Choosing an LUAPFX value

When you choose an LUAPFX value, consider the scope of this parameter in the CICSplex, and also consider its scope in the sysplex in which your CICS® regions operate.

A predefined LUALIAS name is supplied to CICS for cross-domain and cross-network resources. All the CICS regions in an MVS™ image share the same SNA and are in the same domain. A CICS region in a different MVS image uses a different SNA and is thus in a different domain. Resources coming from one SNA to another, but which share the name NETID, are cross-domain resources

A dynamic LUALIAS name is supplied to CICS only for cross-network resources. A resource is a cross-network resource if it has a different network id. SNA ensures that all the dynamic LUALIAS names assigned in one MVS image are unique. However, CICS requires network names to be unique across MVS images so that there are no network name clashes in AORs.

It is important that all CICS regions across all connected networks use unique APPLIDs. This requirement is true whether or not dynamic LUALIASs are used; it is more important with dynamic LUALIASs.

To ensure that all SNA resources in a CICSplex have unique network names, use the LUAPFX prefix:
  • Specify LUAPFX on terminal-owning regions (TORs) only.
  • Use the same LUAPFX value for all the CICS TORs in the same MVS image (that is, for all the TORs that are connected to the same SNA), but ensure the LUAPFX is different in each MVS image in the sysplex..

    If the LUAPFX values are not the same throughout an MVS image, you risk one resource having two different network names in the CICS regions in that image.

    If the LUAPFX values are not unique to each MVS image in the sysplex, you risk two resources attempting to install in a TOR with the same dynamic LUALIAS, or having two resources with the same network name in an AOR.

    To ensure the uniqueness of the LU prefix in each MVS, use model APPL definitions, and in these use an MVS system symbol (&SYSCLONE) as suggested in the z/OS Communications Server: SNA Resource Definition Reference.

    If you use SNA generic resources and your CICS TORs are spread across different MVS images, be aware that if a resource with a dynamically allocated LU alias logs off and then logs on again, and SNA switches the resource to an SNA in another MVS image, a different LUALIAS is assigned because of the different LUAPFX value.
  • Avoid using an LUAPFX value that corresponds to the first two characters of CICS RDO-defined terminal names or connection names installed in the CICSplex.


dfha1lb.html | Timestamp icon Last updated: Sunday, 4 June 2017