NAME

   dtscp - DTS control program

 SYNOPSIS

   dtscp

 NOTES
   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
   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

     +  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

   For more information on any of the above dtscp commands, see the
   appropriate 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
   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.

   Counters  Show the number of occurrences of an event since the
             entity was enabled.

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

   Global Servers
             Show the global servers known by this DTS entity.

   Local Servers
             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 minutes, and 47.52 seconds. A negative Time Differential
   Factor (TDF) of 5 hours and an inaccuracy of 3 milliseconds are
   included in the timestamp.  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
             change
             create
             delete
             disable
             enable
             exit
             help
             set
             show
             synchronize
             quit
             unadvertise
             update

   Books: OSF DCE Administration Guide