MQSeries queue connection factory settings for application clients
Use this panel to view or change the configuration properties of the selected queue connection factory for use with the MQSeries JMS provider. These configuration properties control how connections are created to the associated JMS queue destination.
To view this Application Client Resource Configuration Tool (ACRCT) page, click File > Open. After you browse for an EAR file, click Open. Expand the selected JAR file > JMS Providers > JMS provider instance. Right-click MQ Queue Connection Factories and click New. The following fields appear on the General tab.
A queue connection factory is used to create JMS connections to queue destinations. The queue connection factory is created by the MQSeries JMS provider. A queue connection factory for the MQSeries JMS provider has the following properties.
Note:
- The property values that you specify must match the values that you specified when configuring MQSeries for JMS resources. For more information about configuring MQSeries JMS resources, see the MQSeries Using Java book.
- In MQSeries, names can have a maximum of 48 characters, with the exception of channels which have a maximum of 20 characters.
- Name
- The name by which this queue connection factory is known for administrative purposes. The name must be unique within the JMS connection factories across the WebSphere administrative domain.
Data type String Units En_US ASCII characters Default Null Range 1 through 30 ASCII characters - Description
- A description of this connection factory for administrative purposes.
Data type String Units En_US ASCII characters Default Null Range 1 through 30 ASCII characters - JNDI Name
- The application client run-time uses this field to retreive configuration information. The name must match the value of the Name field on the General tab in the Application Client Resource Reference section of the Application Assembly Tool.
- User
- The user ID used, with the Password property, for authentication if the calling application does not provide a userid and password explicitly.
If you specify a value for the User ID property, also specify a value for the Password property.
The connection factory User ID and Password properties are used if the calling application does not provide a userid and password explicitly; for example, if the calling application uses the method createQueueConnection(). The JMS client flows the userid and password to the JMS server.
Data type String Units En_US ASCII characters Default Null Range 1 through 30 ASCII characters - Password
- The password used, with the User ID property, for authentication if the calling application does not provide a userid and password explicitly.
If you specify a value for the User ID property, also specify a value for the Password property.
Data type String Units En_US ASCII characters Default Null Range 1 through 30 ASCII characters - Re-Enter Password
- Confirms the password.
- Queue Manager
- The name of the MQSeries queue manager for this connection factory.
Connections created by this factory connect to that queue manager.
Data type String Units En_US ASCII characters Default Null Range 1 through 30 ASCII characters - Host
- The name of the host on which the WebSphere MQ queue manager runs, for client connection only.
Data type String Units A valid TCP/IP hostname Default Null Range 1 through 30 ASCII characters - Port
- The TCP/IP port number used for connection to the WebSphere MQ queue manager, for client connection only.
This port must be configured on the WebSphere MQ queue manager.
Data type String Units En_US ASCII characters Default Null Range 1 through 30 ASCII characters - Channel
- The name of the channel used for connection to the WebSphere MQ queue manager, for client connection only.
Data type String Units En_US ASCII characters Default Null Range 1 through 30 ASCII characters - Transport type
- Whether WebSphere MQ client connection or JNDI bindings is used for connection to the WebSphere MQ queue manager.
Data type Enum Units Not applicable Default BINDINGS Range
- CLIENT
- WebSphere MQ client connection is used to connect to the queue manager.
- BINDINGS
- JNDI bindings are used to connect to the queue manager.
- DIRECT
- For WebSphere MQ Event Broker using DIRECT mode..
- Client ID
- The JMS client identifier used for connections to the MQSeries queue manager.
Data type String Units En_US ASCII characters Default Null Range 1 through 30 ASCII characters - CCSID
- The coded character set identifier for use with the WebSphere MQ queue manager.
This coded character set identifier (CCSID) must be one of the CCSIDs supported by WebSphere MQ.
Data type String Units En_US ASCII characters Default Null Range 1 through 30 ASCII characters For more information about supported CCSIDs, and about converting between message data from one coded character set to another, see the WebSphere MQ System Administration document.
- Message Retention
- Select this tick box to specify that unwanted messages are to be left on the queue. Otherwise, unwanted messages are dealt with according to their disposition options.
Data type Enum Units Not applicable Default Cleared Range - Custom Properties
- Specifies name-value pairs for setting additional properties on the object that is created at runtime for this resource.
You must enter a name that is a public property on the object and a value that can be converted from a string to the type required by the set method of the property. The accectable properties and values depend on the object that is created. Refer to the object documentation for a list of valid properties and values.
WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.
IBM is a trademark of the IBM Corporation in the United States, other countries, or both.