ADAERR (Error File Report)

This document describes the utility "ADAERR".

The following topics are covered:


Functional Overview

The ADAERR utility displays the contents of error files generated by the utilities

  • ADACMP

  • ADADCU

  • ADAINV

  • ADAMUP

  • ADAREC

This utility is a single-function utility.

Procedure Flow

graphics/adaerr.png

Data Set Environment
Variable/
Logical Name
Storage Medium Additional Information
Error data ERRIN Disk, Tape (* see note)  
Error messages stdout/
SYS$OUTPUT
   

Note:
(*) A named pipe can be used for this sequential file (not on Open VMS, see Adabas Basics, Using Utilities for details).

The sequential file ERRIN can have multiple extents. For detailed information about sequential files with multiple extents, see Adabas Basics, Using Utilities.

Checkpoints

The utility writes no checkpoints.

Control Parameter

The following control parameter is available:

D    [NO]DUMP

[NO]DUMP

[NO]DUMP

If NODUMP is specified, only a description (length of record, ISN of the record etc.) of each error record will be output, but not the actual record content. See the section Rejected Data Records in this section for information on the contents of the error records.

If DUMP is specified, the record content will be dumped in addition to the record description. For ADACMP, the decompressed record will be dumped, whereas for ADADCU the compressed record will be dumped.

The default is NODUMP.

Example

$ adaerr
%ADAERR-I-STARTED,      11-OCT-2006 18:59:20, Version 6.1.1
%ADAERR-I-RECNOTF, Record NOT found for ISN 317 in file 49
%ADAERR-I-PLOGRB,  from record 1 in block 6 on PLOG 1
%ADAERR-I-IOCNT,        1 IO  on dataset ERRIN
%ADAERR-I-TERMINATED,   11-OCT-2006 18:59:20, elapsed time: 00:00:01 

Rejected Data Records

Any records rejected by the following utilities are written to the error file in variable-length format.

  • ADACMP

  • ADADCU

  • ADAINV

  • ADAMUP

  • ADAREC

The structure of the error records is contained as a header file iodesam.h in the subdirectory "Adabas/inc" of the installation directory on both Windows and UNIX.