Displays current information about the specified server.
SYNOPSIS
SHOW [NODE node-id] DNS SERVER [attribute-specifier]
Arguments
node-id
The name of the node. If you do not specify a node name, the local
node is assumed.
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 status
Authentication Failures
Child Pointer Update Failures
Creation Time
Crucial Replica Removals Backed Out
Future Skew
Incompatible Protocol Errors
Maximum Protocol Version
Minimum Protocol Version
Possible Cycles
Read Accesses
Security Failures
Skulks Completed
Skulks Initiated
State
Times Lookup Paths Broken
UID
Version
Write Accesses
Description
This command displays the names and values of the attributes or
attribute groups named in the attribute-specifier argument. 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.
PRIVILEGES REQUIRED
You must have the NET$EXAMINE rights identifier on a VMS system. No
special privileges are required on an ULTRIX system.
1 – attributes
The following are descriptions of valid characteristics, counters, and status attributes: CHARACTERISTICS Future Skew Specifies the maximum amount of time that a timestamp can vary from local system time at the server node. This characteristic ensures data consistency. Maximum Protocol Version Specifies the maximum version of the DECdns clerk/server protocol that this particular DECdns server supports. Minimum Protocol Version Specifies the minimum version of the DECdns clerk/server protocol that this particular DECdns server supports. UID Uniquely identifies the entity. Version Specifies the version of the architecture implemented by this server. COUNTERS Authentication Failures Specifies the number of times a requesting principal failed authentication procedures. Child Pointer Update Failures Specifies the number of times the server background process was unable to contact all the clearinghouses where a replica of a particular child directory's parent directory is stored, and was therefore unable to apply the child updates that have occurred since the last skulk. This counter increases by one at each occurrence of the Cannot Update Child Pointer event. Creation Time Specifies the time when the DECdns server entity was created. Crucial Replica Removals Backed Out Specifies the number of times a user attempted (from this server) to remove a replica that is crucial to the connectivity of a directory hierarchy. The server background process prevents users from accidentally disconnecting lower-level directories from higher- level directories. When it detects an attempt to remove a crucial replica, it will not execute the command to do so. This counter increases by one at each occurrence of the Crucial Replica event. Incompatible Protocol Errors Accounts for the total number of requests received by this server from a clerk running an incompatible protocol version. A server can communicate with any clerk running the same protocol version, or the version previous to the one it is running. This counter increases by one at each occurrence of the Incompatible Request event. Possible Cycles Specifies the number of times this server followed a chain and encountered an entry already in the chain. For example, a soft link is created that points to a series of links that eventually point back to the first link, or a group which is a member of itself. This counter increases by one at occurrence of the Possible Cycles event. Read Accesses Specifies the number of read operations directed to this DECdns server. Security Failures Specifies the number of times the Security Failures event was generated. This counter is increased whenever a DECdns server has insufficient access rights to a directory or object to perform either a client-requested action or a background operation. Skulks Completed Specifies the number of skulks that were successfully completed by this DECdns server. Skulks Initiated Specifies the number of skulks that were initiated by this DECdns server. Times Lookup Paths Broken Specifies the number of broken connections between clearinghouses on this server and clearinghouses closer to the root. Incoming requests to this server that require a downward lookup in the directory hierarchy may still succeed, but requests requiring lookup in directories closer to the root will fail. This counter increases by one at each occurrence of the Broken Lookup Paths event. Write Accesses Specifies the number of write operations to this DECdns server. STATUS ATTRIBUTES State Specifies the state of the DECdns server. Broken The server has a fatal error condition. Initial The server is initializing. Off The server is not available. On The server is running and available. Shut The server is undergoing an orderly shutdown.
2 – example
The following command displays information about the number of completed skulks on the server running on node .sales.orion. dns> show node .sales.orion dns server skulks completed
3 – 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.
3.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.
3.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.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.