Configuring a queue for the WebSphere MQ messaging provider

Use this task to view or change the configuration of a JMS queue destination for point-to-point messaging with the WebSphere® MQ messaging provider. This task contains an optional step for you to create a new JMS queue destination.

About this task

To view or change the configuration of a queue destination for use with the WebSphere MQ messaging provider, use the administrative console to complete the following steps:

Procedure

  1. In the navigation pane, click Resources > JMS ->JMS providers.
  2. Select the WebSphere MQ messaging provider for the queue destination that you want to configure.
  3. Optional: Change the Scope setting to the level at which the JMS destination is visible to applications.
  4. In the contents pane, under Additional Properties, click Queues to display a table of existing queue destinations, with a summary of their properties.
  5. To view or change the properties of an existing queue destination, click its name in the list. Otherwise, to create a new queue, complete the following steps:
    1. Click New in the content pane.
    2. Specify the following required properties.
      Name
      The name by which this queue destination is known for administrative purposes within IBM® WebSphere Application Server.
      JNDI name
      The JNDI name that is used to bind the queue destination into the namespace.
      Base Queue Name
      The name of the queue to which messages are sent, on the queue manager specified by the Base Queue Manager Name property.
      CCSID
      The coded character set identifier for use with the WebSphere MQ queue manager; for example: 850. See the properties for the queue destination for more details.
    3. Click Apply. This defines the queue destination to WebSphere Application Server, and enables you to view or change additional properties.
  6. Optional: Change properties for the queue destination, according to your needs.
  7. Optional: If you want WebSphere Application Server to try to use the WebSphere MQ queue manager's remote administration utilities to create the queue, configure the WebSphere MQ Queue Connection properties.

    If you have already created your underlying queue in WebSphere MQ using its administration tools (such as runmqsc or MQ Explorer), you do not need to configure any of the WebSphere MQ Queue Connection properties. You only need to configure these properties if you want WebSphere Application Server to try to use the WebSphere MQ queue manager's remote administration utilities to create the queue.

    To be able to browse or change these MQ Config properties, you must have installed the WebSphere MQ client. If you have not done this, the administrative console displays messages like the following:
    The WMQQueueDefiner MBean has encountered an error.
    WMSG0331E: The MQ Client is required for this functionality, but it is not installed.
    Note: For any changes to these properties to take effect on the queue manager, the WebSphere MQ Queue Manager on which the queue resides (or will reside) must be configured for remote administration and be running.

    For more details about these properties, see WebSphere MQ config properties for the queue destination.

  8. Click OK.
  9. Save any changes to the master configuration.
  10. To have the changed configuration take effect, stop then restart the application server.



In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 30, 2013 8:21:57 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-express-iseries&topic=tmj_adm27
File name: tmj_adm27.html