NAME

dtscp - Starts the DTS control program

SYNOPSIS

dtscp

DESCRIPTION

Note:   With the exception of the following subcommands, this command is replaced at DCE Version 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

The ∗(8dts) reference pages describe the commands for the Distributed Time Service (DTS) control program, dtscp.  The DTS control program is a command-line interface that enables you to synchronize, adjust, and maintain the system clocks in a distributed network.  For a detailed explanation of system clock synchronization and management, see the OSF DCE Administration Guide. 

The DTS control program commands are as follows:

advertiseConfigures the DTS server as a global server. 

changeModifies the epoch and sets the local time to a new time. 

createEstablishes a DTS entity (a clerk or server). 

deleteCauses DTS to exit on the local node. 

disableSuspends a DTS entity. 

enableStarts a DTS entity. 

exitEnds the dtscp management session and returns you to the system prompt. 

helpInvokes the dtscp help service. 

quitEnds the dtscp management session and returns you to the system prompt. 

setModifies characteristics of a DTS entity. 

showDisplays characteristics of a DTS entity. 

synchronizeSynchronizes the system clock with the time obtained from DTS servers in the network. 

unadvertiseRemoves the global server entry. 

updateGradually adjusts the system clock to a new time. 

For more information on any of the above dtscp commands, see the appropriate reference page. 

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, and there may also be optional variables for the arguments and attributes.  This is shown in the following diagram:

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 argument; 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:

Characteristics
Set or show the entity’s operation.

CountersShow the number of occurrences of an event since the entity was enabled. 

StatusShow the current state of the entity. (The DTS entity has four status attributes.) 

Global ServersShow the global servers known by this DTS entity. 

Local ServersShow the local servers known by this DTS entity. 

Individual attributes within each of the previously listed groups are described in the set(8dts) and show(8dts) reference pages.  The show command also allows you to specify attribute groups. 

Time Stamps

All responses to commands contain a timestamp.  The following is a typical DTS time display:

1993-03-16-14:29:47.52000-05:00I000.003

The timestamp uses the DTS format as explained in 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 minutes, and 47.52 seconds.  A negative Time Differential Factor (TDF) of 5 hours and an inaccuracy of 3 milliseconds is included in the timestamp. 

Note:   An inaccuracy value of I----- indicates an infinite inaccuracy.  This value appears in time displays before a node’s initial synchronization, or after you enter the change command without specifying an inaccuracy value. 

RELATED INFORMATION

Commands: advertise(8dts), change(8dts), create(8dts), delete(8dts), disable(8dts), enable(8dts), exit(8dts), help(8dts), quit(8dts), set(8dts), show(8dts), synchronize(8dts), unadvertise(8dts), update(8dts). 

Books: OSF DCE Administration Guide.