Guardian Procedure Calls Reference Manual

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.
filecode
output
INT:ref:1
for disk files only, returns the application-defined file code that is assigned when the file is
created.
secondary-extent-size
output
INT:ref:1
for disk files only, returns the size of the secondary file extents in 2048-byte units. A returned
value of -1 in this parameter means that the extent size cannot fit into this unsigned two-byte
parameter. The superseding procedure must be used to get the correct value.
current-record-pointer
output
INT(32):ref:1
for disk files only, returns the setting of the current-record pointer. This can be an even or odd
value. This parameter is invalid with file-name; use filenum. This parameter cannot be
used with 64-bit primary keys. If an attempt is made, error 581 is returned.
A record numberrelative files
A record addressentry-sequenced files
An RBAunstructured files
Parameter is ignored (whatever is passed returns unchanged).key-sequenced files
open-flags
output
INT:ref:1
returns the access granted when the file is opened. This parameter is invalid when used with
file-name; use filenum. In this parameter:
For the $RECEIVE file only, means that the process wants to receive open, close, CONTROL, SETMODE,
RESETSYNC, and CONTROLBUF messages.
<1> 1
Means unstructured access, regardless of the actual file structure (see OPEN Procedure (Superseded
by FILE_OPEN_ Procedure) (page 897)).
<2> 1
Is the access mode:<3:5>
read/write access0
read-only access1
write-only access2
FILEINFO Procedure (Superseded by FILE_GETINFOLIST_ Procedure) 553