IBM Support

Updates to IMS High Performance Load V2.1 User's Guide

Release Notes


Abstract

Updates that apply to IMS High Performance Load V2.1 User's Guide (SC18-9222-08)

Content

The most recent updates appear at the top of the list.

Update 1

Date of change: June 2020

Change description: Documentation changes for APAR PH22458. This APAR enhances IMS High Performance Load to support IMS OSAM database enhancement.

Topics: Changes apply to multiple topics.

==========

Topic: Reloading IMS database with IMS High Performance Load > Restrictions

This topic has been updated as follows:

IMS HP Load performs the same functions as the IMS HD Reorganization Reload utility, with certain restrictions.

The following restrictions apply to the IMS HP Load utility:

  • ...
  • ...
  • IMS catalog databases that are not registered to RECON cannot be encrypted during reload.

==========

Topic: Reloading IMS database with IMS High Performance Load > Control statements > DBIOBUF control statement

This topic has been updated as follows:

Specifies the number of tracks for the access method (VSAM or BDAM) buffers that are used for one database data set group when the database is read or written to.

IMS HP Load translates the specified number into the AMP= or DCB= (NCP=) parameter value internally. If the translated value exceeds the maximum allowable value for each access method, the translated value is overwritten. If you specify the AMP= or the DCB= (NCP=) parameter for the database DD statement, it precedes the DBIOBUF= specification.

This control statement is optional. If you do not specify this control statement, DBIOBUF=30 is used for VSAMA and OSAM LDS, and DBIOBUF=15 is used for OSAM. In the case of HIDAM, DBIOBUF=15 is used.

For OSAM LDS, DBIOBUF=15 is printed in the FRRIN Control Statements report even when DBIOBUF=30 is applied.

==========

Topic: Troubleshooting > Messages and codes > Messages > IMS HP Load messages

The following new messages have been added:

HPSR3680E OSAM IS DEFINED IN THE DBD BUT AN ESDS IS ALLOCATED AS A DATABASE DATA SET

Explanation: The access method is defined as OSAM in the DBD. However, IMS HP Load found an ESDS allocated for a database data set. To use ESDS, the access method must be VSAM.

System action: IMS HP Load issues a user 3672 abend and a dump.

User response: Update the access method defined in the DBD or change the allocation method for database data sets, and rerun the job.

---

HPSR3681E RDJFCB MACRO FAILED FOR DDNAME ddname (RC=xx)

Explanation: The RDJFCB macro failed with a return code xx for the data set that is specified for the DDNAME ddname.

System action: Process ends abnormally.

User response: Check the job log messages and other printed output for an indication that some system service has failed. If none can be found, it is likely that IMS High Performance Load has had an internal logic error. Contact IBM Software Support.

---

User response sections of the following messages have been updated:

HPSR3614E  I/O FAILURE OCCURRED DURING A VSAM SEQUENTIAL WRITE

Explanation: An error occurred attempting a VSAM sequential write.

System action: Module HPSRVSAM issues a user 3614 abend and a dump.

User response: Register 3 contains the RPL feedback code, and register 5 contains the RPL address. The second byte of register 3 contains the return code, and the fourth byte contains the reason code. The explanation of these codes is in the DFSMS/MVS Macro Instructions for Data Sets.

If you are reloading an HIDAM or a PHIDAM database, this message likely indicates that the size of the database data set exceeds 4 GB.

Correct the error and rerun the job.

---
HPSR3784E   VSAM EXTEND FAILURE OCCURRED IN HPIO

Explanation: An error occurred while extending the VSAM data set (EXTEND VSAM) with HPIO. This error could be the result from one of the following causes:

  • The new allocation amount exceeds the maximum RBA.
  • All space is used on the current volume and no more volumes are specified.

For more information, see the IEC message that is printed before this message.

System action: Module HPSRIOIN issues a user 0004 abend.

User response: If the new allocation amount exceeds the maximum RBA, decrease the total size of the database by one of the following methods:

  • Archive old data.
  • Use segment compression.
  • Divide the database data set into two or more data set groups.
  • Convert to OSAM or HALDB.

If you are reloading an HDAM or a PHDAM database, you can also decrease the total size of the database by one of the following methods:

  • Adjust the SEARCH control statement value to decrease the number of segments that will be directed to the overflow portion of the database.
  • Decrease the number of RAA blocks if there are many unused RAPs and the RAA has a high percentage of free space.

If you are reloading an HIDAM or a PHIDAM database, this message likely indicates that the size of the database data set exceeds 4 GB.

If necessary, contact IBM Software Support.

Publication Number

SC18-9222-08

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSV7D2","label":"IMS Tools"},"ARM Category":[],"Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"All Version(s)"},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSAVE5","label":"IMS High Performance Load for z\/OS"},"ARM Category":[{"code":"a8m0z000000cvYlAAI","label":"IMS High Performance Load"}],"Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"2.1.0"}]

Document Information

Modified date:
29 June 2020

UID

ibm16239250