O Rational Developer for System z versão 8.0
introduz o suporte para a criação dos novos MPPs do provedor de serviço do IMS Enterprise Suite SOAP Gateway
descendente e de PL/I, a partir de arquivos WSDL fornecidos pelo usuário que usam o Processador de Lote das Ferramentas de Serviço
Corporativo. Vários aprimoramentos foram feitos para o componente Ferramentas de Serviço
Corporativo de RDz e IMS Connect
para ativar esse novo suporte.
Processador de Lote das Ferramentas do Serviço Corporativo Aprimorado.
O Processador de Lote foi aprimorado para suportar a geração de
artefatos PL/I descendentes do IMS ao
integrar as novas funções descritas no lembrete deste documento
no processo de geração combinado e passível de repetição.
WSDL2ELS (WSDL para Enterprise Language Structure)
Chamado pelo Processador de Lote das Ferramentas de Serviço Corporativo, o WSDL2ELS
gera os artefatos a seguir quando um determinado arquivo WSDL serve como entrada.
- As estruturas de linguagem PL/I são geradas para cada mensagem de entrada e saída
de cada operação em um Serviço e Porta WSDL fornecido pelo usuário.
Um modelo de programação que ajuda com matrizes esparsas, variáveis e desvinculadas
assim como os elementos opcionais são aplicados às estruturas de linguagem
geradas.
- Os arquivos da Sessão de Mapeamento são gerados para cada mensagem de entrada e saída
de cada operação em um Serviço e Porta WSDL especificados pelo usuário
para expressar mapeamentos entre as declarações de elemento e atributo XSD
e os membros da estrutura de linguagem PL/I. Nem todos os membros da estrutura de linguagem
gerados são mapeados para os elementos ou atributos XSD, alguns membros terão
relacionamentos entre si que são expressados com o uso de anotações.
- Os Metadados do WSDL2ELS são gerados para capturar os relacionamentos de alto nível
entre os artefatos gerados WSDL e WSDL2ELS fornecidos pelo usuário.
Esse arquivo está no formato XML e é consumido programaticamente pelo Processador de Lote
das Ferramentas do Serviço Corporativo para gerar Conversores XML, arquivos correlativos do IMS Enterprise SOAP Gateway e MPPs do provedor de serviço da Web do IMS
modelo.
- Um arquivo de log para ajudar na determinação de problema.
Programa de modelo MPP do provedor PL/I do IMS
para um determinado WSDL
Um MPP do provedor PL/I do IMS de modelo
é gerado com base nos metadados do WSDL2ELS. O programa de modelo
inclui estruturas de linguagem pelo WSDL2ELS e começa com
a lógica que obtém o contexto da chamada de serviço. Uma vez que o
contexto do serviço foi recuperado do cabeçalho do protocolo da mensagem,
o modelo se ramifica em um procedimento de manipulação de operação que corresponde
à operação chamada. Cada procedimento de manipulação de operação
demonstra o uso dos APIs fornecidos pelo RDz para recuperar e armazenar
as estruturas de linguagem na Fila de Mensagens do IMS
de acordo com um novo protocolo da mensagem.
Um novo protocolo de mensagem e API de segmentação (IRZPWSIO) que é
requerido pelos MPPs do provedor de serviço e pelos conversores XML desenvolvidos com o uso
do cenário descendente fornece vários aprimoramentos que não ficam disponíveis
para os MPPs ativados como provedores de serviço com o uso do cenário ascendente:
Consulte o IRZPWSH do membro de inclusão do PL/I no conjunto de dados FEK.SFEKSAMP para obter mais informações.
Conversores Descendentes de XML do PL/I do IMS Connect
com REFER e suporte de modelo de programação
O suporte descendente do RDz PL/I para IMS Enterprise
Suite SOAP Gateway pode ser descrito como aprimorado, automatizado e intermediário.
Para suportar as matrizes desvinculadas, o modelo de programação aplicado
às estruturas de linguagem gerados pelo WSDL2ELS e o protocolo de mensagem
e API de segmentação, os conversores de XML do PL/I gerados pelo Processador de Lote
das Ferramentas de Serviço Corporativo para o cenário descendente são significativamente
diferentes daqueles gerados para outros cenários e dependem dos aprimoramentos do IMS Connect que
serão entregues via APAR PM11648.
Nota: O membro de inclusão do PL/I FEK.SFEKSAMP(IRZPWSH)
e o módulo de carregamento do PL/I FEK.SFEKLOAD(IRZPWSIO) são requeridos para construir
conversores descendentes de XML do PL/I do IMS.
Os conversores de XML
gerados para o cenário descendente do PL/I do IMS
podem emitir as novas seguintes condições do Ambiente de Linguagem:
- O XML IRZ0500S para a conversão de estrutura de linguagem não pôde ser concluído
no procedimento PROCEDURE-NAME porque um código de retorno de RETURN-CODE foi
recebido do API IRZXSETS ao tentar armazenar a estrutura de linguagem
STRUCTURE-NAME no buffer de saída de mensagem do IMS
Connect.
- A Estrutura de Linguagem IRZ0501S para a conversão XML não pôde ser concluída
no procedimento PROCEDURE-NAME porque um código de retorno do RETURN-CODE foi
recebido do API IRZXGETS ao tentar recuperar a estrutura de linguagem
STRUCTURE-NAME do buffer de entrada de mensagem do IMS
Connect.
- A Estrutura de Linguagem IRZ0502S para a conversão de XML não pôde ser concluída
no procedimento PROCEDURE-NAME porque a variável do contador da matriz COUNTER-NAME
para a matriz ARRAY-NAME especificou um valor de COUNTER-VALUE que excede
o limite da matriz do ARRAY-LIMIT.
Arquivo Correlativo de múltiplas operações do IMS Enterprise Suite SOAP
Gateway
O Processador de Lote das Ferramentas de Serviço Corporativo gera um conversor
de XML exclusivo para cada operação no WSDL fornecido no cenário descendente do PL/I do IMS. Portanto,
o arquivo Correlativo do SOAP Gateway gerado pelo Processador de Lote
terá uma entrada para cada operação que especifica o respectivo
nome do conversor de XML.