LINES Parameter


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

LINES parameter is used to specify the maximum output lines to be printed on SYSOUT datasets. The line values are always multiples of 1000. For example - If the LINES=20 means, the maximum limit is 20000 lines. It also specifies the action to be taken when the lines exceed the coded limit.

It is a keyword parameter and optional.

Syntax -

LINES={nnnnnn}
      {([nnnnnn][,CANCEL])}
	  {([nnnnnn][,DUMP])}
	  {([nnnnnn][,WARNING])}
nnnnnn Specifies the number of output lines to be printed.
The value can be from 0 to 999999.
nnnnnn, CANCEL Specifies that the job should be canceled without dump when output printing exceeds the lines.
nnnnnn, DUMP Specifies that the job should be canceled with dump when output printing exceeds the lines.
nnnnnn, WARNING Specifies the job should continue with execution when output printing exceeds the lines. But, the system should issue warning messages to notify the operator.

Default and overrides -

The system uses the installation default value if no LINES parameter is coded or no nnnnnn is coded with CANCEL, DUMP, or WARNING.

Examples -


Scenario1 - Ignore LINES parameter.

//MTHEXMP1 JOB (MTH007),'PAWAN Y',NOTIFY=&SYSUID 

The installation default line value is in effect for the output printing.

Scenario2 - Using LINES parameter.

//MTHEXMP2 JOB (MTH007),'PAWAN Y',LINES=20

The maximum output printing line limit is set to 20. i.e., 20000 lines.

Scenario3 - LINES parameter with CANCEL.

//MTHEXMP3 JOB (MTH007),'PAWAN Y',LINES=(20,CANCEL)

The maximum output printing line limit is set to 20. i.e., 20000 lines. If the output printing lines exceed 20000, the job is canceled without DUMP.

Scenario4 - LINES parameter with DUMP.

//MTHEXMP4 JOB (MTH007),'PAWAN Y',LINES=(25,DUMP)

The maximum output printing line limit is set to 25. i.e., 25000 lines. If the output printing lines exceed 25000, the job is canceled with DUMP.

Scenario5 - LINES parameter with WARNING.

//MTHEXMP5 JOB (MTH007),'PAWAN Y',LINES=(14,WARNING)

The maximum output printing line limit is set to 14, i.e., 14000 lines. If the output printing lines exceed 14000, the job continues execution and notifies the operater with a warning message.