Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-159
FILEINFO Procedure (Superseded by
FILE_GETINFOLIST_ Procedure )
<4> 0 Crash-open flag off
1 Crash-open flag on (This is meaningful with the
file-name
parameter only.)
<5> 0 Rollforward needed flag off
1 Rollforward needed flag on
<6> 0 Broken file flag off
1 Broken file flag on
<7> 0 File closed
1 File is either open or has an incomplete TMF transaction against it.
(This is meaningful with the
file-name parameter only.)
<8> 0 Not licensed to have privileged procedures.
1 Licensed to have privileged procedures.
<9> 0 Not a secondary partition of a partitioned file.
1 Is a secondary partition of a partitioned file.
<10> 0 File contents are valid.
1 File contents are probably invalid because a FUP DUP or LOAD,
RESTORE, or similar operation ended abnormally. When this bit is 1,
OPEN fails with error 59, although PURGE will work.
<11:15> Reserved
sync-depth output
INT:ref:1
If this parameter is specified, the
filenum parameter must be specified and must
contain the number of an open file. FILEINFO returns the sync depth (or receive
depth for $RECEIVE) of the file.
next-open-fnum output
INT:ref:1
If this parameter is specified, the
filenum parameter must be specified and must
contain the number of an open file or -1.
If an open file number is specified in
filenum, FILEINFO returns the largest
number of an open file whose file number is less than the file number specified in
filenum. If there is no such file, FILEINFO returns -1.
If -1 is specified in
filenum, FILEINFO returns the file number of the open file with
the largest file number, or -1 if no files are currently open.
Table 5-8
indicates which FILEINFO parameters are valid when specifying the
filenum or file-name parameter.
Caution. If the BUFFERED option is specified for an nonaudited file, a system failure or disk-
process takeover (with sync-depth = 0) could cause the loss of buffered updates for the file
that an application might not detect or handle properly unless modified.