Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_lo_stat_atime() function returns from an LO-status structure the last access time for a smart large object.

mi_integer mi_lo_stat_atime(LO_stat)

MI_LO_STAT *LO_stat;

LO_stat

is a pointer to an LO-status structure that mi_lo_stat() allocates and fills in with status information.

Valid in Client LIBMI Application?	Valid in User-Defined Routine?
Yes	Yes

The mi_lo_stat_atime() function is the LO-status accessor function that returns the last access time from a set of status information. The last access time is only guaranteed to be maintained if the smart large object has the last access-time attribute (the MI_LO_ATTR_KEEP_LASTACCESS_TIME constant) set. If this flag has not been set, the smart-large-object optimizer does not save the last access-time value to disk. The resolution of the last access time that the mi_lo_stat_atime() function returns is number of seconds since 00:00:00, January 1, 1970.

Important: Before you call mi_lo_stat_atime(), you must initialize an LO-status structure with the mi_lo_stat() function.

The mi_lo_stat_atime() function obtains the current value for the last access time from the LO-status structure that LO_stat references.

See the description of the following functions: mi_lo_stat(), mi_lo_stat_cspec(), mi_lo_stat_ctime(), mi_lo_stat_free(), mi_lo_stat_mtime_sec(), mi_lo_stat_refcnt(), and mi_lo_stat_size().

For more information about the last access time of a smart large object, see Status Information. For more information on how to use the mi_lo_stat_atime() function, see The LO-Status Structure, and Obtaining the Status of a Smart Large Object.