Mit OPENUPD wird ein Element zum Lesen und Schreiben eröffnet. Mit ED wird das zu lesende und schreibende Element und mit LD die Bibliothek, in der es sich befindet, angegeben. Typ, Name und Version des bereits existierenden Elementes müssen vollständig angegeben werden. Zusätzlich kann der Benutzer in die Felder USER-DATE bzw. USER-TIME des ED ein Datum bzw. eine Uhrzeit eintragen. Soll das aktuelle Datum und die aktuelle Uhrzeit übernommen werden, müssen die Felder mit Leerzeichen besetzt sein.
Der Parameter DESTROY wird ausgewertet, damit ein Element gegebenenfalls physikalisch gelöscht werden kann.
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 OPENUPD-Aufrufe auf verschiedene Elemente, aber nicht auf dasselbe Element erfolgen. Für jeden sollte ein eigener RD angelegt werden, weil bei jedem OPENUPD-Aufruf eine neue Zugriffspfad-Identifikation im Feld REC-ACC-ID des RD hinterlegt wird.
GET- und PUT-Zugriffe werden koordiniert. Es kann noch die alte Variante gelesen werden, während schon eine neue Variante geschrieben wird. GET- und PUT-Aufrufe, die unter derselben Zugriffspfad-Identifikation aufgerufen werden, beeinflussen sich nicht.
Ein Element kann nicht gleichzeitig mit OPENGET, OPENPUT und OPENUPD eröffnet werden.
Das Feld STORE-FORM des ED wird nicht ausgewertet; der alte Wert kann nicht verändert werden.
Der Elementtypen C und L sind nicht erlaubt, da Elemente dieses Typs nicht verarbeitbare Sätze enthalten.
OPENUPD auf Delta-Elemente ist nur dann möglich, wenn sie Blätter eines Deltabaumes sind.
Wenn nur ein Satz verändert werden soll, muss trotzdem das ganze Element gelesen und geschrieben werden.
Aufrufparameter
Die Parameterstrukturen müssen beim UP-Aufruf in dieser Reihenfolge stehen.
Parameterstruktur | Feld | Bedeutung |
CB | SCBVERSION FUNCTION SUBCODE ACC DESTROY LD-RETURN | Funktionskontrollblock Schnittstellenversion Funktionscode X'10' Subcode wird zur Zeit nicht genutzt: UNUSE UP-Zugriffsidentifikation physikalisches Ü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 |
ED | TYP NAME VERSION USER-DATE USER-TIME | Element-Beschreibung (Quelle, Ziel) 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 |
RD | REC-ACC-ID | Satzbeschreibung Zugriffspfad-Identifikation |
LD | NAME | Bibliothek-Beschreibung vollständiger DMS-Dateiname der Bibliothek (abhängig vom |
ED | VERSION | Element-Beschreibung (Quell- und Zielelement) Elementversion (falls Aufruf mit *HIGH oder bei Versionsautomatismus) |