® ®

IBM DB2 Universal Database


Message Reference
Volume 2
Version 7

GC09-2979-00
 ® ®
IBM DB2 Universal Database

Message Reference
Volume 2
Version 7

GC09-2979-00
Before using this information and the product it supports, be sure to read the general information under
“Appendix C. Notices” on page 555.

This document contains proprietary information of IBM. It is provided under a license agreement and is protected by
copyright law. The information contained in this publication does not include any product warranties, and any
statements provided in this manual should not be interpreted as such.
Order publications through your IBM representative or the IBM branch office serving your locality or by calling
1-800-879-2755 in the United States or 1-800-IBM-4YOU in Canada.
When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any
way it believes appropriate without incurring any obligation to you.
© Copyright International Business Machines Corporation 1993, 2000. All rights reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
About This Guide . . . . . . . . . . v SQL3400 - SQL3499 . . . . . . . . . 348
Who Should Use This Guide . . . . . . . v SQL3500 - SQL3599 . . . . . . . . . 351
How This Guide Is Structured . . . . . . v SQL3600 - SQL3699 . . . . . . . . . 359
Organization . . . . . . . . . . . v SQL3700 - SQL3799 . . . . . . . . . 361
Conventions . . . . . . . . . . . v SQL3800 - SQL3899 . . . . . . . . . 363
SQL3900 - SQL3999 . . . . . . . . . 364
Chapter 1. Introduction to Messages . . . 1 SQL4000 - SQL4099 . . . . . . . . . 370
Information Available Online. . . . . . . 1 SQL4100 - SQL4199 . . . . . . . . . 373
Other DB2 Messages . . . . . . . . 3 SQL4300 - SQL4399 . . . . . . . . . 382
Other Message Sources. . . . . . . . 3 SQL4400 - SQL4499 . . . . . . . . . 384
SQL4900 - SQL4999 . . . . . . . . . 386
Chapter 2. SQL Messages . . . . . . . 5 SQL5000 - SQL5099 . . . . . . . . . 394
SQL0000 - SQL0099 . . . . . . . . . . 5 SQL5100 - SQL5199 . . . . . . . . . 400
SQL0100 - SQL0199 . . . . . . . . . 15 SQL6000 - SQL6099 . . . . . . . . . 406
SQL0200 - SQL0299 . . . . . . . . . 32 SQL6100 - SQL6199 . . . . . . . . . 423
SQL0300 - SQL0399 . . . . . . . . . 51 SQL6500 - SQL6599 . . . . . . . . . 425
SQL0400 - SQL0499 . . . . . . . . . 64 SQL7000 - SQL7099 . . . . . . . . . 434
SQL0500 - SQL0599 . . . . . . . . . 90 SQL8000 - SQL8099 . . . . . . . . . 437
SQL0600 - SQL0699 . . . . . . . . . 110 SQL8100 - SQL8199 . . . . . . . . . 441
SQL0700 - SQL0799 . . . . . . . . . 123 SQL9300 - SQL9399 . . . . . . . . . 442
SQL0800 - SQL0899 . . . . . . . . . 128 SQL10000 - SQL10099 . . . . . . . . 443
SQL0900 - SQL0999 . . . . . . . . . 136 SQL20000 - SQL20099 . . . . . . . . 447
SQL1000 - SQL1099 . . . . . . . . . 154 SQL20100 - SQL20199 . . . . . . . . 469
SQL1100 - SQL1199 . . . . . . . . . 175 SQL20200 - SQL20299 . . . . . . . . 472
SQL1200 - SQL1299 . . . . . . . . . 188 SQL29000 - SQL29100 . . . . . . . . 473
SQL1300 - SQL1399 . . . . . . . . . 208 SQL30000 - SQL30099 . . . . . . . . 476
SQL1400 - SQL1499 . . . . . . . . . 222 SQL30100 - SQL30199 . . . . . . . . 489
SQL1500 - SQL1599 . . . . . . . . . 234
SQL1600 - SQL1699 . . . . . . . . . 239 Chapter 3. SQLSTATE Messages . . . . 491
SQL1700 - SQL1799 . . . . . . . . . 246 Class Code 00 Unqualified Successful
SQL1800 - SQL1899 . . . . . . . . . 252 Completion . . . . . . . . . . . . 492
SQL1900 - SQL1999 . . . . . . . . . 257 Class Code 01 Warning . . . . . . . . 492
SQL2000 - SQL2099 . . . . . . . . . 257 Class Code 02 No Data . . . . . . . . 495
SQL2100 - SQL2199 . . . . . . . . . 268 Class Code 07 Dynamic SQL Error . . . . 496
SQL2200 - SQL2299 . . . . . . . . . 269 Class Code 08 Connection Exception . . . 496
SQL2300 - SQL2399 . . . . . . . . . 272 Class Code 09 Triggered Action Exception 496
SQL2400 - SQL2499 . . . . . . . . . 275 Class Code 0A Feature Not Supported . . . 497
SQL2500 - SQL2599 . . . . . . . . . 278 Class Code 0D Invalid Target Type
SQL2600 - SQL2699 . . . . . . . . . 290 Specification . . . . . . . . . . . 497
SQL2700 - SQL2799 . . . . . . . . . 292 Class Code 0F Invalid Token . . . . . . 497
SQL2800 - SQL2899 . . . . . . . . . 300 Class Code 0K Invalid RESIGNAL statement 497
SQL3000 - SQL3099 . . . . . . . . . 303 Class Code 20 Case Not Found for Case
SQL3100 - SQL3199 . . . . . . . . . 318 Statement . . . . . . . . . . . . 497
SQL3200 - SQL3299 . . . . . . . . . 334 Class Code 21 Cardinality Violation . . . . 498
SQL3300 - SQL3399 . . . . . . . . . 342 Class Code 22 Data Exception. . . . . . 498

© Copyright IBM Corp. 1993, 2000 iii

Class Code 23 Constraint Violation . . . . 499 Class Code 58 System Error . . . . . . 521
Class Code 24 Invalid Cursor State . . . . 500
Class Code 25 Invalid Transaction State . . 500 Appendix A. Communications Errors . . 523
Class Code 26 Invalid SQL Statement TCP/IP . . . . . . . . . . . . . 523
Identifier. . . . . . . . . . . . . 501 APPC . . . . . . . . . . . . . . 527
Class Code 28 Invalid Authorization NETBIOS . . . . . . . . . . . . 529
Specification . . . . . . . . . . . 501 IPX/SPX . . . . . . . . . . . . . 531
Class Code 2D Invalid Transaction
Termination . . . . . . . . . . . . 501 Appendix B. Using the DB2 Library . . . 537
Class Code 2E Invalid Connection Name . . 501 DB2 PDF Files and Printed Books . . . . 537
Class Code 34 Invalid Cursor Name . . . 502 DB2 Information . . . . . . . . . 537
Class Code 38 External Function Exception 502 Printing the PDF Books . . . . . . . 546
Class Code 39 External Function Call Ordering the Printed Books . . . . . 547
Exception . . . . . . . . . . . . 503 DB2 Online Documentation . . . . . . 548
Class Code 3B Invalid SAVEPOINT . . . . 503 Accessing Online Help . . . . . . . 548
Class Code 40 Transaction Rollback . . . . 504 Viewing Information Online . . . . . 550
Class Code 42 Syntax Error or Access Rule Using DB2 Wizards . . . . . . . . 552
Violation . . . . . . . . . . . . . 504 Setting Up a Document Server . . . . 553
Class Code 44 WITH CHECK OPTION Searching Information Online . . . . . 554
Violation . . . . . . . . . . . . . 515
Class Code 46 Java DDL . . . . . . . 515 Appendix C. Notices . . . . . . . . 555
Class Code 51 Invalid Application State . . 516 Trademarks . . . . . . . . . . . . 558
Class Code 54 SQL or Product Limit
Exceeded . . . . . . . . . . . . 516 Index . . . . . . . . . . . . . 561
Class Code 55 Object Not in Prerequisite
State . . . . . . . . . . . . . . 518
Contacting IBM . . . . . . . . . . 563
Class Code 56 Miscellaneous SQL or Product
Product Information . . . . . . . . . 563
Error . . . . . . . . . . . . . . 519
Class Code 57 Resource Not Available or
Operator Intervention . . . . . . . . 519

iv Message Reference, Volume 2

About This Guide
The purpose of this book is to list the messages returned by various
components of DB2.

Who Should Use This Guide

The Message Reference is designed to be used by anyone using DB2 and
requiring more detailed information about returned messages.

How This Guide Is Structured

This guide lists all the possible error messages returned by the various
components of DB2.
Organization
This book contains the following sections:
v Chapter 1. Introduction to Messages, describes how to access and interpret
error messages.
v Chapter 2. SQL Messages, describes the messages (SQLCODE values)
generated by the database manager when a warning or error condition is
detected.
v Chapter 3. SQLSTATE Messages, describes the meaning of each SQLSTATE
value.
v Appendix A. Communications Errors, describes communications error codes
associated with sqlcode -30081.
Conventions
The format for date and time, and the characters used as separators for date
and time, are intended for a system configured to use the United States
national language format. These may be different on your display, depending
on the national language format used by your system.

© Copyright IBM Corp. 1993, 2000 v

vi Message Reference, Volume 2
Chapter 1. Introduction to Messages
It is assumed that you are familiar with the functions of the operating system
where DB2 is installed. You can use the information contained in the
following chapters to identify an error or problem and resolve the problem by
using the appropriate recovery action. This information can also be used to
understand where messages are generated and logged.

Information Available Online

The following DB2 messages are accessible from the operating system
command line:
Prefix Description
ASN messages generated by DB2 Replication
CCA messages generated by the Client Configuration Assistant
CLI messages generated by Call Level Interface
DBA messages generated by the Control Center and the Database
Administration Utility
DBI messages generated by installation and configuration
DB2 messages generated by the command line processor
DWC messages generated by the Data Warehouse Center
FLG messages and reason codes generated by the Information Catalog
Manager
GSE messages generated by the DB2 Spatial Extender
SAT messages generated by DB2 Satellite Edition
SPM messages generated by the sync point manager
SQJ messages generated by Embedded SQL in Java (SQLJ)
SQL messages generated by the database manager when a warning or
error condition has been detected.

As well, the message text associated with SQLSTATE values is available

on-line.

Message identifiers consist of a three character message prefix (see above list),
followed by a four or five digit message number. The single digit letter at the
end which describes the severity of the error message is optional.

© Copyright IBM Corp. 1993, 2000 1

 To access help on these error messages, enter the following at the operating
system command prompt:

db2 “? XXXnnnnn”

where XXX represents the message prefix

and where nnnnn represents the message number.

Note: The message identifier accepted as a parameter of the db2 command is

not case sensitive, and the terminating letter is not required.

Therefore, the following commands will produce the same result:

v db2 “? SQL0000N”
v db2 “? sql0000”
v db2 “? SQL0000n”

If the message text is too long for your screen, use the following command
(on unix-based systems and others which support ’more’):

db2 “? XXXnnnnn” | more

Help can also invoked in the interactive input mode. To enter the interactive
input mode, enter the following at the operating system command prompt:

db2

Once in the interactive input mode, you can enter commands at the following
command prompt:

db2 =>

To get DB2 message help in this mode, type the following at the command
prompt:

? XXXnnnnn

Note: If the message text exceeds the length of the screen, users with
non-graphical workstations can pipe the output to the ’more’ (on
unix-based systems) program or redirect the output to a file which can
then be browsed.

The message text associated with a given SQLSTATE value can be retrieved
by issuing:

2 Message Reference, Volume 2

 db2 “? nnnnn”

or

db2 “? nn”

where nnnnn is a five digit SQLSTATE (alphanumeric) and nn is the two digit
SQLSTATE class code (first two digits of the SQLSTATE value).
Other DB2 Messages
Some DB2 components return messages that are not described in this manual,
or online. Some of the message prefixes may include:
AUD messages generated by the DB2 Audit facility.
DIA diagnostics messages generated by many DB2 components. These
messages are written in the diagnostics log file db2diag.log, and are
intended to provide additional information for users and DB2 service
personnel when investigating errors.
GOV messages generated by the DB2 governor utility.

In most cases, these messages provide sufficient information to determine the

cause of the warning or error. For more information on the command or
utility that generated the messages, please refer to the appropriate manual
where the command or utility is documented.
Other Message Sources
When running other programs on the system, you may receive messages with
prefixes other than those mentioned in this reference.

For information on these messages, refer to the publications that you received
for that program product.

Chapter 1. Introduction To Messages 3

4 Message Reference, Volume 2
Chapter 2. SQL Messages
Each message has a message identifier that consists of a prefix (SQL) and a
message number. Messages are listed in numeric sequence based upon the
message number. There are three message types: notification, warning, and
critical. Message identifiers ending with an N are error messages. Those
ending with a W indicate warning or informational messages. Message
identifiers ending with a C indicate critical system errors.

The message number is also referred to as the SQLCODE. The SQLCODE is

passed to the application as a positive or negative number, depending on its
message type (N, W, or C). N and C yield negative values whereas W yields a
positive value. DB2 returns the SQLCODE to the application and the
application can get the message associated with the SQLCODE. DB2 also
returns an SQLSTATE value for conditions that could be the result of an SQL
statement. SQLSTATE values are listed in Chapter 3. SQLSTATE Messages.
Some SQLCODE values have associated SQLSTATE values. SQLSTATE values
associated with a given SQLCODE (if applicable) have been documented with
each message in this chapter.

Variable parameters for SQL messages are shown as descriptive names.

SQL0000 - SQL0099

SQL0000W Statement processing was SQL0001N Binding or precompilation did not

successful. complete successfully.
Explanation: The SQL statement executed Explanation: For reasons specified in the
successfully, unless a warning condition previous messages, the bind or precompile
occurred. request was unsuccessful.
User Response: Check SQLWARN0 to ensure No package is created.
that it is blank. If it is blank, the statement
User Response: Refer to the messages in the
executed successfully. If it is not blank, a
message file. Resubmit the command.
warning condition exists. Check the other
warning indicators to determine the particular If installing the sample database, drop it and
warning condition. For example, if SQLWARN1 install the sample database again.
is not blank, a string was truncated.
Refer to the Application Development Guide. SQL0002N The bind file name is not valid.
sqlcode: 0 Explanation: For reasons specified in the
previous messages, the bind file name cannot be
sqlstate: 00000, 01003, 01004, 01503, 01504, 01506,
used as specified.
1509, 01517

© Copyright IBM Corp. 1993, 2000 5

No package is created.
SQL0007N The character “<character>”
User Response: Refer to the messages in the following “<text>” is not valid.
message file. Resubmit the command.
Explanation: The specified “<character>” is not
If installing the sample database, drop it and a valid character in SQL statements. The “<text>”
install the sample database again. field indicates the 20 characters of the SQL
statement that preceded the character that is not
valid.
SQL0003N The database name is not valid.
Federated system users: some data sources do
Explanation: For reasons specified in the not provide the appropriate values for the
previous messages, the database name cannot be “<character>” and “<text>” message tokens. In
used as specified. these cases, “<character>” and “<text>” will
No package is created. have the following format: “<data
source>:UNKNOWN”, indicating that the actual
User Response: Refer to the messages in the values for the specified data source are
message file. Resubmit the command. unknown.
The statement cannot be processed.
SQL0004N The password is not valid.
User Response: Remove or replace the character
Explanation: The password contains characters that is not valid.
that are not valid or the password is too long.
sqlcode: -7
No package is created.
sqlstate: 42601
User Response: Resubmit the command with a
valid password.
SQL0008N The token “<token>” found in a
host variable declaration is not
SQL0005N The message file name is not valid.
valid.
Explanation: A host variable declaration has
Explanation: For reasons specified in the invalid syntax. The precompiler cannot identify
previous messages, the message file name cannot the host variable.
be used as specified.
The statement cannot be processed. None of the
No package is created. host variables declared in the statement (up to
User Response: Refer to the messages in the the semicolon) are accepted.
message file. Check the name of the message file. User Response: Examine the syntax of the host
Check the attributes of the message file if it variable declaration.
exists. Resubmit the command.

SQL0009W An attempt to override a

SQL0006N The datetime format parameter is precompiler option was ignored.
not valid.
Explanation: An attempt was made to override
Explanation: The value of the datetime format a precompiler option.
parameter is not in the valid range of 0 through
3. The option is ignored.

No package is created. User Response: Ensure that all precompiler

options are specified correctly.
User Response: Resubmit the command with a
valid format parameter.

6 Message Reference, Volume 2

SQL0010N The string constant beginning SQL0013N An empty delimited identifier is
with “<string>” does not have an not valid.
ending string delimiter.
Explanation: During precompilation, either a
Explanation: The statement contains a string cursor name, statement name, database name, or
constant, beginning with “<string>”, that is not authorization ID, specified as an empty string,
terminated properly. was found. This is not valid. The statement
cannot be processed.
The statement cannot be processed.
User Response: Provide a valid cursor name,
User Response: Examine the statement for
statement name, database name, or authorization
missing apostrophes in the indicated string
ID.
constant.
sqlcode: -10
SQL0014N The source file name is not valid.
sqlstate: 42603
Explanation: The source file name specified in
the call to the precompiler contains invalid
SQL0011N The comment is not terminated. characters or the pointer to the source file name
is invalid.
Explanation: The comment is not terminated
properly. No package was created.

The statement cannot be processed. User Response: Ensure that the source file
name is correct.
User Response: Examine the statement for a
missing or extra comment delimiter in the
indicated comment. SQL0015N The host variable data type
″<token_1>″ is not valid. Use
″<token_2>″ instead.
SQL0012W Correlation without qualification
has occurred for the column Explanation: If the WCHARTYPE CONVERT
“<column>”. precompile option is in effect then the graphic
host variable must be declared with the data
Explanation: The named column occurs in a type ’wchar_t’, not ’sqldbchar’.
SELECT statement, is not explicitly qualified, and
occurs in a table specified in the FROM clause of If the WCHARTYPE NOCONVERT precompile
an outer select. Consequently, the reference to the option is in effect (the default) and ’wchar_t’ is
column in the SELECT statement has been taken defined as a 4-byte integer on this platform, then
to be an outer reference and correlation will the graphic host variable must be declared with
occur. the data type ’sqldbchar’, not ’wchar_t’.

The statement was processed under the User Response: Replace the current data type of
assumption that correlation was intended. the host variable with the data type specified in
the message.
User Response: Ensure that correlation was
intended. It is a good practice to explicitly
qualify intended outer references. SQL0020W Bind or precompile option(s)
“<option-name(s)/option-
sqlcode: +12 number(s)>” are not supported by
sqlstate: 01545 the target database and will be
ignored.
Explanation: This warning is returned in the
following situations:

Chapter 2. SQL Messages 7

v one or more options that were specified at 33 OWNER
precompile/bind time are not supported by
34 QUALIFIER
the target DBMS
v the option value(s) of one or more options that 35 TEXT
were specified at precompile/bind time are not 40 VALIDATE
supported by the target DBMS
41 EXPLAIN
The unsupported options/values will be ignored.
The most probable cause is that an option or 42 ACTION
option value which is only supported while
44 REPLVER
connected to a DRDA application server has been
specified while connected to a non-DRDA server. 45 RETAIN
46 RELEASE
Enter ″db2 ? bind″ or ″db2 ? prep″ for a list of
which options are supported only by a DRDA 47 DEGREE
application server.
50 STRDEL
Possible option numbers and their corresponding 51 DECDEL
option names include:
55 CHARSUB
1 DATETIME
56 CCSIDS
2 LANGLEVEL
57 CCSIDM
4 ISOLATION
58 CCSIDG
5 BLOCKING
59 DEC
6 GRANT
60 WCHARTYPE
8 SQLFLAG
61 DYNAMICRULES
16 CONNECT
62 INSERT
17 SQLRULES
63 EXPLSNAP
18 DISCONNECT
64 FUNCPATH
19 SYNCPOINT
65 SQLWARN
20 ISOLATION
66 QUERYOPT
21 BINDFILE
User Response: Ensure the specification of bind
22 SQLCA or precompile “<option-name(s)/option-
number(s)>” was intended while connected to
23 PACKAGE
this DBMS.
24 OPTLEVEL
25 SYNTAX or SQLERROR SQL0021W Invalid precompiler option
“<option>” is ignored.
26 NOLINEMACRO
Explanation: The option specified in the
30 LEVEL message is not a valid precompiler option.
31 COLLECTION The option is ignored.
32 VERSION User Response: Ensure that all precompiler

8 Message Reference, Volume 2

options are specified correctly. provided follows the rules for valid passwords.

SQL0022W Duplicate precompiler option SQL0028C The release number of the bind
“<option>” is ignored. file is not valid.
Explanation: The precompiler option Explanation: The release number of the bind
“<option>” is a duplicate. file is not compatible with the release number of
the installed version of the database manager.
The option is ignored.
The bind file cannot be used with the current
User Response: Ensure that all precompiler
version of the database manager. The command
options are specified only once.
cannot be processed.
User Response: If possible, repeat the
SQL0023N The database name is not valid.
precompile process with the current database
Explanation: The specified database name is not manager. Otherwise, use only bind files created
a valid name. with a compatible release level of the database
manager.
Precompilation is terminated.
User Response: Ensure that the database name SQL0029N INTO clause required.
is spelled correctly and follows the rules for
short identifiers. Explanation: Non-cursor SELECT or VALUES
statements embedded in an application program
must have an INTO clause to denote where the
SQL0024N A database name was not results of the statement are to be placed.
specified. Dynamic SELECT statements do not permit the
Explanation: No database name was provided INTO clause.
to proceed with precompilation. User Response: Add the INTO clause to the
Precompilation is terminated. SELECT or VALUES statement and precompile
the application program again.
User Response: Provide a database name.
sqlcode: -29

SQL0025W Binding or precompilation sqlstate: 42601

completed with warnings.
Explanation: Binding or precompilation SQL0030N A source file name was not
succeeded, but warnings were issued. A package specified.
and/or bindfile was created as requested in the Explanation: A source file name was not
command. provided to proceed with precompilation.
User Response: Refer to the messages in the Precompilation is terminated.
message file. If necessary, correct the problems
and resubmit the command. User Response: Specify a source file name.

SQL0026N The password is not valid. SQL0031C File “<name>” could not be
opened.
Explanation: The specified password is not a
valid password. Explanation: The file “<name>” is required but
could not be opened.
Precompilation is terminated.
Precompilation is terminated.
User Response: Ensure that the password

Chapter 2. SQL Messages 9

User Response: Ensure that the file name correct extension for the language being used. If
specified is correct and exists in the file system, the file is input to the binder, it must have an
and that the file permissions are correct. extension of .bnd. Also, a fully resolved file name
which is over the platform maximum length will
If installing the sample database, drop it and
cause this error.
install the sample database again. If the error
continues, reinstall the database manager and Precompilation or binding is terminated.
then install the sample database.
User Response: Ensure that the specified file
name is correct.
SQL0032C Unable to use file “<name>”.
Explanation: While reading or writing file SQL0037W The syntax of the message file
“<name>”, an error was encountered. “<name>” is not valid.
Precompilation is terminated. Explanation: The message file name “<name>”
is not syntactically correct for this function.
User Response: Retry the precompilation.
The system redirects the output to the standard
output device.
SQL0033N “<name>” is not a valid bind file.
User Response: Ensure that the specified file
Explanation: The bind file “<name>” specified
name is correct.
is not a bind file.
Binding is terminated.
SQL0038W The bind option SQLERROR
User Response: Ensure that the correct file CONTINUE has been activated
name was specified. since it is required when binding
this DB2-supplied list file to
DB2/MVS, SQL/DS, or OS/400.
SQL0034N A bind file name was not
specified. Explanation: The SQLERROR CONTINUE bind
option is required when binding the following
Explanation: No bind file name was specified to DB2-supplied list files:
proceed with binding.
v ddcsmvs.lst
Binding is terminated. v ddcsvm.lst
User Response: Provide a bind file name. v ddcsvse.lst
v ddcs400.lst
SQL0035N The file “<name>” cannot be This option instructs a DRDA server to create a
opened. package even if there are SQL statements in a
Explanation: The message file “<name>” could bind file which it considers invalid. Since not all
not be opened. of the DRDA servers support all of the SQL
statements contained in the DB2-supplied bind
Binding or precompilation has been terminated. files, the SQLERROR CONTINUE bind option
User Response: Ensure that the system can must be used to guarantee that packages are
access the file. created for all of the bind files in the list file.
User Response: No response is necessary. The
SQL0036N The syntax of the file name required bind option, SQLERROR CONTINUE,
“<name>” is not valid. has been specified for you. To avoid receiving
this warning in the future specify the
Explanation: If the file is input to the SQLERROR CONTINUE bind option.
precompiler, it must have an extension with the

10 Message Reference, Volume 2

 specified bind file in the list. Note that the digit
SQL0039N The binder did not finish
used to identify the bind file indicates the
processing because the bind file is
relative position of the file in the list file.
not valid.
User Response: Refer to the other messages
Explanation: The binder could not process the
which accompanied this one to resolve the errors
bind file. The bind file may not be valid because
which occurred. Resubmit the command.
the bind file contents were altered accidentally.
The bind file is not processed.
SQL0051N The maximum number of SQL
User Response: If possible, repeat the statements was exceeded in the
precompile process to create a new bind file. program.
Otherwise, obtain a new copy of the bind file.
Explanation: Too many SQL statements are in
the program to fit into one package in the
SQL0040N An error occurred on one or more database.
bind files in the list “<name>”.
Precompilation is terminated.
The following files were not
bound: “<list>”. User Response: Either simplify the program, or
split the program into smaller, separate
Explanation: For reasons specified in the
programs, or do both.
previous messages in the message file, one or
more bind files were not bound. The list of files
that were not bound is composed of digits, SQL0053W No SQL statements were found in
starting from 1, that indicate the relative position the program.
of the unbound files in the list file. “<name>”
does not include the path specification of the list Explanation: The specified source file contains
file. no SQL statements.

Only the first 20 bind files in error are listed in If binding, an empty package is created.
the message. If there were more than 20 bind User Response: Ensure that you are
files in error, ellipses (...) are inserted after the precompiling or binding the correct program.
last bind file name in the list.
One or more packages were not created. SQL0055N Source input file is empty.
User Response: Refer to the messages in the Explanation: The program source input file
message file. Check the list file to verify that it contained no data.
contains valid names. Resubmit the command.
Precompilation is terminated.

SQL0041N No attempt was made to bind the User Response: Ensure that the correct input
files following file number file was specified.
″<number>″ in list ″<name>″
because a fatal error occurred SQL0056N An SQLSTATE or SQLCODE
which terminated processing. variable declaration is in a nested
Explanation: Some errors encountered during compound statement.
the binding process are considered fatal (i.e. Explanation: An SQLSTATE or SQLCODE
system errors, memory errors). If one of these variable declaration is in a nested compound
errors occurs while processing a file in a list file, statement instead of the outermost compound
processing terminates. No attempt is made to statement in the SQL routine.
bind the remaining files in the list file.
The statement cannot be processed.
Such an error occurred while binding the

Chapter 2. SQL Messages 11

User Response: Declare the SQLSTATE and
SQL0061W The binder is in progress.
SQLCODE variables only in the outermost
compound statement of the SQL routine. Explanation: This message is written to the
standard output device when the binder begins
sqlcode: -56
processing.
sqlstate: 42630
Processing continues.
User Response: No action is required.
SQL0057N A RETURN statement in an SQL
function or method must include
a return value. SQL0062W Starting INCLUDE of file
″<name>″.
Explanation: A RETURN statement is specified
in the SQL function or method without Explanation: An INCLUDE statement has been
specifying a value to return. encountered. The precompiler is now processing
the INCLUDE file.
The statement cannot be processed.
User Response: No action is required.
User Response: Specify a value on the RETURN
statement.
SQL0063W Completed INCLUDE of file
sqlcode: -57
″<name>″.
sqlstate: 42631
Explanation: The precompiler has completed
processing the INCLUDE file. It will resume
SQL0058N The data type of the RETURN processing the file which contained the
statement value in an SQL INCLUDE statement.
procedure must be INTEGER.
User Response: No action is required.
Explanation: A RETURN statement is specified
in the SQL procedure with a value or expression
SQL0064N File ″<name>″ directly or
that is not of the INTEGER data type.
indirectly INCLUDEs itself.
The statement cannot be processed.
Explanation: A cyclic INCLUDE has been
User Response: Specify a value on the RETURN encountered. A precompiler input file cannot
statement that has a data type of INTEGER. INCLUDE itself, nor be INCLUDEd by a file it
INCLUDEs.
sqlcode: -58
The specified file is not INCLUDEd.
sqlstate: 428F2
User Response: Check the nesting of the
INCLUDE files, and remove any cycles.
SQL0060W The “<name>” precompiler is in
progress.
SQL0065N An unexpected end-of-line was
Explanation: This message is written to the encountered in a host variable
standard output device when the precompiler declaration.
begins processing. The token “<name>” refers to
the particular language precompiler which was Explanation: A host variable declaration has an
invoked. invalid syntax. An end-of-line was encountered
before the declaration was complete.
Processing continues.
The statement cannot be processed.
User Response: No action is required.

12 Message Reference, Volume 2

User Response: Examine the syntax of the host was returned from the database manager.
variable declaration.
The statement cannot be processed.
User Response: Inspect the SQLCODE to
SQL0078N Parameter names must be
determine the problem and take the appropriate
specified for routine
action.
“<routine-name>”.
Explanation: The routine “<routine-name>”
SQL0082C An error has occurred which has
does not have parameter names specified for all
terminated processing.
parameters. When the routine is defined with
LANGUAGE SQL or SQLMACRO a parameter Explanation: A previous, non-SQL error has
name is required for each parameter defined. caused processing to terminate.
The statement cannot be processed. Precompile/bind/rebind is terminated. No
package was created.
User Response: Ensure that each defined
parameter includes a parameter name. User Response: Correct the situation that
caused the previous error and retry the
sqlcode: -78
operation.
sqlstate: 42629
SQL0083C A memory allocation error has
SQL0079N Schema name for DECLARE occurred.
GLOBAL TEMPORARY TABLE
Explanation: During processing, there was not
“<name>” must be SESSION, not
enough memory to continue processing.
“<schema-name>”.
User Response: Possible solutions include:
Explanation: The schema name for a declared
temporary table must be SESSION. The v Ensure that your system has sufficient real and
DECLARE GLOBAL TEMPORARY TABLE virtual memory.
statement defines a new declared temporary v Remove background processes.
table named “<name>” with an explicit
schema-name of “<schema-name>”. This is not
allowed. SQL0084N An EXECUTE IMMEDIATE
statement contains a SELECT or
The statement cannot be processed. VALUES statement.
User Response: Change the statement in one of Explanation: A SELECT or VALUES statement
the following ways: was used in an EXECUTE IMMEDIATE
v Change the schema name to SESSION. statement.
v Remove the schema name and let DB2 use the The statement cannot be processed.
default value, SESSION.
User Response: The implied function is not
sqlcode: -79 supported. Prepare the SELECT or VALUES
statement. Then use OPEN, FETCH, and CLOSE.
sqlstate: 428EK
sqlcode: -84
sqlstate: 42612
SQL0081N SQLCODE “<sqlcode>” returned
during precompilation/bind.
Explanation: While precompiling or binding the
program, an unexpected SQLCODE “<sqlcode>”

Chapter 2. SQL Messages 13

 further, or rename it if it is already fully
SQL0085N The statement name “<name>” is
qualified.
already defined.
Explanation: A previous DECLARE statement
SQL0089N Processing ended after 100 errors
already used the statement name specified in the
were found.
current DECLARE statement.
Explanation: The precompiler or binder quits
The current DECLARE statement is not
processing after 100 errors were found.
processed. The previous DECLARE statement
retains use of the statement name. User Response: Fix the errors indicated in the
message log and resubmit the command.
User Response: Use a different name for the
statement.
SQL0091W Precompilation or binding was
ended with “<number-1>” errors
SQL0086C A memory allocation error has
and “<number-2>” warnings.
occurred.
Explanation: The precompilation or binding has
Explanation: During processing, there was not
terminated with the stated number of warnings
enough memory to continue processing.
and errors.
User Response: Possible solutions include:
Precompilation or binding is terminated.
v Verify that your system has the required
memory. User Response: If warnings or errors occurred,
correct the program, if necessary, and retry the
v Remove background processes.
precompilation or binding.

SQL0087N Host variable ″<name>″ is a

SQL0092N No package was created because
structure used where structure
of previous errors.
references are not permitted.
Explanation: Because of previous errors, no
Explanation: When a structure reference is used
package was created.
in an SQL statement, it is treated as if a
comma-separated list of its component fields had User Response: Correct the errors and retry the
been used instead. Since a list of host variables is precompilation or bind.
not permitted in SQL statements such as
PREPARE, neither is a reference to a structure
with multiple fields. SQL0093N The end-of-input was encountered
before the statement terminator
User Response: Replace the structure reference for EXEC SQL.
with an atomic host variable, or with a fully
qualified structure field name. Explanation: While processing an SQL
statement, the end of source was encountered
before the statement terminated.
SQL0088N Host variable “<name>” is
ambiguous. Precompilation is terminated.

Explanation: Host variable “<name>” cannot be User Response: Ensure that the SQL statement
uniquely identified. More than one host variable terminates properly.
with the same qualification can be found.
The statement cannot be processed.
User Response: Qualify the host variable

14 Message Reference, Volume 2

SQL0094N Binding was ended because of SQL0097N Variables or parameters of LONG
user interrupt request. VARCHAR or LONG
VARGRAPHIC data types are not
Explanation: Binding was terminated because
supported in SQL routines.
the user may have pressed the interrupt key
sequence. Explanation: SQL routines (procedures,
functions or methods) do not support variables
Processing is terminated. No package is created.
or parameters of LONG VARCHAR or LONG
User Response: Resubmit the bind, if needed. VARGRAPHIC data types.

If installing the sample database, drop it and User Response: Do not use variables or
install the sample database again. parameters of LONG VARCHAR or LONG
VARGRAPHIC data types in SQL routines. For
LONG VARCHAR, use VARCHAR with an
SQL0095N No bind file was created because explicit length. For LONG VARGRAPHIC, use
of previous errors. VARGRAPHIC with an explicit length.
Explanation: Because of previous errors, no sqlcode: -97
bind file was created.
sqlstate: 42601
No bind file is created.
User Response: Correct the errors and retry the
precompilation.

SQL0100 - SQL0199

SQL0100W No row was found for FETCH, SQL0101N The statement is too long or too
UPDATE or DELETE; or the result complex.
of a query is an empty table.
Explanation: The statement could not be
Explanation: One of the following conditions is processed because it exceeds a system limit for
true: either length or complexity, or because too many
v No row was found that meets the search constraints or triggers are involved.
conditions specified in an UPDATE or If the statement is one that creates or modifies a
DELETE statement. packed description, the new packed description
v The result of a SELECT statement was an may be too large for its corresponding column in
empty table. the system catalogs.
v A FETCH statement was executed when the Federated system users should also check to see
cursor was positioned after the last row of the if the statement:
result table.
v Exceeds either a federated server system limit
v The result of the SELECT used in an INSERT or a data source system limit for length or
statement is empty. complexity.
No data was retrieved, updated, or deleted. v Violates some other data source specific limit.
User Response: No action is required. The statement cannot be processed.
Processing can continue.
Note: Where character data conversions are
sqlcode: +100
performed for applications and databases
sqlstate: 02000

Chapter 2. SQL Messages 15

 running under different codepages, the a pass-through session. For example, a
result of the conversion is exceeding the character literal larger than 254 bytes included
length limit. in a statement sent to DB2 for MVS/ESA in a
pass-through session would cause this error.
User Response: Either:
v Break the statement up into shorter or less It may be that data conversion is occurring and
complex SQL statements. the resultant string is too long. For connections
between applications and databases running
v Increase the size of the statement heap
under different codepages, string constants are
(stmtheap) in the database configuration file.
converted from the application codepage to the
v Reduce the number of check or referential database codepage. In certain situations, graphic
constraints involved in the statement or reduce string constants may be further converted from
the number of indexes on foreign keys. the database codepage to a UCS-2 (UNICODE)
v Reduce the number of triggers involved in the encoding, for example when the database has
statement. been created with an EUC codepage. This means
v Federated system users: determine which data that it is possible to have a resultant string which
source is failing the statement (see the problem is longer than the input string.
determination guide for procedures to follow
to identify the failing data source) and The statement cannot be processed.
determine the cause of the rejection. If the User Response: For Comment on Table or
rejection is coming from the federated server, Comment on Column, reduce the size of the
increase the size of the statement heap comment. For the SQL CONNECT statement,
(stmtheap) in the database configuration file. reduce the length of the application server name.
sqlcode: -101 For other string constants, the requested function
is not available interactively. For an error
sqlstate: 54001 occurring in the context of a non-CONNECT
SQL statement embedded in an application
program, assign the long string to a host variable
SQL0102N The string constant beginning and substitute that variable for the string literal
with “<string>” is too long. in the SQL statement.
Explanation: One of the following has occurred: Federated system users: for a pass-through
v The comment in the COMMENT ON session, determine what data source is causing
statement is greater than 254 bytes. the error (see the problem determination guide
for the failing data sources). Examine the SQL
v The application server name specified in the
dialect for that data source to determine which
SQL CONNECT statement is greater than 18
specific limit has been exceeded, and adjust the
characters.
failing statement as needed.
v The string constant beginning with ″<string>″
has a length greater than 32672 bytes. sqlcode: -102
Character strings with lengths greater than sqlstate: 54002
32672 bytes or graphic strings with lengths
greater than 16336 characters can be specified
only through assignment from host variables. SQL0103N The numeric literal “<literal>” is
Note that other servers in the DB2 family of not valid.
products may specify a different size limit for
Explanation: The indicated “<literal>” begins
character strings. Consult the documentation
with a digit but is not a valid integer, decimal, or
for the appropriate DB2 product for details.
floating point literal.
v Federated system users: the data
source-specific limits must not be exceeded in Federated system users: a data source-specific

16 Message Reference, Volume 2

literal representation error has occurred in a paired delimiters, and an even number of bytes
pass-through session. within the string.
The statement cannot be processed. Federated system users, see the problem
determination guide to determine which data
User Response: Correct the invalid numeric
source is causing the error.
literal. Federated system users, if the error
occurred in a pass-through session, determine sqlcode: -105
what data source is causing the error (see the
sqlstate: 42604
problem determination guide for the failing data
sources). Examine the SQL dialect for that data
source to determine which literal representation SQL0106N SQL statement begins properly
rule has been violated, and adjust the failing but is incomplete.
statement as needed.
Explanation: The SQL statement was correct up
sqlcode: -103 to the point where no more input was found.
This may be caused by failure to properly end a
sqlstate: 42604
literal. String literals need a final quote mark.
Processing of this SQL statement has ended.
SQL0104N An unexpected token “<token>”
was found following “<text>”. User Response: Check that the statement has all
Expected tokens may include: the necessary parts to complete the desired
“<token-list>”. function and that all clauses are complete.
Explanation: A syntax error in the SQL For PL/I: Check that the SQL statement is
statement was detected at the specified token complete before the semicolon. For Assembler:
following the text “<text>”. The “<text>” field Check that the continuation rules are properly
indicates the 20 characters of the SQL statement followed. (A nonblank character must be in
that preceded the token that is not valid. column 72, and continued lines must start in
column 16 or beyond.)
As an aid to the programmer, a partial list of
valid tokens is provided in the SQLERRM field For COBOL: Check that the SQL statement is
of the SQLCA as “<token-list>”. This list complete before END-EXEC.
assumes the statement is correct to that point.
sqlcode: -106
The statement cannot be processed.
sqlstate: 42601, 42603
User Response: Examine and correct the
statement in the area of the specified token.
SQL0107N The name “<name>” is too long.
sqlcode: -104 The maximum length is
“<length>”.
sqlstate: 42601
Explanation: The name returned as ″<name>″ is
too long. The maximum length permitted for
SQL0105N The string constant beginning
names of that type is indicated by ″<length>″.
with “<string>” is not valid.
The names for indexes and constraints can be a
Explanation: The statement contains a string
maximum length of 18 bytes. The names for
constant beginning with “<string>” that is not
columns can be a maximum length of 30 bytes.
valid.
The names for savepoints, tables, views and
The statement cannot be processed. aliases can be a maximum length of 128 bytes.
(This does not include any escape characters, if
User Response: Specify the correct format of
present.)
the string constant. Check for graphic string,

Chapter 2. SQL Messages 17

A maximum of 30 bytes is permitted for a A column name is qualified with a table name,
schema name (object qualifier), with the which is either qualified or unqualified, or a
exception of user-defined types, which allow a correlation name. In some contexts, a column
maximum of 8 bytes for a schema name. name requires a table name qualifier.
Host variable names must not exceed 30 bytes in The statement cannot be processed.
length.
User Response: Ensure that the name for the
For the SQL CONNECT statement, an object is qualified correctly.
application server name of up to 18 characters in
sqlcode: -108
length will be accepted at pre-compilation time.
However, at runtime, an application server name sqlstate: 42601
which is greater than 8 characters in length will
cause an error.
SQL0109N The “<clause>” clause is not
Also, a password of up to 18 characters in length allowed.
and an authorization ID of up to 8 characters in
length will be accepted in the SQL CONNECT Explanation: The indicated clause is not
statement. allowed in the context where it appears in the
SQL statement.
Federated system users: if in a pass-through
session, a data source-specific limit might have A subquery, an INSERT statement, or a CREATE
been exceeded. VIEW statement cannot have INTO, ORDER BY,
or FOR UPDATE clauses. An embedded SELECT
The statement cannot be processed. statement cannot have ORDER BY or FOR
UPDATE clauses. An embedded SELECT
Note: Where character data conversions are statement cannot contain a set operator except in
performed for applications and databases a subquery. SELECT or VALUES statements used
running under different codepages, the in cursor declarations cannot have an INTO
result of the conversion is exceeding the clause. A RAISE_ERROR function can only be
length limit. used as a select list item if it is cast to some data
type using the CAST specification.
User Response: Choose a shorter name or
correct the spelling of the object name. Federated system users: In a pass-through
session, a data source-specific restriction might
Federated system users: for a pass-through
have been violated.
session, determine what data source is causing
the error (see the problem determination guide The statement cannot be processed.
for the failing data sources). Examine the SQL
User Response: Correct the SQL statement by
dialect for that data source to determine which
removing the clause.
specific limit has been exceeded, and adjust the
failing statement as needed. Federated system users: For a pass-through
session, determine what data source is causing
sqlcode: -107
the error (see the problem determination guide
sqlstate: 42622 for the failing data sources). Examine the SQL
dialect for that data source to determine which
specific restriction has been violated, and adjust
SQL0108N The name “<name>” has the
the failing statement as needed.
wrong number of qualifiers.
sqlcode: -109
Explanation: The name “<name>” is improperly
qualified. sqlstate: 42601
The object given the name “<name>” can only
have one qualifier.

18 Message Reference, Volume 2

 In a SELECT list, the operand of an arithmetic
SQL0110N “<string>” is an invalid
operator cannot be a column function that
hexadecimal constant.
includes the DISTINCT keyword.
Explanation: The hexadecimal constant
“<string>” is invalid. The problem is one of the The statement cannot be processed.
following:
User Response: Correct the use of the column
v An invalid hexadecimal digit was specified. function to eliminate the invalid expression and
Only ’0 to 9’, ’A to F’, and ’a to f’ are allowed. try again.
v An uneven number of hexadecimal digits was
specified. sqlcode: -112

v More than 8000 hexadecimal digits were sqlstate: 42607

specified.
User Response: Correct the constant and SQL0113N “<identifier>” contains a character
resubmit the statement. that is not allowed or does not
contain any characters.
sqlcode: -110
Explanation: An SQL-variable-name,
sqlstate: 42606 parameter-name or condition-name
“<identifier>” contains an invalid character. Only
SQL0111N The column function “<name>” characters that are valid for an SQL ordinary
does not include a column name. identifier are allowed. Note that because the
identifier is delimited, folding is not performed
Explanation: The specification of the column and uppercase and lowercase letters are treated
function “<name>” (AVG, MIN, MAX, SUM, or as distinct from each other.
COUNT(DISTINCT)) was not specified correctly
because such functions must include a column User Response: Correct the identifier and
name in the operand. resubmit the statement.

The statement cannot be processed. sqlcode: -113

User Response: Specify a column name in the sqlstate: 42601

expression that is the operand to the column
function. SQL0117N The number of values assigned is
NOTE: This error is only applicable to releases of not the same as the number of
DB2 prior to Version 2. specified or implied columns.

sqlcode: -111 Explanation:

v The number of insert values in the value list of
sqlstate: 42901
the INSERT statement is not the same as the
number of columns specified or implied. If no
SQL0112N The operand of the column column list is specified, a column list that
function “<name>” includes a includes all columns of the table or view is
column function, a scalar implied.
fullselect, or a subquery. v The number of values on the right hand side
Explanation: The operand of a column function of an assignment in a SET transition-variable
cannot include a: statement or SET clause of an UPDATE
statement does not match the number of
v column function
columns on the left hand side.
v scalar fullselect
The statement cannot be processed.
v subquery.

Chapter 2. SQL Messages 19

User Response: Correct the statement to specify HAVING clause, or ORDER BY clause but
one value for each of the specified or implied there is no GROUP BY clause
columns. v The identified expression is contained in the
sqlcode: -117 SELECT clause, HAVING CLAUSE, or ORDER
BY clause but is not in the GROUP BY clause.
sqlstate: 42802
The identified expression is an expression that
starts with “<expression-start>”. The expression
SQL0118N The table or view that is the may be a single column name.
target of the INSERT, DELETE, or
UPDATE statement is also If the NODENUMBER or PARTITION functions
specified in a FROM clause. are specified in the HAVING clause, then all
Explanation: The table or view specified as the partitioning key columns of the underlying table
target of an INSERT, DELETE, or UPDATE are considered to be in the HAVING clause.
statement also appears in the FROM clause of a
subquery within the statement. The statement cannot be processed.

The table or view that is the target of an INSERT, User Response: Correct the statement by
UPDATE, or DELETE cannot also be used to including the expression in the GROUP BY
supply the values to be inserted or to qualify the clause that are in the SELECT clause, HAVING
rows to be inserted, updated, or deleted. clause, or ORDER BY clause or by removing the
column function from the SELECT statement.
The statement cannot be processed.
sqlcode: -119
This message is only applicable to Version 1.2
servers and earlier, and hosts accessed through sqlstate: 42803
DB2 Connect.
User Response: The implied function is not SQL0120N A WHERE clause, GROUP BY
supported. To attempt to obtain the desired clause, SET clause, or SET
result, create a temporary copy of the object table transition-variable statement
or view and address the subselect to that copy. contains a column function.

sqlcode: -118 Explanation: A WHERE clause can contain a

column function only if that clause appears
sqlstate: 42902 within a subquery of a HAVING clause and the
argument of the column function is a correlated
SQL0119N An expression starting with reference to a group. A GROUP BY clause can
“<expression-start>” specified in a contain a column function only if the argument
SELECT clause, HAVING clause, of the column function is a correlated reference
or ORDER BY clause is not to a column in a different subselect than the one
specified in the GROUP BY containing the GROUP BY clause. A SET clause
clause or it is in a SELECT clause, of an UPDATE statement or a SET
HAVING clause, or ORDER BY transition-variable statement can only include a
clause with a column function column function within a fullselect on the right
and no GROUP BY clause is hand side of an assignment.
specified. The statement cannot be processed.
Explanation: The SELECT statement has one of User Response: Change the statement so that
the following errors: the column function is not used or used only
v The identified expression and a column where it is supported.
function are contained in the SELECT clause,
sqlcode: -120

20 Message Reference, Volume 2

sqlstate: 42903 The statement cannot be processed.
User Response: Correct the statement by
SQL0121N The column “<name>” is including the columns in the GROUP BY clause
specified more than once in the that are in the SELECT clause or by removing
INSERT, UPDATE or SET the columns from the SELECT clause.
transition-variable statement.
sqlcode: -122
Explanation: The same column “<name>” is
sqlstate: 42803
specified more than once in the list of columns of
an INSERT statement, the left hand side of
assignments in the SET clause of an UPDATE SQL0123N The parameter in position ″<n>″
statement, or the left hand side of assignments in in the function ″<name>″ must be
the SET transition-variable statement. Note that a constant or a keyword.
this error may occur when updating or inserting
into a view where more than one column of the Explanation: The parameter in position ″<n>″ in
view is based on the same column of a base the function ″<name>″ is not a constant when it
table. is required to be a constant or a keyword when it
is required to be a keyword.
The statement cannot be processed.
User Response: Ensure that each argument of
User Response: Correct the syntax of the the function conforms to the definition of the
statement so each column name is specified only corresponding parameter.
once.
sqlcode: -123
sqlcode: -121
sqlstate: 42601
sqlstate: 42701

SQL0125N The column number in the

SQL0122N A SELECT statement with no ORDER BY clause is either less
GROUP BY clause contains a than one or greater than the
column name and a column number of columns in the result
function in the SELECT clause, or table.
a column name is contained in the
SELECT clause but not in the Explanation: The ORDER BY clause in the
GROUP BY clause. statement contains a column number that is
either less than 1 or greater than the number of
Explanation: The SELECT statement has one of columns in the result table (the number of items
the following errors: in the SELECT clause).
v A column name and a column function are The statement cannot be processed.
contained in the SELECT clause but there is no
GROUP BY clause. User Response: Correct the syntax of the
v A column name is contained in the SELECT ORDER BY clause so each column identifier
clause but not in the GROUP BY clause. properly identifies a column of the result table.

The column may be contained in a scalar sqlcode: -125

function. sqlstate: 42805

If the NODENUMBER or PARTITION functions

are specified in the SELECT clause, then all
partitioning key columns of the underlying table
are considered to be in the SELECT clause.

Chapter 2. SQL Messages 21

 User Response: Correct the pattern string or the
SQL0127N DISTINCT is specified more than
escape character accordingly.
once.
sqlcode: -130
Explanation: The DISTINCT qualifier cannot be
used: sqlstate: 22019, 22025
v In both the SELECT clause and a column
function SQL0131N The operands of a LIKE predicate
v In two or more column functions in the same have incompatible data types.
SELECT statement.
Explanation: If the expression to the left of a
The statement cannot be processed. LIKE or NOT LIKE is of type character, the
expression to the right must be of type character.
User Response: This error is only applicable to
releases of DB2 prior to DB2 Version 2 and hosts If the expression to the left is of type graphic, the
accessed through DB2 Connect. expression to the right must be of type graphic.
sqlcode: -127 If the expression to the left is of type BLOB, the
expression to the right must be of type BLOB.
sqlstate: 42905
The statement cannot be processed.
SQL0129N The statement contains too many User Response: Correct the expressions of the
table names (the maximum is 15). LIKE predicate to be the same data type.
Explanation: The SQL statement contains too sqlcode: -131
many table names. A single SQL statement can
reference up to 15 tables. Each table in any view sqlstate: 42818
referenced is included in this limit.
The statement cannot be processed. SQL0132N A LIKE predicate or POSSTR
scalar function is not valid
User Response: Break the SQL statement into because the first operand is not a
two or more simple statements with 15 or fewer string expression or the second
table references. operand is not a string.
This message is only applicable to Version 1.2 Explanation: A LIKE predicate or POSSTR
servers and earlier, and hosts accessed through scalar function appearing in the statement is not
DB2 Connect. valid because either the first operand is not a
string expression or the second operand is not a
sqlcode: -129
string.
sqlstate: 54004
The operand appearing to the left of a LIKE or
NOT LIKE predicate or the first operand of
SQL0130N The ESCAPE clause is not a single POSSTR must be a string expression. The value
character, or the pattern string appearing to the right of the predicate or the
contains an invalid occurrence of second operand of POSSTR can be one of:
the escape character. v a constant
Explanation: The escape character must be a v a special register
single character no more than two bytes in v a host variable
length. It can only appear in the pattern string if
v a scalar function whose operands are any of
it is followed by itself, a percent sign, or an
the above
underscore. For more information about the
ESCAPE clause on the LIKE predicate, refer to v an expression concatenating any of the above
the SQL Reference.

22 Message Reference, Volume 2

with the restrictions that: v The value expression of a SET clause in an
v no element in the expression can be of type UPDATE statement unless the expression is a
LONG VARCHAR, CLOB, LONG LONG VARCHAR or LONG VARGRAPHIC
VARGRAPHIC, or DBCLOB. In addition it host variable
cannot be a BLOB file reference variable. v A SELECT statement of a set operator (except
v the actual length of the expression cannot be UNION ALL)
more than 4000 bytes. v VARGRAPHIC scalar function.
A LIKE predicate or POSSTR scalar function Federated system users: in a pass-through
cannot be used with DATE, TIME, or session, a data source-specific restriction can
TIMESTAMP. cause this error. See the SQL Reference
documentation for the failing data sources.
The statement cannot be processed.
The statement cannot be processed.
User Response: Check and correct the syntax of
LIKE and POSSTR User Response: The requested operation on the
string is not supported.
sqlcode: -132
sqlstate: 42824 Note: If it is unclear as to how the 255 byte limit
is being exceeded, consider that codepage
conversion operations may be required to
SQL0134N Improper use of a string column,
evaluate the string expression. Depending
host variable, constant, or
on the source and target codepages, the
function “<name>”.
target may have a greater length attribute
Explanation: The use of the string “<name>” is than the source. For more information,
not permitted. refer to the SQL Reference for discussions
on string restrictions and string
An expression resulting in a string data type conversions.
with a maximum length greater than 255 bytes is
not permitted in:
sqlcode: -134
v A SELECT DISTINCT statement
v A GROUP BY clause sqlstate: 42907
v An ORDER BY clause
v A column function with DISTINCT SQL0135N The input for a long string
v A SELECT or VALUES statement of a set column in an INSERT statement
operator other than UNION ALL. or UPDATE statement must be
from a host variable or be the
An expression resulting in a LONG VARCHAR keyword NULL.
or LONG VARGRAPHIC data type is not
permitted in: Explanation: The UPDATE or INSERT is using
constants, column names, or subqueries where it
v A predicate other than EXISTS or NULL
should be using NULL or a host variable.
v A column function
A long string column is either a LONG
v The SELECT clause of a subquery of a
VARCHAR, LONG VARGRAPHIC,
predicate other than EXISTS or NULL
VARCHAR(n) where n is greater than 254 but
v The SELECT clause of a subselect in an less than or equal to 32767, or VARGRAPHIC(n)
INSERT statement where n is greater than 127 but less than or equal
to 16383.
User Response: Refer to the DB2 for VM

Chapter 2. SQL Messages 23

Application Programming manual for The statement cannot be processed.
information on the use of long strings. Correct
User Response: Ensure that the second and
the statement. Try again.
third arguments of the SUBSTR function have
sqlcode: -135 values that conform to the above rules.
sqlstate: 56033 sqlcode: -138
sqlstate: 22011
SQL0137N The length resulting from
″<operation>″ is greater than
SQL0139W A redundant clause appears in the
″<maximum value>″.
specification for column
Explanation: The result of concatenating the “<column>”.
given operands was longer than what is
Explanation: The clause in the column
supported by the result type.
specification is redundant.
Character string results are limited to 32,700
The statement was processed successfully, but
bytes unless one of the operands is a CLOB and
the redundant clause was ignored.
then the limit is 2 gigabytes.
User Response: Correct the column
Graphic string results are limited to 16,350
specification.
characters unless one of the operands is a
DBCLOB and then the limit is 1,073,741,823 (1 sqlcode: +139
less than 1 gigabyte) double byte characters.
sqlstate: 01589
Binary string results (operands are BLOB) are
limited to 2 gigabytes.
SQL0142N The SQL statement is not
User Response: Ensure that the sum of the supported.
lengths of the operands does not exceed the
supported maximum and try the operation again. Explanation: An embedded SQL statement that
may be valid for other IBM relational database
sqlcode: -137 products is not supported by the database
manager.
sqlstate: 54006
Federated system users: check to see if an SQL
statement was directed at a data source that does
SQL0138N The second or third argument of
not support the SQL statement.
the SUBSTR function is out of
range. The statement cannot be processed.
Explanation: One of the following conditions User Response: Change the syntax of the SQL
occurred: statement or remove the statement from the
v The second argument of the SUBSTR function program.
is less than 1 or greater than M. Federated system users: if the reason is
v The third argument of the SUBSTR function is unknown, isolate the problem to the data source
an expression with a value less than 0 or failing the request (see the problem
greater than M−N+1. determination guide for procedures to follow to
identify the failing data source) and examine the
M is the length of the first argument if it is fixed
SQL dialect for that data source.
length or the maximum length of the first
argument if it is varying length. N is the value of
the second argument.

24 Message Reference, Volume 2

 Note that these conditions do not apply to
SQL0143W The SQL statement is not
subqueries of the SELECT statement.
supported; invalid syntax is
ignored.
You cannot insert rows directly into a typed table
Explanation: An embedded SQL statement that defined on a not instantiable structured type.
may be valid for other IBM relational database Subtables of this table may allow inserts.
products is understood but is not supported by
the database manager. Summary tables do not allow the insert, update
The statement may produce inconsistent or or delete operations.
unwanted results.
The statement cannot be processed.
User Response: Change the syntax of the SQL
statement or remove the statement from the User Response: The requested function cannot
program. be performed on the view or summary table.
Federated system users: if the reason is
SQL0150N The view, typed table, or unknown, isolate the problem to the data source
summary table in the INSERT, failing the request (see the problem
DELETE, or UPDATE statement is determination guide for procedures to follow to
a view, typed table, or summary identify the failing data source) and examine the
table for which the requested object definition and the update restrictions for
operation is not permitted. that data source.

Explanation: The view, typed table, or summary sqlcode: -150

table named in the INSERT, UPDATE, or sqlstate: 42807
DELETE statement is defined so that the
requested insert, update, or delete operation
cannot be performed. SQL0151N The column “<name>” cannot be
updated.
A view is read only if the SELECT statement
contains any of the following: Explanation: The specified column cannot be
updated because one of the following was
v A DISTINCT keyword
attempted.
v A column function in the select list
v the object table is a view, and the specified
v A GROUP BY or HAVING clause column is derived from a scalar function,
v A FROM clause that identifies one of the expression, keyword, constant, or column of a
following: view where that column cannot be updated.
– More than one table or view v the specified column is a non-updateable
– A read-only view (READONLY column of column of a system catalog.
SYSCAT.SYSVIEWS is set to ’Y’) Federated system users should check to see if
– A table or view that is also identified in the some other data source specific limitation
FROM clause of a subquery of the SELECT prevents the column from being updated.
statement. (NOTE: This only applies to
releases prior to DB2 Version 2.) The statement cannot be processed.
v A set operator (other then UNION ALL). User Response: The requested function is not
v Federated system users: a data source specific supported. For a list of updateable catalogs (and
limitation that causes the column not to be the updateable columns) see the SQL Reference.
updateable
Federated system users: if the reason is
unknown, isolate the problem to the data source

Chapter 2. SQL Messages 25

failing the request (see the problem
SQL0156N The name used for this operation
determination guide) and examine the object
is not a table.
definition and the update restrictions for that
data source. Explanation: The SQL statements ALTER
TABLE, DROP TABLE, SET CONSTRAINTS,
sqlcode: -151
CREATE TRIGGER, CREATE INDEX, LOCK
sqlstate: 42808 TABLE, and RENAME TABLE are applicable
only to tables, not to views. The RUNSTATS and
LOAD utilities are also applicable only to tables,
SQL0153N The CREATE VIEW statement or not to views.
common table expression does not
include a column list. Federated system users: Some utilities and
statements are not supported in a federated
Explanation: A column list must be specified in environment. See the Administration Guide for
a CREATE VIEW statement or a common table more information.
expression when:
v any element of the SELECT list in the fullselect The statement or utility cannot be processed.
is other than a column name and is not named User Response: Verify that the correct table
using the AS clause name is specified in the statement. If an alias
v any two elements are the same column name name was supplied, ensure that the alias resolves
that were not renamed using the AS clause. to a table.

The statement cannot be processed. For a Federated system users: Verify that the object is
CREATE VIEW statement, the view was not not a nickname.
created.
sqlcode: -156
User Response: Provide a column name list in
sqlstate: 42809
the CREATE VIEW statement or common table
expression or name the columns in the SELECT
list of the fullselect using the AS clause. SQL0157N “<name>” is not allowed in a
FOREIGN KEY clause because it
sqlcode: -153
does not identify a base table.
sqlstate: 42908
Explanation: The object “<name>” was
identified in a FOREIGN KEY clause of a
SQL0155N A trigger transition table cannot CREATE or ALTER TABLE statement. A
be modified. FOREIGN KEY clause must identify a base table.

Explanation: The trigger includes a The statement cannot be processed. The specified
REFERENCING clause with an OLD_TABLE or table is not created or altered.
NEW_TABLE identified. A DELETE, INSERT or
User Response: Correct the statement to specify
UPDATE triggered SQL statement has used the
a base table name in the FOREIGN KEY clause.
name specified as the OLD_TABLE or
NEW_TABLE as the table to modify. If an alias name was supplied, ensure that the
alias resolves to a base table.
User Response: Remove the DELETE, INSERT
or UPDATE triggered SQL statement from the sqlcode: -157
triggered action or change the name of the
sqlstate: 42810
transition table so that it does not conflict with
the table you are attempting to modify.
sqlcode: -155
sqlstate: 42807

26 Message Reference, Volume 2

 identified by “<expected-object-type>”.
SQL0158N The number of columns specified
for “<name>” is not the same as sqlcode: -159
the number of columns in the
result table of the associated sqlstate: 42809
fullselect.
Explanation: The identifier “<name>” could SQL0160N The WITH CHECK OPTION
identify: clause is not valid for the
specified view.
v a view named in a CREATE VIEW statement
v a table name of a common table expression Explanation: The WITH CHECK OPTION
clause cannot be used in a view definition if:
v a correlation name of a nested table expression
v The view is defined as read only. The view is
v a summary table named in a CREATE TABLE read only if the SELECT statement contains
or ALTER TABLE statement any of the following. (Note that these
v a function named in a CREATE FUNCTION conditions do not apply to subqueries of the
statement SELECT statement.)
v a method named in a CREATE METHOD – A DISTINCT keyword
statement. – A column function in the selected list
The number of column names specified must be – A GROUP BY or HAVING clause
equal to the number of columns in the result – A FROM clause that identifies either:
table of the associated fullselect.
- More than one table or view
The statement cannot be processed. - A read-only view
– A set operator (other than UNION ALL).
User Response: Correct the syntax so that the
list of column names defined for “<name>” v The SELECT statement in the CREATE VIEW
specify a name for each column of the result statement includes a subquery (except for
table in the associated fullselect. specific statistic columns of some catalog
tables).
sqlcode: -158
Federated system users: the WITH CHECK
sqlstate: 42811 option is not supported on views that reference
updateable nicknames.
SQL0159N The statement references
“<object>” which identifies a(n) The statement cannot be processed. The specified
“<object-type>” rather than a(n) view was not created.
“<expected-object-type>”. User Response: Remove the WITH CHECK
Explanation: The object “<object>” specified as OPTION clause or change the view definition so
part of the statement or command refers to an it conforms to the rules above.
object of type “<object-type>” instead of the sqlcode: -160
expected type “<expected-object-type>”.
sqlstate: 42813
The type of the object provided with the
statement or command must match the type
identified by “<expected-object-type>”. For SQL0161N The resulting row of the INSERT
example, if the statement is DROP ALIAS or UPDATE does not conform to
PBIRD.T1, then PBIRD.T1 must be an alias name. the view definition.
User Response: Change the statement or Explanation: The WITH CHECK OPTION
command to properly match the type of object clause was specified in the view definition that is

Chapter 2. SQL Messages 27

the object of the INSERT or UPDATE statement. The statement cannot be processed.
Consequently, all attempts to insert or update
User Response: Ensure the arguments of the
rows in that view are checked to ensure that the
routine conform to the rules of the routine.
results conform to the view definition.
sqlcode: -171
The statement cannot be processed. No inserts or
updates are performed, and the contents of the sqlstate: 42815
view and underlying base table remain
unchanged.
SQL0172N “<name>” is not a valid function
User Response: Examine the view definition to name.
determine why the requested INSERT or
UPDATE was rejected. Note that this may be a Explanation: The SQL statement includes an
data-dependent condition. unknown scalar function.

Requested INSERT or UPDATE may be trying to The statement cannot be processed.

put out of range value(s) in the target column(s). User Response: Ensure that you correctly spell
For system catalog updates, see the SQL Reference the function name.
for valid ranges of values in various updateable
columns of catalogs. sqlcode: -172

Federated system users, if the reason is sqlstate: 42601

unknown, isolate the problem to the data source
failing the request (see the problem SQL0176N The second, third or fourth
determination guide) and examine the object argument of the TRANSLATE
definition and the view definition for that data scalar function is incorrect.
source.
Explanation: The statement is not correct for
sqlcode: -161 one or more of the following reasons:
sqlstate: 44000 v The translate scalar function does not allow
replacement of a character by another
character which is encoded using a different
SQL0170N The number of arguments for
number of bytes. For example, a single-byte
function “<name>” is incorrect.
character cannot be replaced with a
Explanation: The specified scalar function double-byte character nor can a double-byte
“<name>” has either too few or too many character be replaced with a single-byte
arguments. character.

The statement cannot be processed. v The second and third arguments of the
translate scalar function must end with
User Response: Ensure that the correct number correctly formed characters.
of arguments is specified for the scalar function. v The fourth argument of the translate scalar
sqlcode: -170 function must be a correctly formed
single-byte character if the first argument is
sqlstate: 42605 CHAR or VARCHAR.
v The fourth argument of the translate scalar
SQL0171N The data type, length or value of function must be a correctly formed
argument “<n>” of routine double-byte character if the first argument is
“<name>” is incorrect. GRAPHIC or VARGRAPHIC.
Explanation: The data type, length or value of The statement cannot be processed.
argument “<n>” of routine “<name>” is
User Response: Ensure that the second, third,
incorrect.

28 Message Reference, Volume 2

and fourth arguments of the translate scalar v 0001 to 9999 for years.
function have correct values. v 1 to 12 for months.
sqlcode: -176 v 1 to 31 for days when the month is 1, 3, 5, 7, 8,
10, and 12.
sqlstate: 42815
v 1 to 30 for days when the month is 4, 6, 9, 11.
v 1 to 28 for days when the month is 2 in a
SQL0180N The syntax of the string
non-leap year.
representation of a datetime value
is incorrect. v 1 to 29 for days when the month is 2 in a leap
year.
Explanation: The string representation of a date,
v 0 to 24 for hours. If the hour is 24, the other
time, or timestamp value does not conform to
parts of the time are 0. If the format is USA,
the syntax for the specified or implied data type.
the hour cannot be greater than 12.
The statement cannot be processed. v 0 to 59 for minutes.
User Response: Ensure that the syntax of the v 0 to 59 for seconds.
date, time, or timestamp value conforms to the v 0 to 999999 for microseconds.
syntax for its data type. If the string is not
v 001 to 365 for the day portion of a Julian
intended to be a date, time, or timestamp value,
calendar date when the year is not a leap year.
ensure that when used, it does not imply that
data type. v 001 to 366 for the day portion of a Julian
calendar date when the year is a leap year.
Federated system users: the problem might be
due to a date/time representation problem at the Federated system users: the problem might be
data source. If the reason is unknown, isolate the due to a date/time representation problem at the
problem to the data source failing the request data source. Refer to the data source’s
Troubleshooting Guide and examine the documentation for the ranges for date and time
date/time representation restrictions for that data values at the data source. If the reason is
source. unknown, isolate the problem to the data source
failing the request (see the Troubleshooting
sqlcode: -180 Guide) and examine the date/time representation
sqlstate: 22007 restrictions for that data source.

The statement cannot be processed.

SQL0181N The string representation of a
datetime value is out of range. User Response: Ensure that the value is within
the valid range, and the application’s datetime
Explanation: The string representation of a date, format is the same as the string value.
time or timestamp value contains a value that is
out of range. sqlcode: -181

This error could be caused by accessing a sqlstate: 22007

datetime value from an application using a
country code whose datetime format is different SQL0182N An expression with a datetime
than the one used by the application that created value or a labeled duration is not
it. For example, a string datetime value stored in valid.
the format dd/mm/yyyy will not be valid when
read by an application expecting its format to be Explanation: The specified expression contains
mm/dd/yyyy. an improperly used date, time, or timestamp
value or labeled duration.
The correct ranges for date, time, or timestamp
values are as follows: The statement cannot be processed.

Chapter 2. SQL Messages 29

User Response: Examine the SQL statement to error was returned for one of the following
determine the cause of the problem and correct reasons.
the statement. v If a SET DATA TYPE clause is specified, the
sqlcode: -182 existing column:
– is not of data type VARCHAR or
sqlstate: 42816
– has a length that is greater than the length
specified in the clause.
SQL0183N A datetime arithmetic operation or
v If a SET EXPRESSION clause is specified, the
datetime scalar function has a
existing column is not defined as generated
result that is not within the valid
using an expression.
range of dates.
The statement cannot be processed.
Explanation: The result of an arithmetic
operation is a date or timestamp duration which User Response: Make the attributes specified
is outside the range 0001-01-01 through compatible with the existing column, remove the
9999-12-31. attribute specification, or specify a different
column name.
The statement cannot be executed.
sqlcode: -190
User Response: Examine the SQL statement to
determine the cause of the problem. If the sqlstate: 42837
problem is data-dependent, examine the data
processed when the error occurred.
SQL0191N Error occurred because of a
sqlcode: -183 fragmented MBCS character.
sqlstate: 22008 Explanation: Possible causes:
1. User data contained an improperly formed
SQL0187N A reference to a current date/time multi-byte character. For example, the first
special register is invalid. byte of a DBCS character was found, but the
second character was not.
Explanation: An error indication from the
2. A scalar function, such as SUBSTR or
operating system was detected while retrieving
POSSTR has truncated a multi-bytes string
date/time information.
incorrectly. For these functions, start and
User Response: Ensure that the system TOD length values must be correct in terms of
clock and timezone settings are correct. bytes, in the context of the database code
page. For a Unicode database, a common
sqlcode: -187 cause of this could be that the start or length
sqlstate: 22506 for a UTF-8 string are incorrect.
3. A scalar function such as TRANSLATE has
may have changed the multi-byte string.
SQL0190N ALTER TABLE “<table-name>”
specified attributes for column Federated system users: this situation can also be
“<column-name>” that are not detected by the data source.
compatible with the existing
column. User Response:
1. Correct the input data and try again.
Explanation: The attributes specified in the
ALTER COLUMN clause for the column 2. Change the start and length values such that
“<column-name>” of the table “<table-name>” in when characters are converted to the
an ALTER TABLE statement are not compatible database code page, the multi-byte characters
with the attributes of the existing column. The are not truncated incorrectly.

30 Message Reference, Volume 2

3. Correct the TRANSLATE in error.
SQL0198N The statement string of the
Federated system users: if the data is correct, PREPARE or EXECUTE
isolate the problem to the data source failing the IMMEDIATE statement is blank
request (see the Troubleshooting Guide) and or empty.
examine the DBCS restrictions of that data
Explanation: The host variable that was the
source. If the data appears to be correct, contact
object of the PREPARE or EXECUTE
IBM service for assistance.
IMMEDIATE statement either contained all
blanks or was an empty string.
sqlcode: -191
The PREPARE or EXECUTE IMMEDIATE could
sqlstate: 22504 not be completed.
User Response: Correct the logic of the
SQL0193N In an ALTER TABLE statement, program to ensure that a valid SQL statement is
the column “<column-name>” has provided in the operand of the PREPARE or
been specified as NOT NULL and EXECUTE IMMEDIATE statement before it is
either the DEFAULT clause was executed.
not specified or was specified as sqlcode: -198
DEFAULT NULL.
sqlstate: 42617
Explanation: When new columns are added to a
table that already exists, a value must be
assigned to that new column for all existing SQL0199N The use of reserved word
rows. By default, the null value is assigned. “<keyword>” following “<text>”
However, since the column has been defined as is not valid. Expected tokens may
NOT NULL, a default value other than null must include: “<token-list>”.
be defined.
Explanation: A syntax error in the SQL
User Response: Either remove the NOT NULL statement was detected at the point in the
restriction on the column or provide a default statement when the reserved word “<keyword>”
value other than null for the column. appears following “<text>”. The “<text>” field
indicates the 20 characters of the SQL statement
sqlcode: -193 that preceded the reserved word. Clauses in the
sqlstate: 42601 statement may be in the wrong order.
As an aid to the programmer, a partial list of
SQL0197N A qualified column name is not valid tokens is provided in the SQLERRM field
allowed in the ORDER BY clause. of the SQLCA as “<token-list>”. This list
assumes the statement is correct to that point.
Explanation: The ORDER BY clause of a
fullselect that includes a set operator (UNION, The statement cannot be processed.
EXCEPT, INTERSECT) cannot have qualified User Response: Examine the statement in the
column names. keyword area. Add a colon or SQL delimiter, if
User Response: Ensure that all column names missing. Verify that the clauses are in the correct
in the ORDER BY clause are unqualified. order. If the reserved word identified in the
messages is listed as a reserved word, make the
sqlcode: -197 word a delimited identifier.
sqlstate: 42877 NOTE: This error is only applicable to releases of
DB2 prior to Version 2.
sqlcode: -199

Chapter 2. SQL Messages 31

sqlstate: 42601

SQL0200 - SQL0299
– The data type does not exist in the database
SQL0203N A reference to column “<name>”
with a create timestamp earlier than the
is ambiguous.
time the package was bound (applies to
Explanation: The column “<name>” is used in static statements).
the statement and there is more than one – If the data type is in the UNDER clause of a
possible column to which it could refer. This CREATE TYPE statement, the type name
could be the result of: may be the same as the type being defined,
v two tables specified in a FROM clause that which is not valid.
have columns with the same name v A function is being referenced in one of:
v the ORDER BY clause refers to a name that – a DROP FUNCTION statement
applies to more than one column in the select
– a COMMENT ON FUNCTION statement
list
– the SOURCE clause of a CREATE
v a reference to a column from the subject table
FUNCTION statement
in a CREATE TRIGGER statement does not
use the correlation name to indicate if it refers If ″<name>″ is qualified, then the function
to the old or new transition variable. does not exist. If ″<name>″ is unqualified,
then a function of this name does not exist
The column name needs further information to in any schema of the current function path.
establish which of the possible table columns it Note that a function cannot be sourced on
is. the COALESCE, NULLIF, or VALUE
built-in functions.
The statement cannot be processed.
This return code can be generated for any type
User Response: Add a qualifier to the column of database object.
name. The qualifier is the table name or
correlation name. A column may need to be Federated system users: the object identified by
renamed in the select list. “<name>” is not defined in the database or
sqlcode: -203 “<name>” is not a nickname in a DROP
NICKNAME statement.
sqlstate: 42702
Some data sources do not provide the
SQL0204N “<name>” is an undefined name. appropriate values for “<name>”. In these cases,
the message token will have the following
Explanation: This error is caused by one of the format: “OBJECT:<data source> TABLE/VIEW”,
following: indicating that the actual value for the specified
v The object identified by “<name>” is not data source is unknown.
defined in the database.
v A data type is being used. This error can occur The statement cannot be processed.
for the following reasons: User Response: Ensure that the object name
– If ″<name>″ is qualified, then a data type (including any required qualifiers) is correctly
with this name does not exist in the specified in the SQL statement and it exists. For
database. missing data type or function in SOURCE clause,
– If ″<name>″ is unqualified, then the user’s it may be that the object does not exist, OR it
function path does not contain the schema may be that the object does exist in some
to which the desired data type belongs.

32 Message Reference, Volume 2

schema, but the schema is not present in your v For an INSERT or UPDATE statement, the
function path. specified column is not a column of the table,
or view that was specified as the object of the
Federated system users: if the statement is DROP
insert or update.
NICKNAME, make sure the object is actually a
nickname. The object might not exist in the v For a SELECT or DELETE statement, the
federated database or at the data source. Verify specified column is not a column of any of the
the existence of the federated database objects (if tables or views identified in a FROM clause in
any) and the data source objects (if any). the statement.
v For an ORDER BY clause, the specified column
sqlcode: -204
is a correlated column reference in a subselect,
sqlstate: 42704 which is not allowed.
v For a CREATE TRIGGER statement:
SQL0205N Column or attribute “<name>” is – A reference is made to a column of the
not defined in “<object-name>”. subject table without using an OLD or
NEW correlation name.
Explanation: If “<object-name>” is a table or
view, then “<name>” is a column that is not – The left hand side of an assignment in the
defined in “<object-name>”. If “<object-name>” SET transition-variable statement in the
is a structured type, then “<name>” is an triggered action specifies an old transition
attribute that is not defined in “<object-name>”. variable where only a new transition
variable is supported.
Federated system users: “<object-name>” could v For a CREATE FUNCTION statement:
refer to a nickname.
– The RETURN statement of the SQL function
The statement cannot be processed. references a variable that is not a parameter
or other variable that is in the scope of the
User Response: If “<object-name>” is a table or
RETURN statement.
view, verify that the column and table or view
names (including any required qualifiers) are – The FILTER USING clause references a
specified correctly in the SQL statement. If variable that is not a parameter name or an
“<object-name>” is a structured type, verify that expression name in the WHEN clause.
the attribute and type names (including any – The search target in an index exploitation
required qualifiers) are specified correctly in the rule does not match some parameter name
SQL statement. of the function that is being created.
Also, if you receive this error during a REORG – A search argument in an index exploitation
or an IMPORT, the column names in the index rule does not match either an expression
may violate the database manager naming rules name in the EXPRESSION AS clause or a
as defined in the Administration Guide. parameter name of the function being
created.
sqlcode: -205
v For a CREATE INDEX EXTENSION statement,
sqlstate: 42703 the RANGE THROUGH clause or the FILTER
USING clause references a variable that is not
a parameter name that can be used in the
SQL0206N “<name>” is not valid in the
clause.
context where it is used.
The statement cannot be processed.
Explanation: This error can occur in the
following cases: User Response: Verify that the names are
specified correctly in the SQL statement. For a
SELECT statement, ensure that all the required
tables are named in the FROM clause. For a

Chapter 2. SQL Messages 33

subselect in an ORDER BY clause, ensure that User Response: To correct the syntax of the
there are no correlated column references. If a statement, either add the specified column to the
correlation name is used for a table, verify that result table or delete it from the ORDER BY
subsequent references use the correlation name clause.
and not the table name.
sqlcode: -208
For a CREATE TRIGGER statement, ensure that
sqlstate: 42707
only new transition variables are specified on the
left hand side of assignments in the SET
transition-variable statement and that any SQL0212N “<name>” is a duplicate table
reference to columns of the subject table have a designator or is specified more
correlation name specified. than once in the REFERENCING
clause of a trigger definition.
sqlcode: -206
Explanation: The exposed table, view, alias, or
sqlstate: 42703
correlation name specified by “<name>” is
identical to another exposed table, view, alias, or
SQL0207N A column name is not allowed in correlation name in the same FROM clause.
the ORDER BY clause of a
If the statement is a CREATE TRIGGER, the
SELECT statement used with a set
REFERENCING clause may have specified the
operator.
same name as the subject table or may have the
Explanation: A SELECT statement with a set same name for more than one of the OLD or
operator contains an ORDER BY clause, which NEW correlation names or the NEW_TABLE or
specifies column names. In this case, the list of OLD_TABLE identifiers.
columns in the ORDER BY clause must contain
The statement cannot be processed.
only integers.
User Response: Rewrite the FROM clause of the
The statement cannot be processed.
SELECT statement. Associate correlation names
User Response: Specify only integers in the list with table, view, or alias names so no exposed
of columns in the ORDER BY clause. table, view, alias, or correlation name is identical
to any other exposed table, view, alias, or
NOTE: This error is only applicable to releases of
correlation name in the FROM clause.
DB2 prior to Version 2 and hosts accessed
through DB2 Connect. For a CREATE TRIGGER statement, change the
names in the REFERENCING clause so that there
sqlcode: -207
are no duplicates.
sqlstate: 42706
sqlcode: -212
sqlstate: 42712
SQL0208N The ORDER BY clause is not
valid because column “<name>”
is not part of the result table. SQL0214N An expression starting with
“<expression-start>” in the
Explanation: The statement is not valid because
“<clause-type>” clause is not
a column “<name>” specified in the ORDER BY
valid. Reason code =
list is not specified in the SELECT list and is not
“<reason-code>”.
in the result table. Only columns in the result
table can be used to order that result when the Explanation: The expression identified by the
fullselect of the select-statement is not a first part of the expression “<expression-start>”
subselect. in the “<clause-type>” clause is not valid for the
reason specified by the “<reason-code>” as
The statement cannot be processed.
follows:

34 Message Reference, Volume 2

1 The fullselect of the select-statement is table expression or a common table
not a subselect. Expressions are not expression to first provide a result table
allowed in the ORDER BY clause for with the expression as a column of the
this type of select-statement. This reason result.
code occurs only when “<clause-type>”
5 Remove any variant function from the
is ORDER BY.
left side of the dereference operators in
2 DISTINCT is specified in the select the GROUP BY clause.
clause and the expression cannot be
matched exactly with an expression in sqlcode: -214
the select list. This reason code occurs
only when “<clause-type>” is ORDER sqlstate: 42822
BY.
3 Grouping is caused by the presence of a SQL0216N The number of elements on each
column function in the ORDER BY side of a predicate operator does
clause. This reason code occurs only not match. Predicate operator is
when “<clause-type>” is ORDER BY. “<predicate-operator>”.
4 Expression in a GROUP BY clause Explanation: A predicate includes a list of
cannot be a scalar-fullselect. This reason elements on the right or left side (or both sides)
code occurs only when “<clause-type>” of the predicate operator. The number of
is GROUP BY. elements must be the same on both sides. These
5 The left side of a dereference operator in elements may appear in a list of expressions
a GROUP BY clause cannot be a variant enclosed in parentheses or as elements of a select
function. This reason code occurs only list in a fullselect.
when “<clause-type>” is GROUP BY. The statement cannot be processed.

The statement cannot be processed. User Response: Correct the predicate with
mismatched number of elements on each side of
User Response: Modify the select-statement the predicate operator.
based on the reason specified by the
“<reason-code>” as follows: sqlcode: -216

1 Remove the expression from the ORDER sqlstate: 428C4

BY clause. If attempting to reference a
column of the result, change the sort SQL0217W The statement was not executed as
key to the simple-integer or only Explain information requests
simple-column-name form. are being processed.
2 Remove DISTINCT from the select Explanation: The current value of one of the
clause or change the sort key to the Explain special registers has been set to
simple-integer or simple-column-name EXPLAIN. This value allows dynamic SQL
form. statements to be prepared and explained but
3 Add a GROUP BY clause or remove the prevents any dynamic statement from being
column function from the ORDER BY executed.
clause. User Response: Change the value of the
4 Remove any scalar-fullselect from the appropriate Explain special register to a setting
GROUP BY clause. If grouping is other than EXPLAIN by issuing the appropriate
desired on a column of the result that is SET statement from the interface or application
based on a scalar-fullselect use a nested that is encountering this condition.

Chapter 2. SQL Messages 35

sqlcode: +217
SQL0236W SQLDA has only provided
sqlstate: 01604 “<integer1>” SQLVAR entries.
“<integer2>” SQLVAR entries are
required for “<integer3>”
SQL0219N The required Explain table columns. No SQLVAR entries
“<name>” does not exist. have been set.
Explanation: The Explain facility has been Explanation: The value of the SQLN field of the
invoked but was unable to find the required SQLDA should be at least as large as the number
Explain table “<name>”. The Explain tables must of columns in the result set.
be created prior to invoking Explain.
The database manager has not set any SQLVAR
User Response: Create the required Explain entries (and the SQLDOUBLED flag has been set
tables. The SQL Data Definition Language to ″off″ (i.e. to the space character)).
statements needed to create the Explain tables
are available in the file called EXPLAIN.DDL in User Response: Increase the value of the SQLN
the misc directory under sqllib. field in the SQLDA to the value indicated in the
message (making sure the SQLDA is large
sqlcode: -219 enough to support that amount) and resubmit
sqlstate: 42704 the statement.
sqlcode: +236
SQL0220N The Explain table “<name>”, sqlstate: 01005
column “<name2>” does not have
the proper definition or is
missing. SQL0237W SQLDA has only provided
“<integer1>” SQLVAR entries.
Explanation: The Explain facility has been Since at least one of the columns
invoked but the Explain table “<name>” did not being described is a distinct type,
have the expected definition. The definition “<integer2>” SQLVAR entries
could be incorrect due to: should have been specified. None
v Incorrect number of columns defined (if of the Secondary SQLVAR entries
“<name2>” is numeric) have been set.
v Incorrect data type assigned to columns (if Explanation: Since at least one of the columns
“<name2>” is a column name). in the result set is a distinct type, space should
User Response: Correct the definitions of the be provided for twice as many SQLVAR entries
specified Explain table. The SQL Data Definition as the number of columns in the result set. The
Language statements needed to create the database manager has only set the Base SQLVAR
Explain tables are available in the file called entries (and the SQLDOUBLED flag has been set
EXPLAIN.DDL in the misc directory under off (i.e. to the space character).
sqllib. User Response: If there is no need for the
sqlcode: -220 additional information about the distinct type(s)
in the result set, then no action is required. If the
sqlstate: 55002 distinct type information is needed, the value of
the SQLN field in the SQLDA should be
increased to the value indicated in the message
(after making sure that the SQLDA is large
enough to support that amount) and the
statement should be resubmitted.
sqlcode: +237

36 Message Reference, Volume 2

sqlstate: 01594 SQLN field in the SQLDA should be increased to
the value indicated in the message (after making
sure the SQLDA is large enough to support that
SQL0238W SQLDA has only provided
amount) and the statement should be
“<integer1>” SQLVAR entries.
resubmitted. If there is no need for the additional
Since at least one of the columns
information about the distinct type(s) or
being described is a LOB or
reference type(s) in the result set, then it is
structured type, “<integer2>”
possible to resubmit the statement only
SQLVAR entries are required for
providing enough SQLVAR entries to
“<integer3>” columns. No
accommodate the number of columns in the
SQLVAR entries have been set.
result set.
Explanation: Since at least one of the columns
sqlcode: +239
in the result set is a LOB or structured type,
space must be provided for twice as many sqlstate: 01005
SQLVAR entries as the number of columns in the
result set. Note also that one or more of the
SQL0242N The object named
columns in the result set may be a distinct type.
“<object-name>” of type
The database manager has not set any SQLVAR “<object-type>” was specified
entries (and the SQLDOUBLED flag has been set more than once in the list of
off (i.e. to the space character). objects.
User Response: Increase the value of the SQLN Explanation: In a list of object names of type
field in the SQLDA to the value indicated in the “<object-type>”, the object named
message (after making sure that the SQLDA is “<object-name>” was specified more than once.
large enough to support that amount) and The operation of the statement cannot be
resubmit the statement. performed on the object more than once.
sqlcode: +238 User Response: Correct the duplicated object in
the list removing duplicate occurrences.
sqlstate: 01005
sqlcode: -242
SQL0239W SQLDA has only provided sqlstate: 42713
“<integer1>” SQLVAR entries.
Since at least one of the columns
SQL0257N Raw DEVICE containers are
being described is a distinct type
currently not supported on this
or reference type, “<integer2>”
platform.
SQLVAR entries are required for
“<integer3>” columns. No Explanation: An attempt was made to use
SQLVAR entries have been set. DEVICE containers. These are not currently
supported on this platform.
Explanation: If any of the columns in the result
set is a distinct type or reference type, then space User Response: Use FILE containers or
should be provided for twice as many SQLVAR system-managed table spaces instead.
entries as the number of columns in the result
set. sqlcode: -257

The database manager has not set any SQLVAR sqlstate: 42994
entries (and the SQLDOUBLED flag has been set
off (i.e. to the space character).
User Response: If the distinct type or reference
type information is needed, the value of the

Chapter 2. SQL Messages 37

 Restore the table space to the new containers.
SQL0258N Containers cannot be added while
a rebalance of the table space is sqlcode: -259
pending or in progress.
sqlstate: 54037
Explanation: One of the following conditions is
true:
SQL0260N Column “<column-name>” cannot
1. An ALTER TABLESPACE to add containers to belong to the partitioning key
the same table space (on the same node) has because it is either a LONG
previously been issued in the same unit of column, DATALINK column, or
work. Containers for a table space can only structured type column.
be added to one node in one ALTER
TABLESPACE statement in a unit of work. Explanation: A partitioning key cannot have a
2. The table space to which you are adding LONG-type column, DATALINK column, or
containers is currently being rebalanced. structured type column.
Details can be found in the system error log The statement cannot be processed.
and/or the database manager error log.
User Response: Do not use LONG columns,
User Response: DATALINK columns, or structured type columns
1. If possible, roll back the unit of work and for the partitioning key.
issue a single ALTER TABLESPACE to add all
If the table only has LONG columns, DATALINK
the containers. Otherwise, wait until the
columns, or structured type columsn, either add
rebalance has completed and then try the
a column that can be used for the partitioning
operation again.
key to the table, or define the table without a
2. Wait until the rebalance has completed and partitioning key in a single-node nodegroup.
then try the operation again.
sqlcode: -260
sqlcode: -258
sqlstate: 42962
sqlstate: 55041
SQL0262N Table “<table-name>” cannot be
SQL0259N Container map for table space is created in multinode nodegroup
too complicated. “<nodegroup-name>” because it
contains only LONG-type
Explanation: The map structure keeps a record columns. No partitioning key can
of how the table space address space is mapped be created.
to the various containers. If this gets too
complicated, it does not fit in the table space file. Explanation: The table “<table-name>”
consisting of only LONG-type columns cannot be
Details can be found in the system error log created in a multinode nodegroup. The table
and/or the database manager error log. must have at least one non-LONG type column
for use in a partitioning key.
User Response: The table space may need to be
rebalanced to more evenly distribute the data The statement cannot be processed.
among the containers. This may simplify the
mapping. User Response: Either create the table with one
or more non-LONG type columns, or create the
If this does not work, try making as many table in a single-node nodegroup.
containers as possible the same size. Existing
container sizes can be changed by backing up the sqlcode: -262
table space and then using the database sqlstate: 428A2
administration utility to change the containers.

38 Message Reference, Volume 2

 REDISTRIBUTE NODEGROUP command, one of
SQL0263N Node range from
the following occurred:
“<node-number-1>” to
“<node-number-2>” is not valid. v The node appeared more than once in the
Second node number must be ADD NODES or the DROP NODES clause.
greater than or equal to first node v The node appeared in both the ADD NODES
number. and the DROP NODES clause.
Explanation: The specified node range is not v The node to be added is already a member of
valid. the nodegroup.

The statement cannot be processed. The statement cannot be processed.

User Response: Correct the node range in the User Response: Ensure that the node names or
statement, then try the request again. node numbers in the ON NODES, ADD NODES,
or DROP NODES clause are unique. For the
sqlcode: -263 CREATE TABLESPACE and ALTER
sqlstate: 428A9 TABLESPACE statements, ensure that a node
appears in no more than one ON NODES clause.

SQL0264N Partitioning key cannot be added In addition, for the ALTER NODEGROUP
or dropped because table resides statement or REDISTRIBUTE NODEGROUP
in a table space defined on the command:
multi-node nodegroup “<name>”. v Do not specify a node in both the ADD
NODES and the DROP NODES clause.
Explanation: You can only add or drop a
partitioning key on a table in a single-node v Remove the node from the ADD NODES
nodegroup. clause if the node is already defined in the
nodegroup.
The statement cannot be processed.
sqlcode: -265
User Response: Do one of the following and try
the request again: sqlstate: 42728
v Define an identical table with a partitioning
key.
SQL0266N Node “<node-number>” is not
v Redistribute the nodegroup to a single-node defined.
nodegroup.
Explanation: The node “<node-number>” is not
sqlcode: -264 valid for one of the following reasons:
v the node number is not in the valid range of 0
sqlstate: 55037
to 999
v the node is not in the node configuration file
SQL0265N Node “<node-number>” is a
v the node is not part of the nodegroup,
duplicate node.
therefore the requested operation cannot be
Explanation: For the CREATE NODEGROUP processed.
statement, a node can only appear once in the
The statement cannot be processed.
ON NODES clause.
User Response: Depending on the condition:
For the CREATE TABLESPACE and ALTER
TABLESPACE statement, a node can appear only v issue the statement, command or API with
once and in only one ON NODES clause. node numbers in the valid range.
v follow the procedure to add a node to the
For the ALTER NODEGROUP statement or
system.

Chapter 2. SQL Messages 39

v remove the node from the specified nodes in the following reason code:
the statement, command or API.
1 The primary key, each unique
sqlcode: -266 constraint, and each unique index must
contain all partitioning columns of the
sqlstate: 42729 table (columns may appear in any
order).

SQL0268N “<operation>” cannot be 2 Update of the partitioning key column

performed while nodegroup is value is not supported.
being redistributed.
3 A foreign key cannot include any
Explanation: One of the following: nullable partitioning key columns when
v The nodegroup is being redistributed. It defined with ON DELETE SET NULL.
cannot be altered, dropped or redistributed This is a special case of reason code 2
again until the current operation is complete. since defining such a constraint would
result in attempting to update a
v The partitioning key of a table cannot be partitioning key column.
dropped while the nodegroup of the table is
being redistributed. 4 A table defined using a multipartition
nodegroup or a single-partition
The statement cannot be processed. nodegroup on other than the catalog
User Response: Wait until the redistribution is partition does not support DATA
complete, then try the request again. CAPTURE CHANGES.

sqlcode: -268 5 View created with the WITH CHECK

OPTION clause should not use
sqlstate: 55038 functions (or reference views that use
functions ) that:
SQL0269N Database contains maximum v are non-deterministic
number of partitioning maps. v have side effects
Explanation: Because the database contains the v are related to the placement of data
maximum number of partitioning maps (32,768), (for example nodenumber or partition
you cannot create a new nodegroup, alter a functions).
nodegroup, or redistribute an existing one.
These functions must also not be
The statement cannot be processed. present within referenced views if the
new view is created with the
User Response: Drop one or more nodegroups
CASCADED check option.
in the database.
6 A transform cannot be defined for a
Note: Dropping a nodegroup drops all database
user-defined distinct type.
objects such as table spaces, tables and views
that reside in the nodegroup. 7 Long fields can only be defined using a
table space with a page size that is 4K.
sqlcode: -269
A LONG TABLESPACE can only be
sqlstate: 54033 created using a 4K page size.
8 Structured types are not supported as
SQL0270N Function not supported (Reason columns of a table or structured type
code = “<reason-code>”). attribute data types prior to DB2 Version
7.1.
Explanation: The statement cannot be processed
because it violates a restriction as indicated by

40 Message Reference, Volume 2

9 Triggers are not supported on typed 20 ALTER TABLE is not supported for a
tables. summary table.
10 A single default table space cannot be 21 Column length cannot be altered on a
selected since the table has one or more table which is a base table for a
LOB columns which must be placed in a summary table.
table space with a 4K page size and the
22 Summary tables cannot be defined in a
rowsize or number of columns in the
CREATE SCHEMA statement.
table requires a table space with an 8K
page size. 23 REPLICATED can only be specified for
a summary table defined with REFRESH
11 A typed table or typed view cannot be
DEFERRED.
created using a structured type that has
no attributes. 24 The triggered-action in a BEFORE
trigger cannot reference a summary
12 The type of a source key parameter
table defined with REFRESH
must be a user-defined structured type
IMMEDIATE.
or a distinct type that is not sourced on
LOB, DATALINK, LONG VARCHAR, or 25 Only one summary table can be
LONG VARGRAPHIC. specified for a SET CONSTRAINTS
statement.
13 Check constraints cannot be defined on
a typed table or the WITH CHECK 26 The nodegroup being redistributed
OPTION clause cannot be specified on a contains at least one replicated
typed view. summary table.
14 Referential constraints cannot be defined 27 Replicated summary tables cannot be
on a typed table or to a parent table that defined on a table that does not have a
is a typed table. unique index existing on one or more
columns that make up the replicated
15 A default value cannot be defined for
summary table.
reference type columns.
28 A typed table or summary table cannot
16 A reference data type or structured data
be renamed.
type cannot be used as a parameter data
type or a returns data type of a user 29 FOR EXCEPTION clause cannot be
defined function prior to DB2 Version specified with a summary table in the
7.1. Otherwise, a scoped reference data SET CONSTRAINTS statement.
type cannot be used as a parameter data
type or returns data type of a routine. A 30 Typed tables and typed views cannot be
structured type cannot be used as a defined in a CREATE SCHEMA
return column of a table or row statement.
function. 31 A partitioning key cannot be defined
17 The SET CONSTRAINTS statement with more than 500 columns.
cannot be used for a typed table. 32 A table defined using a multipartition
18 Column level UPDATE and nodegroup or a single-partition
REFERENCES privileges cannot be nodegroup on other than the catalog
granted on a typed table or typed view. partition does not support DATALINK
columns defined with FILE LINK
19 A specific default value must be CONTROL.
specified when defining a default for a
column of a typed table. 33 An underlying table of a summary table
defined with REFRESH IMMEDIATE

Chapter 2. SQL Messages 41

 cannot be the child of a referential CREATE TRANSFORM statement for
constraint with cascading effect (i.e. user-defined structured types only.
with option ON DELETE CASCADE or
7 Use a table space with 4K page size for
ON DELETE SET NULL).
any table that includes long fields. If
34 The underlying object relational feature using DMS table spaces, long fields can
is not supported in the current release. be placed in a table space with 4K page
size with other table or index data in
35 An identity column cannot be created in
table spaces with a different page size.
a multi-node database environment.
When defining a LONG TABLESPACE,
36 Database activation of a multi-node use PAGESIZE 4K.
database is not allowed if identity
8 For servers prior to DB2 Version 7.1,
columns exist.
ensure that no column data types are
38 An index using an index extension is structured types in the CREATE TABLE
not supported in a multiple partition statement or ALTER TYPE ADD
nodegroup. COLUMN statement. Ensure that no
attribute data types are structured types
39 Nicknames or OLE DB table functions in the CREATE TYPE statement or
cannot be referenced directly or ALTER TYPE ADD ATTRIBUTE
indirectly in the body of an SQL statement.
function or SQL method.
9 Do not define triggers on typed tables.
User Response: The action corresponding to the
reason code is: 10 Either reduce the row size or number of
columns in the table or specify 2 table
1 Correct the CREATE TABLE, ALTER spaces such that the long data is in a
TABLE or CREATE UNIQUE INDEX table space with a 4K page size and the
statement. base data is in a table space with an 8K
2 Do not attempt to update the page size.
partitioning key columns for a 11 When creating a typed table or typed
multipartition table or consider deleting view, specify a structured type that has
and then inserting the row with the new at least one attribute defined.
values in the partitioning columns.
12 For the type of a source key parameter,
3 Make the partitioning key column not use only a user-defined structured type
nullable, specify a different ON DELETE or a distinct type that is not sourced on
action, or change the partitioning key of LOB, DATALINK, LONG VARCHAR, or
the table so that the foreign does not LONG VARGRAPHIC.
include any columns of the partitioning
key. 13 In a CREATE TABLE or ALTER TABLE
statement for a typed table, do not
4 Either specify DATA CAPTURE NONE specify check constraints. In a CREATE
or ensure that the table is placed in a VIEW statement of a typed view, do not
table space on a single-partition specify the WITH CHECK OPTION
nodegroup that specifies the catalog clause.
partition.
14 Do not specify referential constraints
5 Do not use the WITH CHECK OPTION involving typed tables in a CREATE
clause or remove the function or view TABLE or ALTER TABLE statement.
from the view definition.
15 Do not specify a DEFAULT clause for a
6 Transforms are automatic for
user-defined distinct types. Use the

42 Message Reference, Volume 2

 column with a reference data type in a defined for the summary table also are
CREATE TABLE or ALTER TABLE the set of columns that make up a
statement. unique index on the base table.
16 For servers prior to DB2 Version 7.1, do 28 A typed table or summary table name
not specify a structured type parameter can only be changed by dropping the
or returns type when creating a user table and creating it again with the new
defined function. Otherwise, do not name. Dropping the table may have
specify a scoped reference type as a implications on other objects that
parameter or returns type. Do not depend on the table and the privileges
specify a structured type as a return on the table are lost.
column of a table or row function.
29 Remove the FOR EXCEPTION clause
17 Do not specify a typed table in the SET from the SET CONSTRAINTS statement.
CONSTRAINTS statement.
30 Issue the CREATE statement for the
18 Do not include specific column names typed view or typed table outside of the
when granting REFERENCES or CREATE SCHEMA statement.
UPDATE privileges on a typed table or
31 Reduce the number of columns in the
typed view.
partitioning key.
19 Include a specific value when specifying
32 Either specify NO LINK CONTROL for
the DEFAULT clause on a column of a
the DATALINK column or ensure that
typed table.
the table is placed in a table space on a
20 Drop the summary table and recreate it single-partition nodegroup that specifies
with the desired attributes. the catalog partition. If redistributing to
a multiple-partition nodegroup, the
21 Drop the summary table(s), alter the
table needs to be dropped to continue
column length of the base table and
with the redistribute.
then recreate the summary table(s).
33
22 Issue the CREATE SUMMARY TABLE
statement outside of the CREATE v Do not define a referential constraint
SCHEMA statement. with cascading effect (i.e. with option
ON DELETE CASCADE or ON
23 Either remove the REPLICATED DELETE SET NULL) with an
specification or ensure that REFRESH underlying table of a summary table
DEFERRED is specified for the defined with REFRESH IMMEDIATE
summary table definition. as the child, or
24 Remove the reference to the summary v do not define a REFRESH
table in the triggered-action in the IMMEDIATE summary table whose
BEFORE trigger. underlying table is the child of a
referential constraint with cascading
25 Issue separate SET CONSTRAINTS effect (i.e. with option ON DELETE
IMMEDIATE CHECKED statements for CASCADE or ON DELETE SET
each summary table. NULL).
26 Drop all replicated summary tables in 34 The error can be corrected by removing
the nodegroup and then issue the the use of any unsupported object
REDISTRIBUTE NODEGROUP relational features.
command again. Recreate the replicated
summary table(s). 35 Remove the “GENERATED [ALWAYS |

27 Ensure that a subset of the columns

Chapter 2. SQL Messages 43

 BY DEFAULT] AS IDENTITY ...”
SQL0276N Connection to database ″<name>″
attribute from the column.
cannot be made because it is in
36 Drop the new node(s) to go back to a the restore pending state.
single node configuration. If more nodes
Explanation: The database must be restored
are required, then the tables with
before a connection can be done.
identity columns need to be dropped
before new nodes are added. No connection was made.
38 An index using an index extension User Response: Restore the database, then issue
cannot be created on a table in a the CONNECT statement again.
multiple partition nodegroup. A
sqlcode: -276
nodegroup cannot become a multiple
partition nodegroup while an index sqlstate: 08004
using an index extension exists on a
table in the nodegroup. Either drop any
such indexes and add the partition to SQL0279N The database connection has been
the nodegroup, in which case the terminated during COMMIT
indexes cannot be re-created, or leave processing. The transaction could
the nodegroup unchanged. be in doubt. Reason code =
“<reason-code>”.
39 Remove the reference to a nickname or
OLE DB table function or remove the Explanation: Commit processing encountered
reference to the object that indirectly an error. The transaction has been put in the
references one of these. commit state, but the commit processing may not
have completed. The application’s database
connection has been terminated.
sqlcode: -270
The cause of the error is indicated by the
sqlstate: 42997 ″<reason-code>″:
1 A node involved in the transaction has
SQL0271N Index file for table with fid failed.
″<fid>″ is either missing, or is not
2 Commit was rejected on one for the
valid.
nodes. Check the db2diag.log file for
Explanation: The index file for the table with details.
fid ″<fid>″ is required during processing. The file
User Response: Determine the cause of the
is either missing, or it is not valid.
error. It may be necessary to contact the system
The statement cannot be processed, and the administrator for assistance since the most
application is still connected to the database. This common cause of the error is node failure or
condition does not affect other statements that do connection failure. The RESTART DATABASE
not use the index on this table. command will complete the commit processing
for this transaction.
User Response: Ensure that all users are
disconnected from the database, then issue the sqlcode: -279
RESTART DATABASE command on all nodes.
sqlstate: 08007
Then try the request again.
The index (or indexes) is re-created when the
database is restarted.
sqlcode: -271
sqlstate: 58004

44 Message Reference, Volume 2

SQL0280W View, trigger or summary table SQL0282N Table space ″<tablespace-name>″
“<name>” has replaced an cannot be dropped because at
existing inoperative view, trigger least one of the tables in it,
or summary table. ″<table-name>″, has one or more
of its parts in another table space.
Explanation: An existing inoperative view,
trigger or summary table “<name>” was Explanation: A table in the specified table space
replaced by: does not contain all of its parts in that table
v the new view definition as a result of a space. If more than one table spaces are
CREATE VIEW statement specified, then a table in one of the specified
table spaces does not contain all of its parts in
v the new trigger definition as a result of a
the list. The base table, indexes, or long data may
CREATE TRIGGER statement
be in another table space, so dropping the table
v the new summary table definition as a result space(s) will not completely drop the table. This
of a CREATE SUMMARY TABLE statement. would leave the table in an inconsistent state and
User Response: None required. therefore the table space(s) cannot be dropped.

sqlcode: +280 User Response: Ensure that all objects

contained in table space ″<tablespace-name>″
sqlstate: 01595 contain all their parts in this table space before
attempting to drop it, or include those table
spaces containing the parts in the list to be
SQL0281N Table space ″<tablespace-name>″
dropped.
cannot be altered with additional
containers because it is a system This may require dropping the table
managed table space. ″<table-name>″ before dropping the table space.
Explanation: Additional containers cannot be sqlcode: -282
added to a system managed table space. The
exception to this is when a nodegroup was sqlstate: 55024
modified to add a node without table spaces,
then containers can be added once on the new SQL0283N System temporary table space
node using the ALTER TABLESPACE command. ″<tablespace-name>″ cannot be
In general, the table space must be managed by dropped because it is the only
the database in order to add additional system temporary table space with
containers. a “<page-size>” page size in the
The statement cannot be processed. database.

User Response: To add more containers to a Explanation: A database must contain at least
system managed table space, drop and recreate one system temporary table space with the same
the table space with more containers, ensuring page size as the page size of the catalog
that each container is of the same size and less tablespace. Dropping table space
than the container size limit, or change to a DMS “<tablespace-name>” would remove the last
table space. system temporary tablespace with a
“<page-size>” page size from the database.
sqlcode: -281
User Response: Ensure there will be another
sqlstate: 42921 system temporary table space with a
“<page-size>” page size in the database before
attempting to drop this table space.
sqlcode: -283

Chapter 2. SQL Messages 45

sqlstate: 55026 User Response: Either specify a database
managed table space for the primary table space,
or do not assign the table parts to another table
SQL0284N The table was not created because
space.
the table space
“<tablespace-name>” following sqlcode: -285
the clause “<clause>” is a
sqlstate: 42839
“<tablespace-type>” table space.
Explanation: The CREATE TABLE or DECLARE
SQL0286N A default table space could not be
GLOBAL TEMPORARY TABLE statement
found with a pagesize of at least
specified a table space named
“<pagesize>” that authorization
“<tablespace-name>” following the clause
ID “<user-name>” is authorized
“<clause>” that is not a valid type of table space
to use.
for this clause.
Explanation: The CREATE TABLE or DECLARE
This can occur in the following situations:
GLOBAL TEMPORARY TABLE statement did
v for regular tables, “<tablespace-name>” was not specify a table space, and a table space of the
specified on the IN clause and the table space right type (USER TEMPORARY for declared
is not a REGULAR table space. temporary table) with sufficient page size (at
v for declared temporary tables, least “<pagesize>”), over which authorization ID
“<tablespace-name>” was specified on the IN “<user-name>” has USE privilege, could not be
clause and the table space is not a USER found.
TEMPORARY table space.
Sufficient page size for a table is determined by
v “<tablespace-name>” was specified on the either the byte count of the row or the number of
LONG IN clause and the table space is not a columns.
LONG, managed by database table space.
User Response: Ensure the existence of a table
v “<tablespace-name>” was specified on the
space of the correct type (REGULAR or USER
INDEX IN clause and the table space is not a
TEMPORARY) with a page size of at least
REGULAR, managed by database, table space.
“<pagesize>” and that authorization ID
User Response: Correct the CREATE TABLE “<user-name>” has USE privilege on this table
statement to specify a table space with the space.
correct type for the “<clause>” clause.
sqlcode: -286
sqlcode: -284
sqlstate: 42727
sqlstate: 42838
SQL0287N SYSCATSPACE cannot be used
SQL0285N The indexes and/or long columns for user objects.
for table ″<table-name>″ cannot
Explanation: The CREATE TABLE or GRANT
be assigned to separate table
USE OF TABLESPACE statement specified a
spaces because the primary table
table space named SYSCATSPACE which is
space ″<tablespace-name>″ is a
reserved for catalog tables.
system managed table space.
User Response: Specify a different table space
Explanation: If the primary table space is a
name.
system managed table space, all table parts must
be contained in that table space. A table can have sqlcode: -287
parts in separate table spaces only if the primary
table space, index table space and long table sqlstate: 42838
space are database managed table spaces.

46 Message Reference, Volume 2

 1. either switch to a DMS TABLESPACE or
SQL0288N A long table space cannot be
recreate the SMS TABLESPACE with more
defined using MANAGED BY
directories (PATHs) such that: (number of
SYSTEM.
directories) >= (max tablesize / maxfilesize).
Explanation: The table space being defined is Note that maximum file size is operating
for use with large objects and long strings. These system dependent.
can only be stored in table spaces that are 2. add new container(s) to the DMS table space
defined in database managed space. Thus a long and try the operation again, after the
table space cannot be defined to use system rebalancer has made the new pages available
managed space. for use.
User Response: Remove the keyword LONG or 3. drop unnecessary tables from this DMS table
change to MANAGED BY DATABASE in the space.
CREATE TABLESPACE statement. 4. wait for the rebalancer to make more
sqlcode: -288 progress.
5. perform the redirected restore again to larger
sqlstate: 42613
containers.
6. perform the redirected restore again to larger
SQL0289N Unable to allocate new pages in containers.
table space ″<tablespace-name>″.
7. perform the rollforward again allowing add
Explanation: One of the following conditions is containers, or perform a redirected restore to
true: larger containers.
1. One of the containers assigned to this SMS sqlcode: -289
table space has reached the maximum file
size. This is the likely cause of the error. sqlstate: 57011
2. All the containers assigned to this DMS table
space are full. This is the likely cause of the
SQL0290N Table space access is not allowed.
error.
3. The table space object table for this DMS Explanation: A process attempted to access a
table space is full. table space which is in an invalid state for which
the intended access is not allowed.
4. A rebalance is in progress, but has not
progressed far enough to enable the newly v If the table space is in a quiesced state, only
added space to be used. processes which also hold the table space in a
quiesced state are allowed access to the table
5. A redirected restore is being done to
space.
containers that are too small.
v If the table space is in any other state, only the
6. A rollforward is being done following a
process which is performing the action
redirected restore and all the containers
specified is allowed access to the table space.
assigned to this tablespace are full.
v A system or user temporary table space cannot
7. A rollforward skipping add containers is
be dropped which contains active system or
being done and all the containers assigned to
declared temporary tables.
this tablespace are full.
v The SET CONTAINER api cannot be used to
Details can be found in the system error log set the container list unless the table space is
and/or the database manager error log. in a ″restore pending″ state.
User Response: Perform the action Details can be found in the system error log
corresponding to the cause of the error: and/or the database manager error log.
User Response: Possible actions include:

Chapter 2. SQL Messages 47

v If the table space is in a quiesced state, sqlstate: 57047
attempt to acquire a quiesced share or
quiesced update state on the table space. Or,
SQL0293N Error accessing a table space
attempt to quiesce reset the table space.
container.
v If the table space is in any other state, wait
until the table space has returned to normal Explanation: This error may be caused by one
state before attempting to access the table of the following conditions:
space. v A container (directory, file or raw device) was
not found.
Refer to the Administration Guide for further
information about the table space states. v A container is not tagged as being owned by
the proper table space.
sqlcode: -290 v A container tag is corrupt.
This error can be returned during database
sqlstate: 55039
startup and during the processing of the ALTER
TABLESPACE SQL statement.
SQL0291N State transition not allowed on
table space. Details can be found in the system error log
and/or the database manager error log.
Explanation: An attempt was made to change
the state of a table space. Either the new state is User Response: Try the following actions:
not compatible with the current state of the table 1. Check that the directory, file, or device exists
space, or an attempt was made to turn off a and that the file system is mounted (if it is on
particular state and the table space was not in a separate file system). Containers must be
that state. readable and writable by the database
Details can be found in the system error log instance owner.
and/or the database manager error log. 2. If you have a recent backup, try restoring the
table space or database. If that fails because
User Response: Table space states change when
of the bad container and the container is not
a backup is taken, the load completes, the
a DEVICE type, try manually removing the
rollforward completes, etc., depending on the
container first.
current state of the table spaces. Refer to the
systems administration guide for further If the error was returned from the processing of
information about the table space states. an ALTER TABLESPACE SQL statement with the
SWITCH ONLINE option, then re-issue the
sqlcode: -291
statement after correcting the problem as
sqlstate: 55039 described above.

If the error persists, call your IBM service

SQL0292N An internal database file could
representative.
not be created.
Explanation: An internal database file could not sqlcode: -293
be created. Details can be found in the system
error log and/or the database manager error log. sqlstate: 57048
User Response: Check that the directory
containing the file is accessible (e.g. mounted) SQL0294N The container is already in use.
and writeable by the database instance owner.
Explanation: Table space containers may not be
sqlcode: -292 shared. The possible causes of this error include
the following.

48 Message Reference, Volume 2

v A CREATE TABLESPACE or ALTER v For the ALTER NODEGROUP statement,
TABLESPACE statement included a container reissue the statement using the WITHOUT
that is already in use by another table space. TABLESPACES clause, and then use the
v A CREATE TABLESPACE or ALTER ALTER TABLESPACE statement to create
TABLESPACE statement included a container unique containers for the new node.
from a table space that has been dropped but v For CREATE or ALTER TABLESPACE
the drop statement has not been committed. statements where the environment includes
v An ALTER NODEGROUP statement used to more than one logical node on a physical
add a node used the containers of a LIKE node, ensure that the same containers are not
node that is on the same physical node. These specified for such logical nodes.
containers would therefore already be in use. v For an ADD NODE command or API, reissue
v A CREATE TABLESPACE or ALTER the statement using the WITHOUT
TABLESPACE statement is attempting to use TABLESPACES clause, and then use the
the same container on more than one logical ALTER TABLESPACE statement to create
node on a single physical node. The same unique containers at the new node for the
containers cannot be used for more than one system temporary table spaces.
node on the same physical node. v If you are trying to use a DMS container that
v An ADD NODE command or API used the belonged to a database that no longer exists
containers from the system temporary table but was not dropped properly, then the
spaces of a LIKE node that is on the same db2untag utility can be used to remove the
physical node. These containers would DB2 container tag from it. When this tag is
therefore already be in use. removed DB2 considers the container to be
free and the container can be used in a
v A CREATE TABLESPACE or ALTER
CREATE TABLESPACE or ALTER
TABLESPACE statement included a DMS
TABLESPACE statement.
container from another database that no longer
exists but was not dropped properly. The NOTE: Use extreme caution with db2untag. If
container is not actually in use but it is tagged you issue a db2untag command against a
as being in use. Therefore, DB2 will not allow container that is still in use by a database, then
it to be used until it is untagged. However, it both the database that originally used the
is very important to verify that the container is container and the database that is now using
not in use by the same database or another the container will be corrupted.
database when untagging it. If the container is sqlcode: -294
in use when you untag it, the database(s)
involved will be corrupted. sqlstate: 42730
Details can be found in the system error log
and/or the database manager error log. SQL0295N The combined length for all
User Response: Ensure the containers are container names for the table
unique. space is too long.
v For the CREATE or ALTER TABLESPACE Explanation: The total space required to store
statement, specify a different container for the the list of containers exceeds the space allotted
table space. for this table space in the table space file.
v For the CREATE or ALTER TABLESPACE Details can be found in the system error log
statement including a container from a and/or the database manager error log.
dropped table space, try again after the drop
statement is committed or specify a different User Response: Try one or more of the
container. following:

Chapter 2. SQL Messages 49

v Use symbolic links, mounted file systems, etc. v Container paths must be valid fully-qualified
to shorten the new container names. absolute paths or valid relative paths. The
v Back up the table space and then use the latter are interpreted relative to the database
database administration utility to reduce the directory.
number and/or name lengths of the v For EXTEND or RESIZE operations the
containers. Restore the table space to the new specified container path must exist.
containers. v The path must be read/write accessible to the
sqlcode: -295 instance id (check file permissions on
UNIX-based systems).
sqlstate: 54034 v Containers must be of the type specified in the
command (directory, file or device).

SQL0296N Table space limit exceeded. v Containers (directories) in system managed

table spaces must be empty when designated
Explanation: This database contains the as containers and must not be nested
maximum number of table spaces. No more can underneath other containers.
be created. v The containers for one database must not be
Details can be found in the system error log located underneath the directory of another
and/or the database manager error log. database, and they may not be underneath any
directory that appears to be for another
User Response: Delete table spaces that are not database. This rules out any directory of the
being used any more. Combine small table form SQLnnnnn, where ’n’ is any digit.
spaces by moving all data into one of them and
v The container must be within the file size limit
deleting the other.
for the operating system.
sqlcode: -296 v Containers (files) for dropped database
sqlstate: 54035 managed table spaces can only be reused as
containers (directories) for system managed
table spaces after all agents terminate and vice
SQL0297N Pathname for container is too versa.
long.
v During a redirected restore, an SMS container
Explanation: The full path specifying the was specified for a DMS table space or a DMS
container name exceeds the maximum length container was specified for an SMS table
allowed. If the container was specified as a path space.
relative to the database directory, the v The specified type of the container for an
concatenation of these two values must not EXTEND or RESIZE operation does not match
exceed the maximum length. the type of the container (FILE or DEVICE)
Details can be found in the system error log that was specified when the container was
and/or the database manager error log. created.

User Response: Shorten the path length. This message will also be returned if any other
unexpected error occurred which prevents DB2
sqlcode: -297 from accessing the container.
sqlstate: 54036
Details can be found in the system error log
and/or the database manager error log.
SQL0298N Bad container path.
User Response: Specify another container
Explanation: The container path violates one of location or change the container to make it
the following requirements: acceptable to DB2 (such as changing file
permissions) and try again.

50 Message Reference, Volume 2

sqlcode: -298 Details can be found in the system error log
and/or the database manager error log.
sqlstate: 428B2
User Response: Choose another container and
try again.
SQL0299N Container is already assigned to
the table space. sqlcode: -299
Explanation: The container that you are sqlstate: 42731
attempting to add has already been assigned to
the table space.

SQL0300 - SQL0399
v The corresponding host variable or parameter
SQL0301N The value of a host variable in the
marker used in the SQL statement is defined
EXECUTE or OPEN statement
as numeric, but the input host variable
cannot be used because of its data
contains a numeric value that is too large.
type.
v The terminating NUL character is missing
Explanation: A host variable could not be used from the C language NUL-terminated
as specified in the statement because its data character string host variable.
type is incompatible with the intended use of its
v Federated system users: in a pass-through
value.
session, a data source-specific restriction might
This error can occur as a result of specifying an have been violated.
incorrect host variable or an incorrect SQLTYPE
This error occurs as a result of specifying either
value in a SQLDA on an EXECUTE or OPEN
an incorrect host variable or an incorrect
statement.
SQLLEN value in an SQLDA on an EXECUTE or
The statement cannot be processed. OPEN statement.
User Response: Verify that the data types of all
The statement cannot be processed.
host variables in the statement are compatible
with the manner in which they are used. User Response: Ensure that the input host
variable value is the correct type and length. If
sqlcode: -301
the input host variables supply values to
sqlstate: 07006 parameter markers, match values with the
implied data type and length of the parameter
marker.
SQL0302N The value of a host variable in the
EXECUTE or OPEN statement is Federated system users: for a pass-through
too large for its corresponding session, determine what data source is causing
use. the error (see the problem determination guide
for procedures to follow to identify the failing
Explanation: The value of an input host
data source). Examine the SQL dialect for that
variable was found to be too large for its use in
data source to determine which specific
the SELECT, VALUES, or prepared statement.
restriction has been violated, and adjust the
One of the following occurred:
failing statement as needed.
v The corresponding host variable or parameter
marker used in the SQL statement is defined sqlcode: -302
as string, but the input host variable contains a sqlstate: 22001, 22003
string that is too long.

Chapter 2. SQL Messages 51

SQL0303N A value cannot be assigned to a SQL0305N The NULL value cannot be
host variable in the SELECT, assigned to a host variable in the
VALUES, or FETCH statement SELECT or FETCH statement
because the data types are not because no indicator variable is
compatible. specified.
Explanation: An imbedded SELECT or VALUES Explanation: A FETCH or embedded SELECT
statement selects into a host variable, but the or VALUES operation resulted in the retrieval of
data type of the variable is not compatible with a NULL value to be inserted into a host variable
the data type of the corresponding SELECT-list for which no indicator variable was provided. An
or VALUES-list element. Both must be numeric, indicator variable must be supplied if a column
character, or graphic. For example, if the data can return a NULL value.
type of the column is date or time, the data type
The statement cannot be processed. No data was
of the variable must be character with an
retrieved.
appropriate minimum length.
User Response: Examine the definition of the
The statement cannot be processed.
FETCH or SELECT object table or the elements
User Response: Verify that the table definitions of the VALUES list. Correct the program to
are current and that the host variable has the provide indicator variables for all host variables
correct data type. where NULL values from those columns can be
retrieved.
sqlcode: -303
sqlcode: -305
sqlstate: 42806
sqlstate: 22002
SQL0304N A value cannot be assigned to a
host variable because the value is SQL0306N The host variable “<name>” is
not within the range of the host undefined.
variable’s data type.
Explanation: The host variable “<name>” is not
Explanation: A FETCH, VALUES, or SELECT declared in any DECLARE SECTION.
into a host variable list failed because the host
The statement cannot be processed.
variable was not large enough to hold the
retrieved value. User Response: Ensure that the host variable is
declared and the name spelled correctly.
The statement cannot be processed. No data was
retrieved.
SQL0307N The host variable “<name>” is
User Response: Verify that table definitions are
already defined.
current and that the host variable has the correct
data type. For the ranges of SQL data types, refer Explanation: The host variable “<name>” has
to the SQL Reference. already been declared in a DECLARE SECTION.
Federated system users: for the ranges of data The definition is ignored. The previous definition
types that are returned from a data source, refer is used.
to the documentation for that data source.
User Response: Ensure that the host variable
sqlcode: -304 name is spelled correctly and the name is
defined only once for each program.
sqlstate: 22001, 22003

52 Message Reference, Volume 2

 <var-number> (based at 1), was negative or
SQL0308N The limit on the number of host
greater than the maximum defined for that host
variables has been reached.
variable.
Explanation: The limit on the number of host
The statement cannot be processed.
variables is dependent on how many will fit in
the HOST_VARS column of SYSPLAN. This limit User Response: Correct the program to ensure
has been reached. that the lengths of all string host variables are
not negative or that they are not greater than the
The remaining variable declarations are ignored.
maximum allowed length.
User Response: Either simplify the program,
sqlcode: -311
split the program into smaller, separate
programs, or do both. sqlstate: 22501

SQL0309N The value of a host variable in the SQL0312N The host variable “<host-name>”
OPEN statement is NULL, but its is used in a dynamic SQL
corresponding use cannot be statement, a view definition, or a
NULL. trigger definition.
Explanation: The value of an input host Explanation: The host variable “<host-name>”
variable was found to be NULL but the appears in the SQL statement, but host variables
corresponding use in the SELECT, VALUES, or are not allowed in dynamic SQL statements, in
prepared statement did not specify an indicator the SELECT statement of a view definition, or in
variable. the triggered action of a trigger definition.
The statement cannot be processed. The statement cannot be processed.
User Response: Ensure you need a USING User Response: Use parameter markers (?)
clause. Otherwise, ensure an indicator variable is instead of host variables for dynamic SQL
specified only if required. statements. Do not use host variables and
parameter markers in view or trigger definitions.
sqlcode: -309
sqlcode: -312
sqlstate: 07002
sqlstate: 42618
SQL0310N SQL statement contains too many
host variables. SQL0313N The number of host variables in
the EXECUTE or OPEN statement
Explanation: The maximum number of host
is not equal to the number of
variables was exceeded in the statement.
input values required.
The statement cannot be processed.
Explanation: The number of host variables
User Response: Ensure the statement has fewer specified in the EXECUTE or OPEN statement is
host variables or is less complex. not the same as the number of host variables or
parameter markers (?) appearing in the SQL
statement.
SQL0311N The length of string host variable
number ″<var-number>″ is The statement cannot be processed.
negative or greater than the
User Response: Correct the application program
maximum.
so the number of host variables specified in the
Explanation: When evaluated, the length EXECUTE or OPEN statement and the number
specification for the string host variable, whose of host variables or parameter markers in the
entry in the SQLDA is indicated by SQL statement are the same.

Chapter 2. SQL Messages 53

sqlcode: -313
SQL0318N An END DECLARE SECTION
sqlstate: 07001, 07004 was found without a previous
BEGIN DECLARE SECTION.

SQL0314N The host variable “<name>” is Explanation: An END DECLARE SECTION

incorrectly declared. statement was found, but there was no previous
BEGIN DECLARE SECTION.
Explanation: The host variable “<name>” is not
declared correctly for one of the following The statement cannot be processed.
reasons:
User Response: Enter a BEGIN DECLARE
v The type specified is not one that is supported. SECTION before an END DECLARE SECTION.
v The length specification is 0, negative, or too
large.
SQL0324N The “<usage>” variable “<name>”
v An initializer is used. is the wrong type.
v An incorrect syntax is specified.
Explanation: Either the INDICATOR variable
The variable remains undefined. “<name>” is not a small integer or the
STATEMENT variable “<name>” is not a
User Response: Ensure that you correctly character data type.
specify only the declarations the database
manager supports. The statement cannot be processed.
User Response: Ensure that the variable is the
SQL0315N The host variable is incorrectly correct type and is specified correctly.
declared.
Explanation: The host variable is not declared SQL0332N There is no available conversion
correctly for one of the following reasons: for the source code page “<code
v The type specified is not one that is supported. page>” to the target code page
“<code page>”. Reason code
v The length specification is 0, negative or too “<reason-code>”.
large.
v An incorrect syntax is specified. Explanation: No conversion of data is
supported from the source code page to the
The variable remains undefined. target code page. This error can occur under the
following conditions:
User Response: Ensure that you correctly
specify only the declarations the database v An error has occurred executing an SQL
manager supports. statement. The data cannot be processed by
the database manager.
v An error has occurred when trying to import
SQL0317N No END DECLARE SECTION
or export a WSF or an IXF file. The import or
was found after a BEGIN
export will fail.
DECLARE SECTION.
v Federated system users: the data source does
Explanation: The end of input was reached not support the specified code page
during processing of a DECLARE SECTION. conversion.
Precompilation is terminated. v DB2 Connect users: both ″source code page″
and ″target code page″ may refer to a CCSID
User Response: Add an END DECLARE
on the host or AS/400 system.
SECTION statement to end a DECLARE
SECTION. The reason codes are as follows:

54 Message Reference, Volume 2

1 source and target code page v Change the unsupported code page(s) to one
combination is not supported by the of the documented pairs.
database manager.
AS/400 users should be aware that AS/400
2 source and target code page CCSID 65535 is not supported. AS/400 data
combination is either not supported by encoded using CCSID 65535 must be converted
the database manager or by the to a supported CCSID before it can be accessed
operating system character conversion using DB2 Connect.
utility on the client node.
Federated system users: for data source code
3 source and target code page
page support, see the Installation and
combination is either not supported by
Configuration Supplement.
the database manager or by the
operating system character conversion
utility on the server node. sqlcode: -332

User Response: Possible solutions include: sqlstate: 57017

v Verify that data conversion between the source
and target code page is supported by the
SQL0334N Overflow occurred while
database manager. For database manager code
performing conversion from
page support, check the Quick Beginnings. If
codepage ″<source>″ to codepage
DB2 Connect is being used, check the DB2
″<target>″. The maximum size of
Connect Quick Beginnings.
the target area was ″<max-len>″.
v Data conversion for some code page The source string length was
combinations may be supported through ″<source-len>″ and its
database manager install options, depending hexadecimal representation was
on the language group of the source or target ″<string>″.
code page. Ensure that the appropriate ones
are installed and accessible to the database Explanation: During the execution of the SQL
manager and the client application, as statement, a code page conversion operation has
indicated by the reason code returned. For a resulted in a string that is longer than the
list of install options, consult the Quick maximum size of the target object.
Beginnings or the DB2 Connect Quick User Response: Modify the data to avoid the
Beginnings. overflow condition, depending on the
v Data conversion for some code page circumstances, by:
combinations may be supported by the v decreasing the length of the source string or
database manager through an operating increasing the size of the target object (please
system-provided character conversion utility, refer to the note below),
depending on the language group of the
v altering the operation, or,
source or target code page. Check your
operating system documentation for a list of v ensuring that the application codepage and the
supported conversions and ensure that the database codepage are the same. This
appropriate ones are installed and accessible to eliminates the need for codepage conversions
the database manager and the client for most connections.
application, as indicated by the reason code
returned. For a list of operating system Note: Automatic promotion of character or
conversion utilities used, consult the Quick graphic string data types will not occur as
Beginnings or the DB2 Connect Quick part of character conversion. If the
Beginnings. resultant string length exceeds the
maximum length of the data type of the
source string then an overflow has

Chapter 2. SQL Messages 55

 occurred. To correct this situation either
SQL0340N The common table expression
change the data type of the source string
“<name>” has the same identifier
or use data type casting to allow for an
as another occurrence of a
increase in the string length due to
common table expression
conversion.
definition within the same
statement.
sqlcode: -334
Explanation: The common table expression
sqlstate: 22524 name “<name>” is used in the definition of more
than one common table expressions in the
statement. The name used to describe a common
SQL0338N An ON clause associated with a table expression must be unique within the same
JOIN operator is not valid. statement.
Explanation: An ON clause associated with a The statement cannot be processed.
JOIN operator is not valid for one of the
following reasons. User Response: Change the name of one of the
common table expressions.
v The join condition cannot include any
subqueries. sqlcode: -340
v Column references in an ON clause must only sqlstate: 42726
reference columns of tables that are in the
scope of the ON clause (included in the same
joined-table clause as the ON clause). SQL0341N A cyclic reference exists between
v Scalar fullselects are not allowed in the the common table expressions
expressions of an ON clause. “<name1>” and “<name2>”.

v A function referenced in an ON clause of a full Explanation: The common table expression

outer join must be deterministic and have no “<name1>” refers to “<name2>” in a FROM
external action. clause within its fullselect and “<name2>” refers
v A dereference operation (->) cannot be used. to “<name1>” in a FROM clause within its
fullselects. Such forms of cyclic references are not
v A SQL function or SQL method cannot be allowed.
used.
The statement cannot be processed.
The statement cannot be processed.
User Response: Remove the cyclic reference
User Response: Correct the ON clause to from one of the common table expressions.
reference appropriate columns or delete any
subqueries or scalar fullselects. Remove any sqlcode: -341
dereference operations, SQL functions, or SQL
sqlstate: 42835
methods from the ON clause.
If using full outer join ensure that all functions in
SQL0342N The common table expression
the ON clause are deterministic and have no
“<name>” cannot use SELECT
external action.
DISTINCT and must use UNION
sqlcode: -338 ALL because it is recursive.

sqlstate: 42972 Explanation: There are two possible

explanations:

56 Message Reference, Volume 2

v A fullselect within the common table fullselect has a different data type, length or code
expression “<name>” cannot start with page that may result in failure to assign the
SELECT DISTINCT because the common table value for the column.
expression is recursive.
The statement cannot be processed.
v A fullselect within the common table
expression “<name>” specified UNION User Response: Correct the column used in the
instead of UNION ALL as required for fullselects of the recursive common table
recursive common table expressions. expression so that the initialization column
matches the iterative columns.
The statement cannot be processed.
sqlcode: -344
User Response: Remove the keyword
DISTINCT from the common table expression, sqlstate: 42825
add the keyword ALL following UNION, or
remove the recursive reference within the SQL0345N The fullselect of the recursive
common table expression. common table expression
sqlcode: -342 “<name>” must be the UNION of
two or more fullselects and cannot
sqlstate: 42925 include column functions,
GROUP BY clause, HAVING
SQL0343N The column names are required clause, or an explicit join
for the recursive common table including an ON clause.
expression “<name>”. Explanation: The common table expression
Explanation: The recursive common table “<name>” includes a reference to itself and
expression “<name>” must include the therefore:
specification of the column names following the v must be the union of two or more fullselects
identifier of the common table expression. v cannot include a GROUP BY clause
The statement cannot be processed. v cannot have column functions
User Response: Add column names following v cannot include a HAVING clause
the identifier of the common table expression. v and cannot include an explicit join with an ON
clause.
sqlcode: -343
The statement cannot be processed.
sqlstate: 42908
User Response: Change the common table
expression by:
SQL0344N The recursive common table
expression “<name>” has v making it a union of two or more fullselects
mismatched data types, lengths or v removing any column functions, GROUP BY
code pages for column clause, HAVING clause, or explicit JOIN
“<column-name>”. including an ON clause.
Explanation: The recursive common table v removing the recursive reference.
expression “<name>” has a column sqlcode: -345
“<column-name>” that is referred to in the
iterative fullselect of the common table sqlstate: 42836
expression. The data type, length and code page
are set based on the initialization fullselect for
this column. The result of the expression for the
column “<column-name>” in the iterative

Chapter 2. SQL Messages 57

 v incrementing an INTEGER column in the
SQL0346N An invalid reference to common
iterative select list by 1.
table expression “<name>” occurs
in the first fullselect, as a second v a predicate in the where clause of the iterative
occurrence in the same FROM portion of the form ″counter_col < constant″ or
clause, or in the FROM clause of ″counter_col < :hostvar″.
a subquery. The absence of this syntax in the recursive
Explanation: The common table expression common table expression may result in an
“<name>” includes an invalid reference to itself infinite loop. The data or some other
as described by one of the following. characteristic of the recursive common table
expression may allow the successful completion
v A recursive reference in the first fullselect
of the statement anyway.
before the UNION ALL set operator. The first
fullselect must be an initialization and cannot User Response: To prevent an infinite loop,
include a recursive reference. include the expected syntax as described.
v More than one reference to the same common sqlcode: +347
table expression in the same FROM clause.
Such references are not permitted in recursive sqlstate: 01605
common table expression.
v A recursive reference in the FROM clause of a SQL0350N LOB, DATALINK, or structured
subquery. A recursion cycle cannot be defined type column “<column-name>”
using a subquery. cannot be used in an index, a key,
The statement cannot be processed. a unique constraint, a generated
column, or a declared temporary
User Response: Change one of the following: table.
v the fullselect prior to the union operator so Explanation: Even in cases where it would not
that it does not include a recursive reference violate the maximum size of an index, key, or
v the FROM clause containing more than one unique constraint, a LOB column, DATALINK
reference to the same common table expression column, or structured type column cannot be
to just one reference used in an index, key or unique constraint. These
v the FROM clause of the subquery so that it data types are also not supported as column
does not reference the common table types of a generated column or a declared
expression. temporary table. This restriction includes the use
of distinct type column based on a LOB or
sqlcode: -346 DATALINK.

sqlstate: 42836 The statement cannot be processed.

User Response: Remove the LOB, DATALINK
SQL0347W The recursive common table or structured type column from the specification
expression “<name>” may contain of the index, key, unique constraint, generated
an infinite loop. column, or declared temporary table. An index
defined on a structured type column may be
Explanation: The recursive common table defined using an index extension.
expression called “<name>” may not complete.
This warning is based on not finding specific sqlcode: -350
syntax as part of the iterative portion of the sqlstate: 42962
recursive common table expression. The expected
syntax includes:

58 Message Reference, Volume 2

SQL0351N An unsupported SQLTYPE was SQL0355N The column ″<column-name>″, as
encountered in position defined, is too large to be logged.
“<position-number>” of the
Explanation: Large Object data types (BLOB,
output SQLDA (select list).
CLOB, and DBCLOB) may be created in sizes up
Explanation: The element of the SQLDA at to 2 gigabytes (2147483647 bytes). Logging of
position “<position-number>” is for a data type data values is allowed only upon objects which
that either the application requestor or the are less than or equal to than 1 gigabyte
application server does not support. If the (1073741823 bytes) in size. Therefore, large
application is not using the SQLDA directly, objects greater than 1 gigabyte in size can not be
“<position-number>” could represent the logged.
position of an element in the select list or a
User Response: Either explicitly indicate
parameter of a CALL statement.
logging of data is not required, by using the
The statement cannot be processed. NOT LOGGED phrase during column creation,
or reduce the maximum size of the column to 1
User Response: Change the statement to
gigabyte or below.
exclude the unsupported data type. For a select
statement, remove the names of any columns in sqlcode: -355
the select-list with the unsupported data type or
sqlstate: 42993
use a cast in the query to cast the column to a
supported data type.
SQL0357N The DB2 Data Links Manager
sqlcode: -351
“<name>” is not currently
sqlstate: 56084 available. Reason code =
“<reason-code>”.
SQL0352N An unsupported SQLTYPE was Explanation:
encountered in position
The statement requires processing on the DB2
“<position-number>” of the input
Data Links Manager “<name>”. The DB2 Data
list (SQLDA).
Links Manager is not currently available as
Explanation: The element of the SQLDA at indicated by the reason code.
position “<position-number>” is for a data type
01 The DB2 Data Links Manager is not
that either the application requestor or the
available.
application server does not support. If the
application is not using the SQLDA directly, 02 The database server, instance, or
“<position-number>” could represent the database from which the operation was
position of an input host variable, parameter attempted is not registered with the
marker, or a parameter of a CALL statement. appropriate DB2 Data Links Manager.
The statement cannot be processed. 03 Access to the DB2 Data Links Manager
is currently disallowed.
User Response: Change the statement to
exclude the unsupported data type. 04 The DB2 Data Links Manager is
registered with the database but is an
sqlcode: -352
unknown server.
sqlstate: 56084
05 An error occurred while communicating
with the DB2 Data Links Manager.
06 The installation type of the DB2 Data
Links Manager is not compatible with
that registered to the database.

Chapter 2. SQL Messages 59

The statement cannot be processed.
SQL0358N Unable to access file referenced
User Response: The action depends on the by a DATALINK value. Reason
reason code as follows. code = “<reason-code>”.

01 The DB2 Data Links Manager or a Explanation: A DATALINK value could not be
communication link may be down. Wait assigned. The possible reason codes are as
a while and try again, or check with the follows:
DB2 Data Links Manager administrator.
21 DATALINK value data location format
If the problem persists, disconnect the
is not valid.
application from the database, and retry
after connecting again. 22 DATALINK value DB2 Data Links
manager is not registered with the
02 Register the database server, instance, or
database.
database with the DB2 Data Links
Manager. 23 DATALINK linktype value is not valid.
03 Access to the DB2 Data Links Manager 24 DATALINK value referenced file cannot
is disallowed until DB2 can ensure that be found by a DB2 Data Links Manager.
it is in a consistent state. Wait until DB2
25 DATALINK value referenced file is
does this asynchronously. It is possible
already linked to a database.
that DB2 is unable to do this because of
conditions in other reason codes. So, if 26 DATALINK value referenced file cannot
the problem persists, check the be accessed for linking. It may be a
db2diag.log file of the instance to find directory, a symbolic link or a file with
out the condition and correct that permission bit for set user ID (SUID) on
condition. For more information, refer to or set group ID (SGID) on.
the Administration Guide for
information on crash recovery for DB2 27 DATALINK value data location or
Data Links Managers. comment is too long.

04 Check that the DB2 Data Links Manager 28 Existing registry on the DB2 Data Links
configured to the database is available Manager does not allow this file to be
on the network. linked (No matching prefix on DLFM).

05 Check that the DB2 Data Links Manager 29 The DB2 Data Links Manager does not
and the communication link are up. If authorize the DB2 user to link this file.
the problem persists, disconnect the 30 A link is already in progress for the file
application from the database, and retry by another application.
after connecting again.
31 File copy by the DB2 Data Links
06 If the DB2 Data Links Manager was Manager is not complete for the file to
installed for DFS, then it must added as be unlinked. The statement cannot be
a CELL to the database. If it was processed.
installed for native file systems, then it
must be added as a NODE. Refer to the User Response: The action is based on the
Command Reference for details on ADD reason code as follows.
DATALINKS MANAGER command. 21 Correct the data location format. If
hostname is not specified, DB2 can use
sqlcode: -0357 the local hostname as default only if the
database manager configuration
sqlstate: 57050 parameter Datalinks is set to YES.
22 Ensure that the correct DB2 Data Links

60 Message Reference, Volume 2

 Manager is specified and if so have it with a different data type for the identity
registered to the database. Registered column, specifying a data type that has a larger
DB2 Data Links Managers are ignored range of values than the current data type for the
unless the database manager identity column.
configuration parameter Datalinks is set
sqlcode: -359
to YES.
sqlstate: 23522
23 Correct the linktype value.
24 Check that the correct file is specified
SQL0360W DATALINK values may not be
and that the file exists.
valid because the table
25 Either unlink the existing reference to “<table-name>” is in Datalink
the file or do not specify the file in this Reconcile Pending (DRP) or
statement. Datalink Reconcile Not Possible
(DRNP) state.
26 Linking of directories is not allowed.
Use the actual file name, not the Explanation: DATALINK values in table
symbolic link. If SUID or SGID is on, “<table-name>” may not be valid because the
this file cannot be linked using a table is either in Datalink Reconcile Pending
DATALINK type. (DRP) or Datalink Reconcile Not Possible
(DRNP) state. While in either of these states,
27 Reduce the length of the data location
control of the files on the DB2 Data Links
value or the comment.
Manager is not guaranteed.
28 Contact the DB2 Data Links Manger
Statement processing continues.
administrator to add the registration
necessary to link this file. User Response: Refer to the Administration
Guide for information on Datalink Reconcile
29 Contact the DB2 Data Links Manager
Pending (DRP) and Datalink Reconcile Not
administrator to get the necessary
Possible (DRNP) states to take appropriate
authorization.
action.
30 Do not link this file or retry later.
sqlcode: +360
31 Allow some time for the file copy to
sqlstate: 01627
complete and retry later.

sqlcode: -0358 SQL0368N The DB2 Data Links Manager

“<name>” is not registered to the
sqlstate: 428D1 database.
Explanation: A DATALINK value already exists
SQL0359N The range of values for the that references the DB2 Data Links Manager
identity column is exhausted. “<name>” that is not registered to the database.

Explanation: DB2 attempted to generate a value The statement cannot be processed.

for an identity column, however all allowable User Response: Contact the database
values for the identity column have already been administrator to determine why the DB2 Data
assigned. Links Manager is no longer registered.
The statement cannot be processed. sqlcode: -0368
User Response: Redefine the table with a larger sqlstate: 55022
range of values for the identity column. To do
this, drop the existing table. Recreate the table

Chapter 2. SQL Messages 61

SQL0370N The parameter in position “<n>” SQL0373N The DEFAULT clause cannot be
must be named in the CREATE specified for GENERATED
FUNCTION statement for column “<column-name>”.
LANGUAGE SQL function
Explanation: A DEFAULT clause may not be
“<name>”.
specified for a column which has been identified
Explanation: All parameters for functions as a GENERATED column.
defined with LANGUAGE SQL must have a
The statement cannot be processed.
parameter-name for each parameter.
User Response: Remove the DEFAULT clause
The statement cannot be processed.
and resubmit the statement.
User Response: Include a parameter name for
sqlcode: -373
each parameter of the function.
sqlstate: 42623
sqlcode: -370
sqlstate: 42601
SQL0374N The “<clause>” clause has not
been specified in the CREATE
SQL0372N Only one IDENTITY or ROWID FUNCTION statement for
column is allowed in a table. LANGUAGE SQL function
“<function name>” but an
Explanation: An attempt was made to do one
examination of the function body
of the following:
reveals that it should be specified.
v Create a table with more than one IDENTITY
column. Explanation: The following situations may be
the cause of this error.
v Add an IDENTITY column to a table which
already has one. NOT DETERMINISTIC must be specified if
v Create a table with more than one ROWID either of the following conditions apply within
column. the body of the function:
v Add a ROWID column to a table which v a function that has the NOT DETERMINISTIC
already has one. property is called,
v a special register is accessed.
The statement cannot be processed.
READS SQL DATA must be specified if the body
User Response: For a CREATE TABLE
of the function defined with LANGUAGE SQL
statement, select only one column to have the
contains a subselect or if it calls a function that
ROWID data type or the IDENTITY attribute. For
can read sql data.
an ALTER TABLE statement, a ROWID column
or IDENTITY column already exists for the table.
EXTERNAL ACTION must be specified if the
Do not attempt to add another column with data
body of the function defined with LANGUAGE
type ROWID or with the IDENTITY attribute to
SQL calls a function that has the EXTERNAL
the table.
ACTION property.
sqlcode: -372
The statement cannot be processed.
sqlstate: 428C1
User Response: Either specify the clause or
change the function body.
sqlcode: -374
sqlstate: 428C2

62 Message Reference, Volume 2

SQL0385W Assignment to an SQLSTATE or SQL0389N The specific function instance
SQLCODE variable in an SQL “<specific name>” identified in a
routine may be over-written and CREATE CAST statement either
does not activate any handler. has more than one parameter, has
a parameter that does not match
Explanation: The SQL routine includes at least
the source data type, or returns a
one statement that assigns a value to the
data type that does not match the
SQLSTATE or SQLCODE special variables. These
target.
variables are assigned values by processing of
SQL statements in the SQL routine. The value Explanation: A cast function must
assigned may therefore be over-written as a v have exactly one parameter,
result of the SQL statement processing.
v the data type of the parameter must be the
Furthermore, the assignment of a value to the
same as the source data type,
SQLSTATE special variable does not activate any
handlers. v the result data type must be the same as the
target data type.
The routine definition was processed
successfully. The statement cannot be processed.

User Response: None required. Remove any User Response: Either chose a different function
assignments to the SQLSTATE or SQLCODE instance, change the source data type, or change
special variable to prevent the warning. the target data type.

sqlcode: +385 sqlcode: -389

sqlstate: 01643 sqlstate: 428DG

SQL0388N In a CREATE CAST statement for SQL0390N The function ″<function-name>″

function “<function-name>”, resolved to specific function
either the source “<source data ″<specific-name>″ that is not valid
type name>” and target in the context where it is used.
“<target-data-type-name>” are Explanation: A function resolved to a specific
both built-in types or they are the function that is not valid in the context where it
same type. is used. If ″<specific-name>″ is an empty string,
Explanation: One of the data types must be a then the function resolved to the built-in function
user-defined type. The source type and the target identified by ″<function-name>″. Some of the
type cannot be the same data type. possible situations include:
v the specific function is a table function where
The statement cannot be processed.
only a scalar, column, or row function is
User Response: Change the data type of either expected (such as creating a sourced scalar
the source or the target. function).
sqlcode: -388 v the specific function is a scalar, column, or row
function where only a table function is
sqlstate: 428DF expected (such as in the FROM clause of a
query).
v the specific function is a row function where
only a scalar or column function is expected.
The statement cannot be processed.
User Response: Ensure that the correct function

Chapter 2. SQL Messages 63

name and arguments are specified and that the include the situation involving a result column
current path includes the schema where the of an outer join where NULL producing rows
correct function is defined. You may need to are possible.
change the function name, the current path v The function cannot be used on rows from a
(using SET CURRENT FUNCTION PATH or the replicated summary table.
FUNCPATH bind option), or change the context
in which the function is used. The statement cannot be processed.

sqlcode: -390 User Response: Remove ″<function-name>″

from the context where it is not allowed.
sqlstate: 42887
sqlcode: -391

SQL0391N Invalid use of the row based sqlstate: 42881

function ″<function_name>″.
Explanation: The statement uses a row based SQL0392N SQLDA provided for cursor
function ″<function_name>″ that cannot be used ″<cursor>″ has been changed from
for one of the following reasons: the previous fetch.
v The function is used in a GROUP BY or a Explanation: The application is running with
HAVING clause but is not also included in the DB2 rules, and has requested that LOB data be
select list. returned as a LOB in one FETCH statement, and
v The function cannot be used in this context as a locator in another FETCH statement. This is
because of the recursive nature of the not permitted.
statement. User Response: The statement cannot be
v The function cannot be used in a check executed.
constraint.
Either do not use DB2 rules, or change the
v The function cannot be used in a generated application to not change the data type code
column. from LOB to locator (or the reverse) in the
v The function cannot be used in a view SQLDA between successive fetches.
definition where the WITH CHECK OPTION
clause is specified or any view dependent on sqlcode: -392
such a view having the WITH CHECK sqlstate: 42855
OPTION clause specified.
v The function has an argument that does not
resolve to a row of a base table. This would

SQL0400 - SQL0499
Some data sources do not provide the
SQL0401N The data types of the operands for
appropriate values for “<operator>”. In these
the operation “<operator>” are not
cases the message token will have the following
compatible.
format: “<data source>:UNKNOWN”, indicating
Explanation: The operation “<operator>” that the actual value for the specified data source
appearing within the SQL statement has a is unknown.
mixture of numeric and nonnumeric operands, or
The statement cannot be processed.
the operation operands are not compatible.
User Response: Check all operand data types to
Federated system users: this data type violation
ensure that they are comparable and compatible
can be at the data source or at the federated
with the statement usage.
server.

64 Message Reference, Volume 2

If all the SQL statement operands are correct and (other than CREATE ALIAS) can successfully use
accessing a view, check the data types of all the the newly created alias. The specified alias
view operands. <name> is created.
Federated system users: if the reason is
An inoperative view is considered to be
unknown, isolate the problem to the data source
undefined for the purposes of creating an alias.
failing the request (see the Problem Determination
Guide for procedures to follow to identify the User Response: Ensure that the undefined
failing data source) and examine the data type object <name2> is defined prior to using the
restrictions for that data source. newly created alias in an SQL statement (other
than CREATE ALIAS).
sqlcode: -401
sqlcode: +403
sqlstate: 42818
sqlstate: 01522
SQL0402N The data type of an operand of an
arithmetic function or operation SQL0404N A string in the UPDATE or
“<operator>” is not numeric. INSERT statement is too long for
column “<name>”.
Explanation: A nonnumeric operand is specified
for the arithmetic function or operator Explanation: An INSERT or UPDATE statement
“<operator>”. specifies a value that is longer than the
maximum-length string that can be stored in the
The statement cannot be processed.
column indicated.
User Response: Correct the SQL statement
The statement cannot be processed.
syntax so all specified function or operator
operands are numeric.
Note: “<name>” may or may not be returned in
Federated system users: if the reason is SQLCA, depending on the INSERT or
unknown, isolate the problem to the data source UPDATE statement syntax.
failing the request (see the problem
determination guide for procedures to follow to User Response: Check the length of the object
identify the failing data source) and examine the column and correct the program or SQL
operators applied to that data source. statement so the insert or update string does not
exceed the maximum length.
sqlcode: -402
sqlcode: -404
sqlstate: 42819
sqlstate: 22001

SQL0403W The newly defined alias

″<name>″ resolved to the object SQL0405N The numeric literal “<literal>” is
″<name2>″ which is currently not valid because its value is out
undefined. of range.

Explanation: The alias <name> has been Explanation: The specified numeric literal is not
defined upon: in the acceptable range.

v a table or view which currently is not defined The proper ranges for SQL values are as follows:
in the database v For FLOAT values:
v another alias which resolves to a table or view – 0
which is not defined in the database.
– In the positive range of +2.225E-307 to
The object <name2> is the undefined object. This +1.79769E+308
object must exist before any SQL statement

Chapter 2. SQL Messages 65

 – In the negative range of -1.79769E+308 to outside the target column range. This problem
-2.225E-307. may be caused by the values occurring in the
v -9999999999999999999999999999999. to object column, the SQL operation being
9999999999999999999999999999999. for performed on those values, or both.
DECIMAL values The statement cannot be processed.
v -2147483647 to 2147483647 for INTEGER
User Response: See the explanation of message
values
SQL0405 for ranges allowed for numeric data
v -32768 to +32767 for small integer types.
(SMALLINT) values.
NOTE: For system catalog updates, see the SQL
In certain contexts the literal may have further Reference for valid ranges in various columns of
restrictions that result in this error. For more updateable catalogs.
information, look up the statement or clause in
the SQL Reference. sqlcode: -406
sqlstate: 22003
Federated system users: this range violation can
be at the data source or at the federated server.
The proper ranges for SQL values located in data SQL0407N Assignment of a NULL value to a
source tables depend on the data source. To NOT NULL column “<name>” is
determine the correct range, see the appropriate not allowed.
documentation for the data source. Some data Explanation: One of the following occurred:
sources do not provide the appropriate values for
“<literal>”. In these cases the message token will v The update or insert value was NULL, but the
have the following format: “<data object column was declared as NOT NULL in
source>:UNKNOWN”, indicating that the actual the table definition. Consequently:
value for the specified data source is unknown. – NULL values cannot be inserted into that
column.
The statement cannot be processed. – An update cannot set values in that column
to NULL.
User Response: Reduce the literal value to the
appropriate size. – A SET transition-variable statement in a
trigger cannot set values in that column to
Federated system users: if the reason is NULL.
unknown, isolate the problem to the data source
v The update or insert value was DEFAULT, but
failing the request (see the problem
the object column was declared as NOT NULL
determination guide for procedures to follow to
without WITH DEFAULT in the table
identify the failing data source) and examine the
definition. Consequently:
data range restrictions for that data source.
– A default value of NULL cannot be inserted
sqlcode: -405 into that column.
sqlstate: 42820 – An update cannot set default values of
NULL in that column.
SQL0406N A numeric value in the UPDATE – A SET transition-variable statement in a
or INSERT statement is not trigger cannot set default values of NULL in
within the range of its target that column.
column. v The column name list for the INSERT
statement omits a column declared NOT
Explanation: The value of a host variable or a
NULL and without WITH DEFAULT in the
numeric value calculated during processing of
table definition.
the UPDATE or INSERT SQL statement is

66 Message Reference, Volume 2

v The view for the INSERT statement omits a Federated system users: if the reason is
column declared NOT NULL and without unknown, isolate the problem to the data source
WITH DEFAULT in the base table definition. failing the request (see the problem
determination guide for procedures to follow to
If the value for “<name>” is of the form
identify the failing data source) and examine the
“TBSPACEID=n1, TABLEID=n2, COLNO=n3”,
object definition for that data source. Remember
then the column name from the SQL statement
that the defaults (NULL and NOT NULL) are not
was not available when the error was issued. The
necessarily the same between data sources.
values provided identify the tablespace, table,
and column number of the base table that does
sqlcode: -407
not allow NULL value.
sqlstate: 23502
Federated system users: this situation can be
detected by the federated server or by the data
source. Some data sources do not provide the SQL0408N A value is not compatible with
appropriate values for “<name>”. In these cases the data type of its assignment
the message token will have the following target. Target name is “<name>”.
format: “<data source>:UNKNOWN”, indicating
that the actual value for the specified data source Explanation: The data type of the value to be
is unknown. assigned to the column, parameter, SQL variable,
or transition variable by the SQL statement is
incompatible with the declared data type of the
The statement cannot be processed.
assignment target. Both must be:
Note: Under some circumstances, the token v Numeric
“<name>” may not be filled in (sqlerrmc v Character
field of the SQLCA not filled in). v Graphic
User Response: Correct the SQL statement after v Dates or character
examining the object table definition to v Times or character
determine which columns of the table have the
v Timestamps or character
NOT NULL attribute and do not have the WITH
DEFAULT attribute. v Datalinks
v The same distinct types
If the value for “<name>” is of the form
“TBSPACEID=n1, TABLEID=n2, COLNO=n3”, v Reference types where the target type of the
you can determine the table name and column value is a subtype of the target type of the
name using the following query: column.
SELECT C.TABSCHEMA, C.TABNAME, C.COLNAME v The same user-defined structured types. Or,
FROM SYSCAT.TABLES AS T, the static type of the value must be a subtype
SYSCAT.COLUMNS AS C of the static type (declared type) of the target.
WHERE T.TBSPACEID = n1
AND T.TABLEID = n2 The statement cannot be processed.
AND C.COLNO = n3 User Response: Examine the statement and
AND C.TABSCHEMA = T.TABSCHEMA
possibly the target table or view to determine the
AND C.TABNAME = T.TABNAME
target data type. Ensure the variable, expression,
or literal value assigned has the proper data type
The table and column identified by this query
for the assignment target.
may be the base table of a view for which the
SQL statement failed. sqlcode: -408
sqlstate: 42821

Chapter 2. SQL Messages 67

SQL0409N The operand of a COUNT SQL0413N Overflow occurred during
function is not valid. numeric data type conversion.
Explanation: As specified in the SQL statement, Explanation: During processing of the SQL
the operand of the COUNT function does not statement, an overflow condition arose when
conform to the rules of SQL syntax. Only converting from one numeric type to another.
COUNT(*) and COUNT(DISTINCT column) are Numeric conversion is performed according to
allowed. the standard rules of SQL.
The statement cannot be processed. Federated system users: numeric conversion can
occur at the federated server, at data sources, or
User Response: Specify COUNT(*) or
both.
COUNT(DISTINCT column).
The statement cannot be processed. No data was
NOTE: This message is only applicable to
retrieved, updated, or deleted.
versions of DB2 prior to Version 2.
User Response: Examine the syntax of the SQL
sqlcode: -409
statement to determine the cause of the error. If
sqlstate: 42607 the problem is data-dependent, it may be
necessary to examine the data processed at the
time of the error.
SQL0410N The floating point literal
“<literal>” contains more than 30 Federated system users: if the reason is
characters. unknown, isolate the problem to the data source
failing the request (see the problem
Explanation: The specified floating point literal determination guide for procedures to follow to
is more than 30 characters in length, excluding identify the failing data source) and examine the
leading zeros. A floating point literal has a data range restrictions for that data source.
maximum length of 30 characters.
sqlcode: -413
The statement cannot be processed.
sqlstate: 22003
User Response: Shorten the specified literal.
sqlcode: -410 SQL0415N The data types of corresponding
sqlstate: 42820 columns are not compatible in a
fullselect that includes a set
operator or in the multiple rows
SQL0412N Multiple columns are returned of a VALUES clause of an
from a subquery that is allowed INSERT or fullselect.
only one column.
Explanation: There are various statements
Explanation: In the context of the SQL where this error may occur.
statement, a fullselect is specified that can have
v It may occur within a SELECT or VALUES
only one column as a result.
statement that includes set operations
The statement cannot be processed. (UNION, INTERSECT, or EXCEPT). The
corresponding columns of the subselects or
User Response: Specify only one column when
fullselects that make up the SELECT or
only a scalar fullselect is allowed.
VALUES statements are not compatible.
sqlcode: -412 v It may occur within an INSERT statement that
sqlstate: 42823 is inserting multiple rows. In this case, the
corresponding columns of the rows specified
in the VALUES clause are not compatible.

68 Message Reference, Volume 2

v It may occur within a SELECT or VALUES sqlcode: -416
statement where the VALUES clause is used
sqlstate: 42907
with multiple rows. In this case, the
corresponding columns of the rows specified
in the VALUES clause are not compatible. SQL0417N A statement string to be prepared
contains parameter markers as the
The columns are incompatible for one of the
operands of the same operator.
following reasons:
v Both columns are not characters Explanation: The statement string specified as
the object of a PREPARE or EXECUTE
v Both columns are not numbers
IMMEDIATE contains a predicate or expression
v Both columns are not dates in which parameter markers have been used as
v Both columns are not times operands of the same operator without a CAST
v Both columns are not timestamps specification. For example:
v Both columns are not graphic ? > ?
v Both columns are not the same user-defined
The statement cannot be processed.
distinct type.
User Response: This syntax is not supported.
If the data type of a column is character, date,
Use a CAST specification to give at least one of
time, or timestamp the corresponding column
the parameter markers a data type.
may be a character string constant.
sqlcode: -417
The statement cannot be processed.
sqlstate: 42609
User Response: Correct the column names used
in the SELECT statements or the expressions in
SQL0418N A statement contains a use of a
the VALUES clause so that all corresponding
parameter marker that is not
columns are compatible types.
valid.
sqlcode: -415
Explanation: Untyped parameter markers
sqlstate: 42825 cannot be used:
v in a SELECT list
SQL0416N You cannot specify a result v as the sole argument of a datetime arithmetic
column longer than 254 bytes in operation
the SELECT or VALUES v in some cases as the sole argument of a scalar
statements connected by a set function
operator other than UNION ALL.
Parameter markers can never be used:
Explanation: One of the SELECT or VALUES
v in a statement that is not a prepared statement
statements connected by a set operator specifies
a result column that is longer than 254 bytes. v in the fullselect of a CREATE VIEW statement
VARCHAR or VARGRAPHIC result columns v in the triggered action of a CREATE TRIGGER
longer than 254 bytes can be used only with the statement
UNION ALL set operator. v in a query captured by DB2 Query Patroller
The statement cannot be processed. The statement cannot be processed.
User Response: Either use the UNION ALL User Response: Correct the syntax of the
operator instead of UNION, or remove the result statement. If untyped parameter markers are not
columns longer than 254 bytes from the SELECT allowed, use the CAST specification to give the
or VALUES statements. parameter marker a data type.

Chapter 2. SQL Messages 69

sqlcode: -418 “<function-name>” as the target data type. The
function or data type used in the SQL statement
sqlstate: 42610
may be a synonym for “<function-name>”.
If a decimal character is specified in the
SQL0419N A decimal divide operation is not
DECIMAL function then that is the character that
valid because the result would
must be used in place of the default decimal
have a negative scale.
character.
Explanation: A specified decimal division is not
User Response: Ensure that the character
valid because it will result in a negative scale.
strings that are being converted to numeric types
The formula used internally to calculate the scale contain only characters that are valid in numeric
of the result for decimal division is: SQL constants, using the decimal character, if
Scale of result = 31 - np + ns - ds specified.
sqlcode: -420
where np is the precision of the numerator, ns is
the scale of the numerator, and ds is the scale of sqlstate: 22018
the denominator.
SQL0421N The operands of a set operator or
Federated system users: Decimal division can a VALUES clause do not have the
occur at the federated server, at data sources, or same number of columns.
both. The specified decimal division results in an
invalid scale for that data source. Explanation: The operands of a set operator
such as UNION, EXCEPT, or INTERSECT must
have the same number of columns. The rows in a
The statement cannot be processed.
VALUES clause must have the same number of
User Response: Examine and ensure the columns.
precision and scale of all columns that may
The statement cannot be processed.
participate in a decimal division. Note that an
integer or small integer value may be converted User Response: Change the SQL statement so
to a decimal for this calculation. each operand, or each row of a VALUES clause,
has exactly the same number of columns.
Federated system users: if the reason is
unknown, isolate the problem to the data source sqlcode: -421
failing the request (see the problem
determination guide for procedures to follow to sqlstate: 42826
identify the failing data source) and examine the
data range restrictions for that data source. SQL0423N LOB locator variable
sqlcode: -419 “<variable-position>” does not
currently represent any value.
sqlstate: 42911
Explanation: A locator variable is in error.
Either it has not had a LOB value assigned to it,
SQL0420N Invalid character found in a or the locator associated with the variable has
character string argument of the been freed.
function “<function-name>”.
If ″<variable-position>″ is provided, it gives the
Explanation: The function “<function-name>” ordinal position of the variable in error in the set
has a character string argument that contains a of variables specified. Depending on when the
character that is not valid in a numeric SQL error is detected, the database manager may not
constant. The function may have been called as a be able to determine ″<variable-position>″.
result of using the CAST specification with
Instead of an ordinal position,

70 Message Reference, Volume 2

″<variable-position>″ may have the value
SQL0427N Dynamic rollback invalid for
″function-name RETURNS″, which means that
application execution
the locator value returned from the user-defined
environment.
function identified by function-name is in error.
Explanation: An application executing in a
User Response: Correct the program so that the
CONNECT TYPE 2 environment or Distributed
LOB locator variables used in the SQL statement
Transaction Processing (DTP) environment such
have valid LOB values before the statement is
as CICS has attempted to execute an SQL
executed. A LOB value can be assigned to a
dynamic ROLLBACK statement. The SQL
locator variable by means of a SELECT INTO
dynamic ROLLBACK statement cannot be
statement, a VALUES INTO statement, or a
executed in this environment.
FETCH statement.
Federated system users: SQL dynamic
sqlcode: -423
ROLLBACK statements cannot be executed
sqlstate: 0F001 during a pass-through session.
User Response:
SQL0426N Dynamic commit invalid for v Use the rollback statement provided by the
application execution DTP environment to perform the rollback. For
environment. example, in a CICS environment this would be
Explanation: An application executing in a the CICS SYNCPOINT ROLLBACK command.
CONNECT TYPE 2 environment or Distributed v If this statement was executed within a stored
Transaction Processing (DTP) environment such procedure, remove the statement entirely.
as CICS has attempted to execute an SQL
Federated system users: Either comment out the
dynamic COMMIT statement. The SQL dynamic
ROLLBACK statement or code it as a static
COMMIT statement cannot be executed in this
statement. Then resubmit your program.
environment.
Federated system users: SQL dynamic COMMIT sqlcode: -427
statements cannot be executed during a
pass-through session. sqlstate: 2D529
User Response:
v Use the commit statement provided by the SQL0428N The SQL statement is only
DTP environment to perform the commit. For allowed as the first statement in a
example, in a CICS environment this would be unit of work.
the CICS SYNCPOINT command. Explanation: The SQL statement that was
v If this statement was executed within a stored issued is required to execute before any other
procedure, remove the statement entirely. SQL statement that initiates a unit of work.
Following are possible situations:
Federated system users: Either comment out the
COMMIT statement or code it as a static v The SQL statement must be first in the unit of
statement. Then resubmit your program. work and SQL has been issued against the
connection within the unit of work.
sqlcode: -426 v The SQL statement must be first in the unit of
work and a WITH HOLD cursor is currently
sqlstate: 2D528 open for the connection.
Note that when the statement is DISCONNECT
ALL, it causes the DISCONNECT to be directed

Chapter 2. SQL Messages 71

against all connections, so the request will fail if
SQL0431N User defined function
any of the connections violate the above
“<function-name>” (specific name
restrictions.
“<specific-name>”) has been
User Response: Issue a COMMIT or interrupted by the user.
ROLLBACK prior to processing the SQL
Explanation: A user/client interrupt has
statement. If there are any WITH HOLD cursors,
occurred while the named UDF was in control.
these will need to be closed. If the statement is
SET INTEGRITY, remove the COMMIT User Response: This could indicate some
THRESHOLD clause. problem in the UDF, such as an infinite loop or
wait. If the problem persists, (i.e. the need to
sqlcode: -428
interrupt results in the same error condition),
sqlstate: 25001 then contact the author of the UDF or your
database administrator. Until the problem is
fixed, the UDF should not be used.
SQL0429N The maximum number of
concurrent LOB locators has been sqlcode: -431
exceeded.
sqlstate: 38504
Explanation: A maximum of 32,000 concurrent
LOB locators per unit of work, is supported by
SQL0432N A parameter marker cannot have
DB2.
the user defined type name or
User Response: Modify the program so that it reference target type name
requires fewer concurrent LOB locators and try “<udt-name>”.
again.
Explanation: A parameter marker in the
sqlcode: -429 statement has been determined as having the
user-defined type “<udt-name>” or a reference
sqlstate: 54028 type with the target type “<udt-name>” based
on the context in which it is used. A parameter
SQL0430N User defined function marker cannot have a user-defined type or
“<function-name>” (specific name reference type as its data type unless it is part of
“<specific-name>”) has an assignment (VALUES clause of INSERT or
abnormally terminated. SET clause of UPDATE) or it is being explicitly
cast to a user-defined distinct data type or
Explanation: An abnormal termination has reference data type using the CAST specification.
occurred while the named UDF was in control.
The statement cannot be processed.
User Response: The UDF needs to be fixed.
Contact the author of the UDF or your database User Response: Use an explicit cast to the
administrator. Until it is fixed, the UDF should user-defined distinct data type or reference data
not be used. type for the parameter marker. An alternative is
to cast the columns that are user-defined distinct
sqlcode: -430 data types to their corresponding source data
sqlstate: 38503 type or columns that are reference data types to
their corresponding representation type.
sqlcode: -432
sqlstate: 42841

72 Message Reference, Volume 2

 sqlstate: 01608
SQL0433N Value “<value>” is too long.
Explanation: The value “<value>” required
SQL0435N An invalid SQLSTATE
truncation by a system (built-in) cast or
“<sqlstate>” is specified in the
adjustment function, which was called to
function RAISE_ERROR.
transform the value in some way. The truncation
is not allowed where this value is used. Explanation: The SQLSTATE specified in the
RAISE_ERROR function does not conform to the
The value being transformed is one of the
rules for an application defined SQLSTATE.
following:
v an argument to a user defined function (UDF) User Response: Correct the SQLSTATE specified
in the function RAISE_ERROR. The SQLSTATE
v an input to the SET clause of an UPDATE
must be a character string containing exactly 5
statement
characters. It must be of type CHAR defined
v a value being INSERTed into a table with a length of 5, or type VARCHAR defined
v an input to a cast or adjustment function in with a length of 5 or greater. The SQLSTATE
some other context. value must follow the rules for
v a recursively referenced column whose data application-defined SQLSTATEs as follows:
type and length is determined by the v Each character must be from the set of digits
initialization part of recursion and may grow (’0’ through ’9’) or non-accented upper case
in the iterative part of the recursion. letters (’A’ through ’Z’)
The statement has failed. v The SQLSTATE class (first two characters)
cannot be ’00’, ’01’, or ’02’ since these are not
User Response: If “<value>” is a literal string error classes.
in the SQL statement, it is too long for its
v If the SQLSTATE class (first two characters)
intended use.
starts with the character ’0’ through ’6’ or ’A’
If “<value>” is not a literal string, examine the through ’H’, then the subclass (last three
SQL statement to determine where the characters) must start with a character in the
transformation is taking place. Either the input to range ’I’ through ’Z’
the transformation is too long, or the target is too v If the SQLSTATE class (first two characters)
short. starts with the character ’7’, ’8’, ’9’ or ’I’
Correct the problem and rerun the statement. though ’Z’, then the subclass (last three
characters) can be any of ’0’ through ’9’ or ’A’
sqlcode: -433 through ’Z’.
sqlstate: 22001 sqlcode: -435

SQL0434W An unsupported value for clause sqlstate: 428B3

“<clause>” has been replaced by
the value “<value>”. SQL0436N The terminating NULL character
Explanation: The value that was specified for is missing from the C language
clause “<clause>” is not supported and has been NULL-terminated character string
replaced with the identified supported value host variable.
“<value>”. Explanation: The value of an input host
User Response: No change is required if the variable code in the C programming language
selected value is acceptable. Otherwise, specify a requires a NULL-terminator character at the end
value that is valid for “<clause>”. of the string.

sqlcode: +434 The statement cannot be processed.

Chapter 2. SQL Messages 73

User Response: Ensure that the value of the clause so that table and index statistics are
input host variable is terminated by the consistent (Reason code 6)
NULL-terminator character.
sqlcode: +437
sqlcode: -436
sqlstate: 01602
sqlstate: 22024

SQL0438N Application raised error with

SQL0437W Performance of this complex
diagnostic text: “<text>”.
query may be sub-optimal.
Reason code: “<reason-code>”. Explanation: This error occurred as a result of
execution of the RAISE_ERROR function or the
Explanation: The statement may achieve
SIGNAL SQLSTATE statement in a trigger.
sub-optimal performance since the complexity of
the query requires resources that are not User Response: See application documentation.
available or optimization boundary conditions
were encountered. The following is a list of sqlcode: -438
reason codes: sqlstate: application-defined
1 The join enumeration method was
altered due to memory constraints SQL0439N User defined function
2 The join enumeration method was “<function-name>” is indirectly
altered due to query complexity implemented by function
“<source-function>” which
3 Optimizer cost underflow resulted in error “<sqlcode>”.
4 Optimizer cost overflow Explanation: The function “<function-name>”
was referenced in the user’s statement. However,
5 Query optimization class was too low
because the SOURCE clause was used in the
6 Optimizer ignored an invalid statistic definition of this function, it has turned out that
function “<source-function>” actually
The statement will be processed. implements the function. (It may be a direct or
an indirect definition path from
User Response: One or more of the following: “<function-name>” to “<source-function>”.) At
v Increase the size of the statement heap compile time, the encapsulator (DB2 code which
(stmtheap) in the database configuration file. acts on behalf of a function) for
(Reason code 1) “<source-function>” has returned the error
v Break the statement up into less complex SQL identified by “<sqlcode>”.
statements. (Reason codes 1,2,3,4) User Response: The actual error situation needs
v Ensure predicates do not over-specify the to be understood better before corrective action
answer set (Reason code 3) can be taken. Look up the explanation for
v Change the current query optimization class to “<sqlcode>”. If “<source-function>” is a built-in
a lower value (Reason codes 1,2,4) function, the “<sqlcode>” should indicate the
problem, as in the case where a built-in function
v Issue Runstats for the tables involved in the
is directly referenced in the user’s statement. If
query (Reason codes 3,4)
“<source-function>” is a user defined function,
v Change the current query optimization class to the message most likely indicates a problem with
a higher value (Reason code 5) one of the arguments or with the result from the
v Reissue RUNSTATS for both the tables function.
involved in the query and their corresponding
Correct the problem and try again.
indexes, i.e. use the AND INDEXES ALL

74 Message Reference, Volume 2

sqlcode: -439
SQL0441N Invalid use of keyword
sqlstate: 428A0 DISTINCT or ALL with function
“<function-name>”.

SQL0440N No function by the name Explanation: There are several possible causes.
“<function-name>” having v The keyword DISTINCT or ALL was detected
compatible arguments was found within the parentheses in a reference to
in the function path. function “<function-name>”, and the function
Explanation: This occurs in a reference to has been resolved as a scalar function. Use of
function “<function-name>”, where the keyword DISTINCT or ALL with a scalar
“<function-name>” can refer to a method, when function is invalid.
the database manager cannot find a function or v The keyword DISTINCT is used in a column
method it can use to implement the reference. function for which it is not supported. These
There are several reasons why this could occur: functions include COVARIANCE,
v “<function-name>” was either incorrectly CORRELATION and the linear regression
specified or does not exist in the database. functions (those that start with REGR).

v A qualified reference was made, and the v The function was expected to be a column
qualifier was incorrectly specified. function supporting the keyword ALL or
DISTINCT but the function it resolved to was
v The user’s function path does not contain the not a column function.
schema to which the desired function or
method belongs, and an unqualified reference User Response:
was used. v If a scalar function is being used, then remove
v The wrong number of arguments were the keyword DISTINCT or ALL. It is invalid
included. for a scalar function.
v The right number of arguments were included, v If the function is a column function that does
but the data types of one or more of the not support the DISTINCT or ALL keywords,
arguments is incorrect. then remove the keywords.
v The function does not exist in the database v If a column function is being used, then there
with a create timestamp earlier than the time is a problem with function resolution. Check
the package was bound (applies to static your function path to see if the desired
statements). function is in one of the schemas, and also
v The mutator method corresponding to an check the SYSFUNCTIONS catalog for the
attribute assignment used in an UPDATE spelling of the function name and the number
statement could not be found. The data type of and types of parameters.
the new value for the attribute is not a data Correct the error and try again.
type that is the same or promotable to the data
type of the attribute. sqlcode: -441
User Response: Fix the problem and retry. This
could involve catalog access, change to the sqlstate: 42601
statement, the addition of new functions, and/or
change to the function path. SQL0442N Error in referring to routine
sqlcode: -440 “<routine-name>”. The maximum
number of allowable arguments
sqlstate: 42884 (90) has been exceeded.
Explanation: Too many arguments were
specified in the reference to routine

Chapter 2. SQL Messages 75

“<routine-name>”. The maximum allowable is 10 Length or position in string function out
90. of range
User Response: Correct the statement by 11 Invalid character representation of a
ensuring that the correct number of arguments floating point number
has been used and try again.
sqlcode: -443
sqlcode: -442
sqlstate: 54023 sqlstate: 38xxx (the SQLSTATE returned by the
routine).
SQL0443N Routine “<routine-name>”
(specific name “<specific-name>”) SQL0444N Routine “<routine-name>”
has returned an error SQLSTATE (specific name “<specific-name>”)
with diagnostic text “<text>”. is implemented with code in
library or path
Explanation: An SQLSTATE of the form 38xxx
“<library-or-path>”, function
was returned to DB2 by routine
“<function-code-id>” which
“<routine-name>” (specific name
cannot be accessed. Reason code:
“<specific-name>”), along with message text
“<code>”.
“<text>”. The routine could be a user-defined
function or a user-defined method. Explanation: The DBMS is trying to access the
body of the code that implements routine
User Response: The user will need to
“<routine-name>” (specific name
understand the meaning of the error. See your
“<specific-name>”), and cannot access it for the
Database Administrator, or the author of the
reason given by reason code “<code>” (the codes
routine.
are listed below). The file implementing the
Errors that are detected by the IBM supplied routine is identified by “<library-or-path>”, and
functions in the SYSFUN schema all return the the function by “<function-code-id>”.
SQLSTATE 38552. The message text portion of
(Note that these last two tokens may be
the message is of the form:
truncated, due to limitations in the total token
SYSFUN:nn length which can be provided. If this happens,
then the definition of the routine in the catalogs
where nn is a reason code meaning: may need to be accessed in order to determine
01 Numeric value out of range the full library or path and function code id that
were defined for the routine.)
02 Division by zero
User Response: Given for each reason code:
03 Arithmetic overflow or underflow
1 Path name ″<library-or-path>″ is longer
04 Invalid date format than the maximum (255 bytes). Either
the routine definition needs to be
05 Invalid time format
changed to specify a shorter path, or the
06 Invalid timestamp format DB2 instance path name is too long.
Look at the catalog definition to
07 Invalid character representation of a
determine which is the case. It may be
timestamp duration
necessary to move the function body to
08 Invalid interval type (must be one of 1, a directory with a shorter path name.
2, 4, 8, 16, 32, 64, 128, 256)
2 The DB2 instance path name could not
09 String too long be retrieved from DB2. See your system
administrator.

76 Message Reference, Volume 2

3 The path ″<library-or-path>″ could not 6 The function ″<function-code-id>″ could
be found. See the routine creator or not be found in the module named. See
your database administrator. The routine the routine creator or your database
definition or the location of the routine administrator. The routine definition or
itself will need to be corrected. the function itself will need to be
corrected.
4 The file in ″<library-or-path>″ could not
be found. See the routine creator or 7 The symbol given as the function name
your database administrator. The routine (″<function-code-id>″) is not the name
definition or the location of the routine of a valid function in the named library.
may need to be corrected, or the routine See the routine creator or your database
may need to be re-linked. administrator. The routine definition or
the function itself will need to be
In OS/2 this reason code can arise if the
corrected.
UDF DLL name is longer than format
(8.3). For example a name of 8 The ″load″ system function has failed,
″abcdefgh99.dll″ has format (10.3) and for other than the reasons given above.
would result in this message with It may be that the module was not
reason code 4. The solution is to change linked at all, or not linked correctly.
the name to an acceptable form, for
9 There was insufficient memory to
example ″abcdef99.dll″.
resolve the function name
In addition to the above, this reason ″<function-code-id>″ in the library
code can result if the routine requires a identified in ″<library-or-path>″.
shared library or DLL, and the shared Contact the routine creator or your
library cannot be located (using the database administrator to make sure the
concatenation of directories specified in library containing the function was
the LIBPATH environment variable in correctly linked. The system
UNIX-based systems, the PATH configuration may need to be changed
environment variable in INTEL to make more memory available to DB2
systems). There can be multiple levels of Server.
this indirection involved, leading to this
10 The loadquery system call has failed.
reason code. For example, routine body
This can only happen on unix-based
X can be found, and it needs shared
systems, and is a symptom that the
library Y which can also be found. But Y
database manager itself has not been
needs Z, and Z cannot be located, and
installed correctly. Contact your system
this will result in SQL0444N reason code
administrator.
4.
11 The agent process is searching for a
5 There was insufficient memory to load
particular database manager function
the library containing the function or
that should be in the libdb2.a library,
one or more symbols could not be
and it cannot find it. This can only
resolved. Contact the routine creator or
happen on unix-based systems, and is a
your database administrator to make
symptom that the database manager is
sure that the library was correctly
not correctly installed. Contact your
linked. All required libraries to resolve
system administrator.
referenced symbols such as external
functions must be available. If a lack of 15 Access has been denied. This can
memory is determined then the system happen in Windows NT environments if
configuration may need to be changed the EXTERNAL NAME specification in
to make more memory available to DB2. the routine definition statement does not
specify a full path, or the function does

Chapter 2. SQL Messages 77

 not exist in the instance_name\function sqlstate: 01004
directory, necessitating a search using
the PATH environment variable. For
SQL0447W The statement contains redundant
example, If the PATH contains a LAN
specifications involving the clause
drive prior to the directory containing
“<clause>”.
your function and the DB2 instance is
running under the SYSTEM account, Explanation: The “<clause>” keyword was
this reason code can result. included more than once in the statement. This is
a warning condition.
other: An unidentified system failure has
occurred. Note the code, and see your User Response: If the redundancy was
system administrator. intentional, or if it is determined that no harm
has resulted, then no response is necessary. The
If unable to diagnose the error using the type of ″harm″ alluded to could include, for
information in this message, the diagnostic log example, the omission of some other desired
file db2diag.log contains failure information keyword.
which may help isolate the problem. It may be
sqlcode: +447
necessary to contact your system administrator
for assistance. sqlstate: 01589

Federated system users: if this user defined

SQL0448N Error in defining routine
function is a function template (and thus no code
“<routine-name>”. The maximum
is required to reside on the federated server), you
number of allowable parameters
may want to consider modifying the SQL
(90 for user defined functions and
statement or statistics to enable this function to
methods, 32767 for stored
be evaluated on the remote data source.
procedures) has been exceeded.
sqlcode: -444 Explanation: Too many parameters were
specified when defining routine
sqlstate: 42724 “<routine-name>”. The routine definition
statement may be a CREATE FUNCTION,
CREATE PROCEDURE, CREATE TYPE (method
SQL0445W Value “<value>” has been definition), or ALTER TYPE (method definition).
truncated.
User Response: Change the statement to
Explanation: The value “<value>” was include fewer parameters.
truncated by a system (built-in) cast or
adjustment function, which was called to sqlcode: -448
transform the value in some way. This is a
sqlstate: 54023
warning situation.
The value being transformed is the output of a
SQL0449N The statement defining routine
routine (user-defined function (UDF) or method),
“<routine-name>” contains an
and is being transformed because of a CAST
invalidly formatted
FROM specification in the routine definition, or
library/function identification in
because the UDF is sourced on another function
the EXTERNAL NAME clause.
and the result needed to be transformed.
Explanation: An error was found in the
User Response: Ensure that the output is as
EXTERNAL NAME clause of the CREATE
expected and that the truncation has not caused
statement for user defined function (UDF),
any unexpected consequences.
user-defined method, or stored procedure
sqlcode: +445 “<routine-name>”. The rules for the

78 Message Reference, Volume 2

library/function identification are as follows: – A LOB locator is returned by the routine,
and the length of the LOB value associated
The name takes the form ’<a>!<b>’ or ’<a>’. No
with this locator exceeds the defined size of
blanks are permitted within the single quotes.
the result.
<a> is one of the following:
v the full-path identification of a file (for The definition of the result argument in the
example, (on AIX) /u/slick/udfs/math or (on Routine must conform to the requirement for
OS/2) d:\myfunc\math) the data type. Refer to the Application
v a file name (for example, math) assumed to be Development Guide for more information.
in ’function’ directory in the sqllib directory. v the SQLSTATE value (6 bytes including the
If <b> is omitted, the default is the entry point null terminator)
defined when the named file was linked. If <b> v the message text (71 bytes including the null
is present, it identifies the entry point (function) terminator).
within <a> that will be invoked as the body of v the scratchpad content (length declared on
the routine. CREATE FUNCTION).
User Response: Correct the problem and try This is not permitted.
again. A possible cause is the inclusion of a
blank, or having the ’!’ at the beginning or end This error will also be returned if the length field
of the name. of the scratchpad is altered by the routine.
sqlcode: -449 User Response: See your Database
sqlstate: 42878 Administrator, or the author of the routine.
sqlcode: -450
SQL0450N Routine “<routine-name>” sqlstate: 39501
(specific name “<specific-name>”)
has generated a result value,
SQLSTATE value, message text, or SQL0451N The “<data-item>” definition, in
scratchpad which is too long. the statement that defines routine
“<routine-name>”, contains a data
Explanation: Upon return from routine type “<type>” that is not
“<routine-name>” (specific name appropriate for a non-sourced
“<specific-name>”), DB2 has detected that more routine written in the given
bytes were returned than were allocated for one language.
of the following:
v the result value (based upon the routine Explanation: An error was made in the
definition). There are several possible causes: “<data-item>” part of the statement defining
routine “<routine-name>”. The user’s statement
– Too many bytes were moved to the result contained the invalid type “<type>”, or it
buffer. contained a user defined type (UDT) which is
– The data type is one where the data value based on the invalid type “<type>”. The routine
must be delimited by a null, such as definition may be a CREATE FUNCTION,
VARCHAR(n), and the delimiting null was CREATE PROCEDURE, CREATE TYPE (method
not within the range of the defined size. definition), or ALTER TYPE (method definition).
– DB2 is expecting a two- or four- byte length “<data-item>” is a token that identifies the area
value preceding the value, and this length of the problem in the statement. For example,
exceeds the defined size of the result. ″PARAMETER 2″ or ″RETURNS″ or ″CAST
FROM″.
User Response: Determine which situation has

Chapter 2. SQL Messages 79

occurred, and take corrective action. Possible v 05 - Access to the file was denied. The user
corrective actions include: does not have permission to open the file.
v Changing the routine definition to a supported v 06 - Access to the file was denied. The file is in
type; for example, from DECIMAL to FLOAT. use with incompatible modes. Files to be
This may involve a change in the routine body written to are opened in exclusive mode.
itself, and may also involve use of cast v 07 - Disk full was encountered while writing
functions upon use of the routine. to the file.
v Creating a new (suitably based) user defined v 08 - Unexpected end of file encountered while
type, or changing the definition of an existing reading from the file.
UDT.
v 09 - A media error was encountered while
sqlcode: -451 accessing the file.
v 10 - An incomplete or invalid multibyte
sqlstate: 42815 character was encountered while reading from
the file.
SQL0452N Unable to access the file v 11 - An error was encountered while
referenced by host variable converting data from the file code page to the
“<variable-position>”. Reason application’s graphic character code page.
code: “<reason-code>”.
User Response:
Explanation: An error was encountered
For reason code 01, correct the file name length,
attempting to access or while accessing the file
file name and/or path.
referenced by the ″nth″ host variable, where n =
″<variable-position>″, for the reason given by For reason code 02, specify a valid file option.
″<reason-code>″. <variable-position> is set to 0 if
For reason code 03, ensure that the file specified
the host variable position could not be
exists before attempting to access the file.
determined. The possible reason codes are as
follows: For reason code 04, either delete the file if it is
v 01 - The file name length is invalid or the file no longer required or specify a file name that
name and/or the path has an invalid format. does not currently exist.
v 02 - The file option is invalid. It must have one For reason code 05, ensure that the user has
of the following values: access (correct file permissions) to the file.
SQL_FILE_READ For reason code 06, either use a different file or,
-read from an existing file
if the file must be accessed, modify the
SQL_FILE_CREATE
-create a new file for write application to ensure that the file is not accessed
SQL_FILE_OVERWRITE concurrently.
-overwrite an existing file. For reason code 07, delete unnecessary files to
If the file does not exist,
free up disk space or specify a file that resides on
create the file.
SQL_FILE_APPEND another drive/file system with sufficient disk
-append to an existing file. space. Also, ensure that no operating system or
If the file does not exist, user file size limits were reached. If your
create the file. application code page uses a multibyte encoding
v 03 - The file cannot be found. scheme it is possible that only part of the last
character was written, ensure that the file
v 04 - The SQL_FILE_CREATE option was contains only fully formed characters.
specified for a file with the same name as an
existing file. For reason code 08, if a file is to be used for
input, ensure that the file is not modified before
the entire file has been read.

80 Message Reference, Volume 2

For reason code 09, correct all errors on the number of parameters defined for the method,
media where the file resides. and an ordered list of the types of the
parameters (without regard to any parameters of
For reason code 10, ensure that the file contains
the types).
valid multibyte characters based on the code
page of the application or submit the request The signature of a procedure consists of the
while running under the same code page as the procedure name and the number of parameters
contents of the file. defined for the procedure (data types are not
considered).
For reason code 11, ensure that character
conversion support between the code page of the In this case, either:
file, for example Japanese EUC, and the graphic v there is a function or procedure
code page of the application, for example UCS-2, (“<routine-name>”) already in the schema
is installed. having the same signature as the function or
sqlcode: -452 procedure being created
v there is a method (“<routine-name>”) for the
sqlstate: 428A1
subject type having the same signature as the
method specification being added or the
SQL0453N A problem has been identified method body being created
with the RETURNS clause in the
The statement cannot be processed.
statement that defines the routine
“<routine-name>”. User Response: Determine if the existing
routine already provides the functionality
Explanation: A problem casting the result of
desired. If not, then the signature of the routine
routine “<routine-name>” has been identified.
will have to be changed; for example, by
The CAST FROM data type is not castable to the
changing the routine name.
RETURNS data type, and it should be. See the
SQL Reference for details on casting between data sqlcode: -454
types.
sqlstate: 42723
User Response: Change the RETURNS or CAST
FROM clause so that the CAST FROM data type
SQL0455N In routine “<routine-name>”, the
is castable to the RETURNS data type.
schema name “<schema-name1>”
sqlcode: -453 provided for the SPECIFIC name
does not match the schema name
sqlstate: 42880
“<schema-name2>” of the routine.
Explanation: If the SPECIFIC name is specified
SQL0454N The signature provided in the
as a two part name, the “<schema-name1>”
definition for routine
portion must be the same as the
“<routine-name>” matches the
“<schema-name2>” portion of the
signature of some other routine
“<routine-name>”. Note that the
that already exists in the schema
“<schema-name2>” portion of “<routine-name>”
or for the type.
may have been specified directly or it may have
Explanation: The signature of a function defaulted to the authorization ID of the
consists of the function name, the number of statement. If the routine is a method,
parameters defined for the function, and an “<schema-name>” refers to the schema name of
ordered list of the types of the parameters the subject type of the method.
(without regard to any parameters of the types).
User Response: Correct the statement and try
The signature of a method consists of the method again.
name, the subject type of the method, the

Chapter 2. SQL Messages 81

sqlcode: -455
SQL0458N In a reference to routine
sqlstate: 42882 “<routine-name>” by signature, a
matching routine could not be
found.
SQL0456N In the definition of routine
“<routine-name>”, the SPECIFIC Explanation: In a reference to function, method,
name “<specific-name>” already or stored procedure “<routine-name>” by
exists in the schema. signature, no matching function, method, or
stored procedure could be found.
Explanation: The user has supplied an explicit
SPECIFIC name “<specific-name>” in the If a data type is used that can accept a
definition of routine “<routine-name>”, but this parameter, then the type parameter is optional.
name already exists as the SPECIFIC name for a For example, for CHAR(12), you can either
function, method, or procedure in the schema. specify the parameter (CHAR(12) or omit it
(CHAR()). If you specify the parameter, then the
User Response: Choose a new SPECIFIC name DBMS will only accept an exact match on the
and try again. data type AND the data type parameter. If you
sqlcode: -456 omit the parameter, then the DBMS will accept a
match on data type only. The CHAR() syntax
sqlstate: 42710 provides a way to tell the DBMS to ignore data
type parameters when finding a matching
SQL0457N A function, method, user-defined function.
data type, or structured data type Note also that in the DROP
attribute cannot be called FUNCTION/PROCEDURE and COMMENT ON
″<name>″ since it is reserved for FUNCTION/PROCEDURE statements, an
system use. unqualified reference is qualified with the
Explanation: The user-defined function, statement authorization ID, and this is the
method, user-defined data type, or structured schema where the problem can be found. In the
data type cannot be created because a specified SOURCE clause of a CREATE function, the
name is reserved for use by the system. Names qualification comes from the current function
that cannot be used for function names, distinct path. In this case, there is no matching function
type names, structured type names, or attribute in the entire path.
names include: A function cannot be sourced on the COALESCE,
"=","<",">",">=","<=","&=","&>",,"&<", NULLIF, NODENUMBER, PARTITION,
"!=","!>","!<","<>", SOME, ANY, ALL, NOT, RAISE_ERROR, TYPE_ID, TYPE_NAME,
AND, OR, BETWEEN, NULL, LIKE, EXISTS, IN, TYPE_SCHEMA, or VALUE built-in functions.
UNIQUE, OVERLAPS, SIMILAR, and MATCH.
The statement cannot be processed.
User Response: Select a name for the function,
method, user-defined data type, or structured User Response: Possible responses include:
data type attribute that is not reserved for system v Changing the function path to include the
use. correct schema.
sqlcode: -457 v Removing parameters from the specifications
of data types.
sqlstate: 42939
v Using a SPECIFIC name to refer to the
function or procedure instead of a signature.
sqlcode: -458

sqlstate: 42883

82 Message Reference, Volume 2

 and 01Hxx (warning). This routine
SQL0461N A value with data type
“<routine-name>” (specific name
“<source-data-type>” cannot be
“<specific-name>”) returned an invalid
CAST to type
SQLSTATE “<state>”, along with message text
“<target-data-type>”.
“<text>”. The routine is in error.
Explanation: The statement contains a CAST
User Response: The routine will need to be
with the first operand having a data type of
corrected. See your database administrator, or the
“<source-data-type>” to be cast to the data type
author of the routine. The application
“<target-data-type>”. This cast is not supported.
significance of the bad SQLSTATE can also be
User Response: Change the data type of either learned from the routine author.
the source or target so that the cast is supported.
sqlcode: -463
For predefined data types these are documented
in the SQL Reference. For a cast involving a sqlstate: 39001
user-defined distinct type, the cast can be
between the base data type and the user-defined
distinct type or from a data type that is SQL0464W Procedure “<proc>” returned
promotable to the base data type to the “<num>” query result sets, which
user-defined distinct type. exceeds the defined limit
“<integer>”.
sqlcode: -461
Explanation: The stored procedure named by
sqlstate: 42846 proc completed normally. However, the stored
procedure exceeded the defined limit on the
number of query result sets the procedure can
SQL0462W Routine “<routine-name>”
return.
(specific name “<specific-name>”)
has returned a warning num identifies the number of query result
SQLSTATE, with diagnostic text sets returned by the stored procedure.
“<text>”.
integer identifies the defined limit on the
Explanation: An SQLSTATE of the form 01Hxx number of query result sets for the
was returned to DB2 by routine stored procedure.
“<routine-name>” (with specific name
“<specific-name>”), along with message text Only the first integer query result sets are
“<text>”. returned to the SQL program that issued the SQL
User Response: The user will need to CALL statement.
understand the meaning of the warning. See
your database administrator, or the author of the The possible causes are as follows: The stored
routine. procedure is unable to return num result sets due
to the DRDA limitations imposed by the client.
sqlcode: +462 The DRDA client establishes this limit with the
sqlstate: 01Hxx MAXRSLCNT DDM code point.
User Response: The SQL statement is
SQL0463N Routine “<routine-name>” successful. The SQLWARN9 field is set to ’Z’.
(specific name “<specific-name>”) sqlcode: +464
has returned an invalid
SQLSTATE “<state>”, with sqlstate: 0100E
diagnostic text “<text>”.
Explanation: The valid SQLSTATEs that a
routine can return are 38xxx (error), 38502 (error)

Chapter 2. SQL Messages 83

 42: Failure to create the REPLY QUEUE.
SQL0465N Unable to start, initialize, or
communicate with fenced mode 43: Failure to read from the REPLY QUEUE.
process. Reason code “<code>”.
44: Failure to open the REQUEST QUEUE.
Explanation: There is a system related problem
involved with the running of a fenced mode 45: Failure to write to the REQUEST
routine (user-defined function or method). The QUEUE.
exact nature of the problem is indicated by 47: Failure to grant the routine process the
“<code>”. This is NOT a user problem. Possible access permission to the UDFP shared
reason codes are: memory set.
Routine process errors 48: Failure to grant the routine process the
21: Failure to initialize internal data or access permission to the REPLY QUEUE.
application data. 49: Failure to allocate storage for control
22: Failure to register signal handlers. blocks used in module
loading/unloading.
23: Failure to grant agent process the access
permission for the REQUEST QUEUE. 50: Agent process died while running
routine code or agent code.
24: Failure to connect to the routine process
Shared Memory. 51: Agent process catches USER
INTERRUPT while running un-fenced
25: Failure to open the REPLY QUEUE. routine code.
26: Failure to write to the REPLY QUEUE. 60: Internal error occurred in routine
process.
27: Failure to create the REQUEST QUEUE.
User Response: Contact your Database or
28: Failure to read from the REQUEST
System administrator.
QUEUE.
sqlcode: -465
29: Routine process dies.
sqlstate: 58032
30: Routine process catches an USER
INTERRUPT signal.
SQL0466W The procedure
31: Failure to unload routine module.
“<procedure-name>” returns
32: Failure to allocate storage for control “<number-results>” result sets
blocks used in module from the stored procedure.
loading/unloading.
Explanation: This message is returned as a
33: Failure to send SIGINT from agent result of issuing a CALL SQL statement. It
process to routine process. indicates that the stored procedure
“<procedure-name>” has “<number-results>”
34: Failure to initialize OLE library.
result sets associated with it.
35: Failure to initialize OLE DB
The statement completed successfully.
Initialization Service Component.
User Response: None required.
40: Internal error occurred in routine
process. sqlcode: +466
sqlstate: 0100C
Agent process errors
41: Failure to spawn routine process.

84 Message Reference, Volume 2

SQL0467W The procedure SQL0470N The user defined routine
“<procedure-name>” includes “<routine-name>” (specific name
another result set. There are a “<specific-name>”) has a null
total of “<number-results>” result value for argument “<argument>”
sets. that could not be passed.
Explanation: This message is returned as a Explanation: A routine has an input argument
result of closing a cursor. It indicates that another with a null value but was defined with a
result set exists for stored procedure parameter style that does not pass null
“<procedure-name>” and the cursor was indicators, or the datatype of this parameter does
re-opened on the next result set. There are a total not support null values.
of “<number-results>” result sets from the stored
User Response: If the routine is to be called
procedure.
with null values, ensure the parameter style and
The statement completed successfully. input types are capable of accepting a null value.
For functions, the function could also be created
User Response: None required. Fetches can
with ″RETURNS NULL ON NULL INPUT″.
proceed on to the next result set.
sqlcode: -470
sqlcode: +467
sqlstate: 39004
sqlstate: 0100D

SQL0471N Invocation of routine “<name>”

SQL0469N The parameter mode (IN, OUT, or
failed due to reason
INOUT) is not valid for a
“<reason-code>”.
parameter in procedure
“<procedure-name>” with specific Explanation: A routine “<name>” was invoked
name “<specific-name>” on a DB2 Universal Database for OS/390 server.
(parameter number “<number>”, The routine invocation failed because of the
name “<parameter-name>”). condition described by DB2 reason code
“<reason-code>”.
Explanation: One of the following errors
occurred: The statement cannot be executed. A DSNX9xx
v a parameter in an SQL procedure is declared message describing the error might be displayed
as OUT and is used as input in the procedure on the MVS system console.
body User Response: Consult the documentation for
v a parameter in an SQL procedure is declared the DB2 Universal Database for OS/390 server
as IN and is modified in the procedure body. and correct the condition described by the DB2
reason code.
User Response: Change the attribute of the
parameter to INOUT, or change the use of the sqlcode: -471
parameter within the procedure.
sqlstate: 55023
sqlcode: -469
sqlstate: 42886 SQL0473N A user defined data type having
the same name as a system
predefined type cannot be created.
Explanation: The name of a data type to be
created has an unqualified name that is the same
as a system-predefined data type or is
BOOLEAN. This is not allowed. Adding

Chapter 2. SQL Messages 85

delimiters does not make the name valid. schema where the problem can be found. In the
SOURCE clause of a CREATE FUNCTION, the
The statement could not be processed.
qualification comes from the current function
User Response: Correct the statement to use path. In this case, the first schema in the path
another identifier. containing a function with this name had other
functions by the same name.
sqlcode: -473
Federated system users: For a pass-through
sqlstate: 42918 session, if the statement is a CREATE
FUNCTION MAPPING statement, this error
SQL0475N The result type “<type-1>” of the indicates that an attempt was made to create a
SOURCE function cannot be cast function mapping from one remote function to
to the RETURNS type “<type-2>” more than one local function.
of the user defined function User Response: Correct the reference by one of
“<function-name>”. the following:
Explanation: In order for the CREATE of a v completing the signature
sourced user defined function (UDF) to be valid, v using the SPECIFIC name of the desired
the result type (“<type-1>”) of the source routine
function must be castable to the RETURNS type
(“<type-2>”) of the function being created. There v changing the SQL path
is no supported cast between these data types. and try again.
See the SQL Reference for details on casting
between data types. sqlcode: -476
User Response: Change the RETURNS data
type or the SOURCE function identification so sqlstate: 42725
that the result type of the SOURCE function is
castable to the RETURNS data type. SQL0478N The object type “<object-type1>”
sqlcode: -475 cannot be dropped because there
is an object “<object-name>”, of
sqlstate: 42866 type “<object-type2>”, which
depends on it.
SQL0476N Reference to routine Explanation: The base object, which is an object
“<function-name>” was made of type “<object-type1>” cannot be dropped
without a signature, but the because another object depends on it. There is a
routine is not unique in its restrict dependency defined with objects of type
schema. “<object-type2>” (of which object
Explanation: References to a function or stored “<object-name>” is an example).
procedure without a signature is permitted, but It may be that the dependency is indirect. That
the named function or store procedure is, the named object is dependent on another
“<function-name>” must be unique in its schema object which is dependent on the object being
and is not. If the routine is a method, a reference dropped.
without a signature is permitted but this named
method must be unique for the data type. For example:
v function F1 is sourced on function F2
Note that in the DROP
FUNCTION/PROCEDURE and COMMENT ON v table V1 is defined using F1
FUNCTION/PROCEDURE statements, an v an attempt to drop F2 will fail due to the
unqualified reference is qualified with the direct dependency of F1 on F2 and the indirect
statement authorization ID, and this is the dependency of V1 on F2

86 Message Reference, Volume 2

User Response: Either do not drop this object User Response: Modify the GROUP BY clause
or drop the dependent objects first. to remove the nesting.
sqlcode: -478 sqlcode: -481
sqlstate: 42893 sqlstate: 428B0

SQL0480N The procedure SQL0483N In the CREATE for user defined

“<procedure-name>” has not yet function “<function-name>”
been called. statement, the number of
parameters does not match the
Explanation: Either the procedure identified in
number of parameters of the
an ASSOCIATE LOCATORS statement has not
SOURCE function.
yet been called within the application process, or
the procedure has been called, but an explicit or Explanation: An attempt is being made to
implicit commit occurred before the statement. CREATE a user defined function
“<function-name>” which is sourced on another
User Response: Correct the statements so that
function. One of the following situations has
the exact syntax used to specify the procedure
been identified:
name on the CALL statement is the same as that
on the ASSOCIATE LOCATORS statement. If an v The SOURCE clause uses a function-name
unqualified name is used to CALL the procedure, (input parameter list) to identify the source
the one-part name must also be used in the other function, and the number of types in the list is
statements. Reissue the statements. different from the number of parameters of the
function being created.
sqlcode: -0480
v The SOURCE clause uses different syntax to
sqlstate: 51030 identify the source function, and the number
of types of that function is different from the
number of parameters of the function being
SQL0481N The GROUP BY clause contains created.
“<element 1>” nested within
“<element 2>”. User Response: The number of parameters for
the SOURCE function and for the function being
Explanation: The following types of nesting are created must be the same. The identification of
not allowed within a GROUP BY clause: the SOURCE function needs to be changed, to
v CUBE within CUBE, ROLLUP, or GEL v fix the input parameter list
v ROLLUP within CUBE, ROLLUP, or GEL v correct the function name or function specific
v () within CUBE, ROLLUP, or GEL name to identify the proper function.
v GROUPING SET within GROUPING SET, It is also possible that the function path needs to
CUBE, ROLLUP, or GEL be corrected in order for correct function
where GEL represents the element shown as resolution to occur.
grouping-expression-list in the syntax diagram of
the GROUP BY clause. sqlcode: -483

In some instances the value “---” will be shown sqlstate: 42885

for “<element 2>”. In this case “---” represents
one of CUBE, ROLLUP, GROUPING SET, or
GEL.

The statement cannot be processed.

Chapter 2. SQL Messages 87

SQL0486N The BOOLEAN data type is SQL0491N The definition of routine
currently only supported “<routine-name>” must have a
internally. RETURNS clause, and one of: the
EXTERNAL clause (with other
Explanation: One or more of the data types in
required keywords); the RETURN
the statement is BOOLEAN. This is not
statement; or the SOURCE clause.
supported in the current version of DB2.
Explanation: A required clause is missing in the
User Response: Change the data type(s) then
definition of routine “<routine-name>”. If
resubmit the statement.
EXTERNAL was specified, the following must
sqlcode: -486 also be specified: LANGUAGE, PARAMETER
STYLE, DETERMINISTIC or NOT
sqlstate: 42991 DETERMINISTIC, NO SQL, and EXTERNAL
ACTION or NO EXTERNAL ACTION.
SQL0487N Routine “<routine-name>” User Response: Add the missing clause, then
(specific name “<specific-name>”) try again.
attempted to execute an SQL
statement. sqlcode: -491

Explanation: The program used to implement sqlstate: 42601

the body of a routine is not allowed to execute
SQL statements. This routine “<routine-name>”
SQL0492N There is a problem in the
(specific name “<specific-name>”) contains SQL
CREATE for user defined function
statements.
“<function-name>”, with
User Response: Remove any SQL statements parameter number “<number>”. It
then recompile the program. Investigate the level may involve a mismatch with a
of SQL allowed as specified on the statement SOURCE function.
defining the routine.
Explanation: The parameter in position
sqlcode: -487 “<number>” of function “<function-name>” is in
error and the CREATE cannot be performed. The
sqlstate: 38001 parameter in position “<number>” of the source
function is not castable to the corresponding
SQL0489N The function ″<function-name>″ parameter of the function being created.
in a SELECT or VALUES list item User Response: Possible corrections include:
has produced a BOOLEAN result.
v Identify a different source function.
Explanation: The function ″<function-name>″ is v Change the data type of the parameter of the
defined for use as a predicate, returning a function being created so that the data type of
boolean result. Such a result is not valid in a the source function can be cast to this data
select list. type.
The statement cannot be processed. sqlcode: -492
User Response: Correct the function name or
remove the use of the function. sqlstate: 42879
sqlcode: -489
sqlstate: 42844

88 Message Reference, Volume 2

 prepared INSERT, UPDATE, DELETE or
SQL0493N Routine “<routine-name>”
SELECT statement were to be executed.
(specific name “<specific-name>”)
has returned a date, time or cost-category
timestamp value which is DB2’s cost-category for this SQL
syntactically or numerically statement. The possible values are A or
invalid. B.
Explanation: The body of user defined function limit-amount
(UDF) or method “<routine-name>” (specific The error threshold (in service units)
name “<specific-name>”) has returned an invalid specified in the RLFASUERR column of
date, time or timestamp value. the RLST.
An example of a syntactically invalid date value
is ’1994-12*25’: the ’*’ should be a ’-’. An example The prepare of the dynamic INSERT, UPDATE,
of a numerically invalid time value is ’11.71.22’: DELETE, or SELECT statement was unsuccessful.
there is no 71st minute in the hour. User Response: If this SQLCODE was returned
User Response: The routine needs fixing. See because the cost category value is ″B″, it might
your DBA, or the author of the routine. be that the statement is using parameter markers
or that some statistics are not available for the
sqlcode: -493 referenced tables and columns. Make sure the
administrator has run the utility RUNSTATS on
sqlstate: 22007
the referenced tables. It might also be that UDFs
will be invoked when the statement is executed,
SQL0495N Estimated processor cost of or for INSERT, UPDATE, or DELETE statements
″<estimate-amount1>″ processor that triggers are defined on the changed table.
seconds (″<estimate-amount2>″ Check the DSN_STATEMNT_TABLE or the
service units) in cost category IFCID 22 record for this statement to find the
″<cost-category>″ exceeds a reasons this SQL statement has been put in cost
resource limit error threshold of category ″B″. If the program cannot be changed,
″<limit-amount>″ service units. or if statistics cannot be obtained, ask the
administrator to change the value in the
Explanation:
RLF_CATEGORY_B column in the RLST to ″Y″
The prepare of a dynamic INSERT, UPDATE, which allows the statement to execute or ″W″
DELETE, or SELECT SQL statement resulted in a which returns a warning instead of an error.
cost estimate that exceeded the error threshold
If the warning is caused by an SQL statement
value specified in the resource limit specification
that is consuming too much processor resource,
table (RLST).
attempt to rewrite the statement to perform more
This error is also issued if DB2’s cost category efficiently. Another option is to ask the
value was ″B″, and the default action specified in administrator to increase the error threshold
the RLF_CATEGORY_B column in the RLST is to value in the RLST.
issue an error.
sqlcode: -495
estimate_amount1
sqlstate: 57051
The cost estimate (in processor seconds)
if the prepared INSERT, UPDATE,
DELETE or SELECT statement were to
be executed.
estimate_amount2
The cost estimate (in service units) if the

Chapter 2. SQL Messages 89

 set was previously assigned to a cursor. If
SQL0499N Cursor “<cursor-name>” has
multiple cursors have been allocated for
already been assigned to this or
procedure “<procedure-name>” ensure that only
another result set from procedure
one cursor is used to process the result sets of a
“<procedure-name>”.
stored procedure.
Explanation: An attempt was made to assign a
sqlcode: -499
cursor to a result set but multiple cursors have
been allocated for procedure sqlstate: 24516
“<procedure-name>”.
User Response: Determine if the target result

SQL0500 - SQL0599

SQL0501N The cursor specified in a FETCH SQL0503N A column cannot be updated

or CLOSE statement is not open. because it is not identified in the
FOR UPDATE clause of the
Explanation: The program attempted to either:
SELECT statement of the cursor.
(1) FETCH using a cursor, or (2) CLOSE a cursor
at a time when the specified cursor was not Explanation: Using a cursor, the program
open. attempted to update a value in a table column
that was not identified in the FOR UPDATE
The statement cannot be processed.
clause in the cursor declaration or the prepared
User Response: Check for a previous message SELECT statement.
(SQLCODE) that may have closed the cursor.
Any column to be updated must be identified in
Note that after the cursor is closed, any fetches
the FOR UPDATE clause of the cursor
or close cursor statements receive SQLCODE
declaration.
-501.
The statement cannot be processed.
If no previous SQLCODEs have been issued,
correct the application program to ensure that User Response: Correct the application
the cursor is open when the FETCH or CLOSE program. If the column requires updating, add
statement is executed. its name to the FOR UPDATE clause of the
cursor declaration.
sqlcode: -501
sqlcode: -503
sqlstate: 24501
sqlstate: 42912
SQL0502N The cursor specified in an OPEN
statement is already open. SQL0504N The cursor “<name>” is not
defined.
Explanation: The program attempted to execute
an OPEN statement for an open cursor. Explanation: An UPDATE or DELETE WHERE
CURRENT OF “<name>” was specified, but the
The statement cannot be processed. The cursor
cursor “<name>” was not declared in the
was unchanged.
application program.
User Response: Correct the application program
The statement cannot be processed.
to ensure it does not attempt to execute an
OPEN statement for a cursor already open. User Response: Ensure the completeness of the
application program and correct spelling errors
sqlcode: -502
in the cursor names.
sqlstate: 24502

90 Message Reference, Volume 2

sqlcode: -504 cursors within a savepoint when a ROLLBACK
TO SAVEPOINT is performed.
sqlstate: 34000
Federated system users: the record in a remote
data source has been updated and/or deleted by
SQL0505N The cursor “<name>” is already
another application (or a different cursor within
defined.
this application) and the record no longer exists.
Explanation: The cursor name specified in the
The statement cannot be processed. No data is
DECLARE statement has already been declared.
updated or deleted.
The statement cannot be processed.
User Response: Correct the logic of the
User Response: Ensure the name is spelled application program to ensure that the cursor is
correctly. correctly positioned on the intended row of the
object table before the UPDATE or DELETE
statement is executed. Note that the cursor is not
SQL0507N The cursor specified in the positioned on a row if FETCH returned message
UPDATE or DELETE statement is SQL0100W (SQLCODE = 100).
not open.
sqlcode: -508
Explanation: The program attempted to execute
an UPDATE or DELETE WHERE CURRENT OF sqlstate: 24504
cursor statement when the specified cursor was
not open.
SQL0509N The table specified in the
The statement cannot be processed. No update or UPDATE or DELETE statement is
delete was performed. not the same table specified in the
SELECT for the cursor.
User Response: Check for a previous message
(SQLCODE) that may have closed the cursor. Explanation: The program attempted to execute
Note that after the cursor is closed, any fetches an UPDATE or DELETE WHERE CURRENT OF
or close cursor statements receive SQLCODE -501 cursor statement where the table named did not
and any updates or deletes receive SQLCODE match the name of the table specified in the
-507. Correct the logic of the application program SELECT statement that declared the cursor.
to ensure that the specified cursor is open at the
The statement cannot be processed.
time the UPDATE or DELETE statement is
executed. User Response: Correct the application program
to ensure that the table identified in the UPDATE
sqlcode: -507
or DELETE statement is the same table identified
sqlstate: 24501 in the cursor declaration.
sqlcode: -509
SQL0508N The cursor specified in the
sqlstate: 42827
UPDATE or DELETE statement is
not positioned on a row.
SQL0510N UPDATE or DELETE is not
Explanation: The program attempted to execute
allowed against the specified
an UPDATE or DELETE WHERE CURRENT OF
cursor.
cursor statement when the specified cursor was
not positioned on an object table row. The cursor Explanation: The program attempted to execute
must be positioned on the row to be updated or an UPDATE or DELETE WHERE CURRENT OF
deleted. cursor statement against a table or view
definition that does not permit the requested
The cursor is no longer positioned on a row if
update or delete operation. For example, this
the row is deleted. This includes any use of

Chapter 2. SQL Messages 91

error can occur in a delete from a read-only view Federated system users: isolate the problem to
or in an update where the cursor was not the data source failing the request (see the
defined with the FOR UPDATE clause. problem determination guide for procedures to
follow to identify the failing data source). If a
On the database manager the view is read-only if
data source is failing the request, examine the
the SELECT statement
restrictions for that data source to determine the
v The DISTINCT keyword cause of the problem and its solution. If the
v A column function in the SELECT list restriction exists on a data source, see the SQL
v A GROUP BY or HAVING clause reference manual for that data source to
determine why the object is not updatable.
v A FROM clause that identifies one of the
following: sqlcode: -510
– More than one table or view sqlstate: 42828
– A read-only view (READONLY column of
SYSCAT.SYSVIEWS is set to ’Y’)
SQL0511N The FOR UPDATE clause is not
– A table or view that is also identified in the allowed because the table
FROM clause of a subquery of the SELECT specified by the cursor cannot be
statement. (NOTE: This is a restriction only modified.
in releases of DB2 prior to Version 2).
Explanation: The result table of the SELECT or
v A set operator (other than UNION ALL).
VALUES statement cannot be updated.
Note that these conditions do not apply to
On the database manager, the result table is
subqueries of the SELECT statement.
read-only if the cursor is based on a VALUES
statement or the SELECT statement contains any
The cursor is declared with a FOR FETCH ONLY of the following:
or ORDER BY clause.
v The DISTINCT keyword
The cursor is ambiguous and the BLOCKING v A column function in the SELECT list
ALL bind option was specified. v A GROUP BY, HAVING, or ORDER BY clause
v A FROM clause that identifies one of the
The statement cannot be processed. following:
User Response: If the database manager is – More than one table or view
failing the statement and the cursor is based on a – A read-only view
read-only SELECT or VALUES statement, do not
– An OUTER clause with a typed table or
issue any update or delete statements against it.
typed view
If the database manager is failing the statement – A table or view that is also identified in the
and the cursor is not based on a read-only FROM clause of a subquery of the SELECT
SELECT or VALUES statement and is defined statement. (NOTE: This is only a restriction
with a FOR FETCH ONLY or ORDER BY clause, on version of DB2 prior to Version 2).
either remove this clause from the cursor
v A set operator (other than UNION ALL).
definition or do not issue any update or delete
statements. Note that these conditions do not apply to
subqueries of the SELECT statement.
If the database manager is failing the statement
and the cursor cannot be determined to be either
fetch only or updateable from its definition or The statement cannot be processed.
context, rebind the program with either the User Response: Do not perform updates on the
BLOCKING NO or BLOCKING UNAMBIG bind result table as specified.
option.

92 Message Reference, Volume 2

Federated system users: isolate the problem to the cursor. For case (2), do not issue a
the data source failing the request (see the ROLLBACK until after you finish using the
problem determination guide for procedures to cursor. For case (3), the prepare for the cursor
follow to identify the failing data source). If a must be reissued.
data source is failing the request, examine the
sqlcode: -514
restrictions for that data source to determine the
cause of the problem and its solution. If the sqlstate: 26501
restriction exists on a data source, see the SQL
reference manual for that data source to
determine why the object is not updatable. SQL0516N The DESCRIBE statement does
not specify a prepared statement.
sqlcode: -511
Explanation: The statement name in the
sqlstate: 42829 DESCRIBE statement must specify a statement
that was prepared in the same database
transaction.
SQL0513W The SQL statement will modify
an entire table or view. The statement cannot be processed.
Explanation: The UPDATE or DELETE User Response: Verify that the statement name
statement does not contain a WHERE clause so specifies a statement that has been prepared.
all rows of the table or view are modified if this
statement is executed. sqlcode: -516

The statement is accepted. sqlstate: 26501

Federated system users: not all data sources

report this warning condition. The federated SQL0517N The cursor “<name>” identifies a
server attempts to issue this warning whenever prepared statement that is not a
the condition exists, but there is no guarantee SELECT or VALUES statement.
that the federated server can always detect this Explanation: The cursor “<name>” could not be
condition. Do not rely on this warning to used as specified because the prepared statement
preclude UPDATE/DELETE operations from named in the cursor declaration was not a
affecting an entire table or view. SELECT or VALUES statement.
User Response: Ensure that you intend to The statement cannot be processed.
modify the entire table or view.
User Response: Verify that the statement name
is specified correctly in the PREPARE and the
SQL0514N The cursor “<name>” is not in a DECLARE CURSOR for cursor “<name>”
prepared state. statements. Or correct the program to ensure that
Explanation: The application program tried to only prepared SELECT or VALUES statements
use a cursor “<name>” that is not in a prepared are used in association with cursor declarations.
state. The cursor is associated with a statement sqlcode: -517
that either (1) was never prepared, (2) was made
not valid by a ROLLBACK, or (3) was made not sqlstate: 07005
valid by either an explicit or implicit rebind of
the package.
The statement cannot be processed.
User Response: For case (1), prepare the
statement named in the DECLARE CURSOR
statement for “<name>” before you try to open

Chapter 2. SQL Messages 93

SQL0518N The statement named in the SQL0525N The SQL statement cannot be
EXECUTE statement is not in a executed because it was in error at
prepared state or is a SELECT or bind time for section = ″<sectno>″
VALUES statement. package = ″<pkgname>″
consistency token =
Explanation: The application program tried to
X″<contoken>″.
EXECUTE a statement that (1) was never
prepared, (2) was made not valid by a Explanation: One of the following:
ROLLBACK, (3) is a SELECT or VALUES v The statement was in error when the package
statement, or (4) was made not valid by either was bound, but the error was ignored then
an explicit or implicit rebind of the package. because the option SQLERROR (CONTINUE)
The statement cannot be processed. was used. Since the statement contains an
error, it cannot be executed.
User Response: For case (1), prepare the
v The statement might not be an executable
statement before attempting the EXECUTE. For
statement at this location, or might only be
case (2), either do not issue a ROLLBACK until
executable by a DB2 application requester (for
after you finish using the prepared statement, or
example, DECLARE TABLE in an application
prepare the statement again after the
running on OS/2 causes this message).
ROLLBACK. For case (3), ensure that the
statement is not a SELECT or VALUES statement. The variables are:
For case (4), the prepare for the cursor must be
sectno Section number
reissued.
pkgname
sqlcode: -518
locid.collid.pkgid
sqlstate: 07003
contoken
Consistency token in hexadecimal
SQL0519N The PREPARE statement
identifies the SELECT or VALUES The statement cannot be executed.
statement of the open cursor
“<name>”. User Response: If the SQL statement is not
supposed to execute at the indicated location,
Explanation: The application program then correct the program so that the statement in
attempted to prepare the SELECT or VALUES error does not execute at that location.
statement for the specified cursor when that Precompile, compile, and bind replace the
cursor is already open. package. If the SQL statement is supposed to
execute at the indicated location, correct the
The statement cannot be prepared. The cursor
problem found when it was bound and bind the
was not affected.
package over using BIND with
User Response: Correct the application program ACTION(REPLACE). If multiple versions of the
so it does not attempt to prepare the SELECT or package have been bound, issue the following
VALUES statement for a cursor that is open. SELECT statement to determine which version
has the error: SELECT VERSION FROM
sqlcode: -519
locid.SYSIBM.SYSPACKAGE WHERE
sqlstate: 24506 LOCATION = ’ ’ AND COLLID = ’collid’ AND
NAME = ’pkgid’ AND HEX(CONTOKEN) =
’contoken’
Where:
locid Location name

94 Message Reference, Volume 2

collid Collection id
SQL0530N The insert or update value of the
pkgid Program name FOREIGN KEY
“<constraint-name>” is not equal
sqlcode: -525 to any value of the parent key of
the parent table.
sqlstate: 51015 Explanation: A value in a foreign key of the
object table is being set, but this value is not
SQL0526N The requested function does not equal to any value of the parent key of the
apply to declared temporary parent table.
tables. When a row is inserted into a dependent table,
Explanation: The SQL statement being executed the insert value of a foreign key must be equal to
refers to a declared temporary table. A declared some value of the parent key of any row of the
temporary table cannot be used in the given parent table of the associated relationship.
context. Similarly, when the value of a foreign key is
The statement cannot be processed. updated, the update value of a foreign key must
be equal to the value of the parent key of any
User Response: Modify the SQL statement to row of the parent table of the associated
ensure that the object references are not to relationship at the completion of the statement.
declared temporary tables.
Federated system users: the constraint can exist
sqlcode: -526 on the data source (if the child and parent tables
sqlstate: 42995 exist on the data source).
Some data sources do not provide the
SQL0528N The table “<tablename>” already appropriate values for “<constraint name>”. In
has a unique constraint that is a these cases the message token will have the
duplicate of constraint “<name>”. following format: “<data source>:UNKNOWN”,
indicating that the actual value for the specified
Explanation: A UNIQUE clause uses the same data source is unknown.
column list as the PRIMARY KEY clause, another
UNIQUE clause or the PRIMARY KEY or a The statement could not be executed. The
UNIQUE constraint that already exists for the contents of the object table are unchanged.
table “<tablename>”. Duplicate unique User Response: Examine the insert or update
constraints are not allowed. value of the foreign key first, and then compare
“<name>” is the constraint name, if one was it with each of the parent key values of the
specified or exists. If a constraint name is not parent table to determine and correct the
specified, “<name>” is the first column name problem.
specified in the column list of the UNIQUE sqlcode: -530
clause followed by three periods.
sqlstate: 23503
The statement cannot be processed.
User Response: Remove the duplicate UNIQUE SQL0531N The parent key in a parent row of
clause or change the column list to a set of relationship “<constraint-name>”
columns that is not already part of a unique cannot be updated.
constraint.
Explanation: An operation attempted to update
sqlcode: -528 a parent key in the row of the parent table but
sqlstate: 42891 the parent key in the specified row has
dependent rows in the dependent table

Chapter 2. SQL Messages 95

associated with it in the “<constraint-name>” “<constraint-name>” is NO ACTION, a row of
constraint. the parent table cannot be deleted if the
dependent rows are still dependent on the parent
When the update rule of constraint
key at the completion of the statement.
“<constraint-name>” is NO ACTION, the value
of a parent key in a parent row cannot be When the delete rule of constraint
updated if the parent row has any dependent “<constraint-name>” is RESTRICT, a row of the
rows at the completion of the statement. parent table cannot be deleted if the parent row
has any dependent rows at the time of the delete.
When the update rule of constraint
“<constraint-name>” is RESTRICT, the value of a Note that a delete can cascade to delete other
parent key in a parent row cannot be updated if rows in dependent tables that have a delete rule
the parent row has any dependent rows at the of NO ACTION or RESTRICT. Thus the
time the update of the parent key is attempted. constraint “<constraint-name>” may be on a
different table than the original delete operation.
Federated system users: the constraint can exist
on the data source (if the child and parent tables Federated system users: the constraint can exist
exist on the data source). on the data source (if the child and parent tables
exist on the data source).
Some data sources do not provide the
appropriate values for “<constraint name>”. In Some data sources do not provide the
these cases the message token will have the appropriate values for “<constraint name>”. In
following format: “<data source>:UNKNOWN”, these cases the appropriate fields contain values
indicating that the actual value for the specified (such as “unknown”) that indicate that the actual
data source is unknown. value is unknown.
The statement could not be executed. The The statement could not be executed. The
contents of the parent table are unchanged. contents of the table are unchanged.
User Response: Examine the parent key of the User Response: Examine the delete rule for all
object table and the foreign key of the dependent descendent tables to determine and correct the
table to determine if the value of the specified problem. The specific tables involved can be
row of the parent key should be changed. If this determined from the relationship
does not show the problem, examine the contents “<constraint-name>”.
of the object table and the dependent table to
sqlcode: -532
determine and correct the problem.
sqlstate: 23001, 23504
sqlcode: -531
sqlstate: 23001, 23504
SQL0533N The INSERT statement is not
valid because a relationship
SQL0532N A parent row cannot be deleted restricts the result of the fullselect
because the relationship to one row.
“<constraint-name>” restricts the
Explanation: An INSERT operation with a
deletion.
fullselect attempted to insert multiple rows into a
Explanation: An operation attempted to delete a table that is a parent and a dependent in the
specified row of the parent table but the parent same relationship of a referential constraint.
key in the specified row has dependent rows in
The fullselect of the INSERT operation should
the referential constraint “<constraint-name>”
return no more than one row of data.
and the delete rule of NO ACTION or RESTRICT
is specified for the relationship. The INSERT statement could not be executed.
The contents of the object table are unchanged.
When the delete rule of constraint

96 Message Reference, Volume 2

Federated system users: the constraint can exist Federated system users: the constraint can exist
on the data source (if the child and parent tables on the data source (if the child and parent tables
exist on the data source). exist on the data source).
User Response: Examine the search condition of User Response: Examine the WHERE clause
the fullselect to ensure selection of no more than search condition to ensure no more than one row
one row of data. of data is selected.
sqlcode: -533 NOTE: This is only a restriction in releases of
DB2 prior to Version 2.
sqlstate: 21501
sqlcode: -535
SQL0534N Invalid multiple-row update. sqlstate: 21504
Explanation: An UPDATE operation attempted
to perform a multiple-row update of a column SQL0536N The DELETE statement is not
included in a primary key or unique index. valid because table “<name>” can
be affected by the operation.
Multiple-row updates of columns of a primary
key or unique index are not supported. Explanation: A DELETE operation was
attempted with the indicated table referenced in
The UPDATE statement could not be executed.
a subquery.
The contents of the table are unchanged.
The indicated table referenced in a subquery of
Federated system users: the constraint can exist
the DELETE statement can be affected because it
on federated server (if the child and parent tables
is either:
exist as tables on federated server), or it can exist
on the data source (if the child and parent tables v A dependent of the DELETE object table in a
exist on the data source). relationship with a CASCADE or SET NULL
delete rule.
User Response: Ensure the search condition of
v A dependent of another table in a relationship
the UPDATE statement selects only one object
with a CASCADE or SET NULL delete rule
table row to update.
and deletions from the DELETE object table
sqlcode: -534 can cascade to that table.

sqlstate: 21502 Federated system users: the constraint can exist

on the data source (if the child and parent tables
exist on the data source).
SQL0535N The DELETE statement is not
valid because a self-referencing
Some data sources do not provide the
relationship restricts the deletion
appropriate values for “<name>”. In these cases
to one row.
the appropriate fields contain values (such as
Explanation: A DELETE operation with a “unknown”) that indicate that the actual value is
WHERE clause attempted to delete multiple unknown.
rows from a table which is a parent and a
dependent in the same relationship of a The statement could not be processed.
referential constraint with a RESTRICT or SET
User Response: Do not reference a table in a
NULL delete rule.
DELETE statement subquery when the table can
The WHERE clause of the DELETE operation be affected by the DELETE statement.
should select no more than one row of data.
NOTE: This error is only applicable to releases of
The DELETE statement could not be executed. DB2 prior to Version 2 and hosts accessed
The contents of the object table are unchanged. through DB2 Connect.

Chapter 2. SQL Messages 97

sqlcode: -536 v The descriptions of the corresponding columns
are not compatible. Column descriptions are
sqlstate: 42914
compatible if corresponding columns have
compatible data types (both columns are
SQL0537N The PRIMARY KEY clause, a numeric, character strings, graphic, date/time,
FOREIGN KEY clause, a UNIQUE or have the same distinct type).
clause, or a PARTITIONING KEY
“<name>” is the constraint name if specified in
clause identifies column
the FOREIGN KEY clause. If a constraint name
“<name>” more than once.
was not specified, “<name>” is the first column
Explanation: The column “<name>” appears name specified in the clause followed by three
more than once in a PRIMARY KEY clause, periods.
FOREIGN KEY clause, UNIQUE clause or
PARTITIONING KEY clause of a CREATE or Federated system users: some data sources do
ALTER statement. not provide the appropriate values for “<name>”
and “<table-name>”. In these cases the
Federated system users: the constraint can exist
appropriate fields contain values (such as
on the data source (if the child and parent tables
“unknown”) that indicate that the actual value is
exist on the data source).
unknown.
Some data sources do not provide the
appropriate values for “<name>”. In these cases The constraint can exist the data source (if the
the appropriate fields contain values (such as child and parent tables exist on the data source).
“unknown”) that indicate that the actual value is
unknown. The statement cannot be processed.
The statement cannot be processed. User Response: Correct the statement so the
foreign key description conforms to the parent
User Response: Specify unique names for each
key description.
column.
sqlcode: -538
sqlcode: -537
sqlstate: 42830
sqlstate: 42709

SQL0539N Table “<name>” does not have a

SQL0538N FOREIGN KEY “<name>” does
″<key-type>″ key.
not conform to the description of
the parent key of table Explanation: One of the following occurred:
“<table-name>”. v The table “<name>” was specified as a parent
Explanation: The definition of the indicated in a FOREIGN KEY clause but the table is not
foreign key does not conform to the parent key defined as a parent because it does not have a
description of the table “<table-name>”. primary key.
v The ALTER TABLE statement attempted to
Possible errors are:
drop the primary key for the table “<name>”
v The number of columns in the foreign key but the table does not have a primary key.
column list does not match the number of
v The ALTER TABLE statement attempted to
columns in the parent key column list.
drop the partitioning key for the table
v The number of columns in the foreign key “<name>” but the table does not have a
column list does not match the number of partitioning key.
columns in the primary key of the parent table
(a parent key column list is not specified).

98 Message Reference, Volume 2

Federated system users: the constraint can exist
SQL0541W The referential, primary key, or
on the data source (if the child and parent tables
unique constraint “<name>” is
exist on the data source).
ignored because it is a duplicate
constraint.
Some data sources do not provide the
appropriate values for “<name>” and Explanation: If “<name>” refers to a referential
“<key-type>”. In these cases the appropriate constraint, then a FOREIGN KEY clause uses the
fields contain values (such as “unknown”) that same foreign key and parent table as another
indicate that the actual value is unknown. FOREIGN KEY clause.
If “<name>” refers to a primary key or unique
The statement cannot be processed. A system constraint, then one of the following situations
catalog cannot be defined as a parent in a exists.
referential constraint.
v A PRIMARY KEY clause uses the same set of
User Response: When creating a referential columns as a UNIQUE clause in the statement.
constraint, specify the primary key before v A UNIQUE clause uses the same set of
specifying any foreign keys (constraints). columns as the PRIMARY KEY clause or
sqlcode: -539 another UNIQUE clause in the statement.
v A PRIMARY KEY or a UNIQUE constraint on
sqlstate: 42888
the same set of columns already exists for the
table “<tablename>”.
SQL0540N The definition of table
“<name>” is the constraint name, if specified. If
″<table-name>″ is incomplete
a constraint name was not specified, “<name>”
because it lacks a primary index
is the first column name specified in the column
or a required unique index.
list of the FOREIGN KEY or UNIQUE clause
Explanation: The table named was defined with followed by three periods.
a PRIMARY KEY clause or a UNIQUE clause. Its
definition is incomplete, and it cannot be used Federated system users: the constraint can exist
until a unique index is defined for the primary on the data source (if the child and parent tables
key (the primary index) and for each set of exist on the data source).
columns in any UNIQUE clause (the required
unique indexes). An attempt was made to use Some data sources do not provide the
the table in a FOREIGN KEY clause or in an SQL appropriate values for “<name>”. In these cases
manipulative statement. the appropriate fields contain values (such as
The statement cannot be executed. “unknown”) that indicate that the actual value is
unknown.
User Response: Define a primary index or a
required unique index on the table before The indicated referential constraint or unique
referencing it. constraint was not created. The statement was
sqlcode: -540 processed successfully.

sqlstate: 57001 User Response: No action is required.

Processing can continue.
sqlcode: +541
sqlstate: 01543

Chapter 2. SQL Messages 99

SQL0542N “<name>” cannot be a column of SQL0544N The check constraint
a primary key or unique key “<constraint-name>” cannot be
because it can contain null values. added because the table contains
a row that violates the constraint.
Explanation: The column “<name>” identified
in a PRIMARY KEY clause or UNIQUE clause is Explanation: At least one existing row in the
defined to allow null values. table violates the check constraint that is be
added in the ALTER TABLE statement.
Federated system users: some data sources do
not provide the appropriate values for The statement cannot be processed.
“<name>”. In these cases the appropriate fields
User Response: Examine the check constraint
contain values (such as “unknown”) that indicate
definition that was specified in the ALTER
that the actual value is unknown.
TABLE statement and the data in the table to
The statement cannot be processed. determine why there is a violation of the
constraint. Change either the check constraint or
User Response: Correct the column, primary
the data so that the constraint is not violated.
key or unique key definition.
sqlcode: -544
sqlcode: -542
sqlstate: 23512
sqlstate: 42831

SQL0545N The requested operation is not

SQL0543N A row in a parent table cannot be
allowed because a row does not
deleted because the check
satisfy the check constraint
constraint “<constraint-name>”
“<constraint-name>”.
restricts the deletion.
Explanation: Check constraint violations can
Explanation: The delete operation cannot be
occur on either INSERT or UPDATE operations.
executed because the target table is a parent table
The resulting row violated the check constraint
and is connected with a referential constraint to a
definition on that table.
dependent table with a delete rule of SET NULL.
However, a check constraint defined on the The statement cannot be processed.
dependent table restricts the column from
User Response: Examine the data and the check
containing a null value.
constraint definition in the catalog view
The statement cannot be processed. SYSCAT.CHECKS to determine why the INSERT
or UPDATE statement failed. Change the data so
User Response: Examine the foreign key and its
that the constraint is not violated.
delete rule in the dependent table and the
conflicting check constraint. Change either the sqlcode: -545
delete rule or the check constraint so that they
sqlstate: 23513
do not conflict with each other.
sqlcode: -543
SQL0546N The check constraint
sqlstate: 23511 ″<constraint-name>″ is invalid.
Explanation: A check constraint in the CREATE
TABLE or ALTER TABLE statement is invalid for
one or more of the following reasons:
v the constraint definition contains a subquery
v the constraint definition contains a column
function

100 Message Reference, Volume 2

v the constraint definition contains a host v the constraint definition contains a column
variable function
v the constraint definition contains a parameter v the constraint definition contains a host
marker variable
v the constraint definition contains a special v the constraint definition contains a parameter
register marker
v the constraint definition contains a variant v the constraint definition contains a special
user defined function register
v the constraint definition contains a user v the constraint definition contains a function
defined function with external action that is not deterministic
v the constraint definition contains a user v the constraint definition contains a user
defined function with the scratchpad option defined function with external action
v the check constraint is part of a column v the constraint definition contains a user
definition, and its check-condition contains a defined function with the scratchpad option
reference to a column name other than the v the definition contains a user defined function
column being defined. with the READS SQL DATA option
v the constraint definition contains a dereference v the definition contains a reference to a
operation or a DEREF function where the generated column which is based on an
scoped reference argument is other than the expression
object identifier (OID) column.
v the check constraint is part of a column
v the constraint definition uses a TYPE definition, and its check-condition contains a
predicate. reference to a column name other than the
v the constraint definition includes a CAST column being defined
specification with a SCOPE clause. v the generated column definition contains a
The statement cannot be processed. reference to itself
v the constraint definition contains a dereference
User Response: The user response is one of the
operation or a DEREF function where the
following, depending on the cause of the error:
scoped reference argument is other than the
v change the check constraint so that it does not object identifier (OID) column.
include the listed item.
v the constraint definition uses a TYPE
v move the check constraint definition outside predicate.
the column definition, so that it becomes a
v the constraint definition includes a CAST
table level constraint definition.
specification with a SCOPE clause.
sqlcode: -546
The token within the text of the error message
lists the invalid item.
sqlstate: 42621
The statement cannot be processed.
SQL0548N A check constraint that is defined
User Response: The user response is one of the
with ″<check-condition-element>″
following, depending on the cause of the error:
is invalid.
v change the check constraint or generated
Explanation: A check constraint in the CREATE column so that it does not include the listed
TABLE or ALTER TABLE statement is invalid for item.
one or more of the following reasons:
v move the check constraint definition outside
v the constraint definition contains a subquery the column definition, so that it becomes a
table level constraint definition.

Chapter 2. SQL Messages 101

sqlcode: -548 If “<object-type1>” is DBRM,
“<object-type2>” is PLAN.
sqlstate: 42621.
The SQL statement cannot be executed.
SQL0549N The “<statement>” statement is User Response: Do one of the following to
not allowed for “<object-type1 >” correct the error:
“<object-name1>” because the v If the SQL statement is embedded, remove it,
bind option precompile and compile the application
DYNAMICRULES(BIND) in the program again, and reissue the BIND
“<object-type2>” is in effect. command with the DYNAMICRULES(BIND)
Explanation: A program attempted to issue the option.
indicated SQL statement that is one of several v If appropriate, use the SQL statement with a
SQL statements that cannot be issued from a package or plan that is bound with
package or plan for which the option DYNAMICRULES(RUN).
DYNAMICRULES(BIND) is in effect. Those SQL v Issue the REBIND command with the
statements are: DYNAMICRULES(RUN) option for the plan or
v Dynamic GRANT statement package to which the SQL statement is bound.
v Dynamic REVOKE statement sqlcode: -549
v Dynamic ALTER statement
v Dynamic CREATE statement sqlstate: 42509
v Dynamic DROP statement
v Static or dynamic SET CURRENT SCHEMA SQL0551N “<authorization-ID>” does not
statement. have the privilege to perform
operation “<operation>” on object
“<statement>” “<name>”.
The SQL statement in error
Explanation: Authorization ID
“<object-type1>” “<authorization-ID>” attempted to perform the
PACKAGE or DBRM. DBRM is valid specified “<operation>” on “<name>” without
only in a DRDA connection. the proper authorization.
“<object-name1>” If creating or altering a table with referential
If “<object-type1>” is PACKAGE, constraints, this message (SQLCODE) can
“<object-name1>” is the name of the indicate that the user does not have the
package in the format REFERENCES privilege to create or drop a
’location-id.collection-id.package-id’. If FOREIGN KEY. In this case the “<operation>” is
“<object-type1>” is DBRM, “REFERENCES” and the “<name>” is the object
“<object-name1>” is the name of the the constraint references.
DBRM in the format ’plan-name
DBRM-name’. If attempting to run a DB2 utility or CLI
application, the DB2 utility programs may need
“<object-type2>” to be rebound to the database because the userid
PACKAGE or PLAN. PLAN is valid who created the database no longer exists or no
only in a DRDA connection. If longer has the required privileges.
“<object-type1>” is PACKAGE,
“<object-type2>” can be either Federated system users: if this message is
PACKAGE or PLAN (whichever is returned when the user is changing the
bound with DYNAMICRULES(BIND)). remote_pw column of the
SYSCAT.USEROPTIONS view, the user is not

102 Message Reference, Volume 2

authorized to change a password for another and “UNKNOWN” indicating that the actual
user. The user performing the alter operation values for authid and operation at the specified
must have either SYSADM authority or an data source are not known.
authorization ID (the value in the USER special
The statement cannot be processed.
register) that matches the value of the authid
column in the rows being updated. Some data User Response: Ensure that
sources do not provide the appropriate values for “<authorization-ID>” has the authorization to
“<authid>”, <operation>, and <name>. In these perform the operation.
cases the message tokens will have the following
format: “<data source> AUTHID:UNKNOWN”, Federated system users: this authorization can be
“UNKNOWN”, and “<data at the federated server, the data source, or both.
source>:TABLE/VIEW”, indicating that the sqlcode: -552
actual values for the authid, operation, and name
at the specified data source are not known. sqlstate: 42502

The statement cannot be processed.

SQL0553N An object cannot be created with
User Response: Ensure that the schema name
“<authorization-ID>” has the authorization “<schema-name>”.
necessary to perform the operation.
Explanation: The reason the schema name
Federated system users: this authorization can be “<schema-name>” is invalid depends on the type
at the federated server, the data source, or both. of object that is being created.
If the DB2 utility programs need to be rebound v Objects of types that existed in releases prior
to the database, the database administrator can to DB2 Version 2 (tables, views, indexes and
accomplish this by issuing one of the following packages) cannot be created with the schema
CLP command from the bnd subdirectory of the name SYSCAT, SYSFUN, SYSSTAT or SYSIBM.
instance, while connected to the database: It is strongly advised that schema names
v ″DB2 bind @db2ubind.lst blocking all grant should not start with SYS since additional
public″ for the DB2 utilities. schemas starting with these letters may be
reserved for exclusive use of DB2 in the future.
v ″DB2 bind @db2cli.lst blocking all grant
public″ for CLI. v Objects of types that are being introduced
starting with DB2 Version 2 (user defined
sqlcode: -551 functions, distinct types, triggers, schemata,
and aliases) cannot be created with any
sqlstate: 42501 schema name that starts with the letters SYS.
The statement cannot be processed.
SQL0552N “<authorization-ID>” does not
User Response: Use a valid schema name or
have the privilege to perform
remove the explicit schema name and rerun the
operation “<operation>”.
statement.
Explanation: Authorization ID
sqlcode: -553
“<authorization-ID>” attempted to perform the
specified “<operation>” without the proper sqlstate: 42939
authorization.
Federated system users: some data sources do SQL0554N An authorization ID cannot grant
not provide the appropriate values for a privilege to itself.
“<authorization-ID>” and <operation>. In these
cases the message tokens will have the following Explanation: An authorization ID attempted to
format: “<data source> AUTHID:UNKNOWN”, execute a GRANT statement where the
authorization ID itself appears as one of the

Chapter 2. SQL Messages 103

entries in the authorization ID list to which
SQL0557N The specified combination of
privileges are to be granted.
privileges cannot be granted or
The statement cannot be processed. revoked.

User Response: Remove the authorization ID Explanation: One of the following occurred:
from the list. v The GRANT or REVOKE statement contains a
sqlcode: -554 combination of privileges that are of different
classes. The privileges must all be of one class.
sqlstate: 42502 Examples are DATABASE, PLAN, or TABLE.
v The GRANT statement attempted to grant a
SQL0555N An authorization ID cannot privilege for a view that is not allowed.
revoke a privilege from itself. ALTER, INDEX and REFERENCES cannot be
granted for a view.
Explanation: An authorization ID attempted to
execute a REVOKE statement where the The statement cannot be processed.
authorization ID itself appears as one of the User Response: Correct and resubmit the
entries in the authorization ID list from which statement.
privileges are to be revoked.
sqlcode: -557
The statement cannot be processed.
sqlstate: 42852
User Response: Remove the authorization ID
from the list.
SQL0558N An attempt to revoke a privilege
sqlcode: -555 from “<authorization-ID>” was
sqlstate: 42502 denied because
“<authorization-ID>” would still
hold “<control>” authority.
SQL0556N An attempt to revoke a privilege
from “<authorization-ID>” was Explanation: “<authorization-ID>” holds the
denied because “<control>” privilege. The privilege to be
“<authorization-ID>” does not revoked is implicit in the “<control>” privilege,
hold this privilege. so it cannot be revoked unless the “<control>”
privilege is also revoked.
Explanation: The privilege cannot be revoked
because “<authorization-ID>” does not hold the The valid values for “<control>” are the
privilege. following:
v DBADM
The statement cannot be processed.
v CONTROL
User Response: Change the REVOKE statement
to conform to the REVOKE rules and resubmit The statement cannot be executed. No privileges
the statement. Ensure that when a REVOKE are revoked.
statement lists several privileges to be revoked User Response: Revoke the “<control>”
and a list of authorization IDs that each privilege, if desired.
authorization ID possesses at least one of the
specified privileges. sqlcode: -558
sqlcode: -556 sqlstate: 42504
sqlstate: 42504

104 Message Reference, Volume 2

 may identify both a user and a group in the
SQL0562N The specified database privileges
security namespace, and did not explicitly
cannot be granted to PUBLIC
specify the USER or GROUP keyword in the
(public).
statement. The statement is therefore ambiguous.
Explanation: The GRANT statement attempted Note that when using DCE security, the USER or
to grant a database privilege to the reserved GROUP keyword is always required.
authorization ID PUBLIC (public). DBADM
User Response: Change the statement to
authority cannot be granted to PUBLIC (public).
explicitly specify the USER or GROUP keyword
The statement cannot be processed. to uniquely identify the required authorization
id.
User Response: The implied function is not
supported. sqlcode: -569
sqlcode: -562 sqlstate: 56092
sqlstate: 42508
SQL0570W Not all requested privileges on
object ″<object-name>″ of type
SQL0567N “<authorization-ID>” is not a
″<object-type>″ were granted.
valid authorization ID.
Explanation: A GRANT operation was
Explanation: The authorization ID specified by
attempted on object ″<object-name>″ of type
“<authorization-ID>” is not valid for one of the
″<object-type>″, but some or all of the privileges
following reasons:
were not granted. The authorization ID that
v It begins with ″SYS″, ″sys″, ″IBM″, ″ibm″, issued the statement does not have all of the
″SQL″, or ″sql″. privileges to be granted with grant option or
v It contains characters other than a through z, does not have DBADM authority.
A through Z, 0 through 9, and the three
All valid requested privileges were granted.
special characters (#,@.$).
v It is delimited and contains lower case letters. User Response: Obtain the required authority
and try the the operation again.
v It is GUESTS, ADMINS, USERS, or LOCAL.
v It is PUBLIC preceded by the keyword USER sqlcode: +570
or GROUP in a GRANT or REVOKE sqlstate: 01007
statement.
The statement cannot be processed. SQL0572N Package ″<pkgname>″ is
User Response: Correct the invalid inoperative.
authorization ID. Explanation: The package ″<pkgname>″ is
sqlcode: -567 marked as inoperative and must be explicitly
rebound before it can be used. This package
sqlstate: 42602 cannot be used because one or more user-defined
functions that it depends upon have been
SQL0569N The GRANT/REVOKE statement dropped.
failed because User Response: Explicitly rebind the named
″<authorization-name>″ may package using either the REBIND or the BIND
identify both a user and a group command.
in the system.
sqlcode: -572
Explanation: The GRANT or REVOKE
statement specified an authorization name that sqlstate: 51028

Chapter 2. SQL Messages 105

 4 The value is more than 254 bytes,
SQL0573N A column list specified in the
including quotes for strings, introducer
references clause of constraint
characters such as the X for a hex
“<name>” does not identify a
constant, fully qualified function names,
unique constraint of the parent
and parentheses. Non-significant blanks
table “<table-name>”.
in the value are ignored. In an unequal
Explanation: A list of column names was code page environment, the value may
specified in the references clause for the be more than 254 bytes due to
constraint identified by “<name>” that does not expansion of the string in the database
match the column names of the primary key or code page.
any unique key of the referenced table
5 The USER special register is specified
“<table-name>”.
and the length attribute of the character
“<name>” is the constraint name, if specified. If string data type is less than 8.
a constraint name was not specified, “<name>”
6 A datetime special register (CURRENT
is the first column name specified in the column
DATE, CURRENT TIME, or CURRENT
list of the FOREIGN KEY clause followed by
TIMESTAMP) is specified and does not
three periods.
match the data type of the column.
The statement cannot be processed.
7 A function was specified that is not
User Response: Correct the column list in the supported. The specified function must
references clause or add the unique constraint to be system-generated cast function or
the referenced table. one of the built-in functions BLOB,
DATE, TIME, or TIMESTAMP.
sqlcode: -573
8 The argument to a datetime function
sqlstate: 42890
was not a character string constant or
the corresponding datetime special
SQL0574N DEFAULT value or IDENTITY register.
attribute value is not valid for
9 A system-generated cast function was
column “<column-name>” in
specified and the column is not defined
table “<table-name>”. Reason
with a user-defined distinct type.
code: “<reason-code>”.
10 A value with non-zero scale was
Explanation: The DEFAULT value or IDENTITY
specified for the START WITH or
attribute value for column “<column-name>” in
INCREMENT BY option of an identity
table “<table-name>” is not valid. The possible
column.
reason codes are as follows:
<0 Any reason code that is less than zero is
1 The value is not assignable to the
an SQLCODE. The error in the
column because the constant does not
DEFAULT value specification can be
conform to the format for a constant of
determined by checking the error
that data type, the value has an
message corresponding to this
incorrect length or precision, or the
SQLCODE.
function returns an incorrect data type.
2 A floating-point constant is specified The statement cannot be processed.
and the column is not a floating point
User Response: Correct the DEFAULT value or
data type
IDENTITY attribute value based on the reason
3 A decimal constant is specified and code that was returned.
non-zero digits would be truncated
sqlcode: -574
when assigned to the column

106 Message Reference, Volume 2

sqlstate: 42894
SQL0577N User defined function or
procedure “<function-name>”
SQL0575N View or summary table “<name>” (specific name “<specific-name>”)
cannot be used because it has attempted to modify data but was
been marked inoperative. not defined as MODIFIES SQL
DATA.
Explanation: The view or summary table
“<name>” has been marked inoperative because Explanation: The program used to implement
a table, view, alias, or privilege upon which it is the body of a user defined function or procedure
dependent has been removed. The view cannot is not allowed to modify SQL data.
be used by any SQL statement other than one of
User Response: Remove any SQL statements
the following:
that modify data then recompile the program.
v COMMENT ON For stored procedures, investigate the level of
v DROP VIEW or DROP TABLE SQL allowed as specified on the CREATE
v CREATE ALIAS PROCEDURE statement.

v CREATE VIEW or CREATE TABLE sqlcode: -577

The statement cannot be processed. sqlstate: 38002

User Response: If “<name>” is a view, recreate sqlstate: 42985

the view by issuing a CREATE VIEW statement
using the same view definition as the inoperative
SQL0579N User defined function or
view. If “<name>” is a summary table, recreate
procedure “<function-name>”
the summary table by issuing the CREATE
(specific name “<specific-name>”)
TABLE statement using the same summary table
attempted to read data but was
definition as in the inoperative summary table.
not defined as READ SQL DATA
sqlcode: -575 or MODIFIES SQL DATA.

sqlstate: 51024 Explanation: The program used to implement

the body of a user defined function or procedure
is not allowed to read SQL data.
SQL0576N Alias “<name>” cannot be created
for “<name2>” as it would result User Response: Remove any SQL statements
in a repetitive alias chain. that read data then recompile the program. For
stored procedures, investigate the level of SQL
Explanation: The alias definition of “<name>” allowed as specified on the CREATE
on “<name2>” would have resulted in a PROCEDURE statement.
repetitive alias chain which could never be
resolved. For example, ″alias A refers to alias B sqlcode: -579
which refers to alias A″ is a repetitive alias chain
sqlstate: 38004
which could never be resolved.
sqlstate: 42985
The statement cannot be processed.
User Response: Change the alias definition for
SQL0580N The result-expressions of a CASE
“<name>” or revise the definition of one of the
expression cannot all be NULL.
other alias definitions in the alias chain to avoid
a repetitive chain. Explanation: There is a CASE expression in the
statement that has all the result-expressions
sqlcode: -576
(expressions following THEN and ELSE
sqlstate: 42916 keywords) coded with the keyword NULL.

Chapter 2. SQL Messages 107

The statement cannot be processed. v an IN predicate using a fullselect or
User Response: Change the CASE expression to v an EXISTS predicate
include at least one result-expression that is other and the CASE expression is part of:
than the keyword NULL.
v a VALUES clause
sqlcode: -580 v an IN predicate
sqlstate: 42625 v a GROUP BY clause or
v an ORDER BY clause.
SQL0581N The data types of the Such CASE expressions are not supported. The
result-expressions of a CASE CASE expression may be part of a function
expression are not compatible. written in SQL.
Explanation: There is a CASE expression in the
statement that has result-expressions (expressions The statement cannot be processed.
following THEN and ELSE keywords) that are User Response: Remove the use of the
not compatible. quantified predicate, IN predicate, or EXISTS
The data type of a CASE expression is predicate from the CASE expression. If the CASE
determined using the ″Rules for Result Data expression is part of a function, the query may
Types″ on the result-expressions. The data types need to be written without the function that
of the result-expressions may be incompatible for causes the error.
one of the following reasons: sqlcode: -582
v they are not all character data types
sqlstate: 42625
v they are not all numeric data types
v They are not all date data types
SQL0583N The use of routine
v They are not all time data types “<routine-name>” is invalid
v They are not all timestamp data types because it is not deterministic or
v They are not all the same user-defined distinct has an external action.
data types Explanation: The routine (function or method)
The statement cannot be processed. “<routine-name>” is defined as a
non-deterministic routine or a routine with an
User Response: Correct the result-expressions external action. This type of routine is not
so that they are compatible. supported in the context in which it is used. The
sqlcode: -581 contexts in which these are not valid are:
v as the first operand of a BETWEEN predicate
sqlstate: 42804
v in the expression prior to the first WHEN
keyword in a simple-case-expression.
SQL0582N A CASE expression in a VALUES
v in an expression of a GROUP BY clause
clause, IN predicate, GROUP BY
clause, or ORDER BY clause v in an expression of an ORDER BY clause
cannot include a quantified (external action only)
predicate, an IN predicate using a v in a FILTER clause of a user-defined predicate
fullselect, or an EXISTS predicate. specification or an index extension definition
Explanation: A search condition of a CASE The statement cannot be processed.
expression is:
User Response: If the use of a non-deterministic
v a quantified predicate (one using SOME, ANY, or external action routine was not intended,
or ALL),

108 Message Reference, Volume 2

substitute a routine without these characteristics. statement where the object is a nickname.
If the behavior associated with the
User Response: Substitute a value other than
non-deterministic or external action routine is
NULL or DEFAULT in the VALUES clause. If
intentional, use the alternate form of the
DEFAULT is used as a column-name, capitalize it
statements that make that intent explicit.
and enclose it in double quotes.
v Instead of the BETWEEN predicate, use the
corresponding statement using the equivalent sqlcode: -584
combination of comparison predicates (a>=b sqlstate: 42608
and a<=c instead of a between b and c).
v Instead of a simple-when-clause, use the
corresponding searched-when-clause where the SQL0585N The schema name
routine would get specified in each “<schema-name>” can not appear
search-condition. more than once in the function
path.
v Remove the non-deterministic or external
action routine from the GROUP BY clause. If Explanation: The function path includes
grouping is desired on a column of the result “<schema-name>” more than once. The function
that is based on a non-deterministic or external path can only include one occurrence of each
action routine use a nested table expression or schema name.
a common table expression to first provide a
The statement cannot be processed.
result table with the expression as a column of
the result. User Response: Remove duplicate occurrences
v Remove the external action routine from the of “<schema-name>” from the function path.
ORDER BY clause. If the column is part of the sqlcode: -585
result set of the query, change the expression
in the ORDER BY clause to the simple-integer sqlstate: 42732
or simple-column-name form of the sort key.
v Remove the non-deterministic or external SQL0586N The total length of the CURRENT
action routine from the FILTER clause. FUNCTION PATH special register
cannot exceed 254 characters.
sqlcode: -583
Explanation: The CURRENT FUNCTION PATH
sqlstate: 42845 special register is defined as a VARCHAR(254).
The content of the string includes each schema
name delimited with double quotes and
SQL0584N Invalid use of NULL or
separated from the next schema name by a
DEFAULT.
comma. The total length of the string of all
Explanation: DEFAULT can only be used in a schema names in the CURRENT FUNCTION
VALUES clause that is part of an INSERT PATH cannot exceed 254 characters. The SET
statement. CURRENT FUNCTION PATH statement or the
FUNCPATH option of the PREP or BIND
A VALUES clause that is not part of an INSERT command causing this message would exceed
statement must have a value other than NULL in this limit.
at least one row for each column.
The statement or command cannot be processed.
If DEFAULT is used as a column-name in a
WHERE or HAVING clause, it must be User Response: Remove schema names to
capitalized and enclosed in double quotes. reduce the total length to fit the 254 character
maximum length. If all the schema names are
Federated system users: DEFAULT can not be required, it may be necessary to consolidate
used in a VALUES clause of an INSERT some user-defined functions so that less schema

Chapter 2. SQL Messages 109

names are required on the CURRENT key or a unique key, and the indicated index
FUNCTION PATH. matches the required index.
sqlcode: -586 When creating a primary key or unique key
index, an index description matches if it
sqlstate: 42907
identifies the same set of columns (in any order)
as the primary or unique key without regard to
SQL0590N Name “<name>” specified in ascending or descending specifications, and is
procedure “<procedure>” is not specified as unique.
unique.
The statement is processed successfully.
Explanation: Name “<name>” is specified as a
User Response: No action is required.
parameter, SQL variable, cursor, label, or
condition in procedure “<procedure>”. The name sqlcode: +598
is not unique.
sqlstate: 01550
User Response: Change the name so that it is
unique.
SQL0599W Comparison functions are not
sqlcode: -590 created for a distinct type based
on a long string data type.
sqlstate: 42734
Explanation: Comparison functions are not
created for a distinct type based on a long string
SQL0595W Isolation level
data type (BLOB, CLOB, DBCLOB, LONG
“<requested-level>” has been
VARCHAR, or LONG VARGRAPHIC) since the
escalated to “<escalated-level>”.
corresponding functions are not available for
Explanation: The isolation level specified is not these built-in data types.
supported by DB2. It has been escalated to the
This is a warning situation. The statement is
next higher level of isolation supported by DB2.
processed successfully.
User Response: To avoid this warning, specify
User Response: No action is required.
an isolation level which is supported by DB2.
DB2 supports isolation levels Repeatable Read sqlcode: +599
(RR), Read Stability (RS), Cursor Stability (CS),
sqlstate: 01596
and Uncommitted Read (UR).
sqlcode: +595
sqlstate: 01526

SQL0598W Existing index ″<name>″ is used

as the index for the primary key
or a unique key.
Explanation: An index was required for an
ALTER TABLE operation that defined a primary

SQL0600 - SQL0699

110 Message Reference, Volume 2

 User Response: Either drop the existing object
SQL0600N A routine “<routine-name>” could
or choose another name for the new object.
not be generated because of a
duplicate signature or because it Federated system users: if the statement is a
would override an existing CREATE FUNCTION MAPPING or a CREATE
routine. TYPE MAPPING statement, the user can also
consider not supplying a type mapping name
Explanation: During the CREATE or ALTER
and the system will automatically generate a
operation, a system-generated cast function,
unique name for this mapping.
observer method, mutator method, or constructor
function could not be created because another sqlcode: -601
function or method with the same name and
signature already exists in the schema, or sqlstate: 42710
because the method or function would override
an existing method. SQL0602N The CREATE INDEX or CREATE
User Response: Choose another name for the INDEX EXTENSION statement
user-defined type, attribute, or cast function that specifies too many columns (16 is
causes the conflict, or drop the function or the maximum).
method with the same name as the function or Explanation: The number of columns for the
method that could not be generated. index that would be generated by the CREATE
sqlcode: -600 INDEX statement exceeds the maximum of 16
columns for the database manager. If the index is
sqlstate: 42710 defined on a typed table, there is additional
overhead that reduces the maximum number of
specified columns to 15.
SQL0601N The name of the object to be
created is identical to the existing For a CREATE INDEX EXTENSION statement,
name “<name>” of type “<type>”. the GENERATE KEY function returns a number
of columns that exceeds the maximum of 16
Explanation: The CREATE or ALTER statement
columns allowed in an index.
tried to create or add an object “<name>” when
an object of type “<type>” already exists with Federated system users: the limit for other data
that name on the application server or in the sources is different. That limit could have been
same statement. exceeded. This problem may be detected on the
federated server, or it may be detected on the
If “<type>” is FOREIGN KEY, PRIMARY KEY,
data source.
UNIQUE, or CHECK CONSTRAINT, the
“<name>” is the constraint name specified in the The statement cannot be processed.
CREATE or ALTER TABLE statement or
generated by the system. User Response: Change the index definition to
conform to the column limit of 16. For a
Federated system users: some data sources do CREATE INDEX EXTENSION statement, specify
not provide the appropriate values for the a different GENERATE KEY function, or redefine
“<name>” and “<type>” message tokens. In the function to return fewer columns.
these cases, “<name>” and “<type>” will have
the following format: “OBJECT:<data source> Federated system users: change the index
TABLE/VIEW”, and “UNKNOWN” indicating definition to conform to the column limit for the
that the actual values at the specified data source data source.
are not known. sqlcode: -602
The statement cannot be processed. No new sqlstate: 54008
object is created, and the existing object is not
altered or modified.

Chapter 2. SQL Messages 111

 ″CAST FROM″. In some cases, it may also be
SQL0603N A unique index cannot be created
the data type containing the error.
because the table contains rows
which are duplicates with respect v for a CREATE DISTINCT TYPE statement,
to the values of the identified “<data-item>” gives the name of the type
columns. being defined or the source data type
containing the error.
Explanation: The index defined in the CREATE
v for a CREATE or ALTER TYPE statement,
INDEX statement could not be created as unique,
“<data-item>” gives the type of the attribute
because the specified table already contains rows
containing the error or the name of the
that duplicate the values of the identified
structured type having an incorrect inline
columns.
length value. The inline length cannot be
Federated system users: this situation may also smaller than 292 and the size returned by the
be detected by the data source. constructor function for the structured type.
The statement cannot be processed. The specified v for CAST( expression AS data-type ),
index is not created. ″<data-item>″ is ″CAST″ or the data type
containing the error.
User Response: Examine the data to determine
if the duplicate data is permitted. Alternatively, Federated system users: if the statement is a
consider creating a non-UNIQUE index. CREATE TYPE MAPPING statement, an attempt
was made to create a type mapping where a type
sqlcode: -603 attribute for either the local data type or the
sqlstate: 23515 remote data type is not valid. Possible reasons
include:
v The local length/precision is set to 0 or a
SQL0604N The length, precision, or scale negative value.
attribute for column, distinct type,
structured type, attribute of v The length/precision attribute is specified for
structured type, function, or type data types such as date/time/timestamp, float,
mapping “<data-item>” is not or integer.
valid. v The scale attribute is specified for data types
such as character, date/time/timestamp, float,
Explanation: There is an error in the data type or integer.
specification in a CREATE or ALTER statement,
or a CAST specification. An invalid length, v The FOR BIT DATA clause is specified for a
precision or scale attribute may have been non-character type.
specified, or it may be that the data type itself is v The remote precision is set to 0 for remote
incorrect or not permitted in this context. The types other than Informix datetime.
location of the error is given by “<data-item>” as v An invalid field qualifier is being used in a
follows: type mapping for an Informix datetime type.
v for a CREATE or ALTER TABLE statement, v An ending value is lower than the starting
“<data-item>” gives the name of the column value in a precision/scale range.
containing the error or the data type
containing an error. If the column data type is The statement cannot be processed.
a structured type, then the explicit or implicit User Response: Correct the syntax and try
INLINE LENGTH value must be at least 292 again.
and cannot exceed 32677.
sqlcode: -604
v for a CREATE FUNCTION statement,
“<data-item>” is a token that identifies the sqlstate: 42611
area of the problem in the statement. For
example, ″PARAMETER 2″ or ″RETURNS″ or

112 Message Reference, Volume 2

SQL0605W The index was not created SQL0607N “<operation>” is not defined for
because the index “<name>” system objects.
already exists with the required
Explanation: The “<operation>” specified in the
description.
SQL statement cannot be performed on system
Explanation: A CREATE INDEX operation objects. One of the following was attempted:
attempted to create a new index and the v DROP or ALTER a system owned object such
indicated index matches the required index. as a system catalog table, built-in function or
For CREATE INDEX, two index descriptions built-in data type
match if they identify the same columns in the v COMMENT ON a system owned built-in
same order with the same ascending or function.
descending specifications, and are both specified v INSERT or DELETE on a system catalog table.
as unique or the new index is specified as
v UPDATE directly on a system catalog table.
non-unique. Also, two index descriptions match
Some columns of a subset of system catalog
if they identify the same columns in the same
tables are updateable. For UPDATE operation
order with the same or reverse ascending or
on these catalog tables, updateable views in
descending specifications, and at least one
SYSSTAT schema should be used. For a
description includes the ALLOW REVERSE
description of updateable catalog views
SCANS parameter.
(SYSSTAT views), see the SQL Reference.
The new index was not created. v CREATE or DROP of an index on a system
User Response: No action is required unless the table
existing index ″<name>″ is not a suitable index. v CREATE of a trigger on a system table
For example, the existing index “<name>” is not v A non-updateable system table was identified
a suitable index if it does not allow reverse in the FROM clause of a SELECT statement
scans, and the required one does (or vice versa). containing a FOR UPDATE clause. For a list of
In this case, the index “<name>” must be updateable system catalogs see the SQL
dropped before the required index can be Reference.
created.
v DROP or ALTER of a system table space.
sqlcode: +605 v DROP or ALTER of a system nodegroup.
sqlstate: 01550 v REDISTRIBUTE of the IBMCATGROUP or
IBMTEMPGROUP nodegroups.
SQL0606N The COMMENT ON or LABEL The statement cannot be processed.
ON statement failed because the
User Response: Do not attempt to modify any
specified table or column is not
system objects except for those columns of the
owned by “<owner>”.
system catalog tables which are updateable
Explanation: An attempt was made to comment through updateable SYSSTAT views. See the SQL
or label on a table or column which does not Reference for more information.
exist or is not owned by the owner specified in
sqlcode: -607
the message text.
sqlstate: 42832
Processing of the SQL statement has ended.
User Response: Correct the statement. Try
SQL0612N “<name>” is a duplicate name.
again.
Explanation: A statement was issued with the
sqlcode: -606
same name appearing more than once where
sqlstate: 42505 duplicates are not allowed. Where these names

Chapter 2. SQL Messages 113

appear varies depending on the type of v CREATE INDEX EXTENSION statements
statement. cannot have the same name defined for two
v CREATE TABLE statements cannot have the parameters.
same column name defined for two columns. The statement cannot be processed.
v CREATE VIEW statements or common table
User Response: Specify unique names as
expression definitions cannot have the same
appropriate for the type of statement.
column name in the column name list. If no
column name list is specified, then the column sqlcode: -612
names of the columns in the select list of the
view must be unique. sqlstate: 42711

v ALTER TABLE statement cannot add a column

to a table using the name of a column that SQL0613N The primary key or a unique key
already exists or is the same as another identified by “<name>” is too
column being added. Furthermore, a column long or has too many columns.
name can only be referenced in one ADD or
Explanation: The sum of the internal lengths of
ALTER COLUMN clause in a single ALTER
columns in the PRIMARY KEY clause or a
TABLE statement.
UNIQUE clause identified by “<name>” exceeds
v CREATE INDEX cannot have a column name 1024 or the number of columns exceeds the
specified more than once as part of the index maximum of 16. Also, a primary key or a unique
key or the INCLUDE columns of the index. key cannot be defined using a LONG VARCHAR
v CREATE TRIGGER cannot have a column column. If the primary key or unique constraint
name specified more than once in the list of is defined on a typed table, there is additional
columns that cause an update trigger to be index overhead that reduces the maximum
activated. number of specified columns to 15 and limits the
v CREATE TABLE OF statements cannot have length to 1020.
the same name defined for the REF IS column “<name>” is the constraint name, if specified, of
and any attribute of the structured type. the primary key or unique constraint. If a
v CREATE TYPE statements cannot have the constraint name was not specified, “<name>” is
same name defined for two attributes. the first column name specified in the primary
Attribute names must be unique with the type key or unique constraint clause followed by three
and all supertypes. periods.
v ALTER TYPE statements cannot add an The statement cannot be processed.
attribute to a structured type using the name
of an attribute that already exists in the type User Response: Modify the primary key or a
or any of its subtypes or is the same as unique key definition by eliminating one or more
another attribute being added. Also, the name key columns to conform to the column limit of
of the attribute may not be the same as the 16 and the key length limit.
REF IS column in any table created from the sqlcode: -613
structured type. Furthermore, an attribute
name can only be referenced in one ADD or sqlstate: 54008
DROP ATTRIBUTE clause in a single ALTER
TYPE statement.
v CREATE FUNCTION statements cannot have
the same name defined for two parameters.
The name used in the EXPRESSION AS clause
cannot be the same as a parameter name.

114 Message Reference, Volume 2

 sqlstate: 55006
SQL0614N The index or index extension
″<index-name>″ cannot be created
or altered because the combined SQL0620N The CREATE TABLE statement
length of the specified columns is failed because “<user-id>” has no
too long. private, recoverable dbspaces with
less than 255 tables.
Explanation: The index could not be created or
altered because the sum of the key column Explanation: The dbspace name was not
internal lengths would exceed 1024. Also, an specified in the CREATE TABLE statement, so
index cannot be created using a LONG the database manager tried to find a private
VARCHAR, LONG VARGRAPHIC, or LOB dbspace owned by “<user-id>”. This message
column. If the index is defined on a typed table, will appear under one of the following
there is additional index overhead that reduces conditions:
the maximum length by 4 bytes. The index may 1. There were no private dbspaces found in the
be altered by an ALTER TABLE statement that DB2 for VM database for the “<user-id>”.
alters the data type of one or more columns.
2. There were one or more private dbspaces
An index extension could not be created because found for the “<user-id>”, but each contained
the sum of the columns returned by the 255 tables.
GENERATE KEY function would exceed 1024. 3. The private dbspaces were located in
The statement cannot be processed. The specified nonrecoverable storage pools. Only private
index or index extension was not created or the dbspaces that exist in recoverable storage
table could not be altered. pools will be available when the CREATE
TABLE statement does not specify the
User Response: To modify the index definition dbspace name.
or alter column, eliminate one or more key
columns and reduce the key length to the Processing of the SQL statement has ended.
permitted maximum. For an index extension User Response: Suggestions for the three
definition, specify a different GENERATE KEY conditions above are:
function, or redefine the function to reduce the
length of the returned row. 1. Acquire a private dbspace in a recoverable
storage pool. You may require a database
sqlcode: -614 administrator’s assistance.
sqlstate: 54008 2. Drop a table in a private dbspace residing in
a recoverable storage pool to free up an entry,
or take the action indicated in (1) above.
SQL0615N The object “<object-name>” of
3. If you want to create the table in a dbspace
type “<object-type>” cannot be
existing in a non-recoverable storage pool,
dropped because it is currently in
then specify the dbspace name on the
use by the same application
CREATE TABLE command. Otherwise, take
process.
the action indicated in (1) above.
Explanation: A DROP statement of an object
Then rerun the CREATE TABLE statement.
cannot be issued when it is in use.
The statement cannot be processed. The object is If appropriate, acquire a private dbspace for the
not dropped. user.
User Response: Close any cursors that depend
either directly or indirectly on the object sqlcode: -620
“<object-name>” and resubmit the statement.
sqlstate: 57022
sqlcode: -615

Chapter 2. SQL Messages 115

 v The keyword may appear more than once with
SQL0623N A clustering index already exists
different associated values.
on table “<name>”.
v The keyword may require the specifying of
Explanation: The CREATE INDEX statement other particular keywords in the same
would create a second clustering index on the statement which were not specified.
specified table. A given table can have only one
clustering index. User Response: Check that the statement
conforms to the syntax and rules defined for the
The statement cannot be executed. statement. Correct any invalid occurrences of
User Response: Check to determine the identity duplicate or conflicting keywords.
and validity of the existing clustering index on sqlcode: -628
table “<name>”. Consider creating the index
without the CLUSTER attribute. sqlstate: 42613

sqlcode: -623
SQL0629N SET NULL cannot be specified
sqlstate: 55012 because FOREIGN KEY
“<name>” cannot contain null
SQL0624N Table “<name>” already has a values.
“<key-type>” key. Explanation: The SET NULL option of the
Explanation: A primary key or partitioning key indicated FOREIGN KEY clause is not valid
cannot be defined in an ALTER TABLE statement because no column of the key allows null values.
because the indicated table already has a key of “<name>” is the constraint name, if specified, in
this type. the FOREIGN KEY clause. If a constraint name
The statement cannot be executed. was not specified, “<name>” is the first column
name specified in the column list of the
User Response: A table cannot have more than FOREIGN KEY clause followed by three periods.
one primary key or partitioning key.
The statement cannot be processed.
sqlcode: -624
User Response: Change either a column of the
sqlstate: 42889 key to allow null values or change the delete
rule.
SQL0628N Multiple or conflicting keywords sqlcode: -629
involving the “<clause-type>”
clause are present. sqlstate: 42834

Explanation: There are several possible reasons

why this condition might have been diagnosed SQL0631N FOREIGN KEY “<name>” is too
for the statement. Exactly which one happened is long or has too many columns.
indicated by the value of “<clause-type>”. The Explanation: The sum of the column internal
possibilities to consider are: lengths identified in the FOREIGN KEY clause in
v The keyword may not be specified in the same a CREATE TABLE statement exceeds 1024, or the
statement as some other keyword. number of columns identified exceeds 16. Also, a
v The keyword may be part of a sequence of foreign key cannot be defined using a LONG
keywords where the order in which they are VARCHAR column.
specified is not enforced. A keyword in such a “<name>” is the constraint name, if specified, in
sequence may have been specified with the the FOREIGN KEY clause. If a constraint name
contradicting keyword also specified. was not specified, “<name>” is the first column
name specified in the column list of the

116 Message Reference, Volume 2

FOREIGN KEY clause followed by three periods. CREATE TABLE or ALTER TABLE statement.
The statement cannot be processed. sqlcode: -632
User Response: To modify the foreign key sqlstate: 42915
definition, eliminate one or more key columns
and conform to the 16 column limit and the key
SQL0633N The delete rule of FOREIGN KEY
length limit.
“<name>” must be
sqlcode: -631 “<delete-rule>” (reason code =
“<reason-code>”).
sqlstate: 54008
Explanation: The delete rule specified in a
FOREIGN KEY clause of the CREATE TABLE or
SQL0632N FOREIGN KEY “<name>” is not
ALTER TABLE statement is not valid. The
valid because the table cannot be
indicated delete rule is required for one of the
defined as a dependent of table
following reason codes:
“<table-name>” because of delete
rule restrictions (reason code = v (01) The referential constraint is
“<reason-code>”). self-referencing and an existing self-referencing
constraint has the indicated delete rule (NO
Explanation: A referential constraint cannot be ACTION, RESTRICT or CASCADE).
defined because the object table of the CREATE
v (02) The referential constraint is
TABLE or ALTER TABLE statement cannot be
self-referencing and the table is dependent in a
defined as a dependent of table “<table-name>”
relationship with a delete rule of CASCADE.
for one of the following reason codes:
v (03) The relationship would cause the table to
v (01) The relationship is self-referencing and a
be delete-connected to the same table through
self-referencing relationship already exists with
multiple relationships and such relationships
the SET NULL delete rule.
must have the same delete rule (NO ACTION,
v (02) The relationship forms a cycle of two or RESTRICT or CASCADE).
more tables that cause the table to be
delete-connected to itself (all other delete rules “<name>” is the constraint name, if specified, in
in the cycle would be CASCADE). the FOREIGN KEY clause. If a constraint name
was not specified, “<name>” is the first column
v (03) The relationship causes the table to be
name specified in the column list of the
delete-connected to the indicated table through
FOREIGN KEY clause followed by three periods.
multiple relationships and the delete rule of
the existing relationship is SET NULL.
The statement cannot be processed.
The delete rules of the existing relationships
User Response: If possible, change the delete
cause an error, not the delete rule specified in the
rule.
FOREIGN KEY clause of the CREATE TABLE or
ALTER TABLE statement. sqlcode: -633
sqlstate: 42915
“<name>” is the constraint name, if specified, in
the FOREIGN KEY clause. If a constraint name
was not specified, “<name>” is the first column SQL0634N The delete rule of FOREIGN KEY
name specified in the column list of the “<name>” must not be CASCADE
FOREIGN KEY clause followed by three periods. (reason-code = “<reason-code>”).
Explanation: The CASCADE delete rule
The statement cannot be processed.
specified in the FOREIGN KEY clause of the
User Response: If possible, eliminate the CREATE TABLE or ALTER TABLE statement is
particular FOREIGN KEY clause from the not valid for one of the following reason codes:

Chapter 2. SQL Messages 117

v (01) A self-referencing constraint exists with a
SQL0638N Table “<name>” cannot be created
delete rule of SET NULL, NO ACTION or
because no column definitions
RESTRICT.
were specified.
v (02) The relationship would form a cycle that
would cause a table to be delete-connected to Explanation: The CREATE TABLE statement
itself. One of the existing delete rules in the does not contain any column definitions.
cycle is not CASCADE, so this relationship The statement cannot be processed.
may be definable if the delete rule is not
CASCADE. User Response: Add one or more column
definitions to the statement.
v (03) The relationship would cause another
table to be delete-connected to the same table sqlcode: -638
through multiple paths with different delete
rules or with delete rule equal to SET NULL. sqlstate: 42601
“<name>” is the constraint name, if specified,
in the FOREIGN KEY clause. If a constraint SQL0644N Invalid value specified for
name was not specified, “<name>” is the first keyword ″<keyword>″ in
column name specified in the column list of statement ″<statement-type>″.
the FOREIGN KEY clause followed by three
Explanation: The keyword ″<keyword>″ is
periods.
followed by an invalid value as allowed by the
The statement cannot be processed. description of ″<statement-type>″. For numeric
values, the value may be outside a defined
User Response: If possible, change the delete range. For other types, the value is not in the
rule. defined set of valid values.
sqlcode: -634 User Response: Determine from reference
sqlstate: 42915 documentation for the ″<statement-type>″ what
are valid values and make the appropriate
change.
SQL0637N More than one PRIMARY KEY
clause or more than one DROP sqlcode: -644
PRIMARY KEY clause was sqlstate: 42615
specified.
Explanation: The CREATE TABLE statement SQL0647N Bufferpool “<bufferpool-name>”
contains two or more PRIMARY KEY clauses, or is currently not active.
the ALTER TABLE statement contains two or
more PRIMARY KEY or DROP PRIMARY KEY Explanation: The bufferpool
clauses. “<bufferpool-name>” is not active in the current
database environment. An attempt was made to
The statement cannot be processed. find another bufferpool with the same page size
User Response: Correct the statement. but there are no such bufferpools active in the
current database environment. The bufferpool
sqlcode: -637 “<bufferpool-name>” was recently defined but
sqlstate: 42614 has not yet been activated.
The statement cannot be processed.
User Response: The database must be stopped
and started again to activate the required
bufferpool.
sqlcode: -647

118 Message Reference, Volume 2

sqlstate: 57003 v a package that cannot be dropped using the
DROP statement because it was created by the
system for use with a SQL procedure
SQL0648N The foreign key cannot be
defined because it will cause table The statement cannot be processed.
“<owner1.table-name1>” to be
User Response:
delete-connected to table
“<owner2.table-name2>” through v The function “<name>” can only be dropped
multiple paths. Reason Code = by dropping the distinct type or structured
“<reason-code>”. type that caused the function or method to be
defined. The distinct type name corresponds to
Explanation: The foreign key cannot be defined either the name of the function or the type of
because one of the following reason codes = the parameters to the function.
“<reason-code>”:
v The method “<name>” can only be dropped
01 The relationship will cause table by dropping the structured type that caused
“<owner1.table-name1>” to be the method to be defined. The method name
delete-connected to table corresponds to the name of an attribute for the
“<owner2.table-name2>” through structured type.
multiple paths with the same delete rule v The package “<name>” can only be dropped
of SET NULL. by dropping the SQL procedure that caused
02 The relationship will cause table the package to be defined. The specific name
“<owner1.table-name1>” to be of the SQL procedure can be found by
delete-connected to table retrieving the DSCHEMA and DNAME from
“<owner2.table-name2>” through the SYSIBM.SYSDEPENDENCIES catalog table
multiple paths with different delete where the BSCHEMA and BNAME match
rules. “<name>”, BTYPE is ’K’ and DTYPE is ’L’.
sqlcode: -658
Processing of the SQL statement has ended.
User Response: Correct the statement. Try sqlstate: 42917
again.
sqlcode: -648 SQL0659N Maximum size of a table object
has been exceeded.
sqlstate: 42915
Explanation: One or more of the objects which
make up a table has reached its maximum size.
SQL0658N The object “<name>” cannot be The storage objects that make up a table are:
explicitly dropped.
v Data: This is where basic column data is stored
Explanation: The identifier “<name>” identifies v Index: This is where all indexes on the table
one of the following: are stored
v a cast function or comparison function that v Long Data: This is where LONG VARCHAR
cannot be dropped using the DROP statement and LONG VARGRAPHIC column data is
because it was created by the system for use stored
with a distinct type
v Lob/Lob Allocation: This is where BLOB,
v a method that cannot be dropped using the CLOB, and DBCLOB column data and control
ALTER TYPE method because it was created information are stored
by the system for use with a structured type
Once a storage object has grown to its maximum
size, it cannot be extended further.

Chapter 2. SQL Messages 119

User Response: To make existing space within operation on a parent table that is not in a check
the object available to store new data, the pending state may also receive this error if a
following actions may be taken: dependent table is in a check pending state.
v Reorganize the table User Response: Execute the SET INTEGRITY
v Delete unnecessary rows from the table statement with the IMMEDIATE CHECKED
v Drop an index from the table option and ensure that the data satisfies all the
constraints defined on the table or the table
v Update rows to reduce the amount of data (a
depending on it.
reorg may be required after this action in
order to reclaim unused storage) sqlcode: -668
sqlcode: -659 sqlstate: 57016

sqlstate: 54032
SQL0669N A system required index cannot
be dropped explicitly.
SQL0667N The FOREIGN KEY “<name>”
Explanation: The DROP INDEX statement
cannot be created because the
attempted to drop an index required to:
table contains rows with foreign
key values that cannot be found v enforce the primary key constraint on a table
in the parent key of the parent v enforce a unique constraint on a table
table. v enforce the uniqueness of the object identifier
Explanation: The definition of the indicated (OID) column of a typed table hierarchy
foreign key failed because the table being altered v maintain a replicated summary table.
contains at least one row where the foreign key
A system required index cannot be dropped
does not match the parent key value in the
using the DROP INDEX statement.
parent table.
“<name>” is the constraint name, if specified. If The statement cannot be processed. The specified
a constraint name was not specified, “<name>” index is not dropped.
is the first column name specified in the column
list of the FOREIGN KEY clause followed by User Response: If you do not want to keep the
three periods. primary or unique constraint, use the DROP
PRIMARY KEY clause or the DROP
The statement cannot be processed. The specified CONSTRAINT clause of the ALTER TABLE
table is not altered. statement to remove the primary key or unique
constraint. If the index was created only for
User Response: Remove the erroneous table
enforcing the primary or unique key, then the
rows and define the foreign key.
index will be dropped. If not, the DROP INDEX
sqlcode: -667 statement could then be processed.
sqlstate: 23520 The index for an OID column can only be
dropped by dropping the table.
SQL0668N Operation not allowed when the The index required to maintain a replicated
underlying table (or a dependent summary table can only be dropped by first
table) is in the Check Pending dropping the replicated summary table.
state.
sqlcode: -669
Explanation: When a table is in a check
sqlstate: 42917
pending state, there may be one or more rows
that violate constraints defined on the data. This
table cannot be used for the operation. An

120 Message Reference, Volume 2

SQL0670N The row length of the table SQL0673N A primary or unique key index
exceeded a limit of ″<length>″ cannot be created because the
bytes. (Regular table space table contains rows which are
″<tablespace-name>″.) duplicates with respect to the
values of the identified primary
Explanation: The row length of a table in the
or unique key columns of
database manager cannot exceed:
constraint “<name>”.
v 4005 bytes in a table space with a 4K page size
Explanation: The primary or unique key
v 8101 bytes in a table space with an 8K page
definition of the constraint identified by
size.
“<name>” failed because the table being altered
v 16293 bytes in a table space with an 16K page already contains rows with duplicate values for
size. the PRIMARY KEY or UNIQUE clause columns.
v 32677 bytes in a table space with an 32K page
“<name>” is the constraint name, if specified. If
size.
a constraint name was not specified, “<name>”
The length is calculated by adding the internal is the first column name specified in the primary
lengths of the columns. Details of internal key or unique constraint clause followed by three
column lengths can be found under CREATE periods.
TABLE in the SQL Reference.
The statement cannot be processed. The specified
table is not altered.
One of the following conditions can occur:
v The row length for the table defined in the User Response: Remove the erroneous rows
CREATE TABLE or ALTER TABLE statement from the table before attempting to define the
exceeds the limit for the page size of the table primary or unique key.
space. The regular table space name sqlcode: -673
″<tablespace-name>″ identifies the table space
from which the page size was used to sqlstate: 23515
determine the limit on the row length.
The statement cannot be processed. SQL0680N Too many columns are specified
for a table, view, or table function.
User Response: Depending on the cause, do
one of the following. Explanation: The maximum number of columns
permitted for each table is based on the page size
v In the case of CREATE TABLE or ALTER
of the table space and the data types of the
TABLE:
columns. The limits for tables are:
– specify a table space with a larger pagesize,
v 4K page size allows a maximum of 500
if possible
columns
– otherwise, reduce the row length by
v 8K, 16K, and 32K page sizes allow a maximum
eliminating one or more columns or
of 1012 columns.
reducing the lengths of one or more
columns. The actual number of columns for a table is
determined by the following formula: Total
sqlcode: -670
Columns * 8 + Number of LOB Columns * 12 +
Number of Datalink Columns * 28 <= row size
sqlstate: 54010 limits for page size.

The maximum number of columns permitted for

each view is 5000.

Chapter 2. SQL Messages 121

The maximum number of columns permitted for v for a CREATE or ALTER TYPE statement,
a table function is 255. “<data-item>” identifies the clause containing
the error or gives the name of the attribute
Federated system users: other data sources may containing the error.
have a different maximum column limit. This
The statement cannot be processed.
limit has been exceeded.
User Response: Remove the incompatibility and
The statement cannot be processed. try the statement again.

User Response: Ensure that the number of table sqlcode: -683

or view columns does not exceed the limit. If
sqlstate: 42842
creating a table where a larger page size would
allow the number of columns, specify a table
space with the larger page size. Create separate SQL0696N The definition of trigger
tables or views, as required, to hold additional “<trigger-name>” includes an
information beyond the limit. invalid use of correlation name or
transition table name “<name>”.
Federated system users: limit the number of table
Reason code=“<reason-code>”.
columns to the maximum supported by the data
source. Create separate tables or views, as Explanation: The trigger definition included an
required, to hold additional information beyond invalid use of “<name>”. The value of
the maximum number of columns supported by “<reason-code>” indicates the specific problem
the data source. as follows.
sqlcode: -680 1 NEW correlation name and
NEW_TABLE name are not allowed in a
sqlstate: 54011
DELETE trigger.
2 OLD correlation name and OLD_TABLE
SQL0683N The specification for column,
name are not allowed in an INSERT
attribute, user-defined type or
trigger.
function “<data-item>” contains
incompatible clauses. 3 OLD_TABLE name and NEW_TABLE
name are not allowed in a BEFORE
Explanation: There is an error in a data item
trigger.
specification in a CREATE or ALTER.
Incompatible specifications are present, such as:
The statement cannot be processed.
″INTEGER and FOR BIT DATA″. The location of
the error is given by “<data-item>” as follows: User Response: Remove the invalid correlation
v for a CREATE or ALTER TABLE statement, name or transition table name along with the
“<data-item>” gives the name of the column preceding keyword.
containing the error. sqlcode: -696
v for a CREATE FUNCTION statement,
“<data-item>” is a token that identifies the sqlstate: 42898
area of the problem in the statement. For
example, ″PARAMETER 3″ or ″RETURNS″ or SQL0697N OLD or NEW correlation names
″CAST FROM″. are not allowed in a trigger
v for a CREATE DISTINCT TYPE statement, defined with the FOR EACH
“<data-item>” gives the name of the type STATEMENT clause.
being defined.
Explanation: The trigger, as defined, includes a
REFERENCING clause with OLD or NEW

122 Message Reference, Volume 2

correlation names specified (or both) and the correlation names from the REFERENCING
FOR EACH STATEMENT clause. These cannot clause or replace FOR EACH STATEMENT with
be specified together. FOR EACH ROW.
The statement cannot be processed. sqlcode: -697
User Response: Remove any OLD or NEW sqlstate: 42899

SQL0700 - SQL0799

SQL0707N The object ″<name>″ cannot be SQL0723N An error occurred in a triggered

created because the first three SQL statement in trigger
characters are reserved for system “<trigger-name>”. Information
objects. returned for the error includes
SQLCODE “<sqlcode>”,
Explanation: The following is a list of reserved
SQLSTATE “<sqlstate>” and
names:
message tokens “<token-list>”
v a table space name cannot start with ’SYS’
Explanation: An SQL statement in the trigger
v a nodegroup name cannot start with ’SYS’ or
“<trigger-name>” has failed during execution of
’IBM’
the trigger. The sqlcode, sqlstate and message
User Response: Select a name that does not token list (each token is separated by the vertical
start with a reserved prefix. bar character) are provided. The message tokens
may be truncated. See the corresponding
sqlcode: -707 message for the “<sqlcode>” for further
sqlstate: 42939 explanation of the error.
The trigger and the original SQL statement that
SQL0713N The replacement value for caused the trigger to execute cannot be
″<special-register>″ is invalid. processed.

Explanation: Either the value specified in the User Response: Check the message associated
SET <special-register> statement is not a valid with the SQLCODE of the SQL statement that
value of the indicated special register, or the failed. Follow the action suggested by that
value specified is NULL as a result of an message.
indicator variable. sqlcode: -723
The statement cannot be executed. sqlstate: 09000
User Response: Correct the replacement value
and/or any indicator variables. See the SQL SQL0724N The activation of trigger
Reference for an explanation of the valid values of “<trigger-name>” would exceed
each special register. the maximum level of cascading.
sqlcode: -713 Explanation: Cascading of triggers occurs when
sqlstate: 42815 a triggered SQL statement in a trigger would
result in another trigger being activated or when
a referential constraint delete rule causes
additional triggers to be activated. The depth of
this cascading is limited to 16.
Note that recursive situations where a trigger
includes a triggered SQL statement that directly
or indirectly causes the same trigger to be

Chapter 2. SQL Messages 123

activated is a form of cascading that is very be truncated. See the corresponding message for
likely to cause this error if there are no the “<sqlcode>” for further explanation of the
conditions to prevent cascading from exceeding error.
the limit.
The original SQL statement or command that
The “<trigger-name>” specified is one of the
caused the “<action-type>” cannot be processed
triggers that would have been activated at the
and the implicit system action was not
seventeenth level of cascading.
successful.
User Response: Start with the triggers that are
activated by the UPDATE, INSERT or DELETE Federated system users: You may have received
statement that received this error. If any of these this message because you dynamically prepared
triggers are recursive, ensure that there is some an SQL statement in a pass-through session and
condition that prevents the trigger from being then tried to execute the statement after the
activated more than the limit allows. If this is not session was closed.
the cause of the problem, follow the chain of
triggers that are activated to determine the chain User Response: Check the message associated
that exceeds the cascading limit. with the SQLCODE of the SQL statement that
failed. Follow the action suggested by that
sqlcode: -724 message.
sqlstate: 54038 For an invalid package, the REBIND command
can be used to recreate the error or to explicitly
validate the package once the cause of the error
SQL0727N An error occurred during implicit
has been resolved.
system action type
“<action-type>”. Information For a failure while regenerating a view, the name
returned for the error includes of the view that failed is recorded in the
SQLCODE “<sqlcode>”, db2diag.log file. The failing view can be dropped
SQLSTATE “<sqlstate>” and or a change made to the statement or command
message tokens “<token-list>”. that caused the view regeneration.
Explanation: The processing of a statement or Federated system users: If the statement that
command has caused the database manager to failed was dynamically prepared in a
implicitly perform additional processing. During pass-through session, open another pass-through
this processing an error was encountered. The session, write and prepare the statement again,
action attempted is shown by the and execute it while the session is still open.
“<action-type>”:
sqlcode: -727
1 implicit rebind of a package
sqlstate: 56098
2 implicit prepare of a cached dynamic
SQL statement
SQL0750N The source table cannot be
3 implicit regeneration of a view renamed because it is referenced
in a view, summary table, trigger,
4 This return code is reserved for use by
SQL function, SQL method, check
DB2.
constraint, or referential
5 incremental bind of an SQL statement constraint.
Explanation: The source table in a RENAME
The sqlcode, sqlstate and message token list
statement cannot be renamed for one or more of
(each token is separated by the vertical bar
the following reasons.
character) are provided. The message tokens may

124 Message Reference, Volume 2

v The table is referenced in one or more existing User Response: Remove the statement then
views. recompile the program.
v The table is referenced in one or more existing sqlcode: -751
summary tables.
sqlstate: 38003
v The table is referenced in one or more existing
triggers. This includes triggers on the table or sqlstate: 42985
references in triggered SQL statements.
v The table is referenced in one or more existing SQL0752N Connecting to a database is not
SQL functions or SQL methods. permitted within a logical unit of
v The table has check constraints defined. work when the CONNECT type 1
v The table is involved in one or more referential connection setting is in use.
constraints as a parent or dependent table. Explanation: An attempt was made to connect
The statement cannot be processed. to either another database or the same database
before issuing a COMMIT or ROLLBACK
User Response: Drop the views, summary table, statement. The request cannot be processed
triggers, SQL functions, SQL methods, check within a CONNECT type 1 environment.
constraints, or referential constraints on the table
before issuing the RENAME statement. For views User Response:
or summary tables dependent on the table, query v Submit a COMMIT or ROLLBACK statement
SYSCAT.VIEWDEP where the table matches before requesting a connection to another
BSCHEMA and BNAME columns. For triggers database.
dependent on the table, query SYSCAT.TRIGDEP v If multiple databases need to be updated
where the table matches BSCHEMA and BNAME within a unit of work, change the connection
columns. For SQL functions or SQL methods, settings to SYNCPOINT TWOPHASE and
query SYSCAT.FUNCDEP where the table CONNECT 2 by re-precompiling or by issuing
matches BSCHEMA and BNAME columns. For the SET CLIENT API from within the
check constraints on the table, query application.
SYSCAT.CHECKS where the table matches
TABSCHEMA and TABBNAME columns. For sqlcode: -752
referential constraints dependent on the table,
query SYSCAT.REFERENCES where the table sqlstate: 0A001
matches TABSCHEMA and TABNAME columns
or REFTABSCHEMA and REFTABNAME
SQL0773N Case not found for CASE
columns.
statement.
sqlcode: -750
Explanation: A CASE statement without an
sqlstate: 42986 ELSE clause was found in the routine body of an
SQL procedure. None of the conditions speicified
in the CASE statement were met.
SQL0751N User defined function or
procedure “<function-name>” User Response: Change the CASE statement to
(specific name “<specific-name>”) handle all conditions that can occur.
attempted to execute a statement
sqlcode: -773
that is not allowed.
sqlstate: 20000
Explanation: The program used to implement
the body of a user defined function or procedure
is not allowed to execute the statement.

Chapter 2. SQL Messages 125

SQL0776N Use of cursor “<cursor-name>” is SQL0779N Label “<label>” specified on a
not valid. GOTO, ITERATE, or LEAVE
statement is not valid.
Explanation: Cursor “<cursor-name>” is
specified as the cursor name on a FOR statement Explanation: Label “<label>” is specified on a
in an SQL procedure. The cursor cannot be GOTO, ITERATE, or LEAVE statement in an SQL
specified on a CLOSE, FETCH, or OPEN procedure. The label is not defined or is not a
statement within the FOR statement. valid label for the statement.
User Response: Remove the CLOSE, FETCH, or The label on an ITERATE statement must be the
OPEN statement. label for a FOR, LOOP, REPEAT, or WHILE
statement.
sqlcode: -776
The label on a LEAVE statement must be the
sqlstate: 428D4
label for a FOR, LOOP, REPEAT, WHILE, or
compound statement.
SQL0777N Nested compound statements are
The label on a GOTO must be defined within a
not allowed.
scope that the GOTO statement can reach.
Explanation: Atomic compound statements in v If the GOTO statement is defined in a FOR
the routine body of an SQL procedure cannot be statement, “<label>” must be defined inside
nested. the same FOR statement, excluding a nested
User Response: Ensure that the SQL procedure FOR statement or nested compound statement.
does not contain nested atomic compound v If the GOTO statement is defined in a
statements. compound statement, “<label>” must be
defined inside the same compound statement,
sqlcode: -777 excluding a nested FOR statement or nested
sqlstate: 42919 compound statement.
v If the GOTO statement is defined in a handler,
“<label>” must be defined in the same
SQL0778N End label “<label>” is not the
handler, following the other scope rules.
same as the begin label.
v If the GOTO statement is defined outside of a
Explanation: Label “<label>” specified at the handler, “<label>” must not be defined within
end of a FOR, IF, LOOP, REPEAT, WHILE, or a handler.
compound statement in an SQL procedure is not
the same as the label at the beginning of the User Response: Specify a valid label on the
statement. You cannot specify an end label if a GOTO, ITERATE, or LEAVE statement.
begin label is not specified. sqlcode: -779
User Response: Ensure that the end label is the sqlstate: 42736
same as the begin label for FOR, IF, LOOP,
REPEAT, WHILE, and compound statements.
SQL0780N UNDO is specified for a handler
sqlcode: -778 when ATOMIC is not specified
sqlstate: 428D5 for the compound statement.
Explanation: UNDO is specified for a handler
in a compound statement in an SQL procedure.
UNDO cannot be specified unless the compound
statement is ATOMIC.
User Response: Either specify that the

126 Message Reference, Volume 2

compound statement is ATOMIC or specify EXIT in the select list specified in the FOR statement.
or CONTINUE on the handler.
sqlcode: -783
sqlcode: -780
sqlstate: 42738
sqlstate: 428D6
SQL0785N The declaration or use of the
SQL0781N Condition “<condition>” specified SQLSTATE or SQLCODE variable
in a handler is not defined. is not valid.
Explanation: Condition “<condition>” specified Explanation: SQLSTATE or SQLCODE was used
in a handler in an SQL procedure is not defined. as a variable in the routine body of an SQL
routine, but is not valid for one of the following
User Response: Define the condition using the
reasons:
DECLARE CONDITION statement or remove the
condition from the handler. v SQLSTATE is not declared as CHAR(5)
v SQLCODE is not declared as INTEGER
sqlcode: -781
v The variable is assigned the NULL value.
sqlstate: 42737
The statement cannot be processed.

SQL0782N A condition or SQLSTATE value User Response: Declare the SQLSTATE variable
specified in a handler is not valid. as CHAR(5) and the SQLCODE variable as
INTEGER. Set the variable to a valid value.
Explanation: A condition or SQLSTATE value
specified in a handler in an SQL is not valid for sqlcode: -785
one of the following reasons: sqlstate: 428D8
v The condition or SQLSTATE value has already
been specified by another handler in the same
SQL0787N RESIGNAL statement not within
scope.
a handler.
v The condition or SQLSTATE value was
specified in the same handler as Explanation: The RESIGNAL statement can
SQLEXCEPTION, SQLWARNING, or NOT only be used inside condition handlers.
FOUND. User Response: Remove the RESIGNAL
User Response: Remove the condition or statement or use a SIGNAL statement instead.
SQLSTATE value from the handler. sqlcode: -787
sqlcode: -782 sqlstate: 0K000
sqlstate: 428D7
SQL0789N The data type for parameter or
SQL0783N A duplicate column name or variable “<name>” is not
unnamed column was specified in supported in the SQL routine.
a DECLARE CURSOR statement Explanation: The SQL routine (function,
of a FOR statement. method, or procedure) does not support
Explanation: The select list in the FOR variables or parameters of DATALINK,
statement must contain unique column names. REFERENCE, DISTINCT, STRUCTURED, or LOB
The select list specified contains either duplicate data types.
column names or unnamed expressions. User Response: Do not use SQL variables or
User Response: Specify unique column names parameters of DATALINK, REFERENCE,
DISTINCT, STRUCTURED, or LOB data types in

Chapter 2. SQL Messages 127

the SQL routine definition. Specify a different User Response: Check the triggered SQL
data type for the parameter or variable statements in the trigger for any statement that
“<name>”. does not match the above list and remove it.
sqlcode: -789 sqlcode: -797
sqlstate: 429BB sqlstate: 42987

SQL0797N The trigger “<trigger-name>” is SQL0798N A value cannot be specified for

defined with an unsupported column “<column-name>” which
triggered SQL statement. is defined as GENERATED
ALWAYS.
Explanation: The trigger is defined with a
triggered SQL statement that does match the Explanation: When inserting or updating a row
following list. in a table, a value was specified for the
v A BEFORE trigger can include the following GENERATED ALWAYS column
triggered SQL statements: “<column-name>”. GENERATED ALWAYS
columns should not be specified in the
– a fullselect
column-list for an INSERT or in the SET clause
– a SET transition-variable statement (only for an update unless the keyword DEFAULT is
when FOR EACH ROW is specified). specified.
v An AFTER trigger can include the following
The INSERT or UPDATE is not performed.
triggered SQL statements:
– an INSERT statement User Response: Remove the GENERATED
ALWAYS column from the column-list or SET
– a searched UPDATE statement
clause, or specify DEFAULT as the column value.
– a searched DELETE statement
sqlcode: -798
– a fullselect
sqlstate: 428C9
In some cases the “<trigger-name>” is not
available for use in the message.

SQL0800 - SQL0899
If the problem is data dependent, examine the
SQL0801N Division by zero was attempted.
data being processed at the data sources when
Explanation: The processing of a column the error occurred.
function or arithmetic expression resulted in
sqlcode: -801
division by zero.
sqlstate: 22012
The statement cannot be processed. For the
INSERT, UPDATE, or DELETE statements, no
inserts or updates are performed. SQL0802N Arithmetic overflow or other
arithmetic exception occurred.
User Response: Examine the SQL statement to
determine the cause of the problem. If the Explanation: The processing of a column
problem is data dependent, it is necessary to function or arithmetic expression has resulted in
examine the data processed when the error an arithmetic overflow.
occurred. Refer to the SQL Reference to see the
valid ranges for the data types. The statement cannot be processed. For the
INSERT, UPDATE, or DELETE statements, no
Federated system users: examine the SQL inserts or updates are performed.
statement to determine the cause of the problem.

128 Message Reference, Volume 2

User Response: Examine the SQL statement to Alternatively, if a view is the object of the
determine the cause of the problem. If the INSERT or UPDATE statement, it is the table on
problem is data dependent, it is necessary to which the view is defined that is constrained.
examine the data processed when the error
The statement cannot be processed. The table
occurred. Refer to the SQL Reference to see the
remains unchanged.
valid ranges for the data types.
User Response: Examine the definitions for all
This error may also be returned when column
UNIQUE indexes defined on the object table to
functions cannot handle the value that is
determine the uniqueness constraints those
returned by the SQL statement. For example,
indexes impose.
issuing a SELECT COUNT statement against a
table that has more rows than defined by the For an UPDATE statement, ensure that the
MAX_LONGINT_INT SQL limit will cause an specified operation is not itself inconsistent with
arithmetic overflow error. Consider using the those uniqueness constraints. If this does not
COUNT_BIG column function for tables with show the error, examine the object table content
more than 2 147 483 647 rows. to determine the cause of the problem.
Federated system users: examine the SQL For an INSERT statement, examine the object
statement to determine the cause of the problem. table content to determine which of the values in
If the problem is data dependent, examine the the specified value list violates the uniqueness
data being processed at the data sources when constraint. Alternatively, if the INSERT statement
the error occurred. Refer to the corresponding contains a subquery, the object table contents
SQL Reference for the data source to determine addressed by that subquery must be matched
the valid ranges for the data types. against the object table contents to determine the
cause of the problem.
sqlcode: -802
For a DELETE statement, examine the dependent
sqlstate: 22003
tables for unique constraints on foreign keys that
are defined with the rule ON DELETE SET
SQL0803N One or more values in the NULL. One such table has a foreign key column
INSERT statement, UPDATE included in a unique index that cannot be set to
statement, or foreign key update null since there is already a null in the column
caused by a DELETE statement for that table.
are not valid because they would
Federated system users: isolate the problem to
produce duplicate rows for a table
the data source failing the request (refer to the
with a primary key, unique
Troubleshooting Guide to determine which data
constraint, or unique index.
source is failing to process the SQL statement)
Explanation: The INSERT or UPDATE object and examine the index definitions and data for
table is constrained by one or more UNIQUE the conditions listed previously.
indexes to have unique values in certain columns
sqlcode: -803
or groups of columns. Alternatively, a DELETE
statement on a parent table caused the update of sqlstate: 23505
a foreign key in a dependent table that is
constrained by one or more UNIQUE indexes to
have unique values in certain columns or groups
of columns. The unique index may exist to
support a primary key or unique constraint
defined on the table. Completing the requested
insert or update results in duplicates of the
column values.

Chapter 2. SQL Messages 129

 SQLVAR2.SQLDATALEN pointer, which
SQL0804N The application program input
is always in terms of bytes, even for
parameters for the current request
DBCLOBs.
are not valid. Reason code
″<reason-code>″. If a host variable 106 The SQLDATA pointer is invalid or
or SQLVAR in the SQLDA is points to insufficient storage.
invalid then: host
variable/SQLVAR number = 107 The SQLIND pointer is invalid or points
″<var-number>″, SQLTYPE = to insufficient storage.
″<sqltype>″, SQLLEN = 108 The SQLDATALEN pointer is invalid or
″<sqllen>″, host variable/SQLVAR points to insufficient storage.
type = ″<input_or_output>″.
109 A specific number of input host
Explanation: An error occurred while variables/SQLVARS is expected for the
processing the current request. current SQL statement.
v The call parameter list, which is created by the
110 The LOB locator is not associated with a
precompiler, may not be correct if the
LOB of a compatible type.
application programmer has modified the
output of the precompiler or over-written the 111 A LOB is indicated by the SQLTYPE of
call parameter list in another way. the SQLVAR, but the second SQLVAR is
v The SQLDA or host variable(s) in the SQL null.
statement are invalid. 112 The SQLDATATYPE NAME field is not
v The request being made is not supported or is valid. It does not conform to the format
out of context. for identifying an existing user-defined
type in the database. The format for
Reason codes are interpreted as follows:
identifying an existing user-defined type
100 The request being made is not is as follows: 8 bytes, followed by a
supported or is out of context. period, followed by 18 bytes.

101 SQLDA.SQLN is less than 113 The SQLFLAG4 field is not valid. If a
SQLDA.SQLD structured type is specified the value
must be X’12’. If a reference type is
102 SQLVAR.SQLTYPE is invalid. specified the value must be X’01’.
Federated system users: A data type that Otherwise the value must be X’00’.
you specified is not supported by either
the federated server or the data source In SQL statements with host variables, use the
that you want to access. host variable number to count in from the
beginning of the statement (or substatement, in
103 The length specified in the case of compound SQL) to locate the invalid
SQLVAR.SQLLEN or host variable. For statements using an SQLDA,
SQLVAR2.SQLLONGLEN is incorrect the SQLVAR number is used to locate the invalid
for the SQL type given in SQLVAR. For an input SQLDA, count only input
SQLVAR.SQLTYPE. host variables or SQLVARs; similarly for output.
104 Doubling of the SQLVARs is expected, Note that this number is based at 1.
but the SQLDOUBLED field of
SQLDA.SQLDAID is not set to ’2’. This The statement cannot be processed.
may be required because of a large
User Response: Examine the application
object type or a structured type.
program for any errors noted. Note that the
105 A double-byte character Large Object programmer should not attempt to modify the
has an odd value indicated by the precompiler output.

130 Message Reference, Volume 2

Federated system users: If you received reason
SQL0808N The CONNECT statement
code 102, specify a supported data type and
semantics are not consistent with
resubmit the program.
those of other existing
sqlcode: -804 connections.

sqlstate: 07002 Explanation: The CONNECT statement

originates from a source file which was
precompiled having different connection options
SQL0805N Package “<package-name>” was (SQLRULES, CONNECT type, SYNCPOINT, or
not found. RELEASE type) than that of a source file for
Explanation: Possible causes for this message which a connection exists.
(SQLCODE) are: User Response: Ensure that all source files are
v The specified package or program is not precompiled using the same CONNECT options,
defined in the database. or if this is not possible, call the SET CLIENT api
v The program was not bound or it was to set the desired options for the application
dropped. process before issuing the first CONNECT
statement.
v The application being run is not bound to the
database. sqlcode: -808
v If attempting to run a DB2 utility or CLI sqlstate: 08001
application, the DB2 utilities may need to be
rebound to the database.
SQL0811N The result of a scalar fullselect,
The statement cannot be processed. SELECT INTO statement, or
User Response: Specify the correct package VALUES INTO statement is more
name or bind the program. If the application than one row.
being run is not bound to the database, contact Explanation: One of the following caused the
the database administrator to do the necessary error:
binding.
v Execution of an embedded SELECT INTO or
If the DB2 utility programs need to be rebound VALUES INTO statement resulted in a result
to the database, the database administrator can table of more than one row.
accomplish this by issuing one of the following v Execution of a scalar fullselect resulted in a
CLP command from the bnd subdirectory of the result table of more than one row.
instance, while connected to the database:
v ″DB2 bind @db2ubind.lst blocking all grant Federated system users: this situation can be
public″ for the DB2 utilities. detected by federated server or by the data
source.
v ″DB2 bind @db2cli.lst blocking all grant
public″ for CLI.
The statement cannot be processed.
Federated system users: ensure that the packages
User Response: Ensure that the statement
required for the federated server are bound at
contains the proper condition specifications. If it
the applicable data sources. Refer to the
does, there may be a data problem that is
Installation and Configuration Supplement Guide
causing more than one row to be returned when
for more information about binding packages to
only one is expected.
data sources.
Federated system users: isolate the problem to
sqlcode: -805 the data source failing the request (refer to the
Troubleshooting Guide to determine which data
sqlstate: 51002 source is failing to process the SQL statement)

Chapter 2. SQL Messages 131

and examine the selection criteria and data for
SQL0818N A timestamp conflict occurred.
that object.
Explanation: The timestamp generated by the
sqlcode: -811
precompiler at precompile time is not the same
sqlstate: 21000 as the timestamp stored with the package at bind
time.

SQL0817N The SQL statement cannot be This problem can be caused by the following:
executed because the statement v Precompile, compile, and link without doing
will result in a prohibited update an application bind.
operation.
v Precompile and bind without doing the
Explanation: The application attempted to program compile and link.
execute an SQL statement that would result in v Bind the application using a bind file that
updates to user data or to the subsystem catalog. resulted from a different precompile of the
This is prohibited for one of the following program than the precompile that produced
reasons: the object module linked into the application
v The application is running as an IMS module.
inquiry-only transaction. v Bind an application with the same name as an
v The application is an IMS or CICS application existing plan and execute the existing (old)
that is attempting to update data at a remote application.
DBMS that does not support two-phase
Federated system users: in addition to the causes
commit.
listed previously, the problem can also be due to
v The application is attempting to update data at not binding the required packages at all
multiple locations and one of the locations applicable data sources.
does not support two-phase commit.
These SQL statements include INSERT, UPDATE, The statement cannot be processed.
DELETE, CREATE, ALTER, DROP, GRANT, and User Response: Bind the application again,
REVOKE. using the bind file for the program that matches
the object module. Or, execute the program that
The statement cannot be executed. corresponds to the package stored in the
User Response: If the application is running as database.
an IMS inquiry-only transaction, see your IMS If installing the sample database, record the
system programmer about changing the number and text of this message and then
inquiry-only status of the transaction under contact your technical service representative.
which your application is running.
Federated system users: in addition to the
If the IMS or CICS application is attempting a previously listed actions, ensure that the
remote update, either the application must be packages required for the federated server are
changed to run as a local application on the bound at the applicable data sources. Refer to the
server DBMS, or the server DBMS must be Installation and Configuration Supplement for
upgraded to support two-phase commit. more information on binding packages to data
If the application is attempting to update data at sources.
multiple locations, either the application must be sqlcode: -818
changed, or all DBMSs involved must be
upgraded to support two-phase commit. sqlstate: 51003

sqlcode: -817
sqlstate: 25000

132 Message Reference, Volume 2

 v If SQLRULES(STD) is in effect and the
SQL0822N The SQLDA contains a data
CONNECT statement identifies an existing
address or indicator variable
SQL connection, replace the CONNECT with
address which is not valid.
SET CONNECTION or change the option to
Explanation: The application program placed an SQLRULES(DB2).
address that is not valid in the SQLDA.
Correct the error in the application and try again.
The statement cannot be processed.
sqlcode: -842
User Response: Correct the application program
so that valid addresses are placed in SQLDA.
sqlstate: 08002
sqlcode: -822
sqlstate: 51004 SQL0843N The server name does not specify
an existing connection.
SQL0840N Too many items were returned in Explanation: A statement, command, or API
a SELECT list. specified a server name that does not identify an
existing SQL connection of the application
Explanation: The number of items returned in
process.
the SELECT list exceeds the allowable maximum.
The maximum for SELECT lists (other than on This may have occurred using:
common table expressions) is 1012. The v a SET CONNECTION statement
maximum for SELECT lists in common table
expressions is 5000. v a RELEASE statement
v a DISCONNECT statement
The statement cannot be processed.
v SET or QUERY CLIENT INFORMATION
User Response: Determine whether all the
information is actually needed. (Note that the User Response: The correction depends on the
number of items returned by the SELECT list * in error:
the SQL statement SELECT * from A, B, C is the v If the server name is not the intended name,
sum of the number of columns in all three correct it.
tables.) If possible, rewrite the SQL statement so v Ensure that a connection to the server has
only the necessary items of information are been established and is in a current or
returned. If all the information is necessary, break dormant state before issuing the request for
the SQL statement into two or more statements. that connection.
sqlcode: -840 Correct the error in the application and try again.
sqlstate: 54004
sqlcode: -843

SQL0842N A connection to server sqlstate: 08003

″<server-name>″ already exists.
Explanation: SQLRULES(STD) is in effect and a SQL0846N Invalid specification of identity
CONNECT statement identifies an existing SQL column “<column-name>”.
connection.
Explanation: For an ALTER or CREATE TABLE
User Response: The correction depends on the statement, the specification of an identity column
error: may be invalid for one of the following reasons:
v If the server name is not the intended name, v The data type of the associated column was
correct it. not one of the allowed data types for an
identity column. The following data types are

Chapter 2. SQL Messages 133

 allowed for an identity column: SMALLINT, v Update the database manager configuration
INTEGER, BIGINT, and DECIMAL with a for the TM database using the field tm_database
scale of zero. if that has not already been done.
v An invalid value was specified for v Verify that a connection to the tm_database can
INCREMENT BY. This value can be any be made. For example, attempt the connection
positive or negative value that could be using the Command Line Processor.
assigned to this column, but it cannot be 0, v Ensure that the tm_database chosen is not a
and cannot exceed the value of a large integer database accessed through DB2 Connect.
constant.
sqlcode: -859
v An invalid value was specified for CACHE.
The minimum value for CACHE is 2 and the
maximum value is 32767. sqlstate: 08502

The statement cannot be processed.

SQL0863W A successful connection was
User Response: Correct the syntax and resubmit made, but only single byte
the statement. characters should be used.
sqlcode: -846 Explanation: The server database and client
application are using codepages for different
sqlstate: 42815
language types and any characters outside the
7-bit ASCII range cannot be guaranteed (only the
SQL0859N Access to the Transaction Manager characters in the 7-bit ASCII range exist in all
Database failed with SQLCODE codepages). For example, the connection might
″<SQLCODE>″. be between a Japanese and a Latin-1 codepage,
but none of the Japanese characters will be
Explanation: The application was precompiled
available in the Latin-1 codepage, so all of these
with SYNCPOINT(TWOPHASE) and requires a
characters should be avoided (English characters
Transaction Manager Database to coordinate the
are fine though).
two phase commit. Reasons why the Transaction
Manager Database is not available might include Federated system users: possible causes are:
the following: v The federated database supports single-byte
v It was not created. and double-byte characters but the database
v The tm_database field of the database manager client system supports only single-byte
configuration file has not been updated and characters.
activated with the name of the database. v The data source supports single-byte and
v The database exists, but communication to the double-byte characters but the federated
database failed. system supports only single-byte characters.

User Response: Possible actions: User Response: Do not submit SQL statements
or commands that use characters which are not
v Refer to the SQLCODE that was returned with
common between the application and database
this message, and follow the appropriate
codepages.
action for that SQLCODE.
v Verify that the tm_database exists; if not, create Federated system users: do not submit SQL
a new database or select a database that statements or commands that use characters
currently exists for use as the TM database. It which are not common between the client
is recommended to create a separate database system, the federated system, and the data
if there are no serious constraints on disk source.
storage. sqlcode: +863
sqlstate: 01539

134 Message Reference, Volume 2

 sqlcode: -866
SQL0865N Invalid tm_database value.
Explanation: The database chosen as the sqlstate: 08001
tm_database in the database manager
configuration is not valid. The database must be
at level DB2 V2.1 or later, and cannot be a SQL0868N A CONNECT using a
database accessed through DRDA protocol (ie. USER/USING clause was
through DB2 Connect). attempted to a server for which a
connection already exists.
The statement cannot be executed.
Explanation: A current or dormant connection
User Response: to a server exists, and an attempt to CONNECT
1. Update the database manager configuration to this server using the USER/USING clause is
to specify a valid database for the tm_database invalid.
parameter. User Response: Possible actions:
2. Issue db2stop and db2start to ensure that the v Use the SET CONNECTION statement to
change takes effect. make the connection to the DORMANT
sqlcode: -865 connection current.
v Use the CONNECT statement without
sqlstate: 08001 USER/USING if SQLRULES(DB2) are being
used by the application.
SQL0866N Connection redirection failed. v Complete the existing unit of work,
Reason code: “<reason-code>” disconnect, and then reconnect using
USER/USING.
Explanation: Directory cataloging for a database
caused a connection to be redirected in a manner sqlcode: -868
which is not supported.
sqlstate: 51022
Possible reason codes are:
01 A database connection involved more SQL0880N SAVEPOINT “<savepoint-name>”
than one redirection from a server to does not exist or is invalid in this
another server; only one connection context.
redirection is supported.
Explanation: An error occurred issuing a
02 A connection was attempted which RELEASE or ROLLBACK TO SAVEPOINT
involved both a current version of DB2 “<savepoint-name>” statement. Either a
client or server and a version 1 client or savepoint with that name does not exist, or it
server. This attempt failed because was established outside the current atomic
redirection is not supported with execution context.
version 1 clients or servers.
The statement cannot be processed.
User Response: By the reason code, the actions
are: User Response: Correct the name of the
savepoint in the statement and reissue the
01 Recatalog the database so that there is statement.
no more than one server redirecting the
connection to another server in the path sqlcode: -880
of the connection. sqlstate: 3B001
02 Recatalog the database so that there is
no intermediary server redirecting the
connection.

Chapter 2. SQL Messages 135

 the transaction since the specified savepoint was
SQL0881N A SAVEPOINT with name
established. For more information, refer to the
“<savepoint-name>” already
SQL Reference.
exists, but this savepoint name
cannot be reused. sqlcode: -881
Explanation: The name “<savepoint-name>” sqlstate: 3B501
has already been used in a SAVEPOINT
statement. The savepoint name cannot be reused
because at least one of the SAVEPOINT SQL0882N Savepoint does not exist.
statements that used this name also specified the Explanation: An error occurred issuing a
UNIQUE keyword, which asserts that the name ROLLBACK TO SAVEPOINT statement. Issuing
must be unique. a ROLLBACK TO SAVEPOINT without
The statement cannot be processed. The new specifiying a specific savepoint name is not
savepoint is not set. The old savepoint with the allowed when there are no existing savepoints.
same name still exists. The statement cannot be processed.
User Response: Choose another name for this User Response: Issue a different statement, or
savepoint and reissue the SAVEPOINT statement. try rolling back the entire transaction with the
If this existing savepoint name must be reused, ROLLBACK statement.
issue the RELEASE SAVEPOINT statement to
free the existing savepoint. However, be aware sqlcode: -882
that the RELEASE SAVEPOINT statement also sqlstate: 3B502
releases any savepoints that were established in

SQL0900 - SQL0999

SQL0900N The application state is in error. A SQL0901N The SQL statement failed because
database connection does not of a non-severe system error.
exist. Subsequent SQL statements can
be processed. (Reason
Explanation: A connection to a database does
“<reason>”.)
not exist. This may be due to one of the
following reasons: Explanation: An error has occurred which is
v A serious error in the application state has due to a system error. Processing of the SQL
caused the database connection to be lost. statement has ended for reason “<reason>” (this
is in English only and is useful only to IBM
v The application may have disconnected from a
support personnel).
database and not established a new current
connection before executing the next SQL User Response: Record the message number
statement. (SQLCODE) and reason “<reason>”.
User Response: Reestablish a current If trace was active, invoke the Independent Trace
connection be either switching to an existing Facility at the operating system command
dormant connection (using CONNECT TO or prompt. Refer to the Independent Trace Facility
SET CONNECTION) or by establishing a new in the Troubleshooting Guide for information on
connection (using CONNECT). how to use this facility. Then contact your
technical service representative with the
sqlcode: -900
following information:
sqlstate: 08003 v Problem description
v SQLCODE

136 Message Reference, Volume 2

v reason “<reason>” sqlstate: 58005
v SQLCA contents if possible
v Trace file if possible. SQL0903N COMMIT statement failed,
transaction rolled back. Reason
Federated system users: isolate the problem to
code: “<reason-code>”
the data source failing the request (refer to the
Troubleshooting Guide to determine which data Explanation: One or more of the servers
source is failing to process the SQL statement) participating in the current unit of work was
and take the necessary diagnostic steps for that unable to prepare the database to be committed.
data source. The problem determination The COMMIT statement has failed and the
procedures for data sources vary, so refer to the transaction has been rolled back.
applicable data source manuals.
Possible reason codes are:
sqlcode: -901 01 A connection to one of the databases
participating in the unit of work was
sqlstate: 58004 lost.
Federated system users: if the database
SQL0902C A system error (reason code = you connected to is a federated server
“<reason-code>”) occurred. database where nicknames are used, a
Subsequent SQL statements connection to one of the data sources
cannot be processed. required for a nickname within the
database was lost.
Explanation: A system error occurred.
02 One of the databases or nodes
User Response: Record the message number participating in the unit of work was
(SQLCODE) and reason code in the message. accessed, but unable to prepare to
If trace was active, invoke the Independent Trace commit.
Facility at the operating system command Federated system users: if the database
prompt. Refer to the Independent Trace Facility you connected to is a federated server
in the Troubleshooting Guide for information on database where nicknames are used, one
how to use this facility. Then contact your of the data sources required for a
technical service representative with the nickname is unable to prepare to
following information: commit.
v Problem description
03 A DB2 Data Links Manager
v SQLCODE and embedded reason code participating in the unit of work was
v SQLCA contents if possible unable to prepare to commit.
v Trace file if possible. User Response: If a connection to a database
Federated system users: isolate the problem to was lost, reestablish the connection. If the failure
the data source failing the request (refer to the was not connection related, reference the error
Troubleshooting Guide to determine which data diagnostic logs on the remote system to
source is failing to process the SQL statement) determine the nature of the failure and what
and take the necessary diagnostic steps for that action might be required. Rerun the application.
data source. The problem determination sqlcode: -903
procedures for data sources vary, so refer to the
applicable data source manuals. sqlstate: 40504

sqlcode: -902

Chapter 2. SQL Messages 137

 resource limit specification table or a ’system
SQL0904N Unsuccessful execution caused by
parameter’. If the source is a system parameter,
an unavailable resource. Reason
the resource limit specification table did not
code: ″<reason-code>″, type of
contain an applicable entry or an error occurred
resource: ″<resource-type>″, and
while accessing the table. In either case, the limit
resource name:
is obtained from an install (system) parameter.
″<resource-name>″.
User Response: Determine why this SQL
Explanation: The SQL statement could not be
statement took so long and take appropriate
executed because resource ″<resource-name>″ of
action. Consider simplifying the SQL statement,
type ″<resource-type>″ was not available at the
restructuring tables and indexes, or contacting
time for the reason indicated by ″<reason-code>″.
the installation group responsible for maintaining
Refer to the Problem Determination
the resource limit specification tables.
documentation of DB2 for MVS for an
explanation of resource type codes. An application program that receives this return
code can execute additional SQL statements.
User Response: Verify the identity of the
resource that was not available. To determine sqlcode: -905
why the resource was unavailable, refer to the
specified ″<reason-code>″. sqlstate: 57014

sqlcode: -904
SQL0906N The SQL statement cannot be
sqlstate: 57011 executed because this function is
disabled due to a prior error.
SQL0905N Unsuccessful execution due to Explanation: Execution of the SQL statement
resource limit being exceeded. failed because the requested function had been
Resource name = disabled by a prior error. This situation can arise
″<resource-name>″, limit = if the application program has intercepted an
″<limit-amount1>″ CPU seconds abend (for instance, by an ON ERROR condition
(″<limit-amount2>″ service units) in a PL/I program) and continued to execute
derived from ″<limit-source>″. SQL statements. This situation may also arise if a
DB2 CICS transaction encountered a create
Explanation: The execution of the SQL
thread error yet continued to issue SQL requests
statement was terminated because a resource
without issuing a SYNCPOINT ROLLBACK first.
limit was exceeded.
User Response: In general, an application
The name of the resource whose limit was
program should terminate upon receipt of this
exceeded is ″<resource-name>″. It is also the
return code. All subsequent attempts by the
name of the column in the resource limit
application to execute other SQL statements will
specification table from which the limit was
also fail with the same return code. In the case of
derived. The limit that was exceeded in CPU
a DB2 CICS transaction, if the SQLERRP field in
seconds is ″<limit-amount1>″ and in service
the SQLCA contains the module name
units it is ″<limit-amount2>″. The
DSNCEXT1, the transaction may issue a
″<resource-name>″ may be ASUTIME, which is
SYNCPOINT ROLLBACK and continue
the number of CPU seconds permitted for each
processing. If the transactions chooses to
SQL statement. The maximum number of CPU
ROLLBACK and continue processing, it must be
seconds permitted is ″<limit-amount1>″. The
capable of correcting the situation that caused
maximum number in service units is
the create thread error to occur originally.
″<limit-amount2>″.
sqlcode: -906
The source used to derive the limit-amount is
″<limit-source>″ and is either the name of a sqlstate: 24514, 51005, 58023

138 Message Reference, Volume 2

 sqlstate: 57007
SQL0908N ″<bind-type>″ error using
″<auth-id>″ authority BIND,
REBIND, or AUTO_REBIND SQL0910N The SQL statement cannot access
operation is not allowed. an object on which a modification
is pending.
Explanation: For BIND and REBIND, the
indicated authorization ID is not allowed to Explanation: The application program
perform the indicated ″<bind-type>″ against a attempted to access an object within the same
plan or package. An entry in the resource limit unit of work in which either:
specification table (RLST) prohibits binding and v The application program issued a DROP
rebinding by this authorization ID, or all against the object or a related object (e.g. an
authorization IDs. For AUTO-REBIND, the index for a table)
system parameter controlling AUTO-REBIND
operations is set to disallow AUTO-REBIND. v The application program issued a statement
against the object that added or dropped a
bind-type constraint.
Type of bind operation (BIND, REBIND v The application program issued a DROP
or AUTO-REBIND). TRIGGER or CREATE TRIGGER statement
auth-id Authorization ID of the invoker of the that affected the object, either directly or
BIND subcommand or primary indirectly.
authorization ID of the invoker of the v The application program issued a ROLLBACK
plan for AUTO-REBIND operations. TO SAVEPOINT statement, which placed the
object in the modification pending state.
User Response: If the indicated authorization id
should be allowed to bind, change the entry in v The application program issued a statement
the active RLST table. If AUTO-REBIND that caused all rows of a NOT LOGGED
operations are disabled, rebind the package declared temporary table to be deleted.
before reexecuting the package. Federated system users: in addition to the
sqlcode: -908 previously listed causes, other data source
specific restrictions may exist that prevent access
sqlstate: 23510 to the object.

SQL0909N The object has been deleted. The SQL statement cannot be processed.

Explanation: The application program has User Response: Modify the application program
either (1) dropped a table and then attempted to so there is no attempt to access an object within
access it, or (2) dropped an index and then tried the same unit of work in which the modification
to access its object table using that index. was made. In general, it is better to isolate Data
Definition Language (DDL) statements in a
User Response: The logic of the application different unit of work than Data Manipulation
program must be corrected such that it does not Language (DML) statements that access the same
attempt to access or use an object after it has objects.
been dropped.
The unit of work must be committed or rolled
Dropping indexes within an application program back before the statement that failed can be
is especially hazardous, because there is no way processed successfully. If the committed
of determining whether or not the plan that has modification caused an object to be dropped,
been generated for the application (by BIND or then the object may have to be recreated in order
REBIND) actually uses a particular index for for the failing SQL statement to be processed
access to its object table. successfully.
sqlcode: -909

Chapter 2. SQL Messages 139

If the object is modified within a SAVEPOINT, The application is rolled back to the previous
modify the application program so that it does COMMIT.
not attempt to access the object after the
User Response: To help avoid deadlock or lock
application issues a ROLLBACK TO SAVEPOINT
timeout, issue frequent COMMIT operations, if
statement. Any cursor that accesses the modified
possible, for a long-running application, or for an
object and is open at the time of the ROLLBACK
application likely to encounter a deadlock.
TO SAVEPOINT will not be accessible. Modify
the application so that it closes the cursor. Federated system users: the deadlock can occur
at the federated server or at the data source.
If an insert, delete or update statement involving
There is no mechanism to detect deadlocks that
a NOT LOGGED declared temporary table fails,
span data sources and potentially the federated
then all rows in that table are deleted. Any
system. It is possible to identify the data source
cursor that is open against that declared
failing the request (refer to the problem
temporary table at the time of the failure will not
determination guide to determine which data
be accessible and should be closed by the
source is failing to process the SQL statement).
application.
Deadlocks are often normal or expected while
Federated system users: if the previous action
processing certain combinations of SQL
does not solve the problem, isolate the request
statements. It is recommended that you design
(refer to the Troubleshooting Guide to determine
applications to avoid deadlocks to the extent
which data source is failing to process the SQL
possible.
statement) and determine what additional
constraints exist on the data source that are sqlcode: -911
preventing access to the object. Ensure that the
application is not violating any of those sqlstate: 40001
constraints.
sqlcode: -910 SQL0912N The maximum number of lock
requests has been reached for the
sqlstate: 57007 database.
Explanation: The maximum number of locks for
SQL0911N The current transaction has been the database was reached because insufficient
rolled back because of a deadlock memory was allocated to the lock list.
or timeout. Reason code
“<reason-code>”. The statement cannot be processed.

Explanation: The current unit of work was User Response: The application should submit
involved in an unresolved contention for use of a COMMIT or ROLLBACK statement before
an object and had to be rolled back. submitting other SQL statements. Consider
increasing the database configuration parameter
The reason codes are as follows: (locklist) to allow more lock list space.
2 transaction rolled back due to deadlock. sqlcode: -912
68 transaction rolled back due to lock sqlstate: 57011
timeout.
72 transaction rolled back due to an error SQL0913N Unsuccessful execution caused by
concerning a DB2 Data Links Manager deadlock or timeout. Reason code
involved in the transaction. “<reason-code>”.
Explanation: The request issued was involved
Note: The changes associated with the unit of
in an unresolved contention for use of an object
work must be entered again.
and the execution failed.

140 Message Reference, Volume 2

The reason codes are as follows:
SQL0918N Application must execute a
2 transaction branch failed due to rollback.
deadlock.
Explanation: The unit of work has already been
68 transaction branch failed due to lock rolled back in the database but other resource
timeout. managers involved in this unit of work might
not. To ensure integrity of this application, all
72 transaction rolled back due to an error SQL requests will be rejected until the
concerning a DB2 Data Links Manager application issues a rollback.
involved in the transaction.
User Response: All SQL requests will be
80 statement failed due to timeout. rejected until the application issues a rollback.
User Response: For example, in a CICS environment, this would
be a CICS SYNCPOINT ROLLBACK command.
v For reason code 80, you can retry the failed
statement without terminating the application. sqlcode: -918
If the application accesses multiple remote
databases, it may be better to rollback the sqlstate: 51021
transaction to avoid the possibility of a global
deadlock. SQL0920N Data on a database client system
v For other reason codes, issue a request to cannot be accessed from other
rollback the transaction. The transaction cannot database client systems.
be commited due to the failure of the current
Explanation: The workstation has been
transaction branch.
configured as a client or a server with local
v To help avoid deadlock or lock timeout, issue clients. Any databases created on this system
frequent COMMIT operations, if possible, cannot be shared by other workstations.
within long-running applications or
applications requiring data with high The function cannot be processed.
concurrent access. User Response: Request data only from server
sqlcode: -913 workstations.
sqlcode: -920
sqlstate: 57033
sqlstate: 57019

SQL0917N Remote bind from a DRDA

application requester failed. SQL0925N SQL COMMIT invalid for
application execution
Explanation: An error has occurred during a environment.
remote bind from a DRDA application requester.
This error can be issued during bind or commit Explanation: COMMIT is disallowed in the
processing. following cases:
v In a Distributed Transaction Processing
User Response: This problem is usually caused
environment such as CICS, a static SQL
by an SQL statement which did not get bound
COMMIT statement was attempted, but a
because of an error. The user should consult the
commit statement specific to the environment
diagnostics facility at the DRDA application
is required. For example, in a CICS
requester to determine which statement is
environment this would be the CICS
causing the error and correct it.
SYNCPOINT command.
sqlcode: -917 v A DB2 application precompiled or set to use
sqlstate: 42969 CONNECT 2 in a non-TP Monitor

Chapter 2. SQL Messages 141

 environment has issued a dynamic SQL 1. Remove the statement issuing the
COMMIT statement, whereas only static SQL ROLLBACK and replace it with a statement
COMMITs are allowed. which does the valid equivalent for the
v When issued from a stored procedure, SQL environment.
COMMIT is also not allowed if the calling 2. In the case of a connect type 2, use only static
program is executing in a distributed unit of COMMIT.
work or Distributed Transaction Processing 3. In the case of a stored procedure, remove it
environment. entirely.
User Response: Correct the problem by doing sqlcode: -926
one of the following:
v Remove the statement issuing the COMMIT sqlstate: 2D521
and replace it with a statement which does the
valid equivalent for the environment
SQL0930N There is not enough storage
v In the case of a connect type 2 in a non-TP available to process the statement.
Monitor environment, use only static
COMMIT. Explanation: A request was made to the
v In the case of a stored procedure, remove the database that required another memory page but
COMMIT no more pages are available to the database
manager.
sqlcode: -925
The statement cannot be processed.
sqlstate: 2D521 User Response: Possible solutions include:
v Verify that your system has sufficient real and
SQL0926N SQL ROLLBACK invalid for virtual memory.
application execution v Remove background processes.
environment. v If the error occurs during DUOW
Explanation: ROLLBACK is disallowed in the resynchronization, increase the maxagents and
following cases: reduce the resync_interval database manager
configuration parameter values.
1. In a Distributed Transaction Processing
environment such as CICS, a static SQL sqlcode: -930
ROLLBACK statement was attempted, but a
rollback statement specific to the environment sqlstate: 57011
is required. For example, in a CICS
environment this would be the CICS
SYNCPOINT ROLLBACK command. SQL0931C Operating system file table
overflow occurred. Subsequent
2. A DB2 application precompiled or set to use
SQL statements cannot be
CONNECT 2 has issued a dynamic SQL
processed.
ROLLBACK statement, whereas only static
SQL ROLLBACKs are allowed. Explanation: An Operating system limit has
3. When issued from a stored procedure, SQL been reached. The application program is not
ROLLBACK is also restricted if the calling permitted to issue additional SQL statements.
program is executing in a distributed unit of The database is marked as needing recovery and
work (CONNECT type 2) or Distributed all applications using the database are prevented
Transaction Processing environment. from accessing the database.

User Response: User Response: Terminate all the applications

using the database. Restart the database.

142 Message Reference, Volume 2

To help prevent the problem from recurring: “<object-name>” and resubmit the statement.
v Change the MAXFILOP database configuration sqlcode: -951
parameter to a smaller value (this will reduce
DB2’s use of the operating system file table), sqlstate: 55007
and/or
v Terminate other applications that are using SQL0952N Processing was cancelled due to
files, if appropriate, and/or, an interrupt.
v Refer to the operating system documentation Explanation: The user may have pressed the
for increasing the operating system file table interrupt key sequence.
limit. In most UNIX environments this can be
accomplished by updating the kernel The statement processing is terminated. Some
configuration with a larger value. (On AIX, changes may have been applied to the database,
this may only be possible by increasing the but not committed, before termination occurred.
amount of memory in your machine).
Federated system users: this situation can also be
sqlcode: -931 detected by the data source.
User Response: Continue the application.
sqlstate: 58005
If installing the sample database, drop it and
install the sample database again.
SQL0950N The table or index cannot be
dropped because it is currently in sqlcode: -952
use.
sqlstate: 57014
Explanation: A DROP TABLE or DROP INDEX
statement cannot be issued when an open cursor
SQL0954C Not enough storage is available in
is currently using the table or index.
the application heap to process
The statement cannot be processed. The table or the statement.
index is not dropped.
Explanation: All available memory for the
User Response: Close any cursors required and application has been used.
resubmit the statement.
The statement cannot be processed.
sqlcode: -950
User Response: Terminate the application on
sqlstate: 55006 receipt of this message. Increase the database
configuration parameter (applheapsz) to allow a
larger application heap.
SQL0951N The object “<object-name>” of
type “<object-type>” cannot be sqlcode: -954
altered because it is currently in
sqlstate: 57011
use by the same application
process.
SQL0955C Sort memory cannot be allocated
Explanation: An ALTER statement or SET
to process the statement. Reason
INTEGRITY statement for an object cannot be
code = “<reason-code>”.
issued when it is either locked or in use.
Explanation: Insufficient virtual memory is
The statement cannot be processed. The object is
available to the database agent for sort
not altered.
processing, as indicated by the reason code:
User Response: Close any cursors that depend
1 Insufficient private process memory.
either directly or indirectly on the object

Chapter 2. SQL Messages 143

2 Insufficient shared memory in the The statement cannot be processed.
database-wide shared memory area
User Response: Increase any parameter that
designated for sort processing.
affects the maximum number of open files
allowed at the location of the database. This
The statement cannot be processed but other
includes increasing the configuration parameter
SQL statements may be processed.
(maxfilop) to allow more file handles for the
User Response: One or more of the following: instance and terminating other sessions to reduce
v Decrease the value of the sort heap parameter the number of file handles being used.
(sortheap) in the corresponding database sqlcode: -958
configuration file.
sqlstate: 57009
v For reason code 1, increase the private virtual
memory available, if possible. For example, on
UNIX systems you can use the ulimit SQL0959C Not enough storage is available in
command to increase the maximum size of the the communication heap of the
data area for a process. server to process the statement.
v For reason code 2, increase the size of the Explanation: All available memory in the server
database-wide shared memory area designated communication heap has been used.
for sort processing by increasing the value of
the (sheapthres) database manager The command or statement cannot be processed.
configuration parameter. User Response: Terminate the application on
sqlcode: -955 receipt of this message. Increase the size of the
communication heap (comheapsz) parameter in
sqlstate: 57011 the server workstation database manager
configuration file.

SQL0956C Not enough storage is available in NOTE: This message is applicable only for
the database heap to process the releases of DB2 prior to Version 2.
statement. sqlcode: -959
Explanation: All available memory for the sqlstate: 57011
database has been used.
The statement cannot be processed. SQL0960C The maximum number of files
User Response: Terminate the application on has been reached in the database.
receipt of this message. Increase the database Explanation: The maximum number of database
configuration parameter (dbheap) to allow a larger files has been reached.
database heap. If the number of I/O servers is
near the high limit, reducing this number may The statement cannot be processed.
also help. User Response: Terminate the application on
sqlcode: -956 receipt of this message. Have all active
applications disconnect from the database and
sqlstate: 57011 then have them reconnect to the database. If the
error continues, drop either tables, indexes, or
SQL0958C The maximum number of open both from the database, or split the database.
files has been reached. If installing the sample database, drop it and
Explanation: The maximum number of file install the sample database again.
handles available to the database has been sqlcode: -960
reached.

144 Message Reference, Volume 2

sqlstate: 57011
SQL0965W There is no message text
corresponding to SQL warning
SQL0964C The transaction log for the “<SQLCODE>” in the message
database is full. file on this workstation. The
warning was returned from
Explanation: All space in the transaction log is module “<name>” with original
being used. tokens “<token list>”.
If a circular log with secondary log files is being Explanation: Database server returned code
used, an attempt has been made to allocate and ″<SQLCODE>″ to your application. The warning
use them. When the file system has no more code does not correspond to a message in the
space, secondary logs cannot be used. DB2 message file on this workstation.
If an archive log is used, then the file system has User Response: Refer to the documentation for
not provided space to contain a new log file. your database server to determine the cause for
The statement cannot be processed. specified ″<SQLCODE>″.

User Response: Execute a COMMIT or

ROLLBACK on receipt of this message SQL0966N The error mapping file “<name>”
(SQLCODE) or retry the operation. specified in the Database
Connection Services directory
If the database is being updated by concurrent cannot be found or cannot be
applications, retry the operation. Log space may opened.
be freed up when another application finishes a
transaction. Explanation: One of the following conditions is
true:
Issue more frequent commit operations. If your
v The error mapping file does not exist.
transactions are not committed, log space may be
freed up when the transactions are committed. v The error mapping file is currently opened by
When designing an application, consider when to another application.
commit the update transactions to prevent a log v The error mapping file is not located in the
full condition. expected path.
If deadlocks are occurring, check for them more v The error mapping file is damaged.
frequently. This can be done by decreasing the The error mapping data could not be retrieved.
database configuration parameter DLCHKTIME.
This will cause deadlocks to be detected and User Response: Release the file from the
resolved sooner (by ROLLBACK) which will then application in which it is open or reinstall or
free log space. restore the original file.
If the condition occurs often, increase the sqlcode: -966
database configuration parameter to allow a
sqlstate: 57013
larger log file. A larger log file requires more
space but reduces the need for applications to
retry the operation. SQL0967N The format of the error mapping
file “<name>” specified in the
If installing the sample database, drop it and
Database Connection Services
install the sample database again.
directory is not valid.
sqlcode: -964
Explanation: An error occurred while the
sqlstate: 57011 program was reading the error mapping file.
The error mapping data could not be retrieved.

Chapter 2. SQL Messages 145

User Response: Correct all syntactic errors in Troubleshooting Guide to determine which data
the error mapping file. source is failing to process the SQL statement).
Find the “<error>” in the applicable manual at
sqlcode: -967
the data source. If the probem is data dependent,
sqlstate: 55031 it may be necessary to examine the data being
processed at the data source at the time the error
occurred.
SQL0968C The file system is full.
Explanation: One of the file systems containing SQL0970N The system attempted to write to
the database is full. This file system may contain a read-only file.
the database directory, the database log files, or a
table space container. Explanation: A file used by the database is
marked read-only or does not exist. The database
The statement cannot be processed. requires write access to this file.
User Response: Refer to the diagnostic log to The statement cannot be processed.
determine which file system is full. Free system
space by erasing unwanted files. Do not erase User Response: Terminate the application on
database files. If additional space is required, it receipt of this message (SQLCODE). Ensure that
may be necessary to drop tables and indexes all database files are allowed both read and write
identified as not required. access. Check for unnecessary blank spaces
within the specified filename.
On unix-based systems, this disk full condition
may be due to exceeding the maximum file size sqlcode: -970
allowed for the current userid. Use the chuser
sqlstate: 55009
command to update fsize. A reboot may be
necessary.
SQL0972N The database drive does not
sqlcode: -968
contain the correct diskette.
sqlstate: 57011
Explanation: The diskette in the drive is not the
database diskette.
SQL0969N There is no message text
The statement cannot be processed.
corresponding to SQL error
“<error>” in the message file on User Response: Place the required diskette into
this workstation. The error was the drive. Do not remove a diskette if the
returned from module “<name>” application starts using a database that resides in
with original tokens “<token it.
list>”.
sqlcode: -972
Explanation: The Database server returned
sqlstate: 57019
SQLCODE “<error>” to your application. The
error code does not correspond to a message in
the DB2 message file on this workstation. SQL0973N Not enough storage is available in
the ″<heap-name>″ heap to
User Response: Refer to the documentation for
process the statement.
your database server to determine the cause for
the specified SQLCODE. Take action specified in Explanation: All available memory for this heap
the documentation for the database server to fix has been used. The statement cannot be
this problem. processed.
Federated system users: isolate the problem to User Response: Terminate the application on
the data source failing the request (refer to the receipt of this message (SQLCODE). Increase the

146 Message Reference, Volume 2

configuration parameter for ″<heap-name>″ to The statement cannot be processed.
increase the heap size.
User Response: Close the drive door and retry
sqlcode: -973 the operation.
sqlstate: 57011 sqlcode: -976
sqlstate: 57021
SQL0974N The drive containing the database
is locked.
SQL0977N COMMIT state unknown.
Explanation: The system reported that the drive
Explanation: The tm_database has become
containing the database is locked.
unavailable during COMMIT processing, and
The statement cannot be processed. this has caused the result of the COMMIT to be
unknown. Resynchronization of the databases
User Response: Ensure no other processing (for
will occur when the tm_database becomes
example, CHKDSK) that can lock the drive is
available. Note that the transaction may be rolled
occurring on the system. Retry the operation.
back during resynchronization. Further execution
If installing the sample database, drop it and of SQL statements can safely occur, however
install the sample database again. locks might be held until the resynchronization
process is complete.
sqlcode: -974
User Response: Verify that the connection to the
sqlstate: 57020 tm_database can be made, for example by using
CLP. If it cannot be made, follow the necessary
SQL0975N A new transaction could not be actions for the SQLCODE returned to ensure that
started because database or a connection can be established.
instance ″<name>″ is quiesced by sqlcode: -977
user ″<username>″. Quiesce type:
″<type>″. sqlstate: 40003

Explanation: Another user has quiesced the

instance or database that you are attempting to SQL0978N The diskette is write-protected.
use, and no new transactions are allowed until
Explanation: A write operation was attempted
the instance or database is no longer in the
to the database but the database diskette is write
quiesced state.
protected.
Quiesce type ″<type>″ refers to the instance or
The statement cannot be processed.
database already quiesced and is a ’1’ for an
instance and a ’2’ for a database. User Response: Verify that you are using the
correct diskette. Remove protection from the
User Response: Contact the user who currently
diskette, if necessary.
has the instance or database quiesced to
determine when DB2 will no longer be quiesced, sqlcode: -978
and retry the request at that time.
sqlstate: 55009
sqlcode: -975
sqlstate: 57046

SQL0976N The diskette drive door is open.

Explanation: The drive door for the database is
open.

Chapter 2. SQL Messages 147

 using the database are prevented from accessing
SQL0979N COMMIT has failed against
the database.
″<num>″ databases for an
application process running with The statement cannot be processed.
SYNCPOINT of NONE. The
failures include the following User Response: Record all error information
database alias and SQLSTATE from the SQLCA, if possible. Terminate all
pairs (a maximum of four can be applications using the database. Determine if the
returned): ″<alias/SQLSTATE1>″, error is a hardware error and take the
″<alias/SQLSTATE2>″, appropriate action as specified in the
″<alias/SQLSTATE3>″, Troubleshooting Guide for hardware problems.
″<alias/SQLSTATE4>″. Restart the database. If recovery is not possible,
restore the database from a backup copy.
Explanation: An application was connected to
multiple databases, and a COMMIT was issued If installing the sample database, drop it and
which failed for one or more of these install the sample database again.
connections. sqlcode: -980
Federated system users: if one of the failed sqlstate: 58005
connections is a federated server database where
nicknames are used, then a commit against one
of the data sources required for a nickname has SQL0982N A disk error occurred. However,
failed. subsequent SQL statements can
be processed.
User Response: Depending upon the nature of
the application and the data being updated, the Explanation: A disk error occurred during
user might wish to discontinue the processing processing of a temporary system file that
being done, log the failure, and issue the prevented successful execution of the current
appropriate SQL to ensure that the changes SQL statement. However, subsequent SQL
intended by the application are consistently statements can be processed.
reflected across all databases involved. The statement cannot be processed.
If a full list of databases affected by COMMIT User Response: Terminate the application on
errors could not be returned please refer to the receipt of this message (SQLCODE).
diagnostic log for a full list.
sqlcode: -982
sqlcode: -979
sqlstate: 58004
sqlstate: 40003

SQL0983N The transaction log does not

SQL0980C A disk error occurred. Subsequent belong to the current database.
SQL statements cannot be
processed. Explanation: The signature stored in the log file
does not match the database dependent
Explanation: A disk error occurred that signature. This error usually occurs when the
prevented successful execution of the current and user specified that the log file be stored in a
subsequent SQL statements. The application directory different from where the database is
program is not permitted to issue additional SQL stored. File redirection can be involved.
statements. For example, a recovery routine
associated with the application program cannot The statement cannot be processed.
issue additional SQL statements. The database is User Response: Resubmit the command with
marked as needing recovery and all applications the proper access to the log file.

148 Message Reference, Volume 2

sqlcode: -983 and database recovery procedures for data
sources vary, so refer to the applicable data
sqlstate: 57036
source manuals.

SQL0984C COMMIT or ROLLBACK was not sqlcode: -984

successful. Subsequent SQL
statements cannot be processed. sqlstate: 58005
Explanation: A commit or rollback operation
could not be processed successfully because of a SQL0985C A file error occurred while
system error. The application program is not processing the database catalogs.
permitted to issue additional SQL statements. For The database is not usable.
example, a recovery routine associated with the
application program may not issue additional Explanation: The system is unable to recover
SQL statements. The database is marked as from an I/O error on a catalog file.
needing recovery and all applications using the The system cannot process any statements using
database are prevented from accessing the the database.
database.
User Response: Restore the database from a
The statement cannot be processed. backup copy.
User Response: Record the message number If installing the sample database, drop it and
(SQLCODE) and all SQLCA error information, if install the sample database again.
possible. Terminate all applications using the
database. Restart the database. If installing the sqlcode: -985
sample database, drop it and install the sample sqlstate: 58005
database again.
If recovery is not possible, restore the database SQL0986N A file error occurred while
from a backup copy. processing a user table. The table
If trace was active, invoke the Independent Trace is not usable.
Facility at the operating system command Explanation: The data in the table is no longer
prompt. Refer to the Independent Trace Facility valid.
in the Troubleshooting Guide for information on
how to use this facility. Contact your technical The system cannot process any statements using
service representative with the following the table.
information: User Response: Restore the database from a
Information required: backup version if the database is inconsistent.
v Problem description If installing the sample database, drop it and
v SQLCODE install the sample database again.
v SQLCA contents if possible sqlcode: -986
v Trace file if possible. sqlstate: 58004
Federated system users: isolate the problem to
the data source failing the request (refer to the SQL0987C The application control shared
Troubleshooting Guide to determine which data memory set cannot be allocated.
source is failing to process the SQL statement)
and take the necessary diagnostic steps and Explanation: The application control shared
database recovery procedures for that data memory set cannot be allocated. This error is
source. The problem determination procedures caused by insufficient memory resources for

Chapter 2. SQL Messages 149

either the database manager or the environment your work. If errors still persist, reorganize the
in which its operations are being attempted. table, if possible.
Memory resources that can cause this error
Federated system users: isolate the problem to
include:
the data source failing the request (refer to the
v The number of shared memory identifiers Troubleshooting Guide to determine which data
allocated in the system. source is failing to process the SQL statement)
v The amount of paging or swapping space and follow the index re-creation procedures for
available in the system. that data source.
v The amount of physical memory available in
the system. SQL0992C The release number of the
User Response: One or more of the following: precompiled program is not valid.
v Ensure that sufficient memory resources are Explanation: The release number of the
available to satisfy the database manager precompiled program (package) is not
requirements and those of the other programs compatible with the release number of the
running on the system. installed version of the database manager.
v Reduce the database manager memory The precompiled program (package) cannot be
requirement for this memory set by reducing used with the current version of the database
the database configuration parameter, manager. The command cannot be processed.
app_ctl_heap_sz, which affects it.
User Response: Use only programs that are
v Reduce one or more of the database
precompiled with a compatible release level of
configuration parameters dbheap,
the database manager.
util_heap_sz, and buffpage. Refer to the
Administration Guide for the parameters sqlcode: -992
affecting the amount of database global
memory allocated. sqlstate: 51008

v Reduce the database manager configuration

parameter, sheapthres, if intra_parallel is set to SQL0993W The new path to the log
yes, or set intra_parallel to no. (newlogpath) in the database
v Where appropriate, stop other programs using configuration file is not valid.
the system. Explanation: The path to the log file is not valid
sqlcode: -987 for one of the following reasons:
v The path does not exist.
sqlstate: 57011 v A file with the correct name was found in the
specified path, but it is not a log file for this
database.
SQL0990C An index error occurred.
Reorganize the table. v The database manager instance id does not
have permission to access the path or a log
Explanation: An index has had considerable file.
activity that used all the free space for indexes.
The requested change is not made.
Federated system users: this situation can also be
detected by the data source. User Response: To change the path to the log
file, submit a database configuration command
The statement cannot be processed. with a valid value.
User Response: Commit your work and retry sqlcode: +993
the command. If the error continues, roll back
sqlstate: 01562

150 Message Reference, Volume 2

 table space. Contact IBM service to inspect the
SQL0994N Invalid usage of the application
object and the table space.
savepoint.
sqlcode: -996
Explanation: The application savepoint function
has been used inconsistently. The program sqlstate: 58035
attempted to perform one of the following:
v Request more than one active savepoint. SQL0997W General informational message
v Issue an end savepoint call without an active for transaction processing. Reason
savepoint. Code = “<XA-reason-code>”.
v Issue a rollback savepoint call without an Explanation: The SQLCODE 997 is only passed
active savepoint. between components of the database manager
The function cannot be processed. and will not be returned to an application. It is
used to carry XA return codes for non-error
User Response: Correct the savepoint usage in situations. The possible reason codes are:
the program.
v XA_RDONLY (3) - the transaction branch was
read-only and has been committed.
SQL0995W The current path to the log file v 64 - TM database indicates transaction to be
(logpath) is not valid. The log file committed on DUOW resynchronization
path is reset to the default.
v 65 - TM database indicates transaction to be
Explanation: The path to the log file is not valid rolled back on DUOW resynchronization
for one of the following reasons:
User Response: No action required.
v The path does not exist.
v A file with the correct name was found in the
SQL0998N Error occurred during transaction
specified path, but it is not a log file for this
or heuristic processing. Reason
database.
Code = ″<reason-code>″ Subcode
v The database manager instance id does not = ″<subcode>″.
have permission to access the path or log file.
Explanation: An error is detected when
For circular logging, the log file is created in the processing a distributed transaction. The
default log path. For archive logging, the next transaction is:
log file is created in the default log path. The
v Running under a Distributed Transaction
requested change is not made.
Processing environment (such as those from
User Response: To change the path to the log CICS or other transaction managers).
file, submit a configuration command with a v Performing heuristic operations.
valid value.
v Updating multiple nicknames within a
sqlcode: +995 federated database, where each updated
nickname represents a different data source. In
sqlstate: 01563
this case, one of the data sources has failed
during transaction processing. The reason code
SQL0996N Cannot free pages for an object in returned in this case is the reason for the
a table space. failure at the data source, not the federated
database.
Explanation: There are corrupted internal
database pages or internal logic errors in a table The possible reason codes (corresponding
space. Details can be found in the system error X/Open XA reason codes are shown in
log and/or the database manager error log. parenthesis) are:

User Response: Discontinue use of the object or

Chapter 2. SQL Messages 151

v 01 - (XAER_ASYNC) asynchronous operation v 35 - Heuristic operations are invalid for
already outstanding. non-XA database.
v 02 - (XAER_RMERR) a resource manager error v 36 - The XID is not known by the database
occurred in the transaction branch. manager.
v 03 - (XAER_NOTA) the XID is not valid. v 37 - The transaction has already been
v 04 - (XAER_INVAL) invalid arguments were heuristically committed.
given. Possible subcodes are: v 38 - The transaction has already been
– 01 - xa_info pointer is invalid, eg. the heuristically rolled back.
XAOpen string is null. v 39 - The transaction is not an indoubt
– 02 - database name exceeds maximum transaction.
length. v 40 - Only rollbacks are allowed for this
– 03 - username exceeds maximum length. transaction.
– 04 - password exceeds maximum length. v 41 - Transaction is not heuristically committed
on some MPP subordinator nodes because of
– 05 - username specified but not a password.
node failure.
– 06 - password specified but not a username.
v 69 - Database log ID mismatch during DUOW
– 07 - too many parameters in the xa_info resynchronization.
string.
v 85 - As a result of heuristic processing, the
– 08 - multiple xa_opens generate different transaction has partially committed and rolled
RM ids for the same database name. back.
– 09 - database name not specified. v 210 - Only heuristic commits are allowed for
– 10 - invalide exe_type. this transaction. Some nodes are already in
v 05 - (XAER_PROTO) routine invoked in commit state.
improper context. v 221 - The version of DBMS on the host
v 06 - (XAER_RMFAIL) resource manager requires that all applications that participate in
unavailable. the same XA transaction use the same user ID
to connect to the database.
v 07 - (XAER_DUPID) the XID already exits.
v 222 - The version of DBMS on the host
v 08 - (XAER_OUTSIDE) RM doing work requires that all applications that participate
outside global transaction. the same XA transaction have the same
v 09 - registration (ax_reg) with the transaction CCSID.
manager failed. Possible subcodes are: v 223 - DB2 Connect XA support is only
– 01 - Joining XID not found available to local clients or remote clients that
– 02 - dynamic library specified in the use TCPIP to establish the inbound connection.
tp_mon_name configuration parameter v 224 - DB2 Connect XA support is only
could not be loaded. available to clients that are at least version 7.1.
v 10 - attempted to start a different transaction User Response: For reason codes 1 through 8,
while suspended. an entry will be made in the system log because
v 12 - unregistering (ax_unreg) with the sometimes the SQLCA cannot be returned to the
transaction manager failed. caller.
v 13 - ax interface failure: ax_reg() and If the error is due to a failed data source
ax_unreg() not found. associated with a nickname, the location of the
v 14 - The enlistment for DB2 with the Microsoft failed data source will always appear in
Distributed Transaction Coordinator has failed. federated server’s system log.
MSDTC service may be down. You must
terminate the current transaction. For reason code 4, verify the content of the xa

152 Message Reference, Volume 2

open string and make necessary corrections. generated. In other words, the TM database or
RM database names could be referencing
For reason code 9, subcode 02, ensure that the
different database instances. The log ID
tp_mon_name configuration parameter contains
mismatch may be caused by the following
the name of the dynamic library in the external
reasons:
product which has the ax_reg() function used for
dynamic registration of transactions. v The database directory for the TM database at
the RM instance is incorrect.
For reason code 14, ensure that the MSDTC
v The configuration may have been changed
service is active.
after the indoubt transaction was generated.
For reason code 35, you attempted to perform a v The database may have been dropped and
heuristic operation against a database that only recreated. In that case, you can only commit or
participates as a read-only resource manager in a rollback the indoubt transaction heuristically.
global transaction. Examples are any DRDA
databases such as DB2 on MVS. These type of For reason code 85, you are updating multiple
non-XA databases would not have any XA data sources, and some of the data sources have
indoubt transactions. been heuristically rolled back or committed,
resulting in the transaction having partially
For reason codes 36, 37, and 38, you attempted committed and rolled back. With this reason
to perform an invalid heuristic operation on an code data is now in an inconsistent state, you
indoubt transaction. Either you specified the must manually check every data source updated
wrong XID, or a heuristic or resync operation by the transaction to correct the data.
had taken place since you recorded this XID.
Perform a Heuristic Query request to get the For reason code 210, some of the nodes are
current list of indoubt transactions to verify if already in commit state. You have to perform
you still need to perform your heuristic heuristic commit to resolve the indoubt
operation. transaction.
For reason code 39, the XID specified is for a
transaction that has ended and is waiting for the For reason code 221, ensure all applications that
two-phase commit process to begin. You can only participate in the same XA transaction use the
perform heuristic operations on transactions that same user ID to connect to the database.
have entered the two-phase commit process and
become indoubt transactions. For reason code 222, ensure all applications that
participate in the same XA transaction have the
For reason code 40, an SQL statement was same CCSID.
attempted under a transaction which has failed.
An example of this is to attempt an SQL
For reason code 223, modify the application and
statement in a transaction thread that has
client set-up to use local clients, or for remote
successfully registered after a tightly coupled
clients use TCPIP as the communication protocol
thread participating in the same transaction has
to connect to the gateway.
abnormally terminated.
For reason code 41, you can find more For reason code 224, update the client to version
information about the problem in the db2diag.log 7.1 or later.
file. You need to restart DB2 on the failed nodes.
It may be necessary to contact the system General information collection procedure:
administrator for assistance.
For reason code 69, either the transaction If you cannot resolve the problem identified by
manager (TM) database or the resource manager the reason codes, record the message number
(RM) database or both are different from the
ones when the indoubt transaction was

Chapter 2. SQL Messages 153

(SQLCODE), reason code, and the optional v Problem description
subcode in the message or the SQLCA in the v SQLCODE, embedded reason code, and
system log. subcode
v SQLCA contents (if possible)
If the failure is from a federated database, you
should also record the location of the failed data v Trace file (if possible)
source found in the federated server’s system v Location of the failed data source if the failure
log. is from a federated server.
There might be additional information in the
If trace was active, invoke the Independent Trace
console or message logs of the transaction
Facility at the operating system command
manager and the database manager.
prompt. Refer to the Independent Trace Facility
in the Troubleshooting Guide for information on
sqlcode: -998
how to use this facility. Then, contact your
technical service representative with the
following information: sqlstate: 58005

SQL1000 - SQL1099

SQL1000N “<alias>” is not a valid database SQL1002N “<drive>” is not a valid drive.
alias name.
Explanation: The drive specified in the
Explanation: The alias specified in the command is not valid. The drive is a single
command or api is not valid. The alias must character (A to Z) indicating the diskette drive or
contain 1 to 8 characters (bytes in MBCS fixed-disk partition where the database or
countries) and all the characters must be from database directory is located.
the database manager base character set.
The command cannot be processed.
The command cannot be processed.
User Response: Resubmit the command with
User Response: Resubmit the command with the correct drive.
the correct alias.
SQL1003N The password is not valid because
SQL1001N “<name>” is not a valid database the syntax is not correct or the
name. password does not match the
password of the specified
Explanation: The syntax of the database name
database.
specified in the command is not valid. The
database name must contain 1 to 8 characters Explanation: The length of the password is
and all the characters must be from the database expected to be 18 characters or less. However, if
manager base character set. the password is to be verified for an APPC
conversation, it must be 8 characters or less.
The command cannot be processed.
User Response: Ensure that the password is not
User Response: Resubmit the command with
longer than the limit allowed.
the correct database name.
sqlcode: -1003
sqlcode: -1001
sqlstate: 28000
sqlstate: 2E000

154 Message Reference, Volume 2

SQL1004C There is not enough storage on SQL1005N The database alias ″<name>″
the file system to process the already exists in either the local
command. database directory or the system
database directory.
Explanation: There is not enough storage on the
specified file system to process the command. Explanation: The alias name specified has
already been used. If no alias is specified in the
In a partitioned database environment on OS/2
catalog database command, the database name is
and Windows environments, each node in the
used as the alias. When a database is created, the
partitioned database group must have the exact
alias name is the same as the database name.
same physical hard drive specification (letter)
available and useable (must contain useable This error may occur on the catalog database
space) for the CREATE DATABASE command to command when the alias already exists in the
succeed. The physical hard drive letter is system database directory.
specifed in the database manager configuration.
On the create database command this error may
If this field is left blank the default will be the
occur in one of the following situations:
hard drive where DB2 is installed on the instance
owning machine (sqllib path). v The alias already exists in the system database
directory and local database directory.
The command cannot be processed.
v The alias already exists in the system database
User Response: Choose a different file system directory but not in the local database
or erase some non-database files from the directory.
specified file system to make space for the v The alias already exists in the local database
database manager functions. directory but not in the system database
In a partitioned database environment on OS/2 directory.
and Windows environments, follow the User Response: For the catalog database
following steps: command, uncatalog the alias from the system
v Determine which hard drive specification database directory and resubmit your original
(letter) is required. The drive letter is specified command or catalog the database with a
in the error message. different alias name.
v Determine which node/s of the database For the create database command, do the
partition are experiencing the problem. You following operations with respect to the above 3
can usually find this information in the situations:
db2diag.log file of the instance owning node.
v Drop the database using the alias name.
v Correct the drive problem on the individual Resubmit your original command.
node that is experiencing the problem or
v Uncatalog the alias. Resubmit your original
change the drive specification in the database
command.
manager configuration so that the same drive
is available (and has sufficient space) on each v Catalog the alias into the system database
and every node of the partitioned database directory. Drop the database using the same
group. alias. Resubmit your original command.
v re-issue the command.
SQL1006N The code page “<code page>” of
the application does not match the
code page “<code page>” of the
database.
Explanation: The application could not connect
to the database because the active codepage is

Chapter 2. SQL Messages 155

different from the one that was active when the v Verify that the database is cataloged correctly.
database was created. v Issue a different command.
The command cannot be processed.
User Response: Exit the current application SQL1010N “<type>” is not a valid type
program and return to the operating system. parameter.
Change the code page for the process and restart Explanation: The type specified in the Database
the application program. Environment command is not valid. It must be
’0’ for an indirect database or ’1’ for a remote
SQL1007N Error in finding pages for an database.
object in a table space. In addition, on the Unix, OS/2, Windows NT,
Explanation: There are corrupted internal and Windows 95 platforms, the type can be ’3’
database pages or internal logic error for a table for a database that has a DCE global name.
space. Details can be found in the system error The command cannot be processed.
log and/or the database manager error log.
User Response: Resubmit the command with a
User Response: Discontinue use of the object or valid type.
table space. Contact IBM service to inspect the
object and the table space.
SQL1011N No path was specified in the
sqlcode: -1007 CATALOG DATABASE command
sqlstate: 58034 for an indirect entry.
Explanation: A CATALOG DATABASE
SQL1008N Invalid table space ID. command was issued for an indirect entry but no
path was specified. Indirect entries must specify
Explanation: The table space ID specified does the path where the database resides.
not exist. It is either larger than the current
maximum table space ID, or the table space has The command cannot be processed.
been dropped. User Response: Resubmit the command with
User Response: Discontinue use of the the required path or change the type.
database. Save the diagnostic information in the
error log and contact IBM service. SQL1012N No node name was specified in
sqlcode: -1008 the CATALOG DATABASE
command for a remote entry.
sqlstate: 58036
Explanation: There was no nodename parameter
specified in the CATALOG DATABASE
SQL1009N The command is not valid. command for a remote entry. Remote entries
Explanation: The command is not supported must specify the node name of the database.
when issued on a client-only workstation or The command cannot be processed.
against remote databases. An example of such a
command is cataloging a local database. User Response: Resubmit the command with
the nodename parameter or a different type.
The command cannot be processed.
User Response: Possible solutions include:
v Issue the specified command from a non
client-only workstation or from the
workstation where the database resides.

156 Message Reference, Volume 2

SQL1013N The database alias name or SQL1015N The database must be restarted
database name ″<name>″ could because the previous session did
not be found. not conclude normally.
Explanation: The database name or alias Explanation: The database must be restarted
specified in the command is not an existing because of an abnormal termination of the
database or the database could not be found in previous session (for example, a power failure).
the (client or server) database directories.
The command cannot be processed.
User Response: Ensure that the specified
User Response: On receipt of this message
database name exists in the system database
(SQLCODE), an application can post a message
directory. If the database name does not exist in
warning the user that it takes time to recover the
the system database directory, then the database
database. To restart the database, issue the
either does not exist or the database name has
RESTART DATABASE command. In a partitioned
not been cataloged.
database server environment, the command must
If the database name appears in the system be issued on all nodes.
database directory and the entry type is
sqlcode: -1015
INDIRECT, ensure that the database exists in the
specified local database directory. If the entry sqlstate: 55025
type is REMOTE, then ensure that the database
exists and is cataloged on the database
directories of the server node. SQL1016N The local_lu alias “<name>”
specified in the CATALOG NODE
For CREATE DATABASE with the AT NODE command is not valid.
clause, ensure that the database name is in the
system database directory with an entry type of Explanation: The local logical unit (local_lu)
INDIRECT and with a catalog node number that alias specified in the CATALOG NODE
does not equal -1. command is not permitted. The local logical unit
alias is the local SNA logical unit alias and must
Federated system users: in addition to the above, be 1 to 8 characters and cannot contain blank
verify that the database names specified in characters.
SYSCAT.SERVERS are all valid. Correct any
SYSCAT.SERVERS entry for which the database The command cannot be processed.
specified in that entry does not exist. User Response: Verify that the alias is a
sqlcode: -1013 permitted logical unit name. Verify the characters
used in the name. Resubmit the command with a
sqlstate: 42705 valid logical unit name.

SQL1014W There are no more entries in the SQL1017N The mode parameter “<mode>”
directory, file, or list being specified in the CATALOG NODE
scanned. command is not valid.
Explanation: The scan of the directory, file, or Explanation: The mode specified in the
list is finished. CATALOG NODE command is not permitted.
User Response: No action is required. The mode parameter identifies the
communications profile the Communications
Manager uses to set up a session. The mode
must be 1 to 8 characters. Valid characters are
uppercase or lowercase A through Z, 0 through
9, #, @, and $. The first character must be

Chapter 2. SQL Messages 157

alphabetic. The system changes lowercase
SQL1021N The node name “<name>”
characters to uppercase.
specified in the UNCATALOG
The command cannot be processed. NODE command was not found.

User Response: Verify that the name is a Explanation: The nodename specified in the
permitted mode name. Verify the characters used command could not be found in the node
in the name. Resubmit the command with a directory.
correct mode.
The command cannot be processed.
User Response: If the nodename parameter is
SQL1018N The node name “<name>”
correct, the node may already have been
specified in the CATALOG NODE
uncataloged, and processing can continue.
command already exists.
Otherwise, resubmit the command with the
Explanation: The node name specified in the correct node name.
nodename parameter of the CATALOG NODE
command is already cataloged in the node
SQL1022C There is not enough memory
directory on this file system.
available to process the command.
The command cannot be processed.
Explanation: Not enough random access
User Response: If the nodename parameter is memory (RAM) is available to process the
typed correctly, continue processing. command.

Uncatalog the cataloged node in the node If a remote procedure was invoked, the remote
directory if the node cataloged information is no procedure may use a local variable space that is
longer valid and resubmit the command. If the larger than the allowable maximum (4K).
node cataloged information is valid, define a
If the statement involves a user-defined function
new node name and resubmit the command
(UDF), the memory set controlled by the
using the new node name.
udf_mem_sz database manager configuration
parameter may be larger than the memory
SQL1019N The node name “<name>” available.
specified in the command is not
The command cannot be processed.
valid.
User Response: Stop the application. Possible
Explanation: The node name specified in the
solutions include:
command is not valid. The node name may be 1
to 8 characters and all of the characters must be v Change the MEMMAN NO SWAP, NO MOVE
from the database manager base character set. option in the CONFIG.SYS file to SWAP,
MOVE.
The command cannot be processed.
v Remove background processes.
User Response: Resubmit the command with v Decrease the values of the configuration
the correct node name. parameters that define allocation of memory,
including udf_mem_sz if UDFs are involved in
SQL1020C The node directory is full. the failing statement.
v Install more random access memory (RAM).
Explanation: The node directory cannot hold
any more entries. v If a remote procedure was invoked, ensure
that the remote procedure uses a local variable
The command cannot be processed. space that is less than or equal to 4K.
User Response: Uncatalog any unnecessary v If you are using Remote Data Services,
entries in the node directory. increase the Remote Data Services heap size

158 Message Reference, Volume 2

 (rsheapsz) in the server and client disconnecting from the database, continue
configuration because at least one block is processing. If the error occurred on another SQL
used per application. statement, issue an SQL CONNECT statement
v On OS/2 systems, change PROTECT to and resubmit the command or statement.
NOPROTECT in the MEMMAN statement of sqlcode: -1024
the CONFIG.SYS file. This will make more
memory space available to applications, but sqlstate: 08003
disables certain protection features of OS/2.
Refer to the OS/2 documentation for more SQL1025N The database manager was not
information and to determine if this will be stopped because databases are
appropriate for your environment. still active.
v On OS/2 systems, increase the value of the
min_priv_mem database manager configuration Explanation: The stop database manager
parameter. This will cause the database command cannot be processed if there are any
manager to reserve more private memory applications connected to databases under
space at db2start time. control of the database manager, or if any
databases have been activated.
NOTE: This is applicable only for releases of
DB2 prior to Version 2. No action is taken.

sqlcode: -1022 User Response: Usually no action is required.

To stop the database manager, all active
sqlstate: 57011 applications must disconnect from all the
databases they are using. Alternatively, the user
can use the FORCE command to force
SQL1023C The communications conversation applications to disconnect, and the DEACTIVATE
failed. command to deactivate the database.
Explanation: An error occurred in the
communications conversation. SQL1026N The database manager is already
The command cannot be processed. active.

User Response: Retry the original command. If Explanation: A start database manager
the error persists, contact your communications command is already processed.
administrator. The command cannot be processed.
Federated system users: this situation can also be User Response: Because the command is
detected by the data source. already processed, the application may continue
sqlcode: -1023 processing.

sqlstate: 08001
SQL1027N The node directory cannot be
found.
SQL1024N A database connection does not
exist. Explanation: The list node directory command
cannot be processed because the node directory
Explanation: There is no connection to a could not be found.
database. Other SQL statements cannot be
processed unless an SQL CONNECT was The command cannot be processed.
previously executed. User Response: Issue a CATALOG NODE
The command cannot be processed. command with the appropriate parameters and
resubmit the current command.
User Response: If the error occurred when

Chapter 2. SQL Messages 159

SQL1029N The partner_lu alias “<name>” SQL1032N No start database manager
specified in the CATALOG NODE command was issued.
command is not valid.
Explanation: The start database manager
Explanation: The partner_lu alias specified in command has not been processed. It must be
the CATALOG NODE command was not processed before a stop database manager, any
specified or contains characters that are not SQL statement, or utility can be issued.
valid. The partner_lu alias is the partner SNA
The command cannot be processed.
logical unit alias and must be 1 to 8 characters
and must not contain blank characters. User Response: Issue a start database manager
command and resubmit the current command.
The command cannot be processed.
If using multiple logical nodes, ensure the
User Response: Examine the partner_lu for a
DB2NODE environment variable is set correctly.
typing error. Verify that the alias is a permitted
The DB2NODE environment variable indicates
logical unit name. Verify the characters used in
the node the application will attempt to connect
the alias. Resubmit the command with a correct
to. DB2NODE must be set to the node number of
partner_lu.
one of the nodes defined on the same host as the
application.
SQL1030C The database directory is full.
sqlcode: -1032
Explanation: Either the system database
sqlstate: 57019
directory or the local database directory cannot
hold any more entries.
SQL1033N The database directory cannot be
The command cannot be processed.
accessed because it is being used.
User Response: Uncatalog any unnecessary
Explanation: The database directory cannot be
entries in the directory. Create new databases on
accessed if it is currently being updated. Also,
another file system if the local database directory
the directory cannot be accessed for update if it
is full.
is already being accessed for any reason. This
situation could exist with either the system
SQL1031N The database directory cannot be database directory or the local database directory.
found on the indicated file
The command cannot be processed.
system.
User Response: Wait until the access has
Explanation: The system database directory or
completed, then resubmit the command.
local database directory could not be found. A
database has not been created or it was not sqlcode: -1033
cataloged correctly.
sqlstate: 57019
The command cannot be processed.
User Response: Verify that the database is SQL1034C The database is damaged. The
created with the correct path specification. The application has been disconnected
Catalog Database command has a path from the database. All
parameter which specifies the directory where applications processing the
the database resides. database have been stopped.
sqlcode: -1031 Explanation: Damage has occurred to the
database. It cannot be used until it is recovered.
sqlstate: 58031
All applications connected to the database have
been disconnected and all processes running

160 Message Reference, Volume 2

applications on the database have been stopped. v The maximum number of connections to the
database has been reached.
The command cannot be processed.
v The database is being used by another user on
User Response: Issue a RESTART DATABASE another system.
command to recover the database. If the
v Activate/Deactivate database is in progress.
RESTART command consistently fails, you may
want to restore the database from a backup. In a The command cannot be processed.
partitioned database server environment, check
User Response: Possible solutions include:
the syslog to find out if the RESTART command
fails because of node or communication failures v Resubmit the command later when the
before restoring the database from a backup. If database is not in use.
so, ensure the database manager is up and v Change the authorization to match the current
running and communication is available among user or wait until the database is not in use.
all the nodes, then resubmit the restart v Wait until the database is not in exclusive use.
command.
v Wait until other users on another system have
If you encountered this error during roll-forward disconnected from the database.
processing, you must restore the database from a
backup and perform roll-forward again. sqlcode: -1035

Note that in a partitioned database environment, sqlstate: 57019

the RESTART database command is run on a
per-node basis. To ensure that the database is
restarted on all nodes, use the command: SQL1036C An I/O error occurred while
accessing the database.
db2_all db2 restart database <database_name>
Explanation: At least one database file has an
This command may have to be run several times I/O error:
to ensure that all in-doubt transactions have been v The system cannot open, read from, or write to
resolved. a database file.
v The system cannot create the database because
If you are installing the sample database, drop it an error occurred while the system was
and install the sample database again. creating a database file or a directory for the
database.
sqlcode: -1034
v The system cannot drop the database because
an error occurred while the system was
sqlstate: 58031
deleting a database file or a directory for the
database.
SQL1035N The database is currently in use. v The system cannot create the database because
Explanation: One of the following conditions an interrupt was received while the system
exists: was creating or deleting a database file or a
directory for the database.
v Exclusive use was requested, but the database
is already in use as a shared database by v The system cannot locate the database
another user (in the same process). subdirectory or database configuration file
during connect.
v Exclusive use was requested, but the database
is already in use as an exclusive database. The database cannot be used.
(Two different processes are trying to access
User Response: If the error occurred during the
the same database.)
processing of a database, resubmit the command.

Chapter 2. SQL Messages 161

If the error continues, restore the database from a be accessed. This error may occur not only when
backup version. the system is cataloging or uncataloging a
database but also when the system is accessing a
If the error occurred during CREATE DATABASE
database that is cataloged in the directory.
or DROP DATABASE, a subsequent CREATE
DATABASE or DROP DATABASE command The command cannot be processed.
attempts to erase files and directories left from
User Response: Possible solutions include:
the unsuccessful CREATE DATABASE or DROP
DATABASE command. v If the error occurred on a diskette system,
verify that the correct diskette is in the drive
If installing the sample database, drop it and and ready to use. Verify that it is not
install the sample database again. write-protected.
If the error occurred while trying to connect to a v If the database directory is damaged, restore
database, get a trace and call IBM support for the the databases that were cataloged there from
possibility of recovering the database. backup versions and catalog them.
sqlcode: -1036 If installing the sample database, drop it and
install the sample database again.
sqlstate: 58030
sqlcode: -1039
SQL1037W The Node directory is empty.
sqlstate: 58031
Explanation: An attempt was made to read the
contents of the node directory, but no entries
existed. SQL1040N The maximum number of
applications is already connected
User Response: No action is required.
to the database.
sqlcode: +1037
Explanation: The number of applications
sqlstate: 01606 connected to the database is equal to the
maximum value defined in the configuration file
for the database.
SQL1038C An I/O error occurred while
accessing the node directory. The command cannot be processed.
Explanation: The node directory could not be User Response: Wait for other applications to
accessed because of an I/O error. disconnect from the database. If more
applications are required to run concurrently,
The command cannot be processed.
increase the value for maxappls. After all
User Response: Resubmit the command. If the applications disconnect from the database and
error continues, remove the node directory the database is restarted, the new value takes
(sqlnodir under the sqllib directory) and effect.
recatalog the node names on the network.
sqlcode: -1040
sqlcode: -1038
sqlstate: 57030
sqlstate: 58031
SQL1041N The maximum number of
SQL1039C An I/O error occurred while concurrent databases have already
accessing the database directory. been started.

Explanation: Either the system database Explanation: The application attempted to start
directory or the local database directory cannot an inactive database but the number of active

162 Message Reference, Volume 2

databases already equals the maximum value prompt. Refer to the Independent Trace Facility
defined in the system configuration file. in the Troubleshooting Guide for information on
how to use this facility. Contact your technical
The command cannot be processed.
service representative with the following
User Response: Wait for one of the databases to information:
become inactive. If more databases are required
Required information:
to be active at the same time, increase the value
for numdb. The new value takes effect after the v Problem description
next successful database manager start. v SQLCODE or message number
sqlcode: -1041 v SQLCA contents if possible
v Trace file if possible.
sqlstate: 57032
Federated system users: if necessary isolate the
problem to the data source rejecting the request
SQL1042C An unexpected system error
(see the problem determination guide for
occurred.
procedures to follow to identify the failing data
Explanation: A system error occurred. One source). If the problem is with a data source
possible reason for this error is that the database follow the problem determination procedures for
manager is not installed correctly or the that data source.
environment is not set up correctly.
sqlcode: -1042
On OS/2, while trying to start the database
manager, a very common reason for this error is
sqlstate: 58004
a corrupted NET.ACC file.
The command cannot be processed.
SQL1043C The database manager could not
User Response: If the error occurred on OS/2 initialize the system catalogs.
while trying to start the database manager, and Error “<error>” was returned.
the NET.ACC file is suspected, replace the
Explanation: The CREATE DATABASE
NET.ACC files on the system with those on
command failed while initializing the system
diskette 1 of the DB2 for OS/2 installation
catalogs.
diskettes.
User Response: Record the message number
If the error occurred while trying to connect to a
(SQLCODE) and error in this message.
database, get a trace (instructions below) and call
IBM support. If trace was active, invoke the Independent Trace
Facility at the operating system command
If the problem falls outside of the above
prompt. Refer to the Independent Trace Facility
suggestions, ensure that the system time and
in the Troubleshooting Guide for information on
date is correctly set, and make sure your system
how to use this facility. Then contact your
has enough memory and swapping/paging
technical service representative with the
space available.
following information:
Resubmit the current command. v Environment: Application
If the error continues, stop the database manager v Required information:
and restart it. – Problem description
If the error still continues, reinstall the database – SQLCODE or message number and error
manager. identifier
If trace was active, invoke the Independent Trace – SQLCA contents if possible
Facility at the operating system command – Trace file if possible.

Chapter 2. SQL Messages 163

 v The authorization is PUBLIC or public.
SQL1044N Processing was cancelled due to
an interrupt. v The authorization begins with SYS, sys, IBM,
ibm, SQL or sql.
Explanation: The user may have pressed the
v The authorization violates some data
interrupt key sequence.
source-specific naming convention.
Processing is stopped.
The command cannot be processed.
Federated system users: this situation can also be
User Response: Log on with a valid
detected by the data source.
authorization ID.
User Response: Continue processing to handle
Federated system users: if necessary isolate the
the interrupt.
problem to the data source rejecting the request
If installing the sample database, drop it and (see the Troubleshooting Guide for procedures to
install the sample database again. follow to identify the failing data source) and use
an authorization ID valid for that data source.
If starting the database manager, issue a db2stop
before issuing any db2 commands. sqlcode: -1046
sqlcode: -1044 sqlstate: 28000
sqlstate: 57014
SQL1047N The application is already
connected to another database.
SQL1045N The database was not found
because it was not cataloged Explanation: An application cannot create a
correctly. database while connected to another database.
Explanation: An indirect entry in the database Binding a bind file to one database while already
directory points to another non-HOME entry. connected to another database is not permitted.
The command cannot be processed. The command cannot be processed.
User Response: Verify the entries in all the User Response: Disconnect from the active
associated database directories with the directory database and resubmit the command.
scan commands.
sqlcode: -1045 SQL1048N The use parameter “<parameter>”
in the START USING DATABASE
sqlstate: 58031
or CONNECT TO command is not
valid. it must be an S for shared
SQL1046N The authorization ID is not valid. access, an X for exclusive use or
an N for exclusive use at single
Explanation: The authorization specified at node. For DB2 Connect
logon is not valid for either the data source or connections, only S is supported.
the database manager. One of the following N is only supported in MPP
occurred: configuration.
v The authorization contains more than 30
characters for Windows platforms or 8 Explanation: The use parameter in the START
characters for other platforms. USING DATABASE or CONNECT TO command
must be either an S for shared or an X for
v The authorization contains characters not valid exclusive use. If connecting to a database using
for an authorization. Valid characters are A DB2 Connect, only shared access is allowed.
through Z, a through z, 0 through 9, #, @ and Mnemonic equates for these values are provided
$. in the SQLENV.H file.

164 Message Reference, Volume 2

The command cannot be processed.
SQL1052N The database path ″<path>″ does
User Response: Resubmit the command with a not exist.
valid use parameter (preferably from the
Explanation: The path specified in the path
mnemonic equates).
parameter of the command is not valid. There is
no path with that name.
SQL1049C The application state is in error.
In a partitioned database environment on OS/2
The database connection has been
and Windows environments, each node in the
lost.
partitioned database group must have the exact
Explanation: The connection to the database has same physical hard drive specification (letter)
been lost. available and useable (must contain useable
space) for the CREATE DATABASE command to
The command cannot be processed. succeed. The physical hard drive letter is
User Response: Issue a CONNECT RESET specifed in the database manager configuration.
statement. If this field is left blank the default will be the
hard drive where DB2 is installed on the instance
owning machine (sqllib path).
SQL1050N The database cannot be
uncataloged because it is a home The command cannot be processed.
database. User Response: Resubmit the command with
Explanation: The database specified in the the correct database path.
UNCATALOG DATABASE command is a home In a partitioned database environment on OS/2
database. Home databases cannot be uncataloged and Windows environments, follow the
because their directory entries are deleted when following steps:
the database is dropped.
v Determine which hard drive specification
The command cannot be processed. (letter) is required. The drive letter is specified
in the error message.
User Response: Continue processing if the
database name was specified correctly. v Determine which node/s of the database
partition are experiencing the problem. You
can usually find this information in the
SQL1051N The path “<path>” for the db2diag.log file of the instance owning node.
database directory does not exist.
v Correct the drive problem on the individual
Explanation: The path specified in the database node that is experiencing the problem or
directory parameter of the command or in the change the drive specification in the database
database directory entry is not valid. There is no manager configuration so that the same drive
file system with that name. is available (and has sufficient space) on each
and every node of the partitioned database
The command cannot be processed.
group.
User Response: Resubmit the command with v re-issue the command.
the correct path for the database directory.
sqlcode: -1051 SQL1053N An interrupt is already being
sqlstate: 57019 processed.
Explanation: The system is currently processing
an interrupt so another interrupt is not honored.
The interrupt request is ignored.
User Response: Wait until the current interrupt

Chapter 2. SQL Messages 165

processing finishes and resubmit the command.
SQL1057W The system database directory is
empty.
SQL1054N A COMMIT is in progress and
Explanation: An attempt was made to read the
cannot be interrupted.
contents of the system database directory, but no
Explanation: The system is currently processing entries existed.
a COMMIT. The user entered an interrupt key
User Response: No action is required.
sequence.
sqlcode: +1057
The interrupt request is ignored.
sqlstate: 01606
Federated system users: this situation can also be
detected by the data source.
SQL1058N The handle parameter in the
User Response: Wait until COMMIT is finished
Directory Scan command is not
and resubmit the request.
valid.
Explanation: The handle parameter specified in
SQL1055N A ROLLBACK is in progress and
the Directory Scan command is not valid. The
cannot be interrupted.
handle must be the one returned from the OPEN
Explanation: The system is currently processing DIRECTORY SCAN or the OPEN NODE
a ROLLBACK. The user entered an interrupt key DIRECTORY SCAN command.
sequence.
The command cannot be processed.
The interrupt request is ignored.
User Response: Resubmit the command with a
Federated system users: this situation can also be valid handle parameter.
detected by the data source.
User Response: Wait until ROLLBACK is SQL1059N A Get Next command cannot be
finished and resubmit the request. processed because no Open Scan
command was issued.

SQL1056N There are already eight database Explanation: A directory scan command was
directory scans open. issued before the scan was opened.

Explanation: Eight database directory scans in The command cannot be processed.

this process are already open. No more than
User Response: Issue an OPEN DIRECTORY
eight open scans are allowed.
SCAN or OPEN NODE DIRECTORY SCAN
The command cannot be processed. command and resubmit the current command.

User Response: Issue one or more CLOSE

DIRECTORY SCAN commands and resubmit the SQL1060N User “<authorization-ID>” does
command. not have the CONNECT privilege.

sqlcode: -1056 Explanation: The specified authorization does

not have the CONNECT privilege to access the
sqlstate: 54029 database. The CONNECT privilege must be
granted before the user can connect to a
database.
Federated system users: this situation can also be
detected by the data source.
The command cannot be processed.

166 Message Reference, Volume 2

User Response: Contact the system
SQL1062N The database path “<path>” was
administrator or database administrator for the
not found.
database and request a GRANT CONNECT for
the authorization ID. Resubmit the command. Explanation: The database path parameter
specified in the command does not exist. If the
Federated system users: if necessary isolate the
path is not specified, the default path defined in
problem to the data source rejecting the request
the system configuration file is used, and it does
(see the Troubleshooting Guide for procedures to
not exist.
follow to identify the failing data source) and
ensure that correct priveleges have been granted In a partitioned database environment on OS/2
for that data source. and Windows environments, each node in the
partitioned database group must have the exact
sqlcode: -1060
same physical hard drive specification (letter)
sqlstate: 08004 available and useable (must contain useable
space) for the CREATE DATABASE command to
succeed. The physical hard drive letter is
SQL1061W RESTART completed successfully, specifed in the database manager configuration.
but indoubt transactions exist If this field is left blank the default will be the
against the database. hard drive where DB2 is installed on the instance
Explanation: A RESTART was successfully owning machine (sqllib path).
completed, except indoubt transactions were The command cannot be processed.
discovered. The database is usable, but if the
indoubt transactions are not resolved before the User Response: Verify the path or the default
last connection to the database is dropped, then path and make sure they exist in the system.
the database will again require a RESTART Resubmit the command.
before it can be used.
In a partitioned database environment on OS/2
User Response: Either resolve the indoubt and Windows environments, follow the
transactions, or be prepared to RESTART the following steps:
database whenever you wish to use it. If the v Determine which hard drive specification
transaction manager (TM) that was using the (letter) is required. The drive letter is specified
database (in an XA/DTP environment) is in the error message.
available, then the administrator should instruct
v Determine which node/s of the database
the TM to resolve the indoubt transactions.
partition are experiencing the problem. You
Alternatively, with great caution, the
can usually find this information in the
administrator can use the CLP to heuristically
db2diag.log file of the instance owning node.
complete the transactions.
v Correct the drive problem on the individual
Note that in a partitioned database server node that is experiencing the problem or
environment, the RESTART database command is change the drive specification in the database
run on a per-node basis. In order to ensure that manager configuration so that the same drive
the database is restarted on all nodes, use the is available (and has sufficient space) on each
following command: and every node of the partitioned database
db2_all db2 restart database <database_name> group.
v re-issue the command.
Issuing the above command will resolve any
in-doubt transactions if all nodes are operational.
SQL1063N The start database manager
processing was successful.
This command may have to be run several times
to ensure that all in-doubt transactions have been Explanation: The command to start the
resolved. database manager completed successfully.

Chapter 2. SQL Messages 167

 corrections, run DB2STOP, and then run
SQL1064N The stop database manager
DB2START again.
processing was successful.
If the problem continues, at the operating system
Explanation: The command to stop the database
command prompt type DB2TRC ON -L
manager completed successfully.
0X100000. Run DB2START again, then at the
command prompt, type DB2TRC DUMP
SQL1065W The database was created, but an filename to save the trace information. To turn
error occurred on one or more trace off, type DB2TRC OFF. Contact your service
bind files in list “<list-name>”. coordinator with the trace information.
The following files were not
bound: “<list>”.
SQL1067N DB2STOP processing was not
Explanation: One or more utilities were not successful. IPX/SPX protocol
bound to the database. The list file “<list-name>” support was not successfully
contains a list of the bind files. The numbers in stopped.
“<list>” indicate the relative positions of the
Explanation: The IPX/SPX protocol support
unbound files in the list file.
was not successfully stopped. Possible causes
The listed utility bind files are not bound to the are:
newly created database. v The workstation is not logged in to the
User Response: The user may bind the NetWare file server.
indicated utilities to the database. The format v The workstation does not have authority to
option must not be used on the binder call. delete an object in the NetWare file server
bindery.
SQL1066N DB2START processing was User Response: Ensure that the workstation is
successful. IPX/SPX protocol logged in to the NetWare file server, and has
support was not successfully sufficient authority to delete an object in the
started. bindery at the file server. The user must be
logged in as SUPERVISOR or equivalent. Make
Explanation: The IPX/SPX protocol support
any corrections, and run DB2STOP again.
was not successfully started. Remote clients
cannot use IPX/SPX to connect to the server. If the problem continues, at the operating system
Possible causes are: command prompt type DB2TRC ON -L
v The workstation is not logged in to the 0X100000. Run DB2STOP again, then at the
NetWare file server. command prompt, type DB2TRC DUMP
filename to save the trace information. To turn
v The workstation does not have authority to
trace off, type DB2TRC OFF. Contact your service
create an object in the NetWare file server
coordinator with the trace information.
bindery.
v Another database manager on the network is
using the same object name specified in the SQL1068N The domain that owns the user ID
database manager configuration file. “<user-ID>” for the CONNECT or
ATTACH statement is not defined
User Response: Ensure that the workstation is in the DB2DOMAINLIST
logged in to the NetWare file server, and has environment variable.
sufficient authority to create an object in the
bindery at the file server. The user must be Explanation: A user ID in a CONNECT TO or
logged in as SUPERVISOR or equivalent. Also ATTACH TO statement does not belong to a
ensure that the object name specified in the domain defined in the DB2DOMAINLIST
database manager configuration file is unique for environment variable.
all database managers in the network. Make any

168 Message Reference, Volume 2

User Response: Specify the name of the domain User Response: Ensure that a valid address is
which owns the user ID in the used in the application program and the input
DB2DOMAINLIST environment variable by string is null terminated.
using the DB2SET command.
sqlcode: -1068 SQL1072C The database manager resources
are in an inconsistent state. the
sqlstate: 08004
database manager may have been
incorrectly terminated, or another
SQL1069N The database “<name>” is not a application may be using system
home database. resources in a way which conflicts
with the way the database
Explanation: The database is not a local manager uses system resources.
database. A local database is cataloged as indirect System resource cleanup may be
in the system database directory and this entry required.
references a home entry in the local database
directory on the same node. Remote databases Explanation: The request failed because the
cannot be dropped. database manager resources are in an
inconsistent state. This can occur if:
The command cannot be processed.
v DB2 was incorrectly terminated (on
User Response: If the specified database name UNIX-based systems, for example, this may
was incorrect, resubmit the command with the occur if the processes were terminated with
correct database name. If the specified database the ″kill″ command, rather than the stop
name was correct and the intent is to remove the database manager command).
database name from the database directory, use v Another application or user may have
the UNCATALOG DATABASE command. removed the database manager resources (on
UNIX-based systems, for example, a user with
SQL1070N The address of the database name sufficient privilege may have accidentally
parameter is not valid. removed an Interprocess Communication (IPC)
resource owned by the database manager,
Explanation: The application program used an using the ″ipcrm″ command).
address that is not valid for the database name
v Another application’s use of system resources
parameter. Either the address points to an
conflicts with the database manager’s use of
unallocated buffer or the character string in the
system resources (on UNIX-based systems, for
buffer does not have a null terminator.
example, another application may be using the
The command cannot be processed. same keys that the database manager uses for
creating IPC resources).
User Response: Correct the application program
so a correct address is used and the input string v Another instance of the database manager may
is null terminated. be using the same resources. This could occur
on UNIX-based systems if the two instances
are on different file systems and the sqllib
SQL1071N The address of the database alias directories happen to have the same i-node
name parameter is not valid. (i-nodes are used to get the IPC keys).
Explanation: The application program used an User Response: Resource cleanup may be
address that is not valid for this parameter. required:
Either the address points to an unallocated buffer
v Remove all the database manager processes
or the character string in the buffer does not
running under the instance id (on UNIX-based
have a null terminator.
systems, you can use ″ps -eaf -u <instance id>
The command cannot be processed. | grep db2″ to list all the database manager

Chapter 2. SQL Messages 169

 processes running under the instance id, and
SQL1075N The address of the database
the ″kill -9 <process id>″ command to remove
comment parameter is not valid.
them).
v Ensure that no other application is running Explanation: The application program used an
under the instance id, and then remove all address that is not valid for this parameter.
resources owned by the instance id (on Either the address points to an unallocated buffer
UNIX-based systems, you can use the ″ipcs | or the character string in the buffer does not
grep <instance id>″ command to list all IPC have a null terminator.
resources owned by the instance id, and the The command cannot be processed.
″ipcrm -[q|m|s] <id>″ command to remove
them). User Response: Ensure that a valid address is
used in the application program and the input
v If there is another instance of the database
string is null terminated.
manager running, and it is on a different
filesystem, and an i-node conflict is suspected,
then change the i-node by the following steps: SQL1076N The address of the count
– create another directory at the same level as parameter is not valid.
sqllib Explanation: The application program used an
– move everything from under sqllib to the address that is not valid for the count parameter.
new directory
The command cannot be processed.
– delete sqllib
– rename the new directory to sqllib User Response: Ensure that a valid address is
used in the application program.
v Restart the database manager instance.

SQL1077N The address of the handle

SQL1073N The node directory release parameter is not valid.
number is not correct.
Explanation: The application program used an
Explanation: The node directory release number address that is not valid for the handle parameter.
does not match the product expected release
number. The node directory could be from a The command cannot be processed.
previous release.
User Response: Ensure that a valid address is
User Response: Re-catalog all the node entries used in the application program.
and try the command again.
SQL1078N The address of the buffer
SQL1074N The address of the password parameter is not valid.
parameter is not valid.
Explanation: The application program used an
Explanation: The application program used an address that is not valid for the buffer parameter.
address that is not valid for this parameter.
The command cannot be processed.
Either the address points to an unallocated buffer
or the character string in the buffer does not User Response: Ensure that a valid address is
have a null terminator. used in the application program.
The command cannot be processed.
SQL1079N The address of the nodename
User Response: Ensure that a valid address is
parameter is not valid.
used in the application program and the input
string is null terminated. Explanation: The application program used a
nname parameter address that is invalid. Either

170 Message Reference, Volume 2

the address points to an unallocated buffer or the
SQL1083N The database description block
character string in the buffer does not have a
cannot be processed, reason
null terminator.
code=“<reason-code>”.
The command cannot be processed.
Explanation: The application issued a CREATE
User Response: Ensure that a valid address is DATABASE command, but the database
used in the application program and the input descriptor block (DBDB) could not be processed
string is null terminated. for one of the following reason codes:
v The address of the DBDB is not valid (reason
SQL1080N The address of the local_lu name code 01).
parameter is not valid. v The value of the SQLDBDID field of the DBDB
is not valid (reason code 02). It should be set
Explanation: The application program used an to the value SQLDBDB1.
address that is not valid for the local_lu name
parameter. Either the address points to an v The value of the SQLDBCSS field of the DBDB
unallocated buffer or the character string in the is not valid (reason code 04).
buffer does not have a null terminator. The command cannot be processed.
The command cannot be processed. User Response: Correct the error and resubmit
User Response: Ensure that a valid address is the command.
used in the application program and the input
string is null terminated. SQL1084C Shared memory segments cannot
be allocated.
SQL1081N The address of the partner_lu Explanation: The database manager could not
parameter is not valid. allocate segments while processing a Database
Explanation: The application program has used Environment command or an SQL CONNECT
an address that is not valid for the partner_lu statement.
parameter. Either the address points to an The dbheap parameter may be too small.
unallocated buffer or the character string in the
buffer does not have a null terminator. User Response: Record the message number
(SQLCODE). The cause of this error may be
The command cannot be processed. insufficient memory resources either for the
User Response: Ensure that a valid address is database manager or the environment where
used in the application program and the input operation of the database manager is being
string is null terminated. attempted. Validate that sufficient memory
resources are available to satisfy the database
manager requirements. You may also close any
SQL1082N The address of the mode background processes that do not need to be
parameter is not valid. active.
Explanation: The application program has used If sufficient memory resources exist and the
an address that is not valid for the mode problem continues, invoke the Independent Trace
parameter. Either the address points to an Facility at the operating system command
unallocated buffer or the character string in the prompt. Refer to the Independent Trace Facility
buffer does not have a null terminator. in the Troubleshooting Guide for information on
how to use this facility. Contact your technical
The command cannot be processed.
service representative with the following
User Response: Ensure that a valid address is information:
used in the application program and the input
Required information:
string is null terminated.

Chapter 2. SQL Messages 171

v Problem description
SQL1087W The database was created, but an
v SQLCODE or message number error occurred while opening the
v SQLCA contents if possible list file “<name>”. The utilities
v Trace file if possible. are not bound to the database.

sqlcode: -1084 Explanation: CREATE DATABASE could not

open the list file containing the list of utility bind
files. The list file should be located in the bnd
sqlstate: 57019
subdirectory of the sqllib subdirectory.
The utility bind files are not bound to the newly
SQL1085N The application heap cannot be
created database.
allocated.
User Response: Bind the utilities to the
Explanation: The application could not connect
database. Do not use the format option on the
to the database because the database manager
binder call.
could not allocate the number of application
heap 4K pages specified in the database
configuration file. The system is out of 4K pages. SQL1088W The database was created, but an
The command cannot be processed. error occurred while binding the
utilities. The utilities are not
User Response: Possible solutions are:
bound to the database.
v Lower the size of the application heap
(applheapsz) in the database configuration file. Explanation: CREATE DATABASE or MIGRATE
DATABASE could not bind the utility bind files
v Reduce the maximum number of applications
to the database.
in the database configuration file.
v Remove background processes. The utility bind files are not bound to the newly
created or migrated database.
v Install more memory.
User Response: Bind the utilities to the
sqlcode: -1085
database. Do not use the format option on the
binder call.
sqlstate: 57019

SQL1089W The database was created, but the

SQL1086C An operating system error
binding of the utilities was
“<error>” occurred.
interrupted. The utilities are not
Explanation: The command received an error bound to the database.
from the operating system that prevents further
Explanation: CREATE DATABASE was
processing.
interrupted while binding the utilities to the
The command cannot be processed. database. The interrupt key sequence may have
been pressed.
User Response: Refer to the operating system
user publications to determine the nature of the The utility bind files are not bound to the newly
error. created database.
User Response: Bind the utilities to the
database. Do not use the format option on the
binder call.

172 Message Reference, Volume 2

 the database manager. If the error occurred on
SQL1090C The release number of the
the first connection after removing a fixpak, the
precompiled application program
database should be restored from a backup prior
or utility is not valid.
to using the utility to update the database to the
Explanation: The release number of the fixpak level.
precompiled application program or utility is not
sqlcode: -1091
compatible with the release number of the
installed version of the database manager. sqlstate: 08004
The error will also occur if the application
program is using down-level database manager SQL1092N “<authorization-ID>” does not
libraries or DLLs while accessing the installed have the authority to perform the
version of the database manager configuration requested command.
file.
Explanation: The user attempted to execute a
The command cannot be processed. command or operation without having the
proper authority for that command or operation.
User Response: Verify that there is no older
version of the database manager libraries or The command cannot be processed.
DLLs that will be picked up for your application
processing. Federated system users: this situation can also be
detected by the data source.
If the problem persists, repeat the precompile
process with the current database manager. Use User Response: Log on as a user with the
only application programs precompiled with a correct authority and retry the failed command
compatible release level of the database manager. or operation. Correct authorities may include
SYSADM, SYSCTRL, SYSMAINT, and DBADM.
DBADM is granted on databases and all other
SQL1091C The release number of the authorities are determined by membership in the
database is not valid. groups defined in the database manager
configuration (eg. if sysctrl_group in the database
Explanation: The release number of the
manager configuration file is defined as ’beatles’,
database is not compatible with the release
then you must belong to the group ’beatles’ to
number of the installed version of the database
have SYSCTRL authority). Refer to the Command
manager. This can be the release number when
Reference or the SQL Reference for the listing of
the database was created, the release number
required authorities for the attempted command
when the database was last migrated, or the
or operation.
highest version, release, modification, and fixpak
level defined in the catalog. If you are using Kerberos authentication in a
Windows 2000 environment, ensure that you log
The command cannot be processed. If the error
on to the machine using a domain account. Only
occurred during a Migrate or Restore, you are
domain users can use Kerberos authentication in
attempting to migrate or restore an incompatible
a Windows 2000 environment.
release of database. If the error occurred on the
first connection after removing a fixpak, you are If you are using LDAP support, ensure that you
attempting to connect to a database that is or the DB2 Connect gateway has the authority to
defined to use a higher level of database perform the CATALOG DATABASE, NODE and
manager code. DCS DATABASE commands. Invoke the
command ″UPDATE DBM CFG USING
User Response: Use only databases created
CATALOG_NOAUTH YES″ at the client or the
with a compatible release of database manager. If
gateway to correct the problem.
the error occurred during a Migrate or Restore,
you must first migrate the database to a release Federated system users: if necessary isolate the
which can be migrated by the current release of problem to the data source rejecting the request

Chapter 2. SQL Messages 173

(see the Troubleshooting Guide for procedures to
SQL1095N There are already eight node
follow to identify the failing data source) and
directory scans open.
ensure that the authorization id specified has the
proper authority on that data source. Explanation: Eight node directory scans are
already open in this process and no more than
Contact the System Administrator for authority
eight are allowed.
request assistance. Do not attempt to execute the
command without appropriate authorization. The command cannot be processed.
User Response: Issue one or more CLOSE
SQL1093N The user is not logged on. NODE DIRECTORY SCAN commands. Resubmit
the command.
Explanation: A user must be logged on before
any command requiring authorization can be sqlcode: -1095
processed. Possible causes for this error include:
sqlstate: 54029
v Unable to get a user ID.
v An unexpected operating system error
SQL1096N The command is not valid for this
occurred when attempting to log on.
node type.
v The application is running in a background
process. Explanation: A command was issued on a node
that does not support the command, or the
v The user cancelled an attempted logon.
system environment was found to be set up
The command cannot be processed. incorrectly for this node type. For example, a
database was cataloged as LOCAL on a client
User Response: Log on with a valid user ID
node.
and resubmit the command. If several concurrent
processes are attempting to log on, wait a few The command cannot be processed.
seconds and retry the logon procedure.
User Response: Verify that the command and
sqlcode: -1093 parameters are correct for the node type. Also
verify that the environment where the command
sqlstate: 51017
is to be processed is correct. Resubmit the
command.
SQL1094N The node directory cannot be
accessed because it is being
SQL1097N The node name was not found in
updated.
the node directory.
Explanation: The node directory cannot be
Explanation: Either the node name listed in the
scanned or used while it is being updated. Also,
database directory for a remote database or the
the directory cannot be accessed for update if it
node name specified on an attach command was
is already being accessed for any reason.
not cataloged in the node directory.
The command cannot be processed.
The command cannot be processed.
User Response: Resubmit the command after
Federated system users: this situation can also be
the update is finished.
detected by the data source.
sqlcode: -1094
User Response: Verify that the node name listed
sqlstate: 57009 in the database directory or as the object of the
attach command is cataloged in the node
directory. If the node is not listed in the node
directory, submit a CATALOG NODE command.
Federated system users: in addition to the actions

174 Message Reference, Volume 2

listed above, also verify that the node names User Response: No action is necessary.
listed in all the SYSCAT.SERVERS entries are
sqlcode: -1098
correct. If the node is not listed in the node
directory and the server is a member of the DB2 sqlstate: 53056
family, issue a CATALOG NODE command for
that node.
SQL1099N The diskette is write-protected.
sqlcode: -1097
Explanation: A write operation was attempted
sqlstate: 42720 to a database residing on a write-protected
diskette.
SQL1098N The application is already The statement cannot be processed.
connected to this database.
User Response: Verify you are using the correct
Explanation: A connection to a database was diskette. Remove protection from the diskette, if
requested but the application is already necessary.
connected to the specified database.
The command cannot be processed.

SQL1100 - SQL1199
User Response: Resubmit the request with a
SQL1100W The node name “<name>”
valid authorization ID and password
specified in the Catalog Database
combination for the remote system.
command has not been cataloged
in the Node Directory.
SQL1102N A database name was not
Explanation: The Catalog Database command
specified.
specified node name “<name>” but that is not
cataloged in the node directory. The node name Explanation: No database name was provided
must be cataloged before the remote database to proceed with migration.
can be used.
The statement cannot be processed.
The CATALOG DATABASE command completed
successfully. User Response: Specify a database name for
migration.
User Response: Issue a CATALOG NODE
command.
SQL1103W The Migrate Database command
processing was successful.
SQL1101N Remote database “<name>” on
node “<node-name>” could not be Explanation: The Migrate command completed
accessed with the specified successfully.
authorization id and password. Note that this message will also be returned if
Explanation: A connection to the remote the database was already at the current level and
database ″<name>″ on node ″<node-name>″ was did not need to be migrated.
requested, and the remote node does not accept Processing continues.
the authorization ID and password combination
specified for this node (either in the remote User Response: No action is required.
authorization tables or at runtime).
The request cannot be processed.

Chapter 2. SQL Messages 175

 Processing is stopped.
SQL1104N The address of the program name
parameter is not valid. User Response: Resubmit the command.
Explanation: The application program has used sqlcode: -1107
an address for the program name that is not
valid. sqlstate: 42724

The command cannot be processed.

SQL1108N An unexpected I/O error or
User Response: Use a correct address in the operating system error was
application program. received while loading the
specified DLL “<name>”.
SQL1105N The SQL CONNECT RESET Explanation: An unexpected error occurred
statement is not allowed in a when trying to load the DLL (dynamic link
Remote Application Interface library) module specified in the program name
Procedure. field.
Explanation: The remote application procedure The command cannot be processed.
contains an SQL CONNECT RESET statement.
User Response: Resubmit the current command.
The remote procedure is not allowed to continue. If the error continues, reinstall the database
manager.
User Response: Remove the SQL CONNECT
RESET statement and retry the remote procedure. If reinstallation does not correct the error, record
the message number (SQLCODE) and all
sqlcode: -1105
information in the SQLCA if possible.
sqlstate: 38003
If trace was active, invoke the Independent Trace
Facility at the operating system command
SQL1106N The specified DLL “<name>” prompt. Refer to the Independent Trace Facility
module was loaded, but the in the Troubleshooting Guide for information on
function “<function>” could not how to use this facility. Then contact your
be executed. technical service representative.
Explanation: The function within the DLL sqlcode: -1108
(dynamic link library) cannot be found.
sqlstate: 42724
The command cannot be processed.
User Response: Ensure that the DLL module is SQL1109N The specified DLL “<name>”
built correctly. Reference the module in the could not be loaded.
definition file.
Explanation: The DLL (dynamic link library)
sqlcode: -1106 module specified could not be found.
sqlstate: 42724 The command cannot be processed.
User Response: Ensure that the specified file is
SQL1107N An interrupt was received while in a subdirectory identified in the system
loading the specified DLL LIBPATH.
“<name>”.
sqlcode: -1109
Explanation: When loading the DLL (dynamic
sqlstate: 42724
link library) module, the command was
interrupted, perhaps by Ctrl+Break.

176 Message Reference, Volume 2

SQL1110N A supplied data area was invalid SQL1113N The data type for sqlvar “<n>” in
and could not be used. the output SQLDA was changed
from “<type 1>” to “<type 2>”.
Explanation: The data area is not initialized
correctly. Explanation: The remote stored procedure
changed the data type of the nth sqlvar in the
The command cannot be processed.
output SQLDA; n is the sequence number of the
User Response: Ensure that the user-supplied first mismatched sqlvar.
input SQLDA or output SQLDA fields are
The stored procedure does not return any data.
initialized correctly.
User Response: Correct the remote stored
procedure so the data type information in the
SQL1111N The program name “<name>”
output SQLDA is not changed.
specified was not valid.
sqlcode: -1113
Explanation: The DLL (dynamic link library)
module or program name syntax is not correct. sqlstate: 39502
The command cannot be processed.
SQL1114N The data length for the sqlvar
User Response: Ensure that the DLL or
“<n>” in the output SQLDA was
program name is specified correctly.
changed from “<length 1>” to
sqlcode: -1111 “<length 2>”.

sqlstate: 42724 Explanation: The remote stored procedure

changed the data length of the nth sqlvar in the
output SQLDA; n is the sequence number of the
SQL1112N There are not enough system first mismatched sqlvar.
resources to load the specified
DLL “<name>”. The stored procedure does not return any data.

Explanation: There is not enough random User Response: Correct the remote stored
access memory (RAM) to load the specified DLL procedure so the data length information in the
(dynamic link library) module. output SQLDA is not changed.

The command cannot be processed. sqlcode: -1114

User Response: Stop the application. Possible sqlstate: 39502

solutions are:
v Change the MEMMAN NO SWAP, NO MOVE SQL1115N The number of sqlvars in the
option in the CONFIG.SYS file to SWAP, output SQLDA was changed from
MOVE. “<count 1>” to “<count 2>”.
v Remove background processes.
Explanation: The remote procedure changed the
v Decrease the values of the configuration sqld field in the output SQLDA; sqld is the
parameters that define the allocation of number of used sqlvars in the SQLDA.
memory.
The stored procedure does not return any data.
v Install more random access memory (RAM).
User Response: Correct the remote stored
sqlcode: -1112
procedure so the sqld field in the output SQLDA
is not changed.
sqlstate: 42724
sqlcode: -1115

Chapter 2. SQL Messages 177

sqlstate: 39502
SQL1118N A connection to or activation of
database ″<name>″ cannot be
SQL1116N A connection to or activation for made because a previous backup
database ″<name>″ cannot be is incomplete.
made because of BACKUP
Explanation: The database is in an inconsistent
PENDING.
state because a system error occurred during a
Explanation: The specified database requires a backup function.
backup to be taken to provide a starting point
No connection was made.
for roll-forward recovery.
Federated system users: this situation can also be
No connection was made.
detected by the data source.
User Response: Back up the database by calling
User Response: Issue the BACKUP command
the BACKUP routine or, if roll-recovery is not
and then try the command again.
required, set the log retain and user exit database
configuration parameters off. Federated system users: if necessary isolate the
problem to the data source rejecting the request
sqlcode: -1116
(see the Troubleshooting Guide for procedures to
sqlstate: 57019 follow to identify the failing data source) and
issue the BACKUP command against that data
source prior to trying the command again.
SQL1117N A connection to or activation for
database ″<name>″ cannot be sqlcode: -1118
made because of
sqlstate: 57019
ROLL-FORWARD PENDING.
Explanation: The specified database is enabled
SQL1119N A connection to or activation of
for roll-forward recovery and it has been restored
database ″<name>″ cannot be
but not rolled forward.
made because a previous restore
No connection was made. is incomplete.

Federated system users: this situation can also be Explanation: The database is in an inconsistent
detected by the data source. state because a system error occurred during a
restore function.
User Response: Roll forward the database or
indicate that you do not wish to roll forward by No connection was made.
using the ROLLFORWARD command. Note that
Federated system users: this situation can be
if you do not roll forward the database, the
detected by the data source.
records written since the last backup of the
database will not be applied to the database. User Response: Issue the RESTORE command
and then try the command again.
Federated system users: if necessary isolate the
problem to the data source rejecting the request Federated system users: if necessary isolate the
(see the Troubleshooting Guide for procedures to problem to the data source rejecting the request
follow to identify the failing data source) and (see the Troubleshooting Guide for procedures to
take recovery action appropriate to that data follow to identify the failing data source) and
source to bring the data source to a point of issue the RESTORE command against that data
consistency. source prior to trying the command again.
sqlcode: -1117 sqlcode: -1119
sqlstate: 57019 sqlstate: 57019

178 Message Reference, Volume 2

 buffer or the address points to the incorrect
SQL1120N A connection to or activation of
protocol buffer.
database ″<name>″ cannot be
made because a previous backup The command cannot be processed.
or restore is incomplete.
User Response: Verify that the program
Explanation: The database is in an inconsistent allocates the required buffer area based on the
state because a system error occurred during a protocol field in the node structure and resubmit
backup or restore function. It cannot be the command.
determined if backup or restore was being
processed.
SQL1123N The protocol “<type>” is not
No connection was made. valid.
Federated system users: this situation can also be Explanation: The protocol type specified in the
detected by the data source. node structure for the Catalog command does
not represent a recognized value. The valid
User Response: Issue the BACKUP or
protocol types are defined in the sqlenv header
RESTORE command, and then try the command
files.
again.
The command cannot be processed.
Federated system users: if necessary isolate the
problem to the data source rejecting the request User Response: Verify the protocol type in the
(see the Troubleshooting Guide for procedures to node structure and resubmit the command.
follow to identify the failing data source) and
issue the BACKUP or RESTORE command
against that data source prior to trying the SQL1124N The remote workstation name
command again. “<name>” is not valid.

sqlcode: -1120 Explanation: The remote workstation name

specified in the NETBIOS protocol structure for
sqlstate: 57019 the Catalog command is not specified or contains
characters that are not valid. The workstation
name must be 1 to 8 characters. Valid characters
SQL1121N The address of the node structure
are A through Z, a through z, 0 through 9, #, @,
parameter is not valid.
and $. The first character must be alphabetic or a
Explanation: The application used an address special character: #, @, or $. Lowercase characters
for the node structure parameter that is not are changed to uppercase by the system.
valid. Either the address points to an unallocated
The command cannot be processed.
buffer or the buffer is not large enough to
contain the required input. User Response: Verify the characters specified
in the remote workstation name. Resubmit the
The command cannot be processed.
command with a valid workstation name.
User Response: Verify that the program
allocates the required buffer area and resubmit
SQL1125N The adapter number “<number>”
the command.
is not valid.
Explanation: The adapter number specified in
SQL1122N The address of the protocol
the NETBIOS protocol structure for the Catalog
structure parameter is not valid.
command is not valid.
Explanation: The application used an address
The command cannot be processed.
for the protocol structure parameter that is not
valid. Either the address points to an unallocated User Response: Verify that the adapter number
is valid and resubmit the command.

Chapter 2. SQL Messages 179

 v Increase the system process limit.
SQL1126N The network ID “<ID>” is not
valid. sqlcode: -1129
Explanation: The network ID specified in the
APPN protocol structure for the Catalog sqlstate: 42724
command is not valid. The network ID identifies
the SNA network where the remote logical unit SQL1130N New DARI (Stored Procedure)
(LU) resides. The network ID must be 1 to 8 process could not be started
characters. Valid characters are A through Z, a because the maximum number of
through z, 0 through 9, #, @, and $. The first DARI processes allowed to be
character must be alphabetic or a special present at the server at the same
character: #, @, or $. Lowercase characters are time has been reached.
changed to uppercase by the system.
Explanation: New DARI (Stored Procedure)
The command cannot be processed. process could not be started because the
User Response: Verify the characters specified maximum number of DARI processes allowed to
in the network ID. Resubmit the command with be present at the server at the same time has
a valid network ID. been reached.
User Response: Increase the maximum number
SQL1127N The remote LU name “<name>” is of DARI processes, maxdari, configuration
not valid. parameter. See the database configuration
parameter maxdari for more details.
Explanation: The remote logical unit (LU) name
specified in the APPN protocol structure for the sqlcode: -1130
Catalog command is not valid. The remote LU sqlstate: 42724
name is the remote SNA logical unit name and
must be 1 to 8 characters. Valid characters are A
through Z, a through z, 0 through 9, #, @, and $. SQL1131N DARI (Stored Procedure) process
The first character must be alphabetic or a has been terminated abnormally.
special character: #, @, or $. Lowercase characters Explanation: The cause of this error may be:
are changed to uppercase by the system.
v There was a coding error (e.g. segmentation
The command cannot be processed. violation) within the DARI routine.
User Response: Verify the characters specified v The DARI process has been terminated by
in the remote LU name. Resubmit the command another process through the use of a signal.
with a remote LU name. User Response: Reinitiate the DARI request
after doing the following :
SQL1129N New DARI (Stored Procedure) v Ensure that the DARI procedure is free from
process could not be started programming errors.
because there are insufficient v Make sure that no user is sending a
resources for a new process to be termination signal to the DARI process.
created.
sqlcode: -1131
Explanation: New DARI (Stored Procedure)
process could not be started because there are sqlstate: 38503
insufficient resources for a new process to be
created.
User Response: Do one of the following:
v Reduce the number of users using DB2

180 Message Reference, Volume 2

 sqlcode: -1134
SQL1132N The command is not allowed to
execute within a DARI (Stored sqlstate: 38003
Procedure).
Explanation: An illegal command has been SQL1135N An invalid value was specified for
made within the scope of DARI (Stored the number of segments when
Procedure). creating a database.
The DARI procedure is not allowed to continue. Explanation: The value that was specified for
the number of segments was out of range. The
User Response: Remove the illegal command in
valid range is from 1 to 256.
the DARI procedure and retry.
User Response: Respecify the number of
sqlcode: -1132
segments and try to create the database again.
sqlstate: 38003
SQL1136N An invalid value was specified for
SQL1133N A pointer address inside an sqlvar the default table space extent size
( index = “<n>” ) of the output (dft_extentsize) when creating a
SQLDA was modified within the database.
DARI (Stored Procedure)
Explanation: The value that was specified for
function.
the default table space extent size (dft_extentsize)
Explanation: The “sqlind” or the “sqldata” is out of range. The valid range is from 2 to 256.
pointer within the sqlvar of the output SQLDA
User Response: Correct the table space extent
has been altered within the user prepared DARI
size and try again.
function.
The stored procedure does not return any data.
SQL1137W The database manager was unable
User Response: Correct the usage of the to remove the database path or
indicated sqlvar within the output SQLDA so some of the containers when
that pointer addresses are not changed within dropping database ″<dbalias>″.
the DARI (Stored Procedure) function routine. Cleanup is required.
sqlcode: -1133 Explanation: Either the list of containers could
not be accessed or some failure occurred while
sqlstate: 39502
attempting to remove them or the database
directory.
SQL1134N For database authentication type
User Response: System managed containers
CLIENT, the command is not
(directories) and database managed file
allowed within the scope of DARI
containers may be manually removed using
(Stored Procedure).
operating system commands. To release device
Explanation: All SYSADM commands are not containers, please call your IBM service
allowed to execute within DARI (Stored representative for assistance.
Procedure) when the database authentication
If the log directory has been changed via the
type is CLIENT.
New Log Path configuration parameter, then
The stored procedure does not return any data. manually unmount the log directory file system
and remove the log and database directories.
The DARI procedure is not allowed to continue.
User Response: Remove the illegal command in
the DARI procedure and retry.

Chapter 2. SQL Messages 181

 limit specification table (RLST).
SQL1138W The unique index ″<name>″ was
migrated to support deferred This warning is also issued if DB2’s cost category
uniqueness checking. A new value was ″B″, and the default action specified in
index was not created. the RLF_CATEGORY_B column in the RLST is to
issue a warning.
Explanation: A CREATE INDEX operation was
attempted on an existing index. Since the index estimate_amount1
had not yet been migrated to support deferred The cost estimate (in processor seconds)
uniqueness checking, this migration was if the prepared INSERT, UPDATE,
performed. DELETE or SELECT statement were to
be executed.
The migrated format of the unique index will
allow multiple row updates to check the estimate_amount2
uniqueness of the columns of the index at the The cost estimate (in service units) if the
end of the update statement instead of when prepared INSERT, UPDATE, DELETE or
each row is updated. SELECT statement were to be executed.
User Response: No action is required. cost-category
DB2’s cost-category for this SQL
sqlcode: +1138
statement. The possible values are A or
sqlstate: 01550 B.
limit-amount
SQL1139N The total size of the table space is The warning threshold (in service units)
too big. specified in the RLFASUWARN column
of the RLST.
Explanation: The size of the current table space
is too big. The size of a REGULAR or USER
The prepare of the dynamic INSERT, UPDATE,
TEMPORARY table space is limited to 0xFFFFFF
DELETE, or SELECT statement was successful.
(16777215) pages while the size of a SYSTEM
An SQLCODE -905 might be issued if the
TEMPORARY or LONG table space is limited to
execution of the prepared statement exceeds the
2 tera bytes (2 TB).
ASUTIME value specified in the RLST.
User Response: Check the diagnostic log file
User Response: Ensure that there is application
db2diag.log for details. Reduce the size of the
logic to handle the warning to either allow the
table space and correct the SQL statement.
statement to execute or to stop the statement
sqlcode: -1139 from being executed. If this SQLCODE was
returned because the cost category value is ″B″, it
sqlstate: 54047
might be that the statement is using parameter
markers or that some statistics are not available
SQL1140W Estimated processor cost of for the referenced tables and columns. Make sure
″<estimate-amount1>″ processor the administrator has run the utility RUNSTATS
seconds (″<estimate-amount2>″ on the referenced tables. It might also be that
service units) in cost category UDFs will be invoked when the statement is
″<cost-category>″ exceeds a executed, or for INSERT, UPDATE, or DELETE
resource limit warning threshold statements that triggers are defined on the
of ″<limit-amount>″ service units. changed table. Check the
DSN_STATEMNT_TABLE or the IFCID 22 record
Explanation: The prepare of a dynamic INSERT, for this statement to find the reasons this SQL
UPDATE, DELETE, or SELECT SQL statement statement has been put in cost category ″B″.
resulted in a cost estimate that exceeded the
warning threshold value specified in the resource If the warning is caused by an SQL statement

182 Message Reference, Volume 2

that is consuming too much processor resource, User Response: Ensure that a valid address is
attempt to rewrite the statement to perform more used in the application program and the input
efficiently. Another option is to ask the string is null terminated.
administrator to increase the warning threshold
value in the RLST.
SQL1160N The DOS ″<network protocol>″
sqlcode: +1140 TSR has not been loaded.
sqlstate: 01616 Explanation: The Terminate and Stay Resident
(TSR) network driver for the specified
communications protocol has not been loaded.
SQL1145N PREPARE statement is not
The TSR must be loaded before attempting to
supported when using a gateway
use network communications.
concentrator. Reason code:
“<reason-code>”. User Response: Ensure that the TSR for the
specified communications protocol has been
Explanation: The statement failed for one of the
successfully loaded, then run your application
following reasons, based on “<reason-code>”.
again.
1 When gateway concentrator feature is
ON, dynamically prepared statements
SQL1163N The table cannot be enabled for
from embedded SQL are not supported.
data capture as the identifier
In this configuration, dynamically
name “<ident-name>” of type
prepared statements are only supported
“<ident-type>” is too long.
if the client is a CLI application.
Explanation: Data capture is not supported
2 When the gateway concentrator feature
with certain identifier types exceeding specific
is ON, dynamically prepared SET
lengths. In processing the attempted change, it
statements are not supported.
was found that the identifier “<ident-name>” of
User Response: Based on the reason code, type “<ident-type>” is too long. The identifier
perform the following actions: types and the maximum lengths allowed for data
capture enablement are as follows:
1 Change the application to use CLI for
dynamic SQL statements, or change the 1. column. Column names cannot be longer
application to use static SQL. than 18 bytes for data capture to be enabled.
2. table. Table names cannot be longer than 18
2 Use EXECUTE IMMEDIATE for SET bytes for data capture to be enabled.
statements.
3. schema. Schema names cannot be longer than
18 bytes for data capture to be enabled.
sqlcode: -1145
User Response: If data capture is to be enabled
sqlstate: 560AF for this table than ensure that the identifiers in
question do not exceed the maximum sizes
stated above. Otherwise disable data capture for
SQL1150N The address of the user id
the table in order to use longer indentifier
parameter is not valid.
names.
Explanation: The application program used an
sqlcode: -1163
address that is not valid for this parameter.
Either the address points to an unallocated buffer sqlstate: 42997
or the character string in the buffer does not
have a null terminator.
The command cannot be processed.

Chapter 2. SQL Messages 183

 5 An input varchar is supplied whose
SQL1164N The SQLDA or host variables, of
current length (from the length field of
type ″<type>″, used in the SQL
the varchar itself) is greater than the
statement are not valid. Reason
maximum length. The maximum length
code ″<reason-code>″, host
is determined by the declaration (in the
variable/SQLVAR number
case of a host variable) or by the setting
″<var-number>″.
of SQLVAR.SQLLEN (in the case of a
Explanation: An error occurred while user-defined SQLDA).
processing the SQLDA or host variable(s) in the
6 An input Large Object is passed in
SQL statement.
whose current length (either in the
The call parameter list, which is created by the length field of the LOB itself, or as
precompiler, may not be correct if the application indicated by the
programmer has modified the output of the SQLVAR2.SQLDATALEN pointer) is
precompiler, used a variable name beginning greater than the maximum length. The
with SQL in the application program, or maximum length is determined by the
over-written the call parameter list in another declaration (in the case of a host
way. variable) or by the setting of
SQLVAR2.SQLLONGLEN (in the case of
Also, if an SQLDA is passed directly by the
a user-defined SQLDA).
application, it may not be initialized correctly.
7 A double-byte character Large Object
Host variable/SQLDA types:
has an odd value indicated by the
1 input host variable(s) or SQLDA SQLVAR2.SQLDATALEN pointer, which
is always in terms of bytes, even for
2 output host variable(s) or SQLDA DBCLOBs.

In SQL statements with host variables, use the 8 The SQLDATA pointer is invalid or
host variable number to count in from the points to insufficient storage.
beginning of the statement (or substatement, in 9 The SQLIND pointer is invalid or points
the case of compound SQL) to locate the invalid to insufficient storage.
host variable. For statements using an SQLDA,
the SQLVAR number is used to locate the invalid 10 The SQLDATALEN pointer is invalid or
SQLVAR. For an input SQLDA, count only input points to insufficient storage.
host variables or SQLVARs; similarly for output.
11 A specific number of input host
Note that this number is based at 1, and may not
variables/SQLVARS is expected for the
be applicable to all reason codes. Reason codes
current SQL statement.
are interpreted as follows:
1 SQLDA.SQLN is less than The statement cannot be processed.
SQLDA.SQLD
User Response: Examine the application
2 SQLVAR.SQLTYPE is invalid. program for any errors noted. Note that the
programmer should not attempt to modify the
3 The length specified in
precompiler output.
SQLVAR.SQLLEN or
SQLVAR2.SQLLONGLEN is incorrect sqlcode: -1164
for the SQL type given in
sqlstate: 07002
SQLVAR.SQLTYPE.
4 A Large Object SQLVAR is present, but
the SQLDOUBLED field of
SQLDA.SQLDAID is not set to ’2’.

184 Message Reference, Volume 2

 warning may be returned with a row other than
SQL1165W A value cannot be assigned to a
the row which caused the warning. For example,
host variable because the value is
this occurs with arithmetic expressions in
not within the range of the host
predicates or when the query is processed using
variable’s data type.
system temporary tables. The warning may be
Explanation: A FETCH, VALUES, or SELECT issued again since it is also returned whenever a
into a host variable list failed because the host null indicator variable is set to -2.
variable was not large enough to hold the
The statement processing continued, using null
retrieved value.
as the result of the arithmetic expression and
The statement processing continued returning a possibly returning a null indicator of -2.
null indicator of -2.
User Response: Examine the SQL statement to
User Response: Verify that table definitions are determine the cause of the problem. If the
current and that the host variable has the correct problem is data dependent, it is necessary to
data type. For the ranges of SQL data types, refer examine the data processed when the error
to the SQL Reference. occurred. Refer to the SQL Reference to see the
valid ranges for the data types.
sqlcode: +1165
sqlcode: +1167
sqlstate: 01515
sqlstate: 01519
SQL1166W Division by zero was attempted.
SQL1178N The federated “<object-type>”
Explanation: The processing of an arithmetic
called “<object-name>” does not
expression resulted in division by zero. This
reference a nickname or OLE DB
warning may be returned with a row other than
table function.
the row which caused the warning. For example,
this occurs with arithmetic expressions in Explanation: The object of type “<object-type>”
predicates or when the query is processed using identified by “<object-name>” is defined using
system temporary tables. The warning may be the keyword FEDERATED but the fullselect in
issued again since it is also returned whenever a the statement does not reference a nickname or
null indicator variable is set to -2. an OLE DB table function.
The statement processing continued, using null The statement cannot be processed.
as the result of the division expression and
User Response: Remove the keyword
possibly returning a null indicator of -2.
FEDERATED from the statement.
User Response: Examine the SQL statement to
sqlcode: -1178
determine the cause of the problem. If the
problem is data dependent, it is necessary to sqlstate: 429BA
examine the data processed when the error
occurred.
SQL1179W The “<object-type>” called
sqlcode: +1166 “<object-name>” may require the
invoker to have necessary
sqlstate: 01564
privileges on data source objects.
Explanation: The object identified by
SQL1167W Arithmetic overflow or other
“<object-name>” references an OLE DB table
arithmetic exception occurred.
function or a nickname where the actual data
Explanation: The processing of an arithmetic exists at a data source. When the data source
expression has resulted in an arithmetic overflow, data is accessed, the user mapping and
underflow or other arithmetic exception. This

Chapter 2. SQL Messages 185

authorization checking is based on the user that Type mismatch (0x80020005):
initiated the operation. One or more of the SQL data types do
not match the data types of the method
If the “<object-type>” is SUMMARY TABLE,
arguments.
then the operation is refreshing the data for the
summary table. The user that invoked the Unknown name (0x80020006):
REFRESH TABLE or SET INTEGRITY statement The specified method name was not
that causes the refresh may be required to have found for the specified OLE object.
the necessary privileges to access the underlying
Invalid number of parameters (0x8002000E):
data source object at the data source.
The number of arguments passed to the
If the “<object-type>” is VIEW, then any user of method is different from the number of
the view may be required to have the necessary arguments accepted by the method.
privileges to access the underlying data source
Invalid class string (0x800401F3):
object at the data source.
The specified ProgID or CLSID is
In either case, an authorization error may occur invalid.
when the attempt is made to access the data
Class not registered (0x80040154):
source object.
CLSID is not properly registered.
User Response: Granting privileges to the view
Application not found (0x800401F5):
or summary table may not be sufficient to
Local server EXE not found.
support operations that access the data from the
data source. User access may need to be granted DLL for class not found (0x800401F8):
at the data source for the underlying data source In-process DLL not found.
objects of the view or summary table.
Server execution failed (0x80080005):
sqlcode: +1179 Creation of the OLE object failed.
sqlstate: 01639 User Response: Consult the OLE Programmer’s
Reference Guide for a complete documentation,
including the meaning of the special terminology.
SQL1180N Routine ″<routine-name>″
(specific name ″<specific-name>″) sqlcode: -1180
has caused an OLE error.
HRESULT=″<hresult>″. sqlstate: 42724
Diagnostic text: ″<message text>″.
Explanation: DB2 received an OLE error code SQL1181N Routine ″<routine-name>″
while trying to communicate with the OLE (specific name ″<specific-name>″)
automation server of user defined function has raised an exception with
(UDF) or stored procedure ″<routine-name>″ description ″<message text>″.
(specific name ″<specific-name>″). HRESULT Explanation: The user defined function (UDF)
″<hresult>″ is the returned OLE error code, and or stored procedure ″<routine-name>″ (specific
″<message text>″ is the retrieved error message. name ″<specific-name>″) has raised an exception.
The following shows a partial list of error The message text shows the textual description
messages, HRESULTS, and possible causes. The of the exception returned by the routine.
error message text may be changed by OLE, and User Response: The user will need to
new error codes may be added by OLE. understand the meaning of the exception. See the
Unknown interface (0x80020001): author of the routine.
The specified OLE object does not sqlcode: -1181
support the IDispatch interface.
sqlstate: 38501

186 Message Reference, Volume 2

 0x80040E14
SQL1182N User defined function
The command contained one or more
“<function-name>” could not
errors, e.g. syntax error in pass-through
initialize data source object of
command text.
specified OLE DB provider.
HRESULT=“<hresult>”. 0x80040E21
Diagnostic text: “<message-text>”. Errors occurred, e.g. the supplied
columnID was invalid
Explanation: The OLE DB data source object of
(DB_INVALIDCOLUMN).
the specified OLE DB provider could not be
instantiated or initialized. “<hresult>” is the 0x80040E37
returned OLE DB error code, and The specified table does not exist.
“<message-text>” is the retrieved error message.
User Response: Consult Microsoft OLE DB
The following shows a partial list of HRESULTS Programmer’s Reference and Data Access SDK
and possible causes. for a complete documentation of HRESULT
codes.
0x80040154
Class (OLE DB provider) not registered. sqlcode: -1183
0x80040E73 sqlstate: 38506
The initialization string specified does
not conform to specificiation.
SQL1184N One or more EXPLAIN tables
0x80004005 were not created using the current
Unspecified error (during initialization). version of DB2.
User Response: Verify proper registration of the Explanation: EXPLAIN will not be able to insert
OLE DB provider and correct initialization of the into these tables until they are migrated using
parameters in the connection string. Consult DB2EXMIG, or dropped and created with the
Microsoft OLE DB Programmer’s Reference and EXPLAIN.DDL CLP script for the current version
Data Access SDK for a complete documentation of DB2.
of HRESULT codes and Data Link API
connection string syntax in OLE DB Core User Response: Either migrate the tables using
Components. DB2EXMIG, or drop and re-create them with the
EXPLAIN.DDL CLP script for the current version
sqlcode: -1182 of DB2. Re-issue the command.
sqlstate: 38506 sqlcode: -1184
sqlstate: 55002
SQL1183N User defined function
“<function-name>” received an
OLE DB error from specified OLE SQL1185N FEDERATED “<value>” is
DB provider. incorrectly used in binding the
HRESULT=“<hresult>”. package.
Diagnostic text: “<message-text>”. Explanation: If “<value>” is NO, then at least
Explanation: The specified OLE DB provider one static SQL statement in the package includes
returned an OLE DB error code. “<hresult>” is a reference to either a nickname or OLE DB table
the returned OLE DB error code, and function or OLE DB procedure. In this case, you
“<message-text>” is the retrieved error message. must specify FEDERATED YES to bind the
package.
The following shows a partial list of HRESULTS
and possible causes. If “<value>” is YES, then no static SQL statement
in the package includes a reference to either a

Chapter 2. SQL Messages 187

nickname or OLE DB table function or OLE DB User Response: Specify the correct
procedure. In this case, you must specify FEDERATED option.
FEDERATED NO to bind the package.
The package is not created.

SQL1200 - SQL1299

SQL1200N The object parameter is not valid. SQL1202N Status has not been collected.
Explanation: The value specified for the object Explanation: The value specified for the handle
parameter in the COLLECT DATABASE STATUS parameter in the GET NEXT DATABASE
function call is not valid. Valid values are: STATUS BLOCK or the FREE DATABASE
STATUS RESOURCES function calls is not valid.
SQLE_DATABASE
The handle must be the one returned as the
Status is to be collected for a single
positive function value from the COLLECT
database.
DATABASE STATUS function call.
SQLE_DRIVE
This is the second COLLECT DATABASE
Status is to be collected for all LOCAL
STATUS call made from the process. The first
databases on a single path.
COLLECT DATABASE STATUS call terminates
SQLE_LOCAL and its handle can no longer be used.
Status is to be collected for all LOCAL
The command cannot be processed.
databases.
User Response: Correct the handle parameter
The command cannot be processed. and resubmit the COLLECT DATABASE STATUS
function call.
User Response: Correct the object parameter
and resubmit the COLLECT DATABASE STATUS
function call. SQL1203N The database has no users
connected.

SQL1201N The status parameter is not valid. Explanation: A request was made for user
status on a database, but the database has no
Explanation: The value specified for the status users connected.
parameter in the COLLECT DATABASE STATUS
function call is not valid. Valid values are: The command cannot be processed.

SQLE_SYSTEM User Response: Verify the database name and

System status is to be collected. the connection status. Resubmit the command
with a database currently being used.
SQLE_DATABASE
System status and database status is to
be collected. SQL1204N The code page “<code page>”
and/or country code “<country
SQLE_ALL code>” is not supported by the
System status, database status and user installed version of the database
status is to be collected. manager.

The command cannot be processed. Explanation: This version of the database

manager does not support the active code page
User Response: Correct the status parameter or country code or both.
and resubmit the COLLECT DATABASE STATUS
function call. The command cannot be processed.

188 Message Reference, Volume 2

Choose an active code page and country code
SQL1207N Communication Manager
supported by this version of the database
configuration file “<name>”
manager.
cannot be found.
Federated system users: if necessary isolate the
Explanation: The Communication Manager
problem to the data source rejecting the request
configuration file name specified on the
(see the Troubleshooting Guide for procedures to
CATALOG NODE command was not found
follow to identify the failing data source) and
either in the path specified or in the CMLIB
choose an active code page and country code
directory on the default drive.
supported by both the federated server and the
data source. The command cannot be processed.
User Response: Exit the current program and User Response: Resubmit the command with
return to the operating system. the correct configuration file name and path.
sqlcode: -1204
SQL1209W The partner_lu name “<name>”
sqlstate: 22522
specified in the CATALOG NODE
function does not exist. One was
SQL1205N The code page “<code page>” created.
and/or country code “<country>”
Explanation: The logical partner unit name
that has been specified is not
specified in the CATALOG NODE function does
valid.
not exist in the Communications Manager
Explanation: This version of DB2 does not configuration file located in the CMLIB directory
support the active code page or country code or on the default drive.
both, as specified by the Create Database
A logical unit profile of the specified name was
command.
created.
The command cannot be processed.
User Response: No action is required.
User Response: Refer to the Create Database
command in the Command Reference for details of
SQL1210W Default values were returned for
valid code page and country code pairs
one or more DOS
supported by DB2/2.
Requester/WINDOWS Requester
configuration file parameters.
SQL1206N PRUNE LOGFILE is not
Explanation: One or more of the DOS
supported in this database
Requester/WINDOWS Requester configuration
configuration.
values returned was defaulted. The parameter
Explanation: The PRUNE LOGFILE request is may not be defined in the DOS
not supported if: Requester/WINDOWS Requester configuration
1. both LOGRETAIN and USEREXIT are set to file or the configuration file could not be opened
NO, or or an error occurred reading the file.

2. the active logfile path is set to a raw device. User Response: Ensure that the DOS
Requester/WINDOWS Requester configuration
User Response: Do not issue the PRUNE file exists in the appropriate path and that the
LOGFILE command for this database. parameters are explicitly defined.

Chapter 2. SQL Messages 189

 for the CATALOG command is not valid.
SQL1211N The computer name ″<name>″ is
not valid. The TP name is the remote SNA Application TP
name and must be 1 to 64 characters. Valid
Explanation: The computer name specified in
characters are A through Z, a through z, 0
the NPIPE protocol structure for the Catalog
through 9, #, @, and $. The first character must
command is not valid. The size of the computer
be alphabetic or a special character: #, @, or $.
name must be 15 characters or less.
The command cannot be processed.
The command cannot be processed.
User Response: Verify the characters specified
User Response: Verify that the computer name
in the TP name.
is valid and resubmit the command.
Resubmit the command with a TP name.
SQL1212N The instance name ″<name>″ is
not valid. SQL1215N The LAN adapter address
“<address>” is not valid.
Explanation: The instance name specified for
the Catalog command is not valid. The size of Explanation: The LAN adapter address
the instance name must be 8 characters or less. specified in the APPN protocol structure for the
CATALOG command is not valid.
The command cannot be processed.
The LAN adapter address is the remote SNA
User Response: Verify that the instance name is
LAN adapter address and must be a
valid and resubmit the command.
12-hexadecimal number.
The command cannot be processed.
SQL1213N The change password LU name
“<name>” is not valid. User Response: Verify the LAN adapter
address.
Explanation: The change password logical unit
(LU) name specified in the APPN protocol Resubmit the command with a valid LAN
structure for the CATALOG command is not adapter address.
valid.
The change password LU name is the remote SQL1216N Graphic data and graphic
SNA LU name and must be 1 to 8 characters. functions are not supported for
Valid characters are A through Z, a through z, 0 this database.
through 9, #, @, and $. The first character must
be alphabetic or a special character: #, @, or $. Explanation: The code page of the database
Lowercase characters are changed to uppercase does not support graphic data. The data types
by the system. GRAPHIC, VARGRAPHIC, and LONG
VARGRAPHIC are not valid for this database.
The command cannot be processed. The GRAPHIC literal and the VARGRAPHIC
scalar functions are not valid for this database.
User Response: Verify the characters specified
in the change password LU name. The statement cannot be processed.
Resubmit the command with a valid change Federated system users: this situation can also be
password LU name. detected by the data source.
User Response: Resubmit the command with
SQL1214N The transaction program name valid data types.
“<name>” is not valid.
sqlcode: -1216
Explanation: The transaction program (TP)
name specified in the APPN protocol structure sqlstate: 56031

190 Message Reference, Volume 2

 sqlstate: 57011
SQL1217N The REAL data type is not
supported by the target database.
SQL1219N The request failed because private
Explanation: An SQL operation is using a data
virtual memory could not be
type of REAL (single-precision floating point
allocated.
number) as an input or output variable. The
REAL data type is not supported on the target Explanation: The instance was unable to
database for this request. allocate enough private virtual memory to
process the request. This may be a result of
The statement is not processed.
shared memory allocations made in other
User Response: Replace the declaration of any (unrelated) processes.
host variable that corresponds to the SQL data
User Response: The problem may be corrected
type of REAL with a declaration that
by:
corresponds to an SQL data type of DOUBLE in
your application. v On OS/2, increasing the min_priv_mem
configuration parameter. This will result in
sqlcode: -1217 more private virtual memory being reserved
sqlstate: 56099 when the instance is started.
v Stopping other applications running on the
machine, especially those that use large
SQL1218N There are no pages currently
amounts of shared memory.
available in bufferpool
″<buffpool-num>″. sqlcode: -1219
Explanation: All of the pages in the bufferpool
sqlstate: 57011
are currently being used. A request to use
another page failed.
SQL1220N The database manager shared
The statement cannot be processed.
memory set cannot be allocated.
User Response: The bufferpool is not large
Explanation: The database manager could not
enough to provide pages to all database
allocate its shared memory set. The cause of this
processes or threads at this time. The bufferpool
error may be insufficient memory resources
is too small or there are too many active
either for the database manager or the
processes or threads.
environment in which its operation is being
The statement may be successful if executed attempted. Memory resources that can cause this
again. If this error occurs frequently, some or all error include:
of the following actions may prevent further v The number of shared memory identifiers
failures: allocated in the system
1. increase the bufferpool size v The amount of paging or swapping space
2. decrease the maximum number of database available in the system
agents and/or connections v The amount of physical memory available in
3. decrease the maximum degree of parallelism the system
4. decrease the prefetch size for table spaces that User Response: One or more of the following:
are in this bufferpool
v Validate that sufficient memory resources are
5. move some table spaces into other available to satisfy the database manager’s
bufferpools. requirements, and those of the other programs
sqlcode: -1218 running on the system.

Chapter 2. SQL Messages 191

v Reduce database manager’s memory sqlstate: 57011
requirement for this memory set by reducing
the database manager configuration
SQL1223N An agent could not be started to
parameters which affect it. These are:
service this request.
maxagents, maxdari and, numdb.
v Where appropriate, stop other programs using Explanation: The request failed because the
the system. maxagents configuration parameter limit would
be exceeded.

SQL1221N The Application Support Layer User Response: Increase the maxagents
heap cannot be allocated. configuration parameter, and/or reduce the
number of users using the database.
Explanation: The Application Support Layer
heap could not be allocated. The cause of this sqlcode: -1223
error may be insufficient memory resources sqlstate: 57019
either for the database manager or the
environment in which its operations are being
attempted. Memory resources that can cause this SQL1224N A database agent could not be
error include: started to service a request, or was
v The number of shared memory identifiers terminated as a result of a
allocated in the system database system shutdown or a
force command.
v The amount of paging or swapping space
available in the system Explanation: The message may be attributed to
v The amount of physical memory available in any of the following cases.
the system v The database manager has not been started on
the database server
User Response: One or more of the following:
v The database manager was stopped
v Validate that sufficient memory resources are
available to satisfy the database manager’s v The database manager has already allocated
requirements, and those of the other programs the maximum number of agents
running on the system. v The database agent was forced off by the
v Reduce the aslheapsz configuration parameter. system administrator

v Where appropriate, stop other programs using v The database agent was terminated due to an
the system. abnormal termination of a key database
manager process
sqlcode: -1221 v The application is using multiple contexts with
local protocol. In this case the number of
sqlstate: 57011 connections is limited by the number of shared
memory segments to which a single process
SQL1222N Not enough storage is available in can be attached. For example, on AIX, the limit
the Application Support Layer is ten shared memory segments per process.
heap to process the request. Additional federated server cases are:
Explanation: All available memory in the v The maximum number of processes per user
Application Support Layer heap has been used. (maxuproc on AIX) at the operating system
level has been exceeded.
User Response: Increase the aslheapsz
configuration parameter. v In the client/server environment using the
TCP/IP protocol, the port number assigned to
sqlcode: -1222 the TCP/IP service name on the client is not
the same as the port number on the server.

192 Message Reference, Volume 2

This situation can be detected by federated to increase the number of shared memory
server or by the data source. segments to which a single process can be
attached.
User Response: Reissue the database request. If
a connection cannot be established, then ensure
sqlcode: -1224
that the database manager has been started
successfully. Additionally, ensure that the
maxagents database manager configuration sqlstate: 55032
parameter is appropriately configured.
Federated system users, should also: SQL1225N The request failed because an
operating system process, thread,
v Isolate the problem to the data source rejecting or swap space limit was reached.
the request (see the Troubleshooting Guide for
procedures to follow to identify the failing Explanation: An operating system process,
data source) and ensure that the thread, or swap space limit was reached. On
communication subsystem is active and that UNIX-based systems, this may mean that the
the database manager and required maxuproc value is too low. On OS/2-based
communication protocol server processes have systems, this may mean that the THREADS
been started on the database server. CONFIG.SYS value is too low.
v For AIX operating systems, check the setting of User Response: Increase the limit which was
maxuproc and change it if needed. maxuproc reached (or have your system administrator
restricts the number of processes that can run increase it). On UNIX-based systems, the
under a given federated server. The default maxuproc limit can be changed with the chdev
setting is 40. command.
You can check the current setting of maxuproc
sqlcode: -1225
with the command:
. sqlstate: 57049
lsattr -E -l sys0
SQL1226N The maximum number of
To view the number of processes currently coordinating agents are already
running under a given federated server, use started.
the command:
Explanation: The number of coordinating
ps -ef | grep instdj1 | wc -l
agents started is already equal to the maximum
value defined in the system configuration file.
where “instdj1” is the instance name of the
federated server. The statement cannot be processed.
User Response: Wait for other applications to
To change maxuproc, use the command:
disconnect from the database. If one or more
chdev -l sys0 -a maxuproc='nn' applications are required to run concurrently,
increase the value for max_coordagents. The new
where nn is the new integer value of value takes effect after the next successful
maxuproc. database manager start.
If the application is using multiple contexts with sqlcode: -1226
local protocol, then either reduce the number of
connections in the application, or switch to sqlstate: 57030
another protocol (for example, TCP/IP). For
users on AIX version 4.2.1 or newer, the
environment variable EXTSHM can be set to ON

Chapter 2. SQL Messages 193

 v buffer size entries of
SQL1227N The catalog statistic ″<value>″ for
PAGE_FETCH_PAIRS must be
column ″<column>″ is out of
ascending in value. Also, any buffer
range for its target column, has an
size value in a PAGE_FETCH_PAIRS
invalid format, or is inconsistent
entry cannot be greater than MIN(
in relation to some other statistic.
NPAGES, 524287) where NPAGES is
Reason Code = ″<code>″
the number of pages in the
Explanation: The value or format of a statistic corresponding table.
provided for an updateable catalog is either v ″fetches″ entries of
invalid, out of range, or inconsistent. The most PAGE_FETCH_PAIRS must be
common checks for value, range and format are descending in value, with no
(corresponding to ″<code>″): individual fetches entry being less
1 Numeric statistics must be -1 or >= 0. than NPAGES. Also, any ″fetch″ size
value in a PAGE_FETCH_PAIRS entry
2 Numeric statistics representing must not be greater than CARD
percentages (eg. CLUSTERRATIO) must (cardinality) statistic of the
be between 0 and 100. corresponding table.
3 HIGH2KEY, LOW2KEY related rules : v If buffer size value is the same in two
v The datatype of any HIGH2KEY, consecutive pairs, then page fetch
LOW2KEY value must be the same as value must also be the same in both
the datatype of the corresponding the pairs.
user column. 5 CLUSTERRATIO and
v The length of HIGH2KEY, LOW2KEY CLUSTERFACTOR related rules :
value must be the smaller of 33 or the v Valid values for CLUSTERRATIO are
target column’s datatype’s maximum -1 or between 0 and 100
length.
v Valid values for CLUSTERFACTOR
v HIGH2KEY must be > LOW2KEY are -1 or between 0 and 1
whenever there are 3 or more distinct
v Either CLUSTERRATIO or
values in the corresponding column.
CLUSTERFACTOR must be -1 at all
In the case of less than 3 distinct
times.
values in the column, HIGH2KEY can
be equal to LOW2KEY. v If CLUSTERFACTOR is a positive
value, it must be accompanied by a
4 PAGE_FETCH_PAIRS related rules : valid PAGE_FETCH_PAIR statistic.
v Individual values in the
6 The cardinality of a column (COLCARD
PAGE_FETCH_PAIRS statistic must
statistic in SYSCOLUMNS) cannot be
be separated by a series of blank
greater than the cardinality of its
delimiters.
corresponding table (CARD statistic in
v Individual values in SYSTABLES).
PAGE_FETCH_PAIRS statistics must
not be longer than 10 digits and must 7 No statistics are supported for columns
be less than the maximum integer with the following data types: LONG
value (MAXINT = 2147483647). VARCHAR, LONG VARGRAPHIC,
BLOB, CLOB, DBCLOB, or user-defined
v There must always be a valid
structured types.
PAGE_FETCH_PAIRS value if the
CLUSTERFACTOR is > 0. 8 A statistic is inconsistent with other
v There must be exactly 11 pairs in a related statistics for this entity or is
single PAGE_FETCH_PAIR statistic invalid in this context.

194 Message Reference, Volume 2

User Response: Make sure the new catalog again with the ″continue″ option will
statistic satisfies the above range/length/format restart the operation from the point
checks. of failure.
Make sure that any updates to statistics are Rollforward
consistent in their inter-relationships (eg. The operation is aborted and the
cardinality). database is still in rollforward
pending state. The command must
sqlcode: -1227
be resubmitted.
sqlstate: 23521
Backup/Restore
The operation is aborted and must
SQL1228W DROP DATABASE has completed be resubmitted.
but the database alias name or 2. The service port numbers assigned for FCM
database name ″<name>″ could (Fast Communication Manager)
not be found on ″<num>″ nodes. communications are not the same on all
Explanation: The drop database command has nodes in the DB2 instance. Check the services
completed successfully, however, there are some file being used on all nodes to ensure that the
nodes where the database alias or database name ports are the same. The ports are defined
was not found. It is possible that DROP using the format:
DATABASE AT NODE was already performed DB2_<instance> xxxx/tcp
on these nodes. DB2_<instance>_END xxxx/tcp

User Response: This is a warning message only. where <instance> is the DB2 instance name
No response is necessary. and xxxx is the port number Ensure that
these port numbers are not being used for
SQL1229N The current transaction has been DB2 remote client support.
rolled back because of a system User Response:
error.
1. Try the request again. If the error persists,
Explanation: One of the following has occurred: you can find more information about the
1. A system error, such as node failure or problem in the db2diag.log file. It may be
connection failure, has occurred. The necessary to contact the system administrator
application is rolled back to the previous for assistance since the most common reason
COMMIT. for this error is that a node has failed.
Note that in the case of DB2 utility functions, Note that in an SP environment where the
the behavior is described below: high speed switch is used, this error can be a
symptom of a failure in the high speed
Import The application is rolled back. If the switch.
COMMITCOUNT parameter was
2. Update the service ports to be the same on all
used, the operation is rolled back to
nodes and try the request again.
a previous committed point.
The sixth sqlerrd field of the SQLCA will
Reorg The operation is aborted and must
indicate the node number that detected the node
be resubmitted.
failure. On the node that detected the failure a
Redistribute message will be placed in the db2diag.log that
The operation is aborted, however, identifies the failed node.
some of the operation may have
been successful. Issuing the request sqlcode: -1229

Chapter 2. SQL Messages 195

sqlstate: 40504
SQL1233N The use of this clause or scalar
function is supported only for
SQL1230W At least one agent id specified graphic data that is UCS-2.
could not be forced.
Explanation: UCS-2 is not supported for this
Explanation: At least one agent id specified on database. The support of UCS-2 is required for
the Force command could not be forced. Causes the following:
of this warning may be: v Specifying a graphic string expression as the
v A nonexistent or invalid agent id was first argument of the VARCHAR scalar
specified. function
v The agent disconnected from the database v Specifying a character string expression as the
manager between the time that the agent ids first argument of the VARGRAPHIC scalar
were collected and the Force command was function when a second argument is specified
issued. v Specifying a UCS-2 hexadecimal constant
v The agent id specified was for a parallel agent using the format UX’hex-digits’
(exists on DB2 Enterprise - Extended Edition
The statement cannot be processed.
only) which cannot be forced.
User Response: Resubmit the command with
User Response: If a nonexistent or invalid agent
valid data types.
id was specified, retry the command using the
valid agent id. sqlcode: -1233
sqlstate: 560AA
SQL1231N Invalid Force count specified.
Explanation: The value specified for the count SQL1240N The maximum number of
parameter of the Force command is not valid. quiescers has been reached.
The value specified must either be a positive
Explanation: An attempt was made to acquire a
integer or SQL_ALL_USERS. A value of 0 will
quiesce state on a table space which has already
result in an error.
been quiesced by 5 processes.
User Response: Correct the value of count and
User Response: Wait for one of the processes to
resubmit the command.
release its quiesce state and try again.

SQL1232N Invalid Force mode specified.

SQL1241N An invalid value was specified for
Explanation: The value specified for the mode the ″<tbs-name>″ table space
parameter of the Force command is not valid. definition when creating a
Only asynchronous mode is supported for the database. Attribute is ″<string>″.
Force command. The parameter must be set to
Explanation: The value for a table space
the value SQL_ASYNCH.
attribute was out of range. See the Data
User Response: Set the mode to SQL_ASYNCH Structures section of Application Development
and resubmit the command. Guide for the format of the sqletsdesc structure
used for the create database api. The identified
attribute is the field name of this structure.
User Response: Correct the create database
request.

196 Message Reference, Volume 2

 containing embedded SQL, and the connection
SQL1244W Disconnect for transaction
management was not invoked using the CLI
manager database
APIs.
“<database-name>” will occur at
next COMMIT. User Response: Possible actions:
Explanation: A disconnect has been issued v Ensure that the application disconnects from
against a database which is acting as the TM all servers before attempting to issue the SET
database. The disconnect cannot be completed CLIENT API (sqlesetc or sqlgsetc) or CLP
until the next COMMIT is processed. command.
v Ensure that all connection management
User Response: If it is necessary that the
requests are issued via the DB2 Call Level
database which is acting as the TM database be
Interface APIs if CLI is being used by the
disconnected immediately, issue a COMMIT
application.
statement before execution continues.
sqlcode: +1244
SQL1247N Applications running in an XA
sqlstate: 01002 transaction processing
environment must use the
SYNCPOINT TWOPHASE
SQL1245N Connection limit has been
connection setting.
reached. No more connections are
allowed from this client. Explanation: The application was precompiled
with the option SYNCPOINT ONEPHASE or
Explanation: The maximum number of
SYNCPOINT NONE, or the SYNCPOINT
concurrent database connections has been
connection setting was changed to one of these
reached for an environment where the number of
values using the SET CLIENT API. These settings
connections is restricted or must be predefined.
are invalid for applications which cause
The primary example of where this would occur
transaction processing syncpoint commands (for
is when the NETBIOS protocol is being used.
example CICS SYNCPOINT) to be executed.
User Response: Possible actions: Note that SYNCPOINT ONEPHASE is the
v Use the SET CLIENT command or API to set default precompiler option.
the MAX NETBIOS CONNECTIONS field to User Response: Possible actions:
the maximum number of concurrent
v Re-precompile the application using the
connections required. This must be done
precompiler option SYNCPOINT TWOPHASE.
before any connections are made.
v Modify the program such that the SET
sqlcode: -1245 CLIENT API is called to set the connection
option to SYNCPOINT TWOPHASE prior to
sqlstate: 08001 any other processing.
sqlcode: -1247
SQL1246N Connection settings cannot be
changed while connections exist. sqlstate: 51025
Explanation: One of the following occurred:
v An attempt was made to change the SQL1248N Database “<database alias>” not
connection settings for an application using defined with the transaction
the SET CLIENT API. This was rejected manager.
because one or more connections exist.
Explanation: You attempted to access a
v The application contains both DB2 Call Level database that had not been opened by the
Interface API calls and calls to functions transaction manager. A database must be defined

Chapter 2. SQL Messages 197

to the transaction manager in order to participate
SQL1261N Database ″<name>″ is not in
in the two-phase commit process.
rollforward pending state on
User Response: Define the database as a node(s) ″<node-list>″, so it does
resource manager to the transaction manager of not need to be rolled forward on
your Distributed Transaction Processing these nodes.
environment. For example, in a CICS
Explanation: The specified database is not in
environment this requires adding the database to
roll-forward pending state on the specified
the XAD file and provides the database alias
node(s). This may be because the database has
name in the XAOpen string of the XAD entry.
not been restored, or was restored with the
sqlcode: -1248 WITHOUT ROLLING FORWARD option, or
roll-forward recovery is complete on these nodes.
sqlstate: 42705
If ″,...″ is displayed at the end of the node list,
see the diagnostic log for the complete list of
SQL1251W No data returned for heuristic nodes.
query.
The database is not rolled forward.
Explanation: There are no in-doubt transactions
in the database, nor any transactions that have (Note : if you are using a partitioned database
ended and are waiting to enter the syncpoint server, the node number(s) indicate which
process. node(s) the error occurred on. Otherwise, it is
not pertinent and should be ignored.)
User Response: No action is required.
User Response: Do the following:

SQL1260N Database “<name>” is not 1. Ensure that recovery is required on the

configured for roll-forward specified node(s).
recovery on node(s) “<node-list>”. 2. Restore a backup version of the database on
these nodes.
Explanation: The specified database is not
configured for roll-forward recovery on the 3. Issue the ROLLFORWARD DATABASE
specified node(s). If ″,...″ is displayed at the end command.
of the node list, see the diagnostic log for the
complete list of nodes. SQL1262N The point-in-time specified for
The database is not rolled forward on the rolling forward database
specified node(s). “<name>” is not valid.

(Note : if you are using a partitioned database Explanation: The timestamp parameter
server, the node number(s) indicate which specified for the point-in-time stopping value is
node(s) the error occurred on. Otherwise, it is not valid. The timestamp must be entered in ISO
not pertinent and should be ignored.) format (YYYY-MM-DD-hh.mm.ss.<ssssss> where
YYYY represents year, MM represents month,
User Response: Ensure that recovery is required DD represents day, hh represents hours, mm
on the specified node(s), then restore the most represents minutes, ss represents seconds, and
recent backup version of the database on these ssssss represents optional microseconds).
nodes.
The database is not rolled forward.
User Response: Ensure that the timestamp is
entered in the correct format.
When you issue a ROLLFORWARD DATABASE

198 Message Reference, Volume 2

command, ensure that you are not specifying a database log directory or, if the database is in a
year greater than 2105. consistent state, change the log path to point to
the correct archive file and issue the
ROLLFORWARD DATABASE command again.
SQL1263N The archive file “<name>” is not
Alternatively, resubmit the command with the
a valid log file for database
overflow log path pointing to the correct archive
“<name>” on node
file.
“<node-number>”.
Explanation: The specified archive log file exists
SQL1265N The archive log file “<name>” is
in the database log directory or the overflow log
not associated with the current log
directory on the specified node, but the file is not
sequence for database “<name>”
valid.
on node “<node-number>”.
Roll-forward recovery processing stops.
Explanation: For roll-forward recovery, the log
(Note : if you are using a partitioned database files need to be processed in correct sequence.
server, the node number indicates which node The log file sequence is determined by the
the error occurred on. Otherwise, it is not database that has been restored or the log files
pertinent and should be ignored.) that have been processed. In addition to this, for
table space level roll-forward recovery, the log
User Response: To determine the correct files must be processed in the sequence through
archive log file, issue the ROLLFORWARD which the current state of the database has been
DATABASE command with the QUERY STATUS reached. The specified archive log file was found
option. Move the correct archive log file into the in the log directory or the overflow log path for
database log directory or, if the database is in a the database on the specified node but the log
consistent state, change the log path to point to file is not in the correct log sequence.
the correct archive file, and issue the
ROLLFORWARD DATABASE command again. Roll-forward recovery processing stops.
Alternatively, resubmit the command with the
(Note : if you are using a partitioned database
overflow log path pointing to the correct archive
server, the node number indicates which node
file.
the error occurred on. Otherwise, it is not
pertinent and should be ignored.)
SQL1264N The archive file “<name>” does
User Response: To determine the correct
not belong to database
archive log file, issue the ROLLFORWARD
“<database-name>” on node
DATABASE command with the QUERY STATUS
“<node-number>”.
option. Move the correct archive log file into the
Explanation: The archive log file specified was database log directory or, if the database is in a
found in the log directory or the overflow log consistent state, change the log path to point to
directory but does not belong to the specified the correct archive file and issue the
database. ROLLFORWARD DATABASE command again.
Alternatively, resubmit the command with the
Roll-forward recovery processing stops. overflow log path pointing to the correct archive
(Note : if you are using a partitioned database file.
server, the node number indicates which node
the error occurred on. Otherwise, it 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

Chapter 2. SQL Messages 199

 User Response: See the user exit documentation
SQL1266N Database “<name>” has been
in the Administration Guide for a description of
rolled forward to “<timestamp>”,
the error and resume or terminate roll-forward
which is past the specified
recovery.
point-in-time.
Explanation: Roll-forward is requested to stop
SQL1269N Table space level roll-forward
at a timestamp that is before the current point in
recovery is already running.
time in the specified database log file. This can
happen when rolling forward either the database Explanation: An attempt has been made to use
or a subset of table spaces to a point in time. table space level roll-forward recovery but it is
already running. Only one agent can be
Database roll-forward processing stops.
executing roll-forward recovery at any given
User Response: Specify the correct point in time time.
or restore the database or table space subset from
User Response: Wait until table space level
a backup version and resubmit the
roll-forward recovery is complete. If more table
ROLLFORWARD command.
spaces need recovery, initiate table space level
roll-forward recovery again.
SQL1267N The system could not find
db2uexit in the current PATH
SQL1270C The LANG environmental
environment variable.
variable is set to “<string>”. This
Explanation: The user-supplied file db2uexit language is not supported.
cannot be found, either because it is not in the
Explanation: The LANG environmental variable
current PATH environment variable or it does
is set to a language that is not supported by the
not exist.
database manager. Processing cannot continue.
The command cannot be processed.
User Response: Set the LANG environmental
User Response: Update the current PATH variable to a language that is supported. For
environment variable to include the path to more information please refer to “National
db2uexit or create a db2uexit file and update the Language Support” appendix in the
current PATH environment variable if necessary. Administration Guide.
Federated system users: see the Installation and
SQL1268N Roll-forward recovery stopped Configuration Supplement for NLS information.
due to error “<error>” while
retrieving log file “<logfile>” for
SQL1271W Database ″<name>″ is recovered
database “<name>” on node
but one or more table spaces are
“<node-number>”.
off-line on node(s) ″<node-list>″.
Explanation: Roll-forward processing invokes
Explanation: This message can occur after crash
db2uext2 to retrieve the log file. The error may
recovery, database level roll-forward recovery, or
have occurred in db2uext2.
table space level roll-forward recovery. For
Roll-forward processing stopped. The database is database level roll-forward recovery, the database
still in a roll forward pending state on the is available for use if the STOP option was
specified node. specified. One or more table spaces on the
specified node(s) are not available. This could
(Note : if you are using a partitioned database
happen if:
server, the node number indicates which node
the error occurred on. Otherwise, it is not v the STOP option is not specified for a table
pertinent and should be ignored.) space level roll-forward recovery to a point in
time.

200 Message Reference, Volume 2

v one or more table spaces receive errors during changes to one of the table spaces being rolled
recovery. forward. This transaction could be an indoubt
v additional table spaces are restored while a transaction.
table space level roll-forward recovery is v The table space level roll-forward was
already in progress. interrupted and, before it was resumed, all
v the database is rolled forward past a previous table spaces that were being rolled forward are
point-in-time table space roll-forward, causing restored again.
all table spaces involved to be placed in If ″,...″ is displayed at the end of the node list,
restore pending state. see the diagnostic log for the complete list of
The table spaces that are off-line can be nodes.
identified on the specified node(s) by the LIST
TABLESPACES command or the db2dart utility. (Note : if you are using a partitioned database
The diagnostic log will provide more information server, the node number(s) indicate which
on specific table spaces. node(s) the error occurred on. Otherwise, it is
not pertinent and should be ignored.)
If ″,...″ is displayed at the end of the node list, User Response: Check the diagnostic log for the
see the diagnostic log for the complete list of cause. Do one of the following depending on the
nodes. cause:
v Use the LIST TABLESPACES command to
(Note : if you are using a partitioned database
determine if the table spaces received I/O
server, the node number(s) indicate which
errors. If so, repair them.
node(s) the error occurred on. Otherwise, it is
not pertinent and should be ignored.) v If the transaction table became full, include the
MAXAPPLS database configuration parameter
User Response: Repair or restore the table or try running table space level roll-forward
spaces if necessary and run roll-forward recovery offline.
recovery. If the same error occurs, try running
v If the cause is an active or indoubt transaction,
table space level roll-forward recovery offline.
complete the transaction.
v If the table spaces were restored after a
SQL1272N Table space level roll-forward previous table space level roll forward was
recovery for database ″<name>″ interrupted, the previous table space level
has stopped before completion on roll-forward is now canceled. The next table
node(s) ″<node-list>″. space level roll-forward command will check
Explanation: Table space level roll-forward for table spaces in rollforward pending state.
recovery has stopped on the specified node(s) Run table space level roll-forward recovery
before all qualifying table spaces could be rolled again.
forward. This can be cause by one of the
following:
SQL1273N Roll-forward recovery on database
v The transaction table is full.
″<name>″ cannot reach the
v All table spaces being rolled forward received specified stop point (end-of-log or
I/O errors. point-in-time) because of missing
v Point-in-time table space level roll-forward log file ″<name>″ on node
encountered an I/O error on one of the table ″<node-number>″.
spaces being rolled forward.
Explanation: The Rollforward Database utility
v Point-in-time table space level roll-forward cannot find the specified archive log file in the
encountered an active transaction that made database log directory or the overflow log
directory on the specified node.

Chapter 2. SQL Messages 201

Roll-forward recovery has stopped.
SQL1275N The stoptime passed to
(Note : if you are using a partitioned database roll-forward must be greater than
server, the node number indicates which node or equal to “<timestamp>”,
the error occurred on. Otherwise, it is not because database “<name>” on
pertinent and should be ignored.) node(s) “<node-list>” contains
information later than the
User Response: Do one of the following: specified time.
v Move the specified archive log file into the
database log directory or, if the database is in Explanation: The database or at least one of the
a consistent state, change the log path to point table spaces to be rolled forward were backed up
to the correct archive file, and issue the online. An advanced virtual timestamp is in the
ROLLFORWARD DATABASE command again. database or table space backup. The stoptime
Alternatively, resubmit the command with the passed to roll-forward must be greater than or
overflow log path pointing to the correct equal to the time the online backup ended on the
archive file. specified node.

v If you cannot find the missing log files, restore If ″,...″ is displayed at the end of the node list,
the database/table space on all nodes, then do see the diagnostic log for the complete list of
point-in-time recovery using a timestamp that nodes.
is earlier than that of the missing log file.
(Note : if you are using a partitioned database
server, the node number(s) indicate which
SQL1274N The database “<name>” requires node(s) the error occurred on. Otherwise, it is
roll-forward recovery and the not pertinent and should be ignored.)
point-in-time must be to the end
User Response: Do one of the following:
of logs.
v Resubmit the command with a stoptime
Explanation: The database needs to be rolled greater than or equal to “<timestamp>”. Time
forward. For database level roll-forward recovery, must be specified in CUT (Coordinated
the point-in-time must be to the end of logs Universal Time).
because a database level roll-forward to end of
v Restore an earlier backup on node(s), then
logs is already in progess. To continue the roll
issue the ROLLFORWARD DATABASE
forward, the same stoptime must be specified.
command again.
For table space level roll-forward recovery, the
point-in-time must be to the end of logs for one
SQL1276N Database ″<name>″ cannot be
of the following reasons:
brought out of rollforward
v The system catalogs require roll-forward pending state until roll-forward
recovery. System catalogs must always be has passed a point in time greater
rolled forward to the end of logs to remain than or equal to ″<timestamp>″,
consistent with all other table spaces. because node “<node-number>”
v A table space level roll-forward to the end of contains information later than
logs is already in progress. To continue the roll the specified time.
forward, the same stoptime must be specified.
Explanation: A request was made to bring the
The database is not rolled forward. database or subset of table spaces out of
rollforward pending state by specifying caller
User Response: Resubmit the ROLLFORWARD action SQLUM_ROLLFWD_STOP, SQLUM_STOP,
command specifying ROLLFORWARD TO END SQLUM_ROLLFWD_COMPLETE, or
OF LOGS. SQLUM_COMPLETE. However, the database or
at least one of the table spaces to be rolled
forward was backed up online. The request

202 Message Reference, Volume 2

cannot be granted until the database or all table User Response: To determine the list of
spaces have been rolled forward to the end of containers for each table space being restored,
the online backup timestamp on the specified use the TABLESPACE CONTAINER QUERY api
node. or the LIST TABLESPACE CONTAINERS
command. To specify an updated list for each
This error can also occur if not all the log files
table space, use the SET TABLESPACE
are provided to perform the requested recovery.
CONTAINERS api or command. This api or
(Note : if you are using a partitioned database command lets you specify whether this should
server, the node number indicates which node be the initial list of containers (i.e. a subsequent
the error occurred on. Otherwise, it is not rollforward will redo any ″add container″
pertinent and should be ignored.) operations described in the database log) or the
final list (rollforward will not redo ″add
User Response: If the stoptime specified on the container″ operations).
ROLLFORWARD command is smaller then
″<timestamp>″, resubmit the command with a It is also possible that the container(s) are
stoptime greater than or equal to ″<timestamp>″. read-only, in which case the only action required
before continuing with the restore is to give
Verify that all the log files were provided. the read/write access to the container.
ROLLFORWARD QUERY STATUS command
shows which log file is to be processed next.
Some of the reasons for missing log files include: SQL1278W Roll-forward operation has
v the log path has changed. The file can be completed successfully. Active or
found in the old log path. indoubt transactions required
rollback on node(s) ″<node-list>″.
v the userexit program is not able to retrieve the
log file, because it may have been archived to Explanation: The roll-forward of a table space
a different location. subset to a point in time was completed
successfully, however one or both of the
If the missing log file is found, copy it to the log following situations occurred:
path and resubmit the command.
1. There was one or more active transactions at
the point in time specified. Each transaction
SQL1277N Restore has detected that one or was rolled back from the table spaces in the
more table space containers are table space subset.
inaccessible, or has set their state 2. There was one or more indoubt transactions
to ″storage must be defined″. at the point in time specified. Each indoubt
Explanation: Restore validates that the transaction was rolled back from the table
containers needed by each table space being spaces in the table space subset.
restored are currently accessible on the system. Transactions that were rolled back from the table
Where possible, restore will create the containers spaces in the table space subset may still be
if they do not exist. If they cannot be created, or committed in other table spaces not involved in
are currently in use by another table space, or are the roll-forward.
inaccessible for any other reason, then the list of
containers needed must be corrected before the
If ″,...″ is displayed at the end of the node list,
restore can continue.
see the diagnostic log for the complete list of
If this is a redirected restore, the state of each nodes.
container of the table spaces being restored is set
to ″storage must be defined″. This makes it (Note : if you are using a partitioned database
possible to use the SET TABLESPACE server, the node number(s) indicate which
CONTAINERS api or command against the node(s) the error occurred on. Otherwise, it is
containers to redefine their storage. not pertinent and should be ignored.)

Chapter 2. SQL Messages 203

User Response: The diagnostic log will contain
SQL1281N The connection to database
details on the transactions that were rolled back
″<database-alias>″ has been
by roll-forward recovery.
severed because the pipe
″<pipe-name>″ has been broken.
SQL1279W Some indexes may not have been
Explanation: The connection was lost because
recreated.
the DB2 server broke the pipe. The current
Explanation: An error occurred during index transaction has been rolled back.
recreation while performing a database restart or
User Response: Resubmit the current command.
following a table reorganization which prevented
If the error continues, contact your technical
some of the indexes from being recreated
service representative.
successfully. Details can be found in the system
error log and/or the database manager error log. If trace was active, invoke the Independent Trace
Facility at the operating system command
Database restart or Reorg table was successful.
prompt. Refer to the Independent Trace Facility
User Response: Examine the error log(s) to in the Troubleshooting Guide for information on
determine why the index(es) could not be how to use this facility. Contact your technical
recreated and correct the problem. The invalid service representative with the following
indexes for a table will be recreated when the information:
table is first accessed.
Required information:
v Problem description
SQL1280N The stoptime passed to
v SQLCODE or message number
roll-forward must be less than or
equal to “<timestamp>” for v SQLCA contents, if possible
database “<name>” because at v Trace file, if possible.
least one of the table spaces was
sqlcode: -1281
already rolled forward to this
point in time.
sqlstate: 40504
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 SQL1282N The attempt to connect to
time. It cannot be rolled forward any further. database ″<database-alias>″ failed
because all the pipe instances on
User Response: Do one of the following: ″<pipe-name>″ are busy.
v Resubmit the command with stoptime Explanation: Attempts to connect to the named
“<timestamp>”. pipe failed because the connection was refused
v Restore all table spaces again, and resubmit by DB2. There is a limit to the number of
the command with a stoptime less than connections that are allowed on the named pipe.
“<timestamp>”.
User Response: Increase the connection limit on
v Restore the table space backup(s) taken the DB2 server, or terminate some of the
following the earlier table space roll-forward applications using named pipe to free up
to point in time and resubmit the command connection resources.
with the same stoptime.
sqlcode: -1282
Time must be specified in CUT (Coordinated
Universal Time). sqlstate: 08001

204 Message Reference, Volume 2

SQL1283N The attempt to connect to SQL1286N The connection to database
database ″<database-alias>″ failed ″<database-alias>″ has been
because the pipe ″<pipe-name>″ severed because the operating
is in use by another process. system ran out of resources for
pipe ″<pipe-name>″.
Explanation: The name of the named pipe is
already in used by another process. Named pipe Explanation: Named pipe failed because the
support did not start. operating system ran out of resources (swapping
space, disk space, file handles). The current
User Response: Choose a different name by
transaction has been rolled back.
setting the environment variable DB2PIPENAME,
or have the other programs which use named User Response: Free up the system resources
pipe use a different pipe name. and try again.
sqlcode: -1286
SQL1284N The attempt to connect to
sqlstate: 40504
database ″<database-alias>″ failed
because the pipe ″<pipe-name>″
cannot be found. SQL1287N ATTACH to instance ″<instance>″
failed because the named pipe
Explanation: The server has not started its
″<pipe>″ cannot be found.
named pipe support, or the server is using a
different name for the named pipe. Explanation: The server has not started its
named pipe support, or the instance name is
User Response: Start the database manager and
incorrect.
ensure the named pipe support starts. If the
named pipe support has been started, then User Response: Ensure that the database
ensure the name of the named pipe is the same manager is started at the server and that the
between the client and server by setting the named pipe support is started. Ensure that the
environment variable DB2PIPENAME to the instance name is correct.
same value.
sqlcode: -1284 SQL1290N The value of either the
DFT_CLIENT_COMM database
sqlstate: 08001
manager configuration parameter
or the DB2CLIENTCOMM
SQL1285N The attempt to connect to environment variable is not valid.
database ″<database-alias>″ failed
Explanation: Either an incorrect value was
because the pipe ″<pipe-name>″
specified or the protocol(s) specified are not
is invalid.
supported by the target database. The acceptable
Explanation: The alternate pipe name set by the values are:
environment variable DB2PIPENAME is invalid. v Unix platforms: TCPIP and APPC
User Response: The value of the environment v OS/2: TCPIP, APPC, IPXSPX, and NETBIOS
variable DB2PIPENAME must be a valid pipe v Windows NT and Windows 95: TCPIP, APPC,
name. The pipe name must be no longer than IPXSPX, NETBIOS, and NPIPE
eight characters, and has the same syntactical
restrictions as a normal file name. If more than one value is specified, then they
must be delimited by a comma.
sqlcode: -1285
sqlstate: 08001 Note that this message may be returned from an
intermediate node involved in your connection.

Chapter 2. SQL Messages 205

For example, if you are trying to connect to a DRDA server via a DB2 Connect gateway and
DRDA server via a DB2 Connect gateway and your client workstation does not use global
your client workstation does not use global directory services, this message may be returned
directory services, this message may be returned from the DB2 Connect gateway.
from the DB2 Connect gateway.
User Response: Ensure that:
User Response: Correct the value and try again. v The product providing the directory services is
sqlcode: -1290 properly installed and operational.
v You are logged in to the directory services
sqlstate: 08001
with the appropriate authorization to access
the directory entries, if login is required by the
SQL1291N A directory services error has directory services provider, for example, DCE.
been detected. Service:
If the problem persists, consult with your system
″<directory-services-type>″, API:
administrator and/or database administrator to
″<API>″, function: ″<function>″,
determine the cause of the problem using the set
error code: ″<rc>″.
of tokens provided.
Explanation: An error has been detected by the
directory services subsystem. Refer to the token sqlcode: -1291
values for details. The following is the
explanation of the token values: sqlstate: 08001
″<directory-services-type>″
The type of the directory services being SQL1292N The global name of the database
used. Valid tokens include: or database manager instance is
v DCE invalid.

″<API>″ Explanation: The global name of the database

The application programming interface or database manager instance cannot be NULL
used to access the above directory and cannot be longer than 255 characters. It must
services. Valid tokens include: start with either ″/.../″ or ″/.:/″.
v XDS/XOM Note that this message may be returned from an
intermediate node involved in your connection.
″<function>″
For example, if you are trying to connect to a
The name of the directory services
DRDA server via a DB2 Connect gateway and
subsystem function that returned the
your client workstation does not use global
error code.
directory services, this message may be returned
″<rc>″ The error code returned from the above from the DB2 Connect gateway.
function. The meaning of the value is
User Response: Correct the global name and try
specific to the API being used.
again.
For XDS functions such as ds_read, the
return code values can be found in the
SQL1293N An error was found in a global
DCE include file xds.h.
directory entry. Error code:
For XOM functions such as om_get, the ″<error-code>″.
return code values can be found in the
Explanation: An error has been detected in one
DCE include file xom.h.
of the global database directory entries used.
Refer to the following error codes for details:
Note that this message may be returned from an
intermediate node involved in your connection. 1 The database object does not contain
For example, if you are trying to connect to a authentication information

206 Message Reference, Volume 2

2 Both the database object and the 37 Database protocol in the target database
database locator object do not contain information attribute of the routing
communication protocol information information object is either not found or
too long

10 Entry not a database object Note that you may also see this message if the
DCE subsystem is not operational, or if you do
11 Native database name in the database
not have sufficient privilege to read the DCE
object is either not found or too long
directory entry.
12 Database protocol in the database object
is either not found or too long Note that this message may be returned from an
intermediate node involved in your connection.
13 Invalid authentication value found in
For example, if you are trying to connect to a
the database object
DRDA server via a DB2 Connect gateway and
14 Insufficient or invalid communication your client workstation does not use global
protocol information in the database directory services, this message may be returned
object from the DB2 Connect gateway.

15 Database locator object name not found User Response: Make sure the DCE subsystem
in the database object is operational and that you have the appropriate
privilege to read the directory entry. If the
16 Database locator object name in the problem persists, inform the database
database object invalid administrator to correct the error in the directory
entry. Refer to the Administration Guide for the
format of these directory objects.
20 Entry not a database locator object
sqlcode: -1293
22 Insufficient or invalid communication
protocol information in the database sqlstate: 08001
locator object
SQL1294N The directory path name being
used for global directory access is
30 Entry not a routing information object not specified or not valid.
31 Target database information not found Explanation: In order to use global directory
in the routing information object services, a directory path name must be specified
32 Insufficient information for the target either in the dir_path_name database manager
database in the routing information configuration parameter, or in the
object DB2DIRPATHNAME environment variable. You
either did not specify it, or the name you
33 No appropriate gateway found in the specified is not valid.
routing information object
Note that this message may be returned from an
34 Invalid flag for authentication at intermediate node involved in your connection.
gateway For example, if you are trying to connect to a
35 Database locator object name for the DRDA server via a DB2 Connect gateway and
gateway invalid your client workstation does not use global
directory services, this message may be returned
36 Database name in the target database from the DB2 Connect gateway.
information attribute of the routing
information object is either not found or User Response: Consult your database
too long

Chapter 2. SQL Messages 207

administrator for the correct name to use, specify then the other two are ignored. If the DIR_TYPE
it, and try again. value is not NONE, then the other two must
both contain valid values. The following rules
sqlcode: -1294
apply when the DIR_TYPE value is not NONE:
sqlstate: 08001 1. The DIR_PATH_NAME and DIR_OBJ_NAME
values cannot be NULL (or blanks).
SQL1295N The routing information object 2. If the DIR_TYPE value is DCE, then the
name being used for global DIR_PATH_NAME value must start with
directory access is not specified or either of the special DCE strings enclosed in
not valid. the following quotes: ″/.../″ or ″/.:/″.

Explanation: In order to use global directory User Response: If you want to change the
services to access a remote database with a DIR_TYPE value, make sure the
database protocol that is not native to this client, DIR_PATH_NAME and DIR_OBJ_NAME
the name of a routing information object must be parameters have been specified with the valid
specified either in the route_obj_name database values first. If you want to blank out either the
manager configuration parameter, or in the DIR_PATH_NAME or the DIR_OBJ_NAME
DB2ROUTE environment variable. You either did parameter, make sure you set DIR_TYPE to
not specify it, or the name you specified is not NONE first.
valid.
Note that this message may be returned from an SQL1297N This command is currently not
intermediate node involved in your connection. supported on this platform.
For example, if you are trying to connect to a
Explanation: The function requested using this
DRDA server via a DB2 Connect gateway and
command is not supported on this platform.
your client workstation does not use global
directory services, this message may be returned User Response: Do not use this command.
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,

SQL1300 - SQL1399

208 Message Reference, Volume 2

 User Response: The DCE principal must have
SQL1300N Invalid DCE principal name in
an ERA mapping to a DB2 authorization id. Add
catalog statement.
the missing entry to the DCE registry, and retry
Explanation: The DCE principal name in the the operation.
catalog database operation was invalid. DCE
sqlcode: -1302
principal names are subject to the following
conditions: sqlstate: 08001
v If AUTHENTICATION is specified as DCE, a
principal name must be included in the SQL1303N Security daemon could not be
catalog statement. restarted.
v If AUTHENTICATION is not specified as
DCE, a principal name can not be included in Explanation: An attempt to restart the security
the catalog statement. daemon has failed after communication between
the agents and the security daemon was severed
v The maximum length of the principal name is or the security daemon terminated abnormally.
1024 bytes. All new connections to the database manager
User Response: Ensure that the principal name will be rejected, as authentication is not possible.
conforms to the conditions above, and resubmit User Response: Stop the database manager and
the catalog command. start it again. If the db2start command fails,
follow the user response for that sqlcode. Check
SQL1301N An error occurred when accessing the First Failure Service Log(db2diag.log) to
the server’s DCE keytab file. determine what errors have occurred.

Explanation: An error occurred when accessing sqlcode: -1303

the server’s DCE keytab file. For a keytab file to sqlstate: 58004
be valid, the following conditions must be
satisfied:
v The server’s keytab file exists, has the name SQL1304N The TCP/IP security type SOCKS
keytab.db2, and is in the sqllib/security is not valid.
directory. Explanation: The TCP/IP security type SOCKS
v There is only a single entry in the keytab file. in the TCP/IP protocol structure of the Catalog
Node command is invalid with authentication
User Response: Make sure that DCE is started. type DCE.
Next, check that the keytab file exists, and
contains a single entry (with rgy_edit). Retry the User Response: Make sure you do not use the
operation. combination of TCP/IP protocol with security
type SOCKS and authentication type DCE.

SQL1302N DCE principal to DB2 sqlcode: -1304

authorization id mapping error.
sqlstate: 08001
Reason code: ″<reason-code>″.
Explanation: An error occurred when mapping
SQL1305N An internal DCE error occurred.
a DCE principal to a DB2 authorization id. Refer
to the reason code below. Explanation: DB2 processing failed due to an
v 1. Missing or invalid DCE user to DB2 internal DCE error.
authorization id mapping User Response: Make sure DCE is started. If
v 2. Missing or invalid DCE group to DB2 the problem persists, contact a service
authorization id mapping representative for assistance.

Chapter 2. SQL Messages 209

sqlcode: -1305 specified by looking up the audit facility
reference section for the sqleaucfg
sqlstate: 58004
parameter tokens.
4 Correct the parameter value by looking
SQL1306N An invalid parameter was
up the valid values in the audit facility
specified during invocation of the
reference.
security audit facility. Reason
Code: ″<reason-code>″. 5 Specify the correct count and
allocate/initialize the appropriate length
Explanation: One of the parameters of the
for variable length parameters.
security audit API is incorrect. Reasons:
6 Correct the length allocated for
1 An invalid audit option was specified.
Configure/Describe parameter based on
2 Invalid pointer to Configure/Describe the error token that is returned in the
sqleaucfg structure. SQLCA.

3 Invalid Configure/Describe parameter 7 Check to see if a valid pointer has been

token. provided to a Extract structure.

4 Invalid Configure/Describe parameter 8 The correct parameter should be

value. The value is incorrect or outside specified by looking up the audit facility
the valid range for the parameter. reference section for the sqleauextract
parameter tokens.
5 Invalid count specification for
Configure/Describe parameter. 9 Correct the parameter value by looking
up the valid values in the audit facility
6 Insufficient length allocated for reference.
Configure/Describe parameter.
10 Specify the correct count and
7 Invalid pointer to Extract sqleauextract allocate/initialize the appropriate length
structure. for variable length parameters.
8 Invalid Extract parameter token. 11 Correct the length allocated for Extract
9 Invalid Extract parameter value. The parameter based on the error token that
value is incorrect or outside the valid is returned in the SQLCA.
range.
10 Invalid count specification for Extract SQL1307N An error occurred during
parameter. invocation of the security audit
facility. Reason Code:
11 Invalid length for Extract parameter. ″<reason-code>″.
User Response: The system administrator Explanation: The invocation of the security
should take specific actions for each of the audit API caused an error to occur. Reasons:
reasons.
1. Audit is already started.
1 Provide the right option value for the 2. Audit is already stopped.
audit API call by looking at the sqlutil.h
3. Invalid checksum for audit configuration file.
include file.
4. The default or user-provided audit pathname
2 Check to see if a valid pointer has been is too long.
provided to a Configure/Describe
5. Could not update the audit configuration file.
structure.
Either the filesystem is full or the permissions
3 The correct parameter should be do not allow write.

210 Message Reference, Volume 2

6. Configuration File not found. Either the file
SQL1309N Invalid server principal name.
or the directory which contains the file does
not exist. Explanation: The server principal name
7. The extract file is not found. specified in the database catalog statement does
not exist in the DCE registry. Because of this a
8. Invalid format of audit records during
DCE ticket could not be obtained for the DB2
extract. The file is corrupted.
server.
User Response: The system administrator
User Response: Make sure that the principal
should take specific actions for each of the
name in the database catalog entry corresponds
reasons.
to the DCE principal being used by the DB2
1. No action required. server. It may be necessary to fully qualify the
2. No action required. principal name.
3. Restore the configuration file from backup or sqlcode: -1309
issue ’audit reset’ command.
sqlstate: 08001
4. Choose a different audit pathname which is
within the filename length limit.
5. If the file permissions are incorrect,set the SQL1310N The Database Connection Services
permissions to allow write by owner. If the directory service failed while
filesystem is full, create free space before attempting to access the Database
proceeding. Connection Services directory.
6. If the audit configuration file is missing, then Explanation: The Database Connection Services
restore it from a backup or issue the ’reset’ Directory Service failed because of file errors
command to initialize the file to defaults. If while trying to access the Database Connection
the directory is missing, restore from a Services directory file.
backup or recreate the database manager
The function cannot be processed.
instance.
7. Verify that file exists in the specified path. If User Response: Rerun the function after doing
file missing, restore from backup if available. one of the following:
8. The audit log file is most likely corrupted. If v If you are adding an entry to the Database
problem persists for other audit log files, Connection Services directory, ensure that
notify DB2 service. there is sufficient space for the directory file to
become larger.
v Ensure that no other concurrently running
SQL1308W The audit Extract Facility
program is trying to access the file.
completed Processing.
″<num-records>″ records were v Verify that the directory file has not been
extracted. damaged. If it is unrecoverable, you must
erase it and recreate it or restore it from a
Explanation: The security audit extract facility backed-up version.
completed its processing succesfully and
extracted the specified number of records.
SQL1311N The Database Connection Services
User Response: If zero records were extracted, directory cannot be found.
the user should verify that the extract pathname
contains extract files and the extract parameters Explanation: The directory cannot be found.
are correct. The directory may have been deleted.
The function cannot be processed.
User Response: Use the CATALOG DCS

Chapter 2. SQL Messages 211

DATABASE command to add an entry to the valid. All characters must be from the database
Database Connection Services directory, or manager base character set.
restore the directory from a backed-up version.
The function cannot be processed.
User Response: Ensure that the characters used
SQL1312W The Database Connection Services
in the local database name are from the database
directory is empty.
manager base character set and resubmit the
Explanation: An attempt was made to read the command.
contents of the Database Connection Services
directory, but no entries existed.
SQL1316N No entry was found in the
Processing continues, but subsequent commands Database Connection Services
expecting entries to be available cannot be directory for the specified local
processed. database name.
User Response: Use the Catalog DCS Database Explanation: The Database Connection Services
command to add entries to the directory or directory service failed because no entry could be
restore a backed-up version that contains entries. found in the Database Connection Services
directory that corresponds to the input local
database name.
SQL1313N The Database Connection Services
directory is full. The function cannot be processed.
Explanation: The entry cannot be added to the User Response: Ensure that the local database
Database Connection Services directory because name is correct and resubmit the command.
the directory has already reached its maximum
size.
SQL1317N The local database name already
The function cannot be processed. exists in the Database Connection
Services directory.
User Response: Delete an entry or entries from
the directory before adding any more entries. Explanation: The entry could not be added to
the directory because an entry for that local
database name already exists in the directory.
SQL1314N The address of the Database
Connection Services directory The function cannot be processed.
entry parameter is not valid.
User Response: Specify a unique local database
Explanation: The application program has used name or delete the existing entry and add the
an address for this parameter that is not valid. new entry.
Either the address points to an unallocated buffer
or the buffer is not large enough to contain the
SQL1318N The length of element “<name>”
required input.
in the input structure for
The function cannot be processed. parameter 1 is not valid.
User Response: Ensure that the application Explanation: The length values in the Database
program has allocated the required buffer area Connection Services directory entry structure
and resubmit the command. should not be less than zero nor greater than the
maximum length for the element it represents.
SQL1315N The local database name is not The function cannot be processed.
valid.
User Response: If an element of the directory
Explanation: A local database name was entry structure is specified, the associated length
specified that contains characters that are not value should represent the number of bytes in

212 Message Reference, Volume 2

the element. Otherwise, the length value should
SQL1322N An error occurred when writing to
be zero. Ensure that all the directory entry
the audit log file.
structure elements have the required
specifications and lengths for the command and Explanation: The DB2 audit facility encountered
resubmit the command. 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
SQL1319N The Database Connection Services
file system or prune the audit log to reduce its
directory entries have not been
size.
collected.
When more space is available, use db2audit to
Explanation: A request to copy all the directory
flush out any data in memory, and to reset the
entries was received, but either a prior request to
auditor to a ready state. Ensure that appropriate
collect the entries was not received or the prior
extracts have occurred, or a copy of the log has
request to collect the entries failed.
been made prior to pruning the log, as deleted
The function cannot be processed. records are not recoverable.

User Response: Issue a request to open the User Response: The system administrator
directory and collect the entries. Then resubmit should take the suggested corrective action so
this command. that the audit facility can resume logging.
sqlcode: -1322
SQL1320N The Database Connection Services
sqlstate: 58030
directory cannot be accessed at
this time.
SQL1323N An error occurred when accessing
Explanation: A request to access the Database
the audit configuration file.
Connection Services directory failed. Access to
the Database Connection Services directory is Explanation: db2audit.cfg could not be opened,
dependent on the type of access requested and or was invalid. Possible reasons:
the current activity in the directory. If the request v The db2audit.cfg file either does not exist, or
is for the intention of updating the directory, has been damaged. Take one of the following
then the directory must not be active. If the actions:
request is to read the directory, then access is
– Restore from a saved version of the file.
allowed if the directory is not being updated.
– Reset the audit facility configuration file by
The function cannot be processed. issuing the reset command from the
User Response: Wait for the current activity to db2audit executable.
complete and resubmit the command. User Response: The system administrator
should take the suggested action to resolve the
SQL1321N The structure ID specified in the problem.
directory entry structure is not sqlcode: -1323
valid.
sqlstate: 57019
Explanation: The structure ID received in the
directory entry structure does not represent a
recognized value. SQL1325N The remote database environment
does not support the command or
The function cannot be processed. one of the command options.
User Response: Verify the structure ID passed Explanation: An attempt has been made to
in the directory entry structure is a valid value issue a DB2 workstation database specific
and resubmit the command.

Chapter 2. SQL Messages 213

command or command option against a host command. If the problem persists, contact your
database through DB2 Connect or federated System Administrator.
server. The following commands generate this
error when issued against a DB2 for MVS*, DB2
SQL1327N An implicit connection attempt
for OS/400* or SQL/DS* database:
failed. ″<database-name>″ is not a
v OPSTAT (Collect Operational Status) valid database name.
v DARI (Database Application Remote Interface)
Explanation: An attempt to perform an implicit
v GETAA (Get Administrative Authorizations) connection failed. The syntax of the database
v GETTA (Get Table Authorizations) alias name specified by the DB2DBDFT
v PREREORG (Prepare to Reorganize Table) environment variable is not valid. The database
name must contain 1 to 8 bytes and all the
v REORG (Call Reorganize Function)
characters must be from the database manager
v RQSVPT/ENSVPT/RLBSVPT (Subtransaction base character set.
Requests)
The command cannot be processed.
v RUNSTATS (Run Statistics).
v COMPOUND SQL ATOMIC STATIC (Atomic User Response: Correct the database alias name
Compound SQL) specified by the DB2DBDFT environment
variable and resubmit your command. If using
v ACTIVATE DATABASE
the command line processor, then a ″db2
v DEACTIVATE DATABASE terminate″ should be issued prior to resubmitting
As well, the following commands generate this the command. If you do not want an implicit
error with incorrect options: connection to be performed, remove the
DB2DBDFT environment variable.
v IMPORT (Import table) The filetype must be
IXF, commitcount must be 0, and the first sqlcode: -1327
word in the Action String (e.g. ″REPLACE into
sqlstate: 2E000
...″) must be INSERT.
v EXPORT (Export table) The filetype must be
IXF. SQL1328N An implicit connection attempt
failed. The database alias name or
The command cannot be processed. database name ″<name>″ was not
User Response: Do not attempt to issue this found in the local database
command against a host database through DB2 directory.
Connect or federated server. Explanation: An attempt to perform an implicit
connection failed. The database name specified
SQL1326N The file or directory “<name>” by the DB2DBDFT environment variable does
cannot be accessed. not name an existing database. The database
could not be found in the database directory.
Explanation: The file or directory “<name>”
cannot be accessed because either the file The command cannot be processed.
permissions are incorrect, the file path is Note that a CONNECT RESET request issued
incorrect, or there is insufficient space in the within a distributed unit of work will attempt an
directory or path. implicit connect to the default database. This
User Response: Verify that any path or filename may be the reason for this error.
specified in the command is valid, you have the User Response:
proper permissions to access the path or
v Correct the database alias name specified by
filename, and there is sufficient space to contain
the DB2DBDFT environment variable and
the file. Correct the problem and resubmit the
resubmit the command.

214 Message Reference, Volume 2

v If the intended action is to remove a
SQL1331N The CPIC security type “<type>”
connection while operating in a distributed
is not valid.
unit of work environment, consider replacing
the CONNECT RESET statement with a Explanation: The CPIC security type specified
DISCONNECT or RELEASE statement. in the CPIC protocol structure of the Catalog
v If using the command line processor, then a Node command is invalid. The security type
″db2 terminate″ should be issued prior to specifies the security information that will be
resubmitting the command. included when a database client allocates a
conversation with a partner LU, as specified by
v If you do not want an implicit connection to
the LU 6.2 architecture. Correct values for
be performed, remove the DB2DBDFT
security type are:
environment variable.
v SQL_CPIC_SECURITY_NONE
sqlcode: -1328
– No access security information will be
included.
sqlstate: 42705
Note: This is not supported when using
SQL1329N The resolved path specified on federated server. When DB2 Connect
the command is too long. is used, it is only supported when
authentication type is DCE,
Explanation: The resolved path specified on the KERBEROS, SERVER_ENCRYPT or
command exceeds the maximum length DCS_ENCRYPT.
supported by the database manager. The
resolved path must be no longer than 215 v SQL_CPIC_SECURITY_SAME
characters in length. During a Create Database, – A userid will be included together with an
Catalog Database, Open Database Directory for indicator specifying that the userid is
scan, and change database comment commands, already verified. This is not supported
the database manager instance name is appended when authentication type DCS is used with
to the end of the specified path. DB2 Connect or federated server, or when
authentication type is DCE, KERBEROS,
User Response: Check that the fully resolved SERVER_ENCRYPT or DCS_ENCRYPT.
absolute or relative path name, including the
database manager instance name, does not v SQL_CPIC_SECURITY_PROGRAM
exceed 215 characters in length. Correct the path – Both a userid and a password will be
and resubmit the command. included. This is not supported when
authentication type CLIENT is used with
DB2 Connect or when authentication type is
SQL1330N The symbolic destination name DCE, KERBEROS, SERVER_ENCRYPT or
“<name>” is not valid. DCS_ENCRYPT.
Explanation: The symbolic destination name in User Response: Set the security type to one of
the CPIC protocol structure of the Catalog Node the above and resubmit the command.
command is either not specified or longer than
the allowable length. The name must be 1 to 8 sqlcode: -1331
bytes in length.
sqlstate: 08001
User Response: Verify that the symbolic
destination name is specified and that it is not
SQL1332N The Host Name “<name>” is not
longer than 8 bytes in length. Resubmit the
valid.
command with a valid symbolic destination
name. Explanation: The host name in the TCP/IP
protocol structure of the Catalog Node command
is either not specified or longer than the

Chapter 2. SQL Messages 215

allowable length. The name must be 1 to 255 in the application requestor name are from the
characters in length and cannot be all blanks. database manager base character set and
resubmit the command.
User Response: Verify that the host name is
specified and that it is not longer than 255
characters in length. Resubmit the command SQL1336N The remote host “<hostname>”
with a valid host name. was not found.
Explanation: The system cannot resolve the
SQL1333N The Service Name ″<name>″ is address of the remote host. Possible causes are:
not valid. v An incorrect hostname value was specified
Explanation: The service name is the TCP/IP when the TCP/IP node was cataloged.
protocol structure of the Catalog Node command v The correct hostname was specified, but was
is either not specified or longer than the not defined in any TCP/IP name server
allowable length. The name must be 1 to 14 accessible to your client node, nor in the
characters in length and cannot be all blanks. client’s hosts file.
User Response: Verify that the service name is v The TCP/IP name server where the hostname
specified and that it is not longer than 14 was defined was not available at the time you
characters in length. Resubmit the command tried to connect.
with a valid service name. v TCP/IP is not running.
User Response: Make sure that TCP/IP is
SQL1334N The database server cannot be running and that the hostname specified when
used to route a remote request to cataloging the TCP/IP node is a correct name,
a second database server in this and that it is defined in an accessible name
configuration. server or in the local hosts file.
Explanation: An attempt was made to route a Federated system users: verify that the remote
request through a database server node using an host is cataloged correctly in the
unsupported combination of client and target SYSCAT.SERVERS view.
database server. Either a client or target database
prior to release version 2 was used or an attempt
SQL1337N The service “<service-name>” was
was made to route the request from a DRDA
not found.
client to a DRDA target database. The request
must be routed directly from the client to the Explanation: The system cannot resolve the port
node on which the target database is running. number associated with the service-name.
Possible causes are:
User Response: Uncatalog the database at the
client machine and then catalog the database v An incorrect service-name value was specified
specifying the node on which the database when the TCP/IP node was cataloged.
actually resides. Ensure that the node is also v The correct service-name was specified, but
cataloged. was not defined in the client’s services file.
Federated system users: this situation can also be
SQL1335N The application requestor name is detected by the data source.
not valid
User Response: Make sure that the
Explanation: An application requestor name service-name specified when cataloging the
was specified that contains characters that are TCP/IP node is a correct name, and that it is
not valid. All characters must be from the defined in the local services file.
database manager base character set.
Federated system users must also ensure that the
User Response: Ensure that the characters used

216 Message Reference, Volume 2

name is defined in the services file at the data Each <errorX> represents an SQL statement error.
source. 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
SQL1338N The symbolic destination name
the second and subsequent tokens of the
“<symbolic-destination-name>”
SQLERRMC field (tokens are separated by a one
was not found.
byte hexadecimal value 0xFF).
Explanation: The system cannot find the Side
Each <errorX> is of the format PPPSSSSS where:
Information associated with the
symbolic-destination-name you specified. PPP PPP represents the position of the
Possible causes are: statement that caused the error within
v An incorrect symbolic-destination-name value the Compound SQL block, and is
was specified when the CPIC NODE was left-justified. For example, if the first
cataloged. statement failed, this field would
contain the number one (″1 ″).
v The symbolic destination name and its
associated side information have not been SSSSS SQLSTATE of the statement that failed.
defined to the SNA communications
subsystem. More information can be found by examining the
v The SNA communication subsystem has not SQLCA itself. The third SQLERRD field contains
been started. the number of rows affected by the compound
SQL statement, the fourth SQLERRD field
User Response: Make sure that the contains the position of the last statement that
symbolic-destination-name specified when succeeded, the 5th SQLERRD field contains the
cataloging the CPIC node is a correct name, and number of rows affected by referential integrity
that it has been defined to the local SNA when DB2 Client/Server and SQL/DS databases
communication subsystem. are accessed, and the 6th SQLERRD field
Start the SNA communication subsystem if it has contains the number of statements that failed
not been started. (returned negative SQLCODES).

sqlcode: -1339
SQL1339N ″<n>″ SQL error(s) were detected
in the execution of a Not Atomic sqlstate: 56091
Compound SQL statement, and
have the following identification:
″<error1>″ ″<error2>″ ″<error3>″ SQL1340N The file server ″<fileserver>″ was
″<error4>″ ″<error5>″ ″<error6>″ not found.
″<error7>″.
Explanation: The system cannot find the
Explanation: One or more SQL substatements specified file server on the network. Possible
within a Compound SQL statement resulted in causes are:
SQL errors (negative return codes). v An incorrect fileserver name was specified
The error tokens will not be returned for when the IPX/SPX node was cataloged.
CLI/ODBC applications. CLI/ODBC applications v The correct fileserver name was specified, but
can use SQLGetDiagRec, SQLGetDiagField, or the file server was not available at the time the
SQLError APIs to get more information about connect was tried.
each error.
User Response: Make sure that the fileserver
User Response: Examine the error identification name specified when cataloging the IPX/SPX
information provided. There will be <n> node is correct, and that the file server is
<errorX> tokens filled in, up to a maximum of 7. available on the network.

Chapter 2. SQL Messages 217

 03 A Restore request is in progress. A
SQL1341N A workstation name must be
warning was received from the initial
specified in the client database
utility call indicating that further
manager configuration file.
requests are required before Restore can
Explanation: A workstation name has not been complete.
specified in the client database manager
04 A Rollforward request is in progress. A
configuration file. A workstation name must be
warning was received from the initial
specified when using NetBIOS to communicate
utility call indicating that further
with the server.
requests are required before Rollforward
User Response: Specify a workstation name in can complete.
the client database manager configuration file.
05 A Load request is in progress. A
warning was received from the initial
SQL1342N The File Server name ″<name>″ is utility call indicating that further
missing or invalid.″ requests are required before Load can
complete.
Explanation: The File Server name specified in
the command/API is missing or invalid. 07 Federated system users: the application
cannot process this command after
User Response: Verify that a File Server name
executing SQL statements.
was specified, that the name does not contain
invalid characters, and is not longer than 48 User Response: Corresponding to ″<rc>″:
characters in length. Resubmit the
01 Complete the unit of work (using either
command/API with a valid File Server name.
COMMIT or ROLLBACK) before
reissuing this command.
SQL1343N The Object Name ″<name>″ is
02-05 Issue the required call(s) to complete the
missing or invalid.
utility in progress, then reissue this
Explanation: The Object Name specified in the command.
command/API is missing or invalid.
07 Federated system users: the application
User Response: Verify that the Object Name must issue the commands after
was specified, that the name does not contain establishing a connection to the database
invalid characters, and is not longer then 48 manager but prior to any other SQL
characters in length. Resubmit the statements.
command/API with a valid Object Name.
SQL1360N Current processing cannot be
SQL1350N The application is not in the interrupted.
correct state to process this
Explanation: The user attempted to interrupt a
request. Reason code=″<rc>″.
process which is not interruptible.
Explanation: Corresponding to ″<rc>″:
User Response: Do not interrupt the current
01 The application is currently processing process.
SQL and cannot process the utility
command requested.
SQL1361W Execution time has exceeded
02 A Backup request is in progress. A timeout value. Do you wish to
warning was received from the initial interrupt it?
utility call indicating that further
Explanation: If a command takes longer than a
requests are required before Backup can
pre-defined timeout period, a dialog box pops up
complete.

218 Message Reference, Volume 2

asking if the (Windows client) user wants to
SQL1372N Cannot perform a quiesce while
interrupt it or not.
in a transaction.
Note that this message is applicable in Windows
Explanation: An attempt was made to quiesce a
environments only, and will only be seen in a
database or instance while the user issuing the
dialog pop up box.
quiesce has uncompleted units of work. Quiesce
User Response: There are three choices: YES - cannot be issued while in this state.
interrupt now; NO - continue, don’t prompt me;
User Response: Complete the unit of work
CANCEL - continue, same timeout.
(COMMIT or ROLLBACK) and retry the request.

SQL1370N An attempt to quiesce instance or

SQL1373N Cannot QUIESCE RESET instance
database ″<name1>″ failed
or database ″<name>″, because it
because instance or database
is not quiesced.
″<name2>″ is already quiesced by
user ″<username>″. Quiesce type: Explanation: QUIESCE RESET failed because
″<type>″. the instance or database is not quiesced.
Explanation: An attempt was made to quiesce User Response: Ensure that the quiesce reset is
an instance or database which would have being issued for the correct instance or database
caused an overlapping quiesce, such as quiescing and try again.
an instance while a database is already quiesced
by another user.
SQL1374N Cannot QUIESCE RESET instance
Quiesce type ″<type>″ refers to the instance or or database ″<name>″, because it
database already quiesced and is a ’1’ for an has been quiesced by another user
instance and a ’2’ for a database. ″<username>″.
User Response: Contact the user who currently Explanation: The instance or database is
has the instance or database quiesced to quiesced, but you are not the quiescer.
determine when DB2 will no longer be quiesced,
User Response: Ensure that the quiesce reset is
and retry the request at that time.
being issued for the correct instance or database.

SQL1371N Instance or database ″<name>″ is

SQL1375N An invalid parameter was passed
already quiesced by user
to the api. Parameter
″<username>″. Quiesce type:
″<parm-code>″ is in error.
″<type>″.
Explanation: ″<parm-code>″ indicates the
Explanation: An attempt was made to quiesce
parameter in error:
an instance or database which is already
quiesced. 1 scope
Quiesce type ″<type>″ refers to the instance or 2 options
database already quiesced and is a ’1’ for an
instance and a ’2’ for a database. The value may be out of range or invalid.
User Response: Contact the user who currently User Response: Check the syntax of the api,
has the instance or database quiesced to correct the parameter and try again.
determine when DB2 will no longer be quiesced,
and retry the request at that time.

Chapter 2. SQL Messages 219

SQL1380N An unexpected Kerberos security SQL1384N Unable to complete mutual
error has occurred. For more authentication.
information, refer to db2diag.log.
Explanation: The connection failed because
Explanation: An unexpected Kerberos security either the client or server was unable to complete
error occurred during authentication. mutual authentication.
User Response: Check the db2diag.log file for User Response: If the target principal name was
further information. specified in the CATALOG DATABASE
command, ensure that the target principal name
is valid for the server to which the client is
SQL1381N The Security Support Provider
attempting to connect or attach.
Interface is not available.
When running in a Windows 32-bit operating
Explanation: Authentication failed because the
system environment, the target principal name is
Security Support Provider Interface (SSPI) was
the logon account name of the DB2 service in the
not available.
format of <domain name>\<user ID>.
User Response: When running under Windows
If the target principal name appears to be valid,
operating system, ensure that the file security.dll
then contact IBM service for assistance.
exists under the system directory. Also ensure
that SSPI is supported for the operating system
that is being used. SQL1390C The environment variable
DB2INSTANCE is not defined or
is invalid.
SQL1382N Kerberos support is not available.
Explanation: The environment variable
Explanation: Authentication failed because
DB2INSTANCE is not defined or is not set to a
Kerberos support is not installed.
valid instance owner.
User Response: Ensure that Kerberos support is
User Response: Set the DB2INSTANCE
installed and operational, then retry the
environment variable to the name of the instance
connection.
to use. If you do not know the name of the
instance to use or how to set the DB2INSTANCE
SQL1383N The target principal name is not environment variable to the instance name, refer
valid. to the Administration Guide.

Explanation: The target principal name that was Federated system users: refer to the Installation
specified in the CATALOG DATABASE and Configuration Supplement for DB2INSTANCE
command is not valid. information.

User Response: Remove the database entry that Ensure your PATH environment variable
has the invalid target principal name by using contains the sqllib/adm path in the home
the UNCATALOG DATABASE command. directory of the instance you want to use (for
Re-catalog the database entry with a valid target example, /u/instance/sqllib/adm, where
principal name using the CATALOG DATABASE /u/instance is the home directory of the instance
command and retry the connection. owner on a UNIX system).

When running in a Windows 32-bit operating

system environment, the target principal name is SQL1391N The database is already in use by
the logon account name of the DB2 service in the another instance.
format of <domain name>\<user ID>.
Explanation: The request failed because the
database is in use by another instance of the
database manager (a database may only be used

220 Message Reference, Volume 2

by one instance.) This may be caused by User Response: Ensure that the specified
attempting to access a database located on a instance exists. Use the db2ilist command to
mounted file system accessible to another display the list of instances:
instance located on another machine. db2ilist
This can also occur if you have an open
connection (via SNA) to a database and the SQL1395N Unable to switch to another
database manager was brought down instance because the application is
abnormally. using multiple contexts.
User Response: Explanation: The request to switch to another
v Validate that you are using the correct instance failed because the application is using
database and ensure no other instance uses multiple contexts.
this database.
User Response: Ensure that the application is
v If the database manager was brought down not using multiple contexts before switching to
abnormally, and you have a command line another instance.
processor connection to it, perform a db2
terminate to close the offending open
connection before attempting to connect again. SQL1396N Unable to switch to another
instance because the application is
sqlcode: -1391 connected to a database or
attached to an instance.
sqlstate: 51023
Explanation: Request to switch to another
instance failed because the application is
SQL1392N Multiple instances of applications connected to a database or attached to an
using “<prep, bind, import, instance.
export>” is not supported.
User Response: Ensure that the application is
Explanation: Only 1 instance of prep, bind, not connected to any database or attached to any
import, or export can be running at any one time instance before switching to another instance.
within WINDOWS.
User Response: Within WINDOWS, do not SQL1397N The DB2 service failed to logon.
attempt to start more than 1 application that uses
prep, bind, import, or export. Explanation: DB2 service did not start due to a
logon failure.

SQL1393C The environment variable User Response: If you are starting the DB2
DB2PATH is not defined or is Administration Server, then use the DB2ADMIN
invalid. SETID command to set a new logon account. If
you are starting a DB2 server on Windows NT,
Explanation: The environment variable you can set the logon account for a DB2 service
DB2PATH is not defined or is not set to a valid by using the Services dialog box from the
directory path. Control Panel.
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.
Chapter 2. SQL Messages 221
SQL1400 - SQL1499
OPTION=’PASSWORD’ for that server, alter
SQL1400N Authentication is not supported.
SYSCAT.SERVEROPTIONS to reflect the true
Explanation: The authentication type supplied data source password requirement using the
is not one of the supported types. ALTER SERVER SQL statement.
The command can not be processed. v If the problem is that the data source does not
require a password but
User Response: The user should reissue the SYSCAT.SERVEROPTIONS contains
command with a valid parameter value. SETTING=’Y’ for OPTION=’PASSWORD’ for
See Application Development Guide for a list of that server, alter SYSCAT.SERVEROPTIONS to
supported authentication types. reflect the true data source password
requirement using the ALTER SERVER SQL
statement.
SQL1401N Authentication types do not v If the server option for OPTION=’PASSWORD’
match. is not set in SYSCAT.SERVEROPTIONS, create
Explanation: The user is attempting to connect an entry using the CREATE SERVER SQL
to a remote database which is cataloged on the statement to reflect the true data source
local node with a different authentication type password requirement.
from the remote node. sqlcode: -1401
Federated system users: this message can also
appear when: sqlstate: 08001
v A data source is identified in
SYSCAT.SERVEROPTIONS with SETTING=’N’ SQL1402N Unable to authenticate user due to
for OPTION =’PASSWORD’ and the data unexpected system error.
source is not running in trusted client mode
(that is, the data source expects a password) Explanation: Call your system administrator.
On unix-based systems, the file db2ckpw may not
v The data source is identified in
have the correct permission bits set, or the
SYSCAT.SERVEROPTIONS with SETTING=’Y’
system may have run out of swap/paging space.
for OPTION =’PASSWORD″ and the data
On Windows NT, the DB2 security service may
source is running in trusted client mode (that
not have been started.
is, the data source does not expect a password)
v There is no server option specified for The command can not be processed.
OPTION=’PASSWORD’ in Federated system users: this situation can also be
SYSCAT.SERVEROPTIONS and the system detected by the data source.
default value for PASSWORD violates the data
source password requirement. User Response: On unix-based systems, have
the system administrator ensure the correct
User Response: The command can not be access permissions are set for db2ckpw, and that
processed. there is enough swap/paging space allocated. On
The user should recatalog the database alias on Windows NT, have the system administrator
the client node with the same authentication type verify that the DB2 security service is installed
as the remote database. Resubmit the command. and started.

Federated system users:

v If the problem is that the data source requires
a password but SYSCAT.SERVEROPTIONS
contains SETTING=’N’ for

222 Message Reference, Volume 2

SQL1403N The username and/or password SQL1405N Unable to communicate with local
supplied is incorrect. DB2 authentication server.
Explanation: The username and/or password Explanation: The application failed to
supplied is incorrect or not a valid authenticate due to an error while
username/password combination or the database communicating to the local DB2 authentication
to which you are attempting to connect to has an server.
authentication type of SERVER and no username
User Response: Ensure that the DB2
and password was supplied on the CONNECT
authentication server is started by entering the
TO statement.
following command from an OS/2 window:
If DB2 Connect is being used, the problem may detach db2upm
be that the DCS directory entry for the host
connection could not be found.
SQL1415N The statement was compiled for
If a connection is being made from an OS/2 diagnostic purposes only and has
client to a UNIX-based server with authentication not been executed.
server, and the userid and password are being
picked up from UPM, then the userid on the Explanation: The statement was processed
server must be defined in lowercase and have an through parts of the system to collect diagnostic
uppercase password. information using service features. The necessary
steps to allow further processing of the statement
The command can not be processed. have not been completed.
Federated system users: this situation can also be User Response: This error is returned to
detected by the data source. prevent further processing by the system of
User Response: Supply the correct username statements prepared using service features and is
and password combination. expected.

Federated system users: ensure that the entry in

SYSCAT.USEROPTIONS contains the correct SQL1420N Too many concatenation operators.
username and password for the data source Explanation: The database manager has reached
being accessed. an internal limit while evaluating an expression,
sqlcode: -1403 of long or large object string result type, that
contains concatenation operators.
sqlstate: 08004
User Response: Reduce the number of
concatenations in the expression and try again.
SQL1404N Password expired.
sqlcode: -1420
Explanation: Your password has expired.
sqlstate: 54001
User Response: Change your password, then
retry the request using the new password. You
can use the DB2 Client Configuration Assistant, SQL1421N MBCS conversion error occurred
or Command Line Processor CONNECT and when converting host variable or
ATTACH commands to change your password. sqlvar ″<number>″ to or from
wchar_t format. Reason code
sqlcode: -1404 ″<rc>″.
sqlstate: 08004 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

Chapter 2. SQL Messages 223

during conversion in either wcstombs(), for input the SUBSTR function or by setting the data type
host variables, or mbstowcs(), for output host in the SQLDA to one of the character data types
variables. The host variable or sqlvar number available in Version 1 if the LOB column is not
indicates which data item experienced the larger than the supported length of the character
problem. Valid reason codes are: data type.
1 the problem occurred with input data User Response: Change the query to exclude
any column that has a data type of BLOB, CLOB
2 the problem occurred with output data
or DBCLOB. This is the only possible action if
User Response: If application data is already in the query includes a column of type BLOB. If the
MBCS format, re-precompile the application with column (say C1) is a CLOB, you could use
WCHARTYPE NOCONVERT and re-build. If CAST(C1 AS LONG VARCHAR) to get the first
application data is intended to be in wchar_t 32700 characters. Similarly for DBCLOB column
format, then input data failing in wcstombs() (DC1) use CAST(DC1 AS LONG VARGRAPHIC)
may be corrupt. Correct the data and re-execute to get the first 16350 characters. If the application
the application. code can be changed, code can be added to
change the SQLDA to use LONG VARCHAR or
sqlcode: -1421 LONG VARGRAPHIC for CLOB and DBCLOB.
sqlstate: 22504 sqlcode: -1423
sqlstate: 56093
SQL1422N The size of the container is
invalid.
SQL1424N Too many references to transition
Explanation: One of the containers to be used variables and transition table
in a database managed table space is either too columns or the row length for
large or too small. A container must be at least these references is too long.
extentsize + 1 pages in length. The maximum Reason code=“<rc>”.
size of a container is operating system
dependent. The most common system limit is 2 Explanation: The trigger includes a
gigabytes (524288 4K pages). REFERENCING clause that identifies one or
more transition tables and transition variables.
User Response: Check the diagnostic log for The triggered action of the trigger contains
details. Then correct the SQL statement. references to transition table columns or
sqlcode: -1422 transition variables with one of the following
conditions identified by the reason code:
sqlstate: 54039
1 references total more than the limit of
the number of columns in a table
SQL1423N The query includes a column with
a large object data type. 2 sum of the lengths of the references
exceeds the maximum length of a row
Explanation: The query includes a column with in a table.
a data type of BLOB, CLOB or DBCLOB. In
general, such data types cannot be handled from User Response: Reduce the number of
clients available prior to Version 2.1. references to transition variables and transition
table columns in the trigger action of the trigger
The error occurred for a condition that so that the length is reduced or the total number
corresponds to warning SQLCODE +238. See this of such references is less than the maximum
message for details that explain the condition. number of columns in a table.
The client level receiving this message cannot
process BLOB data types. It may be able to sqlcode: -1424
handle CLOB and DBCLOB data types by using sqlstate: 54040

224 Message Reference, Volume 2

 attached to the node required by the command.
SQL1425N A password has been supplied
without a userid. User Response: Ensure that the application has
no attachment before issuing the command or
Explanation: Any command/API that accepts a
that the attachment that exists is to the correct
userid and password will not accept a password
node.
without a userid.
User Response: Resubmit the command/API
SQL1429N A node directory entry cannot be
and supply a userid if you are also supplying a
created in which the node name
password.
matches the value of the
DB2INSTANCE environment
SQL1426N A default instance cannot be variable.
determined.
Explanation: The CATALOG NODE command
Explanation: If an explicit ’attach to instance’ or API does not allow an entry whose nodename
has not been performed, instance commands try matches the value of the DB2INSTANCE
to form an implicit attachment to a default environment variable.
instance. The default instance is determined from
User Response: Choose another node name for
the DB2INSTDFT and DB2INSTANCE
the node being cataloged and try again.
environment variables. If neither of these are set,
then no implicit attachment can be formed.
SQL1430N The database name ″<database>″
User Response: Set one of these environment
cannot be found in the system
variables to a valid instance name and resubmit
database directory on node
the command.
″<nodename>″.
Explanation: When specific database names are
SQL1427N An instance attachment does not
provided to the database monitor, those
exist.
databases must reside either at the node to
Explanation: The application is not attached to which you are currently attached or at the local
an instance. The attempted command/API node.
cannot be executed unless there is an existing
User Response: Make sure the databases listed
instance attachment.
in the request all reside at the node to which you
User Response: If the error occurred when are attached or at the local node. Reissue the
detaching from an instance, continue processing. request.
If the error occurred during the execution of any
other command, attach to an instance and reissue
SQL1431N The relative path ″<path>″ is not
the failed command.
allowed when executing remotely.
Explanation: When the application is remote
SQL1428N The application is already
from the server, relative paths are not allowed.
attached to ″<nodename1>″ while
the command issued requires an User Response: Specify a fully qualified path
attachment to ″<nodename2>″ for that is valid at the server and reissue the
successful execution. command.
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

Chapter 2. SQL Messages 225

 v from a 64 bit client to a 64 bit server
SQL1432N A request has been sent to a
server using a database protocol sqlcode: -1434
which the server does not
recognize. sqlstate: 08004
Explanation: This error is caused by sending a
DB2 request to a server which does not SQL1440W The WITH GRANT OPTION has
understand the database protocol being used to been ignored on the GRANT
transmit the request. This situation will occur (Database Authorities) statement,
most frequently when sending a DB2 ATTACH GRANT (Package Privileges)
request to a server listed in your node directory statement, GRANT (Index
which is not a DB2 Version 2 or greater server. Privileges) statement, or when
This error will also arise if you send an attach granting CONTROL privilege on
request to DB2 for AS/400, DB2 for MVS, or DB2 a table or view.
for VM and VSE servers.
Explanation: The WITH GRANT OPTION is
User Response: Do not attempt to attach to any not applicable when granting database
of the servers listed above. authorities or privileges on packages or indexes.
The WITH GRANT OPTION does not apply to
SQL1433N The application is already CONTROL privilege on tables, views, indexes, or
connected to ″<database1>″ while packages.
the command issued requires a All valid requested privileges were granted.
connection to ″<database2>″ for
successful execution. User Response: When granting database
authorities, package privileges or index
Explanation: In order to successfully process the privileges do not include the WITH GRANT
command, a connection to a database other than OPTION clause. When granting CONTROL, use
that which currently exists is required. The a separate grant statement for the CONTROL
application must either: 1) have no connection privilege without specifying the WITH GRANT
when the command is issued, or 2) already be OPTION clause.
connected to the database required by the
command. sqlcode: +1440

User Response: Ensure that the application has sqlstate: 01516

no connection before issuing the command or
that the connection that exists is to the correct SQL1441N Invalid parameter. Reason code
database. ″<code>″.
Explanation: The following is a list of valid
SQL1434N A CONNECT or ATTACH reason codes:
statement failed because of a
client/server incompatibility 1 A NULL was passed in for the context
between 32 bit and 64 bit pointer.
platforms. 3 The context pointer has been initialized,
Explanation: This release does not support but not to a valid context area.
client/server connections between 32 bit and 64 4. Invalid option
bit platforms.
5 reserved parameter was not NULL
User Response: You can issue a CONNECT or
ATTACH statement in the following scenarios: User Response: Ensure that the application
v from a 32 bit client to a 32 bit server context pointer has been properly initialized and

226 Message Reference, Volume 2

that any options used are valid and try again.
SQL1445N Thread or process does not have a
context to use.
SQL1442N The context is not in use or is not
Explanation: A context type of
in use by the current thread.
SQL_CTX_MULTI_MANUAL is in effect, but the
Reason code ″<code>″.
current thread or process has not been attached
Explanation: The call failed because: to a context.

1 The context is not in use by any thread User Response: Make sure the current thread or
(no attach was done) process is attached to a context before making
any database calls.
2 The context is not in use by the current
thread.
SQL1450N Invalid registration information
3 The current thread is not using a pointer.
context.
Explanation: An invalid registration information
User Response: For a detach call, ensure that pointer was passed to the register/deregister
the context is the one in use by the current DB2 server command/API.
thread, and that a corresponding attach was
done. User Response: Verify that a valid pointer was
passed to the register/ deregister DB2 server
For a get current context call, ensure that the command/API.
thread is currently using a context.

SQL1451N Register/deregister DB2 server

SQL1443N Thread is already attached to a must be issued from a server
context. node.
Explanation: The user attempted to attach a Explanation: Register/deregister DB2 server
context to a thread, and the thread is already was issued from an invalid node.
using a context.
User Response: Reissue the register/deregister
User Response: Detach from the previous DB2 server command/API from a server node.
context before attaching to a new one.

SQL1452N An invalid registration location

SQL1444N The application context cannot be was specified.
destroyed because it is in use.
Explanation: An invalid registration location
Explanation: The user attempted to destroy an was passed to the register/deregister DB2 server
application context while it is still in use. Either command/API.
there is a thread attached to the context, or the
context has a CONNECT or ATTACH associated User Response: Verify that a valid registration
with it. A CONNECT RESET or DETACH must location was passed to the register/deregister
be done (if a CONNECT or ATTACH has been DB2 server command/API.
done), and all threads must detach from the
context before it can be destroyed.
SQL1453N The entry in the database
User Response: Ensure that all calls to attach to manager configuration file for file
a context have a corresponding detach, all server name is missing or invalid.
CONNECTS have a corresponding CONNECT
Explanation: The file server name specified in
RESET, and all ATTACHES have a corresponding
the configuration command/API or in the
DETACH.
database manager configuration file is missing or
invalid.

Chapter 2. SQL Messages 227

User Response: Verify that a file server name re-register the DB2 server.
was specified, that the name does not contain
invalid characters, and is not longer than 48
SQL1457N Register/deregister failed to login
characters in length. Update the file server name
to the NetWare file server
in the database manager configuration file and
specified because a NetWare
resubmit the command/API.
directory services connection is
already established to that file
SQL1454N The entry in the database server.
manager configuration file for
Explanation: A bindery login using
object name is missing or invalid.
NWLoginToFileServer cannot be performed if a
Explanation: The object name specified in the NetWare directory services connection is already
configuration command/API or in the database established to the specified file server.
manager configuration file is missing or invalid.
User Response: Sever the directory services
User Response: Verify that an object name was connection by logging out and detaching from
specified, that the name does not contain invalid Directory Services, and then reissue
characters, and is not longer than 48 characters register/deregister.
in length. Update the object name in the
database manager configuration file and
SQL1458N IPX/SPX has been configured in
resubmit the command/API.
the database manager
configuration file for direct
SQL1455N The entry in the database addressing. It is not necessary to
manager configuration file for IPX register/deregister the DB2 server
socket number is missing or at/from a NetWare file server.
invalid.
Explanation: Issuing register/deregister is not
Explanation: The IPX socket number specified necessary since the database manager
in the configuration command/API or in the configuration file has been configured for
database manager configuration file is missing or IPX/SPX direct addressing. ie. Fileserver and
invalid. objectname have been specified as ’*’.
User Response: Verify that an IPX socket User Response: Note that since the DB2 server
number was specified, that the number does not has been configured for direct addressing only,
contain invalid characters, and is not longer than IPX/SPX clients using fileserver addressing will
4 characters in length. Update the IPX socket not be able to connect to this server. For the
number in the database manager configuration server to support both types of IPX/SPX client
file and resubmit the command/API. addressing, specify a fileserver and objectname
in the database manager configuration file.
SQL1456N The object name specified in the
database manager configuration SQL1460N The environment variable
file already exists on the NetWare ″<variable>″ required for SOCKS
file server. server name resolution is not
defined or not valid.
Explanation: A duplicate object name was
found when trying to register the DB2 server Explanation: The SOCKS environment variable
object name on the NetWare file server. SOCKS_NS or SOCKS_SERVER is not defined.
SOCKS protocol support requires that both these
User Response: The object name specified in
environment variables be defined.
the database manager configuration file is
already in use. Change the object name and then

228 Message Reference, Volume 2

SOCKS_NS on the server instance ″<instance>″ (node
This is the IP address of the domain ″<node-num1>″).
name server where the SOCKS server is
defined. Note: This message may be returned by an
implicit CONNECT or ATTACH.
SOCKS_SERVER
This is the hostname of the SOCKS User Response: Either:
server. v Ensure that svcename has been specified in the
User Response: Define the missing environment database manager configuration on the
variable and resubmit the command. instance ″<instance>″, node ″<node-num1>″,
the DB2COMM environment variable has been
set to use TCP/IP, and that TCP/IP listener
SQL1461N The security option ″<security>″ was successfully started at DB2START time.
is not valid.
or
Explanation: The SECURITY option for a v Explictly catalog the node and database.
TCP/IP node has a value other than ’SOCKS’.
This option is used to enable the TCP/IP node sqlcode: -1468
being cataloged to use SOCKS protocol support
to traverse a firewall. No value other than sqlstate: 08004
’SOCKS’ is permitted.
User Response: Verify that SOCKS protocol SQL1469N Instance ″<instance-name>″
support is required. If so, re-catalog the node (nodenum ″<node-num1>″) does
with SECURITY SOCKS. If not, re-catalog the not have node ″<node-num2>″
node, but omit the SECURITY option. specified in its db2nodes.cfg file.
Explanation: The SET CLIENT command or api
SQL1462N Request is only valid for a or the environment variable DB2NODE was used
syncpoint manager connection. to set the node for CONNECT or ATTACH to
″<node-num2>″. Subsequent CONNECT or
Explanation: A request was attempted which is ATTACH processing was unable to locate this
only valid for a syncpoint manager connection, node in the db2nodes.cfg file on the instance
but the syncpoint manager instance is not ″<instance-name>″ (node ″<node-num1>″).
connected to.
User Response: Connect to the syncpoint Note: This message may be returned by an
manager instance and reissue the request. implicit CONNECT or ATTACH.
User Response: Ensure that the node number
SQL1468N The database manager TCP/IP specified by the SET CLIENT command or api or
listener must be configured and the DB2NODE environment variable exists in the
running on the server instance db2nodes.cfg file of the intermediate instance
″<instance>″ (nodenum ″<instance-name>″, node ″<node-num1>″.
″<node-num1>″) before
sqlcode: -1469
attempting to CONNECT or
ATTACH to node ″<node-num2>″. sqlstate: 08004
Explanation: The SET CLIENT command or api
or the environment variable DB2NODE was used SQL1470N Value of DB2NODE environment
to set the node for CONNECT or ATTACH to variable is not valid.
″<node-num2>″. In order to CONNECT or
Explanation: The DB2NODE environment
ATTACH to this node, the Database Manager
variable indicates the node the application will
TCP/IP listener must be configured and running

Chapter 2. SQL Messages 229

attempt to connect to. If DB2NODE is unset or is
SQL1472N Cannot connect to database
blank, the application will attempt to connect to
″<database-name>″ on node
the default node. Otherwise, DB2NODE must be
″<node-number>″ because the
set to the node number of one of the nodes
difference between the system
defined on the same host as the application.
time on the catalog node and the
User Response: Set the DB2NODE environment virtual timestamp on this node is
variable to one of the following values: greater than the max_time_diff
database manager configuration
unset causes the application to connect to the parameter.
default node.
Explanation: The system time difference for the
blank causes the application to connect to the machines in the configuration (listed in the
default node. db2nodes.cfg file) is greater than the
A number max_time_diff database manager configuration
causes the application to connect to the parameter.
node with that node number. The node User Response: Synchronize the system times
must be running on the same host as on all machines, and ensure that the
the application. max_time_diff parameter is configured to allow
for normal communication delays among the
sqlcode: -1470 database machines.

sqlstate: 08001 If the above does not fix the problem, see the
Administration Guide for possible causes and
actions.
SQL1471N Cannot connect to database
″<database-name>″ on node sqlcode: -1472
″<node-number>″ because the sqlstate: 08004
database on this node is not
synchronized with catalog node.
SQL1473N Cannot commit the transaction
Explanation: The end-of-log information on this because the time difference
node does not match the corresponding record between the system time on the
on the catalog node. This can be caused by local node and the virtual
restoring the database on various nodes with timestamps of node(s)
backups taken from different times. ″<node-list>″ is greater than the
User Response: If the database is restored max_time_diff database manager
without rolling forward on one node, ensure that configuration parameter. The
the database is restored from consistent offline transaction is rolled back.
backups on all nodes without rolling forward. Explanation: The system time difference for the
sqlcode: -1471 machines in the configuration (listed in the
db2nodes.cfg file) is greater than the
sqlstate: 08004 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

230 Message Reference, Volume 2

for normal communication delays among the sqlcode: 1475
database machines.
sqlstate: 01622
sqlcode: -1473
sqlstate: 40504 SQL1476N The current transaction was rolled
back because of error ″<sqlcode>″.
SQL1474W The transaction completed Explanation: A table was being created with the
successfully, but the time NOT LOGGED INITIALLY option, or NOT
difference between the system LOGGED INITIALLY was activated for an
time on the local node and the existing table. During the same unit of work,
virtual timestamps of node(s) either an error occurred, or a ROLLBACK TO
″<node-list>″ is greater than the SAVEPOINT statement was issued. This unit of
max_time_diff database manager work is rolled back, with the following effects:
configuration parameter. v any table that was created in this unit of work
Explanation: The system time difference for the is dropped.
machines in the configuration (listed in the v any NOT LOGGED INITIALLY tables that
db2nodes.cfg file) is greater than the were activated in the transaction are marked
max_time_diff database manager configuration inaccessible, and can only be dropped.
parameter.
The ″<sqlcode>″ reported is the SQLCODE of the
This warning message is returned to read-only original error. The “<sqlcode>” will be 0 if a
transactions because they are not affected by this ROLLBACK TO SAVEPOINT was issued in the
condition. However, other transactions would be transaction.
rolled back. This message is to inform the user
User Response: Correct the problem, then run
about this condition so that action can be taken
the transaction again. Remove any ROLLBACK
at the earliest possible time.
TO SAVEPOINT statement that is used in the
If ″,...″ is displayed at the end of the node list, same transaction in which a NOT LOGGED
see the syslog file for the complete list of nodes. INITIALLY table is created or activated.
User Response: Synchronize the system times sqlcode: -1476
on all machines, and ensure that the
sqlstate: 40506
max_time_diff parameter is configured to allow
for normal communication delays among the
database machines. SQL1477N Table “<table-name>” cannot be
accessed.
sqlcode: 1474
Explanation: An attempt was made to access a
sqlstate: 01607
table that is not accessible. The table may not be
accessible because of one of the following
SQL1475W A system error occurred during reasons:
CONNECT RESET processing. v The table had NOT LOGGED INITIALLY
Explanation: The CONNECT RESET was activated when the unit of work was rolled
successful but a system error such as a node back.
failure or a communications error may have v The table is a partitioned declared temporary
occurred. table and one or more partitions failed since
the temporary table was declared (all declared
User Response: Check the db2diag.log file for
temporary tables have the schema name
details. The database at this node may need to be
SESSION).
restarted.

Chapter 2. SQL Messages 231

v ROLLFORWARD encountered the activation of v Run db2dart on the database and verify the
NOT LOGGED INITIALLY on this table or a validity of the buffer pool files. If the db2dart
NONRECOVERABLE load on this table. reports an error, contact your local service
representative.
Access to this table is not allowed because its
integrity cannot be guaranteed. After making the changes, disconnect from the
database and start the database again.
User Response: One of the following actions
can be taken.
sqlcode: +1478
v If the table had NOT LOGGED INITIALLY
activated, drop the table. If this table is sqlstate: 01626
required, re-create it.
v If the table is a declared temporary table, drop
the table. If this table is required, declare it SQL1479W Attempt to fetch before the result
again. set returned the first rowset.

v Otherwise, restore from a tablespace or Explanation: The requested rowset overlapped

database backup. The backup image must the start of the result set and, depending on the
have been taken subsequent to the commit fetch orientation specified:
point following the completion of the
SQL_FETCH_PRIOR
non-recoverable operation (NOT LOGGED
one of the following situations:
INITIALLY operation, or NONRECOVERABLE
load). v the current position was beyond the
first row, and the number of the
sqlcode: -1477 current row is less than or equal to
the rowset size.
sqlstate: 55019 v the current position was beyond the
end of the result set, and the rowset
SQL1478W The database has been started but size was greater than the result set
only one buffer pool has been size.
activated. SQL_FETCH_RELATIVE
Explanation: Only one small buffer pool with the absolute value of the fetch offset
no extended storage has been activated. This is was less than or equal to the current
because of one of the following reasons: rowset size.
v Not enough memory could be allocated for the SQL_FETCH_ABSOLUTE
total size of the buffer pools and the extended the fetch offset was negative, and the
storage specified for this database. absolute value of the fetch offset was
v The buffer pool files in the database directory greater than the result set size but less
are missing or corrupt. than or equal to the current rowset size.

User Response: Check the db2diag.log file for User Response: No action needed.
the correct source of the problem. Possible
solutions will be: SQL1480N The discover type specified in the
v Drop or alter the size of one or more of the DISCOVER database manager
buffer pools to allow the database to start configuration parameter is
properly. If there is extended storage specified invalid.
for the database, adjust the configuration
values of num_estore_segs and estore_seg_sz Explanation: Valid values for the DISCOVER
for less memory consumption. parameter in the database manager configuration
file are: DISABLE, KNOWN, or SEARCH.

232 Message Reference, Volume 2

User Response: Update the DISCOVER
SQL1491N The database ″<name>″ was not
database manager configuration parameter with
deactivated because the database
a type of DISABLE, KNOWN, or SEARCH.
is still being used.
Explanation: The database cannot be
SQL1481N One or more of the
deactivated if there are any applications
communications protocols
connected to the specified database.
specified in the
DISCOVER_COMM parameter is User Response: Ensure that all applications
invalid. have done a CONNECT RESET, then try again.
Explanation: Valid values for the
DISCOVER_COMM parameter in the database SQL1492N The database ″<name>″ was not
manager configuration file are any combination deactivated because it was not
of NETBIOS, and TCPIP, separated by commas. activated.
User Response: Update the DISCOVER_COMM Explanation: The database cannot be
database manager configuration parameter with deactivated because the specified database was
any combination of NETBIOS, and TCPIP, not active.
separated by commas.
User Response: No action is required.

SQL1482W The BUFFPAGE parameter will

SQL1493N The application is already
only be used if one of the buffer
connected to an active database.
pools is defined with a size of -1.
Explanation: The ACTIVATE DATABASE and
Explanation: This is a warning that the
DEACTIVATED DATABASE commands cannot
BUFFPAGE database configuration parameter
proceed because the application is already
will be ignored if none of the database’s buffer
connected to a database.
pools is defined with a size of -1. -1 indicates
that the buffer pool is to use the BUFFPAGE User Response: Disconnect from the database
parameter as the number of buffer pool pages. then re-submit the command.
User Response: You can select from the
SYSCAT.BUFFERPOOLS to review the buffer SQL1494W Activate database is successful,
pool definitions. If none of the buffer pools are however, there is already a
defined with size -1 (NPAGES), then setting the connection to the database.
BUFFPAGE parameter will not change the size of
the buffer pools for the database. Explanation: There is already database
connection on one or more nodes.

SQL1490W Activate database is successful, User Response: Refer to the diagnostic log to
however, the database has already see which node returns this warning.
been activated on one or more
nodes. SQL1495W Deactivate database is successful,
Explanation: Database has already been however, there is still a
explicitly started (activated) on one or more connection to the database.
nodes. Explanation: There is still database connection
User Response: Refer to the diagnostic log to to one or more nodes.
see which node returns the warning. User Response: Refer to the diagnostic log to
see which node returns this warning.

Chapter 2. SQL Messages 233

 coordinator node, however, on some other
SQL1496W Deactivate database is successful,
node(s) an error has occurred.
but the database was not
activated. User Response: Refer to the diagnostic log to
find out what error has occurred on which node,
Explanation: Database was not explicitly started
fix the problem if possible and then reissue the
on one or more nodes when deactivate database
activate/deactivate database command.
was executed.
User Response: Refer to the diagnostic log to
see which node returns this warning.

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

SQL1500 - SQL1599
is numeric and greater than or equal to 65536
SQL1512N ddcstrc could not write to the
(64K). Note that the memory to be used will be a
specified file.
multiple of 64K. ddcstrc rounds down the
Explanation: ddcstrc was not able to write the buffersize specified to the nearest multiple of
trace information to the filename that it has been 64K.
instructed to write to.
User Response: Ensure that the filename SQL1525N An error occurred when starting
specified is valid for your file system. If a the DB2 security daemon.
filename is not specified, ensure that you have
Explanation: An unexpected error occurred
the necessary permission to write to the default
when starting the DB2 security daemon.
file ddcstrc.tmp.
User Response: Check the db2diag.log file for
further information, and then retry the
SQL1513W ddcstrc has not been turned off.
DB2START command.
Explanation: Because of an error condition
ddcstrc has not been turned off. This was done to
SQL1526N db2start failed because DB2VIA
ensure that the trace information will not be lost
support was not started. Reason
before being safely placed in a file.
code ″<reason code>″.
User Response: Correct the ddcstrc error
Explanation: DB2VIA support was not started
condition reported prior to this error and attempt
successfully at db2start time. The reason code
to turn off the trace again.
indicates the error:
1. The VIPL library specified in DB2_VI_VIPL
SQL1520N Buffersize must be a numeric registry variable could not be loaded.
value greater than or equal to
2. The Device name specified in
65536.
DB2_VI_DEVICE registry variable could not
Explanation: The user specified an invalid be opened.
buffersize for the ddcstrc command. 3. DB2 does not support the VIA
User Response: Ensure that the buffersize used implementation installed.

234 Message Reference, Volume 2

User Response:
SQL1580W Trailing blanks were truncated
1. Make sure the DB2 registry DB2_VI_VIPL is while performing conversion from
properly set and the name specified in codepage ″<source>″ to codepage
DB2_VI_VIPL is in the %PATH% environment ″<target>″. The maximum size of
variable. the target area was ″<max-len>″.
2. Make sure the DB2 registry DB2_VI_DEVICE The source string length was
is properly set. ″<source-len>″ and its
3. DB2 only supports a VIA implementation that hexadecimal representation was
supports at least Reliable Delivery reliability ″<string>″.
level. It is also required that the VIA Explanation: During the execution of the SQL
implementation complies with Intel Virtual statement, a code page conversion operation has
Interface Architecture Implementation Guide resulted in a string that is longer than the
and passes the conformance Suite. Make sure maximum size of the target object. Processing
the VIA implementation you chose satisfies continued because only blank characters were
these requirements. truncated.
User Response: Ensure that the output is as
SQL1530W The specified degree of expected and that the truncation has not caused
parallelism will be ignored any unexpected consequences.
because the system is not enabled
for intra-partition parallelism. sqlcode: 1580

Explanation: Either the DEGREE bind option sqlstate: 01004

was specified with a value greater than 1 or the
SET CURRENT DEGREE statement was executed SQL1581N The table “<table-name>” cannot
with a value greater than 1, but the database be in append mode and have a
manager was not enabled for intra-partition clustering index.
parallelism.
Explanation: There are two situations where
The database manager must be started with the this error is issued.
intra_parallel configuration parameter set to ON
v A clustered index exists for a table and ALTER
in order for the instance to be enabled for
TABLE is used to attempt to place the table in
intra-partition parallelism.
append mode.
The statement or command completed v A table is in append mode and CREATE
successfully, but the degree specification was INDEX is used to attempt to create a
ignored. clustering index.
User Response: If you want to use User Response: If a clustering index is
intra-partition parallelism restart the database necessary then alter the table to set append mode
manager with the intra_parallel configuration off. If append mode is desired, drop the existing
parameter set to ON. clustering index on the table.
Otherwise use a value of 1 or ANY for the sqlcode: -1581
degree specification.
sqlstate: 428CA
sqlcode: +1530
sqlstate: 01623

Chapter 2. SQL Messages 235

 sqlcode: -1584
SQL1582N The PAGESIZE of the table space
“<tbspace-name>” does not match sqlstate: 57055
the PAGESIZE of the bufferpool
“<bufferpool-name>” associated
with the table space. SQL1585N A system temporary table space
with sufficient page size does not
Explanation: The PAGESIZE value specified in exist.
the CREATE TABLESPACE statement does not
match the page size of the bufferpool specified Explanation: One of the following conditions
for use with the table space. These values must could have occurred:
match. 1. The row length of the system temporary table
exceeded the limit that can be accomodated
The statement cannot be processed. in the largest system temporary table space in
User Response: Change the value specified for the database.
PAGESIZE to match the page size of the 2. The number of columns required in a system
bufferpool or change the bufferpool to one that temporary table exceeded the limit that can
has a page size that matches. be accomodated in the largest system
temporary table space in the database.
sqlcode: -1582
The system temporary table space limits depend
sqlstate: 428CB
on its page size. These values are:
Max Max Page size of
SQL1583N PAGESIZE value “<pagesize>” is Record Cols temporary
not supported. Length table space
----------- ---- ------------
Explanation: The PAGESIZE that is specified in 1957 bytes 244 2K
the CREATE BUFFERPOOL or CREATE 4005 bytes 500 4K
TABLESPACE statement is not a supported page 8101 bytes 1012 8K
size. The supported page sizes for Version 5 are 16293 bytes 1012 16K
4K, 8K, 16K, and 32K. 32677 bytes 1012 32K
The statement cannot be processed. User Response: Create a system temporary
table space of a larger page size supported, if
User Response: Specify one of the supported
one does not already exist. If such a table space
page sizes.
already exists, eliminate one or more columns
sqlcode: -1583 from the system temporary table. Create separate
tables or views, as required, to hold additional
sqlstate: 428DE information beyond the limit.
sqlcode: -1585
SQL1584N System temporary tablespace with
page size of at least “<pagesize>” sqlstate: 54048
could not be found.
Explanation: A system temporary table space SQL1590N LONG VARCHAR and LONG
was required to process the statement. There was VARGRAPHIC fields are not
no system temporary table space available that permitted in TABLESPACEs
had a page size of “<pagesize>” or larger. which are built on DEVICEs.

The statement cannot be processed. Explanation: Devices (raw i/o) on HP require

i/o to be aligned on 1024 byte boundaries.
User Response: Create a system temporary LONG VARCHAR and LONG VARGRAPHIC
table space with a page size of at least fields are handled in 512 byte pieces, and thus
“<pagesize>”.

236 Message Reference, Volume 2

can only be used in SYSTEM MANAGED 33 A Load Replace or Load Insert has
TABLESPACEs or in DATABASE MANAGED occured to the table if it is a summary
TABLESPACEs with only FILE containers. table.
User Response: Alternatives: 34 A Load Replace has occured to the table
v Choose one of the LOB columns types after the last integrity check.
(BLOB,CLOB,DBCLOB) instead of LONG. 35 One of the following:
v Use a table space with the correct attributes. v New constraint has been added to the
sqlcode: 1590 table itself or its parents (or its
underlying table if it is a summary
sqlstate: 56097 table) while in check pending.
v If it is a summary table, a Load
Replace has occured to any
SQL1591N The ON option of the SET underlying table of the table after the
INTEGRITY statement is not last refresh.
valid since the table
“<table-name>” is not in the v If it is a summary table, some of its
correct state. underlying table has been taken out
of check pending before it gets
Explanation: The ON option can only be refreshed.
specified on a table that is in the check pending v If it is a summary table, some of its
state and the first (for foreign key constraints), underlying tables were loaded. The
second (for check constraints) and fifth (for table was then refreshed, followed by
summary tables) fields in the CONST_CHECKED some more loads to the same
column of SYSCAT.TABLES catalog must be underlying tables.
either ’Y’ or ’U’.
v Some of its parents (or underlying
User Response: If the table is not in check table if it is a summary table) have
pending, do not specify the ON option. If the been checked for integrity
table is in check pending, perform integrity non-incrementally.
checking on the table (or refresh the table if it is v The table was in check pending state
a summary table) before executing the SET before migration. Full processing is
INTEGRITY statement with the ON option. required for the first time the table is
sqlcode: -1591 checked for integrity after migration.

sqlstate: 55019 36 Incremental processing of a summary

table is not currently supported.

SQL1592N The INCREMENTAL option is not User Response: Do not specify the
valid with reason code INCREMENTAL option. The system will check
“<reason-code>” since the table the entire table for constraint violations (or if it is
“<table-name>” cannot be a summary table, recompute the summary table
incrementally processed. definition query).

Explanation: The cause is based on the sqlcode: -1592

“<reason-code>”: sqlstate: 55019
31 The table is not in check pending state if
the INCREMENTAL option is specified
in a REFRESH TABLE statement.
32 The table is not a REFRESH
IMMEDIATE summary table.

Chapter 2. SQL Messages 237

 parents must have been validated in order to
SQL1593N The REMAIN PENDING option
check integrity for this table. If this is a summary
is not valid since the table
table, all underlying tables must have been
“<table-name>” is not in check
validated in order to refresh this table. A table is
pending state.
validated when the first (for foreign key
Explanation: The table must be in check constraints), the second (for check constraints)
pending state if the REMAIN PENDING option and the fifth (for summary tables) fields in the
is to be specified. CONST_CHECKED column of SYSCAT.TABLES
are either ’Y’ or ’U’.
User Response: Do not specify the REMAIN
PENDING option. User Response: Check integrity for all its parent
tables (or underlying tables if it is a summary
sqlcode: -1593
table) and re-execute this statement.
sqlstate: 55019
sqlcode: -1595
sqlstate: 55019
SQL1594W Some old data remains unverified
by the system and thus some
fields in the CONST_CHECKED SQL1596N WITH EMPTY TABLE cannot be
column of the SYSCAT.TABLES specified for “<table-name>” that
catalog are marked as ’U’. has a dependent REFRESH
IMMEDIATE summary table.
Explanation: The table was previously
unchecked (or checked by users). The statement Explanation: The table “<table-name>” is
SET INTEGRITY ... OFF or LOAD was later referenced in the query for at least one REFRESH
executed which changed some values in the IMMEDIATE summary table. The WITH EMPTY
CONST_CHECKED column to ’W’. When TABLE clause cannot be specified when altering
INCREMENTAL option is specified in the a table to ACTIVATE NOT LOGGED INITIALLY
current statement, the old (non-appended) on a table with such a dependency.
portion of the table remains unchecked by the
The statement cannot be processed.
system, and hence, the corresponding values in
the CONST_CHECKED column are marked as User Response: Remove the WITH EMPTY
’U’ to keep track of it. TABLE clause from the ALTER TABLE statement.
User Response: No action is required. If the sqlcode: -1596
user wants the data integrity of the table to be
maintained by the system, bring the table back sqlstate: 42928
into check pending and re-execute the statement
without the INCREMENTAL option. Full
processing will be chosen by the system, which
will then assume full responsibility of data
integrity of the table.
sqlcode: +1594
sqlstate: 01636

SQL1595N The integrity for table

“<table-name>” cannot be
checked because either a parent
table in a referential constraint
has not been checked or an
underlying table of the summary
table is not checked.
238 Message Reference, Volume 2
Explanation: To avoid propagating this table
with data that might violate integrity checks, all
SQL1600 - SQL1699
User Response: Add a null character at the end
SQL1601N The Database System Monitor
of the character string parameter and reissue the
input parameter “<parameter>” is
command.
a null pointer.
Explanation: The user called one of the
SQL1605W The database “<db-alias>” is not
Database System Monitor APIs and provided a
active.
null pointer instead of a required parameter.
Explanation: The Database System Monitor
The command can not be processed.
Reset API was called for a specific database, but
User Response: The user should reissue the the database was not active.
command with a valid parameter value.
The command completed successfully but no
action was taken.
SQL1602N An object type supplied in the
User Response: Verify that the database alias is
input data structure (sqlma) is not
correct and the database has been started.
supported.
Explanation: An object type specified in the
SQL1606W The Database System Monitor
variable data area of the input data structure
output buffer is full.
(sqlma) for Database System Monitor Snapshot
API is not supported. Explanation: The Database System Monitor
output buffer area is not large enough to
The command can not be processed.
accommodate the returned data. Likely causes
User Response: Reissue the command using a are intense system activity when the call was
valid object type. Refer to the Administrative API made, or in the case of a Database Monitor API
Reference and Application Development Guide for call within a user application, the user allocated
further information about valid object types. a buffer too small to contain the returned data.
The command completed successfully and data
SQL1603N The parameter “<parameter>” is collected prior to the buffer overflow is returned
not specified in the input data in the user’s buffer.
structure (sqlma).
User Response: The user should reissue the
Explanation: A required parameter is not command, or in the case of a Database Monitor
specified in the input data structure (sqlma) of API call within a user application, allocate a
the Database System Monitor Snapshot or larger buffer or reduce the amount of
Estimate Buffer Size API. information requested.
The command cannot be processed.
SQL1607N There is not enough working
User Response: The user should reissue the
memory to execute the requested
command specifying a valid parameter value.
Database System Monitor
function.
SQL1604N The parameter “<parameter>” is
Explanation: The database manager is out of
not null terminated.
working memory to process the Database System
Explanation: A null character is expected at the Monitor command.
end of the character string parameter.
The command can not be processed.
The command can not be processed.
User Response: Reduce the buffer size in the
input parameter and reissue the command.

Chapter 2. SQL Messages 239

 at the time the Database System Monitor API call
SQL1608W Two or more database aliases
was issued. This can occur when a requested
specified on input refer to the
database or application is inactive, or when a
same database.
monitoring group such as the Table group is
Explanation: A Database System Monitor turned OFF, and Table information is requested.
Snapshot or Estimate Buffer Size API call was
User Response: The command completed
issued specifying the same request for two or
successfully, but no data is returned to the user.
more database aliases in the sqlma input data
structure, and they point to the same database. The user should make sure that the databases or
applications for which monitoring is desired are
Database System Monitor executes successfully,
active at the time the Database System Monitor
but returns only one copy of the information in
API is called, or that the desired monitoring
the output buffer.
groups are active.
User Response: No action is required. However,
the user should verify that the database aliases
SQL1612N The specified event monitor target
specified on input are correct if information on
path is invalid.
different databases was expected.
Explanation: The target path specified in the
CREATE EVENT MONITOR statement is not a
SQL1609N The database “<db-alias>” is a
valid path name. The command could not be
remote database and cannot be
processed.
monitored.
User Response: Resubmit the statement with
Explanation: A Database System Monitor API
the correct event monitor target path.
call was issued specifying the database alias of a
remote database. Database System Monitor does sqlcode: -1612
not support monitoring of remote databases.
sqlstate: 428A3
The command cannot be processed.
User Response: The user should verify that the SQL1613N The specified event monitor
database alias specified on input is correct, and option is invalid.
reissue the command with the correct database
alias. Explanation: The option specified in the
CREATE EVENT MONITOR statement is not
valid. Possible causes include:
SQL1610N The Database System Monitor v The specified MAXFILES, MAXFILESIZE, or
input parameter “<parameter>” is BUFFERSIZE is too low.
invalid.
v MAXFILESIZE is smaller than BUFFERSIZE.
Explanation: The user called one of the v MAXFILESIZE NONE was specified with
Database System Monitor APIs and specified an MAXFILES not equal to 1.
invalid value for the specified parameter.
The command could not be processed.
The command can not be processed.
User Response: Resubmit the statement with
User Response: The user should reissue the the corrected event monitor options.
command with a valid parameter value.
sqlcode: -1613
SQL1611W No data was returned by Database sqlstate: 428A4
System Monitor.
Explanation: None of the monitoring
information requested by the users was available

240 Message Reference, Volume 2

SQL1614N An I/O error occurred when SQL1616N The limit on the maximum
activating an event monitor. number of active event monitors
Reason code = ″<reason-code>″. has already been reached.
Explanation: An I/O error was detected when Explanation: A maximum of 32 event monitors
an event monitor was activated. <reason-code> is can be active simultaneously per database. This
one of the following: limit has already been reached. The specified
event monitor cannot be activated.
1 Encountered an unknown event monitor
target type. User Response: If possible, deactivate one of
the active event monitors and resubmit the SET
2 The Event monitor target path was not
EVENT MONITOR statement.
found.
sqlcode: -1616
3 Access to event monitor target path was
denied. sqlstate: 54030
4 Event monitor target path is not the
name of a pipe. SQL1617N The specified event monitor has
already reached its MAXFILES
5 No process has opened the event
and MAXFILESIZE limit.
monitor target pipe for reading.
Explanation: The specified event monitor was
6 Encountered an unexpected I/O error.
created with a limit on the amount of data that
7 The target pipe was not opened in would be allowed in the event monitor target
message mode. (This reason code is directory. This limit has already been reached.
applicable on OS/2 only.) The specified event monitor cannot be activated.

8 The target pipe buffer is too small. The User Response: If possible, delete some of the
inbound pipe buffer must be at least event monitor data files from the target directory,
4096 bytes in size. (This reason code is and resubmit the SET EVENT MONITOR
applicable on OS/2 only.) statement.

User Response: Where possible, fix the problem sqlcode: -1617

described by the reason code, and resubmit the
sqlstate: 54031
SET EVENT MONITOR statement.
sqlcode: -1614
SQL1618N The target path of the specified
sqlstate: 58030 event monitor is in use by another
event monitor.

SQL1615W The specified event monitor is Explanation: The specified event monitor was
already in the requested state. created with the same target path as another
event monitor. This other event monitor was
Explanation: An attempt was made to either activated at least once, and has left .evt and/or
activate an already active event monitor, or .ctl files in the target path. These files may be in
deactivate an already inactive event monitor. The use by application(s) that are reading the event
SET EVENT MONITOR statement was ignored. information they contain.
User Response: No user response is required. User Response: If the other event monitor is
sqlcode: +1615 currently active, deactivate it. After ensuring no
application(s) are using the files it created in the
sqlstate: 01598 target path, remove the files. Then resubmit the
SET EVENT MONITOR statement.

Chapter 2. SQL Messages 241

Alternatively, recreate the required event which the event monitor was created and then
monitor, specifying a different target path, and reissue the SET EVENT MONITOR statement.
resubmit the SET EVENT MONITOR statement.
sqlcode: -1621
sqlcode: -1618
sqlstate: 55033
sqlstate: 51026
SQL1622N The STATE value specified in the
SQL1619N Cannot DROP an active event SET EVENT MONITOR STATE
monitor. statement is invalid.
Explanation: The specified event monitor is Explanation: The STATE value specified in the
currently active, and therefore cannot be SET EVENT MONITOR STATE statement is not
dropped. within the range of valid values, or the value is
NULL as a result of an indicator variable.
User Response: Deactivate the event monitor
and resubmit the DROP EVENT MONITOR Valid values for the Event Monitor State include:
statement.
0 to deactivate the event monitor
sqlcode: -1619
1 to activate the event monitor
sqlstate: 55034
The statement cannot be executed.
SQL1620N Unable to flush event monitor. User Response: Correct the event monitor state
Reason code “<rc>”. value and/or any indicator variable and reissue
the statement.
Explanation: The event monitor could not be
flushed. Possible reasons are: sqlcode: -1622
1. The event monitor is not started. sqlstate: 42815
2. The event monitor is running at a pre-version
6 level of output, for which flush is not
available. SQL1623N The sqlmonsz or sqlmonss API
was called with too many objects
User Response: Ensure that the event monitor specified in the sqlma input
is started. If the event monitor is running at a structure.
pre-version 6 level of output, do not attempt to
flush it. Explanation: The limit imposed on the number
of objects that are permitted in the sqlma input
sqlcode: -1620 structure has been exceeded.
sqlstate: 55034 User Response: Reduce the number of objects
in the sqlma parameter and try the call again.
SQL1621N The transaction in which the
specified event monitor was SQL1624N All databases referenced by the
created has not yet been sqlmonsz or sqlmonss API must
committed. The event monitor be located at the same node.
cannot be activated.
Explanation: The sqlma parameter contained
Explanation: An event monitor cannot be references to databases that reside on different
activated until the transaction in which it was nodes.
created has been committed.
User Response: Modify the sqlma parameter so
User Response: Commit the transaction in that all database objects reference the same node

242 Message Reference, Volume 2

and then try the call again.
SQL1626W Overflow occurred while
performing conversion from
SQL1625W The monitor is not able to convert codepage ″<source>″ to codepage
from the code page ″<source>″ to ″<target>″. The size of the target
the code page ″<target>″. This area was ″<max-len>″ ,the data
conversion was attempted for data pertained to type ″<type>″ and
pertaining to type ″<type>″. the first eight characters are
″<data>″.
Explanation: Possible types are as follows:
1. statement text Explanation: Possible types are as follows:

2. dcs application 1. statement text

3. application 2. dcs application

4. table 3. application

5. locks 4. table

6. table space 5. locks

6. table space
Conversion of data from the source code page to
the target code page is not supported. This The monitor is unable to convert the data due to
condition can occur under the following space constraints. The data is retained in its
conditions: original form.
1. source and target code page combination is User Response: If possible ensure that the
not supported by the database manager. database being monitored and the monitoring
2. source and target code page combination is application are in the same codepage.
not supported by the operating system
character conversion utility on the server
SQL1627W A snapshot api request was made
node.
at the self-describing datastream
This situation can occur when the monitor tries level, but the server was only able
to convert data pertaining to a database whose to return a snapshot of the fixed
code page is incompatible to that of the monitor size structure format.
application.
Explanation: Although the application issuing
User Response: Check your operating system the snapshot request made it at the
documentation for a list of supported SQLM_DBMON_VERSION6 or later level, the
conversions and ensure that the appropriate ones server returning the snapshot returned a
are installed and accessible to the database downlevel view of the data.
manager.
User Response: In the self describing data
If possible ensure that the database being format for snapshot (DB2 version 6 and later),
monitored and the monitoring application are in collected information, including the server level,
the same codepage. is returned as part of the snapshot datastream. In
the pre-version 6 levels of DB2, the snapshot
collected information is returned in an
sqlm_collected structure. You must use the
sqlm_collected structure, and the old data stream
processing method to parse this snapshot
datastream.

Chapter 2. SQL Messages 243

 Development Guide to determine if the function is
SQL1628W A remote get switches operation
supported through a different API call.
returned partial results because
the output buffer is full. To
retrieve the full results, use a SQL1651N The request cannot be executed
minimum buffer size of “<size>” because the DB2 server version
bytes. does not support this
functionality.
Explanation: The output buffer provided was
not large enough to return all the switch data Explanation: Some new functionality is not
available. The monitor returned as much data as supported against older DB2 server versions.
possible using the given output buffer. Another possible cause of this error could be the
request referenced objects with qualifiers of
User Response: Allocate a larger data buffer
length that exceeds the support of the server
and re-issue the switch request.
version.
User Response: Execute the request against a
SQL1629W A remote snapshot operation
DB2 server where the latest DB2 server version
failed on node or nodes
has been installed, or upgrade the server to the
“<node-list>”, with reason code or
latest DB2 server version.
codes “<reason-list>”.
Explanation: Some type of failure occurred
SQL1652N File I/O error occurred.
during an operation on a remote node for reason
<reason-code>, which is one of the following: Explanation: Error occurred either opening,
reading, writing, or closing a file.
1 FCM was unable to communicate with
the target node, due to a node failure or User Response: Check the db2diag.log for
communications error. details. Also, check for disk full conditions, file
permissions, and operating system errors.
2 The snapshot operation failed to
complete on the target node. Please see
the db2diag.log for the specific sqlca. SQL1653N An invalid profile path was
specified.
User Response: If the cause of the error was a
node failure, or communication error, you will Explanation: A full path to a file where server
need to resolve the communication error, or information should be generated must be
restart the node that failed to correct the error. specified.
If the error was due to a snapshot operation User Response: Ensure that the profile path
failure on a remote node, see the db2diag.log for specified is correct and not null.
the sqlca from the failed operation, and refer to
the instructions for that code to correct the
problem. SQL1654N An instance path error was
encountered.

SQL1650N The function invoked is no longer Explanation: The instance path could not be
supported. returned.

Explanation: The user has attempted to call an User Response: Check that the DB2INSTANCE
API that is no longer supported in this version of path was specified correctly. Check that the
the database manager. complete path length specified is not
approaching the maximum supported by the
User Response: The function required may be operating system.
supported by a different API call. Check in the
Administrative API Reference and Application

244 Message Reference, Volume 2

 2. If there was an instance path failure, check
SQL1660N The Generator at the server,
the DB2INSTANCE value to ensure it is
which is used by Discovery to
correctly set.
gather server information, has
failed. 3. If the open or write to file failed, check that
you have access to open and write a file to
Explanation: A server system failure has the <sqllib path>\<instance>\tmp directory
occurred. on Intel machines, or the <instance
User Response: Report the failure to your DB2 path>/sqllib/tmp directory on UNIX
server administrator. More details of the failure machines.
can be found in the server’s db2diag.log file. 4. If get memory failed, check the available
memory on your machine.
SQL1670N The discover type specified in the 5. If retrieving the DBM configuration failed, try
DISCOVER database manager re-booting the machine or re-installing the
configuration parameter indicates product.
discovery is disabled. 6. If a NetBIOS call failed:
Explanation: DISCOVER = DISABLE is v If Add Name failed with a return code of
configured in the database manager 13, check that the nname configured in the
configuration file. DBM configuration was not used to
configure another DB2 client/server on the
User Response: If DISCOVER functionality is network.
required, change the discover type to KNOWN
v Check that NetBIOS was installed and
or SEARCH.
configured properly, and is functioning
correctly.
SQL1671N The search discovery request v Check your network for problems.
failed. Check the db2diag.log for
7. If a DB2 internal system function failed,
further details.
check that the operating system functions on
Explanation: The search discovery request your machine are functioning correctly.
failed for one of the following reasons:
DB2 Service can provide details about the error
1. Initialization failed codes returned by the above functions and
(sqleCommonInitializationForAPIs) written to the db2diag.log.
2. Failed to retrieve the client instance path
(sqloinstancepath)
SQL1673N The address list specified as input
3. Failed to open the output file (sqlofopn) to the discover interface is
4. Failed to write to output file (sqlofprt) invalid.
5. Failed to get memory (sqlogmblk) Explanation: The application program used an
6. Failed to retrieve database manager invalid input address list pointer. The address list
configuration (sqlfcsys) points to nothing.
7. NetBIOS call failed User Response: Ensure that a valid input
8. DB2 internal system function failed (sqlogpid, address list pointer is specified in the application
sqlogmt) program, and that it is not null.

Check the db2diag.log for details.

User Response:
1. If initialization fails, try re-booting the
machine or re-installing the product.

Chapter 2. SQL Messages 245

 administration server. The communications
SQL1674N The server address specified as
information specified is not correct.
input to the discover interface is
invalid. User Response: Verify that DB2ADMINSERVER
is set on the DB2 server instance you are
Explanation: The application program used an
accessing. This indicates that the server instance
invalid input server address pointer. The server
is a DB2 administration server. Retry the
address points to nothing.
KNOWN discovery request with the correct
User Response: Ensure that a valid input server communications information.
address is specified in the application program,
and that it is not null.

SQL1675N Discovery is only allowed against

DB2 administration servers. The
communications information
provided does not access an
administration server.
Explanation: A KNOWN discovery request was
issued against a DB2 server that is not a DB2

SQL1700 - SQL1799
failure) under the previous database manager.
SQL1700N The reserved schema name
Database migration cannot be done until the
″<name>″ was found in the
database has been restarted.
database during database
migration. The command cannot be processed.
Explanation: The database contains one or more User Response: The database must be restarted.
database objects which use the schema name You must issue the RESTART DATABASE
″<name>″ that is reserved by the current command using the release of Database Manager
Database Manager. where the database was last accessed. Then,
resubmit the database migration command under
The command cannot be processed.
the current release of Database Manager.
User Response: Ensure that all the database
objects that use the reserved schema name are
SQL1702W The “<protocol>” connection
dropped and recreate the objects using a different
managers have started
schema name. This correction must be made in
successfully.
the release of Database Manager where the
database was originally created. Ensure that no User Response: No action required.
reserved schema names are in use before
attempting the migration again. Then, resubmit
the database migration command under the SQL1703W The db2event directory could not
current release of Database Manager. be created during database
migration.

SQL1701N The database cannot be migrated Explanation: The database was migrated
because the last session was successfully but the db2event directory could not
abnormally terminated. be created.

Explanation: The last database operation was This is a warning only.

abnormally terminated (for example, a power

246 Message Reference, Volume 2

User Response: The db2event directory must be schema names are dropped and recreate
created if the event monitor is to be used. The the objects using a different schema
db2event directory must be created in the name. This correction must be made in
database directory where the migrated database the release of database manager in use
resides. The database directory of the migrated prior to the current release. Resubmit
database can be determined by invoking LIST the database migration command under
DATABASE DIRECTORY. the current release.
2 Correct the database state by going back
SQL1704N Database migration failed. Reason to release of database manager in use
code ″<reason-code>″. prior to the current release and perform
any necessary corrective action to the
Explanation: Database migration failed. The
database. Resubmit the database
reason codes are as follows:
migration command under the current
1 an invalid schema name was found. release.

2 database is not migrateable. The 3 Increase the database configuration

database could be in one of the parameters logfilsiz or logprimary to a
following states: larger value. Resubmit the database
v backup pending state migration command.

v roll-forward pending state 4 Ensure that there is sufficient disk space

v transaction inconsistent state. and resubmit the database migration
command.
3 database logs are full.
5 There was a problem in updating the
4 insufficient disk space. database configuration file. Ensure that
the database configuration file is not
5 cannot update database configuration
being held exculsively by any users and
file.
is updateable. Resubmit the database
6 failed to relocate database. migration command. If the problem
persists, inform your IBM service
7 failed to access the database
representatives.
subdirectory or one of the database files.
6 Restore the database from the database
8 failed to update database container tag.
backup.
9 table space access is not allowed.
7 Restore the database from the database
10 an invalid type name was found. backup.

11 structured type and function have the 8 Resubmit the database migration
same name. command. If the problem persists,
contact your IBM service representative.
12 structured type/table has an invalid
attribute. 9 Correct the table space by going back to
the release of the database manager in
13 structured type encountered. use prior to the current release. Refer to
User Response: Possible solutions based on the message SQL0290N for the suggested
reason code are: actions to take to correct the table space.

1 The reserved schema names are: 10 The type name is reserved by the
SYSIBM, SYSCAT, SYSSTAT, and system. Ensure that the type and
SYSFUN. Ensure that all the database database objects that use the type are
objects that use one or more of these dropped and recreated using a

Chapter 2. SQL Messages 247

 non-reserved type name. This correction
SQL1706W At least one non local database
must be made in the release of database
was detected in the node directory
manager in use prior to the current
for this instance during word size
release. Resubmit the database
instance migration.
migration command under the current
release. Explanation: While performing word size
instance migration, at least one database not
11 A structured type and function (with no
created under this instance was encountered.
arguments) belonging to the same
Such databases must have the same word size as
schema cannot have the same name.
this instance for migration to complete
Ensure that the type or function and
successfully.
database objects that use the type or
function are dropped and recreated User Response: Ensure that all databases
using a different name. This correction cataloged at the instance have the same word
must be made in the release of database size.
manager in use prior to the current
release. Resubmit the database
SQL1707N Unable to migrate the instance
migration command under the current
word size.
release.
Explanation: There was an error while
12 Attribute may have defaults, may be
attempting to migrate the word size of the
defined as long varchar or long
instance. Please contact your IBM service
vargraphic, or include null constraints.
representative.
The attribute has to be dropped and
added back to the type according to the User Response: Contact your IBM service
attribute definition rules in the CREATE representative.
TYPE statement.
13 Restore the database from the database SQL1708W Database migration completed
backup. Drop all structured types (and with the following warning code:
related objects, e.g., typed tables, typed “<warning-code>”.
views). Resubmit the database migration
command. Explanation: Database migration completed
with a warning. The warning codes are as
follows:
SQL1705W Unable to update a database
directory entry to the current 1 One or more nodes failed to migrate.
release level. User Response: Possible solution based on the
Explanation: One or more database aliases warning codes:
could not be updated in the database directory 1 Check the db2diag.log file to determine
for a database which has just been migrated from which node failed to migrate. Re-issue
a previous release. the database migration command on
User Response: Uncatalog the database alias(es) that node.
for the migrated database and re-catalog the
database alias using the same information.

248 Message Reference, Volume 2

 the nodegroup without adding at least one node.
SQL1749N The NOT LOGGED INITIALLY
If tablespaces are already defined on the
attribute cannot be activated for
nodegroup but there are no tables, ensure that at
table “<table-name>” since it was
least one node has containers for all the table
not created with NOT LOGGED
spaces.
INITIALLY.
sqlcode: -1751
Explanation: The table “<table-name>” was not
created with the NOT LOGGED INITIALLY sqlstate: 428C0
attribute specified and therefore this attribute
cannot be activated using ALTER TABLE.
SQL1752N The table space cannot be created
The statement cannot be processed. in the nodegroup “<ngname>”.
User Response: Remove the NOT LOGGED Explanation: The nodegroup IBMTEMPGROUP
INITIALLY clause from the ALTER TABLE can be specified if and only if the table space is a
statement. system temporary table space.
sqlcode: -1749 User Response: For system temporary table
spaces, specify nodegroup IBMTEMPGROUP. For
sqlstate: 429AA
other table space types, specify a nodegroup
other than IBMTEMPGROUP.
SQL1750N Foreign keys cannot reference a
sqlcode: -1752
parent key table “<table-name>”
that was created with the NOT sqlstate: 429A1
LOGGED INITIALLY clause.
Explanation: A table that was created with the SQL1753N Node “<node-number>” does not
NOT LOGGED INITIALLY clause cannot be have containers for all the system
referenced by a foreign key. temporary table spaces defined in
the nodegroup IBMTEMPGROUP.
User Response: Remove the foreign key
reference to “<table-name>” in the ALTER or Explanation: A node must have containers
CREATE TABLE statement. defined for all the system temporary table spaces
defined in the nodegroup IBMTEMPGROUP for
sqlcode: -1750
this database before it can be included in a
sqlstate: 429A0 nodegroup.
User Response: Issue the ALTER TABLESPACE
SQL1751N The resulting nodegroup would statement to add containers on every node for
not contain any nodes that can be every system temporary table space in the
used in a partition map. database.
Explanation: A nodegroup must contain at least sqlcode: -1753
one node that can be used in a partition map. If
sqlstate: 57052
a node is added to a nodegroup WITHOUT
TABLESPACES, it cannot be included in the
partition map because there are no containers for SQL1754N The index table space or long
the table spaces defined on the nodegroup. If a table space is not in the same
node is added LIKE another node and the other nodegroup as the primary table
node does not have containers for all table space.
spaces on the nodegroup then neither node can
be included in the partition map. Explanation: All the table spaces specified in
the CREATE TABLE statement must belong to
User Response: Do not drop all the nodes in the same nodegroup.

Chapter 2. SQL Messages 249

User Response: Make sure all the table spaces User Response: Ensure that the USING clause
specified in the CREATE TABLE statement without the ON NODES clause is specified or
belong to the same nodegroup. that each node in the nodegroup is included
once in an ON NODES clause.
sqlcode: -1754
sqlcode: -1757
sqlstate: 42838
sqlstate: 428B1
SQL1755N Node “<node-number>” does not
have containers for all the table SQL1758W The containers not designated for
spaces defined in the nodegroup specific nodes are not used by the
“<ngname>”. table space on any node.
Explanation: A node must have containers Explanation: The ALTER TABLESPACE and
defined for all the table spaces defined in a CREATE TABLESPACE statement includes
nodegroup before that node can be included in a container specification for all the nodes in the
redistribution operation of a nodegroup. nodegroup. The specification of the containers
that is not followed by an ON NODES clause is
User Response: Issue the ALTER TABLESPACE
redundant and has been ignored.
statement to add containers on the node for all
the table spaces defined in the nodegroup. The statement has been processed.
User Response: If the containers are needed on
SQL1756N More than one clause specifies some of the nodes, issue an ALTER
containers without the ON TABLESPACE statement to add the necessary
NODES clause. containers.
Explanation: For the CREATE TABLESPACE, sqlcode: -1758
the USING clause without the ON NODES
sqlstate: 01589
clause can only be specified once.
For the ALTER TABLESPACE, the ADD clause
SQL1759W Redistribute nodegroup is
without the ON NODES clause can only be
required to change data
specified once.
partitioning for objects in
The statement was not processed. nodegroup “<nodegroup-name>”
to include some added nodes or
User Response: Correct the statement and
exclude some dropped nodes.
reissue it.
Explanation: This warning indicates that a
sqlcode: -1756
change being made using the ALTER
sqlstate: 428B1 NODEGROUP or ALTER TABLESPACE
statements has not caused the partitioning map
for the nodegroup to be changed. The
SQL1757N A USING clause without an ON partitioning map for a nodegroup is only
NODES clause is missing. changed immediately by these statements if there
Explanation: In CREATE TABLESPACE are no tables defined using any table space
statement, every USING clause specifies the ON defined in the nodegroup or the node being
NODES clause. However not all the nodes in the dropped is not in the partitioning map.
nodegroup are included, and therefore not all This warning is issued in the following cases:
nodes in the nodegroup have containers.
v One or more nodes are added using ALTER
The statement is not processed. NODEGROUP ADD NODE

250 Message Reference, Volume 2

v One or more nodes are dropped using ALTER v If CREATE TABLESPACE, specify a nodegroup
NODEGROUP DROP NODE that is defined for the buffer pool.
v Containers are added for table space and no sqlcode: -1761
further containers are required for a node to
be used. sqlstate: 42735
For all of these cases, a table is already defined
using a table space in the nodegroup. SQL1762N Unable to connect to database
User Response: If you want the node included because there is not enough space
or excluded for data partitioning then issue the to allocate active log files.
REDISTRIBUTE NODEGROUP command or API. Explanation: There is not enough disk space to
Another alternative is to drop all tables that use allocate active log files.
table spaces in the nodegroup.
User Response: Reduce values for
sqlcode: +1759 LOGPRIMARY and/or LOGFILSIZ database
sqlstate: 01618 configuartion parameters so that a smaller set of
active log files are used.

SQL1760N The CREATE statement for stored

procedure “<procedure-name>” SQL1763N There are multiple container
must have a valid LANGUAGE actions in the ALTER
clause, EXTERNAL clause and TABLESPACE statement.
PARAMETER STYLE clause. Explanation: There is more than one type of
Explanation: A required clause is missing in the container action (ADD, EXTEND, or RESIZE) in
CREATE for procedure “<procedure-name>”. an ALTER TABLESPACE statement. You can only
LANGUAGE, EXTERNAL and PARAMETER specify one type of action within a single ALTER
STYLE must be specified. TABLESPACE statement. However, you can
specify the same action multiple times over
User Response: Add the missing clause, then different containers within the statement.
try again.
User Response: Specify only one type of
sqlcode: -1760 container action in the ALTER TABLESPACE
sqlstate: 42601 statement.
sqlcode: -1763
SQL1761N The nodegroup “<ngname>” is sqlstate: 429BC
not defined for the buffer pool
“<bpname>”.
SQL1764N Specified size for a RESIZE action
Explanation: The nodegroup for the table space in an ALTER TABLESPACE
has not been defined for the buffer pool. The statement is smaller than the
table space cannot be created or altered to use current size of the table space
this combination of nodegroup and buffer pool. container.
The statement cannot be processed. Explanation: The size specified in an ALTER
User Response: The possible actions are: TABLESPACE statement using the RESIZE action
is smaller than the current size of the table space
v specify a buffer pool that has defined the
container. You can only increase the size of a
nodegroup for the table space
container.
v alter the buffer pool to add the nodegroup of
the table space User Response: Specify a size that is larger than

Chapter 2. SQL Messages 251

the current size value of the table space sqlstate: 560B0
container.
sqlcode: -1764

SQL1800 - SQL1899
mode has been activated by setting the
SQL1800N An invalid pointer to structure
DB2_NO_PKG_LOCK registry environment
sqle_request_info was passed to
variable to ″ON″.
the catalog admin command/api.
In this mode, the following classes of operations
Explanation: The pointer to structure
are prevented from being executed because of
sqle_request_info passed as a parameter to the
their impact on packages:
catalog admin command/api was invalid. For
Client Configuration Assistance request this v An operation that invalidates packages.
pointer must not be NULL. v An operation that makes a package
inoperative.
User Response: Specify a valid pointer to
sqle_request_info and re-submit the command. v Binding, rebinding (explicitly or implicitly) or
dropping a package.

SQL1801N Invalid request type. Since the requested operation would affect the
package ″<package-name>″ in one of these ways,
Explanation: The specified request type is not the operation is disallowed.
supported for this command.
User Response: Do not attempt disallowed
User Response: Ensure that the request type is operations in ″No Package Lock″ mode. In order
one of the following supported request types: to execute the requested operation, ″No Package
1. SQLE_CCA_REQUEST - CCA catalog node Lock″ mode must be exited. This is accomplished
request for catalog and open scan command by unsetting the DB2_NO_PKG_LOCK
2. SQLE_DAS_REQUEST - DAS catalog node environment registry variable. In order for the
request for catalog and open scan command variable change to take effect, that database
manager must be stopped and restarted.
3. SQLE_CND_REQUEST - Open scan
command for CCA and DAS catalog entries sqlcode: -1803
sqlstate: 57056
SQL1802N No entry belongs to the request
type.
SQL1816N Wrapper “<wrapper-name>”
Explanation: There is no entry in the node cannot be used to access the
directory that is catalogued by the given request “<type-or-version>” of data source
type. (“<server-type>”
“<server-version>”) that you are
User Response: Catalog an entry with the same
trying to define to the federated
request type and re-submit the command.
database.
Explanation: The wrapper that you specified
SQL1803N The requested operation cannot
does not support the type or version of data
be executed in ″No Package Lock″
source that you want to define.
mode. An affected package is
″<package-name>″. User Response: Consult the documentation to
find out which wrapper supports the type and
Explanation: The database manager is currently
version of data source that you want to define.
operating in ″No Package Lock″ mode. This
Make sure that the wrapper has been registered

252 Message Reference, Volume 2

to the federated database by the CREATE
SQL1819N The DROP SERVER statement
WRAPPER statement. Then recode the CREATE
that you submitted could not be
SERVER statement so that it specifies this
processed.
wrapper, and run the CREATE SERVER
statement again. Explanation: The DROP SERVER statement is
preceded in a unit of work by a SELECT
sqlcode: -1816
statement that references a nickname for a table
sqlstate: 560AC or view within the data source (or category of
data sources) that the DROP SERVER statement
references.
SQL1817N The CREATE SERVER statement
does not identify the User Response: Let the unit of work finish; then
“<type-or-version>” of data source resubmit the DROP SERVER statement.
that you want defined to the
sqlcode: -1819
federated database.
sqlstate: 55006
Explanation: When a CREATE SERVER
statement references the wrapper that you
specified, it must also identify the SQL1820N Action on the LOB value failed.
“<type-or-version>” of data source that is to be Reason code = “<reason-code>”.
defined to the federated database.
Explanation: The possible reasons codes are:
User Response: In the CREATE SERVER 1. Not enough buffer space to store the LOB
statement, code the “<type-or-version>” option value.
so that it designates the “<type-or-version>” of
2. The remote data source does not support the
data source being defined. Then run the CREATE
current action on LOB datatype.
SERVER statement again.
3. Some internal programming limitation
sqlcode: -1817 exceeded.
sqlstate: 428EU User Response: Reduce the size of the LOB or
replace the function which is being applied on
SQL1818N The ALTER SERVER statement the LOB datatype. As a last resort, remove the
that you submitted could not be LOB datatype from the statement.
processed. sqlcode: -1820
Explanation: The ALTER SERVER statement is sqlstate: 560A0
preceded in a unit of work by a SELECT
statement that references a nickname for a table
or view within the data source (or category of SQL1821W The LOB value retrieved may
data sources) that the ALTER SERVER statement have changed.
references. Explanation: The LOB value was evaluated on a
User Response: Let the unit of work finish; then deferred retrieval basis. The LOB value may have
resubmit the ALTER SERVER statement. changed between the time it was first accessed
and when it was actually retrieved.
sqlcode: -1818
User Response: Set the ″deferred_lob_retrieval″
sqlstate: 55007 to ″N″ in SYSSERVEROPTIONS, resubmit your
query, or ignore the warning.
sqlcode: +1821
sqlstate: 01621

Chapter 2. SQL Messages 253

 User Response: Verify if all operands point to
SQL1822N Unexpected error code ″<error
different remote tables. If two operands point to
code>″ received from data source
the same remote base table, consider issuing a
″<data source name>″. Associated
rollback to reverse the update/delete operation.
text and tokens are ″<tokens>″.
sqlcode: +1824
Explanation: While referencing a data source,
the federated server received an unexpected sqlstate: 01620
error code from the data source that does not
map to a DB2 equivalent.
SQL1825N This SQL statement cannot be
Possible error codes include: handled in a federated
v 4901 Trying to open more than 15 cursors environment.
v 4902 Row size exceeds 32K limit Explanation: Due to some limitation, the
current SQL statement cannot be handled in a
User Response: Identify and correct the root
federated environment. Possible limitations
cause of the problem by locating the appropriate
include:
message text and corrective action for the
specified error at the data source. v A cursor update/delete statement involves a
refetch of a column into the federated server
that is not being fetched in the cursor select
SQL1823N No data type mapping exists for statement.
data type ″<data type name>″
v Some internal programming limitation is
from server ″<server name>″.
exceeded.
Explanation: An attempt was made to create a
User Response: Based on the cause:
nickname for an object. One or more columns of
that object are of a type currently unknown to v If this is the cursor update/delete statement
the federated server. The name of (one of) the that involves refetch of a column not being
unknown type(s) is listed in the message. fetched in the cursor select statement, modify
the cursor select statement so that the needed
User Response: Create a mapping for the column is fetched.
specified type name on the specified server using
v If some internal programming limitation is
the CREATE TYPE MAPPING statement.
exceeded, try to simplify or rewrite the part of
sqlcode: -1823 the statement that seems complex, e.g.
expression.
sqlstate: 428C5
sqlcode: -1825
SQL1824W Some base tables in the operands
sqlstate: 429A9
of this UNION ALL may be the
same table.
SQL1826N An invalid value “<value>” was
Explanation: A nickname can refer to a remote
specified for column
base table, a remote view, a remote
“<column-name>” in a system
alias/synonym, or a remote nickname. If two
catalog object “<object-name>”.
operands of a UNION ALL view refer to
different nicknames, they may potentially be Explanation: An invalid value “<value>” was
pointing to the same table (if not both of them specified for a column “<column-name>” in a
are known to be remote base tables). This system catalog object “<object-name>”.
message is issued to warn the user that
potentially one remote base table can get The statement cannot be processed.
updated/deleted twice via updates/deletes User Response: Refer to the SQL Reference for
through two operands. valid values for the specified column in the

254 Message Reference, Volume 2

specified system catalog object. Correct the
SQL1830N RETURNS clause must be
statement and reissue it.
specified prior to a predicate
sqlcode: -1826 specification using the
EXPRESSION AS clause.
sqlstate: 23521
Explanation: The RETURNS clause is not
specified before the PREDICATE clause that
SQL1827N No user mapping is defined from includes the EXPRESSION AS clause. The
local authorization ID RETURNS clause may have been included after
″<auth-ID>″ to server the predicate specification or may be missing.
″<server-name>″.
The statement cannot be processed.
Explanation: An attempt was made to drop or
alter a user mapping that is not defined. User Response: Specify the CREATE
FUNCTION statement with the RESULTS clause
User Response: If it is an ALTER USER prior to the PREDICATE clause.
MAPPING statement, first create a user mapping
using the CREATE USER MAPPING statement. sqlcode: -1830
Then, alter the user mapping. If it is a DROP
sqlstate: 42627
USER MAPPING statement, no extra action is
needed because the user mapping does not exist.
SQL1831N Table statistics for a subtable
sqlcode: -1827
“<subtable-name>” cannot be
sqlstate: 42704 updated.
Explanation: The statement attempts to update
SQL1828N No server option ″<option-name>″ the statistics values of NPAGES, FPAGES, or
is defined for remote server OVERFLOW, for table “<subtable-name>”, that is
″<server-name>″ or for a group of defined as a subtable. For typed tables, these
remote servers: server type statistics can only be updated using the root
″<server-type>″, version table of the table hierarchy.
″<server-version>″, and protocol
The statement cannot be processed.
″<server-protocol>″.
User Response: Update the catalog statistics for
Explanation: An attempt was made to drop or
the root table of the table hierarchy instead of the
alter a server option that is not defined.
subtable.
User Response: If it is an ALTER SERVER
sqlcode: -1831
statement, first create a server option using the
CREATE SERVER statement. Then, alter the sqlstate: 428DY
server option. If it is a DROP SERVER statement,
no extra action is needed because the server
SQL1832N The routine “<routine-name>”
option for the servers does not exist.
cannot be used to define a filter
sqlcode: -1828 because it is defined as an SQL
function.
sqlstate: 42704
Explanation: The routine (function or method)
“<routine-name>” is specified in a FILTER clause
for a user defined predicate specification or an
index extension definition. The routine can not
be defined with LANGUAGE SQL.
The statement cannot be processed.

Chapter 2. SQL Messages 255

User Response: Specify a routine that is not sqlcode: -1883
defined with LANGUAGE SQL.
sqlstate: 428EG
sqlcode: -1832
sqlstate: 429B4 SQL1884N You specified “<option-name>” (a
“<option-type>” option) more
than once.
SQL1881N “<option-name>” is not a valid
“<option-type>” option for Explanation: You entered a statement that
“<object-name>”. references the same option multiple times.
Explanation: The specified option might not User Response: Recode the statement so that it
exist, or it might not be valid for the particular references the option that you want only once.
data source, data source type, or database object Then resubmit the statement.
that you’re working with.
sqlcode: -1884
User Response: Consult the SQL Reference to
sqlstate: 42853
verify the option that you want. Then revise and
resubmit the statement that you want to run.
SQL1885N The “<option-type>” option
sqlcode: -1881
“<option-name>” is already
sqlstate: 428EE defined.
Explanation: You entered a value for an option
SQL1882N The “<option-type>” option that already has a value.
“<option-name>” cannot be set to
User Response: Query the appropriate catalog
“<option-value>” for
view to determine what value the option is
“<object-name>”.
currently set to. If this value differs from the one
Explanation: The value that you specified either that you want, recode the statement so that the
lacks the proper delimiters or is invalid. SET keyword follows the OPTIONS keyword. To
find out what catalog view contains the values
User Response: Consult the SQL Reference to
for this option, consult the SQL Reference.
verify the value that you want. Then revise and
resubmit the statement that you want to run. Be sqlcode: -1885
sure to delimit the value in single quotes.
sqlstate: 428EH
sqlcode: -1882
sqlstate: 428EF SQL1886N The “<operation-type>” operation
is not valid because the
“<option-type>” option
SQL1883N “<option-name>” is a required
“<option-name>” has not been
“<option-type>” option for
defined.
“<object-name>”.
Explanation: You tried to change or delete a
Explanation: You did not specify an option that
value for an option that has not been defined for
DB2 requires in order to process the statement
the data source, data source type, or database
that you submitted.
object that you’re working with.
User Response: Consult the documentation to
User Response: If you specified SET in the
find out the options that are required for the
statement that you want to run, recode the
statement that you want to run. Then revise and
statement, either omitting SET or replacing it
resubmit this statement.
with ADD (ADD is the default). Then resubmit
the statement. If you specified DROP, do nothing.

256 Message Reference, Volume 2

sqlcode: -1886 User Response: Add the SPECIFICATION
ONLY clause and then resubmit the statement.
sqlstate: 428EJ
sqlcode: -1887
SQL1887N SPECIFICATION ONLY clause sqlstate: 42601
required.
Explanation: A CREATE INDEX statement for a
nickname must have a SPECIFICATION ONLY
clause.

SQL1900 - SQL1999
User Response: Correct and resubmit the
SQL1900N The command completed
command.
successfully.
Explanation: The command line utility
successfully completed the command.
User Response: No action is required.

SQL1901N The syntax of the command is not

correct.
Explanation: The command line utility could
not process the command.

SQL2000 - SQL2099
The utility stops processing.
SQL2000N The drive specified in the utility
command is not a valid diskette User Response: Restart the application or
drive or fixed disk. reissue the command, if needed. The output data
from the interrupted command may be
Explanation: The input or output drive
incomplete, and should not be used.
specified in the utility command does not exist.
The utility stops processing.
SQL2002N The specified database utility
User Response: Resubmit the utility command command is not valid for remote
with the correct drive specifier. databases. The database specified
in the command must reside on
your local workstation.
SQL2001N The utility was interrupted. The
output data may be incomplete. Explanation: The database utility command is
only valid for local databases.
Explanation: The user may have pressed the
interrupt key sequence, or had called the utility The utility stops processing.
with a terminate caller action.
User Response: Run the utility locally.
This message can also be returned by DB2
Enterprise - Extended Edition during a backup
SQL2003C A system error occurred.
or restore operation on a database node when
the database catalog node is down. Explanation: An operating system error
occurred. The return code can be found in the

Chapter 2. SQL Messages 257

SQLERRD[0] field of the SQLCA. the data is first copied to an internal buffer. Data
is then written from this buffer to the backup
The utility stops processing.
media when the buffer is full. The buffersize of
User Response: Look at the error return code in “<buffersize>” 4K buffers that was specified is
the SQLERRD[0] field of the SQLCA. Correct the inadequate.
error, if possible, and resubmit the command.
User Response: Use a larger buffersize.

SQL2004N An SQL error “<sqlcode>”

SQL2008N The callerac parameter is not
occurred during processing.
within valid range or the
Explanation: The utility was using an SQL requested action is out of
statement when an error occurred. sequence.

The utility stops processing. Explanation: Either the callerac parameter value
is not one of the acceptable values or the
User Response: Look at the SQLCODE requested action is out of sequence.
(message number) in the message for more
information. Make changes and resubmit the The command cannot be processed.
command.
User Response: Each utility has its own list of
valid callerac values. Check the Application
SQL2005C An I/O error occurred during a Development Guide for the valid values for the
read operation. The data may be callerac for the utility in use. Resubmit the
incomplete. command with a valid callerac parameter.

Explanation: Incomplete data was read during

an I/O operation. SQL2009C There is not enough memory
available to run the utility.
The utility stops processing.
Explanation: More memory is needed to run
User Response: Determine if the I/O error can the specified utility.
be corrected and resubmit the command.
The command cannot be processed.
SQL2006C An I/O error occurred during a User Response: Possible actions include:
write operation. The data may be v Verify that your system has sufficient real and
incomplete. virtual memory.
Explanation: Incomplete data was written v Remove background processes.
during an I/O operation. v Increase the DBHEAP database configuration
The utility stops processing. parameter.

User Response: Determine if the I/O error can

be corrected and resubmit the command. SQL2010N The utility encountered an error
″<error>″ while connecting to the
database.
SQL2007N Specified buffersize of
“<buffersize>” 4K buffers is too Explanation: The utility could not connect to
small for “<pagesize>” page size the database.
object. The utility stops processing.
Explanation: To backup a “<pagesize>” page User Response: Look at the error number in the
size database object one needs a buffer larger message for more information. Make changes
than the page size. When backing up a database and resubmit the command.

258 Message Reference, Volume 2

 configuration file and the database configuration
SQL2011N The utility encountered an error
file for inconsistent values. Resubmit the
″<error>″ while disconnecting
command.
from the database.
Explanation: The utility could not disconnect
SQL2015N The database parameter is not
from the database.
valid. The database name is too
The utility stops processing. long, it was not specified, or the
address of the name is not valid.
User Response: Look at the error number in the
message for more information. Make changes Explanation: The database name is required. It
and resubmit the command. must contain 1 to 8 characters and the characters
must be chosen from the database manager base
character set. The name must be located at a
SQL2012N Interrupt handling could not be
valid address for the application.
enabled.
The utility stops processing.
Explanation: The utility could not enable
interrupt handling. The actual return code can be User Response: Resubmit the command with a
found in the SQLERRD[0] field of the SQLCA. valid database name.
The utility stops processing.
SQL2016C The PATH command does not
User Response: Look at the error return code in
contain a path to
the SQLERRD[0] field of the SQLCA. Correct the
“<program-name>”.
error, if possible, and resubmit the command.
Explanation: The utility could not find the
required program using the operating system
SQL2013N The utility could not access the
Select Path.
database directory. Error “<error>”
was returned. The utility stops processing.
Explanation: An error occurred while the utility User Response: Update the PATH command to
was accessing the database directory. include the path to the indicated program name.
The utility stops processing.
SQL2017N Too many sessions are already
User Response: If the path in the database
started or OS/2 Start Session did
parameter is not the database directory path,
not complete successfully.
resubmit the command with the correct path.
Otherwise, look at the error number in the Explanation: The BACKUP or RESTORE utility
message for more information. Make changes could not start the new session because:
and resubmit the command. v The maximum number of sessions is already
started.
SQL2014N A database environment error v The OS/2 Start Session program returned an
occurred. error.
Explanation: The utility received an error from The utility stops processing.
a database environment command. The database
User Response: Wait until some of the current
manager configuration file and the database
sessions stop processing and resubmit the
configuration file may contain incompatible
command. Or, see the SQLERRD[0] field in the
values.
SQLCA for more information and resubmit the
The utility stops processing. command.
User Response: Check the database manager

Chapter 2. SQL Messages 259

 v Reinstall the database manager or reapply any
SQL2018N The utility encountered an error
recent updates or do both.
“<error>” while attempting to
verify the user’s authorization ID v Bind the utility programs (db2uxxxx.bnd files)
or database authorizations. individually to the database (with no format
option) to isolate the problem and, possibly
Explanation: The user attempted to execute a enable some utilities to operate successfully.
utility and one of the following has occurred:
v The user authorization ID is not valid.
SQL2020N The utility is not bound to the
v An error occurred attempting to access the database correctly.
user’s authorizations for the database.
Explanation: All the utilities were rebound to
The utility stops processing. the database because the utility was not bound
User Response: Look at the error number in the to the database or the package of the utility that
message for more information. Make changes was bound to the database was not compatible
and resubmit the command. with the installed version of the database
manager, but there is still a timestamp conflict
between the installed version of the database
SQL2019N An error occurred while binding manager and the package so the utility and bind
the utilities to the database. file are not compatible.
Explanation: Because the current level of the The utility stops processing.
utility being executed was not bound to the
database, the system attempted to bind all User Response: Reinstall the database manager
utilities to the database and this binding process or reapply any recent updates or do both.
failed. Possible causes for the error include: Resubmit the utility command.
v The system may have run out of disk space.
v A system resource problem such as too many SQL2021N The correct diskette is not in the
files opened. drive.
v A missing or invalid list of utility programs to Explanation: The diskette to be used for Backup
be bound (db2ubind.lst). Database or for Restore Database is not in the
v A missing or invalid bind file for one of the drive or is not valid.
utilities (db2uxxxx.bnd). The command cannot be processed.
v The user does not have the required
User Response: Verify that the correct diskette
authorization for binding utilities. The
is in the drive or insert a new diskette.
required privileges are:
– BIND privilege for the utility programs
SQL2023N The utility encountered an I/O
– SELECT privilege for the system catalogs.
error “<code>” while accessing
For the RESTORE utility, the database is restored, the log control file.
but at least one utility is not bound to the
Explanation: The read or write operation
database. The other utilities stop processing.
against the log control file failed.
User Response: Complete all activities that may
The utility stops processing.
be competing for system resources and resubmit
the utility command. If the error continues, User Response: Record the error return code
perform one of the following actions: value. Determine whether the I/O error can be
v Have a user with SYSADM or DBADM corrected.
authority retry the command.

260 Message Reference, Volume 2

 database configuration file may contain
SQL2024N The utility encountered an I/O
incompatible values.
error “<code>” while accessing
the .BRG file. The utility stops processing.
Explanation: An I/O error occurred while User Response: Look at the SQLCODE
accessing the specified file. (message number) in the message for more
information. Make changes and resubmit the
The .BRG file is used to determine whether a
command. Check that the database manager
Restore operation has terminated abnormally.
configuration file values and the backup image’s
The .BRG file resides in the local database
database configuration file values are compatible.
directory of the database in question and consists
of a filename equivalent to the database token
and filetype of .BRG. SQL2028N Error “<sqlcode>” occurred while
installing the interrupt handler.
The utility stops processing.
Explanation: The utility could not enable the
User Response: Record the error return code.
interrupt handler. The SQLCODE is returned in
Determine whether the I/O error can be
the message.
corrected.
The utility stops processing.
SQL2025N An I/O error “<code>” occurred User Response: Look at the SQLCODE
on media “<dir/devices>”. (message number) in the message for more
information. Make changes and resubmit the
Explanation: An I/O error occurred while
command.
accessing a file on the specified media.
The utility stops processing.
SQL2029N An error “<error>” occurred while
User Response: Record the error return code. “<command-file-name>” was
Determine whether the I/O error can be processing.
corrected.
Explanation: An error was returned from either
the specified command file, or from the
SQL2026N An error ″<sqlcode>″ occurred operating system.
while trying to internally
User Response: The user has either requested a
disconnect from the database.
“Backup changes only” of a database enabled for
Explanation: The internal disconnect command ROLLFORWARD recovery, or has requested a
failed. The SQLCODE is returned in the message. “Backup changes only” while requesting the use
of the user exit.
The utility stops processing.
User Response: Look at the SQLCODE
SQL2030N The “<name>” drive is full. At
(message number) in the message for more
least “<number>” free bytes are
information. Make changes and resubmit the
needed on this drive.
command.
Explanation: The specified drive does not have
enough space for creating an internal
SQL2027N An error ″<sqlcode>″ occurred
subdirectory and information file.
while trying to internally connect
to the database. The utility stops processing.
Explanation: The internal connection failed. The User Response: Free the indicated space on the
SQLCODE is returned in the message. The specified drive and resubmit the command.
database manager configuration file and the

Chapter 2. SQL Messages 261

SQL2031W Warning! Please mount the target SQL2035N The warning condition ″<warn>″
or source media on device was encountered while executing
″<device>″. the utility in non-interrupt mode.
Explanation: A database utility process either Explanation: The calling application invoked
writes data to or reads data from the media on the utility with no interrupt mode. During the
the specified device. The utility returns so that operation a warning condition was encountered.
the user may mount the correct media for the
User Response: Resubmit the operation without
operation.
specifying the no interrupt condition in the
The utility waits for a response to continue. callerac parameter or take actions to prevent the
warning and resubmit the operation.
User Response: Mount the media and return to
the utility with the callerac parameter indicating
if processing continues or ends. SQL2036N The path for the file or device
“<path/device>” is not valid.
SQL2032N The ″<parameter>″ parameter is Explanation: The application calling the utility
not valid. has supplied a source or target path that is not
valid. The path or device specified may not exist
Explanation: The parameter is incorrectly
or is incorrectly specified.
specified. Either the value is out of range or is
incorrect. User Response: Reissue the utility command
with a path that represents a correct path or
User Response: Resubmit the command with a
device.
correct value for the parameter.

SQL2037N TSM could not be loaded.

SQL2033N The TSM error ″<error>″ occurred.
Explanation: A call to a database utility
Explanation: During the processing of a
specified TSM as the target or source of the
database utility, TSM was called and encountered
backup. An attempt was made to load the TSM
an error.
client. Either the TSM client is not available on
User Response: Consult the TSM the system or an error was encountered in the
documentation for a description of the error, take load procedure.
corrective actions and resubmit the command.
User Response: Ensure that the system has
TSM available. Resubmit the command after
SQL2034N The address of the ″<parm>″ TSM is made available, or resubmit the
parameter is not valid. command without utilizing TSM.

Explanation: The application program used an

address that is not valid for this parameter. SQL2038N A database system error
Either the address points to an unallocated buffer ″<errcode>″ occurred during
or the character string in the buffer does not processing.
have a null terminator.
Explanation: A database system error was
User Response: Ensure that a valid address is encountered during the processing of one of the
used in the application program and the input utilities.
string is null terminated.
User Response: Examine the error code in the
message for more information. Take corrective
action and resubmit the command.

262 Message Reference, Volume 2

SQL2039N The application calling the utility SQL2042W Warning! I/O error ″<error>″
has terminated. accessing device ″<device>″.
Additional information (if
Explanation: The application calling the utility
available):
has terminated. The application side of the utility
″<additional_information>″.
is in the same process as the calling application
Please ensure media is mounted
and terminates with the application. The agent
and positioned correctly.
side of the utility terminates as a result.
Explanation: The application calling the utility
User Response: Reissue the command after
has encountered an I/O error while trying to
determining why the application terminated.
read or write to the tape device. The utility
returns so that the user may correctly mount and
SQL2040N The database alias parameter position the tape.
“<dbalias>” is not valid or not
The message may contain additional information
specified.
to help diagnose the problem.
Explanation: The application calling the Backup
The utility waits for a response to continue.
or Restore utility has supplied a database alias
parameter that is not valid. The alias must be 1 User Response: Correctly mount and position
to 8 bytes and the characters must be chosen the tape and return to the utility indicating if
from the database manager base character set. processing continues or ends.
User Response: Reissue the Backup or Restore The error, device and the additional information
command with a valid database alias. (if present) can be used to diagnose and correct
the problem.
SQL2041N The buffer size parameter
specified is not valid. The buffer SQL2043N Unable to start a child process or
size must be specified as 0 or be thread.
between 8 and 16384 inclusive.
Explanation: Unable to start up the child
Explanation: The application calling the utility processes or threads required during the
has supplied a buffer size parameter that is not processing of a database utility. There may not be
valid. The buffer size is used to determine the enough available memory to create the new
internal buffer size. The value is the number of process or thread. On AIX-based systems, the
4K pages that are obtained for this buffer. The maxuproc value set by the chdev command may
value must be specified as 0 or be between 16 be too low. On OS/2-based systems, the
and 16384 inclusive. THREADS value set in CONFIG.SYS may be too
low. The utility stops processing.
When running the backup or restore utility, if 0
is specified, the default buffer size defined in the User Response: Ensure the system limit for
database manager configuration is used. number of processes or threads has not been
reached (either increase the limit or reduce the
If the target media is a diskette, the buffer size
number of processes or threads already running).
must be smaller than the diskette size.
Ensure that there is sufficient memory for the
new process or thread. Resubmit the utility
command.

Chapter 2. SQL Messages 263

 determination documentation for your operating
SQL2044N An error occurred while accessing
system and correct the ″<error>″ condition.
a message queue. Reason code:
Return to the utility with the correct caller action
“<reason-code>”
parameter to indicate if processing should
Explanation: An unexpected error or bad continue or terminate.
message was received on one of the message
queues during the processing of a database
SQL2048N An error occurred while accessing
utility. The following is a list of reason codes:
object “<object>”. Reason code:
1 Unable to create a message queue. The “<reason-code>”.
number of message queues allowed may
Explanation: An error occurred while accessing
have been exceeded.
an object during the processing of a database
2 An error was encountered while reading utility. The following is a list of reason codes:
from a message queue.
1 An invalid object type is encountered.
3 An error was encountered while writing
2 A lock object operation failed. The lock
to a message queue.
wait may have reached the lock timeout
4 An invalid message was received from a limit specified in the database
message queue. configuration.
5 An error was encountered while 3 An unlock object operation failed during
opening a message queue. the processing of a database utility.
6 An error was encountered while closing 4 Access to an object failed.
a message queue.
5 An object in the database is corrupted.
7 An error was encountered while
6 The object being accessed is a table
querying a message queue.
space and either the table space is in
8 An error was encountered while such a state that the operation is not
deleting a message queue. allowed or one or more containers of
the table space is not available. (LIST
The utility stops processing. TABLESPACES will list the current table
space state.)
User Response: Ensure the number of message
queues allowed is not reached. Reduce the 7 A delete object operation failed.
number of message queues in use if necessary
8 Trying to load/quiesce into a table that
and resubmit the utility command.
is not defined on this partition.

SQL2045W Warning! Error ″<error>″ occurred The utility stops processing.

while writing to media
User Response: If a lock object operation failed,
“<media>”.
ensure the lock timeout limit in the database
Explanation: A database utility process configuration is adequate and resubmit the
encountered error ″<error>″ returned by the utility command. You may also consider using
operating system while writing to the media the QUIESCE command to bring the database to
″<media>″. The utility returns so that the user a quiesced state to ensure access.
may attempt to fix the problem or cancel the
If the error was encountered during backup, take
operation.
corrective action to recover the database and
The utility waits for a response to continue. resubmit the utility command.
User Response: Consult the problem If the error was encountered during restore or

264 Message Reference, Volume 2

load recovery, ensure the backup or copy image The utility stops processing.
is correct and resubmit the utility command.
User Response: Ensure the media used is not in
If the object is a table space and the error was use currently. Resubmit the command with a
encountered during a restore, the set table space valid media list.
container api may be used to modify the table
space before resubmitting the utility command.
SQL2058W An end-of-media warning was
encountered on media “<media>”.
SQL2054N The backup or copy image is
Explanation: An end-of-media warning was
corrupted.
encountered during the processing of a database
Explanation: The backup or copy image in use utility. This error can also occur if an invalid tape
is corrupted device block size was specified.
The utility stops processing. The utility is waiting for a response to continue.
User Response: Discard the image as it is not a User Response: Correct the end-of-media
valid image. Resubmit the utility command with condition and return to the utility with the
a valid image. correct caller action parameter to indicate if
processing should continue or terminate.
SQL2055N Unable to access memory from The tape device block size (or blocking factor)
memory set “<memory-heap>”. used at restore time must be the same as that
used during the backup. If a variable block size
Explanation: A database utility was unable to
is used, then the buffer size used must be less
access memory during processing.
than or equal to the maximum block size of the
The utility stops processing. tape device.

User Response: Stop the database manager,

then restart it and resubmit the utility command. SQL2059W A device full warning was
encountered on device
“<device>”.
SQL2056N An invalid media type was
encountered on media “<media>”. Explanation: An device full warning was
encountered during the processing of a database
Explanation: An invalid media type was utility.
encountered during the processing of a database
utility. The utility is waiting for a response to continue.
The utility stops processing. User Response: Correct the device full
condition and return to the utility with the
User Response: Ensure the media used is correct caller action parameter to indicate if
among of the types supported by the utility. processing should continue or terminate.
Resubmit the command with a valid media list.

SQL2060W The device “<device>” is empty.

SQL2057N The media “<media>” is already
opened by another process. Explanation: An empty device was encountered
during the processing of a database utility. The
Explanation: The source or target media utility is waiting for a response to continue.
specified during the processing of a database
utility is already open by another process. The User Response: Mount the media and return to
utility does not allow shared access for the the utility with the caller action parameter to
operation. indicate if processing should continue or
terminate.

Chapter 2. SQL Messages 265

SQL2061N An attempt to access media SQL2066N Table space name ″<name>″
“<media>” is denied. specified does not exist in the
database or cannot be used for the
Explanation: An attempt to access a device, file,
utility operation.
TSM or the vendor shared library is denied
during the processing of a database utility. The Explanation: The table space name specified is
utility stops processing. syntactically correct, but it does not exist in the
database or cannot be used in an utility
User Response: Ensure the device, file, TSM or
operation. If the utility in use is a backup
vendor shared library used by the utility allows
operation, the table space may be disallowed
the access requested and resubmit the utility
because it is a system or user temporary table
command.
space or is in an inconsistent state.
User Response: Check the table space name
SQL2062N An error occurred while accessing
and resubmit the utility command with the
media “<media>”. Reason code:
correct table space name.
“<reason-code>”
Explanation: An unexpected error occurred
SQL2068N An invalid image was
while accessing a device, file, TSM or the vendor
encountered on media “<media>”.
shared library during the processing of a
There was no media header.
database utility. The following is a list of reason
codes: Explanation: An invalid image was encountered
during the processing of a database utility. The
1 An attempt to initialize a device, file,
utility was not able to locate a valid media
TSM or the vendor shared library failed.
header. The utility stops processing.
2 An attempt to terminate a device, file,
User Response: Resubmit the command with
TSM or the vendor shared library failed.
correct backup or copy images.
other If you are using TSM, this is an error
code returned by TSM.
SQL2069N An invalid image was
encountered on media “<media>”.
The utility stops processing. The image was created for
User Response: Ensure the device, file, TSM or database alias “<dbalias>”.
vendor shared library used by the utility is Explanation: An invalid image was encountered
available and resubmit the utility command. If during the processing of a database utility. The
the command is still unsuccessful, contact your image provided was from a different database
technical service representative. alias. The utility stops processing.
User Response: Resubmit the command with
SQL2065W Caller action “<caller-action>” correct backup or copy images.
specified is not allowed when the
media “<media>” specified is the
only one left connected to the SQL2070N An invalid image was
utility. encountered on media “<media>”.
The image contained timestamp
Explanation: The caller action specified is not “<timestamp>”.
allowed because there is only one device left
connected to the database utility. Explanation: An invalid image was encountered
during the processing of a database utility. The
User Response: Return to the utility with the image provided was from a backup or copy with
correct caller action parameter to indicate if
processing should continue or terminate.

266 Message Reference, Volume 2

a different timestamp. The utility stops User Response: Resubmit the command. If the
processing. problem still exists, resubmit the command after
shutdown and restart of DB2 and the DB2 Data
User Response: Resubmit the command with
Links Managers.
correct backup or copy images.
The Restore utility can avoid DATALINK
processing by specifying WITHOUT DATALINK.
SQL2071N An error occurred while accessing
the shared library
“<shr-lib-name>”. Reason code: SQL2074N DATALINK processing failed
“<reason-code>” because of internal problems at
the database server.
Explanation: An unexpected error occurred
while accessing a vendor shared library during Explanation: An unexpected error occurred
the processing of a database utility. The while processing DATALINK values.
following is a list of reason codes:
User Response: Resubmit the command. If the
1 An invalid shared library path was problem still exists, resubmit the command after
encountered. shutdown and restart of DB2.
2 An attempt to load the backup shared The Restore utility can avoid DATALINK
library failed. processing by specifying WITHOUT DATALINK.
3 An error was encountered while
unloading the shared library. SQL2075N DATALINK processing failed
because of internal problems at
The utility stops processing. the DB2 Data Links Manager.

User Response: Ensure the shared library Explanation: An unexpected error occurred
provided is valid and resubmit the utility while processing DATALINK values.
command or use another supported media.
User Response: Resubmit the command. If the
problem still exists, resubmit the command after
SQL2072N Unable to bind the shared library shutdown and restart of the DB2 Data Links
“<shr-lib-name>”. Reason code: Managers.
“<reason-code>”.
The Restore utility can avoid DATALINK
Explanation: An error was encountered while processing by specifying WITHOUT DATALINK.
binding the shared library during the processing
of a database utility. The utility stops processing.
SQL2076W The DB2 Data Links Manager
User Response: Note the reason code returned “<server-name>” was not
from the vendor utility in the message and take registered to the database.
corrective action if possible. Resubmit the
Explanation: The DB2 Data Links Manager
command with a valid shared library or using
“<server-name>” was not registered to the
another supported media.
database with the ADD DATALINKS
MANAGER command.
SQL2073N DATALINK processing failed
User Response: For details on why the ADD
because of internal problems at
DATALINKS MANAGER command failed, check
the database server or DB2 Data
the diagnostic log file db2diag.log.
Links Manager.
Explanation: An unexpected error occurred
while processing DATALINK values.

Chapter 2. SQL Messages 267

SQL2100 - SQL2199
eight open scans are allowed.
SQL2150W The table spaces contained in the
backup image were restored. The command cannot be processed.
Depending on the request of the
caller, one or more of these table User Response: Issue one or more CLOSE
spaces might have been skipped. RECOVERY HISTORY FILE SCAN commands
and resubmit the command.
Explanation: A RESTORE DATABASE
command was issued. The user might have
indicated that only a subset of the table spaces in SQL2160W A damaged recovery history file
the backup image were to be recovered. has been replaced. Processing
continued.
User Response: No action is required.
Explanation: An error was encountered during
an access to the recovery history file. The utility
SQL2154N The RESTORE was not successful. is able to recover the file from an alternate copy.
The backup used to restore the The utility continues processing.
table space(s) is not associated
with the current log sequence for User Response: The utility continues processing
the database. successfully. The user should take appropriate
precautions to ensure the recovery history file is
Explanation: For table space restore, the backup not damaged again.
must have been taken during the current log
sequence of the database. The log file sequence is
determined by the database that has been SQL2161N A damaged recovery history file
restored previously or the log files that have could not be fixed. The specified
been processed. In addition, the backup must action failed.
have been taken after the last time the database Explanation: An error was encountered during
was enabled for roll forward recovery. an access to the recovery history file. The utility
Table space restore has stopped. is not able to recover the file. The utility stops
processing.
User Response: Resubmit the command with a
correct backup image. User Response: To continue processing, the user
may remove the recovery history file and
resubmit the command. The utility will
SQL2155W Changes have been made to the regenerate a new file. Any data from the
recovery history file since the corrupted file are lost. The user may look at the
open scan was issued. corrupted file to see if any information can be
saved. The user should take appropriate
Explanation: Changes have been made to the
precautions to ensure the recovery history file is
recovery history file since the file was open for a
not damaged again.
scan. The data read may not be consistent.
User Response: If it is essential to have
SQL2165W The SQLUHINFO structure did
consistent data from the scan, close the recovery
not provide enough TABLESPACE
history file and resubmit the command.
entries.
Explanation: The SQLUHINFO structure was
SQL2157N There are already eight recovery
not large enough to hold the entry that was to be
history file scans open.
returned (including all of its TABLESPACES).
Explanation: Eight recovery history file scans in The value of the SQLN field of the SQLUHINFO
this process are already open. No more than

268 Message Reference, Volume 2

structure should be at least as large as the SQLD
SQL2172W The utility has completed but it is
field returned.
not able to log the event in the
The command cannot be processed. recovery history file due to error
″<error>″.
User Response: Increase the value of the SQLN
field in the SQLUHINFO structure to the value Explanation: The utility has encountered an
indicated by the SQLD field (making sure the error writing to the recovery history file. This
SQLUHINFO structure is large enough to warning does not affect processing.
support that amount) and resubmit the
User Response: Check the First Failure Service
command.
Log (db2diag.log) for additional information.
Correct the error condition to prevent future
SQL2170N The utility encountered entries warnings.
with the same identifier in the
recovery history file. Write fails.
SQL2180N Incorrect syntax or incorrect
Explanation: The utility has encountered an password key used in filtering
entry with the same identifier (timestamp to the specification.
second) in the recovery history file while writing
Explanation: The filtering specification provided
to it. The write to the recovery history file
uses one or both of incorrect syntax or an
terminates. Database manager ensures the
incorrect password key. Details can be found in
uniqueness of the recovery history file identifiers
either or both of the system error log and the
and makes provisions for it even if there are
database manager error log.
more than one request per second. However,
there may be cases where it will fail if numerous User Response: Save the diagnostic
requests come in within a few seconds. information. Contact IBM service.
User Response: Check the First Failure Service
Log (db2diag.log) for additional information. If SQL2181N An internal error occurred during
the applications are running utilities (such as filtered recovery.
backup, quiesce, load) that generate numerous
Explanation: An internal error occurred during
entries to the history file, try to pace the utility
filtered recovery. Recovery is terminated. Details
requests to prevent the problem.
can be found in one or both of the system error
log or the database manager error log.
SQL2171N The update of the recovery history
User Response: If the error was on an attempt
file failed because the specified
to change the state for a table, try filtering out
object part does not exist in the
the full tablespace. Save the diagnostic
file.
information. Contact IBM service.
Explanation: The entry specified to be updated
in the recovery history file does not exist in the
file. The utility stops processing.
User Response: Resubmit the command with a
valid entry.

SQL2200 - SQL2299

Chapter 2. SQL Messages 269

 User Response: Resubmit the command with a
SQL2200N The qualifier for the table or
valid index name.
index name is too long or it was
not specified as part of the table
or index name. SQL2205N The specified index is not valid.
Reason code: “<reason-code>”.
Explanation: The table name or index must be
fully qualified. The format is authid.name where Explanation: The specified index parameter is
authid must be 1 to 30 characters, table name not valid for the requested operation. Following
must be 1 to 128 characters and index name must is a list of reason codes:
be 1 to 18 characters (bytes in a MBCS
environment). 1 The specified index does not exist for
the specified “<schema>”.“<table-
The utility stops processing. name>” or “<schema>”.“<index-
name>”.
User Response: Resubmit the command with a
fully qualified name including the correct 2 The specified index is an extended
qualifier. index. The Reorganize Table utility does
not support indexes based on index
extensions.
SQL2203N The tablename parameter is not
valid. Either the table name is too
long, only an authorization ID Federated system users: this situation can also be
was specified, the table name was detected by the data source.
not specified, or the address of
the name is not valid. The utility or operation stops processing.

Explanation: The table name is required. It User Response: Resubmit the command with a
must be fully qualified and in the format valid index or without an index.
authid.name where authid is 1 to 30 characters and
name is 1 to 128 characters (bytes in MBCS SQL2207N The filepath specified by the
environments). The table name must be located datafile parameter is not valid.
at a valid application address.
Explanation: The datafile parameter is not any
The utility stops processing. of the values that indicate the default filepath.
User Response: Resubmit the command with Also the datafile parameter is not a valid
the correct table name. non-default value. One of the following may
apply:
v The pointer is not valid.
SQL2204N The iname parameter is not valid.
The name of the index is too long, v The pointer points to a string that is too long
only an authorization ID was for a filepath designation.
specified, or the address of the v The specified path value is not valid (on the
index is not valid. server machine).
Explanation: If an index is specified, it must be v The file path does not end with an appropriate
fully qualified and in the format authid.name separator for the server machine.
where authid is 1 to 30 characters and name is 1 The utility stops processing.
to 18 characters (bytes in MBCS environments).
The index must be located at a valid application User Response: Resubmit the command with a
address. valid datafile parameter.

The utility stops processing.

270 Message Reference, Volume 2

 User Response: Resubmit the command with
SQL2208N The table space specified by the
the name of a system temporary table space or
table space parameter is not valid.
do not use the table space name parameter. In
Explanation: The table space parameter does the latter case, the Reorganize Table utility will
not contain a valid value. One of the following use the table space(s) in which the table itself
conditions may exist: resides.
v The pointer is not valid
v The pointer points to a string that is too long SQL2214N The user does not have the
for a table space name authority to run the Reorganize
v The specified table space does not exist. Table utility on table “<name>”.

The utility stops processing. Explanation: The user attempted to reorganize

the specified table without the appropriate
User Response: Resubmit the command with a authorization (either SYSADM or DBADM
valid table space parameter or do not use the authority or the CONTROL privilege on the
table space name parameter. In the latter case, table).
the Reorganize Table utility will use the table
space(s) in which the table itself resides. The utility stops processing.
User Response: Logon as a user with the
SQL2211N The specified table does not exist. appropriate authority or privilege and resubmit
the reorganize table utility command.
Explanation: The table does not exist in the
database. Either the table name or the
authorization ID is incorrect. SQL2215N SQL error “<sqlcode>” occurred
while committing previous work
The command cannot be processed. for the database.
User Response: Resubmit the command with a Explanation: The user was already connected to
valid table name. the database specified in the Reorganize Table
command. An error occurred while committing
SQL2212N The specified table is a view. The the previous work in progress for the database.
Reorganize Table utility cannot be The utility stops processing with no attempt to
run against a view. roll back the work or break the database
Explanation: The Reorganize Table utility connection.
cannot be run against a view. User Response: Look at the SQLCODE
The utility stops processing. (message number) in the message for more
information. Make changes and resubmit the
User Response: Resubmit the command with a command.
valid table name.
SQL2216N SQL error “<sqlcode>” occurred
SQL2213N The specified table space is not a while reorganizing a database
system temporary table space. table.
Explanation: The Reorganize Table utility Explanation: An error occurred during the
requires that any table space specified is a reorganization of a database table.
system temporary table space. The table space
name provided is not a table space defined to The utility stops processing.
hold system temporary tables. User Response: Look at the SQLCODE
The utility stops processing. (message number) in the message for more

Chapter 2. SQL Messages 271

information. Make changes and resubmit the If the system temporary table space was not
command. specified to the REORG utility then the utility
was looking internally for a system temporary
table space. A system temporary table space that
SQL2217N The page size of the system
uses the same page size as the table data either
temporary table space used by the
did not exist in the database or was not available
REORG utility must match the
at the time.
page size of the table space(s) in
which the table data resides User Response: If the table being reorganized
(including the LONG and/or LOB resides in a table space with a page size which is
column data). different than that of the table space in which the
LONG and/or LOB data of the table resides,
Explanation: If the system temporary table was
then a system temporary table space cannot be
explicitly specified to the REORG utility then the
provided to the REORG utility. Reissue the
page size of the system temporary table space
REORG request without specifying a system
used by the REORG utility must match the page
temporary table space.
size of the table space or table spaces in which
the table data, including LONG and/or LOB If a system temporary table space that uses the
column data, resides. One of the following has same page size as the table data does not exist in
violated this restriction: the database, please create a system temporary
v The table’s data resides in a table space that table space using a page size that matches the
has a different page size than that of the page size of the table data.
specified system temporary table space. If a system temporary table space that uses the
v The table contains LONG and/or LOB same page size as the table data exists in the
columns whose data resides in a table space database but was not available at the time of
with a page size that is different than that of your command, please reissue the command
the system temporary table space and the when the system temporary table space is
table’s regular data. available.

SQL2300 - SQL2399

SQL2300N The identifier for the table name SQL2301N The tablename parameter is not
is too long or it was not specified valid. Either it is too long, only an
as part of the table name. authorization ID was specified, or
the address of the name is not
Explanation: The table name must be fully
valid.
qualified. The format is authid.tablename where
authid contains 1 to 30 characters and tablename Explanation: The table name must be fully
contains 1 to 128 characters (bytes in MBCS qualified and in the format authid.name where
environments). authid contains 1 to 30 characters and name
contains 1 to 128 characters (bytes in MBCS
The utility stops processing.
environments) and must be located at a valid
User Response: Resubmit the command with application address.
the fully qualified table name, including the
The utility stops processing.
correct qualifier.
User Response: Resubmit the command with
the correct table name.

272 Message Reference, Volume 2

SQL2302N The index list is not valid. Either SQL2305N The table specified is a view. The
the address for the list is not utility cannot be run against a
valid, the number of entries in the view.
list is less than the number of
Explanation: The tname parameter specified a
indexes specified, or the address
view rather than a table.
for an index in the list is not
valid. The utility stops processing.
Explanation: The address for the list is not User Response: Resubmit the command with a
valid, the number of entries in the list is less valid tname parameter.
than the number of indexes specified, or the
address for an index in the list is not valid.
SQL2306N The table or index “<name>” does
The utility stops processing. not exist.
User Response: Resubmit the command with a Explanation: The table or index identified by
valid index list. “<name>” does not exist in the database, or the
index identified by “<name>” is not defined on
the specified table. The qualifier for the table or
SQL2303N The statsopt parameter is not
one of the indexes may be incorrect.
valid.
The utility stops processing.
Explanation: The statsopt parameter in the Run
Statistics command must be one of the following: User Response: Resubmit the command with
v T for basic table only valid table names and indexes.
v I for basic indexes only
v B for both basic table and indexes SQL2307N The table specified is a system
table. The Runstats utility cannot
v D for table and distribution
be run against a system table.
v E for table and distribution and basic indexes
Explanation: The Run Statistics utility command
v X for extended indexes only
may not be run against a system table.
v Y for extended indexes and basic table
The utility stops processing.
v A for all
User Response: Resubmit the command with a
The utility stops processing.
valid table name.
User Response: Resubmit the command with a
valid statsopt parameter.
SQL2308N The qualifier for the index name
“<name>” is too long, or it was
SQL2304N The sharelev parameter is not not specified as part of the index
valid. It must be ’R’ for reference name.
or ’C’ for change.
Explanation: The index name must be a fully
Explanation: The sharelev parameter in the RUN qualified name. The format is authid.name where
STATISTICS command must be R for reference or authid contains 1 to 30 characters and name
C for change. contains 1 to 18 characters (bytes in MBCS
environments).
The utility stops processing.
The utility stops processing.
User Response: Resubmit the command with a
valid sharelev parameter. User Response: Resubmit the command with a
fully qualified name, including the correct
qualifier.

Chapter 2. SQL Messages 273

 enough to collect non-uniform distribution
SQL2309N The index name “<name>” is not
statistics on the table.
valid. It is too long or only a
qualifier was specified. User Response: Update the database
configuration parameter stat_heap_sz to the
Explanation: The index name must be a fully
suggested value and try again.
qualified name. The format is authid.name where
authid contains 1 to 30 characters and name
contains 1 to 18 characters (bytes in MBCS SQL2313W All available memory in the
environments). statistics heap has been used.
Statistics were collected on the
The utility stops processing.
first ″<n1>″ rows out of a total of
User Response: Resubmit the command with a ″<n2>″ rows.
valid index.
Explanation: The setting of the database
configuration parameter stat_heap_sz is not big
SQL2310N The utility could not generate enough to collect non-uniform distribution
statistics. Error “<sqlcode>” was statistics on the table. Only <n1> of <n2> rows
returned. could be processed.
Explanation: An error occurred while the utility User Response: Update the database
was gathering statistics. configuration parameter stat_heap_sz by 20
percent and try again.
The utility stops processing.
User Response: Look at the message error
SQL2314W Some statistics are in an
number for more information. Make changes and
inconsistent state. The newly
resubmit the command.
collected ″<object1>″ statistics are
inconsistent with the existing
SQL2311N The user does not have the ″<object2>″ statistics.
authority to run the Run Statistics
Explanation: Issuing RUNSTATS on the table
utility on table “<name>”.
only may result in a situation where the table
Explanation: The user attempted to run level statistics are inconsistent with the already
statistics on the specified table without the existing index level statistics. For example, if
appropriate authorization (either the SYSADM or index level statistics are collected on a particular
DBADM authority or the CONTROL privilege on table and later a significant number of rows is
the table). If the table specified in RUNSTATS is deleted from this table, issuing RUNSTATS on
the root table of a table hierarchy, then the table the table only may end up with the table
name returned in the message may be a subtable cardinality less than FIRSTKEYCARD which is
of the specified root table. an inconsistent state. Likewise, issuing
RUNSTATS for indexes only may leave the
The utility stops processing. already existing table level statistics in an
User Response: Do not attempt to call the Run inconsistent state. For example, if table level
Statistics utility command without appropriate statistics are collected on a particular table and
authorization. later a significant number of rows is deleted
from this table, issuing RUNSTATS for the
indexes only may end up with some columns
SQL2312N Statistics heap size is too small to having a COLCARD greater than the table
carry out the operation. Suggested cardinality.
heap size is ″<num>″ pages.
User Response: If you issued a RUNSTATS for
Explanation: The setting of the database indexes only issue a RUNSTATS on the table as
configuration parameter stat_heap_sz is not big

274 Message Reference, Volume 2

well so that table level and index level statistics RUNSTATS on the table only, issue a RUNSTATS
are consistent. Likewise, if you issued a for indexes as well.

SQL2400 - SQL2499

SQL2400N The type specified in the SQL2404N The backup target media is full.
BACKUP command is not valid. It At least “<number>” free bytes
must be either 0 to back up the are needed on the target media.
entire database or 1 to back up
Explanation: The backup target media does not
only the current changes.
have enough space for creating an internal
Explanation: The type must be either 0 for subdirectory and information file.
backing up the whole database or 1 for backing
The utility stops processing.
up changes only.
User Response: Prepare a backup media that
The utility stops processing.
has at least the specified number of bytes of free
User Response: Resubmit the utility command space and then resubmit the command.
with the correct type.
SQL2405N The BACKUP cannot be
SQL2401N “Backup changes only” cannot be performed because there is a
performed until a backup of the previously incomplete RESTORE.
entire database has been done.
Explanation: The database is in an inconsistent
The type must be 0.
state due to a system crash during a restore
Explanation: A backup of changes only has operation or due to an abnormally terminated
been requested without requesting a backup of RESTORE.
the entire database first, or an internal file has
The utility stops processing.
been damaged such that the BACKUP utility
cannot determine whether a full backup had User Response: Resubmit the RESTORE
been taken. The backup of changes only cannot command.
be used until after a backup of the entire
database.
SQL2406N The BACKUP cannot be
The utility stops processing. performed because the database
needs to be rolled forward.
User Response: Resubmit the utility command
with the correct type. Explanation: The backup failed because the
database is in an inconsistent state.
SQL2403N The user does not have the The utility stops processing.
authority to run the utility against
the database. User Response: Use the ROLLFORWARD
command to make the database usable. Then
Explanation: The user attempted to execute a resubmit the BACKUP command.
database utility without either SYSADM or
DBADM authority.
The utility stops processing.
User Response: Do not attempt to call the
utility command without appropriate
authorization.

Chapter 2. SQL Messages 275

SQL2407N An I/O error occurred reading the SQL2410N “Backup changes only” cannot be
file “<name>”. The BACKUP performed if the database is
cannot be performed because it enabled for ROLLFORWARD or if
cannot determine if a RESTORE the BACKUP is being done
was completed. through a user exit.
Explanation: The indicated file cannot be read Explanation: The user requested a changes only
due to the I/O error. Since the file exists, a backup of a database with roll-forward enabled,
BACKUP or RESTORE command must have not or has requested a changes only backup through
completed. Upon successful completion of the the user exit program.
process this file is deleted.
User Response: Possible solutions include:
The utility stops processing. v If the database is roll-forward enabled,
User Response: Determine which process was resubmit the BACKUP utility command
executed previously. Delete the indicated file and requesting a backup of the entire database.
resubmit the previous command. v Disable roll-forward by turning of the
SQL_ENABLE_LOG_RETAIN flag and
SQL_ENABLE_USER_EXIT flag in the
SQL2408W The database was backed up, but
database configuration file. Then resubmit the
an I/O error “<error>” occurred
BACKUP utility command requesting a
while deleting the file “<name>”.
changes only backup.
Explanation: The BACKUP command ran v If the backup was requested through the user
successfully. The indicated file was not deleted exit program, resubmit the BACKUP utility
due to an I/O error. command to do a changes only backup not
The utility completed processing. using the user exit program.
v If the backup was requested through the user
User Response: Try to delete the file indicated exit program to a standard device, resubmit
in the message. the BACKUP utility command to do a changes
only backup not using the user exit program.
SQL2409N When doing a BACKUP of
changes only, the most recent SQL2411C An I/O error occurred while
backup image must be used. running a utility. Either the disk
Explanation: The user has attempted to perform could not be physically written to
a changes only backup but the backup image or has been filled.
specified is not the most current backup or the Explanation: An operating system error
previous backup of changes only failed. occurred when the utility was writing to the disk
The utility stops processing. or diskette. The actual return code can be found
in the SQLERRD[0]field of the SQLCA.
User Response: Locate the most recent backup
image and resubmit the command. If the most User Response: Look at the error return code in
recent backup image cannot be located or if the the SQLERRD[0] field of the SQLCA. Correct the
previous backup of changes only failed, resubmit error, if possible, and resubmit the command.
the command requesting a backup of the entire
database rather that a changes only backup. SQL2412C A corrupted database page was
encountered while running a
database utility.
Explanation: During the utility operation a
corrupted database page was encountered. The

276 Message Reference, Volume 2

database is in an unpredictable state and the should not be included during the Restore
utility cannot continue. operation.
User Response: Record the message number User Response: Mount a new media, or
(SQLCODE). reposition the current media to provide enough
space for this header, then return to the utility
If trace was active, invoke the Independent Trace
with the callerac parameter indicating if
Facility at the operating system command
processing continues.
prompt. Refer to the Independent Trace Facility
in the Troubleshooting Guide for information on
how to use this facility. Then contact your SQL2416W Warning! Device ″<device>″ is
technical service representative with the full. Please mount new media.
following information:
Explanation: The tape which the utility is using
v Problem description has become full.
v SQLCODE or message number
User Response: Mount another tape and
v SQLCA if possible continue the operation with the callerac
v Trace file if possible. parameter indicating if processing continues.

SQL2413N Online backup is not allowed SQL2418N The database specified for Backup
because either logretain or does not exist.
userexit for roll-forward is not
Explanation: The database specified in the dbase
activated, or a backup pending
parameter of the Database Backup command
condition is in effect for the
could not be found.
database.
User Response: Ensure that the correct database
Explanation: Online backup cannot be
alias was specified for the Backup Database
performed while the database is not logging for
utility and that the database exists for this alias.
forward recovery as forward recovery will be
Resubmit the command with the correct alias.
required at restore time. Forward recovery is
placed into effect by setting either the database
configuration logretain parameter or the userexit SQL2419N The target disk ″<disk>″ has
parameter, and then performing an offline become full.
backup of the database.
Explanation: During the processing of a
User Response: Execute an offline backup or database utility, the target disk became full. The
reconfigure the database for roll-forward utility has stopped and the target is deleted.
recovery and issue an offline backup so that
subsequent online backups will be allowed. User Response: Ensure enough disk space is
available for the utility or direct the target to
other media, such as tape.
SQL2414W Warning! Insufficient space on
device ″<device>″ to contain On unix-based systems, this disk full condition
backup control information. This may be due to exceeding the maximum file size
media will not contain backup allowed for the current userid. Use the chuser
information. command to update fsize. A reboot may be
necessary.
Explanation: During the Backup operation a
new media was mounted and positioned after On non unix-based systems, this disk full
one or more media became full. There is not condition may be due to exceeding the
enough space on this media to contain the maximum file size allowed for the operating
Backup Control Information and the media system. Direct the target to other media, such as
tape, or use multiple targets.

Chapter 2. SQL Messages 277

 User Response: Use the current backup API to
SQL2420N Insufficient space on device
backup the database.
″<device>″ to contain initial
backup control information.
SQL2423N The database cannot be backed up
Explanation: During the Backup operation an
because some index files are
initial backup header needs to be created at the
missing.
start of the backup image. This header must fit
on one tape when backing up to tape. There is Explanation: Some of the index files required
insufficient space on the tape to contain this by the backup are missing. These index files
header. must be recreated prior to backing up the
database.
User Response: Resubmit the Backup operation
and either direct the output to a new tape, or User Response: Run the ’db2recri’ program to
reposition the current tape to provide enough recreate the missing index files and then
space for this header. resubmit the backup command.

SQL2421N Table space level backup is not SQL2424N The backup could not succeed
allowed because roll-forward because asynchronous copy
recovery is not enabled. operations at DB2 Data Links
Managers are not complete.
Explanation: Table space level backup cannot be
performed while the database is not logging for Explanation: The TSM or vendor supplied
forward recovery as forward recovery will be archive server might not be in operational state.
required at restore time. Forward recovery is
placed into effect by setting either the database User Response: Ensure TSM or the vendor
configuration logretain parameter or the userexit supplied archive server is in an operational state
parameter, and then performing an offline and resubmit the backup command.
backup of the database.
User Response: Execute a full database backup SQL2425W The log file for the online backup
or reconfigure the database for roll-forward was not truncated.
recovery and issue an offline backup so that Explanation: During an online backup, all
subsequent table space level backups will be buffered log records are forced to disk and the
allowed. last active log file is truncated. During the
current backup, truncation of the last active log
SQL2422N The database cannot be backed up file has failed. As a result, new log records will
with a back-level backup API due continue to be written into the last log file used
to incompatible table space during the backup.
locations. User Response: No user action is required. The
Explanation: This database contains table last active log file used during the backup will
space(s) which have been defined in a location eventually become inactive when it becomes full.
other than the database subdirectory. This is not
compatible with the API being used.

SQL2500 - SQL2599

278 Message Reference, Volume 2

 User Response: If the wrong database name
SQL2501C The database was restored but the
was used in the command, resubmit the
data in the restored database was
command with the correct database name. If the
unusable.
input drive specified is a diskette drive, check
Explanation: The RESTORE utility either could the diskette being used. If the input drive is a
not read data from the restored database or only hard file, verify that it is the correct hard file.
a portion of the database was restored. Both Resubmit the command with the correct input
cases indicate that the restored database is not drive and the correct diskettes, if applicable.
usable.
The database is unusable and the RESTORE SQL2504W Insert the first backup diskette
utility stops processing. into drive “<drive>”.
User Response: Resubmit the RESTORE Explanation: The RESTORE utility reads the
command. first backup diskette to determine the path of the
database directory that was backed up. If the
backup media is a diskette and the diskette is
SQL2502C An error occurred while reading
not found in the specified input drive, the utility
the backup files. Either the disk
returns to the caller with this prompt. The calling
could not physically be read or
program is expected to query the user and return
the specified disk did not contain
to the utility with the user response.
a valid backup.
The utility waits for a response from the caller.
Explanation: An operating system error
occurred when the RESTORE utility was reading User Response: Prompt the user for the diskette
the diskette or disk, or the diskette or disk does and return to the utility with the callerac
not contain a backup of the database directory or parameter, indicating if processing continues or
does not contain the results of any previous ends.
backup.
The utility stops processing. SQL2505W Warning! Database “<name>”
resides at “<drive>”. The files for
User Response: If the input drive specified is a
this database will be deleted.
diskette drive, check the diskette being used. If
the input drive is a hard file, verify that it is the Explanation: If the database being restored
correct hard file. Resubmit the command with already exists, its files will be deleted before the
the correct input drive and the correct diskettes, restore process starts. The utility returns to the
if applicable. caller with this warning. The caller is expected to
query the user and return to the utility with the
user response. Once the database is dropped, it
SQL2503N The RESTORE was not successful.
cannot be accessed again.
The backup used to restore the
database contained the wrong The utility waits for response from the caller.
database.
User Response: Warn the user that the database
Explanation: The name of the database files will be deleted and return to the utility with
contained on the backup disk does not match the the callerac parameter indicating if processing
database name specified on the RESTORE continues or ends.
command. The RESTORE utility cannot
determine the name until after the database has
been restored because a previous release backup
image was restored.
The utility stops processing.

Chapter 2. SQL Messages 279

SQL2506W The database was restored, but SQL2509N The database drive parameter is
there may be extra files in the not valid.
database.
Explanation: The drive specified does not exist,
Explanation: If changes-only backups were or the database does not exist on this drive or is
performed and database files were deleted not cataloged on this drive. RESTORE should use
between backups, the RESTORE utility adds the db2uexit command to perform the database
these deleted files back into the database. The restore.
restore process could not delete the extra files
The utility stops processing.
either because of an I/O error or by the failure of
an internal connection to an internally stopped User Response: Resubmit the utility command
database. with a valid drive.
The utility ends successfully.
SQL2510N An operating system semaphore
User Response: Either use the database as it is
error occurred.
or attempt to restore it again. Ensure that the
DB2 configuration is compatible with the Explanation: An error occurred in the wait or
restored database configuration before rerunning post semaphore.
the RESTORE utility.
The utility stops processing.

SQL2507W The RESTORE utility is not User Response: Stop the database manager,
bound to the database correctly. then restart it and resubmit the utility command.

Explanation: Because the RESTORE utility was

not bound to the database or the package of the SQL2511N The utility encountered an error
utility that was bound to the database is not “<error>” while dropping the
compatible with the installed version of DB2, all database.
the utilities have been rebound to the database. Explanation: The utility could not drop the
But there is a timestamp conflict between the database.
installed version of DB2 and the package so the
utility and bind file are not compatible. The utility stops processing.

The database is restored, but the utility is not User Response: Look at the error number in the
correctly bound. message for more information. Make changes
and resubmit the command.
User Response: Reinstall DB2 or reapply recent
updates and resubmit the utility command.
SQL2512N The utility encountered an error
“<error>” while creating the
SQL2508N The Database Restore timestamp database.
parameter ″<timestamp>″ is not
valid. Explanation: The utility could not create the
database.
Explanation: The timestamp parameter must
contain either NULL or a portion of a valid The utility stops processing.
timestamp, the portion consisting of complete User Response: Look at the error number in the
components of a timestamp. message for more information. Make changes
User Response: Resubmit the Restore operation and resubmit the command.
with a valid timestamp value.

280 Message Reference, Volume 2

 databases are in use in any process on the
SQL2513N The utility encountered an error
workstation.
“<error>” renaming the database.
The utility stops processing.
Explanation: The utility could not rename the
database. User Response: Wait until no databases on the
workstation are in use and resubmit the
The utility stops processing.
command.
User Response: Look at the error number in the
message for more information. Make changes
SQL2517W The restored database was
and resubmit the command.
migrated to the current release.
Explanation: The database being restored was
SQL2514N The RESTORE was not successful.
backed up using a previous release of DB2. The
The backup used to restore the
RESTORE utility migrated it to the format of the
database contained a database
current release.
with a release number that is not
compatible with the installed The user who submitted the RESTORE command
version of the database manager. is given DBADM authority for the database. If
there are other users, the database administrator
Explanation: The release number of the restored
with DBADM authority must grant authorization
database is not compatible with the release
privileges to the specific database users.
number of the installed version of the database
manager. The RESTORE utility completes successfully.
The utility stops processing. User Response: No action is required.
User Response: Resubmit the command with a
backup that is compatible with the release level SQL2518N The RESTORE was not successful.
of the database manager. An I/O error occurred while
trying to restore the database
configuration file.
SQL2515N The user does not have the
authority to run the RESTORE Explanation: The database configuration file
utility against the database. could not be restored due to an I/O error.
Explanation: The user attempted to execute the The utility stops processing.
RESTORE utility without SYSADM authority.
User Response: Determine whether the I/O
The utility stops processing. error can be corrected. Resubmit the command.
User Response: Do not attempt to call the
RESTORE utility command without appropriate SQL2519N The database was restored, but
authorization. the restored database was not
migrated to the current release.
Error “<sqlcode>” with tokens
SQL2516N The RESTORE utility cannot
″<tokens>″ is returned.
complete because at least one
database on the workstation is in Explanation: The backup image contains a
use. previous release of the database. After the
database files were restored, an attempt was
Explanation: In some situations, the RESTORE
made to migrate the database to the current
utility can attempt to move a database to a
release. The migration failed.
directory by renaming the directory associated
with the database. This cannot be done if any The utility finishes processing but the database
was not migrated.

Chapter 2. SQL Messages 281

User Response: Look at the SQLCODE provided in the Database Restore call. A portion
(message number) in the message for more of a timestamp may have been specified so that a
information. Make changes and submit the match with more than one backup image
Migrate command before using the database. filename was found.
User Response: Resubmit the operation by
SQL2520W The database was restored. The specifying a timestamp with sufficient timestamp
backup version of the components to result in a match to a unique
configuration file was used. backup file.
Explanation: When a database is restored, the
current database configuration file is not always SQL2523W Warning! Restoring to an existing
replaced with the backup version. The current database that is different from the
database configuration file was not usable. It has database on the backup image,
been replaced by the backup version. but have matching names. The
target database will be
The utility completed successfully.
overwritten by the backup
User Response: Some values in the database version. The Roll-forward
configuration file may be different after the recovery logs associated with the
restore process. Check that the configuration target database will be deleted.
parameters are set to the desired values.
Explanation: The database alias and name of
the target database are the same as the backup
SQL2521W The database was restored, but an image database alias and name. The database
I/O error “<code>” occurred while seeds are not the same indicating that the
deleting the .BRG file. databases are not the same. The target database
will be overwritten by the backup version. The
Explanation: The restore process ran Roll-forward recovery logs associated with the
successfully. The .BRG file was not deleted due target database will be deleted. The current
to an I/O error. configuration file will be overwritten with the
The .BRG file is used to determine whether a backup version.
Restore operation has terminated abnormally. User Response: Return to the utility with the
The .BRG file resides in the local database callerac parameter indicating processing to
directory of the database in question and consists continue or end.
of a filename equivalent to the database token
and filetype of .BRG.
SQL2524W Warning! Restoring to an existing
The utility completed successfully. database which appears to be the
User Response: Try to delete the .BRG file. If same but the alias ″<dbase>″ of
you are unsuccessful, contact your technical the existing database does not
service representative. match the alias ″<dbase>″ of the
backup image. The target
database will be overwritten by
SQL2522N More than one backup file the backup version.
matches the timestamp value
provided for the backed up Explanation: The database seeds of the target
database image. database and the database image are the same,
indicating these are the same databases, the
Explanation: The backup image file filename database names are the same, but the database
consists of a database alias and a timestamp aliases are not the same. The target database will
component. A filename is constructed from the be overwritten by the backup version.
source database alias and timestamp parameters

282 Message Reference, Volume 2

User Response: Return to the utility with the callerac parameter indicating processing to
callerac parameter indicating processing to continue or end.
continue or end.
SQL2527W Warning! Restoring to an existing
SQL2525W Warning! Restoring to an existing database that is different from the
database that is different from the backup image database, and the
database on the backup image, database name ″<dbname>″ of the
and the alias ″<dbase>″ of the existing database does not match
existing database does not match the database name ″<dbname>″ of
the alias ″<dbase>″ of the backup the backup image, but the alias
image, but the database names are names are the same. The target
the same. The target database will database will be overwritten by
be overwritten by the backup the backup version. The
version. The Roll-forward Roll-forward recovery logs
recovery logs associated with the associated with the target
target database will be deleted. database will be deleted.
Explanation: The database aliases of the target Explanation: The database aliases of the target
database and database image are not the same, database and database image are the same, the
the database names are the same, and the database names are not the same, and the
database seeds are not the same, indicating these database seeds are not the same, indicating these
are different databases. The target database will are different databases. The target database will
be overwritten by the backup version. The be overwritten by the backup version. The
Roll-forward recovery logs associated with the Roll-forward recovery logs associated with the
target database will be deleted. The current target database will be deleted. The current
configuration file will be overwritten with the configuration file will be overwritten with the
backup version. backup version.
User Response: Return to the utility with the User Response: Return to the utility with the
callerac parameter indicating processing to callerac parameter indicating processing to
continue or end. continue or end.

SQL2526W Warning! Restoring to an existing SQL2528W Warning! Restoring to an existing

database that is the same as the database that is the same as the
backup image database, and the backup image database, but the
alias names are the same, but the alias name ″<dbase>″ of the
database name ″<dbname>″ of the existing database does not match
existing database does not match the alias ″<dbase>″ of backup
the database name ″<dbname>″ of image, and the database name
the backup image. The target ″<dbname>″ of the existing
database will be overwritten by database does not match the
the backup version. database name ″<dbname>″ of the
backup image. The target
Explanation: The database aliases of the target
database will be overwritten by
database and database image are the same, and
the backup version.
the database seeds are the same, however the
database names are different. These are the same Explanation: The database aliases of the target
databases. The target database will be database and database image are not the same,
overwritten by the backup version. the database names are not the same, and the
database seeds are the same, indicating these are
User Response: Return to the utility with the

Chapter 2. SQL Messages 283

the same databases. The current database will be
SQL2531N The backup image selected for
overwritten by the backup version.
restore is not a valid database
User Response: Return to the utility with the backup image.
callerac parameter indicating processing to
Explanation: The file selected for restore is not
continue or end.
a valid backup image. Either the file selected has
become corrupted or a backup tape is not at the
SQL2529W Warning! Restoring to an existing correct position.
database that is different from the
User Response: Determine the location of the
backup image database, and the
correct backup image file, and resubmit the
alias name ″<dbase>″ of the
Restore command.
existing database does not match
the alias name ″<dbase>″ of the
backup image, and the database SQL2532N The backup file contains the
name ″<dbname>″ of the existing backup image of database
database does not match the “<dbalias>” taken at timestamp
database name ″<dbname>″ of the “<timestamp>”. This is not the
backup image. The target backup image requested.
database will be overwritten by
Explanation: The file selected for restore does
the backup version. The
not contain the requested backup image. The
Roll-forward recovery logs
image is for a different database than that
associated with the target
requested.
database will be deleted.
User Response: If using tape, ensure that the
Explanation: The database aliases of the target
correct tape is mounted. If a restore or load is
and database image are not the same, the
being done from disk, then the file must have
database names are not the same, and the
been renamed. Rename the file to the correct
database seeds are not the same, indicating these
filename with a match on database name and
are different databases. The current database will
timestamp. Resubmit the command after taking
be overwritten by the backup version. The
the appropriate action.
Roll-forward recovery logs associated with the
target database will be deleted. The current
configuration file will be overwritten with the SQL2533W Warning! The backup file on
backup version. device ″<device>″ contains the
image of database ″<database>″
User Response: Return to the utility with the
taken at timestamp
callerac parameter indicating processing to
″<timestamp>″. This is not the
continue or end.
backup image requested.
Explanation: The backup image read from the
SQL2530N The backup image is corrupted.
tape position contains a media header that does
Restore of database from this
not match the header of the image of the first file
backup image is not possible.
of the backup file sequence.
Explanation: The backup image being restored
User Response: Ensure that the tape is
is corrupted making the database image
positioned at the correct backup, then return to
non-restorable.
the utility with the callerac parameter indicating
User Response: Discard the backup image as it if processing continues.
is unusable. Restore from a previous backup if
possible.

284 Message Reference, Volume 2

 roll-forward is not required to make the restored
SQL2534W Warning! The media on device
database usable. The database to be restored was
″<device>″ is not positioned at a
backed up in online mode and a roll-forward
valid backup media header.
operation is necessary to make the database
Explanation: The data read from the tape usable.
position does not contain a valid backup media
User Response: Resubmit the Database Restore
header.
command without specifying
User Response: Ensure that the tape is SQLUD_NOROLLFWD for the rst_type
positioned at the correct position, then return to parameter.
the utility with the callerac parameter indicating
if processing continues.
SQL2538N Unexpected End of File of Backup
Image reached on media
SQL2535W Warning! End of media on device ″<media>″.
″<device>″ has been reached.
Explanation: While reading and restoring from
Please mount the next source
the Backup Image file, an end of file condition
media.
was reached unexpectedly. The backup image is
Explanation: The end of tape has been reached unusable and the restore operation terminates.
and there is still more data to be processed. The
User Response: Resubmit the Database Restore
remainder of the backup or load source exists on
command with a usable backup image file.
another tape or on several more tapes.
User Response: Mount the next tape in
SQL2539W Warning! Restoring to an existing
sequence that contains the source image and
database that is the same as the
resubmit the Restore or Load command with the
backup image database. The
callerac parameter set to continue or end.
database files will be deleted.
Explanation: The database aliases, names and
SQL2536W Warning! The backup image on
seeds of the target database and database image
device <device> contains an
are the same, indicating these are the same
incorrect sequence number.
databases. The current database will be
Sequence number <number> is
overwritten by the backup version.
expected.
User Response: Return to the utility with the
Explanation: The tape is positioned on a
callerac parameter indicating processing to
backup image file that is out of sequence. The
continue or end.
tape containing the backup image must be
positioned to the file of sequence number
″<sequence>″ of the backup image. SQL2540W Restore is successful, however a
warning ″<warn>″ was
User Response: Position the tape containing the
encountered during Database
backup image to the correct file and resubmit the
Restore while processing in No
Restore command with the callerac parameter set
Interrupt mode.
to continue or end.
Explanation: The Database Restore utility was
invoked in No Interrupt mode, i.e.
SQL2537N Roll-forward is required
SQLUB_NO_INTERRUPT or
following the Restore.
SQLUD_NO_INTERRUPT was specified. During
Explanation: SQLUD_NOROLLFWD was the processing a warning was encountered but
specified for the rst_type parameter of the not returned at the time it was encountered. The
Database Restore utility, indicating that a Restore has completed successfully and the

Chapter 2. SQL Messages 285

warning message found is shown at the
SQL2544N The directory where the database
completion in this message.
is being restored has become full.
User Response: Ensure that the action that
Explanation: While the database was being
caused this warning to be generated has not
restored the directory to which it was being
resulted in a condition not wanted.
restored had become full. The database being
restored is unusable. The Restore terminates and
SQL2541W The utility was successful, if the database being restored is a new database,
however the file containing the then it is deleted.
backup image could not be
User Response: Free up sufficient space on the
closed.
directory for the database, and reissue the
Explanation: The utility was successful, but the Restore, or if restoring to a new database supply
file containing the backup image could not be a directory with sufficient space to contain the
closed. database.

User Response: Attempt to close the file

containing the backup image. SQL2545W Warning! The backup image on
the TSM server is currently stored
on mountable media. The time
SQL2542N No match for a database image required to make it available is
file was found based on the unknown.
source database alias and
timestamp provided. Explanation: The backup image is not
immediately accessible by the TSM server. The
Explanation: The backup image file filename restore process can continue and make the
consists of a database alias and a timestamp request to the server to retrieve the data. The
component. A filename is constructed from the time required is unknown.
source database alias and timestamp parameters
provided in the Database Restore call. No User Response: Return to the utility with the
filename existed in the source directory that callerac parameter indicating processing to
matched based on the source database alias and continue or end.
timestamp provided.
User Response: Ensure that the database SQL2546N The image on media “<media>” is
backup image resides on the media source. not the first in sequence from the
Resubmit the operation by specifying a correct backup or copy.
timestamp to result in a match.
Explanation: During restore or load recovery,
the first image from the backup or copy must be
SQL2543N The target directory specified for processed first. The image found on the media is
the database is not valid. not the first in sequence.

Explanation: The application calling the Restore The utility waits for a response to continue.
utility has supplied a target directory for the new
User Response: Mount the media with the
database to be created. Either this directory does
correct backup or copy image and return to the
not exist, or is not a valid directory for database
utility with the correct caller action parameter to
creation. An invalid directory for database
indicate if processing should continue or
creation would be a directory of greater than 255
terminate.
characters in length.
User Response: Reissue the Backup or Restore
command with a valid target directory.

286 Message Reference, Volume 2

 from which the restore command was
SQL2547N The database was not restored
issued is the same as that of the backup
because the backup image is from
image.
a previous release and was an
online backup. 3 Contact IBM Service.
Explanation: The physical log file formats have
changed between these releases, making SQL2549N The database was not restored
rollforward impossible. because either all of the table
spaces in the backup image are
User Response: Restore the database using the
inaccessible, or one or more table
version of DB2 used to create the database and
space names in list of table space
rollforward to the end of logs. Take an off-line
names to restore are invalid.
full database backup at this time. This new
backup image will be restorable on the new Explanation: The containers which were used
release of DB2. by the table spaces in the backup image are not
available, are already in use, or one or more table
space names specified in the list on the restore
SQL2548N Database codepage ″<codepage1>″
command do not exist in the backup image.
indicated in the backup image
differs from that of the current User Response: Use redirected restore to
on-disk database codepage redefine the containers for the table spaces in this
″<codepage2>″. The Restore backup image, or specify a list of valid table
operation has failed. space names to restore.
Explanation: The database contained in the
backup image contains data stored in a codepage SQL2550N Database backed up on node
different from that of the database into which the ″<node1>″ cannot be restored to
data is being restored. node ″<node2>″.
This problem can be caused by one of the Explanation: The backup image used for the
following situations: restore is a backup of a database from a different
node. You can only restore a backup to the same
1 The database you are restoring into has
node.
a different codepage than that of the
database in the backup image. User Response: Ensure that you have the
correct backup image for the node then issue the
2 The user is restoring into a new
request again.
database from a session with a different
codepage than the backup.
SQL2551N Database with catalog node
3 The backup image is corrupt, and
″<node1>″ cannot be restored to a
contains invalid character set
database with catalog node
information.
″<node2>″.
User Response:
Explanation: The catalog node can exist on only
1 If restoring over an existing database, one node and there is a discrepancy between the
make sure that the codepage of the backup image and the node being restored to.
existing database matches that of the This can occur in the following cases:
backup image. 1. The backup image specified catalog node
2 If restoring to a new database, make ″<node1>″ and the restore was attempted to
sure that the codepage of the session an existing database whose catalog node is
node ″<node2>″

Chapter 2. SQL Messages 287

2. The restore was attempted to a new database 7 Exception table not allowed for reconcile
and the catalog node has not been restored on typed tables.
first.
8 ALTER TABLE failed to put the table
User Response: Verify that the correct backup into “Datalink Reconcile Pending” or
image is being restored. “Datalink Reconcile Not Possible” state,
or failed to take the table out of
If you are restoring to an existing database and
“Datalink Reconcile Pending” or
want to change the catalog node to ″<node2>″,
“Datalink Reconcile Not Possible” state.
the existing database must be dropped first.
9 Data Links support is not turned on.
If you are restoring to a new database, restore
the catalog node ″<node1>″ first. 10 DB2 Data Links Manager is not
responding. The reconcile action did not
complete.
SQL2552N Invalid report file name specified
in the restore command. User Response: Possible Solutions:
Explanation: The length of the report file name 1 Make sure that the DB2 Data Links
exceeded the allowed limit of 255. Manager is up and running, and that it
has been registered with the database
User Response: Specify a report file name
using the ADD DATALINKS
whose length is within the allowed limit and
MANAGER command. Try connecting
resubmit the restore command.
to the database and make a sure a
corresponding connection has been
SQL2553I The RECONCILE utility established on the DB2 Data Links
completed successfully. Manager.

Explanation: The utility completed successfully. 2 The table does not seem to exist on the
DB2 Data Links Manager. Nothing to
User Response: No action necessary. reconcile.
3 DB2 Data Links Manager may be down.
SQL2554N The RECONCILE utility failed Try starting the DB2 Data Links
with reason code ″<reason-code>″. Manager.
Possible problem with
″<component>″. 4 Ensure you have file permissions and
enough space for the report file. A fully
Explanation: Possible Reason codes: qualified path is required for the
1 Unknown connection to a DB2 Data DLREPORT parameter. Ensure that the
Links Manager. table being reconciled is not damaged.

2 Table/DATALINK column not defined 5 Redefine all datalink columns in the

on the DB2 Data Links Manager. exception table as “NO LINK
CONTROL”.
3 DB2 Data Links Manager may be down.
6 Take the table out of “Datalink
4 I/O problems. Reconcile Not Possible” state using the
5 The exception table contains datalink SET INTEGRITY command. Repeat the
columns that are defined with file link reconcile command.
control. 7 Do not specify an exception table.
6 Table is in “Datalink Reconcile Not 8 Try issuing a SET INTEGRITY command
Possible” state. to put the table into “Datalink Reconcile
Pending” state or to reset the “Datalink

288 Message Reference, Volume 2

 Reconcile Pending” or “Datalink use a correct backup image and resubmit the
Reconcile Not Possible” state. utility command.
9 The value of the database manager
configuration parameter DATALINKS is SQL2563W The restore process has completed
set to NO. To use RECONCILE, you successfully, but one or more
must set the value of the parameter table spaces from the backup
DATALINKS to YES. were not restored.
10 The reconcile command has timed out Explanation: The restore process has completed
waiting for verification from the DB2 successfully. One or more table spaces that are in
Data Links Manager. Try the reconcile the backup were not restored for one of the
command again. following reasons:
v an error was encountered while accessing the
SQL2560N The target database is not containers of the table spaces. If the table
identical to the source database spaces have been dropped since the backup
for a restore from a table space was taken, no further action is necessary.
level backup. v the restore command was invoked with a list
of table spaces so that only a subset of the
Explanation: For a restore from a table space
table spaces in the backup were restored. No
level backup, the target database must be either
further action is necessary.
the original database from which the backup is
taken or a new database. User Response: If this message is not due to a
subset restore, use the query table space function
User Response: Specify the correct target
to check the states of the table spaces. If a table
database and resubmit the utility command.
space is in the ″storage definition pending″ state,
the storage definition for the table space must be
SQL2561W Warning! Restoring from a table corrected for restore to complete successfully. See
space level backup to a database the Administration Guide for details about
which does not exist. A database recovering the table space.
with the same attributes in the
backup will be created.
SQL2564N The pagesize of one or more table
Explanation: For a restore from a table space spaces in the backup image do
level backup, the target database must have the not match that of the
same attributes (database name, alias and seed) corresponding destination table
as the source database. If the database does not spaces.
already exist, it will be created.
Explanation: The target table space pagesize
User Response: Return to the utility with the must match that of the table space pagesize in
callerac parameter indicating processing to the backup image. Restoring to a table space of a
continue or end. different pagesize is not supported. The default
pagesize is 4K.

SQL2562N Table space level restore from a User Response: Ensure that the table space
full database backup is not being restored into has the same pagesize as the
allowed. table space in the backup image.

Explanation: For a restore from a full database

level backup, the restore type cannot be table
space level.
User Response: Specify a correct restore type or

Chapter 2. SQL Messages 289

 v Restoring from a backup image that has
SQL2565N The option specified for
become unusable. If no rollforward follows the
RESTORE is not allowed with the
restore, any tables with DATALINK columns
backup image provided.
are placed in DRNP state.
Explanation: The database contained in the v DATALINK column information does not exist
backup image is an existing database and does at the DB2 Data Links Manager(s). Affected
not match the database to be restored. The tables are placed in DRNP state.
option you have specified for restore requires
v Restore involving fast reconciliation failed
that the database being restored to is new or the
while trying to relink files at the DB2 Data
same as in the backup image.
Links Manager(s). Affected tables are placed in
The utility stops processing. DRNP state.
User Response: Resubmit the command with User Response: Look in the db2diag.log file to
the correct database name. find out what tables are put in DRP/DRNP state.
See the Administration Guide for information on
reconciling tables that are in DRP/DRNP state.
SQL2566W The restore process has completed
successfully, but one or more
table spaces have their tables put SQL2570N A database cannot be restored on
in DRP/DRNP state. Check the a platform that does not match the
db2diag.log file for details. platform on which the backup
image was created.
Explanation: One or more table spaces have
tables in DATALINK Reconcile Pending (DRP) or Explanation: You created the backup image on
DATALINK Reconcile Not Possible (DRNP) one type of platform and are trying to restore it
because of one of the following reasons: on a different platform. However, backup images
v Restoring to a database that has a different must be restored on a system whose machine
database name, alias, hostname, or instance type and operating system match the system on
than the backup image. If no rollforward which the backup image was created.
follows the restore, any tables with User Response: To use this particular backup
DATALINK columns are placed in DRNP image, restore it on a system that corresponds to
state. the system on which the backup was taken.
v Restore is done specifying the WITHOUT
To move a database from one type of platform to
DATALINK option and no rollforward follows
another, use the db2move utility described in the
the restore. Any tables with DATALINK
Data Movement Utilities Guide and Reference.
columns are placed in DRP state.

SQL2600 - SQL2699
User Response: Correct the value of the input
SQL2600W The input parameter pointer to
parameter and resubmit the command.
the authorization block is invalid
or the block’s size is incorrect.
SQL2650N An invalid parameter was passed
Explanation: The pointer to the authorization
to the asynchronous read log API.
structure parameter is NULL, the pointer to the
Reason Code = ″<reason-code>″.
authorization structure points to an area that is
smaller than the length indicated in the structure Explanation: An invalid parameter was passed
length field, or the authorization structure length to the asynchronous read log API. The possible
field is not set to the correct value. reason codes are as follows:
The command cannot be processed. 01 Invalid action specified.

290 Message Reference, Volume 2

02 The starting log sequence number is been allocated and is of the size indicated by the
greater than or equal to the current log buffer size parameter.
database active log sequence number.
For reason code 08, increase the size of the
03 The log sequence number range allocated buffer.
bounded by the starting and ending log
For reason code 09, ensure that memory has been
sequence numbers is not large enough
correctly allocated and the pointers properly
to span a log record.
initialized.
04 The starting log sequence number does
not represent the start of an actual log
SQL2651N The log records associated with
record.
the database can not be
05 The starting log sequence number’s asynchronously read.
location could not be determined.
Explanation: The asynchronous read log API
06 The ending log sequence number is less was used against a connected database which
than or equal to the starting log does not have LOG RETAIN or USER EXITS ON.
sequence number. Only databases which are forward recoverable
may have their associated logs read.
07 The buffer is not valid for the indicated
size. User Response: Update the database
configuration for the database, identified to the
08 The buffer is not of sufficient size to
asynchronous read log API, turning LOG
store a log record.
RETAIN and/or USER EXITS ON.
09 A pointer is not valid.
User Response: For reason code 01, ensure that SQL2652N Insufficient memory to run the
the action is either SQLU_RLOG_QUERY, asynchronous log reader.
SQLU_RLOG_READ, or
Explanation: The allocation of the internal
SQLU_RLOG_READ_SINGLE.
buffers used by the asynchronous read log API
For reason code 02, ensure that the starting log has failed.
sequence number is less than the current active
User Response: Increase the amount of
log sequence number returned in the read log
available memory available to the process
information structure.
(increase real or virtual memory or remove
For reason code 03, ensure that the ending log unnecessary background processes) or decrease
sequence number is sufficiently larger than the the log sequence number range provided to the
starting log sequence number. asynchronous read log API.
For reason code 04, ensure that the starting log
sequence number is either the initial log SQL2653W A Restore, Forward or Crash
sequence number or one byte larger than the last Recovery may have reused log
read log sequence number returned in the read sequence number ranges. Reason
log information structure. code ″<reason-code>″.
For reason code 05, ensure that the starting log Explanation: A Restore, Forward or Crash
sequence number resides in a log extent in the Recovery may have reused log sequence number
database log file path. ranges. The possible reason codes are as follows:
For reason code 06, ensure that the ending log v 01 - Restore has taken place.
sequence number is greater than the starting log v 02 - Forward Recovery (ROLLFORWARD) has
sequence number. taken place.
For reason code 07, ensure that the buffer has v 03 - Crash Recovery has taken place.

Chapter 2. SQL Messages 291

User Response: No action is required. log file. The specified log file has been corrupted
and cannot be read.
SQL2654W The database log has been User Response: Increase the start read log
asynchronously read to the end of sequence and resubmit the call to the
the current active log. Asynchronous Read Log API to start reading
after the specified log file.
Explanation: All log records in the database
active log have been read by the asynchronous
log reader. SQL2657N The Asynchronous Log Reader
requires log file “<name>” which
User Response: No action is required.
does not currently reside in the
database log directory.
SQL2655N The Asynchronous Log Reader
Explanation: The Asynchronous Log Reader
encountered log file “<name>”
requires log records from the specified log file.
which is not associated with the
The specified log file does not currently reside in
database being asynchronously
the database log directory.
read.
User Response: Move the specified log file into
Explanation: The Asynchronous Log Reader
the database log directory of the database being
attempted to read log records from the specified
asynchronously read. If the database log path
log file. The specified log file is not associated
was changed, the log file might be found in the
with the database being asynchronously read.
old log path. Resubmit the call to the
User Response: Remove this log file from the Asynchronous Read Log API.
database log directory. Move the correct log file
into the database log directory and resubmit the
call to the Asynchronous Read Log API.

SQL2656N The Asynchronous Log Reader

has encountered log file
“<name>” which cannot be read.
Explanation: The Asynchronous Log Reader
attempted to read log records from the specified

SQL2700 - SQL2799
1 There is an option not started with ’-’
SQL2701N Invalid command line option for
sign.
″<progname>″. Reason code:
″<reason-code>″ 2 Each option except ’h’ (or ’H’) must be
followed by an argument.
Explanation: Command line option for the data
splitting utility is not valid. Valid options are: 3 There is an invalid option.
v -c ″Configuration file name″ 4 The argument of an option is too long
v -d ″Distribution file name″ (maximum 80 characters).
v -i ″Input file name″
v -o ″Output file prefix″
v -h Usage message
User Response: Given for each reason code:

292 Message Reference, Volume 2

SQL2702N Failed to open the configuration SQL2707N Failed to open the distribution
file ″<config-file>″. file ″<dist-file>″.
Explanation: The utility cannot read the Explanation: The utility cannot open the
configuration file ″<config-file>″. distribution file ″<dist-file>″ for writing.
User Response: Please ensure the configuration User Response: Please ensure the distribution
file exists and is readable. file is writable.

SQL2703N Failed to open the log file SQL2708N Failed to open the output data file
″<log-file>″. ″<out-data-file>″.
Explanation: The utility cannot open the log file Explanation: The utility cannot open the output
″<log-file>″ for writing or appending. data file ″<out-data-file>″ for writing.
User Response: Please ensure the log file exists User Response: Please ensure the output data
and is writable. file is writable.

SQL2704N Failed to open the input data file SQL2709N Syntax error at line ″<line>″ of
″<input-data-file>″. the configuration file.
Explanation: The utility cannot read the input Explanation: There is a syntax error in the
data file ″<input-data-file>″. specification of a keyword and its argument.
User Response: Please ensure the input data file User Response: A keyword and its argument
exists and is readable. must be delimited by an ’=’ sign.

SQL2705N Failed to open the input SQL2710N Invalid keyword at line ″<line>″
partitioning map file of the configuration file.
″<in-map-file>″.
Explanation: There is an undefined keyword in
Explanation: The utility cannot read the input the configuration file.
partitioning map file ″<in-map-file>″.
User Response: Valid keywords (case
User Response: Please ensure the input insensitive) are:
partitioning map file exists and is readable. v DESCRIPTION, CDELIMITER, SDELIMITER,
NODES, TRACE, MSG_LEVEL, RUNTYPE,
SQL2706N Failed to open the output OUTPUTNODES, NODES, OUTPUTNODES,
partitioning map file OUTPUTTYPE, PARTITION, MAPFILI,
″<out-map-file>″. INFILE, MAPFILO, OUTFILE, DISTFILE,
LOGFILE, NEWLINE, HEADER, FILETYPE
Explanation: The utility cannot open the output
partitioning map file ″<out-map-file>″ for
writing. SQL2711N Invalid column delimiter
(CDELIMITER) at line ″<line>″ of
User Response: Please ensure the output the configuration file.
partitioning map file is writable.
Explanation: The column delimiter
(CDELIMITER) specified in the configuration file
is not valid.
User Response: Make sure the column delimiter
(CDELIMITER) is a single byte character.

Chapter 2. SQL Messages 293

SQL2712N Invalid string delimiter SQL2716N Invalid record length (RECLEN)
(SDELIMITER) at line ″<line>″ of ″<reclen>″ at line ″<line>″ of the
the configuration file. configuration file.
Explanation: The string delimiter Explanation: The value for record length
(SDELIMITER) specified in the configuration file (RECLEN) ″<reclen>″ specified in the
is not valid. configuration file is not valid.
User Response: The string delimiter User Response: The record length (RECLEN)
(SDELIMITER) cannot be a period. must be between 1 and 32767.

SQL2713N Invalid run type (RUNTYPE) at SQL2717N Invalid node specification

line ″<line>″ of the configuration (NODES) at line ″<line>″ of the
file. configuration file. Reason code
″<reason-code>″.
Explanation: The value for run type
(RUNTYPE) specified in the configuration file is Explanation: The node specification (NODES) in
not valid. the configuration file is not valid.
User Response: Valid run type (RUNTYPE) can User Response: Given for each reason code:
be either PARTITION or ANALYZE (case
1 NODES has already been defined.
insensitive).
2 The format is not valid. A valid
example: NODES=(0,30,2,3,10-15,57)
SQL2714N Invalid message level
(MSG_LEVEL) at line ″<line>″ of 3 Each entry must be numeric data
the configuration file. between 0 and 999.
Explanation: The value for message level 4 Range specification must be from a
(MSG_LEVEL) specified in the configuration file lower number to a higher number.
is not valid.
User Response: Valid message level SQL2718N Invalid output node specification
(MSG_LEVEL) can be either CHECK or (OUTPUTNODES) at line
NOCHECK (case insensitive). ″<line>″ of the configuration file.
Reason code ″<reason-code>″.
SQL2715N Invalid check level Explanation: The output node specification
(CHECK_LEVEL) at line ″<line>″ (OUTPUTNODES) in the configuration file is not
of the configuration file. valid.
Explanation: The value for check level User Response: Given for each reason code:
(CHECK_LEVEL) specified in the configuration
file is not valid. 1 OUTPUTNODES has already been
defined.
User Response: Valid check level
(CHECK_LEVEL) can be either CHECK or 2 The format is not valid. A valid
NOCHECK (case insensitive). example: OUTPUTNODES=(0,30,2,3,10-
15,57)
3 Each entry must be numeric data
between 0 and 999.
4 Range specification must be from a
lower number to a higher number.

294 Message Reference, Volume 2

 DOUBLE (for binary numerics only),
SQL2719N Invalid output type
DATE, TIME, TIMESTAMP,
(OUTPUTTYPE) at line ″<line>″
DECIMAL(x,y).
of the configuration file.
5 For DECIMAL data type, precision (x)
Explanation: The output type (OUTPUTTYPE)
and scale (y) must be specified and they
in the configuration file is not valid.
must be positive integers.
User Response: Valid output types
6 For CHARACTER or VARCHAR data
(OUTPUTTYPE) are W (write) or S (stdin), case
type, <len> must be specified.″
insensitive.

SQL2722N Invalid log file specification

SQL2720N Number of partition keys
(LOGFILE) at line ″<line>″ of the
exceeded the maximum ″256″.
configuration file.
This error was detected at line
″<line>″ of the configuration file. Explanation: The log file specification
(LOGFILE) in the configuration file is not valid.
Explanation: The number of partitioning keys
defined cannot exceed the maximum limit: 256. User Response: The log file specification
(LOGFILE) must be in one of the following two
User Response: Remove one or more
formats:
partitioning keys defined in the configuration
file. v LOGFILE=<log file name>,<log type>
v LOGFILE=<log file name>
SQL2721N Invalid partitioning key <log type> can only be W (write) or A (append),
specification (PARTITION) at line case insensitive.
″<line>″ of the configuration file.
Reason code ″<reason-code>″.
SQL2723N Invalid trace specification
Explanation: A partitioning key specification (TRACE) at line ″<line>″ of the
(PARTITION) in the configuration file is not configuration file.
valid. Valid format:
Explanation: The trace specification (TRACE) in
PARTITION=<key name>,<position>,<offset>, the configuration file is not valid.
<len>,<nullable>,<datatype>
User Response: The trace specification (TRACE)
If a delimited-data file, <position> must be must be a positive integer between 0 and 65536
defined; otherwise, <offset> and <len> must be (exclusive).
defined.
User Response: Given for each reason code: SQL2724N Invalid node list specification.

1 Fields must be delimited by the ’,’ Explanation: The node list specification is not
character. valid.

2 <position>, <offset> and <len> must be User Response: One and only one of the two
positive integers. parameters: NODES and MAPFILI (input
partition map) must be specified in the
3 <nullable> must take a value from configuration file.
{N,NN,NNWD}.
4 Valid <data type> includes: SMALLINT,
INTEGER, CHARACTER, VARCHAR,
FOR_BIT_CHAR, FOR_BIT_VARCHAR,
FLOAT (for binary numerics only),

Chapter 2. SQL Messages 295

SQL2725N Filename for output partition map SQL2730N Error while writing header to
was not specified. output data file ″<out-data-file>″.
Explanation: If run type is ANALYZE, a Explanation: An I/O error occurred while
filename for the output partition map must be writing the header to an output data file.
defined.
User Response: Check your operating system
User Response: Specify a filename for the documentation for file I/O errors and ensure that
output partition map. there is sufficient space on the output device.

SQL2726N There is no partitioning key SQL2731N Error while reading from input
defined. data file ″<filename>″.
Explanation: At least one partitioning key must Explanation: An I/O error occurred while
be defined. reading from input data file.
User Response: Specify one or more User Response: Check your operating system
partitioning keys. documentation for file I/O errors.

SQL2727N Partition key ″<key-name>″ SQL2732N Line ″<line>″ of the input data
exceeds the record length file contains binary data.
″<reclen>″.
Explanation: Binary data is not permitted on
Explanation: For non-delimited data, starting the host versions of this utility program.
position for a key must be less than the record
User Response: Check your input data file.
length.
User Response: Make sure starting position for
SQL2733N Run type (RUNTYPE) was not
a key is less than the record length.
defined in the configuration file.
Explanation: The run type (RUNTYPE) must be
SQL2728N Output node ″<out-node>″ is not
defined as either PARTITION or ANALYZE.
defined in the node list.
User Response: Please specify run type
Explanation: Output node list must be a subset
(RUNTYPE) in the configuration file.
of the node list, which is derived from NODES
or the input partition map file.
SQL2734N Invalid specification for parameter
User Response: Make sure all output nodes are
32KLIMIT at line ″<line>″ of the
defined in the node list.
configuration file.
Explanation: The specification for parameter
SQL2729N Invalid input partition map.
32KLIMIT in the configuration file is not valid.
Explanation: There is at least one error in the
User Response: Parameter 32KLIMIT can be
input partition map file.
either YES or NO, case insensitive.
User Response: The input partition map must
contain no less than 4096 data entries, and each
data entry must be a number between 0 and 999.

296 Message Reference, Volume 2

SQL2735W The record ″<rec-no>″ of the input SQL2739N The record length was not
data file was discarded because it specified for a binary numerical
was an empty record. data file.
Explanation: The record ″<rec-no>″ of the input Explanation: If a binary numerical input data
data is discarded because it contains nothing but file, the record length has to be defined.
spaces.
User Response: Please specify the record length
User Response: Check record ″<rec-no>″ in the in your configuration file.
input data file.
SQL2740N Float data type is not allowed in a
SQL2736N sqlugrpi_api returned an error non-binary input data file.
when processing record at line
Explanation: Float data type is only supported
″<line>″ of the input data file.
when the file type is BIN (binary).
Explanation: Partitioning key fields contain
User Response: Make sure data types and the
invalid data.
type of input data file match.
User Response: Check the input data file at line
″<line>″.
SQL2741N Invalid file type specification at
line ″<line>″ of the configuration
SQL2737N Failed to write output data file for file.
output node ″<out-node>″ when
Explanation: The file type specification
processing record at line ″<line>″
(FILETYPE) in the configuration file is not valid.
of input data file.
User Response: Valid values for the file type
Explanation: An I/O error occurred while
parameter are as follows:
writing a record to the output data file for node
″<out-node>″. v ASC (positional ascii data file)
v DEL (delimited ascii data file)
User Response: Check your operating system
documentation for file I/O errors and ensure that v BIN (ASC file with all numeric data in binary
there is sufficient space on the output device. format)
v PACK (ASC file with all decimal data in
packed decimal format)
SQL2738W Record at line ″<line>″ of input
data file has been truncated when v IMPLIEDDECIMAL (DEL file with decimal
writing to the output data file for data in implied decimal format).
node ″<out-node>″. Expected All the values are case insensitive.
writing length is ″<reclen>″ while
actual writing length is
″<real-len>″. SQL2742N The length of partition key
″<partition-key>″ does not match
Explanation: Expected writing length (RECLEN) its precision.
does not match the actual writing length.
Explanation: In a binary input data file, the
User Response: Adjust record length value length of a partition key with decimal data type
defined in the configuration file. must conform to the equation:
LENGTH=(PRECISION+2)/2 (integer division),
because it is a packed decimal.
User Response: Match the length of a
decimal-typed partition key with its precision if

Chapter 2. SQL Messages 297

the input data file is a binary data file. 32KLIMIT on, the maximum record length can
not exceed the 32k (bytes) limit.
SQL2743N The length of partition key User Response: Check your input data file and
″<partition-key>″ does not match make sure the record length is less than 32k
its data type. bytes.
Explanation: In a binary input data file, the
length of a partition key with integer, small SQL2748N Record ″<record-number>″ has a
integer, float, and double data type must be a length of ″<length>″ bytes, which
predefined constant, i.e. 4 for integer, 2 for small is too short to hold the
integer, 4 for float, and 8 for double. partitioning key ″<key>″.
User Response: Check partition key definitions Explanation: For a positional ASC input data
in the configuration file. file or a binary numerical data file, each record
has to be long enough to hold all partitioning
keys.
SQL2744N Illegal file name specification for
″<file>″ at line ″<line>″ of the User Response: Check the record length of your
configuration file. input data file.
Explanation: The maximum length for a file
name is 80 bytes. SQL2749N Partitioning key ″<key-no>″ of
record ″<rec-no>″ was not in the
User Response: Check the configuration file.
first 32k bytes of the record.
Explanation: If a record is greater than 32k
SQL2745N Invalid NEWLINE flag at line
bytes long in a delimited data file, all
″<line>″ of the configuration file.
partitioning keys of each record have to be
Explanation: The NEWLINE flag must be either within the first 32k bytes of the record.
YES or NO, and if not given, it is NO.
User Response: Check record ″<rec-no>″ in the
User Response: Check the specification of input data file.
NEWLINE flag in the configuration file.
SQL2750N The length of line
SQL2746N An incomplete record was found ″<line-number>″ in the
while reading record configuration was more than 255
″<record-number>″ from the input bytes.
data file.
Explanation: The maximum length of a line in
Explanation: If a fixed-length positional ASC the configuration file must be less than 255 bytes.
file or a binary numerical data file, each record
User Response: Check your configuration file
has to be exactly the same length as the value of
and make sure all lines are less than 255 bytes.
the RECLEN parameter in the configuration file.
User Response: Make sure the input data file is
SQL2751N The actual length
complete.
″<actual-reclen>″ of record
″<rec-no>″ did not match the
SQL2747N A record was too long while expected length ″<exp-reclen>″.
reading record ″<rec-no>″ from
Explanation: If new line checking is required
the input data file.
for a fixed length ASC data file (NEWLINE
Explanation: For a positional ASC input data parameter is YES and RECLEN parameter is not
file or a delimited data file with parameter zero), the actual length of each record has to

298 Message Reference, Volume 2

match the expected record.
SQL2761N Only one of table name or
User Response: Check record ″<rec-no>″ in the nodegroup can be specified.
input data file.
Explanation: Specify either the table name or
the nodegroup name, but not both.
SQL2752N Invalid codepage specification
User Response: Check your command line
″<codepage>″ at line ″<line>″ of
options.
the configuration file.
Explanation: The codepage specification is not
SQL2762N The utility failed to find the
valid. It must be a positive integer.
database installation path.
User Response: Correct the codepage
Explanation: The utility needs to know where
specification in the configuration file.
the database manager is installed, then it can
find its bind file.
SQL2753N Failed to get the country code and
User Response: Make sure your database
codepage for the application.
manager is properly installed.
Return code from function
″<function-name>″ is ″<rc>″.
SQL2763N The table ″<tbl-name>″ was not
Explanation: The program failed to get the
found.
country code and codepage of its environment.
Explanation: The table ″<tbl-name>″ cannot be
User Response: Check with your database
located in sysibm.systables.
system adminstrator.
User Response: Make sure the table exists in
the database.
SQL2754N Codepage ″<source-cp>″ cannot be
converted to codepage
″<target-cp>″. SQL2764N The nodegroup ″<nodegroup>″
was not found.
Explanation: The database does not support
codepage conversion between those two Explanation: The nodegroup ″<nodegroup>″
codepages. cannot be located in sysibm.sysnodegroupdef.
User Response: Please ensure your data is in a User Response: Make sure the nodegroup exists
convertible codepage. in the database.

SQL2755N Decimal data can not be in both SQL2765W The utility failed to open output
IMPLIEDDECIMAL and partition map file
PACKEDDECIMAL format. ″<out-map-file>″.
Explanation: Valid format of decimal data is Explanation: The utility cannot open the output
SQL_PACKEDDECIMAL_FORMAT, partition map file for writing. It will write the
SQL_CHARSTRING_FORMAT, or output to stdout.
SQL_IMPLIEDDECIMAL_FORMAT, mutually
User Response: Check your file access
exclusive.
permissions.
User Response: Verify the format of your
decimal data, correct the format value, and
resubmit the command.

Chapter 2. SQL Messages 299

SQL2766N The partition map is not of the SQL2767N A command line option is not
correct size ″<map-size>″. valid.
Explanation: The size of the partition map is Explanation: There is an invalid command line
not correct. Data is corrupted in the database. option.
User Response: Contact the Database User Response: Make sure to specify the correct
Administrator to resolve the problem. command line options.

SQL2800 - SQL2899
v (7) Ensure that the TCP/IP services on your
SQL2800N CREATE, DROP, or CHANGE
system contains an entry for your instance
NODE failed. Reason code
″<reason-code>″. v (8) Ensure that you only use port values that
are specified in the services file on your
Explanation: The utility failed to add, drop, or system
change the node because the input parameters
v (9) Ensure that the node number specified is
specified are invalid as indicated by the
unique.
following reason codes:
v (10) Ensure that the new host name/port is
v (1) The node number is not specified
not already defined in the db2nodes.cfg file.
v (2) The TCP/IP host name is not specified
v (11) Ensure that the port value 0 has been
v (3) The computer name is not specified defined for host name specified.
v (4) The node number is invalid.
v (5) The port number is invalid. SQL2801N The syntax of the DB2NCRT
v (6) The TCP/IP host name is invalid. command is incorrect.
v (7) The port value is not defined for your Explanation: The DB2NCRT utility creates a
instance in the services file. new node in a partitioned database system.
v (8) The port value is not in the valid range DB2NCRT /n:node /u:username,password
defined for your instance in the services file. [/i:instance]
v (9) The node number is not unique. [/h:host]
[/m:machine]
v (10) The host name/port couple is not unique. [/p:port]
v (11) The host name value has no [/o:instance owning machine]
corresponding port 0. [/g:netname]

User Response: The action corresponding to the The command arguments are:
reason code is:
v /n Specify the node number
v (1) Ensure that the node number is specified
v /u to specify the account name and password
v (2) Ensure that the TCP/IP host name is for the DB2 service.
specified
v (3) Ensure that the computer name is specified The command options are:

v (4) Ensure that the node number is between 0 v /i Specify the instance if different from the
and 999. default/current instance

v (5) Ensure that the port number is between 0 v /h Specify the TCP/IP host name if the host
and 999. name is not the machine default TCP/IP host
name
v (6) Ensure that the host name specified is both
defined on the system and is operational v /m Specify the workstation name if the node
is created on a remote machine

300 Message Reference, Volume 2

v /p Specify the logical port number if this is command with one of the valid command
not the first node on the machine options.
v /o Specify the computer name of the instance
owning machine when creating the first node SQL2804N The syntax of the DB2NLIST
on a machine. command is incorrect.
v /g Specify the network name or IP Address.
Explanation: The DB2NLIST utility list all
User Response: Enter the command again using nodes in a partitioned system.
valid parameters. DB2NLIST [/i:instance]
[/s]
SQL2802N The syntax of the DB2NCHG
command is incorrect. The command options are:
v /i Specify the instance if different from the
Explanation: The DB2NCHG utility changes or
default/current instance
updates node configuration for a given node in a
partitioned database system. v /s Display node status
DB2NCHG /n:node [/h:host] User Response: Issue the DB2NLIST command
[/m:machine] with one of the valid command options.
[/p:port]
[/i:instance]
[/u:username,password] SQL2805N A service error has occurred.
[/g:netname] Reason code ″<reason-code>″.
Explanation: A service error has occurred
The command options are:
during CREATE, DROP or ADD NODE
v /h Change the TCP/IP host name processing as indicated by the following reason
v /m Change the workstation name codes:
v /p Change the logical port number v (1) Unable to register the service
v /i Specify the instance if different from the v (2) Unable to set the required User Rights
default/current instance Policy
v /u Change the Logon Account name and v (3) Unable to set the Logon Account for the
password service
v /g Specify the network name or IP Address v (4) Unable to delete the service

User Response: Issue the DB2NCHG command User Response: The action corresponding to the
with one of the valid command options. reason code is:
v (1) If the workstation name is specified during
SQL2803N The syntax of the DB2NDROP DB2NCRT, ensure that the workstation name
command is incorrect. is correct.
v (2) Ensure that the user name specified is
Explanation: The DB2NDROP utility drops a valid.
node from a partitioned system.
v (3) Ensure that the user name and the
DB2NDROP /n:node [/i:instance] password specified are valid.
v (4) If the node resides on another machine,
The command options are:
ensure that the machine is running.
v /i Specify the instance if different from the
default/current instance
User Response: Issue the DB2NDROP

Chapter 2. SQL Messages 301

If the problem persists, examine the db2diag.log
SQL2811N The command is invalid because
for problem determination information and
the instance is not a partitioned
contact an IBM Service Representative for
database instance.
assistance.
Explanation: The command is only valid if the
instance is a partitioned database instance.
SQL2806N Node ″<node>″ not found for
instance ″<instance>″. User Response: Ensure that the specified
instance name is valid. If the instance name is
Explanation: DB2NDROP failed because the
not specified on the command line, ensure that
node does not exist.
the DB2INSTANCE environment is set to a valid
User Response: Ensure the node number is partitioned database instance.
correct and reissue the command.
SQL2812N An invalid argument was entered
SQL2807N Node ″<node>″ already exists for for the db2drvmp command.
instance ″<instance>″.
Explanation: Usage:
Explanation: DB2NCRT failed because the node db2drvmp add node_number
already exists. from_drive to_drive
drop node_number
User Response: Ensure the node number is from_drive
correct and reissue the command. query [ node_number ]
[ from_drive ]
reconcile [ node_number ]
SQL2808W Node ″<node>″ for instance
[ from_drive ]
″<instance>″ has been deleted.
Explanation: The DB2NDROP processing has Valid arguments for this command are:
completed successfully.
add assign a new database drive map.
User Response: No further action is required.
drop remove an existing database drive map.
query query a database map.
SQL2809W Node: ″<node>″ added to
instance: ″<instance>″ {Host: reconcile
″<host-name>″ Machine: repair a database map drive when the
″<machine-name>″ Port: registry contents are damanged.
″<port-num>″}
node_number
Explanation: The DB2NCRT processing has the node number. The parameter is
completed successfully. required for add and drop operations.
User Response: No further action is required. from_drive
the drive letter to map from. This
parameter is required for add and drop
SQL2810W Node: ″<node>″ changed in
operations.
instance: ″<instance>″ {Host:
″<host-name>″ Machine: to_drive
″<machine-name>″ Port: to drive letter to map to. This parameter
″<port-num>″} is required only for add operation. It is
not applicable for any other operations.
Explanation: The DB2NCHG processing has
completed successfully. User Response: Enter the command again using
valid arguments.
User Response: No further action is required.

302 Message Reference, Volume 2

 User Response: No action necessary.
SQL2813I The drive mapping from drive
″<drive-1>″ to drive ″<drive-2>″
was added for node ″<node>″. SQL2815I The drive mapping for node
″<node>″ is: ″<drive-1>″ -
Explanation: The drive mapping was added
″<drive-2>″.
successfully.
Explanation: Informational message.
User Response: No action necessary.
User Response: No action necessary
SQL2814I The drive mapping from drive
″<drive>″ was deleted for node
″<node>″.
Explanation: The drive mapping was deleted
successfully.

SQL3000 - SQL3099
The file is not closed.
SQL3001C An I/O error (reason =
“<reason>”) occurred while User Response: If the output data file is
opening the output file. incomplete, erase it and resubmit the command.
Explanation: A system I/O error occurred while
opening the output file. SQL3004N The filetype parameter is not
valid.
The command cannot be processed. No data is
processed. Explanation: The filetype parameter must be
DEL, ASC, IXF, WSF, or DB2CS for the
User Response: For IMPORT/LOAD, verify
command.
that the output file exists. For EXPORT, verify
that the output media has enough free space. The filetype parameter must be DEL, IXF, or WSF
Resubmit the command with a valid output file for the EXPORT command.
name, including the correct path. Look in the
message file for additional information. The filetype parameter must be ASC, DEL, IXF, or
DB2CS for the LOAD command.

SQL3002C An I/O error occurred while IXF files can not be used to load into a table
writing to the output data file. defined on a multinode nodegroup.

Explanation: A system I/O error occurred while The command cannot be processed.
writing to the output data file. The output may User Response: Resubmit the command with a
be incomplete or the disk may be full. valid filetype parameter.
The utility stops processing.
User Response: If the output data file is SQL3005N Processing was interrupted.
incomplete, erase it and resubmit the command. Explanation: An interrupt was received during
processing. The user may have pressed the
SQL3003C An I/O error occurred while interrupt key sequence.
closing the output data file. The utility stops processing. Any database
Explanation: A system I/O error occurred while updates not committed are rolled back.
closing the output data file. User Response: Resubmit the command. If

Chapter 2. SQL Messages 303

doing an import, see Command Reference for The command cannot be processed.
information on how to use commitcount and
User Response: Verify the Action String pointer
restartcount parameters. If doing a load, see
and the structure it points to. Resubmit the
Command Reference for information on how to
command with a valid Action String.
restart the load.

SQL3010N The METHOD parameter is not

SQL3006C An I/O error occurred while
valid.
opening the message file.
Explanation: The METHOD parameter in the
Explanation: A system I/O error occurred while
command is not valid. The METHOD pointer
opening the message file. This error can refer to
may be incorrect. The structure that the
a problem on either the client or the server.
METHOD points to may be incorrect. The
The command cannot be processed. METHOD structure may contain characters that
are not valid.
User Response: Resubmit the command with a
valid message file name, including the correct The command cannot be processed.
path.
User Response: Examine the METHOD pointer
and the structure it points to. Resubmit this
SQL3007C An I/O error occurred while command with a valid METHOD.
writing to the message file.
Explanation: A system I/O error occurred while SQL3011C There is not enough storage to
writing to the message file. process the command.
Processing may not have finished. Explanation: A memory allocation error
occurred. Not enough memory is available to
User Response: If the message file is
process the command, or there was an error
incomplete, erase it and resubmit the command.
freeing storage.
The command cannot be processed.
SQL3008N The utility encountered an error
″<error>″ while connecting to the User Response: Stop the application. Possible
database. solutions include:
Explanation: The IMPORT or EXPORT utility v Verify that your system has sufficient real and
could not connect to the database. virtual memory.
v Remove background processes.
No data is imported or exported.
v Increase the util_heap_sz for the database.
User Response: Look at the error number in the
v Decrease the size of buffers to use for the
message for more information. Make changes
LOAD.
and resubmit the command.
v The util_heap_sz is shared by the LOAD,
BACKUP and RESTORE utilities, so have
SQL3009N The Action String parameter is fewer concurrent instances of these utilities
not valid. running.
Explanation: The Action String (e.g. ″REPLACE
into ...″) parameter in the command is not valid. SQL3012C A system error occurred.
The Action String pointer may be incorrect. The
structure that the Action String points to may be Explanation: An operating system error
incorrect. The Action String structure may contain occurred.
characters that are not valid. The command cannot be processed.

304 Message Reference, Volume 2

User Response: Check your message file, The utility stops processing.
correct the problem and resubmit the command.
User Response: Remove the filetype modifier or
specify at least one valid keyword in the filetype
SQL3013N The length of the filetmod is out modifier. See the Command Reference for more
of the acceptable range. It should information on filetype modifiers.
be greater than or equal to zero
and less than or equal to 8000.
SQL3017N A delimiter is not valid or is used
Explanation: The filetmod specified is outside more than once.
the acceptable range (greater than or equal to
Explanation: For Delimited ASCII (DEL) files,
zero and less than or equal to 8000).
one of two errors occurred:
The command cannot be processed. v The character specified for either the column
User Response: Examine the filetmod pointer delimiter, character string delimiter, or decimal
and the structure it points to. Resubmit the point character is not valid.
command with a valid filetmod. v The same character is specified for more than
one of the preceding items.
SQL3014C An I/O error occurred while The command cannot be processed.
closing the message file.
User Response: Examine the specified
Explanation: A system I/O error occurred while delimiters for validity and uniqueness. Resubmit
closing the message file. the command with valid delimiter overrides.
The message file is not closed.
SQL3018N The period was specified as a
User Response: If the message file is
character string delimiter.
incomplete, resubmit the command.
Explanation: For Delimited ASCII (DEL), the
period cannot be specified as the character string
SQL3015N An SQL error “<sqlcode>”
delimiter.
occurred during processing.
The command cannot be processed.
Explanation: An SQL error occurred during the
utility call. User Response: Resubmit the command with
valid delimiter overrides.
The utility stops processing.
User Response: Look at the SQLCODE
SQL3019N No Action String parameter was
(message number) in the message for more
specified in the command.
information. Make changes and resubmit the
command. Explanation: No Action String (e.g. ″REPLACE
into ...″) parameter is specified for this utility
call. This parameter is required.
SQL3016N An unexpected keyword
″<keyword>″ was found in the The command cannot be processed.
filetmod parameter for the
User Response: Resubmit the command with an
filetype.
Action String parameter.
Explanation: A keyword that does not apply to
the filetype for the utility was found in the
filetype modifier (the filetmod parameter or the
phrase following MODIFIED BY in a CLP
command).

Chapter 2. SQL Messages 305

 v CREATETAB authority on the database and
SQL3020N The user does not have the
one of:
authority to run the specified
Export command. – IMPLICIT_SCHEMA authority on the
database, if the schema name of the table
Explanation: The user attempted to export data does not exist
without the appropriate authorization (either the
– CREATEIN privilege on the schema, if the
SYSADM or DBADM authority), or the
schema of the table exists
CONTROL or SELECT privilege for each table
involved in the export. The import operation is not performed.
The export action is not performed. User Response: Ensure that the user has the
authorization to perform the import operation.
User Response: Request appropriate
authorization before exporting data from the
tables. SQL3022N An SQL error “<sqlcode>”
occurred while processing the
SELECT string in the Action
SQL3021N The user does not have the
String parameter.
authority to run the specified
Import command on table Explanation: In IMPORT or EXPORT, during
“<name>”. processing of the SELECT string from the Action
String (e.g. ″REPLACE into ...″) structure, an SQL
Explanation: The user attempted to import data
error occurred.
without the appropriate authorization for the
specified option and table. The command cannot be processed.
Import using the INSERT option requires one of User Response: Look at the SQLCODE
the following: (message number) in the message for more
v SYSADM or DBADM authority information. Make changes and resubmit the
command.
v CONTROL privilege on the table, view, or
entire hierarchy
v INSERT and SELECT privilege on the table, SQL3023N The database name parameter is
view, or entire hierarchy. not valid.

Note: entire hierarchy refers to all subtables or Explanation: The database name parameter is
object views in the hierarchy. not valid. See the SQLERRD[0] field in the
SQLCA for more information.
Import to an existing table or view using the The database name must contain 1 to 8
INSERT_UPDATE, REPLACE, or the characters and the characters must be from the
REPLACE_CREATE option, requires one of the database manager base character set.
following:
The command cannot be processed.
v SYSADM or DBADM authority
v CONTROL privilege on the table, view, or User Response: Resubmit the statement with a
entire hierarchy. valid database name parameter.

Note: entire hierarchy refers to all subtables or

object views in the hierarchy. SQL3025N A parameter specifying a filename
or path is not valid.
Import to a table that does not exist, using the Explanation: The parameter contains a path,
CREATE or REPLACE_CREATE option, requires directory, or file name that is not valid.
one of the following:
v SYSADM or DBADM authority

306 Message Reference, Volume 2

For IMPORT and EXPORT, verify the datafile
SQL3028N The export method indicator is
parameter.
not valid. It must be either ’N’ or
For LOAD, verify that each entry in the ’D’.
parameters of type sqlu_media_list: datafile should
Explanation: The export method indicator must
contain valid filenames; lobpaths copytarget, and
be either N for Names or D for Default.
workdirectory should contain valid paths on the
server including the final separator and a null The command cannot be processed.
terminator.
User Response: Resubmit the statement with a
The pointer to lobpaths, copytarget and valid method indicator.
workdirectory must be valid or null.
The pointer to the targets in these structures SQL3029N No filetype parameter was
must be valid. specified.
Check that sessions and media_type are specified Explanation: The filetype parameter was either
correctly. not specified or null. The system does not know
which format to use for the data file.
Also, if the lobpaths parameter is specified, check
that the media_type is the same as that specified The command cannot be processed.
for the datafile structure.
User Response: Resubmit the statement with a
If the filetype is IXF, the length of the file name valid filetype.
may be too long.
The command cannot be processed. SQL3030C An I/O error (reason =
“<reason>”) occurred while
User Response: Resubmit the statement with a
opening the input file.
valid parameter.
Explanation: A system I/O error occurred while
opening the input file. This error can refer to a
SQL3026N The msgfile or tempfiles path
problem on either the client or the server.
parameter is not valid.
A possible cause may be that the input file is in
Explanation: For IMPORT or EXPORT, the
use by another application.
msgfile parameter contains a path, directory, or
file name that is not valid. The command cannot be processed.
For LOAD, either the msgfile parameter contains User Response: Ensure that the input file is
a path, directory, or file name that is not valid on valid, including the path, and that it is not
the client, or the tempfiles path is not valid on currently in use by another application.
the server.
Resubmit the command. Look in the diagnostics
If the database to which the application is log file for additional information.
connected is a remote database, the msgfile must
be fully qualified. For a local database the utility
SQL3031C An I/O error occurred while
will attempt to fully qualify the msgfile if it is
reading from the input file.
not already fully qualified. Also verify that the
pointer to the msgfile is valid. Explanation: A system I/O error occurred while
reading from the input file. This error can refer
The command cannot be processed.
to a problem on either the client or the server.
User Response: Resubmit the statement with a
The command cannot be processed.
valid msgfile and/or tempfiles path parameter.

Chapter 2. SQL Messages 307

User Response: Verify that the input file is
SQL3035N The tablename parameter in the
readable.
target specification is not valid.
Explanation: For IMPORT, the tablename in the
SQL3032N The LOAD/IMPORT method
Action String (e.g. ″REPLACE into ...″) is not
indicator is not valid for the
valid. For LOAD, the tablename or the exception
specified filetype. It must be
tablename in the Action String is not valid.
either ’N’, ’P’, or ’default’.
The command cannot be processed.
Explanation: For the IXF and WSF filetypes, the
LOAD/IMPORT method indicator must be either User Response: Resubmit the command with a
N for Names, P for Positional, or D for Default. valid tablename. Also ensure that all command
keywords and parameters are entered in the
The command cannot be processed.
correct order.
User Response: Resubmit the command with a
valid method indicator.
SQL3036N The tcolumn-list in the target
specification does not have a
SQL3033N A keyword such as INSERT, closed parenthesis.
REPLACE, CREATE,
Explanation: The tcolumn-list must be delimited
INSERT_UPDATE, or
by parentheses. The list was not terminated by
REPLACE_CREATE is missing
the closed parenthesis.
from the target specification or it
is misspelled. The command cannot be processed.
Explanation: For IMPORT, the Action String (e.g. User Response: Resubmit the statement with a
″REPLACE into ...″) parameter does not contain valid, complete column list in the Action String
the keyword INSERT, REPLACE, CREATE, (e.g. ″REPLACE into ...″) parameter.
INSERT_UPDATE, or REPLACE_CREATE. For
LOAD, the Action String parameter does not
SQL3037N An SQL error “<sqlcode>”
contain the keyword INSERT, REPLACE, or
occurred during Import
RESTART. The keyword must be followed by at
processing.
least one blank.
Explanation: An SQL error occurred during
The command cannot be processed.
processing of the Action String (e.g. ″REPLACE
User Response: Resubmit the command with a into ...″) parameter.
valid Action String parameter.
The command cannot be processed.
User Response: Look at the SQLCODE
SQL3034N The keyword INTO is missing
(message number) in the message for more
from the target specification or it
information. Make changes and resubmit the
is misspelled.
command.
Explanation: The INTO keyword is missing or
spelled incorrectly. INTO must be followed by at
SQL3038N The Action String parameter
least one blank.
contains unexpected characters.
The command cannot be processed.
Explanation: For IMPORT, there are characters
User Response: Resubmit the command with a other than blanks after the closing parenthesis of
valid Action String (e.g. ″REPLACE into ...″) the column list in the Action String (e.g.
parameter. ″REPLACE into ...″) parameter. For LOAD, there
are characters other than blanks after the closing
parenthesis of the column list and/or the

308 Message Reference, Volume 2

exception tablename in the Action String reason given by “<reason-code>”. The codes are
parameter. listed below.
The command cannot be processed. User Response: Given for each reason code:
User Response: Resubmit the command with a 1 The lobpath is not a valid
valid Action String parameter. sqlu_media_list or the values provided
are not valid. The media_type must be
SQLU_LOCAL_MEDIA and all
SQL3039W The memory available to LOAD
pathnames must be terminated with a
for DATA BUFFER prohibits full
valid path separator.
LOAD parallelism. Load
parallelism of “<value>” will be 2 The lobfile is not a valid sqlu_media_list
used. or the values provided are not valid.
The media_type must be
Explanation: The LOAD utility attempted to
SQLU_LOCAL_MEDIA.
determine the optimal level of CPU parallelism
for SMP exploitation based on the system 3 There are not enough lobpath names
configuration, or the user specified a value for provided. For export, there is not
LOAD parallelism when invoking the utility. enough space on the paths provided to
However, one of the following limitation was hold all the lobs.
encountered:
4 There are not enough lobfile names
1. The amount of free memory in the utility provided. For export, there are more
heap prohibits this degree of parallelism. lobs than the number of lobfile names
2. The DATA BUFFER parameter was specified provided multiplied by
with a value too small to allow for the SQLU_MAX_SESSIONS.
specified or available parallelism.
5 The combination of a lobpath name and
A lesser degree of parallelism, requiring less lobfile name would exceed the
memory, will be used. maximum size of a lobfile name (255
bytes).
User Response:
1. Ignore this message, and the LOAD will 6 An error occurred while trying to access
complete normally using the smaller value the file.
for LOAD parallelism. However, Load
performance may be less than optimal. SQL3042N The LINKTYPE specified for a
2. Specify a smaller value for LOAD parallelism DATALINK column is invalid.
when invoking the utility.
Explanation: The value specified for LINKTYPE
3. Increase the size of the utility heap. for a DATALINK column is invalid.
4. Increase the size of the data buffer parameter,
User Response: Check the LINKTYPE specified.
or leave the parameter blank and let the
Correct the value and resubmit the command.
LOAD utility determine a default based on
the freespace in the utility heap.
SQL3043N The DATALINK SPECIFICATION
for DATALINK column(s) is
SQL3040N Unable to use the lobpath/lobfile
invalid.
parameters as specified. Reason
code: “<reason-code>”. Explanation: The DATALINK SPECIFICATION
for DATALINK column(s) is invalid for one of
Explanation: The utility is unable to use the
the following reasons:
lobpath or lobfile parameters as specified for the

Chapter 2. SQL Messages 309

v No value is specified for valid number of columns in the METHOD
DL_URL_REPLACE_PREFIX. parameter.
v No value is specified for
DL_URL_DEFAULT_PREFIX. SQL3047N The LOAD/IMPORT method
v No value is specified for DL_URL_SUFFIX. specified in METHOD is not
v Contains keywords other than valid for Delimited ASCII files. It
DL_URL_REPLACE_PREFIX or must be either ’P’ or ’default’.
DL_URL_DEFAULT_PREFIX or Explanation: The only valid LOAD/IMPORT
DL_URL_SUFFIX. methods for Delimited ASCII files are P for
User Response: Correct the specification and Positions or D for Default.
resubmit the command. The command cannot be processed.
User Response: Resubmit the command with a
SQL3044N The DATALINK SPECIFICATION valid import method.
for a DATALINK column has
duplicate prefix specification.
SQL3048N There are fewer columns specified
Explanation: The DATALINK SPECIFICATION from the input file than database
for a DATALINK column has duplicate columns, but one of the database
specifications for DL_URL_REPLACE_PREFIX or columns is not nullable.
DL_URL_DEFAULT_PREFIX.
Explanation: When fewer columns are specified
User Response: Remove the duplicate in the METHOD list than are specified for the
specification and resubmit the command. target table, the values for the missing input
columns are loaded as nulls. Because the
SQL3045N A dcolumn position in the columns in the target table that correspond to
METHOD parameter is less than one or more of these input columns are not
one or greater than the maximum nullable, null cannot be inserted.
number of columns (1024) in a The file cannot be loaded.
Delimited ASCII file.
User Response: Define a new table that has the
Explanation: The dcolumn position is less than 1 same number of columns as the input file or that
or greater than the maximum number of has nullable columns. Resubmit the command.
columns (1024) in a delimited file.
The command cannot be processed. SQL3049N The data type “<type>” of the
User Response: Resubmit the command with database column “<name>” is not
valid dcolumn positions. compatible with this format file,
but the database column is not
nullable.
SQL3046N The number of columns in the
METHOD parameter is less than Explanation: The database column type is not
one. valid for this format file. The database column is
not nullable so the utility is ended.
Explanation: For METHOD methods other than
Default, the number of columns specified must The utility stops processing. No data is loaded.
be a positive number (greater than 0). User Response: Redefine the database table so
The command cannot be processed. the columns are compatible with the columns
loaded from the file.
User Response: Resubmit the command with a

310 Message Reference, Volume 2

 placing 8191 rows in the file.
SQL3050W Conversions on the data will be
made between the IXF file code User Response: To prevent this error, use a
page and the application code SELECT statement that results in fewer rows to
page. export, and resubmit the command.
Explanation: If an IMPORT of an IXF data file
has been issued and the code page of the SQL3054N The input file is not a valid
character data in the IXF file is different from the PC/IXF file. The file is too short
code page of the application invoking the import to contain a valid H record.
operation, a conversion will be made from the
code page of the data file to the code page of the Explanation: The end of the file was reached
application and the operation will continue. before the expected end of the first record. The
file may not be a PC/IXF file.
If a LOAD of an IXF data file has been issued
and the code page of the character data in the The LOAD/IMPORT utility stops processing. No
IXF file is different from the database code page, data is imported.
a conversion will be made from the code page of User Response: Verify that the input file is
the data file to the code page of the database and correct.
the operation will continue.
User Response: If you do not want a SQL3055N The input file is not a valid
conversion to be performed, invoke the utility PC/IXF file. The length field in
using the FORCEIN option; otherwise no action the first record cannot be
is required. converted to a numeric value.
Explanation: The value in the length field of the
SQL3051W The data to be loaded into first record is not the ASCII representation of a
“<column_name>” has been number. The file may not be a PC/IXF file.
loaded, but conversion from the
IXF file code page to the The utility stops processing. No data is loaded.
application code page has not User Response: Verify that the input file is
been performed. correct.
Explanation: The data that was loaded into the
CLOB or DBCLOB column is stored in a separate SQL3056N The input file is not a valid
file and no conversions have been performed on PC/IXF file. The value in the
it. length field of the H record is too
To properly load the data, call the utility from an small.
application that has the same code page as the Explanation: The value in the length field of the
IXF file. H record is not large enough for a valid H
User Response: This is a warning only. record. The file may not be a PC/IXF file.
The utility stops processing. No data is loaded.
SQL3053N There are more than 8191 rows to User Response: Verify that the input file is
be exported to a worksheet correct.
formatted file.
Explanation: The maximum number of rows
that can be placed in a worksheet format file
(WSF) is 8191.
The EXPORT utility stops processing after

Chapter 2. SQL Messages 311

SQL3057N The input file is not a valid SQL3061N The single-byte and/or
PC/IXF file. The type field in the double-byte code page field in the
first record is not H. H record cannot be converted to a
numeric value or the value is out
Explanation: The type field in the first record is
of range.
not H. The first record is not a valid H record.
The file may not be a PC/IXF file. Explanation: The single-byte and/or
double-byte code page field in the H record is
The utility stops processing. No data is loaded.
not an ASCII representation of a number or is a
User Response: Verify that the input file is number that is not valid for this field.
correct.
The utility stops processing. No data is loaded.
User Response: Examine the single-byte and
SQL3058N The identifier field in the H
double-byte code page field in the H record,
record is not IXF.
change them to appropriate values as specified in
Explanation: The identifier field in the H record the Application Development Guide and resubmit
does not identify the file as a PC/IXF file. the command.

The utility stops processing. No data is loaded.

SQL3062N The double-byte code page field
User Response: Examine the identifier field in in the H record cannot be
the H record. converted to a numeric value or
the value is out of range.
SQL3059N The version field in the H record Explanation: The double-byte code page field in
is not valid. the H record is not an ASCII representation of a
Explanation: The version field in the H record number or is a number that is not valid for this
contains a value that is not valid. field.

The utility stops processing. No data is loaded. The utility stops processing. No data is loaded.

User Response: Examine the version field in the User Response: Examine the double-byte code
H record. page field in the H record, change it to an
appropriate value as specified in the Application
Development Guide and resubmit the command.
SQL3060N The HCNT field in the H record
cannot be converted to a numeric
value or the value is out of range. SQL3063N The single-byte code page value
“<value 1>” in the H record is not
Explanation: The Heading-record-count field in compatible with the single-byte
the H record is not an ASCII representation of a code page value “<value 2>” for
number or is a number that is not valid for this the application. The FORCEIN
field. option was not specified.
The utility stops processing. No data is loaded. Explanation: The single-byte code page value in
User Response: Examine the HCNT field in the the H record is not compatible with the
H record. application code page value. When the FORCEIN
option is not used, the data cannot be loaded
unless conversion from value 1 to value 2 is
supported.
The utility stops processing. No data is loaded.
User Response: To load this data, resubmit the

312 Message Reference, Volume 2

command with the FORCEIN option.
SQL3067N The length field in the T record
cannot be converted to a numeric
SQL3064N The double-byte code page value value.
“<value 1>” in the H record is not
Explanation: The length field in the T record is
compatible with the double-byte
not an ASCII representation of a number.
code page value “<value 2>” for
the application. The FORCEIN The utility stops processing. No data is loaded.
option was not specified.
User Response: Examine the length field in the
Explanation: The double-byte code page value T record.
in the H record is not compatible with the
application code page value. When the FORCEIN
SQL3068N The value in the length field of
option is not used, the data cannot be loaded
the T record is too small.
unless value 1 and value 2 are the same.
Explanation: The value in the length field of the
The utility stops processing. No data is loaded.
T record is not large enough so the T record is
User Response: To load data where the not valid.
double-byte code page values do not match,
The utility stops processing. No data is loaded.
resubmit the command with the FORCEIN
option. User Response: Examine the length field in the
T record.
SQL3065C The value for the application code
page cannot be determined. SQL3069N The first non-A record following
the H record is not a T record.
Explanation: The system encountered an error
while determining the code page of the Explanation: After the H record, the first record
application. not an A record is also not a T record. The H
record must be immediately followed by a T
The utility stops processing. No data is loaded or
record but A records may exist before the T
unloaded.
record.
User Response: Contact your technical service
The utility stops processing. No data is loaded.
representative.
User Response: Examine the records following
the H record.
SQL3066N While reading or looking for the
T record, the end of the file was
reached. SQL3070N The length field in an A record is
out of range.
Explanation: The end of the file was reached
while the system was looking for the T record or Explanation: The length field in an A record is a
while it was reading the T record. number that is not valid for this field.
The utility stops processing. No data is loaded. The utility stops processing. No data is loaded.
User Response: Examine the T record of the User Response: Examine the length field in the
input file. If the PC/IXF file was copied from one A records.
medium to another, compare the copy with the
original or repeat the copy process.

Chapter 2. SQL Messages 313

 number or is a number that is not valid for this
SQL3071N The data-convention field in the T
field.
record is not C.
The utility stops processing. No data is loaded.
Explanation: The data-convention field in the T
record is a value other than C. User Response: Examine the CCNT field in the
T record.
The utility stops processing. No data is loaded.
User Response: Examine the data-convention
SQL3076N The name length field in the T
field in the T record.
record cannot be converted to a
numeric value or the value is out
SQL3072N The data-format field in the T of range.
record is not M.
Explanation: The name length field in the T
Explanation: The data-format field in the T record is not an ASCII representation of a
record is a value other than M. number or is a number that is not valid for this
field.
The utility stops processing. No data is loaded.
The utility stops processing. No data is loaded.
User Response: Examine the data-format field
in the T record. User Response: Examine the name length field
in the T record.
SQL3073N The machine format field in the T
record is not PCbbb (where b = SQL3077N The number of C records
blank). specified in the CCNT field in the
T record “<value>” exceeds the
Explanation: The machine format field in the T
maximum allowed “<maximum>”.
record is a value other than PCbbb, where each b
is a blank. Explanation: The value in the CCNT field of the
T record is larger than the maximum allowed for
The utility stops processing. No data is loaded.
the indicated release.
User Response: Examine the machine format
The utility stops processing. No data is loaded.
field in the T record.
User Response: Examine the CCNT field in the
T record.
SQL3074N The data-location field in the T
record is not I.
SQL3078N The length field in an A record
Explanation: The data-location field in the T
cannot be converted to a numeric
record is a value other than I.
value.
The utility stops processing. No data is loaded.
Explanation: The length field in an A record is
User Response: Examine the data-location field not an ASCII representation of a number.
in the T record.
The utility stops processing. No data is loaded.
User Response: Examine the length fields in the
SQL3075N The CCNT in the T record cannot
A records.
be converted to a numeric value
or the value is out of range.
Explanation: The C-record count field in the T
record is not an ASCII representation of a

314 Message Reference, Volume 2

SQL3079N The length field in a C record SQL3083N The D-record-id field in the C
cannot be converted to a numeric record for column “<name>”
value. cannot be converted to a numeric
value.
Explanation: The length field in a C record is
not an ASCII representation of a number. Explanation: The D-record-id field in the C
record for the indicated column is not an ASCII
The utility stops processing. No data is loaded.
representation of a number.
User Response: Examine the length field in the
The utility stops processing. No data is loaded.
C records.
User Response: Examine the D-record-id field
in the C record.
SQL3080N The value in the length field of
the C record is too small.
SQL3084N The D-record-position field in the
Explanation: The value in the length field of a
C record for column “<name>”
C record is not large enough so the C record is
cannot be converted to a numeric
not valid.
value.
The utility stops processing. No data is loaded.
Explanation: The D-record-position field in the
User Response: Examine the length field in the C record for the indicated column is not an
C records. ASCII representation of a number.
The utility stops processing. No data is loaded.
SQL3081N Not enough C records were
User Response: Examine the D-record-position
found.
field in the C record.
Explanation: The number of C records found
(in the correct position) is less than the number
SQL3085N The D-record-id and
expected from the C-record-count (CCNT) in the
D-record-position fields in the C
T record.
record for column “<name>” are
The utility stops processing. No data is loaded. out of range or inconsistent with
the previous C record.
User Response: Examine the T and C records.
Explanation: The D-record-id or the
D-record-position fields in the C record for the
SQL3082N While reading or looking for a C indicated column contain a value that is either
record, the end of the file was out of the value range or is not correct relative to
reached. the previous C record.
Explanation: The end of the file was reached The utility stops processing. No data is loaded.
while the system was looking for a C record or
while it was still reading a C record. User Response: Examine the D-record-id and
D-record-position fields in the C record.
The utility stops processing. No data is loaded.
User Response: Examine the C records in the
input file. If the PC/IXF file was copied from one
medium to another, compare the copy with the
original or repeat the copy process.

Chapter 2. SQL Messages 315

 source PC/IXF file with the columns in the
SQL3086N There was no source column
database.
specified to be loaded into
database column “<name>” or the
specified source column does not SQL3089N A non-D record was found where
exist, but the database column is a D record was expected.
not nullable.
Explanation: Some record other than a D record
Explanation: Either there was not a PC/IXF was found where a D record was expected.
column specified to be exported into the
indicated column or the specified PC/IXF source The utility stops processing. No data is loaded.
column does not exist. Nulls cannot be inserted User Response: Examine the D records in the
because the database column is not nullable. file.
The utility stops processing. No data is loaded.
User Response: Check the METHOD parameter SQL3090N The length field in a D record
for erroneous names or positions or for fewer cannot be converted to a numeric
entries in the METHOD parameter than the value.
Action String (e.g. ″REPLACE into ...″) parameter Explanation: The length field in a D record is
states or implies. not an ASCII representation of a number.
The utility stops processing. No data is loaded.
SQL3087N The source column specified to be
loaded into database column User Response: Examine the length field in the
“<name>” is not valid, but the D records.
database column is not nullable.
Explanation: The PC/IXF column cannot be SQL3091N The length field in a D record is
loaded into the indicated database column and out of range.
the reason was given in a previous message in Explanation: The length field in a D record is a
the message log. Nulls cannot be inserted number that is not valid for this field.
because the database column is not nullable.
The utility stops processing. No data is loaded.
The utility stops processing. No data is loaded.
User Response: Examine the length field in the
User Response: Read the previous messages to D records.
understand why the column is not valid.

SQL3092N The identifier field in a D record

SQL3088N The source column specified to be does not contain the expected
loaded into database column value.
“<name>” is not compatible with
the database column, but the Explanation: The identifier field in a D record is
database column is not nullable. not valid. One or more D records may have been
written out of sequence.
Explanation: The source PC/IXF column is not
compatible with the target database column. The The utility stops processing. No data is loaded.
column types or lengths may be incompatible. User Response: Examine the identifier field in
Nulls cannot be inserted because the database the D records.
column is not nullable.
The utility stops processing. No data is loaded.
User Response: Compare the columns in the

316 Message Reference, Volume 2

 indicated database column. The database column
SQL3093N The input file is not a valid WSF
is not nullable so the IMPORT utility stops
file.
processing.
Explanation: The first record in the worksheet
No data is imported.
format (WSF) file was not a beginning-of-file
(BOF) record, or the version of the WSF file is User Response: Redefine the database table so
not supported. the columns are compatible with the columns
being imported from the WSF file. Resubmit the
The IMPORT utility stops processing. No data is
command.
imported.
User Response: Verify that the file is a valid
SQL3097N The record length field in the
WSF file and that the name was entered
WSF record is not valid for its
correctly.
record type.
Explanation: The worksheet format (WSF)
SQL3094N The input column “<name>” was
records have an expected fixed length or a
not found, but the corresponding
variable-length range. The record does not
database column is not nullable.
contain the fixed length, or the variable length is
Explanation: The specified column was not in out of range. Some damage occurred to the WSF
the input file. Because the corresponding file, or it was generated incorrectly, possibly with
database column is not nullable, data cannot be a level of the Lotus product not supported by the
loaded into the column. database manager.
The utility stops processing. No data is loaded. The IMPORT utility stops processing.
The column names processed before the error
User Response: Regenerate the WSF file with a
occurred are in the database
supported level of the Lotus product.
User Response: Verify that the input file
contains the specified column names.
SQL3098N The row number from the input
file is not in the valid range of 1
SQL3095N The specified column position to 8192.
“<position>” is not in the valid
Explanation: The maximum number of rows
range of 1 to 256.
that a worksheet format (WSF) spreadsheet can
Explanation: A column position was specified contain is 8192. The cell coordinate contains a
that was not within the range of 1 to 256. value outside the valid range. Some damage
occurred to the WSF file, or it was generated
The utility stops processing. No data is loaded.
incorrectly, possibly with a level of the Lotus
The column names processed before the error
product not supported by the database manager.
occurred are in the database.
The IMPORT utility stops processing.
User Response: Verify that the specified column
position is within the range 1 to 256. User Response: Regenerate the WSF file with a
supported level of the Lotus product.
SQL3096N The data type “<type>” of the
database column “<name>” is not SQL3099N The column number from the
compatible with any WSF column input file is not in the valid range
type, but the database column is of 1 to 256.
not nullable.
Explanation: The maximum number of columns
Explanation: There is not any worksheet format that a worksheet format (WSF) spreadsheet can
(WSF) column type that is compatible with the contain is 256. The cell coordinate contains a

Chapter 2. SQL Messages 317

value outside the valid range. Some damage has The IMPORT utility stops processing.
occurred to the WSF file, or it was generated
User Response: Regenerate the WSF file with a
incorrectly, possibly with a level of the Lotus
supported level of the Lotus product.
product that is not supported by the database
manager.

SQL3100 - SQL3199

SQL3100W Column number SQL3102W The number of columns in the

“<column-number>” (identified as METHOD parameter is greater
“<name>”) in the output DEL than the number of columns in
format file is longer than 254 the Action String (e.g. ″REPLACE
bytes. into ...″) parameter.
Explanation: The length or maximum length of Explanation: The number of columns taken
the specified output column is greater than 254 from the input file or table is greater than the
bytes. Columns larger than 254 are not supported number to be put in the output table or file.
by some other products.
Only data for the columns indicated in the
The entire field is exported without truncation. output table or file will be processed. Data in the
excess input columns is not processed.
User Response: If the output file cannot be
processed by another product, export only a User Response: Review the data in the output
substring of the incorrect column, redefine the table or file.
table, or manually truncate the data in the DEL
column.
SQL3103W The number of columns in the
METHOD parameter is less than
SQL3101W There is a character string the number of columns in the
delimiter in column Action String (e.g. ″REPLACE into
“<column-number>” in row ...″) parameter.
“<row-number>”.
Explanation: The number of columns taken
Explanation: The system puts character string from the input file or table is less than the
delimiters around the character strings being number to be put in the output table or file.
exported but it found a character string that
Only data for the columns indicated in the input
already has the delimiter in the character string.
table or file will be processed. Data in the excess
Delimiters will be placed around the character output columns is not processed.
string. Future use of that string leads to an
User Response: Review the data in the output
appearance of truncation. Processing can
table or file.
continue.
User Response: Review the data for the given
SQL3104N The Export utility is beginning to
column and row in the output table or file. To
export data to file “<name>”.
avoid loss of data, change the character delimiter
to some character that is not in the data. Explanation: This is the normal beginning
message.
User Response: No action is required.

318 Message Reference, Volume 2

 2 DATALINK value DB2 Data Links
SQL3105N The Export utility has finished
Manager is not registered with the
exporting ″<number>″ rows.
database.
Explanation: This is the summary message for
3 DATALINK linktype value is not valid.
the export utility which is printed at the end of
the message file. This message will state how 4 DATALINK value referenced file cannot
many rows resulting from the SELECT statement be found by the DB2 Data Links
were processed before the export utility Manager.
terminated.
5 DATALINK value referenced file is
User Response: If an sqlcode of 0 was returned already linked to the database.
from the utility, then no response is required. If
an sqlcode of 3107 was returned, check the 6 DATALINK value referenced file cannot
message file for warnings that occurred during be accessed for linking. It may be a
the export and resubmit the command if desired. symbolic link or a file with permission
If a negative sqlcode was returned, an error bit for set user ID (SUID) on or set
occurred during the export and the data file may group ID (SGID) on.
not contain all the data requested. The command 7 DATALINK value URL or comment is
should be resubmitted with the error corrected. too long.
User Response: The action is based on the
SQL3106N An error occurred while ″<reason-code>″ as follows:
formatting a message for the
message file. 1 Correct the data location format. If
hostname is not specified, DB2 can use
Explanation: The error message may be the local hostname as default only if
incomplete or formatted incorrectly. support for FILE LINK CONTROL is
User Response: No action is required. enabled. Refer to the Administration
Guide for information on enabling this
support.
SQL3107W There is at least one warning
message in the message file. 2 Ensure that the correct DB2 Data Links
Manager is specified and if so have it
Explanation: At least one warning was received registered to the database. Registered
during processing. DB2 Data Links Managers are ignored
unless support for FILE LINK
This warning does not affect processing.
CONTROL is enabled. Refer to the
User Response: Review the message file Administration Guide for information
warning. on enabling this support.
3 Correct the linktype value.
SQL3108W Unable to access file referenced
4 Check that the correct file is specified
by a DATALINK value in row
and that the file exists
“<row-number>” and column
“<column-number>”. Reason code 5 Either unlink the existing reference to
= “<reason-code>”. the file or do not specify the file in this
statement.
Explanation: The possible causes of this
message depend on the value of 6 Linking of directories is not allowed.
″<reason-code>″: Use the actual file name, not the
symbolic link. If SUID or SGID is on,
1 DATALINK value data location format
this file cannot be linked using a
is not valid.
DATALINK type.

Chapter 2. SQL Messages 319

7 Reduce the length of the data location
SQL3113W The data type “<type>” of the
value or the comment.
database column “<name>” is not
compatible with this format file.
SQL3109N The utility is beginning to load Null values are inserted for the
data from file “<name>”. column.

Explanation: This is the normal beginning Explanation: The database column type is not
message. The message may indicate the name of valid for this file. Because the column is nullable,
a temporary file created on the server instead of nulls are inserted.
the source file.
Null values are loaded for the indicated column.
User Response: No action is required.
User Response: If nulls are not acceptable for
the column, do one of the following:
SQL3110N The utility has completed v Edit the data in the table.
processing. “<number>” rows
v If possible, use another compatible column in
were read from the input file.
the database table as the target column and
Explanation: This is the normal ending resubmit the command.
message. v Redefine the database table so the columns are
User Response: No action is required. compatible with the columns being loaded and
resubmit the command.

SQL3111C An I/O error occurred while

closing the input data file. SQL3114W Some data following “<text>” in
row “<row-number>” and column
Explanation: A system I/O error occurred while “<column-number>” was not
closing the input data file. This error can refer to loaded.
a problem on either the client or the server.
Explanation: Some data in the specified row
The file is not closed. and column is not loaded, probably because the
column contains data as follows:
User Response: Examine the input file for an
I/O error. v A closed string delimiter
v An isolated carriage return or line feed control
character
SQL3112W There are fewer input file
columns specified than database v A non-delimited string value.
columns. The text that was loaded is shown in the
Explanation: There are fewer columns specified “<text>” token.
in the input file than in the output table. Because
the extra columns in the table are defined as The contents of the field may be incomplete.
nullable, the values in those columns are filled
User Response: Compare the value in the
with nulls.
output table with the input file. If necessary,
User Response: No action is required. correct the input file and resubmit the command,
or edit the data in the table.

320 Message Reference, Volume 2

 that contains the value in question. For ASCII
SQL3115W The field value beginning
files, the value of the column number specifies
“<text>” in row “<row-number>”
the byte location within the row where the value
and column “<column-number>”
in question begins.
is longer than the longest
allowable table column. The value A null value is loaded.
was truncated.
User Response: Examine the input value. If
Explanation: The field value is longer than necessary, correct the input file and resubmit the
32700 bytes. command or edit the data in the table.
The value was truncated after 32700 bytes.
SQL3118W The field value in row
User Response: Compare the value in the
“<row-number>” and column
output table with the input file. If necessary,
“<column-number>” cannot be
correct the input file and resubmit the command
converted to a SMALLINT value,
or edit the data in the table. Check for
but the target column is not
unmatched character string delimiters.
nullable. The row was not loaded.
Explanation: The value in the specified field
SQL3116W The field value in row
cannot be converted to a SMALLINT value.
“<row-number>” and column
There may be a data type mismatch. The value
“<column-number>” is missing,
may be larger than a 2-byte integer. A null
but the target column is not
cannot be loaded because the output column in
nullable.
the table is not nullable.
Explanation: A null field value was encountered
For delimited ASCII (DEL) files, the value of the
in the input file. Because the target column in the
column number specifies the field within the row
table is not nullable, it cannot be loaded.
that contains the value in question. For ASCII
For files other than ASCII files, the value of the files, the value of the column number specifies
column number specifies the field within the row the byte location within the row where the value
of the missing data. For ASCII files, the value of in question begins.
the column number specifies the byte position
The row is not loaded.
within the row of the missing data.
User Response: Correct the input file and
The row is not loaded.
resubmit the command or edit the data in the
User Response: If necessary, correct the input table.
file and resubmit the command or edit the data
in the table.
SQL3119W The field value in row
“<row-number>” and column
SQL3117W The field value in row “<column-number>” cannot be
“<row-number>” and column converted to an INTEGER value.
“<column-number>” cannot be A null was loaded.
converted to a SMALLINT value.
Explanation: There may be a data type
A null was loaded.
mismatch because the value in the specified field
Explanation: The value in the specified field cannot be converted to an INTEGER value.
cannot be converted to a SMALLINT value.
For delimited ASCII (DEL) files, the value of the
There may be a data type mismatch. The value
column number specifies the field within the row
may be larger than a 2-byte integer.
that contains the value in question. For ASCII
For delimited ASCII (DEL) files, the value of the files, the value of the column number specifies
column number specifies the field within the row

Chapter 2. SQL Messages 321

the byte location within the row where the value User Response: Examine the input value. If
in question begins. necessary, correct the input file and resubmit the
command or edit the data in the table.
A null value is loaded.
User Response: Examine the input value. If
SQL3122W The field value in row
necessary, correct the input file and resubmit the
“<row-number>” and column
command or edit the data in the table.
“<column-number>” cannot be
converted to a FLOAT value, but
SQL3120W The field value in row the target column is not nullable.
“<row-number>” and column The row was not loaded.
“<column-number>” cannot be
Explanation: The value in the specified field
converted to an INTEGER value,
cannot be converted to a FLOAT value. There
but the target column is not
may be a data type mismatch. A null cannot be
nullable. The row was not loaded.
loaded because the output column in the table is
Explanation: There may be a data type not nullable.
mismatch because the value in the specified field
For delimited ASCII (DEL) files, the value of the
cannot be converted to an INTEGER value. A
column number specifies the field within the row
null cannot be loaded because the output column
that contains the value in question. For ASCII
in the table is not nullable.
files, the value of the column number specifies
For delimited ASCII (DEL) files, the value of the the byte location within the row where the value
column number specifies the field within the row in question begins.
that contains the value in question. For ASCII
The row is not loaded.
files, the value of the column number specifies
the byte location within the row where the value User Response: Correct the input file and
in question begins. resubmit the command or edit the data in the
table.
The row is not loaded.
User Response: Correct the input file and
SQL3123W The field value in row
resubmit the command or edit the data in the
“<row-number>” and column
table.
“<column-number>” cannot be
converted to a PACKED
SQL3121W The field value in row DECIMAL value. A null was
“<row-number>” and column loaded.
“<column-number>” cannot be
Explanation: The value in the specified field
converted to a FLOAT value. A
cannot be converted to a PACKED DECIMAL
null was loaded.
value. There may be a data type mismatch.
Explanation: The value in the specified field
For delimited ASCII (DEL) files, the value of the
cannot be converted to a FLOAT value. There
column number specifies the field within the row
may be a data type mismatch.
that contains the value in question. For ASCII
For delimited ASCII (DEL) files, the value of the files, the value of the column number specifies
column number specifies the field within the row the byte location within the row where the value
that contains the value in question. For ASCII in question begins.
files, the value of the column number specifies
A null value is loaded.
the byte location within the row where the value
in question begins. User Response: Examine the input value. If
necessary, correct the input file and resubmit the
A null value is loaded.
command or edit the data in the table.

322 Message Reference, Volume 2

SQL3124W The field value in row SQL3128W The field containing ″<data>″ in
“<row-number>” and column row ″<row-number>″ and column
“<column-number>” cannot be ″<column-number>″. was
converted to a PACKED truncated into a DATE field
DECIMAL value, but the target because the data is longer than
column is not nullable. The row the database column.
was not loaded.
Explanation: The date value in the specified
Explanation: The value in the specified field field is longer than the length of the string
cannot be converted to a PACKED DECIMAL representation of a date.
value. There may be a data type mismatch. A
The date value is truncated to fit into the table.
null cannot be loaded because the output column
in the table is not nullable. User Response: Compare the value in the
output table with the input file. If necessary,
For delimited ASCII (DEL) files, the value of the
correct the input file and resubmit the command
column number specifies the field within the row
or edit the data in the table.
that contains the value in question. For ASCII
files, the value of the column number specifies
the byte location within the row where the value SQL3129W The date, time, or timestamp field
in question begins. containing “<text>” in row
“<row-number>” and column
The row is not loaded.
“<column-number>” was padded
User Response: Correct the input file and with blanks.
resubmit the command or edit the data in the
Explanation: The field data in the input file was
table.
shorter than the database column.
The data on the right is padded with blanks.
SQL3125W The character data in row
“<row-number>” and column User Response: Compare the value in the
“<column-number>” was output table with the input file. If necessary,
truncated because the data is correct the input file and resubmit the command
longer than the target database or edit the data in the table.
column.
Explanation: The length of the field data in the SQL3130W The field containing “<text>” in
input file was longer than the length of the row “<row-number>” and column
database field where it is being loaded. “<column-number>” was
truncated into a TIME field
The character data was truncated.
because the data is longer than
User Response: Compare the value in the the database column.
output table with the input file. If necessary,
Explanation: The time value in the specified
correct the input file and resubmit the command
field is longer than the length of the string
or edit the data in the table. The width of the
representation of a time.
database column cannot be increased. If
necessary, define a new table with wider The time value is truncated to fit into the table.
columns and repeat the process.
User Response: Compare the value in the
output table with the input file. If necessary,
correct the input file and resubmit the command
or edit the data in the table.

Chapter 2. SQL Messages 323

 A null value is loaded.
SQL3131W The field containing “<text>” in
row “<row-number>” and column User Response: Examine the input value. If
“<column-number>” was necessary, correct the input file and resubmit the
truncated into a TIMESTAMP command or edit the data in the table.
field because the data is longer
than the database column.
SQL3134W The field in row “<row-number>”
Explanation: The timestamp value in the and column “<column-number>”
specified field is longer than the length of the contains invalid DATALINK
string representation of a timestamp. value, but the target column is not
nullable. The row was not loaded.
The timestamp value is truncated to fit into the
table. Explanation: The DATALINK value in the
specified field is invalid. For delimited ASCII
User Response: Compare the value in the
(DEL) files, the value of the column number
output table with the input file. If necessary,
specifies the field within the row that contains
correct the input file and resubmit the command
the value in question. For ASCII files, the value
or edit the data in the table.
of the column number specifies the byte location
within the row where the value in question
SQL3132W The character data in column begins.
″<column>″ will be truncated to
User Response: Examine the input value. If
size ″<size>″.
necessary, correct the input file and resubmit the
Explanation: The character data column has a command.
defined size that is longer than the longest
default character column which can be exported;
SQL3135N The number of columns in the
each value will be truncated to the specified size.
METHOD parameter is greater
For example, by default, only the first than the number of columns in
SQL_LONGMAX bytes of a LOB column will be the target table.
exported. If the entire LOB column is desired, the
Explanation: The number of data columns in
LOBSINFILE keyword must be specified in the
the METHOD parameter must be less than or
filetype modifier and each LOB column will be
equal to the number of data columns in the
stored into a separate file.
actual table.
User Response: This is a warning only. No
User Response: Specify the correct number of
action is required.
input columns in the METHOD parameter and
resubmit the command.
SQL3133W The field in row “<row-number>”
and column “<column-number>”
SQL3137W Row “<row-number>” is too
contains invalid DATALINK
short. At least one input value
value. A null was loaded.
being loaded to a non-nullable
Explanation: The DATALINK value in the database column is missing. The
specified field is invalid. For delimited ASCII row was not loaded.
(DEL) files, the value of the column number
Explanation: If loading from a delimited ASCII
specifies the field within the row that contains
file, the row contains too few fields. If loading
the value in question. For ASCII files, the value
from a non-delimited ASCII file, the row contains
of the column number specifies the byte location
too few bytes of data. There is no input value for
within the row where the value in question
at least one non-nullable target column.
begins.
The row is not loaded.

324 Message Reference, Volume 2

User Response: Examine the input file and the
SQL3143W A maximum length of variable
contents of the target table. Correct the input file
length column
and resubmit the command, or edit the data in
“<column-number>” exceeds the
the table.
limitation of 240 bytes. Data from
the column may be truncated.
SQL3138W The ending character string
Explanation: The LOTUS 1-2-3** and
delimiter was not found before
Symphony** programs have a limit of 240 bytes
the end of the input data file was
for label records. Whenever a character field
reached.
longer than 240 bytes is written to a worksheet
Explanation: The end of the input data file was format (WSF) file, the data will be truncated to
reached before the terminating character string 240 bytes.
delimiter was found.
Continue processing. Subsequent data entries for
A closing character string delimiter is assumed at the column may be truncated.
the end of the data.
User Response: Verify the output. If significant
User Response: Compare the value in the data from the column is lost because of
output table with the input file. If necessary, truncation, investigate selecting the data from the
correct the input file and resubmit the command column in several fields by substringing, or
or edit the data in the table. redesign the database.

SQL3139W An error ″<error>″ occurred while SQL3144W The length of fixed length column
the utility was disconnecting from “<column-number>” exceeds the
the database. 240-byte limitation. Data from the
column may be truncated.
Explanation: The IMPORT or EXPORT utility
could not disconnect from the database. Explanation: The Lotus 1-2-3** and Symphony**
programs have a limit of 240 bytes for label
The output data may be incomplete. records. Whenever a character field longer than
User Response: Use the error number in the 240 bytes is written to a worksheet format (WSF)
message to determine the exact error. file, the data will be truncated to 240 bytes.
All data entries for the column are truncated
SQL3142W The column heading for column with no additional messages written to the
“<column-number>” is being message log.
truncated to 240 bytes. Continue processing.
Explanation: The LOTUS 1-2-3** and User Response: Verify output. If significant data
Symphony** programs have a limit of 240 bytes from the column is lost because of truncation,
for label records. If a column heading greater investigate selecting the data from the column in
than 240 bytes is specified for export, it is be several fields by substringing, or redesign the
truncated to 240 bytes. database.
The column heading is truncated. Processing
continues. SQL3145W The data for row
User Response: Verify that the column headings “<row-number>”, column
are 240 bytes or less. Check for a possible error “<column-number>” is being
in specifying the names for the columns in the truncated to 240 bytes.
output worksheet format (WSF) file. Explanation: The Lotus 1-2-3** and Symphony**
programs have a limit of 240 bytes for label

Chapter 2. SQL Messages 325

records. Whenever a character field longer than compatible with the database field where the
240 bytes is written to a worksheet format (WSF) field is being inserted.
file, the data is truncated to 240 bytes. This
Processing continues with the next row of input
message is preceded by message SQL3143
data.
associated with the column.
User Response: See the next message in the
Processing continues. The data is truncated.
message file for the row number not inserted.
User Response: Verify the output. If significant Examine the input file and the database contents.
data from the column is lost because of If desired, modify the database or modify the
truncation, investigate selecting the data from the input file and rerun the operation.
column in several fields by substringing, or
redesign the database.
SQL3149N “<number-1>” rows were
processed from the input file.
SQL3146N The DATE or TIMESTAMP value “<number-2>” rows were
for row “<row-number>” and successfully inserted into the
column “<column-number>” is table. “<number-3>” rows were
out of range. rejected.
Explanation: The value for a date or timestamp Explanation: This summary message tells how
is not valid. A date value from 01-01-1900 to many rows of data were read from the input file,
12-31-2099 is valid for worksheet format (WSF) how many rows were successfully inserted into
files. the database table, and how many rows were
rejected. If using the INSERT_UPDATE option,
The cell record is not created.
the number of rows updated is the number of
User Response: Compare the value in the rows processed minus the number inserted and
output file with the input table. If necessary, rejected.
correct the input value and resubmit the
User Response: None, because this is a
command or edit the data in the table.
summary message. The detail messages may
suggest corrective action.
SQL3147W More than 2048 rows were
exported into a worksheet
SQL3150N The H record in the PC/IXF file
formatted file.
has product “<product>”, date
Explanation: The number of rows exported “<date>”, and time “<time>”.
exceeds 2048. The first generation products
Explanation: Information is given about the
cannot support more than 2048 rows.
product that created the PC/IXF file and when it
Continue processing. was created.

User Response: The rows beyond 2048 can be User Response: No action is required.
read only by second and third generation
products.
SQL3151N No data conversion will be done
from the single-byte code page
SQL3148W A row from the input file was not value “<code-page>” in the H
inserted into the table. SQLCODE record to the application
“<sqlcode>” was returned. single-byte code page value
“<code-page>” because the
Explanation: The database operation to insert a FORCEIN option was specified.
row of data read from the input file failed. One
or more of the fields in the input file is not Explanation: No data conversion will be
performed from the IXF code page to the

326 Message Reference, Volume 2

application code page because the FORCEIN HCNT or CCNT values and resubmit the
option was specified. command.
User Response: No action is required. If the
conversion from the IXF file code page to the SQL3155W The name length field in the C
application code page is supported by the record for column “<name>” is
database manager, the operation can be not valid. Data from the column
resubmitted without the FORCEIN option and will not be loaded.
the data will be converted.
Explanation: The value in the name length field
in the C record for the indicated column is not
SQL3152N The double-byte code page value valid.
“<value>” in the H record is not
Data from the indicated column is not loaded.
compatible with the double-byte
code page value “<value>” for the User Response: Change the name length field
application. Data will be inserted in the C record and resubmit the command.
because the FORCEIN option was
specified.
SQL3156W The null field in the C record for
Explanation: The double-byte code page values column “<name>” is not valid.
in the record and the application are not Data from the column will not be
compatible. Because the FORCEIN option was loaded.
used, the data is inserted.
Explanation: The null field in the C record for
User Response: No action is required. the indicated column is not valid.
Data from the indicated column is not loaded.
SQL3153N The T record in the PC/IXF file
has name “<name>”, qualifier User Response: Change the null field in the C
“<qualifier>”, and source record and resubmit the command.
“<source>”.
Explanation: Optional information is given SQL3157W The type field in the C record for
about the name of the table where data was column “<name>” is not valid.
extracted, the product that created the table, and Data from the column will not be
the original source of the data. loaded.

User Response: No action is required. Explanation: The type field in the C record for
the indicated column is not valid. The code page
values may not be compatible with the column
SQL3154W The HCNT value in the H record type.
and the CCNT value in the T
record are not compatible. The Data from the indicated column is not loaded.
CCNT value in the T record will User Response: Change the type field in the C
be used. record and resubmit the command.
Explanation: The HCNT value in the H record
and the CCNT value in the T record do not SQL3158W The single-byte code page field in
agree. the C record for column
The CCNT value in the T record is used. “<name>” is not valid. Data from
the column will not be loaded.
User Response: Verify that the CCNT value is
correct. If not, make the necessary changes to the Explanation: The single-byte code page field in
the C record for the indicated column is not
valid.

Chapter 2. SQL Messages 327

Data from the indicated column is not loaded.
SQL3162W The scale field in the C record for
User Response: Change the single-byte code column “<name>” is not valid.
page field in the C record and resubmit the Data from the column will not be
command. loaded.
Explanation: The scale field in the C record for
SQL3159W The double-byte code page field the indicated column is not valid.
in the C record for column
Data from the indicated column is not loaded.
“<name>” is not valid. Data from
the column will not be loaded. User Response: Change the scale field in the C
record and resubmit the command.
Explanation: The double-byte code page field in
the C record for the indicated column is not
valid. SQL3163W The column length field in the C
record for floating point column
Data from the indicated column is not loaded.
“<name>” is blank. A value of
User Response: Change the double-byte code 00008 will be used.
page field in the C record and resubmit the
Explanation: The column length field in the C
command.
record for the indicated column is blank.
A column length of 00008 is used.
SQL3160W The column length field in the C
record for column “<name>” is User Response: No action is required.
not valid. Data from the column
will not be loaded.
SQL3164W The column length field in the C
Explanation: The column length field in the C record for floating point column
record for the indicated column is not valid. “<name>” is not valid. Data from
the column will not be loaded.
Data from the indicated column is not loaded.
Explanation: The column length field in the C
User Response: Change the column length field
record for the indicated column is not valid. The
in the C record and resubmit the command.
indicated column is a floating point column.
Data from the indicated column is not loaded.
SQL3161W The precision field in the C
record for column “<name>” is User Response: Change the column length field
not valid. Data from the column in the C record and resubmit the command.
will not be loaded.
Explanation: The precision field in the C record SQL3165W The column type field “<type>”
for the indicated column is not valid. in the C record for column
“<name>” is not valid. Data from
Data from the indicated column is not loaded.
the column will not be loaded.
User Response: Change the precision field in
Explanation: The column type in the C record
the C record and resubmit the command.
for the indicated column is not valid.
Data from the indicated column is not loaded.
User Response: Change the column type field
in the C record and resubmit the command.

328 Message Reference, Volume 2

SQL3166W No PC/IXF column was specified SQL3169N The FORCEIN option may be
to be loaded into database column used to make the PC/IXF column
“<name>”, or the specified PC/IXF “<name>” acceptable for loading
column does not exist. Nulls will into database column “<name>”.
be inserted.
Explanation: This is for information only about
Explanation: Either there was not a PC/IXF the optional use of the FORCEIN option.
column specified to be loaded into the indicated
User Response: No action required.
column, or the specified PC/IXF source column
does not exist.
SQL3170W The end of the file was reached
Null values are loaded for the indicated column.
within a row of data. The partial
User Response: No action is required. If nulls row of data was not loaded.
are not acceptable for this column, check the
Explanation: The end of the file was reached
METHOD parameter for erroneous names or
before the end of the current row of data. The
positions or for fewer entries in the METHOD
file may contain only part of the expected data.
parameter than columns stated in or implied by
the Action String (e.g. ″REPLACE into ...″) The partial row of data is not loaded.
parameter.
User Response: If the PC/IXF file was copied
from one medium to another, compare the copy
SQL3167W The PC/IXF column specified to with the original or repeat the copy process.
be loaded into database column
“<name>” is not valid. Nulls will
be inserted. SQL3171W A non-label record was found in
the column header row. The
Explanation: Values in the PC/IXF column record was not processed.
cannot be loaded into the indicated database
column and the reason is given in a previous Explanation: The IMPORT utility expects only
message in the log. label records in the column header row (row
one) of the worksheet format (WSF) file.
Null values are loaded for the indicated column.
The system does not process the record and
User Response: Read the previous messages to continues to the next record.
understand why the column is not valid.
User Response: Remove all data and
information except the column headers from the
SQL3168W The PC/IXF column specified to first row of the spreadsheet file. Resubmit the
be loaded into database column command.
“<name>” is not compatible with
the database column. Nulls will
be inserted. SQL3172W The specified input column
“<name>” was not found. The
Explanation: The source PC/IXF and the target corresponding database column
database column types or lengths may not be will contain null values.
compatible.
Explanation: The specified input column was
Null values are loaded for the indicated column. not found in the input spreadsheet file. The
database column is nullable and contains null
User Response: Compare the columns in the
values.
source PC/IXF file and the database.
User Response: Verify the specified input
column name.

Chapter 2. SQL Messages 329

 database and resubmit the command.
SQL3173N The inserted data for column
“<name>” will always contain
fewer characters than the column SQL3176W The value for row “<row>”,
width. column “<column>” in the WSF
file is out of range for a date
Explanation: The database column width is
value.
larger than the maximum worksheet format
(WSF) label record. Explanation: The record in the spreadsheet file
contains a value that is too large or too small to
Continue processing.
represent a valid worksheet format (WSF) date.
User Response: No action is required. A valid WSF date is between 1 and 73050,
inclusive.
SQL3174W The data type “<type>” of the If the column is nullable, a null is inserted. If the
database column “<name>” is not column is not nullable, the row is not imported.
compatible with any WSF column
User Response: Either edit the data in the table
type. Null values will be inserted
or verify that the data in the spreadsheet file is
for this column.
valid for import into a database manager
Explanation: The database column type is not database and resubmit the command.
valid for a worksheet format (WSF) file. Because
the column is nullable, nulls are imported for the
SQL3177W The value in the WSF file for row
column.
“<row>”, column “<column>” is
User Response: If nulls are not acceptable for out of range for a time value.
the column, do one of the following:
Explanation: The record in the spreadsheet file
v Edit the data in the table. contains a value that is either too large or too
v If possible, use another compatible column in small to represent a valid worksheet format
the database table as the target column and (WSF) time. A WSF time is a value equal to or
resubmit the command. greater than zero, but less than one.
v Redefine the database table so that the If the column is nullable, a null is inserted. If the
columns are compatible with the columns column is not nullable, the row is not imported.
imported from the WSF file, and resubmit the
command. User Response: Either edit the data in the table
or verify that the value to be imported is a time
value in the input spreadsheet file and resubmit
SQL3175W The input record for database row the command.
“<row>”, column “<column>” is
not valid.
SQL3178W The type of record in the WSF file
Explanation: The record in the spreadsheet file for database row
is not compatible with the data type of the “<row-number>”, column
database column. If the database column is a “<column-number>” is not valid
graphic data type, the input data may contain an for representing a time value.
odd number of bytes.
Explanation: The input value is an integer
If the column is nullable, a null is inserted. If the value. A time value must be represented by a
column is not nullable, the row is not imported. floating point number or a fraction of a day in a
User Response: Either edit the data in the table worksheet format (WSF) spreadsheet file.
or verify that the data in the spreadsheet file is If the column is nullable, a null is inserted. If the
valid for importing into a database manager column is not nullable, the row is not imported.

330 Message Reference, Volume 2

User Response: Either edit the data in the table User Response: Check for data that was not
or verify that the value to be imported is a time loaded. If data is missing, edit the table or
value in the input spreadsheet file and resubmit change the input file and resubmit the command.
the command. If the PC/IXF file was copied from one medium
to another, compare the copy with the original or
repeat the copy process.
SQL3179W Row “<row>” in the input file is
missing data for inserting into a
non-nullable column in the SQL3182W Insert diskette “<number>” into
database. The row was not drive “<drive>”. The diskette that
inserted. is currently inserted is not the
right diskette or the continuation
Explanation: The row of data from the input
diskette is not valid.
file has missing or not valid data for a
non-nullable column. The values in the Explanation: During the load of a PC/IXF file
remaining database columns in that row are not that is contained on more than one diskette, a
inserted. request to insert a diskette was sent to the
application, a confirmation that the diskette is in
Processing continues with the next row. The row
the drive was returned but the continuation file
is not inserted.
is not there or is not valid. This action does not
User Response: Either edit the data in the table apply to the first diskette.
or verify that the data in the spreadsheet file is
The utility waits for a response from the
valid for inserting into a database manager
application to either continue processing or stop
database.
processing.
User Response: Have the user verify that the
SQL3180W Insert diskette “<number>” into
correct diskette is in the drive. If the correct
drive “<drive>”.
diskette is in the drive, call the utility again with
Explanation: This is a request for the the callerac parameter set to stop processing.
application to prompt the user to place the
specified diskette in the specified drive.
SQL3183W Multiple delimiter overrides in
The utility is waiting to be called again after the the filetmod parameter are not
user puts the diskette in the drive. separated by blanks.

User Response: Prompt the user for the diskette Explanation: At least one COLDEL, CHARDEL
and then return to the utility with the callerac or DECPT keyword in the filetmod parameter is
parameter indicating whether processing not at the beginning of the filetmod parameter
continues or ends. and does not follow a blank (space). This
condition may arise during the LOAD/IMPORT
or export of delimited ASCII (DEL) files.
SQL3181W The end of the file was reached
before the expected ending record The utility stops processing. The erroneous
was found. delimiter overrides are ignored.

Explanation: During the load of a PC/IXF file User Response: Resubmit the command with a
created by the database manager, the A record of correct filetmod parameter.
subtype E that is expected as the last A record
was not found.
The input file probably is damaged.
Continue processing.

Chapter 2. SQL Messages 331

 or the total index row size could not be
SQL3185W The previous error occurred while
represented in the federated server catalog. The
processing data from row
“<sqlcode>” in the message provides further
“<row-number>” of the input file.
information about the problem encountered.
Explanation: This message provides the
User Response: Read the next message in the
identification of the row where the error
message log (SQL3189) for the name of the index
occurred for the previous message listed in the
that was not created. Create the index with the
message file (for example, SQL3306).
CREATE INDEX command.
User Response: No action is required.
Federated system users: select from the data
source catalog and the federated server catalog to
SQL3186W Data was not loaded into the determine which index or indexes were not
database, because the log was full. created in the federated server catalog. Either:
SQLCODE “<sqlcode>” was v Create the indexes using the CREATE INDEX
returned. A commit will be command. Remember to truncate columns as
attempted and the operation will appropriate in order to not violate limits
continue if the commit is which caused the index to not be created in
successful. the first place.
Explanation: The utility could not insert a row v Do nothing and allow federated server to
of data into the database because the database function without knowledge about the index.
transaction log is full.
Both of the previously listed options have
The completed database transactions are potential performance implications.
committed and the insert is tried again. If the
repeated insert continues to indicate that the log
SQL3188N An error occurred while erasing
is full, the utility stops processing.
the contents of the table.
User Response: Be aware that a subsequent
Explanation: When running LOAD/IMPORT
failure of the utility causes the database to roll
with the REPLACE option, the specified database
back to the state after the last commit, not to the
table is truncated before inserting the data back
state before the utility was initially called.
into the table. An error occurred during the
truncation processing.
SQL3187W An error occurred while creating
The utility ends with an error.
an index. SQLCODE “<sqlcode>”
was returned. User Response: Resubmit the command.
Explanation: The IMPORT utility was creating
an index when an error occurred. An index may SQL3189N The previous message refers to
already exist for some table. index “<name>” with columns
“<column list>”.
This error occurs only during the import of a
PC/IXF file. Explanation: This message always follows
message SQL3187 when an error occurs while
The utility continues processing. The file was
creating an index. “<name>” is the name of the
imported, but the index was not created on the
index where the create failed. “<column list>” is
table.
a string of index column names. Each column
Federated system users: in addition to the name in the string is preceded by a plus (+) or a
previously listed cause, this error can occur when minus (−) sign indicating ascending or
a CREATE NICKNAME statement was issued at descending order.
federated server and the table at the data source
The utility continues processing.
had an index or indexes with too many columns,

332 Message Reference, Volume 2

User Response: Manually create the index with The formats must be enclosed in double-quotes.
the CREATE INDEX command.
Valid DATEFORMAT specifiers include “YYYY”
and the “M”, and “D” characters.
SQL3190N The indexixf option is not valid
Valid TIMEFORMAT specifiers include “AM”,
for this Import operation.
“PM”, “TT”, and the “H”, “M”, and “D”
Explanation: If INDEXIXF is used in the filetmod characters.
parameter of the IMPORT command, each of the
Valid TIMESTAMPFORMAT specifiers include all
following is also required:
of the specifiers for DATEFORMAT and
v The IMPORT must be replacing the contents of TIMEFORMAT, as well as “UUUUUU”.
a table. However, “M” cannot be next to both a date
v The METHOD parameter must be null. format specifier and a time format specifier.
v Each IXF column must be targeted to a A field separator is neccessary if the
database column with the same name. corresponding value in the data file can have a
The utility stops processing. No data is imported. variable length.

User Response: Resubmit the command either The utility stops processing.
without the INDEXIXF option or with the other User Response: Examine the format specifier.
parameters that are valid with the INDEXIXF Correct the format, and resubmit the command.
option.

SQL3193N The specified view or summary

SQL3191N The field in row table cannot be updated. You
“<row-number>”, column cannot LOAD/IMPORT into this
“<column-number>” which view or LOAD into this summary
begins with “<string>” does not table.
match the user specified
DATEFORMAT, TIMEFORMAT, Explanation: The LOAD/IMPORT utility can be
or TIMESTAMPFORMAT. The run against a view only if the view can be
row will be rejected. updated. The specified view is defined such that
data in it may not be changed. The LOAD utility
Explanation: The data does not match the user can be run against a summary table only if the
specified format. This may be caused by missing summary table is not replicated. The specified
fields, mismatched column separators, or a value table is a replicated summary table.
out of range.
The LOAD/IMPORT utility stops processing. No
User Response: Examine the input value. data is inserted.
Correct the input file or specify a
DATEFORMAT, TIMEFORMAT, or User Response: Resubmit the command with
TIMESTAMPFORMAT that matches the data and the name of a table or a view that can be
resubmit the command. updated.

SQL3192N In the filetmod a user specified SQL3194N The specified table is a system
format “<keyword>” beginning table. You cannot load a system
with the string “<string>” is not table.
valid. Explanation: The utility cannot be run against a
Explanation: The user specified format is not system table.
valid because it may be specified more than The utility stops processing. No data is loaded.
once, or it may contain an invalid character.

Chapter 2. SQL Messages 333

User Response: Resubmit the command with a
SQL3196N The input file was not found.
valid table name.
Explanation: The source file to be loaded into a
database could not be found in the path
SQL3195W The diskette “<number>” in drive
indicated by the datafile parameter.
“<drive>” cannot be used for the
output file. Insert a formatted The command cannot be processed.
diskette with writable free space.
User Response: Verify that the input file does
Explanation: The EXPORT utility cannot use the exist and that the path to it is correct.
current diskette for exporting to a PC/IXF file for
one of the following reasons:
SQL3197N An attempt was made to execute
v The output file cannot be opened on the multiple copies of import or
diskette. The diskette may be unformatted. export.
v Not enough free space is available on the
Explanation: An attempt was made to execute
diskette.
more than one instance of the import or export
This warning code is a request for the utility on a system where this is not supported.
application to prompt the user to place another
The command cannot be processed.
diskette in the specified drive.
User Response: Resubmit the second operation
The utility is waiting to be called again after the when no other processes are attempting to
user puts the diskette in the drive. execute the same utility.
User Response: Prompt the user for the diskette
and then return to the utility with the callerac
parameter indicating whether processing
continues or ends.

SQL3200 - SQL3299

SQL3201N The specified table cannot be SQL3203N The INSERT_UPDATE option is

replaced because another table is not permitted for the specified
dependent on it. target because it has no primary
key or all columns are in the
Explanation: A table that is a parent in a
primary key.
relationship with another table cannot be
replaced. Explanation: The INSERT_UPDATE option is
only valid when the target table has a primary
The command cannot be processed.
key and the target columns include all columns
User Response: Select a different option, such of the primary key. In addition, the target table
as INSERT, or select a different target for the should contain at least one column that is not
utility operation. part of the primary key.
The command cannot be processed.
User Response: Select a different option such as
INSERT, or choose a different target for the
utility operation.

334 Message Reference, Volume 2

 1. Tables specified in the traversal-order-list are
SQL3204N The INSERT_UPDATE option
not in PRE-ORDER fashion.
may not be applied to a view.
2. Tables specified in the traversal-order-list are
Explanation: The INSERT_UPDATE option is not connected.
not valid for views and a view has been selected
3. Mismatch of schema name found in
as the target of the utility operation.
traversal-order-list/subtable-list.
The command cannot be processed. 4. With REPLACE option, some subtables are
User Response: Select a different option such as missing in the traversal-order-list.
INSERT, or choose a different target for the 5. Subtable-list is not equal to or a subset of the
utility operation. traversal-order-list.
User Response: The user action, based on the
SQL3205N The specified view cannot be reason code, is:
replaced because the base table 1. Make sure the traversal-order-list is in
has a dependent. PRE-ORDER fashion.
Explanation: A view whose base table is a 2. Make sure all tables in the traversal-order-list
parent table in a referential relationship with any are connected.
table (including itself) cannot be replaced. 3. Make sure schema names are consistent.
The command cannot be processed. 4. When REPLACE option is used, make sure
all subtables in the hierarchy are included.
User Response: Select a different option such as
INSERT, or choose a different target for the 5. Make sure subtable-list is equal to or is a
utility operation. subset of the traversal-order-list.

SQL3206N The specified view cannot be SQL3208W Importing data from typed tables
replaced because its definition into regular table.
involves a subquery. Explanation: User specified to import data from
Explanation: A view whose definition involves typed tables into regular table. Please note,
a subquery cannot be replaced. If the view object_id column will not be cast while
definition depends on the definition of other importing.
views, the other views cannot contain User Response: Please make sure such
subqueries. The use of a subquery anywhere in operation is intentional.
the definition of any view on which the target
view is based prohibits the REPLACE option.
SQL3209N Import with CREATE option does
The command cannot be processed. not allow renaming subtable
User Response: Select a different option, such name nor attribute names.
as INSERT, or choose a different target for the Explanation: When CREATE option is used,
utility operation. neither subtable name nor attribute names can be
renamed.
SQL3207N Invalid table-list provided. User Response: Please check your IMPORT
Reason code ″<reason-code>″. command and make sure no subtable-list is
Explanation: The traversal-order-list/subtable- specified.
list provided is invalid. The explanation for the
reason code is:

Chapter 2. SQL Messages 335

SQL3210N Option ″<option>″ is not SQL3214N The LOAD utility does not
compatible with hierarchy in support deferred indexing for
″<command-name>″. tables with unique indexes.
Explanation: ″<option>″ is not compatible with Explanation: An indexing mode of DEFERRED
hierarchy in EXPORT, IMPORT, or LOAD. was specified for a table that has unique indexes.
This is not valid.
User Response: Please check the command
syntax for hierarchical support. User Response: Specify an indexing mode of
AUTOSELECT, REBUILD or INCREMENTAL,
and reissue the command.
SQL3211N LOAD does not support typed
tables.
SQL3215W The Load utility currently does
Explanation: LOAD does not support typed
not support INCREMENTAL
tables. Please consider IMPORT instead.
indexing when loading into a
User Response: Please use IMPORT to bring DMS table space on tables where
hierarchical data into the database. the table’s index object resides in
the same table space as any of the
other target table’s objects, and
SQL3212N The TERMINATE option of the the COPY option is also specified.
LOAD command is not currently The REBUILD indexing mode
supported for tables with will be used instead.
DATALINK column(s), or table
spaces in delete pending state. Explanation: INCREMENTAL indexing mode is
not supported for this operation. REBUILD
Explanation: An attempt was made to terminate indexing mode is used instead.
a crashed, interrupted, or forced LOAD
operation against a table which contains User Response: The user can avoid this
DATALINK column(s), or a table which resides warning by defining the index in a table space
in table space(s) in delete pending state. These that is not shared by other objects in the table to
are not currently supported. be loaded. Alternatively, avoid use of the COPY
option. Please refer to the DB2 documentation for
User Response: Use the RESTART option of the a full list of alternatives to the COPY option.
LOAD command to recover a crashed,
interrupted, or forced LOAD operation.
SQL3216W The table’s index object was not
consistent at the time the load
SQL3213I The indexing mode is “<mode>”. utility began. INCREMENTAL
Explanation: The indexing mode values are a indexing cannot be performed
follows: during this load utility operation.
The REBUILD indexing mode
REBUILD will be used instead.
indexes will be completely rebuilt
Explanation: INCREMENTAL indexing can only
INCREMENTAL be used on tables that have a consistent index
indexes will be extended object at the time the load utlity begins. Loading
DEFERRED with indexing mode REBUILD causes the table
indexes will not be updated, but will be index to be rebuilt in a consistent manner.
marked as requiring refresh prior to User Response: No action required.
next access.
User Response: No action is required.

336 Message Reference, Volume 2

SQL3217W The INCREMENTAL indexing SQL3220W Volume <volume-name> was not
mode is supported only when found in the <directory-name>
using LOAD to append data using directory. Copy the volume into
the INSERT INTO action. The this directory and continue the
current LOAD action is LOAD/IMPORT.
“<action>”. The utility will use
Explanation: An attempt to LOAD/IMPORT a
indexing mode of “<mode>”
multiple IXF file was made, but one of the files is
instead.
missing from the directory specified.
Explanation: INCREMENTAL indexing can only LOAD/IMPORT tries to find the parts in the
be used when appending data to a table using same directory as the first part.
the load INSERT action. This feature is not
The import will terminate.
supported with when loading with REPLACE,
RESTART, or TERMINATE actions. User Response:
User Response: No action necessary. v Find the part and put it in the same directory
as the first part. Then call LOAD/IMPORT
again with callerac of SQLU_CONTINUE. The
SQL3218C The LOAD utility cannot proceed LOAD/IMPORT will continue processing the
because it has encountered one or file.
more damaged index files. Restart
v Terminate the LOAD/IMPORT by calling
the database and resubmit the
LOAD/IMPORT with a callerac of
LOAD command.
SQLU_TERMINATE.
Explanation: The LOAD utility cannot proceed
because one or more index on disk data
SQL3221W ...Begin COMMIT WORK. Input
structures for the target table are in an
Record Count = <count>
inconsistent state.
Explanation: The import is about to attempt a
User Response: Terminate all applications and
COMMIT of the work performed.
issue the RESTART DATABASE command for the
affected database to rebuild the damaged index User Response: If the SQL3222W message is
or indexes. Then resubmit the LOAD command. not printed immediately after this message, then
the COMMIT failed and you will need to check
your table or view to see which records have
SQL3219N LOAD utility failed to disable
been imported. You can then start the import
constraint checking for the target
again with a RESTARTCOUNT set to the number
table.
of records successfully imported to skip those
Explanation: The LOAD utility encountered rows and import the rest of the file. (If you had
problems during its attempt to disable constraint been doing a CREATE or REPLACE_CREATE or
checking for the target table. REPLACE, call the second import with INSERT
option.)
User Response:
v Issue the SET INTEGRITY OFF command on
the target table prior to running the LOAD SQL3222W ...COMMIT of any database
utility. changes was successful.
v If attempting a LOAD in the REPLACE mode Explanation: The COMMIT was successful.
after a previously failed LOAD operation, use
User Response: None necessary if you get this
the LOAD TERMINATE command to put the
message.
tablespace into an accessible state prior to
issuing a LOAD REPLACE command.

Chapter 2. SQL Messages 337

 User Response: Refer to the original SQL
SQL3223N The parameter of type pointer to
message returned for appropriate action.
<parameter> is not specified
properly.
SQL3228N DEFERRED INDEXING is not
Explanation: The parameter of type
supported for tables with
<parameter> is not specified properly. The types
DATALINK columns.
are one of ″struct sqluimpt_in″, ″struct
sqluimpt_out″, ″struct sqluexpt_out″, ″struct Explanation: The “indexing mode” option for
sqluload_in″, ″struct sqluload_out″, ″struct the load utility was specified as “deferred”. This
sqluunld_in″, or ″struct sqluunld_out″. The option is not supported with tables having
pointer should be either a NULL pointer or DATALINK columns.
should point to the appropriate structure and its
sizeOfStruct field should be initialized to one of User Response: Reissue the load command
SQLUIMPT_IN_SIZE for struct sqluimpt_in, specifying a different indexing mode.
SQLUIMPT_OUT_SIZE for struct sqluimpt_out,
SQLUEXPT_OUT_SIZE for struct sqluexpt_out, SQL3250N COMPOUND=″<value>″ is an
SQLULOAD_IN_SIZE for struct sqluload_in, invalid value or is not allowed in
SQLULOAD_OUT_SIZE for struct sqluload_out, conjunction with other import
SQLUUNLD_IN_SIZE for struct sqluunld_in or parameters.
SQLUUNLD_OUT_SIZE for struct sqluunld_out.
Explanation: The COMPOUND=x option was
The command cannot be processed. specified for the import utility and cannot be
User Response: Call the utility again with a processed due to one of the following reasons:
proper parameter. v It is invalid when the INSERT_UPDATE
option is used.

SQL3225N The RESTARTCOUNT value is v The database being imported to is accessed

greater than the number of rows through a server or gateway of a previous
in the file. No rows were loaded. release.
v The value is not within the allowed range of 1
Explanation: The utility was called with a to 100. (On DOS or Windows, the maximum
RESTARTCOUNT value which was greater than value is 7).
the number of rows in the input file resulting in
no rows being loaded into the table/view. User Response: Change the filetmod option to
correct the usage of COMPOUND=x.
User Response: Ensure that the
RESTARTCOUNT value is correct or call the
utility again with the REPLACE or INSERT SQL3251N ″number″ more errors occurred
option and a correct RESTARTCOUNT value. during the import.
Explanation: The utility encountered more
SQL3227W Record token ″<token1>″ refers to errors than can be relayed in the sqlca
user record number ″<token2>″. (maximum number is 7) while using the
COMPOUND option. Messages for these errors
Explanation: An error or warning was will not be printed to the message file.
encountered during LOAD, IMPORT or EXPORT
of a table. CPU parallelism was greater than 1 at The utility continues processing.
the time the problem was encountered, and an
User Response: If you desire all the error
SQL message was written which identified the
messages for each row inserted during an
user record with a special unique token. This
import, do not use the COMPOUND option or
message serves to map the unique record token
use a COMPOUND value less than or equal to 7.
to the record number of the source user data.

338 Message Reference, Volume 2

SQL3260N An unexpected error occurred SQL3262N The TCP/IP service name
when accessing the LDAP ″<name>″ is not valid.
directory. Error code =
Explanation: The TCP/IP service name
″<error-code>″.
specified is not valid.
Explanation: An unexpected error occurred
User Response: Ensure that the TCP/IP service
when accessing the LDAP directory. The
name is configured and reserved in the local
command can not be processed.
etc/services file, then re-submit the command.
User Response: Record the message number Alternatively, specify the port number that is
(SQLCODE) and the error code. Use the assigned to the TCP/IP service name.
Independent Trace Facility to obtain the DB2
trace. Refer to the Independent Trace Facility in
SQL3263N The protocol type is not
the Troubleshooting Guide for information on
supported.
how to use this facility. Then contact your IBM
service representative. Explanation: The protocol type specified is not
supported for the command.
SQL3261N The REGISTER LDAP command User Response: Re-submit the command using
did not complete successfully a supported protocol type.
because a required input
parameter was not specified.
Reason code = ″<reason-code>″. SQL3264N The DB2 server has not been
registered in LDAP.
Explanation: The REGISTER LDAP command
did not complete successfully because a required Explanation: The command did not complete
input parameter was not specified as indicated successfully because the DB2 server had not been
by the following reason codes: registered in LDAP.

1 The Network Id parameter was not User Response: Register the DB2 server in
specified. LDAP using the REGISTER LDAP command.
Then re-submit the command.
2 The Partner LU parameter was not
specified.
SQL3265N An unexpected error occurred
3 The Transaction Program (TP) name during LDAP authentication.
parameter was not specified.
Explanation: Unable to authenticate the LDAP
4 The Mode parameter was not specified. user due to unexpected LDAP system error.
5 The Netbios NNAME parameter was User Response: Use the Independent Trace
not specified. Facility to obtain the DB2 trace. Refer to the
Independent Trace Facility in the Troubleshooting
6 The TCP/IP hostname parameter was
Guide for information on how to use this facility.
not specified.
Then contact your IBM service representative.
7 The TCP/IP service name parameter
was not specified.
SQL3266N The LDAP user password is
8 The IPX Address was not specified. incorrect.
9 The computer name was not specified. Explanation: The specified password is not a
correct password for the specified user
10 The instance name was not specified.
Distinguished Name (DN).
User Response: Re-submit the command with
the required input parameter

Chapter 2. SQL Messages 339

User Response: Re-submit the command using
SQL3270N The LDAP user’s Distinguished
the correct password.
Named (DN) is not valid.
Explanation: The LDAP user’s Distinguished
SQL3267N ″<authid>″ does not have
Named (DN) is not valid.
sufficient authority to perform the
requested command. User Response: Re-submit the command using
a valid LDAP user’s DN.
Explanation: The command did not complete
successfully because the LDAP user did not have
sufficient authority to perform the required task. SQL3271N The LDAP user’s Distinguished
Name (DN) and/or password is
User Response: Ensure that the LDAP user has
not defined for the current logon
the authorization to perform the operation.
user.
Explanation: When setting user preferences
SQL3268N The LDAP schema is not
such as CLI configuration or DB2 registry
compatible with the current
variable, the LDAP user’s DN and password
release of DB2.
must be defined for the current logon user.
Explanation: The LDAP schema defined at the
User Response: Refer to the IBM eNetwork
server does not contain the definition for the DB2
LDAP documentation on how to configure the
object classes and/or attributes used in the
LDAP user’s DN and password for the current
current release of DB2.
logon user.
User Response: Refer to the Administration
Guide on how to extend the LDAP schema with
SQL3272N The node ″<node-name>″ was not
DB2 object classes and attributes.
found in the LDAP directory.
Explanation: The command did not complete
SQL3269N The LDAP server is not available.
successfully because the node ″<node-name>″
Explanation: DB2 was not able to access was not found in the LDAP directory.
information in the LDAP directory because the
User Response: Ensure the node name is correct
LDAP server was not available.
and re-submit the command.
User Response: Perform the following actions:
1. Ensure that the LDAP server is active. SQL3273N The database ″<database-alias>″
2. Verify that TCP/IP is configured correctly on was not found in the LDAP
your machine directory.
3. Verify that the DB2LDAPHOST registry Explanation: The command did not complete
variable is set to the TCP/IP hostname and successfully because the database
port number of the LDAP server by running ″<database-alias>″ was not found in the LDAP
the ″db2set DB2LDAPHOST″ command. If directory.
the DB2LDAPHOST is not set, you can set it
by using the ″db2set DB2LDAPHOST=<host- User Response: Ensure the database name is
name>:<port-number>″ command, where correct and re-submit the command.
<host-name> is the TCP/IP hostname of the
LDAP server and <port-number> is the
TCP/IP port number of the LDAP server. The
default port number is 389.

340 Message Reference, Volume 2

SQL3274W The database was created SQL3277N The database ″<database-alias>″
successfully. However, the already exists in the LDAP
database was not cataloged in the directory.
LDAP directory. SQLCODE =
Explanation: The command did not complete
″<sqlcode>″.
successfully because another database of the
Explanation: The database was created same name already exists in the LDAP directory.
successfully. However, the database could not be
User Response: Re-submit the command using
cataloged in the LDAP directory because there
a different alias name.
was an error occurred during the operation.
User Response: Correct the error as indicated in
SQL3278N The node ″<node>″ already exists
the SQLCODE. Then catalog the database in the
in the LDAP directory.
LDAP directory using the CATALOG LDAP
DATABASE command. Explanation: The command did not complete
successfully because another node of the same
name already exists in the LDAP directory.
SQL3275W The database was dropped
successfully. However, the User Response: Re-submit the command using
database was not uncataloged in a different alias name.
the LDAP directory. SQLCODE =
″<sqlcode>″.
SQL3279N The command did not complete
Explanation: The database was dropped successfully because LDAP is
successfully. However, the database could not be disabled.
uncataloged in the LDAP directory because there
was an error occurred during the operation. Explanation: The command did not complete
successfully because the LDAP support is
User Response: Correct the error as indicated in disabled on the current machine.
the SQLCODE. Then uncatalog the database in
the LDAP directory using the UNCATALOG User Response: If the LDAP support is
LDAP DATABASE command. installed, enable the LDAP support by running
the command: ″db2set
DB2_ENABLE_LDAP=YES″.
SQL3276N Unable to obtain the LDAP
naming context. If the LDAP support is not installed, you need to
run the setup program and select to install the
Explanation: Unable to query for the LDAP LDAP support.
naming context for the LDAP server.
User Response: Contact your LDAP directory SQL3280N The attempt to connect to a
administrator to obtain the LDAP naming DRDA server failed.
context for the LDAP server that you are using.
If you are using IBM eNetwork Directory V2.1, Explanation: The attempt to connect to a DRDA
this is the name of the LDAP suffix. Then set the server failed because DB2 Connect is not
naming context for the current machine using the installed on this DB2 client and the
″db2set DB2LDAP_BASEDN=<naming-context>″ gateway-node was not specified when cataloging
command. this LDAP database.
User Response: Either install DB2 Connect on
this DB2 client or recatalog this LDAP database
with a valid gateway-node.

Chapter 2. SQL Messages 341

 However, the protocol information could not be
SQL3281N The OSTYPE parameter is not
updated in the LDAP directory because an error
valid.
occurred during the LDAP operation.
Explanation: The database server was not
User Response: Correct the error as indicated in
registered in LDAP because the OSTYPE
the SQLCODE. Then update the protocol
parameter specified was not valid. The OSTYPE
information in the LDAP directory using the
parameter describes the operating system type of
UPDATE LDAP NODE command.
the server.
User Response: Resubmit the command
SQL3284N The nodetype parameter is not
specifying an operating system type (OSTYPE)
valid.
that is supported by DB2.
Explanation: The database server was not
registered in LDAP because the nodetype
SQL3282N The supplied credentials are not
parameter specified was not valid.
valid.
User Response: Use a valid nodetype when
Explanation: Either or both the distinguished
registering the database server in LDAP. Valid
name (DN) of the user and the password that
values for the nodetype parameter are: SERVER,
were specified were not valid.
MPP, and DCS.
User Response: Resubmit the command using
valid values for both the distinguished name
(DN) of the user and the password.

SQL3283W The database manager

configuration was updated
successfully. However, the
protocol information was not
updated in the LDAP directory.
SQLCODE = “<sqlcode-value>”.
Explanation: The database manager
configuration was updated successfully.

SQL3300 - SQL3399

SQL3300N The records in the input file are SQL3301N A BOF record was found in the
not in the correct sequence. middle of the input file.
Explanation: The records in the worksheet Explanation: A beginning-of-file (BOF) record
format (WSF) file are expected to be in ascending must be the first record of a worksheet format
order (row 1, col 1 ... row 1, col 256; row 2, col 1 (WSF) file. It cannot occur at any other location
... row 2, col 256, and so on). Some damage has in the file. Some damage has occurred to the
occurred to the WSF file or it was generated WSF file or it was generated incorrectly, possibly
incorrectly, possibly with a level of the Lotus with a level of the Lotus product not supported
product not supported by the database manager. by the database manager.
The IMPORT utility stops processing. The IMPORT utility stops processing.
User Response: Regenerate the WSF file with a User Response: Regenerate the WSF file with a
supported level of the Lotus product. supported level of the Lotus product.

342 Message Reference, Volume 2

 User Response: Either erase the existing table
SQL3302N An EOF record was found before
or use a keyword other than CREATE and
any data was imported.
resubmit the command.
Explanation: The input file is valid, but it did
not contain any usable data to be imported. The
SQL3306N An SQL error “<sqlcode>”
first worksheet row is reserved for title
occurred while inserting a row
information. The second worksheet row is used
into the table.
for column labels. Data begins in the third row.
Explanation: An SQL error occurred while
The IMPORT utility stops processing.
inserting a row into the table.
User Response: Regenerate the worksheet
If the SQL error is not severe the row will be
format (WSF) file with valid data in the rows
rejected and the utility continues processing;
that the database manager uses for data.
otherwise the utility stops processing.
User Response: Examine other messages in the
SQL3303N The file type must be IXF when
message file for details about the actual error
using the CREATE or
and resubmit the command, if necessary.
REPLACE_CREATE keywords in
the Action String parameter.
SQL3307N The number of columns in the
Explanation: File types other than IXF are not
METHOD parameter does not
allowed with the CREATE or
match the number of entries in
REPLACE_CREATE keywords in the Action
the Action String parameter, or a
String (e.g. ″REPLACE into ...″) parameter.
column specified in the METHOD
The IMPORT utility stops processing. No data is parameter does not exist.
imported.
Explanation: The CREATE or
User Response: Change the file type to IXF, or REPLACE_CREATE option was specified on the
use INSERT, INSERT_UPDATE or REPLACE. IMPORT command. Either:
v If the NAMES or POSITIONS method
SQL3304N The table does not exist. indicator was specified in the METHOD
parameter, the number of columns explicitly
Explanation: The parameters specified on the specified in METHOD is not equal to the
command require that the table exists. number of columns explicitly specified in the
The utility stops processing. No data is loaded. Action String (e.g. ″REPLACE into ...″)
parameter.
User Response: Do one of the following: v If the DEFAULT method indicator was
v Resubmit the command with a table name of specified in the METHOD parameter, the
an existing table. number of columns in the PC/IXF file is less
v If the input file is a PC/IXF file, resubmit the than the number of columns specified in the
command with the CREATE option. Action String parameter.
v One column specified in the METHOD
parameter does not exist in the PC/IXF file.
SQL3305N The table cannot be created
because it already exists. The IMPORT utility stops processing. No table is
created.
Explanation: The CREATE keyword indicates
that a new table must be created but a table with User Response: Either correct the columns
the specified name already exists. specified in the METHOD and Action String
parameters or correct the columns specified in
The IMPORT utility stops processing. No data is
the METHOD parameter.
imported.

Chapter 2. SQL Messages 343

SQL3308N The code page values of the SQL3313N The disk is full. Processing was
PC/IXF column “<name>” are not ended.
compatible with the code page
Explanation: The disk or diskette is full. During
values for the application. The
the export to a PC/IXF file, either the PC/IXF
FORCEIN parameter was not
data file is on a fixed disk, or the PC/IXF data
specified.
file and the database are on the same drive, or
Explanation: The code page values for the the PC/IXF data file and the message file are on
column and the application are not compatible. the same drive.
When the FORCEIN parameter is not specified,
The EXPORT utility stops processing. The
the data cannot be loaded if the conversion from
exported data is not complete.
the IXF file code pate to the application code
page is not supported. User Response: Provide more space on the disk
or diskette or specify that the data file be located
The utility stops processing. No data is loaded.
on a different drive than the database or the
User Response: To load data with these code message file and resubmit the command.
pages, resubmit the command with the
FORCEIN option.
SQL3314N The date and time fields in an A
record do not match the date and
SQL3309N Column “<name>” in the PC/IXF time fields in the H record.
file is defined as a graphic
Explanation: During the load of a PC/IXF file,
column. The FORCEIN parameter
an A record was found in the PC/IXF file, that
was not specified.
contained run identification information (in the
Explanation: During the load of a PC/IXF file, a date and time fields) that differs from the run
graphic data column was encountered. Because identification information in the header (H)
the FORCEIN parameter was not used, the data record. This action does not apply to an A record
cannot be loaded. at the start of a continuation file.
The utility stops processing. No data is loaded. The input file has probably been damaged.
User Response: If you want to load the data The utility stops processing.
with the graphic data, resubmit the command
User Response: Re-create the damaged file, or
with the FORCEIN parameter.
repair the damaged file to recover as much data
as possible. Resubmit the command.
SQL3310N Column “<name>” in the PC/IXF
file is not valid.
SQL3315N The volume fields in an A record
Explanation: The CREATE or of subtype C are not valid.
REPLACE_CREATE option was specified on the
Explanation: During the load of a PC/IXF file
IMPORT command. A column with an invalid C
that was created by Database Services, an A
record was found while importing the PC/IXF
record was found in the PC/IXF file, that
file.
contained volume information (in the volume
The IMPORT utility stops processing. The table is fields) that is not valid.
not created.
The input file has probably been damaged.
User Response: Verify the column definition
The utility stops processing.
information in the input file.
User Response: Re-create the damaged file, or
repair the damaged file to recover as much data
as possible. Resubmit the command.

344 Message Reference, Volume 2

 (message number) in the message for more
SQL3316N An I/O error occurred while
information. Make changes and resubmit the
closing part of the input file.
command.
Explanation: During the load of a multiple part
PC/IXF file, an I/O error occurred while the
SQL3320N There is no delimiter or decimal
system was closing one of the files that make up
point character after a keyword in
the input PC/IXF file. This action does not apply
the filetmod parameter.
to the last file in the group of files that make up
the PC/IXF file. Explanation: A COLDEL, CHARDEL, or
DECPT keyword is located at the very end of the
The utility stops processing.
filetmod parameter. There is no delimiter or
User Response: Resubmit the command. decimal point character following the keyword.
This condition may arise while using delimited
ASCII (DEL) files.
SQL3317N The string pointed to by the
filetmod parameter contains The utility stops processing. No data is loaded or
conflicting information. exported.
Explanation: The filetmod string defines the User Response: Resubmit the command with a
generation and product family for the output correct filetmod parameter.
WSF file. More than one generation or product
family was defined in the string.
SQL3321C Data was not imported into the
The utility stops processing. The output file is database because the log was full.
not created. Recovery was not successful.
SQLCODE “<sqlcode>” was
User Response: Change the filetmod string to
returned.
define only one generation and product family.
Resubmit the command. Explanation: The IMPORT utility could not
insert a row of data into the database because
the database transaction log was full. All work
SQL3318N There are duplicate keywords in
was committed, but the utility could not insert
the filetmod parameter.
the row, because the database transaction log
Explanation: A COLDEL, CHARDEL, or remains full.
DECPT keyword appears more than once in the
The utility stops processing. All previous changes
filetmod parameter. This condition may arise
were committed, but the current row was not
while using delimited ASCII (DEL) files.
imported.
The utility stops processing. No data is loaded or
User Response: Check the amount of space
exported.
remaining on the filesystem containing your
User Response: Resubmit the command with a database files. Consider increasing the maximum
correct filetmod parameter. log size in the database configuration file.

SQL3319N An SQL error “<sqlcode>” SQL3322N An operating system semaphore

occurred while creating the table. error occurred.

Explanation: An SQL error occurred while Explanation: An error occurred in the wait/post
creating the table. semaphores.

The IMPORT utility stops processing. The table The utility stops processing. For the EXPORT
was not created. No data was imported. utility, data may be incomplete on the media. For

User Response: Look at the SQLCODE

Chapter 2. SQL Messages 345

the IMPORT utility, data not already committed insert into tablea()
is rolled back. no columns within the parenthesis
User Response: Stop and restart DB2 and insert into tablea(two words)
resubmit the utility. invalid column name
insert into tablea(grant.col1)
SQL3324N Column “<name>” has a type of column name should not be qualified
“<type>” which is not recognized.
insert into tablea(x1234567890123456789)
Explanation: A column of data returned by the column name too long
SQL statement is not supported.
insert into tablea(,col1,col2)
Federated system users: The data type of the missing column name
data that you want is not supported by either the
federated server or the data source that you want The command cannot continue.
to access.
User Response: Change the Action String
User Response: Correct the error and retry the parameter with a valid column list and call the
command. utility again.
Federated system users: Specify a supported data
type and resubmit the program. SQL3327N A system error occurred (reason
code1 = “ <reason-code-1>” and
reason code2 =
SQL3325W All the columns in row
“<reason-code-2>”).
″<row-number>″ have NULL
values; the row will not be Explanation: A system error occurred during
included in the WSF data file. processing.
Explanation: When you are doing an export of The utility stops processing.
a WSF file and the SELECT statement results in a
row of all NULL values, the row will not be User Response: Record all error information
added to the WSF file. The total number of rows from the SQLCA, if possible. Retain the message
specified in message SQL3105N is the number of file. Terminate all applications using the
rows resulting from the SELECT statement and database. Reboot the system. Restart the
not the number of rows in the WSF file. database. Try the command again.

The command continues processing. If sufficient memory resources exist and the
problem continues, invoke the Independent Trace
User Response: No action required. This is an Facility at the operating system command
informational message. prompt. Refer to the Independent Trace Facility
in the Troubleshooting Guide for information on
how to use this facility.
SQL3326N The column list following the
table name in the Action String
parameter is invalid. SQL3330W In row “<row-number>” a
character field has an odd length
Explanation: When you call IMPORT or LOAD
but its target database column is a
with an Action String (e.g. ″REPLACE into ...″)
graphic column. The row was not
parameter which contains a column list after the
loaded.
table name, this message will result if it is
invalid. For example, the following Action String Explanation: Only even length character fields
parameters will fail: can be loaded into graphic database columns.
The row is not loaded.

346 Message Reference, Volume 2

User Response: Either load the data to a new the correct file name, including a valid path.
table using the CREATE option in the IMPORT
command or do not load this column into this
SQL3334C There is not enough storage
table.
available.
Explanation: This message may accompany
SQL3331C The permission setting of a file
another error message. It indicates there is not
(or directory) does not allow the
enough storage available to open the file.
specified access.
The command cannot be processed.
Explanation: This may accompany another error
message. It indicates an attempt was made to get User Response: Stop the application. Possible
access to a file or directory in a way that is solutions include:
incompatible with the attributes of the file. One v Verify that your system has sufficient real and
of the following may be the source of the virtual memory.
difficulty:
v Remove background processes.
v Opening a file for writing on a read-only
device
v Opening a file for writing on a read-only file SQL3335C The file system is full.

v Opening a directory instead of a file Explanation: This message may accompany

v Encountering a locking or sharing violation. another error message. It indicates there is no
available space for writing on the device.
The command cannot be processed.
The command cannot be processed.
User Response: Retry the utility when the file is
not in use, or retry the utility directing the User Response: To make space available on the
output to a path and file that allows writing. device, delete unneeded files or direct the output
data to a device with space available.

SQL3332C The maximum number of open

files has been reached. SQL3337N An I/O error occurred while
writing data to the server.
Explanation: This message may accompany
another error message. It indicates that the Explanation: An I/O error has occurred while
maximum number of open files has been attempting to write data to a temporary file on
reached. the server (temporary files are created in the tmp
directory under the sqllib directory for the
The command cannot be processed. instance of the database manager). The file
system on the server may be full.
User Response: Terminate other applications to
reduce the number of files open and retry the The utility stops processing. The database is
utility. unchanged.
User Response: Contact the System
SQL3333C The file or directory does not Administrator for the server to make space
exist. available on the server, and resubmit the
command.
Explanation: This message may accompany
another error message. It indicates that a file or
directory to be accessed does not exist or cannot
be found.
The command cannot be processed.
User Response: Resubmit the command with

Chapter 2. SQL Messages 347

 The IMPORT operation is complete; however, the
SQL3338N An I/O error occurred reading a
message file on the database client system may
temporary message file on the
be empty or incomplete.
server.
User Response: Query the remote database to
Explanation: A system I/O error has occurred
determine if the utility operation was successful.
while attempting to read the temporary message
file on the server.

SQL3400 - SQL3499
was specified for the indicated column, but the
SQL3400N The method specified in
column is not nullable.
METHOD is not valid for
Non-Delimited ASCII files. It The command cannot be processed.
must be ’L’ for locations.
User Response: Resubmit the command with a
Explanation: When loading from a valid set of locations for the columns in the
non-delimited ASCII file, columns must be source file.
selected by locations in the file.
The command cannot be processed. SQL3403N The beginning-ending location
pair for inserting into column
User Response: Resubmit the command with a
“<name>” is not valid.
valid set of locations for the columns in the
source file. Explanation: The field specification for locating
the input data for the indicated database column
within the input non-delimited ASCII file is not
SQL3401N The method specified in
valid. The field specification has one of the
METHOD is not valid for any
following errors:
filetype.
v The beginning location is less than zero.
Explanation: The method for selecting columns
v The ending location is less than zero.
in the file is not a value allowed for any filetype.
Choose one of the following method indicators: v The ending location is less than the beginning
location.
v P for positions
v N for names The command cannot be processed.
v L for locations User Response: Resubmit the command with a
v D for default valid set of locations for the columns in the
source file.
Further restrictions are based on filetype.

The command cannot be processed. SQL3404N The beginning-ending location

pair for inserting into column
User Response: Resubmit the command with a “<name>” is not valid for a
valid method indicator. number.
Explanation: The field specification for locating
SQL3402N A beginning-ending location pair the data for the indicated database column
with both values zero was within the input non-delimited ASCII file is not
specified for non-nullable column valid. The location pair defines a field longer
“<name>”. than 50 bytes.
Explanation: A location pair with both the The command cannot be processed.
beginning and the ending location set to zero

348 Message Reference, Volume 2

User Response: Resubmit the command with a
SQL3408W The beginning-ending location
valid set of locations for the columns in the
pair for inserting into column
source file.
“<name>” defines a field larger
than the target column. Data may
SQL3405N The beginning-ending location be truncated.
pair for insertng into column
Explanation: The field specification for
“<name>” is not valid for a date.
obtaining data from the input non-delimited
Explanation: The field specification for locating ASCII file defines a field larger than the size (or
data for the indicated database column within maximum size) of the target database column.
the non-delimited ASCII file is not valid. The
The utility continues processing. Truncation
location pair defines a field length that is not
occurs when necessary.
valid for an external representation of a date.
User Response: No action is required.
The command cannot be processed.
User Response: Resubmit the command with a
SQL3409W The beginning-ending location
valid set of locations for the columns in the
pair for inserting into column
source file.
“<name>” defines a field shorter
than the target fixed-length
SQL3406N The beginning-ending location column. Data will be padded.
pair for inserting into column
Explanation: The indicated database column is
“<name>” is not valid for a time.
a fixed-length column. The field specification for
Explanation: The field specification for locating obtaining data from the input non-delimited
the data in the indicated database column within ASCII file defines a field smaller than the size of
the input non-delimited ASCII file is not valid. the target database column.
The location pair defines a field length that is not
The utility continues processing. Values input to
valid for an external representation of a time.
the indicated database column are padded with
The command cannot be processed. spaces as necessary, on the right.

User Response: Resubmit the command with a User Response: No action is required.
valid set of locations for the columns in the
source file.
SQL3410N The beginning-ending location
pair for inserting into column
SQL3407N The beginning-ending location “<name>” is not valid for a
pair for inserting into column graphic column.
“<name>” is not valid for a
Explanation: The field specification for locating
timestamp.
the input data in the ASCII file that is to be
Explanation: The field specification for locating inserted into the indicated database column
the data for the indicated database column defines a field with an odd number of bytes.
within the input non-delimited ASCII file is not
The command cannot be processed.
valid. The location pair defines a field length that
is not valid for an external representation of a User Response: Resubmit the command with a
timestamp. valid set of locations for the columns in the
source file.
The command cannot be processed.
User Response: Resubmit the command with a
valid set of locations for the columns in the file.

Chapter 2. SQL Messages 349

SQL3411W The field value in row SQL3413W The field value in row
“<row-number>” and column “<row-number>” and column
“<column-number>” is not valid “<column-number>” is too short
for a graphic column. A null was for the target column. A null was
inserted. inserted.
Explanation: The value in the field indicated is Explanation: The value in the specified field is
not an acceptable graphic column value. The not acceptable because it is too short for the
value may contain an odd number of bytes. For target column. The value of the column number
DEL files, the value of the column number specifies the byte location within the row where
specifies a field in the indicated row. For ASCII the field begins.
files, the value of the column number specifies
A null value is inserted.
the byte location within the row where the value
begins. User Response: No action is required. If a null
is not acceptable, correct the inner field and
The row is not inserted.
resubmit the command, or edit the data in the
User Response: If a null is not acceptable, table.
correct the input file and resubmit the command,
or edit the data in the table.
SQL3414N The temporary file ″<filename>″
could not be found.
SQL3412W The field value in row
Explanation: At the end of the load phase a
“<row-number>” and column
temporary file is created with information
“<column-number>” is not valid
necessary to restart the load. If the load is
for a graphic column but the
interrupted before this point, this file is not
target column is not nullable. The
created.
row was not inserted.
This message indicates that this file could not be
Explanation: The value in the field indicated is
found during load restart.
not an acceptable graphic column value. The
value may contain an odd number of bytes. A The utility stops.
null cannot be inserted because the target
column is not nullable. For DEL files, the value User Response: Depending on where the
of the column number specifies a field in the interrupt occurred, it may be possible to restart
indicated row. For ASCII files, the value of the the load at the build phase.
column number specifies the byte location within
the row where the value begins. SQL3415W Failed to convert the field value
The row is not inserted. in row ″<row-number>″ and
column ″<column-number>″ from
User Response: No action is required. If the the codepage of the input data file
row is necessary, correct the input file and to the codepage of the database. A
resubmit the command, or edit the data in the null value was loaded.
table.
Explanation: The value in the field indicated
cannot be converted from the codepage of the
input data file to the codepage of the database.
User Response: If a null value is not acceptable,
correct the input data file and resubmit the
command, or edit the data in the table.

350 Message Reference, Volume 2

 input data file to the codepage of the database.
SQL3416W Failed to convert the field value
in row ″<row-number>″ and User Response: No action is required. If the
column ″<column-number>″ from row is necessary, correct the input data file and
the codepage of the input data file resubmit the command, or edit the data in the
to the codepage of the database. table.
The row was not loaded.
Explanation: The value in the field indicated
cannot be converted from the codepage of the

SQL3500 - SQL3599
User Response: No action is required.
SQL3500W The utility is beginning the
″<phase>″ phase at time
″<timestamp>″. SQL3502N The utility has encountered
″<number>″ warnings which
Explanation: This is an informational message
exceeds the total number of
indicating that a phase is about to begin and that
warnings allowed.
the previous phase has ended. The phases are (in
order of appearance): Explanation: The number of warnings issued
v LOAD during the command has exceeded the total
number of warnings that the user specified at
v BUILD
invocation of the utility.
v DELETE
The utility terminates.
During the LOAD phase, data is loaded into
your table. If there are any indexes to be built, User Response: Ensure that the correct data is
BUILD phase will follow the LOAD phase. If being loaded with the appropriate options or
there were any duplicate keys found for a unique increase the number of warnings allowed.
index, the DELETE phase will follow the BUILD Resubmit the command.
phase.
SQL3503W The utility has loaded
If the LOAD is terminated before the end of the ″<number>″ rows which equals
LOAD, you need to know the phase at which the total count specified by the
you should restart the LOAD. user.
User Response: No action is required. Explanation: The number of rows loaded has
equaled the total number of rows that the user
SQL3501W The table space(s) in which the specified at invocation of the utility.
table resides will not be placed in The utility has successfully completed.
backup pending state since
forward recovery is disabled for User Response: No response required.
the database.
Explanation: COPY NO was specified on the SQL3504W A consistency point is being
invocation of LOAD which results in the table established.
space(s) in which the table resides being placed Explanation: Consistency points will be
into backup pending state unless forward established at times other than the regular
recovery is disabled for the database. interval specified in the SAVECOUNT parameter
The utility continues. at invocation when:

Chapter 2. SQL Messages 351

v the threshold for the amount of meta-data kept but one of the columns is not valid or the pointer
in memory or in temporary files has been passed in for the null indicators is not valid.
reached.
User Response: Correct the parameter and
v A device error occurred for the copy image resubmit the command.
and the load must terminate.
User Response: If the LOAD continues after SQL3508N Error in accessing a file or path of
this message, no action is required. If the LOAD type “<file-type>” during load or
terminates, it can be restarted after all errors are load query. Reason code:
corrected (such as activating a device or “<reason-code>”. Path:
decreasing the interval at which consistency “<path/file>”.
points are to be established).
Explanation: An error occurred while trying to
access a file during load or load query
SQL3505N The length specified in the processing. The utility stops processing.
filetmod for the RECLEN option
is not in the valid range of 1 to User Response: If doing a load and the table
32767. space is not in load pending state, correct the
problem and invoke the load utility again. If the
Explanation: In the filetmod parameter, the table space is in load pending state, then invoke
RECLEN option was specified for an ASC file. the load utility in RESTART or REPLACE mode,
The length specified is not valid. or restore a backup of the table space(s). The
User Response: Correct the length specified and state of the table space can be determined using
resubmit the command. the LIST TABLESPACES command.
The following is a list of reason codes:
SQL3506W The value specified in the null 1 Unable to open the file.
indicator in row “<row-number>”
and column “<column-number>” This could be caused by an incorrect file
is not valid. A value of ’N’ will be name or insufficient authority to access
assumed. the file/directory. Correct the problem
and either restart or rerun the load.
Explanation: For ASC files, a null indicator
column can be specified for each data column 2 Unable to read/scan the file.
and should contain either a ’Y’ or a ’N’. A ’Y’ This could be the result of a hardware
indicates that the column is a null value and a error. If the error is a hardware error,
’N’ indicates that the column contains data. If take the appropriate action as specified
neither of these values are in the null indicator in the Troubleshooting Guide for hardware
column, it is assumed to be a ’N’ and data will problems and restart or rerun the load.
be loaded into the column.
3 Unable to write to or change size of the
User Response: If the data or the null indicator file.
are incorrect, correct the input file and resubmit
the command. This could be the result of a disk full
condition or a hardware error. Refer to
the file type list below and either ensure
SQL3507N The column number specified for there is enough space to run the load or
a null indicator is not in the valid specify a different location to be used.
range of 0 to 32767 or the null Restart or rerun the load. If the error is
indicator parameter is not valid. a hardware error, take the appropriate
Explanation: In the null_ind parameter, columns
for null indicators were specified for an ASC file

352 Message Reference, Volume 2

 action as specified in the Troubleshooting
SQL3509W The utility has deleted
Guide for hardware problems and restart
″<number>″ rows from the table.
or rerun the load.
Explanation: When a table with a unique index
4 The file contains invalid data.
is loaded, rows causing violation of uniqueness
A file required by the load contains of an index will be deleted from the table during
incorrect data. See the action described the delete phase. This message provides
for TEMPFILES_PATH. information on how many rows have been
deleted.
5 Unable to close the file.
User Response: No action is required.
If the load cannot be restarted or rerun,
contact your IBM service representative.
SQL3510N The working directory for the sort
6 Unable to delete the file. phase cannot be accessed.
If the load cannot be restarted or rerun, Explanation: One or more of the specified
contact your IBM service representative. working directories for the sort phase either does
7 Parameter specified incorrectly. Refer to not exist or has no read/write permission.
the list of file types to determine the User Response: Ensure that the specified
parameter in error and rerun the load working directories exist and the read/write
with a valid parameter. permission is setup correctly and resubmit the
command.
The following is a list of file types:
SORTDIRECTORY SQL3511W The file named in row
Ensure that the workdirectory parameter “<row-number>” and column
is specified properly. There must be “<column-number>” cannot be
enough combined space in all the found. A null was loaded.
directories to hold twice the size of the
index keys for the loaded data. For load Explanation: The filename in the specified field
insert and load restart there must also cannot be found. There may be a data type
be room for twice the size of the index mismatch.
keys of the existing data in the table. For delimited ASCII (DEL) files, the value of the
MSGFILE column number specifies the field within the row
Ensure that the messagefile parameter is that contains the value in question. For ASCII
specified properly. There must be files, the value of the column number specifies
enough disk space to write out the the byte location within the row where the value
messages that occur during the load. in question begins.

If this is a load query, ensure that the A null value is loaded.

local message file parameter is NOT the User Response: Examine the input value. If
same as the messagefile parameter used necessary, correct the input file and resubmit the
for the load whose status is being command or edit the data in the table.
queried.
TEMPFILES_PATH
Ensure that the tempfiles path
parameter is specified properly. See the
Data Movement Utilities Guide and
Reference for more details on this
parameter.

Chapter 2. SQL Messages 353

 v 1 - An error occurred while Load was sorting.
SQL3512W The file named in row
“<row-number>” and column Try to restart the load. If the error persists,
“<column-number>” cannot be provide the function, reason code and error
found, but the target column is code to your technical service representative.
not nullable. The row was not v 2 - An error occurred using the vendor sort
loaded. utility.
Explanation: The filename in the specified field Try the load again using the DB2
cannot be found. A null cannot be loaded Client/Server sort utility instead of the vendor
because the output column in the table is not sort. To do this, reset the Profile Registry value
nullable. at the server to blank. You may have to restart
the Database Manager in order to pick up the
For delimited ASCII (DEL) files, the value of the new Profile Registry value. If the error
column number specifies the field within the row persists, provide the function, reason code and
that contains the value in question. For ASCII error code to your vendor sort technical
files, the value of the column number specifies service representative.
the byte location within the row where the value
in question begins.
SQL3515W The utility has finished the
The row is not loaded. ″<phase>″ phase at time
User Response: Correct the input file and ″<timestamp>″.
resubmit the command or edit the data in the Explanation: This is an informational message
table. indicating that a phase has finished. The phases
are (in order of appearance):
SQL3513N The codepage of the file does not v LOAD
match the codepage of the v BUILD
database. The file cannot be
v DELETE
loaded.
User Response: No action is required.
Explanation: DB2CS files cannot be loaded into
a database with a codepage that differs from the
original database. SQL3516N The utility could not restart the
load as specified.
User Response: Change the codepage of the
database and resubmit the command or use Explanation: The Load Utility detected
another filetype (such as PC/IXF) to move your discrepancies in the last consistency point
data from the original database to the new performed by Load before failure occurred. This
database. condition might be caused either by a system
error or an invalid log file.
SQL3514N A utility system error occurred. User Response: Restart the Load at the Build
Function code: “<function>”. phase, to bring the table to a consistent state and
Reason code: “<reason-code>”. create indexes (if applicable), or perform Load
Error code: “<error-code>”. with the REPLACE option.
Explanation: A system error occurred during
database utility processing. SQL3517N An unexpected record was read
from the input source.
User Response: Different actions are required
depending on the value of “<function>”. Explanation: The utility has encountered a
record that is in a format that is not valid. The
The possible function codes are:

354 Message Reference, Volume 2

source may have been corrupted when copied
SQL3520W Load Consistency Point was
from the original source.
successful.
Processing terminates.
Explanation: The Consistency Point performed
User Response: Copy the record from the by Load was successful.
original source in binary and restart the LOAD.
User Response: This is an informational
message only. No response is required.
SQL3518N The data in the source is not
compatible to the table to be
SQL3521N The input source file
loaded.
″<sequence-num>″ was not
Explanation: The source cannot be used to load provided.
this table because one of the following reasons:
Explanation: A load was invoked with multiple
v the table definition does not match the table input files but not all the files were provided. For
definition of the source. the DB2CS filetype, all the input source files that
v the source was created on a different platform were created originally must be provided. For
than the table that is being loaded. the IXF filetype, all the input source files must be
v the source was created from a table that had a provided in the correct order.
different codepage from the table that is being The utility terminates.
loaded.
User Response: Restart the utility providing all
User Response: Ensure that both the table and the input source files and setting the
source are correctly specified. If you want to load RESTARTCOUNT appropriately for the data that
data from a table with a different definition or was already loaded.
from a different platform or codepage, use
another filetype such as IXF or DEL.
SQL3522N A copy target cannot be provided
when both log retain and user
SQL3519W Begin Load Consistency Point. exits are disabled.
Input record count = ″<count>″.
Explanation: A copy target has been specified
Explanation: The Load Utility is about to on invocation of load for a database that has
attempt to perform a Consistency Point to both log retain and user exits disabled. Copy
commit the table data that has already been targets are not valid for such databases.
loaded.
The utility stops processing.
User Response: If message SQL3520W is not
printed immediately after this message, then the User Response: Verify that the database should
Consistency Point failed. The Load will have to have log retain and user exits disabled and
be restarted at the Build phase, to ensure that the invoke the load without specifying a copy target.
table is brought back to a consistent state and all
indexes (if any) created. It will then be possible SQL3523W There are no messages to be
to check which records have been loaded. Start retrieved from the message file.
the Load again with a RESTARTCOUNT set to Reason code: ″<rc>″.
the number of records successfully loaded to skip
those rows and load the rest of the file. Explanation: No messages are returned from a
query of the LOAD temporary message file. The
If this message is followed by messages possible return codes are:
SQL3520W, then this message is informational
only and no response is required. 1 No LOAD temporary message file
exists.

Chapter 2. SQL Messages 355

2 There are no messages in the LOAD
SQL3526N The modifier clause ″<clause>″ is
temporary message file.
inconsistent with the current load
User Response: Ensure that a valid table name options. Reason code:
has been specified. If the table name is specified ″<reason-code>″.
correctly and messages are expected, check the
Explanation: The load file type mode (modifier)
database monitor to verify that the utility is
indicated, is incompatible with your
active and it is not waiting for resources such as
load/import/export command. This is because of
locks. Note that the LOAD temporary message
one of the following reasons:
file will not be created until the LOAD utility is
in progress and it will be deleted after the 1. The current option requires you to specify the
completion of the LOAD utility. RECLEN and NOEOFCHAR file type
modifiers. One or more of these options are
missing from your command.
SQL3524N Option ″<option>″ has an invalid
2. The indicated option, such as DEL or ASC, is
value of ″<value>″.
inconsistent with the format of the input or
Explanation: The value provided must be an output data file.
integer value. Its range for each option is as 3. Generated or identity related file type
follows: modifiers have been specified but the target
1. TOTALFREESPACE: the value must be in the table contains no such columns.
range of 0 to 100, and is interpreted as a 4. It is not possible to load a table having a
percentage of the total pages in the table that non-identity generated column in a unique
are to be appended to the end of the table as index unless the column is specified in the
free space. INCLUDE clause of the CREATE INDEX
2. PAGEFREESPACE: the value must be in the statement or the GENERATEDOVERRIDE file
range of 0 to 100, and is interpreted as a type modifier is used.
percentage of each data page that is to be left 5. It is not possible to load a table having a
as free space. non-identity generated column in the
3. INDEXFREESPACE: the value must be in the partitioning key unless the
range of 0 to 99, and is interpreted as a GENERATEDOVERRIDE file type modifier is
percentage of each index page that is to be used.
left as free space when loading indexes.
User Response: Check the requirements of the
The utility stops processing. option you are using. Reissue the command
using modifier clauses (file type modes) and
User Response: Correct the value and resubmit utility options that are consistent.
the command.

SQL3527N The number specified in the

SQL3525W The ″<option-1>″ option is FILETMOD parameter for the
incompatible with the CODEPAGE option is not valid.
″<option-2>″ option.
Explanation: In the FILETMOD parameter, the
Explanation: Incompatible options have been CODEPAGE option was invalid.
provided to the utility.
User Response: Correct the codepage number
User Response: Remove or modify one of the and resubmit the command.
options and resubmit the command. See the
Command Reference for more information on
valid options.

356 Message Reference, Volume 2

 User Response: No action is necessary.
SQL3528W The delimiter (column delimiter,
string delimiter, or decimal point)
specified in the CLP command SQL3533I The Load utility is currently
may get translated from the building index “<number>” of
application codepage to the “<number>”.
database codepage.
Explanation: This is an informational message
Explanation: When a CLP command is sent returned if the Load currently being queried is in
from the client to the server, it may get the BUILD phase.
translated from the codepage of client to the
codepage of server, if they are different. User Response: No action is necessary.

User Response: To ensure that delimiters are

not converted, they should be specified in hex SQL3534I The Load DELETE phase is
format. approximately “<number>”
percent complete.

SQL3529N The “<operation-name>” Explanation: This is an informational message

operation encountered the returned if the Load currently being queried is in
unsupported data type the DELETE phase.
“<data-type>” in column User Response: No action is necessary.
“<column-number>”.
Explanation: The “<operation-name>” operation SQL3535W The LOAD command parameter
does not support data type “<data-type>” found “<parameter-name>” is no longer
in column “<column-number>”. supported; its value will be
User Response: Please check your table ignored by the LOAD utility.
definition and the Data Movement Guide for Explanation: Your LOAD command contains a
supported data types. parameter that is no longer supported.
User Response: Please refer to the DB2
SQL3530I The Load Query utility is documentation for information on temporary sort
monitoring Load progress on node space for LOAD and suggestions related to
“<node>”. LOAD performance tuning.
Explanation: The Load Query utility was
invoked in an MPP environment. SQL3536N System temporary table space
User Response: No action is necessary. “<table-space-name>” is full.
Explanation: The LOAD utility has
SQL3531I A LOAD RESTART has occurred. encounetered a table space full condition while
sorting index keys.
Explanation: The RESTART option was given
for the Load currently being queried. User Response: Ensure that there is enough
space allocated to the system temporary table
User Response: No action is necessary. space “<table-space-name>”, at least two times
the total size of the indexes being built. Restart
the LOAD utility.
SQL3532I The Load utility is currently in
the “<phase>” phase.
Explanation: This is an informational message
indicating the phase of the Load currently being
queried.

Chapter 2. SQL Messages 357

 column is of type GENERATED ALWAYS, the
SQL3537N Sort memory could not be
value cannot be loaded. The column number
allocated during the execution of
specifies the field within the row of the missing
the LOAD utility.
data.
Explanation: Insufficient process virtual
User Response: For LOAD, an explicit, non
memory is available to the LOAD utility for sort
NULL field value can be loaded into a
processing.
GENERATED ALWAYS identity column only if
User Response: Terminate the application on the identityoverride file type modifier is used.
receipt of this message. Ensure there is enough For non-identity GENERATED ALWAYS
virtual memory available for sort processing. columns, the generatedoverride file type modifier
can be used to load explicit, non NULL values
Possible solutions include:
into a row. If using these modifiers is not
v Disconnect all applications from the database appropriate, the field value must be replaced
and decrease the size of the sort heap with a NULL if LOAD is to accept the row.
parameter (sortheap) in the corresponding
database configuration file. For IMPORT there is no way to override a
GENERATED ALWAYS column. The field value
v Remove background processes and/or
must be removed and replaced with a NULL if
terminate other currently executing
the utility is to accept the row.
applications.
v Increase the amount of virtual memory
available. SQL3551W The table contains at least one
GENERATED ALWAYS column
that the utility will override.
SQL3538N The LOAD QUERY utility failed
because multiple LOADs are Explanation: An “override” file type modifier
using the same temporary files (for example, IDENTITYOVERRIDE or
path. GENERATEDOVERRIDE) has been specified.

Explanation: At least one other LOAD was For IDENTITYOVERRIDE, this may violate the
invoked using the same TEMPFILES PATH as uniqueness property of an identity column
the queried LOAD and is still in progress. The defined as GENERATED ALWAYS.
LOAD QUERY utility cannot uniquely determine For GENERATEDOVERRIDE, this may result in
which LOAD to query. a non-identity GENERATED ALWAYS column
User Response: Use the TABLE parameter of containing a value that does not correspond to
LOAD QUERY instead. its column definition.
User Response: No action is required.
SQL3539N LOAD RESTART cannot proceed
because LOAD TERMINATE has
been attempted at least once.
Explanation: LOAD TERMINATE can only be
followed by LOAD TERMINATE.
User Response: User can proceed with LOAD
TERMINATE only.

SQL3550W The field value in row

“<row-number>” and column
“<column-number>” is not NULL,
but the target column has been
defined as GENERATED
358 MessageALWAYS.
Reference, Volume 2
Explanation: A non NULL field value was
SQL3600 - SQL3699

SQL3600N The IMMEDIATE CHECKED SQL3602W Check data processing found

option of the SET INTEGRITY constraint violations and moved
statement is not valid since the them to exception tables.
table “<table-name>” is not in the
Explanation: There are rows that violate
check pending state.
constraints that were specified to be checked by
Explanation: The data is checked for constraint the SET INTEGRITY statement execution. These
violations only if the table is placed in the check were moved to exceptions tables.
pending state.
User Response: Check the exception tables for
User Response: Use the SET INTEGRITY rows that violate constraints. The rows have been
statement with the OFF option to place a table in deleted from the original table but can be
the check pending state. corrected and transferred back from the
exception tables.
sqlcode: -3600
sqlcode: +3602
sqlstate: 51027
sqlstate: 01603
SQL3601W The statement caused one or more
tables to automatically be placed SQL3603N Check data processing through
in check pending state. the SET INTEGRITY statement
has found integrity violation
Explanation: There are two situations where
involving a constraint with name
this occurs.
“<name>”.
1. Setting a parent table in a referential structure
requires dependent and descendent tables to Explanation: A row has been found to violate a
be set in check pending. This is necessary to constraint defined on a table specified to be
enforce referential integrity constraints. checked by the SET INTEGRITY statement. The
Adding a foreign key when the parent table name “<name>” is either a constraint name or
is in a check pending state requires all new the name of a generated column.
dependents and descendents of the parent User Response: The row has not been deleted
table to be placed automatically in check from the table since the FOR EXCEPTION option
pending. was not used.
2. Setting a base table that has dependent
It is advisable to execute the SET INTEGRITY
refresh immediate summary tables requires
statement using the FOR EXCEPTION option
these dependent summary tables to be set in
when checking the data. The data may be
check pending. This is necessary to enforce
corrected with the information from the
the data relationship between the base table
exception table(s).
and the dependent summary table.
sqlcode: -3603
User Response: This is a warning message. The
user must execute the SET INTEGRITY statement sqlstate: 23514
with the IMMEDIATE CHECKED option in order
to validate the integrity on all the dependent and
descendent tables.
sqlcode: +3601
sqlstate: 01586

Chapter 2. SQL Messages 359

 sqlcode: -3605
SQL3604N Exception table
“<excp-table-name>” sqlstate: 428A6
corresponding to table
“<table-name>” in the SET
INTEGRITY statement or LOAD SQL3606N There is a mismatch in the
utility does not have the proper number of tables being checked
structure, has been defined with and in the number of exception
unique indexes, constraints, tables specified in the SET
generated columns, or triggers, or INTEGRITY statement.
is in the check pending state Explanation: There must be a one-to-one
itself. correspondence between the original tables and
Explanation: The exception table corresponding the exception tables provided in the list.
to a table must have its definition similar to that User Response: Create the missing exception
of the original table. Optional columns for the table if not already done and specify it in the list
utility are as specified in the relevant section of in order to execute the command again.
the documentation describing the exception
tables. There may not be any generated columns sqlcode: -3606
in the exception table. There must not be any sqlstate: 428A7
constraints or triggers defined on the exception
table. The exception table itself should not be in
the check pending state. SQL3608N Cannot check or reset the Check
Pending state on dependent table
User Response: Create the exception table as “<dep-table-name>” using the
indicated in the relevant section of the SET INTEGRITY statement while
documentation and re-run the statement or the parent table
utility. “<par-table-name>” is in the
sqlcode: -3604 check pending state.

sqlstate: 428A5 Explanation: The parent table must be clean

(not in the check pending state) or be included in
the invocation list in order to
SQL3605N Table “<table-name>” named in
v reset the check pending state of a dependent
the SET INTEGRITY statement is
table
either not listed to be checked or
is an exception table specified v check a dependent table.
more than once. User Response: Ensure that the parent table is
Explanation: When the FOR EXCEPTION not in check pending by executing the SET
clause is specified in the SET INTEGRITY INTEGRITY statement to check the parent table.
statement, this error could be caused by one of It is recommended to check the parent table first.
the following : It is also possible to check the dependent table
v The table is missing from the list of tables to and include the parent table in the invocation
be checked list. In this case, the command could still fail if
v The table to be checked is the same as an there are constraint violations in the parent table
exception table and they are not deleted. This can happen if the
FOR EXCEPTION option is not used.
v The exception table is specified for more than
one table to be checked In the case of a referential cycle, all tables must
be included in the invocation list.
User Response: Correct the table names and
execute the command again. sqlcode: -3608

360 Message Reference, Volume 2

sqlstate: 428A8

SQL3700 - SQL3799
the targets for the unload. Unload will continue
SQL3700W Device ″<device>″ is full. There
but will ignore this device.
are ″<active-devices>″ other active
devices. Please mount new media User Response: The media loaded on the
or take appropriate action. specified device will not contain any unloaded
data and should not be included with the media
Explanation: The media on the specified device
supplied to the LOAD utility when the unloaded
is full. This device is one of the
data is being loaded. In order to fix the problem
″<active-devices>″ + 1 target devices to which
with the device, look up the returned SQLCODE
unloaded data is being directed.
in the Message Reference.
User Response: Take ONE of the following
actions:
SQL3703W ″<xxx>″ of ″<yyy>″ number of
v Mount a new target media on the specified type ″<type>″ pages have been
device and continue unloading by invoking unloaded and sent to be written
unload with caller action 1 out to the target media.
(SQLU_CONTINUE).
Explanation: The table being unloaded consists
OR
of ″<yyy>″ pages of the specified type of data.
v If ″<active-devices>″ is not zero, continue the ″<xxx>″ of these have been processed by the
unload without this device by invoking the UNLOAD utility and have been sent to a media
UNLOAD utility with the caller action 4 writer which will write the data to the target
(SQLU_DEVICE_TERMINATE). media.
OR
″<type>″ is one of:
v Cancel the unload by invoking the UNLOAD
v 0 for regular data
utility with caller action 2
(SQLU_TERMINATE). v 2 for Long data and allocation information
v 3 for LOB data
SQL3701W The lobpaths parameter was v 4 for LOB allocation information
specified, but the table does not Note that for Long and LOB data, ″<xxx>″ may
contain any LOB or Long data. be less than ″<yyy>″ when unload is complete,
This parameter will be ignored. because unused space is not unloaded, but will
Explanation: The lobpaths parameter specifies a be recreated when the data is reloaded.
separate target for LOB and Long data. The table
does not contain any LOB or Long data, so the Even for regular data, a final message where
targets specified by the lobpaths parameter will ″<xxx>″ = ″<yyy>″ may not be issued. Instead
not be used. message 3105 is used to indicate that the unload
completed successfully.
User Response: No action required.
User Response: This is an informational
message. No action is required.
SQL3702W Warning. SQLCODE ″<sqlcode>″
was received for device
″<device>″. Unload will attempt SQL3704N The num_buffers parameter
to continue without this device. specified is invalid.
Explanation: SQLCODE ″<sqlcode>″ was Explanation: The num_buffers parameter
detected for the specified device which is one of determines the number of buffers that the utility

Chapter 2. SQL Messages 361

will use. The minimum is 2 if the lobpaths
SQL3706N A disk full error was encountered
parameter is not specified and 3 if the lobpaths
on “<path/file>”.
parameter is specified. This is the minimum
required to allow the utility to work. There is, Explanation: A disk full error was encountered
however, an optimal number of buffers that the during the processing of a database utility. The
utility will use if this parameter is not specified. utility stops.
This optimal number is based on the number of
User Response: Ensure enough disk space is
internal processes that the utility will have
available for the utility or direct the output to
running and whether or not the lobpaths
other media such as tape.
parameter was specified. If the number of buffers
specified is less than the optimal number, some
processes will be waiting for buffers to use. SQL3707N The sort memory size parameter
Therefore, it is recommended to specify 0 for this specified ″<size1>″ is not valid.
parameter and let the utility choose the number The minimum size required is
of buffers. Only specify this parameter if, due to ″<size2>″.
the size of the utility storage heap, it is necessary
to limit the amount of memory that the utility Explanation: The sort memory size is not large
uses. enough for sorting the keys of the index(es).

User Response: Resubmit the command using a User Response: Reissue the command with a
valid num_buffers parameter. valid sort memory size.
To ensure that only the minimum amount of
SQL3705N The buffer size parameter storage is used, specify a value of 0 (to let it
specified is not valid. The buffer default). However, using more than the
size must be specified as 0 or be minimum should improve the performance of
between 8 and 16384 inclusive. the sort.
For multiple buffers, the total
buffer size must not exceed 16384. SQL3783N An error was encountered while
Explanation: The application calling the utility opening the copy location file.
has supplied a buffer size parameter that is not Open file error code is
valid. The buffer size is used to determine the “<errcode>”.
internal buffer size. The value is the number of Explanation: During load recovery, an error was
4K pages that are obtained for this buffer. The encountered while opening the copy location file.
value must be specified as 0 or be between 8 and The operating system file open return code is
16384 inclusive. If there are multiple buffers, the returned.
number of buffers multiplied by the buffer size
must not exceed 16834. User Response: Look at the error code in the
message for more information. Correct the error,
When 0 is specified: if possible, and resubmit the command.
v for a table whose regular data is in a database
managed storage table space, the default
SQL3784W Invalid data was encountered
buffer size chosen is the extent size for the
while reading from the copy
table space or 8, whichever is larger.
location file. Failure occurred at
v for a table whose regular data is in a system line “<line-no>” with error type
managed storage table space, the default “<errtype>”
buffer size chosen is 8.
Explanation: During load recovery, invalid data
User Response: Reissue the command with a was encountered while reading from the copy
valid buffer size. location file. The line number and error type are

362 Message Reference, Volume 2

returned. The utility waits for a response to the current state of load recovery.
continue.
User Response: Correct the value in error and
User Response: Correct the data in the copy return to the utility with the correct caller action
location file and return to the utility with the parameter to indicate if processing should
correct caller action parameter to indicate if continue or terminate.
processing should continue or terminate.
SQL3799W Load recovery for table
SQL3785N Load recovery for table “<schema.tablename>” at time
“<schema.tablename>” at time “<timestamp>” on node
“<timestamp>” on node “<node-number>” is pending due
“<node-number>” failed due to to warning “<sqlcode>” with
error “<sqlcode>” with additional additional information
information “<additional-info>”. “<additional-info>”.
Explanation: A severe error occurred during Explanation: A warning condition is
load recovery. The utility stops processing. encountered during load recovery. The utility
waits for a response to continue.
(Note : if you are using a partitioned database
server, the node number indicates which node (Note : if you are using a partitioned database
the error occurred on. Otherwise, it is not server, the node number indicates which node
pertinent and should be ignored.) the error occurred on. Otherwise, it is not
pertinent and should be ignored.)
User Response: Examine the error code in the
message for more information. Take corrective User Response: Examine the error code in the
action and resubmit the command. message for more information. Take corrective
action and return to the utility with the correct
caller action parameter to indicate if processing
SQL3798W An invalid value was used for
should continue or terminate.
parameter “<parameter>” to
invoke the roll-forward recovery
API to continue load recovery.
Explanation: Load recovery is in progress and
one of the parameters passed in is not valid for

SQL3800 - SQL3899
User Response: Check in the Administration
SQL3802N An invalid quiesce mode
Guide to determine the appropriate way to
“<quiesce-mode>” was
revalidate the index and resubmit the command
encountered.
after the condition is corrected.
Explanation: An invalid quiesce mode was
passed to the quiesce API.
SQL3805N The state of the application or of
User Response: Resubmit the command with one or more table spaces for the
the correct parameters. table specified prohibits the
loadapi action or quiescemode
“<action>”. Reason code =
SQL3804N The index is invalid.
“<reason-code>”.
Explanation: An invalid index was encountered
Explanation: The loadapi action (either
during the processing of a utility command.
quiescemode or callerac) passed to the load API
is in conflict with either the state of the

Chapter 2. SQL Messages 363

application or the state of one or more table 02 Resubmit the command with the correct
spaces for the table. load action or complete the current
logical unit of work by issuing either a
The possible reason codes are as follows:
COMMIT or ROLLBACK.
01 the state of one of the table spaces for
03 Resubmit the command with the correct
the table specified prohibits the loadapi
load action.
action or quiescemode.
04 Determine which table spaces for the
02 the application is not at the start of its
table have reached the maximum
logical unit of work. This condition
number of quiescers. QUIESCE RESET
prohibits the load action specified.
these table spaces.
03 the state of the application prohibits the
05 Resubmit the command with a table
load action specified.
which is not in the system catalog table
04 one or more of the table spaces for the space.
table is already quiesced by the
06 Resubmit the command omitting the
maximum number of quiescers.
copy parameter
05 system catalog table space cannot be
07 Determine at which phase the load
quiesced.
should be restarted and resubmit the
06 load copy not allowed when table space command with the correct phase.
is in backup pending state.
07 Attempt to restart a load at an incorrect SQL3806N Not all table constraints are off
phase for the table to be loaded.

User Response: Corresponding to each of the Explanation: One or more constraints for the
above reasons: table to be loaded are still on when the load API
is invoked.
01 Resubmit the command with the correct
loadapi action or quiescemode, or User Response: Resubmit the command after all
correct the state of the table spaces for table constraints are turned off.
the table.

SQL3900 - SQL3999
v SQLCA contents if possible
SQL3901N A non-severe system error
occured. Reason code v Trace file if possible.
“<reason-code>”.
Explanation: Processing ended because of a SQL3902C A system error occurred. Further
non-severe system error. processing is not possible. Reason
code = “<reason-code>”.
User Response: If trace was active, invoke the
Independent Trace Facility at the operating Explanation: A system error occurred.
system command prompt. Refer to the User Response: If trace was active, invoke the
Independent Trace Facility in the Troubleshooting Independent Trace Facility at the operating
Guide for information on how to use this facility. system command prompt. Refer to the
Then contact your technical service Independent Trace Facility in the Troubleshooting
representative with the following information: Guide for information on how to use this facility.
v Problem description Then contact your technical service
v SQLCODE and embedded reason code representative with the following information:

364 Message Reference, Volume 2

v Problem description
SQL3916I A STOP request was received.
v SQLCODE and embedded reason code Synchronization session stopped
v SQLCA contents if possible successfully.
v Trace file if possible. Explanation:
User Response:
SQL3910I Synchronization session
completed successfully.
SQL3917I A STOP request was received
Explanation: before the results were uploaded
User Response: to the satellite control server. The
results will be uploaded during
the next synchronization session.
SQL3911I Test synchronization session
completed successfully. Explanation:

Explanation: User Response:

User Response:
SQL3918I Synchronization progress
information was obtained
SQL3912I STOP completed successfully. successfully.
Explanation: Explanation:
User Response: User Response:

SQL3913I STOP issued, but no SQL3919I A STOP request was received

synchronization session is before the satellite could contact
currently active. the satellite control server.
Synchronization stopped
Explanation:
successfully.
User Response:
Explanation:
User Response:
SQL3914I A user interrupt was issued. The
synchronization session stopped
successfully. SQL3920I The application version on this
satellite does not match one that
Explanation:
is available for the group of this
User Response: satellite. Synchronization cannot
occur.
SQL3915I A user interrupt was issued Explanation: The application version reported
before the results were uploaded by the satellite does not exist at the satellite
to the satellite control server. The control server.
results will be uploaded during
User Response: Contact the help desk or your
the next synchronization session.
system administrator.
Explanation:
User Response:

Chapter 2. SQL Messages 365

SQL3921I This satellite is disabled at the SQL3933W The test synchronization session
satellite control server. completed successfully. The
Synchronization cannot occur. release level of the satellite,
however, is not supported by the
Explanation: When disabled, the satellite cannot
release level of the satellite
synchronize.
control server.
User Response: Contact the help desk or your
Explanation: The release level of the satellite
system administrator.
must be within the range of one level above to
two levels below that of the satellite control
SQL3930W There are no synchronization server.
scripts to execute.
User Response: Contact the help desk or your
Explanation: No synchronization scripts were system administrator.
downloaded to the satellite for execution.
User Response: Contact the help desk or your SQL3934W The test synchronization session
system administrator to ensure that completed successfully. This
synchronization scripts are available on the satellite, however, is disabled at
satellite control database for this satellite. the satellite control server.
Explanation: The satellite has been placed in the
SQL3931W The test synchronization session disabled state at the satellite control server.
completed successfully. The
User Response: Contact the help desk or your
satellite ID, however, could not be
system administrator.
found in the satellite control
database.
SQL3935W The test synchronization session
Explanation: Either the satellite ID is not
completed successfully. This
defined correctly on the satellite or this satellite
satellite, however, is in the failed
has not been defined in the satellite control
state at the satellite control server.
database.
Explanation: The satellite is in the failed state at
User Response: If you use the
the control server.
DB2SATELLITEID registry variable, ensure that it
is set to the unique ID for the satellite. If you are User Response: Contact the help desk or your
using the operating system logon ID as the system administrator.
satellite ID, ensure you log on using it.
SQL3936W No progress information is
SQL3932W The test synchronization session available.
completed successfully. The
Explanation: The synchronization session has
satellite’s application version,
not reached a stage where the progress
however, is not set locally, or does
information has been logged, or there is no
not exist for this satellite’s group
active synchronization session for this satellite.
at the satellite control server.
User Response: Ensure the synchronication
Explanation: The application version on the
session is active, or try querying for progress
satellite is different from any that are available
information later.
for this satellite’s group.
User Response: Ensure that the application
version on the satellite is set to the correct value.

366 Message Reference, Volume 2

SQL3937W The application version for this SQL3944I Synchronization session identifier
satellite does not match one that was reset successfully for the
is available for this satellite’s satellite.
group.
Explanation: The session identifier was reset
Explanation: A satellite can only synchronize successfully for the satellite.
with a particular application version for its
User Response: No action is required.
group. The application version for this satellite is
not available for the satellite’s group at the
control server. SQL3945I Synchronization session identifier
for the satellite was retrieved
User Response: Ensure that the application
successfully.
version on the satellite is set to the correct value.
Explanation: The session identifier for this
satellite was found and returned successfully.
SQL3938W An interrupt was issued during
script execution. The User Response: No action is required.
synchronization session was
stopped, but the satellite may be
in an inconsistent state. SQL3946N Synchronization session identifier
operation failed.
Explanation: An interrupt was issued while the
script execution phase of the synchronization Explanation: The synchronization session
process was being performed. The identifer operation has failed for an unknown
synchronization session was stopped but the reason.
satellite may be in an inconsistent state because a User Response: Ensure that the product is
script may have been halted at an inappropriate installed correctly. If the failure persists, contact
place. DB2 service.
User Response: Contact the help desk or your
system administrator. SQL3950N A synchronization session is
active. Only one synchronization
SQL3942I Synchronization session identifier session can be active.
was set successfully for the Explanation: Only one synchronization session
satellite. can be active at a time.
Explanation: The session identifier was set User Response: Wait until the current
successfully for the satellite. synchronization session completes successfully
User Response: No action is required. before initiating another session.

SQL3943N Synchronization session identifier SQL3951N The satellite ID cannot be found

exceeds the maximum length of locally.
“<length>” characters. Explanation: Either the operating system logon
Explanation: The specifed synchronization was bypassed or the DB2SATELLITEID registry
session identifier is longer than the allowed variable was not set.
length of “<length>” characters. User Response: If you are using the operating
User Response: Ensure that the identifier is no system logon ID as the satellite ID, log on to the
more than nnn characters. operating system. If you use the
DB2SATELLITEID registry variable, ensure that it
is set to the unique ID for the satellite.

Chapter 2. SQL Messages 367

 User Response: Ensure that the application
SQL3952N The satellite ID could not be
version is set to the correct value.
found at the satellite control
server.
SQL3957N Cannot connect to the satellite
Explanation: Either the satellite ID is not
control server because of a
defined correctly on this satellite or this satellite
communication failure:
has not been defined at the satellite control
SQLCODE=“<sqlcode>”
server.
SQLSTATE=“<sqlstate>”,
User Response: If you use the tokens=“<token1>”, “<token2>”,
DB2SATELLITEID registry variable, ensure that it “<token3>”.
is set to the unique ID for the satellite. If you are
Explanation: An error has been detected by the
using the operating system logon ID as the
communication subsystem. Refer to “<sqlcode>”
satellite ID, ensure you log on using it.
for more details.
Otherwise, contact the help desk or your system
administrator. User Response: Contact the help desk or your
system administrator.
SQL3953N This satellite has been disabled at
the satellite control server. SQL3958N Error occurred during
synchronization session:
Explanation: The satellite ID has been disabled
SQLCODE=“<sqlcode>”
at the satellite control server.
SQLSTATE=“<sqlstate>”,
User Response: Contact the help desk or your tokens=“<token1>”, “<token2>”,
system administrator. “<token3>”.
Explanation: An unknown error has been
SQL3954N This satellite is in the failed state detected by the communication subsystem. Refer
at the satellite control server. to “<sqlcode>” for more details.
Explanation: The satellite is in the failed state User Response: Contact the help desk or your
because a previous synchronization session system administrator.
failed.
User Response: Contact the help desk or your SQL3959N Synchronization session cannot
system administrator. start because of a communication
failure: SQLCODE=“<sqlcode>”
SQLSTATE=“<sqlstate>”,
SQL3955N The satellite control database
tokens=“<token1>”, “<token2>”,
name its alias could not be found.
“<token3>”.
Explanation: The satellite control database is
Explanation: An error has been detected by the
not cataloged correctly.
communication subsystem. Refer to “<sqlcode>”
User Response: Contact the help desk or you for more details.
system administrator.
User Response: Contact the help desk or your
system administrator.
SQL3956N The application version for this
satellite is not defined locally.
Explanation: The application version is not
defined locally on this satellite or is not defined
correctly.

368 Message Reference, Volume 2

SQL3960N Cannot upload results to the SQL3963N Results cannot be uploaded
satellite control server because of because of a database error:
a communication failure: SQLCODE=“<sqlcode>”
SQLCODE=“<sqlcode>” SQLSTATE=“<sqlstate>”,
SQLSTATE=“<sqlstate>”, tokens=“<token1>”, “<token2>”,
tokens=“<token1>”, “<token2>”, “<token3>”.
“<token3>”.
Explanation: An error occurred while uploading
Explanation: An error has been detected by the results to the satellite control server.
communication subsystem. Refer to “<sqlcode>”
User Response: Contact the help desk or your
for more details.
system administrator.
User Response: Contact the help desk or your
system administrator.
SQL3964N Synchronization failed because
the release level of the satellite is
SQL3961N Cannot authenticate with the not supported by the satellite
satellite control server. control server.
Explanation: An authentication error was Explanation: The release level of the satellite
detected while trying to connect to the satellite must be within the range of one level above to
control database. two levels below that of the satellite control
server.
User Response: Either the remote
administrative user ID or the password required User Response: Contact the help desk or your
to connect to the satellite control database was system administrator.
not correct, or both. Either provide the correct
user ID and password, or contact the help desk
SQL3965N Cannot download the
or your system administrator.
synchronization scripts because of
a satellite control server failure:
SQL3962N Synchronization could not be SQLCODE=“<sqlcode>”
started because of a database SQLSTATE=“<sqlstate>”,
error: SQLCODE=“<sqlcode>” tokens=“<token1>”, “<token2>”,
SQLSTATE=“<sqlstate>”, “<token3>”.
tokens=“<token1>”, “<token2>”,
Explanation: The satellite cannot download the
“<token3>”.
scripts that are required to synchronize the
Explanation: An error preventing satellite. One possible reason for this failure is
synchronization occurred at the satellite control that the control server cannot instantiate
server. parameterized scripts with the attributes of the
satellite. Another reason is that the satellite
User Response: Attempt to synchronize again.
control server was temporarily unable to
If failure persists, contact the help desk or your
complete the request because of resource
system administrator.
constraints.
User Response: Try the request again. If the
failure persists, contact the help desk or your
system administrator.

Chapter 2. SQL Messages 369

 not in the defined success code set, or the script
SQL3966N Synchronization session failed.
failed to execute.
Reason code “<reason-code>”.
User Response: Contact the help desk or your
Explanation: The synchronization session failed
system administrator.
to complete for one of the following reasons:
v (01) Missing authentication information.
SQL3969N Synchronization failed because an
v (02) Some scripts required for synchronization
interrupt was received during
are missing.
script execution.
v (03) System files are corrupted or missing.
Explanation: Script execution fails when an
v (04) A system error prevented scripts from
interrupt is received. An abnormal termination of
executing.
this type will cause the synchronization session
User Response: Try the request again. If failure to fail because the system may be in an
persists, contact the help desk or your system inconsistent state.
administrator.
User Response: Contact the help desk or your
system administrator.
SQL3967N Progress information cannot be
retrieved.
SQL3970N Synchronization session failed
Explanation: Progress on this satellite’s with, SQLCODE “<sqlcode>”
synchronization session cannot be retrieved. SQLSTATE “<sqlatate>” The error
Either the data is corrupt, or it does not exist. was detected at location
“<location>”.
User Response: If a synchronization session is
active and no progress information is available, Explanation: Script execution failed because of
contact the help desk or your system an unknown error.
administrator.
User Response: Contact the help desk or your
system administrator.
SQL3968N Synchronization failed to
complete successfully because of a
script failure. The results of the
execution, however, were sent to
the satellite control server.
Explanation: One of the synchronization scripts
failed during execution. Either a return code was

SQL4000 - SQL4099

SQL4001N The character “<character>” in SQL4002N “<token 1>” and “<token 2>” are
column “<column>” on line undeclared host variables that
“<line>” is not valid. cannot both be used as descriptor
names in a single SQL statement.
Explanation: The specified character is not a
valid character in SQL statements. Explanation: The specified identifiers have not
been declared as host variables. Descriptor
The statement cannot be processed.
names are not declared before using. Because
User Response: Remove or replace the character more than one descriptor name in a single
that is invalid. statement is not valid, at least one of the host
variables is not valid.

370 Message Reference, Volume 2

The statement cannot be processed.
SQL4006N The structures are nested too
User Response: Correct the use of descriptor deeply.
names or undeclared host variables in the
Explanation: The number of nested structures
statement. Note that the statement can contain
exceeded the maximum of 25.
additional undeclared host variables.
The statement cannot be processed.
SQL4003N The SQL statement on line User Response: Reduce the number of nested
“<line>” is not supported by this structures.
version of the precompiler.
Explanation: The release numbers of the SQL4007N The host structure
precompiler and the installed version of the “<host-structure>” has no fields.
database manager are not compatible. The
Explanation: No field can be found within the
specified statement is supported by the database
host structure “<host-structure>”.
manager but not the precompiler.
The statement cannot be processed.
The statement cannot be processed.
User Response: Add a field to the host
User Response: Repeat the precompile process
structure.
with the current version of the precompiler.

SQL4008N The host variable “<name>”

SQL4004N The package name is not valid.
cannot be uniquely referenced
Explanation: The package name contains even with full qualification.
characters that are not valid. Either the name is
Explanation: The host variable “<name>”
too long or no name was specified with the
matches with at least one other unqualified or
PACKAGE option.
partially qualified host variable even with full
No package is created. qualification.
User Response: Resubmit the command with a The command cannot be processed.
valid package name or without the PACKAGE
User Response: Rename the host variable.
option.

SQL4009N The expression for data length is

SQL4005N An invalid token “<token>” was
invalid.
found starting in position
“<position>” on line “<line>”. Explanation: The expression for data length has
syntax errors or is too complex.
Explanation: A syntax error in the SQL
statement was detected at the specified token The statement cannot be processed.
“<token>”.
User Response: Check the syntax of the size
The statement cannot be processed. expression.
User Response: Examine the statement,
especially around the specified token. Correct the SQL4010N Illegal nesting of Compound SQL
syntax. statements.
Explanation: This error is returned when a
BEGIN COMPOUND clause is detected as a
sub-statement of a Compound SQL statement.
User Response: Resubmit the precompilation

Chapter 2. SQL Messages 371

without the nested BEGIN COMPOUND.
SQL4013N An END COMPOUND statement
was found without a previous
SQL4011N Invalid SQL sub-statement in a BEGIN COMPOUND statement.
Compound SQL statement.
Explanation: This error is returned when an
Explanation: This error is returned when an END COMPOUND statement has been found
invalid sub-statement is detected in a Compound without a preceding BEGIN COMPOUND.
SQL statement. Valid statements are:
User Response: Either remove the END
v ALTER TABLE COMPOUND, or add a BEGIN COMPOUND,
v COMMENT ON and resubmit the precompilation.
v CREATE INDEX
v CREATE TABLE SQL4014N Invalid Compound SQL syntax.
v CREATE VIEW Explanation: This error is returned when a
v Positioned DELETE Compound SQL statement contains a syntax
v Searched DELETE error. Possible causes include:

v DROP v END COMPOUND is missing

v GRANT v one of the substatements is empty (zero length

or blank).
v INSERT
v LOCK TABLE User Response: Fix the syntax error and
re-precompile.
v REVOKE
v SELECT INTO
SQL4015N An error has occurred during
v Positioned UPDATE preprocessing.
v Searched UPDATE
Explanation: The external preprocessor has
v COMMIT; only when specified as the last terminated with one or more errors.
sub-statement.
v RELEASE TO SAVEPOINT; only for The command cannot be processed.
non-atomic Compound SQL User Response: Please refer to the “.err” file for
v ROLLBACK TO SAVEPOINT; only for the correponding source file for more details.
non-atomic Compound SQL
v SAVEPOINT; only for non-atomic Compound SQL4016N The preprocessor specified cannot
SQL be found.
User Response: Resubmit the precompilation Explanation: The preprocessor specified
without the invalid sub-statement. through the PREPROCESSOR option cannot be
found.
SQL4012N Invalid use of COMMIT in a The command cannot be processed.
Compound SQL statement.
User Response: Ensure that the preprocessor
Explanation: This error is returned when a can be executed from the current directory, and
sub-statement is detected after a COMMIT has also check the syntax of the PREPROCESSOR
been found in a COMPOUND SQL statement. option.
User Response: Make the COMMIT
sub-statement the last sub-statement, and
resubmit the precompilation.

372 Message Reference, Volume 2

 User Response: No action is required.
SQL4017W Preprocessing has completed
successfully.
SQL4020N The ’long’ host variable “<token
Explanation: Preprocessing of the input file has
1>” is not valid. Use ’sqlint32’
completed successfully using the external
instead.
command specified through the
PREPROCESSOR option. Explanation: If the LONGERROR YES
precompile option is in effect or the precompile
User Response: No action is required.
option LONGERROR has not been specified and
the platform has 8-byte ’long’s, then the
SQL4018W Starting to process the INTEGER host variable must be declared with
preprocessed file the data type ’sqlint32’, not ’long’.
“<preprocessed-file>”.
On 64 bit platforms with 8-byte ’long’ types the
Explanation: The precompiler is now processing precompile option LONGERROR NO can be
the preprocessed file. used to specify that ’long’ host variables are to
be used for BIGINT data types. For maximum
User Response: No action is required.
portability the use of ’sqlint32’ and ’sqlint64’ are
recommended for INTEGER and BIGINT data
SQL4019W Completed processing the types respectively.
preprocessed file
User Response: Replace the current data type of
“<preprocessed-file>”.
the host variable with the data type specified in
Explanation: The precompiler has completed the message.
processing the preprocessed file.

SQL4100 - SQL4199
User Response: Correct the SQL statement.
SQL4100I The “<sqlflag-type>” SQL
language syntax is used for syntax
checking by the flagger. SQL4103W A data definition statement is not
within a CREATE SCHEMA
Explanation: The SQL statements that have
statement.
passed the precompiler checking will be subject
to checking against the specified syntax by the Explanation: The FIPS standard requires that all
flagger. Warning message will be issued against data definition statements are contained within a
the statement when there is a syntax deviation. CREATE SCHEMA statement.
Processing continues. Processing continues.
User Response: None. This is an informational User Response: Correct the SQL statement.
message only.

SQL4104W There is a non-standard

SQL4102W An SQL syntax deviation has embedded comment.
occurred at the token starting with
the text ″<text>″. Explanation: A comment embedded in an SQL
statement does not meet the requirements of the
Explanation: The flagger has detected a standard being flagged. The comment does not
deviation from the SQL language syntax begin with at least two consecutive hyphens
specified in the SQLFLAG precompiler option.
Processing continues.
Processing continues.
User Response: Correct the SQL statement.

Chapter 2. SQL Messages 373

SQL4105W An SQL syntax deviation has SQL4109W The SET FUNCTION
occurred. The statement is not SPECIFICATION references
complete. column “<column>”.
Explanation: The SQL statement has terminated Explanation: One of the following conditions
before all required elements have been found. has not been met:
Processing continues. v The COLUMN REFERENCE of a DISTINCT
SET FUNCTION cannot reference a column
User Response: Correct the SQL statement. derived from a SET FUNCTION
SPECIFICATION.
SQL4106W The identifier “<identifier>” is v COLUMN REFERENCEs in the VALUE
more than 18 characters. EXPRESSION of an ALL SET FUNCTION
cannot reference a column derived from a SET
Explanation: Authorization identifier, table FUNCTION SPECIFICATION.
identifier, column name, correlation name,
module name, cursor name, procedure name, or Processing continues.
parameter name has a length of more than 18
User Response: Correct the SQL statement.
characters.
Processing continues.
SQL4110W A VALUE EXPRESSION
User Response: Correct the SQL statement. containing “<column>” cannot
include operators.

SQL4107W Column “<column>” has an Explanation: A VALUE EXPRESSION cannot

invalid length, precision, or scale include operators in an OUTER REFERENCE
attribute. COLUMN REFERENCE.

Explanation: One of the following conditions Processing continues.

has not been met:
User Response: Correct the SQL statement.
v Length value should be greater than zero.
v Precision value should be greater than zero.
SQL4111W The COLUMN REFERENCE is
v Scale value should not be greater than missing or is invalid for the ALL
precision. column function “<function>”.
Processing continues. Explanation: The VALUE EXPRESSION of an
User Response: Correct the SQL statement. ALL SET FUNCTION SPECIFICATION should
include a COLUMN REFERENCE.

SQL4108W An indicator variable has data Processing continues.

type other than exact numeric, or User Response: Correct the SQL statement.
has a non-zero scale.
Explanation: Data type of an indicator variable SQL4112W Column “<column>” is not
should be exact numeric with a scale of zero. unique and requires qualification.
Processing continues. Explanation: The specified column is not
User Response: Correct the SQL statement. unique within the current scope. Qualification
must be given to uniquely identify the required
column.
Processing continues.

374 Message Reference, Volume 2

User Response: Correct the SQL statement. User Response: Correct the SQL statement.

SQL4113W A VALUE EXPRESSION may not SQL4117W Operator “<operator>” is invalid

contain a SET FUNCTION in this context.
SPECIFICATION.
Explanation: One of the following conditions
Explanation: The VALUE EXPRESSION of an has not been met:
ALL SET FUNCTION may not contain SET v A VALUE EXPRESSION containing a
FUNCTION SPECIFICATION. DISTINCT SET FUNCTION cannot include
Processing continues. dyadic operators.
v First character following a monadic operator
User Response: Correct the SQL statement.
cannot be a plus or minus sign.
v VALUE EXPRESSION should not contain
SQL4114W Column “<column>” does not operators if PRIMARY is of type character
identify a column of a table string.
within the current scope.
Processing continues.
Explanation: One of the following conditions
has not been met: User Response: Correct the SQL statement.
v The table or correlation name used as a
qualifier does not exist. SQL4118W The “<exptype>” EXPRESSION is
v The column name does not exist within the comparing incompatible data
current scope or the scope of the qualifier. types.

Processing continues. Explanation: The data types of one of the

following (identified by exptype) do not match:
User Response: Correct the SQL statement.
v exptype = COMPARISON - Comparison
operators must match
SQL4115W A column function that contains v exptype = BETWEEN - The three VALUE
the OUTER REFERENCE column EXPRESSIONs must match
“<column>” is not in the
v exptype = IN - VALUE EXPRESSION,
subquery of a HAVING clause.
subquery and all VALUE SPECIFICATIONs
Explanation: A column function must be must match
contained in a subquery of a HAVING clause if it v exptype = QUANTIFIED - VALUE
contains an OUTER REFERENCE COLUMN EXPRESSION and subquery must match
REFERENCE.
Processing continues.
Processing continues.
User Response: Correct the SQL statement.
User Response: Correct the SQL statement.

SQL4119W The operand in the LIKE

SQL4116W The result of a SUM or AVG predicate is not a character string.
function cannot be a character
string. Explanation: One of the following conditions
has not been met:
Explanation: Character string is not valid for
v Data type of the column in a LIKE predicate is
the result of a SUM or AVG SET FUNCTION
not a character string.
SPECIFICATION.
v Data type of the pattern in a LIKE predicate is
Processing continues. not a character string.

Chapter 2. SQL Messages 375

Processing continues. Processing continues.
User Response: Correct the SQL statement. User Response: Correct the SQL statement.

SQL4120W The ESCAPE character must be a SQL4124W A reference to column

one-byte character string. “<column>” derived from a
column function is invalid in a
Explanation: Escape character in a LIKE
WHERE clause.
predicate must have the data type of character
string with a length of 1. Explanation: A VALUE EXPRESSION directly
contained in the SEARCH CONDITION of a
Processing continues.
WHERE clause must not include a reference to a
User Response: Correct the SQL statement. column derived from a column function.
Processing continues.
SQL4121W The WHERE clause, GROUP BY
User Response: Correct the SQL statement.
clause, or HAVING clause is
invalid for the grouped view
“<schema-name>”.“<view>”. SQL4125W A HAVING clause must contain
the WHERE clause when the
Explanation: If the table identified in the FROM
WHERE clause has a column
clause is a grouped view, then the TABLE
function.
EXPRESSION must not contain a WHERE clause,
GROUP BY clause, or HAVING clause. Explanation: If a VALUE EXPRESSION directly
contained in the SEARCH CONDITION is a
Processing continues.
column function, then the WHERE clause must
User Response: Correct the SQL statement. be contained in a HAVING clause.
Processing continues.
SQL4122W “<schema-name>”.“<name>”
User Response: Correct the SQL statement.
occurs more than once in a FROM
clause.
SQL4126W The COLUMN REFERENCE for
Explanation: One of the following conditions
“<column>” must be an OUTER
has not been met:
REFERENCE.
v Table name occurs more than once in a FROM
clause. Explanation: If a VALUE EXPRESSION directly
contained in the SEARCH CONDITION is a
v Correlation name is identical to a table name
function, then the COLUMN REFERENCE in the
or to another correlation name in a FROM
column function expression must be an OUTER
clause.
REFERENCE.
Processing continues.
Processing continues.
User Response: Correct the SQL statement.
User Response: Correct the SQL statement.

SQL4123W Only one table reference is

SQL4127W Column “<column>” is duplicated
allowed in the FROM clause for a
within the current scope.
GROUPed view.
Explanation: The specified column is duplicated
Explanation: If the table identified by table
within the current scope.
name is a GROUPed view, then the FROM clause
must contain exactly one table reference. Processing continues.

376 Message Reference, Volume 2

User Response: Correct the SQL statement.
SQL4131W The COLUMN REFERENCE for
“<column>” is invalid.
SQL4128W The COLUMN REFERENCE for
Explanation: One of the following conditions
“<column name>” should be a
has not been met:
grouping column or should be
specified within a column v For a GROUPed table, the COLUMN
function. REFERENCE must reference a GROUPing
column or be specified within a SET
Explanation: Each COLUMN REFERENCE FUNCTION SPECIFICATION.
contained in a subquery in the SEARCH
v If not a GROUPed table and VALUE
CONDITION of a HAVING clause must
EXPRESSION includes a SET FUNCTION
reference a grouping column or be specified
SPECIFICATION, then each COLUMN
within a column function.
REFERENCE must be specified within a SET
Processing continues. FUNCTION SPECIFICATION.
User Response: Correct the SQL statement. Processing continues.
User Response: Correct the SQL statement.
SQL4129W DEGREE of table
“<schema-name>”.“<table>”
SQL4132W DISTINCT is specified more than
should be 1 when using a
once.
SELECT LIST of *.
Explanation: One of the following conditions
Explanation: The DEGREE of the TABLE
has not been met:
EXPRESSION must be 1 if a SELECT LIST of * is
specified in a subquery of any predicate other v DISTINCT must not be specified more than
than an EXISTS predicate. once in a QUERY SPECIFICATION, excluding
any subquery of that QUERY
Processing continues. SPECIFICATION.
User Response: Correct the SQL statement. v DISTINCT must not be specified more than
once in a subquery, excluding any subquery
contained in that subquery.
SQL4130W The column function is not valid
for the TABLE EXPRESSION Processing continues.
beginning with table
User Response: Correct the SQL statement.
“<schema-name>”.“<table>”.
Explanation: One of the following conditions
SQL4133W The COMPARISON PREDICATE
has not been met:
subquery cannot contain a
v If the TABLE EXPRESSION is a grouped view, GROUP BY or HAVING clause.
the SELECT LIST of a subquery cannot contain
a SET FUNCTION SPECIFICATION. Explanation: If a subquery is specified in a
COMPARISON PREDICATE, then the TABLE
v If the TABLE EXPRESSION is a grouped view,
EXPRESSION whose FROM clause identifies the
the SELECT LIST of a QUERY
named table must not contain a GROUP BY
SPECIFICATION cannot contain a column
clause or a HAVING clause.
function.
Processing continues.
Processing continues.
User Response: Correct the SQL statement.
User Response: Correct the SQL statement.

Chapter 2. SQL Messages 377

 v In a FETCH statement, between source and
SQL4134W The COMPARISON PREDICATE
target.
subquery cannot identify a
GROUPed view. v In a SELECT statement, between source and
target.
Explanation: If a subquery is specified in a
COMPARISON PREDICATE, then the TABLE Processing continues.
EXPRESSION whose FROM clause identifies the User Response: Correct the SQL statement.
named table must not identify a GROUPed view.
Processing continues. SQL4139I You must specify a VIEW
User Response: Correct the SQL statement. COLUMN LIST for
“<schema-name>”.“<table>”.

SQL4135W There is an invalid Explanation: If any two columns in the table

AUTHORIZATION IDENTIFIER specified by the QUERY SPECIFICATION have
“<authid>”. the same column name, or if any column of that
table is an unnamed column, then a VIEW
Explanation: The AUTHORIZATION COLUMN LIST must be specified.
IDENTIFIER prefixed to the table name is
invalid. Processing continues.

Processing continues. User Response: Correct the SQL statement.

User Response: Correct the SQL statement.

SQL4140W An error has occurred causing the
flagger to stop. Module name =
SQL4136W Table or view ″<module-name>″. Internal error
“<schema-name>”.“<name>” code = ″<error code>″.
already exists.
Explanation: The flagger has encountered an
Explanation: The table name or view name internal error. If the syntax, bindfile or package
specified already exists in the catalog. option is also specified, processing continues but
Processing continues. flagger operation is discontinued. Otherwise,
processing is terminated.
User Response: Correct the SQL statement.
User Response: Record this message number
(SQLCODE), module name and error code in the
SQL4137W The COLUMN DEFINITION is message. Contact your technical service
missing. representative with the information.
Explanation: At least one COLUMN
DEFINITION should be specified for a CREATE SQL4141W An error has occurred when
TABLE. attempting to produce message
Processing continues. “<message number>” in module
“<module name>”.
User Response: Correct the SQL statement.
Explanation: The FLAGGER has attempted to
produce an undefined message.
SQL4138W The data type “<type1>” of the
target is not compatible with the Processing continues.
data type “<type2>” of the source. User Response: Record this message number
Explanation: Data types should match: (SQLCODE), module name and error code in the
message. Contact your technical service
representative with the information.

378 Message Reference, Volume 2

SQL4142W There is not enough memory for SQL4145W Error during FLAGGER access to
flagger operation. Internal error the system catalog. Flagging
code = ″<error code>″. continues to check syntax only.
SQLCODE = “<nnn>” SQLERRP
Explanation: There is not enough memory for
= “<modname>” SQLERRD =
the flagger to operate. If the syntax, bindfile or
“<nnn>” Creator =
package option is also specified, processing
“<creatorname>” Table =
continues but flagger operation is discontinued.
“<tablename>”
Otherwise, processing is terminated.
Explanation: An internal error has occurred
User Response: Ensure that your system has
during FLAGGER access to the system catalog.
sufficient real and virtual memory, and remove
any unnecessary background processes. Processing continues but with flagger syntax
checking only.
SQL4143W An error has occurred when User Response: Record this message number
releasing flagger memory. Internal (SQLCODE), module name and error code in the
error code = ″<error code>″. message. Contact your technical service
representative with the information.
Explanation: The flagger cannot release
allocated memory. If the syntax, bindfile or
package option is also specified, processing SQL4146W Internal error occurred causing the
continues but flagger operation is discontinued. semantics processing to stop.
Otherwise, processing is terminated. Module name = “<module
name>”. Internal error code =
User Response: Restart precompilation if
“<error code>”.
flagging is required.
Explanation: The FLAGGER has encountered a
severe internal error in a semantics analysis
SQL4144W Internal error on call to the
routine.
FLAGGER found in module
“<module-name>”. Internal error Processing continues but with flagger syntax
code = “<error code>”. checking only.
Explanation: The FLAGGER encountered an User Response: Record this message number
internal error. (SQLCODE), module name and error code in the
message. Contact your technical service
Preprocessing continues but FLAGGER operation
representative with the information.
is discontinued.
User Response: Record this message number
SQL4147W Invalid flagger version number.
(SQLCODE), module name and error code in the
message. Contact your technical service Explanation: An invalid flagger version number
representative with the information. is passed to the Precompiler Services COMPILE
SQL STATEMENT API. If the syntax, bindfile or
package option is also specified, processing
continues but flagger operation is discontinued.
Otherwise, processing is terminated.
User Response: Provide a valid flagger version
number. Refer to the Command Reference manual.

Chapter 2. SQL Messages 379

SQL4170W You must declare column SQL4175W Only * or column names are valid
“<column>” as NOT NULL. in this context.
Explanation: All columns identified as UNIQUE Explanation: When UNION is specified, the
must be defined with the NOT NULL option. SELECT LIST for the specification of the two
TABLE EXPRESSIONs identified by the QUERY
Processing continues.
EXPRESSION and QUERY TERM should consist
User Response: Correct the SQL statement. of * or COLUMN REFERENCE(s).
Processing continues.
SQL4171W The viewed table
User Response: Correct the SQL statement.
“<schema-name>”.“<table>” must
be updateable.
SQL4176W The descriptions of tables
Explanation: When the WITH CHECK OPTION
identified by the QUERY
clause is specified then the viewed table must be
EXPRESSION beginning with
updateable.
“<schema-name1>”.“<table1>”
Processing continues. and the QUERY TERM beginning
with “<schema-
User Response: Correct the SQL statement. name2>”.“<table2>” should be
identical.
SQL4172W Invalid number of column names. Explanation: When UNION is specified, the
Explanation: The number of column names in descriptions of the two tables should be identical,
the VIEW COLUMN LIST should be the same as except for the column names.
the DEGREE of the table specified by the QUERY Processing continues.
SPECIFICATION.
User Response: Correct the SQL statement.
Processing continues.
User Response: Correct the SQL statement. SQL4177W The SORT SPECIFICATION
“<number>” is outside the
SQL4173W You must declare cursor DEGREE of cursor “<cursor>”.
“<cursor>” before using it. Explanation: If the SORT SPECIFICATION
Explanation: The cursor specified has not been contains an unsigned integer, it should be greater
declared in a DECLARE CURSOR statement. than 0 and not greater than the number of
columns in the table.
Processing continues.
Processing continues.
User Response: Correct the SQL statement.
User Response: Correct the SQL statement.

SQL4174W Cursor “<cursor>” is already

declared. SQL4178W Table “<schema-name>”.“<table>”
is a read-only table.
Explanation: Cursor specified has already been
declared in a DECLARE CURSOR statement. Explanation: A DELETE, an INSERT, or an
UPDATE was specified on a read-only table.
Processing continues.
Processing continues.
User Response: Correct the SQL statement.
User Response: Correct the SQL statement.

380 Message Reference, Volume 2

 User Response: Correct the SQL statement.
SQL4179W Table “<schema-name>”.“<table>”
must not be identified in a FROM
clause of any subquery contained SQL4183W The number of columns specified
in a SEARCH CONDITION. does not match the number of
values specified.
Explanation: A table specified in a DELETE or
an UPDATE cannot be used in a FROM clause of Explanation: In an INSERT statement, the
any subquery contained in its SEARCH number of columns specified does not match the
CONDITION. number of values specified.
Processing continues. Processing continues.
User Response: Correct the SQL statement. User Response: Correct the SQL statement.

SQL4180W Table “<schema- SQL4184W The number of columns specified

name1>”.“<table1>” is not the does not match the DEGREE of
first table “<schema- the QUERY SPECIFICATION
name2>”.“<table2>” specified in beginning with table
the DECLARE CURSOR “<schema-name>”.“<table>”.
statement.
Explanation: In an INSERT statement, the
Explanation: Table specified in a DELETE or an number of columns specified does not match the
UPDATE statement should be the first table DEGREE of the table specified in the QUERY
specified in the FROM clause of the DECLARE SPECIFICATION
CURSOR statement.
Processing continues.
Processing continues.
User Response: Correct the SQL statement.
User Response: Correct the SQL statement.

SQL4185W There is a data type or length

SQL4181W The number of TARGET mismatch between column
SPECIFICATIONs does not match “<column>” and the INSERT or
the DEGREE of cursor “<cursor>”. UPDATE item.
Explanation: The number of TARGET Explanation: One of the following conditions
SPECIFICATIONs in the FETCH statement does has not been met:
not match the DEGREE of the table specified. v If the data type of the column name is
Processing continues. character string, then the corresponding item
in the INSERT or UPDATE statement should
User Response: Correct the SQL statement. be character string of length equal to or less
than the length of the column name.
SQL4182W Target table “<schema- v If the data type of the column name is exact
name>”.“<table>” of the INSERT numeric, then the corresponding item in the
statement is also in the FROM INSERT or UPDATE statement should be exact
clause or in the subquery. numeric.
Explanation: The named table must not be v If the data type of the column name is
identified in a FROM clause of a QUERY approximate numeric, then the corresponding
SPECIFICATION or of any subquery contained item in the INSERT or UPDATE statement
in the QUERY SPECIFICATION. should be approximate numeric or exact
numeric.
Processing continues.

Chapter 2. SQL Messages 381

Processing continues.
SQL4189W You cannot specify NULL for
User Response: Correct the SQL statement. NOT NULL column “<column>”.
Explanation: If NULL is specified in the SET
SQL4186W You cannot use a GROUP BY or clause of the UPDATE statement, then the
HAVING clause or identify a corresponding column should allow nulls.
GROUPed view in this context.
Processing continues.
Explanation: The table identified in the FROM
User Response: Correct the SQL statement.
clause of the TABLE EXPRESSION in a SELECT
statement should not include a GROUP BY or
HAVING clause and should not identify a SQL4190W A host variable of an
GROUPed view. unrecognized data type is
referenced. Host variable position
Processing continues.
is “<position>”.
User Response: Correct the SQL statement.
Explanation: The host variable reference at
position “<position>” is of a data type not
SQL4187W The number of elements specified recognized by the standard.
in the SELECT LIST should match
Processing continues.
the number in the SELECT
TARGET LIST. User Response: Correct the SQL statement.
Explanation: In the SELECT statement, the
number of elements specified in the SELECT SQL4191W The data type of column
LIST should match the number of elements in “<column name>” is not
the SELECT TARGET LIST. recognized.
Processing continues. Explanation: The data type of the column is not
recognized by the standard.
User Response: Correct the SQL statement.
Processing continues.
SQL4188W A column function is not allowed User Response: Correct the SQL statement.
in a SET clause of an UPDATE
statement.
SQL4192W Table “<schema-name>”.“<table>”
Explanation: A VALUE EXPRESSION in a SET is not found in the catalog.
clause of an UPDATE statement should not
Explanation: The named table or view does not
include a column function.
exist in the system catalog.
Processing continues.
User Response: Correct the SQL statement.

SQL4300 - SQL4399
User Response: Ensure that a compatible Java
SQL4300N Java support is not installed or
Runtime Environment or Java Development Kit
properly configured on this
for the server is installed. Ensure that the
platform.
″jdk11_path″ configuration parameter is correctly
Explanation: Support for Java stored procedures set.
and user-defined functions is not installed and
sqlcode: -4300
configured on this server.

382 Message Reference, Volume 2

sqlstate: 42724
SQL4303N Java stored procedure or
user-defined function ″<name>″,
SQL4301N Java interpreter startup or specific name ″<spec-name>″
communication failed, reason could not be identified from
code ″<reason-code>″. external name ″<string>″.

Explanation: An error occurred while Explanation: The CREATE PROCEDURE or

attempting to start or communicate with a Java CREATE FUNCTION statement that declared
interpreter. The reason codes are: this stored procedure or user-defined function
had a badly formatted EXTERNAL NAME
1 Java environment variables or Java clause. The external name must be formatted as
database configuration parameters are follows: ″package.subpackage.class!method″.
invalid.
User Response: Submit a corrected CREATE
2 A Java Native Interface call to the Java PROCEDURE or CREATE FUNCTION statement.
interpreter failed.
sqlcode: -4303
3 The ″db2java.zip″ file may be corrupt or
missing. sqlstate: 42724

4 The Java interpreter has terminated

itself and cannot be restarted. SQL4304N Java stored procedure or
user-defined function ″<name>″,
User Response: Ensure that the Java database specific name ″<spec-name>″
configuration parameters (jdk11_path and could not load Java class
java_heap_sz) are correctly set. Ensure that a ″<class>″, reason code
supported Java runtime environment is installed. ″<reason-code>″.
Ensure that internal DB2 classes (COM.ibm.db2)
are not overridden by user classes. Explanation: The Java class given by the
EXTERNAL NAME clause of a CREATE
sqlcode: -4301 PROCEDURE or CREATE FUNCTION statement
sqlstate: 58004 could not be loaded. The reason codes are:
1 The class was not found on the
SQL4302N Java stored procedure or CLASSPATH.
user-defined function ″<name>″, 2 The class did not implement the
specific name ″<spec-name>″ required interface
aborted with an exception (“COM.ibm.db2.app.StoredProc” or
″<string>″. “COM.ibm.db2.app.UDF”) or lacked the
Explanation: The Java stored procedure or Java “public” access flag.
user-defined function aborted with a Java 3 The default constructor failed or was
exception. The First Failure Service Log unavailable.
(db2diag.log) contains a Java stack traceback for
the aborted method. 4 Could not load driver for
“jdbc:default:connection”.
User Response: Debug the Java method to
eliminate the exception. 5 Could not establish default context.

sqlcode: -4302 User Response: Ensure that the compiled

″.class″ file is installed in the CLASSPATH, for
sqlstate: 38501 example under ″sqllib/function″. Ensure it
implements the required Java interfaces and is
″public″.

Chapter 2. SQL Messages 383

sqlcode: -4304 PROCEDURE or CREATE FUNCTION statement
could not be found. Its declared argument list
sqlstate: 42724
may not match what the database expects, or it
may not be a ″public″ instance method.
SQL4306N Java stored procedure or
User Response: Ensure that a Java instance
user-defined function ″<name>″,
method exists with the ″public″ flag and the
specific name ″<spec-name>″
expected argument list for this call.
could not call Java method
″<method>″, signature ″<string>″. sqlcode: -4306
Explanation: The Java method given by the sqlstate: 42724
EXTERNAL NAME clause of a CREATE

SQL4400 - SQL4499
User Response: No further action is required.
SQL4400N “<authorization-ID>” does not
have the authority to perform the
task at the DB2 Administration SQL4403N The syntax of the command is
Server. invalid.
Explanation: The user does not have the Explanation: The command was entered using
necessary authority at the DB2 Administration invalid arguments or an invalid number of
Server to perform the attempted action. parameters.
User Response: Attach to the DB2 User Response: Re-submit the command with
Administration Server using a user ID with the valid argument(s).
necessary Authority. Most tasks performed at the
DB2 Administration Server require SYSADM
authority. SQL4404N The DB2 Administration Server
does not exist.

SQL4401C The DB2 Administration Server Explanation: The DB2 Administration Server
encountered an error during was not found on the machine.
startup. User Response: Create the DB2 Administration
Explanation: An error was encountered during Server on the machine.
startup of the DB2 Administration Server. v On OS/2 or Windows 32-bit operating
systems, issue the following command:
User Response: Refer to the DB2
Administration Server’s First Failure Data db2admin create
Capture Log for additional information. Take the v On UNIX platforms, ensure that you have root
appropriate action as necessary and attempt to authority, and issue the following command
restart the DB2 Administration Server. from the instance subdirectory in the path of
the DB2 Universal Database instance, where
If the problem persists contact your technical <ASName> represents the name of the
service representative. Administration Server:
dasicrt <ASName>
SQL4402W The DB2ADMIN command was
successful.
Explanation: All processing completed
normally.

384 Message Reference, Volume 2

SQL4405W The DB2 Administration Server SQL4411N The requested operation is not
already exists. allowed because the server
instance is not the DB2
Explanation: The DB2 Administration Server
Administration Server.
already exists on the machine
Explanation: The requested operation is only
User Response: No further action is required.
valid when issued against the DB2
Administration Server.
SQL4406W The DB2 Administration Server
User Response: The DB2 Administration Server
was started successfully.
should be set up using the DB2ADMIN
Explanation: All processing completed command. Refer to the Quick Beginnings for
normally. further information about the DB2ADMIN
command.
User Response: No further action is required.

SQL4412N The logon user account for the

SQL4407W The DB2 Administration Server DB2 Administration Server is
was stopped successfully. invalid.
Explanation: All processing completed Explanation: To perform the requested task, the
normally. DB2 Administration Server must be running
User Response: No further action is required. under a valid logon user account. This error is
either caused by the account not being setup, or
the logon user account does not contain a valid
SQL4408N The DB2 Administration Server DB2 user ID.
was not dropped because it is
active. User Response: If a logon user account has
been set up, then ensure that the account uses a
Explanation: The DB2 Administration Server valid DB2 user ID.
must be stopped before it can be dropped.
You can set up the logon user account for the
User Response: To stop the DB2 Administration DB2 Administration Server by using the
Server, enter the following command: following command:
DB2ADMIN STOP DB2ADMIN SETID <userid> <password>

SQL4409W The DB2 Administration Server is SQL4413W Usage: DB2ADMIN creates, drops,
already active. starts, or stops the DB2
Explanation: The DB2ADMIN START command Administration Server.
can not be processed because the DB2 Explanation: The DB2ADMIN command syntax
Administration Server is already active. is:
User Response: No further action is required. DB2ADMIN CREATE [/USER:<username>
/PASSWORD:<password>]
DROP
SQL4410W The DB2 Administration Server is START
not active. STOP
SETID <username> <password>
Explanation: The DB2ADMIN STOP command /h
can not be processed because the DB2
Administration Server is not active.
The command options are:
User Response: No further action is required.

Chapter 2. SQL Messages 385

CREATE /h display the usage information
create the DB2 Administration Server
User Response: Issue the DB2ADMIN
DROP delete the DB2 Administration Server command with one of the valid command
options.
START start the DB2 Administration Server
STOP stop the DB2 Administration Server
SQL4414N The DB2 Administration Server is
SETID set the logon account for the DB2 not active.
Administration Server
Explanation: The request cannot be processed
/USER specify the logon account name during unless the DB2 Administration Server is active.
DB2ADMIN CREATE
User Response: Start the DB2 Administration
/PASSWORD Server by issuing the command DB2ADMIN
specify the logon account password START, and reissue the request.
during DB2ADMIN CREATE

SQL4900 - SQL4999
User Response: Correct the specified parameter
SQL4901N Precompiler Services requires
and call the function again.
reinitialization because of a
previous error.
SQL4904N The pointer to parameter “<n>” of
Explanation: On a previous function call, an
function “<function>” is not
error occurred. The requested function call
valid.
cannot be processed until Precompiler Services is
reinitialized. Explanation: The pointer to the specified
parameter in the specified function is not valid.
The function cannot be completed.
The function cannot be completed.
User Response: Call the sqlainit function to
reinitialize Precompiler Services User Response: Correct the specified parameter
and call the function again.
SQL4902N At least one of the characters in
parameter “<n>” of function SQL4905N The value of parameter “<n>” of
“<function>” is not valid. function “<function>” is not
within the valid range.
Explanation: The specified parameter in the
specified function contains at least one character Explanation: The value of the specified
that is not valid. parameter in the specified function is outside the
valid range for that parameter. If the specified
The function cannot be completed.
parameter is a structure, it may contain values
User Response: Correct the specified parameter that are within the valid range but are not valid
and call the function again. when considered together. Some structures
contain headers that specify the allocated size
and how much of that size is being used. It is
SQL4903N The length of parameter “<n>” of
not valid for the allocated size to be less than the
function “<name>” is not valid.
used size.
Explanation: The length of the specified
The function cannot be completed.
parameter in the specified function is not valid.
User Response: Correct the specified parameter
The function cannot be completed.
and call the function again.

386 Message Reference, Volume 2

 specified in the list to be rolled forward is not in
SQL4906N The list of table space names
rollforward pending state on the specified nodes.
specified is an incomplete set for
If continuing a table space rollforward that is
the rollforward operation.
already in progress, one or more of the table
Explanation: The list of table space names is spaces specified in the list to be rolled forward is
incomplete for one of the following reasons: not in rollforward in progress state on the
v For point-in-time table space recovery, a table specified nodes.
space list must be specified. If ″,...″ is displayed at the end of the node list,
v For point-in-time table space recovery, a see the diagnostic log for the complete list of
self-contained list of table space names must nodes.
be specified. The table spaces in the list must
Roll-forward recovery stops.
contain all objects of every table included in
the table spaces. (Note : if you are using a partitioned database
v Point-in-time table space recovery is not server, the node number(s) indicate which
allowed for the system catalogs. node(s) the error occurred on. Otherwise, it is
not pertinent and should be ignored.)
v End-of-logs table space recovery is allowed for
the system catalogs but it can be the only table User Response: Use the LIST TABLESPACES
space name in the list. SHOW DETAIL command on the nodes specified
v The CANCEL option for rollforward must to find out which table spaces are not ready to
have a table space list if there are no table be rolled forward. Use the QUERY STATUS
spaces in ″rollforward-in-progress″ state. option of the rollforward command to determine
the status of the table space rollforward. If the
User Response: Check the table space list and rollforward status is ″TBS pending″, a new table
resubmit the rollforward command with the space rollforward can be started. If the
complete table space list. rollforward status is ″TBS working″, a table space
rollforward is already in progress.
SQL4907W Database ″<name>″ is recovered If starting a new table space rollforward, put the
but one or more of the tables in tablespaces into rollforward pending state by
the table space list included for restoring them.
the rollforward operation are
placed in check pending states. If continuing a table space rollforward and one
or more of the table spaces involved have been
Explanation: One or more of the tables involved restored and put into rollforward pending state,
in the point-in-time tablespace recovery have the table space rollforward in progress must be
referential constraints with tables outside of the canceled. Submit the rollforward command again
table space list used for recovery. All these tables with the CANCEL option and the same table
are placed in check pending state. Rollforward space list. When the rollforward in progress is
operation is otherwise completed successfully. canceled, the table spaces will have been put into
User Response: Check the state for the tables in restore pending state. Restore the table spaces
the table spaces and take appropriate actions if and submit the original rollforward command
necessary. again.

SQL4908N The table space list specified for

roll-forward recovery on database
″<name>″ is invalid on node(s)
″<node-list>″.
Explanation: If starting a new table space
rollforward, one or more of the table spaces

Chapter 2. SQL Messages 387

SQL4909W Roll forward recovery has SQL4910N Overflow log path ″<log-path>″ is
completed successfully but one or not valid.
more table spaces have their
Explanation: The overflow log path specified on
tables put in DRP/DRNP state.
the ROLLFORWARD command is not valid. The
Check the db2diag.log file for
overflow log path must be a directory in a file
details on node(s) ″<node-list>″.
system. This directory must be accessible by the
Explanation: One or more table spaces have instance owner id.
tables in DATALINK Reconcile Pending (DRP)
User Response: Resubmit the command with a
state or DATALINK Reconcile Not Possible
valid overflow log path.
(DRNP) state for one of the following reasons:
v Restore is done specifying the WITHOUT
DATALINK option and rollforward to a SQL4911N The host variable data type is not
point-in-time follows the restore. Any tables valid.
with DATALINK columns are placed in DRP Explanation: The data type of the host variable
state. is not valid.
v Restoring from a backup image with a
different database name, alias, hostname, or The function cannot be completed.
instance and rollforward follows the restore. User Response: Correct the data type of the
Any tables with DATALINK columns are host variable and call the function again.
placed in DRNP state.
v Restoring from a backup image that has
SQL4912N The host variable data length is
become unusable and rollforward follows the
out of range.
restore. Any tables with DATALINK columns
are placed in DRNP state. Explanation: The length of the host variable is
v Rollforward was to a point-in-time, not to the not valid.
end of logs. Any tables with DATALINK The function cannot be completed.
columns in that tablespace are placed in DRP
state. User Response: Correct the length of the host
variable and call the function again.
v DATALINK column information does not exist
at the DB2 Data Links Manager(s). Affected
tables are placed in DRNP state. SQL4913N The host variable token ID has
v Rollforward involved DATALINK columns already been used.
defined with the ″RECOVERY NO″ option. Explanation: The token ID of the host variable
Affected tables are placed in DRP state. has already been used. The token ID must be
If ″,...″ is displayed at the end of the node list, unique within the module.
see the diagnostic log for the complete list of The function cannot be completed.
nodes.
User Response: Correct the token ID of the host
(Note : if you are using a partitioned database variable and call the function again.
server, the node number(s) indicate which
node(s) the error occurred on. Otherwise, it is SQL4914N The host variable token ID is not
not pertinent and should be ignored.) valid.
User Response: Look in the db2diag.log file to Explanation: The token ID of the host variable
find out what tables are put in DRP/DRNP state. is not valid.
See the Administration Guide for information on
reconciling tables that are in DRP/DRNP state. The function cannot be completed.

388 Message Reference, Volume 2

User Response: Correct the token ID of the host
SQL4919N The task_array parameter of
variable and call the function again.
function “sqlacmpl” is too small.
Explanation: The task array structure passed to
SQL4915N The “sqlainit” function has
Precompiler Services on the sqlacmpl function
already been called.
call is too short.
Explanation: Precompiler Services has already
The function did not complete successfully.
been initialized.
User Response: Increase the size of the
User Response: No action is required. Continue
precompiler task array structure allocated by the
processing.
precompiler. Recompile the application program.

SQL4916N The “sqlainit” function has not

SQL4920N The token_id_array parameter of
been called.
function “sqlacmpl” is too small.
Explanation: Precompiler Services must be
Explanation: The token id array structure
initialized before the requested function call can
passed to Precompiler Services on the sqlacmpl()
be processed.
function call is too small.
The function cannot be completed.
The function did not complete successfully.
User Response: Issue an sqlainit function call to
User Response: Increase the size of the
initialize Precompiler Services.
precompiler token id array structure allocated by
the precompiler. Recompile the application
SQL4917N Element “<number>” in the program.
option array is not valid.
Explanation: The option array contains an SQL4930N Bind or precompile option or
element with an option.type or option.value that is option value “<option-name>” is
not valid. The element number in the message is invalid.
the nth element in the option portion of the
Explanation: Either “<option-name>” is an
option array.
invalid bind or precompile option or the value
The function cannot be completed. specified for this option is invalid. The bind or
precompile cannot continue.
User Response: Correct the values stored in the
option array. Call the function again. User Response: Correct the bind or precompile
option or option value and retry the bind or
precompile command.
SQL4918N The term_option parameter of
function “sqlainit” is not valid.
SQL4940N The “<clause>” clause is not
Explanation: The term_option parameter is not permitted or is required.
valid.
Explanation: The indicated clause is either not
The function cannot be completed. allowed in the context where it appears in the
User Response: Correct the term_option SQL statement or it is required in the statement.
parameter and call the function again. A subquery, an INSERT statement, or a CREATE
VIEW statement cannot have INTO, ORDER BY,
or FOR UPDATE clauses. An embedded SELECT
statement cannot have ORDER BY or FOR
UPDATE clauses. An embedded SELECT
statement cannot contain a set operator except in

Chapter 2. SQL Messages 389

a subquery. SELECT statements used in cursor to specify the same number of host variables as
declarations cannot have an INTO clause. SELECT list expressions.
An embedded SELECT statement must have an
INTO clause. SQL4944N An update or insert value is
NULL but the object column
The function cannot be completed.
cannot contain NULL values.
User Response: Remove or add the clause to
Explanation: One of the following occurred:
correct the statement.
v The update or insert value was NULL but the
object column is declared as NOT NULL in the
SQL4941N The SQL statement is blank or table definition. Therefore, null values cannot
empty. be inserted into that column, and values in
Explanation: The text following EXEC SQL was that column cannot be set to NULL by an
blank or empty. update.
v The column name list for the INSERT
The function cannot be completed. statement omits a column that was declared as
User Response: Ensure that a valid SQL NOT NULL in the table definition.
statement is provided following the word EXEC v The view for the INSERT statement omits a
SQL. column that was declared as NOT NULL in
the base table definition.
SQL4942N The statement selects an The function cannot be completed.
incompatible data type into host
variable “<name>”. User Response: Examine the definition of the
object table to determine which columns of the
Explanation: An embedded SELECT statement table have the NOT NULL attribute, and correct
selects into a host variable “<name>” but the the SQL statement.
data type of the variable and the corresponding
SELECT list element are not compatible. If the
data type of the column is date and time, the SQL4945N The use of a parameter marker is
data type of the variable must be character with not valid.
an appropriate minimum length. Both must Explanation: Parameter markers can be used
either be numeric, character, or graphic. only in dynamic SQL statements.
The function cannot be completed. The function cannot be completed.
User Response: Verify that the table definitions User Response: Use host variables instead of
are current and that the host variable has the parameter markers for static SQL statements.
proper data type.

SQL4946N The cursor or statement name

SQL4943W The number of host variables in “<name>” is not defined.
the INTO clause is not the same
as the number of items in the Explanation: The cursor or statement name
SELECT clause. “<name>” specified in the statement is not
defined.
Explanation: The number of host variables
specified in both the INTO clause and the The function cannot be completed.
SELECT clause must be the same. User Response: Check the application program
The function is processed. for completeness and possible spelling errors in
the cursor or statement names.
User Response: Correct the application program

390 Message Reference, Volume 2

SQL4947W An INCLUDE SQLDA statement SQL4953N The call_type parameter of
was encountered and ignored. function “<name>” is not valid.
Explanation: The FORTRAN precompiler Explanation: The call_type parameter of the
shipped by the database manager does not specified function in the application is not valid.
support the INCLUDE SQLDA statement.
The function cannot be completed.
The statement is ignored. Processing continues.
User Response: Correct the call_type parameter
User Response: No action is required. To in the application program.
prevent this message, remove the INCLUDE
SQLDA statement from the program.
SQL4954N The section_number parameter of
function “<name>” is not valid.
SQL4950N Compound SQL statements
Explanation: The section_number parameter of
containing user-defined SQLDAs
the specified function in the application program
are not supported in this
is not valid. Note that for the following SQL
environment.
statements, the section_number parameter of the
Explanation: Compound SQL statements function sqlacall() is used to pass in the
containing user-defined SQLDAs are not statement type:
supported in a 16-bit application. v CONNECT
User Response: Move the statement out of the v SET CONNECTION
compound SQL block or replace the statement v RELEASE
with one that uses host variables instead of an
v DISCONNECT
SQLDA.
The function cannot be completed.
SQL4951N The sqlda_id parameter of User Response: Correct the section_number
function “<name>” is not valid. parameter in the application program.
Explanation: The sqlda_id parameter of the
specified function in the application program is SQL4970N Roll-forward recovery on database
not valid. The sqlda_id parameter cannot be null. ″<name>″ cannot reach the
specified stop point (end-of-log or
The function cannot be completed.
point-in-time) because of missing
User Response: Correct the sqlda_id parameter log file(s) on node(s)
in the application program. ″<node-list>″.
Explanation: This message is returned in the
SQL4952N The sqlvar_index parameter of following situations:
function “<name>” is not valid. v a request was made to bring the specified
Explanation: The sqlvar_index parameter of the database out of roll-forward pending state by
specified function in the application program is specifying caller action
not valid. The sqlvar_index may be larger than the SQLUM_ROLLFWD_STOP, SQLUM_STOP,
number of sqlvar elements in the SQLDA. SQLUM_ROLLFWD_COMPLETE, or
SQLUM_COMPLETE but the Rollforward
The function cannot be completed. Database utility cannot find the necessary
User Response: Correct the sqlvar_index archive log file(s) in the database log directory
parameter in the application program. or the overflow log directory on the specified

Chapter 2. SQL Messages 391

 node(s) to reach the stopping point from the caller action SQLUM_ROLLFWD_STOP,
previous ROLLFORWARD DATABASE SQLUM_STOP,
command. SQLUM_ROLLFWD_COMPLETE, or
v in a multi-node environment, if the SQLUM_COMPLETE.
Rollforward Database utility cannot find the Note : if you are using a partitioned database
necessary archive log file(s) to bring a node server, the node number indicates which node
into synchronization with the catalog node. the error occurred on. Otherwise, it is not
If ″,...″ is displayed at the end of the node list, pertinent and should be ignored.
see the diagnostic log for the complete list of User Response: Reissue the ROLLFORWARD
nodes. DATABASE command with caller action
SQLUM_ROLLFWD_STOP, SQLUM_STOP,
Roll-forward recovery has stopped. The database SQLUM_ROLLFWD_COMPLETE, or
is left in roll-forward pending state. SQLUM_COMPLETE. Any stoptime specified
will be ignored since the previous stoptime is
Note : if you are using a partitioned database already being processed.
server, the node number(s) indicate which
node(s) the error occurred on. Otherwise, it is
not pertinent and should be ignored. SQL4972N Log extent ″<extent>″ on node
″<node-number>″ could not be
User Response: Use the ROLLFORWARD moved to the database logpath.
DATABASE command with the QUERY STATUS
option to determine which log files are missing. Explanation: The Rollforward utility was
invoked with the STOP option. As part of
Do one of the following: roll-forward processing, the log extent ″<extent>″
v Make sure that all archive log files are has to be truncated. This extent must exist in the
available in the database log directory or the database logpath. Currently, the extent exists in
overflow log path, and issue the the overflow log path. An attempt was made to
ROLLFORWARD DATABASE command again. move the extent from the overflow log path to
the database logpath. The attempt failed.
v If you cannot find the missing log files, restore
Roll-forward processing has been stopped.
the database/table space on all nodes, then do
point-in-time recovery using a timestamp that Note : if you are using a partitioned database
is earlier than that of the earliest missing log server, the node number indicates which node
file. the error occurred on. Otherwise, it is not
pertinent and should be ignored.
SQL4971N Roll-forward recovery on database User Response: Move the extent from the
″<name>″ on node overflow log path to the database logpath and
“<node-number>” failed then resubmit the ROLLFORWARD DATABASE
previously while stopping. command.
Roll-forward recovery must be
stopped.
SQL4973N Forward recovery on database
Explanation: A request was made to continue ″<name>″ cannot complete
rolling forward the specified database by because the log information on
specifying caller action SQLUM_ROLLFWD. The node(s) ″<node-list>″ does not
previous iteration of roll-forward recovery failed match the corresponding record(s)
while stopping. If rolling forward at the database on the catalog node.
level, this means that it failed during log
truncation. Roll-forward recovery for this Explanation: The Rollforward utility processed
database must now be stopped by specifying all the log files found on each node, but the stop
points on the specified nodes do not match the

392 Message Reference, Volume 2

corresponding records on the catalog node. This the database or selected table spaces are left in in
can be caused by missing log files on either the an inconsistent state. The database or selected
catalog node or on the specified nodes, or the table spaces are in restore pending state on the
catalog node must be included in the list of listed nodes.
nodes to be rolled forward.
If ″,...″ is displayed at the end of the node list,
The ROLLFORWARD DATABASE processing see the diagnostic log for the complete list of
stops. nodes.
User Response: Do one of the following: Note : if you are using a partitioned database
v Check if the catalog node needs to be rolled server, the node number(s) indicate which
forward. If it does, submit the node(s) the error occurred on. Otherwise, it is
ROLLFORWARD DATABASE command again not pertinent and should be ignored.
and include the catalog node. User Response: Restore the database or selected
v Use the ROLLFORWARD DATABASE table spaces on the listed nodes. The table spaces
command with the QUERY STATUS option to that are in restore pending state can be identified
determine which log files are missing. When on the specified node(s) by the LIST
you find the log files, put them in the log path TABLESPACES command or the db2dart utility.
or overflow log path and resume forward
recovery.
SQL4976N The ROLLFORWARD DATABASE
v If you cannot find the missing log files, restore command cannot be submitted on
the database on all nodes, then do a non-catalog node.
point-in-time recovery using a stoptime that is
earlier than that of the earliest missing log file. Explanation: The ROLLFORWARD DATABASE
command is only accepted on the catalog node.

SQL4974W The ROLLFORWARD DATABASE User Response: Submit the command on the
QUERY STATUS command catalog node.
encountered sqlcode ″<sqlcode>″.
Explanation: The ROLLFORWARD DATABASE SQL4977N Dropped table export directory
QUERY STATUS command encountered an error ″<directory>″ is not valid.
with the sqlcode ″<sqlcode>″. The query might Explanation: The export directory path specified
not be successful on some nodes for various on the ROLLFORWARD command is not valid.
reasons. The most severe error is indicated by The export directory path must be a directory in
″<sqlcode>″. The roll-forward status is only a file system. This directory must be accessible
returned for the successful nodes. by the instance owner id.
User Response: Look up the sqlcode User Response: Resubmit the command with a
″<sqlcode>″ in the Message Reference, or online to valid export directory path.
determine the problems on the failed nodes. Take
the required corrective actions, then continue the
forward recovery on these nodes. SQL4978N The dropped table can not be
accessed.

SQL4975W Roll-forward operation was Explanation: The dropped table can not be
cancelled successfully. The accessed. This may be due to the table being put
database or selected table spaces into unavailable state because of a LOAD
have to be restored on node(s) without copy or a NOT LOGGED INITIALLY
″<node-list>″. operation.

Explanation: A roll-forward operation was User Response: The table can not be recovered
cancelled before it successfully completed, and using the DROPPED TABLE RECOVERY option.

Chapter 2. SQL Messages 393

 The function cannot be processed.
SQL4979W Unable to export the dropped
table data. User Response: Retry the application with a
valid authorization ID.
Explanation: The command was unable to
export the data of the dropped table whose
recovery is being attempted. This can happen SQL4998C The application state is in error;
when the dropped table id specified on the the database connection has been
ROLLFORWARD command is invalid, or when lost.
not all of the logs are available for roll forward.
This warning will be generated when an error Explanation: The connection to the database has
occurs during a dropped table recovery using a been lost.
ROLLFORWARD ... AND STOP command. The function cannot be processed.
User Response: Resubmit the command after User Response: Reconnect to the database.
ensuring that the dropped table id provided is
valid, and that all of the logs are available for
roll forward. SQL4999N A Precompiler Services or
Run-Time Services error occurred.

SQL4994N Precompilation was ended Explanation: A database manager error

because of a user interrupt occurred that prevents Precompiler Services or
request. Run-Time Services from processing function calls.

Explanation: Precompilation was terminated No Precompiler Services or Run-Time Services

because of an interrupt. The user may have function calls can be processed.
pressed an interrupt key sequence. User Response: Record the message number
Processing is terminated. No package was (SQLCODE) and all error information form the
created. SQLCA if possible.

User Response: Resubmit the precompilation if If trace was active, invoke the Independent Trace
needed. Facility at the operating system command
prompt. Refer to the Independent Trace Facility
in the Troubleshooting Guide for information on
SQL4997N The authorization ID is not valid. how to use this facility.
Explanation: The authorization ID for the v Environment: Outer Precompiler Using
application was specified previously but it was Precompiler Services API
defined with more than 8 characters or with v Required information:
characters that are not valid for an authorization
– Problem description
ID.
– SQLCODE
The authorization ID must not be PUBLIC
– SQLCA contents if possible
(public) and it must not begin with SYS (sys),
IBM (ibm), or SQL (sql). Also, it must not contain – Trace file if possible.
the underscore character or any characters
outside the database manager base character set.

SQL5000 - SQL5099

394 Message Reference, Volume 2

SQL5001N “<authorization-ID>” does not SQL5012N The entry in the database
have the authority to change the manager configuration file for the
database manager configuration maximum number of segments
file. allowed for the DB2 kernel is not
in the valid range.
Explanation: The user attempted to Update or
Reset the database manager configuration file Explanation: The value for the maximum
without having SYSADM authority. number of segments allowed for the DB2 kernel
must be between 8 and 8192.
The requested change is not made.
The requested change is not made.
User Response: Do not attempt to change the
database manager configuration file without User Response: Resubmit the command with a
appropriate authorization. Contact a user with valid value for the maximum number of DB2
SYSADM authority if a change is required. segments allowed.

SQL5005C System Error. SQL5018N The entry in the database

manager configuration file for the
Explanation: A system error, probably an I/O
maximum number of remote
error, was encountered while accessing a
connections to the workstation
configuration file.
(numrc) is not in the valid range.
The command cannot be processed.
Explanation: The value for the maximum
User Response: Resubmit the command. number of remote connections to the workstation
must be between 1 and 255.
If the error persists, check the db2diag.log file for
details and ensure that the configuration file is The requested change is not made.
accessible. If unable to resolve the problem,
User Response: Resubmit the command with a
contact an IBM Service Representative for
valid value for the maximum number of remote
assistance.
connections to the workstation.

SQL5010N The path name to the database

SQL5020N The entry in the database
manager configuration file is not
manager configuration file for the
valid.
node name for the workstation
Explanation: An error occurred while (nname) is not valid.
determining the path for the database manager
Explanation: The node name specified in the
configuration file. The database manager
configuration command is not valid. The node
directory structure may have been altered.
name may be 1 to 8 characters. All the characters
The command cannot be processed. must be chosen from the database manager base
character set.
User Response: Resubmit the command. If the
error continues, reinstall the database manager. The command cannot be processed.
User Response: Resubmit the command with a
valid node name.

Chapter 2. SQL Messages 395

SQL5021N The entry in the database SQL5025C The database manager
manager configuration file for the configuration file is not current.
index recreation time (indexrec) is
Explanation: The database manager
not valid. Possible values are 1
configuration file has been updated since you
(during index access) and 2
connected to the database. It is not compatible
(during database restart).
with the configuration for the database to which
Explanation: An invalid value was passed to you are connected.
Configuration Services for the Index Recreation
No access is allowed to the database manager
Time flag (indexrec) in the database manager
configuration file.
configuration file. The invalid value may have
been entered through the Command Line User Response: Wait until all applications
Processor or through a program API call. The disconnect from the databases. Issue the stop
only valid values for the API call are 1 (during database manager command, and then issue the
database access), and 2 (during database restart). start database manager command.
The valid values for the command line processor
are ACCESS and RESTART. If installing the sample database, drop it and
install the sample database again.
The update to the database manager
configuration file is rejected.
SQL5028N The value of sysadm_group must
User Response: Repeat the update request, be the primary group of the
entering one of the possible values. instance owner.
Explanation: An attempt was made to update
SQL5022N The entry in the database sysadm_group in the database manager
configuration file for the index configuration file. For Version 2 of DB2 on
recreation time (indexrec) is not Unix-based platforms, this value is only allowed
valid. Possible values are 0 (use to be the primary group of the instance owner.
system setting), 1 (during index
access), and 2 (during database User Response: Use the primary group of the
restart). instance owner to update this field in the
database manager configuration file on
Explanation: An invalid value was passed to Unix-based platforms.
Configuration Services for the Index Recreation
Time flag (indexrec) in a database configuration
file. The invalid value may have been entered SQL5030C The release number is not valid.
through the Command Line Processor or through Explanation: The release number in the
a program API call. The only valid values for the database manager configuration file or database
API call are 0 (use system setting), 1 (during configuration file is not valid.
index access), and 2 (during database restart).
The command cannot be processed.
The valid values for the command line processor
are SYSTEM, ACCESS, and RESTART. User Response: Verify that the release levels of
your database and DB2 match.
The update to the database configuration file is
rejected. If installing the sample database, drop it and
install the sample database again.
User Response: Repeat the update request,
entering one of the possible values. sqlcode: -5030
sqlstate: 58031

396 Message Reference, Volume 2

 v turning on trace, run db2start again, then
SQL5035N The database requires migration
examine the trace record.
to the current release.
Explanation: The database was created on a
SQL5043N Support for one or more
lower level system release. The Migrate Database
communications protocols failed
command must be used to convert the database
to start successfully. However,
to the current release level.
core database manager
The command cannot be processed. functionality started successfully.
User Response: Perform the Migrate Database Explanation: Communication protocol support
command before attempting to use the database did not start successfully for one or more
with the current system release. protocols. Possible reasons can include the
following:
If this message is received during a restore, drop
the existing database before proceeding. v Communication subsystem configuration error.
v Communication subsystem call failure.
sqlcode: -5035
v Database manager configuration error.
sqlstate: 55001
v System call failure.
v Database manager licensing error.
SQL5040N One of the socket addresses
required by the TCP/IP server You can still connect to the server with
support is being used by another communication protocols that did start
process. successfully. Local clients can also connect to the
server.
Explanation: One of the socket addresses
required by the server either is in use by another User Response: The database manager attempts
program, or has not been freed completely by the to start all communication protocols specified by
TCP/IP subsystem after the database manager the DB2COMM environment variable.
has been stopped. Check the diagnostic log (db2diag.log) for details
User Response: If you have just issued db2stop, on this error. The log will contain more
wait for a couple of minutes so that the TCP/IP information on the cause of the error and also
subsystem has enough time to clean up its which communication protocol(s) did not start
resources. Otherwise, make sure no other successfully.
programs on your workstation are using the port This error only affects communication protocols
numbers reserved for your service name in the specified by the DB2COMM environment
/etc/services file. The port number is a variable.
component of a socket address.

SQL5047C Insufficient memory to execute

SQL5042N One of the communication this function.
protocol server support processes
failed to start up. Explanation: There is not enough memory
available to execute this function.
Explanation: Due to system call failure, or a
communication subsystem call failure, one of the The function cannot be completed.
communication protocol server support processes User Response: Stop the application. Possible
did not start up successfully. solutions include:
User Response: You can investigate the problem v Terminate other processes.
by either: v Decrease the values of the configuration
v examine the system log records; parameters that define allocation of memory.

Chapter 2. SQL Messages 397

v Ensure that your system has sufficient real and sqlcode: -5051
virtual memory.
sqlstate: 42875

SQL5048N The release level of the database

SQL5055C The content of the database
client is not supported by the
configuration file is not valid.
release level of the database
server. Explanation: The database configuration file for
the database is not valid. The file may have been
Explanation: Database clients can only access
altered by a text editor or a program other than
database servers with a release level which is in
the database manager.
the range of one level lower than the client to
two levels higher than the client. User Response: Recreate the database or restore
it from a backup version.
User Response: One or more of the following:
v Upgrade the client release level to fall within sqlcode: -5055
the range of releases supported by the current sqlstate: 58031
server release level.
v Upgrade the server release level to a level
supported by the current client release level. SQL5060N The configuration parameter
token specified is invalid.

SQL5050C The content of the database Explanation: A token number specified in the
manager configuration file is not sqlfupd structure passed to a Configuration
valid. Services API is not valid. It does not represent
any of the supported configuration parameters.
Explanation: The database manager Alternatively, if an UPDATE was attempted, the
configuration file is not valid. The file may have token specified may be that of an unmodifiable
been altered by a text editor or a program other configuration parameter.
than the database manager.
User Response: Choose a valid token number
The command cannot be processed. from those specified in the description of the
Configuration Services API in the Application
User Response: Reinstall the database manager.
Development Guide. Recode the call to the API,
and rerun the program.
SQL5051N An object qualified by
“<qualifier>” cannot be created in
SQL5061N An invalid pointer to structure
schema “<schema-name>”.
sqlfupd was passed to
Explanation: An object created in a CREATE Configuration Services.
SCHEMA statement is qualified by “<qualifier>”
Explanation: The pointer to structure sqlfupd
which is different from the schema name. All
passed as a parameter to one of the
objects created in a CREATE SCHEMA statement
Configuration Services APIs was invalid. It is
must be either qualified by the schema name
either NULL, or does not point to an allocated
“<schema-name>” or not qualified. Unqualified
block of memory of the size indicated by the
objects are implicitly qualified by the schema
count parameter. See the Application Development
name.
Guide for more information.
The statement cannot be processed.
User Response: Correct the code which invokes
User Response: Explicitly qualify the object in the Configuration Services API, and retry the API
the schema with “<schema-name>” or remove call.
“<qualifier>” from the object name.

398 Message Reference, Volume 2

 The command cannot be processed.
SQL5062N An invalid pointer was passed
within the sqlfupd structure to User Response: Correct the code which invokes
Configuration Services. Configuration Services, and rerun the program.
Explanation: The structure sqlfupd passed as a
parameter to one of the Configuration Services SQL5075N The configuration utility was
APIs contained an invalid pointer. The pointer is interrupted.
either NULL, or does not point to an allocated
block of memory. Each token passed in the Explanation: An interrupt was received by the
structure must have a corresponding pointer to a configuration utility. The user may have pressed
field that is either passed in or out of the API. the interrupt key sequence.
See the Application Development Guide for more The command was not processed. Any requested
information. change is not made.
User Response: Correct the code which invokes User Response: Resubmit the command.
Configuration Services, and rerun the program.

SQL5081N The entry in the database

SQL5065C The nodetype value in database configuration file for the size of
manager configuration file is not the buffer pool (buffpage) is not
valid. in the valid range.
Explanation: The nodetype parameter in the Explanation: The minimum value for the size of
database manager configuration file is not valid. the buffer pool is two times the maximum
The command cannot be processed. number of active processes (maxappls). The
maximum value for the size of the buffer pool is
User Response: Reinstall the database manager. 524288 (number of 4KB pages) and is operating
system dependent. The maximum value under
AIX is 51000 (204000 for DB2 Enterprise -
SQL5066W The database configuration
Extended Edition) (4KB pages). Under HP-UX,
parameter value for token
the value must be between 16 and 150000 (4KB
“<token-name>” has been
pages).
truncated.
The requested change is not made.
Explanation: The database configuration
parameter value is larger than the specified User Response: Resubmit the command with a
token can contain. valid value for the size of the buffer pool.
A new token now represents this database
configuration parameter value and should be SQL5083N The entry in the database
used if the value is larger than can be contained configuration file for the initial
by the old token. log file size (logfile) is not in the
valid range.
User Response: Use the new token for this
database configuration parameter. Explanation: The value for the initial log file
size must be between 12 and (2**32 − 1).
SQL5070N The count parameter in the The requested change is not made.
configuration command is not
valid. It must be greater than 0. User Response: Resubmit the command with a
valid value for the initial log file size.
Explanation: The count value passed as a
parameter to a Configuration Services API must
be greater than 0.

Chapter 2. SQL Messages 399

 The requested change is not made.
SQL5091N The entry in the database
configuration file for the size of User Response: Resubmit the command with a
one log file extension (logext) is valid value for the agent heap size.
not in the valid range.
Explanation: The value for the size of one log SQL5099N The new path to the log
file extension must be between 4 and 256. (newlogpath) in the database
configuration file is not valid.
The requested change is not made.
Explanation: The path to the log file is not valid
User Response: Resubmit the command with a
for one of the following reasons:
valid value for the size of one log file extension.
v The path string is longer than 242 bytes.
v The path does not exist.
SQL5092N The entry in the database
configuration file for the v The first directory in the path has a name in
maximum allowable number of the form SQLNNNNN, where NNNNN is a
log file extensions (logmaxext) is value from 00001 to 99999.
not in the valid range. v A file with the correct name was found in the
specified path, but is not a log file for this
Explanation: The value for the maximum
database.
allowable number of log file extensions must be
between 0 and (2 * 10**6). v The new path to the log is currently being
used by another database.
The requested change is not made.
v The device specified by the new path is not
User Response: Resubmit the command with a big enough to hold the primary log files.
valid value for the maximum allowable number
The requested change is not made.
of log file extensions.
User Response: Resubmit the command with a
valid value for the new log path.
SQL5093N The entry for the database
configuration parameter for the sqlcode: -5099
size of the agent heap is not in
the valid range. sqlstate: 08004

Explanation: The value for the size of the agent

heap must be between 2 and 85.

SQL5100 - SQL5199
segments >= ((number of databases * 5) + 1)
SQL5100N The entry in the database
manager configuration file for the
number of allowed concurrent The requested change is not made.
databases is too large. User Response: Do one of the following:
Explanation: The requested change would cause v Increase the maximum number of segments
(1) the number of allowed concurrent databases allowed for DB2.
to be too large or (2) the number of segments v Decrease the number of allowed concurrent
allowed for DB2 to be too small. databases.
The number of allowed concurrent databases is
restricted by the maximum number of segments
allowed for DB2. The following condition must
always be true:

400 Message Reference, Volume 2

SQL5101N The entries in the database SQL5120N Old and new log parameters
configuration file define log file cannot both be modified at the
parameters (logprimary and same time.
logsecond) that are not in the
Explanation: The user is attempting to modify
valid range.
both the previous log parameters and the new
Explanation: The requested change would cause parameters. The application should only support
the total number of logfiles to be out of range. the parameters of the current release.
The following condition must always be true:
The request is denied.
logprimary + logsecond <= 128
User Response: Modify only the parameters of
The requested change is not made. the current release and retry the command.

User Response: Do one or both of the

following: SQL5121N The entry in the database
configuration file for
v Decrease the number of primary log files.
configuration options is not valid.
v Decrease the number of secondary log files.
Explanation: The value set for database options
(SQLF_DETS) is not valid. Valid settings are
SQL5103N The entry in the database between 0 and 15. The requested change is not
configuration file for the size of made.
the buffer pool (buffpage) is too
small for the maximum number of The requested change is not made.
active applications (maxappls). User Response: Resubmit the command with a
Explanation: The requested change would cause valid database options value.
the maximum number of active applications to
be too large for the size of the buffer pool. The SQL5122N Access to the database was invalid
following condition must always be true: because of a machine dependent
bufferpool_size > check.
(number of active_processes * 2)
Explanation: The database and database
configuration file cannot be accessed because of
The requested change is not made.
copy protection.
User Response: Do one or both of the
The user request is denied.
following:
v Increase the size of the buffer pool. User Response: Return to the original database
and modify the configuration file to turn the
v Decrease the maximum number of active
copy protection off, then create a new backup
processes allowed.
which may be used to restore the database. This
must be done by an individual with SYSADM
SQL5112N The value of the configuration authority. If the original database is no longer
parameter ″<parameter>″ must be available, contact your service representative.
either 0 or 1.
Explanation: The request is not completed SQL5123N Database “<name>” cannot be
because the value given for ″<parameter>″ is configured because an I/O error
invalid. occurred while accessing the log
control file.
User Response: Ensure that the value specified
for ″<parameter>″ is either 0 or 1, then try the Explanation: An error occurred while accessing
request again. SQLOGCTL.LFH for the specified database.

Chapter 2. SQL Messages 401

The requested change is not made.
SQL5131N The value specified for the
User Response: Restore the database from a configuration parameter
backup copy or recreate the database. ″<parameter>″ is not in the valid
range. The valid range is ″-1″, or
from ″<start-of-range>″ to
SQL5126N An attempt was made to modify ″<end-of-range>″.
the database manager
configuration parameter ″<parm>″ Explanation: The request is not done because
which is not valid for a node type the value of ″<parameter>″ is not within the
of ″<node-type-code>″. valid range.

Explanation: The user attempted to modify a User Response: Ensure that the value specified
database manager configuration parameter which for ″<parameter>″ is within the valid range, then
is invalid for the given node type. try the request again.
″<node-type-code″> is defined as follows:
1 Database server with local and remote SQL5132N The configuration parameter is
clients null or too long. The maximum
length is <maximum length>.
2 Client
Explanation: The configuration parameter is not
3 Database server with local clients set or too long.
4 Partitioned Database Server with local User Response: Change the value of the
and remote clients configuration parameter to within the maximum
5 Satellite Database Server with local length given.
clients
SQL5133N The value “<value>” for
The requested change is not made. configuration parameter “<parm>”
User Response: Resubmit the request with a is invalid. The valid set of values
valid parameter for the given nodetype. is “<value_list>”.
Explanation: “<value>” was the the value
SQL5130N The value specified for the specified for the configuration parameter
configuration parameter “<parm>”. This value is not one of the allowable
″<parameter>″ is not in the valid values shown in the “<value_list>”.
range of ″<start-of-range>″ to Consult the Application Development Guide
″<end-of-range>″. (SQLFUPD entry) and the Administration Guide
Explanation: The request is not done because for the meanings of these values.
the value of ″<parameter>″ is not within the User Response: Change the value of the
valid range. configuration parameter to one of the values
User Response: Ensure that the value specified shown in the valid list.
for ″<parameter>″ is within the valid range, then
try the request again. SQL5134N The configuration parameter
tpname contains invalid
characters.
Explanation: One or more characters in the
tpname is not in the valid range. The characters
in the tpname must be one of the following:

402 Message Reference, Volume 2

v A-Z the command or function call.
v a-z
v 0-9 SQL5137N The entry in the database
v $ manager configuration file for the
diagnostic directory path
v #
(diagpath) is invalid.
v @
Explanation: An invalid value was specified for
v . (period)
diagpath. The rules for the diagnostic directory
User Response: Change the tpname and retry path are:
the command or function call. 1. the path must follow the operating system’s
naming conventions
SQL5135N The settings of the maxlocks and 2. the path must exist
maxappls configuration 3. the path must be less than or equal to 215
parameters do not use all of the characters
locklist space.
User Response: Change the diagpath and retry
Explanation: The number of active processes the command or function call.
(maxappls) times the maximum percentage of
lock list space for each application (maxlocks)
must be greater than or equal to 100. That is: SQL5140N The entry in the database
manager configuration parameter
maxappls * maxlocks >= 100
“authentication” must be one of
SERVER, CLIENT, DCS, DCE,
This ensures that all of the allocated locklist KERBEROS, SERVER_ENCRYPT,
space can be used. DCS_ENCRYPT,
User Response: Increase the setting for DCE_SERVER_ENCRYPT, or
maxappls, maxlocks, or both. KRB_SERVER_ENCRYPT.
Explanation: The allowed values for the
SQL5136N The entry in the database configuration parameter ″authentication″ are:
manager configuration file for the v SERVER = 0
default database path (dftdbpath) v CLIENT = 1
is invalid.
v DCS = 2
Explanation: An invalid value was specified by v DCE = 3
dftdbpath. The rules for the default database
path on UNIX-based systems are: v SERVER_ENCRYPT = 4
1. the path must follow the operating system’s v DCS_ENCRYPT = 5
naming conventions v DCE_SERVER_ENCRYPT = 5
2. the path must exist v KERBEROS = 7
3. the path must be less than or equal to 215 v KRB_SERVER_ENCRYPT = 8
characters
The requested change is not made.
The rules for other platforms (such as OS/2,
User Response: Resubmit the command with a
WindowsNT, Windows 95) are:
valid value for ″authentication″.
1. the path must be a drive letter
2. the drive must exist
User Response: Change the dftdbpath and retry

Chapter 2. SQL Messages 403

 for ″<parameter>″ is within the valid range, then
SQL5141N The configuration parameter
try the request again.
avg_appls is out of range. The
valid range is from 1 to the value
of maxappls. SQL5151N The value specified for the
configuration parameter
Explanation: The allowable range for avg_appls
″<parameter>″ is less than the
is from 1 to the value of maxappls.
minimum allowable value of
The requested change is not made. ″<minimum value>″ and is not -1.
User Response: One or more of the following: Explanation: The request is not completed
v Change the value of avg_appls to a value in the because the value given for ″<parameter>″ is
valid range. invalid. Except for an allowable value of -1,
″<parameter>″ may not be less than ″<minimum
v Increase the value of maxappls to a higher
value>″.
value, then set avg_appls again.
User Response: Ensure that the value specified
for ″<parameter>″ is within the valid range, then
SQL5142N The configuration parameter
try the request again.
agentpri is not in the valid range.
Explanation: The valid values for agentpri are
SQL5152N The value specified for the
-1, or a three digit number of which the first
configuration parameter
digit is a priority class ranging from 2 to 4 and
″<parameter>″ is greater than the
the last two digits are a priority level within the
maximum allowable value of
class in the range of 00 to 31. The priority class is
″<maximum value>″.
defined as follows:
Explanation: The request is not completed
2 REGULAR
because the value given for ″<parameter>″ is too
3 TIMECRITICAL high. ″<parameter>″ may not be greater than
″<maximum value>″
4 FOREGROUNDSERVER
User Response: Ensure that the value specified
For example, the number 304 would correspond for ″<parameter>″ is within the valid range, then
to a priority class of 3 (TIMECRITICAL), with a try the request again.
priority level of 4.
User Response: Change the value of the SQL5153N The update cannot be completed
configuration parameter to a value within the because the following relationship
valid range. would be violated: ″<condition>″
Explanation: A valid configuration file must
SQL5150N The value specified for the maintain the following relationship:
configuration parameter ″<condition>″.
″<parameter>″ is less than the
minimum allowable value of The update request could not be completed
″<minimum value>″. because the resulting configuration would violate
that relationship.
Explanation: The request is not completed
because the value given for ″<parameter>″ is too User Response: Resubmit the request, ensuring
low. ″<parameter>″ may not be less than that the relationship is satisfied.
″<minimum value>″
User Response: Ensure that the value specified

404 Message Reference, Volume 2

SQL5154N The requested combination of SQL5180N DB2 is unable to read the
configuration values for federation configuration file
″authentication″ and “<file-name>”.
″<parameter>″ is not allowed.
Explanation: The federated configuration file
Explanation: The database manager could not be found, or it could not be opened for
configuration parameter ″authentication″ must reading.
have the value ″CLIENT″ if the value of
User Response: Specify the federation
″<parameter>″ is non-default.
configuration file in the DB2_DJ_INI registry
The requested change is not made. variable. Be sure that the file exists and is
readable.
User Response: Resubmit the command with a
valid combination of configuration parameter
values. SQL5181N The format of line
“<line-number>” in the federation
configuration file “<file-name>”
SQL5155W The update completed
is invalid.
successfully. The current value of
SORTHEAP may adversely affect Explanation: The specified line does not have
performance. the proper format. The format should be:
<variable-name> = <value>.
Explanation: The value of SORTHEAP is
currently greater than half the value of the User Response: Put the specified line in the
database manager configuration parameter format described in the preceding paragraph.
SHEAPTHRES. This may cause performance to
be less than optimal.
SQL5182N A required environment variable,
User Response: Increase the value of the “<variable-name>”, has not been
database manager configuration parameter set.
SHEAPTHRES and/or decrease the value of
Explanation: In the federated configuration file,
SORTHEAP so that SHEAPTHRES is at least
the environment variable “<variable-name>” is
twice as large as SORTHEAP.
unlisted, or it is listed but has no value.
A larger ratio is desirable in most cases. See the
User Response: Consult the “Administration
Adminstration Guide for recommendations on
Guide” to find out what values can be assigned
configuration parameter tuning.
to the environment variable “<variable-name>”.
Then use the db2set command to set this variable
SQL5156N The value of the database to the value that you want it to have.
manager configuration parameter
″trust_allclnts″ must be one of
SQL5185N Pass-through to “<server-type>”
NO, YES, or DRDAONLY.
data sources is not supported.
Explanation: The allowed values for the
Explanation: The Pass-Through facility cannot
configuration parameter ″trust_allclnts″ are:
be used to access “<server-type>” data sources.
v NO = 0
User Response: None required.
v YES = 1
v DRDAONLY = 2 sqlcode: -5185

The requested change is not made. sqlstate: 428EV

User Response: Resubmit the command with a

valid value for ″trust_allclnts″.

Chapter 2. SQL Messages 405

SQL6000 - SQL6099
Manager or DB2 may not be installed or
SQL6000N DB2 Conversion of QMF Data.
configured correctly.
Explanation: This is the normal termination
The command cannot be processed.
message.
User Response: Ensure that Communications
User Response: No action is required.
Manager has been installed and the appropriate
host communications session is active. Retry the
SQL6001N The prefix for the filename was command after checking for other errors. If the
not specified. problem persists, contact your Communications
Manager system administrator.
Explanation: The user executed a module of the
SQLQMF facility directly rather than using the
SQLQMF facility command. SQL6005N An error occurred while reading
the downloaded QMF file.
The command cannot be processed.
Explanation: One of the following conditions
User Response: Use the provided SQLQMF
was encountered:
facility command.
v The file could not be opened.
v The end of file was encountered prematurely.
SQL6002N Communications Manager
encountered a download error. v There was an I/O error while reading the file.

Explanation: Communications Manager The command cannot be processed.

encountered an error during the download of the User Response: Review the Communications
host file. Manager message log. Retry the command. If the
The command cannot be processed. error continues, contact your Communications
Manager system administrator.
User Response: Review the Communications
Manager message log.
SQL6006N An error occurred while writing to
an output file.
SQL6003N The file exported from QMF
contains rows that are too long. Explanation: One of the following conditions
The row length is “<number>”. was encountered:
v Not enough space exists on the C: drive to
Explanation: The computed row size (the sum
write the data.
of the computed column sizes) exceeds the
maximum of 7000 bytes. v An output file could not be opened.
v An I/O error occurred while writing the file.
The command cannot be processed.
v An I/O error occurred while closing the file.
User Response: Return to your QMF host
v The file is in use by another OS/2 process.
session and run a query with fewer data
columns selected. EXPORT the data again and Federated system users: there isn’t enough space
then try the SQLQMF facility command again. to hold the db2djlink output. Additional space is
required for the temporary files that db2djlink
creates and uses.
SQL6004N “<function>” returned the
unexpected return code “<code>”.
The command cannot be processed.
Explanation: An unexpected error occurred
User Response: Check for sufficient disk space
during processing. The Communications

406 Message Reference, Volume 2

on the C: drive. Retry the command.
SQL6009N The file exported from QMF
Federated system users: increase the size of the contains Column “<name>” with
file system where the federated server is a width “<width>” that is too
installed. To estimate the amount of free space long. The maximum column
db2djlink needs on an AIX operating system, width is 4000 bytes.
enter:
Explanation: The downloaded QMF file has a
ls -e /install_directory/lib/libdb2euni.a column width greater than 4000 bytes.

This command returns the number of bytes used The command cannot be processed.
by the listed file. Multiply that number by 3. The User Response: Return to your QMF host
result is an estimate of how much free space is session, rerun the QMF query without the named
needed on the file system. Increase the size of column, and export the data again. Then run the
the file system as necessary and retry the SQLQMF facility command again.
command.

SQL6010N The downloaded QMF file has

SQL6007N The decimal number in row more than 255 data columns.
“<row>”, column “<column>”
cannot be converted to ASCII. Explanation: The file being processed has more
than 255 data columns.
Explanation: The indicated decimal field could
not be converted. The command cannot be processed.

The command cannot be processed. User Response: Return to your QMF host
session and rerun a query, selecting 255 or fewer
User Response: Verify that the host column data columns. EXPORT the data again and then
data type is DECIMAL. Retry the QMF EXPORT run the SQLQMF facility command again.
and then try the SQLQMF facility command
again. If the error continues, rerun the QMF
query without the named column. SQL6011N The data type “<number>”
(“<type-text>”) of column
“<name>” (positioned at column
SQL6008N The file specified in the command “<number>”) cannot be processed.
is not in QMF data format.
Explanation: The QMF file contains a column
Explanation: The file specified by the filename with data type that is not supported.
parameter is not in the expected QMF format.
The SQLQMF facility does NOT support the
The command cannot be processed. following data types:
User Response: Verify that you have typed the v LONG VARCHAR
name correctly. If correct, return to your QMF v LONG VARGRAPHIC.
host session and issue the command EXPORT
DATA TO filename again. Be sure to export using Only the SQLQMF facility SQLQMFDB supports
the QMF data format. graphic data types.

The command cannot be processed.

User Response: Return to your QMF host
session and rerun the query without selecting the
named column. Then run the SQLQMF facility
command again.

Chapter 2. SQL Messages 407

SQL6012N Too many parameters were SQL6016N Too many operands for the
specified for the command. System/370 filename “<name>”.
Explanation: Too many parameters were Explanation: If the host is a VM System, the
specified with the command. host file name contains more than three
space-separate tokens. If the host is an MVS
The command cannot be processed.
System, the host filename contains embedded
User Response: Retry the command with the blanks.
correct number of parameters.
The command cannot be processed.
User Response: Retry the command using a
SQL6013N Host filename “<host filename>”
different keyword value.
is either too long or does not
begin with an alphabetic
character. SQL6017N More information may be
contained in the Import message
Explanation: The host filename does not begin
log “<name>”.
with an alphabetic character; or, if the host is a
VM System, the host filename, filetype, or filemode Explanation: The database IMPORT operation
are too long. terminated with warning or error messages.
The command cannot be processed. The command has left its work files allocated.
User Response: Retry the command with a User Response: Use the message preceding this
correct host filename syntax. message and the IMPORT message log, if it
exists, to decide if the IMPORT was successful
and to determine corrective action. If the import
SQL6014N Invalid command syntax, colon
was successful, erase the DEL, CRE, COL, and
(’:’) should follow a keyword.
IML files.
Explanation: Keyword parameters with
operands require the keyword to be immediately
SQL6018N No S/370 filename was specified.
followed by a “:” character and then the
operand. Explanation: The S/370 filename is a required
parameter.
The command cannot be processed.
The command cannot be processed.
User Response: Verify the command syntax and
retry the command. User Response: Retry the command with a host
filename.
SQL6015N The keyword is not recognized.
SQL6019N Communications short session ID
Explanation: The keyword parameter indicator
“<ID>” is either too long or is
(“/”) was followed by a value that is not a
invalid.
keyword.
Explanation: The value provided for the
The command cannot be processed.
communications short session ID is either longer
User Response: Retry the command using a than one byte or is not alphabetic.
different keyword value.
The command cannot be processed.
User Response: Retry the command with a
valid value.

408 Message Reference, Volume 2

SQL6020N An import option was specified SQL6024N Table or index <name> is not
without also providing a database defined on node <node-number>.
name.
Explanation: The application is connected to
Explanation: No database name was provided node ″<node-number>″, and the table or index
and an import option was specified. ″<name>″ is not defined.
The command has terminated. The cause is one of the following:
User Response: Retry the command and v The node to which the application is
include a database name. connected is not a member of the nodegroup
in which the table or index was created.
v The node is not in use by that nodegroup.
SQL6021N Data was successfully imported.
The utility stops processing.
Explanation: This is a normal ending message
when the SQLQMF facility imports data to a User Response: Connect the application to a
database. node on which the table or index is defined.
Determine the nodegroup in which the table was
User Response: No action is required.
created and obtain the list of nodes in the
nodegroup by selecting the appropriate rows
SQL6022N System database directory is not from the NODEGROUPDEF catalog view. The
shared by all nodes. nodes whose IN_USE value is set to Y are the
ones on which the table or index is defined.
Explanation: All nodes should be accessing one
physical copy of the system database directory.
SQL6025N Database backed up on node
The command cannot be processed. ″<node1>″ cannot be restored to
User Response: Ensure that all nodes are node ″<node2>″.
accessing the system database directory that Explanation: The backup image used for the
resides in the sqllib directory, then try the restore is a backup of the database on a different
request again. node.
User Response: Ensure that you have the
SQL6023N The user does not have the correct backup image for the node, then try the
authority to run the Get Table request again.
Partitioning Information utility on
table ″<name>″.
SQL6026N Database with catalog node
Explanation: The user attempted to retrieve ″<node1>″ cannot be restored to a
partitioning information on the specified table database with catalog node
without the appropriate authorization (either the ″<node2>″.
SYSADM or DBADM authority or the
CONTROL or SELECT privilege on the table). Explanation: The catalog node can exist on only
one node and there is a discrepancy between the
The utility stops processing. backup image and the node being restored to.
User Response: Do not attempt to call the Get This can occur in the following cases:
Table Partitioning Information utility without v The backup image specified catalog node
appropriate authorization. Contact your system ″<node1>″ and the restore was attempted on
administrator for assistance. an existing database whose catalog node is
node ″<node2>″.
v The restore was attempted to a new database
and the catalog node has not been restored

Chapter 2. SQL Messages 409

 first. (Restore the catalog node first to create (3) Cannot open the profile file.
the database on all nodes).
(4) The nodenum parameter value is not
User Response: Verify that the correct backup defined in the db2nodes.cfg file in the
image is being restored. sqllib directory.
If you are restoring to an existing database and (5) The nodenum parameter must be
want to change the catalog node to ″<node2>″, specified when a command option is
the existing database must be dropped first. specified.
If you are restoring to a new database, restore (6) The port parameter value is not valid.
the catalog node ″<node1>″ first.
(7) The new couple hostname/port is not
unique.
SQL6027N The path ″<path>″ for the
(8) The FORCE option cannot be specified
database directory is not valid.
when the NODENUM option is
Explanation: The path ″<path>″ specified for specified.
either the CREATE DATABASE or the CATALOG
(9) The hostname and port parameters must
DATABASE command starts with the character
be specified when using the ADDNODE
’.’ or contains the character string ’/.’.
option.
The command cannot be processed.
(10) Cannot update the db2nodes.cfg file in
User Response: Ensure that the specified path the sqllib directory for the ADDNODE
is a fully qualified path, does not start with the or RESTART option.
character ’.’, and does not contain the character
(11) The hostname parameter value is not
string ’/.’. Then try the request again.
valid.
(12) The pointer to the sqledbstrtopt or
SQL6028N Catalog database failed because
sqledbstopopt structure is not valid.
database ″<dbname>″ was not
found in the local database (13) No port value is defined for your DB2
directory. instance id (/etc/services file on
UNIX-based systems).
Explanation: When cataloguing a local database
into the system database directory, the (14) The port value is not in the valid port
command/API has to be issued from a node on range defined for your DB2 instance id
the server where the database resides. (/etc/services file on UNIX-based
systems).
User Response: Reissue the command/API
from a node where the database resides. (15) A hostname value has no corresponding
port 0 defined in the db2nodes.cfg file
in the sqllib directory.
SQL6030N START or STOP DATABASE
MANAGER failed. Reason code (16) The value specified for the command or
″<reason-code>″. option parameter is not valid.
Explanation: The reason code indicates the (17) The DROP option cannot be specified
error. The statement cannot be processed. when the NODENUM option is not
specified.
(1) Cannot access the sqllib directory of the
instance. (18) The value specified for the callerac
parameter is not valid.
(2) The full path name added to the profile
filename is too long. (19) Unable to create the UNIX socket

410 Message Reference, Volume 2

 directory and 999. If a value is not specified, the
/tmp/db2_<ver>_<rel>/$DB2INSTANCE. port value defaults to 0.
(20) The node number specified with the (7) Ensure that the new couple
ADDNODE option already exists in the hostname/port is not already defined in
db2nodes.cfg file or the node has been the db2nodes.cfg file in the sqllib
already been added since the last stop directory.
database manager command was issued.
(8) Do not specify the FORCE option when
(21) The tablespace type specified with the you specify the NODENUM option.
ADDNODE option is not valid.
(9) Ensure that the hostname and the port
(22) The tablespace node specified with the values are specified when you specify
ADDNODE option is out of range. the ADDNODE option.
(23) The computer name parameter must be (10) Ensure that the $DB2INSTANCE
specified for the ADDNODE option. username has write access to the sqllib
directory of the instance, that there is
(24) The user name parameter must be
sufficient disk space, and the file exists.
specified for the ADDNODE option.
(11) Ensure that the specified hostname is
(25) The computer name is not valid.
defined on the system.
(26) The user name is not valid.
(12) Ensure that the pointer is not NULL and
(27) The password is not valid. points to the sqledbstrtopt for the
sqlepstr() API, or to the sqledbstopopt
(28) The password is expired. structure for the sqlepstp() API.
(29) The user account specified is either (13) Ensure that the services file
disabled, expired, or restricted. (/etc/services on UNIX-based systems)
User Response: The action corresponding to the contains an entry for your DB2 instance
reason code is: id.

(1) Ensure that the $DB2INSTANCE userid (14) Ensure that you only use port values
has the required permissions to access that are specified in the services file
the sqllib directory of the instance. (/etc/services file on UNIX-based
systems) for your instance.
(2) Change the profile name to a shorter
name so that the total length of the fully (15) Ensure that all the hostname values
qualified path added to the profile name have a port 0 defined in the
length is smaller than the db2nodes.cfg file in the sqllib directory
SQL_PROFILE_SZ defined in the file including the restart option parameters.
sqlenv.h. (16) Ensure that the value specified for the
(3) Ensure that the profile file exists. option parameter is within the valid
range.
(4) Ensure that the nodenum value
specified is defined in the db2nodes.cfg (17) Specify the NODENUM option when
file in the sqllib directory and is you specify the DROP option.
between 0 and 999. (18) Ensure that the value specified for the
(5) Resubmit the command with the callerac parameter is within the valid
nodenum parameter specified. range.

(6) Ensure that the port value is between 0 (19) Check the permission of the /tmp
filesystem to make sure all intermediate

Chapter 2. SQL Messages 411

 directories of (2) The full path name added to the
/tmp/db2_<ver>_<rel>/$DB2INSTANCE db2nodes.cfg filename is too long.
can be created.
(3) Cannot open the db2nodes.cfg file in the
(20) Ensure that the correct node number is sqllib directory.
being specified. You must stop the
(4) A syntax error exists at line ″<line>″ of
database manager to update the
the db2nodes.cfg file in the sqllib
db2nodes.cfg file with nodes that have
directory.
been added to the system since the
previous stop database manager (5) The nodenum value at line ″<line>″ of
command. the db2nodes.cfg file in the sqllib
directory is not valid.
(21) Ensure that the value specified for the
tablespace type is within the valid (6) The nodenum value at line ″<line>″ of
range. the db2nodes.cfg file in the sqllib
directory is out of sequence.
(22) Ensure that the tablespace node value
specified is defined in the db2nodes.cfg (7) The nodenum value at line ″<line>″ of
and is between 0 and 999. the db2nodes.cfg file in the sqllib
directory is not unique.
(23) Specify the computer name of the
system on which the new node is (8) The port value at line ″<line>″ of the
created using the COMPUTER option. db2nodes.cfg file in the sqllib directory
is not valid.
(24) Specify a valid domain account user
name and password for the new node (9) The hostname/port couple at line
using the USER and PASSWORD ″<line>″ of the db2nodes.cfg file in the
options. sqllib directory is not unique.
(25) Resubmit the command with a valid (10) The hostname at line ″<line>″ of the
computer name. db2nodes.cfg file in the sqllib directory
is not valid.
(26) Resubmit the command with a valid
user name. (11) The port value at line ″<line>″ of the
db2nodes.cfg file in the sqllib directory
(27) Resubmit the command with a valid
is not defined for your DB2 instance id
password.
in the services file (/etc/services on
(28) Change/update the account password UNIX-based systems).
and resubmit the command.
(12) The port value at line ″<line>″ of the
(29) Resubmit the command with a valid db2nodes.cfg file in the sqllib directory
user account. is not in the valid port range defined for
your DB2 instance id in the services file
(/etc/services on UNIX-based systems).
SQL6031N Error in the db2nodes.cfg file at
line number ″<line>″. Reason (13) The hostname value at line ″<line>″ of
code ″<reason code>″. the db2nodes.cfg file in the sqllib
directory has no corresponding port 0.
Explanation: The statement cannot be processed
because of a problem with the db2nodes.cfg file, (14) A db2nodes.cfg file with more than one
as indicated by the following reason codes: entry exists, but the database manager
configuration is not MPP.
(1) Cannot access the sqllib directory of the
instance.

412 Message Reference, Volume 2

(15) The netname at line “<line>” of the (14) Perform one of the following actions:
db2nodes.cfg file in the sqllib directory v Remove the db2nodes.cfg file.
is not valid.
v Alter the db2nodes.cfg file to contain
User Response: The action corresponding to the exactly one entry.
reason code is: v Install the DB2 Enterprise - Extended
(1) Ensure that the $DB2INSTANCE userid Edition server.
has the required permissions to access (15) Ensure the netname value defined in
the sqllib directory of the instance. db2nodes.cfg at line “<line>” is both
(2) Make the instance home directory path defined on the system and operational.
name shorter.
(3) Ensure that the db2nodes.cfg file exists SQL6032W Start command processing was
in the sqllib directory and is not empty. attempted on ″<total_number>″
node(s). ″<number_started>″
(4) Ensure that at least 2 values are defined node(s) were successfully started.
per line in the db2nodes.cfg file and that ″<number_already_started>″
the file does not contain blank lines. node(s) were already started.
(5) Ensure that the nodenum value defined ″<number_not_started>″ node(s)
in the db2nodes.cfg file is between 0 could not be started.
and 999. Explanation: The database manager did not
(6) Ensure that all the nodenum values start successfully on all the nodes. Not all of the
defined in the db2nodes.cfg file are in data in the database may be accessible. Data on
ascending order. the nodes that started successfully or were
already running is accessible.
(7) Ensure that each nodenum value
defined in the db2nodes.cfg file is User Response: Check the log file created in the
unique. log directory of the sqllib directory for the
instance to see which nodes did not start.
(8) Ensure that the port value is between 0
and 999.
SQL6033W Stop command processing was
(9) Ensure that the new couple attempted on ″<total_number>″
hostname/port is not already defined in node(s). ″<number_stopped>″
the db2nodes.cfg file. node(s) were successfully stopped.
″<number_already_stopped>″
(10) Ensure the hostname value defined in
node(s) were already stopped.
db2nodes.cfg at line ″<line>″ is both
″<number_not_stopped>″ node(s)
defined on the system and operational.
could not be stopped.
(11) Ensure that the services file
Explanation: The database manager did not
(/etc/services on UNIX-based systems)
stop successfully on all the nodes. The database
contains an entry for your DB2 instance
manager is still active on the nodes that could
id.
not be stopped.
(12) Ensure that you only use port values
User Response: Check the log file created in the
that are specified in the services file
log directory of the sqllib directory for the
(/etc/services file on UNIX-based
instance to see which nodes did not stop.
systems) for your instance.
(13) Ensure that the port value 0 has been
defined for the corresponding hostname
in the db2nodes.cfg file.

Chapter 2. SQL Messages 413

SQL6034W Node “<node>” is not being used SQL6037N START or STOP DATABASE
by any databases. MANAGER timeout value was
reached.
Explanation: During DROP NODE VERIFY
processing, all databases are scanned to verify Explanation: The start_stop_time value defined
that this node does not exist in the nodegroups in the database manager configuration was
of any database, and that no event monitor is reached at the node. This value specifies the
defined on this node. time, in minutes, in which a node must respond
to a Start Database Manager, Stop Database
User Response: This node can now be removed
Manager or Add Node command.
from the system by issuing the ’db2stop drop
nodenum <node>’ command. User Response: Do the following:
v Check the First Failure Service Log
SQL6035W Node “<node>” is being used by (db2diag.log) to see if an error message has
database “<database>”. been logged for the node which timed out. If
an error has not been logged, and timeouts
Explanation: During DROP NODE VERIFY persist, you may need to increase the
processing, databases are scanned to verify that start_stop_time value specified in the database
this node does not exist in the nodegroups of manager configuration file.
any database, and that no event monitor is
v If the timeout occurred during a Start
defined on this node. Node “<node>” is being
Database Manager command, you should issue
used by database “<database>” and cannot be
a Stop Database Manager command for all
dropped.
nodes which timed out.
User Response: You must do the following v If the timeout occurred during a Stop Database
before dropping the node: Manager command, you should issue a Stop
1. Redistribute the data to remove it from the Database Manager command for all nodes
node using the REDISTRIBUTE which timed out or for all nodes. Any node
NODEGROUP command. Use either the which is already stopped will return with a
DROP NODE option of the REDISTRIBUTE message stating that the node is stopped.
NODEGROUP command or the ALTER
NODEGROUP statement to drop the node
SQL6038N No partitioning key is defined.
from the nodegroup. This must be done for
all nodegroups in which the node to be Explanation: The user attempted to use the Get
dropped is a member. Row Partitioning Information utility without
2. Drop any event monitors that are defined on specifying a partitioning key.
the node. The utility stops processing.
3. Issue the ’db2stop drop nodenum <node>’
User Response: Ensure that you specify a
command to drop the node.
partitioning key, then try the request again.

SQL6036N START or STOP DATABASE

SQL6039N Partitioning column
MANAGER command is already
″<column-number>″ is currently
in progress.
defined as not nullable.
Explanation: A START DATABASE MANAGER
Explanation: An attempt was made to assign a
or a STOP DATABASE MANAGER command is
null value to partitioning column
already in progress on the system.
″<column-number>″, which is not nullable.
User Response: Wait for the command in
The utility stops processing.
progress to complete, then try the request again.

414 Message Reference, Volume 2

User Response: Assign a non-null value or sqlstate: 57011
change the type of the partitioning column to be
nullable.
SQL6043C No FCM request blocks are
available.
SQL6040C No FCM buffers are available.
Explanation: No FCM request block is available.
Explanation: No FCM buffer is available.
The statement cannot be processed.
The statement cannot be processed.
User Response: Try the request again.
User Response: Try the request again.
If the error persists, increase the number of FCM
If the error persists, increase the number of FCM request blocks (fcm_num_rqb) specified in the
buffers (fcm_num_buffers) specified in the database manager configuration file, then try the
database manager configuration file, then try the request again.
request again.
sqlcode: -6043
sqlcode: -6040
sqlstate: 57011
sqlstate: 57011
SQL6044N The syntax of the string
SQL6041C No FCM connection entries are representation ″<string>″ with
available. value of datatype
″<datatype-value>″ and length
Explanation: No FCM connection entry is
″<length>″ is not correct.
available.
Explanation: The specified string cannot be
The statement cannot be processed.
recognized as the target datatype. (The
User Response: Try the request again. Application Development Guide contains
information on datatypes.) Either the syntax is
If the error persists, increase the number of FCM not valid or the value is out of range.
connection entries (fcm_num_connect) specified in
the database manager configuration file, then try The utility stops processing.
the request again.
User Response: Ensure that the string
sqlcode: -6041 representation or the datatype is correct, then try
the request again.
sqlstate: 57011

SQL6045N The datatype ″<datatype-value>″

SQL6042C No FCM message anchors are of length ″<datatype-length>″ is
available. not supported.
Explanation: No FCM message anchor is Explanation: The datatype and data length are
available. not supported for a partitioning key.
The statement cannot be processed. The utility stops processing.
User Response: Try the request again. User Response: See the Administration Guide for
If the error persists, increase the number of FCM information about datatypes. See the API
message anchors (fcm_num_anchors) specified in Reference for information about the Get Row
the database manager configuration file, then try Partitioning Information API.
the request again.
sqlcode: -6042

Chapter 2. SQL Messages 415

 v Ensure all the DB2 Enterprise - Extended
SQL6046N Specified DROP NODE action is
Edition environment variables are defined in
not valid.
the profile file.
Explanation: The value specified for the action v Ensure the profile file is written in the Korn
parameter of the DROP NODE command is not Shell script format.
valid. Only the verify mode is supported for the
v Ensure that all the host names defined in the
DROP NODE command. The parameter must be
db2nodes.cfg file in the sqllib directory are
set to the value SQL_DROPNODE_VERIFY.
defined on the network and are running.
The command cannot be processed.
User Response: Ensure that the action is set to SQL6049N The log control file for database
SQL_DROPNODE_VERIFY, then try the request ″<name>″ could not be found on
again. node(s) ″<node-list>″.
Explanation: The SQLOGCTL.LFH file for the
SQL6047N Nodegroup cannot be database is not in the database directory on the
redistributed because table specified node(s).
“<name>” does not have a
The database was not started.
partitioning key.
If ″,...″ is displayed at the end of the node list,
Explanation: At least one table in the
see the syslog file for the complete list of nodes.
single-node nodegroup does not have a
partitioning key. All tables in the single-node User Response: Either restore the database from
nodegroup must have a partitioning key before a backup on the specified node(s), or re-create
the nodegroup can be redistributed to a the database.
multiple-node nodegroup.
The operation was not performed. SQL6050N An I/O error occurred while
accessing the log control file for
User Response: Use the ALTER TABLE
database ″<name>″ on node(s)
command to specify partitioning keys for tables
″<node-list>″.
that do not have one. Then try the request again.
Explanation: An error occurred while accessing
the SQLOGCTL.LFH file for the database on the
SQL6048N A communication error occurred
specified node(s).
during START or STOP
DATABASE MANAGER The database cannot be used.
processing.
If ″,...″ is displayed at the end of the node list,
Explanation: A TCP/IP communication error see the syslog file for the complete list of nodes.
occurred while the START or STOP DATABASE
MANAGER command was trying to establish User Response: Either restore the database from
connection with all the nodes defined in the a backup on the specified node(s), or re-create
sqllib/db2nodes.cfg file. the database.

User Response: Do the following:

SQL6051N Database ″<name>″ is not
v Ensure that the node has the proper configured for roll-forward
authorization defined in the .rhosts or the recovery on node(s) ″<node-list>″.
host.equiv files.
v Ensure that the application is not using more Explanation: The specified database is not
than (500 + (1995 - 2 * configured for roll-forward recovery on the
total_number_of_nodes)) file descriptors at the specified node(s).
same time. The database is not rolled forward on all nodes.

416 Message Reference, Volume 2

If ″,...″ is displayed at the end of the node list, (5) The sum of all the values in the
see the syslog file for the complete list of nodes. distribution file is greater than
4,294,967,295.
User Response: Ensure that recovery is required
on the specified node(s), then restore the most (6) The specified target partition map
recent backup version of the database on these contains a node number that is not
nodes. defined in SYSCAT.NODEGROUPDEF
for the specified nodegroup.
SQL6052N Cannot roll forward database User Response: The action corresponding to the
″<name>″ because it is not in reason code is:
roll-forward pending state on
(1) Ensure that the partitioning map file
node(s) ″<node list>″.
contains only a single value (if the
Explanation: The specified database is not in resultant nodegroup is a single-node
the roll-forward pending state on the specified nodegroup) or exactly 4,096 values (if
node(s). This may be because the database has the resultant nodegroup is a multinode
not been restored, or was restored with the nodegroup).
WITHOUT ROLLING FORWARD option, or
(2) Ensure that the distribution file contains
roll-forward recovery is complete on these nodes.
exactly 4,096 values, one per hash
The database is not rolled forward. partition.
If ″,...″ is displayed at the end of the node list, (3) Ensure that the values in the
see the syslog file for the complete list of nodes. distribution file are integers greater than
or equal to 0, and that the sum of all the
User Response: Do the following:
distribution values is less than or equal
1. Ensure that recovery is required on the to 4,294,967,295.
specified node(s).
(4) Ensure that the node numbers are in the
2. Restore a backup version of the database on
range of greater than or equal to 0 and
these nodes.
less than or equal to 999.
3. Issue the ROLLFORWARD DATABASE
command. (5) Ensure that the sum of all the
distribution values for the 4,096
partitions is less than or equal to
SQL6053N Error exists in file ″<file>″. 4,294,967,295.
Reason code = ″<reason-code>″.
(6) Either issue ALTER NODEGROUP to
Explanation: There is an error in the specified add the missing node(s) or change the
file as indicated by the reason code: partitioning map file to exclude the
(1) The number of values in the node(s) not defined in
partitioning map file is not 1 or 4,096. sysibm.sysnodegroupdef.

(2) The number of values in the distribution

file is not 4,096. SQL6054N The archive file ″<name>″ is not a
valid log file for the database
(3) The data in the distribution file is not in ″<name>″ on node
a valid format. ″<node-number>″.
(4) The node number in the partitioning Explanation: An archive log file exists in the log
map is not between 0 and 999. directory on the specified node, but it is not
valid.

Chapter 2. SQL Messages 417

The ROLLFORWARD DATABASE processing (5) No data redistribution is performed
stops. because the data in the nodegroup is
already distributed as specified.
User Response: To determine the correct
archive log file, issue the ROLLFORWARD (6) The REDISTRIBUTE NODEGROUP
DATABASE command with the QUERY STATUS command was not submitted from the
option. Move the correct archive log file to the catalog node.
database log directory or, if the database is in a
(7) The REDISTRIBUTE NODEGROUP
consistent state, change the log path to point to
command is not available nor applicable
the correct archive file and issue the
in this non-partitioned version of the
ROLLFORWARD DATABASE command again.
product.
(8) Redistribution is not allowed if there are
SQL6055N The archive file ″<name>″ does
user temporary table spaces in the
not belong to database ″<name>″
nodegroup with existing declared
on node ″<node-number>″.
temporary tables.
Explanation: An archive log file in the log
User Response: The action corresponding to the
directory on the specified node does not belong
reason code is:
to the specified database.
(1) Do not drop all the nodes of the
The ROLLFORWARD DATABASE processing
nodegroup during redistribution.
stops.
(2) Identify why the previous redistribution
User Response: To determine the correct
failed and take the required corrective
archive log file, issue the ROLLFORWARD
action. Submit the REDISTRIBUTE
DATABASE command with the QUERY STATUS
NODEGROUP command using either
option. Move the correct archive log file to the
the CONTINUE or ROLLBACK option.
database log directory or, if the database is in a
CONTINUE will complete the
consistent state, change the log path to point to
previously aborted redistribution
the correct archive file and issue the
operation and ROLLBACK will undo
ROLLFORWARD DATABASE command again.
the effects of the previously aborted
operation.
SQL6056N Nodegroup cannot be
(3) Issue the next REDISTRIBUTION
redistributed. Reason code =
NODEGROUP command after the
″<reason-code>″.
current one completes.
Explanation: The operation cannot be executed.
(4) You cannot invoke the CONTINUE or
The reason code indicates the error.
ROLLBACK option on a nodegroup that
(1) The nodegroup specification is not legal. is not associated with a failed
The resulting nodegroup after redistribution operation.
redistribution would not contain any
(5) Try using a different target partitioning
nodes.
map or distribution file. Otherwise,
(2) A previous redistribution operation did redistribution is not necessary.
not complete successfully.
(6) Issue the command again from the
(3) A redistribution operation is already in catalog node.
progress.
(7) Do not issue the REDISTRIBUTE
(4) There is no previously aborted NODEGROUP command using this
redistribution command to CONTINUE version of the product.
or ROLLBACK.
(8) Request redistribution again when there

418 Message Reference, Volume 2

 are no declared temporary tables using
SQL6059N The point-in-time passed to the
the user temporary table spaces in the
Rollforward utility must be
nodegroup.
greater than or equal to
″<timestamp>″, because database
SQL6057N Archive file ″<name>″ is not ″<name>″ on node(s)
associated with the database ″<node-list>″ contains information
″<name>″ that was restored, or later than the specified time.
with the log file previously
Explanation: An advanced virtual timestamp is
processed on node
in the database backup.
″<node-number>″.
If ″,...″ is displayed at the end of the node list,
Explanation: An archive log file is found in the
see the syslog file for the complete list of nodes.
log directory on the specified node, but does not
belong to the specified database. User Response: Do one of the following:
The ROLLFORWARD DATABASE processing v Issue the command again with a point-in-time
stops. that is greater than or equal to ″<timestamp>″.
v Restore an earlier backup on node(s), then
User Response: To determine the correct
issue the ROLLFORWARD DATABASE
archive log file, issue the ROLLFORWARD
command again.
DATABASE command with the QUERY STATUS
option. Move the correct archive log file to the
database log directory or, if the database is in a SQL6061N Roll-forward recovery on database
consistent state, change the log path to point to ″<name>″ cannot reach the
the correct archive file and issue the specified stop point (end-of-log or
ROLLFORWARD DATABASE command again. point-in-time) because of missing
log file(s) on node(s)
″<node-list>″.
SQL6058N Roll-forward recovery stopped
because of error ″<error>″ while Explanation: The Rollforward Database utility
retrieving log file ″<name>″ for cannot find the necessary log file(s) in the
database ″<name>″ on node logpath.
″<node-number>″.
User Response: Do one of the following:
Explanation: Roll-forward processing invokes v Use the ROLLFORWARD DATABASE
the db2uexit to retrieve the log file for the command with the QUERY STATUS option to
database on the specified node. The error may determine which log files are missing. When
have occurred in the db2uexit. you find the log files, put them in the log path
The ROLLFORWARD DATABASE processing and resume forward recovery.
stops. v If you cannot find the missing log files, restore
the database on all nodes, then do
User Response: See the user exit documentation
point-in-time recovery using a timestamp that
in the Administration Guide for a description of
is earlier than that of the earliest missing log
the error, and either resume or terminate the
file.
roll-forward recovery.

Chapter 2. SQL Messages 419

 server, the node number(s) indicate which
SQL6062N Roll-forward recovery on database
node(s) the error occurred on. Otherwise, it is
″<name>″ cannot complete
not pertinent and should be ignored.)
because the log information on
node(s) ″<node-list>″ does not User Response: Reissue the ROLLFORWARD
match the corresponding record(s) command to continue.
on the catalog node.
Explanation: The Rollforward utility processed SQL6064N SQL error ″<sqlcode>″ occurred
all the log files found on each node, but the stop during data redistribution.
points on the specified nodes do not match the
corresponding records on the catalog node. This Explanation: An error occurred during data
can be caused by missing log files on either the redistribution.
catalog node or on the specified nodes, or the The utility stops processing.
catalog node must be included in the list of
nodes to be rolled forward. User Response: Look at the SQLCODE
(message number) in the message for more
The ROLLFORWARD DATABASE processing information. Make any required changes and try
stops. the request again.
User Response: Do one of the following:
v Check if the catalog node needs to be rolled SQL6065N An error occurred while writing to
forward. If it does, submit the file ″<file>″.
ROLLFORWARD command again and include
Explanation: One of the following conditions
the catalog node.
was encountered:
v Use the ROLLFORWARD DATABASE
v The file could not be opened.
command with the QUERY STATUS option to
determine which log files are missing. When v An I/O error occurred while writing to the
you find the log files, put them in the log path file.
and resume forward recovery. v An I/O error occurred while closing the file.
v If you cannot find the missing log files, restore The command or the utility cannot be processed.
the database on all nodes, then do
point-in-time recovery using a timestamp that User Response: Ensure that the file exists and
is earlier than that of the earliest missing log that the file permissions allow write access. Try
file. the command or the utility again.

SQL6063N Roll-forward recovery on database SQL6067W ROLLFORWARD DATABASE

″<name>″ has stopped on node(s) QUERY STATUS command
″<node-list>″ due to a change in encountered sqlcode ″<sqlcode>″.
log file size. Explanation: The ROLLFORWARD DATABASE
Explanation: The Rollforward Database utility QUERY STATUS command encountered an error
has stopped rolling forward because the log files with the sqlcode ″<sqlcode>″. The query might
have changed in size. It must be restarted to not be successful on some nodes for various
establish the new log file size. reasons. The most severe error is indicated by
″<sqlcode>″. The roll-forward status is only
If ″,...″ is displayed at the end of the node list, returned for the successful nodes.
see the diagnostic log for the complete list of
nodes. User Response: Look up the sqlcode
″<sqlcode>″ in the DB2 Messages Reference, or
Roll-forward recovery has stopped. online to determine the problems on the failed
(Note : if you are using a partitioned database nodes. Take the required corrective actions, then

420 Message Reference, Volume 2

continue the forward recovery on these nodes.
SQL6072N DB2START with the RESTART
option cannot proceed because the
SQL6068W Rollforward operation was specified node is already active.
cancelled successfully. The
Explanation: The node specified for restart is
database has to be restored on
already active on the system.
node(s) ″<node-list>″.
User Response: If necessary, issue a DB2STOP
Explanation: A Rollforward operation was
specifying the node to stop and issue the
cancelled before it successfully completed, and
DB2START command again to restart the node.
the database is left in an inconsistent state. The
restore pending flag is on for the listed nodes.
SQL6073N Add Node operation failed.
If ″,...″ is displayed at the end of the node list,
SQLCODE = ″<sqlcode>″.
see the syslog file for the complete list of nodes.
Explanation: The Add Node operation failed
User Response: Restore the database on the
with sqlcode ″<sqlcode>″.
listed nodes.
User Response: Check the message associated
with the sqlcode that is returned in either the
SQL6069N The ROLLFORWARD DATABASE
DB2 Messages Reference, or online.
command cannot be submitted on
a non-catalog node. Take any required corrective action, then try the
request again.
Explanation: The ROLLFORWARD DATABASE
command is only accepted on the catalog node.
SQL6074N Add Node operation failed
User Response: Submit the command on the
because a Create or Drop
catalog node.
Database operation is currently
executing.
SQL6071N The requested operation cannot
Explanation: An Add Node operation cannot
be processed because a new node
execute concurrently with a Create or Drop
has been added to the system.
Database operation.
The system must be stopped and
started again before the operation User Response: Wait for the Create or Drop
can be done. Database operation to complete, then try the
request again.
Explanation: One of the following:
v The request was issued from the new node,
and this node cannot communicate with other SQL6075W The Start Database Manager
nodes. operation successfully added the
node. The node is not active until
v A CREATE or DROP DATABASE operation
all nodes are stopped and started
was requested before all nodes were stopped
again.
and started again to include the new node.
Explanation: The db2nodes.cfg file is not
User Response: Issue db2stop to stop all the
updated to include the new node until all nodes
nodes. When all nodes are successfully stopped,
are simultaneously stopped by the STOP
issue db2start to start all the nodes, including the
DATABASE MANAGER (db2stop) command.
new node, then try the request again.
Until the file is updated, the existing nodes
sqlcode: -6071 cannot communicate with the new node.

sqlstate: 57019 User Response: Issue db2stop to stop all the

nodes. When all nodes are successfully stopped,

Chapter 2. SQL Messages 421

issue db2start to start all the nodes, including the
SQL6079W The db2stop DROP NODENUM
new node.
command was cancelled
successfully.
SQL6076W Warning! This command will
Explanation: The db2stop DROP NODENUM
remove all database files on the
command was stopped before it began
node for this instance. Before
processing.
continuing, ensure that there is no
user data on this node by running User Response: None.
the DROP NODE VERIFY
command.
SQL6080W The Start Database Manager
Explanation: This procedure will remove all the operation successfully added in
database partitions from the specified node. the node, but no database
partitions have been created on
User Response: Ensure that the DROP NODE
the node. The node is not active
VERIFY command was run before dropping this
until all nodes are stopped and
node. If using the API, ensure that the callerac
started again.
parameter is specified correctly.
Explanation: The db2nodes.cfg file is not
updated to include the new node until all nodes
SQL6077W The db2stop DROP NODENUM
are simultaneously stopped by the STOP
procedure ended successfully, but
DATABASE MANAGER (DB2STOP) command.
could not remove all the files. See
Until the file is updated, the existing nodes
the file ″<file>″ for details.
cannot communicate with the new node.
Explanation: The db2stop DROP NODENUM
User Response: Issue DB2STOP to stop all the
procedure ended successfully, but some user data
nodes. When all nodes are successfully stopped,
files are still on the node.
issue DB2START to start all the nodes, including
User Response: Information in ″<file>″ file will the new node. When all nodes are successfully
indicate the directory structure from which files started, the database system can be used.
could not be deleted.
SQL6081 A communication error caused a
SQL6078N The db2stop DROP NODENUM DB2STOP FORCE command to
procedure could not update the time out on this node.
database information for database
Explanation: A communication error occurred
″<dbname>″.
on one or more of the database nodes, causing
Explanation: The db2stop DROP NODENUM the DB2STOP FORCE command to time out on
procedure could not access the catalog node for the current node, or, DB2STOP FORCE
database ″<dbname>″. terminated because a severe error occurred
during FORCE on one or more nodes. Any node
User Response: Try the request again. If the where the communication error occurred will
problem persists, contact your service receive the SQL6048N message.
representative.
User Response: Do the following:
1. Correct the communication error on the node
(or nodes) that received the SQL6048N
message.
2. Issue a DB2START command and ensure that
all nodes that received the SQL6048N
message started successfully.

422 Message Reference, Volume 2

3. Issue the DB2STOP FORCE command again
from any node.
4. Look at the db2diag.log file to find the error,
correct it if possible, and reissue the
DB2STOP FORCE command from any node.

SQL6100 - SQL6199

SQL6100N The partitioning map in the data SQL6102W The parameter “<name>” is
file and the partitioning map for reserved for future use. Its value
the database are not the same. should be set to
“<default-value>”.
Explanation: The data to be loaded has either
not been partitioned, or was partitioned with a Explanation: A parameter reserved for future
partitioning map other than the current one for capabilities has been set to a value that is not its
the nodegroup to which the table belongs. The default value. It should be set to the default
data cannot be loaded. value to ensure future compatibility.
User Response: If the data was not partitioned, User Response: Ensure that the parameter
use the db2split program to partition the data, “<name>” is set to the value, “<default-value>”,
then load the partitioned data. then try the request again.
If the data was partitioned, do one of the
following: SQL6103C An unexpected utility error
v Use the partitioning map from the header of occurred. Reason code =
the data file to redistribute the nodegroup to “<reason-code>”.
which the table belongs. Then try the request Explanation: An unexpected utility error
again. occurred.
v Repartition the data with the current
User Response: Record the message number
partitioning map for the nodegroup. Then try
(SQLCODE) and reason code in the message.
the request again to load the newly partitioned
data. If trace was active, invoke the Independent Trace
Facility at the operating system command
prompt. See the Administration Guide for
SQL6101N This data file contains data for
information on how to use this facility. Then
node “<node-1>” but the Load
contact your technical service representative with
utility is connected to node
the following information:
“<node-2>”.
v Problem description
Explanation: The data to be loaded is associated
v SQLCODE and embedded reason code
with a node number that differs from the node
number of the node to which the application is v SQLCA contents if possible
connected. The data cannot be loaded. v Trace file if possible
User Response: Either find the data file
associated with this node and try the request SQL6104N The load utility does not support
again with that data file, or connect to the node the creation of indexes.
associated with this data file and issue the
request at that node. Explanation: The load utility does not support
the creation of indexes, but the table to be loaded
has at least one index defined on it. The index
may have been explictly created with the

Chapter 2. SQL Messages 423

CREATE INDEX statement or implicitly created partition the data and then try the request again
when a primary key was defined for the table. with the partitioned data. If the insert-column
option is being used, ensure that all of the
User Response: Drop all indexes defined on the
partitioning columns are specified in the column
table with the DROP INDEX statement. Drop the
list.
primary key with the ALTER TABLE statement.
Resubmit the command. If the problem persists, contact your technical
service representative with the following
Use CREATE INDEX and ALTER TABLE as
information:
required to recreate indexes and primary key
after the load completes successfully. v Problem description
v SQLCODE and embedded reason code
SQL6105W The Load utility has completed v SQLCA contents if possible
processing. A Rollforward done to v Trace file if possible
a point in time after the load will
not succeed. Take a database
SQL6108N The number of partitioning keys
backup now if database
defined in the data file header
recoverability is required.
(“<number-1>”) does not match
Explanation: No logging is done by the Load the number of partitioning keys
utility. If you try to roll forward with a backup defined for the table
made before the load, the operation will fail (“<number-2>”).
when it encounters references to the data that
Explanation: The partitioning columns specified
was loaded.
in the db2split configuration file were not
User Response: To ensure database correct. The data was not correctly split.
recoverability after the load, do a backup before
User Response: Do the following:
the data is modified.
1. Ensure that the correct partitioning columns
are specified in the db2split configuration file.
SQL6106N The filetype modifier
2. Split the data.
″NOHEADER″ was specified, but
the nodegroup on which the table 3. Issue the Load operation with the newly
is defined is not a single-node partitioned data.
nodegroup.
Explanation: The data to be loaded was SQL6109N Utility expected partitioning
specified as having no header information. column “<column-name-1>”, but
However the target table specified is not a found partitioning column
single-node table. The data cannot be loaded. “<column-name-2>”.

User Response: The data must be split using Explanation: In the db2split configuration file:
db2split, then loaded without the ″NOHEADER″ v One of the partitioning columns defined for
option. the table was not specified.
v The order of the partitioning columns was
SQL6107N The partitioning key information incorrect
in the data file is not correct. v A column was specified that is not a
partitioning column for the table.
Explanation: Either the data was not split with
db2split or the db2split operation was not User Response: Do the following:
successful. 1. Ensure that the db2split configuration file is
User Response: Use the db2split program to correct.

424 Message Reference, Volume 2

2. Split the data. v The file system does not have enough file
3. Issue the Load operation with the newly blocks or inodes.
partitioned data. The requested change is not made.
User Response: Do one of the following, then
SQL6110N Utility expected partitioning try the request again:
column type “<column-type-1>”
v Ensure that the specified path exists and that
for column “<column-name-1>”,
the filesystem and path have read/write
but the data file lists it as type
permissions.
“<column-type-2>”.
v Specify a different newlogpath.
Explanation: The db2split configuration file is
not correct. If the problem persists, see your system
administrator.
User Response: Do the following:
1. Ensure that the db2split configuration file is
SQL6112N The requested change cannot be
correct.
done. The resulting configuration
2. Split the data. parameter settings are not valid.
3. Issue the Load operation with the newly Reason code ″<reason-code>″.
partitioned data.
Explanation: Three rules govern the settings of
some configuration parameters. The rule that
SQL6111N Cannot create a subdirectory would be violated is indicated by the
under the path specified by ″<reason-code>″:
newlogpath.
(1) max_coordagents + num_initagents <=
Explanation: When the newlogpath parameter maxagents
is updated, the system attempts to create a
(2) num_initagents <= num_poolagents
subdirectory under the specified path using the
node name as the name of the subdirectory. One (3) maxdari <= max_coordagents
of the following operating system errors
prevented the creation of the subdirectory: User Response: Ensure that the values you
specify do not violate any of the above rules,
v The file system or path does not have the then try the request again.
appropriate permissions for file creation.
v The file system does not have enough disk
space.

SQL6500 - SQL6599

SQL6500W RESTARTCOUNT in the load SQL6501N Database name was not given in
command may cause some the configuration file.
problems.
Explanation: Database name has to be specified
Explanation: Since multiple loading processes in the configuration file.
for the same table are completely independent, it
User Response: Please specify the database
is almost impossible to have an identical
name and rerun the command.
restartcount for those multiple loading processes.
User Response: Please make sure you have the
correct load command in the configuration file.

Chapter 2. SQL Messages 425

 NOCHECK. The default is CHECK.
SQL6502N The path name (parameter:
data_path) for data file was not User Response: Correct the parameter in the
specified. configuration file, and rerun the command.
Explanation: If the input data file is remote, the
file will be transferred locally. The path to the file SQL6508N The program failed to create the
on the remote machine must be supplied. output pipe for the ftp process.
User Response: Please specify the path name to Explanation: If input data files are remote, they
the remote data file and rerun the command. will be transferred to a local pipe. If this local
pipe already exists, the process will fail.
SQL6504N There are errors in the output User Response: Please ensure your working
node list specification (parameter: space is clean.
outputnodes) in the configuration
file.
SQL6509N The program failed to create input
Explanation: The output node list specification pipes for the splitter processes.
is not valid.
Explanation: The program can not create
User Response: Check the sample configuration temporary input pipes for the splitter processes.
file, correct your output node list specification,
and rerun the command. User Response: Please ensure your working
space is clean.

SQL6505N There are errors in the split node

list specification (parameter: SQL6510N The program failed to create the
splitnodes) in the configuration temporary directory at local
file. non-NFS space of node
″<node-num>″.
Explanation: The split node list specification is
not valid. Explanation: The program needs a temporary
working directory at local non-NFS space of all
User Response: Check the sample configuration splitting and output nodes.
file, correct your split node list specification, and
rerun the command. User Response: Please ensure your working
space is clean.

SQL6506N The program failed to extract

partitioning key information for SQL6511N The program failed to create
table ″<table-name>″ from the output for the splitter process at
system catalog table. node ″<node-num>″.

Explanation: Either the table is not defined, or Explanation: The program can not create
it is not defined in an MPP environment. temporary output pipes for the splitter at node
″<node-num>″.
User Response: Make sure you have the table
properly defined. User Response: Please ensure your working
space is clean.

SQL6507N Checking level (parameter:

check_level) in the configuration
file is not valid.
Explanation: Checking level (parameter:
check_level) can be either CHECK or

426 Message Reference, Volume 2

SQL6512N The program failed to create input SQL6517N The program failed to extract the
pipes for the merging process at node list, where the table
node ″<node-num>″. ″<tbl-name>″ is defined, from the
system catalog table.
Explanation: The program can not create
temporary input pipes for the merging process at Explanation: Either the table is not defined, or
node ″<node-num>″. it is not defined in an MPP environment.
User Response: Please ensure your working User Response: Check how the table was
space is clean. defined in the database.

SQL6513N The program failed to create the SQL6518N The record length (reclen in the
input pipe for the loading process load command) is not valid.
at node ″<node-num>″.
Explanation: Valid record is between 1 to 32768.
Explanation: The program can not create
User Response: Please correct the record length,
temporary input pipe for the loading process at
and rerun the command.
node ″<node-num>″.
User Response: Please ensure your working
SQL6519N The mode (parameter: mode)
space is clean.
″<mode>″ in the configuration file
is not valid.
SQL6514N The program can not read the
Explanation: The running mode of this program
node configuration file:
can be: SPLIT_ONLY, LOAD_ONLY,
″<node-cfg-file>″.
SPLIT_AND_LOAD (default), or ANALYZE.
Explanation: Either the file does not exist, or it
User Response: Please correct the mode in the
is not readable.
configuration file.
User Response: Please check the existence and
permissions of the node configuration file.
SQL6520N The program failed to create
output pipes for the process,
SQL6515N The program failed to find a load which generates the header
command in the configuration information for split file.
file.
Explanation: The program can not create output
Explanation: A CLP load command must be pipes for the process, which generates the header
supplied in the configuration file. information for split file.
User Response: Please specify a CLP load User Response: Please ensure your working
command in the configuration file. space is clean.

SQL6516N The program failed to connect to SQL6521N The configuration file ″<cfg-file>″
database ″<db-name>″. for this program doesn’t exist.
Explanation: Either the database manager has Explanation: The program needs a
not been started yet, or it encountered problems. configuration file.
User Response: Check your database manager User Response: Please create a configuration
status. file.

Chapter 2. SQL Messages 427

 User Response: Please check the permission of
SQL6522N The program found a path name
current working directory.
for the input data files in the load
command.
SQL6527N The node where statistic data will
Explanation: Path name for input data files in
be collected, (parameter:
the load command is not allowed. There is a
run_stat_node), is not a member
separate parameter (data_path) for this purpose.
of the output node list.
User Response: Please correct the configuration
Explanation: The node where statistic data will
file.
be collected must be a member of the output
node list.
SQL6523N The element ″<node-num>″ in the
User Response: Please correct the
split node list (parameter:
run_stat_node parameter.
SplitNodes) is not defined in the
node configuration (db2nodes.cfg)
file. SQL6528N Record length was not specified
in the load command.
Explanation: All nodes in the split node list
must have an entry in the node configuration Explanation: If the BINARYNUMERICS or
file. PACKEDDECIMAL modifier is specified in the
load command, record length (reclen) must be
User Response: Please correct your split node
specified in the load command as well.
list.
User Response: Please correct the load
command.
SQL6524N The element ″<node-num>″ in the
output node list (parameter:
Outputnodes) is not a member of SQL6529N The No Header option
the node list where the table is (NOHEADER) was not specified
defined. in the load command.
Explanation: All nodes in the output node list Explanation: If a table is defined in a single
must be members of the node list where the node nodegroup, the NOHEADER modifier must
table is defined. be specified in the load command.
User Response: Please correct your output node User Response: Please correct the load
list. command.

SQL6525N The program can not read the SQL6530N The data type of one partitioning
input data file ″<file-name>″. key is float or double.
Explanation: Either the input data file was not Explanation: If the input file is a non-binary
found, or it is not readable. data file, float or double columns can not be
defined as partitioning key.
User Response: Please check the existence and
permissions of the input data file. User Response: Supply a binary data file, or
change the definition of your table.
SQL6526N The program can not write in
current working directory SQL6531N The program failed to reset
″<cwd>″. tablespace quiesce.
Explanation: The current working directory is Explanation: There are probably on-going
not writable. loading processes. Make sure all previous

428 Message Reference, Volume 2

loading processes are completed before another
SQL6536N The program ″<progname>″ failed
AutoLoader session can be started.
to open file ″<filename>″ for
User Response: Check the processes status on reading.
your machine.
Explanation: An AutoLoader process can not
successfully open a file or pipe for reading.
SQL6532N A savecount in the load command
User Response: Please ensure everything is
can not be set to non-zero.
correct in the configuration file.
Explanation: The savecount in the load
command can not be set to non-zero if there are
SQL6537N The program ″<progname>″ failed
multiple splitting nodes, the mode is
to open file ″<filename>″ for
SPLIT_AND_LOAD, and the command is either
writing.
a REPLACE INTO or INSERT INTO load
command. Explanation: An AutoLoader process can not
successfully open a file or pipe for writing.
User Response: Please correct the load
command. User Response: Please ensure everything is
correct in the configuration file.
SQL6533N A restartcount in the load
command can not be set to SQL6538N The program failed to read the
non-zero. split file ″<split-file>″.
Explanation: Because multiple splitting nodes Explanation: When the program is invoked in
produce random order of records for loading LOAD_ONLY mode, the input data file must
process(es), using RESTART INTO with a have already been split, and all split files must
restartcount can not guarantee a successful be readable by the program.
recovery.
User Response: Check whether or not the input
User Response: Please correct the load data file has been split, and the access
command. permissions of the resulting split files.

SQL6534N There is an error in the .netrc file SQL6539N There is at least one command in
″<netrc-file>″. ″<cmd-list>″ not found in the
working environment.
Explanation: Either the .netrc file could not be
found, or there is no entry for remote host Explanation: The execution of this program
″<machine>″, or the permissions of the file are depends on a number of common Unix
not correct. commands. The process fails if any one of them
is not available in the working environment.
User Response: Please check the existence and
permission of the .netrc file. User Response: Make sure you have all
necessary commands properly installed on your
system.
SQL6535N The mode SPLIT_ONLY or
ANALYZE is not valid.
SQL6540N File type ″<file-type>″ specified in
Explanation: If a table is defined in a single
the load command is not valid.
node nodegroup, either splitting or analyzing is
not necessary. Explanation: Valid file types are ASC (positional
ASCII) or DEL (delimited ASCII).
User Response: Please change the mode to
LOAD_ONLY or SPLIT_AND_LOAD.

Chapter 2. SQL Messages 429

User Response: Correct the load command in
SQL6554N An error occurred when
the configuration file.
attempting to remotely execute a
process.
SQL6550N The partitioning map file
Explanation: The utility attempted to start a
″<map-file-name>″ could not be
child process on a different database partition,
opened for writing.
but an error occurred.
Explanation: The file name and path for the
User Response:
partitioning map could not be opened. An error
occurred. v If no user ID or password was provided to the
utility for remote access, ensure that the user
User Response: Confirm that the partitioning ID invoking the utility is authorized to execute
map file name and file path were specified programs on the target node(s).
correctly and that the file can be openned for
v If a user ID and password were supplied to
writing.
the utility confirm that they were supplied
correctly.
SQL6551N An error occurred while v If running on NT make sure the DB2
attempting to write to the installation has correctly defined an NT
partition map file. Service for the splitter operation on all nodes.
Explanation: A filesystem error occurred when v If you are unable to resolve this problem,
writing to the partitioning map file. please contact DB2 service.
User Response: Check that the file path is
correct, and that the target device has sufficient SQL6555N The AutoLoader utility
space to hold the partitioning map output. encountered an unexpected
communications error.

SQL6552N An error occurred while Explanation: The utility encountered an error

attempting to open a temporary attempting one of the following operations:
configuration file ″<filename>″ v Attempting to connect to a TCP/IP socket.
for writing.
v Attempting to read or write a TCP/IP msg.
Explanation: The file name and path for a v Attempting to initialize TCP/IP
temporary file could not be opened. An error communications
occurred.
v Attempting to retrieve a complete host name.
User Response: Confirm that the utility v Attempting to select an active TCP/IP socket.
temporary file storage path was specified
v Attempting to close an active socket.
correctly and that the path allows for files to be
openned for writing. v Attempting to retrieve a port number.
User Response:
SQL6553N An error occurred while v If service name setup was required for the
attempting to write to a temporary version of the AutoLoader you are using,
configuration file ″<filename>″. ensure that the service names have been
defined correctly.
Explanation: A filesystem error occurred when
writing to a temporary file. v If you are running concurrent AutoLoader
jobs, ensure that you have followed the
User Response: Check that the file path is documented setup requirements to avoid
correct, and that the target device has sufficient service name conflicts between the concurrent
space for the file data. utility jobs.

430 Message Reference, Volume 2

v If the problem persists, contact your DB2
SQL6560N Node ″<node-number>″ which is
Service representative.
an execution node for splitting
does not appear in the
SQL6556W An incomplete record was db2nodes.cfg file.
detected at the end of file
Explanation: A node specified as an execution
″<filename>″.
node for splitting does not appear to be a
Explanation: An incomplete data record was member in the db2nodes.cfg file. The work
found at the end of a data file provided to the inteded to complete on this node can not be
utility by the user. started.

User Response: Examine the source data for User Response: Add the node to the node list
syntactical correctness. definition in the db2nodes.cfg file, or specify an
alternate node for the split operation which is a
member of the node configuration.
SQL6557N Failed to retrieve the default node
number.
SQL6561N Target node ″<node-number>″ for
Explanation: The utility attempted to determine load does not appear in the
a default node number, but was unable to. nodegroup.
User Response: State source and target node Explanation: A node was specified as a target
numbers explicitly in the utility configuration node for loading, but this node is apparently not
file, or contact DB2 Service for assistance. a member of the node group being loaded.
User Response: Check the nodegroup definition
SQL6558N The utility failed to determine the and confirm that the target node specified for
current working directory and/or loading is part of this nodegroup. If the node is
drive. not part of the nodegroup correct the utility
Explanation: The utility attempted to determine target node specification to include the correct
the current working directory and/or drive but list of nodes. If the node is part of the
encountered an error. nodegroup, please contact DB2 Service for
assistance.
User Response: Contact DB2 Service for
assistance.
SQL6562N The utility is unable to retrieve
the instance name.
SQL6559N An invalid command line option
was provided to the AutoLoader Explanation: The utility attempted to retrieve
utility. the instance name but encountered an error.

Explanation: The user specified a command line User Response: Confirm that the utility is
option for the AutoLoader utility which is either running on a node with DB2 installed, and a
not supported, or obsolete. valid instance is running. For additional help,
please contact DB2 Service.
User Response: Refer to the AutoLoader
documentation, or online help, for the supported
options and features. SQL6563N Failed to retrieve the current user
ID.
Explanation: The utility attempted to retrieve
the current user ID for the ID, but an error was
encountered.
User Response: Contact DB2 Service.

Chapter 2. SQL Messages 431

 parameter must be specified.
SQL6564N The password supplied is not
valid. User Response: Ensure that you have specified
the correct configuration file for the AutoLoader,
Explanation: The user supplied an explicit
and that the LOAD command is specified inside.
password to the utility, but the password is not
valid.
SQL6567N The ″<option-name>″ option
User Response: Supply a valid password.
appears multiple times in the
AutoLoader configuration file.
SQL6565I Usage: db2atld [-config
Explanation: An option parameter was specified
config-file] [-restart] [-terminate]
multiple times inside the AutoLoader
[-help]
configuration file.
Explanation:
User Response: Correct the configuration file so
v The ’-config’ option will run this program that each option appears at most only once.
using a user specified configuration file; the
default is autoload.cfg.
SQL6568I The AutoLoader is now issuing
v The ’-restart’ option will run this program in
all LOAD requests.
restart mode; the configuration file should not
be modified since the last incomplete Explanation: The AutoLoader is starting the
AutoLoader job. LOAD operation on each of the target LOAD
v The ’-terminate’ option will run this program partitions.
in terminate mode; the configuration file User Response: This is an informational
should not be modified since the last message.
incomplete AutoLoader job.
v The ’-help’ option will generate this help
message. SQL6569I The AutoLoader is now issuing
all split requests.
The AutoLoader configuration file is a user
supplied file which contains the LOAD Explanation: The AutoLoader is now issuing
command to be executed, the target database, the split operation on each of the target split
and several optional parameters that the user partitions.
may specify. The sample configuration file, User Response: This is an informational
’AutoLoader.cfg’, supplied in the samples message.
directory contains inline comments which
describe the available options and their defaults.
When running this program with ’-restart’ and SQL6570I The AutoLoader is waiting for all
’-terminate’ option, user should not modify the splitters to complete.
configuration file from their last incomplete job. Explanation: The AutoLoader is waiting for all
User Response: Refer to the DB2 splitters to complete.
documentation for further details about the User Response: This is an informational
AutoLoader utility. message.

SQL6566N The LOAD command is missing SQL6571I The AutoLoader is waiting for all
from the AutoLoader LOAD operations to complete.
configuration file.
Explanation: The AutoLoader is waiting for
Explanation: The LOAD command is missing LOAD operations to complete.
from the AutoLoader configuration file. The

432 Message Reference, Volume 2

User Response: This is an informational
SQL6576N The AutoLoader utility
message.
encountered a threading error.
Reason code ″<reason-code>″,
SQL6572I The LOAD operation has begun return code ″<ret-code>″.
on partition ″<node-number>″.
Explanation: The following is an explanation of
Explanation: The LOAD operation has begun the reason code ″<reason-code>″:
on the specified partition. v 1 - The AutoLoader utility tried to create a
User Response: This is an informational thread but failed with return code
message. ″<ret-code>″.
v 2 - The AutoLoader utility tried to wait for a
thread to finish, but failed with return code
SQL6573I The remote execution of the ″<ret-code>″.
splitter utility on partition
″<node-number>″ finished with User Response: Ensure that you are running on
remote execution code ″<code>″. an operating system which supports threaded
applications, and that your thread limit per
Explanation: The remote execution of the process is sufficient. The thread requirements are
splitter utility on the specified partition has as follows:
completed.
v One thread for every load process which must
User Response: This is an informational be started,
message. v One thread for every splitter process,
v One thread for data feeding to the splitter
SQL6574I The utility has read ″<MB-count>″ processes.
megabytes from the source data.
Explanation: This information is generated SQL6577N The AutoLoader utility does not
periodically to provide status to the user on the support the ROWCOUNT option
progress of large AutoLoader jobs. in the load command.
User Response: This is an informational Explanation: The ROWCOUNT option in the
message. load command is not supported in the
AutoLoader utility.
SQL6575I The utility has completed reading User Response: Correct your load command in
″<MB-count>″ megabytes from the AutoLoader configuration file, and resubmit
the user data. your command.
Explanation: This message is written at the
completion of the AutoLoader run to indicate the SQL6578N Invalid AutoLoader option.
total volume of user data that has been RESTART/TERMINATE option
processed. can only be specified with
SPLIT_AND_LOAD or
User Response: This is an informational
LOAD_ONLY mode.
message.
Explanation: RESTART/TERMINATE option in
AutoLoader can only work with
SPLIT_AND_LOAD or LOAD_ONLY mode.
User Response: Please check the AutoLoader
configuration file or the autloader option flags.

Chapter 2. SQL Messages 433

 LOAD/BUILD/DELETE phase.
SQL6579N Invalid LOAD command in the
AutoLoader configuration file. User Response: This is an informational
RESTART and TERMINATE message.
options of the AutoLoader are
used to perform LOAD RESTART
and LOAD TERMINATE SQL6581I Load cannot restart on node
operation respectively. ″<node-num>″.

Explanation: Users should not specify RESTART Explanation: AutoLoader has acknowledged
nor TERMINATE in the LOAD command. that LOAD cannot be restarted on a given node.
Instead, the RESTART and TERMINATE options User Response: This is an informational
of the AutoLoader should be used. message.
User Response: Without modifing the
AutoLoader configuration file, users should SQL6582I Restarting LOAD on node
launch db2atld with option RESTART or ″<node-num>″ is not required.
TERMINATE.
Explanation: AutoLoader has acknowledged
that LOAD does not need to be restarted on a
SQL6580I LOAD is restarting on node given node.
″<node-num>″ in phase
″<restarting-phase>″. User Response: This is an informational
message.
Explanation: AutoLoader has acknowledged
that LOAD is restarting in either

SQL7000 - SQL7099

SQL7001N Unknown command SQL7003N The statement name is invalid.

“<command>” was requested.
Explanation: The user has specified an incorrect
Explanation: The command submitted to REXX statement name.
could not be recognized.
The command cannot be processed.
The command cannot be processed.
User Response: Verify that the statement name
User Response: Verify that the command is a is of the form “s1” through “s100”.
valid SQL statement and rerun the procedure.
Note that all commands must be in uppercase.
SQL7004N The syntax of the request is
invalid.
SQL7002N The cursor name is invalid.
Explanation: REXX was unable to parse the
Explanation: The user specified an incorrect command string submitted.
cursor name.
The command cannot be processed.
The command cannot be processed.
User Response: Use proper command syntax.
User Response: Verify that the cursor name is
one of the form “c1” through “c100”.
SQL7005W The cursor used by this OPEN
statement has not been declared.
Explanation: An OPEN statement was
attempted without a declaring a cursor.

434 Message Reference, Volume 2

The command cannot be processed. consistent with the length given in the input
SQLDA, and run the procedure again.
User Response: Insert a DECLARE statement
before the OPEN statement and rerun the
procedure. SQL7010N Invalid scan ID “<ID>”.
Explanation: The scan ID “<variable>” passed
SQL7006N Invalid keyword “<keyword>” to REXX did not exist or contained inconsistent
given on “<request>”. or missing data.
Explanation: The statement contains a not valid The command cannot be processed.
keyword “<keyword>”.
User Response: Verify that the data contained
The command cannot be processed. in the scan ID has been assigned correctly, and
run the procedure again.
User Response: Specify the correct keyword
format.
SQL7011N Required parameter
“<parameter>” not given.
SQL7007N REXX variable “<variable>” does
not exist. Explanation: The parameter “<parameter>” is
required by REXX command syntax but was not
Explanation: A REXX variable that did not exist
specified.
in the REXX variable pool was passed.
The command cannot be processed.
The command cannot be processed.
User Response: Specify the required parameter
User Response: Verify that all variable names in
value, and run the procedure again.
the host-variable list are assigned before the
command that failed. Then run the procedure
again. SQL7012N Attempted ISL change while
connected to a database.
SQL7008N REXX variable “<variable>” Explanation: Isolation level (ISL) may not be
contains inconsistent data. changed while connected to a database.
Explanation: A variable that contained The command is ignored.
inconsistent data was passed to REXX.
User Response: If a change in isolation level is
The command cannot be processed. necessary, disconnect from the current database,
then set the isolation level and connect to the
User Response: If the variable is an SQLDA,
database.
verify that the data and length fields have been
assigned correctly. If it is a REXX variable, verify
that the type of data is appropriate to the SQL7013N Mismatched cursor and statement
command where it is being used. name or hold attribute.
Explanation: In REXX, the cursor and statement
SQL7009N Truncated REXX variable name form must be ’cnn’ and ’snn,’ where ’nn’ is
“<variable>”. a number from 1 to 100. The numbers must be
the same for a cursor and statement pair. Also, c1
Explanation: The variable “<variable>” passed
through c50 are declared without hold and c51
to REXX contained inconsistent data. The data
through c100 with hold.
string from “<variable>” was truncated.
The command is ignored.
The command cannot be processed.
User Response: Verify that the cursor and
User Response: Verify that the data length is

Chapter 2. SQL Messages 435

statement numbers match and rerun the need to have the DB2 Application
procedure. Development Client and a C compiler installed
on the server to create SQL procedures. You
may need to set the DB2 registry variable
SQL7014N Incorrect number of host variable
DB2_SQLROUTINE_COMPILER_PATH to
components.
point to a script or batch file that contains
Explanation: In REXX, the first component of a environment settings for the C compiler on
compound host variable lists a number which is your platform.
not equal to the actual number of components v DB2 failed to precompile or compile the SQL
defined. stored procedure. DB2 creates an SQL
The command is ignored. procedure as a C program that contains
embedded SQL. Errors not found during the
User Response: Verify that the number in the inital parsing of the CREATE PROCEDURE
first component matches the number of statement can be found during the precompile
components actually defined and rerun the or compile stage.
procedure.
For UNIX platforms, the full path of the file that
contains diagnostic information is:
SQL7015N The variable name “<variable>” is
not valid in REXX. $DB2PATH/function/routine/sqlproc/ \
Explanation: The variable name specified is not $DATABASE/$SCHEMA/tmp/“<file-name>”
valid in REXX. The name must conform to the
language requirements. where $DATABASE represents the name of the
database, and $SCHEMA represents the schema
The command cannot be processed. name of the SQL procedure.
User Response: Change the name to one that
conforms to the REXX requirements and For OS/2 and Windows 32-bit operating systems,
resubmit the command. the full path of the file that contains diagnostic
information is:

SQL7016N Invalid syntax provided to the %DB2PATH%\function\routine\sqlproc\ \

SQLDB2 interface. Related Error: %DATABASE%\%SCHEMA%\tmp\“<file-name>”
“<db2_error>”. The command
cannot be processed. where %DATABASE% represents the name of the
Explanation: Invalid syntax was provided to the database, and %SCHEMA% represents the
SQLDB2 interface, e.g. both an input file and a schema name of the SQL procedure.
command were specified. User Response: Ensure that both a compatible
User Response: Look up the related error code C compiler and a DB2 Application Development
for more information. Client are installed on the server. If a precompile
or compile error occurred, refer to the messages
from the precompiler or compiler in the
SQL7032N SQL procedure diagnostic file “<file-name>”.
“<procedure-name>” not created.
Diagnostic file is “<file-name>”. Ensure that the DB2 registry variable
DB2_SQLROUTINE_COMPILER_PATH is set to
Explanation: SQL Procedure point to a script or batch file that sets up the C
“<procedure-name>” was not created. One of the compiler environment. On a UNIX operating
following has occurred: system, for example, you may create a script
v Support for SQL stored procedures is not called “sr_cpath” in the
installed and configured on this server. You /home/DB2INSTANCE/sqllib/function/routine

436 Message Reference, Volume 2

directory. To set the DB2 registry variable you keep a backup of the executable associated
DB2_SQL_ROUTINE_COMPILER_PATH with SQL procedure “<procedure-name>”. If the
accordingly, issue the following command: warning was issued during a restore operation or
db2set DB2_SQLROUTINE_COMPILER_PATH = \ a ROLLBACK of a DROP PROCEDURE
“/home/DB2INSTANCE/sqllib/function/ \ statement, then the executable associated with
routine/sr_cpath” “<procedure-name>” must be manually
synchronized with the SQL procedure that is
sqlcode: -7032 defined in the catalog.
sqlcode: +7035
sqlstate: 42904
sqlstate: 01645

SQL7035W The executable of the SQL

procedure “<procedure-name>” is SQL7099N Invalid error “<error>” has
not saved in the database catalog. occurred.

Explanation: The executable of the SQL Explanation: A REXX internal error has
procedure exceeds the limit of 2 megabytes and occurred.
therefore cannot be stored in the database The command cannot be processed.
catalog. It will not be recovered automatically at
database restore time or on ROLLBACK of a User Response: Verify that REXX is installed
DROP PROCEDURE statement. properly and rerun the procedure. If the error
continues, note the error number and call the
User Response: If the warning resulted from a dealer.
CREATE PROCEDURE statement, ensure that

SQL8000 - SQL8099
sqlstate: 42968
SQL8000N DB2START processing failed; a
valid product license was not
found. SQL8002N DRDA connect processing failed;
a valid product license was not
Explanation: A valid license key could not be
found.
found and the evaluation period has expired.
Explanation: A valid license key could not be
User Response: Install a license key for the
found and the evaluation period has expired.
fully entitled version of the product. You can
obtain a license key for the product by contacting User Response: Install a license key for the
your IBM representative or authorized dealer. fully entitled version of the product. You can
obtain a license key for the product by contacting
your IBM representative or authorized dealer.
SQL8001N DB2 connect processing failed; a
valid product license was not sqlcode: -8002
found.
sqlstate: 42968
Explanation: A valid license key could not be
found and the evaluation period has expired.
User Response: Install a license key for the
fully entitled version of the product. You can
obtain a license key for the product by contacting
your IBM representative or authorized dealer.
sqlcode: -8001

Chapter 2. SQL Messages 437

SQL8006W The product ″<product-name>″ SQL8007W There are ″<number>″ day(s) left
does not have a valid license key in the evaluation period for the
installed. If you have licensed this product ″<text>″. For evaluation
product, please ensure the license license terms and conditions, refer
key is properly installed. If a to the IBM Evaluation Agreement
license key is not installed, this in the EVALUATE.AGR file,
product will be enabled for a located in the following directory:
″<number>″ day evaluation ″<text>″.
period. USE OF THE PRODUCT
Explanation: A valid license key has not been
FOR THE EVALUATION PERIOD
installed for this product. The evaluation period
CONSTITUTES ACCEPTANCE
will expire after the specified number of days.
OF THE TERMS OF THE IBM
EVALUATION AGREEMENT IN User Response: The product is operating in
THE EVALUATE.AGR FILE, evaluation mode, and is enabled for a limited
LOCATED IN THE FOLLOWING period of time. When the evaluation period has
DIRECTORY: ″<directory-name>″. expired it will not execute until a license key for
the fully entitled version of the product is
Explanation: A valid license key has not been
installed.
installed for this product. The product will be
enabled to operate for a limited period of time You can obtain a license key for the product by
for evaluation purposes. THE EVALUATION contacting your IBM representative or authorized
PERIOD IS CONTROLLED BY A TIME dealer.
DISABLING DEVICE.
User Response: If you have purchased a fully SQL8008N The product ″<text>″ does not
entitled version of this product, please install have a valid license key installed
your license key as described in the product and the evaluation period has
installation documentation. If you have already expired. Functions specific to this
installed the license key, please verify your product are not enabled.
license file for accuracy.
Explanation: A valid license key could not be
USE OF THE PRODUCT FOR THE found and the evaluation period has expired.
EVALUATION PERIOD IS SUBJECT TO THE
TERMS OF THE IBM EVALUATION User Response: Install a license key for the
AGREEMENT IN THE EVALUATE.AGR FILE. fully entitled version of the product. You can
YOUR USE OF THE PRODUCT DURING THE obtain a license key for the product by contacting
EVALUATION PERIOD CONSTITUTES YOUR your IBM representative or authorized dealer.
ACCEPTANCE OF THESE TERMS.
If you do not accept the terms, you are not SQL8009W The number of concurrent users
authorized to use the product and you must of the DB2 Workgroup product
de-install it. You can obtain a license key for the has exceeded the defined
fully authorized program with the product by entitlement of ″<number>″.
contacting your IBM representative or authorized Concurrent user count is
dealer. ″<number>″.
Explanation: The number of concurrent users
has exceeded the number of defined DB2
concurrent user entitlements.
User Response: Contact your IBM
representative or authorized dealer to obtain
additional DB2 user entitlements and update the

438 Message Reference, Volume 2

DB2 license information in the License Center. YOUR USE OF THE PRODUCT DURING THE
EVALUATION PERIOD CONSTITUTES YOUR
sqlcode: +8009
ACCEPTANCE OF THESE TERMS.
sqlstate: 01632
If you do not accept the terms, you are not
authorized to use the product and you must
SQL8010W The number of concurrent users de-install it. You can obtain a license key for the
of the DB2 Connect product has fully authorized program with the product by
exceeded the defined entitlement contacting your IBM representative or authorized
of ″<number>″. Concurrent user dealer.
count is ″<number>″.
Explanation: The number of concurrent users SQL8012W The number of concurrent users
has exceeded the number of defined DB2 of the DB2 Enterprise product has
concurrent user entitlements. exceeded the defined entitlement
of ″<number>″. Concurrent user
User Response: Contact your IBM count is ″<number>″.
representative or authorized dealer to obtain
additional DB2 user entitlements and update the Explanation: The number of concurrent users
DB2 license information in the License Center. has exceeded the number of defined DB2
concurrent user entitlements.
sqlcode: +8010
User Response: Contact your IBM
sqlstate: 01632 representative or authorized dealer to obtain
additional DB2 user entitlements and update the
SQL8011W One or more database partitions DB2 license information in the License Center.
does not have a valid DB2 license sqlcode: +8012
key installed for the
″<product-name>″ product. Refer sqlstate: 01632
to db2diag.log for more
information.
SQL8013W The number of concurrent
Explanation: A valid license key has not been database connections to the DB2
installed for this product on all database Connect product has exceeded the
partitions. The product will be enabled to defined entitlement of
operate for a limited period of time for ″<number>″. Database connection
evaluation purposes. THE EVALUATION count is ″<number>″.
PERIOD IS CONTROLLED BY A TIME
Explanation: The license for the DB2 Connect
DISABLING DEVICE.
product you are using supports a limited number
User Response: Check the db2diag.log for more of concurrent database connections. You have
information indicating which database partitions requested a number of connections that exceeds
are encountering the license problem. If you have this limit.
purchased a fully entitled version of this product,
User Response: Upgrade to a version of the
please install your license key as described in the
DB2 Connect product with a higher limit of
product installation documentation. If you have
concurrent database connections.
already installed the license key, please verify
your license file for accuracy. DB2 Connect Enterprise Edition users: obtain
licenses for additional users by purchasing
USE OF THE PRODUCT FOR THE
Additional User Packs.
EVALUATION PERIOD IS SUBJECT TO THE
TERMS OF THE IBM EVALUATION sqlcode: +8013
AGREEMENT IN THE EVALUATE.ARG FILE.
sqlstate: 01632

Chapter 2. SQL Messages 439

SQL8014N The version of the DB2 Connect SQL8017W The number of processors on this
product you are using is not machine exceeds the defined
licensed for use with TCP/IP entitlement of
protocol. Upgrade to a full “<licensed-quantity>” for the
function DB2 Connect product to product “<product-name>”. The
use TCP/IP. number of processors on this
machine is “<processor-quanity>”.
Explanation: This version of DB2 Connect is
limited to SNA connectivity. TCP/IP connections Explanation: The number of online processors
are not supported. exceeds the number of processors specified in
your license configuration.
User Response: Upgrade to a full function DB2
Connect product such as DB2 Connect Personal User Response: Purchase additional processor
Edition or DB2 Connect Enterprise Edition to use entitlements from your IBM representative or
TCP/IP. authorized dealer and update your license by
using the License Center or the db2licm
sqlcode: -8014
command line utility.
sqlstate: 42968
sqlcode: +8017

SQL8015N The version of the DB2 Connect

SQL8018W The number of concurrent users
product you are using is not
of this product has exceeded the
licensed for updating multiple
defined entitlement of
databases in the same transaction.
“<number>”. Concurrent user
Explanation: This version of DB2 Connect is count is “<number>”.
limited to working with a single database in a
Explanation: The number of concurrent users
transaction. It does not support 2-phase commit
has exceeded the number of defined concurrent
protocol.
user entitlements.
User Response: Upgrade to a full function DB2
User Response: Contact your IBM
Connect product such as DB2 Connect Personal
representative or authorized dealer to obtain
Edition or DB2 Connect Enterprise Edition to be
additional user entitlements and update the DB2
able to update multiple databases in a single
license information in the License Center.
transaction.
sqlcode: +8018
sqlcode: -8015
sqlstate: 01632
sqlstate: 42968

SQL8019N There was an error updating the

SQL8016N The user “<user-name>” is not
license for the OLAP Starter Kit.
defined as a registered user for
RC = “<reason-code>”.
the product “<product-name>”.
Explanation: The license utility could not
Explanation: The user has not been registered
update the OLAP Starter Kit license because of
to use this product.
an unknown error.
User Response: Contact your IBM
User Response: Try the command again. If the
representative or authorized dealer to obtain
problem persists, please contact an IBM service
additional DB2 registered user entitlements and
representative.
update the registered user list for this product in
the License Center. sqlcode: -8019

440 Message Reference, Volume 2

SQL8020W The number of concurrent SQL8021W The data source “<source-name>”
non-DB2 data sources for one is not defined as a registered data
server has exceeded the defined source for “<product-name>”.
entitlement of
Explanation: The data source has not been
“<number-sources>”. Current
configured as a registered data source. You must
number of non-DB2 data sources
purchase entitlements for all non-DB2 data
is “<number-entitled>”.
sources.
Explanation: The number of concurrent
User Response: Contact your IBM
non-DB2 data sources has exceeded the number
representative or authorized dealer to obtain
of defined entitlements.
additional data source entitlements and update
User Response: Contact your IBM the registered data source list for this product in
representative or authorized dealer to obtain the License Center.
additional entitlements and then update the DB2
sqlcode: +8021
license information in the License Center.
sqlcode: +8020

SQL8100 - SQL8199
v Create a new database with larger values for
SQL8100N The table is full.
maximum pages per segment and number of
Explanation: When creating a database the segments, back up the original database and
following parameters may be specified: restore to the new database.
v maximum number of pages per segment per Federated system users: isolate the problem to
file the data source failing the request (refer to the
v number of segments Troubleshooting Guide to determine which data
source is failing to process the SQL statement)
Each table part may now have multiple files
and:
within the database segments. The file can grow
until it reaches its maximum size in a segment v Take the necessary steps to increase the space
(maximum number of pages per segment) and in the table at the data source.
then it moves to the next segment to add more v If the table is on the federated server, create a
data. This occurs until it has used the maximum new database with larger values for maximum
number of pages per segment in all configured pages per segment and number of segments.
segments, and the table becomes full. Back up the original database and restore to
the new database.
Therefore, the total amount of space per database
part is the product of the maximum number of
SQL8101N A database segment may be
pages and the number of segments. The table
incorrect.
will be full if any of the table parts use all of
their configured space. Explanation: This error could occur in two
ways:
Federated system users: this situation can also be 1. Every database segment has an identifier file.
detected by the data source. The file may be missing or the contents of the
User Response: file may be incorrect.

v Delete rows from the table 2. One, or more, previously allocated database
segments are missing.
v Reorganize the table to make more space
User Response:

Chapter 2. SQL Messages 441

v Check to ensure that the file systems are v Call your IBM service representative
mounted correctly
v Restore the database from a backup

SQL9300 - SQL9399
The command cannot be processed.
SQL9301N An invalid option is specified or
an option parameter is missing. User Response: Ensure that the <name> does
not exceed the maximum length.
Explanation: Either the option specified is
invalid or an option parameter is not specified.
SQL9306N One or more of the field names
The command cannot be processed.
are too long. The maximum
User Response: Correct the option and resubmit length is <max-length>.
the command.
Explanation: The total length of a field name
includes the specified prefix and/or a column
SQL9302N Invalid option parameter: suffix, which can either be its name or its
“<option-parameter>”. number. This total length must not exceed the
maximum length.
Explanation: The option parameter specified is
invalid. The command cannot be processed.
The command cannot be processed. User Response: Ensure that all the field names
do not exceed the maximum length.
User Response: Correct the option parameter
and resubmit the command.
SQL9307N Remarks cannot be retrieved from
the database. Error code =
SQL9303N No <option> is specified.
“<sqlcode>”.
Explanation: The required option “<option>” is
Explanation: An error has occurred when
not specified.
attempting to retrieve the remarks of a column
The command cannot be processed. from the database.

User Response: Resubmit the command with The command cannot be processed.
the required option.
User Response: Check the error code for more
information.
SQL9304N Unable to open file “<filename>”
for writing.
SQL9308W SQL data type “<sqltype>” of the
Explanation: The command cannot be column “<colname>” is not
processed. supported.

User Response: Ensure that the system can Explanation: The SQL data type “<sqltype>” is
access the file. not supported in the specified host language.
No declaration is generated for this column.
SQL9305N The <name> is too long. The
User Response: Ensure that this is the desired
maximum length is <max-length>.
table.
Explanation: The <name> is longer than the
maximum length of <max-length>.

442 Message Reference, Volume 2

 User Response: See the error message for
SQL9320I Connecting to the database
details if it fails.
“<database>”...
Explanation: The utility is attempting to
SQL9323I Generating declarations to the file
connect to the database “<database>”.
“<filename>”...
User Response: See the error message for
Explanation: The utility is attempting to
details if it fails.
generate declarations to the file “<filename>”.
User Response: See the error message for
SQL9321I Binding the utility automatically...
details if it fails.
Explanation: The utility is attempting to bind
itself to the database.
SQL9324I Disconnecting from the database
User Response: See the error message for “<database>”...
details if it fails.
Explanation: The utility is attempting to
disconnect from the database “<database>”.
SQL9322I Retrieving column information
User Response: See the error message for
from the table “<table>”...
details if it fails.
Explanation: The utility is attempting to retrieve
column information from the table “<table>”.

SQL10000 - SQL10099
User Response: Stop the application. Possible
SQL10002N The password supplied is too
solutions include:
long.
v Remove background processes.
Explanation: The length of the password is
v Terminate other applications using the above
expected to be 18 characters or less. However, if
resources.
the password is to be verified for an APPC
conversation, it must be 8 characters or less. v If you are using Remote Data Services,
increase the Remote Data Services heap size
User Response: Ensure that the password is not (rsheapsz) in the server and client
longer than the limit allowed. configuration because at least one block is
sqlcode: -10002 used per application.
NOTE: This is applicable only for releases of
sqlstate: 28000
DB2 prior to Version 2.
v Decrease the values of the configuration
SQL10003C There are not enough system parameters that define allocation of memory,
resources to process the request. including udf_mem_sz if UDFs are involved in
The request cannot be processed. the failing statement.
Explanation: The database manager could not sqlcode: -10003
process the request due to insufficient system
resources. The resources that can cause this error sqlstate: 57011
include:
v The amount of memory in the system
v The number of message queue identifiers
available in the system.

Chapter 2. SQL Messages 443

SQL10004C An I/O error occurred while SQL10007N Message “<msgno>” could not be
accessing the database directory. retrieved. Reason code: “<code>”.
Explanation: Either the system database Explanation: The requested message <msgno>
directory or the local database directory cannot could not be retrieved from the message file.
be accessed. This error may occur not only when Reason code <code> is one of the following:
the system is cataloging or uncataloging a 1. The environment variable “DB2INSTANCE”
database but also when the system is accessing a is either not set, or is set to an invalid
database that is cataloged in the directory. instance. Correct it and try again.
The command cannot be processed. 2. The message file was found, but the file
could not be opened because of permissions.
User Response: Possible solutions include:
Check the file permissions of the files under
v If the local database directory is damaged, the message directory.
restore the databases that were cataloged there
3. The message file could not be found. Either
from backup versions and catalog them.
the file does not exist, or the directory the
If installing the sample database, drop it and message file should be in does not exist.
install the sample database again. Check that a either a ’prime’ directory (the
default) or a directory with the same name as
sqlcode: -10004 the ’LANG’ environment variable exists
under the message directory.
sqlstate: 58031 4. The requested message does not exist in the
message file. Either the message file is
outdated, or it is the wrong one.
SQL10005N The mode parameter
“<parameter>” in the CONNECT 5. LC_CTYPE is set to a locale which the
TO statement is not valid. It must database does not support. Correct it and try
be SHARE for shared access, again.
EXCLUSIVE for exclusive use or 6. An unexpected system error occurred. Try
EXCLUSIVE MODE ON SINGLE execution again. If problem persists, contact
NODE for exclusive use on single your IBM representative.
node. For DB2 Connect 7. Not enough memory. An attempt to get
connections, only SHARE mode is private memory failed. Try again.
supported. EXCLUSIVE MODE
ON SINGLE NODE is only User Response: Reissue the command after
supported in MPP configuration. verifying the following:
v ensure that the DB2INSTANCE environment
Explanation: The mode parameter of the
variable is set to the correct literal string for
CONNECT TO statement must be SHARE for
the username attempting this command
shared, EXCLUSIVE for exclusive use or
EXCLUSIVE MODE ON SINGLE NODE for v ensure that correct home directory is specified
exclusive use on single node. If connecting to a for the username attempting this command
database using DB2 Connect, only shared access (i.e. in the /etc/passwd file)
is allowed. EXCLUSIVE MODE ON SINGLE v ensure that the LANG environment variable is
NODE is only supported in MPP configuration. set to the correct value for the installed
language, or is set to ’C’ (defaults to whatever
The command cannot be processed.
is in the ’prime’ directory), on the username
User Response: Resubmit the command with a attempting this command
valid mode parameter.
If all of the above are correct and the error still
occurs, reinstall DB2.

444 Message Reference, Volume 2

 sqlstate: 42724
SQL10009N The codeset “<codeset>” and/or
territory “<territory>” that has
been specified is not valid. SQL10012N An unexpected operating system
error was received while loading
Explanation: This version of the database
the specified library ″<name>″.
manager does not support the active codeset or
territory or both, as specified by the Create Explanation: An unexpected error occurred
Database command. when trying to load the library module specified
in the program name field.
The command cannot be processed.
User Response: Resubmit the current command.
User Response: Refer to the Create Database
If the error continues, stop the database manager
command in the Administration Guide for details
and start it again. If the error continues, reinstall
of valid codeset and territory pairs supported by
the database manager.
the database manager.
If reinstallation does not correct the error, record
the message number (SQLCODE) and all
SQL10010N The specified library, “<name>”,
information in the SQLCA if possible.
was loaded, but the function
“<function>” could not be If trace was active, invoke the Independent Trace
executed. Facility at the operating system command
prompt. Refer to the Independent Trace Facility
Explanation: The function routine within the
in the Troubleshooting Guide for information on
library cannot be found.
how to use this facility. Then contact IBM as
The command cannot be processed. specified in this guide.
User Response: sqlcode: -10012
1. If it is a DARI library, ensure the DARI sqlstate: 42724
library is built correctly. Make sure that the
function routine is exported through the
’export file’. SQL10013N The specified library ″<name>″
could not be loaded.
2. For other libraries, user may have to reinstall
the database manager instance or the Explanation: The library module could not be
database manager product. found.
sqlcode: -10010 User Response: For DARI users, ensure that the
specified library is available.
sqlstate: 42724 v If the client application uses a fully qualified
path name to specify the DARI library, the
SQL10011N An interrupt was received while DARI library must be stored in the given
loading the specified DARI directory path. If the client application does
library “<name>”. not use the path name, the DARI library must
be stored in the default directory
Explanation: When loading the DARI library, (<InstanceHomeDir>/sqllib/function). Where
the command was interrupted, perhaps by the <InstanceHomeDir> is the home directory of
interrupt key (usually Ctrl+Break or Ctrl+C). the database manager instance.
Processing is stopped. v If the error message occurs during database
manager start time then the user will have to
User Response: Resubmit the command. reinstall the DB2 instance or the database
sqlcode: -10011 manager product.

Chapter 2. SQL Messages 445

Federated system users: if the error message v Decrease the values of the configuration
occurs as a result of issuing db2start on the parameters that define the allocation of
federated system and the “<name>” is “from memory.
DB2_DJ_COMM” then the federated server v Install more memory.
experienced a problem loading one of the
wrapper modules identified by the sqlcode: -10015
DB2_DJ_COMM environment variable. The
DB2_DJ_COMM environment variable must be sqlstate: 42724
updated to contain only valid wrapper modules.
SQL10017N The SQL CONNECT RESET
If the error message occurs as a result of issuing statement is not allowed in a
db2start on the federated system and the Database Application Remote
“<name>” is not “from DB2_DJ_COMM”, the Interface (DARI) procedure.
user must re-install the federated instance.
Explanation: The remote procedure contains an
If the library identifies a wrapper module, that SQL CONNECT RESET statement.
module must be installed, link-edited (as User Response: Remove the SQL CONNECT
required), and available in the correct directory. RESET statement and retry the remote procedure.
Refer to the Installation and Configuration
Supplement for more information about sqlcode: -10017
configuring wrapper modules.
sqlstate: 38003
sqlcode: -10013
SQL10018N The disk is full. Processing was
sqlstate: 42724 ended.
Explanation: The disk is full. During the export
SQL10014N The invoking DARI program to a PC/IXF file, either the PC/IXF data file is on
name “<name>” specified is not a fixed disk, or the PC/IXF data file and the
valid. database are on the same file system, or the
PC/IXF data file and the message file are on the
Explanation: The DARI library module or the same file system.
DARI program name syntax is not correct.
The EXPORT utility stops processing. The
User Response: Ensure that the DARI library or exported data is not complete.
program name is specified correctly.
User Response: Provide more space on the disk
sqlcode: -10014 or specify that the data file be located on a
sqlstate: 42724 different file system than the database or the
message file and resubmit the command.

SQL10015N There are not enough system

resources to load the specified SQL10019N The database cannot be accessed
library ″<name>″. in the specified path.

Explanation: There is not enough memory to Explanation: The database cannot be accessed
load the library module. for one of the following reasons:
v The path does not contain a database image.
User Response: Stop the application. Possible
solutions are: v Permissions on the path are incorrect.
v Remove background processes. User Response: Ensure that the path references

446 Message Reference, Volume 2

a valid database and that the permissions are does not allow write access.
correct.
The statement cannot be processed.
sqlcode: -10019
User Response: Verify that the file permissions
sqlstate: 58031 for the file system on which the database resides
allow write access.
SQL10021N The file permissions do not allow
write access to the database.
Explanation: A write operation was attempted
to a database residing on a file system which

SQL20000 - SQL20099
SELECT FUNCSHEMA, FUNCNAME, SPECIFICNAME
SQL20005N The internal identifier limit for
FROM SYSCAT.FUNCTIONS
object type “<type>” has been WHERE FUNCID = INTEGER(“<method-ID>”)
exceeded.
Explanation: The create of an object of type sqlcode: -20010
“<type>” cannot be processed because the next
internal identifier for the object would exceed the sqlstate: 2202D
maximum value.
The statement cannot be processed. SQL20011N Transform group “<group-name>”
is already defined for a subtype
User Response: Drop objects of type “<type>”
or supertype of data type
that are not being used any more.
“<type-name>”.
sqlcode: -20005
Explanation: A transform group called
sqlstate: 54035 “<group-name>” already exists for a type in the
same hierarchy as “<type-name>”. It may be
defined for a supertype or subtype of
SQL20010N Mutation method “<method-ID>” “<type-name>”. A transform group name can
is not allowed when the instance only be used once within a structured type
of the structured type is NULL. hierarchy.
Explanation: The method “<method-ID>” is a The statement cannot be processed.
mutator method that is specified with an
instance of a structured type that is null. Mutator User Response: Change the name of the
methods cannot be processed on a null instance. transform group.
In some cases, the method name is not available.
sqlcode: -20011
The statement cannot be processed.
sqlstate: 42739
User Response: Determine the null instance that
is used with a mutator method. Use a
SQL20012N Type “<type-name>” does not
constructor function to create a non-null instance
have any associated transform
of the structured type before using any mutator
groups to drop.
methods on the instance.
Explanation: There are no transforms defined
To determine the method name associated with
for “<type-name>”. There is nothing to drop.
the “<method-ID>”, use the following query:

Chapter 2. SQL Messages 447

The statement did not drop any transform
SQL20014N The transform group
groups.
“<group-name>”
User Response: Ensure the name of the type “<transform-type>” transform
(including any required qualifiers) is correctly function for type “<type-name>”
specified in the SQL statement and that the type is not valid. Reason code =
exists. “<reason-code>”.

sqlcode: -20012 Explanation: The “<transform-type>” transform

function in transform group “<group-name>” is
sqlstate: 42740 not valid. The reason is based on the
“<reason-code>” as follows.
SQL20013N The object “<super-object-name>” 1 There can only be one parameter for a
is not valid as a supertype, FROM SQL transform function.
supertable, or superview of object
“<sub-object-name>”. 2 The parameter of a FROM SQL
transform function must be of type
Explanation: If the statement resulting in the “<type-name>”.
error is creating a type, then
“<super-object-name>” is a type that cannot be 3 The RETURNS data type of a TO SQL
be a supertype of “<sub-object-name>” because transform function must be of type
it is not a user-defined structured type. “<type-name>”.

If the statement resulting in the error is creating 4 The RETURNS type of a FROM SQL
a table, then “<super-object-name>” is a table transform function that returns a scalar
that cannot be be a supertable of table must be a built-in data type other than
“<sub-object-name>” because it is not defined as DECIMAL.
a typed table or the type of table
5 All of the RETURNS types of a FROM
“<super-object-name>” is not the direct
SQL transform function that returns a
supertype of the type used in defining table
scalar must be built-in data types other
“<sub-object-name>”.
than DECIMAL.
If the statement resulting in the error is creating
6 There must be at least one parameter for
a view, then “<super-object-name>” is a view
a TO SQL transform function.
that cannot be be a superview of view
“<sub-object-name>” because it is not defined as 7 The parameter types for a TO SQL
a typed view or the type of view transform function must all be built-in
“<super-object-name>” is not the direct data types other than DECIMAL.
supertype of the type used in defining view
8 The TO SQL transform function must be
“<sub-object-name>”.
a scalar function.
The statement cannot be processed.
9 The FROM SQL transform function
User Response: Specify a valid type, table, or must be written using LANGUAGE
view in the UNDER clause of the CREATE SQL, or must use another FROM SQL
statement. transform function that is written using
LANGUAGE SQL.
sqlcode: -20013
10 The TO SQL transform function must be
sqlstate: 428DB
written using LANGUAGE SQL or use a
TO SQL transform function that is
written using LANGUAGE SQL.

The statement cannot be processed.

448 Message Reference, Volume 2

User Response:
SQL20015N A transform group
1 Specify a FROM SQL transform function “<group-name>” is not defined
with a signature that has only one for data type “<type-name>”.
parameter.
Explanation: A specified transform group
2 Specify a FROM SQL transform function “<group-name>” is not defined for the data type
where the type of the parameter is the “<type-name>”. The data type “<type-name>”
same as “<type-name>”. may have been explicitly specified in the
statement or may be implicit based on the use of
3 Specify a TO SQL transform function a structured type that requires the existence of
where the RETURNS type is the same as the transform group for the data type.
“<type-name>”.
If “<group-name>” is empty, either the
4 Specify a FROM SQL transform function TRANSFORM GROUP bind option or the
with a RETURNS type that is a built-in CURRENT DEFAULT TRANSFORM GROUP
data type other than DECIMAL. special register was not specified and therefore
5 Specify a FROM SQL transform function there was no transform for “<type-name>”.
where each element of the row has a The statement cannot be processed.
RETURNS type that is a built-in data
type other than DECIMAL. User Response: Define transform group
“<transform-type>” for data type “<type-name>”
6 Specify a TO SQL transform function using the CREATE TRANSFORM statement. If
with a signature that has at least one the error occurred when dropping the transform,
parameter. no action is required because the transform
7 Specify a TO SQL transform function group did not exist for the data type.
where all the parameter types are If “<group-name>” is empty, specify the
built-in data types other than TRANSFORM GROUP bind option on the
DECIMAL. CURRENT DEFAULT TRANSFORM GROUP
8 Specify a TO SQL transform function special register.
that is a scalar function. sqlcode: -20015
9 Specify a FROM SQL transform function sqlstate: 42741
that is written using LANGUAGE SQL,
or that uses another FROM SQL
transform function that is written using SQL20016N The value of the inline length
LANGUAGE SQL. associated with type
“<type-name>” is too small.
10 Specify a TO SQL transform function
that is written using LANGUAGE SQL Explanation: The definition for structured type
or that uses a TO SQL transform “<type-name>” has an INLINE LENGTH value
function that is written using specified that is smaller than the size returned by
LANGUAGE SQL. the constructor function (32 + 10 *
number_of_attributes) for the type and is less
sqlcode: -20014 than 292.
The statement cannot be processed.
sqlstate: 428DC
User Response: Specify an INLINE LENGTH
value that is at least the size returned by the
constructor function for the type or is at least
292. If this error occurs when altering the type
(or some supertype of this type) to add an

Chapter 2. SQL Messages 449

attribute, either the attribute cannot be added or the data types of corresponding columns are
the type must be dropped and re-created with a assignable.
larger INLINE LENGTH value.
sqlcode: -20019
sqlcode: -20016
sqlstate: 42866
sqlstate: 429B2
SQL20020N Operation “<operation-type>” is
SQL20017N Addition of this subtype exceeds not valid for typed tables.
the maximum number of levels of
Explanation: The operation identified by
a type hierarchy.
“<operation-type>” cannot be performed on a
Explanation: The maximum number of levels in typed tables.
a type hierarchy is 99. Adding this type would
The statement cannot be processed.
exceed the maximum.
User Response: Remove the ADD COLUMN
The statement cannot be processed.
clause or SET DATATYPE clause from the ALTER
User Response: Do not add any more subtypes statement. Columns can only be added by
to this type hierarchy. re-defining the table with a structured type that
includes the new column as an attribute.
sqlcode: -20017
Similarly, the data type of a column can only be
sqlstate: 54045 changed by re-defining the table with a type that
includes the column with a different data type.

SQL20018N Row function “<function-name>” sqlcode: -20020

must return at most one row.
sqlstate: 428DH
Explanation: The function is a defined to return
a single row. The result of the processing the
SQL20021N Inherited column or attribute
function is more than one row.
“<name>” cannot be changed or
User Response: Ensure that the function is dropped.
defined in such a way that at most one row is
Explanation: The value of “<name>” identifies
returned.
either a column name or an attribute name
sqlcode: -20018 (depending on the statement context) that is
inherited from a typed table, typed view, or
sqlstate: 21505 structured type above it in the table, view, or
type hierarchy.
SQL20019N The result type returned from the v In the CREATE TABLE statement, the WITH
function body cannot be assigned OPTIONS clause cannot be specified for
to the data type defined in the column “<name>” in the CREATE TABLE
RETURNS clause. statement because it is inherited from a
supertable in the table hierarchy.
Explanation: The data type of each column
returned by the function body must be v In the ALTER TABLE statement, the SET
assignable to the corresponding column specified SCOPE clause cannot be specified for column
in the RETURNS clause. If the function is a “<name>” because it is inherited from a
scalar function, there is only one column. supertable in the table hierarchy.
v In the CREATE VIEW statement, the WITH
User Response: Change the RETURNS type or
OPTIONS clause cannot be specified for
the type returned from the function body so that
column “<name>” in the CREATE VIEW

450 Message Reference, Volume 2

 statement because it is inherited from a
SQL20024N The scope table or view
superview in the view hierarchy.
“<target-name>” is not defined
v In the ALTER TYPE statement, the DROP with structured type
ATTRIBUTE clause cannot be specified for “<type-name>”.
attribute “<name>” because it is inherited
from a supertype in the type hierarchy. Explanation: The scope table or view
“<target-name>” is not valid for use as the scope
The statement cannot be processed. of this reference because it is:
User Response: The options for a column may v not a typed table or
only be set or altered for the table or view in the v not a typed view or
typed table hierarchy or typed view hierarchy
v the type of the table or view is not the same as
where the column is introduced. An attribute can
the target type of the REF type.
only be dropped from the data type in the type
hierarchy where the attribute was introduced. The statement cannot be processed.
sqlcode: -20021 User Response: Specify the scope of the
reference using a typed table or typed view with
sqlstate: 428DJ
the same type as the target type of the REF type.
sqlcode: -20024
SQL20022N The scope for the reference
column ″<column-name>″ is sqlstate: 428DM
already defined.
Explanation: The scope for the reference SQL20025N SCOPE is not specified in the
column ″<column-name>″ cannot be added RETURNS clause of an external
because it is already defined. function or is specified in the
RETURNS clause of a sourced
The statement cannot be processed.
function.
User Response: Remove the ADD SCOPE
Explanation: There are two possible causes:
clause from the ALTER TABLE statement.
v A reference type must have a scope defined
sqlcode: -20022 when used as the result of a user-defined
sqlstate: 428DK external function.
v A reference type cannot have a scope defined
when used as the result of an user-defined
SQL20023N Parameter ″<parm-number>″ of sourced function. The function will use the
the external or sourced function scope of the source function.
has a scope defined.
The statement cannot be processed.
Explanation: A reference type parameter should
not have a scope defined when used with User Response: When defining an external
external or sourced user defined functions. function with a reference type as a returns type,
ensure that the SCOPE clause is specified. When
The statement cannot be processed. defining SOURCED function with a reference
User Response: Remove the SCOPE type as a returns type, ensure that the SCOPE
specification from the definition of the parameter. clause is not specified.

sqlcode: -20023 sqlcode: -20025

sqlstate: 428DL sqlstate: 428DN

Chapter 2. SQL Messages 451

SQL20026N The type ″<type-name>″ is not a SQL20028N The table or view “<table-name>”
structured type or is not an cannot have a different schema
instantiable structured type. name from the other tables or
views in the same hierarchy.
Explanation: The statement requires a
structured type that can be instantiated. The type Explanation: All tables in a typed table
“<type-name>” is either: hierarchy must have the same schema name and
v not a structured type; or all views in a typed view hierarchy must have
the same schema name.
v a structured type that is defined as not
instantiable. The statement cannot be processed.
The statement cannot be processed. User Response: Verify that the schema name of
the table or view is correct. If a hierarchy name
User Response: Verify that the correct type
is specified, verify that its schema name matches
name is used in the statement.
the schema name of the root table or view. If a
sqlcode: -20026 subtable is being created, verify that it is being
created under the correct supertable. If a subview
sqlstate: 428DP is being created, verify that it is being created
under the correct superview.
SQL20027N The subtable or subview sqlcode: -20028
“<sub-object-name>” was not
created because subtable or sqlstate: 428DQ
subview “<object-name>” with
type “<type-name>” already
SQL20029N ″<operation>″ cannot be applied
exists.
to a subtable.
Explanation: Within a typed table or view
Explanation: The operation ″<operation>″ was
hierarchy, only one subtable or subview may
applied to a table that is not the root of a table
exist of a particular subtype. The table or view
hierarchy.
“<sub-object-name>” cannot be created since
there is already a table or view of type The statement cannot be processed.
“<type-name>” defined. The table or view that
User Response: Specify the root table of the
already exists is “<object-name>”.
table hierarchy in the operation.
The statement cannot be processed.
sqlcode: -20029
User Response: Verify that the subtable or
sqlstate: 428DR
subview is being created with the correct type
and that the subtable is being created under the
correct supertable or the subview is being SQL20030N Attributes of a structured type
created under the correct superview. “<type-name>” cannot be added
or dropped when a typed table,
sqlcode: -20027
typed view, or index extension
sqlstate: 42742 “<object-name>” is dependent on
the type.
Explanation: The attributes of a structured type
cannot be added or dropped if a typed table or
typed view of the structured type or any of its
subtypes currently exists. Attributes of a
structured type also cannot be added or dropped
when a column exists in the table that directly or

452 Message Reference, Volume 2

indirectly uses “<type-name>”. Also, attributes of for the first time. Use this as the table name
a structured type cannot be added or dropped when creating the index.
when the type “<type-name>” or one of its
sqlcode: -20032
subtypes is used in an index extension. The table,
view, or index extension “<object-name>” is one sqlstate: 428DS
table, view, or index extension that is dependent
on the structured type “<type-name>”. There
may be other tables, views, or index extensions SQL20033N An expression including
that are dependent on the type or one of its “<partial-expression>” does not
proper subtypes. include a valid scoped reference.

The statement cannot be processed. Explanation: The expression that includes

“<partial-expression>” requires an operand that
User Response: Verify that the right type is is reference type with a scope defined. If the
being altered or drop any tables, views, and expression includes the DEREF function, the
index extensions that are dependent on the argument of the function must be a reference
structured type “<type-name>”. type with a scope defined.
sqlcode: -20030 For the dereference operator (->), the left
operand needs to be a reference type with a
sqlstate: 55043
scope defined.
The statement cannot be processed.
SQL20031N ″<Object>″ may not be defined on
a subtable. User Response: Correct the SQL statement
syntax so the operand or argument is a reference
Explanation: Primary key and unique
type with a scope defined.
constraints can only be defined on the root table
of a typed table hierarchy. Similarly, unique sqlcode: -20033
indexes can only be defined on the root table of
a typed table hierarchy. sqlstate: 428DT

The statement cannot be processed.

SQL20034N The data type ″<list-type-name>″
User Response: Unique indexes, Primary key or is not included in a structured
unique constraints can only be defined on the data type hierarchy that includes
root table of a table hierarchy. the data type ″<left-type-name>″
of the left operand of the TYPE
sqlcode: -20031
predicate.
sqlstate: 429B3
Explanation: All the data types listed in the
TYPE predicate must be included in a data type
SQL20032N Index on the specified columns hierarchy that includes the data type of the left
cannot be defined on subtable operand of the TYPE predicate. The data type
“<table-name>”. ″<left-type-name>″ is not a structured data type
(not part of any type hierarchy) or the data type
Explanation: The columns specified for the
″<list-type-name>″ is not included in the data
index were all introduced at a higher level in the
type hierarchy that includes ″<left-type-name>″.
typed table hierarchy than subtable
“<table-name>”. Therefore, the index cannot be The statement cannot be processed.
created on this subtable.
User Response: Ensure that the data type of the
The statement cannot be processed. expression and all listed data types in the TYPE
predicate are structured data types within the
User Response: Determine the table in the table
same data type hierarchy. If ″<left-type-name>″ is
hierarchy where all of the columns are included

Chapter 2. SQL Messages 453

SYSIBM.REFERENCE, use DEREF to make the
SQL20037N Object identifier column is
result data type of the expression a structured
required to create the root table or
data type.
root view “<object-name>” of a
sqlcode: -20034 typed table or view hierarchy.

sqlstate: 428DU Explanation: When creating the root table of a

typed table hierarchy, an object identifier (OID)
column must be defined (using the REF IS
SQL20035 Invalid left operand of a clause) on the CREATE TABLE statement.
dereference operator. Path
expression starts with When creating the root view of a typed view
“<expression-string>”. hierarchy, an object identifier (OID) column must
be defined (using the REF IS clause) on the
Explanation: The left operand of the dereference CREATE VIEW statement.
operator in a path expression is not valid.
Possible causes are: The statement cannot be processed.
v The left operand includes a column function User Response: Add the required OID column
that uses a column function as an argument. (REF IS clause) to the CREATE TABLE or
v The left operand expression includes a column CREATE VIEW statement.
function and a reference to a column that is
sqlcode: -20037
not in the GROUP BY clause.
sqlstate: 428DX
User Response: Correct the left operand of the
dereference operator for the path expression that
starts with “<expression-string>”. SQL20038N The “<keywords>” clause cannot
be specified with the EXTEND
sqlcode: -20035
USING clause.
sqlstate: 428DV
Explanation: The EXTEND USING clause in the
CREATE INDEX statement cannot be specified
SQL20036N The object identifier column with the “<keywords>” clause.
“<column-name>” cannot be
The statement cannot be processed.
referenced using the dereference
operator. User Response: Remove the specification of
“<keywords>” clause or the EXTEND USING
Explanation: The dereference operator is used
clause from the CREATE INDEX statement.
with “<column-name>” as the right operand.
This column is the object identifier column of the sqlcode: -20038
target table of the dereference and is not valid
sqlstate: 42613
for this operator.
The statement cannot be processed.
SQL20039N The definition of index
User Response: Correct the name of the column “<index-name>” does not match
in the dereference operation. the definition of index extension
“<index-ext-name>”.
sqlcode: -20036
Explanation: The index definition and the index
sqlstate: 428DW
extension definition do not match. The following
lists the possibilities for where the definitions do
not match.
v The number of arguments following the index
extension name in the EXTEND USING clause

454 Message Reference, Volume 2

 is not the same as the number of instance v have the the type of each start key column be
parameters of the index extension. the same as the corresponding transformation
v The data types of the arguments following the function column.
index extension name in the EXTEND USING More precisely, let a1:t1,... an:tn be the function
clause do not match exactly (including length result columns and data types of the key
or precision and scale) the data types of the transformation function. The function result
corresponding instance parameters of the columns of the range-producing function must
index extension. be b1:t1,...,bm:tm,c1:t1,...,cm:tm, where m <= n and
v The number of columns specified for the index the ″b″ columns are the start key columns and
is not same as the number of source key the ″c″ columns are the stop key columns.
parameters of the index extension.
v The data types of the index columns do not The statement cannot be processed.
match exactly (including length or precision User Response: Specify a range-producing table
and scale) the data types of the corresponding function that is consistent with the key
source key parameters of the index extension. transformation table function.
There is an exception to exact matching of
data types for the case of subtypes. The sqlcode: -20040
column of the index may be a subtype of the
sqlstate: 428E1
data type specified as the corresponding
source key parameter.
SQL20041N Number or the type of target key
The statement cannot be processed.
parameters does not match with
User Response: Change the index definition so the number or type of key
that the index extension matches. transform function
“<function-name>” for index
sqlcode: -20039 extension “<index-ext-name>”.
sqlstate: 428E0 Explanation: The number of target key
parameters has to match with the number of
SQL20040N Number or type of the result of results returned by the key transform function. In
the range-producing table addition, the type of the target key parameters
function “<range-function- must exactly match the corresponding function
name>”, is inconsistent with that result types.
of key transformation table The statement cannot be processed.
function “<transform-function-
name>” for index extension User Response: Specify the correct number and
“<index-ext-name>”. type of parameters as the target key parameters.

Explanation: The range-producing function sqlcode: -20041

must:
sqlstate: 428E2
v return up to twice as many columns as
returned by the key transformation function
SQL20042N The maximum allowable
v have an even number of columns (the first half
“<parm-type>” parameters is
of the return columns are the start key values
exceeded in index extension
and the second half of the return columns are
“<index-ext-name>”. The
the stop key values)
maximum is “<max-value>”.
v have the each start key column with the same
type as the corresponding stop key column Explanation: Too many parameters were
specified. If “<parm-type>”is INDEX
EXTENSION, then up to “<max-value>” instance

Chapter 2. SQL Messages 455

parameters may be specified. If “<parm-type>”is
SQL20044N The routine “<routine-name>” or
INDEX KEYS, then up to “<max-value>” key
the CASE expression is not valid
source parameters may be specified.
in a CREATE INDEX
The statement cannot be processed. EXTENSION or CREATE
FUNCTION statement. Reason
User Response: Specify no more than the code = “<reason-code>”.
maximum number of parameters.
Explanation: A routine (function or method)
sqlcode: -20042 “<routine-name>” used in the CREATE INDEX
sqlstate: 54046 EXTENSION or CREATE FUNCTION statement
is not valid where it is used. If “<routine-name>”
is empty, then the CASE expression used for
SQL20043N Argument for routine filtering is not valid. The reason code indicates
“<routine-name>” is not valid. the reason.
Reason code = “<reason-code>”.
1 The key transformation function is not a
Explanation: The routine “<routine-name>” table function.
could be the transformation function, the
range-producing function, or a routine (function 2 The key transformation function is not
or method) referenced in the FILTER USING an external function.
clause. The reason code indicates why an 3 The key transformation function is a
argument is not valid: variant function.
1 For a key transformation function, the 4 The key transformation function is an
argument is not an observer method or external action function.
an index extension instance parameter.
5 The range-producing function is not a
2 The expression used as the argument table function.
uses a routine that specifies
LANGUAGE SQL. 6 The range-producing function is not an
external function.
3 The expression used as the argument is
a subquery. 7 The range-producing function is a
variant function.
4 The data type of an expression used as
the argument cannot be a structured 8 The range-producing function is an
type. external action function.

5 The argument of a key transformation 9 The index-filter function is not an

function cannot have a data type of external function.
structured data type, LOB, DATALINK,
10 The index-filter function is a variant
LONG VARCHAR, or LONG
function.
VARGRAPHIC.
11 The index-filter function is an external
The statement cannot be processed. action function.

User Response: Specify a valid argument for 12 The result type of a filter function or
the function. CASE expression is not an integer data
type.
sqlcode: -20043
13 A subquery is used in a CASE
sqlstate: 428E3 expression or as an argument of a filter
function.

456 Message Reference, Volume 2

The statement cannot be processed.
SQL20047N The search method
User Response: If “<routine-name>” is not “<method-name>” is not found in
empty, specify a routine that conforms to the the index extension
rules for a function or method specified in the “<index-ext-name>”.
specific clause of the CREATE INDEX
Explanation: The method “<method-name>”
EXTENSION or CREATE FUNCTION statement.
referenced in an exploitation rule of the
Otherwise, specify a CASE expression that
user-defined predicate has to match one of the
conforms to the rules for a CASE expression in
search methods specified in the index extension
the FILTER USING clause.
“<index-ext-name>”.
sqlcode: -20044
The statement cannot be processed.
sqlstate: 428E4
User Response: Specify a method defined in the
index extension.
SQL20045N The data type of instance
sqlcode: -20047
parameter “<parameter-name>” is
invalid in index extension sqlstate: 42743
“<index-ext-name>”.
Explanation: An instance parameter must be SQL20048N The search argument of method
one of the following data types: VARCHAR, “<method-name>” does not match
VARGRAPHIC, INTEGER, DECIMAL, or the one in the corresponding
DOUBLE. search method in the index
extension “<index-ext-name>”.
The statement cannot be processed.
Explanation: The search argument provided for
User Response: Specify a valid data type for
method “<method-name>” does not match the
the instance parameter “<parameter-name>”.
argument of the corresponding search method in
sqlcode: -20045 the index extension “<index-ext-name>”. Either
the number of arguments or the type of the
sqlstate: 429B5 arguments do not match the defined number or
type of the parameters.
SQL20046N SELECTIVITY clause following The statement cannot be processed.
“<predicate-string>” can only be
specified for a valid user-defined User Response: Specify a search argument that
predicate. matches the paramters defined in the index
extension.
Explanation: The SELECTIVITY clause is
specified with a predicate that does not include a sqlcode: -20048
valid user-defined function. A valid user-defined
sqlstate: 428E6
function includes a PREDICATES clause with a
WHEN clause that matches the predicate. The
SELECTIVITY clause cannot be specified except SQL20049N Type of an operand following the
with a user-defined predicate. comparison operator in the AS
PREDICATE WHEN clause does
The statement cannot be processed.
not exactly match the RETURNS
User Response: Remove the SELECTIVITY type.
clause following the predicate.
Explanation: The definition of the user-defined
sqlcode: -20046 predicate is not valid. In the AS PREDICATE
WHEN clause, the type of the operand following
sqlstate: 428E5 the the comparison operator is not an exact

Chapter 2. SQL Messages 457

match with the RETURNS type of the function. sqlstate: 428E9
The statement cannot be processed.
SQL20052N Column “<column-name>” is an
User Response: Specify an the operand with the
object identifier column which
correct data type.
cannot be updated.
sqlcode: -20049
Explanation: The UPDATE statement includes
sqlstate: 428E7 setting a column that is an object identifier (OID)
column. An OID column cannot be updated.

SQL20050N The search target or search The statement cannot be processed.

argument “<parameter-name>”
User Response: Remove the SET of
does not match a name in the
″<column-name>″ from the UPDATE statement.
function being created.
sqlcode: -20052
Explanation: Each search target in an index
exploitation rule has to match some parameter sqlstate: 428DZ
name of the function that is being created. Each
search argument in an index exploitation rule
SQL20053N Fullselect in typed view
must match either an expression name in the
“<view-name>” is not valid.
EXPRESSION AS clause or a parameter name of
Reason code = “<reason-code>”.
the function being created. Parameter names
must be specified in the parameter list for the Explanation: The fullselect specified in the
function. definition of typed view “<view-name>” does
not conform to the rules for the fullselect of a
The statement cannot be processed.
typed view. Possible reason codes follow.
User Response: Specify only valid names of the
1 A subview definition contains a
function in the search target or search argument.
common table expression, OR a branch
sqlcode: -20050 in a subview definition does not range
over a single table, view, nickname or
sqlstate: 428E8
an alias.
2 The row-set of a branch over a
SQL20051N The argument
table-hierarchy cannot be proven by the
“<parameter-name>” cannot
database manager to be distinct from
appear as both a search target and
the row-set of all branches over the
a search argument in the same
same table-hierarchy in the rest of the
exploitation rule.
typed view hierarchy.
Explanation: In the exploitation clause, a
3 The first expression of a branch over a
function parameter cannot be specified as an
hierarchy in the root view is:
argument following KEY and as an argument of
the method specified following the USE v not the object identifier column of the
keyword. typed table or typed view referenced
in the FROM clause and the
The statement cannot be processed. UNCHECKED option in the REF IS
User Response: Specify a parameter name of clause is not used OR
the function in no more than on of the search v if the table in the FROM clause is not
target or the search argument. typed, the column is nullable or does
not have a unique index defined on
sqlcode: -20051 only that column and the

458 Message Reference, Volume 2

 UNCHECKED option in the REF IS FROM clause of each branch that is not
clause is not used OR the same as one already used in the
v not identical to the expression in the view hierarchy or use a predicates that
branch over the same hierarchy in the clearly define the row-set for each
subview. branch as distinct compared to the
row-sets for other branches in the typed
4 A table or view over which a branch of view hierarchy.
a subview ranges is not a subtable or
subview of the table or view referenced 3 Ensure that the first column of the root
in any branch of the superview and view conforms to the rules to be a valid
either the subview uses EXTEND AS or object identifier column for the typed
the root view does not have the view. Consider using the UNCHECKED
UNCHECKED option in the REF IS option in the ref is clause.
clause turned on. 4 Specify a subtable or subview of the
5 The fullselect includes references to the table or view specified in the FROM
NODENUMBER or PARTITION clause of a branch of the superview. Or
functions, non-deterministic functions, use the UNCHECKED option in the root
or functions defined to have external view definition in conjunction with the
action. AS (without EXTEND) clause in the
subview definition.
6 A branch in a subview cannot range
over an OUTER table or view if any 5 Remove the reference to the function
branch in its superview ranges over a from the fullselect.
table or view in the same hierarchy 6 If this is the first subview to use OUTER
without using OUTER. in a branch over this hierarchy, change
7 A subview ranges over a view in its the FROM clause so that OUTER is not
own view hierachy. used. If the superview uses OUTER,
include OUTER in the FROM clause of
8 A subview uses a set operation other the subview.
than UNION ALL in its definition OR
UNION ALL is used in the definition 7 Do not source a subview on other views
without specifying the UNCHECKED in the same hierarchy.
option in the REF IS clause of the root 8 If UNION ALL was used, use the
view. UNCHECKED option in the REF IS
9 A subview contains two branches of a clause of the rootview to allow multiple
UNION ALL that range over the same branches in the subview definition. For
table hierarchy or view hierarchy. other set operations encapsulate the set
operation into a view and use the
10 The subview definition contains a UNCHECKED option in the subview to
GROUP BY or HAVING clause. allow sourcing on common views.
User Response: Change the fullselect of the 9 Unify the branches to a select over their
view definition based on the “<reason-code>”. common supertable or superview and
1 Use only one table or view in the FROM use predicates (e.g. the type predicate)
clause. Encapsulate complex selects into to filter for the desired rows.
views that the typed view can range 10 Encapsulate the GROUP BY and
over using the UNCHECKED option of HAVING clause into a view and use the
the root view’s REF IS clause. UNCHECKED option in the root view
2 Specify a different table or view in the to allow sourcing on common views.

Chapter 2. SQL Messages 459

sqlcode: -20053 v Character
v Graphic
sqlstate: 428EA
v Dates or character
v Times or character
SQL20054N The table “<table-name>” is in an
v Timestamps or character
invalid state for the operation.
Reason code = “<reason-code>”. v Datalinks
v the same distinct types
Explanation: The table is in a state that does
not allow the operation. The reason code v reference types where the target type of the
indicates the state of the table that prevents the select list expression is a subtype of the target
operation. type of the attribute.

21 The table is in Datalink Reconcile The statement cannot be processed.

Pending (DRP) state or Datalink User Response: Examine the current definition
Reconcile Not Possible (DRNP) state. for the table and the associated structured type.
22 The function cannot be used in a Ensure the select list expession data type for the
generated column. specified column is a compatible type.
sqlcode: -20055
The statement cannot be processed.
sqlstate: 42854
User Response: The action is based on the
reason code as follows.
SQL20056N Processing on DB2 Data Links
21 Refer to the Administration Guide for Manager “<name>” encountered
information on Datalink Reconcile an error. Reason code =
Pending (DRP) and Datalink Reconcile “<reason-code>”.
Not Possible (DRNP) states to take
appropriate action. Explanation: The processing on the DB2 Data
Links Manager for the statement encountered an
22 Use SET INTEGRITY FOR <table-name> error as indicated by the following reason codes.
OFF before altering the table. Then alter
the table and use SET INTEGRITY FOR 01 An inconsistency was detected between
<table-name> IMMEDIATE CHECKED the data on the DB2 Data Links
FORCE GENERATED to generate the Manager and a DATALINK value in a
values for the new or altered column. table.
02 The DB2 Data Links Manager reached a
sqlcode: -20054 resource limit during the processing.

sqlstate: 55019 99 The DB2 Data Links Manager

encountered an internal processing
error.
SQL20055N A result column data type in the
select list is not compatible with The statement cannot be processed.
the defined data type for column
″<column-name>″. User Response: The action is based on the
reason code as follows.
Explanation: The data type of the select list
expression corresponding to ″<column-name>″ is 01 Run the reconcile utility on the table.
incompatible with the data type for the attribute 02 The DB2 Data Links Manager
of the structured type. Both must be: administrator should identify the
v Numeric

460 Message Reference, Volume 2

 resource from the diagnostic logs and User Response: Change the fullselect in the
take corrective action. CREATE TABLE statement so that so that it
conforms to the rules based on the summary
99 Save the diagnostic logs from the DB2
table options and whether or not the summary
Data Links Manager and the database
table is replicated.
manager and contact IBM service.
sqlcode: -20058
sqlcode: -20056
sqlstate: 428EC

sqlstate: 58004
SQL20059W The summary table
″<table-name>″ may not be used
SQL20057N Column ″<column-name>″ in to optimize the processing of
subview ″<view-name>″ cannot queries.
be defined as read only when the
corresponding column is Explanation: The summary table is defined with
updatable in the superview. REFRESH DEFERRED and a fullselect that is
currently not supported by the database manager
Explanation: The column identified by when optimizing the processing of queries. The
″<column-name>″ in the subview rules are based on the summary table options
″<view-name>″ is defined (implicitly) as read (REFRESH DEFERRED or REFRESH
only. The superview of ″<view-name>″ includes IMMEDIATE). The fullselect in the CREATE
the corresponding column that is updatable. A TABLE statement that returned this condition
column cannot be changed from updatable to violates at least one of the rules as described in
read only in a typed view hierarchy. the SQL Reference.
The statement cannot be processed. The summary table is successfully created.
User Response: Change the CREATE VIEW User Response: No action is required. If the
statement so that the column of the subview summary table was intended for use in
″<view-name>″ is updatable or drop the optimizing the processing of queries, redefine the
superview(s) and recreate them using the READ fullselect to ensure that it is a subselect that
ONLY clause to force the column to be read only. includes a GROUP BY clause.
sqlcode: -20057 sqlcode: +20059
sqlstate: 428EB sqlstate: 01633

SQL20058N The fullselect specified for the SQL20060N The key transform table function
summary table ″<table-name>″ is used by the index extension of
not valid. index “<index-id>” of table
Explanation: The summary table definition has “<table-id>” in “<tbspace-id>”
specific rules regarding the contents of the generated duplicate rows.
fullselect. Some rules are based on the summary Explanation: The key transform table function
table options (REFRESH DEFERRED or specified by the GENERATE USING clause of the
REFRESH IMMEDIATE) while others are based index extension used by index “<index-id>”
on whether or not the table is replicated. The generated duplicate rows. For a given invocation
fullselect in the CREATE TABLE statement that of the key transform table function, no duplicate
returned this condition violates at least one of rows should be produced. This error is occured
the rules as described in the SQL Reference. when inserting or updating the key value for the
The statement cannot be processed. index “<index-id>” of table “<table-id>” in table
space “<tbspace-id>”.

Chapter 2. SQL Messages 461

The statement cannot be processed. The statement cannot be processed.
User Response: The code for the key transform User Response: Specify a TRANSFORM
table function used by the index extension of GROUP clause with a transform group name that
index “<index-id>” must be modified to avoid is defined for “<type-name>”.
the creation of duplicate rows.
sqlcode: -20063
To determine the index name, use the following
sqlstate: 428EM
query:
SELECT IID, INDSCHEMA, INDNAME
FROM SYSCAT.INDEXES AS I, SQL20064N Transform group “<group-name>”
SYSCAT.TABLES AS T does not support any data type
WHERE IID = <index-id> specified as a parameter or
AND TABLEID = <table-id> returned data type.
AND TBSPACEID = <tbspace-id>
AND T.TBASCHEMA = I.TABSCHEMA Explanation: The transform group
AND T.TABNAME = I.TABNAME “<group-name>” specified in the TRANSFORM
GROUP clause is not defined for any data type
sqlcode: -20060 that is included in the parameter list or the
RETURNS clause of a function or method.
sqlstate: 22526 The statement cannot be processed.
User Response: Remove the transform group
SQL20062N Transform function from the function or method definition.
“<transform-type>” in transform
group “<group-name>” for type sqlcode: -20064
“<type-name>” cannot be used for
sqlstate: 428EN
a function or method.
Explanation: The transform function defined in
SQL20065N Transform group “<group-name>”
the transform group “<group-name>” for type
for data type “<type-name>”
“<type-name>” cannot be used for a function or
cannot be used to transform a
method because the transform function is not
structured type for use with a
written in SQL (defined with LANGUAGE SQL).
client application.
The transform group cannot be used for this
function or method. Explanation: The transform group
“<group-name>” for data type “<type-name>”
The statement cannot be processed.
defines a transform function that cannot be used
User Response: Specify a transform group for when performing transforms for client
type “<type-name>” that has the transform applications. The possible reasons for this are
functions defined with LANGUAGE SQL. based on the definition of the transform function
that is not supported for client applications. The
sqlcode: -20062 unsupported transform function may be:
sqlstate: 428EL v a FROM SQL function that is a ROW function
v a TO SQL function has more than one
SQL20063N TRANSFORM GROUP clause parameter
must be specified for type The statement cannot be processed.
“<type-name>”.
User Response: For static embedded SQL,
Explanation: The function or method includes a specify a different transform group using the
parameter or returns data type of “<type-name>” TRANSFORM GROUP bind option. For dynamic
that does not have a transform group specified. SQL, specify a different transform group using

462 Message Reference, Volume 2

the SET DEFAULT TRANSFORM GROUP sqlstate: 42628
statement.
sqlcode: -20065 SQL20068N The structured type
“<type-name>” may not be
defined so that one of its attribute
SQL20066N The “<transform-type>” transform
types directly or indirectly uses
function is not defined in the
itself. The attribute
transform group “<group-name>”
“<attribute-name>” causes the
for data type “<type-name>”.
direct or indirect use.
Explanation: The “<transform-type>” transform
Explanation: Direct use: Type A is said to
function of transform group “<group-name>” for
directly use type B if one of the following is true:
data type “<type-name>” is required for a
transform group used in a function or method v Type A has an attribute of type B
definition. v Type B is a subtype of A, or a supertype of A.
The statement cannot be processed. Indirect use: Type A is said to indirectly use type
B if the following is true:
User Response: If creating a function or
method, specify a different transform group in v Type A uses type C, and type C uses type B.
the function or method definition. If referencing You cannot define a type so that one of its
a structured type in a dynamic SQL statement, attribute types directly or indirectly uses itself.
specify a different transform group for the The type for attribute “<attribute-name>” is the
CURRENT DEFAULT TRANSFORM GROUP cause of the direct or indirect use.
special register. Alternatively, add a
“<transform-type>” transform function to the User Response: Evaluate the type and remove
transform group “<group-name>” for data type the attribute type that causes the direct or
“<type-name>”. indirect use.

sqlcode: -20066 sqlcode: -20068

sqlstate: 42744 sqlstate: 428EP

SQL20067N The “<transform-type>” transform SQL20069N The RETURNS type of the

function is defined more than “<routine-type>”
once in the transform group “<routine-name>” is not the same
“<group-name>” for data type as the subject type.
“<type-name>”. Explanation: The method “<method-name>”
Explanation: A TO SQL or FROM SQL specifies SELF AS RESULT. The RETURNS data
transform function can only be specified once in type of the method must be the same as the
a transform group. The transform group subject data type of the method.
“<group-name>” for data type “<type-name>” User Response: Change the RETURNS type of
has at least two FROM SQL or TO SQL (or both) the method “<method-name>” to match the
transform functions defined. subject type.
The statement cannot be processed. sqlcode: -20069
User Response: Delete the TO SQL or FROM sqlstate: 428EQ
SQL definitions from “<group-name>” in the
transform definition so that there is only one of
each.
sqlcode: -20067

Chapter 2. SQL Messages 463

 associated functional areas you can enable at the
SQL20075N The index or index extension
instance level:
“<index-name>” cannot be created
or altered because the length of 1. The ability to execute distributed request
“<column-name>” is more than operations against multiple data sources in a
255 bytes. single statement.

Explanation: The index could not be created or User Response: Enable the instance for the
altered because the key column length is greater requested action or operation. First, install the
than 255. specified functional area if it is missing. Then,
enable the specified functional area. Enablement
v “<index-name>” is the index name.
steps vary by “<reason-code>”:
v “<column-name>” is the name of the key
1. Set the DBM variable <DREQ> to ON and
column. If this error was returned from an
then restart the database manager. For a
ALTER TABLE operation, then the value of
federated server, set the DBM variable
“<column-name>” is the column number of
<FEDERATED> to YES and then restart the
the table.
database manager.
The index extension could not be created because
sqlcode: -20076
a column returned by the GENERATE KEY
function is greater than 255 bytes.
sqlstate: 0A502
v “<index-name>” is the index extension name.
v “<column-name>” is the name of a column
returned by the GENERATE KEY function. SQL20077N Cannot construct structured type
objects that have Datalink type
The statement could not be processed. The attributes.
specified index or index extension was not
created, or the table could not be altered. Explanation: An attempt was made to invoke
the constructor of a structured type which has a
User Response: If creating an index, eliminate Datalink and/or a Reference type attribute. This
the column from the index definition. If altering functionality is currently not supported. In
a table, reduce the new column length to the Version 6.1 or earlier, this error may also be
permitted maximum. If creating an index issued for a structured type object with a
extension, specify a different GENERATE KEY Reference type attribute.
function, or redefine the function to eliminate the
column. The statement cannot be processed.

sqlcode: -20075 User Response: The error can be corrected by

doing one of the following:
sqlstate: 54008 1. Removing the invocation of the constructor of
the type from the program.
SQL20076N The instance for the database is 2. Removing any Datalink (or Reference) type
not enabled for the specified attributes from the definition of the
action or operation. Reason code = structured type (this may not be possible if
“<reason-code>”. there are any tables that depend on this type).
Explanation: An error has been detected at the sqlcode: -20077
instance level. The requested operation cannot be
completed because a specified functional area sqlstate: 428ED
was not installed or because a specified
functional area was not enabled to the instance.
The following is the list of reason codes and

464 Message Reference, Volume 2

 LANGUAGE “<language-type>”. If the
SQL20078N Hierarchy object “<object-name>”
LANGUAGE is SQL, the method body must be
of type “<object-type>” can not be
an SQL control statement. For other languages,
processed using operation
the EXTERNAL clause must be specified.
“<operation-type>”.
The statement cannot be processed.
Explanation: The operation “<operation-type>”
was attempted using a hierarchy object named User Response: Change the method body to
“<object-name>” of type “<object-type>”. This match the LANGUAGE specified in the method
operation does not support processing of a specification.
hierarchy object.
sqlcode: -20081
The statement could not be processed.
sqlstate: 428ES
User Response: Verify that the correct object
name was used. For objects types TABLE or
VIEW, the object must be the name of a subtable SQL20082N The dynamic type
in the table or view hierarchy. In some cases, the “<expression-type-id>” of the
object must specifically name the root table. For expression is not a subtype of the
objects of type index, the name must be a name target data type “<target-type-id>”
of an index created on a subtable. in a TREAT specification.

sqlcode: -20078 Explanation: The dynamic data type of the

result of the expression specified in the TREAT
sqlstate: 42858 specification is “<expression-type-id>”. The
specified target data type “<target-type-id>” is a
proper subtype of “<expression-type-id>” which
SQL20080N Method specification for
is not allowed.
“<method-name>” cannot be
dropped because a method body The statement cannot be processed.
exists.
User Response: Change the “<target-type-id>”
Explanation: The method specification of the TREAT specification to a supertype of
“<method-name>” still has an existing method “<expression-type-id>” or change the expression
body that must be dropped before the method so that the dynamic data type of the result is a
specification can be dropped. subtype of “<target-type-id>”.
The statement cannot be processed. To determine the data type names for
“<expression-type-id>” and “<target-type-id>”,
User Response: Use the DROP METHOD
use the following query:
statement with the same method specification to
drop the method body and then issue the ALTER SELECT TYPEID, TYPESCHEMA, TYPENAME
TYPE statement again to drop the method FROM SYSCAT.DATATYPES
specification. WHERE TYPEID IN INTEGER(
“<expression-type-id>”),
sqlcode: -20080 INTEGER(“<target-type-id>”))

sqlstate: 428ER
sqlcode: -20082

SQL20081N The method body cannot be sqlstate: 0D000

defined for a LANGUAGE
“<language-type>” method
specification “<method-name>”.
Explanation: The method
specification“<method-name>” is defined with

Chapter 2. SQL Messages 465

 method may not be in an overriding relationship.
SQL20083N The data type of the value
This means that if the function were a method
returned by “<routine-type>”
with its first parameter as subject S, it must not
“<routine-id>” does not match the
override another method of any supertype of S
data type specified as RESULT.
and it must not be overriden by another method
Explanation: The method “<routine-id>” of any subtype of S.
specifies SELF AS RESULT and therefore requires
that the data type of the value returned must be The statement cannot be processed.
the same as the subject data type used to invoke
the method. The RETURN statement in either the User Response: Change the routine that is
SQL method body or in the TO SQL transform being defined to use a different routine name
function for the type of an external method than “<routine-name>” or change the parameters
resulted in the incorrect data type. of the routine.

The statement cannot be processed. sqlcode: -20084

User Response: Change the RETURN statement sqlstate: 42745

of the method or transform function to ensure
that the data type of the returned value is always SQL20085N A routine defined with
the subject type used to invoke the method. PARAMETER STYLE JAVA cannot
To determine the routine name associated with have structured type
the “<routine-id>”, use the following query: “<type-name>” as a parameter
type or as the returns type.
SELECT FUNCSCHEMA, FUNCNAME, SPECIFICNAME
FROM SYSCAT.FUNCTIONS Explanation: A routine is defined with
WHERE FUNCID = INTEGER(“<routine-id>”) PARAMETER STYLE JAVA and one of the
parameter types or a returns type is defined
sqlcode: -20083 using the structured type “<type-name>”. This is
not supported by this version of DB2.
sqlstate: 2200G
The statement cannot be processed.
User Response: Change to a different parameter
SQL20084N The “<routine-type>”
style for the routine or remove the structured
“<routine-name>” would define
type from the routine definition.
an overriding relationship with an
existing method. sqlcode: -20085
Explanation: A method MT, with subject type T, sqlstate: 429B8
is defined to override another method MS, with
subject type S, if all of the following conditions
SQL20086N Length of the structured type
are true:
value for a column exceeds the
v MT and MS have the same unqualified name system limit.
and the same number of parameters.
Explanation: The value for a structured type
v T is a proper subtype of S.
column exceeds 1 gigabyte in overall size,
v The non-subject parameter-types of MT are the including descriptor data for the instance. The
same as the corresponding non-subject column could be one that is being inserted or
parameter-types of MS. (Here, “same” applies updated directly or it may be a column that is
to the basic type, such as VARCHAR, generated.
disregarding length and precision).
The statement cannot be processed.
No method may override, or be overridden by,
another method. Furthermore, a function and a User Response: Reduce the size of the

466 Message Reference, Volume 2

structured type value that is being assigned to
SQL20090W The use of the structured type
the column.
having attribute
sqlcode: -20086 “<attribute-name>” of type
DATALINK is effectively limited
sqlstate: 54049 to the type of a typed table or
type view.
SQL20087N DEFAULT or NULL cannot be Explanation: The attribute “<attribute-name>”
used in an attribute assignment. is defined with a type of DATALINK or a
Explanation: The UPDATE statement is using distinct type based on a DATALINK. A
an attribute assignment to set the value of an structured type that includes such an attribute
attribute in a structured type column. This form can only be used as the type of a table or view. If
of assignment statement does not allow the use used as the type of a column of a table or view it
of the keyword DEFAULT or the keyword NULL can only be assigned the null value.
as the right hand side of the assignment. The statement continued processing.
The statement cannot be processed. User Response: Consider the intended use of
User Response: Specify an expression for the the structured type. If the type will be used as a
right hand side of the attribute assignment or column data type, then remove the attribute
change the assignment so it is not using the “<attribute-name>” from the structured type or
attribute assignment syntax. use a data type other than DATALINK for the
attribute.
sqlcode: -20087
sqlcode: +20090
sqlstate: 428B9
sqlstate: 01641

SQL20089N A method name cannot be the

same as a structured type name SQL20093N The table “<table-name>” cannot
within the same type hierarchy. be converted to or from a
summary table. Reason code =
Explanation: A specified method name is the “<reason-code>”.
same as the structured type which is defined for
one of the supertypes or subtypes of the Explanation: The ALTER TABLE statement is
structured type. being used to change a table from a summary
table to DEFINITION ONLY or to convert a
The statement cannot be processed. regular table to a summary table. The ALTER
User Response: Specify a different name for the TABLE statement failed as indicated by the
method. following reason codes.

sqlcode: -20089 1 The table is a typed table or hierarchy

table.
sqlstate: 42746
2 The table is not a summary table and
DEFINITION ONLY was specified.
3 The table is a replicated summary table
and DEFINITION ONLY was specified.
4 The table has at least one trigger
defined.
5 The table has at least one check
constraint defined.

Chapter 2. SQL Messages 467

6 The table has at least one unique 5 Drop any check constraints and try the
constraint or unique index defined. ALTER TABLE statement again.
7 The table has at least one referential 6 Drop any unique constraints and unique
constraint defined. indexes. Try the ALTER TABLE
statement again.
8 The table is referenced in the definition
of an existing summary table. 7 Drop any referential constraints and try
the ALTER TABLE statement again.
9 The table is referenced directly or
indirectly (through a view, for example) 8 Drop the summary table that references
in the fullselect. the table and try the ALTER TABLE
statement again.
10 The table is already a summary table.
9 A summary table cannot reference itself.
11 The number of columns of the existing
Modify the fullselect to remove the
table does not match the number of
direct or indirect reference to the table
columns defined in the select list of the
being altered.
fullselect.
10 The operation is not allowed since the
12 The data types of the columns of the
table is already a summary table.
existing table do not exactly match the
corresponding columns in the select list 11 Modify the fullselect to include the
of the fullselect. correct number of columns in the select
list.
13 The column names of the columns of
the existing table do not exactly match 12 Modify the fullselect so that the result
the corresponding column names in the column data types exactly match the
select list of the fullselect. data types of the corresponding existing
columns.
14 The nullability characteristics of the
columns of the existing table do not 13 Modify the fullselect so that the result
exactly match the nullability column names exactly match the
characteristics of the corresponding column names of the corresponding
columns in the select list of the existing columns.
fullselect.
14 The table cannot be converted to a
15 The conversion cannot be performed if summary table unless the nullability
there are any other table alterations in characteristics can be matched. Create a
the same ALTER TABLE statement. new summary table instead.
User Response: The action is based on the 15 Perform the other table alterations in an
reason code as follows. ALTER TABLE statement that does not
include the SET SUMMARY AS clause.
1 The table cannot be converted to a
summary table. Create a new summary
sqlcode: -20093
table instead.
2 There is no need to convert this table. sqlstate: 428EW
No action required.
3 A replicated table can only be a
summary table. Create a new table
instead.
4 Drop any triggers and try the ALTER
TABLE statement again.

468 Message Reference, Volume 2

 referenced as a new transition variable in a
SQL20094N The column “<column-name>” is
BEFORE trigger.
GENERATED using an expression
and cannot be used in the User Response: Remove the reference to
BEFORE trigger “<trigger-name>”. “<column-name>” in the trigger
“<trigger-name>”.
Explanation: The value for column
“<column-name>” is generated using an sqlcode: -20094
expression and cannot be named in the column
name list of a BEFORE UPDATE trigger or sqlstate: 42989

SQL20100 - SQL20199
2. There has been a syntax error in IP address of
SQL20108N A result set contains an
debugger client in the debugger table.
unsupported data type in position
“<position-number>” for the 3. A timeout in the communication between the
cursor “<cursor-name>” opened debugger backend and the debugger client
by the stored procedure occurred.
“<procedure-name>”. 4. A problem occured accessing the debugger
table DB2DBG.ROUTINE_DEBUG.
Explanation: The stored procedure named by
procedure-name cannot return at least one of its User Response:
query result sets named by cursor-name because 1. Verify that you install the debugger option on
at least one of the columns, column the DB2 server machine.
position-number contains a data type which is
not supported by either the DRDA Application 2. Make sure that the IP address in the
Requestor (client) or the DRDA Application debugger table has the correct syntax.
Server (server). As such the call to the stored 3. Check that the debugger demon on the client
procedure fails. is started and that the ports on the client and
server match.
User Response: Modify the OPEN statement
(and subsequent FETCH statements) for cursor 4. Verify that you have created the debugger
cursor-name in the stored procedure tables with the correct layout.
procedure-name on the server to not select the sqlcode: +20109
unsupported data type in column
position-number. The client application which sqlstate: 01637
invoked the stored procedure may need to be
modified to reflect the change in the stored
procedure. SQL20111N A SAVEPOINT, RELEASE
SAVEPOINT, or ROLLBACK TO
sqlcode: -20108 SAVEPOINT statement cannot be
sqlstate: 56084 issued in this context. Reason
code = “<reason-code>”.

SQL20109W Error in DB2 debugger support. Explanation: The statement cannot be processed
Reason code: “<reason-code>”. because it violates a restriction as indicated by
the following reason code:
Explanation: The debugger support had an
1. Savepoint cannot be issued inside a trigger.
error situation which will disable debugging, but
not affect normal execution. The following is a 2. Savepoint cannot be issued inside a global
list of reason codes: transaction.
1. The debugger support is not installed. The statement cannot be processed.

Chapter 2. SQL Messages 469

User Response: Remove the SAVEPOINT, sqlcode: -20113
RELEASE SAVEPOINT, or ROLLBACK TO
SAVEPOINT statement in the trigger or global sqlstate: 22004
transaction.
sqlcode: -20111 SQL20114W Column “<column-name>” in
table “<table-name>” is not long
sqlstate: 3B503
enough for the defined length of
the USER default value.
SQL20112N A SAVEPOINT cannot be set
Explanation: The column “<column-name>” is
because a SAVEPOINT already
defined with a length that is less than 128 bytes.
exists and nested SAVEPOINTS
The clause DEFAULT USER has been specified
are not supported.
for this column. Since the USER special register
Explanation: An error occurred in a is defined as VARCHAR(128), any attempt to
SAVEPOINT or atomic compound SQL assign the default value for “<table-name>” by a
statement. A savepoint already exists and nested user with a user ID longer than the column
savepoints are not supported in this length results in an error. A user with a user ID
environment. longer than the column length would never be
able to insert or update this column to the
User Response: If re-establishing an existing
default value.
savepoint is necessary, issue the RELEASE
SAVEPOINT statement to free the existing User Response: If your system standards would
savepoint, and then reissue the SAVEPOINT not allow a user ID to exceed the length of the
statement. For atomic compound SQL, a column, then this warning may be ignored. To
SAVEPOINT cannot be set until after the end of prevent this warning from occuring, the length of
the compound statement. the column must be at least 128 bytes. You can
change the column length by dropping and
sqlcode: -20112
creating the table again, or, if the data type is
sqlstate: 3B002 VARCHAR, by using ALTER TABLE to increase
the length of the column.

SQL20113N Null cannot be returned from sqlcode: +20114

method “<method-id>” defined
sqlstate: 01642
with SELF AS RESULT.
Explanation: The method with method
SQL20115N The “<routine-type>”
identifier “<method-id>” is defined with SELF
“<routine-name>” cannot be used
AS RESULT. The invocation of the method used
as a “<transform-type>” transform
a non-null instance of a structured type so the
function in transform group
method cannot return a null instance.
“<group-name>”.
User Response: Change the method
Explanation: If “<routine-type>” is FUNCTION,
implementation to ensure that a null value is not
then the function defined by “<routine-name>”
returned as the return value for the method. One
cannot be used as a transform function because it
possibility is to set all the attributes of the
is a builtin function. If “<routine-type>” is
returned structured type to null value. To
METHOD, then the method defined by
determine the name of the method that failed,
“<routine-name>” cannot be used as a transform
use the following query:
function because it is a method.
SELECT FUNCSCHEMA, FUNCNAME, SPECIFICNAME
FROM SYSCAT.FUNCTIONS The statement cannot be processed.
WHERE FUNCID = method-id
User Response: Specify a different function for

470 Message Reference, Volume 2

the “<transform-type>” transform function of after CURRENT ROW or UNBOUNDED
transform group “<group-name>”. FOLLOWING is specified before
CURRENT ROW.
sqlcode: -20115
sqlstate: 428EX The statement cannot be processed.
User Response: Change the window
SQL20116N The data type of the search target specification to correct the invalid specification
“<parameter-name>” does not indicated by the “<reason-code>”.
match that of the source key
1 Add a window ORDER BY clause to
specified in the index extension
each window specification that specifies
“<index-extension-name>”.
RANGE.
Explanation: If the search target is of a built-in
2 Ensure that each window specification
or distinct data type, its type must exactly match
that includes RANGE has exactly one
that of the source key specified in the index
sort-key-expression in the window
extension. If the data type of the search target is
ORDER BY clause.
a structured type, it must be in the same
structured type hierarchy as the data type of the 3 For each window specification that
source key in the index extension. includes RANGE, ensure that the range
value can be subtracted from the
The statement cannot be processed.
sort-key-expression in the window
User Response: Specify a search target with a ORDER BY clause, which must be a
data type that matches that of the source key in numeric type or a datetime type. For
the index extension. datetime sort-key-expressions, the range
value must be the specific datetime
sqlcode: -20116
duration DECIMAL type with the
sqlstate: 428EY correct precision and scale.
4 Ensure that any window specification
SQL20117N A window specification for an using “BETWEEN” and “CURRENT
OLAP function is not valid. ROW” has the “UNBOUNDED
Reason code = “<reason-code>”. PRECEDING” before “AND CURRENT
ROW” or “UNBOUNDED
Explanation: The window specification (OVER FOLLOWING” after “CURRENT ROW
clause) of an OLAP function invocation is not AND”.
correctly specified. The incorrect specification is
indicated by the “<reason-code>”.
sqlcode: -20117
1 RANGE is specified without an ORDER
BY in the window specification. sqlstate: 428EZ
2 RANGE is specified and the window
ORDER BY clause includes more than SQL20118N Structured type “<type-name>”
one sort-key-expression. has more than the maximum
number of allowable attributes.
3 RANGE is specified and the data type
The maximum is “<max-value>”.
of the range value cannot be used in a
subtraction expression with the data Explanation: The maximum number of
type of the sort-key-expression in the attributes, including inherited attributes, allowed
window ORDER BY clause. for each structured type has been exceeded with
the definition of structured type “<type-name>”.
4 UNBOUNDED PRECEDING is specified
The maximum number of attributes, including

Chapter 2. SQL Messages 471

inherited attributes, is “<max-value>”. sqlcode: -20119
The statement cannot be processed. sqlstate: 428F0
User Response: Ensure that the number of
attributes for the structured type does not exceed SQL20120N An SQL TABLE function must
the limit. return a table result.
sqlcode: -20118 Explanation: An SQL function that specifies
TABLE in the RETURNS clause must return a
sqlstate: 54050
result that is a table. With the exception of a
scalar fullselect, a scalar expression cannot be
SQL20119N A ROW function must define at returned as the result of an SQL TABLE function.
least two columns.
User Response: Either remove the TABLE
Explanation: A function that specifies ROW in keyword from the RETURNS clause to make it a
the RETURNS clause must include a column list scalar function or specify a fullselect in the
with at least two columns. RETURN statement of the TABLE function body.

User Response: Either remove the ROW sqlcode: -20120

keyword from the RETURNS clause to make it a
sqlstate: 428F1
scalar function or specify multiple columns in
the column list of the RETURNS clause.

SQL20200 - SQL20299
correct format. If the jar id exists, it may need to
SQL20200N The install or replace of
be removed before it can be installed. For the
“<jar-id>” failed as “<url>” could
remove or replace procedures, ensure the jar id
not be located.
exists.
Explanation: The URL specified on the install or
sqlcode: -20201
replace jar procedure did not identify a valid jar
file. sqlstate: 46002
User Response: Reissue the install or replace jar
procedure with a URL that identifies a valid jar SQL20202N The replace or remove of
file. “<jar-id>” failed as “<class>” is in
use.
sqlcode: -20200
Explanation: The specified class in the jar file is
sqlstate: 46001
currently in use by a defined procedure, or the
replacement jar file does not contain the specified
SQL20201N The install, replace or remove of class for which a procedure is defined.
“<jar-id>” failed as the jar name
User Response: Ensure all procedures
is invalid.
referencing the classes being removed are
Explanation: The jar name specified on the dropped and resubmit the replace or remove
install, replace or remove jar procedure was procedure.
invalid. For example, the jar id may be of the
sqlcode: -20202
improper format, may not exist to be replaced or
removed, or can not be installed as it already sqlstate: 46003
exists.
User Response: Ensure the jar id is of the

472 Message Reference, Volume 2

 parameter with a null value but the Java
SQL20203N User defined function or
datatype of this argument does not support null
procedure “<function-name>” has
values. Examples of Java datatypes that do not
a Java method with an invalid
support null values are BOOLEAN, BYTE,
signature.
SHORT, INT, LONG or DOUBLE.
Explanation: The signature of the java method
User Response: If the method is to be called
used to implement the function or procedure was
with null values, ensure the input Java types are
invalid. For example, the method may have
capable of accepting a null value. For functions,
parameters that are not mappable to the
the function could also be created with
parameters on the corresponding create
″RETURNS NULL ON NULL INPUT″.
statement or the method for a procedure may
specify a return value. sqlcode: -20205
User Response: Reissue the corresponding sqlstate: 39004
CREATE statement specifying parameters that
match the Java method, or correct the parameters
or return type of the Java method and rebuild SQL20206W The procedure “<function-name>”
the class. returned too many result sets.

sqlcode: -20203 Explanation: The specified procedure returned

more results sets than were specified on the
sqlstate: 46007 CREATE PROCEDURE statement.
User Response: Modify the procedure to return
SQL20204N The user defined function or fewer result sets, or drop and recreate the
procedure “<function-name>” was procedure specifying the correct number of result
unable to map to a single Java sets.
method.
sqlcode: +20206
Explanation: The identified function or
procedure either failed to find a matching Java sqlstate: 0100E
method, or found more than 1 matching Java
method. SQL20207N The install or remove jar
User Response: Correct either the Java method procedure for “<jar-id>” specified
or corresponding create statement so that the the use of a deployment
function or procedure call resolves to a single descriptor.
Java method. Explanation: The DEPLOY or UNDEPLOY
sqlcode: -20204 parameter of the install or replace jar procedure
was non-zero; this parameter is not supported
sqlstate: 46008 and must be zero.
User Response: Reissue the procedure with the
SQL20205N The user defined function or DEPLOY or UNDEPLOY parameter set to zero.
procedure “<function-name>” has
an input argument with a null sqlcode: -20207
value that could not be passed to sqlstate: 46501
the method.
Explanation: A function created with ″CALLED
ON NULL INPUT″ or procedure has an input

SQL29000 - SQL29100

Chapter 2. SQL Messages 473

 User Response: Ensure that the correct version
SQL29000N The value specified for
of the DB2 Query Patroller client is installed.
DYN_QUERY_MGMT is not
valid. DB2 Query Patroller is not
installed on this server. SQL29005N User “<user-ID>” is not defined
in the user profile table.
Explanation: The attempt to update the
database configuation parameter Explanation: User “<user-ID>” is not defined in
DYN_QUERY_MGMT to ENABLE failed because the user profile table. The user, or the group to
the DB2 Query Patroller server is not installed. which the user belongs, must be defined in the
user profile table.
User Response: Install the DB2 Query Patroller
server. User Response: Use Query Administration to
define the user in the user profile table.
SQL29001N This database client level is not
compatible with the level of DB2 SQL29006N Java exception
Query Patroller server you are “<exception-string>” was thrown.
running on.
Explanation: Java exception
Explanation: The client and server code are not “<exception-string>” was thrown.
compatible.
User Response: Please refer to the First Failure
Data Service Log (db2diag.log) for additional
SQL29002N DB2 Query Patroller is not information.
installed on this server.
If the problem persists contact your technical
Explanation: DB2 Query Patroller server tables service representative.
do not exist on the server.
User Response: Install the DB2 Query Patroller SQL29007N DB2 Query Patroller Server is not
server. available.
Explanation: DB2 Query Patroller server is not
SQL29003N DB2 Query Patroller could not running.
load Java class “<class-name>”,
reason code “<reason-code>”. User Response: Start DB2 Query Patroller
server and resubmit your query.
Explanation: An error occurred while trying to
load the Java class “<class-name>”. The reason
codes are: SQL29008N Error encountered during job
sequence number generation.
1 The class was not found on the
CLASSPATH. Explanation: An error was encountered during
job sequence number generation.
User Response: Ensure the “<class-name>” is
installed in the CLASSPATH. User Response: Please refer to the First Failure
Data Service Log (db2diag.log) and the DB2
Query Patroller log file (syserr.log) for additional
SQL29004N DB2 Query Patroller class information.
“<class-name>” cannot call
method “<method-name>” with If the problem persists contact your technical
signature “<signature>”. service representative.

Explanation: The Java method

“<method-name>” cannot be found.

474 Message Reference, Volume 2

 User Response: Correct the value of the DB2
SQL29009N Error encountered when
registry variable “<registry-variable>” with the
submitting a new job. Reason
db2set command and resubmit the query.
code “<reason-code>”.
Explanation: An error was encountered during
SQL29015N Error encountered during job
submission of a new job.
cancellation. Reason code:
User Response: Examine the reason code and “<reason-code>”.
resubmit the query.
Explanation: An error was encountered while
trying to cancel a job. The reason code maps to
SQL29010N The query has been cancelled. an SQL or DB2 message.
Explanation: User has cancelled the query. User Response: Examine the reason code,
correct the error, and retry the action again.
SQL29011I Job “<job-ID>” has been
submitted. SQL29016N The data source on the client does
not match the data source on the
Explanation: Job “<job-ID>” has been submitted
DB2 Query Patroller server.
to the DB2 Query Patroller server.
Explanation: The data source to which the
client is connected does not match the data
SQL29012N Job “<job-ID>” has been aborted.
source that is used by the DB2 Query Patroller
Explanation: Job “<job-ID>” has been aborted. server.

User Response: Use QueryMonitor or the User Response: Ensure that the DB2DBDFT
iwm_cmd command to examine the reason for profile variable on the DB2 Query Patroller
the aborted job and resubmit the query. server matches the client data source name.

SQL29013I Job “<job-ID>” has been held. SQL29017N Job “<job-id>” has been
cancelled.
Explanation: Job “<job-ID>” has been put on
hold. Explanation: Job “<job-id>” has been cancelled.
User Response: None.
SQL29014N The value specified for DB2
registry variable
SQL29018N The DB2 Query Patroller Client is
“<registry-variable>” is invalid.
not installed.
Explanation: The value specified for
Explanation: The user is querying a database
“<registry-variable>” is invalid because of the
which has enabled the database configuration
following restrictions by “<registry-variable>”:
parameter DYN_QUERY_MGMT. However, the
DQP_NTIER DB2 Query Patroller client code is not installed
The value must be one of OFF, on the client machine.
RUN[:timeout], or CHECK[:timeout].
User Response: Install the QueryEnabler
DQP_LAST_RESULT_DEST component of the DB2 Query Patroller client.
The length must not exceed 32
characters.
SQL29019N Jobs have been scheduled on the
DQP_TRACEFILE DB2 Query Patroller server.
The length must not exceed 256
Explanation: Jobs have been scheduled on the
characters.
DB2 Query Patroller server.

Chapter 2. SQL Messages 475

User Response: None.

SQL30000 - SQL30099
received a warning SQLCODE that requires the
SQL30000N Execution failed because of a
program or end user to either re-issue the
Distributed Protocol Error that
chained statement or issue a different SQL
will not affect the successful
request. This error can occur only in a
execution of subsequent
client/server environment.
commands or SQL statements:
Reason Code “<reason- v A distributed client using DRDA has chained
code(subcode)>”. an OPEN statement to a PREPARE, but the
PREPARE statement received SQLCODE
Explanation: A system error occurred that +1140.
prevented successful processing of the current
environment command or SQL statement. This The statement cannot be executed as chained.
message (SQLCODE) is produced at statement User Response: The statement must be sent
compilation or execution time. again as a separate request.
The command or statement cannot be processed. sqlcode: -30002
The current transaction is not rolled back and the
application remains connected to the remote sqlstate: 57057
database.
User Response: Record the message number SQL30020N Execution failed because of a
and the reason code. Record all error information Distributed Protocol Error that
from the SQLCA, if possible. Attempt to rerun will affect the successful
the application. execution of subsequent
commands and SQL statements:
If sufficient memory resources exist and the Reason Code “<reason-code>”.
problem continues, invoke the Independent Trace
Facility at the operating system command Explanation: A system error occurred that
prompt. Refer to the Independent Trace Facility prevented successful execution of the current
in the Troubleshooting Guide for information on environment command or SQL statement, as well
how to use this facility. as any subsequent commands or SQL statements.
Required information: The command or statement cannot be processed.
v Problem description The current transaction is rolled back and the
application is disconnected from the remote
v SQLCODE and reason code database.
v SQLCA contents if possible
User Response: Record the message number
v Trace file if possible. (SQLCODE) and the reason code. Record all
sqlcode: -30000 error information from the SQLCA, if possible.
Attempt to connect the remote database and
sqlstate: 58008 rerun the application.
If sufficient memory resources exist and the
SQL30002N The SQL statement cannot be problem continues, invoke the Independent Trace
executed due to a prior condition Facility at the operating system command
in a chain of statements. prompt. Refer to the Independent Trace Facility
in the Troubleshooting Guide for information on
Explanation: An SQL statement was chained to how to use this facility.
PREPARE, but the PREPARE statement has
Required information:

476 Message Reference, Volume 2

v Problem description User Response: Record the message number,
v SQLCODE and reason code the “<manager>”, and “<level>” values. Record
all error information from the SQLCA, if
v SQLCA contents if possible
possible. Attempt to connect to the remote
v Trace file if possible. database again.
Some possible reason codes include: If the problem persists, invoke the Independent
121C Indicates that the user is not authorized Trace Facility at the operating system command
to perform the requested command. prompt. Refer to the Independent Trace Facility
in the Troubleshooting Guide for information on
1232 The command could not be completed how to use this facility. Then, contact your
because of a permanent error. In most service representative with the following
cases, the server will be in the process information:
of an abend. v Problem description
220A The target server has received an invalid v SQLCODE and reason code
data description. If a user SQLDA is v SQLCA contents if possible
specified, ensure that the fields are
initialized correctly. Also, ensure that the v Trace file if possible.
length does not exceed the maximum sqlcode: -30021
allowed length for the data type being
used. sqlstate: 58010
If you are using the DB2 Connect
product in a gateway server SQL30040N Execution failed because of
environment with downlevel clients, this unavailable resources that will not
error may occur if your application’s affect the successful execution of
host variables and the queried table’s subsequent commands and SQL
column descriptions do not match. statements: Reason “<reason>”.
Type of Resource
sqlcode: -30020 “<resource-type>”. Resource name
“<resource-name>”. Product ID
sqlstate: 58009 “<product-ID>”.
Explanation: The application cannot process the
SQL30021N Execution failed because of a command or SQL statement because the specified
Distributed Protocol Error that resource has run out. The current transaction is
will affect the successful not rolled back and the application remains
execution of subsequent connected to the remote database.
commands and SQL statements:
Manager “<manager>” at Level The command cannot be processed.
“<level>” not supported. User Response: Increase the size of the
Explanation: A system error occurred that specified resource and resubmit the command.
prevented successful connection of the sqlcode: -30040
application to the remote database. This message
(SQLCODE) is produced for SQL CONNECT sqlstate: 57012
statement. ″<manager>″ and ″<level>″ are
numeric values that identify the incompatibility
between the client and the server.
The command cannot be processed.

Chapter 2. SQL Messages 477

 sqlstate: 57013
SQL30041N Execution failed because of
unavailable resources that will
affect the successful execution of SQL30050N “<number>” command or SQL
subsequent commands and SQL statement invalid while bind is in
statements: Reason “<reason>”. progress.
Type of Resource
“<resource-type>”. Resource name Explanation: An application attempted to issue
“<resource-name>”. Product ID a command or SQL statement that is not valid
“<product-ID>”. while a precompile/bind operation is in
progress. <number> is a numeric value that
Explanation: The application cannot process the identifies the erroneous command or SQL
command or SQL statement because resources statement.
are not available at the remote database. This
SQLCODE is produced at statement compilation The command or statement is not processed.
or processing time. User Response: If the application is not the
Federated system users: this situation can also be database manager precompiler/binder, verify
detected by the data source. that bind is not active before issuing the
command or SQL statement.
If the “<resource name>” is “Encrypt” or
“Decrypt”, the user exits for password If the application is the database manager
encryption or decryption are unavailable or had precompiler/binder, record the message number
an error. (SQLCODE) and the <number> value. Record all
error information from the SQLCA, if possible.
The command or statement cannot be processed. Attempt to perform the bind operation again.
User Response: Investigate the remote database If sufficient memory resources exist and the
system environment. problem continues, invoke the Independent Trace
Facility at the operating system command
Federated system users:
prompt. Refer to the Independent Trace Facility
v If the password encryption or decryption user in the Troubleshooting Guide for information on
exit failed, “<reason>” is the integer value that how to use this facility.
the federated server received when invoking
the user exit. Ensure that no errors occurred Contact your technical service representative
when the encryption and decryption user exits with the following information:
were link-edited with the federated server. Required information:
If using a user-supplied user exit, please check v Problem description
the user exit source code to determine why the
“<reason>” was returned. If the error is found v SQLCODE and reason code
in the user exit source code, fix the error, v SQLCA contents if possible
link-edit the object code with the federated v Trace file if possible.
server, and reissue the failing command or
statement. sqlcode: -30050
v For all other cases, isolate the problem to the
sqlstate: 58011
data source failing the request (refer to the
problem determination guide to determine
which data source is failing in processing an SQL30051N Bind process with the specified
SQL statement), correct the problem at the package name and consistency
data source, and reissue the failing command token not active.
or statement.
Explanation: An attempt has been made to
sqlcode: -30041 issue a precompile/bind operation when

478 Message Reference, Volume 2

precompile/bind is not active or an attempt was sqlcode: -30052
made to use an invalid package name and/or
sqlstate: 42932
consistency token during an active
precompile/bind operation.
SQL30053N The value for OWNER failed the
The command or statement cannot be processed.
authorization check at the remote
User Response: If the application is not the database.
database manager precompiler/binder, verify
Explanation: The value specified for the
that precompile/bind is active before issuing the
OWNER option on the precompile/bind failed
bind operation and that correct information is
the authorization check at the remote database.
being passed on the bind operation.
This SQLCODE is produced during
If the application is the database manager precompile/bind. It is not produced by the
precompiler/binder, record the message number database manager precompiler/binder.
(SQLCODE) and all error information from the
The precompile/bind operation cannot be
SQLCA, if possible. Attempt to perform the
processed.
operation again.
User Response: Ensure that you are authorized
If sufficient memory resources exist and the
to use the ID specified for the OWNER option,
problem continues, invoke the Independent Trace
or do not use the OWNER option.
Facility at the operating system command
prompt. Refer to the Independent Trace Facility sqlcode: -30053
in the Troubleshooting Guide for information on
how to use this facility. sqlstate: 42506

Contact your technical service representative

with the following information: SQL30060N “<authorization-ID>” does not
have the privilege to perform
Required information: operation “<operation>”.
v Problem description Explanation: Authorization ID
v SQLCODE and reason code <authorization-ID> attempted to perform the
v SQLCA contents if possible specified <operation> without having been
granted the proper authorization to do so. This
v Trace file if possible.
SQLCODE is produced at statement compilation
sqlcode: -30051 or processing time.
The statement cannot be processed.
sqlstate: 58012
User Response: Ensure that the
<authorization-ID> has been granted the
SQL30052N Program preparation assumptions
authorization necessary to perform the desired
are incorrect.
operation.
Explanation: The SQL statement being compiled
sqlcode: -30060
is not recognized by the precompiler and cannot
be processed by the database. sqlstate: 08004
The statement cannot be processed.
SQL30061N The database alias or database
User Response: Ensure that the statement is
name “<name>” was not found at
correct and attempt to perform the operation
the remote node.
again. If the problem continues, remove the
statement from the program. Explanation: The database name is not an
existing database at the remote database node.

Chapter 2. SQL Messages 479

The statement cannot be processed.
SQL30071N “<object-identifier>” Object is not
User Response: Resubmit the command with supported.
the correct database name or alias.
Explanation: The remote database received data
Federated system users: check to ensure that the it does not recognize. The current environment
entry in SYSCAT.SERVERS correctly specifies the command or SQL statement cannot be processed
database name of the data source. successfully, nor can any subsequent commands
or SQL statements.
sqlcode: -30061
The current transaction is rolled back and the
sqlstate: 08004 application is disconnected from the remote
database. The command cannot be processed.
SQL30070N “<command-identifier>” User Response: Record the message number
Command is not supported. (SQLCODE) and the object identifier. Record all
Explanation: The remote database received a error information from the SQLCA, if possible.
command that it does not recognize. The current Attempt to connect to the remote database and
environment command or SQL statement cannot rerun the application.
be processed successfully, nor can any If sufficient memory resources exist and the
subsequent commands or SQL statements. problem continues,
The current transaction is rolled back and the If trace was active, invoke the Independent Trace
application is disconnected from the remote Facility at the operating system command
database. The statement cannot be processed. prompt. Refer to the Independent Trace Facility
User Response: Record the message number in the Troubleshooting Guide for information on
(SQLCODE) and the command identifier. Record how to use this facility.
all error information from the SQLCA, if Contact your technical service representative
possible. Attempt to connect to the remote with the following information:
database and rerun the application.
Required information:
If sufficient memory resources exist and the
problem continues, invoke the Independent Trace v Problem description
Facility at the operating system command v SQLCODE and object identifier
prompt. Refer to the Independent Trace Facility v SQLCA contents if possible
in the Troubleshooting Guide for information on
v Trace file if possible.
how to use this facility.
sqlcode: -30071
Contact your technical service representative
with the following information:
sqlstate: 58015
Required information:
v Problem description SQL30072N “<parameter-identifier>”
v SQLCODE and command identifier Parameter is not supported.
v SQLCA contents if possible Explanation: The remote database received data
v Trace file if possible. it does not recognize. The current environment
command or SQL statement cannot be processed
sqlcode: -30070
successfully, nor can any subsequent commands
or SQL statements.
sqlstate: 58014
The command cannot be processed.. The current
transaction is rolled back and the application is
disconnected from the remote database.

480 Message Reference, Volume 2

User Response: Record the message number how to use this facility. Contact your technical
(SQLCODE) and the parameter identifier. Record service representative with the following
all error information from the SQLCA, if information:
possible. Attempt to connect to the remote
Required information:
database and rerun the application.
v Problem description
If sufficient memory resources exist and the
v SQLCODE, parameter identifier, and value
problem continues, invoke the Independent Trace
Facility at the operating system command v SQLCA contents if possible
prompt. Refer to the Independent Trace Facility v Trace file if possible.
in the Troubleshooting Guide for information on
how to use this facility. Some possible parameter identifiers include:

Contact your technical service representative 002F The target server does not support the
with the following information: data type requested by the application
requester. For example, when DB2
Required information: Connect is used to connect to DB2 2.3,
v Problem description this error will be returned unless the
proper PTF is applied to DB2 2.3.
v SQLCODE and parameter identifier
Ensure that the level of the server is
v SQLCA contents if possible supported by the requester.
v Trace file if possible.
119C, 119D, 119E
sqlcode: -30072 The target server does not support the
CCSID requested by the application
sqlstate: 58016 requester. Ensure the CCSID used by the
requester is supported by the server.

SQL30073N “<parameter-identifier>” v 119C - Verify the single-byte CCSID.

Parameter value “<value>” is not v 119D - Verify the double-byte CCSID.
supported. v 119E - Verify the mixed-byte CCSID.
Explanation: The remote database received data
it does not recognize. The current environment sqlcode: -30073
command or SQL statement cannot be processed
successfully, nor can any subsequent commands sqlstate: 58017
or SQL statements.
The current transaction is rolled back and the SQL30074N “<reply-identifier>” Reply is not
application is disconnected from the remote supported.
database. The command cannot be processed. Explanation: The client received a reply it does
User Response: Record the message number not recognize. The current environment
(SQLCODE) and the parameter identifier. Record command or SQL statement cannot be processed
all error information from the SQLCA, if successfully, nor can any subsequent commands
possible. Attempt to connect to the remote or SQL statements.
database and rerun the application. The current transaction is rolled back and the
If sufficient memory resources exist and the application is disconnected from the remote
problem continues, database. The statement cannot be processed.

If trace was active, invoke the Independent Trace User Response: Record the message number
Facility at the operating system command (SQLCODE) and the reply identifier. Record all
prompt. Refer to the Independent Trace Facility error information from the SQLCA, if possible.
in the Troubleshooting Guide for information on

Chapter 2. SQL Messages 481

Attempt to connect to the remote database and Manager 1.0 APPC Programming Guide and
rerun the application. Reference (SC31-6160) for explanation of the
APPC primary and secondary return codes. For
If sufficient memory resources exist and the
details of APPC sense data, refer to the IBM
problem continues, invoke the Independent Trace
Communications Manager 1.0 Problem Determination
Facility at the operating system command
Guide (SC31-6156).
prompt. Refer to the Independent Trace Facility
in the Troubleshooting Guide for information on User Response: Ensure that both the database
how to use this facility. manager and Communications Manager are
started at the Database Server and that all
Contact your technical service representative
Communications Manager configuration
with the following information:
parameters are correct. Also, consult the
Required information: Communications Manager/2 APPC Programming
v Problem description Guide & Reference for further information.

v SQLCODE and reply identifier

Note: If the reason code embedded in your
v SQLCA contents if possible message is 0003-084C0001 one possible
v Trace file if possible. cause for this message is that you are
trying to make a remote connection to a
sqlcode: -30074 workstation that is not a server. Verify that
the remote workstation is a server. If it is
sqlstate: 58018 not a server, install the database manager
as a server.
SQL30080N A communication error
“<reason-code>” occurred sending sqlcode: -30080
or receiving data from the remote
database. sqlstate: 08001

Explanation: The “<reason-code>” contains the

original error codes reported by Communications SQL30081N A communication error has been
Manager. detected. Communication protocol
being used: <protocol>.
For APPC error codes, the format is Communication API being used:
pppp-ssssssss-dddddddd where pppp is the primary <interface>. Location where the
return code, ssssssss is the secondary return code error was detected: <location>.
and dddddddd is the sense data. Each of these Communication function
error code values is represented in hexadecimal detecting the error: <function>.
notation. Possible primary and secondary error Protocol specific error code(s):
codes include 0003-00000004 and 0003-00000005, <rc1>, <rc2>, <rc3>.
which indicate that a conversation with the
Database Server could not be allocated. Sense Explanation: An error has been detected by the
data will only be displayed for an APPC communication subsystem.
ALLOCATE error.
If the connection has already been established,
The command cannot be processed. The possible causes include the following:
connection attempted to the database is v A communication subsystem error at the client
unsuccessful or the current transaction to the node or server node has caused the connection
connected database is rolled back and the to go down.
application is disconnected from the remote
v A communication subsystem error at the
database.
SOCKS server, if one is being used, has caused
Refer to the document IBM Communications the connection to go down.

482 Message Reference, Volume 2

v A network error has caused the connection to used to invoke the above
go down. communication protocol services. Valid
v The database agent at the server was forced off token values are:
by the system administrator. v SOCKETS
v The database agent at the server was v SOCKS
terminated due to an abnormal termination of v CPI-C
a key database manager process.
v DLR or DD
If you are trying to establish a new connection, v TLI or Connection/Bindery
possible causes include the following:
<location>
v The remote database server has not been
This is a protocol specific ID which
cataloged correctly at the client.
uniquely identifies the node that
v The database manager configuration file at the detected the error. If the protocol being
server has not been configured with the proper used is:
communication parameters.
v TCP/IP
v The communication subsystem at the client
The format of the ID is the Internet
node or server node has not been configured
address in dot notation.
correctly, or has not been started successfully.
v APPC
v The communication subsystem at the SOCKS
server, if one is being used, has not been The format of the ID is the fully
configured correctly, or has not been started qualified LU name
successfully. (networkID.LUname).
v The DB2COMM environment variable at the v NETBIOS
server doesn’t specify the communication The format of the ID is the
protocol used by the client. Workstation name (nname).
v The database manager at the server has not v IPX/SPX
been started, or has not been started The format of the ID is the network
successfully. One or more of the address and node address in
communication protocols specified by hexadecimal notation (network.node).
DB2COMM may not have been successfully
started.
If the location information is not
Refer to the token values for details. Depending available at the time that the error
on the protocol being used and the occurred, this token is not filled in.
communication function invoked, some tokens
<function>
may not be applicable. The following is the
The name of the communication
explanation of the token values:
subsystem function that returned the
<protocol> error code(s).
The actual communication protocol
<rc1>, <rc2>, <rc3>
being used. Valid token values are:
The list of the available error codes and
v TCP/IP subcodes that are specific to each
v APPC protocol being used. Tokens that are not
v NETBIOS applicable contain ″*″.
v IPX/SPX If the protocol being used is:
<interface> v TCP/IP
The application programming interface – If present, <rc1> contains the
global errno value from the TCP/IP

Chapter 2. SQL Messages 483

 sockets function call. When using contains the global errno value from
Windows Sockets, if present, <rc1> the CPI-C function call. <rc3> is not
contains the error from the TCP/IP applicable.
sockets function call returned by v NETBIOS
WSAGetLastError().
<rc1> contains the return code from
– If present, <rc2> contains the the call to NetBIOS. <rc2> and <rc3>
global h_errno value from the are not applicable.
TCP/IP database function call.
v IPX/SPX
When using Windows Sockets, if
present, <rc2> contains the error <rc1> contains the global t_errno
from the TCP/IP database function value from the call to TLI Services, or
call returned by the return code from the call to
WSAGetLastError(). NetWare Connection or Bindery
Services. If the <rc1> t_errno is
– If <rc3> is present and contains
TLOOK, <rc2> contains the TLI event
″0″, it means that the TCP/IP
that has occurred. If the <rc2> event
connection has been closed. This
is T_DISCONNECT, <rc3> contains
could be caused by one of the
the disconnect reason code. On AIX, if
following:
the <rc1> t_errno is TSYSERR, <rc3>
- The database agent at the server contains the system errno (defined in
was forced off by the system sys/errno.h). If <rc1> contains the
administrator. error return code from a call to AIX
- A database agent could not be NetWare Connection or Bindery
started at the server because the Services, <rc2> contains the error
maxagents database manager generator.
configuration parameter has
been exceeded. Check the First See the Communications Errors appendix of the
Failure Service Log Messages Reference for more information on
(DB2DIAG.LOG) at the server to specific communication error codes.
see if an error message has been
logged. User Response:

- The database agent at the server If the connection has already been established,
was terminated due to an check if:
abnormal termination of a key 1. The database agent at the server has been
database manager process. forced off.
2. The database manager at the server has
Note: When using Windows Sockets, abnormally terminated.
if the <function> is
WSAStartup, and <rc1> is 0, 3. A communication subsystem or network error
then <rc2> contains the has occurred. See the Messages Reference for
Windows Sockets Specification more information on specific communication
version level requested by DB2, error codes.
and <rc3> contains the If you are trying to establish a new connection,
Windows Sockets Specification check if:
version level supported by the
1. The remote database server is cataloged
Windows Sockets DLL.
properly on the client node.
v APPC
2. The database manager configuration file at
<rc1> contains the return code from the server is configured with the proper
the CPI-C function. If present, <rc2> communication related parameters. If the

484 Message Reference, Volume 2

 database manager configuration parameters 2 (PASSWORD INVALID)
have been updated at the server, ensure that The password specified in the request is
you stop and then re-start the database not valid.
manager, for the changes to take effect.
3 (PASSWORD MISSING)
3. The communication subsystems on both The request did not include a password.
client and server nodes are configured and
started up properly. 4 (PROTOCOL VIOLATION)
The request violated security protocols.
4. The DB2COMM environment variable at the
server specifies the communication protocol 5 (USERID MISSING)
used by the client. The request did not include a userid.
5. The database manager at the server is 6 (USERID INVALID)
successfully started. Start database manager The userid specified in the request is not
processing at the server should have returned valid.
SQL1063, and not SQL5043. If SQL5043 is
returned, check the First Failure Service Log 7 (USERID REVOKED)
(DB2DIAG.LOG) for more information. The userid specified in the request has
6. A communication subsystem or network error been revoked.
has occurred. 8 (GROUP INVALID)
If the problem persists, consult with your The group specified in the request is not
network administrator and/or communication valid.
expert to determine the cause of the problem 9 (USERID REVOKED IN GROUP)
using the set of tokens provided. The userid specified in the request has
been revoked in the group.
sqlcode: -30081
10 (USERID NOT IN GROUP)
The userid specified in the request is not
sqlstate: 08001
in the group.
11 (USERID NOT AUTHORIZED AT REMOTE
SQL30082N Attempt to establish connection
LU) The userid specified in the request is not
failed with security reason
authorized at the remote Logical Unit.
″<reason-code>″
(″<reason-string>″). 12 (USERID NOT AUTHORIZED FROM
LOCAL LU)
Explanation: The attempt to connect to the
The userid specified in the request is not
remote database server was rejected due to
authorized at the remote Logical Unit
invalid or incorrect security information. The
when coming from the local Logical
cause of the security error is described by the
Unit.
<reason-code> and corresponding
<reason-string> value. 13 (USERID NOT AUTHORIZED TO TP)
The userid specified in the request is not
The following is a list of reason codes and
authorized to access the Transaction
corresponding reason strings:
Program.
0 (NOT SPECIFIED)
14 (INSTALLATION EXIT FAILED)
The specific security error is not
The installation exit failed.
specified.
15 (PROCESSING FAILURE)
1 (PASSWORD EXPIRED)
Security processing at the server failed.
The password specified in the request
has expired. 16 (NEW PASSWORD INVALID)
the password specified on a change

Chapter 2. SQL Messages 485

 password request did not meet the For reason code 17, retry the command with a
server’s requirements. supported authentication type.
17 (UNSUPPORTED FUNCTION) For reason code 20, make sure the authentication
the security mechanism specified by the mechanism for the server is started, and retry.
client is invalid for this server. Some
sqlcode: -30082
typical examples:
v The client sent a new password value sqlstate: 08001
to a server that does not support the
DRDA change password function. SQL30083N Attempt to change password for
v The client sent DCE authentication user id ″<uid>″ failed with
information to a server that does not security reason ″<reason-code>″
support DCE. (″<reason-string>″).
v The client sent SERVER_ENCRYPT or Explanation: The attempt to change password
DCS_ENCRYPT authentication was rejected due to invalid or incorrect security
information to a server that does not information. The cause of the security error is
support password encryption. described by the ″<reason-code>″ and
v The client sent a userid (but no corresponding ″<reason-string>″ values.
password) to a server that does not
support authentication by userid only. The following is a list of reason codes and
corresponding reason strings:
18 (NAMED PIPE ACCESS DENIED)
The named pipe is inaccessible due to a 0 (NOT SPECIFIED)
security violation. The specific security error is not
specified.
19 (USERID DISABLED or RESTRICTED)
The userid has been disabled, or the 1 (CURRENT PASSWORD INVALID)
userid has been restricted from The old password specified in the
accessing the operating environment at request is not vaild.
this time. 2 (NEW PASSWORD INVALID)
20 (MUTUAL AUTHENTICATION FAILED) The password specified in the request is
The server being contacted failed to not valid under the password rules
pass a mutual authentication check. The imposed by the system where password
server is either an imposter, or the ticket was to be changed.
sent back was damaged. 3 (CURRENT PASSWORD MISSING)
21 (RESOURCE TEMPORARILY The request did not include an old
UNAVAILABLE) password.
Security processing at the server was 4 (NEW PASSWORD MISSING)
terminated because a resource was The request did not include a new
temporarily unavailable. For example, password.
on AIX, no user licenses may have been
available. 5 (USERID MISSING)
The request did not include a userid.
User Response: Ensure that the proper userid
and/or password is supplied. 6 (USERID INVALID)
The userid specified in the request is not
The userid may be disabled, the userid may be valid.
restricted to accessing specific workstations, or
the userid may be restricted to certain hours of 7 (USERID REVOKED)
operation. The userid specified in the request has

486 Message Reference, Volume 2

 been revoked. Passwords can not be Possible reason codes are:
changed for revoked userids. v 01 - an SQL request that changes data (such as
14 (INSTALLATION EXIT FAILED) an INSERT or a CREATE) was issued against a
The installation security exit failed. read-only database; or, a stored procedure was
invoked against a read-only database.
15 (PROCESSING FAILURE) Read-only databases include the following
Security processing at the server failed. types:
17 (UNSUPPORTED FUNCTION) – Databases accessed using DRDA when
Change password funcion is not operating in a unit of work which has
supported by the system. connection setting SYNCPOINT
TWOPHASE and executing in a
19 (USERID DISABLED or RESTRICTED) non-XA/DTP environment when either a
The userid has been disabled, or the Synchpoint Manager is not being used or
userid has been restricted from the remote DRDA database does not
accessing the operating environment at support level 2 DRDA protocol.
this time.
– Databases accessed by DRDA in an
24 (USERNAME AND/OR PASSWORD XA/DTP environment when either a
INVALID) Synchpoint Manager gateway is unavailable
The username specified, password or the remote DRDA database does not
specified, or both, are invalid. support level 2 DRDA protocol.
User Response: Ensure that the proper userid, – Databases which were not the first database
current and new passwords are supplied. For updated when the SYNCPOINT
reason code 14, check the file db2pem.log in the ONEPHASE connection setting is in effect
instance subdirectory (typicaly ″db2″) for a for the unit of work.
detailed description of the problem encountered. v 02 - an API such as Precompile, Bind, or
Reorganize Table which causes internal
The userid may be disabled, the userid may be
commits was issued in an application which
restricted to accessing specific workstations, or
has the setting CONNECT type 2 or is
the userid may be restricted to certain hours of
operating in an XA/DTP environment.
operation.
v 03 - an SQL OPEN for a held cursor was
sqlcode: -30083 issued while in an XA/DTP environment
sqlstate: 08001 when using an ENCINA or TUXEDO
transaction processing monitor.
v 04 - a DISCONNECT statement was issued
SQL30090N Operation invalid for application
while in an XA/DTP environment.
execution environment. Reason
code = “<reason-code>” v 05 - A compound SQL statement which
contains a COMMIT statement was issued in a
Explanation: The operation is invalid for the CONNECT type 2 or XA/DTP environment.
application execution environment. For example,
v 06 - The SET CLIENT API was issued in an
an operation might be invalid for applications
XA/DTP environment.
that have special restrictions on statements or
APIs - applications such as those that operate in v 07 - A second database is being accessed
an XA Distributed Transaction Processing within a unit of work for which two-phase
environment, such as CICS; those that operate commit coordination is not being supplied by
with CONNECT type 2 connection settings; or the transaction manager. To ensure data
those that use federated system functionality to integrity, the operation has been disallowed.
update multiple heterogeneous data sources. The v 08 - An attempt was made to access a database
operation was rejected. for use of commit coordination from a source

Chapter 2. SQL Messages 487

 different from a concurrently connected or more of the data sources in the unit of work
database. The two types of coordination only supports one-phase commit. Possible
cannot be mixed, and operations against the causes are:
current database are rejected. – An attempt was made to update a data
v 09 - An attempt was made to execute an source that only supports one-phase
XA/DTP local transaction against a database commit, but a different data source has
accessed under Synchpoint Manager already been updated in the same unit of
coordination. work.
v 10 - An SQL OPEN for a held cursor was – An attempt was made to update a data
issued in either of these cases: source that supports two-phase commit, but
– XA/DTP environment, or a different data source that only supports
one-phase commit has already been
– federated server accessing a nickname
updated in the same unit of work.
defined on a two phase commit datasource
– An attempt was made to update a local
Cursor hold is not supported in these federated server table, but a data source
environments. that only supports one-phase commit has
v 11 - An operation is not supported for already been updated in the same unit of
pass-through. work.
v 12 - The insert/update/delete operation – An attempt was made to update a data
requires the existence of a timestamp column source that only supports one-phase commit
and a unique index due to the restriction on when the application is operating with a
the data source. CONNECT type 2 connection setting.
For an update/delete operation accessing data v 19 - The application host variable data type is
sources: not supported by the data source in a
– Fujitsu RDB2 requires the existence of a pass-through session.
unique index. v 20 - SET CLIENT INFORMATION was issued
v 13 - A positioned UPDATE or DELETE while a Unit of Work is in progress.
operation requires the existence of a column in v 21 - The operation that you want performed at
the SELECT list of the cursor, but that column the specified data source(s) is not supported
does not exist in the SELECT list of the cursor. by the wrapper by which DB2 accesses the
v 14 - An illegal combination of updatable data source(s). Consult the documentation to
cursors, cursor hold, and isolation level of find out what operations this wrapper
Repeatable Read exists. Invalid combinations supports.
are: User Response:
– Isolation level Repeatable Read and a WITH
Correct the problem by doing one of the
HOLD cursor
following steps:
– A WITH HOLD cursor with FOR UPDATE
v For reasons 01, 02, 03, 04, 06, or 19, remove the
v 15 - Reserved for future use statement or API which is not supported.
v 16 - Illegal type column and protocol column v Alternately, for reasons 01, 02, 03, 04, or 06,
value combination in SYSCAT.SERVERS. execute the application in a different
v 17 - The REORG utility cannot be issued environment which supports the failing
against a nickname. statement or API.
v 18 - An update request (or, a DDL operation v For reason 05 move the COMMIT request
that results in the update of a system catalog outside of the compound statement.
table) has been issued that would result in v For reason 07, ensure that only one database is
multiple data sources being updated when one accessed within a unit of work for which

488 Message Reference, Volume 2

 EXEC SQL COMMIT or EXEC SQL v For reason 18, do one of the following steps:
ROLLBACK will be issued in place of – Submit a COMMIT or ROLLBACK before
syncpoint requests to an external transaction issuing an update to a different data source.
manager. If multiple databases must be
– If multiple data sources need to be updated
accessed within the unit of work, utilize the
within a unit of work, make sure the
commitment control interface provided by the
two_phase_commit server option has been
external transaction manager product.
set to ’Y’ for all the data sources that need
v For reason 08, ensure that all databases being to be updated. See the SQL Reference for
accessed within a unit of work are under the information on setting the value used for
commitment control of the same type of the two_phase_commit setting.
request: external transaction processing
– If the data source to be updated supports
monitor (such as CICS SYNCPOINT) or local
only one-phase commit and the application
COMMIT and ROLLBACK EXEC SQL.
is operating with a CONNECT type 2
v For reason 09, do one of the following steps: connection setting, change the application to
– Execute the transaction as an XA/DTP operate with a CONNECT type 1
global transaction. connection setting.
– Access the database in a non-XA/DTP v For reason 20, submit a Commit or Rollback
environment. before invoking the API.
– Do not use the services of the Synchpoint sqlcode: -30090
Manager for the database connection if the
transaction is read-only. sqlstate: 25000
v For reasons 10 through 17 (federated server
users), isolate the problem to the data source
failing the request (see the Troubleshooting
Guide) and examine the restrictions for that
data source.

SQL30100 - SQL30199
v sqlerrmc (SQL message tokens)
SQL30101W Bind options specified on
REBIND request are ignored. sqlcode: +30101
Explanation: Bind options were specified on the
REBIND request however the database server sqlstate: 01599
does not support respecification of any bind
options. The bind options specified will be
ignored and the options from the original BIND
request will be used.
User Response: No action is required. This is a
warning situation only.
If the database server returned an additional
warning SQLCA, the ″sqlerrmc″ tokens will
indicate the following information about this
additional SQLCA in this order:
v sqlcode (SQL return code)
v sqlstate (universal SQL return code)
v sqlerrp (product name)

Chapter 2. SQL Messages 489

490 Message Reference, Volume 2
Chapter 3. SQLSTATE Messages
This section lists the SQLSTATEs and their meaning. The SQLSTATEs are
grouped by class code; for subcodes, see the corresponding tables.
Table 1. SQLSTATE Class Codes
Class Meaning For subcodes, refer to...
Code
00 Unqualified Successful Completion Table 2 on page 492
01 Warning Table 3 on page 492
02 No Data Table 4 on page 495
07 Dynamic SQL Error Table 5 on page 496
08 Connection Exception Table 6 on page 496
09 Triggered Action Exception Table 7 on page 496
0A Feature Not Supported Table 8 on page 497
0D Invalid Target Type Specification Table 9 on page 497
0F Invalid Token Table 10 on page 497
0K Invalid RESIGNAL Statement Table 11 on page 497
20 Case Not Found for CASE Statement Table 12 on page 497
21 Cardinality Violation Table 13 on page 498
22 Data Exception Table 14 on page 498
23 Constraint Violation Table 15 on page 499
24 Invalid Cursor State Table 16 on page 500
25 Invalid Transaction State Table 17 on page 500
26 Invalid SQL Statement Identifier Table 18 on page 501
28 Invalid Authorization Specification Table 19 on page 501
2D Invalid Transaction Termination Table 20 on page 501
2E Invalid Connection Name Table 21 on page 501
34 Invalid Cursor Name Table 22 on page 502
38 External Function Exception Table 23 on page 502
39 External Function Call Exception Table 24 on page 503
3B Invalid SAVEPOINT Table 25 on page 503
40 Transaction Rollback Table 26 on page 504
42 Syntax Error or Access Rule Violation Table 27 on page 504

© Copyright IBM Corp. 1993, 2000 491

 Table 1. SQLSTATE Class Codes (continued)
Class Meaning For subcodes, refer to...
Code
44 WITH CHECK OPTION Violation Table 28 on page 515
46 Java DDL Table 29 on page 515
51 Invalid Application State Table 30 on page 516
54 SQL or Product Limit Exceeded Table 31 on page 516
55 Object Not in Prerequisite State Table 32 on page 518
56 Miscellaneous SQL or Product Error Table 33 on page 519
57 Resource Not Available or Operator Table 34 on page 519
Intervention
58 System Error Table 35 on page 521

Class Code 00 Unqualified Successful Completion

Table 2. Class Code 00: Unqualified Successful Completion
SQLSTATE Meaning
Value
00000 Execution of the SQL statement was successful and did not result in any
type of warning or exception condition.

Class Code 01 Warning

Table 3. Class Code 01: Warning
SQLSTATE Meaning
Value
01002 A DISCONNECT error occurred.
01003 Null values were eliminated from the argument of a column function.
01004 The value of a string was truncated when assigned to a host variable.
01005 Insufficient number of entries in an SQLDA.
01007 A privilege was not granted.
0100C One or more adhoc result sets were returned from the procedure.
0100D The cursor that was closed has been re-opened on the next result set
within the chain.
0100E The procedure generated more than the maximum allowed number of
result sets. Only the first integer result sets have been returned to the
caller.

492 Message Reference, Volume 2

Table 3. Class Code 01: Warning (continued)
SQLSTATE Meaning
Value
01503 The number of result columns is larger than the number of host variables
provided.
01504 The UPDATE or DELETE statement does not include a WHERE clause.
01506 An adjustment was made to a DATE or TIMESTAMP value to correct an
invalid date resulting from an arithmetic operation.
01509 Blocking was cancelled for a cursor because there is insufficient storage
in the user virtual machine.
01515 The null value has been assigned to a host variable, because the non-null
value of the column is not within the range of the host variable.
01516 An inapplicable WITH GRANT OPTION has been ignored.
01517 A character that could not be converted was replaced with a substitute
character.
01519 The null value has been assigned to a host variable, because a numeric
value is out of range.
01524 The result of a column function does not include the null values that
were caused by evaluating an arithmetic expression.
01526 Isolation level has been escalated.
01539 Connection is successful but only SBCS characters should be used.
01543 A duplicate constraint has been ignored.
01545 An unqualified column name has been interpreted as a correlated
reference.
01550 The index was not created, because an index with the specified
description already exists.
01560 A redundant GRANT has been ignored.
01562 The new path to the log (newlogpath) in the database configuration file
is invalid.
01563 The current path to the log file (logpath) is invalid. The log file path is
reset to the default.
01564 The null value has been assigned to a host variable, because division by
zero occurred.
01586 Setting OFF the constraints for a parent table in a referential structure
has resulted in one or more descendent tables being automatically placed
into a check-pending state
01589 A statement contains redundant specifications.

Chapter 3. SQLSTATE Messages 493

 Table 3. Class Code 01: Warning (continued)
SQLSTATE Meaning
Value
01592 In a CREATE FUNCTION statement that references a SOURCE function,
either:
v an input parameter has a larger length, precision, or scale than that of
the corresponding parameter of the source function; or
v the RETURNS or CAST FROM parameter has a smaller length,
precision, or scale than that of the source function; or
v the CAST FROM parameter in the CREATE FUNCTION statement has
a larger length, precision, or scale than that of the RETURNS
parameter.
Truncation may occur at run time (and may result in an error at that
time).
01594 Insufficient number of entries in an SQLDA for ALL information (i.e. not
enough descriptors to return the distinct name).
01595 The view has replaced an existing, invalidated view.
01596 Comparison functions were not created for a distinct type based on a
long string data type.
01598 An attempt has been made to activate an active event monitor or
deactivate an inactive event monitor.
01599 Bind options were ignored on REBIND.
01602 The optimization level has been reduced.
01603 CHECK DATA processing found constraint violations and moved them
to exception tables.
01604 The SQL statement was explained and not executed.
01605 A recursive common table expression may contain an infinite loop.
01606 The node or system database directory is empty.
01607 The difference between the times on nodes in a read-only transactions
exceed the defined threshold.
01609 The procedure generated more than the maximum allowed number of
result sets. Only the first integer result sets have been returned to the
caller.
01610 One or more ad hoc result sets were returned from the procedure.
01611 The cursor that was closed has been re-opened on the next result set
within the chain.
01616 The estimated CPU cost exceeds the resource limit.
01618 Redistribute nodegroup is required to change data partitioning.
01620 Some base tables of UNION ALL may be the same table.
01621 The retrieved LOB value may have been changed.

494 Message Reference, Volume 2

 Table 3. Class Code 01: Warning (continued)
SQLSTATE Meaning
Value
01622 Statement completed successfully but a system error occurred after the
statement completed.
01623 Value of DEGREE is ignored.
01626 The database has only one active bufferpool.
01627 The DATALINK value may not be valid because the table is in reconcile
pending or reconcile is not possible state.
01632 The number of concurrent connections has exceeded the defined
entitlement for the product.
01633 The summary table may not be used to optimize the processing of
queries.
01636 Integrity of non-incremental data remains unverified by the database
manager.
01637 Debugging is not enabled.
01639 The view or summary table may require the invoker to have necessary
privileges on data source objects.
01641 Datalink type attributes limit the use of the structured type.
01642 Column not long enough for the largest possible USER default value.
01643 Assignment to an SQLSTATE or SQLCODE variable in an SQL routine
may be over-written and does not activate any handler.
01645 The executable for the SQL procedure is not saved in the database
catalog.
01HXX Valid warning SQLSTATEs returned by a user-defined function or
external procedure CALL.

Class Code 02 No Data

Table 4. Class Code 02: No Data
SQLSTATE Meaning
Value
02000 One of the following exceptions occurred:
v The result of the SELECT INTO statement or the subselect of the
INSERT statement was an empty table.
v The number of rows identified in the searched UPDATE or DELETE
statement was zero.
v The position of the cursor referenced in the FETCH statement was
after the last row of the result table.

Chapter 3. SQLSTATE Messages 495

Class Code 07 Dynamic SQL Error
Table 5. Class Code 07: Dynamic SQL Error
SQLSTATE Meaning
Value
07001 The number of host variables is not the same as the number of parameter
markers.
07002 The call parameter list or control block is invalid.
07003 The statement identified in the EXECUTE statement is a select-statement,
or is not in a prepared state.
07004 The USING clause is required for dynamic parameters.
07005 The statement name of the cursor identifies a prepared statement that
cannot be associated with a cursor.
07006 An input host variable cannot be used, because of its data type.

Class Code 08 Connection Exception

Table 6. Class Code 08: Connection Exception
SQLSTATE Meaning
Value
08001 The application requester is unable to establish the connection.
08002 The connection already exists.
08003 The connection does not exist.
08004 The application server rejected establishment of the connection.
08007 Transaction resolution unknown.
08502 The CONNECT statement issued by an application process running with
a SYNCPOINT of TWOPHASE has failed, because no transaction
manager is available.

Class Code 09 Triggered Action Exception

Table 7. Class Code 09: Triggered Action Exception
SQLSTATE Meaning
Value
09000 A triggered SQL statement failed.

496 Message Reference, Volume 2

Class Code 0A Feature Not Supported
Table 8. Class Code 0A: Feature Not Supported
SQLSTATE Meaning
Value
0A001 The CONNECT statement is invalid, because the process is not in the
connectable state.
0A502 The action or operation is not enabled for this database instance.

Class Code 0D Invalid Target Type Specification

Table 9. Class Code 0D: Invalid Target Type Specification
SQLSTATE Meaning
Value
0D000 The target structured data type specification is a proper subtype of the
source structured data type.

Class Code 0F Invalid Token

Table 10. Class Code 0F: Invalid Token
SQLSTATE Meaning
Value
0F001 The LOB token variable does not currently represent any value.

Class Code 0K Invalid RESIGNAL statement

Table 11. Class Code 0K: Invalid RESIGNAL statement
SQLSTATE Meaning
Value
0K000 RESIGNAL statement is not within a handler.

Class Code 20 Case Not Found for Case Statement

Table 12. Class Code 20: Case Not Found for Case Statement
SQLSTATE Meaning
Value
20000 The case was not found for the CASE statement.

Chapter 3. SQLSTATE Messages 497

Class Code 21 Cardinality Violation
Table 13. Class Code 21: Cardinality Violation
SQLSTATE Meaning
Value
21000 The result of a SELECT INTO is a result table of more than one row, or
the result of the subquery of a basic predicate is more than one value.
21501 A multiple-row INSERT into a self-referencing table is invalid.
21502 A multiple-row UPDATE of a primary key is invalid.
21504 A multiple-row DELETE from a self-referencing table with a delete rule
of RESTRICT or SET NULL is invalid.
21505 A row function must return not more than one row.

Class Code 22 Data Exception

Table 14. Class Code 22: Data Exception
SQLSTATE Meaning
Value
22001 Character data, right truncation occurred; for example, an update or
insert value is a string that is too long for the column, or a datetime
value cannot be assigned to a host variable, because it is too small.
22002 A null value, or the absence of an indicator parameter was detected; for
example, the null value cannot be assigned to a host variable, because no
indicator variable is specified.
22003 A numeric value is out of range.
22004 A null value cannot be returned either from a procedure defined as
PARAMETER STYLE GENERAL, or from a type-preserving method
invoked with a non-null argument.
22007 An invalid datetime format was detected; that is, an invalid string
representation or value was specified.
22008 Datetime field overflow occurred; for example, an arithmetic operation
on a date or timestamp has a result that is not within the valid range of
dates.
2200G The most specific type does not match.
22011 A substring error occurred; for example, an argument of SUBSTR is out
of range.
22012 Division by zero is invalid.
22018 The character value for the CAST, DECIMAL, FLOAT, or INTEGER
scalar function is invalid.
22019 The LIKE predicate has an invalid escape character.

498 Message Reference, Volume 2

 Table 14. Class Code 22: Data Exception (continued)
SQLSTATE Meaning
Value
22021 A character is not in the coded character set.
22024 A NUL-terminated input host variable or parameter did not contain a
NUL.
22025 The LIKE predicate string pattern contains an invalid occurrence of an
escape character.
2202D Null instance used with a mutator method.
22501 The length control field of a variable length string is negative or greater
than the maximum.
22504 A mixed data value is invalid.
22506 A reference to a datetime special register is invalid, because the TOD
clock is malfunctioning or the operating system timezone parameter is
out of range.
22522 A CCSID value is not valid at all, not valid for the data type or subtype,
or not valid for the encoding scheme.
22526 A key transform function generated no rows or duplicate rows.

Class Code 23 Constraint Violation

Table 15. Class Code 23: Constraint Violation
SQLSTATE Meaning
Value
23001 The update or delete of a parent key is prevented by a RESTRICT update
or delete rule.
23502 An insert or update value is null, but the column cannot contain null
values.
23503 The insert or update value of a foreign key is invalid.
23504 The update or delete of a parent key is prevented by a NO ACTION
update or delete rule.
23505 A violation of the constraint imposed by a unique index or a unique
constraint occurred.
23510 A violation of a constraint on the use of the command imposed by the
RLST table occurred.
23511 A parent row cannot be deleted, because the check constraint restricts the
deletion.
23512 The check constraint cannot be added, because the table contains rows
that do not satisfy the constraint definition.

Chapter 3. SQLSTATE Messages 499

 Table 15. Class Code 23: Constraint Violation (continued)
SQLSTATE Meaning
Value
23513 The resulting row of the INSERT or UPDATE does not conform to the
check constraint definition.
23514 Check data processing has found constraint violations.
23515 The unique index could not be created or unique constraint added,
because the table contains duplicate values of the specified key.
23520 The foreign key cannot be defined, because all of its values are not equal
to a parent key of the parent table.
23521 The update of a catalog table violates an internal constraint.
23522 The range of an identity column has been exhausted.

Class Code 24 Invalid Cursor State

Table 16. Class Code 24: Invalid Cursor State
SQLSTATE Meaning
Value
24501 The identified cursor is not open.
24502 The cursor identified in an OPEN statement is already open.
24504 The cursor identified in the UPDATE, DELETE, SET, or GET statement is
not positioned on a row.
24506 The statement identified in the PREPARE is the statement of an open
cursor.
24514 A previous error has disabled this cursor.
24516 A cursor has already been assigned to a result set.

Class Code 25 Invalid Transaction State

Table 17. Class Code 25: Invalid Transaction State
SQLSTATE Meaning
Value
25000 An update operation is invalid for the application execution
environment.
25001 The statement is only allowed as the first statement in a unit of work.
25501 The statement is only allowed as the first statement in a unit of work.

500 Message Reference, Volume 2

Class Code 26 Invalid SQL Statement Identifier
Table 18. Class Code 26: Invalid SQL Statement Identifier
SQLSTATE Meaning
Value
26501 The statement identified does not exist.

Class Code 28 Invalid Authorization Specification

Table 19. Class Code 28: Invalid Authorization Specification
SQLSTATE Meaning
Value
28000 Authorization name is invalid.

Class Code 2D Invalid Transaction Termination

Table 20. Class Code 2D: Invalid Transaction Termination
SQLSTATE Meaning
Value
2D521 SQL COMMIT or ROLLBACK are invalid in the current operating
environment.
2D528 Dynamic COMMIT is invalid for the application execution environment.
2D529 Dynamic ROLLBACK is invalid for the application execution
environment.

Class Code 2E Invalid Connection Name

Table 21. Class Code 2E: Invalid Connection Name
SQLSTATE Meaning
Value
2E000 Connection name is invalid.

Chapter 3. SQLSTATE Messages 501

Class Code 34 Invalid Cursor Name
Table 22. Class Code 34: Invalid Cursor Name
SQLSTATE Meaning
Value
34000 Cursor name is invalid.

Class Code 38 External Function Exception

Table 23. Class Code 38: External Function Exception
SQLSTATE Meaning
Value
38XXX Valid error SQLSTATEs returned by a user-defined function, external
procedure, or trigger.
38001 The external function is not allowed to execute SQL statements.
38002 The external function attempted to modify data, but the function was not
defined as MODIFIES SQL DATA.
38003 The statement is not allowed in a function or procedure.
38004 The external function attempted to read data, but the function was not
defined as READS SQL DATA.
38501 Error occurred while calling a user-defined function, external procedure,
or trigger (using the SIMPLE CALL or SIMPLE CALL WITH NULLS
calling convention).
38502 The external function is not allowed to execute SQL statements.
38503 A user-defined function has abnormally terminated (abend).
38504 A user-defined function has been interrupted by the user to stop a
probable looping condition.
38506 Function failed with error from OLE DB provider.

502 Message Reference, Volume 2

 Table 23. Class Code 38: External Function Exception (continued)
SQLSTATE Meaning
Value
38552 A function in the SYSFUN schema (supplied by IBM) has abnormally
terminated.

One of the following reason codes can be found in the message text:
01 Numeric value out of range
02 Division by zero
03 Arithmetic overflow or underflow
04 Invalid date format
05 Invalid time format
06 Invalid timestamp format
07 Invalid character representation of a timestamp duration
08 Invalid interval type (must be one of 1, 2, 4, 8, 16, 32, 64, 128,
256)
09 String too long
10 Length or position in string function out of range
11 Invalid character representation of a floating point number

Class Code 39 External Function Call Exception

Table 24. Class Code 39: External Function Call Exception
SQLSTATE Meaning
Value
39001 A user-defined function has returned an invalid SQLSTATE.
39004 A null value is not allowed for an IN or INOUT argument.
39501 The eye-catcher associated with an argument was modified.

Class Code 3B Invalid SAVEPOINT

Table 25. Class Code 3B: Invalid SAVEPOINT
SQLSTATE Meaning
Value
3B001 The savepoint is not valid.
3B002 The maximum number of savepoints has been reached.
3B501 A duplicate savepoint name was detected.
3B502 A RELEASE or ROLLBACK TO SAVEPOINT was specified, but a
savepoint does not exist.

Chapter 3. SQLSTATE Messages 503

 Table 25. Class Code 3B: Invalid SAVEPOINT (continued)
SQLSTATE Meaning
Value
3B503 A SAVEPOINT, RELEASE SAVEPOINT, or ROLLBACK TO SAVEPOINT
is not allowed in a trigger or global transaction.

Class Code 40 Transaction Rollback

Table 26. Class Code 40: Transaction Rollback
SQLSTATE Meaning
Value
40001 Deadlock or timeout with automatic rollback occurred.
40003 The statement completion is unknown.
40504 A system error has caused the unit of work to be rolled back.
40506 The current transaction was rolled back because of an SQL error.

Class Code 42 Syntax Error or Access Rule Violation

Table 27. Class Code 42: Syntax Error or Access Rule Violation
SQLSTATE Meaning
Value
42501 The authorization ID does not have the privilege to perform the specified
operation on the identified object.
42502 The authorization ID does not have the privilege to perform the
operation as specified.
42504 A specified privilege cannot be revoked from a specified
authorization-name.
42506 Owner authorization failure occurred.
42508 The specified database privileges cannot be granted to PUBLIC.
42509 SQL statement is not authorized, because of the STATICRULES option.
42601 A character, token, or clause is invalid or missing.
42602 A character that is invalid in a name has been detected.
42603 An unterminated string constant has been detected.
42604 An invalid numeric or string constant has been detected.
42605 The number of arguments specified for a scalar function is invalid.
42606 An invalid hexadecimal constant has been detected.
42607 An operand of a column function is invalid.

504 Message Reference, Volume 2

Table 27. Class Code 42: Syntax Error or Access Rule Violation (continued)
SQLSTATE Meaning
Value
42608 The use of NULL or DEFAULT in VALUES is invalid.
42609 All operands of an operator or predicate are parameter markers.
42610 A parameter marker is not allowed.
42611 The column or argument definition is invalid.
42612 The statement string is an SQL statement that is not acceptable in the
context in which it is presented.
42613 Clauses are mutually exclusive.
42614 A duplicate keyword is invalid.
42615 An invalid alternative was detected.
42617 The statement string is blank or empty.
42618 A host variable is not allowed.
42621 The check constraint is invalid.
42622 A name or label is too long.
42623 A DEFAULT clause cannot be specified.
42625 A CASE expression is invalid.
42627 RETURNS clause must be specified prior to predicate specification using
the EXPRESSION AS clause.
42628 A TO SQL or FROM SQL transform function is defined more than once
in a transform definition.
42629 Parameter names must be specified for SQL routines.
42630 An SQLSTATE or SQLCODE variable declaration must not be in a nested
compound statement.
42631 A RETURN statement in an SQL function or method must include a
return value.
42701 A duplicate column name in an INSERT or UPDATE statement was
detected.
42702 A column reference is ambiguous, because of duplicate names.
42703 An undefined column, attribute, or parameter name was detected.
42704 An undefined object or constraint name was detected.
42705 An undefined server-name was detected.
42707 A column name in ORDER BY does not identify a column of the result
table.
42709 A duplicate column name in a PRIMARY, UNIQUE, or FOREIGN KEY
clause was detected.

Chapter 3. SQLSTATE Messages 505

 Table 27. Class Code 42: Syntax Error or Access Rule Violation (continued)
SQLSTATE Meaning
Value
42710 A duplicate object or constraint name was detected.
42711 Duplicate column name or attribute name was detected in the object
definition or ALTER statement.
42712 A duplicate table designator was detected in the FROM clause.
42713 A duplicate object was detected in a list of objects.
42720 The nodename for the remote database was not found in the node
directory.
42723 A function with the same signature already exists in the schema.
42724 Unable to access an external program used for a user-defined function or
a procedure.
42725 A function was referenced directly (not by either signature or by specific
instance name), but there is more than one specific instance of that
function.
42726 Duplicate names for named derived tables were detected.
42727 No default primary tablespace exists for the new table.
42728 A duplicate node was detected in the nodegroup definition.
42729 The node is not defined.
42730 The container name is already used by another tablespace.
42731 The container name is already used by this tablespace.
42732 A duplicate schema name in the SET CURRENT PATH statement was
detected.
42734 A duplicate parameter-name, SQL variable-name, cursor-name,
condition-name, or label was detected.
42735 Nodegroup for the table space is not defined for the buffer pool.
42736 The label specified on the LEAVE statement is not found or not valid.
42737 The condition specified in the handler is not defined.
42738 A duplicate column name or unnamed column was specified in a
DECLARE CURSOR statement of a FOR statement.
42739 A duplicate transform was detected.
42740 No transforms were found for the specified type. No transforms were
dropped.
42741 A transform group is not defined for a data type.
42742 Subtable or subview of the same type already exists in the typed table or
typed view hierarchy.
42743 The search method is not found in the index extension.

506 Message Reference, Volume 2

Table 27. Class Code 42: Syntax Error or Access Rule Violation (continued)
SQLSTATE Meaning
Value
42744 A TO SQL or FROM SQL transform function is not defined in a
transform group.
42745 The routine would define an overriding relationship with an existing
method.
42746 A method name cannot be the same as a structured type name within the
same type hierarchy.
42802 The number of insert or update values is not the same as the number of
columns.
42803 A column reference in the SELECT or HAVING clause is invalid, because
it is not a grouping column; or a column reference in the GROUP BY
clause is invalid.
42804 The result expressions in a CASE expression are not compatible.
42805 An integer in the ORDER BY clause does not identify a column of the
result table.
42806 A value cannot be assigned to a host variable, because the data types are
not compatible.
42807 The INSERT, UPDATE, or DELETE is not permitted on this object.
42808 A column identified in the INSERT or UPDATE statement is not
updateable.
42809 The identified object is not the type of object to which the statement
applies.
42810 A view is identified in a FOREIGN KEY clause.
42811 The number of columns specified is not the same as the number of
columns in the SELECT clause.
42813 WITH CHECK OPTION cannot be used for the specified view.
42815 The data type, length, scale, value, or CCSID is invalid.
42816 A datetime value or duration in an expression is invalid.
42818 The operands of an operator or function are not compatible.
42819 An operand of an arithmetic operation or an operand of a function that
requires a number is not a number.
42820 A numeric constant is too long, or it has a value that is not within the
range of its data type.
42821 An update or insert value is not compatible with the column.
42823 Multiple columns are returned from a subquery that is allowed only one
column.
42824 An operand of LIKE is not a string, or the first operand is not a column.

Chapter 3. SQLSTATE Messages 507

 Table 27. Class Code 42: Syntax Error or Access Rule Violation (continued)
SQLSTATE Meaning
Value
42825 The rows of UNION, INTERSECT, EXCEPT, or VALUES do not have
compatible columns.
42826 The rows of UNION, INTERSECT, EXCEPT, or VALUES do not have the
same number of columns.
42827 The table identified in the UPDATE or DELETE is not the same table
designated by the cursor.
42828 The table designated by the cursor of the UPDATE or DELETE statement
cannot be modified, or the cursor is read-only.
42829 FOR UPDATE OF is invalid, because the result table designated by the
cursor cannot be modified.
42830 The foreign key does not conform to the description of the parent key.
42831 A column of a primary or unique key cannot allow null values.
42832 The operation is not allowed on system objects.
42834 SET NULL cannot be specified, because the foreign key does not allow
null values.
42835 Cyclic references cannot be specified between named derived tables.
42836 The specification of a recursive, named derived table is invalid.
42838 An invalid use of a tablespace was detected.
42839 Indexes and long columns cannot be in separate tablespaces from the
table.
42840 An invalid use of the AS CAST option was detected.
42841 A parameter marker can not be a user-defined type or reference type.
42842 A column definition is invalid, because a specified option is inconsistent
with the column description.
42845 An invalid use of a VARIANT or EXTERNAL ACTION function was
detected.
42846 Cast from source type to target type is not supported.
42852 The privileges specified in GRANT or REVOKE are invalid or
inconsistent. (For example, GRANT ALTER on a view.)
42853 Both alternatives of an option were specified, or the same option was
specificed more than once.
42854 A result column data type in the select list is not compatible with the
defined type in a typed view or summary table definition.
42855 The assignment of the LOB to this host variable is not allowed. The
target host variable for all fetches of this LOB value for this cursor must
be a locator or a LOB variable.

508 Message Reference, Volume 2

Table 27. Class Code 42: Syntax Error or Access Rule Violation (continued)
SQLSTATE Meaning
Value
42858 Operation cannot be applied to the specified object.
42863 An undefined host variable in REXX has been detected.
42866 The data type in either the RETURNS clause of the CAST FROM clause
in the CREATE FUNCTION statement is not appropriate for the data
type returned from the sourced function or RETURN statement in the
function body.
42875 The object to create within CREATE SCHEMA must have the same
qualifier as the schema name.
42877 The column name cannot be qualified.
42878 An invalid function or procedure name was used with the EXTERNAL
keyword.
42879 The data type of one or more input parameters in the CREATE
FUNCTION statement is not appropriate for the corresponding data type
in the source function.
42880 The CAST TO and CAST FROM data types are incompatible, or would
always result in truncation of a fixed string.
42881 Invalid use of a row based function.
42882 The specific instance name qualifier is not equal to the function name
qualifier.
42883 No function was found with a matching signature.
42884 No function or procedure was found with the specified name and
compatible arguments.
42885 The number of input parameters specified on a CREATE FUNCTION
statement does not match the number provided by the function named in
the SOURCE clause.
42886 The IN, OUT, or INOUT parameter attributes do not match.
42887 The function is not valid in the context where it occurs.
42888 The table does not have a primary key.
42889 The table already has a primary key.
42890 A column list was specified in the references clause, but the identified
parent table does not have a unique constraint with the specified column
names.
42891 A duplicate UNIQUE constraint already exists.
42893 The object or constraint cannot be dropped, because other objects are
dependent on it.
42894 The DEFAULT value is invalid.

Chapter 3. SQLSTATE Messages 509

 Table 27. Class Code 42: Syntax Error or Access Rule Violation (continued)
SQLSTATE Meaning
Value
42895 For static SQL, an input host variable cannot be used, because its data
type is not compatible with the parameter of a procedure or user-defined
function.
428A0 An error occurred with the sourced function on which the user-defined
function is based.
428A1 Unable to access a file referenced by a host file variable.
428A2 A table cannot be assigned to a multi-node node group, because it does
not have a partition key.
428A3 An invalid path has been specified for an event monitor.
428A4 An invalid value has been specified for an event monitor option.
428A5 An exception table named in a SET INTEGRITY statement either does
not have the proper structure, or it has been defined with generated
columns, constraints, or triggers.
428A6 An exception table named in a SET INTEGRITY statement cannot be the
same as one of the tables being checked.
428A7 There is a mismatch in the number of tables being checked and in the
number of exception tables specified in the SET INTEGRITY statement.
428A8 Cannot reset the check-pending state using the SET INTEGRITY
statement on a descendent table while a parent table is in the
check-pending state.
428A9 The node range is invalid.
428B0 Illegal nesting inside ROLLUP, CUBE, or GROUPING SETS.
428B1 Incorrect number of table space container specifications that are not
designated for specific nodes.
428B2 The path name for the container is not valid.
428B3 An invalid SQLSTATE was specified on RAISE_ERROR.
428C0 The node cannot be dropped, because it is the only node in the
nodegroup.
428C1 Only one ROWID column can be specified for a table.
428C2 Examination of the function body indicates that the given clause should
have been specified on the CREATE FUNCTION statement.
428C4 The number of elements on each side of the predicate operator is not the
same.
428C5 No data type mapping was found for a data type from the data source.
428C9 A ROWID column cannot be specified as the target column of an INSERT
or UPDATE.

510 Message Reference, Volume 2

Table 27. Class Code 42: Syntax Error or Access Rule Violation (continued)
SQLSTATE Meaning
Value
428CA A table in append mode cannot have a clustered index.
428CB The page size for a table space must match the page size of the
associated bufferpool.
428D1 Unable to access a file referenced by a DATALINK value.
428D4 A cursor specified in a FOR statement cannot be referenced in an OPEN,
CLOSE, or FETCH statement.
428D5 The ending label does not match the beginning label.
428D6 UNDO is not allowed for NOT ATOMIC statements.
428D7 The condition value is not allowed.
428D8 The declaration or use of the SQLSTATE or SQLCODE variable is not
valid.
428DB An object is not valid as a supertype, supertable, or superview.
428DC The function is not valid as the transform for this type.
428DD A required transform is not defined.
428DE PAGESIZE value is not supported.
428DF Data types specified in CREATE CAST are not valid.
428DG Function specified in CREATE CAST is not valid.
428DH Operation is not valid for typed tables.
428DJ Inherited column or attribute cannot be changed or dropped.
428DK The scope for the reference column is already defined.
428DL Parameter of external or sourced function has a scope defined.
428DM The scope table or view is not valid for the reference type.
428DN SCOPE is not specified in the RETURNS clause of an external function or
is specified in the RETURNS clause of a sourced function.
428DP The type is not a structured type.
428DQ A subtable or subview cannot have a different schema name than its
supertable or superview.
428DR Operation cannot be applied to a sub-table.
428DS Index on the specified columns cannot be defined on subtable.
428DT Operand of expression is not a valid scoped reference type.
428DU A type is not included in the required type hierarchy.
428DV Invalid left operand of a dereference operator.

Chapter 3. SQLSTATE Messages 511

 Table 27. Class Code 42: Syntax Error or Access Rule Violation (continued)
SQLSTATE Meaning
Value
428DW Object identifier column cannot be referenced using the dereference
operator.
428DX Object identifier column is required to define the root table or root view
of a typed table or typed view hierarchy.
428DY Table statistics cannot be updated for a subtable.
428DZ An object identifier column cannot be updated.
428E0 Definition of index does not match the definition of the index extension.
428E1 Result of the range-producing table function is inconsistent with that of
the key transformation table function for the index extension.
428E2 Number or the type of key-target parameters does not match with the
number or type of key transform function for the index extension.
428E3 Argument for function in index extension is not valid.
428E4 Function is not supported in CREATE INDEX EXTENSION statement.
428E5 SELECTIVITY clause can only be specified with a user-defined predicate.
428E6 The search argument of method in the user-defined predicate does not
match the one in the corresponding search method of the index
extension.
428E7 Type of the operand following the comparison operator in the
user-defined predicate does not match the RETURNS data type.
428E8 A search target or search argument parameter does not match a
parameter name of the function being created.
428E9 An argument parameter name cannot appear as both a search target and
search argument in the same exploitation rule.
428EA A fullselect in a typed view is not valid.
428EB A column in a subview cannot be read only when the corresponding
column in the superview is updatable.
428EC The fullselect specified for the summary table is not valid.
428ED Structured types with Datalink or Reference type attributes cannot be
constructed.
428EE Option is not valid for this data source.
428EF Value for the option is not valid for this data source.
428EG Missing required option for this data source.
428EH Cannot ADD an option that is already defined.
428EJ Cannot SET or DROP an option that has not been ADDed.

512 Message Reference, Volume 2

Table 27. Class Code 42: Syntax Error or Access Rule Violation (continued)
SQLSTATE Meaning
Value
428EK The qualifier for a declared global temporary table name must be
SESSION.
428EL A transform function is not valid for use with a function or method.
428EM The TRANSFORM GROUP clause is required.
428EN A transform group is specified that is not used.
428EP A structured type cannot depend on itself either directly or indirectly.
428EQ The returns type of the routine is not the same as the subject type.
428ER A method specification cannot be dropped before the method body is
dropped.
428ES A method body does not correspond to the language type of the method
specification.
428EU TYPE or VERSION is not specified in the server definition.
428EV Pass-through facility is not supported for the type of data source.
428EW The table cannot be converted to or from a summary table.
428EX Routine cannot be used as a transform function because it is either a
builtin function or a method.
428EY The data type of the search target in a user-defined predicate does not
match the data type of the source key of the specified index extension.
428EZ A window specification for an OLAP function is not valid.
428F0 A ROW function must include at least two columns.
428F1 An SQL TABLE function must return a table result.
428F2 The data type of the RETURN statement value in an SQL procedure
must be INTEGER.
42901 A column function does not include a column name.
42903 A WHERE clause or SET clause includes an invalid reference, such as a
column function.
42904 The SQL procedure was not created because of a compile error.
42907 The string is too long.
42908 The statement does not include a required column list.
42911 A decimal divide operation is invalid, because the result would have a
negative scale.
42912 A column cannot be updated, because it is not identified in the UPDATE
clause of the select-statement of the cursor.
42914 The DELETE is invalid, because a table referenced in a subquery can be
affected by the operation.

Chapter 3. SQLSTATE Messages 513

 Table 27. Class Code 42: Syntax Error or Access Rule Violation (continued)
SQLSTATE Meaning
Value
42915 An invalid referential constraint has been detected.
42916 The alias cannot be created, because it would result in a repetitive chain
of aliases.
42917 The object cannot be explicitly dropped.
42918 A user-defined data type cannot be created with a system-defined data
type name (for example, INTEGER).
42919 Nested compound statements are not allowed.
42921 Containers cannot be added to the tablespace.
42925 Recursive named derived tables cannot specify SELECT DISTINCT and
must specify UNION ALL.
42928 WITH EMPTY TABLE cannot be specified for a table that has a
dependent REFRESH IMMEDIATE summary table.
42932 The program preparation assumptions are incorrect.
42939 The object cannot be created, because the specified identifier is reserved
for system use.
42962 A long column, LOB column, or structured type column cannot be used
in an index, a key, or a constraint.
42968 The connection failed, because there is no current software license.
42969 The package was not created and the current unit of work was rolled
back, because of internal limitations or an invalid section number.
42972 An expression in a join-condition references columns in more than one of
the operand tables.
42985 The statement is not allowed in a routine.
42987 The statement is not allowed in a procedure or trigger.
42989 A GENERATED column that is based on an expression cannot be used in
a BEFORE trigger.
42991 The BOOLEAN data type is currently only supported internally.
42993 The column, as defined, is too large to be logged.
42994 Raw device containers are not currently supported on this system.
42995 The requested function does not apply to global temporary tables.
42997 A unique index or unique constraint is not allowed because the key
columns are not a superset of the partitioned key columns.
429A0 A foreign key cannot reference a parent table defined as not logged
initially.
429A1 Nodegroup is not valid for the table space.

514 Message Reference, Volume 2

 Table 27. Class Code 42: Syntax Error or Access Rule Violation (continued)
SQLSTATE Meaning
Value
429A9 SQL statement cannot be processed by DataJoiner.
429B2 Specified inline length value for the structured type is too small.
429B3 Object may not be defined on a subtable.
429B4 Data filter function cannot be a LANGUAGE SQL function.
429B5 Data type of instance parameter in index extension is not valid.
429B8 A routine defined with PARAMETER STYLE JAVA cannot have a
structured type as a parameter or returns type.
429B9 DEFAULT or NULL cannot be used in an attribute assignment.
429BA A federated view or summary table definition does not reference a
nickname or OLE DB table function.
429BB A data type specified for a parameter or variable is not supported in a
SQL routine.
429BC There are multiple container actions in the ALTER TABLESPACE
statement.

Class Code 44 WITH CHECK OPTION Violation

Table 28. Class Code 44: WITH CHECK OPTION Violation
SQLSTATE Meaning
Value
44000 The INSERT or UPDATE is not allowed, because a resulting row does
not satisfy the view definition.

Class Code 46 Java DDL

Table 29. Class Code 46: Java DDL
SQLSTATE Meaning
Value
46001 Java DDL - Invalid URL.
46002 Java DDL - Invalid jar name.
46003 Java DDL - Invalid class deletion.
46007 Java DDL - Invalid signature.
46008 Java DDL - Invalid method specification.
46501 Java DDL - Optional component not implemented.

Chapter 3. SQLSTATE Messages 515

Class Code 51 Invalid Application State
Table 30. Class Code 51: Invalid Application State
SQLSTATE Meaning
Value
51002 The package corresponding to an SQL statement execution request was
not found.
51003 Consistency tokens do not match.
51004 An address in the SQLDA is invalid.
51005 Thr previous system error has disabled this function.
51008 The release number of the precompiled program is not valid.
51015 An attempt was made to execute a section that was found to be in error
at bind time.
51017 The user is not logged on.
51021 SQL statements cannot be executed until the application process executes
a rollback operation.
51022 A CONNECT that specifies an authorization name is invalid when a
connection (either current or dormant) already exists to the server named
in that CONNECT statement.
51023 The database is already in use by another instance of the database
manager.
51024 A view cannot be used, because it has been marked inoperative.
51025 An application in the XA transaction processing environment is not
bound with SYNCPOINT TWOPHASE.
51026 An event monitor cannot be turned on, because its target path is already
in use by another event monitor.
51027 The IMMEDIATE CHECKED option of the SET INTEGRITY statement is
not valid since a table is not in the check-pending state.
51028 A package cannot be used, because it is marked inoperative.
51030 The procedure referenced in a ALLOCATE CURSOR, or an ASSOCIATE
LOCATORS statement has not yet been called within the application
process.

Class Code 54 SQL or Product Limit Exceeded

Table 31. Class Code 54: SQL or Product Limit Exceeded
SQLSTATE Meaning
Value
54001 The statement is too long or too complex.

516 Message Reference, Volume 2

Table 31. Class Code 54: SQL or Product Limit Exceeded (continued)
SQLSTATE Meaning
Value
54002 A string constant is too long.
54004 The statement has too many table names or too many items in a SELECT
or INSERT list.
54006 The result of concatenation is too long.
54008 The key is too long, has too many columns, or a key column is too long.
54010 The record length of the table is too long.
54011 Too many columns were specified for a table or view.
54023 The limit for the number of parameters or arguments for a function or a
procedure has been exceeded.
54028 The maximum number of concurrent LOB handles has been reached.
54029 The maximum number of open directory scans has been reached.
54030 The maximum number of event monitors are already active.
54031 The maximum number of files have already been assigned the event
monitor.
54032 The maximum size of a table has been reached.
54033 The maximum number of partitioning maps has been reached.
54034 The combined length of all container names for the tablespace is too
long.
54035 An internal object limit exceeded.
54036 The path name for the container is too long.
54037 The container map for the tablespace is too complicated.
54038 Maximum depth of cascaded triggers exceeed.
54045 Maximum levels of a type hierarchy exceeded.
54046 The maximum allowable parameters is exceeded in an index extension.
54047 The maximum size of a table space is exceeded.
54048 A temporary table space with sufficient page size does not exist.
54049 Length of an instance of a structured type exceeds system limit.
54050 The maximum allowable attributes is exceeded in a structured type.

Chapter 3. SQLSTATE Messages 517

Class Code 55 Object Not in Prerequisite State
Table 32. Class Code 55: Object Not in Prerequisite State
SQLSTATE Meaning
Value
55001 The database must be migrated.
55002 The explanation table is not defined properly.
55006 The object cannot be dropped, because it is currently in use by the same
application process.
55007 The object cannot be altered, because it is currently in use by the same
application process.
55009 The system attempted to write to a read-only file or a write-protected
diskette.
55012 A clustering index already exists on the table.
55019 The table is in an invalid state for the operation.
55022 The file server is not registered with this database.
55023 An error occured calling a routine.
55024 The tablespace cannot be dropped, because data related to a table is also
in another tablespace.
55025 The database must be restarted.
55026 A temporary tablespace cannot be dropped.
55031 The format of the error mapping file is incorrect.
55032 The CONNECT statement is invalid, because the database manager was
stopped after this application was started.
55033 An event monitor cannot be activated in the same unit of work in which
it is created or modified.
55034 The event monitor is in an invalid state for the operation.
55036 The node cannot be dropped, because it has not been removed from the
partitioning map.
55037 The partitioning key cannot be dropped, because the table is in a
multi-node nodegroup.
55038 The nodegroup cannot be used, because it is being rebalanced.
55039 The access or state transition is not allowed, because the tablespace is not
in an appropriate state.
55041 Containers cannot be added to a tablespace while a rebalance is in
progress.
55043 Attributes of a structured type cannot be altered when a typed table or
typed view based on the type exists.

518 Message Reference, Volume 2

Class Code 56 Miscellaneous SQL or Product Error
Table 33. Class Code 56: Miscellaneous SQL or Product Error
SQLSTATE Meaning
Value
56031 The clause or scalar function is invalid, because mixed and DBCS data
are not supported on this system.
56033 The insert or update value of a long string column must be a host
variable or NULL.
56084 LOB data is not supported in DRDA.
56091 Multiple errors occurred as a result of executing a compound SQL
statement.
56092 The type of authorization cannot be determined, because the
authorization name is both a user id and group id.
56097 LONG VARCHAR and LONG VARGRAPHIC fields are not permitted in
TABLESPACEs which are built on DEVICEs.
56098 An error occurred during implicit rebind or prepare.
56099 The REAL data type is not supported by the target database.
560A0 Action on a LOB value failed.
560AA The clause or scalar function is invalid, because UCS-2 is not supported
on this system.
560AC Wrapper definition cannot be used for the specified type or version of
data source.
560AF PREPARE statement is not supported when using gateway concentrator.
560B0 Invalid new size value for table space container resizing.

Class Code 57 Resource Not Available or Operator Intervention

Table 34. Class Code 57: Resource Not Available or Operator Intervention
SQLSTATE Meaning
Value
57001 The table is unavailable, because it does not have a primary index.
57003 The specified bufferpool has not been activated.
57007 The object cannot be used, because a DROP or ALTER is pending.
57009 Virtual storage or database resource is temporarily unavailable.
57011 Virtual storage or database resource is not available.
57012 A non-database resource is not available. This will not affect the
successful execution of subsequent statements.

Chapter 3. SQLSTATE Messages 519

 Table 34. Class Code 57: Resource Not Available or Operator Intervention (continued)
SQLSTATE Meaning
Value
57013 A non-database resource is not available. This will affect the successful
execution of subsequent statements.
57014 Processing was canceled as requested.
57016 The table cannot be accessed, because it is inactive.
57017 Character conversion is not defined.
57019 The statement was not successful, because of a problem with a resource.
57020 The drive containing the database is locked.
57021 The diskette drive door is open.
57022 The table could not be created, because the authorization ID of the
statement does not own any suitable dbspaces.
57030 Connection to application server would exceed the installation-defined
limit.
57032 The maximum number of concurrent databases have already been
started.
57033 Deadlock or timeout occurred without automatic rollback.
57036 The transaction log does not belong to the current database.
57046 A new transaction cannot start because the database or instance is
quiesced.
57047 An internal database file cannot be created, because the directory is not
accessible.
57048 An error occurred while accessing a container for a tablespace.
57049 The operating system process limit has been reached.
57050 The file server is not currently available.
57051 The estimated CPU cost exceeds the resource limit.
57052 Node is unavailable, because it does not have containers for all
temporary table spaces.
57055 A temporary table space with sufficient page size was not available.
57056 Package is not available because the database is in NO PACKAGE LOCK
mode.
57057 The SQL statement cannot be executed due to a prior condition in a
DRDA chain of SQL statements.

520 Message Reference, Volume 2

Class Code 58 System Error
Table 35. Class Code 58: System Error
SQLSTATE Meaning
Value
58004 A system error (that does not necessarily preclude the successful
execution of subsequent SQL statements) occurred.
58005 A system error (that prevents the successful execution of subsequent SQL
statements) occurred.
58008 Execution failed due to a distribution protocol error that will not affect
the successful execution of subsequent DDM commands or SQL
statements.
58009 Execution failed due to a distribution protocol error that caused
deallocation of the conversation.
58010 Execution failed due to a distribution protocol error that will affect the
successful execution of subsequent DDM commands or SQL statements.
58011 The DDM command is invalid while the bind process in progress.
58012 The bind process with the specified package name and consistency token
is not active.
58014 The DDM command is not supported.
58015 The DDM object is not supported.
58016 The DDM parameter is not supported.
58017 The DDM parameter value is not supported.
58018 The DDM reply message is not supported.
58023 A system error has caused the current program to be canceled.
58030 An I/O error has occurred.
58031 The connection was unsuccessful, because of a system error.
58032 Unable to use the process for a fenced mode user-defined function.
58034 An error was detected while attempting to find pages for an object in a
DMS tablespace.
58035 An error was detected while attempting to free pages for an object in a
DMS tablespace.
58036 The internal tablespace ID specified does not exist.

Chapter 3. SQLSTATE Messages 521

522 Message Reference, Volume 2
Appendix A. Communications Errors
If your application returns an sqlcode of -30081, it means that a
communications error has been detected. The actual error encountered by the
communication subsystem is returned in the list of error tokens for the 30081
error message. The following lists possible communications errors that can be
returned.

The error codes are grouped by protocol as follows:

v “TCP/IP”
v “APPC” on page 527
v “NETBIOS” on page 529
v “IPX/SPX” on page 531

TCP/IP
When using TCP/IP in a Unix environment, the following table lists some of
the errnos which the user may encounter most frequently. It is NOT a
complete list of errors. Errnos can be found in the file /usr/include/sys/errno.h.
The errno number itself is indicated for each operating system.
Table 36. Unix TCP/IP errnos.
Errno Number
Errno Description
AIX HP-UX Solaris UnixWare Linux
Interrupted system
EINTR 4 4 4 4 4
call.
Resource temporarily
EAGAIN 11 11 11 11 11
unavailable.
EBUSY 16 16 16 16 16 Resource busy.
The per-process file
EMFILE 24 24 24 24 24 descriptor table is
full.
EPIPE 32 32 32 32 32 Broken pipe.
The specified address
EADDRINUSE 67 226 125 125 98
is already in use.
The network is
ENETDOWN 69 228 127 127 100
down.
No route to the
ENETUNREACH 70 229 128 128 101
network is available.

© Copyright IBM Corp. 1993, 2000 523

Table 36. Unix TCP/IP errnos. (continued)
Errno Number
Errno Description
AIX HP-UX Solaris UnixWare Linux
The network has
ENETRESET 71 230 129 129 102 dropped the
connection on reset.
Connection has been
ECONNRESET 73 232 131 131 104
reset by the partner.
Insufficient buffer
space resources were
ENOBUFS 74 233 132 132 105 available in the
system to complete
the call.
The socket is not
ENOTCONN 76 235 134 134 107
connected.
The connection timed
ETIMEDOUT 78 238 145 145 110
out.
The connection has
been refused. If you
are trying to connect
to the database,
check that the
database manager
and TCP/IP protocol
support at the server
have been started
ECONNREFUSED 79 239 146 146 111
successfully.

If using SOCKS
protocol support, also
ensure that TCP/IP
protocol support at
the SOCKS server
has been started
successfully.
EHOSTDOWN 80 241 147 147 112 The host is down.
No route to the host
EHOSTUNREACH 81 242 148 148 113
is available.

For more information on Unix TCP/IP communication errors, refer to the

technical reference manuals for the appropriate operating system. You can also
issue the following command:
man function-name

524 Message Reference, Volume 2

where function-name represents the name of the function that returned an
error. The man pages might provide you with additional information about
errors returned by specific functions.

When using OS/2 TCP/IP, the following is a list of errnos which the user may
encounter most frequently. It is NOT a complete list of errors. Errnos can be
found in the file nerrno.h This file is part of the TCP/IP product include files.
It may not be present on your system if they have not been installed. The
errno number itself is in parentheses.
v SOCEINTR (10003): Interrupted system call.
v SOCEMFILE (10024): Too many open files.
v SOCEPIPE (10032): Broken pipe.
v EADDRINUSE (10048): The specified address is already in use.
v ENETDOWN (10050): The network is down.
v ENETUNREACH (10051): No route to the network is available.
v ENETRESET (10052): The network has dropped the connection on reset.
v SOCECONNABORTED (10053): The software caused a connection abort.
v ECONNRESET (10054): Connection has been reset by the partner.
v ENOBUFS (10055): No buffer space available.
v ENOTCONN (10057): The socket is not connected.
v ETIMEDOUT (10060): The establishment of a connection timed out before a
connection was made.
v ECONNREFUSED (10061): The connection has been refused. If you are
trying to connect to the database, check that the database manager and
TCP/IP protocol support at the server has been started successfully.
If using SOCKS protocol support, also ensure that TCP/IP protocol support
at the SOCKS server has been started successfully.
v EHOSTDOWN (10064): The host is down.
v EHOSTUNREACH (10065): No route to the host is available.
v SOCEOS2ERR (10100): OS/2 error.

For more information on OS/2 TCP/IP communication errors, refer to the

OS/2 TCP/IP documentation.

When using TCP/IP or IPX/SPX on a Windows 32-bit operating system, the

following is a list of error codes which the user may encounter most
frequently. It is NOT a complete list of errors. Errors returned by
WSAGetLastError() can be found in the file winsock.h. This file may not be
installed on your system if you do not have a development environment
installed. Detailed information about errors returned by specific functions are
documented in the Windows Sockets 2 Application Programming Interface.

Appendix A. Communications Errors 525

 You can get a copy of this specification from the following website:
http://www.stardust.com/winsock/ws_specs.htm.
v WSAEINVAL (10022): If this error is received on function WSASTARTUP,
then the Windows Sockets version supported by the application is not
supported by this DLL.
v WSAEMFILE (10024): There are no file descriptors available.
v WSAEWOULDBLOCK (10035): The socket is marked as non-blocking and
the operation would block.
v WSAEINPROGRESS (10036): A blocking Windows Sockets operation is in
progress.
v WSAENOPROTOOPT (10042): The option is unknown or unsupported.
v WSAEADDRINUSE (10048): The specified address is already in use.
v WSAENETDOWN (10050): The network subsystem has failed.
v WSAENETUNREACH (10051): The network can’t be reached from this host
at this time.
v WSAENETRESET (10052): The connection has been broken due to remote
host resetting.
v WSAECONNABORTED (10053): The virtual circuit was aborted due to
timeout or other failure. The network has dropped the connection on reset.
v WSAECONNRESET (10054): Connection has been reset by the partner.
v WSAENOBUFS (10055): No buffer space available, too many connections.
v WSAENOTCONN (10057): The socket is not connected.
v WSAETIMEDOUT (10060): The establishment of a connection timed out
before a connection was made.
v WSAECONNREFUSED (10061): The connection has been refused. If you are
trying to connect to the database, check that the database manager and
TCP/IP protocol support at the server has been started successfully.
v WSAEHOSTUNREACH (10065): The network can’t be reached from this
host at this time.
v WSASYSNOTREADY (10091): The underlying network subsystem is not
ready for network communication.
v WSAVERNOTSUPPORTED (10092): The version of Windows Sockets API
support requested is not provided by this particular Windows Sockets
implementation.
v WSAHOST_NOT_FOUND (11001): Host not found.
v WSATRY_AGAIN (11002): Host not found. Request to retrieve the
hostname’s IP address from the name server failed.
v WSANO_DATA (11004): Valid name, no data record of requested type. The
name server or hosts file does not recognize the hostname, or the service
name is not specified in the services file.

526 Message Reference, Volume 2

 For more information on TCP/IP communication errors under Windows, refer
to the Windows Sockets documentation.

APPC
Below is a list of CPI-C function return codes which the user may encounter
most frequently. It is NOT a complete list of return codes. The number in
parentheses indicates the defined number corresponding to the return code.
v CM_ALLOCATE_FAILURE_NO_RETRY (1): Allocation failed because of a
non-temporary condition. For example, the session cannot be activated due
to a system definition error or session-activation protocol error. This return
code is also returned when the session is deactivated because of a session
protocol error before the conversation can be allocated.
v CM_ALLOCATE_FAILURE_RETRY (2): Allocation failed because of a
temporary condition. For example, the session cannot be activated due to a
temporary lack of resources at the local system or remote system.
v CM_CONVERSATION_TYPE_MISMATCH (3): Allocation failed because the
remote program does not support the conversation type in the allocation
request. This is likely a problem with the TP at the server. Ensure that the
TP at the server is configured to support a conversation type of basic.
v CM_TPN_NOT_RECOGNIZED (9): This error occurs when the allocate
request is sent to the remote system. It indicates that the remote system
does not recognize the transaction program name specified in the request. If
you are not using global directory services, ensure that the TP name
specified in the CPI-C Side Information profile at the client, matches the TP
name specified at the server. If you are using global directory services,
request your database administrator’s help to ensure that the TP name
specified in the global directory entry matches the TP name specified at the
server.
v CM_TP_NOT_AVAILABLE_NO_RETRY (10): This error occurs when the
allocate request is sent to the remote system. It indicates that the remote LU
recognizes the TP name sent, but cannot start the program. Also check that
the userid specified in the TPN profile at the server is valid.
v CM_TP_NOT_AVAILABLE_RETRY (11): This error occurs when the allocate
request is sent to the remote system. It indicates that the remote LU
recognizes the TP name sent, but for some reason which may be temporary,
it cannot start the program. Ensure that the database manager and APPC
protocol support at the server have been started successfully.
v CM_DEALLOCATED_ABEND (17): This error occurs when the remote
program deallocates the conversation. This can occur if the remote program
has abnormally terminated, or has encountered a fatal error condition. If
you are trying to connect to DB2 for AIX, check that the database manager
and APPC protocol support at the server have been started successfully. For
an AIX server, this error could also be caused by one of the following:

Appendix A. Communications Errors 527

 – The database agent at the server was forced off by the system
administrator.
– A database agent could not be started at the server because the maxagents
database manager configuration parameter has been exceeded. Check the
First Failure Service Log (DB2DIAG.LOG) at the server to see if an error
message has been logged.
– The database agent at the server was terminated due to an abnormal
termination of a key database manager process.
v CM_PRODUCT_SPECIFIC_ERROR (20): A product-specific error has been
detected, and a description of the error has been stored in the product’s
system error log. Check that the local APPC subsystem has been started
successfully. For Communication Server for AIX, to get more information
about a product-specific error, it is necessary to check the value of the
global variable errno. See the section below for more information on
possible errnos that can be returned. Communication Server for OS/2
records errors in the OS/2 system error log.
v CM_RESOURCE_FAILURE_NO_RETRY (26): This error occurs when the
conversation terminates prematurely (on either the remote or local end)
from an error related to resources (such as sessions or links). For an OS/2
server, this error could also be caused by one of the following:
– The database agent at the server was forced off by the system
administrator.
– A database agent could not be started at the server because the maxagents
database manager configuration parameter has been exceeded. Check the
First Failure Service Log (DB2DIAG.LOG) at the server to see if an error
message has been logged.
– The database agent at the server was terminated due to an abnormal
termination of a key database manager process.
v CM_RESOURCE_FAILURE_RETRY (27): This error occurs when the
conversation terminates prematurely (on either the remote or local end) for
about the same reason as the NO_RETRY condition described above. The
only difference is that the error may not be permanent.
For the most part, CPI Communications return codes are enough to deduce
the cause of the error. But when CM_PRODUCT_SPECIFIC_ERROR is
returned, additional information is provided.

For Communication Server for AIX, the errno provides additional information.
Below is a list of some of the more common errnos. It is NOT a complete list.
Errnos numbered 101 and higher can be found in the file
/usr/include/luxsna.h, which contains the Communication Server for AIX
specific errnos. Most of these errnos are translated to CPI-C return codes.
Lower-numbered errnos are related to AIX problems and can be found in the
file /usr/include/sys/errno.h. The errno number itself is in parentheses.

528 Message Reference, Volume 2

 v EBADF (9): This is a ″bad file descriptor″ error. If this error occurs when
trying to connect to the database, it usually means that the SNA subsystem
at the server has not been started, or that there is some problem with the
SNA configuration profiles. Check that the SNA subsystem at the server has
been started. Check that the link station to the server node can be activated.
v EACCESS (13): This is a ″permission denied″ error. If this error occurs when
trying to connect to the database, it usually means that there is some
problem with the SNA configuration profiles.
On HP-UX, for SNAPlus2, please refer to the /usr/include/sys/errno.h file
for a description of the error.

For OS/2, when CPI Communications returns

CM_PRODUCT_SPECIFIC_ERROR, an entry is created in the error log.
Information in the error log entry identifies CPIC as the originator. If
Communications Server/2 (CS/2) is installed, CS/2 records the error in the
OS/2 system error log. Refer to the problem determination guide for the
specific product, for a complete description of the error, and the
recommended action to take.

For more information on CPI Communications errors, refer to Systems

Application Architecture Common Programming Interface Communications
Reference.

NETBIOS
When using NetBIOS, the following is a list of hexadecimal return codes that
the user may encounter most frequently. It is NOT a complete list of return
codes.
01 Invalid buffer length
03 Invalid command
05 Command timed out
06 Message incomplete
07 Data not received
08 Invalid local session number
09 No resource available
0A Session closed
This error could be caused by one of the following:
v The database agent at the server was forced off by the system
administrator.
v A database agent could not be started at the server because the
maxagents database manager configuration parameter has been
exceeded. Check the First Failure Service Log (DB2DIAG.LOG) at
the server to see if an error message has been logged.

Appendix A. Communications Errors 529

 v The database agent at the server was terminated due to an
abnormal termination of a key database manager process.
0B Command cancelled
0D Duplicate name used on the network. Ensure that the nname
parameter defined in the database manager configuration file is
unique on the network.
0E Name table full
0F Command completed (name has active sessions and is now
deregistered)
11 Local session table full
12 Session open rejected
13 Invalid name number
14 Remote name not found
If this error occurs when trying to connect to the database, ensure
that:
v The database manager has been successfully started at the server,
and NetBIOS support has also been successfully started.
v The server nname specified in the NETBIOS node entry at the
client, matches the workstation name specified in the database
manager configuration file at the server.
15 Local name not found
16 Name in use on remote node
17 Name deleted
18 Session ended abnormally
19 Name conflict detected
21 Interface busy
22 Too many commands outstanding
23 Invalid adapter
24 Command already completed
26 Command invalid to cancel
30 Name defined by another environment
34 Environment not defined, RESET must be issued
35 Required operating system resources exhausted, retry later
36 Max applications exceeded
37 No SAPs available
38 Requested resources not available
39 Invalid NCB address
3A Invalid reset
3B Invalid NCB DD ID
3C Segment lock unsuccessful
3F Device driver open error.
40 OS error detected
4F Perm ring status
F6 Unexpected CCB error
F8 Adapter open error

530 Message Reference, Volume 2

 F9 Adapter support software internal error
FA Adapter check
FB NetBIOS not operational
FC Open failures
FD Unexpected adapter close
FF Command in process

For more information on NetBIOS return codes, refer to the Local Area
Network technical reference.

IPX/SPX
When using IPX/SPX on Windows 32-bit operating systems, refer to the
TCP/IP section for a list of the most frequently encountered errors. Errors
returned by both TCP/IP and IPX/SPX on Windows systems conform to the
WINSOCK specifications. When using IPX/SPX on OS/2 or Unix systems, the
following is a list of t_errnos which the user may encounter most frequently. It
is NOT a complete list of errors. Error values can be found in the file tiuser.h.
The t_errno number itself is in parentheses.
v TBADF (4): Specified file handle does not refer to a transport endpoint.
v TNOADDR (5): Transport provider could not allocate an address.
v TOUTSTATE (6): A function was issued in the wrong sequence.
v TSYSERR (8): A system error occurred during execution of this function.
v TLOOK (9): An asynchronous event has occurred on this connection.
v TNODATA (13): No data is currently available from the transport provider.
v TADDRBUSY (23): Specified address is in use and the transport provider
could not allocate a new address.

When the first error token specifies t_errno = TLOOK, the second error token
specifies an event. Below is a list of events which the user may encounter most
frequently. It is NOT a complete list of events. Events can be found in the file
tiuser.h. The event value is in parentheses.
v T_DISCONNECT (0x0010): Disconnect received.
This error could be caused by one of the following:
– The server was not started, or IPX/SPX support on the server was not
started. Check the First Failure Service Log (DB2DIAG.LOG) at the
server to see if messages have been logged.
– The node directory information specified on the client is incorrect.
– The client or server IPX/SPX communications stack was not installed
and/or configured properly.
– The database agent at the server was forced off by the system
administrator.

Appendix A. Communications Errors 531

 – A database agent could not be started at the server because the maxagents
database manager configuration parameter has been exceeded. Check the
First Failure Service Log (DB2DIAG.LOG) at the server to see if an error
message has been logged.
– The database agent at the server was terminated due to an abnormal
termination of a key database manager process.

When the first error token specifies t_errno = TLOOK, and the second error
token specifies the event T_DISCONNECT, the third error token specifies a
disconnect reason code. Below is a list of disconnect reason codes which the user
may encounter most frequently. It is NOT a complete list of reason codes.
Disconnect reason codes can be found in the file tispxipx.h. On UNIX
platforms, the reason codes are defined in the file spx_app.h. The reason code
value is in parentheses.
v TLI_SPX_CONNECTION_TERMINATED (0xEC): Disconnect received from
remote peer.
v TLI_SPX_CONNECTION_FAILED (0xED): Connection failure.

For more information on TLI IPX/SPX communication errors, refer to the

Transport Layer Interface documentation.

When using OS/2 IPX/SPX file server addressing, the following is a list of
return values which the user may encounter most frequently. It is NOT a
complete list of errors. Return values can be found in the file nwerror.h.
0x880F -
This is a ″NO CONNECTION TO SERVER″ error. Ensure that the file
server specified is up and running, and can be accessed by the client
and server workstations.
0x88FF -
If this error occurs when trying to connect to the database, and the
function is NWAttachToFileServer, ensure that the IPX/SPX protocol
support at the client has been installed correctly, and is started.
0x89EF -
This is an ″INVALID NAME″ error. Illegal characters were specified in
the file server or object name. Control characters, the comma,
semicolon, slash, backslash, question mark, asterisk, and tilde are
invalid.
0x89F2
This is a ″NO OBJECT READ PRIVILEGE″ error. The client does not
have access to read the DB2 server’s object registered at the Netware
file server.
0x89F4
This is a ″NO OBJECT DELETE PRIVILEGE″ error. Ensure that the

532 Message Reference, Volume 2

 userid/password specified during deregister has sufficient authority
to delete an object and its properties, on the file server.
0x89F5
This is a ″NO OBJECT CREATE PRIVILEGE″ error. Ensure that the
userid/password specified during register has sufficient authority to
create an object and its properties, on the file server.
0x89F6
This is a ″NO PROPERTY DELETE PRIVILEGE″ error. Ensure that the
userid/password specified during deregister has sufficient authority
to delete an object and its properties, on the file server.
0x89F7
This is a ″NO PROPERTY CREATE PRIVILEGE″ error. Ensure that the
userid/password specified during register has sufficient authority to
create an object and its properties, on the file server.
0x89F8
This is a ″NO PROPERTY WRITE PRIVILEGE″ error. Ensure the that
the userid/password specified during register has sufficient authority
to write object property values, on the file server.
0x89FC -
This is an ″UNKNOWN FILE SERVER″ or ″NO SUCH OBJECT″ error.
If this error occurs when running the REGISTER/DEREGISTER
command, ensure that:
v An object name has been specified in the database manager
configuration file, and the name contains valid characters.
v A file server name has been specified in the database manager
configuration file, and the name contains valid characters.

If this error occurs when trying to connect to the database, and the
function is NWScanProperty, ensure that:
v The network address of the database manager has been successfully
registered at the NetWare file server. This is done by running the
REGISTER command at the server.
v The object name specified in the IPXSPX node directory entry at the
client, matches the object name specified in the database manager
configuration file at the server.
v The file server name specified in the IPXSPX node directory entry
at the client, matches the file server name specified in the database
manager configuration file at the server.

If this error occurs on function NWAttachToFileServer, ensure that the

files server name was configured correctly in the database manager
configuration file.

Appendix A. Communications Errors 533

 If this error occurs on function NWLoginToFileServer, ensure that the
userid specified on the register/deregister is valid for logging into the
file server.
0x89FF -
This is a ″NO SUCH OBJECT OR BAD PASSWORD″ error. Ensure
that the password you have specified is defined, and has not expired.

For more information on IPX/SPX file server addressing errors, refer to the
NetWare Client API for C documentation.

When using Unix IPX/SPX file server addressing, the following is a list of
error generators that identify what location generated the error.
v 0x00 - File server
v 0x10 - API
v 0x20 - API

When using Unix IPX/SPX file server addressing mode, the following is a list
of error codes which the user may encounter most frequently. It is NOT a
complete list of errors. On AIX, error codes can be found in the file nwerrors.h.
0x02 - This is a ″TRANSPORT OPEN″ error. Ensure that IPX/SPX
communications was installed and configured correctly.
0xDE -
This is a ″BAD PASSWORD″ error. Ensure that the password specified
on register/deregister is valid for logging into the file server.
0xEF - This is an ″INVALID NAME″ error. Ensure that the file server and
object name specified in the database manager configuration file is
valid. Check that the name does not contain illegal characters.
0xF2 - This is a ″NO OBJECT READ PRIVILEGE″ error. The client does not
have access to read the DB2 server’s object registered at the Netware
file server.
0xF4 - This is a ″NO OBJECT DELETE PRIVILEGE″ error. Ensure that the
userid/password specified during deregister has sufficient authority
to delete an object and its properties, on the file server.
0xF5 - This is a ″NO OBJECT CREATE PRIVILEGE″ error. Ensure that the
userid/password specified during register has sufficient authority to
create an object and its properties, on the file server.
0xF6 - This is a ″NO PROPERTY DELETE PRIVILEGE″ error. Ensure that the
userid/password specified during deregister has sufficient authority
to delete an object and its properties.

534 Message Reference, Volume 2

0xF7 This is a ″NO PROPERTY CREATE PRIVILEGE″ error. Ensure that the
userid/password specified during register has sufficient authority to
create an object and its properties.
0xF8 - This is a ″NO PROPERTY WRITE PRIVILEGE″ error. Ensure the that
the userid/password specified during register has sufficient authority
to write object property values, on the file server.
0xFC - This is a ″UNKNOWN FILE SERVER″ or ″NO SUCH OBJECT″ error.
If this error occurs when running the REGISTER/DEREGISTER
command, ensure that:
v An object name has been specified in the database manager
configuration file, and the name contains valid characters.
v A file server name has been specified in the database manager
configuration file, and the name contains valid characters.

If this error occurs when trying to connect to the database, and the
function is NWScanProperty, ensure that:
v The network address of the database manager has been successfully
registered at the NetWare file server. This is done by running the
REGISTER command at the server.
v The object name specified in the IPXSPX node directory entry at the
client, matches the object name specified in the database manager
configuration file at the server.
v The file server name specified in the IPXSPX node directory entry
at the client, matches the file server name specified in the database
manager configuration file at the server.

If this error occurs on function NWAttachToServerPlatform, ensure that

the files server name was configured correctly in the database
manager configuration file.

If this error occurs on function NWLoginToServerPlatform, ensure that

the userid specified on the register/deregister is valid for logging into
the file server.
0xFF - This is a ″NO RESPONSE FROM FILE SERVER″. Ensure that the file
server is up and running and accessible by the DB2 server and client.

For more information on IPX/SPX file server addressing mode errors, refer to
the NetWare C Interface for UNIX API reference.

Appendix A. Communications Errors 535

536 Message Reference, Volume 2
Appendix B. Using the DB2 Library
The DB2 Universal Database library consists of online help, books (PDF and
HTML), and sample programs in HTML format. This section describes the
information that is provided, and how you can access it.

To access product information online, you can use the Information Center. For
more information, see “Accessing Information with the Information Center”
on page 551. You can view task information, DB2 books, troubleshooting
information, sample programs, and DB2 information on the Web.

DB2 PDF Files and Printed Books

DB2 Information
The following table divides the DB2 books into four categories:
DB2 Guide and Reference Information
These books contain the common DB2 information for all platforms.
DB2 Installation and Configuration Information
These books are for DB2 on a specific platform. For example, there are
separate Quick Beginnings books for DB2 on OS/2, Windows, and
UNIX-based platforms.
Cross-platform sample programs in HTML
These samples are the HTML version of the sample programs that are
installed with the Application Development Client. The samples are
for informational purposes and do not replace the actual programs.
Release notes
These files contain late-breaking information that could not be
included in the DB2 books.

The installation manuals, release notes, and tutorials are viewable in HTML
directly from the product CD-ROM. Most books are available in HTML on the
product CD-ROM for viewing and in Adobe Acrobat (PDF) format on the DB2
publications CD-ROM for viewing and printing. You can also order a printed
copy from IBM; see “Ordering the Printed Books” on page 547. The following
table lists books that can be ordered.

On OS/2 and Windows platforms, you can install the HTML files under the
sqllib\doc\html directory. DB2 information is translated into different

© Copyright IBM Corp. 1993, 2000 537

 languages; however, all the information is not translated into every language.
Whenever information is not available in a specific language, the English
information is provided

On UNIX platforms, you can install multiple language versions of the HTML
files under the doc/%L/html directories, where %L represents the locale. For
more information, refer to the appropriate Quick Beginnings book.

You can obtain DB2 books and access information in a variety of ways:
v “Viewing Information Online” on page 550
v “Searching Information Online” on page 554
v “Ordering the Printed Books” on page 547
v “Printing the PDF Books” on page 546
Table 37. DB2 Information
Name Description Form Number HTML
Directory
PDF File Name
DB2 Guide and Reference Information
Administration Guide Administration Guide: Planning provides SC09-2946 db2d0
an overview of database concepts, db2d1x70
information about design issues (such as
logical and physical database design),
and a discussion of high availability.

Administration Guide: Implementation SC09-2944

provides information on implementation db2d2x70
issues such as implementing your
design, accessing databases, auditing,
backup and recovery.
SC09-2945
Administration Guide: Performance db2d3x70
provides information on database
environment and application
performance evaluation and tuning.

You can order the three volumes of the

Administration Guide in the English
language in North America using the
form number SBOF-8934.
Administrative API Describes the DB2 application SC09-2947 db2b0
Reference programming interfaces (APIs) and data
structures that you can use to manage db2b0x70
your databases. This book also explains
how to call APIs from your applications.

538 Message Reference, Volume 2

Table 37. DB2 Information (continued)
Name Description Form Number HTML
Directory
PDF File Name
Application Building Provides environment setup information SC09-2948 db2ax
Guide and step-by-step instructions about how
to compile, link, and run DB2 db2axx70
applications on Windows, OS/2, and
UNIX-based platforms.
APPC, CPI-C, and SNA Provides general information about No form number db2ap
Sense Codes APPC, CPI-C, and SNA sense codes that
you may encounter when using DB2 db2apx70
Universal Database products.

Available in HTML format only.

Application Development Explains how to develop applications SC09-2949 db2a0
Guide that access DB2 databases using
embedded SQL or Java (JDBC and db2a0x70
SQLJ). Discussion topics include writing
stored procedures, writing user-defined
functions, creating user-defined types,
using triggers, and developing
applications in partitioned environments
or with federated systems.
CLI Guide and Reference Explains how to develop applications SC09-2950 db2l0
that access DB2 databases using the DB2
Call Level Interface, a callable SQL db2l0x70
interface that is compatible with the
Microsoft ODBC specification.
Command Reference Explains how to use the Command Line SC09-2951 db2n0
Processor and describes the DB2
commands that you can use to manage db2n0x70
your database.
Connectivity Supplement Provides setup and reference information No form number db2h1
on how to use DB2 for AS/400, DB2 for
OS/390, DB2 for MVS, or DB2 for VM as db2h1x70
DRDA application requesters with DB2
Universal Database servers. This book
also details how to use DRDA
application servers with DB2 Connect
application requesters.

Available in HTML and PDF only.

Appendix B. Using the DB2 Library 539

Table 37. DB2 Information (continued)
Name Description Form Number HTML
Directory
PDF File Name
Data Movement Utilities Explains how to use DB2 utilities, such SC09-2955 db2dm
Guide and Reference as import, export, load, AutoLoader, and
DPROP, that facilitate the movement of db2dmx70
data.
Data Warehouse Center Provides information on how to build SC26-9993 db2dd
Administration Guide and maintain a data warehouse using
the Data Warehouse Center. db2ddx70
Data Warehouse Center Provides information to help SC26-9994 db2ad
Application Integration programmers integrate applications with
Guide the Data Warehouse Center and with the db2adx70
Information Catalog Manager.
DB2 Connect User’s Guide Provides concepts, programming, and SC09-2954 db2c0
general usage information for the DB2
Connect products. db2c0x70
DB2 Query Patroller Provides an operational overview of the SC09-2958 db2dw
Administration Guide DB2 Query Patroller system, specific
operational and administrative db2dwx70
information, and task information for the
administrative graphical user interface
utilities.
DB2 Query Patroller Describes how to use the tools and SC09-2960 db2ww
User’s Guide functions of the DB2 Query Patroller.
db2wwx70
Glossary Provides definitions for terms used in No form number db2t0
DB2 and its components.
db2t0x70
Available in HTML format and in the
SQL Reference.
Image, Audio, and Video Provides general information about DB2 SC26-9929 dmbu7
Extenders Administration extenders, and information on the
and Programming administration and configuration of the dmbu7x70
image, audio, and video (IAV) extenders
and on programming using the IAV
extenders. It includes reference
information, diagnostic information
(with messages), and samples.
Information Catalog Provides guidance on managing SC26-9995 db2di
Manager Administration information catalogs.
Guide db2dix70

540 Message Reference, Volume 2

Table 37. DB2 Information (continued)
Name Description Form Number HTML
Directory
PDF File Name
Information Catalog Provides definitions for the architected SC26-9997 db2bi
Manager Programming interfaces for the Information Catalog
Guide and Reference Manager. db2bix70
Information Catalog Provides information on using the SC26-9996 db2ai
Manager User’s Guide Information Catalog Manager user
interface. db2aix70
Installation and Guides you through the planning, GC09-2957 db2iy
Configuration Supplement installation, and setup of
platform-specific DB2 clients. This db2iyx70
supplement also contains information on
binding, setting up client and server
communications, DB2 GUI tools, DRDA
AS, distributed installation, the
configuration of distributed requests,
and accessing heterogeneous data
sources.
Message Reference Lists messages and codes issued by DB2, Volume 1 db2m0
the Information Catalog Manager, and GC09-2978
the Data Warehouse Center, and
describes the actions you should take. db2m1x70
Volume 2
You can order both volumes of the GC09-2979
Message Reference in the English
language in North America with the db2m2x70
form number SBOF-8932.
OLAP Integration Server Explains how to use the Administration SC27-0787 n/a
Administration Guide Manager component of the OLAP
Integration Server. db2dpx70
OLAP Integration Server Explains how to create and populate SC27-0784 n/a
Metaoutline User’s Guide OLAP metaoutlines using the standard
OLAP Metaoutline interface (not by db2upx70
using the Metaoutline Assistant).
OLAP Integration Server Explains how to create OLAP models SC27-0783 n/a
Model User’s Guide using the standard OLAP Model
Interface (not by using the Model db2lpx70
Assistant).
OLAP Setup and User’s Provides configuration and setup SC27-0702 db2ip
Guide information for the OLAP Starter Kit.
db2ipx70
OLAP Spreadsheet Add-in Describes how to use the Excel SC27-0786 db2ep
User’s Guide for Excel spreadsheet program to analyze OLAP
data. db2epx70

Appendix B. Using the DB2 Library 541

Table 37. DB2 Information (continued)
Name Description Form Number HTML
Directory
PDF File Name
OLAP Spreadsheet Add-in Describes how to use the Lotus 1-2-3 SC27-0785 db2tp
User’s Guide for Lotus spreadsheet program to analyze OLAP
1-2-3 data. db2tpx70
Replication Guide and Provides planning, configuration, SC26-9920 db2e0
Reference administration, and usage information
for the IBM Replication tools supplied db2e0x70
with DB2.
Spatial Extender User’s Provides information about installing, SC27-0701 db2sb
Guide and Reference configuring, administering,
programming, and troubleshooting the db2sbx70
Spatial Extender. Also provides
significant descriptions of spatial data
concepts and provides reference
information (messages and SQL) specific
to the Spatial Extender.
SQL Getting Started Introduces SQL concepts and provides SC09-2973 db2y0
examples for many constructs and tasks.
db2y0x70
SQL Reference, Volume 1 Describes SQL syntax, semantics, and the Volume 1 db2s0
and Volume 2 rules of the language. This book also SC09-2974
includes information about
release-to-release incompatibilities, db2s1x70
product limits, and catalog views.
Volume 2
You can order both volumes of the SQL SC09-2975
Reference in the English language in
North America with the form number db2s2x70
SBOF-8933.
System Monitor Guide and Describes how to collect different kinds SC09-2956 db2f0
Reference of information about databases and the
database manager. This book explains db2f0x70
how to use the information to
understand database activity, improve
performance, and determine the cause of
problems.
Text Extender Provides general information about DB2 SC26-9930 desu9
Administration and extenders and information on the
Programming administration and configuring of the desu9x70
text extender and on programming using
the text extenders. It includes reference
information, diagnostic information
(with messages) and samples.

542 Message Reference, Volume 2

Table 37. DB2 Information (continued)
Name Description Form Number HTML
Directory
PDF File Name
Troubleshooting Guide Helps you determine the source of GC09-2850 db2p0
errors, recover from problems, and use
diagnostic tools in consultation with DB2 db2p0x70
Customer Service.
What’s New Describes the new features, functions, SC09-2976 db2q0
and enhancements in DB2 Universal
Database, Version 7. db2q0x70
DB2 Installation and Configuration Information
DB2 Connect Enterprise Provides planning, migration, GC09-2953 db2c6
Edition for OS/2 and installation, and configuration
Windows Quick information for DB2 Connect Enterprise db2c6x70
Beginnings Edition on the OS/2 and Windows 32-bit
operating systems. This book also
contains installation and setup
information for many supported clients.
DB2 Connect Enterprise Provides planning, migration, GC09-2952 db2cy
Edition for UNIX Quick installation, configuration, and task
Beginnings information for DB2 Connect Enterprise db2cyx70
Edition on UNIX-based platforms. This
book also contains installation and setup
information for many supported clients.
DB2 Connect Personal Provides planning, migration, GC09-2967 db2c1
Edition Quick Beginnings installation, configuration, and task
information for DB2 Connect Personal db2c1x70
Edition on the OS/2 and Windows 32-bit
operating systems. This book also
contains installation and setup
information for all supported clients.
DB2 Connect Personal Provides planning, installation, GC09-2962 db2c4
Edition Quick Beginnings migration, and configuration information
for Linux for DB2 Connect Personal Edition on all db2c4x70
supported Linux distributions.
DB2 Data Links Manager Provides planning, installation, GC09-2966 db2z6
Quick Beginnings configuration, and task information for
DB2 Data Links Manager for AIX and db2z6x70
Windows 32-bit operating systems.

Appendix B. Using the DB2 Library 543

Table 37. DB2 Information (continued)
Name Description Form Number HTML
Directory
PDF File Name
DB2 Enterprise - Extended Provides planning, installation, and GC09-2964 db2v3
Edition for UNIX Quick configuration information for DB2
Beginnings Enterprise - Extended Edition on db2v3x70
UNIX-based platforms. This book also
contains installation and setup
information for many supported clients.
DB2 Enterprise - Extended Provides planning, installation, and GC09-2963 db2v6
Edition for Windows Quick configuration information for DB2
Beginnings Enterprise - Extended Edition for db2v6x70
Windows 32-bit operating systems. This
book also contains installation and setup
information for many supported clients.
DB2 for OS/2 Quick Provides planning, installation, GC09-2968 db2i2
Beginnings migration, and configuration information
for DB2 Universal Database on the OS/2 db2i2x70
operating system. This book also
contains installation and setup
information for many supported clients.
DB2 for UNIX Quick Provides planning, installation, GC09-2970 db2ix
Beginnings migration, and configuration information
for DB2 Universal Database on db2ixx70
UNIX-based platforms. This book also
contains installation and setup
information for many supported clients.
DB2 for Windows Quick Provides planning, installation, GC09-2971 db2i6
Beginnings migration, and configuration information
for DB2 Universal Database on Windows db2i6x70
32-bit operating systems. This book also
contains installation and setup
information for many supported clients.
DB2 Personal Edition Provides planning, installation, GC09-2969 db2i1
Quick Beginnings migration, and configuration information
for DB2 Universal Database Personal db2i1x70
Edition on the OS/2 and Windows 32-bit
operating systems.
DB2 Personal Edition Provides planning, installation, GC09-2972 db2i4
Quick Beginnings for migration, and configuration information
Linux for DB2 Universal Database Personal db2i4x70
Edition on all supported Linux
distributions.

544 Message Reference, Volume 2

Table 37. DB2 Information (continued)
Name Description Form Number HTML
Directory
PDF File Name
DB2 Query Patroller Provides installation information about GC09-2959 db2iw
Installation Guide DB2 Query Patroller.
db2iwx70
DB2 Warehouse Manager Provides installation information for GC26-9998 db2id
Installation Guide warehouse agents, warehouse
transformers, and the Information db2idx70
Catalog Manager.
Cross-Platform Sample Programs in HTML
Sample programs in Provides the sample programs in HTML No form number db2hs
HTML format for the programming languages
on all platforms supported by DB2. The
sample programs are provided for
informational purposes only. Not all
samples are available in all
programming languages. The HTML
samples are only available when the DB2
Application Development Client is
installed.

For more information on the programs,

refer to the Application Building Guide.
Release Notes
DB2 Connect Release Provides late-breaking information that See note #2. db2cr
Notes could not be included in the DB2
Connect books.
DB2 Installation Notes Provides late-breaking Available on
installation-specific information that product
could not be included in the DB2 books. CD-ROM only.
DB2 Release Notes Provides late-breaking information about See note #2. db2ir
all DB2 products and features that could
not be included in the DB2 books.

Notes:
1. The character x in the sixth position of the file name indicates the
language version of a book. For example, the file name db2d0e70 identifies
the English version of the Administration Guide and the file name db2d0f70
identifies the French version of the same book. The following letters are
used in the sixth position of the file name to indicate the language version:

Language Identifier
Brazilian Portuguese b

Appendix B. Using the DB2 Library 545

 Bulgarian u
Czech x
Danish d
Dutch q
English e
Finnish y
French f
German g
Greek a
Hungarian h
Italian i
Japanese j
Korean k
Norwegian n
Polish p
Portuguese v
Russian r
Simp. Chinese c
Slovenian l
Spanish z
Swedish s
Trad. Chinese t
Turkish m

2. Late breaking information that could not be included in the DB2 books is
available in the Release Notes in HTML format and as an ASCII file. The
HTML version is available from the Information Center and on the
product CD-ROMs. To view the ASCII file:
v On UNIX-based platforms, see the Release.Notes file. This file is located
in the DB2DIR/Readme/%L directory, where %L represents the locale
name and DB2DIR represents:
– /usr/lpp/db2_07_01 on AIX
– /opt/IBMdb2/V7.1 on HP-UX, PTX, Solaris, and Silicon Graphics
IRIX
– /usr/IBMdb2/V7.1 on Linux.
v On other platforms, see the RELEASE.TXT file. This file is located in the
directory where the product is installed. On OS/2 platforms, you can
also double-click the IBM DB2 folder and then double-click the Release
Notes icon.
Printing the PDF Books
If you prefer to have printed copies of the books, you can print the PDF files
found on the DB2 publications CD-ROM. Using the Adobe Acrobat Reader,
you can print either the entire book or a specific range of pages. For the file
name of each book in the library, see Table 37 on page 538.

546 Message Reference, Volume 2

 You can obtain the latest version of the Adobe Acrobat Reader from the
Adobe Web site at http://www.adobe.com.

The PDF files are included on the DB2 publications CD-ROM with a file
extension of PDF. To access the PDF files:
1. Insert the DB2 publications CD-ROM. On UNIX-based platforms, mount
the DB2 publications CD-ROM. Refer to your Quick Beginnings book for
the mounting procedures.
2. Start the Acrobat Reader.
3. Open the desired PDF file from one of the following locations:
v On OS/2 and Windows platforms:
x:\doc\language directory, where x represents the CD-ROM drive and
language represent the two-character country code that represents your
language (for example, EN for English).
v On UNIX-based platforms:
/cdrom/doc/%L directory on the CD-ROM, where /cdrom represents the
mount point of the CD-ROM and %L represents the name of the desired
locale.

You can also copy the PDF files from the CD-ROM to a local or network drive
and read them from there.
Ordering the Printed Books

You can order the printed DB2 books either individually or as a set (in North
America only) by using a sold bill of forms (SBOF) number. To order books,
contact your IBM authorized dealer or marketing representative, or phone
1-800-879-2755 in the United States or 1-800-IBM-4YOU in Canada. You can
also order the books from the Publications Web page at
http://www.elink.ibmlink.ibm.com/pbl/pbl.

Two sets of books are available. SBOF-8935 provides reference and usage
information for the DB2 Warehouse Manager. SBOF-8931 provides reference
and usage information for all other DB2 Universal Database products and
features. The contents of each SBOF are listed in the following table:

Appendix B. Using the DB2 Library 547

Table 38. Ordering the printed books
SBOF Number Books Included
SBOF-8931 v Administration Guide: Planning v OLAP Integration Server
v Administration Guide: Implementation Administration Guide
v Administration Guide: Performance v OLAP Integration Server Metaoutline
User’s Guide
v Administrative API Reference
v OLAP Integration Server Model User’s
v Application Building Guide
Guide
v Application Development Guide
v OLAP Integration Server User’s Guide
v CLI Guide and Reference
v OLAP Setup and User’s Guide
v Command Reference
v OLAP Spreadsheet Add-in User’s
v Data Movement Utilities Guide and Guide for Excel
Reference
v OLAP Spreadsheet Add-in User’s
v Data Warehouse Center Administration Guide for Lotus 1-2-3
Guide
v Replication Guide and Reference
v Data Warehouse Center Application
v Spatial Extender Administration and
Integration Guide
Programming Guide
v DB2 Connect User’s Guide
v SQL Getting Started
v Installation and Configuration
v SQL Reference, Volumes 1 and 2
Supplement
v System Monitor Guide and Reference
v Image, Audio, and Video Extenders
Administration and Programming v Text Extender Administration and
Programming
v Message Reference, Volumes 1 and 2
v Troubleshooting Guide
v What’s New
SBOF-8935 v Information Catalog Manager v Query Patroller Administration Guide
Administration Guide v Query Patroller User’s Guide
v Information Catalog Manager User’s
Guide
v Information Catalog Manager
Programming Guide and Reference

DB2 Online Documentation

Accessing Online Help
Online help is available with all DB2 components. The following table
describes the various types of help.

548 Message Reference, Volume 2

Type of Help Contents How to Access...
Command Help Explains the syntax of From the command line processor in interactive
commands in the command mode, enter:
line processor. ? command

where command represents a keyword or the entire

command.

For example, ? catalog displays help for all the

CATALOG commands, while ? catalog database
displays help for the CATALOG DATABASE
command.
Client Configuration Explains the tasks you can From a window or notebook, click the Help push
Assistant Help perform in a window or button or press the F1 key.
notebook. The help includes
Command Center Help overview and prerequisite
information you need to
Control Center Help know, and it describes how
to use the window or
Data Warehouse Center
notebook controls.
Help

Event Analyzer Help

Information Catalog
Manager Help

Satellite Administration
Center Help

Script Center Help

Message Help Describes the cause of a From the command line processor in interactive
message and any action you mode, enter:
should take. ? XXXnnnnn

where XXXnnnnn represents a valid message

identifier.

For example, ? SQL30081 displays help about the

SQL30081 message.

To view message help one screen at a time, enter:

? XXXnnnnn | more

To save message help in a file, enter:

? XXXnnnnn > filename.ext

where filename.ext represents the file where you

want to save the message help.

Appendix B. Using the DB2 Library 549

Type of Help Contents How to Access...
SQL Help Explains the syntax of SQL From the command line processor in interactive
statements. mode, enter:
help statement

where statement represents an SQL statement.

For example, help SELECT displays help about the

SELECT statement.
Note: SQL help is not available on UNIX-based
platforms.
SQLSTATE Help Explains SQL states and From the command line processor in interactive
class codes. mode, enter:
? sqlstate or ? class code

where sqlstate represents a valid five-digit SQL

state and class code represents the first two digits
of the SQL state.

For example, ? 08003 displays help for the 08003

SQL state, while ? 08 displays help for the 08 class
code.

Viewing Information Online

The books included with this product are in Hypertext Markup Language
(HTML) softcopy format. Softcopy format enables you to search or browse the
information and provides hypertext links to related information. It also makes
it easier to share the library across your site.

You can view the online books or sample programs with any browser that
conforms to HTML Version 3.2 specifications.

To view online books or sample programs:

v If you are running DB2 administration tools, use the Information Center.
v From a browser, click File —>Open Page. The page you open contains
descriptions of and links to DB2 information:
– On UNIX-based platforms, open the following page:
INSTHOME/sqllib/doc/%L/html/index.htm

where %L represents the locale name.

– On other platforms, open the following page:
sqllib\doc\html\index.htm

The path is located on the drive where DB2 is installed.

550 Message Reference, Volume 2

 If you have not installed the Information Center, you can open the page
by double-clicking the DB2 Information icon. Depending on the system
you are using, the icon is in the main product folder or the Windows
Start menu.

Installing the Netscape Browser

If you do not already have a Web browser installed, you can install Netscape
from the Netscape CD-ROM found in the product boxes. For detailed
instructions on how to install it, perform the following:
1. Insert the Netscape CD-ROM.
2. On UNIX-based platforms only, mount the CD-ROM. Refer to your Quick
Beginnings book for the mounting procedures.
3. For installation instructions, refer to the CDNAVnn.txt file, where nn
represents your two character language identifier. The file is located at the
root directory of the CD-ROM.

Accessing Information with the Information Center

The Information Center provides quick access to DB2 product information.
The Information Center is available on all platforms on which the DB2
administration tools are available.

You can open the Information Center by double-clicking the Information

Center icon. Depending on the system you are using, the icon is in the
Information folder in the main product folder or the Windows Start menu.

You can also access the Information Center by using the toolbar and the Help
menu on the DB2 Windows platform.

The Information Center provides six types of information. Click the

appropriate tab to look at the topics provided for that type.
Tasks Key tasks you can perform using DB2.
Reference DB2 reference information, such as keywords, commands, and
APIs.
Books DB2 books.
Troubleshooting
Categories of error messages and their recovery actions.
Sample Programs
Sample programs that come with the DB2 Application
Development Client. If you did not install the DB2
Application Development Client, this tab is not displayed.
Web DB2 information on the World Wide Web. To access this
information, you must have a connection to the Web from
your system.

Appendix B. Using the DB2 Library 551

 When you select an item in one of the lists, the Information Center launches a
viewer to display the information. The viewer might be the system help
viewer, an editor, or a Web browser, depending on the kind of information
you select.

The Information Center provides a find feature, so you can look for a specific
topic without browsing the lists.

For a full text search, follow the hypertext link in the Information Center to
the Search DB2 Online Information search form.

The HTML search server is usually started automatically. If a search in the

HTML information does not work, you may have to start the search server
using one of the following methods:
On Windows
Click Start and select Programs —> IBM DB2 —> Information —>
Start HTML Search Server.
On OS/2
Double-click the DB2 for OS/2 folder, and then double-click the Start
HTML Search Server icon.

Refer to the release notes if you experience any other problems when
searching the HTML information.

Note: The Search function is not available in the Linux, PTX, and Silicon
Graphics IRIX environments.
Using DB2 Wizards
Wizards help you complete specific administration tasks by taking you
through each task one step at a time. Wizards are available through the
Control Center and the Client Configuration Assistant. The following table
lists the wizards and describes their purpose.

Note: The Create Database, Create Index, Configure Multisite Update, and
Performance Configuration wizards are available for the partitioned
database environment.

Wizard Helps You to... How to Access...

Add Database Catalog a database on a client workstation. From the Client Configuration
Assistant, click Add.
Backup Database Determine, create, and schedule a backup From the Control Center, right-click
plan. the database you want to back up
and select Backup —> Database
Using Wizard.

552 Message Reference, Volume 2

Wizard Helps You to... How to Access...
Configure Multisite Configure a multisite update, a distributed From the Control Center, right-click
Update transaction, or a two-phase commit. the Databases folder and select
Multisite Update.
Create Database Create a database, and perform some basic From the Control Center, right-click
configuration tasks. the Databases folder and select
Create —> Database Using
Wizard.
Create Table Select basic data types, and create a primary From the Control Center, right-click
key for the table. the Tables icon and select Create
—> Table Using Wizard.
Create Table Space Create a new table space. From the Control Center, right-click
the Table Spaces icon and select
Create —> Table Space Using
Wizard.
Create Index Advise which indexes to create and drop for From the Control Center, right-click
all your queries. the Index icon and select Create
—> Index Using Wizard.
Performance Tune the performance of a database by From the Control Center, right-click
Configuration updating configuration parameters to match the database you want to tune and
your business requirements. select Configure Performance
Using Wizard.

For the partitioned database

environment, from the Database
Partitions view, right-click the first
database partition you want to
tune and select Configure
Performance Using Wizard.
Restore Database Recover a database after a failure. It helps From the Control Center, right-click
you understand which backup to use, and the database you want to restore
which logs to replay. and select Restore —> Database
Using Wizard.

Setting Up a Document Server

By default, the DB2 information is installed on your local system. This means
that each person who needs access to the DB2 information must install the
same files. To have the DB2 information stored in a single location, perform
the following steps:
1. Copy all files and subdirectories from \sqllib\doc\html on your local
system to a Web server. Each book has its own subdirectory that contains
all the necessary HTML and GIF files that make up the book. Ensure that
the directory structure remains the same.

Appendix B. Using the DB2 Library 553

 2. Configure the Web server to look for the files in the new location. For
information, refer to the NetQuestion Appendix in the Installation and
Configuration Supplement.
3. If you are using the Java version of the Information Center, you can
specify a base URL for all HTML files. You should use the URL for the list
of books.
4. When you are able to view the book files, you can bookmark commonly
viewed topics. You will probably want to bookmark the following pages:
v List of books
v Tables of contents of frequently used books
v Frequently referenced articles, such as the ALTER TABLE topic
v The Search form

For information about how you can serve the DB2 Universal Database online
documentation files from a central machine, refer to the NetQuestion
Appendix in the Installation and Configuration Supplement.
Searching Information Online
To find information in the HTML files, use one of the following methods:
v Click Search in the top frame. Use the search form to find a specific topic.
This function is not available in the Linux, PTX, or Silicon Graphics IRIX
environments.
v Click Index in the top frame. Use the index to find a specific topic in the
book.
v Display the table of contents or index of the help or the HTML book, and
then use the find function of the Web browser to find a specific topic in the
book.
v Use the bookmark function of the Web browser to quickly return to a
specific topic.
v Use the search function of the Information Center to find specific topics. See
“Accessing Information with the Information Center” on page 551 for
details.

554 Message Reference, Volume 2

Appendix C. Notices
IBM may not offer the products, services, or features discussed in this
document in all countries. Consult your local IBM representative for
information on the products and services currently available in your area. Any
reference to an IBM product, program, or service is not intended to state or
imply that only that IBM product, program, or service may be used. Any
functionally equivalent product, program, or service that does not infringe
any IBM intellectual property right may be used instead. However, it is the
user’s responsibility to evaluate and verify the operation of any non-IBM
product, program, or service.

IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not give
you any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the

IBM Intellectual Property Department in your country or send inquiries, in
writing, to:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

The following paragraph does not apply to the United Kingdom or any
other country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY
OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow
disclaimer of express or implied warranties in certain transactions, therefore,
this statement may not apply to you.

This information could include technical inaccuracies or typographical errors.

Changes are periodically made to the information herein; these changes will
be incorporated in new editions of the publication. IBM may make

© Copyright IBM Corp. 1993, 2000 555

 improvements and/or changes in the product(s) and/or the program(s)
described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those
Web sites. The materials at those Web sites are not part of the materials for
this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the
purpose of enabling: (i) the exchange of information between independently
created programs and other programs (including this one) and (ii) the mutual
use of the information which has been exchanged, should contact:
IBM Canada Limited
Office of the Lab Director
1150 Eglinton Ave. East
North York, Ontario
M3C 1H7
CANADA

Such information may be available, subject to appropriate terms and

conditions, including in some cases, payment of a fee.

The licensed program described in this information and all licensed material
available for it are provided by IBM under terms of the IBM Customer
Agreement, IBM International Program License Agreement, or any equivalent
agreement between us.

Any performance data contained herein was determined in a controlled

environment. Therefore, the results obtained in other operating environments
may vary significantly. Some measurements may have been made on
development-level systems and there is no guarantee that these measurements
will be the same on generally available systems. Furthermore, some
measurements may have been estimated through extrapolation. Actual results
may vary. Users of this document should verify the applicable data for their
specific environment.

Information concerning non-IBM products was obtained from the suppliers of

those products, their published announcements or other publicly available
sources. IBM has not tested those products and cannot confirm the accuracy
of performance, compatibility or any other claims related to non-IBM
products. Questions on the capabilities of non-IBM products should be
addressed to the suppliers of those products.

556 Message Reference, Volume 2

All statements regarding IBM’s future direction or intent are subject to change
or withdrawal without notice, and represent goals and objectives only.

This information may contain examples of data and reports used in daily
business operations. To illustrate them as completely as possible, the examples
include the names of individuals, companies, brands, and products. All of
these names are fictitious and any similarity to the names and addresses used
by an actual business enterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information may contain sample application programs in source

language, which illustrates programming techniques on various operating
platforms. You may copy, modify, and distribute these sample programs in
any form without payment to IBM, for the purposes of developing, using,
marketing or distributing application programs conforming to the application
programming interface for the operating platform for which the sample
programs are written. These examples have not been thoroughly tested under
all conditions. IBM, therefore, cannot guarantee or imply reliability,
serviceability, or function of these programs.

Each copy or any portion of these sample programs or any derivative work
must include a copyright notice as follows:

© (your company name) (year). Portions of this code are derived from IBM
Corp. Sample Programs. © Copyright IBM Corp. _enter the year or years_. All
rights reserved.

Appendix C. Notices 557

Trademarks
The following terms, which may be denoted by an asterisk(*), are trademarks
of International Business Machines Corporation in the United States, other
countries, or both.

ACF/VTAM IBM
AISPO IMS
AIX IMS/ESA
AIX/6000 LAN DistanceMVS
AIXwindows MVS/ESA
AnyNet MVS/XA
APPN Net.Data
AS/400 OS/2
BookManager OS/390
CICS OS/400
C Set++ PowerPC
C/370 QBIC
DATABASE 2 QMF
DataHub RACF
DataJoiner RISC System/6000
DataPropagator RS/6000
DataRefresher S/370
DB2 SP
DB2 Connect SQL/DS
DB2 Extenders SQL/400
DB2 OLAP Server System/370
DB2 Universal Database System/390
Distributed Relational SystemView
Database Architecture VisualAge
DRDA VM/ESA
eNetwork VSE/ESA
Extended Services VTAM
FFST WebExplorer
First Failure Support Technology WIN-OS/2

The following terms are trademarks or registered trademarks of other

companies:

Microsoft, Windows, and Windows NT are trademarks or registered

trademarks of Microsoft Corporation.

Java or all Java-based trademarks and logos, and Solaris are trademarks of
Sun Microsystems, Inc. in the United States, other countries, or both.

Tivoli and NetView are trademarks of Tivoli Systems Inc. in the United States,
other countries, or both.

558 Message Reference, Volume 2

UNIX is a registered trademark in the United States, other countries or both
and is licensed exclusively through X/Open Company Limited.

Other company, product, or service names, which may be denoted by a

double asterisk(**) may be trademarks or service marks of others.

Appendix C. Notices 559

560 Message Reference, Volume 2
Index
late-breaking information 546 wizards (continued)
A backup database 552
accessing help 1 M completing tasks 552
add database wizard 552, 553 Messages 1 configure multisite update 552
AUD messages 3 AUD 3 create database 553
B DIA 3 create table 553
backup database wizard 552 GOV 3 create table space 553
books 537, 547 SQL 5 index 553
SQLSTATE 491 performance configuration 553
C messages, introduction 1 restore database 553
configure multisite update
wizard 552 N
create database wizard 553 Netscape browser
create table space wizard 553 installing 551
create table wizard 553
O
D online help 1, 548
DB2 library online information
books 537 searching 554
Information Center 551 viewing 550
language identifier for other message sources 3
books 545
late-breaking information 546 P
online help 548 PDF 546
ordering printed books 547 performance configuration
printing PDF books 546 wizard 553
searching online printing PDF books 546
information 554
setting up document server 553 R
structure of 537 release notes 546
viewing online information 550 restore wizard 553
wizards 552
DIA messages 3 S
sample programs
G cross-platform 545
GOV messages 3 HTML 545
H searching
Help 1 online information 552, 554
HTML setting up document server 553
sample programs 545 SmartGuides
wizards 552
I SQL messages 5
index wizard 553 SQLSTATE messages 491
Information Center 551
installing
V
Netscape browser 551 viewing
introduction to messages 1 online information 550

L W
language identifier wizards
books 545 add database 552, 553

© Copyright IBM Corp. 1993, 2000 561

562 Message Reference, Volume 2
Contacting IBM
If you have a technical problem, please review and carry out the actions
suggested by the Troubleshooting Guide before contacting DB2 Customer
Support. This guide suggests information that you can gather to help DB2
Customer Support to serve you better.

For information or to order any of the DB2 Universal Database products

contact an IBM representative at a local branch office or contact any
authorized IBM software remarketer.

If you live in the U.S.A., then you can call one of the following numbers:
v 1-800-237-5511 for customer support
v 1-888-426-4343 to learn about available service options

Product Information
If you live in the U.S.A., then you can call one of the following numbers:
v 1-800-IBM-CALL (1-800-426-2255) or 1-800-3IBM-OS2 (1-800-342-6672) to
order products or get general information.
v 1-800-879-2755 to order publications.
http://www.ibm.com/software/data/
The DB2 World Wide Web pages provide current DB2 information
about news, product descriptions, education schedules, and more.
http://www.ibm.com/software/data/db2/library/
The DB2 Product and Service Technical Library provides access to
frequently asked questions, fixes, books, and up-to-date DB2 technical
information.

Note: This information may be in English only.

http://www.elink.ibmlink.ibm.com/pbl/pbl/
The International Publications ordering Web site provides information
on how to order books.
http://www.ibm.com/education/certify/
The Professional Certification Program from the IBM Web site
provides certification test information for a variety of IBM products,
including DB2.

© Copyright IBM Corp. 1993, 2000 563

 ftp.software.ibm.com
Log on as anonymous. In the directory /ps/products/db2, you can
find demos, fixes, information, and tools relating to DB2 and many
other products.
comp.databases.ibm-db2, bit.listserv.db2-l
These Internet newsgroups are available for users to discuss their
experiences with DB2 products.
On Compuserve: GO IBMDB2
Enter this command to access the IBM DB2 Family forums. All DB2
products are supported through these forums.

For information on how to contact IBM outside of the United States, refer to
Appendix A of the IBM Software Support Handbook. To access this document,
go to the following Web page: http://www.ibm.com/support/, and then
select the IBM Software Support Handbook link near the bottom of the page.

Note: In some countries, IBM-authorized dealers should contact their dealer

support structure instead of the IBM Support Center.

564 Message Reference, Volume 2




Printed in the United States of America

on recycled paper containing 10%
recovered post-consumer fiber.

GC09-2979-00