org.omg.CosTime
Interface TimeServiceOperations

All Known Subinterfaces:

TimeService

All Known Implementing Classes:

_TimeServiceStub, TimeServicePOA, TimeServicePOATie

public interface TimeServiceOperations

The TimeService interface provides operations for obtaining the current time, constructing a UTO with specified values for each attribute, and constructing a TIO wuth specified upped and lower bounds.

Method Summary

TIO	new_interval(long lower, long upper) Operation new_interval
UTO	new_universal_time(long time, long inaccuracy, short tdf) Operation new_universal_time
UTO	secure_universal_time() The secure_universal_time operation returns the current time in a UTO only if the time can be guaranteed to have been obtained securely.
UTO	universal_time() The universal_time operation returns the current time and an estimate of inaccuracy in a UTO.
UTO	uto_from_utc(UtcT utc) Operation uto_from_utc

Method Detail

universal_time

UTO universal_time()
                   throws TimeUnavailable

The universal_time operation returns the current time and an estimate of inaccuracy in a UTO. It raises TimeUnavailable exceptions to indicate failure of an underlying time provider. The time returned in the UTO by this operation is not guaranteed to be secure or trusted. If any time is available at alll, that tile is returned by this operation.

Throws:

TimeUnavailable

secure_universal_time

UTO secure_universal_time()
                          throws TimeUnavailable

The secure_universal_time operation returns the current time in a UTO only if the time can be guaranteed to have been obtained securely. In order to make such a guarantee, the underlying TimeService must meet the criteria to be followed for secure time implementation guideslines. If there is any uncertainty at all about meeting any aspect of these criteria, then this operation must return the TimeUnavailable exception. Thus, time obtained through this operation can alwys be trusted.

Throws:

TimeUnavailable

new_universal_time

UTO new_universal_time(long time,
                       long inaccuracy,
                       short tdf)

Operation new_universal_time

uto_from_utc

UTO uto_from_utc(UtcT utc)

Operation uto_from_utc

new_interval

TIO new_interval(long lower,
                 long upper)

Operation new_interval