APPLID

The APPLID parameter specifies the z/OS® Communications Server application identifier for this CICS® region.

APPLID={DBDCCICS|applid}
Valid values are as follows:
applid
This name, 1 through 8 characters, identifies the CICS region in the z/OS Communications Server network. It must match the name field specified in the APPL statement of the z/OS Communications Server VBUILD TYPE=APPL definition. For an example, see Defining specific CICS APPL statements to z/OS Communications Server.

If CICS is running in a sysplex, its APPLID must be unique in the sysplex.

This parameter can be used also as the application identifier of this CICS region on IPIC connections.

When you define this CICS region to another CICS region, in an MRO or ISC over SNA CONNECTION definition you specify the APPLID using the NETNAME attribute; in an IPIC IPCONN definition you specify the APPLID using the APPLID attribute.

When sharing a DL/I database with a batch region, the APPLID is used by the batch region to identify the CICS region.

If the CICS region uses XRF, the form of the APPLID parameter is as follows:

APPLID=(generic_applid,specific_applid)
Specifies the generic and specific XRF APPLIDs for the CICS region. Both APPLIDs must be 1 through 8 characters long and the specific APPLID must be unique in the sysplex. If, on CICS startup, the specified specific APPLID is found to duplicate the (specific or only) APPLID of any other CICS region currently active in the sysplex, CICS issues message DFHPA1946 and fails to initialize.
generic_applid
The generic APPLID for both the active and the alternate CICS regions. You must specify the same name for generic_applid on the APPLID system initialization parameter for both CICS regions. Because IRC uses the generic_applid to identify the CICS regions, there can be no IRC connection for an alternate CICS region until takeover has occurred and the alternate CICS region becomes the active CICS region.

When you define this XRF pair to another CICS region, in an MRO or ISC over SNA CONNECTION definition you specify the generic APPLID using the NETNAME attribute; in an IPIC IPCONN definition you specify the generic APPLID using the APPLID attribute.

When sharing a DL/I database with a batch region, this name is used by the batch region to identify the CICS region. CICS passes the generic applid to DBRC, because the alternate system does not sign on to DBRC until it has completed takeover.

Do not confuse the term generic applid with generic resource name. Generic APPLIDs apply only to CICS regions that use XRF. Generic resource names apply only to z/OS Communications Server generic resource groups.

specific_applid
Specifies the CICS region in the z/OS Communications Server network. It must match the label specified in the z/OS Communications Server VBUILD TYPE=APPL definition. You must specify a different specific_applid on the APPLID system initialization parameter for the active and for the alternate CICS region. Also, generic_applid and specific_applid must be different.

The active and alternate CICS regions use the z/OS Communications Server MODIFY USERVAR command to set a user application name variable, so end users do not need to know which CICS region is active at any instant.



dfha2_applid.html | Timestamp icon Last updated: Thursday, 27 June 2019