PQ83994: REORG OF PHDAM DB DOES NOT USE AND NAME-SWAP SHADOW ILDS WHEN NO SECONDARY INDEXES EXIST AND NO RECORD IS WRITTEN.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Reorg of PHDAM DB does not use and name-swap shadow ILDS when
  no secondary indexes exist and no record is written.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IPR Driver of IMS Parallel      *
  *                 Reorganization for z/OS Version 2 Release 1  *
  *                 (FMID=H25N210).                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: IPR Driver does not use the shadow ILDS *
  *                      of a PHDAM partition even if an ILDS    *
  *                      exists. The message "*** OUTPUT ILDS IS *
  *                      NOT USED ***" is printed on the ILDS    *
  *                      row in the Data Set Information report. *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  IPR Driver does not use the shadow ILDS of a PHDAM partition
  even if an ILDS exists. The message "*** OUTPUT ILDS IS NOT
  USED ***" is printed on the ILDS row in the Data Set Information
  report.
  

Problem conclusion

• IPR Driver has been modified so that it will always initialize
  the shadow ILDS and, if NAMESWAP=YES, does name swapping
  between the original ILDS and the shadow ILDS if one of the
  following conditions is satisfied and ILDSBLD=YES is specified:
  1. The shadow ILDS of all partitions that are to be reorganized
     are specified in the JCL stream.
  2. Dynamic allocation of shadow data sets is designated and all
     shadow ILDS exist.
  *
  In order for the above function to work, it is required to
  apply to IMS High Performance Load the PTF that is provided by
  APAR PQ83995.
  *
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS Parallel Reorganization for z/OS Version 2 Release 1 User's
  Guide (Document Number: SC27-1180-02) should be modified as
  follows.
    * * *    * * *    * * *    * * *    * * *    * * *    * * *
   Appendix E. Messages and Codes
    E.3 Messages
     E.3.4 HPSG Messages
      <<< The following messages are added. >>>
  |
  | HPSG0109E CATALOG SEARCH ERROR: RC=rc  MID=xx RSN=yy RETCD=zz
  |
  | Explanation: A call to DFSMS Catalog Search Interface
  | (IGGCSI00) got a non-zero return code.  rc indicates a return
  | code of IGGCSI00.  When the return code is either 4 or 8,
  | MID=xx, RSN=yy, and RETCD=zz are included in the message,
  | which are the value contained in the reason area of an
  | IGGCSI00 call. Here, xx is the Module ID in character format,
  | yy is the hexadecimal reason code, and zz is the hexadecimal
  | return code. For details of these codes, refer to "z/OS DFSMS
  | Managing Catalogs."
  |
  | System Action: IPR Driver ends with a return code of 8.
  |
  | Programmer Response: Refer to z/OS DFSMS Managing Catalogs
  | for the meaning of the return code and reason area codes.
  | If the problem cannot be resolved, call IBM Support Center.
  |
  |
  | HPSG0388E SHADOW ILDS OF ONE OR MORE PARTITIONS NOT SPECIFIED
  |           OR NOT EXIST
  |
  | Explanation: This message is issued in either one of the
  | following cases:
  |   1. Shadow ILDS of one or more partitions are not specified
  |      in the JCL stream
  |   2. Shadow ILDS of one or more partitions do not exist.
  |
  | System Action: IPR Driver end a return code of 8.
  |
  | Programmer Response: Create shadow ILDS for each partition
  | to be reorganized. If the dynamic allocation of the shadow
  | data sets is not requested, you must code the DD statement
  | for shadow ILDS for each partition. If you do not need to
  | create a shadow ILDS because no ILE record is written for
  | the database, code ILDSBLD=NO control statement or delete
  | all shadow ILDS that exist.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Modules/Macros

• HPSGGHPT HPSGGRGB HPSGGSTB HPSGICS  HPSGICSD
  HPSGICS0 HPSGLINK HPSGMAIN HPSGMSGT HPSGRA00 HPSGRA10 HPSGRR00
  HPSGRS00 HPSGRS10 HPSGTM00 H25N210J
  

Fix information

• Fixed component name

  IMS PARALLEL RE

• Fixed component ID

  5655F7400

Applicable component levels

• R210 PSY UQ85579

     UP04/03/02 P F403

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.