Working with Status Characteristics

The IfxLoStat class stores some statistical information about a smart large object such as the size, last access time, last modified time, last status change, and so on. Figure 6 shows the status information that you can obtain.

Figure 6. Status Information for a Smart Large Object

Status Information

Description

Last-access time

The time, in seconds, that the smart large object was last accessed

This value is available only if the last-access time attribute is enabled for the smart large object. For more information, see Last-Access Time.

Last-change time

The time, in seconds, of the last change in status for the smart large object

A change in status includes changes to metadata and user data (data updates and changes to the number of references). This system time is stored as number of seconds since January 1, 1970.

Last-modification time

The time, in seconds, that the smart large object was last modified

A modification includes only changes to user data (data updates). This system time is stored as the number of seconds since January 1, 1970.

On some platforms, the last-modification time might also have a microseconds component, which can be obtained separately from the seconds component.

Size

The size, in bytes, of the smart large object

Storage characteristics

See Working with Storage Characteristics.

To obtain a reference to the status structure, call the following method in the IfxSmartBlob class:

To obtain particular categories of status information, call the methods shown in Figure 7.

Figure 7. Methods for Obtaining Status Information

Status Information: Method Signature in ifxLoStat Class
Last-access time: int getLastAccessTime()
Last-change time: int getLastStatusTime()
Last-modification time: int getLastModifyTimeM() - time in microseconds
int getLastModifyTimeS() - time rounded to seconds
Size: int getSize()
Storage characteristics: ifxLobDescriptor getLobDescriptor()