Version 7.4.4
 —  Messages and Codes  —

Utility Messages and Codes

The Adabas utilities issue return/condition codes, and may also display error messages. This document lists, alphabetically by utility, the utility error messages and describes the utility nonzero return codes.


Utility Error Messages

Utility messages are displayed following a title line showing the utility name. The message line itself is displayed, followed by the same "explanation" and/or "action" information shown in this chapter.

Variable information such as jobname, dataset name, return code, abend code, or nucleus response code may occur in the message line or in the text following the actual message. These variables are represented in lowercase as either "xxx...xxx" or as "reason", "nucleus-response", "job-name", "ret-code", and so on. In the actual message these notations are replaced with the actual values. Generally, variables within parentheses ( ) are hexadecimal and those without parentheses are decimal.

When a message includes a nucleus response or abend code, the specific code description identifies the cause. See the description of nucleus response codes and abend codes.

Error messages are described for the following utilities:

Common error messages (ERROR-001 - ERROR-120)
ADAACK ADADEF ADAORD ADASAV
ADACDC ADAFRM ADAPLP ADASEL
ADACMP ADAICK ADAPRI ADAULD
ADACNV ADAINV ADARAI ADAVAL
ADADBS ADALOD ADAREP ADAZAP
ADADCK ADAMER ADARES  

Top of page

Utility Return Codes

When an Adabas utility returns control to the operating system and no abend has occurred, the utility writes a return codes in the rightmost positions of general register 15:

Code The utility operation ...
0 was successful.
4 was successful but encountered a warning condition.
8 encountered an error condition but then continued.
16 was successful in its main function but then encountered an error condition.
20 could not be completed. The operation encountered an error condition but did not terminate abnormally because NOUSERABEND was specified.

Note:
Note: Utilities that terminate with return code 4 write "...terminated with warning" as the last message. This indicates that, although the utility function completed successfully, circumstances may have rendered the result of the function different from that which was expected. The job protocol contains one or more related warning or error messages.

Return codes are supported by operating system as described in the following table:

Op Sys Return Code Support
OS/390 z/OS See the job control language reference manuals for job step condition code information.
VM/ESA z/VM The command language keeps track of the return code.
VSE/ESA Return codes are supported.
BS2000 Return codes are supported using job variables. For more information, see the Adabas Installation documentation, section How to Manage Job Variables in the Adabas Environment.

Depending on the operating system and the utility, the return code can be tested to determine the utility job status:

These unsuccessful return code (RC) meanings are described here in alphabetical order by Adabas utility.

ADAACK

Return Code 4 or 8
Explanation:

Database inconsistency.


ADACMP

Return Code 4
Explanation:

At least one rejected record.


ADADBS

Return Code 4
Explanation:

One of the following occurred:

  • CHANGE, NEWFIELD, or RELEASE: The operation was performed on a component file of an expanded file. The other component files must be processed explicitly.

  • MODFCB: MAXRECL must be the same for all component files.

  • OPERCOM ADAEND/CANCEL: The Adabas nucleus was not active.

  • OPERCOM CLUFREEUSER: One or more otherwise eligible UTEs were not deleted because they were due a response code 9, subcode 20, and FORCE was not specified.

  • OPERCOM DUQE: The user queue element (UQE) for the specified user ID was not found.

  • RESETDIB: The IDENT job name was not found.


Return Code 8
Explanation:

One of the following occurred:

  • DELETE: The file to be deleted was not found.

  • OPERCOM STOPU: The function received an Adabas response code.

  • RELEASE: An invalid descriptor name was specified, or the function received an Adabas response code.


ADADEF

Return Code 4
Explanation:

NEWWORK: Attempt to write RLOG information or close RLOG dataset failed.


ADADCK

Return Code 4 or 8
Explanation:

Database inconsistency.


ADAICK

Return Code 4
Explanation:

One of the following occurred:

  • GETMAIN failed.

  • ICHECK detected WARNING-163 (unreachable index blocks).


Return Code 8
Explanation:

Database inconsistency.


ADAINV

Return Code 4
Explanation:

One of the following occurred:

  • The utility's DIB entry was removed by another user during ADAINV operation.

  • (all functions) Attempt to write RLOG information or close RLOG database failed.

  • ADAINV was restarted, but at least one of the descriptors to be inverted was already in the index. The index is correct.

  • ADAINV INVERT was run on a component file of an expanded file. The other component files must be explicitly inverted.


ADALOD

Return Code 4
Explanation:

One of the following occurred:

  • More DDEBAND records were available than specified by the NUMREC parameter.

  • More DDEBAND records were available than ISNs for those records.

  • The utility's DIB entry was removed by another user during ADALOD operation.

  • The file to be loaded could not be added to the expanded file chain.

  • (all functions) Attempt to write RLOG information or close RLOG dataset failed.

  • In an UPDATE function, the allocation of a file-specific DLOG extension failed. ADALOD completed the UPDATE function, but marked the whole file as changed; it did not log the Data Storage and address converter RABNs of blocks that were actually changed.


ADAORD

Return Code 4
Explanation:

One of the following occurred:

  • The utility's DIB entry has been removed by another user during ADAORD operation.

  • (all functions) Attempt to write RLOG information or close RLOG dataset failed.

  • RESTRUCTURE functions: Initialization of RLOG processing failed.

  • RESTRUCTUREDB: Attempt to initialize RLOG access failed.

  • RESTRUCTUREF: Attempt to initialize RLOG access failed.

  • A system file was excluded from ADAORD STORE operation.

  • MAXRECL was specified for a component of an expanded file. Ensure that the same MAXRECL is specified for all components.

  • Allocation of the DLOG extension failed.

  • Nonzero return code received from ADARAC.


ADARAI

Return Code 4
Explanation:

ADARAI RECOVER cannot create the job control statements needed for the sequential file used during utility execution. The message "unknown file element" is returned and the RECOVER function completes with return code 4. The generated job control must then be edited. See message ADAR78.


ADAREP

Return Code 4
Explanation:

One of the following occurred:

  • An overlap of file extents or of file extents and free space extents was detected.

  • A gap between file extents or between file extents and free space extents was detected.

  • A checkpoint contains an unknown checkpoint type or format.

  • The field definition table (FDT) does not exist for the existing file control block (FCB).

  • The FCB contains an invalid file number.

  • A bad ISN/RABN length indicator was detected in the FCB.

  • At least one parent field in the FDT has no corresponding special descriptor table (SDT) field.

  • An invalid FDT/SDT length was detected.

  • The count of coupled files is greater than 18.

  • There are inconsistencies in the expanded file chain.

  • The volume serial number could not be identified.

  • For a report from an online save tape, either no protection log was specified, an invalid protection log was specified, or an error was encountered while processing the protection log.

  • CPLIST or CPEXLIST was specified in conjunction with SAVETAPE.

  • FROMDATE, TODATE, FROMSESSION, or TOSESSION was specified without CPLIST or CPEXLIST.

  • NOCOUNT was not specified in conjunction with SAVETAPE.

  • An error occurred converting the mirror table to version 7 format.

  • All components of an expanded file did not have the same MAXRECL.


ADARES

Return Code 4
Explanation:

One of the following occurred:

  • (all functions) Attempt to write RLOG information or close RLOG dataset failed.

  • COPY: A block count mismatch occurred.

  • PLCOPY: Attempt to initialize RLOG access failed.

  • PLCOPY: Attempt to open Adabas nucleus failed with a response code other than zero or 148.

  • PLCOPY: No protection log datasets are currently at completion. No data will be copied or merged at this time.

  • PLCOPY: Warning! The supplied input intermediate datasest is empty. This should only happen on the initial run of ADARES. Processing continues.

  • COPY/CLCOPY/PLCOPY: No records to be copied.

  • COPY/PLCOPY/CLCOPY: The Associator datasets could not be opened; therefore, no checkpoints have been written.

  • The point indicated by TOPLOG/TOBLK/TOCP could not be found.

  • BACKOUT and REGENERATE: No records to be processed were found.

  • REGENERATE found batch utility runs which must first be executed before REGENERATE can complete.

  • The parallel participant table (PPT) indicates that there are currently no PLOGs to be copied for this cluster database.

  • The parallel participant table (PPT) indicates that there are currently no CLOGs to be copied for this cluster database.


Return Code 8
Explanation:

One of the following occurred:

  • (Adabas Delta Save Facility) An error occurred in a PLCOPY or COPY function when processing the delta save images (DSIM) dataset. Building the DSIM dataset was discontinued. The PLCOPY or COPY function continued normally. RC 8 is also given in all cases where the DSIM dataset is necessary but is not available or is not usable.

  • REGENERATE or BACKOUT function determined that one or more files in the file list were in an inconsistent state; that is, in load, reorder, refresh, or restore status. Processing continues for all other files in the file list.


Return Code 16
Explanation:

An error occurred after the PLCOPY/CLCOPY function successfully closed the DD/SIAUS1 or DD/SIAUS2 dataset. The error message is printed in DD/DRUCK.


ADASAV

Return Code 4
Explanation:

One of the following occurred:

  • (all functions) Attempt to write RLOG information or close RLOG dataset failed.

  • (Adabas Delta Save Facility) The nucleus returned a response code after ET synchronization at the end of an online save operation, but the online save operation was nevertheless completed successfully. The response code was ignored by ADASAV.

  • The utility's DIB entry was removed by another user during ADASAV operation.

  • MERGE: Attempt to initialize RLOG access failed.

  • RESTORE (database) or RESTORE GCB: Attempt to initialize RLOG access failed.

  • RESTORE could not be performed for a file that was already present because OVERWRITE was not specified.

  • RESTONL (database) or RESTONL GCB: Attempt to initialize RLOG access failed.

  • SAVE could not be performed on a file that was inaccessible. The file is in load, refresh, reorder, or restore status.

  • SAVE FILE: Attempt to initialize RLOG access failed.


Return Code 16
Explanation:

(Adabas Delta Save Facility) An error occurred after a full or delta save operation completed successfully.


ADASEL

Return Code 4
Explanation:

No records were found matching the selection criterion.


ADAULD

Return Code 4
Explanation:

One of the following has occurred:

  • No records were found using ADAULD selection criteria/values.

  • UNLOAD: Attempt to initialize RLOG access failed.


Return Code 8
Explanation:

The nucleus returned a non-zero response code. Depending on the ERRLIM parameter of ADAULD UNLOAD, the function may continue. Unloaded data can be used, but records may be missing depending on the particular response code returned.


ADAVAL

Return Code 4
Explanation:

Not all files were validated.


Return Code 8
Explanation:

Database inconsistency.


Top of page