DNS$CPHELP.HLB  —  set

1  –  directory

 Modifies characteristics for the specified directory.

 SYNOPSIS

      SET DIRECTORY directory-name characteristic

 Arguments

 directory-name

 The full name of the directory to be modified.

 characteristic

 The name and value of the characteristic to be modified. Specify one
 or more of the following:

 DNS$Convergence [=] value
 DNS$InCHName [=] boolean
 DNS$UpgradeTo [=] v.n

 Description

 This command modifies characteristics for the specified directory.
 You can specify one or more of the listed characteristics to be
 modified. Use a comma to separate characteristics.

 Characteristics

 DNS$Convergence [=] value

 Specifies the degree of consistency among replicas. Specify the
 value argument as one of the following:

 Low            The next skulk distributes all updates that occurred
                since the previous skulk. Skulks occur at least once
                every 24 hours.
 Medium         DECdns attempts to propagate an update to all
                replicas. If the attempt fails, the next scheduled
                skulk makes the replicas consistent. Skulks occur at
                least once every 12 hours.
 High           DECdns attempts to propagate an update to all
                replicas. If that attempt fails (for example, if
                one of the replicas is unavailable), a skulk is
                scheduled for within 1 hour. Background skulks will
                occur at least once every 12 hours. Use this setting
                temporarily and briefly because it uses extensive
                system resources.

 By default, every directory inherits the convergence setting of its
 parent at creation time. The default setting of the root directory
 is medium.

 DNS$InCHName [=] boolean

 Specifies whether a directory or any of its descendants can store
 clearinghouse names. The boolean argument can be specified as one of
 the following:

 True       The directory or its descendants can store clearinghouse
            names.
 False      The directory or its descendants cannot store
            clearinghouse names. This is the default value.

 DNS$UpgradeTo [=] v.n

 Controls the upgrading of a directory from one version of DECdns to
 another. By modifying this attribute, you can initiate the upgrading
 of a directory to a higher version of DECdns. Specify the value as
 v.n where v indicates the major version number and n specifies the
 minor version number. There is no default.

 ACCESS RIGHTS
 You must have write access to the directory whose attribute you
 intend to modify.

1.1  –  example

 The following command sets a low convergence value on the .mfg
 directory.

 dns> set directory .mfg DNS$Convergence = low

1.2  –  to_new_epoch

 Reconstructs a directory's replica set, allowing you to exclude a
 replica or re-specify replica types.

 SYNOPSIS

      SET DIRECTORY directory-name TO NEW EPOCH MASTER

      clearinghouse-name [,READ-ONLY clearinghouse-name] [...]

      [,EXCLUDE clearinghouse-name]

 directory-name

 The full name of the directory.

 clearinghouse-name

 The name of the clearinghouse in which an individual replica is
 located. The first clearinghouse-name specifies where the master
 replica is stored.

 ACCESS RIGHTS
 You must have read and control access to all the replicas in the
 replica set. To change the type of replica, you must have write
 access to the clearinghouse that stores the replica whose type is
 being changed.

1.2.1  –  example

 The following command sets a new epoch for the directory .mfg.
 The master replica is in .paris_ch, and read-only replicas are in
 .chicago1_ch, .seattle_ch, and .ny1_ch. The new replica set excludes
 the replica in .ny1_ch.

 dns> set directory .mfg to new epoch master .paris1_ch, -
 _> read-only .chicago1_ch, read-only .seattle_ch, exclude .ny1_ch

1.3  –  to_skulk

 Skulks a directory immediately. The control program prompt (dns>)
 does not return until skulking completes. It may take a while for
 skulking to complete.

 SYNOPSIS

      SET DIRECTORY directory-name TO SKULK

 Argument

 directory-name

 The full name of the directory.

 ACCESS RIGHTS
 You must have write access to the directory you intend to skulk.

1.3.1  –  example

 The following command initiates a skulk on the .admin directory.

 dns> set directory .admin to skulk

2  –  dns

2.1  –  clerk

 Modifies characteristics of the clerk entity on the specified node.

 SYNOPSIS

      SET [NODE node-id] DNS CLERK characteristic

 Arguments

 node-id

 The name of the node. If you do not specify a node name, the local
 node is assumed.

 characteristic

 The name and the value of the characteristic to be modified. Specify
 one or any combination of the following for the characteristic
 argument:

 Clerk Timeout      Specifies the default timeout of client interface
 [[=]secs]          calls. If no response is received in the
                    specified timeout, the clerk generates an
                    error message. If you use this argument without
                    specifying a value, it is set to the default (60
                    seconds).
 Default Namespace  Designates the Known Namespace whose name is
 [=]name            given, as the default namespace for this clerk. A
                    name must be supplied; there is no default.
 Solicit Holddown   Specifies the time (in seconds) to wait after
 [[=]secs]          initialization before soliciting advertisements
                    from servers. If you use this argument without
                    specifying a value, it is set to the default (15
                    seconds).

 Description

 This command modifies characteristics of the clerk entity
 on the specified node. You can specify one or more of the
 listed characteristics to be modified. Use a comma to separate
 characteristics. If you do not specify a value, the attribute is
 set to its default if that attribute has a default. You can also
 enter this command through the NCL interface.

 PRIVILEGES REQUIRED
 You must have the NET$MANAGE rights identifier (VMS systems) or
 superuser privileges (ULTRIX systems).

2.1.1  –  example

 The following command sets the clerk timeout to a value of 90
 seconds for the clerk running on node .eng.rigel.

 dns> set node .eng.rigel dns clerk clerk timeout 90

2.1.2  –  known_namespace

 Modifies characteristics for the specified known namespace.

 SYNOPSIS

      SET [NODE node-id] DNS CLERK KNOWN NAMESPACE identifier

      NAME[=]new-name

 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. This is a required argument. You
 can use one of the following:

 name       A simple name for the namespace.
 nscts      The value of the namespace creation timestamp (NSCTS) that
            is automatically assigned when the namespace is created.
            The format of the NSCTS is 14 pairs of hex digits (xx-xx).

 new-name

 Specifies a new name for this known namespace, in effect, renaming
 the known namespace.

 PRIVILEGES REQUIRED
 You must have the NET$MANAGE rights identifier (VMS systems) or
 superuser privileges (ULTRIX systems).

2.1.2.1  –  example

 The following command renames the IAF_1 namespace in the local
 clerk's cache with the new name NDL.

 dns> set dns clerk known namespace IAF_1 name NDL

3  –  group

 Modifies characteristics of the specified group. The DNS$GroupRevoke
 characteristic 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.

 SYNOPSIS

      SET GROUP group-name DNS$GroupRevoke

      (expiration-time extension-time)

 Arguments

 group-name

 The full name of the group.

 expiration-time

 A date and time after which a clerk must verify that a principal
 is still a member of a group. The value is specified as yyyy-mm-dd-
 hh:mm:ss.

 extension-time

 A period of time for which to renew the clerk's reliance on cached
 data when checking for group membership. After the specified
 expiration time, a clerk must verify group membership from the
 server. If the test is positive, the clerk adds the extension time
 to obtain a new expiration date. The extension time is specified as
 ddd-hh:mm:ss.

 ACCESS RIGHTS
 You must have write access to the group whose attribute you intend
 to modify.

3.1  –  example

 The following command specifies a group membership test of the group
 .sales.admingroup with an expiration time of December 31, 1991, that
 is extended 90 days if the clerk verifies membership.

 dns> set group .sales.admingroup DNS$GroupRevoke -
 _> (1991-12-31-12:00:00 090-00:00:00)

4  –  link

 Modifies characteristics of the specified soft link.

 SYNOPSIS

      SET LINK link-name characteristic

 Arguments

 link-name

 The full name of the soft link.

 characteristic

 The name and the value of the characteristic to be modified. Specify
 one or both of the following for the characteristic argument:

 DNS$LinkTarget [=] fullname
 DNS$LinkTimeout [=] [(expiration-time extension-time)]

 Description

 This command modifies characteristics of the specified soft link.
 Enter one or both of the following characteristics. If you enter
 both characteristics, separate them with a comma.

 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 a soft link expires and its target
 entry has been deleted, the soft link is deleted. If the link still
 points to an existing entry, its life is extended by the expiration
 time. Specify expiration-time in the format yyyy-mm-dd-hh:mm:ss. The
 default value of 0 means "never expire." Specify extension-time in
 the format ddd-hh:mm:ss. The default value is 000-00:00:00.

 ACCESS RIGHTS
 You must have write access to the soft link you intend to modify.

4.1  –  example

 The following command sets the expiration value of a soft link named
 .eng.link01 to December 31, 1992, at 12:00 p.m. and sets the soft
 link's extension value to 90 days.

 dns> set link .eng.link01 dns$linktimeout -
 _> (1992-12-31-12:00:00 090-00:00:00)

5  –  object

 Changes the value of a modifiable, single-valued attribute
 (including application-defined attributes) of an object entry. This
 task is usually accomplished through the client application. Use a
 comma to separate attributes. Enclose in parentheses any value that
 has multiple parts separated by spaces.

 SYNOPSIS

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

 Arguments

 object-name

 The full name of the object entry. Specify your own attribute name
 or one of the DECdns-defined attributes.

 attribute-name

 The name of the attribute to be modified.

 attribute-value

 The value of the attribute to be modified. 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").

 Description

 This command changes the value of a modifiable, single-valued
 attribute (including application-defined attributes) of an object
 entry. This task is usually accomplished through the client
 application. Use a comma to separate attributes.

 ACCESS RIGHTS
 You must have write access to the object entry whose attribute you
 intend to modify or have control access to the parent directory.

5.1  –  example

 The following command changes the .sales_records attribute value to 2.

 dns> set object .sales_records Q1 %x2
Close Help