SQL1250N A database partition is not added because XML features have been used in the instance.

Explanation

An instance of the database manager has already had at least one database created where an XML object, such as a table with a column of data type XML or a XML schema repository object, was created. Even if the XML objects no longer exist, the database manager instance is still considered to have used XML. Once the database manager instance is known to have used XML in this way, the instance is no longer permitted to have more than a single database partition. Any attempt to add a database partition will return this error.

User response

If any of the databases that are part of the instance are using columns of data type XML or XML schema repository objects, then a different instance will be required to establish an instance with multiple database partitions.

If the databases in the instance are not actually intended for storage of XML data, the instance must be cleansed of all references to XML data. Indicators still exist in the instance and the databases, even when there are no longer columns of data type XML and XML schema repository objects. There are two approaches to clearing the instance XML indicator and database level XML indicators.

  1. Export non-XML data from the existing databases in the instance. Create a new instance with new databases. Import the data into the database in the new instance.
  2. Use a password protected db2pdcfg option to change the XML indicators in the database configuration for each database within the instance and for the database manager configuration of the instance. Before this is done, it is extremely important that no database in the instance includes any columns of type XML and that the XML schema respository of each database is empty. Contact IBM Service to use this option.

SQL1251W No data returned for heuristic query.

Explanation

There are no indoubt transactions in the database, nor any transactions that have ended and are waiting to enter the syncpoint process.

User response

No action is required.

SQL1252N More than one procedure was identified at the data source for the source procedure source-procedure-name specified in the CREATE PROCEDURE (Sourced) statement. Reason code = reason-code.

Explanation

More than one procedure was identified at the data source for the source procedure procedure-name specified in the CREATE PROCEDURE (Sourced) statement. Possible reason codes are:
1
There are multiple source procedures at the data source with identical source procedure name and source schema name.
2
There are multiple source procedures at the data source with identical source procedure name, source schema name and NUMBER OF PARAMETERS.
3
There are multiple source procedures at the data source with identical source procedure name.

User response

Actions based on the reason codes are:
1
Specify the NUMBER OF PARAMETERS in the CREATE PROCEDURE (Sourced) statement to help uniquely identify the procedure at the data source.
2
Specify the UNIQUE ID in the CREATE PROCEDURE (Sourced) statement to help uniquely identify the procedure at the data source.
3
Specify the source-schema-name in the CREATE PROCEDURE (Sourced) statement to help uniquely identify the procedure at the data source.

sqlcode: -1252

sqlstate: 42725

SQL1253N The source procedure with the name source-procedure-name was not found at the data source. Reason code = reason-code.

Explanation

The source procedure specified in the CREATE PROCEDURE (Sourced) statement was not found at the data source. Possible reason codes are:
1
The source object name along with the NUMBER OF PARAMETERS does not identify a procedure at the data source.
2
The source object name along with the NUMBER OF PARAMETERS and UNIQUE ID does not identify a procedure at the data source.
3
The source package name specified in the CREATE PROCEDURE (Sourced) statement is not found at the data source.
4
The source package name specified in the CREATE PROCEDURE (Sourced) statement is marked invalid at the data source
5
The source object name does not identify a procedure at the data source.
6
The source object name specifies a UNIQUE ID, but UNIQUE ID is not supported at the data source.

User response

Actions based on the reason codes are:
1
Verify that the NUMBER OF PARAMETERS specified is correct.
2
Verify that the UNIQUE ID specified is valid for the data source and identifies a procedure at the data source.
3
Verify that the source package name specified is correct.
4
Correct the package definition at the data source.
5
Verify that the source object name specified is correct.
6
Remove the UNIQUE ID clause.

sqlcode: -1253

sqlstate: 42883

SQL1254N The data type data-type is not supported by the federated server or data source server-name. It was used for parameter parameter-name in the procedure procedure-name.

Explanation

The data type of the parameter that was specified for the procedure is not supported by either the federated server or the data source that was accessed.

User response

Specify a supported data type and resubmit the program.

sqlcode: -1254

sqlstate: 428C5

SQL1255N The option value value specified for procedure procedure-name does not match the corresponding option of the source procedure.

Explanation

The value for SQL data access (NO SQL, CONTAINS SQL, READS SQL DATA, or MODIFIES SQL DATA), determinism (DETERMINISTIC or NOT DETERMINISTIC), or external action (EXTERNAL ACTION or NO EXTERNAL ACTION) specified in the CREATE PROCEDURE (Sourced) statement does not match the corresponding option of the source procedure.

User response

Correct the option value to match the corresponding option of the source procedure.

sqlcode: -1255

sqlstate: 428GS

SQL1256W The package body for the source procedure source-procedure-name at the data source was not found or is invalid.

Explanation

The federated procedure was created successfully but the package body for the source procedure procedure-name at the data source was not found or is invalid.

User response

Ensure that the package body of the source procedure is valid before the federated procedure is invoked.

sqlcode: +1256

sqlstate: 0168A

SQL1257N The query must contain a predicate using the column column-name in nickname nickname.

Explanation

The data source requires a predicate that uses the indicated column. Either the predicate is not in the query, or the predicate is in the query but was not made available to the data source wrapper during query compilation.

User response

If the required column is not used in a predicate in the query, add a predicate that uses the column appropriately. If the required column is in a predicate in the query, restructure the query so that the predicate is valid. Valid predicates are listed in the documentation for the data source.

sqlcode: -1257

sqlstate: 429C0

SQL1258N The SYSTOOLSPACE and SYSTOOLSTMPSPACE table spaces must be created in the IBMCATGROUP database partition group.

Explanation

In order for the SYSTOOLSPACE and SYSTOOLSTMPSPACE table spaces to be created, they must be defined in the IBMCATGROUP database partition group.

User response

Resubmit the CREATE TABLESPACE command and specify the IN IBMCATGROUP clause.

sqlcode: -1258

sqlstate: 560CJ

SQL1259N The ARCHIVE LOG command failed for database db-name on database partition partition-list due to SQLCODE SQLCODE.

Explanation

An SQL error occurred while attempting to issue the ARCHIVE LOG command for database db-name on database partition partition-list.

User response

Refer to the SQLCODE in the Message Reference for the user response and resubmit the ARCHIVE LOG command.

SQL1260N Database name is not configured for roll-forward recovery on node(s) node-list.

Explanation

The specified database is not configured for roll-forward recovery on the specified node(s). If ",..." is displayed at the end of the node list, see the administration notification log for the complete list of nodes.

The database is not rolled forward on the specified node(s).

(Note : if you are using a partitioned database server, the node number(s) indicate which node(s) the error occurred on. Otherwise, it is not pertinent and should be ignored.)

User response

Ensure that recovery is required on the specified node(s), then restore the most recent backup version of the database on these nodes.

SQL1261N Database name is not in rollforward pending state on node(s) node-list, so it does not need to be rolled forward on these nodes.

Explanation

The specified database is not in roll-forward pending state on the specified node(s). This may be because the database has not been restored, or was restored with the WITHOUT ROLLING FORWARD option, or roll-forward recovery is complete on these nodes.

If ",..." is displayed at the end of the node list, see the administration notification log for the complete list of nodes.

The database is not rolled forward.

(Note : if you are using a partitioned database server, the node number(s) indicate which node(s) the error occurred on. Otherwise, it is not pertinent and should be ignored.)

User response

Do the following:
  1. Ensure that recovery is required on the specified node(s).
  2. Restore a backup version of the database on these nodes.
  3. Issue the ROLLFORWARD DATABASE command.

SQL1262N The point-in-time specified for rolling forward database name is not valid.

Explanation

The timestamp parameter specified for the point-in-time stopping value is not valid. The timestamp must be entered in ISO format (YYYY-MM-DD-hh.mm.ss.<ssssss> where YYYY represents year, MM represents month, DD represents day, hh represents hours, mm represents minutes, ss represents seconds, and ssssss represents optional microseconds).

The database is not rolled forward.

User response

Ensure that the timestamp is entered in the correct format.

When you issue a ROLLFORWARD DATABASE command, ensure that you are not specifying a year greater than 2105.

SQL1263N The archive log file logfile is not a valid log file for database database-name on database partition dbpartitionnum and log stream log-stream-ID.

Explanation

The specified archive log file exists in the database log directory or the overflow log directory on the specified database partition, but the file is not valid.

Rollforward recovery processing stops.

(Note: If you are using a partitioned database server, the database partition number indicates the database partition on which the error occurred. Otherwise, this value is not pertinent and should be ignored.)

User response

To determine the correct archive log file, issue the ROLLFORWARD DATABASE command with the QUERY STATUS option. Move the correct archive log file into the database log directory or, if the database is in a consistent state, change the log path to point to the correct archive file, and issue the ROLLFORWARD DATABASE command again. Alternatively, reissue the command with the overflow log path pointing to the correct archive file.

SQL1264N The archive log file logfile does not belong to database database-name on database partition dbpartitionnum and log stream log-stream-ID.

Explanation

The specified archive log file was found in the log directory or the overflow log directory but does not belong to the specified database.

Rollforward recovery processing stops.

(Note: If you are using a partitioned database server, the database partition number indicates the database partition on which the error occurred. Otherwise, this value is not pertinent and should be ignored.)

User response

To determine the first archive log file that does not belong to the database, issue the ROLLFORWARD DATABASE command with the QUERY STATUS option. To continue with rollforward recovery:

  • If you are using an overflow log path, verify that it applies to the correct database and contains the correct archive files.
  • If you are not using an overflow log path, find the correct archive log files and copy them into the database log directory.

To stop rollforward recovery, perform one of the following steps before issuing the ROLLFORWARD DATABASE...STOP command:

  • Remove the invalid log files from the active log path and from the archive path (including the overflow path)
  • Replace the invalid log files with the correct log files in the active log path and the archive path (including the overflow path)

SQL1265N The archive log file logfile is not associated with the current log sequence for database database-name on database partition dbpartitionnum and log stream log-stream-ID.

Explanation

For rollforward recovery, log files must be processed in correct sequence. The log file sequence is determined by the database that has been restored or by the log files that have been processed. For table space-level rollforward recovery, moreover, the log files must be processed in the sequence through which the current state of the database was reached. The specified archive log file was found in the log directory or the overflow log path for the database on the specified database partition, but the log file is not in the correct log sequence.

Rollforward recovery processing stops.

(Note: If you are using a partitioned database server, the database partition number indicates the database partition on which the error occurred. Otherwise, this value is not pertinent and should be ignored.)

User response

To determine the correct archive log file, issue the ROLLFORWARD DATABASE command with the QUERY STATUS option. Move the correct archive log file into the database log directory or, if the database is in a consistent state, change the log path to point to the correct archive file and issue the ROLLFORWARD DATABASE command again. Alternatively, resubmit the command with the overflow log path pointing to the correct archive file.

SQL1266N The rollforward operation failed because the specified point-in-time value is not valid. This rollforward operation was a continuation of a previous rollforward operation. The point-in-time value specified for this rollforward operation was earlier in time than the point-in-time value specified for the previous rollforward operation. Database or table space name: database-or-table-space-name. Point-in-time value specified for the previous rollforward operation: timestamp.

Explanation

When a rollforward operation fails, is interrupted, or finishes but does not include the STOP or COMPLETE option, you must continue the rollforward operation by calling the ROLLFORWARD command, or the db2Rollforward API, again. However, a rollforward cannot be continued to a point in time that is earlier than the point-in-time value that was specified for the previous rollforward operation.

This message is returned when a rollforward operation is a continuation of a previous rollforward operation that did not complete and the previous rollforward operation was to a point in time that is later than the point in time specified for this rollforward operation. When continuing a rollforward operation that was to a point in time, the new rollforward must be one of the following:

  • a rollforward to the same point in time
  • a rollforward to a later point in time
  • a rollforward to the end of logs

This error can happen with both database and table space rollforward operations.

When this error occurs, rollforward processing stops.

User response

Respond to this error in one of the following ways:

  • Resubmit the ROLLFORWARD command, or db2Rollforward API, specifying a valid point-in-time value.
  • Resubmit the ROLLFORWARD command, or db2Rollforward API, specifying to rollforward to the end of logs.
  • Recover from a backup image by performing the following steps:
    1. Restore the database or table space subset from a backup image.
    2. Resubmit the ROLLFORWARD command, or db2Rollforward API.

SQL1267W An integrity verification failure occurred on log file logfile for database database-name on database partition dbpartitionnum and log stream log-stream-ID which has been archived. This log file will not be usable.

Explanation

The database is configured for log archiving, and a log file was archived with an integrity verification failure. This log file will not be usable if it is required by a database recovery operation, such as Restore, Rollforward or other operations which may require archived log file data. In addition, the db2ReadLog API or other tools which read log file data will not be able to process this log file.

An integrity verification failure occurs when the database engine's verification checking finds a problem with the log before it is archived. Detailed information related to the verification checking failure is written to the db2 diagnostic log file (db2diag.log).

User response

It is recommended to perform a full database backup operation now, in order to establish a new recovery starting point. This may help to eliminate the need for this log file should database Restore or Rollforward recovery be required. Likewise, if a db2ReadLog API (or other tools which may read archived log file data) cannot process this log file, then the application reliant on the log file data must establish a new starting point in a later log file.

SQL1268N Rollforward recovery processing has stopped because of error error while retrieving log file logfile for database database-name on database partition dbpartitionnum and log stream log-stream-ID.

Explanation

Rollforward processing is unable to retrieve a required log file. This error is sometimes returned because the target system to which you are attempting to restore the backup image does not have access to the facility being used by the source system to archive its transaction logs.

(Note: If you are using a partitioned database server, the database partition number indicates the database partition on which the error occurred. Otherwise, this value is not pertinent and should be ignored.)

User response

  • Ensure that log archiving is being performed correctly by checking the administration notification log. Correct any errors and resume rollforward recovery.
  • If the database is configured to use log archiving through a userexit program, check the userexit diagnostic logs to determine whether an error occurred while executing the userexit program. Correct the error and resume rollforward recovery.
  • Ensure that the target system to which you are attempting to restore the backup image has access to the facility being used by the source system to archive its transaction logs. Make appropriate changes and resume rollforward recovery.

SQL1269N Table space level roll-forward recovery is already running.

Explanation

An attempt has been made to use table space level roll-forward recovery but it is already running. Only one agent can be executing roll-forward recovery at any given time.

User response

Wait until table space level roll-forward recovery is complete. If more table spaces need recovery, initiate table space level roll-forward recovery again.

SQL1270C The LANG environmental variable is set to string. This language is not supported.

Explanation

The LANG environmental variable is set to a language that is not supported by the database manager. Processing cannot continue.

User response

Set the LANG environmental variable to a language that is supported. For more information please refer to “National Language Support” appendix in the Administration Guide.

Federated system users: see the Federated Systems Guide for NLS information.

SQL1271W Database name is recovered but one or more table spaces are offline on members or nodes node-list.

Explanation

This message can occur after crash recovery, database level roll-forward recovery, or table space level roll-forward recovery. For database level roll-forward recovery, the database is available for use if the STOP option was specified. One or more table spaces on the specified members or nodes are not available. This could happen if:

  • One or more table spaces receive I/O errors during recovery.
  • One or more table spaces may require storage definition following recovery.
  • One of more table spaces are unusable and must be dropped.
  • One or more table spaces have been taken offline.
  • Additional table spaces are restored while a table space level roll-forward recovery is already in progress.
  • The database is rolled forward past a previous point-in-time table space roll-forward, causing all table spaces involved to be placed in restore pending state.

The table spaces that are offline can be identified on the specified members or nodes by the MON_GET_TABLESPACE table function. In environments other than DB2 pureScale environments, the db2dart utility can also be used. The administration notification log will provide more information on specific table spaces.

If ",..." is displayed at the end of the member or node list, see the administration notification log for the complete list of member or nodes.

Note: The member or node numbers provide useful information only in DB2 pureScale environments and partitioned database environments. Otherwise, the information should be ignored.

User response

Repair or restore the table spaces if necessary and run roll-forward recovery. If the same message occurs, try running table space level roll-forward recovery offline.

SQL1272N Table space level roll-forward recovery for database name has stopped before completion on members or nodes node-list.

Explanation

Table space level roll-forward recovery has stopped on the specified members or nodes before all qualifying table spaces could be rolled forward.

This message can be returned for the following types of reasons:

  • The transaction table is full.
  • All table spaces being rolled forward received I/O errors.
  • Point-in-time table space level roll-forward encountered an I/O error on one of the table spaces being rolled forward.
  • Point-in-time table space level roll-forward encountered an active transaction that made changes to one of the table spaces being rolled forward. This transaction could be an indoubt transaction.
  • The table space level roll-forward was interrupted and, before it was resumed, all table spaces that were being rolled forward are restored again.
  • The table space rollforward state information has become corrupted or been lost.
  • A lock timeout or deadlock occurred.

If ",..." is displayed at the end of the member or node list, see the administration notification log for the complete list of members or nodes.

Note: The member or node numbers provide useful information only in DB2 pureScale environments and partitioned database environments. Otherwise, the information should be ignored.

User response

Check the administration notification log for the cause. Do one of the following depending on the cause:

  • Use the MON_GET_TABLESPACE table function to determine if the table spaces received I/O errors. If the table spaces received I/O errors, repair them.
  • If the transaction table became full, increase the MAXAPPLS database configuration parameter or try running table space level roll-forward recovery offline.
  • If the cause is an active or indoubt transaction, complete the transaction.
  • If the table spaces were restored after a previous table space level roll forward was interrupted, the previous table space level roll-forward is now canceled. The next table space level roll-forward command will check for table spaces in rollforward pending state.
  • Cancel the rollforward operation, which will put the table space in restore pending state. Before reissuing the ROLLFORWARD command, restore a table space level backup image.

Run table space level roll-forward recovery again.

SQL1273N An operation reading the logs on database database-name cannot continue because of a missing log file log-file-name on database partition dbpartitionnum and log stream log-stream-ID.

Explanation

The operation cannot find the specified log file in the archive, database log directory, or overflow log directory for the given log stream. The operation reading the logs has been stopped. This operation was either a recovery operation, a rollforward operation, a call to the db2ReadLog API, or any other operation that requires access to the transaction logs.

If the operation was a crash recovery, the database is left in an inconsistent state. If the operation was a rollforward operation, the operation has stopped and the database is left in rollforward pending state.

User response

Recover the missing log file by taking one of the following actions:

  • Move the specified log file into the database log directory and restart the operation.
  • If an overflow log path can be specified, restart the operation with the overflow log path, specifying the path that contains the log file.

If the missing log file cannot be found, determine whether one of the following special cases applies:

  • If the operation is a ROLLFORWARD DATABASE command to maintain a standby system through log shipping, this error might be normal, because some files that are available on the primary site might not yet be available on the standby system. To ensure that your standby system is up-to-date, issue a ROLLFORWARD DATABASE command with the QUERY STATUS option after each rollforward operation to verify that the log replay is progressing properly. If you find that a rollforward operation on the standby system is not making progress over an extended period of time, determine why the log file that is reported as missing is not available on the standby system, and correct the problem. Note that the ARCHIVE LOG command can be used to truncate currently active log files on the primary system, making them eligible for archiving and subsequent replay on the standby system.
  • If a ROLLFORWARD DATABASE command with the TO END OF LOGS option was issued following a restore operation from an online backup image in which the only available logs are those that were included in the backup image, there are two possible scenarios to consider:
    • Scenario 1: All of the log files contained in the backup image are found by the rollforward operation. However, the rollforward operation still looks for log files that were updated following the original backup operation. Bring the database to a consistent state by issuing the ROLLFORWARD DATABASE command with the STOP option (without the TO END OF LOGS option). To avoid this scenario in the future, use the END OF BACKUP option instead of the END OF LOGS option, because the rollforward operation will not look for log files that were updated after the backup was taken.
    • Scenario 2: One or more log files that were contained in the backup image were not found by the rollforward operation. These log files are required to bring the database to a consistent state. Attempting to bring the database to a consistent state by issuing the ROLLFORWARD DATABASE command with the STOP option (without the TO END OF LOGS option) will fail with SQL1273N; recover the missing log file, as described earlier in this section.

If the missing log file cannot be recovered:

  • If the operation is a ROLLFORWARD DATABASE command, you can issue the ROLLFORWARD DATABASE command again with the STOP option (without the END OF LOGS option or the END OF BACKUP option) to bring the database to a consistent state. If this consistency point (immediately prior to the missing log file) is not acceptable, you can restore the database and roll forward to any point in time that is prior to the missing log file by providing an earlier time stamp to the ROLLFORWARD DATABASE command.
  • If the operation is a ROLLFORWARD DATABASE command with the STOP or COMPLETE option (without the END OF LOGS option or the END OF BACKUP option), the missing log file is needed to bring the database to a consistent state. Because you cannot recover the missing log file, you must restore and roll forward to an earlier point in time (as long as that point in time is not prior to the minimum recovery time).
  • If the operation is a call to the db2ReadLog or db2ReadLogNoConn API for the purpose of replicating data, resynchronize the replicated tables and terminate the current connection being used by the API. If the API is being used to maintain a disaster recovery site, a backup image that was created after the last time stamp in the missing log file must be restored to the disaster recovery site before any subsequent API calls can complete successfully. If the API is being used for any other purpose, terminate the connection being used by the API and deactivate the database. In all cases, restart the scan by creating a new connection to the database and calling the API with the query action. Use the nextStartLRI as the piStartLRI on the next call to the API.

SQL1274N The database name requires roll-forward recovery and the point-in-time must be to the end of logs.

Explanation

The database needs to be rolled forward. For database level roll-forward recovery, the point-in-time must be to the end of logs because a database level roll-forward to end of logs is already in progress. To continue the roll forward, the same stoptime must be specified.

For table space level roll-forward recovery, the point-in-time must be to the end of logs for one of the following reasons:
  • The system catalogs require roll-forward recovery. System catalogs must always be rolled forward to the end of logs to remain consistent with all other table spaces.
  • A table space level roll-forward to the end of logs is already in progress. To continue the roll forward, the same stoptime must be specified.
  • The point in time specified for a table space level roll-forward is past the end of the logs of the database. It is very likely that this time is incorrect. If this is the intended recovery stop time, resubmit the command with the END OF LOGS option.

The database is not rolled forward.

User response

Resubmit the ROLLFORWARD command specifying ROLLFORWARD TO END OF LOGS.

SQL1275N The stop time passed to the rollforward utility must be greater than or equal to timestamp timestamp, because database name on nodes node-list contains information later than the specified time.

Explanation

The stop time passed to the rollforward utility must be greater than or equal to the time the backup ended on the specified nodes.

If ",..." is displayed at the end of the node list, see the administration notification log for the complete list of nodes.

(Note: If you are using a partitioned database server, the node number or numbers indicate which nodes the error occurred on. Otherwise, it is not pertinent and should be ignored.)

User response

Do one of the following:

  • Resubmit the command with a stop time greater than or equal to timestamp.
  • Restore an earlier backup on the specified nodes, then issue the ROLLFORWARD DATABASE command again.

SQL1276N Database name cannot be brought out of rollforward pending state until roll-forward has passed a point in time greater than or equal to timestamp, because node node-number contains information later than the specified time.

Explanation

A request was made to bring the database or subset of table spaces out of rollforward pending state by specifying caller action SQLUM_ROLLFWD_STOP, SQLUM_STOP, SQLUM_ROLLFWD_COMPLETE, or SQLUM_COMPLETE. However, the database or at least one of the table spaces to be rolled forward was backed up online. The request cannot be granted until the database or all table spaces have been rolled forward to the end of the online backup timestamp on the specified node.

This error can also occur if not all the log files are provided to perform the requested recovery.

(Note : if you are using a partitioned database server, the node number indicates which node the error occurred on. Otherwise, it is not pertinent and should be ignored.)

User response

If the stoptime specified on the ROLLFORWARD command is smaller then timestamp, resubmit the command with a stoptime greater than or equal to timestamp.

Verify that all the log files were provided. the ROLLFORWARD QUERY STATUS command shows which log file is to be processed next. Some of the reasons for missing log files include:

  • the log path has changed. The file can be found in the old log path.
  • The database manager is unable to find the log file from the archive location reflected by the current LOGARCHMETH1 or LOGARCHMETH2 database configuration parameters.

If the missing log file is found, copy it to the log path and resubmit the command.

SQL1277W A redirected restore operation is being performed. During a table space restore, only table spaces being restored can have their paths reconfigured. During a database restore, storage group storage paths and DMS table space containers can be reconfigured.

Explanation

The Restore utility validates that the containers needed by each table space being restored are currently accessible on the system. Where possible, the Restore utility will create the containers if they do not exist. If they cannot be created, are currently in use by another table space, or are inaccessible for any other reason, then the list of containers needed must be corrected before the restore operation can continue.

In a redirected restore, the state of each container of a non-automatic storage table space being restored is set to "storage must be defined". This makes it possible to use the SET TABLESPACE CONTAINERS command or API against the containers to redefine their storage.

For table spaces using automatic storage, the only way to redefine container paths is to use the SET STOGROUP PATHS command for a specific storage group or the ON keyword when you issue the RESTORE DATABASE command to redefine all the storage groups paths. You cannot use the SET TABLESPACE CONTAINERS command or API against automatic storage table spaces.

User response

To determine the list of containers for each table space being restored, use the MON_GET_CONTAINER table function. To specify an updated list for each table space, use the SET TABLESPACE CONTAINERS command or API. This API or command lets you specify whether this should be the initial list of containers (meaning that a subsequent rollforward will redo any "add container" operations described in the database log) or the final list (meaning that the rollforward operation will not redo "add container" operations).

It is also possible that the container(s) or storage path(s) are read-only, in which case the only action required before continuing with the restore is to give read/write access to the container(s) or storage path(s).

To reconfigure the paths of specific storage groups during a database restore, use the SET STOGROUP PATHS command.

When you are ready to proceed with the restore, issue a RESTORE DATABASE command with the CONTINUE keyword to perform the actual restore.

If this warning is returned after issuing the RESTORE DATABASE command with the CONTINUE keyword then that means some table space container or storage group storage path still needs to be defined. Check the db2diag log file for more details.

SQL1279W Some indexes may not have been recreated.

Explanation

An error occurred during index recreation while performing a database restart or following a table reorganization which may have prevented some of the indexes from being recreated successfully. Details can be found in administration notification log.

Database restart or Reorg table was successful.

User response

Examine the administration notification log to determine why the index(es) could not be recreated and correct the problem. The invalid indexes for a table will be recreated when the table is first accessed.

SQL1280N The stoptime passed to roll-forward must be less than or equal to timestamp for database name because at least one of the table spaces was already rolled forward to this point in time.

Explanation

At least one of the table spaces specified by the roll-forward to point in time has already been rolled forward to an earlier point in time. It cannot be rolled forward any further.

User response

Do one of the following:
  • Resubmit the command with stoptime timestamp.
  • Restore all table spaces again, and resubmit the command with a stoptime less than timestamp.
  • Restore the table space backup(s) taken following the earlier table space roll-forward to point in time and resubmit the command with the same stoptime.

Time must be specified in CUT (Coordinated Universal Time).

SQL1281N The connection to database database-alias has been severed because the pipe pipe-name has been broken.

Explanation

The connection was lost because the database server broke the pipe. The current transaction has been rolled back.

User response

Resubmit the current command. If the error continues, contact your technical service representative.

If trace was active, invoke the Independent Trace Facility at the operating system command prompt. Contact your technical service representative with the following information:

Required information:
  • Problem description
  • SQLCODE or message number
  • SQLCA contents, if possible
  • Trace file, if possible.

sqlcode: -1281

sqlstate: 40504

SQL1282N The attempt to connect to database database-alias failed because all the pipe instances on pipe-name are busy.

Explanation

Attempts to connect to the named pipe failed because the connection was refused by DB2. There is a limit to the number of connections that are allowed on the named pipe.

User response

Increase the connection limit on the database server, or terminate some of the applications using named pipe to free up connection resources.

sqlcode: -1282

sqlstate: 08001

SQL1283N The attempt to connect to database database-alias failed because the pipe pipe-name is in use by another process.

Explanation

The name of the named pipe is already in used by another process. Named pipe support did not start.

User response

Choose a different name by setting the environment variable DB2PIPENAME, or have the other programs which use named pipe use a different pipe name.

SQL1284N The attempt to connect to database database-alias failed because the pipe pipe-name cannot be found.

Explanation

The server has not started its named pipe support, or the server is using a different name for the named pipe.

User response

Start the database manager and ensure the named pipe support starts. If the named pipe support has been started, then ensure the name of the named pipe is the same between the client and server by setting the environment variable DB2PIPENAME to the same value.

sqlcode: -1284

sqlstate: 08001

SQL1285N The attempt to connect to database database-alias failed because the pipe pipe-name is invalid.

Explanation

The alternate pipe name set by the environment variable DB2PIPENAME is invalid.

User response

The value of the environment variable DB2PIPENAME must be a valid pipe name. The pipe name must be no longer than eight characters, and has the same syntactical restrictions as a normal file name.

sqlcode: -1285

sqlstate: 08001

SQL1286N The connection to database database-alias has been severed because the operating system ran out of resources for pipe pipe-name.

Explanation

Named pipe failed because the operating system ran out of resources (swapping space, disk space, file handles). The current transaction has been rolled back.

User response

Free up the system resources and try again.

sqlcode: -1286

sqlstate: 40504

SQL1287N ATTACH to instance instance failed because the named pipe pipe cannot be found.

Explanation

The server has not started its named pipe support, or the instance name is incorrect.

User response

Ensure that the database manager is started at the server and that the named pipe support is started. Ensure that the instance name is correct.

SQL1288N The remote server does not support this operation.

Explanation

The remote server is running on a 64-bit platform that does not support non-SQL requests from Version 7 (or earlier) 32-bit clients.

User response

Perform this operation from a supported client.

SQL1289W During conversion of an argument to function-name from code page from-code-page to code page to-code-page, one or more invalid characters were replaced with a substitute character, or a trailing partial multi-byte character was omitted from the result.

Explanation

The input to function-name passed to the code page conversion function contains a byte sequence that is not a valid character in the input code page, from-code-page. Each invalid byte sequence was replaced with the substitute character when converting to to-code-page. The inserted substitute character may or may not be included in the final result. If an invalid byte sequence appears at the end of the input, it is omitted from the result rather than replaced with a substitute character.

If function-name is *N, the invalid byte sequence was encountered while the input value was being converted to code page 1232 for internal processing.

User response

Ensure that the data being converted does not contain invalid byte sequences.

sqlcode: +1289

sqlstate: 01517

SQL1290N The value of either the DFT_CLIENT_COMM database manager configuration parameter or the DB2CLIENTCOMM environment variable is not valid.

Explanation

Either an incorrect value was specified or the protocol(s) specified are not supported by the target database. The acceptable values are:

  • Unix platforms: TCPIP and APPC
  • Windows: TCPIP, APPC (Windows 32-bit only), and NPIPE

If more than one value is specified, then they must be delimited by a comma.

Note that this message may be returned from an intermediate node involved in your connection. For example, if you are trying to connect to a DRDA server via a DB2 Connect gateway and your client workstation does not use global directory services, this message may be returned from the DB2 Connect gateway.

User response

Correct the value and try again.

sqlcode: -1290

sqlstate: 08001

SQL1291N A directory services error has been detected. Service: directory-services-type, API: API, function: function, error code: rc.

Explanation

An error has been detected by the directory services subsystem. Refer to the token values for details. The following is the explanation of the token values:

directory-services-type

The type of the directory services being used. Valid tokens include:

  • DCE
API

The application programming interface used to access the listed directory services. Valid tokens include:

  • XDS/XOM
function

The name of the directory services subsystem function that returned the error code.

rc

The error code returned from the indicated function. The meaning of the value is specific to the API being used.

For XDS functions such as ds_read, the return code values can be found in the DCE include file xds.h.

For XOM functions such as om_get, the return code values can be found in the DCE include file xom.h.

Note that this message may be returned from an intermediate node involved in your connection. For example, if you are trying to connect to a DRDA server via a DB2 Connect gateway and your client workstation does not use global directory services, this message may be returned from the DB2 Connect gateway.

User response

Ensure that:

  • The product providing the directory services is properly installed and operational.
  • You are logged in to the directory services with the appropriate authorization to access the directory entries, if login is required by the directory services provider, for example, DCE.

If the problem persists, consult with your system administrator and/or database administrator to determine the cause of the problem using the set of tokens provided.

sqlcode: -1291

sqlstate: 08001

SQL1292N The global name of the database or database manager instance is invalid.

Explanation

The global name of the database or database manager instance cannot be NULL and cannot be longer than 255 characters. It must start with either "/.../" or "/.:/".

Note that this message may be returned from an intermediate node involved in your connection. For example, if you are trying to connect to a DRDA server via a DB2 Connect gateway and your client workstation does not use global directory services, this message may be returned from the DB2 Connect gateway.

User response

Correct the global name and try again.

SQL1293N An error was found in a global directory entry. Error code: error-code.

Explanation

An error has been detected in one of the global database directory entries used. Refer to the following error codes for details:

1

The database object does not contain authentication information

2

Both the database object and the database locator object do not contain communication protocol information

10

Entry not a database object

11

Native database name in the database object is either not found or too long

12

Database protocol in the database object is either not found or too long

13

Invalid authentication value found in the database object

14

Insufficient or invalid communication protocol information in the database object

15

Database locator object name not found in the database object

16

Database locator object name in the database object invalid

20

Entry not a database locator object

22

Insufficient or invalid communication protocol information in the database locator object

30

Entry not a routing information object

31

Target database information not found in the routing information object

32

Insufficient information for the target database in the routing information object

33

No appropriate gateway found in the routing information object

34

Invalid flag for authentication at gateway

35

Database locator object name for the gateway invalid

36

Database name in the target database information attribute of the routing information object is either not found or too long

37

Database protocol in the target database information attribute of the routing information object is either not found or too long

Note that you may also see this message if the DCE subsystem is not operational, or if you do not have sufficient privilege to read the DCE directory entry.

Note that this message may be returned from an intermediate node involved in your connection. For example, if you are trying to connect to a DRDA server via a DB2 Connect gateway and your client workstation does not use global directory services, this message may be returned from the DB2 Connect gateway.

User response

Make sure the DCE subsystem is operational and that you have the appropriate privilege to read the directory entry. If the problem persists, inform the database administrator to correct the error in the directory entry.

sqlcode: -1293

sqlstate: 08001

SQL1294N The directory path name being used for global directory access is not specified or not valid.

Explanation

In order to use global directory services, a directory path name must be specified either in the dir_path_name database manager configuration parameter, or in the DB2DIRPATHNAME environment variable. You either did not specify it, or the name you specified is not valid.

Note that this message may be returned from an intermediate node involved in your connection. For example, if you are trying to connect to a DRDA server via a DB2 Connect gateway and your client workstation does not use global directory services, this message may be returned from the DB2 Connect gateway.

User response

Consult your database administrator for the correct name to use, specify it, and try again.

sqlcode: -1294

sqlstate: 08001

SQL1295N The routing information object name being used for global directory access is not specified or not valid.

Explanation

In order to use global directory services to access a remote database with a database protocol that is not native to this client, the name of a routing information object must be specified either in the route_obj_name database manager configuration parameter, or in the DB2ROUTE environment variable. You either did not specify it, or the name you specified is not valid.

Note that this message may be returned from an intermediate node involved in your connection. For example, if you are trying to connect to a DRDA server via a DB2 Connect gateway and your client workstation does not use global directory services, this message may be returned from the DB2 Connect gateway.

User response

Consult with your database administrator for the correct object name to use, specify it and try again.

sqlcode: -1295

sqlstate: 08001

SQL1296N Valid values must be specified for the DIR_PATH_NAME and DIR_OBJ_NAME database manager configuration parameters if the DIR_TYPE parameter has a value other than NONE.

Explanation

These three parameters are interrelated. If the DIR_TYPE value is NONE, then the other two are ignored. If the DIR_TYPE value is not NONE, then the other two must both contain valid values. The following rules apply when the DIR_TYPE value is not NONE:
  1. The DIR_PATH_NAME and DIR_OBJ_NAME values cannot be NULL (or blanks).
  2. If the DIR_TYPE value is DCE, then the DIR_PATH_NAME value must start with either of the special DCE strings enclosed in the following quotes: "/.../" or "/.:/".

User response

If you want to change the DIR_TYPE value, make sure the DIR_PATH_NAME and DIR_OBJ_NAME parameters have been specified with the valid values first. If you want to blank out either the DIR_PATH_NAME or the DIR_OBJ_NAME parameter, make sure you set DIR_TYPE to NONE first.

SQL1297N This command is currently not supported on this platform.

Explanation

The function requested using this command is not supported on this platform.

User response

Do not use this command.

SQL1300N Invalid DCE principal name in catalog statement.

Explanation

The DCE principal name in the catalog database operation was invalid. DCE principal names are subject to the following conditions:

  • If AUTHENTICATION is specified as DCE, a principal name must be included in the catalog statement.
  • If AUTHENTICATION is not specified as DCE, a principal name can not be included in the catalog statement.
  • The maximum length of the principal name is 1024 bytes.

User response

Ensure that the principal name conforms to the listed conditions, and resubmit the catalog command.

SQL1301N An error occurred when accessing the server's DCE keytab file.

Explanation

An error occurred when accessing the server's DCE keytab file. For a keytab file to be valid, the following conditions must be satisfied:
  • The server's keytab file exists, has the name keytab.db2, and is in the sqllib/security directory.
  • There is only a single entry in the keytab file.

User response

Make sure that DCE is started. Next, check that the keytab file exists, and contains a single entry (with rgy_edit). Retry the operation.

SQL1302N DCE principal to DB2 authorization id mapping error. Reason code: reason-code.

Explanation

An error occurred when mapping a DCE principal to a DB2 authorization id. Refer to the following reason codes:

1

Missing or invalid DCE user to DB2 authorization id mapping.

2

Missing or invalid DCE group to DB2 authorization id mapping.

User response

The DCE principal must have an ERA mapping to a DB2 authorization id. Add the missing entry to the DCE registry, and retry the operation.

sqlcode: -1302

sqlstate: 08001

SQL1303N Security daemon could not be restarted.

Explanation

An attempt to restart the security daemon has failed after communication between the agents and the security daemon was severed or the security daemon terminated abnormally. All new connections to the database manager will be rejected, as authentication is not possible.

User response

Stop the database manager and start it again. If the db2start command fails, follow the user response for that sqlcode.

sqlcode: -1303

sqlstate: 58004

SQL1304N The TCP/IP security type SOCKS is not valid.

Explanation

The TCP/IP security type SOCKS in the TCP/IP protocol structure of the Catalog Node command is invalid with authentication type DCE.

User response

Make sure you do not use the combination of TCP/IP protocol with security type SOCKS and authentication type DCE.

sqlcode: -1304

sqlstate: 08001

SQL1305N An internal DCE error occurred.

Explanation

Database manager processing failed due to an internal DCE error.

User response

Make sure DCE is started. If the problem persists, contact a service representative for assistance.

sqlcode: -1305

sqlstate: 58004

SQL1306N An invalid parameter was specified during invocation of the security audit facility. Reason Code: reason-code.

Explanation

One of the parameters of the security audit API is incorrect. Reasons:
1
An invalid audit option was specified.
2
Invalid pointer to Configure/Describe sqleaucfg structure.
3
Invalid Configure/Describe parameter token.
4
Invalid Configure/Describe parameter value. The value is incorrect or outside the valid range for the parameter.
5
Invalid count specification for Configure/Describe parameter.
6
Insufficient length allocated for Configure/Describe parameter.
7
Invalid pointer to Extract sqleauextract structure.
8
Invalid Extract parameter token.
9
Invalid Extract parameter value. The value is incorrect or outside the valid range.
10
Invalid count specification for Extract parameter.
11
Invalid length for Extract parameter.
12
Invalid Archive parameter value. The value is incorrect or outside the valid range.
13
Invalid path. The length of the path is outside the valid range.
14
The use of a relative path is unsupported.

User response

The system administrator should take specific actions for each of the reasons.
1
Provide the right option value for the audit API call by looking at the sqlutil.h include file.
2
Check to see if a valid pointer has been provided to a Configure/Describe structure.
3
The correct parameter should be specified by looking up the audit facility reference section for the sqleaucfg parameter tokens.
4
Correct the parameter value by looking up the valid values in the audit facility reference.
5
Specify the correct count and allocate/initialize the appropriate length for variable length parameters.
6
Correct the length allocated for Configure/Describe parameter based on the error token that is returned in the SQLCA.
7
Check to see if a valid pointer has been provided to a Extract structure.
8
The correct parameter should be specified by looking up the audit facility reference section for the sqleauextract parameter tokens.
9
Correct the parameter value by looking up the valid values in the audit facility reference.
10
Specify the correct count and allocate/initialize the appropriate length for variable length parameters.
11
Correct the length allocated for Extract parameter based on the error token that is returned in the SQLCA.
12
Correct the parameter value or the parameter length by looking up the valid value in the audit facility reference.
13
Provide a path with a length in the supported range.
14
Specify an absolute path.

SQL1307N An error occurred during invocation of the security audit facility. Reason Code: reason-code.

Explanation

The invocation of the security audit API caused an error to occur. Reasons:

  1. Audit is already started.
  2. Audit is already stopped.
  3. Invalid checksum for audit configuration file.
  4. The default or user-provided audit pathname is too long.
  5. Could not update the audit configuration file. Either the filesystem is full or the permissions do not allow write.
  6. Configuration File not found. Either the file or the directory which contains the file does not exist.
  7. The extract file is not found.
  8. Invalid format of audit records during extract. The file is corrupted.
  9. The file does not exist.
  10. Access to the file is denied due to file permissions.
  11. The active audit log has already been archived and new events can not be logged to it.
  12. Out of disk space (disk full).
  13. File I/O error during Extract or Archive.
  14. Extract can not be performed on the active audit log file.

User response

The system administrator should take specific actions for each of the reasons.

  1. No action required.
  2. No action required.
  3. Restore the configuration file from backup or issue 'audit reset' command.
  4. Choose a different audit pathname which is within the filename length limit.
  5. If the file permissions are incorrect,set the permissions to allow write by owner. If the filesystem is full, create free space before proceeding.
  6. If the audit configuration file is missing, then restore it from a backup or issue the 'reset' command to initialize the file to defaults. If the directory is missing, restore from a backup or recreate the database manager instance.
  7. Verify that file exists in the specified path. If file missing, restore from backup if available.
  8. The audit log file is most likely corrupted. If problem persists for other audit log files, notify DB2 service.
  9. Verify that the active log files to be archived or the archived log files to be extracted exist in the specified path.
  10. Correct the file permissions within the file system.
  11. An archived audit log file has been renamed to the active audit log file. The active audit log file must be renamed back to the archived audit log file.
  12. Ensure enough disk space is available.
  13. Check the db2diag log file for details.
  14. Extract must be run on an archived audit log file. Archive the active audit log file before extracting from it.

SQL1308W The audit Extract Facility completed Processing. num-records records were extracted.

Explanation

The security audit extract facility completed its processing succesfully and extracted the specified number of records.

User response

If zero records were extracted, the user should verify that the extract pathname contains extract files and the extract parameters are correct.

SQL1309N Invalid server principal name.

Explanation

The server principal name specified in the database catalog statement does not exist in the DCE registry. Because of this a DCE ticket could not be obtained for the database server.

User response

Make sure that the principal name in the database catalog entry corresponds to the DCE principal being used by the database server. It may be necessary to fully qualify the principal name.

sqlcode: -1309

sqlstate: 08001

SQL1310N The Database Connection Services directory service failed while attempting to access the Database Connection Services directory.

Explanation

The Database Connection Services Directory Service failed because of file errors while trying to access the Database Connection Services directory file.

The function cannot be processed.

User response

Rerun the function after doing one of the following:
  • If you are adding an entry to the Database Connection Services directory, ensure that there is sufficient space for the directory file to become larger.
  • Ensure that no other concurrently running program is trying to access the file.
  • Verify that the directory file has not been damaged. If it is unrecoverable, you must erase it and recreate it or restore it from a backed-up version.

SQL1311N The Database Connection Services directory cannot be found.

Explanation

The directory cannot be found. The directory may have been deleted.

The function cannot be processed.

User response

Use the CATALOG DCS DATABASE command to add an entry to the Database Connection Services directory, or restore the directory from a backed-up version.

SQL1312W The Database Connection Services directory is empty.

Explanation

An attempt was made to read the contents of the Database Connection Services directory, but no entries existed.

Processing continues, but subsequent commands expecting entries to be available cannot be processed.

User response

Use the Catalog DCS Database command to add entries to the directory or restore a backed-up version that contains entries.

SQL1313N The Database Connection Services directory is full.

Explanation

The entry cannot be added to the Database Connection Services directory because the directory has already reached its maximum size.

The function cannot be processed.

User response

Delete an entry or entries from the directory before adding any more entries.

SQL1314N The address of the Database Connection Services directory entry parameter is not valid.

Explanation

The application program has used an address for this parameter that is not valid. Either the address points to an unallocated buffer or the buffer is not large enough to contain the required input.

The function cannot be processed.

User response

Ensure that the application program has allocated the required buffer area and resubmit the command.

SQL1315N The local database name is not valid.

Explanation

A local database name was specified that contains characters that are not valid. All characters must be from the database manager base character set.

The function cannot be processed.

User response

Ensure that the characters used in the local database name are from the database manager base character set and resubmit the command.

SQL1316N No entry was found in the Database Connection Services directory for the specified local database name.

Explanation

The Database Connection Services directory service failed because no entry could be found in the Database Connection Services directory that corresponds to the input local database name.

The function cannot be processed.

User response

Ensure that the local database name is correct and resubmit the command.

SQL1317N The local database name already exists in the Database Connection Services directory.

Explanation

The entry could not be added to the directory because an entry for that local database name already exists in the directory.

The function cannot be processed.

User response

Specify a unique local database name or delete the existing entry and add the new entry.

SQL1318N The length of element name in the input structure for parameter 1 is not valid.

Explanation

The length values in the Database Connection Services directory entry structure should not be less than zero nor greater than the maximum length for the element it represents.

The function cannot be processed.

User response

If an element of the directory entry structure is specified, the associated length value should represent the number of bytes in the element. Otherwise, the length value should be zero. Ensure that all the directory entry structure elements have the required specifications and lengths for the command and resubmit the command.

SQL1319N The Database Connection Services directory entries have not been collected.

Explanation

A request to copy all the directory entries was received, but either a prior request to collect the entries was not received or the prior request to collect the entries failed.

The function cannot be processed.

User response

Issue a request to open the directory and collect the entries. Then resubmit this command.

SQL1320N The Database Connection Services directory cannot be accessed at this time.

Explanation

A request to access the Database Connection Services directory failed. Access to the Database Connection Services directory is dependent on the type of access requested and the current activity in the directory. If the request is for the intention of updating the directory, then the directory must not be active. If the request is to read the directory, then access is allowed if the directory is not being updated.

The function cannot be processed.

User response

Wait for the current activity to complete and resubmit the command.

SQL1321N The structure ID specified in the directory entry structure is not valid.

Explanation

The structure ID received in the directory entry structure does not represent a recognized value.

The function cannot be processed.

User response

Verify the structure ID passed in the directory entry structure is a valid value and resubmit the command.

SQL1322N An error occurred when writing to the audit log file.

Explanation

The database audit facility encountered an error when invoked to record an audit event to the trail. There is no space on the file system the audit log resides on. Free up space on this file system or prune the audit log to reduce its size.

User response

  • When more space is available, run the audit facility to flush out any data in memory, and to reset the auditor to a ready state.
  • Ensure that appropriate extracts have occurred, or a copy of the log has been made prior to pruning the log, because deleted records are not recoverable.

sqlcode: -1322

sqlstate: 58030

SQL1323N An error occurred when accessing the audit configuration file.

Explanation

db2audit.cfg could not be opened, or was invalid. Possible reasons:
  • The db2audit.cfg file either does not exist, or has been damaged. Take one of the following actions:
    • Restore from a saved version of the file.
    • Reset the audit facility configuration file by issuing the reset command from the db2audit executable.

User response

The system administrator should take the suggested action to resolve the problem.

sqlcode: -1323

sqlstate: 57019

SQL1324N Error converting data from nickname column schema.name.column. Reason Code: reason-code. Value: value.

Explanation

A data conversion problem occurred while transferring data from or to the remote source. Possible reasons:
1
Numeric value was out of range
2
Numeric value syntax error
3
Base 64 decoding error
4
Hexbin decoding error

User response

Check the data type mapping between the remote type and the local type. Also ensure that the remote system returns valid data.

SQL1325N The remote database environment does not support the command or one of the command options.

Explanation

An attempt has been made to issue a DB2 workstation database specific command or command option against a host database through DB2 Connect or federated server. The following commands generate this error when issued against a DB2 for MVS*, DB2 for OS/400* or SQL/DS* database:

  • OPSTAT (Collect Operational Status)
  • GETAA (Get Administrative Authorizations)
  • GETTA (Get Table Authorizations)
  • PREREORG (Prepare to Reorganize Table)
  • REORG (Call Reorganize Function)
  • RQSVPT/ENSVPT/RLBSVPT (Subtransaction Requests)
  • RUNSTATS (Run Statistics).
  • COMPOUND SQL ATOMIC STATIC (Atomic Compound SQL)
  • ACTIVATE DATABASE
  • DEACTIVATE DATABASE

As well, the following commands generate this error with incorrect options:

  • IMPORT (Import table) The filetype must be IXF, commitcount must be 0 for offline import or must not be automatic for online import, and the first word in the Action String (for example, "REPLACE into ...") must be INSERT.
  • EXPORT (Export table) The filetype must be IXF.

The command cannot be processed.

User response

Do not attempt to issue this command against a host database through DB2 Connect or federated server.

SQL1326N The file or directory name cannot be accessed.

Explanation

The file or directory name cannot be accessed because either the file permissions are incorrect, the file path is incorrect, or there is insufficient space in the directory or path.

If you are using a cluster manager, this error can be returned if the database manager failed to add the given path to the cluster manager configuration. Error messages from the cluster manager will be recorded in the db2diag log file.

User response

Verify that any path or filename specified in the command is valid, you have the proper permissions to access the path or filename, and there is sufficient space to contain the file. Correct the problem and resubmit the command. If the problem persists, contact your System Administrator.

If you are using a cluster manager, correct the problem and resubmit the command:

  • Review the db2diag log file for error messages from the cluster manager.
  • Respond to the cluster manager error messages in the db2diag log file to correct the underlying problem that prevented the database manager from adding the path to the cluster manager configuration.
  • Resubmit the command.

SQL1327N An implicit connection attempt failed. database-name is not a valid database name.

Explanation

An attempt to perform an implicit connection failed. The syntax of the database alias name specified by the DB2DBDFT environment variable is not valid. The database name must contain 1 to 8 bytes and all the characters must be from the database manager base character set.

The command cannot be processed.

User response

Correct the database alias name specified by the DB2DBDFT environment variable and resubmit your command. If using the command line processor, then a "db2 terminate" should be issued prior to resubmitting the command. If you do not want an implicit connection to be performed, remove the DB2DBDFT environment variable.

sqlcode: -1327

sqlstate: 2E000

SQL1328N An implicit connection attempt failed. The database alias name or database name name was not found in the local database directory.

Explanation

An attempt to perform an implicit connection failed. The database name specified by the DB2DBDFT environment variable does not name an existing database. The database could not be found in the database directory.

The command cannot be processed.

Note that a CONNECT RESET request issued within a distributed unit of work will attempt an implicit connect to the default database. This may be the reason for this error.

User response

  • Correct the database alias name specified by the DB2DBDFT environment variable and resubmit the command.
  • If the intended action is to remove a connection while operating in a distributed unit of work environment, consider replacing the CONNECT RESET statement with a DISCONNECT or RELEASE statement.
  • If using the command line processor, then a "db2 terminate" should be issued prior to resubmitting the command.
  • If you do not want an implicit connection to be performed, remove the DB2DBDFT environment variable.

sqlcode: -1328

sqlstate: 42705

SQL1329N The resolved path specified on the command is too long.

Explanation

The resolved path specified on the command exceeds the maximum length supported by the database manager. The resolved path must be no longer than 215 characters in length. During a Create Database, Catalog Database, Open Database Directory for scan, and change database comment commands, the database manager instance name is appended to the end of the specified path.

User response

Check that the fully resolved absolute or relative path name, including the database manager instance name, does not exceed 215 characters in length. Correct the path and resubmit the command.

SQL1330N The symbolic destination name name is not valid.

Explanation

The symbolic destination name in the CPIC protocol structure of the Catalog Node command is either not specified or longer than the allowable length. The name must be 1 to 8 bytes in length.

User response

Verify that the symbolic destination name is specified and that it is not longer than 8 bytes in length. Resubmit the command with a valid symbolic destination name.

SQL1331N The CPIC security type type is not valid.

Explanation

The CPIC security type specified in the CPIC protocol structure of the Catalog Node command is invalid. The security type specifies the security information that will be included when a database client allocates a conversation with a partner LU, as specified by the LU 6.2 architecture. Correct values for security type are:

SQL_CPIC_SECURITY_NONE

No access security information will be included.

Note: This is not supported when using federated server. When DB2 Connect is used, it is only supported when authentication type is DCE, KERBEROS, or SERVER_ENCRYPT.

SQL_CPIC_SECURITY_SAME

A userid will be included together with an indicator specifying that the userid is already verified. This is not supported when authentication type SERVER is used with DB2 Connect or federated server, or when authentication type is DCE, KERBEROS, or SERVER_ENCRYPT.

SQL_CPIC_SECURITY_PROGRAM

Both a userid and a password will be included. This is not supported when authentication type CLIENT is used with DB2 Connect or when authentication type is DCE, KERBEROS,or SERVER_ENCRYPT.

User response

Set the security type to one of the types listed in this message and resubmit the command.

sqlcode: -1331

sqlstate: 08001

SQL1332N The Host Name name is not valid.

Explanation

The host name in the TCP/IP protocol structure of the Catalog Node command is either not specified or longer than the allowable length. The name must be 1 to 255 characters in length and cannot be all blanks.

User response

Verify that the host name is specified and that it is not longer than 255 characters in length. Resubmit the command with a valid host name.

SQL1333N The Service Name name is not valid.

Explanation

The service name is the TCP/IP protocol structure of the Catalog Node command is either not specified or longer than the allowable length. The name must be 1 to 14 characters in length and cannot be all blanks.

User response

Verify that the service name is specified and that it is not longer than 14 characters in length. Resubmit the command with a valid service name.

SQL1334N The database server or DB2 Connect server cannot be used to route a remote request to a second database server in this configuration.

Explanation

An attempt was made to route a request through a database server node or DB2 Connect server node using an unsupported combination of client and target database server, or from a non-LUW DRDA client to a DRDA target database through a LUW database server or DB2 Connect server. The request must be routed directly from the client to the node on which the target database is running.

User response

Uncatalog the database at the client machine and then catalog the database specifying the node on which the database actually resides. Ensure that the node is also cataloged.

SQL1335N The application requestor name is not valid.

Explanation

An application requestor name was specified that contains characters that are not valid. All characters must be from the database manager base character set.

User response

Ensure that the characters used in the application requestor name are from the database manager base character set and resubmit the command.

SQL1336N The remote host hostname was not found.

Explanation

The system cannot resolve the address of the remote host. Possible causes are:

  • An incorrect hostname value was specified when the TCP/IP node was cataloged.
  • The correct hostname was specified, but was not defined in any TCP/IP name server accessible to your client node, nor in the client's hosts file.
  • The TCP/IP name server where the hostname was defined was not available at the time you tried to connect.
  • TCP/IP is not running.
  • The remote host was cataloged on this client using the CATALOG TCPIP6 NODE command. However, the remote host does not support IPv6.

User response

Make sure that TCP/IP is running and that the hostname specified when cataloging the TCP/IP node is a correct name, and that it is defined in an accessible name server or in the local hosts file.

If the remote host was cataloged on this client using the CATALOG TCPIP6 NODE command but the remote host does not support IPv6, then perform the following steps: (1) Use the UNCATALOG command and (2) recatalog using the CATALOG TCPIP NODE command.

Federated system users: verify that the remote host is cataloged correctly in the SYSCAT.SERVERS view.

sqlcode: -1336

sqlstate: 08001, 08508

SQL1337N The service service-name was not found.

Explanation

The system cannot resolve the port number associated with the service-name. Possible causes are:
  • An incorrect service-name value was specified when the TCP/IP node was cataloged.
  • The correct service-name was specified, but was not defined in the client's services file.

Federated system users: this situation can also be detected by the data source.

User response

Make sure that the service-name specified when cataloging the TCP/IP node is a correct name, and that it is defined in the local services file.

Federated system users must also ensure that the name is defined in the services file at the data source.

SQL1338N The symbolic destination name symbolic-destination-name was not found.

Explanation

The system cannot find the Side Information associated with the symbolic-destination-name you specified. Possible causes are:
  • An incorrect symbolic-destination-name value was specified when the CPIC NODE was cataloged.
  • The symbolic destination name and its associated side information have not been defined to the SNA communications subsystem.
  • The SNA communication subsystem has not been started.

User response

Make sure that the symbolic-destination-name specified when cataloging the CPIC node is a correct name, and that it has been defined to the local SNA communication subsystem.

Start the SNA communication subsystem if it has not been started.

SQL1339N n SQL error(s) were detected in the execution of a Not Atomic Compound SQL statement, and have the following identification: error1 error2 error3 error4 error5 error6 error7.

Explanation

One or more SQL substatements within a Compound SQL statement resulted in SQL errors (negative return codes).

The error tokens will not be returned for CLI/ODBC applications. CLI/ODBC applications can use SQLGetDiagRec, SQLGetDiagField, or SQLError APIs to get more information about each error.

User response

Examine the error identification information provided. There will be <n> <errorX> tokens filled in, up to a maximum of 7. Each <errorX> represents an SQL statement error. These errors are listed in the order that they were encountered. If the message text has not been formatted, this information can be found in the second and subsequent tokens of the SQLERRMC field (tokens are separated by a one byte hexadecimal value 0xFF).

Each <errorX> is of the format PPPSSSSS where:
PPP
PPP represents the position of the statement that caused the error within the Compound SQL block, and is left-justified. For example, if the first statement failed, this field would contain the number one ("1 ").
SSSSS
SQLSTATE of the statement that failed.

More information can be found by examining the SQLCA itself. The third SQLERRD field contains the number of rows affected by the compound SQL statement, the fourth SQLERRD field contains the position of the last statement that succeeded, the 5th SQLERRD field contains the number of rows affected by referential integrity when IBM Data Server Client/DB2 Server and SQL/DS databases are accessed, and the 6th SQLERRD field contains the number of statements that failed (returned negative SQLCODES).

sqlcode: -1339

sqlstate: 56091

SQL1340N The file server fileserver was not found.

Explanation

The system cannot find the specified file server on the network. Possible causes are:
  • An incorrect fileserver name was specified when the IPX/SPX node was cataloged.
  • The correct fileserver name was specified, but the file server was not available at the time the connect was tried.

User response

Make sure that the fileserver name specified when cataloging the IPX/SPX node is correct, and that the file server is available on the network.

SQL1341N A workstation name must be specified in the client database manager configuration file.

Explanation

A workstation name has not been specified in the client database manager configuration file.

User response

Specify a workstation name in the client database manager configuration file.

SQL1342N The File Server name name is missing or invalid.

Explanation

The File Server name specified in the command/API is missing or invalid.

User response

Verify that a File Server name was specified, that the name does not contain invalid characters, and is not longer than 48 characters in length. Resubmit the command/API with a valid File Server name.

SQL1343N The Object Name name is missing or invalid.

Explanation

The Object Name specified in the command/API is missing or invalid.

User response

Verify that the Object Name was specified, that the name does not contain invalid characters, and is not longer then 48 characters in length. Resubmit the command/API with a valid Object Name.

SQL1344N Orphan rows found in the system catalogs. Contact your technical service representative prior to attempting a database upgrade.

Explanation

One or more system catalogs contain orphan rows that can cause a database upgrade to fail.

User response

Contact your technical service representative. Do not attempt a database upgrade until this problem has been resolved.

SQL1345N Execution failed due to a cluster manager error that will not affect the successful execution of subsequent SQL statements.

Explanation

A cluster manager error occurred that prevented successful processing of the current environment command or SQL statement. The error occurred at execution time.

The command or statement cannot be processed. The current transaction is not rolled back and the application remains connected to the database.

User response

Record the message number. Record all error information from the SQLCA, if possible. Attempt to make the necessary corrective actions based on the cluster manager return code in the db2diag log file and resubmit the command or SQL statement.

Required information:

  • Problem description
  • SQLCODE and reason code
  • SQLCA contents, if possible
  • Trace file, if possible

sqlcode: -1345

sqlstate: 58038

SQL1348W The table space could not be reduced in size.

Explanation

The table space size could not be reduced any further because no free space exists above the table space high water mark.

User response

A reorg table or index operation may allow space below the high water mark to be freed, allowing a subsequent ALTER TABLESPACE ... REDUCE statement to reduce the size of the table space.

sqlcode: +1348

sqlstate: 0168J

SQL1350N The application is not in the correct state to process this request. Reason code=rc.

Explanation

Corresponding to rc:
01
The application is currently processing SQL and cannot process the utility command requested.
02
A Backup request is in progress. A warning was received from the initial utility call indicating that further requests are required before Backup can complete.
03
A Restore request is in progress. A warning was received from the initial utility call indicating that further requests are required before Restore can complete.
04
A Rollforward request is in progress. A warning was received from the initial utility call indicating that further requests are required before Rollforward can complete.
05
A Load request is in progress. A warning was received from the initial utility call indicating that further requests are required before Load can complete.
07
Federated system users: the application cannot process this command after executing SQL statements.

User response

Corresponding to rc:
01
Complete the unit of work (using either COMMIT or ROLLBACK) before reissuing this command.
02-05
Issue the required call(s) to complete the utility in progress, then reissue this command.
07
Federated system users: the application must issue the commands after establishing a connection to the database manager but prior to any other SQL statements.

SQL1351C No FCM channels are available.

Explanation

No FCM channels are available. FCM is unable to increase the number of channels automatically because the maximum value has been reached.

The statement cannot be processed.

User response

Try the request again after other processes have freed up some of this resource.

If the error persists, increase the number of FCM channels ( fcm_num_channels) specified in the database manager configuration file, then try the request again.

sqlcode: -1351

sqlstate: 57011

SQL1352N Trusted Connection cannot be reused during a transaction.

Explanation

An attempt to reuse a connection failed because the connection was in a transaction. The connection is now in an unconnected state.

User response

Before trying to reuse a connection make sure that you perform a commit or rollback.

SQL1353N A column option for column column-name is invalid in a transparent DDL statement. Reason code = reason-code.

Explanation

Transparent DDL statements create objects at a data source. Certain column options that can be specified for objects created at the federated server are not supported via transparent DDL statements. The specific column option specified for column column-name is indicated by the reason-code as follows:

  1. lob-options
  2. unique-constraint, referential-constraint, or check-constraint
  3. default-clause
  4. generated-column-spec (not including the default-clause)

The statement cannot be processed.

User response

Remove or replace the option that is invalid.

sqlcode: -1353

sqlstate: 428GO

SQL1354N An SQL variable in routine routine-name is not available for reference due to a recent commit or rollback operation.

Explanation

During the execution of routine routine-name an attempt was made to reference an SQL variable or SQL parameter of data type XML that cannot be referenced because a recent commit or rollback operation has caused its value to no longer be available.

Referencing variables or parameters of data type XML in SQL procedures after a commit or rollback operation occurs without first assigning new values to these variables is not supported.

User response

To prevent the error from occurring, do one or more of the following:
  • Move the commit or rollback operation to after the SQL statement that references SQL variables or SQL parameters of data type XML.
  • Remove references to SQL variables or SQL parameters of data type XML that follow commit or rollback operations.
  • Assign values to SQL variables or SQL parameters of data type XML that will be referenced in SQL statements that follow a commit or rollback operation.
  • Retry the transaction if the rollback was implicit as a result of conditions such as deadlocks or system failures.

sqlcode: -1354

sqlstate: 560CE

SQL1355N One or more values specified when retrieving alert configuration settings are invalid. Reason code: reason-code.

Explanation

One or more values specified when retrieving alert configuration settings are invalid for the reason given by reason code reason-code. The possible reason codes are as follows:
1
The specified object type is invalid.
2
The specified configuration level is invalid.
3
The request to retrieve alert configuration for a particular database failed because the database name is not specified.
4
The request to retrieve alert configuration for a particular object failed because either the database name or the object name is not specified.
5
The object specified does not match the object type.
6
An object was specified but no object level settings were requested.

User response

The action corresponding to the reason code is:
1
To retrieve alert configuration settings for the database manager, specify object type DBM, for the database, specify object type DB, for a tablespace, specify object type TS, for a tablespace container, specify object type TSC.
2
If the object type is DBM, specify configuration level D to retrieve install default settings, or specify G or O to retrieve instance level settings. If the object type is not DBM, specify configuration level D to retrieve install default settings, specify G to retrieve global level settings, or specify O for object level settings.
3
Specify the database name.
4
Ensure both the database name and the object name are specified.
5
Ensure the object specified matches the object type.
6
Specify object name only if you want to retrieve object level settings.

Resubmit the request.

sqlcode: -1355

sqlstate: 560CD

SQL1356N The data partition cannot be detached from the table tablename.

Explanation

The ALTER TABLE ... DETACH PARTITION statement cannot be processed. The data partition has been attached within the same unit of work (UOW) and so the table has a pending modification to be made.

User response

Either COMMIT or ROLLBACK the pending ATTACH transaction before detaching the partition.

SQL1357N The specified data type is invalid as the local data type for a data type mapping from a data source. Reason code = reason-code. Altering the local type to the specified data type is not allowed.

Explanation

The data type you specified is an invalid type mapping or an unsupported data type.

User response

The reason-code indicates which action to take.
  1. The local data type specified is not compatible with the data type being mapped to from the data source. Specify a data type that is compatible with the one at the data source.
  2. The specified data type is not a built-in data type. Specify an appropriate built-in data type.
  3. The wrapper does not support the data type mapping. Specify a data type supported by the wrapper.

sqlcode: -1357

sqlstate: 42815

SQL1358N A duplicate cursor cannot be opened.

Explanation

More than 65533 instances of this cursor have been opened since the first instance was opened at this nesting level.

User response

Close all instances of this cursor at this nesting level.

sqlcode: -1358

sqlstate: 54064

SQL1359N Processing of a trusted context switch user request was cancelled due to an interrupt.

Explanation

An interrupt request was received during switch user processing. The switch user request did not complete and the connection has been placed in the unconnected state.

User response

Continue the application. The connection must first be placed back into the connected state by issuing a valid switch user request or by terminating this connection and establishing a new one.

sqlcode: -1359

sqlstate: 51018

SQL1360N Current processing cannot be interrupted.

Explanation

The user attempted to interrupt a process which is not interruptible.

User response

Do not interrupt the current process.

SQL1361W Execution time has exceeded timeout value. Do you wish to interrupt it?

Explanation

If a command takes longer than a pre-defined timeout period, a dialog box pops up asking if the (Windows client) user wants to interrupt it or not.

Note that this message is applicable in Windows environments only, and will only be seen in a dialog pop up box.

User response

There are three choices: YES - interrupt now; NO - continue, don't prompt me; CANCEL - continue, same timeout.

SQL1362W One or more of the parameters submitted for immediate modification were not changed dynamically. Client changes will not be effective until the next time the application is started or the TERMINATE command has been issued. Server changes will not be effective until the next DB2START command.

Explanation

Some changes to the database manager configuration could not be applied immediately. For these parameters, the changes become effective only after the database manager is started. This typically occurs after a DB2START on a server and after the application restarts on a client.

User response

To see which parameter changes took effect dynamically and which ones did not, retrieve the database manager configuration parameters and display the parameter details using the following command:
DB2 GET DBM CFG SHOW DETAIL

Changes to database manager configuration parameters can only take effect dynamically if you are attached to the instance. Not all configuration parameters support dynamic update. To see which parameters can be changed dynamically, refer to the Administration Guide.

If several parameters were submitted in a group, submit the parameters individually. In those cases where a configuration parameter could not change dynamically, do one or more of the following:
  • for user applications: stop and start the application
  • for CLP: TERMINATE and reconnect
  • for a server: issue DB2STOP and DB2START

SQL1363W One or more of the parameters submitted for immediate modification were not changed dynamically. For these configuration parameters, the database must be shutdown and reactivated before the configuration parameter changes become effective.

Explanation

The database configuration command has been successfully processed. However, not all changes were processed right away.

Changes to database configuration parameters can only take effect dynamically if you are connected to the database. Not all configuration parameters support dynamic update, meaning that they will not take effect until the database is deactivated and reactivated.

User response

To see which parameter changes took effect dynamically and which ones did not, retrieve the database configuration parameters and display the parameter details using the following command:

DB2 GET DB CFG FOR  <database-alias> SHOW DETAIL

If the parameters were submitted in a group, resubmit the parameter updates individually.

For the configuration parameters that do not support dynamic updates, do one or more of the following:

  • Deactivate the database by using the DEACTIVATE DATABASE command, then reactivate it by using the ACTIVATE DATABASE command.
  • Rebind your packages after the new configuration parameters take effect so that the new values will be used during the bind.
  • Use the FLUSH PACKAGE CACHE command to invalidate dynamic statements in the SQL cache.

SQL1364W One or more of the parameters were set to AUTOMATIC in a case where the parameter does not support AUTOMATIC.

Explanation

One or more of the configuration parameters were set to AUTOMATIC in a case where the parameter does not support AUTOMATIC.

User response

If the parameter changes were submitted as a group, resubmit the changes individually to see which parameter changes were successful.

If only one parameter was submitted then this message indicates that the value AUTOMATIC is not supported for this parameter.

To find out which configuration parameters support the AUTOMATIC value, refer to the Administration Guide.

SQL1365N db2start or db2stop failed in processing the plugin plugin-name. Reason code = reason-code.

Explanation

Processing failed for the server side security plug-in plugin-name. The explanation corresponding to the reason-code is:

1

Security plug-in not found.

2

Unable to load the security plug-in.

3

More than one Kerberos security plug-in is specified in the SRVCON_GSSPLUGIN_LIST database manager configuration parameter.

4

No Kerberos based security plug-in is found and Kerberos is specified in the SRVCON_AUTH or AUTHENTICATION database manager configuration parameter.

5

Required API is missing in the security plug-in.

6

Wrong security plug-in type.

7

Error encountered during unloading of the security plug-in.

8

Invalid security plug-in name.

9

The version of the APIs reported by the security plug-in is not compatible with DB2.

10

Security plug-in encountered an unexpected error on the database server

11

The SRVCON_GSSPLUGIN_LIST database manager configuration parameter is not set and GSSPLUGIN or GSS_SERVER_ENCRYPT is specified in the SRVCON_AUTH or AUTHENTICATION database manager configuration parameter.

12

The communication exit library name in the database manager configuration parameter COMM_EXIT_LIST is invalid.

13

The communication exit library can not be found.

14

The communication exit library can not be loaded.

15

The communication exit library is missing a required API.

16

The communication exit library encountered an error when loading.

17

The version of the APIs reported by the communication exit library is not compatible with DB2.

User response

The user response corresponding to the reason-code is:

1

Ensure that the indicated security plug-in is located in the server-plug-in directory.

2

Check the administration notification log file for the cause of the failure. Fix the problem identified by the error message text in the administration notification log.

3

Ensure that only one Kerberos security plug-in is specified in the SRVCON_GSSPLUGIN_LIST database manager configuration parameter.

4

Specify one Kerberos security plug-in in the SRVCON_GSSPLUGIN_LIST database manager configuration parameter or do not specify Kerberos in the SRVCON_AUTH or AUTHENTICATION database manager configuration parameter.

5

Check the administration notification log file for the missing required API name. Add the missing API to the security plug-in.

6

Specify the right type of security plug-in in the appropriate database manager configuration parameter. For example, do not specify a userid-password based security plug-in for the SRVCON_GSSPLUGIN_LIST database manager configuration parameter.

7

Check the administration notification log file for the cause of the failure. Fix the problem identified by the error message text in the administration notification log.

8

Specify a valid security plug-in name. The name should not contain any directory path information.

9

Ensure that the security plug-in is using a supported version of the APIs and that it is reporting a correct version number.

10

Check the administration notification log file on the client and on the server for more information. Fix the problem identified by the error message text in the administration notification log.

11

Specify at least one GSS-API based security plug-in for the SRVCON_GSSPLUGIN_LIST database manager configuration parameter or specify a different authentication type for the SRVCON_AUTH or AUTHENTICATION database manager configuration parameter.

12

Use a library name that is compatible with the communication exit library naming rules.

13

Ensure the indicated communication exit library is located in the standard communication buffer exit library location.

14

Check the db2diag.log for messages indicating the reason that the communication exit library can not be loaded.

15

Check the db2diag.log for the missing API name. Add the missing API to the communication exit library.

16

Check the db2diag.log for any messages returned from the communication exit library. The message indicates the communication buffer exit library encountered an error, not DB2.

17

Use a version of the communication exit library that is compatible with this version of DB2.

SQL1366N A security plug-in plugin-name processing error occurred on the client. Reason code = reason-code.

Explanation

The client side security plug-in returned an error. The explanation corresponding to the reason-code is:
  1. Required API is missing in the security plug-in.
  2. Wrong security plug-in type.
  3. Unable to load the client security plug-in.
  4. Unable to unload the security plug-in.
  5. Invalid plug-in name.
  6. The version of the APIs reported by the security plug-in is not compatible with DB2.
  7. Security plug-in encountered an unexpected error.
  8. Invalid client credential.
  9. Security plug-in received an expired credential.

User response

The user response corresponding to the reason-code is:
  1. Check the administration notification log file for the name of the required missing API. Add the missing API to the security plug-in.
  2. Specify the right type of security plug-in in the appropriate database manager configuration parameter. For example, do not specify a userid-password based security plug-in for the SRVCON_GSSPLUGIN_LIST database manager configuration parameter.
  3. Check the administration notification log file for the cause of the failure. Fix the problem identified by the error message text in the administration notification log.
  4. Check the administration notification log file for the cause of the failure. Fix the problem identified by the error message text in the administration notification log.
  5. Specify a valid security plug-in name. The name should not contain any directory path information.
  6. Ensure that the security plug-in is using a supported version of the APIs and that it is reporting a correct version number.
  7. Check the administration notification log file on the client and on the server for more information. Fix the problem identified by the error message text in the administration notification log.
  8. Verify that the client credential (generated by db2secGenerateInitialCred or provided as an inbound delegated credential) is in a format recognized by the security plug-in. As the credential will be used to initate contexts, it must be an INITIATE or BOTH credential.
  9. The user issuing the statement must obtain the appropriate credentials (or re-obtain their initial credentials) and then resubmit the statement.

SQL1367N Insufficient operating system configuration for resource policy support.

Explanation

Resource policy does not support the current operating system configuration.

User response

Install the appropriate operating system level or disable the DB2_RESOURCE_POLICY registry variable.

SQL1368N Invalid resource policy configuration.

Explanation

The resource policy file is invalid.

User response

Correct the policy definition specified by the file defined by the DB2_RESOURCE_POLICY registry variable.

Disable resource policy support by clearing the DB2_RESOURCE_POLICY registry variable or set DB2_RESOURCE_POLICY to AUTOMATIC for automatic configuration.

SQL1369N Invalid XML document.

Explanation

The current XML document is invalid.

User response

Validate the XML document before proceeding.

SQL1370N An attempt to quiesce instance or database name1 failed because instance or database name2 is already quiesced by user username. Quiesce type: type.

Explanation

An attempt was made to quiesce an instance or database which would have caused an overlapping quiesce, such as quiescing an instance while a database is already quiesced by another user.

Quiesce type type refers to the instance or database already quiesced and is a '1' for an instance and a '2' for a database.

User response

Contact the user who currently has the instance or database quiesced to determine when the instance or database will no longer be quiesced, and retry the request at that time.

SQL1371W The quiesce operation was not executed because the specified instance or database named name is already quiesced.

Explanation

Before performing maintenance activities, you can force users off of a database manager instance or database by quiescing the instance or database.

This message is returned when an attempt is made to quiesce an instance or database which is already quiesced.

User response

No action is required.

SQL1372N Cannot perform a quiesce while in a transaction.

Explanation

An attempt was made to quiesce a database or instance while the user issuing the quiesce has uncompleted units of work. Quiesce cannot be issued while in this state.

User response

Complete the unit of work (COMMIT or ROLLBACK) and retry the request.

SQL1373W Cannot unquiesce instance or database name, because it is not quiesced.

Explanation

Unquiesce failed because the instance or database is not quiesced.

User response

Ensure that the unquiesce is being issued for the correct instance or database.

SQL1374N Cannot QUIESCE RESET instance or database name, because it has been quiesced by another user username.

Explanation

The instance or database is quiesced, but you are not the quiescer.

User response

Ensure that the quiesce reset is being issued for the correct instance or database.

SQL1375N An invalid parameter was passed to the api. Parameter parm-code is in error.

Explanation

parm-code indicates the parameter in error:
1
scope
2
options

The value may be out of range or invalid.

User response

Check the syntax of the api, correct the parameter and try again.

SQL1376N Creating or invoking a sourced procedure using a wrapper defined as fenced is not supported.

Explanation

The sourced procedure cannot be created or invoked using a wrapper defined as fenced.

User response

Submit the statement using a wrapper defined as unfenced.

sqlcode: -1376

sqlstate: 55069

SQL1377N Creating or altering the sourced procedure is not supported at this data source.

Explanation

The sourced procedure cannot be created or altered at this data source.

User response

Submit the statement at a supported data source.

sqlcode: -1377

sqlstate: 560CL

SQL1379W Database partition group partition_group has been partially redistributed. The number of tables redistributed is number, and the number of tables yet to be redistributed is number. Reason code = reason-code.

Explanation

This redistribute operation completed successfully, however the database partition group is only partially redistributed. As a result, redistributed tables in the database partition group could use a different partitioning map than tables that have not been redistributed. Also, if collocation between redistributed and non-redistributed tables existed before the redistribute operation, the collocation property between these tables is temporarily disabled. Query performance may not be optimal.

Reason codes:

1

The redistribute request specified a table list, which did not include all the tables in the specified database partition group. As a result, other tables in the database partition group, which were not listed in the request, are not redistributed.

2

The STOP AT parameter was specified with the redistribute request, and the value was reached before the redistribute operation completed.

User response

Issue another redistribute request specifying the CONTINUE parameter to apply the new distribution to another specified set of tables or to the rest of the database partition group, or specify the ABORT parameter to undo the redistribution operation and return to the old distribution system.

SQL1380N An unexpected Kerberos security error has occurred.

Explanation

An unexpected Kerberos security error occurred during authentication.

User response

No action required.

SQL1381N The Security Support Provider Interface is not available.

Explanation

Authentication failed because the Security Support Provider Interface (SSPI) was not available.

User response

When running under Windows operating system, ensure that the file security.dll exists under the system directory. Also ensure that SSPI is supported for the operating system that is being used.

SQL1382N Kerberos support is not available.

Explanation

Authentication failed because Kerberos support is not installed.

User response

Ensure that Kerberos support is installed and operational, then retry the connection.

SQL1383N The target principal name is not valid.

Explanation

The target principal name that was specified in the CATALOG DATABASE command is not valid.

User response

Remove the database entry that has the invalid target principal name by using the UNCATALOG DATABASE command. Re-catalog the database entry with a valid target principal name using the CATALOG DATABASE command and retry the connection.

When running in a Windows operating system environment, the target principal name is the logon account name of the DB2 service in the format of <domain name>\<user ID>.

SQL1384N Unable to complete mutual authentication.

Explanation

The connection failed because either the client or server was unable to complete mutual authentication.

User response

If the target principal name was specified in the CATALOG DATABASE command, ensure that the target principal name is valid for the server to which the client is attempting to connect or attach.

When running in a Windows operating system environment, the target principal name is the logon account name of the DB2 service in the format of <domain name>\<user ID>.

If the target principal name appears to be invalid, then contact IBM service for assistance.

SQL1385N The parameter parameter has been specified improperly for the redistribute operation. Reason code = reason-code.

Explanation

The parameter named in the error message is invalid, incorrectly specified, or is incompatible with one of the other redistribute options specified.

Reason codes:

1

An invalid redistribution option was specified. The distribution option can be one of "U" (Uniform), "T" (Target map), "C" (Continue), or "A" (Abort).

2

The maximum number of partition numbers in a partition list must be less than or equal to the maximum number of partitions allowable in a cluster.

3

Invalid STOP AT parameter value. The STOP AT value must be ISO format, with a length of 26. The format must be "yyyy.mm.dd.hh-mm-ss-nnnnnn".

7

Invalid STATISTICS parameter value. The value must be either DB2REDIST_STAT_USE_PROFILE ('P') or DB2REDIST_STAT_NONE ('N').

8

The length of a table name is out of range. The maximum length of the name of each table is (SQL_MAX_IDENT + SQL_MAX_IDENT +2).

9

Invalid table option parameter. The table option value must be either DB2REDIST_TABLES_FIRST ('F') or DB2REDIST_TABLES_ONLY ('O').

10

Missing information from input parameter struct. Input struct db2RedistStruct can not be NULL. Also its field struct db2RedistIn can not be NULL.

11

Undefined database partition group name, or bad struct db2Char to database partition group name. Database partition group name must be provided. Struct db2Char which stores the database partition group name must have valid data. Check struct db2Char to database partition group name. When pioData is NULL, iLength has to be zero and vice versa.

12

The structure db2Char that is storing data distribution file name is not valid.

13

The structure db2Char that is storing target partition map file name is not valid.

14

The redistribute option 'T'(target map) was specified, but no target map file is specified.

15

When the redistribute option is 'T'(Target map) or 'A' (Abort), a data distribution file should not be specified.

16

When the redistribute option is 'U'(Uniform), 'C'(Continue) or 'A' (Abort), the target map file should not bespecified.

17

When the redistribute option is 'T'(Target map), 'C'(Continue) or 'A' (Abort), the add partition list, drop partition list should be empty, and the add count and the drop count should be zero.

18

Redistribute options may not be specified more than once.

19

Wrong version number is passed into the API.

20

A typed table specified in the TABLE list is not the root table of the whole hierarchy.

21

Invalid DATA BUFFER parameter value. The value must be greater than 0, and less than the size of util_heap_sz db cfg parameter.

User response

Check the corresponding parameter based on the reason code, ensure that a valid parameter is specified, then call the utility again.

SQL1387W A DB2 High Availability Disaster Recovery (HADR) takeover completed successfully. However, a HADR resource group remains locked; and the cluster manager is not controlling that resource group.

Explanation

A HADR takeover completed successfully, and the cluster manager should now take over responsibility for managing the resource groups on the affected cluster nodes again.

However, the database manager failed to return control of a resource group to the cluster manager. As a result, the cluster manager is not currently controlling that resource group.

If the cluster manager is not controlling this resource group, the cluster manager will not respond to any failures related to that resource group.

Error messages from the cluster manager will be recorded in the db2diag log file.

User response

Manually unlock the resource group so the cluster manager can control the resource group:

  1. Review the db2diag log file for diagnostic information detailing why the database manager failed to unlock the resource group and return control of the resource group to the cluster manager.
  2. Use the cluster manager's tools and utilities to unlock, enable, or monitor the affected resource group.

SQL1388W An error occurred while trying to access a resource or part of a resource requested. Partial information was still returned. Details are available in the administration notification log with message message-number.

Explanation

An error occurred when trying to access one or more sources of information requested. The information which could be collected is valid and was returned but some records may be missing.

User response

The query results are not complete. Refer to the related entries in the administration notification log for more information then correct and resubmit the command. If the problem persists, contact IBM support.

SQL1389N Table designator table-designator is not valid for the expression.

Explanation

The table designator is not defined to be a table designator in this SQL statement or the table designator cannot be referenced where it is specified in the SQL statement.

The statement cannot be executed.

User response

Correct the syntax and resubmit the statement. Refer to DB2 SQL Reference for rules for table designator of ROW CHANGE TIMESTAMP expression and ROW CHANGE TOKEN expression, or RID and RID_BIT built-in functions.

sqlcode: -1389

sqlstate: 42703

SQL1390C The environment variable DB2INSTANCE is not defined or is invalid.

Explanation

The environment variable DB2INSTANCE is not defined or is not set to a valid instance owner.

User response

Set the DB2INSTANCE environment variable to the name of the instance to use. If you do not know the name of the instance to use or how to set the DB2INSTANCE environment variable to the instance name, refer to the Administration Guide.

Federated system users: refer to the Federated Systems Guide for DB2INSTANCE information.

Ensure your PATH environment variable contains the sqllib/adm path in the home directory of the instance you want to use (for example, /u/instance/sqllib/adm, where /u/instance is the home directory of the instance owner on a UNIX system).

SQL1391N The database is already in use by another instance of the database manager.

Explanation

The request failed because the database is in use by another instance of the database manager (a database may only be used by one instance.) This may be caused by attempting to access a database located on a mounted file system accessible to another instance located on another machine.

This can also occur if you have an open connection (via SNA) to a database and the database manager was brought down abnormally.

User response

  • Validate that you are using the correct database and ensure no other instance uses this database.
  • If the database manager was brought down abnormally, and you have a command line processor connection to it, perform a db2 terminate to close the offending open connection before attempting to connect again.

sqlcode: -1391

sqlstate: 51023

SQL1392N Multiple instances of applications using prep,-bind,-import,-export is not supported.

Explanation

Only 1 instance of prep, bind, import, or export can be running at any one time within WINDOWS.

User response

Within WINDOWS, do not attempt to start more than 1 application that uses prep, bind, import, or export.

SQL1393C The environment variable DB2PATH is not defined or is invalid.

Explanation

The environment variable DB2PATH is not defined or is not set to a valid directory path.

User response

Set the DB2PATH environment variable to the directory where the database manager is installed.

SQL1394N The instance is not defined.

Explanation

The new instance can not be set for the application because the instance is not defined.

This message can be returned when the current user does not have the required authority to execute in the current instance environment.

User response

Ensure that the specified instance exists and that the current user has sufficient authority to execute programs in the current instance environment. Use the db2ilist command to display the list of instances:

   db2ilist

SQL1395N Unable to switch to another instance because the application is using multiple contexts.

Explanation

The request to switch to another instance failed because the application is using multiple contexts.

User response

Ensure that the application is not using multiple contexts before switching to another instance.

SQL1396N Unable to switch to another instance because the application is connected to a database or attached to an instance.

Explanation

Request to switch to another instance failed because the application is connected to a database or attached to an instance.

User response

Ensure that the application is not connected to any database or attached to any instance before switching to another instance.

SQL1397N The DB2 service failed to logon.

Explanation

DB2 service did not start due to a logon failure.

User response

If you are starting the DB2 Administration Server, then use the DB2ADMIN SETID command to set a new logon account. If you are starting a database server on Windows, you can set the logon account for a DB2 service by using the Services dialog box from the Control Panel.

SQL1398N The routine routine-name is not supported in a partitioned database environment.

Explanation

The routine routine-name is not supported in a partitioned database environment. The return data type of the RID function does not uniquely identify a row across database partitions. The RID function is supported in a non-partitioned database environment for compatibility with DB2 for z/OS.

User response

Only use the routine in a non-partitioned database environment. Instead of using the RID function, use the RID_BIT function.

sqlcode: -1398

sqlstate: 56038

SQL1399N Operation operation-name is not valid for option option-name1 because of option option-name2 for object object-name. Reason code= reason-code.

Explanation

Two wrapper or server options have dependency on each other. Whether an option can be dropped or added depends on the existence of another option. Please view section Changes Related to DDL Statements for the examples of how this sqlcode is used.

The reason codes are:
01
Option option-name1 cannot be added because option option-name2 for object object-name does not exist.
02
Option option-name1 cannot be dropped because option option-name2 for object object-name exists.

User response

Two wrapper or server options have dependency on each other. Whether an option can be dropped or added depends on the existence of another option.

The reason codes are:
01
Add option option-name2 for object object-name. Then add option option-name1.
02
Drop opotion option-name2 for object object-name. Then drop option option-name1.

SQL1400N Authentication is not supported.

Explanation

The authentication type supplied is not one of the supported types.

The command can not be processed.

User response

The user should reissue the command with a valid parameter value.

SQL1401N Authentication types do not match.

Explanation

The user is attempting to connect to a remote database which is cataloged on the local node with a different authentication type from the remote node.

Federated system users: this message can also appear when:
  • A data source is identified in SYSCAT.SERVEROPTIONS with SETTING='N' for OPTION ='PASSWORD' and the data source is not running in trusted client mode (that is, the data source expects a password)
  • The data source is identified in SYSCAT.SERVEROPTIONS with SETTING='Y' for OPTION ='PASSWORD' and the data source is running in trusted client mode (that is, the data source does not expect a password)
  • There is no server option specified for OPTION='PASSWORD' in SYSCAT.SERVEROPTIONS and the system default value for PASSWORD violates the data source password requirement.

User response

The command can not be processed.

The user should recatalog the database alias on the client node with the same authentication type as the remote database. Resubmit the command.

Federated system users:
  • If the problem is that the data source requires a password but SYSCAT.SERVEROPTIONS contains SETTING='N' for OPTION='PASSWORD' for that server, alter SYSCAT.SERVEROPTIONS to reflect the true data source password requirement using the ALTER SERVER SQL statement.
  • If the problem is that the data source does not require a password but SYSCAT.SERVEROPTIONS contains SETTING='Y' for OPTION='PASSWORD' for that server, alter SYSCAT.SERVEROPTIONS to reflect the true data source password requirement using the ALTER SERVER SQL statement.
  • If the server option for OPTION='PASSWORD' is not set in SYSCAT.SERVEROPTIONS, create an entry using the CREATE SERVER SQL statement to reflect the truedata source password requirement.

sqlcode: -1401

sqlstate: 08001

SQL1402N Unable to authenticate user due to unexpected system error.

Explanation

Call your system administrator. On unix-based systems, the file db2ckpw may not have the correct permission bits set, or the system may have run out of swap/paging space. On Windows, the DB2 security service may not have been started or the account may be locked.

The command can not be processed.

Federated system users: this situation can also be detected by the data source.

User response

On unix-based systems, have the system administrator ensure the correct access permissions are set for db2ckpw, and that there is enough swap/paging space allocated. On Windows, ensure that the account is not locked.

SQL1403N The username and/or password supplied is incorrect.

Explanation

The username and/or password supplied is incorrect or not a valid username/password combination or the database to which you are attempting to connect to has an authentication type of SERVER and no username and password was supplied on the CONNECT TO statement.

If DB2 Connect is being used, the problem may be that the DCS directory entry for the host connection could not be found.

The command can not be processed.

Federated system users: this situation can also be detected by the data source.

User response

Supply the correct username and password combination.

Federated system users: ensure that the entry in SYSCAT.USEROPTIONS contains the correct username and password for the data source being accessed.

sqlcode: -1403

sqlstate: 08004

SQL1404N Password expired.

Explanation

Your password has expired.

User response

Change your password, then retry the request using the new password. You can use the Command Line Processor to issue the CONNECT statement or the ATTACH command to change your password.

sqlcode: -1404

sqlstate: 08004

SQL1405N Unable to communicate with local DB2 authentication server.

Explanation

The application failed to authenticate due to an error while communicating to the local DB2 authentication server.

User response

Ensure that the DB2 authentication server is started.

SQL1406N Shared sort memory cannot be allocated for this utility.

Explanation

Shared sort memory is not available and is required for this operation.

User response

Do any of the following:
  • Configure the value of the SHEAPTHRES_SHR configuration parameter to allow for sorts to occur in shared memory.
  • Enable intra-partition parallelism by setting the INTRA_PARALLEL configuration parameter to "YES".
  • Activate the connection concentrator.

SQL1407N The option-name option is incompatible with feature.

Explanation

The utility does not support the option_name option with feature.

User response

Resubmit the command using compatible options.

SQL1408N The audit policy audit-policy is already in use for the object object-name of type object-type.

Explanation

An AUDIT USING statement for object object-name of type object-type attempted to associate the audit policy for the specified object, but an audit policy audit-policy is already in use. Only one audit policy can be associated to a particular object. The statement could not be processed.

User response

Use the REPLACE option of the AUDIT statement to replace the existing audit policy with the desired audit policy.

sqlcode: -1408

sqlstate: 5U041

SQL1409N An audit policy is not associated with the object object-name of type object-type.

Explanation

An AUDIT statement specifying the REMOVE option attempted to remove an association with the object object-name of type object-type, but an association does not exist The statement could not be processed.

User response

Verify the correct object and type was used. If that is correct, then nothing needs to be done as the association does not exist.

sqlcode: -1409

sqlstate: 5U042

SQL1410N The SQL statement cannot be issued within an XA transaction.

Explanation

One of the following statements has been issued, but it cannot be issued within an XA transaction.
  • CREATE, ALTER, or DROP WORKLOAD
  • GRANT or REVOKE USAGE ON WORKLOAD
  • CREATE, ALTER, or DROP SERVICE CLASS
  • CREATE, ALTER, or DROP WORK CLASS SET
  • CREATE, ALTER, or DROP WORK ACTION SET
  • CREATE, ALTER, or DROP THRESHOLD
  • CREATE, ALTER, or DROP TRUSTED CONTEXT
  • CREATE, ALTER, or DROP AUDIT POLICY

User response

Reissue the statement from a non-XA connection or wait until the current XA transaction is complete before reissuing the statement.

sqlcode: -1410

sqlstate: 51041

SQL1411N The specified clause, clause, is not supported for service superclasses.

Explanation

The clause, clause, that is specified is valid for a service subclass but is not valid for a service superclass. When creating or altering a service subclass use the UNDER clause.

User response

Remove the unsupported clause, or specify the UNDER clause to create or alter a service subclass.

sqlcode: -1411

sqlstate: 5U043

SQL1412N The table named table-name could not be processed. Reason: reason-code.

Explanation

The possible reason codes are as folows:

31

The table contains data of type XML created on a database server Version 9.5 or earlier. The redistribute utility cannot process tables that have XML columns containing data of type XML created on a database server prior to Version 9.7.

User response

Take the action that corresponds to the reason-code.

31

Use the procedure SYSPROC.ADMIN_MOVE_TABLE to recreate the table. The new version of the table can be distributed.

You can verify that no other table in the database partition group has XML columns that were created prior to database server Version 9.7 by performing the following steps:

  1. Use the ADMIN_GET_TAB_INFO table function or review the administrative view SYSIBMADM.ADMINTABINFO to retrieve the XML_RECORD_TYPE information for the table.
  2. If the value of the returned column XML_RECORD_TYPE is 2 or greater, then the redistribute utility can process the table.
  3. If the value of XML_RECORD_TYPE is 1, then the redistribute utility cannot process the table. Use the procedure SYSPROC.ADMIN_MOVE_TABLE to recreate the table.

sqlcode: -1412

sqlstate: 55019

SQL1413N Invalid specification of a row change timestamp column for table table-name.

Explanation

The specification of a row change timestamp column is invalid. A row change timestamp column cannot be:

  • A column of a foreign key.
  • A column of a functional dependency DEPENDS ON clause.
  • A column of a database partitioning key.
  • Defined for a temporary table.

The statement cannot be executed.

User response

Correct the syntax and resubmit the statement.

sqlcode: -1413

sqlstate: 429BV

SQL1414N Table designator table-designator is not valid for the expression.

Explanation

The table designator is not defined to be a table designator in this SQL statement or the table designator cannot be referenced where it is specified in the SQL statement. The statement cannot be executed.

User response

Correct the syntax and resubmit the statement. Refer to the SQL Reference for rules for table designator of ROW CHANGE TIMESTAMP expression and ROW CHANGE TOKEN expression.

sqlcode: -1414

sqlstate: 42703

SQL1415N The statement was compiled for diagnostic purposes only and has not been executed.

Explanation

The statement was processed through parts of the system to collect diagnostic information using service features. The necessary steps to allow further processing of the statement have not been completed.

User response

This error is returned to prevent further processing by the system of statements prepared using service features and is expected.

SQL1416N Wrapper library wrapper-library-name is not compatible with the release of database product installed at the federated server. The wrapper library is compatible with the following DB2 releases list-of-DB2-releases.

Explanation

The wrapper library is not compatible with the release and fix pack level of database product installed at the federated server. The wrapper library is compatible with the releases of DB2 listed in list-of-DB2-releases. The most common cause of this error is one of the following:

  • You installed a DB2 fix pack, but did not install the corresponding InfoSphere Federation Server fix pack.
  • During the installation of a InfoSphere Federation Server fix pack, the script to link the fenced wrapper library did not run or did not complete successfully.
  • You installed a patch for InfoSphere Federation Server that requires running a script to link the fenced wrapper library. The script did not run or did not complete successfully.
  • You put incompatible product libraries in the database product install directory.

User response

To determine the release and fix pack level of DB2, issue the db2level command. If necessary, install the InfoSphere Federation Server fix pack that is equivalent to the current DB2 release and fix pack level. if the wrapper requires running a script to link the fenced wrapper library, then run the linking script. Wrappers that require this are the following:

Data Source Default Wrapper Name Linking Script
Informix INFORMIX djxlinkInformix
Microsoft SQL Server DJXMSSQL3 djxlinkMssql
Oracle NET8 djxlinkOracle
Sybase CTLIB djxlinkSybase
Teradata TERADATA djxlinkTeradata

For more information on the linking scripts, consult the InfoSphere Federation Server Installation Guide.

sqlcode: -1416

sqlstate: 560CN

SQL1417W Wrapper wrapper-name supports data source server versions list-of-data-source-versions. Using the wrapper with later versions might result in errors or unexpected results.

Explanation

IBM tested the wrapper with only the data source server versions in the list list-of-data-source-versions. If you use the wrapper to access the version of the data source server that you specified on the CREATE SERVER or ALTER SERVER statement, then you might get errors or unexpected results.

User response

Contact the data source vendor to determine if the version of the data source server that you are using is compatible with applications written for earlier versions. if the version of the data source server that you are using is compatible, the wrapper should function correctly. However, IBM did not test the wrapper with the version of the data source server that you are using. If the version of the data source server that you are using is not compatible and you continue to use the wrapper to access that version of the data source server, then errors or unexpected results will probably occur.

sqlcode: +1417

sqlstate: 0168Q

SQL1418W Changing the database configuration parameter DECFLT_ROUNDING may have unintended consequences. The value was not changed dynamically. All applications must disconnect from this database before the changes become effective.

Explanation

Changing the database configuration parameter (DB config parameter) DECFLT_ROUNDING may have several unintended consequences. Any calculation using the DECFLOAT data type could produce a different result with the new rounding mode.

The following is a list of some of the most significant consequences:

  • Previously constructed MQTs could contain results that differ from what would be produced with the new rounding mode.
  • A trigger whose execution is potentially dependent on rounding mode could produce different results now, based on the new rounding mode. However, even if the results of a trigger can be affected by the rounding mode, changing it will have no effect on data that was already written.
  • It is possible for constraints that allowed data to be inserted into a table, will now, if re-evaluated, reject that same data. Similarly it is possible for constraints that did not allow data to be inserted into a table, would now, with the new rounding mode, accept that same data.
  • The value of a generated column whose calculation is dependent on DECFLT_ROUNDING could be different for two rows identical except for the generated column value, if one row was inserted before the change to DECFLT_ROUNDING and the other was inserted after.
    • Note: rounding mode is not compiled into packages, so static SQL does not need to be recompiled after changing DECFLT_ROUNDING.

The value of the configuration parameter was not changed dynamically but will only become effective after all applications disconnect from this database. If the database was activated, it must be deactivated.

User response

To rectify the MQT issue, refresh any MQTs potentially impacted by rounding mode. Evaluate and correct any issues related to triggers affected by rounding mode manually.

To rectify the presence of data in a table which now violate a constraint based on the new rounding mode, use SET INTEGRITY to check for rows that violate the constraint based on the new rounding mode. To rectify the generated column issue, use SET INTEGRITY with the FORCE GENERATED option on tables with generated columns which could be affected.

Alternatively, change the rounding mode database configuration parameter (DB config parameter) DECFLT_ROUNDING back to its prior value to avoid all of the potential consequences indicated in this message.

To have the new value for the configuration parameter come into effect, disconnect all applications from this database. If the database was activated, it must be deactivated.

sqlcode: +1418

sqlstate: 0168M

SQL1419N The statement, clause, command, API, or function is not supported in a DB2 pureScale environment. Reason code = reason-code.

Explanation

The reason code indicates why the operation failed:

1

Only automatic storage table spaces are supported in a DB2 pureScale environment.

The CREATE TABLESPACE or CREATE DATABASE statement failed because the table space was not specified as MANAGED BY AUTOMATIC STORAGE.

2

Enabling automatic storage is not supported in a DB2 pureScale environment.

Because no type of storage other than automatic storage is supported in a DB2 pureScale environment, the statement for altering a table space that uses any other type of storage to use automatic can return this reason code.

3

Dropping storage paths that are used for automatic storage table spaces is not supported in a DB2 pureScale environment.

As a result, the DROP STORAGE clause is not supported with the ALTER DATABASE statement in a DB2 pureScale environment.

4

Creating a database partition group on any database partition other than database partition number 0 is not supported in a DB2 pureScale environment.

As a result, the following clauses are not supported in the CREATE DATABASE PARTITION GROUP statement in DB2 pureScale environments:

  • ON DBPARTITIONNUMS
  • ON DBPARTITIONNUM, specifying a database partition other than 0
5

Altering database partition groups is not supported in a DB2 pureScale environment.

As a result, the ALTER DATABASE PARTITION GROUP statement is not supported.

6

The CREATE TABLE statement failed because the specified table type is not supported in the current environment.

The following types of tables are not supported in a DB2 pureScale environment:

  • Multidimensional clustering (MDC) tables
  • Insert time clustering (ITC) tables
  • Range-clustered tables (RCT)
7

Online index reorganization operations are not supported in a DB2 pureScale environment.

9

Creating or dropping a database on a specified database partition is not supported.

As a result, the following actions are not supported in DB2 pureScale environments:

  • Specifying the AT DBPARTITIONNUM clause in a CREATE DATABASE or DROP DATABASE command
  • Calling the sqlecran API or the sqledrpn API
11

Altering database containers is not supported in a DB2 pureScale environment.

As a result, the following clauses are not supported with the ALTER TABLESPACE statement in a DB2 pureScale environment:

  • ADD <database-container-clause>
  • BEGIN NEW STRIPE SET <database-container-clause>
  • DROP <database-container-clause>
  • REBALANCE
  • RESIZE <database-container-clause>
  • USING STOGROUP
13

The db2ReadLogNoConn API is not supported.

14

Adding database partitions using the START DATABASE MANAGER command with the ADD DBPARTITIONNUM clause is not supported in a DB2 pureScale environment. Dropping database partitions using the STOP DATABASE MANAGER command with the DROP DBPARTITIONNUM clause is not supported in a DB2 pureScale environment.

16

The PRUNE LOGFILE command is not supported.

17

The following configuration parameter is not supported in a DB2 pureScale environment:

  • HEALTH_MON - Health monitoring
18

The specified create buffer pool or alter buffer pool operation is not supported.

19

In a DB2 pureScale environment, if the ROLLFORWARD and RECOVER commands are issued with the ON DBPARTITIONNUMS clause or with the ON DBPARTITIONNUM clause (either as part of the database partition list clause or the log overflow clause), the database partition specified must be 0.

20

Unable to add a CF or additional members to this host. The maximum cumulative number of CFs and members on this host has already been reached.

23

A restore operation with the REBUILD option is not supported in a DB2 pureScale environment.

24

A point-in-time recovery operation (rollforward or recover with the TO <isotime> option, or rollforward with the TO END OF BACKUP option) is not supported in a DB2 pureScale environment.

26

The SET CLIENT command does not support the CATALOG_DBPARTITIONNUM clause in a DB2 pureScale environment.

27

Infinite logging is not supported in a DB2 pureScale environment.

28

The use of raw devices for database logging is not supported in a DB2 pureScale environment.

29

The QUIESCE TABLESPACES FOR TABLE command failed because quiescing table spaces is not supported in a DB2 pureScale environment. Quiescing a database or a database manager instance is supported in a DB2 pureScale environment.

User response

Respond to this message according to the reason code:

1

Execute the statement again, specifying the MANAGED BY AUTOMATIC STORAGE clause.

2

No user response is required. Automatic storage should already be enabled.

3

Execute the statement again without specifying the DROP STORAGE clause.

4

Execute the statement again without specifying ON DBPARTITIONNUMS and without specifying ON DBPARTITIONNUM with a database partition other than 0.

5

No response is required. You cannot alter database partition groups in a DB2 pureScale environment.

6

Execute the CREATE TABLE statement again without specifying any of the following clauses:

  • ORGANIZE BY DIMENSIONS
  • ORGANIZE BY INSERT TIME
  • ORGANIZE BY KEY SEQUENCE
7

Reissue the index reorganization command without specifying the ALLOW READ ACCESS or ALLOW WRITE ACCESS clause.

9

No response is required. You cannot create or drop a database on a specified database partition in a DB2 pureScale environment.

11

Execute the statement again without specifying the unsupported clauses.

13

No response is required. You cannot use the db2ReadLogNoConn API in a DB2 pureScale environment.

14

No response is required. You cannot add or drop database partitions in a DB2 pureScale environment.

16

No response is required. You cannot use the PRUNE LOGFILE command in a DB2 pureScale environment.

17

No user response is required. You cannot use the HEALTH_MON configuration parameter in a DB2 pureScale environment.

18

Block-based buffer pools are not supported in a DB2 pureScale environment. Execute the CREATE BUFFERPOOL or ALTER BUFFERPOOL statement again without specifying the NUMBLOCKPAGES or BLOCKSIZE clause.

19

Reissue the ROLLFORWARD or RECOVER command without specifying ON DBPARTITIONNUMS or specify a database partition value of 0.

20

Before you can add a CF or member on this host you will have to remove one. For instance, if you want to add a CF you will first have to remove a member.

23

Restart the restore operation without specifying the unsupported REBUILD option.

24

Restart the rollforward or recover operation without specifying the unsupported TO <isotime> or TO END OF BACKUP option.

26

Do not specify the CATALOG_DBPARTITIONNUM clause with the SET CLIENT command.

27

Do not set the value of the logsecond database configuration parameter to -1. This value configures the database with infinite active log space, which is not supported in a DB2 pureScale environment.

28

Do not specify a raw device when updating the value of the newlogpath database configuration parameter. Specify a valid path name or, as an alternative to using raw logs, use either direct input/output (DIO) or concurrent input/output (CIO).

29

Quiesce the database using the QUIESCE DATABASE command, or quiesce the database manager instance using the QUIESCE INSTANCE command.

sqlcode: -1419

sqlstate: 56038

SQL1420N Too many concatenation operators.

Explanation

The database manager has reached an internal limit while evaluating an expression, of long or large object string result type, that contains concatenation operators.

User response

Reduce the number of concatenations in the expression and try again.

sqlcode: -1420

sqlstate: 54001

SQL1421N MBCS conversion error occurred when converting host variable or sqlvar number to or from wchar_t format. Reason code rc.

Explanation

A C/C++ application with embedded SQL statements was precompiled with the WCHARTYPE CONVERT option. At runtime, the application received an error which occurred during conversion in either wcstombs(), for input host variables, or mbstowcs(), for output host variables. The host variable or sqlvar number indicates which data item experienced the problem. Valid reason codes are:
1
the problem occurred with input data
2
the problem occurred with output data

User response

If application data is already in MBCS format, re-precompile the application with WCHARTYPE NOCONVERT and re-build. If application data is intended to be in wchar_t format, then input data failing in wcstombs() may be corrupt. Correct the data and re-execute the application.

sqlcode: -1421

sqlstate: 22504

SQL1422N The size of the container is invalid.

Explanation

One of the containers to be used in a database managed table space is either too large or too small. A container must be at least 2 * extentsize pages in length. The maximum size of a container is operating system dependent. The most common system limit is 2 gigabytes (524288 4K pages).

User response

Check the administration notification log for details. Then correct the SQL statement.

sqlcode: -1422

sqlstate: 54039

SQL1423N The query includes a column with a large object data type.

Explanation

The query includes a column with a data type of BLOB, CLOB or DBCLOB. In general, such data types cannot be handled from clients available prior to Version 2.1.

The error occurred for a condition that corresponds to warning SQLCODE +238. See this message for details that explain the condition. The client level receiving this message cannot process BLOB data types. It may be able to handle CLOB and DBCLOB data types by using the SUBSTR function or by setting the data type in the SQLDA to one of the character data types available in Version 1 if the LOB column is not larger than the supported length of the character data type.

User response

Change the query to exclude any column that has a data type of BLOB, CLOB or DBCLOB. This is the only possible action if the query includes a column of type BLOB. If the column (say C1) is a CLOB, you could use CAST(C1 AS LONG VARCHAR) to get the first 32700 characters. Similarly for DBCLOB column (DC1) use CAST(DC1 AS LONG VARGRAPHIC) to get the first 16350 characters. If the application code can be changed, code can be added to change the SQLDA to use LONG VARCHAR or LONG VARGRAPHIC for CLOB and DBCLOB.

sqlcode: -1423

sqlstate: 56093

SQL1424N Too many references to transition variables and transition table columns or the row length for these references is too long. Reason code=rc.

Explanation

The trigger includes a REFERENCING clause that identifies one or more transition tables and transition variables. The triggered action of the trigger contains references to transition table columns or transition variables with one of the following conditions identified by the reason code:
1
references total more than the limit of the number of columns in a table
2
sum of the lengths of the references exceeds the maximum length of a row in a table.

User response

Reduce the number of references to transition variables and transition table columns in the trigger action of the trigger so that the length is reduced or the total number of such references is less than the maximum number of columns in a table.

sqlcode: -1424

sqlstate: 54040

SQL1425N A password has been supplied without a userid.

Explanation

Any command/API that accepts a userid and password will not accept a password without a userid.

User response

Resubmit the command/API and supply a userid if you are also supplying a password.

SQL1426N A default instance cannot be determined.

Explanation

If an explicit 'attach to instance' has not been performed, instance commands try to form an implicit attachment to a default instance. The default instance is determined from the DB2INSTDFT and DB2INSTANCE environment variables. If neither of these are set, then no implicit attachment can be formed.

User response

Set one of these environment variables to a valid instance name and resubmit the command.

SQL1427N An instance attachment does not exist.

Explanation

The application is not attached to an instance. The attempted command/API cannot be executed unless there is an existing instance attachment.

User response

If the error occurred when detaching from an instance, continue processing. If the error occurred during the execution of any other command, attach to an instance and reissue the failed command.

SQL1428N The application is already attached to nodename1 while the command issued requires an attachment to nodename2 for successful execution.

Explanation

In order to successfully process the command, an attachment to a node other than that which currently exists is required. The application must either: 1) have no attachment when the command is issued, or 2) already be attached to the node required by the command.

User response

Ensure that the application has no attachment before issuing the command or that the attachment that exists is to the correct node.

SQL1429N A node directory entry cannot be created in which the node name matches the value of the DB2INSTANCE environment variable.

Explanation

The CATALOG NODE command or API does not allow an entry whose nodename matches the value of the DB2INSTANCE environment variable.

User response

Choose another node name for the node being cataloged and try again.

SQL1430N The database name database cannot be found in the system database directory on node nodename.

Explanation

When specific database names are provided to the database monitor, those databases must reside either at the node to which you are currently attached or at the local node.

User response

Make sure the databases listed in the request all reside at the node to which you are attached or at the local node. Reissue the request.

SQL1431N The relative path path is not allowed when executing remotely.

Explanation

When the application is remote from the server, relative paths are not allowed.

User response

Specify a fully qualified path that is valid at the server and reissue the command.

SQL1432N A request has been sent to a server using a database protocol which the server does not recognize.

Explanation

This error is caused by sending a DB2 request to a server which does not understand the database protocol being used to transmit the request. This situation will occur most frequently when sending a DB2 ATTACH request to a server listed in your node directory which is not a DB2 Version 2 or greater server. This error will also arise if you send an attach request to DB2 for AS/400, DB2 for MVS, or DB2 for VM and VSE servers.

User response

Do not attempt to attach to any of the servers listed in the Explanation.

SQL1433N The application is already connected to database1 while the command issued requires a connection to database2 for successful execution.

Explanation

In order to successfully process the command, a connection to a database other than that which currently exists is required. The application must either: 1) have no connection when the command is issued, or 2) already be connected to the database required by the command.

User response

Ensure that the application has no connection before issuing the command or that the connection that exists is to the correct database.

SQL1434N A CONNECT or ATTACH statement failed because of a client/server incompatibility between 32 bit and 64 bit platforms.

Explanation

  1. Version 7 does not support client/server connections between 32 bit and 64 bit platforms.
  2. Version 8 Windows 64-bit database server does not support client/server connections from Version 7 64-bit clients.

User response

For scenario 1, you can issue a CONNECT or ATTACH statement in the following scenarios:

  • from a 32 bit client to a 32 bit server
  • from a 64 bit client to a 64 bit server

For scenario 2 listed above, reissue the statement from a supported client.

sqlcode: -1434

sqlstate: 08004

SQL1435N Binding or rebinding the automated maintenance policy configuration stored procedures failed.

Explanation

You can use the stored procedures SYSPROC.AUTOMAINT_SET_POLICY or SYSPROC.AUTOMAINT_SET_POLICYFILE and SYSPROC.AUTOMAINT_GET_POLICY or SYSPROC.AUTOMAINT_GET_POLICYFILE to configure database server automated maintenance activities such as automatic backup, automatic reorganization, and automatic statistics collection.

Before you can use SYSPROC.AUTOMAINT_SET_POLICY, SYSPROC.AUTOMAINT_SET_POLICYFILE, SYSPROC.AUTOMAINT_GET_POLICY or SYSPROC.AUTOMAINT_GET_POLICYFILE, these stored procedures must be bound to the database against which you will run them. The bind file for these stored procedures is called db2policy.bnd.

The database server attempts to automatically bind these automated maintenance policy configuration stored procedures for you. However, this automatic binding or rebinding failed.

You will not be able to use these stored procedures until they are bound to the database.

User response

To bind these automated maintenance policy configuration stored procedures perform the following steps:

  1. Connect to the database on which you will use these stored procedures
  2. Run the DB2 bind command with the bind file called db2policy.bnd in the SQLLIB/bnd directory:
    DB2 bind db2policy.bnd blocking all grant public

sqlcode: -1435

sqlstate: 5U0ZZ

SQL1436N Automated maintenance policy configuration file named file-name could not be opened.

Explanation

You can use the stored procedures SYSPROC.AUTOMAINT_SET_POLICY or SYSPROC.AUTOMAINT_SET_POLICYFILE and SYSPROC.AUTOMAINT_GET_POLICY or SYSPROC.AUTOMAINT_GET_POLICYFILE to configure database server automated maintenance activities such as automatic backup, automatic reorganization, and automatic statistics collection.

When you call SYSPROC.AUTOMAINT_SET_POLICY or SYSPROC.AUTOMAINT_SET_POLICYFILE, you can specify an XML file that contains the automated maintenance policy details that you want to configure. In this case, the file specified could not be opened.

No new automated maintenance policy configuration was applied.

User response

  1. Confirm that the specified file satisfies the following conditions:
    • the file exists
    • the user id as which the stored procedure is running has permission to read the file
    • the file is not empty
    • the format of the file is UTF-8
  2. Call the SYSPROC.AUTOMAINT_SET_POLICY or SYSPROC.AUTOMAINT_SET_POLICYFILE procedure again specifying a file that satisfies the previously listed conditions.

sqlcode: -1436

sqlstate: 5U0ZZ

SQL1437N The XML in the automatic maintenance policy file or LOB parameter passed to AUTOMAINT_SET_POLICY or AUTOMAINT_SET_POLICYFILE is not valid at line number line-number and column number coumn-number. Validation error message: error-message.

Explanation

You can use the stored procedures SYSPROC.AUTOMAINT_SET_POLICY or SYSPROC.AUTOMAINT_SET_POLICYFILE and SYSPROC.AUTOMAINT_GET_POLICY or SYSPROC.AUTOMAINT_GET_POLICYFILE to configure database server automated maintenance activities such as automatic backup, automatic reorganization, and automatic statistics collection.

There are two forms of SYSPROC.AUTOMAINT_SET_POLICY or SYSPROC.AUTOMAINT_SET_POLICYFILE: one version of this stored procedure takes a parameter that is the name of an XML file that contains automated maintenance configuration details, and the other version of this stored procedure takes a LOB parameter containing automated maintenance configuration details in XML format.

The XML in the automatic maintenance configuration file or LOB parameter passed to SYSPROC.AUTOMAINT_SET_POLICY or SYSPROC.AUTOMAINT_SET_POLICYFILE contains invalid XML at the line specified. The column number indicates the location within that line of the error.

No new automatic maintenance configuration was applied.

User response

Correct the contents of the XML configuration file and call the stored procedure again.

sqlcode: -1437

sqlstate: 5U0ZZ

SQL1438N An internal error occurred while processing the XML automated maintenance policy configuration file or LOB parameter passed to AUTOMAINT_SET_POLICY or AUTOMAINT_SET_POLICYFILE.

Explanation

You can use the stored procedures SYSPROC.AUTOMAINT_SET_POLICY or SYSPROC.AUTOMAINT_SET_POLICYFILE and SYSPROC.AUTOMAINT_GET_POLICY or SYSPROC.AUTOMAINT_GET_POLICYFILE to configure database server automated maintenance activities such as automatic backup, automatic reorganization, and automatic statistics collection.

There are two forms of SYSPROC.AUTOMAINT_SET_POLICY or SYSPROC.AUTOMAINT_SET_POLICYFILE: one version of this stored procedure takes a parameter that is the name of an XML file that contains automated maintenance configuration details, and the other version of this stored procedure takes a LOB parameter containing automated maintenance configuration details in XML format.

An internal error occurred while processing the XML in the automatic maintenance configuration file or LOB passed to SYSPROC.AUTOMAINT_SET_POLICY or SYSPROC.AUTOMAINT_SET_POLICYFILE.

No new automatic maintenance configuration was applied.

User response

Confirm that the contents of the XML configuration file or the LOB parameter passed to SYSPROC.AUTOMAINT_SET_POLICY or SYSPROC.AUTOMAINT_SET_POLICYFILE is valid and call the stored procedure again.

sqlcode: -1438

sqlstate: 5U0ZZ

SQL1439N Could not retrieve automated maintenance policy configuration information.

Explanation

You can use the stored procedures SYSPROC.AUTOMAINT_SET_POLICY or SYSPROC.AUTOMAINT_SET_POLICYFILE and SYSPROC.AUTOMAINT_GET_POLICY or SYSPROC.AUTOMAINT_GET_POLICYFILE to configure database server automated maintenance activities such as automatic backup, automatic reorganization, and automatic statistics collection.

The stored procedure SYSPROC.AUTOMAINT_GET_POLICY or SYSPROC.AUTOMAINT_GET_POLICYFILE was unable to collect existing automated maintenance configuration information because it could not find any default automated maintenance policies.

No automatic maintenance configuration information was collected.

User response

Default automated maintenance policies are created by the DB2 health monitor. If the health monitor has not yet created the default maintenance policies, then you can manually create them:

  1. Connect to the database for which you wish to create default automated maintenance policies
  2. Call the system stored procedure called SYSPROCS.SYSINSTALLOBJECTS with the following parameters:
    
    SYSPROCS.SYSINSTALLOBJECTS( 'POLICY','C','','')
    

sqlcode: -1439

sqlstate: 5U0ZZ

SQL1440W All privileges were granted but the WITH GRANT OPTION was ignored.

Explanation

With some GRANT statements, you can use the WITH GRANT OPTION clause to give the specified user (or groups) the ability to grant privileges to others.

The WITH GRANT OPTION is ignored when it is used in combination with certain privileges. This message is returned when an attempt is made to specify the WITH GRANT OPTION with privileges that it does not apply to.

All valid privileges were granted.

User response

No response is required.

sqlcode: +1440

sqlstate: 01516

SQL1441N Invalid parameter. Reason code code.

Explanation

The following is a list of valid reason codes:
1
A NULL was passed in for the context pointer.
3
The context pointer has been initialized, but not to a valid context area.
4.
Invalid option
5
reserved parameter was not NULL

User response

Ensure that the application context pointer has been properly initialized and that any options used are valid and try again.

SQL1442N The context is not in use or is not in use by the current thread. Reason code code.

Explanation

The call failed because:
1
The context is not in use by any thread (no attach was done)
2
The context is not in use by the current thread.
3
The current thread is not using a context.

User response

For a detach call, ensure that the context is the one in use by the current thread, and that a corresponding attach was done.

For a get current context call, ensure that the thread is currently using a context.

SQL1443N Thread is already attached to a context.

Explanation

The user attempted to attach a context to a thread, and the thread is already using a context.

User response

Detach from the previous context before attaching to a new one.

SQL1444N The application context cannot be destroyed because it is in use.

Explanation

The user attempted to destroy an application context while it is still in use. Either there is a thread attached to the context, or the context has a CONNECT or ATTACH associated with it. A CONNECT RESET or DETACH must be done (if a CONNECT or ATTACH has been done), and all threads must detach from the context before it can be destroyed.

User response

Ensure that all calls to attach to a context have a corresponding detach, all CONNECTS have a corresponding CONNECT RESET, and all ATTACHES have a corresponding DETACH.

SQL1445N Thread or process does not have a context to use.

Explanation

A context type of SQL_CTX_MULTI_MANUAL is in effect, but the current thread or process has not been attached to a context.

User response

Make sure the current thread or process is attached to a context before making any database calls.

SQL1446N An internal error occurred while processing the XML automated maintenance policy configuration file or LOB parameter passed to AUTOMAINT_GET_POLICY or AUTOMAINT_GET_POLICYFILE.

Explanation

You can use the stored procedures SYSPROC.AUTOMAINT_SET_POLICY or SYSPROC.AUTOMAINT_SET_POLICYFILE and SYSPROC.AUTOMAINT_GET_POLICY or SYSPROC.AUTOMAINT_GET_POLICYFILE to configure database server automated maintenance activities such as automatic backup, automatic reorganization, and automatic statistics collection.

There are two forms of SYSPROC.AUTOMAINT_GET_POLICY or SYSPROC.AUTOMAINT_GET_POLICYFILE: one version of this stored procedure takes a parameter that is the name of an XML file that contains automated maintenance configuration details, and the other version of this stored procedure takes a LOB parameter containing automated maintenance configuration details in XML format.

An internal error occurred while processing the XML in the automatic maintenance configuration file or LOB passed to SYSPROC.AUTOMAINT_GET_POLICY or SYSPROC.AUTOMAINT_GET_POLICYFILE.

No automatic maintenance configuration was collected.

User response

Confirm that the contents of the XML configuration file or the LOB parameter passed to SYSPROC.AUTOMAINT_SET_POLICY or SYSPROC.AUTOMAINT_SET_POLICYFILE is valid and call the stored procedure again.

sqlcode: -1446

sqlstate: 5U0ZZ

SQL1447N The XML in the automated maintenance policy file or LOB parameter passed to AUTOMAINT_SET_POLICY or AUTOMAINT_SET_POLICYFILE is not valid for reason: reason-code.

Explanation

You can use the stored procedures SYSPROC.AUTOMAINT_SET_POLICY or SYSPROC.AUTOMAINT_SET_POLICYFILE and SYSPROC.AUTOMAINT_GET_POLICY or SYSPROC.AUTOMAINT_GET_POLICYFILE to configure database server automated maintenance activities such as automatic backup, automatic reorganization, and automatic statistics collection.

The automated maintenance configuration file or LOB parameter passed to SYSPROC.AUTOMAINT_SET_POLICY or SYSPROC.AUTOMAINT_SET_POLICYFILE contains invalid XML according to the given reason code:

1

The PathName element does not specify a valid path. For example, this message is returned if the specified path does not exist.

2

The SQL syntax of the FilterClause element is not valid.

3

The database manager attempted to validate the XML input file or LOB parameter you passed to SYSPROC.AUTOMAINT_SET_POLICY using a schema document in the /home/misc directory. The database manager could not find the schema document.

4

The first element in the XML input file or LOB parameter is not valid XML.

5

The encoding of the input XML file is not UTF-8.

No new automatic maintenance configuration was applied.

User response

Respond according to the reason code:

1, 2, and 4

Correct the contents of the XML configuration file or LOB parameter and call the stored procedure again.

3

Without this schema document, you cannot use the SYSPROC.AUTOMAINT_SET_POLICY, SYSPROC.AUTOMAINT_SET_POLICYFILE, SYSPROC.AUTOMAINT_GET_POLICY, or SYSPROC.AUTOMAINT_GET_POLICYFILE procedures.

You cannot replace this schema document manually. Reinstall the database server to replace the missing file.

5

Ensure that the first line of the XML input specifies encoding="UTF-8". If the editor in which you created the XML input saved the file using different encoding, save the file again using UTF-8 encoding.

sqlcode: -1447

sqlstate: 5U0ZZ

SQL1448N The path or file name full-file-name that was passed to AUTOMAINT_GET_POLICY or AUTOMAINT_GET_POLICYFILE does not exist.

Explanation

You can use the stored procedures SYSPROC.AUTOMAINT_SET_POLICY or SYSPROC.AUTOMAINT_SET_POLICYFILE and SYSPROC.AUTOMAINT_GET_POLICY or SYSPROC.AUTOMAINT_GET_POLICYFILE to configure database server automated maintenance activities such as automatic backup, automatic reorganization, and automatic statistics collection.

When you call SYSPROC.AUTOMAINT_GET_POLICY or SYSPROC.AUTOMAINT_GET_POLICYFILE, you can specify the name of an XML file into which the output from the stored procedure should be saved. In this case, the file specified could not be created or written to.

No automated maintenance policy configuration information was saved.

User response

  1. Confirm that the specified path and file satisfy the following conditions:
    • the directory path and file exist
    • the user id as which the stored procedures is running has permission to create or write to the file
  2. Call the SYSPROC.AUTOMAINT_SET_POLICY or SYSPROC.AUTOMAINT_SET_POLICYFILE procedure again specifying a file that satisfies the previously listed conditions.

sqlcode: -1448

sqlstate: 5U0ZZ

SQL1449C Tools catalog migrated successfully to the current level. The scheduler was not started successfully for the reason code reason-code.

Explanation

The db2tdbmgr command successfully migrated the database to the current level, but the scheduler was not started successfully for the reason indicated by the reason code:

1

The Tools Catalog Database configuration in the DB2 Administration Server configuration parameters is not correct.

2

The database manager containing the Tools Catalog Database has not been started.

3

The Tools Catalog Database is being used by another scheduler.

4

Unexpected error occurred when starting the scheduler.

User response

1

Correct the Tools Catalog Database configuration in the DB2 Administration Server configuration parameters. For instructions on configuring the Tools Catalog Database, refer to the section on the DB2 Administration Server in the DB2 Administration Guide.

2

Start the database manager containing the Tools Catalog Database.

3

Wait until the Tools Catalog Database is not being used by another scheduler.

4

Stop and Restart the DB2 Administration Server.

SQL1450N Invalid registration information pointer.

Explanation

An invalid registration information pointer was passed to the register/deregister database server command/API.

User response

Verify that a valid pointer was passed to the register/ deregister database server command/API.

SQL1451N Register/deregister database server must be issued from a server node.

Explanation

Register/deregister database server was issued from an invalid node.

User response

Reissue the register/deregister database server command/API from a server node.

SQL1452N An invalid registration location was specified.

Explanation

An invalid registration location was passed to the register/deregister database server command/API.

User response

Verify that a valid registration location was passed to the register/deregister database server command/API.

SQL1453N The entry in the database manager configuration file for file server name is missing or invalid.

Explanation

The file server name specified in the configuration command/API or in the database manager configuration file is missing or invalid.

User response

Verify that a file server name was specified, that the name does not contain invalid characters, and is not longer than 48 characters in length. Update the file server name in the database manager configuration file and resubmit the command/API.

SQL1454N The entry in the database manager configuration file for object name is missing or invalid.

Explanation

The object name specified in the configuration command/API or in the database manager configuration file is missing or invalid.

User response

Verify that an object name was specified, that the name does not contain invalid characters, and is not longer than 48 characters in length. Update the object name in the database manager configuration file and resubmit the command/API.

SQL1455N The entry in the database manager configuration file for IPX socket number is missing or invalid.

Explanation

The IPX socket number specified in the configuration command/API or in the database manager configuration file is missing or invalid.

User response

Verify that an IPX socket number was specified, that the number does not contain invalid characters, and is not longer than 4 characters in length. Update the IPX socket number in the database manager configuration file and resubmit the command/API.

SQL1456N The object name specified in the database manager configuration file already exists on the NetWare file server.

Explanation

A duplicate object name was found when trying to register the database server object name on the NetWare file server.

User response

The object name specified in the database manager configuration file is already in use. Change the object name and then re-register the database server.

SQL1457N Register/deregister failed to login to the NetWare file server specified because a NetWare directory services connection is already established to that file server.

Explanation

A bindery login using NWLoginToFileServer cannot be performed if a NetWare directory services connection is already established to the specified file server.

User response

Sever the directory services connection by logging out and detaching from Directory Services, and then reissue register/deregister.

SQL1458N IPX/SPX has been configured in the database manager configuration file for direct addressing. It is not necessary to register/deregister the database server at/from a NetWare file server.

Explanation

Issuing register/deregister is not necessary since the database manager configuration file has been configured for IPX/SPX direct addressing. ie. Fileserver and objectname have been specified as '*'.

User response

Note that since the database server has been configured for direct addressing only, IPX/SPX clients using fileserver addressing will not be able to connect to this server. For the server to support both types of IPX/SPX client addressing, specify a fileserver and objectname in the database manager configuration file.

SQL1459I Tools catalog migrated successfully to the current level.

Explanation

The db2tdbmgr command successfully migrated the database to the current level.

User response

No response is required.

SQL1460N The environment variable variable required for SOCKS server name resolution is not defined or not valid.

Explanation

The SOCKS environment variable SOCKS_NS or SOCKS_SERVER is not defined. SOCKS protocol support requires that both these environment variables be defined.
SOCKS_NS
This is the IP address of the domain name server where the SOCKS server is defined.
SOCKS_SERVER
This is the hostname of the SOCKS server.

User response

Define the missing environment variable and resubmit the command.

SQL1461N The security option security is not valid.

Explanation

The SECURITY option for a TCP/IP node has a value other than 'SOCKS'. This option is used to enable the TCP/IP node being cataloged to use SOCKS protocol support to traverse a firewall. No value other than 'SOCKS' is permitted.

User response

Verify that SOCKS protocol support is required. If so, re-catalog the node with SECURITY SOCKS. If not, re-catalog the node, but omit the SECURITY option.

SQL1462N Request is only valid for a syncpoint manager connection.

Explanation

A request was attempted which is only valid for a syncpoint manager connection, but the syncpoint manager instance is not connected to.

User response

Connect to the syncpoint manager instance and reissue the request.

SQL1463N The operation cannot be performed on the administration task because the administration task table table-name cannot be used.

Explanation

The administration task cannot be added, updated, or removed because the table table-name that is used to store information about the tasks cannot be used as required. The table exists but cannot be used in its existing state. The administration task tables are automatically created when administration tasks are added to the database system. If the table was created in some other way, it may not be usable for administration task operations.

User response

Make the administration task table usable for administration task operations. To re-create table table-name, explicitly drop the table and then call the SYSPROC.ADMIN_TASK_ADD procedure to schedule a task.

sqlcode: -1463

sqlstate: 55070

SQL1464W Not all tasks were removed because some tasks were running.

Explanation

The SYSPROC.ADMIN_TASK_REMOVE procedure attempted to remove a set of tasks, but not all were removed. The tasks that were not running were removed by the procedure, but any tasks that were running when the procedure attempted to remove them were not removed.

User response

Wait until the running tasks complete and then use the SYSPROC.ADMIN_TASK_REMOVE procedure to remove the tasks. The SYSTOOLS.ADMIN_TASK_STATUS view can be used to check the execution status of tasks.

sqlcode: +1464

sqlstate: 0168S

SQL1465N The result of the SQL statement specified for the administrative task is not valid as input to the procedure procedure-name specified for the administrative task.

Explanation

The SQL statement that was specified as the PROCEDURE_INPUT for the scheduled administrative task was executed but the result could not be used as input to the procedure procedure-name that was specified for the scheduled administrative task. The SQL statement must result in no more than one row with the same number of columns in the result as there are arguments to the procedure.

User response

Modify the data in the database so that the SQL statement results in no more than one row, or modify the administrative task to change either the SQL statement or procedure specified for it. Ensure that the SQL statement will return no more than one row, and the number of arguments to the procedure specified for the administrative task matches the number of columns returned by the SQL statement. To modify the administrative task, use the SYSPROC.ADMIN_TASK_REMOVE procedure to remove the task, then call SYSPROC.ADMIN_TASK_ADD to recreate it.

sqlcode: -1465

sqlstate: 21507

SQL1467C The database manager received an I/O error while trying to read a page from the system managed temporary table space with table space id table-space-id.

Explanation

The most likely reason for the I/O error is a file system or hardware error.

The statement cannot be processed; and the utility or transaction of which this statement is a part will be rolled back.

User response

SQL1468N The database manager TCP/IP listener must be configured and running on the server instance instance (database partition number database-partition-number1) before attempting to CONNECT or ATTACH to node database-partition-number2.

Explanation

The SET CLIENT command or api or the environment variable DB2NODE was used to set the node for CONNECT or ATTACH to database-partition-number2. In order to CONNECT or ATTACH to this node, the Database Manager TCP/IP listener must be configured and running on the server instance instance (database partition number database-partition-number1).

Note: This message may be returned by an implicit CONNECT or ATTACH.

User response

Either:

  • Ensure that svcename has been specified in the database manager configuration on the instance instance, database partition number database-partition-number1, the DB2COMM environment variable has been set to use TCP/IP, and that TCP/IP listener was successfully started at DB2START time.

    or

  • Explicitly catalog the node and database.

sqlcode: -1468

sqlstate: 08004

SQL1469N Instance instance-name (database partition number database-partition-number1) does not have node database-partition-number2 specified in its db2nodes.cfg file.

Explanation

The SET CLIENT command or api or the environment variable DB2NODE was used to set the node for CONNECT or ATTACH to database-partition-number2. Subsequent CONNECT or ATTACH processing was unable to locate this node in the db2nodes.cfg file on the instance instance-name (node database-partition-number1).

Note: This message may be returned by an implicit CONNECT or ATTACH.

User response

Ensure that the node number specified by the SET CLIENT command or api or the DB2NODE environment variable exists in the db2nodes.cfg file of the intermediate instance instance-name, node database-partition-number1.

sqlcode: -1469

sqlstate: 08004

SQL1470N Value of DB2NODE environment variable is not valid.

Explanation

The DB2NODE environment variable indicates the node the application will attempt to connect to. If DB2NODE is unset or is blank, the application will attempt to connect to the default node. Otherwise, DB2NODE must be set to the node number of one of the nodes defined on the same host as the application.

User response

Set the DB2NODE environment variable to one of the following values:
unset
causes the application to connect to the default node.
blank
causes the application to connect to the default node.
A number
causes the application to connect to the node with that node number. The node must be running on the same host as the application.

sqlcode: -1470

sqlstate: 08001

SQL1471N Cannot connect to database database-name on node node-number because the database on this node is not synchronized with catalog node.

Explanation

The end-of-log information on this node does not match the corresponding record on the catalog node. This can be caused by restoring the database on various nodes with backups taken from different times.

User response

If the database is restored without rolling forward on one node, ensure that the database is restored from consistent offline backups on all nodes without rolling forward.

sqlcode: -1471

sqlstate: 08004

SQL1472N Cannot connect to database database-name on node node-number because the difference between the system time on the catalog node and the virtual timestamp on this node is greater than the max_time_diff database manager configuration parameter.

Explanation

The system time difference for the machines in the configuration (listed in the db2nodes.cfg file) is greater than the max_time_diff database manager configuration parameter.

User response

Synchronize the system times on all machines, and ensure that the max_time_diff parameter is configured to allow for normal communication delays among the database machines.

sqlcode: -1472

sqlstate: 08004

SQL1473N Cannot commit the transaction because the time difference between the system time on the local node and the virtual timestamps of node(s) node-list is greater than the max_time_diff database manager configuration parameter. The transaction is rolled back.

Explanation

The system time difference for the machines in the configuration (listed in the db2nodes.cfg file) is greater than the max_time_diff database manager configuration parameter.

If ",..." is displayed at the end of the node list, see the syslog file for the complete list of nodes.

User response

Synchronize the system times on all machines, and ensure that the max_time_diff parameter is configured to allow for normal communication delays among the database machines.

sqlcode: -1473

sqlstate: 40504

SQL1474W The transaction completed successfully, but the time difference between the system time on the local member and the virtual timestamps of member or members member-list is greater than the max_time_diff database manager configuration parameter.

Explanation

The system time difference for the machines in the configuration (listed in the db2nodes.cfg file) is greater than the max_time_diff database manager configuration parameter.

This warning message is returned to read-only transactions because they are not affected by this condition. However, other transactions would be rolled back. This message is to inform the user about this condition so that action can be taken at the earliest possible time.

If ",..." is displayed at the end of the member list, see the syslog file for the complete list of members.

User response

Synchronize the system times on all machines, and ensure that the max_time_diff parameter is configured to allow for normal communication delays among the database machines.

sqlcode: +1474

sqlstate: 01607

SQL1475W A system error occurred during CONNECT RESET processing.

Explanation

The CONNECT RESET was successful but a system error such as a node failure or a communications error may have occurred.

User response

Check the administration notification log for details. The database at this node may need to be restarted.

sqlcode: +1475

sqlstate: 01622

SQL1476N The current transaction was rolled back because of error sqlcode.

Explanation

The transaction was rolled back because:

  1. An implicit or explicit CLOSE CURSOR failed, or
  2. A table was being created with the NOT LOGGED INITIALLY option, or NOT LOGGED INITIALLY was activated for an existing table. During the same unit of work, either an error occurred, or a ROLLBACK TO SAVEPOINT statement was issued. This unit of work is rolled back, with the following effects:
    • Any table that was created in this unit of work is dropped or put into DROP PENDING state.
    • Any NOT LOGGED INITIALLY tables that were activated in the transaction are marked inaccessible, and can only be dropped.
    • The sqlcode will be 0 if a ROLLBACK TO SAVEPOINT was issued in the transaction.
  3. A rollback to savepoint failed or release savepoint failed.
  4. A severe error occurred during an atomic array input operation.
  5. An error occurred during the creation of a system temporary LOB that was to be used to maintain a LOB locator value for a LOB column of a declared temporary table or created temporary table whose rows were being deleted.

The runtime token, sqlcode, indicates the underlying sqlcode that was returned.

User response

Correct the problem as indicated by the error sqlcode, then run the transaction again. Remove any ROLLBACK TO SAVEPOINT statement that is used in the same transaction in which a NOT LOGGED INITIALLY table is created or activated.

sqlcode: -1476

sqlstate: 40506

SQL1477N For table table-name an object object-id in table space tbspace-id cannot be accessed.

Explanation

An attempt was made to access a table where one of its objects is not accessible. The table may not be accessible because of one of the following reasons:

  • The table had NOT LOGGED INITIALLY activated when the unit of work was rolled back.
  • The table is a partitioned created temporary table or declared temporary table and one or more database partitions failed since the temporary table was instantiated or declared.
  • ROLLFORWARD encountered the activation of NOT LOGGED INITIALLY on this table or a NONRECOVERABLE load on this table.

Access to this table is not allowed because its integrity cannot be guaranteed.

User response

One of the following actions can be taken.

  • If the object is a table and it had NOT LOGGED INITIALLY activated, drop the table. If this table is required, re-create it.
  • If the object is a data partition, detach it from the table. If this data partition is required, add a new one.
  • If the object is a non-partitioned index, drop the index. If this index is required, create a new one.
  • If the table is a created temporary table, disconnect from the server and connect again to instantiate a new copy of the created temporary table.
  • If the table is a declared temporary table, drop the table. If this table is required, declare it again.
  • Otherwise, restore from a table space or database backup. The backup image must have been taken subsequent to the commit point following the completion of the non-recoverable operation (NOT LOGGED INITIALLY operation, or NONRECOVERABLE load).

The catalogs and administrative views can be used to determine what the object is. To determine if the object is a table, use the following query:

SELECT TABNAME
  FROM SYSCAT.TABLES
  WHERE TBSPACEID=tbspace-id AND
    TABLEID=object-id

If a table name does not appear as the result for this query you can determine if the object is a partition by using the following query:

SELECT DATAPARTITIONNAME, TABNAME
  FROM SYSCAT.DATAPARTITIONS
  WHERE TBSPACEID=tbspace-id AND
    PARTITIONOBJECTID=object-id

To determine if the object is an index, use the following query:

SELECT INDNAME
  FROM SYSCAT.INDEXES
  WHERE TBSPACEID=tbspace-id AND
    INDEX_OBJECTID=object-id

To determine if the object is a created temporary table or a declared temporary table, use the following query:

SELECT TABNAME
 FROM SYSIBMADM.ADMINTEMPTABLES
 WHERE TBSP_ID=tbspace-id AND 
  INDEX_TAB_FILE_ID=object-id

sqlcode: -1477

sqlstate: 55019

SQL1478W The defined buffer pools could not be started. Instead, one small buffer pool for each page size supported by the database manager has been started.

Explanation

The defined buffer pools could not be started. Instead, one small buffer pool for each page size supported by the database manager has been started. The defined buffer pools could not be started for one or more of the following reasons:
  • Not enough memory could be allocated for the total size of the buffer pools specified for this database.
  • The buffer pool files in the database directory are missing or corrupt.

User response

Check the administration notification log for the correct source of the problem. A possible solution includes:
  • Drop or alter the size of one or more of the buffer pools to allow the database to start properly.

After making the changes, disconnect from the database and start the database again.

sqlcode: +1478

sqlstate: 01626

SQL1479W Attempt to fetch before the result set returned the first rowset.

Explanation

The requested rowset overlapped the start of the result set and, depending on the fetch orientation specified:
SQL_FETCH_PRIOR
one of the following situations:
  • the current position was beyond the first row, and the number of the current row is less than or equal to the rowset size.
  • the current position was beyond the end of the result set, and the rowset size was greater than the result set size.
SQL_FETCH_RELATIVE
the absolute value of the fetch offset was less than or equal to the current rowset size.
SQL_FETCH_ABSOLUTE
the fetch offset was negative, and the absolute value of the fetch offset was greater than the result set size but less than or equal to the current rowset size.

User response

No action needed.

SQL1480N The discover type specified in the DISCOVER database manager configuration parameter is invalid.

Explanation

Valid values for the DISCOVER parameter in the database manager configuration file are: DISABLE, KNOWN, or SEARCH.

User response

Update the DISCOVER database manager configuration parameter with a type of DISABLE, KNOWN, or SEARCH.

SQL1481N One or more of the communications protocols specified in the DISCOVER_COMM parameter is invalid.

Explanation

An example of a valid value for the DISCOVER_COMM parameter in the database manager configuration file is TCPIP.

User response

Update the DISCOVER_COMM database manager configuration parameter with only valid values.

SQL1482W The BUFFPAGE parameter will only be used if one of the buffer pools is defined with a size of -1.

Explanation

This is a warning that the BUFFPAGE database configuration parameter will be ignored if none of the database's buffer pools is defined with a size of -1. -1 indicates that the buffer pool is to use the BUFFPAGE parameter as the number of buffer pool pages.

User response

You can select from the SYSCAT.BUFFERPOOLS to review the buffer pool definitions. If none of the buffer pools are defined with size -1 (NPAGES), then setting the BUFFPAGE parameter will not change the size of the buffer pools for the database.

SQL1483N Add database partition server processing for database partition server partitionnum failed. Information returned for the error includes SQLCODE sqlcode, SQLSTATE sqlstate, and message tokens token-list.

Explanation

Add database partition server processing failed for database partition server partitionnum. The sqlcode, sqlstate, and message token list (each token is separated by the vertical bar character) are provided. The message tokens may be truncated. See the corresponding message for the sqlcode for further explanation of the error.

User response

Check the message associated with the SQLCODE of the SQL statement that failed. Follow the action suggested by that message.

sqlcode: -1483

sqlstate: 5UA02

SQL1484N The request failed because of an ongoing add operation. Request: request. Member or dbpartitionnum: number.

Explanation

The request failed because of an ongoing add operation. Until the specified database partition or member is added, the request is not allowed.

User response

Wait for the add operation to complete and resubmit the request.

sqlcode: -1484

sqlstate: 55071

SQL1485N The database partition server or member cannot be added or dropped because of the state the database or instance name is in. State state.

Explanation

A database partition server or member cannot be added or dropped when the database or instance is in the specified state.

User response

Change the database or instance so that it is in a state that allows the adding or dropping of a database partition server or member and resubmit the request.

sqlcode: -1485

sqlstate: 55019

SQL1487W The database partition server, DB2 member, or CF was added successfully.

Explanation

In a partitioned database environment, this message is returned when a new database partition server was added to a single-partition database environment. At the completion of the add database partition server operation, the new database partition server is not active until the database manager instance is restarted.

In a DB2 pureScale environment, the message is returned when a new DB2 member or cluster caching facility (CF) is added to an instance. After the member or CF is added, it is not active until the member or CF is restarted.

User response

The new member or CF must be started manually using the db2start command.

SQL1488W The add database partition server operation was successful, and the new database partition server partitionnum is active. The DB2 cluster manager is detected in the instance. You may want to run the cluster manager tool db2haicu to configure the new database partition server for the cluster manager.

Explanation

The instance is managed by the DB2 cluster nmanager. When the newly added database partition server is configured, it can be managed by the cluster manager.

User response

Use the db2haicu tool to add the new database partition server to the cluster manager.

SQL1489I The add database partition server operation was successful. The new database partition server dbpartitionnum is active.

User response

No response is required.

SQL1490W Activate database is successful, however, the database has already been activated on one or more nodes.

Explanation

Database has already been explicitly started (activated) on one or more nodes.

User response

No action required.

SQL1491N The database name was not deactivated because the database is still being used.

Explanation

The database cannot be deactivated if there are any applications connected to the specified database.

User response

Ensure that all applications have done a CONNECT RESET, then try again.

SQL1492N The database name was not deactivated because it was not activated.

Explanation

The database cannot be deactivated because the specified database was not active.

User response

No action is required.

SQL1493N The command failed because the application is already connected to an active database.

Explanation

The ACTIVATE DATABASE, DEACTIVATE DATABASE, or ARCHIVE LOG command cannot proceed because the application is already connected to a database.

User response

Disconnect from the database, and then reissue the command.

SQL1494W Activate database is successful, however, there is already a connection to the database.

Explanation

There is already database connection on one or more nodes.

User response

No action required.

SQL1495W Deactivate database is successful, however, there is still a connection to the database.

Explanation

There is still database connection to one or more nodes. The database will be shut down when the last connection disconnects from the database.

User response

No action required.

SQL1496W Deactivate database is successful, but the database was not activated.

Explanation

Database was not explicitly started on one or more nodes when deactivate database was executed.

User response

No action required.

SQL1497W Activate/Deactivate database was successful, however, an error occurred on some nodes.

Explanation

Activate/Deactivate database is successful at least on the catalog node and coordinator node, however, on some other node(s) an error has occurred.

User response

Refer to the diagnostic log to find out what error has occurred on which node, fix the problem if possible and then reissue the activate/deactivate database command.

SQL1498W There are tables in the database that contain one or more type-1 indexes. To convert them to type-2 indexes, run the generated-file CLP script prior to database upgrade.

Explanation

Beginning in DB2 Version 9.7, type-1 indexes are no longer supported and they must be converted to type-2 indexes. Type-2 indexes were introduced in DB2 UDB Version 8 as a replacement for type-1 indexes in order to improve concurrency by minimizing next-key locking and using columns with length greater than 255 bytes as part of the index key.

The db2ckupgrade command identifies all type-1 indexes and generates the generated-file CLP script file in the same directory as the command logfile. The CLP script contains a REORG INDEXES ALL statement with the ALLOW WRITE ACCESS and CONVERT options for each identified type-1 index. It can be executed to convert all the identified type-1 indexes to type-2 indexes.

During database upgrade, any remaining type-1 indexes are marked invalid. The database manager will automatically rebuild the indexes as type-2 indexes on the first table access after database upgrade. No access to the table will be allowed until the index rebuild has completed.

User response

To avoid the overhead of index rebuild on the first table access, run the generated-file CLP script generated by the db2ckupgrade command to convert type-1 indexes to type-2 indexes prior to database upgrade.

SQL1499W Database upgrade was successful; however, additional user action may be required. See the administration notification log for more details.

Explanation

Database upgrade was successful; however, additional user action may be required because one or more of the following conditions were detected:

  • Database upgrade altered NOT FENCED routines to FENCED and NOT THREADSAFE or altered user defined wrappers to FENCED on UNIX and Linux operating systems.
  • Database upgrade could not successfully collect statistics on the system catalog tables.
  • Database upgrade detected identifiers called NULL.
  • Database upgrade marked indexes for rebuild on one or more tables.
  • Database upgrade detected asterisks in workload connection attributes.
  • Database upgrade detected databases enabled for XML Extender.
  • Database upgrade detected databases enabled for DB2 WebSphere MQ functions.
  • Database upgrade could not successfully re-validate or rebind packages.

User response

Refer to the administration notification log for additional information on the conditions detected to help you determine the action that might be required.