CHANGE.DB command

The CHANGE.DB command changes the verification options of the current RDE for the specified non-HALDB full-function database, HALDB partition, or DEDB area.

Subsections:

Syntax

Read syntax diagramSkip visual syntax diagramCHANGE.DBDBD( pattern) AREA( pattern) CHECKON(Y,D,WN) CHECKBAT(Y,D,WN)CHECKLD(Y,D,WN)CHECKIC(Y,D,WN)CHECKRV(Y,D,WN)CHKRAND(YN)CHKCOMP(YN)CHKPSEL(YN)CHKFPSEL(YN)RECUPD(YN)RECLD(YN)RECUL(YN)GENMAX( nn)

Parameters

DBD(pattern)
Specifies the database for which you want to change an RDE. You can specify either of the following patterns:
  • A specific database name or a specific HALDB partition name
  • A partially specified database name pattern or a partially specified HALDB partition name pattern—for example, DH41*, where * means ALL
Note: A partially specified HALDB master name is not supported. If it is specified, this command fails with message FABL0461E.

For HALDBs, if you specify a HALDB master name, all the RDEs of its partitions are changed. If you specify a HALDB partition name, only the RDE of the partition is changed.

AREA(pattern)
Specifies the DEDB area for which you want to change an RDE. Only when you specify a specific DEDB name in the DBD parameter, you can specify either of the following patterns:
  • A specific DEDB area name
  • A partially specified DEDB area name pattern
If you omit the keyword, the RDEs for all areas of the DEDB database that is specified with the DBD parameter are changed.
CHECKON (Y or N, D or W)
Specifies the verification option in effect for online IMS subsystems. You can specify the following options:
Y
Check. If you specify Y, you can specify either of the following parameters:
D
If a mismatch is found, deny authorization to use the database.
W
Issue a warning message and create a new RDE.
N
Do not check.
CHECKBAT (Y or N, D or W)
Specifies the verification option in effect for batch jobs. You can specify the following options:
Y
Check. If you specify Y, you can specify either of the following parameters:
D
If a mismatch is found, deny authorization to use the database.
W
Issue a warning message and create a new RDE.
N
Do not check.
CHECKLD (Y or N, D or W)
Specifies the verification option in effect for user load program jobs. You can specify the following options:
Y
Check. If you specify Y, you can specify either of the following parameters:
D
If a mismatch is found, deny authorization to use the database.
W
Issue a warning message and create a new RDE.
N
Do not check.
CHECKIC (Y or N, D or W)
Specifies the verification option in effect for batch image copy jobs. You can specify the following options:
Y
Check. If you specify Y, you can specify either of the following parameters:
D
If a mismatch is found, deny authorization to use the database.
W
Issue a warning message and create a new RDE.
N
Do not check.
CHECKRV (Y or N, D or W)
Specifies the verification option in effect for database recovery jobs. You can specify the following options:
Y
Check. If you specify Y, you can specify either of the following parameters:
D
If a mismatch is found, deny authorization to use the database.
W
Issue a warning message and create a new RDE.
N
Do not check.
CHKRAND (Y or N)
Specifies the option to determine whether to verify changes in randomizing routines by checksum. You can specify the following options:
Y
Check.
N
Do not check.
If CHECKON, CHECKBAT, CHECKLD, CHECKIC, or CHECKRV is set to Y, this specification is effective in each IMS environment.
CHKCOMP (Y or N)
Specifies the option to determine whether to verify changes in segment edit/compression exit routines by checksum. You can specify the following options:
Y
Check.
N
Do not check.
If CHECKON, CHECKBAT, CHECKLD, CHECKIC, or CHECKRV is set to Y, this specification is effective in each IMS environment.
CHKPSEL (Y or N)
Specifies the option to determine whether to verify changes in HALDB partition selection exit routines by checksum. You can specify the following options:
Y
Check.
N
Do not check.
If CHECKON, CHECKBAT, CHECKLD, CHECKIC, or CHECKRV is set to Y, this specification is effective in each IMS environment.
CHKFPSEL (Y or N)
Specifies the option to determine whether to verify changes in DEDB partition selection exit routines by checksum. You can specify the following options:
Y
Check.
N
Do not check.
If CHECKON, CHECKBAT, CHECKLD, CHECKIC, or CHECKRV is set to Y, this specification is effective in each IMS environment.
RECUPD (Y or N)
Specifies the option to determine whether to record database update access information. You can specify the following options:
Y
Record.
N
Do not record.
RECLD (Y or N)
Specifies the option to determine whether to record database load access information. You can specify the following options:
Y
Record.
N
Do not record.
RECUL (Y or N)
Specifies the option to determine whether to record database unload access information. You can specify the following options:
Y
Record.
N
Do not record.
If RECUPD, RECLD, or RECUL is set to Y and Integrity Checker starts recording database accesses, the recorded information remains until the RDE is re-created or the option is changed from Y to N.
GENMAX (nn)
Specifies the maximum number of expired RDEs to be kept in the LICON data set for use in recoveries. A maximum of 15 RDE copies can be kept.

Example

In this example, the following conditions are assumed:

  • The IMS ID is taken from the batch SCD module (DFSVC000) loaded by the IMS load module library IMSVS.SDFSRESL.
  • The LICON data set is dynamically allocated by the LICON utility. The data set name is provided by one of the global option modules.
CHANGE.DB with DBDLIB
This example changes the maximum number of expired RDEs to be kept in the LICON data set to 2. 
//LICJOB   JOB
//        EXEC PGM=FABLIU00
//STEPLIB   DD DISP=SHR,DSN=HPS.SHPSLMD0
//          DD DISP=SHR,DSN=IMSVS.SDFSRESL
//DBDLIB    DD DISP=SHR,DSN=IMSVS.DBDLIB
//FABLPRNT  DD SYSOUT=*
//FABLIN    DD *
  CHANGE.DB DBD(DH41TS01) GENMAX(2)
/*