dtscp(1m)dtscp(1m)NAMEdtscp - DTS control program
SYNOPSISdtscpNOTES
With the exception of the following subcommands, this command is
replaced at Revision 1.1 by the dcecp command. This command may be
fully replaced by the dcecp command in a future release of DCE, and may
no longer be supported at that time.
exit help quit
DESCRIPTION
This section describes the commands for the DCE Distributed Time Ser‐
vice (DTS) control program (dtscp). The DTS control program is a com‐
mand-line interface that enables you to synchronize, adjust, and main‐
tain the system clocks in a distributed network. For a detailed expla‐
nation of system clock synchronization and management, see the OSF DCE
Administration Guide.
The DTS control program commands are The advertise command, which con‐
figures 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 com‐
mand, 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 dis‐
plays 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
For more information on any of the above dtscp commands, see the appro‐
priate reference page in this chapter.
You can use control program commands from within the control program or
from the system prompt. To enter DTS commands from within the control
program, first start the control program by entering the dtscp command.
For example: $ dtscp dtscp> At this prompt you can enter any control
program command; for example: dtscp> show current time
To leave the control program and return to the system prompt, enter the
exit command.
To enter DTS commands from the system prompt (interactively or in a
command procedure) enter the dtscp command with an internal command of
the control program as the first argument. The control program executes
the command without displaying the control program prompt. For example,
you can enter the synchronize command as follows: $ dtscp synchronize
Some dtscp commands have optional arguments or attributes; there may
also be optional variables for the arguments and attributes.
See the following sample command: dtscp> update time
1990-08-03-05:45:28.000+01:00I00.500
/ / /
Command [Argument] Variable
--------
[Attribute]
Abbreviations
You can enter as few as three characters for each DTS command or argu‐
ment; DTS commands and arguments are unique for three characters or
more. For example, rather than entering the command enable set clock
true, you can enter the following abbreviated command: dtscp> ena set
clo tru
Attributes
The dtscp set and show commands have several attributes—pieces or sets
of data associated with them. The attribute groups are categorized as
follows:
Set or show the entity's operation. Show the number of occurrences of
an event since the entity was enabled. Show the current state of the
entity. (The DTS entity has four status attributes.) Show the global
servers known by this DTS entity. Show the local servers known by this
DTS entity.
Individual attributes within each of the previously listed groups are
described in the reference pages for the set and show commands. The
show command also allows you to specify attribute groups.
Time Stamps
All responses to commands contain a timestamp. The following example
shows a typical DTS time display:
1993-03-16-14:29:47.52000-05:00I000.003
The timestamp uses the DTS format that is explained in Chapter 15 of
the OSF DCE Administration Guide—Core Components. In this example, the
year is 1993, the day is March 16, and the time is 14 hours, 29 min‐
utes, and 47.52 seconds. A negative Time Differential Factor (TDF) of 5
hours and an inaccuracy of 3 milliseconds are included in the time‐
stamp. An inaccuracy value of I----- indicates an infinite inaccuracy.
This value appears in time displays before a node's initial synchro‐
nization or after you enter the change command without specifying an
inaccuracy value.
RELATED INFORMATION
Commands: advertise, change, create, delete, disable, enable, exit,
help, set, show, synchronize, quit, unadvertise, update
Books: OSF DCE Administration Guide
dtscp(1m)