Broker 10.15 | webMethods Broker Documentation | webMethods Broker Messaging Programmer's Guide | webMethods Messaging Administration | JMSAdmin Command Reference | JMSAdmin Command Descriptions | Modify TopicConnectionFactory
 
Modify TopicConnectionFactory
Changes property values for an existing topic connection factory that is already bound to JNDI (JMS clients only).
Syntax
modify { tcf | TopicConnectionFactory } lookup-name with
 
[ { brokerHost | bh }=host[:port] ]
[ { brokerName | bn }=broker-name ]
[ clientId=client-id ]
[ application=application-name ]
[ group=client-group-name ]
[ sslKeystore=filename ]
[ sslPassword=password ]
[ sslTruststore=filename ]
[ sslEncrypted={ true | false } ]
[ useXA={ true | false } ]
[ marshallInClassName=class-name ]
[ marshallOutClassName=class-name ] ]
The command syntax has these parts:
Part
Description
lookup-name
Required. The name used to look up this connection factory in the JNDI directory.
brokerHost
*Optional.The host part is the host name of the Broker Server on which the Broker resides. The default value is localhost.
*Optional.The port part is the port number of the Broker Server on which the Broker resides. The default value is 6849.
brokerName
Optional. The name of the Broker. If you do not specify a Broker name, JMSAdmin uses the default Broker on the specified Broker Server.
clientID
Optional. The base client ID for connections created by this factory.
*If you specify a client ID, it must be unique. This ID is assigned to all the connections to the Brokers in the cluster.
*If you do not specify a client ID, the connection factory assigns a unique ID when a connection is established.
application
Optional. The name of the application stored as part of the application's Broker client state. The application is displayed by JMSAdmin.
group
Optional. The client group name that clients created from this connection factory will use. Note that the bind command does not create the client group; you must create a client group explicitly using the create group command. The default client-group-name is JMSClient.
sslKeystore
Optional. The fully qualified path of the file containing the SSL certificate that JMSAdmin will use on SSL connections made from this connection factory.
sslPassword
Optional. The password for the keystore file that JMSAdmin is to use when connecting to the Broker using SSL.
sslTruststore
Optional. The file that holds the trusted root (CA public key) that JMSAdmin will use to connect to an SSL-enabled Broker.
sslEncrypted
Optional. Whether traffic to the Broker on connections made from this connection factory will be encrypted.
*If set to true, all traffic to the Broker on this connection will be encrypted.
*If set to false, the connection will be authenticated but no data will be encrypted.
The default value is false.
useXA
Optional. Whether XA transactions are allowed with this connection factory. The default value is true, which means XA transactions are allowed. If you are not using the specified connection factory with an application server, specifying false saves some of the overhead associated with support for XA connection factories.
marshalInClassName
Optional. Class name of the inbound marshaller.
marshalOutClassName
Optional. Class name of the outbound marshaller.
Example
In this example, an existing topic connection factory named MyTCF has its BrokerName property setting changed from the default (null) to JMS Broker and its BrokerHost property changed from localhost to testserver.
/sub4/sub5> show MyTCF
MyTCF : com.webmethods.jms.impl.WmXATopicConnectionFactoryImpl
BrokerHost: localhost
BrokerName: <default broker>
Application: <not specified>
ClientGroup: BrokerJMS_Connections
ClientID: <not specified>
SSLKeystore: <not specified>
SSLEncrypted: false
UseXA: false
/sub4/sub5> modify tcf MyTCF with brokerName="JMS Broker" bh=testserver:8849
/sub4/sub5> show MyTCF
MyTCF : com.webmethods.jms.impl.WmXATopicConnectionFactoryImpl
BrokerHost: testserver:8849
BrokerName: JMS Broker
Application: <not specified>
ClientGroup: BrokerJMS_Connections
ClientID: <not specified>
SSLKeystore: <not specified>
SSLEncrypted: false
UseXA: false
Related Commands
Bind TopicConnectionFactory
Modify Topic