Optionen für GENERATE

Sie können den Parameter OPTION für die Aktion GENERATE verwenden, um bestimmte Verarbeitung zu steuern. In diesem Abschnitt werden die verfügbaren Optionen für die Aktion GENERATE beschrieben.

Übersicht über Optionen für GENERATE

Tabelle 1 enthält eine Übersicht über die verfügbaren GENERATE -Optionen. Jede der verfügbaren Optionen wird ausführlicher in Schlüsselwörter für GENERATE OPTIONbeschrieben.
Tabelle 1. Übersicht über Optionen für GENERATE
AUSWAHL Abkürzung Beschreibung
USS Führen Sie nur die Workflowstufe GENERATE aus, die die Komponenten implementiert, die sich auf z/OS® UNIX System Servicesbeziehen. Diese Option erfordert vor der Verwendung eine vollständige Ausführung der Aktion GENERATE .
NOUSS Führen Sie nicht die z/OS UNIX bereitstellungsphase in der Aktion GENERATE .
SECEXITS (SECEXITS) SEC Führen Sie die Konfigurationsverarbeitung nur für Sicherheitsexits durch. Diese Option erfordert vor der Verwendung eine vollständige Ausführung der Aktion GENERATE .
NOSECEXITS NS Führen Sie keine Konfigurationsverarbeitung für Sicherheitsexits durch.
VALIDIEREN VAL Führen Sie die anfängliche Validierung der RTEDEF -Parameter durch.
QUICKLOAD QL Laden Sie die schreibgeschützten Konfigurationsmember in die RK* -Dateien. Die schreibgeschützten Member sind die Member, die von der Anpassung während der Konfiguration nicht betroffen sind. Diese Option erfordert vor der Verwendung eine vollständige Ausführung der Aktion GENERATE .
QUICKCONFIG QC Aktualisieren Sie die konfigurierbaren Elemente für die Laufzeitumgebung (z. B. in den Bibliotheken RKANPARU, RKANSAMU und RKANCMDU ), ohne Daten aus den Zielbibliotheken SMP/E zu aktualisieren. Diese Option erfordert vor der Verwendung eine vollständige Ausführung der Aktion GENERATE .
RELINK Link Assemblieren und verknüpfen Sie Module für OMEGAMON for Networks (KN3) und die erweiterte OMEGAMON 3270-Benutzerschnittstelle (KOB). Diese Option erfordert vor der Verwendung eine vollständige Ausführung der Aktion GENERATE .
NORELINK NL Montieren und verknüpfen Sie keine Bearbeitungsmodule für OMEGAMON for Networks ( KN3 ) und OMEGAMON enhanced 3270 user interface (KOB).
TRGCOPY TRG Erstellen Sie eine Kopie Ihrer SMP/E Zielbibliotheken, mit der Sie Ihre Laufzeitumgebungen erstellen oder aktualisieren können.
Vorbereiten PREP Bereiten Sie Arbeitsdateien für Ihre Laufzeitumgebung vor. Sie können diese Option verwenden, um die Arbeitsdateien vor anderen GENERATE -Aktionsphasen zu erstellen, um die Installation oder Wartung von OMEGAMON vorzubereiten.

Wenn Sie mehrere Optionen angeben möchten, trennen Sie die Werte durch Kommas und ohne Leerzeichen voneinander. Beispiel: OPTION USS,SECEXITS

Kompatibilität der Optionen für GENERATE

Einige Optionen sind nicht kompatibel, um während desselben Jobs mit anderen Optionen ausgeführt zu werden. Tabelle 2 gibt an, welche Optionen kompatibel sind. Y in der Tabellenzelle gibt an, dass Sie die beiden Optionen zusammen in demselben Job angeben können. N in der Tabellenzelle gibt an, dass Sie die beiden Optionen nicht zusammen in demselben Job angeben können.
Tabelle 2. Kompatibilität der Optionen für GENERATE
  USS NOUSS SECEXITS NOSECEXITS VALIDATE QUICKLOAD QUICKCONFIG RELINK NORELINK TRGCOPY PREPARE
USS N Y N N Y Y Y N N N
NOUSS N N Y N N N N Y Y N
SECEXITS Y N N N Y Y Y N N N
NOSECEXITS N Y N N N N N Y N N
VALIDATE N N N N N N N N N N
QUICKLOAD Y N Y N N Y Y N N N
QUICKCONFIG Y N Y N N Y Y N N N
RELINK Y N Y N N Y Y N N N
NORELINK N Y N Y N N N N N N
TRGCOPY N Y N N N N N N N N
PREPARE N N N N N N N N N N

Schlüsselwörter für GENERATE OPTION

USS | NOUSS
Sie können optional steuern, wann die GENERATE Workflow-Phase ausgeführt werden soll, die die Teile in Bezug auf z/OS UNIX. Standardmäßig führt die Aktion GENERATE automatisch alle erforderlichen z/OS UNIX konfiguration durch. Es kann jedoch Fälle geben, in denen Sie diesen Schritt überspringen möchten (z. B. aus Gründen wie Berechtigungsproblemen) und diesen Schritt zu einem späteren Zeitpunkt ausführen. Sie können den Parameter OPTION wie folgt verwenden, um den Wert für USS oder NOUSS anzugeben, um diese Verarbeitung zu steuern:
USS
Wenn OPTION USS angegeben ist, führt die Aktion GENERATE nur den Schritt aus, der die Teile, die mit z/OS UNIX bezieht; es wird keine weitere Verarbeitung durchgeführt (es sei denn, ein anderer OPTION Wert ist ebenfalls angegeben, wie SECEXITS). Sie können diese Option nicht bei der ersten Ausführung der Aktion GENERATE für eine neue Laufzeitumgebung verwenden; sie kann nur bei nachfolgenden Ausführungen verwendet werden.
Wichtig:
  • Sie müssen die Aktion GENERATE vollständig ausführen, bevor Sie OPTION USSverwenden können.
  • Wenn Sie irgendwelche Parameter innerhalb Ihrer RTEDEF Mitglieder geändert haben, die die z/OS UNIX konfiguration auswirken, verwenden Sie nicht OPTION USS, da es Ihre Parameteränderungen nicht erfassen wird. Führen Sie stattdessen die Aktion GENERATE mit OPTION NOUSS (oder ohne die Option) aus, um die Mitglieder in Bezug auf die folgenden Elemente neu zu konfigurieren z/OS UNIX. Dann können Sie OPTION USS verwenden, um die aktualisierten Mitglieder nach z/OS UNIX.
NUSS
Wenn OPTION NOUSS angegeben ist, wird bei der Aktion GENERATE nicht die Phase ausgeführt, in der die Teile, die mit z/OS UNIX. Sie können diese Option bei der ersten Ausführung der Aktion GENERATE für eine neue Laufzeitumgebung sowie bei nachfolgenden Ausführungen verwenden.
SECEXITS | NOSECEXITS

Sie können optional steuern, wann die Konfigurationsverarbeitung für Sicherheitsexits durchgeführt werden soll. Standardmäßig führt die Aktion GENERATE automatisch die erforderlichen Konfigurationsaufgaben für Sicherheitsexits durch, wozu auch der Neuaufbau und die Neuverknüpfung der Sicherheitsexits mit der Ladebibliothek RKANMODU gehören. Indem Sie diese Aufgaben getrennt von anderen Phasen durchführen, können Sie wertvolle CPU-Zyklen einsparen und herausfinden, wann eine zusätzliche Autorisierung erforderlich ist, was z. B. bei der Aktualisierung der Ladebibliothek der Fall sein kann.

Mit dem Parameter OPTION können Sie den Wert SECEXITS oder NOSECEXITS angeben, um diese Verarbeitung wie folgt zu steuern:
SECEXITS
Wenn OPTION SECEXITS angegeben ist, führt die Aktion GENERATE nur die Konfiguration für Sicherheitsexits aus. Es wird keine weitere Verarbeitung ausgeführt (es sei denn, es wird auch ein anderer Wert für OPTION angegeben, z. B. USS). Sie können diese Option nicht bei der ersten Ausführung der Aktion GENERATE für eine neue Laufzeitumgebung verwenden; sie kann nur bei nachfolgenden Ausführungen verwendet werden.
Wichtig: Sie müssen die Aktion GENERATE vollständig ausführen, bevor Sie die Option SECEXITS verwenden können.
NOSECEXITS
Wenn OPTION NOSECEXITS angegeben ist, führt die Aktion GENERATE keine Konfigurationsverarbeitung für Sicherheitsexits durch. Sie können diese Option sowohl bei der ersten Ausführung der Aktion GENERATE für eine neue Laufzeitumgebung als auch bei nachfolgenden Ausführungen verwenden.
Tipp: Mit dieser Option wird die Ladebibliothek RKANMODU nicht aktualisiert, ein Datensatz, der möglicherweise eine restriktivere Berechtigung für die Aktualisierung erfordert. Wenn Sie diese Option zusammen mit der Option NORELINKverwenden, aktualisiert die Aktion GENERATE die Bibliothek RKANMODU nicht, und Sie können die anderen Konfigurationsschritte von GENERATE durchführen, die keinen zusätzlichen Zugriff erfordern.

Weitere Informationen zum Erstellen Ihrer Bibliothek für Sicherheitsexits finden Sie unter Einrichten von Sicherheitsexits in Ihrer Laufzeitumgebung.

VALIDIEREN
Sie können überprüfen, ob alle in der Datei RTEDEF angegebenen Parameter korrekte Werte aufweisen und ob nichts fehlt. Mit dieser Option können Sie die Ausführung der vollständigen GENERATE -Aktion vorbereiten. OPTION VALIDATE erstellt vorläufige und Arbeitsbibliotheken erneut und führt Validierungsschritte aus, um sicherzustellen, dass Ihre Konfiguration korrekt ist. Sie können die Option VALIDATE nicht mit einem anderen OPTION -Wert verwenden. Nach der Ausführung der Aktion GENERATE mit OPTION VALIDATEkönnen Sie den Validierungsbericht mithilfe der Anweisung $VALRPT DD suchen.
Achtung: Wenn Sie zuvor PARMGEN für die Konfiguration verwendet haben, beachten Sie, dass die Verwendung der Aktion GENERATE mit OPTION VALIDATE die Datei WCONFIG erneut erstellt, wodurch die PARMGEN-Konfiguration ungültig wird. Dies bedeutet, dass Sie die PARMGEN-Konfiguration nicht mehr verwenden können, wenn Sie eine Laufzeitumgebung von PARMGEN mit der Aktion MIGRATE auf Configuration Manager migrieren und dann die Aktion GENERATE mit OPTION VALIDATEausführen.
QUICKLOAD

Mit OPTION QUICKLOADkönnen Sie die schreibgeschützten Konfigurationsmember in die RK* -Dateien laden. Die schreibgeschützten Member sind die Member, die von der Anpassung während der Konfiguration nicht betroffen sind.

OPTION QUICKLOAD ist mit den Optionen USS und SECEXITS kompatibel, aber nicht mit den Optionen VALIDATE und NOUSS . Diese Option erfordert vor der Verwendung eine vollständige Ausführung der Aktion GENERATE .

QUICKCONFIG

Mit dieser Option können Sie Ihre Produkte schnell neu konfigurieren, ohne die schreibgeschützten Laufzeitelemente neu zu laden oder Daten aus SMP/E Zielbibliotheken zu aktualisieren. Durch die Verwendung dieser Option kann die Leistung verbessert werden, wobei die größte Auswirkung bei Verwendung einer vollständigen Laufzeitumgebung auftritt (der ParameterRTE_TYPE ist auf FULLgesetzt).

Wenn OPTION QUICKCONFIG angegeben ist, aktualisiert die Aktion GENERATE die konfigurierbaren Elemente für die Laufzeitumgebung (z. B. in den Bibliotheken RKANPARU, RKANSAMU und RKANCMDU ), ohne Daten aus den Zielbibliotheken SMP/E zu aktualisieren. Die schreibgeschützten Member, bei denen es sich um Member handelt, die von der Anpassung während der Konfiguration nicht betroffen sind, werden nicht in die RK* -Dateien geladen.

Genauer gesagt führt die Ausführung der Aktion GENERATE mit OPTION QUICKCONFIG die folgenden Aktionen aus:
  • Validiert Parameter
  • Ordnet fehlende Dateien zu
  • Aktualisiert konfigurierbare Member für die Runtime Environment (z. B. in den Bibliotheken RKANPARU, RKANSAMUund RKANCMDU ).
  • Aktualisiert gestartete Tasks, VTAM-Liste und VTAM-Knoten.
  • Aktualisiert z/OS UNIX -zugehörigen Mitglieder, verteilt sie aber nicht auf die z/OS UNIX verzeichnisse oder Dateien. Um vorbereitete Mitglieder in z/OS UNIX dateien oder Verzeichnissen bereitzustellen, müssen Sie die Option QUICKCONFIG mit der Option USS kombinieren.
Wenn Sie die Aktion GENERATE mit OPTION QUICKCONFIG ausführen, werden die folgenden Aktionen nicht ausgeführt:
  • Aktualisieren von Daten aus SMP/E Zielbibliotheken
  • Aktualisieren Sie schreibgeschützte Module aus SMP/E Zielbibliotheken
  • Aktualisieren Sie z/OS UNIX dateien oder Verzeichnisse
  • Führen Sie alle Assemblierungs-oder Verknüpfungsoperationen aus, die sich auf Sicherheitsexits oder andere Lademodule beziehen.

Die Option QUICKCONFIG kann nicht zusammen mit der Option VALIDATE oder NOUSS verwendet werden. Die Option QUICKCONFIG erfordert eine vollständige Ausführung der Aktion GENERATE vor der Verwendung.

Sie können optional steuern, wann Elemente in der RKANMODU Ladebibliothek zusammengestellt und verknüpft werden sollen, wenn eine erneute Verknüpfung von IBM Z OMEGAMON AI for Networks ( KN3 ) oder OMEGAMON enhanced 3270 User Interface (KOB) Modulen erforderlich ist, z.B. bei der Durchführung von Wartungsarbeiten. In der Standardeinstellung führt die Aktion GENERATE diese Schritte automatisch durch. Durch die getrennte Durchführung dieser Aufgaben können Sie eingrenzen, wann eine zusätzliche Autorisierung erforderlich ist, was z. B. bei der Aktualisierung der Ladebibliothek der Fall sein kann.

Mit dem Parameter OPTION können Sie den Wert RELINK oder NORELINK angeben, um diese Verarbeitung wie folgt zu steuern:
ERNEUT VERKNÜPFEN
Verwenden Sie OPTION RELINK , um Elemente in der RKANMODU Ladebibliothek zusammenzustellen und zu verknüpfen, wenn eine Neuverknüpfung von IBM Z OMEGAMON AI for Networks ( KN3 ) oder OMEGAMON Enhanced 3270 User Interface (KOB)-Modulen erforderlich ist, z. B. bei der Durchführung von Wartungsarbeiten. Sie können diese Option nicht beim ersten Lauf der Aktion GENERATE für eine neue Laufzeitumgebung verwenden; sie kann nur bei späteren Läufen genutzt werden.
Wichtig: Sie müssen die Aktion GENERATE vollständig ausführen, bevor Sie die Option RELINK verwenden können.
Hinweis: Wenn Sie mit PARMGEN vertraut sind, führt die Option RELINK die gleiche Funktion aus wie der Auftrag PARMGEN KCIJPLNK (Run post- SMP/E RKANMODU ASM/LINK steps ).
Tipp: Sie können das verwendete Bindeprogramm anpassen, indem Sie den Programmnamen im Parameter GBL_UTIL_BINDER angeben.
Bei Verwendung der Aktion GENERATE mit OPTION RELINKunterscheiden sich die Details je nach Umgebung, in der die Aktion ausgeführt wird, wie folgt:
Auf einem lokalen System (das Konfigurationssystem in einem fernen Implementierungsszenario)

Sie können die Aktion GENERATE mit OPTION RELINK auf einem lokalen System ausführen, um Elemente zu assemblieren und zu verknüpfen.

In einer fernen Umgebung mit einer anderen z/OS -Version

Sie können die Aktion GENERATE mit OPTION RELINK auf einem Zielsystem ausführen, das eine andere z/OS -Version als das Konfigurationssystem hat. Sie müssen nicht alle Schritte im Szenario für die ferne Implementierung ausführen (AktionGENERATE , Aktion PACKAGE , Übertragungsdateien, Aktion DEPLOY ).

Die Verwendung der Option RELINK setzt voraus, dass die Bibliothek SMP/E TKANMODS auf dem Zielsystem vorhanden ist. Die Bibliothek TKANMODS ist nicht Teil der vollständigen Laufzeitumgebung und wird nicht von der Aktion BLDREMDS erstellt. Mit anderen Worten, es muss eine Umgebung SMP/E vorhanden sein, um Konsistenz zu gewährleisten. Daher müssen Sie Configuration Manager aus denselben SMP/E Bibliotheken ausführen.

Sie können die Aktion GENERATE nach Bedarf mit OPTION RELINK wiederholen.

Wenn Sie die Option RELINK verwenden, um Module in einer fernen Umgebung mit einer anderen z/OS -Version erneut zu verlinken, haben Sie möglicherweise in den Bibliotheken, die durch die Parameter GBL_DSN_SYS1_MACLIB und GBL_DSN_CEE_SCEELKED festgelegt sind, andere Einstellungen als auf Ihrem lokalen System. Wenn es signifikante Unterschiede im Inhalt dieser Bibliotheken gibt, die steuern, wie Module assembliert und verknüpft werden, sollten Sie die GENERATE -Aktion mit OPTION RELINK auf dem Zielsystem ausführen.

In einer fernen Umgebung mit derselben z/OS -Version

Sie können die Aktion GENERATE mit OPTION RELINK auf einem Zielsystem ausführen, das dieselbe z/OS -Version wie das Konfigurationssystem hat. In dieser Umgebung gibt es keine SMP/E Umgebung auf dem Zielsystem, und es wird nur der minimale Satz an Bibliotheken übertragen, um die Aktion DEPLOY durchzuführen.

Sie können die folgenden Schritte ausführen:
  1. GENERATE -Aktion mit OPTION RELINK
  2. PACKAGE Aktionen
  3. Übertragung von Dateien
  4. DEPLOY Aktionen
Diese Implementierung spart CPU-Zyklen im Schritt GENERATE ein.
Für eine vollständige Laufzeitumgebung
In einer vollständigen Laufzeitumgebung müssen Sie die Aktion GENERATE mit OPTION QUICKLOAD,RELINK ausführen, um die richtigen Verknüpfungsergebnisse zu erzielen. (Diese Anforderung ist auf eine Abhängigkeit vom Dataset RKANSAM zurückzuführen.)
Wenn OPTION NORELINK angegeben ist, werden bei der Aktion GENERATE die Module IBM Z OMEGAMON AI for Networks ( KN3 ) oder OMEGAMON Enhanced 3270 User Interface (KOB) nicht zusammengesetzt und verknüpft, selbst wenn eine erneute Verknüpfung erforderlich ist. Sie können diese Option sowohl bei der ersten Ausführung der Aktion GENERATE für eine neue Laufzeitumgebung als auch bei nachfolgenden Ausführungen verwenden.
Tipp: Mit dieser Option wird die Ladebibliothek RKANMODU nicht aktualisiert, ein Datensatz, der möglicherweise eine restriktivere Berechtigung für die Aktualisierung erfordert. Wenn Sie diese Option zusammen mit der Option NOSECEXITSverwenden, aktualisiert die Aktion GENERATE die Bibliothek RKANMODU nicht, und Sie können die anderen Konfigurationsschritte von GENERATE durchführen, die keinen zusätzlichen Zugriff erfordern.
TRGCOPY
Verwenden Sie OPTION TRGCOPY , um eine Kopie Ihrer SMP/E Zielbibliotheken zu erstellen, mit der Sie Ihre Laufzeitumgebungen erstellen oder aktualisieren können. Sie können dieses Schlüsselwort mit TRGabkürzen. Weitere Informationen finden Sie unter SMP/E Zielbibliothekskopien verwenden.
VORBEREITEN

Verwenden Sie OPTION PREPARE , um temporäre Arbeitsbibliotheken für Ihre Laufzeitumgebung vorzubereiten. Sie können diese Option verwenden, um die Arbeitsdateien vor anderen Workflowphasen der GENERATE -Aktion zu erstellen, um die Installation oder Wartung von OMEGAMON vorzubereiten. Diese Option kann nützlich sein, wenn Sie andere verwandte Tasks ausführen müssen, die die Arbeitsdateien im Voraus oder parallel benötigen, wie z. B. das Vorbereiten von Membern für Db2 -Bindungen oder das Kopieren von Membern gestarteter Tasks in PROCLIB-Bibliotheken.

Mit dieser Option können Sie zunächst die Aktion GENERATE mit OPTION PREPARE ausführen, um die Arbeitsdateien zu erstellen, und dann, wenn Sie bereit sind, die Option GENERATE erneut ausführen (ohne die Option PREPARE ), um die zusätzlichen Workflowstufen abzuschließen. Sie können die Option PREPARE nicht mit einem anderen OPTION -Wert verwenden.
Wichtig: Wenn Sie die Option PREPARE verwenden, um die Arbeitsdateien zu erstellen, müssen Sie dieselbe Configuration Manager -Wartungsstufe haben, wenn Sie nachfolgende GENERATE -Aktionsjobs ohne die Option PREPARE ausführen.
Genauer gesagt führt die Ausführung der Aktion GENERATE mit OPTION PREPARE die folgenden Aktionen aus:
  • Validiert Parameterwerte
  • Führt Parsingschritte aus
  • Ordnet die vorläufigen Staging-Bibliotheken (IK*) und Arbeitsbibliotheken (WK*) zu und aktualisiert sie. Diese Bibliotheken werden später in die Laufzeitbibliotheken (RK*) kopiert.
  • Ordnet PROCLIB-, VTAMLST-und VTAMLIB -Bibliotheken zu und aktualisiert sie. Diese Bibliotheken enthalten gestartete Tasks, VTAM-Listen und VTAM-Knoten.
    Wichtig: In den Parametern GBL_DSN_SYS1_PROCLIB, GBL_DSN_SYS1_VTAMLIBund GBL_DSN_SYS1_VTAMLST angegebene Datasets sind betroffen.
  • Aktualisiert die im Parameter GBL_USER_JCLangegebene globale Benutzerbibliothek, die globale Parameter enthält.
    Wichtig: Alle Änderungen an den folgenden RTEDEF -Membern wirken sich auf Ihre vorhandene Laufzeitumgebung aus: VAR$GLOB, VAR$lparund SYS@lpar .
  • Erstellt einen Prüfpunkt. Am Ende des Jobs erstellt die GENERATE -Aktion mit OPTION PREPARE das Member $PREPARE in der Bibliothek WKANPARU und füllt es wie folgt mit dem Datum und der Uhrzeit der Prüfpunkterstellung:
    ******************* Top of Data ******************
    * Checkpoint created by userID on yyyy-mm-dd hh:mm:ss
    ****************** Bottom of Data ****************
    Wenn der Prüfpunkt erkannt wird, umgehen nachfolgende GENERATE -Aktionsjobs (ohne die Option PREPARE ) die Workflowstufen, die von der Option PREPARE ausgeführt werden, und setzen die Verarbeitung mit den verbleibenden Workflowstufen fort. Die Aktion GENERATE löscht dann das Member $PREPARE am Ende des Jobs.
    Hinweis: Der Prüfpunkt wird nicht entfernt, wenn eine der folgenden Optionen verwendet wird: USS, SECEXITS, RELINK, QUICKLOAD .