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

Latest revision as of 23:04, 13 February 2017

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 are also available.

Introduction

This page describes the enhancements and other changes contained in the newest release of Fast/Unload, version 4.7. 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

The SMF record format information in Fast/Unload 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) that is 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 V7.5 or greater, and so the LAI also requires a version of the Sirius Mods that supports Model 204 V7.5 or greater.

@@ 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. [[Release notes for Fast/Unload V4.6]] are also available.
+__TOC__
+<!-- formerly pointed to: Template:Content_index:_Fast/Unload_V4.7_release_notes -->
+==Introduction==
+This page describes the enhancements and other changes contained in the newest
+release of <var class="product">Fast/Unload</var>, version 4.7. The previous
+generally released version of <var class="product">Fast/Unload</var>, 4.6, was released in July, 2012.
+===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/VM CMS.
+==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>[[DEFINE FIELD command#Ordered index CHUNK attribute|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===
+This version of <var class="product">Fast/Unload</var> supports the X'02', X'04', and X'08' bits for the <var>[[FUNPARM parameter|FUNPARM]]</var>
+and <var>[[FUNPRMU parameter|FUNPRMU]]</var> parameters of <var class="product">Model 204</var>.
+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
+have their intended effect if the version of <var class="product">Fast/Unload</var> 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 <var class="product">Fast/Unload</var> report (FUNPRINT), this statistic is available in the SMF record as:
+<p class="code">Offset  Length  Type           Description
+&#45;-----  ------  -------------  ----------------------------------
+     4       Signed Binary  Storage used for occurrence pointer arrays
+</p>
+====Documentation fix====
+The SMF record format information in [[Fast/Unload SMF record format]] is corrected:
+<ul>
+<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 manual.
+<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>
+</ul>
+==Maintenance and Support==
+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.
+===2.1 Improved messages===
+The following <var class="product">Fast/Unload</var> messages have been improved:
+<ul>
+<li>Improved message for incompatible file
+<p>
+Error message <code>FUNL0019</code> now indentifies the file parameter (<var>FITRANS</var>, <var>FICREATE</var>, or <var>FIFORMAT</var>) that is not supported by the current
+version of Fast/Unload. </p></li>
+<li>Improved message for GETMAIN errors
+<p>
+Error message <code>FUNL0003</code> now displays the name of the storage area for
+which a <var>GETMAIN</var> failed. </p></li>
+</ul>
 ==Compatibility, fixes, and co-requisites==
+This section describes any compatibility issues with prior versions of <var class="product">Fast/Unload</var> and any
+bugs that have been fixed in this version of <var class="product">Fast/Unload</var> 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).
+<p class="note"><b>There are no backwards incompatibilities in version 4.7.</b>
+The results of successful processing with <var class="product">Fast/Unload</var> version 4.6 are identical, when compared with the
+same inputs to <var class="product">Fast/Unload</var> version 4.7.
+</p>
+===Fixes in Fast/Unload 4.7 not propagated to 4.6===
+This section describes fixes to functionality existing in <var class="product">Fast/Unload</var> 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.
+<p class="note"><b>There are no fixes in Fast/Unload 4.7 that are not available in previous versions.</b>
+</p>
 ===Fast/Unload 4.7 version corequisites===
@@ Line 14: / Line 106: @@
 <dd>If a <var>UAI</var> operation is performed on a <var>[[FILEORG parameter|FILEORG]]</var> X'100' file, the <var>LAI</var> requires at least
 version 7.7 of the <var class="product">Sirius Mods</var>. In general, however, if such a file contains <var>FILEORG</var> X'100'
-features, especially fieldgroups, the <var>LAI</var> must be done with <var class="product">Model 204</var> V7R2 or greater,
+features, especially fieldgroups, the <var>LAI</var> must be done with <var class="product">Model 204</var> V7.5 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> V7R2 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> V7.5 or greater.
 </dl>
-{{Template:Content index: Fast/Unload V4.7 release notes}}
+[[Category:Fast/Unload]]
-[[Category:Fast/Unload release notes|Fast/Unload V4.7]]
 [[Category:Release notes|Fast/Unload V4.7]]