MQSeries topic connection factory settings for application clients
Panel for changing the properties of a topic connection factory for use with the MQSeries JMS provider. These configuration properties control how connections are created to the associated JMS topic 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 Topic Connection Factories and click New. The following fields appear on the General tab.
A topic connection factory is used to create JMS connections to topic destinations. The topic connection factory is created by the MQSeries JMS provider. A topic 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 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 topic connection factory is known for administrative purposes within IBM WebSphere Application Server. The name must be unique within the JMS provider.
Data type String
Description
- A description of this topic connection factory for administrative purposes within IBM WebSphere Application Server.
Data type String Default Null
JNDI Name
- The JNDI name that is used to bind the topic connection factory into the appserver's name space.
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.
This name is used to link the platform binding information. The binding associates the resources defined by the deployment descriptor of the module to the actual (physical) resources bound into JNDI by the platform.
Data type String Units En_US ASCII characters Default Null Range 1 through 45 ASCII characters
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 property, also specify a value for the Password property.
The connection factory User 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 createTopicConnection(). The JMS client flows the userid and password to the JMS server.
Data type String
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 Default Null
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
Host
- The name of the host on which the MQ queue manager runs, for client connection only.
Data type String Default Null Range A valid TCP/IP hostname
Port
- The TCP/IP port number used for connection to the MQ queue manager, for client connection only.
This port must be configured on the MQ queue manager.
Data type Integer Default Null Range A valid TCP/IP port number, configured on the MQ queue manager.
Channel
- The name of the channel used for connection to the MQ queue manager, for client connection only.
Data type String Default Null Range 1 through 20 ASCII characters
Transport Type
- Whether MQSeries client connection or JNDI bindings is used for connection to the MQSeries queue manager.
Data type Enum Units Not applicable Default BINDINGS Range
CLIENT
- MQSeries client connection is used to connect to the MQSeries queue manager.
BINDINGS
- JNDI bindings are used to connect to the MQSeries queue manager.
Client Id
- The JMS client identifier used for connections to the MQSeries queue manager.
Data type String
CCSID
- The coded character set identifier for use with the MQ queue manager.
This coded character set identifier (CCSID) must be one of the CCSIDs supported by MQ.
Data type String
Broker Control Queue
- The name of the broker control queue, to which all command messages (except publications and requests to delete publications) are sent
The name of the broker control queue. Publisher and subscriber applications, and other brokers, send all command messages (except publications and requests to delete publications) to this queue.
Data type String Units En_US ASCII characters Default Null Range 1 through 48 ASCII characters
Broker Queue Manager
- The name of the MQSeries queue manager that provides the Pub/Sub message broker.
Data type String Units En_US ASCII characters Default Null Range 1 through 48 ASCII characters
Broker Pub Queue
- The name of the broker's input queue that receives all publication messages for the default stream
The name of the broker's input queue (stream queue) that receives all publication messages for the default stream. Applications can also send requests to delete publications on the default stream to this queue.
Data type String Units En_US ASCII characters Default Null Range 1 through 48 ASCII characters
Broker Sub Queue
- The name of the broker queue from which non-durable subscription messages are retrieved
The name of the broker's queue from which non-durable subscription messages are retrieved. The subscriber specifies the name of the queue when it registers a subscription.
Data type String Units En_US ASCII characters Default Null Range 1 through 48 ASCII characters
Broker CCSubQ
- The name of the broker's queue from which non-durable subscription messages are retrieved for a ConnectionConsumer. This property applies only for use of the Web container.
The name of the broker queue from which non-durable subscription messages are retrieved for a ConnectionConsumer. This property applies only for use of the Web container.
Data type String Units En_US ASCII characters Default Null Range 1 through 48 ASCII characters
Broker Version
- Whether the message broker is provided by the MQSeries MA0C Supportpac or newer versions of WebSphere message broker products
Data type Enum Units Not applicable Default Advanced Range
Advanced
- The message broker is provided by newer versions of WebSphere message broker products (MQ Integrator and MQ Publish and Subscribe)
Basic
- The message broker is provided by the MQSeries MA0C SupportPac (MQSeries - Publish/Subscribe)
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.