Generating z/OS Communications Server generic resource support
To generate z/OS® Communications Server generic resource support for your CICS® TORs, you must perform these steps.
About this task
Procedure
- Use the GRNAME system
initialization parameter to define the generic resource name under
which CICS is to register to z/OS Communications Server. To
comply with the CICS naming
conventions, pad the name to the permitted 8 characters with one of
the characters #, @, or $. For example:
GRNAME=CICSH###If you specify a valid generic resource name on GRNAME, specify only name1 on the APPLID system initialization parameter. If you do specify both name1 and name2 on the APPLID parameter, CICS ignores name1 and uses name2 as the z/OS Communications Server APPLID.
- Use an APPL statement to define the attributes of each participating TOR to z/OS Communications Server. The attributes defined on each individual APPL statement should be identical. The name on each APPL statement must be unique. It identifies the TOR individually, within the generic resource group.
- Shut down each terminal-owning region normally before registering
it as a member of the generic resource. An immediate shutdown
is not sufficient; nor is a CICS failure
followed by a cold start. Do not specify a shutdown assist transaction,
to avoid the possibility of the transaction force closing z/OS Communications Server or performing
an immediate shutdown. The default shutdown assist transaction, DFHCESD,
is described in Shutdown assist program (DFHCESD).
If CICS has not been shut down cleanly before you try to register it as a member of a generic resource, z/OS Communications Server might (due to the existence of persistent sessions) fail to register it, and issue a return code-feedback (RTNCD-FDB2) of X'14', X'86'. To correct this, you must restart CICS (with the same APPLID), and then shut it down cleanly. Alternatively, if you have written a batch program to end affinities (see Writing a batch program to end affinities), you might be able to use it to achieve the same effect. As part of its processing, the batch program opens the original z/OS Communications Server ACB with the original APPLID, unbinds any persisting sessions, and closes the ACB.
You can shut down the CICS region with the following interfaces:
CICS Explorer®Use the Regions view.
dfht1mv.html |
Last updated: Sunday, 4 June 2017