Configuración del concentrador para el protocolo de transporte JMS

En este apartado se describe cómo configurar el concentrador para que utilice el transporte JMS. Si va a utilizar el transporte JMS para enviar documentos desde el concentrador o para recibir documentos en este, siga los procedimientos descritos en este apartado. Si no tiene pensado utilizar el transporte JMS, omita este apartado.

Nota: los procedimientos de este apartado describen cómo utilizar la implementación de JMS de WebSphere MQ para configurar el entorno JMS. Los procedimientos también describen cómo configurar colas locales. Si desea configurar colas de transmisión y remotas, consulte la documentación de WebSphere MQ.

Más adelante, en otros apartados, aprenderá a configurar pasarelas o destinos JMS (o ambos). Estas tareas se describen en los apartados Configuración de un destino JMS y Configuración de una pasarela JMS.

Creación de un directorio para JMS

En primer lugar, debe crear un directorio para JMS. Por ejemplo, supongamos que deseara crear un directorio denominado JMS en el directorio c:\temp de una instalación Windows. Los pasos que debe seguir son los siguientes:

  1. Abra el Explorador de Windows.
  2. Abra el directorio C:\temp.
  3. Cree una nueva carpeta denominada JMS.

Modificación de la configuración JMS predeterminada

En este apartado, se actualiza el archivo JMSAdmin.config, que forma parte de la instalación de WebSphere MQ, para cambiar el URL del proveedor y de la fábrica de contexto.

  1. Vaya al directorio Java\bin de WebSphere MQ. Por ejemplo, en una instalación Windows, debe ir a: C:\IBM\MQ\Java\bin
  2. Abra el archivo JMSAdmin.config con un editor de texto plano, como el Bloc de notas de Windows o vi.
  3. Añada el carácter # al inicio de las líneas siguientes:
    INITIAL_CONTEXT_FACTORY=com.sun.jndi.ldap.LdapCtxFactory
     PROVIDER_URL=ldap://polaris/o=ibm,c=us
  4. Elimine el carácter # del inicio de las líneas siguientes:
    #INITIAL_CONTEXT_FACTORY=com.sun.jndi.fscontext.RefFSContextFactory 
     #PROVIDER_URL=file:/C:/JNDI-Directory
  5. Cambie la línea PROVIDER_URL=file:/C:/JNDI-Directory para que indique el nombre del directorio JMS que haya configurado en el apartado Creación de un directorio para JMS. Por ejemplo, si configura el directorio c:/temp/JMS, la línea se parecería a la siguiente:
    PROVIDER_URL=file:/c:/temp/JMS
  6. Guarde el archivo.

Creación de colas y del canal

En esta sección, WebSphere MQ se utiliza para crear colas que se emplearán para enviar y recibir documentos y el canal para esta comunicación. Se supone que se ha creado un gestor de colas. El nombre del gestor de colas debe indicarse donde aparece <nombre_gestor_colas> en los pasos siguientes. También se da por supuesto que se ha iniciado un receptor para este gestor de colas en el puerto TCP 1414.

  1. Abra un indicador de línea de mandatos.
  2. Especifique el mandato siguiente para iniciar el servidor de mandatos de WebSphere MQ:
    strmqcsv <nombre_gestor_colas>
  3. Especifique el mandato siguiente para iniciar el entorno de mandatos de WebSphere MQ:
    runmqsc <nombre_gestor_colas>
  4. Especifique el mandato siguiente para crear una cola WebSphere MQ que se utilizará para los documentos entrantes enviados al concentrador:
    def ql(<nombre_cola>)

    Por ejemplo, para crear una cola denominada JMSIN, debe especificar:

    def ql(JMSIN)
  5. Especifique el mandato siguiente para crear una cola WebSphere MQ que se utilizará para los documentos enviados desde el concentrador:
    def ql(<nombre_cola>)

    Por ejemplo, para crear una cola denominada JMSOUT, debe especificar:

    def ql(JMSOUT)
  6. Especifique el siguiente mandato para crear un canal de WebSphere MQ que se utilizará para los documentos entrantes y salientes enviados al concentrador:
    def channel(<nombre_canal1>) CHLTYPE(SVRCONN)

    Por ejemplo, para crear un canal denominado canal.java, debe especificar:

    def channel(canal.java) CHLTYPE(SVRCONN)
  7. Especifique el mandato siguiente para salir del entorno de mandatos de WebSphere MQ:
    end

Adición de un tiempo de ejecución Java(TM) a su entorno

Especifique el mandato siguiente para añadir un tiempo de ejecución Java a la vía de acceso del sistema:

set PATH=%PATH%;<DirProducto>\_jvm\jre\bin 

donde DirProducto se refiere al directorio en el que se ha instalado WebSphere Partner Gateway.

Definición de la configuración JMS

Para definir la configuración de JMS, realice los pasos siguientes:

  1. Vaya al directorio Java de WebSphere MQ (directorio <vía_acceso_directorio_instalación_Websphere_MQ>\java\bin)
  2. Inicie la aplicación JMSAdmin especificando el mandato siguiente:
    JMSAdmin
  3. Defina un nuevo contexto JMS especificando los mandatos siguientes desde el indicador InitCtx>:
    define ctx(<nombre_contexto>)
    change ctx(<nombre_contexto>)

    Por ejemplo, si el nombre_contexto es JMS, los mandatos son parecidos al siguiente:

    define ctx(JMS)

    change ctx(JMS) 
  4. Desde el indicador InitCtx/jms>, especifique la siguiente configuración de JMS:
    define qcf(nombre_fábrica_conexiones)
         tran(CLIENT) 
         host(<su_dirección_IP>) 
         port(1414) 
         chan(java.channel) 
         qmgr(<nombre_gestor_colas>)
    define q(<nombre>) queue(<nombre_cola>) qmgr(<nombre_gestor_colas>)
    define q(<nombre>) queue(<nombre_cola>) qmgr(<nombre_gestor_colas>)
    end

En los pasos anteriores se ha creado el archivo .bindings, que se encuentra en una subcarpeta de la carpeta especificada en el paso 5. El nombre de la subcarpeta es el nombre especificado para el contexto JMS.

A modo de ejemplo mostramos la siguiente sesión JMSAdmin que se utiliza para definir la fábrica de conexiones de cola como Hub, con la dirección IP sample.ibm.com donde reside el gestor de colas MQ (<nombre_gestor_colas> de sample.queue.manager). El ejemplo utiliza los nombres de cola de JMS y el nombre de canal que se creó en el apartado Creación de colas y del canal. Observe que la entrada del usuario sigue a la solicitud del >.

InitCtx> define ctx(jms)
 InitCtx> change ctx(jms) 
 InitCtx/jms> define qcf(Hub) 
     tran(CLIENT) 
     host(sample.ibm.com) 
     port(1414) 
     chan(java.channel) 
     qmgr(sample.queue.manager) 
 InitCtx/jms> define q(inQ) queue(JMSIN) qmgr(sample.queue.manager) 
 InitCtx/jms> define q(outQ) queue(JMSOUT) qmgr(sample.queue.manager) 
 InitCtx/jms>end 

En este ejemplo, el archivo .bindings estaría ubicado en el siguiente directorio: c:/temp/JMS/JMS, donde c:/temp/JMS es PROVIDER_URL y JMS es el nombre de contexto.

Copyright IBM Corp. 2003, 2005