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, data set 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:
Utility Return Codes
When an Adabas utility returns control to the operating system and no abend has
occurred, the utility writes a return code in the rightmost positions of general
register 15:
| Code |
The utility operation ... |
| 0 |
was successful. |
| 4 |
was successful but encountered a warning condition. |
| 8 |
was not successful. |
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.
For return codes on z/OS, see the job control language reference manual for job step
condition code information.
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.
ADACHK Return Codes
| Return Code 0 |
| Explanation |
ADACHK was successful.
|
| Return Code 4 |
| Explanation |
ADACHK was successful but encountered a warning condition.
With the ADACHK utility, a return code of 4 indicates that either the number of
unreachable index blocks is greater than zero or any
CHKnnnW (warning) message was received.
|
| Return Code 8 |
| Explanation |
ADACHK encountered an error condition but then continued.
With the ADACHK utility, a return code of 8 indicates that a database
inconsistency was encountered.
|
| Return Code 20 |
| Explanation |
The function could not be completed.
The operation encountered an error condition but did not terminate abnormally
because NOUSERABEND was specified.
|
ADACMP Return Codes
| Return Code 4 |
| Explanation |
One of the following occurred:
|
| Return Code 8 |
| Explanation |
The utility detected inconsistencies between the files in a LOB group (a base
file and its associated LOB file).
|
ADADBS Return Codes
| 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 DATAPFAC: The Data Storage padding factor (DATAPFAC) setting is
ignored for files containing spanned records. The following warning will also
appear if DATAPFAC is specified for a file that has data storage spanning
enabled:
*****DATAPFAC is ignored for files with spanned data storage enabled******
-
MODFCB MAXRECL: The 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 (ADARSP009), 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 Codes
| Return Code 4 |
| Explanation |
NEWWORK: Attempt to write RLOG information or close RLOG data set failed.
|
ADAINV Return Codes
| 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 Codes
| 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 data set
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.
-
The utility has processed files in a LOB group (a base file and its
corresponding LOB file) that were incorrectly linked to each other or marked
as being out-of-sync.
-
The utility has been unable to establish or validate the base-to-LOB file
linkage in a LOB group because one of the files was locked or otherwise
unavailable.
-
The utility has been unable to validate the base-to-LOB file consistency in a
LOB group because some input records were not loaded due to the use of the
SKIPREC/NUMREC parameters.
-
The utility has processed a file in a LOB group (a base file and its
corresponding LOB file) where Adabas has been unable to track whether the two
files in the group have stayed in sync.
|
| Return Code 8 |
| Explanation |
One of the following occurred:
-
The input records loaded in a file in a LOB group (a base file and its
associated LOB file) were unloaded from a file that had been marked as being
out-of-sync with the other file.
-
The file in a LOB group (a base file and its associated LOB file) that was
loaded or updated had a different status with respect to LOB updates than the
other file in the LOB group.
-
Inconsistencies were detected in a LOB file from which LOB values were to be
deleted.
|
ADAORD Return Codes
| 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 data set
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.
-
The utility has processed files in a LOB group (a base file and its
corresponding LOB file) that were incorrectly linked to each other or marked
as being out-of-sync.
|
ADARAI Return Codes
| 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 Codes
| 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.
-
All components of an expanded file did not have the same MAXRECL.
-
The utility has processed files in a LOB group (a base file and its
corresponding LOB file) that were incorrectly linked to each other or marked
as being out-of-sync.
|
ADARES Return Codes
| Return Code 4 |
| Explanation |
One of the following occurred:
-
(all functions) Attempt to write RLOG information or close RLOG data set
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 (ADARSP148).
-
PLCOPY: No protection log data sets are currently at completion. No data will
be copied or merged at this time.
-
PLCOPY: Warning! The supplied input intermediate data set 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 data sets 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.
-
The utility has processed a file in a LOB group (a base file and its
corresponding LOB file) where Adabas has been unable to track whether the two
files in the group have stayed in sync.
|
| Return Code 8 |
| Explanation |
One of the following occurred:
-
(Adabas Delta Save Facility Facility) An error occurred in a PLCOPY or COPY function when
processing the delta save images (DSIM) data set. Building the DSIM data set
was discontinued. The PLCOPY or COPY function continued normally. RC 8 is also
given in all cases where the DSIM data set 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
DDSIAUS1 or DDSIAUS2 data set. The error message is printed in DDDRUCK.
|
ADASAV Return Codes
| Return Code 4 |
| Explanation |
One of the following occurred:
-
(all functions) Attempt to write RLOG information or close RLOG data set
failed.
-
(Adabas Delta Save Facility 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.
-
REPLICATION FOR FILE file-number IS SWITCHED OFF BECAUSE REPLICATION IS NOT
ACTIVE.
-
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.
-
The utility has processed files in a LOB group (a base file and its
corresponding LOB file) that were incorrectly linked to each other or marked
as being out-of-sync.
|
| Return Code 16 |
| Explanation |
(Adabas Delta Save Facility Facility) An error occurred after a full or delta save operation completed
successfully.
|
ADASEL Return Codes
| Return Code 4 |
| Explanation |
No records were found matching the selection criterion.
|
ADAULD Return Codes
| Return Code 4 |
| Explanation |
One of the following has occurred:
|
| 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.
|
ADAWRK Return Codes
| Return Code 4 |
| Explanation |
No autorestart information available on Work Part 1
|
| Return Code 8 |
| Explanation |
Autorestart will not complete successfully .
|
| Return Code 20 |
| Explanation |
This return code is returned instead of an abend when the NOUSERABEND parameter
is specified.
|