FairCom Corporation


F.90 DeleteIFile


Delete ISAM file and associated indices.

Short Name

DELIFIL

TYPE

ISAM function

DECLARATION

COUNT DeleteIFile(pIFIL ifilptr)

DESCRIPTION

DeleteIFile deletes the file and indices referenced by the incremental ISAM structure pointed to by ifilptr if and only if the file and indices have been opened in exclusive mode.

RETURN

Value
Symbolic Constant
Explanation
0
NO_ERROR
Successful file deletion.
55
DLTF_ERR
File could not be deleted. Does any process have the file open?
56
DLTP_ERR
File is not opened in the ctEXCLUSIVE mode. Delete is not performed.

See Appendix A "c-tree Plus Error Codes" of the c-tree Plus Programmer's Reference Guide for a complete listing of valid c-tree Plus error values.

EXAMPLE

pIFIL ifilptr;
if (OpenIFile(ifilptr)
printf("\nCould not open data file or index, error = %d,
file = %d",isam_err,isam_fil);
else if (DeleteIFile(ifilptr)
printf("\nCould not delete data file or index, error = %d,
file = %d",isam_err,isam_fil);

LIMITATIONS

DeleteIFile calls the low-level DeleteCtFile function, which first closes the file before deletion.

This permits another process to have a small window of opportunity to gain control of the file in which case the delete will fail and result in an error DLTF_ERR (55).

SEE ALSO

DeleteRFile.


FairCom Corporation
www.faircom.com