Para incluir nós que usam o transporte JMS, como os nós JMS e SOAP, em transações coordenadas
por XA, você deve concluir a configuração adicional.
Se você requer coordenação de transação, escolha um provedor JMS de acordo com o Java™ Message
Service Specification, versão 1.1 e que suporte
JMS XAResource API através da sessão JMS.
Se você especificar seu próprio provedor JMS usando o serviço configurável
JMSProviders, configure o atributo jmsProviderXASupport
como true para indicar que o provedor JMS selecionado suporte transações
coordenadas por XA. Se você configurar essa propriedade como true e o provedor JMS
selecionado não suportar transações XA, será levantada uma exceção.
Se você configurar essa propriedade como false, mas a propriedade Modo de transação no
nó estiver configurada como Sim e
a propriedade do fluxo de mensagens Transação Coordenada
estiver selecionada, uma exceção será levantada.
Se o designer de mensagens tiver especificado um provedor que não esteja em conformidade com
um XA, somente o modo não transacional será suportado. Nesse caso, você deve configurar a
propriedade Modo de Transação como
Nenhum para todos os nós JMS
e SOAP que usam o transporte JMS.
Para configurar o nodes:
- Alterne para o Perspectiva do Desenvolvimento de Aplicativos do Intermediário.
- Configure a propriedade do fluxo de mensagens Transação Coordenada para yes nas propriedades do arquivo BAR.
- Para cada nó que usa o transporte JMS necessário
na transação coordenada por XA, configure a propriedade Modo de Transação como Sim no editor de fluxo
de mensagens.
- Crie um Factory de Conexão da Fila e use o nome padrão, recoverXAQCF, ou forneça seu próprio nome. Consulte o nó JMSInput ou JMSOutput para obter detalhes adicionais sobre como criar objetos administrados por JNDI.
- Nos sistemas distribuídos, é necessário configurar uma sub-rotina para cada provedor
JMS que você deseja usar, antes da implementação.
A tabela a seguir mostra os arquivos de alternância de provedor JMS que são
fornecidos em cada sistema operacional.
Plataforma |
Arquivo de 32 bits |
Arquivo de 64 bits |
AIX
|
|
libJMSSwitch.so |
HP-Itanium
|
|
libJMSSwitch.so |
Linux em POWER
|
|
libJMSSwitch.so |
Linux em System
z
|
|
libJMSSwitch.so |
Linux em x86
|
libJMSSwitch.so |
|
Linux em
x86-64
|
|
libJMSSwitch.so |
Solaris em SPARC
|
|
libJMSSwitch.so |
Solaris
em x86-64
|
|
libJMSSwitch.so |
Windows em x86
|
JMSSwitch.dll |
|
Windows em x86-64
|
JMSSwitch32.dll |
JMSSwitch.dll |
Selecione o link apropriado para obter detalhes dessa tarefa no sistema operacional,
ou sistemas, que sua empresa usa:
Para obter
informações adicionais, consulte os tópicos a seguir:
No z/OS, o único provedor JMS que
é suportado é o IBM®
WebSphere MQ Java
Client, e o único modo de transporte suportado para esse cliente é o modo BIND; nenhuma
etapa de configuração adicional é necessária.
O provedor JMS poderá fornecer arquivos JAR adicionais que
são necessários para suporte transacional; para obter mais informações, consulte a
documentação fornecida com o provedor JMS. Por exemplo, nos sistemas distribuídos, o
provedor JMS do
WebSphere MQ fornece um arquivo JAR extra,
com.ibm.mqetclient.jar.
É necessário incluir arquivos JAR adicionais ao diretório do broker shared_classes:

No Linux and UNIX: var/mqsi/shared-classes.
No Windows, %ALLUSERSPROFILE%\Application
Data\IBM\MQSI\shared-classes, em que %ALLUSERSPROFILE% é a
variável de ambiente que define o diretório ativo do sistema.
O diretório padrão depende
do sistema operacional.- No Windows XP e
Windows Server 2003: C:\Documents and
Settings\All Users\IBM\MQSI\shared-classes
- No Windows Server 2008: C:\ProgramData\IBM\MQSI\shared-classes
Seu computador não pode usar o valor padrão; use %ALLUSERSPROFILE% para assegurar que tenha acessado o local correto.
Para obter mais informações,
consulte a seção sobre como tornar o cliente do provedor JMS disponível aos nós JMS em
Nó JMSInput.
Opcional: Para proteger o connection
factory JMS e/ou as ligações JNDI, consulte Protegendo Conexões JMS e Consultas de JNDI.