PreviousNext

server catalog

Returns a list of the names of all server configuration objects on a specified host. The syntax is:

server catalog [host_name_list] [-executing] [-simplename] [-local]

Options

-executing
Returns the name of all servers known by dced that are currently running on the specified host.

-simplename
Returns names but removes the /.../cellname/hosts/hostname/config/service/ portion of the name.

-local
Specifies that the command is to operate on the local dced object while the dced on the local machine is in partial service mode.

Description
The server catalog operation returns a list of the names of all server configuration objects on a specified host. If called with the -executing option, it returns the name of all server execution objects (running servers) known by dced that are currently executing on the specified host. If called with no arguments, it returns information about the servers on the local host. The optional host_name_list argument is a list of host names. If more than one is specified then the information returned is concatenated. The order of information returned is arbitrary. Fully qualified names are returned by default; use the -simplename option to return the names without prepending the cell name and the name of the server container.

Privileges Required
You must have r (read) permission to the applicable container (configuration or execution) object.

Examples

dcecp> server catalog /.:/hosts/foster
/.:/hosts/foster/config/srvconf/try_tserver
dcecp>