The EXEC CICS ISSUE PASS command can be used (either from an application program, or by means of CECI) to disconnect a terminal from CICS®, and transfer it to the VTAM® 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.
If your TORs are members of a VTAM 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. VTAM chooses the most suitable group member to which to transfer the terminal. (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.)
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 may want to code your node error program to deal with the situation when message DFHZC3490 (DFHZNAC error code X'C3') is issued.