removeUserFromTopicRole command

Use the removeUserFromTopicRole command to remove a user from a topic role within a specified topic space.

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.

This command is valid only when used with WebSphere® Application Server Version 7.0 or later application servers. Do not use it with earlier versions.

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

    print AdminTask.help('SIBAdminBusSecurityCommands')

  • 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

Use the removeUserFromTopicRole command to remove a user from the sender or receiver roles for a topic anywhere in the topic hierarchy for a local bus. Removing a user from topic roles prevents the user from accessing the topic space in the topic roles.

Target object

None.

Required parameters

-bus busName
The name of the local bus. You can use the listSIBuses command to list the names of existing buses.
-topicSpace topicSpaceName
The name of the topic space.
-topic topicName
The name of the topic.
-role roleType
You can specify the Sender or Receiver roles for a topic.
-user userName or uniqueName
The name of a user you want to remove from the topic roles for the local bus. You can type one of the following names:
  • A security user name.
  • A unique user name.

Conditional parameters

None.

Optional parameters

None.

Examples

The following example removes a user called User1, from the Sender role for a topic called football, in the topic space called Sport, on a local bus called Bus1.

AdminTask.removeUserFromTopicRole ('[-bus Bus1 -topicSpace Sport 
 -topic football -role Sender -user User1]')