Your Browser is not longer supported

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

{{viewport.spaceProperty.prod}}

OPENUPD Eröffnen eines Elementes zum Lesen und Schreiben

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

ED


VERSION

Element-Beschreibung (Quell- und Zielelement)

Elementversion (falls Aufruf mit *HIGH oder bei Versionsautomatismus)