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]  [abruptly  | dtsd  | inetd  | dced  ]

Arguments

dts_entityIdentifies 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 

   •As 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 dcecp  string  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. 

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

Errors

A representative list of errors that might be returned is not shown here.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

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

server  dts_entity
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

verboseDisplays 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

to  DTS_timestamp
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 

abruptlySpecifies to set the clock abruptly rather than gradually adjust it to the   computed time. 

bypassSets the system clock to the specified time without using DTS. 

epoch  epoch_number
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 specifies 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   system clock directly. This operation 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  g    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

dcedUse dced  services instead of DTS to report the time. 

inetdUse inetd  socket connections instead of DTS to report the time. 

dtsdUse DTS services to report the time. 

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 gradually with a server. 
 The syntax is as follows:

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

Options

abruptlyCauses the clock to be set abruptly rather than gradually adjusted to the   computed time. 

dcedUse dced  services instead of DTS as the time source. 

inetdUse inetd  socket connections instead of DTS as the time source. 

dtsdUse 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(8dce), dts(8dce), dtsd(8dts), utc(8dce).