Rational Developer for System z, Versión 7.6.1

Crear un servicio basado en canal

Los servicios basados en canal son aplicaciones de CICS que se describen como componentes y se juntan utilizando una herramienta tal como Rational Developer for System z. Estos servicios solo están disponibles para otras aplicaciones CICS que utilicen el mandato de API INVOKE SERVICE y pasen datos binarios de contenedores por un canal.

Acerca de esta tarea

En SCA, el programa de aplicación que desee exponer como servicio basado en canal es la implementación de la lógica empresarial. El servicio de componente describe la interfaz al programa de aplicación en WSDL. Un componente tiene una interfaz, que puede contener operaciones y enlaces. Para un servicio basado en canal, un enlace CICS describe el canal. Si selecciona este enlace, Rational Developer for System z añade una sección binding.cics al SCDL. Un servicio basado en canal no tiene correlaciones de datos, debido a que la interfaz de aplicación espera un canal y datos binarios en contenedores.

Procedimiento

  1. Cree un compuesto utilizando Rational Developer for System z.
    1. Especifique el nombre del programa de aplicación como la implementación del componente.
    2. Añada el enlace CICS al servicio o referencia adecuado seleccionando la modalidad de correlación directa en las herramientas.
      • Si especifica un URI en el enlace CICS que esté conectado al servicio de compuesto, este URI proporciona el nombre externo para el servicio. En CICS, este URI es un nombre de vía de acceso relativa; por ejemplo, si el servicio debe exponerse como http://myhost:port/myService, el URI en el enlace es myService, porque el host y el puerto están fuera del control de la aplicación de compuesto.
      • Si especifica un URI en el enlace CICS que esté conectado a la referencia de compuesto, el URI está completo para el servicio; por ejemplo http://myhost:port/myService o cics://PROGRAM/prog1?user=user1.
    3. Opcional: Defina importaciones en la referencia de compuesto. Las importaciones definen las dependencias del componente o compuesto.
    Un recuadro representa al compuesto. Dentro del compuesto hay otro recuadro que representa al componente. Una flecha pequeña entra en el componente por la izquierda para representar el servicio de componente. Otra flecha pequeña sale del componente por la derecha para representar la referencia de componente. Una flecha grande entra en el compuesto por la izquierda para representar el servicio de compuesto; tiene texto para indicar que es una Operación con un enlace CICS. Una flecha grande sale del compuesto por la derecha para representar la referencia de compuesto; tiene texto para indicar que tiene Importaciones con un enlace CICS.

    Para obtener detalles sobre las maneras recomendadas de crear y desplegar compuestos en CICS, consulte Procedimientos recomendados para crear y desplegar compuestos.

  2. Despliegue el compuesto en CICS como un paquete. Rational Developer for System z genera el manifiesto de paquete y empaqueta el SCDL y otros artefactos automáticamente. El manifiesto describe todos los recursos y metadatos que CICS necesita para instalar satisfactoriamente un recurso BUNDLE; el recurso BUNDLE representa el compuesto en la región CICS. El manifiesto define el compuesto como un tipo de recurso SCACOMPOSITE y hace referencia a la ubicación del SCDL utilizando una vía de acceso relativa.
  3. Cree e instale el recurso BUNDLE. Puede establecer un dominio SCA opcionalmente en la definición de recurso BUNDLE. Un dominio SCA normalmente representa un conjunto de servicios que proporcionan un área de función de negocio. Puede instalar el mismo paquete utilizando distintos dominios SCA, ya que CICS identifica el servicio combinando el dominio SCA y el nombre del servicio. Para obtener detalles y ejemplos de cómo añadir un dominio SCA, consulte Ámbitos para paquetes

    Debe asegurarse de que todos los requisitos previos del paquete están disponibles en la región CICS para que el recurso BUNDLE se instale satisfactoriamente.

  4. Escriba una aplicación para llamar al servicio basado en canal utilizando el mandato de API INVOKE SERVICE:
    EXEC CICS INVOKE SERVICE('nombreservicio')
              CHANNEL(canal)
              OPERATION(operación)

    El nombreservicio es el nombre externo del servicio, el canal es el nombre de 16 bytes del canal, y la operación es cualquier valor. Aunque la operación es una opción obligatoria en el mandato, el valor no se utiliza para servicios basados en canal.

Resultados

Cuando la aplicación llama al servicio basado en canal, CICS resuelve el nombre del servicio y emite un mandato EXEC CICS LINK para pasar el canal y los contenedores especificados al programa de aplicación que ha definido en el compuesto. Si ha especificado una interconexión de peticionario específica en el enlace, CICS ejecuta la petición a través de esa interconexión de peticionario. Si no se ha especificado una interconexión de peticionario en el enlace, CICS crea de forma dinámica una interconexión de peticionario para la petición.

Qué hacer a continuación

Puede probar y validar que el servicio funciona como estaba previsto. Puede ver el recurso BUNDLE y su contenido utilizando el IBM CICS Explorer. También puede habilitar e inhabilitar el recurso BUNDLE para gestionar todos los recursos juntos.

Términos de uso | Comentarios

Este Information Center está basado en tecnología Eclipse. (http://www.eclipse.org)