clearfile statement

The clearfile statement deletes all items in the specified file variable previously opened with an open statement.

Syntax

clearfile {file.var}

Parameter(s)

file.var Specifies the file in which all items are to be deleted.

Description

The default file.var is cleared if no file.var is specified. This statement works like the TCL clear-file command.

The file is not deleted, but all nonfile type items within the data file or dictionary are deleted. The file retains the same base and modulo. If the dictionary is specified in the associated open statement that defines the file variable, the dictionary of the file is cleared. If data is specified in the associated open statement, the data section of the file is cleared. If neither is specified in the associated open statement, the data section of the file is cleared.

CAUTION:
Once started, it clears the file to completion. The process cannot be stopped.