IBM J2EE Connector Tools Feature Versão 6.0.1 - Notas sobre o Release

Para o IBM Rational Application Developer Versão 6.0.0.1 ou 6.0.1

Para visualizar a versão mais recente desse arquivo, consulte as notas sobre o release no endereço www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/601/J2C/html/nl/readme_pt_BR_601.html

Conteúdo

1.0 Sobre Este Release
   1.1 O Que Há de Novo Neste Release
   1.2 Histórico de Correção do Produto
2.0 Informações de Instalação
   2.1 Requisitos de Hardware
   2.2 Requisitos de Software
   2.2.1 WebSphere^® Application Server
   2.2.2 Adaptadores de Recursos
3.0 Limitações, Problemas e Soluções Alternativas
   3.1 Limitações
   3.1.1 Exceção de Tempo de Implementação
   3.1.2 Vários Adaptadores de Recursos Instalados no Mesmo Servidor de Tempo de Execução
   3.2 Problemas e Soluções Alternativas
   3.2.1 Alterações de ConnectionSpec não Podem Ser Feitas por meio de Assistentes J2C
   3.2.2 Não é possível importar o arquivo COBOL que contém DBCS
   3.2.3 Dificuldade de inserir valores em algumas propriedades IMSInteractionSpec no assistente Novo J2C JavaBean
4.0 Suporte ao Cliente
5.0 Avisos e Marcas Registradas

1.0 Sobre este release

As ferramentas do J2EE Connector (J2C) Architecture permitem criar aplicativos J2EE que integram e estendem operações e dados em seus EIS (Enterprise Information Systems) existentes.

As ferramentas do J2C consistem nos seguintes componentes principais:

1.1 O Que Há de Novo Neste Release

Esse release inclui as seguintes atualizações e recursos:

• O assistente de criação de bean de comando permite o encapsulamento da execução de uma operação específica dentro do EIS.
• O assistente de migração J2C permite migrar os arquivos WSDL criados no WebSphere Application Developer Integration Edition para um projeto Rational Application Developer atual.
• A ferramenta de migração da linha de comandos J2C permite que você migre os arquivos WSDL criados no WebSphere Application Developer Integration Edition para o Rational Application Developer utilizando a linha de comandos.
• O IMS Connector para Java Versão 9.1.0.2 é atualizado para a 9.1.0.2.1
• O IMS Connector para Java Versão 9.1.0.1.1 é atualizado para a 9.1.0.1.2
• O CICS ECI versão 6.0.0 é atualizado para a 6.0.1
• As seguintes amostras foram atualizadas com o novo IMS 9.1.0.1.2 RAR:
  • IMS PhoneBook
  • Saída de vários segmentos
  • Matrizes de entrada e saída
• A mesma amostra de entrada e saída foi atualizada com o novo CICSECI 6.0.1 RAR.
• A nova amostra chamada Bean de comando J2C foi incluída em Samples Gallery.

1.2 Histórico de Correção do Produto

As seguintes correções são incluídas nessa liberação do Recurso de Ferramentas do Rational Application Developer J2EE Connector:

• (PK05710) O Java bean J2C gerado não manipula a exceção corretamente.
• (PK05919) Não é possível utilizar o caractere "/" nos nomes de referência de recursos.
• (PK04996) Exceção de ponteiro nulo ao selecionar a geração de código de estilo "nomes abreviados".
• (PK07730) O IMSRequestType no tempo de execução é zero e não o valor padrão 1. O código gerado definirá IMSRequestType para 1 que é o valor padrão.
• Fornece suporte para o método de execução com três parâmetros (IMSInteractionSpec, Input Record, Output Record) para interações  SYNC_SEND.
• Emite uma exceção contendo a mensagem ICO0007E quando a propriedade reRoute  é definida para  TRUE em uma conexão de soquete dedicado e persistente.
• Garante que uma mensagem "DFS" do IMS é internamente reconhecida pelo IMS Connector para Java para que as interações subseqüentes, seguindo a mensagem "DFS", não receberá um java.lang.IllegalArgumentException contendo a mensagem ICO0026E. 
• Reconfigura o valor do ID do cliente interno utilizado pelo IMS Connector para Java seguindo a exceção que contém a mensagem ICO0085E.  A exceção contendo a mensagem ICO0085E é emitida quando um aplicativo fornece um ID de cliente específico do usuário para uma interação em uma conexão de soquete compartilhável e persistente.  Antes dessa atualização, o valor do ID de cliente persistia até que o aplicativo fosse reiniciado.  
• Garante que a conexão de soquete permaneça aberta após a detecção de um valor inválido para o campo LL da mensagem de entrada.
• Corrige uma exceção de ponteiro nulo no rastreio.
• Emite uma exceção contendo a mensagem ICO0056E quando um valor é especificado para a propriedade IMSConnectName, mas o IMS Connector para Java não está em execução na plataforma 390. Se um valor for especificado para a propriedade IMSConnectName e o IMS Connector para Java estiver em execução em um ambiente OS/390^® ou z/OS^®, o IMS Connector para Java tentará criar uma conexão de Opção Local. Se o IMS Connector para Java não estiver em execução em um ambiente OS/390 ou z/OS, a exceção ICO0056E será registrada pelo servidor de aplicativo, mas a interação não continuará e o IMS Connector para Java tentará criar uma conexão TCP/IP utilizando os valores de nome de host e porta padrão.
• Emite uma exceção seguindo uma tentativa para listar uma conexão inelegível na transação atual.
• Atualiza a exceção contendo a mensagem ICO0078E com mais informações precisas.
• A propriedade reRoute do IMS Connector para Java não é mais ignorada para as interações nas conexões de soquete dedicadas e persistentes.  Com essa atualização, será emitida uma mensagem de exceção.
• (PK05920) A opção Configure Resource Adapter Deployment (Configurar Implementação do Adaptador de Recursos) não existe na página de informações de implementação da página da Web J2C, do Serviço da Web ou do EJB a partir do assistente Java Bean J2C.

2.0 Informações de Instalação

Para obter informações sobre a instalação do recurso J2C do Rational Application Developer, consulte www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/601/install_instruction/ifeature_j2c/nl/install_pt_BR_601.html

2.1 Requisitos de Hardware

Consulte as instruções de instalação para obter os requisitos de hardware para instalação do Rational Application Developer J2C Feature.

2.2 Requisitos de Software

Se você desenvolver um aplicativo utilizando as ferramentas do J2C no Rational Application Developer e executá-lo no WebSphere Application Server Versão 5, certifique-se de ter a manutenção requerida aplicada ao WebSphere Application Server Versão 5. Consulte a Seção 2.2.1 WebSphere Application Server para obter detalhes.

Consulte as instruções de instalação para obter detalhes adicionais sobre o software e as especificações suportadas pelo Rational Application Developer J2C Feature.

Para obter detalhes sobre o software e as especificações suportadas por uma ferramenta específica no Rational Application Developer, consulte a ajuda on-line.

O IBM^® Rational Application Developer Versão 6.0.0.1 deve ser instalado antes desse recurso.

2.2.1 WebSphere Application Server

O WebSphere V5.0 e o WebSphere V5.1 suportam o J2C 1.0. Os níveis de serviço do WebSphere Application Server requeridos para utilizar o J2EE Connector Tools estão listados na tabela a seguir. Os ambientes de teste de nível anterior disponíveis com o Rational Application Developer V6.0 exigem o serviço listado na coluna WAS Distributed Service Level Required (Nível de Serviço Distribuído do WAS Exigido) na tabela. As correções acumulativas do WebSphere Application Server, por exemplo WAS 5.0.2.8, estão disponíveis a partir do site de suporte do WebSphere Application Server (www.ibm.com/software/webservers/appserv/was/support). As Correções do Integration Edition RunTime para 5.0 e 5.1, estão disponíveis a partir de www.ibm.com/support/docview.wss?rs=180&context=SSEQTP&dc=D410&dc=D420&uid=swg24004796&loc=en_US&cs=utf-8&lang=en. Os PTFs do WebSphere Application Server para z/OS estão disponíveis no site de suporte do WebSphere Application Server para z/OS www.ibm.com/software/webservers/appserv/zos_os390/support/

O WebSphere V6 suporta aplicativos J2C 1.5.

2.2.2 Adaptadores de Recursos

Os seguintes adaptadores de recursos são suportados nas ferramentas J2C:

• CICS ECI 5.1 (J2C 1.0)
• CICS ECI 6.0.0, 6.0.1 (J2C 1.5) - apenas Saída
• IMS 9.1.0.1.1, 9.1.0.1.2 (J2C 1.0)
• IMS 9.1.0.2, 9.1.0.2.1 (J2C 1.5) - apenas Saída

3.0 Limitações, Problemas e Soluções Alternativas Conhecidos

Estas notas sobre o release incluem informações específicas da liberação, como problemas e limitações que não foram disponibilizadas até a conclusão desta documentação do produto.

3.1 Limitações

3.1.1 Exceção de Tempo de Implementação

Durante a criação de páginas da Web, os EJBs ou os Serviços da Web, você pode notar uma exceção no console de servidor WebSphere Application Server V6. Isso não afeta a operação normal do servidor ou do bean J2C. Esse problema foi corrigido no WebSphere Application Server versão 6.0.1 disponível em www.ibm.com/software/webservers/appserv/was/support/

[2/21/05 18:55:49:781 EST] 00000017 SystemErr R java.lang.reflect.InvocationTargetException at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:85) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:58) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java(Compiled Code)) at java.lang.reflect.Method.invoke(Method.java(Compiled Code)) at com.ibm.ws.ffdc.DiagnosticModule.getDataForDirective(DiagnosticModule.java:316) at com.ibm.ws.ffdc.DiagnosticModule.getDataForDirectives(DiagnosticModule.java:287) at com.ibm.ws.ffdc.DiagnosticModule.dumpComponentData(DiagnosticModule.java:143) at com.ibm.ws.ffdc.DiagnosticEngine.processIncident(DiagnosticEngine.java:159) at com.ibm.ws.ffdc.FFDCFilter.filterEngine(FFDCFilter.java:434) at com.ibm.ws.ffdc.FFDCFilter.processException(FFDCFilter.java:195) at com.ibm.ws.management.AdminServiceImpl.outputWarningAndFFDC(AdminServiceImpl.java:1660) at com.ibm.ws.management.AdminServiceImpl.checkForOpDeprecation(AdminServiceImpl.java:1737) at com.ibm.ws.management.AdminServiceImpl.preInvoke(AdminServiceImpl.java:1670) at com.ibm.ws.management.AdminServiceImpl.access$400(AdminServiceImpl.java:100) at com.ibm.ws.management.AdminServiceImpl$1.run(AdminServiceImpl.java:899) at com.ibm.ws.security.util.AccessController.doPrivileged(AccessController.java(Compiled Code)) at com.ibm.ws.management.AdminServiceImpl.invoke(AdminServiceImpl.java:817) at com.ibm.ws.management.connector.AdminServiceDelegator.invoke(AdminServiceDelegator.java:139) at sun.reflect.GeneratedMethodAccessor23.invoke(Unknown Source) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java(Compiled Code)) at java.lang.reflect.Method.invoke(Method.java(Compiled Code)) at com.ibm.ws.management.connector.soap.SOAPConnector.invoke(SOAPConnector.java:325) at com.ibm.ws.management.connector.soap.SOAPConnector.service(SOAPConnector.java:193) at com.ibm.ws.management.connector.soap.SOAPConnection.handleRequest(SOAPConnection.java:55) at com.ibm.ws.http.HttpConnection.readAndHandleRequest(HttpConnection.java:641) at com.ibm.ws.http.HttpConnection.run(HttpConnection.java:469) at com.ibm.ws.util.ThreadPool$Worker.run(ThreadPool.java(Compiled Code)) Caused by: java.lang.NullPointerException at com.ibm.ws.management.dm.JmxDM.processAdminService(JmxDM.java:50) at com.ibm.ws.management.dm.JmxDM.ffdcDumpDefaultJmx(JmxDM.java:34) ... 28 more

3.1.2 Vários Adaptadores de Recursos Instalados no Mesmo Servidor de Tempo de Execução

Várias versões independentes do mesmo adaptador de recurso EIS não devem ser instaladas no WebSphere Application Server, especialmente se forem do mesmo tipo de EIS. Por exemplo, se você instalar um CICS ECI 5.1 e CICS ECI 6.0, poderá haver um conflito. Isso ocorre porque todos os adaptadores de recursos compartilham o mesmo carregador de classes.

3.2 Problemas e Soluções Alternativas

3.2.1 Alterações de ConnectionSpec não Podem Ser Feitas por meio de Assistentes J2C

O assistente J2C não fornece nenhum suporte para a interface com o usuário para que os usuários façam alterações no ConnectionSpec. Você deve alterá-lo diretamente no código Java de implementação gerado. Abra o arquivo Java de implementação gerado em um editor, navegue para o método que deve ser modificado e, em seguida, altere, inclua ou remova os doclets daquele método.

3.2.2 Não é possível importar o arquivo COBOL que contém DBCS

Se você importar um arquivo COBOL que inclui caracteres NL, terá que alterar o Nome do Código de Idioma do Tempo de compilação em Window (Janela) > Preferences (Preferências) > Importer (Importador) > COBOL > More COBOL Option (Mais Opções do COBOL). Você obterá um erro para o en_US padrão.

3.2.3 Dificuldade de inserir valores em algumas propriedades IMSInteractionSpec no assistente Novo J2C JavaBean

No assistente Novo J2C JavaBean, se você selecionar com.ibm.connector2.ims.ico.IMSInteractionSpec, haverá problemas ao inserir valores nos campo de entrada avançada Reroute name (Nome de Reroute), LTERM name (Nome de LTERM) e Map name (Nome do Mapa). Como esses arquivos são preenchidos com espaços em branco, você deve eliminar esses espaços antes de inserir os valores. Caso contrário, você receberá uma indicação de erro e não poderá continuar.

4.0 Suporte ao Cliente

A home page do produto para o Rational Application Developer é www.ibm.com/software/awdtools/developer/application/. Para Perguntas Freqüentes, listas de problemas conhecidos e correções e outras informações de suporte, visite a página de suporte em www.ibm.com/software/awdtools/developer/application/support/

5.0 Avisos e Marcas Registradas

© Copyright IBM Corporation 2000, 2005. Todos os Direitos Reservados.

A Documentação XDoclet inclusa neste produto IBM é utilizada com permissão e está protegida pela seguinte declaração de atribuição de copyright: Copyright (c) 2000-2005, XDoclet Team. Todos os direitos reservados.

Partes baseadas em Design Patterns: Elements of Reusable Object-Oriented Software, de Erich Gamma, Richard Helm, Ralph Johnson e John Vlissides, Copyright (c) 1995 by Addison-Wesley Publishing Company, Inc. Todos os direitos reservados.

Estas informações foram desenvolvidas para produtos e serviços oferecidos nos Estados Unidos. É possível que a IBM não ofereça os produtos, serviços ou recursos discutidos nesta publicação em outros países. Consulte um representante IBM local para obter informações sobre os produtos e serviços disponíveis atualmente em sua área. Qualquer referência a produtos, programas ou serviços IBM não significa que apenas produtos, programas ou serviços IBM possam ser utilizados. Qualquer produto, programa ou serviço funcionalmente equivalente, que não infrinja nenhum direito de propriedade intelectual da IBM, poderá ser utilizado em substituição a este produto, programa ou serviço. Entretanto, a avaliação e verificação da operação de qualquer produto, programa ou serviço não-IBM são de responsabilidade do Cliente.

A IBM pode ter patentes ou solicitações de patentes pendentes relativas a assuntos tratados nesta documentação. O fornecimento desta publicação não garante ao Cliente nenhum direito sobre tais patentes. Pedidos de licença devem ser enviados, por escrito, para:

Gerência de Relações Comerciais e Industriais da IBM Brasil
Av. Pasteur, 138-146, Botafogo
Rio de Janeiro, RJ
CEP 22290-240

Para pedidos de licença relacionados a informações de DBCS (Conjunto de Caracteres de Byte Duplo), entre em contato com o Departamento de Propriedade Intelectual da IBM em seu país ou envie pedidos de licença, por escrito, para:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

O parágrafo a seguir não se aplica a nenhum país em que tais disposições não estejam de acordo com a legislação local: A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAÇÃO "NO ESTADO EM QUE SE ENCONTRA" SEM GARANTIA DE NENHUM TIPO, SEJA EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS NÃO SE LIMITANDO ÀS GARANTIAS IMPLÍCITAS OU CONDIÇÕES DE NÃO-VIOLAÇÃO, MERCADO OU ADEQUAÇÃO A UM DETERMINADO PROPÓSITO. Alguns países não permitem a exclusão de garantias expressas ou implícitas em certas transações; portanto, essa disposição pode não se aplicar ao Cliente.

Estas informações podem incluir imprecisões técnicas ou erros tipográficos. Periodicamente são feitas alterações nas informações aqui contidas; tais alterações serão incorporadas em futuras edições desta publicação. A IBM pode, a qualquer momento, aperfeiçoar e/ou alterar os produtos e/ou programas descritos nesta publicação, sem aviso prévio.

Referências nestas informações a Web sites não-IBM são fornecidas apenas por conveniência e não representam de forma alguma um endosso a esses Web sites. Os materiais contidos nesses Web sites não fazem parte dos materiais desse produto IBM e a utilização desses Web sites é de inteira responsabilidade do Cliente.

A IBM pode utilizar ou distribuir as informações fornecidas da forma que julgar apropriada sem incorrer em qualquer obrigação para com o Cliente.

Licenciados deste programa que desejam obter informações sobre este assunto com objetivo de permitir: (i) a troca de informações entre programas criados independentemente e outros programas (incluindo este) e (ii) a utilização mútua das informações trocadas, devem entrar em contato com:

Gerência de Relações Comerciais e Industriais da IBM Brasil
Av. Pasteur, 138-146, Botafogo
Rio de Janeiro-RJ
CEP 22290-240

Tais informações podem estar disponíveis, sujeitas a termos e condições apropriadas, incluindo em alguns casos o pagamento de uma taxa.

O programa licenciado descrito neste documento e todo o material licenciado disponível são fornecidos pela IBM sob os termos do Contrato com o Cliente IBM, do Contrato de Licença do Programa Internacional IBM ou de qualquer outro contrato equivalente.

Todos os dados de desempenho aqui contidos foram determinados em um ambiente controlado. Portanto, os resultados obtidos em outros ambientes operacionais podem variar significativamente. Algumas medidas podem ter sido tomadas em sistemas de nível de desenvolvimento e não há garantia de que estas medidas serão iguais em sistemas geralmente disponíveis. Além disso, algumas medidas podem ter sido estimadas por extrapolação. Resultados reais podem variar. Os usuários deste documento devem verificar os dados aplicáveis para seu ambiente específico.

As informações sobre produtos não-IBM foram obtidas junto aos fornecedores dos respectivos produtos, de seus anúncios publicados ou de outras fontes disponíveis publicamente. A IBM não testou estes produtos e não pode confirmar a precisão de do desempenho, da compatibilidade ou de qualquer outra reivindicação relacionada a produtos não-IBM. Dúvidas sobre os recursos de produtos não-IBM devem ser encaminhadas diretamente a seus fornecedores.

Todas as declarações relacionadas aos objetivos e intenções futuras da IBM estão sujeitas a alterações ou cancelamento sem aviso prévio e representam apenas metas e objetivos.

Estas informações contêm exemplos de dados e relatórios utilizados nas operações diárias de negócios. Para ilustrá-los da forma mais completa possível, os exemplos podem incluir nomes de indivíduos, empresas, marcas e produtos. Todos estes nomes são fictícios e qualquer semelhança com nomes e endereços utilizados por uma empresa real é mera coincidência.

LICENÇA DE COPYRIGHT:

Estas informações contêm programas de aplicativos de exemplo na linguagem fonte, ilustrando as técnicas de programação em diversas plataformas operacionais. Você pode copiar, modificar e distribuir estes programas de exemplo sem a necessidade de pagar à IBM, com objetivos de desenvolvimento, utilização, marketing ou distribuição de programas aplicativos em conformidade com a interface de programação de aplicativo para a plataforma operacional para a qual os programas de exemplo são criados. Esses exemplos não foram testados completamente em todas as condições.Portanto, a IBM não pode garantir ou implicar a confiabilidade, manutenção ou função destes programas.

Cada cópia ou parte desses programas de amostra ou qualquer trabalho derivado, deve incluir um aviso de copyright com os dizeres:

© (o nome de sua empresa) (ano). Partes deste código são derivadas dos Programas de Exemplo IBM Corp. © Copyright IBM Corp. 2000, 2005. Todos os direitos reservados.

Se você estiver visualizando estas informações em cópia eletrônica, as fotografias e ilustrações coloridas podem não aparecer.

Informações sobre a Interface de Programação

As informações sobre interface de programação destinam-se a facilitar a criação de software aplicativo utilizando este programa.

As interfaces de programação de uso geral permitem que o cliente desenvolva o software aplicativo que obtém os serviços das ferramentas deste programa.

No entanto, estas informações também podem conter informações sobre diagnósticos, modificações e ajustes. As informações sobre diagnósticos, modificações e ajustes são fornecidas para ajudá-lo a depurar o seu software aplicativo.

Aviso: Não utilize estas informações sobre diagnósticos, modificações e ajustes como uma interface de programação, pois elas estão sujeitas a alterações.

Marcas Registradas e Marcas de Serviço

Os termos a seguir são marcas registradas da International Business Machines Corporation nos Estados Unidos e/ou em outros países:

• CICS
• IBM
• IMS
• OS/390
• Rational
• WebSphere
• z/OS

Java e todas as marcas registradas baseadas em Java são marcas registradas da Sun Microsystems, Inc. nos Estados Unidos e/ou em outros países.

Windows e Windows NT^® são marcas registrada da Microsoft^® Corporation nos Estados Unidos e/ou em outros países.

Intel^® e Pentium^® são marcas registradas ou comerciais da Intel Corporation ou de suas subsidiárias nos Estados Unidos e/ou em outros países.

UNIX^® é uma marca registrada da The Open Group nos Estados Unidos e/ou em outros países.

Linux^® é uma marca registrada da Linus Torvalds nos Estados Unidos e/ou em outros países.

Outros nomes de empresa, produtos ou serviços podem ser marcas comerciais ou marcas de serviço de terceiros.