Fast/Unload: Difference between revisions
mNo edit summary |
mNo edit summary |
||
| Line 7: | Line 7: | ||
run. | run. | ||
<var class="product">Fast/Unload</var> can either be invoked directly as a standalone load module or from a User | <var class="product">Fast/Unload</var> can either be invoked directly as a standalone load module or from a <var class="product">User | ||
Language program. When invoked as a standalone load module, <var class="product">Fast/Unload</var> | Language</var> program. When invoked as a standalone load module, <var class="product">Fast/Unload</var> | ||
enqueues the data file in share mode unless explicitly requested otherwise. If the | enqueues the data file in share mode unless explicitly requested otherwise. If the | ||
enqueue fails, <var class="product">Fast/Unload</var> terminates with an error condition code. It is thus the file | enqueue fails, <var class="product">Fast/Unload</var> terminates with an error condition code. It is thus the file | ||
| Line 15: | Line 15: | ||
The <var class="product">Fast/Unload User Language Interface</var>, purchased as a separate <var class="product">Fast/Unload</var> option, | The <var class="product">Fast/Unload User Language Interface</var>, purchased as a separate <var class="product">Fast/Unload</var> option, | ||
allows one to invoke <var class="product">Fast/Unload</var> from User Language, | allows one to invoke <var class="product">Fast/Unload</var> from <var class="product">User Language</var>, | ||
using the <var>[[FastUnload (Recordset function)|FastUnload]]</var> or <var>[[FastUnloadTask (Recordset function)|FastUnloadTask]]</var> functions of | using the <var>[[FastUnload (Recordset function)|FastUnload]]</var> or <var>[[FastUnloadTask (Recordset function)|FastUnloadTask]]</var> functions of | ||
the <var>[[Recordset class|Recordset]]</var> class or the <var>[[$FunLoad]]</var> function. | the <var>[[Recordset class|Recordset]]</var> class, or using the <var>[[$FunLoad]]</var> function. | ||
With this approach, an application builds a set of records to be unloaded, using standard User | With this approach, an application builds a set of records to be unloaded, using standard <var class="product">User | ||
Language statements; for example, you can reduce unload time by restricting the set of | Language</var> statements; for example, you can reduce unload time by restricting the set of | ||
records using indexed <var class="product">Model 204</var> fields. The <var class="product">Fast/Unload</var> load module runs in a subtask | records using indexed <var class="product">Model 204</var> fields. The <var class="product">Fast/Unload</var> load module runs in a subtask | ||
(or PST under CMS) of <var class="product">Model 204</var>. | (or PST under CMS) of <var class="product">Model 204</var>. | ||
| Line 26: | Line 26: | ||
A system manager can cancel or examine <var class="product">Fast/Unload</var> requests, and each user can | A system manager can cancel or examine <var class="product">Fast/Unload</var> requests, and each user can | ||
perform the same functions on asynchronous requests that he or she initiated. | perform the same functions on asynchronous requests that he or she initiated. | ||
To explore the details, see | To explore the details, see the [[:Category:Fast/Unload User Language Interface|components]] of the <var class="product">Fast/Unload User Language Interface</var>. | ||
The <var class="product">Fast/Unload User Language Interface</var> also | The <var class="product">Fast/Unload User Language Interface</var> also | ||
| Line 33: | Line 33: | ||
can also unload a group of files, although without access to group definitions in <var class="product">Model 204</var>. | can also unload a group of files, although without access to group definitions in <var class="product">Model 204</var>. | ||
The <var class="product">Fast/Unload</var> documentation has | The <var class="product">Fast/Unload</var> documentation has yet to be [[Migration of Sirius PDF manuals|converted]] to SirWiki; the [http://www.sirius-software.com/maint/download/funr.pdf manual] and [http://sirius-software.com/maint/download/funrel46.pdf most recent release notes] are still maintained in PDF format. | ||
However, there is a [[Fast/Unload active punch list|wishlist]] for <var class="product">Fast/Unload</var> in SirWiki. | However, there is a [[Fast/Unload active punch list|wishlist]] for <var class="product">Fast/Unload</var> in SirWiki. | ||
Revision as of 16:11, 25 June 2012
Fast/Unload is a utility whose primary function is to quickly unload data from a Model 204 data file to one or more sequential data sets.
The Fast/Unload utility consists of several functional units. One unit is a data extraction facility which reads data from a Model 204 data file. Another unit is a compiler which converts a special data language (FUEL) to machine language. The generated machine language actually performs the output function. A third unit is a reporting facility which provides a job log and reports any special conditions or errors that might have occurred during a run.
Fast/Unload can either be invoked directly as a standalone load module or from a User Language program. When invoked as a standalone load module, Fast/Unload enqueues the data file in share mode unless explicitly requested otherwise. If the enqueue fails, Fast/Unload terminates with an error condition code. It is thus the file manager's job to ensure that when Fast/Unload is run as a standalone load module, Model 204 does not have the file to be unloaded locked in exclusive mode.
The Fast/Unload User Language Interface, purchased as a separate Fast/Unload option, allows one to invoke Fast/Unload from User Language, using the FastUnload or FastUnloadTask functions of the Recordset class, or using the $FunLoad function. With this approach, an application builds a set of records to be unloaded, using standard User Language statements; for example, you can reduce unload time by restricting the set of records using indexed Model 204 fields. The Fast/Unload load module runs in a subtask (or PST under CMS) of Model 204. With the Fast/Unload User Language Interface, the processing can be performed either synchronously or asynchronously. A system manager can cancel or examine Fast/Unload requests, and each user can perform the same functions on asynchronous requests that he or she initiated. To explore the details, see the components of the Fast/Unload User Language Interface.
The Fast/Unload User Language Interface also provides the ability to unload data from a Model 204 group. The standalone Fast/Unload load module can also unload a group of files, although without access to group definitions in Model 204.
The Fast/Unload documentation has yet to be converted to SirWiki; the manual and most recent release notes are still maintained in PDF format. However, there is a wishlist for Fast/Unload in SirWiki.