/sys$common/syshlp/helplib.hlb DCE_CDS, cdscp, show_clearinghouse  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME

   show clearinghouse - Displays attribute information about the specified
                        clearinghouse

 SYNOPSIS

   cdscp show clearinghouse clearinghouse-name [attribute-name]
                            [with attribute-name = attribute-value]

 ARGUMENTS

   clearinghouse-name
             The full name of a specific clearinghouse.  The last simple
             name can contain wildcard characters.

   attribute-name
             The name of a particular attribute; see Description for
             valid attribute names.

   attribute-value
             The value of a particular attribute.

 DESCRIPTION

   The show clearinghouse command displays the names and values of the
   attributes  specified in attribute-name.  You can use a combination
   of attributes in any sequence in a single command.  Use a space to
   separate multiple attributes.  You can use a with
   attribute-name = attribute-value clause to limit output only to
   clearinghouses whose attributes have values equal to the specified
   values.  A space must precede and follow the = (equals sign).

   If you do not supply any attributes, the command displays all
   attributes and their values.  The following list describes the
   clearinghouse attributes:

   CDS_AllUpTo
             Indicates the date and time the clearinghouse object has
             been updated to reflect the CDS_CHDirectories attribute.

   CDS_CHDirectories
             Specifies the full name and unique identifier (UUID) of
             every directory that has a replica in this clearinghouse.

   CDS_CHLastAddress
             Specifies the current reported network address of the
             clearinghouse.

   CDS_CHName
             Specifies the full name of the clearinghouse.

   CDS_CHState
             Specifies the state of the clearinghouse.  The state on
             indicates the clearinghouse is running and available.

   CDS_NSCellname
             Specifies the name of the cell in which the clearinghouse
             resides.

   CDS_CTS   Specifies the creation timestamp (CTS) of the clearinghouse.

   CDS_DirectoryVersion
             Specifies the directory version for new directories that
             are created in the clearinghouse.

   CDS_ObjectUUID
             Specifies the unique identifier of the clearinghouse.

   CDS_ReplicaVersion
             Specifies the current version of the replica in which the
             directory was created.

   CDS_UTS   Specifies the timestamp of the most recent update to an
             attribute of the clearinghouse.

   The following counters and their values are displayed only when you
   use this command to display all attributes and their values:

   Data Corruption Count
             Specifies the number of times that the data corruption event
             was generated

   Enables   Specifies the number of times that the clearinghouse was
             enabled since it was last started

   Read Accesses
             Specifies the number of read operations directed to this
             clearinghouse

   References Returned
             Specifies the number of requests directed to this
             clearinghouse that resulted in the return of a partial
             answer instead of satisfying the client's request

   Skulk Failures
             Specifies the number of times that a skulk of a directory,
             initiated from this clearinghouse, failed to complete -
             usually because one of the replicas in the replica set was
             unreachable

   Entry Missing Count
             Specifies the number of times the clearinghouse entry missing
             event was generated

   Root Not Reachable Count
             Specifies the number of times the root lost event was
             generated

   Upgrades Failed Counts
             Specifies the number of times that upgrades failed

   Write Accesses
             Specifies the number of write operations directed to this
             clearinghouse

   Disables  Specifies the number of times that the clearinghouse was
             disabled since it wsa last started

   Privilege Required

   You must have read permission to the clearinghouse.  If you specify a
   wildcard clearinghouse name, you also need read permission to the cell
   root directory.

 NOTE

   This command is replaced at Revision 1.1 by the dcecp command and
   may not be provided in future releases of DCE.

 EXAMPLE

   The following command displays the current values of the CDS_UTS
   and CDS_ObjectUUID attributes associated with the /.:/Chicago1_CH
   clearinghouse:

   cdscp> show clearinghouse /.:/Chicago1_CH CDS_UTS CDS-ObjectUUID

                    SHOW
           CLEARINGHOUSE   /.../abc.com/Chicago1_CH
                      AT   1991-10-21-13:12:30
                 CDS_UTS = 1991-10-21-13:04:04.000000009/08-00-2b-1c-8f-1f
          CDS_ObjectUUID = 3706d70c-8b05-11ca-9002-08002b1c8f1f

 RELATED INFORMATION

   Commands: clear clearinghouse
             create clearinghouse
             delete clearinghouse
             list clearinghouse
             set cdscp preferred clearinghouse
             show cdscp preferred clearinghouse