Release notes for Fast/Unload V4.7: Difference between revisions
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, | 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. | ||
The previous version of <var class="product">Fast/Unload</var>, 4.6, became available in July, 2012. [ | 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 | 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 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 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 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==== | ||
The SMF record format information in [[Fast/Unload SMF record format]] is corrected: | |||
<ul> | <ul> | ||
<li> | <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 | <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>) | 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> | 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> | 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 | |||
[[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
FUNL0019now 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
FUNL0003now 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.