OPENGET Eröffnen eines Elementes zum Lesen

Mit OPENGET wird ein Element zum Lesen eröffnet. Mit ED wird das zu lesende 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.

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’.

Ein Element kann mehrfach zum Lesen eröffnet werden, wenn mehrfach OPENGET mit derselben Element- und Bibliotheksbezeichnung aufgerufen wird. Für jeden OPEN sollte ein eigener RD angelegt werden, weil bei jedem OPENGET eine neue Zugriffspfad-Identifikation im Feld REC-ACC-ID des RD hinterlegt wird. Diese Zugriffspfad-Identifikation wird für alle weiteren Zugriffe und zum Schließen des Elementes benötigt.

Ein Element kann nicht gleichzeitig mit OPENGET, OPENPUT und OPENUPD eröffnet werden.

Nach der Eröffnung steht der Lesezeiger (für sequentielles Lesen) auf dem Elementanfang.

Angaben zu USER-DATE, USER-TIME und STORE-FORM des ED werden nicht ausgewertet.

Elemente mit Format-B Sätzen können mit GET nur gelesen werden, wenn beim OPENGET der Subcode EXTRA gesetzt wird.

Aufrufparameter

Die Parameterstrukturen müssen beim UP-Aufruf in dieser Reihenfolge stehen.

Parameterstruktur	Feld	Bedeutung
CB	SCBVERSION FUNCTION SUBCODE ACC LD-RETURN	Funktionskontrollblock Schnittstellenversion Funktionscode X'0E' EXTRA: Format-B Sätze im Element erlaubt UNUSE: sonst UP-Zugriffsidentifikation 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	Element-Beschreibung 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 Feld LD-RETURN des CB)
ED	VERSION	Element-Beschreibung Elementversion (falls Aufruf mit *HIGH)