Example 8: CHECK DATA for user-defined RI violations in a table space

In this example, a CHECK DATA job checks for user-defined RI as specified in the RULES option. Because SAVERULES YES is also specified, the utility saves the user-defined RI rules in a CHECK PLUS database for use in later executions. CHECK PLUS writes one SQL DELETE statement per distinct foreign key violation to a discard data set in SPUFI format. The utility does not perform any table space or index checking.

Because user-defined RI rules are independent of Db2 CHKP states, SCOPE ALL is specified, and CHECK PLUS checks all rows.

During RI checking, CHECK PLUS finds five violations (see message BMC52288I) and details the errors in messages BMC52610I and BMC52611W. Because of these errors, the utility completes with return code 4.

Related topics

Command-and-syntax-reference

Considerations-for-each-type-of-checking

Examples-of-CHECK-PLUS-jobs

SQL-batch-execution-program

Types-of-checking

Message 50041I indicates the status of zIIP processing. For this example, the ZIIP installation option is ENABLED, but an XBM subsystem was not specified. CHECK PLUS automatically located an available XBM subsystem to provide zIIP processing.

The SQL DELETE statements in the SPUFI-formatted discard data set can be executed to delete the rows that are in violation. You can use SPUFI, QMF, DSNTEP2, DSNTIAD, or the SQL batch execution program that CHECK PLUS provides. For detailed information about this program and an example execution, see SQL-batch-execution-program

Command options for example 8

Command options used in JCL	Description
TABLESPACE	Identifies the table spaces to check
SCOPE ALL	Checks all rows of all specified tables
RULES FOR TABLE	Allows you to define RI and column condition rules for CHECK PLUS to verify for the specified table
PRIMARY KEY	Specifies the primary key by using the PRIMARY KEY (column name) syntax of the CREATE TABLE SQL statement
FOREIGN KEY	Specifies a foreign key and the table that it references by using the referential constraint syntax of the CREATE TABLE SQL statement
SAVERULES	Allows you to save or not save the RI rules that you defined in the primary key and referential constraint specifications
DISCARDFMT SPUFI	Produces one SQL DELETE statement per distinct foreign key in violation and writes the DELETE statements to the discard file
CHECKIXLEVEL 0	Performs no checks on index pages other than those normally performed when CHECK PLUS reads index entries from the index
CHECKTSLEVEL 0	Performs no checks on table space pages other than those performed normally when CHECK PLUS reads rows from the specified table space

DDL to create the data structures in example 8

CREATE TABLESPACE ACKRITS3 IN ACKRIDB1
USING STOGROUP ACKRISG1
PRIQTY      10
SECQTY      10
ERASE       NO
FREEPAGE    0
PCTFREE     0
BUFFERPOOL BP0
LOCKSIZE    PAGE
CLOSE       YES
CCSID       EBCDIC
SEGSIZE     64:
COMMIT
:
CREATE TABLE ACK.ACKRITB3
(COL01_CHAR_2          CHAR(2)                  NOT NULL WITH DEFAULT
.COL02_CHAR_2          CHAR(2)                  NOT NULL WITH DEFAULT
.COL03_CHAR_2          CHAR(2)                  NOT NULL WITH DEFAULT
.COL04_CHAR_2          CHAR(2)                  NOT NULL WITH DEFAULT
.COL05_CHAR_2          CHAR(2)                  NOT NULL WITH DEFAULT
.COL06_CHAR_2          CHAR(2)                  NOT NULL WITH DEFAULT
.COL07_CHAR_2          CHAR(2)                  NOT NULL WITH DEFAULT
.COL08_CHAR_2          CHAR(2)                  NOT NULL WITH DEFAULT
.COL09_CHAR_2          CHAR(2)                  NOT NULL WITH DEFAULT
.COL10_CHAR_2          CHAR(2)                  NOT NULL WITH DEFAULT
.COL11_CHAR_2          CHAR(2)                  NOT NULL WITH DEFAULT
.COL12_CHAR_2          CHAR(2)                  NOT NULL WITH DEFAULT
)
IN ACKRIDB1.ACKRITS3
CCSID EBCDIC:
COMMIT
:

ALTER TABLE ACK.ACKRITB3
  ADD FOREIGN KEY EX6T1FK2 ( COL01_CHAR_2, COL02_CHAR_2)
  REFERENCES ACK.ACKRITB2:
COMMIT:

JCL for example 8

//         JOBCARD
//*===================================================================
//*==== CHECK DATA for user-defined RI violations in a table space ==
//*================================================================*
//* Use your DB2 subsystem name inplace of "DB2SYS" parm parameter. *
//* Use your DB2 product install libraries for STEPLIBS ;            *
//*     PRODUCT.LIBRARIES                                             *
//*     DB2.DSNEXIT                                                   *
//*     DB2.DSNLOAD                                                   *
//*================================================================*
//CHECK08 EXEC PGM=ACKUMAIN,
//         PARM=(DB2SYS,ACKEX08,NEW,,'MSGLEVEL(1)')
//STEPLIB DD DISP=SHR,DSN=PRODUCT.LIBRARIES
//         DD DISP=SHR,DSN=DB2.DSNEXIT
//         DD DISP=SHR,DSN=DB2.DSNLOAD
//SYSIN     DD *
CHECK DATA TABLESPACE ACKRIDB1.ACKRITS4
           SCOPE ALL
           RULES
                 FOR TABLE ACK.ACKRITB5
                     PRIMARY KEY (COL01_CHAR_2
                                 ,COL02_CHAR_2
                                 )
                 FOR TABLE ACK.ACKRITB4
                     FOREIGN KEY EX8T2FK1(COL01_CHAR_2
                                         ,COL02_CHAR_2
                                         )
                     REFERENCES ACK.ACKRITB5
                     SAVERULES YES
           DISCARDFMT SPUFI
           CHECKIXLEVEL 0
           CHECKTSLEVEL 0
/*
//SYSPRINT DD DSN=ACK.EXAMPL08.SYSPRINT,
//           UNIT=SYSDA,SPACE=(CYL,(1,1)),DISP=(NEW,CATLG)
//UTPRINT   DD SYSOUT=*
//SYSDISC   DD DSN=ACK.EXAMPL08.SYSDISC,
//             DISP=(NEW,CATLG,CATLG),
//             UNIT=SYSDA,SPACE=(CYL,(1,1))
//SYSERR    DD DSN=ACK.EXAMPL08.SYSERR,
//             DISP=(NEW,CATLG,CATLG),
//             UNIT=WORK,SPACE=(CYL,(1,1))

SYSPRINT for example 8

1                               ***** B M C   C H E C K   P L U S   F O R   D B 2    V13R1.00 *****
                                             (C) COPYRIGHT 1993 - 2022 BMC SOFTWARE, INC.
               CHECK PLUS TECHNOLOGY IS PROTECTED BY ONE OR MORE OF THE FOLLOWING U.S. PATENTS: 5,579,515 AND 6,163,783
-BMC50001I UTILITY EXECUTION STARTING    2/28/2022    9:37:02 ...
BMC50002I UTILITY ID = 'ACKEX08'. DB2 SUBSYSTEM ID = 'DEJM'. OPTION MODULE = 'ACK$OPTS'.
BMC50471I z/OS 2.4.0,PID=HBB77C0,DFSMS FOR Z/OS=2.4.0,DB2=12.1.510
BMC50471I REGION=0M,BELOW 16M=8.6M,ABOVE 16M=1,003.1M,IEFUSI=NO,CPUs=7,GPs=5,zIIPs=2
BMC50471I MEMLIMIT=15.9E,AVAILABLE=15.9E,MEMLIMIT SET BY:REGION=0
BMC50471I SMFID=DB2B,JOBID=J0021549,JOB=ACKEX08,STEP=CHECK08,CPU=8561-615 (z15)/1.71,76.0G
0
BMC50471I CHECK PLUS FOR DB2--V13.01.00 BASE
BMC50471I   NO MAINTENANCE TO REPORT
BMC50471I DB2 UTILITIES COMMON CODE--V13.01.00 BASE
BMC50471I   NO MAINTENANCE TO REPORT
BMC50471I SOLUTION COMMON CODE--V13.01.00 BASE
BMC50471I   MAINT: BPJ1541 BPJ1713 BPJ2211
BMC50471I BMCSORT ENGINE--V02.04.01
BMC50471I   MAINT: BPJ0691 BPJ0718 BPJ0881 BPJ0922 BPJ0996 BPJ1164 BPJ1309 BPJ1386 BPJ1497 BPJ1594 BPJ1724 BPJ1809
BMC50471I          BPJ1833 BPJ1891 BPJ1905 BPJ2109 BPJ2232 BPJ2297
BMC50471I BMC STATS API--V13.01.00 BASE
BMC50471I   NO MAINTENANCE TO REPORT
BMC50471I EXTENDED BUFFER MANAGER--V06.02.01
BMC50471I   MAINT: BPE0443 BPE0445 BPE0447 BPE0449 BPE0450 BPE0451 BPE0452 BPE0455 BPE0456 BPE0457 BPE0460 BPE0463
BMC50471I          BPE0467 BPE0468 BPE0469 BPE0473 BPE0474 BPE0475 BPE0479 BPE0480 BPE0482 BPE0487 BPE0488 BPE0489
BMC50471I          BPE0493 BPE0497 BPE0498 BPE0501 BPE0503 BPE0507 BPE0512 BPE0513 BPE0517 BPE0518 BPE0519 BPE0523
BMC50471I          BPE0524 BPE0527 BPE0528 BPE0530 BPE0531 BPE0534 BPE0535 BPE0540 BPE0541 BPE0542 BPE0545 BPE0549
BMC50471I          BPE0551 BPE0552 BPE0555 BPE0556 BPE0557 BPE0560
0
BMC50471I DRNDELAY=3                              LOADDECP=NO                             SQLDELAY=3
BMC50471I DRNRETRY=10                             LOCKROW=YES                             SQLRETRY=100
BMC50471I DRNWAIT=NONE                            MAXP=5                                  UXSTATE=SUP
BMC50471I DSER=NO                                 MSGLEVEL=1                              WBUFFS=20
BMC50471I DSPLOCKS=NONE                           OPNDB2ID=YES                            WORKUNIT=SYSALLDA
BMC50471I FILECHK=WARN                            PLAN=ACK1310T                           XBLKS=3
BMC50471I FORCE_AT=(START,3)                      SMAX=16                                 ZIIP=ENABLED
BMC50471I FORCE_RPT=NO                            SMCORE=(0K,0K)
BMC50471I FORCE=NONE                              SORTNUM=32
0

BMC50471I DB2 DSNHDECP MODULE SETTINGS:
BMC50471I VERSION                 = 1210
BMC50471I SUBSYSTEM DEFAULT       = DEJM
BMC50471I CHARACTER SET           = ALPHANUM
BMC50471I DATE FORMAT             = USA
BMC50471I TIME FORMAT             = USA
BMC50471I LOCAL DATE LENGTH       = 0
BMC50471I LOCAL TIME LENGTH       = 0
BMC50471I DECIMAL POINT           = PERIOD
BMC50471I DECIMAL ARITHMETIC      = 15
BMC50471I DELIMITER               = DEFAULT
BMC50471I SQL DELIMITER           = DEFAULT
BMC50471I ENCODING SCHEME         = EBCDIC
BMC50471I APPL. ENCODING SCHEME   = EBCDIC
BMC50471I MIXED                   = NO
BMC50471I EBCDIC CCSID            = (37,65534,65534)
BMC50471I ASCII CCSID             = (819,65534,65534)
BMC50471I UNICODE CCSID           = (367,1208,1200)
BMC50471I IMPLICIT TIME ZONE      = CURRENT (-06:00)

BMC50658I DB2 CURRENT FUNCTION LEVEL IS V12R1M509
BMC50659I DB2 CATALOG LEVEL IS V12R1M509
BMC50660I DB2 HIGHEST ACTIVATED FUNCTION LEVEL IS V12R1M509
BMC50661I DB2 CODE LEVEL IS V12R1M510

BMC50471I BMC_BMCUTIL       ='BMCUTIL.CMN_BMCUTIL'
BMC50471I BMC_BMCSYNC       ='BMCUTIL.CMN_BMCSYNC'
BMC50471I BMC_BMCHIST       ='BMCUTIL.CMN_BMCHIST'
BMC50471I BMC_BMCRELS       ='ACKIB2.BMCRELS'
BMC50471I BMC_BMCFKEY       ='ACKIB2.BMCFKEY'
BMC50471I BMC_BMCPKEY       ='ACKIB2.BMCPKEY'
BMC50471I BMC_BMCKEYS       ='ACKIB2.BMCKEYS'
0
0
BMC50102I CHECK DATA TABLESPACE ACKRIDB1.ACKRITS4
BMC50102I            SCOPE ALL
BMC50102I            RULES
BMC50102I                  FOR TABLE ACK.ACKRITB5
BMC50102I                      PRIMARY KEY (COL01_CHAR_2
BMC50102I                                  ,COL02_CHAR_2
BMC50102I                                  )
BMC50102I                  FOR TABLE ACK.ACKRITB4
BMC50102I                      FOREIGN KEY EX8T2FK1(COL01_CHAR_2
BMC50102I                                          ,COL02_CHAR_2
BMC50102I                                          )
BMC50102I                      REFERENCES ACK.ACKRITB5
BMC50102I                      SAVERULES YES
BMC50102I            DISCARDFMT SPUFI
BMC50102I            CHECKIXLEVEL 0
BMC50102I            CHECKTSLEVEL 0

BMC50041I 0: ZIIP ENABLED (0) USING XBM SUBSYSTEM XBMB
BMC50004I UTILINIT PHASE COMPLETE. ELAPSED TIME = 00:01:32

BMC50394I UNABLE TO LOCATE SORT WORK DATASETS, DDNAME = 'SORTWKNN'
BMC50474I BELOW 16M = 8340K, ABOVE 16M = 1020280K, CPUS = 5

BMC52601I STARTING CHECK DATA FOR THE FOLLOWING :
BMC52602I PK FOR TABLE ACK.ACKRITB5 USING IX.ACK.ACKRIX05
BMC52603I FK ACK.ACKRITB4.EX8T2FK1 USING TS.ACKRIDB1.ACKRITS4
BMC52230I MAX TASKS = 1, MAX PARTS/TASK = 2, SORTWKS/TASK = 32, MAX OPEN PARTS/TASK = 2, MAX INDEXES/TASK = 2

BMC50894I PAGE EXTERNALIZATION PROCESS STARTING AT   2/28/2022   9:38:35

BMC50650I ESTABLISHING A POINT OF CONSISTENCY FOR:
BMC50651I SPACE ACKRIDB1.ACKRITS4 PART(0) PSID(0014)
BMC50651I SPACE ACKRIDB1.ACKRIX05 PART(0) PSID(001C)

BMC50895I PAGE EXTERNALIZATION PROCESS COMPLETE. ELAPSED TIME = 00:00:00

BMC52286I 1: CHECKING OF DATASET 'DEJMCAT.DSNDBD.ACKRIDB1.ACKRIX05.I0001.A001' READ 5 PAGES
BMC52286I 1: CHECKING OF DATASET 'DEJMCAT.DSNDBD.ACKRIDB1.ACKRITS4.I0001.A001' READ 6 PAGES
BMC50481I 1: SORT COMPLETE. ELAPSED TIME = 00:00:00
BMC50481I 1: CHECK TASK COMPLETE. ELAPSED TIME = 00:00:00

BMC52606I FK ACK.ACKRITB4.EX8T2FK1 , 100 KEYS CHECKED, 5 VIOLATIONS FOUND

BMC50476I DDNAME = SYSERR, I/OS = 2, I/O WAITS = 2, RDB LOCK WAITS = 0
BMC52288I CHECK ERROR SUMMARY: PAGE EXCEPTIONS-0, CONSTRAINT VIOLATIONS-5
BMC50004I CHECK PHASE COMPLETE. ELAPSED TIME = 00:00:00

BMC52610I CREATOR.TABLE.CONSTRAINT ROW-ID   KEY
BMC52611W ACK.ACKRITB4.EX8T2FK1   0000060100 '05','HK'
BMC52611W ACK.ACKRITB4.EX8T2FK1   0000060200 '05','OM'
BMC52611W ACK.ACKRITB4.EX8T2FK1   0000060300 '05','UB'
BMC52611W ACK.ACKRITB4.EX8T2FK1   0000060400 '05','WX'
BMC52611W ACK.ACKRITB4.EX8T2FK1   0000060900 '13','GI'

BMC50476I DDNAME = SYSERR, I/OS = 1, I/O WAITS = 1, RDB LOCK WAITS = 0
BMC50476I DDNAME = SYSDISC, I/OS = 1, I/O WAITS = 1, RDB LOCK WAITS = 0
BMC50004I FIXRI PHASE COMPLETE. ELAPSED TIME = 00:00:00

BMC50041I 0: ZIIP NOT ENABLED (0) USING XBM SUBSYSTEM XBMB
0BMC50006I UTILITY EXECUTION COMPLETE, RETURN CODE = 4

Discard data set for example 8

DELETE FROM ACK.ACKRITB4 WHERE COL01_CHAR_2 = '05' AND COL02_CHAR_2 = 'HK' ;
DELETE FROM ACK.ACKRITB4 WHERE COL01_CHAR_2 = '05' AND COL02_CHAR_2 = 'OM' ;
DELETE FROM ACK.ACKRITB4 WHERE COL01_CHAR_2 = '05' AND COL02_CHAR_2 = 'UB' ;
DELETE FROM ACK.ACKRITB4 WHERE COL01_CHAR_2 = '05' AND COL02_CHAR_2 = 'WX' ;
DELETE FROM ACK.ACKRITB4 WHERE COL01_CHAR_2 = '13' AND COL02_CHAR_2 = 'GI' ;

Example 8: CHECK DATA for user-defined RI violations in a table space

On this page