Utilización de editores para plataformas, aplicaciones y políticas

Utilice editores para trabajar con los proyectos de plataforma, los proyectos de aplicación y los proyectos de enlace de aplicación y proyectos de paquetes de CICS después de crearlos.

Los editores de plataformas, aplicaciones y enlaces de aplicaciones se abren automáticamente después de crear un proyecto de ese tipo. Para abrir el editor de manifiestos de paquete después de crear un proyecto de paquete de CICS, o para abrir cualquiera de los editores posteriormente, vaya a la vista Explorador de proyectos en la perspectiva de Nube de CICS. Expanda la carpeta META-INF para el proyecto y efectúe una doble pulsación en cualquiera de los archivos .xml para el paquete, excepto el archivo manifest.xml. Como alternativa a la doble pulsación, puede pulsar con el botón derecho del ratón el archivo y pulsar Abrir con y, a continuación, seleccionar el nombre del editor. Cuando se abre el editor, la pestaña de nombre de editor muestra el nombre de plataforma, aplicación, enlace de aplicación o paquete de CICS.

Si no dispone de un sistema de copia de seguridad con versión que le permita revertir a una versión anterior de los proyectos, en lugar de editar los proyectos existentes directamente, es posible que prefiera copiarlos en otro proyecto y después editar las copias nuevas.

Los errores y avisos durante el proceso de edición se muestran en la ventana principal en el editor, la pestaña Problemas en la perspectiva o el campo estado en el entorno de trabajo.

Para revertir uno o más de los cambios antes de guardarlos, utilice la función Deshacer. En el menú de entorno de trabajo, pulse Editar > Deshacer o pulse Control-Z.

Cuando haya completado las actualizaciones en un paquete de aplicación, un paquete de enlace de aplicación o un paquete de CICS, actualice siempre los números de versión mayores, menores y micro para el paquete de acuerdo con la política de mantenimiento de versiones. CICS valida los números de versión cuando se instala una aplicación en la plataforma y deben actualizarse los números de versión para el paquete de aplicación y el enlace de aplicación cada vez que se actualizan los paquetes de CICS para la aplicación. Los paquetes de plataforma no utilizan control de versiones. Para obtener información sobre el mantenimiento de versiones, consulte Control de versiones.

Para guardar los cambios, pulse el icono Guardar Icono Guardar o pulse Control-S. Si intenta cerrar el editor sin guardar los cambios, se visualiza un diálogo que le pregunta si desea guardar los cambios o cerrar sin guardarlos.

Cuando haya guardado los cambios, exporte la plataforma o aplicación al directorio de inicio de la plataforma en zFS. Seleccione la acción exportar en la pestaña Visión general del editor para abrir el asistente de exportación. Una aplicación, su enlace de aplicación y sus paquetes de CICS asociados se exportan juntos como un único proceso. El nuevo número de versión se utiliza como parte del nombre de directorio, de modo que las versiones anteriores de los paquetes permanecen en el directorio de inicio la plataforma.

Para instalar la plataforma o aplicación en CICSplex, necesitará una nueva definición de recurso PLATDEF o APPLDEF que apunte al directorio de plataforma o aplicación correcto en el directorio de inicio de la plataforma. Para crear esta definición de recurso durante el proceso de exportación, seleccione el recuadro de selección en el asistente de exportación.

Editor de plataformas

Utilice el editor de plataformas para trabajar con paquetes de plataformas que todavía no se han instalado en un CICSplex. Cuando una plataforma ya está instalada y activa, puede utilizar los menús de la perspectiva de Nube de CICS para añadir y eliminar regiones CICS individuales en tipos de región, y puede añadir y eliminar paquetes de CICS que se despliegan con la plataforma. Sin embargo, no puede modificar los tipos de región en una plataforma instalada, por lo tanto utilice el editor de plataformas para finalizar los tipos de región antes de instalar el paquete de plataforma. Si edita un paquete de plataforma para una plataforma que ya está instalada, debe detener, descartar, reinstalar y reiniciar la plataforma para implementar los cambios.

El editor de plataformas tiene tres pestañas: Visión general, Tipos de región y Despliegue. La lista de acciones en la pestaña Visión general explica un proceso para editar el proyecto de la plataforma y tiene enlaces a los asistentes y pestañas para realizar cada tarea.

La pestaña Visión general del editor de plataformas muestra el ID, la descripción y el directorio de inicio de la plataforma, los tipos de región en la plataforma y los paquetes de CICS que están desplegados con la plataforma. Se listan las acciones que puede realizar en la plataforma.
Utilice la pestaña Visión general del editor de plataformas para estas tareas:
  • Cambiar el ID, la descripción o el directorio de inicio de la plataforma para la plataforma.
  • Añadir y eliminar tipos de región para la plataforma. La pestaña Visión general tiene funciones básicas para crear tipos de región nuevos o adoptar tipos de región desde una topología existente. Para modificar los tipos de región y trabajar con las regiones de CICS en ellos, utilice la pestaña Tipos de región. Si efectúa una doble pulsación en el nombre de un tipo de región, le lleva a ese tipo de región en la pestaña Tipos de región.
  • Añadir y eliminar paquetes de CICS que se despliegan con la plataforma. Para editar cualquiera de estos paquetes de CICS, efectúe una doble pulsación en el nombre del paquete en la lista del editor de plataformas para abrir el editor de manifiestos de paquete.
La pestaña Tipos de región del editor de plataformas muestra los tipos de región en la plataforma y las definiciones de región CICS en los tipos de región creados. Los tipos de región adoptados se marcan como Adoptados. Si está seleccionado un tipo de región, la pestaña muestra las propiedades y las opciones avanzadas para el tipo de región. Si se selecciona una definición de región CICS, la pestaña muestra los atributos de la definición de la región CICS y los tipos de región que incluyen la región.
Utilice la pestaña Tipos de región del editor de plataformas para estas tareas:
  • Añadir y eliminar tipos de región para la plataforma. Puede crear nuevos tipos de región o adoptar tipos de región de una topología existente.
  • Crear nuevas definiciones de región de CICS en tipos de región creados.
  • Especificar o editar las propiedades básicas para definiciones de región CICS en tipos de región creados.
  • Añadir y eliminar definiciones de región CICS en tipos de región creados y compartirlas entre los tipos de región creados. Las definiciones de región CICS huérfanas que no se encuentran actualmente en un tipo de región, se visualizan en la parte superior de la lista. Seleccione la región para añadirla a un tipo de región.
El editor de plataformas no se conecta con el CICSplex de destino, por lo tanto no puede utilizarlo para añadir, eliminar o compartir regiones CICS en tipos de región adoptados. Tan sólo puede trabajar con definiciones de región CICS en tipos de región creados.

Utilice la pestaña Despliegue del editor de plataformas para correlaciones los paquetes de CICS que se despliegan con la plataforma con los tipos de región de la plataforma. Utilice el botón de conmutación El botón de conmutación para conmutar entre trabajar con los tipos de región y trabajar con los paquetes de CICS.

La pestaña Despliegue del editor de plataformas muestra los tipos de región en la plataforma, y los paquetes de CICS que están desplegados con la plataforma. Los tipos de región aparecen en la primera columna y los paquetes de CICS aparecen en la segunda columna.
Seleccione cada paquete de CICS y utilice los recuadros de selección para especificar los tipos de región donde se va a desplegar. Los paquetes de CICS que todavía no estás enlazados a ningún tipo de región se marcan con un error.

Editor de aplicaciones y editor de manifiestos de paquete

Utilice el editor de aplicaciones y el editor de manifiestos de paquete para actualizar las aplicaciones. El apartado Actualización de aplicaciones describe el proceso que debe seguirse para actualizar una aplicación y desplegar la nueva versión de la aplicación en la plataforma. También debe actualizar el enlace de aplicación cuando actualice la aplicación.

El editor de aplicaciones tiene una única pestaña, la pestaña Visión general. La lista de acciones en la pestaña Visión general tiene enlaces a asistentes que puede utilizar para crear los nuevos paquetes de CICS o un enlace de aplicaciones para la aplicación y para exportar la aplicación y el enlace de aplicaciones al directorio de inicio de plataforma.

La pestaña Visión general del editor de aplicaciones muestra el ID, la versión y la descripción para la aplicación, los paquetes de CICS que se instalarán como parte de la aplicación y los puntos de entrada definidos por los paquetes de CICS referenciados. Se listan las acciones que puede realizar en la aplicación.
Utilice la pestaña Visión general del editor de aplicaciones para estas tareas:
  • Cambiar el ID, la descripción o el número de versión para la aplicación.
  • Añadir y eliminar paquetes de CICS para la aplicación.
  • Acceder al editor de manifiestos de paquete para actualizar paquetes de CICS para la aplicación.
  • Acceder al editor de manifiestos de paquete para actualizar puntos de entrada de aplicación.

Para actualizar un paquete de CICS o un punto de entrada de aplicación, efectúe una doble pulsación en su nombre en la lista del editor de aplicaciones para abrir el editor de manifiestos de paquete. El editor de manifiestos de paquete tiene tres pestañas: Visión general, Puntos de entrada y Ámbitos de política. Puede utilizar el editor de manifiestos de paquete para crear nuevas definiciones de recurso en el paquete de CICS, eliminar definiciones de recurso del paquete de CICS y añadir y eliminar dependencias en recursos importados, crear y editar puntos de entrada de aplicación y definir ámbitos de política. También puede acceder a los editores de recursos para editar recursos existentes que están definidos en el paquete de CICS. Acuérdese de aumentar el número de versión para el paquete de CICS cuando haya finalizado las actualizaciones.

Cuando edita un paquete de CICS o un punto de entrada de aplicación (definido en un paquete de CICS) para la aplicación y aumenta el número de versión para el paquete de CICS, CICS Explorer marca la versión anterior con un error en el editor de aplicaciones. Elimine la versión anterior del paquete CICS del paquete de aplicación seleccionándola y pulsando Eliminar en el editor de aplicación.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.

Cuando finalice todas las actualizaciones en la aplicación y los paquetes de CICS asociados, acuérdese de actualizar los números de versión mayores, menores y micro para que el paquete de aplicación refleje el nivel de los cambios que ha realizado, tal como se describe en el apartado Control de versiones.

Editor de enlaces de aplicaciones

Utilice el editor de enlaces de aplicaciones para actualizar la información de despliegue para las aplicaciones. El apartado Actualización de aplicaciones describe el proceso que debe seguirse para actualizar una aplicación y un enlace de aplicación, y para utilizar el enlace de aplicación para desplegar la nueva versión de la aplicación en la plataforma.

El editor de enlaces de aplicaciones tiene dos pestañas: Visión general y Despliegue. La lista de acciones de la pestaña Visión general tiene enlaces a asistentes que puede utilizar para crear paquetes de CICS para desplegar con el enlace de aplicaciones y para exportar la aplicación y el enlace de aplicaciones al directorio de inicio de plataforma.

La pestaña Visión general del editor de aplicaciones muestra el ID, la versión y la descripción para el enlace de aplicaciones, los paquetes de CICS que se instalarán como parte de la aplicación y las políticas definidas por los paquetes CICS referenciados. Se listan las acciones que puede realizar en el enlace de aplicaciones.
Utilice la pestaña Visión general del editor de enlaces de aplicaciones para estas tareas:
  • Cambiar el ID, la descripción o el número de versión del enlace de aplicación.
  • Cambiar la plataforma o aplicación a la que hace referencia el enlace de aplicación.
  • Añadir y eliminar paquetes de CICS que se despliegan con el enlace de aplicación.
  • Acceder al editor de manifiestos de paquete para actualizar paquetes de CICS que se despliegan con el enlace de aplicación.
  • Acceder al editor de manifiesto de paquete para actualizar políticas para la aplicación.

Para actualizar un paquete o una política de CICS, efectúe una doble pulsación en el nombre del paquete o la política en la lista del editor de enlaces de aplicaciones para abrir el editor de manifiestos de paquete. Cuando actualice un paquete o una política de CICS, elimine la versión anterior del paquete de CICS del paquete de enlace de aplicación y añada la nueva versión, del mismo modo que para el editor de aplicaciones.

Utilice la pestaña Despliegue del editor de enlaces de aplicaciones para correlacionar los paquetes de CICS para la aplicación referenciada, y también los paquetes de CICS que están desplegados con el enlace de aplicaciones, con los tipos de región de la plataforma de destino. Utilice el botón de conmutación El botón de conmutación para conmutar entre trabajar con los tipos de región y trabajar con los paquetes de CICS.
La pestaña Despliegue del editor de aplicaciones muestra los tipos de región en la plataforma y los paquetes de CICS para la aplicación y el enlace de aplicaciones. Los tipos de región aparecen en la primera columna y los paquetes de CICS aparecen en la segunda columna.
  • 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.
  • 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 trabaja con la versión correcta de proyecto de plataforma y vea el proyecto de plataforma en el editor de plataformas para verificar los tipos de región. 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.

Cuando finalice todas las actualizaciones en el enlace de aplicación y los paquetes de CICS asociados, acuérdese de actualizar los números de versión mayores, menores y micro para que el paquete de enlace de aplicación refleje el nivel de los cambios que ha realizado, tal como se describe en el apartado Control de versiones.

Control de versiones

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.

El número de versión para el enlace de aplicación no es necesario que sea el mismo número de versión que la aplicación asociada. 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.