Example 5: SHRLEVEL CHANGE: CHECK INDEX and CHECK TABLESPACE of a specified table space
This CHECK INDEX job reports three-page VERIFY condition violations (see message BMC52470W). These errors are violations of column conditions that were specified with the VERIFY option of the RULES specification. Because of these errors, the utility completes with return code 4.
Message BMC52471I lists the columns specified in the failed condition along with corresponding column values. Because an index exists, CHECK PLUS lists and flags the index columns to assist in identifying the rows in violation. In this example, columns 2 and 5 are listed in the message and flagged as index columns but are not in the condition clause.
Message 50041I indicates the status of zIIP processing. For this example, an XBM subsystem ID was specified for SHRLEVEL CHANGE processing. CHECK PLUS uses the same XBM subsystem ID for zIIP processing. The following table describes the key command options for this job.
Command options for example 5
Command options used in JCL | Description |
|---|---|
TABLESPACE | Identifies the table space for which you want all indexes checked. |
SHRLEVEL CHANGE | Specifies the level of access that concurrently operating Db2 applications and utilities have to the target spaces This feature enables read/write access to the table space while CHECK PLUS checks a consistent image of the data. |
XBMID | Specifies the XBM subsystem to be activated when using XBM or SUF with CHECK PLUS |
CHECKTSLEVEL 2 | Performs all CHECKTSLEVEL 1 checks on the specified table space plus additional interpage checks on such items as overflow pointers and records, valid rows in correct partitions, and intact segment chains |
CHECKIXLEVEL 2 | Performs all CHECKIXLEVEL 1 checks plus checks on the correct relationships between index keys and table rows |
KEYSONLY | Performs checks only on the correct relationships between index keys and table rows and does not perform the page structure checks of CHECKIXLEVEL 1 |
SORTDEVT | Specifies the device type for the sort work files that BMCSORT will allocate dynamically |
RULES FOR TABLE | Allows you to define RI and column condition rules for CHECK PLUS to verify the specified table |
VERIFY | Allows you to specify the condition that must be true for a column value to be valid |
JCL for example 5
//*===================================================================
//*=== SHRLEVEL CHANGE: CHECK INDEX and CHECK TABLESPACE of a =======
//*====================== specified 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 *
//*================================================================*
//CHECK05 EXEC PGM=ACKUMAIN,
// PARM=(DB2SYS,ACKEX05,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 INDEX TABLESPACE ACKNDB.ACKNS05
SHRLEVEL CHANGE XBMID XBM4
CHECKTSLEVEL 2
CHECKIXLEVEL 2 KEYSONLY
SORTDEVT SYSDA
RULES FOR TABLE ACK.ACKN05T2
VERIFY (NOT (COL3_CHAR_250 LIKE '%TTT%'))
//SYSPRINT DD DSN=ACK.EXAMPL05.SYSPRINT,
// UNIT=SYSDA,SPACE=(CYL,(1,1)),DISP=(NEW,CATLG)
//UTPRINT DD SYSOUT=*
SYSPRINT for example 5
(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/23/2022 15:50:23 ...
BMC50002I UTILITY ID = 'ACKEX05'. 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.9M,IEFUSI=NO,CPUs=7,GPs=5,zIIPs=2
BMC50471I MEMLIMIT=15.9E,AVAILABLE=15.9E,MEMLIMIT SET BY:REGION=0
BMC50471I SMFID=DB2B,JOBID=J0242601,JOB=ACKEX05,STEP=CHECK05,CPU=8561-615 (z15)/1.71,72.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 INDEX TABLESPACE ACKNDB.ACKNS05
BMC50102I SHRLEVEL CHANGE XBMID XBMB
BMC50102I CHECKTSLEVEL 2
BMC50102I CHECKIXLEVEL 2 KEYSONLY
BMC50102I SORTDEVT SYSDA
BMC50102I RULES FOR TABLE ACK.ACKN05T2
BMC50102I VERIFY (NOT (COL3_CHAR_250 LIKE '%TTT%'))
BMC50041I 0: ZIIP ENABLED (0) USING XBM SUBSYSTEM XBMB
BMC50004I UTILINIT PHASE COMPLETE. ELAPSED TIME = 00:00:00
BMC50394I UNABLE TO LOCATE SORT WORK DATASETS, DDNAME = 'SORTWKNN'
BMC50474I BELOW 16M = 7757K, ABOVE 16M = 1022340K, CPUS = 5
BMC52230I MAX TASKS = 1, MAX PARTS/TASK = 1, SORTWKS/TASK = 32, MAX OPEN PARTS/TASK = 1, MAX INDEXES/TASK = 1
BMC50894I PAGE EXTERNALIZATION PROCESS STARTING AT 2/23/2022 15:50:24
BMC50650I ESTABLISHING A POINT OF CONSISTENCY FOR:
BMC50651I SPACE ACKNDB.ACKNS05 PART(0) PSID(0002)
BMC50651I SPACE ACKNDB.ACKN0511 PART(0) PSID(0006)
BMC50651I SPACE ACKNDB.ACKN0521 PART(0) PSID(0008)
BMC50651I SPACE ACKNDB.ACKN0522 PART(0) PSID(000A)
BMC50651I SPACE ACKNDB.ACKN0523 PART(0) PSID(000C)
BMC50895I PAGE EXTERNALIZATION PROCESS COMPLETE. ELAPSED TIME = 00:00:01
BMC52286I 2: CHECKING OF DATASET 'DEJMCAT.DSNDBD.ACKNDB.ACKN0511.I0001.A001' READ 23 PAGES
BMC52470W VERIFY CONDITION VIOLATED. TABLE = 'ACK.ACKN05T2'
BMC52471I !COL2_DECIMAL_6_2=.36,COL3_CHAR_250='03111XTTT80078901284272 0000036',!COL5_VCHAR_100=
BMC52471I '**** ACKN05T2 COL5_VCHAR_100 ***'
BMC52470W VERIFY CONDITION VIOLATED. TABLE = 'ACK.ACKN05T2'
BMC52471I !COL2_DECIMAL_6_2=3.69,COL3_CHAR_250='02111XTTT80078901284888 0000369',!COL5_VCHAR_100=
BMC52471I '**** ACKN05T2 COL5_VCHAR_100 ***'
BMC52470W VERIFY CONDITION VIOLATED. TABLE = 'ACK.ACKN05T2'
BMC52471I !COL2_DECIMAL_6_2=5.69,COL3_CHAR_250='03333ATU7TTTU7887287277 0000569',!COL5_VCHAR_100=
BMC52471I '**** ACKN05T2 COL5_VCHAR_100 ***'
BMC52286I 1: CHECKING OF DATASET 'DEJMCAT.DSNDBD.ACKNDB.ACKNS05.I0001.A001' READ 54 PAGES
BMC52286I 2: CHECKING OF DATASET 'DEJMCAT.DSNDBD.ACKNDB.ACKN0521.I0001.A001' READ 10 PAGES
BMC52286I 2: CHECKING OF DATASET 'DEJMCAT.DSNDBD.ACKNDB.ACKN0522.I0001.A001' READ 5 PAGES
BMC52286I 2: CHECKING OF DATASET 'DEJMCAT.DSNDBD.ACKNDB.ACKN0523.I0001.A001' READ 7 PAGES
BMC50481I 2: UNLOAD INDEX TASK COMPLETE. ELAPSED TIME = 00:00:00
BMC50481I 1: SORT COMPLETE. ELAPSED TIME = 00:00:00
BMC50481I 1: CHECK TASK COMPLETE. ELAPSED TIME = 00:00:00
BMC50277I XBM STATISTICS: DSN='DEJMCAT.DSNDBD.ACKNDB.ACKNS05.I0001.A001', READS 55, HITS 0, WRITES 0, CACHE 0
BMC50277I XBM STATISTICS: DSN='DEJMCAT.DSNDBD.ACKNDB.ACKN0511.I0001.A001', READS 23, HITS 0, WRITES 0, CACHE 0
BMC50277I XBM STATISTICS: DSN='DEJMCAT.DSNDBD.ACKNDB.ACKN0521.I0001.A001', READS 12, HITS 0, WRITES 0, CACHE 0
BMC50277I XBM STATISTICS: DSN='DEJMCAT.DSNDBD.ACKNDB.ACKN0522.I0001.A001', READS 5, HITS 0, WRITES 0, CACHE 0
BMC50277I XBM STATISTICS: DSN='DEJMCAT.DSNDBD.ACKNDB.ACKN0523.I0001.A001', READS 7, HITS 0, WRITES 0, CACHE 0
BMC52277I XBLKS = 3, XFERS = 1, EMPTY WAITS = 0, FULL WAITS = 2
BMC52606I VER ACK.ACKN05T2."VERIFY CONDITION" , 299 ROWS CHECKED, 3 VIOLATIONS FOUND
BMC52278I 271 ENTRIES CHECKED FOR (PGSIZE 4K) INDEX 'ACK.ACKN0511,' 0 ERRORS
BMC52278I 299 ENTRIES CHECKED FOR (PGSIZE 4K) INDEX 'ACK.ACKN0521,' 0 ERRORS
BMC52278I 299 ENTRIES CHECKED FOR (PGSIZE 4K) INDEX 'ACK.ACKN0522,' 0 ERRORS
BMC52278I 299 ENTRIES CHECKED FOR (PGSIZE 4K) INDEX 'ACK.ACKN0523,' 0 ERRORS
BMC52288I CHECK ERROR SUMMARY: PAGE EXCEPTIONS-0, CONSTRAINT VIOLATIONS-3
BMC50004I CHECK PHASE COMPLETE. ELAPSED TIME = 00:00:02
BMC50041I 0: ZIIP NOT ENABLED (0) USING XBM SUBSYSTEM XBMB
0BMC50006I UTILITY EXECUTION COMPLETE, RETURN CODE = 4