NAME

remove - remove a file from the file system


SYNOPSIS

stat = remove (filename)



character filename(FILENAMESIZE)
integer stat returned as OK/ERR



DESCRIPTION

From within a running program, remove (or delete) the file
specified by "name" from the file system.
"Name" is an ascii character array.
The file need not be opened to be removed.

If the file exists and can be removed, OK is returned.
If the file does not exist or cannot be removed for some
other reason, the function returns ERR.


IMPLEMENTATION

The file to be removed need not be connected to the running program.
However, if it is,
remove
closes the file before removing it.



SEE ALSO

open, close, create


DIAGNOSTICS

If the file does not exist the routine returns ERR.