Despliegue de los ejemplos de JCICS

Puede utilizar el paquete de CICS de ejemplo en el CICS Explorer SDK para desplegar los ejemplos de JCICS en una región CICS.

Antes de empezar

Debe crear los proyectos de ejemplo de JCICS, como se describe en Cómo empezar con ejemplos de JCICS.

Acerca de esta tarea

CICS carga y ejecuta las aplicaciones Java desde zFS, de modo que debe desplegar sus aplicaciones compiladas en un directorio adecuado en zFS. Puede crear un directorio adecuado en zFS utilizando la perspectiva z/OS en CICS Explorer. CICS debe tener acceso de lectura y ejecución en el directorio.

El CICS Explorer SDK proporciona soporte para desplegar aplicaciones Java en un proyecto de paquete de CICS en zFS. Un proyecto de paquete de CICS agrupa un conjunto de paquetes de OSGi desplegados y gestionados lógicamente como una unidad. Puede utilizar el proyecto de paquete de CICS de ejemplo para desplegar los ejemplos de JCICS en una región CICS.

Procedimiento

  1. En IDE de Eclipse, abra la perspectiva Java.
  2. Abra el asistente Ejemplo nuevo utilizando una de las opciones siguientes:
    • En la barra de menús de Eclipse, pulseArchivo > Nuevo > Ejemplo.
    • Pulse la flecha abajo en el icono Ejemplo nuevo y pulse Ejemplo.
    • En la vista Explorador de proyectos, pulse con el botón derecho del ratón y pulseNuevo > Ejemplo.
  3. En la carpeta CICS Java, seleccione Ejemplo de paquete CICS OSGi y pulse Siguiente.
  4. En el campo Nombre de proyecto, especifique un nombre para el nuevo proyecto. De forma predeterminada, Eclipse crea un nombre que es la ubicación de carpeta de los ejemplos en el espacio de trabajo, seguido del nombre del ejemplo. Por ejemplo, el nombre de proyecto predeterminado para el paquete de CICS es com.ibm.cics.server.examples.
  5. Pulse Finalizar. Eclipse crea el proyecto de paquete de CICS que contiene un manifiesto y tres recursos. Estos recursos hacen referencia a tres paquetes OSGi. Un archivo de programa es también parte de un proyecto de paquete de ejemplo que puede utilizar para desplegar un proyecto en CICS e instalar un paquete.
  6. Abra el archivo web.osgibundle para verificar su contenido. Este archivo está en formato XML y contiene el nombre simbólico y la versión del paquete de OSGi. También contiene el nombre de un servidor de JVM de ejemplo. El servidor de JVM es el entorno de ejecución para aplicaciones Java en CICS. Cuando crea sus propias aplicaciones, debe proporcionar el nombre del servidor de JVM de destino en este archivo.
  7. Despliegue el paquete de CICS en zFS:
    1. Pulse con el botón derecho del ratón en el proyecto de paquete de CICS y seleccione Exportar a sistema de archivos UNIX de z/OS.
    2. Seleccione Exportar a una ubicación específica en el sistema de archivos y pulse Siguiente.
    3. Especifique sus credenciales FTP si es necesario. Es posible que deba crear una conexión con una máquina host de destino si anteriormente no ha configurado una conexión.
    4. Vaya a un directorio en el que desee desplegar el paquete de CICS y pulse Finalizar.
    El paquete de CICS se despliega en el directorio especificado.
  8. Abra la perspectiva CICS SM. En la vista CICSplex Explorer, seleccione la región CICS en la que desea ejecutar los programas de ejemplo de JCICS.
  9. Instale el recurso de JVMSERVER, DFH$JVMS, se encuentra en el grupo de ejemplo DFH$OSGI. El recurso crea un servidor de JVM de ejemplo en la región de CICS que contiene una infraestructura OSGi. El nombre de este recurso coincide con el nombre del servidor de JVM que se especificó en el manifiesto del paquete de CICS. Puede comprobar el estado del servidor de JVM pulsando Operaciones > Java > Servidores JVM.
  10. Abra la vista Definiciones de paquete pulsando Definiciones > Definiciones de paquete. En esta vista se enumeran todas las definiciones de paquete para la región CICS.
  11. En la vista Definiciones de grupos de recursos, seleccione el grupo DFH$OSGI proporcionado. Si esta vista no está abierta, seleccione Ventana > Mostrar vista para abrirla en la perspectiva Eclipse. La vista Definiciones de paquete se filtra para mostrar la definición de recurso DFH$OSGB.
  12. Copie la definición de recurso en un nuevo grupo y edite los atributos:
    1. Pulse con el botón derecho del ratón en DFH$OSGB y seleccione Copiar.
    2. Pulse con el botón derecho del ratón en cualquier punto de la vista Definiciones de grupos de recursos u seleccione Pegar.
    3. Especifique un nuevo nombre de grupo y pulse Aceptar.
  13. Edite la definición de recurso BUNDLE en el nuevo grupo para cambiar el directorio del paquete de forma que coincida con la ubicación del paquete de CICS desplegado.
  14. Pulse con el botón derecho del ratón en la definición para instalar el recurso BUNDLE. Puede comprobar el recurso BUNDLE instalado con estado ENABLED pulsando Operaciones > Paquetes. También puede comprobar la lista de paquetes OSGi pulsando Operaciones > Java > Paquetes de OSGi.
  15. Para ejecutar los ejemplos en un servidor de JVM, instale el grupo de ejemplo DFH$OSGI en la región CICS. Este grupo contiene las definiciones de recursos para todos los ejemplos. Los recursos de ejemplo BUNDLE y JVMSERVER no se instalan porque ya ha creado recursos con el mismo nombre. Cuando se instala el grupo, CICS crea los recursos que son necesarios para ejecutar los ejemplos.

Resultados

Ha desplegado correctamente el paquete de CICS de ejemplo en zFS y ha creado los recursos de CICS necesarios para ejecutar los ejemplos de JCICS.

Qué hacer a continuación

Puede ejecutar los ejemplos de JCICS como se describe en el apartado Ejecución de los ejemplos de JCICS.