Block-level compare reports

The block-level compare reports contain comparison results for two DBDs, PSBs, or ACBs.

Subsections:

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)
DXDRET
 Metadata 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
PXPSRT
 Metadata 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
ACB Compare reports also contain metadata information for DBDs and PSBs. For those sections, see Table 1 and Table 2.
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.

Note: Any comparison of two variable-length fields in the IMS control blocks is based on the field length of the LIBRARY 1 block. If any difference is found, DBD/PSB/ACB Compare reports it in full length, using one or more lines in the LIBRARY 1 and LIBRARY 2 fields.

Sample report: Block-level compare report for DBDs

The following figure shows an example of the DBD Compare report.

Figure 1. DBD Compare report
IMS LIBRARY INTEGRITY UTILITIES - DBD/PSB/ACB COMPARE            "DBD COMPARE REPORT"                                    PAGE:     1
5655-U08                                                   DATE: 10/01/2021 TIME: 09.21.45                          FABLDBD0 - V2.R2
 
TYPE      : DBD
NAME      : DSFACHON
LIBRARY 1 : VOLUME=IMSVS   DSNAME=IMSVS.DBDLIB
LIBRARY 2 : VOLUME=IMSVS   DSNAME=IMSVS.TEST.DBDLIB 
 
LIBRARY1  LIBRARY2   SECTIONS WHICH ARE DIFFERENT                      DIFFERENCE DESCRIPTION
--------  --------   ------------------------------------------------  ----------------------------------------------------------
NO        YES        PRFX   DB (DSFACHON)                              HIDAM OSAM
YES       NO         PRFX   DB (DSFACHON)                              HIDAM VSAM
DSFACH00  DSFACHO0   PRFX   DSG(DSFACH00)                              INPUT DD NAME/MSDB SEQUENCD FIELD NAME
3380      3350       PRFX   DSG(DSFACH00)                              DEVICE TYPE OR RESERVED FIELD
      57        52   PRFX   DSG(DSFACH00)                              LONGEST SEGMENT LENGTH
    2041         0   PRFX   DSG(DSFACH00)                              LOGICAL RECORD LENGTH
    2048      1690   PRFX   DSG(DSFACH00)                              BLOCK/CI SIZE
    2041         0   PRFX   DSG(DSFACH00)                              OVERFLOW/OUTPUT LOGICAL RECORD LENGTH
    2048      1690   PRFX   DSG(DSFACH00)                              OVERFLOW/OUTPUT BLOCK/CI SIZE
      35        30   SEGTAB SEG(SSFACP00)                              DATA LEN - SEGM LEN FOR FIXED LEN SEGMS
ETEANA00  ETEANAME   FLDTAB SEG(SSFACP00) FLD(ETEANA00)                FIELD/XDFLD NAME
NO        YES        INDXTB                                            INDEX POINTER IS SYMBOLIC
The records in the figure have the following meanings:
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.

Figure 2. PSB Compare report
IMS LIBRARY INTEGRITY UTILITIES - DBD/PSB/ACB COMPARE            "PSB COMPARE REPORT"                                    PAGE:     1
5655-U08                                                   DATE: 10/01/2021 TIME: 09.21.45                          FABLPSB0 - V2.R2
 
TYPE      : PSB
NAME      : PSBSMUUL
LIBRARY 1 : VOLUME=IMSVS   DSNAME=IMSVS.PSBLIB
LIBRARY 2 : VOLUME=IMSVS   DSNAME=IMSVS.TEST.PSBLIB 
 
LIBRARY1  LIBRARY2   SECTIONS WHICH ARE DIFFERENT                      DIFFERENCE DESCRIPTION
--------  --------   ------------------------------------------------  ----------------------------------------------------------
NO        YES        PRFX                                              APPLICATION PROGRAM IS ASSEMBLER, COBOL OR NOT SPECIFIED
YES       NO         PRFX                                              APPLICATION PROGRAM IS PL/I
GID       A          DBPCB  PCB(DSFACHON)                              PROCESSING OPTIONS
GID       A          SENSEG PCB(DSFACHON) SEG(SSFACP00)                SENSEG PROCOPT.
GID       A          SENSEG PCB(DSFACHON) SEG(SSFACP11)                SENSEG PROCOPT.
GID       A          SENSEG PCB(DSFACHON) SEG(SSFACP12)                SENSEG PROCOPT.
     140       160   SENSEG PCB(DSSTUIVN) SEG(SSSTUP11)                PARENT OFFSET IN SEGTBL.
SSSTUP12             SENSEG PCB(DSSTUIVN) SEG(SSSTUP12)                SENSEG NAME.
A                    SENSEG PCB(DSSTUIVN) SEG(SSSTUP12)                SENSEG PROCOPT.
     140             SENSEG PCB(DSSTUIVN) SEG(SSSTUP12)                PARENT OFFSET IN SEGTBL.
                     SENSEG PCB(DSSTUIVN) SEG(SSSTUP12)                SOURCE SEGMENT OFFSET.
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 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.

Figure 3. ACB Compare report
IMS LIBRARY INTEGRITY UTILITIES - DBD/PSB/ACB COMPARE            "ACB COMPARE REPORT"                                    PAGE:     1
5655-U08                                                   DATE: 10/01/2021 TIME: 09.21.45                          FABLACB0 - V2.R2 
 
TYPE      : ACB
NAME      : DSFACHON
LIBRARY 1 : VOLUME=IMSVS   DSNAME=IMSVS.ACBLIB
LIBRARY 2 : VOLUME=IMSVS   DSNAME=IMSVS.TEST.ACBLIB 
 
LIBRARY1  LIBRARY2   SECTIONS WHICH ARE DIFFERENT                      DIFFERENCE DESCRIPTION
--------  --------   ------------------------------------------------  ----------------------------------------------------------
     976      1088   PRFX                                              DMB SIZE IN BYTES
NO        YES        PRFX                                              HD INDEXED
YES       NO         PRFX                                              VSAM HIDAM
      57        52   AMPBPX                                            LENGTH OF LARGEST  SEGMENT IN DATASET
YES       NO         AMPB                                              ACCESS METHOD IS VSAM
YES       NO         AMPB                                              DATA SETS ARE PASSWORD PROTECTED
       0      1690   AMPB                                              OVERFLOW BLOCKSIZE
DSFACH00  DSFACHO0   AMPB                                              OVERFLOW DDNAME
      35        30   PSDB                                              DATA LENGTH OF THE SEGMENT
      35        30   PSDB                                              FOR VAR LENGTH SEG - MAX VALUE
The records in the figure have the following meaning:
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.

Figure 4. Another ACB Compare report
IMS LIBRARY INTEGRITY UTILITIES - DBD/PSB/ACB COMPARE            "ACB COMPARE REPORT"                                    PAGE:     1
5655-U08                                                   DATE: 10/01/2021 TIME: 09.21.45                          FABLACB0 - V2.R2
 
TYPE      : ACB
NAME      : PSBSMUUL
LIBRARY 1 : VOLUME=IMSVS   DSNAME=IMSVS.ACBLIB
LIBRARY 2 : VOLUME=IMSVS   DSNAME=IMSVS.TEST.ACBLIB 
 
LIBRARY1  LIBRARY2   SECTIONS WHICH ARE DIFFERENT                      DIFFERENCE DESCRIPTION
--------  --------   ------------------------------------------------  ----------------------------------------------------------
NO        YES        PRFX                                              APPLICATION PROGRAM IS ASSEMBLER, COBOL OR NOT SPECIFIED
YES       NO         PRFX                                              APPLICATION PROGRAM IS PL/I
GID       A          DBPCB  PCB(DSSCHHVN)                              PROCESSING OPTIONS
       3         4   DBPCB  PCB(DSSCHHVN)                              NO OF SENSITIVE SEGMTS IN PCB
NO        YES        SDB    SEG(SSSCHP00)                              SENSITIVITY IS REPLACE
000000F0  00000140   SDB    SEG(SSSCHP00)                              SDB LOGICALLY RELATED
NO        YES        SDB    SEG(SSSCHP11)                              SENSITIVITY IS REPLACE
00000140  00000190   SDB    SEG(SSSCHP11)                              SDB LOGICALLY RELATED
SSSCHP13  SSSCHP12   SDB    SEG(SSSCHP13)                              SEGMENT SYMBOLIC NAME
C8D7F1F3  C8D7F1F2   SDB    SEG(SSSCHP13)                              NEXT SEGMENT ON LOGICAL TWIN CHAIN
NO        YES        SDB    SEG(SSSCHP13)                              SENSITIVITY IS REPLACE
       0        80   SDB    SEG(SSSCHP13)                              OFFSET TO SIBLING OF SDB
00000190  000001E0   SDB    SEG(SSSCHP13)                              SDB LOGICALLY RELATED
YES       NO         SDB    SEG(SSSCHP13)                              SEGMENT HAS A PHYSICAL TWIN BKW
YES       NO         SDB    SEG(SSSCHP13)                              SEGMENT HAS A LOGICAL TWIN BKWD
YES       NO         SDB    SEG(SSSCHP13)                              SEGMENT HAS A LOGICAL PARENT PO
      06        04   SDB    SEG(SSSCHP13)                              POINTER NO IN PARENT TO FIRST OCCURANCE
      00        05   SDB    SEG(SSSCHP13)                              POINTER NO IN PARENT TO LAST  OCCURANCE
      13        02   SDB    SEG(SSSCHP13)                              EXECUTABLE KEY LEN OF KEY FIELD
      04        03   SDB    SEG(SSSCHP13)                              SEGMENT CODE
GID       A          DBPCB  PCB(DSSTUIVN)                              PROCESSING OPTIONS
NO        YES        SDB    SEG(SSSTUP00)                              SENSITIVITY IS REPLACE
NO        YES        SDB    SEG(SSSTUP11)                              SENSITIVITY IS REPLACE

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.