$FunPurg

From m204wiki
Jump to navigation Jump to search

Purge running or waiting Fast/Unload request

This purges a Fast/Unload request which is running or enqueued to run.

The $FunPurg function accepts one argument and returns a numeric result.

The only argument is a string that identifies the request number for the request to be purged. To purge a request, a user must either have initiated the request or have system manager privileges. For example, the following code creates an asynchronous unload request, and then immediately purges it:

%RC = $FunLoad('DATA',..,'ASYNC') IF %RC GE 0 THEN %RC = $FunPurg(%RC) END IF

Syntax

%result = $FunPurg(req_num)

%result is set to either of these:

  • 0, if the request number req_num was found and purged
  • An error code if the request could not be found or purged:

    5 - User does not have privilege to purge request 6 - Request not found

Products authorizing $FunPurg