What's new in IMS High Performance Unload

This topic summarizes the technical changes for this edition.

New and changed information is denoted by 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.

Revision markers follow these general conventions:

  • Only technical changes are marked; style and grammatical changes are not marked.
  • If part of an element, such as a paragraph, syntax diagram, list item, task step, or figure is changed, the entire element is marked with revision markers, even though only part of the element might have changed.
  • If a topic is changed by more than 50%, the entire topic is marked with revision markers (so it might seem to be a new topic, even though it is not).

Revision markers do not necessarily indicate all the changes made to the information because deleted text and graphics cannot be marked with revision markers.

Start of change

SC27-0936-11 (November 2023)

Description Related APARs
Fix for migration unload issue of a non-HALDB with a virtual logical child segment to a HALDB. For more information, see the following topics: PH57574
End of change

SC27-0936-10 (October 2022)

Description Related APARs
Modified messages FABH0646E and FABH0856E. N/A

SC27-0936-09 (August 2020)

Description Related APARs
Support for IMS OSAM database enhancement. PH22529
Support encrypted VSAM (ESDS) DBDS even when Media Manager is used. PH00816
Support for the Language Environment® preinitialization service (CEEPIPI). PI91820
A new control statement, ZIIPMODE, which specifies whether HSSR engine offloads eligible VSAM ESDS I/O workloads to zIIP processors. For more information, see ZIIPMODE control statement. PI89050
Enables 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. PI83671
A new control statement, CABBASE, which specifies the basic size of I/O buffers that the CAB buffer handler allocates. For more information, see CABBASE control statement. PI77214
Support for IMS 15.1. PI73493
Fix for DBRC database authorization issues of HSSR Engine. PI60116
A new control statement, COMPAUTH, which specifies to call the segment compression exit in supervisor state. For more information, see COMPAUTH control statement. PI51721
Other APAR related doc changes. PI59811

SC27-0936-08 (March 2015)

Description Related APARs
Support for IMS 14.1. PI27636
Support unloading of databases when database versioning is enabled in the IMS system. PI10157
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. PM97558
Support IMS catalogs. Information is added to Considerations for unloading an IMS catalog. PM65262
Other APAR related doc changes. PM84374, PM88606, PI19021

SC27-0936-07

Description Related APARs
Support for IMS 12.1 PM22119
*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. PK90234
Support for IMS 11.1. PK74302
Other APAR related doc changes. PK61726, PK77437, PK90234, PM12285, PM48532, PM55775, PM58705

SC27-0936-06

Description Related APARs
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.
N/A
Improvements in the usability and readability of the product information are made in Application programming interface for using HSSR Engine. N/A
IMS High Performance Unload for z/OS® 1.2 does not support IMS that are lower than 7.1. 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 8.1 and later. N/A
Other APAR related doc changes. PK38688, PK47931, PK49836

SC27-0936-05

Description Related APARs
Support for IMS 10.1:
  • 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.
PK33118
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. PK32595
The SKIPVLC control statement has been added to HSSR Engine. For more information, see SKIPVLC control statement. PK28097
The CHECKREC control statement has been added to the FABHURG1 unload utility. For more information, CHECKREC control statement. PK11534
Other APAR related doc changes. PK17804, PK24577, PK24974

SC27-0936-04

Description Related APARs
JCL compatibility with IMS HD Reorganization Unload is supported. For more information, see IMS HD Reorganization Unload JCL for running FABHURG1. PK11209
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. PK07882
Keywords, URG1BUFNO and FSUBUFNO, have been added to the default option table (FABHOPT). For more information, see Replacing the HSSR option table (FABHOPT). PK06057
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. PK04911
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. PK01994
Other APAR related doc changes. PQ97692, PQ99842, PK07881, PK08900

SC27-0936-03

Description Related APARs
Support for IMSDALIB DD statement. IMS Parallel Reorganization for z/OS 3.1 requires IMS High Performance Unload that has this APAR applied. PQ93668
Function to set buffer numbers for VSAM KSDS automatically. PQ85786
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. PQ83387
Support for 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. PQ81675
Enables the product to run under IMS 9.1. PQ80191
Other APAR related doc changes. PQ69413, PQ70680, PQ70768, PQ72433, PQ76387, PQ77099, PQ79194

SC27-0936-01 and SC27-0936-02

Description Related APARs
The following functions are added 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.
PQ67004, PQ67296, PQ69199
Complemented 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 2.1 and IMS High Performance Load for OS/390® 1.1 regard it internally, and therefore refer to it, as having PHD format. PQ66914
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. PQ62843
Added a description of the conditions in which the header record flag introduced by APAR PQ22654 for HSSR 2.3 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. PQ59762
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.
PQ59358
Enables IMS High Performance Unload to run under IMS8.1. PQ57581
IMS High Performance Unload is modified so that Segment Edit/Compression routines are loaded and deleted by the IMS IMODULE service. The APAR also adds message FABH0853E. PQ57815
New control statement, PARTEXTR, for 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. PQ55674
IMS High Performance Unload is modified 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. PQ49420
Added a description that the GOT control statement becomes valid if DBRC is inactive in the FABHFSU unload utility. PQ48541

SC27-0936-00

This documentation 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).

Description Related APARs
The compatibility with DBT V2 HSSR and other prior products is summarized in the following topics: N/A
One of the major enhancements to IMS High Performance Unload is the addition of support for IMS 7.1, specially High Availability Large Database (HALDB), introduced in IMS 7.1. See Methods for processing High Availability Large Databases. N/A