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.