MIGRAR

La acción MIGRATE importa los valores de configuración de un entorno de ejecución que está configurado con PARMGEN a uno que está configurado con Configuration Manager.

Antes de empezar

Revise la información siguiente antes de utilizar la acción MIGRATE :
  • Si migra un entorno de ejecución configurado con PARMGEN a uno configurado con Configuration Manager, ya no podrá utilizar PARMGEN para configurar el entorno de ejecución. Para obtener más información, consulte Comparación con PARMGEN.
  • En esta tarea, source hace referencia al entorno de ejecución configurado con PARMGEN y target hace referencia al entorno de ejecución configurado con Configuration Manager.
  • La migración sólo funciona para los productos OMEGAMON soportados por Configuration Manager. Si el origen de migración contiene otros productos configurados por PARMGEN que no están soportados por Configuration Manager, se emite el mensaje de error KFJ00001E para la acción MIGRATE en la salida KCIPRINT y el trabajo finaliza. Para obtener la lista de productos soportados, consulte Productos soportados por Configuration Manager.
  • Tenga en cuenta el convenio de denominación que utilizará para el entorno de ejecución de destino. Los entornos de ejecución de origen y destino pueden compartir el mismo calificador de alto nivel, al que se hace referencia como migración in situ.
    Nota: Considerando que PARMGEN almacena parámetros en rte_plib_hilev.rte_name.WCONFIG para cada entorno de ejecución, Configuration Manager almacena parámetros y variables en rte_plib_hilev.RTEDEF, que pueden contener definiciones para varios entornos de ejecución. Para obtener más información sobre las diferencias entre PARMGEN y Configuration Manager, consulte Comparación con PARMGEN.
  • La acción MIGRATE da soporte a la migración de uno o varios entornos de ejecución PARMGEN a una única configuración de Configuration Manager RTEDEF . Se recomienda que decida antes de la migración del primer entorno de ejecución si tiene previsto migrar uno o varios entornos de ejecución a un único RTEDEF.
    Nota: Si va a configurar un TEMS de alta disponibilidad (TEMS HA), asegúrese de que sólo se haya definido un entorno de ejecución en el RTEDEF (es decir, el utilizado para el TEMS HA).
  • Para los parámetros que describen calificadores de conjunto de datos, la acción MIGRATE no migra los parámetros que se han personalizado con valores codificados que coinciden parcialmente con el valor del parámetro RTE_HILEV de PARMGEN. Por ejemplo, si en la configuración de PARMGEN, ha establecido el parámetro KD2_OMPE_DSHLQ para utilizar el valor TEST.RTE1.HLQ1y RTE_HILEV se ha establecido en "TEST.RTE1", KD2_OMPE_DSHLQ no se migrará.

    Antes de migrar de PARMGEN a Configuration Manager, revise los parámetros personalizados que describen calificadores de conjuntos de datos. Si ha personalizado nombres de conjunto de datos que coinciden parcialmente con el valor RTE_HILEV de la configuración de PARMGEN, pero utiliza un valor codificado en lugar de la referencia de parámetro %RTE_HILEV%, debe actualizar el valor para utilizar %RTE_HILEV% para que el parámetro se migre correctamente.

  • Antes de realizar una acción MIGRATE , asegúrese de que tiene una copia de seguridad del entorno de ejecución PARMGEN de origen. El paso siguiente en Gestor de configuración después de una migración es generar miembros de tiempo de ejecución utilizando la acción GENERATE . Si realiza una migración in situ, la acción GENERATE subsiguiente sobrescribirá los conjuntos de datos del entorno de ejecución utilizados por PARMGEN.

Acerca de esta tarea

Con la acción MIGRATE , puede importar los valores de configuración del entorno de ejecución PARMGEN existentes de un miembro WCONFIG específico en el Gestor de configuración rte_plib_hilev.RTEDEF. La acción MIGRATE lee WCONFIG y otros conjuntos de datos de una instalación de PARMGEN, a partir de los cuales crea los descriptores dispersos que contienen los parámetros, ocultando cada valor de parámetro que se considera un valor predeterminado o que no se ha modificado. También copia otros archivos para el soporte de variables del sistema, las alteraciones temporales de inclusión y las salidas de seguridad necesarias para dar soporte a la migración.

La lista siguiente proporciona detalles sobre la acción MIGRATE :
  • La acción MIGRATE da soporte a la migración de un entorno de ejecución PARMGEN a la vez.
  • Puede migrar uno o más entornos de ejecución PARMGEN a una única configuración de Configuration Manager RTEDEF . El comportamiento predeterminado de la acción MIGRATE es migrar sólo un entorno de ejecución al conjunto de datos RTEDEF . Utilizando el parámetro OPTION MULTIPLE , puede migrar varios entornos de ejecución a un único conjunto de datos RTEDEF . Cada migración de entorno de ejecución requiere un trabajo de acción MIGRATE independiente. Si tiene previsto migrar varios entornos de ejecución a un único conjunto de datos RTEDEF , asegúrese de incluir el parámetro OPTION MULTIPLE en cada trabajo de acción MIGRATE , incluido el primero.
    Nota: Puede abreviar OPTION MULTIPLE a OPTION MULTI.
  • La acción MIGRATE crea los miembros necesarios en el conjunto de datos RTEDEF , tal como se indica a continuación:
    • Cuando se utiliza el comportamiento predeterminado de la acción MIGRATE para migrar un entorno de ejecución a un único conjunto de datos RTEDEF (omitiendo el parámetro OPTION MULTIPLE ), la acción MIGRATE creará miembros de tipo Kpp$PARM en el conjunto de datos RTEDEF creado respectivo, junto con el miembro rte_name para los parámetros específicos del entorno de ejecución.
    • Al migrar varios entornos de ejecución a una única configuración de RTEDEF , utilice el parámetro OPTION MULTIPLE y KFJ_SYSNAME lpar en KCIVARS DD. La acción MIGRATE creará miembros de tipo Kpp$lpar en el conjunto de datos RTEDEF , junto con el miembro rte_name para los parámetros específicos del entorno de ejecución.

      En las ejecuciones posteriores de la acción MIGRATE , reutilice el mismo valor de parámetro RTE_PLIB_HILEV , pero actualice los valores para los parámetros RTE_NAME, KFJ_MIGRATE_WCONFIGy KFJ_SYSNAME para crear un nuevo conjunto de miembros de parámetros de entorno de ejecución. No hay ningún límite sobre cuántos entornos de ejecución se pueden migrar a un único conjunto de datos de RTEDEF .

  • Si la acción MIGRATE detecta que un destino especificado RTEDEF ya contiene Kpp$lpar y miembros rte_name , MIGRATE emite un mensaje de error y se detiene. Tenga en cuenta que MIGRATE detectará también los miembros Kpp$PARM y VAR$GLOB en RTEDEF . Puesto que se considera que estos miembros tienen un ámbito sysplex, sólo pueden existir en RTEDEF durante el proceso de migración si no hay miembros Kpp$lpar adicionales destinados a migrarse al mismo RTEDEF. En función del caso, puede aparecer cualquiera de los mensajes siguientes: KFJ00218E, KFJ00219E, KFJ00220E
  • La acción MIGRATE acepta entornos de ejecución PARMGEN con variables del sistema. Sin embargo, las variables del sistema no se copian a menos que haya elegido alterarlas temporalmente en la configuración de PARMGEN. Las variables se copian en el RTEDEF miembro VAR$GLOB para una acción predeterminada (única) MIGRATE o miembro VAR$lpar en una acción MIGRATE múltiple.
  • Para los parámetros que utilizan variables como valores, a diferencia de PARMGEN, Configuration Manager no permite que el parámetro y la variable tengan el mismo nombre. Si dicha configuración existe en su configuración PARMGEN, la acción MIGRATE renombra las variables automáticamente. En la mayoría de los casos, se añade el sufijo _R al nombre de la variable. Para obtener más información, consulte Variables migradas de PARMGEN.
  • La acción MIGRATE asigna la biblioteca de salidas de seguridad con el nombre predeterminado rte_plib_hilev.rte_name.SECEXITS (o, opcionalmente, el nombre especificado en el parámetro KFJ_SECURITY_EXITS_LIB ). La acción MIGRATE también copia las salidas de seguridad utilizadas por el entorno PARMGEN en la biblioteca de salidas de seguridad especificada y define la biblioteca de salidas de seguridad de origen en el entorno de ejecución utilizando el parámetro RTE_X_SECURITY_EXIT_LIB . Para obtener más información, consulte Configuración de salidas de seguridad en su entorno de ejecución.
    Importante: El parámetro RTE_X_SECURITY_EXIT_LIB contendrá el nombre de la biblioteca de salidas de seguridad utilizada por el entorno PARMGEN de origen; debe revisar este valor y actualizarlo si es necesario antes de ejecutar la acción GENERATE .
  • Si el uso de miembros override embed se habilita especificando el parámetro KFJ_USE_EMBEDS establecido en Y, la acción MIGRATE asigna el conjunto de datos embeber con el nombre predeterminado rte_plib_hilev.rte_name.EMBEDS (o, opcionalmente, el nombre especificado en el parámetro KFJ_EMBEDS_LIB ). La acción MIGRATE configura el conjunto de datos de incorporaciones, lo llena con parámetros de inclusión de alteración temporal soportados (si procede) y lo define en el entorno de ejecución utilizando el parámetro RTE_X_OVERRIDE_EMBEDS_LIB . Para obtener más información, consulte Uso de miembros de incrustación de anulación en el Administrador de configuración.
  • La acción MIGRATE funciona con el parámetro KFJ_LOCAL_PLIB_HILEV para permitir la generación local de entornos de ejecución para sistemas remotos utilizando distintos calificadores de alto nivel.

    Cuando se especifica el parámetro KFJ_LOCAL_PLIB_HILEV , el conjunto de datos kfj_local_plib_hilev.RTEDEF generado contendrá un miembro adicional: PCK$PARM para una acción MIGRATE predeterminada (única) o miembro PCK$lpar en una acción MIGRATE múltiple. Este miembro permite entornos de ejecución generados localmente utilizando un calificador de alto nivel de conjunto de datos diferente al que se va a utilizar en el destino de despliegue (por ejemplo, el sistema de producción).

    Para obtener más información sobre implementaciones remotas, consulte Consideraciones especiales para la implementación de SYSPLEX, RTEDEF(PCK$PARM) e Implementación de entornos de ejecución remotos.

Después de ejecutar la acción MIGRATE
Después de ejecutar la acción MIGRATE , debe revisar cuidadosamente los miembros del conjunto de datos RTEDEF generados para verificar que los parámetros tienen los valores esperados. Puede utilizar el informe proporcionado en la salida del trabajo MIGRATE identificada por la sentencia MIGRPT DD para revisar los detalles sobre los parámetros. Este informe presenta parámetros en los grupos siguientes:
  • Parámetros que se migran al conjunto de datos RTEDEF porque sus valores son diferentes de los valores predeterminados
  • Parámetros que siempre se migran, independientemente de los valores predeterminados o no
  • Parámetros que no se migran debido a que tienen valores predeterminados
  • Parámetros que no se migran porque coinciden con el valor del parámetro RTE_HILEV de PARMGEN

Este informe proporciona a cada parámetro su valor resuelto. Tenga en cuenta que algunos parámetros utilizan variables del sistema o dependen de otros parámetros, y algunos parámetros heredan valores de otros parámetros y se puede considerar que tienen valores predeterminados. Además, algunos parámetros tienen valores predeterminados diferentes a PARMGEN, como se describe en Parámetros con valores predeterminados diferentes a PARMGEN.

Importante: Verifique que los calificadores de alto nivel de conjunto de datos, los nombres de conjunto de datos y las vías de acceso de z/OS® UNIX System Services son correctas, ya que una acción GENERATE posterior podría sobrescribir los archivos existentes.
Para migrar un entorno de ejecución PARMGEN a un entorno de ejecución Configuration Manager , utilice el procedimiento siguiente.
Nota: La variable de flujo de trabajo CONFIRM no está soportada para la acción MIGRATE .

Procedimiento

  1. Modifique el trabajo de ejemplo KFJJMCM en TKANSAM (consulte el ejemplo siguiente) para seleccionar una acción MIGRATE .
  2. Especifique los valores de parámetro necesarios, como se indica a continuación:
    1. Especifique valores para el entorno de destino que se va a configurar con Gestor de configuración en los parámetros RTE_NAME y RTE_PLIB_HILEV.
    2. Especifique el nombre del conjunto de datos WCONFIG de origen en el parámetro KFJ_MIGRATE_WCONFIG . Este es el conjunto de datos WCONFIG del entorno de ejecución configurado por PARMGEN desde el que se van a importar los valores de configuración.
  3. (Opcional) Especifique parámetros adicionales según sea necesario, por ejemplo:
    • Para migrar este entorno de ejecución a un conjunto de datos RTEDEF que contiene varias configuraciones de entorno de ejecución, añada los parámetros OPTION MULTIPLE y KFJ_SYSNAME lpar . Si se trata de una ejecución posterior de la acción MIGRATE , reutilice el mismo valor de parámetro RTE_PLIB_HILEV , pero actualice los valores para los parámetros RTE_NAME, KFJ_MIGRATE_WCONFIGy KFJ_SYSNAME.
    • Para especificar un nombre diferente para la biblioteca de salidas de seguridad, añada el parámetro KFJ_SECURITY_EXITS_LIB y el valor.
    • Para habilitar el uso de miembros override embed , añada el parámetro KFJ_USE_EMBEDS establecido en Y y el parámetro y valor KFJ_EMBEDS_LIB .
  4. Ejecute el trabajo KFJJMCM para realizar la migración y generar el nuevo conjunto de datos RTEDEF .
    Los mensajes de trabajo para la acción MIGRATE se graban en el conjunto de datos SYSOUT de KCIPRINT .
  5. Revise los miembros del conjunto de datos RTEDEF generados para verificar que los parámetros tienen los valores esperados. Compruebe que los calificadores de alto nivel del conjunto de datos, los nombres de los conjuntos de datos y las rutas son correctos z/OS UNIX son correctos. También puede utilizar el informe proporcionado en la salida de trabajo MIGRATE identificada por MIGRPT DD para revisar los detalles sobre los parámetros.

Ejemplo

Los siguientes trabajos JCL migran una configuración de PARMGEN existente a la que apunta highlevel.WCONFIG en una biblioteca de RTEDEF TSOUID.MONSUITE.RTEDEF. El primer ejemplo es para un único entorno de ejecución RTEDEF, y el segundo ejemplo es para un entorno de ejecución múltiple RTEDEF. Estos ejemplos también especifican que los miembros de inclusión de alteración temporal están habilitados y proporcionan nombres de conjuntos de datos personalizados para las salidas de seguridad y las bibliotecas de inclusión.

Figura 1. JCL de ejemplo para realizar la acción MIGRATE para un entorno de ejecución único 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
/*
Figura 2. JCL de ejemplo para realizar la acción MIGRATE para un entorno de ejecución múltiple 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                                                    
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
/*

Qué hacer a continuación

Cuando haya terminado de migrar los entornos de ejecución de PARMGEN a la biblioteca RTEDEF de Configuration Manager, utilice la acción GENERATE para generar miembros de tiempo de ejecución utilizando los parámetros configurados. Véase GENERAR.