dtscp(1m)																 dtscp(1m)

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  com-
       mand-line interface that enables you to synchronize, adjust, and maintain 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 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 con-
       trol 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:

       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 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  inaccu-
       racy.  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

																	 dtscp(1m)