Configuring WebSphere MQ Message queues

InterChange Server requires one WebSphere MQ message queue for each active connector whose DELIVERY_TRANSPORT configuration parameter is WebSphere MQ. The WebSphere MQ queue carries messages from the connector to InterChange Server. The configure_mq file creates the queue manager and creates all queues specified in the crossworlds_mq.tst file. These files are located in ProductDir/mqseries.

WebSphere MQ might need additional configuration if the message queues cannot handle large numbers of messages. WebSphere MQ message queues are set up by default to hold 5000 possible messages. During times of high traffic volumes or an initial InterChange Server conversion, this default might be exceeded. When the message queues are overloaded, errors occur and connectors cannot post messages to InterChange Server.

To alter a message queue, change the crossworlds_mq.tst file according to the following procedure:

  1. Set the maximum queue depth of the message queues.

    After each queue definition, set the MAXDEPTH parameter by adding the following:

    ALTER QLOCAL (QUEUENAME) MAXDEPTH (DEPTH_DESIRED

    During conversion times, set the maximum queue depth to at least 20,000 messages.

  2. Reconfigure the size of each individual message.

    The default message size is 4194304 (4 MB). You can set the MAXMSGL parameter for any of the following objects: queues, queue managers, and channels:

    ALTER QUEUE(QUEUENAME) MAXMSGL(SIZE_DESIRED)
     
    ALTER QMGR MAXMSGL (SIZE_DESIRED)
     
    ALTER CHANNEL(CHANNELNAME) CHLTYPE(TYPE) MAXMSGL(SIZE_DESIRED)
    
  3. Allow for more than the standard uncommitted messages across all queues.

    After each queue definition, set the MAXUMSGS parameter by adding the following:

    ALTER QMGR MAXUMSGS (NUMBER

    The number of allowed uncommitted messages should be the sum of the maximum message depth (MAXDEPTH) of each queue. The memory used by InterChange Server should not increase unless the number of uncommitted messages increases.

For more information on these WebSphere MQ commands, see the WebSphere MQ documentation or the online WebSphere MQ Information Center.

Setting the KEEPALIVE option

Set the KEEPALIVE option to enable the TCP/IP to periodically check and remove any orphaned channels. The TCP/IP checks if the other end of the connection is still open. If it is not, the channel is closed.

To use this option, modify the queue manager configuration file (QM.INI) to add the following entry:

TCP: ;TCP entries
 
KEEPALIVE=Yes ;Switch TCP/IP KEEPALIVE on

Usually, the time interval for the KEEPALIVE mechanism to close the orphaned channel is two hours.

For more information on these WebSphere MQ commands, see the WebSphere MQ documentation or the online WebSphere MQ Information Center.

Copyright IBM Corp. 1997, 2004