PAGES Parameter
The PAGES parameter is used to specify the maximum output pages to be printed on SYSOUT datasets. The page values are always multiples of 1000. For example - If the PAGES=20 means, the maximum limit is 20000 pages. It also specifies the action to be taken when the pages exceed the coded limit.
It is a keyword parameter and optional.
Syntax -
PAGES={nnnnnn}
{([nnnnnn][,CANCEL])}
{([nnnnnn][,DUMP])}
{([nnnnnn][,WARNING])}
nnnnnn | Specifies the number of output pages to be printed. The value can be from 0 to 999999. |
nnnnnn, CANCEL | Specifies the job should be canceled without dump when output printing exceeds the pages. |
nnnnnn, DUMP | Specifies the job should be canceled with dump when output printing exceeds the pages. |
nnnnnn, WARNING | Specifies should continue with execution when output printing exceeds the pages. But, the system should issue warning messages to notify the operator. |
Default and overrides -
The system uses the installation default value if no PAGES parameter or no nnnnnn is coded with CANCEL, DUMP, or WARNING.
Examples -
Scenario1 - Ignore PAGES parameter.
//MTHEXMP1 JOB (MTH007),'PAWAN Y',NOTIFY=&SYSUID
The installation default page value is in effect for the output printing.
Scenario2 - Using PAGES parameter.
//MTHEXMP2 JOB (MTH007),'PAWAN Y',PAGES=20
The maximum output printing page limit is set to 20. i.e., 20000 pages.
Scenario3 - PAGES parameter with CANCEL.
//MTHEXMP3 JOB (MTH007),'PAWAN Y',PAGES=(20,CANCEL)
The maximum output printing page limit is set to 20. i.e., 20000 pages. If the output printing pages exceed 20000, the job is canceled without DUMP.
Scenario4 - PAGES parameter with DUMP.
//MTHEXMP4 JOB (MTH007),'PAWAN Y',PAGES=(25,DUMP)
The maximum output printing page limit is set to 25. i.e., 25000 pages. If the output printing pages exceed 25000, the job is canceled with DUMP.
Scenario5 - PAGES parameter with WARNING.
//MTHEXMP5 JOB (MTH007),'PAWAN Y',PAGES=(14,WARNING)
The maximum output printing page limit is set to 14, i.e., 14000 pages. If the output printing pages exceed 14000, the job continues execution and notifies the operater with a warning message.