The ADAVAL utility validates any or all files within an Adabas database except the checkpoint and security files.
ADAVAL compares the actual descriptor values contained in the records in Data Storage with the corresponding values stored in the Associator to ensure that the Associator and Data Storage are synchronized, and that there are no values missing from the Associator.
Before running ADAVAL, the consistency of the inverted lists should be checked with the ADAICK utility.
Note:
If ADAICK has been run and errors occurred, do not run
ADAVAL until the cause of the ADAICK error has been corrected. This ADAVAL run
restriction applies for any ADAICK error except ADAICK WARNING-163.
The Adabas nucleus must be running when executing ADAVAL. ADAVAL assigns EXF (exclusive use) status to all files to be validated, making them unavailable to other utilities or users. If ADAVAL specifies a file currently in use, an error message is issued and operation stops. ADAVAL returns condition code 4 if any errors are found.
ADAVAL prints a list of all fields compared and the ISNs rejected during validation on SYSOUT (DD/DRUCK). The normal ADAVAL output is shown under Example of ADAVAL Output.
If desired, rejected ISNs can also be output to a sequential data set (DD/FEHL). The first record on DD/FEHL is always as follows:
| Bytes | Description |
|---|---|
| 0-1 | Record length in binary format (example: X'0012') |
| 2-3 | Set to zero (example: X'0000') |
| 4-9 | Program ID (example: C'ADAVAL') |
| 10-13 | Four-byte packed Julian date in format,
YYYYDDDF ("F" = B'1111')
|
| 14-17 | Four-byte packed time in format,
hhmmssth (t = tenths of a
second, h = hundredths of a second) |
All remaining DD/FEHL records have the following format (items shown with an asterisk (*) are also in the normal SYSOUT and DD/DRUCK output):
| Bytes | Description | ||||||
|---|---|---|---|---|---|---|---|
| 0-1 | Record length in binary format (example: X'0012') | ||||||
| 2-3 | Set to zero (example: X'0000') | ||||||
| 4-5* | Adabas file number in binary format | ||||||
| 6* |
|
||||||
| 7 | Set to zero | ||||||
| 8-11 | ISN in binary format | ||||||
| 12-13* | Descriptor name as stored in the field definition table (FDT) | ||||||
| 14* | Descriptor value length in binary format | ||||||
| 15, on* | Descriptor value | ||||||
