ADACDC Utility Messages

ADACDC attempted to open the file filename but the open failed. Processing cannot continue with this file; utility execution is terminated.

Provide the missing file in the ADACDC job.

An error occurred reading the file filename; utility execution is terminated. This error generally occurs when the format of the file indicated is not valid.

Ensure that the file in question has a valid format as specified in the ADACDC documentation. In addition, check any special considerations for the operating system where the utility is being executed.

An error occurred writing to the file filename; utility execution is terminated. This error normally occurs when the output file is full, but it may also occur when the format of the file indicated is not valid.

If the file is full, increase the size of the file and rerun the job. Otherwise, ensure that the file in question has a valid format as specified in the ADACDC documentation. In addition, check any special considerations for the operating system where the utility is being executed.

The ADACDC utility was not able to write data to the file filename because the amount of data to be written exceeded the maximum data that could be written to this file. Additional input in the message indicates the length of data that was to be written and the maximum data that can be written to the file.

Increase the block size on the file to accommodate the largest record that may be written to the file.

The ADACDC utility opened the CDCTXI file and successfully read the first record; however, the first record is not a transaction file record produced by the ADACDC utility.

Supply a valid input transaction file to the utility or specify the RESETTXF so that the CDCTXI specification is ignored if the file name is correct.

The ADACDC utility encountered inconsistent input while processing the input PLOG data. It was expecting the next block based on the values olddbid, oldplog, and oldblock, but found that the next block to be processed was newdbid, newplog, and newblock. This can occur if

• a PLOG is encountered that was produced by a different database ID;

• newplog and oldplog are the same, but newblock is not 1 more than oldblock, or newplog is less than oldplog.

PLOGs must be provided to the ADACDC utility in the chronological order in which they were created. Provide the PLOG input in the correct chronological order. If this has occurred due to information on the input transaction file and you still wish to process the PLOGs provided, specify the RESETTXF option.

An error occurred while decompressing a record (on file file for ISN number isn, field name name, and PE Index peindex) before writing it to the primary output file. The record cannot be decompressed. This can occur if

• the FDT for a file has changed; or

• a data area longer than the default for the field in the FDT has been written, which can legally occur.

The record is written with an indication that decompression failed.

If the FDT has changed, the record cannot be decompressed unless the FDT is changed back. If the record(s) being written are longer than the default value for the field in the FDT, either increase the default value to accommodate the larger field sizes or avoid writing fields longer than the default value.

The CDCTXI file was successfully opened but was empty; no transaction information is available.

If you are aware that the input transaction file is empty, you can ignore this warning; however, if you expect the input transaction file to contain some data, you need to determine why ADACDC is seeing an empty file.

The value specified for the PHASE parameter is invalid.

Specify "1", "2", or "BOTH", as appropriate.

A data record is decompressed before writing to the primary output file. Before the record can be decompressed, the FDT for the file file must exist in the database. In this case, the FDT was not found; so the record could not be decompressed. Processing for the file is disabled after this message is issued.

Make the FDT for the file available again in the database and rerun the job with FILE=file to process the records for the file in question.

The first record was read from the extract file provided for a phase 2 execution of the ADACDC utility. This record indicates that the extract file was generated for the extdbid database; however, the ADARUN DBID is rundbid.

Run the phase 2 job using the correct database.

ADACDC detected that NOET was specified on the previous run of ADACDC, but not on this run-or vice versa. Changing the NOET parameter between runs renders the data on the transaction file redundant; therefore, this data is ignored.

If this is expected, the message may be ignored. If it is not expected, you should determine why the ADACDC utility is being run with different options.

Before writing the ISN (isn) for the file (file) to the primary output data set, an attempt was made to decompress the data. This attempt failed because the maximum length of output that can be written to the primary output data set is not large enough to accommodate the decompressed record. The record is written to the primary output data set with an indicator in the CDCO/CDCH header that the record is still in compressed format.

Increase the block size of the primary output data set. If the data record requires more than 32K when decompressed, it cannot be supported by the ADACDC utility.

A decompression error occurred while decompressing the data record for the unique sequential number seqnum for ISN isn on file file prior to output to the primary output data set. The return code (rc), response code (rspcode), and subcode (subcode) are given in the message. The record is written to the primary output data set with an indicator in the CDCO/CDCH header that the record is still in compressed format.

Report the error to your DBA.

The error limit is exceeded if the combined number of WARNING-127, WARNING-133, or WARNING-134 messages exceeds 99. This error generally indicates a fundamental problem with FDT definition(s) that should be corrected.

Correct the reason for some or all of the warning messages and rerun the job.

While reading the input PLOGs, ADACDC detected that the PLOG number jumped from currplog to nextplog indicating that PLOG numbers in between may have been skipped.

This can legally occur during online saves because they increase the session number without the PLOG number being changed. This causes the next PLOG started to use a number more than 1 greater than the previous PLOG.

If that does not explain the difference, verify that all appropriate PLOGs for the database have been provided in sequence.

PLOGS of earlier Adabas versions cannot be handled by this version of ADACDC.

Use the ADACDC from the load library of the appropriate version.

The protection log (PLOG) was created by an Adabas cluster nucleus and has not yet been merged with other PLOGs using an ADARES PLCOPY procedure.

Use the ADARES PLCOPY function before extracting data using ADACDC.

The IGNORESPANNED parameter was supplied. All spanned records found in the PLOG will be ignored.

If processing spanned records is required, omit the IGNORESPANNED parameter and rerun the ADACDC job. Otherwise, no action is required for this informational message.

A standalone secondary segment (that is, a secondary segment without a primary segment) of the spanned record identified with the unique sequential number seqnum for primary ISN isn on file file was encountered in the protection log (PLOG). This segment cannot be decompressed. The record is written to the primary output data set with an indicator in the CDCH header that the record is still in compressed format.

No action is required for this informational message. Probably Adabas was started with the ADARUN nucleus parameter SRLOG=UPD, which instructs the nucleus to write to the PLOG only modified spanned record segments. If it is necessary to include all spanned PLOG records into ADACDC processing, restart the Adabas nucleus after changing the ADARUN SRLOG parameter to ALL or PART.

The primary and secondary segments of a spanned record are connected using their ISNs. A secondary segment was found in the PLOG with a different ISN from what was expected.

Report this problem to your DBA.

The length of the buffer for assembling spanned records is not large enough to contain the complete spanned record.

Report this problem to your DBA.

The number of segments of a spanned record exceeds the SEGLFAC value (maximum number of spanned record segments allowed in one spanned record).

Report this problem to your DBA.

The value specified for the MAXLOGRECLEN parameter is too small. Valid values must be at least 32768 bytes.

Correct the parameter value and rerun the job.

If you specify the DST parameter, you must also specify a valid TZ parameter.

Supply the correct parameter values and rerun the job.

If you do not specify the TZ parameter, values of date-time fields with TZ option are not converted to local time but left in UTC format.

Supply the TZ parameter for the desired local time or set TZ='Etc/UTC' (to avoid the warning message) and rerun the job.

The specified timezone could not be processed.

Depending on the subcode, verify that the correct timezone was specified, that TZINFO assigns to the Timezone library (ADAvrs.TZ00) and that the timezone file is unmodified. Supply the correct parameter values and rerun the job.

If the error cannot be solved, contact your Software AG technical support representative for assistance.

An error occurred during an attempt to invoke the external sort routine. The return code (rc) and IOR return code (ior-rc) are given in the message.

Investigate the return code to determine why the problem occurred. Make appropriate corrections and rerun the job.