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 y 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 un servicio de z/OS Connect denominado recordOpsCreate. Tenga en cuenta que en el paso 3 se muestra un ejemplo más completo.
    <!-- Definiciones de servicio de z/OS Connect --> 
    <zosConnectService id="zcs1"  
    	serviceName="recordOpsCreate"  
    	serviceRef="wolaOpsCreate"/> 
    Si desea más información sobre las definiciones de atributo configurables asociadas al elemento zosConnectService, consulte la documentación para 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"/> 

    Si desea más información sobre las definiciones de atributo configurables asociadas al elemento zosConnectManager, consulte la documentación para 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 la 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"
            dataXformRef="zconXform"/> 
    
    <!-- Transformador de datos de z/OS Connect --> 
    <zosConnectDataXform id="zconXform"          
    	bindFileLoc="/zosConnect/bind" 
            bindFileSuffix=".bnd"   
    	requestSchemaLoc="/zosConnect/schema"  
    	responseSchemaLoc="/zosConnect/schema"
    	requestSchemaSuffix=".json"
    	responseSchemaSuffix=".json">
    </zosConnectDataXform> 

    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.

    Cuando linkTaskChanID se configura junto con useCICSContainer=true bajo el elemento localAdaptersConnectService, se envían al programa de destino un conjunto de contenedores de contexto y un contenedor de carga útil. La lista siguiente proporciona los nombres y la descripción de los contenedores de contexto.
    ZCONReqURL
    El contenedor de contexto ZCONRegURL contiene el URL de la solicitud HTTP. Por ejemplo, si utiliza una definición invokeURI de /banking/deposit y el parámetro de solicitud country=USA, el URL es https//localhost:port/banking/deposit?country=USA.
    ZCONReqQParms
    El contenedor de contexto ZCONReqQParms contiene los parámetros de consulta de la solicitud HTTP. Por ejemplo, con el URL de solicitud https//localhost:port//banking/deposit?country=USA, el parámetro de consulta es country=USA.
    ZCONReqMethod
    El contenedor de contexto ZCONReqMethod contiene el método de solicitud HTTP. Por ejemplo, GET.
    ZCONHTTPHeaders
    El contenedor de contexto ZCONHTTPHeaders contiene un conjunto con formato JSON de pares de nombre y valor de cabecera HTTP configurados mediante el atributo linkTaskChanCtxContHttpHeaders bajo el elemento localAdaptersConnectService.
    El atributo linkTaskChanCtxContHttpHeaders acepta una lista de series con distinción de mayúsculas y minúsculas, separadas por comas, que representan los nombres de cabecera que se pasarán al programa de destino en el contenedor ZCONHTTPHeaders. La información contenida en este contenedor de contexto está en formato JSON, por ejemplo, {httpHeaders:{"header1":"header1Value", ...,"headerN":"headerNValue"}}. Si la solicitud contiene varias cabeceras con el mismo nombre, el valor utilizado es el valor de la primera cabecera de la solicitud.

    Los usuarios pueden modificar la codificación predeterminada de los datos (cp819) contenidos en todos los contenedores de contexto mediante el atributo de configuración linkTaskChanCtxContEncoding bajo el elemento localAdaptersConnectService.

    Cuando linkTaskChanID se configura junto con useCICSContainer=true bajo el elemento localAdaptersConnectService, puede personalizar los nombres de carga útil de los contenedores de salida y entrada mediante los atributos linkTaskChanReqContID y linkTaskChanRespContID. Si estos atributos no están definidos, los nombres predeterminados son ZCONReqData y ZCONRespData. El ejemplo siguiente muestra la configuración adecuada.
    <localAdaptersConnectService id="wolaOpsCreate"
            registerName="OLASERVER"
            serviceName="ZCONMC5"
            connectionFactoryRef="wolaCF"
            linkTaskChanID="ZCONCHANNEL"
            linkTaskChanType="1"
            useCICSContainer="true"
            linkTaskChanCtxContHttpHeaders="Connection, CustomHeader1, CustomHeader2, CustomHeader3"
            linkTaskChanReqContID="wolaOpsReqData"
            linkTaskChanRespContID="wolaOpsRespData"
            linkTaskChanCtxContEncoding="cp037"/>

    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. serviceName debe coincidir con el nombre que utiliza una aplicación de espacio de direcciones externa para el nombre de servicio en una API Recibir solicitud o Servicio de host 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 nombre debe coincidir con el nombre que está utilizando una aplicación de espacio de dirección externa para el nombre de registro en una llamada a la API Registrar de WOLA, o el nombre utilizado para RGN con un servidor de enlace CICS de WOLA. registerName puede ser una serie alfanumérica de 1 a 12 caracteres.

    connectionFactoryRef

    required="true"

    type="String"

    Referencia a la fábrica de conexiones de adaptadores de recursos WOLA configurada.

    connectionWaitTimeout

    required="false"

    type="Integer"

    min="0"

    max="2147483647"

    Tiempo de espera en segundos para que una aplicación de espacio de dirección externa que coincida con el nombre de registro emita una API Recibir solicitud o Servicio de host de WOLA y pase a estar activa. Este atributo define la propiedad ConnectionWaitTimeout en la fábrica de conexiones de adaptadores locales optimizados. Si no se especifica ningún valor, se utiliza el valor predeterminado de la propiedad. Para obtener más información, consulte las propiedades de fábrica de conexiones para los adaptadores locales optimizados en la documentación de Liberty.

    linkTaskTranID

    required="false"

    type="String"

    Define el nombre del ID de transacción de tarea de invocación de enlace de servidor de enlaces CICS de WOLA (cualquier serie de 4 caracteres). Este atributo se utiliza cuando se usa el servidor de enlace CICS. Este atributo define la propiedad LinkTaskTranID en la fábrica de conexiones de adaptadores locales optimizados. Para obtener más información, consulte las propiedades de fábrica de conexiones para los adaptadores locales optimizados en la documentación de Liberty.

    useCICSContainer

    required="false"

    type="Boolean"

    default="false"

    Define el mecanismo para utilizar para la propagación de datos. Si está establecido en true, la carga útil se pasa al programa de aplicaciones CICS de destino utilizando contenedores CICS. Si está establecido en false (valor predeterminado), la carga útil se pasa al programa de aplicaciones CICS de destino utilizando COMMAREA. Este atributo se utiliza cuando se usa el servidor de enlace CICS. Este atributo define la propiedad useCICSContainer en la fábrica de conexiones de adaptadores locales optimizados. Para obtener más información, consulte las propiedades de fábrica de conexiones para los adaptadores locales optimizados en la documentación de Liberty.

    linkTaskReqContType

    type="Integer"

    min="0"

    default="0"

    Define el tipo del contenedor de solicitudes (0=CHAR, 1=BIT). Este atributo se utiliza cuando se usa el servidor de enlace CICS y cuando los atributos linkTaskReqContID y useCICSContainer (true) también están configurados. Este atributo define la propiedad linkTaskReqContType en la fábrica de conexiones de adaptadores locales optimizados. Para obtener más información, consulte las propiedades de fábrica de conexiones para los adaptadores locales optimizados en la documentación de Liberty.

    linkTaskRspContID

    required="false"

    type="String"

    Define el nombre del contenedor de respuesta, o salida (una serie de 1 a 16 caracteres que coincide con el nombre de contenedor definido en CICS). Este atributo se utiliza cuando se usa el servidor de enlace CICS y cuando los atributos linkTaskReqContID y useCICSContainer (true) también están configurados. Este atributo define el enlace linkTaskRspContID en la fábrica de conexiones de adaptadores locales optimizados. Para obtener más información, consulte las propiedades de fábrica de conexiones para los adaptadores locales optimizados en la documentación de Liberty.

    linkTaskRspContType

    type="Integer"

    min="0"

    default="0"

    Define el tipo del contenedor de respuestas (0=CHAR, 1=BIT). Este atributo se utiliza cuando se usa el servidor de enlace CICS y cuando los atributos linkTaskRspContID y useCICSContainer (true) también se han configurado. Este atributo define la propiedad linkTaskRspContType en la fábrica de conexiones de adaptadores locales optimizados. Para obtener más información, consulte las propiedades de fábrica de conexiones para los adaptadores locales optimizados en la documentación de Liberty.

    linkTaskChanID

    required="false"

    type="String"

    Define el nombre de canal CICS que se utilizará para el suministro y la recepción de cargas útiles mediante contenedores CICS utilizando una serie de 1 a 16 caracteres que coincide con el nombre de canal definido en CICS. Este atributo se utiliza cuando se utiliza el servidor de enlace CICS y cuando el atributo useCICSContainer (true) también está configurado. Este atributo define la propiedad linkTaskChanID en la fábrica de conexiones de adaptadores locales optimizados. Para obtener más información, consulte las propiedades de fábrica de conexiones para los adaptadores locales optimizados en la documentación de Liberty.

    linkTaskChanType

    required="false"

    type="Integer"

    min="0"

    default="0"

    Define el tipo de contenedores CICS (0=CHAR, 1=BIT) que se van a asociar al ID del canal configurado. Cuando está establecido en 0=CHAR (valor predeterminado), la codificación de los datos de carácter en los contenedores de entrada/salida se esperan/devuelven en ASCII (CCSID 819) y los datos se convierten a o de EBCDIC (cp037) antes/después de que se hayan enviado a/desde el programa de destino. Utilice el tipo BIT para evitar expectativas de codificación y tipo de datos. Este atributo se utiliza al usar el servidor de enlace CICS y cuando los atributos linkTaskChanID y useCICSContainer (true) también están configurados. Este atributo define la propiedad linkTaskChanType en la fábrica de conexiones de adaptadores locales optimizados. Para obtener más información, consulte las propiedades de fábrica de conexiones para los adaptadores locales optimizados en la documentación de Liberty.

    linkTaskChanReqContID

    required="false"

    default="ZCONReqData"

    type="String"

    Define el nombre del contenedor de solicitudes mediante una serie de 1 a 16 caracteres que coincide con el nombre de contenedor definido en CICS. Este atributo se utiliza al usar el servidor de enlace CICS y cuando los atributos linkTaskChanID y useCICSContainer (true) también están configurados.

    linkTaskChanRespContID

    required="false"

    default="ZCONRespData"

    type="String"

    Define el nombre del contenedor de respuestas mediante una serie de 1 a 16 caracteres que coincide con el nombre de contenedor definido en CICS. Este atributo se utiliza al usar el servidor de enlace CICS y cuando los atributos linkTaskChanID y useCICSContainer (true) también están configurados.

    linkTaskChanCtxContEncoding

    required="false"

    type="String"

    default="cp819"

    Define la codificación de los datos en todos los contenedores de contexto que se envían al programa de destino. Este atributo se utiliza al usar el servidor de enlace CICS y cuando los atributos linkTaskChanID y useCICSContainer (true) también están configurados.

    linkTaskChanCtxContHttpHeaders

    required="false"

    type="String"

    Define el nombre de cabecera HTTP o lista de nombres de cabecera HTTP separados por coma que se pasan al programa de destino utilizando el contenedor de contexto con el nombre de ZCONHTTPHeaders. La información contenida en este contenedor de contexto está en formato JSON, de la forma siguiente: {httpHeaders:{"header1":"header1Value", ...,"headerN":"headerNValue"}}. Este atributo se utiliza al usar el servidor de enlace CICS y cuando los atributos linkTaskChanID y useCICSContainer (true) también están configurados.


Icono que indica el tipo de tema Tema de tarea

Nombre de archivo: twlp_zconnect_srvcdef.html