PreviousNext

rpcgroup list

Returns a list of the names of all members of the specified group. The syntax is:

rpcgroup list rpcgroup_name_list [-member member_name_list] [-noupdate]

Options

-noupdate
Usually, name service data is cached locally on each machine in a cell. If a name service inquiry can be satisfied by data in the local CDS cache, this cached data is returned. However, locally cached copies of name service data might not include a recent CDS update. If the -noupdate option is not specified, dcecp goes to a CDS server to retrieve the required data, updating the local CDS cache. Use the -noupdate option (to avoid taking the time to update the local cache) when you believe that the local cache is up to date.

-member member_name_list
Specifies a list of names of one or more members to be returned from all groups named in the rpcgroup_name_list argument. Use this option to check for specific member names. The value of the -member option is a list of names of RPC entries, RPC groups, or RPC profiles; they are only references stored in the RPC group and do not need to actually exist outside of the group. All members specified are listed from all RPC groups specified in the argument.

Description
The rpcgroup list operation returns a list of the names of all members of the specified group. The returned names are fully qualified names and are returned in an arbitrary order. The argument is a list of names of RPC groups to have their member's names returned.

Privileges Required
You need r (read) permission to the CDS object entry (the target group entry).

Examples
The following example lists all the members of the group /.:/subsys/applications/infobases, in the order in which they were added to the group:

dcecp> rpcgroup list /.:/subsys/applications/infobases
/.../my_cell.goodcompany.com/subsys/applications/video_server
/.../my_cell.goodcompany.com/subsys/applications/bbs_server
/.../my_cell.goodcompany.com/subsys/applications/audio_server1
/.../my_cell.goodcompany.com/subsys/applications/audio_server2
/.../my_cell.goodcompany.com/subsys/applications/clipart_server
/.../my_cell.goodcompany.com/subsys/applications/photo_server1
/.../my_cell.goodcompany.com/subsys/applications/photo_server2
dcecp>

The following example uses the -member option to list a specific member of the group /.:/subsys/applications/infobases.

dcecp> rpcgroup list /.:/subsys/applications/infobases \
> -member /.:/subsys/applications/bbs_server
/.../my_cell.goodcompany.com/subsys/applications/bbs_server
dcecp>