Block-level compare reports
The block-level compare reports contain comparison results for two DBDs, PSBs, or ACBs.
Report field description
The blocks in DBD/PSB/ACB in LIBRARY 1 are taken as the basis for the comparisons. If an entry of a table such as segment table (SEGTAB) and field table (FLDTAB) are found in either LIBRARY 1 or LIBRARY 2, all information contained in the entry is reported. If the entry is found only in LIBRARY 2, an asterisk (*) appears to the right of the contents of LIBRARY 2.
The headings of DBD, PSB, and ACB Compare reports contain the following items in common:
- TYPE
- Function type (DBD, PSB, or ACB) specified with the control statement.
- NAME
- Name of the member or members that were compared. When the compared members have different names, the second member name follows the first member name, separated by a colon.
- LIBRARY 1
- Data set name and volume serial number of the library that contains the member. Corresponds to DBDLIB, PSBLIB, or ACBLIB DD statements.
- LIBRARY 2
- Data set name and volume serial number of the library that contains the member. Corresponds to DBDLIB2, PSBLIB2, or ACBLIB2 DD statements.
- SECTIONS WHICH ARE DIFFERENT
- List of sections in which the differences were found.
DBD/PSB/ACB Compare compares two DBDs, PSBs, or ACBs that have the same name but are in different libraries. It also compares DBDs, PSBs, or ACBs that have different names and that are in the same library or in different libraries. In each pair, it compares the sections summarized in the following tables.
Table 1. Sections in DBD Compare reports Section Description DIR Information about the construction of the DBD control block PRFX DB (dbname) Database information PRFX DSG (ddname) Data set information PRFX DSG (dsg-num) Data set information for HALDB SEGTAB SEG (segname) Segment information CMPRTN SEG (segname) CMP (exitname) Compression exit information FLDTAB SEG (segname) FLD (fldname) Field information LCHLD LCH (lchname) Logical child information EXTDBD EXT (extdbnam) External DB information that is referred to by the DBD INDXTB Index information SSPTAB Subset pointer information about DEDB DBD SORTAB SEG (segname) Source segment information RDMRTN HDAM randomizing routine information about HDAM DBD (see note) DBDXTB DBD extensional information SEGXTB SEG (segname) Segment exit table information EXITTB SEG (segname) EXT (exitname) Exit name array information INDXMP PSL (exitname) FPSI Partition Selection exit information DXVECT
DXDENT
DXDRET
DXSENT SEG (segname)
DXSEXT SEG (segname)
DXSRET
DXFMCT
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)
DXDRETMetadata information for DBD DBDGEN IMS release level information. If the DBD was generated by IMS 3 or higher, the level is shown. CKTBL1 /CK search field information about DEDB DBD CKTBL2 /CK subsequence field information about DEDB DBD Note: The differences in this section are checked only if the RDMRTN section is customized. For details about customization, see the topic "HDAM and PHDAM randomizing routines (DFSHDC40)" in the IMS Exit Routines.Table 2. Sections in PSB Compare reports Section Description PRFX PSB attributes information TPPCB PCB (ltrmname) TP PCB information DBPCB PCB (dbname) DB PCB information GSPCB PCB (dbname) GSAM DB PCB information SENSEG PCB (dbname) SEG (segname) Sensitive segment information about DB PCB PSSPTB PCB (dbname) SEG (segname) Subset pointer information about DB PCB SENFLD PCB (dbname) SEG (segname) FLD (fldname) Sensitive field information about DB PCB REFTBL DB (dbname) DB information referred to by DB PCB or GSAM PCB PCBNAM NAM (pcbname) PCB name information specified in the PCB statement PXVECT
PXPCRT
PXPCXT
PXSSRT
PXSFRT
PXPSRTMetadata information for PSB PXXREF DB(dbname) DB information referred to by DB PCB PSBGEN IMS release level information. If the PSB was generated by IMS 3 or higher, the level is shown. Table 3. Sections in ACB Compare reports Section Description PRFX ACB attributes and database information TPPCB PCB (ltrmname) TP PCB information PCBNAM PCB (ltrmname) NAM (pcbname) PCB name information about TP PCB DBPCB PCB (dbname) DB PCB information DBPCBX PCB (dbname) DB PCB extensional information VERID PCB (dbname) Version ID information about the DBD that is referred to by DB PCB DMBXTB PCB (dbname) DMB extensional information about DEDB DMB referred to by DB PCB SEGXTB PCB (dbname) SEG (segname) Segment exit table information about DEDB DMB referred to by DB PCB EXITTB PCB (dbname) SEG (segname) EXT(exitname) Exit name array information about DEDB DMB referred to by DB PCB JCB PCB (pcbname) JOB control block information SDB SEG (segname) Sensitive segment information about DB PCB FSBLST Information related to sensitive field of DB PCB FSB FLD (fldname) Sensitive field information about DB PCB SPCB DB PCB information for DEDB DBD SMLT SEG (segname) Sensitive segment information about DB PCB for DEDB DBD RDMRTN HDAM randomizing routine information about HDAM DBD AMPBPX Prefix information about the Access Method Prefix Block AMPB Access Method Prefix Block information PSDB Physical Segment Descriptor Block information SECOND SEG (segname) Secondary list information FDB FLD (fldname) Field Description Block information DMBXTB DMB extensional information SEGXTB SEG (segname) Segment exit table information EXITTB SEG (segname) EXT (exitname) Exit name array information CPAC CMP (exitname) Compression exit information DMCB DBD (dbdname) DEDB Master Control Block information about DEDB DBD SDT SEG (segname) Segment information about DEDB DBD FDT SEG (segname) FLD (fldname) Field information about DEDB DBD MRMB DBD (dbdname) DEDB Randomizing Module Block information about DEDB DBD DMAC DBD (dbdname) DSG (areaname) DEDB AREA Control List information about DEDB DBD BHDR DBD (dbdname) FLD (fldname) Header information about MSDB DBD CRTE DEDB secondary index cross reference table entries information CRTEXD INDEX record partitioning information - DIFFERENCE DESCRIPTION
- Description of the field in which difference was found.
When differences are found between two control blocks after running DBD/PSB/ACB Compare, you can run DBD/PSB/ACB Mapper, or DBD/PSB/ACB Reversal to obtain more information about the control blocks.
Sample report: Block-level compare report for DBDs
The following figure shows an example of the DBD Compare report.
- 1st and 2nd records
- In the prefix section, different access methods are specified: HIDAM VSAM in LIBRARY 1, and HIDAM OSAM in LIBRARY 2.
- 3rd record
- In the prefix section, different DD names are specified: DSFACH00 in LIBRARY 1, and DSFACHO0 in LIBRARY 2.
- 10th record
- In segment SSFACP00 in the SEGTAB section, different segment lengths are specified: 35 in LIBRARY 1, and 30 in LIBRARY 2.
- 11th record
- In the FLDTAB section, different field names are specified for the ETEANA00 field of segment SSFACP00: ETEANA00 in LIBRARY 1, and ETEANAME in LIBRARY 2.
Sample report: Block-level compare report for PSBs
The following figure shows an example of the PSB Compare report.
- 1st and 2nd records
- In the prefix section, different application program languages are specified: PL/I in LIBRARY 1, and Assembler or COBOL in LIBRARY 2.
- 3rd record
- In the DBPCB section, different processing options are specified in the DSFACHON PCB: GID in LIBRARY 1, and A in LIBRARY 2.
- 4th through 6th records
- In the sensitive segments of DSFACHON in the SENSEG section, different processing options are specified: GID in LIBRARY 1, and A in LIBRARY 2.
Sample report: Block-level compare reports for ACBs
The following figure shows an example of the ACB Compare report.
- 2nd and 3rd records
- In the prefix section, different access methods are specified: HIDAM VSAM in LIBRARY 1, and HD INDEXED in LIBRARY 2.
- 4th record
- In the AMPBPX section, the lengths of largest segment in the data set are different: 57 in LIBRARY 1, and 52 in LIBRARY 2.
- 9th record
- In the PSDB section, the data lengths of the segment are different: 35 in LIBRARY 1, and 30 in LIBRARY 2.
The following figure shows another example for the ACB Compare report.
The records in the figure have the following meaning:
- 1st and 2nd records
- In the prefix section, different application program languages are specified: PL/I in LIBRARY 1, and Assembler or COBOL in LIBRARY 2.
- 3rd record
- In the DBPCB section, different processing options are specified in DSSCHHVN PCB: GID in LIBRARY 1, and A in LIBRARY 2.
- 4th record
- In the DBPCB section, different numbers of the sensitive segments in DSSCHHVN PCB are given: three in LIBRARY 1, and four in LIBRARY 2.