Define maximum length of log output records
Component: | SYSFILE |
Functional area: | Job processing |
Domain: | JOB |
Privileges: | STD-PROCESSING |
Function
With the MODIFY-SYSFILE-OPTIONS command, users can specify the maximum length of log output records. Logging is set with the MODIFY-JOB-OPTIONS command. The command has effect only if the log is directed to a cataloged file (SYSOUT is assigned to a file) and to SYSLST. Outputs to terminal are not influenced.
The user can determine whether output is to be additionally directed into a file which is accessible while library elements are output to SYSLST or SYSOUT.
Effect of maximum output record length
Output records exceeding the specified record length are distributed over several lines when logged. These lines do not exceed the specified record line. The length of the output records also contains the “prefix” (e.g. blanks, the character strings (IN) or (OUT)), which precedes each record to be logged.
Format
MODIFY-SYSFILE-OPTIONS |
LOGGING-LINE-SIZE = *UNCHANGED / *STD / <integer 18..2044> ,LIBRARY-OUTPUT-COPY = *UNCHANGED / *YES / *NO / *BY-SYSTEM-PARAMETER |
Operands
LOGGING-LINE-SIZE = *UNCHANGED
The default is *UNCHANGED, i.e. the setting remains unchanged. At the beginning of a job, the default value of 132 is set. During logging, output records exceeding 132 characters in length are spread over two or more lines containing a maximum of 132 characters. Each continuation line thus created also contains a “prefix”.
Example
With LOGGING-LINE-SIZE=132, a 1000-byte-long data record is spread over eight lines for SYSOUT output to a cataloged file and over nine lines for hardcopy output.
LOGGING-LINE-SIZE = *STD
The *STD entry sets line size to the default value of 132.
LOGGING-LINE-SIZE = <integer 16..2044>
Sets the specified value. The largest specifiable value depends on the attributes of the file assigned: A SAM file with BUF-LEN=STD(1) on an NK disk can contain no more than one record with a length of 2032 bytes.
LIBRARY-OUTPUT-COPY = *UNCHANGED / *YES / *NO / *BY-SYSTEM-PARAMETER
Specifies whether the output records are additionally written into a file when SYSLST or SYSOUT is assigned to a PLAM library element. When a task starts, the SSMMILOG system parameter setting applies.
The default value is *UNCHANGED, i.e. the current setting remains unchanged.
LIBRARY-OUTPUT-COPY = *YES
In each assignment of SYSLST or SYSOUT to a PLAM library element, a file is generated as a copy and each output record is also written into that file. The copy is assigned the following name:
S.LST.<lib>.<elem>.<tsn>.<counter>
or
S.OUT.<lib>.<elem>.<tsn>.<counter>
The name sections have the following meanings:
lib: | the first 7 characters of the PLAM library |
elem: | the first 7 characters of the element |
tsn: | the task’s TSN |
counter: | 4-position counter |
LIBRARY-OUTPUT-COPY = *NO
Output records are not copied.
LIBRARY-OUTPUT-COPY = *BY-SYSTEM-PARAMETER
The setting of the SSMMILOG system parameter applies.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed | |
64 | CMD0216 | Semantic error |