ADD	Dateien in Bibliothek aufnehmen

ONXADD [t/] ['str1'= ... ] bibliothek [,CA] [,CPR] [,CL[typ]]

Die mit X angekreuzten Dateien/Bibliothekselemente werden als Elemente in die angegebene Bibliothek aufgenommen. Bei der Übertragung zwischen zwei PLAM-Bibliotheken werden die Versionsbezeichnungen der Elemente übernommen. Bei der Übertragung aus einer LMS-ISAM Bibliothek in eine PLAM-Bibliothek werden die Versionsbezeichnungen der Elemente nicht übernommen. Bei der Aufnahme von Dateien in eine PLAM-Bibliothek werden die neuen Elemente ohne Versionsbezeichnung angelegt.

	'str1'= ...	Namenstransformationsregeln

		'str1'='str2' | 'str1'=DP[n][I] | 'str1'=DS[n][I]

		'str1'='str2'

		Der Name des neuen Bibliothekselements wird gebildet, indem im ursprünglichen Namen die Zeichenfolge 'str1' gesucht und durch 'str2' ersetzt wird. Definitionsgemäß wird der String '_' (Hochkomma Leerzeichen Hochkomma) am Ende und der Nullstring '' am Anfang eines jeden Namens gefunden. Enthält der ursprüngliche Name die Zeichenfolge 'str1' nicht, so wird die Variable Action für dieses Datenobjekt nicht ausgeführt.

		'str1'=DP[n][I]

		Delete Prefix: Der Name des neuen Bibliothekselements wird gebildet, indem im ursprünglichen Namen die Zeichenfolge 'str1' gesucht und der links davorstehende Namensteil bzw. die n links davorstehenden Stellen gelöscht werden. Aufgrund des Zusatzes I wird auch das Suchitem 'str1' gelöscht.

		'str1'=DS[n][I]

		Delete Suffix: Der Name des neuen Bibliothekselements wird gebildet, indem im ursprünglichen Namen die Zeichenfolge 'str1' gesucht und der nachfolgende Namensteil bzw. die n nachfolgenden Stellen gelöscht werden. Aufgrund des Zusatzes I wird auch das Suchitem 'str1' gelöscht.

		Fehlt die Angabe 'str1'=..., so wird der Name des neuen Bibliothekselements 1 zu 1 aus dem Namen der Datei bzw. des ursprünglichen Bibliothekselements gebildet. Näheres zu den Namenstransformationsregeln siehe Seite 5-. Beispiele für die Namenstransformation finden Sie unten.

	t/	Nur bei Aufnahme in eine PLAM-Bibliothek: Die mit X markierten Datenobjekte werden als Elemente des angegebenen Typs in die PLAM-Bibliothek aufgenommen. Fehlt die Typangabe, so wird S/ als Standardtyp ergänzt. Beim Übertragen von Elementen von PLAM nach PLAM werden bei fehlender Typangabe die Elemente mit dem gleichen Typ wie in der Ursprungsbibliothek eingerichtet.

Der Benutzer kann beim Ankreuzen der Dateien den in der Variablen Action definierten Elementtyp durch Eintragen des Action-Codes Xt ändern. t bezeichnet einen von der Variablen Action abweichenden Elementtyp. Die Typangabe im Action-Code hat Vorrang vor dem in der Variablen Action festgelegten Typ. E ist als Typangabe im Action-Code nicht zulässig, da der Action-Code XE das Löschen der Ursprungsdatei bzw. des Elements nach erfolgreicher Aufnahme in die Zielbibliothek bewirkt.

	bibliothek	Name der Bibliothek, in der die Datenobjekte abzuspeichern sind.

	CA	Copy All Delta-Versions. Dieser Parameter ist nur von Bedeutung bei der Übertragung von deltagespeicherten Elementen einer PLAM-Bibliothek in eine zweite PLAM-Bibliothek. Deltagespeicherte Elemente werden strukturerhaltend, d.h. mit allen zugehörigen Versionen in die neue Bibliothek übertragen. Ohne Angabe der CA-Option (Standardfall) wird nur die in der Dateienliste mit X markierte Elementversion in die neue Bibliothek übertragen.

	CPR	Copy Protection Attributes. Dieser Parameter ist nur von Bedeutung bei der Übertragung von Elementen einer PLAM-Bibliothek in eine zweite PLAM-Bibliothek unter der eigenen Benutzerkennung. Evtl. vorhandene Read-, Write- und Execute-Passworte sowie die Basic Access Control Listen (BACL) der Ursprungselemente werden in die kopierten Elemente übernommen. Falls die Bibliothek-2 neu eingerichtet wird, werden auch die Bibliotheks- und Typattribute aus der Ursprungsbibliothek übernommen. Zu den Bibliotheksattributen gehören die Administrationsrechte (siehe Seite 6-) und die Standard-Schutzattribute für neue Elemente (siehe Seite 6-). Zu den Typattributen gehören die Standard-Schutzattribute für neu hinzukommende Elemente dieses Typs.

	CL[typ]	Create Library. Falls die Bibliothek noch nicht existiert, wird sie automatisch neu angelegt. Es erfolgt keine Rückfrage "Create ... Library ?". Falls die Bibliothek schon existiert, so bleibt dieser Parameter ohne Wirkung.

		Mit typ kann der Typ der Neu anzulegenden Bibliothek bestimmt werden. Mögliche Eingaben sind: F/L/P[1]/N. Standard: P

	Hinweise:

		Durch die Typangabe P1 wird eine PLAM-Bibliothek mit BLKSIZE=(STD,1) erzeugt. Standard ist (STD,2).

	Bei der Aufnahme von Dateien in eine PLAM-Bibliothek bzw. bei der Übertragung von Bibliothekselementen in eine andere PLAM-Bibliothek erbt das neue Element das Alter des Ursprungsobjekts.

	Beim Übertragen von Elementen einer PLAM-Bibliothek in eine andere PLAM-Bibliothek sind folgende Sonderfälle zu beachten:

	ONXADD '_'='suffix' bibliothek	ein Blank in String-1

	Bei Elementen mit Versionen wird die angegebene Suffix nach dem Elementnamen und vor der Versionsbezeichnung eingefügt.

	ONXADD '_'='/suffix' bibliothek	ein Blank in String-1

	Bei Elementen mit Versionsbezeichnung wird diese entfernt und durch die angegebene Version /suffix ersetzt.

	Bei Elementen ohne Version wird die angegebene Version /suffix an den Elementnamen angehängt.

	ONXADD '__'='suffix' bibliothek	zwei Blanks in String-1

	Bei Elementen mit Versionen wird die angegebene Suffix an die bestehende Versionsbezeichnung angehängt.