HELPLIB.HLB  —  DCE  DCE_DTS, dtscp_commands, enable
 NAME

   enable - Starts the DTS entity on the local node.

 SYNOPSIS

   dtscp enable [set clock <boolean>]

 ARGUMENTS

   set clock <boolean>
             Specifies whether the clock is abruptly set or gradually
             adjusted to the computed time. This argument is optional.
             Valid values for <boolean> are:

             false     The clock is gradually adjusted. This is the
                       default condition.

             true      The clock is abruptly set.

 DESCRIPTION

   After the DTS entity is created with the dtscp create command, it
   is still in a non-functioning state. To put it into operation, you
   must invoke dtscp enable, which causes an immediate synchronization
   to take place.  When the command is executed, the status attribute
   state is set to on.

   In addition, you may use the enable command to activate a DTS
   entity that has previously been deactivated with the disable
   command.  See the disable reference page in this chapter for more
   information.

   Privilege Required

   You must have write permission on the ACL associated with the DTS
   entity in order to execute the command.

 NOTES

   The DTS entity cannot be enabled until it is created with the
   create command; the DTS entity must be in the off state.

   This command is replaced at Revision 1.1 by the dcecp command and
   may not be provided in future releases of DCE.

 EXAMPLES

    1.  The following example shows how to enable the entity and adjust
        the clock gradually to the computed time following the first
        synchronization:

             dtscp> enable

    2.  The following example shows how to enable the entity and
        abruptly set the clock to the computed time following the
        first synchronization:

             dtscp> enable set clock true

 RELATED INFORMATION

   Commands: create
             disable
Close Help