für privilegierte Anwender
Die Anweisung CREATE-SYSTEM-MANAGED-PUBSET erstellt entweder einen neuen SM-Pubset oder prüft, ob sich angegebene SF-Pubsets konfliktlos in einen neuen SM-Pubset überführen lassen.
Beim Erstellen eines neuen SM-Pubsets werden max. 255 SF-Pubsets zu einem neuen SM-Pubset konvertiert, wobei jeder SF-Pubset zu einem Volume-Set des SM-Pubsets wird.
Die Prüffunktion führt einen Konsistenz-Check durch, der über systemweite Namenskonflikte bei den betroffenen Pubsets informiert.für nicht-privilegierte Anwender
Für nichtprivilegierte Anwender stellt die Anweisung CREATE-SYSTEM-MANAGED-PUBSET nur die Prüffunktion zur Verfügung. Dabei entscheidet ein Konsistenz-Check, ob sich die angegebenen SF-Pubsets in einen neuen SM-Pubset überführen lassen. Die Überprüfungen beziehen sich ausschließlich auf die Benutzerkennung des Aufrufers. Der Aufrufer kann sich somit darüber informieren, welche von ihm verursachten Namenskonflikte es gibt und wie er sie beseitigen kann.
Ausgaben
Die Ausgaben dieser Anweisung werden im Abschnitt „Ausgaben (Erzeugen neuer SM-Pubsets)" bzw. im Abschnitt „Ausgaben (Prüffunktion)" beschrieben, die Masken im Abschnitt „Ausgaben in Bildschirmmasken".
Arbeitsweise
Die generelle Arbeitsweise dieser Anweisung, Einschränkungen sowie die Kontingentverteilung werden im Abschnitt „Erzeugen neuer SM-Pubsets" beschrieben.
CREATE-SYSTEM-MANAGED-PUBSET OPERATIONAL-MODE=*OPERATION sollte nie ohne vorhergehende FDDRL-Sicherung der umzuwandelnden Pubsets aufgerufen werden, da bei einem fehlerhaften Abbruch alle Pubsets zerstört und nicht mehr zugreifbar sein können.
Eine logische Sicherung mittels HSMS wird ebenfalls empfohlen. Hierbei kann ein neues Backup-Archiv erzeugt werden, das zur Herstellung der HSMS-Umgebung für den neuen SM-Pubset verwendet werden kann. Anleitungen zur Umstellung der HSMS-Umgebung sind im Leitfaden für die SMS-Migration gegeben, siehe Handbuch „System Managed Storage“ [8].
Spool-Aufträge für Dateien, die in den zu konvertierenden Pubsets katalogisiert sind, sollten nicht mehr ausstehen, da sie durch die Umbenennung der Katalogkennung nicht mehr ausgeführt werden können.
SECOS-spezifische Benutzerinformationen (z.B. Gruppeninformation, Privilegien) gehen auch bei Angabe von KEEP-USER-ATTRIBUTES=*ALL vollständig verloren, wenn das Betriebssystem während der Pubset-Konvertierung ohne SECOS betrieben wird.
Simulations- und Check-Modus
Wenn der Operand OPERATIONAL-MODE=*SIMULATION angegeben wird, wird die hier beschriebene Funktion nicht real ausgeführt. Es erfolgt lediglich ein Syntax-Check und eine Auflistung der angegebenen Volume-Sets.
Wenn der Operand OPERATIONAL-MODE=*CHECK-NAME-CONSISTENCY angegeben wird, wird nur die Prüffunktion ausgeführt.
Nähere Informationen siehe Operandenbeschreibung.
Format für privilegierte Anwender
CREATE-SYSTEM-MANAGED-PUBSET | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||
Operanden
PUBSET = <catid>
Kennung des zu erzeugenden oder auf Erzeugbarkeit zu überprüfenden SM-Pubsets.
Die Kennung muss sich von den Kennungen der zu konvertierenden SF-Pubsets unterscheiden.
Falls nicht nur eine Prüfung durchgeführt werden soll (Operand OPERATIONAL-MODE= *CHECK-NAME-CONSISTENCY), sondern auch eine Konvertierung, darf noch kein gleich lautender MRSCAT-Eintrag existieren.
Die angegebene Kennung geht ein in die Überprüfung der Dateinamenslänge und der automatischen Modifizierbarkeit von GUARD-Bedingungen.
CONTROL-VOLUME-SET = <catid>(...)
Kennung des SF-Pubsets, der zum Control-Volume-Set des neuen SM-Pubsets werden soll.
Sie muss sich von der Kennung des zu erzeugenden SM-Pubsets unterscheiden.
Wie für alle zu konvertierenden SF-Pubsets, muss auch für diesen Pubset bereits ein MRSCAT-Eintrag mit dem richtigen Gerätetyp existieren.
Falls nicht nur eine Prüfung durchgeführt werden soll (Operand OPERATIONAL-MODE= *CHECK-NAME-CONSISTENCY), sondern auch eine Konvertierung, darf der Pubset jedoch weder im lokalen noch in einem anderen System importiert sein.
Der Control-Volume-Set muss die im Abschnitt „Voraussetzungen für den Ablauf von SMPGEN" beschriebenen Anforderungen erfüllen.
Bei der reinen Prüffunktion (OPERATIONAL-MODE=*CHECK-NAME-CONSISTENCY) wird die Angabe der folgenden Volume-Set-Eigenschaften ignoriert.
AVAILABILITY =
Bestimmt den Verfügbarkeitsgrad von Dateien, bezogen auf die Ausfallsicherheit des Volume-Sets.
Die Verfügbarkeit ist eine logische Volume-Set-Eigenschaft, die bei der
Speicherplatzwahl als Auswahlkriterium zur Ablage von Dateien dient. Eine Änderung der Volume-Set-Eigenschaft muss der Systembetreuer explizit veranlassen.
AVAILABILITY = *STD
Voreinstellung: Der Volume-Set bietet keine erhöhte Ausfallsicherheit.
AVAILABILITY = *HIGH
Der Volume-Set bietet hohe Ausfallsicherheit.
Es liegt in der Verantwortung des Systembetreuers, zu überprüfen, dass die Ausfallsicherheit auch physikalisch gewährleistet ist, und z.B. den DRV-Modus vor Beginn der Konvertierung einzuschalten.
PERFORMANCE-ATTR =
Bestimmt die Performance-Eigenschaften des Volume-Sets, bezogen auf Dateizugriffe. Es handelt sich hierbei um logische Attribute, die bei der Speicherplatzwahl als Auswahlkriterium dienen. Es erfolgt keine Validierung bzgl. der vorhandenen Hardware (z.B. Cache).
PERFORMANCE-ATTR = *STD
Voreinstellung: Für den Volume-Set sollen keine erhöhten Performance-Attribute bzgl. Dateizugriffen definiert werden.
PERFORMANCE-ATTR = *PARAMETERS(...)
Die für den Volume-Set geltenden Performance-Eigenschaften werden über folgende Unterstruktur definiert:
PERFORMANCE =
Beschreibt das I/O-Performance-Profil des Volume-Sets. Die Angabe einer Liste von bis zu drei Werten ist möglich.
PERFORMANCE = *STD
Voreinstellung: Der Volume-Set bietet keine erhöhte I/O-Performance.
PERFORMANCE = *HIGH
Der Volume-Set bietet erhöhte I/O-Performance.
PERFORMANCE = *VERY-HIGH
Der Volume-Set bietet sehr hohe I/O-Performance.
WRITE-CONSISTENCY =
Bestimmt, ob die zur Erhöhung der I/O-Performance eingesetzte Hardware auch im Falle eines Systemabsturzes Datenkonsistenz garantiert.
WRITE-CONSISTENCY = *BY-CLOSE
Voreinstellung: Schreib-I/Os mit erhöhter Performance sind nur unter Verzicht auf sofortige absturzsichere Datenablage möglich; erst beim Schließen der Datei gelangen die Daten auf ein Medium, das Datenerhaltung auch im Falle eines Systemabsturzes garantiert.
WRITE-CONSISTENCY = *IMMEDIATE
Auch bei Schreib-I/Os mit erhöhter Performance gelangen die Daten unmittelbar auf ein Medium, das Datenerhaltung auch im Falle eines Systemabsturzes garantiert.
ADD-VOLUME-SET =
Spezifiziert, ob außer dem als Control-Volume-Set angegebenen Pubset weitere SF-Pubsets in den SM-Pubset aufgenommen werden sollen.
ADD-VOLUME-SET = *NONE
Voreinstellung: Es sollen keine weiteren SF-Pubsets aufgenommen werden.
ADD-VOLUME-SET = <catid>(...)
Kennungen der weiteren SF-Pubsets, die als Volume-Set in den SM-Pubset aufgenommen werden sollen. Die Pubset-Kennung wird zur Volume-Set-Kennung.
Alle Volume-Set-Kennungen müssen sich untereinander, von der Kennung des Control-Volume-Sets und von der gewählten SM-Pubset-Kennung unterscheiden.
Falls nicht nur eine Prüfung durchgeführt werden soll (Operand OPERATIONAL-MODE= *CHECK-NAME-CONSISTENCY), sondern auch eine Konvertierung, dürfen die SF-Pubsets jedoch weder im lokalen noch in einem anderen System importiert sein; es müssen dafür jedoch bereits MRSCAT-Einträge mit dem richtigen Gerätetyp existieren.Die Volume-Sets müssen die im Abschnitt „Voraussetzungen für den Ablauf von SMPGEN" beschriebenen Anforderungen erfüllen.
Die als Unterstruktur angebbaren Volume-Set-Eigenschaften sind bis auf USAGE unter dem Operanden CONTROL-VOLUME-SET beschrieben.
Bei der reinen Prüffunktion (OPERATIONAL-MODE=*CHECK-NAME-CONSISTENCY) wird die Angabe der folgenden Volume-Set-Eigenschaften ignoriert.
USAGE =
Bestimmt die Art der Nutzung des Volume-Sets.
USAGE = *STD
Der Volume-Set soll als Ablageort für die Standarddateien genutzt werden. Arbeitsdateien (Dateiattribut WORK) dürfen dort nicht abgelegt werden.
USAGE = *HSMS-CONTROLLED
Der Volume-Set dient dem Subsystem HSMS zur Realisierung der Speicherebene S1 und des Backup-Volume-Sets eines SM-Pubsets. Benutzer dürfen dort keine Dateien ablegen.
KEEP-USER-ATTRIBUTES =
Spezifiziert, wie mit den Logon-Kennwörtern und der Benutzergruppenstruktur sowie den nur Home-Pubset-relevanten Benutzerinformationen (Privilegien, Berechtigungen, Operator-Roles) verfahren werden soll.
Bei der reinen Prüffunktion (OPERATIONAL-MODE=*CHECK-NAME-CONSISTENCY) wird die Angabe dieses Operanden ignoriert.
KEEP-USER-ATTRIBUTES = *ALL(...)
Voreinstellung: Die Informationen sollen von einem der zusammenzuführenden SF-Pubsets übernommen werden. Die Informationen auf allen anderen Ausgangs-Pubsets bleiben unberücksichtigt.
ATTRIBUTE-ORIGIN = *CONTROL-VOLUME-SET
Die Informationen sollen von dem Pubset übernommen werden, der Control-Volume-Set werden soll.
ATTRIBUTE-ORIGIN = <catid>
Spezifiziert die Kennung des Pubsets, von dem die Informationen übernommen werden sollen. Er muss einer der zu konvertierenden Pubsets sein.
KEEP-USER-ATTRIBUTES = *BASIC
Nur die hauptsächlich Daten-Pubset-relevanten Benutzerinformationen sollen übernommen werden. Die Informationen gehen bei der Pubset-Konvertierung verloren (auch dann, wenn nur ein Pubset konvertiert wird.)
S1-MIGRATED-FILES =
Vereinbart, ob es als Konflikt anzusehen ist, wenn in einem der zu überprüfenden Pubsets Dateien katalogisiert sind, die gegenwärtig auf die S1-Ebene migriert sind.
S1-MIGRATED-FILES = *NOT-ALLOWED
Voreinstellung: Der oben genannte Fall ist als Konflikt anzusehen.
S1-MIGRATED-FILES = *ALLOWED
Der oben genannte Fall ist nicht als Konflikt anzusehen.
Die S1-migrierten Dateien sind im Anschluss an die Konvertierung jedoch nicht mehr zugänglich, sondern müssen aus einer Backup-Datei zurückgeholt werden. Ihre Katalogeinträge sind noch erhalten, sodass sie nach Erzeugung der HSMS-Umgebung durch REPAIR-CATALOG-BY-RESTORE gezielt auf die S1-Ebene des SM-Pubsets gebracht werden können.
MAX-ERRORS = 32767 / <integer 0..32767>
Bei Auftreten der angegebenen Anzahl von Fehlern wird der Konsistenz-Check abgebrochen. Die vor dem Abbruch aufgetretenen Konflikte werden ausgegeben, falls ERROR-INFORMATION = *DETAIL angegeben wurde. 32767 ist Voreinstellung.
MONJV =
Vereinbart eine überwachende Jobvariable.
MONJV = *NONE
Voreinstellung: Es gibt keine überwachende Jobvariable.
MONJV = <filename 1..54 without-gen-vers>
Gibt den Namen der überwachenden Jobvariablen an. Sie muss bereits in einem zugreifbaren Pubset katalogisiert sein und darf nicht durch ein Kennwort geschützt sein.
Die Zustandsanzeige der Jobvariablen wird während der Konvertierung (OPERATIONAL-MODE=*OPERATION) auf folgende Weise gesetzt:
$I | zu Beginn der Bearbeitung |
| $R | nach erfolgreicher Durchführung der Bearbeitung |
| $A | bei fehlerhaftem Abbruch der Bearbeitung |
Die Zustandsanzeige der Jobvariablen wird während des Konsistenz-Checks (OPERATIONAL-MODE=*CHECK-NAME- CONSISTENCY) auf folgende Weise gesetzt:
$I | zu Beginn der Konsistenz-Checks |
| $R | am Ende des Konsistenz-Checks, wenn Konsistenz besteht |
| $E | am Ende des Konsistenz-Checks, wenn keine Konsistenz besteht |
| $A | bei nicht vollständig durchgeführtem Konsistenz-Check |
Die Angabe des Operanden ist nur sinnvoll bei Einsatz des Software-Produkts JV.
Wenn die Jobvariable auch zu Beginn der Funktionsausführung einen definierten Inhalt haben soll, muss der Anwender sie selbst initialisieren. Wird die Funktionsausführung gleich zu Anfang abgebrochen, z.B. weil ein semantischer Fehler festgestellt wird, so versorgt SMPGEN die Jobvariable nicht.
Liegt die Jobvariable auf einem der zusammenzuführenden Pubsets und ist nicht OPERATIONAL-MODE=*CHECK-NAME-CONSISTENCY(PUBSET-STATE= *IMPORTED) spezifiziert worden, so wird der SMPGEN-Auftrag zurückgewiesen.
ERROR-INFORMATION =
Steuert den Umfang der Fehlerinformationen, die in Text- und/oder Variablenform ausgegeben werden.
ERROR-INFORMATION = *DETAIL
Voreinstellung: Eine detaillierte Fehlerinformation soll ausgegeben werden. Dabei wird nicht nur die Anzahl der Namenskonflikte ausgegeben, sondern es werden auch alle mehrfach vorkommenden oder zu langen Namen einzeln aufgelistet.
Im Dialog an der Datensichtstation werden Bildschirmmasken ausgegeben, die die Möglichkeit bieten, die Fortsetzungsbildschirme oder die Detail-Bildschirme zu unterdrücken oder auf SYSLST umzuschalten (siehe Abschnitt „Ausgaben in Bildschirmmasken").
Im Batch-Betrieb und auf SYSLST erfolgt die Ausgabe im selben Format, nur ohne Reaktionsmöglichkeit.
ERROR-INFORMATION = *SUMMARY
Es sollen keine detaillierten Fehlerinformationen ausgegeben werden, d.h. keine Listen von Namenskonflikten, sondern nur die Anzahl der Konflikte in den verschiedenen Namensklassen.
EXECUTION-MODE =
Gibt an, ob die Funktion in der aktuellen Task oder in einer neu zu erzeugenden Batch-Task ausgeführt werden soll.
EXECUTION-MODE = *SYNCHRONOUS(...)
Voreinstellung: Die Funktion soll in der laufenden Task ausgeführt werden.
TEXT-OUTPUT =
Steuert das Ausgabeziel der in Textformat erfolgenden Ausgaben, d.h. der Listen, Protokollierungs- und Fehlermeldungen.
TEXT-OUTPUT = *STD
Voreinstellung: Die Ausgabe soll entsprechend der standardmäßigen Voreinstellung erfolgen. Im Dialogbetrieb erfolgt die Ausgabe sowohl auf SYSOUT als auch auf SYSLST. Im Batch-Betrieb erfolgt die Ausgabe auf SYSLST.
TEXT-OUTPUT = *SYSOUT
Die Ausgabe soll auf SYSOUT erfolgen.
Diese Angabe ist nur im Dialogbetrieb erlaubt. SYSOUT darf nicht auf eine Datei umgewiesen worden sein.
Ist SYSOUT-Ausgabe gewünscht, so werden Bildschirmmasken ausgegeben, die mit der DUE-Taste zu quittieren sind. Beim Auftreten vieler Fehler ist es möglich, das detaillierte Fehlerprotokoll nachträglich auf SYSLST zu legen oder zu unterdrücken.
TEXT-OUTPUT = *SYSLST
Die Ausgabe soll auf SYSLST erfolgen.
TEXT-OUTPUT = *NONE
Es wird keine Ausgabe in Listen- oder Meldungsform gewünscht. Diese Angabe ist nur sinnvoll, wenn stattdessen der Operand STRUCTURE-OUTPUT angegeben wird. Fehlermeldungen und die Meldungen über Start und Erfolg der Funktion sind nicht unterdrückbar; sie werden auch bei der Angabe TEXT-OUTPUT=*NONE auf SYSOUT ausgegeben.
STRUCTURE-OUTPUT =
Steuert die Ausgabe von Fehlerinformationen in S-Variablen.
STRUCTURE-OUTPUT = *SYSINF
Voreinstellung: Die Fehlerinformationen sollen in die S-Variable ausgegeben werden, auf die der Anwender den Variablenstrom SYSINF zugewiesen hat.
Ist dieser Variablenstrom nicht aktiv, so erfolgt keine Ausgabe in eine S-Variable.
STRUCTURE-OUTPUT = *NONE
Es erfolgt keine Ausgabe in eine S-Variable.
STRUCTURE-OUTPUT = <composed-name 1..100>
Name der S-Variablen, in der die Fehlerinformationen abgelegt werden.
Die Variable muss vom Anwender als dynamisch definierte Struktur deklariert sein(/DECLARE-VARIABLE ..., MULTIPLE-ELEMENTS=*LIST,TYPE=*STRUCTURE).
Die Funktion soll in einer neu zu erzeugenden Batch-Task ausgeführt werden. In diesem Fall erfolgt keine Informationsausgabe in eine S-Variable.
TEXT-OUTPUT =
steuert die Ausgabe der Listen, Protokollierungs- und Fehlermeldungen.
TEXT-OUTPUT = *SYSLST
Die Ausgabe soll in eine Spoolout-Datei erfolgen, die bei Jobende ausgedruckt und gelöscht wird. Der Name der Spoolout-Datei entspricht der Standardeinstellung der SYSLST-Datei für ENTER-Tasks.
TEXT-OUTPUT = <filename 1..54 without-gen-vers>
Die Ausgabe soll in die angegebene Datei erfolgen. Falls die Datei bereits existiert, muss der Anwender das Schreibzugriffsrecht darauf besitzen. Die Datei darf nicht durch ein Kennwort geschützt sein. Sie muss lokal zugreifbar und darf keine temporäre Datei sein. Bei Jobende wird die Datei nicht ausgedruckt und auch nicht gelöscht.
OPERATIONAL-MODE =
Bestimmt, ob die Funktion „Erzeugen eines SM-Pubsets“ real ausgeführt oder nur simuliert oder ob nur die Prüffunktion (Konsistenz-Check) ausgeführt werden soll.
OPERATIONAL-MODE = *OPERATION
Voreinstellung: Die Funktion soll real ausgeführt werden.
OPERATIONAL-MODE = *SIMULATION
Die Funktion soll nur simuliert werden.
Die Syntax der angegebenen Operanden wird geprüft.
Die Operanden MAX-ERRORS, MONJV, ERROR-INFORMATION und EXECUTION-
MODE (mit Unteroperanden) haben jedoch nicht die in der Operandenbeschreibung aufgeführte Bedeutung; Ausgabemedium, ausführende Task usw. sind im Simulationsmodus nicht einstellbar.
Die Ausführung erfolgt immer in der laufenden Task: falls dies eine Dialog-Task ist, erfolgt die Ausgabe auf SYSOUT und SYSLST, falls es eine Batch-Task ist, nur auf SYSLST.
Bei erfolgreicher Syntaxprüfung wird eine Tabelle der Volume-Sets mit den spezifizierten logischen Eigenschaften ausgegeben.
Die Ausgangs-Pubsets müssen für diese Funktion nicht zugänglich sein; es erfolgen keine Plattenoperationen. Demgemäß werden auch keine Überprüfungen vorgenommen, für die die Platten verfügbar sein müssen, also kein Namens-Konsistenz-Check. Die MRSCAT-Einträge werden ebenfalls nicht überprüft.
OPERATIONAL-MODE = *CHECK-NAME-CONSISTENCY(...)
Es wird die Prüffunktion (Konsistenz-Check) von SMPGEN ausgeführt.
Dabei werden die SF-Pubsets, die in den Operanden CONTROL-VOLUME-SET und ADD-VOLUME-SET spezifiziert wurden, daraufhin überprüft, ob sie in einen neu zu schaffenden SM-Pubset übergeführt bzw. konvertiert werden können.
PUBSET-STATE =
Gibt an, ob der Konsistenz-Check bei laufender Pubset-Session, also möglicherweise parallel zu anderen Anwender-Zugriffen auf die Pubsets, erfolgen soll.
PUBSET-STATE = *IMPORTED
Voreinstelling: Der Konsistenz-Check soll bei laufender Pubset-Session erfolgen. Die Pubsets sind bereits lokal importiert. Der Konsistenz-Check liefert nur eine ungefähre Aussage, die durch zwischenzeitliche Änderungen bereits überholt sein kann.
PUBSET-STATE = *NOT-IMPORTED
SMPGEN soll die Pubsets für den Konsistenz-Check exklusiv belegen. Die Pubsets sind weder lokal noch von einem anderen System importiert. Während des Konsistenz-Checks werden sie gegen andere Zugriffe gesperrt, daher ist das Ergebnis zum Zeitpunkt der Ausgabe korrekt.
USER-ID =
Spezifiziert, für welche Benutzerkennung(en) die Konsistenzprüfungen der Pubsets erfolgen sollen.
USER-ID = *OWN
Voreinstellung: Die Konsistenzprüfungen sollen sich nur auf Dateinamen, JVs und Guards unter der Aufrufer-Benutzerkennung erstrecken.
Die in der Anweisungsbeschreibung genannten Systemverwaltungs-spezifischen allgemeinen Prüfungen (unerlaubte Dateien, S1-Migration) erfolgen auch bei dieser Angabe.
USER-ID = *ALL
Die Konsistenzprüfungen sollen sich auf alle Benutzerkennungen erstrecken. Diese Angabe ist unzulässig, falls einer oder mehrere der Pubsets im SHARED-SLAVE-Modus importiert ist.
Format für nicht-privilegierte Anwender
CREATE-SYSTEM-MANAGED-PUBSET | ||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||
Operanden
PUBSET = <catid>
Kennung eines SM-Pubsets, der auf Erzeugbarkeit überprüft werden soll.
Die Kennung muss sich von den Kennungen der zusammenzuführenden SF-Pubsets unterscheiden.
Es darf ein gleichlautender MRSCAT-Eintrag existieren: Auf einen entsprechenden Pubset wird - etwa zum Zwecke von Überprüfungen - nicht zugegriffen.
Die angegebene Kennung geht ein in die Überprüfung der Dateinamenslänge und der automatischen Modifizierbarkeit von GUARD-Bedingungen.
CONTROL-VOLUME-SET = <catid>
Kennung des SF-Pubsets, der zum Control-Volume-Set des neuen SM-Pubsets werden soll. Die Kennung wird zur Volume-Set-Kennung des Control-Volume-Sets. Sie muss sich von der Kennung des zu erzeugenden SM-Pubsets unterscheiden. Der SF-Pubset muss im lokalen System importiert sein.
ADD-VOLUME-SET =
Spezifiziert, ob außer dem als Control-Volume-Set angegebenen Pubset weitere SF-Pubsets für eine Aufnahme in den SM-Pubset überprüft werden sollen.
ADD-VOLUME-SET = *NONE
Voreinstellung: Es sollen keine weiteren SF-Pubsets überprüft werden.
ADD-VOLUME-SET = <catid>
Kennungen der weiteren SF-Pubsets, die überprüft werden sollen.
Die Pubset-Kennung wird zur Volume-Set-Kennung.
Alle Volume-Set-Kennungen müssen sich untereinander, von der Kennung des Control-Volume-Sets und von der gewählten SM-Pubset-Kennung unterscheiden.
Die SF-Pubsets müssen im lokalen System importiert sein.
Die als Unterstruktur angebbaren Volume-Set-Eigenschaften sind bis auf USAGE unter dem Operanden CONTROL-VOLUME-SET beschrieben.
MAX-ERRORS = 32767 / <integer 0..32767>
Bei Auftreten der angegebenen Anzahl von Fehlern wird der Konsistenz-Check abgebrochen. Die vor dem Abbruch aufgetretenen Konflikte werden ausgegeben, falls ERROR-INFORMATION = *DETAIL angegeben wurde. 32767 ist Voreinstellung.
MONJV =
Vereinbart eine überwachende Jobvariable.
MONJV = *NONE
Voreinstellung: Es gibt keine überwachende Jobvariable.
MONJV = <filename 1..54 without-gen-vers>
Gibt den Namen der überwachenden Jobvariablen an. Sie muss bereits in einem zugreifbaren Pubset katalogisiert sein und darf nicht durch ein Kennwort geschützt sein.
Die Zustandsanzeige der Jobvariablen wird während des Konsistenz-Checks auf folgende Weise gesetzt:
$I | zu Beginn der Konsistenz-Checks |
| $R | am Ende des Konsistenz-Checks, wenn Konsistenz besteht |
| $E | am Ende des Konsistenz-Checks, wenn keine Konsistenz besteht |
| $A | bei nicht vollständig durchgeführtem Konsistenz-Check |
Die Angabe des Operanden ist nur sinnvoll bei Einsatz des Software-Produkts JV.
Wenn die Jobvariable auch zu Beginn der Funktionsausführung einen definierten Inhalt haben soll, muss der Anwender sie selbst initialisieren. Wird die Funktionsausführung gleich zu Anfang abgebrochen, z.B. weil ein semantischer Fehler festgestellt wird, so versorgt SMPGEN die Jobvariable nicht.
ERROR-INFORMATION =
Steuert den Umfang der Fehlerinformationen, die in Text- und/oder Variablenform ausgegeben werden.
ERROR-INFORMATION = *DETAIL
Voreinstellung: Eine detaillierte Fehlerinformation soll ausgegeben werden. Dabei wird nicht nur die Anzahl der Namenskonflikte ausgegeben, sondern es werden auch alle mehrfach vorkommenden oder zu langen Namen einzeln aufgelistet.
Im Dialog an der Datensichtstation werden Bildschirmmasken ausgegeben, die die Möglichkeit bieten, die Fortsetzungsbildschirme oder die Detail-Bildschirme zu unterdrücken oder auf SYSLST umzuschalten (siehe Abschnitt „Ausgaben in Bildschirmmasken").
Im Batch-Betrieb und auf SYSLST erfolgt die Ausgabe im selben Format, nur ohne Reaktionsmöglichkeit.
ERROR-INFORMATION = *SUMMARY
Es sollen keine detaillierten Fehlerinformationen ausgegeben werden, d.h. keine Listen von Namenskonflikten, sondern nur die Anzahl der Konflikte in den verschiedenen Namensklassen.
EXECUTION-MODE =
Gibt an, ob die Funktion in der aktuellen Task oder in einer neu zu erzeugenden Batch-Task ausgeführt werden soll.
EXECUTION-MODE = *SYNCHRONOUS(...)
Voreinstellung: Die Funktion soll in der laufenden Task ausgeführt werden.
TEXT-OUTPUT =
Steuert das Ausgabeziel der in Textformat erfolgenden Ausgaben, d.h. der Listen, Protokollierungs- und Fehlermeldungen.
TEXT-OUTPUT = *STD
Voreinstellung: Die Ausgabe soll entsprechend der standardmäßigen Voreinstellung erfolgen. Im Dialogbetrieb erfolgt die Ausgabe sowohl auf SYSOUT als auch auf SYSLST. Im Batch-Betrieb erfolgt die Ausgabe auf SYSLST.
TEXT-OUTPUT = *SYSOUT
Die Ausgabe soll auf SYSOUT erfolgen.
Diese Angabe ist nur im Dialogbetrieb erlaubt. SYSOUT darf nicht auf eine Datei umgewiesen worden sein.
Ist SYSOUT-Ausgabe gewünscht, so werden Bildschirmmasken ausgegeben, die mit der DUE-Taste zu quittieren sind. Beim Auftreten vieler Fehler ist es möglich, das detaillierte Fehlerprotokoll nachträglich auf SYSLST zu legen oder zu unterdrücken.
TEXT-OUTPUT = *SYSLST
Die Ausgabe soll auf SYSLST erfolgen.
TEXT-OUTPUT = *NONE
Es wird keine Ausgabe in Listen- oder Meldungsform gewünscht. Diese Angabe ist nur sinnvoll, wenn stattdessen der Operand STRUCTURE-OUTPUT angegeben wird.
Fehlermeldungen und die Meldungen über Start und Erfolg der Funktion sind nicht unterdrückbar; sie werden auch bei der Angabe TEXT-OUTPUT=*NONE auf SYSOUT ausgegeben.
STRUCTURE-OUTPUT =
Steuert die Ausgabe von Fehlerinformationen in S-Variablen.
STRUCTURE-OUTPUT = *SYSINF
Voreinstellung: Die Fehlerinformationen sollen in die S-Variable ausgegeben werden, auf die der Anwender den Variablenstrom SYSINF zugewiesen hat.
Ist dieser Variablenstrom nicht aktiv, so erfolgt keine Ausgabe in eine S-Variable.
STRUCTURE-OUTPUT = *NONE
Es erfolgt keine Ausgabe in eine S-Variable.
STRUCTURE-OUTPUT = <composed-name 1..100>
Name der S-Variablen, in der die Fehlerinformationen abgelegt werden.
Die Variable muss vom Anwender als dynamisch definierte Struktur deklariert sein (/DECLARE-VARIABLE ..., MULTIPLE-ELEMENTS=*LIST,TYPE=*STRUCTURE).
Die Funktion soll in einer neu zu erzeugenden Batch-Task ausgeführt werden. In diesem Fall wird die Informationsausgabe in eine S-Variable nicht unterstützt.
TEXT-OUTPUT =
steuert die Ausgabe der Listen, Protokollierungs- und Fehlermeldungen.
TEXT-OUTPUT = *SYSLST
Die Ausgabe soll in eine Spoolout-Datei erfolgen, die bei Jobende ausgedruckt und gelöscht wird. Der Name der Spoolout-Datei entspricht der Standardeinstellung der SYSLST-Datei für ENTER-Tasks.
TEXT-OUTPUT = <filename 1..54 without-gen-vers>
Die Ausgabe soll in die angegebene Datei erfolgen. Falls die Datei bereits existiert, muss der Anwender das Schreibzugriffsrecht darauf besitzen. Die Datei darf nicht durch ein Kennwort geschützt sein. Sie muss lokal zugreifbar und darf keine temporäre Datei sein. Bei Jobende wird die Datei nicht ausgedruckt und auch nicht gelöscht.