FairCom ISAM for C

CloseISAM

Close all ISAM files.

Short Name

CLISAM()

Type

ISAM function

Declaration

COUNT CloseISAM()

Description

CloseISAM() closes all the files opened in the current FairCom DB session and frees all memory allocated by that session. If CloseISAM() encounters difficulty closing a file, it tries to close the remaining files. The error code returned by CloseISAM() pertains to the first file that could not be closed.

Before a second FairCom DB session is started with a call to InitCTree(), CreateISAM(), InitISAM() or OpenISAM() can be made, CloseISAM() must be called.

Return

Value	Symbolic Constant	Explanation
0	NO_ERROR	Successful close of ISAM files.
22	FNUM_ERR	File number out of range.
24	FCLS_ERR	Could not close file number isam_fil.

See FairCom DB Error Codes for a complete listing of valid FairCom DB error values.

Example

extern IFIL myfile;

COUNT retval;

if (retval = InitISAM(6,7,4))

printf("\nCould not close files. Error %d.", retval);

else {

if (OpenIFile(&myfile))

printf("\nCould not open files.");

if (CloseISAM())

printf("\nCould not close ISAM.");

}

Limitations

CloseISAM() closes all ISAM files including those opened or created with the incremental ISAM functions.