$QMOD – Modify job queue element in JES2 job queue

Format description

Note:


>>-+--------+--$QMOD--+-element-addrx-+--+-,--queue-value-+----->
   '-symbol-'         '-(--Rn--)------'  '-,--(--Rn--)----'   

>--+----------+--+-------------------+-------------------------->
   '-,--ALONE-'  '-,--PCHANGE--=--OK-'   

                                                 .-NO--.   
>--+------------------------------+--,--KEEP--=--+-YES-+-------->
   |                 .-CHANGE---. |                        
   '-,--PRIORITY--=--+-NOCHANGE-+-'                        

>--+-----------------------+--+------------------+-------------->
   |               .-YES-. |  '-,--JCT--=--addrx-'   
   '-,--EXIT51--=--+-NO--+-'                         

>--+------------------------------+----------------------------->
   '-,--OLD_JOBCLASS--=--jobclass-'   

>--+------------------------------+----------------------------><
   '-,--OLD_SRVCLASS--=--srvclass-'

element

Specifies the address of an element that has been modified and is to be requeued in the JES2 job queue. If register 1 is used, the address must be loaded into register 1 before execution of this macro instruction.

Note: The JQE returned may be real or artificial.

queue

Specifies the logical queue where the job queue element is to be placed. This value must always be one of the eight logical queue types. If register 0 is used, one of these values must be loaded into register 0 before the execution of this macro instruction.

The queue type operands may be ignored if the job queue element has been flagged for cancellation. The resulting logical queue is as follows:

JQE1OCAN bit on and JQE1PURG bit off. Any $QMOD with a $XEQ specification is altered to $OUTPUT.
JQE1OCAN bit off and JQE1PURG bit on. Any $QMOD with a JQEJOECT and JQEHLDCT field 0 is altered to $PURGE. Any $QMOD with a JQEJOECT or JQEHLDCT field nonzero is altered to $HARDCPY.

Attention:

If the processor issuing the $QMOD does not have exclusive ownership of the JQE through $QSUSE, the results of the $QMOD macro instruction are unpredictable. One way to guarantee exclusive ownership is to obtain the JQE through a $QGET or $QADD macro instruction or with the $GETLOK macro instruction.

ALONE

Indicates that the busy flags associated with the moved element are to remain unchanged. If ALONE is not specified, the busy flags associated with the moved element are turned off.

Once the queues have been obtained, all modifications must be made to the JES2 job queues before a $WAIT macro can be issued. Issuing a $WAIT macro implies that the processor no longer requires the queues.

PCHANGE=OK

Indicates that the queue type many be ignored by $QMOD logic if it is determined that another queue type is more appropriate. See the queue parameter description on this macro for examples when a queue type change can occur.

PRIORITY=CHANGE|NOCHANGE

CHANGE indicates that when $QMOD places the job on the queue, JES2 can modify the priority of the job. This is the default. NOCHANGE indicates that when $QMOD places the job on the queue, the priority of the job will remain unchanged.

When PRIORITY is set to CHANGE, the priority of the job will be set to 1 when the job is placed on the hard copy queue.

KEEP=

Indicates a YES or NO. The option is valid only if the JQE is an artificial JQE. KEEP=NO frees the memory for the artificial JQE.

EXIT51=YES|NO

When EXIT51=YES, indicates that JES2 exit 51 is called if the job is changing phase. When EXIT51=NO, it indicates that the call to the exit is bypassed. Default is YES.

JCT

Indicates that address of the JCT to be passed to JES2 exit 51 (if any). If JCT is not specified, no JCT will be passed to the exit.

OLD_JOBCLASS=

Specifies a pointer to the 8-byte job class corresponding to the queue that the job is moved from.

OLD_SRVCLASS=

Specifies a pointer to the 8-byte service class corresponding to the queue that the job is moved from.

Format description

Environment