OPEN-LIBRARY - Globale Bibliothek öffnen

Mit OPEN-LIBRARY wird eine globale Bibliothek festgelegt und eröffnet. Diese wird in den anderen Anweisungen mit LIBRARY =*STD angesprochen.

Werden in einer Anweisung zwei Bibliotheken benötigt, so muss die 2. Bibliothek bei der Anweisung explizit oder über Dateikettungsnamen angegeben werden.

Globale Bibliotheken bleiben solange zugewiesen, bis sie explizit durch die CLOSE-LIBRARY-Anweisung geschlossen werden oder eine neue OPEN-LIBRARY-Anweisung gegeben wird.

Globale Bibliotheken werden standardmäßig nur zum Lesen eröffnet. Sollen sie zum Lesen und Schreiben eröffnet werden, muss der Operand MODE=*UPDATE gesetzt werden.Wird eine Bibliothek neu eingerichtet, muss sie mit MODE=*UPDATE erzeugt werden.

Format

OPEN-LIBRARY                                                                                                                                             

LIBRARY = <filename 1..54 without-vers> / *LINK(...)
	*LINK(...)
		|	LINK-NAME = <structured-name 1..8>
,MODE = *READ / *UPDATE(...)
	*UPDATE(...)
		|	STATE = *ANY / *OLD / *NEW

Operanden

LIBRARY = <filename 1..54 without-vers> / *LINK(...)
Angabe der Bibliothek, die als globale Bibliothek eingerichtet und eröffnet werden soll.

LIBRARY = <filename 1..54 without-vers>
Name der Bibliothek, die als globale Einstellung eingerichtet und eröffnet werden soll.

LIBRARY = *LINK(...)
Die über den Dateikettungsnamen zugewiesene Bibliothek wird als globale Bibliothek eingerichtet und eröffnet.

LINK-NAME = <structured-name 1..8>
Dateikettungsname der Bibliothek, der vor dem Aufruf von LMSCONV mit /ADD-FILE-LINK vereinbart wurde.

MODE = *READ / *UPDATE(...)
Öffnungsmodus der Bibliothek.

MODE = *READ
Die Bibliothek wird nur zum Lesen eröffnet. Sie muss bereits existieren.

 

MODE = *UPDATE(...)
Die Bibliothek wird zum Lesen und Schreiben eröffnet.

STATE = *ANY / *OLD / *NEW
Status der zu eröffnenden Bibliothek.

STATE = *ANY
Die Bibliothek kann existieren. Existiert sie nicht, so wird sie neu angelegt.

STATE = *OLD
Die Bibliothek muss existieren.

STATE = *NEW
Die Bibliothek darf nicht existieren. Sie wird neu angelegt.

Beispiele

Zuweisen einer existierenden Bibliothek LIB1 als globale Bibliothek:

//open-library library=lib1

Zuweisen einer existierenden Bibliothek als globale Bibliothek über den Dateikettungsnamen:

/add-file-link link-name=glob-lib,file-name=lib1
//start-lmsconv
. . .
//open-library library=*link(link-name=glob-lib)

Neuanlegen einer Bibliothek mit Zuweisung als globale Bibliothek:

//open-library library=lib1,mode=*update