Essas notas sobre o release abrangem informações sobre o release para IBM(R) WebSphere(R) Business Integration Adapter Framework, versão 2.6.0, para Windows(R). Elas contêm as seguintes seções:
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).
Esta seção lista os novos recursos e aprimoramentos feitos neste release:
AdapterHelpName | Localiza um arquivo de Ajuda Estendida de propriedade específica do conector |
bidi.Application | Especifica o formato bi-di para dados provenientes de aplicativos externos no adaptador no formato de qualquer objeto de negócios suportado pelo adaptador |
bidi.Broker | Especifica o formato bi-di para dados enviados ou recebidos para e do intermediário |
bidi.Metadata | Especifica o formato bi-di de metadados/dados de configuração |
bidi.Transformation | Especifica se a transformação bi-di deve ser chamada no tempo de execução |
CommonEventInfrastructure | Especifica se a CEI (Common Event Infrastructure) deve ser chamada no tempo de execução |
CommonEventInfrastructureContextURL | O URL utilizado para obter acesso ao CEI Server Application |
ControllerEventSequencing | Ativa o seqüenciamento de eventos no controlador do conector |
jms.ListenerConcurrency | Especifica o número de listeners simultâneos para o controlador JMS |
jms.TransportOptimized | Determina se o WIP está otimizado; o provedor MQ é necessário para o WIP otimizado |
ResultsSetEnabled | Ativa ou desativa o suporte de conjunto de resultados |
ResultsSetSize | Número máximo de objetos de negócios que deve ser retornado ao Information Integrator |
TivoliMonitorTransactionPerformance | Especifica se é necessário chamar o Tivoli Monitoring para Transaction Performance no tempo de execução |
Entre o release 2.4.0 e o 2.6.0, foram corrigidos os seguintes CRs, com base nos casos relatados por clientes.
Número de Rastreio |
Descrição |
35632 | DisableNumberFormatGrouping é utilizado para determinar se é necessário utilizar o agrupamento ao chamar CWConnectorBusObj.setintValue(..) /setfloatValue()/setdoubleValue(). O valor padrão é false. Sem o agrupamento, 1,234,567, por exemplo, é mantido como 1234567. Uma nova propriedade denominada DisableLocaleFormating determinará se é necessário executar qualquer formatação com os números. O valor padrão para essa propriedade é false. |
33705 | Foram incluídas duas novas propriedades, MaxDoublePrecision e MaxFloatPrecision, para definir precisões duplas e flutuantes independentes do código do idioma. Os métodos setdoubleValue e setfloatValue agora utilizam esses valores de propriedade se definido, em vez da precisão padrão de código do idioma. Corrigido no Patch 1.6.1. |
30617 | Uma nova propriedade, RetrieveVerb, foi introduzida. Para compatibilidade com anteriores, o verbo será definido, por padrão, como RetrieveByContent. O adaptador pode definir o RetrieveVerb para substituir esse padrão. Se a propriedade for definida, ela será utilizada como o verbo de recuperação em getBO. |
33784 | Uma nova
assinatura de método foi incluída para fetchEvents: O Vetor público
fetchEvents(int pollQuantity) lança ConnectionFailureException,
FetchEventsFailedException. Esse método também possui uma implementação padrão para compatibilidade com anteriores que consiste em uma chamada para o método original e retorna o Vetor eventsToProcess no CWConnectorEventStore. O StatusChangeFailedException é capturado e transformado em ConnectionFailureException. No pollForEvents, o novo método é chamado. APPRESPONSETIMEOUT será retornado se houver um ConnectionFailureException. Para FetchEventsFailedException, um status FAIL será retornado de pollForEvents. |
Número de Rastreio |
Descrição |
46029 | Um auxílio do RAS foi incluído para rastrear a versão do adaptador utilizado. |
46185 | O método CxListBuffer's endsWith() não retorna corretamente um valor false quando não puder localizar o valor de procura especificado. O IndexOutOfBoundsException em CxListBuffer foi corrigido. |
30977 | Os adaptadores não se comportam corretamente quando um erro 2019 for gerado pelo MQSeries. |
29963 | Pode ser iniciado mais de um adaptador com o mesmo nome. A verificação foi incluída para assegurar que um adaptador não possa ser iniciado mais de uma vez na mesma plataforma. Uma mensagem será exibida se outro adaptador for detectado com o mesmo nome. |
33337, 33338, 33339 | O suporte ao Objeto grande deve ser incluído. |
32412 | O adaptador C++ não pode ser iniciado porque está faltando CWConnector.dll no pacote. |
34350 | Utilizando o JDBCConnector, o verbo RetrieveByContent não recupera o objeto de negócios se a consulta de seleção encontrar vários registros. |
46118 | O processamento do verbo RetrieveByContent falha no Adaptador JDBC. |
34472 | O adaptador MQ retorna um erro OutOfMemory ao processar um grande evento. O código foi incluído para verificar uma exceção OutOfMemory no encadeamento de polling. Se localizada, uma mensagem será registrada e o adaptador sairá. |
34726 | As mensagens inválidas são perdidas quando recebidas pelo adaptador sendo executado com o WebSphere Business Integration Message Broker. Mensagens desse tipo não serão roteadas para a fila de falha. |
36131 | A Estrutura do Adaptador responde com um erro ClassCastException quando forem recebidas mensagens JMS de um tipo inesperado. O rastreio foi incluído para indicar que ocorreu um erro. |
36763, 58347 | Os adaptadores não podem se conectar ao InterChange Server depois de reiniciar o Servidor de Nome Persistente. |
36147 | As atualizações dinâmicas do nível de rastreio de agente não funcionam. |
32199 | A Estrutura do Adaptador sempre inclui um nome do conector em ObjectEventId. Uma nova propriedade de conector foi incluída para intermediários InterChange Server, EnableOidForFlowMonitoring. Essa propriedade é um Booleano com um valor padrão false. Se definida como true, o ADK marcará o ObjectEventId de entrada como uma chave estrangeira para monitoramento do fluxo. |
29420, 30721 | Uma alteração no script do adaptador pode aprimorar o desempenho de um adaptador. Os argumentos JVM contêm uma opção -mx (tamanho máximo de heap). Incluir a opção -ms (tamanho mín de heap) e configurar seu valor para a metade do tamanho máximo de heap aprimorará o desempenho. Edite o arquivo start_adapter.bat localizado no diretório \bin. Localize a linha que contém "set JVMArgs" e a opção -ms como no seguinte exemplo: set JVMArgs="-mx128m -ms64m %JVMArgs%" |
29249 | Os atributos de objetos de negócios definidos como zero podem provocar o seguinte erro no analisador: org.xml.sax.SAXParseException: Um caractere XML inválido (Unicode: 0x0) foi localizado no elemento. |
Número de Rastreio |
Descrição |
34367 | Os objetos e mapas de negócios suportados anteriormente não estão sendo removidos da definição de conector; portanto, os erros de dependência são lançados quando o usuário tenta validar o projeto. |
35225 | O programa termina de forma anormal ao abrir uma configuração com um grande número de objetos de negócios. |
Utilizar o WebSphere Business Integration Adapters versão 2.6.0 enquanto versões anteriores estiverem instaladas na mesma máquina física não é recomendado. Se forem necessárias diferentes versões do WebSphere Business Integration Adapters versão 2.6.0, você deve utilizar máquinas separadas.
Um configuração salva por esse release do Connector Configurator especifica uma versão 4.3.0. As versões de configuração anteriores devem passar pelo upgrade abrindo e salvando novamente a configuração. Durante esse processo, as novas propriedades (baseadas nas dependências) serão automaticamente incluídas com os valores padrão. Consulte a nova tabela de propriedade e "Novo neste release".
Versões suportadas do InterChange Server
incluem 4.2.2 a 4.3.
Os adaptadores suportados incluem quaisquer que forem liberados com o
WebSphere Business Integration Adapters versões de 2.3.1 a 2.6.0.
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.
Seja instalando o software a partir do CD ou fazendo download dele a partir do Passport Advantage e instalando-o a partir de um diretório local, consulte o Instalando o WebSphere Business Integration Adapters, V.2.6.
Nota de Migração
Para permitir que qualquer adaptador de um release anterior da Estrutura do Adaptador funcione corretamente com esse release, você deve alterar os scripts de início para o conector e o ODA. Consulte o Guia de Migração do Adaptador para obter as alterações específicas requeridas.
Nota de instalação do Adaptador para CORBA
Se você instalar o adaptador para CORBA, certifique-se de ler as notas sobre o release do adaptador para obter informações adicionais sobre o software de pré-requisito.
Esse release inclui as seguintes limitações:
Foram localizados os seguintes problemas nesse release:
Número de Rastreio |
Problema |
23482 |
Devido a uma limitação do WebSphere MQ, os adaptadores não podem gravar mais de 100 MB de texto de mensagem XML em uma fila MQ para processamento. Esse problema ocorre quando o JMS for o transporte e WebSphere MQ Integrator ou WebSphere Application Server forem o intermediário de integração. O tempo de execução do adaptador converte os objetos de negócios em mensagens XML, que podem ficar bem grandes. Para contornar isso, evite criar mais de 25.000 objetos filho por objeto de negócios. |
N/D | Adaptadores que armazenam metadados/dados de configuração nos objetos de negócios meta (como parte dos valores padrão) ou objetos de negócios regulares (como parte do conteúdo das instâncias de tempo de execução) podem não suportar totalmente o processamento de dados bi-di com direção da direita para esquerda. O processamento incorreto pode ocorrer apenas se esses metadados de configuração guiarem o conector no processamento de informações específicas de aplicativo (ASI) e incluírem especificações do caminho de classe da rotina de tratamento de dados, codificação de dados, nome de filas e assim por diante. Para contornar isso, você deve colocar uma definição específica para cada um dos objetos de negócios meta. Especialmente, você deve incluir a especificação BIDI.METABUSINESSOBJECT=YES no nível ASI do objeto de negócios de cada objeto de negócios meta. |
Número de Rastreio |
Ferramenta | Descrição |
44407 | Instalador | Quando o IBM SDK de 32 bits para uso com o Instalador do IBM WebSphere Business Integration Adapter Framework estiver sendo executado em código do idioma chinês tradicional, chinês simplificado e coreano, o texto no painel de boas-vindas do Instalador dará a impressão de que a versão do SDK (Software Development Kit) é a 2.6.0. A Versão 2.6.0 refere-se na verdade ao IBM WebSphere Business Integration Adapter Framework e não ao IBM SDK. Isso não será problema quando o instalador estiver sendo executado em outros códigos de idioma. |
29024 | Business Object Designer ODA | Ao utilizar
o assistente do Business Object Designer ODA, você pode ter problemas
para configurar os arquivos de mensagens nos ODAs para os seguintes
adaptadores: MetaSolv Applications, JD Edwards OneWorld, CORBA, COM,
Enterprise JavaBeans e Ariba Buyer. Para contornar isso, insira o prefixo "BIA_" na frente do local padrão do arquivo de mensagem. |
31620 | Connector Configurator | Para o
WebSphere Message Brokers, se o ID de Configuração da Mensagem de
objeto de negócios não for exclusivo, você verá a seguinte mensagem
durante a validação (em que xxx representa o ID): Objeto de Negócios Suportados: ID de menagem de objeto de negócios duplicado xxx. Para WebSphere Business Integration Broker 5.0, você pode ignorar essa mensagem. Para WebSphere MQ Integrator Broker 2.1, atualize os IDs para torná-los exclusivos. |
31824 | Connector Configurator | Ao utilizar
o Connector Configurator com WebSphere Message Brokers, se o ID de
Conjunto de Mensagens for nulo no painel Objetos de Negócios
Suportados, o objeto de negócios não será salvo no arquivo de
configuração.
Para solucionar isso, utilize qualquer valor não nulo para o ID de Conjunto de Mensagens. O ID de Conjunto de Mensagens real pode ser substituído durante a implementação do System Manager. |
N/D | Se um layout não-bi-di de teclado (por exemplo, em inglês) for selecionado quando você copiar caracteres bi-di de um local externo (por exemplo, Bloco de Notas) e colá-los nas Ferramentas do WebSphere Business Integration com base em C++ com GUI, os caracteres bi-di serão exibidos como pontos de interrogação. Para evitar esse problema, você deve utilizar o layout do teclado bi-di ao copiar origens externas para um componente de GUI de Ferramentas do WebSphere Business Integration baseadas em C++. |
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:
http://www.ibm.com/websphere/integration/wicserver/infocenter
http://www.ibm.com/websphere/integration/wbicollaborations/infocenter (para colaborações)
http://www.ibm.com/websphere/integration/wbiadapters/infocenter
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.