Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-155
FILEINFO Procedure (Superseded by
FILE_GETINFOLIST_ Procedure )
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 2-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.
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).
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:
<1> 1 For the $RECEIVE file only, means that the process wants to receive
open, close, CONTROL, SETMODE, RESETSYNC, and
CONTROLBUF messages.
<2> 1 Means unstructured access, regardless of the actual file structure (see
the OPEN procedure).
<3:5> Is the access mode:
0 read/write access
1 read-only access
2 write-only access
<6> 1 Indicates that resident buffers are provided by the application process
for calls to file system I/O routines. A 0 is always returned in this bit
(see the OPEN procedure).