Using the ISSUE PASS command

The EXEC CICS ISSUE PASS command can be used to disconnect a terminal from CICS® and transfer it to the z/OS® Communications Server application specified on the LUNAME option.

For example, to transfer a terminal from this CICS to another terminal-owning region, you could issue the command:

where applid is the applid of the TOR to which the terminal is to be transferred.

When your TORs are members of a generic resource group, you can transfer a terminal to any member of the group by specifying LUNAME as the generic resource name. For example:

where grname is the generic resource name. z/OS Communications Server transfers the terminal to the most lightly-loaded member of the generic resource. (If the system that issues the ISSUE PASS command is itself the most lightly-loaded member, z/OS Communications Server transfers the terminal to the next most lightly-loaded member.)

Note that, if the system that issues an ISSUE PASS LUNAME(grname) command is the only CICS currently registered under the generic resource name (for example, the others have all been shut down), the ISSUE PASS command does not fail with an INVREQ. Instead, the terminal is logged off and message DFHZC3490 is written to the CSNE log. You can code your node error program to deal with this situation. For advice on coding a node error program, see Writing a node error program.

If you need to transfer a terminal to a specific TOR within the CICS generic resource group, you must specify LUNAME as the member name—that is, the CICS APPLID, as in the first example command.