modifySIBJMSTopic command

Use the modifySIBJMSTopic command to change the properties of a JMS topic for the default messaging provider at a specific scope.

To run the command, use the AdminTask object of the wsadmin scripting client.

[IBM i][IBM i]The wsadmin scripting client is run from Qshell.

Command-line help is provided for service integration bus commands:
  • For a list of the available service integration bus JMS commands in Jython and a brief description of each command, enter the following command at the wsadmin prompt:

    print AdminTask.help('SIBJMSAdminCommands')

  • For overview help on a given command, enter the following command at the wsadmin prompt:

    print AdminTask.help('command_name')

After using the command, save your changes to the master configuration by using the following command:

AdminConfig.save()

Purpose

This command changes the properties of a JMS topic for the default messaging provider at a specific scope.

Target object

A JMS topic.

Required parameters

None.

Optional parameters 

-name jmstopic_name
-jndiName jndi_name
-description text
-topicName topic_name
-topicSpace topicspace_name
-deliveryMode Application | NonPersistent | Persistent
-timeToLive time
-priority priority
-readAhead AsConnection | AlwaysOn | AlwaysOff
-busName name

Example

  • Using Jython:
    wsadmin>AdminConfig.getid("/Node:9994GKCNode01")
'9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)'

wsadmin>AdminTask.modifySIBJMSTopic("jmstopic2(cells/9994GKCNode01Cell/nodes/
9994GKCNode01|resources.xml#J2CAdminObject_1098738992263)", ["-jndiName",
 "jms/jnmstopic2", "-topicName", "archery", "-readAhead", "AlwaysOn"])
'jmstopic2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
J2CAdminObject_1098738992263)'

wsadmin>AdminTask.showSIBJMSTopic("jmstopic2(cells/9994GKCNode01Cell/nodes/
9994GKCNode01|resources.xml#J2CAdminObject_1098738992263)")
'{topicSpace=sportshall, deliveryMode=Application, jndiName=jms/jnmstopic2, 
busName=, readAhead=AlwaysOn, name=jmstopic2, timeToLive=, priority=, 
topicName=archery}'
  • Using Jacl:
    wsadmin>$AdminConfig getid /Node:9994GKCNode01
9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)

wsadmin>$AdminTask modifySIBJMSTopic 
jmstopic2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
J2CAdminObject_1098738992263)
 {-jndiName jms/jnmstopic2 -topicName archery -readAhead AlwaysOn}
jmstopic2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
J2CAdminObject_1098738992263)

wsadmin>$AdminTask showSIBJMSTopic 
jmstopic2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
J2CAdminObject_1098738992263)
{topicSpace=sportshall, deliveryMode=Application, jndiName=jms/jnmstopic2, 
busName=, readAhead=AlwaysOn, name=jmstopic2, timeToLive=, priority=, 
topicName=archery}