Configuración del concentrador para el protocolo de transporte JMS

Ha instalado WebSphere MQ como parte de la instalación de WebSphere Business Integration Connect. WebSphere MQ incluye una implementación de JMS, que puede utilizar para configurar la comunicación mediante JMS.

Sin embargo, WebSphere MQ no está configurado para JMS por omisión. En este apartado se proporcionan instrucciones para configurar 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 por omisión

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 Creación de un directorio para JMS. Por ejemplo, si configura el directorio c:/temp/JMS, la línea sería:
    PROVIDER_URL=file:/c:/temp/JMS
     
  6. Guarde el archivo.

Creación de colas y del canal

En este apartado, utilice WebSphere MQ para crear las colas que utilizará para enviar y recibir documentos y el canal para dicha comunicación. Se supone que se ha creado un gestor de colas. <Nombre del gestor de colas> debería sustituirse por el nombre del gestor de colas en los pasos siguientes. También se asume 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 del gestor de colas>
     
  3. Especifique el mandato siguiente para iniciar el entorno de mandatos de WebSphere MQ:
    runmqsc <nombre del gestor de 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 a su entorno

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

establezca la vía de acceso PATH=%PATH%;<en el directorio de instalación>\_jvm\jre\bin
 

donde el directorio de instalación se refiere al directorio en el que se ha instalado WebSphere Business Integration Connect.

Definición de la configuración JMS

Para definir la configuración JMS, lleve a cabo los pasos siguientes:

  1. Pase al directorio Java de WebSphere MQ (directorio (<vía de acceso al directorio de instalación de 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(jms)
     
    change ctx(jms) 
     
  4. Desde el indicador InitCtx/jms>, especifique la siguiente configuración de JMS:
    define qcf(WBICHub)
         tran(CLIENT)
         host(<su_dirección_IP>)
         port(1414)
         chan(canal.java)
         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
     

A modo de ejemplo mostramos la sesión JMSAdmin que se utiliza para definir la fábrica de conexiones de cola como WBIHub, con una dirección IP sample.ibm.com donde reside el gestor de colas MQ (<nombre del gestor de colas> de sample.queue.manager). El ejemplo utiliza los nombres de cola de JMS y el nombre de canal que se creó en 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(WBICHub)
     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
 

Inicio del servidor y visualización de la Consola de comunidad

En este capítulo se muestra cómo iniciar el servidor WebSphere Business Integration y visualizar la Consola de comunidad.

Copyright IBM Corp. 1997, 2004