Skip Headers
Oracle® Fusion Middleware Administrator's Guide for Oracle Service Bus
11g Release 1 (11.1.1.6.3)

Part Number E15867-08
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

9 MQ Connections

This chapter describes how to create, locate, edit, and delete MQ Connection resources using the Oracle Service Bus Administration Console.

Note:

See Chapter 1, "Interoperability Scenarios and Considerations" for the supported versions of WebSphere MQ on Oracle Service Bus. The WebSphere MQ client library is not bundled with the Oracle Service Bus installer. Get the WebSphere MQ client library from your WebSphere MQ installation.

MQ Connections are sharable resources that can be reused across multiple MQ proxy and business services. MQ proxy and business services must connect to an MQ queue manager before accessing an MQ queue. MQ Connection resources provide the connection parameters required for connecting to a MQ queue manager.

Each MQ Connection resource has a connection pool. Every business or proxy service using a given MQ Connection resource to get a connection to a given queue manager uses the same connection pool that was created for that resource. Thus, multiple business services and proxy services using the same queue manager share a connection pool.

To learn more about Oracle Service Bus MQ Connection resources and native MQ transports, see "MQ Transport" in the Oracle Fusion Middleware Developer's Guide for Oracle Service Bus.

To learn more about WebSphere MQ Fundamentals, see http://www.redbooks.ibm.com/redbooks/SG247128/wwhelp/wwhimpl/java/html/wwhelp.htm.

9.1 Locating MQ Connections

Locating MQ Connection resources:

  1. Do either of the following:

    • Select Project Explorer to display the Projects View page or the Project/Folder View page. Then navigate through projects and folders to find the MQ Connection resource.

    • Select Resource Browser > MQ Connections. The Summary of MQ Connections page displays the information shown in Table 9-1. For a more detailed description of the properties, see Section 9.3, "Editing MQ Connections."

  2. To restrict the number of items in the list, you can filter by name, path, or both. In the Name and Path fields, enter the name and path of the search target(s), then click Search.

  3. Click the Open icon to display additional search filters. If you specify multiple search criteria, only results that match all the criteria will be returned.

    • Filter by Queue Manager Name. Enter any string, including wildcard characters, then click Search.

    • Filter by Queue Manager Channel Name. Enter any string, including wildcard characters, then click Search.

    • Click View All to remove the search filters and display all MQ Connection resources.

Table 9-1 MQ Connection Details

Property Description

MQ Connection Name

The name assigned to the MQ Connection resource. The name is a link to the MQ Connection Configuration page. See Section 9.3, "Editing MQ Connections."

Path

The path is the project name and the name of the folder in which the MQ Connection resource resides. It is a link to the project or folder that contains this resource. See Section 4.1.1, "Qualifying Resource Names Using Projects and Folders."

Options

Click the Delete icon to delete a specific MQ Connection resource. See Section 9.4, "Deleting MQ Connections."


9.2 Adding MQ Connections

Before you begin

See Chapter 1, "Interoperability Scenarios and Considerations" for the supported versions of WebSphere MQ on Oracle Service Bus. The WebSphere MQ client library is not bundled with the Oracle Service Bus installer. Get the WebSphere MQ client library from your WebSphere MQ installation.

To configure and use MQ Connection resources and the MQ transport in Oracle Service Bus, you must add the MQ client library to the classpath. One option is to copy the com.ibm.mq.jar library to your DOMAIN_NAME/lib directory, where DOMAIN_NAME is the name of the directory in which you located the domain, typically MW_HOME\user_projects\domains\DOMAIN_NAME.

To add an MQ Connection resource

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Section 3.1, "Using the Change Center."

  2. Select Project Explorer, then select a project or folder in which to add the MQ Connection resource. The Project/Folder View page is displayed.

  3. From the Create Resource list, select MQ Connection from under Utility to display the Create a New MQ Connection Resource page.

    Specify the connection parameters shown in Table 9-2.

    Table 9-2 MQ Connection Parameters

    Property To create or edit...

    Resource Name

    Enter a unique name for this MQ Connection resource.

    Follow the Section 2.3, "Resource Naming Restrictions" for naming guidance.

    Resource Description

    Enter a description for the MQ Connection resource.

    Connection Type

    Select one of the following modes for connecting to the MQ queue manager:

    • tcp mode—Use TCP/IP to connect to a queue manager that does not reside on the same machine as Oracle Service Bus.

    • binding mode—Use the bindings mode to connect to a queue manager that is located on the same machine as Oracle Service Bus.

    MQ Host Name

    For tcp mode connections only:

    Enter the host name of the MQ queue manager.

    MQ Port Number

    For tcp mode connections only:

    Enter the port number of the MQ queue manager listener.

    MQ Queue Manager Name

    Enter the name of the MQ queue manager to which to connect.

    Queue Manager CCSID

    For tcp mode connections only:

    The coded character set identifier (CCSID) to be used when establishing a connection. The CCSID is used mainly for internationalization support.

    To learn more, see WebSphere MQ Fundamentals at http://www.redbooks.ibm.com/redbooks/SG247128/wwhelp/wwhimpl/java/html/wwhelp.htm.

    MQ Queue Manager Channel Name

    For tcp mode connections only:

    Enter the queue manager server connection channel name.

    SSL Required

    For tcp mode connections:

    Select the check box to use SSL for sending messages. Only server-side SSL will be enabled when the 2-way SSL Required option is not selected.

    Cipher Suite

    This option is available only when the SSL Required check box is selected.

    Select the Cipher Suite algorithm to be used by SSL.

    The Cipher Suite algorithm is used to encrypt and decrypt message communications between the WebSphere MQ server and the WebSphere MQ client. Thus a Cipher Suite algorithm must be specified when using SSL to communicate with a WebSphere MQ server.

    2-way SSL Required

    This option is available only when the SSL Required check box is selected.

    Select the check box to enable both client-side and server-side SSL authentication.

    Reference to the Service Key Provider

    If you selected 2-way SSL Required, you must provide a reference to the service key provider for obtaining the appropriate key store and trust store information.

    Enter the path (project/folder) and name of a service key provider, or click Browse to select one from the Select Service Key Provider page.

    Reference to the Static Service Account

    For tcp mode connections only:

    Required for user name and password authentication. Enter the path (project/folder) and name of a static service account, or click Browse to select service accounts from a browser.

    WebSphere MQ Version

    Select the WebSphere MQ version:

    • 5.3

    • 6.0

    • 7.0

    MQ Connection Pool Size

    Enter the size of the MQ connection pool.

    MQ Connection Timeout

    Enter the time interval in seconds after which unused connections are destroyed. The default is 1800 seconds.

    MQ Connection Max Wait

    Enter the Max Wait in seconds for the amount of time to wait for a connection to become available. If a connection is not made within that time interval, Oracle Service Bus throws an exception. The default is 3 seconds.


  4. Click Save. The MQ Connection resource is created and saved in the current session.

  5. To end the session and deploy the configuration to the run time, click Activate under Change Center.

9.3 Editing MQ Connections

To edit an MQ Connection resource:

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Section 3.1, "Using the Change Center."

  2. Locate the MQ Connection resource, as described in Section 9.1, "Locating MQ Connections."

  3. Click the MQ Connection resource name.

    The View MQ Connection - Configuration page displays the information shown in Table 9-3.

    Table 9-3 MQ Connection Details

    Property Description

    Last Modified By

    The user who created this MQ Connection resource or imported it into the configuration.

    Last Modified On

    The date and time that the user created this MQ Connection resource or imported it into the configuration. Click the date and time link to view the change history of this resource. See Section 4.23, "View Change History Page."

    References

    The number of objects that this MQ Connection resource references. If such references exist, click the numeric link to view a list of the objects. See Section 4.22, "Viewing References to Resources."

    Referenced by

    The number of objects that reference this MQ Connection resource. If such references exist, click the numeric link to view a list of the objects. See Section 4.22, "Viewing References to Resources."

    Description

    A description of this MQ Connection resource, if one exists.


  4. To make a change to the fields, click Edit. For descriptions of the fields, see Section 9.2, "Adding MQ Connections."

    You cannot change the Resource Name field.

  5. Click Save to commit the updates in the current session.

  6. To end the session and deploy the configuration to the run time, click Activate under Change Center.

9.4 Deleting MQ Connections

To delete an MQ Connection resource:

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Section 3.1, "Using the Change Center."

  2. Select Resource Browser > MQ Connections to display the Summary of MQ Connections page.

  3. Click the Delete icon in the Options field of the MQ Connection resource you want to delete. The MQ Connection resource is deleted in the current session. A Deletion Warning icon is displayed when other resources reference this resource. You can delete the resource with a warning confirmation. This might result in conflicts due to unresolved references to the deleted resource.

  4. To end the session and deploy the configuration to the run time, click Activate under Change Center.