clock(1m)																 clock(1m)

NAME

       clock - A dcecp object that manages the clock on a local or remote host

SYNOPSIS

       clock compare [dts_entity] [-server dts_entity]

       clock help [operation | -verbose]

       clock operations

       clock set [dts_entity] {-to DTS_timestamp [-abruptly -epoch epoch_number | -bypass] | -epoch  epoch_number}

       clock show [dts_entity] [-dtsd  | -inetd | -dced]

       clock synchronize [dts_entity] [-dtsd [-abruptly] | -inetd | -dced]

ARGUMENTS

       Identifies the dtsd server or clerk to act on.

       With the -server option in the compare operation, dts_entity can identify a DTS time provider.

       When  used  without  the  -dced	or -initd options, dts_entity can be either of the following: The name of a dtsd server, which can be on a
       remote host, in the format: /.../cellname/hosts/hostname/dts-entity A string binding for the remote host on which the dtsd is running, such
       as: ncacn_ip_tcp:130.105.1.227

       Alternatively you can specify the binding in Tcl format, such as: {ncacn_ip_tcp 130.105.1.227}

       When  used  with the -dced or -inetd options, dts_entity identifies the server by a simple host name in the form hostname.  The name of the
       clock operation for which to display help information.

DESCRIPTION

       The clock object represents the clock on a system and the time that it tells.  This object has commands to display and set the  time.   The
       time  setting  functionality  is provided by DTS, unless you specify either the -dced or -inetd option.	The optional argument to the clock
       command is the name of a DCE Version 1.1 dtsd running on some machine.  Without an argument, the _s(dts) convenience variable  is  checked.
       If this variable is not set, the command operates on the clock on the local machine.

       Use the -epoch option to change only the epoch number of the dtsd.

OPERATIONS

   clock compare
       Returns	the  difference  between  the  clocks  on the local machine and a DTS server in the cell.  The syntax is as follows: clock compare
       [dts_entity] [-server dts_entity]

       Options

       Optionally names a specific DTS server against which to compare the host clock.

       See ARGUMENTS for the format of the dts_entity argument.

       The compare operation returns the difference between the clocks on the local machine and a DTS server in the cell.   If	a  server  is  not
       specified,  the	command  picks	the  last  responding server returned by dts catalog.  An optional argument compares a remote host's clock
       against a DTS server.  An optional -server option compares the clock against a specific DTS server.

       The DTS server that responds to this operation may be communicating directly with an external time provider.  If so, the provider attribute
       returned by this operation will be set to yes.

       Privileges Required

       You must have r (read) permission  on /.:/hosts/hostname/dts-entity to execute the command.

       Examples

       dcecp> clock compare {server /.:/gumby/hosts/oddball/dts_entity} {provider no} {skew -0-00:00:00.020I-----} dcecp>

       dcecp> clock compare -server /.:/hosts/santafe/dts-entity {server /.:/hosts/santafe/dts-entity} {provider yes} {skew -0-00:00:00.292I1.431}
       dcecp>

   clock help
       Returns help information about the clock object and its operations.  The syntax is as follows: clock help [operation | -verbose]

       Options Displays information about the clock object.

       Used without an argument or option, the clock help command returns brief information about each clock operation.   The  optional  operation
       argument  is  the  name of an operation about which you want detailed information.  Alternatively, you can use the -verbose option for more
       detailed information about the clock object itself.

       Privileges Required

       No special privileges are needed to use the clock help command.

       Examples

       dcecp> clock help compare	     Returns the difference between the local clock and a server.   set 		 Sets  the  system
       clock  to the specified time.  show		  Returns the current time as a DTS style timestamp.  synchronize	  Synchronizes the
       local clock with the specified server.  help		   Prints a summary of command-line options.  operations	  Returns  a  list
       of the valid operations for this command.  dcecp>

   clock operations
       Returns a list of the operations supported by the clock object.	The syntax is as follows: clock operations

       The list of available operations is in alphabetical order except for help and operations, which are listed last.

       Privileges Required

       No special privileges are needed to use the clock operations command.

       Examples

       dcecp> clock operations compare set show synchronize help operations dcecp>

   clock set
       Sets the clock to the specified time.  The syntax is as follows: clock set [dts_entity] {-to DTS_timestamp [-abruptly -epoch epoch_number |
       -bypass] | -epoch epoch_number}

       Options This option specifies a DTS timestamp as the time to which to set the clock.  You can specify the time in  the  ISO-compliant  time
       format, as follows: CCYY-MM-DD-hh:mm:ss.fff Specifies to set the clock abruptly rather than gradually adjust it to the computed time.  Sets
       the system clock to the specified time without using DTS.  Specifies an epoch_number that matches the epochs  of  servers  with	which  the
       local clock synchronizes.

       The set operation sets the local clock to the specified time.  An optional argument sets the clock on a remote host.  The -to option speci-
       fies a DTS timestamp as the time to which to set the clock.  If you do not specify the -abruptly option, DTS adjusts the clock gradually to
       the specified time.  The -abruptly option changes to the specified time, without gradual adjustments.  If you specify the -abruptly option,
       you must also specify the -epoch option to indicate a new epoch.  You can also use the -epoch option without specifying a time to pull  the
       specified  dts_entity out of synchronization.  The -bypass option causes DTS to be ignored and sets the system clock directly.  This opera-
       tion returns an empty string on success.

       Note that setting your system clock is a dangerous operation.  If your machine is not synchronized with other machines in the  cell,  other
       DCE services, especially CDS, do not operate correctly.	See the OSF DCE Administration Guide for more information about DTS.

       Privileges Required

       You  must  have w (write) permission on the clock object (/.:/hosts/hostname/dts-entity) if using DTS to set the time, otherwise no special
       privileges are required.

       Examples

       dcecp> clock set -to 1994-07-15-16:27:28.000-04:00 -abruptly -epoch 1 dcecp>

       dcecp> clock set -epoch 5 dcecp>

   clock show
       Returns a DTS-style timestamp including the time differential factor (TDF).  The syntax is as follows: clock  show  [dts_entity]  [-dtsd  |
       -inetd | -dced]

       Options Use dced services instead of DTS to report the time.  Use inetd socket connections instead of DTS to report the time.  Use DTS ser-
       vices to report the time (default).

       The show operation returns a DTS-style timestamp with the TDF indicated.  Use the dts_entity argument to specify a remote host on which	to
       show the clock.

       Two  options  let  you  specify	that the time should be returned without using DTS services: The -dced option specifies that dced services
       should be used instead of DTS services The -inetd option specifies that inetd socket connections should be used instead of DTS

       Privileges Required

       You must have r (read) permission on the clock object (/.:/hosts/hostname/dts-entity) if using DTS to show the time, otherwise  no  special
       privileges are required.

       Examples

       dcecp> clock show 1994-07-15-16:28:02.229+00:00I----- dcecp>

       dcecp> clock show oddball -dced 1994-07-16-17:29:05.321+00:00I----- dcecp>

   clock synchronize
       Causes dtsd to synchronize with a server.  The syntax is as follows: clock synchronize [dts_entity] [-dtsd [-abruptly] | -inetd | -dced]

       Options	Causes	the clock to be set abruptly rather than gradually adjusted to the computed time.  Use dced services instead of DTS as the
       time source.  Use inetd socket connections instead of DTS as the time source.  Use DTS services as the time source.

       The synchronize operation causes the local dtsd to synchronize the local clock  gradually  with	the  cell  time  from  DTS  servers.   The
       -abruptly option changes to the specified time immediately, without gradual adjustments.

       By  default,  the  time	is retrieved from DTS.	If the -dced option is specified, the time is retrieved from dced services.  If the -inetd
       option is specified, the time is retrieved from inetd socket connections.  The optional dts_entry argument synchronizes the  clock  on  the
       named remote host.  This operation returns an empty string on success.

       Privileges Required

       You  must  have w (write) permission on the clock object (/.:/hosts/hostname/dts-entity) if using DTS to synchronize the time, otherwise no
       special privileges are required.

       Examples

       dcecp> clock synchronize dcecp>

RELATED INFORMATION

       Commands: dcecp(1m), dcecp_dts(1m), dcecp_utc(1m), dtsd(1m).

																	 clock(1m)