FILE_DELETE

Use

Deletes the specified file.

Arguments

[IMPORTING] filename TYPE STRING

name of the file to be deleted. Environment variables are not supported in file name. The file names can be either relative or absolute.

[CHANGING] rc TYPE I

Return code.

Possible values:

  • 2

    the file cannot be found in the specified directory

  • 3

    the specified directory does not exist

  • 5

    the user does not have the right to delete the file

  • 32

    the file is locked by another program

Exceptions

ACCESS_DENIED

Thrown if the account with which the user is logged on to the PC has not the permissions required to delete the file.

CNTL_ERROR

If calling the GUI function fails.

ERROR_NO_GUI

Currently not used.

FILE_DELETE_FAILED

Currently not used.

FILE_NOT_FOUND

If either the file or the directory was not found, this exception is fired.

NOT_SUPPORTED_BY_GUI

Raised if neither Windows nor Java nor Web GUI is being used.

UNKNOWN_ERROR

This exception is fired if the deletion of the file fails for any other reason than the file not being found or the access being denied.

WRONG_PARAMETER

Thrown if no file name is specified.