1 – child
Displays current information about the specified child pointer.
SHOW CHILD child-name [attribute-specifier]
[prepositional-phrase]
ARGUMENTS
child-name
A specific child name or a complete directory specification followed
by a wildcard template for matching simple names of child pointers.
attribute-specifier
The name of an attribute or an attribute group. Enter one or more of
the following attribute-specifiers:
all [attributes]
all characteristics
DNS$ChildCTS
DNS$CTS
DNS$Replicas
DNS$UTS
prepositional-phrase
A phrase that affects the destination or content of command output.
DESCRIPTION
This command displays the names and values of the attributes or
attribute groups named in attribute-specifier. If you do not supply
any attribute specifier, the command displays all attributes and
their values. You can use any combination of attribute specifiers
in any sequence in a single command. Use a comma to separate
specifiers.
ACCESS RIGHTS
You must have read access to the directory in which the child
pointer is located.
1.1 – characteristics
Every DECdns entity has attributes, which are pieces or sets of data associated with that entity. Characteristics are attributes that reflect or affect the operational behavior of an entity. The following are descriptions of valid characteristics: DNS$ChildCTS Specifies the creation timestamp (CTS) of the child directory referenced by the child pointer. DNS$CTS Specifies the CTS of the specified child pointer. DNS$Replicas Specifies the address, CTS, and name of a set of clearinghouses where a copy of the child directory referenced by the child pointer is located. This attribute also specifies whether the directory in a particular clearinghouse is a master or read-only replica. DNS$UTS Specifies the timestamp of the most recent update to an attribute of the child pointer.
1.2 – example
The following command displays the creation timestamp (CTS) of the child directory .sales to which the child pointer refers. dns> show child .sales dns$cts
1.3 – prepositional_phrases
A phrase that affects the destination or content of command output.
You can use one or more prepositional phrases. Be sure to precede
each of the following prepositional phrases 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.
to file[=]filename Redirects the output to
filename. If the file does not
exist, this command creates
it. If the file does exist, its
contents are overwritten.
to extend file[=]filename Appends the output to an
existing filename. If the file
does not exist, it is created.
to terminal Directs the output to the
terminal. This is the default
option.
2 – clearinghouse
Displays DECdns attribute information about the specified
clearinghouse.
SYNOPSIS
SHOW CLEARINGHOUSE clearinghouse-name
[attribute-specifier] [prepositional-phrase]
Arguments
clearinghouse-name
A specific clearinghouse name or a complete directory specification
followed by a wildcard template for matching simple names of
clearinghouses.
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 identifiers
all status
DNS$ACS
DNS$CHCTS
DNS$CHDirectories
DNS$CHLastAddress
DNS$CHName
DNS$CHState
DNS$CHUpPointers
DNS$NSCTS
DNS$NSNickname
DNS$UTS
prepositional-phrase
A phrase that affects the destination or content of command output.
Specify one or more of the following prepositional phrases:
with attribute [relop] value
to file[=]filename
to extend file[=]filename
to terminal
Description
This command displays the names and values of the attributes or
attribute groups named in attribute-specifier. 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 attributes 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.
2.1 – access
Displays the access control set of a clearinghouse.
SYNOPSIS
SHOW CLEARINGHOUSE clearinghouse-name ACCESS
[prepositional-phrase]
Arguments
clearinghouse-name
The name of the clearinghouse for which you want to see the access
control set. It can be a specific clearinghouse name or a complete
directory specification followed by a wildcard template for matching
simple names of clearinghouses.
prepositional-phrase
You can affect the destination or content of command output by using
prepositional phrases.
ACCESS RIGHTS
You need read access to the clearinghouse.
2.1.1 – example
The following example is a command that displays the access control set of the .ny_ch clearinghouse. dns> show clearinghouse .ny_ch access
2.1.2 – prepositional_phrases
A phrase that affects the destination or content of command output.
You can use one or more prepositional phrases. Be sure to precede
each of the following prepositional phrases with a comma and a
space:
to file[=]filename Redirects the output to
filename. If the file does not
exist, this command creates
it. If the file does exist, its
contents are overwritten.
to extend file[=]filename Appends the output to an
existing filename. If the file
does not exist, it is created.
to terminal Directs the output to the
terminal. This is the default
option.
2.2 – characteristics
Every DECdns entity has attributes, which are pieces or sets of
data associated with that entity. 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 attributes and their values. The
following are descriptions of valid clearinghouse attributes:
CHARACTERISTICS
DNS$ACS
Specifies the access control set for the clearinghouse.
DNS$CHCTS
Specifies the time at which the clearinghouse was created.
DNS$CHLastAddress
Specifies the current reported network address of the clearinghouse.
DNS$CHUpPointers
Specifies pointers to clearinghouses that contain replicas closer
to the root than those in this clearinghouse. If the attribute
has no values, either this clearinghouse stores a replica of the
root directory, or it has not yet obtained the necessary up-pointer
information from other clearinghouses.
DNS$NSCTS
Specifies the creation timestamp of the namespace of which the
clearinghouse is a part.
DNS$NSNickname
Specifies the nickname of the namespace of which the clearinghouse
is a part.
DNS$UTS
Specifies the timestamp of the most recent update to an attribute of
the clearinghouse.
IDENTIFIER
DNS$CHName
Specifies the full name of the clearinghouse.
STATUS ATTRIBUTES
DNS$CHDirectories
Specifies the full name and creation timestamp (CTS) of every
directory that has a replica in this clearinghouse.
DNS$CHState
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.
2.3 – example
The following command displays the current values of the DNS$ACS attribute associated with the .chicago1_ch clearinghouse. dns> show clearinghouse .chicago1_ch DNS$ACS
2.4 – prepositional_phrases
A phrase that affects the destination or content of command output.
You can use one or more prepositional phrases. Be sure to precede
each of the following prepositional phrases 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.
to file[=]filename Redirects the output to
filename. If the file does not
exist, this command creates
it. If the file does exist, its
contents are overwritten.
to extend file[=]filename Appends the output to an
existing filename. If the file
does not exist, it is created.
to terminal Directs the output to the
terminal. This is the default
option.
3 – directory
Displays current information about the specified directory.
SYNOPSIS
SHOW DIRECTORY directory-name [attribute-specifier]
[prepositional-phrase])
Arguments
directory-name
A specific directory name or a complete directory specification
followed by a wildcard template for matching simple names of
directories.
attribute-specifier
The name of an attribute group or a particular attribute. Enter one
or more of the following attribute specifiers:
all [attributes]
all characteristics
DNS$ACS
DNS$AllUpTo
DNS$Convergence
DNS$CTS
DNS$DirectoryVersion
DNS$InCHName
DNS$ParentPointer
DNS$Replicas
DNS$UpGradeTo
DNS$UTS
prepositional phrase
A phrase that affects the destination or content of command output.
Specify one or more of the following prepositional phrases:
with attribute [relop] value
to file[=]filename
to extend file[=]filename
to terminal
Description
This command displays the names and values of the attributes or
attribute groups named in attribute-specifier. If you do not supply
any attribute specifier, the command displays all attributes and
their values. You can use any combination of attribute specifiers
in any sequence in a single command. Use a comma to separate
specifiers.
ACCESS RIGHTS
You need read access to the directory to use the show command.
3.1 – access
Displays the access control set of a directory.
SYNOPSIS
SHOW DIRECTORY directory-name ACCESS [prepositional-phrase]
Arguments
directory-name
A specific directory name or a complete directory specification
followed by a wildcard template for matching simple names of
directories.
prepositional-phrase
ACCESS RIGHTS
You must have read access to the directory.
3.1.1 – example
The following command displays the access control set of the directory .sales and stores the output in a file called sdshow. dns> show directory .sales access, to file sdshow
3.1.2 – prepositional_phrases
A phrase that affects the destination or content of command output.
You can use one or more prepositional phrases. Be sure to precede
each of the following prepositional phrases with a comma and a
space:
to file[=]filename Redirects the output to
filename. If the file does not
exist, this command creates
it. If the file does exist, its
contents are overwritten.
to extend file[=]filename Appends the output to an
existing filename. If the file
does not exist, it is created.
to terminal Directs the output to the
terminal. This is the default
option.
3.2 – attributes
Every DECdns entity has attributes, which are pieces or sets of
data associated with that entity. Characteristics are attributes
that reflect or affect the operational behavior of an entity. If
you do not supply any specified attribute, the command displays
all attributes and their values. You can use any combination of
specified attributes in any sequence in a single command. Use a
comma to separate attributes. The following are descriptions of
valid attributes:
CHARACTERISTICS
DNS$ACS
Specifies the access control set for the directory.
DNS$AllUpTo
Indicates the date and time of the last successful skulk on the
directory. All replicas of the directory are guaranteed to have
received all updates whose timestamps are less than the value of
this characteristic.
DNS$Convergence
Specifies the degree of consistency among replicas. This attribute's
value can be one of the following:
Low The next skulk distributes all updates that occurred
since the previous skulk. Skulks occur at least once
every 24 hours.
Medium DECdns attempts to propagate an update to all
replicas. If the attempt fails, the next scheduled
skulk makes the replicas consistent. Skulks occur at
least once every 12 hours.
High DECdns attempts to propagate an update to all
replicas. If the attempt fails (for example, if
one of the replicas is unavailable), a skulk is
scheduled for within 1 hour. Background skulks will
occur at least once every 12 hours. Use this setting
temporarily and briefly, because it uses extensive
system resources.
By default, every directory inherits the convergence setting of its
parent at creation time. The default setting of the root directory
is medium.
DNS$CTS
Specifies the creation timestamp (CTS) of the directory DECdns.
DNS$DirectoryVersion
Specifies the current version of the directory (derived from the
DNS$Directory
Version attribute of the clearinghouse in which the directory was
created). Multiple directory versions are supported in a namespace.
DNS$InCHName
Specifies whether a directory or any of its descendants can store
clearinghouse names. If this value is True, the directory can store
clearinghouse names. If it is False, the directory cannot store
clearinghouse names.
DNS$ParentPointer
Contains a set of pointers to replicas of this directory's parent in
the namespace.
DNS$Replicas
Specifies the address, creation timestamp (CTS), and name of
every clearinghouse where a replica of this directory is located.
This attribute also specifies whether the replica in a particular
clearinghouse is a master or read-only replica.
DNS$UpgradeTo
Controls the upgrading of a directory from one version of DECdns to
another. By modifying this attribute, you can initiate the upgrading
of a directory to a newer version of DECdns.
DNS$UTS
Specifies the timestamp of the most recent update to an attribute of
the directory.
3.3 – example
The following command displays the creation timestamp (CTS), the time at which the .admin directory was created. dns> show directory .admin dns$cts
3.4 – prepositional_phrases
A phrase that affects the destination or content of command output.
You can use one or more prepositional phrases. Be sure to precede
each of the following prepositional phrases 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.
to file[=]filename Redirects the output to
filename. If the file does not
exist, this command creates
it. If the file does exist, its
contents are overwritten.
to extend file[=]filename Appends the output to an
existing filename. If the file
does not exist, it is created.
to terminal Directs the output to the
terminal. This is the default
option.
4 – dns
4.1 – clerk
Displays current information about the specified DECdns clerk.
SYNOPSIS
SHOW [NODE node-id] DNS CLERK [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
Cache Bypasses
Cache Hits
Clerk Timeout
Creation Time
Default Namespace
Incompatible Protocol Errors
Miscellaneous Operations
Read Operations
Solicit Holddown
State
UID
Version
Write Operations
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.
The following is a description of the clerk attributes:
4.1.1 – attributes
CHARACTERISTICS Clerk Timeout Specifies the default timeout of client interface calls. If no response is received in the specified time, an error message will be generated. The default is 60 seconds. Default Namespace Contains the name of the clerk's default namespace. Solicit Holddown Specifies the time (in seconds) to wait after initialization before soliciting advertisements from servers. The default is 15 seconds. UID Uniquely identifies the entity. Version Specifies the version of the DECdns architecture implemented by this clerk. COUNTERS Authentication Failures Specifies the number of times a requesting principal failed authentication procedures. Cache Bypasses Specifies the number of requests to read attributes for which the clerk was specifically directed by the requesting application to bypass its own cache. Instead, a server is contacted to get the requested information. This counter does not account for requests that the clerk is unable to satisfy from the cache or for requests to look up names or enumerate the contents of directories. Cache Hits Specifies the total number of read requests directed to this clerk that were satisfied entirely by the information contained in its own cache. This figure accounts only for requests to read attribute values and does not include requests to look up names or enumerate the contents of directories. Creation Time Specifies the time at which this entity was created. Incompatible Protocol Errors Specifies the number of times this clerk received a response to one of its own requests from a server running a protocol version of DECdns software that was incompatible with the protocol version of DECdns software the clerk was running. Clerk requests directed to servers running incompatible protocol versions do not complete. Miscellaneous Operations Specifies the number of operations other than read and write (that is, skulks, enumerating contents of directories, and so on) performed by this clerk. Read Operations Specifies the number of lookup operations performed by this clerk. This counter accounts only for requests to read attributes and does not include name lookups or enumerations of multiple names. Write Operations Specifies how many requests to modify data were processed by this clerk. STATUS ATTRIBUTES State Specifies the state of the DECdns clerk. Broken The DECdns clerk has a fatal error condition. Initial The DECdns clerk is in the process of initializing. Off The DECdns clerk is not available. On The DECdns clerk is running and available. Shut The DECdns clerk is in the process of an orderly shutdown. PRIVILEGES REQUIRED You must have the NET$EXAMINE rights identifier on a VMS system. No special privileges are required on an ULTRIX system.
4.1.2 – example
The following command displays the state of the clerk running on node .mfg.ariel. dns> show node .mfg.ariel dns clerk state
4.1.3 – known_namespace
Displays current information about the specified namespace.
SYNOPSIS
SHOW [NODE node-id] DNS CLERK KNOWN NAMESPACE identifier
[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.
identifier
The identifier of the namespace. You can use one of the following
identifiers: the simple name for the namespace, which can contain
wildcard characters, or the NSCTS, which is the value of the
namespace creation timestamp that is automatically assigned when
the namespace is created. The format of the NSCTS is 14 pairs of hex
digits (xx-xx).
attribute-specifier
The name of an attribute or an attribute group. Enter one or more of
the following attribute specifiers:
all [attributes]
all counters
all identifiers
all status
Ambiguous
Creation Time
Explicit Creation
Name
Nickname
NSCTS
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 a single command. Use a comma to separate
the 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.
4.1.3.1 – attributes
Every DECdns entity has attributes, which are pieces or sets of data associated with that entity. Characteristics are attributes that reflect or affect the operational behavior of an entity. The following are descriptions of valid characteristics: You can use any combination of attribute specifiers in a single command. Use a comma to separate the specifiers. If you do not supply any attribute specifier, the command displays all identifiers and their values. The following are descriptions of valid counters, identifiers, and status attributes: COUNTER Creation Time Specifies the time at which the clerk added this known namespace to its cache. IDENTIFIERS Name Specifies an external, human-readable name by which the namespace can be identified. If the namespace nickname is unique, the Name is the same as the Nickname. Otherwise, the Name is generated by appending _n to the nickname for some value of n that makes it unique. The Ambiguous attribute is then set true for the known namespace. NSCTS Specifies the creation timestamp of the namespace. STATUS ATTRIBUTES Ambiguous Indicates whether the nickname for this namespace is ambiguous; that is, more than one namespace known to this clerk has the same nickname. If true, the namespace nickname is ambiguous. If false, the namespace nickname is unique. Explicit Creation Specifies whether the namespace was created by a create command. If false, the namespace was created by the clerk itself. Nickname The name given to the namespace when it was created.
4.1.3.2 – example
The following command displays the identifiers of all namespaces with ambiguous nicknames. dns> show dns clerk known namespace *, with ambiguous=true
4.1.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.
4.1.4 – manual_nameserver
Displays the knowledge in the clerk's cache about a server that
exists across a wide area network (WAN).
SYNOPSIS
SHOW [NODE node-id] DNS CLERK MANUAL NAMESERVER 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.
name
The name of the manual nameserver entity that you want to show. It
can contain wildcard characters.
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
Failed Solicits
Last Solicit
Name
Successful Solicits
Towers
UID
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 from 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 a single command. Use a comma to separate
the 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.
4.1.4.1 – attributes
The following are descriptions of valid characteristics, counters, identifiers, and status attributes: CHARACTERISTICS Towers Specifes the DECnet/OSI address of the server that this entity represents. UID Uniquely identifies the entity. COUNTERS Creation Time Specifies the time at which the clerk created knowledge of this server in its cache. Successful Solicits The number of times the clerk made a successful solicit connection to the server and received clearinghouse advertisement data back. Failed Solicits The number of times solicitation of clearinghouse advertisement data from the nameserver failed. IDENTIFIER Name Specifies an external, human-readable name by which the nameserver can be identified. STATUS ATTRIBUTE Last Solicit Indicates the time at which the clerk last tried to solicit this nameserver.
4.1.4.2 – 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 name, limits the output only to directories whose specified attributes have certain values.
4.1.4.3 – example
The following command displays the Name attribute of the manual nameserver rns. dns> show dns clerk manual nameserver rns Name
4.1.5 – remote_clearinghouse
Displays current information about the specified remote
clearinghouse.
SYNOPSIS
SHOW [NODE node-id] DNS CLERK REMOTE 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 simple names of
clearinghouses.
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
Creation Time
CTS
Miscellaneous Operations
Name
Read Operations
UID
Write Operations
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.
PRIVILEGES REQUIRED
You must have the NET$EXAMINE rights identifier on a VMS system. No
special privileges are required on an ULTRIX system.
4.1.5.1 – attributes
The following are descriptions of valid characteristics, counters, and identifiers: CHARACTERISTICS UID Identifies the remote clearinghouse entity. COUNTERS Creation Time Specifies the time at which this entity was created. Miscellaneous Operations Specifies the number of operations other than read and write (that is, skulks, new epochs, and so on) performed by this clerk on the remote clearinghouse. Read Operations Specifies the number of lookup operations of any sort performed by the clerk on the remote clearinghouse. Write Operations Specifies the number of write operations performed by this clerk on the remote clearinghouse. IDENTIFIERS CTS Indicates the creation timestamp (CTS) of this entity. Name Specifies the full name of the clearinghouse.
4.1.5.2 – 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.
4.1.5.3 – example
The following command displays the CTS of the remote clearinghouse .paris2_ch cached by the clerk on node .jmh. dns> show node .jmh dns clerk remote clearinghouse .paris2_ch cts
4.2 – server
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.
4.2.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.
4.2.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
4.2.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.
4.2.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.
4.2.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
4.2.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.
5 – group
Displays current information about the specified group.
SYNOPSIS
SHOW GROUP group-name [attribute-specifier]
[prepositional-phrase]
Arguments
group-name
A specific group name or a complete directory specification followed
by a wildcard template for matching simple names of groups.
attribute-specifier
The name of an attribute or an attribute group. Enter one or more of
the following attribute specifiers:
all [attributes]
all characteristics
DNS$ACS
DNS$CTS
DNS$GroupRevoke
DNS$Members
DNS$UTS
prepositional-phrase
A phrase that affects the destination or content of command output.
Specify one or more of the following prepositional phrases:
with attribute [relop] value
to file[=]filename
to extend file[=]filename
to terminal
Description
This command displays the names and values of the attributes or
attribute groups named in attribute-specifier. You can use any
combination of attribute specifiers in a single command. Use a
comma to separate the specifiers. If you do not supply any attribute
specifier, the command displays all attributes and their values.
ACCESS RIGHTS
You need read access to the group for which you want to display attribute
information.
5.1 – access
Displays the access control set of a group.
FORMAT
SHOW GROUP group-name ACCESS [prepositional-phrase]
Arguments
group-name
A specific group name or a complete directory specification followed
by a wildcard template for matching simple names of groups.
prepositional-phrase
ACCESS RIGHTS
You must have read access to the group.
5.1.1 – example
The following command displays the access control set of the group .eng.testgroup. dns> show group .eng.testgroup access
5.1.2 – prepositional_phrases
A phrase that affects the destination or content of command output.
You can use one or more prepositional phrases. Be sure to precede
each of the following prepositional phrases with a comma and a
space:
to file[=]filename Redirects the output to
filename. If the file does not
exist, this command creates
it. If the file does exist, its
contents are overwritten.
to extend file[=]filename Appends the output to an
existing filename. If the file
does not exist, it is created.
to terminal Directs the output to the
terminal. This is the default
option.
5.2 – attributes
If you do not supply any attribute specifier, the command displays all attributes and their values. CHARACTERISTICS The following are descriptions of valid characteristics: DNS$ACS Specifies the access control set of the group. DNS$CTS Specifies the creation timestamp of this group. DNS$GroupRevoke Specifies a timeout that determines how long a positive result from a group membership test operation may be cached by the clerk that issued the request. DNS$Members Specifies the DECdns full name of each member of the group. Members are specified as a group name, a collection of principals denoted with wildcards (for example, .org.name*), or an individual name in the format nodename.username. To specify a DNS Version 1-style principal, use the format nodename::username. DNS$UTS Specifies the timestamp of the most recent update to an attribute of the group.
5.3 – example
The following command displays the full name of each member of the group .sales_group1. dns> show group .sales_group1 DNS$members
5.4 – prepositional_phrases
You can affect the destination or content of command output by using prepositional phrases. Be sure to precede each of the following prepositional phrases with a comma and a space: with attribute [relop] value When used with a wildcard group-name, limits the output only to directories whose specified attributes have certain values. to file[=]filename Redirects the output to filename. If the file does not exist, this command creates it. If the file does exist, its contents are overwritten. to extend file[=]filename Appends the output to an existing filename. If the file does not exist, it is created. to terminal Directs the output to the terminal. This is the default option.
6 – link
Displays current information about the specified soft link.
SYNOPSIS
SHOW LINK link-name [attribute-specifier]
[prepositional-phrase]
Arguments
link-name
A specific name of a soft link or a complete directory specification
followed by a wildcard template for matching simple names of soft
links.
attribute-specifier
The name of an attribute or an attribute group. Enter one or more of
the following attribute specifiers:
all [attributes]
all characteristics
DNS$ACS
DNS$CTS
DNS$LinkTarget
DNS$LinkTimeout
DNS$UTS
prepositional-phrase
A phrase that affects the destination or content of command output.
Specify one or more of the following prepositional phrases:
with attribute [relop] value
to file[=]filename
to extend file[=]filename
to terminal
Description
This command displays the names and values of the attributes or
attribute groups named in attribute-specifier. If you do not supply
any attribute specifier, the command displays all attributes and
their values. You can use any combination of attribute specifiers
in any sequence in a single command. Use a comma to separate
specifiers.
ACCESS RIGHTS
You must have read access to the soft link.
6.1 – access
Displays the access control set of a soft link.
SYNOPSIS
SHOW LINK link-name ACCESS [prepositional-phrase]
Arguments
link-name
A specific name of a soft link or a complete directory specification
followed by a wildcard template for matching simple names of soft
links.
prepositional-phrase
ACCESS RIGHTS
You must have read access to the soft link.
6.1.1 – example
The following command displays the access control set of the soft link .sales.australia and stores the output in a file called slshow. dns>show link .sales.australia access, to file=slshow
6.1.2 – prepositional_phrases
A phrase that affects the destination or content of command output.
You can use one or more prepositional phrases. Be sure to precede
each of the following prepositional phrases with a comma and a
space:
to file[=]filename Redirects the output to
filename. If the file does not
exist, this command creates
it. If the file does exist, its
contents are overwritten.
to extend file[=]filename Appends the output to an
existing filename. If the file
does not exist, it is created.
to terminal Directs the output to the
terminal. This is the default
option.
6.2 – attributes
CHARACTERISTICS The following are descriptions of valid characteristics. DNS$ACS Specifies the access control set for the soft link. DNS$CTS Specifies the creation timestamp of this soft link. DNS$LinkTarget Specifies the full name of the directory, object entry, or other soft link to which the soft link points. DNS$LinkTimeout Specifies a timeout value after which the soft link is either extended or deleted. The timeout value contains both an expiration time and an extension time. If the soft link does not point to anything when it is checked, it is deleted. DNS$UTS Specifies the timestamp of the most recent update to an attribute of the soft link.
6.3 – example
The following command shows the full name of the directory, object entry, or other soft link to which the soft link named .sales.australia points. dns> show link .sales.australia DNS$LinkTarget
6.4 – prepositional_phrases
You can affect the destination or content of command output by using prepositional phrases. Be sure to precede each of the following prepositional phrases with a comma and a space: with attribute [relop] value When used with a wildcard link-name, limits the output only to directories whose specified attributes have certain values. to file[=]filename Redirects the output to filename. If the file does not exist, this command creates it. If the file does exist, its contents are overwritten. to extend file[=]filename Appends the output to an existing filename. If the file does not exist, it is created. to terminal Directs the output to the terminal. This is the default option.
7 – object
Displays current information about the specified object entry.
SYNOPSIS
SHOW OBJECT object-name [attribute-specifier]
[prepositional-phrase]
Arguments
object-name
A specific object entry name or a complete directory specification
followed by a wildcard template for matching simple names of object
entries.
attribute-specifier
The name of an application-defined attribute, user-defined
attribute, or an attribute group. Enter one or more of the following
attribute specifiers:
all [attributes]
all characteristics
DNA$Towers
DNS$ACS
DNS$Address
DNS$Class
DNS$ClassVersion
DNS$CTS
DNS$ObjectUID
DNS$UTS
prepositional-phrase
A phrase that affects the destination or content of command output.
Specify one or more of the following prepositional phrases:
with attribute [relop] value
to file[=]filename
to extend file[=]filename
to terminal
Description
This command displays current information about the specified object
entry. Application-defined attributes for an object are included
in the output of this command (if they exist). Names and values
of the attributes or attribute groups named in attribute-specifier
are also shown. If you do not supply any attribute specifier, the
command displays all attributes and their values. You can use any
combination of attribute specifiers in any sequence in a single
command. Use a comma to separate specifiers.
ACCESS RIGHTS
You must have read access to the object.
7.1 – access
Displays the access control set of an object entry.
SYNOPSIS
SHOW OBJECT object-name ACCESS
[prepositional-phrase]
Arguments
object-name
A specific object entry name or a complete directory specification
followed by a wildcard template for matching simple names of object
entries.
prepositional-phrase
ACCESS RIGHTS
You must have read access to the object entry.
7.1.1 – example
The following command displays the access control set of the object entry .sales.east.floor1Ln03 and stores the output in a file called coshow. dns> show object .sales.east.floor1ln03 access, to file=coshow
7.1.2 – prepositional_phrases
A phrase that affects the destination or content of command output.
You can use one or more prepositional phrases. Be sure to precede
each of the following prepositional phrases with a comma and a
space:
to file[=]filename Redirects the output to
filename. If the file does not
exist, this command creates
it. If the file does exist, its
contents are overwritten.
to extend file[=]filename Appends the output to an
existing filename. If the file
does not exist, it is created.
to terminal Directs the output to the
terminal. This is the default
option.
7.2 – attributes
CHARACTERISTICS The following are descriptions of valid characteristics: DNA$Towers Specifies the DECnet/OSI address of every node at which the object entry may be found. This attribute is used only by DECnet/OSI nodes and servers. DNS$ACS Specifies the access control set for the object entry. DNS$Address Specifies the DECnet Phase IV address of every node at which the object entry may be found. This attribute is used only by Phase IV nodes and servers. DNS$Class Classifies objects according to the type of object being named. Client application programs can define their own classes for object entries that their application creates. DNS$ClassVersion Allows the definition of an object class to be evolved over time (for example, by changing the definition of the class-specific attributes) without confusing the clients of the DECdns directory service. DNS$CTS Specifies the creation timestamp of this object. DNS$ObjectUID Specifies the unique identifier (UID) associated with the object entry. This attribute is optional and, if present, its value can be null. Clients are responsible for maintaining the UIDs of object entries that they are using; DECdns does not ensure that object entry UIDs are valid or unique. DNS$UTS Specifies the timestamp of the most recent update to an attribute of the object entry. In addition, application-specific attributes may exist for an object entry. See your application programmer for a list of application- defined attributes.
7.3 – example
The following command lists the DNS$CTS value of the object entry new_dev. dns> show object new_dev DNS$CTS
7.4 – prepositional_phrases
You can affect the destination or content of command output by using prepositional phrases. Be sure to precede each of the following prepositional phrases with a comma and a space: with attribute [relop] value When used with a wildcard object-name, limits the output only to directories whose specified attributes have certain values. to file[=]filename Redirects the output to filename. If the file does not exist, this command creates it. If the file does exist, its contents are overwritten. to extend file[=]filename Appends the output to an existing filename. If the file does not exist, it is created. to terminal Directs the output to the terminal. This is the default option.
8 – replica
Displays current information about the specified replica.
SYNOPSIS
SHOW REPLICA directory-name
[AT] CLEARINGHOUSE clearinghouse-name
[attribute-specifier] [prepositional phrase]
Arguments
directory-name
The full name of the directory.
clearinghouse-name
The full name of the clearinghouse.
attribute-specifier
The name of an attribute or an attribute group. Specify one or more
of the following attribute specifiers:
all [attributes]
all characteristics
all identifiers
all status
DNS$CTS
DNS$Epoch
DNS$LastSkulk
DNS$LastUpdate
DNS$ReplicaState
DNS$ReplicaType
DNS$ReplicaVersion
DNS$RingPointer
prepositional phrase
A phrase that affects the destination or content of command output.
Specify one or more of the following prepositional phrases:
to file[=]filename
to extend file[=]filename
to terminal
Description
This command displays the names and values from the attributes or
attribute groups named in attribute-specifier. This command displays
directory-specific attributes as well as per-replica attributes.
If you do not supply any attribute specifier, the command displays
all attributes and their values. You can use any combination of
attribute specifiers in any sequence in a single command.
ACCESS RIGHTS
You must have read access to the directory from which this replica
was created.
8.1 – attributes
The following are descriptions of valid characteristics, identifiers, and status attributes: CHARACTERISTICS DNS$CTS Specifies the creation timestamp (CTS) of the directory of which this replica is a copy. DNS$LastSkulk Records the timestamp of the last skulk that began processing this particular replica of a directory. This will be zero for read-only replicas since they do not start processing for a skulk. DNS$LastUpdate Records the timestamp of the last update to any attribute of the replica, or any change to the contents of the replica, including object entries, child pointers, and soft links. This will be zero for read-only replicas. DNS$ReplicaType Specifies the replica type of a directory. DNS$ReplicaVersion Specifies the replica version of a directory. DNS$RingPointer Specifies the creation timestamp (CTS) of all clearinghouses containing another replica of this directory. IDENTIFIER DNS$Epoch Identifies a replica as part of a directory's complete set. STATUS ATTRIBUTE DNS$ReplicaState Specifies the internal state of a replica. When you create or delete a replica, it goes through various states.
8.2 – example
The following command displays the replica type of the .eng directory in the .chicago2_ch clearinghouse. dns> show replica .eng at clearinghouse .chicago2_ch DNS$ReplicaType
8.3 – prepositional_phrases
You can affect the destination or content of command output by using prepositional phrases. Be sure to precede each of the following prepositional phrases with a comma and a space: to file[=]filename Redirects the output to filename. If the file does not exist, this command creates it. If the file does exist, its contents are overwritten. to extend file[=]filename Appends the output to an existing filename. If the file does not exist, it is created. to terminal Directs the output to the terminal. This is the default option.