A fix is available
APAR status
Closed as new function.
Error description
New option is provided to PARTINIT statement for the installation default option of IPR Reload Utility.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IMS Database Reorganization * * Expert for z/OS Version 4 Release 1 * * (FMID=H25N410). * **************************************************************** * PROBLEM DESCRIPTION: New option is provided to PARTINIT * * statement for the installation default * * option of IPR Reload utility. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR provides a new option to PARTINIT statement for the installation default option of IPR Reload utility. The new option PARTINIT=YES,LPART specifies that initialization of a HALDB partition is to be done for the partitions that are specified by the LPART control statement. The LPART statement is used when you delete/define HALDB DBDS by using DDEFPDS DD and IPR Reload utility cannot determine the reorganized partition for some reasons. For details, refer to the APAR description of PM46445 for IMS High Performance Load. To use the new option, LPART statement, or DDEFPDS DD for IPR Reload utility, the following maintenance is required: - APAR PM46445 for IMS High Performance Load (FMID=H1IM210)
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== IMS Database Reorganization Expert for z/OS Version 4 Release 1 User's Guide SC19-1137-01 ( SC19113701 ) should be changed as follows: ================================================================ 5.3.1 JCL requirements for IPR Reload |DDEFPDS DD | Defines an optional data set that contains the IDCAMS | commands for deleting and defining the database data sets to | be processed by IPR Reload utility. IPR Reload utility | searches for the delete and define statements for each | database data set in the member that has the same name as the | database DD name. | | The member must contain only the delete and define | statements. | | Requirements: | - To delete and define database data sets by specifying this | DD statement, the load module library of STEPLIB must be | authorized through Authorized Program Facility (APF). | | - To delete and define HALDB data sets by specifying this DD | statement, the input unloaded data set must be created by | IMS HP Unload with the CHECKREC=YES option. | The unloaded data set must not be concatenated. | |HPSRAMSO DD | Defines the output data set for the Result of Database Data | Set Allocation report. The data set can reside on a tape, | a direct-access device, or it can be routed through the | output stream. If the DD statement is not coded, it is | dynamically allocated to the SYSOUT stream of the output | class that is specified by the MSGCLASS parameter on the JOB | statement. 5.3 IPR Reload JCL statements | 5.3.2.x LPART control statement | Specifies the HALDB partitions to load. | This control statement is optional. | This control statement does not have a default. | __________________________________________________________ | | | | |>>____LPART=___ _*ALL_______________ __________________>< | | | |_partname__________________| | | | | _,1____ | | | | |_(__partname__|_______|__)_| | | | | |_,nnnn_| | | | | |_partlist__________________| | | |__________________________________________________________| | | *ALL | Specifies to load all the partitions. | | Use this option only when you reorganize the entire | database and the input unloaded data set contains data for | all the partitions. | | partname | Specifies the name of the partition to load, or the first | partition of several sequential partitions to load. | | nnnn | Specifies the number of sequential partitions to load. | If this parameter is not specified, the default value of 1 | is assumed. | | Important: The processing order of the partitions is | determined by the HALDB partition selection exit routine or | the HALDB high key values. The processing order does not | depend on the partition names. When you process multiple | partitions, be aware of the order that they are processed. | | Example: The following statements have the same meaning: | LPART=PARTA | LPART=(PARTA) | LPART=(PARTA,1) | | partlist | Specifies a list of the partition names to load. The names | must be separated by commas and enclosed in parentheses. | You can specify up to 1001 names by using multiple | statements as follows: | | LPART=(part1,part2,part3,part4,part5) | LPART=(part6,part7,part8,part9,part10) | | You can specify non-sequential partitions. | | The processing order of the partitions is determined by the | HALDB partition selection exit routine or the HALDB high | key values. The specified order in the list does not affect | the processing order. | | Use the LPART statement to specify the partitions to load | when one or more of the following conditions are met: | - When you create database data sets by using the DDEFPDS | DD statement (IDCAMS commands) and the input unloaded | data set was not created by IMS HP Unload with | the CHECKREC=YES option. | - When you create database data sets by using the DDEFPDS | DD statement (IDCAMS commands) and if you have added new | partitions after unloading the database. | - When you have added new partitions after unloading the | database, and you have one or more empty new partitions | that you want to process with the PARTINIT=YES,LPART | option (specifies to initialize the empty partition.) | To avoid errors, consider specifying this statement only one | or more of these conditions are met. | | Note: If the unload data sets contain segments for the | partitions that are not specified on the LPART control | statement, IPR Reload utility issues an HPSR3768W message and | continues processing. 5.3.2.25 PARTINIT control statement Specifies whether to initialize HALDB partitions after reload. IMS HP Load initializes a HALDB partition when a HALDB partition does not contain any segment during reload. The PARTINIT control statement is valid only for a HALDB. This control statement is optional. If you do not explicitly specify this control statement, PARTINIT=NO will be used. __________________________________________________________ | | | _NO_________________ | | | _,PINITON_ | | |>>____PARTINIT=____|_YES__|__________|_|________________><| | | |_,UNLOAD__| | | | |_,LPART___| | |__________________________________________________________| : UNLOAD Specifies that initialization of a HALDB partition is to be done when the partition information is included in the input unloaded data set. To use this option, the following conditions must be satisfied: -The input unloaded data set has been created by IMS HP Unload and with the CHECKREC=YES option. -The input unloaded data sets are not concatenated. | LPART | Specifies that initialization of a HALDB partition is to be | done when the partitions to be loaded are specified by the | LPART control statement. ======================================== > 7.0 References >> 7.1 Setting installation default option >>> 7.1.4 How to code HPSROPT macro statements __________________________________________________________ | | | _NO_________________ | | | _,PINITON_ | | |>>____PARTINIT=____|_YES__|__________|_|________________><| | | |_,UNLOAD__| | | | |_,LPART___| | |__________________________________________________________| ======================================== > 8.0 Troubleshooting >> 8.2 Messages and codes >>> 8.2.1 Return codes >>>> 8.2.1.3 IPR Reload utility return codes Table 68. Return codes of IPR Reload utility ------------------------------------------------------------ |Return |Reason |Meaning | |code |code | | +------------------------------------------------------------+ |0 |None |Successful completion. | +------------------------------------------------------------+ |4 |The reason code is a logical sum of the following | | |codes: | |: | |: | +------------------------------------------------------------| | |X'2000'|Although partition initialization function | | | |is used, some partitions were not | | | |initialized by one of the following reasons:| | | | - The flag in the RECON shows that the | | | | partition does not need to be | | | | initialized (NOPINIT). | | | | | | | | - The partition information is not found | | | | in the unloaded data set. | | | | | | | | | - Although PARTINIT=YES,LPART is | | | | | specified, the partition is not | | | | | specified on the LPART statement. | +------------------------------------------------------------+
APAR Information
APAR number
PM46446
Reported component name
IMS DB REORG EX
Reported component ID
5655F7400
Reported release
410
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2011-08-25
Closed date
2011-10-25
Last modified date
2011-11-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK73195
Modules/Macros
HPSCOPT HPSCOPTS HPSGCSC0 HPSGOPTR
SC19113701 |
Fix information
Fixed component name
IMS DB REORG EX
Fixed component ID
5655F7400
Applicable component levels
R410 PSY UK73195
UP11/10/26 P F110
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":"4.1.0","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
06 January 2023