OSF DCE Application Development Guide--Core Components

OSF DCE Application Development Guide—Core Components
interface time_provider
{
import "dce/nbase.idl";
import "dce/utctypes.idl";
/* Minimum and Maximum number of times to read time source at
* each synchronization
*/
const long K_MIN_TIMESTAMPS = 1;
const long K_MAX_TIMESTAMPS = 6;
/* Message status field return values
*/
const long K_TPI_FAILURE = 0;
const long K_TPI_SUCCESS = 1;
/* This structure contains one reading of the TP wrapped in
* the timestamps of the local clock.
*/
typedef struct TimeResponseType
{
utc_t beforeTime; /* local clk just before getting UTC */
utc_t TPtime; /* source UTC; inacc also supplied */
utc_t afterTime; /* local clk just after getting UTC */
} TimeResponseType;
/* Time-provider control message. This structure is returned
* in response to a time service request. The status field
* returns TP success or failure. The nextPoll gives the
* client the time at which to poll the TP next. The timeout
* value tells the client how long to wait for a time response
* from the TP. The noClockSet will tell the client whether
* or not it is allowed to alter the system clock after a
* synchronization with the TP.
*/
typedef struct TPctlMsg
{
unsigned long status;
unsigned long nextPoll;
unsigned long timeout;
unsigned long noClockSet;
} TPctlMsg;
20 − 6 Tandem Computers Incorporated 124245