Version 8.1.4
 —  Utilities  —

Functional Overview

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*
Flag byte:
C'-' A value is missing
C'+' A value is incorrect
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

Top of page