SQL2501C The database was restored but the data in the restored database was unusable.

Explanation

The RESTORE utility either could not read data from the restored database or only a portion of the database was restored. Both cases indicate that the restored database is not usable.

The database is unusable and the RESTORE utility stops processing.

User response

Resubmit the RESTORE command.

SQL2502C An error occurred while reading the backup files. Either the disk could not physically be read or the specified disk did not contain a valid backup.

Explanation

An operating system error occurred when the RESTORE utility was reading the diskette or disk, or the diskette or disk does not contain a backup of the database directory or does not contain the results of any previous backup.

The utility stops processing.

User response

If the input drive specified is a diskette drive, check the diskette being used. If the input drive is a hard file, verify that it is the correct hard file. Resubmit the command with the correct input drive and the correct diskettes, if applicable.

SQL2503N The RESTORE was not successful. The backup used to restore the database contained the wrong database.

Explanation

The name of the database contained on the backup disk does not match the database name specified on the RESTORE command. The RESTORE utility cannot determine the name until after the database has been restored because a previous release backup image was restored.

The utility stops processing.

User response

If the wrong database name was used in the command, resubmit the command with the correct database name. If the input drive specified is a diskette drive, check the diskette being used. If the input drive is a hard file, verify that it is the correct hard file. Resubmit the command with the correct input drive and the correct diskettes, if applicable.

SQL2504W Insert the first backup diskette into drive drive.

Explanation

The RESTORE utility reads the first backup diskette to determine the path of the database directory that was backed up. If the backup media is a diskette and the diskette is not found in the specified input drive, the utility returns to the caller with this prompt. The calling program is expected to query the user and return to the utility with the user response.

The utility waits for a response from the caller.

User response

Prompt the user for the diskette and return to the utility with the callerac parameter, indicating if processing continues or ends.

SQL2505W Warning! Database name resides on drive drive. The files for this database will be deleted.

Explanation

If the database being restored already exists, its files will be deleted before the restore process starts. The utility returns to the caller with this warning. The caller is expected to query the user and return to the utility with the user response. Once the database is dropped, it cannot be accessed again.

The utility waits for response from the caller.

User response

Warn the user that the database files will be deleted and return to the utility with the callerac parameter indicating if processing continues or ends.

SQL2506W The database was restored, but there may be extra files in the database.

Explanation

If changes-only backups were performed and database files were deleted between backups, the RESTORE utility adds these deleted files back into the database. The restore process could not delete the extra files either because of an I/O error or by the failure of an internal connection to an internally stopped database.

The utility ends successfully.

User response

Either use the database as it is or attempt to restore it again. Ensure that the DB2 configuration is compatible with the restored database configuration before rerunning the RESTORE utility.

SQL2507W The RESTORE utility is not bound to the database correctly.

Explanation

Because the RESTORE utility was not bound to the database or the package of the utility that was bound to the database is not compatible with the installed version of DB2, all the utilities have been rebound to the database. But there is a timestamp conflict between the installed version of the database product and the package so the utility and bind file are not compatible.

The database is restored, but the utility is not correctly bound.

User response

Reinstall DB2 or reapply recent updates and resubmit the utility command.

SQL2508N The Database Restore timestamp parameter timestamp is not valid.

Explanation

The timestamp parameter must contain either NULL or a portion of a valid timestamp, the portion consisting of complete components of a timestamp.

User response

Resubmit the Restore operation with a valid timestamp value.

SQL2509N The database drive parameter is not valid.

Explanation

The drive specified does not exist, or the database does not exist on this drive or is not cataloged on this drive. RESTORE should use the db2uexit command to perform the database restore.

The utility stops processing.

User response

Resubmit the utility command with a valid drive.

SQL2510N An operating system semaphore error occurred.

Explanation

An error occurred in the wait or post semaphore.

The utility stops processing.

User response

Stop the database manager, then restart it and resubmit the utility command.

SQL2511N The utility encountered an error error while dropping the database.

Explanation

The utility could not drop the database.

The utility stops processing.

User response

Look at the error number in the message for more information. Make changes and resubmit the command.

SQL2512N The utility encountered an error error while creating the database.

Explanation

The utility could not create the database.

The utility stops processing.

User response

Look at the error number in the message for more information. Make changes and resubmit the command.

SQL2513N The utility encountered an error error renaming the database.

Explanation

The utility could not rename the database.

The utility stops processing.

User response

Look at the error number in the message for more information. Make changes and resubmit the command.

SQL2514N The RESTORE was not successful. The backup used to restore the database contained a database with a release number that is not compatible with the installed version of the database manager.

Explanation

The release number of the restored database is not compatible with the release number of the installed version of the database manager.

The utility stops processing.

User response

Resubmit the command with a backup that is compatible with the release level of the database manager.

SQL2515N The user does not have the authority to run the RESTORE DATABASE utility against the database.

Explanation

The user attempted to execute the RESTORE DATABASE utility without SYSADM authority.

The utility stops processing.

User response

Ensure that you have the appropriate authorization to run the RESTORE DATABASE command.

SQL2516N The RESTORE utility cannot complete because at least one database on the workstation is in use.

Explanation

In some situations, the RESTORE utility can attempt to move a database to a directory by renaming the directory associated with the database. This cannot be done if any databases are in use in any process on the workstation.

The utility stops processing.

User response

Wait until no databases on the workstation are in use and resubmit the command.

SQL2517W The database was successfully restored and then upgraded to the current release. However, the database operation returned warning or error code warn-err-code and runtime tokens tokens.

Explanation

You can upgrade a database from one version to a newer version using the restore utility. You can upgrade by recreating your old database manager instance in the new version and then restoring a backup image from the the old instance into the new instance. In this scenario, after restoring the database in the new database instance, the restore utility automatically performs the upgrade operation. This message is returned when the upgrade operation that the restore utility automatically runs returns a warning or error.

User response

Respond to this message by performing the following troubleshooting steps:

  1. Review the text of the warning or error code listed in the runtime token warn-err-code.
  2. Respond to the warning or error code listed in the runtime token warn-err-code before accessing the upgraded database.

The user who issued the RESTORE DATABASE command is given DBADM authority to the database. If other users had DBADM authority prior to the restore, work with a user who has SECADM authority, to grant DBADM authorization to these users.

SQL2518N The RESTORE was not successful. An I/O error occurred while trying to restore the database configuration file.

Explanation

The database configuration file could not be restored due to an I/O error.

The utility stops processing.

User response

Determine whether the I/O error can be corrected. Resubmit the command.

SQL2519N The database was restored but the restored database was not upgraded to the current release. Error sqlcode with tokens tokens is returned.

Explanation

The database backup that you restored is from a previous database product release. After the database files were restored, an attempt was made to upgrade the database to the current release. The database upgrade failed.

The database restore was completed but the database was not upgraded.

User response

Review the SQLCODE (message number) returned for more information. Make any corrections and issue the UPGRADE DATABASE command before accessing the database.

SQL2520W The database was restored. The backup version of the configuration file was used.

Explanation

When a database is restored, the current database configuration file is not always replaced with the backup version. The current database configuration file was not usable. It has been replaced by the backup version.

The utility completed successfully.

User response

Some values in the database configuration file may be different after the restore process. Check that the configuration parameters are set to the desired values.

SQL2521W The database was restored, but an I/O error code occurred while deleting file type file-type.

Explanation

The restore process ran successfully. The specified file was not deleted due to an I/O error.

A file with the extension “.BRG” is used to determine whether a RESTORE operation has terminated abnormally. The file resides in the local database directory of the database for which the RESTORE operation was attempted.

A file with the extension “.BRI” stores information about the progress of an incremental RESTORE operation. The file resides in the local database directory of the database for which the RESTORE INCREMENTAL operation was attempted.

The file name consists of the database token concatenated with the file type extension. For example, if the database “SAMPLE” is assigned the database token “SQL00001”, the BRI file will have the name “instance/NODE0000/sqldbdir/SQL00001.BRI”.

The utility completed successfully.

User response

Delete the .BRG or .BRI file manually. If the file cannot be deleted, contact your technical service representative.

SQL2522N More than one backup file matches the time stamp value provided for the backed up database image.

Explanation

The backup image file file name consists of a database alias and a time stamp component. A file name is constructed from the source database alias and time stamp parameters provided in the Database Restore call. A portion of a time stamp may have been specified so that a match with more than one backup image file name was found. If no time stamp was provided restore implicitly matches any backup image; implying if there are more than one backup images a unique match cannot be made.

User response

Resubmit the operation by specifying a time stamp with sufficient time stamp components to result in a match to a unique backup file.

SQL2523W Warning! Restoring to an existing database that is different from the database on the backup image, but have matching names. The target database will be overwritten by the backup version. The Roll-forward recovery logs associated with the target database will be deleted.

Explanation

The database alias and name of the target database are the same as the backup image database alias and name. The database seeds are not the same indicating that the databases are not the same. The target database will be overwritten by the backup version. The Roll-forward recovery logs associated with the target database will be deleted. The current configuration file will be overwritten with the backup version.

User response

Return to the utility with the callerac parameter indicating processing to continue or end.

SQL2524W Warning! Restoring to an existing database which appears to be the same but the alias dbase of the existing database does not match the alias dbase of the backup image. The target database will be overwritten by the backup version.

Explanation

The database seeds of the target database and the database image are the same, indicating these are the same databases, the database names are the same, but the database aliases are not the same. The target database will be overwritten by the backup version.

User response

Return to the utility with the callerac parameter indicating processing to continue or end.

SQL2525W Warning! Restoring to an existing database that is different from the database on the backup image, and the alias dbase of the existing database does not match the alias dbase of the backup image, but the database names are the same. The target database will be overwritten by the backup version. The Roll-forward recovery logs associated with the target database will be deleted.

Explanation

The database aliases of the target database and database image are not the same, the database names are the same, and the database seeds are not the same, indicating these are different databases. The target database will be overwritten by the backup version. The Roll-forward recovery logs associated with the target database will be deleted. The current configuration file will be overwritten with the backup version.

User response

Return to the utility with the callerac parameter indicating processing to continue or end.

SQL2526W Warning! Restoring to an existing database that is the same as the backup image database, and the alias names are the same, but the database name dbname of the existing database does not match the database name dbname of the backup image. The target database will be overwritten by the backup version.

Explanation

The database aliases of the target database and database image are the same, and the database seeds are the same, however the database names are different. These are the same databases. The target database will be overwritten by the backup version.

User response

Return to the utility with the callerac parameter indicating processing to continue or end.

SQL2527W Warning! Restoring to an existing database that is different from the backup image database, and the database name dbname of the existing database does not match the database name dbname of the backup image, but the alias names are the same. The target database will be overwritten by the backup version. The Roll-forward recovery logs associated with the target database will be deleted.

Explanation

The database aliases of the target database and database image are the same, the database names are not the same, and the database seeds are not the same, indicating these are different databases. The target database will be overwritten by the backup version. The Roll-forward recovery logs associated with the target database will be deleted. The current configuration file will be overwritten with the backup version.

User response

Return to the utility with the callerac parameter indicating processing to continue or end.

SQL2528W Warning! Restoring to an existing database that is the same as the backup image database, but the alias name dbase of the existing database does not match the alias dbase of backup image, and the database name dbname of the existing database does not match the database name dbname of the backup image. The target database will be overwritten by the backup version.

Explanation

The database aliases of the target database and database image are not the same, the database names are not the same, and the database seeds are the same, indicating these are the same databases. The current database will be overwritten by the backup version.

User response

Return to the utility with the callerac parameter indicating processing to continue or end.

SQL2529W Warning! Restoring to an existing database that is different from the backup image database, and the alias name dbase of the existing database does not match the alias name dbase of the backup image, and the database name dbname of the existing database does not match the database name dbname of the backup image. The target database will be overwritten by the backup version. The Roll-forward recovery logs associated with the target database will be deleted.

Explanation

The database aliases of the target and database image are not the same, the database names are not the same, and the database seeds are not the same, indicating these are different databases. The current database will be overwritten by the backup version. The Roll-forward recovery logs associated with the target database will be deleted. The current configuration file will be overwritten with the backup version.

User response

Return to the utility with the callerac parameter indicating processing to continue or end.

SQL2530N The backup image is corrupted. Restore of database from this backup image is not possible.

Explanation

The backup image being restored is corrupted making the database image non-restorable.

User response

Discard the backup image as it is unusable. Restore from a previous backup if possible.

SQL2531N The backup image selected for restore is not a valid database backup image.

Explanation

The file selected for restore is not a valid backup image. Either the file selected has become corrupted or a backup tape is not at the correct position.

User response

Determine the location of the correct backup image file, and resubmit the Restore command.

SQL2532N The backup file contains the backup image of database dbalias taken at timestamp timestamp. This is not the backup image requested.

Explanation

The file selected for restore does not contain the requested backup image. The image is for a different database than that requested.

User response

If using tape, ensure that the correct tape is mounted. If a restore or load is being done from disk, then the file must have been renamed. Rename the file to the correct filename with a match on database name and timestamp. Resubmit the command after taking the appropriate action.

SQL2533W Warning! The backup file on device device contains the image of database database taken at timestamp timestamp. This is not the backup image requested.

Explanation

The backup image read from the tape position contains a media header that does not match the header of the image of the first file of the backup file sequence.

User response

Ensure that the tape is positioned at the correct backup, then return to the utility with the callerac parameter indicating if processing continues.

SQL2534W Warning! The media on device device is not positioned at a valid backup media header.

Explanation

The data read from the tape position does not contain a valid backup media header.

User response

Ensure that the tape is positioned at the correct position, then return to the utility with the callerac parameter indicating if processing continues.

SQL2535W Warning! End of media on device device has been reached. Please mount the next source media.

Explanation

The end of tape has been reached and there is still more data to be processed. The remainder of the backup or load source exists on another tape or on several more tapes.

User response

Mount the next tape in sequence that contains the source image and resubmit the Restore or Load command with the callerac parameter set to continue or end.

SQL2536W Warning! The backup image on device device contains an incorrect sequence number. Sequence number number is expected.

Explanation

The tape is positioned on a backup image file that is out of sequence. The tape containing the backup image must be positioned to the file of sequence number sequence of the backup image.

User response

Position the tape containing the backup image to the correct file and resubmit the Restore command with the callerac parameter set to continue or end.

SQL2537N Roll-forward is required following the Restore.

Explanation

SQLUD_NOROLLFWD was specified for the rst_type parameter of the Database Restore utility, indicating that a roll-forward is not required to make the restored database usable. If the database to be restored was backed up in online mode or the restore issued was a tablespace level restore, then a roll-forward operation is necessary to make the database usable.

User response

Resubmit the Database Restore command without specifying SQLUD_NOROLLFWD for the rst_type parameter.

SQL2538N Unexpected End of File of Backup Image reached on media media.

Explanation

While reading and restoring from the Backup Image file, an end of file condition was reached unexpectedly. The backup image is unusable and the restore operation terminates.

User response

Resubmit the Database Restore command with a usable backup image file.

SQL2539W The specified name of the backup image to restore is the same as the name of the target database. Restoring to an existing database that is the same as the backup image database will cause the current database to be overwritten by the backup version.

Explanation

This message is returned when the database aliases, names and seeds of the target database and database image are the same, indicating these are the same databases. The current database will be overwritten by the backup version.

This message can also be returned when the RESTORE command is called with the GENERATE SCRIPT parameter. When the RESTORE command is used to generate a restore script, the restore utility performs some of the same error checking that is performed when a restore operation is being performed. When this message is returned when the RESTORE command is called with the GENERATE SCRIPT parameter, the message can be ignored.

User response

  • If this message is being returned when the RESTORE command is called with the GENERATE SCRIPT parameter no response is required.
  • Return to the utility with the callerac parameter indicating processing to continue or end.

SQL2540W Restore is successful, however a warning warn was encountered during Database Restore while processing in No Interrupt mode.

Explanation

The Database Restore utility was invoked in No Interrupt mode, i.e. WITHOUT PROMPTING. During the processing, one or more warnings were encountered but not returned at the time they were encountered. The Restore has completed successfully and the warning messages found are shown at the completion in this message.

User response

Ensure that the action that caused this warning to be generated has not resulted in a condition not wanted.

SQL2541W The utility was successful, however the file containing the backup image could not be closed.

Explanation

The utility was successful, but the file containing the backup image could not be closed.

User response

Attempt to close the file containing the backup image.

SQL2542N No match for a database image file was found based on the source database alias database-alias and timestamp timestamp provided.

Explanation

The backup image file filename consists of a database alias and a timestamp component. A filename is constructed from the source database alias and timestamp parameters provided in the Database Restore call. No filename existed in the source directory that matched based on the source database alias and timestamp provided.

The following situations might apply:

  1. The path to the backup was incorrectly specified in the restore command.
  2. You do not have permission to access the backup image or the directory within which the backup image resides.
  3. You are performing an automatic incremental restore and a required image was not found based on the timestamp and location in the database history.
  4. You are restoring a database in a partitioned database environment, the database does not already exist, and the first database partition being restored is not the catalog partition.
  5. You are restoring from TSM media, and the TSM API client configuration used by the current instance is not able to access the backup image.

User response

Appropriate responses corresponding to the situations described previously are:

  1. Ensure that the database backup image resides on the media source. Resubmit the operation by specifying a correct path to the backup image and correct timestamp to result in a match.
  2. Ensure that you have permission to access the backup image and the directory in which it resides.
  3. Check the database history for the corresponding backup entry and verify that the location listed matches the actual location of the backup image. Either update the database history and retry the operation to result in a match or issue a RESTORE INCREMENTAL ABORT command to cleanup any resources that may have been created during processing.
  4. Always restore the catalog partition first when restoring a partitioned database.
  5. Use db2adutl utility with QUERY option to check if the image could be retrieved from TSM. If you are restoring a backup image taken from a different instance on a different server, make sure to use the options NODENAME, OWNER, and optionally PASSWORD corresponding to the TSM settings of the TSM node on which the backup image was originally taken. Once you have verified that the image could be retrieved, you could pass the same options in the options string of the RESTORE command.

SQL2543N The target directory specified for the database is not valid.

Explanation

The application calling the Restore utility has supplied a target directory for the new database to be created. Either this directory does not exist, or is not a valid directory for database creation. An invalid directory for database creation would be a directory of greater than 215 characters in length.

User response

Reissue the Backup or Restore command with a valid target directory.

SQL2544N The directory where the database is being restored has become full.

Explanation

While the database was being restored the directory to which it was being restored had become full. The database being restored is unusable. The Restore terminates and if the database being restored is a new database, then it is deleted.

User response

Free up sufficient space on the directory for the database, and reissue the Restore, or if restoring to a new database supply a directory with sufficient space to contain the database.

SQL2545W Warning! The backup image on the TSM server is currently stored on mountable media. The time required to make it available is unknown.

Explanation

The backup image is not immediately accessible by the TSM server. The restore process can continue and make the request to the server to retrieve the data. The time required is unknown.

User response

Return to the utility with the callerac parameter indicating processing to continue or end.

SQL2546N The image on media media is not the first in sequence from the backup or copy.

Explanation

During restore or load recovery, the first image from the backup or copy must be processed first. The image found on the media is not the first in sequence.

The utility waits for a response to continue.

User response

Mount the media with the correct backup or copy image and return to the utility with the correct caller action parameter to indicate if processing should continue or terminate.

SQL2547N The database was not restored because the backup image is from a previous release and requires rollforward recovery.

Explanation

The physical log file formats have changed between these releases, making rollforward impossible.

User response

Restore the database using the version of DB2 used to create the database and rollforward to the end of logs. Take an off-line full database backup at this time. This new backup image will be restorable on the new release of DB2.

SQL2548N Database code page indicated within the backup image code-page is invalid or not supported. The restore operation has failed.

Explanation

  1. The backup image you are restoring may have been created on a server with a newer FixPak level than the FixPak level that has been applied to this server. In this case, it is possible that the image contains a newer code page that is unsupported.
  2. The backup image is corrupt and contains invalid code page information.

User response

If attempting to restore an image from a server with a newer FixPak level to a server with a lesser FixPak level, then ensure that the code page is supported by both servers. Alternatively, consider applying the newer FixPak to the server you are restoring to.

SQL2549N The database was not restored because either all of the table spaces in the backup image are inaccessible, or one or more table space names in list of table space names to restore are invalid.

Explanation

The containers which were used by the table spaces in the backup image are not available, are already in use, or one or more table space names specified in the list on the restore command do not exist in the backup image.

User response

Use redirected restore to redefine the containers for the table spaces in this backup image, or specify a list of valid table space names to restore. If this error occurs during the transport operation, it might be caused by containers already in use by a staging database from a failed transport operation. This will cause subsequent transport operations to fail when restoring to their staging databases. Drop any transport staging databases and re-issue the RESTORE DATABASE command.

SQL2550N Database backed up on node node1 cannot be restored to node node2.

Explanation

The backup image used for the restore is a backup of a database from a different node. You can only restore a backup to the same node.

User response

Ensure that you have the correct backup image for the node then issue the request again.

SQL2551N Database with catalog node node1 cannot be restored to a database with catalog node node2.

Explanation

In an environment that is not a DB2 pureScale environment, the catalog node can exist on only one node. This message is returned when there is a discrepancy between the backup image and the node being restored to. This can occur in the following cases:

  1. The backup image specified catalog node node1 and the restore was attempted to an existing database whose catalog node is node node2
  2. The restore was attempted to a new database and the catalog node has not been restored first.

User response

Verify that the correct backup image is being restored.

If you are restoring to an existing database and want to change the catalog node to node2, the existing database must be dropped first.

If you are restoring to a new database, restore the catalog node node1 first.

SQL2552N Invalid report file name specified in the restore command.

Explanation

The length of the report file name exceeded the allowed limit of 255.

User response

Specify a report file name whose length is within the allowed limit and resubmit the restore command.

SQL2553I The RECONCILE utility completed successfully.

Explanation

The utility completed successfully.

User response

No action necessary.

SQL2554N The RECONCILE utility failed with reason code reason-code. Possible problem with component.

Explanation

Possible Reason codes:
1
Unknown connection to a DB2 Data Links Manager.
2
Table/DATALINK column not defined on the DB2 Data Links Manager.
3
DB2 Data Links Manager may be down.
4
I/O problems.
5
The exception table contains datalink columns that are defined with file link control.
6
Table is in “Datalink Reconcile Not Possible” state.
7
Exception table not allowed for reconcile on typed tables.
8
ALTER TABLE failed to put the table into “Datalink Reconcile Pending” or “Datalink Reconcile Not Possible” state, or failed to take the table out of “Datalink Reconcile Pending” or “Datalink Reconcile Not Possible” state.
9
Data Links support is not turned on.
10
Table is in the Set Integrity Pending state.
11
A required DB2 Data Links Manager was not available during exception handling. Table is placed in DataLink Reconcile Pending state.
12
Reconcile processing could not complete on the DB2 Data Links Manager(s) in the allotted time period. Check the administration notification log for details.
13
Reconcile processing has been terminated as there was no progress for a period of time.

User response

Possible Solutions:
1
Make sure that the DB2 Data Links Manager is up and running, and that it has been registered with the database using the ADD DATALINKS MANAGER command. Try connecting to the database and make a sure a corresponding connection has been established on the DB2 Data Links Manager.
2
The table does not seem to exist on the DB2 Data Links Manager. Nothing to reconcile.
3
DB2 Data Links Manager may be down. Try starting the DB2 Data Links Manager.
4
Ensure you have file permissions and enough space for the report file. A fully qualified path is required for the DLREPORT parameter. Ensure that the table being reconciled is not damaged.
5
Redefine all datalink columns in the exception table as “NO LINK CONTROL”.
6
Take the table out of the Datalink Reconcile Not Possible state using the SET INTEGRITY statement. Repeat the RECONCILE utility.
7
Do not specify an exception table.
8
Try issuing a SET INTEGRITY command to put the table into “Datalink Reconcile Pending” state or to reset the “Datalink Reconcile Pending” or “Datalink Reconcile Not Possible” state.
9
The value of the database manager configuration parameter DATALINKS is set to NO. To use RECONCILE, you must set the value of the parameter DATALINKS to YES.
10
To run reconcile on a table, the table cannot be in the Set Integrity Pending state. To remove the Set Integrity Pending state, use the SET INTEGRITY statement.
11
Run reconcile again.
12
The reconcile command has timed out waiting for verification from the DB2 Data Links Manager(s). Try the reconcile command again.
13
Resubmit the reconcile command. If the problem persists, contact IBM Support.

SQL2555I The database was restored and then successfully upgraded to the current DB2 release where you issued the RESTORE DATABASE command.

Explanation

The backup that you used to restore the database is from a previous DB2 release. After you restored the database, it was upgraded to the DB2 release where you issued the RESTORE DATABASE command.

The user who issued the RESTORE DATABASE command is given DBADM authority to the database. If other users had DBADM authority prior to restore, the security administrator, who has SECADM authority, must grant DBADM authorization to these users.

The RESTORE DATABASE command was completed successfully. The UPGRADE DATABASE command issued automatically after the database restore was also completed successfully.

User response

Perform post-upgrade tasks.

SQL2556W The database was restored but did not include all of the logs required for rollforward recovery to a consistent point in time.

Explanation

A RESTORE DATABASE command was issued with the optional LOGTARGET path specified but the backup image did not contain all of the logs required for a successful rollforward recovery.

User response

To successfully complete rollforward recovery, supply all of the required log extents from a log archive or other location.

SQL2560N The table space restore operation failed because the target database is not identical to the source database.

Explanation

You can restore a database or restore one or more table spaces in a database from a backup image into a target database using the RESTORE DATABASE command or the db2Restore API.

There are some conditions that must be met to run a restore operation from a table space level backup. For example, the target database that is specified for the restore operation must meet one of the following conditions:

  • The specified target database is the original database from which the backup image was taken.
  • The specified target database. does not exist, and the rebuild option is specified in the restore command or API call.

This message is returned when an attempt is made to perform a database restore operation or a table space-level restore operation to a target database that is neither the original database from which the backup image was created nor a newly-created database.

User response

Respond to this error in one of the following ways:

  • Run the restore operation again, specifying a target database that is the original database from which the backup image was taken.
  • Run the restore operation again, using the rebuild options and specifying a target database that does not exist.

SQL2561W Warning! Rebuilding a database from a table space image or using a subset of table spaces. The target database will be overwritten. The restore utility also reports the following sqlcode sqlcode.

Explanation

The RESTORE utility was issued with the REBUILD option and either specified a table space image to restore or specified a list of table spaces to restore from a backup image. If the database does not already exist, it will be created using the table spaces available for restore and the same database attributes as those in the image. If the database already exists, the database will be overwritten using the table spaces available for restore and based on the sqlcode returned with this warning.

If a subset of table spaces is restored from a non-recoverable database, the table spaces that were not part of the restore can never be recovered unless you do a complete database restore.

User response

Return to the utility with the callerac parameter indicating processing to continue or end.

SQL2563W The restore process completed successfully. However, one or more table spaces from the backup image were not restored.

Explanation

This message can be returned for different reasons, including the following examples:

  • An error was encountered while accessing the containers of the table spaces.
  • The restore command was invoked with a list of table spaces so that only a subset of the table spaces in the backup were restored.
  • An attempt was made to restore table spaces that have file system caching enabled into containers on disks that do not support file system caching.

User response

  • If the table spaces have been dropped since the backup was taken, no further action is necessary.
  • If this message is not due to a subset restore, verify the status of the table spaces by running the LIST TABLESPACES command.
  • If a table space is in the "storage definition pending" state, the storage definition for the table space must be corrected for restore to complete successfully.

SQL2565N The option specified for RESTORE is not allowed with the backup image provided.

Explanation

The database contained in the backup image is an existing database and does not match the database to be restored. The option you have specified for restore requires that the database being restored to is new or the same as in the backup image.

The utility stops processing.

User response

Resubmit the command with the correct database name.

SQL2566W The restore process has completed successfully, but one or more table spaces have their tables put in DRP/DRNP state. Check the db2diag log file for details.

Explanation

One or more table spaces have tables in DATALINK Reconcile Pending (DRP) or DATALINK Reconcile Not Possible (DRNP) because of one of the following reasons:

  • Restoring to a database that has a different database name, alias, hostname, or instance than the backup image. If no rollforward follows the restore, any tables with DATALINK columns are placed in DRNP state.
  • Restore is done specifying the WITHOUT DATALINK option and no rollforward follows the restore. Any tables with DATALINK columns are placed in DRP state.
  • Restoring from a backup image that has become unusable. If no rollforward follows the restore, any tables with DATALINK columns are placed in DRNP state.
  • DATALINK column information does not exist at the DB2 Data Links Manager(s). Affected tables are placed in DRNP state.
  • Restore involving fast reconciliation failed while trying to relink files at the DB2 Data Links Manager(s). Affected tables are placed in DRNP state.

User response

Look in the administration notification log to find out what tables are put in DRP/DRNP state. See the Administration Guide for information on reconciling tables that are in DRP/DRNP state.

SQL2570N An attempt to restore on target OS target-OS from a backup created on source OS source-OS failed due to the incompatibility of operating systems or an incorrect specification of the restore command. Reason-code: reason-code.

Explanation

Possible reason codes are:

1

target-OS and source-OS are not compatible systems.

2

A cross-platform restore of a compressed backup was attempted and no decompression library was specified. By default the library in the backup image from source-OS is used. This library is not suitable for a restore on target-OS.

3

A compression library-only restore was attempted on target-OS, a different operating system from the one on which the backup was taken (source-OS).

User response

Responses for each reason code are:

1

To use this particular backup image, restore it on a system that is restore-compatible with the operating system on which the backup was taken. To move a database from one type of operating system to another, use the db2move utility.

2

Retry the Restore operation, specifying a decompression library that was compiled for target-os. For example, db2 restore db sample comprlib libdb2compr.a.

3

Do not attempt to restore a compression library on an operating system where it cannot be used.

SQL2571N An automatic restore is unable to proceed. Reason code: reason-code.

Explanation

An error was encountered during the automatic restore process. This error occurred during an incremental restore or during a rebuild of a database from table space images or from a subset of table spaces in a database image. The utility was unable to complete as intended. The utility stops processing.

In the case of an incremental restore, this error is returned after the initial definitions have been restored and the processing of the required incremental restore set cannot be completed successfully.

In the case of a rebuild, this error is returned after the initial target image has been restored and the processing of the remaining required restore set cannot be completed successfully.

The error is a result of one of the following reason codes:

1
The backup image corresponding to the specified timestamp could not be found in the database history.
2
An error occurred trying to determine which table spaces to restore.
3
A required backup image could not be found in the database history.
4
The wrong rebuild type was specified for the incremental rebuild intended.
5
Cannot automatically restore only temporary table spaces.

User response

If this is an incremental restore or an incremental rebuild, issue a RESTORE INCREMENTAL ABORT command to clean up any resources that may have been created during processing. Perform a manual incremental restore to restore the database from this backup image.

If this is a non-incremental rebuild then complete the rebuild, if necessary, by issuing table space restores against the remaining images required to rebuild the database as intended. See the diagnostic (db2diag) log files for additional information.

SQL2572N Attempted an incremental restore of an out of order image. The restore of tablespace tablespace-name encountered an error because the backup image with timestamp timestamp-value must be restored before the image that was just attempted.

Explanation

When restoring images produced with an incremental backup strategy, restore the images in the following order:
  1. Restore the final image first to indicate to DB2 the increment to which you want to restore the database.
  2. Restore the full database or tablespace image which precedes the set of incremental images.
  3. Restore the set of incremental and delta images in the chronological order in which they were produced.
  4. Restore the final image for a second time.

Each tablespace in the backup image is aware of the backup image that must be restored before the backup image that failed can be successfully restored. You must restore the image with the timestamp reported in this message before you can successfully restore the image that invoked this message. There might be additional images to restore before the indicated image, but this was the first tablespace to encounter an error.

User response

Ensure the order of the set of incremental backup images is correct and continue the incremental restore process.

SQL2573N An incremental backup image must be restored as part of an incremental RESTORE operation.

Explanation

A RESTORE operation was attempted using an incremental backup image. An incremental backup cannot be restored on its own; it can be restored only as part of an incremental RESTORE operation.

The utility stops processing.

User response

To restore this backup image, reissue the RESTORE command using the INCREMENTAL modifier. To perform a non-incremental RESTORE operation, specify a non-incremental backup image.

SQL2574N A backup image restored as part of an incremental RESTORE operation cannot be newer than the target image.

Explanation

The target image is the first image to be restored as part of an incremental RESTORE operation. This image contains the tablespace definitions and other control structures for the database that is being restored. The RESTORE utility cannot restore an image that is newer than the target image during an incremental RESTORE operation, because it could corrupt the database.

The incremental RESTORE operation failed because it attempted to restore a backup image with a timestamp that is more recent than the timestamp of the target image.

The utility stops processing.

User response

Reissue the command, specifying a backup image with a timestamp that is older than the timestamp of the target image.

SQL2575N The timestamp of the specified incremental backup image is older than the timestamp of the last image that was restored for tablespace tablespace-number. The last backup image has a timestamp of timestamp.

Explanation

To perform an incremental RESTORE operation, the backup images must be restored in chronological order of oldest to newest for each tablespace. An incremental RESTORE operation specified a backup image with a timestamp older than the timestamp of the previous image that was restored for the specified tablespace.

The utility stops processing.

User response

Reissue the command, specifying a backup image with a timestamp that is newer than the timestamp of the last image that was restored for the tablespace.

SQL2576N The RESTORE command failed because the INCREMENTAL clause was not specified and the table space is involved in an incremental restore operation. Table space name: table-space-name.

Explanation

To perform a manual, cumulative restore operation you must issue the RESTORE command, specifying the INCREMENTAL clause, for each image involved in the restore operation.

This message is returned when the RESTORE command is issued without the INCREMENTAL clause, but the utility detects that a previous incremental restore operation has not completed.

User response

To perform a manual, cumulative restore operation, issue the RESTORE command, specifying the INCREMENTAL clause, for each image involved in the restore operation.

SQL2577N No library found for decompressing backup.

Explanation

The image being restored is a compressed backup, but no decompression library was specified and no library was found in the image.

The RESTORE utility requires a plug-in library to decompress the backup. This library is typically stored in the backup image itself, but in this case the creator of the backup chose to exclude the library. The library name can also be specified as a parameter to the RESTORE utility.

The utility stops processing.

User response

Resubmit the command, specifying the name of a library that can decompress the data in the image.

SQL2578N The specified object was not found in the backup image.

Explanation

The specific object that was asked to be restored does not exist in the backup image.

The RESTORE utility attempted to restore a single object from the backup image. No object of this type exists in the backup image.

The backup history file and the decompression library are the objects that can be restored individually.

The utility stops processing.

User response

Resubmit the command, specifying a backup image that does contain the object in question.

SQL2580W Warning! Restoring logs to a path which contains existing log files. Attempting to overwrite an existing log file during restore will cause the restore operation to fail.

Explanation

The specified log target path contains at least one file with a name which matches the log filename format. If the restore operation later attempts to extract a log file of the same name, this will cause the restore to fail.

User response

Either remove the existing log files from the log target path, or otherwise ensure that the files which exist in the log target will not match the filenames of any logs to be extracted from this backup image. Then return the utility with a callerac parameter indicating that restore processing should either continue or terminate.

SQL2581N Restore is unable to extract log files or restore a log directory from the backup image to the specified path. Reason code rc.

Explanation

An error occurred while attempting to extract a log file from the backup image. This could be because one of the following reasons:

1

The backup image does not include logs.

2

The log target path specified could be full or invalid.

3

A log file name in the backup image matches a log file which already exists in the log target path.

4

There was an I/O error while trying to write the file.

5

The primary log directory on disk contains log files that will be destroyed by restore.

6

The mirror log directory on disk contains log files that will be destroyed by restore.

7

The default log directory of the existing database has logs that will be destroyed by the restore.

User response

1

Check that the backup image contains log files to be restored. If it does not, resubmit the command without specifying the LOGTARGET parameter.

2

Check that the specified LOGTARGET path is valid and that there is enough space available for all log files in the backup image to be extracted. Resubmit the command.

3

Check that there are no existing log files in the log target path with the same name as log files in the backup image being restored. Resubmit the command.

4

See the diagnostic (db2diag) log files for additional information. Try to resolve the problem and resubmit the command.

5, 6, or 7

Do one of the following:

  • Manually copy or move the log files from the primary log directory so you can archive those log files; and then call the RESTORE DATABASE command again.
  • Call the RESTORE DATABASE command again with the LOGTARGET parameter and either the INCLUDE FORCE parameter or the EXCLUDE FORCE parameter.

SQL2582W Warning! A new request to rebuild the database from a table space image or using a subset of table spaces has been detected. This will abort the current rebuild in progress and start a new one using this backup image. The target database will be overwritten.

Explanation

The RESTORE utility was issued with the REBUILD option but it has detected that a rebuild of the database is already in progress. If this operation were to take place then it would abort the current rebuild in progress and start a new one using this backup image as the target. The database will be overwritten.

Subsequent restore commands during the rebuild phase of the database should not be issued with the REBUILD option.

User response

Return to the utility with the callerac parameter indicating processing to continue or end.

SQL2583N The intended restore command cannot be processed because a previous incremental restore is still in progress.

Explanation

The RESTORE utility has detected that a previous incremental restore operation has not completed. The intended restore command is not part of the previous incremental restore and cannot be processed unless the previous incremental restore is aborted.

The utility stops processing.

User response

Issue a restore with the INCREMENTAL ABORT option and then reissue the intended restore command.

SQL2584N A snapshot restore failed because the log directories must be restored but a valid LOGTARGET has not been specified.

Explanation

Snapshot backup enables you to use fast copying technologies for the data copying and movement parts of DB2 database backup and restore operations.

The snapshot backup image must be restored as a whole. For this reason, when there are database logs in the snapshot backup image, they must be restored with the rest of the image.

There are database logs in the snapshot backup image you are restoring, so they must be restored with the rest of the image. However, the path for the given log directory shares a path or storage device with other paths or storage devices used by the database being restored.

It is not unusual for the path of the log directory to share a path or storage device with other database paths or storage devices. For example: when you create a database, the log directory is created under the main database directory by default. When a log path shares a path or storage device with other database paths or storage devices, a snapshot restore can not restore the log directory unless you specify the target location for the log directory using the LOGTARGET parameter.

The snaphot restore failed because you did not specify a LOGTARGET, or because you specified an invalid LOGTARGET.

User response

Resubmit the RESTORE command using the LOGTARGET parameter.

SQL2585N The selected backup image is for database dbalias taken at timestamp timestamp from instance instance-name. This backup image cannot be restored into the current instance.

Explanation

The backup image selected for restore is from an instance that does not match the current instance.

Snapshot backup images can only be restored to the same instance name they were taken from.

User response

To find snapshot backup images that are available for the current instance, use the db2acsutil utility.

To restore a given snapshot backup image:

  1. Move to the instance from which this snapshot backup image was taken.
  2. Resubmit the command.

SQL2590N The requested RESTORE operation cannot be completed because a schema transport error has occurred. Reason Code: rc.

Explanation

An error occurred while using the RESTORE DATABASE command with the TRANSPORT option to transport table spaces and schemas from a database backup image to a target database. The following reason code indicates the error:

1

The list of table spaces and schemas being transported is not a valid transportable set.

2

The table spaces and schemas being transported contain tables with columns that are of a data type that is not supported with schema transport.

3

Table spaces or schemas already exists on the target database.

4

The list of table spaces and schemas being transported contains system catalogs. The system catalogs can not be transported.

5

All default staging databases are already in use.

6

Rollforward requires user interaction to resolve load copy recovery.

7

The backup image must contain the SYSCATSPACE table space.

8

Transport is not supported in partitioned database environments or in DB2 pureScale environments.

9

Transport is not supported when the source instance is an ESE instance and the target instance is a DB2 pureScale instance.

10

Attempting to increase LSN on target database failed.

12

Table space ID for schema transport cannot be reserved because another session of transport is already in progress.

13

Storage paths are dropped as table spaces are being reserved for schema transport.

14

A warning occurred when creating the staging database.

15

An error occurred on target database while transporting table spaces.

16

An error occurred on staging database while transporting table spaces.

17

Schema transport stopped because table space ID mapping is not resolved or validated. An error occurred in one of the following situations:

  • Mapping table space IDs between the staging database and the target database.
  • Validating table space IDs provided by the client against the server memory.
  • The mapped table space is not valid.
18

Reason code 18 can be returned for two reasons:

  • An attempt was made to perform a schema transport operation into a database that is configured to disallow non-logged operations.
  • An attempt was made to specify the TRANSPORT INTO clause with the RESTORE command when restoring to a target database that is encrypted with DB2 native encryption.
19

Not all DDL objects in the transportable set can be created on the target database.

20

The specified backup image was created using an online backup operation, and the LOGTARGET parameter was not specified with the RESTORE command.

21

The table spaces and schemas being transported contain partitioned tables, which are not supported with schema transport.

User response

Based on the reason code, perform the following actions:

1

Ensure that the table space list contains all objects that exist in the schema list and vice versa. See the db2diag log file for the failing object.

2

Respond to reason code 2 by performing the following steps:

  1. Identify the columns that are defined as a data type that is not supported with schema transport by reviewing diagnostic details in the db2diag log files.
  2. Remove the columns that are unsupported with schema transport by performing one of the following actions:
    • Drop the columns that are of an unsupported data type.
    • Drop the tables containing the columns that are of an unsupported data type.
    • Remove the table spaces and schemas containing the unsupported columns from the list of schemas to be transported.
  3. Run the restore operation again.
3

You can perform one of the following actions to resolve the conflict with the table spaces or schemas and re-issue the RESTORE DATABASE command.

  • Drop or rename the conflicting table spaces on the target database.
  • Drop or rename the table spaces from the source database and create another backup image.
  • Exclude the offending table spaces and schemas from the transportable set. When removing table spaces and schemas, you must ensure the remaining table spaces and schemas define a valid transportable set.
4

Remove the system table spaces from the table space list and re-issue the RESTORE DATABASE command again.

5

When re-issuing the RESTORE DATABASE command, you can either specify a non-default staging database name with the STAGE IN option, or wait for other transports to complete to free up a default staging database name.

6

Ensure that the rollforward logs do not include a load copy recovery operation.

7

Add the SYSCATSPACE tablespace to the backup image.

8

Ensure that the database is single node database that is not configured as a partitioned database environment or a DB2 pureScale environment.

9

Select a compatible backup image and re-issue the RESTORE DATABASE command.

10

Check db2diag.log for errors during attempt to increase LSN on target database.

12

Concurrent transport operations against any target database is not supported. Wait until the existing schema transport completes, then re-issue RESTORE DATABASE command.

13

Wait until schema transport completes, then re-issue operations that alter storage paths. Cleanup connections to the target database and drop the staging database. Re-issue the RESTORE DATABASE command.

14

Check db2diag.log for errors during creation of the staging database. Resolve errors, drop the staging database, then re-issue the RESTORE DATABASE command.

15

Check db2diag.log for errors on the target database. Resolve errors, drop the staging database, then re-issue the RESTORE DATABASE command.

16

Check db2diag.log for errors on the staging database. Resolve errors, drop the staging database, then re-issue the RESTORE DATABASE command.

17

Ensure that the transportable set does not contain any objects that have dependency on table spaces outside of the transportable set. For example, an object in the transportable set cannot have an index defined in another table space that is not included in the transportable set. Check db2diag.log for details on the cause of error. Resolve errors, drop the staging database, then re-issue the RESTORE DATABASE command.

18

Specify a target database that allows non-logged operations and that is not encrypted.

19

Some objects might be invalid or some dependencies might not exist. Check db2diag.log for details on the cause of error. Resolve errors, then re-issue the RESTORE DATABASE command.

20

Call the RESTORE command again, specifying the LOGTARGET parameter.

21

Respond to reason code 21 by performing the following steps:

  1. Identify the partitioned tables by reviewing diagnostic details in the db2diag log files.
  2. Remove the partitioned tables by performing one of the following actions:
    • Drop the partitioned tables.
    • Remove the table spaces that contain the partitioned tables from the list of table spaces to be transported.
  3. Run the restore operation again.

SQL2600W The input parameter pointer to the authorization block is invalid or the block's size is incorrect.

Explanation

The pointer to the authorization structure parameter is NULL, the pointer to the authorization structure points to an area that is smaller than the length indicated in the structure length field, or the authorization structure length field is not set to the correct value.

The command cannot be processed.

User response

Correct the value of the input parameter and resubmit the command.

SQL2650N An invalid parameter parameter_name was passed to the API-name read log API. Reason Code = reason-code.

Explanation

An invalid parameter was passed to a read log API. The possible reason codes are as follows:

01

Invalid action specified.

02

The starting log record identifier is greater than the current database active log record identifier.

03

The log record identifier range bounded by the starting and ending log record identifiers is not large enough to span a log record.

04

The starting log record identifier does not represent the start of an actual log record.

05

The starting log record identifier's location could not be determined.

06

The ending log record identifier is less than or equal to the starting log record identifier.

07

The buffer is not valid for the indicated size.

08

The buffer is not of sufficient size to store a log record.

09

A pointer is not valid.

10

The filter option is not valid.

11

The logfile path is not valid.

12

The overflow logfile path is not valid.

13

The retrieve logs option is not valid.

14

The specified number of bytes for memory allocation is too small.

15

The log sequence number is larger than can be contained by its respective API field.

16

The log record identifier type for piStartLRI is invalid.

17

The log record identifier types for piStartLRI and piEndLRI are not the same.

User response

Based on the reason code, follow the instructions given:

01

Ensure that the action is either DB2READLOG_QUERY, DB2READLOG_READ, or DB2READLOG_READ_SINGLE.

02

Reduce the value of the starting log record identifier.

03

Ensure that the ending log record identifier is sufficiently larger than the starting log record identifier.

04

Ensure that the starting log record identifier is either the initial log record identifier or the next start log record identifier that is returned in the read log information structure.

05

Ensure that the starting log record identifier resides in a log extent in the database log path.

06

Ensure that the ending log record identifier is greater than the starting log record identifier.

07

Ensure that the buffer has been allocated and is of the size indicated by the log buffer size parameter.

08

Increase the size of the allocated buffer.

09

Ensure that memory has been correctly allocated and the pointers properly initialized.

10

Ensure that the filter option is either DB2READLOG_FILTER_OFF or DB2READLOG_FILTER_ON.

11

Ensure that the log path field is defined and points to a valid directory.

12

Ensure that the overflow log path field is defined and points to a valid directory.

13

Ensure that the retrieve option is either DB2READLOG_RETRIEVE_OFF, DB2READLOG_RETRIEVE_LOGPATH, or DB2READLOG_RETRIEVE_OVERFLOW.

14

Increase the number of bytes that can be allocated internally.

15

Use the latest version or level of the read log API, because the version in use possesses data type limitations for containing the log sequence number.

16

Ensure that the log record identifier type for piStartLRI is either DB2_READLOG_LRI_1 or DB2_READLOG_LRI_2.

17

Ensure that the log record identifier type for piStartLRI matches the log record identifier type for piEndLRI.

SQL2651N The log records associated with the database can not be asynchronously read.

Explanation

The asynchronous read log API was used against a connected database which does not have LOG RETAIN or USER EXITS ON. Only databases which are forward recoverable may have their associated logs read.

User response

Update the database configuration for the database, identified to the asynchronous read log API, turning LOG RETAIN and/or USER EXITS ON.

SQL2652N Insufficient memory to run the db2ReadLog or db2ReadLogNoConn API.

Explanation

The allocation of internal structures and buffers that are used by the db2ReadLog or db2ReadLogNoConn API has failed.

User response

Increase the amount of available memory that is available to the process (increase real or virtual memory, or remove unnecessary background processes).

SQL2653W A Restore, Rollforward or Crash Recovery might have reused log sequence number ranges. Reason code reason-code.

Explanation

A Restore, Rollforward or Crash Recovery might have reused log sequence number ranges. The possible reason codes are as follows:

1

Restore has taken place.

2

Rollforward has taken place.

3

Crash Recovery has taken place.

User response

No action is required.

SQL2654W The database log has been asynchronously read to the end of the current active log.

Explanation

All log records in the database active log have been read by the asynchronous log reader.

User response

No action is required.

SQL2655N The Asynchronous Log Reader encountered log file name which is not associated with the database being asynchronously read.

Explanation

The Asynchronous Log Reader attempted to read log records from the specified log file. The specified log file is not associated with the database being asynchronously read.

User response

Remove this log file from the database log directory. Move the correct log file into the database log directory and resubmit the call to the Asynchronous Read Log API.

SQL2656N The Asynchronous Log Reader has encountered log file name which cannot be read.

Explanation

The Asynchronous Log Reader attempted to read log records from the specified log file. The specified log file has been corrupted and cannot be read.

User response

Increase the start read log sequence and resubmit the call to the Asynchronous Read Log API to start reading after the specified log file.

SQL2657N The log read operation failed because the log reader cannot find the log file named log-file-name in the log stream log-stream-id.

Explanation

You can read log records from the DB2 database logs, or query the log manager for information about the current state of logs using the db2ReadLog API.

This message is returned when the db2ReadLog API is called, but the log reader cannot access log records from the indicated log file on the indicated log stream. One reason this can happen is because the log path was recently changed, using the newlogpath database configuration parameter, and the required log file is located in the old log path.

User response

  1. If log archiving is enabled, perform the following troubleshooting steps:
    1. Confirm whether database log files are successfully being archived and retrieved by looking for related errors in the db2diag log files.
    2. If there are error in the db2diag log files that indicate that log archiving is not functioning properly, troubleshoot and resolve the problems with log archiving.
  2. Perform the following general troubleshooting steps:
    1. Determine the location of the log file for which the db2ReadLog API was searching, indicated in the run-time token log-file-name.
    2. Manually copy the required log file into the database log path (indicated by the logpath database configuration parameter.)
  3. Resubmit the call to the db2ReadLog API.

SQL2701N Invalid command line option for progname. Reason code: reason-code.

Explanation

Command line option for the data splitting utility is not valid. Valid options are:
  • -c "Configuration file name"
  • -d "Distribution file name"
  • -i "Input file name"
  • -o "Output file prefix"
  • -h Usage message

User response

Given for each reason code:
1
There is an option not started with '-' sign.
2
Each option except 'h' (or 'H') must be followed by an argument.
3
There is an invalid option.
4
The argument of an option is too long (maximum 80 characters).

SQL2702N Failed to open the configuration file config-file.

Explanation

The utility cannot read the configuration file config-file.

User response

Please ensure the configuration file exists and is readable.

SQL2703N Failed to open the log file log-file.

Explanation

The utility cannot open the log file log-file for writing or appending.

User response

Please ensure the log file exists and is writable.

SQL2704N Failed to open the input data file input-data-file.

Explanation

The utility cannot read the input data file input-data-file.

User response

Please ensure the input data file exists and is readable.

SQL2705N Failed to open the input partitioning map file in-map-file.

Explanation

The utility cannot read the input partitioning map file in-map-file.

User response

Please ensure the input partitioning map file exists and is readable.

SQL2706N Failed to open the output partitioning map file out-map-file.

Explanation

The utility cannot open the output partitioning map file out-map-file for writing.

User response

Please ensure the output partitioning map file is writable.

SQL2707N Failed to open the distribution file dist-file.

Explanation

The utility cannot open the distribution file dist-file for writing.

User response

Please ensure the distribution file is writable.

SQL2708N Failed to open the output data file out-data-file.

Explanation

The utility cannot open the output data file out-data-file for writing.

User response

Please ensure the output data file is writable.

SQL2709N Syntax error at line line of the configuration file.

Explanation

There is a syntax error in the specification of a keyword and its argument.

User response

A keyword and its argument must be delimited by an '=' sign.

SQL2710N Invalid keyword at line line of the configuration file.

Explanation

There is an undefined keyword in the configuration file.

User response

Valid keywords (case insensitive) are:
  • DESCRIPTION, CDELIMITER, SDELIMITER, NODES, TRACE, MSG_LEVEL, RUNTYPE, OUTPUTNODES, NODES, OUTPUTNODES, OUTPUTTYPE, PARTITION, MAPFILI, INFILE, MAPFILO, OUTFILE, DISTFILE, LOGFILE, NEWLINE, HEADER, FILETYPE

SQL2711N Invalid column delimiter (CDELIMITER) at line line of the configuration file.

Explanation

The column delimiter (CDELIMITER) specified in the configuration file is not valid.

User response

Make sure the column delimiter (CDELIMITER) is a single byte character.

SQL2712N Invalid string delimiter (SDELIMITER) at line line of the configuration file.

Explanation

The string delimiter (SDELIMITER) specified in the configuration file is not valid.

User response

The string delimiter (SDELIMITER) cannot be a period.

SQL2713N Invalid run type (RUNTYPE) at line line of the configuration file.

Explanation

The value for run type (RUNTYPE) specified in the configuration file is not valid.

User response

Valid run type (RUNTYPE) can be either PARTITION or ANALYZE (case insensitive).

SQL2714N Invalid message level (MSG_LEVEL) at line line of the configuration file.

Explanation

The value for message level (MSG_LEVEL) specified in the configuration file is not valid.

User response

Valid message level (MSG_LEVEL) can be either CHECK or NOCHECK (case insensitive).

SQL2715N .Invalid check level (CHECK_LEVEL) at line line of the configuration file.

Explanation

The value for check level (CHECK_LEVEL) specified in the configuration file is not valid.

User response

Valid check level (CHECK_LEVEL) can be either CHECK or NOCHECK (case insensitive).

SQL2716N Invalid record length (RECLEN) reclen at line line of the configuration file.

Explanation

The value for record length (RECLEN) reclen specified in the configuration file is not valid.

User response

The record length (RECLEN) must be between 1 and 32767.

SQL2717N Invalid node specification (NODES) at line line of the configuration file. Reason code reason-code.

Explanation

The node specification (NODES) in the configuration file is not valid.

User response

Given for each reason code:
1
NODES has already been defined.
2
The format is not valid. A valid example: NODES=(0,30,2,3,10-15,57)
3
Each entry must be numeric data between 0 and 999.
4
Range specification must be from a lower number to a higher number.

SQL2718N Invalid output node specification (OUTPUTNODES) at line line of the configuration file. Reason code reason-code.

Explanation

The output node specification (OUTPUTNODES) in the configuration file is not valid.

User response

Given for each reason code:
1
OUTPUTNODES has already been defined.
2
The format is not valid. A valid example: OUTPUTNODES=(0,30,2,3,10-15,57)
3
Each entry must be numeric data between 0 and 999.
4
Range specification must be from a lower number to a higher number.

SQL2719N Invalid output type (OUTPUTTYPE) at line line of the configuration file.

Explanation

The output type (OUTPUTTYPE) in the configuration file is not valid.

User response

Valid output types (OUTPUTTYPE) are W (write) or S (stdin), case insensitive.

SQL2720N Number of partition keys exceeded the maximum "256". This error was detected at line line of the configuration file.

Explanation

The number of partitioning keys defined cannot exceed the maximum limit: 256.

User response

Remove one or more partitioning keys defined in the configuration file.

SQL2721N Invalid partitioning key specification (PARTITION) at line line of the configuration file. Reason code reason-code.

Explanation

A partitioning key specification (PARTITION) in the configuration file is not valid. Valid format:
 PARTITION=<key name>,
           <position>,
           <offset>,
           <len>,
           <nullable>,
           <datatype>

If a delimited-data file, <position> must be defined; otherwise, <offset> and <len> must be defined.

User response

Given for each reason code:
1
Fields must be delimited by the ',' character.
2
<position>, <offset> and <len> must be positive integers.
3
<nullable> must take a value from {N,NN,NNWD}.
4
Valid <data type> includes: SMALLINT, INTEGER, CHARACTER, VARCHAR, FOR_BIT_CHAR, FOR_BIT_VARCHAR, FLOAT (for binary numerics only), DOUBLE (for binary numerics only), DATE, TIME, TIMESTAMP, DECIMAL(x,y).
5
For DECIMAL data type, precision (x) and scale (y) must be specified and they must be positive integers.
6
For CHARACTER or VARCHAR data type, <len> must be specified.

SQL2722N Invalid log file specification (LOGFILE) at line line of the configuration file.

Explanation

The log file specification (LOGFILE) in the configuration file is not valid.

User response

The log file specification (LOGFILE) must be in one of the following two formats:
  • LOGFILE=<log file name>,<log type>
  • LOGFILE=<log file name>

<log type> can only be W (write) or A (append), case insensitive.

SQL2723N Invalid trace specification (TRACE) at line line of the configuration file.

Explanation

The trace specification (TRACE) in the configuration file is not valid.

User response

The trace specification (TRACE) must be a positive integer between 0 and 65536 (exclusive).

SQL2724N Invalid node list specification.

Explanation

The node list specification is not valid.

User response

One and only one of the two parameters: NODES and MAPFILI (input partition map) must be specified in the configuration file.

SQL2725N Filename for output partition map was not specified.

Explanation

If run type is ANALYZE, a filename for the output partition map must be defined.

User response

Specify a filename for the output partition map.

SQL2726N There is no partitioning key defined.

Explanation

At least one partitioning key must be defined.

User response

Specify one or more partitioning keys.

Altering the distribution key can only be done to a table whose table space is associated with a single-partition database partition group.

You can add or drop distribution keys, using the ALTER TABLE statement.

SQL2727N Partition key key-name exceeds the record length reclen.

Explanation

For non-delimited data, starting position for a key must be less than the record length.

User response

Make sure starting position for a key is less than the record length.

SQL2728N Output node out-node is not defined in the node list.

Explanation

Output node list must be a subset of the node list, which is derived from NODES or the input partition map file.

User response

Make sure all output nodes are defined in the node list.

SQL2729N Invalid partitioning map file. Reason code: reason-code.

Explanation

There is at least one error in the partitioning map file.

The specific error is indicated by the reason code:

1

The partitioning map file cannot be read.

2

The number of values in the partitioning map file is not 1 or 32768.

3

The node number in the partitioning map file is not between 0 and 999.

4

The data in the partitioning map file is not in a valid format.

User response

1

Check file permissions for the partitioning map file. Also, check that another program has not deleted or altered the partitioning map file.

2

Ensure that the partitioning map file contains only a single value (if the resultant database partition group is a single-partition database partition group) or exactly 32768 values (if the resultant database partition group is a multipartition database partition group).

3

Ensure that the node numbers are in the range of greater than or equal to 0 and less than or equal to 999.

4

Ensure that the values in the partitioning map file are integers greater than or equal to 0.

SQL2730N Error while writing header to output data file out-data-file.

Explanation

An I/O error occurred while writing the header to an output data file.

User response

Check your operating system documentation for file I/O errors and ensure that there is sufficient space on the output device.

SQL2731N Error while reading from input data file filename.

Explanation

An I/O error occurred while reading from input data file.

User response

Check your operating system documentation for file I/O errors.

SQL2732N Line line of the input data file contains binary data.

Explanation

Binary data is not permitted on the host versions of this utility program.

User response

Check your input data file.

SQL2733N Run type (RUNTYPE) was not defined in the configuration file.

Explanation

The run type (RUNTYPE) must be defined as either PARTITION or ANALYZE.

User response

Please specify run type (RUNTYPE) in the configuration file.

SQL2734N Invalid specification for parameter 32KLIMIT at line line of the configuration file.

Explanation

The specification for parameter 32KLIMIT in the configuration file is not valid.

User response

Parameter 32KLIMIT can be either YES or NO, case insensitive.

SQL2735W The record rec-no of the input data file was discarded because it was an empty record.

Explanation

The record rec-no of the input data is discarded because it contains nothing but spaces.

User response

Check record rec-no in the input data file.

SQL2736N sqlugrpi_api returned an error when processing record at line line of the input data file.

Explanation

Partitioning key fields contain invalid data.

User response

Check the input data file at line line.

SQL2737N Failed to write output data file for output node out-node when processing record at line line of input data file.

Explanation

An I/O error occurred while writing a record to the output data file for node out-node.

User response

Check your operating system documentation for file I/O errors and ensure that there is sufficient space on the output device.

SQL2738W Record at line line of input data file has been truncated when writing to the output data file for node out-node. Expected writing length is reclen while actual writing length is real-len.

Explanation

Expected writing length (RECLEN) does not match the actual writing length.

User response

Adjust record length value defined in the configuration file.

SQL2739N The record length was not specified for a binary numerical data file.

Explanation

If a binary numerical input data file, the record length has to be defined.

User response

Please specify the record length in your configuration file.

SQL2740N Float data type is not allowed in a non-binary input data file.

Explanation

Float data type is only supported when the file type is BIN (binary).

User response

Make sure data types and the type of input data file match.

SQL2741N Invalid file type specification at line line of the configuration file.

Explanation

The file type specification (FILETYPE) in the configuration file is not valid.

User response

Valid values for the file type parameter are as follows:
  • ASC (positional ascii data file)
  • DEL (delimited ascii data file)
  • BIN (ASC file with all numeric data in binary format)
  • PACK (ASC file with all decimal data in packed decimal format)
  • IMPLIEDDECIMAL (DEL file with decimal data in implied decimal format).

All the values are case insensitive.

SQL2742N The length of partition key partition-key does not match its precision.

Explanation

In a binary input data file, the length of a partition key with decimal data type must conform to the equation: LENGTH=(PRECISION+2)/2 (integer division), because it is a packed decimal.

User response

Match the length of a decimal-typed partition key with its precision if the input data file is a binary data file.

SQL2743N The length of partition key partition-key does not match its data type.

Explanation

In a binary input data file, the length of a partition key with integer, small integer, float, and double data type must be a predefined constant, i.e. 4 for integer, 2 for small integer, 4 for float, and 8 for double.

User response

Check partition key definitions in the configuration file.

SQL2744N Illegal file name specification for file at line line of the configuration file.

Explanation

The maximum length for a file name is 80 bytes.

User response

Check the configuration file.

SQL2745N Invalid NEWLINE flag at line line of the configuration file.

Explanation

The NEWLINE flag must be either YES or NO, and if not given, it is NO.

User response

Check the specification of NEWLINE flag in the configuration file.

SQL2746N An incomplete record was found while reading record record-number from the input data file.

Explanation

If a fixed-length positional ASC file or a binary numerical data file, each record has to be exactly the same length as the value of the RECLEN parameter in the configuration file.

User response

Make sure the input data file is complete.

SQL2747N A record was too long while reading record rec-no from the input data file.

Explanation

For a positional ASC input data file or a delimited data file with parameter 32KLIMIT on, the maximum record length can not exceed the 32k (bytes) limit.

User response

Check your input data file and make sure the record length is less than 32k bytes.

SQL2748N Record record-number has a length of length bytes, which is too short to hold the partitioning key key.

Explanation

For a positional ASC input data file or a binary numerical data file, each record has to be long enough to hold all partitioning keys.

User response

Check the record length of your input data file.

SQL2749N Partitioning key key-no of record rec-no was not in the first 32k bytes of the record.

Explanation

If a record is greater than 32k bytes long in a delimited data file, all partitioning keys of each record have to be within the first 32k bytes of the record.

User response

Check record rec-no in the input data file.