Os parâmetros que são fornecidos em XAOpenString são delimitados por vírgula e posicionais. Represente os parâmetros opcionais ausentes
com uma vírgula se tiver incluído outros parâmetros posteriormente na cadeia.
A seguinte entrada de
sub-rotina é um exemplo que você pode incluir ao utilizar WebSphere MQ Java
como o provedor JMS:
XAResourceManager:
Name=WBIWMQJMS
SwitchFile=/install_dir/lib/JMSSwitch.so
XAOpenString=<Depósito de Informações do Provedor de Contexto Inicial>,
<Local das Ligações JNDI>'
<Proprietário LDAP>,
<Credenciais LDAP>,
<Nome da Connection Factory de Recuperação>,
<Proprietário JMS>,
<Credenciais JMS>
ThreadOfControl=THREAD
em que:
- install_dir
- É o local da instalação do WebSphere Event
Broker.
Este valor é obrigatório onde os parâmetros LDAP são omitidos, mas uma Connection Factory
de fila definida pelo usuário é especificada para recuperação.
- <Depósito de Informações de Contexto Inicial>
- É o identificador do Depósito de Informações de Contexto Inicial para o provedor
JMS; esse valor é necessário.
- <Local das Ligações JNDI>
- É o caminho para o arquivo de ligações ou o local do diretório LDAP dos objetos
administrados por JNDI que podem ser utilizados para criar um depósito de informações de
contexto inicial para a conexão JMS. Ao fornecer o caminho de arquivo ao arquivo de ligações, não inclua o nome de arquivo.
Consulte o nó JMSInput or JMSOutput para obter detalhes adicionais sobre como criar os objetos administrados por JNDI; este valor é necessário.
- <Proprietário LDAP>
- É um parâmetro opcional utilizado para especificar o proprietário (ID do usuário) que
poderá ser necessário quando um banco de dados LDAP for utilizado para manter os objetos
administrados por JNDI.
- <Credenciais LDAP>
- É um parâmetro opcional utilizado para especificar as Credenciais (senha) que poderão
ser necessárias se um banco de dados LDAP protegido por senha for utilizado para manter
os objetos administrados por JNDI.
- <Nome do Connection Factory de Recuperação>
- É um parâmetro opcional utilizado para especificar o nome de um objeto do Connection
Factory de Fila nos objetos administrados por JNDI para fins de recuperação, quando o
nome não padrão é necessário.
- <Proprietário JMS>
- É um parâmetro opcional para o ID de usuário exigido para conectar-se a um provedor
JMS, utilizando um Connection Factory JMS seguro.
- <Credenciais JMS>
- É um parâmetro opcional para a senha exigida para conectar-se ao mesmo provedor JMS,
em conjunto com o proprietário JMS.
Os valores para o depósito de informações do provedor de Contexto Inicial e Local de
ligações JNDI na sub-rotina devem corresponder aos especificados nos nós JMSInput ou JMSOutput nos fluxos de mensagens.
Todos os parâmetros LDAP devem ser compatíveis com os valores especificados no comando mqsicreatebroker ou mqsichangebroker.
O nome do Depósito de Informações do Provedor de Recuperação deve corresponder ao nome de um Connection Factory de Fila criado nos objetos administrados por JNDI.
Se não for especificado um nome, será utilizado a fábrica padrão de recoverXAQCF. Em qualquer
caso, este valor deve referir-se a um objeto administrado por JNDI que já foi
criado.
O Proprietário JMS e as Credenciais JMS devem ser configurados
juntos.
O exemplo a seguir mostra o formato
de uma sub-rotina no arquivo
qm.ini que descreve um provedor
JMS para transações globais:
XAResourceManager:
Name=XAJMS_PROVIDER1
SwitchFile=/opt/var/mqsi/lib/JMSSwitch.so
XAOpenString= com.sun.jndi.fscontext.RefFSContextFactory,
/Bindings/JMSProvider1_Bindings_Directory,
,
,
,
myJMSuser1,
passwd
ThreadOfControl=THREAD
em que:
- XAJMS_PROVIDER1
- É o nome definido pelo usuário para o gerenciador de recursos
- /opt/var/mqsi
- É o <Caminho da Instalação>
- com.sun.jndi.fscontext.RefFSContextFactory
- É o <Depósito de Informações de Contexto Inicial>
- /Bindings/JMSProvider1_Bindings_Directory
- É o local das ligações
- myJMSuser1
- É o <Proprietário JMS>
- passwd
- É a senha utilizada nas <Credenciais JMS>
Neste exemplo, os campos opcionais
<Proprietário
do LDAP>,
<credenciais do LDAP> e
<Nome da Connection Factory de Recuperação> não são necessários, portanto, os delimitadores de vírgulas posicionais são configurados apenas
na sub-rotina
XAOpenString.