FABXCRP1 data set (Validate function)

The FABXCRP1 data set contains the FABXPPRM Echo Back report, the IMS Catalog Environment report, and the IMS Catalog Validation report.

FABXPPRM Echo Back report

This report contains an echo of the FABXPPRM parameters.

Figure 1. Example of the FABXPPRM Echo Back report
IMS LIBRARY INTEGRITY UTILITIES - CATALOG MANAGER                        "FABXPPRM ECHO BACK"                            PAGE:     1
5655-U08                                                   DATE: 04/05/2021  TIME: 20.04.44                         FABXCATM - V2.R2

"FABXPPRM STATEMENT"                                                                                                        

0........1.........2.........3.........4.........5.........6.........7.........8                                            
12345678901234567890123456789012345678901234567890123456789012345678901234567890                                            
DLI,FABXCAPL,DFSCP000,,,,,,,,,,,N,N,,,,,,,,,,,,DFSDF=RGN

IMS Catalog Environment report

This report contains environment information about the IMS system and the IMS catalog.

Figure 2. Example of the IMS Catalog Environment report
IMS LIBRARY INTEGRITY UTILITIES - CATALOG MANAGER                  "IMS CATALOG ENVIRONMENT REPORT"                      PAGE:     1
5655-U08                                                   DATE: 04/05/2021  TIME: 20.04.44                         FABXCATM - V2.R2

IMS ENVIRONMENT                                                                                                             

IMS ID                     :  SYS1                                                                                         
IMS VERSION                :  15.01.00                                                                                     

IMS CATALOG ENVIRONMENT                                                                                                     

DFSDF MEMBER NAME          :  DFSDFRGN                                                                                     
DFS3CDX0 ROUTINE           :  NO                                                                                           
ACB MANAGEMENT             :  ACBLIB                                                                                       

ALIAS OF CATALOG DB        :  DFSC                                                                                         
CATALOG HLQ                :  IMS.CATALOG
IMS DIRECTORY HLQ          :  IMS.CATALOG 

This report contains the following fields:

IMS ID
IMS ID.
IMS VERSION
IMS version. The utility, which can retrieve the IMS installed level of 15.2 or later, reports the IMS installed level instead of the IMS base level.
DFSDF MEMBER NAME
DFSDF PROCLIB member name. This field is blank if the DFS3CDX0 exit routine was used.
DFS3CDX0 ROUTINE
Whether the DFS3CDX0 exit routine was used. YES indicates that the DFS3CDX0 was used. Blank indicates that the DFSDF member was used.
ACB MANAGEMENT
The location from which the ACBs were loaded. The following locations are used:
CATALOG
ACBs were loaded from the IMS catalog.
ACBLIB
ACBs were loaded from the ACB libraries.
ALIAS OF CATALOG DB
The alias name of the IMS catalog database.
CATALOG HLQ
The high-level qualifier (HLQ) of the IMS catalog.
IMS DIRECTORY HLQ
The high-level qualifier of the IMS directory data sets. This field is blank if the IMS directory was not referred to in the job.

IMS Catalog Validation report

This report contains validation results for DBDs and PSBs. If ACBs were loaded from ACB libraries, the report contains validation results for the DBDs and PSBs in the ACB libraries and the IMS catalog. If ACBs were loaded from the IMS catalog, the report contains validation results for the DBDs and PSBs in the ACB libraries, the IMS catalog, and the IMS directory.

The following figure shows an example of the report when the IMS management of ACBs is not enabled.
Figure 3. Example of the IMS Catalog Validation report (ACB library and IMS catalog)
IMS LIBRARY INTEGRITY UTILITIES - CATALOG MANAGER                  "IMS CATALOG VALIDATION REPORT"                       PAGE:     1
5655-U08                                                   DATE: 06/13/2021  TIME: 01.25.31                         FABXCATM - V2.R2
                                                                                                                              
DBD                                                                                                                         
---                                                                                                                         
                    |------------ ACBLIB -------------|------------ CATALOG ------------|                                   
NAME     VALIDATION  DB VERSION ACBGEN TIMESTAMP       DB VERSION TIMESTAMP                                                 
         RESULT                                                                                                             
-------- ----------- ---------- ---------------------- ---------- ----------------------                                    
DBDXD70A VALID       0000000001 2021/03/03 20:59:27.31 0000000001 2021/03/03 20:59:27.31                                    
DBDXE70A VALID       0000004321 2021/03/03 20:59:27.31 0000004321 2021/03/03 20:59:27.31                                    
DBDXH70A VALID       0000000020 2021/03/03 20:59:27.31 0000000020 2021/03/03 20:59:27.31                                    
DBDXI03A INVALID     0000000000 2021/03/05 10:21:00.05 0000000000 2021/03/03 20:59:27.31                               
 
IMS LIBRARY INTEGRITY UTILITIES - CATALOG MANAGER                  "IMS CATALOG VALIDATION REPORT"                       PAGE:     2
5655-U08                                                   DATE: 06/13/2021  TIME: 01.25.31                         FABXCATM - V2.R2
                                                                                                                              
PSB                                                                                                                         
---                                                                                                                         
                    |------------ ACBLIB -------------|------------ CATALOG ------------|                                   
NAME     VALIDATION             ACBGEN TIMESTAMP                  TIMESTAMP                                                 
         RESULT                                                                                                             
-------- -----------            ----------------------            ----------------------                                    
PSBX010  VALID                  2021/03/03 20:59:27.31            2021/03/03 20:59:27.31                                    
PSBX013  INVALID                2021/03/05 10:21:00.05            2021/03/03 20:59:27.31                                 
PSBX020  VALID                  2021/03/03 20:59:27.31            2021/03/03 20:59:27.31                                    
PSBX030  VALID                  2021/03/03 20:59:27.31            2021/03/03 20:59:27.31  

The following figure shows an example of the report when the IMS management of ACBs is enabled. This example contains result of validating DBDs and PSBs in ACB libraries, IMS catalog, and IMS directory.

Figure 4. Example of the IMS Catalog Validation report (IMS directory, IMS catalog, and ACB library) (Part 1 of 2)
IMS LIBRARY INTEGRITY UTILITIES - CATALOG MANAGER                  "IMS CATALOG VALIDATION REPORT"                       PAGE:     1
5655-U08                                                   DATE: 06/19/2021  TIME: 03.48.39                         FABXCATM - V2.R2
                                                                                                                                    
DBD                                                                                                                               
---                                                                                                                               
                    |----------- DIRECTORY -----------|------------ CATALOG -------------|------------- ACBLIB -------------|     
NAME     VALIDATION  STATUS     TIMESTAMP              DB VERSION  TIMESTAMP              DB VERSION  ACBGEN TIMESTAMP            
         RESULT                                                                                                                   
-------- ----------- --------- ----------------------- ---------- ----------------------- ---------- -----------------------      
DBD#D01A VALID                                                                                                                    
                     STAGING    2021/03/03 21:00:34.51 0000000000  2021/03/03 21:00:34.51 0000000000  2021/03/03 21:00:34.51      
DBD#D03A INVALID                                                                                                                  
                     STAGING    2021/03/03 21:00:34.51 (DBD NOT EXIST)                    0000000000  2021/03/03 21:00:34.51      
DBD#D60A INVALID                                                                                                                  
                     ACTIVE     2021/02/27 19:37:00.16 0000000000  2021/02/27 19:37:00.16                                         
                     STAGING    2021/03/03 21:00:34.51 (INSTANCE NOT EXIST)               (DBD NOT EXIST)                         
DBD#D70A VALID                                                                                                                    
                     ACTIVE     2021/02/27 19:37:00.16 0000000001  2021/02/27 19:37:00.16                                         
                     STAGING    2021/03/03 21:00:34.51 0000000001  2021/03/03 21:00:34.51 0000000001  2021/03/03 21:00:34.51      
DBD#D80A INVALID                                                                                                                  
                     ACTIVE     2021/02/27 19:37:00.16 0000000000  2021/02/27 19:37:00.16                                         
                     STAGING    2021/03/03 21:00:34.51 (INSTANCE NOT EXIST)               0000000000  2021/03/03 21:00:34.51      
DBD#H01A INVALID                                                                                                                  
                     STAGING    2021/03/03 21:00:34.51 (INSTANCE NOT EXIST)               (DBD NOT EXIST)                         
DBD#H02A INVALID                                                                                                                  
                     STAGING    2021/03/03 21:00:34.51 (DBD NOT EXIST)                    (DBD NOT EXIST)                         
DBD#H60A INVALID                                                                                                                  
                     ACTIVE     2021/02/27 19:37:00.16 0000000000  2021/02/27 19:37:00.16                                         
                     STAGING    2021/03/03 21:00:34.51 (INSTANCE NOT EXIST)               (DBD NOT EXIST)                         
DBD#H70A VALID                                                                                                                    
                     ACTIVE     2021/02/27 19:37:00.16 0000004096  2021/02/27 19:37:00.16                                         
                     STAGING    2021/03/03 21:00:34.51 0000004096  2021/03/03 21:00:34.51 0000004096  2021/03/03 21:00:34.51      
DBD#H80A INVALID                                                                                                                  
                     ACTIVE     2021/02/27 19:37:00.16 0000000000  2021/02/27 19:37:00.16                                         
                     STAGING    2021/03/03 21:00:34.51 (INSTANCE NOT EXIST)               0000000000  2021/03/03 21:00:34.51      
DBD#X01A VALID                                                                                                                    
                     ACTIVE     2021/02/27 19:37:00.16 0000000000  2021/02/27 19:37:00.16                                         
                     STAGING    2021/03/03 21:00:34.51 0000000000  2021/03/03 21:00:34.51 0000000000  2021/03/03 21:00:34.51      
DBD#X02A VALID                                                                                                                    
                     ACTIVE     2021/02/27 19:37:00.16 0000000000  2021/02/27 19:37:00.16                                         
                     STAGING    2021/03/03 21:00:34.51 0000000000  2021/03/03 21:00:34.51 0000000000  2021/03/03 21:00:34.51      
DBD@G20V INVALID                                                                                                             
                     ACTIVE     2021/02/27 19:37:00.16 (INSTANCE NOT EXIST)                                                  
                     STAGING    2021/03/03 21:00:34.51 0000000000  2021/03/03 21:00:34.51 (GSAM)                            
DBD@X03A INVALID                                                                                                             
                     ACTIVE     2021/02/27 19:37:00.16 (INSTANCE NOT EXIST)                                                  
                     STAGING    2021/03/03 21:00:34.51 (INSTANCE NOT EXIST)               0000000000 *2021/02/27 19:37:00.16
 
                                                                                                        
 
Figure 5. Example of the IMS Catalog Validation report (IMS directory, IMS catalog, and ACB library) (Part 2 of 2)
IMS LIBRARY INTEGRITY UTILITIES - CATALOG MANAGER                  "IMS CATALOG VALIDATION REPORT"                       PAGE:     2
5655-U08                                                   DATE: 06/19/2021  TIME: 03.48.39                         FABXCATM - V2.R2
                                                                                                                                    
PSB                                                                                                                               
---                                                                                                                               
                    |----------- DIRECTORY -----------|------------ CATALOG -------------|------------- ACBLIB -------------|     
NAME     VALIDATION  STATUS     TIMESTAMP                          TIMESTAMP                          ACBGEN TIMESTAMP            
         RESULT                                                                                                                   
-------- ----------- --------- -----------------------            -----------------------            -----------------------      
DFSCPL00 VALID                                                                                                                    
                     ACTIVE     2021/02/27 19:37:01.86             2021/02/27 19:37:01.86             2021/02/27 19:37:01.86      
DFSCP000 VALID                                                                                                                    
                     ACTIVE     2021/02/27 19:37:01.86             2021/02/27 19:37:01.86             2021/02/27 19:37:01.86      
DFSCP001 VALID                                                                                                                    
                     ACTIVE     2021/02/27 19:37:01.86             2021/02/27 19:37:01.86             2021/02/27 19:37:01.86      
MAXPSB01 VALID                                                                                                                    
                     ACTIVE     2021/02/27 19:37:00.16             2021/02/27 19:37:00.16                                         
                     STAGING    2021/03/03 21:00:34.51             2021/03/03 21:00:34.51             2021/03/03 21:00:34.51      
MAXPSB02 VALID                                                                                                                    
                     ACTIVE     2021/02/27 19:37:00.16             2021/02/27 19:37:00.16                                         
                     STAGING    2021/03/03 21:00:34.51             2021/03/03 21:00:34.51             2021/03/03 21:00:34.51      
PSB#001  INVALID                                                                                                                  
                     -         (PSB NOT EXIST)                     2021/03/03 21:00:34.51             2021/03/03 21:00:34.51      
PSB#002  VALID                                                                                                                    
                     ACTIVE     2021/02/27 19:37:00.16             2021/02/27 19:37:00.16                                         
                     STAGING    2021/03/03 21:00:34.51             2021/03/03 21:00:34.51             2021/03/03 21:00:34.51      
PSB#009  VALID                                                                                                                    
                     ACTIVE     2021/02/27 19:37:00.16             2021/02/27 19:37:00.16                                         
                     STAGING    2021/03/03 21:00:34.51             2021/03/03 21:00:34.51             2021/03/03 21:00:34.51      
PSB#031  VALID                                                                                                                    
                     STAGING    2021/03/03 21:00:34.51             2021/03/03 21:00:34.51             2021/03/03 21:00:34.51      
PSB#032  VALID                                                                                                                    
                     STAGING    2021/03/03 21:00:34.51             2021/03/03 21:00:34.51             2021/03/03 21:00:34.51      
PSB#033  VALID                                                                                                                    
                     STAGING    2021/03/03 21:00:34.51             2021/03/03 21:00:34.51             2021/03/03 21:00:34.51      
PSB#600  INVALID                                                                                                                  
                     STAGING    2021/03/03 21:00:34.51 (PSB NOT EXIST)                                2021/03/03 21:00:34.51      
PSB#700  INVALID                                                                                                                  
                     STAGING    2021/03/03 21:00:34.51 (PSB NOT EXIST)                                2021/03/03 21:00:34.51      
PSB#800  INVALID                                                                                                                  
                     STAGING    2021/03/03 21:00:34.51 (PSB NOT EXIST)                                2021/03/03 21:00:34.51      
PSB@G10B INVALID                                                                                                                  
                     STAGING    2021/03/03 21:00:34.51 (PSB NOT EXIST)                    (PSB NOT EXIST)                         
PSB@G10V VALID                                                                                                                    
                     ACTIVE     2021/02/27 19:37:00.16             2021/02/27 19:37:00.16                                         
                     STAGING    2021/03/03 21:00:34.51             2021/03/03 21:00:34.51             2021/03/03 21:00:34.51     
PSB@600  INVALID                                                                                                             
                     ACTIVE     2021/02/27 19:37:00.16 (INSTANCE NOT EXIST)                                                  
                     STAGING    2021/03/03 21:00:34.51 (INSTANCE NOT EXIST)                          *2021/02/27 19:37:00.16
The following figure shows an example of the report when the IMS management of ACBs is enabled. This example contains result of validating DBDs and PSBs in IMS catalog, and IMS directory.
Figure 6. Example of the IMS Catalog Validation report (IMS directory and IMS catalog)
IMS LIBRARY INTEGRITY UTILITIES - CATALOG MANAGER                  "IMS CATALOG VALIDATION REPORT"                       PAGE:     1
5655-U08                                                   DATE: 06/15/2021  TIME: 02.09.27                         FABXCATM - V2.R2
                                                                                                                              
DBD                                                                                                                         
---                                                                                                                         
                    |----------- DIRECTORY -----------|------------ CATALOG -------------|                                  
NAME     VALIDATION  STATUS     TIMESTAMP              DB VERSION  TIMESTAMP                                                
         RESULT                                                                                                             
-------- ----------- --------- ----------------------- ---------- -----------------------                                   
DBD#D22A VALID                                                                                                              
                     ACTIVE     2021/03/05 01:01:33.65 0000000001  2021/03/05 01:01:33.65                                   
                     STAGING    2021/03/09 21:00:34.51 0000000002  2021/03/09 21:00:34.51
DBD#H35A VALID                                                                                                              
                     ACTIVE     2021/03/05 01:01:33.65 0000000020  2021/03/05 01:01:33.65
DBD#D85A INVALID                                                             
                     ACTIVE     2021/03/05 01:01:33.65 (INSTANCE NOT EXIST)  
DBD@D11A VALID                                                                                                              
                     ACTIVE     2021/03/05 01:01:33.65 0000001234  2021/03/05 01:01:33.65
                     STAGING    2021/03/09 21:00:34.51 0000001234  2021/03/09 21:00:34.51
DBD@E33A VALID                                                                                                              
                     ACTIVE     2021/03/05 01:01:33.65 0000004321  2021/03/05 01:01:33.65                                   
DBD@H60A INVALID                                                                         
                     ACTIVE     2021/02/27 19:37:00.16 (INSTANCE NOT EXIST)              
                     STAGING    2021/03/09 21:00:34.51 0000000000  2021/03/09 21:00:34.51
DBD@H90A VALID                                                                                                              
                     ACTIVE     2021/03/05 01:01:33.65 0000011111  2021/03/05 01:01:33.65                                   
IMS LIBRARY INTEGRITY UTILITIES - CATALOG MANAGER                  "IMS CATALOG VALIDATION REPORT"                       PAGE:     2
5655-U08                                                   DATE: 06/15/2021  TIME: 02.09.27                         FABXCATM - V2.R2
                                                                                                                              
PSB                                                                                                                         
---                                                                                                                         
                    |----------- DIRECTORY -----------|------------ CATALOG -------------|                                  
NAME     VALIDATION  STATUS     TIMESTAMP                          TIMESTAMP                                                
         RESULT                                                                                                             
-------- ----------- --------- ----------------------- ---------- -----------------------                                   
PSB@015  VALID                                                                                                              
                     ACTIVE     2021/03/05 01:01:33.65             2021/03/05 01:01:33.65 
                     STAGING    2021/03/09 21:00:34.51             2021/03/09 21:00:34.51                                 
PSB@025  VALID                                                                                                              
                     ACTIVE     2021/03/05 01:01:33.65             2021/03/05 01:01:33.65                                   
PSB@035  VALID                                                                                                              
                     ACTIVE     2021/03/05 01:01:33.65             2021/03/05 01:01:33.65
This report contains the following fields:
NAME
The resource name. Either the name of the DBD or PSB.
VALIDATION RESULT
The result of the validation. The following indicators are used:
VALID
When the IMS management of ACBs is enabled, the utility reports VALID if an instance in the IMS catalog has the same ACB generation time stamp as the ACB in the IMS directory.

If an ACB library is specified, the following conditions must also be true to be VALID:

  • If the member exists in both the active and staging data sets of the IMS directory:
    • The time stamp is the same between the ACB library and the IMS directory staging data set, and an instance with the time stamp exists in the IMS catalog.
    • The database version number is the same between the ACB library and the IMS catalog.
    • An instance that has the same time stamp as the one in the IMS directory active data set exists in the IMS catalog.
  • If the member exists in either the active or the staging data sets of the IMS directory:
    • The time stamp is the same between the ACB library and the IMS directory, and an instance with the same time stamp exists in the IMS catalog.
    • The database version number is the same between the ACB library and the IMS catalog.
When the IMS management of ACBs is not enabled, the utility reports the validation result as VALID if both of the following conditions are met:
  • The most recent instance in the IMS catalog has the same ACB generation time stamp as the ACB in the ACB library.
  • The database version number of the ACB in the ACB library matches the database version number of the instance in the IMS catalog.
INVALID
If the resources do not meet the VALID conditions, INVALID is printed.

When a member is reported as INVALID, identify the cause and run the ACB Generation and Catalog Populate utility (DFS3UACB) or the IMS Catalog Populate utility (DFS3PU00) to fix the condition.

DIRECTORY
STATUS
ACTIVE
DBD or PSB is in the active ACB data sets of the IMS directory.
STAGING
DBD or PSB is in the IMS directory staging data set.
TIMESTAMP
ACB generation time stamp of the DBD or PSB in the active ACB data sets of the IMS directory or the IMS directory staging data set.

When the DBD or PSB does not exist, (DBD NOT EXIST) or (PSB NOT EXIST) is printed.

CATALOG
DB VERSION
The database version number. When either of the following conditions is met, a string of zeros is shown as the database version number:
  • Database versioning is enabled and this DBD is the first version of the database.
  • Database versioning is not enabled.
TIMESTAMP
ACB generation time stamp of the DBD or PSB in the IMS catalog.
  • When the IMS management of ACBs is enabled and the ACB exists in the IMS directory, this field shows the ACB generation time stamp of the DBD or PSB, which is the same as the ACB generation time stamp of the ACB in the IMS directory.

    If an instance with the same time stamp does not exist in the IMS catalog, this field shows (INSTANCE NOT EXIST).

    If the ACB does not exist in the IMS directory, this field shows the time stamp of the ACB in the ACB library.

  • When the IMS management of ACBs is not enabled, it shows the time stamp of the most recent DBD or PSB in the IMS catalog.

(DBD NOT EXIST) or (PSB NOT EXIST) is printed if the utility finds no instance of the DBD or PSB in the IMS catalog.

ACBLIB
DB VERSION
The database version number. When either of the following conditions is met, a string of zeros is shown as the database version number:
  • Database versioning is enabled and this DBD is the first version of the database.
  • Database versioning is not enabled.
ACBGEN TIMESTAMP
ACB generation time stamp.

If the time stamp does not match with the time stamp of the ACB in the IMS directory, an asterisk (*) is printed before the time stamp.

(DBD NOT EXIST) or (PSB NOT EXIST) is printed if the utility finds no ACB in the ACB libraries.