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

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

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

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.

 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

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