MIGRATE

Die Aktion MIGRATE importiert Konfigurationseinstellungen aus einer Laufzeitumgebung, die mit PARMGEN konfiguriert ist, in eine Laufzeitumgebung, die mit Configuration Managerkonfiguriert ist.

Vorbereitende Schritte

Lesen Sie die folgenden Informationen, bevor Sie die Aktion MIGRATE verwenden:
  • Wenn Sie eine Laufzeitumgebung, die mit PARMGEN konfiguriert ist, auf eine mit Configuration Managerkonfigurierte Laufzeitumgebung migrieren, können Sie PARMGEN nicht mehr zum Konfigurieren der Laufzeitumgebung verwenden. Weitere Informationen finden Sie unter Vergleich mit PARMGEN.
  • In dieser Task bezieht sich source auf die Laufzeitumgebung, die mit PARMGEN konfiguriert ist, und target auf die Laufzeitumgebung, die mit Configuration Managerkonfiguriert ist.
  • Die Migration funktioniert nur für OMEGAMON-Produkte, die von Configuration Managerunterstützt werden. Wenn die Migrationsquelle andere von PARMGEN konfigurierte Produkte enthält, die von Configuration Managernicht unterstützt werden, wird die Fehlernachricht KFJ00001E für die Aktion MIGRATE in der Ausgabe von KCIPRINT ausgegeben und der Job wird beendet. Eine Liste der unterstützten Produkte finden Sie unter Vom Konfigurationsmanager unterstützte Produkte.
  • Beachten Sie die Namenskonvention, die Sie für Ihre Ziellaufzeitumgebung verwenden. Quellen-und Ziellaufzeitumgebungen können dasselbe übergeordnete Qualifikationsmerkmal gemeinsam nutzen, das als Inplace-Migrationbezeichnet wird.
    Hinweis: Während PARMGEN Parameter in rte_plib_hilev.rte_name.WCONFIG für jede Laufzeitumgebung speichert, speichert Configuration Manager Parameter und Variablen in rte_plib_hilev.RTEDEF, die Definitionen für mehrere Laufzeitumgebungen enthalten können. Weitere Informationen zu den Unterschieden zwischen PARMGEN und Configuration Managerfinden Sie unter Vergleich mit PARMGEN.
  • Die MIGRATE -Aktion unterstützt die Migration einer oder mehrerer PARMGEN-Laufzeitumgebungen in eine einzelne Configuration Manager RTEDEF -Konfiguration. Es wird empfohlen, dass Sie vor der Migration Ihrer ersten Laufzeitumgebung entscheiden, ob Sie eine oder mehrere Laufzeitumgebungen in eine einzelne RTEDEFmigrieren möchten.
    Hinweis: Wenn Sie einen Hochverfügbarkeits-TEMS (HA-TEMS) einrichten, stellen Sie sicher, dass nur eine Laufzeitumgebung in der RTEDEF definiert ist (d. h. die für den Hochverfügbarkeits-TEMS verwendete).
  • Bei Parametern, die Dateiqualifikationsmerkmale beschreiben, migriert die Aktion MIGRATE keine Parameter, die mit fest codierten Werten angepasst wurden, die teilweise mit dem PARMGEN-Parameterwert RTE_HILEV übereinstimmen. Wenn Sie beispielsweise in Ihrer PARMGEN-Konfiguration den Parameter KD2_OMPE_DSHLQ für die Verwendung des Werts TEST.RTE1.HLQ1festgelegt haben und RTE_HILEV auf "TEST.RTE1"gesetzt ist, wird KD2_OMPE_DSHLQ nicht migriert.

    Bevor Sie eine Migration von PARMGEN auf Configuration Manager durchführen, überprüfen Sie Ihre angepassten Parameter, die Dateiqualifikationsmerkmale beschreiben. Wenn Sie angepasste Dateinamen haben, die teilweise mit Ihrem PARMGEN-Konfigurationswert RTE_HILEV übereinstimmen, aber einen fest codierten Wert anstelle der Parameterreferenz %RTE_HILEV%verwenden, müssen Sie den Wert so aktualisieren, dass %RTE_HILEV% verwendet wird, damit der Parameter erfolgreich migriert werden kann.

  • Stellen Sie vor der Ausführung einer MIGRATE -Aktion sicher, dass Sie über eine Sicherung Ihrer PARMGEN-Quellenlaufzeitumgebung verfügen. Der nächste Schritt im Konfigurationsmanager nach einer Migration ist das Generieren von Laufzeitmembern mit der Aktion GENERATE . Wenn Sie eine Inplace-Migration durchführen, überschreibt die nachfolgende Aktion GENERATE die Laufzeitumgebungsdateien, die von PARMGEN verwendet wurden.

Informationen zu dieser Task

Mit der Aktion MIGRATE können Sie vorhandene Konfigurationseinstellungen der PARMGEN-Laufzeitumgebung aus einem bestimmten WCONFIG -Member in Configuration Manager rte_plib_hilev.RTEDEFimportieren. Die Aktion MIGRATE liest die Datei WCONFIG und andere Dateien aus einer PARMGEN-Installation, aus der sie die Sparse-Deskriptoren erstellt, die die Parameter enthalten, und verdeckt alle Parametereinstellungen, die als Standardeinstellung betrachtet werden oder nicht geändert wurden. Außerdem kopiert sie andere Dateien für die Unterstützung von Systemvariablen, die Einbettung von Überschreibungen und Sicherheitsausgänge, die für die Unterstützung der Migration erforderlich sind.

Die folgende Liste enthält Details zur Aktion MIGRATE :
  • Die Aktion MIGRATE unterstützt die Migration jeweils einer PARMGEN-Laufzeitumgebung.
  • Sie können eine oder mehrere PARMGEN-Laufzeitumgebungen in eine einzelne Configuration Manager RTEDEF -Konfiguration migrieren. Das Standardverhalten der Aktion MIGRATE besteht darin, nur eine Laufzeitumgebung in die Datei RTEDEF zu migrieren. Mit dem Parameter OPTION MULTIPLE können Sie mehrere Laufzeitumgebungen in eine einzelne RTEDEF -Datei migrieren. Jede Laufzeitumgebungsmigration erfordert einen separaten MIGRATE -Aktionsjob. Wenn Sie planen, mehrere Laufzeitumgebungen in eine einzelne RTEDEF -Datei zu migrieren, stellen Sie sicher, dass Sie den Parameter OPTION MULTIPLE in jedem MIGRATE -Aktionsjob, einschließlich des ersten, einschließen.
    Hinweis: Sie können OPTION MULTIPLE mit OPTION MULTIabkürzen.
  • Die Aktion MIGRATE erstellt die erforderlichen Member in der Datei RTEDEF wie folgt:
    • Wenn Sie das Standardverhalten der Aktion MIGRATE verwenden, um eine Laufzeitumgebung in eine einzelne RTEDEF -Datei zu migrieren (ohne den Parameter OPTION MULTIPLE ), erstellt die Aktion MIGRATE Member des Typs Kpp$PARM in der jeweils erstellten Datei RTEDEF zusammen mit dem Member rte_name für die umgebungsspezifischen Parameter.
    • Wenn Sie mehrere Laufzeitumgebungen in eine einzelne RTEDEF -Konfiguration migrieren, verwenden Sie die Parameter OPTION MULTIPLE und KFJ_SYSNAME lpar in KCIVARS DD. Die Aktion MIGRATE erstellt Member des Typs Kpp$lpar in der Datei RTEDEF zusammen mit dem Member rte_name für die für die Laufzeitumgebung spezifischen Parameter.

      Verwenden Sie bei nachfolgenden Ausführungen der Aktion MIGRATE denselben RTE_PLIB_HILEV -Parameterwert, aber aktualisieren Sie die Werte für die Parameter RTE_NAME, KFJ_MIGRATE_WCONFIGund KFJ_SYSNAME , um eine neue Gruppe von Laufzeitumgebungsparametermembern zu erstellen. Es gibt keine Begrenzung, wie viele Laufzeitumgebungen in eine einzelne RTEDEF -Datei migriert werden können.

  • Wenn die Aktion MIGRATE feststellt, dass ein angegebenes Ziel RTEDEF bereits Kpp$lpar -und rte_name -Member enthält, gibt MIGRATE eine Fehlernachricht aus und wird gestoppt. Beachten Sie, dass MIGRATE auch Kpp$PARM-und VAR$GLOB-Member in RTEDEF erkennt. Da diese Member als Member mit einem Sysplex-Geltungsbereich betrachtet werden, können sie während des Migrationsprozesses nur in RTEDEF vorhanden sein, wenn keine zusätzlichen Kpp$lpar -Member in dieselbe RTEDEFmigriert werden sollen. Je nach Fall kann eine der folgenden Nachrichten angezeigt werden: KFJ00218E, KFJ00219E, KFJ00220E
  • Die Aktion MIGRATE akzeptiert PARMGEN-Laufzeitumgebungen mit Systemvariablen. Systemvariablen werden jedoch nur kopiert, wenn Sie ausgewählt haben, dass sie in Ihrer PARMGEN-Konfiguration überschrieben werden sollen. Variablen werden in das RTEDEF Member VAR$GLOB für eine MIGRATE Standardaktion (einzelne Aktion) oder ein Member VAR$lpar in einer mehrfachen MIGRATE -Aktion kopiert.
  • Bei Parametern, die Variablen als Werte verwenden, erlaubt der Configuration Manager im Gegensatz zu PARMGEN nicht, dass der Parameter und die Variable denselben Namen haben. Wenn solche Einstellungen in Ihrer PARMGEN-Konfiguration vorhanden sind, benennt die Aktion MIGRATE die Variablen automatisch um. In den meisten Fällen wird die Endung _R an den Variablennamen angehängt. Weitere Informationen finden Sie unter "Variablen, die von PARMGEN migriert wurden ".
  • Die Aktion MIGRATE ordnet die Bibliothek der Sicherheitsexits mit dem Standardnamen rte_plib_hilev.rte_name.SECEXITS (oder optional mit dem im Parameter KFJ_SECURITY_EXITS_LIB angegebenen Namen) zu. Die Aktion MIGRATE kopiert auch die Sicherheitsexits, die von der PARMGEN-Umgebung verwendet werden, in die angegebene Bibliothek für Sicherheitsexits und definiert die Bibliothek der Quellensicherheitsexits mit dem Parameter RTE_X_SECURITY_EXIT_LIB in der Laufzeitumgebung. Weitere Informationen finden Sie unter Einrichten von Sicherheitsausgängen in Ihrer Laufzeitumgebung.
    Wichtig: Der Parameter RTE_X_SECURITY_EXIT_LIB enthält den Namen der Sicherheitsexitbibliothek, die von der PARMGEN-Quellenumgebung verwendet wird. Sie müssen diese Einstellung überprüfen und bei Bedarf aktualisieren, bevor Sie die Aktion GENERATE ausführen.
  • Wenn die Verwendung von override embed -Membern aktiviert wird, indem der Parameter KFJ_USE_EMBEDS auf Ygesetzt wird, ordnet die Aktion MIGRATE die Einbettungsdatei mit dem Standardnamen rte_plib_hilev.rte_name.EMBEDS (oder optional mit dem im Parameter KFJ_EMBEDS_LIB angegebenen Namen) zu. Die Aktion MIGRATE richtet die Einbettungsdatei ein, füllt sie mit unterstützten Überschreibungseinbettungsparametern (falls zutreffend) und definiert sie für die Laufzeitumgebung mit dem Parameter RTE_X_OVERRIDE_EMBEDS_LIB . Weitere Informationen finden Sie unter "Verwendung von Override-Einbettungsmitgliedern in Configuration Manager ".
  • Die Aktion MIGRATE arbeitet mit dem Parameter KFJ_LOCAL_PLIB_HILEV , um die lokale Generierung von Laufzeitumgebungen für ferne Systeme mit unterschiedlichen übergeordneten Qualifikationsmerkmalen zu ermöglichen.

    Wenn der Parameter KFJ_LOCAL_PLIB_HILEV angegeben wird, enthält die generierte kfj_local_plib_hilev.RTEDEF -Datei ein zusätzliches Member: PCK$PARM für eine Standardaktion (einzelne Aktion) MIGRATE oder ein Member PCK$lpar in einer Mehrfachaktion MIGRATE . Dieses Member ermöglicht lokal generierte Laufzeitumgebungen, die ein anderes übergeordnetes Qualifikationsmerkmal für Dateien verwenden als das, das auf dem Implementierungsziel verwendet werden soll (z. B. das Produktionssystem).

    Weitere Informationen über Remote-Bereitstellungen finden Sie unter Besondere Überlegungen zum SYSPLEX-Rollout, RTEDEF(PCK$PARM) und Bereitstellung von Remote-Laufzeitumgebungen.

Nachdem Sie die Aktion MIGRATE ausgeführt haben
Nachdem Sie die Aktion MIGRATE ausgeführt haben, müssen Sie die generierten Member der RTEDEF -Datei sorgfältig prüfen, um sicherzustellen, dass die Parameter die erwarteten Werte aufweisen. Sie können den Bericht verwenden, der in der MIGRATE -Jobausgabe bereitgestellt wird, die von der Datendefinitionsanweisung MIGRPT angegeben wird, um Details zu den Parametern zu überprüfen. Dieser Bericht enthält Parameter in den folgenden Gruppen:
  • Parameter, die in die Datei RTEDEF migriert werden, weil ihre Werte von den Standardwerten abweichen
  • Parameter, die immer migriert werden, unabhängig davon, ob es sich um Standardwerte handelt oder nicht
  • Parameter, die aufgrund von Standardwerten nicht migriert werden
  • Parameter, die nicht migriert werden, weil sie dem Wert des PARMGEN-Parameters RTE_HILEV entsprechen

Dieser Bericht stellt jeden Parameter mit seinem aufgelösten Wert bereit. Beachten Sie, dass einige Parameter Systemvariablen verwenden oder von anderen Parametern abhängig sind. Einige Parameter übernehmen Werte von anderen Parametern und können als Standardwerte betrachtet werden. Außerdem haben einige Parameter andere Standardwerte als PARMGEN, wie in Parameter mit anderen Standardwerten als PARMGEN beschrieben.

Wichtig: Stellen Sie sicher, dass die übergeordneten Qualifikationsmerkmale, Dateinamen und z/OS® UNIX System Services -Pfade für Dateien korrekt sind, da eine nachfolgende GENERATE -Aktion möglicherweise vorhandene Dateien überschreibt.
Verwenden Sie die folgende Prozedur, um eine PARMGEN-Laufzeitumgebung auf eine Configuration Manager -Laufzeitumgebung zu migrieren.
Hinweis Die Workflowvariable CONFIRM wird für die Aktion MIGRATE nicht unterstützt.

Vorgehensweise

  1. Ändern Sie den Beispieljob KFJJMCM in TKANSAM (siehe Beispiel unten), um eine MIGRATE -Aktion auszuwählen.
  2. Geben Sie die erforderlichen Parameterwerte wie folgt an:
    1. Geben Sie Werte für die Zielumgebung an, die mit Configuration Manager in den Parametern RTE_NAME und RTE_PLIB_HILEVkonfiguriert werden sollen.
    2. Geben Sie den Namen der Quellendatei WCONFIG im Parameter KFJ_MIGRATE_WCONFIG an. Dies ist die Datei WCONFIG der PARMGEN-konfigurierten Laufzeitumgebung, aus der Konfigurationseinstellungen importiert werden.
  3. (Optional) Geben Sie bei Bedarf zusätzliche Parameter an, z. B.
    • Um diese Laufzeitumgebung in eine RTEDEF -Datei mit mehreren Laufzeitumgebungskonfigurationen zu migrieren, fügen Sie die Parameter OPTION MULTIPLE und KFJ_SYSNAME lpar hinzu. Wenn dies eine nachfolgende Ausführung der Aktion MIGRATE ist, verwenden Sie denselben Wert für den Parameter RTE_PLIB_HILEV , aber aktualisieren Sie die Werte für die Parameter RTE_NAME, KFJ_MIGRATE_WCONFIGund KFJ_SYSNAME.
    • Um einen anderen Namen für die Bibliothek der Sicherheitsexits anzugeben, fügen Sie den Parameter KFJ_SECURITY_EXITS_LIB und den Wert hinzu.
    • Um die Verwendung von override embed -Mitgliedern zu ermöglichen, fügen Sie den Parameter KFJ_USE_EMBEDS , der auf Y gesetzt ist, sowie den Parameter KFJ_EMBEDS_LIB und den Wert hinzu.
  4. Führen Sie den Job KFJJMCM aus, um die Migration durchzuführen und die neue RTEDEF -Datei zu generieren.
    Jobnachrichten für die Aktion MIGRATE werden in die SYSOUT-Datei von KCIPRINT geschrieben.
  5. Überprüfen Sie die generierten RTEDEF -Dateimember, um sicherzustellen, dass die Parameter die erwarteten Werte haben. Überprüfen Sie, ob die High-Level-Qualifikatoren, die Datensatznamen und die Pfade z/OS UNIX pfade korrekt sind. Sie können auch den Bericht verwenden, der in der MIGRATE -Jobausgabe bereitgestellt wird, die durch die MIGRPT DD angegeben wird, um Details zu den Parametern zu überprüfen.

Beispiel

Die folgenden JCL-Jobs migrieren eine vorhandene PARMGEN-Konfiguration, auf die highlevel.WCONFIG verweist, in eine RTEDEF Bibliothek TSOUID.MONSUITE.RTEDEF. Das erste Beispiel gilt für eine einzelne Laufzeitumgebung RTEDEFund das zweite Beispiel für eine Laufzeitumgebung mit mehreren Laufzeitumgebungen RTEDEF. In diesen Beispielen wird auch festgelegt, dass Einbettungsmember für Überschreibung aktiviert werden und angepasste Dateinamen für die Sicherheitsexits und Einbettungsbibliotheken bereitgestellt werden.

Abb. 1. Beispiel-JCL zum Ausführen der Aktion MIGRATE für eine einzelne Laufzeitumgebung RTEDEF
//UID#ZMCM JOB ,CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID
/*JOBPARM SYSAFF=ZOS1
//S1       EXEC PGM=KCIOMEGA,REGION=0M,DYNAMNBR=256
//STEPLIB  DD DISP=SHR,DSN=MONSUITE.TKANMOD
//KCIFLOW  DD DISP=SHR,DSN=MONSUITE.TKANCUS(KFJOMEGA)
//KCIVARS  DD *                                        
*                                                                               
ACTION                  MIGRATE                                                    
RTE_NAME                RTE1
RTE_PLIB_HILEV          TSOUID.MONSUITE
                                                                                
KFJ_MIGRATE_WCONFIG     highlevel.WCONFIG                                       
                                                                                
KFJ_SECURITY_EXITS_LIB  TEST1.TST.DEMO.MYEXITS
KFJ_USE_EMBEDS          Y
KFJ_EMBEDS_LIB          TEST1.TST.DEMO.MYEMBEDS
/*
Abbildung 2: Beispiel-JCL zum Ausführen der Aktion MIGRATE für eine RTEDEF mit mehreren Laufzeitumgebungen
//UID#ZMCM JOB ,CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID
/*JOBPARM SYSAFF=ZOS1
//S1       EXEC PGM=KCIOMEGA,REGION=0M,DYNAMNBR=256
//STEPLIB  DD DISP=SHR,DSN=MONSUITE.TKANMOD
//KCIFLOW  DD DISP=SHR,DSN=MONSUITE.TKANCUS(KFJOMEGA)
//KCIVARS  DD *                                        
*                                                                               
ACTION                  MIGRATE                                                    
OPTION                  MULTIPLE
RTE_NAME                RTE1
RTE_PLIB_HILEV          TSOUID.MONSUITE
                                                                                
KFJ_MIGRATE_WCONFIG     highlevel.WCONFIG                                       
                                                                                
KFJ_SECURITY_EXITS_LIB  TEST1.TST.DEMO.MYEXITS
KFJ_USE_EMBEDS          Y
KFJ_EMBEDS_LIB          TEST1.TST.DEMO.MYEMBEDS

KFJ_SYSNAME             lpar
/*

Nächste Schritte

Nachdem Sie Ihre PARMGEN-Laufzeitumgebungen in die Bibliothek RTEDEF des Konfigurationsmanagers migriert haben, verwenden Sie die Aktion GENERATE , um Laufzeitmember mit den konfigurierten Parametern zu generieren. Siehe GENERATE.