$FunPurg: Difference between revisions
No edit summary |
|||
Line 2: | Line 2: | ||
<span class="pageSubtitle">Purge running or waiting Fast/Unload request</span> | <span class="pageSubtitle">Purge running or waiting Fast/Unload request</span> | ||
This purges a | This purges a <i>[[Fast/Unload]]</i> request which is either running or enqueued to run. | ||
The <var>$FunPurg</var> function accepts one argument and returns a numeric result. | The <var>$FunPurg</var> function accepts one argument and returns a numeric result. |
Revision as of 21:48, 11 November 2014
Purge running or waiting Fast/Unload request
This purges a Fast/Unload request which is either 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 0 if the request number req_num was found and purged, or it is set to 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