Los parámetros que están definidos en XAOpenString están
delimitados por comas y son posicionales. Representan parámetros
opcionales que faltan mediante una coma si incluye otros parámetros
más adelante en la serie.
La siguiente entrada de sección
es un ejemplo que puede añadir cuando utiliza Java de
WebSphere MQ como proveedor JMS:
XAResourceManager:
Name=WBIWMQJMS
SwitchFile=/dir_instalación/lib/JMSSwitch.so
XAOpenString=<Fábrica de contexto inicial>,
<ubicación de enlaces JNDI>'
<Principal LDAP>,
<Credenciales LDAP>,
<Nombre de fábrica de conexión de recuperación>,
<Principal JMS>,
<Credenciales JMS>
ThreadOfControl=THREAD
donde:
- dir_instalación
- Es la ubicación de la instalación de
WebSphere Event
Broker.
Este valor es obligatorio cuando se omiten los parámetros LDAP, pero
se especifica una Fábrica de conexión de colas definida por el usuario para recuperación.
- <Fábrica de contexto inicial>
- Es el identificador de Fábrica de contexto inicial para el proveedor
JMS; este valor es obligatorio.
- <Ubicación de enlaces JNDI>
- Es la vía de acceso al archivo de enlaces o la ubicación del
directorio LDAP de los objetos
administrados JNDI que se pueden utilizar para crear una fábrica de
contexto inicial para la conexión JMS. Cuando proporcione la vía de acceso al archivo de enlaces, no incluya el nombre de archivo. Consulte el nodo JMSInput o JMSOutput para obtener más información sobre cómo crear objetos administrados en JNDI; este valor es necesario.
- <Principal LDAP>
- Es un parámetro opcional utilizado para especificar el principal (ID de usuario) que puede ser
necesario cuando se utiliza una base de datos LDAP para que contenga los
objetos administrados JNDI.
- <Credenciales LDAP>
- Es un parámetro opcional utilizado para especificar las Credenciales (contraseña) que se
pueden necesitar si se utiliza una base de datos LDAP protegida por
contraseña para que contenga los objetos administrados JNDI.
- <Nombre de fábrica de conexión de recuperación>
- Es un parámetro opcional que se utiliza para
especificar el nombre de un objeto de Fábrica de conexión de colas en
los objetos administrados JNDI para la recuperación, cuando se necesita el
nombre que no sea el valor predeterminado.
- <Principal JMS>
- Es un parámetro opcional para el ID de usuario necesario para conectar
a un proveedor JMS, utilizando una fábrica de conexión JMS segura.
- <Credenciales JMS>
- Es un parámetro opcional para la contraseña necesaria para conectar
al mismo proveedor JMS, junto con el principal JMS.
Los valores
para la Fábrica de contexto inicial y la Ubicación de los
enlaces JNDI de la sección deben coincidir con los valores especificados
en los nodos JMSInput o
JMSOutput en los flujos de mensajes.
Todos los parámetros LDAP deben coincidir con los valores
que ha especificado en el mandato
mqsicreatebroker o
mqsichangebroker.
El Nombre de fábrica de recuperación debe coincidir con un nombre de Fábrica de conexión
de colas creado en los objetos administrados JNDI. Si no especifica ningún
nombre, se utiliza una fábrica predeterminada denominada
recoverXAQCF. En cualquier caso, este valor debe hacer referencia a un objeto administrado JNDI que ya se haya creado.
El principal JMS y las credenciales JMS deben configurarse juntos.
En el siguiente ejemplo se muestra el formato de una sección en el archivo
qm.ini que describe un proveedor JMS para transacciones globales:
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
donde:
- XAJMS_PROVIDER1
- Es el nombre definido por el usuario para el gestor de recursos
- /opt/var/mqsi
- Es la <Vía de acceso de instalación>
- com.sun.jndi.fscontext.RefFSContextFactory
- Es la <Fábrica de contexto inicial>
- /Bindings/JMSProvider1_Bindings_Directory
- Es la ubicación de los enlaces
- myJMSuser1
- Es el <Principal JMS>
- passwd
- Es la contraseña utilizada en <Credenciales JMS>
En este ejemplo, los campos opcionales
<LDAP Principal>,
<Credenciales LDAP>y
<Nombre de fábrica de conexión de recuperación> no son necesarios, por lo que sólo están configurados los delimitadores de coma posicionales en la sección
XAOpenString.