Function

To specify the output scheduling priorities with relation to the quantity (records or pages) of output.

Parameters

n

The entry (1-9) being referenced in the OUTPRTY table.

PAGE=page

The output page count for stream mode data sets (1-16777215) that is associated with the PRIORITY= value. The actual page count of a data set is determined by JES2 when writing the output data set to spool.

PRIORITY=priority

The output selection priority (0-255) of a job output element (JOE) for the output interval specified by the RECORD or PAGE parameter. When JES2 builds job output elements (JOEs) for a job, it assigns a priority to each JOE based on the total number of output lines, cards, or pages represented by the JOE.

Note: JOEs are selected in a high to low priority order. For example, a JOE with priority of 150 is selected before a JOE with priority of 140.

RECORD=record

The output record count (1-16777215) that is associated with the PRIORITY= value. The actual record count of a data set is determined by JES2 when writing the output data set to spool.

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 does not affect post-execution jobs.
• The OUTPRTY values do not affect an output data set if the PRTY= parameter was specified on the data set's JCL OUTPUT statement and PRTYOUT=YES was specified on the OUTDEF initialization statement.
• Before changing the specifications of OUTPRTY(n), make sure the values you want assigned fit into the defined OUTPRTY table. See z/OS JES2 Initialization and Tuning Reference, SA32-0992 for further information about the size of the OUTPRTY(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 $HASP848 message displays the current values of all the parameters on the OUTPRTY(n) initialization statement.

JES2 assigns a priority of 120 to any data set that contains at least 15,000 output records and/or 300 output pages.