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.
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.
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
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 – 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.
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
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.