listGroupsInForeignBusRole command

Use the listGroupsInForeignBusRole command to list the groups in the sender role for a foreign bus.

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 listGroupsInForeignBusRole command to list the groups that can send 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.

Conditional parameters

None.

Optional parameters

-showUniqueNames TRUE | FALSE
Whether to display unique names. This parameter has two possible values:
TRUE
Unique names are displayed.
FALSE
Security names are displayed.
The default value is FALSE.

Examples

The following example lists the groups in the Sender role for a foreign bus called ForeignBus1. The local bus is called Bus1.

AdminTask.listGroupsInForeignBusRole ('[-bus Bus1 -foreignBus ForeignBus1 -role Sender]')