Mit OPENPUT wird ein Element zum Schreiben eröffnet. Mit ED1 wird das zu schreibende Element und mit LD die Bibliothek, in der es sich befindet, angegeben.
Typ, Name und Version des Elementes müssen vollständig angegeben werden.
Es sind vier Subcodeangaben möglich: UNUSE, INCP, HIGP und INCB
Bei Subcodeangaben ungleich UNUSE wird die Versionsangabe besonders behandelt (siehe "ED Element Description").
Ist die Bibliothek nicht vorhanden, so wird sie eingerichtet. Zusätzlich kann der Benutzer in die Felder USER-DATE bzw. USER-TIME des ED1 ein Datum bzw. eine Uhrzeit eintragen. Soll das aktuelle Datum und die aktuelle Uhrzeit übernommen werden, müssen die Felder mit Leerzeichen besetzt sein.
Die Parameter OVERWRITE und DESTROY werden ausgewertet. OVERWRITE=NAME ist nicht zulässig. Delta-Elemente können nur dann überschrieben werden, wenn sie Blätter eines Delta-Baumes sind.
Bei der Eröffnung wird zur Identifizierung des Zugriffspfades eine Zugriffspfad-Identifikation im Feld REC-ACC-ID des RD hinterlegt. Ist bei der Eröffnung ein Fehler aufgetreten, hat sie den Wert 4 x X’FF’.
Es können nacheinander mehrere OPENPUT-Aufrufe auf verschiedene Elemente, aber nicht auf dasselbe Element erfolgen. Für jeden Aufruf sollte ein eigener RD angelegt werden, weil bei jedem OPENPUT-Aufruf eine neue Zugriffspfad-Identifikation im Feld REC-ACC-ID des RD hinterlegt wird.
Ein Element kann nicht gleichzeitig mit OPENGET, OPENPUT und OPENUPD eröffnet werden.
Die Elementtypen C und L sind nicht erlaubt, da Elemente dieser Typen nicht verarbeitbare Sätze enthalten.
Das Feld ED1.STORE-FORM bestimmt die Speicherungsform für das anzulegende Element. Die Speicherungsform darf den Einstellungen der Typattribute bzw. Bibliotheksattribute nicht widersprechen, und alle Elemente eines Typs und Namens müssen die gleiche Speicherungsform haben. Delta-Elemente können nur dann überschrieben werden, wenn sie Blätter eines Delta-Baumes sind.
STORE-FORM=FULL
Das Element wird vollgespeichert angelegt (Fehler, falls nicht zulässig).
STORE-FORM=STD
Das Element wird gemäß der für den Elementscope geforderten Speicherungsform angelegt. Widersprüchliche Anforderungen führen auf Fehler. Ist nichts Besonderes gefordert, wird Vollspeicherung gewählt.
Ist die geforderte Speicherungsform DELTA, wird bei Subcode UNUSE die Basis als Standardbasis bestimmt. Bei allen anderen Subcodes wird die Basis durch die Angabe in ED1.VERSION bestimmt.
STORE-FORM=DELTA
Das Element wird delta-gespeichert angelegt (Fehler, falls nicht zulässig). Die Angabe ist zulässig für die Elementtypen S, P, D, J, M, X bzw. davon abgeleitete Elementtypen.Bei Subcode UNUSE muss zusätzlich die Beschreibung ED2 angegeben werden, die das Basiselement bezeichnet. Bei Verwendung des Versionsautomatismus wird die ED2 ignoriert, die Basisversion muss dann in der ED1 angegeben werden.
Behandlung von Delta-Elementen - ohne Versionsautomatismus
Soll das Element als Delta-Element aufgenommen werden, muss gelten:
ED1.STORE-FORM=DELTA, ED1.TYP=ED2.TYP, ED1.NAME=ED2.NAME
Soll das Element als erstes Element eines Delta-Baums aufgenommen werden, darf ein Element dieses Typs und Namens noch nicht existieren und es muss zusätzlich gelten:
ED1.VERSION=ED2.VERSION
Soll das Element als weiteres Element eines Delta-Baums aufgenommen werden, muss mit ED2 das bereits existierende Basiselement angegeben werden und es muss gelten:
ED1.VERSION ? ED2.VERSION
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'0F' Versionsautomatismus (UNUSE oder INCP oder INCB oder HIGP) UP-Zugriffsidentifikation physikalisches Überschreiben logisches Überschreiben vollständiger DMS-Dateiname in LD |
RD | - | Satzbeschreibung keine Versorgung notwendig |
LD | PASSWORD LINK MAX-NAME-LEN NAME | Bibliothek-Beschreibung Kennwort lt. PASSWORD-Kommando Dateikettungsname Maximale Länge des Bibliotheksnamen Bibliotheksname |
ED1 | TYP NAME VERSION STORE-FORM USER-DATE USER-TIME | Element-Beschreibung (Ziel) Elementtyp Elementname Elementversion Speicherungsform vom Benutzer vergebenes Datum vom Benutzer vergebene Uhrzeit |
ED2 | TYP NAME VERSION | Element-Beschreibung (Basis) falls ED1.STORE-FORM = DELTA Elementtyp Elementname Elementversion |
Rückkehrparameter
Parameterstruktur | Feld | Bedeutung |
CB | RETURNCODE LMS-MSG DMS-MSG PLAM-MSG | Funktionskontrollblock Returncode LMS-Meldungsschlüssel DMS-Meldungsschlüssel PLAM-Meldungsschlüssel |
RD | REC-ACC-ID | Satzbeschreibung Zugriffspfad-Identifikation |
LD | NAME | Bibliothek-Beschreibung vollständiger DMS-Dateiname der Bibliothek (abhängig vom |
ED1 | VERSION | Element-Beschreibung (Zielelement) Elementversion (falls Aufruf mit *HIGH oder bei Versionsautomatismus) |