1 set 2 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. 3 example The following command sets a low convergence value on the .mfg directory. dns> set directory .mfg DNS$Convergence = low 3 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. 4 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 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. 4 example The following command initiates a skulk on the .admin directory. dns> set directory .admin to skulk 2 dns 3 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). 4 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 4 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). 5 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 2 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 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) 2 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. 3 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) 2 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. 3 example The following command changes the .sales_records attribute value to 2. dns> set object .sales_records Q1 %x2