MODIFY-ELEMENT

The MODIFY-ELEMENT statement initiates the modification of members. The modifications themselves are controlled by way of MODIFY-ELEMENT substatements (see "MODIFY-ELEMENT substatements for member types R, C and L").

MODIFY-ELEMENT selects the members to be modified. The source and target base types may differ if text members are modified.

Once the MODIFY-ELEMENT statement has been sent, LMS expects a substatement as the next statement. If another statement is entered instead of a substatement, an error message is issued.

MODIFY-ELEMENT

ELEMENT = *LIB RARY -ELEM ENT (...)
	*LIBRARY-ELEMENT(...)
		|	LIBRARY = *STD / <filename 1..54 without-vers> / *LINK(...)
		|		*LINK(...)
		|			|	LINK-NAME = <structured-name 1..8>
		|	,ELEMENT = *ALL(...) / <composed-name 1..64 with-under with-wild(132)>(...)
		|		*ALL(...)
		|			|	VERSION = *HIGH EST -EXIST ING / *ALL / *UPPER-LIMIT /
		|			|		<composed-name 1..24 with-under with-wild(52)>
		|			|	,BASE = *STD / <composed-name 1..24 with-under with-wild>
		|		<composed-name 1..64 with-under with-wild(132)>(...)
		|			|	VERSION = *HIGH EST -EXIST ING / *ALL / *UPPER-LIMIT /
		|			|		<composed-name 1..24 with-under with-wild(52)>
		|			|	,BASE = *STD / <composed-name 1..24 with-under with-wild>
		|	,TYPE = *LMS-DEF AULT / <alphanum-name 1..8>

	|	,USER-DATE = *ANY / *TODAY / <date 8..10 with-compl> / *INTERVAL(...)
	|		*INTERVAL(...)
	|			|	FROM = 1900-01-01 / <date 8..10 with-compl>
	|			|	,TO = *TODAY / <date 8..10 with-compl>
	|	,CREATION-DATE = *ANY / *TODAY / <date 8..10 with-compl> / *INTERVAL(...)
	|		*INTERVAL(...)
	|			|	FROM = 1900-01-01 / <date 8..10 with-compl>
	|			|	,TO = *TODAY / <date 8..10 with-compl>
	|	,MODIFICATION-DATE = *ANY / *TODAY / <date 8..10 with-compl> / *INTERVAL(...)
	|		*INTERVAL(...)
	|			|	FROM = 1900-01-01 / <date 8..10 with-compl>
	|			|	,TO = *TODAY / <date 8..10 with-compl>
	|	,EXCEPT-ELEMENT = *NONE / *ELEMENT(...)
	|		*ELEMENT(...)
	|			|	ELEMENT = *ANY (...) / <composed-name 1..64 with-under with-wild(132)>(...)
	|			|		*ANY(...)
	|			|			|	VERSION = *ANY / *HIGHEST-EXISTING / *UPPER-LIMIT /
	|			|			|		<composed-name 1..24 with-under with-wild(52)>
	|			|			|	,BASE = *STD / <composed-name 1..24 with-under with-wild>
	|			|		<composed-name 1..64 with-under with-wild(132)>(...)
	|			|			|	VERSION = *ANY / *HIGHEST-EXISTING / *UPPER-LIMIT /
	|			|			|		<composed-name 1..24 with-under with-wild(52)>
	|			|			|	,BASE = *STD / <composed-name 1..24 with-under with-wild>
	|			|	,TYPE = *ANY / *LMS-DEFAULT / <alphanum-name 1..8>
	|			|	,USER-DATE = *ANY / *TODAY / <date 8..10 with-compl> / *INTERVAL(...)
	|			|		*INTERVAL(...)
	|			|			|	FROM = 1900-01-01 / <date 8..10 with-compl>
	|			|			|	,TO = *TODAY / <date 8..10 with-compl>

		|			|	,CREATION-DATE = *ANY / *TODAY / <date 8..10 with-compl> / *INTERVAL(...)
		|			|		*INTERVAL(...)
		|			|			|	FROM = 1900-01-01 / <date 8..10 with-compl>
		|			|			|	,TO = *TODAY / <date 8..10 with-compl>
		|			|	,MODIFICATION-DATE = *ANY / *TODAY / <date 8..10 with-compl> / *INTERVAL(...)
		|			|		*INTERVAL(...)
		|			|			|	FROM = 1900-01-01 / <date 8..10 with-compl>
		|			|			|	,TO = *TODAY / <date 8..10 with-compl>
,TO-ELEMENT = *LIB RARY -ELEM ENT (...)
	*LIBRARY-ELEMENT(...)
		|	LIBRARY = *STD / *BY-SOURCE / <filename 1..54 without-vers> / *LINK(...)
		|		*LINK(...)
		|			|	LINK-NAME = <structured-name 1..8>
		|	,ELEMENT = *BY-SOUR CE (...) / <composed-name 1..132 with-under with-wild-constr>(...)
		|		*BY-SOURCE(...)
		|			|	VERSION = *LMS-DEF AULT / *BY-SOURCE / *HIGHEST-EXISTING / *INCREMENT /
		|			|					*UPPER-LIMIT / <composed-name 1..52 with-under with-wild-constr>
		|			|	,BASE = *STD / <composed-name 1..24 with-under with-wild>
		|		<composed-name 1..132 with-under with-wildcard-constr>(...)
		|			|	VERSION = *LMS-DEF AULT / *BY-SOURCE / *HIGHEST-EXISTING / *INCREMENT /
		|			|					*UPPER-LIMIT / <composed-name 1..52 with-under with-wild-constr>
		|			|	,BASE = *STD / <composed-name 1..24 with-under with-wild>
		|	,TYPE = *BY-SOUR CE / *LMS-DEFAULT / <alphanum-name 1..8>
		|	,USER-DATE = *TODAY / *BY-SOURCE / <date 8..10 with-compl>
,TEXT-PARAMETERS = *NONE / *PARAMETERS(...)
	*PARAMETERS(...)
		|	INPUT-RECORD-ID = *NONE / *RECORD-PART(...)
		|		*RECORD-PART(...)
		|			|	START = <integer 1..251>
		|			|	,LENGTH = <integer 1..16>
,WRITE-MODE = *LMS-DEF AULT / *CREATE / *REPLACE / *ANY
,DIALOG-CONTROL = *LMS-DEF AULT / *NO / *YES / *ERROR

ELEMENT = *LIBRARY-ELEMENT(...)

Specifies the desired member designation.

LIBRARY = *STD/ <filename 1..54 without-vers> / *LINK(...)
Specifies the library containing the member to be modified.

LIBRARY = *STD
The library opened by OPEN-LIBRARY.

LIBRARY = <filename 1..54 without-vers>
Name of the library containing the member to be modified.

LIBRARY = *LINK(...)
The library assigned via the link name.

LINK-NAME = <structured-name 1..8>
Link name of the library; this name was defined by means of a /ADD-FILE-LINK command prior to calling LMS.

ELEMENT = *ALL(...) / <composed-name 1..64 with-under with-wild(132)>(...)Specifies the member to be modified.

VERSION = *HIGHEST-EXISTING / *ALL / *UPPER-LIMIT /
<composed-name 1..24 with-under with-wild(52)>
Version of the member to be modified.

VERSION = *HIGHEST-EXISTING
The member with the highest existing version with reference to BASE is modified.

VERSION = *UPPER-LIMIT
The highest possible version X’FF’ in the library under the specified TYPE and name is modified.

VERSION = <composed-name 1..24 with-under with-wild(52)>
Explicitly specifies the version of the member to be modified.

BASE = *STD / <composed-name 1..24 with-under with-wild>
Prefix for the version selection. In conjunction with VERSION= *HIGHEST- EXISTING , it is then possible to use a certain prefix to reference the highest existing version. BASE=*STD has the same effect as BASE=*. For further information concerning specification of the base, see "Version designations".

TYPE = *LMS-DEFAULT / <alphanum 1..8>
Type of the member to be modified.

USER-DATE = *ANY / *TODAY / <date 8..10 with-compl> / *INTERVAL(...)Date given by the user.

USER-DATE = *ANY
The member to be modified has any date.

USER-DATE = *TODAY

The member with the current date is modified.

USER-DATE = <date 8..10 with-compl>
The member whose date is entered explicitly in the form [YY]YY-MM-DD is modified.

USER-DATE = *INTERVAL(...)
All members lying in the specified interval are modified.

FROM = 1900-01-01 / <date 8..10 with-compl>
Beginning of interval.

TO = *TODAY / <date 8..10 with-compl>
End of interval.

CREATION-DATE = *ANY / *TODAY / <date 8..10 with-compl> / *INTERVAL(...)Creation date of the member. For a description of the operands, see the USER-DATE operand of this statement.

MODIFICATION-DATE = *ANY / *TODAY / <date 8..10 with-compl> / *INTERVAL(...) Date of the last modification to the member. For a description of the operands, see the USER-DATE operand of this statement.

EXCEPT-ELEMENT = *NONE / *ELEMENT(...)
Specifies the members to be excluded from the above selection.

EXCEPT-ELEMENT = *NONE
No members are excluded from correction.

EXCEPT-ELEMENT = *ELEMENT(...)
Specifies the members that are to be excluded from modification. A member is excluded when all the fields of the EXCEPT-ELEMENT structure that are not set to *ANY identify the member as a hit. If all the fields of the EXCEPT-ELEMENT structure are set to *ANY, then all members will be excluded.
For a description of the operands, see the *LIBRARY-ELEMENT operand of this statement.

TO-ELEMENT = *LIBRARY-ELEMENT(...)
Specifies the destination to which and the name under which the corrected member is to be written back.

LIBRARY = *STD / *BY-SOURCE / <filename 1..54 without-vers> / *LINK(...) Specifies the library to which the corrected member is to be written back.

LIBRARY = *STD
The library opened by OPEN-LIBRARY.

LIBRARY = *BY-SOURCE
The corrected member is written back to the original library.

LIBRARY = <filename 1..54 without-vers>

Name of the library to which the corrected member is to be added.

LIBRARY = *LINK(...)
The library assigned via the link name.

LINK-NAME = <structured-name 1..8>
Link name of the library; this name was defined by means of a /ADD-FILE-LINK command prior to calling LMS.

ELEMENT = *BY-SOURCE(...) /
<composed-name 1..132 with-under with-wild-constr>(...)
Name that the corrected member is to receive.

ELEMENT = *BY-SOURCE(...)
The new name is the same as the old name.

VERSION = *LMS-DEFAULT / *BY-SOURCE / *HIGHEST-EXISTING /
*INCREMENT / *UPPER-LIMIT /
<composed-name 1..52 with-under with-wild-constr>
Version that the corrected member is to receive.

VERSION = *BY-SOURCE
The corrected member receives the same version as the original member. If the original member has no version specification, the corrected member receives X’FF’ as the version specification.

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.

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

VERSION = <composed-name 1..52 with-under with-wild-constr>
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".

ELEMENT = <composed-name 1..132 with-under with-wild-constr>(...)

Name of the corrected member. It can also be entered using wildcards.

VERSION = *LMS-DEFAULT / *BY-SOURCE / *HIGHEST-EXISTING /
*INCREMENT / *UPPER-LIMIT /
<composed-name 1..52 with-under with-wild-constr>
Version that the corrected member is to receive.
For a description of the operands, see above.

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 = *BY-SOURCE /*LMS-DEFAULT / <alphanum-name 1..8>
Type that the corrected member is to receive.

TYPE = *BY-SOURCE
The corrected member receives the same type designation as the original member.

USER-DATE = *TODAY / *BY-SOURCE / <date 8..10 with-compl>
Date given by the user.

USER-DATE = *TODAY
The current date is given.

USER-DATE = *BY-SOURCE
The new member is given the same date as the source member.

USER-DATE = <date 8..10 with-compl>
The date must be entered in the form [YY]YY-MM-DD.

TEXT-PARAMETERS = *NONE / *PARAMETERS(...)
Specifies parameters for textual members.

TEXT-PARAMETERS = *NONE
No parameters are specified for textual members.

TEXT-PARAMETERS = *PARAMETERS(...)
Specifies parameters for textual members.

INPUT-RECORD-ID = *NONE / *RECORD-PART(...)
Specifies the location of the record ID (see substatements for textual members on "MODIFY-ELEMENT substatements for member types R, C and L") in the input record.

INPUT-RECORD-ID = *NONE
No location is specified for the record ID of the input record.

INPUT-RECORD-ID = *RECORD-PART(...)

Specifies the beginning and length of the record ID area, where
beginning + length ≤ 252

START = <integer 1..251>
Specifies the first character in the record ID to indicate the beginning of the record ID area.

LENGTH = <integer 1..16>
Specifies the length of the record ID.

WRITE-MODE = *LMS-DEFAULT / *CREATE / *REPLACE / *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.
If the source member is the same as the target member, this operand is ignored.

WRITE-MODE = *CREATE
The name of the corrected member must not yet exist and is created as a new member.

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

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

DIALOG-CONTROL = *LMS-DEFAULT / *NO / *YES / *ERROR
This operand determines whether or not a dialog is to be conducted with the user during execution of a statement.

For more detailed information on dialog control, see the MODIFY-LMS-DEFAULTS statement on "MODIFY-LMS-DEFAULTS".

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 64 64 130 130 130 130	CMD0001 LMS0129 CMD0230 LMS1002 LMS0020 LMS0213 LMS0214 LMS0302 LMS0509 LMS0510 LMS1003 LMS1004 PLA0223 PLA0224 PLA0229 PLA0233 PLA0475 PLA0476 PLA0478 LMS0041 LMS0411 LMS0412 LMS0413	No error Statement aborted by user Syntax error Internal error Target member or target file does not exist Name exists as delta member Name exists as full member Member not found Target member or target file already exists Base not found Error during wildcard processing with at least one member or file 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

For ELEMENT: read authorization for LIBRARY and ELEMENT
If more than one member is affected by the statement, members without read authorization are excluded from the statement.

For TO-ELEMENT: read and write authorization for LIBRARY
Administer authorization where the specified member designation is new. Otherwise, only write authorization for the member existing under the specified member designation (administer authorization no longer required).

If WRITE-CONTROL is active and a base version exists, the USERID of the user must be entered as the HOLDER of the member specified by BASE. Only if write authorization has been granted can a new version be generated or this base version overwritten. In this case, administer authorization is no longer required.

Notes

• When creating a member, be sure to take into account the convention applicable to the member type.

• If WRITE-CONTROL is active in the output library, the access method adds a comment (record type 2) to the member which is to be written. The comment logs the HOLDER, DATE and TIME of the operation. The record is written as the first record of the record type. Any comment records which already exist or have been edited by means of INFORMATION=*COMMENT are copied after it. If, in addition, the member is written to the base of a different version (i.e. not the first version under a name), the member attributes STATE and HOLDER and all the rights of the base version are adopted for the new version. The CCSN is adopted from the source file. The USER-DATE is determined anew.