Mit dieser Anweisung können der Elementname, die Version, das Benutzerdatum, der CCS-Name und der Elementzustand geändert werden. Die Anweisung ist für alle Elementtypen zulässig.
Der Basistyp für Quell- und Zielelement darf unterschiedlich sein, wenn Textelemente bearbeitet werden.
Das Ändern einer Elementbezeichnung ist für Delta-Elemente oder bei aktivem WRITE-CONTROL nicht zugelassen.
MODIFY-ELEMENT-ATTRIBUTES | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ELEMENT = *LIBRARY-ELEMENT(...)
Angaben für die gewünschte Elementbezeichnung.
LIBRARY = *STD / <filename 1..54 without-vers> / *LINK(...)
Angabe der Bibliothek, in der sich das Element befindet.
LIBRARY = *STD
Die durch OPEN-LIBRARY eröffnete Bibliothek.
LIBRARY = <filename 1..54 without-vers>
Name der Bibliothek, in der sich das Element befindet.
LIBRARY = *LINK(..)
Die über den Dateikettungsnamen zugewiesene Bibliothek.
LINK-NAME = <structured-name 1..8>
Dateikettungsname der Bibliothek, der vor dem Aufruf von LMS mit einem /ADD-FILE-LINK-Kommando vereinbart wurde.
ELEMENT = *ALL(...) / <composed-name 1..64 with-under with-wild(132)>(...)
Name des Elementes, dessen Attribute geändert werden sollen.
VERSION = *HIGHEST-EXISTING / *ALL / *UPPER-LIMIT /
<composed-name 1..24 with-under with-wild(52)>
Version, die das Element besitzt.
VERSION = *HIGHEST-EXISTING
Die Attribute des Elementes mit der höchsten bestehenden Version werden geändert.
VERSION = *UPPER-LIMIT
Die in der Bibliothek unter dem angegebenen TYPE und Namen höchstmögliche Version X’FF’ des Elementes wird verwendet.
VERSION = <composed-name 1..24 with-under with-wild(52)>
Explizite Angabe der Version des Elements.
BASE = *STD / <composed-name 1..24 with-under with-wild>
Präfix für die Versionsauswahl. Im Zusammenhang mit VERSION=*HIGHEST-EXISTING kann damit die höchste Version mit einem bestimmten Präfix angesprochen werden. BASE=*STD wirkt wie BASE=*. Näheres zur Angabe der Basis siehe "Versionsbezeichnungen".
TYPE = *LMS-DEFAULT / *ALL / <alphanum-name 1..8 with-wild(20)>Typ, den das Element besitzt.
USER-DATE = *ANY / *TODAY / <date 8..10 with-compl> / *INTERVAL(...)Datum, das vom Benutzer vergeben wurde.
USER-DATE = *ANY
Das Element besitzt ein beliebiges Datum.
USER-DATE = *TODAY
Das Element mit dem aktuellen Tagesdatum wird verwendet.
USER-DATE = <date 8..10 with-compl>
Das Element, dessen Datum explizit in der Form [JJ]JJ-MM-TT eingegeben wird, wird verwendet.
USER-DATE = *INTERVAL(...)
Alle Elemente, die in dem angegebenen Zeitraum liegen, werden verwendet.
FROM = 1900-01-01 / <date 8..10 with-compl>
Beginn des Zeitraums.
TO = *TODAY / <date 8..10 with-compl>
Ende des Zeitraums.
CREATION-DATE = *ANY / *TODAY / <date 8..10 with-compl> / *INTERVAL(...)
Erzeugungsdatum des Elementes. Beschreibung der Operanden siehe Operand USER-DATE dieser Anweisung.
MODIFICATION-DATE = *ANY / *TODAY / <date 8..10 with-compl> / *INTERVAL(...)
Datum der letzten Änderung für das Element. Beschreibung der Operanden siehe Operand USER-DATE dieser Anweisung.
CODED-CHARACTER-SET = *ANY / *NONE / <name 1..8 with-wild(20)>
Zeichensatz, der dem Element zugeordnet ist.
CODED-CHARACTER-SET = *ANY
Die Elemente werden unabhängig von dem zugeordneten Zeichensatz ausgewählt.
CODED-CHARACTER-SET = *NONE
Die Elemente, denen kein Zeichensatz zugeordnet ist, werden ausgewählt.
CODED-CHARACTER-SET = <name 1..8 with-wild(20)>
Die Elemente, denen der angegebene Zeichensatz zugeordnet ist, werden ausgewählt.
STATE = *ANY / *FREE / *IN-HOLD(...)
Zustand, der dem Element zugeordnet ist.
STATE = *ANY
Es werden Elemente unabhängig von STATE ausgewählt.
STATE = *FREE
Nur Elemente mit STATE=FREE werden ausgewählt.
STATE = *IN-HOLD(...)
Nur Elemente mit STATE=IN-HOLD werden ausgewählt.
HOLDER = *ANY / <name 1..8 with-wild(20)>
HOLDER, der dem Element zugeordnet ist.
HOLDER = *ANY
Die Elemente werden, unabhängig vom HOLDER, ausgewählt.
HOLDER = <name 1..8 with-wild(20)>
Nur Elemente, denen ein zum Muster passender HOLDER zugeordnet ist, werden ausgewählt.
EXCEPT-ELEMENT = *NONE / *ELEMENT(...)
Angabe der Elemente, die von der oben getroffenen Auswahl ausgeschlossen werden.
EXCEPT-ELEMENT = *NONE
Es wird kein Element ausgeschlossen
EXCEPT-ELEMENT = *ELEMENT(...)
Angabe der Elemente, deren Attribute von einer Änderung ausgeschlossen werden sollen. Ein Element wird ausgeschlossen, wenn alle Felder der EXCEPT-ELEMENT-Struktur, die nicht auf *ANY gesetzt sind, das Element als Treffer ausweisen. Sind alle Felder der EXCEPT-ELEMENT-Struktur auf *ANY gesetzt, so werden alle Elemente ausgeschlossen.
Zur Beschreibung der Operanden siehe Operand *LIBRARY-ELEMENT dieser Anweisung.
NEW-ATTRIBUTES = *PARAMETERS(...)
Angabe der Attribute, die das Zielelement erhalten soll.
ELEMENT = *BY-SOURCE(...) /
<composed-name 1..132 with-under with-wild-constr>(...)
Neuer Name, den das Element erhalten soll.
ELEMENT = *BY-SOURCE(...)
Der neue Name entspricht dem alten Namen. Das Element wird nicht umbenannt.
VERSION = *BY-SOURCE / *LMS-DEFAULT / *HIGHEST-EXISTING /
*INCREMENT / *UPPER-LIMIT /
<composed-name 1..52 with-under with-wild-constr>
Version, die das Element erhalten soll. Das Element wird nicht umbenannt, sondern nur die Version.
VERSION = *BY-SOURCE
Das neue Element erhält die gleiche Version wie das ursprüngliche Element.
VERSION = *HIGHEST-EXISTING
Abhängig von der unter dem Typ geltenden Konvention wird unter existierenden Elementen gleichen Typs und Namens die höchste zu BASE passende Version überschrieben, ansonsten wird eine Defaultversion erzeugt.
VERSION = *INCREMENT
Abhängig von der unter dem Typ geltenden Konvention wird unter existierenden Elementen gleichen Typs und Namens eine neue, höhere Version erzeugt, ansonsten eine Defaultversion (siehe auch "Konvention: STD-TREE").
VERSION = *UPPER-LIMIT
Die höchstmögliche Version X’FF’ wird erzeugt.
VERSION = <composed-name 1..52 with-under with-wild-constr>
Der hier angegebene Text wird als Versionsbezeichnung interpretiert.
BASE = *STD / <composed-name 1..24 with-under with-wild>
Legt die Basis für das Zielelement fest. Näheres zur Angabe der Basis siehe "Versionsbezeichnungen".
ELEMENT = <composed-name 1..132 with-under with-wild-constr>(...)
Der neue Name des Elementes kann auch mit Wildcards eingegeben werden.
VERSION = *BY-SOURCE / *LMS-DEFAULT / *HIGHEST-EXISTING /
*INCREMENT / *UPPER-LIMIT /
<composed-name 1..52 with-under with-wild-constr>
Version, die das umzubennendende Element erhalten soll.
Beschreibung der Operanden siehe oben.
BASE = *STD / <composed-name 1..24 with-under with-wild>
Legt die Basis für das Zielelement fest. Näheres zur Angabe der Basis siehe "Versionsbezeichnungen".
TYPE = *BY-SOURCE / *LMS-DEFAULT / <alphanum-name 1..20 with-wild-constr>
Typ, den das umzubenennende Element erhalten soll.
TYPE = *BY-SOURCE
Das umzubenennende Element erhält die gleiche Typbezeichnung wie das ursprüngliche Element.
USER-DATE = *BY-SOURCE / *TODAY / <date 8..10 with-compl>
Datum, das vom Benutzer vergeben wird.
USER-DATE = *BY-SOURCE
Das umzubenennende Element erhält das gleiche Datum wie das ursprüngliche Element.
USER-DATE = *TODAY
Das aktuelle Tagesdatum wird vergeben.
USER-DATE = <date 8..10 with-compl>
Das Datum muss in der Form [JJ]JJ-MM-TT eingegeben werden.
MODIFICATION-DATE = *BY-SOURCE / *SYSTEM-DATE
Steuert die Aktualisierung des Änderungsdatums.
MODIFICATION-DATE = *BY-SOURCE
Das Änderungsdatum wird nicht akualisiert.
MODIFICATION-DATE = *SYSTEM-DATE
Das Änderungsdatum wird akualisiert.
CODED-CHARACTER-SET = *BY-SOURCE / *LIBRARY-DEFAULT / *NONE / <name 1..8>
Zeichensatz, der dem Element zugeordnet werden soll.
CODED-CHARACTER-SET = *BY-SOURCE
Das Element erhält den Zeichensatz des Quellelementes zugeordnet.
CODED-CHARACTER-SET = *LIBRARY-DEFAULT
Das Element erhält den Zeichensatz der Bibliothek zugeordnet, die das Element enthält.
CODED-CHARACTER-SET = *NONE
Dem Element wird kein Zeichensatz zugeordnet.
CODED-CHARACTER-SET = <name 1..8>
Das Element erhält den hier angegebenen Zeichensatz zugeordnet.
STATE = *BY-SOURCE / *FREE / *IN-HOLD
Zustand, der dem Element zugeordnet wird.
STATE = *BY-SOURCE
Der Zustand des Elementes bleibt unverändert.
STATE = *FREE
Der neue Zustand des Elementes ist FREE. Nur der HOLDER und der Bibliothekseigentümer dürfen den Zustand auf FREE ändern.
STATE = *IN-HOLD
Der neue Zustand des Elementes ist IN-HOLD. Die USERID desjenigen, der den Zustandswechsel von FREE auf IN-HOLD änderte, wird als HOLDER eingetragen. War der Zustand bereits IN-HOLD, wird die Anweisung abgewiesen. Nur wer Ausleihrecht hat, kann HOLDER werden.
WRITE-MODE = *LMS-DEFAULT / *CREATE / *REPLACE / *ANY
Überschreiben eines Elementes gleichen Namens. Existiert das Element nicht unter diesem Namen, wird es neu angelegt. Bleiben Typ, Name und Version des Elementes unverändert, so wirkt WRITE-MODE immer wie WRITE-MODE=*ANY.
WRITE-MODE = *CREATE
Das Zielelement darf noch nicht existieren und wird neu erzeugt.
WRITE-MODE = *REPLACE
Das Zielelement muss bereits existieren und wird dann ersetzt.
WRITE-MODE = *ANY
Das Zielelement wird ersetzt, wenn es bereits existiert. Ansonsten wird es neu angelegt.
DIALOG-CONTROL = *LMS-DEFAULT / *NO / *YES / *ERROR
Dieser Operand legt fest, ob während der Ausführung einer Anweisung ein Dialog mit dem Benutzer geführt werden soll oder nicht.
Nähere Erläuterungen zur Dialogführung unter MODIFY-LMS-DEFAULTS.
Anweisungs-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
0 | CMD0001 | Ohne Fehler | |
2 | 0 | LMS0129 | Anweisung abgebrochen durch Benutzer |
1 | CMD0230 | Syntaxfehler | |
32 | LMS1002 | Interner Fehler | |
64 | LMS0020 | Ziel-Element oder Ziel-Datei nicht vorhanden | |
64 | LMS0213 | Name existiert als Delta-Element | |
64 | LMS0214 | Name existiert als Voll-Element | |
64 | LMS0302 | Element nicht gefunden | |
64 | LMS0509 | Ziel-Element oder Ziel-Datei schon vorhanden | |
64 | LMS0510 | Basis nicht gefunden | |
64 | LMS1003 | Fehler während Mengenverarbeitung (Wildcard) bei mindestens einem Element oder einer Datei | |
64 | LMS1004 | Sonstige Fehler | |
64 | PLA0223 | Nur Blätter eines Delta-Baumes überschreibbar | |
64 | PLA0224 | Speicherform nicht erlaubt | |
64 | PLA0229 | Kein Zugriffsrecht für das Element | |
64 | PLA0233 | Ausleihstatus verhindert Elementzugriff | |
64 | PLA0475 | Funktion verletzt Versionsautomatismus | |
64 | PLA0476 | Version passt nicht zur geltenden Konvention | |
64 | PLA0478 | Versionsüberlauf bei Erhöhung | |
130 | LMS0041 | Systemadressraum erschöpft | |
130 | LMS0411 | Bibliothek gesperrt | |
130 | LMS0412 | Element gesperrt | |
130 | LMS0413 | Typ gesperrt |
Notwendige Zugriffsrechte
Lese- und Schreibrecht für LIBRARY
Soll die Elementbezeichnung geändert werden, ist zusätzlich Administrationsrecht erforderlich.
Soll die Elementbezeichnung geändert werden und existiert diese Elementbezeichnung bereits, so ist für das dadurch überschriebene Element zusätzlich Schreibrecht erforderlich.
Soll der Elementzustand von FREE auf IN-HOLD geändert werden, ist Ausleihrecht erforderlich. Nur der HOLDER oder der Bibliothekseigentümer dürfen den Zustand wieder auf FREE ändern.
Andere Attribute dürfen mit Administrationsrecht oder Schreibrecht für das Element geändert werden, nicht jedoch bei STATE=*IN-HOLD und aktivem WRITE-CONTROL.
Hinweise
Beim Anlegen eines Elements ist die unter dem Typ geltende Konvention zu beachten.
Bei aktivem WRITE-CONTROL ist das Ändern der Elementbezeichnung nicht erlaubt. Damit wird verhindert, dass Elemente erzeugt oder überschrieben werden, ohne dass dokumentiert wird durch wen und wann.
Beispiele
In den folgenden Beispielen sei der Elementtyp bereits voreingestellt.
Ändern des Elementnamens von OLD in NEW:
//modify-element-attributes *lib(library=lib,elem=old), -new-attr=*par(elem=new)Ändern der Versionsbezeichnung des Elementes old von V1 in V2:
//modify-element-attributes *lib(library=lib,elem=old(version=v1)), -new-attr=*par(*by-source(version=v2))