Mit REN kann ein Element umbenannt werden. Mit ED1 wird das umzubenennende Element, mit LD die Bibliothek, in der es sich befindet, angegeben. Mit ED2 wird die neue Bezeichnung des Elementes bestimmt. Sowohl beim Eingabeelement als auch beim Ausgabeelement müssen Typ, Name und Version vollständig angegeben werden.
Beim Ausgabeelement muss zusätzlich noch ein gültiges vom Benutzer zu vergebendes Datum und ebenso eine gültige Uhrzeit angegeben werden. Sollen sich Datum und Uhrzeit gegenüber dem Eingabeelement nicht ändern, müssen die entsprechenden Felder mit Leerzeichen besetzt sein. Datum und Uhrzeit können nur gemeinsam geändert werden. Das bedeutet:
ist das USER-DATE in der Beschreibung ED2 ein Leerzeichen, so wird die USER-TIME in ED2 ignoriert und die alten Elementangaben bleiben erhalten.
ist das USER-DATE in der Beschreibung ED2 ungleich einem Leerzeichen, so werden USER-DATE und USER-TIME aus ED2 unverändert übernommen.
Die Parameter DESTROY und OVERWRITE werden ausgewertet. OVERWRITE= EXTEND und OVERWRITE=NAME wirken wie OVERWRITE=NO.
Ein Umbenennen von Delta-Elementen ist nicht möglich. Ebenso darf das Ausgabeelement nicht bereits als Delta-Element existieren.
Es sind vier Subcodeangaben möglich: UNUSE, INCP, HIGP und INCB
Bei Subcodeangaben ungleich UNUSE wird die Versionsangabe besonders behandelt (siehe "ED Element Description").
Aufrufparameter
Die Parameterstrukturen müssen beim UP-Aufruf in dieser Reihenfolge stehen.
Parameterstruktur | Feld | Bedeutung |
CB | SCBVERSION FUNCTION SUBCODE ACC DESTROY OVERWRITE LD-RETURN | Funktionskontrollblock Schnittstellenversion Funktionscode X'06' Versionsautomatismus (INCP oder INCB oder INCB oder HIGP) UP-Zugriffsidentifikation physikalisches Überschreiben logisches Überschreiben vollständiger DMS-Dateiname in LD |
LD | PASSWORD LINK MAX-NAME-LEN NAME | Bibliothek-Beschreibung Kennwort lt. PASSWORD-Kommando Dateikettungsname Maximale Länge des Bibliotheksnamen Bibliotheksname |
ED1 | TYP NAME VERSION | Element-Beschreibung (alt) Elementtyp Elementname Elementversion |
ED2 | TYP NAME VERSION USER-DATE USER-TIME | Element-Beschreibung (neu) Elementtyp Elementname Elementversion vom Benutzer vergebenes Datum vom Benutzer vergebene Uhrzeit |
Rückkehrparameter
Parameterstruktur | Feld | Bedeutung |
CB | RETURNCODE LMS-MSG DMS-MSG PLAM-MSG | Funktionskontrollblock Returncode LMS-Meldungsschlüssel DMS-Meldungsschlüssel PLAM-Meldungsschlüssel |
LD | NAME | Bibliothek-Beschreibung vollständiger DMS-Dateiname der Bibliothek (abhängig |
ED1 | VERSION | Element-Beschreibung (alt) Elementversion (falls Aufruf mit *HIGH) |