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
.
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 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
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. Do not include spaces in the name. |
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 is enabled unless the 2-way SSL Required option is also 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. Clear the check box for 1-way SSL for only server-side 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. A service key provider contains Public Key Infrastructure (PKI) credentials that proxy services use for decrypting inbound SOAP messages and for outbound authentication and digital signatures. Enter the path ( For more information about using service providers, see "Service Key Providers" in the Oracle Fusion Middleware Administrator's Guide for Oracle Service Bus. |
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. A service account provides a user name and password that proxy services and business services use for outbound authentication or authentication to a local or remote resource. |
WebSphere MQ Version |
Select the WebSphere MQ version:
Note: Versions 5.3 and 6.0 are no longer supported by IBM. These versions are deprecated in Oracle Service Bus. |
MQ Connection Pool Size |
Enter the number of MQ connections to be stored in the connection pool for reuse. |
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 maximum amount of time (in milliseconds) 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 3000 milliseconds. |
XA Enabled |
Select this option if the transactions handled by this connection are distributed (XA) transactions. For XA transactions, the MQ queue must be configured for persistence. If you are using version 5.3 or 6.0 (both deprecated), add the |
Click Save. The MQ Connection resource is created and saved in the current session.
To end the session and deploy the configuration to the runtime, 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 runtime, 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 runtime, click Activate under Change Center.