show clearinghouse(8cds)

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 was last started

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

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

Examples
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(8cds)

create clearinghouse(8cds)

delete clearinghouse(8cds)

list clearinghouse(8cds)

set cdscp preferred clearinghouse(8cds)

show cdscp preferred clearinghouse(8cds)