INFORMIX
DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions
Home Contents Index Master Index New Book

mi_lo_stat_atime()

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

Syntax

Usage

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 gets the current value for the last-access time from the LO-status structure that LO_stat references.

Return Values

>=0

The number of seconds since January 1, 1970 for the last-access time of the smart large object whose status information is in the LO-status structure that LO_stat references.

MI_ERROR

The function was not successful.

Related Topics

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().

In Chapter 3, "Handling Smart Large Objects," see "Status Information" for information on the last-access time. See "The LO-Status Structure", and "Obtaining the Status of a Smart Large Object" for information on how to use the mi_lo_stat_atime() function.




DataBlade API Programmer's Manual, version 9.1
Copyright © 1998, Informix Software, Inc. All rights reserved.