ADARnn System Messages

The LOAD or CDLOAD macro failed and ADARUN was not able to load ADAIOR. ADARUN issues a message and ends with an abnormal end (abend). "load-name" is either LOAD for LOAD (SVC 4) or CDLO for CDLOAD (SVC65). "ret-code" is the return code from the CDLOAD or LOAD macro, and can have the following meanings:

Return codes from the CDLOAD macro include

Return codes from the LOAD macro include

A logic error occurred during ADARAI processing either while collecting information during a utility or nucleus run, or while executing the ADARAI utility itself. The logic error is identified by the module and offset and the registers at the time of the error are provided in subsequent lines of the message.

Contact your technical support representative. Provide the actions required to trigger the error and the text of the error message itself.

An I/O error occurred during an operation, identified by the 'action' value, which was issued against a dataset by the Adabas Recovery Aid collection or utility component. The dataset is identified by the 'file' value and the error will be identified by the 'error' value.

The 'error' value indicates the error that occurred while accessing the identified dataset.

The database ID for the database in the GCB is 'asso-dbid', which does not correspond with the database ID with which the RLOG was initialized ('rlog-dbid'). This message is issued by the Adabas Recovery Aid collection component and causes the utility operation or nucleus initialization request to fail.

Either the RLOG used for this utility run was not initialized to run with the database in use, or the database ID of the database was changed. In this case, the RLOG must be reinitialized using the ADARAI PREPARE function.

A utility operation was executed that caused a new generation to be started. The number of this new generation, which becomes the current generation, is 'gen-num'. This message is issued by the collection component of the Adabas Recovery Aid when a new generation is started.

The ADARAI data collection component was called for request 'request'; however, this request terminated with a return code and reason code as shown by 'rc' and 'reason' respectively. If 'rc' is less than 8, the request completed successfully but messages may have been issued. If 'rc' is 8 or greater, the request failed.

In many cases, this error is issued due to a situation highlighted by a previous Adabas or system message. However, if there is no obvious reason why this message has been issued, report the message to your technical support representative.

The Adabas Recovery Aid utility component attempted to obtain 'reqsize' bytes of storage for its processing but only succeeded in obtaining 'stgsize' bytes of storage. ADARAI processing fails.

Increase the amount of storage available to ADARAI by at least 'reqsize'-'stgsize' bytes.

The Adabas Recovery Aid collection or utility component attempted to open the RLOG dataset DDRLOGR1 but the file was not available to the job.

Provide the DDRLOGR1 file to the job and rerun the job.

The Adabas Recovery Aid collection or utility component attempted to open the RLOG dataset ; however. an open error occurred as identified by the 'error' value. This indicates that the DDRLOGR1 file has been found but some other error occurred.

Correct the error indicated by the 'error' value and rerun the job.

When the Adabas Recovery Aid collection component encounters any sort of problem, it attempts to set the status of the current generation to indicate that problems occurred while recording the generation. In the case where this message is issued, it was not possible to set the failure in the RLOG dataset. This is particularly serious because the current generation will appear to be in a normal status but data will be missing. An attempt to use this generation to recover the database will probably lead to data being lost or invalid.

The Adabas Recovery Aid data collection interface terminates abnormally with abend code 33, which means that the utility or nucleus run will also be terminated abnormally.

A new generation should be started immediately for the database in question and a note kept that the generation for which this error occurred is invalid. You should then proceed to determine what the problem was based on other error messages issued prior to this error message. If necessary, contact your technical support representative for assistance.

This message is issued by the Adabas Recovery Aid collection component when the current generation has any status other than the 'normal' status. It is issued when the ADARAI data collection interface is called to insure that the user is aware that the current generation is in a state that may not be automatically recovered.

This is an information message and may be ignored if the status of the RLOG is acceptable to the installation. If not, a new generation should be started as soon as possible and the cause of the abnormal status for the generation investigated.

When the Adabas Recovery Aid utility ADARAI is building a given generation, it checks to make sure that all PLOGs required by the generation are available to it. This is based on the normal sequence of PLOG entries from the start of the generation to the end of the generation. When ADARAI expects a given range of PLOG blocks to be available but cannot find the relevant PLOG in its data, this message is issued. The data values provided are as follows:

This can happen if the current generation is the subject of the operation and the nucleus was not down at the time, or the last PLOG copy job had not completed. If this is not the case, it indicates that one or more PLCOPY jobs failed to record their information on the RLOG. To determine when and why this happened, refer back to the PLOG job that copied the blocks in question to determine why the data was not written to the RLOG dataset.

After certain events on a database, ADARAI cannot generate a recovery job which will recover the database or files on the database without changes. When this occurs, the Adabas Recovery Aid collection component sets the generation into which the data is logged to the "restricted" status. This message is issued when this occurs and 'reason' identifies why the generation was set to "restricted".

This message is for information only, however, it is recommended that once this message has been issued, a new generation is started as soon as possible to insure that a generation is available with a "normal" status.

The minimum number of generations in the RLOG dataset are using more than 50% of the RABNs available on the dataset. This fact is determined when the Adabas Recovery Aid collection component writes information to the RLOG dataset. Successful completion of the current nucleus or utility session is not affected by the situation. The meanings of the variable values are as follows:

None required. This message is for your information only.

The Adabas Recovery Aid data collection component attempted to write information for the current generation; however, the current generation does not fit on the RLOG and none of the other generations on the RLOG could be deleted. RLOG logging stops. Information for the current session could not be completely logged, and no further information will be logged. This does not affect successful completion of the current nucleus or utility session.

Run the ADARAI LIST utility function to archive the existing RLOG information and/or back up the RLOG dataset. Increase the size of the RLOG. Finally, run ADARAI PREPARE followed by an ADASAV SAVE (database) to reestablish the RLOG logging operation.

The Adabas Recovery Aid data collection component was unable to provide the ADARAI utility with information about the sequential file used during utility execution. An "unknown file element" was written to the RLOG instead of a "file element". This does not affect successful completion of the current nucleus or utility session.

Information about this sequential file can be recorded manually for later use in the ADARAI RECOVER function. If an ADARAI RECOVER function is executed using this generation/file, the job control statements needed for this file cannot be created. Instead, the "unknown file element" will be displayed and the ADARAI RECOVER function will complete with a return code of 04. The generated job control must then be edited to add the manually recorded file information.