$T JOBPRTY(n)

Function

To specify the job scheduling priorities with relation to execution time.

Syntax


>>-$T--JOBPRTY--+-n--+-----------+-------------------+---------->
                |    '- ---+-n-+-'                   |   
                |          '-*-'                     |   
                |    .-,------------------------.    |   
                |    V                          |    |   
                '-(------+-n-+--+-----------+---+--)-'   
                         '-*-'  '- ---+-n-+-'            
                                      '-*-'              

>--+--------------------+--+--------------------+--------------><
   '-,--PRIORITY--=--nn-'  '-,--TIME--=--nnnnnn-'

Parameters

n: The entry (1-9) being referenced in the JOBPRTY table.
PRIORITY=nn: The job priority (0-15) that is to be associated with the job execution time, specified by the TIME parameter.
TIME=nnnnnn: The execution time (1-279620, in minutes) of a job that is to be associated with the PRIORITY= value. The TIME value is compared against the estimated execution time for a job, taken from the accounting field of the JOB statement, the /*JOBPARM statement, or the ESTIME initialization statement.

Authority Required

This command requires system authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.

This command requires control security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Processing Considerations

This command affects only those jobs that have not yet entered the system.
The JOBPRTY values do not affect a job if either of the following are true:
- A /*PRIORITY control statement was specified for the job and PRTYJECL=YES was specified on the JOBDEF initialization statement.
- The PRTY= parameter was specified on the job's JCL JOB statement and PRTYJOB=YES was specified on the JOBDEF initialization statement.
Before changing the specifications of JOBPRTY(n), make sure the values you want assigned fit into the defined JOBPRTY table. See z/OS JES2 Initialization and Tuning Reference, SA32-0992 for further information about the size of the JOBPRTY(n) table.

Scope

Single member. This command will be in effect for this member only.

Depending on your installation's setup, however, you might want this command to be applied to all members of the MAS (to ensure a consistent environment across the MAS). If so, you can use the MVS ROUTE *ALL command to issue this command to all active members (if the JES2 command character is the same on all members). See z/OS MVS System Commands, SA38-0666 for more information on using the ROUTE *ALL command.

Messages

The $HASP832 message displays the current values of all the parameters on the JOBPRTY(n) initialization statement.

Example

 1   $t jobprty(2),priority=11,time=3

  $HASP832 JOBPRTY(2) PRIORITY=11,TIME=3

Any job entering the system with an estimated execution time of 3 minutes receives a priority of 11 in the JES2 job queues.