A fix is available
APAR status
Closed as new function.
Error description
With this APAR, the following new functions are added: - HD Pointer Checker shows the database dataset size in GB (giga bytes) form, and the percentage of a database data set size to the maximum size in its reports. - Export Utility of DB Historical Data Analyzer can export the percentage of a database data set size to the maximum size into a flat file.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: IBM IMS High Performance Pointer Checker for * * z/OS Version 2 Release 1 (FMID=HPC2210) * * users. * **************************************************************** * PROBLEM DESCRIPTION: This APAR provides the following two * * new functions to High Performance * * Pointer Checker: * * * * - HD Pointer Checker * * Adds more data set size information * * to the HISAM Data Set Statistics * * Report and the HD Data Set Statistics * * Report. * * * * - Export Utility of DB Historical data * * Analyzer * * Adds more data set size information * * to exportable fields. * * * * In addition, this APAR fixes errors in * * the HISAM Data Set Statistics Report * * of HD Pointer Checker. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** +--- !!!! NOTE !!!! ------------------------------------------+ | By this APAR, the format of some HD Pointer Checker reports | | are changed. If a user's application program reads the HD | | Pointer Checker reports, the user's application program | | needs to be changed. | +-------------------------------------------------------------+ 1. HD Pointer Checker reports enhancements (1) HISAM Data Set Statistics Report The following items are added: - The database data set size in giga bytes - The percentage of database data set size to a maximum size - The database data set size limit - The free space(usable) - The free space(not usable) - The unknown data - The VSAM CI overhead The following items are deleted: - The free space (2) HD Data Set Statistics Report The following items are added: - The database data set size in giga bytes - The percentage of database data set size to a maximum size - The database data set size limit 2. Export Utility enhancements A percentage of database data set size to a maximum size can be exported to a flat file. 3. "HISAM Data Set Statistics Report" is chagend to show correct values in the following fiedls: - TOTAL BYTES OF SPACE - DL/I OVERHEAD
Problem conclusion
Temporary fix
Comments
Documentation Changes: Note: The section numbers are those of the BookManager (BKMGR) book. The documents are modified as follows: ============================================================== IMS High Performance Pointer Checker for z/OS, V2R1, User's Guide Vol.1 (SC18725701) ============================================================== 2.0 HD Pointer Checker 2.1 Operating Instructions for the HD Pointer Checker Processor 2.1.7 Output 2.1.7.3 STATIPRT Data Set 2.1.7.3.4 HISAM Data Set Statistics Report ---------------------------------------------------------------- The following descriptions are modified: TOTAL BYTES OF SPACE | The following items are shown: | - The database data set size in bytes. | - The percentage of the database data set size to the total | size(always 100.0%). | - The database data set size in giga bytes. | - The percentage of database data set size to a maximum | size. | - The database data set size limit. SEGMENT PREFIX The number of bytes in the prefix and what percentage it makes of the total bytes. SEGMENT DATA The number of bytes of data and what percentage it makes of the total bytes. SEGMENT PAD The number of bytes of segment pad and what percentage it makes of the total bytes. If the length of the variable segment is less than the MIN value in the DBD,the difference is counted as a segment pad. |Note: A deleted segment that is marked as deleted in a delete | byte is reported in segment prefix, segment data, and | segment pad, because the segment is not physically deleted. The following description is added after "SEGMENT PAD": | FREE SPACE(USABLE) | The sum of the following values and what percentage it | makes of the total bytes. | - Unused area in a logical record that has enough | length to store the minimum length dependent segment. | The segment length is the prefix length plus the data | length. The data length is a numeric value specified | in the SEGM statement in the DBD. | For a variable-length segment, the maximum segment size | is taken as the data length. | If a fixed length segment is defined with a segment | edit/compression exit, the minimum length of the | segment is the prefix length plus the minimum value | of BYTES= in DBD. | For a fixed-length segment that has been made longer | than the segment size in the DBD by the segment | edit/compress facility, the segment size in the DBD is | taken as the segment data length. The increase in the | maximum length of the fixed-segment which is edited by | a segment edit/compression facility is ignored. | - Unused area in the VSAM CI that has enough length | to contain one or more logical record. | FREE SPACE(NOT USABLE) | The sum of the following values and what percentage it | makes of the total bytes: | - Unused area in a logical record that does not | have enough length to contain the shotest dependent | segment. | - Unused area in a VSAM CI does not have enough | length to contain a logical record. | UNKNOWN DATA | The number of bytes of unknown data, and what percentage it | makes of the total bytes. | The unknown data are contiguous bytes that cannot be | classified as segment, free space, DL/I OVERHEAD, or | VSAM CI OVERHEAD. The following description is deleted: | FREE SPACE | The number of bytes of free space and what percentage | it makes of the total bytes. The following descriptions are modified: DL/I OVERHEAD | The sum of the following values and what percentage it | makes of the total bytes: | - The first 4 bytes in a logical record that are a | direct-address pointer to the next logical record | in the database record. | - A 1-byte segment code of 0 that says the last segment | in the logical record has been reached. The following description is added after "DL/I OVERHEAD": | VSAM CI OVERHEAD | The sum of RDFs and CIDFs in the VSAM CIs and what | percentage it makes of the total bytes. ---------------------------------------------------------------- Figure 24. HISAM Data Set Statistics Report is modified. ---------------------------------------------------------------- 2.1.7.3.11 HD Data Set Statistics Report ---------------------------------------------------------------- The following description is modified: TOTAL BYTES OF SPACE | The following items are shown: | - The database data set size in bytes. | - The percentage of the database data set size to the total | size(always 100.0%). | - The database data set size in giga bytes. | - The percentage of database data set size to a maximum | size. | - The database data set size limit. ---------------------------------------------------------------- Figure 31. HD Data Set Statistics Report is modified. ============================================================== IMS High Performance Pointer Checker for z/OS, V2R1, User's Guide Vol.2 (SC18725801) ============================================================== 2.4.3.3 FABGRECI Data Set 2.4.3.3.7 Field Names ---------------------------------------------------------------- Table 6. is modified as follows: Table 6. Field Names +-------------+---+-----------+---------+-----+--------------+ |Field Name |De-|Record Type|Effective|Maxim|Description | | |fau|That Can be|Database |um Le| | | |lt |Specified |Organizat|ngth | | | |Val|Y:Can be sp|ion |That | | | |ue |ecified |Y:Value |Can B| | | | |N:Cannot be|is set |e Spe| | | | |specified |N: Blank |cifie| | | | | |(X'40') |d | | | | | |or null |0:Can| | | | | |(X'00') |not b| | | | | |is set |e spe| | | | | | |cifie| | | | | | |d | | | +---+-----------+---------+-----+ | | |A|L|D|P|D|S|R|P|H|H|P|P|H|C|X|P| | | |T|E|B|A|S|E|A|T|D|I|H|H|I| | | | | | |T|N| |R|G|G|P|R|A|D|D|I|S| | | | | | |R| | |T| |M| | |M|A|A|D|A| | | | | | | | | | | | | | | |M|M|A|M| | | | | | | | | | | | | | | | | |M| | | | | | |-------------+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+--------------| |Data set group and data set space information | |Value for each data set is set. For a HALDB, each DSG | |information is generated per partition. | |-------------+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+--------------| |-------------+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+--------------| |ALCCYL |X|4|N|N|Y|N|N|N|Y|Y|Y|Y|Y|0|4|8| Allocated | | | | | | | | | | | | | | | | | | |Cylinders for | | | | | | | | | | | | | | | | | | |the data set | | | | | | | | | | | | | | | | | | | If you want | | | | | | | | | | | | | | | | | | |to set this | | | | | | | | | | | | | | | | | | |field, run | | | | | | | | | | | | | | | | | | |HD Pointer | | | | | | | | | | | | | | | | | | |Checker with | | | | | | | | | | | | | | | | | | |the DATASET= | | | | | | | | | | | | | | | | | | |REAL option | |-------------+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+--------------| ||USEDDS% |C|5|N|N|Y|N|N|N|Y|Y|Y|Y|Y|5|0|0|Used rate to | || | | | | | | | | | | | | | | | | |the data set | || | | | | | | | | | | | | | | | | |capacity | ||-------------+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+--------------| ||OVUSEDDS% |C|5|N|N|Y|N|N|N|N|N|N|N|Y|5|0|0|Used rate to | || | | | | | | | | | | | | | | | | |the data set | || | | | | | | | | | | | | | | | | |capacity of | || | | | | | | | | | | | | | | | | |overflow data | || | | | | | | | | | | | | | | | | |set | ||-------------+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+--------------|
APAR Information
APAR number
PK16210
Reported component name
IMS POINTER CHE
Reported component ID
5655E0900
Reported release
210
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2005-12-05
Closed date
2006-01-22
Last modified date
2006-02-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK11031
Modules/Macros
FABGHIR0 FABGXCB0 FABGXXPE FABPANB FABPHSHI FABPR003 FABPSHI0 FABPUDSR FABPUPHR FABPXPHR
SC18725701 | SC18725801 |
Fix information
Fixed component name
IMS POINTER CHE
Fixed component ID
5655E0900
Applicable component levels
R210 PSY UK11031
UP06/01/24 P F601
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.
[{"Line of Business":{"code":null,"label":null},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89G","label":"IMS HP Pointer Checker"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"210"}]
Document Information
Modified date:
04 October 2020