PSX_REMOVE

Remove a file or directory

Description:

This C function calls the "remove" RTL function to remove a specified file or directory. It is equivalent to "unlink" for files and "rmdir" for directories. A directory must be empty. On error, STATUS is set to PSX__ERRNO and the error message will contain the system error message.

Invocation

CALL PSX_REMOVE( PATHNAME, STATUS )

Arguments

PATHNAME = CHARACTER ∗ ( ∗ ) (Given)
The path to the file.
STATUS = INTEGER (Given and Returned)
The inherited global status.

Examples:

CALL PSX_REMOVE( ’tmp.dat’, STATUS )
This will remove the file tmp.dat

External Routines Used

cnf: cnfImprt ems: emsSyser

References

Copyright

Copyright (C) 1999-2004 CLRC