Note:
See Oracle Fusion Middleware Supported System Configurations athttp://www.oracle.com/technology/software/products/ias/files/fusion_certification.html 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.
Locating MQ Connection resources:
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."
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.
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." |
Before you begin
See Oracle Fusion Middleware Supported System Configurations at http://www.oracle.com/technology/software/products/ias/files/fusion_certification.html 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
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."
Select Project Explorer, then select a project or folder in which to add the MQ Connection resource. The Project/Folder View page is displayed.
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:
|
|
MQ Host Name |
For Enter the host name of the MQ queue manager. |
|
MQ Port Number |
For 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 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 |
|
MQ Queue Manager Channel Name |
For Enter the queue manager server connection channel name. |
|
SSL Required |
For 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 ( |
|
Reference to the Static Service Account |
For 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:
|
|
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. |
Click Save. The MQ Connection resource is created and saved in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
To edit an MQ Connection resource:
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."
Locate the MQ Connection resource, as described in Section 9.1, "Locating MQ Connections."
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. |
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.
Click Save to commit the updates in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
To delete an MQ Connection resource:
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."
Select Resource Browser > MQ Connections to display the Summary of MQ Connections page.
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.
To end the session and deploy the configuration to the run time, click Activate under Change Center.