JCL LINES Parameter

Summary -

In this topic, we described about the below sections -

LINES
- Default and overrides

LINES parameter used to specify the maximum amount of output in thousands of lines to be printed on sysout data sets. It also specifies the action needs to be taken when it exceeds the lines specified.

By using LINES parameter, the JOB can be cancelled with or without dump or to continue the execution by notifying operator regarding the job exceeds the maximum. LINES parameter is optional.

Syntax -

LINES={nnnnnn /([nnnnnn][,CANCEL]) /([nnnnnn][,DUMP])/([nnnnnn][,WARNING])}

nnnnnn	Specifies the maximum amount of the output printed for the job. The amount is in thousands. Ex: 50 means 50000 lines The value can be from 0 to 999999.
nnnnnn, CANCEL	Specifies that the system used to cancel the job without dump when output exceeds the value (nnnnnn) specified.
nnnnnn, DUMP	Specifies that the system used to cancel the job when output exceeds the value (nnnnnn) specified. It also requests the system for the dump.
nnnnnn, WARNING	Specifies that the system to continue the execution of the JOB when output exceeds the value (nnnnnn) specified. System will issue warning messages at the specified interval.

Default and overrides:

Specifying the LINES parameter on JOB statement, will override the system default values. If no LINES parameter specified, then system uses the installation default value.

If no nnnnnn specified along with CANCEL, DUMP or WARNING, system uses the installation default value. If no CANCEL, DUMP or WARNING specified, system will use installation default value.

Example 1:

//MTHEXMP1 JOB (META007),'PAWAN Y'

This JOB statement indicates LINES not specified. The installation default determines the JOB processing.

Example 2:

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

This JOB statement indicates that LINES value specified as 20. System will cancel MTHEXMP2 job when the sysout exceeds 20 thousand lines.

Example 3:

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

This JOB statement indicates that LINES value specified as 20. System will cancel MTHEXMP3 job without dump when the sysout exceeds 20 thousand lines.

Example 4:

//MTHEXMP4 JOB (META007),'PAWAN Y', LINES=20, DUMP

This JOB statement indicates that LINES value specified as 20. System will cancel MTHEXMP4 job when the sysout exceeds 20 thousand lines and also requests for system dump.

Example 5:

//MTHEXMP5 JOB (META007),'PAWAN Y', LINES=20, WARNING

This JOB statement indicates that LINES value specified as 20. System will continue the execution of MTHEXMP5 job when the sysout exceeds 20 thousand lines. But send intermediate messages to the operator.