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 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:

EXEC CICS ISSUE PASS
LUNAME(applid)

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:

EXEC CICS ISSUE PASS LUNAME(grname)

where grname is the generic resource name. VTAM 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, VTAM 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 the CICS Customization Guide.

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.

Related tasks
Planning your CICSplex to use VTAM generic resources
Defining connections in a generic resource environment
Generating VTAM generic resource support
Migrating a TOR to a generic resource
Removing a TOR from a generic resource
Moving a TOR to a different generic resource
Setting up inter-sysplex communications between generic resources
Ending affinities
Using ATI with generic resources
Dealing with special cases
Related reference
Prerequisites for VTAM generic resources
Rules checklist
[[ Contents Previous Page | Next Page Index ]]