A fix is available
APAR status
Closed as new function.
Error description
Provide an option to report the information about twin chain for IPR Driver and 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: Provide an option to report the * * information about twin chain. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR provides an option to report the information about twin chain by IPR Reload utility or the reload task of Smart Reorg Driver. To use the new function, the following maintenance is required: - APAR PM79675 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-02 ( SC19113702 ) should be changed as follows: ================================================================ 3.5.2 Control statements for Smart Reorg 3.5.2.5 Control statements for Reload task : Table-17.-Control statements for Reload task +----------+-------------------+---------+--- | Keyword | Acceptable values | Default | +----------+-------------------+---------+--- | : | : | : | +----------+-------------------+---------+--- | | TWINSTAT | YES-or-NO | NO- | +----------+-------------------+---------+--- | : | : | : | 5.3 IPR Reload JCL statements 5.3.2 Control statements : | 5.3.2.xx TWINSTAT control statement | | Specifies whether to generate twin segment statistics report. | Twin segment statistics report is a part of segment | statistics report, and the twin segment statistics part | provides further information about twin chain. For the | details, see "Segment Statistics report" in topic 5.5.1.9. | This specification is valid for HDAM, HIDAM, PHDAM, or | PHIDAM. This control statement is optional. If you do not | explicitly specify this control statement, TWINSTAT=NO will | be used. | _________________________________________________________ | | | | | _NO___ | | | >>__TWINSTAT=__|_YES__|______________________________>< | | | | | |_________________________________________________________| | | NO | Specifies that the twin segment statistics report not be | generated. | | YES | Specifies that the twin segment statistics report be | generated. | | Notes: | -When processing a HALDB with TWINSTAT=YES, | PARTSTAT=YES is forced and statistics reports that | include twin segment statistics part are generated | for each partition. | -When TWINSTAT=YES is specified for the reload block | of Smart Reorg utility, you must specify STATRL=YES | or HPSSTAT DD statement. | | Note: | The default value of the TWINSTAT control statement can be | changed. For details, see "Setting installation default | option" in topic 7.1. 5.5 IPR Reload reports 5.5.1 HPSOUT data set 5.5.1.9 Segment Statistics report : Variable Length Segment Statistics Section When there is any variable-length segment in a database, this section is produced as part of the Segment Statistics report. When there is no variable-length segment, this section is not printed. : : | Twin Segment Statistics Section | When TWINSTAT=YES is specified, this section is produced as | part of the Segment Statistics report. For a HISAM or a | SHISAM database, this section is not printed. The following figures show examples of Segment Statistics reports. : : The meanings of the fields in the Segment Statistics report are as follows: PARTITION The partition name. This field is printed only for a HALDB. SEGMENT STATISTICS SEGMENT The name of the segment type. : SEGMENT IN OVERFLOW STATISTICS : <<<VARIABLE LENGTH SEGMENT STATISTICS>>> SEGMENT The name of the segment type. : | TWIN SEGMENT STATISTICS | | The twin chain statistics part provides further information | about twin chained segments with the following items: | | SEGMENT | The name of the segment. | | NUMBER OF CHAINS | The total number of chains for the segment type. | "N/A" is shown if twin pointer is not defined for the | segment. | | MAX CHAIN LENGTH | The maximum number of twin chain length | | AVG CHAIN LENGTH | The average number of twin chain length 7.0 Reference 7.1 Setting installation default options 7.1.4 How to code HPSCOPT macro statements : ___________________________________________________________ | | | DRIVER: | | <_,_______________________________________ | | |__DRIVER___ _______________________________________ |__| | | |_ ________________________________ ____| | | | | _NO_____________ | | | | | |_CONDREORG=__|_YES____________|_| | | | | |_(YES,DIAGONLY)_| | | : : | |_ _____________________ _______________| | | | | | _NO__ | | | | | | |_SINDEXSUF=__|_YES_|_| | | | | |_ _____________________________________| | | | | _NO__ | | | | |_STATRL=__|_YES_|_| | | | |___________________________________________________________| ____________________________________________________________ | | | DRIVRL: | | <_,___________________________________________ | | |__DRIVRL_____________________________________________ |__|| | |_ ____________ __________________ ________| | | | |_ILEDATAC=__|_data_class_name__| | | : : | |_ _________________ ______________________| | | | | _NO___ | | | | | |_SORT=__|_YES__|_| | | | | |_COND_|_| | | | | |_ ________________________________________| | | | | | _NO__ | | | | | | |_TWINSTAT=__|_YES_|_| | | | |_ __________________ _____________________| | | | _YES_ | | | |_WF1REC=__|_NO__|_| | | | |____________________________________________________________| : ____________________________________________________________ | | | RELOAD: | | <_,_________________________________________ | | |__RELOAD__ __________________________________________ |__|| | |_ ________________________________ _______| | | | | _YES,WARN________ | | | | | | | _,WARN__ | | | | | | |_CHKTRAIL=__|_YES__|_,ERROR_|_|_| | | | | |_NO______________| | | : : | |_ _________________ ______________________| | | | | _NO___ | | | | | |_SORT=__|_YES__|_| | | | | |_COND_|_| | | | | |_ ________________________________________| | | | | | _NO__ | | | | | | |_TWINSTAT=__|_YES_|_| | | | |_ __________________ _____________________| | | | _YES_ | | | |_WF1REC=__|_NO__|_| | | | |____________________________________________________________| : The identifier of each utility and the option keywords supported by the utility are as follows: DRIVER This parameter identifies the Smart Reorg Driver (HPSGMAIN) . This parameter supports the following values: - CONDREORG - DECODEDBD - DECODESXD - DISPOLDDS - SINDEXSUF - HPIO - ITKBLOAD - ITKBSRVR - ILDSBLD | - STATRL DRIVRL This parameter identifies the Reload task under the Smart Reorg Driver. This parameter supports the following values: - ILEDATAC - ILESTORC - OADSPR - PAD - PARTINIT - REPAIRILK - SORT - WF1REC | - TWINSTAT The specification of PARTINIT is valid only when REORGINPT=ULDS is used. : : RELOAD This parameter identifies the IPR Reload utility. This parameter supports the following values: - DECODEDBD - PARTINFO - CHKUPDT - HPIO - OADSPR - PAD - PARTINIT - REPAIRILK - SORT - ITKBLOAD - ITKBSRVR - ILDSBLD - ILEDATAC - ILESTORC - GDGBASE - GDGLIMIT - WF1REC | - TWINSTAT Note: The Reload task under Smart Reorg uses the option table for DRIVRL, not the one for RELOAD.
APAR Information
APAR number
PM79676
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
2012-12-21
Closed date
2013-04-18
Last modified date
2013-05-06
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK93613
Modules/Macros
HPSCOPT HPSCOPTS HPSGCM00 HPSGOPTG HPSGOPTR
SC19113702 |
Fix information
Fixed component name
IMS DB REORG EX
Fixed component ID
5655F7400
Applicable component levels
R410 PSY UK93613
UP13/04/23 P F304
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