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.