Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-154
FILEINFO Procedure (Superseded by
FILE_GETINFOLIST_ Procedure )
devtype output
INT:ref:1
returns the device type and subtype of the device associated with this primary
partition file. If
devtype.<0> = 1, this device is a demountable disk volume. See
Appendix A, Device Types and Subtypes
for a list of device types and subtypes.
extent-size output
INT:ref:1
for disk files, returns the primary extent size in 2048-byte units. For nondisk
devices, it returns the configured physical record length in bytes. For interprocess
files, this parameter has no meaning. A returned value of -1 in this parameter
means that the extent size cannot fit into this unsigned 2-byte parameter. The
superseding procedure must be used to get the correct value.
eof-pointer output
INT(32):ref:1
for disk files only, returns the relative byte address (RBA) of the end-of-file location.
A returned value of -1 in this parameter means that the end-of-file value cannot fit
into this unsigned 4-byte parameter. The superseding procedure must be used to
get the correct value.
next-record-pointer output
INT(32):ref:1
for disk files only, returns the next-record pointer setting:
relative files A record number
entry-sequenced files A record address
unstructured files An RBA
key-sequenced files Parameter is ignored (whatever is passed returns
unchanged).
This parameter is not valid with
file-name; use filenum. This parameter cannot
be used with 64-bit primary keys. If an attempt is made, error 581 is returned.
last-modtime output
INT:ref:3
for disk files only, returns a three-word timestamp indicating the last time the file
was modified; if the file has never been modified, its creation time is returned.
last-modtime is of the same form as the interval-clock returned by
TIMESTAMP and can be converted into a date by CONTIME.
You can obtain the same information in a four-word timestamp by calling
FILEINQUIRE.