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.
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.
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.
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:
.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.
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.
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> |
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.
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
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.
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.
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.
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).
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.
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).
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.
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.
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.
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).
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 |
<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
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.
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
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.
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
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.
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.
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.
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.
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.