$FunForc: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
m (1 revision)
Line 4: Line 4:
This cancels a ''[[Fast/Unload]]'' request which is either running or enqueued to run.  
This cancels a ''[[Fast/Unload]]'' request which is either running or enqueued to run.  


The $FunForc function accepts one argument and returns a numeric result.  
The <var>$FunForc</var> 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 cancelled. To cancel 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 cancels it:
The only argument is a string that identifies the request number for the request to be cancelled. To cancel 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 cancels it:
Line 27: Line 27:




<var>$FunForc</var> immediately DETACH'es a ''[[Fast/Unload]]'' task while $FunPurg allows the ''[[Fast/Unload]]'' task to do a "clean" termination. Indiscriminate use of $FunForc could result in certain resources (such as sort work files) being left "in use". $FunForc should be used when [[$FunPurg]] cannot purge the request cleanly.<p>
<var>$FunForc</var> immediately DETACH'es a ''[[Fast/Unload]]'' task while <var>$FunPurg</var> allows the ''[[Fast/Unload]]'' task to do a "clean" termination. Indiscriminate use of <var>$FunForc</var> could result in certain resources (such as sort work files) being left "in use". <var>$FunForc</var> should be used when [[$FunPurg]] cannot purge the request cleanly.<p>


<ul class="smallAndTightList">
<ul class="smallAndTightList">

Revision as of 19:44, 19 October 2012

Cancel running or waiting Fast/Unload request

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

The $FunForc 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 cancelled. To cancel 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 cancels it:

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

Syntax

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

$FunForc Function

%RESULT is set either to 0, if the request number req_num was found and cancelled, or to an error code, if the request could not be found or cancelled.

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

$FunForc Error Codes


$FunForc immediately DETACH'es a Fast/Unload task while $FunPurg allows the Fast/Unload task to do a "clean" termination. Indiscriminate use of $FunForc could result in certain resources (such as sort work files) being left "in use". $FunForc should be used when $FunPurg cannot purge the request cleanly.

Products authorizing $FunForc