ISSUE PASS

z/OS® Communications Server application routing.

ISSUE PASS

Conditions: INVREQ, LENGERR, NOTALLOC

Description

ISSUE PASS disconnects the terminal from CICS® after the task has terminated, and transfers it to the z/OS Communications Server application defined in the LUNAME option.

This command requires that AUTH=PASS is coded on the z/OS Communications Server APPL macro for the CICS terminal-owning system that issues it, with DISCREQ=YES or RELREQ=YES in the RDO TYPETERM resource definition for any terminal where this function might be used.

If the LUNAME specified is the name of another CICS system, you can use the EXTRACT LOGONMSG command to access the data referred to by this command.

Because of a z/OS Communications Server limitation, the maximum length of the user data is restricted to 255 bytes.

Note: The system initialization parameter CLSDSTP=NOTIFY|NONOTIFY allows you to have the node error program (NEP) and the console notified of whether the PASS was successful or not. The NEP can be coded to reestablish a session ended by an unsuccessful PASS. For programming information about how to do this, see the section about NEP in Writing a node error program.

Options

FROM(data-area): specifies the data area containing the logon user data that is to be passed to the application named in the LUNAME option. This option may be omitted if ATTACHID is specified on an LUTYPE6.1 command.
LENGTH(data-value): specifies the length, as a halfword binary value, of the data issued.
LOGMODE(data-value): specifies the name (1–8 characters) of the z/OS Communications Server logon mode table entry used by z/OS Communications Server to establish the new session.
LOGONLOGMODE: specifies that the new session is to be established with the z/OS Communications Server logon mode table entry in use when the session logged on.
Note: The logmode name saved is taken from the X'0D' control vector in the z/OS Communications Server CINIT. This is the logmode name known in this system.
If persistent sessions (PSDINT=nnn in the SIT) is in use, then the TYPETERM definition for any terminal to be ISSUE PASSed should use RECOVOPTION(NONE), because the logon LOGMODE name is not recovered across a persistent sessions restart.

If neither LOGMODE nor LOGONLOGMODE is supplied, the new session will be established with the default LOGMODE.
LUNAME(name): specifies the name (1–8 characters) of the z/OS Communications Server application to which the terminal is to be passed.
NOQUIESCE: specifies that the user can choose to recover from certain pass failures.

Conditions

16 INVREQ: occurs if the command is not valid for the logical unit in use.
Default action: terminate the task abnormally.
22 LENGERR: occurs if an out-of-range value is supplied in the LENGTH option.
Default action: terminate the task abnormally.
61 NOTALLOC: occurs if the facility specified in the command is not owned by the application.
Default action: terminate the task abnormally.