DNS$CPHELP.HLB  —  show  dns

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:

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.

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

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.

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.

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

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.

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.

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.

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.

1.4.3  –  example 

 The following command displays the Name attribute of the manual
 nameserver rns.

 dns> show dns clerk manual nameserver rns Name

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.

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.

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.

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

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.

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.

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

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.

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.

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

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.
Close Help