cdsclient(1m)															     cdsclient(1m)

NAME

       cdsclient - A dcecp object that represents a Cell Directory Service client

SYNOPSIS

       cdsclient disable client_name

       cdsclient help [operation | -verbose]

       cdsclient operations

       cdsclient show client_name

DESCRIPTION

       The  cdsclient object allows some low-level control over a CDS client in the local cell.  Use it to disable a running client by shutting it
       down gracefully and to display a limited set of the attribute and counter information that is currently known to the client.

ARGUMENTS

       The  name  of  one  CDS	client	running  somewhere  in	the  local  cell.   Specify  the  client  name	 using	 one   of   the   formats:
       /.../cell_name/hosts/host_name/cds-clerk

       /.:/hosts/host_name/cds-clerk The name of the cdsclient operation for which to display help information.

ATTRIBUTES

       The  number  of authentication failures encountered by the client since it started.  The number of times the client bypassed the cache when
       looking for information.  The number of times the client used the cache when looking for information.   The  date-time  stamp  representing
       when  the  current  client  started.  The number of non-read, non-write operations processed by the client since it started.  The number of
       protocol errors encountered by the client since it started.  The number of read operations processed by the client since it  started.   The
       number of write operations processed by the client since it started.

OPERATIONS

   cdsclient disable
       Disables the specified CDS client.  The syntax is as follows: cdsclient disable client_name

       The specified client 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 d (delete), w (write), and c (create) permissions on the namespace entry of the clerk.

       Example

       dcecp> cdsclient disable /.:/hosts/blech/cds-clerk dcecp>

   cdsclient help
       Returns help information about the cdsclient object and its operations.	The syntax is as follows: cdsclient help [operation | -verbose]

       Options Displays information about the cdsclient object.

       Used without an argument or option, cdsclient help returns brief information about each cdsclient 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 cdsclient object itself.

       Privileges Required

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

       Examples

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

   cdsclient operations
       Returns a list of the operations supported by the cdsclient object.  The syntax is as follows: cdsclient 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 cdsclient operations command.

       Examples

       dcecp> cdsclient operations disable show help operations dcecp>

   cdsclient show
       Returns attribute information about the specified CDS client.  The syntax is as follows: cdsclient show client_name

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

       Privileges Required

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

       Example

       dcecp>  cdsclient  show	/.:/hosts/blech/cds-clerk  {Creation_Time  1995-10-11-15:09:45.187-04:00I-----}  {Protocol_Errors  0} {Authentica-
       tion_Failures 0} {Read_Operations 78935} {Cache_Hits 55007} {Cache_Bypasses  23726}  {Write_Operations  50}  {Miscellaneous_Operations  53}
       dcecp>

RELATED INFORMATION

       Commands:
	cdsadv(1m),
	dcecp(1m),
	dcecp_cds(1m).

																     cdsclient(1m)