listGroupsInDestinationRole command
Use the listGroupsInDestinationRole command to list the groups in the destination roles for a local bus.
如果要執行這個指令,請使用 wsadmin Scripting 用戶端的 AdminTask 物件。
wsadmin Scripting 用戶端是從 Qshell 執行.
如需相關資訊,請參閱利用 wsadmin Script 配置 Qshell 來執行 WebSphere Script.
- 如需 Jython 中可用的服務整合匯流排安全指令清單,以及每個指令的簡要說明,請在 wsadmin 提示下,輸入下列指令:
print AdminTask.help('SIBAdminBusSecurityCommands')
- 如需給定指令的概觀說明,請在 wsadmin 提示下,輸入下列指令:
print AdminTask.help('command_name')
AdminConfig.save()
Purpose
Use the listGroupsInDestinationRole command to list all the groups in destination roles for a selected local bus. The roles you can specify depend on the type of destination.
Target object
None.
Required parameters
- -type destinationType
- You can specify one of the following destination types:
- Queue
- Port
- TopicSpace
- ForeignDestination
- Alias
The allowed roles for a destination depend on the type of the destination as defined in Administering destination roles.
If you are specifying a destinationType that is either foreignDestination or alias, the foreign bus name that you specify must be the name of the foreign bus hosting the destination.
If you specify a destinationType of queue or topic, the foreign bus name is ignored. The authorization is granted against the destination in the local bus.
- -bus busName
- The name of the local bus. You can use the listSIBuses command to list the names of existing buses.
- -role roleType
- You can specify one of the following role types, depending on the -type you
have specified.
- Sender
- This role type is authorized to send messages to destinations on the local bus.
- Receiver
- This role type is authorized to receive messages from destinations on the local bus.
- Browser
- This role type is authorized to browse messages on destinations on the local 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.
Examples
The following example lists groups in the Sender role for a queue type destination called Queue1, on a local bus called Bus1.
AdminTask.listGroupsInDestinationRole ('[-type queue -bus Bus1 -destination Queue1 -role Sender]')
The following example lists groups in the Receiver role for a queue type destination called Queue2, on a local bus called Bus1.
AdminTask.listGroupsInDestinationRole ('[-type queue -bus BusName -destination Queue2 -role Receiver]')