NAME
Intro - Introduction to the DCE DTS control program commands
DESCRIPTION
The DCE Distributed Time Service control program (dtscp) allows
you to synchronize, adjust, and maintain the system clocks in a
distributed network. The DTS control program commands are listed
below:
+ The advertise command, which configures the DTS server as a global
server
+ The change command, which modifies the epoch and sets the local
time to a new time
+ The create command, which establishes a DTS entity (a clerk or
server)
+ The delete command, which causes DTS to exit on the local node
+ The disable command, which suspends a DTS entity
+ The enable command, which starts a DTS entity
+ The exit command, which ends the dtscp management session and
returns you to the system prompt
+ The help command which invokes the dtscp help service.
+ The quit command, which ends the dtscp management session and
returns you to the system prompt
+ The set command, which modifies characteristics of a DTS entity
+ The show command, which displays characteristics of a DTS entity
+ The synchronize command, which synchronizes the system clock with
the time obtained from DTS servers in the network
+ The unadvertise command, which removes the global server entry
+ The update command, which gradually adjusts the system clock to a
new time
RELATED INFORMATION
Command: dtscp
Books: DCE Administration Guide
DCE Administration Reference
1 – advertise
NAME
advertise - Configures the system as a global server by adding
the server's entry to the cell profile
SYNOPSIS
dtscp advertise
DESCRIPTION
The advertise command causes DTS to forward the name and attributes
of the server to CDS by binding the server's protocol tower to the
CDS object and adding an entry for the server in the cell profile.
Once the server's entry is in the cell profile, it is configured as
a global server, and servers outside of the LAN can access it.
Privilege Required
You must have write permission on the ACL associated with the DTS
entity in order to execute the command.
NOTE
This command is replaced at Revision 1.1 by the dcecp command and may
not be provided in future releases of DCE.
EXAMPLES
dtscp> advertise
RELATED INFORMATION
Commands: unadvertise
2 – change
NAME
change - Alters the epoch number and time on the local node
SYNOPSIS
dtscp change epoch integer [time absolute-time]
OPTIONS
epoch integer
Specifies the new epoch number (0-255). This argument
is required.
time absolute-time
Specifies a clock setting for the new epoch. If you do not
supply this argument and a value, the server uses the
current clock time with an unspecified inaccuracy and
initiates a synchronization. This argument is optional.
DESCRIPTION
The change command sets the time and changes the epoch of the DTS
server on which it is entered. Use this command to isolate a server
from the rest of the servers in the network before changing the time.
Permissions Required
You must have write permission on the ACL associated with the DTS
entity in order to execute the command.
NOTES
This command is valid only for servers. The new epoch number you
specify must be different from the current epoch number.
This command is replaced at Revision 1.1 by the dcecp command and
may not be provided in future releases of DCE.
EXAMPLES
1. The following example shows how to change the epoch number:
dtscp> change epoch 1
2. The following example shows how to change the epoch number and
time:
dtscp> change epoch 1 time 1990-11-30-10:58:00.000-05:00I0.000
3 – create
NAME
create - Creates the DCE DTS entity on the specified node
SYNOPSIS
dtscp create type <type>
OPTIONS
type <type> Specifies the type of DCE DTS entity to be created on
the specified node. Specify one of the following for
<type>:
clerk The DCE DTS entity is created as a clerk. (The
default setting is clerk.)
server The DCE Distributed Time Service entity is created
as a server.
DESCRIPTION
The create command creates a time server or time clerk entity on
the system where the command is entered.
After the DTS entity is created, it is still in a non-functioning
state. To put it into operation, you must invoke dtscp enable,
which causes an immediate synchronization to take place. For more
information, see the enable reference page in this chapter.
Privilege Required
You must have write permission on the ACL associated with the DTS
entity in order to execute the command.
NOTE
This command is replaced at Revision 1.1 by the dcecp command and
may not be provided in future releases of DCE.
EXAMPLE
dtscp> create type server
4 – delete
NAME
delete - Deletes the DCE DTS entity
SYNOPSIS
dtscp delete
DESCRIPTION
The delete command deletes the DCE DTS entity from the system where
the command is entered. When delete is executed, the DTS daemon
process completes execution. To restart the DTS daemon, use the
SYS$MANAGER:DCE$SETUP.COM command procedure.
Privilege Required
You must have write permission on the ACL associated with the DTS
entity in order to execute the command.
NOTES
The DCE DTS entity cannot be deleted until you enter the disable
command, which causes the status attribute state to be set to off.
This command is replaced at Revision 1.1 by the dcecp command and
may not be provided in future releases of DCE.
EXAMPLE
dtscp> delete
RELATED INFORMATION
Commands: disable
5 – disable
NAME
disable - Stops the DCE DTS entity on the local node
SYNOPSIS
dtscp disable
DESCRIPTION
The disable command turns off the DCE DTS entity on the system where
the command is entered. When the command is executed, the status
attribute state is set to off.
Privilege Required
You must have write permission on the ACL associated with the DTS
entity in order to execute the command.
NOTES
The DCE DTS entity cannot be disabled until it is enabled with the
enable command. You must enter the disable command before you can
delete the entity.
This command is replaced at Revision 1.1 by the dcecp command and
may not be provided in future releases of DCE.
EXAMPLES
dtscp> disable
RELATED INFORMATION
Commands: enable
delete
create
6 – enable
NAME
enable - Starts the DTS entity on the local node.
SYNOPSIS
dtscp enable [set clock <boolean>]
ARGUMENTS
set clock <boolean>
Specifies whether the clock is abruptly set or gradually
adjusted to the computed time. This argument is optional.
Valid values for <boolean> are:
false The clock is gradually adjusted. This is the
default condition.
true The clock is abruptly set.
DESCRIPTION
After the DTS entity is created with the dtscp create command, it
is still in a non-functioning state. To put it into operation, you
must invoke dtscp enable, which causes an immediate synchronization
to take place. When the command is executed, the status attribute
state is set to on.
In addition, you may use the enable command to activate a DTS
entity that has previously been deactivated with the disable
command. See the disable reference page in this chapter for more
information.
Privilege Required
You must have write permission on the ACL associated with the DTS
entity in order to execute the command.
NOTES
The DTS entity cannot be enabled until it is created with the
create command; the DTS entity must be in the off state.
This command is replaced at Revision 1.1 by the dcecp command and
may not be provided in future releases of DCE.
EXAMPLES
1. The following example shows how to enable the entity and adjust
the clock gradually to the computed time following the first
synchronization:
dtscp> enable
2. The following example shows how to enable the entity and
abruptly set the clock to the computed time following the
first synchronization:
dtscp> enable set clock true
RELATED INFORMATION
Commands: create
disable
7 – exit
NAME
exit - Causes dtscp to complete execution.
SYNOPSIS
dtscp exit
DESCRIPTION
The exit command causes the DTS control program (dtscp) to complete
execution and returns operation to the parent process.
NOTE
This command may be replaced in future releases by the dcecp command,
and may no longer be supported at that time.
EXAMPLES
The following command shows how to leave dtscp and return to the
parent process:
dtscp> exit
RELATED INFORMATION
Commands: quit
8 – help
NAME
help - Displays help information about dtscp commands.
SYNOPSIS
dtscp help [help-topic]
ARGUMENTS
help-topic
Specifies the help topic for which help information is
to be displayed.
The following are valid help topics:
+ advertise
+ change
+ create
+ delete
+ disable
+ enable
+ set
+ show
+ synchronize
+ unadvertise
+ update
DESCRIPTION
The help command displays information about dtscp commands.
NOTE
This command may be replaced in future releases by the dcecp command,
and may no longer be supported at that time.
EXAMPLES
The following command shows how to get help about the help subtopic
unadvertise.
dtscp> help unadvertise
9 – quit
NAME
quit - Causes dtscp to complete execution
SYNOPSIS
dtscp quit
DESCRIPTION
The quit command causes dtscp to complete execution and returns
operation to the parent process.
NOTE
This command may be replaced in future releases by the dcecp command,
and may no longer be supported at that time.
EXAMPLES
The following command shows how to leave dtscp and return to the
parent process:
dtscp> quit
RELATED INFORMATION
Command: exit
10 – set
NAME
set - Modifies characteristics for the DTS entity.
SYNOPSIS
dtscp set characteristic
ARGUMENTS
characteristic
The 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.
+ check interval [relative-time]
+ courier role [role]
+ error tolerance [relative-time]
+ global set timeout [relative-time]
+ local set timeout [relative-time]
+ maximum inaccuracy [relative-time]
+ query attempts [integer]
+ server entry name [name]
+ server group name [name]
+ server principal name [name]
+ servers required [integer]
+ synchronization hold down [relative-time]
DESCRIPTION
The set command modifies the charactistics you specify for the DTS
entity. The modifiable characteristics and their values are
described in the following list.
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 courier
The local server becomes a courier if none are
available on the LAN.
courier The local server synchronizes with the global
set of servers.
noncourier
The 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 attemps 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 [name]
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
Privilege Required
You must have write permission on the ACL associated with the DTS
entity in order to execute the command.
NOTES
This command is replaced at Revision 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 following example command sets the check interval
characteristic to 30 seconds:
dtscp> set check interval 00-00:00:30.000
2. The following example shows how to set the number of servers
required before the entity can synchronize:
dtscp> set servers required 4
3. The following example shows how to set the courier role for
a server:
dtscp> set courier role backup courier
4. The following example command sets the error tolerance
characteristic to seven minutes:
dtscp> set error tolerance 0-00:07:00.000
5. The following example command the global set timeout
characteristic to 45 seconds:
dtscp> set global set timeout 0-00:00:45.000
6. The following example command the local set timeout charac-
teristic to five seconds:
dtscp> set local set timeout 0-00:00:05.000
7. The following example command sets the maximum inaccuracy
characteristic to three milliseconds:
dtscp> set maximum inaccuracy 0-00:00:00.300
8. The following example command sets the server entry name
characteristic to /.:/hosts/orion/dts-entity:
dtscp> set server entry name /.:/hosts/orion/dts-entity
9. The following example command sets the server principal name
characteristic to /.:/hosts/vega/dts-entity:
dtscp> set server principal name /.:/hosts/vega/dts-entity
10. The following example command sets the synchronization hold down
characteristic to 15 minutes:
dtscp> set synchronization hold down 0-00:15:00.000
RELATED INFORMATION
Commands: show
11 – show
NAME
show - Displays current information about the DTS entity
SYNOPSIS
dtscp show attribute-group | attribute-name
ARGUMENTS
attribute-group
The name of an attribute group or individual attribute
to be displayed. The following values are valid:
+ all
+ all characteristics
+ all counters
+ all status
+ global servers
+ local servers
attribute-name
The name of a specific attribute from the characteristics,
counters, or status group. The attribute specifiers global
servers and local servers do not contain any other
attributes.
DESCRIPTION
The show command displays the names and values of the specified
attributes or attribute groups. For attribute groups, if you do
not supply a group name with the all argument, all characteristics
and their values are displayed. The following sections list names
of individual attributes, categorized by group.
Note that the attributes displayed by the show command might be
different, depending upon whether you have requested information
about a server or a clerk.
Characteristics
Characteristic arguments can contain a maximum of 80 characters
and are recalculated to a normalized date format. For example:
Input value: 0-0025:10:99.99999999
Result: 1-01:11:39.990
acting courier role
Specifies whether a backup courier is currently
functioning as a courier. If the role is noncourier,
the node is not attempting to synchronize with global
servers. This characteristic is shown only for servers.
Default: noncourier
Value: courier or noncourier
automatic tdf change
Specifies whether automatic changes to the time
differential factor are enabled or disabled; the
value is determined by the operating system.
Default: true
Value: true/false
check interval
Specifies the amount of time between checks for faulty
servers. Applicable only to servers that have external
time providers. This characteristic is shown only for
servers.
Default: 0-01:30:00.00
Value: 0-00:00:30.000 - 10675199-02:48:05.478
clock adjustment rate
Specifies the rate at which the DTS server or clerk entity
adjusts the node's clock during a synchronization.
clock resolution
Specifies the amount of time between system clock ticks.
The value is determined by the operating system.
courier role
Specifies a server's interaction with the set of global
servers. This characteristic is shown only for servers.
backup courier
The local server becomes a courier if none are
available on the LAN.
courier The local server synchronizes with the global
set of servers.
noncourier
The local server does not synchronize with the
global set of servers.
Default: noncourier
DTS version
Specifies the DTS software version installed on the node.
epoch number
Specifies the server's epoch number. The change command
modifies this characteristic. This characteristic is
shown only for servers.
Default: 0
Value: 0-255
error tolerance
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.478
global set timeout
Specifies the amount of time the node waits for a response
to a WAN 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
Specifies the amount of time the node waits for a response
to a 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 attemps characteristic.
Default: 0-00:00:05.000
Value: 0-00:00:00.000 - 0-00:10:00.000
local time differential factor
Specifies the Time Differential Factor (TDF), which is
the amount of time the server varies from Greenwich mean
time (GMT) or Coordinated Universal Time (UTC).
Default: 0-00:00:00.000
Value: -13-00:00:00 - 13-00:00:00
maximum clock drift rate
Specifies the worst-case drift rate of the node's clock,
in nanoseconds per second, as determined by the
manufacturer's specifications.
maximum inaccuracy
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.0 - 10675199-02:48:05.478
next tdf change
Specifies the future time at which the time differential
factor is automatically changed. The value is determined
by the operating system.
query attempts
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
Specifies a server's ACL entry name; <hostname>
represents the name of the system or node that is
the server's client. The default setting is the
recommended value. This characteristic is shown only
for servers.
Default: /.:/hosts/<hostname>/dts-entity
server group name
Specifies the security group name for the time servers
within the cell.
Default: /.:/subsys/dce/dts-servers
server principal name
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. This characteristic is shown
only for servers.
Default: /.:/hosts/<hostname>/self
servers required
Specifies the minimum number of servers required for
a synchronization. Settings of 1 or 2 may cause
unreliable computed times.
Default: 3
Value: 1-10
synchronization hold down
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.0
Value: 0-00:00:30.0 - 01 00:00:00.00
Servers:
Default: 0-00:02.00.0
Value: 0-00:00:30.0 - 01 00:00:00.00
time provider present
Specifies whether or not the entity used an external
time provider at the last successful synchronization.
This attribute applies to servers only.
time representation version
Specifies the timestamp format used by the node.
type
Specifies whether the node is a DTS server or clerk.
The create command modifies this characteristic.
Counters
clock settings
Specifies the number of times the node clock has been
set nonmonotonically (abruptly).
creation time
Specifies the time at which the DTS entity was created
and the counters were initialized.
different epochs detected
Specifies the number of times the node received time
response messages from servers or clerks that had epoch
numbers different from its own. This counter is shown
only for servers.
disable directives completed
Specifies the number of times the DTS has been disabled.
enable directives completed
Specifies the number of times the DTS has been enabled.
epoch changes completed
Specifies the number of times the server's epoch has
changed.
insufficient resources detected
Specifies the number of times the node has been unable
to allocate virtual memory.
local servers not in group
Specifies the number of times that a local server was
contacted, but it was not in the dts security group.
local times not intersecting
Specifies the number of times the node's time interval
failed to intersect with the computed interval of the
servers.
no global servers detected
Specifies the number of times the courier server could
not contact any global servers. This counter is shown
only for servers.
protocol mismatches detected
Specifies the number of times the local node failed to
process a received message containing an incompatible
protocol version.
servers not in group
Specifies the number of times that a non-local server
was contacted, but it was not in the dts security group.
This counter is shown only for servers.
servers not responding
Specifies the number of times the courier server could
not contact a specific global server. This counter is
shown only for servers.
servers times not intersecting
Specifies the number of times a server has detected
faulty servers (other than itself). This counter is
shown only for servers.
synchronizations completed
Specifies the number of times the node successfully
synchronized.
system errors detected
Specifies the number of times a DTS operation detected
a system error.
time provider failures detected
Specifies the number of times the external time provider
signaled a failure or the node was unable to access the
time provider.
time provider timeouts detected
Specifies the number of times a dtsd server process
initiated contact with a time provider and did not
receive the initial response within the interval
specified by local set timeout (the default interval
is 5 seconds). This counter is shown only for servers.
time representation version mismatches detected
Specifies the number of times the local node failed to
process a received message containing an incompatible
timestamp format.
too few servers detected
Specifies the number of times a node failed to synchronize
because it could not contact the required minimum number
of servers.
updates initiated
Specifies the number of times a server has attempted to
update its clock. This counter is shown only for servers.
Status
current time
Specifies the current time on the node.
global servers
Specifies the set of global servers known by the node.
last synchronization
Specifies the computed time at the last attempted
synchronization.
local servers
Specifies the set of local servers known by the node.
state
Specifies the state of the DTS entity.
off The DTS entity is disabled.
on The DTS entity is enabled.
synchronizing
The DTS entity is synchronizing.
updating The DTS entity is updating the time.
uid
Specifies the entity's unique identifier, which is
generated when the entity is created. This attribute
is shown only for servers.
Privilege Required
You must have read permission on the ACL associated with the DTS
entity in order to execute the command.
NOTE
This command is replaced at Revision 1.1 by the dcecp command and
may not be provided in future releases of DCE.
EXAMPLES
1. The following command shows how to display the current time:
dtscp> show current time
Current Time = 1990-11-30-12:11:41.718-05:00I0.359 EST
2. The following command shows how to display all of the entity's
characteristic attribute settings:
dtscp> show all
Check Interval = +0-01:30:00.000I-----
Epoch Number = 0
Error Tolerance = +0-00:10:00.000I-----
Local Time Differential Factor = -0-04:00:00.000I-----
Maximum Inaccuracy = +0-00:00:00.100I-----
Servers Required = 3
Query Attempts = 3
Local Set Timeout = +0-00:00:05.000I-----
Global Set Timeout = +0-00:00:15.000I-----
Synchronization Hold Down = +0-00:02:00.000I-----
Type = Server
Courier Role = NonCourier
Acting Courier Role = NonCourier
Clock Adjustment Rate = 40000000 nsec/sec
Maximum Clock Drift Rate = 1000000 nsec/sec
Clock Resolution = 10000000 nsec
DTS Version = V1.0.1
Time Representation Version = V1.0.0
Time Provider Present = FALSE
Automatic TDF Change = FALSE
Next TDF Change = 1993-10-31-06:00:00.000+00:00I0.000
Server Principal Name = hosts/system1/self
Server Entry Name = hosts/system1/dts-entity
Server Group Name = subsys/dce/dts-servers
3. The following command displays the current values of all
characteristic attributes:
dtscp> show all characteristics
This command produces the same output as does the show all
command.
4. The following command shows how to display all of the local
servers known to the entity:
dtscp> show local servers
Known Servers
Local /.../sisyphus.osf.org/hosts/system2/self
Last Time Polled = 1993-10-15-21:01:46.124+00:00I0.809
Last Observed Time = 1993-10-15-21:03:09.041+00:00I-----
Last Observed Skew = +0-00:01:22.917I-----
Used in Last Synchronization = TRUE
Transport Type = RPC
Local /.../sisyphus.osf.org/hosts/system3/self
Last Time Polled = 1993-10-15-21:01:46.124+00:00I0.809
Last Observed Time = 1993-10-15-21:01:46.143+00:00I0.817
Last Observed Skew = +0-00:00:00.019I1.625
Used in Last Synchronization = TRUE
Transport Type = RPC
5. The following command displays the current values of all
counter attributes:
dtscp> show all counters
Creation Time = 1993-10-14-16:23:57.801+00:00I0.767
Local Times Not Intersecting = 0
Server Times Not Intersecting = 0
Different Epochs Detected = 0
Too Few Servers Detected = 0
Time Provider Timeouts Detected = 1
Protocol Mismatches Detected = 0
Time Representation Mismatches Detected = 0
No Global Servers Detected = 0
Servers Not Responding = 0
Clock Settings = 0
Epoch Changes Completed = 0
System Errors Detected = 0
Synchronizations Completed = 865
Updates Initiated = 0
Enable Directives Completed = 1
Disable Directives Completed = 0
Insufficient Resources Detected = 0
Time Provider Failures Detected = 0
Local server not in group = 0
Servers not in group = 0
6. The following command displays the current values of all status
attributes:
dtscp> show all status
UID = 00004e34-5e1c-2c87-8500-08005a0d4582
Last Synchronization = 1993-10-15-21:05:43.023+00:00I-----
State = On
7. The following command displays the current value of the
courier role attribute:
dtscp> show courier role
Courier Role = NonCourier
8. The following command displays the server entry name for this
server:
dtscp> show server entry name
Server Entry Name = hosts/system1/dts-entity
9. The following command displays the current state of the Time
Service entity:
dtscp> show state
State = On
10. The following command displays the current value of the check
interval attribute:
dtscp> show check interval
Check Interval = +0-01:30:00.000I-----
11. The following command displays the current value of the servers
times not intersecting counter:
dtscp> show servers times not intersecting
Server Times Not Intersecting = 0
RELATED INFORMATION
Commands: set
12 – synchronize
NAME
synchronize - Causes the DTS entity to synchronize the clock on
the system where the command is entered.
SYNOPSIS
dtscp synchronize [set clock boolean]
ARGUMENTS
set clock boolean
Specifies whether the clock is abruptly set or gradually
adjusted to the computed time. This argument is optional.
The following values are valid:
false The clock is gradually adjusted. This is the
default condition.
true The clock is abruptly set.
DESCRIPTION
The synchronize command causes the DTS clerk or server to solicit
time intervals from servers, compute the intersection of the time
intervals, and adjust the system clock to the midpoint of the
computed time interval. This command overrides the functions of the
synchronization hold down characteristic.
Privilege Required
You must have write permission on the ACL associated with the DTS
entity in order to execute the command.
NOTES
The synchronize command does not execute if the entity is already
synchronizing or is disabled; the entity must be in the on state.
This command is replaced at Revision 1.1 by the dcecp command and
may not be provided in future releases of DCE.
EXAMPLES
1. The following example shows how to initiate a synchronization
for the entity, followed by a gradual clock adjustment:
dtscp> synchronize
2. The following example shows how to initiate a synchronization
for the entity, followed by an abrupt reset of the clock:
dtscp> synchronize set clock true
13 – unadvertise
NAME
unadvertise - Removes the global server entry from the cell profile
SYNOPSIS
dtscp unadvertise
DESCRIPTION
The unadvertise command causes DTS to remove the server's name
from the cell profile and binding from the related CDS entry,
deleting the server's global status.
Privilege Required
You must have write permission on the ACL associated with the DTS
entity in order to execute the command.
NOTE
This command is replaced at Revision 1.1 by the dcecp command and
may not be provided in future releases of DCE.
EXAMPLES
dtscp> unadvertise
RELATED INFORMATION
Commands: advertise
14 – update
NAME
update - Gradually adjusts the clock on the local node to the
specified time
SYNOPSIS
dtscp update time absolute-time
ARGUMENTS
time absolute-time
Specifies the absolute time to which the clock is adjusted.
This argument is required.
DESCRIPTION
The update command gradually adjusts the system clock to a new time,
beginning at the time specified in the argument. The difference
between the current clock value and the absolute time specified in
the argument is used to adjust the clock.
Privilege Required
You must have write permission on the ACL associated with the DTS
entity in order to execute the command.
NOTES
The update command is valid only for servers. The combined time and
inaccuracy value you specify must be contained within the interval
formed by the current time and inaccuracy. That is, the new setting
must be more accurate than the current time.
This command is replaced at Revision 1.1 by the dcecp command and
may not be provided in future releases of DCE.
EXAMPLES
The following example shows how to update the time for a server;
the clock is gradually adjusted to the specified time:
dtscp> update time 1993-12-30-11:24:00.000-05:00I0.000