*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> dtscp (1m)              


 dtscp(1m)                Open Software Foundation                 dtscp(1m)

 NAME    [Toc]    [Back]
      dtscp - DTS control program

 SYNOPSIS    [Toc]    [Back]

 NOTES    [Toc]    [Back]
      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    [Toc]    [Back]
      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

        +  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.

 Hewlett-Packard Company            - 1 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96

 dtscp(1m)                Open Software Foundation                 dtscp(1m)

        +  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:


      At this prompt you can enter any control program command; for example:

      tscp> 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:

      tscp>   update time 1990-08-03-05:45:28.000+01:00I00.500
              /       /           /

 Hewlett-Packard Company            - 2 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96

 dtscp(1m)                Open Software Foundation                 dtscp(1m)

         Command   [Argument]   Variable

    Abbreviations    [Toc]    [Back]
      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:

      tscp> ena set clo tru

    Attributes    [Toc]    [Back]
      The dtscp set and show commands have several attributes-pieces or sets
      of data associated with them. The attribute groups are categorized as

      Characteristics    [Toc]    [Back]
                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    [Toc]    [Back]
                Show the global servers known by this DTS entity.

      Local Servers    [Toc]    [Back]
                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    [Toc]    [Back]
      All responses to commands contain a timestamp.  The following example
      shows a typical DTS time display:


      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

 Hewlett-Packard Company            - 3 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96

 dtscp(1m)                Open Software Foundation                 dtscp(1m)


      Note:  An inaccuracy value of ----- 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.

      Commands: advertise, change, create, delete, disable, enable, exit,
      help, set, show, synchronize, quit, unadvertise, update

      Books: OSF DCE Administration Guide

 Hewlett-Packard Company            - 4 -OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
[ Back ]
 Similar pages
Name OS Title
pppctl OpenBSD PPP control program
camcontrol FreeBSD CAM control program
pppctl FreeBSD PPP control program
stacker IRIX robotics control program
cdscp HP-UX Starts the CDS control program
rpccp HP-UX Starts the RPC control program
ndc FreeBSD name daemon control program
iopctl OpenBSD a program to control IOP devices
timedc OpenBSD timed control program
timedc FreeBSD timed control program
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service