createSIBJMSTopic command

Use the createSIBJMSTopic command to create a new 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 creates a JMS topic for the default messaging provider at a specific scope.

Target object

Scope of the default messaging provider at which the JMS topic is to be created.

Required parameters 

-name jmstopic_name
-jndiName jndi_name

Optional parameters 

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

Example

Note: In the following examples, code blocks beginning with wsadmin> show code that is entered by the user. Lines that do not begin with wsadmin> show code that has been returned by the console.
  • Using Jython:
    wsadmin>AdminConfig.getid("/Node:9994GKCNode01" )

    '9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)'

    wsadmin>AdminTask.createSIBJMSTopic("9994GKCNode01(cells/9994GKCNode01Cell/
nodes/9994GKCNode01|node.xml#Node_1)", ["-name", "jmstopic2", "-jndiName",
 "jms/jnmstopic2", "-topicSpace", "sportshall"])

    'jmstopic2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
J2CAdminObject_1098738992263)'

    wsadmin>AdminTask.listSIBJMSTopics("9994GKCNode01(cells/9994GKCNode01Cell/
nodes/9994GKCNode01|node.xml#Node_1)")

    'topic1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
J2CAdminObject_1098738449292)
jmstopic2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
J2CAdminObject_1098738992263)'
  • Using Jacl:
    wsadmin>$AdminConfig getid /Node:9994GKCNode01

    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)

    wsadmin>$AdminTask createSIBJMSTopic 
9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
 {-name jmstopic2 -jndiName jms/jnmstopic2 -topicSpace sportshall}
jmstopic2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
J2CAdminObject_1098738992263)

    wsadmin>$AdminTask listSIBJMSTopics 
9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)

    topic1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
J2CAdminObject_1098738449292)
jmstopic2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
J2CAdminObject_1098738992263)