Actualización de aplicaciones

Cuando realiza cambios a los paquetes CICS para los componentes de una aplicación, actualice las versiones de los paquetes CICS, el paquete de aplicación y el enlace de aplicación, y despliegue las nuevas versiones en la plataforma.

Antes de empezar

Cuando actualiza una aplicación que se despliega en una plataforma, la aplicación no está disponible para los usuarios desde el momento en que inhabilita y descarta el recurso APPLCTN instalado en CICSplex para la versión anterior de la aplicación, hasta el momento en que instala la nueva definición de recurso APPLDEF y habilita la nueva versión de la aplicación. Planee un momento adecuado en el que esto pueda suceder sin problemas, o planee una solución alternativa para los usuarios de la aplicación durante ese tiempo.

Para actualizar una aplicación, necesita editar el proyecto de aplicación y el proyecto de enlace de aplicación. Si no posee un sistema de copia de seguridad con versión que le habilite a revertir a una versión anterior de los proyectos, en lugar de editar los proyectos existentes directamente como se describe en estas instrucciones, es posible que prefiera copiarlos en otro proyecto y luego editar las copias nuevas.

Acerca de esta tarea

Puede gestionar cambios en las aplicaciones mediante la utilización del control de versiones. Cada paquete CICS, paquete de aplicación y enlace de aplicación tiene un ID e información sobre la versión para identificarlo de forma exclusiva. La versión utiliza identificadores mayores, menores y micro, de modo que puede indicar la importancia de un cambio y gestionar las dependencias entre paquetes. Este concepto se denomina mantenimiento de versiones semánticas y se toma de la iniciativa de Open Service Gateway. Aunque se centra en los paquetes Java™, puede utilizar los mismos principios para aplicarlos a los paquetes en general.

El mantenimiento de versiones semánticas proporciona una manera de incrementar los componentes mayores, menores y micro de una versión para indicar la compatibilidad o incompatibilidad con versiones anteriores de un paquete. Por ejemplo, los arreglos de error pueden incrementar el componente micro de la versión, los cambios compatibles incrementan el componente menor de la versión y los cambios incompatibles incrementan el componente mayor de la versión. Para obtener más información acerca del mantenimiento de versiones semánticas, consulte Libro blanco técnico de mantenimiento de versiones semánticas.

Debe aplicar una política de mantenimiento de versiones a los paquetes CICS y los paquetes de gestión para desplegar y gestionar actualizaciones en el entorno CICS. No puede utilizar una versión existente de un paquete de aplicación para instalar nuevas versiones de los paquetes CICS para la aplicación, y no puede utilizar una versión existente de un enlace de aplicación con una nueva versión de un enlace de aplicación. Debe actualizar el paquete de aplicación y el enlace de aplicación siempre que actualice los paquetes CICS para la aplicación.

Cuando cambia la versión de un paquete de gestión, de acuerdo con los principios del mantenimiento de versiones semánticas, la nueva versión debería reflejar el mayor cambio en un paquete CICS incluido en el paquete de gestión. Por ejemplo, puede cambiar un paquete CICS para una aplicación desde la versión 1.0.1 a la versión 1.0.2, que es un cambio de versión micro, y cambiar otro paquete CICS para la aplicación desde la versión 1.2.0 a la versión 1.3.0, que es un cambio de versión menor. El paquete de aplicación que incluye estos dos paquetes CICS deberían, por lo tanto, tener un cambio de versión menor, de modo que si el paquete de aplicación se encontraba previamente en la versión 2.5.1, debería cambiar a la versión 2.6.0.

Procedimiento

  1. Pulse Ventana > Mostrar vista > Explorador de proyectos para abrir la vista Explorador de proyectos.
  2. Ubique el proyecto de aplicación, expanda la carpeta META-INF para el proyecto de aplicación y efectúe una doble pulsación sobre el archivo application.xml o el archivo bundles.xml. Se abrirá el editor de aplicaciones. Para tener una guía para utilizar el editor de aplicaciones, consulte El editor de aplicaciones.
    Consejo: Si CICS Explorer encuentra un error en los archivos XML para el paquete de aplicación, u otro problema importante, se visualizará información acerca del error o problema en la vista Problemas.
  3. Para incluir más paquetes CICS en el paquete de aplicación, pulse Añadir. Seleccione los paquetes CICS adecuados de la lista de paquetes CICS que están disponibles en el espacio de trabajo.
  4. Para eliminar paquetes CICS que están incluidos actualmente en el paquete de aplicación, seleccione los paquetes CICS y pulse Eliminar.
  5. Para editar cualquier paquete de CICS incluido en el paquete de aplicación, efectúe una doble pulsación en el nombre de paquete de CICS en la lista del editor de aplicaciones para abrir el editor de manifiestos de paquete.
    1. Utilice el editor de manifiesto de paquete para añadir y eliminar dependencias del paquete CICS, crear nuevos puntos de entrada de aplicación y definir ámbitos de política.
    2. Para editar recursos definidos en el paquete CICS, utilice los editores de recurso, tal como se describe en Edición de recursos definidos en un proyecto de paquete de CICS.
    3. Una vez que haya actualizado un paquete CICS, utilice el editor de manifiesto de paquete para incrementar los números de versión mayores, menores y micro para el paquete CICS de acuerdo con la política de mantenimiento de versiones, y guarde los cambios.
    4. Elimine la versión anterior del paquete CICS del paquete de aplicación seleccionándola y pulsando Eliminar en el editor de aplicación. Cuando actualiza el número de versión del paquete CICS, CICS Explorer marca la versión anterior con un error en el editor de aplicación.
    5. Incluya el paquete CICS actualizado en el paquete de aplicación mediante la pulsación de Añadir en el editor de aplicación, y mediante la selección de la nueva versión del paquete CICS de la lista de paquetes CICS disponibles en el espacio de trabajo.
  6. Para editar cualquier punto de entrada para la aplicación, efectúe una doble pulsación en el nombre del punto de entrada de aplicación en la lista del editor de aplicaciones para abrir el editor de manifiestos de paquete. Una vez que haya actualizado el punto de entrada de aplicación, utilice el editor de manifiesto de paquete para incrementar los números de versión mayores, menores y micro para el paquete CICS de acuerdo con las políticas de mantenimiento de versiones, y guarde los cambios. Incluya el paquete CICS actualizado que contiene el punto de entrada de aplicación en el paquete de aplicación, y elimine la versión anterior.
  7. Una vez que haya completado las actualizaciones de la aplicación, utilice el campo Versión en el editor de aplicación para incrementar los números de versión mayores, menores y micro para la aplicación de acuerdo con la política de mantenimiento de versiones, luego guarde los cambios.
  8. A continuación, puede actualizar el enlace de aplicación existente para especificar la nueva versión de la aplicación, o crear un nuevo enlace de aplicación para la nueva versión de la aplicación.
    • Para crear un nuevo enlace de aplicación para la nueva versión de la aplicación, pulse Crear un enlace de aplicación en el editor de aplicación para abrir el asistente de enlace de aplicación, y siga los siguientes pasos en el asistente.
    • Para actualizar el enlace de aplicación existente, en la vista Explorador de proyectos, ubique el enlace de aplicación existente para la aplicación, expanda la carpeta META-INF para el proyecto de enlace de aplicación y efectúe una doble pulsación en el archivo application.xml, bundles.xml o deployment.xml. Se abrirá el editor de enlace de aplicación. Si desea una guía para utilizar el editor de enlaces de aplicaciones, consulte El editor de enlaces de aplicaciones.
  9. En el editor de enlace de aplicación, pulse Examinar por el nombre de aplicación y seleccione la nueva versión de la aplicación.
  10. Realice cualquier cambio que sea necesario a los paquetes CICS desplegados con el enlace de aplicación.
    1. Pulse Añadir o Eliminar para cambiar la selección de los paquetes de CICS desplegados con el enlace de aplicaciones.
    2. Efectúe una doble pulsación en cualquiera de los paquetes CICS para editarlos. Actualice y revierta los paquetes CICS y añada las nuevas versiones al enlace de aplicación, de la misma manera que se describe en 5 para los paquetes de CICS para la aplicación.
  11. Para editar cualquier política que se despliega con el enlace de aplicación, efectúe una doble pulsación en el nombre de la política en la lista del editor de aplicaciones para abrir el editor de manifiestos de paquete. Una vez que haya actualizado la política, utilice el editor de manifiesto de paquete para incrementar los números de versión mayores, menores y micro para el paquete CICS de acuerdo con la política de mantenimiento de versiones, y guarde los cambios. Incluya el paquete CICS actualizado que contiene la política en el enlace de aplicación, y elimine la versión anterior.
  12. En la pestaña Despliegue del editor de enlace de aplicación, compruebe que cada uno de los paquetes CICS para la aplicación y cada uno de los paquetes CICS desplegados con el enlace de aplicación, esté vinculado a un tipo de región adecuado. Utilice el botón de conmutación Botón de conmutación para conmutar entre trabajar con los tipos de región y trabajar con los paquetes de CICS.
    1. Cualquier paquete CICS que todavía no está vinculado a ningún tipo de región se marca con la letra X. Si va a trabajar con los paquetes CICS, seleccione cada nuevo paquete CICS y utilice el recuadro de selección para especificar los tipos de regiones donde se va a desplegar.
    2. Los tipos de región especificados en el enlace de aplicación que no se pueden encontrar en la versión actual del proyecto de plataforma asociado con el enlace de aplicación se marcan con un signo de exclamación. Compruebe que esté trabajando con la versión correcta del proyecto de plataforma. Si ha eliminado el tipo de región de la plataforma o ha cambiado a una plataforma que no incluye el tipo de región, limpie el proyecto de enlace de aplicación. Si va a trabajar con los tipos de regiones, seleccione cada tipo de región no deseado y deseleccione todos los paquetes CICS especificados para ese tipo de región.
  13. Una vez que haya completado las actualizaciones del enlace de aplicación, utilice el campo Versión en el editor de enlace de aplicación para incrementar los números de versión mayores, menores y micro para el enlace de aplicación de acuerdo con la política de mantenimiento de versiones, luego guarde los cambios.
    Consejo: El número de versión del enlace de aplicación no tiene que ser el mismo que el número de versión de la aplicación. Sin embargo, de acuerdo con los principios del mantenimiento de versiones semánticas, debería actualizar el número de versión del enlace de aplicación para reflejar el mayor cambio en la aplicación o en los paquetes CICS desplegados con el enlace de aplicación.
  14. Pulse Asistente de exportación en el editor de aplicación o el editor de enlace de aplicación para desplegar la aplicación y el enlace de aplicación actualizados en el directorio de inicio de plataforma en z/OS UNIX. El nuevo número de versión se utiliza como parte del nombre para el directorio, de modo que las versiones anteriores de la aplicación y el paquete de aplicación permanezcan en el directorio de inicio de plataforma.
  15. Cree una nueva definición de recurso APPLDEF para apuntar al directorio de aplicación actualizado. Para crear una definición de recurso APPLDEF durante el proceso de exportación, seleccione el recuadro de selección en el asistente de exportación.
  16. Inhabilite y descarte el recurso APPLCTN instalado que representa la versión anterior de la aplicación.
  17. Instale la nueva definición de recurso APPLDEF.

Resultados

La nueva versión de la aplicación se despliega en la plataforma. Los paquetes CICS incluidos en la nueva versión del paquete de aplicación están instalados en las regiones CICS adecuadas, y los recursos definidos dentro de los paquetes CICS se crean dinámicamente en las regiones CICS.