NAME

cds  — A dcecp object that represents a Cell Directory Service server

SYNOPSIS

cds disable server_name

cds help  [operation | verbose  ]

cds operations

cds show server_name

Arguments

operationThe name of the cds  operation for which to display help information. 

server_name
The name of one CDS server running somewhere in the local cell. Specify the server name in one of the following formats:

/.../cell_name/hosts/host_name/cds-server
/.:/hosts/host_name/cds-server

Description

The cds  object allows some low-level control over a CDS server in the local cell.  Using it, you can disable a running server, which causes it to shut down gracefully.  This command will also display a limited set of the attribute and counter information currently known to the specified server. 

Attributes

Child_Update_Failures
The number of times the server failed to update a child replica.

Creation_Time
The date-time stamp representing when the current server started.

Crucial_Replicas
The number of crucial replicas known to the server.

Future_Skew_Time
The skew time allowed the server.

Known_Clearinghouses
The list of clearinghouses known to the server.

Read_Operations
The number of read operations processed by the server since it started.

Security_Failures
The number of times the CDS server had problems with the cell Security Service.

Skulks_Completed
The number of skulks completed by the server since it started.

Skulks_Initiated
The number of skulks initiated by the server since it started.

Times_Lookup_Paths_Broken
The number of times the lookup path was  broken during a server operation.

Write_Operations
The number of write operations processed by the server since it started.

Errors

A representative list of errors that might be returned is not shown here.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

Operations

cds disable

Disables the specified CDS server.  The syntax is as follows:

cds disable server_name

The specified server must be running somewhere in the local cell, and you must have the privileges to access that machine.   This operation returns an empty string on success. 

Privileges Required

You must have dwc (delete , write, create ) permissions on the namespace entry of the server. 

Example

dcecp> cds disable /.:/hosts/blech/cds-server
dcecp> 

cds help

Returns help information about the cds  object and its operations.  The syntax is as follows:

cds help [operation | verbose ]

Options

verboseDisplays information about the cds  object. 

Used without an argument or option, the cds help  command returns brief information about each cds  operation.  The optional operation argument is the name of an operation about which you want detailed information.  Alternatively, you can use the verbose  option to display detailed information about the cds  object itself. 

Privileges Required

No special privileges are needed to use the cds help  command. 

Examples

dcecp> cds help
disable             Disables the specified CDS server.
show                Returns attribute information about the named CDS server.
help                Prints a summary of command-line options.
operations          Returns a list of the valid operations for this command.
dcecp> 

cds operations

Returns a list of the operations supported by the cds object.  The syntax is as follows:

cds operations

The list of available operations is in alphabetical order except for help  and operations, which are listed last. 

Privileges Required

No special privileges are needed to use the cds operations command. 

Examples

dcecp> cds operations
disable show help operations
dcecp> 

cds show

Returns attribute information about the specified CDS server.  The syntax is as follows:

cds show server_name

The attributes returned mostly represent counter information, which can be used to help isolate a problems with a CDS server.  The order in which the attributes are returned is fixed within CDS. 

Privileges Required

You must have r (read) permissions on the namespace entry of the server. 

Examples

dcecp> cds show /.:/hosts/blech/cds-server
{Creation_Time 1995-10-11-10:06:31.434-04:00I-----}
{Future_Skew_Time 0}
{Read_Operations 141384}
{Write_Operations 3589}
{Skulks_Initiated 278}
{Skulks_Completed 278}
{Times_Lookup_Paths_Broken 0}
{Crucial_Replicas 0}
{Child_Update_Failures 0}
{Security_Failures 0}
{Known_Clearinghouses /.../gumby1/blech_ch}
dcecp> 

Related Information

Commands: cdsd(8dce), dcecp(8dce),   cdsclient(8dce).