$FunPurg: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 1: Line 1:
{{DISPLAYTITLE:$FunPurg}}
{{DISPLAYTITLE:$FunPurg}}
<span class="pageSubtitle"><section begin="desc" />Purge running or waiting [[Fast/Unload]] request<section end="desc" /></span>
<span class="pageSubtitle">Purge running or waiting [[Fast/Unload]] request</span>


This purges a ''[[Fast/Unload]]'' request which is either running or enqueued to run.  
This purges a ''[[Fast/Unload]]'' request which is either running or enqueued to run.  

Revision as of 21:21, 22 November 2011

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

<section begin="syntax" /> %RESULT = $FunPurg(req_num) <section end="syntax" />

$FunPurg Function

%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

$FunPurg Error Codes

Products authorizing $FunPurg