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

From m204wiki
Jump to navigation Jump to search
No edit summary
 
(12 intermediate revisions by one other user not shown)
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__
__TOC__
Line 10: Line 9:
==Introduction==
==Introduction==
This page describes the enhancements and other changes contained in the newest
This page describes the enhancements and other changes contained in the newest
release of <var class="product">Fast/Unload</var>, version 4.7, which is still under development. The previous
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.
generally released version of <var class="product">Fast/Unload</var>, 4.6, was released in July, 2012.


===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>[[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===
===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:
The SMF record format information in [[Fast/Unload 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 58: Line 64:
<li>Improved message for incompatible file
<li>Improved message for incompatible file
<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>) that is 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 101: 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
<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'
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> V7R5 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> 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> V7.5 or greater.
</dl>
</dl>


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

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.