ERserver. iseries. DB2 UDB for iseries SQLCODEs and SQLSTATEs

Transcription

1 ERserer iseries DB2 UDB for iseries SQLCODEs and SQLSTATEs

2

3 ERserer iseries DB2 UDB for iseries SQLCODEs and SQLSTATEs

4 Copyright International Business Machines Corporation 1998, All rights resered. US Goernment Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

5 Contents Chapter 1. DB2 Uniersal Database TM for iseries SQL Messages and Codes... 1 SQLCODEs and SQLSTATEs SQLCODEs SQLSTATEs SQL State Class Codes Chapter 2. DB2 Uniersal Database for iseries SQL Messages and Codes... 5 SQLSTATE Classes and Codes Chapter 3. DB2 Uniersal Database for iseries SQL Messages and Codes SQL Messages Reference Using Display Message Description (DSPMSGD) to display a message description Using the online reference to display message descriptions Copyright IBM Corp. 1998, 2002 iii

6 i iseries: DB2 UDB for iseries SQLCODEs and SQLSTATEs

7 Chapter 1. DB2 Uniersal Database TM for iseries SQL Messages and Codes SQLCODEs and SQLSTATEs SQL returns error codes to the application program when an error occurs. This reference lists SQLCODEs and their associated SQLSTATEs. To find a specific Message ID, SQLCODE, or SQLSTATE, use the SQL message finder. SQLCODEs and SQLSTATEs are returned in the SQLCA structure. SQLSTATE is an additional return code that proides application programs with common return codes for common error conditions found among the IBM TM relational database systems. SQLSTATEs are particularly useful when handling errors in distributed SQL applications. If SQL encounters an error while processing the statement, the first characters of the SQLSTATE are not 00, 01, or 02, and the SQLCODE is a negatie number. If SQL encounters a warning but alid condition while processing your statement, the SQLCODE is a positie number and bytes one and two of the SQLSTATE are 01. If your SQL statement is processed without encountering an error or warning condition, the SQLCODE returned is 0 and the SQLSTATE is SQLCODEs Each SQLCODE that is recognized on IBM iseries has a corresponding message in the message file QSQLMSG. Directions for finding a SQLCODE in the message file along with the text for these messages are aailable at Chapter 3, DB2 Uniersal Database for iseries SQL Messages and Codes, on page 23. The message identifier for any SQLCODE is constructed by appending the absolute alue (5 digits) of the SQLCODE to SQ and changing the third character to L if the third character is 0. For example, if the SQLCODE is 30070, the message identifier is SQ If the SQLCODE is -0204, the message identifier is SQL0204. When running in debug mode, SQL places a message corresponding to the SQLCODE in the job log for each SQL statement run. If you are not running in debug mode and get a negatie SQLCODE, you will get a message in the job log also. An application can also send the SQL message corresponding to any SQLCODE to the job log by specifying the message ID and the replacement text on the CL commands Retriee Message (RTVMSG), Send Program Message (SNDPGMMSG), and Send User Message (SNDUSRMSG). SQLSTATEs For a list of SQLSTATEs that are used by the DB2 family of products, see DB2 Product Family. When an SQLSTATE other than is returned from a non-db2 UDB for iseries application serer, DB2 UDB for iseries attempts to map the SQLSTATE to a DB2 UDB for iseries SQLCODE and message: Copyright IBM Corp. 1998,

8 If the SQLSTATE is not recognized by DB2 UDB for iseries, the common message for the class is issued. If the SQLSTATE and SQLCODE correspond to a single DB2 UDB for iseries SQLCODE, DB2 UDB attempts to conert the tokens returned in SQLERRM to the replacement data expected by the SQL message. If an error occurs while conerting the tokens: The SQLCA is not changed. A common message for the class code of the SQLSTATE is issued. SQL State Class Codes The table below proides a list of general SQLSTATE classes. Each class links to a list of the more specific SQLSTATE codes that comprise that class. Table 1. SQLSTATE Class Codes Class Code Meaning For subcodes, refer to Unqualified Successful Completion Table 1 (See Table 2 on page 5) 01 Warning Table 2 (See Table 3 on page 5) 02 No Data Table 3 (See Table 4 on page 7) 07 Dynamic SQL Error Table 4 (See Table 5 on page 7) 08 Connection Exception Table 5 (See Table 6 on page 7) 09 Triggered Action Exception Table 6 (See Table 7 on page 8) 0A Feature Not Supported Table 7 (See Table 8 on page 8) 0E Inalid Schema Name List Specification Table 8 (See Table 9 on page 8) 0F Inalid Token Table 9 (See Table 10 on page 8) 0K Resignal When Handler Not Actie Table 10 (See Table 11 on page 8) 20 Case Not Found for Case Statement Table 11 (See Table 12 on page 8) 21 Cardinality Violation Table 12 (See Table 13 on page 8) 22 Data Exception Table 13 (See Table 14 on page 9) 23 Constraint Violation Table 14 (See Table 15 on page 9) 24 Inalid Cursor State Table 15 (See Table 16 on page 10) 25 Inalid Transaction State Table 16 (See Table 17 on page 10) 26 Inalid SQL Statement Identifier Table 17 (See Table 18 on page 10) 27 Triggered Data Change Violation Table 18 (See Table 19 on page 11) 28 Inalid Authorization Specification Table 19 (See Table 20 on page 11) 2D Inalid Transaction Termination Table 20 (See Table 21 on page 11) 2E Inalid Connection Name Table 21 (See Table 22 on page 11) 2F SQL Function Exception Table 22 (See Table 23 on page 11) 34 Inalid Cursor Name Table 23 (See Table 24 on page 11) 38 External Function Exception Table 24 (See Table 25 on page 11) 39 External Function Call Exception Table 25 (See Table 26 on page 12) 3B Saepoint Exception Table 26 (See Table 27 on page 12) 3C Ambiguous Cursor Name Table 27 (See Table 28 on page 12) 42 Syntax Error or Access Rule Violation Table 28 (See Table 29 on page 12) 44 WITH CHECK OPTION Violation Table 29 (See Table 30 on page 19) 2 iseries: DB2 UDB for iseries SQLCODEs and SQLSTATEs

9 Table 1. SQLSTATE Class Codes (continued) Class Code Meaning For subcodes, refer to Jaa TM Errors Table 30 (See Table 31 on page 19) 51 Inalid Application State Table 31 (See Table 32 on page 19) 54 SQL or Product Limit Exceeded Table 32 (See Table 33 on page 20) 55 Object Not in Prerequisite State Table 33 (See Table 34 on page 20) 56 Miscellaneous SQL or Product Error Table 34 (See Table 35 on page 21) 57 Resource Not Aailable or Operator Interention Table 35 (See Table 36 on page 21) 58 System Error Table 36 (See Table 37 on page 21) Chapter 1. DB2 Uniersal Database TM for iseries SQL Messages and Codes 3

10 4 iseries: DB2 UDB for iseries SQLCODEs and SQLSTATEs

11 Chapter 2. DB2 Uniersal Database for iseries SQL Messages and Codes SQLSTATE Classes and Codes DB2 UDB for iseries returns SQLSTATE codes to the applications that access it through SQL. SQLSTATE codes indicate whether the database operation was successfully performed or whether DB2 returned warnings or errors to the application. SQLSTATEs can be associated with one or more SQLCODEs. The tables below proide descriptions of SQLSTATE codes that could be returned to applications by DB2 UDB for iseries. Table 2. Class Code 00: Unqualified Successful Completion SQLSTATE Value Meaning Execution of the SQL statement was successful and did not result in any type of warning or exception condition. SQLCODE Values +000 Table 3. Class Code 01: Warning SQLSTATE Value Meaning SQLCODE Values A DISCONNECT error occurred Null alues were eliminated from the argument of a column function The alue of a string was truncated when assigned to a host ariable. +000, +445, Insufficient number of entries in an SQLDA A priilege was not reoked A priilege was not granted A The query expression of the iew is too long for the information +178 schema. 0100C One or more ad hoc result sets were returned from the procedure D The cursor that was closed has been re-opened on the next result set +467 within the chain. 0100E The procedure returned too many result sets. +464, The number of result columns is larger than the number of host +000, +030 ariables proided The UPDATE or DELETE statement does not include a WHERE +000, +088 clause The statement was not executed because it is unacceptable in this +084 enironment An adjustment was made to a DATE or TIMESTAMP alue to correct +000 an inalid date resulting from an arithmetic operation The null alue has been assigned to a host ariable, because the non-null alue of the column is not within the range of the host ariable Copyright IBM Corp. 1998,

12 Table 3. Class Code 01: Warning (continued) SQLSTATE Value Meaning SQLCODE Values A character that could not be conerted was replaced with a +335 substitute character The null alue has been assigned to a host ariable, because a +802 numeric alue is out of range The null alue has been assigned to a host ariable, because the +331 characters cannot be conerted The local table or iew name used in the CREATE ALIAS statement +403 is undefined Isolation leel has been escalated WHERE NOT NULL is ignored, because the index key cannot contain +645 null alues An undefined object name was detected The string representation of a datetime alue is inalid. +180, An arithmetic operation on a date or timestamp has a result that is +183 not within the alid range of dates During remote bind where existence checking is deferred, the +114 serer-name specified does not match the current serer Connection is successful but only SBCS characters should be used Authorization ID does not hae the priilege to perform the +552 operation as specified The null alue has been assigned to a host ariable, because a substring error occurred; for example, an argument of SUBSTR is out of range An unqualified column name has been interpreted as a correlated +012 reference A mixed data alue is improperly formed. +191, +304, The authorization ID does not hae the priilege to perform the +551 specified operation on the identified object Too many host ariables hae been specified on SELECT INTO or +326 FETCH The null alue has been assigned to a host ariable, because diision +802 by zero occurred The null alue has been assigned to a host ariable, because a miscellaneous data exception occurred; for example, the character alue for the CAST, DECIMAL, FLOAT, or INTEGER scalar function is inalid; a floating-point NAN (not a number) or inalid data in a packed decimal field was detected. +304, +420, The table was created but not journaled The unit of work was committed or rolled back, but the outcome is +990 not fully known at all sites An ALTER TABLE may cause data truncation Insufficient number of entries in an SQLDA for ALL information (i.e not enough descriptors to return the distinct name) The DATALINK alue may not be alid because the table is in reconcile pending or reconcile is not a possible state iseries: DB2 UDB for iseries SQLCODEs and SQLSTATEs

13 Table 3. Class Code 01: Warning (continued) SQLSTATE Value Meaning SQLCODE Values The external program could not be updated with the associated procedure or function attributes The distinct data type name is too long and cannot be returned in the SQLDA. The short name is returned instead. of queries Assignment to SQLCODE or SQLSTATE ariable does not signal a +385 warning or error A result sets could not be returned because the cursor was closed A DB2SQL BEFORE trigger changed to DB2ROW Hxx Valid warning SQLSTATEs returned by a user-defined function or external procedure CALL Table 4. Class Code 02: No Data SQLSTATE Value Meaning One of the following exceptions occurred: The result of the SELECT INTO statement or the subselect of the INSERT statement was an empty table. The number of rows identified in the searched UPDATE or DELETE statement was zero. The position of the cursor referenced in the FETCH statement was after the last row of the result table. The fetch orientation is inalid No additional result sets returned SQLCODE Values +100 Table 5. Class Code 07: Dynamic SQL Error SQLSTATE Value Meaning SQLCODE Values The number of host ariables is not the same as the number of parameter -313 markers The call parameter list or control block is inalid The statement identified in the EXECUTE statement is a select-statement, or is -518 not in a prepared state The USING clause is required for dynamic parameters The statement name of the cursor identifies a prepared statement that cannot -517 be associated with a cursor An input host ariable, transition ariable, or parameter marker cannot be used, because of its data type Table 6. Class Code 08: Connection Exception SQLSTATE Value Meaning SQLCODE Values The application requester is unable to establish the connection , , The connection already exists The connection does not exist. -843, -900 Chapter 2. DB2 Uniersal Database for iseries SQL Messages and Codes 7

14 Table 6. Class Code 08: Connection Exception (continued) SQLSTATE Value Meaning SQLCODE Values The application serer rejected establishment of the connection , A DISCONNECT is not allowed when the connection uses an LU6.2 protected conersation Table 7. Class Code 09: Triggered Action Exception SQLSTATE Value Meaning SQLCODE Values A triggered SQL statement failed Table 8. Class Code 0A: Feature Not Supported SQLSTATE Value Meaning 0A001 The CONNECT statement is inalid, because the process is not in the connectable state. SQLCODE Values -752 Table 9. Class Code 0E: Inalid Schema Name List Specification SQLSTATE Value Meaning SQLCODE Values 0E000 The schema name list in a SET PATH statement is not alid Table 10. Class Code 0F: Inalid Token SQLSTATE Value Meaning SQLCODE Values 0F001 The locator alue does not currently represent any alue Table 11. Class Code 0K: Resignal When Handler Not Actie SQLSTATE Value Meaning SQLCODE Values 0K000 A RESIGNAL was issued but a handler is not actie Table 12. Class Code 20: Case Not Found for Case Statement SQLSTATE Value Meaning SQLCODE Values The case was not found for the CASE statement Table 13. Class Code 21: Cardinality Violation SQLSTATE Value Meaning 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 alue. SQLCODE Values iseries: DB2 UDB for iseries SQLCODEs and SQLSTATEs

15 Table 14. Class Code 22: Data Exception SQLSTATE Value Meaning Character data, right truncation occurred; for example, an update or insert alue is a string that is too long for the column, or a datetime alue cannot be assigned to a host ariable, because it is too small A null alue, or the absence of an indicator parameter was detected; for example, the null alue cannot be assigned to a host ariable, because no indicator ariable is specified. SQLCODE Values -302, -303, -404, A numeric alue is out of range. -302, -304, -406, -446, A null alue cannot returned from a procedure that is defined as PARAMETER STYLE GENERAL or a type-presering method that is inoked with a non-null argument The fetch orientation is inalid An inalid datetime format was detected; that is, an inalid string -180, -181 representation or alue was specified Datetime field oerflow occurred; for example, an arithmetic operation on a -183 date or timestamp has a result that is not within the alid range of dates A substring error occurred; for example, an argument of SUBSTR is out of -138 range Diision by zero is inalid The character alue for the CAST, DECIMAL, FLOAT, or INTEGER scalar -420 function is inalid The LIKE predicate has an inalid escape character A character is not in the coded character set. -330, A parameter or host ariable alue is inalid. -302, -304, -406, A NUL-terminated input host ariable or parameter did not contain a NUL The LIKE predicate string pattern contains an inalid occurrence of an escape -130 character The length control field of a ariable length string is negatie or greater than -311 the maximum The string representation of a name is inalid A mixed data alue is inalid. -191, -304, -406, The alue for a ROWID or reference column is not alid A CCSID alue is not alid at all, not alid for the data type or subtype, or not -189 alid for the encoding scheme Character conersion resulted in truncation Table 15. Class Code 23: Constraint Violation SQLSTATE Value Meaning SQLCODE Values The update or delete of a parent key is preented by a RESTRICT update or -531, -532 delete rule An insert or update alue is null, but the column cannot contain null alues The insert or update alue of a foreign key is inalid Chapter 2. DB2 Uniersal Database for iseries SQL Messages and Codes 9

16 Table 15. Class Code 23: Constraint Violation (continued) SQLSTATE Value Meaning SQLCODE Values The update or delete of a parent key is preented by a NO ACTION update or -531, -532 delete rule A iolation of the constraint imposed by a unique index or a unique constraint -803 occurred A parent row cannot be deleted, because the check constraint restricts the -543 deletion The check constraint cannot be added, because the table contains rows that do -544 not satisfy the constraint definition The resulting row of the INSERT or UPDATE does not conform to the check -545 constraint definition The unique index could not be created or unique constraint added, because the -603 table contains duplicate alues of the specified key The range of alues for the identity column or sequence is exhausted The foreign key cannot be defined, because all of its alues are not equal to a parent key of the parent table Table 16. Class Code 24: Inalid Cursor State SQLSTATE Value Meaning SQLCODE Values The identified cursor is not open. -501, The cursor identified in an OPEN statement is already open The cursor identified in the UPDATE, DELETE, SET, or GET statement is not -508 positioned on a row The statement identified in the PREPARE is the statement of an open cursor FETCH CURRENT was specified, but the current row is deleted, or a alue of -226 an ORDER BY column of the current row has changed FETCH NEXT, PRIOR, CURRENT, or RELATIVE is not allowed, because the -227 cursor position is not known A preious error has disabled this cursor Table 17. Class Code 25: Inalid Transaction State SQLSTATE Value Meaning SQLCODE Values An update operation is inalid for the application execution enironment Update operation not allowed The statement is only allowed as the first statement in a unit of work Table 18. Class Code 26: Inalid SQL Statement Identifier SQLSTATE Value Meaning SQLCODE Values The statement identified does not exist. -514, The statement name specified in a DECLARE CURSOR already has a cursor allocated to it iseries: DB2 UDB for iseries SQLCODEs and SQLSTATEs

17 Table 19. Class Code 27: Triggered Data Change Violation SQLSTATE Value Meaning An attempt was made to change the same row in the same table more than once in the same SQL statement. SQLCODE Values -907 Table 20. Class Code 28: Inalid Authorization Specification SQLSTATE Value Meaning SQLCODE Values Authorization name is inalid. -113, -188 Table 21. Class Code 2D: Inalid Transaction Termination SQLSTATE Value Meaning SQLCODE Values 2D522 COMMIT and ROLLBACK are not allowed in an ATOMIC Compound -774 statement. 2D528 Dynamic COMMIT or COMMIT ON RETURN procedure is inalid for the , -426 application execution enironment 2D529 Dynamic ROLLBACK is inalid for the application execution enironment , -427 Table 22. Class Code 2E: Inalid Connection Name SQLSTATE Value Meaning SQLCODE Values 2E000 Connection name is inalid. -113, -188, -251 Table 23. Class Code 2F: SQL Function Exception SQLSTATE Value Meaning SQLCODE Values 2F002 The external function attempted to modify data, but the function was not -577 defined as MODIFIES SQL DATA. 2F003 The statement is not allowed in a function or procedure F004 The external function attempted to read data, but the function was not defined -579 as READS SQL DATA. 2F005 The function did not execute a RETURN statement Table 24. Class Code 34: Inalid Cursor Name SQLSTATE Value Meaning SQLCODE Values Cursor name is inalid Table 25. Class Code 38: External Function Exception SQLSTATE Value Meaning SQLCODE Values 38xxx Valid error SQLSTATEs returned by a user-defined function, external -443 procedure, or trigger The external routine is not allowed to execute SQL statements Chapter 2. DB2 Uniersal Database for iseries SQL Messages and Codes 11

18 Table 25. Class Code 38: External Function Exception (continued) SQLSTATE Value Meaning SQLCODE Values The external routine attempted to modify data, but the routine was not defined -577 as MODIFIES SQL DATA The statement is not allowed in a routine The external routine attempted to read data, but the routine was not defined as -579 READS SQL DATA Error occurred while calling a user-defined function, external procedure, or trigger (using the SIMPLE CALL or SIMPLE CALL WITH NULLS calling conention). -443, Table 26. Class Code 39: External Function Call Exception SQLSTATE Value Meaning SQLCODE Values A user-defined function has returned an inalid SQLSTATE A null alue is not allowed for an IN or INOUT argument when using PARAMETER STYLE GENERAL. -470, Table 27. Class Code 3B: Saepoint Exception SQLSTATE Value Meaning SQLCODE Values 3B001 The saepoint is not alid B002 The maximum number of saepoints has been reached B501 A duplicate saepoint name was detected B502 A RELEASE or ROLLBACK TO SAVEPOINT was specified, but a saepoint does not exist Table 28. Class Code 3C: Ambiguous Cursor Name SQLSTATE Value Meaning SQLCODE Values 3C000 The cursor name is ambiguous Table 29. Class Code 42: Syntax Error or Access Rule Violation SQLSTATE Value Meaning SQLCODE Values The authorization ID does not hae the priilege to perform the specified -551 operation on the identified object The authorization ID does not hae the priilege to perform the -552 operation as specified Owner authorization failure occurred A character, token, or clause is inalid or missing. -007, -029, -097, -104, -109, -115, -128, -199, -441, A character that is inalid in a name has been detected. -113, An unterminated string constant has been detected An inalid numeric or string constant has been detected. -103, iseries: DB2 UDB for iseries SQLCODEs and SQLSTATEs

19 Table 29. Class Code 42: Syntax Error or Access Rule Violation (continued) SQLSTATE Value Meaning SQLCODE Values The number of arguments specified for a scalar function is inalid An inalid hexadecimal constant has been detected An operand of a column function is inalid All operands of an operator or predicate are parameter markers A parameter marker is not allowed. -184, The column or argument definition is inalid. -106, The statement string is an SQL statement that is not acceptable in the -084 context in which it is presented Clauses are mutually exclusie A duplicate keyword is inalid Inalid options are specified The statement string is blank or empty A host ariable is not allowed. -090, -312, -5012, Read-only SCROLL was specified with the UPDATE clause The check constraint or generated column expression is inalid A name or label is too long A DEFAULT clause cannot be specified A CASE expression is inalid Parameter names must be specified for SQL routines An expression must be specified on a RETURN statement in an SQL -057 function A duplicate column name in an INSERT or UPDATE statement was -121 detected A column reference is ambiguous, because of duplicate names An undefined column or parameter name was detected. -205, -206, -213, -378, -379, An undefined object or constraint name was detected An undefined serer-name was detected A column name in ORDER BY does not identify a column of the result -208 table A duplicate column name in a PRIMARY, UNIQUE, or FOREIGN KEY -537 clause was detected A duplicate object or constraint name was detected. -456, A duplicate column name was detected in the object definition or ALTER -612 TABLE statement A duplicate table designator was detected in the FROM clause. or -212 REFERENCING clause of a CREATE TRIGGER statement The local serer name is not defined A function with the same signature already exists in the schema Unable to access an external program used for a user-defined function or a procedure. -444, -4300, -4303, -4304, Chapter 2. DB2 Uniersal Database for iseries SQL Messages and Codes 13

20 Table 29. Class Code 42: Syntax Error or Access Rule Violation (continued) SQLSTATE Value Meaning SQLCODE Values A routine was referenced directly (not by either signature or by specific instance name), but there is more than one specific instance of that routine Duplicate names for common table expressions were detected A duplicate schema name in the SET CURRENT PATH statement was -585 detected A procedure with the specified name cannot be added to the schema because the procedure oerloading is not allowed in this database and there is already a procedure with the same name in the schema A duplicate parameter-name was detected The label specified on the GOTO, ITERATE, or LEAVE statement is not -779 found or not alid The condition specified in the handler is not defined A duplicate column name or unanmed column was specified in a -783 DECLARE CURSOR statement of a FOR statement The number of insert or update alues is not the same as the number of -117 columns A column reference in the SELECT or HAVING clause is inalid, because it is not a grouping column; or a column reference in the GROUP BY clause is inalid. -119, The result expressions in a CASE expression are not compatible An integer in the ORDER BY clause does not identify a column of the -125 result table A alue cannot be assigned to a host ariable, because the data types are -303 not compatible The INSERT, UPDATE, or DELETE is not permitted on this object. -150, A column identified in the INSERT or UPDATE statement is not -151 updateable The identified object is not the type of object to which the statement -152, -156, -159 applies A iew is identified in a FOREIGN KEY clause The number of columns specified is not the same as the number of -158 columns in the SELECT clause A library name is required in CREATE TABLE in the system naming mode WITH CHECK OPTION cannot be used for the specified iew The column cannot be dropped, because it is the only column in the -195 table The data type, length, scale, alue, or CCSID is inalid. -060, -171, -451, -713, -5005, A datetime alue or duration in an expression is inalid. -182, The column cannot be dropped, because RESTRICT was specified and a -196 iew or constraint is dependent on the column The operands of an operator or function are not compatible. -131, iseries: DB2 UDB for iseries SQLCODEs and SQLSTATEs

21 Table 29. Class Code 42: Syntax Error or Access Rule Violation (continued) SQLSTATE Value Meaning SQLCODE Values An operand of an arithmetic operation or an operand of a function that -402 requires a number is not a number A numeric constant is too long, or it has a alue that is not within the -405, -410 range of its data type A data type for an assignment to a column is not compatible with the -408 column data type An expression in the ORDER BY clause or GROUP BY clause is not -214 alid Multiple columns are returned from a subquery that only allows one -412 column An operand of LIKE is not a string, or the first operand is not a column. -132, The rows of UNION, INTERSECT, EXCEPT, or VALUES do not hae -415 compatible columns The rows of UNION, INTERSECT, EXCEPT, or VALUES do not hae the -421 same number of columns The table identified in the UPDATE or DELETE is not the same table -509 designated by the cursor The table designated by the cursor of the UPDATE or DELETE statement -510, -520 cannot be modified, or the cursor is read-only FOR UPDATE OF is inalid, because the result table designated by the -511 cursor cannot be modified The foreign key does not conform to the description of the parent key The operation is not allowed on system objects The qualified object name is inconsistent with the naming option SET NULL cannot be specified, because the foreign key does not allow -629 null alues Cyclic references cannot be specified between named deried tables The specification of a recursie, named deried table is inalid The column cannot be altered, because its attributes are not compatible -190 with the current column attributes A parameter marker can not be a user-defined type or reference type A column definition is inalid, because a specified option is inconsistent -683 with the column description An inalid use of a NOT DETERMINISTIC or EXTERNAL ACTION -583 function was detected Cast from source type to target type is not supported An OVRDBF command was issued for one of the referenced files, but one of the parameters is not alid for SQL Isolation leel CS WITH KEEP LOCKS is not allowed A logical file is inalid in CREATE VIEW A referenced file is not a table, iew, or physical file The priileges specified in GRANT or REVOKE are inalid or inconsistent. (For example, GRANT ALTER on a iew.) -557 Chapter 2. DB2 Uniersal Database for iseries SQL Messages and Codes 15

22 Table 29. Class Code 42: Syntax Error or Access Rule Violation (continued) SQLSTATE Value Meaning SQLCODE Values The assignment of the LOB to this host ariable is not allowed. The target host ariable for all fetches of this LOB alue for this cursor must be a locator or LOB ariable A referenced file has more than one format Operation cannot be applied to the specified object The CHECK constraint cannot be dropped because it is enforcing a -784 primary key to be not null An extended dynamic statement cannot be executed against a -827 non-extended dynamic package An undefined host ariable in REXX has been detected The data type in either the RETURNS clause or 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 FETCH statement clauses are incompatible with the cursor definition An inalid number of rows was specified in a multiple-row FETCH ALWCPYDTA(*NO) was specified, but a copy is necessary to implement -527 the select-statement The schema-name portion of a qualified name must be the same name as the schema name Different CCSIDs for keys in CREATE INDEX are only allowed with a *HEX sort sequence The column name cannot be qualified An inalid function or procedure name was used with the EXTERNAL -449 keyword 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 The CAST TO and CAST FROM data types are incompatible, or would -453 always result in truncation of a fixed string Inalid use of a function The specific instance name qualifier is not equal to the function name -455 qualifier No function was found with a matching signature No function or procedure was found with the specified name and -440 compatible arguments The number of input parameters specified on a CREATE FUNCTION statement does not match the number proided by the function named in the SOURCE clause The IN, OUT, or INOUT parameter attributes do not match The function is not alid in the context where it occurs The table does not hae a primary key The table already has a primary key iseries: DB2 UDB for iseries SQLCODEs and SQLSTATEs

23 Table 29. Class Code 42: Syntax Error or Access Rule Violation (continued) SQLSTATE Value Meaning SQLCODE Values A column list was specified in the references clause, but the identified parent table does not hae a unique constraint with the specified column names A duplicate UNIQUE constraint already exists The referential constraint and trigger are not allowed, because the -675 DELETE rule and trigger eent are not compatible The object or constraint cannot be dropped or authoritites cannot be -478, -616 reoked from the object, because other objects are dependent on it The DEFAULT alue is inalid For static SQL, an input host ariable cannot be used, because its data type is not compatible with the parameter of a procedure or user-defined function The ASP number is inalid An inalid correlated reference or transition table was detected in a -696 trigger Correlated references and column names are not allowed for triggered -697 actions with the FOR EACH STATEMENT clause. 428A1 Unable to access a file referenced by a file reference ariable B7 The number specified in an SQL statement is out of the alid range B8 The name specified on a rename is not alid C1 Only one ROWID or IDENTITY column can be specified for a table C7 A ROWID or reference column specification is not alid C9 A ROWID or IDENTITY column cannot be specified as the target column -798 of an INSERT or UPDATE. 428D1 Unable to access a file referenced by a DATALINK alue D2 AS LOCATOR cannot be specified for a non-lob parameter D4 A cursor specified in a FOR statement cannot be referenced in an OPEN, -776 CLOSE, or FETCH statement. 428D5 The ending label does not match the beginning label D6 UNDO is not allowed for NOT ATOMIC compound statements D7 The condition alue is not allowed D8 The sqlcode or sqlstate ariable declaration is not alid EK The qualifier for a declared global temporary table name or an index on -079 a declared global temporary table must be SESSION 428F1 An SQL TABLE function must return a table result F2 An integer expression must be specified on a RETURN statement in an -058 SQL procedure A WHERE, VALUES, GROUP BY, HAVING, or SET clause includes an -120 inalid reference, such as a column or OLAP function The SQL procedure was not created because of a compile error A column function in a subquery of a HAVING clause includes an -133 expression that applies an operator to a correlated reference The string is too long Chapter 2. DB2 Uniersal Database for iseries SQL Messages and Codes 17

24 Table 29. Class Code 42: Syntax Error or Access Rule Violation (continued) SQLSTATE Value Meaning SQLCODE Values The statement does not include a required column list CREATE VIEW includes an operator or operand that is not alid for -154 iews. For example, UNION or UNION ALL The statement is not allowed in an ATOMIC Compound statement A decimal diide operation is inalid, because the result would hae a -419 negatie scale A column cannot be updated, because it is not identified in the UPDATE -503 clause of the select-statement of the cursor The DELETE is inalid, because a table referenced in a subquery can be -536 affected by the operation The object cannot be explicitly dropped A user-defined data type cannot be created with a system-defined data -473 type name (for example, INTEGER) Nested compound statements are not allowed DROP SCHEMA cannot be executed under commitment control Program or package must be recreated to reference an alias-name An alias resoled to another alias rather than a table or iew at the -513 remote location Locators are not allowed with COMMIT(*NONE) The same column was identified in FOR UPDATE OF and ORDER BY The program preparation assumptions are incorrect The parameter must not hae a subtype of mixed The object cannot be created, because the specified identifier is resered -457, -707 for system use The authorization ID cannot be both an owner and primary group owner The serer name specified does not match the current serer A long column, LOB column, structured type column or datalink column -350 cannot be used in an index, a key, or a constraint The connection failed, because there is no current software license The package was not created and the current unit of work was rolled -917 back, because of internal limitations or an inalid section number COMMIT HOLD or ROLLBACK HOLD is not allowed to a non-sql application serer SQL statements cannot be executed under commitment control, because DFM is already actie under commitment control to another system An expression in a join-condition references columns in more than one of -338 the operand tables The authorization ID cannot be changed when connecting to the local serer An indicator ariable is not a small integer CREATE SCHEMA is not allowed if changes are pending in the unit of work iseries: DB2 UDB for iseries SQLCODEs and SQLSTATEs

25 Table 29. Class Code 42: Syntax Error or Access Rule Violation (continued) SQLSTATE Value Meaning SQLCODE Values The priilege cannot be granted to the iew, because *OBJOPR or *OBJMGT authority exists on a dependent iew or table, and the grantee does not hae *ALLOBJ or the specified priilege on the dependent table or iew The statement is not allowed in a routine. -577, -579, The statement is not allowed in a trigger A unique index or unique constraint is not allowed because the key -270 columns are not a superset of the partitioned key columns The requested function does not apply to global temporary tables The partition key cannot be a datatime or floating-point column A referential constraint is not allowed because the foreign key columns are not a superset of the partitioned key columns or the node group is not the same as the parent table B6 429B7 429BD Rows from a distributed table cannot be redistributed because the table contains a datalink column with FILE LINK CONTROL. A referential constraint with a delete rule of CASCADE is not allowed on a table with a DataLink column with FILE LINK CONTROL. RETURN must be the last SQL statement of the atomic compound statement within an SQL row or table function Table 30. Class Code 44: WITH CHECK OPTION Violation SQLSTATE Value Meaning The INSERT or UPDATE is not allowed, because a resulting row does not satisfy the iew definition. SQLCODE Values -161 Table 31. Class Code 46: Jaa Errors SQLSTATE Value Meaning SQLCODE Values The URL specified on an install or replace of a jar procedure did not identify a alid jar file The jar name specified on the install, replace, or remoe of a jaa procedure is not alid The jar file cannot be remoed, a class is in use by a procedure A Jaa function has a Jaa method with an inalid signature A Jaa function could not map to a single Jaa method The install or remoe jar procedure for <jar-id> specified the use of a deployment descriptor Table 32. Class Code 51: Inalid Application State SQLSTATE Value Meaning SQLCODE Values The package corresponding to an SQL statement execution request was not -805 found Consistency tokens do not match Chapter 2. DB2 Uniersal Database for iseries SQL Messages and Codes 19

26 Table 32. Class Code 51: Inalid Application State (continued) SQLSTATE Value Meaning SQLCODE Values An address in the SQLDA is inalid COMMIT or ROLLBACK is not allowed, because commitment control has not been started An attempt was made to execute a section that was found to be in error at -525 bind time SQL statements cannot be executed until the application process executes a -918 rollback operation An implicit connect to a remote serer is not allowed because a saepoint is outstanding The operation is not allowed because a trigger has been marked inoperatie Table 33. Class Code 54: SQL or Product Limit Exceeded SQLSTATE Value Meaning SQLCODE Values The statement is too long or too complex A string constant is too long The statement has too many table names or too many items in a SELECT or -129, -840 INSERT list The sort key is too long, or has too many columns The result of concatenation is too long The key is too long, a column of the key is too long, or the key many columns. -602, -613, -614, Too many users were specified in GRANT or REVOKE The record length of the table is too long Too many columns were specified for a table or iew. -101, The row is too long The maximum number of late descriptors has been exceeded, probably because -871 too many different CCSIDs were used Too many constraints, or the size of the constraint is too large The limit for the number of parameters or arguments for a function or a -442, -448 procedure has been exceeded The maximum number of concurrent LOB handles has been reached An internal object limit exceeded Maximum depth of nested functions, procedures, or triggers was exceeded A multiple-byte (UCS-2) sort sequence table cannot be supprted in DRDA TM because it is too large Table 34. Class Code 55: Object Not in Prerequisite State SQLSTATE Value Meaning SQLCODE Values Recursion is not supported to a non-sql400. application serer The object cannot be dropped, because it is currently in use by the same application process. -615, iseries: DB2 UDB for iseries SQLCODEs and SQLSTATEs

27 Table 34. Class Code 55: Object Not in Prerequisite State (continued) SQLSTATE Value Meaning SQLCODE Values The object cannot be altered, because it is currently in use by the same -951 application process The schema cannot be dropped, because it is in the library list The table is in an inalid state for the operation Local program attempted to connect to a remote database The alias is not allowed because it identifies a single member of a multiple member file An object cannot be created into a protected schema Table 35. Class Code 56: Miscellaneous SQL or Product Error SQLSTATE Value Meaning SQLCODE Values An unsupported SQLTYPE was encountered in a select-list or input-list. -351, A bind option is inalid Table 36. Class Code 57: Resource Not Aailable or Operator Interention SQLSTATE Value Meaning SQLCODE Values The statement cannot be executed, because a utility or a goernor time limit -666 was exceeded The object cannot be created, because a DROP or CREATE is pending The object cannot be used, because a DROP or ALTER is pending Virtual storage or database resource is not aailable. -904, -971, A non-database resource is not aailable. This will not affect the successful execution of subsequent statements A non-database resource is not aailable. This will affect the successful execution of subsequent statements Processing was canceled as requested Character conersion is not defined Deadlock or timeout occurred without automatic rollback DDM recursion has occurred A local SQL application program cannot be executed on an application serer The file serer is not currently aailable Table 37. Class Code 58: System Error SQLSTATE Value Meaning SQLCODE Values An inalid section number was detected A system error (that does not necessarily preclude the successful execution of subsequent SQL statements) occurred. SQLSTATE 58004, when combined with SQLCODE -4301, indicates this meaning for the failure: Jaa interpreter startup or communication failed. -901, Chapter 2. DB2 Uniersal Database for iseries SQL Messages and Codes 21

28 Table 37. Class Code 58: System Error (continued) SQLSTATE Value Meaning SQLCODE Values Execution failed due to a distribution protocol error that will not affect the successful execution of subsequent DDM commands or SQL statements Execution failed due to a distribution protocol error that caused deallocation of the conersation Execution failed due to a distribution protocol error that will affect the successful execution of subsequent DDM commands or SQL statements The DDM command is inalid while the bind process in progress The bind process with the specified package name and consistency token is not actie The DDM command is not supported The DDM object is not supported The DDM parameter is not supported The DDM parameter alue is not supported The DDM reply message is not supported The commit operation failed, because a resource in the unit of work was not -175 able to commit its resources An unexpected error occurred while attempting to access a client drier iseries: DB2 UDB for iseries SQLCODEs and SQLSTATEs

29 Chapter 3. DB2 Uniersal Database for iseries SQL Messages and Codes SQL Messages Reference Table 38. SQL0007 SQL Messages are displayed when a DB2 UDB for iseries returns an error or warning code to the application that uses it. The base message text is displayed or logged at runtime. To find a specific message, SQLCODE, or SQLSTATE, try the SQL Message Finder. Using Display Message Description (DSPMSGD) to display a message description Detailed descriptions of all DB2 UDB for iseries messages, including SQLCODEs, are aailable in message file QSQLMSG. You can display and print them from the Display Message Description display. The CL command to display the message description is DSPMSGD. This command shows you both the first leel and the second leel text for the message. The first leel is a short, single sentence ersion of the message. The second leel generally describes the reason in more detail and proides suggested solutions. To show the message that corresponds to SQLCODE 0204, type the following command: DSPMSGD RANGE(SQL0204) MSGF(QSYS/QSQLMSG) Using the online reference to display message descriptions You can use the reference below with both positie and negatie SQLCODEs. Take the absolute alue of the SQLCODE, then append it to the letters SQL (for SQLCODEs less than ) or the letters SQ (for SQLCODEs greater than or equal to ) to determine the message identifier. Each SQLCODE corresponds to one or more SQLSTATEs. Refer to Chapter 2, DB2 Uniersal Database for iseries SQL Messages and Codes, on page 5 for more information about SQLSTATEs. SQL0007 Character &1 (HEX &2) not alid in SQL statement. The character &1 specified in the SQL statement is not permitted. The hexadecimal representation for the character is &2. The character is ignored by the precompiler and processing of the statement continues. Recoery Text: Correct the character. The character may need to be enclosed either in quotation marks or apostrophes. Precompile the program again. SQLCODE or SQLCODEs: -007 SQLSTATE or SQLSTATEs: Table 39. SQL0010 SQL0010 String constant beginning &1 not delimited. Copyright IBM Corp. 1998,

30 Table 39. SQL0010 (continued) SQL0010 The string delimiter is missing in the constant beginning with &1. The string is treated as if it were delimited by the end of the source file. Recoery Text: Delimit the string constant. Check for any missing or extra quotation marks and apostrophes. These errors are likely to cause other errors. Some statements may not hae been processed as the result of either missing or extra string delimiters. Precompile the program again. SQLCODE or SQLCODEs: -010 SQLSTATE or SQLSTATEs: Table 40. SQL0012 SQL0012 Correlation without qualification occurred for column &1 to table &2. Column &1 which occurs in a subselect, is not explicitly qualified, and occurs in table &2 in library &3 specified in the FROM clause of an outer subselect or as the target of an update or delete operation. Consequently, the reference to the column in the subselect is an outer reference, and correlation will occur. Recoery Text: Ensure you intended to use the correlation. If you did not intend to use the correlation, the column does not exist in any of the tables or iews identified in the FROM clause of the same leel of the subselect that column &1 was referenced. Since it is a good practice to explicitly qualify any intended correlated references, it is recommended that the statement be changed so that the column &1 is qualified with a table designator. SQLCODE or SQLCODEs: +012 SQLSTATE or SQLSTATEs: Table 41. SQL0029 SQL0029 INTO clause missing from embedded statement. SELECT and VALUES INTO statements embedded in a program must hae an INTO clause to specify where the results of the statement are to be placed. A dynamic VALUES INTO statement must hae an INTO clause. Recoery Text: Add the INTO clause to the statement, and precompile the program again. SQLCODE or SQLCODEs: -029 SQLSTATE or SQLSTATEs: Table 42. SQL0030 SQL0030 Number of host ariables less than result alues. 24 iseries: DB2 UDB for iseries SQLCODEs and SQLSTATEs