MODIFY-LOGGING-PARAMETERS

The MODIFY-LOGGING-PARAMETERS statement modifies the global settings for the editor, 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 LMS run (*UNCHANGED) until a new MODIFY-LOGGING-PARAMETERS statement for this value or RESET-LOGGING-PARAMETERS is issued.

At the beginning of the LMS run, the values immediately following *UNCHANGED are valid. The default or current values can be output with the appropriate SHOW statement..

MODIFY-LOGGING-PARAMETERS

LOGGING = *UNCHA NGED / *MINIMUM / *MAXIMUM
,TEXT-OUTPUT = UNCHA NGED / *SYSOUT / *SYSLST(...) / *NONE / *EDT(...) / *LIBRARY-ELEMENT(...)
	*SYSLST(...)
		|	SYSLST-NUMBER = *STD / <integer 1..99>
	*EDT(...)
		|	WRITE-MODE = *UNCHA NGED / *EXTEND / *REPLACE
	*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 = *UP PER -LIM IT / *HIGHEST-EXISTING / *INCREMENT /
		|			|		<composed-name 1..24 with-under>
		|			|	,BASE = *STD / <composed-name 1..24 with-under with-wild>
		|	,TYPE = P / <alphanum-name 1..8>
		|	,WRITE-MODE = *UNCHA NGED / *CREATE / *REPLACE / *EXTEND / *ANY

,OUTPUT-LAYOUT = *UNCHA NGED / *PARAMETERS(...)
	*PARAMETERS(...)
		|	LINES-PER-PAGE = *UNCHA NGED / <integer 1..9999>
		|	,LINE-SIZE = *UNCHA NGED / 132 / 80
		|	,EXTRA-FORM-FEED = *UNCHA NGED / *NO / *YES
		|	,HEADER-LINES = *UNCHA NGED / *YES / *NO

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

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

LOGGING = *MAXIMUM
A complete LMS log is output.

TEXT-OUTPUT = *UNCHANGED / *SYSOUT / *SYSLST(...) / *NONE / *EDT(...) / *LIBRARY-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.

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 = *EDT(...)
The output is written to EDT work file 9.
If an error occurs during log output, LMS switches over to the default log stream (SYSOUT).

WRITE-MODE = *UNCHANGED / *EXTEND / *REPLACE

Write mode for the output with regard to the contents of work file 9.

WRITE-MODE = *EXTEND
If data exists in work file 9, the output is added to it. Otherwise, the output is written at the beginning of the work file.

WRITE-MODE =*REPLACE
Writes the output at the beginning of work file 9. Any data already present in the work file is overwritten.

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 / *HIGHEST-EXISTING / *INCREMENT /
<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 = *HIGHEST-EXISTING
Depending on the convention applicable for the type, this overwrites the highest existing version with reference to BASE among the members of the same type and name; otherwise a default version is generated.

VERSION = *INCREMENT
Depending on the convention applicable for the type, this generates a new, higher version among existing members having the same type and name; otherwise a default version is generated (see also "Convention: STD-TREE").

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

BASE = *STD / <composed-name 1..24 with-under with-wild>
Defines the base for the target member. For further information concerning specification of the base, see "Version designations".

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 / *ANYOverwriting of a member having the same name. If the member does not exist under this name, it will be created as a new member.

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 LMS log format.

LINES-PER-PAGES = *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.

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.

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.

HEADER-LINES = *YES

Headers containing the library and member designations are output.

HEADER-LINES = *NO
No headers are output.

Statement return code

(SC2)	SC1	Maincode	Meaning
2	0 0 1 32 64 64 64 64 64 64 64 64 64 64 64 64 64 130 130 130 130	CMD0001 LMS0151 CMD0230 LMS1002 LMS0020 LMS0093 LMS0213 LMS0214 LMS0510 LMS1004 PLA0223 PLA0224 PLA0229 PLA0233 PLA0475 PLA0476 PLA0478 LMS0041 LMS0411 LMS0412 LMS0413	No error Input or output medium set to standard Syntax error Internal error Target member or target file does not exist Protocol member already exists Name exists as delta member Name exists as full member Base not found Other error Only leaves of a delta tree can be overwritten Storage form not allowed No access right for the member Borrow status prevents member access Function violates version automation Version does not match applicable convention Increase causes version overflow System address space exhausted Library locked Member locked Type locked

Required access rights

No access rights are necessary.