A fix is available
APAR status
Closed as new function.
Error description
This APAR enables the following: - DBD/PSB/ACB Compare/Mapper/Reversal utility and Consistency Checker can process DBD/PSB/ACB members which include metadata.
Local fix
N/A
Problem summary
**************************************************************** * USERS AFFECTED: IMS Library Integrity Utilities for z/OS, * * Version 2 Release 1 (FMID=H27P210). * **************************************************************** * PROBLEM DESCRIPTION: This APAR enables the following * * utilities to process DBD, PSB or ACB * * including IMS Catalog metadata: * * * * - DBD/PSB/ACB Reversal utility * * - DBD/PSB/ACB Compare utility * * - DBD/PSB/ACB Mapper utility * * - Consistency Checker utility * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR enables the following utilities to process DBD, PSB or ACB including IMS Catalog metadata: - DBD/PSB/ACB Reversal utility can decode DBD, PSB or ACB member including metadata. - DBD/PSB/ACB Compare utility can compare DBD, PSB or ACB member including metadata. - DBD/PSB/ACB Mapper utility can issue correct maps and reports from DBD, PSB or ACB member including metadata. - Consistency Checker utility can check the consistency of definitions that are required to run the IMS subsystem using DBD, PSB or ACB member including metadata.
Problem conclusion
Temporary fix
Comments
The following modules and macros have been fixed to support IMS Catalog. FABLACBC FABLADPL FABLADP0 FABLAPI0 FABLAPSC FABLCMPD FABLCMPP FABLCMPR FABLCOMP FABLDBDT FABLDBD0 FABLDMBC FABLEACB FABLECHK FABLECTL FABLEDBD FABLEICB FABLEPCC FABLEPSB FABLGEN FABLICB FABLLINK FABLLOAD FABLPRTS FABLPSBT FABLPSB0 FABLREAD FABLVCTC FABLVCT0 FABMAMAP FABMBASE FABMDMAP FABMPMAP FABNACB0 FABNCNTL FABNCODE FABNCOM1 FABNCPUT FABNCTG0 FABNDBD0 FABNDBLC FABNDCNC FABNDCOD FABNDCTL FABNDCVC FABNDDN0 FABNDEDB FABNDIR0 FABNDMBC FABNDSG0 FABNDST0 FABNDUMP FABNEXCL FABNGSAM FABNINDX FABNLCH0 FABNLOG0 FABNMSDB FABNOPEN FABNPARM FABNPBLC FABNPCNC FABNPCTL FABNPDBD FABNPPCB FABNPPSB FABNREAC FABNREAD FABNSDBD FABNSPSB FABNSREF FABNSTAE FABNTSRT FABNXREF H27P210J MMIDBD ======================== = DOCUMENTATION CHANGE = ======================== IMS Library Integrity Utilities for z/OS Version 2 Release 1 User's Guide (Document Number: SC19-2479-01) should be changed as follows. ================================================================ -------------------------------------------------------------- 4.0 Consistency Checker utility 4.1 Consistency Checker overview -------------------------------------------------------------- The following columns are modified in the Table 4. +-------+-+---------------+-+---------------+ | |:|MODBLKS |:|DRD | | | | | | | +-------+-+---------------+-+---------------+ | : |:| : |:| : | +-------+-+---------------+-+---------------+ ||PHIDAM |:|Yes(see note 7)|:|Yes(see note 7)| +-------+-+---------------+-+---------------+ ||PSINDEX|:|Yes(see note 7)|:|Yes(see note 7)| +-------+-+---------------+-+---------------+ | : |:| : |:| : | +-------+-+---------------+-+---------------+ |Note: | | : | ||7. There is no need to create a MODBLKS or | || RDDS entry for IMS Catalog database. | +-------------------------------------------+ The following note is modified: Note: Consistency Checker does not verify GSAM PCBs because no ACB member is generated. | Consistency Checker does not verify MODBLKS or RDDS entry | when DBDs or PSBs for IMS Catalog are processed because | neither MODBLKS nor RDDS entry are required The following paragraph is added after "Program structure": |Restrictions | |Consistency Checker does not support the verification for |IMS Catalog Partition Definition Data Set. If CHKRECON=YES is |specified and IMS Catalog DB is not registered in the RECON |data set, Consistency Checker detects that the definition is |not consistent with DBDs for IMS Catalog. -------------------------------------------------------------- 4.6 Output from Consistency Checker 4.6.2 SYSPRINT data set 4.6.2.1 DBD Check report -------------------------------------------------------------- The following notes are added: MODBLKS DB DEF Whether a database definition that corresponds to the DBD is found in the specified MODBLKS module. | Note: When processing a DBD for IMS Catalog, the lines for | MODBLKS are not shown. SYSRDDS DB DEF Whether a database definition that corresponds to the DBD is found in the specified system RDDS. | Note: When processing a DBD for IMS Catalog, the lines for | SYSRDDS are not shown. NSYSRDDS DB DEF Whether a database definition that corresponds to the DBD is found in the specified non-system RDDS. | Note: When processing a DBD for IMS Catalog, the lines for | NSYSRDDS are not shown. -------------------------------------------------------------- 4.6.2.2 PSB Check report -------------------------------------------------------------- The following notes are added: MODBLKS PSB DEF Whether a database definition that corresponds to the PSB is found in the specified MODBLKS module. | Note: When processing a PSB for IMS Catalog, the lines for | MODBLKS are not shown. SYSRDDS PSB DEF Whether a database definition that corresponds to the PSB is found in the specified system RDDS. | Note: When processing a PSB for IMS Catalog, the lines for | SYSRDDS are not shown. NSYSRDDS PSB DEF Whether a database definition that corresponds to the PSB is found in the specified non-system RDDS. | Note: When processing a PSB for IMS Catalog, the lines for | NSYSRDDS are not shown. -------------------------------------------------------------- 5.0 DBD/PSB/ACB Compare utility 5.5 Control statements for DBD/PSB/ACB Compare -------------------------------------------------------------- The following parameter is added to NOCOMP=: | CATALOG | This parameter indicates that the metadata fields in DBD, | PSB or ACB are not compared. | Note: The metadata fields are compared when all of the | following conditions met: | - NOCOMP=CATALOG is not specified. | - NOCOMP=IMSREL is not specified. Or even if | specified, both of the members are IMS V12 or later. The following columns are added to Table 5. +--------+-------+-----------------+--------------------+ |Function|Section|Field description|Added or removed | +--------+-------+-----------------+--------------------+ |DBD | : | : | : | |compare | : | : | : | || +-------+-----------------+--------------------+ || |DXVECT |Metadata |Added by IMS Version| || |DXDENT |information |12 (see note) | || |DXDRET |for DBD | | || |DXSENT | | | || |DXSEXT | | | || |DXSRET | | | || |DXFDTT | | | || |DXFDOT | | | || |DXFXTT | | | || |DXFRDT | | | || |DXFRET | | | || |DXFPAT | | | || |DXFCIT | | | || |DXFCAT | | | || |DXFCRT | | | || |DXFMDT | | | || |DXFMNT | | | || |DXFMRT | | | || |DXFSAT | | | || |DXMENT | | | || |DXMPAT | | | || |DXMOVT | | | || |DXMITT | | | || |DXMUTT | | | || |DXMPOT | | | || |DXMPOE | | | || |DXMURT | | | || |DXMRET | | | || |DXLRET | | | || |DXXRET | | | || |DXTRET | | | || |DXARET | | | || |DXFEXT | | | || |DXDRET | | | || +-------+-----------------+--------------------+ || |EXITTB |NODLET OPTION |Added by IMS Version| || | |(Y/N) |12 | || +-------+-----------------+--------------------+ || |EXITTB |NO BEFORE OPTION |Added by IMS Version| || | |(Y/N) |12 | +--------+-------+-----------------+--------------------+ |PSB | : | : | : | |compare | : | : | : | || +-------+-----------------+--------------------+ || |PXVECT |Metadata |Added by IMS Version| || |PXPCRT |information |12 (see note) | || |PXPCXT |for PSB | | || |PXSSRT | | | || |PXSFRT | | | || |PXPSRT | | | +--------+-------+-----------------+--------------------+ |Note: When both libraries to be compared were generated| || by IMS Version which the fields were added or | | later, the fields are compared even if | | NOCOMP=IMSREL is specified. | +-------------------------------------------------------+ -------------------------------------------------------------- 5.7 Output from DBD/PSB/ACB Compare 5.7.2 SYSPRINT data set 5.7.2.1 Block level compare reports -------------------------------------------------------------- The following columns are added in the Table 7. +--------------------+---------------------+ |Section |Description | +--------------------+---------------------+ | : | : | +--------------------+---------------------+ ||INDXMP PSL(exitname)|Contains FPSI | || |Partition selection | || |exit information | |+--------------------+---------------------+ ||DXVECT |Contains the metadata| ||DXDENT |information for DBD | ||DXDRET | | ||DXSENT SEG(segname) | | ||DXSEXT SEG(segname) | | ||DXSRET | | ||DXFDTT | | ||DXFDOT | | ||DXFXTT | | ||DXFRDT | | ||DXFRET | | ||DXFPAT | | ||DXFCIT | | ||DXFCAT | | ||DXFCRT | | ||DXFMDT | | ||DXFMNT | | ||DXFMRT | | ||DXFSAT | | ||DXMENT | | ||DXMPAT | | ||DXMOVT | | ||DXMITT | | ||DXMUTT | | ||DXMPOT | | ||DXMPOE | | ||DXMURT | | ||DXMRET | | ||DXLRET | | ||DXXRET | | ||DXTRET | | ||DXARET | | ||DXFEXT FLD(fldname) | | ||DXDRET | | +--------------------+---------------------+ |DBDGEN | ... | +------------------------------------------+ The following columns are added in the Table 8. +-------------------+---------------------+ |Section |Description | +-------------------+---------------------+ | : | : | +-------------------+---------------------+ ||PXVECT |Contains the metadata| ||PXPCRT |information for PSB | ||PXPCXT | | ||PXSSRT | | ||PXSFRT | | ||PXPSRT | | +-------------------+---------------------+ |PSBGEN | ... | +-----------------------------------------+ The following columns are added in the Table 9. +-------------------+---------------------+ |Section |Description | +-------------------+---------------------+ | : | : | +-------------------+---------------------+ |BHDR DBD ... | : | +-------------------+---------------------+ ||see Table 7 |Contains the metadata| || |information for DBD | |+-------------------+---------------------+ ||see Table 8 |Contains the metadata| || |information for PSB | +-------------------+---------------------+
APAR Information
APAR number
PM68396
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-07-08
Closed date
2012-07-30
Last modified date
2012-09-05
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK80687
Modules/Macros
FABLACBC FABLADPL FABLADP0 FABLAPI0 FABLAPSC FABLCMPD FABLCMPP FABLCMPR FABLCOMP FABLDBDT FABLDBD0 FABLDMBC FABLEACB FABLECHK FABLECTL FABLEDBD FABLEPCC FABLEPSB FABLLINK FABLLOAD FABLPRTS FABLPSBT FABLPSB0 FABLREAD FABLVCTC FABLVCT0 FABMAMAP FABMDMAP FABMPMAP FABNACB0 FABNCNTL FABNCODE FABNCPUT FABNCTG0 FABNDBD0 FABNDBLC FABNDCNC FABNDCOD FABNDCTL FABNDCVC FABNDDN0 FABNDEDB FABNDIR0 FABNDMBC FABNDSG0 FABNDUMP FABNEXCL FABNGSAM FABNINDX FABNLCH0 FABNLOG0 FABNMSDB FABNOPEN FABNPARM FABNPBLC FABNPCNC FABNPCTL FABNPDBD FABNPPCB FABNPPSB FABNREAC FABNREAD FABNSDBD FABNSPSB FABNSREF FABNSTAE FABNTSRT FABNXREF H27P210J
| SC19247901 |
Fix information
Fixed component name
IMS LIBR INTEG
Fixed component ID
5655I4200
Applicable component levels
R210 PSY UK80687
UP12/08/07 P F208
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":"SSCX89N","label":"IMS Library Integrity Utilities"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"2.1.0"}]
Document Information
Modified date:
14 December 2020