Guardian Procedure Calls Reference Manual

Table 9 CHECK^FILE Operations That Return Addresses (continued)
ret-addr (for native callers) retval (for other callers)State of Fileoperation
<logical file name>[1] through [8]
Returns the word address within the FCB of the file opener’s PID.
Valid only for C-series format FCBs.
OpenFILE^OPENERSPID^ADDR
Returns the word address within the FCB of an INT (32) sequence
number. This is the line number of the last record read of an EDIT
AnyFILE^SEQNUM^ADDR
file. For other files, this is the sequence number of the last record
read multiplied by 1000.
Returns the word address within the FCB of the user flag word.AnyFILE^USERFLAG^ADDR
Considerations
• During the execution of this procedure, the detection of any error causes the display of an
error message and the process is aborted.
• This procedure is used to get the primary extent or secondary extent size of a file that is no
greater than 65,535 pages. If the primary and secondary extent sizes are greater than 65,535,
error 538 is returned.
Examples
Native caller:
CALL CHECK^FILE (IN^FILE , FILE^FILENAME^ADDR, INFILE^ADDR);
Other callers:
@INFILE^NAME := CHECK^FILE (IN^FILE , FILE^FILENAME^ADDR);
Related Programming Manual
For programming information about the CHECK^FILE procedure, see the Guardian Programmer's
Guide.
CHECK^FILE Procedure 127