cds(1m) 																   cds(1m)

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

       The  name  of  the  cds	operation  for which to display help information.  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

       The number of times the server failed to update a child replica.  The date-time stamp representing when the current  server  started.   The
       number  of  crucial  replicas known to the server.  The skew time allowed the server.  The list of clearinghouses known to the server.  The
       number of read operations processed by the server since it started.  The number of times the CDS server had problems with the cell Security
       Service.   The  number  of skulks completed by the server since it started.  The number of skulks initiated by the server since it started.
       The number of times the lookup path was	broken during a server operation.  The number of write operations processed by the server since it
       started.

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 Displays 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  argu-
       ment  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(1m), dcecp(1m), dcecp_cdsclient(1m).

																	   cds(1m)