Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)

Guardian Procedure Calls Reference Manual—522629-013

3-78

CLOSE^FILE Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

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

Syntax for TAL Programmers

Parameters

error returned value

INT

returns either a file-system or a sequential I/O (SIO) procedure error number

indicating the outcome of the close. In any case, the file is closed.

If the abort-on-error mode (the default) is in effect, the only possible value for

error is 0.

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

#include <cextdecs(CLOSE_FILE)>

short CLOSE_FILE ( { short _near *common-fcb }

{ short _near *file-fcb }

,[ short tape-disposition ] );

error := CLOSE^FILE ( { common-fcb } ! i

{ file-fcb } ! i

,[ tape-disposition ] ); ! i