ADD Aufnehmen einer Datei als Element

Mit ADD kann eine Datei als Element in eine Bibliothek aufgenommen werden. Mit FD wird die Datei, mit ED1 das Element und mit LD die Bibliothek, in die es aufgenommen werden soll, angegeben.

Es sind vier Subcodeangaben möglich: UNUSE, INCP, HIGP und INCB
Bei Subcodeangaben ungleich UNUSE wird die Versionsangabe besonders behandelt (siehe "ED Element Description").

Zusätzlich kann der Benutzer in die Felder USER-DATE bzw. USER-TIME des ED1 ein Datum bzw. eine Uhrzeit eintragen. Soll durch LMS das aktuelle Datum und die aktuelle Uhrzeit eingetragen werden, müssen die Felder mit Leerzeichen besetzt sein.

Beim Zielelement wird das Katalogattribut CCS als Elementattribut eingetragen.

Die Parameter OVERWRITE, RKEY, DESTROY und PROT-IND werden ausgewertet.

Wird OVERWRITE=EXTEND angegeben, muss gelten:

• Im Element dürfen keine ISAM-Schlüssel vorhanden sein.

• Enthält das Element Dateiattribute (Satzart 164), müssen diese mit den Attributen der Datei übereinstimmen.

• Enthält das Element keine Dateiattribute, darf die Datei nicht RECORD-FORMAT= FIXED haben.

• Der CCS-Name der Datei muss mit dem des Elementes übereinstimmen.

OVERWRITE=NAME ist nicht zulässig.

Das Feld ED1.STORE-FORM bestimmt die Speicherungsform für das anzulegende Element. Die Speicherungsform darf den Einstellungen der Typattribute bzw. Bibliotheksattribute nicht widersprechen, und alle Elemente eines Typs und Namens müssen die gleiche Speicherungsform haben. Delta-Elemente können nur dann überschrieben werden, wenn sie Blätter eines Delta-Baumes sind.

STORE-FORM=FULL

Das Element wird vollgespeichert angelegt (Fehler, falls nicht zulässig).

STORE-FORM=STD

Das Element wird gemäß der für den Elementscope geforderten Speicherungsform angelegt. Widersprüchliche Anforderungen führen auf Fehler. Ist nichts besonderes gefordert, wird Vollspeicherung gewählt.
Ist die geforderte Speicherungsform DELTA, wird bei Subcode UNUSE die Basis als Standardbasis bestimmt. Bei allen anderen Subcodes wird die Basis durch die Angabe in ED1.VERSION bestimmt.

STORE-FORM=DELTA

Das Element wird delta-gespeichert angelegt (Fehler, falls nicht zulässig). Die Angabe ist zulässig für die Elementtypen S, P, D, J, M, X bzw. davon abgeleitete Elementtypen.Bei Subcode UNUSE muss zusätzlich die Beschreibung ED2 angegeben werden, die das Basiselement bezeichnet. Bei Verwendung des Versionsautomatismus wird die ED2 ignoriert, die Basisversion muss dann in der ED1 angegeben werden.

Behandlung von Delta-Elementen - ohne Versionsautomatismus:

• Soll das Element als Delta-Element aufgenommen werden, muss gelten:

  ED1.STORE-FORM=DELTA, ED1.TYP=ED2.TYP, ED1.NAME=ED2.NAME

• Soll das Element als erstes Element eines Delta-Baums aufgenommen werden, darf ein Element dieses Typs und Namens noch nicht existieren und es muss zusätzlich gelten:

  ED1.VERSION=ED2.VERSION

• Soll das Element als weiteres Element eines Delta-Baums aufgenommen werden, muss mit ED2 das bereits existierende Basiselement angegeben werden und es muss gelten:

  ED1.VERSION != ED2.VERSION

Aufrufparameter

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

Parameterstruktur	Feld	Bedeutung
CB	SCBVERSION FUNCTION SUBCODE ACC DESTROY RKEY OVERWRITE PROT-IND LD-RETURN	Funktionskontrollblock Schnittstellenversion Funktionscode X'08' Versionsautomatismus (UNUSE oder INCP oder INCB oder HIGP) UP-Zugriffsidentifikation physikalisches Überschreiben ISAM-Schlüssel und Dateiattribute logisches Überschreiben Elementschutz vollständiger DMS-Dateiname in LD
FD	PASSWORD LINK NAME	Datei-Beschreibung Kennwort lt. PASSWORD-Kommando Dateikettungsname Dateiname
LD	PASSWORD LINK MAX-NAME-LEN NAME	Bibliothek-Beschreibung Kennwort lt. PASSWORD-Kommando Dateikettungsname Maximale Länge des Bibliotheksnamens Bibliotheksname
ED1	TYP NAME VERSION STORE-FORM USER-DATE USER-TIME	Element-Beschreibung (Ziel) Elementtyp Elementname Elementversion Speicherungsform vom Benutzer vergebenes Datum vom Benutzer vergebene Uhrzeit
ED2	TYP NAME VERSION	Element-Beschreibung (Basis) falls ED1.STORE-FORM = DELTA und Subcode = Blank 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
FD	NAME	Datei-Beschreibung Dateiname (falls Datei durch Dateikettungsnamen gegeben)
LD	NAME	Bibliothek-Beschreibung (Zielbibliothek) vollständiger DMS-Dateiname der Bibliothek (abhängig vom Feld LD-RETURN des CB)
ED1	VERSION	Element-Beschreibung (Zielelement) Elementversion (falls Aufruf mit *HIGH oder bei Versionsautomatismus)