DNS$CPHELP.HLB  —  show  dns  server  clearinghouse
 Displays current NCL attribute information about the specified
 clearinghouse.

 SYNOPSIS

      SHOW [NODE node-id] DNS SERVER CLEARINGHOUSE

      clearinghouse-name [attribute-specifier] [prepositional-phrase]

 Arguments

 node-id

 The name of the node. If you do not specify a node name, the local
 node is assumed.

 clearinghouse-name

 A specific clearinghouse name or a complete directory specification
 followed by a wildcard template for matching clearinghouse simple
 names.

 attribute-specifier

 The name of an attribute or an attribute group. Enter one or more of
 the following attribute specifiers:

 all [attributes]
 all characteristics
 all counters
 all identifiers
 all status
 Creation Time
 Data Corruptions
 Disable Counts
 CTS
 Enable Counts
 Name
 Read Accesses
 References Returned
 Skulk Failures
 State
 Times Clearinghouse Entry Missing
 Times Root Not Reachable
 UID
 Upgrades Not Possible
 Write Accesses

 prepositional phrase

 A phrase that affects the content of command output. Specify the
 following prepositional phrase:

 with attribute [relop] value

 Description

 This command displays the names and values of the attributes or
 attribute groups named in attribute-specifier. You can also enter
 this command through the NCL interface. You can use any combination
 of attribute specifiers in any sequence in a single command. Use
 a comma to separate specifiers. If you do not supply any attribute
 specifier, the command displays all identifiers and their values.

 ACCESS RIGHTS
 You need read access to the clearinghouse to display a list of known
 attributes or the value of an attribute.

 PRIVILEGE REQUIRED
 You must have the NET$EXAMINE rights identifier on a VMS system. No
 special privileges are required on an ULTRIX system.

1  –  characteristics

 Every DECdns entity has attributes, which are pieces or sets of data
 associated with that entity. The following are descriptions of valid
 ncl attributes:

 CHARACTERISTIC

 CTS

 Specifies the creation timestamp (CTS) of this clearinghouse.

 UID

 Uniquely identifies the entity.

 COUNTERS

 Creation Time

 Specifies the time at which the clearinghouse entity was created.

 Data Corruptions

 Specifies the number of times that the Data Corruption event was
 generated.

 Disable Counts

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

 Enable Counts

 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.

 Times Clearinghouse Entry Missing

 Specifies the number of times the Clearinghouse Entry Missing event
 was generated.

 Times Root Not Reachable

 Specifies the number of times the Root Lost event was generated.

 Upgrades Not Possible

 Specifies the number of times that the clearinghouse tried to
 upgrade a directory and failed.

 Write Accesses

 Specifies the number of write operations directed to this
 clearinghouse.

 IDENTIFIER

 Name

 Specifies the full name of the clearinghouse.

 STATUS ATTRIBUTES

 State

 Specifies the state of the clearinghouse.

 Broken     The clearinghouse has a fatal error condition.
 Initial    The clearinghouse is in the process of initializing.
 Off        The clearinghouse is not available.
 On         The clearinghouse is running and available.
 Shut       The clearinghouse is in the process of an orderly
            shutdown.

 PREPOSITIONAL PHRASES
 You can affect the content of command output by using prepositional
 phrases. Be sure to precede the following prepositional phrase with
 a comma and a space:

 with attribute [relop] value

 When used with a wildcard clearinghouse-name, limits the output only
 to directories whose specified attributes have certain values.

2  –  example

 The following command displays the current value of the Write
 Accesses counter associated with the .chicago1_ch clearinghouse
 on server node .midwest1.

 dns> show node .midwest1 dns server clearinghouse .chicago1_ch 0 -
 _> Write Accesses

3  –  prepositional_phrases

 A phrase that affects the destination or content of command output.
 Be sure to precede the following prepositional phrase with a comma
 and a space:

 with attribute [relop] value        When used with a wildcard child-
                                     name, limits the output only
                                     to directories whose specified
                                     attributes have certain values.
Close Help