WebSphere MQ messaging provider queue settings
Use this panel to view or change the configuration properties of the selected queue destination for point-to-point messaging with WebSphere MQ as a messaging provider.
A WebSphere MQ queue destination is used to configure the properties of a queue for the WebSphere MQ messaging provider. Connections to the queue are created using an associated WebSphere MQ queue connection factory or connection factory.
To view WebSphere MQ queue settings, use the administrative console to complete the following steps:
- In the navigation pane, click Resources > JMS->Queues to display existing queue destinations.
- Select the name of the queue destination to work with.
- Optional: To create a new queue destination, click New.
- Optional: To view or change the queue destination settings, select ts name in the list displayed.
Under General Properties there are two groups of properties:
- Administration
- WebSphere MQ Queue
Make any required changes to the Administration and WebSphere MQ Queue groups of properties and then click Apply to save the configuration before, in the content pane under Additional Properties, you click one of the following links:
- Advanced properties to display or change the advanced properties of the WebSphere MQ queue destination
- WebSphere MQ queue connection properties to display or change the connection properties of the WebSphere MQ queue destination
- Custom properties to display or change the custom properties of the WebSphere MQ queue destination
Under Related items, we can click JAAS - J2C authentication data to configure authentication information for use with the queue destination.
When specifying WebSphere MQ properties, the following restrictions apply:
- Names can have a maximum of 48 characters, with the exception of channels, which have a maximum of 20 characters.
- The property values specified must match the values that specified when configuring WebSphere MQ for JMS resources. For more information about configuring WebSphere MQ JMS resources, see the Use Java and System Administration sections of the WebSphere MQ information center.
If WebSphere MQ functionality has been disabled at a scope that affects this WebSphere MQ messaging provider resource, then an informational message indicating that WebSphere MQ has been disabled appears. In a single server environment this informational message is only displayed when the server is restarted after WebSphere MQ functionality has been disabled. In a network deployment environment the informational message is displayed immediately. For more information see Disable WebSphere MQ functionality in WebSphere Application Server.
A queue destination for use with the WebSphere MQ messaging provider has the following properties.
Scope
The scope assigned to the queue when it is created. The scope specifies the level to which this queue definition is visible to applications.
Resources such as messaging providers, namespace bindings, or shared libraries can be defined at multiple scopes, with resources defined at more specific scopes overriding duplicates which are defined at more general scopes.
The scope displayed is for information only, and cannot be changed on this panel. To browse or change this resource at a different scope, change the scope on WebSphere MQ queue destination collection panel, then click Apply, before clicking the link for the type of resource.
Information Value Data type String
Provider
The JMS provider assigned when the queue is created.
For all queues created using this panel, the provider is the WebSphere MQ messaging provider.
The provider is displayed for information only.
Information Value Data type String
Name
The name by which the queue is known for administrative purposes within WebSphere Application Server.
Information Value Data type String
JNDI name
The name used to bind the queue into the JNDI namespace.
As a convention, use the fully qualified JNDI name; for example, in the form jms/Name, where Name is the logical name of the resource.
Information Value Data type String
Description
A description of the queue for administrative purposes within WebSphere Application Server.
Information Value Data type String Default Null
Queue name
The WebSphere MQ name for the queue that holds the messages for the JMS destination.
Information Value Data type String
Queue manager or queue-sharing group name
The name of the WebSphere MQ queue manager or queue-sharing group that hosts the queue.
Information Value Data type String
Related concepts
JMS interfaces - explicit polling for messages
Related tasks
Manage Java 2 Connector Architecture authentication data entries for JAAS Secure messaging Disable WebSphere MQ functionality in WebSphere Application Server
WebSphere MQ queue connection properties WebSphere MQ messaging provider queue and topic advanced properties settings WebSphere MQ resource custom properties settings Mapping of administrative console panel names to command names and WebSphere MQ names
WebSphere MQ library Reference topic