The MODIFY-ELEMENT statement initiates the modification of members. The modifications themselves are controlled by way of substatements.
MODIFY-ELEMENT selects the members to be modified.
Once the MODIFY-ELEMENT statement has been sent, LMSCONV expects a substatement as the next statement. If another statement is entered instead of a substatement, an error message is issued.
Format
MODIFY-ELEMENT | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
ELEMENT = *LIBRARY-ELEMENT(...)Specifications for 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.
ELEMENT = *ALL(...) / <composed-name 1..64 with-under with-wild(132)>(...)
ELEMENT = *ALL(...)
All members are specified.
ELEMENT = <composed-name 1..64 with-under with-wild(132)>(...)
Name of 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 is modified.
VERSION = *ALL
All versions of the member are 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.
TYPE = *DEFAULT / <alphanum-name 1..8>
Type of the member to be modified. If the value is *DEFAULT and the current value set with MODIFY-DEFAULTS is *NONE, LMSCONV requires a type specification.
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.
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.
ELEMENT = *BY-SOURCE(...) / <composed-name 1..132 with-under with-wildcard-constr>(...)
Name that the corrected member is to receive.
ELEMENT = *BY-SOURCE(...)
The new name is the same as the old name.
VERSION = *DEFAULT / *BY-SOURCE / *UPPER-LIMIT /
<composed-name 1..52 with-under with-wildcard-constr>
Version that the corrected member is to receive.
VERSION = *DEFAULT
The default value is *BY-SOURCE (see below) or the current value set with
MODIFY-DEFAULTS.
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 = *UPPER-LIMIT
The highest possible version X'FF' is generated.
VERSION = <composed-name 1..52 with-under with-wildcard-constr>
The text specified here is interpreted as the version designation.
ELEMENT = <composed-name 1..132 with-under with-wildcard-constr>(...)
Name of the corrected member. It can also be entered using wildcards.
VERSION = *DEFAULT / *BY-SOURCE / *UPPER-LIMIT /
<composed-name 1..52 with-under with-wildcard-constr>
Version that the corrected member is to receive. For a description of the operands, see above.
TYPE = *BY-SOURCE / *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.
TYPE = *DEFAULT
If the value is *DEFAULT and the current value set with MODIFY-DEFAULTS is *NONE, LMSCONV requires a type specification.
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 specified 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 section “Substatements of MODIFY-ELEMENT for text members”) 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 = *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 = *DEFAULT
The default value is *CREATE (see below) or the current value set with MODIFY-DEFAULTS.
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 = *DEFAULT / *NO / *YES / *ERROR
This operand specifies whether or not the execution of the statement is carried out interactively with the user.
For more detailed information on dialog control, see the MODIFY-DEFAULTS statement.
DIALOG-CONTROL = *DEFAULT
The default value is *NO or the current value set with MODIFY-DEFAULTS.
DIALOG-CONTROL = *NO
All members are processed without dialog queries, i.e. without the user being able to take control.
Exception: If a member or a library is locked, LMSCONV inquires whether the attempt to access it shall be repeated.
DIALOG-CONTROL = *YES / *ERROR
See the description in the MODIFY-DEFAULTS statement .