Fast/Unload overview: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (→‎Fast/Unload HPO: link repair)
m (minor formatting)
Line 1: Line 1:
<!-- Page name: Fast/Unload overview-->
<p></p>
<var class="product">Fast/Unload</var> is a utility which quickly unloads
<var class="product">Fast/Unload</var> is a utility which quickly unloads
data from a <var class="product">Model 204</var> file to one or more sequential data sets.
data from a <var class="product">Model 204</var> file to one or more sequential data sets.
<var class="product">Fast/Unload</var> consists of several functional units:
<var class="product">Fast/Unload</var> consists of several functional units:
<ul>
<ul>
<li>A data extraction facility which reads data from a <var class="product">Model 204</var>
<li>A data extraction facility that reads data from a <var class="product">Model 204</var> file. </li>
file. </li>


<li>A compiler which converts a special data language ([[FUEL]]) to machine language.
<li>A compiler that converts a special data language ([[FUEL]]) to machine language.
The generated machine language performs the output function and other general-purpose manipulation.</li>
The generated machine language performs the output function and other general-purpose manipulation.</li>


<li>A reporting facility which provides a job log, job statistics, file statistics, and field statistics, and reports
<li>A reporting facility ([[Fast/Unload Extraction Language (FUEL)#fst|FSTATS]]) that provides a job log, job statistics, file statistics, and field statistics, and reports
any special conditions or errors that might have occurred during
any special conditions or errors that might have occurred during
a run.</li>
a run.</li>
Line 41: Line 38:
{{Template: Fast/Unload topic list}}
{{Template: Fast/Unload topic list}}


<div id="fusi"></div>
==<b id="fusi"></b>Fast/Unload SOUL Interface==
 
==Fast/Unload SOUL Interface==
<!--Caution: <div> above-->
 
The <var class="product">[[Fast/Unload SOUL Interface]]</var> (FUSI), purchased as a separate <var class="product">Fast/Unload</var> option,
The <var class="product">[[Fast/Unload SOUL Interface]]</var> (FUSI), purchased as a separate <var class="product">Fast/Unload</var> option,
allows one to invoke <var class="product">Fast/Unload</var> using the <var>[[FastUnload (Recordset function)|FastUnload]]</var> or <var>[[FastUnloadTask (Recordset function)|FastUnloadTask]]</var> method
allows one to invoke <var class="product">Fast/Unload</var> using the <var>[[FastUnload (Recordset function)|FastUnload]]</var> or <var>[[FastUnloadTask (Recordset function)|FastUnloadTask]]</var> method

Revision as of 22:58, 4 August 2016

Fast/Unload is a utility which quickly unloads data from a Model 204 file to one or more sequential data sets. Fast/Unload consists of several functional units:

  • A data extraction facility that reads data from a Model 204 file.
  • A compiler that converts a special data language (FUEL) to machine language. The generated machine language performs the output function and other general-purpose manipulation.
  • A reporting facility (FSTATS) that provides a job log, job statistics, file statistics, and field statistics, 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 SOUL 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, the Fast/Unload terminates with an error condition code. Therefore, you must ensure that when Fast/Unload is run as a standalone load module, Model 204 does not have the file enqueued in exclusive mode.

Note: As of version 4.6, Fast/Unload must be running under z/OS or z/VM CMS. As of version 4.7, Fast/Unload supports EAV (Extended Attribute Volume) disks for Model 204 files and supports FILEORG X'200' files.

Fast/Unload topics

The Fast/Unload documentation consists of the pages listed below. This list is also available as a "See also" link from each of the pages.

See the release notes for information about product changes and Model 204 feature support per Fast/Unload version.

Fast/Unload topic list

Fast/Unload SOUL Interface

The Fast/Unload SOUL Interface (FUSI), purchased as a separate Fast/Unload option, allows one to invoke Fast/Unload using the FastUnload or FastUnloadTask method of the Recordset class, or using the $Funload function in a SOUL program.

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. Since the unload is from a Model 204 record set, the Fast/Unload SOUL Interface automatically provides the ability to unload data from a Model 204 group; standalone Fast/Unload provides that functionality by allowing multiple Model 204 file names on the OPEN statement.

The Fast/Unload SOUL Interface processing can be synchronous or asynchronous.

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.

Fast/Unload HPO

Fast/Unload HPO is Model 204 HPO (offloading Model 204 work to zIIP processors) extended to Fast/Unload.

Fast/Unload support for this specialty-engine processing is initially available in version 7.6 of Model 204 but only for FUSI users. This processing is available also to Fast/Unload (PGM=FUNLOAD) as of version 7.7 of Model 204.

Exploiting zIIPs in Fast/Unload requires:

  1. z/OS, which is where the zIIP-accessing SRBs reside.
  2. Customer authorization for the Fast/Unload HPO product, a Fast/Unload option.
  3. Customer authorization for the Model 204 HPO product.
  4. Appropriate setting of zIIP and Fast/Unload Model 204 system parameters.
    • If Fast/Unload is invoked from FUSI, several Model 204 parameters are of concern.
    • Otherwise (that is, PGM=FUNLOAD), new Fast/Unload parameters (non-FUSI-specifiable) are likely necessary.

Even if Model 204 HPO is not purchased or in use, Fast/Unload HPO offers improved performance because it locates the Fast/Unload control blocks above the bar, taking advantage of the enhanced Model 204 V7.6 64-bit addressing and ATB storage.