Conversion for IBM z/OS Connect zosConnect-2.0 data transformation

Note: If you are generating a WSBind file and JSON schemas to use the z/OS Connect data transformation feature, you must use the naming convention that is required by the zosConnectDataXform element in the server.xml file. The names of the request and response schemas must be of the format that is shown in the following example. The suffixes _request and _response are mandatory. The following example uses this naming convention:

    SERVICE-ARCHIVE={servicearchive_dir}/{servicearchive}
    SERVICE-NAME={serviceName}        
    WSBIND={wsbind_dir}/{serviceName}.wsbind
    JSON-SCHEMA-REQUEST={json_schema_dir}/{serviceName}_request.json
    JSON-SCHEMA-RESPONSE={json_schema_dir}/{serviceName}_response.json

where

• {serviceName} must match the value that is specified on the serviceName attribute of the associated zosConnectService element when you configure server.xml file to use the DataXform.
• {servicearchive_dir>} is the UNIX System Services directory in which the service archive file is created
• {wsbind_dir} is the UNIX System Services directory in which the wsbind file is created.
• {json_schema_dir} is the UNIX System Services directory in which the JSON request and response schemas are created.

For example:

        <zosconnect_zosConnectService id="inquireCatalogService"
               serviceName="<serviceName>"
               serviceRef="wolaCatalogManager"
               dataXformRef="xformJSON2Byte" />        
        <!-- z/OS Connect data transformation provider -->
        <zosconnect_zosConnectDataXform id="xformJSON2Byte"
               bindFileLoc="<wsbind_dir>" 
               bindFileSuffix=".wsbind"
               requestSchemaLoc="<json_schema_dir>"
               responseSchemaLoc="<json_schema_dir>"
               requestSchemaSuffix=".json"  
               responseSchemaSuffix=".json">
        </zosconnect_zosConnectDataXform>

Note:

1. If you use the WSBind file to call CICS via an API, JSON-SCHEMA-REQUEST and JSON-SCHEMA-RESPONSE must use schemas that specify only a single property at the top level of the JSON format described.
2. If you are generating a WSBind file and JSON schemas for use in a z/OS Connect DataXform, you must use a naming convention that is expected by the zosConnectDataXform element in the server.xml file. Specify the following values for the BAQJS2LS parameters:

   
   SERVICE-NAME={serviceName}
   WSBIND={wsbind_dir}/{serviceName}.wsbind
   JSON-SCHEMA-REQUEST={json_schema_dir}/{serviceName}_request.json
   JSON-SCHEMA-RESPONSE={json_schema_dir}/{serviceName}_response.json
   

   where
   • {serviceName} must match the value that is specified on the serviceName attribute of the associated zosConnectService element when you configure server.xml file to use the DataXform
   • {wsbind_dir} is the UNIX System Services directory in which the wsbind file is created.
   • {json_schema_dir} is the UNIX System Service directory in which the JSON request and response schemas are stored.