Notas sobre o Release para Versão 2.6.0 do IBM WebSphere Business Integration Adapter para JDBC

Essas notas sobre o release abrangem informações sobre o release para a Versão 2.6.0 do IBM(R) WebSphere(R) Business Integration Adapter para JDBC.Essas notas sobre o release contêm as seguintes seções:
Novo neste release Tempo de Execução e API do WebSphere Business Integration Adapters
Histórico de correção do produto Problemas Conhecidos e Soluções Alternativas
Requisitos de hardware e de software Atualizações de documentação
Instalação, migração, upgrade, configuração

Nota: Podem estar disponíveis informações importantes sobre esse produto nos Flashes de Suporte Técnico lançados depois que essas notas sobre o release foram publicadas.Eles podem ser localizados no Web site de suporte do WebSphere Business Integration, http://www.ibm.com/websphere/integration/wbiserver/support.Clique no produto no qual você está interessado; se houver flashes disponíveis, eles estarão localizados em Ajuda Automática > Resolver um Problema > Flashes (Alertas).

Novo neste release

Novos recursos e aprimoramentos feitos neste release incluem o seguinte:

Novo suporte ao sistema operacional

O Adaptador JDBC agora é executado no AIX(R) de 64 bits (JMV de 32 bits no AIX de 64 bits).

Novo suporte a idiomas

Foi incluído suporte para idiomas bidirecionais (bi-di) para o adaptador e para ODA.

Consulte a publicação Guia do Usuário do Adaptador para JDBC para obter informações detalhadas sobre o Adaptador para JDBC e sobre os novos recursos.

Histórico de correção do produto

Entre o release 2.5.0 e o 2.6.0, foram corrigidos o seguintes problemas, com base nos casos relatados pelos clientes.

Número de
Rastreio
Descrição
35258 Foi incluída a impressão de rastreios de pilha para exceções capturadas em eventos principais no Adaptador JDBC.
31759 Foi corrigido um problema com a notificação de e-mail LogAtInterchangeEnd no Fix Pack 2.4.4.
35455 Os contêineres em um objeto de negócios do wrapper não estão sendo excluídos. Este problema foi corrigido no Fix Pack 2.4.4.
35954 Os atributos de cópia não são propagados para objetos de negócios de contêiner filhos. Este problema foi corrigido no Fix Pack 2.4.4.
35078 O adaptador não é encerrado quando há falha de polling, com a chamada de SPBeforePoll ativada.
43390 É necessário suporte para a recuperação de objetos CLOB grandes como parâmetros de procedimentos armazenados.
36188 A propriedade do conector RetryCountAndInterval não funciona para dados de objetos de negócios filhos.
58660 O adaptador retorna uma mensagem de erro se o parâmetro de saída de um procedimento armazenado for RS (ResultSet).
59112 O adaptador falha ao abrir uma conexão com o banco de dados após a falha de uma consulta de ping.

Requisitos de hardware e de software

Os requisitos de hardware e de software estão incluídos na documentação do produto. Consulte as Informações de Instalação, Migração, Upgrade e Configuração para obter links para esses guias.

Instalação, Migração, Upgrade e Configuração

Se você estiver instalando o software a partir do CD ou fazendo download dele a partir do Passport Advantage e o instalando a partir de um diretório local, consulte o guia apropriado:

Esses guias também incluem informações gerais de migração, upgrade e configuração

Para obter os requisitos de hardware e software, além de informações sobre instalação, migração, upgrade e configuração específicas para este produto, consulte a publicação Guia do Usuário do Adaptador para JDBC.

Notas de Upgrade

Tempo de Execução e API do WebSphere Business Integration Adapters

Certifique-se de executar essa versão do adaptador com o tempo de execução do WebSphere Business Integration Adapters versão 1.8.0 ou posterior.

Os arquivos .jar da API do WebSphere Business Integration Adapters e os scripts associados (CWConnEnv.bat e CWODAEnv.bat para Windows(R); CWConnEnv.sh e CWODAEnv.sh para plataformas UNIX) são instalados pela API do WebSphere Business Integration Adapters.Antes de instalar o adaptador, certifique-se de que o tempo de execução WebSphere Business Integration Adapters esteja instalado. Se a versão não for 1.8.0 ou posterior, será necessário fazer download da API mais recente. Essa seção fornece instruções para verificar a versão da API, fazer download da versão mais recente e ativar o adaptador para ser executado em diversas versões do InterChange Server e do ADK (Adapter Development Kit).

Verificando a versão do tempo de execução

Para verificar a versão do tempo de execução, localize o arquivo de manifesto (ProductDir\lib\WBIA.jar) e abra-o em um editor Java JAR adequado. Procure pelas seguintes linhas:

Implementation-Title: "CWConnectorAPI"
Implementation-Version: 1.8.0

A linha Implementation-version indica a versão instalada da API. Se a versão não for 1.8.0 ou posterior, será necessário fazer download do mais recente tempo de execução.

Fazendo Download do tempo de execução

Para fazer download da versão mais recente do tempo de execução:

  1. Vá para http://www.ibm.com.
  2. Clique na guia Suporte& Downloads.
  3. Sob o título Downloads, clique em Downloads & Drivers.
  4. No campo Digitar Termos de Procura, digite "wbia api" e clique em Submeter.

Depois de fazer download e instalar o tempo de execução, você deve encontrar os seguintes arquivos:

lib\WBIA.jar
bin\CWConnEnv.bat (Windows)
bin/CWConnEnv.sh (UNIX)
bin\CWODAEnv.bat (Windows)
bin/CWODAEnv.sh (UNIX)
connectors\messages\CwConnectorAgentMessages.txt

Ativar os adaptadores para versões anteriores do Adapter Development Kit e do InterChange Server

Esse adaptador é executado apenas no Adapter Framework atual, versão 2.6.0, que trata do InterChange Server versões 4.2.2 e a 4.3.0.

Problemas conhecidos e soluções alternativas

Foram localizados os seguintes problemas nesse release:

Número de
Rastreio
Descrição
41966 O JDBC ODA não pode gerar um objeto de negócios a partir do pseudônimo de um procedimento armazenado ao utilizar o Oracle thin driver, pois o driver não suporta análise de Sinônimos para StoredProcedures. Para solucionar isto, utilize o nome do procedimento real para gerar o objeto de negócios utilizando o ODA, ou construir o objeto de negócios manualmente.
43888 O JDBC ODA mostra os nomes do nó de procedimento armazenado com um sufixo ";1" ao analisar um banco de dados SQL Server. Este é um problema com o banco de dados SQL Server para o qual não há correções. Para solucionar este problema, você pode remover manualmente o ";1" no ASI gerado para os atributos de procedimento armazenado no objeto de negócios gerado.
41967 A Estrutura não pode processar mais do que 20.000 valores de propriedade ao exibir as propriedades de configuração do ODA ou ao solicitar ao usuário as propriedades específicas de definição do objeto de negócios. Assegure-se de que não mais do que 10.000 valores sejam retornados na lista drop down, o ODA será interrompido.
N/D O WebSphere Business Integration Adapters e o InterChange Server não suportam caracteres bi-di como parte dos nomes do objeto de negócios e do atributo de objeto de negócios. Conseqüentemente, após o gabarito do objeto de negócios ser gerado com base nas tabelas de banco de dados com nomes de colunas contendo caracteres bi-di, você deve renomear todos os nomes de objetos de negócios e os nomes de atributos que incluam caracteres não-Latim para incluir apenas caracteres em Latim.
N/D No JDBC ODA, os nomes da tabela e das colunas em hebraico para o driver DB2 OS/390 IBM Universal JDBC restringem como os caracteres não-Latim devem ser especificados como parte de uma consulta SQL. Em particular, ele não processa corretamente as consultas SQL que contêm caracteres bi-di como parte dos nomes da tabela e das colunas se os nomes da tabela e das colunas não estiverem entre parênteses. Conseqüentemente, já que os gabaritos de objeto de negócios gerados pelo JDBC ODA não colocam os nomes da tabela e das colunas entre parênteses nas ASI (Informações Específicas do Aplicativo), se você estiver utilizando estes gabaritos para comunicação com o OS/390 DB2 através do driver IBM Universal JDBC, é necessário modificar os nomes da tabela e das colunas nos gabaritos de objeto de negócios da seguinte forma:
Todas as ocorrências de TN=<nome da tabela> na ASI de nível de objeto de negócios devem ser substituídas por TN="<nome da tabela>"
Todas as ocorrências de CN=<nome da tabela> na ASI de nível de atributo de negócios devem ser substituídas por CN="<nome da tabela>"
N/D Devido às limitações do driver DB2 OS/400 IBM Universal JDBC, os nomes das colunas da tabela, incluindo caracteres bi-di são excluídas do gabarito de objeto de negócios gerado. Conseqüentemente, apenas as colunas que contêm nomes em Latim são consideradas durante a geração do gabarito de objeto de negócios. Se a tabela não possuir colunas em Latim, nenhum gabarito de objeto de negócios é gerado.
Se você estiver utilizando um driver DataDirect JDBC, visualizará os seguintes problemas:
41973 O driver DataDirect SQL não suporta análise de colunas do tipo TimeStamp. Para atributos que estão vinculados a colunas do tipo TimeStamp no banco de dados, corrija os tipo de atributo manualmente na definição de objeto de negócios.
41977 Ao utilizar o driver DataDirect SQL, o OracleApps ODA não gera informações específicas do aplicativo apropriadas para os procedimentos armazenados que retornam conjuntos de resultados. O driver não suporta análise de tipo de retorno quando o procedimento armazenado retorna um conjunto de resultados. Por exemplo, o procedimento armazenado retorna @RETURNVALUE, que o ODA não pode utilizar para gerar um atributo. Para solucionar isto, inclua o atributo manualmente na definição do objeto de negócios.
O driver DataDirect Oracle não fornece informações sobre chaves quando o objeto de negócios é gerado a partir do pseudônimo de uma tabela, e ele não suporta a análise de pseudônimos. Para solucionar isto, você deve modificar o objeto de negócios após a sua geração.

Atualizações da Documentação

A documentação do produto não está incluída como parte do pacote do produto, seja através de CD ou distribuição eletrônica do produto. A documentação para esse produto pode ser localizada nos seguintes Centros de Informações:

Para obter a documentação do produto, visite o Web site e faça download do conjunto de documentação atual para o release que você está utilizando. Siga as instruções fornecidas na página do Centro de Informações para concluir a instalação.

Copyright IBM Corp. 1997, 2004