A fix is available
APAR status
Closed as new function.
Error description
A new option is provided to let IPR Reload utility do a check against DBRC to see whether an update of the database has been done between unload and reload.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IPR Unload utility and IPR * * Reload utility of IMS Parallel * * Reorganization for z/OS Version 3 Release 1 * * (FMID=H25N310) * **************************************************************** * PROBLEM DESCRIPTION: This APAR provides a following new * * options: * * - CHECKREC= for IPR Unload. * * - CHKUPDT= for IPR Reload. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** The following new control statements are introduced: - CHECKREC= for IPR Unload. If 'CHECKREC=YES' is specified in HPSIN DD, IPR Unload utility writes the particular record for checking the content by IPR Reload. - CHKUPDT= for IPR Reload. If 'CHKUPDT=YES,xxx' is specified in HPSIN DD, IPR Reload utility checks whether an update of the database has been done between unload and reload. To use these control statements, the following maintenances are required: - APAR PK11534 for IMS High Performance Unload (FMID=H1IN110) - APAR PK12257 for IMS High Performance Load (FMID=H1IM210)
Problem conclusion
Temporary fix
Comments
Documentation Change ==================== IMS Parallel Reorganization for z/OS User's Guide (SC18922801) should be changed as follows: ================================================================ 3.0 The IPR Unload utility 3.8 Control statements 3.8.3 Control statements for unload function ____________________________________________________________ | Table 12. Control statements for unload function | |_____________ _______________ ______________ _______________| | Keyword | Acceptable | Default | Description | | | values | | | |_____________|_______________|______________|_______________| | | CHECKREC | YES or NO | NO | Specifies | | | | | | whether the | | | | | | check record | | | | | | used by IPR | | | | | | Reload is | | | | | | added to the | | | | | | unload data | | | | | | set. | | |_____________|_______________|______________|_______________| | DBRECDIST | a or (b1,... | (100,200,... | Specifies ... | | | | | | (Add following control statement) |3.8.3.x CHECKREC Control statement | Specifies whether the particular record is written just behind | the header record in the unload data set. This record is used | by IPR Reload utility for it to know certain status | of the database at unloading time. | | This control statement is used only for *HD or *SH unload | format. | | This control statement is optional. If you do not explicitly | specify the control statement, CHECKREC=NO will be used. | | ____________________________________________________________ | | | | | +---NO----+ | | | | | | | | >>---CHECKREC=---+---YES---+-------------------------->< | | |____________________________________________________________| | | YES The particular record is written. | NO The particular record is not written. | | Note: The default value of the CHECKREC control statement can | be changed. For details, see "Setting installation | default options" in topic 6.0. 3.9 Reports and statistics 3.9.2 HPSIN Control Statements report (Add the CHECKREC control statement in 'Figure 58. HPSIN Control Statements report for the IPR Unload utility') --------------------------------------------------------------- : OPTIONS FOR UNLOAD FUNCTION: KEYWORD VALUE ------------ --------------------------------------------- | CHECKREC NO DBRECDIST (100,200,300,400,500,600,700,800,900,1000,... DBRECDIST (6000,7000,8000,9000,10000) DBRECKEYS 10 DECODEDBD YES : --------------------------------------------------------------- ================================================================ 4.0 The IPR Reload utility 4.7 Control statements 4.7.2 Overview of IPR Reload control statements ____________________________________________________________ | Table 28. IPR Reload control statements for process control| |_____________ _______________ ______________ _______________| | Keyword | Accepted | Default | Description | | | values | | | |_____________|_______________|______________|_______________| | | CHKUPDT | YES,ABEND or | NO | Specifies | | | | YES,WARN or | | whether you | | | | NO | | want to make | | | | | | IPR Reload | | | | | | check an | | | | | | update of the | | | | | | database has | | | | | | been done | | | | | | between unload| | | | | | and reload. | | |_____________|_______________|______________|_______________| | COMPRESS | YES or NO | NO | Compress ... | | | | | | (The following section should be added.) |4.7.x CHKUPDT Control Statement | Specifies whether you want to make IPR Reload check against | DBRC to see if an update of the database has been done | between unload and reload. | The control statement is optional. If you do not explicitly | specify this control statement, CHKUPDT=NO will be used. | | ____________________________________________________________ | | | | | +--NO------------------+ | | | | | | | | | +-,ABEND-+ | | | | | | | | | | | >>-CHKUPDT= ----+--YES--+-,WARN--+-----+---------->< | | |____________________________________________________________| | | NO Specifies that update not be checked. | YES Specifies that update between unload and reload be | checked. | ABEND Specifies that IPR Reload to abnormally end when | an update is found. If you specify CHKUPDT=YES only, | CHKUPDT=YES,ABEND is assumed. | WARN Specifies that IPR Reload to continue processing with | setting the job step return code to 4 when an update | is found. | | The check against DBRC for an update is activated when all | of the following conditions are met: | - DBRC is active | - Database and Database data sets are registered to DBRC | - The unloaded data set was created by the IPR Unload | utility with the CHECKREC=YES option. | | Note: The default value of the CHKUPDT control statement can | be changed. For details, see "Setting installation | default options" in topic 6.0. 4.8 Reports and statistics 4.8.1 HPSOUT data set 4.8.1.2 HPSIN Control Statements report (Add the CHKUPDT control statement in 'Figure 88. HPSIN Control Statements report for the IPR Reload utility') --------------------------------------------------------------- : EXTENT 52 SORT NO | CHKUPDT NO DECODEDBD NO DBRECDIST (100,200,300,400,500,600,700,800,900,1000,... : --------------------------------------------------------------- ================================================================ 6.0 Setting installation default options 6.2 Creating an Installation Default Option Table (HPSCOPTI) Defaults for the following options can be changed by creating an HPSCOPTI: o DECODEDBD option for the IPR Driver : o STATREP option for the IPR Unload | o CHECKREC option for the IPR Unload o APISET option for the API function of the IPR Unload o PCBLIST option for the API function of the IPR Unload o DECODEDBD option for the IPR Reload o PARTINFO option for the IPR Reload | o CHKUPDT option for the IPR Reload 6.4 How to code HPSCOPT macro statements _____________________________________________________________ | | | >>--HPSCOPT=----------------------------------------------> | | | | >-+-START----------------------------------------------+->< | | | | | | +-END------------------------------------------------+ | | | | | | | +-|,A|-+ +-|,B|-+ +-|,H|-+ +-|,I|-+ | | | | | | | | | | | | | | | +-DRIVER-+------+-+------+-+------+-+------+---------+ | | | | | || | +-|,C|-+ +-|,D|-+ +-|,G|-+ +-|,J|-+ | | || | | | | | | | | | | | || +-UNLOAD-+------+-+------+- ...---+------+-+------+--+ | | | | | || | +-|,C|-+ +-|,D|-+ +-|,K|-+ | | || | | | | | | | | | || +-RELOAD-+------+-+------+-+------+------------------+ | | | | : | | | || J: | || +--NO---+ | || | | | || |--CHECKREC=--+--YES--+-----------------------------------| | | | || K: | || +--NO-------------------------+ | || | | | || | +--ABEND--+ | | || | | | | | || |--CHKUPDT=--+--(--YES--,--+--WARN---+--)--+--------------| | |_____________________________________________________________| ======================= End of Doc-Change ======================
APAR Information
APAR number
PK11533
Reported component name
IMS PARALLEL RE
Reported component ID
5655F7400
Reported release
310
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2005-09-07
Closed date
2005-10-06
Last modified date
2005-11-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK07920
Modules/Macros
HPSCOPT HPSCOPTD HPSCOPTS
| SC18922801 |
Fix information
Fixed component name
IMS PARALLEL RE
Fixed component ID
5655F7400
Applicable component levels
R310 PSY UK07920
UP05/10/08 P F510
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":"310","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
06 January 2023