Die Anweisung MODIFY-ELEMENT leitet die Modifikation von Elementen ein. Die Änderungen selber werden über Subanweisungen gesteuert.
Durch MODIFY-ELEMENT werden die Elemente ausgewählt, die geändert werden sollen.
Wurde die MODIFY-ELEMENT-Anweisung abgeschickt, erwartet LMSCONV als nächste Anweisung eine Subanweisung. Wird statt einer Subanweisung eine andere Anweisung eingegeben, wird eine Fehlermeldung ausgegeben.
Format
MODIFY-ELEMENT | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operanden
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 zu ändernde Element befindet.
LIBRARY = *STD
Die durch OPEN-LIBRARY eröffnete Bibliothek.
LIBRARY = <filename 1..54 without-vers>
Name der Bibliothek, in der sich das zu ändernde Element befindet.
LIBRARY = *LINK(...)
Die über den Dateikettungsnamen zugewiesene Bibliothek.
LINK-NAME = <structured-name 1..8>
Dateikettungsname der Bibliothek.
ELEMENT = *ALL(...) / <composed-name 1..64 with-under with-wild(132)>(...)
ELEMENT = *ALL(...)
Alle Elemente werden geändert.
ELEMENT = <composed-name 1..64 with-under with-wild(132)>(...)
Name des Elements, welches geändert werden soll.
VERSION = *HIGHEST-EXISTING / *ALL/ *UPPER-LIMIT /
<composed-name 1..24 with-under with-wild(52)>
Version, die das zu ändernde Element besitzt.
VERSION = *HIGHEST-EXISTING
Das Element mit der höchsten bestehenden Version wird geändert.
VERSION = *ALL
Alle Versionen des Elements werden geändert.
VERSION = *UPPER-LIMIT
Die in der Bibliothek unter dem angegebenen TYPE und Namen höchstmögliche Version X'FF' wird geändert.
VERSION = <composed-name 1..24 with-under with-wild(52)>
Explizite Angabe der Version des Elements, das geändert werden soll.
TYPE = *DEFAULT / <alphanum-name 1..8>
Typ, den das zu ändernde Element besitzt. Ist der Wert *DEFAULT und der mit MODIFY-DEFAULTS aktuell eingestellte Wert gleich *NONE, so verlangt LMSCONV die Angabe eines Typs.
USER-DATE = *ANY / *TODAY / <date 8..10 with-compl> / *INTERVAL(...)
Datum, das vom Benutzer vergeben wurde.
USER-DATE = *ANY
Das zu ändernde Element besitzt ein beliebiges Datum.
USER-DATE = *TODAY
Das Element mit dem aktuellen Tagesdatum wird geändert.
USER-DATE = <date 8..10 with-compl>
Das Element, dessen Datum explizit in der Form [JJ]JJ-MM-TT eingegeben wird, wird geändert.
USER-DATE = *INTERVAL(...)
Alle Elemente, die in dem angegebenen Zeitraum liegen, werden geändert.
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(...)
Datum der Erzeugung des Elements. Beschreibung der Operandenwerte 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 Operandenwerte siehe Operand USER-DATE dieser Anweisung.
TO-ELEMENT = *LIBRARY-ELEMENT(...)
Angabe, wohin und unter welchem Namen das korrigierte Element zurückgeschrieben werden soll.
LIBRARY = *STD / *BY-SOURCE / <filename 1..54 without-vers> / *LINK(...)
Angabe der Bibliothek, in die das korrigierte Element zurückgeschrieben werden soll.
LIBRARY = *STD
Die durch OPEN-LIBRARY eröffnete Bibliothek.
LIBRARY = *BY-SOURCE
Das korrigierte Element wird in die ursprüngliche Bibliothek zurückgeschrieben.
LIBRARY = <filename 1..54 without-vers>
Name der Bibliothek, in die das korrigierte Element aufgenommen werden soll.
LIBRARY = *LINK(...)
Die über den Dateikettungsnamen zugewiesene Bibliothek.
LINK-NAME = <structured-name 1..8>
Dateikettungsname der Bibliothek.
ELEMENT = *BY-SOURCE(...) / <composed-name 1..132 with-under with-wildcard-constr>(...)
Name, den das korrigierte Element erhalten soll.
ELEMENT = *BY-SOURCE(...)
Das Zielelement erhält den Namen des Quellelementes.
VERSION = *DEFAULT / *BY-SOURCE / *UPPER-LIMIT /
<composed-name 1..52 with-under with-wildcard-constr>
Version, die das korrigierte Element erhalten soll.
VERSION = *DEFAULT
Der Standardwert ist *BY-SOURCE (s.u.) oder der mit MODIFY-DEFAULTS aktuell eingestellte Wert.
VERSION = *BY-SOURCE
Das korrigierte Element erhält die gleiche Version wie das ursprüngliche Element. Hat das ursprüngliche Element keine Versionsangabe, erhält das korrigierte Element X'FF' als Versionsangabe.
VERSION = *UPPER-LIMIT
Die höchstmögliche Version X'FF' wird erzeugt.
VERSION = <composed-name 1..52 with-under with-wildcard-constr>
Der hier angegebene Text wird als Versionsbezeichnung interpretiert.
ELEMENT = <composed-name 1..132 with-under with-wildcard-constr>(...)
Name des korrigierten Elements. Er kann auch mit Wildcards eingegeben werden.
VERSION = *DEFAULT / *BY-SOURCE / *UPPER-LIMIT /
<composed-name 1..52 with-under with-wildcard-constr>
Version, die das korrigierte Element erhalten soll.
Beschreibung der Operanden siehe oben.
TYPE = *BY-SOURCE / *DEFAULT / <alphanum-name 1..8>
Typ, den das korrigierte Element erhalten soll.
TYPE = *BY-SOURCE
Das korrigierte Element erhält die gleiche Typbezeichnung wie das ursprüngliche Element.
TYPE = *DEFAULT
Ist der Wert *DEFAULT und der mit MODIFY-DEFAULTS aktuell eingestellte Wert gleich *NONE, so verlangt LMSCONV die Angabe eines Typs.
USER-DATE = *TODAY / *BY-SOURCE / <date 8..10 with-compl>
Datum, das vom Benutzer vergeben wird.
USER-DATE = *TODAY
Das aktuelle Tagesdatum wird vergeben.
USER-DATE = *BY-SOURCE
Das neue Element erhält das gleiche Datum wie das ursprüngliche Element.
USER-DATE = <date 8..10 with-compl>
Das Datum muss in der Form [JJ]JJ-MM-TT eingegeben werden.
TEXT-PARAMETERS = *NONE / *PARAMETERS(...)
Legt Parameter für Textelemente fest.
TEXT-PARAMETERS = *NONE
Es werden keine Parameter für Textelemente festgelegt.
TEXT-PARAMETERS = *PARAMETERS(...)
Legt Parameter für Textelemente fest.
INPUT-RECORD-ID = *NONE / *RECORD-PART(...)
Legt den Bereich der Satzkennung (siehe Abschnitt „Subanweisungen von MODIFY-ELEMENT für Textelemente") im Eingabesatz fest.
INPUT-RECORD-ID = *NONE
Es wird keine Satzkennung im Eingabesatz festgelegt.
INPUT-RECORD-ID = *RECORD-PART(...)
Beginn und Länge des Satzkennungsbereiches werden festgelegt.
Es muss gelten: Beginn + Länge <= 252.
START = <integer 1..251>
Beginn des Satzkennungsbereiches durch Angabe des ersten Zeichens im Satz.
LENGTH = <integer 1..16>
Länge der Satzkennung.
WRITE-MODE = *DEFAULT / *CREATE / *REPLACE / *ANY
Überschreiben eines Elementes gleichen Namens. Existiert das Element nicht unter diesem Namen, wird es neu angelegt. Ist Quellelement = Zielelement so wird der Operand WRITE-MODE ignoriert.
WRITE-MODE = *DEFAULT
Der Standardwert ist *CREATE (s.u.) oder der mit MODIFY-DEFAULTS aktuell eingestellte Wert.
WRITE-MODE = *CREATE
Der Name des korrigierten Elements darf noch nicht existieren und wird neu erzeugt.
WRITE-MODE = *REPLACE
Das korrigierte Element muss bereits existieren und wird dann ersetzt.
WRITE-MODE = *ANY
Das korrigierte Element wird ersetzt, wenn es bereits existiert. Ansonsten wird es neu angelegt.
DIALOG-CONTROL = *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-DEFAULTS.
DIALOG-CONTROL = *DEFAULT
Der Standardwert ist NO oder der mit MODIFY-DEFAULTS aktuell eingestellte Wert.
DIALOG-CONTROL = *NO
Alle Elemente werden ohne Nachfrage, d.h. ohne Eingreifmöglichkeit des Benutzers, bearbeitet.
Ausnahme: Ist ein Element oder eine Bibliothek gesperrt, fragt LMSCONV nach, ob der Zugriffsversuch wiederholt werden soll.
DIALOG-CONTROL = *YES / *ERROR
Siehe die Beschreibung bei der Anweisung MODIFY-DEFAULTS.