z/OS JES2 Macros
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


$VERIFY – Verify a control block

z/OS JES2 Macros
SA32-0996-00

Use the $VERIFY macro instruction to validate control block contents when read in from spool.

Format description

Read syntax diagramSkip visual syntax diagram
>>-+--------+--$VERIFY--TYPE--=--+-CHK--------+----------------->
   '-symbol-'                    +-HDB--------+   
                                 +-IOT--------+   
                                 +-JCT--------+   
                                 +-NHSB-------+   
                                 +-OCT--------+   
                                 +-SWBI-------+   
                                 '-(--R--n--)-'   

>--,--BUFAD--=--+-addrx------+--+----------------------+-------->
                '-(--R--n--)-'  '-,--JNAMFLD--=--addrx-'   

>--+----------------------+------------------------------------->
   '-,--JNUMFLD--=--addrx-'   

>--+-------------------------------+---------------------------->
   |                  .-(--R2--)-. |   
   '-,--MTTR/MQTR--=--+-addrx----+-'   

>--+------------------------------+--+--------------------+----><
   '-,--KEYFLD--=--+-addrx------+-'  '-,--ERRET--=--addrx-'   
                   '-(--R--n--)-'                             

TYPE=
Specifies the EBCDIC control block identifier or a register that contains the address of the 4-byte EBCDIC identifier of the control block to be verified. TYPE= is required for control block verification.
Control Block
Meaning
CHK
checkpoint control block
HDB
JES2 SYSIN/SYSOUT data buffer
IOT
input/output table control block
JCT
job control table control block
NHSB
NJE network header buffer
OCT
output control table
SWBI
scheduler work block information
BUFAD=
Specifies the address of the buffer that contains the control block to be verified.
ERRET=
Specifies the address of an error routine that is to get control if a control block error is detected or the control block is not verified.
JNAMFLD
Specifies the location of a value to be compared to the content of a control block job name field to determine if it is a valid control block. This parameter is passed in AR14. This parameter is an optional parameter.
JNUMFLD
Specifies the address of a value to be compared to the content of a control block job number field to determine if it is a valid control block. This parameter is passed in AR15. This parameter is an optional parameter.
KEYFLD=
Specifies the address of a field to be used to verify the control block. The value at this address is compared to the control block key field to determine if the control block is valid. The control block key field for this type is specified by the KEYOFF= value of the verification table you built using $VERTAB.
MTTR= / MQTR=
Specifies a track address (MTTR or MQTR) that is to be compared to the contents of a MTTR field in the control block to determine if the control block is valid.

MTTR= and MQTR= are mutually exclusive.

If this parameter is specified, a register or the name of a field is passed to the service routine in R1 (MTTR as 0000 MTTR and MQTR as F0MT TTTR). If neither MTTR nor MQTR is specified, zero is loaded and passed to the service routine in R1.

Return codes

The following return codes (in decimal) are returned in register 15.
Return Code
Meaning
0
Control block valid
4
Control block cannot be verified
8
Control block invalid

Environment

  • JES2 main task, user task (HASPFSSM address space), and HASPFSSM.
  • No waits can occur
Note: This macro requires registers 0, 1, 14, and 15.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014