RETURN kopiert ein Element einer Quellbibliothek in eine Ausgabebibliothek, wenn die zur Zielversion angegebene Basis in der Ausgabebibliothek vom Benutzer reserviert ist. Es löscht das Element in der Quellbibliothek und gibt die Reservierung in der Ausgabebibliothek wieder zurück.
Zur ersten Version eines Elements gibt es noch keine Basis. RETURN erfordert in diesem Falle Administrationsrecht.
Mit ED1 wird das Quellelement, mit LD1 die Quellbibliothek, mit ED2 das Zielelement und mit LD2 die Zielbibliothek angegeben. LD1 und LD2 dürfen dieselbe Bibliothek bezeichnen. Typ, Name und Version des Elementes müssen vollständig angegeben werden.
ED3 bezeichnet die Basis zum Element ED2. Es muss gelten:
ED2.TYP=ED3.TYP, ED2.NAME=ED3.NAME
Ist keine Version in ED3.VERSION (=Blank) angegeben, so wird die vom Benutzer ausgeliehene Version als Basisversion genommen (Fehler bei Mehrdeutigkeit).
Es sind vier Subcodeangaben möglich: UNUSE, INCP, HIGP und INCB
Bei Subcodeangaben ungleich UNUSE wird die Versionsangabe besonders behandelt (siehe "ED Element Description"). Die Versionsangabe in ED3 wird ignoriert.
Zusätzlich kann der Benutzer in die Felder USER-DATE bzw. USER-TIME des ED2 ein Datum bzw. eine Uhrzeit eintragen. Soll das Datum und die Uhrzeit des Eingabeelementes übernommen werden, müssen die Felder mit Leerzeichen besetzt sein.
Die Parameter OVERWRITE und DESTROY werden ausgewertet.
OVERWRITE=EXTEND und OVERWRITE=NAME sind nicht zulässig.
Die Speicherungsform des Zielelements (ED2) ist durch die Basis (ED3) bestimmt.
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'1E' Versionsautomatismus (UNUSE oder INCP oder INCB oder HIGP) UP-Zugriffsidentifikation physikalisches Überschreiben logisches Überschreiben vollständiger DMS-Dateiname in LD |
LD1 | PASSWORD LINK MAX-NAME-LEN NAME | Bibliothek-Beschreibung (Quellbibliothek) Kennwort lt. PASSWORD-Kommando Dateikettungsname Maximale Länge des Bibliotheksnamen Bibliotheksname |
ED1 | TYP NAME VERSION | Element-Beschreibung (Quellelement) Elementtyp Elementname Elementversion |
LD2 | PASSWORD LINK MAX-NAME-LEN NAME | Bibliothek-Beschreibung (Zielbibliothek) Kennwort lt. PASSWORD-Kommando Dateikettungsname Maximale Länge des Bibliotheksnamen Bibliotheksname |
ED2 | TYP NAME VERSION STORE-FORM USER-DATE USER-TIME | Element-Beschreibung (Zielelement) Elementtyp Elementname Elementversion Speicherungsform vom Benutzer vergebenes Datum vom Benutzer vergebene Uhrzeit |
ED3 | TYP NAME VERSION | Element-Beschreibung (Basiselement) Elementtyp = ED2.TYP Elementname = ED2.NAME Elementversion (Basisversion) |
Rückkehrparameter
Parameterstruktur | Feld | Bedeutung |
CB | RETURNCODE LMS-MSG DMS-MSG PLAM-MSG | Funktionskontrollblock Returncode LMS-Meldungsschlüssel DMS-Meldungsschlüssel PLAM-Meldungsschlüssel |
LD1 | NAME | Bibliothek-Beschreibung (Quellbibliothek) vollständiger DMS-Dateiname der Bibliothek (abhängig |
ED1 | VERSION | Element-Beschreibung (Quellelement) Elementversion (falls Aufruf mit *HIGH) |
LD2 | NAME | Bibliothek-Beschreibung (Zielbibliothek) vollständiger DMS-Dateiname der Bibliothek (abhängig |
ED2 | VERSION | Element-Beschreibung (Zielelement) Elementversion (bei Versionsautomatismus und *HIGH) |