NAME

set - Modifies characteristics for the DTS entity

SYNOPSIS

dtscp set characteristic ... 

ARGUMENTS

characteristicThe name and value of one or more characteristics to be modified.  Valid values for characteristic are described in the following list.  These values are described in more detail in the DESCRIPTION section. 

DESCRIPTION

The set command modifies the charactistics you specify for the Distributed Time Service (DTS) entity.  The modifiable characteristics and their values are as follows:

check interval [relative-time]
Specifies the amount of time between checks for faulty servers.  Applicable only for servers that have external time-providers.

Default: 0-01:30:00.000

Value: 0-00:00:30.000 - 10675199-02:48:05.000

courier role [role]
Specifies a server’s interaction with the set of global servers.

Default: backup courier

The following values are valid:

backup courierThe local server becomes a courier if none are available on the local area network (LAN). 

courierThe local server synchronizes with the global set of servers. 

noncourierThe local server does not synchronize with the global set of servers. 

error tolerance [relative-time]
Specifies the maximum separation allowed between the local clock and the computed time before synchronizations become abrupt rather than gradual (monotonic). Default: 0-00:10:00.000 Value: 0-00:00:00.500 - 10675199-02:48:05.000

global set timeout [relative-time]
Specifies the amount of time the node waits for a response to a global synchronization request before sending another request or declaring a global server to be unavailable.  The number of attempts made to reach the server is controlled by the query attemps characteristic. 

Default: 0-00:00:15.000

Value: 0-00:00:00.000 - 0-00:10:00.000

local set timeout [relative-time]
Specifies the amount of time the node waits for a response to a local synchronization request before sending another request or declaring a server to be unavailable.  The number of attempts made to reach the server is controlled by the query attempts characteristic. 

Note that the local set timeout value controls only the initial contact with a time-provider.  During this initial contact, the time-provider itself determines the timeout value for actually reporting back times.  This allows a time-provider attached to a slow source like a modem to request that dtsd wait for a longer interval. 

Default: 0-00:00:05.000

Value: 0-00:00:00.000 - 0-00:01:00.000

maximum inaccuracy [relative-time]
Specifies the inaccuracy limit for the node.  When the node exceeds the maximum inaccuracy setting, it attempts to synchronize. Default: 0-00:00:00.100

Value: 0-00:00:00.000 - 10675199-02:48:05.000

query attempts [integer]
Specifies the number of attempts that a node makes to contact a server before the node considers the server unavailable. Default: 3

Value: 1-10

server entry name [name]
Specifies a server’s CDS entry name; hostname represents the name of the system or node that is the server’s client.  The default setting is the recommended value.  Default: /.:/hosts/hostname/dts-entity

server group name [name]
Specifies the name of the security group that DTS uses for authentication checks.  DTS clerks and servers do not accept time values from DTS servers that are not included in this group.

server principal name [hostname]
Specifies a server’s principal name for authentication purposes; hostname represents the name of the system or node that is the server’s client.  The default setting is the recommended value.  Default: /.:/hosts/hostname/self

servers required [integer]
Specifies the minimum number of servers required for a synchronization. Settings of 1 or 2 may cause unreliable computed times.

Default: 1 (clerks) 3 (servers)
Value: 1-10

synchronization hold down [relative-time]
Specifies the interval a node must wait to synchronize.  Also specifies synchronization frequency when a node reaches the value specified by the maximum inaccuracy characteristic.  Clerks: Default: 0-00:10:00.000 Value: 0-00:00:30.000 - 01-00:00:00.000 Servers: Default: 0-00:02:00.000 Value: 0-00:00:30.000 - 01-00:00:00.000

Privileges Required

You must have w (write) permission on the access control list (ACL) associated with the DTS entity in order to execute the command. 

NOTES

This command is replaced at DCE Version 1.1 by the dcecp command and may not be provided in future releases of DCE. 

The following two commands are obsolete.  Use the replacements shown. 

set lan timeout
This command is the same as set local set timeout. 

set wan timeout
This command is the same as set global set timeout. 

EXAMPLES

     1.The command in the following example sets the check interval characteristic to 30 seconds:

dtscp> set check interval 00-00:00:30.000

     2.The following command sets the number of servers required before the entity can synchronize:

dtscp set servers required 4

     3.The following command sets the courier role for a server:

dtscp> set courier role backup courier

     4.The command in the following example sets the error tolerance characteristic to seven minutes:

dtscp> set error tolerance 0-00:07:00.000

     5.The following command sets the global set timeout characteristic to 45 seconds:

dtscp set global set timeout 0-00:00:45.000

     6.The following command sets the local set timeout characteristic to five seconds:

dtscp> set local set timeout 0-00:00:05.000

     7.The following command sets the maximum inaccuracy characteristic to three milliseconds:

dtscp> set maximum inaccuracy 0-00:00:00.300

     8.The following command sets the server entry name characteristic to /.:/hosts/orion/dts-entity:

dtscp> set server entry name /.:/hosts/orion/dts-entity

     9.The command in the following example sets the server principal name characteristic to /.:/hosts/vega/dts-entity:

dtscp set server principal name /.:/hosts/vega/dts-entity

     10.The following command sets the synchronization hold down characteristic to 15 minutes:

dtscp> set synchronization hold down 0-00:15:00.000

RELATED INFORMATION

Commands: dtscp(8dts), show (8dts).