Definición de servicios de z/OS Connect

Las definiciones de servicios de z/OS® Connect proporcionan el mecanismo para llegar a activos de aplicaciones z/OS utilizando llamadas REST. Para habilitar los servicios de z/OS Connect, debe añadir una definición de servicio de z/OS Connect en el archivo de Liberty server.xml con el nombre de elemento zosConnectService junto con un nombre del elemento de referencia del proveedor de servicios.

Acerca de esta tarea

Los servicios de z/OS Connect los define el elemento de configuración zosConnectService. Este elemento contiene definiciones de atributos que pueden tener definidos equivalentes de forma global. Los atributos se pueden definir globalmente a través del elemento zosConnectManager. Si se definen estos atributos, se aplicarán a todos los servicios. Si se han configurado los atributos de nivel global y de servicio, se utilizarán los valores definidos en el nivel zosConnectService.

z/OS Connect proporciona una implementación de servicio que permite que las solicitudes z/OS Connect interactúen con activos de z/OS a través de adaptadores locales optimizados de WebSphere (WOLA). El servicio se habilita automáticamente cuando se han configurado ambas características, zosConnect-1.0 y zosLocalAdapters-1.0. Las instancias de este servicio se pueden definir a través del elemento de configuración localAdaptersConnectService.

z/OS Connect proporciona también una implementación de servicio que permite que las solicitudes z/OS Connect se pongan en contacto con puntos finales REST remotos. El servicio está disponible cuando se configura la característica zosConnect-1.2. Las instancias de este servicio se pueden definir a través del elemento de configuración zosConnectServiceRestClient. Para obtener más información, consulte la documentación del Servicio de cliente REST de z/OS Connect.

Procedimiento

  1. Añada un elemento de configuración zosConnectService para cada servicio en la configuración server.xml. Debe configurar, como mínimo, los atributos serviceRef y serviceName. El elemento serviceRef apunta al elemento de configuración del proveedor de servicio. El atributo serviceName es la forma en que el proveedor de servicio se identifica a sí mismo con z/OS Connect y también es el nombre que se debe utilizar como parte del URL para solicitudes de z/OS que tienen como destino un servicio específico. El nombre de servicio debe ser exclusivo. A continuación encontrará un ejemplo de un archivo server.xml que muestra lo que es necesario para añadir al servicio de z/OS Connect denominado recordOpsCreate:
    <!-- Definiciones de servicio de z/OS Connect --> 
    <zosConnectService id="zcs1"  
    	serviceName="recordOpsCreate"  
    	serviceRef="wolaCreateService"/> 
    Para obtener más información sobre las definiciones de atributos configurables asociadas con el elemento zosConnectService, consulte la documentación de la característica z/OS Connect.
  2. (Opcional) Añada el elemento de configuración zosConnectManager al archivo server.xml.

    Este elemento es un singleton en la configuración de server.xml y contiene valores globales que se aplican a todos los servicios de z/OS Connect que se han definido para el servidor. El elemento puede contener los nombres de los interceptores de z/OS Connect o los elementos de configuración del proveedor de transformación de datos que se aplican a todos los servicios del servidor.

    El ejemplo siguiente describe un elemento de configuración zosConnectManager que define un nombre de grupo de operaciones de Operator1 en el elemento globalOperationsGroup. Se trata del nombre del grupo de seguridad (SAF o LDAP) al cual debe pertenecer el ID de usuario del cliente que realiza la solicitud para poder permitir las solicitudes de operaciones de z/OS Connect como, por ejemplo, action=start|stop|status. Este grupo se aplica a todos los servicios de configuraciones de z/OS Connect. El elemento dataxform define el nombre de elemento donde z/OS Connect encontrará un proveedor de transformación de datos. Si se suministra el valor dataxform en el elemento zosConnect significa que es la implementación del proveedor de transformación para todos los servicios en la configuración que todavía no tienen su propia referencia de elemento de transformación de datos. El elemento de interceptores es el nombre del elemento en la configuración que describe el conjunto de interceptores de z/OS Connect que se aplican a todos los servicios en la configuración.

    <zosConnectManager id="zosConnectGlobals"  
    	globalOperationsGroup="Operator1"  
    	globalDataxformRef="XformJSON2Byte"  
    	globalInterceptorsRef="GlobalInterceptors"/> 

    Para obtener más información sobre las definiciones de atributos configurables asociadas con el elemento zosConnectManager, consulte la documentación de la característica z/OS Connect.

    Para obtener más información sobre cada atributo, consulte la documentación de las características de Liberty.
  3. Si WOLA está configurado en Liberty, la configuración para una solicitud requiere un elemento de configuración localAdaptersConnectService en el archivo server.xml. Esta configuración consta mínimamente del nombre de la fábrica de conexiones de WOLA de destino, el nombre de registro y el nombre de servicio. La configuración de z/OS Connect sigue las convenciones de Liberty porque solamente requiere que se especifique el mínimo de parámetros. Fíjese que cuando se configura la fábrica de conexiones de WOLA para una interacción de z/OS Connect, debe utilizar el contenedor como mecanismo de autenticación. Las fábricas de conexiones de WOLA que no especifican ningún atributo containerAuthDataRef no reciben soporte. A continuación se muestra un ejemplo:
    <!-- Definición de fábrica de conexiones de adaptadores locales --> 
    <authData id="cauth1" user="user1" password="{xor}LDo8Ki02KyY="/> 
    <connectionFactory id="wolaCF" jndiName="eis/ola"        
    	containerAuthDataRef="cauth1"  >       
    	<properties.ola/> 
    </connectionFactory>     
    
    <!-- Configuración de adaptadores locales --> 
    <zosLocalAdapters wolaGroup="LIBERTY" wolaName2="LIBERTY"         
    	wolaName3="LIBERTY" /> 
    
    <!-- Definiciones del servicio de WOLA Connect y del servicio de z/OS Connect --> 
    <localAdaptersConnectService id="wolaOpsCreate"             
    	registerName="BATCH01"   
    	serviceName="COBLPGM1"   
    	connectionFactoryRef="wolaCF"/> 
    
    <zosConnectService id="zcs1" serviceName="recordOpsCreate"    
    	serviceRef="wolaOpsCreate"   
    	runGlobalInterceptors="true"    
    	interceptorsRef="serviceInterceptorList"/> 

    La implementación del servicio de z/OS Connect que permite que las solicitudes de z/OS Connect interactúen con los activos de z/OS a través de adaptadores locales optimizados de WebSphere (WOLA) puede requerir un transformador de datos. Si se ha configurado un transformador de datos, a nivel global o de servicio, las cargas útiles de entrada y de salida se convertirán utilizando el transformador de datos configurado. Si no se ha configurado ningún transformador de datos y la solicitud contiene una carga útil de JSON, el servicio da por supuesto que el programa de fondo gestionará la conversión de datos. El servicio convierte la carga útil de JSON, tal como está, en una matriz de bytes utilizando la codificación especificada en la cabecera de la solicitud o el valor predeterminado de codificación JSON de UTF-8. Del mismo modo, si el activo devuelve una carga útil y no se configura ningún transformador de datos, la implementación de servicio de WOLA esperará recibir una carga útil de JSON en formato de matriz de bytes, que se convertirá a una carga útil de respuesta JSON siguiendo las misma reglas de codificación utilizadas para la transformación de una carga útil de solicitudes JSON a matriz de bytes.

    La implementación del proveedor de servicio WOLA permite especificar una cierta cantidad de definiciones de fábrica de conexiones WOLA en su elemento de configuración localAdaptersConnectService. La tabla siguiente es una lista de definiciones de atributos localAdaptersConnectService y una descripción de cada uno de ellos.

    Definición de atributo Descripción

    serviceName

    required="true"

    type="String"

    Nombre del servicio de destino de WOLA. Este nombre de servicio debe coincidir con el nombre que utiliza una aplicación de espacio de direcciones externa para el nombre de servicio en una llamada a la API Receive Request solicitud o Host Service de WOLA, o el nombre de programa utilizado para SVC con un servidor de enlaces CICS de WOLA.

    registerName

    required="true"

    type="String"

    Nombre del registro de destino de WOLA. Este registro de destino debe coincidir con el nombre que utiliza una aplicación de espacio de direcciones externa como nombre de registro en una llamada a la API Register de WOLA o como nombre que utiliza RGN con un servidor de enlaces CICS de WOLA.

    connectionFactoryRef

    required="true"

    type="String"

    Nombre del elemento de fábrica de conexiones con el nombre JNDI de la fábrica de conexiones del adaptador de recursos WOLA que se debe utilizar. Consulte la documentación del adaptador de recursos de WOLA de Liberty para obtener más información.

    connectionWaitTimeout

    required="false"

    type="Integer"

    min="0"

    max="2147483647"

    Número de segundos que se debe esperar para que una aplicación de espacio de direcciones externa que coincida con el nombre de registro emita una solicitud de API Receive Request o Host Service de WOLA y que esté activa. Consulte la documentación del adaptador de recursos de WOLA de Liberty para obtener más información.

    linkTaskTranID

    required="false"

    type="String"

    Especifica el nombre del ID de transacción de tareas de invocación de enlaces del servidor de enlace CICS de WOLA. Consulte la documentación del adaptador de recursos de WOLA de Liberty para obtener más información.

    useCICSContainer

    required="false"

    type="Boolean"

    default="false"

    Cuando se utiliza el servidor de enlace CICS de WOLA, se indica si la carga útil pasa a un contenedor de CICS individual o a una COMMAREA del programa de aplicación CICS de destino. Consulte la documentación del adaptador de recursos de WOLA de Liberty para obtener más información.

    linkTaskTranID

    required="false"

    type="String"

    Cuando se utiliza el servidor de enlace CICS de WOLA y se define el distintivo useCICSContainer en true, se especifica el nombre del contenedor de solicitudes CICS de destino. Consulte la documentación del adaptador de recursos de WOLA de Liberty para obtener más información.

    linkTaskReqContType

    type="Integer"

    min="0"

    default="0"

    Cuando se utiliza el servidor de enlace CICS de WOLA y el distintivo useCICSContainer se ha establecido en true, se especifica el tipo de contenedor de solicitudes CICS de destino (0=CHAR, 1=BIT). Consulte la documentación del adaptador de recursos de WOLA de Liberty para obtener más información.

    linkTaskRspContID

    required="false"

    type="String"

    Cuando se utiliza el servidor de enlace CICS de WOLA y se define el distintivo useCICSContainer en true, se especifica el nombre del contenedor de respuestas CICS de destino. Consulte la documentación del adaptador de recursos de WOLA de Liberty para obtener más información.

    linkTaskRspContType

    type="Integer"

    min="0"

    default="0"

    Cuando se utiliza el servidor de enlace CICS de WOLA y el distintivo useCICSContainer se ha establecido en true, se especifica el tipo de contenedor de respuestas CICS de destino (0=CHAR, 1=BIT). Consulte la documentación del adaptador de recursos de WOLA de Liberty para obtener más información.

    linkTaskChanID

    required="false"

    type="String"

    Cuando se utiliza el servidor de enlace CICS de WOLA, se especifica el nombre de canal de CICS que se debe utilizar para entregar mensajes y recibir mensajes de respuesta utilizando contenedores de CICS. Consulte la documentación del adaptador de recursos de WOLA de Liberty para obtener más información.

    linkTaskChanType

    required="false"

    type="Integer"

    min="0"

    default="0"

    Cuando se utiliza el servidor de enlace CICS de WOLA y se especifica el nombre de canal linkTaskChanID, se especifica el tipo de contenedores CICS de destino que se asociarán a ese canal (0=CHAR, 1=BIT). Consulte la documentación del adaptador de recursos de WOLA de Liberty para obtener más información.

Icono que indica el tipo de tema Tema de tarea



Icono de indicación de fecha y hora Última actualización: Friday, 16 September 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_zconnect_srvcdef
Nombre de archivo:twlp_zconnect_srvcdef.html