MQSeries topic connection factory settings for application clients

Use this panel to view or change the configuration properties of the selected 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. The name must be unique within the JMS provider.

Data type	String
Units	En_US ASCII characters
Default	Null
Range	1 through 30 ASCII characters

Description

A description of this topic connection factory for administrative purposes.

Data type	String
Units	En_US ASCII characters
Default	Null
Range	1 through 30 ASCII characters

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
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 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
Units	A valid JMS client ID, as 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.

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.