MODIFY-LOGGING-PARAMETERS - Modify logging settings

The MODIFY-LOGGING-PARAMETERS statement modifies the global settings for the logging scope, output medium and logging format.

If one of these values is changed by the MODIFY-LOGGING-PARAMETERS statement, this new setting becomes the current setting. This remains valid for the LMSCONV run (*UNCHANGED) until a new MODIFY-LOGGING-PARAMETERS statement for this value or RESET-LOGGING-PARAMETERS is issued. At the beginning of the LMSCONV run, the values immediately following *UNCHANGED apply.

Format

MODIFY-LOGGING-PARAMETERS                                                                                                                

LOGGING = *UNCHANGED / *MINIMUM / *MAXIMUM
,TEXT-OUTPUT = *UNCHANGED / *SYSOUT / *SYSLST(...) / *NONE / *LIBRARY-ELEMENT(...)
	*SYSLST(...)
		|	SYSLST-NUMBER = *STD / <integer 1..99>
	*LIBRARY-ELEMENT(...)
		|	LIBRARY = *STD / <filename 1..54 without-vers> / *LINK(...)
		|		*LINK(...)
		|			|	LINK-NAME = <structured-name 1..8>
		|	,ELEMENT = <composed-name 1..64 with-under>(...)
		|		<composed-name 1..64 with-under>(...)
		|			|	VERSION = *UPPER-LIMIT / <composed-name 1..24 with-under>
		|	,TYPE = P / <alphanum-name 1..8>
		|	,WRITE-MODE = *UNCHANGED / *CREATE / *REPLACE / *EXTEND / *ANY
,OUTPUT-LAYOUT = *UNCHANGED / *PARAMETERS(...)
	*PARAMETERS(...)
		|	LINES-PER-PAGE = *UNCHANGED / <integer 1..9999>
		|	,LINE-SIZE = *UNCHANGED / 132 / 80
		|	,EXTRA-FORM-FEED = *UNCHANGED / *NO / *YES
		|	,HEADER-LINES = *UNCHANGED / *YES / *NO

Operands

LOGGING = *UNCHANGED / *MINIMUM / *MAXIMUM
Defines the scope of LMSCNV logging.

LOGGING = *MINIMUM
Only error messages and negative acknowledgments are output.

LOGGING = *MAXIMUM
A complete LMSCONV log is output.

TEXT-OUTPUT = *UNCHANGED / *SYSOUT / *SYSLST(...) / *NONE / *LIBARARY-ELEMENT(...)
This parameter defines the output medium. If the medium is changed or if WRITE-MODE=*EXTEND is entered, page numbering always begins with 1. The preset value is *SYSOUT.

TEXT-OUTPUT = *SYSOUT
The output is written to SYSOUT.

TEXT-OUTPUT = *SYSLST(...)
The output is written to SYSLST.

SYSLST-NUMBER = *STD / <integer 1..99>
Denotes the SYSLST file to which the output is to be written.

SYSLST-NUMBER = *STD
The system file SYSLST is used.

SYSLST-NUMBER = <integer 1..99>
The system file with the specified number from the set SYSLST01 through SYSLST99 is used.

TEXT-OUTPUT = *NONE
Except for error messages, output is suppressed.

TEXT-OUTPUT = *LIBRARY-ELEMENT(...)
The output is stored in a library member.

LIBRARY = *STD / <filename 1..54 without-vers> / *LINK(...)
Specifies the library in which the output is to be stored. Either the library set globally by means of OPEN-LIBRARY is used as standard, or the explicitly specified library or the library assigned via the link name is used.

LINK-NAME = <structured-name 1..8>
Link name of the library.

ELEMENT = <composed-name 1..64 with-under>(...)
Specifies the member in which the output is to be stored.

VERSION = *UPPER-LIMIT / <composed-name 1..24 with-under>
Specifies the version that the member is to receive.

VERSION = *UPPER-LIMIT
The highest possible version X'FF' is generated.

VERSION = <composed-name 1..24 with-under>
The text specified here is interpreted as the version designation.

TYPE = P / <alphanum-name 1..8>
Specifies the member type.
By default the member in which the output is stored receives type P for print-edited files.

WRITE-MODE = *UNCHANGED / *CREATE / *REPLACE / *EXTEND / *ANY
Overwriting of a member having the same name. If the member does not exist under this name, it will be created as a new member. The preset value is *CREATE.

WRITE-MODE = *CREATE
The target member must not yet exist and is created as a new member.

WRITE-MODE = *REPLACE
The target member must already exist and is replaced.

WRITE-MODE = *EXTEND
The target member is extended if it already exists. Otherwise it will be created as a new member.

WRITE-MODE = *ANY
The target member is replaced if it already exists. Otherwise it will be created as a new member.

OUTPUT-LAYOUT = *UNCHANGED / *PARAMETERS(...)
This parameter defines the LMSCONV log format.

LINES-PER-PAGE = *UNCHANGED / <integer 1..9999>
This parameter defines the page length.
Default value: 64 lines

LINE-SIZE = *UNCHANGED / 132 / 80
This parameter defines the line length.The preset value is 132.

LINE-SIZE = 132
The line is to be 132 characters long.

LINE-SIZE = 80
The line is to be 80 characters long.

EXTRA-FORM-FEED = *UNCHANGED / *NO / *YES
This parameter controls an extra form feed. The preset value is *NO.

EXTRA-FORM-FEED = *NO
A form feed will only occur when the page is full.

EXTRA-FORM-FEED = *YES
A form feed will occur either when the page is full or when a change of statement or member takes place.

HEADER-LINES = *UNCHANGED / *YES / *NO
This parameter controls the output of headers.The preset value is *YES.

HEADER-LINES = *YES
Headers containing the library and member designations are output.

HEADER-LINES = *NO
No headers are output.