Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

RETURN Rückgabe eines Elementes

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
vom Feld LD-RETURN des CB)

ED1


VERSION

Element-Beschreibung (Quellelement)

Elementversion (falls Aufruf mit *HIGH)

LD2


NAME

Bibliothek-Beschreibung (Zielbibliothek)

vollständiger DMS-Dateiname der Bibliothek (abhängig
vom Feld LD-RETURN des CB)

ED2


VERSION

Element-Beschreibung (Zielelement)

Elementversion (bei Versionsautomatismus und *HIGH)