WebSphere WebSphere Application Server Express, Version 6.0.x Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Defining a WebSphere MQ link

This topic describes how to define a WebSphere MQ link on a messaging engine in a service integration bus.

Before you begin

Before starting this task you will need to:
  • Know the name of the messaging engine on which you intend to put the WebSphere MQ link.
  • Have created the foreign bus that represents the WebSphere MQ queue manager network. For information about creating a foreign bus, see Adding a foreign bus.
  • Know the name of the WebSphere MQ queue manager that you will define as the gateway through which messages will be exchanged with the WebSphere MQ link.
  • Have created sender and receiver channels in the WebSphere MQ network. The WebSphere MQ link receiver channel must have the same name as its partner sender channel in the WebSphere MQ network. The WebSphere MQ link sender channel must have the same name as its partner receiver channel in the WebSphere MQ network. For examples on creating channels, see WebSphere MQ link sample configuration.

Why and when to perform this task

To define a WebSphere MQ link, use the administrative console to complete the following steps. This task contains optional steps to define a WebSphere MQ link sender channel and a WebSphere MQ link receiver channel.

Steps for this task

  1. In the navigation pane, click Service integration > Buses [Content Pane] > bus_name > [Additional Properties] Messaging engines > engine_name > [Additional Properties] WebSphere MQ links
  2. In the content pane, click New.
  3. Type the name of the new WebSphere MQ link.
  4. Enter a description for the WebSphere MQ link.
  5. In the foreign bus name, click the name of the foreign bus that represents the WebSphere MQ network.
  6. Type the virtual, messaging-engine queue-manager name, that is, the queue name that WebSphere MQ will use to address this service integration bus. Maximum 48 characters.
  7. Review the default values in the remaining fields on the panel, using the field help in the Help pane to find out more information about each field. Modify any values as necessary.
  8. Click Next.
  9. Define the WebSphere MQ link sender channel.
    1. Type the name of the sender channel associated with this WebSphere MQ link. Maximum 20 characters. This name must be the same as the name of the partner receiver channel in the WebSphere MQ network.
    2. Type the host name or address of the target queue manager in the WebSphere MQ network.
    3. Enter the port number on which the gateway queue manager is listening for the inbound communication requests.
    4. Type the transport chain, that is the communication protocol for the foreign bus. Possible choices include "OutboundBasicMQLink" and "OutboundSecureMQLink". For more information seeOutbound transport options and Securing connections to a WebSphere MQ network.
    5. Review the default values in the remaining fields on the panel, using the field help in the Help pane to find out more information about each field. Modify any values as necessary.
  10. Click Next.
  11. Define the WebSphere MQ link receiver channel.
    1. Type the name of the receiver channel associated with this WebSphere MQ link. Maximum 20 characters. This name must be the same as the name of the partner sender channel in the WebSphere MQ network.
    2. Review the default values in the remaining fields on the panel, using the field help in the Help pane to find out more information about each field. Modify any values as necessary.
  12. Click Next
  13. Check the summary of WebSphere MQ link properties, and when you are satisfied click Finish.
  14. Save your changes to the master configuration
  15. Restart the application server if you have completed configuring the WebSphere MQ link, that is, you are not going to define broker profiles. The WebSphere MQ link is ready to send, receive, or exchange messages with the WebSphere MQ network, provided the queue manager (the gateway queue manager) has been created on the WebSphere MQ network, and the required resources defined.

You can now define a broker profile, by following the steps in Defining a publish/subscribe broker profile.

Related information
WebSphere MQ link settings

Task topic

Terms of Use | Feedback

Last updated: 2 Aug 2005
http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.pmc.express.doc\tasks\tjc0001_.html

© Copyright IBM Corporation 2004, 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)