DNS$CPHELP.HLB  —  show  dns  clerk  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.

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.

2  –  example

 The following command displays the identifiers of all namespaces
 with ambiguous nicknames.

 dns> show dns clerk known namespace *, with ambiguous=true

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