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

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.

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

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

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