z/OS® Communications
Server application routing.
ISSUE PASS
>>-ISSUE PASS--LUNAME(name)------------------------------------->
>--+-------------------------------------+---------------------->
'-FROM(data-area)--LENGTH(data-value)-'
>--+---------------------+--+-----------+----------------------><
+-LOGMODE(data-value)-+ '-NOQUIESCE-'
'-LOGONLOGMODE--------'
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 the
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.