The ED descriptor identifies a member. There are restrictions for the following functions:
OPENGET
TYP
Member types C and L are allowed only if the EXTRA subcode is set in the OPENGET call.
OPENPUT, OPENUPD
TYP
Member types C and L are not allowed, as members of these types contain records which cannot be processed.
COPY, COPYSTR, DEL, OPENGET, PROVIDE, REN, RETURN, SEL
The member designation of the input member is not checked for conformance
with LMS conventions (exception: member type for COPY,
PROVIDE, REN, RETURN).ADD, COPY, COPYSTR, LOCK, OPENPUT, OPENUPD, PROVIDE, REN, RETURN, UNLOCK
The following rules apply for the member designation of the output member:
TYP
The member type must be a valid standard LMS type (S, M, P, D, J, X, R, C, L, H, F, U) or derived from one of the above (see "LMS (BS2000) SDF Format" [1]). The standard types (R, C, L, H, F, U) and types derived from them are not permitted for delta members.
NAME
The name must meet the standards described in [1].
VERSION
The version must meet the standards described in [1]. @ is not a valid
version designation. If the user wishes to generate the highest possible
version, X’FF’ followed by at least one blank must be entered explicitly. The string Vn. (n=0-9) is not converted to V0n.ADD, COPY, OPENPUT, OPENUPD, PROVIDE, REN, RETURN
USER-DATE
The first 10 characters of the date must always have the format YYYY-MM-DD (although only a syntax check for zzzz-zz-zz is performed). The
remaining 4 characters are not checked; they should have the format dddB, where ddd stands for the current day of year and B for blank.USER-TIME
The time of day is not checked for syntax errors and should be specified in the form HH:MM:SS.
ADD, COPY, OPENPUT, PROVIDE
STORE-FORM
The storage mode value must either STD, DELTA or FULL.
ADD, COPY, OPENPUT, PROVIDE, REN, RETURN
The following rules apply to the member description of the output member:
Due to version automation, the ED version field for the output member contains the following, depending on the subcode:
Subcode
Contents
INCP
Prefix 1
HIGP
Prefix 1
INCB
Base
1 The prefix may also consist of the empty version (blanks) and has a maximum length of 23 characters.If the subcode is not a blank, the base ED for delta members (ED2 or ED3 for COPY) is ignored.
If the target ED has a member type for which the convention STD-TREE is valid, abbreviated versions (e.g. 2.3) are converted into the internal format (002.003).
When version automation is in use, the named fields are likewise used to write the written target version back. Specified prefix and base entries are overwritten during this process.
Field | Meaning | Length | Contents after |
TYP | Member type | 8 | 8 x X'40' |
NAME | Member name | 64 | 64 x X'40' |
VERSION | Member version | 24 | 24 x X'40' |
STORE-FORM | Storage mode of member ́S ́: STD: (FULL or DELTA) ́D ́: DELTA: delta member ́V ́: FULL: non-delta member | 1 | C’V’ |
USER-DATE | Date specified by user | 14 | 14 x X'40' |
USER-TIME | Time of day specified by user | 8 | 8 x X'40' |
The descriptor ED is required in the following functions:
ADD, COPY, COPYSTR, DEL, GSYSELEM, LOCK, LST, MODEA, MODEP, OPENGET, OPENPUT, OPENUPD, PROVIDE, REN, RETURN, SEL, UNLOCK.
With the ADD, COPY, DEL, LOCK, LST, MODEA, MODEP, OPENGET, OPENUPD, OPENPUT, PROVIDE, REN, RETURN, SEL and UNLOCK functions, the EDVERS field in the source and target member specification in ED may contain the string *HIGH followed by a blank. This allows the user to specify the highest version for the given member name without first having to use the TOC function to look it up. LMS automatically looks up the highest version and returns it in the EDVERS field, overwriting the string *HIGH. The user has to set up a loop to keep passing the value *HIGH to the EDVERS field.