FastUnloadTask (Recordset function): Difference between revisions
m (1 revision) |
m (1 revision) |
||
| Line 27: | Line 27: | ||
available in the Online in which it is running, which means that the | available in the Online in which it is running, which means that the | ||
FUNTSKN system parameter must be set to 1 or higher. | FUNTSKN system parameter must be set to 1 or higher. | ||
For more information about <var class="product">Fast/Unload User Language Interface</var> environmental considerations, see the &FUNR.. | For more information about <var class="product">Fast/Unload User Language Interface</var> environmental considerations, see the &FUNR.. | ||
==Syntax== | ==Syntax== | ||
<p class="syntax">%funtask = %rs:FastUnloadTask( [Input=] inlist - | <p class="syntax">%funtask = %rs:FastUnloadTask( [Input=] inlist - | ||
[, [Parameters=] parms] - | [,&nbsp;[Parameters=] parms] - | ||
[, AllMessages=bool] - | [,&nbsp;AllMessages=bool] - | ||
[, ReportToStringlist=bool] - | [,&nbsp;ReportToStringlist=bool] - | ||
[, MaxTime=sec] ) | [,&nbsp;MaxTime=sec] ) | ||
</p> | </p> | ||
===Syntax | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>%funtask</th> | <tr><th>%funtask</th> | ||
| Line 61: | Line 61: | ||
<td>A numeric value that indicates the maximum number of seconds after initiation of the request that the request is given to complete. If the request has not even started running in a <var class="product">[[Fast/Unload]]</var> task, or if the task is running, but hasn't completed after the timeout period, the request is cancelled (resulting in a return code 32 from <var class="product">[[Fast/Unload]]</var>). | <td>A numeric value that indicates the maximum number of seconds after initiation of the request that the request is given to complete. If the request has not even started running in a <var class="product">[[Fast/Unload]]</var> task, or if the task is running, but hasn't completed after the timeout period, the request is cancelled (resulting in a return code 32 from <var class="product">[[Fast/Unload]]</var>). | ||
A value of 0 for <var>MaxTime</var> means that the request will never timeout. | A value of 0 for <var>MaxTime</var> means that the request will never timeout. | ||
<var>MaxTime</var> is the [[Notation conventions for methods#Named parameters|required name]] for the parameter. The parameter itself is an optional parameter, and it defaults to the setting of the FUNMAXT system parameter. FUNMAXT is described in the &FUNR.. '''Note:''' A request can timeout through no fault of its own if all the <var class="product">[[Fast/Unload]]</var> tasks are taken up by other long-running requests. | <var>MaxTime</var> is the [[Notation conventions for methods#Named parameters|required name]] for the parameter. The parameter itself is an optional parameter, and it defaults to the setting of the FUNMAXT system parameter. FUNMAXT is described in the &FUNR.. '''Note:''' A request can timeout through no fault of its own if all the <var class="product">[[Fast/Unload]]</var> tasks are taken up by other long-running requests. | ||
</td></tr></table> | </td></tr></table> | ||
Revision as of 17:21, 13 April 2011
<section begin=dpl_desc/><section end=dpl_desc/>
FastUnloadTask is a member of the Recordset class.
This method performs unloads using Fast/Unload where the Fast/Unload output is processed programmatically as it is received.
The FastUnloadTask approach has this advantage over the FastUnload method with a Stringlist output: it avoids potentially large quantities of data from being moved to and from CCATEMP. Its disadvantage is that, since User Language processing is likely to be slower than Fast/Unload processing, using FastUnloadTask is likely to tie up a Fast/Unload task much longer than using FastUnload, which sends its output to a Stringlist.
FastUnloadTask returns a FastUnloadTask object that can be used to retrieve output from Fast/Unload.
The FastUnloadTask function is only available to customers licensed for the Fast/Unload User Language Interface.
The FastUnload function also requires at least one FastUnload task to be available in the Online in which it is running, which means that the FUNTSKN system parameter must be set to 1 or higher. For more information about Fast/Unload User Language Interface environmental considerations, see the &FUNR..
Syntax
%funtask = %rs:FastUnloadTask( [Input=] inlist - [, [Parameters=] parms] - [, AllMessages=bool] - [, ReportToStringlist=bool] - [, MaxTime=sec] )
Syntax terms
| %funtask | A reference to an instance of a FastUnloadTask object. |
|---|---|
| %rs | A reference to an instance of a Recordset object. |
| Input=inlist | A Stringlist object that contains the Fast/Unload FUEL program for the unload. Input is the allowed name for the parameter. |
| Parameters=parms | A string that contains the parameters that are to be passed to Fast/Unload. Parameters is the allowed name for the parameter.
This is an optional parameter; if it is not specified, no parameters are passed to Fast/Unload. |
| AllMessages=bool | A Boolean enumeration, providing functionality similar to the $Funload ALLMSG parameter: if True, all messages that would go in the Fast/Unload report are sent to the report dataset, report Stringlist, or FUNAUDIT. Informational messages ordinarily suppressed by Fast/Unload User Language Interface are included by this setting.
AllMessages is the required name for the parameter. The parameter itself is an optional parameter, and it defaults to False. That is, many informational messages are suppressed from the report output. |
| ReportToStringlist=bool | A Boolean enumeration value:
|
| MaxTime=sec | A numeric value that indicates the maximum number of seconds after initiation of the request that the request is given to complete. If the request has not even started running in a Fast/Unload task, or if the task is running, but hasn't completed after the timeout period, the request is cancelled (resulting in a return code 32 from Fast/Unload).
A value of 0 for MaxTime means that the request will never timeout. MaxTime is the required name for the parameter. The parameter itself is an optional parameter, and it defaults to the setting of the FUNMAXT system parameter. FUNMAXT is described in the &FUNR.. Note: A request can timeout through no fault of its own if all the Fast/Unload tasks are taken up by other long-running requests. |