Cómo añadir recursos a un proyecto de paquete de CICS

Cuando se añaden definiciones de recursos a un proyecto de paquete de CICS, CICS crea dinámicamente recursos cuando se despliega e instala el paquete en la región CICS.

Antes de empezar

Primero debe crear un proyecto de paquete de CICS para poder añadirle recursos. Para más información, consulte Creación de un proyecto de paquete de CICS.

Acerca de esta tarea

Algunas características de recursos de CICS cambian debido a que están definidas en un paquete de CICS y se crearon dinámicamente como parte de un despliegue de paquete. El ciclo de vida de los recursos de CICS que se crean de esta manera no se puede administrar independientemente del recurso de PAQUETE. Deben administrarse a través del paquete de CICS. Debido a la interdependencia entre el ciclo de vida del paquete y del recurso, los arquitectos de aplicaciones deben considerar cuidadosamente cuál conjunto de recursos para una aplicación debería tener su ciclo de vida enlazado con el ciclo de vida de un paquete de CICS. Para entender más sobre las potenciales implicaciones de definir recursos en los paquetes de CICS, consulte Características de los recursos de paquete.

Puede hacer referencia a uno a muchos paquetes de CICS en un paquete de aplicaciones. Al empaquetar la aplicación de esta forma, puede desplegar una aplicación y sus paquetes como una única entidad en CICS, lo que hace más fácil de actualizar y gestionar la aplicación en CICS. Un paquete de CICS sólo puede instalarse en regiones CICS por más de una aplicación si solamente contiene recursos aptos para versiones múltiples.

Las aplicaciones desplegadas en plataformas que utilizan los recursos CICS admitidos como recursos privados, en combinación con otros recursos designados para aplicaciones y con recursos importados, son aptos para las versiones múltiples. Los siguientes recursos se admiten como parte de aplicaciones de versiones múltiples:
  • Recursos PROGRAM definidos en paquetes de CICS que forman parte de la aplicación
  • Recursos LIBRARY definidos en paquetes de CICS que forman parte de la aplicación
  • Políticas
  • Sentencias de puntos de entrada de aplicación
  • Cualquier recurso definido como dependencia, o importación, de la aplicación

No es posible incluir en otras aplicaciones un paquete de CICS que contiene otros tipos de recursos que se hallan instalados en las mismas regiones CICS de la plataforma y no puede añadirlo a la plataforma si ya se ha instalado para una aplicación. Si la aplicación necesita un recurso no apto para versiones múltiples que ya se halla en un paquete de CICS que se haya instalado en el tipo de región de destino de la plataforma, cree un nuevo proyecto de paquete de CICS. Declare el recurso como dependencia del nuevo paquete de CICS, especificando una importación en el archivo de manifiesto. Después incluya el nuevo proyecto de paquete de CICS en su proyecto de aplicación. Para obtener instrucciones para declarar un recurso como una dependencia, consulte Definición de dependencias de paquete.

Al definir una transacción TRANSACTION en un paquete CICS y desplegar el paquete CICS como parte de una aplicación, o al añadir el paquete CICS a una plataforma, no se da soporte a la instalación automática del programa inicial para la transacción. Para un recurso TRANSACTION que se define en un paquete CICS que se despliega como parte de una aplicación, deberá definir y desplegar el recurso PROGRAM para el programa inicial de la transacción, como parte de la misma aplicación. Para un recurso TRANSACTION que se define en un paquete CICS que se despliega con una plataforma, deberá definir y desplegar el recurso PROGRAM para el programa inicial de la transacción, de una de las siguientes maneras:
  • En un paquete CICS que se despliegue con la plataforma.
  • Como parte de una aplicación que se despliegue en la plataforma.
  • En las regiones CICS que formen parte de la plataforma, utilizando un paquete CICS autónomo, el CSD de CICS o el repositorio de datos de CICSPlex SM.

Para definir un recurso en un proyecto de paquete de CICS, siga estos pasos:

Procedimiento

  1. En la vista de Explorador de proyectos, pulse el botón derecho del ratón en el proyecto de paquete de CICS y seleccione Nuevo.
  2. Seleccione el recurso que desee añadir en el menú; por ejemplo un programa, biblioteca, transacción o definición de correlación URI.
    Consejo: Los paquetes de CICS admiten nombres con combinaciones de mayúsculas y minúsculas para recursos donde estos sean admitidos en CICS. Sin embargo, el sistema de archivos podría no admitir archivos con el mismo nombre pero con mayúsculas y minúsculas diferentes a que residan en el mismo proyecto de paquete de CICS. Si necesita nombres de recurso duplicados que utilicen mayúsculas y minúsculas diferentes, defina estos recursos en proyectos de paquete de CICS separados.
  3. Complete los campos necesarios en el asistente.
    1. Para un subconjunto de recursos de CICS puede añadir una operación de aplicación si el recurso es un punto de entrada a la aplicación.
    2. Para un servidor de JVM, puede decidir crear un perfil de JVM utilizando una de las plantillas proporcionadas, OSGi, Axis2 o Liberty o utilizar un perfil de JVM existente que esté en el paquete de CICS o importar un perfil de JVM al paquete de CICS desde otro lugar en el espacio de trabajo o el sistema de archivos local. Después de completar el asistente, edite el perfil de JVM para que cumpla las necesidades de su sistema, siguiendo las instrucciones que encontrará en Edición de recursos definidos en un proyecto de paquete de CICS.
    3. Para una interconexión, puede decidir crear un archivo de configuración de interconexiones utilizando uno de los archivos de configuración de interconexiones de ejemplo suministrado por CICS de o importar un archivo de configuración existente desde el sistema de archivos local o desde el espacio de trabajo local. Después finalizar las tareas del asistente, edite el archivo de configuración de interconexiones para añadir los manejadores de mensajes, los programas de proceso de cabeceras y los manejadores de aplicaciones que desee incluir, siguiendo las instrucciones que encontrará en Edición de recursos definidos en un proyecto de paquete de CICS.
    4. Para un servicio web, importe un archivo de enlace del servicio web del sistema de archivos local o del espacio de trabajo local para crear la definición WEBSERVICE. Puede optar por importar un documento WSDL o un archivo de archivado WSDL que se empaquetarán en el paquete, y para un proveedor de servicios puede marcar el recuadro de selección para incluir una definición PROGRAM en el paquete. Tenga en cuenta que el servicio web se crea con el valor predeterminado que no requiere la validación completa de mensajes SOAP, pero puede cambiarlo en el editor de recursos o en CICS después de instalar el recurso.
    5. Después de crear una definición WEBSERVICE, puede pulsar el botón derecho del ratón sobre ésta e iniciar un asistente para generar las definiciones URIMAP para el servicio web y crear una transacción de alias:
      • La vía de acceso para URIMAP se rellena previamente basándose en el archivo de enlace del servicio web, pero puede especificar una vía de acceso diferente si es necesario.
      • El nombre de sistema principal y el número de puerto para URIMAP se rellenan previamente en base al archivo de enlace del servicio web. Si no es posible recuperar el nombre del sistema principal, CICS Explorer muestra un mensaje de aviso y deberá indicar un valor en el campo Sistema principal. Si no se puede recuperar el número de puerto, CICS Explorer proporciona un valor predeterminado de 80 ó 443, dependiendo del esquema URI.
      • La transacción de alias predeterminada CPIH, pero puede cambiarla y puede marcar el recuadro de selección para generar una definición de transacción. Tenga en cuenta que las definiciones de transacciones no se generarán para CPIH ni CPIQ, incluso aunque haya marcado el recuadro de selección. Otros nombres de transacciones que empiecen por C se reservan para CICS.
      • Para que el recurso URIMAP se halle en un punto de entrada de la aplicación, puede abrir el Editor del manifiesto de paquetes de CICS y conmutar a la pestaña Puntos de entrada y, a continuación, añadir un punto de entrada especificando un nombre de operación único, un tipo de recurso URIMAP y el nombre de recurso URIMAP.
    6. Para un recurso URIMAP, puede crear un archivo de configuración URIMAP mediante el diálogo Nueva definición de correlación URI. Especifique el sistema principal, la vía de acceso y elija el uso.
      • Para una definición URIMAP que utiliza un archivo HFS para proporcionar una respuesta estática, el archivo debe estar empaquetado en el paquete de CICS con el recurso URIMAP. Especifique una vía de acceso de archivo relativo que sea relativa al directorio raíz del paquete de CICS. Para una vía de acceso de archivo relativo, no utilice una barra inclinada al inicio de la vía de acceso. Se pueden utilizar vías de acceso absolutas pero no es recomendable en absoluto.
      • Seleccione el uso:
        • Para crear una definición URIMAP para CICS como servidor HTTP, seleccione Servidor. Este tipo de definición URIMAP se utiliza para correlacionar el URI de una solicitud HTTP entrante desde un cliente web a recursos CICS. Es posible proporcionar una respuesta generada por la aplicación o una respuesta estática.
        • Para crear una definición URIMAP para CICS como cliente HTTP, seleccione Cliente. Este tipo de definición URIMAP se utiliza cuando CICS hace una petición para un recurso HTTP en un servidor, así puede evitar identificar el URI en su programa de aplicación.
        • Para crear una definición URIMAP para un servicio web, seleccione Interconexión. Este tipo de definición URIMAP se utiliza para una solicitud de servicio web entrante; es decir, una solicitud por la que un cliente invoca un servicio web en CICS. El URI de la solicitud entrante está asociada con los recursos WEBSERVICE y PIPELINE, los cuales especifican el proceso que se va a realizar en el mensaje.
        • Para crear una definición URIMAP para un canal de información Atom, seleccione Atom. Este tipo de definición URIMAP se utiliza para una solicitud de entrada para datos que CICS deja disponible como canal de información de Atom. La definición URIMAP correlaciona el URI de la solicitud con una definición de recurso ATOMSERVICE, que define un documento de Atom.
        • Para crear un URIMAP para una aplicación web que se está ejecutando en un servidor de JVM, seleccione Servidor de JVM. Este tipo de URIMAP se utiliza para correlacionar solicitudes de aplicaciones en una transacción CICS. Si no hay ningún URIMAP que coincida con el URI de la solicitud entrante, CICS utiliza la transacción CJSA.
        • Para configurar el URIMAP para que proporcione una respuesta estática, seleccione Archivo y, a continuación, seleccione Archivo HFS o Nombre de plantilla. El atributo de uso se establece en USAGE(SERVER).
      • Para que el recurso URIMAP se halle un punto de entrada de la aplicación, marque el recuadro de selección Crear un punto de entrada de la aplicación y especifique un nombre de operación único. De forma alternativa, puede abrir el Editor del manifiesto de paquetes de CICS y conmutar a la pestaña Puntos de entrada y, a continuación, añadir un punto de entrada especificando un nombre de operación único, un tipo de recurso URIMAP y el nombre de recurso URIMAP.
  4. Pulse Finalizar.
  5. Si desea ver y editar los atributos del recurso inmediatamente después de creado, seleccione el recuadro de selección Abrir editor para abrir el editor del recurso al finalizar el asistente. Si desea hacerlo más adelante, puede abrir el editor de recursos desde la vista del Explorador de proyectos.

Resultados

Se crea una definición de recurso en el proyecto de paquete de CICS y se actualiza el manifiesto de paquete.

Qué hacer a continuación

Para editar el recurso en el editor de recursos, siga las instrucciones en Edición de recursos definidos en un proyecto de paquete de CICS.

Cuando complete la definición del recurso, puede desplegar el proyecto de paquete de CICS al zFS, o empaquetar el paquete para que se despliegue con un paquete de aplicación o de plataforma. Consulte Despliegue de un paquete de CICS si desea más información.