Configurando Transformadores de Dados

O IBM® z/OS Connect EE fornece a capacidade de transformar opcionalmente cargas úteis de solicitação e de resposta que são usadas para chamar um ativo de negócios em sistemas operacionais z/OS. É possível criar transformadores de carga útil de mensagem para satisfazer as necessidades específicas pela implementação da SPI (Service Provider Interface) com.ibm.zosconnect.spi.DataXform que está incluída com o z/OS Connect EE.

Sobre Esta Tarefa

O z/OS Connect EE fornece uma implementação que requer que o formato da mensagem de solicitação e de resposta seja JSON. Este produto suporta a conversão da solicitação para uma matriz de bytes que pode ser mapeada por uma estrutura C, PL/I ou COBOL de idioma nativo. Essa estrutura de linguagem do programa de destino ou copy book inclui uma descrição dos parâmetros in e out. A estrutura de linguagem é usada por um utilitário fornecido para gerar um arquivo de ligação e arquivos de esquema de solicitação e resposta JSON. O arquivo de ligação que é gerado por esse utilitário é usado pelo z/OS Connect EE para concluir a conversão de dados para e a partir dos formatos de dados nativos e JSON, conforme as solicitações chegam e as respostas são retornadas. É possível recuperar os esquemas JSON para a mensagem de solicitação e resposta com uma chamada de API RESTful que é fornecida pelo z/OS Connect EE.

O z/OS Connect EE fornece o elemento de configuração zosConnectService que permite que o administrador configure um conjunto de atributos que se aplicam a um serviço específico. Um desses atributos é dataXformRef que aponta para uma configuração de transformação de dados que deve ser usada para um serviço específico. Esta tarefa descreve como o transformador de dados fornecido com o z/OS Connect EE é usado.

Nota:

Nos exemplos mostradas nas etapas 1 e 2, o serviceName e bindFileSuffix devem corresponder ao bindfile encontrado em bindFileLoc. Por exemplo: recordOpsCreate.wsbind reside em /u/bindfiles.
Os nomes dos arquivos de esquema de solicitação e resposta devem corresponder ao serviceName especificado no elemento zosConnectService com _request ou _response anexado. Os valores, incluindo o tipo de arquivo, devem corresponder ao requestSchemaSuffix ou responseSchemaSuffix respectivamente. Por exemplo: recordOpsCreate_request.json e recordOpsCreate_response.json. Esses arquivos devem residir em /u/json.

Procedimento

Atualize o elemento zosConnectService para cada serviço em sua configuraçãoserver.xml para a qual você deseja ativar a transformação de dados fornecida pelo z/OS Connect EE.

<!-- z/OS Connect service definition --> 
<zosconnect_zosConnectService id="zcs1" 
	serviceName="recordOpsCreate" 
	serviceRef="wolaOpsCreateService" 
	dataXformRef="xformJSON2byte"/>

Crie o elemento associado zosConnectDataXform.

<!-- z/OS Connect data transformation provider --> 
<zosconnect_zosConnectDataXform id="xformJSON2byte" 
		bindFileLoc="/u/bindfiles" bindFileSuffix=".wsbind" 
		requestSchemaLoc="/u/json" responseSchemaLoc="/u/json"
		requestSchemaSuffix=".json" responseSchemaSuffix=".json"/>

Opcional: configure um transformador de dados que se aplica a todos os serviços.
Configure o globaDataXformRef do elemento zosConnectManager para o ID do transformador de dados configurado que é destinado para uso global. Se ambos os transformadores de dados global e de serviço estiverem definidos e as solicitações são recebidas para um serviço com um transformador de dados configurado, o z/OS Connect EE usará o transformador de dados configurado especificamente para o serviço.
```
<zosconnect_zosConnectManager globalDataXformRef="globalDataXform"/>   

 
<zosconnect_zosConnectDataXform id="globalDataXform" 
		bindFileLoc="/u/bindfiles" bindFileSuffix=".wsbind"         
		requestSchemaLoc="/u/json" responseSchemaLoc="/u/json"
		requestSchemaSuffix=".json" responseSchemaSuffix=".json"/>      
```