$T ESTPAGE

Function

To specify the default page count for a job's output and the action JES2 takes if a job exceeds this page count.

Syntax


>>-$T--ESTPAGE--+-------------------+--+-------------------+---->
                '-,--INT--=--nnnnnn-'  '-,--NUM--=--nnnnnn-'   

>--+------------------+----------------------------------------><
   '-,--OPT--=--+-0-+-'   
                +-1-+     
                '-2-'

Parameters

INT=nnnnnn

The interval (1-999999), in number of pages, at which JES2 repeats the $HASP375 message to the operator.

NUM=nnnnnn

The number of pages (1-999999) produced for a job after which the $HASP375 message informs the operator that the job's estimated output has been exceeded.

OPT={0|1|2}

Specifies the action JES2 takes when a job exceeds the estimated page output as specified by the NUM= parameter. The options and subsequent action are:

0: Job is allowed to continue execution.
1: Job is cancelled without a dump.
2: Job is cancelled with a dump (if a dump statement was coded for this job step).

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

If changed by this command after a job was submitted, the ESTPAGE parameters are affected as follows:

the INT= and OPT= values are effected immediately and are reflected during job execution
the NUM= value remains equal to the value when the job was submitted. It takes affect for only newly submitted jobs.

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 $HASP845 message displays the current values of all the parameters on the ESTPAGE initialization statement.

Example

 1   $t estpage,int=10

  $HASP845 ESTPAGE NUM=200,INT=10,OPT=0

If a job that has not yet been selected for execution exceeds 200 pages of output (NUM=200) during its execution, the $HASP375 message informs the operator that the job's estimated output has been exceeded. JES2 repeats the $HASP375 message to the operator every 10 pages that exceed the estimated page output (200 pages) until the job completes execution.