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 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 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. 5 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. 5 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 5 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. 2 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. 3 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. 4 example The following command displays the access control set of the group .eng.testgroup. dns> show group .eng.testgroup access 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: 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 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. 3 example The following command displays the full name of each member of the group .sales_group1. dns> show group .sales_group1 DNS$members 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: 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. 2 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. 3 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. 4 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 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: 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 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. 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 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: 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. 2 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. 3 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. 4 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 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: 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 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. 3 example The following command lists the DNS$CTS value of the object entry new_dev. dns> show object new_dev DNS$CTS 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: 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. 2 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. 3 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. 3 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 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.