Use this panel to view or change the configuration properties of
the selected topic connection factory for use with the MQSeries product Java
Messaging Service (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.
A topic connection factory is used to create JMS connections to topic destinations.
The topic connection factory is created by the MQSeries product JMS provider.
A topic connection factory for the MQSeries product JMS provider has the following
properties.
- 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.
- Description
- A description of this topic connection factory for administrative
purposes within IBM WebSphere Application Server.
Data type |
String |
Default |
Null |
- JNDI Name
- The Java Naming and Directory Interface (JNDI) name that is used
to bind the topic connection factory into the application server 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, you must 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.
- 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, you must 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.
- Host
- The name of the host on which the WebSphere MQ queue manager runs
for client connections only.
Data type |
String |
Default |
Null |
Range |
A valid TCP/IP host name |
- 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 |
Integer |
Default |
Null |
Range |
A valid TCP/IP port number, configured on the WebSphere MQ queue
manager. |
- Channel
- The name of the channel used for client connections to the WebSphere
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 are 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.
- CCSID
- The coded character set identifier to be used with the WebSphere
MQ queue manager.
This coded character set identifier (CCSID) must be one of the CCSIDs supported
by WebSphere MQ.
- 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
as well as 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 Publisher
and Subscriber 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 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 nondurable subscription
messages are retrieved.
The name of the broker queue from which nondurable 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 queue from which nondurable subscription
messages are retrieved for a ConnectionConsumer request. 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
- Specifies whether the message broker is provided by the MQSeries
MA0C SupportPac or newer versions of WebSphere family message broker products.
Data type |
Enum |
Units |
Not applicable |
Default |
Advanced |
Range |
- Advanced
- The message broker is provided by newer versions of WebSphere family message
broker products (MQ Integrator and MQ Publish and Subscribe)
- Basic
- The message broker is provided by the MQSeries MA0C SupportPac (MQSeries
- Publish and Subscribe)
|
- Custom Properties
- Specifies name-value pairs for setting additional properties on
the object that is created at run time 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 acceptable properties and values depend on the object
that is created. Refer to the object documentation for a list of valid properties
and values.