A fix is available
APAR status
Closed as new function.
Error description
Functional enhancement
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users IMS Parallel Reorganization * * for z/OS Version 3 Release 2 (FMID=H25N320) * **************************************************************** * PROBLEM DESCRIPTION: This APAR provides several functional * * enhancements: * * 1. IPR Unload utility supports IMS * * Tools Knowledge Base for z/OS. * * 2. IPR Reload utility and IPR Driver * * support new option for ILDSBLD * * statement. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR provides the following functional enhancements: 1. IPR Unload utility supports IMS Tools Knowledge Base for z/OS to store statistics reports in the Output repository. To use this new function, APAR PK57504 for IMS High Performance Unload for z/OS, Version 1 Release 2 (FMID=H1IN120) is required. For the details, see the description of APAR PK57504. 2. IPR Reload utility and IPR Driver support new option for ILDSBLD statement to rebuild ILDS with using less data space. To use this new option, APAR PK57506 for IMS High Performance Load for z/OS, Version 2 Release 1 (FMID=H1IM210) is required.
Problem conclusion
Temporary fix
Comments
======================== = Documentation Change = ======================== IBM IMS Parallel Reorganization for z/OS User's Guide (SC18-9228-03) should be changed as follows: ================================================================ 2.0 IMS Parallel Reorganization Driver 2.7 Control statements 2.7.2 Control statements for Reorganization Manager : Table 10. Control statements for Reorganization Manager +-----------+---------------+--------+-----------------------+ |Keyword |Acceptable |Default | Description | | | Values | | | +-----------+---------------+--------+-----------------------+ : : : : : +-----------+---------------+--------+-----------------------+ |ILDSBLD || YES |YES |Specifies whether to | | || YES,DSPR | |build ILDS during | | || NO | |reorganization. | | | | |See "ILDSBLD control | | | | |statement" in topic | | | | |2.7.8.15. | +-----------+---------------+--------+-----------------------+ ================================================================ 2.7.8 Description of control statements for Reorganization Manager 2.7.8.15 ILDSBLD control statement : ____________________________________________________________ | | | | _YES___________ | | | | |_,DSPR_| | | | | >>__ILDSBLD=__|_NO____________|_________________________>< | | | |____________________________________________________________| : | If you specify ILDSBLD=YES or ILDSBLD=YES,DSPR, ILDS for each HALDB partition that is reorganized is built in the shadow ILDS in the IPR Driver job step. : ================================================================ 2.8 Reports and statistics 2.8.1 HPSOUT data set 2.8.1.2 Default Option Tables report : Figure 14 is an example of the Default Option Tables report when HPSCOPTI was used. IMS PARALLEL REORG PAGE: 1 5655-M28 08/15/2007 17.24.31 "DEFAULT OPTION TABLES" SYSTEM DEFAULT: HPSCOPTS IN IPR310.SHPSLMD0 INSTALLATION DEFAULT: HPSCOPTI IN IPR310.SHPSLMD0 KEYWORD SYSTEM DEFAULT INSTALLATION DEFAULT ------------ -------------------- -------------------- DECODEDBD (NO,NO) (YES,NO) DECODESXD (NO,NO) (YES,NO) DISPOLDDS TEMPNAME NEWSHADOW HPIO N/A N/A | ILDSBLD YES NO | ITKBLOAD *NO *NO | ITKBSRVR *NO *NO SINDEXSUF NO NO : ================================================================ 4.0 The IPR Reload utility 4.6 JCL requirements : Table 33. DD statements and record format for the IPR Reload utility +-----------+---------------+------------+-------------------+ |DDNAME |Use |Format | Need | +-----------+---------------+------------+-------------------+ : : : : : +-----------+---------------+------------+-------------------+ |SORTWKnn |Input/Output | |Optional | +-----------+---------------+------------+-------------------+ || HPSRISMG || Output || LRECL=133 || Optional | +-----------+---------------+------------+-------------------+ : | HPSRISMG DD | This optional output data set contains the messages | produced by DFSORT. This data set is used only when | ILDSBLD=YES,DSPR is specified. If the DD statement is | omitted, the data set is allocated dynamically. : ================================================================ 4.7 Control statements 4.7.2 Overview of IPR Reload control statements : Table 37. IPR Reload control statements for a partitioned database +-----------+---------------+--------+-----------------------+ |Keyword |Accepted |Default | Description | | | Values | | | +-----------+---------------+--------+-----------------------+ : : : : : +-----------+---------------+--------+-----------------------+ |ILDSBLD || C |C |Specifies whether to | | || YES | |build ILDS and how to | | || YES,DSPR | |do it during | | || NO | |reorganization. | | | | |See "ILDSBLD control | | | | |statement" in topic | | | | |4.7.15. | +-----------+---------------+--------+-----------------------+ : ================================================================ 4.7.15 ILDSBLD control statement : ___________________________________________________________ | | | | _C_____________ | | | >>__ILDSBLD=__|_YES___________|________________________>< | | | | |_,DSPR_| | | | | |_NO____________| | |___________________________________________________________| : YES ILDS is rebuilt. In the process of rebuilding, the records of ILDS are arranged in the sequence of the key value. To improve the performance of rebuilding ILDS by making the VSAM load mode in effect, you need to specify the REUSE parameter in your ILDS CLUSTER definition, and specify the ILDSBLD=YES control statement. | DSPR | ILDS is rebuilt with using less data space. : ================================================================ 4.8 Reports and statistics 4.8.1 HPSOUT data set 4.8.1.2 Default Option Tables report : Figure 97 is an example of the Default Option Tables report. IMS HIGH PERFORMANCE LOAD PAGE: 1 5655-M26 08/15/2006 17.24.31 "DEFAULT OPTION TABLES" SYSTEM DEFAULT: HPSCOPTS IN IPR310.SHPSLMD0 INSTALLATION DEFAULT: HPSCOPTI IN IPR310.SHPSLMD0 KEYWORD SYSTEM DEFAULT INSTALLATION DEFAULT ------------ -------------------- -------------------- CHKUPDT NO NO DECODEDBD NO YES HPIO N/A N/A | ILDSBLD C YES ITKBLOAD *NO *NO ITKBSRVR *NO *NO OADSPR NO NO PARTINFO YES YES PARTINIT NO (YES,UNLOAD) : ================================================================ 6.0 SETTING INSTALLATION DEFAULT OPTIONS 6.4 HOW TO CODE HPSCOPT MACRO STATEMENTS : +------------------------------------------------------------+ | | | >>__HPSCOPT=__ START___ | | | | | _| ,A |_ _| ,B |_ _| ,H |_ | | |_DRIVER__|________|__|________|__|________|_ | | _| ,I |_ _| ,L |_ _| ,N |_ | | __|________|__|________|__|________| | | | _| ,O |_ _| ,Q |_ | | | __|________|__|________| | | | | : | | : | | | _| ,C |_ _| ,D |_ _| ,K |_ | | |_RELOAD__|________|__|________|__|________|_ | | _| ,L |_ _| ,M |_ _| ,N |_ | | __|________|__|________|__|________| | | | _| ,O |_ _| ,P |_ _| ,R |_ | | | __|________|__|________|__|________| | | | | : | | : | | | Q: | | | __YES__________ | | | |_(YES,DSPR)____| | | | |___ILDSBLD=__|__NO___________|__________________________| | | | | | R: | | | __C_____________ | | | |___ILDSBLD=__|__YES__________|__________________________| | | | |_(YES,DSPR)____| | | | |__NO___________| | |____________________________________________________________| : The identifier of each utility and the option keywords supported by the utility are as follows: : - DRIVER identifies the IPR Driver | DECODEDBD, DECODESXD, DISPOLDDS, SINDEXSUF, HPIO, ITKBLOAD, | ITKBSRVR, and ILDSBLD - RELOAD identifies the IPR Reload utility | DECODEDBD, PARTINFO, CHKUPDT, HPIO, OADSPR, PARTINIT, and | ILDSBLD : ================================================================ 10.0 Messages and codes 10.3 Messages 10.3.2 HPSG messages ---------------------------------------------------------------- HPSG0212E n-th OPERAND MUST BE text Explanation: The n-th operand of the control statement must be specified as indicated by the string text. Text is one of the following: - EITHER YES OR NO : - OMITTED WHEN IMSCMD=NO | - OMITTED WHEN ILDSBLD=NO - PARTITION NAME AND NUMBER LESS THAN 1002 : - ONE OF DELETE, NEWSHADOW, AND TEMPNAME | - DSPR : ================================================================
APAR Information
APAR number
PK57505
Reported component name
IMS PARALLEL RE
Reported component ID
5655F7400
Reported release
320
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2007-12-03
Closed date
2007-12-19
Last modified date
2008-01-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK32514
Modules/Macros
HPSCOPT HPSCOPTD HPSCOPTS HPSGCM00 HPSGCM20 HPSGCSC1 HPSGGRGB HPSGOPTG HPSGOPTR HPSGOPTU HPSGRS00 HPSGSTMT
| SC18922803 |
Fix information
Fixed component name
IMS PARALLEL RE
Fixed component ID
5655F7400
Applicable component levels
R320 PSY UK32514
UP07/12/22 P F712
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":"320","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
06 January 2023