Documentação leia-me do IBM WebSphere Message Broker para Versão 8.0.0.0 do conjunto de ferramentas e componentes de tempo de execução.
Arquivo leia-me para: IBM WebSphere Message Broker
Release do produto/componente: 8.0
Data de publicação: 9 de dezembro de 2011
Data da última modificação: 9 de dezembro de 2011
Sempre use a versão mais recente deste
arquivo leia-me, que fica disponível apenas em inglês em:
http://www.ibm.com/support/docview.wss?uid=swg27006917
Arquivos leia-me
traduzidos ficam disponíveis em:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/
Para obter informações sobre as tarefas que você deve concluir antes de instalar o produto, consulte o centro de informações do WebSphere Message Broker V8.0 em:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp
Verifique os requisitos do sistema do WebSphere Message Broker para assegurar-se que a plataforma de instalação seja suportada para a edição do produto que você está planejando instalar. A página da Web dos requisitos do sistema do WebSphere Message Broker está disponível em:
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
Duas edições do WebSphere Message Broker V8.0 estão disponíveis no Windows:
A edição de 64 bits do WebSphere Message Broker não é suportada em todas as versões de 64 bits do Sistema Operacional Windows. Para obter mais informações, consulte a página da web de requisitos do sistema do WebSphere Message Broker.
Aplicando serviço ao z/OS
Se estiver aplicando o serviço ao z/OS, os pacotes Program Temporary Fix (PTF) devem ser transferidos por download como arquivos binários e depois transferidos para o z/OS:
Organização . . . : PS
Formato de registro . . . : FB
Duração de registro . . . : 1024
Tamanho de bloco . . . . : 6144
Primeiros rastreios de extensão. : 500
Segundos rastreios . : 50
Você pode utilizar a amostra Job Control Language (JCL) a seguir para alocar esses conjuntos de dados:
/* INSERT A VALID JOBCARD HERE
//*
//ALLOCATE EXEC PGM=IEFBR14
//SYSMOD1 DD DSN=YOUR HIGH LEVEL QUALIFIER (HLQ).PTF
NUMBER.TRS,
// DISP=(NEW,CATLG,DELETE),
// UNIT=SYSDA,
//SPACE=(TRK,(500,50),RLSE),
// DSORG=PS,
// DCB=(RECFM=FB,LRECL=1024,BLKSIZE=6144)
//*
put PTF NUMBER.TRS 'YOUR HLQ.PTF
NUMBER.TRS' (replace
Você pode utilizar a seguinte amostra JCL para descompactar os conjuntos de dados depois de ter feito as alterações e ter adicionado um cartão de tarefa apropriado:
//*****************************************************
//* UNTERSE APAR
//*****************************************************
/UNPACK EXEC PGM=TRSMAIN,PARM='UNPACK'
//STEPLIB DD DISP=SHR,DSN=TERSE.LOADLIB
//SYSPRINT DD SYSOUT=*
//INFILE DD DSN=YOUR HLQ.PTF NUMBER.TRS,
// DISP=SHR
//OUTFILE DD DSN=YOUR HLQ.PTF NUMBER,
// DISP=(NEW,CATLG),
// SPACE=(TRK,(1000,100,))
/*
Se você estiver migrando do WebSphere Message Broker Versão 6.1 ou Versão 7.0, consulte o centro de informações online em http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp, que fornece informações detalhadas sobre como migrar.
O centro de informações online do WebSphere Message Broker V8.0 está disponível em:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp
Sempre consulte o centro de informações on-line para obter as informações mais recentes. O centro de informações on-line contém informações mais novas do que o centro de informações enviado com o Message Broker Toolkit.
O centro de informações do WebSphere Message Broker para V8.0 GA contém a documentação para gravar e visualizar dados. No entanto, ele não contém informações sobre como reproduzi-los.
Um PDF foi fornecido com a documentação mais atualizada e abrangente sobre como gravar, visualizar e reproduzir dados. Para fazer o download do PDF, consulte a nota técnica em:
www.ibm.com/support/docview.wss?uid=swg21573603
O centro de informações independente
está disponível para download em:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V8.0/wmb_help_linux.tgz (versão Linux)
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V8.0/wmb_help_win.zip (versão Windows)
Leia o arquivo using_the_infocenter.html que está incluído na pasta ibm_help nos arquivos wmb_help_linux.tgz e wmb_help_win.zip.
Defeitos: Este arquivo leia-me pode conter referências aos números de defeitos. Esses números referem-se a números de problemas internos da IBM; você pode achar esses números úteis quando estiver discutindo problemas com o seu representante de serviços da IBM.
Notas Técnicas: Para obter informações atuais sobre problemas conhecidos e correções disponíveis, consulte o website de suporte do WebSphere Message Broker em:
http://www.ibm.com/support/entry/portal/Software/WebSphere/WebSphere_Message_Broker
Para localizar informações, clique em Resolução de Problemas. As notas técnicas do WebSphere Message Broker são exibidas e podem ser ordenadas e procuradas.
Para obter informações sobre como fazer o download das imagens de instalação do WebSphere Message Broker Versão V8.0 do website do Passport Advantage, consulte o documento de download Download WebSphere Message Broker V8.0 from the
Passport Advantage website, que está disponível em:
http://www.ibm.com/support/docview.wss?uid=swg24030968
Versões: Para obter as informações mais recentes sobre quais versões específicas do sistema operacional e bancos de dados são suportados pelo WebSphere Message Broker, consulte a página de requisitos do sistema em:
http://www.ibm.com/software/integration/wbimessagebroker/requirements/index.html
Verifique periodicamente as atualizações do WebSphere Message Broker Toolkit, incluindo atualizações de documentação em inglês e em outros idiomas suportados. Correções recomendadas para o WebSphere Message Broker podem ser localizadas em:
http://www.ibm.com/support/docview.wss?uid=swg27006041
Detalhes sobre o que há de novo na versão 8.0 podem ser localizados em:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp?topic=/com.ibm.etools.mft.doc/bb23110_.htm
Esta seção destaca os problemas conhecidos e suas soluções (se houver) do WebSphere Message Broker, por componente.
Sintomas:
Se você executar o programa de desinstalação uninstaller.exe do WebSphere Message Broker e estiver usando o Windows 7 ou o Windows Server 2008 R2, um diálogo poderá ser exibido avisando que o arquivo de desinstalação não está assinado.
Solução:
Esse aviso pode ser ignorado com segurança. Continue com o processo de desinstalação.
Sintomas:
Se estiver instalando um produto IBM usando uma imagem eletrônica a partir do IBM Passport Advantage e estiver usando o Windows XP Service Pack 2 ou mais recente, suas configurações de Segurança Windows podem fazer com que o Attachment Manager bloqueie o conteúdo do arquivo .zip do instalador, causando falha na sua instalação.
Solução:
Para obter uma solução alternativa para este problema, conclua as seguintes etapas:
Para obter informações adicionais sobre o Windows Attachment Manager, consulte o site de Suporte da Microsoft em: http://support.microsoft.com/kb/883260
A imagem de instalação do componente de tempo de execução WebSphere Message Broker V8.0 GA excedeu o limite de 700 MB recomendado para um CD físico. Por essa razão, a imagem de instalação da plataforma HP-UX é fornecida em um DVD físico em vez de um CD físico. A imagem de instalação do componente de tempo de execução WebSphere Message Broker V8.0 GA também está disponível a partir do website do Passport Advantage.
Para obter informações sobre como fazer o download das imagens de instalação do WebSphere Message Broker Versão V8.0 do website do Passport Advantage, consulte o documento de download Download WebSphere Message Broker V8.0 from the
Passport Advantage website, que está disponível em:
http://www.ibm.com/support/docview.wss?uid=swg24030968
O WebSphere Message Broker é suportado no Ubuntu, mas apenas para sistemas de desenvolvimento. Os sistemas de produção não devem ser usados para executar o WebSphere Message Broker no Ubuntu.
Para obter mais informações, consulte a página de requisitos do sistema do WebSphere Message Broker. A
página da Web dos requisitos do sistema do WebSphere Message Broker está disponível em:
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
Sintomas
Ao tentar conectar um nó que possua vários terminais de saída a outros nós, uma conexão não é criada.
Solução
Para solucionar esse problema, conclua uma das seguintes etapas:
Para conectar o WebSphere Message Broker Explorer a um gerenciador de filas para receber publicações, a propriedade SHARECNV no canal SVRCONN desse gerenciador de filas deve ter um valor maior que 0. Esse valor será necessário se você quiser usar as visualizações Estatísticas do Broker ou Gráfico de Estatísticas do Broker no WebSphere Message Broker Explorer.
Sintoma:
Ao migrar o WebSphere Message Broker Toolkit e seus recursos para V8.0, itens podem ser exibidos no WebSphere Message Broker Toolkit, que foram removidos na V8.0; por exemplo, as opções do kit de ferramentas anterior nos menus. Erros inexplicáveis também podem ser exibidos.
Solução:
Para resolver o problema, conclua as seguintes etapas:
Sintoma:
Quando você importa recursos em uma nova área de trabalho, podem ser exibidas mensagens de erro após a conclusão da autoconstrução.
Solução:
Na visualização Desenvolvimento do Broker, selecione seus projetos e clique com o botão direito em Projeto > Limpar para reconstruir projetos. Após os projetos estarem limpos, as mensagens de erro relativas à importação são removidas.
mqsicreatebar
pode exigir a limpeza do projetoSintoma:
Quando você executa o comando mqsicreatebar
e especifica uma nova área de trabalho, mensagens de erro podem ser exibidas.
Solução:
Use a opção -cleanBuild
quando executar o comando mqsicreatebar
para limpar os projetos.
Sintoma:
Ao usar o centro de informações que está incluído no WebSphere Message Broker Toolkit V8.0.0.0 GA, os tópicos Data Format Description Language (DFDL) são exibidos apenas em inglês dos Estados Unidos.
Esses tópicos possuem o identificador "dfxxxxx_", em que "xxxxx" é um número de cinco dígitos.
Solução:
Para visualizar esses tópicos em um idioma que não seja o inglês dos Estados Unidos, use o centro de informações online. O centro de informações online do WebSphere Message Broker V8.0 contém a documentação traduzida mais recente e está disponível em:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp
Sintomas:
Durante a descoberta iterativa do WebSphere Adapter para SAP Software Enterprise Metadata Discovery (EMD), o painel Configuração de Geração e Implementação de Serviço do assistente de Conexão do Adaptador é exibido e pode ser editado; entretanto, nenhuma informação de conexão do sistema do adaptador que você insere é salva no componente adaptador.
Solução:
Use o editor WebSphere Adapters para alterar as informações de conexão de sistema do adaptador para garantir que as descobertas iterativas do EMD subsequente preservem as informações de conexão de sistema do adaptador:
Sintomas:
O adaptador de entrada JDE falha ao ser implementado se a caixa de seleção entrega assegurada está selecionada no assistente do adaptador. O seguinte erro é emitido:
Uma tentativa de configurar a propriedade 'AssuredOnceDelivery' no componente do adaptador 'AssuredDeliveryMSApp.IBM WebSphere Adapter for JD Edwards EnterpriseOne' falhou porque a propriedade não é suportada.
Solução:
Essa funcionalidade não é suportada atualmente, e não deve ser usada no desenvolvimento do fluxo de mensagens.
Sintomas:
O uso de um mapeamento de dados gráficos para mapear dados de entrada que são recuperados de um banco de dados depende da configuração de nome do esquema padrão do seu servidor de banco de dados. O broker não fornece atualmente um recurso para substituir o nome de esquema do banco de dados que será usado nas instruções SQL emitidas no banco de dados. Atualmente, a instrução SQL emitida pelo mapeamento inclui apenas o nome do banco de dados e da tabela, mas não um nome de esquema. Como resultado, seu servidor de banco de dados usa o nome de esquema do banco de dados padrão para a identidade que o broker usou para se conectar a ele ao executar o mapeamento. A identidade da conexão que o broker usa é configurada em um serviço configurável JDBCProvider do broker. O serviço configurável JDBCProvider usado é selecionado pelo nome da origem de dados no mapeamento.
Se a tabela de banco de dados requerida não estiver disponível nesse esquema, a execução do mapeamento falhará com um erro de broker que contém códigos de erro específicos para seu servidor de banco de dados. Por exemplo:
BIP3947E: O processamento do mapeamento de QName '{maps}:RDB_Mapping' falhou com os seguintes detalhes:
'{Mensagem e códigos de erro de acesso de sua tabela de esquema de banco de dados específica}'
Solução:
Verifique se a tabela que está sendo selecionada a partir do mapeamento de dados gráficos está disponível no esquema configurado pelo seu servidor de banco de dados para a identidade de conexão com o banco de dados configurada no serviço configurável JDBCProvider. Restringe-se particularmente ao z/OS.
Sintomas:
Nos sistemas UNIX que usam Z shell (zsh) como o ambiente de shell, uma chamada para 'source {install path}/mqsiprofile' faz com que o shell saia. Devido ao comportamento padrão de zsh, o comando mqsiprofile verifica um número de argumento incorreto para determinar se ele é originado ou executado diretamente. O script mqsiprofile imprime então uma mensagem de aviso e chama a saída, mas zsh interpreta essa chamada como uma instrução para sair do shell atual.
Solução:
Para solucionar esse problema, conclua a seguinte etapa:
Sintoma:
O tópico an19545_ mqsiapplybaroverride do centro de informações descreve os parâmetros -k e -y para uso com aplicativos e bibliotecas. Usar esses parâmetros com o comando resulta no seguinte erro:
BIP1033E Parâmetros inválidos
Solução:
Estas opções não são suportadas com esse comando e não devem ser usadas.
Clientes usando bancos de dados do usuário em z/OS requerem o APAR PK99362 do DB2.
Transações globalmente coordenadas ('XA') não são suportadas.
Transações globalmente coordenadas ('XA') JDBC/XA são suportadas em DB2 e Oracle (exceto Oracle RAC) em todas as plataformas de broker exceto HP-UX em Itanium e z/OS.
ODBC XA e JDBC/XA não podem ser combinadas no mesmo intermediário.
Transações globalmente coordenadas ('XA') Informix não são suportadas.
Apenas DB2 e Microsoft SQL Server são suportados no Windows Server 2008 R2 e Windows 7 de 64 bits. Use as páginas de requisitos do sistema DB2 e Microsoft SQL Server para determinar as versões corretas de cada produto para usar com seu sistema.
A página da web de requisitos do sistema DB2 estão disponíveis em:
http://www.ibm.com/software/data/db2/linux-unix-windows/sysreqs.html
http://www.ibm.com/legal/copytrade.shtml
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. Entretanto, 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 lhe garante direito algum sobre tais patentes. Pedidos de licença devem ser enviados, por escrito, para:
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:
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 A ELAS NÃO SE LIMITANDO, AS GARANTIAS IMPLÍCITAS DE NÃO-INFRAÇÃO, COMERCIALIZAÇÃO 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, essa disposição pode não se aplicar ao Cliente.
Essas informações podem conter imprecisões técnicas ou erros tipográficos. São feitas alterações periódicas 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.
Qualquer referência nestas informações a websites não IBM é fornecida apenas para conveniência e não representa, de forma alguma, um endosso a esses websites. Os materiais nesses websites não fazem parte dos materiais desse produto IBM e o uso desses websites é 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:
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 nesta publicação e todo o material licenciado disponível são fornecidos pela IBM sob os termos do Contrato com o Cliente IBM, do Contrato Internacional de Licença do Programa 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 estes nomes são fictícios e qualquer semelhança com nomes e endereços utilizados por uma empresa real é mera coincidência.
LICENÇA DE DIREITOS AUTORAIS:
Estas informações contêm programas de aplicativos de exemplo na linguagem fonte, ilustrando as técnicas de programação em diversas plataformas operacionais. O Cliente 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. O Cliente 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.
Os termos a seguir são marcas registradas da International Business Machines Corporation
nos Estados Unidos e/ou em outros países:
DB2, developerWorks, IBM, Informix, Passport Advantage, WebSphere, z/OS.
Java e todas as marcas registradas e logotipos baseados em Java são marcas
registradas da Oracle e/ou de suas afiliadas 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.
UNIX é uma marca registrada da The Open Group nos Estados Unidos e em outros países.
Linux é uma marca registrada de Linus Torvalds 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ágina do produto WebSphere Message Broker
http://www.ibm.com/software/integration/wbimessagebroker/
Fix Packs do DB2
Se você tiver um contrato de suporte atual, poderá solicitar fix packs do DB2 em CD ligando para o suporte do DB2. Como alternativa, é possível fazer o download dos fix packs do DB2 na web, no entanto, alguns arquivos de fix pack são grandes e, portanto, solicitar versões em CD pode evitar downloads demorados.
Os detalhes do contato de suporte ao DB2 e os downloads de fix pack do DB2 estão disponíveis em:
http://www.ibm.com/software/data/db2/udb/support.html
Fix Packs do WebSphere MQ
http://www.ibm.com/support/entry/portal/Software/WebSphere/WebSphere_MQ
Fix Packs do WebSphere Message
Broker
http://www.ibm.com/support/docview.wss?uid=swg27006041
Requisitos do WebSphere Message Broker
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
Arquivo leia-me do WebSphere Message Broker
http://www.ibm.com/support/docview.wss?uid=swg27006917
Centro de informações independente do WebSphere Message Broker V8.0
Para Linux:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V8.0/wmb_help_linux.tgz
Para Windows:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V8.0/wmb_help_win.zip
Centro de informações online do WebSphere Message Broker V8.0
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp
Downloads do IBM Centre para Java™ Technology
Development
http://www.ibm.com/developerworks/java/jdk/
Especificação da Web Services Description Language (WSDL)
http://www.w3.org/TR/wsdl
Zona do WebSphere Message Broker do developerWorks
http://www.ibm.com/developerworks/websphere/zones/businessintegration/wmb.html