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.
EXEC CICS ISSUE PASS
LUNAME(applid)
EXEC CICS ISSUE PASS LUNAME(grname)
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.