Guardian Procedure Calls Reference Manual

CLOSE^FILE Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Related Programming Manual
Summary
The CLOSE^FILE procedure closes a specified file.
CLOSE^FILE is a sequential I/O (SIO) procedure and should be used only with files that have been
opened by OPEN^FILE.
Syntax for C Programmers
#include <cextdecs(CLOSE_FILE)>
short CLOSE_FILE ( { short _near *common-fcb }
{ short _near *file-fcb }
,[ short tape-disposition ] );
Syntax for TAL Programmers
error := CLOSE^FILE ( { common-fcb } ! i
{ file-fcb } ! i
,[ tape-disposition ] ); ! i
Parameters
common-fcb
input
INT:ref:*
indicates that all open files are to be closed if the common file control block (FCB) is passed.
If BREAK is owned for any file being closed, it is returned to its previous owner. Note that the
first parameter to CLOSE^FILE is either common-fcb or file-fcb; one or the other can be
passed.
file-fcb
input
INT:ref:*
identifies the file to be closed if the FCB is passed. If BREAK is owned for the file being closed,
it is returned to its previous owner. Note that the first parameter to CLOSE^FILE is either
common-fcb or file-fcb; one or the other can be passed.
tape-disposition
input
INT:value
specifies magnetic tape disposition.
CLOSE^FILE Procedure 171