Creating an activation specification for the WebSphere MQ messaging provider
Use this task to create an activation specification for use with the WebSphere® MQ messaging provider.
About this task
To create an activation specification for use with the WebSphere MQ messaging provider, use the administrative console to complete the following steps. You can choose either to enter all the required connection information using the Create WebSphere MQ JMS resource wizard or to use a client channel definition table (CCDT) to establish a connection to the WebSphere MQ messaging provider.
For information about modifying an existing activation specification, see the related tasks.
Procedure
- In the navigation pane, click Resources > JMS > Activation specifications.
- Select the Scope setting corresponding to the scope of the activation specification that you want to create.
- Click New in the content pane.
- Select WebSphere MQ messaging provider, then click OK to start the Create WebSphere MQ JMS resource wizard.
- On the
Configure basic attributes
page, enter the following information, then click Next.- Name
- The name by which this activation specification is known for administrative purposes within WebSphere Application Server.
- JNDI name
- The name that is used to bind this activation specification into the JNDI namespace.
- Description
- Optional. A description of this activation specification for administrative purposes within WebSphere Application Server.
- On the
Specify MDB destination data
page, enter the following information, then click Next.- Destination JNDI name
- The JNDI name for the JMS destination from which messages are delivered to a message-driven bean (MDB) that is configured to use this activation specification.
- Message selector
- Optional. A message selector expression specifying which messages are to be delivered.
- Destination type
- The type of destination (queue or topic) from which to consume messages.
- On the
Select connection method
page, choose how you want to specify the connection details for to the WebSphere MQ messaging provider by selecting one of the following options, then click Next.- Enter all the required information into this wizard
- Choosing this option takes you to the
Supply queue manager details
page (see step 8), where you can start entering the connection details using the Create WebSphere MQ JMS resource wizard. - Use a client channel definition table
- Choosing this option takes you to the
Specify client channel definition table
page (see step 9), where you can enter details of the client channel definition table that you want to use.
- If you have chosen to enter all the required information
using the wizard, complete the following steps:
- On the
Supply queue manager details
page, enter the name of the queue manager or queue-sharing group that you want to connect to then click Next. - On the
Enter connection details
page, specify the details for the connection, then click Next to continue to theTest connection
page.You can choose either to enter host and port information separately, or enter host and port information in the form of a connection name list. You must only choose the option to use a connection name list if you are creating a connection to a multi-instance queue manager. You must not use this option for connections to non-multi-instance queue managers as that can result in transaction integrity issues.- Transport
- Optional. The WebSphere MQ transport type for the connection. The option that you select is used to determine the exact mechanisms used to connect to WebSphere MQ. If you are configuring a transport type of bindings, then client or bindings, see Configuring the WebSphere MQ messaging provider with native libraries information for more information.
- Enter host and port information in the form of separate hostname and port values
- This radio button is selected by default and enables the Hostname and Port fields and disables the Connection name list field. Leave this radio button selected if you want to enter host and port information in the form of separate hostname and port values.
- Hostname
- The host name, IPv4, or IPv6 address of the WebSphere MQ queue manager to connect to. Complete this field if you have selected Enter host and port information in the form of separate hostname and port values.
- Port
- Optional. The port number on which WebSphere MQ is listening. If you do not specify a value for the port number, the default value of 1414 is used. Complete this field if you have selected Enter host and port information in the form of separate hostname and port values.
- Enter host and port information in the form of a connection name list
- This radio button is cleared by default and, if selected, disables
the Hostname and Port fields
and enables the Connection name list field.
- Click this radio button to select it if you want to enter host and port information in the form of a connection name list.
- Leave this radio button cleared if you want to enter host and port information in the form of separate host name and port values.
- Connection name list
- The connection name list specifying the host name and port details
to use when you want the connection factory to connect to a multi-instance
queue manager. Complete this field if you have selected Enter
host and port information in the form of a connection name list.
Enter the host name and port details in the following form:
host[(port)][,host(port)]
host must be a valid TCP/IP host name or IPv4 or IPv6 address.
port must be an integer value in the range 1 - 65536 (inclusive). The port information is optional, and if not specified, defaults to 1414.
For example: localhost(1234),remotehost1(1234),remotehost2
- Server connection channel
- Optional. The WebSphere MQ server connection channel name used when connecting to WebSphere MQ queue manager or queue-sharing group.
- On the
- If you are using a channel client definition table to establish
a connection to the WebSphere MQ messaging
provider, complete the following fields on the
Specify client channel definition table
page, then click Next to continue to theTest connection
page.- Client channel definition table URL
- The URL to the client channel definition table that you want to use when connecting to WebSphere MQ.
- Queue manager
- Optional. The name of the queue manager to be used to select one or more entries from the CCDT.
- Optional: On the
Test connection
page, if you want to test establishing the connection, click Test connection. This test can take several seconds to perform. - On the
Summary
page, complete the creation of the new activation specification by clicking Finish. - Stop then restart the application server.