VTAM® 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 VTAM application defined in the LUNAME option.
This command requires that AUTH=PASS is coded on the VTAM 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 VTAM 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
CICS Customization Guide.
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 VTAM logon mode table
entry used by VTAM to establish the new session.
- LOGONLOGMODE
- specifies that the new session is to be established with the VTAM 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 VTAM 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 VTAM application to
which the terminal is to be passed.
- NOQUIESCE
- specifies that the user can choose to recover from certain pass failures.
Conditions
- INVREQ
- occurs if the command is not valid for the logical unit in use.
Default action: terminate the task abnormally.
- LENGERR
- occurs if an out-of-range value is supplied in the LENGTH option.
Default action: terminate the task abnormally.
- NOTALLOC
- occurs if the facility specified in the command is not owned by the
application.
Default action: terminate the task abnormally.