Guardian Procedure Calls Reference Manual

FILE_CLOSE_Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Messages
Related Programming Manuals
Summary
The FILE_CLOSE_ procedure closes an open file. Closing a file terminates access to the file. You
can use FILE_CLOSE_ to close files that were opened by either FILE_OPEN_ or OPEN.
Syntax for C Programmers
#include <cextdecs(FILE_CLOSE_)>
short FILE_CLOSE_ ( short filenum
,[ short tape-disposition ] );
Syntax for TAL Programmers
error := FILE_CLOSE_ ( filenum ! i
,[ tape-disposition ] ); ! i
Parameters
filenum
input
INT:value
is the number identifying the open file to be closed. filenum was returned by FILE_OPEN_
or OPEN when the file was originally opened.
tape-disposition
input
INT:value
is one of these values, indicating the tape control action to take:
Rewind and unload; do not wait for completion.0
Rewind and unload, do not wait for completion.1
Rewind and leave online; do not wait for completion.2
Rewind and leave online; wait for completion.3
Do not rewind; leave online.4
Reserved for parallel backup.5
Other input values result in no error if the file is a tape device; the control action might be
unpredictable.
If omitted, 0 is used.
362 Guardian Procedure Calls (F)