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