IBM^(R) WebSphere^(R) Business Integration Message Brokers Toolkit Versão 5.1

Alterar histórico:
GA: 23 de julho de 2004
Atualizado: 20 de Agosto de 2004
Atualizado: 20 de Outubro de 2004
Atualizado: 17 de Dezembro de 2004
Fix Pack 5: 09 de Fevereiro de 2005

(C) Copyright IBM Corporation 2004, 2005. Todos os direitos reservados.

Bem-vindo ao IBM WebSphere Business Integration Message Brokers Toolkit Versão 5.1.

Este arquivo leia-me aplica-se somente à instalação do Message Brokers Toolkit Versão 5.1 no Microsoft^(R) Windows^(R) e sua utilização com o WebSphere Business Integration Message Broker e WebSphere Business Integration Event Broker Versão 5.0. Ele descreve problemas conhecidos e contém atualizações de documentos que não foram disponibilizados a tempo para serem incluídos no centro de informações on-line. Você também deve ler o arquivo leia-me do IBM WebSphere Business Integration Message Brokers Versão 5.0 para obter informações adicionais sobre o produto.

AVISO!
Instale o Message Brokers Toolkit Versão 5.1 somente se você já tiver instalado o WebSphere Application Development Integration Edition Versão 5.1. Não instale a Versão 5.1 caso você possua um nível anterior do WebSphere Studio Application Developer Integration Edition; para esse você deve utilizar o Message Brokers Toolkit Versão 5.0, que é fornecido com o WebSphere Business Integration Message Broker e o WebSphere Business Integration Event Broker Versão 5.0. O Message Brokers Toolkit Versão 5.1 possui função idêntica à do Message Brokers Toolkit Versão 5.0.

Instalando o Message Brokers Toolkit Versão 5.1 em um ambiente da equipe
O WebSphere Studio Application Developer Integration Edition Versão 5.1 não é um pré-requisito para todas as instalações do Message Brokers Toolkit Versão 5.1. No entanto, se pelo menos uma de suas instalações do Message Broker Toolkit integrar-se ao WebSphere Studio Application Developer Integration Edition Versão 5.1, todas as suas instalações do Message Broker Toolkit deverão estar na Versão 5.1 para garantir o compartilhamento e a integridade dos dados.

Se você não estiver utilizando o WebSphere Studio Application Developer Integration Edition Versão 5.1 em nenhum sistema ou se estiver utilizando o WebSphere Studio Application Developer Integration Edition Versão 5.0, será preciso instalar o Message Brokers Toolkit Versão 5.0.

CVS compatibility
The Message Brokers Toolkit Version 5.1 is based on Eclipse 2.1.2, and uses CVS client plugin version 2.1.1. For this version, your CVS server must be at version 1.11.6 or earlier (Linux and UNIX only, CVSNT is not supported).

Informações Essenciais para Todos os Usuários

Versões traduzidas do arquivo leia-me e do arquivo install.html estão disponíveis em: ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling

Versões traduzidas do centro de informações não estão incluídas neste pacote. Todos os fragmentos do idioma nacional no centro de informações estão vazios e todas as informações estão exibidas em Inglês. Se quiser exibir o centro de informações em um idioma suportado que não seja o Inglês Americano, faça o download do recurso Eclipse apropriado após ter instalado o fix pack. As traduções serão disponibilizadas no momento em que o fix pack for disponibilizado ou logo depois. Para obter instruções sobre como fazer o download dessas atualizações, consulte Atualizações de recurso.

Informações Essenciais se Você Estiver Migrando

Se você estiver migrando, consulte o arquivo install.html para obter detalhes das ações que deverão ser tomadas antes da instalação.

Se quiser instalar o Message Brokers Toolkit Versão 5.1 em um sistema no qual o Message Brokers Toolkit Versão 5.0 já está instalado, você precisará desinstalar primeiro a Versão 5.0 Toolkit; as duas versões não podem coexistir.

O centro de informações fornece informações adicionais sobre migração; para visualizá-las antes da instalação, faça o download da versão independente do centro de informações (consulte Documentação para conhecer as instruções).

Você deve estar ciente dessas relações de migração e implementação:

• Quando você cria ou modifica fluxos de mensagens, conjuntos de mensagens e mapeamentos de mensagens no kit de ferramentas da Versão 5.1, não poderá mais acessar tais recursos em um kit de ferramentas da Versão 5.0. Assegure-se de que todos os usuários que compartilham projetos em um ambiente de equipe estão cientes dessa restrição e faça cópias de backup, se necessário.
• Você deve obter uma versão migrada de todos os plug-ins de nó definidos pelo usuário do fornecedor antes de implementar com êxito os fluxos de mensagens que os contém.

Você pode compartilhar recursos entre versões em sistemas diferentes:

• Você pode implementar qualquer projeto desenvolvido na Versão 5.0 sem a necessidade de alterá-los.
• Você pode importar arquivos de archive do intermediário criados nesta versão para um espaço de trabalho da Versão 5.0 e implementá-los com êxito.

Documentação

Suporte

Atualizações de Recurso

1. No kit de ferramentas, selecione Ajuda > Atualizações de Software > Novas Atualizações. O Eclipse, em seguida, procura as atualizações disponíveis.
2. O Eclipse exibe quais atualizações estão disponíveis. Selecione as atualizações que você deseja instalar.
3. Ao selecionar as atualizações a serem instaladas, você receberá um aviso de que os recursos não foram marcados digitalmente. Você pode ignorar esse aviso.
4. Após instalar os recursos, o Eclipse solicita que você inicie novamente o workbench.
5. Após reiniciar o workbench, os novos recursos estão instalados e prontos para serem utilizados.

Índice

Restrições e Limitações:

• WebSphere Studio Application Developer Integration Edition
• Coexistência
• Instalação
• Após a Instalação

Avisos e Marcas Registradas

Páginas da Web Úteis

Restrições e Limitações

Esta seção destaca, por componente, as restrições e limitações do WebSphere Business Integration Message Broker e do WebSphere Business Integration Event Broker.

WebSphere Studio Application Developer Integration Edition

Para estender um workbench do WebSphere Studio Application Developer Integration Edition com este produto, você deve fazer upgrade do WebSphere Studio Application Developer Integration Edition para o nível apropriado suportado. A versão do workbench do WebSphere Studio Application Developer Integration Edition que pode ser estendida é WebSphere Studio Application Developer Integration Edition Versão 5.1 GA com "Interim Fix 002 - General Fixes 2.0.0". Versões anteriores do WebSphere Studio Application Developer Integration Edition 5.1 não são suportadas.

Você também deve aplicar a correção "WebSphere Business Integration Message Broker v5.1.5 Interim Fix 001 - Prerequisite Fixes 1.0.0.1" após ter instalado o WebSphere Business Integration Message Broker ou o WebSphere Business Integration Event Broker.

Para obter instruções detalhadas, consulte o arquivo install.html.

Coexistência

• Você pode implementar qualquer projeto desenvolvido na Versão 5.0 sem a necessidade de alterá-los.
• Você pode importar arquivos de archive do intermediário criados nesta versão para um espaço de trabalho da Versão 5.0 e implementá-los com êxito.

Instalação

1. Defeito 34320
   Durante a instalação, se você optar por NÃO aceitar o Acordo de Licença, aparecerá um pop-up com os botões SIM e NÃO. Independente do botão que selecionar, você retornará à página do Acordo de Licença. Clicar em SIM pode ter causado o cancelamento da instalação e o fechamento da barra de ativação.

   Além disso, se durante a instalação você clicar em VOLTAR na página do Acordo de Licença, várias mensagens de erro JVM (Java^TM Virtual Machine) ocorrerão e a Barra de Lançamento travará.

   Solução: Aceite o Acordo de Licença se você quiser instalar o produto com sucesso.

2. Defeito 37122
   Um erro no Installshield faz com que os arquivos de resposta utilizados em uma instalação silenciosa sejam interpretados incorretamente. Para evitar esse problema, execute as seguintes ações:
   • Crie um arquivo de resposta, conforme mostrado abaixo.
   • Configure installLocation em seu diretório de instalação escolhido
   • Configure o componente a ser instalado para verdadeiro, conforme descrito na linha de comentário.

   O exemplo abaixo instala a barra de ferramentas no local C:\Arquivos de programas\IBM\WBIMB.

   ---start of response file---------
   
   -P installLocation="C:\Program Files\IBM\WBIMB"
   -W setupTypes.selectedSetupTypeId=custom
   
   ###############################################################################
   #
   # User Input Field - suiteFeatures
   #
   #
   
   #Do not change this - it sets the installer to ignore the standard custom setup route
   -W featureSelectionIB.active=false
   
   #Set a value to true to install that component
   # If any of the Broker, UNS or Config Manager parameters are set to true, 
   # the core value must also be set to true.  
   # Otherwise set this should be set to false to avoid installing most of the product.
   
   -W enableCore.value=true
   -W setCustomSuiteBrokerFeatureTrue.propertyValue=false
   -W setCustomSuiteUNSFeatureTrue.propertyValue=false
   -W setCustomSuiteConfigMgrFeatureTrue.propertyValue=false
   
   #Set to true if the Message Broker extension features are required.
   #The broker and core features must also be set to true to install this
   
   -W setCustomMessageTrue.value=false
   
   #Set to true if the tooling is required
   -W setCustomToolingTrue.value=true
   
   ------ end of response file----------
   

Após a Instalação

1. Se você instalou o Message Brokers Toolkit Versão 5.1 e substituiu a Versão 5.0:
   1. Defeito 34555
      Você deve reconstruir todos os projetos definidos em seu espaço de trabalho.
   2. Defeito 34930
      Se o INSTALL_PATH\eclipse\workspace\.metadata existir, você poderá pensar que ao abrir o Message Brokers Toolkit, o Update Manager será ativado corretamente, mas todas as atualizações em seus plug-ins falharão. Como resultado disso, o Message Brokers Toolkit não abrirá com os níveis corretos de plug-in e poderão ocorrer falhas do kit de ferramentas.
      
      Por exemplo, quando você está no Broker Application Development Perspective, pode ver que o item de menu Arquivo de Definição de Mensagem está faltando na lista produzida por Arquivo > Novo Menu. Esta é uma indicação de que a instalação não contém o nível ou a versão corretos de plug-ins para o Message Brokers Toolkit.
      
      Você pode verificar se os níveis de plug-ins que está utilizando estão corretos clicando em Ajuda > Sobre o Message Brokers Toolkit para WebSphere Studio - Message Broker na janela do Message Brokers Toolkit para WebSphere Studio. Sob o título "Message Brokers Toolkit para WebSphere Studio", o número de uma versão é exibido. Se as versões corretas dos plug-ins estão sendo utilizadas após a instalação da Versão 5.1, a versão exibida é a 5.1.0. Se a versão exibida for menor que esta:
      1. Exclua o diretório .metadata.
      2. Abra novamente o Message Brokers Toolkit.
      3. Importe novamente seus projetos existentes para o espaço de trabalho fazendo o seguinte para cada projeto:
         1. Clique em Arquivo> Importar.
         2. Quando o Assistente de Importação aparecer, selecione Projeto Existente no Espaço de Trabalho e clique em Avançar.
         3. Clique em Procurar e defina o local do projeto no espaço de trabalho.
         4. Clique em Concluir.
2. Defeito 32898
   Se suas definições de LAN não estiverem configuradas corretamente para o acesso do host local, talvez devido às definições no script de configuração automática, pode ocorrer uma das alternativas a seguir:
   • O navegador de ajuda abre em uma página em branco.
   • O navegador de ajuda exibe um erro HTTP em vez de uma página de ajuda.
   • Há grandes retardos quando o centro de informações estiver carregado.
   
   Solução: O administrador do sistema pode configurar as definições de LAN para que os documentos de ajuda possam ser acessados com êxito a partir do servidor de ajuda local fazendo o seguinte:
   1. No Painel de Controle, abra Opções de Internet, selecione a guia Conexões e escolha Definições de LAN.
   2. Se o host for configurado para utilizar DHCP para a atribuição de IP, certifique-se de que a caixa de opções Detectar definições automaticamente esteja limpa.
   3. Se utilizar o servidor proxy, certifique-se de que Ignorar servidor proxy para endereços locais esteja selecionado.
   4. Nas definições Avançadas para os proxies, inclua '127.0.0.1;localhost' nas Exceções se este endereço não estiver listado.
   5. Se você estiver utilizando um script de configuração automática para definições de proxy e não tiver certeza se o script está correto, limpe a caixa de opções Utilizar script de configuração automática.
   
   Se as etapas acima não corrigirem o problema, tente alterar as propriedades da porta e do host em org.eclipse.tomcat\preferences.ini. Definir host=localhost ou host=127.0.0.1 deve funcionar. Se estiver executando um firewall, poderá também ser necessário definir port=80 (ou algum outro valor favorável ao firewall).
3. Defeito T32243
   A extensão de arquivo mxsd não está associada corretamente com o Message Definition Editor. Para garantir que os arquivos mxsd sejam abertos no Message Definition Editor como a ação padrão, selecione Janela > Preferências > Workbench > Associações de Arquivo. Role para baixo a lista de tipos de arquivo e selecione *.mxsd. Em seguida selecione Message Definition Editor na lista de editores Associados. Clique em Padrão e depois em OK.
4. Defeito 36638
   O tópico Message Set Editor Preferences (ad15810_) descreve somente as opções disponíveis na Versão 5.0 toolkit. As opções da Versão 5.0 não estão disponíveis para a Versão 5.1. No Versão 5.1 toolkit, as opções são:
   • Configurações do editor de conjunto de mensagem, Definição de visualização de esboço. Essas opções são exibidas mas não são operacionais:
     • Grupo por espaço de nomes e depois por coletas
     • Grupo por coletas e depois por espaço de nomes
   • Configurações do editor de definição de mensagem:
     • Mostrar tipos complexos de base
       Se você tiver definido um ou mais tipos complexos baseados em outros tipos complexos, selecione esta opção se quiser que o conteúdo desses tipos complexos de base sejam exibidos na visão geral do editor de definição de mensagem e nas visualizações de esboço (selecionado por padrão).
       Se não quiser exibi-los, limpe a caixa de opções.
5. Defeito 36655
   Se você desinstalar o toolkit chamando o uninstaller.exe com a opção -silent, o programa de desinstalação retorna ao controle imediatamente e é executado como uma tarefa de segundo plano. Se você não quiser que o programa de desinstalação retorne até que seja concluído, chame o uninstaller no java utilizando este comando:
   java -cp <diretório_de_instalação>\_uninst\studio\uninstall.jar run -silent
   em que <diretório_de_instalação> é o diretório no qual você instalou o produto.
   Se não tiver um jvm configurado (Versão 1.3.1 ou superior), você pode utilizar o jvm no produto instalado no diretório <diretório_de_instalação>\_sjvm\bin\. Se fizer isso, talvez você tenha que excluir esse diretório manualmente quando a desinstalação for concluída.
6. Defeito 37671
   Importando copybooks do COBOL: quando você importar um copybook do COBOL para ocupar um arquivo de definição de conjunto de mensagem, verifique se o copybook contém pelo menos 01 estrutura de nível. Se não houver nenhuma estrutura de nível, nenhum objeto (elementos, grupos, tipos) será importado.
7. Database Views definitions are not supported in the ESQL editor. References to database views in the ESQL code (instead of to schemas or tables) are flagged as warnings (unresolved reference) in the ESQL editor. These warnings do not prevent you from deploying the corresponding ESQL.
   These unresolved reference warnings might also appear when you have migrated a Version 2.1 message flow, because the 5.0 ESQL editor validates database references.
   References to database tables and schemas only are supported.
8. ESQL compilation restriction: if you create a subflow, and choose to distribute this as a plug-in project, calls to ESQL global routines within the subflow might not be generated correctly when you add a message flow that contains the subflow to a BAR file. When you deploy the BAR file, it will fail.
   Workaround: Implement one of the following options:
   • Include all routines at module-level within the subflow.
   • Add the subflows to your workspace, and update the project that contains the calling message flow to reference the subflow project (or projects).

Avisos

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 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. No entanto, 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 publicaçã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 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, esta disposição pode não se aplicar ao Cliente.

Estas informações podem conter 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 deste 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 qualquer outro contrato equivalente.

As informações relativas a 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 seu desempenho, compatibilidade nem 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.

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 esses nomes são fictícios e qualquer semelhança com os 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. Você pode copiar, modificar e distribuir estes programas de exemplo de qualquer maneira sem pagamento à IBM, com objetivos de desenvolvimento, utilização, marketing ou distribuição de programas aplicativos em conformidade com interfaces de programação de aplicativos da IBM.

Marcas Registradas

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

IBM WebSphere.

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.

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

Outros nomes de empresas, produtos e serviços podem ser marcas registradas ou marcas de serviço de terceiros.

Páginas da Web Úteis

Fix Packs do WebSphere Business Integration Message Broker e do WebSphere Business Integration Event Broker
http://www.ibm.com/software/integration/mqfamily/support/summary/wbib.html

WebSphere Business Integration Message Broker Requirements
http://www.ibm.com/software/integration/wbimessagebroker/requirements/

WebSphere Business Integration Event Broker Requirements
http://www.ibm.com/software/integration/wbieventbroker/requirements/

WebSphere Business Integration Message Broker e WebSphere Business Integration Event Broker Install.html
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/

Arquivos Leia-me do WebSphere Business Integration Message Broker e WebSphere Business Integration Event Broker
http://www.ibm.com/software/integration/mqfamily/support/readme/

Centro de Informações Independente do WebSphere Business Integration Message Broker
http://www.ibm.com/software/integration/wbimessagebroker/library/

Centro de Informações Independente do WebSphere Business Integration Event Broker
http://www.ibm.com/software/integration/wbieventbroker/library/