Puede utilizar el paquete de CICS de
ejemplo en el CICS Explorer SDK
para desplegar los ejemplos de JCICS en una región
CICS.
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
- En IDE de Eclipse, abra la perspectiva Java.
- Abra el asistente Ejemplo nuevo utilizando una de las opciones siguientes:
- En la barra de menús de Eclipse, pulse.
- 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 pulse.
- En la carpeta CICS Java, seleccione Ejemplo de paquete CICS
OSGi y pulse Siguiente.
- 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.
- 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.
- 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.
- Despliegue el paquete de CICS en zFS:
- 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.
- Seleccione Exportar a una ubicación específica en el sistema de archivos y pulse Siguiente.
- 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.
- 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.
- 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.
- 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 .
- Abra la vista Definiciones de paquete pulsando . En esta vista se enumeran todas las definiciones de paquete para la región
CICS.
- En la vista Definiciones de grupos de recursos, seleccione el grupo DFH$OSGI proporcionado. Si esta vista no está abierta, seleccione para abrirla en la perspectiva Eclipse. La vista Definiciones de paquete se filtra para mostrar la definición de recurso DFH$OSGB.
- Copie la definición de recurso en un nuevo grupo y edite los atributos:
- Pulse con el botón derecho del ratón en DFH$OSGB y seleccione Copiar.
- Pulse con el botón derecho del ratón en cualquier punto de la vista Definiciones de grupos de recursos u seleccione Pegar.
- Especifique un nuevo nombre de grupo y pulse Aceptar.
- 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.
- 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 . También puede comprobar la lista de paquetes OSGi pulsando .
- 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.