removeGroupFromForeignBusRole command

Use the removeGroupFromForeignBusRole command to remove a group from the sender role for a foreign bus.

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

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; for example, by using the following command:


AdminConfig.save()

Purpose

Use the removeGroupFromForeignBusRole command to remove a group from the sender role for a foreign bus. This prevents the group from sending messages from a local bus to a foreign bus.

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.
-foreignBus foreignBusName
The name of the foreign bus.
-role Sender
You can only specify the Sender role for a foreign bus.
-group groupName or uniqueName
The name of a group you want to remove from the sender role for a foreign bus. You can type one of the following names:
  • A security group name, or one of the following specialized group names:
    Server
    This group contains application servers.
    AllAuthenticated
    This group contains authenticated users only.
    Everyone
    This group contains all users. Each user is anonymous.
  • A unique group name.

Conditional parameters

None.

Optional parameters

None.

Example

The following example removes a group called Group1 from the Sender role for a foreign bus called ForeignBus1. The local bus is called Bus1.

AdminTask.removeGroupFromForeignBusRole ('[-bus Bus1 -ForeignBus ForeignBus1 -role Sender -group Group1]')



Related concepts
Role-based authorization
Foreign buses
Related tasks
Removing users and groups from foreign bus roles
Reference topic Reference topic    

Terms of Use | Feedback

Last updatedLast updated: Sep 19, 2011 6:15:55 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-express-dist&topic=rjr_del_gp_fbus_role
File name: rjr_del_gp_fbus_role.html