A fix is available
APAR status
Closed as new function.
Error description
Support for IMS V13 KEYWORDS: IMSV13TGT/K
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IMS Library Integrity Utilities * * for z/OS, Version 2 Release 1 (FMID=H27P210) * **************************************************************** * PROBLEM DESCRIPTION: This APAR enables Library Integrity * * Utilities to run under IMS Version 13. * * * * This APAR also fixes an existing problem* * of DBD/PSB/ACB Compare utility: * * ABEND0C4 occurs in FABLCOMP when * * comparing ACBs after applying any PTFs. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR enables Library Integrity Utilities to run under IMS Version 13. IMS Version 13 provides Database versioning enhancements. Consistency Checker, DBD/PSB/ACB Compare, DBD/PSB/ACB Reversal and DBD/PSB/ACB Mapper are enhanced to support new DBD and PSB statement parameter DBVER and DBLEVEL for Database versioning in this APAR. This APAR also fixes an existing problem of DBD/PSB/ACB Compare utility: If offset of an internal table in FABLACB0 is not aligned to Full-word boundary after applying any PTFs, ABEND0C4 occurs in FABLCOMP when comparing ACBs.
Problem conclusion
Temporary fix
Comments
Documentation Changes: Note: The section numbers are those of the BookManager (BKMGR) book. The documentation is modified as follows: ============================================================== IMS Library Integrity Utilities for z/OS, V2R1, User's Guide (SC19247901) ============================================================== -------------------------------------------------------------- 1.0 Overview of IMS Library Integrity Utilities 1.4 IMS Library Integrity Utilities terminology -------------------------------------------------------------- The following description is added: To make this book easier to read, the version and release levels of IMS are abbreviated, as follows: | - IMS Version 13 refers to IMS Version 13 Release 1. -------------------------------------------------------------- 1.0 Overview of IMS Library Integrity Utilities 1.8 Summary of changes -------------------------------------------------------------- The following description is added: All utilities | APAR PM75259: IMS Library Integrity Utilities can run under | IMS Version 13. -------------------------------------------------------------- 2.0 Configuring IMS Library Integrity Utilities 2.1 Hardware and software prerequisites -------------------------------------------------------------- The following description is added: Software IMS Library Integrity Utilities operates in z/OS Version 1 Release 8 (5694-A01) or later. IMS Library Integrity Utilities requires one of the following products: | - IMS Version 13 Release 1 (5635-A04) -------------------------------------------------------------- 4.0 Consistency Checker 4.6 Output from Consistency Checker 4.6.2 SYSPRINT data set 4.6.2.1 DBD Check report -------------------------------------------------------------- The following figure is modified: Figure 19. DBD Check report (Part 2 of 2) IMS LIBRARY INTEGRITY UTILITIES - CONSISTENCY CHECKER 5655-U08 DATE ... DB INFORMATION -------------- LIBRARY CHK ITEM/FIELD CONTENTS DBDLI -------- --- ------------ ------------------------- ----- ACBLIB ACB MBR FOUND | IMSREL 1310 1310 | *** GENDATE 12/25/2012 10:34 01/10 | *** DBVER 1234 ACCESS HDAM,OSAM HDAM, The following description is added in the report field descriptions for the DB information part: ACBLIB | DBVER | The database version number of the DBD specified in the | DBVER parameter of the DBD statement. -------------------------------------------------------------- 4.0 Consistency Checker 4.6 Output from Consistency Checker 4.6.2 SYSPRINT data set 4.6.2.2 PSB Check report -------------------------------------------------------------- The following figure is modified: Figure 21. PSB Check report (Part 2 of 2) IMS LIBRARY INTEGRITY UTILITIES - CONSISTENCY CHECKER 5655-U08 DATE ... PSB INFORMATION --------------- LIBRARY CHK ITEM/FIELD CONTENTS PSBLI -------- --- ------------ ------------------------- ----- ACBLIB ACB MBR FOUND | IMSREL 1310 1310 | *** GENDATE 12/24/2012 18:32 12/25 | *** DBLEVEL BASE CURR LANG ASSEM/COBOL ASSEM ... DBPCB INFORMATION ----------------- | P -------- ... --------------------------------- | PCB # CHK A DBDNAME ... OCSEQ(D) VIEW LIST DBVER | ----- --- - -------- ... ------ ----- ---- ---------- | 1 P TESTDB1 ... STIDX1 YES 1 | *** A TESTDB1 ... * YES 1 | 4 P TESTDB2 ... YES 2 | *** A TESTDB2 ... YES 1* The following description is added in the report field descriptions for the PSB information part: ACBLIB | DBLEVEL | The database version level specified in the PSB statement. The following description is added in the report field descriptions for the DB PCB information part: PSBLIB/ACBLIB These columns show that the following fields are found in the PSB and the ACB: | DBVER | The database version number of the DBD that is specified in | the DB PCB. -------------------------------------------------------------- 5.0 DBD/PSB/ACB Compare utility 5.7 Output from DBD/PSB/ACB Compare 5.7.2 SYSPRINT data set 5.7.2.1 Block level compare reports -------------------------------------------------------------- The following column in the Table 7 is updated.: +-------------------+-----------------------------------------+ |Section | Description | +-------------------+-----------------------------------------+ || DBDXTB | Contains the DBD extensional information| || | and database versioning information. | The following column is added to the Table 8.: +-------------------+-----------------------------------------+ |Section | Description | +-------------------+-----------------------------------------+ || PCBE PCB (pcbname)| Contains the PSB extensional information| || | and database versioning information. | -------------------------------------------------------------- 6.0 DBD/PSB/ACB Mapper utility 6.7 Output from DBD/PSB/ACB Mapper 6.7.2 SYSPRINT data set 6.7.2.1 DBD map -------------------------------------------------------------- The header of the all figures in this chapter are modified like the following figure: Figure 50. DBD map (single-page) IMS LIBRARY INTEGRITY ... PAGE: A 5655-U08 ... FABMDMAP - V2.R1 DBDNAME=PHDAM04 ... | DBDMAP OF PHDAM04 ... DBVER= 3 -------------------------------------------------------------- 6.0 DBD/PSB/ACB Mapper utility 6.7 Output from DBD/PSB/ACB Mapper 6.7.2 SYSPRINT data set 6.7.2.2 DBD report -------------------------------------------------------------- The header of the all figures in this chapter are modified like the following figures: Figure 53. DBD report (Part 1 of 2) IMS LIBRARY INTEGRITY ... PAGE: 1 5655-U08 ... FABMDMAP - V2.R1 DBDNAME=DSCRSDVN ... | DBDMAP OF DSCRSDVN ... DBVER= 3 The following description is added: Report field description for the database information part The database information part includes the following information: On the first two lines of the report (underneath the heading): | - The version number of the DBD specified in the DBVER | parameter of the DBD statement -------------------------------------------------------------- 6.0 DBD/PSB/ACB Mapper utility 6.7 Output from DBD/PSB/ACB Mapper 6.7.2 SYSPRINT data set 6.7.2.3 PSB Summary report -------------------------------------------------------------- The following figure is modified: Figure 55. PSB Summary report (Part 1 of 2) IMS LIBRARY INTEGRITY UTILITIES - DBD/PSB/ACB MAPPER 5655-U08 DATE ... PSB PREFIX SUMMARY 0 BYTES NEEDED FOR I/O WORK ARE 0 BYTES NEEDED FOR SSA WORK ARE ASSEMBLER/COBOL LANGUAGE OR NOT SP | DBLEVEL = CURR ... DB PCB DETAIL DB PCB # 1 DSCRSDVN | DBVER= 3 PROCESSING OPTION = L -------------------------------------------------------------- 6.0 DBD/PSB/ACB Mapper utility 6.7 Output from DBD/PSB/ACB Mapper 6.7.2 SYSPRINT data set 6.7.2.5 PSB report -------------------------------------------------------------- The following description is added: | Note: FABM0045W notification is displayed to this report when | the utility detects the database version number of the DBD | referenced by the PSB is different from the database version | specified in the PSB. The header of the all figures in this chapter are modified like the following figure: Figure 57. PSB report (Part 1 of 2) IMS LIBRARY INTEGRITY ... PAGE: 1 5655-U08 ... FABMPMAP - V2.R1 ... | DBDMAP OF DSCRSDVN ... DBVER= 3 -------------------------------------------------------------- 13.0 Troubleshooting 13.4 IMS Library Integrity Utilities messages 13.4.2 FABM messages -------------------------------------------------------------- The following new message is added: FABM0045W THE DATABASE VERSION NUMBERS THAT ARE SPECIFIED BY THE PSB AND THE DBD DO NOT MATCH. PSB psbname SPECIFIED VERSION number1 AND DBD dbdname SPECIFIES VERSION number2. Explanation: The DBD/PSB/ACB Mapper utility detects the difference between the database version numbers that are specified in the PSB and the DBD referenced by the PSB. In this case, there is a possibility that the reported DBD in the PSB report is not expected by the PSB. System Action: THE DBD/PSB/ACB MAPPER utility continues processing. User Response: None ×**** PE13/01/18 PTF IN ERROR. SEE APAR PM80933 FOR DESCRIPTION
APAR Information
APAR number
PM75259
Reported component name
IMS LIBR INTEG
Reported component ID
5655I4200
Reported release
210
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2012-10-17
Closed date
2012-12-21
Last modified date
2013-10-24
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK90553
Modules/Macros
FABLACBD FABLACB0 FABLACT0 FABLADPL FABLADP0 FABLAH0D FABLAH1D FABLAH2D FABLAPI0 FABLAPSD FABLARCN FABLBAFD FABLBALD FABLBAR0 FABLBA0D FABLBDFD FABLBDLD FABLBD0D FABLBH0D FABLBH1D FABLBH2D FABLBICD FABLBIN0 FABLBPED FABLB00D FABLCMPD FABLCMPP FABLCMPR FABLDBDT FABLDBD0 FABLDMBD FABLEACB FABLECHK FABLECLS FABLECMP FABLECTL FABLEDBD FABLEDMA FABLEDMB FABLEDMC FABLEDMD FABLEDM9 FABLEDRD FABLEMBL FABLEMDA FABLEOPN FABLEPAA FABLEPAB FABLEPAC FABLEPAD FABLEPA9 FABLEPCC FABLEPCM FABLEPRP FABLEPSB FABLERCN FABLERDA FABLERDB FABLERDC FABLERDD FABLERPT FABLFBBD FABLGVT0 FABLICCD FABLICI0 FABLIDBD FABLIDR0 FABLIPSD FABLIU00 FABLLINK FABLLOAD FABLPSBT FABLPSB0 FABLRCKD FABLREAD FABLRTRD FABLRTS0 FABLTBLD FABLUMD1 FABLVAI0 FABLVCS0 FABLVCTD FABLVDVD FABLVMND FABLVRCD FABLVRE0 FABLVTBD FABMAMAP FABMBMAP FABMDBLD FABMDCND FABMDCVD FABMDMAP FABMDMBD FABMPBLD FABMPCND FABMPCVD FABMPMAP FABMPSDD FABMREAD FABNACB0 FABNCHKD FABNCHKP FABNCNST FABNCNTL FABNCODE FABNCPUT FABNDATE FABNDBD0 FABNDBLD FABNDCND FABNDCOD FABNDCTL FABNDCVD FABNDDN0 FABNDEDB FABNDIR0 FABNDMBD FABNDSG0 FABNDUMP FABNEXCL FABNGSAM FABNINDX FABNLCH0 FABNLOG0 FABNMSDB FABNMSGS FABNOPEN FABNPARM FABNPBLD FABNPCNA FABNPCNB FABNPCNC FABNPCND FABNPCN8 FABNPCN9 FABNPCTL FABNPCVD FABNPDBD FABNPLOD FABNPPCB FABNPPSB FABNPSDD FABNREAD FABNREAX FABNSDBD FABNSPSB FABNSREF FABNSTAE FABNTLES FABNTSRT FABNWILD FABNXREF FABQCHEK FABQIVP FABQLMGR FABQMAIN FABQRLVA FABQRLVB FABQRLVC FABQRLVD FABQRLV9 FABQRPT9 FABQTASK FABQUMD3 H27P210J
SC19247901 |
Fix information
Fixed component name
IMS LIBR INTEG
Fixed component ID
5655I4200
Applicable component levels
R210 PSY UK90553
UP12/12/22 P F212
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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"2.1.0","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89N","label":"IMS Library Integrity Utilities"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"2.1.0","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
24 October 2013