Notas sobre o Release do WebSphere Business Integration Server Express e Express Plus, Versão 4.4, para Windows

$L(com.ibm.wbi.install.common.i18n.WBIProductResources, businessIntegrationServerExpressPlusProduct.
displayName)

• A criação do repositório pode falhar. Quando isto ocorrer, o log do Instalador incluirá a seguinte linha de mensagem: Não foi emitido nenhum comando de início do gerenciador de banco de dados.
• A inicialização do InterChange Server Express pode falhar, porque sem a execução do gerenciador de banco de dados, o InterChange Server Express não pode se conectar ao SMB_DB. Quando isto ocorrer, as mensagens do arquivo de log InterchangeSystem incluirão a seguinte linha: Não foi emitido nenhum comando de início do gerenciador de banco de dados.

Solução alternativa: Esta solução alternativa é para ambos os problemas:

1. Abra o Centro de Controle do DB2.
2. Expanda a pasta Todos os Sistemas Catalogados e expanda a pasta de seu host e depois a pasta Instâncias.
3. Na pasta Instâncias, clique com o botão direito no ícone DB2 e clique em Iniciar.
   A seguinte mensagem do DB2 é exibida: Processamento do DB2START foi bem-sucedido.

Quando você tiver concluído essas etapas, poderá criar um repositório e iniciar com êxito o InterChange Server Express.

Portanto, o alias do repositório do InterChange Server Express denominado SMB_DB, que é criado durante a instalação original do WebSphere Business Integration Server Express ou do Express Plus, permanece após a desinstalação do DB2. Embora a existência desse alias não afete a reinstalação do DB2 Enterprise ou do DB2 Express, quando o WebSphere Business Integration Server Express ou Express Plus for reinstalado, a criação do repositório irá falhar porque o sistema encontra o alias SMB_DB antigo.

Solução alternativa: Exclua o banco de dados SMB_DB manualmente antes de desinstalar ou reinstalar o DB2 Enterprise ou DB2 Express. A exclusão do banco de dados real elimina seu alias.

O ODA definia as informações de nível de objeto incorretamente quando o nome da classe de interface de biblioteca do tipo COM começava com um caractere sublinhado (_). Este problema foi corrigido e as informações são geradas corretamente.

Se um objeto pai com um atributo de chave com UID=AUTO nas informações específicas do aplicativo e com um objeto filho que possui um atributo que faz referência à chave pai como a chave externa, a chave externa do objeto filho não será preenchida com o novo valor da coluna de identidade do pai durante a operação de criação.

31759

Para o verbo Delete, se o objeto de negócios pai for um objeto de negócios do wrapper, filhos com múltipla cardinalidade do objeto de negócios do wrapper não serão excluídos.

Ao utilizar atributos Copy para propagar valores em uma hierarquia de objetos de negócios, tais valores não estavam sendo propagados para objetos de negócios filho de "N" cardinalidades.

Quando o servidor SAP for encerrado abruptamente, os eventos de pedido não serão mais perdidos durante o processamento de pedidos.

O valor de ObjectEventId será preservado para processamento de pedidos.

O desempenho sofria quedas quando o diretório Request era preenchido com muitos arquivos de status para processamento de pedidos ALE.

A definição de caracteres de espaço que preenchem os campos em um segmento ao enviá-lo para SAP deve ser corrigida.

Ao utilizar arquivos IDOC de sistemas SAP R/3 4.7, as informações específicas do aplicativo geradas nos objetos de negócios estavam incorretas.

O adaptador não estava utilizando o valor de propriedade de conector configurado para AleEvenTD valign="top" align="left"ir para criação da pasta Pedido. A pasta Pedido retém os arquivos de mensagem de status para processamento de pedidos ALE utilizando gerenciamento TID.

Objetos de negócios filho devem ser processados corretamente quando ABAP BAPI_Handler for utilizado.

Eventos enviados quando o conector for pausado não chegam mais à tabela archive com status 3. Eles permanecem na tabela de eventos prontos para sofrerem polling com status Q. Esta alteração requer a importação de transportes a partir dos seguintes arquivos: 4_Delivery.zip e 4_Utilities.zip.

Ao processar IDOCs com um segmento de texto vazio, o adaptador não falha mais retornando um erro MQ.

Um BAPI/RFC de Procura por Descrição no nó RFC não estava gerando seu objeto de negócios correspondente corretamente.

Quando o adaptador é pausado, alguns eventos desapareceram. Com esta correção, todos os eventos permanecem na fila de eventos.

O suporte para caracteres Japoneses MS932 agora é suportado. A propriedade de configuração PartnerCharset deve ser utilizada para especificar a codificação PartnerCharset.

Quando o conector estava pausado, os eventos foram enviados para a fila de erros. Com esta correção, os eventos permanecem na fila de eventos para serem reprocessados novamente quando o conector retomar suas atividades.

O recurso reiniciar/tentar novamente não estava reiniciando o conector corretamente.

O adaptador não lança mais NullPointerException quando há dados de registro de controle (SAP ALE) incorretos.

Se um objeto de negócios não for suportado, o adaptador não será encerrado. Em vez disso, um erro será registrado e o adaptador continuará em funcionamento.

Quando o atributo Dummy_key não existe no objeto de negócios, ocorre uma falha no adaptador. Com esta correção, o adaptador processa o evento com sucesso, sem o mapeamento dummy_key.

O mecanismo de link de evento funcionará no sistema SAP 4.7 com esta correção. Esta alteração requer a importação de transportes no arquivo 47_EventTriggering.zip.

O adaptador não sofre mais interrupções após enviar um objeto de negócios com caracteres LF CR.

O ODA falhou ao criar objetos de negócios que contêm a mesma estrutura nos campos de importação e exportação. Com esta correção, as estruturas serão renomeadas exclusivamente e o objeto será criado com sucesso.

O ODA Siebel não é capaz de gerar definições de objetos de negócios para serviços de negócios nas versões 6.x do aplicativo Siebel.

O adaptador sempre espera que o atributo de contêiner SiebelMessage esteja presente no objetos de negócios de resposta do objeto de negócios do serviço de negócios personalizado. Agora, o processamento continuará mesmo se o atributo de contêiner SiebelMessage não for localizado.

O adaptador não deve registrar nenhuma mensagem enquanto a entrega de assinatura estiver no nível de rastreio 0.

Se um atributo de chave for do tipo String e possuir espaços vazios no valor, haverá um erro no adaptador.

O conector não efetua rollback de uma operação de criação de filho quando uma associação está envolvida.

O adaptador anexa uma nova linha ao início do conteúdo retornado de uma chamada para uma rotina de tratamento de dados filho. O metaobjeto DataHandler do SOAP agora suporta à nova propriedade UseNewLine com os valores possíveis true ou false. O valor de true inclui uma nova linha no início de um resultado obtido a partir de uma chamada para rotina de tratamento de dados filhos. Um valor false anexa o conteúdo na tag de abertura do elemento. O valor padrão é true para retrocompatibilidade. Por exemplo:

- UseNewLine está definido como true
<ParentElement>
conteúdo obtido a partir de uma rotina de tratamento de dados filhos</ParentElement>
- UseNewLine está definido como false
<ParentElement>conjunto obtido a partir de uma rotina de tratamento de dados filhos</ParentElement>

A rotina de tratamento de protocolo SOAP/JMS não causa falha em um pedido que não gera resposta dentro do valor configurado de ResponsetWaitTimeout.

A rotina de tratamento SOAP/HTTP(S) ignora a carga útil de resposta síncrona caso o comprimento do conteúdo do cabeçalho HTTP não esteja especificado.

• A rotina de tratamento de protocolo assíncrono verifica e trunca o tipo MIME, se necessário, antes de tentar realizar a conversão para uma mensagem HTTP a partir de um objeto de negócios.
• A rotina de tratamento de protocolo assíncrono inclui funcionalidade adicional de tempo limite/nova tentativa.
• A rotina de tratamento de protocolo assíncrono inclui a opção de realizar codificação base64.

Solução alternativa: Se ocorrer este problema, encerre o WebSphere InterChange Server Express e os adaptadores, encerre o Servidor de Nomenclaturas e, em seguida, reinicie o servidor e os adaptadores.

Solução alternativa: Não execute o programa de desinstalação contido no diretório install_location\_uninst para fazer upgrade para a versão 4.4 pois ele afetará a instalação. Você poderá remover o diretório manualmente. No entanto, deixar o diretório onde ele se encontra não irá afetar a funcionalidade do produto.

1. A partir do menu View no Netscape, selecione Character Set > Unicode (UTF-8).
2. A partir do menu View, selecione Character Set > Set Default Character Set.
3. A partir do menu Edit, selecione Preferences.
4. Na janela Preferences, selecione Appearance > Fonts.
5. No campo For the Encoding, selecione Unicode.
6. No campo Variable Width Font, selecione Lucida Sans Unicode.
7. Selecione Use my default fonts, overriding document-specified fonts.
8. Clique em OK.

1. Clique em Iniciar > Programas e localize os atalhos do WebSphere Application Server 5.1.1.
2. Clique em Iniciar Application Server
3. Abra o Administrative Console (local)
4. Efetue login no console (utilize ibm para o ID do usuário)
5. Clique em Servidores no painel à esquerda
6. Clique em Servidores de Aplicativos
7. Clique em ICSMonitor
8. Clique em Definição de Processo
9. Clique em Java Virtual Machine
10. Role para localizar "Argumentos genéricos da JVM e anexe o seguinte ao final dos argumentos existentes:
    
    -Djava.protocol.handler.pkgs=com.ibm.net.ssl.www.protocol

A definição de tag personalizada para este Botão ExecuteCollaboration define que os valores para estes atributos de imagem não podem ser uma expressão de tempo de execução. No entanto se você utilizar a Visualização de Propriedades do Rational Application Developer para especificar esses valores, a ferramenta poderá incluir automaticamente uma expressão de tempo de execução para especificar o arquivo de imagem. Isto resultará em um erro JspTranslate.

Solução alternativa: Utilize um nome de arquivo de imagem com extensão de arquivo (por exemplo, oneimage.gif), em vez de utilizar uma expressão de tempo de execução como um valor para essas propriedades de imagem.

Se o Rational Application Developer 6.0 estiver instalado em uma máquina, a instalação do WebSphere Business Integration Server Express Tools na mesma máquina criará duas opções de menu para iniciar o System Manager. Uma das opções utiliza a plataforma IES como base, e a outra utiliza o Rational Application Developer como base. Este cenário poderá levar à execução de duas instâncias do System Manager ao mesmo tempo. Como as ferramentas do designer podem comunicar-se com apenas uma instância do System Manager por vez, o comportamento das ferramentas do designer será imprevisível caso sejam executadas duas instâncias do System Manager.

Ao utilizar o ODA, a propriedade PackageName deve ser uma única palavra, sem pontuação ou espaços. Por exemplo, Teste ou Amostras é aceitável; no entanto, com.ibm.adapters.MQProxy não é. Isto ocorre devido a uma limitação em BIA_COMProxy.dll.

Solução alternativa: Insira os nomes do método manualmente no objeto de negócios gerado, isto é, create=Method1;Method2;Method3.

Solução alternativa: Crie um TaskItem por ocorrência.

Solução alternativa: Se isto ocorrer, interrompa o adaptador e siga as instruções no guia do usuário para oferecer os privilégios apropriados ao usuário. Em seguida, reinicie o adaptador, e todos os eventos com status definido como IN_PROGRESS serão processados.

Soluções Alternativas:

• Gere um novo evento utilizando somente caracteres em inglês no Assunto. Atualize o item para que apenas caracteres em inglês sejam utilizados no Assunto. Isto gera um novo evento com o verbo "Update". O agente do conector agora processa o novo evento corretamente.
• Atualize o evento e o item, substituindo os caracteres japoneses somente com caracteres em inglês no Assunto.
  1. Atualize o item para que apenas caracteres em inglês sejam utilizados no Assunto.
  2. Atualize o evento em archive, substituindo o Assunto antigo pelo novo Assunto.
  3. Copie o evento da pasta Archive para a pasta Evento.

  O agente do conector agora processa corretamente o evento atualizado.

Solução alternativa: Forneça o caminho completo do arquivo IFS do iSeries na propriedade iSeriesFilePath; por exemplo, /QSYS.LIB/PNPLIB.LIB/SRCPF.FILE/. Após definir o caminho, o ODA lista os arquivos nesta pasta. Selecione os arquivos apropriados para gerar objetos de negócios. Para obter informações adicionais, consulte o technote em http://www-1.ibm.com/support/docview.wss?rs=695&context=SSMKUK&dc=DB520&q1=iseries&uid=swg21188205&loc=en_US&cs=utf-8&lang=en

Solução alternativa: Após a geração do gabarito do objeto de negócios com base nas tabelas de banco de dados com nomes de colunas contendo caracteres bidirecionais, renomeie todos os nomes de objetos de negócios e nomes de atributos que incluam caracteres não-latim, de forma a incluir apenas caracteres em latim.

Solução alternativa: Como os gabaritos de objetos de negócios gerados pelo ODA JDBC não colocam nomes de tabela e coluna entre parênteses em ASI (Informações Específicas do Aplicativo), se você estiver utilizando esses gabaritos para comunicação com o OS/390 DB2 através do driver IBM Universal JDBC, modifique os nomes de tabela e coluna nos gabaritos de objetos de negócios, da seguinte maneira:

• Substitua todas as ocorrências de TN=<nome da tabela> na ASI de nível do objeto de negócios com TN="<nome da tabela>"
• Substitua todas as ocorrências de CN=<nome da coluna> na ASI de nível do atributo do objeto de negócios com CN="<nome da coluna>"

Solução alternativa: Efetue login no servidor DB2 e execute o seguinte comando: db2jstrt LISTENPORT.

Solução alternativa: Utilize o nome de procedimento armazenado real para gerar o objeto de negócios utilizando o ODA ou crie o objeto de negócios manualmente.

Solução alternativa: Para listar todas as tabelas no banco de dados, utilize o arquivo driver-classes12.zip JDBC nativo fornecido pela Oracle.

Solução alternativa: Remova manualmente o ";1" nas informações específicas do aplicativo geradas para atributos do procedimento armazenado no objeto de negócios gerado.

Este release inclui as seguinte limitações no adaptador:

• JText possui dois modos de processamento: texto (modo normal) e binário. O modo binário requer uma rotina de tratamento de dados apropriada para ser conectado.
• JText não pode renomear um conjunto de dados que utiliza convenções de nomenclatura MVS.
• A lógica de arquivamento no MVS difere daquela de ambientes UNIX^(R) e Windows^(R), devido às limitações do MVS.
• JText pode realizar polls em arquivos remotos com base em um time stamp de um site FTP apenas se o servidor FTP suportar o comando data e hora da modificação (mdtm). A ativação deste recurso pode reduzir o desempenho, especialmente se houver um número grande de arquivos de eventos no diretório de eventos.
• Quando um atributo de metaobjeto LargeObject no adaptador JText é definido como true, o adaptador segue uma metodologia diferente de arquivamento. Nesta metodologia, se um arquivo de eventos possui múltiplos objetos de negócios, o arquivamento é feito apenas após o processamento de todos os objetos de negócios desse arquivo de eventos. Além disso, o arquivo original não será arquivado caso o processamento de objetos de negócios para todos os objetos de negócios desse arquivo de eventos resulte em uma falha ou em um status não-assinado. O arquivo original será arquivado apenas quando o processamento de objetos de negócios para o arquivo de eventos resulta em status misto, por exemplo, uma combinação de sucessos e falhas.
• O suporte bidirecional da propriedade FTPFileEventMask não existe neste release, devido às seguintes restrições:
  • Apenas o sistema operacional VM permite a definição de nomes de arquivos que incluem caracteres bidirecionais.
  • O suporte a FTP no conector JText não permite a comunicação com FTP do VM.

Solução alternativa: Para todos os arquivos com qualquer outro EndBODelimiter que não seja EOF, utilize um editor Hex para incluir alguns bytes (por exemplo, FF02) como delimitador e especifique os bytes como EndBODelimiter.

• ISO-8859-8 se o código do idioma for hebraico
• ISO-8859-6 se o código do idioma for árabe
• ISO-8859-1 para todos os outros casos

Solução alternativa: Consulte o technote Memory utilization for the IBM WebSphere Business Integration Adapter for mySAP.com v6.0.0 (ALE module).

Solução alternativa: Inclua manualmente o atributo na definição de objeto de negócios.

Solução alternativa: Defina a propriedade padrão DeliveryTransport como IDL.

Solução alternativa: Defina o valor da propriedade como true (distinção entre maiúsculas e minúsculas).

Solução alternativa: Após um gabarito de objeto de negócios baseado nos arquivos XML/XSD com nomes de atributos/elementos contendo caracteres bidirecionais ser gerado, renomeie todos os nomes de objetos de negócios e nomes de atributos que incluam caracteres não-latim, para que possam conter apenas caracteres em latim.

Quando o ODA WSDL encontra múltiplos esquemas seqüenciais que importam uns aos outros sem fornecer os locais dos esquemas, ele registra avisos ou erros; no entanto, os objetos de negócios são gerados corretamente.

Solução alternativa: Separe cada esquema em um arquivo individual e atualize as importações/inclusões para conter os locais de arquivo apropriados. Importe esses arquivos de esquema individuais no documento WSDL utilizando uma instrução de importação com os locais de arquivo apropriados.

Quando o WebSphere MQ 5.3 CSD03 for utilizado como o provedor JMS, o listener JMS do adaptador não poderá ler corpos de mensagens após mover a mensagem da fila de entrada para a fila em andamento. Este é um problema com o aplicativo WebSphere MQ.

Solução alternativa: Utilize uma URL codificada, ou salve o arquivo WSDL no armazenamento local e utilize o caminho local em vez da URL de HTTP.

Solução alternativa: Utilize URLs codificadas.

Solução alternativa: Modifique o script inicial do adaptador para definir a variável JVMArgs com a opção -Xgcthreads1, conforme mostrado no seguinte exemplo:
JVMArgs="-Xgcthreads1 %JVMArgs%"

Neste release, alguns guias de adaptador, conforme listados abaixo, não foram revisados com os nomes de produtos e informações de suporte à plataforma e de restrição de recursos específicos dos releases do WebSphere Business Integration Server Express e Express Plus. Em vez disso, as versões mais recentes dos guias do release do produto WebSphere Business Integration Adapters foram fornecidas. Isto se aplica aos seguintes guias:

Esses guias contêm informações atualizadas para os recursos do adaptador, conforme fornecidos no release do produto IBM WebSphere Business Integration Adapters. Você poderá perceber diferenças entre os nomes utilizados para certas ferramentas referenciadas nesses guias e os nomes utilizados para as ferramentas fornecidas com os produtos IBM WebSphere Business Integration Server Express e Express Plus. Além disso, as seguintes referências a recursos que poderão aparecer nesses guias não são válidas para os releases do WebSphere Business Integration Server Express e Express Plus:

• Referências aos intermediários de integração com exceção do InterChange Server Express
• Referências ao MQ como mecanismo de transporte de entrega.
• Referências à implementação do agente do conector utilizando passagem de Internet do MQ, que permite a implementação do agente do conector com o InterChange Server Express instalado no outro lado de um firewall de Internet
• Referências ao paralelismo do agente do conector
• Referências ao suporte a assinaturas ITLM

• Declarações de suporte à plataforma
• Referências a nomes de caminho e de arquivo
• Criação e uso de scripts de inicialização
• Instruções para iniciar e interromper o conector
• Instruções para criar um novo arquivo de configuração
• Instruções para definir as propriedades de Segurança no Connector Configurator

Informações sobre implementação e tarefas administrativas relevantes para todos os adaptadores suportados nas plataformas Windows, Linux ou OS/400 e i5/OS estão disponíveis no Guia de Implementação do Sistema e no Guia de Administração do Sistema Para obter informações adicionais e obter resposta sobre dúvidas relacionadas a limitações de recursos dos adaptadores, visite o Web site de suporte do WebSphere Business Integration Server Express.

• TraceFileName
• TraceLevel
• MessageFile

<messagefile prefix="BIA_">></messagefile>

Isto assegura que ODA será inicializado corretamente após carregar o arquivo de mensagem apropriado.

A configuração padrão da propriedade SupportNameValuePair é false. A configuração é utilizada para determinar o formato da chave do objeto de evento. Se a propriedade estiver definida como true, o valor da chave do objeto deverá ser um par nome-valor com um sinal de igual ( = ) entre o nome e o valor.

Se a propriedade estiver definida como false, ou caso não esteja definida, apenas um ID de linha poderá ser especificado na chave de objetos. Chaves múltiplas não são suportadas.