Notas sobre o Release do IBM WebSphere Business Integration Server Express, Versão 4.3.1, para OS/400

Estas notas sobre o release tratam de informações sobre release do IBM(R) WebSphere(R) Business Integration Server Express, Versão 4.3.1, para OS/400(R). Elas contêm as seguintes seções:
Visão Geral Problemas Conhecidos e Soluções Alternativas
Requisitos de hardware e software Documentações
Informações sobre Instalação e Configuração

Nota: Informações importantes sobre este produto podem estar disponíveis nos Technical Support Flashes emitidos após a publicação destas notas sobre o release. Os Flashes podem ser encontrados no Web site de suporte do WebSphere Business Integration, http://www.ibm.com/software/integration/wbiserverexpress/support.Escolha a área de componentes de interesse e pesquise a seção de boletins.

Visão Geral

O IBM WebSphere Business Integration Server Express e o IBM WebSphere Business Integration Server Express Plus incluem os seguintes componentes:

Além do suporte existente para Windows(R) 2000, essa liberação inclui suporte para o InterChange Server Express nos seguintes sistemas operacionais:

Requisitos de hardware e software

Os requisitos de hardware e software estão inclusos na documentação do produto. Consulte as Informações sobre Configuração e Instalação para obter os links para esses guias.

Informações sobre Instalação e Configuração

Se você estiver instalando o software a partir do CD ou efetuando download do Passport Advantage e instalando a partir de um diretório local, consulte a publicação WebSphere Business Integration Server Express Installation Guide for OS/400.

Nota: Se você estiver instalando os adaptadores de tecnologia e adaptadores de aplicativos na mesma máquina, instale os adaptadores de tecnologia primeiro, através do Server Express Plus, depois instale cada adaptador de aplicativos através do instalador Pacote de Capacidade do Adaptador.

Problemas Conhecidos e Soluções Alternativas

Os seguintes problemas foram encontrados neste release:

Nome do Componente Número de Rastreio Descrição
Editor de Atividade 42343 No Editor de Atividade, você pode selecionar a partir de uma lista de variáveis globais na Janela Biblioteca para utilizar em uma atividade personalizada. Variáveis globais podem ser simples como uma variável Java (por exemplo, do tipo String) ou podem ser sofisticadas como uma variável de objeto (por exemplo, do tipo BusObj). Quando uma variável global é utilizada em uma atividade, sua designação ocorre apenas no final da atividade, portanto você deve evitar o uso de variáveis separadas que possuam as mesmas variáveis raiz em uma atividade.

Ao invés disso, você pode realizar duas subatividades em ações diferentes. Se precisar utilizar variáveis com a mesma raiz, tente reutilizar a variável com raiz única.

Adaptadores 43586 A propriedade AgentTraceLevel de um conector sendo executado através do transporte de entrega JMS e utilizando uma configuração de conector local (especificada através da opção de linha de comandos -c) pode ser atualizada dinamicamente somente uma vez através do System Manager durante a existência do conector. Tentativas subseqüentes de atualizar essa propriedade irão falhar. Uma mensagem parecida com a seguinte será mostrada nos logs:

[Tipo: Aviso] [ID da Msg: 14211] [Msg: Atualização dinâmica não é permitida para AgentTraceLevel. No arquivo de configuração, o valor já estava definido para o agente de conector e o valor definido anteriormente será utilizado.]

A propriedade AgentTraceLevel para um conector sendo executado através do transporte de entrega JMS e utilizando uma configuração de conector local não deve ser atualizada dinamicamente através do System Manager. Se a propriedade precisar ser modificada, você deve atualizar o arquivo de configuração do conector e reiniciar o agente do conector. Caso contrário, o erro que acabou de ser descrito será encontrado e pode ocorrer uma incompatibilidade entre a configuração do controlador do conector e a configuração do agente do conector.
Adaptador para JText 46499 Se mais de um arquivo corresponder à máscara de evento do MVS PDS e o FTPRenameExt for especificado o conector arquiva apenas um arquivo e não é capaz de renomear e arquivar um segundo arquivo. Para solucionar esse problema, especifique tanto FTPArchiveDir quanto FTPRenameExt em branco, para que o arquivo de eventos MVS seja excluído sem ser renomeado.
Adaptador para JText 43454 Quando o adaptador JText estiver em poll com o atributo EventExt do MO_JTextConnector_Default do metaobjeto de configuração em branco, o polling falha e o adaptador é desligado.
Adaptador para JText 35571 Uma provisão para especificar 'EOF' como um valor para EndBODelimiter no modo de processamento binário é requerida.
Para solucionar esse problema, para todos os arquivos que não possuam um EndBODelimiter diferente do próprio EOF, utilize um editor Hex para incluir alguns bytes (por exemplo, FF02) como o delimitador e especifique os bytes como o EndBODelimiter.
Adaptador para JText 34834 Suporte para FTP seguro é requerido pelo JText. O campo de senha, visível para o administrador do sistema JText agora, não estaria visível para qualquer pessoa com FTP Seguro.
Adaptador para JDBC 43503 Ao utilizar o ODA para gerar um objeto de negócios a partir de um servidor de banco de dados DB2 sendo executado no Linux, o Business Object Designer será interrompido. Isso ocorre porque o DB2 JDBC Applet Server não é iniciado.

Para solucionar esse problema, efetue login no servidor DB2 e execute o seguinte comando: db2jstrt LISTENPORT.

Adaptador para JDBC e Adaptador para Aplicativos Oracle 43246 O script inicial do OracleAppsODA inclui o arquivo xworacle.jar no DRIVERPATH, que não lista todas as tabelas no banco de dados Oracle da maneira esperada. Se você quiser listar todas as tabelas do banco de dados, pode solucionar esse problema utilizando o arquivo driver-classes12.zip JDBC nativo fornecido pelo Oracle. Defina o caminho do driver apropriadamente nos scripts iniciais de acordo com as instruções no guia do usuário do adaptador.
Adaptador para JMS e Adaptador para WebSphere MQ 37094 Durante o processamento de uma mensagem duvidosa (do InProgressQueue) que foi originada em uma das várias filas de entrada configuradas, o adaptador recupera as propriedades de conversão com base na primeira fila de entrada das propriedades específicas do conector.
Adaptador para JMS e Adaptador para WebSphere MQ 34323 As amostras dos adaptadores JMS e WebSphere MQ foram projetadas para oferecer configuração e uso dos adaptadores em um ambiente WebSphere InterChange Server Express. As instruções para utilização dessas amostras são fornecidas nas technotes que descrevem como você pode utilizar as amostras para enviar e receber objetos de negócios em um ambiente WebSphere Business Integration Server Express.

A technote do adaptador JMS pode ser encontrada no seguinte local:
http://www-1.ibm.com/support/docview.wss?rs=0&q1=JMS+adapter&uid=swg21174512&loc=en_US&cs=utf-8&cc=us&lang=en
A technote do adaptador WebSphere MQ está disponível no seguinte local:
http://www-1.ibm.com/support/docview.wss?rs=0&q1=WebSphereMQ+adapter&uid=swg21174510&loc=en_US&cs=utf-8&cc=us&lang=en
Adaptador para JMS e Adaptador para WebSphere MQ 33728 Durante o processamento de eventos, quando várias propriedades de conversão correspondem ao InputFormat e/ou ao InputQueue de uma mensagem de entrada, o adaptador tenta utilizar incorretamente o último atributo de objeto de negócios correspondente em um metaobjeto estático como o mapa para a mensagem de entrada. Nesses casos, o adaptador deve passar o conteúdo da mensagem para a rotina de tratamento de dados para permitir que ela determine o nome do objeto de negócios.

Para solucionar esse problema, configure as chaves InputFormat e InputQueue de cada um dos atributos BusinessObjectType_verb do metaobjeto estático.

Adaptador para JMS 36128 A inicialização do adaptador falha quando a propriedade InputQueue não está configurada.
Adaptador para JMS 36438 Há distinção entre maiúsculas e minúsculas nos nomes de propriedades de conversão das informações específicas de aplicativos do metaobjeto de configuração e dos nomes de metaobjetos dinâmicos.
Adaptador para WebSphere Commerce 42516 Quando o WebSphere Commerce, Business Edition, Versão 5.5 com Fix Pack 4 (ou versão anterior) for utilizado no servidor de comércio, o usuário da loja não pode ser criado apropriadamente com o adaptador WebSphere Commerce. O usuário da loja não pode efetuar logon na loja devido a uma autoridade incorreta. Uma efix do WebSphere Commerce é requerida para corrigir esse problema. A efix é JR20090 no WebSphere Commerce 5.5 com Fix Pack 4.
Adaptador para WebSphere MQ 34969 Durante o processamento de eventos síncrono, uma mensagem de relatório não é enviada para erros da rotina de tratamento de dados.
Pacote de Capacidade do Adaptador 58762 Se você instalar um adaptador de aplicativos a partir do Pacote de Capacidade do Adaptador em um sistema OS/400 que possui o Server Express Plus InterChange Server e/ou o Web Tools instalado, mas não possui adaptadores de tecnologia instalados, a inicialização de seu adaptador de aplicativos pode falhar.
Para solucionar esse problema, execute o Launchpad e instale o adaptador de tecnologia (por exemplo, e-Mail, JText ou JDBC). Quando a instalação estiver concluída, você poderá iniciar o adaptador de aplicativos.
Pacote de Capacidade do Adaptador 58799 Se você instalar um adaptador de aplicativos a partir do Pacote de Capacidade do Adaptador em um sistema OS/400 que não possui o Server Express Plus instalado, a inicialização do adaptador de aplicativos pode falhar. (O log do adaptador indicará uma ClassNotFoundException.)
Para solucionar esse problema, execute um dos procedimentos a seguir:
Digite o seguinte comando na linha de comandos para copiar o arquivo WBIA.jar para a biblioteca do produto:
CPY OBJ('/QIBM/ProdData/WBIServer43/AdapterCapacityPack/lib/WBIA.jar') TODIR('/QIBM/ProdData/WBIServer43/product/lib') OWNER(*KEEP).
Nota: Assegure que o proprietário do arquivo e as autoridades do arquivo copiado correspondam ao arquivo .jar original.
Execute o Launchpad e instale um adaptador de tecnologia (por exemplo, e-Mail, JText ou JDBC). Quando a instalação estiver concluída, você poderá iniciar o adaptador de aplicativos.
Instalador (Pacote de Capacidade do Adaptador) 44001 Quando você realiza uma instalação local ou remota do Pacote de competência para o Metasolv e JD Edwards OneWorld no Windows 2000 e tenta ativar o adaptador, ele é terminado com um erro: A linha de entrada é muito longa. Isso ocorre por problemas com o comprimento da linha de comandos no Windows 2000. Você verá o mesmo problema com o WebSphere Business Integration Adapters para Aplicativos Siebel e Oracle quando realizar uma instalação de CP remota. Existe uma solução alternativa planejada para esse problema, através de uma technote que estará disponível após esse release.
Adaptadores e Segurança de Perfil do Usuário OS/400 Pode ser necessário, por motivos de segurança, alterar o perfil do usuário nos quais os processos do agente do adaptador são executados sob o OS/400. Por exemplo, se o adaptador for JDBC ou JText, você pode não querer conceder ao perfil de usuário QWBISVR43 autoridade para seu banco de dados para JDBC ou para os diretórios e arquivos do JText. Se esse for o caso, você terá que realizar as seguintes ações para permitir que o Adaptador seja executado com êxito em um perfil de usuário diferente de QWBISVR43:
  1. Para alterar a descrição para um Agente de Adaptador, utilize o comando CHGJOBD CL para definir o parâmetro USER para o perfil de usuário que você deseja.
  2. Utilize o comando GRTOBJAUT CL para conceder autoridade do objeto para a descrição de job especificada na etapa 1 para o perfil do usuário da etapa 1, definindo o parâmetro USER no perfil de usuário e o parâmetro AUT para os seguintes valores: *READ e *EXECUTE.
  3. Utilize o comando GRTOBJAUT CL para conceder autoridade do objeto para a biblioteca QWBISVR43 do perfil do usuário da etapa 1, definindo o parâmetro USER no perfil de usuário e o parâmetro AUT para os seguintes valores: *READ e *EXECUTE.
  4. Utilize o comando GRTOBJAUT CL para conceder autoridade do objeto para a descrição do subsistema QWBISVR43 na biblioteca QWBISVR43 do perfil do usuário especificado na etapa 1, definindo o parâmetro USER no perfil de usuário e o parâmetro AUT para os seguintes valores: *READ e *EXECUTE.
  5. Utilize o comando GRTOBJAUT CL para conceder autoridade do objeto para a classe QWBISVR43 da biblioteca QWBISVR43 do perfil do usuário especificado na etapa 1, definindo o parâmetro USER no perfil de usuário e o parâmetro AUT para os seguintes valores: *READ e *EXECUTE.
  6. Utilize o comando CHGAUT CL para conceder autoridade de objeto para o diretório que contém o conector no IFS (Integrated File System) do perfil de usuário da etapa 1. Defina o parâmetro USER no perfil de usuário e o parâmetro DTAAUT para *RWX.
Documentação O guia Data Handler Guide faz referência de maneira incorreta e oferece documentação para a rotina de tratamento de dados do host. A rotina de tratamento de dados do host binário não está incluída no produto.
Documentação O guia do MetaSolv Adapter deve informar que o Metasolv Adapter agora suporta PSR (Product Service Request) e LSR (Local Service Request).
Documentação Em todos os guias, a seção "New in this release" deve conter o seguinte:

Além do suporte existente para Windows 2000, esse release inclui suporte para o InterChange Server Express nos seguintes sistemas operacionais:

  • IBM OS/400 V5R2, V5R3
  • Red Hat Enterprise AS Linux 3.0, Atualização 1
  • SuSE Linux Enterprise Server 8.1 com SP3
  • Microsoft Windows 2003
DB2(R) Enterprise no Windows 35380 O DB2 Enterprise não reinicia o gerenciador de banco de dados quando o Windows é reiniciado. Como o gerenciador de banco de dados não é executado, dois problemas podem ocorrer se o Windows for reiniciado durante a instalação do WebSphere Business Integration Server Express ou Express Plus:
  • A criação do repositório pode falhar. Quando isso ocorrer, o log do Instalador incluirá a seguinte linha de mensagem: Nenhum comando start do gerenciador de banco de dados foi emitido
  • 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 isso ocorrer, as mensagens do arquivo de log do InterchangeSystem incluirão a seguinte linha: Nenhum comando start do gerenciador de banco de dados foi emitido

Você pode tratar esses problemas executando as seguintes etapas:

  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.

Desinstaladores do DB2 Enterprise e do DB2 Express no Windows 35380 Se o DB2 Enterprise ou o DB2 Express e o WebSphere Business Integration Server Express (ou Express Plus) tiverem sido anteriormente instalados e desinstalados, a criação do repositório falha durante a instalação do WebSphere Business Integration Server Express ou Express Plus. Isso ocorre porque o processo de desinstalação do DB2 Enterprise e do DB2 Express não remove os aliases de bancos de dados do diretório C:\DB2\aliases_directory.

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.

Para solucionar esse problema, exclua manualmente o banco de dados SMB_DB antes de desinstalar e reinstalar o DB2 Enterprise ou o DB2 Express. A exclusão do banco de dados real elimina seu alias.

Instalador (Todos) 46851 O texto não resolvido de pacotes de recursos pode ser exibido na janela durante a transferência de arquivos. Mais especificamente, o seguinte pode ser exibido: $L(com.ibm.wbi.install.common.i18n.WBIProductResources, businessIntegrationServerExpressPlusProduct.displayName).

O que deve ser exibido é: WebSphere Business Integration Server Express Plus V4.3.1.
Instalador (Todos) 43593 O texto do título pode estar truncado nas caixas de diálogo da mensagem devido ao seu comprimento; no entanto, o conteúdo pretendido da mensagem é exibido.
Launchpad Antes de instalar os componentes DB2 Express ou WebSphere MQ, você deve desativar qualquer recurso de proteção de sistema de arquivos em tempo real do software anti-vírus instalado.

Se você tiver o software Norton AntiVirus instalado, pode desativar seu recurso de proteção de arquivos em tempo real parando o serviço do Windows Norton AntiVirus Client. Para outros produtos anti-vírus, consulte a documentação do produto para obter instruções de como desativar o recurso de proteção de sistema de arquivos em tempo real. Você pode ativar o software anti-vírus depois que os componentes DB2 Express ou WebSphere MQ estiverem instalados.

Launchpad 58560 O componente Toolset Express é instalado automaticamente quando o componente Samples está sendo instalado, mesmo se você apagar a caixa de opções ao lado de Ferramentas Administrativas e Ferramentas de Desenvolvimento. Isso ocorre porque a GUI do Launchpad não é atualizada corretamente para reconfigurar as caixas de opções.
Launchpad 35851 A instalação do DB2 Express ou do WebSphere MQ versão 5.3.0.2 com CSD 6 pode falhar quando instalado através da imagem eletrônica, se as imagens forem transferidas por download para um local com espaços.

Para solucionar esse problema, extraia as imagens eletrônicas para um local que não contenha espaços.

Launchpad 37017 Ao executar o Launchpad a partir de um CD, a tela inicial do Launchpad é interrompida na janela inicial. Algumas unidades de CD denominadas DVD Multi Player & Compact Disk Rewritable High Speed (a unidade tem que ser desses dois tipos) podem causar interrupção do CD do Express Plus durante a instalação e a tela inicial será interrompida indefinidamente.

Para solucionar esse problema, se possível, configure a unidade de CD para remover o recurso de alta velocidade durante a instalação. Se isso não for possível, execute a instalação a partir da imagem ESD (Electronic Software Delivery). Você também pode tentar copiar o conteúdo de todos os CDs para a unidade de disco rígido.
PTFs Requeridas para o OS/400 V5R2 O carregamento das seguintes PTFs é requerido em seu sistema OS/400 V5R2:
Número da PTF Produto Descrição
SI13693 5722SS1 Corrige o JDBC NullPointerException utilizando ResultSet.getObject()
SI07110 5722SS1 IBM Tivoli License Manager, suporte para agente do sistema
SI10105 5722SS1 IBM Tivoli License Manager, suporte para agente do sistema
SI10771 5722SS1 IBM Tivoli License Manager, suporte para agente do sistema
SI10904 5722SS1 IBM Tivoli License Manager, suporte para agente do sistema
PTFs Requeridas para o OS/400 V5R3 O carregamento das seguintes PTFs é requerido em seu sistema OS/400 V5R3:
Número da PTF Produto Descrição
SI13094 5722SS1 Corrige a análise Java do -Xbootclasspath na inicialização da JVM
SI14668 5722SS1 Corrige o JDBC NullPointerException utilizando ResultSet.getObject()
SI12116 5722SS1 IBM Tivoli License Manager, suporte para agente do sistema
System Monitor 43759 Se você estiver utilizando o Netscape 4.7x com idiomas de caracteres de byte duplo, os caracteres podem não ser exibidos no Netscape. Para configurar o Netscape para permitir que o caracteres de conjuntos de caracteres de byte duplo sejam exibidos, siga essas etapas:
  1. No menu View do Netscape, selecione Character Set > Unicode (UTF-8).
  2. No menu View, selecione Character Set > Set Default Character Set.
  3. Abra o menu Edit e 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.
System Monitor 43360 Se você criar uma visualização com mais de 20 monitores a partir da página Criar e Configurar Visualizações, pode encontrar uma exceção ao selecionar a visualização. Limite o número de monitores em uma visualização para menos de 20.
System Monitor 42481 O System Monitor suporta a execução do Web Application Server e do cliente no mesmo código do idioma. Se o servidor e o cliente estiverem em códigos do idioma diferentes, o texto será exibido em ambos os idiomas. Se não for possível executar o servidor no mesmo código do idioma do cliente, defina o código do idioma da JVM igual ao código do idioma do cliente, executando as seguintes etapas:
  1. A partir do WebSphere Application Server, inicie o WebSphere Application Server Administrator Console (para o Express, você deve ativar o aplicativo adminconsole):
  2. Vá para a Java Virtual Machine através do seguinte caminho:
    Servidores > Servidores de Aplicativos > ICSMonitor > Definição de Processo > Java Virtual Machine
  3. Inclua os seguintes argumentos nos argumentos de JVM genéricos:
    -Duser.language=language code -Duser.region=country code
    Substitua language code e country code por seus códigos de idioma e país específicos.
  4. Reinicie o servidor do monitor InterChange Server e defina o navegador cliente para o mesmo idioma utilizado na etapa anterior.
Servidor (Amostras) 43775 Há um erro no arquivo \mqseries\RemoteServerSample.mqsc.

Na expressão a seguir, o texto destacado está incorreto:
DEFINE CHANNEL(CH_ICS_TO_AGENT) CHLTYPE(SDR) TRPTYPE(TCP) REPLACE +
XMITQ(TO_AGENT) DESCR('Server to Agent') +
CONNAME('172.16.15.96(1415)')

A expressão deveria ser a seguinte (veja o texto destacado):
DEFINE CHANNEL(CH_ICS_TO_AGENT) CHLTYPE(SDR) TRPTYPE(TCP) REPLACE +
XMITQ(XMITQ_TO_AGENT) DESCR('Server to Agent') +
CONNAME('172.16.15.96(1415)')

Para solucionar esse problema, modifique o arquivo \mqseries\RemoteServerSample.mqsc após a instalação.
Ferramentas - Editor de Atividade 36145 A marcação de cores no editor de código Java(TM) do Editor de Atividades não manipula aspas dentro de cadeias; entretanto, isso não deve afetar a compilação.

Documentações

A documentação do produto não faz parte do pacote de produtos, por CD ou distribuição eletrônica de produtos. A documentação desse produto pode ser encontrada no IBM WebSphere Business Integration Server Express InfoCenter.

Os seguintes documentos podem ser encontrados nesse Web site:

Map Development Guide
Business Object Development Guide
Collaboration Development Guide
Data Handler Guide
Access Development Guide
WebSphere Business Integration Server Express Installation Guide for Windows
WebSphere Business Integration Server Express Installation Guide for Linux
WebSphere Business Integration Server Express Installation Guide for OS/400
Quick Start Guide
System Implementation Guide
System Administration Guide
Adapter for COM User Guide
Adapter for e-Mail User Guide
Adapter for Exchange User Guide
Adapter for iSeries User Guide
Adapter for JD Edwards OneWorld User Guide
Adapter for JDBC User Guide
Adapter for JMS User Guide
Adapter for JText User Guide
Adapter for Lotus Domino User Guide
Adapter for MetaSolv Applications User Guide
Adapter for mySAP.com (SAP R/3 V. 4.x) User Guide
Adapter for Oracle Applications User Guide
Adapter for PeopleSoft User Guide
Adapter for Portal Infranet User Guide
Adapter for Siebel eBusiness Applications User Guide
Adapter for SWIFT User Guide
Adapter for Telcordia User Guide
Adapter for Web Services User Guide
Adapter for WebSphere Commerce User Guide
Adapter for WebSphere MQ User Guide
Adapter for XML User Guide

Collaborations for Customer Relationship Management
Collaborations for Procurement
Collaborations for Financials and Human Resources
Collaborations for Order Management

Copyright IBM Corp. 2004