What's new in IMS High Performance Unload

This topic summarizes the technical changes for this edition.

New and changed information is denoted either by a character in the left margin or by blue carets (Symbol that indicates the start of new or changed content) and (Symbol that indicates the end of new or changed content) at the beginning and end of the new or changed information. Editorial changes that have no technical significance are not noted.

Start of change

SC27-0936-09 (August 2020)

This edition covers the functional changes provided by the following APARs:

  • PI51721, PI59811, PI60116, PI73493, PI77214, PI83671, PI89050, PI91820, PH00816, and PH22529
The major changes are as follows:
PI51721
A new control statement, COMPAUTH, which specifies to call the segment compression exit in supervisor state, has been added. For more information, see COMPAUTH control statement.
PI60116
This APAR fixes DBRC database authorization issues of HSSR Engine.
PI73493
Support for IMS Version 15 Release 1 has been added.
PI77214
A new control statement, CABBASE, which specifies the basic size of I/O buffers that the CAB buffer handler allocates, has been added. For more information, see CABBASE control statement.
PI83671
This APAR enables IMS HP Unload to use database definitions in the IMS catalog instead of DBD libraries when IMS-managed ACBs is enabled. For more information, see Considerations for IMS-managed ACBs environment.
PI89050
A new control statement, ZIIPMODE, which specifies whether HSSR engine offloads eligible VSAM ESDS I/O workloads to zIIP processors, has been added. For more information, see ZIIPMODE control statement.
PI91820
This APAR adds support for the Language Environment® preinitialization service (CEEPIPI).
PH00816
This APAR enhances IMS HP Unload to support encrypted VSAM (ESDS) DBDS even when Media Manager is used.
PH22529
This APAR enhances IMS HP Unload to support IMS OSAM database enhancement.
End of change

SC27-0936-08 (March 2015)

This edition covers the functional changes provided by the following APARs:

  • PM65262, PM84374, PM88606, PM97558, PI10157, PI19021, and PI27636

The major changes are as follows:

APAR PM65262
This APAR enhances IMS High Performance Unload to support IMS catalogs. Information is added to Considerations for unloading an IMS catalog.
APAR PM97558
You can use the new control statement, SKIPAUTH, for the HSSR Engine. Use this control statement to bypass IMS DBRC database authorization for HALDB partitions. For more information, see SKIPAUTH control statement.
APAR PI10157
This APAR enhances IMS High Performance Unload to support unloading of databases when database versioning is enabled in the IMS system.
APAR PI27636
Support for IMS Version 14 Release 1 has been added.

SC27-0936-07

This edition covers the functional changes provided by the following APARs:

  • PK61726, PK77437, PK90234, PM12285, PM22119, PM48532, PM55775, and PM58705.

The major changes are as follows:

APAR PK74302
Support for IMS Version 11 has been added.
APAR PK90234
*CP format (the communication industry partitioned format) has been supported. This format is useful if the database is a HALDB with partitioned secondary index (PSINDEX) databases and if *CS format cannot be used due to the presence of the PSINDEX. For details, see *CP format.
APAR PM22119
Support for IMS Version 12 has been added.

SC27-0936-06

This edition covers the following improvements of IMS High Performance Unload for z/OS®, Version 1 Release 2:

  • Functional and performance improvements:
    • In the unload utilities (FABHURG1 and FABHFSU), the number of buffers that are automatically set for unload data set are increased. For details, see FABHURG1 JCL requirements and FABHFSU JCL requirements.
    • If the STEPLIB is APF-authorized, HSSR Engine uses the Media Manager to read VSAM ESDS database data sets. The use of Media Manager saves the use of CPU time.
  • Improvements in the usability and readability of the product information are made in Application programming interface for using HSSR Engine.

IMS High Performance Unload for z/OS, Version 1 Release 2 does not support IMS that are lower than Version 7. Therefore, the names of the IMS libraries that are referred to by the catalog procedure, provided by the product, are changed to those names of IMS Version 8 and higher.

This edition also includes documentation changes to support APARs PK38688, PK47931, and PK49836.

SC27-0936-05

This edition covers the functional changes that are provided by the following APARs:

  • PK11534, PK17804, PK24577, PK24974, PK28097, PK32595, and PK33118.

The major enhancements are as follows:

APAR PK11534
The CHECKREC control statement has been added to the FABHURG1 unload utility. For more information, CHECKREC control statement.
APAR PK28097
The SKIPVLC control statement has been added to HSSR Engine. For more information, see SKIPVLC control statement.
APAR PK32595
The Get Next call with two SSAs to retrieve the second-level-dependent segment has been supported in HP Unload API. For more information, see DL/I calls supported by each API set.
APAR PK33118
Support for IMS Version 10 has been added.
  • To use the parallel RECONs, you must specify the IMSPLEX= and the DBRCGRP= parameters in the JCL EXEC statement. For more information, see Preparing the basic JCL.
  • The FABHURG1 and FABHFSU unload utilities support the large format data set for unload data sets.

SC27-0936-04

This edition covers the functional enhancements provided by the following APARs:

  • PQ97692, PQ99842, PK01994, PK04911, PK06057, PK07881, PK07882, PK08900, and PK11209.
The major enhancements are as follows:
APAR PK01994
IBM®-provided exit routine FABHKEYX is available for the FABHURG1 unload utility. For more information, see Migration unload: Exit routine FABHKEYX for distributing unload records.
APAR PK04911
Get Next call with a qualified SSA on root segments is supported in HP Unload API. For more information, see DL/I calls supported by each API set.
APAR PK06057
Keywords, URG1BUFNO and FSUBUFNO, have been added to the default option table (FABHOPT). For more information, see Replacing the HSSR option table (FABHOPT).
APAR PK07882
Function to retrieve HDAM or HIDAM root segments in a secondary index sequence has been supported. For more information, see Considerations for using a secondary index.
APAR PK11209
JCL compatibility with IMS HD Reorganization Unload is supported. For more information, see IMS HD Reorganization Unload JCL for running FABHURG1.

SC27-0936-03

This edition covers the following functional enhancements to this product:

APAR PQ80191
This APAR enables the product to run under IMS Version 9 Release 1.
APAR PQ81675
This APAR adds the support for the DFSHALDB DD statement, which is used to select a single partition to be processed in the API function (DLI or DBB region) of IMS High Performance Unload. For details, see Consideration for HALDB single partition processing.
APAR PQ83387
This APAR adds support for HALDB partitions that are defined as HALDB Online Reorganization (OLR) capable. See the considerations described in Considerations for HALDB Online Reorganization capable partitions.
APAR PQ85786
This APAR adds the function to set buffer numbers for VSAM KSDS automatically.
APAR PQ93668
This APAR adds the support for the IMSDALIB DD statement. IMS Parallel Reorganization for z/OS, Version 3 Release 1 requires IMS High Performance Unload that has this APAR applied.
This edition also includes the changes added by the following APARs:
  • PQ69413, PQ70680, PQ70768, PQ72433, PQ76387, PQ77099, and PQ79194.

SC27-0936-01 and SC27-0936-02

APAR PQ48541
This APAR adds the description that the GOT control statement becomes valid if DBRC is inactive in the FABHFSU unload utility.
APAR PQ49420
This APAR modifies IMS High Performance Unload so that using an uninitialized OSAM database as input causes an error. IMS High Performance Unload is modified so that, before getting access to a database, it checks the status of each data set in that database. If it finds an uninitialized data set, it causes an abend U4013. For High Availability Large Database (HALDB), the first time IMS High Performance Unload gets access to a partition, it checks the status of the data sets in that partition. If it finds an uninitialized data set, it causes an abend U4013.
APAR PQ55674
This APAR adds a control statement, PARTEXTR, to the HSSREXTR DD for the FABHEXTR exit routine of the FABHURG1 unload utility. The PARTEXTR control statement specifies how many database records are to be extracted from each HALDB partition.
APAR PQ57815
This APAR modifies IMS High Performance Unload so that Segment Edit/Compression routines are loaded and deleted by the IMS IMODULE service. The APAR also adds message FABH0853E.
APAR PQ57581
This APAR enables IMS High Performance Unload to run under IMS Version 8.
APAR PQ59358
This DOC APAR is devoted to explanations for three messages:
  • The explanation for message FABH0431W is expanded to cover all the conditions in which that message is issued.
  • Explanations of messages FABH0092W and FABH0358W, which had been missing, are added.
APAR PQ59762
This DOC APAR adds a description of the conditions in which the header record flag introduced by APAR PQ22654 for HSSR V2R3 causes an incompatibility. If an unloaded data set has been created by specifying the DECN control statement for a database that contains a compressed segment, that data set is not compatible with an unloaded data set created by the IMS HD Reorganization Unload utility.
APAR PQ62843
This APAR adds support for the Return Code Edit exit. This APAR provides a new exit for the HSSR Engine of IMS High Performance Unload. This exit, called the Return Code Edit exit (FABHRCEX), can be used to modify the return codes issued by HSSR application programs.
APAR PQ66914
This DOC APAR adds the formerly insufficient explanation of HALDB formats. The description is now as follows: A HALDB can be unloaded in *HD format by FABHURG1, or in UL format by FABHFSU. Whichever format the HALDB is in, both the IPR Reload utility of IMS Parallel Reorganization for z/OS, Version 2 Release 1 and IMS High Performance Load for OS/390®, Release 1 regard it internally, and therefore refer to it, as having PHD format.
APARs PQ67004, PQ67296, and PQ69199
These APARs add the following functions to the HSSR call:
  • The application programming interface for IMS High Performance Unload is extended to support GN and GNP calls with an unqualified SSA for a dependent segment type of an HD database.
  • The application programming interface for IMS High Performance Unload is extended to support EXEC DLI commands.

SC27-0936-00

This guide covers IMS High Performance Unload, which is a follow-on product to the IMS System Utilities/Data Base Tools (DBT) Version 2 High Speed Sequential Retrieval (DBT V2 HSSR). The compatibility with DBT V2 HSSR and other prior products is summarized in the following topics:

One of the major enhancements to IMS High Performance Unload is the addition of support for IMS Version 7 (IMS V7), specially High Availability Large Database (HALDB), introduced in IMS V7. See Methods for processing High Availability Large Databases.