Creating the JMS bindings file

To create the JMS bindings file, you use the JMSAdmin application. This section provides a summary of how to create the JMS bindings file. For complete information on how to use the JMSAdmin application, refer to your WebSphere MQ documentation.

The following steps describe how to create the JMS bindings file:

  1. In a command prompt (from the WebSphereMQ_Root\java\bin directory), launch the JMSAdmin application by entering:
    JMSAdmin
    
  2. Define the new JMS configuration by entering the following commands at the command-line prompt:
    1. Create the JMS context with the following command:
      def ctx(contextName)
      
    2. Change your active context by typing:
      chg ctx(contextName)
      

      where contextName is the context you created in the previous step.

    3. Define the queue connection factory with the following command:
      def qcf(connectionFactoryName) qmgr (queueManagerName) tran(client)
       chan(javaChannelName) host (MQHostName) port (MQport)
      

      where:

      • connectionFactoryName is the name to assign to your queue connection factory
      • queueManagerName is the name of your WebSphere MQ queue manager (that manages the queues that Business Integration Connect will use)
      • javaChannelName is the name of the channel used to establish client communications to WebSphere MQ. The default channel name is java.channel.
      • MQHostName is the IP address of the host machine (the machine on which the WebSphere MQ queue manager resides)
      • MQport is the port number of the host machine
    4. Define the queues by typing the following command for each queue:
      def q(queueAliasName) qmgr (queueManagerName) queue (queueName)
      
    5. Exit JMSAdmin with the following command:
      end
      

The bindings file is created in a subfolder of the folder configured in the PROVIDER_URL field of the JMSAdmin.config file. The bindings file has the following name:

.bindings

The name of the subfolder is the name you chose for your JMS context.

Figure 32 shows the creation of a sample JMS configuration.

Figure 32. Commands to create sample JMS configuration

def ctx(JMS)
change ctx(JMS)
define qcf(WBICHub) qmgr(bcg.queue.manager) tran(CLIENT) chan(java.channel) 
host(127.0.0.1) port(1414)
define q(inQ) queue (JMSIN) qmgr(bcg.queue.manager)
define q(outQ) queue (JMSOUT) qmgr(bcg.queue.manager)

The commands in Figure 32, issued from within the JMSAdmin application, create the following JMS objects:

When these commands are complete, the JMSAdmin application has created a .bindings file in the following directory:

C:/filesender/config/jms

Copyright IBM Corp. 2003, 2004