On entry, register 1 contains the address of the following ten
word parameter list:
- Word 1
- The address of the job name.
- Word 2
- The address of a halfword that contains the length of the job
name.
- Word 3
- The address of the user ID.
- Word 4
- The address of one byte that contains the length of the user ID.
- Word 5
- The address of a message to be displayed on the terminal. The
exit must supply the message when it sets a return code of 4 or 8.
The format of the message is "LLtext", where LL is a 2-byte
field that contains the length of the entire message (including the
LL field). The maximum text length is 127 bytes. The exit must obtain
the message text area and should free it when it receives control
again.
- Word 6
- The address of a response from the user if the exit's previous
return code was 4. The format of the response is "LLtext", where
LL is a 2-byte field that contains the length of the entire reply
(including the LL field). The command processor that calls
the exit obtains and frees the reply text area.
- Word 7
- The address of the one byte command code that indicates which command processor invoked
the exit. The command codes are:
- 0
- STATUS command processor
- 4
- CANCEL command processor
- 8
- OUTPUT command processor
- Word 8
- The address of the jobid if the user specified jobid on the command.
If the user did not specify jobid, this word contains zero.
- Word 9
- The address of a halfword that contains the jobid length. If
the user did not specify jobid, the length field contains zero.
- Word 10
- (For the OUTPUT command only)
The address of a list of pointers
and bits that reflects the syntax that the user entered on the OUTPUT
command. The total length of this list is five fullwords. The high-order
bit of word 10 must be on to indicate the end of the parameter list.
The five fullwords are as follows. For more information about the
parse descriptor entry (PDE), see .
- Word 1
- Pointer to the first PDE for the CLASS operand on the chain of
PDEs. If the user did not specify CLASS on the OUTPUT command, this
word contains zero.
- Word 2
- Pointer to the print-data-set-name PDE. If the user did not enter
the data set name, this word contains zero.
- Word 3
- Pointer to the PDE for the class name on the NEWCLASS operand.
If the user did not specify a new class, this word contains zero.
- Word 4
- Pointer to the PDE for the remote station ID. If the user did
not enter a destination, this word contains zero.
- Word 5
- Only the first 12 bits (high-order) are used to reflect the user-entered
syntax as follows:
- X'8000'
- PAUSE (if off, assume NOPAUSE or not applicable)
- X'4000'
- HOLD (if off, assume NOHOLD or not applicable)
- X'2000'
- HERE
- X'1000'
- BEGIN
- X'0800'
- NEXT
- X'0400'
- DELETE
- X'0200'
- PRINT
- X'0100'
- NEWCLASS
- X'0080'
- KEEP (if off, assume NOKEEP or not applicable)
- X'0040'
- DEST
- X'0020'
- Reserved
- X'0010'
- Reserved
z/OS TSO/E Customization
Copyright IBM Corporation 1990, 2014