ADARAI Utility Messages

#### Search Results

Search

# ADARAI Utility Messages

This document describes general ADARAI errors (errors 117-159), ADARAI errors written to the output recovery job (errors 160 to 169), and informational ADARAI messages.

- ADARAI Errors (ERROR-117 - ERROR-159)

- ADARAI Error Messages Written to the Output Recovery Job (ERROR-160 - ERROR-169)

- ADARAI Information Messages

## ADARAI Errors (ERROR-117 - ERROR-159)

### Overview of Messages

`ERROR-117 | ERROR-118 | ERROR-119 | ERROR-120 | ERROR-121 | ERROR-122 | ERROR-124 | ERROR-127 | ERROR-130 | ERROR-131 | ERROR-133 | ERROR-136 | ERROR-138 | ERROR-139 | ERROR-140 | ERROR-141 | ERROR-142 | ERROR-143 | ERROR-144 | ERROR-145 | ERROR-146 | ERROR-147 | ERROR-148 | ERROR-149 | ERROR-150 | ERROR-156 | ERROR-157 | ERROR-158 | ERROR-159`

ERROR-117 | DSIMSIZE/DSIMDEV parameters required
Explanation | ADARAI RECOVER was invoked for a database where the Delta Save Facility was active. In order to run correctly, ADARAI must know the DSIM device type and size of the DSIM data set. This could not be established using the RLOG and the parameters were not provided to ADARAI; therefore, ADARAI operation cannot continue.
Action | Specify the DSIMDEV and DSIMSIZE parameters to ADARAI.

ERROR-118 | Skeleton for job-control contains a keyword placeholder. This is not permitted for this skeleton
Explanation | The skeleton job control for the job-control step in the supplied skeleton job control contained a keyword place holder. This placeholder is not permitted in the job-control step.
Action | Modify the `job-control' step in the skeleton to remove the `keyword' placeholder specification.

ERROR-119 | Skeleton for job-control contained two or more keyword placeholder definitions
Explanation | The skeleton job control for the job-control step in the supplied skeleton job control contained two or more keyword placeholders prior to the next step. Each placeholder should only be specified once in each job control step in the skeleton; otherwise, ADARAI cannot determine which one to use.
Action | Modify the `job-control' step in the skeleton to only specify the `keyword' placeholder once.

ERROR-120 | Skeleton for job-control did not contain required keyword placeholder
Explanation | The skeleton job control for the job-control step in the supplied skeleton job control did not contain the keyword placeholders anywhere prior to the next step. In order to insert the correct replacement data in the appropriate place in the skeleton, the keyword placeholder must be provided at some point in the job-control skeleton.
Action | Modify the `job-control' step in the skeleton to include the 'keyword' placeholder specification.

ERROR-121 | Invalid file number file-number is an invalid file number
Explanation | The file number file-number is greater than the maximum permitted for the database.
Action | Supply a valid file number and rerun the job.

ERROR-122 | Specified DRIVES parameter drives larger than original DRIVES parameter original
Explanation | The ADARAI RECOVER DRIVES parameter was set to drives, however, the original save job was originally run with DRIVES=original. The DRIVES parameter specified for ADARAI RECOVER must be equal to, or less than the original DRIVES parameter. ADARAI ignores the specification and uses the original DRIVES parameter.
Action | Modify the DRIVES parameter to use a valid value.

ERROR-124 | Invalid file number requested. There is not recovery log information for the following file number (s): File=nn
Explanation | The file is not known to the recovery log (RLOG). If the file was created by an ADADBS operation, the required checkpoint was not included in the checkpoint file, and the RLOG has no record of the change.
Action | Supply correct file numbers and rerun the job.

ERROR-127 | RLOG is incorrect version. Execute PREPARE function and rerun the job
Explanation | The RLOG is from a version of the recovery aid prior to version 7.1, but the newer Adabas recovery aid requires an RLOG created by the updated ADARAI PREPARE function.
Action | Run the ADARAI PREPARE function to convert the RLOG.

ERROR-130 | Parameter RLOGSIZE missing or invalid. A minimum of nn blocks is required
Action | Supply a valid RLOGSIZE parameter and rerun the job.

ERROR-131 | Invalid value for parameter MINGENS. The value for this parameter must be in the range 4 through 32
Action | Supply a valid MINGENS parameter and rerun the job.

ERROR-133 | Missing or invalid JCL pattern
Explanation | The input parameter list does not contain a valid pattern string for the JCL to be generated.
Action | Supply a correct JCL/JCS pattern and rerun the job. See the Adabas Utilities documentation for the syntax description.

ERROR-136 | Invalid value for the RELGEN parameter
Explanation | The value is either greater than MINGENS - 1 or, for a Recovery operation, points to a nonexistent generation.
Action | Supply a valid RELGEN parameter and rerun the job.

ERROR-138 | ADARES PLCOPY not acknowledged
Explanation | The Adabas nucleus is not up. ADARAI called the user exit 2 (dual log processing) or user exit 12 (multiple log processing) to submit a job to copy pending data from a protection log. ADARAI waited for the copy to complete; however, the copy did not complete in the time that ADARAI was waiting.

ERROR-139 | ADARES PLCOPY not acknowledged
Explanation | The Adabas nucleus was called with a FEOFPL command to close and copy the current dual or multiple protection log. ADARAI waited for a copy to be submitted and completed as a result of this command; however, the copy did not complete in the time that ADARAI was waiting.

ERROR-140 | ADARAI not permitted to run. The Adabas nucleus returned response nnn.
Explanation | The only acceptable response is 148.
Action | Shut down the nucleus and rerun the job.

ERROR-141 | Internal error occurred in module RAGDOS: GETVIS failure occurred for PUTSPOOL buffer
Action | Increase the size of the partition GETVIS and rerun the job.

ERROR-142 | Internal error occurred in module RAGDOS: PUTSPOOL job submission error. Internal return code is X'nnn'
Action | See the IBM POWER Installation and Operations Manual for corrective action. Then rerun the job.

ERROR-143 | Internal error occurred in module RAGDOS: Invalid calling function determined
Action | Contact your Software AG technical support representative.

ERROR-144 | Internal error occurred in module RAGDOS: CDLOAD failure for ADAIOI
Action | Check the return code for CDLOAD for corrective action and rerun the job.

ERROR-145 | Internal error occurred in module RAGDOS: CDLOAD failure for ADAOPTD
Action | Check the return code for CDLOAD for corrective action and rerun the job.

ERROR-146 | Internal error occurred in module RAGDOS: SUBSID error
Action | Check the return code for SUBSID for corrective action and rerun the job.

ERROR-147 | Internal error occurred in module RAGDOS: GETVIS error
Action | Check the return code for GETVIS for corrective action and rerun the job.

ERROR-148 | Internal error occurred in module RAGDOS: DLBL record length limit
Action | Contact your Software AG technical support representative.

ERROR-149 | Internal error occurred in module RAGDOS: JCL buffer exceeded
Action | Contact your Software AG technical support representative.

ERROR-150 | Internal error occurred in module RAGDOS: LUB tabe exceeded
Action | Contact your Software AG technical support representative.

ERROR-156 | Invalid JCL control keyword
Action | Supply a correct JCL/JCS input and rerun the job.

ERROR-157 | Generation nn is xxxxxxxx
Explanation | ADARAI was not able to LIST or RECOVER a generation because the generation is either erroneous or restricted.
Action | Determine the reason for the problem, correct it, and rerun the job.

ERROR-158 | ADARAI not permitted to run. The Adabas nucleus returned response rc, subcode sc
Explanation | ADARAI was unable to run because of the problem indicated by the Adabas nucleus response code rc and, if relevant, the subcode sc
Action | See the Adabas response code/subcode descriptions.

ERROR-159 | ADARAI PREPARE not permitted to run
Explanation | The RLOG is in an invalid state for PREPARE. If the RLOG is in use, issue an ADARAI REMOVE for the RLOG. If this is a new RLOG, it must be formatted before running ADARAI PREPARE. The RLOGSIZE defined using ADARAI PREPARE must be the same as that previously defined by the SIZE parameter of the ADAFRM RLOGFRM function.
Action | Use ADARAI REMOVE to deactivate the RLOG, or ADAFRM RLOGFRM to reformat the RLOG before running ADARAI PREPARE.

## ADARAI Error Messages Written to the Output Recovery Job (ERROR-160 - ERROR-169)

The following errors are written directly to the output recovery job to

- ensure that the job cannot run without modification, and

- identify the point in the job generation where the error was encountered.

### Overview of Messages

`ERROR-160 | ERROR-161 | ERROR-162 | ERROR-163 | ERROR-164 | ERROR-165 | ERROR-166 | ERROR-167 | ERROR-168 | ERROR-169`

ERROR-160 | The generation used to create the following job was status
Explanation | The generation used to generate the job had a status other than "normal". This indicates that ADARAI determined at some time during the creation of the generation that the job it would generate could not run without changes by the user.
Action | Determine the reason for the status and modify as appropriate. When the generation is "restricted", a later message indicates where the generation actually became restricted. Generally, such jobs run successfully with intervention. If the generation is "erroneous", it is impossible to know what caused this during the recovery phase; therefore, you must determine what caused the problem and correct it in the recovery job if possible and appropriate.

ERROR-161 | No full save data set available in generation
Explanation | The generation being recovered has no full save data set associated with it. This should only occur for the first generation allocated by default after the RLOG is prepared.
Action | Determine the last full save data set prior to the generation and insert a step to restore this prior to using the generated recovery job. Any steps that took place between the time the full save was taken and the RLOG became available must also be inserted here to insure that the recovery job runs and that the resulting data is valid.

ERROR-162 | Missing PLOG data set information PLOG number = plog low PLOG block = lowblk [NUCID nucid] high PLOG block = highblk [NUCID nucid]
Explanation | During the generation of the recovery job, ADARAI determined that it needed the range of PLOG blocks listed in the message; however, these PLOG blocks were not recorded in the generation being recovered. This may occur if the generation was restricted, or a PLCOPY step to copy a PLOG failed to record its execution on the RLOG data set. When it is nonzero, a cluster nucleus ID is appended after the low and high PLOG block number.
Action | Determine the PLOG on which the range of blocks is located and add this data set to the job at the appropriate point as identified by the location of the message.

ERROR-163 | Generation became restricted following this step
Explanation | This identifies the point in the recovery job at which the generation became "restricted" and the reason why it was restricted. With user intervention, it should be possible to handle the reason for the generation becoming restricted and thus to enable the recovery job to successfully recover the database.
Action | Take appropriate action to handle the reason for the restriction.

ERROR-164 | No session end record found Insure all PLOGs are included prior to next utility run
Action | ADARAI encountered an off-line utility execution at a point where a session start record was found but no session end record was found. This indicates that the nucleus session terminated abnormally prior to the off-line utility being executed. This means that ADARAI cannot determine precisely what the last PLOG block of that session was and can only attempt to include all PLOG blocks it knows about for that session.
Action | Ensure that all PLOGs for that particular session are provided to the REGENERATE prior to the utility step about to be executed. Additional PLOGs for the session, not known to ADARAI, can be added at the end of the DD/SIIN statement.

ERROR-165 | No RESTPLOG entry found
Explanation | A RESTONL request was encountered that is normally followed by a RESTPLOG entry indicating the PLOGs that must be provided to the RESTONL for it to complete successfully. In this case, no RESTPLOG entry could be found relating to the RESTONL function that was encountered. Under normal circumstances, this can only occur if the RESTONL function fails during the PLOG processing stage and the RESTPLOG is not repeated stand-alone.
Action | Determine if the RESTPLOG was in fact successfully issued but not recorded on the RLOG. If so, the appropriate PLOGs can be added to the RESTONL step based on the information in the RESTPLOG job itself.

ERROR-166 | No starting PLOG information found
Explanation | While building the recovery job, ADARAI encountered a utility operation that was run online; however, no preceding nucleus sessions start record was encountered. This can only occur if the generation is "restricted" or the session start logging to the RLOG failed.
Action | If there is no reasonable explanation why this occurred, contact your Software AG technical support representative.

ERROR-167 | RESTPLOG encountered out of sequence SYN1 PLOG block =plogblk [NUCID nucid] SYN2 PLOG block =plogblk [NUCID nucid]
Explanation | Under normal circumstances, a RESTPLOG request is only encountered in association with a RESTONL utility operation. In this case, a RESTPLOG was encountered for the PLOG blocks identified with no preceding RESTONL request. When it is nonzero, the cluster nucleus ID is appended after the block number.
Action | Determine how the RESTPLOG entry occurred at that point and determine if the recovery job will run successfully without that step.

ERROR-168 | Job contains one or more errors
Explanation | While building the recovery job, ADARAI detected one or more errors that have rendered the generated recovery job not executable.
Action | Correct the errors identified earlier in the job and run the job if it can be successfully repaired based on the errors that have occurred.

ERROR-169 | The previous step was incomplete
Explanation | The ADARAI data collection mechanism was notified that the step prior to this message was preparing to complete its processing; however, a `commit' record was not written for the utility execution indicating that either it did not run to completion or the commit record could not be written.
Action | Determine the reason for the failure to complete the information on the RLOG. If the recovery job can run successfully without the failing step, remove the step completely from the recovery job. If required, make the appropriate corrections to the job step.

## ADARAI Information Messages

### Overview of Messages

`INFO-001 | INFO-002`

INFO-001 | The following PLOG numbers were not used: low PLOG number lowplog [NUCID nucid] high PLOG number highplog [NUCID nucid]
Explanation | During its PLOG validation processing, ADARAI checks to see whether the PLOG session numbers it encounters are in sequential ascending order (e.g., PLOG 8 follows PLOG 7, PLOG 7 follows PLOG 6 and so on). When it encounters a situation where this is not the case, this message is issued identifying the range of `missing' PLOGs. This can occur when online saves are used. When it is nonzero, a cluster nucleus ID is appended after the session number.

INFO-002 | File number file deleted
Explanation | During optimized ADARAI RECOVERY processing, a deleted file may simply not figure in the recovery job itself. This message is issued to register the fact that the file number `file' was deleted during the generation being recovered.