DNS$CPHELP.HLB  —  add  object
 Adds a value to a modifiable, set-valued attribute (including
 application-defined attributes) of an object entry. If the value
 is already defined for the attribute, no error message is generated.
 Usually this task is performed through the client application, since
 the client application defines the name of the attribute and the
 syntax of its value.

 SYNOPSIS

      ADD OBJECT object-name attribute-name [=] attribute-value

 Arguments

 object-name

 The full name of an object entry.

 attribute-name

 The name of a particular attribute. Specify your own attribute
 name or one of the DECdns-defined attributes. Separate multiple
 attributes with commas.

 attribute-value

 The value of a particular attribute. You can express the values of
 application-defined attributes as quoted strings, "ps"; hex strings,
 %x FF00EE; or concatenations of them in parentheses, (%x0103 "ps").

 ACCESS RIGHTS
 You must have write access to the object entry or control access to
 the parent directory in which you intend to store the attribute.

1  –  example 

 The following command adds the value "ps" to the user-
 defined set-valued attribute printcap of an object entry named
 .sales.east.deskprinter.

 dns>add object .sales.east.deskprinter printcap "ps"

2  –  access 

 Adds an access control entry (ACE) to an object entry's access
 control set (ACS).

 SYNOPSIS

      ADD OBJECT object-name ACCESS principal [AS GROUP]

      [FOR] access

 Arguments

 object-name

 The full name of the object entry.

 principal

 The principal for whom access is being added. You can specify a
 principal 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. The phrase as group
 indicates the specified principal is a group. You cannot use this
 phrase with wildcard principal names.

 access

 The access rights for the specified principal. Rights are read,
 write, delete, test, control, and none, and you can specify them as
 r, w, d, t, c, and non. Separate multiple rights with commas.

 Description

 This command adds an access control entry (ACE) to an object entry's
 access control set. Access rights are defined as follows:

 Read       The principal can look up the object entry by name, read
            any object attribute, and perform wildcard lookups.
 Write      The principal can change any modifiable attribute except
            the ACS.
 Delete     The principal can delete the object entry.
 Test       The principal can check the value of the object entry.
 Control    The principal can alter the object entry's ACS.
 None       The principal does not have access rights.

 You must have control access to the object entry whose ACS is being
 modified.

2.1  –  example 

 The following command grants read, write, and test access to user
 smith on node .sales.orion for an object entry named .admin.work_
 disk3.

 dns> add object .admin.work_disk3 access .sales.orion.smith -
 _> for r, w, t
Close Help