REN renames a member. ED1 specifies the member to be renamed, LD the library containing this member and ED2 the new designation of the member. The complete type, name and version must be specified both for the input member and for the output member. In addition, a valid user-defined date and time of day must be specified for the output member. If the date and time of the input member are to be taken over, the corresponding fields must contain blanks.
The date and time can only be changed together. This means:
If the USER-DATE in the ED2 descriptor is a blank, the USER-TIME in ED2 is ignored and the old member attributes are retained.
If the USER-DATE in the ED2 descriptor is not a blank, the USER-DATE and USER-TIME from ED2 are taken over unchanged.
The parameters DESTROY and OVERWRITE are interpreted.
OVERWRITE=EXTEND and OVERWRITE=NAME have the same effect as OVERWRITE=NO.
Delta members cannot be renamed. The output member must not yet exist as a delta member.
There are four possible subcode specifications: UNUSE, INCP, HIGP and INCB
Subcode specifications other than UNUSE result in special treatment of the version specification (see "ED (Element Description)").
Call parameters
The parameter structures must be given in the following sequence in the subroutine call.
Parameter | Field | Meaning |
CB | SCBVERSION FUNCTION SUBCODE ACC DESTROY OVERWRITE LD-RETURN | Function control block Interface version Function code X’06’ Version automation Subroutine access identification Physical overwriting Logical overwriting Full DMS file name in LD |
LD | PASSWORD LINK MAX-NAME-LEN NAME | Library descriptor Password as per PASSWORD command Link name Maximum length of library name Library name |
ED1 | TYP NAME VERSION | Member descriptor (old) Member type Member name Member version |
ED2 | TYP NAME VERSION USER-DATE USER-TIME | Member descriptor (new) Member type Member name Member version Date specified by user Time of day specified by user |
Return parameters
Parameter | Field | Meaning |
CB | RETURNCODE LMS-MSG DMS-MSG PLAM-MSG | Function control block Return code LMS message code DMS message code PLAM message code |
LD | NAME | Library descriptor Full DMS file name of library (dependent on LD-RETURN field of CB) |
ED1 | VERSION | Member descriptor (old) Member version (if call used *HIGH) |