Broker 10.5 | webMethods Broker Documentation | webMethods Broker Messaging Programmer's Guide | webMethods Messaging Administration | JMSAdmin Command Reference | JMSAdmin Command Descriptions | Modify Topic
 
Modify Topic
Changes the values of properties in an existing topic definition.
Syntax
modify topic lookup-name with { topicName | tn }=event-type-name
 
[ deadLetterOnly={ true | false } ]
[ localOnly={ true | false } ]
[ priorityOrdering={ true | false } ]
[ { sharedState | ss }={ true | false } ]
[ { sharedStateOrdering | sso }={ none | publisher } ]
The command syntax has these parts:
Part
Description
lookup-name
Required. The name of the JNDI directory to which the topic is bound.
topicName
Required. The name of the topic (destination) through which publishers and subscribers will exchange messages. The name must meet the following criteria:
*The first character cannot be a pound sign (#).
*The name cannot contain the at sign (@), forward slash (/), or colon (:).
*Each name segment cannot exceed 255 bytes.
deadLetterOnly
Optional.If you set this option to true, only dead letter subscriptions will be received. The default value is false.
localOnly
Optional. If you set this option to true, only messages originating (published) from the local machine will be received. The default value is false.
priorityOrdering
Optional.Whether or not the subscribers' queues order messages by priority. The default value is true.
sharedState
Optional. Whether to allow multiple connections to share the same Broker client for the subscription. The default value is false.
If sharedState is set to true, webMethods Broker used as a JMS provider creates Broker clients as shared state clients for the connection.
sharedStateOrdering
Optional. The ordering of documents received on a shared state client. The default value is none.
*To receive documents in order from a publisher, set to publisher.
*To receive documents in any order, set to none.
Example
The following changes the name of the topic that is bound to the name nNewEmp:
\> modify topic nNewEmp with topicName=Acme::JMS::Topics::HR::NewEmp
Related Commands
Bind Topic
Create Topic
Delete Topic