Control statements for the Consistency Checker utility

The input to the Consistency Checker utility consists of control statements in the SYSIN data set.

Subsections:

Control statement example

The following figure shows the control statements that can be coded in the SYSIN data set.
Figure 1. Example of the control statements for Consistency Checker
//SYSIN    DD   *
    DDIRSFX=A
    CHKRECON=YES
    FAILONLY=YES
    FAILRC=04    
    DBD=TESTDB1
    DBD=TESTDB2 
/*

Syntax rules

The following guidelines apply to the control statements for Consistency Checker:

  • The control statements can be coded anywhere between columns 2 - 80.
  • In the control statement field, blanks must not be used between keyword, equal sign, and member name.
  • Comments can be written after a blank because a blank is considered the delimiter.
  • Statements with an asterisk (*) in column 1 are treated as comments.

Control statement keywords

The format of each control statement is as follows:

Note: DDIRSFX, PDIRSFX, CHKRECON, PCBERRLMT, FAILONLY, and FAILRC statements can be specified only once, in no special order. DDIRSFX and CHKRECON are effective for all DBD members, PDIRSFX and PCBERRLMT are effective for all PCB members, and FAILONLY and FAILRC are effective for all DBD and PSB members.
DDIRSFX=[x|0]
This statement specifies the alphanumeric suffix character appended to DFSDDIR of the MODBLKS module name. The default is 0. If MODBLKS data set is specified in the MODBLKS DD statement, this specification is effective. If DRD=YES is specified in the SYSIN data set, this specification is ignored.
PDIRSFX=[x|0]
This statement specifies the alphanumeric suffix character that is appended to DFSPDIR of the MODBLKS module name. The default is 0. If MODBLKS data set is specified in the MODBLKS DD statement, this specification is effective. If DRD=YES is specified in the SYSIN data set, this specification is ignored.
CHKRECON=YES|NO
This statement specifies whether to verify the registration of the database and the data set to RECON. The default is NO.
FAILONLY=YES|NO
This statement specifies whether the DBD check reports are to be printed only for the DBDs that fail the consistency check, and whether the PSB check reports are to be printed only for the PSBs and the PCBs that fail the consistency check. The default is NO, which means these check reports are printed for all of the DBDs and for all of the PSBs to be checked.
FAILRC=nn
This statement specifies the return code by two-digit decimal number which is returned when the consistency check fails for any DBDs or any PSBs. The default is 08.
PCBERRLMT=nnnn
This statement specifies the maximum number of inconsistent PCBs in each PSB that is to be printed on the PSB check report. If the number of inconsistent PCBs in each PSB has exceeded the value specified in this statement, Consistency Checker will not check further PCBs. You can specify a left-aligned decimal number in the range of 0 - 2500. This specification is effective only when FAILONLY=YES is specified. The default is 2500.
NOCHKORG=dborg
This statement specifies that the database organization is to be excluded from the consistency check. One or more of the following types can be specified:
  • HSAM, HISAM, HDAM, HIDAM, INDEX, PHDAM, PHIDAM, PSINDEX, GSAM, LOGICAL, MSDB, and DEDB.
    Note: Here, HSAM includes SHSAM, and HISAM includes SHISAM.
For example, specifying the following statement causes the DBDs that are defined as HSAM, SHSAM, or GSAM to be excluded from consistency checking. 
NOCHKORG=HSAM,GSAM
When specifying two or more statements, specify them as follows: 
NOCHKORG=HSAM
NOCHKORG=GSAM
DRD=YES|NO
This statement specifies whether Dynamic Resource Definition (DRD) is enabled in your IMS™ system. The default is NO. If an RDDS data set is specified in the SYSRDDS or NSYSRDDS DD statement, this specification is effective.
DBD=member
This statement specifies the DBD member names to be checked. You can use wildcards to specify multiple members.
PSB=member
This statement specifies the PSB member names to be checked. You can use wildcards to specify multiple members.
Note: For the DBD and PSB control statements, wildcards that can be used are an asterisk (*) and a percent sign (%). An asterisk represents 0 - 8 characters, and a percent sign represents a single character. If two or more asterisks are specified sequentially, only the first asterisk is recognized.
Parent topic: Consistency Checker utility