Changing the high water mark of a database

Overview

When writing information to the Adabas Audit Data Retrieval database, the system checks whether there is still enough space in the database. If the database is close to getting full, a warning message is written to the console:

IRM9550W HIGH WATER MARK REACHED 90% BETA97.DB.MAIN.DATA

By default, the high water mark is 90 percent. You can change this value for individual databases using the program BST05CMD or BST05UPF.

Caution: No database access during changing high water mark

Do not access the Adabas Audit Data Retrieval database while changing the high water mark is in progress. To prevent the database from being accessed:

  1. Stop all Adabas Audit Data Retrieval jobs and the reader started tasks that are running.
  2. Then stop the Adabas Audit Data Retrieval started task.

Sample JCL for program BST05CMD

This example changes the high water mark of the Adabas Audit Data Retrieval MAIN database to 85 percent (DATA) and 95 percent (KEY).

+-----------------------------------------------------------------------+
|jobcard |
|//stepname EXEC PGM=BST01RFF,REGION=0M, |
|// PARM=('S=97,B01LST=xx,B97LST=xx', |
|// 'PGM=BST05CMD,SIGNON=NO') |
|//STEPLIB DD DISP=SHR, |
|// DSN=BSA.LOAD |
|//SFFPARM DD DISP=SHR, |
|// DSN=BETA.PARMLIB |
|//B97DEF DD DISP=SHR, |
|// DSN=BETA97.DB.DEF |
|//BQLPRINT DD SYSOUT=* |
|//BQLIN DD * |
| DEFINE UPDATE FILE B97MAIN HWM(85) |
| DEFINE UPDATE FILE B97KEY HWM(95) |
|/* |
+-----------------------------------------------------------------------+

Syntax (BST05CMD)

Specify the following under DD BQLIN:

DEFINE UPDATE FILE logicalfilename HWM(nn)

where logicalfilename is the logical filename of the Adabas Audit Data Retrieval database and nn the new high water mark in percent. For a list of logical filenames, see the table in "Adabas Audit Data Retrieval database components".

Sample JCL for program BST05UPF

+-----------------------------------------------------------------------+
|jobcard |
|//stepname EXEC PGM=BST01RFF,REGION=0M, |
|// PARM=('S=97,B01LST=xx,B97LST=xx', |
|// 'PGM=BST05UPF,SIGNON=NO') |
|//STEPLIB DD DISP=SHR, |
|// DSN=BSA.LOAD |
|//SFFPARM DD DISP=SHR, |
|// DSN=BETA.PARMLIB |
|//B97DEF DD DISP=SHR, |
|// DSN=BETA97.DB.DEF |
|//BQLPRINT DD SYSOUT=* |
|//BQLIN DD * |
| DEFINE UPDATE FILE OLDDSN(BETA97.DB.MAIN) HWM(85) |
| DEFINE UPDATE FILE OLDDSN(BETA97.DB.MAIN.KEY) HWM(95) |
|/* |
+-----------------------------------------------------------------------+

Syntax (BST05UPF)

Specify the following under DD BQLIN:

DEFINE UPDATE FILE OLDDSN(datasetname) HWM(nn)

where datasetname is the dataset name of the Adabas Audit Data Retrieval database and nn the new high water mark in percent. Or you can use this syntax:

DEFINE UPDATE FILE logicalfilename HWM(nn)

where logicalfilename is the logical file name (short name) of the Adabas Audit Data Retrieval database and nn the new high water mark in percent. For a list of logical filenames, see the table in "Adabas Audit Data Retrieval database components".