DBD Definition report
The DBD Definition report contains information about ACBLIB that the command process used.
This report is generated by the following commands:
- ANALYZE
- CHANGE
- DMACPRT
- EXTRACT
- INDEXBLD
- INITIALIZE
- UNLOAD
- RELOAD
- REORG
- TUNE
This report is not printed if you make one of the following specifications:
- GLOBAL SCAN=SITE_CREATE
- GLOBAL SCAN=SITE_REPORT
The following figure is a sample of the DBD Definition report for Unload when only IMSACB is specified.
IMS HPFP UTILITIES - FPA UNLOAD "DBD definition report" PAGE: 1
5698-FPP V2R1 2021-11-22 17:00:06
- ACBLIB : IMSACB
- ACB DSNAME : IMSVS.ACBLIB
- DBD NAME : DEDBJN23
- RANDOMIZER : RMOD4
- IMS LEVEL : VERSION 14 RELEASE 1
DB LARGEST INFO: CI-SIZE UOW-1 NO(RAP'S/UOW) UOW-2 SEG-LEN
------- ------ ------------- ------ -------
28,672 15 14 8 900
AREA:
TOTAL CI'S SDEP START
AREA AREA CI-SIZE UOW= ROOT= ------------------------------------------ -------------------
NO. NAME BASE DOVF IOVF TOTAL BLOCK# RBA(HEX)
----- -------- ------- ------------- --------------- --------- --------- --------- --------- --------- --------
1 DB23AR0 1,024 (15,1) (6,2) 56 4 29 89 - -
2 DB23AR1 2,048 (3,1) (2,1) 2 1 2 5 - -
3 DB23AR2 2,048 (15,1) (5,1) 56 4 14 74 - -
4 DB23AR3 2,048 (15,1) (5,1) 56 4 14 74 - -
5 DB23AR4 1,024 (12,8) (14,6) 32 64 71 167 - -
6 DB23AR5 8,192 (10,4) (3,1) 12 8 9 29 - -
7 DB23AR6 28,672 (2,1) (2,1) 1 1 1 3 - -
8 DB23AR7 2,048 (3,1) (2,1) 2 1 2 5 - -
SEGMENT:
+----------------------------------------------------------------------+
| LEGEND FOR SEGMENT INFORMATION |
+----------------------------------------------------------------------+
| R: ROOT SEGMENT D: DDEP SEGMENT S: SDEP SEGMENT |
| F: FIXED LENGTH V: VARIABLE LENGTH I: COMP INIT Y: PCL DEFINED |
+----------------------------------------------------------------------+
PARENT LENGTH KEY COMP-RTN
SEG. SEG. HIER PARENT TYPE FIX|VAR ------- -------------- -------- -------------- SEC.
CODE NAME LVL S.CODE PCL SSP MAX MIN OFF LEN NAME INIT IDX
----- -------- ----- ------ ---- ------- --- --- ------ ------ --- --- -------- ---- ----
1 ROOTSEG1 1 - R V - - 900 20 2 8 - - 6
2 DD1 2 1 D V - - 900 20 2 10 - - 13
3 DD2 2 1 D V - - 900 20 2 10 - - -
4 DD3 2 1 D V - - 900 20 2 10 - - 1
5 DD4 2 1 D V - - 900 20 2 10 - - -
6 DD43 3 5 D V - - 900 20 2 10 - - -
7 DD44 4 6 D V - - 900 20 2 10 - - -
8 DD45 5 7 D V - - 900 20 2 10 - - -
9 DD46 6 8 D V - - 900 20 2 10 - - -
10 DD47 7 9 D V - - 900 20 2 10 - - -
11 DD48 8 10 D V - - 900 20 2 10 - - -
12 DD49 9 11 D V - - 900 20 2 10 - - -
13 DD410 10 12 D V - - 900 20 2 10 - - 8
14 DD411 11 13 D V - - 900 20 2 10 - - -
15 DD412 12 14 D V - - 900 20 2 10 - - -
The following figure is a sample of the DBD Definition report for Unload when IMSACB is specified together with the IMSACB DD and the NEWACB DD statements.
IMS HPFP UTILITIES - FPA UNLOAD "DBD definition report" PAGE: 1
5698-FPP V2R1 2021-11-22 17:00:06
- ACBLIB : IMSACB
- ACB DSNAME : IMSVS.ACBLIB
- DBD NAME : DEDBJN22
- RANDOMIZER : RMOD5
- IMS LEVEL : VERSION 14 RELEASE 1
DEDB DEFINITION DIFFERENCE DETECTED. *: DIFFERENCE &: SEVERE DIFFERENCE
DB LARGEST INFO: CI-SIZE UOW-1 NO(RAP'S/UOW) UOW-2 SEG-LEN
------- ------ ------------- ------ -------
2,048 13 10 3 900
AREA:
TOTAL CI'S SDEP START
AREA AREA CI-SIZE UOW= ROOT= ------------------------------------------ -------------------
NO. NAME BASE DOVF IOVF TOTAL BLOCK# RBA(HEX)
----- -------- ------- ------------- --------------- --------- --------- --------- --------- --------- --------
1 DB22AR0 1,024 (5,1) (5,1) 16 4 4 24 32 00008000
2 DB22AR1 2,048 (5,1) (5,1) 16 4 4 24 32 00010000
3 DB22AR2 1,024 (13,3) (15,3) 120 36 38 194 210 00034800
4 DB22AR3 1,024 (10,2) (10,2) 64 16 19 99 112 0001C000
5 DB22AR4 2,048 (10,2) (10,2) 64 16 19 99 112 00038000
SEGMENT:
+----------------------------------------------------------------------+
| LEGEND FOR SEGMENT INFORMATION |
+----------------------------------------------------------------------+
| R: ROOT SEGMENT D: DDEP SEGMENT S: SDEP SEGMENT |
| F: FIXED LENGTH V: VARIABLE LENGTH I: COMP INIT Y: PCL DEFINED |
+----------------------------------------------------------------------+
PARENT LENGTH KEY COMP-RTN
SEG. SEG. HIER PARENT TYPE FIX|VAR ------- -------------- -------- -------------- SEC.
CODE NAME LVL S.CODE PCL SSP MAX MIN OFF LEN NAME INIT IDX
----- -------- ----- ------ ---- ------- --- --- ------ ------ --- --- -------- ---- ----
==> 1 ROOTSEG1 1 - R V - - 900 20 2 6 * - - 6
2 SDSEGNM1 2 1 S V - - 900 20 - - - - -
3 DD1 2 1 D V - - 900 20 2 7 - - 13
4 DD2 2 1 D V - - 900 20 2 7 - - 1
5 DD3 2 1 D V - - 900 20 - - - - -
6 DD4 2 1 D V - - 900 20 2 7 - - -
7 DD43 3 6 D V - - 900 20 2 7 - - -
8 DD44 4 7 D V - - 900 20 2 7 - - -
9 DD45 5 8 D V - - 900 20 2 7 - - -
10 DD46 6 9 D V - - 900 20 2 7 - - -
11 DD47 7 10 D V - - 900 20 2 7 - - -
12 DD48 8 11 D V - - 900 20 2 7 - - -
13 DD49 9 12 D V - - 900 20 2 7 - - -
14 DD410 10 13 D V - - 900 20 2 7 - - 8
15 DD411 11 14 D V - - 900 20 2 7 - - -
16 DD412 12 15 D V - - 900 20 2 7 - - -The following figure is a sample of the DBD Definition report for Unload when NEWACB is specified together with the IMSACB DD and the NEWACB DD statements.
IMS HPFP UTILITIES - FPA UNLOAD "DBD definition report" PAGE: 1
5698-FPP V2R1 2021-11-22 17:00:06
- ACBLIB : NEWACB
- ACB DSNAME : IMSVS.NEWACB
- DBD NAME : DEDBJN22
- RANDOMIZER : RMOD5
- IMS LEVEL : VERSION 14 RELEASE 1
DEDB DEFINITION DIFFERENCE DETECTED. *: DIFFERENCE &: SEVERE DIFFERENCE
DB LARGEST INFO: CI-SIZE UOW-1 NO(RAP'S/UOW) UOW-2 SEG-LEN
------- ------ ------------- ------ -------
2,048 13 10 3 900
AREA:
TOTAL CI'S SDEP START
AREA AREA CI-SIZE UOW= ROOT= ------------------------------------------ -------------------
NO. NAME BASE DOVF IOVF TOTAL BLOCK# RBA(HEX)
----- -------- ------- ------------- --------------- --------- --------- --------- --------- --------- --------
1 DB22AR0 1,024 (5,1) (5,1) 16 4 4 24 32 00008000
2 DB22AR1 2,048 (5,1) (5,1) 16 4 4 24 32 00010000
3 DB22AR2 1,024 (13,3) (15,3) 120 36 38 194 210 00034800
4 DB22AR3 1,024 (10,2) (10,2) 64 16 19 99 112 0001C000
5 DB22AR4 2,048 (10,2) (10,2) 64 16 19 99 112 00038000
SEGMENT:
+----------------------------------------------------------------------+
| LEGEND FOR SEGMENT INFORMATION |
+----------------------------------------------------------------------+
| R: ROOT SEGMENT D: DDEP SEGMENT S: SDEP SEGMENT |
| F: FIXED LENGTH V: VARIABLE LENGTH I: COMP INIT Y: PCL DEFINED |
+----------------------------------------------------------------------+
PARENT LENGTH KEY COMP-RTN
SEG. SEG. HIER PARENT TYPE FIX|VAR ------- -------------- -------- -------------- SEC.
CODE NAME LVL S.CODE PCL SSP MAX MIN OFF LEN NAME INIT IDX
----- -------- ----- ------ ---- ------- --- --- ------ ------ --- --- -------- ---- ----
==> 1 ROOTSEG1 1 - R V - - 900 20 2 6 DFSCMPX0* - 6
2 SDSEGNM1 2 1 S V - - 900 20 - - - - -
3 DD1 2 1 D V - - 900 20 2 7 - - 13
4 DD2 2 1 D V - - 900 20 2 7 - - 1
5 DD3 2 1 D V - - 900 20 - - - - -
6 DD4 2 1 D V - - 900 20 2 7 - - -
7 DD43 3 6 D V - - 900 20 2 7 - - -
8 DD44 4 7 D V - - 900 20 2 7 - - -
9 DD45 5 8 D V - - 900 20 2 7 - - -
10 DD46 6 9 D V - - 900 20 2 7 - - -
11 DD47 7 10 D V - - 900 20 2 7 - - -
12 DD48 8 11 D V - - 900 20 2 7 - - -
13 DD49 9 12 D V - - 900 20 2 7 - - -
14 DD410 10 13 D V - - 900 20 2 7 - - 8
15 DD411 11 14 D V - - 900 20 2 7 - - -
16 DD412 12 15 D V - - 900 20 2 7 - - -
The following figures show samples of the DBD Definition reports that are generated by the Reload function. These reports are generated when DBD information inconsistencies are detected between the library that is specified on the IMSACB DD statement and the USR files that were created during the Unload process.
When inconsistencies
are detected, two DBD Definition reports are generated:
- DBD Definition report that contains DBD information in IMSACB
- DBD Definition report that contains DBD information in the USR file in which the first inconsistency was detected
The ampersand (&) character is shown after an item whenever a difference is found.
The following figure shows sample DBD Definition report that contains the DBD information in IMSACB.
IMS HPFP UTILITIES - FPA RELOAD "DBD definition report" PAGE: 1
5698-FPP V2R1 2021-11-22 18:08:02
- ACBLIB : IMSACB
- ACB DSNAME : FPTL02.DBTJIE1.IMS14.DB12.ACBLIB4
- DBD NAME : DEDBJN23
- RANDOMIZER : RMODTS2
- IMS LEVEL : VERSION 14 RELEASE 1
DEDB DEFINITION SEVERE DIFFERENCE DETECTED. *: DIFFERENCE &: SEVERE DIFFERENCE
DB LARGEST INFO: CI-SIZE UOW-1 NO(RAP'S/UOW) UOW-2 SEG-LEN
------- ------ ------------- ------ -------
28,672 5 3 2 900
AREA:
TOTAL CI'S SDEP START
AREA AREA CI-SIZE UOW= ROOT= ------------------------------------------ -------------------
NO. NAME BASE DOVF IOVF TOTAL BLOCK# RBA(HEX)
----- -------- ------- ------------- --------------- --------- --------- --------- --------- --------- --------
1 DB23AR1 2,048 (5,2) (14,4) 30 20 19 69 77 00026800
2 DB23AR2 1,024 (2,1) (16,4) 12 12 7 31 36 00009000
==> 3 DB23AR8& 4,096 (4,1) (8,4) 12 4 15 31 38 00026000
4 DB23AR4 8,192 (2,1) (2,1) 1 1 1 3 8 00010000
5 DB23AR5 28,672 (2,1) (2,1) 1 1 1 3 8 00038000
SEGMENT:
+----------------------------------------------------------------------+
| LEGEND FOR SEGMENT INFORMATION |
+----------------------------------------------------------------------+
| R: ROOT SEGMENT D: DDEP SEGMENT S: SDEP SEGMENT |
| F: FIXED LENGTH V: VARIABLE LENGTH I: COMP INIT Y: PCL DEFINED |
+----------------------------------------------------------------------+
PARENT LENGTH KEY COMP-RTN
SEG. SEG. HIER PARENT TYPE FIX|VAR ------- -------------- -------- --------------
CODE NAME LVL S.CODE PCL SSP MAX MIN OFF LEN NAME INIT
----- -------- ----- ------ ---- ------- --- --- ------ ------ --- --- -------- ----
1 ROOTSEG1 1 - R V - - 900 100 2 10 - -
2 SDEPSEG1 2 1 S V - - 800 20 - - - -
==> 3 DD1 2 1 D V - - 800 80 -& - - -
4 DD11 3 3 D F - 8 128 128 - - - -
==> 5 DD2 2 1 D V Y - 600 60 3& 5& DFSCMPX0 I
6 DD21 3 5 D V Y 8 400 40 - - DFSCMPX0 I
==> 7 DD21A& 4 6 D V Y - 200 40 - - - -
8 DD212 4 6 D V Y - 200 40 - - - -
==> 9 DD2121 5 8 D V Y - 200 40 2& 3 - -The following figure shows sample DBD Definition report that contains the DBD information in the USR file in which the first inconsistency was detected.
IMS HPFP UTILITIES - FPA RELOAD "DBD definition report" PAGE: 1
5698-FPP V2R1 2021-11-22 18:08:02
- ACBLIB : IAREA001
- ACB DSNAME : FPTL02.DBTJIE1.IMS14.DB12.ACBLIB
- DBD NAME : DEDBJN23
- RANDOMIZER : RMODTS2
- IMS LEVEL : VERSION 14 RELEASE 1
DEDB DEFINITION SEVERE DIFFERENCE DETECTED. *: DIFFERENCE &: SEVERE DIFFERENCE
DB LARGEST INFO: CI-SIZE UOW-1 NO(RAP'S/UOW) UOW-2 SEG-LEN
------- ------ ------------- ------ -------
28,672 5 3 2 900
AREA:
TOTAL CI'S SDEP START
AREA AREA CI-SIZE UOW= ROOT= ------------------------------------------ -------------------
NO. NAME BASE DOVF IOVF TOTAL BLOCK# RBA(HEX)
----- -------- ------- ------------- --------------- --------- --------- --------- --------- --------- --------
1 DB23AR1 2,048 (5,2) (14,4) 30 20 19 69 77 00026800
2 DB23AR2 1,024 (2,1) (16,4) 12 12 7 31 36 00009000
==> 3 DB23AR3& 4,096 (4,1) (8,4) 12 4 15 31 38 00026000
4 DB23AR4 8,192 (2,1) (2,1) 1 1 1 3 8 00010000
5 DB23AR5 28,672 (2,1) (2,1) 1 1 1 3 8 00038000
SEGMENT:
+----------------------------------------------------------------------+
| LEGEND FOR SEGMENT INFORMATION |
+----------------------------------------------------------------------+
| R: ROOT SEGMENT D: DDEP SEGMENT S: SDEP SEGMENT |
| F: FIXED LENGTH V: VARIABLE LENGTH I: COMP INIT Y: PCL DEFINED |
+----------------------------------------------------------------------+
PARENT LENGTH KEY COMP-RTN
SEG. SEG. HIER PARENT TYPE FIX|VAR ------- -------------- -------- --------------
CODE NAME LVL S.CODE PCL SSP MAX MIN OFF LEN NAME INIT
----- -------- ----- ------ ---- ------- --- --- ------ ------ --- --- -------- ----
1 ROOTSEG1 1 - R V - - 900 100 2 10 - -
2 SDEPSEG1 2 1 S V - - 800 20 - - - -
==> 3 DD1 2 1 D V - - 800 80 2& 3 - -
4 DD11 3 3 D F - 8 128 128 - - - -
==> 5 DD2 2 1 D V Y - 600 60 2& 3& DFSCMPX0 I
6 DD21 3 5 D V Y 8 400 40 - - DFSCMPX0 I
==> 7 DD211& 4 6 D V Y - 200 40 - - - -
8 DD212 4 6 D V Y - 200 40 - - - -
==> 9 DD2121 5 8 D V Y - 200 40 -& - - -- ACBLIB
- The name of the ACBLIB DD statement.
In the DBD Definition reports that indicate the inconsistencies in the USR files, the DD name for the USR file is printed in this field.
When IMSCATHLQ=bsdshlq and IMSCATACB_INPUT=CURRENT is specified,
IMS CATALOG (CURRENT)is printed in this field. When IMSCATHLQ=bsdshlq and IMSCATACB_INPUT=PENDING is specified,IMS CATALOG (PENDING)is printed in this field. - ACB DSNAME
- The name of the ACBLIB data set specified by the acblib
DD statement. The data set has the DBD definition. This field is printed when IMSCATHLQ=*NO is
specified.
In the DBD Definition reports that indicate the inconsistencies in the USR files, the name of the ACBLIB data set that is stored in the corresponding USR file is printed in this field.
- IMSCATHLQ
- The high-level qualifier of the bootstrap data set of the IMS directory. This field is printed when IMSCATHLQ=bsdshlq is specified.
- DBD NAME
- The name of the DBD to be reported.
- RANDOMIZER
- The name of the randomizing module.
- IMS LEVEL
- The IMS level of the source data set from which the DBD definition information was reported.
- DB LARGEST INFO
- The largest value of the areas in the DBD as follows:
- CI-SIZE is the largest CI size of areas in the DBD.
- UOW-1 is the largest number of CIs per UOW of areas in the DBD.
- NO(RAP'S/UOW) is the largest number of RAP CIs per UOW of areas in the DBD.
- UOW-2 is the largest number of DOVF CIs per UOW of areas in the DBD.
- SEG-LEN is the largest length of segments of areas in the DBD.
- AREA NO
- The area number.
- AREA NAME
- The area name.
- CI-SIZE
- The CI size of the area.
- UOW=
- The UOW= parameter value for the area that is defined in the DBD.
- ROOT=
- The ROOT= parameter value for the area that is defined in the DBD.
- TOTAL CI'S BASE
- The total number of BASE CIs for the area that is defined in the DBD.
- TOTAL CI'S DOVF
- The total number of DOVF CIs for the area that is defined in the DBD.
- TOTAL CI'S IOVF
- The total number of IOVF CIs for the area that is defined in the DBD. IOVF bitmap CIs are not included.
- TOTAL CI'S TOTAL
- The total number of CIs for the area that is defined in the DBD. The first, second, IOVF bitmap, work UOW, and SDEP part CIs are not included.
- SDEP START BLOCK#
- The first block number of CI in the SDEP part of the area.
- SDEP START RBA (HEX)
- The hexadecimal value of the first CI in the SDEP part of the area.
- SEG.CODE
- The segment code.
- SEG.NAME
- The segment name.
- HIER LVL
- The hierarchical level of the segment.
- PARENT S.CODE
- The parent segment code of the segment.
- TYPE
- The type of the segment as follows:
- R is the root segment.
- S is the sequential dependent segment.
- D is the direct dependent segment.
- FIX|VAR
- The attribute of the segment as follows:
- F is the fixed-length segment.
- V is the variable-length segment.
- PARENT PCL
- Indicates whether the parent of the segment has a PCL pointer. Y means that the parent of the segment has a PCL pointer.
- PARENT SSP
- Indicates the number of subset pointers that the parent of the segment has, if any are defined.
- LENGTH MAX
- The maximum length of the segment that is defined in the DBD.
- LENGTH MIN
- The minimum length of the segment that is defined in the DBD.
- KEY OFF
- The offset of the key field of the segment, if one is defined.
- KEY LEN
- The key length of the segment, if one is defined.
- COMP-RTN NAME
- The name of the segment edit/compression exit routine of the segment, if one is defined.
- COMP-RTN INIT
- Tells whether COMPRTN= INIT subparameter has been defined in the
DBD.
I: The COMPRTN= INIT subparameter has been defined. - SEC. IDX
- The number of secondary index databases in which the segment is defined as a target segment.
In this example, both IMSACB and NEWACB are specified, and the DBD members are different in Unload processing. Two DBD Definition reports are reported, which show the differences among them marked with '*'. When there is a severe difference, this report shows the difference with '&', and processing stops.