Release notes for Fast/Unload V4.7: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (add new features and GA date)
Line 1: Line 1:
These release notes list the enhancements and other changes contained in <var class="product">Fast/Unload</var> version 4.7, <b><i>which is still in development</i></b>. Until the the commercial release of the software, Sirius reserves the
These release notes list the enhancements and other changes contained in <var class="product">Fast/Unload</var> version 4.7, available as of December 10, 2014.  
right to remove or change anything described herein.  


The previous version of <var class="product">Fast/Unload</var>, 4.6, became available in July, 2012. [http://sirius-software.com/maint/download/funrel46.pdf Release notes for Fast/Unload V4.6 (PDF)] are also available.
The previous version of <var class="product">Fast/Unload</var>, 4.6, became available in July, 2012. [http://sirius-software.com/maint/download/funrel46.pdf Release notes for Fast/Unload V4.6 (PDF)] are also available.
Line 14: Line 13:


===z/OS or z/CMS required===
===z/OS or z/CMS required===
Starting with version 4.6, <var class="product">Fast/Unload</var> must be running under z/OS or z/CMS.
Starting with version 4.6, <var class="product">Fast/Unload</var> must be running under z/OS or z/VM CMS.


==New features==
==New features==
===EAV support===                                                                                     
This version of <var class="product">Fast/Unload</var> introduces support for EAV (Extended Attribute Volume) disks for <var class="product">Model&nbsp;204</var> files. 
===CHUNK fields===                                                                                     
This version of <var class="product">Fast/Unload</var> provides support for <var>CHUNK</var> fields, introduced in version 7.5 of <var class="product">Model&nbsp;204</var>.
===FILEORG X'200' (files with 48M records)===                                                       
This version of <var class="product">Fast/Unload</var> provides support for the <var>[[FILEORG parameter|FILEORG]]</var> X'200' bit, introduced in version 7.5 of <var class="product">Model&nbsp;204</var>. 
This feature allows a file to contain up to "48M" (that is, 50,331,648) records.                 


===Fast/Unload User Language Interface changes===
===Fast/Unload User Language Interface changes===
Line 24: Line 33:
These parameters control the <var class="product">Model 204</var> auditing of <var class="product">Fast/Unload</var> messages, and were
These parameters control the <var class="product">Model 204</var> auditing of <var class="product">Fast/Unload</var> messages, and were
introduced in version 8.1 of the <var class="product">Sirius Mods</var>. If they are specified in <var class="product">Model 204</var>, they only
introduced in version 8.1 of the <var class="product">Sirius Mods</var>. If they are specified in <var class="product">Model 204</var>, they only
have their intended effect if the version of <var class="product">Fast/Unload</var> is 4.7 or later. Otherwise, they
have their intended effect if the version of <var class="product">Fast/Unload</var> is 4.7 or later. Otherwise, they are effectively ignored.
are effectively ignored.


===Statistics improvements===
===Statistics improvements===
Line 39: Line 47:


====Documentation fix====
====Documentation fix====
In the November, 2013 PDF version of the <var class="book">Fast/Unload Reference Manual</var>, Appendix F, "SMF record format," now correctly:
In the <var class="book">[http://m204wiki.rocketsoftware.com/images/e/e2/FunrNew.pdf Fast/Unload Reference Manual]</var> PDF, Appendix F, "SMF record format," is corrected:
<ul>
<ul>
<li>Lists offset 047 as a 5-byte reserved area instead of a 3-byte reserved area. The offsets of all
<li>It now lists offset 047 as a 5-byte reserved area instead of a 3-byte reserved area. The offsets of all
statistics following offset 047 are now correctly 2 greater (hence divisible by 4) than the offsets shown in previous versions of the
statistics following offset 047 are now correctly 2 greater (hence divisible by 4) than the offsets shown in previous versions of the
manual.
manual.


<li><var class="product">Fast/Unload</var> version 4.3 introduced the following statistic:
<li>It now includes this statistic, introduced in <var class="product">Fast/Unload</var> version 4.3:
<p class="code">128 4 Signed Binary Number of longstring items acquired</p>
<p class="code">128 4 Signed Binary Number of longstring items acquired</p>
</ul>
</ul>


==Maintenance and Support==
==Maintenance and Support==
These enhancements to <var class="product">Fast/Unload</var> do not affect its intrinsic functionality, but rather
These enhancements to <var class="product">Fast/Unload</var> do not affect its intrinsic functionality, but rather affect the way maintenance and support for the product are delivered.
affect the way maintenance and support for the product are delivered.


===2.1 Improved messages===
===2.1 Improved messages===
Line 59: Line 66:
<p>
<p>
Error message <code>FUNL0019</code> now indentifies the file parameter (<var>FITRANS</var>, <var>FICREATE</var>, or <var>FIFORMAT</var>) thatis not supported by the current
Error message <code>FUNL0019</code> now indentifies the file parameter (<var>FITRANS</var>, <var>FICREATE</var>, or <var>FIFORMAT</var>) thatis not supported by the current
version of Fast/Unload. </p>
version of Fast/Unload. </p></li>


<li>Improved message for GETMAIN errors
<li>Improved message for GETMAIN errors
<p>
<p>
Error message <code>FUNL0003</code> now displays the name of the storage area for
Error message <code>FUNL0003</code> now displays the name of the storage area for
which a <var>GETMAIN</var> failed. </p>
which a <var>GETMAIN</var> failed. </p></li>
</ul>
</ul>
——————————————————————————————————————————


==Compatibility, fixes, and co-requisites==
==Compatibility, fixes, and co-requisites==
Line 104: Line 110:
and so the <var>LAI</var> also requires a version of the <var class="product">Sirius Mods</var> that supports <var class="product">Model 204</var> V7R5 or greater.
and so the <var>LAI</var> also requires a version of the <var class="product">Sirius Mods</var> that supports <var class="product">Model 204</var> V7R5 or greater.
</dl>
</dl>


[[Category:Fast/Unload release notes|Fast/Unload V4.7]]
[[Category:Fast/Unload release notes|Fast/Unload V4.7]]
[[Category:Release notes|Fast/Unload V4.7]]
[[Category:Release notes|Fast/Unload V4.7]]

Revision as of 17:39, 16 December 2014

These release notes list the enhancements and other changes contained in Fast/Unload version 4.7, available as of December 10, 2014.

The previous version of Fast/Unload, 4.6, became available in July, 2012. Release notes for Fast/Unload V4.6 (PDF) are also available.


Introduction

This page describes the enhancements and other changes contained in the newest release of Fast/Unload, version 4.7, which is still under development. The previous generally released version of Fast/Unload, 4.6, was released in July, 2012.

z/OS or z/CMS required

Starting with version 4.6, Fast/Unload must be running under z/OS or z/VM CMS.

New features

EAV support

This version of Fast/Unload introduces support for EAV (Extended Attribute Volume) disks for Model 204 files.

CHUNK fields

This version of Fast/Unload provides support for CHUNK fields, introduced in version 7.5 of Model 204.

FILEORG X'200' (files with 48M records)

This version of Fast/Unload provides support for the FILEORG X'200' bit, introduced in version 7.5 of Model 204. This feature allows a file to contain up to "48M" (that is, 50,331,648) records.

Fast/Unload User Language Interface changes

This version of Fast/Unload supports the X'02', X'04', and X'08' bits for the FUNPARM and FUNPRMU parameters of Model 204.

These parameters control the Model 204 auditing of Fast/Unload messages, and were introduced in version 8.1 of the Sirius Mods. If they are specified in Model 204, they only have their intended effect if the version of Fast/Unload is 4.7 or later. Otherwise, they are effectively ignored.

Statistics improvements

Storage for occurrence pointer arrays

An additional statistics line identifies storage usage for pointers to field and fieldgroup occurrences that are referenced in the FUEL program. In addition to being reported on the Fast/Unload report (FUNPRINT), this statistic is available in the SMF record as:

Offset Length Type Description ------ ------ ------------- ---------------------------------- 132 4 Signed Binary Storage used for occurrence pointer arrays

Documentation fix

In the Fast/Unload Reference Manual PDF, Appendix F, "SMF record format," is corrected:

  • It now lists offset 047 as a 5-byte reserved area instead of a 3-byte reserved area. The offsets of all statistics following offset 047 are now correctly 2 greater (hence divisible by 4) than the offsets shown in previous versions of the manual.
  • It now includes this statistic, introduced in Fast/Unload version 4.3:

    128 4 Signed Binary Number of longstring items acquired

Maintenance and Support

These enhancements to Fast/Unload do not affect its intrinsic functionality, but rather affect the way maintenance and support for the product are delivered.

2.1 Improved messages

The following Fast/Unload messages have been improved:

  • Improved message for incompatible file

    Error message FUNL0019 now indentifies the file parameter (FITRANS, FICREATE, or FIFORMAT) thatis not supported by the current version of Fast/Unload.

  • Improved message for GETMAIN errors

    Error message FUNL0003 now displays the name of the storage area for which a GETMAIN failed.

Compatibility, fixes, and co-requisites

This section describes any compatibility issues with prior versions of Fast/Unload and any bugs that have been fixed in this version of Fast/Unload but had not, as of the date of this release, been fixed in version 4.6 (all 4.6 fixes have also been fixed in version 4.6).

Backwards incompatibilities

In general, backward incompatibility means that an operation that was previously performed without any indication of error, now operates, given the same inputs and conditions, in a different manner. We may not list as backwards incompatibilities those cases in which the previous behavior, although not indicating an error, was "clearly and obviously" incorrect, and which are introduced as normal bug fixes (whether or not they had been fixed with previous maintenance).

There are no backwards incompatibilities in version 4.7. The results of successful processing with Fast/Unload version 4.6 are identical, when compared with the same inputs to Fast/Unload version 4.7.

Fixes in Fast/Unload 4.7 not propagated to 4.6

This section describes fixes to functionality existing in Fast/Unload version 4.6 but which, due to the absence of customer problems, have not, as of the date of the release, been applied to that version.

There are no fixes in Fast/Unload 4.7 that are not available in previous versions.

Fast/Unload 4.7 version corequisites

This section lists any restrictions on usage of various products (including Fast/Unload itself) which will be imposed by use of version 4.7 of Fast/Unload.

UAI on FILEORG X'100' file
If a UAI operation is performed on a FILEORG X'100' file, the LAI requires at least version 7.7 of the Sirius Mods. In general, however, if such a file contains FILEORG X'100' features, especially fieldgroups, the LAI must be done with Model 204 V7R5 or greater, and so the LAI also requires a version of the Sirius Mods that supports Model 204 V7R5 or greater.