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


$QGET – Obtain a job queue element from the JES2 job queue

z/OS JES2 Macros
SA32-0996-00

Use $QGET to obtain a job queue element from the specified logical queue of the JES2 job queue and return the address of this element in register 1.

Note: JES2 returns an artificial JQE (JQA).

Format description

Read syntax diagramSkip visual syntax diagram
>>-+--------+--$QGET--queue-type-------------------------------->
   '-symbol-'                      

>--+-------------------------------+--+---------------------+--->
   '-,--TYPE--=--class-list-prefix-'  '-,--FOUND--=--relexp-'   

>--+--------------------+--+------------------------+----------->
   '-,--NONE--=--relexp-'  '-,--CB--=--+-addrx----+-'   
                                       '-(--Rn--)-'     

>--+-------------------------------------------+---------------->
   |           .-L---------------------------. |   
   '-,--MF--=--+-(--EX--,--+-label------+--)-+-'   
                           '-(--R--x--)-'          

>--+-----------------------------+-----------------------------><
   '-,--NODETBL--=--+-addrx----+-'   
                    '-(--Rn--)-'     

queue type
Specifies the logical queue from which the job queue element is to be obtained. This queue type is indicated in the inline parameter list generated by the macro expansion. Valid queue types and their meanings are:
$DUMMY
Reserved queue.
$FREE
Indicates that the JQE is to be obtained from the JES2 free queue.
$HARDCPY
Indicates that the JQE is to be obtained from the JES2 hardcopy queue.
$INPUT
Indicates that the JQE is to be obtained from the JES2 input queue.
$INWS
Indicates a QGET call for JES-managed initiators.
$OJTWS
Indicates that the JQE work selection algorithms are used to select an eligible job for this transmitter.
$OJTWSC
Indicates that the JQE work selection algorithms are used to select an eligible job for this transmitter and that the conversion queue ($XEQ) is scanned for work.
$OUTPUT
Indicates that the JQE is to be obtained from the JES2 output queue.
$PURGE
Indicates that the JQE is to be obtained from the JES2 purge queue.
$RECEIVE
Indicates that the JQE is to be obtained from the JES2 SYSOUT receive queue.
$SETUP
Indicates that the JQE is to be obtained from the JES2 setup queue.
$WLMINWS
Indicates a QGET call for WLM-managed initiators.
$XEQ
Indicates that the JQE is to be obtained from the conversion queue.
$XEQCLAS
Indicates that the JQE is to be obtained from the JES2 execution class queue.
$XMIT
Indicates that the JQE is to be obtained from the JES2 transmit queue.
Note: Although $INWS, $OJTWS, and $OJTWSC are not actual queue types, they can be used to indicate work selection for offload job transmitters or a call for initiators.
TYPE=
Specifies the prefix of the class list used if the queue type is $INWS, $OJTWS, or $OJTWSC. The value specified must be a valid control block DSECT name, for example, DCT or PIT. This value is also used to determine the offset of the class list field. If TYPE= is not specified, the class list defaults to DCTCLASS for offload job transmitters and PITCLASS for initiators.
FOUND=
Specifies a label or address in a register to which JES2 branches if a selectable JQE is found.
NONE=
Specifies a label or address in a register to which JES2 branches if no selectable JQE is found.
CB=
Specifies the address of a control block which is to be used for work selection or an initiator call. This keyword is only valid if either the queue type is specified as $INWS, $OJTWS or $OJTWSC.
MF=
Specifies the required form of this macro.
L
Indicates the list form of the macro.
EX
Indicates the executable form of the macro. This form requires the address of a parameter list.
label
The label of the parameter list.
(Rx)
The register that contains the address of the parameter list.
NODETBL=
Specifies the location of the MDCTNODS field in the job transmitter's line device control table (DCT). If the queue type specification is not $XMIT, this keyword should not be used. If register notation is used, the address must have been loaded into the designated register before execution of this macro instruction.

Environment

  • Main task.
  • $WAIT can occur.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014