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