PAGES Parameter


Note! PAGES parameter can be coded only at the job level.

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.