A fix is available
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 number
PQ83994
Reported component name
IMS PARALLEL RE
Reported component ID
5655F7400
Reported release
210
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2004-01-30
Closed date
2004-02-26
Last modified date
2004-04-03
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
SC27118002 |
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.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSVL5Q","label":"IMS Database Reorganization Expert for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"210","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
06 January 2023