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 the client gracefully and to display a limited set of the attribute and counter information that is currently known to the client. 

Arguments

client_name
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 

   operation
The name of the cdsclient  operation for which to display help information. 

Attributes

Authentication_Failures
The number of authentication failures encountered by the client since it started.

Cache_Bypasses
The number of times the client bypassed the cache when looking for information.

Cache_Hits
The number of times the client used the cache when looking for information.

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

Miscellaneous_Operations
The number of non-read, non-write operations processed by the client since it started.

Protocol_Errors
The number of protocol errors encountered by the client since it started.

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

Write_Operations
The number of write operations processed by the client 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

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

verboseDisplays information about the cdsclient  object. 

Used without an argument or option, cdsclient help  returns brief information about each cdsclient  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 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 operations 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-server
{Creation_Time 1995-10-11-15:09:45.187-04:00I-----}
{Protocol_Errors 0}
{Authentication_Failures 0}
{Read_Operations 78935}
{Cache_Hits 55007}
{Cache_Bypasses 23726}
{Write_Operations 50}
{Miscellaneous_Operations 53}
dcecp> 

Related Information

Commands: cdsadv(8cds) , cds(8dce) , dcecp(8dce) .