cdsclient(1m)                                                 cdsclient(1m)




 NAME    [Toc]    [Back]
      cdsclient - A dcecp object that represents a Cell Directory Service
      client

 SYNOPSIS    [Toc]    [Back]
      cdsclient disable client_name

      cdsclient help [operation | -verbose]

      cdsclient operations

      cdsclient show client_name

 DESCRIPTION    [Toc]    [Back]
      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    [Toc]    [Back]
      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    [Toc]    [Back]
      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    [Toc]    [Back]
    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.



 Hewlett-Packard Company            - 1 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96






 cdsclient(1m)                                                 cdsclient(1m)




      Example

      dcecp> cdsclient disable /.:/hosts/blech/cds-clerk.ft3 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
      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.ft3 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.ft3 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



 Hewlett-Packard Company            - 2 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96






 cdsclient(1m)                                                 cdsclient(1m)




      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.ft3 {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    [Toc]    [Back]
      Commands:
       cdsadv(1m),
       dcecp(1m),
       dcecp_cds(1m).


 Hewlett-Packard Company            - 3 -OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96