# Notas sobre o Release, Problemas, Limitações e Soluções Alternativas Conhecidos que Afetam os Projetos de Serviço Único

## Suporte a Mensagens com Diversos Segmentos nos Projetos de Serviço Único do IMS SOAP Gateway

Os projetos de serviço único do Enterprise Service Tools IMSTM SOAP Gateway incluem suporte para message passing programs (MPPs) com diversos segmentos. Você poderá implementar os artefatos gerados no Rational Developer para System z Versão 7.5 quando todos os pré-requisitos a seguir estiverem disponíveis de forma geral:

- IMS SOAP Gateway V10.2
- IMS V10R1 IMS Connect
- PTF for IMS V10R1 IMS Connect APAR PK69366
- PTFs para o Enterprise COBOL para z/OSR APAR PK65058

## A Conversão de XML Compilado em COBOL do IBM Rational Developer para System z Aprimorou a Verificação de Erros que Pode Emitir Números de Mensagens Atualizados de IGZ0280S a IGZ0298S e Novos Números de Mensagens de IGZ0299S a IGZ0303S

Problema: A Conversão de XML Compilado em Enterprise Service Tools do IBM Rational Developer para System z para tempos de execução do CICS, do IMS e em Lote nos cenários ascendentes e intermediários pode ser encerrada com um código de retorno de 280 a 303. A mensagem retornada do Ambiente de Linguagem pelo conversor está desatualizada ou o texto "Falha em Obter Mensagem de Exceção" é exibido no log do sistema ou no console

Solução: A Conversão de XML Compilado em COBOL do Rational Developer para System z aprimorou a verificação de erro que pode emitir números de mensagens atualizados IGZ0280S a IGZ0298S e novos números de mensagens IGZ0299S a IGZ0303S. Aplique o PTF para o APAR PK65058.

## Suporte Adicional para Mapeamento em Cenários de Serviços da Web para CICS

Os cenários de Serviços da Web para CICS têm suporte para um nível de mapeamento e nível de tempo de execução adicional (2.2). Para usar os artefatos gerados nesse nível, você precisa do CICS TS 3.2 com APAR PK69738 aplicado.

## Informações sobre a Derivação de Tipo PL/I para XML

No tópico "Tipos de XML Derivados de PL/I" na Tabela 6, o tipo PL/I para XML está em erro e deve ser ignorado.

## Copybook Faz com que o Assistente do Enterprise Service Tools Seja Interrompido

Problema: O assistente do Enterprise Service Tools é interrompido quando os copybooks necessários não são resolvidos. Isso ocorre quando o Idioma das mensagens de erro na página de preferências do importador de COBOL está configurado para algo diferente de en_US.

Solução: Altere o Idioma das mensagens de erro selecionando: Janela > Preferências > Importador > COBOL > Mais opções de COBOL.

## Arquivos de Origem de Importação Intermediários

Problema: No cenário de desenvolvimento intermediário, no assistente Importar arquivos de origem, importação com a opção Sistema de Arquivos não é suportada.

Solução alternativa: Copie todos os arquivos necessários para um projeto geral e, em seguida, importe-os selecionando Área de Trabalho no assistente Importar arquivos de origem.

## Conflito Crescente com Arquivos Antigos WSDL/XSD e Arquivos WSDL e Arquivos XSD Novos

Problema: No cenário de desenvolvimento ascendente, usar uma versão mais antiga de arquivos WSDL e arquivos XSD gerados com novos conversores gerados pode causar erros no tempo de execução. Por exemplo, a mensagem de erro do tempo de execução a seguir pode ocorrer:

    IGZ0282S Conversão de
    XML para a estrutura de dados não pôde ser concluída no programa PGMNAME, pois nenhum nome de elemento no
    documento XML foi reconhecido pelo conversor.

Solução: WSDL/XSDs gerados com um conversor devem sempre ser acoplados aos conversores.

## Mapeamento do Tipo de Dados do Esquema XML para o Tipo COBOL COMP-3 (DECIMAL COMPACTADO)

Problema: No tópico da ajuda on-line "Tipos XML Derivados do COBOL", a linha para COMP-3 (DECIMAL COMPACTADO) deve ser a seguinte:

Tabela 1. Derivação de Tipo COBOL para XML
Tipo COBOL | Propriedades COBOL UsageValue + COBOL ModelType | Tipo XSD Correspondente
--- | --- | ---
packed-decimal, comp-3 -> packedDecimal | packedDecimal | Se o ponto decimal for especificado:
    <xsd:simpleType>
    <xsd:restriction base="xsd:decimal">
       <xsd:minInclusive value="xx.x"/>
       <xsd:maxInclusive value="yy.y"/>
    </xsd:restriction>
    </xsd:simpleType>
Se o ponto decimal não for especificado:
    <xsd:simpleType>
       <xsd:restriction base="xsd:short">
         <xsd:minInclusive value="xxx"/>
         <xsd:maxInclusive value="yyy"/>
       </xsd:restriction>
    </xsd:simpleType>

## Os Cenários Descendente e Intermediário com Importação de Arquivo WSDL Remoto (z/OS Unix) que Inclui, Importa ou Redefine um Esquema Não São Suportados

Problema: Em um projeto do Enterprise Service Tools, se você estiver executando um cenário Criar Nova Implementação de Serviço (descendente) ou Mapear para uma Interface de Serviço Existente (intermediário), com o arquivo WSDL (que foi importado originalmente de um local remoto) que inclui, importa ou redefine um esquema, isso falharia com um erro.

Solução alternativa: Copie todos os arquivos necessários para a estação de trabalho ou para um projeto geral na área de trabalho e importe o arquivo WSDL local para o "Projeto de Serviços da Web para CICS" usando RMB -> Importar -> Arquivos de origem e tente o cenário descendente.

## Rotinas de Conversão de COBOL Geradas por Assistente de Serviço Único Executados Somente no z/OS

Apesar de o compilador de COBOL da estação de trabalho suportar instruções XML PARSE no tempo de compilação e no tempo de execução, os programas COBOL gerados pelos assistentes de servidor único são projetados para execução somente no ambiente do z/OS

## Profundidade de Aninhamento do Elemento XML

Problema: O conversor de XML para a estrutura de linguagem retorna a seguinte mensagem de exceção:

    IGZ0291S A conversão da estrutura XML em dados não pôde ser concluída no programa nome do programa, porque foi excedido o máximo de profundidade de
    aninhamento do elemento XML. O erro ocorreu no elemento nome de elemento com o conteúdo de caractere conteúdo do caractere.

Solução alternativa: O conversor de XML para a estrutura de linguagem não pôde manipular a profundidade do aninhamento de um elemento XML específico. Apesar de existir uma concessão para níveis de aninhamento além da estrutura original do COBOL, ela pode ser excedida. Se existir um elemento em um documento XML de pedido que não esteja no esquema, o elemento causará essa condição se seu nível de aninhamento for muito profundo.

## Itens FILLER nas Estruturas de Dados COBOL

Problema: Grupos sem nomes e seus itens básicos não estão disponíveis para seleção na página de seleção da estrutura de dados ou no editor da sessão de mapeamento porque o item-pai foi filtrado para fora com seus itens básicos.

Solução alternativa: Edite a estrutura de dados COBOL e forneça nomes aos grupos e/ou itens de dados elementares que requerem conversão. Dar um nome ao grupo COBOL disponibiliza seus itens básicos não preenchidos para seleção.

## Conflito de Opções do Compilador OPT

Problema: A opção do compilador OPT na instrução PROCESS gerada no driver e nos programas conversores entrará em conflito com a opção TEST se você especificá-la como a opção de compilação em seu JCL.

Solução alternativa: Se você quiser depurar os programas conversores de XML gerado, cancele a seleção da caixa de opção "Otimização" no grupo "Especificar preferências relacionadas ao compilador" na página "Opções de geração" no assistente Serviço da Web.

## Mapeamento de Correspondência Automática de Grupos COBOL que Contêm Itens OCCURS DEPENDING ON

Problema: Se um item de dados COBOL for ou contiver um item ODO, você não poderá executar uma ação "Match Mapping" com uma estrutura XML compatível, a menos que mapeie manualmente o objeto ODO antes de tentar a ação Match Mapping.

Solução alternativa: Antes de tentar a ação Corresponder mapeamento, mapeie manualmente o objeto ODO de acordo com as regras de mapeamento. (no documento XML, o elemento mapeado para o item de objeto ODO do COBOL deve aparecer antes do elemento XML que é mapeado ao assunto ODO correspondente do COBOL).

## Sensibilidade de Maiúsculas e Minúsculas de Determinados Campos de Entrada de Texto nos Assistentes de Ativação XML

Problema: As entradas de nomes de pasta e de arquivo fazem distinção de maiúsculas e minúsculas no Eclipse no Windows.

Solução alternativa: Certifique-se de que você insira os nomes de pastas e arquivos de forma consistente. Por exemplo, se seu nome de pasta mostrar MyFolder no Workbench, você deve digitar MyFolder em um campo de entrada que pede um nome de pasta. Se você inserir myfolder, por exemplo, as ferramentas podem sinalizar isso como um nome de pasta inválido ou não-existente.

## Ponteiros Inválidos Causam Loops Infinitos

Problema: Fornecer ponteiros inválidos não nulos para conversores ou drivers XML causa um loop infinito.

Solução alternativa: Os conversores de XML tentam detectar e relatar ponteiros nulos transmitidos pelo responsável pela chamada. Para ponteiros inválidos não nulos, os Conversores XML provavelmente irão encontrar e retornar uma exceção de proteção (SOC4).

## Suporte para Membros de Dados DBCS com SOAP para CICS e Serviços da Web para CICS

O suporte para itens de dados DBCS nos projetos de serviço único do Enterprise Service Tools exige que os documentos XML de pedido e de resposta sejam codificados em UTF-16 ou UTF-8. Se o tempo de execução de destino do serviço da Web for SOAP para CICS, configure o recurso para trocar XML em UTF-8 ou UTF-16 com o Driver do Conversor de XML. O tempo de execução dos Serviços da Web para CICS trocarão XML em UTF-8 com um cliente por padrão, enquanto que o Driver do Conversor de XML troca XML com o CICS em UTF-16; quando UNICODE é necessário, UTF-16 é a opção mais eficiente atualmente para os Conversores XML. Para qualquer um dos dois tempos de execução, pode ser necessário configurar suporte do z/OS para UNICODE com uma imagem de conversão que suporte conversão entre UNICODE e a página de códigos do host DBCS.

## O Item de Menu Gerar > Arquivo XML Não Honra Restrições de Esquema XSD

Problema: O item de menu Gerar -> Arquivo XML não honra restrições em um esquema XSD. O uso da ação Gerar Arquivo XML em um XSD criado pelo Enterprise Service Tools pode levar à geração de arquivos XML inválidos.

Solução alternativa: Edite o arquivo XML gerado de forma que o conteúdo da tag esteja de acordo com as restrições especificadas no esquema XSD.

## Processador de Batch XML e de Serviços da Web: Entradas Inválidas no XML de Configuração Podem Causar Exceções de Ponteiro Nulo Durante o Processo de Batch

Problema: Entradas inválidas nos arquivos XML opcionais (Container.xml, PlatformProperties.xml, ServicesSpecification.xml) podem causar exceções de ponteiro nulo durante a execução do processador de batch.

Solução alternativa: Siga o formato para especificar entradas corretamente nos arquivos XML de opções.

## Processador de Batch XML e de Serviços da Web: Especificando o Diretório para o Local do Arquivo de Idiomas de Entrada

O local dos arquivos de entrada COBOL pode ser especificado no atributo importDirectory como um caminho absoluto, começando pela especificação da unidade (por exemplo, C:\mypath\test).

Se, em vez disso, um caminho relativo for desejado (por exemplo, para que os arquivos de configuração e o código fonte Cobol possam ser relocalizados sem a alteração de quaisquer locais de arquivos nos arquivos de configuração xsebatch), tente fazer o seguinte:

Tabela 2.
Diretório: | Descrição:
--- | ---
`C:\workspace\account_details` | Projeto principal
`C:\workspace\account_details\cobol_src` | Subdiretório com arquivos de origem COBOL a importar
`C:\workspace\account_details\xsebatch_config` | Subdiretório com arquivos de configuração XML para xsebatch

Em seguida, você poderia utilizar o elemento InputOutputMessage a seguir para um arquivo de origem COBOL chamado DFH0ACTD.cbl no diretório cobol_src:

    <InputOutputMessage importFile="../cobol_src/DFH0ACTD.cbl"></InputOutputMessage>

Alternativamente, é possível colocar os arquivos de origem COBOL no mesmo diretório, a partir do qual xsebatch é chamado

## Processador de Batch XML e de Serviços da Web: Especificando Nomes de Dados em Letras Maiúsculas e Minúsculas

Mesmo que os nomes de dados COBOL não façam distinção entre maiúsculas e minúsculas, é preciso especificar maiúsculas e minúsculas exatas nos arquivos xml de especificação. Por exemplo, se na origem de dados COBOL, o nome dos dados for chamado MY-Data, na especificação xml Service o atributo nativeTypeName deverá ser definido como nativeTypeName="MY-Data". Se você não especificar maiúsculas e minúsculas exatas, o nome dos dados não será localizado e o primeiro nome de dados de nível 01 disponível será utilizado por padrão.

## Restrição de Constantes Figurativas LOW-VALUES e HIGH-VALUES

Constantes figurativas LOW-VALUE(S) e HIGH-VALUE(S) podem ser apresentadas em estruturas de dados COBOL utilizadas nos assistentes de serviço único, mas seus significados semânticos são ignorados pelos assistentes de serviço único e não são carregados nos artefatos gerados por estes assistentes de serviço único do Enterprise Service Tools

## Caracteres GB18030 no Nome de um Projeto de Serviço Único do Enterprise Service Tools

Problema: Utilizar caracteres da página de códigos GB18030 no nome de um projeto de serviço único do Enterprise Service Tools provoca erros ao executar um assistente de serviço único do Enterprise Service Tools em arquivos no projeto.

Solução alternativa: não use caracteres GB18030 ao denominar um projeto de serviço único do Enterprise Service Tools.

## Arquivos Temporários Nem Sempre Limpos

Problema: Após executar um assistente de serviço único do Enterprise Service Tools, você pode, às vezes, observar que arquivos temporários (por exemplo, ~DF45B.tmp) são deixados na pasta do projeto de serviço único do Enterprise Service Tools.

Solução alternativa: Se você vir arquivos denominados de forma semelhante em seu projeto de serviço único do Enterprise Service Tools após executar um assistente de serviço único do Enterprise Service Tools, é possível excluir tais arquivos com segurança

## Projeto Temporário Nem Sempre Limpo

Problema: O processo de migração para os arquivos de mapeamento antigos requer que os arquivos de origem referidos mapeados estejam na mesma pasta que o arquivo de mapeamento. Se esse requisito não for atendido, a ferramenta de migração de mapeamento falhará com a seguinte mensagem de erro: "O recurso [nome do arquivo].mapping não é local".

Solução alternativa: Se você vir projetos denominados de forma semelhante em seu espaço de trabalho após executar um assistente de serviço único do Enterprise Service Tools, poderá excluir esses projetos de forma segura.

## Ao Migrar Arquivos de Mapeamento Versão 6.0 (Arquivos .cmx), os Arquivos de Origem Referenciados pelo Arquivo .cmx Devem Estar na Mesma Pasta

Problema: O processo de migração para os arquivos de mapeamento antigos requer que os arquivos de origem referidos mapeados estejam na mesma pasta que o arquivo de mapeamento. Se esse requisito não for atendido, a ferramenta de migração de mapeamento falhará com a seguinte mensagem de erro: "O recurso [nome do arquivo].mapping não é local".

Solução alternativa: Mova os arquivos de origem referidos para a mesma pasta que o arquivo de mapeamento que está sendo migrado.

## A Navegação para Local Remoto no Assistente de Serviço da Web Causa Travamento do Ambiente de Trabalho

Problema: A navegação para um local remoto para uma pasta de destino (pasta Conversor, pasta WSDL ou WSBIND) nas páginas do assistente de serviço da Web pode demorar muito ou travar o workbench quando o nome da conexão for longo (como ctfmvs08.rtp.raleigh.ibm.com)

Solução alternativa: Renomeie o nome da conexão para algo mais curto, como ctfmvs08.

## Nomes de Elementos Globais nos Esquemas XML Gerados Não São Consistentes entre Tipos de Conversão XML Interpretativa e Compilada

Problema: Os nomes de elemento raiz de mensagem de serviço da Web nos esquemas XML gerados pela geração padrão da conversão XML Compilada e Interpretativa não correspondem. Você pode precisar alterar o padrão de geração da conversão de XML Compilada para que corresponda com o caso de conversão Interpretativa, conforme descrito a seguir na seção Solução Alternativa. Isso permitirá que você altere o tipo de conversão de interpretativa para compilada se necessário posteriormente sem precisar publicar novamente o arquivo WSDL e sem alterar o código em clientes do serviço da Web.

Solução alternativa: Ao gerar os artefatos para conversão de XML Compilada, é possível usar o assistente para alterar o nome do elemento raiz para corresponder a conversão XML Interpretativa. Essa nova opção chamada "Nome do elemento raiz" está localizada na página Opções de Geração, na guia Opções WSDL e XSD no grupo de propriedades do Esquema XML de pedido e resposta.

Por exemplo, o grupo COBOL denominado A-B-C fará com que os artefatos de conversão Interpretativa tenham o nome de elemento raiz de mensagem "a_b_c". Os artefatos de conversão Compilada padrão terão o nome de elemento raiz "ABC". Conforme descrito anteriormente, você pode alterar "ABC" no assistente para "a_b_c" para correspondência com o WSDL gerado para a conversão interpretativa.

## Caracteres DBCS Não São Permitidos no Nome de Arquivos Gerados pelo Conversor de XML

Problema: Caracteres DBCS não são permitidos nos nomes de membros do Conjunto de Dados Particionados no z/OS.

Solução alternativa: Omita os caracteres DBCS ao especificar o nome dos arquivos do conversor de XML. Além disso, verifique se os nomes de arquivo padrão sugeridos pelo Assistente não contêm caracteres DBCS.

Tópico pai: Enterprise Service Tools - Notas sobre o Release