Utilización de editores para plataformas y aplicaciones

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 descriptores de enlaces de aplicación se abren automáticamente después de crear un proyecto de este 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 el botón derecho del ratón en 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.

Cuando trabaje con proyectos para aplicaciones, compruebe que el proyecto de plataforma CICS de la plataforma de destino se halle en el espacio de trabajo local, puesto que CICS Explorer requiere este proyecto para validar las aplicaciones y los enlaces de las aplicaciones.

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 Ctrl+Z (cmd+Z para OS X).

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 Ctrl+S (cmd+S para OS X). 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.

Después de instalar una aplicación en CICSplex, puede verla en el editor de descriptor de aplicaciones en línea. Puede utilizar este editor para habilitar, inhabilitar o inhabilitar y descartar la aplicación instalada así como para ver sus recursos privados. Para trabajar con una aplicación instalada, vaya a la vista Explorador de nubes en la perspectiva Nube de CICS. En el CICSplex donde se encuentra la plataforma, seleccione una versión de la aplicación instalada y pulse dos veces el nombre de aplicación o pulse con el botón derecho el nombre de aplicación y pulse Abrir.

Editor de descriptor de plataforma

Utilice el editor de descriptor de plataforma 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 descriptor de plataforma 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 descriptor de plataformas tiene tres pestañas: Visión general, Tipos de región y Despliegue. La sección Acciones de la pestaña Visión general explica un proceso para editar el proyecto de la plataforma y tiene enlaces con los asistentes y pestañas para realizar cada tarea.

Pestaña Visión general del editor de descriptor de plataformas
La pestaña Visión general del editor de descriptor de plataformas muestra el ID, descripción y directorio de inicio de la plataforma, los tipos de región de la plataforma y los paquetes CICS desplegados con la plataforma. Utilice la pestaña Visión general para las tareas siguientes:
  • 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 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 descriptor de plataformas para abrir el editor de manifiestos de paquete.
La pestaña Tipos de región del editor de descriptor de plataformas
La pestaña Tipos de región del editor de descriptor de plataformas muestra los tipos de región de la plataforma y las definiciones de regiones 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 incluye la región. Utilice la pestaña Tipos de región para las tareas siguientes:
  • 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 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 descriptor 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 descriptor 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 descriptor de plataformas
La pestaña Despliegue del editor de descriptor de plataformas muestra los tipos de región de la plataforma y los paquetes CICS 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 en los que debe desplegarse. 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 descriptor de aplicaciones y editor de manifiestos de paquete

Utilice el editor de descriptor 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. Compruebe que en el espacio de trabajo local se encuentre el Proyecto de plataforma CICS para la plataforma de destino antes de comenzar a trabajar con una aplicación o con un enlace de aplicaciones.

El editor de descriptor de aplicaciones tiene una única pestaña: Visión general. La sección Acciones de 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 aplicación al directorio de inicio de la plataforma.

La pestaña Visión general del editor de descriptor de aplicaciones
La pestaña Visión general del editor de aplicaciones muestra el ID, la versión y la descripción de la aplicación, los paquetes de CICS que se instalarán como parte de la aplicación y las políticas definidas por los paquetes de CICS referenciados. Utilice la pestaña Visión general del editor de aplicaciones para las tareas siguientes:
  • Cambiar el ID, la descripción o el número de versión de la aplicación.
  • Añadir y eliminar paquetes de CICS para la aplicación.
  • Acceder al editor de archivos manifest de paquete para actualizar los paquetes de CICS para la aplicación.
  • Acceder al editor de archivos manifest de paquetes para actualizar los 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 archivos manifest 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. Recuerde que debe 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 de CICS del paquete de aplicación seleccionándola y pulsando Eliminar en el editor de aplicación.Incluya el paquete de 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 de CICS de la lista de paquetes de 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 descriptor de enlaces de aplicaciones

Utilice el editor de descriptor 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. Compruebe que en el espacio de trabajo local se encuentre el Proyecto de plataforma CICS para la plataforma de destino antes de comenzar a trabajar con una aplicación o con un enlace de aplicaciones.

El editor de descriptor de enlaces de aplicaciones tiene dos pestañas: la pestaña Visión general y la pestaña 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
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 de CICS referenciados. Utilice la pestaña Visión general del editor de descriptor de enlaces de aplicaciones para las tareas siguientes:
  • 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.
  • Acceda al editor de definiciones de política para actualizar las políticas definidas en paquetes referenciados por el enlace de aplicación.

Para actualizar un paquete deCICS, efectúe una doble pulsación en el nombre del paquete en la lista de paquetes de CICS en el editor de descriptor de enlaces de aplicaciones para abrir el editor de manifiestos de paquete. Para actualizar una política en uno de los paquetes referenciados, pulse dos veces el nombre de la política en la lista de políticas en el editor de descriptor de enlaces de aplicaciones para abrir el editor de definiciones de política. Cuando actualice un paquete 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 descriptor 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 plataformas
La pestaña Despliegue del editor de plataformas muestra los tipos de región de la plataforma y los paquetes CICS para la aplicación y el enlace de aplicación. Los tipos de región aparecen en la primera columna y los paquetes de CICS aparecen en la segunda columna.
  • Cualquier paquete de 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 de CICS, seleccione cada nuevo paquete de 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 descriptor 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. Cuando trabaje con los tipos de región, seleccione cada tipo de región no deseado y deseleccione todos los paquetes de CICS especificados para dicho 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 distintas versiones de aplicaciones utilizando el control de versiones. Cada paquete de 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 de 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 de las versiones semánticas, consulte el documento técnico de OSGi Alliance Versiones de semántica.

Debe aplicar una política de mantenimiento de versiones a los paquetes de CICS, a los paquetes de aplicaciones y a los enlaces de aplicaciones para desplegar y gestionar actualizaciones en el entorno CICS. No puede utilizar una versión existente de un paquete de aplicación para desplegar nuevas versiones de los paquetes de 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 las versiones del paquete de aplicación y el enlace de aplicación siempre que actualice los paquetes de CICS para la aplicación.

Cuando cambie la versión de una aplicación, según los principios del mantenimiento de versiones semánticas, la nueva versión debería reflejar el mayor cambio en un paquete de CICS que está incluido en la aplicación. Por ejemplo, puede cambiar un paquete de 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 de 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 de CICS debería, por lo tanto, tener un cambio de versión menor, de modo que si la 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 de CICS desplegados con el enlace de aplicación.

Editor de descriptor de aplicaciones en línea

Utilice el editor de descriptor de aplicaciones en línea para ver las aplicaciones que hay instaladas en una plataforma. No puede realizar cambios en el formato de la aplicación instalada utilizando este editor.

El editor de aplicaciones en línea tiene tres pestañas: Visión general, Recursos privados y Atributos. La sección Acciones de la pestaña Visión general tiene enlaces con las otras pestañas.

La pestaña Visión general del editor de descriptor de aplicaciones en línea
Utilice la pestaña Visión general del editor de descriptor de aplicaciones en línea para ver información general sobre la versión de la aplicación instalada, incluido el ID, la descripción y el número de versión, el estado de la versión de la aplicación, los paquetes CICS que forman parte de la aplicación y los puntos de entrada de la aplicación.
  • Puede convertir la versión de la aplicación disponible para los interlocutores utilizando los puntos de entrada de la aplicación mediante los botones Hacer disponible y Hacer no disponible en esta pestaña.
  • Puede habilitar, inhabilitar o descartar la versión de la aplicación utilizando los botones Habilitar e Inhabilitar de esta pestaña.
  • La opción para descartar la versión de la aplicación está disponible como una selección del botón Inhabilitar.
No puede utilizar este editor para cambiar el formato de la aplicación instalada. Para cambiar el formato de la aplicación instalada, modifique e invierta el proyecto de aplicación en el espacio de trabajo local de la vista Explorador de proyectos, luego exporte e instale la nueva versión de la aplicación.

Pestaña Recursos privados del editor de descriptor de aplicaciones en línea
Utilice la pestaña Recursos privados del editor de descriptor de aplicaciones en línea para ver los recursos privados instalados en sus regiones CICS para la versión de la aplicación y los puntos de entrada de la aplicación. Seleccione la pestaña del tipo de recurso que desea ver, por ejemplo, los recursos PROGRAM o LIBRARY. Puede seleccionar la pestaña Conjuntos de paquetes de DB2 para ver el recurso PACKAGESET asociado con la aplicación. Puede seleccionar la pestaña Nombres DS de LIBRARY para ver los nombres de conjuntos de datos que ha generado z/OS para la concatenación LIBRARY de los conjuntos de datos para los recursos privados LIBRARY. Para obtener más información sobre los recursos privados, consulte Recursos privados para versiones de aplicaciones en la documentación del producto CICS TS V5.4.0.

La pestaña Atributos del editor de descriptor de aplicaciones en línea.
Utilice la pestaña Atributos del editor de descriptor de aplicaciones en línea para obtener información detallada acerca de los atributos de la versión de la aplicación instalada, incluidos los directorios de la aplicación y el enlace de aplicación, el estado de habilitación y el estado de disponibilidad, y la firma del recurso.