What's new in IMS Index Builder

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

SC18-9101-07 (July 2018)

This edition covers the following functional enhancements provided by APARs PI59810, PI61398, PI65714, PI72375, PI73092, PI83668, PI77681, PI88851, and PI92715.

  • Support for IMS™ Version 15.
  • New control statement, PROGMON, to specify the interval for issuing load progress messages. For more information, see PROGMON control statement.
  • Enhancement to support the PARTNAME control statement when building PSINDEX databases. For more information, see PARTNAME control statement.
  • Support for update mode, to update only the existing records in PSINDEX databases. For more information, see PROC control statement.
  • Enhancement to support retrieving DBDs from the IMS catalog directory data sets instead of DBD libraries. For more information, see Using the IMS catalog.
  • New control statement, ZIIPMODE, to offload eligible workloads to zIIP processors. For more information, see ZIIPMODE control statement.
  • Restrictions for using IMS exit routines documented in IMS Index Builder restrictions.
End of change

SC18-9101-06 (March 2016)

This edition covers the following functional enhancements provided by APARs PI27638, PI28218, PI32727, PI48799, PI51722, PI56192, and PI58843.

  • Support for IMS Version 14.
  • Support for HALDB 8 GB OSAM data sets.
  • New control statement, COMPAUTH. See COMPAUTH control statement.
  • Security improvement. All the libraries concatenated to the STEPLIB and JOBLIB must be APF-authorized without exception. The DFSRESLB DD statement is no longer needed in IMS Index Builder JCL.

SC18-9101-05

This edition covers the following functional enhancements provided by APARs PM74179, PM75258, PM76131, PM78145, PM86783, PM89774, PM92801, PM94114, PM97423, PI05347, PI06319, PI10953, PI15217, PI18256, PI21471, and PI24092.

SC18-9101-04

This edition covers the following functional enhancements provided by APARs PM46849, PM46957, PM49620, PM49636, PM53350, PM56986, PM60941, PM64823, PM66456, and PM68881.
  • Supports parallel sorting of PSINDEXes. You can sort the partitions in parallel to improve the performance of building PSINDEXes. For more information, see MAXTASKS control statement.
  • New reason codes (901, 902, and 903) and an error message (IIUB080E) have been added to alert when block size is zero.
  • ILDS control statement, which specifies to initialize Indirect List Data Sets (ILDSs) without loading ILE records, has been added. For more information, see ILDS control statement.
  • A new message (IIUB081I) to alert when the processed HALDB has logical relationships and ILE records need attention.
  • WFP output files of IMS High Performance Load can be used as input for building PSINDEXes. For more information, see Building partitioned secondary indexes using HPSRWFP as input.
  • Configuration steps for enabling the DBRC command authorization have been added. For more information, see Configuring for DBRC command authorization.
  • Indexes and indirect list data sets (ILDS) for IMS catalog databases can be built. For more information, see Building indexes and ILDSs for IMS catalog databases.

SC18-9101-03

This edition covers the following functional enhancements provided by APARs PM17738, PM17740, PM19218, PM21662, PM22120, PM23259, PM23498, PM26050, PM27122, PM30368, PM31946, PM34562, PM37055, PM37987, and PM42233:
  • Support for IMS Version 12.
  • The CLASS control statement specifies the high-level qualifier of stripe data sets. For more information, see CLASS control statement.
  • The ITKBLOAD control statement specifies the name of the load module library for IMS Tools Knowledge Base. For more information, see ITKBLOAD control statement.
  • The DBAUTH control statement specifies whether IMS Index Builder issues the IMS DBRC authorization request for the prime database and the indexes to prevent transactions and programs from updating the database. The IMS DBRC authorization request can be issued in IMS Version 10 or later. For more information, see DBAUTH control statement.
  • The SVCDUMP control statement specifies whether IMS Index Builder requests an SVC dump file after a system abend or a user abend. For more information, see SVCDUMP control statement.
  • The IIURDFLT MAXTASKS entry of the runtime option module (IIURPRMS) customizes the IMS Index Builder run. For more information, see IIURDFLT MAXTASKS entry.
  • The IIUB062I message is added to indicate a dynamic allocation failure of a stripe data set and its cause.
This edition also contains the following documentation changes:

SC18-9101-02

This edition covers the following functional enhancements provided by APARs PK84777, PK89282, PK90640, PK98192, PK98315, PM01160, PM01565, PM04676, PM04978, PM05407, PM06592, PM10758, PM12486, and PM13947:
  • Description about the sequential scan technology that was introduced in IMS Index Builder Version 3.1 and the instruction to change the scan methods are added. For more information, see Selecting the scan method.
  • The SIDXBUF control statement enables you to specify the number of buffers that are to be used in the load process for each secondary index. For more information, see SIDXBUF control statement.
  • The TMRWAIT control statement enables you to specify the IIUTMRXT timeout value. For more information, see TMRWAIT control statement.
  • The VIC control statement specifies whether IMS Index Builder issues the DBRC NOTIFY.UIC command to turn off the IC NEEDED flag. For more information, see VIC control statement.
  • A sample JCL is provided to replace the runtime option module (IIURPRMS). Also, several entries are added to the IIURPRMS module table. For more information, see Defining runtime parameters.
  • The verification function of IMS Index Builder verifies that the number of records that were loaded to each index matches the number of the scanned occurrences of the prime database. For more information, see IMS Index Builder verification phase failure reason codes.
  • Diagnostics Aid is supported for diagnosing and reporting IMS Index Builder problems. For more information about using the Diagnostics Aid, see Diagnostics Aid.

SC18-9101-01

Instruction to migrate from IMS Index Builder Version 2.3 to Version 3.1 is added. See Migrating from IMS Index Builder Version 2.3 to Version 3.1.

This edition covers the following functional enhancements provided by APARs PK72674, PK73170, PK73601, PK73802, PK82341, and PK84520:
  • Support for IMS Version 11.
  • The SORTFSZ control statement is used to support heavy sort loads, which is different from IMS Index Builder Version 2.3. For more information, see IMS Index Builder input control statements.
  • SORTFSZ triggers striped sort mode.
  • Run time optimized code (race code) is applied by default in IMS Index Builder encoding routines.
  • A standard, single subordinate address space procedure, started task is invoked by job name.
  • Runtime parameters have changed. For more information, see Defining runtime parameters.
  • The number of STCs can be controlled with the MAXTASKS control statement.
  • Stripe data sets have been introduced to enhance communications with subordinate address space. Stripes are internal work files with specific HLQ.
  • Index records with duplicate keys are stored in stripes with LLQ "DUPLKEYS." Duplicate keys stripes are not deleted at termination.
  • IMS Index Builder does not shadow the index data sets, so the CATLG statement is obsolete. However, in the DDEFPDS functionality, user catalogs are required to be supported by DD statements.

SC18-9101-00

  • Support for enabling the IMS Tools Knowledge Base has been added. The IMS Tools Knowledge Base is a central repository for automatically collecting output reports that are generated. For more information, see IMS tools product integration and the ITKBSRVR statement definition in IMS Index Builder input control statements.
  • This release supports routing WTOs and messages from the subordinate address space to the master address space. For more information, see the IIUCAPT DD statement definition in IMS Index Builder JCL.
  • The IMS Index Builder load library is no longer needed in the IMS concatenation. For more information, see the STEPLIB DD statement definition in IMS Index Builder JCL.
  • Allocation contention problems have been resolved in this release. The ALTER statement is no longer needed.
  • Support for indirect list data sets (ILDS) is provided in this release with the BLD_ILDS keyword. For more information, see the PROC statement definition in IMS Index Builder input control statements.
  • Support for rebuilding selected PSINDEX partitions has been added. For more information, see the INDEX statement definition in IMS Index Builder input control statements.
  • The scope of sequential scan has been extended to allow for rebuilding of ILDS, primary indexes, and some secondary indexes. For more information, see Defining the subordinate address space procedure.
  • The RACF profile is now passed from the master address space to the subordinate address space. For more information, see Defining the subordinate address space procedure.
  • IMS Index Builder will correctly process indexes with non-unique keys.
  • This release of IMS Index Builder can process an unlimited number of PSINDEX partitions.
  • The following DD statement is no longer supported:
    • SYSPRINT DD
  • The following control statements are no longer supported. If they are used, warning messages are issued that the statement is no longer supported, and IMS Index Builder continues processing.
    • ALTER
    • CATLG
    • EXEC
    • NDXIOUBF
    • SORTE15
    • SORTE35
    • SORTID
    • SORTOUT
    • SORTSTAT
  • IDCAMS processing of the data sets is completed in the initialization and registration phases, before building the processing structures. IIUB053E is introduced to denote IDCAMS processing failure in the data set description block. IIUB100E reason 109 at initialization phase ends if IDCAMS failures have been encountered. In the registration phase, IIUB029E is used.
  • DEL/DEF support is integrated to data set IDCAMS processing. See the DDEFPDS DD statement.
  • Data set initializations are processed entirely during the initialization phase.
  • The index load report has been enhanced. Separate report blocks are provided at data set/partition level, and a summary block is introduced at secondary index/PSINDEX level. The rejected records are reported in the summary block, and for PSINDEXes, the sum of the partition records is provided.
  • IMS Index Builder will always use DBRC for HALDB databases. If the INPUT control statement specified DBRC=N, no notification is issued, regardless of the database type. In prior IMS Index Builder versions, notifications were always issued for HALDB databases.
  • BLD_SECONDARY specifies that secondary index databases must be built. If the prime database does not have secondary indexes, an error is indicated, and IMS Index Builder stops at the initialization phase. In prior IMS Index Builder versions, an error was not indicated.
Parent topic: IMS Index Builder overview