Definición de transformaciones de carga útil de mensajes de z/OS Connect

IBM® z/OS® Connect proporciona la posibilidad de transformar opcionalmente carga útiles de solicitudes y respuestas que se utilizan para llamar a un activo empresarial en los sistemas operativos z/OS. Puede crear transformadores de carga útil de mensajes para satisfacer las necesidades específicas implementando la interfaz de proveedor de servicios (SPI) com.ibm.wsspi.zos.connect.DataXform que se incluye con z/OS Connect.

Acerca de esta tarea

z/OS Connect proporciona una implementación que requiere que el mensaje de solicitud y respuesta esté en formato JSON. Esta característica admite la conversión de la solicitud en una matriz de bytes, que se puede correlacionar mediante una estructura de lenguaje nativo Cobol, PL/I o C. Esta estructura de lenguaje del programa de destino, o libro de copias, que incluye una descripción de los parámetros in y out, se utiliza para generar un archivo de enlaces y archivos de esquema de solicitud y respuesta JSON empleando un programa de utilidad que proporciona z/OS Connect. El archivo de enlaces que genera este programa de utilidad lo utiliza z/OS Connect para completar la conversión de datos respecto a formatos de datos JSON y nativos a medida que llegan las solicitudes y se devuelven las respuestas. Puede recuperar los esquemas JSON para el mensaje de solicitud y respuesta con una llamada a la API REST que proporciona z/OS Connect.

z/OS Connect proporciona el elemento de configuración zosConnectService que permite que el administrador configure un conjunto de atributos que se aplican a un servicio determinado. Uno de estos atributos es dataXformRef, que apunta a una configuración de transformación de datos que debe utilizar un servicio específico. Esta tarea describe cómo solicitar que se utilice el transformador de datos suministrado por z/OS Connect.

Procedimiento

  1. Actualice el elemento zosConnectService para cada servicio en la configuración de server.xml para el que desee habilitar la transformación de datos suministrados por z/OS Connect.
    <!-- Definición de servicio de z/OS Connect --> 
    <zosConnectService id="zcs1" 
    	serviceName="recordOpsCreate" 
    	serviceRef="wolaOpsCreateService" 
    	dataXformRef="xformJSON2btye"/> 
  2. Cree el elemento zosConnectDataXform asociado.
    <!-- Proveedor de transformación de datos de z/OS Connect --> 
    <zosConnectDataXform id="xformJSON2Byte" 
    		bindFileLoc="/u/bindfiles" bindFileSuffix=".bnd" 
    		requestSchemaLoc="/u/json" responseSchemaLoc="/u/json"
    		requestSchemaSuffix=".json" responseSchemaSuffix=".json"/>  

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

  3. Opcional: configure un transformador de datos que se aplique a todos los servicios. Defina el elemento globaDataXformRef de zosConnectManager en el ID del transformador de datos configurado que se va a utilizar de forma global. Si se definen los transformadores de datos global y de servicio y llegan solicitudes para un servicio con un transformador de datos configurado, z/OS Connect utilizará el transformador de datos configurado específicamente para el servicio.
    <zosConnectManager id="zosConnectGlobals" globalDataXformRef="globalDataXform"/>   
    
    <!-- Proveedor de transformación de datos de z/OS Connect --> 
    <zosConnectDataXform id="globalDataXform" 
    		bindFileLoc="/u/bindfiles" bindFileSuffix=".bnd"         
    		requestSchemaLoc="/u/json" responseSchemaLoc="/u/json"
    		requestSchemaSuffix=".json" responseSchemaSuffix=".json"/>      
  4. Opcional: Configure valores como por ejemplo pollingRate y updateTrigger para ajustar las acciones de supervisión. De forma predeterminada se supervisan los directorios asociados con una definición de transformación de datos para ver si hay nuevos archivos y actualizaciones de archivos. Para obtener más información sobre estos atributos de configuración, consulte la sección del elemento zosConnectDataXform en zosConnect-1.0 y zosConnect 1.2.
      <zosConnectDataXform id="ibmDataXform2"        
    bindFileLoc="/zosConnect/banking/bind/" bindFileSuffix=".bnd"    
    requestSchemaLoc="/zosConnect/banking/reqSchema" requestSchemaSuffix=".json"    
    responseSchemaLoc="/zosConnect/banking/respSchema" responseSchemaSuffix=".json" pollingRate="500ms">    
    </zosConnectDataXform>

    En el ejemplo, se sondean los directorios /zosConnect/banking/bind,/zosConnect/banking/reqSchema y /zosConnect/banking/respSchema para ver si hay actualizaciones de archivo cada 500 milisegundos. Si los atributos de configuración pollingRate y updateTrigger no están configurados, se utilizarán, respectivamente, los atributos predeterminados de polled y 2 seconds. Si no necesita supervisión de archivos, puede inhabilitarla estableciendo el atributo updateTrigger en disabled. Si prefiere desencadenar una renovación manual de determinados archivos, establezca el atributo updateTrigger en mbean y utilice el mbean de notificación de archivos: com.ibm.ws.kernel.filemonitor.FileNotificationMBean para desencadenar las actualizaciones; por ejemplo:

    String[] MBEAN_METHOD_SIGNATURE = new String[] {Collection.class.getName(),Collection.class.getName(),Collection.class.getName() };        
    JMXConnector jmxConnector = ...;        
    MBeanServerConnection mbsc = jmxConnector.getMBeanServerConnection();        
    ObjectName fileMonitorMBeanName = new ObjectName("WebSphere:service=com.ibm.ws.kernel.filemonitor.FileNotificationMBean");        
    
    List<String> paths = new ArrayList<String>();        
    paths.add("/zosConnect/banking/bind/customer.bnd");        
    paths.add("/zosConnect/banking/reqSchema/customer_request.json");       
    paths.add("/zosConnect/banking/respSchema/customer_response.json");        
    
    Object[] params = new Object[] { null, paths, null };        
    mbsc.invoke(fileMonitorMBeanName, "notifyFileChanges", params, MBEAN_METHOD_SIGNATURE);

    El ejemplo utiliza la característica restConnector-1.0 para desencadenar la actualización de los archivos customer.bnd, customer_request.json y customer_response.json. Para obtener más información sobre cómo crear una conexión JMX segura, consulte la documentación de Configuración de una conexión JMX segura a Liberty


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_msg_payload_conv
Nombre de archivo:twlp_zconnect_msg_payload_conv.html