Description: The Time entry denotes the Event Log's idea of the current time; i.e the timestamp that would be placed on an entry if it was added now.

Remarks:

Entries placed in the Event Log after this function is called will have Event Log timestamps (i.e., the Timestamp field in the SaHpiEventLogEntryT structure) based on the new time. Setting the clock does not affect existing Event Log entries. If the time is set to a relative time, subsequent entries placed in the Event Log will have an Event Log timestamp expressed as a relative time; if the time is set to an absolute time, subsequent entries will have an Event Log timestamp expressed as an absolute time.

This function only sets the Event Log time clock and does not have any direct bearing on the timestamps placed on events (i.e., the Timestamp field in the SaHpiEventT structure), or the timestamps placed in the domain RPT info record. Setting the clocks used to generate timestamps other than Event Log timestamps is implementation-dependent, and should be documented by the HPI implementation provider.

Some underlying implementations may not be able to handle the same relative and absolute time ranges, as those defined in HPI. Such limitations will be documented in implementation-specific documentation. When a time value is set in a region that is not supported by the implementation, an error code of SNMP_GENERROR will be returned.

Refer to SaHpiTime for full description.