Using the Oracle Service Bus Console

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

MQ Connections

Note: See Product Support Information 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 the MQ Transport User Guide.

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

Locating MQ Connections

  1. Do either of the following:
  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 8-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 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 Qualifying Resource Names Using Projects and Folders.
      Options
      Click the Delete icon to delete a specific MQ Connection resource. See Deleting MQ Connections.

Adding MQ Connections

Before you begin

See Product Support Information 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 BEA_HOME\user_projects\domains\DOMAIN_NAME.

To add a 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 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 drop-down list, select MQ Connection from under Utility to display the Create a New MQ Connection Resource page.

    4. Specify the connection parameters shown in Table 8-2.

    Table 8-2 MQ Connection Parameters 
    Property
    To create or edit...
    Resource Name
    Enter a unique name for this MQ Connection resource.

    Note: 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:
    • 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:
    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.

Editing MQ Connections

This section describes how to edit existing MQ Connection resources.

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
  2. Locate the MQ Connection resource, as described in Locating MQ Connections.
  3. Click the MQ Connection resource name.

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

    Table 8-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 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 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 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 Adding MQ Connections.

    5. 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.

Deleting MQ Connections

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See 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.

  Back to Top       Previous  Next