DB2 UDB Messages and Codes For OS-390 & Z-OS
Uploaded by
api-25919427DB2 UDB Messages and Codes For OS-390 & Z-OS
Uploaded by
api-25919427DB2 Universal Database for OS/390 and z/OS
Messages and Codes
Version 7
GC26-9940-01
DB2 Universal Database for OS/390 and z/OS
Messages and Codes
Version 7
GC26-9940-01
Note
Before using this information and the product it supports, be sure to read the
general information under “Appendix E. Notices” on page 1321.
Second Edition, Softcopy Only (August 2001)
This edition applies to Version 7 of IBM DATABASE 2 Universal Database Server for OS/390 and z/OS (DB2 for
OS/390 and z/OS), 5675-DB2, and to any subsequent releases until otherwise indicated in new editions. Make sure
you are using the correct edition for the level of the product.
This softcopy version is based on the printed edition of the book and includes the changes indicated in the printed
version by vertical bars. Additional changes made to this softcopy version of the book since the hardcopy book was
published are indicated by the hash (#) symbol in the left-hand margin. Editorial changes that have no technical
significance are not noted.
This and other books in the DB2 for OS/390 and z/OS library are periodically updated with technical changes. These
updates are made available to licensees of the product on CD-ROM and on the Web (currently at
www.ibm.com/software/data/db2/os390/library.html). Check these resources to ensure that you are using the most
current information.
© Copyright International Business Machines Corporation 1982, 2001. All rights reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Part 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Chapter 1. Introduction to this book and the DB2 library . . . . . . . . 3
Who should read this book . . . . . . . . . . . . . . . . . . . . . 3
How to use this book . . . . . . . . . . . . . . . . . . . . . . . 3
Message type codes . . . . . . . . . . . . . . . . . . . . . . 5
DB2 message severity codes . . . . . . . . . . . . . . . . . . . 5
DB2 abend completion codes (X'04E' and X'04F). . . . . . . . . . . . 5
DB2 diagnostic information . . . . . . . . . . . . . . . . . . . . 6
MVS abends resulting from DB2 operation . . . . . . . . . . . . . . 7
| Summary of changes to this book . . . . . . . . . . . . . . . . . . 7
How to send your comments . . . . . . . . . . . . . . . . . . . . 7
Part 2. SQL Return Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Chapter 2. SQL Return Codes . . . . . . . . . . . . . . . . . . . 11
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Checking the execution of SQL statements . . . . . . . . . . . . . . 11
SQLCODE . . . . . . . . . . . . . . . . . . . . . . . . . . 11
SQLSTATE . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Successful execution SQL code. . . . . . . . . . . . . . . . . . . 12
Error SQL codes . . . . . . . . . . . . . . . . . . . . . . . . 24
Part 3. DB2 Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Chapter 3. DB2 Messages . . . . . . . . . . . . . . . . . . . . 135
Chapter 4. DSNA... Messages . . . . . . . . . . . . . . . . . . 137
Chapter 5. DSNB... Messages . . . . . . . . . . . . . . . . . . 143
Chapter 6. DSNE... Messages . . . . . . . . . . . . . . . . . . 189
Chapter 7. DSNF... Messages . . . . . . . . . . . . . . . . . . 213
| Chapter 8. DSNG... Messages . . . . . . . . . . . . . . . . . . 215
Chapter 9. DSNH... Messages . . . . . . . . . . . . . . . . . . 217
Message line numbers . . . . . . . . . . . . . . . . . . . . . 217
Message severity codes . . . . . . . . . . . . . . . . . . . . . 217
Source tokens in messages. . . . . . . . . . . . . . . . . . . . 218
Chapter 10. DSNI... Messages . . . . . . . . . . . . . . . . . . 255
Chapter 11. DSNJ... Messages . . . . . . . . . . . . . . . . . . 263
Chapter 12. DSNL... Messages . . . . . . . . . . . . . . . . . . 307
Chapter 13. DSNM... Messages . . . . . . . . . . . . . . . . . . 351
Chapter 14. DSNN... Message . . . . . . . . . . . . . . . . . . 353
© Copyright IBM Corp. 1982, 2001 iii
Chapter 15. DSNP... Messages . . . . . . . . . . . . . . . . . . 355
Chapter 16. DSNR... Messages . . . . . . . . . . . . . . . . . . 367
Chapter 17. DSNT... Messages . . . . . . . . . . . . . . . . . . 375
Chapter 18. DSNU... Messages . . . . . . . . . . . . . . . . . . 441
Chapter 19. DSNV... Messages . . . . . . . . . . . . . . . . . . 579
Chapter 20. DSNW... Messages . . . . . . . . . . . . . . . . . . 597
Chapter 21. DSNX... Messages . . . . . . . . . . . . . . . . . . 611
Chapter 22. DSNY... Messages . . . . . . . . . . . . . . . . . . 629
Chapter 23. DSNZ... Messages . . . . . . . . . . . . . . . . . . 631
Chapter 24. DSN1... Messages . . . . . . . . . . . . . . . . . . 633
Chapter 25. DSN2... Messages . . . . . . . . . . . . . . . . . . 661
Chapter 26. DSN3... Messages . . . . . . . . . . . . . . . . . . 671
Chapter 27. DSN7... Messages . . . . . . . . . . . . . . . . . . 683
Chapter 28. DSN8... Messages . . . . . . . . . . . . . . . . . . 691
Chapter 29. DSN9... Messages . . . . . . . . . . . . . . . . . . 701
Part 4. DB2 Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707
Chapter 30. Section 4. DB2 Codes . . . . . . . . . . . . . . . . 709
Chapter 31. X’C1......’ Codes . . . . . . . . . . . . . . . . . . . 711
Chapter 32. X’C2......’ Codes . . . . . . . . . . . . . . . . . . . 719
Chapter 33. X’C3......’ Codes . . . . . . . . . . . . . . . . . . . 755
Chapter 34. X’C5......’ Codes . . . . . . . . . . . . . . . . . . . 761
Chapter 35. X’C6......’ Code . . . . . . . . . . . . . . . . . . . 767
Chapter 36. X’C8......’ Codes . . . . . . . . . . . . . . . . . . . 769
Chapter 37. X’C9......’ Codes . . . . . . . . . . . . . . . . . . . 771
Chapter 38. X’D1......’ Codes . . . . . . . . . . . . . . . . . . . 805
Chapter 39. X’D3......’ Codes . . . . . . . . . . . . . . . . . . . 847
Chapter 40. X’D4......’ Codes . . . . . . . . . . . . . . . . . . . 987
Chapter 41. X’D6......’ Codes . . . . . . . . . . . . . . . . . . . 995
iv DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 42. X’D7......’ Codes . . . . . . . . . . . . . . . . . . . 997
Chapter 43. X’D9......’ Codes . . . . . . . . . . . . . . . . . . 1007
Chapter 44. X’E2......’ Codes . . . . . . . . . . . . . . . . . . 1025
Chapter 45. X’E3......’ Codes . . . . . . . . . . . . . . . . . . 1037
Chapter 46. X’E4......’ Codes . . . . . . . . . . . . . . . . . . 1055
Chapter 47. X’E5......’ Codes . . . . . . . . . . . . . . . . . . 1107
Chapter 48. X’E6......’ Codes . . . . . . . . . . . . . . . . . . 1131
Chapter 49. X’E6......’ Reason Codes . . . . . . . . . . . . . . . 1133
Chapter 50. X’E6......’ Abend Codes . . . . . . . . . . . . . . . . 1143
Chapter 51. X’E7......’ Codes . . . . . . . . . . . . . . . . . . 1147
Chapter 52. X’E8......’ Codes . . . . . . . . . . . . . . . . . . 1163
Chapter 53. X’E9......’ Codes . . . . . . . . . . . . . . . . . . 1177
Chapter 54. X’F1......’ Codes . . . . . . . . . . . . . . . . . . 1179
Chapter 55. X’F3......’ Codes . . . . . . . . . . . . . . . . . . 1181
Chapter 56. X’F7......’ Codes . . . . . . . . . . . . . . . . . . 1225
Chapter 57. X’F9......’ Codes . . . . . . . . . . . . . . . . . . 1229
Part 5. IRLM Messages and Codes . . . . . . . . . . . . . . . . . . . . . 1235
Chapter 58. IRLM Messages and Codes . . . . . . . . . . . . . . 1237
IRLM messages . . . . . . . . . . . . . . . . . . . . . . . 1237
Chapter 59. IRLM Error Return and Reason Codes . . . . . . . . . 1255
CHANGE request . . . . . . . . . . . . . . . . . . . . . . . 1255
IDENT request . . . . . . . . . . . . . . . . . . . . . . . . 1258
LOCK request . . . . . . . . . . . . . . . . . . . . . . . . 1259
NOTIFY request . . . . . . . . . . . . . . . . . . . . . . . 1260
PLEXIT request. . . . . . . . . . . . . . . . . . . . . . . . 1261
PURGE request . . . . . . . . . . . . . . . . . . . . . . . 1261
QUERY request . . . . . . . . . . . . . . . . . . . . . . . 1262
QUIT request . . . . . . . . . . . . . . . . . . . . . . . . 1263
RETLOCK request . . . . . . . . . . . . . . . . . . . . . . 1263
STAT request . . . . . . . . . . . . . . . . . . . . . . . . 1264
SYNC request . . . . . . . . . . . . . . . . . . . . . . . . 1264
TAKEOVER request . . . . . . . . . . . . . . . . . . . . . . 1264
UNLOCK request . . . . . . . . . . . . . . . . . . . . . . . 1265
VERIFY request . . . . . . . . . . . . . . . . . . . . . . . 1266
Chapter 60. IRLM Abend Reason Codes . . . . . . . . . . . . . . 1267
Contents v
Part 6. SNA CODES . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1269
Chapter 61. SNA Sense Codes . . . . . . . . . . . . . . . . . 1271
Part 7. Appendixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1277
Appendix A. CICS Transaction Abend/Dump Code. . . . . . . . . . 1279
Appendix B. Problem determination . . . . . . . . . . . . . . . 1281
Diagnostic items . . . . . . . . . . . . . . . . . . . . . . . 1281
Resource types . . . . . . . . . . . . . . . . . . . . . . . . 1283
ABEND codes associated with DSN1COPY misuse . . . . . . . . . . 1286
Explanations . . . . . . . . . . . . . . . . . . . . . . . . 1288
Appendix C. SQLSTATE Values—Common Error Codes . . . . . . . 1291
Using SQLSTATE values . . . . . . . . . . . . . . . . . . . . 1291
Appendix D. New, Changed, and Deleted Messages and Codes . . . . 1311
New messages and codes . . . . . . . . . . . . . . . . . . . . 1311
Changed messages and codes . . . . . . . . . . . . . . . . . . 1317
Changed SQLSTATEs . . . . . . . . . . . . . . . . . . . . . 1320
Deleted messages and codes . . . . . . . . . . . . . . . . . . 1320
Appendix E. Notices . . . . . . . . . . . . . . . . . . . . . 1321
Programming interface information . . . . . . . . . . . . . . . . . 1322
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . 1323
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . 1325
Bibliography . . . . . . . . . . . . . . . . . . . . . . . . 1345
vi DB2 UDB for OS/390 and z/OS: Messages and Codes
Part 1. Introduction
Chapter 1. Introduction to this book and the DB2 library . . . . . . . . 3
Who should read this book . . . . . . . . . . . . . . . . . . . . . 3
How to use this book . . . . . . . . . . . . . . . . . . . . . . . 3
Message type codes . . . . . . . . . . . . . . . . . . . . . . 5
DB2 message severity codes . . . . . . . . . . . . . . . . . . . 5
DB2 abend completion codes (X'04E' and X'04F). . . . . . . . . . . . 5
DB2 diagnostic information . . . . . . . . . . . . . . . . . . . . 6
MVS abends resulting from DB2 operation . . . . . . . . . . . . . . 7
| Summary of changes to this book . . . . . . . . . . . . . . . . . . 7
How to send your comments . . . . . . . . . . . . . . . . . . . . 7
© Copyright IBM Corp. 1982, 2001 1
2 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 1. Introduction to this book and the DB2 library
This chapter contains specific information about this book and a general overview of
the DB2 library.
Throughout this book, “DB2” means the program product IBM DATABASE 2
Universal Database Server for OS/390 and z/OS (DB2 for OS/390 and z/OS). Other
DB2 products are given their complete names or abbreviations.
Who should read this book
This book, IBM DATABASE 2 Universal Database Server for OS/390 and z/OS
Messages and Codes, lists messages and codes issued by DB2, with explanations
and suggested responses. This book is intended for users and system
programmers who might encounter DB2 messages and codes.
How to use this book
This book consists of the following six sections and four appendixes:
v “Part 1. Introduction” on page 1 explains the different types of messages and
codes that DB2 generates.
v “Part 2. SQL Return Codes” on page 9 lists the SQL return codes.
v “Part 3. DB2 Messages” on page 133 lists the various DB2 messages.
v “Part 4. DB2 Codes” on page 707 lists the various DB2 codes.
v “Part 5. IRLM Messages and Codes” on page 1235 lists the various IRLM
messages and codes.
v “Part 6. SNA CODES” on page 1269 lists the SNA codes.
v “Appendix A. CICS Transaction Abend/Dump Code” on page 1279 explains the
CICS transaction abend/dump code (DSNC).
v “Appendix B. Problem determination” on page 1281 lists the diagnostic items and
resource types you can use to resolve problems.
v “Appendix C. SQLSTATE Values—Common Error Codes” on page 1291 lists the
error code SQLSTATE values. These values provide common return codes for
common error conditions.
v “Appendix D. New, Changed, and Deleted Messages and Codes” on page 1311
lists the new, changed, and deleted messages and codes.
The introduction provides general information about DB2 messages and codes. You
will be referred to it from appropriate places in the manual. However, it is
recommended that you become familiar with this material ahead of time.
The SQL return codes are listed by numeric sequence. The DB2 messages are
listed in order of their subcomponent identifier and further by their numeric identifier.
The codes are listed by their hexadecimal ID and further by their numeric identifier.
The IRLM messages and codes are listed by numeric sequence.
Message identifiers and CSECT names are used to identify messages. Unless the
message is issued by a subcomponent operating outside the DB2 environment
(such as the precompiler or attachment facilities), messages are preceded by a
subsystem recognition character that is defined during system installation. The
subsystem recognition character is not shown in the message texts in this book.
© Copyright IBM Corp. 1982, 2001 3
| All DB2 message identifiers are eight to ten characters long. The first three
characters are always DSN: it is the DB2 component prefix name. The fourth
character is the subcomponent identifier: it identifies the subcomponent of DB2 that
issued the message. Each subcomponent has an associated hexadecimal identifier
| (hex ID): it is the hexadecimal representation of the subcomponent identifier. The
| numeric identifier is three to five characters long and begins at the fifth character in
| the message. The numeric identifier is unique within the subcomponent. The last
character of the message identifier is the message type code. It indicates the type
of response that the message requires. A subsystem identifier is an optional field
found after the message number: it is also known as the csect-name. Message
identifiers and CSECT names have the following format:
DSNB209I DSNB1CHK
where:
DSN is the DB2 subsystem prefix name.
B is the subcomponent identifier; in this example B identifies the DB2 buffer
manager and the hexadecimal ID for this subcomponent is X'C2'.
209 is the numeric identifier.
I indicates that this message is for information only.
DSNB1CHK
is the csect name; it is an optional field.
The DB2 reason codes and subsystem termination reason codes are 4 bytes long.
The first byte is always 00: it is the high-order byte. The second byte is the
hexadecimal identifier (hex ID): it identifies the DB2 subcomponent. The last 2 bytes
are the numeric identifier: it is unique within the subcomponent. The codes have the
following format:
00E50041
where:
00 is the high-order byte.
E5 is the hexadecimal identifier; it identifies the DB2 agent services manager.
0041 is the numeric identifier.
Accompanying each message and code is the following information, when
applicable:
responses are and their effect. If this information is not
shown, no operator response is required.
Explanation: This section tells what the message or
System Programmer Response: If a response by the
code means, why it occurred, and what caused it. To
system programmer is needed, this part tells what the
assist in diagnosing problems, the CSECTs that issued
pertinent responses are and their effect. If this
the message are also included. However, if the issuing
information is not shown, no system programmer
CSECT is placed in the message text at run time, it is
response is required.
not included in the explanation.
Programmer Response: If a programmer response is
System Action: This part tells what is happening as a
necessary, this part tells what the pertinent responses
result of the condition causing the message or code. If
are and their effect. If this information is not shown, no
this information is not shown, no system action is taken.
programmer response is required.
User Response: If a response by the user is
Problem Determination: This section lists the actions
necessary, this section tells what the pertinent
that can be performed to obtain adequate data for
responses are and their effect. If this information is not
support personnel to diagnose the problem. If this
shown, no user response is required.
information is not shown, no problem determination is
Operator Response: If an operator response is required.
necessary, this section tells what the pertinent
4 DB2 UDB for OS/390 and z/OS: Messages and Codes
Message type codes
The last character of a message identifier is the type code. Four type codes are
used, as shown in the following list:
A Immediate action Action is required immediately. The
associated task does not continue until the
requested action is taken.
D Immediate decision Decision or action is required immediately.
The associated task does not continue until
the requested decision is made or action is
taken.
E Eventual action Action is required at some point; however,
the associated task continues. All RC=8 error
messages that are not host related (SOFT
errors) have the E changed to a W in
precompiler output when SQL(ALL) is in
effect. All RC=8 errors (HARD errors) look
the same as they have in the past.
I Information only No action is required.
DB2 message severity codes
Messages issued by the precompiler subcomponent of DB2, as well as some
messages issued by the service controller and utility subcomponents of DB2,
provide severity codes. The specific meanings of the severity codes differ slightly for
each of the subcomponents. In general, the higher the severity level, the more
significant the situation.
Severity codes for these subcomponents are described at the beginning of the
individual subcomponent sections in “Part 3. DB2 Messages” on page 133. They are
also included in the individual messages, where appropriate.
DB2 abend completion codes (X'04E' and X'04F)
DB2 uses two system abend completion codes: X'04E' and X'04F'.
X'04E' and X'04F' identify:
v Internal errors encountered during DB2 operation
v Diagnostic information for problem determination
v Subsystem actions initiated by the DB2 subcomponent involved in the error
X'04E'
An X'04E' abend completion code indicates that DB2 detected an internal error
and abended a DB2 internal task (TCB) or a user-connected task. Errors
associated with an X'04E' abend completion code might be preceded by an
MVS system code or by internal errors.
The diagnostic material generated by the X'04E' abend must be examined to
determine the source of the error that actually resulted in a subsequent task or
subsystem termination.
X'04F'
An X'04F' abend completion code indicates that DB2 detected a severe error
and abended the entire DB2 subsystem. When an X'04F' is issued, DB2
determined that continued operation could result in the loss of data integrity.
Errors associated with an X'04F' abend completion code might be preceded by
an MVS system error or by one or more DB2 X'04E' abend completion codes.
Chapter 1. Introduction to this book and the DB2 library 5
Table 1 summarizes the diagnostic information and subsystem actions available to
DB2 when these abend completion codes are issued. Some pieces of this
information are not relevant to some error situations and will not help in problem
diagnosis. In these cases, DB2 does not produce any diagnostic information that is
unnecessary. The information that DB2 produces for a given error depends upon
the specific problem. The MVS services that provide diagnostic information are
discussed in “DB2 diagnostic information”
Table 1. Abend Completion Codes
X'04E' X'04F'
Explanation v Error during DB2 normal v Severe error; continued
operation operation may jeopardize data
integrity
System action v Internal DB2 task is abended v The entire DB2 subsystem is
abended
v Connected user task is
v User task with an active DB2
abended
connection may be abnormally
terminated with an X'04F'
v Possible MEMTERM (memory
termination) of connected allied
address space
Diagnostic information v SVC dump v SYS1.LOGREC entries
v SYS1.LOGREC entries v VRA data entries
v VRA data entries
Associated reason v DB2 abend reason code v Subsystem termination reason
codes v Associated MVS system codes code
v MVS system completion codes
and X'04E' codes that precede
the X'04F' abend
Location of v SVC dump title v SYS1.LOGREC entries
accompanying codes v Message DSNW050I v VRA data entries
v Register 15 of SDWA section v Message DSNV086E, which is
“General Purpose Registers at sent to MVS system operator
Time of Error”
v SYS1.LOGREC entries
v VRA data entries
DB2 diagnostic information
DB2’s functional recovery routines use MVS services to provide diagnostic
information for assistance in problem determination.
The following MVS services provide diagnostic information:
v SVC dumps
The DB2 abend completion code X'04E' uses the MVS SDUMP service to create
SVC dumps. The content and storage areas associated with these dumps vary
depending on the specific error and the state of the DB2 subsystem at the time
the error.
v SYS1.LOGREC entries
Entries are requested in the SYS1.LOGREC data set at the time of the error
using the MVS SETRP service. The following are also recorded in
SYS1.LOGREC:
– Subsystem abnormal terminations
– Secondary abends occurring in a recovery routine
6 DB2 UDB for OS/390 and z/OS: Messages and Codes
– Recording requests from recovery routines percolated to by the recovery
termination manager.
v Variable recording area (VRA) data
Data entries are added to the VRA of the SDWA by using an MVS VRA defined
key. VRA data includes a series of diagnostic data entries common to both DB2
abend completion codes. Additional information is provided by the invoking
subcomponent recovery routine during initial error processing or recovery
termination manager percolation.
MVS abends resulting from DB2 operation
During DB2 operation, an abend can occur with an MVS system completion code. If
you receive an MVS abend during DB2 operation, refer to the appropriate MVS
publication.
| Summary of changes to this book
| This edition adds and modifies messages and codes to support DB2 Version 7. It
| also incorporates technical corrections and changes made to previously published
| information. For specific information about new, changed and deleted messages
| and codes for Version 7, see “Appendix D. New, Changed, and Deleted Messages
| and Codes” on page 1311.
How to send your comments
Your feedback helps IBM to provide quality information. Please send any comments
that you have about this book or other DB2 for OS/390 and z/OS documentation.
You can use any of the following methods to provide comments:
v Send your comments by e-mail to [email protected] and include the name
of the product, the version number of the product, and the number of the book. If
you are commenting on specific text, please list the location of the text (for
example, a chapter and section title, page number, or a help topic title).
v Send your comments from the Web. Visit the Web site at:
http://www.ibm.com/software/db2os390
The Web site has a feedback page that you can use to send comments.
v Complete the readers’ comment form at the back of the book and return it by
mail, by fax (800-426-7773 for the United States and Canada), or by giving it to
an IBM representative.
Chapter 1. Introduction to this book and the DB2 library 7
8 DB2 UDB for OS/390 and z/OS: Messages and Codes
Part 2. SQL Return Codes
© Copyright IBM Corp. 1982, 2001 9
10 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 2. SQL Return Codes
The information in this chapter is General-use Programming Interface and
Associated Guidance Information, as defined in “Appendix E. Notices” on
page 1321.
Introduction
Structured Query Language (SQL) return codes, and the tokens referred to in the
explanations, are returned in the SQL communication area (SQLCA).
The SQLCA is an area in the application program (defined by the application
program) for the use of DB2. It is described in Appendix C of DB2 SQL Reference .
The SQL return code is returned in the SQLCODE field of the SQLCA. The tokens
are returned in the SQLERRM field. If there are several tokens, they appear
sequentially in SQLERRM in the order in which they appear in the message text.
The tokens are separated by the character X'FF'.
A token appears in the message text in lowercase letters. When an SQL return
code is returned through SPUFI, the tokens have been substituted into the
message text and the text is displayed. The substitution of tokens into message text
is performed by a DB2 module named DSNTIAR. This module can also be used by
application programs. Refer to Part 2 of DB2 Application Programming and SQL
Guide for more information about DSNTIAR.
Checking the execution of SQL statements
An application program containing executable SQL statements must either provide a
structure named SQLCA or a stand-alone integer variable named SQLCODE
(SQLCOD in FORTRAN). An SQLCA may be provided by using the INCLUDE
SQLCA statement. INCLUDE SQLCA must not be used if a stand-alone SQLCODE
is provided.
The SQLCA includes an integer variable named SQLCODE. The option of providing
a stand-alone SQLCODE instead of an SQLCA allows for conformance with the
ISO/ANSI SQL standard. The use of this option must be indicated to the
precompiler.
SQLCODE
Regardless of whether the application program provides an SQLCA or a
stand-alone variable, SQLCODE is set by DB2 after each SQL statement is
executed. DB2 conforms to the ISO/ANSI SQL standard as follows:
v If SQLCODE = 0, execution was successful.
v If SQLCODE > 0, execution was successful with a warning.
v If SQLCODE < 0, execution was not successful.
v SQLCODE = 100, ″no data″ was found. For example, a FETCH statement
returned no data because the cursor was positioned after the last row of the
result table.
© Copyright IBM Corp. 1982, 2001 11
000 • +110
SQLSTATE
SQLSTATE is also set by DB2 after the execution of each SQL statement. Thus,
application programs can check the execution of SQL statements by testing
SQLSTATE instead of SQLCODE. SQLSTATE (SQLSTT in FORTRAN) is a 5-byte
character string variable in the SQLCA.
SQLSTATE provides application programs with common codes for common error
conditions (the values of SQLSTATE are product-specific only if the error or warning
is product-specific). Furthermore, SQLSTATE is designed so that application
programs can test for specific errors or classes of errors. The coding scheme is the
same for all IBM relational database products. See “Appendix C. SQLSTATE
Values—Common Error Codes” on page 1291 for more information and a complete
list of the possible values of SQLSTATE.
Successful execution SQL code
000 SUCCESSFUL EXECUTION +098 A DYNAMIC SQL STATEMENT ENDS
WITH A SEMICOLON.
Explanation: Unqualified successful execution or
successful execution with one or more warnings. If Explanation: The statement string of a PREPARE or
SQLWARN0 is blank, there are no warnings. If EXECUTE IMMEDIATE statement is a valid dynamic
SQLWARN0 = W, at least one of the other warning SQL statement, but it ends with a semicolon.
indicators in the SQLCA has been set to indicate a
System Action: The semicolon and any subsequent
warning condition. For example, SQLWARN1 is used to
text are ignored.
indicate that a value of a string column was truncated
when assigned to a host variable. SQLWARNx fields are Programmer Response: Check that the semicolon is
described in Appendix C of DB2 SQL Reference. being used as a statement terminator.
SQLSTATE: 00000 for unqualified successful SQLSTATE: 01568
execution
SQLSTATE: 01ddd for successful execution with +100 ROW NOT FOUND FOR FETCH,
warning 'ddd'. UPDATE OR DELETE, OR THE RESULT
OF A QUERY IS AN EMPTY TABLE
+012 THE UNQUALIFIED COLUMN NAME Explanation: One of the following conditions occurred:
column-name WAS INTERPRETED AS A v No row met the search conditions specified in an
CORRELATED REFERENCE UPDATE or DELETE statement.
Explanation: The column name does not identify a v The result of a SELECT INTO statement was an
column of a table or view in the FROM clause of the empty table.
subquery. However, it does identify a column of a table v A FETCH statement was executed when the cursor
or view in a FROM clause at a higher level in the was positioned after the last row of the result table.
statement.
v The result of the subselect of an INSERT statement
System Action: The column name is interpreted as a is empty.
correlated reference.
Programmer Response: If DB2’s interpretation of the When a SELECT statement is executed using SPUFI,
column name was not what you intended, rewrite the this SQLCODE indicates normal completion.
SQL statement and submit it again. If you intend the System Action: No data was retrieved, updated, or
column name to refer to a table named at a higher deleted.
level, we advise rewriting the statement anyway, using a
table name or correlation name as a qualifier for the SQLSTATE: 02000
column name. The unqualified column name could be
interpreted differently if you do a rebind after altering +110 SQL UPDATE TO A DATA CAPTURE
one of the tables to which you refer. TABLE NOT SIGNALED TO
SQLSTATE: 01545 ORIGINATING SUBSYSTEM
Explanation: DataPropagator (DPropNR) exit routine
issued an SQL INSERT, UPDATE, or DELETE
12 DB2 UDB for OS/390 and z/OS: Messages and Codes
+111 • +206
statement to a table defined with DATA CAPTURE
+203 THE QUALIFIED COLUMN NAME
CHANGES. Since data capture is already in progress,
column-name WAS RESOLVED USING A
notification is not sent back to the originating IMS
NON-UNIQUE OR UNEXPOSED NAME
subsystem.
Explanation: The table designator selected to resolve
System Action: DB2 changes the data and records
a qualified column name is one of the following:
the change in the log. DB2 does not notify DPropNR’s
v An unexposed name
exit routine of the change, because doing so might
v An exposed name that has an exposed duplicate in
cause the same change to be made again.
the same FROM clause
SQLSTATE: 01561 v An exposed name that has an unexposed duplicate
which appears before the selected name in the
ordered list of names to which the qualifier is
+111 THE SUBPAGES OPTION IS NOT compared
SUPPORTED FOR TYPE 2 INDEXES
Therefore, the statement does not conform to the
Explanation: You cannot use the SUBPAGES option guidelines for using only unique exposed names as
for type 2 indexes. qualifiers or it is possible that the column reference was
System Action: The option is ignored and processing not resolved to the intended instance of the table or
continues. view.
Programmer Response: Remove the SUBPAGES System Action: DB2 uses the selected name to
option to get rid of the warning. resolve the reference.
SQLSTATE: 01590 Programmer Response: If DB2’s resolution of the
qualifier was not what you intended, rewrite the SQL
statement and submit it again. The rules used to resolve
+117 THE NUMBER OF INSERT VALUES IS column name qualifiers are given in Chapter 2 of DB2
NOT THE SAME AS THE NUMBER OF SQL Reference.
OBJECT COLUMNS
SQLSTATE: 01552
Explanation: The number of insert values in the value
list of the INSERT statement is not the same as the
number of object columns specified. +204 name IS AN UNDEFINED NAME
System Action: A valid plan or package will be Explanation: The object identified by 'name' is not
created if no errors are detected. The statement is defined in the DB2 subsystem. This return code can be
bound dynamically on each execution of the statement. generated for any type of DB2 object.
Programmer Response: For better performance, System Action: A valid plan or package will be
rebind the plan or package after correcting the created if no errors are detected. The statement is
statement. To correct the statement, specify one and bound dynamically on each execution of the statement.
only one value for each of the specified object columns. Programmer Response: For better performance,
SQLSTATE: 01525 rebind the plan or package after correcting the
statement. To correct the statement, determine that the
object name was correctly specified in the SQL
+162 TABLESPACE database- statement (including any required qualifiers). If so,
name.tablespace-name HAS BEEN ensure that the object exists in the system before
PLACED IN CHECK PENDING resubmitting the statement.
Explanation: The indicated table space is in check SQLSTATE: 01532
pending status because the ALTER TABLE statement
was used to specify a referential constraint or a check
constraint (while special register CURRENT RULES = +206 column-name IS NOT A COLUMN OF AN
'DB2') on a populated table. The table space is not INSERTED TABLE, UPDATED TABLE,
generally available until the check pending status is OR ANY TABLE IDENTIFIED IN A FROM
removed from the table space. CLAUSE
System Action: The table space was placed in check Explanation: This return code is used to report one of
pending status. these errors:
v In the case of an INSERT or UPDATE statement, the
Programmer Response: Run the CHECK DATA utility.
specified column is not a column of the table or view
The enforcement of the referential constraint or the
that was specified as the object of the insert or
check constraint is deferred until the CHECK DATA
update.
utility is run.
SQLSTATE: 01514
Chapter 2. SQL Return Codes 13
+218 • +231
v In the case a SELECT or DELETE statement, the
+220 THE COLUMN column-name IN
specified column is not a column of any of the tables
EXPLANATION TABLE table-name IS
or views identified in a FROM clause in the
NOT DEFINED PROPERLY
statement.
v There is a correlated reference in GROUP BY. Explanation: An error occurred during the insertion of
a row into the explanation table. The table is improperly
v There is an unresolved qualified reference in
defined for the following reasons:
HAVING.
v A column is missing.
System Action: A valid plan or package will be
v Columns are defined in the wrong order.
created if no errors are detected. The statement is
bound dynamically on each execution of the statement. v The table contains an extra column.
v A column description is invalid because of its name,
Programmer Response: For better performance,
data type, length, or null attributes.
rebind the plan or package after correcting the
statement. To correct the statement, verify that the System Action: A valid plan or package will be
column and table names are specified correctly in the created if no errors are detected. The statement is
SQL statement. In the case of a SELECT statement, bound dynamically on each execution of the statement.
check to be sure that all of the required tables were
Programmer Response: For better performance,
named in the FROM clause.
rebind the plan or package after correcting the
SQLSTATE: 01533 statement. To correct the statement, correct the
definition of the required explanation table. Refer to
Chapter 5 of DB2 SQL Reference for information about
+218 THE SQL STATEMENT REFERENCING
defining an explanation table.
A REMOTE OBJECT CANNOT BE
EXPLAINED SQLSTATE: 01546
Explanation: The user has used EXPLAIN(YES) on
the bind subcommand to bind an application which has | +222 DELETE HOLE DETECTED USING
SQL statement referencing a remote object or the user | cursor-name
has a static EXPLAIN SQL statement which references
a remote object in the application program. EXPLAIN on
| Explanation: DB2 could not FETCH data for cursor
a remote object is not supported by DB2.
| cursor-name because the corresponding row of the
| underlying table was deleted, resulting in a delete hole.
It is issued at BIND time, and only with | DB2 detected the delete hole when it processed a
VALIDATE(RUN). | FETCH for cursor cursor-name.
System Action: The plan or package will be bound | cursor-name
successfully, but no information will be filled in the | Name of the cursor used for the FETCH
user’s PLAN-TABLE for the SQL statement referencing | statement.
a remote object. An SQLCODE -512 will be issued at
run time if the EXPLAIN statement is found to explain a
| System Action: The statement cannot be processed.
remote object.
| The cursor is repositioned on the hole.
SQLSTATE: 01537
| Programmer Response: Correct the application
| program to handle this situation or change isolation
| levels so the base row cannot be deleted during the
+219 THE REQUIRED EXPLANATION TABLE | cursor operation.
table-name DOES NOT EXIST
| SQLSTATE: 02502
Explanation: The EXPLAIN statement assumes the
existence of the explanation table and it is not defined
in the DB2 subsystem as a base table. Refer to Chapter
| +231 CURSOR POSITION OF CURSOR
5 of DB2 SQL Reference for more information.
| cursor-name IS NOT VALID FOR FETCH
| OF THE CURRENT ROW
System Action: A valid plan or package will be
created if no errors are detected. The statement is
| Explanation: The cursor was not positioned on a row,
bound dynamically on each execution of the statement.
| and either FETCH CURRENT or FETCH RELATIVE 0
| was specified. No data was fetched.
Programmer Response: For better performance,
rebind the plan or package after correcting the
| cursor-name
statement. To correct the statement, determine whether
| Name of the cursor used for the FETCH
the required explanation table does exist. If not, create
| statement.
the required table. | System Action: The statement cannot be processed.
SQLSTATE: 01532
| The cursor position is unchanged.
14 DB2 UDB for OS/390 and z/OS: Messages and Codes
+236 • +238
| Programmer Response: Correct the application Note: in the case of DESCRIBE INPUT, each reference
| program to establish position before issuing this FETCH to column would actually be parameter.
| statement.
System Action: DB2 has set the SQLDAID 7th byte
| SQLSTATE: 02000 flag ″on″ because sufficient space was not provided for
the extended SQLVAR entries. The value of the 7th byte
flag indicates how many SQLVAR entries are needed
+236 SQLDA INCLUDES integer1 SQLVAR
for each column. Additionally, because there were
ENTRIES, BUT integer2 ARE REQUIRED
enough SQLVAR entries for the base SQLVARs, DB2
FOR integer3 COLUMNS
has set the fields of the base SQLVAR entries.
Explanation: The value of the SQLN field of the However, DB2 has not set any extended SQLVAR
SQLDA should be at least as large as the number of entries.
columns being described. integer3 is the number of
Programmer Response: If there is no need for the
columns being described.
additional information about the distinct type(s), then no
In the case that USING BOTH has been specified, twice action is required unless USING BOTH was specified
as many SQLVAR entries are needed as the number of (in which case additional SQLVAR entries must be
columns being described. provided for the labels).
The number of SQLVAR entries that are needed to If the distinct type information is needed, the value of
return all of the information about the columns is the SQLN field in the SQLDA should be increased to
integer2. integer2 (after making sure that the SQLDA is large
enough to support that amount) and the statement
Note: in the case of DESCRIBE INPUT, each reference should be resubmitted.
to column would actually be parameter. SQLSTATE: 01594
System Action: The SQLDAID 7th byte has been set
to ″on″ with a value of 2 indicating that 2 SQLVAR +238 SQLDA INCLUDES integer1 SQLVAR
entries are needed for each column. DB2 has not set ENTRIES, BUT integer2 SQLVAR
any SQLVAR entries. ENTRIES ARE NEEDED FOR integer3
Programmer Response: Increase the value of the COLUMNS BECAUSE AT LEAST ONE
SQLN field in the SQLDA to the value indicated in the OF THE COLUMNS BEING DESCRIBED
message (making sure the SQLDA is large enough to IS A LOB
support that amount) and resubmit the statement. Explanation: Given that at least one the columns
SQLSTATE: 01005 being described is a LOB, space must be provided for
the extended SQLVAR entries in addition to the base
SQLVAR entries. The value of SQLN, integer1, indicates
+237 SQLDA INCLUDES integer1 SQLVAR that there are not enough SQLVAR entries for the base
ENTRIES, BUT integer2 ARE REQUIRED and extended SQLVAR entries. One or more of the
BECAUSE AT LEAST ONE OF THE columns being described may be a distinct type.
COLUMNS BEING DESCRIBED IS A
DISTINCT TYPE The total number of SQLVAR entries that are required
depends on whether USING BOTH was specified or not
Explanation: Given that at least one of the columns (n is the number of columns being described which is
being described is a distinct type, space should be integer3), and whether the columns include any distinct
provided for the extended SQLVAR entries in addition to types:
the base SQLVAR entries. The value of SQLN, integer1,
v With USING BOTH, and one or more distinct types,
indicates that there are not enough SQLVAR entries for
space should be allocated for 3n SQLVAR entries.
the base and extended SQLVAR entries.
v Otherwise, space should be allocated for 2n SQLVAR
The total number of SQLVAR entries that are required entries.
depends on whether USING BOTH was specified (n is
the number of columns being described): The number of SQLVAR entries that are needed to
v With USING BOTH, space should be allocated for 3n return all of the information about the columns is
SQLVAR entries. integer2.
v Otherwise, space should be allocated for 2n SQLVAR
entries. Note: in the case of DESCRIBE INPUT, each reference
to column would actually be parameter.
The number of SQLVAR entries that are needed to System Action: DB2 has set the SQLDAID 7th byte
return all of the information about the columns is flag ″on″ because sufficient space was not provided for
integer2. the extended SQLVAR entries. The value of the 7th byte
flag indicates how many SQLVAR entries are needed
Chapter 2. SQL Return Codes 15
+239 • +339
for each column. DB2 has not set any SQLVAR entries.
+304 A VALUE WITH DATA TYPE data-type1
Programmer Response: Increase the value of the CANNOT BE ASSIGNED TO A HOST
SQLN field in the SQLDA to integer2 (after making sure VARIABLE BECAUSE THE VALUE IS
that the SQLDA is large enough to support that amount) NOT WITHIN THE RANGE OF THE
and resubmit the statement. HOST VARIABLE IN POSITION
position-number WITH DATA TYPE
SQLSTATE: 01005 data-type2
Explanation: A FETCH or SELECT into a host
+239 SQLDA INCLUDES integer1 SQLVAR variable list or structure, position number
ENTRIES, BUT integer2 ARE REQUIRED position-number failed because the host variable having
FOR integer3 COLUMNS BECAUSE AT data type data-type2 was not large enough to hold the
LEAST ONE OF THE COLUMNS BEING retrieved value having data type data-type1.
DESCRIBED IS A DISTINCT TYPE
System Action: The FETCH or SELECT could not
Explanation: Given that at least one of the columns return the data for the indicated SELECT item, the
being described is a distinct type, space should be indicator variable is set to negative two (-2) to indicate a
provided for the extended SQLVAR entries in addition to null value returned. Processing continues.
the base SQLVAR entries. The value of SQLN, integer1,
indicates that there are not enough SQLVAR entries for Programmer Response: Verify that table definitions
the base and extended SQLVAR entries. are current, and that the host variable has the proper
data type. See the explanation for SQLCODE -405 for
The total number of SQLVAR entries that are required ranges of SQL data types.
depends on whether USING BOTH was specified or not
(n is the number of columns being described which is SQLSTATE: 01515
integer3),
v With USING BOTH, space should be allocated for 3n +331 THE NULL VALUE HAS BEEN
SQLVAR entries. ASSIGNED TO A HOST VARIABLE
v Otherwise, space should be allocated for 2n SQLVAR BECAUSE THE STRING CANNOT BE
entries. TRANSLATED. REASON reason-code,
CHARACTER code-point, HOST
The number of SQLVAR entries that are needed to VARIABLE position-number
return all of the information about the columns is Explanation: A string assigned to a host variable had
integer2. to be translated from its coded character set to the
coded character set of the host variable and an error
Note: in the case of DESCRIBE INPUT, each reference occurred during the translation. The position-number is
to column would actually be parameter. the ordinality of the host variable in the SQLDA. See the
System Action: DB2 has set the SQLDAID 7th byte description of SQLCODE -331 for further information
flag ″on″ because sufficient space was not provided for including the meaning of the reason-code and
the extended SQLVAR entries. The value of the 7th byte code-point.
flag indicates how many SQLVAR entries are needed System Action: The host variable is unchanged and
for each column. DB2 has not set any SQLVAR entries. its indicator variable is set to -2 to indicate that a null
:elq. value is returned. Execution of the statement continues
Programmer Response: If the distinct type as if the translation error had not occurred.
information is needed, the value of the SQLN field in the SQLSTATE: 01520
SQLDA should be increased to integer2 (after making
sure the SQLDA is large enough to support that
amount) and the statement should be resubmitted. +339 THE SQL STATEMENT HAS BEEN
SUCCESSFULLY EXECUTED, BUT
If there is no need for the additional information about THERE MAY BE SOME CHARACTER
the distinct type(s) in the result set, then it is possible to CONVERSION INCONSISTENCIES
resubmit the statement only providing enough SQLVAR
entries to accommodate the number of columns being Explanation: The application is connected to a DB2
described (i.e. provide the necessary number of base Version 2 Release 3 database server. The SQL
SQL entries). statement is using an alias or three-part name, which
refers to another DB2 subsystem that is at the Version 2
SQLSTATE: 01005 Release 2 level. DB2 Version 2 Release 2 does not
support character conversion. Since the execution of
SQL statements from an EBCDIC DRDA requester to
an EBCDIC Version 2 Release 2 DB2 server could
require character conversion, a warning is generated. If
16 DB2 UDB for OS/390 and z/OS: Messages and Codes
+394 • +402
the requester system CCSID is inconsistent with the 9 METHOD is invalid.
DB2 Version 2 Release 2 environment, most EBCDIC
10 SORTN_JOIN is invalid.
character code points match to the same character.
Only certain special characters typically lead to data 11 SORTC_JOIN is invalid.
integrity concerns. Therefore, a warning is generated.
12 ACCESSTYPE is invalid.
System Action: The statement is successfully
executed. 13 ACCESSCREATOR or ACCESSNAME is
invalid.
Programmer Response: If the DB2 Version 2
Release 2 table is accessed from other environments 14 TYPE 1 index can’t be used with isolation level
(different CCSID), incorrect results might occur (relative ’UR’.
to what the other environment might expect). You 15 Specified index can’t be used as requested.
should understand what characters might not be
consistent with the DB2 Version 2 Release 2 16 Multi-index access can’t be done.
environment (its inherent CCSID) and avoid use of 17 Invalid ACCESSTYPE combination.
those characters or understand the exposure you face if
you use them. 18 METHOD specified for first table accessed.
System Programmer Response: If the application 19 Nested-loop join can’t be done as requested.
must refer to the Version 2 Release 2 subsystem data, 20 Merge join can’t be done as requested.
the Version 2 Release 2 DB2 subsystem can be
migrated to Version 2 Release 3 where character 21 Hybrid join can’t be done as requested.
conversion is supported.
22 PARALLELISM_MODE requested can’t be
SQLSTATE: 01569 done.
23 PARALLELISM_MODE is invalid.
+394 USER SPECIFIED OPTIMIZATION
24 ACCESS_DEGREE is invalid.
HINTS USED DURING ACCESS PATH
SELECTION 25 JOIN_DEGREE is invalid.
Explanation: Normal access path selection was 26 A table is missing.
bypassed in favor of an access path specified in the
27 A table is redundant.
PLAN_TABLE.
28 PRIMARY_ACCESSTYPE is invalid.
System Action: Processing continues normally.
29 ACCESS_PGROUP_ID is not specified.
Programmer Response: Ensure that the access path
is correct and produces the correct results. 30 JOIN_PGROUP_ID is not specified.
SQLSTATE: 01629 31 PARALLELISM_MODE is not specified.
32 CREATOR or TNAME is invalid.
+395 USER SPECIFIED OPTIMIZATION
HINTS ARE INVALID (REASON CODE = 33 Join sequence is incorrect.
reason-code). THE OPTIMIZATION 34 Full outer join requires merge join method.
HINTS ARE IGNORED.
35 WHEN_OPTIMIZE is invalid or inconsistent.
Explanation: The optimization hints specified for this
query are invalid. Areason-code in the following table 99 Unexpected error.
can help identify why the hints were invalid: System Action: The user-specified optimization hints
reason-code are ignored. The access path is determined without the
Description use of hints and processing continues normally.
2 TABNO is invalid. Programmer Response: Correct the problem with the
optimization hints, or disable their use for this query.
3 TNAME is not specified.
SQLSTATE: 01628
4 TNAME is ambiguous.
5 TABNO doesn’t agree with TNAME. +402 LOCATION location IS UNKNOWN
6 QBLOCKNO doesn’t agree with TNAME. Explanation: A remote object is referenced and either
7 PAGE_RANGE is invalid. the table SYSIBM.LOCATIONS is not defined or the
referenced 'location' matches no entry in the
8 PREFETCH is invalid. SYSIBM.LOCATIONS.LOCATION column.
Chapter 2. SQL Return Codes 17
+403 • +466
System Action: For the CREATE ALIAS statement,
+462 EXTERNAL FUNCTION OR
the alias is created. For binding a plan or package with
PROCEDURE name (SPECIFIC NAME
the VALIDATE(RUN) option, the plan or package is
specific-name) HAS RETURNED A
created.
WARNING SQLSTATE, WITH
SQLSTATE: 01521 DIAGNOSTIC TEXT text
Explanation: An SQLSTATE of the form 01Hxx was
+403 THE LOCAL OBJECT REFERENCED returned to DB2 by user-defined function or procedure
BY THE CREATE ALIAS STATEMENT name, along with message text text.
DOES NOT EXIST
System Action: Processing continues.
Explanation: The local object referenced by the
Programmer Response: See your database
CREATE ALIAS statement does not exist when creating
administrator, or the author of the function or procedure
the alias.
to find out the meaning of the warning. The significance
System Action: The alias is created. of the bad SQLSTATE to the invoking application can
be learned from the author of the function or procedure.
SQLSTATE: 01522
SQLSTATE: 01Hxx
+434 OPTION keyword IS A DEPRECATED
FEATURE +464 PROCEDURE proc RETURNED num
QUERY RESULT SETS, WHICH
Explanation: keyword is a deprecated feature that will EXCEEDS THE DEFINED LIMIT integer
not be supported in releases following DB2 Version 7. It
is accepted, but continued use of this keyword is not Explanation: The stored procedure named by proc
recommended. completed normally. However, the stored procedure
exceeded the defined limit on the number of query
For indexes, use type 2 indexes rather than type 1 result sets the procedure can return.
indexes to avoid any incompatibilities.
v num identifies the number of query result sets
System Action: Processing continues normally. returned by the stored procedure.
Programmer Response: No change is required for v integer identifies the defined limit on the number of
the current release. However, you should change your query result sets for the stored procedure.
SQL statement and remove this feature to prepare for
future releases when this feature is not supported. Only the first integer query result sets are returned to
the SQL program that issued the SQL CALL statement.
SQLSTATE: 01608
The possible causes are as follows:
+445 VALUE value HAS BEEN TRUNCATED v The stored procedure is unable to return num result
Explanation: The value value was truncated by a cast sets due to the limit defined for the procedure.
function, which was called to transform the value in v The stored procedure is unable to return num result
some way. This is a warning situation. The cast function sets due to the DRDA limitations imposed by the
is a result of client. The DRDA client establishes this limit with the
v a CAST specification MAXRSLCNT DDM code point.
v a built-in function such as CHAR, VARCHAR, etc. System Action: The SQL statement is successful. The
v a CAST FROM specification on the CREATE SQLWARN9 field is set to ’Z’.
FUNCTION statement that created the function SQLSTATE: 0100E
v a user-defined function that is sourced on another
function and the result needed to be transformed.
+466 PROCEDURE proc RETURNED num
QUERY RESULTS SETS
If 'value' has the 'for bit data' subtype, then the 'value' is
printed as a hexadecimal string in quotes followed by an Explanation: The stored procedure named by proc
X. completed normally. The procedure returned the number
of SQL query result sets specified in num.
System Action: The value has been truncated.
System Action: The SQL statement is successful. The
Programmer Response: Ensure that the output is as SQLWARN9 field is set to ’Z’.
expected and that the truncation has not caused any
unexpected consequences. | SQLSTATE: 0100C
SQLSTATE: 01004
18 DB2 UDB for OS/390 and z/OS: Messages and Codes
+494 • +551
being executed. If this SQLCODE was returned
+494 NUMBER OF RESULT SETS IS
because the cost category value is “B”, it might be that
GREATER THAN NUMBER OF
the statement is using parameter markers or that some
LOCATORS
statistics are not available for the referenced tables and
Explanation: The number of result set locators columns. Make sure the administrator has run the utility
specified on the ASSOCIATE LOCATORS statement is RUNSTATS on the referenced tables. It might also be
less than the number of result sets returned by the that UDFs will be invoked when the statement is
stored procedure. The first ″n″ result set locator values executed, or for INSERT, UPDATE, or DELETE
are returned, where ″n″ is the number of result set statements that triggers are defined on the changed
locator variables specified on the SQL statement. table. Check the DSN_STATEMNT_TABLE or the IFCID
22 record for this statement to find the reasons this SQL
System Action: The SQL statement is successful. The
statement has been put in cost category “B”.
SQLWARN3 field is set to ’Z’.
User Response: If the warning is caused by an SQL
Programmer Response: Increase the number of
statement that is consuming too much processor
result set locator variables specified on the SQL
resource, attempt to rewrite the statement to perform
statement.
more efficiently. Another option is to ask the
SQLSTATE: 01614 administrator to increase the warning threshold value in
the RLST.
+495 ESTIMATED PROCESSOR COST OF SQLSTATE: 01616
estimate-amount1 PROCESSOR
SECONDS (estimate-amount2 SERVICE
+535 THE RESULT OF THE POSITIONED
UNITS) IN COST CATEGORY
UPDATE OR DELETE MAY DEPEND ON
cost-category EXCEEDS A RESOURCE
THE ORDER OF THE ROWS
LIMIT WARNING THRESHOLD OF limit-
amount SERVICE UNITS Explanation: A positioned update of a primary key or
a delete from a table with a self-referencing constraint
Explanation: The prepare of a dynamic INSERT,
was requested.
UPDATE, DELETE, or SELECT SQL statement resulted
in a cost estimate that exceeded the warning threshold System Action: DB2 executes the UPDATE or
value specified in the resource limit specification table DELETE statement and the contents of the table are
(RLST). This warning is also issued if DB2’s cost changed.
category value was “B”, and the default action specified
SQLSTATE: 01591
in the RLF_CATEGORY_B column in the RLST is to
issue a warning.
+541 THE REFERENTIAL OR UNIQUE
estimate_amount1
CONSTRAINT name HAS BEEN
The cost estimate (in processor seconds) if the
IGNORED BECAUSE IT IS A
prepared INSERT, UPDATE, DELETE or
DUPLICATE
SELECT statement were to be executed.
Explanation: A FOREIGN KEY clause uses the same
estimate_amount2
key and parent table as another FOREIGN KEY clause,
The cost estimate (in service units) if the
or a UNIQUE clause uses the same column list as
prepared INSERT, UPDATE, DELETE or
SELECT statement were to be executed.
| another UNIQUE or PRIMARY KEY clause. In either
case, the duplicate clause is ignored.
cost-category
name is either the foreign key name or the unique
DB2’s cost-category for this SQL statement.
constraint name.
The possible values are A or B.
System Action: DB2 continues processing.
limit-amount
The warning threshold (in service units) Programmer Response: If the duplication is an error,
specified in the RLFASUWARN column of the correct the statement and execute it again.
RLST.
SQLSTATE: 01543
System Action: The prepare of the dynamic INSERT,
UPDATE, DELETE, or SELECT statement was
successful. An SQLCODE -905 might be issued if the +551 auth-id DOES NOT HAVE THE
execution of the prepared statement exceeds the PRIVILEGE TO PERFORM OPERATION
ASUTIME value specified in the RLST. operation ON OBJECT object-name
Programmer Response: Ensure that there is Explanation: Authorization ID auth-id has attempted to
application logic to handle the warning to either allow perform the specified operation on object object-name
the statement to execute or to stop the statement from without having been granted the proper authority to do
Chapter 2. SQL Return Codes 19
+552 • +599
so. This error might also occur if the specified object System Action: The offending privilege(s) in the
does not exist, or if the object is a read-only view (for authorization specification are granted without the
UPDATE or INSERT). Additionally, the error may occur GRANT option. If the grantee is PUBLIC, all the
if auth-id is trying to create a table or view with an privileges in the authorization specification are granted
authorization ID other than its own. You may create a without the GRANT option.
table or view from an auth-id other than your own only if
SQLSTATE: 01516
your authorization ID is SYSADM, DBADM, or DBCTRL.
If this error occurs while DB2 is creating or altering a
+561 THE ALTER, INDEX, REFERENCES,
table involving referential constraints, this code reports
AND TRIGGER PRIVILEGES CANNOT
that the user does not have the necessary ALTER
BE GRANTED PUBLIC AT ALL
privilege to perform a FOREIGN KEY, DROP FOREIGN
LOCATIONS
| KEY, DROP PRIMARY KEY, or DROP UNIQUE
| operation. The object-name identifies the object table of Explanation: You specified a GRANT statement with
the CREATE or ALTER TABLE statement, not the table either an ALL or ALL PRIVILEGES keyword. ALL and
for which the user lacks the ALTER privilege. ALL PRIVILEGES imply the granting of ALTER, INDEX,
REFERENCES, AND TRIGGER privileges that cannot
System Action: A valid plan or package will be
be granted to a remote user.
created if no errors are detected. The statement is
bound dynamically on each execution of the statement. System Action: DB2 executes the GRANT statement.
However, it does not grant the ALTER, INDEX,
Programmer Response: For better performance,
REFERENCES, or TRIGGER privileges to PUBLIC*.
rebind the plan or package after correcting the
statement. To correct the statement, ensure that auth-id SQLSTATE: 01523
has been granted the authority to perform the desired
operation, that object-name exists, and that auth-id is
not trying to create a table with a different authorization +562 A GRANT OF A PRIVILEGE WAS
ID. IGNORED BECAUSE THE GRANTEE
ALREADY HAS THE PRIVILEGE FROM
SQLSTATE: 01548 THE GRANTOR
Explanation: At least one of the privileges in the
+552 auth-id DOES NOT HAVE THE GRANT statement was ignored because the privilege
PRIVILEGE TO PERFORM OPERATION was already granted to the grantee by the grantor.
operation
System Action: The privileges previously granted are
Explanation: Authorization ID 'auth-id' has attempted ignored; all others are granted.
to perform the specified 'operation' without having been
granted the authority to do so. SQLSTATE: 01560
System Action: A valid plan or package will be
created if no errors are detected. The statement is +585 THE SCHEMA NAME schema-name
bound dynamically on each execution of the statement. APPEARS MORE THAN ONCE IN THE
CURRENT PATH
Programmer Response: For better performance,
rebind the plan or package after correcting the Explanation: The current path includes schema name
statement. To correct the statement, ensure that the more than once.
authorization-ID has been granted the authority System Action: The statement is executed.
necessary to perform the desired operation.
SQLSTATE: 01625
SQLSTATE: 01542
+599 COMPARISON FUNCTIONS ARE NOT
+558 THE WITH GRANT OPTION IS CREATED FOR A DISTINCT TYPE
IGNORED BASED ON A LONG STRING DATA
Explanation: The GRANT statement contained one of TYPE
the following situations: Explanation: Comparison functions are not created for
v PUBLIC was within the list of 'grantee' authorization a distinct type based on a long string data type (BLOB,
IDs. CLOB, DBCLOB) since the corresponding function are
v BINDAGENT privilege was being granted. not available for these built-in data types.
v ANY package privilege on collection-id.* was being
granted. System Action: The statement is processed
successfully.
The WITH GRANT option may not be used in the above
situations. Programmer Response: No action is required.
20 DB2 UDB for OS/390 and z/OS: Messages and Codes
+610 • +655
SQLSTATE: 01596 | SQLSTATE: 01528
|
+610 A CREATE/ALTER ON OBJECT | +650 THE TABLE BEING CREATED OR
object-name HAS PLACED OBJECT IN | ALTERED CANNOT BECOME A
utility PENDING | DEPENDENT TABLE
| Explanation: The identified object is in one of the | Explanation: This table is defined with the maximum
| following states: | number of columns. It cannot be altered to be a
| v REBUILD pending for an index | dependent table later.
| The index is in REBUILD PENDING status because | System Action: The table is created. Check to see if
| CREATE INDEX with DEFER was specified on a | the table will become a dependent table at a later time.
| populated table. The index is not generally available | If yes, drop and recreate the table with fewer than 750
| until the index is removed from the REBUILD pending | columns.
| state.
| v REORG pending for a table space partition | SQLSTATE: 01538
| The table space is in REORG pending because |
| ALTER INDEX was used to change the limit key | +653 TABLE table-name IN PARTITIONED
| values. The table space partition is not generally | TABLESPACE tspace-name IS NOT
| available until the REORG pending status is | AVAILABLE BECAUSE ITS
| removed. | PARTITIONED INDEX HAS NOT BEEN
| v REORG pending for a table space | CREATED
| The table space is in REORG pending because | Explanation: An attempt has been made to insert or
| ALTER TABLE was used to add an identity column to | manipulate data in or create a view on a partitioned
| a populated table. The table space is not generally | table (that is, a table residing in a partitioned table
| available until the REORG pending status is | space) before the partitioned index for that table has
| removed. | been created.
| System Action: The object was placed in the | A table residing in a partitioned table space cannot be
| indicated pending status. | referenced in any SQL manipulative statement or a
| Programmer Response: The following actions may | CREATE VIEW statement before the partitioned index
| be taken: | for that table has been created.
| v For REBUILD pending on an index, use the | System Action: A valid plan or package will be
| REBUILD INDEX utility to rebuild the index and | created if no errors are detected. The statement is
| remove the REBUILD pending status. | bound dynamically on each execution of the statement.
| v For REORG pending on a table space partition, | Programmer Response: For better performance,
| perform the following steps: | rebind the plan or package after correcting the
| 1. Issue a DISPLAY DATABASE command for the | statement. To correct the statement, verify that the
| table space to identify which partitions are in | correct table was specified in the statement. If so,
| REORG pending. | ensure that the partitioned index for the table has been
| 2. Run the REORG utility on the partitions that are | created successfully before attempting to execute any
| in REORG pending. | SQL manipulative statements that reference that table.
| v For REORG pending on a table space, run the
| REORG utility on the table space. | SQLSTATE: 01551
| SQLSTATE: 01566 |
| +655 STOGROUP stogroup_name HAS
| | BOTH SPECIFIC AND NON-SPECIFIC
| +645 WHERE NOT NULL IS IGNORED | VOLUME IDS. IT WILL NOT BE
| BECAUSE THE INDEX KEY CANNOT | ALLOWED IN FUTURE RELEASES
| CONTAIN NULL VALUES
| Explanation: The CREATE/ALTER STOGROUP
| Explanation: The WHERE NOT NULL clause is | statement has caused the STOGROUP with
| ignored on the CREATE INDEX statement because the | ’stogroup_name’ to have both specific and non-specific
| index key is defined on columns that cannot contain null | (’*’) volume Ids. This warning code is used to specify
| values. | that the mixing of different types of volume Ids will not
| System Action: The option is ignored; processing | be allowed in future releases.
| continues. | System Action: DB2 continues processing.
| Programmer Response: Remove the WHERE NOT | Programmer Response: Plan to use either specific or
| NULL clause to get rid of the warning. | non-specific volume ids to avoid future release migration
Chapter 2. SQL Return Codes 21
+658 • +802
| impact. ALTER STOGROUP may be used to drop all
+799 A SET STATEMENT REFERENCES A
| specific volume ids or all non-specific volume ids. SPECIAL REGISTER THAT DOES NOT
| SQLSTATE: 01597 EXIST AT THE SERVER SITE
| Explanation: A DB2 server received a SET statement
| +658 THE SUBPAGES VALUE IS IGNORED that it does not understand.
| FOR THE CATALOG INDEX index-name
System Action: The SET SPECIAL REGISTER
| Explanation: Only SUBPAGES 1 is allowed for this request is ignored.
| catalog index. Programmer Response: This SQLCODE can be
| System Action: The index was altered successfully returned to an application for any SQL statement. This
| using SUBPAGES 1. If you are also altering the TYPE SQLCODE may be masked by other negative
| option to a new value, the index is placed in recovery SQLCODEs that the SQL statement receives.
| pending status. Processing continues at the server.
| SQLSTATE: 01600 SQLSTATE: 01527
|
| +664 THE INTERNAL LENGTH OF THE +802 EXCEPTION ERROR exception-type HAS
| LIMIT-KEY FIELDS FOR THE OCCURRED DURING operation-type
| PARTITIONED INDEX index-name OPERATION ON data-type DATA,
| EXCEEDS THE LENGTH IMPOSED BY POSITION position-number
| DB2
Explanation: The exception error exception-type
Explanation: The ALTER INDEX statement can occurred while doing an ADDITION, SUBTRACTION,
change a limit key for the partitioned index (that is, the MULTIPLICATION, DIVISION, NEGATION, or BUILT-IN
cluster index for a table residing in a partitioned table FUNCTION operation on a field whose data-type is
space), and the length of the limit key exceeds the DECIMAL, FLOAT, SMALLINT, or INTEGER. The error
permitted maximum. occurred while processing an arithmetic expression in
the SELECT list of an outer SELECT statement, and the
| DB2 restricts the internal length of the limit keys for a position in the select list is denoted by position-number.
| partitioned index to a maximum of 40 bytes. The sum of The possible exception types are FIXED POINT
| the internal lengths of the limit keys specified in the OVERFLOW, DECIMAL OVERFLOW, DIVIDE
| PART clause of the ALTER INDEX statement exceeds EXCEPTION, EXPONENT OVERFLOW, ZERO DIVIDE,
| that 40-byte maximum. The limit key was truncated to or OUT OF RANGE. The data type displayed in the
| 40 bytes. message may indicate the data type of the temporary
System Action: The specified index was altered but internal copy of the data, which may differ from the
the limit key was truncated to 40 bytes. actual column or literal data type due to conversions by
DB2.
SQLSTATE: 01540
A fixed point overflow can occur during any arithmetic
operation on either INTEGER or SMALLINT fields.
+738 DEFINITION CHANGE OF object
object_name MAY REQUIRE SIMILAR A decimal overflow exception can occur when one or
CHANGE ON READ-ONLY SYSTEMS more nonzero digits are lost because the destination
field in any decimal operation is too short to contain the
Explanation: A change was made to the definition of result.
the specified object that may also require a similar
change to any read-only shared systems. A divide exception can occur on a decimal division
operation when the quotient exceeds the specified
System Action: The statement is successfully data-field size. A zero divide exception occurs on any
executed. division by zero.
Programmer Response: Check the read-only shared An exponent overflow can occur when the result
systems that have the specified object defined, and characteristic of any floating-point operation exceeds
determine if a change must be made to the object on 127 and the result fraction is not zero, i.e. the
those systems. magnitude of the result exceeds approximately 7.2E+75.
SQLSTATE: 01530 Any of the exceptions/overflows can occur during the
processing of a built-in function. If the operation-type is
FUNCTION then the error occurred while processing
either an input, intermediate, or final value. The cause
could be that the value of a parameter is out of range.
22 DB2 UDB for OS/390 and z/OS: Messages and Codes
+806 • +2000
Note: Parts of exception-type, data-type, operation-type
+863 THE CONNECTION WAS SUCCESSFUL
, and position-number may or may not be
BUT ONLY SBCS WILL BE
returned in SQLCA, depending upon when the
SUPPORTED
error was detected.
Explanation: The target AS supports only the DB2
System Action: For each expression in error the
SBCS CCSID. The DB2 Mixed CCSID or GRAPHIC
indicator variable is set to negative two (-2) to indicate a
CCSID or both are not supported by the target AS. DB2
null value returned. The data variable is unchanged.
character data sent to the target AS must be restricted
Execution of the statement continues with all nonerror
to SBCS.
columns and expressions of the outer SELECT list
being returned. If the statement is cursor controlled then System Action: The CONNECT statement is
the CURSOR will remain open. successful. The release level of the target AS has been
placed into the SQLERRP field of the SQLCA (see DB2
Programmer Response: Examine the expression for
SQL Reference for the CONNECT statement).
which the warning occurred to see if the cause (or the
likely cause) of the problem can be determined. The Programmer Response: Do not execute any SQL
problem may be data-dependent, in which case it will be statements which pass either mixed data or graphic
necessary to examine the data that was being data as input host variables.
processed at the time the error occurred.
SQLSTATE: 01539
See the explanation of SQLCODE -405 for allowed
ranges of numeric data types.
+883 ROLLBACK TO SAVEPOINT OCCURED
SQLSTATE: 01519 WHEN THERE WERE OPERATIONS
THAT CANNOT BE UNDONE, OR AN
OPERATION THAT CANNOT BE
+806 BIND ISOLATION LEVEL RR
UNDONE OCCURRED WHEN THERE
CONFLICTS WITH TABLESPACE
WAS A SAVEPOINT OUTSTANDING
LOCKSIZE PAGE OR LOCKSIZE ROW
AND LOCKMAX 0 Explanation: The operations that are referred to are
updates (inserts into or deletes from) a created global
Explanation: The specification of isolation level RR is
temporary table. If this SQL warning code is received as
incompatible with the LOCKSIZE PAGE or LOCKSIZE
the result of a ROLLBACK TO SAVEPOINT statement,
ROW and LOCKMAX 0 specification for a table space
the rollback is performed; however, the changes that
accessed by the application. Table space locking is
were made to the temporary table are not undone. If
used to protect the integrity of the application.
this SQL warning code is received as the result of an
System Action: A valid package/plan is created if no operation to a created global temporary table, the
errors are detected. Table space locking is used. RR operation is performed; however, be advised that a
isolation level is preserved. savepoint is outstanding, and the update will not be
backed out if a rollback to the savepoint is performed.
Programmer Response: If you do not want table
space locking, use isolation level UR, CS, or RS. System Action: The SQL statement is processed.
SQLSTATE: 01553 Programmer Response: Verify that this is what you
meant.
+807 THE RESULT OF DECIMAL SQLSTATE: 01640
MULTIPLICATION MAY CAUSE
OVERFLOW
+2000 TYPE 1 INDEXES WITH SUBPAGES
Explanation: An arithmetic expression contains a GREATER THAN 1 CANNOT BECOME
decimal multiplication that may cause an overflow GROUP BUFFER POOL DEPENDENT
condition when the statement is executed. The problem IN A DATA SHARING ENVIRONMENT
may be corrected by restructuring the arithmetic
Explanation: A SUBPAGES value of greater than 1
expression so that decimal multiplication precedes
was specified on a CREATE INDEX or ALTER INDEX
decimal division or by changing the precision and scale
statement in a data sharing environment. Type 1
of the operands in the arithmetic expression. Refer to
indexes with a SUBPAGES value greater than 1 can
Chapter 2 of DB2 SQL Reference for the precision and
only be accessed in a data sharing environment in
scale of the decimal multiplication and division results.
non-group buffer pool dependent mode. Any read or
System Action: A valid package will be created if no update request that would cause the index to become
errors are detected. group buffer pool dependent will be denied with a
'resource unavailable' condition. Only type 2 indexes or
SQLSTATE: 01554 type 1 indexes with SUBPAGES 1 can become group
buffer pool dependent.
Chapter 2. SQL Return Codes 23
+20002 • +30100
System Action: The statement is successfully | DEFINE NO was specified in one of the following
executed. If ALTER INDEX was performed, then the | situations:
index is placed in recovery pending status. | v a CREATE INDEX statement that included the VCAT
| SQLSTATE: 01638 | clause
| v a CREATE INDEX statement for a non-empty table
+20002 THE GBPCACHE SPECIFICATION IS | v a CREATE LOB TABLESPACE statement
IGNORED, bpname DOES NOT ALLOW | v a CREATE TABLESPACE statement that included the
CACHING | VCAT clause
Explanation: This message is issued in response to a | System Action: DB2 ignored the DEFINE NO option
CREATE or ALTER of a table space or index is which a | and created the object with the DEFINE YES option
buffer pool is named that corresponds to a group buffer | instead.
pool that is defined with GBPCACHE NO. The
corresponding group buffer pool is used only for
| SQLSTATE: 01644
cross-invalidation. It contains no data entries. All reads
and writes are from and to DASD. +30100 OPERATION COMPLETED
SUCCESSFULLY BUT A DISTRIBUTION
System Action: The statement is processed.
PROTOCOL VIOLATION HAS BEEN
User Response: If you want to use one of the DETECTED. ORIGINAL
GBPCACHE options other than NONE, you must alter SQLCODE=original-sqlcode AND
the table space or index to use a group buffer pool that ORIGINAL SQLSTATE=original-sqlstate
is defined with GBPCACHE YES.
Explanation: The application requested operation
SQLSTATE: 01624 (either COMMIT or ROLLBACK) has completed
successfully but the response from the remote server
and the SQLCODE that was returned from the remote
+20007 USE OF OPTIMIZATION HINTS IS
server are inconsistent. For example, the reply message
DISALLOWED BY A DB2 SUBSYSTEM
from the remote server indicates that a COMMIT
PARAMETER. THE SPECIAL REGISTER
operation completed successfully but the SQLCODE
’OPTIMIZATION HINT’ IS SET TO THE
returned from the AS was negative.
DEFAULT VALUE OF BLANKS.
System Action: An alert was generated. A DSNL031I
Explanation: DB2 is not enabled to use optimization
message may have been written to the console. Refer
hints. The special register OPTIMIZATION HINT is set
to the description of this message for further
to the default value of BLANKS.
information.
System Action: Processing continues normally using
The SQLCODE returned by the remote server is
the default OPTIMIZATION HINT value. The
replaced with +30100 and the SQLSTATE returned by
user-specified optimization hints are ignored. The
the remote server is replaced with 01558.
access path is determined without the use of hints and
processing continues normally. The SQLCODE and SQLSTATE values that were
returned from the AS are stored in the SQLERRM field
Programmer Response: Enable the use of
in a string of the following format:
OPTIMIZATION HINT by changing the value of
OPTIMIZATION HINTS on the DB2 Installation panel 'original-sqlcode 'FF'X original-sqlstate'
DSNTIP4. Programmer Response: Notify the System
If, after further consideration, you do not want to use an Programmer for assistance in analyzing the trace data
OPTIMIZATION HINT, change or remove the SET that was generated.
CURRENT OPTIMIZATION HINT statement. SQLSTATE: 01558
SQLSTATE: 01602
| +20122 DEFINE NO OPTION IS NOT
| APPLICABLE IN THE CONTEXT
| SPECIFIED
| Explanation: The DEFINE NO option was specified,
| however it is not applicable in the context specified.
Error SQL codes
24 DB2 UDB for OS/390 and z/OS: Messages and Codes
-007 • -097
-007 STATEMENT CONTAINS THE ILLEGAL -079 QUALIFIER FOR DECLARED GLOBAL
CHARACTER character TEMPORARY TABLE table-name MUST
BE SESSION, NOT qualifier
Explanation: The specified 'character' is not a valid
character in SQL statements. Explanation: The qualifier for a declared temporary
table must be SESSION. The DECLARE GLOBAL
System Action: The statement cannot be executed.
TEMPORARY TABLE statement defines a new
Programmer Response: Correct the syntax and temporary table named table-name with an explicit
resubmit the statement. Refer to Chapter 2 of DB2 SQL qualifier of qualifier. Specifying a qualifier other than
Reference for information about the valid SQL character SESSION is not allowed.
set.
System Action: The statement was not executed.
SQLSTATE: 42601
Programmer Response: Change the statement in one
of the following ways:
-010 THE STRING CONSTANT BEGINNING v Change the qualifier to SESSION.
string IS NOT TERMINATED v Remove the qualifier, and let DB2 default it to
SESSION.
Explanation: The statement contains a string
constant, beginning with 'string', that is not terminated SQLSTATE: 428EK
properly.
System Action: The statement cannot be executed. -084 UNACCEPTABLE SQL STATEMENT
Programmer Response: Examine the statement for Explanation: This SQL statement is unacceptable to
missing quotation marks or apostrophes in the indicated DB2. One of the following has occurred:
string constant. v An attempt has been made to PREPARE or
SQLSTATE: 42603 EXECUTE IMMEDIATE an SQL statement that
cannot be prepared; refer to the proper SQL
statement in DB2 SQL Reference
-029 INTO CLAUSE REQUIRED v The embedded SQL statement is not an SQL
Explanation: SELECT statements embedded in an statement supported by DB2.
application program must have an INTO clause to v The statement referenced an undeclared cursor.
denote where the results of the SELECT are to be v An attempt was made to prepare an ALLOCATE
placed. Dynamic SELECT statements do not permit the CURSOR statement but the statement identifier is
INTO clause. already associated with a declared cursor.
System Action: The statement cannot be executed. System Action: The statement cannot be executed.
Programmer Response: Add the INTO clause to the Programmer Response: If the situation involves an
SELECT statement and precompile the application SQL statement that cannot be prepared, the problem is
program again. in the source of the SQL statement, not the application
SQLSTATE: 42601 program. Thus, no action is necessary unless the
source of the SQL statement is the application program
itself.
-060 INVALID type SPECIFICATION : spec
If the situation involves an SQL statement that is not
Explanation: 'type' is either LENGTH or SCALE. supported by DB2, remove it from the application
'spec' is the specified length or scale. Length or scale program and precompile again.
must be specified by an unsigned integer constant and
the value must be in the range allowed by the data If the situation involves an invalid PREPARE of an
type. ALLOCATE CURSOR statement, change the application
program to use a statement identifier that is not
System Action: The statement cannot be executed. associated with a declared cursor.
Programmer Response: Correct the statement. Refer SQLSTATE: 42612
to Chapter 2 of DB2 SQL Reference for rules for length
and scale.
-097 THE USE OF LONG VARCHAR OR
SQLSTATE: 42815 LONG VARGRAPHIC IS NOT ALLOWED
IN THIS CONTEXT
Explanation: The statement attempted to use the
LONG VARCHAR or LONG VARGRAPHIC syntax. This
syntax cannot be used for the following statements:
Chapter 2. SQL Return Codes 25
-101 • -105
v CAST syntax substituting that variable for the string literal in the SQL
v CREATE DISTINCT TYPE statement.
v CREATE FUNCTION
SQLSTATE: 54002
v CREATE PROCEDURE
v ALTER FUNCTION
v COMMENT ON FUNCTION -103 literal IS AN INVALID NUMERIC
v GRANT EXECUTE ON FUNCTION LITERAL
v REVOKE EXECUTE ON FUNCTION
| v DROP Explanation: The indicated 'literal' begins with a digit,
but is not a valid integer, decimal, or float literal.
Use the VARCHAR or VARGRAPHIC syntax specifying System Action: The statement cannot be executed.
an explicit length as required.
Programmer Response: Correct the invalid literal.
System Action: The statement cannot be executed.
SQLSTATE: 42604
Programmer Response: Correct the statement.
SQLSTATE: 42601 -104 ILLEGAL SYMBOL ″token″. SOME
SYMBOLS THAT MIGHT BE LEGAL
ARE: token-list
# -101 THE STATEMENT IS TOO LONG OR
# TOO COMPLEX Explanation: A syntax error was detected where the
symbol ″token″ occurs in the SQL statement. The list of
# Explanation: DB2 cannot process the statement
symbols that might be legal shows some alternate
# because it exceeds the system limits for length or
symbols that could possibly be correct at that point, if
# complexity. Enabling parallelism will increase the
the preceding part of the statement is entirely correct.
# complexity of the statement.
However, the preceding part of the statement might be
# System Action: DB2 cannot process the statement.
incorrect. For example, if an important keyword is
# Programmer Response: Divide the statement into omitted, DB2 detects the error later, and not always
# shorter or less complex SQL statements. immediately after the point where the keyword should
appear. The list of alternate symbols are only
# If the statement enables parallelism, try disabling
suggestions. Some of those symbols might not even be
# parallelism. You may do this by using the DEGREE(1)
legal for statements to be executed by DB2. Those
# bind option for static SQL, or by setting the CURRENT
symbols are possibly correct for statements sent to
# DEGREE special register to ’1’ for dynamic SQL.
other database management systems.
# SQLSTATE: 54001 This SQL code will also be issued if the RELEASE TO
SAVEPOINT statement is specified without a savepoint
-102 LITERAL STRING IS TOO LONG. name.
STRING BEGINS string
System Action: The statement cannot be executed.
Explanation: The string constant beginning with
Programmer Response: Correct the statement and
’string’ has a length greater than 255 characters or 124
execute it again.
graphic characters. Character strings with lengths
greater than 255 and graphic strings with lengths SQLSTATE: 42601
greater than 124 can be specified only through
assignment from host variables.
-105 INVALID STRING
For special registers, the allowable length depends on
Explanation: The statement contains an invalid string.
the particular special register. See Chapter 3 of the SQL
It is neither a character string nor a graphic string.
Reference to determine the maximum length of a value
for a special register. System Action: The statement cannot be executed.
Two consecutive string delimiters are used to represent Programmer Response: Specify the correct format of
one string delimiter within the character string, but these the string. Check for a graphic string, paired delimiters,
count as 2 bytes when calculating the lengths of the character G or N, and an even number of bytes
character string constants. within the string.
System Action: The statement cannot be executed. SQLSTATE: 42604
Programmer Response: The requested function is
not available interactively. If the error occurred in the
context of an SQL statement embedded in an
application program, the desired result can be achieved
by assigning the long string to a host variable, and
26 DB2 UDB for OS/390 and z/OS: Messages and Codes
-107 • -110
-107 THE NAME name IS TOO LONG. -108 THE NAME name IS QUALIFIED
MAXIMUM ALLOWABLE SIZE IS size INCORRECTLY
Explanation: The name is too long. The maximum Explanation: The name name is improperly qualified.
permissible length for names of that type is indicated by
A target name on the RENAME statement may not have
size.
a qualifier.
Names for the following cannot contain more than 128
System Action: The statement cannot be executed.
characters:
v Savepoint-name Programmer Response: Remove the qualifier and
reissue the statement.
Names for the following cannot contain more than 64 SQLSTATE: 42601
characters:
v Version-id
-109 clause CLAUSE IS NOT PERMITTED
Names for the following cannot contain more than 18 Explanation: The indicated clause is not permitted in
characters (20 including SQL escape characters, if the context in which it appears in this SQL statement for
present): the following reasons:
v SQL columns v A subselect cannot have an INTO clause.
v SQL tables
v A CREATE VIEW statement cannot have INTO,
v SQL views
ORDER BY, or FOR UPDATE clauses.
v SQL indexes
v SQL aliases v An embedded SELECT statement cannot have
v SQL synonyms ORDER BY or FOR UPDATE clauses
v Collection-ids v SELECT statements used in cursor declarations
v Check constraints cannot have an INTO clause.
| v Functions v A RAISE_ERROR function can only be used as a
| v Stored procedures select list item if it is cast to some data type using the
| v User-defined types CAST specification.
v DESCRIBE INPUT statement can not have USING
Names for the following cannot contain more than 16
clause.
characters:
v QUERYNO cannot be specified as part of an
v Location-name
EXPLAIN statement when the EXPLAIN statement
The following cannot contain more than 8 characters: contains an ’explainable-sql-statement’.
v Table qualifiers v The table being updated in a POSITIONED UPDATE
v View qualifiers statement cannot be assigned a correlation name.
v Library member names specified in an INCLUDE
statement If the clause is part of a CREATE INDEX, CREATE
v Storage group names TABLE, CREATE TABLESPACE or ALTER
v Database names TABLESPACE statement, see the appropriate section of
v Table space names the SQL Reference for a description of the valid use of
v Application plans clauses for the statement.
v Database request modules (DBRMs) System Action: The statement cannot be executed.
v Referential constraint names specified in CREATE or
ALTER TABLE statements Programmer Response: Correct the SQL statement.
v Package-ids
SQLSTATE: 42601
| v Schema names
| v Trigger names
-110 INVALID HEXADECIMAL LITERAL
Host variable names cannot contain more than 64
BEGINNING string
characters. Volume serial numbers cannot contain more
than 6 characters. Labels cannot contain more than 30 Explanation: The literal beginning with the specified
characters. 'string' contains one or more characters that are not
valid hexadecimal digits.
System Action: The statement cannot be processed.
System Action: The statement cannot be executed.
Programmer Response: Choose a shorter name for
the object. Programmer Response: Correct the invalid literal.
SQLSTATE: 42622 SQLSTATE: 42606
Chapter 2. SQL Return Codes 27
-111 • -114
103 DBCS blanks X’4040’ are not allowed.
-111 A COLUMN FUNCTION DOES NOT
INCLUDE A COLUMN NAME 104 There are no characters between the shift-out
and the shift-in characters.
Explanation: The specification of a column function
(AVG, MAX, MIN, or SUM) was invalid because such 105 Shift-out cannot be the first byte of the DBCS
functions must include a column name in the operand. character between the shift-out and the shift-in
In a trigger definition, a transition variable specification characters.
does not qualify as a column name for this purpose.
System Action: Processing is terminated.
System Action: The statement cannot be executed.
User Response: Correct the name.
Programmer Response: A column name must be
specified as an operand to the function. Refer to SQLSTATE: 42602
Chapter 3 of DB2 SQL Reference for information about
the proper usage of column functions. -114 THE LOCATION NAME location DOES
SQLSTATE: 42901 NOT MATCH THE CURRENT SERVER
Explanation: A 3-part SQL procedure name was
-112 THE OPERAND OF A COLUMN provided for one of the following SQL statements:
FUNCTION IS ANOTHER COLUMN ASSOCIATE LOCATORS
FUNCTION CALL
DESCRIBE PROCEDURE
Explanation: The operand of a column function can
be either an expression or DISTINCT followed by an The first part of the SQL procedure name, which
expression. The operand cannot be another column specifies the location where the stored procedure
function. resides, did not match the value of the SQL CURRENT
System Action: The statement cannot be executed. SERVER special register.
Programmer Response: Correct the function System Action: The statement cannot be executed.
specification. Refer to Chapter 3 of DB2 SQL Reference Programmer Response: Take one of these actions to
for information about the proper usage of column resolve the mismatch:
functions.
v Change the location qualifier to match the CURRENT
SQLSTATE: 42607 SERVER special register.
v Issue an SQL CONNECT to the location where the
-113 INVALID CHARACTER FOUND IN string, stored procedure resides before issuing the SQL
REASON CODE nnn statement. Ensure that the SQL CALL statement is
issued before the ASSOCIATE LOCATORS or
Explanation: The string contains an invalid character. DESCRIBE PROCEDURE.
It can be an SQL ordinary identifier name, a host
v Bind the package containing the 3-part SQL
variable name, or a DBCS comment.
procedure name with the BIND option
For SBCS SQL ordinary identifiers, names of buffer DBPROTOCOL(DRDA). With this option, DB2
pools, databases, plans, and storage groups must implicitly uses the DRDA protocol for remote access
contain only uppercase alphabetic or national to the stored procedure.
characters and numerics when CHARSET is v Correct the statements so that the exact syntax used
KATAKANA; the first character must be alphabetic or to specify the procedure name on the CALL
national. statement be the same as that on the ASSOCIATE
The following reason codes apply to SBCS identifiers: LOCATOR and/or DESCRIBE PROCEDURE. If an
unqualified name is used to CALL the procedure, the
000 An invalid character was found in the SBCS 1-part name must also be used on the other
identifier (including the case in which a DBCS statements. If the CALL statement is made with a
identifier was used where only an SBCS 3-part name, and the current server is the same as
identifier is allowed.) the location in the 3-part name, the ASSOCIATE
LOCATOR or DESCRIBE procedure can omit the
The following reason codes apply to DBCS identifiers or location.
comments:
SQLSTATE: 42961
101 An odd number of bytes exists between the
shift-out and the shift-in character.
102 Either a shift-in or shift-out character is
missing.
28 DB2 UDB for OS/390 and z/OS: Messages and Codes
-115 • -121
-115 A PREDICATE IS INVALID BECAUSE -119 A COLUMN IDENTIFIED IN A HAVING
THE COMPARISON OPERATOR CLAUSE IS NOT INCLUDED IN THE
operator IS FOLLOWED BY A GROUP BY CLAUSE
PARENTHESIZED LIST OR BY ANY OR
Explanation: A column identified in a HAVING clause
ALL WITHOUT A SUBQUERY
(possibly within a scalar function) does not appear in
Explanation: A simple comparison like '>' must not be the GROUP BY clause. Columns specified in a HAVING
followed by a list of items. ANY and ALL comparisons clause must appear within column functions or also be
must be followed by a subselect, rather than an specified in the GROUP BY clause.
expression or a list of items.
System Action: The statement cannot be executed.
System Action: The statement cannot be executed.
Programmer Response: The implied function is not
Programmer Response: Correct the SQL statement. supported by DB2. Refer to Chapter 4 of DB2 SQL
Refer to Chapter 5 of DB2 SQL Reference for Reference for information about the proper usage of
information about the syntax of SQL statements. HAVING and GROUP BY clauses.
SQLSTATE: 42601 SQLSTATE: 42803
-117 THE NUMBER OF VALUES ASSIGNED -120 A WHERE CLAUSE, SET CLAUSE,
IS NOT THE SAME AS THE NUMBER VALUES CLAUSE, OR A SET
OF SPECIFIED OR IMPLIED COLUMNS HOST-VARIABLE STATEMENT
INCLUDES A COLUMN FUNCTION
Explanation: The number of insert values in the value
list of the INSERT statement is not the same as the Explanation: A column function or a user-defined
number of object columns specified. Alternatively, the function that is sourced on a column function is not
number of values on the right side of an assignment in permitted in a SET clause, a VALUES clause, or a SET
a SET assignment statement or the SET clause of an assignment statement. A column function or a
UPDATE statement does not match the number of user-defined function that is sourced on a column
columns on the left side. function is allowed in a WHERE clause only if the
WHERE clause appears within a subquery of a HAVING
System Action: The statement cannot be executed.
clause.
No data was inserted into the object table.
System Action: The statement cannot be executed.
Programmer Response: Correct the statement to
specify one and only one value for each of the specified
Note: The 'column-name' may or may not be returned
object columns.
in SQLCA, depending on the nature of the error
SQLSTATE: 42802 occurring in the SQL statement.
Programmer Response: The implied function is not
-118 THE OBJECT TABLE OR VIEW OF THE supported by DB2. Refer to Chapter 4 of DB2 SQL
DELETE OR UPDATE STATEMENT IS Reference for information about restrictions on operands
ALSO IDENTIFIED IN A FROM CLAUSE that can be specified within WHERE, SET and VALUES
clauses and SET assignment statements.
Explanation: The table or view specified as the object
of a DELETE or UPDATE statement also appears in the SQLSTATE: 42903
FROM clause of a subselect within the statement.
The table or view that is the object of a UPDATE or -121 THE COLUMN name IS IDENTIFIED
DELETE cannot also be used to supply the values to be MORE THAN ONCE IN THE INSERT OR
inserted or to qualify the rows to be updated or deleted. UPDATE OR SET TRANSITION
VARIABLE STATEMENT
System Action: The statement cannot be executed.
No data was updated or deleted. Explanation: The same column 'name' is specified
more than once, either in the list of object columns of
Programmer Response: The implied function is not
an INSERT statement, in the SET clause of an UPDATE
supported by DB2. It may be possible to obtain the
statement, or in a SET transition variable statement.
desired result by creating a temporary copy of the
object table or view and addressing the subselect to System Action: The statement cannot be executed.
that copy. Refer to Chapter 5 of DB2 SQL Reference for No data was inserted or updated in the object table.
information about the syntax of SQL statements.
Programmer Response: Correct the syntax of the
SQLSTATE: 42902 statement so that each column name is specified only
once.
SQLSTATE: 42701
Chapter 2. SQL Return Codes 29
-122 • -128
-122 A SELECT STATEMENT WITH NO -125 AN INTEGER IN THE ORDER BY
GROUP BY CLAUSE CONTAINS A CLAUSE DOES NOT IDENTIFY A
COLUMN NAME AND A COLUMN COLUMN OF THE RESULT
FUNCTION IN THE SELECT CLAUSE
Explanation: The ORDER BY clause in the statement
OR A COLUMN NAME IS CONTAINED
contains a column number that is either less than one,
IN THE SELECT CLAUSE BUT NOT IN
or greater than the number of columns of the result
THE GROUP BY CLAUSE
table (the number of items in the SELECT clause).
Explanation: The SELECT statement contains one of
System Action: The statement cannot be executed.
these errors:
v The statement contains a column name and a Programmer Response: Correct the syntax of the
column function in the SELECT clause, but no ORDER BY clause such that each column identifier
GROUP BY clause. properly denotes a column of the result table.
v A column name is contained in the SELECT clause SQLSTATE: 42805
(possibly within a scalar function) but not in the
GROUP BY clause.
-126 THE SELECT STATEMENT CONTAINS
BOTH AN UPDATE CLAUSE AND AN
Note: A HAVING clause specified without a GROUP
ORDER BY CLAUSE
BY clause implies a GROUP BY with no
columns. Thus, no column names are allowed Explanation: The SELECT statement in the
in the SELECT clause. declaration for a cursor contains both an UPDATE
| v A sort-key-expression was specified in the ORDER clause and an ORDER BY clause. Unless you use a
| BY clause, the result table contains grouped data, but scrollable cursor, an ORDER BY clause cannot be
| the select-clause and ORDER BY clause contain a specified in the declaration for a cursor that is to be
| mixture of grouped data and non-grouped data. used for UPDATE.
System Action: The statement cannot be executed. System Action: The statement cannot be processed.
The cursor remains undefined in the application
Programmer Response: You can correct the program.
statement by:
Programmer Response: The implied function is not
v including the columns in the GROUP BY clause that
supported by DB2. A cursor that is to be used for
are in the SELECT clause, or
update cannot be defined to fetch the rows of the object
v removing the columns from the SELECT clause. table in a specific order.
Refer to Chapter 4 of DB2 SQL Reference for Refer to Chapter 4 of DB2 SQL Reference for
information about the use of GROUP BY clauses in information about restrictions on the declarations for
SQL statements. cursors to be used for update.
SQLSTATE: 42803 SQLSTATE: 42829
-123 THE PARAMETER IN POSITION n IN -127 DISTINCT IS SPECIFIED MORE THAN
THE FUNCTION name MUST BE A ONCE IN A SUBSELECT
CONSTANT OR KEYWORD Explanation: The DISTINCT qualifier can be used
Explanation: The parameter in position n in the only once in a SELECT statement or a subselect.
function name is not a constant when it is required to be System Action: The statement cannot be executed.
a constant or a keyword when it is required to be a
keyword. Programmer Response: The implied function is not
supported by DB2. Refer to Chapter 4 of DB2 SQL
System Action: The statement could not be Reference for information about restrictions on the use
processed. of the DISTINCT qualifier.
Programmer Response: Action: Ensure that each SQLSTATE: 42905
argument of the function conforms to the definition of
the corresponding parameter.
-128 INVALID USE OF NULL IN A
SQLSTATE: 42601 PREDICATE
Explanation: The use of NULL in the search condition
does not conform to the rules of SQL syntax.
System Action: The statement cannot be executed.
30 DB2 UDB for OS/390 and z/OS: Messages and Codes
-129 • -134
Programmer Response: The implied function is not
-132 AN OPERAND OF value IS NOT VALID
supported by DB2. Refer to Chapter 2 of DB2 SQL
Reference for information about the proper use of the Explanation: The operation value can be the LIKE
NULL operand. predicate, the ESCAPE clause, the LOCATE scalar
function, or the POSSTR scalar function.
SQLSTATE: 42601
| The following must be string expresions:
-129 THE STATEMENT CONTAINS TOO | v The operands appearing to the left of a LIKE or NOT
MANY TABLE NAMES | LIKE predicate
| v The operand appearing in the ESCAPE clause
Explanation: A subselect (including all subqueries)
can have a maximum of 225 references to table names. | v The first two arguments to the LOCATE function
| v The arguments to the POSSTR function
System Action: The statement cannot be executed.
| See the for the rules of what can be specified in each
Programmer Response: Break the SQL statement
| context.
into two or more simpler statements with less than 225
table references in each. The count will include the
A LIKE predicate, ESCAPE clause, LOCATE scalar
number of base table occurrences from each table or
function or POSSTR scalar function cannot be used
view on the FROM list. Refer to Chapter 4 of DB2 SQL
with DATE, TIME, or TIMESTAMP.
Reference for the definition of a subselect.
System Action: The statement cannot be processed.
SQLSTATE: 54004
Programmer Response: Check and correct the
syntax of LIKE, LOCATE, or POSSTR
-130 THE ESCAPE CLAUSE CONSISTS OF
MORE THAN ONE CHARACTER, OR SQLSTATE: 42824
THE STRING PATTERN CONTAINS AN
INVALID OCCURRENCE OF THE
ESCAPE CHARACTER -133 A COLUMN FUNCTION IN A
SUBQUERY OF A HAVING CLAUSE IS
Explanation: The ESCAPE character must be a single INVALID BECAUSE ALL COLUMN
character, either SBCS or DBCS as appropriate. For REFERENCES IN ITS ARGUMENT ARE
'column-name LIKE pattern', the ESCAPE character can NOT CORRELATED TO THE GROUP
only appear in the character string if it is followed by BY RESULT THAT THE HAVING
itself, %, or _ (underscore). The Escape Clause cannot CLAUSE IS APPLIED TO
be specified if the column name at the left of the LIKE
or NOT LIKE has the MIXED subtype. Explanation: If a column function has a correlated
column reference, it must be correlated from within a
System Action: The statement cannot be executed. HAVING clause to the GROUP BY result that the
HAVING clause is applied to. All column references in
Programmer Response: Correct the string pattern, or
the argument must satisfy this condition.
choose a different ESCAPE character and change the
pattern accordingly, or eliminate the use of the Escape System Action: The statement cannot be executed.
Clause on the LIKE or NOT LIKE predicate where the
column name to the left has the MIXED subtype. Programmer Response: Refer to Chapter 4 of DB2
SQL Reference for information about restrictions on the
SQLSTATE: 22019 if other than invalid ESCAPE syntax of the HAVING clause.
pattern. 22025 if invalid ESCAPE pattern.
SQLSTATE: 42906
-131 STATEMENT WITH LIKE PREDICATE
HAS INCOMPATIBLE DATA TYPES -134 IMPROPER USE OF LONG STRING
COLUMN column-name OR AN
Explanation: If the column name at the left of LIKE or | EXPRESSION THAT RESOLVES TO A
NOT LIKE is of type character, the expression at the | LONG STRING
right and the ESCAPE character must be of type
character. If the column name is of type graphic, the Explanation: The SQL statement references a long
expression at the right and the ESCAPE character must string, but DB2 does not allow the use of long strings in
be of type graphic. the specified context. For an exhaustive list of such
contexts, refer to “Varying Length Character Strings” in
System Action: The statement cannot be executed. Chapter 2 of DB2 SQL Reference.
Programmer Response: Check the data type of every System Action: DB2 cannot process the statement.
operand.
SQLSTATE: 42818
Chapter 2. SQL Return Codes 31
-136 • -144
Note: The column-name might not be returned in the
-138 THE SECOND OR THIRD ARGUMENT
SQLCA, depending on the nature of the error
OF THE SUBSTR FUNCTION IS OUT
and the syntax in which it occurred.
OF RANGE
Programmer Response: DB2 does not support the
Explanation: One of the following conditions exists:
requested operation on a long string value. Refer to
Chapter 2 of DB2 SQL Reference for information about v The second argument of the SUBSTR function is less
restrictions on the specification and manipulation of long than 1 or greater than M.
string values. v The third argument of the SUBSTR function is an
integer constant 0 or an expression whose value is
SQLSTATE: 42907
less than 0 or greater than M−N+1.
M is the length of the first argument, if it is of
-136 SORT CANNOT BE EXECUTED
fixed-length, or M is the maximum length of the first
BECAUSE THE SORT KEY LENGTH IS
argument, if it is of varying-length. N is the value of the
GREATER THAN 4000 BYTES
second argument.
Explanation: A sort key is derived from the list of
System Action: The statement cannot be executed.
columns specified following a DISTINCT qualifier, or in
an ORDER BY or GROUP BY clause. If both a Programmer Response: Ensure that the second and
DISTINCT qualifier and an ORDER BY or GROUP BY third arguments of the SUBSTR function have legal
clause are present, the sort key is derived from the values according the above rules.
combination of both lists of columns.
SQLSTATE: 22011
The internal length of the sort key cannot exceed 4000
bytes. In attempting to process the SQL statement, the
-142 THE SQL STATEMENT IS NOT
internal length of the sort key derived from the
SUPPORTED
DISTINCT and/or ORDER BY or GROUP BY
specifications was found to exceed that 4000-byte Explanation: An SQL statement was detected that is
maximum. not supported by the database. The statement might be
valid for other IBM relational database products or it
System Action: The statement cannot be executed.
might be valid in another context. For example,
Programmer Response: The statement must be statements such as VALUES and SIGNAL SQLSTATE
modified such that the internal length of the sort key will can appear only inside a trigger.
not exceed 4000 bytes. In general, this means that one
System Action: The statement cannot be executed.
or more column names must be deleted from the
ORDER BY or GROUP BY clause, or the list following Programmer Response: Change the syntax of the
the DISTINCT qualifier. SQL statement or remove the statement from the
program.
SQLSTATE: 54005
SQLSTATE: 42612
-137 THE LENGTH RESULTING FROM
operation IS GREATER THAN -144 INVALID SECTION NUMBER number
maximum-length
Explanation: One of the following:
Explanation: The length of the result of concatenation 1. The user attempted to execute an invalid section.
or a function exceeds the defined maximum. The
operation that resulted in the error is operation. 2. This release of DB2 does not support the SQL
statement.
v For concatenation, the length cannot exceed 32,764
(if character operands) or 16,382 (if graphic 3. The section number in the call parameter list is one
operands). of these:
v Negative
v For other functions, see DB2 SQL Reference for the v An invalid duplicate
maximum result length. v Greater than the maximum section number of the
System Action: The statement cannot be executed. DBRM or package.
Programmer Response: Ensure that the length of the System Action: The statement is not executed.
result does not exceed the defined maximum. Programmer Response: For case 1: If you are
SQLSTATE: 54006 executing a package that was bound with
SQLERROR(CONTINUE), determine whether the
statement in question was bound as a valid section. You
can use the following statements to query the DB2
catalog:
32 DB2 UDB for OS/390 and z/OS: Messages and Codes
-147 • -150
SELECT SQLERROR SQLSTATE: 42809
FROM SYSIBM.SYSPACKAGE
WHERE COLLID = collection-id AND
NAME = package-id AND -148 THE SOURCE TABLE source-name
VERSION = version-name; CANNOT BE RENAMED OR ALTERED
Explanation: Possible cases:
If that query returns ’C’, the package was bound with
SQLERROR(CONTINUE). 1 The RENAME statement cannot be used to
SELECT STMTNO, TEXT rename a view, an active RLST table, or a
FROM SYSIBM.SYSPACKSTMT table for which a synonym is defined.
WHERE COLLID = collection-id AND 2 The ALTER statement cannot be used to alter
NAME = package-id AND
the length of the column because the column is
VERSION = version-name AND
SECTNO = number AND referenced in a referential integrity relation, a
BINDERROR = 'Y'; user exit (field procedure, edit procedure, valid
procedure, stored procedure or user defined
If that query returns any rows, the section is invalid. function), a global temporary table, or a table
Refer to the error messages issued during the bind to defined with data capture changes. If the table
determine the cause. Correct any errors and bind the name specified in the alter is a view or if there
package again, using the REPLACE option. exists a row in SYSVIEWDEP that has
source-name as a base table name, then this
ALTER statement will fail.
For case 2: If the DB2 system has fallen back to a
previous release, determine whether there are any SQL System Action: The statement cannot be executed.
statements with a section number of zero that are not
supported by that release. You can use the following Programmer Response: For case:
statements to query the DB2 catalog. 1 Drop all views, inactivate the RLST table, or
drop the synonym.
When executing from a DBRM, use:
2 Avoid referential integrity relations, user exits,
SELECT * or global temporary tables.
FROM SYSIBM.SYSSTMT
WHERE SECTNO = 0 3 Run REORG INDEX, REORG TABLESPACE,
ORDER BY NAME, PLNAME, STMTNO, SEQNO; or REBUILD INDEX. If the index is partitioned,
then run the utility on all the partitions. Reissue
When executing from a package, use: the statement.
SELECT * SQLSTATE: 42809
FROM SYSIBM.SYSPACKSTMT
WHERE SECTNO = 0
ORDER BY COLLID, NAME, VERSION, STMTNO, SEQNO; -150 THE OBJECT OF THE INSERT,
DELETE, OR UPDATE STATEMENT IS
For case 3: Examine the application to determine A VIEW OR TRANSITION TABLE FOR
whether the call parameter list was changed in some WHICH THE REQUESTED OPERATION
way. In general, you should not attempt to change the IS NOT PERMITTED
output of the precompiler.
Explanation: One of the following occurred:
SQLSTATE: 58003 v A transition table was named in an INSERT,
UPDATE, or DELETE statement in a triggered action.
-147 ALTER FUNCTION function-name Transition tables are read-only.
FAILED BECAUSE SOURCE v
FUNCTIONS CANNOT BE ALTERED The view named in the INSERT, UPDATE, or
Explanation: The function cannot be altered because DELETE statement is defined in such a way that the
it is a source function. Only external scalar functions, or requested insert, update, or delete operation cannot
external table functions can be altered. be performed upon it.
Inserts into a view are prohibited if:
To change an existing source function, you must DROP
the function and recreate it. – The view definition contains a join, a GROUP BY,
or a HAVING clause.
System Action: The statement cannot be executed.
– The SELECT clause in the view definition contains
Programmer Response: Change the statement to the DISTINCT qualifier, an arithmetic expression,
refer to a function that can be altered, or recreate the a string expression, a built-in function, or a
function by dropping it and then creating a new version constant.
of it.
Chapter 2. SQL Return Codes 33
-151 • -153
– Two or more columns of the view are derived from | Individual columns in a view cannot be updated for one
the same column. | of the following reasons:
– A base table of the view contains a column that | v The column is derived from an SQL function, an
does not have a default value and is not included | arithmetic expression, or a constant.
in the view. | v The column is defined for a column of an underlying
| view that cannot be updated.
Updates to a view are prohibited if:
| v The column is defined for a read-only view.
– The view definition contains a join, a GROUP BY,
| v The column is defined for a column that is in the
or a HAVING clause.
| partitioning key of a partitioned table.
– The SELECT clause in the view definition contains
the DISTINCT qualifier or a function. | System Action: The statement cannot be executed.
| No data was updated in the object table or view.
Also, a given column in a view cannot be updated | Programmer Response: The requested function is
(that is, the values in that column cannot be updated) | not supported by DB2. Refer to the description of the
if the column is derived from an arithmetic | UPDATE statement in Chapter 5 of DB2 SQL Reference
expression, a constant, a column that is part of the | for information about restrictions on the ability to update
key of a partitioned index, or a column of a catalog | ROWID columns, identity columns, and columns in
table that cannot be updated. | partitioned tables and views.
Deletes against a view are prohibited if: | SQLSTATE: 42808
– The view definition contains a join, a GROUP BY,
or a HAVING clause. -152 THE DROP clause CLAUSE IN THE
– The SELECT clause in the view definition contains ALTER STATEMENT IS INVALID
the DISTINCT qualifier or a built-in function. BECAUSE constraint-name IS A
constraint-type
System Action: The statement cannot be executed.
No data was inserted, updated, or deleted. | Explanation: The DROP clause of an ALTER TABLE
| statement tried to drop a constraint that does not match
Programmer Response: The requested function | the constraint-type in the DROP clause. clause must
cannot be performed on the view. Refer to Chapter 5 of | identify an appropriate constraint-type as follows:
DB2 SQL Reference for further information regarding
inserting, deleting, and updating views. | REFERENTIAL CONSTRAINT
| The identified constraint must be a referential
If the error occurred on a CREATE TRIGGER | constraint.
statement, remove the INSERT, UPDATE, or DELETE
reference to the transition table. | CHECK CONSTRAINT
| The identified constraint must be a check
SQLSTATE: 42807 | constraint.
| PRIMARY KEY CONSTRAINT
| -151 THE UPDATE STATEMENT IS INVALID | The identified constraint must be a primary key
| BECAUSE THE CATALOG | constraint.
| DESCRIPTION OF COLUMN
| column-name INDICATES THAT IT | UNIQUE KEY CONSTRAINT
| CANNOT BE UPDATED | The identified constraint must be a unique key
| constraint.
| Explanation: The specified column cannot be updated
| for one of the following reasons: | System Action: The ALTER TABLE DROP statement
cannot be executed. No object was dropped.
| v The values for columns occurring in the partitioning
| key of a partitioned table cannot be updated. Programmer Response: Drop the existing object with
| v The object table is a view and the specified column is the correct DROP clause of the ALTER TABLE
| defined (in the definition of the view) in such a way statement.
| that it cannot be updated. SQLSTATE: 42809
| v The object table is a catalog table with no columns
| that can be updated.
-153 THE STATEMENT IS INVALID
| v The object column is a ROWID column. BECAUSE THE VIEW OR TABLE
| v The object column is defined with the AS IDENTITY DEFINITION DOES NOT INCLUDE A
| and GENERATED ALWAYS attributes. UNIQUE NAME FOR EACH COLUMN
| v The specified column of catalog tables cannot be Explanation: You must specify a list of column names
| updated because the column itself is not updatable. if the result table of the subselect that is specified in the
34 DB2 UDB for OS/390 and z/OS: Messages and Codes
-154 • -159
CREATE VIEW or DECLARE GLOBAL TEMPORARY statement. A FOREIGN KEY clause must identify a
TABLE statement has duplicate column names or an table.
unnamed column (a column from a constant, function,
System Action: The statement cannot be executed.
or expression).
Programmer Response: Correct the statement to
System Action: The statement cannot be executed.
specify a table name in the foreign key clause.
The specified view was not created, or the declared
temporary table was not declared. SQLSTATE: 42810
Programmer Response: Correct the statement by
providing a list of names for the columns of the view. -158 THE NUMBER OF COLUMNS
Refer to Chapter 5 of DB2 SQL Reference for SPECIFIED FOR THE VIEW IS NOT THE
information about the syntax of the CREATE VIEW SAME AS THE NUMBER OF COLUMNS
statement or the DECLARE GLOBAL TEMPORARY SPECIFIED BY THE SELECT CLAUSE,
TABLE statement. OR THE NUMBER OF COLUMNS
SPECIFIED IN THE CORRELATION
SQLSTATE: 42908
CLAUSE IN A FROM CLAUSE IS NOT
THE SAME AS THE NUMBER OF
-154 THE STATEMENT FAILED BECAUSE COLUMNS IN THE CORRESPONDING
VIEW OR TABLE DEFINITION IS NOT TABLE, VIEW, TABLE EXPRESSION,
VALID OR TABLE FUNCTION
Explanation: The view defined in the CREATE VIEW Explanation: There are two cases:
statement or the table declared in the DECLARE v The number of column names specified for a view in
GLOBAL TEMPORARY TABLE statement is not valid a CREATE VIEW statement must equal the number
because the view or table definition contains one of the of elements (column names, SQL functions,
following: expressions, etc.) specified in the following AS
v UNION or UNION ALL SELECT clause.
v a reference to a remote object v The number of column names specified in a
correlation clause must equal the number of columns
System Action: The statement cannot be executed.
in the corresponding table, view, table expression or
The specified object is not defined.
table function.
Programmer Response: Refer to Chapter 5 of DB2
System Action: The statement cannot be executed.
SQL Reference for information about restrictions on the
definitions for views or declared temporary tables. Programmer Response: Correct the syntax of the
statement to specify a column name for each column in
SQLSTATE: 42909
the corresponding object (table, view, etc.). Refer to
Chapter 5 of DB2 SQL Reference for information about
-156 THE STATEMENT DOES NOT IDENTIFY the syntax of the statement.
A TABLE
SQLSTATE: 42811
Explanation: The statements ALTER TABLE, DROP
TABLE, LOCK TABLE, CREATE INDEX, and CREATE
-159 DROP OR COMMENT ON object
TRIGGER apply only to tables. Indexes and triggers can
IDENTIFIES A(N) object-type1 RATHER
be defined only on tables.
THAN A(N) object-type2
System Action: The statement cannot be executed.
Explanation: The object specified in the DROP VIEW
The specified view or remote object was not altered,
statement, DROP ALIAS statement, or COMMENT ON
dropped, or locked, or the index or trigger was not
ALIAS statement identifies a table instead of a view or
created.
an alias.
Programmer Response: Verify that the proper name
The DROP VIEW statement can have only a view as its
was specified in the statement.
object. The DROP ALIAS or COMMENT ON ALIAS
SQLSTATE: 42809 statement can have only an alias as its object. You must
use the DROP TABLE statement to drop a table that is
neither a view nor an alias. You must use the
-157 ONLY A TABLE NAME CAN BE COMMENT ON TABLE statement to comment on a
SPECIFIED IN A FOREIGN KEY table or view.
CLAUSE. object-name IS NOT THE
NAME OF A TABLE. System Action: The statement cannot be executed.
Explanation: The indicated object was identified in a Programmer Response: Correct the DROP VIEW,
FOREIGN KEY clause of a CREATE or ALTER TABLE DROP ALIAS, or COMMENT ON ALIAS statement so
Chapter 2. SQL Return Codes 35
-160 • -173
that the view name or the alias name is specified | an authorization ID that holds 'SYSADM' or 'DBADM'
correctly (with the proper qualifier). If you intended to authority can create views for other authorization IDs.
drop or comment on the specified table, use the DROP | The DBADM privilege should be granted on any of the
TABLE or COMMENT ON TABLE statement. | databases that contain at least one of the tables on
| which this CREATE VIEW is based.
SQLSTATE: 42809
SQLSTATE: 42502
-160 THE WITH CHECK OPTION CANNOT
BE USED FOR THE SPECIFIED VIEW -170 THE NUMBER OF ARGUMENTS
SPECIFIED FOR function-name IS
Explanation: The WITH CHECK OPTION does not
INVALID
apply to a view definition under either of the following
circumstances: Explanation: An SQL statement includes the scalar
v The view is read-only (for example, the view function 'function-name' with either too many or too few
definition includes DISTINCT GROUP BY, or JOIN). arguments.
v The view definition includes a subquery. System Action: The statement cannot be executed.
System Action: The statement cannot be executed. Programmer Response: Correct the statement. Refer
The specified view was not created. to Chapter 3 of DB2 SQL Reference for information
about the number of arguments required by the scalar
Programmer Response: Refer to Chapter 5 of DB2
function 'function-name'.
SQL Reference for rules regarding use of the WITH
CHECK OPTION in view definitions. SQLSTATE: 42605
SQLSTATE: 42813
-171 THE DATA TYPE, LENGTH, OR VALUE
OF ARGUMENT nn OF function-name IS
-161 THE INSERT OR UPDATE IS NOT
INVALID
ALLOWED BECAUSE A RESULTING
ROW DOES NOT SATISFY THE VIEW Explanation: Either the data type, the length or the
DEFINITION value of argument nn of scalar function function-name is
incorrect.
Explanation: The WITH CHECK OPTION applies to
the view that is the object of the INSERT or UPDATE If the encoding scheme is EBCDIC or ASCII, a possible
statement. Consequently, all attempts to insert or reason for this error is that a character argument was
update rows in that view are checked to ensure that the specified for a built-in function that expects a graphic
results will conform to the view definition. argument, or a graphic argument was specified for a
| built-in function that expects a character argument. The
System Action: The statement cannot be executed.
| UNICODE encoding scheme does support the mixing of
No inserts or updates were performed, and the contents
| character and graphic arguments.
of the object view (and underlying base table) remain
unchanged. System Action: The statement cannot be executed.
Programmer Response: Examine the view definition Programmer Response: Correct the statement. Refer
to determine why the requested INSERT or UPDATE to Chapter 3 of DB2 SQL Reference for rules for each
was rejected. Note that this may be a data-dependent argument of the scalar function function-name.
condition.
SQLSTATE: 42815
SQLSTATE: 44000
-173 UR IS SPECIFIED ON THE WITH
-164 auth-id1 DOES NOT HAVE THE CLAUSE BUT THE CURSOR IS NOT
PRIVILEGE TO CREATE A VIEW WITH READ-ONLY
QUALIFICATION authorization-ID
Explanation: The cursor is not a read-only cursor.
Explanation: The authorization ID auth-id1 does not WITH UR can be specified only if DB2 can determine
have the authority necessary to create views with that the cursor is read-only.
qualifiers other than its own authorization ID.
System Action: Statement execution fails.
Specifically, the attempt to create a view with qualifier
authorization-ID is rejected. Programmer Response: If the cursor is intended to
be read-only but is ambiguous, add the FOR FETCH
System Action: The statement cannot be executed.
ONLY clause. If the cursor is updateable, change the
The specified view was not created.
isolation level specified on the WITH clause.
Programmer Response: Do not attempt to create
SQLSTATE: 42801
views with other than your own ID as a qualifier. Only
36 DB2 UDB for OS/390 and z/OS: Messages and Codes
-180 • -184
-180 THE DATE, TIME, OR TIMESTAMP Table 2. (continued)
VALUE value IS INVALID Datetime Numeric Range
Explanation: The length or string representation of a Hours 0 to 24 (If hour is
DATE, TIME, or TIMESTAMP value does not conform to 24, other parts of
any valid format. time values are
zeroes. If hour is
The value can contain one of the following:
USA, maximum
v For a host variable, the position number of the input hour is 12.)
host variable. If the position number cannot be
determined, a blank is displayed. Minutes 0 to 59
v For a character string constant, the character string Seconds 0 to 59
constant. The maximum length that is displayed is
Microseconds 0 to 999999
the length of SQLERRM.
v For a character column, the column name. If the
column is a VIEW column and it has a corresponding System Action: The statement cannot be executed.
base column, the VIEW column name is displayed. If
Programmer Response: Check whether the value is
the column is a VIEW column but it does not have a
within the valid range and is in the proper format. Refer
corresponding base column, a string of ’*N’ is
to Chapter 2 of DB2 SQL Reference for information on
displayed.
string data formats.
Otherwise, value is a string of '*N'.
SQLSTATE: 22007
System Action: The statement cannot be executed.
Programmer Response: Correct the program to -182 AN ARITHMETIC EXPRESSION WITH A
ensure the specified value conforms to the syntax of DATETIME VALUE IS INVALID
DATE, TIME, and TIMESTAMP. Refer to Chapter 2 of
Explanation: The specified arithmetic expression
DB2 SQL Reference for a list of valid DATE and TIME
contains an improperly used datetime value or labeled
formats.
duration.
SQLSTATE: 22007
System Action: The statement cannot be executed.
Programmer Response: Correct the indicated
-181 THE STRING REPRESENTATION OF A
arithmetic expression.
DATETIME VALUE IS NOT A VALID
DATETIME VALUE SQLSTATE: 42816
Explanation: The string representation of a datetime
is not in the acceptable range or is not in the correct -183 AN ARITHMETIC OPERATION ON A
format. The proper ranges for datetime values are as DATE OR TIMESTAMP HAS A RESULT
follows: THAT IS NOT WITHIN THE VALID
RANGE OF DATES
Table 2.
Explanation: The result of an arithmetic operation is a
Datetime Numeric Range
date or timestamp that is not within the valid range of
Years 0001 to 9999 dates which are between 0001-01-01 and 9999-12-31.
Months 1 to 12 System Action: The statement cannot be executed.
Days April, June, 1 to 30 Programmer Response: Examine the SQL statement
September, to see if the cause of the problem can be determined.
November (months The problem may be data-dependent, in which case it
4, 6, 9, 11) will be necessary to examine the data that was
processed at the time the error occurred.
February (month 2) 1 to 28 (Leap
year 1 to 29) SQLSTATE: 22008
January, March, 1 to 31
May, July, August, -184 AN ARITHMETIC EXPRESSION WITH A
October, December DATETIME VALUE CONTAINS A
(months 1, 3, 5, 7, PARAMETER MARKER
8, 10, 12)
Explanation: The specified arithmetic expression
contains a parameter marker improperly used with a
datetime value.
Chapter 2. SQL Return Codes 37
-185 • -189
System Action: The statement cannot be executed. Programmer Response: For CURRENT TIMEZONE,
check that the MVS parameter PARMTZ is between −24
Programmer Response: Correct the indicated
and +24 hours. For the other CURRENT special
arithmetic expression.
registers, check that the MVS TOD clock has been set
SQLSTATE: 42610 correctly.
SQLSTATE: 22506
-185 THE LOCAL FORMAT OPTION HAS
BEEN USED WITH A DATE OR TIME
-188 THE STRING REPRESENTATION OF A
AND NO LOCAL EXIT HAS BEEN
NAME IS INVALID
INSTALLED
Explanation: The host variable referenced in the
Explanation: The local format option has been used
DESCRIBE statement does not contain a valid string
with a datetime value and no datetime exit has been
representation of a name. One of the following error
installed. This may occur if the LOCAL DATE LENGTH
conditions has occurred.
or LOCAL TIME LENGTH on the Installation Application
Programming Defaults Panel indicated that an exit for v The first byte of the variable is a period or a blank.
datetime was supplied, but in fact the exit supplied by v The number of identifiers is greater than 3.
DB2 was not replaced. This may also occur if the v An identifier is too long.
datetime exit was replaced and the corresponding
v A period not contained in a delimited identifier is
LOCAL DATE LENGTH or LOCAL TIME LENGTH on
followed by a period or a blank.
the Installation Application Programming Defaults Panel
was not set to a nonzero value. v A delimited identifier is followed by a character other
than a period or a blank.
System Action: The statement cannot be executed.
v A delimited identifier is not terminated by a quotation
Programmer Response: Contact the system mark.
programmer about installation of the date or time exit.
System Action: The statement cannot be executed.
SQLSTATE: 57008
Programmer Response: Correct the value of the host
variable so that it is a valid string representation of a
-186 THE LOCAL DATE LENGTH OR LOCAL name.
TIME LENGTH HAS BEEN INCREASED
SQLSTATE: 22503
AND EXECUTING PROGRAM RELIES
ON THE OLD LENGTH
-189 CCSID ccsid IS UNKNOWN OR INVALID
Explanation: The local format option has been used
FOR THE DATA TYPE OR SUBTYPE
with a datetime value and DB2 has discovered that the
datetime exit routine has been changed to produce a Explanation: To determine the subtype of an input
longer local format. host variable or result column, the SYSSTRINGS
catalog table was accessed with the specified CCSID
System Action: The statement cannot be executed.
and:
Programmer Response: If the statement receiving v The CCSID is not a value of either INCCSID or
this error is embedded in the application program, then OUTCCSID, or
a REBIND command must be issued for the application
v The TRANSTYPE column classifies the CCSID as
plan. If the statement was dynamic SQL, then the
GRAPHIC rather than CHARACTER, or
statement can be reentered.
v A graphic CCSID has not been specified on your
SQLSTATE: 22505 system.
-187 A REFERENCE TO A CURRENT This error can occur when SYSSTRINGS is accessed
DATE/TIME SPECIAL REGISTER IS with a pair of CCSIDs to determine if a translation is
INVALID BECAUSE THE MVS TOD defined for the pair. In this case, the error is the
CLOCK IS BAD OR THE MVS PARMTZ inconsistency between the data type of a string and the
IS OUT OF RANGE TRANSTYPE classification of its CCSID (one is
GRAPHIC and the other is CHARACTER).
Explanation: DB2 has encountered an invalid
time-of-day (TOD) clock. The user referenced one of the This error can also occur when a CCSID specified in
special registers: CURRENT DATE, CURRENT TIME, DECP does not exist as a value in the INCCSID or
CURRENT TIMESTAMP, or CURRENT TIMEZONE. If OUTCCSID columns of SYSSTRINGS.
the user referenced CURRENT TIMEZONE, the MVS
parameter PARMTZ was out of range.
System Action: The statement cannot be executed.
38 DB2 UDB for OS/390 and z/OS: Messages and Codes
-190 • -199
Another reason this error can occur is that you may be SQLSTATE: 22504
using one of the graphic built-in functions but a graphic
CCSID was not specified during system installation.
-197 QUALIFIED COLUMN NAMES IN
System Action: The statement cannot be bound or ORDER BY CLAUSE NOT PERMITTED
executed. WHEN UNION OR UNION ALL
SPECIFIED
Programmer Response: Ensure that the CCSSID is
valid and consistent with the data type of the string. If a Explanation: A SELECT statement that specifies both
valid CCSID is not listed in a built-in row of the union of two or more tables and the ORDER BY
SYSSTRINGS, it can be defined by inserting a clause cannot use qualified column names in the
user-provided row. If a valid CCSID is misclassified in a ORDER BY clause.
user-provided row, that row can be updated to correct
Programmer Response: Change the statement so
the mistake. Refer to the appendices of DB2 Installation
that qualified names are not necessary in the ORDER
Guide for more information on CCSIDs and to DB2 SQL
BY clause.
Reference for more information on the SYSSTRINGS
catalog table. System Action: The statement is not executed.
If a graphic CCSID had not been specified at system SQLSTATE: 42877
installation, update your DECP to include a graphic
CCSID and recycle your DB2.
-198 THE OPERAND OF THE PREPARE OR
SQLSTATE: 22522 EXECUTE IMMEDIATE STATEMENT IS
BLANK OR EMPTY
-190 ATTRIBUTES OF COLUMN Explanation: The operand (host variable or literal
column-name IN TABLE table-name ARE string) that was the object of the PREPARE or
NOT COMPATIBLE WITH THE EXECUTE IMMEDIATE statement either contained all
EXISTING COLUMN blanks or was an empty string. A DBRM built in Version
2 Release 3 cannot be used on a Version 2 Release 2
Explanation: The attributes specified for the column of
system if the distributive functions were used. If this
the specified table in an ALTER statement are not
error appears on Version 2 Release 2 and the DBRM
compatible with the attributes of the existing column.
was built on Version 2 Release 3,the program needs to
Either the data type or length is not valid:
be precompiled again to correct the problem.
v The new altered length for the column is of different
length than the current length of the column. System Action: The statement cannot be executed.
v The existing column is not a VARCHAR data type.
Programmer Response: Correct the logic of the
System Action: The ALTER statement cannot be application program to ensure that a valid SQL
executed. statement is provided in the operand of the PREPARE
or EXECUTE IMMEDIATE statement before that
Programmer Response: Specify attributes that are
statement is executed.
compatible with the existing column.
SQLSTATE: 42617
SQLSTATE: 42837
-199 ILLEGAL USE OF KEYWORD keyword.
-191 A STRING CANNOT BE USED
TOKEN token-list WAS EXPECTED
BECAUSE IT IS INVALID MIXED DATA
Explanation: A syntax error was detected in the
Explanation: The operation required the translation of
statement at the point where the keyword 'keyword'
a mixed data character string to a different coded
appears.
character set. The string could not be translated
because it does not conform to the rules for well-formed As an aid to the programmer, a partial list of valid
mixed data. For example, the string contains EBCDIC tokens is provided in SQLERRM as 'token-list'. Only
shift codes that are not properly paired. those tokens that will fit are listed. Some tokens in the
list might not be valid in statements to be executed by
System Action: The statement cannot be executed.
DB2; those tokens are valid for sending to other
Programmer Response: If the string contains the database management systems.
intended information, the description of the column or
System Action: The statement cannot be executed.
host variable should be changed from MIXED DATA to
BIT or SBCS DATA. If the description of the column or Programmer Response: Examine the statement in
host variable is correct, the string is the problem and it the area of the indicated keyword. A colon or SQL
must be changed to conform to the rules for well-formed delimiter might be missing.
mixed data. For more information about well-formed
MIXED DATA refer to Chapter 2 of DB2 SQL Reference. SQLSTATE: 42601
Chapter 2. SQL Return Codes 39
-203 • -206
table names are specified correctly (including any
-203 A REFERENCE TO COLUMN
required qualifiers) in the SQL statement.
column-name IS AMBIGUOUS
SQLSTATE: 42703
Explanation: An unqualified column name is
ambiguous if more than one table or view identified in
the FROM clause has a column with that name, or if -206 column-name IS NOT A COLUMN OF AN
more than one column of a nested table expression has INSERTED TABLE, UPDATED TABLE,
that name. OR ANY TABLE IDENTIFIED IN A FROM
CLAUSE, OR IS NOT A COLUMN OF
A qualified column name is ambiguous only if the
THE TRIGGERING TABLE OF A
qualifier is the correlation name for a nested table
TRIGGER
expression and the column name is not unique.
Explanation: This return code is used to report one of
A reference to a column of the triggering table in a
the following errors:
CREATE TRIGGER statement is ambiguous if it does
not use the correlation name to indicate if it refers to the v In the case of an INSERT or UPDATE statement, the
old or new transition variable. specified column is not a column of the table or view
that was specified as the object of the insert or
System Action: The statement cannot be executed. update.
Programmer Response: If the problem is caused by v In the case of an INSERT with VALUES clause, there
a nonunique column name in a nested table expression, is a column referenced and columns are not allowed
change the nested table expression so that the column in the VALUES clause.
name is unique. If the problem is caused by the use of v In the case of a SELECT or DELETE statement, the
an unqualified name, qualify it with a table, view, or specified column is not a column of any of the tables
correlation name. or views identified in a FROM clause in the
SQLSTATE: 42702 statement.
v There is a correlated reference in the GROUP BY
clause in the select list of a subselect, or a correlated
-204 name IS AN UNDEFINED NAME
reference is not used in a search condition.
Explanation: A routine was invoked. The routine v There is an unresolved qualified reference in
invocation was not accepted because of DB2 reason HAVING.
code rc.
v For a CREATE TRIGGER statement:
name The name of the routine that was invoked. – A reference is made to a column using an OLD or
rc The DB2 reason code describing the cause of NEW correlation name. The column name is not
the failure. Possible values are: 00E79000, defined in the triggering table.
00E79001, 00E79002, 00E79003, 00E79004, – The left side of an assignment in the SET
00E79005, 00E79006, 00E79007, 00E7900B, transition-variable statement in the triggered action
00E7900C. specifies an old transition variable where only a
new transition variable is supported or trigger was
System Action: The statement cannot be executed. not created.
Programmer Response: Verify that the object name System Action: The statement cannot be executed.
was correctly specified in the SQL statement, including No data was retrieved, inserted, or updated or the
any required qualifiers. If it is correct, ensure that the trigger was not created.
object exists in the system before resubmitting the
statement. Programmer Response: Verify that the column and
table names are specified correctly in the SQL
For missing a data type or function in the SOURCE statement. In the case of a SELECT statement, check
clause, it may be that the object does not exist, OR it to be sure that all of the required tables were named in
may be that the object does exist in some schema, but the FROM clause.
the schema is not present in your current path.
In the case of a CREATE TRIGGER statement, ensure
SQLSTATE: 42704 that only new transition variables are specified on the
left side of assignments in the SET transition-variable
-205 column-name IS NOT A COLUMN OF statement and that any reference to columns of the
TABLE table-name triggering table are qualified with a transition variable
correlation name.
Explanation: No column with the specified
'column-name' occurs in the table or view 'table-name'. SQLSTATE: 42703
System Action: The statement cannot be executed.
Programmer Response: Verify that the column and
40 DB2 UDB for OS/390 and z/OS: Messages and Codes
-208 • -220
System Action: The statement cannot be executed.
-208 THE ORDER BY CLAUSE IS INVALID
BECAUSE COLUMN name IS NOT Programmer Response: Modify the select-statement
PART OF THE RESULT TABLE based on the reason specified by the reason-code as
follows:
Explanation: The statement is invalid because a
column ('name') specified in the ORDER BY list does | v 1 - Remove the expression from the ORDER BY
not appear in the result table (that is, it is not specified | clause. If attempting to reference a column of the
in the SELECT-list). Only columns in the result table can | result, change the sort key to the simple-integer or
be used to order that result when the fullselect of the | simple-column-name form. See the ORDER BY
select-statement is not a subselect. | syntax diagram in the DB2 SQL Reference for more
| information.
System Action: The statement cannot be executed.
v 2 - Remove DISTINCT from the select clause.
Programmer Response: Correct the syntax of the
SQLSTATE: 42822
statement, either by adding the specified column to the
result table, or deleting it from the ORDER BY clause.
Refer to Chapter 4 of DB2 SQL Reference for | -216 THE NUMBER OF ELEMENTS ON
information about restrictions on the use of the ORDER | EACH SIDE OF A PREDICATE
BY clause to order the result of an SQL SELECT. | OPERATOR DOES NOT MATCH.
| PREDICATE OPERATOR IS operator.
SQLSTATE: 42707
| Explanation: The number of expressions specified on
| the left-hand side of OPERATOR operator is unequal to
-212 name IS SPECIFIED MORE THAN
| either the number of values returned by the fullselect or
ONCE IN THE REFERENCING CLAUSE
| to the number of expressions specified on the
OF A TRIGGER DEFINITION
| right-hand side of the operator. The number of
Explanation: The REFERENCING clause of a | expressions and the number of values/expressions on
CREATE TRIGGER statement specified the same name | either side of the operator must be equal.
for more than one of the OLD or NEW correlation
| System Action: The statement was not executed.
names or the OLD_TABLE or NEW_TABLE identifiers.
name is the name that was specified multiple times. | Programmer Response: Change the number of
System Action: The statement cannot be executed.
| expressions to match the number of values returned by
The trigger was not created.
| the fullselect or vice versa.
Programmer Response: Change the statement to
| SQLSTATE: 428C4
specify unique names for all transition variables and
tables in the REFERENCING clause and resubmit the -219 THE REQUIRED EXPLANATION TABLE
CREATE TRIGGER request. table-name DOES NOT EXIST
SQLSTATE: 42712 Explanation: The EXPLAIN statement assumes the
existence of the explanation table and it is not defined
in the DB2 subsystem as a base table. Refer to Chapter
| -214 AN EXPRESSION IN THE FOLLOWING
5 of DB2 SQL Reference for more information.
| POSITION, OR STARTING WITH
| position-or-expression-start IN THE System Action: The statement cannot be executed.
| clause-type CLAUSE IS NOT VALID.
| REASON CODE = reason-code Programmer Response: Determine whether the
required explanation table does exist. If not, create the
Explanation: The expression identified by the first part required table.
of the expression expression-start in the clause-type
clause is not valid for the reason specified by the SQLSTATE: 42704
reason-code as follows:
| v 1- The fullselect of the select-statement is not a -220 THE COLUMN column-name IN
| subselect. Expressions are not allowed in the EXPLANATION TABLE table-name IS
| ORDER BY clause for this type of select-statement. NOT DEFINED PROPERLY
| This reason code occurs only when clause-type is
Explanation: An error occurred during the insertion of
| ORDER BY.
a row into the explanation table. The table is improperly
| v 2 - DISTINCT is specified in the select clause, and defined for the following reasons:
| either a column name in the ORDER BY clause
v A column is missing.
| cannot be matched exactly with a column name in
| the SELECT list, or a sort-key-expression is specified v Columns are defined in the wrong order.
| in the ORDER BY clause. This reason code occurs v The table contains an extra column.
| only when clause-type is ORDER BY.
Chapter 2. SQL Return Codes 41
-221 • -225
v A column description is invalid because of its name, | SQLSTATE: 24510
data type, length, or null attributes.
System Action: The statement cannot be executed. | -223 AN UPDATE OR DELETE OPERATION
The explanation information is not generated. | WAS ATTEMPTED AGAINST AN
| UPDATE HOLE USING cursor-name
Programmer Response: Correct the definition of the
required explanation table. Refer to Chapter 5 of DB2 | Explanation: DB2 detected an update hole when DB2
SQL Reference for information on defining an | attempted a positioned UPDATE or DELETE on a row
explanation table. | that no longer satisfies its previous search condition. An
| update hole is created when a row exists in the result
SQLSTATE: 55002
| table and the resulting row has been updated in the
| base table such that the row no longer satisfies the
-221 “SET OF OPTIONAL COLUMNS” IN | search condition in the SELECT statement.
EXPLANATION TABLE table-name IS
| cursor-name
INCOMPLETE. OPTIONAL COLUMN
| Name of the cursor used for the positioned
column-name IS MISSING
| update or delete.
Explanation: The EXPLAIN statement assumes the
| System Action: The statement cannot be processed.
required explanation table is defined properly. The
| The cursor is positioned on the table.
optional column indicated is not defined in the indicated
explanation table. PLAN_TABLEs must have one of | Programmer Response: Correct the application
several specific formats. The format chosen must be | program to handle this error condition or change
complete, and each column in the PLAN_TABLE | isolation levels so the base row cannot be updated
definition must be correct for the chosen format. The | during the cursor operation.
allowed formats for the PLAN_TABLE are described in
Chapter 6 of DB2 SQL Reference.
| SQLSTATE: 24511
System Action: The explanation information is not
generated.
| -224 THE RESULT TABLE DOES NOT
| AGREE WITH THE BASE TABLE USING
Programmer Response: Correct the definition of the | cursor-name
required explanation table to include all of the optional
columns in the chosen format, just the Version 2
| Explanation: DB2 attempted a positioned UPDATE or
Release 2 optional columns, or no optional columns.
| DELETE was attempted on a row that no longer
Refer to Chapter 5 of DB2 SQL Reference for
| matches its previous condition. The column values in
information on defining an explanation table.
| the result table row do not match the current values in
| the base table row because the row was updated
SQLSTATE: 55002 | between the time it was inserted into the result table
| and the positioned update or delete was executed.
| -222 AN UPDATE OR DELETE OPERATION | cursor-name
| WAS ATTEMPTED AGAINST A HOLE | Name of the cursor used for the positioned
| USING cursor-name | update or delete.
| Explanation: DB2 could not process a positioned | System Action: The statement cannot be processed.
| update or delete with cursor cursor-name that is defined | The cursor is positioned on the same row.
| as SENSITIVE STATIC. The selected row is either a
| delete hole or an update hole. DB2 detects these holes
| Programmer Response: Correct the application
| when DB2 tries to delete or update the current row of
| program to handle this error condition or change
| the result table for cursor cursor-name, and cannot
| isolation levels so the base row cannot be updated
| locate the corresponding row of the underlying table.
| during the cursor operation.
| A delete hole occurs when the corresponding row of the | SQLSTATE: 24512
| underlying table has been deleted.
| An update hole occurs when the corresponding row of
| -225 FETCH STATEMENT CLAUSES ARE
| the underlying table has been updated, and the updated
| INCOMPATIBLE WITH THE CURSOR
| row no longer satisfies the search condition that is
| DEFINITION USING cursor-name
| specified in the SELECT statement of the cursor. | Explanation: DB2 could not process a FETCH
| System Action: The statement cannot be processed. | statement for cursor cursor-name because it contained
| The cursor is positioned on the hole. | a disallowed keyword. You may only specify the
| keyword NEXT for non-scrollable cursors. The keywords
| Programmer Response: Issue a FETCH statement to | PRIOR, FIRST, LAST, ABSOLUTE, RELATIVE,
| position the cursor on a row. | CURRENT, BEFORE, and AFTER are disallowed for a
42 DB2 UDB for OS/390 and z/OS: Messages and Codes
-228 • -244
| cursor that was not declared with the SCROLL attribute. added, created, or deleted at anytime, they are not
validated until they are used. Therefore, it is possible to
| cursor-name specify a locale that is not valid at installation or bind
| Name of the cursor used for the FETCH
time.
| statement.
SQLSTATE: 42708
| System Action: The statement cannot be processed.
| Programmer Response: Correct the FETCH
-240 THE PART CLAUSE OF A LOCK TABLE
| statement to excluse the disallowed keyword, or corect
STATEMENT IS INVALID
| the DECLARE CURSOR statement to include the
| appropriate SCROLL option. Explanation: The LOCK TABLE statement is invalid
for one of the following reasons:
| SQLSTATE: 42872
v The table space in which the table resides is not
partitioned or does not have the LOCKPART YES
| -228 FOR UPDATE CLAUSE SPECIFIED FOR attribute, and the PART clause is specified.
| READ-ONLY SCROLABLE CURSOR
v An integer specified in the PART clause does not
| USING cursor-name
identify a partition of the table space.
| Explanation: A cursor was declared read-only with the System Action: The LOCK TABLE statement cannot
| INSENSITIVE SROLL option, but the SELECT be executed.
| statement contained a FOR UPDATE clause.
Programmer Response: Determine whether the
| cursor-name specified table resides in a partitioned table space
| Name of the cursor used for the FETCH.
defined with LOCKPART YES.
| System Action: The statement cannot be processed. v If it is partitioned and defined with LOCKPART YES,
| Programmer Response: To define a scrollable cursor specify a PART clause that identifies the partition you
| that is read-only, specify INSENSITIVE SCROLL, but do want to lock.
| not specify FOR UPDATE clause. To define a scrollable v If it is partitioned but does not have the LOCKPART
| cursor that can be updated, specify SENSITIVE YES attribute and you want to lock a single partition,
| SCROLL. Corect the application program to DECLARE use ALTER TABLESPACE to change the LOCKPART
| CURSOR appropriately. attribute to YES.
| SQLSTATE: 42620 v If it is not partitioned, do not specify the PART clause.
SQLSTATE: 428B4
-229 THE LOCALE locale SPECIFIED IN A
SET LOCALE OR OTHER STATEMENT | -243 SENSITIVE CURSOR cursor-name
THAT IS LOCALE SENSITIVE WAS NOT | CANNOT BE DEFINED FOR THE
FOUND | SPECIFIED SELECT STATEMENT
Explanation: The statement attempted to reference a | Explanation: The cursor cursor-name is defined as
Locale that is not known or not available to DB2. locale | SENSITIVE, but the content of of the SELECT
is the locale that was either specified on the SET | statement requires DB2 to build a temporary table with
CURRENT LOCALE statement or the locale that was in | the result table of the cursor, and DB2 cannot
effect at the time the Locale access was attempted. | guarantee that changes made outside the cursor will be
System Action: The statement cannot be executed. | visible. This could result from the content of the query
| making the result table read-only. In this case the cursor
Programmer Response: If the statement was a SET | must be defined INSENSITIVE.
LOCALE statement, re-specify a locale that is correct
(known and available to DB2). Refer to Chapter 3 of | System Action: The statement cannot be processed.
SQL Reference for more information on Locales. If the | Programmer Response: Either change the content of
statement was something other than SET LOCALE, | the query to not be read-only, or change the type of
then the statement contained a locale sensitive interface | cursor to be INSENSITIVE.
(the UPPER function is an example of a locale sensitive
interface). Issue ″SELECT CURRENT LOCALE FROM | SQLSTATE: 36001
SYSIBM.SYSDUMMY1″ to determine the value of the
LOCALE in use by your program. Possible reasons for | -244 SENSITIVITY sensitivity SPECIFIED ON
this message include an incorrect LOCALE bind option, | THE FETCH IS NOT VALID FOR
or an incorrect LOCALE default value specified at | CURSOR cursor-name
installation time (The value of a Locale is not validated
until it is needed in a Locale sensitive interface). | Explanation: The sensitivity option specified on
Because Locales are dynamic in nature, they can be | FETCH conflicts with the sensitivity option in effect for
| cursor cursor-name. If a cursor is declared
Chapter 2. SQL Return Codes 43
-250 • -302
| INSENSITIVE, the FETCH statement can only specify v Referenced as an input variable in an embedded
| INSENSITIVE or nothing. If a cursor is declared SQL statement.
| SENSITIVE, the FETCH statement can specify v Used to provide a value for a parameter marker of a
| INSENSITIVE, SENSITIVE, or nothing. dynamic SQL statement.
| sensitivity
| Specified sensitivity for the FETCH statement. If the data type of the variable is character string, it is
invalid because it does not include X’00’. If the data
| cursor-name type of the variable is graphic string, it is invalid
| Name of the cursor used for the FETCH because it does not include X’0000’.
| statement.
System Action: The statement cannot be executed.
| In case of a non-scrollable cursor, sensitivity option Programmer Response: Append a NUL-terminator to
| cannot be specified. the end of the string.
| System Action: The statement cannot be processed. SQLSTATE: 22024
| Programmer Response: Change the host variable to
| be an exact numeric with a scale of zero. -301 THE VALUE OF INPUT HOST
| SQLSTATE: 42618 VARIABLE OR PARAMETER NUMBER
position-number CANNOT BE USED AS
SPECIFIED BECAUSE OF ITS DATA
-250 THE LOCAL LOCATION NAME IS NOT TYPE
DEFINED WHEN PROCESSING A
THREE-PART OBJECT NAME Explanation: DB2 received data that could not be
used as specified in the statement because its data
Explanation: A three-part object name (table, view, or type is incompatible with the requested operation.
alias) cannot be used until the local location name is
defined. The position-number identifies either the host variable
number (if the message is issued as a result of an
System Action: Install or reinstall the DB2 distributed INSERT, UPDATE, DELETE, SELECT, VALUE INTO, or
data facility (DDF) with a registered location name for SET assignment statement), or the parameter number
local DB2. (if the message is issued as the result of a CALL
Programmer Response: Define the local location statement, or the invocation of a function).
name and then retry the function. System Action: The statement cannot be executed.
SQLSTATE: 42718 Programmer Response: Correct the application
program, function or stored procedure. Ensure that the
-251 TOKEN name IS NOT VALID data type of the indicated input host variable or
parameter in the statement is compatible with the way it
Explanation: A location name cannot contain is used.
alphabetic extenders. (The standard alphabetic
extenders in the United States are #, @, $.) SQLSTATE: 42895
System Action: The statement cannot be executed
-302 THE VALUE OF INPUT VARIABLE OR
Programmer Response: Correct the name and PARAMETER NUMBER position-number
reissue the statement. IS INVALID OR TOO LARGE FOR THE
TARGET COLUMN OR THE TARGET
SQLSTATE: 42602
VALUE
Explanation: DB2 received data that was invalid or
-300 THE STRING CONTAINED IN HOST
too large to fit in the corresponding column of the table
VARIABLE OR PARAMETER
or the corresponding target value. The position-number
position-number IS NOT
identifies either the host variable number (if the
NUL-TERMINATED
message is issued as a result of an INSERT, UPDATE,
Explanation: A host variable or parameter is invalid. DELETE, SELECT, VALUES INTO, or SET assignment
Its entry in the SQLDA is indicated by position-number. statement), or the parameter number (if the message is
The host variable or parameter is a C string variable issued as the result of a CALL statement or the
that is one of the following: invocation of a function).
v Used as an input parameter to a stored procedure or One of the following occurred:
function.
v The column is defined as a string and the host
v Returned as an output parameter from a stored variable or parameter contains a string that is too
procedure or function. long for the column.
44 DB2 UDB for OS/390 and z/OS: Messages and Codes
-303 • -309
v The column is defined as numeric and the host
-304 A VALUE WITH DATA TYPE data-type1
variable or parameter contains a numeric value too
CANNOT BE ASSIGNED TO A HOST
large for the definition of the column.
VARIABLE BECAUSE THE VALUE IS
v The host variable is defined as decimal, but contains NOT WITHIN THE RANGE OF THE
invalid decimal data. HOST VARIABLE IN POSITION
v The target value is a string constant and the host position-number WITH DATA TYPE
variable or parameter contains a string that is too data-type2
long for the target value.
Explanation: A CALL, FETCH, SELECT, VALUES
v The target value is a numeric constant and the host INTO, or SET assignment statement with a host
variable or parameter contains a numeric value that variable list or structure in position number
is too large for the target value. position-number failed because the host variable with
System Action: The statement cannot be executed. data type data-type2 was not large enough to hold the
retrieved value with data type data-type1.
Programmer Response: Correct the application
program, function or stored procedure. Check the System Action: The statement cannot be executed.
column type and length of the value or the data type No data was retrieved. If the statement was a FETCH,
and contents of the input host variable or parameter the cursor remains open.
position-number. Ensure that the value of the host Programmer Response: Verify that table definitions
variable or parameter will fit in the column or contains are current, and that the host variable has the correct
valid decimal data. Valid decimal data is a System/370 data type. See the explanation for SQLCODE -405 for
packed decimal number. ranges of SQL data types.
SQLSTATE: 22003 if number too large for target; SQLSTATE: 22003
22001 otherwise.
-305 THE NULL VALUE CANNOT BE
-303 A VALUE CANNOT BE ASSIGNED TO ASSIGNED TO OUTPUT HOST
OUTPUT HOST VARIABLE NUMBER VARIABLE NUMBER position-number
position-number BECAUSE THE DATA BECAUSE NO INDICATOR VARIABLE
TYPES ARE NOT COMPARABLE IS SPECIFIED
Explanation: A CALL, FETCH, SELECT, VALUES Explanation: A FETCH, SELECT, VALUES INTO, or
INTO, or SET host-variable statement with an output SET assignment statement resulted in the retrieval of a
host variable, whose entry in the output SQLDA is null value to be inserted into the output host variable,
indicated by position-number, could not be performed. designated by entry number 'position-number' of the
The data type of the variable was not compatible with output SQLDA, for which no indicator variable was
the data type of the corresponding SELECT, VALUES provided. An indicator variable must be supplied if a
INTO, or SET host-variable statement list element. The column returns a null value.
values of the output host variable and the
corresponding list element must be in one of the System Action: The statement cannot be executed.
following categories: No data was retrieved.
v Both must be numbers. Programmer Response: Examine the definition of the
v Both must be character strings if not using Unicode. table that is the object of the statement and correct the
v Both must be graphic strings if not using Unicode. application program to provide indicator variables for all
v Both must be row IDs. host variables into which null values can be retrieved.
This includes host variables for columns which can
In addition, for datetime, timestamp values, the host contain null values and host variables which receive the
variable must be a character string variable with a results of column functions whose result table could be
correct length. empty.
System Action: The CALL, FETCH, SELECT, SQLSTATE: 22002
VALUES INTO, or SET host-variable statement cannot
be executed. No data was retrieved.
-309 A PREDICATE IS INVALID BECAUSE A
Programmer Response: Verify that table definitions REFERENCED HOST VARIABLE HAS
are current and that the host variable has the correct THE NULL VALUE
data type.
Explanation: The statement could not be processed
SQLSTATE: 42806 because a host variable appearing in a predicate such
as
column-name = host-variable
Chapter 2. SQL Return Codes 45
-310 • -314
had the NULL value. Such a predicate is not permitted v The SQL statement is a prepared statement, or
when the host variable contains the NULL value even v The attributes of the variable are inconsistent with its
though the object column might contain nulls. usage in the static SQL statement, or
System Action: The statement cannot be executed. v The variable is not declared in the application
program or
Programmer Response: Rebind the plan or package
containing the statement. The condition described is not v The variable appeared in one of the triggered SQL
an error in DB2 Version 2 Release 3 and later releases. statements in a CREATE TRIGGER statement.
SQLSTATE: 22512 System Action: The statement cannot be executed.
Programmer Response: Verify that
-310 DECIMAL HOST VARIABLE OR v The variable name is spelled properly in the SQL
PARAMETER number CONTAINS statement.
NON-DECIMAL DATA v The variable is allowed in the SQL statement.
Explanation: DB2 received nondecimal data from v The application program contains a declaration for
either an application (in the form of a host variable), that variable.
function or a stored procedure (in the form of a v The attributes of the variable are compatible with its
parameter that was passed to or from function or a use in the statement.
stored procedure).
SQLSTATE: 42618
number Identifies either the host variable number (if the
message is issued as a result of a FETCH,
INSERT, UPDATE, DELETE, SELECT, -313 THE NUMBER OF HOST VARIABLES
VALUES INTO, or SET assignment statement SPECIFIED IS NOT EQUAL TO THE
statement), or the parameter number (if the NUMBER OF PARAMETER MARKERS
message is issued as the result of the Explanation: The number of host variables specified
invocation of a function, or a CALL statement). in the EXECUTE or OPEN statement is not the same as
System Action: The statement cannot be processed. the number of parameter markers (question marks)
appearing in the prepared SQL statement.
Programmer Response: Correct the application
program or stored procedure. Ensure that all decimal System Action: The statement cannot be executed.
variables or parameters contain valid System/370 Programmer Response: Correct the application
packed decimal numbers. program so that the number of host variables specified
SQLSTATE: 22023 in the EXECUTE or OPEN statement is the same as the
number of parameter markers appearing in the prepared
SQL statement. The DESCRIBE INPUT SQL statement
-311 THE LENGTH OF INPUT HOST can be used to determine the expected number of input
VARIABLE NUMBER position-number IS parameter markers.
NEGATIVE OR GREATER THAN THE
MAXIMUM SQLSTATE: 07001
Explanation: When evaluated, the length specification
for input host string variable, whose entry in the SQLDA -314 THE STATEMENT CONTAINS AN
is indicated by position-number, was negative or greater AMBIGUOUS HOST VARIABLE
than the maximum. REFERENCE
System Action: The statement cannot be executed. Explanation: A host variable used in the statement
has been defined more than once in this application
Programmer Response: Correct the program to program causing confusion as to which host variable
ensure that the lengths of all host string variables are defined should be used.
not negative or that they are not greater than the
maximum allowed length. System Action: The statement cannot be executed.
SQLSTATE: 22501 Programmer Response: Make the host variable
unique or use qualifications to indicate which host
variable definition is to be used.
-312 variable-name IS AN UNDEFINED OR
UNUSABLE HOST VARIABLE OR IS SQLSTATE: 42714
USED IN A DYNAMIC SQL STATEMENT
OR A TRIGGER DEFINITION
Explanation: The host variable variable-name appears
in the SQL statement, but:
46 DB2 UDB for OS/390 and z/OS: Messages and Codes
-327 • -331
v If the reason-code is 16 and the string is described
-327 THE ROW CANNOT BE INSERTED
as MIXED data, either change its description or the
BECAUSE IT IS OUTSIDE THE BOUND
string to conform to the rules for well-formed mixed
OF THE PARTITION RANGE FOR THE
data.
LAST PARTITION
v If the reason-code is 20, correct the translate
Explanation: When a row is inserted, the calculated procedure.
partition key value for the new row must be within the
v If the reason-code is 24, delete the SBCS character
bounds of a partition (as specified in the VALUES
from the graphic string.
clause of the CREATE INDEX statement).
SQLSTATE: 22021
System Action: The statement cannot be executed.
Programmer Response: Correct the statement to
-331 A STRING CANNOT BE ASSIGNED TO
specify a value for the partition key that is within the
A HOST VARIABLE BECAUSE IT
bounds of the last partition of the partitioned table
CANNOT BE TRANSLATED. REASON
space.
reason-code, CHARACTER code-point,
SQLSTATE: 22525 POSITION position-number
Explanation: The operation required the translation of
-330 A STRING CANNOT BE USED a string to the coded character set of the host variable
BECAUSE IT CANNOT BE and a translation error occurred. The type of error is
TRANSLATED. REASON reason-code, indicated by the 'reason-code':
CHARACTER code-point, HOST v 8 for length exception (e.g., expansion required for
VARIABLE position-number PC MIXED data exceeds the maximum length of the
Explanation: A translation error occurred during the string).
translation of a string to a different coded character set. v 12 for invalid 'code point' (e.g., use of the
The type of error is indicated by the reason-code: ERRORBYTE option of SYSSTRINGS).
8 Length exception (for example, expansion v 16 for form exception (e.g., invalid MIXED data).
required for PC MIXED data exceeds the v 20 for translate procedure error (e.g., an exit set the
maximum length of the string). length control field of the string to an invalid value).
12 Invalid code point (for example, use of the If the 'reason-code' is 12, 'code-point' is the invalid
ERRORBYTE option of SYSSTRINGS). 'code point'. Otherwise, 'code-point' is blank. The
'position-number' is the ordinality of the output variable
16 Form exception (for example, invalid MIXED
in the SQLDA.
data).
System Action: The statement cannot be executed.
20 Translate procedure error (for example, an exit
set the length control field of the string to an Programmer Response: If the 'reason-code' is 8, the
invalid value). maximum length of the result column must be extended
to allow for the expansion that occurs when the string is
24 SBCS character found in string contained in a
translated. If the 'reason-code' is 12, either the translate
wchar_t host variable.
table must be changed to accept the 'code-point' or the
data must be changed to eliminate the 'code point'. If
If the reason-code is 12, code-point is the invalid code the 'reason-code' is 16, and the string is described as
point. Otherwise, code-point is either blank or an MIXED data, either its description must be changed or
additional reason-code returned by an exit. If the string the string must be changed to conform to the rules for
is the value of an input host variable, the well-formed MIXED data. If the 'reason-code' is 20, the
position-number is the ordinality of the variable in the translate procedure must be corrected. An alternative to
SQLDA. If the string is not the value of a host variable, these corrective actions is to provide an indicator
the position-number is blank. variable so that a null value and a warning can be
System Action: The statement cannot be executed. returned rather than an error. Refer to Chapter 2 of DB2
SQL Reference for more information on coded character
Programmer Response: Take one of the following set.
actions based on the reason-code
SQLSTATE: 22021
v If the reason-code is 8, extend the maximum length
of the host variable to allow for the expansion that
occurs when the string is translated.
v If the reason-code is 12, either change the translate
table to accept the code-point or the data to eliminate
the code-point.
Chapter 2. SQL Return Codes 47
-332 • -350
expression of the predicate must only reference
-332 CHARACTER CONVERSION BETWEEN
columns of the other operand table.
CCSID from-ccsid TO to-ccsid
REQUESTED BY reason-code IS NOT v A VALUE or COALESCE function is allowed in the
SUPPORTED ON clause only when the join operator is a FULL
OUTER JOIN or FULL JOIN.
Explanation: The operation required a conversion
v An operator other than ’=’ is not allowed in a FULL
between two differend CCSIDs, but no conversion
OUTER JOIN or FULL JOIN.
support was found.
v A subquery is not allowed in the ON clause.
from-ccsid identifies the coded character set of the
string to be converted. System Action: The statement cannot be executed.
to-ccsid identifies the coded character set to which it Programmer Response: Correct the syntax so that it
must be translated. doesn’t violate any of the above items within the ON
clause
reason code describes the reason codes returned from
DB2. Reason codes returned from DB2 begin with SQLSTATE: 42972
'DSN' and identify the context in which the conversion
was requested. Values other than those that start with -339 THE SQL STATEMENT CANNOT BE
'DSN' are returned from other DB2 platforms and are EXECUTED FROM AN ASCII BASED
described in the documentation for the platform. DRDA APPLICATION REQUESTOR TO
System Action: The statement cannot be processed. A V2R2 DB2 SUBSYSTEM
Programmer Response: If the conversion request is Explanation: The application is connected to a DB2
correct, refer to Appendix B of DB2 Installation Guide Version 2 Release 3 database server. The SQL
for information on how to add conversion support. statement is using an alias or three-part name, which
refers to another DB2 subsystem that is at the Version 2
SQLSTATE: 57017 Release 2 level. DB2 Version 2 Release 2 does not
support character conversion. Since the execution of
-333 THE SUBTYPE OF A STRING SQL statements from an ASCII DRDA requester to an
VARIABLE IS NOT THE SAME AS THE EBCDIC Version 2 Release 2 DB2 server could require
SUBTYPE KNOWN AT BIND TIME AND character conversion, access to the Version 2 Release
THE DIFFERENCE CANNOT BE 2 DB2 is denied for data integrity reasons.
RESOLVED BY TRANSLATION System Action: The statement cannot be executed.
Explanation: The CCSID in the run time SQLDA is Programmer Response: Remove statements from the
inconsistent with the bind time subtype of the host application that resolve to a DB2 Version 2 Release 2
variable or parameter marker. Either the run time subsystem.
description is BIT and the bind time description was not
BIT, or the run time description is not BIT and the bind System Programmer Response: If the application
time description was BIT. must refer to the Version 2 Release 2 subsystem data,
the Version 2 Release 2 DB2 subsystem must be
System Action: The statement cannot be executed. migrated to Version 2 Release 3 where character
Programmer Response: Change the CCSID in the conversion is supported.
SQLDA so that the subtype of the host variable is SQLSTATE: 56082
consistent with the bind time subtype of the host
variable or parameter marker. If the input data in error is
a parameter marker, you can use the DESCRIBE -350 INVALID SPECIFICATION OF A LARGE
INPUT SQL statement to determine the expected OBJECT COLUMN
SQLTYPE, SQLLEN and CCSID expected. Refer to | Explanation: The ALTER TABLE, CREATE TABLE, or
Chapter 2 of DB2 SQL Reference for more information | CREATE INDEX statement is invalid for one of the
on coded character set. | following reasons:
SQLSTATE: 56010 | v A LOB column cannot be added to a temporary table.
| v A LOB column cannot be added to a table defined
-338 AN ON CLAUSE IS INVALID | with an EDITPROC.
| v The PRIMARY KEY clause cannot specify a LOB
Explanation: This return code reports a violation of
one of the following:
| column as a column of the primary key.
| v The UNIQUE clause cannot specify a LOB column as
v One expression of the predicate must only reference
columns of one of the operand tables of the
| a column of the unique key.
associated join operator, full join, and the other | v The referential-constraint clause cannot specify a
| LOB column as a column of a foreign key.
48 DB2 UDB for OS/390 and z/OS: Messages and Codes
-351 • -373
| v The CREATE INDEX statement cannot name a LOB column whose length exceeds 1 gigabyte or a
| column as a column of the index key. DBCLOB column whose length exceeds 500
| v A LOB column cannot be specified in a references megabyte characters
| clause. System Action: The statement cannot be executed.
System Action: The statement cannot be executed. Programmer Response: Either change the attribute of
Programmer Response: Correct the syntax and the LOB table space to LOG NO or drop the base table,
resubmit the statement. and recreate it with columns of an acceptable length for
logging.
SQLSTATE: 42962
SQLSTATE: 42993
-351 AN UNSUPPORTED SQLTYPE WAS
ENCOUNTERED IN POSITION | -359 THE RANGE OF VALUES FOR THE
position-number OF THE SELECT-LIST | IDENTITY COLUMN IS EXHAUSTED
Explanation: position-number is the position of the | Explanation: An INSERT statement was issued
first element in the SQLDA with an unsupported data | against a table with an identity column; however all
type. Either the application requestor or the application | allowable values for the identity column data type have
server does not have support for this type. This error | already been assigned, assuming NO CYCLE is in
can only occur in a client/server environment. | effect.
System Action: The statement cannot be executed. | System Action: The statement cannot be processed.
Programmer Response: Change the statement to | Programmer Response: Redefine the table to use a
exclude the unsupported data type. For a select | data type on the identity column that supports a larger
statement, remove the names of any columns in the | range of values. For example, if SMALLINT is currently
select-list with the unsupported data types. | specified, change the data type for the identity column
| to INTEGER.
SQLSTATE: 56084
| SQLSTATE: 23522
-352 AN UNSUPPORTED SQLTYPE WAS
ENCOUNTERED IN POSITION | -372 ONLY ONE ROWID OR IDENTITY
position-number OF THE INPUT-LIST | COLUMN IS ALLOWED IN A TABLE
Explanation: The input SQLDA for an OPEN, | Explanation: An attempt was made to do one of the
EXECUTE, FETCH, or CALL statement contains an | following:
unsupported SQLTYPE for the parameter in position | v Create a table with more than one ROWID column.
position-number. position-number is the position of the | v Add a ROWID column to a table that already has
first element in the SQLDA with an unsupported data | one.
type. Either the application requestor or the application
| v Create a table with more than one identity column.
server does not have support for this data type. This
error can only occur in a client/server environment. | v Add an identity column to a table that already has
| one.
System Action: The statement cannot be executed.
| System Action: The statement was not executed.
Programmer Response: Change the SQLDA to
exclude the unsupported data type. | Programmer Response: For a CREATE TABLE
| statement, select only one column to have the row ID
SQLSTATE: 56084 | data type or the AS IDENTITY attribute. For an ALTER
| TABLE statement, a ROWID column or identity column
-355 A LOB COLUMN IS TOO LARGE TO BE | already exists for the table. Do not attempt to add
LOGGED | another column with the data type row ID or with the AS
| IDENTITY attribute to the table.
Explanation: One of the following has occurred:
| SQLSTATE: 428C1
v a CREATE TABLE statement for an auxiliary table
stores a BLOB, CLOB or DBCLOB column whose
length exceeds 1 gigabyte but whose associated | -373 DEFAULT CANNOT BE SPECIFIED FOR
LOB table space was defined with the LOG YES | IDENTITY COLUMN column-name
attribute
| Explanation: A DEFAULT clause may not be specified
v an ALTER TABLESPACE statement of a LOB table | for a column that has been identified as an IDENTITY
space specifies the LOG YES clause but the auxiliary | column.
table in the LOB table space stores a BLOB or CLOB
| System Action: The statement cannot be executed.
Chapter 2. SQL Return Codes 49
-390 • -399
| Programmer Response: Remove the DEFAULT final call processing, but the statement is not allowed.
| clause and resubmit the statement.
System Action: The SQL statement cannot be
| SQLSTATE: 42623 executed.
Programmer Response: Change the definition of the
-390 THE FUNCTION function-name, function to not issue SQL statements during final call
SPECIFIC NAME specific-name, IS NOT processing.
VALID IN THE CONTEXT IN WHICH IT
SQLSTATE: 38505
OCCURS
Explanation: A function resolved to a specific function
-397 THE OPTION GENERATED IS
that is not valid in the context where it is used. If
SPECIFIED WITH A COLUMN THAT IS
specific-name is an empty string, then the function
NOT A ROW ID OR DISTINCT TYPE
resolved to the built-in function identified by
BASED ON A ROW ID
function-name. Some of the possible situations include:
v A scalar or column function is referenced where only Explanation: GENERATED was specified in a
a table function is allowed (such as in the FROM CREATE or ALTER TABLE statement for a column with
clause of a query). a data type that is not a row ID, and is not a distinct
type that is based on a row ID. GENERATED can only
v A table function is referenced where only a scalar or
be specified for a column with a data type of row ID, or
column function is allowed (such as in an expression,
a distinct type that is based on a row ID.
or in a SOURCE clause of a CREATE FUNCTION
statement). System Action: The statement cannot be executed.
System Action: The statement cannot be executed. Programmer Response: Correct the statement. Either
eliminate the GENERATED clause or ensure that the
Programmer Response: Ensure that the correct
data type of the object is row ID.
function name and arguments are specified and that the
SQL path includes the schema where the correct SQLSTATE: 428D3
function is defined. You may need to change the
function name, arguments, SQL path (using SET
CURRENT PATH or the PATH bind option), or change –398 A LOCATOR WAS REQUESTED FOR
the context in which the function is used. Refer to HOST VARIABLE NUMBER
Chapter 5 of DB2 SQL Reference for information on the position-number BUT THE VARIABLE IS
use of functions. NOT A LOB
SQLSTATE: 42887 Explanation: The application requested that a locator
be returned from host variable number position-number.
A locator can only be used with LOB data, and the
-392 SQLDA PROVIDED FOR CURSOR requested data is not a LOB.
cursor HAS BEEN CHANGED FROM
THE PREVIOUS FETCH System Action: The statement cannot be executed.
Explanation: The application is running with DB2 Programmer Response: Change the statement to
rules, and has requested that LOB data be returned as either return LOB data, or change the target host
a LOB in one FETCH statement, and as a locator in variable to not be a locator.
another FETCH statement. This is not permitted. SQLSTATE: 428D2
System Action: The statement is not executed and
the connection is terminated. -399 ATTEMPTED TO INSERT AN INVALID
Programmer Response: Either do not use DB2 rules, VALUE INTO A ROWID COLUMN
or change to application to not change the data type Explanation: When inserting into a table, a value
code from LOB to locator (or the reverse) in the SQLDA specified for a ROWID column was invalid. Only row ID
between successive fetches. values previously generated by DB2 are valid.
SQLSTATE: 42855 System Action: The INSERT is not performed.
Programmer Response: Do not attempt to generate
-396 object-type object-name ATTEMPTED TO any value for insertion into a ROWID column. Insertion
EXECUTE AN SQL STATEMENT into ROWID columns is supported for purposes of Data
DURING FINAL CALL PROCESSING Propagation, where DB2 has previously generated the
Explanation: A user-defined function named row ID values. Only row ID values previously generated
object-name was invoked and attempted to execute an by DB2 can be used as values for insertion into a row
SQL statement (other than CLOSE CURSOR) during ID column. Alternatively, insert the row specifying
DEFAULT for the ROWID column or remove the
50 DB2 UDB for OS/390 and z/OS: Messages and Codes
-400 • -406
ROWID column from the insert column-list.
-404 THE SQL STATEMENT SPECIFIES A
| You may also use the OVERRIDING clause as a STRING THAT IS TOO LONG
| possible solution for this situation. See INSERT in DB2
Explanation: An INSERT, UPDATE, CALL, VALUES
| SQL Reference for more information about the
INTO, SET, parameter, host variable, or transition
| OVERRIDING USER VALUE clause.
variable statement specifies a value that is longer than
SQLSTATE: 22511 the maximum length string that can be stored in the
target column.
-400 THE CATALOG HAS THE MAXIMUM System Action: The statement cannot be executed.
NUMBER OF USER DEFINED INDEXES
Programmer Response: Check the length of the
Explanation: Only one hundred user-defined indexes target column, parameter, host variable or transition
can be created in the catalog database. variable and correct the program or SQL statement so
that the length of the string does not exceed that
System Action: The statement cannot be executed. maximum. For example, you could use the SUBSTR
Programmer Response: If this index must be created, function to shorten the string.
another user-defined index on the catalog must be SQLSTATE: 22001
dropped. After that index is dropped, this statement can
be executed.
-405 THE NUMERIC LITERAL literal
SQLSTATE: 54027 CANNOT BE USED AS SPECIFIED
BECAUSE IT IS OUT OF RANGE
# -401 THE OPERANDS OF AN ARITHMETIC Explanation: The specified numeric literal is not in the
# OR COMPARISON OPERATION ARE proper range.
# NOT COMPARABLE
The proper ranges for SQL values are as follows:
# Explanation: An arithmetic operation appearing within v 5.4E−79 to 7.2E+75 for FLOAT values
# the SQL statement contains a mixture of numeric and v −(1031 -1) to +(1031 -1) for DECIMAL values
# non-numeric operands, or the operands of a comparison v −2147483648 to 2147483647 for INTEGER values
# operation are not compatible. v −32768 to +32767 for small integer (SMALLINT)
# One reason for this error is that the comparison involves values.
# both character and graphic operands. This combination System Action: The statement cannot be executed.
# of operands is not allowed for EBCDIC and ASCII data.
# For Unicode data, this combination of operands is not Programmer Response: The value of the literal
# allowed if a field procedure exists on one of the should be reduced to the appropriate size for this data
# columns. type.
# System Action: The statement cannot be executed. SQLSTATE: 42820
# Programmer Response: Check the data types of all
# operands to ensure that their data types are comparable -406 A CALCULATED OR DERIVED
# and compatible with their usage in the statement. NUMERIC VALUE IS NOT WITHIN THE
RANGE OF ITS OBJECT COLUMN
# If all the operands of the SQL statement are correct,
# then, if a view is being accessed, check the data types Explanation: A value derived or calculated during
# of all the operands in the view definition. processing of the SQL statement was outside the range
of the data type of its object column. This problem might
# SQLSTATE: 42818 have arisen because either the values occurring in the
object column were out of range, or the SQL operation
-402 AN ARITHMETIC FUNCTION OR performed was not appropriate for the values in the
OPERATOR arith-fop IS APPLIED TO object column.
CHARACTER OR DATETIME DATA System Action: The statement cannot be executed.
Explanation: A nonnumeric operand has been Programmer Response: See the explanation of
specified for the arithmetic function or operator arith-fop. SQLCODE -405 for allowed ranges for numeric data
System Action: The statement cannot be executed. types.
Programmer Response: Examine and correct the SQLSTATE: 22003
syntax of the SQL statement such that all operands of
the specified function or operator are numeric.
SQLSTATE: 42819
Chapter 2. SQL Return Codes 51
-407 • -412
variable or literal value that is assigned to the object
-407 AN UPDATE, INSERT, OR SET VALUE
has the proper data type. In some cases, you can
IS NULL, BUT THE OBJECT COLUMN
convert the value to the proper data type by using a
column-name CANNOT CONTAIN NULL
function such as CHAR or DECIMAL.
VALUES
SQLSTATE: 42821
Explanation: One of the following conditions occurred:
v A null insert or update value was specified for a
column defined as NOT NULL. -409 INVALID OPERAND OF A COUNT
FUNCTION
v No insert value was provided for a column that does
not have a default value. Explanation: The operand of the COUNT or
v A SET transition variable statement specified a NULL COUNT_BIG function in the statement violates SQL
value for column defined as NOT NULL. syntax. A common error is a column name or other
expression without DISTINCT.
v The insert value was DEFAULT, but the object
column was declared as NOT NULL without WITH System Action: The statement cannot be executed.
DEFAULT in the table definition. Consequently, a
default value of NULL cannot be inserted into that Programmer Response: Correct the syntax and
column. resubmit the statement. Refer to Chapter 3 of DB2 SQL
Reference for information about the proper form for the
v A null insert value was specified for a ROWID operands of a COUNT or COUNT_BIG function.
column.
SQLSTATE: 42607
System Action: The statement cannot be executed.
The 'column-name' might be returned in the SQLCA,
depending on the syntax of the SQL statement in which -410 THE FLOATING POINT LITERAL literal
the error was detected. CONTAINS MORE THAN 30
CHARACTERS
Programmer Response: Examine the definition of the
object table to determine which columns of the table Explanation: The specified floating-point literal is more
have the NOT NULL attribute or have a type of ROWID, than 30 characters in length. A floating-point literal has a
and correct the SQL statement accordingly. maximum length of 30 characters.
SQLSTATE: 23502 System Action: The statement cannot be executed.
Programmer Response: Correct the indicated literal.
-408 THE VALUE IS NOT COMPATIBLE
SQLSTATE: 42820
WITH THE DATA TYPE OF ITS TARGET
Explanation: The data type of the value to be
-411 CURRENT SQLID CANNOT BE USED
assigned to the column, parameter, host variable or
IN A STATEMENT THAT REFERENCES
transition variable by the SQL statement is incompatible
REMOTE OBJECTS
with the declared data type of the assignment target.
Both must be: Explanation: A reference to the CURRENT SQLID
v Numeric special register is invalid in a statement that contains
v Character the three-part name or alias of an object that is remote
v Graphic to the remote server.
v Dates or character
System Action: The statement cannot be executed.
v Times or character
v Timestamps or character Programmer Response: Either remove the reference
v Row IDs to CURRENT SQLID or the reference to the remote
v The same distinct types object.
SQLSTATE: 56040
However, dates, times, or timestamps cannot be
assigned to a character column that has a field
procedure. Also note that character and graphic data -412 THE SELECT CLAUSE OF A
types are compatible when using Unicode. SUBQUERY SPECIFIES MULTIPLE
COLUMNS
This SQLCODE is issued for any statement that fails
Explanation: In the context in which it was used in the
required assignment rule checking.
SQL statement, the subquery can have only one column
System Action: The statement cannot be executed. specified in its SELECT clause.
Programmer Response: Examine the current System Action: The statement cannot be executed.
definition for the object table, procedure, user-defined
Programmer Response: Correct the syntax of the
function, or host variable and ensure that the host
52 DB2 UDB for OS/390 and z/OS: Messages and Codes
-413 • -418
SQL statement. Refer to Chapter 4 of DB2 SQL
-416 AN OPERAND OF A UNION CONTAINS
Reference for information about restrictions on the
A LONG STRING COLUMN
syntax for subqueries.
Explanation: The UNION specified in the SQL
SQLSTATE: 42823
statement could not be performed because one of the
tables participating in the union contains a long string
-413 OVERFLOW OCCURRED DURING column (for example, a VARCHAR column with length
NUMERIC DATA TYPE CONVERSION greater than 255). The operands of a UNION cannot
contain long string columns.
Explanation: During processing of the SQL statement,
an overflow condition arose when converting from one System Action: The statement cannot be executed.
numeric type to another. Numeric conversion is
Programmer Response: The implied function is not
performed according to the standard rules of SQL.
supported by DB2. Refer to Chapter 2 of DB2 SQL
System Action: The statement cannot be processed. Reference for information about restrictions on the
No data was retrieved, updated, or deleted. manipulation of long string columns.
Programmer Response: Examine the syntax of the SQLSTATE: 42907
SQL statement to determine the cause of the error. If
the problem is data-dependent, it might be necessary to
-417 A STATEMENT STRING TO BE
examine the data processed at the time of the error.
PREPARED INCLUDES PARAMETER
SQLSTATE: 22003 MARKERS AS THE OPERANDS OF
THE SAME OPERATOR
-414 A LIKE PREDICATE IS INVALID Explanation: The statement string specified as the
BECAUSE THE FIRST OPERAND IS object of a PREPARE contains a predicate or
NOT A STRING expression where parameter markers have been used
as operands of the same operator—for example:
Explanation: The data type of the first operand of the
LIKE predicate must be a character string or graphic
? > ?
string.
System Action: The statement cannot be executed. This syntax is not permitted.
Programmer Response: Respecify the predicate so System Action: The statement cannot be executed.
that the data type of each operand is a character string
Programmer Response: Correct the logic of the
or a graphic string.
application program so that this syntax error does not
SQLSTATE: 42824 occur. Refer to Chapter 5 of DB2 SQL Reference for
information about the proper usage of parameter
markers within SQL statements to be prepared.
-415 THE CORRESPONDING COLUMNS,
column-number, OF THE OPERANDS OF SQLSTATE: 42609
A UNION OR A UNION ALL DO NOT
HAVE COMPARABLE COLUMN
-418 A STATEMENT STRING TO BE
DESCRIPTIONS
PREPARED CONTAINS AN INVALID
Explanation: The column descriptions of USE OF PARAMETER MARKERS
corresponding columns of the operands of a UNION or
Explanation: Parameter markers cannot be used in
UNION ALL must be comparable. The columns of
the SELECT list, as the sole argument of a scalar
ordinality 'column-number' of the operands in this
function, or in a concatenation operation. Parameter
UNION or UNION ALL do not satisfy this requirement.
markers cannot be used in the string expression of an
For columns to be comparable, they must both be either
EXECUTE IMMEDIATE SQL statement.
numeric, character, graphic, date, time, or timestamp.
They cannot be a mixture of these groups. If System Action: The statement cannot be executed.
corresponding columns have field procedures, they
must both have the same field procedure. Programmer Response: Correct the logic of the
application program so that this error does not occur.
System Action: The statement cannot be executed. Refer to Chapter 5 of DB2 SQL Reference for
information about the proper usage of parameter
Programmer Response: Check the data types of the
markers within SQL statements and for EXECUTE
specified columns and correct the UNION or UNION
IMMEDIATE SQL statement restrictions.
ALL statement so that all corresponding columns have
comparable column descriptions. SQLSTATE: 42610
SQLSTATE: 42825
Chapter 2. SQL Return Codes 53
-419 • -427
Programmer Response: For a result set locator there
-419 THE DECIMAL DIVIDE OPERATION IS
are two common causes for the error:
INVALID BECAUSE THE RESULT
v The host variable used as a result set locator was
WOULD HAVE A NEGATIVE SCALE
never assigned a valid result set locator value. Result
Explanation: The decimal division is invalid because it set locator values are returned by the DESCRIBE
will result in a negative scale. PROCEDURE and ASSOCIATE LOCATORS
statements. Make sure the value in your host variable
The formula used internally to calculate the scale of the
is obtained from one of these statements.
result for decimal division is explained in Chapter 2 of
v Result set locator values are only valid as long as the
DB2 SQL Reference.
underlying SQL cursor is open. If a commit or
System Action: The statement cannot be executed. rollback operation closes an SQL cursor, the result
No data was retrieved, updated, or deleted. set locator associated with the cursor is no longer
valid.
Programmer Response: Examine the precision and
scale of all columns that may have participated in a For a LOB locator, some common causes for the error
decimal division. Note that an integer or small integer are:
value may have been converted to decimal for this v The host variable used as a LOB locator was never
calculation. assigned a valid LOB value.
v A commit or rollback operation or an SQL FREE
SQLSTATE: 42911 LOCATOR statement freed the locator.
SQLSTATE: 0F001
-420 THE VALUE OF A STRING ARGUMENT
WAS NOT ACCEPTABLE TO THE
function-name FUNCTION -426 DYNAMIC COMMIT NOT VALID AT AN
APPLICATION SERVER WHERE
Explanation: A string argument did not conform to the UPDATES ARE NOT ALLOWED
requirements of the function. For example, a character
string passed to the DECIMAL function did not conform Explanation: An application executing using DRDA
to the rules for forming an SQL integer or decimal protocols has attempted to issue a dynamic COMMIT
constant. statement, or a stored procedure has attempted to issue
a COMMIT_ON_RETURN, while connected to a
System Action: The statement cannot be processed. location at which updates are not allowed. A dynamic
Programmer Response: Change the argument value COMMIT or COMMIT_ON_RETURN can be issuedonly
so that it conforms to the requirements of the function while connected to a location at which updates are
as specified in DB2 SQL Reference. allowed.
SQLSTATE: 22018 System Action: The statement cannot be executed.
No COMMIT is performed.
-421 THE OPERANDS OF A UNION OR Programmer Response: The IMS or CICS protocols
UNION ALL DO NOT HAVE THE SAME should be used to commit work in these environments.
NUMBER OF COLUMNS SQLSTATE: 2D528
Explanation: The operands of a UNION or UNION
ALL must have the same number of columns. -427 DYNAMIC ROLLBACK NOT VALID AT
System Action: The statement cannot be executed. AN APPLICATION SERVER WHERE
UPDATES ARE NOT ALLOWED
Programmer Response: Correct the SQL statement
so that there are exactly the same number of columns Explanation: An application executing using DRDA
in each operand. protocols has attempted to issue a dynamic ROLLBACK
statement while connected to a location at which
SQLSTATE: 42826 updates are not allowed. A dynamic ROLLBACK may
be issued only while connected to a location at which
-423 INVALID VALUE FOR LOCATOR IN updates are allowed.
POSITION position-# System Action: The statement cannot be executed.
Explanation: The value specified in a result set No ROLLBACK is performed.
locator host variable or a LOB locator host variable Programmer Response: The IMS or CICS protocols
specified at position position-# in the locator variable list should be used to rollback work in these environments.
of the SQL statement does not identify a valid result set
locator or LOB locator variable, respectively. SQLSTATE: 2D529
System Action: The statement cannot be executed.
54 DB2 UDB for OS/390 and z/OS: Messages and Codes
-430 • -440
CHAR defined with a length of 5, or a type VARCHAR
-430 routine-type routine-name (SPECIFIC
defined with a length of 5 or greater. The SQLSTATE
NAME specific-name) HAS
value must follow the rules for application-defined
ABNORMALLY TERMINATED
SQLSTATEs as follows:
Explanation: An abnormal termination has occurred v Each character must be from the set of digits (’0’
while the routine routine-name (stored procedure or through ’9’) or non-accented upper case letters (’A’
function) was in control. through ’Z’).
System Action: The statement cannot be executed. v The SQLSTATE class (first two characters) cannot be
’00’, ’01’ or ’02’ because these are not error classes.
Programmer Response: The stored procedure or
function needs to be fixed. Contact the author of the v If the SQLSTATE class (first two characters) starts
routine or your database administrator. Until it is fixed, with the character ’0’ through ’6’ or ’A’ through ’H’,
the routine should not be used. then the subclass (last three characters) must start
with a letter in the range ’I’ through ’Z’.
SQLSTATE: 38503
v If the SQLSTATE class (first two characters) starts
with the character ’7’, ’8’, ’9’ or ’I’ though ’Z’, then the
-433 VALUE value IS TOO LONG subclass (last three characters) can be any of ’0’
through ’9’ or ’A’ through ’Z’.
Explanation: The value value required truncation by a
system (built-in) cast or adjustment function, which was SQLSTATE: 428B3
called to transform the value in some way. The
truncation is not allowed where this value is used. The
-438 APPLICATION RAISED ERROR WITH
value being transformed is one of the following:
DIAGNOSTIC TEXT: text
v an argument to a user defined function (UDF)
Explanation: This error occurred as a result of
v an input to the SET clause of an UPDATE statement
execution of the RAISE_ERROR function or as a result
v a value being INSERTed into a table of the SIGNAL SQLSTATE statement.
v an input to a cast or adjustment function in some
text Diagnostic text provided by the invocation of
other context.
the RAISE_ERROR function or the SIGNAL
SQLSTATE statement.
If value has the 'for bit data' subtype, then the value is
printed as a hexadecimal string in quotes followed by an System Action: The statement cannot be processed.
X.
Programmer Response: Use application-provided
System Action: The statement cannot be executed. diagnostic text, if provided, to determine the cause of
the error.
Programmer Response: If value is a literal string in
the SQL statement, it is too long for its intended use. If SQLSTATE: application-defined
value is not a literal string, examine the SQL statement
to determine where the transformation is taking place.
-440 NO routine-type BY THE NAME
Either the input to the transformation is too long, or the
routine-name HAVING COMPATIBLE
target is too short. Correct the problem and rerun the
ARGUMENTS WAS FOUND
statement.
Explanation: This occurs in a reference to routine
SQLSTATE: 38xxx
(stored procedure or function) routine-name, when DB2
cannot find a function or stored procedure it can use to
-435 AN INVALID SQLSTATE sqlstate IS implement the reference. There are several reasons
SPECIFIED IN THE FUNCTION why this could occur.
RAISE_ERROR OR IN A SIGNAL v routine-name was either incorrectly specified or does
SQLSTATE STATEMENT not exist in the database.
Explanation: The SQLSTATE specified in the v A qualified reference was made, and the qualifier was
RAISE_ERROR function or specified in a SIGNAL incorrectly spelled.
SQLSTATE statement of a trigger definition does not v A user’s current path does not contain the schema to
conform to the rules for an application defined which the desired function belongs, and an
SQLSTATE. unqualified reference was used.
System Action: The statement cannot be processed. v The wrong number of arguments were included.
Programmer Response: Correct the SQLSTATE v For functions, the data types of one or more of the
specified in the RAISE_ERROR function or SIGNAL arguments is incorrect.
statement. The SQLSTATE must be a character string v The routine invoker is not authorized to execute the
containing exactly 5 characters. It must be of type routine.
Chapter 2. SQL Return Codes 55
-441 • -449
System Action: The statement cannot be executed. However, the MVS load module identified in the
LOADMOD column of the SYSIBM.SYSROUTINES row
Programmer Response: Fix the problem and retry.
could not be found.
This could involve a change to the SQL statement, the
addition of new routines or a change to the user’s name The name of the MVS load module that could
current path. not be found
SQLSTATE: 42884 System Action: The statement cannot be executed.
Programmer Response: If the LOADMOD column
-441 INVALID USE OF ’DISTINCT’ OR ’ALL’ value in the SYSIBM.SYSROUTINES table is incorrect,
WITH SCALAR FUNCTION | use the ALTER FUNCTION or ALTER PROCEDURE
function-name | statement to correct the value.
Explanation: The keyword ’DISTINCT’ or ’ALL’ was If the LOADMOD column value is correct, use the MVS
detected within parentheses in a reference to function linkage editor to create the required MVS load module
function-name and the function has been resolved as a in one of the MVS load libraries used by your
scalar function. Use of the keyword ’DISTINCT’ or ’ALL’ installation for stored procedures.
with a scalar function is invalid.
| This error can also occur if you are invoking a
System Action: The statement cannot be executed. | WLM-managed stored procedure that is not APF
| authorized, and the DB2 load libraries are not in the
Programmer Response: If a scalar function is being
| STEPLIB concatenation because they are being loaded
used, then remove the keyword ’DISTINCT’ or ’ALL’.
| from LINKLIST. In this case, if you want the stored
If a column function is being used, then there is a | procedure program to run APF-authorized, link-edit it
problem with function resolution. Check your current | with AC=1 into an MVS APF authorized library. If you do
path to see if the desired function is in one of the | not want the stored procedure program to run APF
schemas, and also check the SYSIBM.SYSROUTINES | authorized, add the DB2 load library to the STEPLIB
catalog for the spelling of the function name and the | concatenation of the JCL used to start the
number and types of parameters. | WLM-managed address space.
SQLSTATE: 42601 SQLSTATE: 42724
-443 EXTERNAL FUNCTION function-name -449 CREATE OR ALTER STATEMENT FOR
(SPECIFIC NAME specific-name) HAS FUNCTION OR PROCEDURE
RETURNED AN ERROR SQLSTATE routine-name CONTAINS AN INVALID
WITH DIAGNOSTIC TEXT msg-text FORMAT OF THE EXTERNAL NAME
CLAUSE OR IS MISSING THE
Explanation: An SQLSTATE of the form 38xxx was EXTERNAL NAME CLAUSE
returned by function function-name, along with message
text msg-text. Explanation: An error was found in the EXTERNAL
NAME clause of the CREATE FUNCTION, CREATE
If the third character is not 5 (i.e. ’385xx’) then the last 3 PROCEDURE, ALTER FUNCTION, or ALTER
characters of the SQLSTATE value were chosen by the PROCEDURE statement for routine-name, or the clause
function, to indicate the reason of the failure. is needed but was not specified.
SQLSTATEs values of the form 385xx are issued by
IBM with a different SQLCODE. v For a LANGUAGE JAVA or COMPJAVA stored
procedure, or LANGUAGE JAVA user-defined
System Action: The actions in the external function function, the name must be specified and it must
should be rolled back. contain a valid external-java-routine-name of the
following form:
Programmer Response: Contact the author of the
function or your database administrator. Until the
problem is resolved, the function should not be used. jar-name:package-id...class-id.method-id(method-signature)
– Do not include blanks.
SQLSTATE: 42601
– For LANGUAGE COMPJAVA, do not specify a
jar-name.
-444 USER PROGRAM name COULD NOT – The method-name consists of the list of
BE FOUND package-ids, class-id, and method-id, and must
Explanation: DB2 received an SQL CALL statement not be longer than 254 bytes.
for a stored procedure or an SQL statement containing – For LANGUAGE JAVA, zero or more package-ids
an invocation of a user-defined function, and found the may be specified preceding the class-id
row in the SYSIBM.SYSROUTINES catalog table – For LANGUAGE COMPJAVA,
associated with the requested procedure name.
56 DB2 UDB for OS/390 and z/OS: Messages and Codes
-450 • -454
– The method-signature is optional, and is a list of
-451 THE data-item DEFINITION, IN THE
Java data types that are separated by commas. If
CREATE FUNCTION FOR function-name
specified, the method-signature must not be
CONTAINS DATA TYPE type WHICH IS
longer than 1024 bytes.
NOT APPROPRIATE FOR AN
– If multiple strings are specified, the total length of EXTERNAL FUNCTION WRITTEN IN
all the strings concatenated together for the THE GIVEN LANGUAGE
external-java-routine-name must not be greater
than 1305. Explanation: An error was made in the data-item part
of the CREATE FUNCTION statement for
v For external routines with a language other than
function-name. The CREATE FUNCTION statement
JAVA or COMPJAVA, the external name must be a
contained an invalid type, or it contained a distinct type
short identifier with letters or digits. The first character
which is based on the invalid type.
must be a letter. (This is the MVS naming convention
for load modules). A possible cause for this error is System Action: The statement cannot be executed.
the inclusion of a blank in the name.
Programmer Response: Correct the statement.
If the clause is omitted, the external name defaults to
function-name. However, for CREATE FUNCTION or SQLSTATE: 42815
CREATE PROCEDURE if the function or procedure
name is longer than eight characters then the -453 THERE IS A PROBLEM WITH THE
EXTERNAL NAME clause must be explicitly specified RETURNS CLAUSE IN THE CREATE
to specify a valid short identifier as the external FUNCTION STATEMENT FOR
name. function-name
System Action: The statement cannot be executed. Explanation: A problem casting the result of
Programmer Response: Correct the syntax of the user-defined function function-name has been identified.
SQL statement. Refer to the DB2 SQL Reference for The CAST FROM data type is not castable to the
information on the EXTERNAL NAME clause. RETURNS data type, and it must be. See the SQL
Reference for details on casting between data types.
User Response: When LANGUAGE is JAVA or
COMPJAVA, possible causes include: System Action: The statement cannot be executed.
v Omitting hte EXTERNAL NAME clause. Programmer Response: Change the RETURNS or
v Including a blank. CAST FROM clause so that the CAST FROM data type
is castable to the RETURNS data type.
v Having the '!' at the beginning or end of the name.
v Specifying an invalid external-java-routine-name. SQLSTATE: 42880
SQLSTATE: 42878
-454 THE SIGNATURE PROVIDED IN THE
CREATE FUNCTION STATEMENT FOR
-450 USER-DEFINED FUNCTION OR function-name MATCHES THE
STORED PROCEDURE name, SIGNATURE OF SOME OTHER
PARAMETER NUMBER parmnum, FUNCTION ALREADY EXISTING IN THE
OVERLAYED STORAGE BEYOND ITS SCHEMA
DECLARED LENGTH.
Explanation: The signature consists of the function
Explanation: Upon return from a specific function name (function-name), the number of parameters
name or a stored procedure name, DB2 has detected defined for the function, and an ordered list of the types
an overlay storage beyond a parameter’s declared of the parameters (without regard to any parameters of
length. The parameter number is specified for a stored the types). In this case there is a function already in the
procedure or function. This is not permitted. schema and the existing function has the same
System Action: The statement cannot be executed. signature as the function being created. See the SQL
Reference for the details on the uniqueness of a
Programmer Response: Contact the author of the function.
function or your database administrator. Until it is fixed,
the function should not be used. System Action: The statement cannot be executed.
SQLSTATE: 39501 Programmer Response: Determine if the existing
function already provides the functionality desired. If not,
then the new function’s signature will have to be
changed (e.g. change the function name).
SQLSTATE: 42723
Chapter 2. SQL Return Codes 57
-455 • -458
Programmer Response: Select a name for the
-455 IN CREATE FUNCTION FOR
function or distinct type that is not reserved for system
function-name, THE SCHEMA NAME
use.
schema-name1 PROVIDED FOR THE
SPECIFIC NAME DOES NOT MATCH SQLSTATE: 42939
THE SCHEMA NAME schema-name2 OF
THE FUNCTION
| -458 IN A REFERENCE TO FUNCTION
Explanation: If the SPECIFIC name is specified as a | function-name BY SIGNATURE, A
two part name, the schema-name1 portion must be the | MATCHING FUNCTION COULD NOT BE
same as the schema-name2 portion of the | FOUND
function-name. Note that the schema-name2 portion of
function-name may have been specified directly or it | Explanation: In a reference to function function-name
may have defaulted to the authorization ID of the | by signature, no matching function could be found. The
statement. | problem could be with the data type or some other
| attributes of a parameter. For some data types there are
System Action: The statement cannot be executed. | attributes in addition to data type:
Programmer Response: Correct the statement. | v Length, precision, or scale
| While it is not necessary to specify a length,
SQLSTATE: 42882
| precision, or scale attribute for a data type, if one is
| specified then there must be an exact match on the
-456 IN CREATE FUNCTION FOR | corresponding specification of the parameter for the
function-name, THE SPECIFIC NAME | existing function as defined in SYSPARMS.
specific-name ALREADY EXISTS IN THE | A type of FLOAT(n) does not need to match the
SCHEMA | defined value for n since 1<=n<=21 means REAL
Explanation: A SPECIFIC name has been explicitly | and 22<=n<=53 means DOUBLE. Matching occurs
specified as specific-name in the CREATE FUNCTION | based on whether the type is REAL or DOUBLE.
statement for function-name, but this name already | However, a match on data type is sufficient.
exists as the SPECIFIC name for another function | To indicate this, an empty set of parentheses must be
within the schema. | specified for the data types that allow a specification
System Action: The statement cannot be executed. | of length, precision, or scale. For example, assuming
| a function exists for which a parameter was defined
Programmer Response: Choose a new SPECIFIC | as CHAR(12) on the CREATE FUNCTION statement,
name. | a reference to that function by a signature could
SQLSTATE: 42710 | specify this parameter as either CHAR(12), or
| CHAR(). The CHAR() syntax provides a way to say
| ″don’t care about length, precision and scale
-457 A FUNCTION OR DISTINCT TYPE | attributes in finding a matching function″.
CANNOT BE CALLED name SINCE IT | FLOAT() cannot be used since the parameter value
IS RESERVED FOR SYSTEM USE | indicates different data types (REAL or DOUBLE).
Explanation: The user-defined function or distinct type | If, however, neither length, presision, scale, or empty
cannot be created or referenced because the name | parenthesis were specified, then normal default rules
selected is reserved for use by the system. | apply. For example, a specification of CHAR would
| result in CHAR(1) as on the CREATE TABLE
A number of names used as keywords are reserved for
| statement. Furthermore, this implicit specification of
system use. These names may not be used as
| length, precision, or scale must exactly match the
user-defined functions or distinct-type-names, even if
they are delimited identifiers. These names are:
| corresponding specification of the parameter for the
| existing function as defined in SYSPARMS.
= < > >= <=
| v Subtype, or encoding scheme
¬= ¬> ¬>
ALL AND ANY BETWEEN DISTINCT | You do not need to specify the subtype or encoding
EXCEPT EXISTS FALSE FOR FROM | scheme (CCSID clause) to identify an existing
IN IS LIKE MATCH NOT | function in the database. However, if a subtype or
NULL ONLY OR OVERLAPS SIMILAR | encoding scheme is specified then there there must
SOME TABLE TRUE TYPE UNIQUE | be an exact match on the corresponding specification
UNKNOWN | of the parameter for the existing function as defined
| in SYSPARMS.
| The names of built-in data types cannot be used as the
| name of a distinct type (for example, CHAR). | Unqualified function names:
System Action: The statement is not executed. | v For ALTER FUNCTION, DROP FUNCTION,
| COMMENT ON FUNCTION, GRANT and REVOKE
58 DB2 UDB for OS/390 and z/OS: Messages and Codes
-461 • -470
| statements for EXECUTE on functions, an unqualified System Action: The statement could not be executed.
| function name is implicitly qualified with the statement
Programmer Response: The user-defined function or
| authorization ID, and this is the schema where the
stored procedure needs to be corrected. See your
| function with the problem can be found.
database administrator, or the author of the function to
| v In the SOURCE clause of a CREATE FUNCTION find out the meaning of the warning. The significance of
| statement, the qualification comes from the SQL the bad SQLSTATE to the invoking application can be
| path. In this case, the is no matching function in the learned from the author of the function.
| entire path.
SQLSTATE: 39001
| Note: A function cannot be sourced on the
| COALESCE, NULLIF, RAISE_ERROR, or -469 SQL CALL STATEMENT MUST
| VALUE built-in functions. Additionally, there SPECIFY AN OUTPUT HOST VARIABLE
| are restrictions on the way that you can FOR PARAMETER number
| source on the COUNT, COUNT_BIG, CHAR,
| and STRIP built-in functions because of some Explanation: DB2 received an SQL CALL statement
| of the keywords that they accept. for a stored procedure. DB2 found the row in the
SYSIBM.SYSROUTINES catalog table associated with
| System Action: The statement cannot be executed. the requested procedure name. However, parameter
| Programmer Response: Possible responses include: number was identified in the SYSIBM.SYSPARMS table
| v Changing the SQL path to include the correct as an OUT or INOUT parameter. A host variable must
| schema. be supplied on the SQL CALL statement for parameters
| v Changing the attibutes of the parameters. defined as OUT or INOUT.
| v Using a SPECIFIC name to refer to the function number
| instead of a signature. The parameter number from the ORDINAL field
| SQLSTATE: 42883 in SYSIBM.SYSPARMS.
System Action: The statement cannot be executed.
-461 A VALUE WITH DATA TYPE Programmer Response: If the SQL CALL statement
source-data-type CANNOT BE CAST TO is coded incorrectly, modify the SQL application to
TYPE target-data-type provide an output host variable on the SQL CALL
Explanation: The statement contains a CAST with the statement.
first operand having a data type of source-data-type to If the SYSIBM.SYSPARMS table contains incorrect
be cast to the data type target-data-type. This is not information, the DROP PROCEDURE and CREATE
supported. PROCEDURE statements must be used to replace the
Change the data type of either the source or target so catalog definition for the stored procedure.
that the cast is supported. For predefined (built-in) data SQLSTATE: 42886
types or a cast involving a user-defined distinct type,
see the SQL Reference.
-470 SQL CALL STATEMENT SPECIFIED A
System Action: The statement could not be NULL VALUE FOR INPUT PARAMETER
processed. number, BUT THE STORED
Programmer Response: Correct the CAST PROCEDURE DOES NOT SUPPORT
specification to specify a supported combination of NULL VALUES.
source and target types. Explanation: DB2 received an SQL CALL statement
SQLSTATE: 42846 for a stored procedure and found a null value in the
incoming parameter list. The stored procedure was
defined in the SYSIBM.SYSROUTINES catalog table
-463 EXTERNAL ROUTINE routine-name with PARAMETER_STYLE of GENERAL, which
(SPECIFIC NAME specific-name) HAS specifies that the routine does not accept null values.
RETURNED AN INVALID SQLSTATE
sqlstate, WITH DIAGNOSTIC TEXT text A call to a stored procedure with a LANGUAGE value of
COMPJAVA receives this SQLCODE if an input
Explanation: The valid SQLSTATEs that a parameter in the compiled Java stored procedure has a
user-defined function or stored procedure can return are Java base type that cannot be set to a null value.
38xxx (error), 38502 (error) and 01Hxx (warning).
User-defined function or stored procedure routine-name number
returned an invalid SQLSTATE sqlstate, along with The parameter number from the ORDINAL field
message text text. The user-defined function or stored in SYSIBM.SYSPARMS.
procedure is in error. System Action: The statement cannot be executed.
Chapter 2. SQL Return Codes 59
-471 • -476
Programmer Response: If the stored procedure System Action: The statement could not be
should not accept null values, change the calling processed.
application to provide a nonnull value.
Programmer Response: Correct the statement to use
If the stored procedure should accept null values, use another identifier for the name of the new user-defined
the ALTER PROCEDURE statement to change the type.
PARAMETER STYLE of the stored procedure to be
SQLSTATE: 42918
DB2SQL or GENERAL WITH NULLS.
SQLSTATE: 39004
-475 THE RESULT TYPE type-1 OF THE
SOURCE FUNCTION CANNOT BE
| -471 INVOCATION OF FUNCTION OR CAST TO THE RETURNS TYPE type-2
| PROCEDURE name FAILED DUE TO OF THE USER-DEFINED FUNCTION
| REASON rc function-name
| Explanation: A routine was invoked. The routine Explanation: In order for the CREATE FUNCTION for
| invocation was not accepted because of DB2 reason a sourced user-defined function to be valid, the result
| code rc. type (type-1) of the source function must be castable to
the RETURNS type (type-2) of the function being
| name The name of the routine that was invoked.
created. There is no supported cast between these data
| rc The DB2 reason code describing the cause of types. See the DB2 SQL Reference for details on
| the failure. casting between data types.
| System Action: The statement cannot be executed. A System Action: The statement cannot be executed.
DSNX9xx message describing the error might be
Programmer Response: Change the RETURNS data
displayed on the MVS system console.
type or the SOURCE function identified so that the
Programmer Response: Correct the condition result type of the SOURCE function is castable to the
described by the DB2 reason code. RETURNS data type.
SQLSTATE: 55023 SQLSTATE: 42866
-472 CURSOR cursor-name WAS LEFT OPEN -476 REFERENCE TO FUNCTION
BY EXTERNAL FUNCTION function-name WAS NAMED WITHOUT A
function-name (SPECIFIC NAME SIGNATURE, BUT THE FUNCTION IS
specific-name) NOT UNIQUE WITHIN ITS SCHEMA
Explanation: The function program did not close the Explanation: References to a function without a
specified cursor. Modify the function program so that it signature are permitted, but the named function
closes the cursor. function-name must be unique in its schema and it is
not.
System Action: The statement cannot be executed.
Note also that in the ALTER FUNCTION, DROP
Programmer Response: Reissue the statement when FUNCTION, COMMENT ON FUNCTION, GRANT and
desired. REVOKE statements for EXECUTE on functions, an
SQLSTATE: 24517 unqualified reference is qualified with the statement
authorization ID, and this is the schema where the
problem can be found. In the SOURCE clause of a
-473 A USER DEFINED DATA TYPE CANNOT CREATE FUNCTION statement, the qualification comes
BE CALLED THE SAME NAME AS A from the CURRENT PATH. In this case, the first schema
SYSTEM PREDEFINED TYPE (BUILT-IN in the path containing a function with this name had
TYPE) other functions by the same name.
Explanation: The name of a data type to be created System Action: The statement cannot be executed.
has an unqualified name that is the same as a
system-predefined data type or is BOOLEAN. This is Programmer Response: Correct the reference by one
not allowed. Adding delimiters does not make the name of the following:
valid. The following names are restricted: v completing the signature
v using the SPECIFIC name of the desired function
BLOB CHAR
CHARACTER CLOB DATE DBCLOB v changing the CURRENT PATH
DEC DECIMAL DOUBLE FLOAT GRAPHIC SQLSTATE: 42725
INT INTEGER NUMERIC REAL
ROWID SMALLINT TIME TIMESTAMP VARCHAR
VARGRAPHIC
60 DB2 UDB for OS/390 and z/OS: Messages and Codes
-478 • -482
If type1 is DISTINCT TYPE, the dependencies
-478 DROP OR REVOKE ON OBJECT TYPE
for REVOKE might be:
type1 CANNOT BE PROCESSED
BECAUSE OBJECT name OF TYPE v A parameter of a function owned by the
type2 IS DEPENDENT ON IT revokee is defined as this distinct type.
v A column of a table owned by the revokee is
Explanation: The requested action cannot be
defined as this distinct type.
processed because a dependency exists on this type1.
type2 is the type of object that has the dependency on v A parameter of a stored procedure owned by
the type1 object involved in the DROP or REVOKE. the revokee is defined as this distinct type.
type2 can be one of the following: If type1 is PROCEDURE, the dependencies for
v FUNCTION REVOKE might be:
v PROCEDURE v A trigger definition owned by the revokee
v TABLE contains a CALL statement with the name of
this stored procedure.
v VIEW
v TRIGGER (for the trigger package) This SQLCODE may also be issued when SYSADM is
v CHECK CONSTRAINT (object_name contains the being revoked. When SYSADM is revoked the
table name) cascading of the REVOKE statement may encounter
v DEFAULT (object_name contains the table name) dependencies that prevent the REVOKE from being
successfully processed.
DROP If type1 is FUNCTION, the dependencies for
DROP might be: System Action: The statement cannot be executed.
v Another function is sourced on this function. Programmer Response: Remove the dependencies
v A view uses this function. on this object and then reissue the request.
v A trigger package uses this function. SQLSTATE: 42893
v A table uses this function in a check
constraint or user-defined default. -480 THE PROCEDURE procedure-name HAS
NOT YET BEEN CALLED
The dependency might be on one of the
generated cast functions for a distinct type. If Explanation: The procedure identified in a DESCRIBE
type1 is DISTINCT TYPE, the dependencies PROCEDURE or an ASSOCIATE LOCATORS
for DROP might be: statement has not yet been called within the application
process or the procedure has been called, but an
v A parameter of a function is defined as this
explicit or implicit commit occurred before the statement.
distinct type.
v A column of a table is defined as this distinct System Action: The statement cannot be executed.
type. Programmer Response: Correct the statements so
v A parameter of a stored procedure is defined that the exact syntax used to specify the procedure
as this distinct type. name on the CALL statement be the same as that on
the ASSOCIATE LOCATOR and/or DESCRIBE
If type1 is PROCEDURE, the dependencies for
PROCEDURE. If an unqualified name is used to CALL
DROP might be:
the procedure, the 1-part name must also be used on
v A trigger definition contains a CALL the other statements. If the CALL statement is made
statement with the name of this stored with a 3-part name, and the current server is the same
procedure as the location in the 3-part name, the ASSOCIATE
REVOKE LOCATOR or DESCRIBE procedure can omit the
If type1 is FUNCTION, the dependencies for location. Rerun the statements.
REVOKE might be: SQLSTATE: 51030
v A function owned by the revokee is sourced
on this function.
-482 THE PROCEDURE procedure-name
v A view owned by the revokee uses this RETURNED NO LOCATORS
function.
Explanation: The procedure identified in an
v A trigger package owned by the revokee
ASSOCIATE LOCATORS statement returned no result
uses this function.
set locators.
v A table owned by the revokee uses this
function in a check constraint or System Action: The statement cannot be executed.
user-defined default. Programmer Response: Determine if result set
locators are returned from the identified procedure by
Chapter 2. SQL Return Codes 61
-483 • -492
using the DESCRIBE PROCEDURE statement. | failing SQL statement from the external function or
| procedure.
SQLSTATE: 51030
| SQLSTATE: 38001
-483 IN CREATE FUNCTION FOR
function-name STATEMENT, THE | -490 NUMBER number DIRECTLY SPECIFIED
NUMBER OF PARAMETERS DOES NOT | IN AN SQL STATEMENT IS OUTSIDE
MATCH THE NUMBER OF | THE RANGE OF ALLOWABLE VALUES
PARAMETERS OF THE SOURCE | IN THIS CONTEXT (minval, maxval)
FUNCTION
| Explanation: A number (number) was specified that is
Explanation: An attempt is being made to CREATE a | not valid in the context in which it was specified. The
user-defined function function-name which is sourced on | minimum allowed value in this context is minval. The
another function. One of the following situations has | maximum allowed value in this context is maxval. n
been identified: | must be within the range specified by minval and
v The SOURCE clause uses a function-name (input | maxval (minval =< n =< maxval).
parameter list) to identify the source function, and the | System Action: The statement was not executed.
number of types in the list is different from the
number of parameters of the function being created. | Programmer Response: Change the value n to a
| valid value in the statement.
v The SOURCE clause uses different syntax to identify
the source function, and the number of types of that | SQLSTATE: 428B7
function is different from the number of parameters of
the function being created.
| -491 CREATE STATEMENT FOR
System Action: The statement cannot be executed. | USER-DEFINED FUNCTION
| function-name MUST HAVE A RETURNS
Programmer Response: The number of parameters
| CLAUSE AND: THE EXTERNAL
for the SOURCE function and for the function being
created must be the same. The identification of the
| CLAUSE WITH OTHER REQUIRED
SOURCE function needs to be changed to:
| KEYWORDS; THE RETURN
v fix the input parameter list
| STATEMENT AND PARAMETER
v correct the function name or function specific name to
| NAMES; OR THE SOURCE CLAUSE
identify the proper function. Explanation: A required clause is missing in the
CREATE for function function-name.
It is also possible that the current path needs to be | v For an EXTERNAL function, specify EXTERNAL and
corrected in order for correct function resolution to | one of the following:
occur. | – LANGUAGE
SQLSTATE: 42885 | – PARAMETER STYLE
| v For an SQL FUNCTION, specify a RETURN
| statement, and a parameter name for each
| -487 object-type object-name ATTEMPTED TO
| parameter.
| EXECUTE AN SQL STATEMENT WHEN
| THE DEFINITION OF THE FUNCTION | v For a user-defined SOURCE FUNCTION, specify the
| OR PROCEDURE DID NOT SPECIFY | SOURCE class.
| THIS ACTION System Action: The statement cannot be processed.
| Explanation: A user-defined function or stored | Programmer Response: Add the missing clauses or
| procedure object-name was invoked and attempted to | statement, and reissue the failing statement.
| execute SQL statements, but the function or procedure
| was created with the NO SQL option. SQLSTATE: 42601
| In an environment of nested functions and procedures,
| the SQL option in effect is the most restrictive one that -492 THE CREATE FUNCTION FOR
| has been specified in the nested hierarchy of functions function-name HAS A PROBLEM WITH
| an procedures. The SQL data access option in effect PARAMETER NUMBER number. IT MAY
| does not allow for modifying data. INVOLVE A MISMATCH WITH A
SOURCE FUNCTION
| System Action: The SQL statement cannot be
| executed. Explanation: The parameter in position number of
function function-name is in error. The parameter in
| Programmer Response: Either use an ALTER position number of the source function is not castable to
| statement to change the definition of the function or the corresponding parameter of the function being
| procedure to allow SQL statements, or remove the created.
62 DB2 UDB for OS/390 and z/OS: Messages and Codes
-495 • -497
If the parameter of the function being created is a table might also be that UDFs will be invoked when the
parameter then the corresponding parameter of the statement is executed, or for INSERT, UPDATE, or
source function must also be a table parameter. DELETE statements that triggers are defined on the
Furthermore, the column numbers for both of the table changed table. Check the DSN_STATEMNT_TABLE or
parameters must be the same. the IFCID 22 record for this statement to find the
reasons this SQL statement has been put in cost
If the parameter of the function being created is not a
category “B”. If the program cannot be changed, or if
table parameter then the corresponding parameter of
statistics cannot be obtained, ask the administrator to
the source function must also not be a table parameter.
change the value in the RLF_CATEGORY_B column in
System Action: The statement cannot be executed. the RLST to “Y” which allows the statement to execute
or “W” which returns a warning instead of an error.
Programmer Response: Possible corrections include:
v Identify a different source function. User Response: If the warning is caused by an SQL
statement that is consuming too much processor
v Change the data type of the parameter of the resource, attempt to rewrite the statement to perform
function being created so that the data type of the more efficiently. Another option is to ask the
source function can be cast to this data type. administrator to increase the error threshold value in the
SQLSTATE: 42879 RLST.
SQLSTATE: 57051
-495 ESTIMATED PROCESSOR COST OF
estimate-amount1 PROCESSOR -496 THE SQL STATEMENT CANNOT BE
SECONDS (estimate-amount2 SERVICE EXECUTED BECAUSE IT
UNITS) IN COST CATEGORY REFERENCES A RESULT SET THAT
cost-category EXCEEDS A RESOURCE WAS NOT CREATED BY THE
LIMIT ERROR THRESHOLD OF limit- CURRENT SERVER
amount SERVICE UNITS
Explanation: The SQL statement cannot be executed
Explanation: The prepare of a dynamic INSERT, because the current server is different from the server
UPDATE, DELETE, or SELECT SQL statement resulted that called a stored procedure. The SQL statement can
in a cost estimate that exceeded the error threshold be any of the following:
value specified in the resource limit specification table v ALLOCATE CURSOR
(RLST). This error is also issued if DB2’s cost category v DESCRIBE CURSOR
value was “B”, and the default action specified in the v FETCH (using an allocated cursor)
RLF_CATEGORY_B column in the RLST is to issue an v CLOSE (using an allocated cursor)
error.
System Action: The statement cannot be executed.
estimate_amount1
The cost estimate (in processor seconds) if the Programmer Response: Connect to the server that
prepared INSERT, UPDATE, DELETE or called the stored procedure which created the result set
SELECT statement were to be executed. before running the SQL statement that failed.
estimate_amount2 SQLSTATE: 51033
The cost estimate (in service units) if the
prepared INSERT, UPDATE, DELETE or
-497 THE MAXIMUM LIMIT OF INTERNAL
SELECT statement were to be executed.
IDENTIFIERS HAS BEEN EXCEEDED
cost-category FOR DATABASE database-name
DB2’s cost-category for this SQL statement.
Explanation: The SQL statement cannot be executed
The possible values are A or B.
because an internal identifier limit has been exceeded
limit-amount for the database. The cause of this error is due to one
The error threshold (in service units) specified of the following: (1) On a CREATE DATABASE
in the RLFASUERR column of the RLST. statement, the limit of 65279 DBIDs has been
exceeded. (2) For all other statements, the limit of
System Action: The prepare of the dynamic INSERT, 65279 OBIDs has been exceeded for that database.
UPDATE, DELETE, or SELECT statement was
unsuccessful. System Action: The SQL statement cannot be
executed.
Programmer Response: If this SQLCODE was
returned because the cost category value is “B”, it might Programmer Response: (1) In the case of a DBID
be that the statement is using parameter markers or limit being exceeded, DROP all unused databases and
that some statistics are not available for the referenced issue a COMMIT. (2) In the case of an OBID limit being
tables and columns. Make sure the administrator has exceeded, DROP all unused objects in the database
run the utility RUNSTATS on the referenced tables. It and issue a COMMIT, specify a different database or
Chapter 2. SQL Return Codes 63
-499 • -502
run the MODIFY utility to reclaim unused OBIDs. application plan was bound with the
DISCONNECT(AUTOMATIC) option.
SQLSTATE: 54041
System Action: The statement cannot be executed.
-499 CURSOR cursor-name HAS ALREADY Programmer Response: The correction depends on
BEEN ASSIGNED TO THIS OR the desired state of both the cursor and the connection,
ANOTHER RESULT SET FROM as follows:
PROCEDURE procedure-name. v If you want the cursor closed, change the application
Explanation: An attempt was made to assign a cursor program so that the cursor is not referenced in the
to a result set using the SQL statement ALLOCATE closed state.
CURSOR and one of the following applies: v If you want the cursor open and the connection was
v The result set locator variable specified in the placed in the released state by the application
ALLOCATE CURSOR statement has been previously program, change the program so that the connection
assigned to cursor cursor-name. is not placed in the released state until the cursor is
explicitly closed.
v Cursor cursor-name specified in the ALLOCATE
CURSOR statement has been previously assigned to v If you want the cursor open and the connection was
a result set from stored procedure procedure-name. placed in the released state as a result of the
DISCONNECT(AUTOMATIC) option, rebind the plan
System Action: The statement cannot be executed. using DISCONNECT(CONDITIONAL).
Programmer Response: Determine if the target result
set named in the ALLOCATE CURSOR statement has Correct the error in the application, rebind the plan, and
been previously assigned to a cursor. resubmit the job.
If the result set has been previously assigned to cursor SQLSTATE: 24501
cursor-name, then either choose another target result
set or call stored procedure procedure-name again and -501 THE CURSOR IDENTIFIED IN A FETCH
reissue the ASSOCIATE LOCATOR and ALLOCATE OR CLOSE STATEMENT IS NOT OPEN
CURSOR statements.
Explanation: The application program attempted to
If the result set has not been previously assigned to a either:
cursor, the cursor cursor-name specified in the
1. FETCH using a cursor, or
ALLOCATE CURSOR statement has been previously
assigned to some result set from stored procedure 2. CLOSE a cursor
procedure-name. You can not assign cursor at a time when the specified cursor was not open.
cursor-name to another result set, so you must specify
a different cursor name in the ALLOCATE CURSOR System Action: The statement cannot be executed.
statement.
Programmer Response: Check for a previous SQL
Correct the statements so that the exact syntax used to return code that may have closed the cursor. Commit
specify the procedure name on the CALL statement be and rollback operations close cursors. SQLCODES
the same as that on the ASSOCIATE LOCATOR and/or | -404, -652, -679, -802, -901, -904, -909, -910, -911, and
DESCRIBE PROCEDURE. If an unqualified name is -913 will force the cursor to close. After the cursor is
used to CALL the procedure, the 1-part name must also closed, any fetches or close cursor statements will
be used on the other statements. If the CALL statement receive this SQLCODE -501.
is made with a 3-part name, and the current server is
If no previous SQL return codes have been issued,
the same as the location in the 3-part name, the
correct the logic of the application program to ensure
ASSOCIATE LOCATOR or DESCRIBE procedure can
that the cursor is open at the time the FETCH or
omit the location.
CLOSE statement is executed.
SQLSTATE: 24516
SQLSTATE: 24501
-500 THE IDENTIFIED CURSOR WAS
-502 THE CURSOR IDENTIFIED IN AN OPEN
CLOSED WHEN THE CONNECTION
STATEMENT IS ALREADY OPEN
WAS DESTROYED
Explanation: The application program attempted to
Explanation: The FETCH, UPDATE, DELETE, or
execute an OPEN statement for a cursor that was
CLOSE statement identifies a closed cursor that was
already open.
defined with the WITH HOLD option. The cursor was
closed when the connection on which it was dependent System Action: The statement cannot be executed.
was destroyed during a commit operation. The The cursor was unchanged (that is, it was not
connection was destroyed because the application 'reopened').
process placed it in the released state, or the
64 DB2 UDB for OS/390 and z/OS: Messages and Codes
-503 • -507
Programmer Response: Correct the logic of the System Action: The statement cannot be executed.
application program to ensure that it does not attempt to
Programmer Response: Check the application
execute an OPEN statement for a cursor that is already
program for completeness and for a possible spelling
open.
error in the cursor declaration or allocation. The
SQLSTATE: 24502 declaration for or allocation of a cursor must appear in
an application program before SQL statements that
reference the cursor.
-503 A COLUMN CANNOT BE UPDATED
BECAUSE IT IS NOT IDENTIFIED IN If the cursor-name was <UNKNOWN>, then the cursor
THE UPDATE CLAUSE OF THE was not successfully declared or allocated. This can
SELECT STATEMENT OF THE CURSOR occur if SQL(DB2) was used, and a warning message
was issued during precompilation. Check the precompile
Explanation: The application program attempted to
output for warning messages on the DECLARE
update (using a cursor) a value in a column of the
CURSOR or ALLOCATE CURSOR statement, and
object table that was not identified in the FOR UPDATE
correct the statement.
clause in the cursor declaration.
For an allocated cursor, if an implicit or explicit
Any column that is to be updated must be identified in
COMMIT, ROLLBACK, or CLOSE occurred since the
the FOR UPDATE clause of the cursor declaration.
cursor was successfully allocated, modify the application
System Action: The statement cannot be executed. program logic to do one of the following:
No data was updated in the object table. v After the COMMIT, ROLLBACK, or CLOSE operation,
Programmer Response: Correct the application call the associated stored procedure again, and
program. If the column is to be updated, its name must reissue the ASSOCIATE LOCATORS and ALLOCATE
be added to the FOR UPDATE clause of the cursor CURSOR statements.
declaration. v For COMMIT, declare the associated cursor in the
stored procedure WITH HOLD so the COMMIT
SQLSTATE: 42912 operation will not deallocate the cursor.
-504 THE CURSOR NAME cursor-name IS For an allocated cursor, if the associated stored
NOT DEFINED procedure was called again and new result sets were
returned since the cursor was allocated, reissue the
Explanation: Cursor cursor-name was referenced in ASSOCIATE LOCATORS and ALLOCATE CURSOR
an SQL statement, and one of the following is true: statements.
v Cursor cursor-name was not declared (using the
DECLARE CURSOR statement) or allocated (using SQLSTATE: 34000
the ALLOCATE CURSOR statement) in the
application program before it was referenced. -507 THE CURSOR IDENTIFIED IN THE
v Cursor cursor-name was referenced in a positioned UPDATE OR DELETE STATEMENT IS
UPDATE or DELETE statement which is not a NOT OPEN
supported operation for an allocated cursor.
Explanation: The application program attempted to
v Cursor cursor-name was allocated, but a CLOSE execute an UPDATE or DELETE WHERE CURRENT
cursor statement naming cursor-name was issued OF cursor statement at a time when the specified cursor
and deallocated the cursor before this cursor was not open.
reference.
System Action: The statement cannot be executed.
v Cursor cursor-name was allocated, but a ROLLBACK
No update or delete was performed.
operation occurred and deallocated the cursor before
this cursor reference. Programmer Response: Check for a previous SQL
v Cursor cursor-name was allocated, but its associated return code that might have closed the cursor.
cursor declared in a stored procedure was not SQLCODES -404, -652, -679, -901, -904, -909, -910,
declared WITH HOLD, and a COMMIT operation -911, and -913 force the cursor to close. After the cursor
occurred and deallocated the cursor before this is closed, any fetches or close cursor statements
cursor reference. The COMMIT operation can be receive SQLCODE -501. Any updates or deletes receive
either explicit (the COMMIT statement) or implicit this SQLCODE -507. Correct the logic of the application
(that is, a stored procedure defined as program to ensure that the specified cursor is open at
COMMIT_ON_RETURN = ’Y’ was called before this the time the UPDATE or DELETE statement is
cursor reference). executed.
v Cursor cursor-name was allocated, but its associated SQLSTATE: 24501
stored procedure was called again since the cursor
was allocated, new result sets were returned, and
cursor cursor-name was deallocated.
Chapter 2. SQL Return Codes 65
-508 • -511
ONLY, or because the application is bound
-508 THE CURSOR IDENTIFIED IN THE
CURRENTDATA(NO) and the cursor is ambiguous.
UPDATE OR DELETE STATEMENT IS
NOT POSITIONED ON A ROW This error code is also returned if DB2 has employed
parallelism to execute the SELECT statement
Explanation: The application program attempted to
associated with the cursor named in a DELETE
execute an UPDATE or DELETE WHERE CURRENT
WHERE CURRENT OF cursor statement, or if a
OF cursor statement at a time when the specified cursor
DELETE WHERE CURRENT OF is issued against a
was not positioned on a row of the object table. The
row which DB2 cannot guarantee to have not been
cursor must be positioned on the row that is to be
modified by another application since the time the
updated or deleted.
cursor was positioned upon it (in accordance with
This SQL code can be issued if the cursor is no longer ISO(CS)) semantics for an ambiguous cursor in an
positioned on the row because another cursor in the application bound CURRENTDATA(NO)).
same application program delete the row or updates an
System Action: The statement cannot be processed.
index column. This includes deletes and index column
No data was updated or deleted in the object table.
updates that are performed as a result of rolling back to
a savepoint. Programmer Response: The requested UPDATE or
DELETE cannot be performed. Refer to Chapter 5 of
System Action: The statement cannot be executed.
DB2 SQL Reference for information about restrictions
No data was updated or deleted.
on using UPDATE and DELETE operations against
Programmer Response: Correct the logic of the views.
application program to ensure that the cursor is
For a remote table, modify the DECLARE CURSOR and
correctly positioned on the intended row of the object
then rebind the PLAN.
table before the UPDATE or DELETE statement is
executed. Note that the cursor is not positioned on a For a cursor that uses parallelism, disable parallelism
row if FETCH returned an SQLCODE = 100. for the query by using the DEGREE(1) BIND option for
static SQL or by setting the CURRENT DEGREE
SQLSTATE: 24504
special register to '1' for dynamic SQL.
For an ambiguous cursor in an application bound
-509 THE TABLE IDENTIFIED IN THE
CURRENTDATA(NO), either make the cursor
UPDATE OR DELETE STATEMENT IS
unambiguous (declare it FOR UPDATE OF), or rebind
NOT THE SAME TABLE DESIGNATED
the application CURRENTDATA(YES).
BY THE CURSOR
SQLSTATE: 42828
Explanation: The application program attempted to
execute an UPDATE or DELETE WHERE CURRENT
OF cursor statement where the table named in that -511 THE FOR UPDATE CLAUSE CANNOT
statement did not match the name of the table specified BE SPECIFIED BECAUSE THE TABLE
in the declaration for that cursor. DESIGNATED BY THE CURSOR
CANNOT BE MODIFIED
System Action: The statement cannot be executed.
The update or delete was not performed. Explanation: The result table of the SELECT
statement cannot be updated. This can occur if the
Programmer Response: Correct the application
SELECT specifies more than one table or view in the
program to ensure that the table identified in the
FROM clause, if the SELECT list contains a built-in
UPDATE or DELETE statement is the same table
function or DISTINCT, or if the statement contains an
identified in the declaration for the cursor.
ORDER BY or GROUP BY or HAVING clause. This can
SQLSTATE: 42827 also occur if a view is specified in the FROM clause and
the view cannot be updated.
-510 THE TABLE DESIGNATED BY THE System Action: The statement cannot be executed.
CURSOR OF THE UPDATE OR DELETE The specified cursor remains undefined in the
STATEMENT CANNOT BE MODIFIED application program.
Explanation: The application program attempted to Programmer Response: Updates cannot be
execute an UPDATE or DELETE WHERE CURRENT performed on the result table as it is specified. Refer to
OF cursor statement against a table or view that cannot Chapter 5 of DB2 SQL Reference for information about
be updated or deleted. This can occur for a delete from restrictions on the updating of views.
a read-only view or for an update in which the cursor
SQLSTATE: 42829
was not defined with the FOR UPDATE clause.
This error code is also returned when the table exists at
a remote location and DB2 has employed block fetching
because you explicitly declared the cursor FOR FETCH
66 DB2 UDB for OS/390 and z/OS: Messages and Codes
-512 • -517
Programmer Response: For case (1), ensure that
-512 STATEMENT REFERENCE TO REMOTE
you prepare the statement that is named in the
OBJECT IS INVALID
DECLARE CURSOR statement for 'cursor-name' before
Explanation: One of the following conditions exists: you try to open the cursor. For case (2), do one of the
v The statement refers to multiple locations. following:
v A statement with a remote reference is being v Use the WITH HOLD option of DECLARE CURSOR.
EXPLAINED either by a dynamic EXPLAIN statement v Do not execute a commit or rollback operation until
or the EXPLAIN(YES) option. you are finished using the cursor.
v An alias is used incorrectly. v Prepare the statement again after the commit or
v A three-part name is implicitly or explicitly used in a rollback.
statement that is not supported by the DB2 private SQLSTATE: 26501
protocols.
v A three-part name is implicitly or explicitly used in a
-516 THE DESCRIBE FOR STATIC
triggered statement.
STATEMENT DOES NOT IDENTIFY A
v A PREPARE statement contains an ATTRIBUTES PREPARED STATEMENT
clause. This is not supported by the BD2 private
protocols. Explanation: An attempt was made to execute a
DESCRIBE FOR STATIC for a statement that had not
System Action: The statement cannot be executed. been successfully prepared beforehand. This error can
Programmer Response: If the object cannot be occur when the DESCRIBE originates on an application
meaningfully eliminated from the statement, see your requester that supports extended dynamic SQL.
Database Administrator for other ways to obtain the Because the target statement is static on the DB2 for
data required. Refer to Chapter 3 of DB2 SQL MVS/ESA subsystem, the DESCRIBE statement fails.
Reference for more information about using remote System Action: The statement cannot be executed.
objects.
Programmer Response: Correct the logic of the
If the remote object reference is in a triggered SQL application program to ensure that a statement is
statement, you can instead invoke a user-defined properly prepared before a DESCRIBE FOR STATIC of
function or a stored procedure from the trigger and the statement is attempted. If the DESCRIBE FOR
access the remote object from the function or stored STATIC is a distributed request that originated on a
procedure. system that supports extended dynamic SQL, contact
SQLSTATE: 56023 your system administrator about changing the DB2
subsystem parameter DESCSTAT to YES to tolerate
these DESCRIBE FOR STATIC requests against static
-513 THE ALIAS alias-name MUST NOT BE SQL.
DEFINED ON ANOTHER LOCAL OR
REMOTE ALIAS SQLSTATE: 26501
Explanation: The object indicated by 'alias-name' is a
local or remote alias. An alias is not allowed to be -517 CURSOR cursor-name CANNOT BE
defined on a local alias, and it should not be defined on USED BECAUSE ITS STATEMENT
a remote alias. NAME DOES NOT IDENTIFY A
PREPARED SELECT STATEMENT
System Action: The statement cannot be executed.
Explanation: The cursor 'cursor-name' could not be
Programmer Response: Modify the SQL statement to used as specified because the prepared statement
ensure that all object references are to base tables or named in the declaration for the cursor was not a
views. SELECT statement.
SQLSTATE: 42924 System Action: The statement cannot be executed.
Programmer Response: Verify that the
-514 THE CURSOR cursor-name IS NOT IN A statement-name is specified correctly in the PREPARE
PREPARED STATE statement and the DECLARE CURSOR statement for
Explanation: The application program has tried to use cursor 'cursor-name'. Alternatively, correct the
a cursor, 'cursor-name,' that is not in a prepared state. application program logic to ensure that only prepared
The cursor is associated with a statement that either SELECT statements are used in association with cursor
(1) has never been prepared, or (2) has been declarations.
invalidated by a commit or rollback operation. SQLSTATE: 07005
System Action: The statement cannot be executed.
Chapter 2. SQL Return Codes 67
-518 • -526
pkgname
-518 THE EXECUTE STATEMENT DOES NOT
locid.collid.pkgid
IDENTIFY A VALID PREPARED
STATEMENT contoken
Consistency token in hexadecimal
Explanation: One of the following conditions exists:
v The statement named in the EXECUTE statement System Action: The statement cannot be executed.
has not been prepared. Programmer Response: If the SQL statement is not
v The statement named in the EXECUTE statement supposed to execute at the indicated location, then
identifies a SELECT, VALUE INTO, or statement. correct the program so that the statement in error does
v The statement named in the EXECUTE IMMEDIATE not execute at that location. Precompile, compile, and
statement identifies a SELECT, VALUE INTO, or bind replace the package. If the SQL statement is
statement. supposed to execute at the indicated location, correct
the problem found when it was bound and bind the
System Action: The statement cannot be executed. package over using BIND with ACTION(REPLACE). If
Programmer Response: Ensure that you prepare the multiple versions of the package have been bound,
statement prior to EXECUTE. Also, ensure that the issue the following SELECT statement to determine
statement you prepare is not a SELECT or VALUES which version has the error: SELECT VERSION FROM
INTO statement. locid.SYSIBM.SYSPACKAGE WHERE LOCATION = ' '
AND COLLID = 'collid' AND NAME = 'pkgid' AND
SQLSTATE: 07003 HEX(CONTOKEN) = 'contoken'
Where:
-519 THE PREPARE STATEMENT
IDENTIFIES THE SELECT STATEMENT locid Location name
OF THE OPENED CURSOR cursor-name collid Collection id
Explanation: The application program has attempted pkgid Program name
to PREPARE (actually, re-PREPARE) the SELECT
statement for the specified cursor at a time when that SQLSTATE: 51015
cursor was already open.
System Action: The statement cannot be executed. -526 THE REQUESTED OPERATION OR
The cursor was not affected. USAGE DOES NOT APPLY TO table
type TEMPORARY TABLE table name
Programmer Response: Correct the logic of the
application program so that it does not attempt to Explanation: DB2 assumes that the SQL statement
re-PREPARE the SELECT statement for a cursor when being executed refers to a created or declared
that cursor is open. temporary table named table name, and the requested
operation or usage in the statement is not allowed on
SQLSTATE: 24506 the temporary table.
table type
-525 THE SQL STATEMENT CANNOT BE CREATED or DECLARED
EXECUTED BECAUSE IT WAS IN
ERROR AT BIND TIME FOR SECTION = CREATED is for a temporary table defined by
sectno PACKAGE = pkgname the CREATE GLOBAL TEMPORARY TABLE
CONSISTENCY TOKEN = X'contoken' statement.
Explanation: One of the following: DECLARED is for a temporary table defined by
the DECLARE GLOBAL TEMPORARY TABLE
v The statement was in error when the package was
statement.
bound, but the error was ignored then because the
option SQLERROR (CONTINUE) was used. Since table name
the statement contains an error, it cannot be Qualified name of the temporary table.
executed.
System Action: The statement cannot be processed.
v The statement might not be an executable statement
at this location, or might only be executable by a DB2 Programmer Response: Modify the SQL statement to
application requester (for example, DECLARE TABLE ensure that the object references are not to the
in an application running on OS/2 causes this indicated type of temporary table, or if table type is
message). DECLARED and you intended table name to refer to an
existing persistent base table, you must perform one of
The variables are: the following actions:
v Recreate the persistent base table table name with a
sectno Section number
different qualifier
68 DB2 UDB for OS/390 and z/OS: Messages and Codes
-530 • -534
v In the same application process, issue a DROP the parent keyshould be changed. If this does not
TABLE for table name followed by a COMMIT to drop expose the problem, examine the contents of the object
the declared temporary table and afterwards be able table and the dependent table to determine the cause of
to reference the persistent base table with the same the problem.
table name in the same application process
SQLSTATE: 23504
v Remove the DECLARE GLOBAL TEMPORARY
TABLE statement from the application process to use
the persistent base table with the same table name -532 THE RELATIONSHIP constraint-name
RESTRICTS THE DELETION OF ROW
SQLSTATE: 42995 WITH RID X'rid-number'
Explanation: A DELETE operation attempted to delete
-530 THE INSERT OR UPDATE VALUE OF a specified parent row in the object table and all related
FOREIGN KEY constraint-name IS descendent rows in the descendent tables. However, a
INVALID delete rule of RESTRICT or NO ACTION was specified
Explanation: An UPDATE or INSERT operation for one or more descendent tables.
attempted to place a value in a foreign key of the object A row of the table cannot be deleted because it has a
table; however, this value was not equal to some value dependent in a relationship with a delete rule of
of the parent key of the parent table. RESTRICT or NO ACTION or the deletion cascades to
When a row is inserted into a dependent table, the a row which is a dependent in a relationship with a
insert value of a foreign key must be equal to the value delete rule of RESTRICT or NO ACTION.
of the parent keyof some row of the parent table in the System Action: The DELETE statement cannot be
associated relationship. executed. The contents of the object table are
When the value of the foreign key is updated, the unchanged.
update value of a foreign key must be equal to the Programmer Response: Examine the delete rule for
value of the parent keyof some row of the parent table all descendent tables to determine the cause of the
of the associated relationship. problem. The specific tables involved can be determined
System Action: The UPDATE or INSERT statement from the relationship 'constraint-name'. The specific
cannot be executed. The object table is unchanged. descendent row is known by RID X'rid-number'.
Programmer Response: Examine the insert or update SQLSTATE: 23504
value of the foreign key first, and then compare it with
each of the parent keyvalues of the parent table to -533 INVALID MULTIPLE-ROW INSERT
determine the cause of the problem.
Explanation: An INSERT operation with a subselect
SQLSTATE: 23503 attempted to insert multiple rows into a self-referencing
table.
-531 PARENT KEY IN A PARENT ROW The subselect of the INSERT operation should return no
CANNOT BE UPDATED BECAUSE IT more than one row of data.
HAS ONE OR MORE DEPENDENT
ROWS IN RELATIONSHIP System Action: The INSERT statement cannot be
constraint-name executed. The contents of the object table are
unchanged.
Explanation: For plans and packages bound
beginning with Version 5 or dynamic SQL, a multi-row Programmer Response: Examine the search
update of a parent key attempted to remove a parent condition of the subselect to make sure that no more
key value on which a foreign key was dependent. than one row of data is selected.
For plans and packages bound prior to Version 5 an SQLSTATE: 21501
UPDATE operation attempted to update a primary key
in the specified row of the object table; however, the -534 THE PRIMARY KEY CANNOT BE
primary key in the specified row had dependent rows UPDATED BECAUSE OF
associated with it. The value of a primary key in a MULTIPLE-ROW UPDATE
parent row cannot be updated if the parent row has any
dependent rows. Explanation: An UPDATE operation attempted to
update a primary key on multiple rows of the object
System Action: The UPDATE statement cannot be table.
executed. The object table is unchanged.
An UPDATE statement updating the primary key cannot
Programmer Response: Examine the parent key of be used to update more than one row of the object
the object table and the foreign key of the dependent table.
table to determine if the value of the specified row of
Chapter 2. SQL Return Codes 69
-536 • -540
Note: This SQLCODE will only be issued for plans and the indicated table due to one of the following reasons:
packages bound prior to Version 5. SQLCODE v The referenced parent kkey has not been defined as
-534 will not be issued for dynamic SQL or plans a primary key or a unique key.
and packages bound with Version 5 or later
v The keys do not have the same number of columns.
releases.
v The decription of the keys are not identical. The
System Action: The UPDATE statement cannot be requirement for identical descriptions includes data
executed. The contents of the object table are type, length attribute, and field procedure.
unchanged.
name is the constraint-name specified in the foreign key
Programmer Response: Examine the search clause or, if a constraint-name was not specified, the
condition of the UPDATE statement to make sure that first column-name specified in the clause.
no more than one row of the object table is selected to
be updated. System Action: The statement cannot be processed.
SQLSTATE: 21502 Programmer Response: Correct the statement so
that the description of the foreign key references a
primary key or unique key, or so that the description of
-536 THE DELETE STATEMENT IS INVALID the foreign key conforms to that of a parent key of the
BECAUSE TABLE table-name CAN BE indicated table.
AFFECTED BY THE OPERATION
SQLSTATE: 42830
Explanation: A DELETE operation with the indicated
table referenced in a subquery was attempted.
-539 TABLE table-name DOES NOT HAVE A
If 'T' is the object table of the DELETE, the indicated PRIMARY KEY
table is one of the following:
Explanation: DB2 cannot perform the CREATE or
v A dependent of 'T' in a relationship with a delete rule
ALTER TABLE statement because the indicated table
of CASCADE or SET NULL
does not have a primary key. Thus, the primary key
v A dependent of another table in a relationship with a cannot be dropped, or the table cannot be defined as a
delete rule of CASCADE or SET NULL in which parent in a referential constraint.
deletions from 'T' can cascade to that table.
System Action: The statement cannot be processed.
System Action: The DELETE statement cannot be
processed. The contents of the object table are | Programmer Response: Correct the statement to
unchanged. | reference a table with a primary key, or define a primary
| key with ALTER TABLE ADD PRIMARY KEY before
Programmer Response: Do not attempt to reference | referencing the table in a FOREIGN KEY clause.
a table in a subquery of a DELETE statement when the
table can be affected by the DELETE statement. SQLSTATE: 42888
SQLSTATE: 42914
-540 THE DEFINITION OF TABLE table-name
IS INCOMPLETE BECAUSE IT LACKS
-537 THE PRIMARY KEY CLAUSE, A A PRIMARY INDEX OR A REQUIRED
FOREIGN KEY CLAUSE, OR A UNIQUE UNIQUE INDEX
CLAUSE IDENTIFIES COLUMN
column-name MORE THAN ONCE Explanation: The table named was defined with a
PRIMARY KEY clause, a UNIQUE clause, or with a
Explanation: PRIMARY KEY, FOREIGN KEY, or ROWID column with the GENERATED BY DEFAULT
UNIQUE can each be followed by a list of column attribute. Its definition is incomplete, and it cannot be
names. The statement violates the rule that no column used until a unique index is defined for
name can appear more than once in any such list.
v the primary key (the primary index)
System Action: The statement cannot be executed. v a ROWID column
Programmer Response: Correct the statement to v for each set of columns in any UNIQUE clause (the
specify unique names for each column. required unique indexes).
SQLSTATE: 42709 An attempt was made to use the table in a FOREIGN
KEY clause or in an SQL manipulative statement.
-538 FOREIGN KEY name DOES NOT System Action: The statement cannot be executed.
CONFORM TO THE DESCRIPTION OF
Programmer Response: Define a primary index or a
A PARENT KEY OF TABLE table-name
required unique index on the table before referencing it.
Explanation: The definition of the indicated foreign
SQLSTATE: 57001
key does not conform to the description of parent key of
70 DB2 UDB for OS/390 and z/OS: Messages and Codes
-542 • -546
constraint by using the SELECT statement, negating the
-542 column-name CANNOT BE A COLUMN
check constraint in the WHERE clause. For example:
| OF A PRIMARY KEY, A UNIQUE
| CONSTRAINT, OR A PARENT KEY SELECT * FROM table WHERE (NOT (check-condition));
BECAUSE IT CAN CONTAIN NULL SQLSTATE: 23512
VALUES
| Explanation: The code is used to report that a column -545 THE REQUESTED OPERATION IS NOT
| identified in a PRIMARY KEY, a UNIQUE constraint ALLOWED BECAUSE A ROW DOES
| clause, or a parent key (via a REFERENCES clause) is NOT SATISFY THE CHECK
| defined to allow null values. CONSTRAINT check-constraint
System Action: The statement cannot be executed. Explanation: Table check constraint violations
| Programmer Response: In the case of a column occurred on an INSERT or UPDATE statement. The
| identified in a PRIMARY KEY or a UNIQUE constraint resulting row violated the check constraint definition on
| clause, correct the statement and rerun it. the table.
| In the case of a column identified in a REFERENCES System Action: The INSERT or UPDATE statement
| clause, drop the parent table then recreate it with cannot be executed. The contents of the table are
| referenced columns defined as NOT NULL. Afterwards, unchanged.
| rerun the statement. Programmer Response: Examine the data and the
SQLSTATE: 42831 check constraint definition in the SYSIBM.SYSCHECKS
catalog table to determine why the INSERT or UPDATE
statement was rejected. The data must be changed to
-543 A ROW IN A PARENT TABLE CANNOT satisfy the check constraint.
BE DELETED BECAUSE THE CHECK
CONSTRAINT check-constraint SQLSTATE: 23513
RESTRICTS THE DELETION
Explanation: The delete operation cannot be -546 THE CHECK CONSTRAINT
executed because the target table is a parent table and constraint-name IS INVALID
is connected with a referential constraint to a dependent Explanation: A check constraint in the CREATE
table with a delete rule of SET NULL. However, a check TABLE or ALTER TABLE statement is invalid for one or
constraint defined on the dependent table restricts the more of the following reasons:
column from containing a null value.
v The constraint definition refers to a column that has a
System Action: The DELETE statement was not field procedure.
executed. The contents of the tables are unchanged. v The constraint definition refers to a column with a
Programmer Response: Examine the foreign key and data type that is lower in the hierarchy of numeric
its delete rule in the dependent table and the conflicting data types than the data type of any other operand.
check constraint. Change either the delete rule or the The hierarchy is as follows:
check constraint so that they do not conflict. small integer < large integer < decimal
< single precision float < double precision float
SQLSTATE: 23511
v The constraint definition refers to a column with a
numeric data type that is not the same numeric data
-544 THE CHECK CONSTRAINT SPECIFIED type as that of the other column operands.
IN THE ALTER TABLE STATEMENT
v The constraint definition refers to a column with a
CANNOT BE ADDED BECAUSE AN
length that is shorter than the other operands when
EXISTING ROW VIOLATES THE CHECK
the column and other operands are not character
CONSTRAINT
string data types.
Explanation: An existing row violates the check v The constraint definition refers to a built-in or
constraint specified in the ALTER TABLE statement. user-defined function.
System Action: The statement cannot be executed. v The constraint definition uses a cast function that
The check constraint definition is not added to the table. requires conversion of the data. The only functions
The table definition is unchanged. that are allowed in a check constraint are cast
functions that do not require conversion of the data.
Programmer Response: Examine the check
constraint definition that was specified in the ALTER System Action: The statement is not executed.
TABLE statement and the data in the table to determine
For ALTER TABLE, the check constraint is not added to
why the ALTER TABLE statement was rejected.
the object table. The definition of the table is
You can determine which rows violated the check unchanged.
Chapter 2. SQL Return Codes 71
-548 • -549
For CREATE TABLE, the table is not created. The indicated SQL statement is bound to one of the
following:
Programmer Response: Correct the check constraint
definition and execute the statement again. v The named plan or package that was not bound with
the option DYNAMICRULES(RUN)
SQLSTATE: 42621
v The named package that was not bound with the
DYNAMICRULES option, but is appended to a plan
-548 A CHECK CONSTRAINT THAT IS that was not bound with DYNAMICRULES(RUN)
DEFINED WITH column-name IS
statement
INVALID
The SQL statement in error
Explanation: A check constraint in the CREATE
object_type1
TABLE or ALTER TABLE statement is invalid for one or
PACKAGE or DBRM
more of the following reasons:
v The constraint definition refers to a column that has a object_name
field procedure. If object_type1 is PACKAGE, object_name is
the name of the package in the format
v The constraint definition refers to a column with a
’location-id.collection-id.package-id’.
data type that is lower in the hierarchy of numeric
data types than the data type of any other operand. If object_type1 is DBRM, object_name is the
The hierarchy is as follows: name of the DBRM in the format ’plan-name
small integer < large integer < decimal DBRM-name’.
< single precision float < double precision float object_type2
v The constraint definition refers to a column with a PLAN or PACKAGE
numeric data type that is not the same numeric data
type as that of the other column operands. If object_type1 is PACKAGE, object_type2 can
be either PACKAGE or PLAN (whichever is
v The constraint definition refers to a column with a bound with a DYNAMICRULES value other
length that is shorter than the other operands when than RUN).
the column and other operands are not character
string data types. If object_type1 is DBRM, object_type2 is
v The constraint definition refers to a ROWID column. PLAN.
v The constraint definition refers to a LOB column. System Action: The SQL statement cannot be
executed.
System Action: The statement is not executed.
Programmer Response: Do one of the following to
For ALTER TABLE, the check constraint is not added to correct the error:
the object table. The definition of the table is
unchanged. v If the SQL statement is embedded, remove it,
precompile and compile the application program
For CREATE TABLE, the table is not created. again, and reissue the BIND command with the
desired DYNAMICRULES option.
Programmer Response: Correct the check constraint
definition and execute the statement again. v If appropriate, use the SQL statement with a package
or plan that is bound with DYNAMICRULES(RUN).
SQLSTATE: 42621
v Issue the REBIND command with the
DYNAMICRULES(RUN) option for the plan or
-549 THE statement STATEMENT IS NOT package to which the SQL statement is bound
ALLOWED FOR object_type1
object_name BECAUSE THE BIND Refer to the BIND PACKAGE(DSN), BIND PLAN(DSN),
OPTION DYNAMICRULES(RUN) IS NOT REBIND PACKAGE(DSN), or REBIND PLAN(DSN)
IN EFFECT FOR object_type2 statement in DB2 Command Reference for the
description of the DYNAMICRULES option and the
Explanation: A program attempted to issue the
expected results. Determine if either the SQL statement
indicated SQL statement that is one of several SQL
should be removed from the program or the plan or
statements that cannot be issued from a plan or
package should be rebound with the
package for which the option DYNAMICRULES(RUN) is
DYNAMICRULES(RUN) option.
not in effect. Those SQL statements are:
v Dynamic GRANT statement SQLSTATE: 42509
v Dynamic REVOKE statement
v Dynamic ALTER statement
v Dynamic CREATE statement
v Dynamic DROP statement
72 DB2 UDB for OS/390 and z/OS: Messages and Codes
-551 • -555
-551 auth-id DOES NOT HAVE THE -552 auth-id DOES NOT HAVE THE
PRIVILEGE TO PERFORM OPERATION PRIVILEGE TO PERFORM OPERATION
operation ON OBJECT object-name operation
Explanation: Authorization ID auth-id attempted to Explanation: Authorization ID 'auth-id' has attempted
perform operation on object object-name without having to perform the specified 'operation' without having been
been granted the proper authority to do so. This error granted the authority to do so.
might also occur if the object is a read-only view (for
System Action: The statement cannot be executed.
INSERT, DELETE, or UPDATE), or if auth-id is trying to
create a table or view with an authorization ID other Installation Action: Check for an attempted
than its own. authorization violation.
You can create a table from an auth-id other than your Programmer Response: Ensure that the authorization
own only if your authorization ID is SYSADM, DBADM, ID has been granted the authority necessary to perform
or DBCTRL. You can create a view from an auth-id the desired operation.
other than your own only if your authorization ID is
SYSADM. SQLSTATE: 42502
When operation is ’GRANT ***’, the keyword ALL was
used in the GRANT statement, but the grantor auth-id -553 auth-id SPECIFIED IS NOT ONE OF THE
did not possess any privilege to grant. VALID AUTHORIZATION IDS
If this error occurs while DB2 is creating or altering a Explanation: The authorization ID specified as the
table involving referential constraints, this code reports value of the 'authorization-id' or host variable in the SQL
that the user does not have the necessary ALTER SET CURRENT SQLID statement is neither the user’s
privilege to perform a FOREIGN KEY, DROP FOREIGN primary authorization ID nor one of the associated
| KEY, DROP PRIMARY KEY, or DROP UNIQUE secondary authorization IDs.
| operation. The object-name identifies the object table of System Action: The SET CURRENT SQLID
the CREATE or ALTER TABLE statement, not the table statement cannot be executed. The current SQL ID is
for which the user lacks the ALTER privilege. not changed.
If this error occurs for a distributed SQL request, then: Programmer Response: Correct the error in the
1. If authorization ID translation is in effect for either statement or contact the security administrator to have
the requesting DB2 site or the serving (responding) the authorization ID defined for your use.
DB2 site, then auth-id is the translated authorization
ID. Refer to Part 3 (Volume 1) of DB2 Administration SQLSTATE: 42503
Guide for information on authorization ID translation.
2. If an alias name was used in the SQL statement, -554 AN AUTHORIZATION ID CANNOT
then object-name is the resolved remote table or GRANT A PRIVILEGE TO ITSELF
view name.
Explanation: An authorization ID attempted to execute
If the operation is a DROP PACKAGE, the object name a GRANT statement in which that ID itself appears as
consists of the collection ID, the package name and the one of the entries in the list of 'grantee' authorization
consistency token. The consistency token uniquely IDs.
identifies which version of the package the user does An authorization ID cannot GRANT a privilege to itself.
not have authorization to drop. However, if SQLRULES(STD) is in effect or CURRENT
RULES contains STD, GRANT to self is allowed.
Note: Beginning with Version 5, SQLCODE -551 will be
returned instead of SQLCODE -204 for the System Action: The statement cannot be executed.
runtime error where an object does not exist and No privileges were granted.
the CURRENT RULES special register is set to Programmer Response: Refer to Chapter 4 of DB2
’STD’. SQL Reference for information about restrictions on the
System Action: The statement cannot be executed. use of the GRANT statement.
Installation Action: Check for an attempted SQLSTATE: 42502
authorization violation.
Programmer Response: Ensure that auth-id was -555 AN AUTHORIZATION ID CANNOT
granted the authority to perform the desired operation, REVOKE A PRIVILEGE FROM ITSELF
the object-name exists, and auth-id is not trying to Explanation: An authorization ID attempted to execute
create a table with a different authorization ID. a REVOKE statement in which that ID itself appears as
SQLSTATE: 42501 one of the entries in the list of authorization IDs to be
revoked.
Chapter 2. SQL Return Codes 73
-556 • -567
An authorization ID cannot REVOKE its own privilege. ’keyword-list’ provides a list of the keywords that would
However, if SQLRULES(STD) is in effect or CURRENT be permitted in this context.
RULES contains STD, REVOKE to self is allowed.
Alternatively:
System Action: The statement cannot be executed. v The mixture of privileges specified on the GRANT or
No privileges were revoked. REVOKE statement is not permitted. The privileges
Programmer Response: Refer to Chapter 5 of DB2 must all be of one type, and consistent with the form
SQL Reference for information about restrictions on the of the GRANT or REVOKE statement.
use of the REVOKE statement. v REVOKE UPDATE (column-list) is not permitted; only
REVOKE UPDATE is valid.
SQLSTATE: 42502
v The keywords DELETE, INSERT, SELECT,
TRIGGER, UPDATE, REFERENCES and ALTER
-556 authid2 CANNOT HAVE THE privilege cannot be specified for an auxiliary table.
PRIVILEGE on_object REVOKED BY
authid1 BECAUSE THE REVOKEE System Action: The statement cannot be executed.
DOES NOT POSSESS THE PRIVILEGE Programmer Response: Correct the syntax of the
OR THE REVOKER DID NOT MAKE GRANT or REVOKE statement.
THE GRANT
SQLSTATE: 42852
Explanation: The REVOKE statement was not
successful for one of the following reasons:
-558 INVALID CLAUSE OR COMBINATION
v Authid2 does not possess the privilege.
OF CLAUSES ON A GRANT OR
v The revoker, authid1, did not explicitly grant the REVOKE
privilege to authid2.
Explanation: The location qualifier specified for a
v Authid2 is the owner of the specified object.
GRANT or REVOKE statement is invalid.
v When privilege is '***' the keyword ALL was used in
the REVOKE statement, but authid2 did not possess System Action: The statement cannot be executed.
any privilege to revoke. Programmer Response: Refer to Chapter 5 of DB2
v When authid1 is ALL, the BY ALL clause was used in SQL Reference for valid keywords for the GRANT
the REVOKE statement, but authid2 did not possess statement.
any privilege to revoke.
SQLSTATE: 56025
An authorization ID can revoke only the privileges that it
has explicitly granted to other authorization IDs, unless -559 ALL AUTHORIZATION FUNCTIONS
the authorization ID has SYSADM or SYSCTRL HAVE BEEN DISABLED
authority and specifies the BY clause. No authorization
ID, not even SYSADM, can revoke 'privileges' on an Explanation: The authorization mechanism has been
object from the object owner. disabled in the DB2 subsystem. Consequently, GRANT
and REVOKE statements are ignored.
System Action: The statement cannot be executed.
No privileges were revoked from any authorization ID. System Action: The statement cannot be executed.
No privileges were granted or revoked.
Programmer Response: Check the appropriate
authorization catalog tables to verify that authid2 Programmer Response: Do not attempt to execute
possesses the privilege to be revoked. Queries can be GRANT or REVOKE statements unless and until the
made with GRANTEE = authid2 and the privilege authorization mechanism is enabled in the DB2
column not = blanks. Correct and reissue the REVOKE subsystem.
statement. SQLSTATE: 57002
If a user holding SYSADM or SYSCTRL authority
receives this SQLCODE, the BY clause might have -567 bind-type AUTHORIZATION ERROR
been omitted from the REVOKE statement. USING auth-id AUTHORITY PACKAGE =
SQLSTATE: 42504 package-name PRIVILEGE = privilege
Explanation: The authorization ID given does not
-557 INCONSISTENT GRANT/REVOKE have the privilege indicated, and cannot invoke the
KEYWORD keyword. PERMITTED indicated subcommand against the indicated package.
KEYWORDS ARE keyword-list bind-type
Explanation: The GRANT or REVOKE statement Type of bind subcommand (BIND | REBIND |
contains a syntax or spelling error at or before the FREE).
specified ’keyword’. As an aid to the programmer,
74 DB2 UDB for OS/390 and z/OS: Messages and Codes
-571 • -574
auth-id Authorization ID of the package owner. v At the time of the autobind, locks are being held to
process an SQL statement within the application
package-name
program.
Name of the package
(location.collection.package.version) System Action: The statement cannot be executed.
privilege Programmer Response:
Name of the privilege not held: v Ensure that all requests for modifications to the data
v BINDADD—The authority to create a new are confined to a single location within any given
package using BIND with the ADD option. commit scope for any application that references a
v BIND—The authority to BIND (REPLACE) or location that does not support multi-site update.
REBIND a package. v For programs operating in an IMS or CICS
v COPY—The authority to COPY from the environment where the remote database systems do
indicated package not support multi-site update, all SQL statements
must be read-only access.
v CREATE IN—The authority to create a
package in the indicated collection. v If an autobind is causing this SQLCODE to be
issued, REBIND the plan or package.
System Action: The indicated package is not bound,
rebound, or freed. SQLSTATE: 25000
System Programmer Response: The indicated
privilege must be granted to the authorization ID that -573 TABLE table-name DOES NOT HAVE A
will become the package owner. UNIQUE KEY WITH THE SPECIFIED
COLUMN NAMES
SQLSTATE: 42501
Explanation: A referential constraint cannot be defined
with the specified table as the parent because a unique
-571 THE STATEMENT WOULD RESULT IN index with the specified column names does not exist
A MULTIPLE SITE UPDATE for the identified parent table.
Explanation: System Action: The statement cannot be processed.
This SQLCODE is issued in the following situations: Programmer Response: Create a unique index with
v When an application program operating in an IMS or the specified columns for the parent table.
CICS environment attempts to modify data at a
SQLSTATE: 42890
remote location where multi-site update capabilities
are not supported.
v When an application program has explicit SQL | -574 THE SPECIFIED DEFAULT VALUE OR
statements within a commit scope that would result in | IDENTITY ATTRIBUTE VALUE
updates at multiple sites where one of the sites at | CONFLICTS WITH THE DEFINITION OF
which data is being updated does not support | COLUMN column-name
multi-site update. | Explanation: The DEFAULT value specified for
| column-name is not valid for one of the following
This SQLCODE can be issued when an application | reasons:
program explicitly modifies data at a single location
| v The value is not assignable to the column because
within a commit scope. This can occur in the following
| the constant does not conform to the format for a
situations:
| constant of that data type, or the value has the
v A package or plan associated with the application | incorrect length or precision.
program was invalidated.
| v A floating-point constant is specified and the column
v A package or plan was bound at one release of DB2 | is not a floating point data type
and fallback occurs to a prior release.
| v A decimal constant is specified and non-zero digits
| would be truncated when assigned to the column
In the situations described above, an implicit autobind is
done on behalf of the user. An autobind results in the | v The value is more than 255 bytes, including quotes
DB2 catalog being updated. The conditions that must | for strings, introducer characters such as the X for a
exist for this SQLCODE to be issued when an autobind | hex constant, fully qualified function names, and
occurs are: | parentheses.
v One site where data has been modified does not | v Either the USER or CURRENT SQLID special
support multi-site update. | register is specified and the length attribute of the
| character string data type is less than 8.
v The autobind occurs at a separate and distinct site
from where an application program explicitly modifies
data.
Chapter 2. SQL Return Codes 75
-577 • -581
| v A system-generated cast function was specified and
| -579 object-type object-name ATTEMPTED TO
| the column is not defined with a user-defined distinct
| READ DATA WHEN THE DEFINITION
| type
| OF THE FUNCTION OR PROCEDURE
| v A function was specified that is not supported. A | DID NOT SPECIFY THIS ACTION
| function may only be specified when the data type is
| a distinct type, and in this case the specified function | Explanation: The current environment does not allow
| must be one of the system-generated cast functions | SQL statements that read data. One of the following
| associated with this distinct type. | situations had occurred:
| v WITH DEFAULT is specified with a value other than | v A user-defined function or stored procedure
| NULL for a LOB column. | object-name was invoked and attempted to read
| data, but the function or procedure was defined
| v A value with non-zero scale was specified for the
| without the READS SQL DATA or MODIFIES SQL
| START WITH or INCREMENT BY option of an
| DATA option.
| identity column with the DECIMAL data type.
| v A function or procedure defined with CONTAINS SQL
| System Action: The SQL statement cannot be | or NO SQL has attempted to invoke another function
| executed. | or procedure defined with READS SQL DATA.
| Programmer Response: Specify a default value that
| is valid for the definition of the column. | In an environment of nested functions and procedures,
| the SQL option in effect is the most restrictive one that
SQLSTATE: 42894 | has been specified in the nested hierarchy of functions
| and procedures. The SQL data access option in effect
| -577 object-type object-name ATTEMPTED TO | does not allow for reading data.
| MODIFY DATA WHEN THE DEFINITION | System Action: The SQL statement failed.
| OF THE FUNCTION OR PROCEDURE
| DID NOT SPECIFY THIS ACTION | Programmer Response: Either use an ALTER
| statement to change the definition of the function or
| Explanation: The current environment does not allow | procedure to allow statements that read data, or remove
| SQL statements that modify data. One of the following | the failing SQL statement from the external function or
| situations has occurred: | procedure.
| v A user-defined function or stored procedure
| SQLSTATE: 38004
| object-name was invoked and attempted to modify
| data, but the function or procedure was defined
| without the MODIFIES SQL option. -580 THE RESULT-EXPRESSIONS OF A
| v A user-defined function or stored procedure CASE EXPRESSION CANNOT ALL BE
| object-name was invoked and attempted to execute a NULL
| data definition statement, but the function or Explanation: There is a CASE expression in the
| procedure was defined without the MODIFIES SQL statement that has all the result-expressions
| option. (expressions following the THEN and ELSE keywords)
| v A function or procedure defined with READS SQL coded with the keyword NULL.
| DATA, CONTAINS SQL, or NO SQL has attempted to
System Action: The statement cannot be processed.
| invoke another function or procedure defined with
| MODIFIES SQL DATA. Programmer Response: Change the CASE
expression to include at least one result-expression with
| In an environment of nested functions and procedures, a keyword other than NULL.
| the SQL option in effect is the most restrictive one that
SQLSTATE: 42625
| has been specified in the nested hierarchy of functions
| and procedures. The SQL data access option in effect
| does not allow for modifying the data. -581 THE DATA TYPES OF THE
RESULT-EXPRESSIONS OF A CASE
| System Action: The SQL statement failed.
EXPRESSION ARE NOT COMPATIBLE
| Programmer Response: Either use an ALTER
Explanation: There is a CASE expression in the
| statement to change the definition of the function or
statement that has result-expressions (expressions
| procedure to allow statements that modify data, or
following THEN and ELSE keywords) that are not
| remove the failing SQL statement from the external
compatible. The data type of the result-expressions
| function or procedure.
might be incompatible because the CASE condition
| SQLSTATE: 38002 result data types are not all:
v character
v graphic
v numeric
76 DB2 UDB for OS/390 and z/OS: Messages and Codes
-582 • -587
v date | v Remove the function from the ORDER BY clause. If
v time | the column is part of the result set of the query,
v timestamp | change the expression in the ORDER BY clause to
| the simple-integer or simple-column-name form of the
If encoded in Unicode, character and graphic data types | sort key. See the ORDER BY syntax diagram in the
are compatible, howver. Refer to DB2 SQL Reference | DB2 SQL Reference for more information.
for more information about Unicode.
SQLSTATE: 42845
System Action: The statement cannot be processed.
Programmer Response: Correct the -585 THE SCHEMA NAME schema-name
result-expressions so that they are compatible. CANNOT APPEAR MORE THAN ONCE
IN THE CURRENT PATH
SQLSTATE: 42804
Explanation: The current path includes schema-name
more than once. The current path can only include one
-582 THE SEARCH-CONDITION IN A occurrence of each schema name.
SEARCHED-WHEN-CLAUSE CANNOT
BE A QUANTIFIED PREDICATE, IN System Action: The statement cannot be executed.
PREDICATE, OR AN EXISTS
Programmer Response: Remove duplicate
PREDICATE.
occurrences of schema-name from the current path.
Explanation: The search-condition in a
SQLSTATE: 42732
searched-when-clause specifies a quantified predicate,
an IN predicate, or an EXISTS predicate, but is not
allowed. -586 THE TOTAL LENGTH OF THE
CURRENT PATH SPECIAL REGISTER
System Action: The statement cannot be processed.
CANNOT EXCEED 254 CHARACTERS
Programmer Response: Correct the search-condition.
Explanation: The CURRENT PATH special register is
SQLSTATE: 42625 defined as a VARCHAR(254). The content of the string
includes each schema name delimited with double
quotes and separated from the next schema name by a
-583 THE USE OF FUNCTION function-name comma. The total length of the string of all schema
IS INVALID BECAUSE IT IS NOT names in the CURRENT PATH cannot exceed 254
| DETERMINISTIC OR HAS AN characters. A SET CURRENT PATH statement causing
EXTERNAL ACTION this message would exceed this limit.
| Explanation: The function function-name is defined as System Action: The statement is not executed.
| a not deterministic function or a function with an
| external action. This type of function is not supported in Programmer Response: Remove schema names to
the context in which it is used. The contexts in which reduce the total length to fit the 254 character maximum
these are not valid are: length. If all the schema names are required, it may be
v in the expression prior to the first WHEN keyword in necessary to consolidate some user-defined functions
a simple-case-expression. so that fewer schema names are required for the
CURRENT PATH.
v in the WHERE clause of the subselect in a CREATE
VIEW statement if the WITH CHECK OPTION is SQLSTATE: 42907
specified.
| v in an expression of an ORDER BY clause -587 A LIST OF item-references ARE NOT IN
System Action: The statement cannot be executed. THE SAME FAMILY
Programmer Response: If the use of a not Explanation: Each item-reference in the SET
deterministic or external action function was not statement is either a host-variable or a
intended, substitute a function without these transition-variable. The list of item-references must be of
characteristics. If the behavior associated with the not the same family, meaning if one of the item-references
deterministic or external action function is intentional, is a transition-variable, then all of the item-references in
use the alternate form of the statements that make that the list must be a transition-variable. If the statement is
intent explicit. used in the triggered action of a CREATE TRIGGER
statement, each item-reference must identify a
v Instead of a simple-when-clause, use the transition-variable. If the statement is used in any other
corresponding searched-when-clause where the context, each item-reference must identify a
function would get specified in each search-condition. host-variable.
v Remove the WITH CHECK OPTION from the
CREATE VIEW statement. System Action: The statement can not be processed.
Chapter 2. SQL Return Codes 77
-590 • -601
Programmer Response: Correct the statement and TABLE statement, the NOT NULL clause must be
execute it again. specified for the column.
SQLSTATE: 428C6 System Action: The statement cannot be executed.
Programmer Response: Change the statement to
-590 PARAMETER NAME parameter-name IS specify NOT NULL for ROWID column column-name.
NOT UNIQUE IN THE CREATE FOR
SQLSTATE: 42831
ROUTINE routine-name
Explanation: The parameter name parameter-name
-601 THE NAME OF THE OBJECT TO BE
specified on a CREATE FUNCTION or CREATE
CREATED OR THE TARGET OF A
| PROCEDURE statement for routine-name is not unique.
RENAME STATEMENT IS IDENTICAL
System Action: The statement cannot be executed. TO THE EXISTING NAME name OF THE
OBJECT TYPE obj-type
Programmer Response: Change the name of the
parameter to make all of the parameter names unique Explanation: One of the following situations has been
within the CREATE statement. detected:
SQLSTATE: 42734 v A CREATE statement tried to create an object name
of type obj-type, but an object of that type with the
same name is already defined in the DB2 subsystem.
-592 NOT AUTHORIZED TO CREATE
– If obj-type is CONSTRAINT, the name was
FUNCTIONS OR PROCEDURES IN
specified in the FOREIGN KEY clause, CHECK
WLM ENVIRONMENT env-name
| clause, PRIMARY KEY clause, or UNIQUE clause
| Explanation: This mesage is issued when: of either a CREATE or ALTER TABLE statement.
| v The value of the env-name token is 'NO WLM All referential integrity, check constraint, primary
| ENVIRONMENT' and the check for authorization to key, and unique key constraint names defined on
| the DB2-managed stored procedures address space a table must be unique.
| failed because the NO WLM ENVIRONMENT clause – If obj-type is TABLE or VIEW, and a CREATE
| was specified on the CREATE PROCEDURE or ALIAS statement failed, then the alias-name
| ALTER PROCEDURE statement. specified in the CREATE ALIAS statement is
| v There is no DB2-managed stored procedures identical to the table name or view name
| address space. specified. The TABLE or VIEW might not exist in
the DB2 subsystem.
System Action: The statement cannot be executed. – If obj-type is DISTINCT TYPE, and a CREATE
| Programmer Response: To correct the error, perform DISTINCT TYPE statement failed, then there is
| one of the following actions: already a user-defined type existing with the same
name as the distinct type name specified in the
| v If the value of the env-name token is 'NO WLM
CREATE DISTINCT TYPE statement.
| ENVIRONMENT', choose a different value for the
| WLM ENVIRONMENT keyword or request – If obj-type is FUNCTION or PROCEDURE, and a
| authorization to create objects in the specified WLM CREATE FUNCTION or CREATE PROCEDURE
| ENVIRONMENT from the system administrator. statement failed, then there is already a routine
existing with the same name as the name
| v If there is no DB2-managed stored procedures
specified in the CREATE FUNCTION or CREATE
| address space, request that one be created. Also
PROCEDURE statement.
| request that a RACF PERMIT be completed to allow
| access to this resource. – If obj-type is FUNCTION, and a CREATE
DISTINCT TYPE statement failed, then there is
| After doing one of the above, reissue the SQL already a cast function existing with the same
| statement. name as the distinct type and an input parameter
of the source type or there is already a cast
SQLSTATE: 42510 function existing with the same name as the
source type and an input parameter of the distinct
-593 NOT NULL MUST BE SPECIFIED FOR type name.
ROWID OR DISTINCT TYPE COLUMN v A RENAME statement specified a target name name,
column-name but an object with the same name is already defined
in the DB2 subsystem.
Explanation: ROWID columns and distinct type
columns for which the source type is a ROWID do not System Action: The CREATE, ALTER or RENAME
support null values. When a ROWID column (or distinct statement cannot be executed. No new object was
type for which the source type is a ROWID) is defined created, no existing object was altered, and no existing
on a CREATE TABLE, ALTER TABLE, or DECLARE object was renamed.
78 DB2 UDB for OS/390 and z/OS: Messages and Codes
-602 • -612
Programmer Response: Either drop the existing SQLSTATE: 42611
object or choose another name. If obj-type is data set,
do an IDCAMS DELETE of the data set before retrying
-607 OPERATION OR OPTION operation IS
the CREATE. Refer to Chapter 2 of DB2 SQL
NOT DEFINED FOR THIS OBJECT
Reference for information about the scope of object
names in DB2. Explanation: The operation or option cannot be
performed on the object specified in the SQL statement.
SQLSTATE: 42710
System Action: The statement cannot be executed.
-602 TOO MANY COLUMNS SPECIFIED IN A Programmer Response: If an option of the SQL
CREATE INDEX statement is not allowed for this object, modify the SQL
statement and resubmit the statement. If an operation is
Explanation: The number of columns specified in the
not defined for the object, the statement cannot be
CREATE INDEX statement exceeds 64, the maximum
executed.
permitted by DB2.
SQLSTATE: 42832
System Action: The statement cannot be executed.
The specified index was not created.
-611 ONLY LOCKMAX 0 CAN BE SPECIFIED
Programmer Response: The index definition must be
WHEN THE LOCK SIZE OF THE
modified to conform to the system-imposed column limit
TABLESPACE IS TABLESPACE OR
of 64.
TABLE
SQLSTATE: 54008
Explanation: This message is issued when:
v The LOCKSIZE of the table space is TABLESPACE
-603 A UNIQUE INDEX CANNOT BE or TABLE, and LOCKMAX is being altered to or
CREATED BECAUSE THE TABLE created as a nonzero value.
CONTAINS ROWS WHICH ARE
v The LOCKSIZE of the table space is being altered to
DUPLICATES WITH RESPECT TO THE
TABLESPACE or TABLE, and LOCKMAX is being
VALUES OF THE IDENTIFIED
altered to or created as a nonzero value.
COLUMNS
Explanation: The index defined in the CREATE If LOCKSIZE is TABLESPACE or TABLE, LOCKMAX
INDEX statement could not be created as unique must be 0 because lock escalation is not supported
because the specified table already contains rows that from these levels.
are duplicates with respect to the values of the identified
columns. System Action: The statement cannot be executed.
System Action: The statement cannot be executed. Programmer Response: Do one of the following:
v Reissue the statement with LOCKMAX 0.
Programmer Response: Examine the data to
ascertain whether or not the duplicate data is valid. v Alter the LOCKSIZE of the table space to a value
Alternatively, consider creating a nonunique index. other than TABLESPACE or TABLE.
SQLSTATE: 23515 SQLSTATE: 53088
-604 A DATA TYPE DEFINITION SPECIFIES -612 column-name IS A DUPLICATE
AN INVALID LENGTH, PRECISION, OR COLUMN NAME
SCALE ATTRIBUTE Explanation: The CREATE INDEX, CREATE TABLE,
Explanation: A data type definition in a CREATE or CREATE VIEW or ALTER TABLE statement specifies
ALTER statement contains an invalid length, precision, the same column-name for two (or more) columns of
or scale attribute specification. In addition, the the index, table, view, or the UPDATE OF clause of a
specification of data type might be incorrect or invalid. trigger definition specifies the same column name more
Or, the column definition in a view referenced in a than once. Column names must be unique within an
CREATE TABLE LIKE view has an invalid length. index, a table, a view, or in the UPDATE OF clause of a
trigger definition. A column cannot be specified in more
System Action: The statement cannot be executed. than one ALTER TABLE clause except if it is specified
The specified object was not created or altered. in an ALTER COLUMN clause and ADD CHECK
CONSTRAINT clause.
Programmer Response: Correct the syntax, and
resubmit the statement. Refer to Chapter 2 of DB2 SQL System Action: The statement cannot be executed.
Reference for information about valid length, precision, The specified index, table, view, or trigger was not
and scale attributes for the data type of an object. created.
Chapter 2. SQL Return Codes 79
-613 • -617
Programmer Response: Correct the CREATE
-615 operation-type IS NOT ALLOWED ON A
statement to specify unique names for each of the
PACKAGE IN USE
columns of the index, table, view, or the columns in the
UPDATE OF clause of a trigger definition. Correct the Explanation: The operation 'operation-type' cannot be
ALTER statement to specify unique names for each of performed because the package is in use by the same
the ALTER COLUMN clauses. application process.
This error can also occur on CREATE TABLE when a operation-type
column list of a PRIMARY KEY, FOREIGN KEY, or Type of bind operation (BIND, REBIND or
UNIQUE clause contains two or more occurrences of DROP).
the same column name.
System Action: The BIND, REBIND, or DROP
SQLSTATE: 42711 operation on the package is not performed.
Programmer Response: Change the application to
-613 THE PRIMARY KEY OR A UNIQUE invoke the BIND, REBIND or DROP operation when the
CONSTRAINT IS TOO LONG OR HAS package is not use by the same application process.
TOO MANY COLUMNS
SQLSTATE: 55006
Explanation: In a list of columns following either
PRIMARY KEY or UNIQUE, the number of columns is
-616 obj-type1 obj-name1 CANNOT BE
greater than 64 or the sum of the column length
DROPPED BECAUSE IT IS
attributes is greater than the number allowed for the
REFERENCED BY obj-type2 obj-name2
type of index.
Explanation: Some types of objects cannot be
System Action: The CREATE or ALTER statement
dropped if there are other objects which are dependent
cannot be executed. The specified table cannot be
upon them. For example, a storage group cannot be
created or altered.
dropped if there are one or more existing table spaces
Programmer Response: Change the table definition that use that storage group.
to keep within the prescribed limits.
Execution of the specified DROP statement would drop
SQLSTATE: 54008 object obj-name1 of type obj-type1 on which object
obj-name2 of type obj-type2 is dependent.
-614 THE INDEX CANNOT BE CREATED OR System Action: The statement cannot be processed.
THE LENGTH OF A COLUMN CANNOT The specified object was not dropped.
BE CHANGED BECAUSE THE SUM OF
Programmer Response: Verify that the object
THE INTERNAL LENGTHS OF THE
specified in the DROP statement was, indeed, the
IDENTIFIED COLUMNS IS GREATER
object to be dropped. If so, all the existing objects that
THAN THE ALLOWABLE MAXIMUM
have a dependency on that object must first be
Explanation: The index could not be created or the dropped.
length of a column cannot be changed because the
A LOB table space cannot be dropped when an
sum of the internal lengths of the key columns would
association exists between it and another table space.
exceed the allowable maximum. The maximum
The associated base table must be dropped first.
permitted key length is 255.
A populated auxiliary table and its index can only be
System Action: The statement cannot be executed.
dropped by dropping the associated base table.
The specified index was not created or the length of the
column was not changed. A trigger package cannot be explicitly dropped. It can
only be dropped by dropping the associated trigger with
Programmer Response: The definition for the index
a DROP TRIGGER statement or by dropping the
must be modified (possibly by eliminating one or more
triggering table.
key columns) to reduce the length of the key to the
permitted maximum. Refer to Chapter 5 of DB2 SQL SQLSTATE: 42893
Reference if you require a complete explanation of other
possible maximum key lengths and how they are
computed. -617 A TYPE 1 INDEX IS NOT VALID FOR
TABLE table-name
SQLSTATE: 54008
Explanation: A TYPE 1 index cannot be created on
the following tables:
v A table within a large table space
v A table within a table space with LOCKSIZE ROW
v An auxiliary table
80 DB2 UDB for OS/390 and z/OS: Messages and Codes
-618 • -622
In addition, a type 1 index cannot be created on a ALTER is for ALTER TABLESPACE or ALTER
ROWID column of a table. INDEX.
System Action: The statement cannot be executed. space type
The index was not created TABLE or INDEX
Programmer Response: Either create the index as TABLE is for table space, and INDEX is for
TYPE 2 or, if LOCKSIZE ROW was used,alter the index space.
LOCKSIZE of the table space containing the table to a
database type
value other than LOCKSIZE ROW.
WORK FILE or TEMP
SQLSTATE: 56089
System Action: The statement cannot be executed.
Programmer Response: Refer to DB2 SQL
-618 OPERATION operation IS NOT
Reference for information about attributes that are
ALLOWED ON SYSTEM DATABASES
allowed or not allowed for a space type space in a
Explanation: System databases cannot be the object database type database. Correct and resubmit the stmt
of certain types of operations. The attempted 'operation' type statement.
cannot be performed on system databases. One
SQLSTATE: 53001
possible reason for this error is that CCSID ASCII was
specified when a system database was being created.
-621 DUPLICATE DBID dbid WAS DETECTED
System Action: The statement cannot be executed.
AND PREVIOUSLY ASSIGNED TO
No changes were made to the specified system
database-name
database.
Explanation: The current database being created was
Programmer Response: Do not attempt to perform
assigned a DBID of 'dbid', which is identical to the DBID
the requested operation on system databases.
assigned to database 'database-name'. An
SQLSTATE: 42832 inconsistency exists between the DB2 catalog and
directory.
-619 OPERATION DISALLOWED BECAUSE System Action: The statement cannot be executed.
THE DATABASE IS NOT STOPPED No new object was created, and the existing object was
not altered or modified.
Explanation: The statements CREATE, ALTER or
DROP for a table space, table, or index in the database Programmer Response: Notify the system
cannot be processed unless the database is stopped programmer. The inconsistency must be corrected
(using the STOP command). before CREATE DATABASE will be successful.
System Action: The statement cannot be processed. System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
Programmer Response: Issue the -DISPLAY
and Reference for information on identifying and
DATABASE command to verify that the work file
reporting the problem.
database is stopped before resubmitting the statement.
SQLSTATE: 58001
SQLSTATE: 55011
-622 FOR MIXED DATA IS INVALID
-620 KEYWORD keyword IN stmt type
BECAUSE THE MIXED DATA INSTALL
STATEMENT IS NOT PERMITTED FOR
OPTION IS NO
A space type SPACE IN THE database
type DATABASE Explanation: FOR MIXED DATA is specified in a
column description of a CREATE or ALTER TABLE, a
Explanation: The specified keyword in the SQL
CREATE FUNCTION, or a CREATE PROCEDURE
statement stmt type indicates an attribute that is not
statement, but the MIXED DATA install option is set to
allowed for a space type space in the database type
NO. FOR MIXED DATA is valid only when the MIXED
database.
DATA install option is set to YES.
keyword
System Action: The statement is not executed.
Specifies the keyword that is not allowed.
Programmer Response: Either change the install
stmt type
option or the FOR clause. If the install option is correctly
CREATE or ALTER
set to NO, the allowable FOR clause options are BIT
CREATE is for CREATE TABLESPACE or and SBCS.
CREATE INDEX.
SQLSTATE: 56031
Chapter 2. SQL Return Codes 81
-623 • -628
System Action: The SQL statement cannot be
-623 A CLUSTERING INDEX ALREADY
executed.
EXISTS ON TABLE table-name
Programmer Response: Stop the page set before
Explanation: The CREATE INDEX statement would
resubmitting the statement.
create a second cluster index on the specified table. A
given table can have only one cluster index. SQLSTATE: 55015
System Action: The statement cannot be executed.
-627 THE ALTER STATEMENT IS INVALID
Programmer Response: Check to determine the
BECAUSE THE PAGESET HAS
identity and validity of the existing cluster index on the
USER-MANAGED DATA SETS
object table. Alternatively, consider creating the index
without the CLUSTER attribute. Explanation: This code is used if a PRIQTY,
SECQTY, or ERASE clause is specified, USING
SQLSTATE: 55012
STOGROUP is not specified, and the page set has
user-managed data sets.
-624 TABLE table-name ALREADY HAS A
System Action: The SQL statement cannot be
PRIMARY KEY OR UNIQUE KEY
executed.
CONSTRAINT WITH SPECIFIED
COLUMNS Programmer Response: Verify that the correct table
or partition is specified. The primary and secondary
Explanation: The code is used to report that a primary
space allocation of a user-managed data set cannot be
| key or unique key cannot be defined in an ALTER
altered by means of an ALTER statement.
| TABLE statement because the table either:
| v Already has a primary key, or SQLSTATE: 55016
| v Has an existing unique constraint with the same
| definition (same set of columns specified) as the new -628 THE CLAUSES ARE MUTUALLY
| key. EXCLUSIVE
System Action: The statement cannot be run. Explanation: Mutually exclusive clauses were
specified in one or more of the following ways:
| Programmer Response: Do not attempt to define a
| table with more than one primary key, or a unique v A CREATE TABLESPACE statement contains both
| constraint that duplicates the definition of an existing the SEGSIZE and NUMPARTS clauses.
| unique constraint. v A CREATE TABLESPACE statement contains both
the SEGSIZE and LARGE clauses.
SQLSTATE: 42889
v A CREATE TABLESPACE statement contains both
the SEGSIZE and MEMBER CLUSTER clauses.
-625 TABLE table-name DOES NOT HAVE AN
v A CREATE or ALTER TABLESPACE contains both
INDEX TO ENFORCE THE
the LOCKPART YES and LOCKSIZE TABLESPACE
| UNIQUENESS OF THE PRIMARY OR
| UNIQUE KEY v A 'column-definition' contains both NOT NULL and
DEFAULT NULL clauses.
| Explanation: The ALTER TABLE statement is invalid
v A 'column-definition' contains both FIELDPROC and
| because the table does not have a unique index with a
DEFAULT clauses.
| key that is identical to the nominated primary or unique
| key. v A select-statement contains both the update-clause
and the FOR FETCH ONLY clause.
System Action: The statement cannot be executed.
v An ALTER TABLE statement contains both a DROP
Programmer Response: Make sure the key list CONSTRAINT clause and either a DROP FOREIGN
specified on the ALTER TABLE statement identifies an | KEY, DROP CHECK, DROP PRIMARY KEY, or
existing unique index of the table. | DROP UNIQUE clause.
SQLSTATE: 55014 v A CREATE or ALTER TABLESPACE statement
contains both LOCKPART YES and LOCKSIZE
TABLESPACE.
-626 THE ALTER STATEMENT IS NOT
v A CREATE TRIGGER statement specifies more than
EXECUTABLE BECAUSE THE PAGE
one correlation name for OLD, NEW, OLD_TABLE, or
SET IS NOT STOPPED
NEW_TABLE. Each of these correlation specifications
Explanation: An ALTER statement specifies a can appear no more than once in the CREATE
BUFFERPOOL, USING, PRIQTY, SECQTY, ERASE, or TRIGGER statement.
GBPCACHE clause, but the page set is not stopped. v A CREATE FUNCTION statement contains both a
CAST FROM clause and a SOURCE clause.
82 DB2 UDB for OS/390 and z/OS: Messages and Codes
-629 • -632
v A CREATE FUNCTION statement contains both a System Action: The statement cannot be processed.
SOURCE clause and a RETURNS TABLE clause.
Programmer Response: Change a column of the key
v A CREATE FUNCTION statement contains both a to allow null values or change the delete rule.
SOURCE clause and a clause used to define an
external function (For example, EXTERNAL, SQLSTATE: 42834
LANGUAGE, NO SQL).
v A CREATE or ALTER PROCEDURE statement -630 THE WHERE NOT NULL
attempts to use the NO WLM ENVIRONMENT and SPECIFICATION IS INVALID FOR TYPE
PROGRAM TYPE SUB options. When NO WLM 1 INDEXES
ENVIRONMENT is used, then SECURITY must also
be used. Explanation: Type 1 indexes cannot be created with
the WHERE NOT NULL specification.
v A CREATE or ALTER PROCEDURE statement
attempts to use both NO WLM ENVIRONMENT and System Action: The statement cannot be executed.
either USER or DEFINER for SECURITY. When NO
Programmer Response: Either the index must be
WLM ENVIRONMENT is used, then SECURITY DB2
created as a type 2 index, or the WHERE NOT NULL
must also be used.
specification must not be used.
| v A CREATE or ALTER PROCEDURE statement
| contains both a LANGUAGE REXX clause, and a SQLSTATE: 56089
| PARAMETER STYLE DB2SQL or PARAMETER
| STYLE JAVA clause. -631 FOREIGN KEY name IS TOO LONG OR
v An ALTER TABLE statement contains both an ALTER HAS TOO MANY COLUMNS
COLUMN clause and a VALIDPROC clause.
Explanation: This code is used to report that the sum
v An ALTER TABLE statement contains both an ALTER of the length attributes of the columns identified in the
COLUMN clause and a clause other than the check indicated FOREIGN KEY clause is greater than 255
constraint clause. bytes or the number of columns identified is greater
v The AS (subselect) clause of a DECLARE GLOBAL than 64. The 'name' is the constraint-name specified in
TEMPORARY TABLE statement contains both an the FOREIGN KEY clause or, if a constraint-name was
INCLUDING COLUMN DEFAULTS clause and a not specified, the first column-name specified in the
USING TYPE DEFAULTS clause. clause.
v A CREATE DATABASE statement contains both the System Action: The statement cannot be executed.
AS WORKFILE clause and the AS TEMP clause.
Programmer Response: The table definition must be
v If INSENSITIVE or SENSITIVE is specified, then
modified to conform to the system-imposed limit of the
SCROLL must also be specified, either on DECLARE
sum of the length attributes of the columns identified in
CURSOR or with the ATTRIBUTES clause of the
the PRIMARY KEY clause.
PREPARE statement.
v If SCROLL is specified, then either INSENSITIVE or SQLSTATE: 54008
SENSITIVE STATIC must also be specified, either on
DECLARE CURSOR or with the ATTRIBUTES clause -632 THE TABLE CANNOT BE DEFINED AS
of the PREPARE statement. A DEPENDENT OF table-name
v The attribute-string specified in the ATTRIBUTES BECAUSE OF DELETE RULE
clause of the PREPARE statement cannot specify RESTRICTIONS
conflicting options.
Explanation: This code is used to report that the
| Programmer Response: Change the options object of an ALTER TABLE statement cannot be defined
| specified in the statement, and reissue the statement. as a dependent of the indicated table because either:
SQLSTATE: 42613 v The relationship would form a cycle that would cause
the table to be delete-connected to itself.
v The relationship would cause the table to be
-629 SET NULL CANNOT BE SPECIFIED
delete-connected to the indicated table through
BECAUSE FOREIGN KEY name
multiple paths and the delete rule of the existing
CANNOT CONTAIN NULL VALUES
relationship is SET NULL.
Explanation: The code SET NULL option of the
The error is due to the delete rules of existing
indicated FOREIGN KEY clause is invalid because no
relationships, not the delete rule specified in the
column of the key allows null values. The name is the
FOREIGN KEY clause of the ALTER TABLE statement.
constraint-name specified in the FOREIGN KEY clause
or, if a constraint-name was not specified, the first System Action: The statement cannot be executed.
column-name specified in the clause.
Programmer Response: Eliminate the particular
Chapter 2. SQL Return Codes 83
-633 • -638
FOREIGN KEY clause from the ALTER or CREATE
-636 THE PARTITIONING KEYS FOR
TABLE statement.
PARTITION part-num ARE NOT
SQLSTATE: 42915 SPECIFIED IN ASCENDING OR
DESCENDING ORDER
-633 THE DELETE RULE MUST BE Explanation: In the CREATE INDEX or ALTER INDEX
delete-rule statement for the CLUSTER index for a partitioned table
(that is, a table residing in a partitioned table space),
Explanation: The code is used to report that the the partitioning key values specified in the limit key
'delete-rule' specified in a FOREIGN KEY clause of the value specifications were not in either ascending or
ALTER TABLE statement is invalid. The indicated descending order.
'delete-rule' is required because:
v A self-referencing constraint must have a 'delete-rule' System Action: The statement cannot be executed.
of CASCADE or NO ACTION. The specified cluster index was not created.
v The relationship would cause the table to be Programmer Response: Correct the limit key value
delete-connected to the same table through multiple specifications in the CREATE INDEX or ALTER INDEX
paths and such relationships must have the same statement for the identified partitionso that the limit key
'delete-rule'. values for successive partitions are in strictly ascending
or descending order.
System Action: The statement cannot be executed.
SQLSTATE: 56016
Programmer Response: Change the 'delete rule' in
the FOREIGN KEY clause.
-637 DUPLICATE keyword KEYWORD
SQLSTATE: 42915
Explanation: The SQL statement contains a duplicate
specification for the keyword keyword. For example:
-634 THE DELETE RULE MUST NOT BE
CASCADE v DEFAULT, UNIQUE, and PRIMARY can only be
specified once in a column definition.
Explanation: The code is used to report that the v UNIQUE and PRIMARY cannot both be specified for
CASCADE delete rule specified in the FOREIGN KEY the same column definition.
clause of an ALTER TABLE statement is invalid
because: v PRIMARY can only be specified once in a CREATE
TABLE statement.
v The relationship would form a cycle that would cause
a table to be delete-connected to itself. v The attribute-string specified in the ATTRIBUTES
clause of the PREPARE statement cannot specify an
v The relationship would cause another table to be option more than once.
delete-connected to the same table through multiple
paths with different delete rules or with a delete rule System Action: The statement cannot be processed.
equal to SET NULL.
Programmer Response: Correct the statement by
System Action: The statement cannot be executed. removing duplicate clauses.
Programmer Response: Change the delete rule. SQLSTATE: 42614
SQLSTATE: 42915
-638 TABLE table-name CANNOT BE
CREATED BECAUSE COLUMN
-635 THE DELETE RULES CANNOT BE DEFINITION IS MISSING
DIFFERENT OR CANNOT BE SET
NULL Explanation: The CREATE TABLE statement does not
contain any column definition.
Explanation: The code is used to report that the
delete rules specified in two FOREIGN KEY clauses of System Action: The SQL statement cannot be
the CREATE TABLE statement are invalid because the executed.
table would be delete-connected to the same table
Programmer Response: Add column definition to the
through multiple paths involving relationships with
statement.
different delete rules or with delete rules of SET NULL.
SQLSTATE: 42601
System Action: The statement cannot be executed.
Programmer Response: Change the delete rule.
SQLSTATE: 42915
84 DB2 UDB for OS/390 and z/OS: Messages and Codes
-639 • -647
-639 A NULLABLE COLUMN OF A FOREIGN -643 CHECK CONSTRAINT EXCEEDS
KEY WITH A DELETE RULE OF SET MAXIMUM ALLOWABLE LENGTH
NULL CANNOT BE A COLUMN OF THE
Explanation: The check constraint definition exceeds
KEY OF A PARTITIONED INDEX
the maximum allowable limit of 3800 characters. The
Explanation: A partition key of the clustering index redundant blank spaces are excluded from this limit.
cannot be updated. Therefore, a foreign key column
System Action: The CREATE TABLE or ALTER
with a delete rule of SET NULL cannot be a column of a
TABLE statement failed.
partition key if that column is nullable. If this error
occurs for an ALTER TABLE operation, the foreign key Programmer Response: Rewrite the check constraint
cannot be created. If this error occurs for a CREATE definition so that it is less than 3800 characters. You
INDEX operation, the index cannot be created. might need to divide the check constraint into two or
more smaller check constraints.
System Action: The statement cannot be executed.
SQLSTATE: 54024
Programmer Response: Review the delete rule of the
referential constraint and the partition keys for the index.
Do one of the following: -644 INVALID VALUE SPECIFIED FOR
v If the operation in error was CREATE INDEX, either KEYWORD keyword IN stmt-type
change the index partition key definition or drop and STATEMENT
redefine the referential constraint with a different Explanation: The value specified for the 'keyword'
delete rule. parameter in the 'stmt-type' SQL statement is not a
v If the operation in error was ALTER TABLE, change permitted value.
the referential delete rule so that all nullable index
keys are not part of the foreign keys. System Action: The SQL statement cannot be
executed.
SQLSTATE: 56027
Programmer Response: Correct the statement. Refer
to Chapter 5 of DB2 SQL Reference for information
-640 LOCKSIZE ROW CANNOT BE about the permissible values for the 'keyword' keyword
SPECIFIED BECAUSE TABLE IN THIS in 'stmt-type' statements.
TABLESPACE HAS TYPE 1 INDEX
SQLSTATE: 42615
Explanation: If LOCKSIZE ROW is specified for a
table space, all indexes on tables in the table space
must be type 2 indexes. The following SQL statement -646 TABLE table-name CANNOT BE
identifies all the type 1 indexes: CREATED IN SPECIFIED TABLE SPACE
table-space-name BECAUSE IT
SELECT I.CREATOR, I.NAME ALREADY CONTAINS A TABLE
FROM SYSIBM.SYSINDEXES I,
SYSIBM.SYSTABLES T Explanation: The table space specified in a CREATE
WHERE INDEXTYPE = ' ' TABLE statement is a partitioned, default, or LOB table
AND T.TSNAME = 'table_space_name' space in which an existing table already resides. Only
AND T.DBNAMe = 'database_name' one table may reside in a partitioned, default, or LOB
AND T.CREATOR = I.TBCREATOR
table space.
AND T.NAME = I.TBNAME;
System Action: The statement cannot be executed.
where ’table_space_name’ is the name of the table The specified table was not created.
space that is to be altered; ’database_name’ is the
Programmer Response: Verify that the correct table
name of the database that contains the table space.
space was specified in the CREATE statement. Do not
System Action: The statement cannot be executed. attempt to create more than one table in a partitioned,
default, or LOB table space.
Programmer Response: Since the LOCKSIZE ROW
on the table space and the type 1 indexes conflict, SQLSTATE: 55017
either use the ALTER INDEX statement to convert all
type 1 indexes to type 2 indexes or use another
-647 BUFFERPOOL bp-name CANNOT BE
LOCKSIZE option.
SPECIFIED BECAUSE IT HAS NOT
SQLSTATE: 56089 BEEN ACTIVATED
Explanation: The buffer pool specified in a CREATE
or ALTER statement for a table space or index (index
space) is not activated.
Table spaces and indexes (index spaces) can only be
Chapter 2. SQL Return Codes 85
-650 • -655
assigned or reassigned to buffer pools that are currently System Action: The statement is not executed. For
activated. an ALTER TABLE statement, the definition of the table
is unchanged. For a CREATE TABLE statement, the
System Action: The statement cannot be executed.
table is not created.
The specified table space or index space was not
created or altered. SQLSTATE: 54025
Programmer Response: Verify that the proper buffer
pool was specified in the CREATE or ALTER statement. -652 VIOLATION OF INSTALLATION
Use the -DISPLAY BUFFERPOOL command to display DEFINED EDIT OR VALIDATION
the attributes of the buffer pool and determine if the PROCEDURE proc-name
buffer pool is activated. If the buffer pool is not
Explanation: The result of the SQL statement has
activated, use the -ALTER BUFFERPOOL command to
been rejected by the installation defined edit or
change the VPSIZE from 0 to the desired size.
validation procedure 'proc-name' for the object table.
SQLSTATE: 57003
System Action: The statement cannot be executed.
The contents of the object table were not modified.
-650 THE ALTER INDEX CANNOT BE
Programmer Response: Determine the requirements
EXECUTED, REASON reason
imposed by the edit or validation procedure for inserts
Explanation: The ALTER INDEX statement cannot be and updates of the object table.
executed for one of the following reasons:
SQLSTATE: 23506
1 Alter to type 1 index is not allowed for the
index whose associated table space has a
-653 TABLE table-name IN PARTITIONED
LOCKSIZE specification of ROW.
TABLE SPACE tspace-name IS NOT
2 Alter to type 1 index is not allowed for the AVAILABLE BECAUSE ITS
index defined with UNIQUE WHERE NOT PARTITIONED INDEX HAS NOT BEEN
NULL. CREATED
3 Alter to type 1 index is not allowed for the Explanation: An attempt has been made to insert or
index whose associated table space has been manipulate data in or create a view on a partitioned
defined as a LARGE table space. table (that is, a table residing in a partitioned table
space) before the partitioned index for that table has
4 Alter to type 1 index is not allowed for an index
been created.
on an ASCII table.
A table residing in a partitioned table space cannot be
5 Alter PIECESIZE is not allowed for a
referenced in any SQL manipulative statement or a
partitioning index.
CREATE VIEW statement before the partitioned index
6 Alter PIECESIZE 4G is not allowed for for that table has been created.
non-partitioned indexes on a non-LARGE table.
System Action: The statement cannot be executed.
11 Alter VALUES is not allowed for an index on a
Programmer Response: Verify that the correct table
partitioned base table with LOB columns.
was specified in the statement. If so, ensure that the
System Action: The ALTER INDEX statement is not partitioned index for the table has been created
executed. successfully before attempting to execute any SQL
manipulative statements that reference that table.
Programmer Response: Correct the error according
to the given reason and execute the statement again. SQLSTATE: 57004
SQLSTATE: 56090
-655 THE CREATE OR ALTER STOGROUP
IS INVALID BECAUSE THE STORAGE
-651 TABLE DESCRIPTION EXCEEDS GROUP WOULD HAVE BOTH SPECIFIC
MAXIMUM SIZE OF OBJECT AND NON-SPECIFIC VOLUME IDS
DESCRIPTOR.
Explanation: One of the following error conditions
Explanation: The CREATE TABLE or ALTER TABLE occurred:
statement causes the table descriptor (record OBD) to
exceed the object descriptor size limit of 32KB. v Both a specific and a non-specific ('*') volume ID are
specified in the VOLUMES clause of a CREATE
Programmer Response: Change the statement by STOGROUP statement.
reducing either the number or length (or a combination v Both a specific and a non-specific ('*') volume ID are
of both) of the user-defined default string constants or specified in an ADD VOLUMES clause of an ALTER
check constraints and execute the statement again. STOGROUP statement.
86 DB2 UDB for OS/390 and z/OS: Messages and Codes
-658 • -662
v A specific volume ID is specified in an ADD System Action: The statement cannot be executed.
VOLUMES clause of an ALTER of a storage group The specified cluster index was not created or altered.
that has non-specific volume IDs or mixed volume
Programmer Response: Verify that the correct table
IDs.
was specified in the CREATE INDEX or ALTER INDEX
v A non-specific volume ID ('*') is specified in an ADD statement. If so, the definition for the partitioned table
VOLUMES clause of an ALTER of a storage group space must be examined so that a proper definition for
that has specific volume IDs or mixed volume IDs. the cluster index for the table may be constructed. Refer
System Action: The statement is not executed. to Chapter 5 of DB2 SQL Reference for information
about the requirements that must be satisfied by the
Programmer Response: Specify either specific or definitions for the cluster indexes for partitioned tables.
non-specific volume IDs in the VOLUMES clause of
CREATE STOGROUP statement and the ADD SQLSTATE: 53035
VOLUMES clause of the ALTER STOGROUP
statement. To add specific volume IDs to a storage -661 INDEX index-name CANNOT BE
group with non-specific volume IDs, use the REMOVE CREATED ON PARTITIONED TABLE
VOLUMES clause to remove the non-specific volume SPACE tspace-name BECAUSE THE
IDs. To add non-specific volume IDs to a storage group NUMBER OF PART SPECIFICATIONS
with specific volume IDs, use the REMOVE VOLUMES IS NOT EQUAL TO THE NUMBER OF
clause to remove the specific volume IDs. PARTITIONS OF THE TABLE SPACE
SQLSTATE: 56036 Explanation: The CREATE INDEX statement for the
cluster index on a partitioned table (that is, a table
-658 A object-type CANNOT BE DROPPED residing in a partitioned table space) does not contain
USING THE statement STATEMENT the same number of PART specifications as there are
partitions in the table space. The definition for the
Explanation: A DROP statement was issued, but the cluster index for a partitioned table must contain exactly
object cannot be explicitly dropped. The object must be as many PART specifications as there are partitions in
dropped by dropping an associated object: the table space in which that table resides. Also, the
TRIGGER PACKAGE part numbers must be valid and unique.
A trigger package cannot be dropped with the System Action: The statement cannot be executed.
DROP PACKAGE statement. A trigger package The specified cluster index was not created.
can only be dropped implicitly when the
associated trigger is dropped using the DROP Programmer Response: Examine the definition of the
TRIGGER statement. partitioned table space to determine how many
partitions have been specified, and then correct the
CAST FUNCTION syntax of the CREATE INDEX statement to provide the
A cast function cannot be explicitly dropped proper number of PART specifications. Refer to Chapter
with the DROP FUNCTION statement. A cast 5 of DB2 SQL Reference for information about the
function can only be dropped implicitly when definitions for cluster indexes on partitioned tables.
the associated distinct type is dropped using
the DROP DISTINCT TYPE statement. SQLSTATE: 53036
System Action: The SQL statement cannot be
executed. -662 A PARTITIONED INDEX CANNOT BE
CREATED ON A NON-PARTITIONED
Programmer Response: Issue the appropriate DROP TABLE SPACE tspace-name
statement to drop the intended objects.
Explanation: The CREATE INDEX statement contains
SQLSTATE: 42917 PART specifications, but the specified object table is not
partitioned (that is, does not reside in a partitioned table
-660 INDEX index-name CANNOT BE space).
CREATED OR ALTERED ON System Action: The statement cannot be executed.
PARTITIONED TABLE SPACE The specified index was not created.
tspace-name BECAUSE KEY LIMITS
ARE NOT SPECIFIED Programmer Response: Verify that the proper object
table was specified in the statement. Refer to Chapter 5
Explanation: The CREATE INDEX or ALTER INDEX of DB2 SQL Reference for information about the proper
statement did not specify limit key values for the usage of PART specifications in CREATE INDEX
partitions of the table space. To create a clustering statements.
index for a table in a partitioned table space, or to
modify those values using ALTER INDEX, you must SQLSTATE: 53037
include those values.
Chapter 2. SQL Return Codes 87
-663 • -668
stmt-verb
-663 THE NUMBER OF KEY LIMIT VALUES
The type of data definition language (DDL)
IS EITHER ZERO, OR GREATER THAN
statement
THE NUMBER OF COLUMNS IN THE
KEY OF INDEX index-name object The DB2 object type
Explanation: The number of limit key value function
specifications provided in at least one of the PART A utility, the governor, or the distributed data
specifications of the CREATE INDEX or ALTER INDEX facility (DDF)
statement is either zero or greater than the number of
columns in the index key. If the object is part of the communications database, it
System Action: The statement cannot be executed. cannot be dropped while the DDF is active.
The specified index was not created. System Action: The statement was not executed.
Programmer Response: Correct the statement so Programmer Response: If the function is a utility, wait
that each PART specification contains exactly the same for the function to complete or stop. Then resubmit the
number of limit key value specifications as there are statement for execution.
columns in the index key.
If the function is the governor, the statement cannot be
SQLSTATE: 53038 executed until the resource limit facility is stopped or
switched to a different resource limit specification table
-665 THE PART CLAUSE OF AN ALTER (RLST). In a DB2 data sharing environment, the
STATEMENT IS OMITTED OR INVALID resource limit facility must be stopped on all members
of the DB2 data sharing group or all members must
Explanation: The ALTER statement is invalid for one switch to an RLST that is not associated with the object.
of the following reasons:
If the function is the DDF, the facility must be stopped
v The table space or index is not partitioned and the before the object can be dropped. In a DB2 data
PART clause is specified. sharing environment, the facility must be stopped on all
v The table space or index is partitioned, a partition members of the DB2 data sharing group.
attribute (FREEPAGE or PCTFREE) is specified, and
the PART clause is not specified. SQLSTATE: 57005
v The integer specified in the PART clause does not
identify a partition of the table space or index. -667 THE CLUSTERING INDEX FOR A
v A USING, PRIQTY, SECQTY, or ERASE clause is PARTITIONED TABLE SPACE CANNOT
used to alter storage attributes, but the partition is not BE EXPLICITLY DROPPED
specified. Explanation: The DROP INDEX statement attempted
v A GBPCACHE clause is used to alter the group to drop the cluster index for a table residing in a
buffer pool caching attributes, but the partition is not partitioned table space. The cluster index for such a
specified. table cannot be dropped explicitly with the DROP
v The VALUES clause is specified without the PART INDEX statement.
clause. You must specify PART to change VALUES. System Action: The statement cannot be executed.
System Action: The SQL statement cannot be The specified index was not dropped.
executed. Programmer Response: The cluster index for a table
Programmer Response: Determine whether the table in a partitioned table space can only be dropped
space or index you want to alter is partitioned. If it is implicitly when the associated partitioned table space is
partitioned, specify a PART clause that identifies the dropped.
partition you want to alter. If it is not partitioned, do not SQLSTATE: 42917
specify the PART clause.
SQLSTATE: 53039 -668 THE COLUMN CANNOT BE ADDED TO
THE TABLE BECAUSE THE TABLE
-666 stmt-verb object CANNOT BE HAS AN EDIT PROCEDURE
EXECUTED BECAUSE function IS IN Explanation: The ALTER TABLE statement attempted
PROGRESS to add a column to a table that has an edit procedure. If
Explanation: The SQL statement could not be a table has an edit procedure, no columns can be
executed because the named function was executing at added to it.
the time. System Action: The statement cannot be executed.
The specified table was not altered.
88 DB2 UDB for OS/390 and z/OS: Messages and Codes
-669 • -671
Programmer Response: Verify that the correct table | v The row length of a large sort record exceeds the
was specified in the ALTER statement. Do not attempt | page size of a work file table space. The sort record
to ALTER the definition of a table that has an | includes columns that are being sorted and columns
installation-written edit procedure associated with it. | that the user selects. The length of the columns that
| are being sorted is the sort key length. The length of
SQLSTATE: 56018
| the columns that the user selects is the sort data
| length.
| -669 THE OBJECT CANNOT BE EXPLICITLY
System Action: The statement cannot be executed.
| DROPPED. REASON reason-code
The object table was not created or altered.
| Explanation: The DROP statement failed for the Programmer Response: In the case of CREATE
| reason indicated by the reason-code as follows: TABLE, either (1) the row length of the table must be
| 0001 The DROP TABLE statement attempted to reduced (by eliminating or reducing the lengths of one
| drop a table that resides in a partitioned table or more of the columns), or (2) the table must be
| space. assigned to a table space that uses a larger buffer pool
(assuming that the row length of the table does not
| 0002 The DROP INDEX statement attempted to drop exceed that page size limit).
| an index required to enforce the primary key,
| unique key, or referential constraint of the In the case of ALTER TABLE, either (1) the length of
| table. the column to be added to the table must be reduced
or, (2) if the row length of the table is already at the
| System Action: The statement cannot be processed. maximum, the table cannot be altered to add any
| The object is not dropped. additional columns.
| Programmer Response: If the statement is a DROP In the case of a row length that exceeds the page size
| TABLE statement, the table of a partitioned table space of a work file table space, eliminate columns from the
| can only be dropped implicitly when the table space result of the join.
| itself is dropped.
| In the case of a large sort record in which the row
| If the statement is a DROP INDEX statement and you | length exceeds the page size of a work file table space,
| do not want to keep the primary key, unique key, or | eliminate columns from the SELECT list or reduce the
| referential constraint, use the DROP CONSTRAINT | number of columns that are being sorted.
| clause of the ALTER TABLE statement to remove the
| constraint, then drop the index. SQLSTATE: 54010
SQLSTATE: 42917
-671 THE BUFFERPOOL ATTRIBUTE OF
THE TABLE SPACE CANNOT BE
-670 THE RECORD LENGTH OF THE TABLE ALTERED AS SPECIFIED BECAUSE IT
EXCEEDS THE PAGE SIZE LIMIT WOULD CHANGE THE PAGE SIZE OF
Explanation: The row length for a table cannot THE TABLE SPACE
exceed the page size of the table space in which that Explanation: For example, the change to the buffer
table resides (or is to reside). The page size of the table pool attribute for the table space specified in the ALTER
space is determined by the buffer pool used by that TABLESPACE statement would change the page size of
table space. the table space—either from 4KB to 32KB, 8KB to
One of following conditions may occur: 16KB, or vice versa.
v As defined in a CREATE TABLE statement, the row Use of the ALTER TABLESPACE statement to change
length for the table would exceed the page size of the page size of a table space is not permitted.
the specified (or default) table space.
System Action: The statement cannot be executed.
v In the case of an ALTER TABLE statement, addition The table space definition was not altered.
of the specified column would cause the row length
of the table to exceed the page size of the table Programmer Response: For example, if the table
space. space uses one of the 4KB buffer pools (for example,
v In the case of an ALTER TABLE statement used to BP0, BP1, or BP2), it can be reassigned to one of the
alter the length of an existing variable length column, other 4KB buffer pools (but not buffer pool BP32K). If,
the new length of the altered column would cause the however, it is assigned to buffer pool BP32K, the buffer
row length of the table to exceed the page size of the pool assignment cannot be subsequently altered.
table space. SQLSTATE: 53040
v The row length in the result of a join exceeds the
page size of a work file table space.
Chapter 2. SQL Return Codes 89
-672 • -680
during interactive execution of an SQL statement or
-672 OPERATION DROP NOT ALLOWED ON
execution of an application program, installation
TABLE table_name
administration should be notified.
Explanation: The DROP operation failed for one of
Installation Action: It may be necessary to reexamine
the following reasons:
the buffer pool storage strategy.
v The table being dropped has the RESTRICT ON
DROP attribute. One of the following messages has also been sent to
the MVS console: DSNB601I, DSNB603I, or DSNB605I.
v The table space or database being dropped contains
Refer to “Part 3. DB2 Messages” on page 133 for
the specified table, which has the RESTRICT ON
explanations of these messages.
DROP attribute.
SQLSTATE: 57011
System Action: The DROP statement cannot be
executed.
-678 THE LITERAL literal SPECIFIED FOR
Programmer Response: Before dropping the table,
THE INDEX LIMIT KEY MUST
alter the table, specifying DROP RESTRICT ON DROP.
CONFORM TO THE DATA TYPE
For DROP TABLESPACE or DROP DATABASE, make data-type OF THE CORRESPONDING
sure that there are no other tables within the table COLUMN column-name
space or database with the RESTRICT ON DROP
Explanation: The index limit key value 'literal' has
attribute. The following SELECT statement can identify
been specified incorrectly in the CREATE INDEX or
the tables:
ALTER INDEX statement.
SELECT CREATOR, NAME
FROM SYSIBM.SYSTABLES Limit key value specifications must conform to the data
WHERE TYPE = 'T' type of the corresponding index key column. In this
AND CLUSTERTYPE = 'Y' case, the 'literal' must be of data type 'data-type' to
AND DBNAME = 'database_name' conform to the data type of column 'column-name'.
AND TSNAME = 'tablespace_name';
System Action: The statement cannot be executed.
SQLSTATE: 55035 The specified index was not created.
Programmer Response: Correct the statement so
-676 ONLY A 4K PAGE BUFFERPOOL CAN that each limit key value literal is of precisely the same
BE USED FOR AN INDEX data type as that of the corresponding index key
Explanation: A buffer pool having a page size other column.
than 4KB was specified in the CREATE INDEX SQLSTATE: 53045
statement. Only 4KB buffer pools (that is, BP0, BP1,
and BP2) can be specified for indexes.
-679 THE OBJECT name CANNOT BE
System Action: The statement cannot be executed. CREATED BECAUSE A DROP IS
The specified index was not created. PENDING ON THE OBJECT
Programmer Response: Correct the statement to Explanation: The application program has executed a
specify a 4KB buffer pool. Refer to Chapter 5 of DB2 DROP for the specified object, and then tried to
SQL Reference for information about the syntax of SQL re-create an object with the same name (and of the
statements. same type) before the DROP was completed.
SQLSTATE: 53041 System Action: The statement cannot be executed.
The specified object was not created.
-677 INSUFFICIENT VIRTUAL STORAGE Programmer Response: The logic of the application
FOR BUFFERPOOL EXPANSION program must be modified to issue a COMMIT (or the
Explanation: An attempt to either open (create) or IMS or CICS equivalent) between the DROP and
expand a buffer pool has failed because insufficient CREATE statements.
virtual storage was available. SQLSTATE: 57006
This error may occur under either of two circumstances:
v An attempt to create a buffer pool while opening a | -680 TOO MANY COLUMNS SPECIFIED FOR
table space or index(space), or | A TABLE, VIEW OR TABLE FUNCTION
v An attempt to expand a buffer pool from its current
size to its maximum size. | Explanation: The maximum number of columns
| permitted per table, view, or table function is 750. The
System Action: The statement cannot be executed. | statement attempted to perform one of the following
Programmer Response: If this error should occur | actions:
90 DB2 UDB for OS/390 and z/OS: Messages and Codes
-681 • -686
| v CREATE or ALTER a table to contain more than 750
-683 THE SPECIFICATION FOR COLUMN,
| columns
DISTINCT TYPE, FUNCTION, OR
| v CREATE a view with more than 750 columns PROCEDURE data-item CONTAINS
| v CREATE a table function with more than 750 INCOMPATIBLE CLAUSES
| columns in the RETURNS TABLE clause
Explanation: There is an error in the data item
System Action: The statement cannot be executed. specification in a CREATE or ALTER statement.
Incompatible specifications are present such as
| Programmer Response: Change the CREATE ″INTEGER and FOR BIT DATA″. The location of the
| statement to not include more than 750 columns, or do error is given by data-item as follows:
| not try to alter an existing table to contain more than
| 750 columns. v For a CREATE or ALTER TABLE statement,
data-item gives the name of the column containing
SQLSTATE: 54011 the error. The error could be an invalid specification
of FOR BIT DATA, FOR SBCS DATA, FOR MIXED
DATA, or FIELDPROC for column data-item.
-681 COLUMN column-name IN VIOLATION
OF INSTALLATION DEFINED FIELD v For a CREATE FUNCTION or CREATE
PROCEDURE. RT: return-code, RS: PROCEDURE statement, data-item is a token that
reason-code, MSG: message-token identifies the area of the problem in the statement.
For example, ″PARAMETER 3″ or ″RETURNS″ or
Explanation: An installation field procedure returned ″CAST FROM″.
an error for 'column-name'. The 'reason-code' and
v For a CREATE DISTINCT TYPE statement, data-item
'message-token' are defined by the field procedure.
gives the name of the type being defined.
They may give additional information to help determine
the cause of the problem. System Action: The statement cannot be executed.
Return code Programmer Response: Correct the SQL statement
Error by removing the incompatible specification.
4 Invalid value on encode or decode or invalid
column description on define SQLSTATE: 42842
8 Invalid parameter value
12 Field procedure error on any function -684 THE LENGTH OF LITERAL LIST
BEGINNING string IS TOO LONG
Use 'reason-code' and 'message-token' for additional
information. Explanation: The length of the literal list beginning
with 'string', excluding insignificant blanks and delimiting
System Action: The statement cannot be executed. parentheses is greater than 255.
Programmer Response: If it is not a field procedure System Action: The statement cannot be executed.
error, determine the requirements imposed by the field
procedure. If it is a field procedure error, examine the Programmer Response: Correct the SQL statement.
field procedure. SQLSTATE: 54012
SQLSTATE: 23507
-685 INVALID FIELD TYPE, column-name
-682 FIELD PROCEDURE procedure-name Explanation: The field description returned by the field
COULD NOT BE LOADED procedure is invalid. The data type code denotes a long
Explanation: The field procedure 'procedure-name' string or has an invalid value.
cannot be loaded. System Action: The statement cannot be executed.
System Action: The statement cannot be executed. Programmer Response: Correct the field procedure
Programmer Response: The application should either so that it returns a valid data type code.
commit or roll back to previous COMMIT. Then, in SQLSTATE: 58002
general, the application should terminate.
SQLSTATE: 57010 -686 COLUMN DEFINED WITH A FIELD
PROCEDURE CAN NOT COMPARE
WITH ANOTHER COLUMN WITH
DIFFERENT FIELD PROCEDURE
Explanation: The columns specified are not
compatible. Different field procedures are specified, or
only one field procedure is specified.
Chapter 2. SQL Return Codes 91
-687 • -691
System Action: The statement cannot be executed. for the reason indicated by 'reason-code' after
consulting the application registration table and object
Programmer Response: Correct the SQL statement.
registration table.
Refer to Chapter 2 of DB2 SQL Reference for
comparison restrictions between columns defined with a The explanation of the given reason code:
field procedure. v 0001
SQLSTATE: 53043 Data definition control support is running under the
controlling by application name mode. The statement
is rejected because the current application is not
-687 FIELD TYPES INCOMPARABLE
registered in application registration table with
Explanation: One column cannot be compared with DEFAULTAPPL on.
another column that has incompatible field types. v 0002
System Action: The statement cannot be executed. Data definition control support is running under the
controlling by application name with exceptions
Programmer Response: Correct the SQL statement. mode. The statement is rejected because the object
Refer to Chapter 2 of DB2 SQL Reference for is not registered in object registration table and the
comparison restrictions between columns defined with a current application is not registered in application
field procedure. registration table with DEFAULTAPPL on.
SQLSTATE: 53044 v 0003
Data definition control support is running under the
-688 INCORRECT DATA RETURNED FROM controlling by application name with exceptions
FIELD PROCEDURE, column-name, mode. The statement is rejected because the object
msgno is registered in object registration table but the
current application does not match.
Explanation: Unexpected data returned from field
v 0004
procedure for column 'column-name'. For more
information see 'msgno'. Data definition control support is running under the
controlling by object name with exceptions mode. The
System Action: The statement cannot be executed. statement is rejected because the object is registered
Programmer Response: Correct the field procedure in object registration table but the current application
so that it returns values that are consistent with their does not match.
descriptions. v 0005
SQLSTATE: 58002 Data definition control support is running under the
controlling by object name mode. The statement is
rejected because the object is registered in object
-689 TOO MANY COLUMNS DEFINED FOR A registration table but the current application does not
DEPENDENT TABLE match.
Explanation: The maximum number of columns v 0006
allowed for a dependent table is 749. The code is used Data definition control support is running under the
to report that the statement is invalid because of one of controlling by object name mode. The statement is
the following: rejected because the object is not registered in object
v A CREATE TABLE statement is creating a dependent registration table.
table with 750 columns.
System Action: The statement cannot be executed.
v An ALTER TABLE statement is altering a dependent
table with 749 columns to add a column, or altering a Programmer Response: None if valid rejection.
table with 750 columns to become a dependent table. Otherwise, check to see if data definition control support
is running under the desired mode. Check one or both
System Action: The statement cannot be executed. registration table(s) to determine if the entries of the
Programmer Response: Correct the SQL statement registration table(s) are correct. If they are not, then
to conform to the column limit for a dependent table. update the registration table(s).
SQLSTATE: 54011 SQLSTATE: 23508
-690 THE STATEMENT IS REJECTED BY -691 THE REQUIRED REGISTRATION
DATA DEFINITION CONTROL TABLE table-name DOES NOT EXIST
SUPPORT. REASON reason-code Explanation: The data definition control support
Explanation: The code is issued by the data definition assumes the existence of the application registration
control support to report that the statement is rejected table and object registration table. But either one or
both tables is not defined.
92 DB2 UDB for OS/390 and z/OS: Messages and Codes
-692 • -697
System Action: The statement cannot be executed. The application registration table or object registration
table was dropped, but the DROP statement was not
Programmer Response: Determine whether the
committed.
required registration tables do exist. If not, create the
required tables. System Action: The statement cannot be executed.
SQLSTATE: 57018 Programmer Response: Resubmit the job. If the
same error happens, check for the application that
issued the DROP statement for the application
-692 THE REQUIRED UNIQUE INDEX
registration table or the object registration table. Either
index-name FOR DDL REGISTRATION
commit the DROP statement which dropped the table
TABLE table-name DOES NOT EXIST
and create a new application registration table or object
Explanation: A unique index must be defined for each registration table, or issue a ROLLBACK for the DROP
registration table. The code is issued when either the statement to put the tables back.
required index does not exist or the index defined is not
SQLSTATE: 57023
a unique index.
System Action: The statement cannot be executed.
-696 THE DEFINITION OF TRIGGER
Programmer Response: Determine whether the trigger-name INCLUDES AN INVALID
required unique index does exist. If not, create the USE OF CORRELATION NAME OR
required index. If the index does exist, but is not unique, TRANSITION TABLE NAME name.
drop it and recreate it as a unique index. REASON CODE=reason-code
SQLSTATE: 57018 Explanation: The trigger definition included an invalid
use of name
-693 THE COLUMN column-name IN DDL trigger-name
REGISTRATION TABLE OR INDEX The trigger that encountered the error
table-name (index-name) IS NOT
name The transition variable correlation name or
DEFINED PROPERLY
transition table name
Explanation: An error occurred during verification of
reason-code
the application or object registration table.
A reason-code indicating the specific problem
The table is improperly defined for the following as follows:
reasons: 1. NEW correlation name and NEW_TABLE
v A required column is missing. name are not allowed in a DELETE trigger.
v A column description is invalid because its name, 2. OLD correlation name and OLD_TABLE
column number, data type, length, or null attribute is name are not allowed in an INSERT trigger.
incorrect. 3. OLD_TABLE name and NEW_TABLE
name are not allowed in a BEFORE trigger.
or System Action: The statement cannot be executed.
The trigger was not created.
The index is improperly defined for the following
reasons: Programmer Response: Remove the invalid
v A required key column is missing. correlation name or transition table name along with the
v A key column description is invalid because of its key preceding keyword.
sequence or because its ordering is incorrect. SQLSTATE: 42898
v A defined key column should not be part of the
unique key.
-697 OLD OR NEW CORRELATION NAMES
System Action: The statement cannot be executed. ARE NOT ALLOWED IN A TRIGGER
Programmer Response: Correct or alter the definition DEFINED WITH THE FOR EACH
of the required registration table or index. STATEMENT CLAUSE. OLD_TABLE OR
NEW_TABLE NAMES ARE NOT
SQLSTATE: 55003 ALLOWED IN A TRIGGER WITH THE
BEFORE CLAUSE.
-694 THE DDL STATEMENT CANNOT BE Explanation: The trigger, as defined, includes a
EXECUTED BECAUSE A DROP IS REFERENCING clause with one of the following invalid
PENDING ON THE DDL REGISTRATION combinations:
TABLE table-name
v OLD or NEW correlation names specified (or both)
Explanation: An error occurred while accessing the and the FOR EACH STATEMENT clause.
application registration table or object registration table.
Chapter 2. SQL Return Codes 93
-713 • -718
v NEW_TABLE or OLD_TABLE correlation names User Response: Precompile the named program
specified (or both) and the BEFORE clause. again using the current precompiler. Reissue the BIND
subcommand.
System Action: The statement cannot be executed.
The trigger was not defined. Problem Determination: If the program was
precompiled at an appropriate release, and the problem
Programmer Response: Remove invalid correlation
persists, collect the following:
names or change the trigger granularity to FOR EACH
v A hexadecimal print of the first record of the failing
ROW.
DBRM
SQLSTATE: 42899 v The listing from the precompile job that generated the
DBRM
v Output from the BIND attempt.
-713 THE REPLACEMENT VALUE value FOR
special-register IS INVALID SQLSTATE: 56065
Explanation: The value specified in the SET
special-register statement is not a valid value of the -717 bind-type FOR object-type object-name
indicated special register. WITH MARK release-dependency-mark
FAILED BECAUSE object-type
System Action: The statement cannot be executed. DEPENDS ON FUNCTIONS OF THE
Programmer Response: Correct the replacement RELEASE FROM WHICH FALLBACK
value. See DB2 SQL Reference for an explanation of HAS OCCURRED
the valid values of each special register. Explanation: The plan or package indicated depends
SQLSTATE: 42815 on a function of DB2 which is not supported by the
currently active release.
-715 PROGRAM program-name WITH MARK bind-type
release-dependency-mark FAILED REBIND
BECAUSE IT DEPENDS ON object-type
FUNCTIONS OF THE RELEASE FROM PLAN | PACKAGE
WHICH FALLBACK HAS OCCURRED
object-name
Explanation: Program 'program-name' depends on a Name of the application plan, or the package
function of DB2 that is not supported by the current
active release. release-dependency-mark
A one-character mark showing the oldest
program-name release of DB2 can support this plan or
Name of the application program. package. The release dependency mark for the
release-dependency-mark plan is kept in the IBMREQD columns in the
A 1-character mark showing the oldest DB2 DB2 catalog in SYSIBM.SYSPLAN (plans),
release supporting this program. SYSIBM.SYSPACKAGE(packages).
System Action: The BIND operation for this plan or System Action: The REBIND operation for this plan
package is not performed. or package is not performed.
User Response: The program cannot be used until User Response: The plan or package cannot be used
the DB2 subsystem is remigrated to the newer release. until the DB2 subsystem is remigrated to the newer
release.
Operator Response: Notify the system programmer.
Operator Response: Notify the system programmer.
System Programmer Response: Warn users not to
use plans or packages containing this program until the System Programmer Response: Warn users not to
DB2 subsystem has been remigrated to the newer use the plan or package until the DB2 subsystem has
release. been remigrated to the newer release.
SQLSTATE: 56064 SQLSTATE: 56066
-716 PROGRAM program-name -718 REBIND OF PACKAGE package-name
PRECOMPILED WITH INCORRECT FAILED BECAUSE IBMREQD OF
LEVEL FOR THIS RELEASE ibmreqd IS INVALID
Explanation: Program 'program-name' was Explanation: The IBMREQD column of the
precompiled under a release not supported by the SYSIBM.SYSPACKAGE catalog table for the named
current level of DB2, or the contents of the DBRM have package contains an unrecognizable character.
been modified after the precompilation phase.
94 DB2 UDB for OS/390 and z/OS: Messages and Codes
-719 • -722
package-name System Programmer Response: There are two
Name of the package approaches to solve this problem. The first is to
(location.collection.package.version) precompile the program again with a new version name
and reissue the original BIND subcommand. The other
System Action: The REBIND failed.
approach is not to do the precompile but reissue the
User Response: You must do a BIND BIND subcommand with REPLVER(SAME).
ACTION(REPLACE) for this package.
SQLSTATE: 42710
SQLSTATE: 56067
-721 BIND ERROR FOR PACKAGE = pkg-id
-719 BIND ADD ERROR USING auth-id CONTOKEN = contoken’X IS NOT
AUTHORITY PACKAGE package-name UNIQUE SO IT CANNOT BE CREATED
ALREADY EXISTS
Explanation: An attempt is made to add or replace a
Explanation: An attempt is made to add a package package with a consistency token that is not unique for
that already exists. The combination of that package. In other words, the combination of
'location.collection.package.version' must be unique in location.collection.package.consistency-token already
the SYSIBM.SYSPACKAGE table. In addition, the exists.
combination of 'location.collection.package.consistency-
pkg-id Fully qualified name of the package.
token' must be unique.
contoken
auth-id Authorization ID of the invoker of the BIND
Consistency token in hexadecimal.
subcommand.
System Action: The BIND will fail.
package-name
Name of the package System Programmer Response: Check the
(location.collection.package.version). SYSIBM.SYSPACKAGE catalog table for names of
existing application packages with the indicated
System Action: No package is created.
consistency token. Reissue the BIND subcommand
System Programmer Response: Check the such that the location.collection.package.consistency-
SYSIBM.SYSPACKAGE catalog table for names of token is unique within the catalog. The following SQL
existing application packages. Re-invoke the BIND statement can be used to query the catalog:
subcommand with a 'location.collection.package.version' SELECT COLLID,NAME
that is not in use. FROM loc-id.SYSIBM.SYSPACKAGE
WHERE HEX(CONTOKEN) = contoken
SQLSTATE: 42710
SQLSTATE: 42710
-720 BIND ERROR, ATTEMPTING TO
REPLACE PACKAGE = package_name -722 bind-type ERROR USING auth-id
WITH VERSION = version2 BUT THIS AUTHORITY PACKAGE package-name
VERSION ALREADY EXISTS DOES NOT EXIST
Explanation: An attempt is made to create a version Explanation: The indicated subcommand was issued
of a package that already exists. The version specified against a package that does not exist. The individual
in the REPLVER keyword is different from the version variable fields contain:
specified for the precompile. The version specified for
bind-type
the precompile already exists in the catalog. The
Type of bind subcommand (BIND | REBIND |
combination of 'location.collection.package.version' must
FREE).
be unique in the SYSIBM.SYSPACKAGE catalog table.
A common mistake is that the user may believe that the auth-id Authorization ID of the invoker of the BIND
version he is creating is the one specified in the subcommand.
REPLVER keyword. This is not the case. The version
specified in the REPLVER keyword is the name of the package-name
version being replaced. The version that will be created Name of the package
is the version that was given to the program when it (location.collection.package.version)
was precompiled. System Action: Package not rebound or freed.
package_name System Programmer Response: Check the
Fully qualified package name SYSPACKAGE catalog table for the correct
version2 'location.collection.package.version' to use.
Version-id of package that is to be created SQLSTATE: 42704
System Action: The bind will fail.
Chapter 2. SQL Return Codes 95
-723 • -725
-723 AN ERROR OCCURRED IN A -724 THE ACTIVATION OF THE object-type
TRIGGERED SQL STATEMENT IN OBJECT object-name WOULD EXCEED
TRIGGER trigger-name, SECTION THE MAXIMUM LEVEL OF INDIRECT
NUMBER section-number. SQL CASCADING
INFORMATION RETURNED: SQLCODE
Explanation: Cascading of indirect SQL occurs when
sqlerror, SQLSTATE sqlstate, AND
a trigger, user-defined function or stored procedure
MESSAGE TOKENS token-list
invokes another trigger, user-defined function or stored
Explanation: During execution of an UPDATE, procedure which in turn invokes another. The activation
INSERT, or DELETE statement, a trigger was activated. of some of the triggers in this chain might be due to the
One of the triggered SQL statements received an SQL enforcement of referential constraint delete rules. The
error condition. depth of this cascading is limited to 16.
trigger-name Note that recursive situations where a trigger includes a
The trigger that was activated when the error triggered SQL statement that directly or indirectly
occurred. causes the same trigger to be activated are very likely
to cause this error. The trigger should contain logic to
section-number
check for a terminating condition to prevent this error.
The section number associated with the failing
triggered SQL statement. For triggers that object-type
contain a WHEN clause, the WHEN clause is Names the type of object being called. Object
section number one. The triggered SQL type is TRIGGER, FUNCTION, or
statements are numbered sequentially, PROCEDURE.
beginning with section number two. This is true
object-name
for triggers with or without a WHEN clause.
Specifies the name of the trigger, user-defined
sqlcode function or stored procedure that would have
The SQLCODE received by the activated be activated at the seventeenth level of
trigger. cascading.
sqlstate System Action: The original statement could not be
The corresponding SQLSTATE for the executed. All SQL statements executed by all triggers,
SQLCODE received by the activated trigger. user-defined functions, and stored procedures in the
cascade chain are rolled back. External actions
token-list
performed by the indirect SQL, such as sending a
The list of tokens from the original SQL error.
network message might have already occurred.
This list might be truncated.
Programmer Response: Start with the indirect SQL
System Action: The trigger and the original INSERT,
that is activated by the original SQL operation. Check
UPDATE, or DELETE statement cannot be processed.
for recursive patterns in any invoked user-defined
The triggering table is unchanged.
functions or in any triggers defined on the subject of an
Programmer Response: Contact your Database update operation. If the chain is not recursive, the
Administrator to determine why the trigger named in the cascade chain must be simplified by altering the
message received the error. triggers, user-defined functions, or stored procedures
involved.
System Programmer Response: Use the trigger
name and section number to determine the failing SQL SQLSTATE: 54038
statement. If the trigger definition is available, use the
section number to determine the failing statement.
-725 THE SPECIAL REGISTER register AT
Alternatively, the failing statement can be retrieved from
LOCATION location WAS SUPPLIED AN
the SYSIBM.SYSPACKSTMT catalog table: SELECT
INVALID VALUE
TEXT, SEQNO FROM SYSIBM.SYSPACKSTMT
WHERE COLLID = ’schema-name’ AND NAME = Explanation: DB2 received a SET statement with an
’trigger-name’ AND SECTNO = section-number ORDER invalid value. Valid SETs might be allowed or retained.
BY SEQNO Refer to the explanation of the reported Further processing stops at the named site until the
SQLCODE. Follow the action suggested by that SET statement is corrected.
SQLCODE.
System Action: All SQL statements at the named
SQLSTATE: 09000 remote site are rejected until the SET statement that
was in error is corrected.
Programmer Response: The SET statement should
be reissued with a valid value. This situation can be
corrected with a local SET statement or with a DRDA
SET statement executed at the remote site. Once the
96 DB2 UDB for OS/390 and z/OS: Messages and Codes
-726 • -733
special register has been supplied a valid value, the stored procedure that was defined with the COMMIT
application can resume execution. ON RETURN attribute.
SQLSTATE: 42721 SQLSTATE: 429B1
-726 BIND ERROR ATTEMPTING TO -730 THE PARENT OF A TABLE IN A
REPLACE PACKAGE = package-name. READ-ONLY SHARED DATABASE
THERE ARE ENABLE OR DISABLE MUST ALSO BE A TABLE IN A
ENTRIES CURRENTLY ASSOCIATED READ-ONLY SHARED DATABASE
WITH THE PACKAGE
Explanation: An attempt was made to define a
Explanation: The BIND subcommand was issued to relationship between a table in a read-only shared
replace a package that has ENABLE or DISABLE database and a table that is not.
entries currently associated with the package.
System Action: The statement cannot be executed.
System Action: Package not bound.
Programmer Response: Insure that the correct tables
System Programmer Response: FREE the package are being used for the relationship being defined.
first and then BIND the package.
SQLSTATE: 56053
SQLSTATE: 55030
-731 USER-DEFINED DATASET dsname
-728 DATA TYPE data-type IS NOT MUST BE DEFINED WITH
ALLOWED IN DB2 PRIVATE SHAREOPTIONS(1,3)
PROTOCOL PROCESSING
Explanation: The VSAM SHAREOPTIONS must be
Explanation: An SQL statement uses a data type that (1,3) for all of the indexes and table spaces in the
cannot be used with DB2 private protocol. Data types database. The user-defined data set identified did not
such as LOBs (large objects), row IDs and user defined meet this requirement.
types cannot be accessed using DB2 private protocol.
System Action: The statement cannot be executed.
System Action: The statement cannot be executed.
Programmer Response: Insure that the data sets
Programmer Response: If this is an invalid data type, used in the shared database are defined with the proper
correct the statement. If this is a valid (but disallowed) SHAREOPTIONS.
data type, you can:
SQLSTATE: 56054
v Remove access to the data type listed, and
re-execute the statement.
-732 THE DATABASE IS DEFINED ON THIS
v Change the application program so that DRDA is
SUBSYSTEM WITH THE ROSHARE
used to access the data.
READ ATTRIBUTE BUT THE TABLE
v BIND the package containing the statement to the SPACE OR INDEX SPACE HAS NOT
remote site with bind option DBPROTOCOL(DRDA) BEEN DEFINED ON THE OWNING
and rerun the program. SUBSYSTEM
Refer to the DB2 SQL Reference for more information. Explanation: Prior to creating a table space or index
SQLSTATE: 56080 in a database with the ROSHARE READ attribute, that
object must first be defined on the owning subsystem.
-729 A STORED PROCEDURE SPECIFYING System Action: The statement cannot be executed.
COMMIT ON RETURN CANNOT BE Programmer Response: Verify that the table space or
THE TARGET OF A NESTED CALL index has been defined on the owning system in a
STATEMENT ROSHARE OWNER database.
Explanation: A stored procedure defined with the SQLSTATE: 56055
COMMIT ON RETURN attribute was called from a
stored procedure, user-defined function, or trigger.
Stored procedures defined with COMMIT ON RETURN -733 THE DESCRIPTION OF A TABLE
cannot be nested in this way. SPACE, INDEX SPACE, OR TABLE IN A
ROSHARE READ DATABASE MUST BE
System Action: The SQL statement is not executed. If CONSISTENT WITH ITS DESCRIPTION
the CALL statement references a remote server, the unit IN THE OWNER SYSTEM
of work is placed in a must rollback state.
Explanation: This code is issued while creating a
Programmer Response: Remove the CALL to the table space, index, or table in the ROSHARE READ
Chapter 2. SQL Return Codes 97
-734 • -739
database. These objects must be consistent with their SQLSTATE: 55004
descriptions in the ROSHARE OWNER database as
follows:
-736 INVALID OBID obid SPECIFIED
v For a table space, the following attributes must be
the same: Explanation: An invalid OBID value was given on the
Page size CREATE statement. The OBID is invalid for one of the
Segment size following reasons:
Number of partitions v The specified OBID does not fall within the
v For an index, the following attributes must be the acceptable range for OBIDs, which is 1 to 32767.
same: v The specified OBID is already in use for the given
Number of partitions database.
Number of subpages
Table OBID System Action: The statement cannot be executed.
Total key length Programmer Response: Verify that the given OBID is
Index type (Type 1 or Type 2 Index) a valid value for an OBID. If so, ensure that the OBID is
Number of key columns correct for the object to be created, then query the
v For a table, the following attributes must be the catalog to find the object that is already defined as
same: having the same OBID in the database. If an invalid
Table OBID OBID was given for the object to be created, correct the
Maximum record length statement and execute it again. If the existing object is
Number of columns in error, then DROP and CREATE that object using the
Whether an edit procedure exists correct OBID value.
System Action: The statement cannot be executed. It is possible that the OBID “in use” is the OBID for an
object that had been previously dropped. If that is the
Programmer Response: Ensure that the definition of case, and the CREATE was issued for a table in a
the table space, index, or table is consistent with that in non-ROSHARE READ database, then select a different
the ROSHARE OWNER database. OBID for use in the OBID clause. If the object had been
SQLSTATE: 56056 previously dropped and the CREATE was issued for a
table in a ROSHARE READ database, COMMIT and
re-submit the CREATE TABLE request.
-734 THE ROSHARE ATTRIBUTE OF A
DATABASE CANNOT BE ALTERED SQLSTATE: 53014
FROM ROSHARE READ
Explanation: An attempt was made to ALTER a -737 IMPLICIT TABLE SPACE NOT
database from ROSHARE READ to either ROSHARE ALLOWED
OWNER or ROSHARE NONE. Explanation: A CREATE TABLE statement was issued
System Action: The statement cannot be executed. using an implicit table space. An implicit table space
may not be used in a database that has been defined
Programmer Response: Verify that the correct as a read-only shared database.
database was specified on the ALTER DATABASE
statement. The ROSHARE attribute of a read-only System Action: The statement cannot be executed.
shared database cannot be altered. To change this, Programmer Response: CREATE a table space for
DROP and recreate the database. the table, using the same name as is given on the
SQLSTATE: 56057 owning system. Then resubmit the CREATE TABLE
statement.
-735 DATABASE dbid CANNOT BE SQLSTATE: 56056
ACCESSED BECAUSE IT IS NO
LONGER A SHARED DATABASE -739 CREATE OR ALTER FUNCTION
Explanation: An attempt was made to access an function-name FAILED BECAUSE
object in the database identified by dbid, that is known FUNCTIONS CANNOT MODIFY DATA
to the system as having the ROSHARE READ attribute. WHEN THEY ARE PROCESSED IN
The database, however, is no longer defined as PARALLEL.
ROSHARE OWNER on the owning subsystem. Explanation: The function cannot be created or
System Action: The statement cannot be processed. altered because ALLOW PARALLEL and MODIFIES
SQL DATA were both specified explicitly or implicitly. A
Programmer Response: Verify that the correct object function cannot be parallelized if it modifies data.
is specified on the statement.
System Action: The statement cannot be processed.
98 DB2 UDB for OS/390 and z/OS: Messages and Codes
-740 • -747
Programmer Response: Specify DISALLOW DSNDB07, is the implicit work file database.
PARALLEL or change the MODIFIES SQL DATA to NO
System Action: The statement cannot be executed.
SQL, CONTAINS SQL or READS SQL DATA.
Programmer Response: To create the work file
SQLSTATE: 56088
database for a DB2 subsystem that is not a member of
a DB2 data sharing group, create database DSNDB07
-740 FUNCTION name IS DEFINED WITH without the WORKFILE clause.
THE OPTION MODIFIES SQL DATA
SQLSTATE: 53004
WHICH IS NOT VALID IN THE
CONTEXT IN WHICH IT WAS INVOKED
-746 THE SQL STATEMENT IN AN
Explanation: A user-defined function defined with
EXTERNAL FUNCTION, TRIGGER, OR
MODIFIES SQL DATA is only allowed in:
IN STORED PROCEDURE name
v VALUES clause of an INSERT statement VIOLATES THE NESTING SQL
v SET clause of an UPDATE statement RESTRICTION
v VALUES statement in a trigger Explanation: If a table is being modified (by INSERT,
v SET Assignment statement DELETE or UPDATE), the table can not be accessed by
v CALL procedure statement the lower level nesting SQL statement.
System Action: The SQL statement failed. If any table is being accessed by a SELECT statement,
no table can be modified (by INSERT, DELETE or
Programmer Response: Remove the user-defined UPDATE) in any lower level nesting SQL statement.
function from the failing statement. or remove the
MODIFIES SQL DATA option from the definition of the System Action: The SELECT, INSERT, DELETE or
function. UPDATE SQL statement failed.
SQLSTATE: 51034 Programmer Response: Remove the failing
statement from the named external function, trigger or
the stored procedure.
-741 A database-type DATABASE IS
ALREADY DEFINED FOR MEMBER SQLSTATE: 57053
member-name
Explanation: A CREATE DATABASE statement was -747 TABLE table-name IS NOT AVAILABLE
issued for a WORK FILE or TEMP database, but the UNTIL THE AUXILIARY TABLES AND
database can not be created because one is already INDEXES FOR ITS EXTERNALLY
defined for the named DB2 subsystem or data sharing STORED COLUMNS HAVE BEEN
group member. CREATED
database-type Explanation: An attempt was made to access or
WORK FILE or TEMP reference a table with one or more LOB columns,
however either
member-name
v an auxiliary table for storing one of the LOB columns
Name of the DB2 subsystem or data sharing
has not been created, or
group member that already has a
database-type database. v an index has not been created for an auxiliary table,
or
System Action: The statement cannot be executed.
v there is not an auxiliary table for each partition of the
Programmer Response: Verify the identity and table space.
validity of the existing database-type database for the
System Action: The statement was not executed.
named DB2 subsystem or data sharing member. The
existing database can be altered or dropped if Programmer Response:
necessary. If the existing database is dropped, resubmit 1. Use CREATE TABLESPACE to create a LOB table
the CREATE DATABASE statement. space.
2. Use CREATE TABLE to create the auxiliary table for
SQLSTATE: 55020
storing the column.
3. Use CREATE INDEX to create an index on the
-742 DSNDB07 IS THE IMPLICIT WORK FILE auxiliary table.
DATABASE 4. Resubmit the statement that failed.
Explanation: The WORKFILE clause cannot be used SQLSTATE: 57054
on a CREATE DATABASE statement to create a work
file database for a DB2 subsystem that is not a member
of a DB2 data sharing group. The system database,
Chapter 2. SQL Return Codes 99
-748 • -763
| can be done by issuing an SQL ROLLBACK
-748 AN INDEX ALREADY EXISTS ON
| statement or the equivalent IMS or CICS
AUXILIARY TABLE table-name
| operation.
Explanation: The CREATE INDEX statement would
| User-defined function
create a second index on the specified auxiliary table.
| External function object-name issued one of
An auxiliary table can have only one index.
| the following SQL statements:
System Action: The statement cannot be executed. | v COMMIT
| v ROLLBACK
Programmer Response: An index already exists.
Another index cannot be created. | System Action: The statement cannot be executed.
SQLSTATE: 54042 | Programmer Response: Remove the unsupported
| statement from your stored procedure or user-defined
| function.
-750 THE SOURCE TABLE source-name
CANNOT BE RENAMED BECAUSE IT | SQLSTATE: 38003
IS REFERENCED IN EXISTING VIEW
DEFINITIONS OR TRIGGER
-752 THE CONNECT STATEMENT IS
DEFINITIONS
INVALID BECAUSE THE PROCESS IS
Explanation: The source table in a RENAME NOT IN THE CONNECTABLE STATE
statement cannot be renamed because it is referenced
Explanation: The application process attempted to
in one or more existing view definitions or it is
execute a CONNECT statement while in the
referenced as the triggering table in one or more
unconnectable state. See the description of the
existing triggers. The table has check constraints
CONNECT statement in the DB2 SQL Reference for an
defined.
explanation of connection states.
System Action: The statement cannot be executed.
System Action: The statement cannot be executed.
Programmer Response: Change the source name to The connection state of the application process is
the name of an object that can be renamed and reissue unchanged.
the statement. Drop any triggers defined on the table
Programmer Response: Modify the application
before issuing the RENAME statement. These can be
program to execute a commit or rollback operation prior
found by querying the system catalog: SELECT * FROM
to executing the CONNECT statement.
SYSIBM.SYSTRIGGERS WHERE TBNAME =
’source-name’ SQLSTATE: 0A001
SQLSTATE: 42986
-763 INVALID TABLE SPACE NAME
table-space-name
| -751 object-type object-name (SPECIFIC
| NAME specific name) ATTEMPTED TO Explanation: The named table space is invalid for one
| EXECUTE AN SQL STATEMENT of the following reasons:
| statement THAT IS NOT ALLOWED v It is a LOB table space and therefore cannot reside in
a work file database.
| Explanation: A stored procedure or user-defined
v It is a LOB table space and therefore cannot contain
| function attempted to execute an SQL statement that is
a non-auxiliary table.
| not allowed.
v It is not a LOB table space and therefore cannot
| Stored procedure contain an auxiliary table.
| A stored procedure issued an SQL statement
System Action: The statement cannot be executed.
| that forced the DB2 thread to roll back the unit
| of work. The SQL statement that caused the Programmer Response: Either
| thread to be placed in the MUST_ROLLBACK v Create the LOB table space in a non-workfile
| state is one of the following: database.
| COMMIT v Create the table in a non-LOB table space.
| ROLLBACK v Create the auxiliary table in a LOB table space.
SQLSTATE: 560A1
| All further SQL statements are rejected until
| the SQL application that issued the SQL CALL
| statement rolls back the unit of work. When
| control returns to the SQL application that
| issued the SQL CALL statement, the SQL
| application must roll back the unit of work. This
100 DB2 UDB for OS/390 and z/OS: Messages and Codes
-764 • -768
or CREATE FUNCTION statement. Data in an auxiliary
-764 A LOB TABLE SPACE AND ITS
table can only be accessed through operations on the
ASSOCIATED BASE TABLE SPACE
base table columns.
MUST BE IN THE SAME DATABASE
System Action: The statement cannot be executed.
Explanation: An attempt was made to create an
auxiliary table in a LOB table space that is not in the Programmer Response: Correct the statement to
same database as the associated base table space. specify the corresponding base table instead of the
auxiliary table and resubmit the statement.
System Action: The statement cannot be executed.
SQLSTATE: 560A4
Programmer Response: Correct the statement to
specify a LOB table space in the same database as the
associated base table space. -767 MISSING OR INVALID COLUMN
SPECIFICATION FOR INDEX
SQLSTATE: 560A2
index-name
Explanation: The CREATE INDEX statement failed for
-765 TABLE IS NOT COMPATIBLE WITH
one of the following reasons:
DATABASE
v An index on a non-auxiliary table must specify the
Explanation: A CREATE TABLE or ALTER TABLE columns on which the index is defined.
statement defines a LOB column in a table whose
v An index on an auxiliary table must not have a
database attribute is ROSHARE OWNER or ROSHARE
column specification.
READ. This is not permitted.
System Action: The statement cannot be executed.
System Action: The statement is not executed.
Programmer Response: Correct the syntax of the
Programmer Response: If CREATE TABLE, either
CREATE INDEX statement.
assign the table to an ROSHARE NONE database or
create the table without a LOB column. If ALTER v To create an index on a non-auxiliary table, specify
TABLE, redefine the column as a non-LOB column or the columns on which the index is defined.
move the table to an ROSHARE NONE database. v To create an index on an auxiliary table, do not
specify the name of any column.
SQLSTATE: 560A3
SQLSTATE: 42626
-766 THE OBJECT OF A STATEMENT IS AN
AUXILIARY TABLE FOR WHICH THE -768 AN AUXILIARY TABLE ALREADY
REQUESTED OPERATION IS NOT EXISTS FOR THE SPECIFIED COLUMN
PERMITTED OR PARTITION
Explanation: An auxiliary table was named in one of Explanation: An attempt was made to create an
the following statements: auxiliary table, but an auxiliary table for the specified
v ALTER TABLE column or partition already exists. When the base table
v CREATE ALIAS belongs to a non-partitioned table space, there can be
v CREATE FUNCTION only one auxiliary table per LOB column of the table.
v CREATE SYNONYM When the base table belongs to a partitioned table
v CREATE VIEW space, for any given LOB column, all values of the LOB
v DELETE column for a given partition are stored in their own
v DESCRIBE TABLE auxiliary table. There must be one auxiliary table per
v INSERT partition of the base table space.
v SELECT
v UPDATE System Action: The statement is not executed.
Programmer Response: Check that the correct table
There are no attributes of an auxiliary table that can be name, column name, and if applicable, partition number
altered. have been specified. If a different name is desired for
the existing auxiliary table, the RENAME TABLE
Aliases and synonyms cannot be created on an statement can be used to rename the auxiliary table.
auxiliary table.
SQLSTATE: 560A5
Data in an auxiliary table cannot be accessed by
specifying the auxiliary table name in the SELECT,
INSERT, DELETE, UPDATE, CREATE PROCEDURE,
Chapter 2. SQL Return Codes 101
-769 • -798
v A ROWID column cannot be a column in a table with
-769 SPECIFICATION OF CREATE AUX
an EDITPROC.
TABLE DOES NOT MATCH THE
CHARACTERISTICS OF THE BASE System Action: The statement cannot be executed.
TABLE
Programmer Response: Correct the syntax and
Explanation: Either an attempt was made to create an resubmit the statement.
auxiliary table
SQLSTATE: 428C7
v using the PART clause and the specified base table
is not partitioned or
v without using the PART clause and the specified -797 ATTEMPT to CREATE TRIGGER
base table is partitioned trigger-name WITH AN UNSUPPORTED
TRIGGERED SQL STATEMENT
If the base table is not partitioned, then the PART
keyword is not allowed on the CREATE AUXILIARY Explanation: The trigger definition includes an
TABLE statement. If the base table is partitioned, then unsupported triggered SQL statement. The SQL
the PART keyword must be specified. statements allowed as a triggered SQL statement
depend on the type of trigger:
System Action: The auxiliary table was not created. v A BEFORE trigger can include the following triggered
Programmer Response: Check whether the name of SQL statements:
the base table specified in the CREATE AUXILIARY – a fullselect or VALUES statement
TABLE statement is correct. If it is correct and the table – a SET transition-variable statement (not allowed in
is not partitioned, remove the PART clause from the a BEFORE DELETE trigger)
statement. If it is correct and the table is partitioned, – a SIGNAL SQLSTATE statement
add the PART clause to the statement. If the table – a CALL statement
name is not correct, correct the name and also check v An AFTER trigger can include the following triggered
that the correct column name is specified. SQL statements:
– a fullselect or VALUES statement
SQLSTATE: 53096
– an INSERT statement
– a searched UPDATE statement
-770 TABLE table-name CANNOT HAVE A – a searched DELETE statement
LOB COLUMN UNLESS IT ALSO HAS A – a SIGNAL SQLSTATE statement
ROWID COLUMN – a CALL statement
Explanation: An attempt was made to create a table System Action: The CREATE TRIGGER statement
with a LOB column or to add a LOB column to a table, cannot be executed, and the trigger is not created.
but the table does not have a ROWID column. A table
Programmer Response: Check the triggered SQL
with a LOB column must also have a ROWID column.
statements in the trigger for any statement that is not
System Action: The statement was not executed. listed above and remove it.
Programmer Response: If creating a table with a SQLSTATE: 42987
LOB column, define a column with type ROWID in the
same table. If using ALTER to add a LOB column to a
| -798 YOU CANNOT INSERT A VALUE INTO
table, first use ALTER to add a column with type
| A COLUMN THAT IS DEFINED WITH
ROWID to the table.
| THE OPTION GENERATED ALWAYS
SQLSTATE: 530A6 | COLUMN column-name
| Explanation: When inserting into a table, a value was
-771 INVALID SPECIFICATION OF A ROWID | specified for column column-name with the GENERATE
COLUMN | ALWAYS attribute. GENERATED ALWAYS columns
| should not be specified in the column-list for an
Explanation: For an ALTER or CREATE TABLE
| insertion unless the corresponding entry in the VALUES
statement, the specification of a ROWID column might
| list is DEFAULT.
be invalid for one of the following reasons:
v A ROWID column cannot be added to a temporary | System Action: The INSERT is not performed.
table. | Programmer Response: Remove the column from the
v The referential-constraint clause cannot specify a | column-list or specify DEFAULT for the GENERATED
ROWID column as a column of a foreign key. | ALWAYS column in the VALUES clause.
v A ROWID column cannot be a column of a primary | You may also use the OVERRIDING clause as a
| key or unique key. | possible solution for this situation. See INSERT in DB2
| SQL Reference for more information about the
102 DB2 UDB for OS/390 and z/OS: Messages and Codes
-802 • -803
| OVERRIDING USER VALUE clause. to see if the cause of the problem can be determined.
The problem may be data-dependent, in which case it
| SQLSTATE: 428C9 will be necessary to examine the data that was being
processed at the time the error occurred.
-802 EXCEPTION ERROR exception-type HAS
If the arithmetic expression in error was within the
OCCURRED DURING operation-type
SELECT list of the outer SELECT statement, then it is
OPERATION ON data-type DATA,
advisable to include an indicator variable for all
POSITION position-number
expressions in the SELECT list. This allows processing
Explanation: An exception error has occurred in the to continue so that non-error column and expression
processing of an SQL arithmetic function or arithmetic values can be returned.
expression. This error may be indicated by
See the explanation of SQLCODE -405 for allowed
| exception-type. Possible values for exception-type are
ranges of numeric data types.
| FIXED POINT OVERFLOW, DECIMAL OVERFLOW,
| ZERO DIVIDE, DIVIDE EXCEPTION, EXPONENT Problem Determination: A fixed point overflow can
| OVERFLOW, or OUT OF RANGE. The exception error occur during any arithmetic operation on either
occurred in one of the following areas: INTEGER or SMALLINT fields.
v In the SELECT list of an SQL SELECT statement. A divide exception can occur on a decimal division
v In the search condition of a SELECT, UPDATE, or operation when the quotient exceeds the specified data
DELETE statement. field size. A zero divide occurs on a division by zero.
v In the SET clause of the UPDATE statement. An exponent overflow can occur when the result
v Found during the evaluation of a column function. characteristic of any floating-point operation exceeds
127 and the result fraction is not zero, for example, the
Data-type may indicate the data types of the items magnitude of the result exceeds approximately 7.2E+75.
being manipulated. Possible values for data-type are
A decimal overflow exception can occur under either of
INTEGER, SMALLINT, DECIMAL, and FLOAT. The data
the following circumstances:
type displayed in the message may indicate the data
type of the temporary internal copy of the data, which v One or more non-zero digits are lost because the
may differ from the actual column or literal data type destination field in any decimal operation is too short
due to conversions by DB2. to contain the result.
| v A Java stored procedure or user-defined function sets
Operation-type may indicate the arithmetic operation | a decimal value in an output parameter that has a
that was being performed at the time of the error. The | precision or scale too small for the value.
possible operation-types are ADDITION, | operation-type is JAVA CONVERSION. data-type is
SUBTRACTION, MULTIPLICATION, DIVISION, | DECIMAL. position-number indicates which
| NEGATION, BUILT-IN FUNCTION, COLUMN | parameter of the CALL statement or user-defined
| FUNCTION, and JAVA CONVERSION. | function invocation is in error.
Position-number may indicate the position of the | Any of the exceptions/overflows can occur during the
expression in a SELECT list if the error was in the | processing of a Built-In Function. If the operation-type is
SELECT list of an outer SELECT statement | FUNCTION, then the error occurred while processing
| either an input, intermediate, or final value. The
Note: Parts of exception-type, data-type, | exception may occur because the value of a parameter
operation-type, and/or position-number may not | is out of range.
be returned to the SQL communication area, SQLSTATE: 22012 if ZERO DIVIDE.
depending on where the error was detected.
22003 if other than ZERO DIVIDE.
System Action: The statement cannot be executed. In
the case of an INSERT or UPDATE statement, no data
is updated or deleted. If the statement was a -803 AN INSERTED OR UPDATED VALUE IS
cursor-controlled FETCH, then the CURSOR will remain INVALID BECAUSE THE INDEX IN
| open unless the exception occurred while processing a INDEX SPACE indexspace-name
| column function (indicated by operation-type of CONSTRAINS COLUMNS OF THE
| COLUMN FUNCTION), in which case the CURSOR will TABLE SO NO TWO ROWS CAN
| be closed. If the CURSOR is closed, subsequent CONTAIN DUPLICATE VALUES IN
| attempts to use that cursor without first doing an OPEN THOSE COLUMNS. RID OF EXISTING
| for it receive an SQLCODE -501. If the statement was a ROW IS Xrid
cursor-controlled OPEN then the CURSOR will remain
Explanation: The table that is the object of the
closed.
INSERT or UPDATE operation is constrained (by
Programmer Response: Examine the SQL statement UNIQUE INDEX in the INDEX SPACE
Chapter 2. SQL Return Codes 103
-804 • -805
indexspace-name to have unique values in certain 02 Close issued for non-cursor.
columns. Completion of the requested INSERT or
03 Prepare of EXECUTE IMMEDIATE.
UPDATE would result in duplicate values occurring in
row rid. 04 Statement is not recognized.
If a view is the object of the INSERT or UPDATE 05 No statement string present.
statement, the table that defines the view is constrained.
The update might also be caused by a DELETE 06 Bad SQLDA format in parameter list.
operation of a parent row that cascades to a dependent 07 SQLDA length is invalid.
row with a delete rule of SET NULL.
08 Unrecognized input data type.
System Action: The INSERT, UPDATE, or DELETE
statement cannot be executed. The object table is 09 Invalid length for input variable.
unchanged. 10 Invalid data length for output variable.
Programmer Response: Examine the definitions for 11 The value of SQLDABC is not consistent with
UNIQUE INDEX in the INDEX SPACE the value of SQLD.
indexspace-name to determine the uniqueness
constraint imposed. Please refer to 12 Invalid input data pointer.
SYSIBM.SYSINDEXES for the indexspace-name and 13 Invalid output data pointer.
the associated index-name.
14 SQLN has too many items for SQLDABC.
For an UPDATE statement, verify that the specified
operation is consistent with the uniqueness constraint. If 15 Input RDI pointer is invalid.
this does not indicate the error, examine the object table
16 Unrecognized output data type.
to determine the cause of the problem.
17 The value of the 7th byte of SQLDAID is not
For an INSERT statement, examine the object table to
consistent with the data types contained in the
determine which values violate the uniqueness
SQLDA. The SQLDA contains a LOB type host
constraint. If the INSERT statement contains a
variable, but the 7th byte of SQLDAID is not
subquery, match the contents of the table addressed by
set to ’2’ or greater to indicate that the
the subquery and the contents of the object table to
extended SQLVARs have been allocated.
determine the cause of the problem.
System Action: The statement cannot be executed.
For a DELETE statement, examine the index key
columns in the table that defines the index. These System Programmer Response: Examine the
columns contain a foreign key, which when set NULL on application program for any of the errors noted under
a cascade delete from the object table, causes the the explanation above. In general, the application
duplicate values. programmer should not attempt to modify the output of
the precompiler.
SQLSTATE: 23505
SQLSTATE: 07002
-804 AN ERROR WAS FOUND IN THE
APPLICATION PROGRAM INPUT -805 DBRM OR PACKAGE NAME
PARAMETERS FOR THE SQL location-name.collection-id.dbrm-
STATEMENT, REASON reason name.consistency -token NOT FOUND IN
PLAN plan-name. REASON reason
Explanation: The call parameter list or the SQLDA is
invalid. Explanation: An application program attempted to use
v The call parameter list, which is created by the a DBRM or package 'location-name.collection-id.dbrm-
precompiler, might be invalid if the application name.consistency-token' that was not found.
programmer has modified the output of the Collection id is blank ('location-name..dbrm-
precompiler, used a variable name beginning with name.consistency-token') if the CURRENT
’SQL’ in the application program, or overwritten the PACKAGESET special register was blank for the local
call parameter list in some other way. program execution.
v The SQLDA, which is created by the application
The REASON token is blank if the length of
program, has an invalid data type or data length.
’location-name’ is 16, the length of ’collection-id’ is 18,
v The value of SQLDABC is not consistent with the and the length of ’dbrm-name’ is 8 due to the length of
value of SQLD. SQLERRMT.
The following is the list of reason codes: The DBRM or package name was not found for one or
more of the following reasons:
01 Open issued for non-cursor.
v 01
104 DB2 UDB for OS/390 and z/OS: Messages and Codes
-805
– The DBRM name was not found in the member System Programmer or Programmer response:
list of the plan and there is no package list for the Based on the above reasons, the programmer can
plan. Refer to the first SQL statement under perform one or more of the following operations for
problem determination for assistance in each reason to correct the error.
determining the problem. v 01
– The package name was not found because there – Add the DBRM name ’dbrm-name’ to the
is no package list for the plan. Refer to the second MEMBER list of the BIND subcommand and bind
SQL statement under Problem Determination for the application plan 'plan-name', or
assistance in determining the problem.
– Add the PKLIST option with the appropriate
v 02 package list entry to the REBIND subcommand
The DBRM name 'dbrm-name' did not match an entry and rebind the application plan 'plan-name'.
in the member list or the package list. Any of the v 02
following conditions could be the problem:
– Correct the dbrm-name of the entry in the PKLIST
Bind conditions: option and use the REBIND subcommand to
– The 'collection-id' in the package list was not rebind the application plan 'plan-name', or
correct when the application plan 'plan-name' was – Correct the location-name of the entry in the
bound. Refer to the second SQL statement under PKLIST option and use the REBIND subcommand
Problem Determination for assistance in to rebind the application plan 'plan-name', or
determining the problem.
– Correct the location-name in the
– The ’location-name’ in the package list was not CURRENTSERVER option and use the REBIND
correct when the application 'plan-name' was subcommand to rebind the application plan
bound. Refer to the second SQL statement under 'plan-name', or
Problem Determination for assistance in
– Set the CURRENT PACKAGESET special register
determining the problem.
correctly, or
– The 'location-name' in the CURRENTSERVER
– Connect to the correct location name.
option for the bind subcommand was not correct
when the application plan 'plan-name' was bound. v 03
Refer to the third SQL statement under Problem All the operations under reason 02 above might fix
Determination for assistance in determining the the problem, plus the following operations.
problem. – Correct the collection-id of the entry in the PKLIST
option and use the REBIND subcommand to
Application conditions: rebind the application plan 'plan-name', or
– The CURRENT PACKAGESET special register – Bind the DBRM of the version of the application
was not set correctly by the application. program to be executed into the collection
– The application was not connected to the proper 'collection-id', or
location. – Execute the correct version of the application
v 03 program. The consistency token of the application
The DBRM name 'dbrm-name' matched one or more program is the same as the package that was
entries in the package list and the search of those bound.
entries did not find the package. The conditions listed v 04
under reason 02 or the following conditions might be All the operations under reason 02 and 03 might fix
the problem. the problem.
– The DBRM of the version of the application
Problem Determination: The following queries aid in
program being executed was not bound (A
determining the problem. Run these queries at the local
package with the same consistency token as that
location.
of the application program was not found.) Refer
to the fourth and fifth SQL statements under the 1. This query displays the DBRMs in the member list
Problem Determination section. for the plan. If no rows are returned, then the plan
was bound without a member list.
– The incorrect version of the application program is
being executed. SELECT PLCREATOR, PLNAME, NAME, VERSION
FROM SYSIBM.SYSDBRM
v 04 WHERE PLNAME = 'plan-name';
The package, ’collection-id.dbrm-name.consistency- 2. This query displays the entries in the package list
token’, does not exist at the remote site, for the plan. If no rows are returned, then the plan
’location-name’. Refer to the fifth SQL statement was bound without a package list.
under the Problem Determination section.
System Action: The statement cannot be executed.
Chapter 2. SQL Return Codes 105
-807 • -811
SELECT LOCATION, COLLID, NAME the package is not allocated.
FROM SYSIBM.SYSPACKLIST
WHERE PLANNAME = 'plan-name'; System Programmer Response: One of the
following:
3. This query displays the CURRENTSERVER value
specified on the BIND subcommand for the plan. v Rebind the package to enable it to execute with the
required connection type and name.
SELECT NAME, CURRENTSERVER
FROM SYSIBM.SYSPLAN v Check the SYSPLSYSTEM or SYSPKSYSTEM
WHERE NAME = 'plan-name'; catalog table to find a connection from which the
4. This query displays if there is a matching package in package can be executed.
SYSPACKAGE. If the package is remote, put the v Correct the attach library.
location name in the FROM clause. If no rows are
SQLSTATE: 23509
returned, the correct version of the package was not
bound.
SELECT COLLID, NAME, HEX(CONTOKEN), VERSION -808 THE CONNECT STATEMENT IS NOT
FROM <location-name.>SYSIBM.SYSPACKAGE CONSISTENT WITH THE FIRST
WHERE NAME = 'dbrm-name' CONNECT STATEMENT
AND HEX(CONTOKEN) = 'consistency-token';
Explanation: The CONNECT semantics that apply to
5. This query displays if there is a matching package in an application process are determined by the first
SYSPACKAGE. If the package is remote, put the CONNECT statement executed (successfully or
location name in the FROM clause. Use this query unsuccessfully) by the application process. One of the
when collection-id is not blank. If no rows are following rules was violated:
returned, the correct version of the package was not
v A type 2 CONNECT statement cannot be executed
bound.
after a type 1 CONNECT statement was executed.
SELECT COLLID, NAME, HEX(CONTOKEN), VERSION
FROM <location-name.>SYSIBM.SYSPACKAGE v A type 1 CONNECT statement cannot be executed
WHERE NAME = 'dbrm-name' after a type 2 CONNECT statement was executed.
AND HEX(CONTOKEN) = 'consistency-token' System Action: The statement cannot be executed.
AND COLLID = 'collection-id';
Programmer Response: The probable cause of this
SQLSTATE: 51002
error is that different programs in the application
process were precompiled with different CONNECT
-807 ACCESS DENIED: PACKAGE options.
package-name IS NOT ENABLED FOR
Ensure that the application process uses either type 1
ACCESS FROM connection-type
or type 2 CONNECT statements and then resubmit the
connection-name
job. The type of CONNECT to be used is a precompiler
Explanation: Access is denied for one of the following option. The default is type 2 CONNECT.
reasons:
SQLSTATE: 08001
v It is disabled, either from the ’connection-type’ or
from the ’connection-type’ with the specific
’connection-name’. -811 THE RESULT OF AN EMBEDDED
SELECT STATEMENT OR A
v The attach library that you are using is from a
SUBSELECT IN THE SET CLAUSE OF
previous release of DB2 that does not support the
AN UPDATE STATEMENT IS A TABLE
ENABLE and DISABLE options of the bind operation.
OF MORE THAN ONE ROW, OR THE
RESULT OF A SUBQUERY OF A BASIC
The variables are: PREDICATE IS MORE THAN ONE
package-name VALUE
The package name (collection.package-id). Explanation: Execution of an embedded SELECT
connection-type statement or a subselect in the SET clause of an
One of the following: BATCH, DB2CALL, UPDATE statement has resulted in a result table that
REMOTE, IMSBMP, IMSMPP, CICS, contains more than one row. Alternatively, a subquery
DLIBATCH, or UNKNOWN. contained in a basic predicate has produced more than
one value.
connection-name
Name of the connection that is restricted. If all System Action: The statement cannot be executed.
connection names from a specific Programmer Response: Examine the syntax of the
connection-type are restricted, this value is not statement to ensure that it contains the proper condition
specified. specifications. If the statement syntax is correct, there
System Action: The statement is not executed and might be a problem with the data that is causing more
106 DB2 UDB for OS/390 and z/OS: Messages and Codes
-812 • -818
than one row or value to be returned when you do not
-817 THE SQL STATEMENT CANNOT BE
expect it.
EXECUTED BECAUSE THE
SQLSTATE: 21000 STATEMENT WILL RESULT IN A
PROHIBITED UPDATE OPERATION.
-812 THE SQL STATEMENT CANNOT BE Explanation: The application attempted to execute an
PROCESSED BECAUSE A BLANK SQL statement that would result in updates to user data
COLLECTION-ID WAS FOUND IN THE or to the subsystem catalog. This is prohibited for one
CURRENT PACKAGESET SPECIAL of the following reasons:
REGISTER WHILE TRYING TO FORM A v The application is running as an IMS inquiry-only
QUALIFIED PACKAGE NAME FOR transaction.
PROGRAM program-name.consistency-
v The application is an IMS or CICS application that is
token USING PLAN plan-name
attempting to update data at a remote DBMS that
Explanation: A last or only entry in the package list for does not support two-phase commit.
the plan contained asterisk (*) the 'collection-id ' which v The application is attempting to update data at
requires the 'CURRENT PACKAGESET' special register multiple locations and one of the locations does not
to be set to a nonblank 'collection-id' in order to form a support two-phase commit.
qualified package name.
v A trigger defined with activation time BEFORE was
System Action: The statement cannot be executed. activated and its triggered action caused updates to
the database.
Programmer Response: Set the 'CURRENT
PACKAGESET' special register to the desired These SQL statements include INSERT, UPDATE,
'collection-id' or have your system administrator check DELETE, CREATE, ALTER, DROP, GRANT, and
the plan’s package list for correctness. REVOKE.
SQLSTATE: 22508 System Action: The statement cannot be executed.
Programmer Response: If the application is running
-815 A GROUP BY OR HAVING CLAUSE IS as an IMS inquiry-only transaction, see your IMS
IMPLICITLY OR EXPLICITLY SPECIFIED system programmer about changing the inquiry-only
IN A SUBSELECT OF A BASIC status of the transaction under which your application is
PREDICATE OR THE SET CLAUSE OF running.
AN UPDATE STATEMENT
If the IMS or CICS application is attempting a remote
Explanation: A subselect of a basic predicate or a update, either the application must be changed to run
SET clause of an UPDATE statement either: as a local application on the server DBMS, or the server
v directly contains a GROUP BY or HAVING clause DBMS must be upgraded to support two-phase commit.
v specifies as its object a view having a definition that If the application is attempting to update data at multiple
includes a GROUP BY or HAVING clause locations, either the application must be changed, or all
DBMSs involved must be upgraded to support
Neither construct is permitted. two-phase commit.
System Action: The statement cannot be executed. If the error is due to an invalid statement during a
No data was retrieved. trigger activation, contact your system administrator to
Programmer Response: The implied function is not correct the trigger definition.
supported by DB2. SQLSTATE: 25000
No coding workaround exists for the subselect. A
GROUP BY or HAVING clause cannot be used within -818 THE PRECOMPILER-GENERATED
the subselect of a basic predicate because the TIMESTAMP x IN THE LOAD MODULE
subselect is allowed to return only a single value. For IS DIFFERENT FROM THE BIND
more information on basic predicates, refer to DB2 SQL TIMESTAMP y BUILT FROM THE DBRM
Reference. z
SQLSTATE: 42920 Explanation: The SQL precompiler places timestamp
'y' in the DBRM, and time stamp 'x' in the parameter list
in the application program for each SQL statement. At
BIND time, DB2 stores the DBRM timestamp for
run-time use. At run-time, timestamp 'x', for the SQL
statement being processed, is compared with timestamp
'y' derived from the DBRM 'z' at BIND time. If the two
timestamps do not match, the DBRM and the
Chapter 2. SQL Return Codes 107
-819 • -842
application program were not the result of the same SQLSTATE: 58004
precompile.
This problem can occur if you: -822 THE SQLDA CONTAINS AN INVALID
v Precompile, compile, and link, without doing a BIND DATA ADDRESS OR INDICATOR
of the application, VARIABLE ADDRESS
v Precompile and BIND, without doing the compile and
Explanation: The application program has placed an
link for the application program, or
invalid address in the SQLDA.
v BIND the application using a DBRM that resulted
from a different precompile of the application program System Action: The statement cannot be executed.
than that which produced the object module that is
linked into the application module. Programmer Response: Correct the application
program such that valid addresses are placed in
SQLDA.
The timestamps 'x' and 'y' are DB2 internal timestamps.
They do not have an external interpretation. SQLSTATE: 51004
System Action: The statement cannot be executed.
-840 TOO MANY ITEMS RETURNED IN A
Programmer Response: BIND the application again,
SELECT OR INSERT LIST
using the DBRM for the application program that
matches the object module. Explanation: The number of items returned in the
select list or presented in an insert list exceeds the
SQLSTATE: 51003
allowable maximum of 750.
System Action: The statement cannot be executed.
-819 THE VIEW CANNOT BE PROCESSED
BECAUSE THE LENGTH OF ITS PARSE Programmer Response: Determine whether all the
TREE IN THE CATALOG IS ZERO information is actually needed. (Note that the number of
items returned by the select list * in the SQL statement
Explanation: SYSIBM.SYSVTREE.VTREE is a
SELECT * FROM A, B, C is the sum of the number of
varying-length string column that contains the parse
columns in all three tables.) If not, rewrite the SQL
trees of views. In processing a view, the length control
statement so that only the necessary items of
field of its parse tree was found to be zero.
information are returned. If so, break the SQL statement
System Action: The statement cannot be executed. up into two or more statements, as required.
Programmer Response: This is a system error. If you SQLSTATE: 54004
suspect an error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on
-842 A CONNECTION TO location-name
identifying and reporting the problem.
ALREADY EXISTS
SQLSTATE: 58004
Explanation: One of the following situations occurred:
v A CONNECT statement identifies a location with
-820 THE SQL STATEMENT CANNOT BE which the application process has a private
PROCESSED BECAUSE catalog-table connection, using system-directed access.
CONTAINS A VALUE THAT IS NOT
v SQLRULES(STD) is in effect and a CONNECT
VALID IN THIS RELEASE
statement identifies an existing SQL connection.
Explanation: A column of the indicated catalog table v A private connection, using system-directed access,
contains a value that prevents further processing of an cannot be established because of an existing SQL
SQL statement. The meaning of the value is unknown to connection to that location.
the release of DB2. If a fall back has occurred, the
| v A CONNECT (type 2) request that includes the
value is probably the result of the use of new function
prior to the fall back.
| USER/USING clause identifies an existing SQL
| connection.
System Action: The statement cannot be executed.
System Action: The statement cannot be executed.
Programmer Response: Verify that the statement
Programmer Response: The correction depends on
refers to the intended tables or views and that the
the error, as follows:
problem is the result of a fall back. If this is the case,
the statement cannot be corrected because it depends v If the location name is not the intended name, correct
on a function that is not supported in the current it.
release. If the problem is not the result of a fallback, v If SQLRULES(STD) is in effect and the CONNECT
-820 is a system error. If you suspect an error in DB2, statement identifies an existing SQL connection,
refer to Part 2 of DB2 Diagnosis Guide and Reference replace the CONNECT with SET CONNECTION or
for information on identifying and reporting the problem. change the option to SQLRULES(DB2).
108 DB2 UDB for OS/390 and z/OS: Messages and Codes
-843 • -870
v If the CONNECT statement identifies an existing | v The data type of the associated column was not one
private connection, destroy that connection (by using | of the allowed data types for an identity column. The
the RELEASE statement in a previous unit of work) | allowed data types are the following:
before executing the CONNECT statement. If the | – INTEGER
SQL statements following the CONNECT can be
executed using system-directed access, an
| – SMALLINT
alternative solution is to change the application to use | – DECIMAL with a scale of zero
that method. | v An invalid value was specified for INCREMENT BY.
v If system-directed access cannot be used, destroy | This value can be any positive or negative value that
the conflicting SQL connection (by using the | could be assigned to this column, but it must be
RELEASE statement in a previous unit of work) | within the range defined for the INTEGER type and
before executing the SQL statement that requires | can not be 0.
system-directed access. An alternative solution is to | v An invalid value was specified for MINVALUE and/or
change the application so that only | MAXVALUE. MINVALUE must be less than
application-directed access is used. | MAXVALUE.
| v Destroy the connection (by using the RELEASE | v The CREATE TABLE statement cannot specify an
| statement in a previous unik of work) before | EDITPROC for a table that has an identity column.
| executing the CONNECT statement which includes | v The ALTER TABLE statement cannot define an
| the USER/USING clause. | identity column on a global temporary table.
| v The CREATE TABLE LIKE statement cannot create a
Correct the error in the application, rebind the plan or
package, and resubmit the job.
| table with an edit procedure like another table that
| has an identity column.
SQLSTATE: 08002
| System Action: DB2 cannot process the statement.
-843 THE SET CONNECTION OR RELEASE
| Programmer Response: Correct the syntax and
STATEMENT MUST SPECIFY AN
| resubmit the statement.
EXISTING CONNECTION | SQLSTATE: 42815
Explanation: One of the following rules was violated:
v A SET CONNECTION statement must identify an | -867 INVALID SPECIFICATION OF A ROWID
existing SQL connection of the application process. | COLUMN
v A RELEASE statement must identify an existing | Explanation: For an ALTER or CREATE TABLE
connection of the application process. | statement, the specification of a ROWID column might
System Action: The statement cannot be executed.
| be invalid for one of the following reasons:
| v A ROWID column can not be added to a temporary
Programmer Response: The correction depends on | table.
the error, as follows:
| v The referential-constraint clause can not specify a
v If the location name is not the intended name, correct | ROWID column as a column of a foreign key.
it.
| v A ROWID column can not be a column of a primary
v If the location name does not identify an existing SQL | key.
connection, replace the SET CONNECTION with a
| v A ROWID column can not be a column in a table with
CONNECT statement.
| an EDITPROC.
v If RELEASE CURRENT was executed in the
unconnected state or the specified location name | System Action: The statement cannot be executed.
does not identify an existing SQL or DB2 private | Programmer Response: Correct the syntax and
connection, delete the RELEASE statement. | resubmit the statement.
Correct the error in the application, rebind, the plan and | SQLSTATE: 428C7
resubmit the job.
SQLSTATE: 08003 -870 THE NUMBER OF HOST VARIABLES IN
THE STATEMENT IS NOT EQUAL TO
THE NUMBER OF DESCRIPTORS
| -846 INVALID SPECIFICATION OF AN
| IDENTITY COLUMN Explanation: The number of host variables in the SQL
statement does not match the number of host variable
| Explanation: For an ALTER or CREATE TABLE descriptors.
| statement, the specification of an identity column may
| be invalid for one of the following reasons: System Action: The statement cannot be executed.
Chapter 2. SQL Return Codes 109
-872 • -877
Programmer Response: Correct the application | the table space which contains the table.
program. The most likely cause of this problem is a
System Action: The statement cannot be executed.
missing colon before a host variable.
Programmer Response: Correct the SQL statement.
Problem Determination: If the SQL statement is
bound locally, descriptors are built by the DB2 SQLSTATE: 53091
precompiler. For a remote SQL statement, descriptors
are built by DDF and are passed in the array
SQLSTTVRB. -875 operand CANNOT BE USED WITH THE
ASCII DATA REFERENCED
SQLSTATE: 58026
Explanation: ASCII data was referenced in one of the
following situations:
-872 A VALID CCSID HAS NOT YET BEEN v A LIKE predicate refers to a mixed data column in an
SPECIFIED FOR THIS SUBSYSTEM ASCII table. The LIKE predicate is not supported for
Explanation: A valid CCSID was not specified on mixed ASCII data.
either the ASCII CODED CHAR SET, EBCDIC CODED v A VARGRAPHIC function was specified for a column
CHAR SET, or UNICODE CODED CHAR SET in an ASCII table. The VARGRAPHIC function is not
subsystem parameter on installation panel DSNTIPF. supported for ASCII data.
System Action: The statement cannot be executed. System Action: The statement cannot be executed.
Programmer Response: Contact your system Programmer Response: Correct the SQL statement.
administrator to have the necessary CCSID defined for
your system. SQLSTATE: 42988
SQLSTATE: 51032
-876 'object' CANNOT BE CREATED,
REASON 'reason'
| -873 DATA ENCODED WITH DIFFERENT
| CCSIDS CANNOT BE REFERENCED IN Explanation: The object cannot be created in the SQL
| THE SAME SQL STATEMENT statement.
| Explanation: You cannot refer to a column defined in Possible values for 'object':
| a table in one encoding scheme in the same SQL TYPE 1 INDEX
| statement as a column defined in a table of another The object being created is a type 1 index.
| encoding scheme. INDEX The object being created is an index.
| This situation can occur when a table created in either Possible values for 'reason':
| the ASCII, EBCDIC, or UNICODE encoding schemes is
| referenced in a statement with a table that is not in the TABLE DEFINED AS ASCII
| same encoding scheme. The underlying table is defined as ASCII. Only
type 2 indexes are supported for ASCII tables.
This situation can also occur when a table is created; a
DECP CCSID value is changed; another table is PIECESIZE IS NOT VALID
created, and then the two tables are referenced in a PIECESIZE is only valid for non-partitioned
single SQL statement. indexes.
System Action: The statement cannot be executed. PIECESIZE 4GB IS NOT VALID
PIECESIZE 4GB is only valid for
Programmer Response: Correct the SQL statement. non-partitioned indexes on LARGE tables.
SQLSTATE: 53090 System Action: The statement cannot be executed.
Programmer Response: Correct the SQL statement
| -874 THE ENCODING SCHEME SPECIFIED for the object being created.
| FOR THE TABLE IS NOT THE SAME AS
| THAT USED FOR THE TABLE SPACE SQLSTATE: 53092
| CONTAINING THIS TABLE
| Explanation: If CCSID ASCII was specified, then the | -877 CCSID ASCII OR CCSID UNICODE IS
| containing table space is EBCDIC or UNICODE. If | NOT ALLOWED FOR THIS DATABASE
| CCSID EBCDIC was specified, then the containing table | OR TABLE SPACE
| space is ASCII or UNICODE. If CCSID UNICODE was Explanation: The database or table space specified is
| specified, then the containing table space is ASCII or required to be in EBCDIC.
| EBCDIC.
System Action: The statement cannot be executed.
| The encoding scheme of a table must be the same as
110 DB2 UDB for OS/390 and z/OS: Messages and Codes
-878 • -882
| Programmer Response: Remove the CCSID ASCII or | System Action: The statement cannot be processed.
| CCSID UNICODE clause from the statement.
| Programmer Response: Contact your system
SQLSTATE: 53093 | administrator to properly setup the installation options,
| or change the data types of the elements in columns in
| your CREATE or ALTER statement.
| -878 THE PLAN_TABLE USED FOR
| EXPLAIN CANNOT BE ASCII OR SQLSTATE: 53095
| UNICODE
Explanation: PLAN_TABLEs must be encoded in -880 SAVEPOINT savepoint-name DOES NOT
EBCDIC for use with EXPLAIN. EXIST OR IS INVALID IN THIS
CONTEXT
System Action: The statement cannot be executed.
Explanation: The RELEASE TO SAVEPOINT or
Programmer Response: Drop the existing
ROLLBACK TO SAVEPOINT statement does not
PLAN_TABLE, and recreate it with the EBCDIC
identify a savepoint that exists.
encoding scheme.
System Action: DB2 does not process the statement.
SQLSTATE: 53094
Programmer Response: Correct the statement to use
a valid savepoint name.
| -879 CREATE or ALTER STATEMENT FOR
| obj-name CANNOT DEFINE A COLUMN, SQLSTATE: 3B001
| DISTINCT TYPE, FUNCTION OR
| STORED PROCEDURE PARAMETER
-881 A SAVEPOINT WITH NAME
| AS MIXED OR GRAPHIC WITH
savepoint-name ALREADY EXISTS, BUT
| ENCODING SCHEME encoding-scheme
THIS SAVEPOINT NAME CANNOT BE
| Explanation: A CREATE or ALTER TABLE statement REUSED
| for object-name attempted to define a column, distinct
Explanation: The SAVEPOINT statement uses the
| type, or parameter of a user-defined function or stored
same savepoint name as another savepoint, and it
| procedure as mixed data or graphic when the system
cannot be created because at least one of the
| does not have an appropriate CCSID defined for the
savepoints was defined with the UNIQUE clause to
| encoding-scheme encoding scheme.
indicate that the name cannot be reused within the
| v A CREATE, with CCSID UNICODE clause specified, transaction.
| cannot be processed because the proper level of
| OS/390 is not installed. Refer to the Program System Action: The statement is not executed and a
| Directory for information on the level of OS/390 new savepoint is not set. The old savepoint still exists.
| required for UNICODE support. Programmer Response: Correct the statement. Either
| v A CREATE DISTINCT TYPE statement cannot define use a different savepoint name, or omit the UNIQUE
| a distinct type, on EBCDIC or ASCII data, with a clause if the other savepoint was created without the
| source type of CHAR FOR MIXED DATA, or UNIQUE clause and your intention is to reuse that
| GRAPHIC, VARGRAPHIC, or DBCLOB, when the savepoint name.
| MIXED DATA install option is set to NO.
SQLSTATE: 3B501
| v A CREATE FUNCTION or CREATE PROCEDURE
| statement cannot define a parameter or specify a
| RETURNS data type, for ASCII or EBCDIC data, as -882 SAVEPOINT DOES NOT EXIST
| CHAR FOR MIXED DATA, or GRAPHIC,
Explanation: A ROLLBACK TO SAVEPOINT
| VARGRAPHIC, or DBCLOB, when the MIXED DATA
statement was specified without a savepoint name to
| install option is set to NO.
rollback to the last active savepoint, but no savepoint
exists.
| Note: This error only occurs when the encoding
| scheme in use is EBCDIC or ASCII. The MIXED System Action: The statement is not executed.
| DATA install option does not affect Unicode data.
Programmer Response: Correct the application logic
to either set a savepoint or to not attempt to rollback to
| Note: This error can occur when there is an attempt to a savepoint.
| define a column or parameter as character FOR
| MIXED DATA even though the keywords FOR SQLSTATE: 3B502
| MIXED DATA do not appear in the failing
| statement. This occurs when the MIXED value in
| DECP is YES, in this case the default subtype
| for the character types is FOR MIXED DATA.
Chapter 2. SQL Return Codes 111
-900 • -905
Even if an abend occurred, an application program
-900 THE SQL STATEMENT CANNOT BE
receiving this return code can retry and is not prohibited
EXECUTED BECAUSE THE
from executing further SQL statements.
APPLICATION PROCESS IS NOT
CONNECTED TO AN APPLICATION SQLSTATE: 58004
SERVER
Explanation: A previous failure has placed the -902 POINTER TO THE ESSENTIAL
application process in the unconnected state. The only CONTROL BLOCK (CT/RDA) HAS
SQL statements that can be successfully executed from VALUE 0, REBIND REQUIRED
the unconnected state are CONNECT, COMMIT,
ROLLBACK, and local SET statements. Explanation: Pointer to the essential control block,
either the CT or the RDA is zeroes. This precludes the
System Action: The statement cannot be executed. successful execution of the current SQL statement, as
well as any subsequent SQL statements.
Programmer Response: It is possible that no
response is required because checking for -900 is one System Action: The statement cannot be executed.
way of detecting the unconnected state. If this is not the The application program is not permitted to issue
case, the logic of the application program must be additional SQL statements. For example, a recovery
changed. For additional information, see the description routine associated with the application program may not
of the CONNECT statement in Chapter 5 of DB2 SQL issue additional SQL statements.
Reference .
Programmer Response: Rebind the failing application
SQLSTATE: 08003 program and try again. If the problem persists, examine
your DBRM and make sure it matches your program.
-901 UNSUCCESSFUL EXECUTION CAUSED SQLSTATE: 58005
BY A SYSTEM ERROR THAT DOES
NOT PRECLUDE THE SUCCESSFUL
EXECUTION OF SUBSEQUENT SQL -904 UNSUCCESSFUL EXECUTION CAUSED
STATEMENTS BY AN UNAVAILABLE RESOURCE.
REASON reason-code, TYPE OF
Explanation: A system error occurred that prevented RESOURCE resource-type, AND
successful execution of the current SQL statement. RESOURCE NAME resource-name
However, the error does not prevent successful
execution of further SQL statements. Explanation: The SQL statement could not be
executed because resource 'resource-name' of type
The error might occur if the length of the SQL statement 'resource-type' was not available at the time for the
is less than 0, or is greater than the DB2 maximum reason indicated by 'reason-code'. Refer to Table 3 in
length for a statement. “Appendix B. Problem determination” on page 1281 for
an explanation of resource type codes. Refer to “Part 4.
This SQLCODE might also occur when distributed
DB2 Codes” on page 707 for an explanation of the
commit processing encounters an error. In this case, all
given reason code.
servers in the unit of work that support distributed
two-phase commit backed out the unit of work. If a System Action: The SQL statement cannot be
server that does not support distributed two-phase executed. If the SQL statement being executed was a
commit has updates in the unit of work, that server must cursor FETCH, DB2 closes the cursor. Subsequent
be queried to determine if its updates were committed attempts to use that cursor without first doing an OPEN
or backed out. for it receive an SQLCODE -501.
Finally, this error might occur during commit if Programmer Response: Verify the identity of the
post-processing cannot be completed because of an resource that was not available. To determine why the
update that changes the partition of a row. Resource resource was unavailable, refer to the specified
unavailable problems can prevent the post-processing 'reason-code'.
from completing. The existence of held cursors can
prevent the post-processing from completing. Commit is SQLSTATE: 57011
failed. The transaction is aborted.
System Action: The statement cannot be executed. A -905 UNSUCCESSFUL EXECUTION DUE TO
X'04E' abend might be requested for the application. RESOURCE LIMIT BEING EXCEEDED,
The application program can have a recovery routine to RESOURCE NAME = resource-name
recover from such an abend and can retry SQL LIMIT = limit-amount1 CPU SECONDS
statements. (limit-amount2 SERVICE UNITS)
DERIVED FROM limit-source
Programmer Response: If an abend occurred, notify
the system programmer for analysis of the abend that Explanation: The execution of the SQL statement was
caused this return code. terminated because a resource limit was exceeded.
112 DB2 UDB for OS/390 and z/OS: Messages and Codes
-906 • -909
resource-name System Action: The statement cannot be executed.
The name of the resource whose limit was
Programmer Response: In general, an application
exceeded. It is also the name of the column in
program should terminate upon receipt of this return
the DB2 table from which the limit was derived.
code. All subsequent attempts by the application to
The resource-name can be ASUTIME, which is
execute other SQL statements will also fail with the
the number of CPU seconds permitted for each
same return code. In the case of a DB2 CICS
SQL statement.
transaction, if the SQLERRP field in the SQLCA
limit-amount1 contains the module name DSNCEXT1, the transaction
The maximum number of CPU seconds may issue a SYNCPOINT ROLLBACK and continue
permitted processing. If the transactions chooses to ROLLBACK
and continue processing, it must be capable of
limit-amount2
correcting the situation that caused the create thread
The maximum number in service units
error to occur originally.
permitted
SQLSTATE: 51005
limit-source
The source used to derive the limit-amount: the
name of a resource limit specification table, a -908 bind-type ERROR USING auth-id
system parameter, or the AUTHORITY. BIND, REBIND OR
SYSIBM.SYSROUTINES catalog table. If the AUTO-REBIND OPERATION IS NOT
source is a system parameter, the resource ALLOWED
limit specification table did not contain an
Explanation: For BIND and REBIND, the indicated
applicable entry or an error occurred while
authorization ID is not allowed to perform the indicated
accessing the table.
bind-type against a plan or package. An entry in the
System Action: If the limit-source was a resource limit resource limit specification table (RLST) prohibits
specification table or a system parameter, the execution binding and rebinding by this authorization ID, or all
of this SQL statement is terminated. A record containing authorization IDs. For AUTO-REBIND, the system
more detailed information about this failure is generated. parameter controlling AUTO-REBIND operations is set
If an SQL cursor is associated with the failed instruction, to disallow AUTO-REBIND.
its position is unchanged and a CLOSE or PREPARE
bind-type
command can be issued. If any other operation is
Type of bind operation (BIND, REBIND or
attempted with the cursor, it cannot be executed and
AUTO-REBIND).
SQLCODE -905 is returned. If there is no cursor, this
statement was rolled back. auth-id Authorization ID of the invoker of the BIND
subcommand or primary authorization ID of the
Programmer Response: Determine why this SQL
invoker of the plan for AUTO-REBIND
statement or stored procedure took so long and take
operations.
appropriate action. Consider simplifying the SQL
statement, restructuring tables and indexes, or System Action: The plan or package is not bound.
contacting the installation group responsible for
maintaining the resource limit specification tables. System Programmer Response: If the indicated
authorization id should be allowed to bind, change the
If the limit-source was a resource limit specification entry in the active RLST table. If AUTO-REBIND
table or a system parameter, the application program operations are disabled, rebind the package before
that receives this return code can execute additional reexecuting the package.
SQL statements.
SQLSTATE: 23510
SQLSTATE: 57014
-909 THE OBJECT HAS BEEN DELETED
-906 THE SQL STATEMENT CANNOT BE
EXECUTED BECAUSE THIS FUNCTION Explanation: The application program has either:
IS DISABLED DUE TO A PRIOR ERROR 1. Dropped a table and then attempted to accesss it.
Explanation: Execution of the SQL statement failed 2. Dropped an index and then tried to access its object
because the requested function had been disabled by a table using that index.
prior error. This situation can arise if the application System Action: The statement cannot be executed.
program has intercepted an abend (for instance, by an
ON ERROR condition in a PL/I program) and continued System Programmer Response: The logic of the
to execute SQL statements. This situation may also application program must be corrected such that it does
arise if a DB2 CICS transaction encountered a create not attempt to access or use an object after it has been
thread error yet continued to issue SQL requests dropped.
without issuing a SYNCPOINT ROLLBACK first. Dropping indexes within an application program is
Chapter 2. SQL Return Codes 113
-910 • -913
especially hazardous, because there is no way of v 00C9008E - timeout
determining whether or not the plan that has been
The changes associated with the unit of work must be
generated for the application (by BIND or REBIND)
entered again.
actually uses a particular index for access to its object
table.If the indicated authorization id should be allowed System Action: The statement cannot be executed.
to bind, change the entry in the active RLST table. If The application is rolled back to the previous COMMIT.
AUTO-REBIND operations are disabled, rebind the
package before reexecuting the package. Programmer Response: A long-running application,
or an application that is likely to encounter a deadlock,
SQLSTATE: 57007 should (if possible) issue frequent COMMIT commands.
This can lessen the possibility of a deadlock occurring.
See message DSNT376I for other possible ways to
-910 THE SQL STATEMENT CANNOT
avoid future deadlocks or timeouts. On receipt of the
ACCESS AN OBJECT ON WHICH A
SQLCODE -911, the application should, in general,
DROP OR ALTER IS PENDING
terminate.
Explanation: The application program has issued a
For more information about how IMS, CICS, and TSO
DROP or ALTER against an object, and then attempted
handle deadlocks, see Part 4 of DB2 Application
to access that object before the DROP or ALTER is
Programming and SQL Guide.
completed.
SQLSTATE: 40001
System Action: The statement cannot be executed.
Programmer Response: In the case of ALTER, the
-913 UNSUCCESSFUL EXECUTION CAUSED
logic of the application program must be modified so
BY DEADLOCK OR TIMEOUT. REASON
that a COMMIT (or the IMS or CICS equivalent) is
CODE reason-code, TYPE OF
executed between the ALTER and the failing SQL
RESOURCE resource-type, AND
statement.
RESOURCE NAME resource-name
For DROP, the logic of the application program should
Explanation: The application was the victim in a
be modified such that there is no attempt to access an
deadlock or experienced a timeout. The reason code
object after the DROP has been executed.
indicates whether a deadlock or timeout occurred.
Note that DROP includes the case when rollback to a
Refer to message DSNT500I under “Chapter 17.
savepoint includes rolling back to a CREATE.
DSNT... Messages” on page 375 for an explanation of
SQLSTATE: 57007 'resource-type' and 'resource-name'. Refer to Table 3 in
“Appendix B. Problem determination” on page 1281 for
an explanation of resource type codes.
-911 THE CURRENT UNIT OF WORK HAS
BEEN ROLLED BACK DUE TO System Action: The SQL statement cannot be
DEADLOCK OR TIMEOUT. REASON executed. If the SQL statement being executed was a
reason-code, TYPE OF RESOURCE cursor FETCH, DB2 closes the cursor.
resource-type, AND RESOURCE NAME
SQLERRD(3) also contains the reason-code which
resource-name
indicates whether a deadlock or timeout occurred. The
Explanation: The current unit of work was the victim most common reason codes are:
in a deadlock, or experienced a timeout, and had to be v 00C90088 - deadlock
rolled back.
v 00C9008E - timeout
The reason code indicated whether a deadlock or
Programmer Response: The application should either
timeout occurred. Refer to message DSNT500I under
commit or roll back to the previous COMMIT. Then,
“Chapter 17. DSNT... Messages” on page 375 for an
generally, the application should terminate. See
explanation of 'resource-type' and 'resource-name'.
message DSNT376I for possible ways to avoid future
Refer to Table 3 in “Appendix B. Problem determination”
deadlocks or timeouts.
on page 1281 for an explanation of resource type
codes. For more information about how CICS and TSO handle
deadlocks, see Part 4 of DB2 Application Programming
Note: The changes associated with the unit of work and SQL Guide.
must be entered again.
SQLSTATE: 57033
SQLERRD(3) also contains the reason-code which
indicates whether a deadlock or timeout occurred. The
most common reason codes are:
v 00C90088 - deadlock
114 DB2 UDB for OS/390 and z/OS: Messages and Codes
-917 • -922
The unit of work must be terminated by a rollback
-917 BIND PACKAGE FAILED
operation because the update made (but not
Explanation: An error has occurred which prevents committed) at the application server cannot be
the package from being created. This SQLCODE can committed consistently with other current or future
be issued during bind or commit processing. updates made to this distributed unit of work.
System Action: The bind fails and the package is not v An abend occurred during the execution of a stored
created. If issued during commit processing, all changes procedure, or a restricted SQL statement was issued
to the database are rolled back. If issued during bind from a stored procedure.
processing, only package creation fails. Other changes v An abend occurred during the execution of a function,
within the logical unit of work are committable. or a restricted SQL statement was issued from a
function.
Programmer Response: Correct the cause of the
problem and try again. System Action: In the IMS and CICS environments,
all SQL statements are rejected until the rollback
Problem Determination: Inspect the SQLCODES
occurs. In the other environments, all SQL statements
issued for the SQL statements of the package.
other than a static ROLLBACK are rejected until a static
SQLSTATE: 42969 ROLLBACK is executed.
Programmer Response: Correct the application,
-918 THE SQL STATEMENT CANNOT BE function, or stored procedure, rebind it, and resubmit the
EXECUTED BECAUSE A CONNECTION job.
HAS BEEN LOST
SQLERRP contains the name of the module that
Explanation: Execution of the SQL statement failed detected the previous failure and placed the application
because a communications link between the local DB2 in the must-abort state.
and at least one remote server no longer exists. A
SQLSTATE: 56045
previous failure caused this condition.
System Action: In the IMS and CICS environments,
-922 AUTHORIZATION FAILURE: error-type
all SQL statements are rejected until the rollback
ERROR. REASON reason-code
occurs. In the other environments, all SQL statements
other than a static ROLLBACK are rejected until a static Explanation: Authorization failed because of the error
ROLLBACK is executed. indicated by error-type
Programmer Response: In general, an application error-type
program should issue a static ROLLBACK. Attempts by Types of authorization failure
the application to issue SQL statements other than v User authorization
static ROLLBACK might fail. Once the static v Plan access
ROLLBACK is issued, the application can resume v Duplicate exit requested
execution. v Installation error
v Connect
SQLERRP contains the name of the module that
detected the previous failure and placed the application reason-code
in the must-abort state. DB2 reason code associated with authorization
failure
SQLSTATE: 51021
System Action: The statement cannot be processed.
The connection to DB2 is not established.
-919 A ROLLBACK OPERATION IS
REQUIRED Programmer Response: If error-type is user
authorization:, the authorization-ID specified to DB2
Explanation: The unit of work was placed in a state
through your attachment facility is not valid for DB2.
where a rollback operation is required. This can happen
See your system programmer or your CICS, IMS, or
for the following reasons:
TSO system administrator.
v An SQL statement updated a distributed database
server, but the database server can be used only for If error-type is plan access, then the authorization ID
read-only operations. Either updates are currently associated with this connection is not authorized to use
restricted to servers that support distributed the specified plan name or the specified plan name
two-phase commit and this application server does does not exist. See your system administrator.
not support distributed two-phase commit, or updates If error-type is duplicate exit, then you requested a
are restricted to a single server that does not support duplicate exit.
distributed two-phase commit and this application
server is not that server. If error-type is installation error, a connection or sign-on
exit denied your request. See your system programmer.
Chapter 2. SQL Return Codes 115
-923 • -925
If error-type is Connect, an SQL CONNECT request If the condition is ″CICS entry disabled″, then NAME
failed to connect to the local DB2 with USER/USING indicates the entry that is disabled.
specified. See the reason code for a description of the
System Action: The statement cannot be executed.
failure. The application program has been palced in the
The connection to DB2 is not established.
connectable and unconneted state. The only SQL
statements that can be successfully completed in this Programmer Response: If the connection failed
state are CONNET, COMMIT, ROLLBACK, and local because either DB2 or a required database, table
SET statements. Any attempt to execute other SQL space, table, or index was unavailable, wait until it is
statements will result in an error (SQLCODE -900). available before invoking the application again.
Look up the reason code in “Part 4. DB2 Codes” on If allocation failed for an application plan, REBIND the
page 707 for further information. plan to determine the problem. Error messages are
produced explaining why the plan could not be
Any attempts to issue SQL statements following the
allocated.
-922 SQLCODE when error-type is not Connect causes
unpredictable results. For other types of allocation errors, installation action
might be required to correct the problem.
SQLSTATE: 42505
For CICS attachment failures, resolve the primary cause
as noted by the reason code. Then restart the
-923 CONNECTION NOT ESTABLISHED:
attachment.
DB2 condition REASON reason-code,
TYPE resource-type, NAME Problem Determination: The reason-code,
resource-name resource-type, and resource-name might not be
available. If they are not available, nothing appears. If
Explanation: The connection to DB2 failed for the
they are available, refer to Part 4. DB2 Codes for an
reason indicated by condition, which can be any of the
explanation of the reason-code, resource-type, and
following:
resource-name.
v DB2 not up
v DB2 not operational Refer to message DSNT500I under Chapter 17. DSNT...
v DB2 shutdown in progress Messages for an explanation of resource type and
v DB2 restricted access mode resource name. Refer to Table 3 in “Appendix B.
v Allocation error Problem determination” on page 1281 for an explanation
v DB2 - CICS attachment not up of resource type codes. Any attempts to issue SQL
v DB2 - CICS ENTRY disabled statements after receiving SQLCODE -923 will cause
v The object is dependent on facilities of a release of unpredictable results.
DB2 that is newer than the release that you are
currently running (fall back). SQLSTATE: 57015
Possible causes of an allocation error are: -924 DB2 CONNECTION INTERNAL ERROR,
v The application plan does not exist. function-code, return-code, reason-code
v The application plan is inoperative. An explicit Explanation: Connection to DB2 has failed because of
REBIND or BIND is required. an unexpected internal error, identified by the
v The application plan is invalid. Underlying resources 'reason-code'.
have changed. System Action: The statement cannot be executed.
v A required database, table space, table, or index is The connection to DB2 is not established.
unavailable.
Programmer Response: Look up the abend
v Data set allocation failed for a required data set. 'reason-code' in Part 4. DB2 Codes for further
v There is insufficient virtual storage. information. The requested 'function-code' and
v The application is trying to execute the plan from a 'return-code' may provide additional information. Any
system (environment) that was restricted when the attempts to issue SQL statements following the
plan was bound or rebound. Check the SQLCODE -924 will cause unpredictable results.
SYSPLSYSTEM table to determine from which SQLSTATE: 58006
systems (for example, IMS or CICS) the plan can be
executed.
-925 COMMIT NOT VALID IN IMS, CICS OR
If the condition is ″CICS attachment not up″, then RRSAF ENVIRONMENT
NAME indicates the DB2 subsystem that is not Explanation: An application executing in either an IMS
available. The reason code indicates the reason the or CICS environment or an application executing in an
attachment is not available. RRSAF environment when DB2 is not the only resource
manager has attempted to execute a COMMIT
116 DB2 UDB for OS/390 and z/OS: Messages and Codes
-926 • -939
statement. The SQL COMMIT statement cannot be The DYNAM option can result in the incorrect language
executed in these environments. interface module being loaded at runtime.
System Action: The statement cannot be executed. SQLSTATE: 51006
No commit is performed.
Programmer Response: The IMS, CICS or RRS -929 FAILURE IN A DATA CAPTURE EXIT:
protocols should be used to commit work in these token
environments.
Explanation: 'token' is an information string provided
If a stored procedure is being called from IMS or CICS, by DPROP’s exit routine which captures data changes
ensure that the stored procedure is not defined to in tables defined with DATA CAPTURE CHANGES.
perform a commit on return.
System Action: The information string is placed in in
SQLSTATE: 2D521 the SQLERRM area of the SQLCA.
System Programmer Response: For documentation
-926 ROLLBACK NOT VALID IN IMS, CICS of the actions associated with this SQLCODE, refer to
OR RRSAF ENVIRONMENT the Data Propagator (DPROP) publications.
Explanation: An application executing in either an IMS SQLSTATE: 58002
or CICS environment or an application executing in an
RRSAF environment when DB2 is not the only resource
-939 ROLLBACK REQUIRED DUE TO
manager has has attempted to execute a ROLLBACK
UNREQUESTED ROLLBACK OF A
statement. The SQL ROLLBACK statement cannot be
REMOTE SERVER
executed in these environments.
Explanation: A dynamic commit was executed
System Action: The statement cannot be executed.
preceding the execution of this request. The remote
No roll back is performed.
server to which the application was CONNECTed during
Programmer Response: The IMS, CICS or RRS the dynamic COMMIT successfully committed. However,
protocols should be used to rollback work in these at least one other remote server (which was read-only)
environments. rolled back its portion of the distributed unit of work
during the dynamic commit.
SQLSTATE: 2D521
To ensure that an application that uses cursor-hold
cursors does not incorrectly assume cursor position is
-927 THE LANGUAGE INTERFACE (LI) WAS
being maintained at any remote server that rolled back,
CALLED WHEN THE CONNECTING
the application must perform a rollback operation.
ENVIRONMENT WAS NOT
ESTABLISHED. THE PROGRAM Communications are still established with all remote
SHOULD BE INVOKED UNDER THE servers.
DSN COMMAND
System Action: In the IMS and CICS environments,
Explanation: In the TSO environment, the user has all SQL statements are rejected until the rollback
attempted to execute an application program without occurs. In the other environments, all SQL statements
first establishing the correct execution environment by other than a static ROLLBACK are rejected until a static
issuing the DSN command. In the IMS, CICS, or call ROLLBACK is executed.
attachment facility (CAF) environment, the user has
Programmer Response: Issue the appropriate
attempted to execute an application program that is not
(depending on the environment) request to cause a
using the correct language interface module.
rollback. Re-establish any cursor positioning and
System Action: The statement cannot be executed. continue the application with the first request that
received the -939 SQLCODE.
Programmer Response: In the TSO environment,
DB2 application programs should be invoked under the SQLERRP contains the name of the module that
RUN subcommand of the DSN command processor. In detected the previous failure and placed the application
the IMS, CICS or CAF environment check that the in the must-abort state.
application was link-edited with or is dynamically
SQLSTATE: 51021
allocating the correct language interface module. The
language interface modules required in each
environment are as follows:
v IMS: DFSLI000
v CICS: DSNCLI
v CAF: DSNALI
v TSO: DSNELI
Chapter 2. SQL Return Codes 117
-947 • -991
-947 THE SQL STATEMENT FAILED -950 THE LOCATION NAME SPECIFIED IN
BECAUSE IT WILL CHANGE A TABLE THE CONNECT STATEMENT IS
DEFINED WITH DATA CAPTURE INVALID OR NOT LISTED IN THE
CHANGES, BUT THE DATA CANNOT COMMUNICATIONS DATABASE
BE PROPAGATED
Explanation: One of the following conditions applies:
Explanation: The DPROP SUPPORT option on the v The location name is blank.
installation panel is set to 2 (support DPROP only). The
v The data type of the host variable is not character
SQL statement would have changed a table defined
string.
with DATA CAPTURE CHANGES. However, the data
cannot be propagated because the SQL statement did v The length attribute of the host variable is greater
not originate from an IMS subsystem, or monitor trace than 16.
class 6 was not active at the beginning of the unit of v The location name does not appear in the
work for that change. LOCATIONS column of the SYSIBM.LOCATIONS
table, nor is it the name of the local DB2 subsystem.
System Action: The statement is not executed.
System Action: The statement cannot be executed.
System Programmer Response: Take one of the
The application process is placed in the unconnected
following actions:
state.
v Change the installation option to 1 (no propagation)
or 3 (permit changes from any subsystem). Programmer Response: If the location name is
specified as the value of a host variable, ensure that the
v Change the application program that receives this
name is left justified in the host variable and, if
SQLCODE so that it can be run in an IMS
necessary, padded on the right with blanks. If this is not
subsystem, and activate monitor trace class 6.
the problem, either SYSIBM.LOCATIONS must be
updated to include the specified name, or the specified
If the installation option is changed to 3, SQL changes
name must be changed to match a name in
to tables defined with DATA CAPTURE CHANGES are
SYSIBM.LOCATIONS.
permitted from any subsystem, but they are not
propagated unless the environment is set up for SQLSTATE: 42705
propagation.
SQLSTATE: 56038 -981 THE SQL STATEMENT FAILED
BECAUSE THE RRSAF CONNECTION
IS NOT IN A STATE THAT ALLOWS
-948 DISTRIBUTED OPERATION IS INVALID
SQL OPERATIONS, REASON
Explanation: The unit of work was initiated before reason-code.
DDF was started, and the application attempted to
Explanation: The application attempted to execute an
perform a distributed operation. The unit of work must
SQL operation but the RRSAF connection was not in a
be terminated by a rollback operation.
state that allows the processing of SQL statements.
System Action: In the IMS and CICS environments,
System Action: The statement cannot be executed.
all SQL statements are rejected until a rollback occurs.
In the other environments, all SQL statements other Programmer Response: See reason-code in “Part 4.
than a static ROLLBACK are rejected until a static DB2 Codes” on page 707 for an explanation of the
ROLLBACK is executed. problem. Correct the error in the application, REBIND,
and run the application again.
Programmer Response: An application that performs
local database updates before DDF is started cannot SQLSTATE: 57015
perform distributed operations within the same unit of
work. The current unit of work must be terminated by a
-991 CALL ATTACH WAS UNABLE TO
rollback operation and a new unit of work must be
ESTABLISH AN IMPLICIT CONNECT
initiated before any SQL operations can be performed.
OR OPEN TO DB2. RC1= rc1 RC2= rc2
Restart the current unit of work.
Explanation: Call attach attempted to perform an
SQLSTATE: 56062 implicit connect and open as the result of an SQL
statement. The connect or open failed with the returned
values.
rc1 The value returned in FRBRC1 for the failed
CONNECT or OPEN request.
rc2 The value returned in FRBRC2 for the failed
CONNECT or OPEN request.
118 DB2 UDB for OS/390 and z/OS: Messages and Codes
-1760 • -20005
System Action: The statement cannot be executed.
| -5012 HOST VARIABLE host-variable IS NOT
Programmer Response: Verify that the application | EXACTLY NUMERIC WITH SCALE
intended to use the call attachment facility (CAF) as the | ZERO
mechanism to connect to DB2. For functions or stored
| Explanation: HOST VARIABLE host-variable was
procedures running in the WLM-established stored
| specified, but it is not valid in the context in which it was
procedure address space the application must be
| used. HOST VARIABLE host-variable was specified as
link-edited with or dynamically allocate the RRS
| part of ABSOLUTE or RELATIVE in a FETCH
attachment language interface module (DSNRLI), not
| statement. The host variable was not usable.
CAF.
| host-variable
SQLSTATE: 57015
| Name of the host variable containing the
| ABSOLUTE or RELATIVE value.
| -1760 CREATE PROCEDURE FOR
| System Action: The statement cannot be processed.
| procedure-name MUST HAVE VALID
| LANGUAGE AND EXTERNAL CLAUSES | Programmer Response: Change the host variable to
| be an exact numeric with a scale of zero.
| Explanation: A LANGUAGE or EXTERNAL clause is
| missing in the CREATE statement for procedure | SQLSTATE: 42618
| procedure-name. This clause must be specified.
| System Action: The statement cannot be executed. -20003 GBPCACHE NONE CANNOT BE
SPECIFIED FOR TABLESPACE OR
| Programmer Response: Change the CREATE INDEX IN GRECP
| statement to include the missing clause and reissue the
| statement. Explanation: GBPCACHE NONE was specified on an
ALTER TABLESPACE or ALTER INDEX statement, but
| SQLSTATE: 42601 the table space, index, or the partition to be altered is in
GRECP.
-2001 THE NUMBER OF HOST VARIABLE
System Action: The statement cannot be processed.
PARAMETERS FOR A STORED
PROCEDURE IS NOT EQUAL TO THE User Response: Use the START DATABASE
NUMBER OF EXPECTED HOST command to recover the table space or index from the
VARIABLE PARAMETERS. ACTUAL GRECP then STOP the table space or index before
NUMBER sqldanum, EXPECTED reissuing the ALTER statement.
NUMBER opnum
SQLSTATE: 560A7
Explanation: DB2 received an SQL CALL statement
for a stored procedure. However, the number of host
-20004 8K or 16K BUFFERPOOL PAGESIZE
variable parameters supplied on the CALL statement
INVALID FOR A WORKFILE OBJECT
does not match the expected number of host variable
parameters. Explanation: This message is issued when:
sqldanum v A CREATE or ALTER DATABASE statement for a
The number of host variable parameters as workfile database specifies an 8K or 16K pagesize in
determined by examining the SQLDA. the BUFFERPOOL clause.
v A CREATE or ALTER TABLESPACE statement for a
opnum The expected number of host variable
workfile database specifies an 8K or 16K pagesize in
parameters as determined by parsing the
the BUFFERPOOL clause.
statement.
System Action: The statement cannot be executed.
System Action: The statement cannot be executed.
User Response: Correct the statement to specify a 4K
Programmer Response: If the SQL CALL statement
or 32K bufferpool pagesize.
is coded incorrectly, modify the SQL application to
provide the correct number of parameters on the SQL SQLSTATE: 560A8
CALL statement.
SQLSTATE: 53089 | -20005 THE INTERNAL ID LIMIT OF limit HAS
| BEEN EXCEEDED FOR OBJECT TYPE
| object-type
| Explanation: An internal ID is used to uniquely identify
| objects of type object-type. The limit for internal IDs for
| this type of object is limit and this limit has been
| exceeded.
Chapter 2. SQL Return Codes 119
-20006 • -20072
| This could occur during a CREATE DISTINCT TYPE, a SQLSTATE: 53098
| CREATE FUNCTION, or a CREATE PROCEDURE
| statement. This could also occur during processing for a
-20071 WLM ENVIRONMENT NAME MUST BE
| CREATE TABLE or ALTER TABLE ADD COLUMN
| statement where a new identity column is created.
| SPECIFIED function-name
Explanation: The WLM ENVIRONMENT option was
| System Action: The SQL statement cannot be
not specified on CREATE FUNCTION, and there is no
| executed.
default WLM environment for the installation.
| SQLSTATE: 54035
System Action: The statement could not be
processed.
-20006 LOBS CANNOT BE SPECIFIED AS
Programmer Response: Select a WLM
PARAMETERS WHEN NO WLM
ENVIRONMENT name and include it in the CREATE
ENVIRONMENT IS SPECIFIED
FUNCTION statement. Contact your system
Explanation: On a CREATE PROCEDURE statement, administrator to find out the names of the WLM
one or more LOBs (or distinct types based on LOBs) environments that have been defined for your
were specified in the parameter list, and the NO WLM installation.
ENVIRONMENT option was also specified.
SQLSTATE: 53099
Option NO WLM ENVIRONMENT cannot be used with
LOBs in the parameter list for a stored procedure.
-20072 csect-name bind-type bind-subtype
System Action: The statement is not executed. ERROR USING auth-id AUTHORITY
OPERATION IS NOT ALLOWED ON A
Programmer Response: Either do not specify a LOB
TRIGGER PACKAGE package-name
as a parameter, or specify a WLM ENVIRONMENT
name rather than NO WLM ENVIRONMENT on your Explanation: The package specified is a trigger
CREATE PROCEDURE statement. package.The bind-type operation cannot be performed
against a trigger package using this statement or
SQLSTATE: 53097
subcommand.
csect-name
-20008 UNSUPPORTED OPTION keyword
Name of the CSECT that issued the message.
SPECIFIED
bind-type
Explanation: keyword is a deprecated feature that
Type of bind operation (BIND, REBIND, DROP,
was supported in releases prior to DB2 Version 7, and
or FREE).
is no longer supported.
bind-subtype
For indexes, only one type is currently supported —
Subtype of bind operation (COPY or blank).
type 2.
auth-id Authorization ID of the invoker of the BIND,
System Action: The statement cannot be executed.
REBIND or FREE subcommand or primary
Programmer Response: Correct the syntax of the authorization ID of the currently executing
SQL statement to remove reference to the unsupported process for a DROP statement.
keyword. Refer to the DB2 SQL Reference for more
package-name
information.
Name of the package in the following format:
SQLSTATE: 560A9 'collection.package'.
System Action: The plan or package is not bound,
-20070 AUXILIARY TABLE table-name CANNOT copied, or freed.
BE CREATED BECAUSE COLUMN
System Programmer Response: A trigger package
column-name IS NOT A LOB COLUMN
cannot be explicitly bound. A trigger package cannot be
Explanation: An auxiliary table cannot be created for copied. To rebind a trigger package locally, the REBIND
a non-LOB column. A CREATE AUXILIARY TABLE TRIGGER PACKAGE subcommand must be used. A
statement must refer to a LOB column in the associated trigger package cannot be rebound remotely. To drop a
base table. trigger package, the DROP TRIGGER statement must
be used.
System Action: The statement cannot be executed.
The specified table was not created. SQLSTATE: 56052
Programmer Response: Change the name of the
column to correctly refer to a LOB column in the base
table.
120 DB2 UDB for OS/390 and z/OS: Messages and Codes
-20073 • -20100
| ATTRIBUTES instead. For example:
-20073 THE FUNCTION function-name CANNOT
BE ALTERED BECAUSE IT IS | DECLARE GLOBAL TEMPORARY TABLE ....
| AS (SELECT * FROM view-name) DEFINITION ONLY
REFERENCED IN EXISTING VIEW | INCLUDING IDENTITY COLUMN ATTRIBUTES
DEFINITIONS
| SQLSTATE: 560AD
Explanation: The function-name in an ALTER
FUNCTION statement cannot be altered to NOT
-20092 A VIEW WAS SPECIFIED FOR LIKE
DETERMINISTIC or EXTERNAL ACTION. It is
BUT IT INCLUDES A ROWID COLUMN
referenced in one or more existing view definitions.
Explanation: The LIKE clause specified the name of a
System Action: The statement cannot be executed.
view that contains a ROWID column. This is not
Programmer Response: Drop the views that supported.
reference the function before issuing the ALTER
System Action: The statement is not executed.
FUNCTION statement.
| Programmer Response: Specify the name of a view
SQLSTATE: 42927
| that does not contain a ROWID column (or distinct type
| column for which the source type is ROWID), or specify
-20074 THE OBJECT object-name CANNOT BE | the name of a table and resubmit the statement.
CREATED BECAUSE THE FIRST
SQLSTATE: 560AE
THREE CHARACTERS ARE RESERVED
FOR SYSTEM OBJECTS
-20100 AN ERROR OCCURRED WHEN
Explanation: In general, SYS is a reserved prefix for
BINDING A TRIGGERED SQL
names. The only exceptions are:
STATEMENT. INFORMATION
v SYSPROC is a valid schema name for stored
RETURNED: SECTION NUMBER :
procedures.
section-number SQLCODE sqlerror,
v SYSADM is a valid schema name.
SQLSTATE sqlstate, AND MESSAGE
This condition is similar to the condition reported in TOKENS token-list
precompiler message DSNH794I.
Explanation: During execution of a CREATE
TRIGGER statement, the SQL statements specified in
This message is also issued if an attempt is made to the triggered action are bound into a trigger package.
grant the CREATEIN, ALTERIN or DROPIN privileges During that processing, an error was discovered in one
on a schema with the SYS prefix. The same exceptions of those statements.
apply to the grant.
section-number
System Action: The statement is not executed. The section number associated with the failing
Programmer Response: Select a name that does not triggered SQL statement. For triggers that
start with a reserved prefix. contain a WHEN clause, the WHEN clause is
section number one. The triggered SQL
SQLSTATE: 42939 statements are numbered sequentially,
beginning with section number two. This is true
| -20091 A VIEW NAME WAS SPECIFIED AFTER for triggers with or without a WHEN clause.
| LIKE IN ADDITION TO THE INCLUDING sqlcode
| IDENTITY COLUMN ATTRIBUTES The SQLCODE received when binding the
| CLAUSE statement.
| Explanation: The LIKE clause specified the name of a sqlstate
| view in combination with the INCLUDING IDENTITY The corresponding SQLSTATE for the
| COLUMN ATTRIBUTES clause. This usage is not SQLCODE received when binding the
| supported. statement.
| System Action: The statement is not executed. token-list
| Programmer Response: Remove the INCLUDING The list of tokens from the original SQL error.
| IDENTITY COLUMN ATTRIBUTES clause and resubmit This list might be truncated.
| the statement to copy the existing view definition without System Action: The CREATE TRIGGER statement
| the identity column attributes. was not processed. The trigger and the trigger package
| In the case of DECLARE GLOBAL TEMPORARY were not created.
| TABLE, it is possible to get the identity column Programmer Response: Use the section number
| attributes for a column of a view using the AS subselect determine the failing triggered SQL statement. Refer to
| clause with INCLUDING IDENTITY COLUMN the explanation of the reported SQLCODE. Follow the
Chapter 2. SQL Return Codes 121
-20101 • -20107
action suggested by that message. listed in the table. Altering the CCSID of a database or
table space to a value not listed in the table is not
SQLSTATE: 56059
permitted.
SQLSTATE: 42856
-20101 THE FUNCTION function FAILED WITH
REASON rc
-20106 THE CCSID FOR TABLE SPACE OR
Explanation: The statement attempted to execute a
DATABASE CANNOT BE CHANGED
function function. The statement failed, Reason Code rc
BECAUSE THE TABLE SPACE OR
Possible values for rc are: 00E73001, 00E73002, DATABASE ALREADY CONTAINS A
00E73003, and 00E73004. TABLE THAT IS REFERENCED IN
EXISTING VIEW DEFINITIONS
System Action: The statement cannot be executed.
Explanation: An ALTER statement cannot be used to
Programmer Response: Correct the condition alter the CCSID for a table space or database that
described by the DB2 reason code. contains a table that is referenced in existing view
SQLSTATE: 56060 definitions.
System Action: The statement cannot be executed.
-20102 CREATE OR ALTER STATEMENT FOR Programmer Response: To alter the CCSID for the
USER-DEFINED FUNCTION specified space, first drop any existing view definitions
function-name SPECIFIED THE option that refer to tables contained in the identified space and
OPTION WHICH IS NOT ALLOWED then reissue the ALTER statement.
FOR THE TYPE OF ROUTINE
SQLSTATE: 42945
Explanation: An option was specified that is not
allowed for the type of function being created or altered.
v MODIFIES SQL DATA is not allowed for table -20107 HOST VARIABLE OR PARAMETER
functions. NUMBER position-number CANNOT BE
v ALLOW PARALLEL is not allowed for table functions. USED AS SPECIFIED BECAUSE
v CARDINALITY is not allowed for non-table functions. REASON reason
v LANGUAGE SQL is not allowed for non-SQL
Explanation: DB2 received data that could not be
functions or procedures.
used as specified in the statement because it is not
v LANGUAGE specifying something other than SQL is
convertible to an acceptable format in this machine
not allowed for SQL functions or procedures.
environment.
v LANGUAGE JAVA is not allowed for table functions.
v PARAMETER STYLE JAVA is not allowed for table position-number identifies either the host variable
functions. number (if the message is issued as a result of an
INSERT, UPDATE, DELETE, SELECT, SET, or VALUES
System Action: The statement cannot be processed.
statement), or the parameter number (if the message is
Programmer Response: Remove the option from the issued as the result of a CALL statement, or the
statement and reissue the failing statement. invocation of a function).
SQLSTATE: 42849 reason
01 IEEE (BFP) floating point instructions or
-20104 AN ATTEMPT TO ALTER A CCSID instruction emulation is not available. This
FROM from-ccsid TO to-ccsid FAILED support is called the basic-floating-point-
extensions facility, and is discussed in detail in
Explanation: The statement attempted to alter the ESA/390 Principles of Operation,
CCSID for a database or table space and the statement SA22-7201–05 (and subsequent updates).
failed.
System Action: The statement cannot be executed.
from-ccsid represents the CCSID that is currently in use
for the database or table space. Programmer Response: This host variable or
parameter requires machine instructions that are not
to-ccsid is the CCSID that specified on the alter available on this machine. These instructions must be
statement. available to DB2 to perform the requested operation.
System Action: The statement cannot be executed. Run this statement on a machine that is capable of
supporting the required operations. Contact your system
Programmer Response: The SQL REFERENCE administrator.
contains a list of CCSIDs that may be specified on this
statement. Only CCSIDs specified in this appendix may SQLSTATE: 53022
be altered, and then, only to the corresponding value
122 DB2 UDB for OS/390 and z/OS: Messages and Codes
-20110 • -30000
-20110 CANNOT IMPLICITLY CONNECT TO A | -20201 THE INSTALL, REPLACE OR REMOVE
REMOTE SITE WITH A SAVEPOINT | OF jar-name FAILED AS THE JAR
OUTSTANDING | NAME IS INVALID
Explanation: The statement referenced an object at a | Explanation: The jar name jar-name specified on the
remote DBMS with an alias or a three-part name when | install, replace, or remove jar procedure was invalid. For
an active savepoint exists. Such a reference requires an | example, the jar may be of the improper format, may
implicit connection to the remote DBMS, which is not | not exist to be replaced, or cannot be installed as it
allowed when there is an outstanding savepoint. | already exists.
System Action: The statement is not executed. | System Action: DB2 cannot process the statement.
Programmer Response: Either release the savepoint, | User Response: Ensure the jar identifier is of the
or move the data. | correct format. If the jar exists, it may need to be
| removed before it can be installed. For the remove or
SQLSTATE: 51036
| replace procedures, ensure the jar exists.
| SQLSTATE: 54001
-20111 CANNOT ISSUE SAVEPOINT, RELEASE
SAVEPOINT, ROLLBACK TO
SAVEPOINT FROM A TRIGGER, FROM | -20202 THE REPLACE OR REMOVE OF
A USER-DEFINED FUNCTION, OR | jar-name FAILED AS class IS IN USE
FROM A GLOBAL TRANSACTION
| Explanation: A defined routine currently is using the
Explanation: SAVEPOINT, RELEASE SAVEPOINT, | specified class in the jar file, or the replacement jar file
and ROLLBACK TO SAVEPOINT statements can not be | does not contain the specified class for which a routine
used in the body of a trigger or a global transaction. | is defined.
System Action: The statement is not executed. | System Action: DB2 cannot process the statement.
Programmer Response: Correct the logic of the | SQLSTATE: 46003
application program so that this error does not occur.
SQLSTATE: 3B503 | -20204 THE USER-DEFINED FUNCTION OR
| PROCEDURE routine-name WAS
| UNABLE TO MAP TO A SINGLE JAVA
| -20129 LOCAL SPECIAL REGISTER IS NOT
| METHOD
| VALID AS USED
| Explanation: A CREATE or ALTER FUNCTION or
| Explanation: Local special registers cannot be
| PROCEDURE statement for routine-name specified a
| referenced in an assignment statement (SET or
| Java method in the EXTERNAL NAME clause that
| VALUES INTO) that assigns multiple values. For
| cannot be used. The identified function or procedure
| example, the following special registers are local:
| either failed to find a matching Java method, or found
| CURRENT SERVER and CURRENT PACKAGESET.
| more than 1 matching Java method.
| Additionally, the local special registers cannot be
| System Action: DB2 cannot process the statement.
| referenced in a SET host-variable statement that has
| parenthesis around the special register. | SQLSTATE: 46008
| The following statements are not valid:
| SET (:hv1) = (CURRENT SERVER); -30000 EXECUTION FAILED DUE TO A
| SET (:hv1,:hv2) = (CURRENT SERVER,CURRENT DISTRIBUTION PROTOCOL ERROR
| PATH); THAT WILL NOT AFFECT THE
| VALUES CURRENT SERVER, CURRENT DATE SUCCESSFUL EXECUTION OF
| INTO :c1, :c2; SUBSEQUENT COMMANDS OR SQL
STATEMENTS: REASON reason-code
| Severity: 8 (error) (sub-code)
| System Action: The statement cannot be executed. Explanation: A DRDA protocol error has resulted
| Programmer Response: Split the statement into which prevented successful execution of the current
| multiple statements so that the local special registers SQL statement. The error was such that it will not
| are not referenced in a statement that assigns multiple preclude the successful execution of further SQL
| values. Also be sure that a SET statement for a local statements.
| special register does not use parenthesis on either side
System Action: The statement cannot be executed.
| of the equal sign.
The SQLCA is formatted. Message DSNL031I or
| SQLSTATE: 560B5 DSNL032I, which might contain additional diagnostic
Chapter 2. SQL Return Codes 123
-30002 • -30020
information, might be issued to the MVS console. v A distributed client using DRDA has chained an
OPEN statement to a PREPARE, but the PREPARE
Programmer Response: Notify the DBA for
statement received SQLCODE +495.
assistance in analysis of the SQL statement which
yielded this SQLCODE. System Action: The statement cannot be executed as
chained.
Problem Determination: The 'reason-code' identifies
the DDM code point which represents the DDM reply Programmer Response: The statement must be sent
message received from the remote server in response again as a separate request.
to the attempt to execute the SQL statement. These
SQLSTATE: 57057
represent internal errors detected at the remote server
or possibly, by the local DB2 functions.
-30020 EXECUTION FAILED DUE TO A
The 'reason-code' value is the two-byte hexadecimal
DISTRIBUTION PROTOCOL ERROR
code point for the DDM reply message that represents
THAT CAUSED DEALLOCATION OF
the error and is one of the following:
THE CONVERSATION: REASON
X'1254' - CMDCHKRM
<reason-code (sub-code)>
X'220A' - DSCINVRM
X'220E' - DTAMCHRM Explanation: A DRDA protocol error has occurred that
X'1245' - PRCCNVRM prevented the successful execution of the current SQL
X'2202' - QRYNOPRM statement or command, as well as any subsequent SQL
X'220F' - QRYPOPRM statements.
X'2207' - RDBACCRM
X'2204' - RDBNACRM The 'reason-code' identifies the DDM code point which
X'124C' - SYNTAXRM represents the DDM reply message received from the
remote server in response to the attempt to execute the
SQL statement. These represent internal errors detected
A two-byte 'sub-code' accompanies 'reason-codes'
at the remote server site or possibly, by the local DB2
X'220A' (DSCINVRM), X'1245' (PRCCNVRM), and
functions.
X'124C' (SYNTAXRM). In all other cases, the 'sub-code'
is zero. The 'reason-code' value is the two-byte hexadecimal
code point for the DDM reply message that represents
The 'sub-code' when nonzero, consists of two bytes the error and is one of the following:
such that the high-order byte indicates the site at which X'1232' - AGNPRMRM
the error was detected. This is X'01' if the error was X'1254' - CMDCHKRM
detected by the local DB2; it is X'02' if the error was X'220A' - DSCINVRM
detected by the remote server. The low-order byte is X'220E' - DTAMCHRM
dependent on the 'reason-code' as follows: X'0010' - FDODSC
1. Description Error Code (DSCERRCD) if X'1218' - MGRDEPRM
'reason-code' = X'220A' (DSCINVRM). X'1245' - PRCCNVRM
X'241A' - QRYDSC
2. Syntax Error Code (SYNERRCD) if 'reason-code' =
X'2202' - QRYNOPRM
X'124C' SYNTAXRM).
X'220F' - QRYPOPRM
3. Conversational Protocol Error Code (PRCCVNCD) if X'2207' - RDBACCRM
'reason-code' = X'1245' (PRCCNVRM). X'2204' - RDBNACRM
X'124C' - SYNTAXRM
Refer to the IBM Distributed Data Management (DDM)
Reference Guide for a detailed discussion of the A two byte sub-code accompanies 'reason codes'. The
semantics of the DDM terms DSCERRCD, SYNERRCD, sub-code, when nonzero, consists of two bytes such
and PRCCNVCD. that the high-order byte indicates the site at which the
SQLSTATE: 58008 error was detected. This is X'01' if the error was
detected by the local DB2; It is X'02' if the error was
detected by the remote server. The low-order byte is
-30002 THE SQL STATEMENT CANNOT BE dependent upon the 'reason code' as follows:
EXECUTED DUE TO A PRIOR Description Error Code (DSCERRCD) if reason
CONDITION IN A CHAIN OF code= X'220A' (DSCINVRM).
STATEMENTS Syntax Error Code (SYNERRCD) if reason code =
X'124C' (SYNTAXRM).
Explanation: An SQL statement was chained to
Conversational Protocol Error Code (PRCCVNCD) if
PREPARE, but the PREPARE statement has received a
reason code = X'1245' (PRCCNVRM).
warning SQLCODE that requires the program or end
Manager Dependency Error Code (DEPERRCD) if
user to either re-issue the chained statement or issue a
reason code = X'1218' (MGRDEPRM).
different SQL request. This error can occur only in a
client/server environment.
124 DB2 UDB for OS/390 and z/OS: Messages and Codes
-30021 • -30040
Refer to IBM Distributed Data Management (DDM)
-30030 COMMIT REQUEST WAS
Reference Guide for a detailed discussion of the
UNSUCCESSFUL, A DISTRIBUTION
semantics of the DDM terms DSCERRCD, SYNERRCD,
PROTOCOL VIOLATION HAS BEEN
PRCCNVCD, and DEPERRCD.
DETECTED, THE CONVERSATION HAS
System Action: The statement cannot be executed. BEEN DEALLOCATED. ORIGINAL
The SQLCA is formatted and the conversation on which SQLCODE=original-sqlcode AND
the error was detected is deallocated. Message ORIGINAL SQLSTATE=original-sqlstate
DSNL031I or DSNL032I, which might contain additional
Explanation: The application requested COMMIT
diagnostic information, might be issued to the MVS
operation was unsuccessful and the response from the
console.
remote server and the SQLCODE that was returned
Programmer Response: The connection to the server from the remote server are inconsistent. For example,
has been broken, and the server has, therefore, rolled the reply message from the remote server indicates that
back the unit of work. In this case, the only SQL a COMMIT operation did not complete successfully but
statement that may be successfully executed is the SQLCODE returned from the remote server was
ROLLBACK. However, if the requester detects this error greater than or equal to zero. The unit of work has been
on a COMMIT, then it is unknown whether the unit of rolled back and the connection with the remote server
work was committed or rolled back at the server. has been deallocated.
SQLSTATE: 58009 System Action: An alert was generated. A DSNL031I
message may have been written to the console. Refer
to the description of this message for further
-30021 EXECUTION FAILED DUE TO A information.
DISTRIBUTION PROTOCOL ERROR
THAT WILL AFFECT THE The SQLCODE returned by the remote server is
SUCCESSFUL EXECUTION OF replaced with -30030 and the SQLSTATE returned by
SUBSEQUENT COMMANDS OR SQL the AS is replaced with '158013' and the connection
STATEMENTS: MANAGER manager AT with the remote server has been deallocated.
LEVEL level NOT SUPPORTED ERROR
The SQLCODE and SQLSTATE values that were
Explanation: A DRDA error occurred that prevented returned from the remote server are stored in the
the successful execution of the current SQL statement SQLERRM field in a string of the following format:
or command and any subsequent SQL statements. 'original-sqlcode 'FF'X original-sqlstate'
A manager-level conflict was detected during the Programmer Response: Notify the system
processing of the DDM EXCSAT command. Refer to the programmer for assistance in analyzing the trace data
IBM Distributed Data Management (DDM) Reference that was generated.
Guide for a detailed description of EXCSAT processing
and errors. SQLSTATE: 58013
The manager value is the 2-byte hexadecimal code
point of the DDM manager class identified as not -30040 EXECUTION FAILED DUE TO
supported in the EXCSATRD that reported the error. UNAVAILABLE RESOURCES THAT
Refer to the DDM term MGRLVL in the IBM Distributed WILL NOT AFFECT THE SUCCESSFUL
Data Management (DDM) Reference Guide for the EXECUTION OF SUBSEQUENT
2-byte hexadecimal values. COMMANDS OR SQL STATEMENTS.
REASON reason-code TYPE OF
The level value is the 2-byte hexadecimal value of the RESOURCE resource-type RESOURCE
manager level identified as not supported in the NAME resource-name PRODUCT ID
EXCSATRD that reported the error. Refer to the DDM pppvvrrm RDBNAME rdbname
term MGRLVL in the IBM Distributed Data Management
(DDM) Reference Guide for the 2-byte hexadecimal Explanation: The SQL statement or command
values. requires a non RDB resource that is currently
unavailable. The reason-code identifies why the
System Action: The statement cannot be executed. resource identified by the resource-type and
Programmer Response: Notify the system resource-name is unavailable. The product, product
programmer for analysis of the condition that caused level, and RDB are identified.
this SQLCODE. Values for reason-code
SQLSTATE: 58010 This is product specific and can be found in the
remote server documentation.
Values for resource-type
Two byte hexadecimal number defined as follows:
Chapter 2. SQL Return Codes 125
-30041 • -30050
This is product specific and can be found in the Two byte hexadecimal number that is product
remote server documentation. specific. This can be found in the remote server
documentation.
Values for resource-name
Variable length field with alphanumeric characters Values for <resource-name>
and a maximum length of 35 bytes. Variable length field with alphanumeric characters
and a maximum length of 35 bytes.
Values for pppvvrrm
Eight-byte field with alphanumeric characters defined Values for <pppvvrrm>
as follows: Eight byte field with alphanumeric characters defined
ppp....... DSN for OS/390, ARI for SQL/DS SQL as follows:
and QSQ for AS/400 (3 bytes) ppp....... DSN for DB2, ARI for SQL/DS, SQL for
vv........ version number (2 bytes) OS/2 and QSQ for AS/400 (3 bytes)
rr........ release level (2 bytes) vv........ version number (2 bytes)
m......... modification level (1 byte) rr........ release level (2 bytes)
m......... modification level (1 byte)
Values for rdbname
Sixteen-byte field with the RDBNAME. Values for <rdbname>
Sixteen byte field with the RDBNAME.
System Action: The statement cannot be processed.
The local DB2 is disconnected from the remote server. System Action: The statement cannot be executed.
The local DB2 is disconnected from the remote server.
Programmer Response: Verify the identify of the
resource that was not available. The reason the Programmer Response: Verify the identity of the
resource is unavailable is identified by the reason-code. resource that was not available. The reason the
resource is unavailable is identified by the reason-code.
Collect the following diagnostic items to help determine
the cause of the unavailable resource. Collect the following diagnostic items to help determine
v Console output from the system identified by the cause of the unavailable resource.
RDBNAME, and a listing of SYSLOG data set for the v Console output from the system identified by
period of time spanning the failure. RDBNAME, and a listing of SYSLOG data set for the
v Information described for the reason code received. period of time spanning the failure.
v Information described for the <reason-code>
SQLSTATE: 57012
received.
SQLSTATE: 57013
-30041 EXECUTION FAILED DUE TO
UNAVAILABLE RESOURCES THAT
WILL AFFECT THE SUCCESSFUL -30050 <command-or-SQL-statement-type
EXECUTION OF SUBSEQUENT COMMAND OR SQL STATEMENT
COMMANDS AND SQL STATEMENTS. INVALID WHILE BIND PROCESS IN
REASON <reason-code> TYPE OF PROGRESS
RESOURCE <resource-type>
Explanation: A remote command or remote SQL
RESOURCE NAME <resource-name>
execution was attempted while a remote bind was in
PRODUCT ID <pppvvrrm> RDBNAME
progress. The only commands allowed during bind are,
<rdbname>
BIND STATEMENT, END BIND, ROLLBACK, or
Explanation: The SQL statement or command COMMIT.
requires a non RDB resource that is currently
System Action: The request is rejected. The local
unavailable. The <reason-code> identifies why the
DB2 is disconnected from remote server.
resource identified by the <resource-type> and
<resource-name> is unavailable. The product, product Programmer Response: Ensure the remote bind has
level, and RDB are identified. completed before attempting to execute an SQL
statement or process a remote command. COMMIT and
Values for <reason-code>
ROLLBACK will terminate the bind processing.
Four byte binary number that is product specific.
This can be found in the remote server SQLSTATE: 58011
documentation.
Values for <resource-type>
126 DB2 UDB for OS/390 and z/OS: Messages and Codes
-30051 • -30071
-30051 BIND PROCESS WITH SPECIFIED -30061 RDB NOT FOUND
PACKAGE NAME AND CONSISTENCY
Explanation: An attempt was made to access an RDB
TOKEN NOT ACTIVE
which cannot be found. This usually means that a
Explanation: Binding of a statement or end bind was requester specified the server location name incorrectly.
attempted while the package was not undergoing bind The server responded by indicating that the requester’s
processing. specification of the server location name is incorrect.
Requester or server changes are needed to make the
System Action: The bind statement request or end
location names consistent. Location names for DB2
bind request is rejected. The local DB2 is disconnected
systems are defined in the BSDS DDF record and are
from the remote server.
also in the DSNL004I console message when DDF is
Programmer Response: Ensure that the server started. For more information about defining location
processing the bind request was not abending when names, see Part 3 of DB2 Installation Guide.
this request was being processed, or that the package
System Action: The request is not processed.
name hasn’t changed before terminating the remote
bind package request. Programmer Response: Ensure the RDB name was
correctly specified and resubmit the job.
SQLSTATE: 58012
SQLSTATE: 08004
-30052 PROGRAM PREPARATION
ASSUMPTIONS ARE INCORRECT -30070 command COMMAND NOT
SUPPORTED ERROR
Explanation: The program preparation assumptions in
effect for binding a statement (i.e. BINDSQLSTT Explanation: The target does not support a particular
command) are incorrect. command. The error causes termination of the
connection between the local DB2 and the remote
System Action: The statement is rejected.
server.
Programmer Response: The creation of the package
Values for command
following this error is dependent on the package
creation options specified at begin bind time. Two byte hexadecimal DDM code point.
SQLSTATE: 42932 System Action: The command is rejected. The local
DB2 is disconnected from the remote server.
-30053 OWNER AUTHORIZATION FAILURE Programmer Response: Ensure the proper command
was issued.
Explanation: An authorization error associated with
the package owner is detected. The AS, for example, SQLSTATE: 58014
has determined that the binder has specified a package
owner that the binder has no authorization to specify. -30071 object-type OBJECT NOT SUPPORTED
System Action: The begin bind request is rejected. ERROR
Programmer Response: Correct the authorization Explanation: The target does not support a particular
problem and reissue the request. object. The error causes the termination of the
connection between the local DB2 and the remote
SQLSTATE: 42506 server.
Values for object-type
-30060 RDB AUTHORIZATION FAILURE
Two byte hexadecimal DDM code point.
Explanation: The user is not authorized to access an
System Action: The command/SQL statement is
RDB.
rejected. The local DB2 is disconnected from the remote
System Action: The request is rejected. server.
Programmer Response: Correct the authorization Programmer Response: Ensure the object has been
problem and resubmit the job. correctly specified and resubmit the job or reissue the
command.
SQLSTATE: 08004
SQLSTATE: 58015
Chapter 2. SQL Return Codes 127
-30072 • -30073
Determine the single-byte CCSIDs for the
-30072 parameter subcode PARAMETER NOT
requester and server systems. The single-byte
SUPPORTED ERROR
CCSID for DB2 subsystems is defined in
Explanation: A particular parameter is not supported DSNHDECP. One or both partners might be
by either the application requester or the remote server. using an incorrect CCSID, or support might
need to be added. See DB2 Installation Guide
Values for parameter
for more information on CCSIDs.
Two byte hexadecimal DDM code point.
X'147A'
Values for subcode DB2 servers can return this code point when a
numeric input host variable is not within the
Two byte hexadecimal number defined as follows: range that DB2 supports. See the explanation
This subcode is composed of two distinct parts, but of SQLCODE -406 for more information.
may optionally be zero. The high-order byte (when
not zero) indicates the site at which the error was X'14AC'
detected. This is X’01’ if the error was detected by DB2 servers return this code point when a
the local DB2; it is X’02’ if the error was detected by DRDA client requests an authentication
the remote server. The low order byte is always mechanism that is not supported by the DB2
zero. server. See the explanation of DB2 reason
code 00D3010E for more information.
System Action: The command/SQL statement is
rejected. A disconnect has occurred. X'2110'.
Usually means that a requester specified the
Programmer Response: The connection to the server server location name incorrectly. The server
has been broken, and the server has therefore rolled responded by indicating that the requester’s
back the unit of work. In this case, the only SQL specification of the server location name is
statement that may be successfully executed is incorrect, and the length of the location name
ROLLBACK. However, if the requester detects this error is longer than that supported by the server.
on a COMMIT, then it is unknown whether the unit of Requester or server changes are needed so
work was committed or rolled back at the server. the location names are consistent. Location
SQLSTATE: 58016 names for DB2 systems are defined in the
BSDS DDF record and can also be seen in the
DSNL004I console message when DDF is
-30073 parameter subcode PARAMETER VALUE started. See Part 3 of DB2 Installation Guide
NOT SUPPORTED ERROR for more information about defining location
Explanation: The specified parameter value is not names.
supported by either the local DB2 or the remote server. X'2120' Usually means that the server does not support
The parameter, is a 2-byte hexadecimal DDM code the use of double quote string delimiters in
point. See IBM Distributed Data Management (DDM) SQL statements. DB2 COBOL applications can
Reference Guide for a definition of the valid code use double quote string delimiters in SQL
points. Common values for parameter include: statements. This requires that the program be
precompiled with the SQLDELIM(QUOTESQL)
X'0035' Usually means that a DB2 server does not option. If the server product does not support
support the single-byte coded character set double quote SQL statement string delimiters,
identifier (CCSID) sent by the requester, or a then the program must be modified to use
DB2 requester does not support the single-byte single quote SQL string delimiters and be
CCSID received from a server. See X'119C' for precompiled with the SQLDELIM(APOSTSQL)
more information. option.
X'1144' DRDA servers return this code point when a X'2121' Usually means that the there is a semantic
DB2 client specifies a version for a package error with the string that specifies the character
and the DRDA server does not support used as a decimal delimiter in SQL statements.
versions.
X'213F'
X'119C' Means that the server was processing a bind
If the subcode information contains X'01', the or rebind command that specified an
requester does not support the single-byte unsupported value for the DYNAMICRULES
CCSID that the server wants to use. If the bind parameter. If the server is a DB2 Version
subcode information contains X'02', the server 3 system, specify DYNAMICRULES(RUN) or
does not support the single-byte CCSID that omit the DYNAMICRULES parameter.
the requester wants to use.
The 'subcode', which is a 2-byte hexadecimal number,
consists of two distinct parts and can optionally be zero.
128 DB2 UDB for OS/390 and z/OS: Messages and Codes
-30074 • -30081
The high-order byte (when not zero) indicates the site at The sense portion of subcode is VTAM’s sense code.
which the error was detected. If the error was detected See “Part 6. SNA CODES” on page 1269 for
by the local DB2, it is X'01'. If the error was detected by descriptions of sense codes that are often associated
the remote server, it is X'02'. The low-order byte is with SNA network definition errors.
always zero.
System Action: The statement is not executed. The
System Action: The command or SQL statement is application was disconnected from the server because
rejected. A disconnect occurred. of a communication failure. A DSNL500I message
containing additional diagnostic information might be
Programmer Response: The connection to the server
issued to the MVS console.
was broken, and the server rolled back the unit of work.
The only SQL statement that can be successfully Programmer Response: Review the diagnostic
executed is ROLLBACK. However, if the requester information described in VTAM for MVS/ESA
detects this error on a COMMIT, then it is unknown Programming for LU 6.2 for the particular LU6.2 return
whether the unit of work was committed or rolled back codes. Consult with a communications expert to
at the server. determine the cause of the communication failure.
SQLSTATE: 58017 SQLSTATE: 08001
-30074 REPLY MESSAGE WITH codepoint -30081 prot COMMUNICATION ERROR
(svrcod) NOT SUPPORTED ERROR DETECTED. API=api, LOCATION=loc,
FUNCTION=func, ERROR CODES=rc1
Explanation: A reply message codepoint is not
rc2 rc3
recognized or the reply message SVRCOD is not
recognized. The error does not affect the processing of Explanation: A communications error was detected
subsequent DRDA commands and SQL statements while communicating with a remote client or server.
issued by the application program.
prot Identifies the communication protocol that
Values for codepoint encountered the error. Currently, ’TCP/IP’ is the
v The codepoint is a two-byte hexadecimal value that only possible value.
represents a DDM reply message. IBM Distributed api Identifies the communication application
Data Management (DDM) Reference Guide defines programming interface (API) used by DB2.
the valid codepoints for reply messages. Currently, ’SOCKETS’ is the only possible
value.
Values for SVRCOD
loc The network location of the partner system.
v The SVRCOD is a one-byte hexadecimal value which
represents the reply messages severity code. IBM For TCP/IP partners, this field contains the
Distributed Data Management (DDM) Reference dotted decimal IP address of the partner.
Guide defines the valid SVRCOD for reply messages.
func The communication function that failed.
System Action: Processing continues.
For TCP/IP partners, this field identifies name
Programmer Response: The cause of this error may of the socket call that failed.
be a mismatch in source and targe manager levels or
rc1 The first return code indicator.
might be an internal error.
For TCP/IP partners, this field contains the
SQLSTATE: 58018
TCP/IP return code in decimal format. The
return code values are documented in OS/390
-30080 COMMUNICATION ERROR code UNIX System Services Programming:
(subcode) Assembler Callable Services Reference.
Explanation: A SNA communications error was rc2 The second return code indicator.
detected. VTAM for MVS/ESA Programming for LU 6.2
For TCP/IP partners, this field contains the
contains the valid code and subcode values that can
TCP/IP reason code in decimal format. The
appear in this message.
reason code values are documented in OS/390
v code is VTAM’s primary LU6.2 return code (RCPRI). UNIX System Services Programming:
v subcode takes one of the following forms: Assembler Callable Services Reference.
– rcsec-sense
rc3 The third return code indicator.
– rcsec
For TCP/IP partners, this field contains zero.
The rcsec portion of subcode is VTAM’s secondary
System Action: The statement is not executed. The
LU6.2 return code (RCSEC).
application is disconnected from the server.
Chapter 2. SQL Return Codes 129
-30082 • -30105
Programmer Response: Consult with a Already Verified userids. Client or server changes
communications expert to determine the cause of the must be made to correct the inconsistency.
communication failure. - DB2 for OS/390 server acceptance of Already
SQLSTATE: 08001 Verified userids over TCP/IP connections is
controlled by the TCPALVER value of the
DSNTIP5 installation panal (DSN6FAC
-30082 CONNECTION FAILED FOR SECURITY TCPALVER).
REASON reason-code (reason-string)
- DB2 for OS/390 client usage of Already Verified
Explanation: The attempt to connect to a remote userids is controlled by the SECURITY_OUT
database server was rejected due to invalid or incorrect column of the SYSIBM.LUNAMES or
security information. The cause of the security error is SYSIBM.IPNAMES tables.
described by the reason-code and reason-string values.
System Action: The attempt to connect to the remote
The possible values for reason-code and reason-string database server fails. If the server system is a DB2 for
appear below: OS/390 and z/OS server, a DSNL030I message at the
v 1 (PASSWORD EXPIRED) -- the password used to server system describes the cause.
connect to the remote server has expired. Programmer Response: DB2 uses the
v 2 (PASSWORD INVALID) -- the password used to communications database (CDB) to control network
connect to the remote server does not match the security functions. Make the appropriate changes to the
password stored at the remote server. CDB to correct the security failure.
v 3 (PASSWORD MISSING) -- the remote server SQLSTATE: 08001
rejected the connection request because the request
did not include a password.
-30090 REMOTE OPERATION INVALID FOR
v 4 (PROTOCOL VIOLATION) -- the remote server
APPLICATION EXECUTION
rejected the connection request because the request
ENVIRONMENT
did not contain the proper security information. Error
messages or trace records should be produced by Explanation: An update operation or a dynamic
the server system to explain the nature of the commit or rollback was attempted at a server that was
security violation. supporting an application that was in a read-only
v 5 (USER-ID MISSING) -- the remote server rejected execution environment (IMS or CICS).
the connection request because the request did not System Action: The request is rejected.
specify a user-id.
Programmer Response: Do not attempt to update
v 6 (USER-ID INVALID) -- the user-id specified in the
data or issue dynamic commits or rollbacks from IMS or
connection request is not defined at the remote
CICS applications that are accessing remote data.
server system.
v 7 (USER-ID REVOKED) -- the user-id specified in the SQLSTATE: 25000
connection request has been revoked.
v 15 (SECURITY -30104 ERROR IN BIND OPTION option AND
FAILURE:secchkcd:svcerrno)—Authentication failed BIND VALUE value.
at the remote server system. Refer to the IBM
Distributed Data Management (DDM) Reference Explanation: While processing the bind parameters
Guide for a detailed discussion of the semantics of that were passed from the requester site, either the bind
the DDM terms SECCHKCD and SVCERRNO. option or the bind value is not acceptable to the server
database, or the option/value pair is not appropriate.
v 16 (NEW PASSWORD INVALID) -- the password
specified on a change password request did not meet Programmer Response: The BIND or REBIND
the server’s requirements. command failed. Examine the command options and
v 17 (UNSUPPORTED FUNCTION) -- the security values, determine the error, and resubmit the command.
mechanism specified by the client is invalid for this SQLSTATE: 56095
server. Some typical examples:
– The client sent a new password value to a server
-30105 BIND OPTION option1 IS NOT
that does not support the DRDA change password
ALLOWED WITH BIND OPTION option2
function.
– The client sent DCE authentication information to Explanation: While processing the bind parameters
a server that does not support DCE. that were passed from the requester site, it was found
that there is a conflict in bind options that are mutually
– The client is configured to send an Already
exclusive.
Verified userid but the server does not support
Programmer Response: The BIND or REBIND
130 DB2 UDB for OS/390 and z/OS: Messages and Codes
command failed. Examine the command options,
determine the cause of the conflict, and resubmit the
command.
SQLSTATE: 56096
Chapter 2. SQL Return Codes 131
132 DB2 UDB for OS/390 and z/OS: Messages and Codes
Part 3. DB2 Messages
Chapter 3. DB2 Messages . . . . . . . . . . . . . . . . . . . . 135
Chapter 4. DSNA... Messages . . . . . . . . . . . . . . . . . . 137
Chapter 5. DSNB... Messages . . . . . . . . . . . . . . . . . . 143
Chapter 6. DSNE... Messages . . . . . . . . . . . . . . . . . . 189
Chapter 7. DSNF... Messages . . . . . . . . . . . . . . . . . . 213
| Chapter 8. DSNG... Messages . . . . . . . . . . . . . . . . . . 215
Chapter 9. DSNH... Messages . . . . . . . . . . . . . . . . . . 217
Message line numbers . . . . . . . . . . . . . . . . . . . . . 217
Message severity codes . . . . . . . . . . . . . . . . . . . . . 217
Source tokens in messages. . . . . . . . . . . . . . . . . . . . 218
Chapter 10. DSNI... Messages . . . . . . . . . . . . . . . . . . 255
Chapter 11. DSNJ... Messages . . . . . . . . . . . . . . . . . . 263
Chapter 12. DSNL... Messages . . . . . . . . . . . . . . . . . . 307
Chapter 13. DSNM... Messages . . . . . . . . . . . . . . . . . . 351
Chapter 14. DSNN... Message . . . . . . . . . . . . . . . . . . 353
Chapter 15. DSNP... Messages . . . . . . . . . . . . . . . . . . 355
Chapter 16. DSNR... Messages . . . . . . . . . . . . . . . . . . 367
Chapter 17. DSNT... Messages . . . . . . . . . . . . . . . . . . 375
Chapter 18. DSNU... Messages . . . . . . . . . . . . . . . . . . 441
Chapter 19. DSNV... Messages . . . . . . . . . . . . . . . . . . 579
Chapter 20. DSNW... Messages . . . . . . . . . . . . . . . . . . 597
Chapter 21. DSNX... Messages . . . . . . . . . . . . . . . . . . 611
Chapter 22. DSNY... Messages . . . . . . . . . . . . . . . . . . 629
Chapter 23. DSNZ... Messages . . . . . . . . . . . . . . . . . . 631
Chapter 24. DSN1... Messages . . . . . . . . . . . . . . . . . . 633
Chapter 25. DSN2... Messages . . . . . . . . . . . . . . . . . . 661
Chapter 26. DSN3... Messages . . . . . . . . . . . . . . . . . . 671
Chapter 27. DSN7... Messages . . . . . . . . . . . . . . . . . . 683
© Copyright IBM Corp. 1982, 2001 133
Chapter 28. DSN8... Messages . . . . . . . . . . . . . . . . . . 691
Chapter 29. DSN9... Messages . . . . . . . . . . . . . . . . . . 701
134 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 3. DB2 Messages
Refer to “Part 1. Introduction” on page 1 for a description of message types and
message numbering conventions.
Unless the message is issued by a subcomponent operating outside the DB2
environment, messages are preceded by a command prefix that is defined during
system installation. The command prefix is not shown in the message texts in this
book.
In the TSO attachment facility, the user can control whether message IDs are
displayed. To see them, type 'PROFILE MSGID'. To suppress them, type 'PROFILE
NOMSGID'.
© Copyright IBM Corp. 1982, 2001 135
136 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 4. DSNA... Messages
The messages in this chapter are written to the trace. They are seen only if the
trace is turned on (that is, ddname DSNTRACE was allocated to SYSOUT or the
TSO terminal).
DSNA... messages share a basic structure. Here are the message elements, listed
in order:
1. Message number (DSNAnnna).
2. The name of the CSECT responsible for writing the message.
3. TCB address of the task currently executing.
4. A series of tokens and token-explanations unique to each message.
Note: The intent of these messages is to aid IBM development and the IBM
Support Center. They contain information that might not be meaningful
except to IBM.
Programmer Response: You must DISCONNECT the
DSNA002E DSNACA00 TCB=address SYSTEM
previous connection before you can re-CONNECT.
ERROR - FOUND UNEXPECTED
Correct the logic in your code.
THREAD
Problem Determination: See a DSNTRACE trace
Explanation: The DB2 call attachment facility control
stream to understand the context of this message.
block, the CAB, indicated that a thread was present
when none should have been present. This is a CAF
system error. DSNA202E DSNACA00 TCB=address CANNOT
USE 'OPEN', PRIOR OPEN OR SQL
This message is issued by the following CSECT:
ALREADY CONNECTED APPLICATION
DSNACA00
TO DB2
System Action: This message immediately precedes
Explanation: An OPEN request was received but a
an 04E abend, with reason code 00C10002.
DB2 thread had already been created for the specified
System Programmer Response: Collect a TCB. This is a user error. The message is accompanied
SYSUDUMP and DSNTRACE trace stream. by return code (R15) 200 and code (R0) 00C10202.
Programmer Response: Refer the problem to your System Action: No new DB2 thread is created and an
system programmer. error return and reason code are issued. The DB2 call
attachment facility is ready for more input.
Problem Determination: Contact your IBM Support
Center. System Programmer Response: Refer the problem
to the programmer using the DB2 call attachment
facility.
DSNA201E DSNACA00 TCB=address CANNOT
USE 'CONNECT', ALREADY Programmer Response: Your application program
CONNECTED TO DB2 had already (explicitly or implicitly) established an
OPEN level connection to DB2. You cannot do this
Explanation: A CONNECT request was received but a
again until the original OPEN is terminated. 'Explicit'
connection to DB2 already existed for the TCB identified
OPENs occur when an application issues the call
by 'address' in the message. This is a CAF error
attachment facility OPEN request. 'Implicit' OPENs
(application program error). The message is
occur when an application issues SQL statements
accompanied by return code (R15) 200 and code (R0)
before a DB2 connection was established. Correct the
00C10201.
logic in your application program.
System Action: No new connection is made to DB2
Problem Determination: See a DSNTRACE trace
and an error return and reason code are issued. The
stream to understand the context of this message.
DB2 call attachment facility is ready for more input.
System Programmer Response: Refer the problem
to the programmer using the DB2 call attachment
facility.
© Copyright IBM Corp. 1982, 2001 137
DSNA203E • DSNA207E
DB2 call attachment facility is ready for more input.
DSNA203E DSNACA00 TCB=address CANNOT
USE 'CLOSE', THERE WAS NO 'OPEN' System Programmer Response: Refer the problem
IN EFFECT to the programmer using the DB2 call attachment
facility.
Explanation: A CLOSE request was received but no
OPEN level connection (implicit or explicit) existed for Programmer Response: Correct the logic in your
this task. This is a user error. The message is application. Do not issue TRANSLATE unless a DB2
accompanied by return code (R15) 200 and code (R0) connection has been attempted.
00C10203.
Problem Determination: See a DSNTRACE trace
System Action: No CLOSE is performed. The DB2 stream to understand the context of this message.
call attachment facility is ready for more input.
System Programmer Response: Refer the problem DSNA206E DSNACA00 TCB=address WRONG
to the programmer using the DB2 call attachment NUMBER OF PARMS OR VL BIT OFF
facility.
Explanation: An erroneous DB2 call attachment
Programmer Response: Correct the logic in your facility request was received. The request had too many
application. Do not issue CLOSE unless an explicit or too few parameters and could not be processed. The
OPEN has been performed. 'Explicit' OPENs occur message is accompanied by return code (R15) 200 and
when an application issues the call attachment facility code (R0) 00C10206.
OPEN request.
System Action: The previous request was not
Problem Determination: See a DSNTRACE trace processed. The DB2 call attachment facility is ready for
stream to understand the context of this message. more input.
System Programmer Response: Refer the problem
DSNA204E DSNACA00 TCB=address CANNOT to the programmer using the DB2 call attachment
USE 'DISCONNECT', THERE WAS NO facility.
'CONNECT' IN EFFECT
Programmer Response: Correct the logic in your
Explanation: A DISCONNECT request was received application. Be sure that any parameter list passed to
but no DB2 connection had been established. This is a the DB2 call attachment facility has the correct number
user error. The message is accompanied by return code of parameters for the individual call, and that the high
(R15) 200 and code (R0) 00C10204. order (VL) bit is turned on to end the parameter list.
System Action: No DISCONNECT has been Problem Determination: See a DSNTRACE trace
performed. The DB2 call attachment facility is ready for stream to understand the context of this message.
more input.
System Programmer Response: Refer the problem DSNA207E DSNACA00 TCB=address DID NOT
to the programmer using the DB2 call attachment RECOGNIZE ACTION PARAMETER -
facility. parm
Programmer Response: Correct the logic in your Explanation: An unrecognized action request type or
application. Do not issue DISCONNECT unless a parameter was received by the DB2 call attachment
CONNECT has been performed. facility and could not be processed. The allowable
action request types are CONNECT, OPEN, CLOSE,
Problem Determination: See a DSNTRACE trace
DISCONNECT, and TRANSLATE. For allowable
stream to understand the context of this message.
parameters, refer to the CAF section in DB2 Application
Programming and SQL Guide. This message is
DSNA205E DSNACA00 TCB=address CANNOT accompanied by return code (R15) 200 and code (R0)
USE 'TRANSLATE', THERE WAS NO 00C10207.
CONNECTION TO DB2 OR NOTHING
System Action: Control returns to the caller. Your
TO TRANSLATE
request was not processed. The DB2 call attachment
Explanation: A TRANSLATE request was received but facility is ready for more input.
no data was available for translation. You must have
System Programmer Response: Refer the problem
valid DB2 call attachment facility control structures
to the programmer using the DB2 call attachment
before you can make a TRANSLATE request. Control
facility.
structures are built when you issue explicit or implicit
connection requests. This is a user error. The message Programmer Response: Correct the logic in your
is accompanied by return code (R15) 200 and code application. Check the spelling of the action parameter
(R0) 00C10205. type or keyword on the previous request passed to the
DB2 call attachment facility. The action parameter type
System Action: No TRANSLATE is performed. The
138 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNA208E • DSNA304I
you passed is listed in the parm field of the DSNA800I # System Action: The stored procedure DSNACICS
trace message. If the error is not the action parameter, # terminates without calling the CICS transaction.
the parameter in error is listed in the parm field of this
# Programmer Response: Correct the input parameter
message.
# value specified on the SQL CALL statement.
Problem Determination: See a DSNTRACE trace
# System Programmer Response: Ensure that the user
stream to understand the context of this message.
# exit DSNACICX sets the parameter to a valid value.
DSNA208E DSNACA00 TCB=address CANNOT
# DSNA302I THE REQUIRED INPUT PARAMETER
HAVE 2 SSIDS (ssid1 AND ssid2)
# parm-name CONTAINS NULLS
FROM 1 TCB
# Explanation: The stored procedure DSNACICS could
Explanation: An OPEN request was received
# not run because one or more of the required input
specifying a different subsystem identifier (ssid2) than
# parameters contains a null value.
the previous CONNECT request (ssid1). Your task can
only be connected to a single DB2 subsystem. The # Severity: 12
message is accompanied by return code (R15) 200 and
code (R0) 00C10208. # System Action: The stored procedure DSNACICS
# terminates without calling the CICS transaction.
System Action: Control returns to the caller. Your
request was not processed. The DB2 call attachment # Programmer Response: Correct the input parameter
facility is ready for more input. # value in the SQL CALL statement, or ensure that the
# user exit DSNACICX sets the parameter to a non-null
System Programmer Response: Refer the problem # value.
to the programmer using the DB2 call attachment
facility. # System Programmer Response: Ensure that the user
# exit DSNACICX sets the parameter to a non-null value.
Programmer Response: Specify the correct DB2
subsystem identifier on both the OPEN and CONNECT
requests. # DSNA303I THE PARAMETER NETNAME WAS NOT
# SPECIFIED WHEN THE CONNECT
Problem Determination: See a DSNTRACE trace # TYPE OF SPECIFIC WAS SPECIFIED
stream to understand the context of this message.
# Explanation: The input parameter NETNAME must
# contain a non-null value when the CONNECT TYPE
DSNA209E DSNACA00 A STORED PROCEDURE # parameter is set to SPECIFIC.
ISSUED AN EXPLICIT CALL TO
DSNALI # Severity: 12
Explanation: A stored procedure issued an explicit call # System Action: The stored procedure DSNACICS
to DSNALI. This is not allowed. Return code 200 in # terminates without calling the CICS transaction.
register 15 and code 00C10209 in register 0 accompany # Programmer Response: Correct the input parameter
this message. # value in the SQL CALL statement, or ensure the the
System Action: Control returns to the caller. The # user exit DSNACICX sets the parameter to a non-null
request was not processed. The DB2 call attachment # value.
facility is ready for more input. # System Programmer Response: Ensure that the user
System Programmer Response: Refer the problem # exit DSNACICX sets the parameter to a non-null value.
to the programmer using the DB2 call attachment
facility. # DSNA304I THE USER EXIT DSNACICX
Programmer Response: Remove explicit calls to # RETURNED RETURN CODE =
DSNALI from the application program. # X'hhhhhhhh' AND THE FOLLOWING
# ERROR MESSAGE:
Problem Determination: See a DSNTRACE trace job
stream to understand the context of this message. # Explanation: The user exit DSNACICX returned a
# non-zero return code and a message to stored
# procedure DSNACICS. The message that DSNACICX
# DSNA301I THE VALUE parm-value FOR # returns immediately follows message DSNA304I.
# PARAMETER parm-name IS NOT VALID
# Severity: 12
# Explanation: The stored procedure DSNACICS could
# not run because one of the input parameters contains # System Action: The stored procedure DSNACICS
# an incorrect value. # terminates without calling the CICS transaction.
# Severity: 12 # Programmer Response: Contact the system
# programmer.
Chapter 4. DB2 Messages 139
DSNA305I • DSNA307I
# System Programmer Response: Correct the cause of
# DSNA306I THE CICS SERVER PROGRAM program
# the error message that the user exit generated.
# ABENDED. CICS ABEND
# CODE=C’cccc’
# DSNA305I THE CICS EXCI func REQUEST FAILED.
# Explanation: The CICS server program that
# CICS RESPONSE CODE = X'hhhh'
# DSNACICS called abnormally terminated. CICS returns
# CICS REASON CODE = X'hhhhhhhh'
# a four-character abend code to indicate the error. These
# Explanation: DSNACICS uses the CICS EXCI Call # error codes are described in CICS/ESA Problem
# interface to request the execution of a CICS server # Determination Guide.
# program. CICS EXCI interface call func resulted in an
# Severity: 12
# unexpected CICS response code and reason code.
# Possible values of func are: # System Action: Stored procedure DSNACICS
# processes the next request. CICS does a backout to the
# Initialize_User Initializes the EXCI user environment.
# last syncpoint and forces the SYNCONRETURN option.
# Allocate_Pipe Allocates a session to a CICS region.
# Programmer Response: Correct the error in the
# Open_Pipe Connects an allocated pipe to a # server program.
# receive session of the CICS region.
# System Programmer Response: Correct the cause of
# DPL_Request Issues a request to execute the CICS # the error in the server program. Ensure that the mirror
# server program. # transaction is still enabled after this error. The mirror
# transaction must be enabled so that subsequent
# Close_Pipe Disconnects an open pipe from a # requests to run a server program are accepted.
# CICS region.
# Deallocate_Pipe # DSNA307I OS/390 token-service REQUEST FAILED.
# Deallocates a pipe from a CICS # SYSTEM RETURN CODE=X'hhhh'
# region.
# Explanation: DSNACICS uses the OS/390 token
# The failure can occur because the EXCI interface is not # services to save task-level information. The OS/390
# properly enabled for the CICS subsystem. For # service returned an unexpected return code.
# explanations of the CICS response code and reason # token-service is the token service function that
# code, see CICS External Interfaces Guide. # DSNACICS requested. Possible values are:
# Severity: 12 # Create_token Create a token using the IEANTCR
# System Action: The stored procedure DSNACICS # service.
# terminates without calling the CICS transaction. # Retrieve_token Retrieve a token using the IEANTRT
# Programmer Response: Contact the system # service.
# programmer.
# See the description of IEANTCR or IEANTRT in OS/390
# System Programmer Response: Ensure that the # MVS Programming: Assembler Services Reference for a
# EXCI interface is enabled to the CICS region that the # full description of the return code.
# stored procedure calls. If you suspect an error in the
# DB2 stored procedure, refer to Part 3 of DB2 Diagnosis # Severity: 12
# Guide and Reference for information on identifying and
# System Action: Stored procedure DSNACICS
# reporting the problem.
# processes the next request.
# Add a DSNDUMP DD statement to the JCL startup
# Programmer Response: Contact the system
# procedure for the stored procedure address space in
# programmer.
# which DSNACICS runs. Then rerun the application that
# calls DSNACICS. This causes DB2 to generate an SVC # System Programmer Response: Add a DSNDUMP
# dump whenever it issues an error message for # DD statement to the JCL startup procedure for the
# DSNACICS. # stored procedure address space in which DSNACICS
# runs. Then rerun the application that calls DSNACICS.
# If you suspect an error in the DB2 stored procedure,
# This causes DB2 to generate an SVC dump whenever it
# refer to Part 3 of DB2 Diagnosis Guide and Reference.
# issues an error message for DSNACICS.
# Collect the following diagnostic items listed in
# “Appendix B. Problem determination” on page 1281: 1, # If you suspect an error in the DB2 stored procedure,
# 2, 22. # refer to Part 3 of DB2 Diagnosis Guide and Reference.
# Collect the following diagnostic items listed in
# “Appendix B. Problem determination” on page 1281: 1,
# 2, 22.
140 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNA308I • DSNA312I
# DSNA308I THE CICS EXCI DPL_REQUEST
# refer to Part 3 of DB2 Diagnosis Guide and Reference.
# REQUEST FAILED. CICS RESPONSE
# Collect the following diagnostic items listed in
# CODE=0. DPL RETAREA CONTAINS
# “Appendix B. Problem determination” on page 1281: 1,
# FIELD1=X'hhhhhhhh',
# 2, 22.
# FIELD2=X'hhhhhhhh', FIELD3=C’cccc’
# Explanation: DSNACICS uses the CICS EXCI Call
# DSNA310I STORED PROCEDURE TASK
# interface to request the execution of a CICS server
# CANCELLED BY OPERATOR
# program. The DPL_REQUEST command returned an # Explanation: The task that called the DSNACICS
# unexpected value in the DPL_RETAREA. See CICS # stored procedure was cancelled by the operator.
# External Interfaces Guide and CICS/ESA Application
# Programming Guide for a full description of the # Severity: 12
# meanings of FIELD1, FIELD2, and FIELD3. # System Action: DSNACICS terminates immediately.
# Severity: 12 # The CICS server program might have been called.
# System Action: Stored procedure DSNACICS # Programmer Response: Contact the system
# processes the next request. # programmer.
# Programmer Response: Correct any errors in the # System Programmer Response: Determine why the
# server program. Contact the system programmer. # operator cancelled the stored procedure task.
# System Programmer Response: Add a DSNDUMP
# DD statement to the JCL startup procedure for the # DSNA311I DSNACICS ABNORMALLY
# stored procedure address space in which DSNACICS # TERMINATED
# runs. Then rerun the application that calls DSNACICS. # Explanation: The task that called the DSNACICS
# This causes DB2 to generate an SVC dump whenever it # stored procedure abnormally terminated.
# issues an error message for DSNACICS.
# Severity: 12
# If you suspect an error in the DB2 stored procedure,
# refer to Part 3 of DB2 Diagnosis Guide and Reference. # System Action: DSNACICS terminates immediately.
# Collect the following diagnostic items listed in # The CICS server program might have been called. An
# “Appendix B. Problem determination” on page 1281: 1, # SVC dump or a SYSMDUMP is generated for this error.
# 2, 22. # If a CICS service encountered an error, a SYSMDUMP
# might be generated. For an abend in the stored
# procedure, an SVC dump is generated.
# DSNA309I UNABLE TO LOAD USER EXIT
# DSNACICX. SYSTEM REASON # Programmer Response: Contact the system
# CODE=X'hhhh' SYSTEM COMPLETION # programmer.
# CODE=X'hhhh' # System Programmer Response: Review the JES
# Explanation: DSNACICS was unable to load the user # messages for the stored procedure address space in
# exit routine DSNACICX. # which DSNACICS runs. Look for CICS or system
# messages that describe the source of the problem.
# Severity: 12
# If you suspect an error in the DB2 stored procedure,
# System Action: The stored procedure DSNACICS # refer to Part 3 of DB2 Diagnosis Guide and Reference.
# does not call the CICS transaction. DSNACICS # Collect the following diagnostic items listed in
# processes the next request. # “Appendix B. Problem determination” on page 1281: 1,
# Programmer Response: Contact the system # 2, 22.
# programmer.
# System Programmer Response: Ensure that the # DSNA312I USER EXIT DSNACICX ABNORMALLY
# STEPLIB statement in the startup procedure for the # TERMINATED
# stored procedure address space specifies the library # Explanation: User exit program DSNACICX
# that contains DSNACICX. A default user exit is shipped # abnormally terminated.
# in the SDSNLOAD DB2 library.
# Severity: 12
# Add a DSNDUMP DD statement to the JCL startup
# procedure for the stored procedure address space in # System Action: DSNACICS terminates immediately.
# which DSNACICS runs. Then rerun the application that # The CICS server program is not called. An SVC dump
# calls DSNACICS. This causes DB2 to generate an SVC # is generated for this error.
# dump whenever it issues an error message for # Programmer Response: Contact the system
# DSNACICS. # programmer.
# If you suspect an error in the DB2 stored procedure, # System Programmer Response: Determine why the
Chapter 4. DB2 Messages 141
DSNA313I • DSNA8xx
# user exit abended. If you suspect an error in the DB2
DSNA8xx
# stored procedure, refer to Part 3 of DB2 Diagnosis
# Guide and Reference. Collect the following diagnostic Explanation: Messages in the DSNA800 series are
# items listed in “Appendix B. Problem determination” on intended for diagnosis and are documented in Part 8 of
# page 1281: 1, 2, 22. DB2 Diagnosis Guide and Reference.
# DSNA313I DSNACICS TERMINATED BY DB2
# CANCEL THREAD COMMAND
# Explanation: The stored procedure DSNACICS
# terminated because the operator issued the DB2
# CANCEL THREAD command.
# Severity: 12
# System Action: DSNACICS terminates immediately.
# The CICS server program might have been called.
# Programmer Response: Contact the system
# programmer.
# System Programmer Response: Determine why the
# operator issued the DB2 CANCEL THREAD command.
# DSNA314I UNABLE TO LOAD CICS STUB
# ROUTINE DFHXCSTB. SYSTEM
# REASON CODE=X'hhhh' SYSTEM
# COMPLETION CODE=X'hhhh'
# Explanation: DSNACICS was unable to load the CICS
# stub routine DFHXCSTB.
# Severity: 12
# System Action: The stored procedure DSNACICS
# does not call the CICS transaction. DSNACICS
# processes the next request.
# Programmer Response: Contact the system
# programmer.
# System Programmer Response: Ensure that the
# STEPLIB statement in the startup procedure for the
# stored procedure address space specifies the CICS
# library that contains DFHXCSTB. DFHXCSTB is in the
# CICS EXCI library (SDFHEXCI). This library must be
# APF authorized.
# Add a DSNDUMP DD statement to the JCL startup
# procedure for the stored procedure address space in
# which DSNACICS runs. Then rerun the application that
# calls DSNACICS. This causes DB2 to generate an SVC
# dump whenever it issues an error message for
# DSNACICS.
# If you suspect an error in the DB2 stored procedure,
# refer to Part 3 of DB2 Diagnosis Guide and Reference.
# Collect the following diagnostic items listed in
# “Appendix B. Problem determination” on page 1281: 1,
# 2, 22.
142 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 5. DSNB... Messages
System Programmer Response: To determine the
DSNB200I UPDATE VVDS FAILED. DSNAME =
cause of the error, refer to system message IEC161I in
dsn, MMRC=cccccccc
the appropriate MVS publication. Correct the error, and
CONNECTION-ID=xxxxxxxx,
reinvoke the application.
CORRELATION-ID=yyyyyyyyyyyy,
LUW-ID=logical-unit-of-work-id =token Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
Explanation: DB2 was unable to update the data set
determination” on page 1281: 1, 5, 10, 12.
high-used RBA in the VSAM volume data set (VVDS)
when it was ready to close a data set that was used by
a RECOVER, LOAD, or REORG utility job. The error DSNB207I DYNAMIC ALLOCATION OF DATA SET
was detected by the media manager catalog update FAILED. REASON = rrrr DSNAME = dsn
function that issues system message IEC161I. The dsn
indicates the DSNAME of the data set. MMRC is the Explanation: A required data set of a DB2 table or
return code that DB2 received from the media manager index space could not be allocated. Reason code rrrr,
catalog update service. Refer to DFSMS/MVS: which is returned by dynamic allocation, indicates the
Diagnosis Reference for DFSMSdfp for a description of reason for the failure. Refer to the appropriate MVS
these codes. publications for a description of this reason code. The
dsn indicates the data set’s DSNAME.
The connection ID, correlation ID, and
logical-unit-of-work ID (LUW-ID) identify the user or After being issued for a given data set, this message is
application that encountered the problem. disabled for that data set.
An LUW-ID of '*' indicates that the thread does not have This message is issued by the following CSECT:
an LUW-ID. If the LUW-ID is not an '*', the value is a DSNB1OST
logical-unit-of-work-id that is assigned to the thread System Action: Buffer manager functions that detect
followed by an '=' sign and a token value which can be this condition terminate and pass a unique error return
used in place of logical-unit-of-work-id in any DB2 code.
command that accepts logical-unit-of-work-id as input.
Operator Response: Notify the system programmer.
System Action: DB2 continues closing this data set.
However, the utility job is informed with a 00C2010C System Programmer Response: Correct the
'resource unavailable' reason code. The utility job is left situation, and then reinvoke the application.
in a failed state. Problem Determination: Collect the following
Operator Response: Notify the system programmer. diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 1, 5, 10, 12.
System Programmer Response: To determine the
cause of the error, refer to system message IEC161I in
the appropriate MVS publication. Correct the error, and DSNB209I csect-name–BUFFER MANAGER
then notify the user to reinvoke the application. TABLESPACE/INDEXSPACE
CLEAN–UP ROUTINE (DSNB1CFC)
Problem Determination: Collect the following HAS BEEN SCHEDULED FOR DBNAME
diagnostic items listed in “Appendix B. Problem = dbn, SPACENAME = spn, PSID =
determination” on page 1281: 1, 10, 11. X'psid'
Explanation: DB2 detected an abnormal condition for
DSNB204I OPEN OF DATA SET FAILED. DSNAME one of the following reasons:
= dsn v The associated table space or index space contains
Explanation: A required data set of a DB2 table or modified pages that cannot be written to DASD for a
index space could not be opened. The error was period of time that is longer than expected. This can
detected by the media manager CONNECT function be caused by either an unusually long period of
that issues system message IEC161I. The dsn indicates contiguous update or by an internal logic error.
the DSNAME of the data set. v This message follows an abnormal termination due to
inconsistent data or an incomplete update to the
After being issued for a given data set, this message is page.
disabled for that data set.
System Action: Buffer manager functions that detect DB2 scheduled the table space or index space cleanup
this condition terminate. routine (DSNB1CFC) for the associated table space or
index space. DSNB1CFC acquires a drain lock to
Operator Response: Notify the system programmer. ensure that no updates are in progress. Data is
inaccessible to users during the cleanup process.
© Copyright IBM Corp. 1982, 2001 143
DSNB212I • DSNB219I
For recoverable inconsistent pages with unbalanced
DSNB215I csect-name–ONLINE RECOVERY FOR
write intents, DB2 initiates the recovery process and
AN INCONSISTENT PAGE HAS BEEN
reconstructs the pages using the DB2 log. For other
COMPLETED FOR DBNAME = dbn ,
modified pages with unbalanced write intents, the buffer
SPACENAME = spn , PAGE NUMBER =
manager forces the pages to be written back to DASD
X'pno'
and then makes the buffer space available for
reassignment. Explanation: The recovery process for an inconsistent
page completed. The dbn indicates the associated
The dbn indicates the database name with which the database name. The spn indicates the table space
table space or index space is associated. The spn is the name or index space name. The pno is the page
name of the table space or index space that must be number (in hexadecimal) within the table space or index
cleaned up. The psid is the internal identifier for the space that was logically inconsistent.
table space or index space; it is used to associate this
System Action: Processing continues.
message with follow-on message DSNB221I, which
might be issued.
DSNB217I csect-name–ONLINE RECOVERY FOR
System Action: DB2 is ready to clean up the
AN INCONSISTENT PAGE WAS
associated table space or index space. However, before
UNSUCCESSFUL FOR DBNAME = dbn ,
any cleanup is initiated, DB2 requests a drain on the
SPACENAME = spn , PAGE NUMBER =
table space or index space. DB2 waits indefinitely for
X'pno'
this lock. Therefore, all activities against the table space
and/or index space must be quiesced before the Explanation: The recovery process for an inconsistent
cleanup process can proceed. If the associated object is page failed. The page is written to DASD as logically
an index space, all activities against the table space for inconsistent. This message is issued in response to
which the index space is defined must also be message DSNB212I, which was issued to indicate the
quiesced. After the cleanup process completes, the start of the recovery process. The dbn indicates the
table space or index space is automatically made associated database name. The spn indicates the table
accessible to users. space name or index space name. The pno is the page
number (in hexadecimal) within the table space or index
User Response: If the clean up activity does not
space that was logically inconsistent.
appear to be completed, DB2 might still be waiting for a
drain lock on the table space. Issue a -DISPLAY System Action: The page is marked as logically
DATABASE CLAIMERS command for the table space in inconsistent and is unavailable until it is repaired. The
question (for index spaces, this would be the associated execution unit driving this function proceeds normally.
table space) to determine whether the clean up routine
Problem Determination: A DSNI012I message might
is still waiting for a lock and if so, to determine the
be issued before this message to indicate the same
holders of the table space lock. If the jobs are holding
failure. If it is, a 00C90102 abend dump might help
the table space lock for a very long duration (for
determine the cause of this failure. Otherwise, see
instance, wait-for-input), it might be necessary to cancel
SYS1.LOGREC for any abend that occurred between
those jobs in order to allow the clean up process to
the associated DSNB212I message and this message.
proceed.
Use the time stamp on the log records to find this
abend.
DSNB212I csect-name–RECOVER PAGE
STARTING DBNAME = dbn ,
DSNB219I csect-name–BUFFER MANAGER
SPACENAME = spn , PAGE NUMBER =
TABLESPACE/INDEXSPACE
X'pno'
CLEAN–UP PROCESS HAS BEEN
Explanation: The buffer manager (BM) subcomponent COMPLETED FOR DBNAME = dbn ,
of DB2 discovered an inconsistent page with SPACENAME = spn
unbalanced write intents. DB2 is ready to do online
Explanation: This message indicates that the buffer
recovery on the page using the DB2 log. The dbn
manager (BM) table space or index space cleanup
indicates the associated database name. The spn
process completed for the associated table space or
indicates the table space name or index space name.
index space. Refer to message DSNB209I for the
The pno is the page number (in hexadecimal) within the
reasons why the buffer manager schedules the table
table space or index space that is logically inconsistent.
space or index space cleanup process. The dbn
System Action: Processing continues. indicates the associated database name. The spn
indicates the table space name or index space name.
System Action: Processing continues.
144 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB221I • DSNB224I
DSNB221I csect-name–BUFFER MANAGER DSNB224I csect-name– BUFFER MANAGER I/O
TABLESPACE/INDEXSPACE ERROR DURING function,
CLEAN–UP PROCESS WAS NOT DBNAME=dbn,SPACENAME=snm, DATA
REQUIRED FOR PSID = X'psid' SET NUMBER=dsno, PAGE
NUMBER=X'pno', MM ERROR
Explanation: This message indicates that the buffer
FLAG=X'aa', CSW STATUS=X'bbbb',
manager (BM) table space or index space cleanup
SENSE BYTES=X'cccc', SEEK
process was bypassed for the associated table space or
ADDRESS=X'dddddddddddddddd'
index space. After quiescing all other activities against
the table space or index space, the buffer manager Explanation: An I/O error was encountered by the
discovered that the table space or index space is no buffer manager (BM) subcomponent of DB2. The
longer in active mode; that is, it was closed. function specified in the message is READ, WRITE, or
FORMAT. The message gives the database name, table
The abnormal condition detected earlier was resolved
space name or index space name, data set number,
by buffer manager close page set processing. Refer to
and page number (in hexadecimal) of the page for
the corresponding message, DSNB209I, using psid as
which the I/O operation was being performed. The
the matching field, for the reasons the buffer manager
remaining information is error information returned by
schedules the table space or index space cleanup
the media manager and is used for error analysis by
process. The psid is the internal identifier for the
IBM support personnel.
associated table space or index space.
System Action: The system action depends on the
System Action: Processing continues.
function being performed. If the function is WRITE, or if
the function is READ and the operation was performed
DSNB223I csect-name–BUFFER MANAGER during restart or rollback, the I/O error page range of
TABLESPACE/INDEXSPACE CLEANUP the data set is updated and message DSNU086I is
PROCESS WAS SKIPPED FOR PSID = issued. In most cases (READ, synchronous WRITE,
X'psid' FORMAT), a 'resource not available' is returned to the
user with a reason code that identifies the nature of the
Explanation: This message indicates that the table problem.
space or index space cleanup process was bypassed
for the associated table space or index space. During After being issued 10 times for a given data set, this
the process of quiescing all other activities against the message is disabled for that data set until it is closed
table space or index space, an error that is not and reopened.
recoverable was detected. The error might be caused
Operator Response: Notify the system programmer.
by any of the following conditions:
v An out-of-storage condition was detected by IRLM. System Programmer Response: See documentation
v The table space or index space was dropped in “Part 4. DB2 Codes” on page 707 for the reason code
because of a backout. returned to the user in the SQLCA or in utility
messages. If you suspect an error in DB2, refer to Part
It is assumed that the abnormal condition detected 2 of DB2 Diagnosis Guide and Reference for
earlier can later be resolved by the close page set information on identifying and reporting the problem.
processing. Refer to the corresponding message
Problem Determination: See the Problem
DSNB209I (use psid as the matching field) for the
Determination section of the reason code returned to
reasons for scheduling the table space or index space
user.
cleanup process. The psid specifies the internal
identifier for the associated table space or index space. Check the MVS console log for an IOS error message
indicating the type of I/O error that occurred. If an IOS
System Action: Processing continues.
message was issued, follow the problem determination
System Programmer Response: The associated directions for that message.
table space or index space might contain inconsistent
Collect the following diagnostic items listed in
data. Issue the DB2 STOP TABLESPACE or
“Appendix B. Problem determination” on page 1281: 1,
INDEXSPACE command to allow close page set
5.
processing to perform cleanup for the associated table
space or index space.
Chapter 5. DB2 Messages 145
DSNB225I • DSNB228I
System Programmer Response: If you suspect an
DSNB225I csect-name - BUFFER MANAGER I/O
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
ERROR DURING function
and Reference for information on identifying and
DBNAME=dbn,SPACENAME=snm, DATA
reporting the problem.
SET NUMBER=dsno, MM ERROR
CODES=X’aaaaaaaa’ DB2 REASON Problem Determination: This message is issued
CODE=X’bbbbbbbb’ before the occurrence of abend X'04E' and reason code
00C200F7 to provide information about the page set
Explanation: DB2 encountered an I/O error. The
involved.
function specified in the message is READ, WRITE,
CASTOUT, or FORMAT. The message contains the Collect the following diagnostic items listed in
database name, table space name or index space “Appendix B. Problem determination” on page 1281: 1,
name, data set number, media manager error 2, 5, 10, 12, 64.
information returned at the time of the failure, and the
DB2 reason code associated with this failure.
DSNB227I csect-name - DFHSM RECALL FAILED
System Action: Except for a castout error, the FOR DSNAME=dsn HSMRC=aaaaaaaa
application terminates with abend X'04E' and reason HSMRSN=bbbbbbbb
code 00C200A4 or 00C200C0. If an error occurs during
castout, processing continues. Explanation: The attempt to recall a migrated data set
failed. DSNAME identifies the data set. HSMRC and
Operator Response: Notify the system programmer HSMRSN are the return code and reason code given by
and follow the directions given for the reason code DFHSM.
described in “Part 4. DB2 Codes” on page 707.
System Action: A 'resource not available' code is
System Programmer Response: If you suspect an returned to the user.
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and Operator Response: Notify the system programmer.
reporting the problem. System Programmer Response: Use the information
Problem Determination: This message is issued provided in the message to determine the reason for the
before the occurrence of abend X'04E' and reason code DFHSM recall failure.
00C200A4 or 00C200C0 to provide information related Problem Determination: Refer to “Part 4. DB2 Codes”
to the media manager failure. on page 707 for an explanation of the return and
Check the MVS console log for an IOS error message reason codes contained in this message. Refer to the
indicating the type of I/O error that occurred. If an IOS DFHSM message ARC11nnI, where nn is the value of
message was issued, follow the problem determination HSMRC.
directions for that message.
Collect the following diagnostic items listed in DSNB228I csect-name GROUP BUFFER POOL
“Appendix B. Problem determination” on page 1281: 1, gbpname CANNOT BE ACCESSED FOR
2, 5, 10, 12. function MVS IXLCACHE REASON
CODE=reason
DSNB226I csect-name - BUFFER MANAGER PAGE Explanation: While accessing group buffer pool
GET ROUTINE DETECTED AN INVALID gbpname for function function DB2 received an error
PAGE IN DBNAME=dbn, from the MVS IXLCACHE request.
SPACENAME=snm, DATA SET function
NUMBER= dsno, PAGE READ or WRITE
EXPECTED=X’aaaaaa’, PAGE
RECEIVED=X’bbbbbb’ reason Reason code from the MVS IXLCACHE
request
Explanation: An unexpected page was received
during buffer manager (BM) get page processing. The System Action: The system action depends on the
page set involved is identified by the database name, function being performed. If the function is a WRITE, or
space name, and data set number. The page in error is a READ performed during rollback or DB2 restart, the
identified by page expected aaaaaa. Page number page is added to the logical page list (LPL) for the data
bbbbbb was found in the buffer that should contain the set and message DSNB250E is issued. Otherwise,
expected page. 'resource unavailable' is returned to the user with a
reason code that identifies the specific problem.
System Action: The application is terminated with
abend X'04E' and reason code 00C200F7. System Programmer Response: See MVS/ESA
Programming: Sysplex Services Reference for an
Operator Response: Notify the system programmer explanation of the MVS IXLCACHE reason code.
and follow the directions given for reason code
00C200F7 in “Part 4. DB2 Codes” on page 707
146 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB229I • DSNB232I
xlvlid The level ID recorded by DB2 previously and is
DSNB229I csect-name UNEXPECTED ERROR
the expected level ID for opening the data set
WHEN CHECKING FOR REQUEST
COMPLETION FOR GROUP BUFFER dsn The DSNAME of the data set.
POOL gbp-name MVS IXLFCOMP
REASON CODE=reason This problem could be the result of data sets that were
Explanation: DB2 received an unexpected error from restored to a level that is inconsistent with other data
MVS when checking for the completion of a write sets, inconsistent with the DB2 log, or both.
request to the secondary group buffer pool for System Action: DB2 sends back a 'resource
duplexing. gbp-name indicates the name of the group unavailable' SQL code to the application and a reason
buffer pool. If the group buffer pool is duplexed and the code explaining the error.
error was encountered on a request to the secondary
group buffer pool, then gbp-name indicates the name of Operator Response: Notify the system programmer.
the group buffer pool suffixed with ’-SEC’. System Programmer Response: To enable access to
reason is the reason code from the MVS IXLFCOMP a data set reported as down level, take one of the
service. following actions:
v Restore the page set or partition to the proper level
System Action: DB2 returns the group buffer pool
(use DSN1COPY, DFHSM, or another tool).
back to simplex mode. The secondary group buffer pool
is deallocated. Identify the level ID of a copy of the page set or
partition by running the DSN1PRNT(FORMAT) utility.
System Programmer Response: See MVS/ESA The level ID is found in the header page of the page
Programming: Sysplex Services Reference for an set or partition.
explanation of the MVS IXLFCOMP reason code.
v Recover the down level page set or partition to
currency by running the RECOVER or RECOVER
DSNB230I A SHARED OWNING SYSTEM CANNOT LOGONLY utility.
CONNECT A SHARED DATASET IN v Accept the down levelling by running the REPAIR
OUTPUT MODE. DSN=dsn utility with the LEVELID option.
Explanation: A required inter-system sharing data set | This option is only valid if DB2 is able to access the
of a DB2 table or index space could not be opened in | level ID (lvlid is not ″X’’″).
output mode. The error was detected by the media Inconsistent data problems might result from this
manager CONNECT function, which issues system action and are the user’s responsibility.
message IEC161I. The dsn is the DSNAME of the data
v Replace the contents of the page set or partition
set.
using the LOAD REPLACE utility.
v Explicitly restore the page set to a prior point in time
DSNB231I A SHARED DATASET CANNOT BE with the RECOVER utility.
CONNECTED IN INPUT MODE.
DSN=dsn If the expected level ID is less than the encountered
Explanation: A required inter-system sharing data set level ID, it is possible that the object identified in the
of a DB2 table or index space could not be opened in message was ported from another system improperly or
input mode. The error was detected by the media it might indicate that DSNDB01.SYSLGRNX is down
manager CONNECT function, which issues system level. If the problem is in the object identified in the
message IEC161I. The dsn is the DSNAME of the data message, the actions listed above can be used to allow
set. access to the data. If the problem is in SYSLGRNX, this
is a serious situation that compromises the
recoverability of all objects managed by DB2.
DSNB232I csect-name - UNEXPECTED DATA SET Investigate whether SYSLGRNX might have
LEVEL ID ENCOUNTERED - LEVEL ID inadvertently been restored to a point in time
=lvlid EXPECTED LEVEL ID=xlvlid inconsistent with the rest of the DB2 system.
DSN=dsn
Explanation: A required data set of a DB2 table space
could not be opened. DB2 encountered an unexpected
data set level ID.
| lvlid The unexpected level ID from the data set. If
| DB2 was unable to retrieve the level ID from
| the data set (for example, if the data set had
| been deleted and redefined), the level ID is
| shown as ″X’’″.
Chapter 5. DB2 Messages 147
DSNB250E • DSNB302I
System Action: If the connection was requested on
DSNB250E csect-name A PAGE RANGE WAS
behalf of an access request by an SQL user on this
ADDED TO THE LOGICAL PAGE LIST
DB2, SQLCODE -904 (resource unavailable) is returned
DATABASE NAME = dbn SPACE NAME
to the SQL user with the DB2 reason code shown in
= spn DATA SET NUMBER = dsno PAGE
this message.
RANGE = lowpg TO highpg START
LRSN = startlrsn END LRSN = endlrsn If the connection was requested on behalf of an SQL
START RBA = startrba user on another DB2 in the data sharing group,
SQLCODE -904 (resource unavailable) is returned to
Explanation: DB2 added a page range to the logical
the SQL user with DB2 reason code 00C20252. This
page list (LPL) for the specified data set because of a
indicates that the requested table space or index space
problem with the pages in the page range. The startlrsn
is unavailable because another DB2 cannot connect to
and endlrsn give the log range needed to recover the
the group buffer pool.
pages in the page range. These values are RBA values
unless DB2 is in the data sharing environment, in which If the MVS IXLCONN reason code is xxxx0C08
case these values are LRSN values. In the data sharing (structure allocation failed because there was no
environment, startrba indicates the starting RBA value of suitable facility to allocate based on the preference list
the recovery log range if the value is not zero. The in the MVS CFRM administrative policy), or if the MVS
startrba only applies to log records for the DB2 member IXLCONN reason code is xxxx084C (user does not
that issued the message.The zero value for endrba or have proper Security Access Facility (SAF)
endlrsn in this message refers to the current end of the authorization), then IFCID 0250, if active, contains
recovery log. additional diagnostic information.
System Action: The page range is added to the LPL
for the page set. The page remains inaccessible until it DSNB302I csect-name GROUP BUFFER POOL
is recovered with either the START DATABASE gbpname IS ALLOCATED IN A
command with the SPACENAM option, the RECOVER VOLATILE STRUCTURE
utility, or the LOAD utility. Users attempting to access a
page in the LPL receive SQLCODE -904 with reason Explanation: The DB2 group buffer pool structure is
code 00C20206. If MVS detects a problem during group volatile.
buffer pool access processing, DB2 writes a One DB2 member issues this message whenever the
SYS1.LOGREC entry describing the error. structure has the volatile attribute. DB2 detects this
System Programmer Response: To recover pages either on the first connection to the group buffer pool or
from the LPL, use the -START DATABASE command when the attribute changes later. DB2 always requests
with the SPACENAM option, the RECOVER utility, or nonvolatile group buffer pools but allows allocation in a
the LOAD utility. volatile structure if that is all that is available.
System Action: DB2 processing continues.
DSNB301E csect-name GROUP BUFFER POOL System Programmer Response: To cause the group
gbpname CANNOT BE CONNECTED buffer pools to be allocated in nonvolatile coupling
DB2 REASON CODE = reason1 MVS facilities, ensure that:
IXLCONN REASON CODE = reason2
v At least a subset of your coupling facilities are
Explanation: DB2 was not able to connect to the configured correctly for nonvolatility.
named group buffer pool. This message is generally v The MVS CFRM policy correctly specifies the
issued once for each DB2 subsystem for each DB2 nonvolatile coupling facilities in the preference list for
reason code, except 00C20204, until the failure the group buffer pool coupling facility structures.
condition is corrected.
reason1 Even when these things are correctly done, there might
DB2 reason code be instances when a suitable coupling facility in the
preference list cannot be found (for example, not
reason2 enough free space), and therefore allocation occurs in a
MVS IXLCONN reason code different coupling facility. MVS tries to allocate the
structure in the facility that best meets the structure
For DB2 reason code 00C20204, which indicates a allocation request as follows:
problem during MVS IXLCONN processing, this
message is issued once for each DB2 subsystem for 1st choice:
each IXLCONN reason code until the failure condition is Coupling facility that meets the volatility
corrected. If the DB2 reason code is not 00C20204, requirement, the space requirement, and the
then reason2 contains zeros. See MVS/ESA exclusion list requirement.
Programming: Sysplex Services Reference for an 2nd choice:
explanation of MVS IXLxxxx reason codes Coupling facility that meets the volatility
requirement and the storage requirement.
148 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB303E • DSNB306I
3rd choice:
DSNB305I csect-name ’DAMAGE ASSESSMENT
Coupling facility that has the best fit (most
PENDING’ STATUS WAS CLEARED
available free space) even though this might be
FOR GROUP BUFFER POOL gbpname
less than the amount requested.
Explanation: Damage assessment completed and the
4th choice:
'damage assessment pending' (DAP) status is cleared
Structure cannot be allocated.
for the group buffer pool (GBP). At this point, the group
buffer pool status is no longer restricted and DB2
IFCID 0250, if activated, contains a list of the coupling attempts to reconnect to the group buffer pool on the
facilities on which allocation was attempted. next reference to a GBP-dependent page set within the
associated buffer pool.
DSNB303E csect-name A LOSS OF CONNECTIVITY Message DSNB304I precedes this message.
WAS DETECTED TO GROUP BUFFER
POOL gpbname
DSNB306I csect-name THE REQUESTED LENGTH
Explanation: Connectivity to group buffer pool OF THE LOCAL CACHE VECTOR
gpbname was lost. COULD NOT BE ALLOCATED FOR
System Action: DB2 disconnects from the coupling GROUP BUFFER POOL gbpname
facility structure with REASON=FAILURE. REQUESTED LENGTH = length1
ALLOCATED LENGTH = length2
The action taken in response to this problem depends
on the attempted function, as follows: Explanation: DB2 connected to the group buffer pool
indicated by gbpname, but the MVS Cross-system
v For a coupling facility read: SQLCODE -904
Extended Services (XES) component could not allocate
(resource unavailable) is returned to the SQL user
the requested size of the local cache vector (LCV) in
with a reason code indicating the specific error.
the hardware system area (HSA). DB2 requires an LCV
v For a coupling facility read during rollback, backout, size that is large enough to handle all pages in the
or restart: The inaccessible page is added to the member’s buffer pool (virtual pool and hiperpool
logical page list (LPL) for the page set. Message combined).
DSNB250E is issued for the first page of each data
set added to the LPL. length1 indicates the LCV size (in number of bits) that
DB2 requested. length2 indicates the LCV size (in
v For a coupling facility read during castout: The
number of bits) that XES was able to allocate.
castout operation cannot complete.
v For a coupling facility write: The changed page is To prevent flooding the operator console, this message
added to the LPL for the page set. is only issued once per DB2 member per group buffer
pool until the condition is corrected.
DSNB304I csect-name GROUP BUFFER POOL System Action: DB2 disconnects from the GBP and
gbpname WAS SET TO ’DAMAGE issues message DSNB301E with reason code
ASSESSMENT PENDING’ STATUS 00C20208, if it has not yet been issued.
Explanation: A coupling facility structure for a group SQLCODE -904 is returned to the user with a reason
buffer pool was damaged. code of 00C20208.
System Action: System Programmer Response: There is not enough
HSA storage on the processor to support the size of the
v DB2 puts the group buffer pool into 'damage
local cache vector. The details of HSA allocation are
assessment pending' (DAP) status. Message
machine-dependent and are defined by the hardware.
DSNB304I indicates the DAP status. The group
To correct this problem, take one or both of the
buffer pool cannot be accessed until DAP status is
following actions:
cleared.
v Consult the documentation for your processor
v The DB2 damage assessment process determines
hardware to determine if the HSA storage allocation
which table spaces and index spaces are using the
can be increased, and if so, how to do it.
failed group buffer pool and puts those spaces into
'group buffer pool recovery pending' (GRECP) status. v Modify the software configuration in your parallel
sysplex to reduce the number or size of the vectors
v After DB2 sets all the necessary spaces to GRECP
that are in use by other coupling facility structure
status, the DAP status for the group buffer pool is
users. Consider the following possible solutions:
cleared. Message DSNB305I indicates that DAP
status is cleared. – Use the DB2 ALTER BUFFERPOOL command to
reduce the size of this local buffer pool. This
means you might have to reduce or eliminate the
hiperpool or reduce the size of the virtual pool.
Chapter 5. DB2 Messages 149
DSNB307I • DSNB310I
– Use the DB2 ALTER BUFFERPOOL command to
DSNB308I csect-name GROUP BUFFER POOL
reduce the size of another local buffer pool that is
gbpname WAS SUCCESSFULLY
already connected to a group buffer pool. This
ALLOCATED BUT THE ALLOCATED
means that you might have to reduce or eliminate
SIZE OF alloc_size IS LESS THAN THE
the hiperpool, or reduce the size of the virtual
REQUESTED SIZE OF req_size
pool. If you make a connected buffer pool smaller,
DB2 can usually contract the size of the Explanation: DB2 successfully connected to the group
corresponding LCV dynamically, making HSA buffer pool and allocated the group buffer pool in a
storage available. However, DB2 cannot always coupling facility. However, the allocated size of the
do the dynamic LCV contraction; this is especially group buffer pool was less than the requested size in
true if there is a hiperpool. In cases where DB2 the MVS CFRM administrative policy because there is
cannot dynamically contract the LCV size, you can not enough space in the preference list facilities. Both
use the DB2 ALTER BUFFERPOOL command to alloc_size and req_size are in 4KB blocks.
either force a deallocation of the LCV or to force a
System Programmer Response: IFCID 0250
contraction of the LCV as follows:
provides information about which coupling facilities were
1. Delete the hiperpool, if it exists. used for attempted allocation.
2. Take one of the following actions:
a. Make the virtual pool very small (perhaps DSNB309I csect-name GROUP BUFFER POOL
50 pages or less). Making the virtual pool gbpname HAS BEEN DISCONNECTED
sufficiently small should let DB2 WITH A REASON OF ’reason’
dynamically contract the LCV, or
Explanation: DB2 disconnected from the named
b. Delete the virtual pool to let DB2
group buffer pool.
disconnect from the group buffer pool. This
frees the entire LCV associated with that reason indicates one of the following values:
member’s connection to that group buffer
pool. NORMAL
DB2 disconnected the group buffer pool
3. Redefine the virtual pool to be smaller than the normally. MVS deletes the connection.
original size. If a hiperpool originally existed,
then you can probably restore the virtual pool FAILURE
back to its original size. DB2 disconnected the group buffer pool
– Consolidate your group buffer pool-dependent abnormally. MVS puts the connection into a
page sets into fewer buffer pools to reduce the ’failed-persistent’ state. DB2 disconnects the
number of group buffer pool connections. GBP with a reason of FAILURE when some
type of error has been detected, and castout
– Consult the documentation for the other software processing cannot proceed. Usually the error
components that might be using a coupling facility involves a connectivity failure to either the
cache or list structure with an associated LCV to coupling facility or DASD. This message is
determine whether it is possible to either delete preceded by message DSNB303E, and
the connection or to reduce the size of the LCV probably a series of DSNB311I and DSNB312I
associated with the connection. messages.
DSNB307I csect-name GROUP BUFFER POOL If this message is issued because connectivity was lost
gbpname WAS SUCCESSFULLY to the group buffer pool, this message signifies that this
ALLOCATED BUT THE EXCLUSION DB2 member has completed its processing of the error.
LIST WAS NOT HONORED
System Programmer Response: See the system
Explanation: DB2 successfully connected to the group programmer response for message DSNB311I or
buffer pool and allocated the group buffer pool in a DSNB312I.
coupling facility. However, the group buffer pool was
allocated in a coupling facility containing a structure in
DSNB310I csect-name GROUP BUFFER POOL
the exclusion list.
gbpname IS ALLOCATED IN A
System Programmer Response: If you require that NONVOLATILE STRUCTURE
the exclusion list be honored, you must ensure that
Explanation: The coupling facility storage in which the
there is sufficient space in the coupling facilities that are
group buffer pool is allocated was previously volatile,
not in the exclusion list. IFCID 0250 provides
but is now nonvolatile. For availability reasons, we
information about which facilities were attempted.
recommend that DB2 group buffer pools be allocated in
nonvolatile coupling facility storage. When DB2
connects a group buffer pool, it requests that the
backing coupling facility structure be allocated in
150 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB311I • DSNB314I
nonvolatile storage. If the request for nonvolatile storage connectivity to the coupling facility in which the group
is not honored, DB2 issues message DSNB302I. buffer pool is allocated.
System Action: DB2 processing continues. reason is one of the following:
NOSFMPOL
DSNB311I csect-name DBNAME database SPACE MVS cannot determine the scope of the loss of
NAME spacename HAS PAGES IN THE connectivity because there is no active SFM
LOGICAL PAGE LIST policy with CONNFAIL(YES).
Explanation: This message is issued after a loss of LOSSCONN
connectivity to a group buffer pool was detected. The MVS determined that the scope of the loss of
message indicates that the named table space or index connectivity was less than 100%.
space has one or more pages in the logical page list
NOXESEVL
(LPL) that need to be recovered. This message is
MVS started to try to determine the scope of
issued after DB2 has completed its processing for the
the loss of connectivity, but some condition
table space or index space; this is the earliest point at
occurred which prevented MVS from being
which you can recover LPL pages for that table space
able to complete the evaluation. One example
or index.
of such a condition would be that the SFM
System Action: The pages in the LPL are not policy became inactive while MVS was trying to
accessible until they have been recovered. do the evaluation.
System Programmer Response: Issue the START
If reason is LOSSCONN, then percentage indicates the
DATABASE command with the named table space or
percentage of lost connectivity that was calculated by
index to recover the LPL pages. The START
MVS. MVS evaluates the scope of the loss of
DATABASE command must be issued from a DB2
connectivity in terms of SFM weights associated with
member that can connect to the group buffer pool.
the systems which have lost connectivity and which
Alternatively, the RECOVER utility or the LOAD utility
have active connectors to the coupling facility structure
can be used to recover the LPL pages.
(if there are systems that do not have an active
connector to the coupling facility structure, then those
DSNB312I csect-name DBNAME database SPACE systems are not factored into the ″percentage loss of
NAME spacename PARTITION connectivity″ calculation).
part-number HAS PAGES IN THE
LOGICAL PAGE LIST If reason is not LOSSCONN, then percentage is not
applicable (it should appear as zero).
Explanation: This message is issued after a loss of
connectivity to a group buffer pool was detected. The System Action: The DB2 member disconnects the
message indicates that a partition of the named table group buffer pool, putting its connection into a
space or index has one or more pages in the logical ″failed-persistent″ state.
page list (LPL) that need to be recovered. This
message is issued after DB2 has completed its If there are transactions that are in progress at the time
processing for the partition; this is the earliest point at of the connectivity failure, DB2 might need to add pages
which you can recover the LPL pages for that partition. to the logical page list (LPL).
System Action: The pages in the LPL are not System Programmer Response: Use the START
accessible until they have been recovered. DATABASE command to recover the LPL pages. If
DSNDB01 or DSNDB06 objects have LPL pages, you
System Programmer Response: Issue the START might need to recover these first, before proceeding
DATABASE command on the table space or index with LPL recovery for other objects.
space partition to recover the LPL pages. The START
DATABASE command must be issued from a DB2
member that can connect to the group buffer pool. DSNB314I csect-name DAMAGE ASSESSMENT TO
Alternatively, the RECOVER utility or the LOAD utility BE TRIGGERED FOR GROUP BUFFER
can be used to recover the LPL pages. POOL gpbname REASON=reason
Explanation: DB2 is about to initiate the damage
DSNB313I csect-name GROUP BUFFER POOL assessment function for group buffer pool gpbname
gpbname TO BE DISCONNECTED because of a detected error in either the coupling facility
REASON=reason LOSSCONN in which the group buffer pool was allocated, or in the
PERCENTAGE=percentage connectivity from the MVS systems to the coupling
facility.
Explanation: This DB2 member is disconnecting from
group buffer pool gpbname because it has lost reason is one of the following:
Chapter 5. DB2 Messages 151
DSNB315I • DSNB319A
100%LCON GRECP objects. If DSNDB01 or DSNDB06 objects are
An error has occurred in a coupling facility or in in GRECP state or have LPL pages, you might need to
the attachments of MVS systems to a coupling recover these first, before proceeding with GRECP or
facility which has caused all DB2 members to LPL recovery for other objects.
lose connectivity to the named group buffer
pool.
DSNB315I csect-name GROUP BUFFER POOL
STRFAIL gpbname IS ALLOCATED AS
There was an error in the coupling facility in GBPCACHE cacheatt
which the group buffer pool was allocated
Explanation:
which caused a failure of the coupling facility
structure. YES The group buffer pool will be used for data
caching.
CONERROR
The named group buffer pool is currently NO The group buffer pool will not be used for data
allocated in a coupling facility, but DB2 cannot caching. It will be used for cross invalidation
connect to the group buffer pool because the only.
system on which it is running does not
currently have connectivity, and MVS has One DB2 member issues this message whenever the
indicated that currently no other member is structure is allocated. DB2 detects this on the first
actively connected and has connectivity. connection to the group buffer pool either in the
DAP The named group buffer pool is in damage mainline processing or during group buffer pool rebuild.
assessment pending (DAP) state. System Action: DB2 processing continues.
System Action: DB2 triggers the damage assessment
function to ensure that any changed pages that might DSNB319A csect-name THERE IS A SHORTAGE OF
have been cached in the affected group buffer pool get SPACE IN GROUP BUFFER POOL
marked as ″needing recovery″ (the objects to which the gbp-name
pages belong are marked in GRECP state). This
message should be immediately followed by a Explanation: The amount of storage in the group
DSNB304I message indicating that the group buffer buffer pool (GBP) coupling facility structure available for
pool has been entered into damage assessment writing new pages is low. The GBP is 75 percent full
pending (DAP) state. with changed data. As the GBP fills with changed data,
the castout thresholds are continuously reached, and
If there are transactions that are in progress at the time the castout engines must continuously work to attempt
of the connectivity failure, DB2 might need to add pages to keep the number of changed pages in the GBP
to the logical page list (LPL). below the castout thresholds. Also, the more changed
There is one case where DB2 triggers damage data the GBP contains, the less efficiently it operates.
assessment for a group buffer pool, but no DSNB314I Completely running out of GBP storage can result in
message is issued. This case is where the group buffer transaction delays and in pages being added to the
pool was manually deleted (via MVS SETXCF FORCE logical page list (LPL).
commands) while all connections to the group buffer This message stays on the MVS console and is
pool were failed-persistent (e.g. all DB2 members were highlighted.
down). In this case, the next DB2 member to connect to
the group buffer pool will cause MVS to try to reallocate System Action: DB2 processing continues.
a new instance of the group buffer pool in some This message might remain highlighted and might not
coupling facility in the CFRM policy preference list. If the be automatically deleted in a pre SP5.2.1-JES3
allocation succeeds, then DB2, by doing a coupling environment.
facility structure version id comparison, will detect that
the previous instance of the group buffer pool had been Operator Response: Contact the system programmer
lost, and will trigger damage assessment. But you will to fix the storage problem.
not receive the DSNB314I message in this case, nor will System Programmer Response:
you receive the DSNB304I or DSNB305I messages
indicating that the group buffer pool has been put into You can relieve the GBP storage shortage by taking
damage assessment pending (DAP) state. You will only one or more of the following actions:
receive a series of DSNB322I and/or DSNB323I v Use the ALTER GROUPBUFFERPOOL command to
messages indicating those pagesets or partitions that lower the CLASST and GBPOOLT castout thresholds.
have been put into GRECP state by the damage
v Use the ALTER GROUPBUFFERPOOL command to
assessment process.
lower the GBPCHKPT GBP checkpoint frequency.
System Programmer Response: Use the START v Use the MVS SETXCF START,REBUILD command
DATABASE command to recover the LPL pages and to expand the GBP coupling facility structure. If you
152 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB320I • DSNB323I
rebuild, you can use the ALTER command on the table space or index space to remove
GROUPBUFFERPOOL command to lower the RATIO the GRECP status and make the data accessible. You
so that a higher percentage of the GBP storage is can also use the RECOVER or LOAD utility with the
given to data entries over directory entries. REPLACE option to clear the GRECP status.
v If you are running on MVS 5.2 or a subsequent
release, you can use the MVS SETXCF DSNB322I csect-name - TABLE SPACE OR INDEX
START,ALTER command to expand the size of the SPACE WITH DBID X’dbid’ PSID X’psid’
GBP (the maximum size to which you can expand is PARTITION part-number IN GROUP
determined by the SIZE parameter in the CFRM BUFFERPOOL gbpname IS IN GROUP
policy that was used to allocate the GBP). BUFFERPOOL RECOVERY PENDING
STATE AND CANNOT BE
If you don’t do anything to relieve the storage shortage, AUTOMATICALLY RECOVERED
message DSNB325A appears if the GBP reaches 90
percent full. Explanation: This message reports the group buffer
pool recovery pending (GRECP) status of the table
Message DSNB327I appears when the GBP storage space or index space partition identified by the internal
shortage is relieved. identifiers DBID and PSID. This message is issued
instead of message DSNB320I when the name of the
table space or index space is not available. The
You can monitor the amount of GBP storage in use with
partition cannot be automatically recovered because
the DISPLAY GBPOOL command and with the DB2
there are retained physical locks (P-locks) on the
statistics trace. Monitor the castout activity to ensure
partition.
that castouts are keeping up with the rate of GBP-write
activity. You can use Performance trace classes 20 and Severity: 4 (warning)
21 (specifically, IFCIDs 0261, 0262 and 0263) to do
more detailed monitoring of the DB2 castout processing. System Action: The data in the identified partition is
not accessible.
DSNB320I csect-name - DBNAME database SPACE User Response: Issue the -DISPLAY DATABASE(*)
NAME spacename PARTITION SPACENAM(*) RESTRICT command to determine the
part-number IN GROUP BUFFERPOOL table spaces or index spaces partition in GRECP status.
gbpname IS IN GROUP BUFFERPOOL First, start the failed DB2 members that hold retained
RECOVERY PENDING STATE P-locks on the partition.Issue the -START DATABASE
command on the partition to remove the GRECP status
Explanation: This message reports the group buffer and make the data accessible again. You can also use
pool recovery pending (GRECP) status of the named the RECOVER or LOAD utility with the REPLACE
table space or index space partition. option to clear the GRECP status.
Severity: 4 (warning)
DSNB323I csect-name - TABLE SPACE OR INDEX
System Action: The data in the named partition is not
SPACE WITH DBID X’dbid’ PSID X’psid’
accessible.
IN GROUP BUFFERPOOL gbpname IS
User Response: Issue the -START DATABASE IN GROUP BUFFERPOOL RECOVERY
command on the partition to remove the GRECP status PENDING STATE AND CANNOT BE
and make the data accessible again. You can also use AUTOMATICALLY RECOVERED
the RECOVER or LOAD utility with the REPLACE
Explanation: This message reports the group buffer
option to clear the GRECP status.
pool recovery pending (GRECP) status of the table
space or index space identified by the internal identifiers
DSNB321I csect-name - DBNAME database SPACE DBID and PSID. This message is issued instead of
NAME spacename IN GROUP message DSNB321I when the name of the table space
BUFFERPOOL gbpname IS IN GROUP or index space is not available. The table space or
BUFFERPOOL RECOVERY PENDING index space cannot be automatically recovered because
STATE there are retained physical locks (P-locks) on the space.
Explanation: This message reports the group buffer Severity: 4 (warning)
pool recovery pending (GRECP) status of the named
System Action: The table space or index space is not
table space or index space.
accessible.
Severity: 4 (warning)
User Response: Issue the -DISPLAY DATABASE(*)
System Action: The table space or index space is not SPACENAM(*) RESTRICT command to determine the
accessible. table spaces or index spaces in GRECP status. First,
start the failed DB2 members that hold retained P-locks
User Response: Issue the -START DATABASE
on the table space or index space.Issue the -START
Chapter 5. DB2 Messages 153
DSNB325A • DSNB330I
DATABASE command on the table space or index activity, and then retry the write to the GBP. If the GBP
space to remove the GRECP status and make the data write still fails after several retry attempts, then DB2
accessible again. You can also use the RECOVER or adds the page to LPL.
LOAD utility with the REPLACE option to clear the
GRECP status. Message DSNB327I appears when the GBP storage
shortage is relieved.
DSNB325A csect-name THERE IS A CRITICAL
SHORTAGE OF SPACE IN GROUP You can monitor the amount of GBP storage in use with
BUFFER POOL gbp-name the DISPLAY GBPOOL command and with the DB2
statistics trace. Monitor the castout activity to ensure
Explanation: The amount of storage in the group that castouts are keeping up with the rate of GBP-write
buffer pool (GBP) coupling facility structure available for activity. You can use Performance trace classes 20 and
writing new pages is critically low. The GBP is 90 21 (specifically, IFCIDs 0261, 0262 and 0263) to do
percent full with changed data. As the GBP fills with more detailed monitoring of the DB2 castout processing.
changed data, the castout thresholds are continuously
reached, and the castout engines must continuously
work to attempt to keep the number of changed pages DSNB327I csect-name GROUP BUFFER POOL
in the GBP below the castout thresholds. In addition, gbp-name HAS ADEQUATE FREE
the more the GBP is filled with changed data, the less SPACE
efficient are the coupling facility storage management Explanation: The group buffer pool (GBP) coupling
algorithms. Completely running out of GBP storage can facility structure has adequate space available for the
result in transaction delays and in pages being added to writing of new pages to the GBP.
the logical page list (LPL).
This message may be issued when either of the
This message stays on the MVS console and is following occurs:
highlighted. v Rebuilding of GBP reduces changed page count to
System Action: DB2 processing continues. 60% or less of GBP capacity.
v 'changed data.' entries decrease to 60% or lower
This message might remain highlighted and might not when they were previously 75% GBP capacity or
be automatically deleted in a pre-SP5.2.1-JES3 higher.
environment.
System Action: DB2 processing continues.
Operator Response: Contact the system programmer
to fix the storage problem.
| DSNB330I csect-name GROUP BUFFER POOL
System Programmer Response: You can relieve the gbpname CANNOT BE CONNECTED
GBP storage shortage by taking one or more of the FOR REBUILD DB2 REASON CODE =
following actions: reason1 MVS IXLCONN REASON CODE
v Use the ALTER GROUPBUFFERPOOL command to = reason2
lower the CLASST and GBPOOLT castout thresholds. Explanation: DB2 was not able to connect to the
v Use the ALTER GROUPBUFFERPOOL command to named group buffer pool for rebuild. reason1 is the DB2
lower the GBPCHKPT GBP checkpoint frequency. reason code. reason2 is the MVS IXLCONN reason
v Use the MVS SETXCF START,REBUILD command code. See MVS/ESA Programming: Sysplex Services
to expand the GBP coupling facility structure. If you Reference for an explanation of MVS IXLxxxx reason
rebuild, you can use the ALTER codes.
GROUPBUFFERPOOL command to lower the RATIO System Action: DB2 stops the rebuild.
so that a higher percentage of the GBP storage is
given to data entries over directory entries. Problem Determination: If the MVS IXLCONN reason
v If you are running on MVS 5.2 or a subsequent code is xxxx0C08 (structure allocation failed because
release, you can use the MVS SETXCF there was no suitable facility to allocate based on the
START,ALTER command to expand the size of the preference list in the MVS CFRM administrative policy),
GBP (the maximum size to which you can expand is or if the MVS IXLCONN reason code is xxxx084C (user
determined by the SIZE parameter in the CFRM does not have proper Security Access Facility (SAF)
policy that was used to allocate the GBP). authorization), then IFCID 0250, if active, contains
additional diagnostic information.
If you don’t do anything to relieve the storage shortage,
message DSNB228I appears if a write to the GBP fails
due to a 'GBP full' condition. If DB2 detects a 'full'
condition, it will suspend the transaction, initiate castout
154 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB331I • DSNB333I
DSNB331I csect-name REBUILD STARTED FOR DSNB332I csect-name THIS MEMBER HAS
GROUP BUFFER POOL gbpname COMPLETED CASTOUT OWNER
REASON = reason REBUILD FOR GROUP BUFFER POOL
gbpname PAGES CAST OUT FROM
Explanation: A rebuild has been initiated for the
ORIGINAL STRUCTURE = value1
named group buffer pool. reason indicates the reason
PAGES WRITTEN TO NEW
why the rebuild was initiated. reason can be one of the
STRUCTURE = value2
following:
Explanation: This DB2 member has completed its part
OPERATOR
of the rebuild processing for the named group buffer
The operator initiated a SETXCF command to
pool for the page sets and partitions for which it is the
initiate the rebuild.
castout owner.
LOSSCONN
value1 indicates the number of pages that this member
MVS detected a loss of connectivity to the
has castout to DASD for the rebuild. If the new structure
group buffer pool.
has a sufficient number of data entries, then value1
should normally be zero because DB2 writes the
This message is issued by each DB2 member changed pages from the original structure to the new
participating in the rebuild. structure. However, if the new structure does not have
System Action: The DB2 members that are actively sufficient space, then value1 may be greater than zero
connected to the named group buffer pool participate in because DB2 responds to insufficient space in the new
the rebuild. DB2 accomplishes the group buffer pool structure by casting the changed pages in the original
rebuild processing in two phases: structure to DASD instead of writing them to the new
structure.
1. Quiesce phase. Each member quiesces all local
access to the group buffer pool. value2 indicates how many changed pages this member
2. Connect phase. Each member connects to the new wrote to the new structure from the original as part of
structure. Each page set or partition castout owner the rebuild process. If the new structure has sufficient
that has connectivity to original structure is space, then each DB2 that has connectivity to the
responsible for writing pages from the original original structure writes the changed pages for page
structure to the new one. If there are not enough sets and partitions for which it is the castout owner from
data entries in the new structure, the page set and the original structure to the new structure, and value2
partition owners cast those pages out to DASD indicates the number of pages that the DB2 member
instead. Each member issues message DSNB332I wrote.
after it completes this activity. After all members value1 and value2 would be zero if this member has no
have completed their castout owner rebuild work, page set or partition castout ownership responsibility.
the group buffer pool structure owner does the final
sweep and checks to see if there are any changed This message is issued by each DB2 member that has
pages still remaining in the original structure. If so, connectivity to the original group buffer pool, and it is
the structure owner reads the changed pages from always be preceded by message DSNB331I.
the original structure and writes them to the new
System Action: If this DB2 member is not the group
one. The structure owner issues message
buffer pool structure owner, then its rebuild work is
DSNB333I after it has completed the final sweep.
done, and it notifies MVS that it has completed its part
of the rebuild and awaits later notification that all
After all members have responded to MVS indicating members have completed. If this member is the
that its connect phase processing is complete, MVS structure owner, then it proceeds to its final sweep
then notifies each member that the rebuild is complete. processing (see DSNB333I).
Each DB2 member issues message DSNB338I
indicating that the rebuild has completed successfully. Refer to ″System Action″ for message DSNB331I for an
explanation of the group buffer pool rebuild processing.
If an error occurs during the rebuild, the rebuild is
stopped. Each DB2 member issues message DSNB335I DSNB333I csect-name REBUILD FINAL SWEEP
indicating the reason why the rebuild is stopping, COMPLETED FOR GROUP BUFFER
followed by message DSNB339I indicating that the POOL gbpname PAGES WRITTEN TO
rebuild has not completed successfully. The operator NEW STRUCTURE = value1
can also stop rebuilds using the MVS SETXCF
command. Explanation: DB2 has completed the final sweep for
the rebuild of the named group buffer pool. A final
sweep means that the DB2 member that is the group
buffer pool structure owner ensures that all changed
pages have either been cast out to DASD or have been
written to the new structure after all the page set and
Chapter 5. DB2 Messages 155
DSNB335I • DSNB339I
partition owners have finished their work. If any NOBETRCONN
changed pages are found in the original structure during New structure does not provide better
the final sweep, then the structure owner writes them connectivity than the current structure for a
out to the new structure. value1 should be zero in most LossConn rebuild
cases for a manual rebuild. value1 will probably be
greater than zero in most cases where the rebuild was If reason1 indicates ’DB2REASON’, then reason2
initiated because a DB2 lost connectivity to the group specifies a DB2 reason code that indicates why DB2
buffer pool. stopped the rebuild. If reason1 is not ’DB2REASON’,
then reason2 is zero.
This message is issued by the structure owner and is
always preceded by message DSNB332I.
This message is normally preceded by message
System Action: Immediately after issuing this DSNB331I, which indicates that the rebuild was started
message, the structure owner notifies MVS that the and the reason why the rebuild was started. This
rebuild has completed, and MVS should soon begin message is issued by each DB2 member participating in
notifying each participating member that the rebuild is the rebuild. This message is followed by message
complete. DSNB339I.
Refer to ″System Action″ for message DSNB331I for an System Action: The new structure is discarded. If the
explanation of the group buffer pool rebuild processing. original structure is still usable, then all members that
still have connectivity to the original structure resume
using it. Members that do not have connectivity to the
DSNB335I csect-name REBUILD STOPPED FOR
original structure disconnect, and their connections
GROUP BUFFER POOL gbpname
become failed-persistent.
REASON = reason1 DB2 REASON
CODE = reason2 If the original structure is not usable, then DB2 initiates
damage assessment processing for the group buffer
Explanation: A rebuild has been stopped for the
pool.
named group buffer pool.
System Programmer Response: If the rebuild
reason1 indicates why the rebuild was stopped:
stopped because of “DB2REASON”, see the
OPERATOR explanation for the reason code given.
The operator initiated an MVS SETXCF
command to stop the rebuild.
DSNB338I csect-name THE REBUILD FOR GROUP
LOSSCONNNEW BUFFER POOL gbpname HAS
One or more of the DB2 members lost COMPLETED SUCCESSFULLY
connectivity to the new group buffer pool
Explanation: The rebuild for the named group buffer
structure while the rebuild was in progress.
pool has successfully completed.
LOSSCONNOLD
This message is preceded by message DSNB331I
One or more of the DB2 members lost
which indicates the reason why the rebuild was started.
connectivity to the original group buffer pool
This message is issued by each DB2 member
structure while the rebuild was in progress.
participating in the rebuild.
STRFAILNEW
System Action: The original structure is discarded
The new group buffer pool structure failed
and all DB2s that are connected to the group buffer
while the rebuild was in progress.
pool begin using the new structure.
STRFAILOLD
The original group buffer pool structure failed
DSNB339I csect-name THE STOP OF THE
while the rebuild was in progress.
REBUILD FOR GROUP BUFFER POOL
DB2REASON gbpname HAS COMPLETED
DB2 decided to stop the rebuild. The reason
Explanation: The stop of the rebuild for the named
code given in reason2 indicates why DB2
group buffer pool has completed.
stopped the rebuild.
This message is preceded by message DSNB335I
INSUFFCONN
which indicates the reason why the rebuild was
New structure does not provide connectivity
stopped. This message is issued by each DB2 member
that is better than or equivalent to the current
participating in the rebuild.
structure.
System Action: The new structure is discarded. If the
original structure is still usable, then all members that
still have connectivity to the original structure resume
using it, and members that do not have connectivity to
156 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB340I • DSNB353I
the original structure disconnect and their connection reason code that indicates why DB2 could not initiate
goes into a failed-persistent state. the recovery.
If the original structure is not usable, then DB2 initiates Severity: 4 (warning)
damage assessment processing for the group buffer
System Action: The partition remains in group buffer
pool.
pool recovery pending (GRECP) status and is
inaccessible.
| DSNB340I csect-name UNEXPECTED ERROR
User Response: Use the DB2 -START DATABASE
DURING REBUILD FOR GROUP
command on the partition to remove the GRECP status
BUFFER POOL gbpname MVS
and make the data accessible. You can also use the
service-name RETURN CODE = rc MVS
RECOVER or LOAD utility with the REPLACE option to
service-name REASON CODE = reason
clear the GRECP status.
Explanation: DB2 received an unexpected error from
MVS during rebuild processing for the named group
DSNB352I csect-name AUTOMATIC RECOVERY
buffer pool.
CANNOT BE INITIATED FOR GROUP
service-name is one of the following: BUFFER POOL gbp-name REASON =
IXLREBLD reason
IXLEERSP
Explanation: Following a failure of the named group
buffer pool, DB2 is not able to initiate automatic
rc is the return code from the MVS service and reason
recovery.
is the reason code.
reason indicates the reason why automatic recovery
System Action: DB2 stops the rebuild.
was not initiated:
System Programmer Response: See MVS/ESA
AUTORECNO
Programming: Sysplex Services Reference for an
The AUTOREC option is set to NO for the
explanation of the return and reason code for the
group buffer pool.
named MVS service.
CONNRELEASE
At least one actively connected DB2 member is
DSNB350I csect-name DBNAME database SPACE
not at the proper release to support automatic
NAME spacename CANNOT BE
recovery.
AUTOMATICALLY RECOVERED. DB2
REASON CODE = reason Severity: 4 (warning)
Explanation: Following a group buffer pool failure, System Action: The page sets and partitions that are
DB2 cannot automatically recover the named table in group buffer pool recovery pending (GRECP) status
space or index space. reason specifies a DB2 reason remain inaccessible.
code that indicates why DB2 could not initiate the
User Response: Use the DB2 -START DATABASE
recovery.
command on the page sets and partitions to remove the
Severity: 4 (warning) GRECP status and make the data accessible. You can
also use the RECOVER or LOAD utility with the
System Action: The table space or index space
REPLACE option to clear the GRECP status.
remains in group buffer pool recovery pending (GRECP)
status and is inaccessible. If reason is AUTORECNO and you want to enable
automatic recovery for the group buffer pool, use the
User Response: Use the DB2 -START DATABASE
ALTER GROUPBUFFERPOOL command to set
command on the table space or index space to remove
AUTOREC to YES for the group buffer pool.
the GRECP status and make the data accessible. You
can also use the RECOVER or LOAD utility with the If reason is CONNRELEASE, then you must ensure that
REPLACE option to clear the GRECP status. all DB2 members in the group are running at the
appropriate release. Automatic recovery is not
supported unless all members are running Version 5 or
DSNB351I csect-name DBNAME database SPACE
a later release.
NAME spacename PARTITION part#
CANNOT BE AUTOMATICALLY
RECOVERED. DB2 REASON CODE = DSNB353I csect-name ASYNCHRONOUS GRECP
reason RECOVERY IN PROGRESS FOR
GROUP BUFFER POOL bpoolname
Explanation: Following a group buffer pool failure,
DB2 cannot automatically recover the named table Explanation: Following a group buffer pool failure,
space or index space partition. reason specifies a DB2 DB2 triggers an automatic recovery process to attempt
to recover GRECP page sets for the specified group
Chapter 5. DB2 Messages 157
DSNB354I • DSNB404I
buffer pool. This message is issued once by any DB2 vpcba Number of currently active (that is, not
member who is the page set castout owner on one of stealable) buffers in the virtual buffer pool
the objects being recovered.
System Action: Processing continues.
System Action: Check for the DSNB354I message to
verify the completion of the automatic recovery process.
DSNB403I HIPERPOOL SIZE = hpsize BUFFERS,
CASTOUT = hpcast ALLOCATED =
DSNB354I csect-name ASYNCHRONOUS GRECP hpalc TO BE DELETED = hptbd
RECOVERY HAS COMPLETED FOR BACKED BY ES = hpback
GROUP BUFFER POOL bpoolname.
Explanation: This message, displayed by the
Explanation: DB2 has completed the GRECP DISPLAY BUFFERPOOL command, describes the
recovery process for those GRECP page sets in the allocation status of a hiperpool. This message is always
group buffer pool specified in the message. This preceded by message DSNB401I identifying the
message is issued once by any DB2 member who associated buffer pool.
previously issued a DSNB353I message, who is the
The variables are:
page set castout owner on one of the objects being
recovered. hpsize The user-specified hiperpool size.
hpcast The hiperpool’s CASTOUT attribute (YES or
DSNB401I BUFFERPOOL NAME bpname, NO).
BUFFERPOOL ID bpid, USE COUNT
ucount hpalc Number of allocated buffers in an active
hiperpool.
Explanation: This message contains the display
information that results from a DISPLAY BUFFERPOOL hptbd Number of buffers to be deleted in an active
command. For each buffer pool, this message is the hiperpool because of pool contraction.
first of a set of messages that display information from hpback
the DISPLAY BUFFERPOOL command. Number of buffers backed by expanded
The statistics are: storage. For a CASTOUT(YES) hiperpool, this
number is higher than the actual number of
bpname backed buffers if expanded storage frames
The buffer pool external name (BP0, BP1,..., were stolen by the system and DB2 did not
BP49, BP8KB, BP16KB BP32K, BP32K1,..., subsequently try to access the buffers.
BP32K9).
bpid The buffer pool internal identifier (0-49, 80-89). This message is issued by the following CSECT:
DSNB1DBP
ucount The number of open table spaces or index
spaces that refer to this buffer pool. A zero use
count means that the buffer pool is inactive. DSNB404I THRESHOLDS — VP SEQUENTIAL =
vpseq HP SEQUENTIAL = hpseq
System Action: Processing continues. DEFERRED WRITE = dwt VERTICAL
DEFERRED WRT = dwv1,dwv2
PARALLEL SEQUENTIAL = vppseqt
DSNB402I VIRTUAL BUFFERPOOL SIZE = vpsize
ASSISTING PARALLEL SEQT =
BUFFERS ALLOCATED = vpalc TO BE
vpxpseqt
DELETED = vptbd IN-USE/UPDATED =
vpcba Explanation: This message is displayed by the
DISPLAY BUFFERPOOL command to describe the
Explanation: This message, displayed by the
user-modifiable thresholds for the buffer pool. This
DISPLAY BUFFERPOOL command, describes the
message is always preceded by message DSNB401I
allocation status of a virtual buffer pool. This message is
identifying the associated buffer pool.
always preceded by message DSNB401I identifying the
associated buffer pool. The input threshold variables are:
The statistics are: vpseq Sequential steal threshold for the virtual pool,
expressed as a percentage of the total virtual
vpsize The user-specified virtual buffer pool size
buffer pool size.
vpalc Number of allocated buffers in an active virtual
hpseq Sequential steal threshold for the hiperpool,
buffer pool
expressed as a percentage of the total
vptbd Number of buffers to be deleted in an active hiperpool size.
virtual buffer pool because of pool contraction
dwt Free buffer deferred write threshold for the
158 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB405I • DSNB409I
virtual buffer pool, expressed as a percentage current and pending VPTYPE and PGSTEAL attributes.
of the total virtual buffer pool size. This message is always preceded by message
DSNB401I identifying the associated buffer pool.
dwv1 Vertical deferred write threshold for the virtual
buffer pool, expressed as a percentage of the cvptype is the virtual buffer pool type (VPTYPE)
total virtual buffer pool size. attribute that is applicable to the current allocation of the
virtual buffer pool.
dwv2 Vertical deferred write threshold for the virtual
buffer pool, expressed as an absolute number PRIMARY
of buffers. dwv2 is used to determine the The virtual buffer pool is allocated in the DB2
threshold only if dwv1 is zero and dwv2 is data base services (ssnmDBM1) address
non-zero; otherwise dwv1 is used to determine space.
the threshold.
DATASPACE
vppseqt The virtual buffer pool is allocated in one or
Sequential threshold for parallel query more data spaces.
processing, expressed as a percentage of the
virtual sequential steal threshold. When the pvptype is the pending virtual buffer pool type
threshold is set to 0, there is no parallel query (VPTYPE) attribute that will be applied for the next
processing support. allocation of the virtual buffer pool.
vpxpseqt PRIMARY
Assisting parallel sequential threshold, The virtual buffer pool is to be allocated in the
expressed as a percentage of the sequential DB2 data base services (ssnmDBM1) address
threshold for parallel query processing. space.
vpxpseqt allows you to control how much
buffer resource is used when this DB2 is DATASPACE
assisting another member of the group in The virtual buffer pool is to be allocated in one
parallel processing. When the threshold is set or more data spaces.
to 0, this buffer pool will not be used to assist
other data sharing members in processing a pgsteal is the page stealing method (PGSTEAL) that is
query. In a non-data-sharing environment, this in use for the virtual buffer pool.
value is ignored. LRU Specifies the virtual buffer pool buffers are
System Action: Processing continues. managed using the least recently used (LRU)
algorithm. This is the default.
DSNB405I spacetype NAMES - sn sn sn sn FIFO Specifies the virtual buffer pool buffers are
managed using the first in first out (FIFO)
Explanation: This message, displayed by the algorithm.
DISPLAY BUFFERPOOL command, lists the names of
the hiperspaces or data spaces allocated to a buffer System Action: Processing continues.
pool. Each DSNB405I message displays up to four
space names. If there are more than four, then multiple DSNB408I NO DETAIL STATISTICS AVAILABLE
DSNB405I messages are issued. This message is FOR BUFFER POOL bpname
always preceded by message DSNB401I identifying the
associated buffer pool. spacetype is one of the Explanation: This message is displayed by the
following: DISPLAY BUFFERPOOL command with the DETAIL
option specified. It indicates that no detail statistics are
HIPERSPACE available for the requested buffer pool because the pool
The sn list gives the names of the hiperspaces was not activated since DB2 startup.
that are allocated to the hiperpool.
System Action: Processing continues.
DATASPACE
The sn list gives the names of the data spaces
that are allocated to the virtual buffer pool. DSNB409I INCREMENTAL STATISTICS SINCE
basetime
System Action: Processing continues.
Explanation: This message is displayed by the
DISPLAY BUFFERPOOL command with the
DSNB406I VIRTUAL BUFFERPOOL TYPE - DETAIL(INTERVAL) option specified. It indicates the
CURRENT = cvptype PENDING = start time of the interval for which the statistics were
pvptype PAGE STEALING METHOD = accumulated (that is, either the time of the previous
pgsteal incremental display or the time the buffer pool was first
Explanation: This message, displayed by the activated, if there was no previous incremental display).
DISPLAY BUFFERPOOL command, describes the
Chapter 5. DB2 Messages 159
DSNB410I • DSNB415I
System Action: Processing continues.
DSNB413I LIST PREFETCH - REQUESTS = pft
PREFETCH I/O = pio PAGES READ =
DSNB410I CUMULATIVE STATISTICS SINCE pfp
basetime
Explanation: This message is displayed by the
Explanation: This message is displayed by the DISPLAY BUFFERPOOL command with the DETAIL
DISPLAY BUFFERPOOL command with the DETAIL(*) option specified. It shows the list prefetch statistics for
option specified. It indicates the start time of the interval the buffer pool. This message is always preceded by
for which the statistics were accumulated (that is, the message DSNB401I identifying the associated buffer
time the buffer pool was first activated). pool.
System Action: Processing continues. The statistics are:
pft Number of times list prefetch was requested
DSNB411I RANDOM GETPAGE = rgp SYNC READ
pio Number of list prefetch read I/O operations
I/O (R) = srr SEQ. GETPAGE = sgp
SYNC READ I/O (S) = srs DMTH HIT = pfp Number of pages read because of list prefetch
dmt
System Action: Processing continues.
Explanation: This message is displayed by the
DISPLAY BUFFERPOOL command with the DETAIL
DSNB414I DYNAMIC PREFETCH - REQUESTS =
option specified. It lists the page read statistics for the
pft PREFETCH I/O = pio PAGES READ =
buffer pool. This message is always preceded by
pfp
message DSNB401I identifying the associated buffer
pool. Explanation: This message is displayed by the
DISPLAY BUFFERPOOL command with the DETAIL
The statistics are:
option specified. It lists the dynamic prefetch statistics
rgp Number of nonsequential GETPAGE requests for the buffer pool. This message is always preceded by
message DSNB401I identifying the associated buffer
srr Number of synchronous read I/O operations for
pool.
nonsequential GETPAGE requests
The statistics are:
sgp Number of sequential GETPAGE requests
pft Number of times dynamic prefetch was
srs Number of synchronous read I/O operations for
requested
sequential GETPAGE requests
pio Number of dynamic prefetch read I/O
dmt Number of times data management threshold
operations
was hit
pfp Number of pages read because of dynamic
System Action: Processing continues.
prefetch
System Action: Processing continues.
DSNB412I SEQUENTIAL PREFETCH - REQUESTS
= pft PREFETCH I/O = pio PAGES READ
= pfp DSNB415I PREFETCH DISABLED - NO BUFFER =
pfd NO READ ENGINE = ree
Explanation: This message is displayed by the
DISPLAY BUFFERPOOL command with the DETAIL Explanation: This message is displayed by the
option specified. It lists the sequential prefetch statistics DISPLAY BUFFERPOOL command with the DETAIL
for the buffer pool. This message is always preceded by option specified. It lists prefetch statistics for the buffer
message DSNB401I identifying the associated buffer pool. This message is always preceded by message
pool. DSNB401I identifying the associated buffer pool.
The statistics are: The statistics are:
pft Number of times sequential prefetch was pfd Number of times prefetch was disabled (no
requested buffer)
pio Number of sequential prefetch read I/O ree Number of times prefetch was disabled (no
operations asynchronous read processor available)
pfp Number of pages read because of sequential System Action: Processing continues.
prefetch
System Action: Processing continues.
160 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB420I • DSNB431I
virtual pool synchronously (that is, in response
DSNB420I SYS PAGE UPDATES = sws SYS
to a page access request by an application)
PAGES WRITTEN = pws ASYNC WRITE
I/O = wio SYNC WRITE I/O = imw hws Number of pages moved from virtual buffer
pool to hiperpool synchronously (that is, in
Explanation: This message is displayed by the
response to a page access request by an
DISPLAY BUFFERPOOL command with the DETAIL
application)
option specified. It lists page write statistics for the
buffer pool. This message is always preceded by hra Number of pages moved from hiperpool to
message DSNB401I identifying the associated buffer virtual buffer pool asynchronously (that is, by a
pool. DB2 system process such as a sequential
prefetch)
The statistics are:
hwa Number of pages moved from virtual buffer
sws Number of system page updates
pool to hiperpool asynchronously (that is, by a
pws Number of system pages written DB2 system process such as sequential
prefetch)
wio Number of asynchronous write I/O operations
hrf Number of attempts to read a page from a
imw Number of synchronous write I/O operations
hiperpool, but the backing E-frame was stolen
System Action: Processing continues. by the system
hwf Number of attempts to write a page to the
DSNB421I DWT HIT= dwt VERTICAL DWT HIT=vdw hiperpool, but no backing E-frame could be
NO WRITE ENGINE=wee allocated
Explanation: This message is displayed by the System Action: Processing continues.
DISPLAY BUFFERPOOL command with the DETAIL
option specified. It lists page-write statistics for the
DSNB431I HIPERPOOL ACTIVITY (USING
buffer pool. This message is always preceded by
ASYNCHRONOUS DATA MOVER
message DSNB401I identifying the associated buffer
FACILITY) — HP READS = ara HP
pool.
WRITES = awa READ FAILURES = arf
The statistics are: WRITE FAILURES = awf
dwt Number of times deferred write threshold was Explanation: This message is displayed by the
hit DISPLAY BUFFERPOOL command with the DETAIL
option specified. It lists statistics about the movement of
vdw Number of times vertical deferred write pages between the virtual buffer pool and the hiperpool.
threshold was hit The statistics listed are for pages moved
wee Number of times write engine (asynchronous asynchronously, (that is, by a DB2 system process such
write processor) was not available for I/O as sequential prefetch, using the Asynchronous Data
operations Mover Facility.). This message is always preceded by
message DSNB401I identifying the associated buffer
System Action: Processing continues. pool.
The variables are:
DSNB430I HIPERPOOL ACTIVITY (NOT USING
ASYNCHRONOUS DATA MOVER ara Number of pages moved from hiperpool to
FACILITY) — SYNC HP READS=hrs virtual buffer pool
SYNC HP WRITES=hws ASYNC HP awa Number of pages moved from virtual buffer
READS=hra ASYNC HP WRITES= hwa pool to hiperpool
READ FAILURES= hrf WRITE
FAILURES=hwf arf Number of pages for which a read request
failed
Explanation: This message is displayed by the
DISPLAY BUFFERPOOL command with the DETAIL awf Number of pages for which a write request
option specified. It lists statistics about the movement of failed
pages between the virtual buffer pool and the hiperpool.
System Action: Processing continues.
This message is always preceded by message
DSNB401I identifying the associated buffer pool. The
statistics listed are for pages moved without the use of
the Asynchronous Data Mover Facility.
The statistics are:
hrs Number of pages moved from hiperpool to
Chapter 5. DB2 Messages 161
DSNB440I • DSNB455I
DSNB440I PARALLEL ACTIVITY — PARALLEL DSNB454I HP CACHED PAGES — CURRENT =
REQUEST = tpa DEGRADED hcount MAX = mhcount
PARALLEL = dpa
Explanation: This message might be displayed for an
Explanation: This message is issued in response to active buffer pool by the DISPLAY BUFFERPOOL
the DISPLAY BUFFERPOOL command with DETAIL command with LSTATS specified. It lists the number of
specified. It lists statistics about parallel activities. This cached pages and the number of changed pages in the
message is always preceded by message DSNB401I hiperpool for a data set. The message is only issued if
identifying the associated buffer pool. there are nonzero values to display. This message is
always preceded by message DSNB401I identifying the
The variables are:
associated buffer pool, DSNB464I or DSNB465I
tpa Total number of negotiations with the buffer identifying the table space or index space, and
pool for getting the requested number of DSNB466I identifying the data set.
sequential prefetch streams
The statistics are:
dpa Total number of times the negotiation resulted
hcount Number of cached pages in HP for the data set
in the degraded mode of parallel operations
(that is, the number of buffers that contain
pages for the data set in the hiperpool).
DSNB453I VP CACHED PAGES - CURRENT =
mhcount
vcount MAX = mvcount CHANGED =
Maximum number of cached pages in HP for
ccount MAX = mccount
the data set since the last DISPLAY
Explanation: This message might be displayed for an BUFFERPOOL command with the LSTATS
active buffer pool by the DISPLAY BUFFERPOOL option was issued.
command with LSTATS specified. It lists the number of
System Action: Processing continues.
cached pages and the number of changed pages in the
virtual buffer pool for a data set. The message is only
issued if there are nonzero values to display. This DSNB455I SYNCHRONOUS I/O DELAYS —
message is always preceded by message DSNB401I AVERAGE DELAY = avd MAXIMUM
identifying the associated buffer pool, DSNB464I or DELAY = mxd TOTAL PAGES = tpg
DSNB465I identifying the table space or index space,
Explanation: This message might be displayed for an
and DSNB466I identifying the data set.
active buffer pool by the DISPLAY BUFFERPOOL
The statistics are: command with the LSTATS option specified. It lists
synchronous I/O delay statistics for a data set belonging
vcount Number of cached pages in VP for the data set
to an open table space or index space associated with
(that is, the number of buffers that contain
the buffer pool. The values listed are incremental since
pages for the data set in the virtual buffer
the last display for the data set. The message is only
pool).
issued if there are nonzero values to display. This
mvcount message is always preceded by message DSNB401I
Maximum number of cached pages in VP for identifying the associated buffer pool, DSNB464I or
the data set since the last DISPLAY DSNB465I identifying the table space or index space,
BUFFERPOOL command with the LSTATS and DSNB466I identifying the relative data set within
option was issued. the table space or index space.
ccount Number of changed pages in VP for the data The statistics are:
set (that is, the number of buffers that were
avd Average I/O delay in milliseconds for pages in
changed in the virtual buffer pool for the data
the data set
set).
mxd Maximum I/O delay in milliseconds for pages in
mccount
the data set
Maximum number of changed pages in VP for
the data set since the last DISPLAY tpg Total number of pages read or written for the
BUFFERPOOL command with the LSTATS data set
option was issued.
System Action: Processing continues.
This message is issued by the following CSECT:
DSNB1DBP
System Action: Processing continues.
162 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB456I • DSNB462I
v The column headers (DSNB460I), which are
DSNB456I ASYNCHRONOUS I/O DELAYS —
underlined
AVERAGE DELAY = avd MAXIMUM
DELAY = mxd TOTAL PAGES = tpg v Detailed space information for all spaces and
TOTAL I/O COUNT = tio partitions requested by the command (DSNB462I)
v An ending message (DSNB463I) that might be
Explanation: This message might be displayed for an
displayed if no spaces matched the command criteria
active buffer pool by the DISPLAY BUFFERPOOL
command with the LSTATS option specified. It lists
asynchronous I/O delay statistics for a data set The text of message DSNB462I provides the detail lines
belonging to an open table space or index space that follow the headings generated by this message. If
associated with the buffer pool. The values listed are the DISPLAY BUFFERPOOL LIST command finds more
incremental since the last display for the data set. The than 255 lines of output to display, the report will be
message is only issued if there are nonzero values to broken up and new headings (DSNB460I) will be
display. This message is always preceded by message displayed with ’(CONTINUED)’ showing in the heading
DSNB401I identifying the associated buffer pool, text. This is needed due to the MVS limitation of 255
DSNB464I or DSNB465I identifying the table space or messages for multi-line WTO messages.
index space, and DSNB466I identifying the relative data System Action: Processing continues.
set within the table space or index space.
The statistics are: DSNB461I
avd Average I/O delay in milliseconds for pages in Explanation: This message appears within a multiple
the data set line display generated by a DISPLAY BUFFERPOOL
mxd Maximum I/O delay in milliseconds for pages in command. It follows message DSNB460I and is used to
the data set underline the column headings that are displayed by
DSNB460I.
tpg Total number of pages read or written for the
data set System Action: Processing continues.
tio Total number of I/Os issued for the data set
DSNB462I database spacenam part ty gbp mbr
System Action: Processing continues. castout use p-lock
Explanation: This message displays the detail lines
DSNB459I csect-name OPEN FAILURE HAS generated by a DISPLAY BUFFERPOOL command. It
OCCURRED FOR DATA SET dsn follows DSNB460I.
Explanation: This message might be displayed for an The detail lines contain the following information (for
active buffer pool by the DISPLAY BUFFERPOOL report readability, the fields for DBNAME and SPACE
command with the LIST option specified. It indicates NAME might be blank. When either field is blank, one of
that a previous attempt to access a data set (identified the prior detail lines contains the suppressed value).
by its relative data set number within a table space or
index space) failed due to an allocation or open error. database
Name of the database that is associated with
This message is always preceded by a DSNB401I the page set/partition.
message identifying the associated buffer pool and a
DSNB464I or DSNB465I message identifying the table spacenam
space or index space. Name of the table space or index space.
System Action: Processing continues. part The partition number. It is blank for a simple
table space or simple index space. For non
partitioned indexes on a partitioned table
DSNB460I --PAGE SET/PARTITION LIST space, it is the logical partition number
INFORMATION----DATA SHARING preceded by the character L (for example,
INFO-- TS GBP MEMBER CASTOUT L01).
USE P-LOCK DATABASE SPACE NAME
PART IX DEP NAME OWNER COUNT ty Whether the object is a table space (TS) or an
STATE index space (IX).
Explanation: This message displays the column gbp Whether the page set/partition is
headings that indicate the beginning of a multiple line GBP-dependent (’Y’ for yes; ’N’ for no).
display generated by a DISPLAY BUFFERPOOL mbr Name of the member that the detail line
command. The format of the multiple line display has pertains to.
three parts:
castout Whether the member identified in this line is
the castout owner (’Y’ for yes; blank for no).
Chapter 5. DB2 Messages 163
DSNB463I • DSNB466I
use Number of active claimers or drainers for the
DSNB464I TS USE DATABASE SPACE NAME
page set/partition for the member displayed on
PART IX COUNT ========
this detail line.
=========== ==== == =====
p-lock P-lock state that the member identified in this
Explanation: This message displays underlined
line currently holds. Values are:
column headings that indicate the beginning of a
IS R/O interest. There are other multiple line display generated by a DISPLAY
members who have interest in this BUFFERPOOL command. The format of the multiple
page set/partition. The page line display has three parts:
set/partition. is GBP-dependent. v Underlined column headings (DSNB464I).
IX R/W interest. There are other v Detailed space information for the spaces and
members who have interest in this partitions that are requested by the command
page set/partition. The page (DSNB465I).
set/partition is GBP-dependent. v An ending message (DSNB463I) that may be
S R/O interest. There may be other displayed if no spaces matched the command
members reading the page criteria.
set/partition. The page set/partition is
not GBP-dependent. The text of message DSNB465I provides the detail lines
that follow the headings generated by this message. If
SIX R/W interest. There may be other the DISPLAY BUFFERPOOL LIST command finds more
members who are reading the page than 255 lines of output to display, the report will be
set/partition. The page set/partition is broken up and new headings (DSNB464I) will be
GBP-dependent. displayed with ’(CONTINUED)’ showing in the heading
NSU R/W interest. The page set/partition is text. This is needed due to the MVS limitation of 255
GBP-dependent. messages for multi-line WTO messages.
X R/W interest. There are no other System Action: Processing continues.
members accessing the page
set/partition. The page set/partition is DSNB465I database spacenam part ty use
not GBP-dependent.
Explanation: This message displays the detail lines
US A temporary state that can be held by generated by the DISPLAY BUFFERPOOL command. It
a restarting DB2 when ’waiting for follows DSNB464I.
retained locks’ is enabled.
The detail lines contain the following information (for
### A number that is to be used as a report readability, the fields for DBNAME and SPACE
diagnostic aid. A number is displayed NAME might be blank. When either field is blank, one of
only when a DISPLAY BUFFERPOOL the prior detail lines will contain the suppressed value).
command encounters a lock state
other than any of those defined database
above. Name of the database that is associated with
the page set/partition.
System Action: Processing continues.
spacenam
Name of the table space or index space.
DSNB463I * * * NO OBJECTS MATCHED
LIST/LSTATS SELECTION CRITERIA part The partition number. It is blank for a simple
table space or simple index space. For non
Explanation: This message appears as part of the partitioned indexes on a partitioned table
DISPLAY BUFFERPOOL output if the command did not space, it is the logical partition number
find any page sets/partitions that matched the selection preceded by the character L
criterion. For example, the message would be displayed
for DIS BPOOL(BP0) GBPDEP(Y) if the command did ty Whether the object is a table space (TS) or an
not find any page sets/partitions that were index space (IX).
GBP-dependent. System Action: Processing continues.
User Response: If you expected to see a list of page
sets/partitions, ensure that the syntax of the command DSNB466I ------------------PAGE SET/PARTITION
was coded correctly. Consider adding or changing the STATISTICS-------------------
filter keywords to obtain a list of page sets/partitions.
Explanation: This message appears as part of the
System Action: The command terminates normally. DISPLAY BUFFERPOOL output if the command was
164 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB467I • DSNB502I
specified with the LSTATS option. It shows statistics for System Action: The command ignores keyword1 and
data sets. terminates normally.
System Action: Processing continues.
DSNB499I DISPLAY TERMINATED DUE TO
INSUFFICIENT MESSAGE SPACE
DSNB467I STATISTICS FOR type
dbname.spacenam DATA SET #: dsn# Explanation: The DISPLAY BUFFERPOOL or the
USE COUNT:ucount DISPLAY GROUPBUFFERPOOL command was unable
to obtain storage for additional messages. This should
Explanation: This message might be displayed for an
only happen for a particularly long display request, such
active buffer pool by the DISPLAY BUFFERPOOL
as a detail display for a large number of buffer pools or
command with the LSTATS option specified. It identifies
group buffer pools.
the page set/partition type (table space/index space),
database name, space name, number of System Action: The display is truncated.
claimers/drainers and the relative data set number
System Programmer Response: Reissue the
within a table space or index space for the statistics
-DISPLAY BUFFERPOOL or the -DISPLAY
displayed in one or more of the messages that follow
GROUPBUFFERPOOL command, specifying a smaller
this one.
number of buffer pools or group buffer pools.
type Whether the page set/partition is a table space
(TABLE SPACE) or an index space (INDEX
DSNB501I bpname IS NOT A VALID BUFFER
SPACE).
POOL NAME
dbname
Explanation: An invalid buffer pool name was
Database name
specified on an ALTER BUFFERPOOL or DISPLAY
spacenam BUFFERPOOL command. THE VALID NAMES ARE
Name of the table space or index space. BP0, BP1,..., BP49, BP32K, BP32K1,...BP32K9.
dsn# The relative data set number within a table System Action: The request is rejected.
space or index space for the statistics
System Programmer Response: Reissue the ALTER
displayed in one or more of the messages that
BUFFERPOOL or DISPLAY BUFFERPOOL command,
follow this one.
specifying a valid buffer pool name.
ucount Number of applications with a claim or drain on
the page set/partition.
DSNB502I csect-name VPSIZE FOR bpname MUST
System Action: Processing continues. BE BETWEEN llimit AND ulimit
Explanation: An attempt was made to change a buffer
DSNB468I keyword KEYWORD IS IGNORED FOR pool’s VPSIZE to an invalid value using the ALTER
NON-DATA SHARING SYSTEMS BUFFERPOOL command. VPSIZE is the number of
buffers in the virtual buffer pool.
Explanation: The identified keyword is valid only in a
data-sharing environment. Keywords GBPDEP and bpname
CASTOWNR can cause this message to be displayed. Buffer pool name.
User Response: Re-enter the command without the llimit Lower limit for buffer pool’s VPSIZE. For BP0,
keyword since the DB2 is a non-data-sharing DB2. the lower limit is 56. For all other buffer pools,
the lower limit is 0.
System Action: The command ignores the keyword
and terminates normally. ulimit Upper limits for buffer pool’s VPSIZE. For
VPTYPE(PRIMARY) virtual buffer pools, the
upper limit is as follows:
DSNB469I keyword1 KEYWORD IS IGNORED
v 400,000 for 4KB page-size buffer pools
WHEN keyword2 KEYWORD IS
v 200,000 for 8KB page-size buffer pools
SPECIFIED
v 100,000 for 16KB page-size buffer pools
Explanation: Keyword1 is incompatible with keyword2. v 50,000 for 32KB page-size buffer pools
For example, in command DIS BPOOL(BP0)
GBPDEP(Y) LSTATS(*), keyword GBPDEP indicates For VPTYPE(DATASPACE) virtual buffer pools,
that a list of page sets or partitions are desired (as in the upper limit is 8,000,000, regardless of the
LIST keyword); however, keyword GBPDEP is ignored page size.
because LIST and LSTATS are two different reports.
System Action: The request is rejected.
User Response: Omit keyword1 if keyword2 is used
System Programmer Response: Reissue the ALTER
on the next entry of the command.
Chapter 5. DB2 Messages 165
DSNB503I • DSNB509I
BUFFERPOOL command, specifying a legitimate deferred write threshold. Valid values range from 0 to
VPSIZE value. 90.
System Action: The request is rejected.
DSNB503I HPSIZE FOR bpname MUST BE
System Programmer Response: Reissue the ALTER
BETWEEN llimit AND ulimit
BUFFERPOOL command, specifying a legitimate
Explanation: An attempt was made to change a buffer DWQT value.
pool’s HPSIZE to an invalid value using the ALTER
BUFFERPOOL command. HPSIZE is the number of
DSNB507I VDWQT FOR bpname MUST BE
buffers in the hiperpool. The variables are:
BETWEEN 0 AND 90
bpname
Explanation: An attempt was made to change a buffer
Buffer pool name.
pool’s VDWQT attribute to an invalid value using the
llimit Lower limit for buffer pool’s HPSIZE. The lower ALTER BUFFERPOOL command. VDWQT is the
limit for all buffer pools is 0. vertical deferred write threshold. Valid values range from
0 to 90.
ulimit Upper limits for buffer pool’s HPSIZE. For 4KB
page-size buffer pools, the upper limit is System Action: The request is rejected.
2,097,152. For 32KB page-size buffer pools,
System Programmer Response: Reissue the ALTER
the upper limit is 262,144.
BUFFERPOOL command, specifying a legitimate
System Action: The request is rejected. VDWQT value.
System Programmer Response: Reissue the ALTER
BUFFERPOOL command, specifying a legitimate DSNB508I csect-name THE TOTAL VPSIZE IS
HPSIZE value. BEYOND THE MAXIMUM LIMIT
Explanation: An ALTER BUFFERPOOL command
DSNB504I VPSEQT FOR bpname MUST BE specified a VPSIZE or VPTYPE value that would cause
BETWEEN 0 AND 100 the sum of the ssnmDBM1 address space storage
requirements for all virtual buffer pools to exceed
Explanation: An ALTER BUFFERPOOL command
1.6GB, or the number of VPTYPE(DATASPACE) buffers
was issued to try to alter a buffer pool’s VPSEQT
to exceed 8,000,000. When calculating the storage
attribute to an invalid value. VPSEQT is the virtual
requirements for the virtual buffer pools, DB2 uses the
buffer pool sequential steal threshold. Valid values
page size (4K, 8K, 16K, or 32K) for each
range from 0 to 100.
VPTYPE(PRIMARY) virtual pool buffer and lookaside
System Action: The request is rejected. pool buffer, and 128 bytes for each
VPTYPE(DATASPACE) buffer.
System Programmer Response: Reissue the ALTER
BUFFERPOOL command, specifying a legitimate System Action: The buffer pool’s VPSIZE or VPTYPE
VPSEQT value. is not changed. Processing for other parameters, if
requested, proceeds normally.
DSNB505I HPSEQT FOR bpname MUST BE System Programmer Response: Rebalance VPSIZE
BETWEEN 0 AND 100 for all buffer pools.
Explanation: An attempt was made to change a buffer
pool’s HPSEQT attribute to an invalid value using the DSNB509I THE TOTAL HPSIZE IS BEYOND THE
ALTER BUFFERPOOL command. HPSEQT is the MAXIMUM LIMIT
hiperpool sequential steal threshold. Valid values range
Explanation: An ALTER BUFFERPOOL command
from 0 to 100.
specified an HPSIZE value that would cause the sum of
System Action: The request is rejected. the HPSIZE value for all buffer pools to exceed 8GB.
System Programmer Response: Reissue the ALTER System Action: The buffer pool’s HPSIZE is not
BUFFERPOOL command, specifying a legitimate changed. Processing for other parameters, if requested,
HPSEQT value. proceeds normally.
System Programmer Response: Rebalance HPSIZE
DSNB506I DWQT FOR bpname MUST BE for all buffer pools.
BETWEEN 0 AND 90
Explanation: An attempt was made to change a buffer
pool’s DWQT attribute value using the ALTER
BUFFERPOOL command. DWQT is the free buffer
166 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB510I • DSNB519I
DSNB510I NO ACTION REQUESTED DSNB515I integer IS THE CURRENT HPSEQT FOR
BUFFER POOL bpname
Explanation: An ALTER BUFFERPOOL command
was issued, but no buffer pool attributes were specified. Explanation: An ALTER BUFFERPOOL command
specified an HPSEQT equal to the current sequential
System Action: The buffer pool’s attributes are not
steal threshold of the hiperpool.
changed.
System Action: The sequential steal threshold of the
System Programmer Response: Reissue the ALTER
hiperpool is not changed. Processing for other
BUFFERPOOL command specifying one or more buffer
parameters, if requested, proceeds normally.
pool attributes.
DSNB516I integer IS THE CURRENT DWQT FOR
DSNB511I VDWQT CANNOT BE GREATER THAN
BUFFER POOL bpname
DWQT
Explanation: An ALTER BUFFERPOOL command
Explanation: An ALTER BUFFERPOOL command
specified a DWQT equal to the current deferred write
specified a DWQT and/or VDWQT value that would
threshold of the buffer pool.
result in the buffer pool’s VDWQT parameter being
greater than its DWQT parameter. System Action: The deferred write threshold of the
buffer pool is not changed. Processing for other
System Action: The buffer pool’s VDWQT or DWQT
parameters, if requested, proceeds normally.
is not changed. Processing for other parameters, if
requested, proceeds normally.
DSNB517I int1,int2 IS THE CURRENT VDWQT FOR
System Programmer Response: Rebalance DWQT
BUFFER POOL bpname
and VDWQT for the buffer pool.
Explanation: An ALTER BUFFERPOOL command
specified a VDWQT equal to the current vertical
DSNB512I integer IS THE CURRENT VPSIZE FOR
deferred write threshold of the buffer pool.
BUFFER POOL bpname
System Action: The vertical deferred write threshold
Explanation: An ALTER BUFFERPOOL command
of the buffer pool is not changed. Processing for other
specified a VPSIZE equal to the buffer pool’s current
parameters, if requested, proceeds normally.
virtual buffer pool size.
System Action: The virtual buffer pool size is not
DSNB518I value IS THE CURRENT CASTOUT
changed. Processing for other parameters, if requested,
ATTRIBUTE FOR HIPERPOOL bpname
proceeds normally.
Explanation: An ALTER BUFFERPOOL command
specified a CASTOUT attribute equal to the hiperpool’s
DSNB513I integer IS THE CURRENT HPSIZE FOR
current CASTOUT attribute.
BUFFER POOL bpname
System Action: The hiperpool’s CASTOUT attribute is
Explanation: An ALTER BUFFERPOOL command
not changed. Processing for other parameters, if
specified an HPSIZE equal to the buffer pool’s current
requested, proceeds normally.
hiperpool size.
System Action: The hiperpool size is not changed.
DSNB519I csect-name PGSTEAL FOR bpname
Processing for other parameters, if requested, proceeds
HAS BEEN SET TO value.
normally.
Explanation: This message is issued in response to
an ALTER BUFFERPOOL command to indicate that the
DSNB514I integer IS THE CURRENT VPSEQT FOR
requested change to the PGSTEAL parameter was
BUFFER POOL bpname
accepted.
Explanation: An ALTER BUFFERPOOL command
bpname is the name of the buffer pool.
specified an VPSEQT equal to the current sequential
steal threshold of the virtual buffer pool. value is one of the following:
System Action: The hiperpool size is not changed. LRU The virtual buffer pool buffers are managed
Processing for other parameters, if requested, proceeds using the least recently used (LRU) algorithm.
normally. This is the default.
FIFO The virtual buffer pool buffers are managed
using the first in first out (FIFO) algorithm.
System Action: Processing continues.
Chapter 5. DB2 Messages 167
DSNB520I • DSNB529I
DSNB520I READY TO EXPLICITLY DELETE DSNB524I VPSEQT FOR bpname HAS BEEN SET
BUFFER POOL bpname TO integer
Explanation: This message is issued before draining Explanation: This message is issued in response to
an active buffer pool in response to an ALTER an ALTER BUFFERPOOL command. It indicates the
BUFFERPOOL command, which specified VPSIZE=0 successful modification of the sequential steal threshold
against an active buffer pool. of the virtual buffer pool.
System Action: After this message is issued, DB2
quiesces all current activities against this buffer pool. DSNB525I HPSEQT FOR bpname HAS BEEN SET
DB2 locks the table space exclusively and performs TO integer
physical close for all open table spaces or index spaces
Explanation: This message is issued in response to
that reference this pool. DB2 also prevents subsequent
an ALTER BUFFERPOOL command. It indicates the
database access that references this pool. SQL
successful modification of the sequential steal threshold
applications get an SQLCODE -904 (resource not
of the hiperpool.
available) with reason code 00C200E0 to indicate that
the requested virtual buffer pool size is not initialized.
After the requested buffer pool is deleted, message DSNB526I DWQT FOR bpname HAS BEEN SET TO
DSNB521I is issued. integer
Explanation: This message is issued in response to
DSNB521I BUFFER POOL bpname HAS BEEN an ALTER BUFFERPOOL command. It indicates the
EXPLICITLY DELETED successful modification of the deferred write threshold of
the buffer pool.
Explanation: This message is issued after an active
buffer pool is explicitly deleted with an ALTER
BUFFERPOOL command. This message is always DSNB527I VDWQT FOR bpname HAS BEEN SET
preceded by a corresponding DSNB520I message. TO int1,int2
System Action: The virtual storage and hiperspaces Explanation: This message is issued in response to
associated with this buffer pool are released. an ALTER BUFFERPOOL command. It indicates the
successful modification of the vertical deferred write
threshold of the buffer pool.
DSNB522I VPSIZE FOR bpname HAS BEEN SET
TO integer
DSNB528I CASTOUT ATTRIBUTE FOR bpname
Explanation: This message is issued in response to
HAS BEEN SET TO value
an ALTER BUFFERPOOL command to indicate that the
requested change to the VPSIZE parameter was Explanation: This message is issued in response to
accepted. For an active pool, the actual expansion, an ALTER BUFFERPOOL command. It indicates that
contraction, or deletion does not take place until after the requested change to the hiperpool’s CASTOUT
this message is issued. attribute was accepted. For an active pool, the actual
rebuilding of the hiperpool with the new CASTOUT
System Action: Processing continues.
attribute does not take place until after this message is
System Programmer Response: Issue the DISPLAY issued.
BUFFERPOOL command to determine the actual virtual
System Action: Processing continues.
storage usage for this pool.
System Programmer Response: Use the DISPLAY
BUFFERPOOL command to determine the actual
DSNB523I HPSIZE FOR bpname HAS BEEN SET
CASTOUT attribute for this pool.
TO integer
Explanation: This message is issued in response to
DSNB529I VPPSEQT FOR bpname HAS BEEN SET
an ALTER BUFFERPOOL command to indicate that the
TO integer
requested change to the HPSIZE parameter was
accepted. For an active hiperpool, the actual expansion, Explanation: This message is issued in response to
contraction, creation, or deletion does not take place the ALTER BUFFERPOOL command. It indicates the
until after this message is issued. successful modification of the parallel sequential steal
threshold of the virtual buffer pool.
System Action: Processing continues.
System Programmer Response: Issue the DISPLAY
BUFFERPOOL command to determine the actual
hiperpool size for this pool.
168 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB530I • DSNB537I
System Programmer Response: Change the
DSNB530I integer IS THE CURRENT VPPSEQT
VPXPSEQT attribute to a valid value and reenter the
FOR BUFFER POOL bpname
command.
Explanation: An ALTER BUFFERPOOL command
specified a VPPSEQT equal to the current parallel
DSNB535I csect-name VPTYPE FOR bpname HAS
sequential steal threshold of the virtual buffer pool.
BEEN SET TO value. IT WILL TAKE
This message is issued by the following CSECT: EFFECT ON THE NEXT ALLOCATION.
DSNB1ABP
Explanation: This message is issued in response to
System Action: The parallel sequential steal threshold an ALTER BUFFERPOOL command to indicate that the
of the virtual buffer pool is not changed. Processing for requested change to the VPTYPE parameter was
other parameters, if requested, proceeds normally. accepted. The new VPTYPE value takes effect the next
time the buffer pool is allocated.
DSNB531I VPPSEQT FOR bpname MUST BE bpname is the name of the buffer pool.
BETWEEN 0 AND 100
value is one of the following:
Explanation: An ALTER BUFFERPOOL command
PRIMARY
was issued to alter a buffer pool’s VPPSEQT attribute to
The virtual buffer pool is to be allocated in the
an invalid value. VPPSEQT is the parallel sequential
DB2 data base services address space.
steal threshold of the virtual buffer pool. Valid values
range from 0 to 100. DATASPACE
The virtual buffer pool is to be allocated in one
System Action: The VPPSEQT value is not changed.
or more DB2-associated data spaces.
System Programmer Response: Change the
System Action: Processing continues.
VPPSEQT attribute to a valid value and reenter the
command.
| DSNB536I csect-name THE TOTAL VIRTUAL
BUFFER POOL STORAGE EXCEEDS
DSNB532I VPXPSEQT FOR bpname HAS BEEN
THE REAL STORAGE CAPACITY
SET TO integer
Explanation: This message is issued as a warning
Explanation: This message is issued from
that the total amount of allocated virtual buffer pool
DSNB1ABP csect in response to the ALTER
storage for this DB2 subsystem has exceeded the real
BUFFERPOOL command. It indicates the successful
storage capacity of the OS/390 image. The amount of
modification of the assisting parallel sequential threshold
real storage should be at least as much as the total
of the virtual buffer pool.
amount of virtual buffer pool storage, and should also
be enough to accommodate the EDM pool and DB2
DSNB533I integer IS THE CURRENT VPXPSEQT working storage in addition to the virtual buffer pool
FOR BUFFER POOL bpname storage. Paging activity in the buffers is an indication of
a performance problem.
Explanation: An ALTER BUFFERPOOL command
specified a VPXPSEQT equal to the current assisting System Action: Processing continues.
parallel sequential threshold of the virtual buffer pool.
System Programmer Response: Allocate more real
This message is issued from DSNB1ABP csect.
storage to the OS/390 image. If there is not enough real
System Action: The assisting parallel sequential storage to hold the buffers, then the number of buffers
threshold of the virtual buffer pool is not changed. needs to be reduced. This might mean fewer concurrent
Processing for other parameters, if requested, proceeds users. If the number of buffers is reduced, then DB2 will
normally. issue the DSNB538I message when the total amount of
virtual buffer pool storage no longer exceeds the real
| storage capacity.
DSNB534I VPXPSEQT FOR bpname MUST BE
BETWEEN 0 AND 100
DSNB537I csect-name VPTYPE AND VPSIZE ARE
Explanation: An ALTER BUFFERPOOL command
MUTUALLY EXCLUSIVE WHEN THE
was issued to change a buffer pool’s VPXPSEQT
VIRTUAL BUFFER POOL IS
attribute to an invalid value. VPXPSEQT is the assisting
ALLOCATED
parallel sequential threshold of the virtual buffer pool.
Valid values range from 0 to 100. This message is Explanation: An ALTER BUFFERPOOL command
issued from DSNB1ABP csect. specified both VPTYPE and VPSIZE keywords while the
corresponding virtual buffer pool was allocated. If the
System Action: The VPXPSEQT value is not
virtual buffer pool is allocated, then only one of VPTYPE
changed.
or VPSIZE is allowed.
Chapter 5. DB2 Messages 169
DSNB538I • DSNB552I
System Action: The VPTYPE and VPSIZE keywords
DSNB541I csect-name INSUFFICIENT LOCAL
are not processed.
CACHE VECTOR STORAGE TO
System Programmer Response: Resubmit the CREATE/EXPAND HIPERPOOL bpname
command specifying either VPTYPE or VPSIZE, but not TO SPECIFIED SIZE size1 HIPERPOOL
both. Be aware that the VPTYPE change does not take SIZE IS NOW size2.
effect immediately. The new VPTYPE specification
Explanation: The specified hiperpool could not be
becomes ″pending″ and will take effect the next time
created or expanded to the requested size (size1). The
that the buffer pool is allocated, as indicated in
associated group buffer pool is connected, and the local
message DSNB535I. If other attributes are changed
cache vector could not be expanded to cover the
while the pending VPTYPE is different than the currently
requested hiperpool size.
allocated VPTYPE, then those altered attributes take
effect immediately for the currently allocated pool (they The local cache vector is a bit array which tracks
do not become ″pending″ for the new VPTYPE). whether the page in a given buffer was modified by
another system (cross-invalidated). There must be one
bit in the vector for each buffer in the virtual buffer pool
DSNB538I csect-name THE TOTAL VIRTUAL
and hiperpool. For more information on the local cache
BUFFER POOL STORAGE NO LONGER
vector, see MVS/ESA Programming: Sysplex Services
EXCEEDS THE REAL STORAGE
Reference.
CAPACITY
System Action: DB2 downgrades the hiperpool size
Explanation: This message is issued following a
to the size that can be supported by the available local
previous DSNB536E message to indicate that the total
cache vector storage (size2).
amount of allocated virtual buffer pool storage for this
DB2 subsystem no longer exceeds the real storage System Programmer Response: Free local cache
capacity of the OS/390 image. vector storage by contracting or deleting other buffer
pools that are connected to a group buffer pool. Then
System Action: Processing continues.
reattempt the hiperpool expansion or creation by issuing
the ALTER BUFFERPOOL command.
DSNB540I csect-name INSUFFICIENT LOCAL
CACHE VECTOR STORAGE TO
DSNB551I BSDS READ ERROR, RC= integer,
EXPAND VIRTUAL BUFFER POOL
RSN=integer
bpname TO SPECIFIED SIZE size1.
VIRTUAL BUFFER POOL SIZE IS NOW Explanation: This message is issued in response to a
size2. failure of a READ function on the bootstrap data set
(BSDS). Users should check any previous error
Explanation: The specified virtual buffer pool could
messages issued by MVS and DB2 against the
not be expanded to the requested size (size1). The
corresponding BSDS. RC and RSN indicate an error
associated group buffer pool is connected, and the local
return code and reason code from the BSDS function.
cache vector could not be expanded to cover the
requested virtual buffer pool size. System Action: Processing continues.
The local cache vector is a bit array which tracks Operator Response: Notify the system programmer.
whether the page in a given buffer was modified by
System Programmer Response: Analyze the return
another system (cross-invalidated). There must be one
and reason codes to determine what type of error
bit in the vector for each buffer in the virtual buffer pool
occurred. Refer to message DSNJ107I for more
and hiperpool. For more information on the local cache
information.
vector, see MVS/ESA Programming: Sysplex Services
Reference.
DSNB552I BSDS WRITE ERROR, RC= integer,
System Action: DB2 downgrades the expansion
RSN= integer
request to the size that can be supported by the
available local cache vector storage (size2). Explanation: This message is issued in response to a
failure of a WRITE function on the bootstrap data set
System Programmer Response: Free local cache
(BSDS). Check any previous error messages issued by
vector storage by contracting or deleting other buffer
MVS and DB2 against the corresponding BSDS. RC
pools that are connected to a group buffer pool. Then
and RSN indicate an error return code and reason code
reattempt the virtual pool expansion by reissuing the
from the BSDS function.
ALTER BUFFERPOOL command.
System Action: Processing continues.
Operator Response: Notify the system programmer.
System Programmer Response: Analyze the return
and reason codes to determine what type of error
170 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB553I • DSNB605I
occurred. Refer to message DSNJ108I for more area (SQLCA) or messages. An SQLCODE -904
information. (resource not available) is returned to the user.
Operator Response: Notify the system programmer.
DSNB553I BSDS INSERT ERROR, RC= integer,
System Programmer Response: Use the ALTER
RSN= integer
TABLESPACE or ALTER INDEX statement to modify
Explanation: This message is issued in response to a affected table spaces or indexes to indicate a usable
failure of an INSERT function on the bootstrap data set buffer pool. Use the DISPLAY BUFFERPOOL command
(BSDS). Check any previous error messages issued by to determine a usable buffer pool. If necessary, use the
MVS and DB2 against the corresponding BSDS. RC ALTER BUFFERPOOL command to activate the failing
and RSN indicate an error return code and reason code buffer pool by setting its VPSIZE to a nonzero value.
from the BSDS function.
System Action: Processing continues. DSNB603I INSUFFICIENT VIRTUAL STORAGE TO
CREATE/EXPAND VIRTUAL BUFFER
Operator Response: Notify the system programmer.
POOL bpname TO SPECIFIED SIZE
System Programmer Response: Analyze the return integer. VIRTUAL BUFFER POOL SIZE
and reason codes to determine what type of error IS NOW integer.
occurred. For more information, refer to message
Explanation: A virtual buffer pool could not be created
DSNJ109I or other DSNJ messages related to BSDS.
or expanded to the requested size. Insufficient virtual
storage exists within the ssnmDBM1 address space to
DSNB601I BUFFER POOL bpname FULL build the virtual buffer pool. The virtual buffer pool size
is set by the ALTER BUFFERPOOL command and can
Explanation: A buffer is required to access a be queried by using the DISPLAY BUFFERPOOL
database page that is not currently contained within the command.
virtual buffer pool. A buffer cannot be assigned because
all buffers in the virtual buffer pool are in a System Action: The virtual buffer pool is created or
nondisplaceable state. (Buffers are in a nondisplaceable expanded to the size allowed by the available virtual
state when they contain actively referenced pages or storage. If the virtual buffer pool cannot be created at
updated pages for which writes are pending.) all, and the creation request was triggered by a page
set open by an application, then an SQLCODE -904
This message can occur if there is an overload of (resource not available) is returned to the user. Reason
concurrent activity for the buffer pool size. The variable code 00C200E8 and the buffer pool external name are
bpname is the buffer pool external name. recorded in the cursor table (CT), which is available in
System Action: Reason code 00C200E9 and the the SQL communication area (SQLCA) or messages.
buffer pool external name are recorded in the cursor Operator Response: Notify the system programmer.
table (CT), which is available in the SQL communication
area (SQLCA) or messages. An SQLCODE -904 System Programmer Response: Analyze the virtual
(resource not available) is returned to the user. storage content of the ssnmDBM1 address space to
determine further action. If appropriate, use the ALTER
Operator Response: Notify the system programmer. TABLESPACE or ALTER INDEX statement to use a
System Programmer Response: Do one of the different buffer pool. Otherwise, use ALTER
following: BUFFERPOOL commands to balance virtual storage
v Reduce concurrent activity by reducing the number of use for all buffer pools.
DB2 threads.
v Use the ALTER BUFFERPOOL command to increase DSNB605I UNABLE TO CREATE VIRTUAL
the size of the virtual buffer pool. BUFFER POOL bpname TO SPECIFIED
SIZE DURING STARTUP/RESTART.
DSNB602I UNABLE TO CREATE BUFFER POOL INSUFFICIENT VIRTUAL STORAGE
bpname. VIRTUAL BUFFER POOL SIZE Explanation: An attempt to create the virtual buffer
IS ZERO pool failed at the time that DB2 was performing its
Explanation: An attempt to create the buffer pool startup or restart processing. Insufficient virtual storage
failed while opening a DB2 table space or index that exists within the ssnmDBM1 address space for building
specified its use. The virtual buffer pool size for bpname the virtual buffer pool. The name of the buffer pool is
was zero. This indicates that the use of the pool is bpname.
invalid. System Action: The buffer pool is not created. The
System Action: Reason code 00C200E0 and the table space or index open request, which triggered the
buffer pool external name are recorded in the cursor attempt to create the buffer pool, fails. An SQLCODE
table (CT), which is available in the SQL communication -904 (resource not available) is returned to the user.
Reason code 00C200E8 and the buffer pool external
Chapter 5. DB2 Messages 171
DSNB606I • DSNB610I
name are recorded in the cursor table (CT), which is returned from the MVS DSPSERV macro.
available in the SQL communication area (SQLCA) or
Variables rr and cccc identify the return and reason
messages.
codes for the failure.
Operator Response: Notify the system programmer.
System Action: The hiperpool is not created.
This message remains on the console until the operator
However, the failure of the hiperpool creation does not
deletes it.
have any impact on the creation of the corresponding
System Programmer Response: Analyze the virtual virtual buffer pool.
storage content of the DSNDBM1 ssnmDBM1 address
Operator Response: Notify the system programmer.
space to determine further action. If appropriate, use
ALTER BUFFERPOOL commands to balance virtual System Programmer Response: For more
storage use for all buffer pools. information about the failure, look up the identified
return and reason codes in MVS/ESA Programming:
Authorized Assembler Services Reference, Volumes
DSNB606I INSUFFICIENT VIRTUAL STORAGE TO
1-4.
CREATE/EXPAND HIPERPOOL bpname
TO SPECIFIED SIZE integer
HIPERPOOL SIZE IS NOW integer DSNB609I VIRTUAL BUFFER POOL bpname
CREATED USING DEFAULT SIZE
Explanation: A hiperpool could not be created or
integer DURING STARTUP/RESTART.
expanded to the requested size. Insufficient virtual
VIRTUAL BUFFER POOL SIZE IS ZERO
storage exists within the DSNDBMI address to build the
buffer control structures for managing the hiperpool. The Explanation: While activating a buffer pool during DB2
hiperpool size is set by the ALTER BUFFERPOOL startup or restart processing, the virtual buffer pool size
command. Its size can be queried with the DISPLAY was zero. A zero value might be caused by an unusable
BUFFER command. Approximately 20MB of virtual bootstrap data set (BSDS) or by a DB2 abnormal
storage is required to construct a 2GB hiperpool. termination after buffer pool size was altered to zero.
The name of the buffer pool is bpname and the default
System Action: The hiperpool is created or expanded
buffer pool size is integer.
to the size allowed by the available virtual storage.
System Action: DB2 creates the virtual buffer pool
Operator Response: Notify the system programmer.
using the startup restart default value. For 4KB/32KB
System Programmer Response: Analyze the virtual page-type buffer pools, the default values are 1000 and
storage content of the DSNDBMI address space for 12, respectively.
more information. If necessary, rebalance buffer pool
Operator Response: Notify the system programmer.
virtual storage use for all active buffer pools with the
This message remains on the console until deleted by
ALTER BUFFERPOOL command.
the operator.
System Programmer Response: Use the ALTER
DSNB607I UNABLE TO CREATE HIPERPOOL
TABLESPACE or ALTER INDEX statement to modify the
bpname NO EXPANDED STORAGE ON
affected table spaces or indexes to indicate a usable
THE SYSTEM
buffer pool. To determine a usable buffer pool, use the
Explanation: DB2 is unable to create an ESO DISPLAY BUFFERPOOL command. If necessary, use
hiperspace to back the hiperpool because there is no the ALTER BUFFERPOOL command to activate the
expanded storage on the system. failing buffer pool by setting the VPSIZE to a nonzero
value.
System Action: The hiperpool is not created.
However, the failure of the hiperpool creation does not
have any impact on the creation of the corresponding DSNB610I UNABLE TO CREATE HIPERPOOL
virtual buffer pool. bpname - ASYNCHRONOUS DATA
MOVER FACILITY NOT INSTALLED
Operator Response: Notify the system programmer.
Explanation: One of the following events occurred:
System Programmer Response: Because there is no
expanded storage on the system, set the hiperpool size v DB2 was building a buffer pool in response to a table
to zero for all buffer pools. space open request and noted that the hiperpool size
for the buffer pool was nonzero.
v An ALTER BUFFERPOOL command specified a
DSNB608I UNABLE TO CREATE HIPERPOOL
nonzero hiperpool size for an active buffer pool.
bpname RETURN CODE = rr REASON
CODE = cccc However, the hiperpool could not be created since the
Asynchronous Data Mover Facility was not installed on
Explanation: DB2 is unable to create an ESO
| the system and the system does not support the Fast
hiperspace to back the hiperpool because of an error
| Synchronous Data Mover Facility.
172 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB611I • DSNB743I
This message is issued by the following CSECT:
DSNB741I csect-name DUPLEXING COULD NOT
| DSNB1OPS, DSNB1ABP BE ESTABLISHED FOR GROUP
System Action: The hiperpool is not created. BUFFER POOL gbpname REASON =
However, the absence of the hiperpool has no impact reason
on the virtual buffer pool.
Explanation: DB2 was unable to establish duplexing
Operator Response: Notify the system programmer. for the named group buffer pool. reason indicates the
DB2 reason code indicating why duplexing could not be
System Programmer Response: Since hiperpools established.
cannot be created, set the hiperpool size for all buffer
pools to zero. System Action: The group buffer pool goes back to
simplex mode.
DSNB611I HIPERPOOL bpname DELETED — System Programmer Response: See the explanation
ASYNCHRONOUS DATA MOVER for the reason code given.
FACILITY IS INOPERATIVE
Explanation: DB2 was trying to access data in an DSNB742I csect-name DUPLEXING HAS BEEN
existing hiperpool and received a failure from the SUCCESSFULLY ESTABLISHED FOR
Asynchronous Data Mover Facility indicating that it was GROUP BUFFER POOL gbpname
inoperative.
Explanation: The process to establish duplexing for
System Action: The hiperpool is deleted. However, the named group buffer pool has successfully
the absence of the hiperpool has no impact on the completed.
virtual buffer pool.
This message is preceded by message DSNB740I
Operator Response: Notify the system programmer. which indicates the reason why duplexing was initiated.
This message remains on the console until deleted by This message is issued by each DB2 member
the operator. participating in establishing duplexing.
System Programmer Response: Take appropriate System Action: Processing of mainline requests is
action to restore the availability of the Asynchronous resumed for the group buffer pool. Writes of changed
Data Mover Facility. Once the Asynchronous Data pages to the group buffer pool will be duplexed writes
Mover Facility becomes available, use the ALTER from this point forward.
BUFFERPOOL command to rebuild the hiperpool.
DSNB743I csect-name DUPLEXING IS BEING
DSNB740I csect-name ATTEMPTING TO STOPPED FOR GROUP BUFFER POOL
ESTABLISH DUPLEXING FOR GROUP gbpname, FALLING BACK TO PRIMARY
BUFFER POOL gbpname REASON = REASON = reason1 DB2 REASON
reason CODE = reason2
Explanation: DB2 has been requested to establish Explanation: Duplexing is being stopped for the
duplexing for the named group buffer pool. reason named group buffer pool. To stop the duplexing, the
indicates the reason why duplexing was initiated. reason secondary group buffer pool will be deallocated, and
can be one of the following: DB2 will go back to simplex mode on the primary group
buffer pool.
OPERATOR
The operator initiated a SETXCF command to reason1 indicates why duplexing was stopped:
initiate duplexing.
OPERATOR
POLICY The operator initiated an MVS command to
The currently active CFRM policy indicated that stop duplexing.
duplexing should be automatically established
POLICY
for the group buffer pool.
A new CFRM policy has been activated which
specifies DUPLEX(DISABLED) for the group
This message is issued by each DB2 member buffer pool.
participating in establishing duplexing.
LOSSCONNSEC
System Action: The DB2 members that are actively One or more of the DB2 members lost
connected to the named group buffer pool participate in connectivity to the secondary group buffer pool
establishing duplexing for the group buffer pool. Access structure.
to the group buffer pool is quiesced while duplexing is
being established. STRFAILSEC
The secondary group buffer pool structure
failed.
Chapter 5. DB2 Messages 173
DSNB744I • DSNB749I
DB2REASON DB2REASON
DB2 decided to stop duplexing. The reason DB2 decided to stop duplexing. The reason
code given in reason2 indicates why DB2 code given in reason2 indicates why DB2
stopped duplexing. stopped duplexing.
DUPCONNCHG
If reason1 indicates ’DB2REASON’, then reason2
Duplexing rebuild stopped because of
specifies a DB2 reason code that indicates why DB2
insufficient connectivity due to a change in the
stopped duplexing. If reason1 is not ’DB2REASON’,
set of connectors.
then reason2 is zero.
If reason1 indicates ’DB2REASON’, then reason2
This message is issued by each DB2 member
specifies a DB2 reason code that indicates why DB2
connected to the duplexed group buffer pool.
stopped duplexing. If reason1 is not ’DB2REASON’,
then reason2 is zero. System Action: The primary group buffer pool
structure is discarded, and DB2 enters back into
This message is issued by each DB2 member simplex mode on the secondary group buffer pool
connected to the duplexed group buffer pool. structure. If DUPLEX(AUTO) is specified in the active
CFRM policy for the group buffer pool, then duplexing
System Action: The secondary group buffer pool
will be automatically reinitiated, if duplexing is still
structure is discarded, and DB2 enters back into
possible.
simplex mode on the primary group buffer pool
structure. If DUPLEX(AUTO) is specified in the active System Programmer Response: If the rebuild
CFRM policy for the group buffer pool, then duplexing stopped because of “DB2REASON”, see the
will be automatically reinitiated, if duplexing is still explanation for the reason code given. If duplexing is
possible. not automatically reinitiated and duplexing is desired for
the group buffer pool, then use the MVS SETXCF
System Programmer Response: If the rebuild
command to reestablish duplexing.
stopped because of “DB2REASON”, see the
explanation for the reason code given. If duplexing is
not automatically reinitiated and duplexing is desired for DSNB745I csect-name THE TRANSITION BACK TO
the group buffer pool, then use the MVS SETXCF SIMPLEX MODE HAS COMPLETED
command to reestablish duplexing. FOR GROUP BUFFER POOL gbpname
Explanation: The named group buffer pool has
DSNB744I csect-name DUPLEXING IS BEING completed the transition from duplex mode back to
STOPPED FOR GROUP BUFFER POOL simplex mode.
gbpname, SWITCHING TO SECONDARY
This message is preceded either by message
REASON = reason1 DB2 REASON
DSNB743I or by message DSNB744I which indicates
CODE = reason2
the reason why duplexing was stopped. This message
Explanation: Duplexing is being stopped for the is issued by each DB2 member connected to the group
named group buffer pool. To stop the duplexing, the buffer pool.
primary group buffer pool will be deallocated, and DB2
System Action: The group buffer pool is now back in
will switch to the the secondary group buffer pool to go
simplex mode which means that writes of changed
back to simplex mode.
pages to the group buffer pool are now simplexed. If
reason1 indicates why duplexing was stopped: REDUPLEX(YES) is specified in the active CFRM policy
for the group buffer pool, then duplexing will be
OPERATOR
automatically reinitiated, if duplexing is still possible.
The operator initiated an MVS command to
This would mean that the group buffer pool is only
stop duplexing.
temporarily back into simplex mode (it is soon to be
POLICY entered back into duplex mode).
A new CFRM policy has been activated which
specifies DUPLEX(DISABLED) for the group
DSNB749I GBPCACHE NO IS NOT ALLOWED
buffer pool.
FOR gbpname BECAUSE IT IS
LOSSCONNPRI DUPLEXED
One or more of the DB2 members lost
Explanation: This message is issued in response to
connectivity to the primary group buffer pool
an ALTER GROUPBUFFERPOOL command that
structure.
requests a change of the GBPCACHE attribute from
STRFAILPRI YES to NO, but because the group buffer pool is
The primary group buffer pool structure failed. duplexed, the change from YES to NO is not allowed.
System Action: The request to change from
174 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB750I • DSNB755I
GBPCACHE(YES) to GBPCACHE(NO) is rejected. System Action: Processing continues, but the
information displayed is incomplete.
System Programmer Response: GBPCACHE(NO)
and duplexing are mutually exclusive. If you want
GBPCACHE(NO), then you must put the group buffer in DSNB752I GROUP DETAIL STATISTICS ARE NOT
simplex mode before specifying GBPCACHE(NO). To AVAILABLE FOR THE GROUP BUFFER
put a duplexed group buffer pool in simplex mode, do POOL BECAUSE A REBUILD IS IN
any of the following procedures: PROGRESS
v Activate a new CFRM policy that specifies Explanation: Because a rebuild is in progress for the
DUPLEX(DISABLED) for the group buffer pool. This group buffer pool, DB2 cannot retrieve group buffer pool
is the preferred method if you do not intend to duplex group (GDETAIL) statistics in response to a DISPLAY
the group buffer pool again for awhile. GROUPBUFFERPOOL command. A preceding
v Ensure that DUPLEX(AUTO) is not specified in the DSNB750I or DSNB751I message identifies the
active CFRM policy for the group buffer pool, and associated group buffer pool.
then issue the MVS command SETXCF
System Action: Processing continues.
STOP,REBUILD,DUPLEX.
DSNB753I GROUP BUFFER POOL STRUCTURE
DSNB750I DISPLAY FOR GROUP BUFFER POOL
OWNER INFORMATION NOT
gbpname FOLLOWS
AVAILABLE IRLM NOTIFY RETURN
Explanation: This message is issued in response to a CODE = retcode IRLM NOTIFY REASON
a DISPLAY GROUPBUFFERPOOL command. It signals CODE = reason
the beginning of a display for group buffer pool
Explanation: DB2 could not retrieve group buffer pool
gbpname if the following are true:
structure owner information for message DSNB798I
v It meets the selection criteria on the command. because the IRLM Notify request did not successfully
v The MVS CFRM administrative policy information for complete. A preceding DSNB750I or DSNB751I
the group buffer pool is accessible. message identifies the associated group buffer pool.
If the CFRM policy information is unavailable, message retcode Return code from IRLM on the Notify request
DSNB751I signals the partial display of group buffer
reason Reason code from IRLM on the Notify request
pool information.
For an explanation of IRLM return and reason codes,
The series of messages DSNB755I through DSNB759I
see “Chapter 59. IRLM Error Return and Reason
provide information on the group buffer pool’s allocation
Codes” on page 1255.
characteristics. Messages DSNB765I through
DSNB769I provide information on DB2 connections to System Action: Processing continues.
the group buffer pool, while DSNB770I through
DSNB788I provide statistics on group buffer pool usage.
Note that all message numbers in the range might not DSNB755I DB2 GROUP BUFFER POOL STATUS
be used. Message DSNB790I ends the display. CONNECTED = status1 CURRENT
DIRECTORY TO DATA RATIO = ratio1
PENDING DIRECTORY TO DATA RATIO
DSNB751I MVS CFRM POLICY INFORMATION = ratio2
NOT AVAILABLE FOR GROUP BUFFER
POOL gbpname MVS IXCQUERY Explanation: In response to a DISPLAY
RETURN CODE = retcode MVS GROUPBUFFERPOOL command, this is the first of two
IXCQUERY REASON CODE = reason A messages displaying information about the status of the
PARTIAL DISPLAY FOLLOWS group buffer pool as it is known to DB2. This message
is followed by DSNB756I. A preceding DSNB750I or
Explanation: DB2 could not retrieve group buffer pool DSNB751I message identifies the associated group
policy information in response to a DISPLAY buffer pool.
GROUPBUFFERPOOL command. Either the MVS
query request (IXCQUERY) did not successfully status1 Whether this DB2 is connected to the group
complete, or the backing structure for the group buffer buffer pool:
pool is not defined in the MVS CFRM administrative YES This DB2 is actively connected to the
policy. To determine the exact reason, examine return group buffer pool.
code retcode and reason code reason returned by MVS
on the query request. For an explanation of the NO This DB2 is not actively connected to
IXCQUERY codes, see MVS/ESA Programming: the group buffer pool.
Sysplex Services Reference. If the IXCQUERY request ratio1 The ratio of directory entries to data pages, as
did not complete successfully, no CONNLIST specified for the current allocation of this group
information, even if requested, is provided.
Chapter 5. DB2 Messages 175
DSNB756I • DSNB758I
buffer pool. If the group buffer pool is not manually issue DB2 -START
currently allocated, this field contains blanks. DATABASE commands to do the
recovery.
ratio2 The desired ratio of directory entries to data
pages to take effect at the next reallocation of
the group buffer pool. DSNB757I MVS CFRM POLICY STATUS FOR
coupling facilityname = status2 MAX SIZE
INDICATED IN POLICY = psize KB
DSNB756I CLASS CASTOUT THRESHOLD =
ALLOCATED = status1
threshold1 % GROUP BUFFER POOL
CASTOUT THRESHOLD = threshold2 % Explanation: For a DISPLAY GROUPBUFFERPOOL
GROUP BUFFER POOL CHECKPOINT command, this message gives the status for the
INTERVAL = interval MINUTES structure associated with the group buffer pool. It is
RECOVERY STATUS = status1 displayed only if DB2 was successful in querying the
AUTOMATIC RECOVERY = MVS CFRM administrative policy. It is immediately
auto-rec-parm preceded by message DSNB756I, and if the structure is
allocated, followed by messages DSNB758I and
Explanation: This is the second of two messages
DSNB759I. A preceding DSNB750I message identifies
displaying information about the status of the group
the associated group buffer pool.
buffer pool as it is known to DB2. If DB2 was successful
in getting MVS CFRM policy information for the group coupling facilityname
buffer pool, messages DSNB757I through DSNB759I The backing coupling facility structure name for
immediately follow this message. A preceding this group buffer pool, such as
DSNB750I or DSNB751I message identifies the DSNCAT_GBP0.
associated group buffer pool.
status2 MVS global status of the backing coupling
threshold1 facility structure:
The threshold at which class castouts are to be
NORMAL
initiated. It is expressed as a percentage of the
Structure is defined in the current
group buffer pool size.
CFRM policy and has no current MVS
threshold2 restrictions.
The threshold at which castout is to be initiated
CHNGP
at the group buffer pool level. It is expressed
Change pending in the structure
as a percentage of the group buffer pool size.
policy.
interval The time, in minutes, between successive
psize The size (in kilobytes) of the coupling facility
initiations of group buffer pool checkpoint.
structure as indicated in the CFRM policy
status1 The recovery status for the group buffer pool: definition.
DAP Damage assessment pending. DB2 is status1 Whether the backing coupling facility structure
in the process of doing damage is currently allocated:
assessment for the group buffer pool
YES The coupling facility structure is
in response to a coupling facility
allocated in a coupling facility.
structure failure. The group buffer pool
is temporarily stopped internally by NO The coupling facility structure is not
DB2 and is unavailable for use until allocated in any coupling facility.
the damage assessment process
completes.
DSNB758I ALLOCATED SIZE = asize KB
NORMAL VOLATILITY STATUS = volstat REBUILD
There is no pending recovery action STATUS = rbldstat CFLEVEL = cfname,
for this group buffer pool. cflevel
auto-rec-parm Explanation: This message is the first of two
Automatic recovery parameter specification: messages giving the allocation details for the group
buffer pool on a DISPLAY GROUPBUFFERPOOL
YES DB2 should automatically initiate
command. It is issued only if DB2 determines, by
recovery for the objects using this
successfully querying the MVS CFRM policy, that the
group buffer pool following a failure of
group buffer pool is allocated. It is immediately
the group buffer pool. This is the
preceded by message DSNB757I. A preceding
default.
DSNB750I message identifies the associated group
NO DB2 should not initiate automatic buffer pool.
group buffer pool recovery. If the
group buffer pool fails, you must
176 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB759I • DSNB761I
asize The actual allocated group bufferpool structure dir# Actual number of directory entries allocated for
size (in kilobytes). the coupling facility structure.
volstat The volatility status of the backing group buffer data# Actual number of data pages allocated for the
pool structure for this group buffer pool: coupling facility structure.
VOLATILE conn# The number of DB2 subsystems that are
The backing coupling facility structure connected to the coupling facility structure.
is volatile. This includes both active connections and
failed-persistent connections. The CONNLIST
NON-VOLATILE
option of the DISPLAY GROUPBUFFERPOOL
The backing coupling facility structure
command gives details of the connection
is non-volatile.
status.
rbldstat Inidication of whether or not rebuild is in
progress for the group buffer pool structure,
DSNB760I GBPCACHE OPTION SET TO value
and if so, which part of the rebuild process is
FOR gbpname. IT WILL TAKE EFFECT
happening:
ON THE NEXT REALLOCATION
NONE Rebuild is not in progress.
Explanation: This message is issued in response to
QUIESCE an ALTER GROUPBUFFERPOOL command that
Rebuild is in progress and the rebuild requests a change in the GBPCACHE attribute. It is
is currently in the rebuild quiesce also issued for the first ALTER GROUPBUFFERPOOL
phase. command for a group buffer pool, even when the
GBPCACHE option is not specified on the command.
CONNECT (In this case, the message shows YES for the
Rebuild is in progress and the rebuild GBPCACHE option.) The new setting takes effect the
is currently in the rebuild connect next time the coupling facility cache structure is
phase. allocated.
CLEANUP System Programmer Response: Use the MVS
The rebuild has completed, and the command SETXCF START, REBUILD command when
connected DB2 members are making you are ready for the change to take effect.
final preparations to use the new
group buffer pool structure. System Action: Processing continues.
STOPPING
The rebuild is stopping, and the DSNB761I THE NEW SETTING WILL TAKE
connected DB2 members are making EFFECT AFTER THE GBPCACHE
preparations to fall back to the original ATTRIBUTE HAS BEEN CHANGE TO
group buffer pool structure. YES
cfname The coupling facility level for the coupling Explanation: This message is issued in response to
facility in which this group buffer pool is an ALTER GROUPBUFFERPOOL command that
allocated. requests a change to RATIO, CLASST, GBPOOLT or
GBPCHKPT when GBPCACHE NO is also specified on
cflevel The coupling facility level for the coupling the command or when the current GBPCACHE attribute
facility in which this group buffer pool is is NO. The new setting takes effect the next time the
allocated. coupling facility cache structure is allocated after the
GBPCACHE attribute has been changed to YES.
DSNB759I NUMBER OF DIRECTORY ENTRIES = System Programmer Response: Use the ALTER
dir# NUMBER OF DATA PAGES = data# GROUPBUFFERPOOL command to change the
NUMBER OF CONNECTIONS = conn# GBPCACHE attribute to YES and the MVS command
Explanation: This message is the second of two SETXCF START, REBUILD when you are ready for the
messages giving the allocation details for the group change to take effect.
buffer pool for a DISPLAY GROUPBUFFERPOOL System Action: Processing continues.
command. It is issued only if DB2 determines, by
successfully querying the MVS CFRM administrative
policy, that the group buffer pool is allocated. It is
immediately preceded by message DSNB758I. A
preceding DSNB750I message identifies the associated
group buffer pool.
Chapter 5. DB2 Messages 177
DSNB762I • DSNB765I
buffer pool that does not match the ″GBPCACHE NO″
DSNB762I DUPLEXING STATISTICS FOR
criterion.
secondary-gbpname WRITES CHANGED
PAGES = s1 FAILED DUE TO LACK OF System Action: The display is terminated for this
STORAGE = s2 CHANGED PAGES group buffer pool. Command processing continues, if
SNAPSHOT VALUE = s3 there are other group buffer pool names to process.
Explanation: This message is displayed as a result of
the DISPLAY GROUPBUFFERPOOL command with the DSNB764I DUPLEXING STATISTICS FOR
GDETAIL option if the group buffer pool is duplexed. It secondary-gbpname WRITES CHANGED
lists the statistics on writes to the secondary group PAGES = s1 FAILED DUE TO LACK OF
buffer pool and the total number of changed pages for STORAGE = s2 ASYNCHRONOUS
the secondary group buffer pool. secondary-gbpname is COMPLETION CHECKS = s3
the normal group buffer pool name (such as GBP0)
suffixed with ’-SEC’. Explanation: This message is displayed as a result of
the DISPLAY GROUPBUFFERPOOL command with the
s1 Changed page write hit counter. Number of MDETAIL option if the group buffer pool is duplexed. It
times a coupling facility write request for a lists the statistics on writes to the secondary group
changed page successfully completed. If the buffer pool. secondary-gbpname is the normal group
group buffer pool has been duplexed for the buffer pool name (e.g. GBP0) suffixed with ’-SEC’.
entire reporting interval, then this number
should be roughly equal to the changed page s1 Coupling facility write requests for changed
write hit counter reported in message pages. If the group buffer pool has been
DSNB786I for the primary group buffer pool. duplexed for the entire reporting interval, then
However, due to timing windows in gathering this number should be roughly equal to the
the counter information for the display, or due sum of the synchronous writes of changed
to previous transaction failures that might have pages to the primary group buffer pool
occurred, the counts might not be exactly the (indicated in message DSNB776I) and the
same. asynchronous writes of changed pages to the
primary group buffer pool (indicated in
s2 Write miss cache full counter. Number of message DSNB777I). However, due to timing
times a coupling facility write request was not windows in gathering the counter information
completed because of a lack of storage in the for the display, or due to previous transaction
secondary group buffer pool. failures that may have occurred, the counts
may not be exactly the same.
s3 Total changed counter. Snapshot value of the
current number of changed pages in the s2 Coupling facility write requests that were not
secondary group buffer pool. The displayed completed because of a lack of storage in the
value of this counter is not affected by whether secondary group buffer pool.
this is an incremental or cumulative display. If
the group buffer pool is duplexed, then this s3 The number of times DB2 checked for the
number should be roughly equal to the total completion of the write of a changed page to
changed counter reported in message the secondary group buffer pool, but the write
DSNB786I for the primary group buffer pool. had not yet completed and thus the transaction
However, due to timing windows in gathering had to wait until the write to the secondary
the counter information for the display, or due group buffer pool completed.
to previous transaction failures that might have
occurred, the counts might not be exactly the For information about the Member Detail Report, see
same. DB2 Data Sharing: Planning and Administration.
For information about the Group Detail Report, see DB2 DSNB765I NO CONNLIST REPORT IS
Data Sharing: Planning and Administration . GENERATED. THERE ARE NO
CONNECTIONS TO THIS GROUP
DSNB763I gbpname IS NOT DEFINED WITH BUFFER POOL.
GBPCACHE NO Explanation: DB2 displays this message in response
Explanation: This message is issued in response to a to a DISPLAY GROUPBUFFERPOOL command with
DISPLAY GROUPBUFFERPOOL command with the CONNLIST option when there are currently no
TYPE(NOCACHE) and either one name or a list of connection names to report for the group buffer pool. A
names specified in the selection list. The specified preceding DSNB750I message identifies the associated
group buffer pool is not defined with GBPCACHE NO, group buffer pool.
and therefore does not meet the qualification to be
displayed. This message is issued once for each group
178 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB766I • DSNB773I
DSNB766I THE CONNLIST REPORT FOLLOWS DSNB770I MEMBER DETAIL STATISTICS ARE
NOT AVAILABLE FOR THE GROUP
Explanation: DB2 displays this message in response
BUFFER POOL. THIS DB2 HAS NEVER
to a DISPLAY GROUPBUFFERPOOL command with
BEEN CONNECTED TO THE GROUP
the CONNLIST option to indicate the beginning of the
BUFFER POOL.
CONNLIST display for this group buffer pool. A
preceding DSNB750I message identifies the associated Explanation: This message is issued in response to a
group buffer pool. DISPLAY GROUPBUFFERPOOL command with
MDETAIL specified. MDETAIL statistics are not available
for the requested group buffer pool because this DB2
DSNB767I CONNECTION NAME = conname,
has not connected to the group buffer pool since
CONNECTION STATUS = status
startup. A preceding DSNB750I or DSNB751I message
CONNECTOR’S RELEASE = DB2
identifies the associated group buffer pool.
release
System Action: Processing continues.
Explanation: This message contains the display
information that results from a DISPLAY
GROUPBUFFERPOOL command with the CONLIST DSNB771I INCREMENTAL MEMBER DETAIL
option. One DSNB767I message is issued for each STATISTICS SINCE basetime
defined connection to the group buffer pool. The
Explanation: This message is displayed in response
associated group buffer pool is identified on a preceding
to the DISPLAY GROUPBUFFERPOOL command with
DSNB750I message.
MDETAIL(INTERVAL) specified. It indicates the start
conname time of the interval for which the statistics were
Name of the connection. DB2 subsystems use accumulated. This is the time of the previous MDETAIL
the DB2 member name as the connection incremental display on this DB2 or the time DB2 first
name. connected to the group buffer pool if there was no
previous MDETAIL incremental display. A preceding
status Status of the connection.
DSNB750I or DSNB751I message identifies the
A Active. associated group buffer pool.
F Failed-Persistent. System Action: Processing continues.
D Dually connected to both the original
structure and the new structure during DSNB772I CUMULATIVE MEMBER DETAIL
a rebuild. STATISTICS SINCE basetime
DB2 release Explanation: This message is displayed in response
The release of the connected DB2. to the DISPLAY GROUPBUFFERPOOL command with
MDETAIL(*) specified. It indicates the start time of the
interval for which the statistics were accumulated. This
DSNB768I THERE ARE NO GROUP BUFFER is the time this DB2 first connected to the group buffer
POOLS DEFINED WITH GBPCACHE NO pool. A preceding DSNB750I or DSNB751I message
Explanation: This message is issued in response to a identifies the associated group buffer pool.
DISPLAY GROUPBUFFERPOOL command with the System Action: Processing continues.
TYPE(NOCACHE) option and an asterisk (*) specified
as the selection list when DB2 determines that there are
no group buffer pools defined with the GBPCACHE(NO) DSNB773I MEMBER DETAIL STATISTICS
attribute. SYNCHRONOUS READS DUE TO
BUFFER INVALIDATION DATA
System Action: Command processing is terminated. RETURNED = r1 DATA NOT RETURNED
= r2
DSNB769I THE CONNLIST REPORT IS Explanation: This is the first of eight messages
COMPLETE containing local statistics, displayed as a result of the
Explanation: DB2 displays this message in response DISPLAY GROUPBUFFERPOOL command with the
to a DISPLAY GROUPBUFFERPOOL command with MDETAIL option. It lists some synchronous read
the CONNLIST option to indicate the end of the statistics for the group buffer pool. A preceding
CONNLIST display for this group buffer pool. A DSNB750I or DSNB751I message identifies the
preceding DSNB750I message identifies the associated associated group buffer pool. Messages DSNB774I,
group buffer pool. DSNB775I, DSNB789I, and DSNB776I through
DSNB779I always follow this one.
The counter descriptions are listed below. In the
descriptions, the term “synchronous” means that the
Chapter 5. DB2 Messages 179
DSNB774I • DSNB777I
coupling facility interaction is done under the DB2 user’s buffer pool following the RPL request (these
execution unit. pages were retrieved from DASD). Note that if
RPL is in use, then there are not any coupling
r1 Synchronous coupling facility read requests
facility interactions associated with this number;
issued because the virtual buffer or hiperpool
this number is incremented when the RPL
buffer was marked “invalid”. Data is
feedback indicates that the page is not cached
successfully returned from the group buffer
in the GBP, and so DB2 can avoid a coupling
pool.
facility read request for the page and go
r2 Synchronous coupling facility read requests directly to DASD.
issued because the virtual buffer or hiperpool
r6 If RPL is not in use, then this is the number of
buffer was marked “invalid”. Data is not
coupling facility read requests issued for
returned from the group buffer pool.
prefetch where data is returned from the group
buffer pool.
DSNB774I DUE TO DATA PAGE NOT IN BUFFER
If RPL is in use, then this number should be
POOL DATA RETURNED = r3 DATA
zero.
NOT RETURNED = r4
Explanation: This is the second of eight messages
DSNB776I SYNCHRONOUS WRITES CHANGED
containing local statistics, displayed as a result of the
PAGES = w1 CLEAN PAGES = w2
DISPLAY GROUPBUFFERPOOL command with the
MDETAIL option. It lists more local synchronous read Explanation: This is the fifth of eight messages
statistics for the group buffer pool. A preceding containing local statistics, displayed as a result of the
DSNB750I or DSNB751I message identifies the DISPLAY GROUPBUFFERPOOL command with the
associated group buffer pool. This message is always MDETAIL option. It lists some local write statistics for
preceded by message DSNB773I and followed by the group buffer pool. A preceding DSNB750I or
messages DSNB775I, DSNB789I, and DSNB776I DSNB751I message identifies the associated group
through DSNB779I. buffer pool. This message is always preceded by
messages DSNB773I through DSNB775I and
The counter descriptions are listed below. In the
DSNB789I and followed by messages DSNB777I
descriptions, the term ″synchronous″ means that the
through DSNB779I.
coupling facility interaction is done under the DB2 user’s
execution unit. The counter descriptions are listed below. In the
descriptions, the term ″synchronous″ means that the
r3 Synchronous coupling facility read requests
coupling facility interaction is done under the DB2 user’s
issued because the required data was not in
execution unit.
the virtual buffer pool or in the hiperpool buffer.
Data is successfully returned from the group w1 Synchronous coupling facility write requests for
buffer pool. changed pages
r4 Synchronous coupling facility read requests w2 Synchronous coupling facility write requests for
issued because the required data was not in clean pages
the virtual buffer pool or hiperpool buffer. Data
is not returned from the group buffer pool.
DSNB777I ASYNCHRONOUS WRITES CHANGED
PAGES = w3 CLEAN PAGES = w4
DSNB775I PREFETCH READS DATA NOT FAILED WRITES DUE TO LACK OF
RETURNED = r5 REGISTER PAGE LIST STORAGE = w5
NOT AVAILABLE DATA RETURNED = r6
Explanation: This is the sixth of eight messages
Explanation: This is the third of eight messages containing local statistics, displayed as a result of the
containing local statistics, displayed as a result of the DISPLAY GROUPBUFFERPOOL command with the
DISPLAY GROUPBUFFERPOOL command with the MDETAIL option. It lists local write and
MDETAIL option. It lists some prefetch read statistics for cross-invalidation statistics for the group buffer pool. A
the group buffer pool. A preceding DSNB750I or preceding DSNB750I or DSNB751I message identifies
DSNB751I message identifies the associated group the associated group buffer pool. This message is
buffer pool. always preceded by messages DSNB773I through
DSNB775I, DSNB789I, and DSNB776I and followed by
r5 If the ″register page list″ (RPL) function is not
messages DSNB778I and DSNB779I.
in use, then this is the number of coupling
facility read requests issued for prefetch where The counter descriptions are listed below. In the
data is not returned from the group buffer pool. descriptions, the term ″asynchronous″ means that the
coupling facility interaction is done under a DB2 system
If RPL is in use, then this is the number of
execution unit, such as with a prefetch.
pages that were not retrieved from the group
180 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB778I • DSNB783I
w3 Asynchronous coupling facility write requests
DSNB780I GROUP DETAIL STATISTICS ARE NOT
for changed pages
AVAILABLE FOR THE GROUP BUFFER
w4 Asynchronous coupling facility write requests POOL. THIS DB2 IS NOT CURRENTLY
for clean pages CONNECTED TO THE GROUP BUFFER
POOL.
w5 Coupling facility write requests that were not
completed because of a lack of storage in the Explanation: DB2 could not retrieve group buffer pool
group buffer pool. group (GDETAIL) statistics in response to a DISPLAY
GROUPBUFFERPOOL command because this DB2
subsystem is not currently connected to the group buffer
DSNB778I CASTOUT THRESHOLDS DETECTED pool. A preceding DSNB750I or DSNB751I message
FOR CLASSES = t1 FOR GROUP identifies the associated group buffer pool.
BUFFER POOL = t2 GBP
CHECKPOINTS TRIGGERED = k1 System Action: Processing continues.
PARTICIPATION IN REBUILD = k2
Explanation: This is the seventh of ten messages DSNB781I GROUP DETAIL STATISTICS ARE NOT
containing local statistics, displayed as a result of the AVAILABLE FOR THE GROUP BUFFER
DISPLAY GROUPBUFFERPOOL command with the POOL. MVS IXLCACHE RETURN CODE
MDETAIL option. It lists local castout threshold statistics = retcode MVS IXLCACHE REASON
for the group buffer pool and also group buffer pool CODE = reason
checkpoint and rebuild statistics. A preceding DSNB750I
Explanation: DB2 could not retrieve group buffer pool
or DSNB751I message identifies the associated group
group (GDETAIL) statistics in response to a DISPLAY
buffer pool. This message is always preceded by
GROUPBUFFERPOOL command because the statistics
messages DSNB773I through DSNB775I, DSNB789I,
request (IXLCACHE macro) did not successfully
DSNB776I, and DSNB777I and followed by messages
complete. A preceding DSNB750I or DSNB751I
DSNB796I, DSNB779I, and DSNB797I.
message identifies the associated group buffer pool.
Counters:
retcode Return code from MVS on the statistics request
t1 Number of times the class castout threshold
reason Reason code from MVS on the statistics
was detected
request
t2 Number of times the group buffer pool castout
threshold was detected For an explanation of IXLCACHE return and reason
codes, see MVS/ESA Programming: Sysplex Services
k1 Number of group buffer pool checkpoints that
Reference.
were triggered.
System Action: Processing continues.
k2 Number of times that this member participated
in a rebuild of the group buffer pool structure.
DSNB782I INCREMENTAL GROUP DETAIL
STATISTICS SINCE basetime
DSNB779I ENGINES NOT AVAILABLE FOR
CASTOUT = e1 FOR WRITING = e2 Explanation: This message is displayed by the
DISPLAY GROUPBUFFERPOOL command with
Explanation: This is the ninth of ten messages
GDETAIL(INTERVAL) specified. It indicates the start
containing local statistics, displayed as a result of the
time of the interval for which the statistics were
DISPLAY GROUPBUFFERPOOL command with the
accumulated. This is the time of the previous GDETAIL
MDETAIL option. It lists miscellaneous local statistics for
incremental display from this DB2 or the time the group
the group buffer pool. The associated group buffer pool
buffer pool was allocated or reallocated, if there was no
is identified in a preceding DSNB750I or DSNB751I
previous GDETAIL incremental display.
message. This message is always preceded by
messages DSNB773I through DSNB775I, DSNB789I, System Action: Processing continues.
DSNB776I through DSNB778I, and DSNB796I. It is
followed by message DSNB797I.
DSNB783I CUMULATIVE GROUP DETAIL
Counters: STATISTICS SINCE basetime
e1 Engine not available for castout Explanation: This message is displayed in response
to the DISPLAY GROUPBUFFERPOOL command with
e2 Engine not available for coupling facility write
GDETAIL(*) specified. It indicates the start time of the
interval for which the statistics were accumulated. This
is the time the group buffer pool was first allocated or
reallocated.
Chapter 5. DB2 Messages 181
DSNB784I • DSNB787I
System Action: Processing continues. For information about the Group Detail Report, see DB2
Data Sharing: Planning and Administration .
DSNB784I GROUP DETAIL STATISTICS READS
DATA RETURNED = r1 DSNB786I WRITES CHANGED PAGES= w1
CLEAN PAGES = w2 FAILED DUE TO
Explanation: This is the first of five messages
LACK OF STORAGE = w3 CHANGED
containing group statistics, displayed as a result of the
PAGES SNAPSHOT VALUE = p1
DISPLAY GROUPBUFFERPOOL command with the
GDETAIL option. It lists the successful reads for the Explanation: This is the third of five messages
group buffer pool. A preceding DSNB750I or DSNB751I containing group statistics, displayed as a result of the
message identifies the associated group buffer pool. DISPLAY GROUPBUFFERPOOL command with the
This message is always followed by messages GDETAIL option. It is followed by messages DSNB787I
DSNB785I through DSNB788I. and DSNB788I. It lists the statistics on writes to the
group buffer pool and the total number of changed
r1 ″Read hit″ counter. Number of times that a
pages for the group buffer pool. The associated group
page was returned on a coupling facility read
buffer pool is identified in a preceding DSNB750I or
request.
DSNB751I message. This message is always preceded
by messages DSNB784I and DSNB785I.
For information about the Group Detail Report, see DB2
Data Sharing: Planning and Administration . w1 ″Changed page write hit″ counter. Number of
times a coupling facility write request for a
changed page successfully completed.
DSNB785I DATA NOT RETURNED DIRECTORY
ENTRY EXISTED = r2 DIRECTORY w2 ″Clean page write hit″ counter. Number of
ENTRY CREATED = r3 DIRECTORY times a coupling facility write request for a
ENTRY NOT CREATED = r4, r5 clean page completed successfully.
Explanation: This is the second of five messages w3 ″Write miss cache full″ counter. Number of
containing group statistics, displayed as a result of the times a coupling facility write request was not
DISPLAY GROUPBUFFERPOOL command with the completed because of a lack of storage in the
GDETAIL option. It continues the read statistics for the group buffer pool.
group buffer pool. The associated group buffer pool is
p1 ″Total changed″ counter. Snapshot value of the
identified in a preceding DSNB750I or DSNB751I
current number of changed pages. The
message. This message is always preceded by
displayed value of this counter is not affected
message DSNB784I and followed by messages
by whether this is an incremental or cumulative
DSNB786I through DSNB788I.
display.
All the ″read counters″ in this message represent cases
where data was not returned on the coupling facility For information about the Group Detail Report, see DB2
read request. Data Sharing: Planning and Administration .
r2 ″Read miss directory hit″ counter. Number of
times that a coupling facility read request DSNB787I RECLAIMS FOR DIRECTORY ENTRIES
specified a page for which a directory entry = d1 FOR DATA ENTRIES = d2
exists, but no data was cached for that page. CASTOUTS= c1
r3 ″Read miss name assigned″ counter. Number Explanation: This is the fourth of five messages
of times that a coupling facility read request containing group statistics, displayed as a result of the
specified a page for which a directory entry DISPLAY GROUPBUFFERPOOL command with the
was created. GDETAIL option. It is always preceded by messages
DSNB784I through DSNB786I and followed by message
r4 ″Read miss assignment suppressed″ counter.
DSNB788I. It lists the statistics on reclaims and
Number of times that a coupling facility read
castouts for the group buffer pool. The associated group
request specified a page for which no directory
buffer pool is identified in a preceding DSNB750I or
entry exists and no directory entry is created.
DSNB751I message.
r5 ″Read miss cache full″ counter. Number of
d1 ″Directory entry reclaim″ counter. Number of
times that a coupling facility read request
times a name assignment required that a
specified a page for which no directory entry
directory entry be reclaimed by the coupling
exists and no directory entry is created
facility.
because of a lack of storage in the group
buffer pool. d2 ″Data entry reclaim″ counter. Number of times
a name assignment required that a data page
be reclaimed by the coupling facility.
182 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB788I • DSNB793I
c1 ″Castout″ counter. Number of castout ″changed″ in the group buffer pool as a result
operations performed. of feedback from the request to register a list
of pages.
For information about the Group Detail Report, see DB2
r9 Coupling facility read requests done for
Data Sharing: Planning and Administration .
prefetch to retrieve a page marked as ″clean″
in the group buffer pool as a result of feedback
DSNB788I CROSS INVALIDATIONS DUE TO from the request to register a list of pages.
DIRECTORY RECLAIMS = x1 DUE TO
r10 Coupling facility read requests in which a
WRITES = x2 EXPLICIT = x3
directory entry was not created because of a
Explanation: This is the last of five messages lack of storage in the group buffer pool.
containing group statistics, displayed as a result of the
DISPLAY GROUPBUFFERPOOL command with the
DSNB790I DISPLAY FOR GROUP BUFFER POOL
GDETAIL option. It lists the cross-invalidation (XI)
gbpname IS COMPLETE
statistics for the group buffer pool. The associated
group buffer pool is identified in a preceding DSNB750I Explanation: For a DISPLAY GROUPBUFFERPOOL
or DSNB751I message. This message is always command, this message signals the end of the display
preceded by messages DSNB784I through DSNB787I. for group buffer pool gbpname.
x1 ″XI for directory reclaim″ counter. Number of
times a directory entry was reclaimed (stolen) DSNB791I THIS DB2 IS NOT CONNECTED TO
and XI signals had to be sent (that is, the gbpname
stolen directory entry had registered DB2
Explanation: This message is issued in response to a
interest).
DISPLAY GROUPBUFFERPOOL command with
x2 ″XI for write″ counter. Number of times a TYPE(MCONN) and either one name or a list of names
coupling facility write request caused XI to one specified in the selection list. The DB2 on which the
or more registered DB2s. DISPLAY GROUPBUFFERPOOL command was issued
is not currently connected to the specified group buffer
x3 ″XI for explicit invalidation″ counter. Number of
pool. This message is issued once for each group buffer
times an explicit coupling facility XI request
pool that does not match the ″member connectivity″
caused XI to one or more registered DB2s.
criterion.
For more information about these counters, see DB2 System Action: The display is terminated for this
Data Sharing: Planning and Administration. group buffer pool. Command processing continues, if
there are other group buffer pool names to process.
DSNB789I REGISTER PAGE LIST = r7 RETRIEVE
CHANGED PAGES = r8 RETRIEVE DSNB792I NO DB2 IN THE GROUP IS
CLEAN PAGES = r9 FAILED READS CONNECTED TO gbpname
DUE TO LACK OF STORAGE = r10
Explanation: This message is issued in response to a
Explanation: This is the fourth of eight messages DISPLAY GROUPBUFFERPOOL command with
containing local statistics, displayed as a result of the TYPE(GCONN) and either one name or a list of names
DISPLAY GROUPBUFFERPOOL command with the specified in the selection list. No DB2 in the group is
MDETAIL option. It lists more local read statistics for the currently connected to the specified group buffer pool.
group buffer pool. A preceding DSNB750I or DSNB751I This message is issued once for each group buffer pool
message identifies the associated group buffer pool. that does not match the ″group connectivity″ criterion.
The counter descriptions are listed below. System Action: The display is terminated for this
group buffer pool. Command processing continues, if
r7 The number of requests to the coupling facility there are other group buffer pool names to process.
to register interest in a list of pages. DB2 does
this when prefetch (sequential or list) is used
when the following conditions are met: DSNB793I DELETE NAME LIST = s5 READ
v The DB2 member is running on a particular CASTOUT STATISTICS = s6 DELETE
service level of MVS 5.2 or above NAME = s7 OTHER ASYNCHRONOUS
v The GBP is allocated in a coupling facility GBP REQUESTS = s8
with CFLEVEL=2 or above.
Explanation: This message is displayed as a result of
r8 Coupling facility read requests done for the DISPLAY GROUPBUFFERPOOL command with the
prefetch to retrieve a page marked as MDETAIL option if the group buffer pool is duplexed. It
lists the statistics on requests to the secondary group
buffer pool that are related to castout processing and to
garbage collection processing.
Chapter 5. DB2 Messages 183
DSNB794I • DSNB797I
s5 The number of Delete Name List requests to
DSNB795I NO DB2 IN THE GROUP IS
delete a set of pages from the secondary
CONNECTED TO ANY GROUP BUFFER
group buffer pool that have just been cast out
POOL
from the primary. If the group buffer pool has
been duplexed for the entire reporting interval, Explanation: This message is issued in response to a
then this number should be roughly equal to DISPLAY GROUPBUFFERPOOL command with the
the number of Unlock Castout requests to the TYPE(GCONN) option and an asterisk (*) specified as
primary (indicated in message DSNB796I). the selection list. When DB2 successfully determines
(that is, no error is encountered during command
s6 The number of Read Castout Statistics
processing) that there are no group buffer pools
requests to check for ″orphaned data entries″
connected to any DB2 in the data sharing group.
in the secondary group buffer pool. The DB2
member that is the group buffer pool structure System Action: Command processing is terminated.
owner periodically issues these requests to
determine whether garbage collection is
DSNB796I CASTOUTS PAGES CAST OUT = c1
necessary to clean up orphaned data entries
UNLOCK CASTOUT = c2 READ
from the secondary. Orphaned data entries are
CASTOUT CLASS = c3 READ
″changed″ data entries in the secondary group
CASTOUT STATISTICS = c4 READ
buffer pool without a corresponding ″changed″
DIRECTORY INFO = c5
data entry in the primary. Orphaned data
entries are to be expected from time to time Explanation: This is the eighth of ten messages
and do not represent any kind of data containing local statistics, displayed as a result of the
inconsistency problem (because the page has DISPLAY GROUPBUFFERPOOL command with the
already been cast out from the primary and MDETAIL option. It lists local castout statistics for the
such that the version of the page in the group buffer pool. A preceding DSNB750I or DSNB751I
secondary is the same as the version of the message identifies the associated group buffer pool.
page on DASD). Orphaned data entries can be This message is always preceded by messages
introduced by certain transaction or system DSNB773I through DSNB775I, DSNB789I, DSNB776I
failures, or by new group buffer pool write through DSNB778I, and followed by messages
activity that encounters very unlikely timing DSNB779I and DSNB797I.
windows when castout is concurrently
processing. Counters:
s7 The number of Delete Name requests to delete c1 Number of pages cast out.
″orphaned data entries″ from the secondary c2 Number of requests to unlock for castout.
group buffer pool. The DB2 member that is the
group buffer pool structure owner issues these c3 Number of read castout class requests.
requests if it determines that garbage collection c4 Number of read castout statistics requests.
is necessary. See the description above under
s6 for a description of ″orphaned data entries″. c5 Number of read directory info requests. These
requests are made during group buffer pool
s8 The number of asynchronous CF requests sent checkpoint.
to the secondary group buffer pool. This
excludes ASYNCHRONOUS COMPLETION
CHECKS as reported on the DSNB764I DSNB797I OTHER INTERACTIONS REGISTER
message. PAGE = o1 UNREGISTER PAGE = o2
DELETE NAME = o3 READ STORAGE
For information about the Member Detail Report, see STATISTICS = o4 EXPLICIT CROSS
DB2 Data Sharing: Planning and Administration. INVALIDATIONS = o5 ASYNCHRONOUS
GBP REQUESTS = o6
DSNB794I THIS DB2 IS NOT CONNECTED TO Explanation: This is the last of ten messages
ANY GROUP BUFFER POOL containing local statistics, displayed as a result of the
DISPLAY GROUPBUFFERPOOL command with the
Explanation: This message is issued in response to a MDETAIL option. It lists local castout statistics for the
DISPLAY GROUPBUFFERPOOL command with the group buffer pool. A preceding DSNB750I or DSNB751I
TYPE(MCONN) option and an asterisk (*) specified as message identifies the associated group buffer pool.
the selection list. This message is issued when DB2 This message is always preceded by messages
determines that there are no group buffer pools having DSNB773I through DSNB775I, DSNB789I, DSNB776I
″member connectivity″ from the DB2 on which the through DSNB779I, and DSNB796I.
DISPLAY GROUPBUFFERPOOL command was issued.
Counters:
System Action: Command processing is terminated.
184 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB798I • DSNB799I
o1 Number of requests to the coupling facility to the group buffer pool were to fail, DB2 uses
register interest in a single page. each member’s restart/redo LRSN in
conjunction with lrsn1 to determine the starting
o2 Number of requests to the coupling facility to
points for the merged log scan to recover the
remove the registered interest in a single page.
page sets and partitions that are entered into
o3 Number of requests to the coupling facility to group buffer pool recovery pending (GRECP)
delete the directory entries associated with a status. You can do more detailed monitoring of
set of pages. the group buffer pool checkpoint processing
with IFCID 0261.
o4 Number of requests to the coupling facility to
read the statistics counters associated with the member-name2
structure. DB2 generally issues this request The member name of the group buffer pool
once per group buffer pool checkpoint, and structure owner. The structure owner’s
once per GDETAIL request on the DB2 responsibilities include the following:
DISPLAY GROUPBUFFERPOOL command. v Issue the group buffer pool checkpoint.
v Detect the GBPOOLT castout threshold and
o5 Number of explicit cross-invalidations for pages initiate castout if this threshold has been
in the group buffer pool. reached (by notifying the pageset or partition
o6 Number of coupling facility requests to the castout owners).
primary group buffer pool that were converted v Coordinate the damage assessment process
from synchronous to asynchronous. in case the group buffer pool fails.
v Coordinate the rebuild process for the group
buffer pool.
DSNB798I LAST GROUP BUFFER POOL
CHECKPOINTtimestamp MINIMUM ’UNKNOWN’ is displayed if DB2 is not able to
CLEAN-TO-DIRTY LRSN = lrsn1 determine which member is the structure
MINIMUM MEMBER RESTART/REDO owner for the group buffer pool. This should
LRSN = lrsn2, member-name1 only happen in an unexpected error situation.
STRUCTURE OWNER = member-name2 See the message accompanying that error.
Explanation: This message is displayed in response System Action: Processing continues.
to the DISPLAY GROUPBUFFERPOOL command. It is
issued only if DB2 determines, by successfully querying
the MVS CFRM policy, that the group buffer pool is DSNB799I SECONDARY GBP ATTRIBUTES
allocated. It is immediately preceded by message ALLOCATED SIZE = ssize KB
DSNB759I. A preceding DSNB750I message identifies VOLATILITY STATUS = svolstat
the associated group buffer pool. CFNAME = cfname CFLEVEL = cflevel
NUMBER OF DIRECTORY ENTRIES =
timestamp sdir# NUMBER OF DATA PAGES =
The date and time of the last group buffer pool sdata#
checkpoint.
Explanation: For a DISPLAY GROUPBUFFERPOOL
lrsn1 The recovery log record sequence number command, this message gives the attributes of the
(LRSN) that was recorded by the last group secondary group buffer pool if the group buffer pool is
buffer pool checkpoint that reflects the oldest duplexed. It is displayed only if the group buffer pool is
changed page clean-to-dirty LRSN value at the duplexed and if DB2 was successful in querying the
time of the checkpoint. If the group buffer pool MVS CFRM administrative policy. This message is not
were to fail, lrsn1 is used by DB2 as input to displayed if the group buffer pool is in a transition state
determine the starting points for the merged between simplexing and duplexing.
log scan to recover the page sets and
partitions that are entered into group buffer ssize The actual allocated size (in kilobytes) of the
pool recovery pending (GRECP) status. You secondary group buffer pool coupling facility
can do more detailed monitoring of the group structure.
buffer pool checkpoint processing with IFCID
svolstat
0261.
The volatility status of the secondary group
lrsn2 The minimum member-level write-pending buffer pool:
(restart/redo) LRSN that was recorded by the
VOLATILE
last group buffer pool checkpoint.
The structure is volatile.
member-name1 is the DB2 member associated
with the minimum restart/redo LRSN. Group NON-VOLATILE
buffer pool checkpoint records a restart/redo The structure is non-volatile.
LRSN for each member - lrsn2 reflects only the
single minimum value across all members. If
Chapter 5. DB2 Messages 185
DSNB800I • DSNB805I
sdir# Actual number of directory entries allocated for Because the actual ratio change does not take affect
the secondary group buffer pool. until the group buffer pool is reallocated, this message
shows the estimated number of directory entries and
sdata# Actual number of data pages allocated for the
data pages that are allocated based on the new ratio
secondary group buffer pool.
and the maximum size of the coupling facility structure,
cfname The name of the coupling facility in which the as indicated in the active CFRM policy definition. The
secondary group buffer pool is allocated. actual number of entries that are allocated varies based
on the amount of coupling facility storage that is
cflevel The coupling facility level for the coupling available at the time the allocation is attempted, and on
facility in which the secondary group buffer the amount of storage overhead necessary for the
pool is allocated. coupling facility control structures. Because DB2 cannot
determine these variables, the estimated number of
DSNB800I DIRECTORY ENTRY TO DATA PAGE directory and data entries displayed in this message
RATIO SET TO value FOR gbpname. IT assumes that the entire storage allocation for the
WILL TAKE EFFECT ON THE NEXT coupling facility cache structure will be used for
REALLOCATION. directory and data entries, which is not the case.
Explanation: This message is issued in response to To determine the actual number of directory and data
an ALTER GROUPBUFFERPOOL command that entries that are allocated for this group buffer pool, you
requests a change to the directory entry to the data must cause the buffer pool to be reallocated or rebuilt,
page ratio for a group buffer pool. It is also issued for as described in DB2 Data Sharing: Planning and
the first ALTER GROUPBUFFERPOOL command for a Administration, then issue a DISPLAY
group buffer pool, even when no ratio value is specified GROUPBUFFERPOOL command.
on the command (in this case, the default ratio value is System Action: Processing continues.
being used). The new ratio takes effect the next time
the coupling facility cache structure is allocated.
DSNB803I RATIO IS TRUNCATED TO value
The directory entry to data page ratio determines the
number of directory entries and the number of data Explanation: The precision specified on the RATIO
pages that are allocated in the coupling facility cache parameter on an ALTER GROUPBUFFERPOOL
structure for the group buffer pool. If the coupling facility command was greater than allowed. For decimal
structure is not allocated, the first connect from any DB2 numbers less than 25, any digits after the first decimal
causes allocation of the structure and the new directory place are ignored: for example, 5.67 is treated as 5.6.
entry to data page ratio to take effect. For decimal numbers greater than or equal to 25, any
digits after the decimal point are ignored: for example,
If the structure size can be determined from the MVS 25.3 is treated as 25.
CFRM administrative policy, message DSNB801I is
issued to indicate an estimate of the number of directory System Action: Processing continues.
and data entries that are allocated based on the new
ratio and the current size of the coupling facility
DSNB804I CLASS CASTOUT THRESHOLD SET
structure. Otherwise, message DSNB812I is issued.
TO value% FOR gbpname
System Action: Processing continues.
Explanation: This message is issued in response to
System Programmer Response: Use the -DISPLAY an ALTER GROUPBUFFERPOOL command that
GROUPBUFFERPOOL command to display the number requests a change to the class castout threshold value
of allocated directory and data entries. for a group buffer pool. It is also issued for the first
ALTER GROUPBUFFERPOOL command for a group
buffer pool, even when no threshold value is specified
DSNB801I MAX STRUCTURE SIZE INDICATED IN on the command (in this case, the default class castout
MVS CFRM POLICY = size KB threshold value is being used).
ESTIMATED NUMBER OF DIRECTORY
ENTRIES = dir# ESTIMATED NUMBER System Action: Processing continues.
OF DATA PAGES = data#
Explanation: This message is issued in response to DSNB805I value IS NOT A VALID PARAMETER
an ALTER GROUPBUFFERPOOL command after the FOR ’CLASST’
directory entry to data page ratio is successfully
Explanation: An illegal value was specified on the
updated. It is also issued for the first ALTER
CLASST (class castout threshold) keyword on an
GROUPBUFFERPOOL command for a group buffer
ALTER GROUPBUFFERPOOL command. The CLASST
pool, even when no ratio value is specified on the
value must be an integer between 0 and 90, inclusive.
command (in this case, the default ratio value is used).
The group buffer pool is identified in message System Action: The request is rejected.
DSNB800I, which immediately precedes this message.
System Programmer Response: Reissue the -ALTER
186 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNB806I • DSNB814I
GROUPBUFFERPOOL command, specifying an acceptable value for GBPCHKPT.
acceptable value for CLASST.
DSNB812I SIZE ESTIMATES ARE NOT AVAILABLE
DSNB806I GROUP BUFFER POOL CASTOUT FOR THE GROUP BUFFER POOL MVS
THRESHOLD SET TO value% FOR IXCQUERY RETURN CODE = return
gbpname code MVS IXCQUERY REASON CODE =
reason code
Explanation: This message is issued in response to
an ALTER GROUPBUFFERPOOL command that Explanation: The directory entries and data pages
successfully changes the group buffer pool castout estimates for the group buffer pool, identified on the
threshold value for a group buffer pool. It is also issued preceding DSNB800I message, could not be computed
for the first successful ALTER GROUPBUFFERPOOL because IXCQUERY was unable to obtain the backing
command for a group buffer pool, even when no structure’s size information from the MVS CFRM
threshold value is specified on the command (in this administrative policy definition. This can happen if an
case, the default group buffer pool castout threshold IXCQUERY processing error occurred, or if the structure
value is being used). was not defined in the CFRM policy. The backing
structure for the group buffer pool must be defined in
System Action: Processing continues.
the CFRM policy before the group buffer pool can be
allocated. The exact reason can be determined from the
DSNB807I value IS NOT A VALID PARAMETER return code and the reason code. For an explanation of
FOR ’GBPOOLT’ the IXCQUERY codes, see MVS/ESA Programming:
Sysplex Services Reference.
Explanation: An ALTER GROUPBUFFERPOOL
command was issued with an illegal value specified on System Action: The command completes
the GBPOOLT (group buffer pool castout threshold) successfully, but without giving the estimates.
keyword. The GBPOOLT value must be an integer
between 0 and 90, inclusive.
DSNB813I csect-name ALTER NOTIFICATION
System Action: The request is rejected. FAILED
System Programmer Response: Reissue the -ALTER Explanation: An ALTER GROUPBUFFERPOOL
GROUPBUFFERPOOL command, specifying an command failed to propagate the request for castout
acceptable value for GBPOOLT. threshold or checkpoint interval change to other DB2s in
the data sharing group. This error is triggered by an
error encountered by the IRLM notification process. As
DSNB808I GROUP BUFFER POOL CHECKPOINT a result, different DB2s in the group might have different
INTERVAL SET TO value MINUTES FOR values for the castout threshold or checkpoint interval.
gbpname The RATIO change does not use the notification
Explanation: This message is issued in response to process and is, therefore, not affected by such a failure.
an ALTER GROUPBUFFERPOOL command that System Action: Processing continues.
successfully changes the group buffer pool checkpoint
interval value for a group buffer pool. It is also issued System Programmer Response: Reissue the -ALTER
for the first successful ALTER GROUPBUFFERPOOL GROUPBUFFERPOOL command with the same
command for a group buffer pool, even when no interval parameters. If the problem persists, it indicates a
value is specified on the command (in this case, the deeper problem, such as inadequate space for the
default group buffer pool checkpoint interval value is locking structures.
being used).
System Action: Processing continues. DSNB814I csect-name NO CHANGES REQUESTED
ON COMMAND
DSNB809I value IS NOT A VALID PARAMETER Explanation: An ALTER GROUPBUFFERPOOL
FOR ’GBPCHKPT’ command without any parameters was issued for an
existing group buffer pool. If an ALTER
Explanation: An ALTER GROUPBUFFERPOOL GROUPBUFFERPOOL command without any
command was issued with an illegal value specified on parameters is issued for a group buffer pool that does
the GBPCHKPT (group buffer pool checkpoint) keyword. not yet exist, a group buffer pool definition with default
The GBPCHKPT value must be an integer between 1 parameters values is created.
and 999999, inclusive.
System Action: The command is successful and
System Action: The request is rejected. processing continues.
System Programmer Response: Reissue the -ALTER
GROUPBUFFERPOOL command, specifying an
Chapter 5. DB2 Messages 187
DSNB890I • DSNB892I
are left-justified with a blank as the rightmost padding
DSNB890I command-verb gbp-kwd COMMAND IS
character. DB2 adds the padding blanks if they are not
ONLY VALID FOR DATA SHARING
specified on the command.
Explanation: An attempt was made to issue a
System Action: The request is rejected.
GROUPBUFFERPOOL command on a DB2 that was
not initialized to participate in data sharing. System Programmer Response: Reissue the
command, specifying a valid group buffer pool name.
command-verb
The name of the command attempted: ALTER,
or DISPLAY
gbp-kwd
The keyword GROUPBUFFERPOOL or
GBPOOL
System Action: The command request is rejected.
DSNB891I name IS NOT A VALID GROUP BUFFER
POOL OR COUPLING FACILITY
STRUCTURE NAME
Explanation: An invalid name was specified on an
ALTER GROUPBUFFERPOOL or DISPLAY
GROUPBUFFERPOOL command.
name Either the DB2 group buffer pool name or the
backing coupling structure name
You must either specify the DB2 group buffer pool name
(gpbname) or the backing coupling facility structure
name (strname). Acceptable values for gbpname are
GBP0, GBP1, ... , GBP49, GBP32K, GBP32K1, ... ,
GBP32K9. The strname has the following format:
groupname_gbpname
The groupname is the DB2 data sharing group name.
The underscore (_) is used as a delimiter between the
groupname and the gbpname.
System Action: The request is rejected.
System Programmer Response: Reissue the
command specifying a valid group buffer pool name.
DSNB892I grpname IS NOT A VALID GROUP
NAME FOR THIS DB2
Explanation: The group name specified as part of the
full coupling facility cache structure name on an ALTER
GROUPBUFFERPOOL or DISPLAY
GROUPBUFFERPOOL command is incorrect. On the
commands, you can specify either the correct 16-byte
coupling facility cache structure name or the DB2 group
buffer pool name. The coupling facility cache structure
name is a 16-character name specified as follows:
groupname_gbpname
The gbpname can be GBP0, GBP1, ..., GBP49
GBP32K, GBP32K1, ..., GBP32K9. The groupname is
the DB2 data sharing group name. The underscore (_)
is used as a delimiter between the groupname and the
gbpname. The coupling facility cache structure names
188 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 6. DSNE... Messages
In the TSO attachment facility, the user can control whether message IDs are
displayed. To see them, type PROFILE MSGID. To suppress them, type PROFILE
NOMSGID.
Trace messages associated with the TSO attachment facility (including DSN and
DB2I) are not listed in this manual. If you suspect an error in DB2, refer to Part 2 of
DB2 Diagnosis Guide and Reference for information on identifying and reporting the
problem.
All DSN command processor trace messages have the same message number:
DSNET20I.
key was pressed, 'subcmd' may be either 'DSN' or the
DSNET20I
previously invoked subcommand.
Explanation: This is one of many possible trace
User Response: Enter a 'C' to cancel the DB2
messages bearing this message number. Complete
subcommand currently executing. The DSN prompt will
documentation of all of the TSO attachment facility trace
appear on the terminal. Enter anything else (except
messages bearing this message number is found in
another attention) to resume execution.
Part 8 of DB2 Diagnosis Guide and Reference.
DSNE006A C WILL TERMINATE THE
DSNE004E PROBABLE SUBSYSTEM ERROR
SUBCOMMAND WITH UNCOMMITTED
DETECTED IN CSECT csect-name,
CHANGES BACKED OUT
SUBSYSTEM FUNCTION service,
RETCODE retcode, REASON CODE Explanation: Enter a 'C' to terminate the
reason-code subcommand. No uncommitted changes are made to
the database. Any other reply causes subcommand
Explanation: A subsystem error has occurred. The
execution to continue.
function identified in the message as 'service' is either
an MVS or a DB2 service routine. The error was User Response: Enter a 'C' to terminate the
discovered in the 'csect-name' indicated in the subcommand. Control returns to DSN, and the DSN
message. Refer to the appropriate MVS publications for prompt appears on the terminal. This is a second-level
a description of the return and reason codes. help message associated with message DSNE005A.
System Action: This message is sometimes followed
by an intentional system abend. In other instances, the DSNE008I REPLY WAS xxxxx, EXECUTION
DSN command processor will terminate the current RESUMED
subcommand and attempt to continue by issuing
another DSN prompt. Explanation: Execution was suspended by a user
ATTENTION and then was resumed, because the string
User Response: Run the job again with a specified in the message as 'xxxxx' was entered.
SYSUDUMP dump data set allocated and DSN tracing
set to 123. Collect the DSN trace stream. If an abend System Action: Control returns to the interrupted
occurs, collect the dump. session.
DSNE005A EXECUTION IS INTERRUPTED. ENTER DSNE009I REPLY WAS C, EXECUTION
C TO CANCEL, OR ANY OTHER REPLY TERMINATED
TO RESUME THE subcmd Explanation: The response to message DSNE005A
SUBCOMMAND was a C. This caused the current subcommand to
Explanation: The Attention key was pressed. Entering terminate.
a 'C' will cancel the DSN subcommand that is currently System Action: The current subcommand is
executing. If the user enters a question mark, message terminated. The DSN prompt appears on the terminal.
DSNE006A will appear. Any other reply will cause
execution of the subcommand that was in progress to User Response: You can now enter another DSN
continue. subcommand.
If the DSN prompt was issued just before the Attention
© Copyright IBM Corp. 1982, 2001 189
DSNE010I • DSNE106E
DSNE010I SUBCOMMAND subcmd CANCELED DSNE102I YOU ARE NOT AUTHORIZED TO USE
BY ATTENTION DB2 SUBSYSTEM ssid
Explanation: The subcommand specified in the Explanation: The authorization ID is not authorized to
messages was canceled because the user pressed the use subsystem 'ssid'.
attention key and then entered a 'C'.
System Action: Control returns to TSO.
System Action: The current subcommand is
User Response: Contact the system programmer, or
terminated. The DSN prompt appears on the terminal.
system administrator to arrange for the required RACF
User Response: A new subcommand can be entered. or equivalent security system authorization.
DSNE011I DSN COMMAND CANCELED BY DSNE103E MAIN STORAGE REQUEST FROM
ATTENTION csect-id FAILED
Explanation: The user of the DSN command Explanation: A request for main storage failed.
processor has pressed attention. Since this occurred
System Action: The TSO attachment facility is ready
before DSN was fully initialized, DSN terminates. If DSN
for more input.
had been fully initialized, it would have prompted the
user to continue or cancel. User Response: Increase the address space size.
This can be done as part of the logging on process.
System Action: The DSN command processor
terminates. Control returns to TSO or the calling CLIST.
DSNE104E RETRY COUNT OF number NOT VALID,
User Response: Restart DSN.
SET TO 120
Explanation: An invalid 'RETRY' parameter was
DSNE100I ssid NOT OPERATIONAL, RETRY
entered on the DSN command. It has been set to 120.
COUNT IS ZERO
Valid retry counts are integer numbers from 0 to 120.
Explanation: The subsystem (specified in the
System Action: Retry count is modified, and DSN
message as 'ssid') was not active, and no retries remain
execution continues.
to be executed. No more connection attempts are
made. The operator should be notified to start this User Response: The next time you invoke DSN, use
specific subsystem, and the DSN command should be a RETRY count of 0 to 120.
resubmitted. Issue the DSN command with the RETRY
parameter set greater than zero.
DSNE105E SUBSYSTEM ssid NO LONGER
System Action: Control returns to TSO. OPERATIONAL
User Response: Notify the operator to start the Explanation: The DB2 subsystem is down. It must be
subsystem. restarted before the user can continue.
Operator Response: Start the subsystem with the System Action: Control returns to TSO attachment
'ssid' specified in the message. facility.
User Response: Before you can continue, DB2 must
DSNE101I ssid NOT OPERATIONAL, WILL RETRY be restarted. You must also reissue the DSN command.
nnn MORE TIMES ISPF users should restart their jobs.
Explanation: The requested DB2 subsystem 'ssid'
was not started or is not available. Connection to it will DSNE106E PLAN plan-id NOT AUTHORIZED FOR
be attempted 'nnn' more times. This message is issued SUBSYSTEM ssid AND AUTH-ID
every 30 seconds (and each time 'nnn' is decreased by auth-id
1) until the connection is made or 'nnn' is zero.
Explanation: The requested combination of plan-id,
System Action: DSN repeats the connection attempt subsystem-id, and user-id is not currently authorized.
until the connection is made or until the retry count is
decreased to zero. System Action: The TSO attachment facility is ready
for more input.
User Response: Notify the operator start DB2.
User Response: Notify the system programmer or
system administrator to obtain proper authorization.
System Programmer Response: The system
administrator for the DB2 subsystem can arrange the
necessary authorization.
190 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNE107E • DSNE114E
DSNE107E SUBSYSTEM RESOURCE NEEDED DSNE110E ssid NOT VALID SUBSYSTEM ID,
FOR PLAN plan-name, AUTH ID COMMAND TERMINATED
auth-id, AND SUBSYSTEM subsys IS
Explanation: There is no subsystem id with the name
NOT AVAILABLE
identified in the message as 'ssid'. The subsystem
Explanation: The DB2 subsystem was unable to identifier you specify (or default to) on the DSN
allocate a necessary resource for the requested command must exist. This message is the result of
combination of plan-id, user-id, and subsystem-id. This specifying (or defaulting to) a nonexistent subsystem
message is accompanied by DSNE108E. An attempt to identifier. For information on the SYSTEM parameter of
establish connection with the DB2 subsystem has failed. the DSN command, refer to DB2 Command Reference.
System Action: The TSO attachment facility is ready System Action: The DSN processor ends, and control
for more input. returns to TSO.
User Response: Arrange to obtain the needed User Response: Reissue the command with a valid
resource, and resubmit the subcommand. See the SYSTEM parameter.
explanation for message DSNE108E, which
accompanies this message.
DSNE111E INSTALLATION EXIT REJECTED
DSNAME data-set-name
DSNE108E FEEDBACK - REASON CODE
Explanation: A local installation-supplied exit has
reason-code TYPE= type RESOURCE
rejected the data set name identified in the message as
NAME - 44 characters
'data-set-name'.
Explanation: This message accompanies message
System Action: The TSO attachment facility is ready
DSNE107E or DSNE114E to explain the problem more
for more input.
clearly. RESOURCE NAME is the name of the
unavailable resource. The reason code is in User Response: Either correct the data set name
hexadecimal format. specified, or arrange to authorize the original data set
name. Resubmit the request.
System Action: The TSO attachment facility is ready
for more input.
DSNE112E userid STILL SIGNED ON TO
User Response: Arrange for the missing resource to
SUBSYSTEM ssid
be available, and resubmit your job.
Explanation: An attempt was made to sign on to DB2
Problem Determination: The reason the resource is
when the user was already signed on.
unavailable is identified by a reason code. The reason
codes that appear in this message are described in System Action: Control returns to TSO.
“Part 4. DB2 Codes” on page 707.
User Response: Log off and log on again.
TYPE and RESOURCE NAME identify the resource that
is currently unavailable. The TYPE code identifies the
type, as well as the format and content, of the DSNE113E NOT ABLE TO LINK TO MODULE
RESOURCE NAME. Refer to Table 3 in “Appendix B. modname IN DSNAME data-set-name
Problem determination” on page 1281 for an explanation Explanation: A DB2 subsystem error occurred during
of resource type codes. an attempt to link to module 'modname' in data set
'data-set-name'.
DSNE109E NO INPUT TO BIND, SUBCOMMAND System Action: The TSO attachment facility is ready
TERMINATED for more input.
Explanation: No LIBRARY parameter was specified User Response: Check that the module exists and
on the BIND subcommand. No DBRMLIB was allocated. that its name is spelled correctly. Enter the correct
System Action: The TSO attachment facility is ready module name.
for more input.
User Response: Specify the LIBRARY parameter, and DSNE114E THE COMBINATION OF PLAN planid,
resubmit the BIND subcommand. Alternatively, you AUTH ID auth-id, AND SUBSYSTEM
could issue an ALLOCATE command for the DDNAME ssid IS NOT VALID
DBRMLIB and then resubmit the BIND subcommand as Explanation: The resource in message DSNE108E,
originally written. which will follow this message, is not a valid resource
name.
System Action: The TSO attachment facility is ready
for more input.
Chapter 6. DB2 Messages 191
DSNE117E • DSNE124E
User Response: Correct the invalid combination, and User Response: Check the data-set-name. The data
resubmit the subcommand. The problem is probably set you specified is partitioned, but you did not specify a
caused by a user spelling error. If it is not, check with member name. Add a member name, and resubmit the
the system administrator to determine the availability of job.
the needed resource. Your program may need to be
bound. See the explanation for message DSNE108
DSNE121E csect-id NOT ABLE TO OPEN DATA SET
(which accompanies this one) for more information.
Explanation: The DB2 subsystem was unable to open
the requested data set.
DSNE117E NOT ABLE TO LOCATE membername
IN DSNAME data-set-name This message is issued by the following CSECTs:
DSNECP23, DSNECP69
Explanation: The 'data-set-name' specified does not
contain the member the user wanted to run. System Action: The TSO attachment facility is ready
for more input.
System Action: Control remains with the DSN
command processor, and the DSN prompt appears on User Response: For information about why the data
the terminal. The DSN command processor is ready for set could not be opened, read the explanations of the
another command. messages that accompany this message. Correct the
condition, and resubmit the job.
User Response: Correct the PROGRAM or LIBRARY
parameter, and resubmit the subcommand.
DSNE122E DATA SET ORGANIZATION MUST BE
EITHER SEQUENTIAL OR
DSNE118E invalid-command NOT VALID
PARTITIONED. data-set-name IS NOT
COMMAND
Explanation: The DB2 subsystem was unable to open
Explanation: The user entered an invalid command. A
data set 'data-set-name', because it is not a sequential
typing error may be responsible. You may be trying to
or partitioned data set.
run a command processor that is either not available on
your system or that is not part of your current LNKLST This message is issued by the following CSECT:
or STEPLIB concatenation. DSNECP69
System Action: The TSO attachment facility is ready System Action: The TSO attachment facility is ready
for more input. for more input.
User Response: Either correct the spelling error, or User Response: Correct the data-set-name, or
rearrange your library concatenation so that you can change the data set organization. Resubmit the job.
access the required command processor. Resubmit the
command.
DSNE123I data-set-name NOT PARTITIONED DATA
SET, IT IS IGNORED
DSNE119E data-set-name NOT PARTITIONED
DATA SET Explanation: The data-set-named in the message is
required to be partitioned. It is not and, consequently,
Explanation: The user tried to allocate a sequential was ignored.
data set when a partitioned data set was required.
System Action: DSN will attempt to continue BIND
System Action: The TSO attachment facility is ready processing.
for more input.
User Response: Correct the subcommand, and
User Response: Check the data-set-name. The data resubmit it.
set you specified is sequential, but you specified a
member name. Remove the member name, and
resubmit the job. DSNE124E DATA SET data-set-name, MEMBER
member-name IN USE, TRY LATER
DSNE120E data-set-name NOT SEQUENTIAL DATA Explanation: The member contained in
SET 'data-set-name' is currently in use. This message is
normally issued when another user is updating the
Explanation: The user tried to allocate a partitioned specified member.
data set when a sequential data set was required.
This message is issued by the following CSECT:
This message is issued by the following CSECT: DSNECP69
DSNECP69
System Action: The TSO attachment facility is ready
System Action: The TSO attachment facility is ready for more input.
for more input.
User Response: Wait until the member is available
192 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNE125E • DSNE132I
and reissue your DCLGEN request.
DSNE130I MAXIMUM NUMBER OF DB2 USERS
REACHED. YOUR RETRY COUNT IS
DSNE125E DATA SET data-set-name IN USE, TRY ZERO
LATER
Explanation: The number of concurrent connections
Explanation: The sequential data set 'data-set-name' to DB2 is restricted. The number is specified in the
is currently in use. This message is normally issued installation parameters in member DSN6SYSP. For TSO
when another user is updating the specified data set. foreground, see parameter IDFORE. For background
jobs, see parameter IDBACK. The DSN request has
This message is issued by the following CSECT: been denied, because the current number of DB2
DSNECP69 connections in the system has reached the
System Action: The TSO attachment facility is ready installation-specified limit.
for more input. System Action: Control returns to TSO.
User Response: Wait until the data set is available User Response: Resubmit the DSN command when
and reissue your DCLGEN request. activity using DB2 has diminished. If still unsuccessful,
see the system programmer about the installation
DSNE126E THE DB2 OPERATOR IS STOPPING parameters.
THE SUBSYSTEM. PLEASE END YOUR
DSN SESSION DSNE131I MAXIMUM NUMBER OF DB2 USERS
Explanation: The operator has requested that DB2 REACHED. WILL RETRY nnn MORE
quiesce. The user should promptly finish the current TIMES
task and terminate the DSN session so that this can Explanation: The number of concurrent connections
take place. This message may be followed by message to DB2 is restricted. The number is specified in the
DSNE127I. installation parameters in member DSN6SYSP. For TSO
This message is issued by the following CSECT: foreground, see parameter IDFORE. For background
DSNECP00 jobs, see parameter IDBACK. The DSN request was
denied because the current number of DB2 connections
System Action: No new users will be permitted to in the system reached the installation specified limit.
initiate DB2 sessions. Current users will be permitted to
work until they terminate their connections to DB2. The DSN connection to DB2 is attempted 'nnn' more
times. The number of retries is determined by the
User Response: End your DSN session as soon as RETRY parameter on the DSN command. For more
possible. information, refer to DB2 Command Reference.
This message is issued every 30 seconds (and each
DSNE127I THE DB2 OPERATOR IS STOPPING time 'nnn' is decreased by 1) until the connection is
THE SUBSYSTEM. DSN IS made or until 'nnn' is decreased to zero.
TERMINATING
System Action: DSN repeats the connection attempt
Explanation: The operator has requested that DB2 until the connection is made or the retry count is
terminate. decreased to 0.
System Action: DB2 will shut down, interrupting user User Response: If all retry attempts fail, resubmit the
activities as necessary. DSN will terminate immediately DSN command when DB2 activity diminishes. If still
and return the user to TSO. unsuccessful, see the system programmer about the
User Response: Reinitiate your session when DB2 installation parameters.
returns.
DSNE132I DB2 IS OPERATING IN RESTRICTED
DSNE128I DB2 IS ABNORMALLY ENDING. DSN IS ACCESS MODE. MAINTENANCE
TERMINATING PERSONNEL ONLY
Explanation: DB2 has encountered a problem from Explanation: DB2 is not available for normal
which it cannot recover. operation. It is only available to service personnel.
System Action: DB2 is abending. DSN terminates System Action: Control returns to the caller. Your
immediately and returns the user to TSO. request was not processed. The DSN command
processor was unable to connect to DB2.
User Response: Reinitiate your session when DB2
returns. User Response: Wait until DB2 is available for
general use, then resubmit your request.
Chapter 6. DB2 Messages 193
DSNE133E • DSNE236A
also be specified for ENABLE or DISABLE.
DSNE133E csect-name RELEASE LEVELS NOT
COMPATIBLE. DSN=release_level, System Action: The TSO attachment facility is ready
DB2=release_level for more input.
Explanation: The DSN command processor, perhaps User Response: Enter Y (Yes) on the connection type
running under the control of DB2I, has detected a for the associated connection names.
release level incompatibility between itself and DB2.
The current release_level of the DSN command
processor code and the DB2 subsystem load modules DSNE233A MEMBER NAME MUST NOT BE
is indicated as a string of three numeric characters as SPECIFIED MORE THAN ONCE
follows: Explanation: The LIBRARY field containing the data
v Version set name, also contains a member name.
v Release
v Modification level System Action: The TSO attachment facility is ready
for more input.
System Action: The DSN command processor
terminates. User Response: The member name must be specified
only once, and must be specified on the MEMBER field.
User Response: Check that your method of invoking
DSN or DB2I allocates the correct libraries for DSN. If
you used JCL or a TSO logon procedure to execute DSNE234A EITHER DBRM MEMBER OR INCLUDE
DSN code, check your JOBLIB and STEPLIB PACKAGE LIST MUST BE SPECIFIED
allocations. If you used a CLIST to execute DSN, insure Explanation: The BIND PLAN subcommand requires
that you obtained the correct version of the DSN either a DBRM member name or a package list as
code.See your system programmer if you invoke DSN input, neither was specified.
using procedures supplied by your system programmer.
System Action: The TSO attachment facility is ready
Operator Response: Notify the system programmer. for more input.
System Programmer Response: If you are unable to User Response: Enter a DBRM member name(s), or
determine the problem, you can trace DSN execution specify that a package list is to be included. Both
through DB2I or the DSN command processor. options are also allowed.
Problem Determination: Insure that coexistence is
supported on both release levels (DSN and DB2). If DSNE235A plan/package NAME IS A DUPLICATE
coexistence is supported, insure that the lower level OF PRIMARY plan/package NAME
release has the correct SPE level code support that is
required to coexist with the current higher level release. Explanation: In addition to the primary 'plan' or
'package' name specified on the REBIND or FREE
For more information about coexistence and SPEs, refer subcommand panel, the user also specified that
to the program directory or preventative service additional plans or packages were to be included in the
planning (PSP) updates. list. The primary 'plan' or 'package' name was again
specified to be included in the list.
DSNE231A ONE NAME IS REQUIRED TO FREE A System Action: The duplicate of the primary 'plan' or
PLAN OR A PACKAGE 'package' name is automatically deleted from the list to
Explanation: The user has attempted to use the avoid errors during subcommand processing. The TSO
FREE PLAN or PACKAGE panel without specifying a attachment facility is ready for more input.
plan or package name. User Response: Complete the list of additional plans
System Action: The TSO attachment facility is ready or packages.
for more input.
User Response: Enter the name of a plan or DSNE236A SPECIFY A CONNECTION TYPE TO
package, or (*) to indicate 'all'. ENABLE OR DISABLE
Explanation: The user indicated that individual
DSNE232A CONNECTION NAME REQUIRES connection types were to be ENABLED or DISABLED,
ENABLE/DISABLE OF CONNECTION but no specific connection types were specified.
TYPE System Action: The TSO attachment facility is ready
Explanation: The user indicated that specific for more input.
connection names were to be specified for ENABLE or User Response: Enter Y (YES) for each individual
DISABLE, but the associated connection type field was connection type to ENABLE, or DISABLE.
not updated. The ENABLE or DISABLE of connection
names requires the corresponding connection type to
194 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNE237A • DSNE245A
System Programmer Response: Delete the ISPF
DSNE237A SPECIFY ENABLE ALL OR SPECIFIC
table in error. The table is recreated automatically
CONNECTION TYPES
during the next invocation of the DB2I function.
Explanation: In addition to requesting that all
Problem Determination: The format of the ISPF table
connection types be enabled, the user also requested
was changed since the last successful use of the table.
that specific connection types be enabled. The enable
Refer to the DB2I ISPF table library allocated to the
of all connection types includes the enable of specific
DSNETBLS DD statement, and examine the ISPF error
connection types.
log for additional diagnostic information.
System Action: The TSO attachment facility is ready
for more input.
DSNE243A ISPF RETURNED AN UNEXPECTED
User Response: Specify specific connection types to CODE DURING A TABLE DISPLAY
be enabled, or specify that all connection types are to
Explanation: An ISPF error was encountered when
be enabled.
attempting to display a DB2I table panel.
System Action: TSO processing for the current
DSNE240A ISPF RETURNED AN UNEXPECTED
subcommand is terminated.
CODE WHILE CLOSING A TABLE
User Response: Notify the system programmer.
Explanation: An ISPF error return code was
encountered when attempting to perform a TBCLOSE System Programmer Response: Insure that the DB2I
for an ISPF table while processing the current panel and panel library are established correctly. If the
subcommand panel. format of both is correct, then use ISPF option 7.2 to
test the panel for additional errors.
System Action: TSO processing for the current
subcommand is terminated. Examine the ISPF error log for additional error
information and determine the name of the panel to be
User Response: Notify the system programmer.
displayed.
System Programmer Response: Verify that the ISPF
table library allocated to the DSNETBLS DD statement
DSNE244A CANNOT SAVE CREATED TABLE,
has sufficient space or directory entries available. Also
VERIFY SPACE IN TABLE LIBRARY
refer to the ISPF error log for additional diagnostic
information. Explanation: An ISPF TBSAVE function returned with
a condition code greater than zero.
DSNE241A INTERNAL PROCEDURE WAS PASSED System Action: TSO processing for the current
AN INVALID NUMBER OF ARGUMENTS subcommand is terminated.
Explanation: A TSO Interpreter error was encountered User Response: Notify the system programmer.
while executing a subroutine during the processing of
the current subcommand. System Programmer Response: Verify that the ISPF
table library allocated to the DSNETBLS DD statement
System Action: TSO processing for the current has sufficient space and directory entries available. Also
subcommand is terminated. refer to the ISPF error log for additional diagnostic
information.
User Response: Notify the system programmer.
System Programmer Response: Notify the IBM
DSNE245A ISPF RETURNED AN UNEXPECTED
support center that an error was encountered in the
CODE WHILE ADDING A ROW TO A
TSO SYSCALL instruction.
TABLE
Problem Determination: The TSO SYSCALL
Explanation: An ISPF TBADD function returned with a
instruction is not passing all the parameters to a
condition code greater than four.
subroutine defined within the CLIST.
System Action: The TSO attachment facility is ready
for more input.
DSNE242A ISPF RETURNED AN UNEXPECTED
CODE WHILE SETTING SEARCH User Response: Enter the DB2I CANCEL command,
ARGUMENTS and notify the system programmer.
Explanation: An ISPF table for the current function System Programmer Response: Verify that the user
does not contain the expected column or table format. has enough memory to perform ISPF functions. Also
refer to the ISPF error log for additional diagnostic
System Action: TSO processing for the current
information.
subcommand is terminated.
User Response: Notify the system programmer.
Chapter 6. DB2 Messages 195
DSNE246A • DSNE291A
DSNE246A ISPF RETURNED AN UNEXPECTED DSNE252A JCL WAS NOT CREATED, ERROR
CODE WHILE DELETING A ROW errcode WHILE DOING function_name
FUNCTION
Explanation: An ISPF TBDELETE function returned
with a condition code greater than zero. Explanation: Error code 'errcode' was received while
doing a function 'function_name', the JCL was not
System Action: TSO processing for the current
created.
subcommand is terminated.
Severity: 20
User Response: Enter the DB2I CANCEL command,
and notify the system programmer. System Action: Refer to ISPF V4 Dialog Developer's
Guide and Reference for the cause of this error.
System Programmer Response: Verify that the user
has enough memory to perform ISPF functions. Also User Response: Contact your systems programmer.
refer to the ISPF error log for additional diagnostic
Problem Determination: Use the return code/function
information.
combination to find the causes for the problem in ISPF
V4 Dialog Developer's Guide and Reference and correct
DSNE247A ISPF RETURNED AN UNEXPECTED the problem.
CODE WHILE UPDATING A ROW
Collect the following diagnostic items listed in
Explanation: An ISPF TBPUT function returned with a “Appendix B. Problem determination” on page 1281: 21.
condition code greater than four.
System Action: TSO processing for the current DSNE283A THE , (COMMA) OPTION IS
subcommand is terminated. INCOMPATIBLE WITH THE hostlang
LANGUAGE
User Response: Enter the DB2I CANCEL command,
and notify the system programmer. Explanation: The user tried to select the 'hostlang'
APPLICATION LANGUAGE and the comma option of
System Programmer Response: Verify that the user
the DECIMAL POINT field on the DB2I defaults panel.
has enough memory to perform ISPF functions.
This combination is not supported.
Recreate the user actions that lead to the failure. Also
refer to the ISPF error log for additional diagnostic System Action: The defaults panel is displayed again.
information.
User Response: Either change the APPLICATION
LANGUAGE field or the DECIMAL POINT field. If you
DSNE248A COMMAND ENTERED CONTAINS need the C (C/370 Compiler), then the DECIMAL
INVALID CHARACTERS, RESPECIFY POINT field must contain a decimal point (.).
Explanation: The command entered at the command
line contains an invalid character, the command must be DSNE288A YOU CANNOT SPECIFY (RUN)=YES
reentered. WITH CICS OR IMS
System Action: The TSO attachment facility is ready Explanation: Application programs that make CICS or
for more input. IMS calls cannot be run from the TSO environment.
They can, however, be precompiled, bound, compiled,
User Response: Correct the invalid command entry.
and linked under TSO. The user should specify N on
the RUN panel when preparing a CICS or IMS
DSNE250A PLEASE ENTER THE COMMAND AT application.
THE LINE WITH THE PLAN/PACKAGE
System Action: The system is waiting for new input to
NAME
the panel.
Explanation: SELECT or RESET commands must be
User Response: Change the RUN option to N.
entered on the line where the PLAN/PACKAGE name is
shown. This line contains the name of the
PLAN/PACKAGE, while the secondary line(s) do not. DSNE291A ALL DB2 COMMANDS BEGIN WITH A
DASH
System Action: The line command is rejected. The
TSO attachment facility is ready for more input. Explanation: The user omitted the DB2 command
recognition character that must precede all DB2
User Response: Reenter the line command on the
commands.
primary PLAN/PACKAGE line(s).
System Action: The DB2 commands panel is
displayed again so the user can resubmit the command.
User Response: Add the DB2 command recognition
character, and reenter the command.
196 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNE292I • DSNE340I
DSNE292I DATA SET data-set-name NOW DSNE296A YOU CANNOT TERMINATE AND
CONTAINS YOUR JCL RESTART A UTILITY AT THE SAME
TIME
Explanation: DB2I has just created some JCL for you.
The JCL now resides in data set 'data-set-name'. You Explanation: You have set conflicting options on the
can now edit this data, if desired. The TSO SUBMIT DB2I Utilities panel. You can either TERMINATE a utility,
command will start the job running in background. or you can RESTART a utility, but you cannot do both.
System Action: The system is waiting for your next System Action: The system is waiting for new input to
request. the panel.
User Response: You can start another DB2I job or User Response: Either change the RESTART option
leave the panel. to NO, or select a different FUNCTION.
DSNE293A MEMBER NAME IS REQUIRED. YOUR DSNE297A ENTER DATA SET NAME: COPYDSN
PROGRAM MUST BE IN A PDS OR RCPYDSN1
Explanation: The user either has attempted to run a Explanation: You have not specified a data set name
program that is not in a partitioned data set or has for the COPY utility. A data set name for the
forgotten to specify a member name. local/current site (COPYDSN), and/or the recovery site
(RCPYDSN1) is required.
System Action: The RUN panel will be displayed so
that the user can specify a member name and try the System Action: The system is waiting for new input to
run again. the panel.
User Response: Specify a member name, and rerun User Response: Enter a data set name for
the program. COPYDSN, and/or RCPYDSN1.
DSNE294I SYSTEM RETCODE=hex-code USER OR DSNE298A ERROR DURING EDIT: CLIST data set
DSN RETCODE=decimal-code name
Explanation: A DB2I function has just completed. The Explanation: Errors were encountered while
return codes for that function are returned in this attempting to change the online book data set names in
message. The variable 'hex-code' is a 3-digit the DB2 CLIST member DSNEMC01. No data set
hexadecimal number; the variable 'decimal-code' is a names were changed.
3-digit decimal number. Refer to the appropriate MVS
System Action: The system is waiting for new input to
publication for explanations of the return codes.
the panel.
System Action: DB2I is ready for another execution
User Response: Ensure that the CLIST data set
cycle unless other messages appeared indicating that
name is correct and contains the DSNEMC01 CLIST
DB2 is unavailable.
member to be changed. This CLIST data set must also
User Response: You may have to change input be available to the TSO user ID in WRITE mode. This
parameters to correct unsatisfactory completion codes. error will continue to be displayed on the panel until the
error is resolved or the user exits the panel (END).
DSNE295A YOU CANNOT DISPLAY AND RESTART System Programmer Response: If you are unable to
A UTILITY AT THE SAME TIME determine the problem, you can trace the DB2 CLIST
execution while displaying this panel.
Explanation: You have set options on the DB2I
Utilities panel that call for conflicting actions. You can Problem Determination: Examine the CLIST trace
either DISPLAY the status of a utility, or you can output for any TSO/ISPF nonzero return codes
RESTART a utility, but you cannot do both. encountered during CLIST execution.
System Action: The system is waiting for new input to If you suspect an error in DB2, refer to Part 2 of DB2
the panel. Diagnosis Guide and Reference for information on
identifying and reporting the problem.
User Response: Either change the RESTART option
to NO, or select a different FUNCTION.
DSNE340I INTERNAL ERROR – ILLEGAL TYPE IN
MODULE module-name
Explanation: An internal DB2 problem has occurred.
The named module has detected a nonexistent
SQLTYPE.
Chapter 6. DB2 Messages 197
DSNE351A • DSNE361I
User Response: Collect the SPUFI trace and ISPF executing the user’s SQL statement(s). The commit is
log, and notify either the system programmer or the done at the end of the processing of an input data set, if
database administrator. it is requested and if there has been no SQL execution
error.
You may have to rerun the failing job after you have
turned on trace. This will enable you to send trace System Action: SPUFI waits until the user enters a
messages to the ISPF log. valid response.
System Programmer Response: If you suspect an User Response: Type in a 'Y' or an 'N', and press
error in DB2, refer to Part 2 of DB2 Diagnosis Guide 'ENTER'.
and Reference for information on identifying and
reporting the problem.
DSNE355A CHANGE DEFAULTS PROCESSING
OPTION MUST BE Y (YES) OR N (NO)
DSNE351A EDIT PROCESSING OPTION MUST BE
Explanation: The user specified a change-default
Y (YES) OR N (NO)
option other than 'YES', 'NO', or the abbreviation 'Y' or
Explanation: The user specified an edit option other 'N'. A valid user response determines whether SPUFI
than 'YES', 'NO', or the abbreviation 'Y' or 'N'. A valid displays the current-session SPUFI defaults and allows
user response determines whether SPUFI invokes the the user to change the defaults.
ISPF editor to allow the user to edit the input data set.
System Action: SPUFI waits until the user enters a
System Action: SPUFI will wait until the user enters a valid response.
valid response.
User Response: Type in a 'Y' or an 'N', and press
User Response: Type in a 'Y' or an 'N', and press 'ENTER'.
'ENTER'.
DSNE359A OUTPUT DATA SET NAME REQUIRED
DSNE352A EXECUTE PROCESSING OPTION FOR EXECUTE OR BROWSE
MUST BE Y (YES) OR N (NO)
Explanation: The user did not specify the name of the
Explanation: The user specified an execute option output data set.
other than 'YES', 'NO', or the abbreviation 'Y' or 'N'. A
System Action: SPUFI waits until the user specifies
valid user response determines whether SPUFI
an output data set.
executes the SQL statements in the user input data set.
User Response: Type in the correct entry, and press
System Action: SPUFI waits until the user enters a
'ENTER'.
valid response.
User Response: Type in a 'Y' or an 'N', and press
DSNE360A THE OUTPUT DATA SET MUST RESIDE
'ENTER'.
ON DASD
Explanation: The user has attempted to send the
DSNE353A BROWSE PROCESSING OPTION MUST
output of SPUFI to a SYSOUT data set. He must enter
BE Y (YES) OR N (NO)
a generic device class that contains only DASD devices.
Explanation: The user specified a browse option other
System Action: SPUFI waits until the user specifies a
than 'YES', 'NO', or the abbreviation 'Y' or 'N'. A valid
valid output device class.
user response determines whether SPUFI invokes ISPF
BROWSE to allow the user to browse the output data User Response: Type in the correct entry, and press
set. 'ENTER'.
System Action: SPUFI will wait until the user enters a
valid response. DSNE361I SPUFI PROCESSING COMPLETE
User Response: Type in a 'Y' or an 'N', and press Explanation: This informational message is displayed
'ENTER'. after SPUFI successfully created the output data set. If
errors are encountered before the completion of output
data set processing, or during the subsequent BROUSE
DSNE354A AUTOCOMMIT PROCESSING OPTION
OUTPUT option for this data set, this message is
MUST BE Y (YES) OR N (NO)
replaced by either SPUFI or TSO/ISPF error messages.
Explanation: The user specified an AUTOCOMMIT
System Action: The system waits for the next user
option other than 'YES', 'NO', or the abbreviation 'Y' or
input.
'N'. A valid user response determines whether SPUFI
automatically commits all the changes to the database User Response: At this point you can change the
subsystem. This was encountered as a result of SPUFI panel variable settings to initiate a new SPUFI
198 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNE363A • DSNE371A
request, or you can exit SPUFI.
| DSNE365A SQL STATEMENT TERMINATOR HAS
| BEEN CHANGED TO token
DSNE363A ONLY RR (REPEATABLE READ) OR CS
| Explanation: The SPUFI input data set contains a
(CURSOR STABILITY) ALLOWED
| #SET statement that changes the SQL statement
Explanation: The user has entered an invalid isolation | terminator to token.
level. This value must be either RR or CS. 'Isolation
| System Action: token is the SQL statement terminator
level' here refers to the degree to which the SPUFI user
| until another #SET statement changes it or the end of
wants to isolate SQL execution from the effects of other
| the input data is reached.
concurrently executing DB2 applications.
If the repeatable read (RR) level is specified and the
DSNE366A ONLY THE LISTED RECFM TYPES ARE
AUTOCOMMIT option is 'YES', other applications can
ALLOWED
modify the selected database values as soon as the
SPUFI EXECUTE phase is completed and as soon as Explanation: The user has entered an invalid record
the automatic COMMIT (or ROLLBACK, if an error was format for the output data set.
encountered,) operation is performed. Therefore, it is
System Action: The system waits until the user enters
possible that the retrieved data being browsed by the
one of the allowed RECFM types.
user has already been modified by another application.
User Response: Enter a RECFM of V, VB, VBA, F,
If the RR level is specified and the AUTOCOMMIT
FB, or FBA.
option is 'NO', no other DB2 application executing
concurrently can change any of the selected database
values until the SPUFI user issues either a COMMIT or DSNE367A ACTION MUST BE C (COMMIT) OR R
a ROLLBACK. Therefore, other applications might be in (ROLLBACK) OR D (DEFER)
a normal wait state while the SPUFI user is browsing
the output data set. Explanation: This message requests the user to make
a commit action decision.
If the cursor stability (CS) level is specified, it does not
make any difference whether the AUTOCOMMIT option User Response: To commit all the changes made
is 'YES' or 'NO'. Other concurrently executing DB2 since the last commit point, enter a 'C'. To undo all the
applications can change the selected database values changes that have been made since the last commit
as soon as the SELECT has completed. point, enter an 'R'. To defer the decision, enter a blank.
System Action: SPUFI waits until the user specifies
either 'RR' or 'CS'. DSNE368A YES OR NO MUST BE ENTERED FOR
EACH PROCESSING OPTION
User Response: Type in the correct entry, and press
'ENTER'. Explanation: One of the processing options was left
blank or set to blank by the user.
| DSNE364A token IS INVALID AS AN SQL User Response: Enter 'YES' or 'NO' for each
| STATEMENT TERMINATOR processing option.
| Explanation: The user has entered an SQL statement
| terminator (token) that is not supported. The following DSNE370A INPUT DATA SET COULD NOT BE
| values are not valid for use as a SQL statement OPENED
| terminator: Explanation: The input data set could not be opened
| v blank because of invalid data set attributes. The logical record
| v comma length (LRECL) of the input data set must be 80K. The
record format (RECFM) must be either F or FB. The
| v single and double quotes input data set may be either sequential or partitioned.
| v underscore
User Response: Specify an input data set having
| v left and right parenthesis valid attributes.
| System Action: The statement cannot be executed.
| User Response: Specify a valid SQL statement DSNE371A OUTPUT DATA SET COULD NOT BE
| terminator. OPENED
Explanation: The output data set could not be opened
because of invalid data set attributes. The logical record
length (LRECL) must be at least 80KB and less than
32KB. The record format (RECFM) must be F, FB, FBA,
V, VB, or VBA. The output data set must be sequential.
Chapter 6. DB2 Messages 199
DSNE372A • DSNE384A
User Response: Either specify an output data set User Response: Correct the input data set attributes,
having valid attributes, or enter correct attributes for this and try again.
data set.
DSNE378A ASA CONTROL CHARACTER NOT
DSNE372A OUTPUT DATA SET MUST BE ALLOWED ON INPUT DATA SET
SEQUENTIAL RECFM
Explanation: The user has requested that a Explanation: The user attempted to use an input data
nonsequential output data set contain the output from set containing forms control characters or machine
execution of SQL statements. control characters. These characters are not allowed on
the input data set.
User Response: Enter the data-set-name of a
sequential data set for the output data set. User Response: Remove the forms control characters
or machine control characters from the input data set,
and try again.
DSNE374A OUTPUT DATA SET MUST BE
SEQUENTIAL
DSNE379A text from DYNALLOC
Explanation: The output data set is of unrecognized
organization. It must be sequential. Explanation: An attempt to allocate a data set has
failed. This message contains the secondary
System Action: Processing does not begin until the
explanation for the failure.
panel entries are correct and the user presses 'ENTER'.
User Response: Correct the condition, and resubmit
User Response: The output data set must be
the subcommand.
sequential. Enter a sequential data-set-name (no
member) in the output data set field.
DSNE381A UNEXPECTED ALLOCATION RETURN
CODE return-code, reason-code
DSNE375A ACCESS TO INPUT DATA SET NOT
AUTHORIZED Explanation: An unexpected return code from SVC 99
was received. The return code received is the
Explanation: A local installation-supplied exit has
DYNALLOC (SVC 99) return code. Refer to the
rejected access to the input data set specified by the
appropriate MVS publication for explanations of the
user.
return and reason codes.
User Response: Either specify the name of a data set
User Response: Correct the condition, and resubmit
for which authorization will be allowed, or arrange to
the subcommand.
authorize the original data-set-name. Resubmit the
request.
DSNE383A INVALID OUTPUT DATA SET RECORD
FORMAT. OPEN RETURN CODE rcode
DSNE376A ACCESS TO OUTPUT DATA SET NOT
AUTHORIZED Explanation: The data set format was invalid.
Acceptable record formats are: F, FB, FBA, V, VB, or
Explanation: A local installation-supplied exit has
VBA.
rejected access to the output data set.
User Response: Enter a valid value in the record
User Response: Either specify the name of a data set
format field.
for which authorization will be allowed, or arrange to
authorize the original data-set-name. Resubmit the
request. DSNE384A UNEXPECTED DEALLOCATION
RETURN CODE return-code,
reason-code
DSNE377A INPUT DATA SET RECFM MUST BE F
OR FB WITH LRECL 79 OR 80 Explanation: A deallocation request has returned an
unexpected return and reason code.
Explanation: The user specified an input data set that
does not have the required attributes (F or FB with User Response: Refer to the appropriate MVS
LRECL 79 or 80). publication for explanations of the return and reason
codes.
Note: If the input data set has an LRECL of 79, SPUFI
assumes the data set was exported by QMF.
Therefore, it is recommended that you should not
use an LRECL of 79 for a data set that is not
exported from QMF.
200 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNE385A • DSNE393I
User Response: Enter the data-set-name without
DSNE385A ENTER MEMBER NAME. INPUT DATA
attempting to specify a member.
SET IS PARTITIONED
Explanation: The input data set is partitioned, and the
DSNE390A THE OUTPUT DATA SET ATTRIBUTES
user did not enter the member name on the SPUFI
ARE INCONSISTENT
main menu.
Explanation: This message indicates that the user
System Action: Processing does not begin until the
made one of three possible errors in specifying block
panel entries are correct. If any of the processing
size and logical record length (LRECL):
options are changed, this message is ignored, and
v The user specified a record format (RECFM) of F, but
processing will proceed according to the new settings.
the block size is not equal to the logical record length
User Response: Enter the member name. (LRECL)
v The user specified a record format (RECFM) of F,
FB, or FBA, but block size is not evenly divisible by
DSNE386A MEMBER member-name NOT
logical record length (LRECL).
PRESENT IN SPECIFIED INPUT DATA
v The user specified a record format (RECFM) of VB,
SET
but the block size is less than logical record length
Explanation: The named member is not in the input (LRECL) + 4. The user must allow 4 bytes for the
data set. block header.
System Action: Processing does not begin until the User Response: Specify logical record length
panel entries are correct. (LRECL) and block size appropriately on the
DSNESP02 panel.
User Response: Enter a correct member name or a
correct data-set-name.
DSNE391I FREEMAIN ERROR IN MODULE
module-name
DSNE387I DSNTIAR ERROR. RETURN CODE =
return-code Explanation: SPUFI encountered a FREEMAIN error
in the specified module.
Explanation: An internal DB2 error has occurred.
DSNTIAR attempted to format a message to explain a System Action: This message is logged in the ISPF
nonzero SQL code, but the attempt failed. log data set. No abend occurs.
User Response: Notify the system programmer. User Response: Notify the system programmer or
system administrator.
System Programmer Response: Print the ISPF log,
and collect a dump of the TSO address space. Refer to System Programmer Response: Print the ISPF log,
Part 2 of DB2 Application Programming and SQL Guide and collect a dump of the TSO address space. If you
for failure analysis procedures. suspect an error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on
identifying and reporting the problem.
DSNE388A INPUT DATA SET MUST BE
SEQUENTIAL OR PARTITIONED
DSNE392I GETMAIN ERROR IN MODULE
Explanation: The input data set organization is not module-name
recognized.
Explanation: SPUFI encountered a GETMAIN error in
System Action: Processing does not begin until the the specified module.
panel entries are correct.
System Action: This message is logged in the ISPF
User Response: Enter a data-set-name with log data set. User abend X'00C50003' is issued.
sequential or partitioned organization. It may be
necessary to allocate a sequential or partitioned data User Response: Notify the system programmer or
set. system administrator.
System Programmer Response: Ensure that enough
DSNE389A A MEMBER HAS BEEN SPECIFIED storage is allocated to the TSO user.
FOR A SEQUENTIAL DATA SET
Explanation: The user has specified a member as DSNE393I SPF VDELETE ERROR IN MODULE
input to SPUFI. However, the input data set specified is DSNESM90. ERROR CODE = flag
sequential.
Explanation: An internal SPUFI error has occurred.
System Action: Processing does not begin until the CSECT DSNESM90 tried to delete an ISPF dialog
panel entries are correct. variable that was not previously defined.
Chapter 6. DB2 Messages 201
DSNE395I • DSNE605E
System Action: This message is logged in the ISPF
DSNE417A csect-name TYPE IS TIMESTAMP
log data set. No abend is issued. However, if the
problem persists, notify the system programmer. Explanation: This is a SPUFI trace message. SPUFI
has looked in the SQLTYPE field of the SQLDA and
System Programmer Response: If you suspect an
detected a data type of TIMESTAMP.
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and
reporting the problem. DSNE457I csect-name ARITHMETIC ERROR IN
THE CURRENT ROW AND COLUMN
Problem Determination: Record the error code 'flag'.
It has no user significance, but it can assist the IBM Explanation: This is a SPUFI trace message. SPUFI
Support Center in resolving the problem. has looked in the SQLDA and detected an arithmetic
error. The indicator variable associated with this value
contains -2.
DSNE395I UNEXPECTED RETURN CODE FROM
SPF SERVICE
DSNE601I SQL STATEMENTS ASSUMED TO BE
Explanation: A return code of 4 from ISPF DISPLAY
BETWEEN COLUMNS nn AND nn
or a return code of 8 from the ISPF editor was
encountered. Explanation: This message indicates which record
columns in the input data set are scanned for SQL
System Action: The message is displayed on the
statements. For data sets of type COBOL, columns 8
SPUFI panel and logged in the ISPF log data set. No
through 72 are scanned. For STANDARD data set
user abend is issued.
types, if the LRECL is 79 then columns 1 through 71
User Response: Notify the system programmer. are scanned, and if the LRECL is 80 then columns 1
through 72 are scanned.
System Programmer Response: If a new release of
ISPF is used, determine whether the above return System Action: This message is written to the SPUFI
codes are now assigned meaning by ISPF. output data set along with other summary messages.
Problem Determination: This message may be
issued if a previously unassigned (by ISPF) return code DSNE603E INPUT STATEMENT HAS
from the ISPF DISPLAY or EDIT function is UNBALANCED APOSTROPHES
encountered. If a new release of ISPF is used,
Explanation: An opening apostrophe was detected in
determine whether the above return codes are now
an input record, but the end of data set was reached
assigned meaning by ISPF.
before a closing apostrophe was encountered.
System Action: SPUFI processing stops. Correct the
DSNE396A YOU CANNOT SPECIFY DEFER WHEN
error, and start again.
LEAVING SPUFI
User Response: A closing apostrophe was probably
Explanation: You have attempted to leave SPUFI with
omitted from a literal value. Add the missing apostrophe,
outstanding database changes not yet committed or
and execute the input file again.
rolled back. You can’t leave SPUFI unless a decision
has been made to commit or rollback.
DSNE604E THE SQL STATEMENT EXCEEDS THE
System Action: The system is waiting for new input to
MAXIMUM ALLOWED LENGTH
the panel.
Explanation: This message indicates that the
User Response: Specify COMMIT or ROLLBACK.
preceding SQL statement in the output data set
exceeds the maximum length allowed. An SQL
DSNE415A csect-name TYPE IS DATE statement may span up to a maximum of 455 input
records.
Explanation: This is a SPUFI trace message. SPUFI
has looked in the SQLTYPE field of the SQLDA and System Action: SPUFI processing stops. Correct the
detected a data type of DATE. error, and start again.
User Response: Edit the SQL statement in question
DSNE416A csect-name TYPE IS TIME so that it resides on fewer input records.
Explanation: This is a SPUFI trace message. SPUFI
has looked in the SQLTYPE field of the SQLDA and DSNE605E THE INPUT DATA SET IS EMPTY
detected a data type of TIME.
Explanation: The user has specified an input data set
that does not contain any valid SQL statements.
202 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNE606E • DSNE613I
System Action: SPUFI processing stops. Correct the completed, and this message is included in the SPUFI
error, and start again. output.
User Response: Edit SQL statements into the
specified data set, or specify another input data set that DSNE611I COLUMN HEADER FOR COLUMN
contains valid SQL statements. NUMBER nn WAS TRUNCATED
Explanation: An SQL SELECT statement was
| DSNE606E INVALID USE OF AN SQL STATEMENT executed, but the specified column name, identified by
| TERMINATOR 'nn' in the message, was truncated. This truncation
occurred either because the column name was longer
| Explanation: An SQL statement terminator has been
than the remaining record width or because the name
| used improperly in an SQL input statement. Either two
was longer than the user-specified maximum field
| successive statement terminators were encountered, or
length.
| a series of blanks followed by a terminator was
| detected. The proper use of the SQL statement System Action: Input data set processing is
| terminator is to delimit the end of a valid SQL completed, and this message is included in the SPUFI
| statement. output.
System Action: SPUFI processing stops. Correct the User Response: If the truncation is caused by
error, and start again. insufficient record width, use a larger LRECL for the
output data set or specify fewer data columns to be
| User Response: Remove the extraneous terminator returned on the SELECT statement.
| from the input data set.
If the truncation is caused by the user-specified
maximum field length setting, use a larger value for this
DSNE607E PREVIOUS INPUT RECORD HAS
setting.
UNBALANCED SO/SI CHARACTERS
Explanation: A shift out (SO) character was detected
DSNE612I DATA FOR COLUMN HEADER name
in the previous input record with no corresponding shift
COLUMN NUMBER nn WAS
in (SI) character in the record. The SO/SI characters
TRUNCATED
delimit a DBCS string in the SPUFI input data set.
SPUFI requires that SO/SI characters be paired within Explanation: An SQL SELECT statement was
an input record. executed, but data for the specified column name,
identified by 'nn' in the message, was truncated. This
System Action: SPUFI processing stops.
truncation occurred either because the data was longer
User Response: A closing SI character was probably than the remaining record width or because the data
omitted from a literal value. Add the missing SI was longer than the user-specified maximum field
character, and re-execute the input file. length.
System Action: Input data set processing is
DSNE609E INPUT STATEMENT HAS completed, and this message is included in the SPUFI
UNBALANCED QUOTES output.
Explanation: An opening quote (“) was detected in an User Response: If the truncation is because of
input record, but a corresponding quote was not found insufficient record width, use a larger LRECL for the
at the end. Two sets of quotes are used to delimit a output data set or specify fewer data columns be
statement. returned on the SELECT statement.
System Action: SPUFI processing stops. If the truncation is because of the user-specified
maximum field length setting, use a larger value for this
User Response: A closing quote was probably omitted setting.
from a literal value. Add the missing quote, and execute
the input file again.
DSNE613I OUTPUT LRECL IS TOO SMALL TO
DISPLAY THE FOLLOWING COLUMNS:
DSNE610I NUMBER OF ROWS DISPLAYED IS nn
Explanation: An SQL SELECT statement was
Explanation: Execution of an SQL SELECT statement executed, but the logical record length of the output
causes one or more rows of data to be displayed. This data set was not large enough to display the column
message appears in the output data set following the names and data values of all returned columns. The
returned data for a SELECT. It gives a count, 'nn', of the columns specified following this message were not
number of rows displayed. displayed because of insufficient remaining record
System Action: Input data set processing is width.
System Action: Input data set processing is
Chapter 6. DB2 Messages 203
DSNE614I • DSNE622I
completed, and this message is included in the SPUFI SQL Return Codes” on page 9.
output.
System Action: Input data set processing is
User Response: This condition can be avoided by completed, and this message is included in the SPUFI
using a larger LRECL for the output data set or by output.
specifying that fewer data columns be returned on the
SELECT statement.
DSNE618I ROLLBACK PERFORMED, SQLCODE
IS number
DSNE614I AUTOCOMMIT IS NO, NO CHANGES
Explanation: When an error is encountered while
COMMITTED
executing a SPUFI input file, and the user specified an
Explanation: The user delayed committing or rolling AUTOCOMMIT option of 'YES', this message will be
back changes made during execution of the input file written to the output data set to indicate the status of
until later in the session. This is done by specifying an the ROLLBACK that was performed. 'number' specifies
AUTOCOMMIT option of 'NO'. the SQL return code for the statement. These return
codes are listed in “Part 2. SQL Return Codes” on
System Action: Input data set processing is
page 9.
completed, and this message is included in the SPUFI
output. System Action: Input data set processing is
completed, and this message is included in the SPUFI
User Response: Commit or roll back these changes
output.
before ending the session.
DSNE620I NUMBER OF SQL STATEMENTS
DSNE615I NUMBER OF ROWS AFFECTED IS nn
PROCESSED IS nn
Explanation: This message is written to the output
Explanation: This message is written to the output
data set following execution of an SQL UPDATE,
data set after processing all SQL statements in the
INSERT, or DELETE statement. 'nn' in the message is a
current input data set. The term 'nn' is a count of the
count of the number of rows that were modified as a
number of SQL statements processed.
result of executing the UPDATE, INSERT, or DELETE
statement. System Action: Input data set processing is
completed, and this message is included in the SPUFI
Note: In the case of a mass delete of a table in a output.
segmented table space where DB2 does not
access nor count the individual rows, this
DSNE621I NUMBER OF INPUT RECORDS READ
message will not be displayed.
IS nn
System Action: Input data set processing is
Explanation: This message is written to the output
completed, and this message is included in the SPUFI
data set after processing all SQL statements in the
output.
current input data set. The term 'nn' is a count of the
total number of records read from the input data set.
DSNE616I STATEMENT EXECUTION WAS
System Action: Input data set processing is
SUCCESSFUL, SQLCODE IS number
completed, and this message is included in the SPUFI
Explanation: This message is written to the output output.
data set following the successful execution of an SQL
statement from the input data set. 'number' specifies the
DSNE622I NUMBER OF OUTPUT RECORDS
SQL return code for the statement. These return codes
WRITTEN IS nn
are listed in Part 2. SQL Return Codes.
Explanation: This message is written to the output
System Action: Input data set processing is
data set after processing all SQL statements in the
completed, and this message is included in the SPUFI
current input data set. The term 'nn' is a count of the
output.
total number of records written to the output data set.
System Action: Input data set processing is
DSNE617I COMMIT PERFORMED, SQLCODE IS
completed, and this message is included in the SPUFI
number
output.
Explanation: When an input file is executed
successfully and the user specified an AUTOCOMMIT
option of 'YES', this message is written to the output
data set to indicate the status of the COMMIT that was
performed. 'number' specifies the SQL return code for
the COMMIT. These return codes are listed in “Part 2.
204 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNE623I • DSNE800A
Processing of the current SELECT statement is
DSNE623I SYNTAX ERROR AT RECORD xx,
terminated. The maximum number to display is
OFFSET xx
specified by the SPUFI user on the CURRENT SPUFI
Explanation: A syntax error was detected in the SQL DEFAULTS panel.
statement preceding this message in the output data
This message appears in the SPUFI output file.
set. 'xx' identifies the erroneous line number in the SQL
statement, and 'yy' identifies the offset (in characters) of System Action: Processing of subsequent SQL
the error within that record. statements in the input file continues.
System Action: Input data set processing is User Response: If the number of lines displayed is
completed, and this message is included in the SPUFI insufficient, you can increase the maximum number of
output. lines to be displayed for SELECT statements on the
CURRENT SPUFI DEFAULTS panel and re-execute the
User Response: Correct the specified syntax error in
SELECT statement.
the input data set, and execute the job again.
DSNE627I csect-id FOR SQLCODE = number,
DSNE624I UNABLE TO LOAD ISPLINK MODULE.
USER REQUESTED: action
SPUFI PROCESSING TERMINATED
Explanation: During PREPARE processing of the SQL
Explanation: During SPUFI initialization processing,
statement, SPUFI received an SQLCODE (+495) and
an error was encountered attempting to LOAD the ISPF
requested you to respond with the desired action to be
interface module, ISPLINK. This module could not be
taken by SPUFI (CONTINUE or BYPASS).
located in the LNKLST or STEPLIB library
concatenation. SPUFI does not consider this to be an SQL statement
error and places this message in the SPUFI output file
System Action: SPUFI processing is terminated.
to document the SQLCODE received and the action you
User Response: Rearrange your library concatenation requested. number specifies the SQL return code
so that the ISPLINK module can be located. This associated with the PREPARE request. These return
module resides in the ISPF load library. codes are listed in “Part 2. SQL Return Codes” on
page 9.
DSNE625I CONNECT TO LOCATION (location System Action: SPUFI processing for this statement
name) PERFORMED, SQLCODE IS is based on action documented in the message:
number v CONTINUE
Explanation: The SPUFI user has indicated that the – Processing for the current SQL statement
SQL statements defined in the input file are to be continues normally.
processed by the server at the remote location specified v BYPASS
in the CONNECT LOCATION field of the SPUFI panel. – Processing for the current SQL statement is
terminated without error.
This message appears in the output file and indicates
that an SQL CONNECT request was issued by SPUFI User Response: Respond as indicated by the SQL
to the specified location name. The 'number' specifies code returned.
the SQL return code associated with the CONNECT
request. These return codes are listed in “Part 2. SQL
DSNE800A NO DEFAULT VALUES WERE
Return Codes” on page 9.
CHANGED. PRESS ENTER TO
System Action: Subsequent processing of the SQL CONTINUE
statements in the input file is based upon the successful
Explanation: The user left panel DSNESP02 without
completion of the CONNECT request. If the request is
changing it. This panel contains all the defaults that can
unsuccessful, the SQL error number and all associated
be modified by the user.
error messages are placed in the output file.
System Action: This message is presented on the
User Response: Respond as indicated by the SQL
SPUFI panel DSNESP01. SPUFI waits for the next user
code returned.
input.
User Response: Press 'ENTER' if you want to
DSNE626I MAXIMUM OUTPUT LINES FOR
continue.
SELECT STATEMENT REACHED
(number), PROCESSING FOR
CURRENT SELECT STATEMENT
TERMINATED
Explanation: The maximum number of output lines to
be displayed for a SELECT statement was reached.
Chapter 6. DB2 Messages 205
DSNE803A • DSNE910E
DSNE803A INPUT FILE WAS NOT CHANGED. DSNE904I EXECUTION COMPLETE, MEMBER
PRESS ENTER TO CONTINUE member-name REPLACED
Explanation: The user has exited from the ISPF editor Explanation: A DCLGEN subcommand executed
without modifying the input data set. successfully, replacing the 'member-name' specified in
the message.
System Action: The system waits for the next user
input. System Action: The TSO attachment facility is ready
for more input.
User Response: Press 'ENTER' if you want to
continue. The SPUFI panel variable settings can be
changed at this point. DSNE905I EXECUTION COMPLETE, MEMBER
member-name ADDED
DSNE804A TO CONTINUE, C (COMMIT) OR R Explanation: A DCLGEN subcommand executed
(ROLLBACK) MUST BE SPECIFIED successfully, adding the 'member-name' specified in the
message to the data set specified in the DCLGEN
Explanation: The user has specified the
subcommand.
AUTOCOMMIT=NO option and now wants either to exit
or to switch to another DB2 subsystem with outstanding System Action: The TSO attachment facility is ready
work uncommitted on the current DB2 subsystem. for more input.
System Action: DB2 waits for the user to specify
either the COMMIT (C) or the ROLLBACK (R) option. DSNE908E csect-name INVALID USE OF parameter
IN PARAMETER LIST OF KEYWORD
User Response: Enter 'C' or 'R' to continue.
keyword.
Explanation: An invalid parameter was specified in
DSNE808A EDIT SESSION HAS COMPLETED.
the parameter list of the specified keyword.
PRESS ENTER TO CONTINUE.
Severity: 8
Explanation: The user has exited from the ISPF
editor. System Action: Subcommand processing is
terminated. The TSO attachment facility is ready for
System Action: SPUFI waits form the next user input.
more input.
User Response: Press 'Enter' if you want to continue.
User Response: Correct the parameter list in error,
Press 'END' if you want to terminate your SPUFI
and resubmit the job.
session. The SPUFI panel variable settings can be
changed at this point.
DSNE909E csectname WARNING, DBCSSYMBOL
KEYWORD IS INVALID WITH
DSNE901I EXECUTION COMPLETE
LANGUAGE language KEYWORD
Explanation: Execution of a subcommand has IGNORED
successfully completed.
Explanation: You specified the DBCSSYMBOL
System Action: The TSO attachment facility is ready keyword in your DCLGEN invocation, but your
for more input. LANGUAGE keyword value was not COB2.
DBCSSYMBOL only applies to COB2 PICTURE
clauses. DCLGEN will ignore this keyword.
DSNE903I WARNING, DECLARATION HAS SAME
NAME AS TABLE table-name System Action: DCLGEN processing continues.
Explanation: A DCLGEN subcommand has a User Response: In the future, do not specify the
'STRUCTURE' parameter that is the same as the 'table DBCSSYMBOL keyword unless the LANGUAGE
name' specified in the message. The requested keyword value is COB2.
declaration has been created, but this could cause
conflicts with internal names.
DSNE910E csectname WARNING, THE OWNER
System Action: DCLGEN execution continues. KEYWORD WAS SPECIFIED WITH A
QUALIFIED TABLE NAME. OWNER
User Response: Choose a different 'STRUCTURE' KEYWORD IGNORED
parameter.
Explanation: You specified both the OWNER keyword
and a qualified table name for the TABLE keyword in
your DCLGEN invocation. The table qualifier will be
used as the table owner, and the OWNER keyword will
be ignored.
206 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNE920E • DSNE926E
System Action: DCLGEN processing continues. stream in the DSNTRACE data set. Use the ABEND
subcommand of the DSN command processor to collect
User Response: In the future, specify either a
a dump. If you suspect an error in DB2, refer to Part 2
qualified table name for the TABLE keyword, or an
of DB2 Diagnosis Guide and Reference for information
unqualified table name for the TABLE keyword along
on identifying and reporting the problem.
with the OWNER keyword.
DSNE924E PARSE FAILED IN CSECT csect-name
DSNE920E member-name ALREADY EXISTS,
PARAMETER parm, FLAG flag
SPECIFY ACTION(REPLACE) TO
REPLACE Explanation: This is a DB2 subsystem error, not a
user error. The 'PARM' parameter was not correctly
Explanation: The DCLGEN user tried to overwrite an
parsed. The flag specified was detected as an
old declaration with a new one without specifying
inappropriate value in a parse results field.
REPLACE on the 'ACTION' parameter.
System Action: The TSO attachment facility is ready
System Action: The TSO attachment facility is ready
for more input.
for more input.
User Response: Report the problem to the system
User Response: Change the 'ACTION' parameter to
programmer.
REPLACE (if that’s actually what you want to do), and
resubmit the command. System Programmer Response: Re-create the
problem with DSN tracing turned on. Collect the trace
stream in the DSNTRACE data set. Use the ABEND
DSNE921E REQUIRED PARAMETER
subcommand of the DSN command processor to collect
table-parameter IS MISSING
a dump. If you suspect an error in DB2, refer to Part 2
Explanation: Your DCLGEN subcommand was of DB2 Diagnosis Guide and Reference for information
missing the required TABLE parameter. on identifying and reporting the problem.
System Action: Your DCLGEN subcommand was not
processed. The DSN command processor issued a DSNE925E BUFFER OVERFLOW IN CSECT
return code of 8. DSN is ready for more input. csect-name WHILE WRITING string
User Response: Resubmit the DCLGEN subcommand Explanation: This is a DCLGEN subsystem error.
with a TABLE parameter. CSECT 'csect-name' detected a buffer overflow
condition while attempting to write 'string'.
DSNE922E TABLE NAME QUALIFIER OF qualifier System Action: The TSO attachment facility is ready
IS TOO LONG. CANNOT EXCEED 8 for more input.
CHARACTERS IN LENGTH
User Response: Notify the system programmer.
Explanation: DCLGEN detected an invalid TABLE
System Programmer Response: Re-create the
parameter. The table name qualifier (the left portion of
problem with DSN tracing turned on. Collect the trace
the table name) was too long.
stream in the DSNTRACE data set. If you suspect an
System Action: Your DCLGEN subcommand was not error in DB2, refer to Part 2 of DB2 Diagnosis Guide
processed. The DSN command processor issued a and Reference for information on identifying and
return code of 8. DSN is ready for more input. reporting the problem.
User Response: Resubmit the DCLGEN subcommand
with a shorter table name qualifier. DSNE926E COMMAND REJECTED, command NOT
SUPPORTED UNDER subsystem
DSNE923E CSECT csect-name FOUND AN Explanation: The user entered a TSO TIME or TEST
UNRECOGNIZED LANGUAGE unknown command. These are not supported by DSN or DB2I.
Explanation: This is a DCLGEN subsystem error, not System Action: The user should leave DSN or DB2I,
a user error. The language parameter 'unknown' is not return to TSO, and retry the command. DSN can be run
known to the subsystem. under TSO TEST. The TSO attachment facility is ready
for more input.
System Action: The TSO attachment facility is ready
for more input. User Response: Enter the DSN subcommand, or
leave DSN to execute the requested command.
User Response: Report the problem to the system
programmer.
System Programmer Response: Re-create the
problem with DSN tracing turned on. Collect the trace
Chapter 6. DB2 Messages 207
DSNE927E • DSNE937I
DSNE927E RUN SUBCOMMANDS REQUIRE DSNE931E csect-name keyword-name
(1)PROGRAM PARM OR (2)PLAN AND (parameter_value) CONTAINS AN
CP PARMS INVALID SYMBOL (symbol)
Explanation: RUN subcommands may contain (1) the Explanation: An invalid 'symbol' (symbol) was
'PROGRAM' parameter and, optionally, the 'PLAN' specified in the 'parameter_value' associated with the
parameter or (2) the 'PLAN' and command processor specified 'keyword-name'.
('CP') parameters. Combinations of (1) and (2) are not
Severity: 8
allowed.
System Action: Subcommand processing is
System Action: The TSO attachment facility is ready
terminated. The TSO attachment facility is ready for
for more input.
more input.
User Response: Correct the subcommand, and
User Response: Correct the keyword
resubmit the job.
'parameter_value' in error, and resubmit the job.
DSNE928E RUN SUBCOMMANDS CANNOT HAVE
DSNE932I WARNING, ONLY IBM SUPPLIED
A PROGRAM PARM AND A CP PARM
names SHOULD BEGIN WITH DSN
Explanation: A RUN subcommand cannot contain
Explanation: The user has issued a BIND, REBIND,
both the 'PROGRAM' and command processor ('CP')
or FREE subcommand, using a name or id that begins
parameters. The subcommand should be resubmitted
with DSN.
with only one of the parameters.
System Action: Processing continues.
System Action: The TSO attachment facility is ready
for more input. User Response: In the future, do not use plan-names,
collection-ids, or package -ids that begin with DSN. It
User Response: Correct the subcommand, and
would be a good idea to FREE the plan or package you
resubmit the job.
just created and to BIND again with a new plan-name,
collection-id, or package-id.
DSNE929E TABLE NAME LOCATION OF
(location-name) IS TOO LONG.
DSNE935I ... IS THE DCLGEN COMMAND THAT
CANNOT EXCEED 16 CHARACTERS IN
MADE THE FOLLOWING STATEMENTS
LENGTH.
Explanation: This message is a part of normal
Explanation: DCLGEN detected an invalid
DCLGEN output. It identifies the DCLGEN command
AT(location) keyword parameter. The specified location
that produced the declaration of which it is a part.
name is too long.
System Action: This message is included in the
System Action: Your DCLGEN subcommand was not
DCLGEN output.
processed. The DSN command processor issues a
return code of 8. The DSN is ready for more input.
DSNE936I THE NUMBER OF COLUMNS
User Response: Resubmit the DCLGEN subcommand
DESCRIBED BY THIS DECLARATION
specifying a location name that does not exceed 16
IS nnn
characters.
Explanation: This message is a part of normal
DCLGEN output. It tells how many columns were in the
DSNE930E TABLE NAME OF table-name MUST BE
table that was named in the DCLGEN command.
QUALIFIED WHEN SPECIFIED WITH
LOCATION OF location-name System Action: This message is included in the
DCLGEN output.
Explanation: DCLGEN detected an invalid TABLE
keyword parameter. You must specify a qualified table
name with the AT (location) keyword. DSNE937I COBOL DECLARATION FOR TABLE
table-name
System Action: Your DCLGEN subcommand was not
processed. The DSN command processor issues a Explanation: This message is a part of normal
return code of 8. DSN is ready for more input. DCLGEN output. It tells the name of the table for which
the declaration was created.
User Response: Specify a qualified table name and
resubmit the DCLGEN command. System Action: This message is included in the
DCLGEN output.
208 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNE938I • DSNE944I
starting or ending position of the parameter, but the
DSNE938I PLI DECLARATION FOR TABLE
parameter value is not bracketed by both characters.
table-name
This message is also generated if the first character of
Explanation: This message is a part of normal the connection name is not an alphabetic character.
DCLGEN output. It tells the name of the table for which
If the LU name format of the REMOTE keyword is to be
the declaration was created.
used, the name must be specified as <LU_name>.
System Action: This message is included in the
Severity: 8
DCLGEN output.
System Action: Subcommand processing is
terminated. DSN command processor reissues the DSN
DSNE939E csect-name THE COMBINATION
prompt to allow another subcommand to be entered.
ACQUIRE(ALLOCATE) AND
RELEASE(COMMIT) IS NOT ALLOWED User Response: Correct the keyword
'parameter_value' in error, and resubmit the job. Refer
Explanation: The BIND or REBIND subcommand was
to DB2 Command Reference for additional information
submitted with conflicting parameters. You cannot
about the specification of connection names for the
specify ACQUIRE(ALLOCATE) and
REMOTE keyword.
RELEASE(COMMIT) on the same subcommand.
System Action: The subcommand is terminated and
DSNE943E csect-name REMOTE CONNECTION
the DSN command processor reissues the DSN prompt
NAME (parameter_value) CANNOT
to allow another subcommand to be entered.
EXCEED (length_value) CHARACTERS
User Response: Enter the corrected subcommand. IN LENGTH
Refer to DB2 Command Reference for additional
Explanation: The REMOTE connection name
information about the BIND and REBIND
'parameter_value' specified is greater than the length
subcommands.
'length_value' permitted for the REMOTE keyword.
This message is issued if the REMOTE location name
DSNE940E DEFER(PREPARE) INVALID WITH
format exceeds 16 characters, or the LU name format
NODEFER(PREPARE)
(<LU name>) exceeds 10 characters in length.
Explanation: The BIND or REBIND subcommand was
Severity: 8
submitted with conflicting parameters. You cannot
specify DEFER(PREPARE) and NODEFER(PREPARE) System Action: Subcommand processing is
on the same subcommand because these actions terminated. DSN command processor reissues the DSN
conflict. prompt to allow another subcommand to be entered.
System Action: The subcommand is terminated and User Response: Correct the keyword
the DSN command processor reissues the DSN prompt 'parameter_value' in error and resubmit the job. Refer to
to allow another subcommand to be entered. DB2 Command Reference for additional information
about the specification of connection names for the
User Response: Enter the corrected subcommand.
REMOTE keyword.
Refer to DB2 Command Reference for additional
information regarding the BIND and REBIND
subcommands. DSNE944I WARNING, BECAUSE YOUR TABLE OR
COLUMN NAMES CONTAIN LOWER
CASE OR NON-ALPHABETIC
DSNE941I DSNBIND IS A RESERVED PLAN NAME
CHARACTERS, YOU WILL NEED TO
Explanation: This message is generated when the USE THE SQL (NOT PL/I) INCLUDE
plan name is 'DSNBIND' in a BIND statement. STATEMENT TO INCLUDE DCLGEN
OUTPUT INTO YOUR PROGRAM
System Action: Subcommand processing is
terminated. The TSO attachment facility is ready for Explanation: DCLGEN had to wrap your table or
more input. column name(s) in quotes so DB2 could process them.
Quotes are not recognized by the PL/I compiler. To
User Response: Change the plan-name and resubmit
avoid compilation errors, use the SQL INCLUDE
the job.
statement ('EXEC SQL INCLUDE membername') to
merge the DCLGEN output with your source program.
DSNE942E csect-name REMOTE CONNECTION
Refer to Chapter 5 of DB2 SQL Reference for more
NAME (parameter_value) HAS INVALID
information about the SQL INCLUDE statement.
FORMAT
System Action: DCLGEN processing continues.
Explanation: The REMOTE connection name
'parameter_value' contains a < or > character in the User Response: If you have not coded the SQL
Chapter 6. DB2 Messages 209
DSNE947I • DSNE954I
INCLUDE, do so before the next compile.
DSNE950E DCLGEN DOES NOT SUPPORT THE
lang LANGUAGE
DSNE947I QUOTE PARAMETER IS ONLY VALID
Explanation: A DCLGEN user attempted to specify a
WITH COBOL. IT HAS BEEN CHANGED
LANGUAGE parameter, 'lang', that DCLGEN does not
TO APOST
support.
Explanation: You specified the DCLGEN QUOTE
System Action: DCLGEN processing terminates.
parameter and a non-COBOL language parameter. This
combination is not valid. The QUOTE parameter was User Response: Correct the LANGUAGE parameter
specified as either a parameter on the DCLGEN and resubmit the DCLGEN subcommand.
subcommand or a default set for your site at DB2
installation time.
DSNE952I C DECLARATION FOR TABLE
The DCLGEN processor changed the QUOTE setting table-name
(for this run) to APOST.
Explanation: This message is a part of normal
System Action: DCLGEN processing continues and DCLGEN output. It tells the name of the table for which
should produce valid output. the declaration was created.
User Response: If you used QUOTE on the DCLGEN System Action: This message is included in the
command, you may want to change it to APOST before DCGLEN output.
submitting it again.
DSNE953I csect-name PRECISION OF DECIMAL
DSNE948I csect-id FURTHER subcommand COLUMN colname EXCEEDS THE
PROCESSING WILL NOT BE MAXIMUM PRECISION FOR THE lang
ATTEMPTED LANGUAGE.
Explanation: A DSN command processor Explanation: DCLGEN was building a COBOL or PL/I
subcommand (indicated in the message) has language declaration for a table when it encountered a
encountered an error which stopped DSN from decimal column with a precision greater than the
processing this subcommand. The subcommand will not precision supported by the language.
complete normally. This message is accompanied by
System Action: DCLGEN set the return code to 4 and
other messages explaining the exact nature of the
processed the rest of the table.
problem.
User Response: This is a warning. Be aware that the
System Action: Subcommand processing terminates.
declaration for column 'colname' causes a compiler
The DSN prompt is reissued, indicating DSN is ready
error. You must edit the declaration before including it in
for another subcommand.
an application program.
User Response: Read the accompanying messages
for help in deciding what to do next.
DSNE954I csect-name USE OF THE DCLGEN
COLSUFFIX(YES) OPTION WILL
DSNE949E COMMIT PROCESSING ABNORMAL RESULT IN A MIXED FIELD NAME FOR
TERMINATION, REASON CODE COLUMN colname. THE lang
reason_code LANGUAGE DOES NOT SUPPORT
MIXED FIELD NAMES.
Explanation: The DSN command processor has
initiated a 'prepare to commit' request in DB2. The Explanation: The COLSUFFIX(YES) option and a
request is rejected when DB2 cannot commit the work double-byte NAMES prefix were specified in a DCLGEN
performed invocation, but column colname contains single-byte
characters. This combination would result in a
System Action: Commit processing is terminated.
generated field name with a mixture of double-byte and
User Response: Examine the reason code associated single-byte characters, but the lang language does not
with this message, and respond as indicated before support mixed field names.
resubmitting the job.
System Action: DCLGEN set the return code to 4 and
Problem Determination: Reference the associated generated the field name as requested.
reason code to determine why the 'prepare to commit'
User Response: This is a warning. Be aware that the
was not successful.
declaration for column colname causes a compiler error.
You must edit the declaration before including it in an
application program.
210 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNE955I • DSNE969E
REBIND/BIND PACKAGE/PLAN or FREE PACKAGE
DSNE955I csect-name COLSUFFIX(YES) WAS
subcommand.
SPECIFIED WITHOUT A NAMES
PREFIX. COLUMN NAMES WILL BE
USED FOR FIELD NAMES. DSNE965E parameter_value IS NOT A VALID
keyword KEYWORD PARAMETER
Explanation: When COLSUFFIX(YES) is specified in
a DCLGEN invocation, DCLGEN generates field names Explanation: The parameter_value is not a valid
by concatenating the NAMES prefix with the column parameter value for the keyword.
names. However, no NAMES prefix was specified.
System Action: Subcommand processing terminates.
System Action: DCLGEN set the return code to 4 and The DSN command processor reissues the DSN prompt
used the column names as field names. to allow you to enter another subcommand.
User Response: This is a warning. Specify a NAMES User Response: Enter the corrected subcommand.
prefix when you specify COLSUFFIX(YES). Refer to DB2 Command Reference for additional
information about the parameter values supported on
the keyword.
DSNE956A A FIELD NAME PREFIX MUST BE
SPECIFIED WHEN COLUMN SUFFIX
VALUE IS YES. DSNE966E connection_type KEYWORD OMITTED
FROM THE ENABLE|DISABLE
Explanation: When YES is specified for the COLUMN
DECLARATION
SUFFIX field on the DCLGEN panel, DCLGEN
generates field names by concatenating the value in the Explanation: The 'connection_type' keyword was not
FIELD NAME PREFIX field with the column names. specified in either the ENABLE or DISABLE keywords
However, no value was specified for FIELD NAME and is required if connection-names are specified for the
PREFIX. 'connection_type'.
System Action: The DCLGEN panel generated this Severity: 8
error message.
System Action: Subcommand processing is
User Response: Specify a FIELD NAME PREFIX terminated. DSN command processor reissues the DSN
value, or change the COLUMN SUFFIX value to NO. prompt to allow you to enter another subcommand.
User Response: Enter the corrected subcommand.
DSNE960E PARAMETER STRING EXCEEDS Refer to DB2 Command Reference for additional
ALLOWABLE LIMIT OF 100 (DECIMAL) information about the connection type parameter values
CHARACTERS supported on the ENABLE and DISABLE keywords.
Explanation: The PARMS option parameter-string of
the RUN subcommand cannot exceed 100 (decimal) DSNE967E keyword_name KEYWORD CANNOT
characters in length. BE SPECIFIED MORE THAN ONCE
PER RUN
System Action: The TSO attachment facility is ready
for more input. Explanation: Either the BIND PACKAGE MEMBER or
LIBRARY keywords specified more than one parameter
User Response: Correct the PARMS option and
value. Only one member or library name is permitted.
resubmit the job.
Severity: 8
DSNE964E csect-name INVALID SYNTAX FOR System Action: Subcommand processing is
keyword KEYWORD PARAMETER terminated. DSN command processor will reissue the
parameter DSN prompt to allow another subcommand to be
entered.
Explanation: A parameter that does not follow DB2
naming conventions was specified for keyword. User Response: Enter the corrected subcommand.
Refer to DB2 Command Reference for additional
System Action: Subcommand processing is
information regarding the BIND PACKAGE and BIND
terminated. The DSN command processor reissues the
PLAN subcommands.
DSN prompt to allow you to enter another
subcommand.
DSNE969E csect-name keyword1 IS MUTUALLY
User Response: Correct the keyword parameter value
EXCLUSIVE WITH keyword2
in error, and resubmit the command. Refer to DB2
Command Reference for additional information about Explanation: Both the PKLIST and NOPKLIST
the specification of a package name and the keywords, cannot be specified on one invocation of the
REBIND PLAN subcommand. Both the ENABLE and
Chapter 6. DB2 Messages 211
DSNE970E • DSNE999
DISABLE keywords cannot be specified on one Command Reference for additional information about
invocation of the BIND/REBIND PLAN/PACKAGE the BIND PACKAGE/PLAN subcommands.
subcommand.
Severity: 8 DSNE975E csect-name keyword KEYWORD IS
ONLY VALID WHEN COPY KEYWORD
System Action: Subcommand processing is
IS PRESENT
terminated. DSN command processor will reissue the
DSN prompt to allow another subcommand to be Explanation: A keyword was issued that may only be
entered. specified in conjunction with the COPY keyword.
User Response: Enter the corrected subcommand. keyword
Refer to DB2 Command Reference for additional COPYVER or OPTIONS
information regarding the REBIND PLAN subcommand.
Severity: 8
System Action: Subcommand processing is
DSNE970E EITHER MEMBER OR PKLIST MUST
terminated. The DSN command processor will reissue
BE SPECIFIED, BOTH ARE ALSO
the DSN prompt to allow another subcommand to be
ALLOWED
entered.
Explanation: The BIND PLAN subcommand requires
User Response: Enter the corrected subcommand.
either the MEMBER or PKLIST keyword, and neither
Refer to DB2 Command Reference for additional
was specified. Either keyword or both may be specified.
information regarding the BIND PACKAGE
Severity: 8 subcommand.
System Action: Subcommand processing is
terminated. DSN command processor will reissue the DSNE976E LIBRARY KEYWORD IS ONLY VALID
DSN prompt to allow another subcommand to be WHEN MEMBER KEYWORD IS
entered. PRESENT
User Response: Enter the corrected subcommand. Explanation: The LIBRARY keyword may only be
Refer to DB2 Command Reference for additional specified in conjunction with the MEMBER keyword.
information regarding the BIND PLAN subcommand.
Severity: 8
System Action: Subcommand processing is
DSNE971E EITHER MEMBER OR COPY BUT NOT
terminated. The DSN command processor will reissue
BOTH MUST BE SPECIFIED
the DSN prompt to allow another subcommand to be
Explanation: The BIND PACKAGE subcommand entered.
requires either the MEMBER or COPY keyword; both
User Response: Enter the corrected subcommand.
are not allowed on the same subcommand invocation.
Refer to DB2 Command Reference for additional
Severity: 8 information regarding the BIND PACKAGE
subcommand.
System Action: Subcommand processing is
terminated and the DSN command processor will
reissue the DSN prompt to allow another subcommand DSNE999 INVALID SQL RETURN CODE
to be entered.
Explanation: The number you selected is not a valid
User Response: Enter the corrected subcommand. SQL return code.
Refer to DB2 Command Reference for additional
This message is issued by panel: DSN4SRC
information regarding the BIND PACKAGE
subcommand. User Response: Check the number and enter it again.
DSNE974E csect-name keyword1 KEYWORD IS
INVALID WITH keyword2 KEYWORD.
Explanation: The keyword2 should not be specified
with keyword1.
System Action: Subcommand processing is
terminated. The DSN command processor reissues the
DSN prompt to allow another subcommand to be
entered.
User Response: Modify one of the keywords on the
command and resubmit the job. Refer to DB2
212 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 7. DSNF... Messages
DSNF001I MESSAGE GENERATOR
INITIALIZATION PARAMETERS NOT
FOUND. DEFAULTS ASSUMED
Explanation: The message generator was unable to
access the routing code initialization parameter defined
by the DSN6SYSP macro. Default values defined by
that macro are assumed.
System Action: Subsystem initialization continues.
Operator Response: Notify the system programmer.
System Programmer Response: It might be
necessary to change the DSN6SYSP macro and
replace the DSN6SYSP member of the DSNIPARM
directory. Refer to Part 2 of DB2 Installation Guide for
details of this process.
DSNF700I csect-name message-id HAS BEEN
ISSUED
Explanation: An unsuccessful attempt has been made
to issue the message 'message-id'. This message is
issued only if the requested message could not be
found in the DB2 message directory.
System Action: The system proceeds as though the
requested message had been issued.
Operator Response: Notify the system programmer.
System Programmer Response: Refer to this manual
for actual message text. You need the message number
('message-id'). If you suspect an error in DB2, refer to
Part 2 of DB2 Diagnosis Guide and Reference for
information on identifying and reporting the problem.
© Copyright IBM Corp. 1982, 2001 213
214 DB2 UDB for OS/390 and z/OS: Messages and Codes
|
| Chapter 8. DSNG... Messages
|
| DSNG001I EDM stype CAN NOT BE DECREASED
| BELOW THE VALUE isize SPECIFIED
| AT DB2 STARTUP
| Explanation: The EDM stype storage cannot be
| decreased below the size that was specified at DB2
| startup.
| System Action: Processing continues.
|
| DSNG002I EDM stype HAS AN INITIAL SIZE isize,
| REQUESTED SIZE rsize, AND AN
| ALLOCATED SIZE asize
| Explanation: This message is issued in response to a
| request to increase or decrease the EDM stype storage.
| isize The EDM stype storage size prior to the
| request for a change.
| rsize The requested EDM stype storage size.
| asize The EDM stype storage size immediately
| available.
| v When increasing the EDM Pool or EDM
| DATASPACE, the asize is the storage
| available to satisfy the request.
| v When decreasing the EDM Pool or EDM
| DATASPAC, the asize is the INITIAL size
| reduced by the amount that could be
| released immediately.
| When the asize is larger than the rsize, the
| difference is marked to be released when it
| is no longer referenced.
| System Action: Processing continues.
|
| DSNG003I INSUFFICIENT VIRTUAL STORAGE TO
| EXPAND EDM stype STORAGE
| Explanation: Insufficient virtual storage exists to
| expand the EDM stype storage as specified.
| System Action: The EDM stype storage is expanded
| only to the size allowed by the available virtual storage.
© Copyright IBM Corp. 1982, 2001 215
216 DB2 UDB for OS/390 and z/OS: Messages and Codes
|
Chapter 9. DSNH... Messages
Message line numbers
The line number nnnn in the following compiler messages is generated by assigning
sequential numbers to the original source. The numbers are printed on the SQL
precompiler source listing (if the SOURCE option is specified to the precompiler).
'COL cc' in the messages identifies the source column in which the condition was
detected. This is usually the location of the column containing the first character of
the associated source token. However, if the precompiler cannot determine this
location, it is the beginning of the statement. Because the detected error might be
similar to a valid, but different, construction, the SQL parsing might indicate the
wrong location for the error.
Message severity codes
One of the characters I, W, E, S, or U is shown at the beginning of each
precompiler message as an aid to the programmer. These characters indicate the
severity level as follows:
I 0 Informational
W 4 Warning
E 8 Error
S 12 Severe error
U 16 Unrecoverable error
When unsupported non-DB2 statements are detected during SQL(ALL)
precompilation, the return code will be forced to 4 if the return code was 8, and no
host-related errors were detected. This is done so that the application can proceed
with the compilation and link-edit steps. This allows the syntax checking to be
delayed until bind. If a severity 8 precompiler error message is not a host-related
error, the precompiler treats the error as a warning and place a W instead of an E
in the precompiler output listing. In this instance, the precompiler also issues
DSNH049I to indicate that the actual return code 8 from the precompiler was
changed to 4.
The following precompiler messages with severity levels of 8 are not changed from
errors to warnings when SQL(ALL) is in effect:
DSNH051I
DSNH080I
DSNH290I
DSNH291I
DSNH292I
DSNH312I
DSNH313I
DSNH314I
DSNH504I
© Copyright IBM Corp. 1982, 2001 217
DSNH003I • DSNH009I
Source tokens in messages
Tokens from your source program do not always appear in messages exactly as
they appear in your program. For example, leading zeros are removed from integer
tokens.
System Programmer Response: Ensure that the
DSNH003I S csectname FILE ddname
SYSIN data is provided. Also ensure that SYSLIB is
PARAMETERS INCORRECT
defined if the application program contains SQL
Explanation: The file ddname has invalid or incorrect INCLUDE statements.
parameters, such as logical record length.
Severity: 12 (severe error) DSNH007I E csectname LINE nnnn COL cc
ILLEGAL CHARACTER IGNORED: 'c'
System Action: The precompiler is terminated.
('hh'X)
User Response: Correct the data set or library
Explanation: The character identified in the message
parameters.
as c is not permitted. The hexadecimal representation
for the character is hh.
DSNH004I S csectname type COULD NOT BE
Severity: 8 (error)
FOUND
System Action: The character is ignored.
Explanation: The precompiler could not find the
indicated type of statement in the application program User Response: Correct the character. It might need
source. This message is only issued for HOST(COBOL) to be within quotation marks or apostrophes.
and HOST(COB2). The type is DATA DIVISION,
WORKING-STORAGE SECTION, or PROCEDURE
DSNH008I S csectname LINE nnnn COL cc
DIVISION. This error can cause other errors.
NESTED INCLUDE NOT SUPPORTED
Severity: 12 (severe error)
Explanation: While processing an INCLUDE, another
System Action: Processing continues. Additional nested INCLUDE statement was encountered.
errors might result.
Severity: 12 (severe error)
User Response: Ensure that the host language
System Action: The nested INCLUDE statement is
statement in your application program is correct and
ignored.
that the statement is present within the proper margins.
User Response: Remove the nested INCLUDE
statements; they are not allowed in an included file. The
DSNH005I U csectname FILE ddname NO MEMBER
DB2 precompiler permits only one level of INCLUDE
NAME SPECIFIED
statements.
Explanation: The ddname must refer to a partitioned
data set, and the member name must be specified in
DSNH009I S csectname LINE nnnn COL cc
the allocation. This helps to prevent accidental erasure
MEMBER name COULD NOT BE
of the DBRM library.
INCLUDED
Severity: 16 (unrecoverable error)
Explanation: The identified member name was not
System Action: The precompiler is terminated. found or could not be read.
User Response: Correct the JCL or TSO allocate Severity: 12 (severe error)
command to specify a member name.
System Action: Processing continues without the data
from that member.
DSNH006I U csectname FILE ddname COULD NOT
User Response: Ensure that the member is in the
BE OPENED
library and that its name is spelled correctly. Check and
Explanation: The file identified in the message is correct any JCL errors. They are likely to cause other
required, but it could not be opened. errors. Ensure that the data set and library parameters
are correct.
Severity: 16 (unrecoverable error)
System Action: The precompiler is terminated.
User Response: Ensure that the file is present in your
JCL.
218 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNH010I • DSNH021I
System Action: The precompiler is terminated.
DSNH010I S csectname LINE nnnn COL cc
UNTERMINATED STRING CONSTANT User Response: Move up the SQL statement and
BEGINNING text corresponding host variable declaration to the main
program or to the first program and resubmit the job.
Explanation: The constant identified in the message
as 'text' is not terminated properly.
DSNH014I S csectname LINE nnnn COL cc SQL
Severity: 12 (severe error)
STATEMENT IS FOUND IN AN
System Action: The string is treated as if it were INAPPROPRIATE PLACE
terminated by the end of file.
Explanation: If any SQL statement is found in the
User Response: Terminate the string constant. Check COBOL DECLARATIVES section, this message is
for and correct any missing or extra quotation marks issued.
and apostrophes. These errors are likely to cause
Severity: 12 (severe error)
others. Some statements were probably missed
because of missing or extra string delimiters. System Action: Processing continues. Additional
errors might result.
DSNH011I S csectname LINE nnnn COL cc User Response: Move the SQL statement out of the
UNTERMINATED COMMENT COBOL DECLARATIVES section and resubmit the job.
Explanation: A comment is not terminated properly.
This message is only issued for HOST(PLI) and DSNH016I E csectname LINE nnnn COL cc token
HOST(C). REQUIRED
Severity: 12 (severe error) Explanation: The required character or keyword
identified as token is missing.
System Action: The string is treated as if it were
terminated by the end of file. Severity: 8 (error)
User Response: Ensure that the comment terminator System Action: The token is assumed to be present
is typed properly and that it is within the specified in order to continue checking the statement syntax.
margins. This error is likely to cause others. Some
statements were probably missed because of the User Response: Correct the SQL statement.
missing comment terminator. Determine if you skipped either this keyword or another
keyword earlier in the SQL statement. The assumed
token is printed in the SYSTEM error message. This
DSNH012I W csectname LINE nnnn COL cc token might not be what you intended, even though it is
INVALID CONTINUATION the only symbol allowed in the clause at this point.
Explanation: The continuation does not follow the
host language rules. DSNH019I W csectname OPTION: INVALID
OPTION option
Severity: 4 (warning)
Explanation: The identified option was requested, but
System Action: Processing continues. Additional
it is not a precompiler option.
errors might result.
Severity: 4 (warning)
User Response: Follow the host language
continuation rules and embedded SQL continuation System Action: The option is ignored.
rules. Check the margin option. This error is most
common in assembler language in cases where a User Response: Check the valid precompiler options
continuation begins before the continuation column (the to determine if your spelling is correct for this option.
continuation column is column 16 by default). This problem might cause additional errors if the
APOST, APOSTSQL, COMMA, HOST, MARGINS,
QUOTESQL, or TWOPASS option is needed but not
DSNH013I E csectname LINE nnnn COL cc SQL specified. The other options are either defaults or affect
STATEMENT FOUND OTHER THAN IN only the listing. Correct the problem and run the
THE FIRST PROGRAM (OR MAIN precompile again.
PROGRAM)
Explanation: This message is for VS COBOL II only. If DSNH021I W csectname OPTION: SUBOPTION
any SQL statement is found in the source after the first NOT PERMITTED WITH OPTION option
program in a BATCH COMPILE or the end of the main
program of a nested program, this message is issued. Explanation: The identified option cannot have
suboptions, but one or more were specified.
Severity: 8 (error)
Severity: 4 (warning)
Chapter 9. DB2 Messages 219
DSNH022I • DSNH029I
System Action: The suboptions are ignored. Severity: 4 (warning)
User Response: None is required. However, you System Action: The MARGINS option is ignored.
should remove the suboption.
User Response: Ensure that the source statements
are within the proper margins and that the margins are
DSNH022I W csectname OPTION: UNMATCHED ')' specified correctly. The margins for COBOL must be 8,
TAKEN AS ',' 72. The margins for FORTRAN must be 1, 72.
Explanation: An unmatched ending parenthesis was
found before the end of the option string. DSNH027I W csectname SUBOPTION suboption
TOO LONG, TRUNCATED AFTER
Severity: 4 (warning)
numofchar CHARS
System Action: The parenthesis is assumed to be a
Explanation: The version ID is greater than
comma.
numofchar bytes long. The maximum length for the
User Response: Balance the parentheses. version ID is 64 bytes.
Severity: 4 (warning)
DSNH023I W csectname OPTION: SUBOPTION
System Action: The option is honored, but the version
MISSING FOR OPTION option
ID is truncated after 64 bytes.
Explanation: The specified option requires a
User Response: Refer to the 'options used' list in the
suboption, but one was not provided.
precompiler output to see what version ID was used.
Severity: 4 (warning)
System Action: The option is ignored. DSNH028I W csectname ATTACH SUBOPTION
suboption NOT PERMITTED WITH HOST
User Response: Provide a suboption or remove the (FORTRAN) SPECIFIED.
option. This problem might cause additional errors if the
HOST or MARGINS option is needed but not specified. Explanation: The identified suboption for precompiler
The other options are either defaults or affect only the option ATTACH cannot take effect when the application
listing. Correct the problem and run the precompile is a FORTRAN application because the interface code
again. for FORTRAN is always DSNHFT.
Severity: 4 (warning)
DSNH024I W csectname OPTION: SUBOPTION
System Action: The option is ignored.
suboption INVALID FOR OPTION option
User Response: None is required. However, you can
Explanation: The identified suboption is not allowed
either code ATTACH(TSO) or specify no ATTACH
for the option specified.
precompiler option
Severity: 4 (warning)
System Action: The entire option is usually ignored. DSNH029I E csectname LINE nnnn COL cc INTO
CLAUSE REQUIRED
User Response: Refer to the 'options used' list in the
precompiler output listing to see if the option was used. Explanation: SELECT statements embedded in an
Remove the suboption. application program must have an INTO clause to
denote where the results of the SELECT are to be
placed. Dynamic SELECT statements do not permit the
DSNH025I W csectname OPTION: EXCESSIVE INTO clause.
SUBOPTIONS FOR OPTION option
Severity: 8 (error)
Explanation: Too many suboptions were given for the
identified option. System Action: The statement is replaced by host
language statements that, if executed, set an error code
Severity: 4 (warning) in the SQLCA.
System Action: The excess suboptions are ignored. User Response: Add the INTO clause to the SELECT
User Response: Remove excess suboptions. statement, and precompile the application program
again.
DSNH026I W csectname OPTION: INVALID
MARGINS FOR HOST LANGUAGE
Explanation: The host language does not permit the
specified margins.
220 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNH030I • DSNH041I
DSNH030I W csectname LINE nnnn COL cc DSNH033I W csectname LINE nnnn COL cc
STATEMENT CONTAINS WRONG STATEMENT CREATES MORE OR
NUMBER OF 'INTO' VARIABLES LESS COLUMNS THAN WERE
DECLARED
Explanation: The number of variables specified in an
INTO clause is not the same as the number of Explanation: The number of columns specified in a
select-list elements (taking into account expansion of CREATE statement is different from the number of
host structures and '*' or 'table.*' select entries columns specified in the DECLARE TABLE statement.
according to the declarations supplied).
Severity: 4 (warning)
Severity: 4 (warning)
System Action: Processing continues.
System Action: Processing continues.
User Response: Ensure that the DECLARE TABLE
User Response: Ensure the included table matches the CREATE TABLE. If the DECLARE TABLE
declarations are correct. If the declarations are correct, statement is incorrect, some warnings might also be
this statement causes an error when the application incorrect or might not be generated when needed. If the
program is bound. If the declarations are incorrect, you CREATE TABLE statement is incorrect, you must
can proceed, but the declarations should be corrected. correct it.
Otherwise, you need to correct the SQL statement and
precompile again.
DSNH034I W csectname LINE nnnn COL cc
STATEMENT INSERTS MORE OR LESS
DSNH031I W csectname LINE nnnn COL cc VALUES THAN THE NUMBER OF
STATEMENT CREATES A COLUMN COLUMNS DECLARED
WITH NAME name1 WHICH DOES NOT
Explanation: The number of values specified in an
MATCH DECLARED NAME name2
INSERT statement is different from the number of
Explanation: The column name specified in a columns specified in the DECLARE TABLE statement
CREATE statement (name1) is not the same as the for the receiving table.
name of the corresponding column in the DECLARE
Severity: 4 (warning)
TABLE statement (name2).
System Action: Processing continues.
Severity: 4 (warning)
User Response: Insert the correct number of values.
System Action: Processing continues.
If the DECLARE TABLE statement is incorrect, this
User Response: Ensure that the DECLARE TABLE warning might also be incorrect. If the INSERT
matches the CREATE TABLE. You can use the statement is incorrect, you must correct it.
cross-reference and source listings to help find the two
statements.
DSNH038I S csectname LINE nnnn COL cc
PROGRAM OR SUBPROGRAM
DSNH032I W csectname LINE nnnn COL cc CONTAINS MORE THAN 32767 SQL
STATEMENT CREATES A COLUMN STATEMENTS
name WHOSE ATTRIBUTES DO NOT
Explanation: The number of SQL statements in an
MATCH THE DECLARATION
application program or a FORTRAN subprogram is
Explanation: The column name is specified in a greater than 32767.
CREATE statement with a different data type or length
Severity: 12 (severe error)
than was specified for the corresponding column in the
DECLARE TABLE statement. System Action: The precompiler terminates.
Severity: 4 (warning) User Response: Divide the application program or
subprogram into smaller programs or reduce the SQL
System Action: Processing continues.
statements in each program unit so that the maximum
User Response: Correct the DECLARE TABLE or number of SQL statements is not exceeded.
CREATE TABLE statement. If the DECLARE TABLE
statement is incorrect, some warnings might also be
DSNH041I W csectname OPTION: MISSING HOST
incorrect or might not be generated when needed. If the
OPTION
CREATE TABLE statement is incorrect, you must
correct it. Explanation: The host language was not specified in
the OPTION field.
Severity: 4 (warning)
System Action: HOST(COBOL) is assumed.
Chapter 9. DB2 Messages 221
DSNH042I • DSNH053I
User Response: Specify the host language if it is not
DSNH051I E csectname LINE nnnn COL cc sqltype
COBOL. It is probably best to specify the host language
name PREVIOUSLY DECLARED OR
and remove all warnings.
REFERENCED
Explanation: The variable sqltype is TABLE,
DSNH042I W csectname OPTION: option OPTION
CURSOR, or STATEMENT. The identifier name was
INVALID FOR HOST LANGUAGE
already defined with the given sqltype. The definition
Explanation: The option identified in the message is might have occurred implicitly. For example, name might
not valid. The QUOTE and COMMA options are not have been found in the FROM clause of a SELECT,
permitted with HOST(ASM), HOST(PLI), or HOST(C). causing it to be defined as a table.
The TWOPASS option is not permitted with
Severity: 8 (error)
HOST(COBOL).
System Action: The name is installed in the symbol
Severity: 4 (warning)
table as a duplicate.
System Action: The specified option is ignored.
User Response: Remove duplicate definitions, or
User Response: Remove the invalid option, or correct correct the references. Avoid implicit definitions by
the host specification. inserting (or including) table declarations before they are
referenced. Check the number of passes used. Use the
cross-reference and source listings to help resolve this
DSNH049I W csectname RETURN CODE IS type of error.
FORCED TO 4 BECAUSE OPTION
SQL(ALL) IS IN EFFECT, ORIGINAL
RETURN CODE WAS nnn DSNH052I E csectname LINE nnnn COL cc
COLUMN name IS ALREADY DEFINED
Explanation: One or more SQL-related error IN TABLE table-name
messages were detected by the precompiler, but
because of option SQL(ALL), the return code is forced Explanation: The identified name is already defined
to 4 in order to let the application proceed with as a column in the table named table-name. The
compilation. definition might have occurred implicitly. For example,
table-name might have been found in a select-list,
The SQL syntax checking is deferred until bind time causing name to be defined as a column within
because the source might contain non-DB2 SQL syntax table-name if table-name was not declared as a host
that the DB2 precompiler does not recognize and flags variable.
as an error. The DBRM produced by this precompilation
cannot be bound successfully by DB2 if there are SQL Severity: 8 (error)
syntax errors or non-DB2 SQL syntax.
System Action: The name is installed in the symbol
The return code remains untouched if there are table as a duplicate.
host-related syntax or semantic errors in the source.
User Response: Remove duplicate definitions, or
Severity: 4 (warning) correct the references. Avoid implicit definitions by
inserting (or including) table declarations before they are
System Action: Processing continues. referenced.
User Response: Ensure that the intention of this
precompilation is for executing it in a non-DB2 system. DSNH053I W csectname NO SQL STATEMENTS
WERE FOUND
DSNH050I I csectname WARNINGS HAVE BEEN Explanation: No SQL statements were found in the
SUPPRESSED DUE TO LACK OF precompiler input file. An empty DBRM member was
TABLE DECLARATIONS written.
Explanation: One or more warning messages were Severity: 4 (warning)
suppressed because no table declarations were found
before the first SQL statement that referenced a table or System Action: Processing continues.
column.
User Response: If you embedded SQL statements in
Severity: 0 your application program and none were found, make
sure your column margins are properly defined for your
System Action: Processing continues. Suppression is application program.
discontinued if a table declaration is found.
User Response: Insert (or INCLUDE) table
declarations before they are referenced in order to
permit table and column checking.
222 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNH060I • DSNH084I
DSNH060I E csectname LINE nnnn COL cc DSNH082I I csectname LINE nnnn COL cc
INVALID type SPECIFICATION: spec STATEMENT DOES NOT CONFORM TO
IBM SQL SYNTAX OR SEMANTIC
Explanation: The type is either SCALE or LENGTH.
STANDARD - REASON CODE ccc
The spec is the given SCALE or LENGTH specification
in an SQL declaration. Length and scale specifications Explanation: When the precompiler option SQL(ALL)
must be unsigned integers. The scale specification, is in effect, statements that do not conform to certain
where permitted, cannot exceed the length. The length IBM SQL rules are flagged.
specification cannot be 0.
Severity: 0 (informational)
Severity: 8 (error)
System Action: Processing continues.
System Action: Processing continues.
User Response: Change the syntax of the statement
User Response: Correct the length or scaling. to conform to the IBM SQL standard if portability is
required. Not changing the syntax means that the
program is less portable within the IBM SQL
DSNH080I E csectname LINE nnnn COL cc usage
environment.
VARIABLE name IS NOT type TYPE
Explanation: The usage is INDICATOR or STRING.
DSNH083I I csectname LINE nnnn COL cc IBM SQL
The type is SMALLINT, VARCHAR, or CHARACTER.
RESERVED WORD ibmkeywd
The data type of the variable name is not acceptable.
SPECIFIED AS AN IDENTIFIER NAME
All indicator variables must be small integers.
PREPARE and EXECUTE strings must be variable Explanation: When the precompiler option SQL(ALL)
character strings, except for FORTRAN, which requires is in effect, IBM SQL reserved words should not be
character type. used as identifier names. Using IBM SQL reserved
words limits the portability of the statement.
Severity: 8 (error)
Severity: 0 (informational)
System Action: If the containing SQL statement is a
declaration, it is discarded. If the containing SQL System Action: Processing continues.
statement is executable, it is replaced by host language
User Response: If possible, change the identifier
statements that will, if executed, set an error code in the
name to a non-IBM SQL reserved word so that the
SQLCA.
statement conforms to the IBM SQL standard. Not
User Response: Specify a host variable of the proper changing the identifier name means that the program is
type. less portable within the IBM SQL environment.
DSNH081I W csectname LINE nnnn COL cc DSNH084I W csectname LINE nnnn COL cc
STATEMENT DOES NOT CONFORM TO UNACCEPTABLE SQL STATEMENT
ANS SYNTAX STANDARD - REASON
Explanation: The referenced SQL statement is not
CODE ccc
allowed in this situation, but it will not cause an error.
Explanation: When the precompiler option Depending on the option specified at precompile time,
STDSQL(YES) is in effect, the SQL syntax is checked one of the following occurred.
to see if it conforms to the ANSI/ISO SQL standard of v The BEGIN DECLARE SECTION(*), END DECLARE
1992. Reason codes are: SECTION(*), and UPDATE STATISTICS statements
000 Column function with DISTINCT as an are flagged as not compatible.
arithmetic-operation operand does not conform * For C applications, BEGIN and END DECLARE
to the ANSI/ISO SQL standard of 1992. SECTION are not flagged.
001 FOR UPDATE OF as part of a DECLARE * For other languages, the statement is only allowed
CURSOR statement does not conform to the with precompiler option STDSQL(YES).
ANSI/ISO SQL standard of 1992. v Using the STDSQL(YES) precompiler option, the
INCLUDE SQLCA statement is flagged as a warning.
Severity: 4 (warning)
Severity: 4 (warning)
System Action: Processing continues.
System Action: The BEGIN DECLARE SECTION,
User Response: You have the option of changing or
END DECLARE SECTION, and INCLUDE SQLCA
not changing the syntax to conform to the ANS syntax
statements are ignored. The other statements are
standard.
replaced by host language statements that will, if
System Programmer Response: Check the SQL executed, set a warning code or SQLCODE -84 in the
statement. SQLCA.
Chapter 9. DB2 Messages 223
DSNH085I • DSNH104I
User Response: Unless this application program is User Response: Break the statement into shorter or
used in a portable manner, remove the statement. less complex SQL statements.
DSNH085I W csectname LINE nnnn COL cc DSNH102I E csectname LINE nnnn COL cc
UNACCEPTABLE SQL KEYWORD LITERAL STRING IS TOO LONG.
IGNORED: keyword STRING BEGINS string
Explanation: The SQL keyword is not allowed by Explanation: The referenced character string literal
DB2, but it does not cause an error. This message is (beginning with string in the message) is too long. Up to
printed as a warning to the programmer. 255 characters or 124 graphic characters are permitted.
Severity: 4 (warning) Two consecutive string delimiters are used to represent
one string delimiter within the character string, but these
System Action: The keyword and its parameters are
count as 2 bytes when calculating the lengths of
ignored.
character string constants. For SET CURRENT
User Response: Unless this application program is PACKAGESET, up to 18 characters are allowed; for
used with both SQL/DS and DB2, remove the keyword. SET CURRENT SQLID, up to 8 characters are allowed;
for SET CURRENT DEGREE, up to 3 characters are
allowed; for SET CURRENT OPTIMIZATION HINT, only
DSNH088I W csectname LINE nnnn COL cc THIS one character is allowed; for SET CURRENT LOCALE,
STATEMENT WILL action AN ENTIRE up to 50 characters are allowed.
TABLE
Severity: 8 (error)
Explanation: The action is either DELETE or
UPDATE. The referenced SQL statement has no System Action: If the SQL statement containing the
WHERE clause and will delete or update all rows of the string is a declaration, it is discarded. If the SQL
specified table. This message is printed as a warning to statement containing the string is executable, it is
the programmer. replaced by host language statements that, if executed,
set an error code in the SQLCA.
Severity: 4 (warning)
User Response: Correct the string. If a shorter string
System Action: Processing continues. is acceptable, reduce the length of the literal. If a long
User Response: Be sure that you intend to delete or string is required, a host variable is required.
update all rows, or add a suitable WHERE clause.
DSNH103I E csectname LINE nnnn COL cc
DSNH090I S csectname LINE nnnn COL cc HOST INVALID NUMERIC LITERAL token
VARIABLE NOT PERMITTED HERE: Explanation: The token was found. It begins with a
name digit, but it is not a valid integer, decimal, or float literal.
Explanation: Host variable references are not Identifiers cannot begin with a digit except for the
permitted in this type of SQL statement. The name is WHENEVER statement with HOST(FORTRAN), and the
invalid. identifiers in COBOL.
Severity: 12 (severe error) Severity: 8 (error)
System Action: The statement is replaced by host System Action: If the containing SQL statement is a
language statements that will, if executed, set an error declaration, it is discarded. If the containing SQL
code in the SQLCA. statement is executable, it is replaced by host language
statements that will, if executed, set an error code in the
User Response: Specify a literal or a column name SQLCA.
rather than a host variable. The colon (:) indicates that
the name that follows is a host variable. Remove it to User Response: Check the indicated token for validity.
specify a column name. Use apostrophes or quotation marks if a character literal
is desired. Remove the invalid characters if a number is
desired.
DSNH101I S csectname THE STATEMENT IS TOO
LONG OR TOO COMPLEX.
DSNH104I E csectname LINE nnnn COL cc
Explanation: The statement cannot be executed ILLEGAL SYMBOL ″token″. SOME
because it exceeds the system limits for either length or SYMBOLS THAT MIGHT BE LEGAL
complexity. ARE: token-list
Severity: 16 Explanation: A syntax error was detected where the
System Action: The statement cannot be executed. symbol ″token″ occurs in the SQL statement. The list of
symbols that might be legal shows some alternate
224 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNH105I • DSNH109I
symbols that could possibly be correct at that point, if v INCLUDE member names
the preceding part of the statement is entirely correct. v Storage group names
v Buffer pool names
However, the preceding part of the statement might be
v Field procedure names
incorrect. For example, if an important keyword is
v Database names
omitted, DB2 detects the error later, and not always
v Table space names
immediately after the point where the keyword should
v Application plans
appear. The list of alternate symbols are only
v Database request modules (DBRMs)
suggestions.
v Referential constraint names specified in CREATE or
Severity: 8 (error) ALTER TABLE statements.
v Package-id
System Action: If the containing SQL statement is a
declaration, it is discarded. If the containing SQL
Host variable names cannot contain more than 64
statement is executable, it is replaced by host language
characters.
statements that will, if executed, set an error code in the
SQLCA.
Volume serial numbers cannot contain more than 6
User Response: Correct the statement and characters.
precompile the program again.
Severity: 8 (error)
System Action: If the SQL statement containing the
DSNH105I E csectname LINE nnnn COL cc,
problem is a declaration, it is discarded. If the SQL
INVALID STRING CONSTANTS
statement containing the problem is executable, it is
Explanation: Incorrect graphic or mixed data literals replaced by host language statements that will, if
were found on line nnnn, column cc. executed, set an error code in the SQLCA.
Severity: 8 (error) User Response: Correct the name length.
System Action: The literal is ignored and the SQL
statement containing the problem is discarded. DSNH109I E csectname LINE nnnn COL cc type
CLAUSE NOT PERMITTED
User Response: Specify the correct format of literals.
Explanation: The type is INTO, ORDER BY, FOR
System Programmer Response: Check for a quote,
UPDATE, , USING, LARGE, or CORRELATION NAME.
an apostrophe, shift-out (so) or shift-in (si) characters, G
or N characters, or the number of characters within the v Embedded SELECT statements cannot include
literal. ORDER BY, because the result cannot be more than
a single row.
v Embedded SELECT statements cannot include FOR
DSNH107I E csectname LINE nnnn COL cc NAME
UPDATE OF, because position is not retained.
name IS TOO LONG; MAXIMUM IS size
CHARACTERS v SELECT clauses used in cursor declarations or
subselects cannot have an INTO clause because the
Explanation: Names for the following cannot contain INTO is on the FETCH statement.
more than 64 characters:
v CREATE VIEW statements cannot include any of the
v Version-id above clauses.
v The UNION operator is not allowed in an embedded
Names for the following cannot contain more than 18 SELECT.
characters (20 including SQL escape characters, if
present): v A CREATE TABLESPACE statement cannot specify
v SQL columns LOCKPART without the NUMPARTS option.
v SQL tables v An ALTER TABLESPACE statement cannot specify
v SQL views LOCKPART for a non-partitioned table space.
v SQL indexes v A table space with LOCKPART YES cannot be
v SQL synonyms altered to LOCKSIZE TABLESPACE.
v Collection-ids
v A table space with LOCKSIZE TABLESPACE cannot
v Check constraints
be altered to LOCKPART YES.
Names for the following cannot contain more than 16 v The LARGE clause without the NUMPARTS option is
characters: not allowed in a CREATE TABLESPACE statement.
v Location-name v DESCRIBE INPUT statement can not have USING
clause.
The following cannot contain more than 8 characters: v The table being updated in a POSITIONED UPDATE
v Authorization IDs statement can not be assigned a correlation name.
Chapter 9. DB2 Messages 225
DSNH110I • DSNH117I
Severity: 8 (error) 000 An invalid character was found in the SBCS
identifier (including the case in which a DBCS
System Action: If the containing SQL statement is a
identifier was used where only an SBCS
declaration, it is discarded. If the containing SQL
identifier is allowed.)
statement is executable, it is replaced by host language
statements that will, if executed, set an error code in the
The following reason codes apply to DBCS identifiers or
SQLCA.
comments:
User Response: Remove the clause. You might need
101 An odd number of bytes exists between the
to use a cursor to perform the processing. The ORDER
shift-out and the shift-in character.
and FOR UPDATE clauses are accepted on the
DECLARE CURSOR statement. The INTO clause is 102 Either a shift-in or shift-out character is
accepted on the FETCH statement. The LARGE clause missing.
is accepted on a CREATE TABLESPACE statement with
the NUMPARTS option. 103 DBCS blanks X’4040’ are not allowed.
104 There are no characters between the shift-out
DSNH110I E csectname LINE nnnn COL cc and the shift-in characters.
INVALID HEX LITERAL BEGINNING 105 Shift-out cannot be the first byte of the DBCS
string character between the shift-out and the shift-in
Explanation: The referenced hexadecimal literal characters.
contains one or more characters that are not valid Severity: 8 (error)
hexadecimal numbers.
System Action: Processing is terminated.
Severity: 8 (error)
User Response: Correct the name.
System Action: If the containing SQL statement is a
declaration, it is discarded. If the containing SQL
statement is executable, it is replaced by host language DSNH115I E csectname LINE nnnn COL cc
statements that will, if executed, set an error code in the ILLEGAL USE OF COMPARISON
SQLCA. OPERATOR operator
User Response: Correct the literal. Explanation: The syntax is not correct for this type of
comparison. A simple comparison such as '>' must not
be followed by a list of items. The ANY and ALL
DSNH111W W csectname LINE nnnn COL cc THE comparisons must precede a subselect, rather than an
SUBPAGES OPTION IS NOT expression or a list of items.
SUPPORTED FOR TYPE 2 INDEXES
Severity: 8 (error)
Explanation: You cannot use the SUBPAGES option
for type 2 indexes. System Action: If the containing SQL statement is a
declaration, it is discarded. If the containing SQL
Severity: 4 (warning) statement is executable, it is replaced by host language
System Action: The option is ignored; processing statements that will, if executed, set an error code in the
continues. SQLCA.
Programmer Response: Remove the SUBPAGES User Response: Correct the syntax. If necessary,
option to get rid of the warning. refer to Chapter 2 of DB2 SQL Reference for the correct
syntax.
DSNH113I E csectname LINE nnnn COL cc
INVALID CHARACTER FOUND IN string, DSNH117I E csectname LINE nnnn COL cc
REASON CODE - nnn STATEMENT INSERTS THE WRONG
NUMBER OF VALUES
Explanation: The string contains an invalid character.
It can be an SQL ordinary identifier name, a host Explanation: The number of entries in a value-list is
variable name, or a DBCS comment. not the same as the number of columns specified in an
INSERT statement.
For SBCS SQL ordinary identifiers, names of buffer
pools, databases, plans and storage groups must Severity: 8 (error)
contain only uppercase alphabetic or national System Action: Processing continues.
characters and numerics when CHARSET is
KATAKANA; the first character must be alphabetic or User Response: Correct the syntax. If necessary,
national. refer to Chapter 5 of DB2 SQL Reference for the correct
syntax.
The following reason codes apply to SBCS identifiers:
226 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNH120I • DSNH132I
Severity: 8 (error)
DSNH120I E csectname LINE nnnn COL cc
FUNCTION USAGE NOT PERMITTED: System Action: If the containing SQL statement is a
fname declaration, it is discarded. If the containing SQL
statement is executable, it is replaced by host language
Explanation: A WHERE clause or SET clause
statements that will, if executed, set an error code in the
contains a column function, possibly as a result of a
SQLCA.
reference to a column that is derived from a column
function in a view definition. A column function is User Response: Reduce the number of table
allowed in a WHERE clause only if that clause appears references in each subselect. Each reference to a single
within a subquery of a HAVING clause. table counts separately. The count only applies to
table/view references in the FROM list. Each view is
Severity: 8 (error)
only counted one time. Refer to Chapter 4 of DB2 SQL
System Action: If the containing SQL statement is a Reference for the definition of a subselect.
declaration, it is discarded. If the containing SQL
statement is executable, it is replaced by host language
DSNH130I E csectname LINE nnnn COL cc THE
statements that will, if executed, set an error code in the
ESCAPE CLAUSE 'x' CONSISTS OF
SQLCA.
MORE THAN ONE CHARACTER
User Response: Correct the syntax. A subselect
Explanation: The literal x used in the ESCAPE clause
clause might be needed to produce the function result.
is too long. Only one SBCS or one DBCS character is
If necessary, refer to Chapter 4 of DB2 SQL Reference
allowed.
for the correct syntax.
Severity: 8 (error)
DSNH125I E csectname LINE nnnn COL cc System Action: The corresponding SQL statement is
INVALID ORDER BY COLUMN replaced by host language statements that will, if
NUMBER: number executed, set an error code in the SQLCA.
Explanation: The identified column number is either User Response: Correct the string. The literal string
less than 1 or greater than the number of items in the for the ESCAPE clause can only be one SBCS or
select-list. DBCS character.
Severity: 8 (error)
DSNH131I E csectname LINE nnnn STATEMENT
System Action: The cursor declaration is discarded.
WITH LIKE PREDICATE HAS
User Response: Correct the column number. If INCOMPATIBLE DATA TYPES
necessary, refer to Chapter 4 of DB2 SQL Reference for
Explanation: If the column name at the left of LIKE or
the correct syntax.
NOT LIKE is a character type, the expression at the
right must be a character type. If the column name is a
DSNH126I E csectname LINE nnnn COL cc ORDER graphic type, the expression at the right must be a
BY CANNOT BE USED WITH A FOR graphic type.
UPDATE OF CLAUSE
Severity: 8 (error)
Explanation: The ORDER BY clause makes the
System Action: The statement is ignored.
cursor incapable of being updated.
User Response: Check the data type of every
Severity: 8 (error)
operand.
System Action: The cursor declaration is discarded.
User Response: This is a DB2 restriction. You can DSNH132I E csectname LINE nnnn COL cc
have either an ordered cursor or a cursor that can be INVALID LIKE PREDICATE
updated. You cannot specify both attributes for the
Explanation: The value following LIKE must be an
same cursor. You might need to change your application
alphanumeric host variable or literal, graphic host
logic.
variable or literal, or special character literal.
Severity: 8 (error)
DSNH129I E csectname LINE nnnn COL cc TOO
MANY TABLES SPECIFIED IN SQL System Action: If the containing SQL statement is a
STATEMENT declaration, it is discarded. If the containing SQL
statement is executable, it is replaced by host language
Explanation: In a subselect, (including all subqueries),
statements that will, if executed, set an error code in the
there can be no more than 225 references to table
SQLCA.
names.
User Response: Correct the syntax. If necessary,
Chapter 9. DB2 Messages 227
DSNH142I • DSNH199I
refer to Chapter 2 of DB2 SQL Reference for the correct
DSNH182I E csectname LINE nnnn COL cc AN
syntax.
ARITHMETIC EXPRESSION WITH A
DATETIME VALUE IS INVALID
DSNH142I E csectname LINE nnnn COL cc THE
Explanation: The specified arithmetic expression
SQL STATEMENT IS NOT SUPPORTED
contains an improperly used date/time value or labeled
Explanation: The token was found. An SQL statement duration.
was detected that is not supported by the database.
Severity: 8 (error)
The statement might be valid for other IBM relational
database products or it might be valid in another System Action: If the containing SQL statement is a
context. For example, statements such as VALUES and declaration, it is discarded. If the containing SQL
SIGNAL SQLSTATE can appear only inside a trigger. statement is executable, it is replaced by host language
statements that will, if executed, set an error code in the
Severity: 8 (error)
SQLCA.
System Action: The SQL statement is replaced by
User Response: Correct the indicated expression.
host language statements that will, if executed, set an
Refer to Chapter 2 of DB2 SQL Reference for the rules
error code in the SQLCA.
for date/time arithmetic.
User Response: Change the syntax of the SQL
statement or remove the statement from the program.
DSNH184I E csectname LINE nnnn COL cc AN
ARITHMETIC EXPRESSION WITH A
DSNH170I E csectname LINE nnnn COL cc DATETIME VALUE CONTAINS A
NUMBER OF ARGUMENTS SPECIFIED PARAMETER MARKER
FOR function-name IS INVALID
Explanation: The specified expression contains a
Explanation: An SQL statement specified the scalar parameter marker improperly used with a date/time
function function-name with either too many or too few value.
arguments.
Severity: 8 (error)
Severity: 8 (error)
System Action: If the containing SQL statement is a
System Action: If the containing SQL statement is a declaration, it is discarded. If the containing SQL
declaration, it is discarded. If the containing SQL statement is executable, it is replaced by host language
statement is executable, it is replaced by host language statements that will, if executed, set an error code in the
statements that will, if executed, set an error code in the SQLCA.
SQLCA.
User Response: Correct the indicated expression.
User Response: Correct the function call. Refer to Refer to Chapter 2 of DB2 SQL Reference for
Chapter 3 of DB2 SQL Reference for information about information about date/time arithmetic.
the number of arguments required by the scalar function
function-name.
DSNH198I E csectname LINE nnnn COL cc EMPTY
SQL STATEMENT IGNORED
DSNH171I E csectname LINE nnnn COL cc THE
Explanation: The referenced SQL statement has no
DATA TYPE, LENGTH, OR VALUE OF
text between the EXEC SQL and the statement
ARGUMENT nn OF function-name IS
terminator.
INVALID
Severity: 8 (error)
Explanation: Either the data type, the length or the
value of argument nn of scalar function function-name is System Action: The statement is ignored.
incorrect.
User Response: Correct the statement, or remove it.
Severity: 8 (error)
System Action: If the containing SQL statement is a DSNH199I E csectname LINE nnnn COL cc
declaration, it is discarded. If the containing SQL INVALID KEYWORD keyword; VALID
statement is executable, it is replaced by host language SYMBOLS ARE: token list
statements that will, if executed, set an error code in the
Explanation: A syntax error was detected at the
SQLCA.
keyword specified in the message. As an aid to the
User Response: Correct the argument. Refer to programmer, a partial list of valid tokens is provided in
Chapter 3 of DB2 SQL Reference for rules for each the message. Only those tokens that fit are listed. The
argument of the scalar function function-name. error might be earlier in the statement, but the syntax of
the statement appears to be valid up to this point.
228 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNH203I • DSNH290I
Severity: 8 (error)
DSNH206I W csectname LINE nnnn COL cc
System Action: If the containing SQL statement is a STATEMENT REFERENCES COLUMN
declaration, it is discarded. If the containing SQL column name WHICH IS NOT
statement is executable, it is replaced by host language DECLARED IN THE SPECIFIED
statements that will, if executed, set an error code in the TABLE(S)
SQLCA.
Explanation: The column column name is not
User Response: Check the SQL statement in the area contained in any TABLE declaration for the tables
of the indicated keyword. A colon or SQL delimiters specified in the statement.
might be missing. Correct the SQL statement.
Severity: 4 (warning)
System Action: Processing continues.
DSNH203I W csectname LINE nnnn COL cc
STATEMENT REFERENCES COLUMN User Response: If the table declares are correct and
column name, WHICH IS DECLARED IN the column name is not in the tables, this creates an
MORE THAN ONE OF THE SPECIFIED error in the BIND step. Correct the DECLARE TABLE
TABLES statements or the column name.
Explanation: The column column name was System Programmer Response: Check the spelling
referenced without sufficient qualification. Type checking of the column name. Ensure that all the tables needed
cannot be done. were specified in the statement.
Severity: 4 (warning)
DSNH207I E csectname LINE nnnn COL cc
System Action: Processing continues.
ILLEGAL ORDER BY SPECIFICATION
User Response: If the table declares are correct and
Explanation: If the select expression involves a
the column name is not unique, this creates an error in
UNION operator, the ORDER BY list must use numeric
the BIND step. Correct the DECLARE TABLE
constants rather than variables.
statement, or use the correct table name to qualify the
column name. Severity: 8 (error)
System Action: If the containing SQL statement is a
DSNH204I W csectname LINE nnnn COL cc declaration, it is discarded. If the containing SQL
STATEMENT REFERENCES statement is executable, it is replaced by host language
UNDECLARED TABLE table-name statements that will, if executed, set an error code in the
SQLCA.
Explanation: The table definition was not provided. It
is optional, but checking cannot be done without the User Response: Correct the syntax. If necessary,
table information. (BIND checks against the actual table refer to Chapter 4 of DB2 SQL Reference for the correct
during later processing.) syntax.
Severity: 4 (warning)
DSNH251I E csectname LINE nnnn COL cc TOKEN
System Action: Processing continues.
name IS NOT VALID
Explanation: The location name cannot contain
DSNH205I W csectname LINE nnnn COL cc
alphabetic extenders for national languages (that is, #,
COLUMN column-name WAS NOT
@, and $ in the United States).
DECLARED IN TABLE table-name
Severity: 8 (error)
Explanation: The column name column-name is not
contained in the table declarations. The name specified System Action: Processing continues.
in a DISTINCT function must reference a column of the
User Response: Correct the content of the location
table. The value expression of an ALL function must
name.
reference a column of the table.
Severity: 4 (warning)
DSNH290I E csectname LINE nnnn COL cc NO
System Action: Processing continues. VALID 'END DECLARE SECTION'
FOUND
User Response: If the table declares are correct and
the column name is not in the table, this creates an Explanation: The user’s source program contains a
error in the BIND step. Correct the DECLARE TABLE BEGIN DECLARE SECTION, but no corresponding
statement or the column name. END DECLARE SECTION was found.
Severity: 8 (error)
Chapter 9. DB2 Messages 229
DSNH291I • DSNH312I
System Action: Processing continues.
| DSNH307I E csectname HOST VARIABLE
User Response: Check the application program and | ALREADY DECLARED
ensure that a valid END DECLARE SECTION statement
| Explanation: The host variable being registered with
is present.
| SQLGALHV has already been registered.
| Severity: 8 (error)
DSNH291I E csectname LINE nnnn COL cc NO
VALID 'BEGIN DECLARE SECTION' | System Action: The host variable is ignored.
FOUND
| User Response: Continue the compilation or
Explanation: The user’s source program contains an | precompilation process.
END DECLARE SECTION, but no corresponding
BEGIN DECLARE SECTION was found.
| DSNH308I U csectname MAXIMUM NUMBER OF
Severity: 8 (error) | HOST VARIABLES EXCEEDED
System Action: Processing continues. | Explanation: The registration of host variables
| exceeded the internal symbol table storage capacity.
User Response: Check the application program and
ensure that a valid BEGIN DECLARE SECTION is | Severity: 16 (unrecoverable error)
present.
| System Action: Further processing halts.
DSNH292I E csectname LINE nnnn COL cc HOST
| User Response: Terminate compilation or
NAME name IS TOO LONG; MAXIMUM
| precompilation.
IS size CHARACTERS
DSNH310I W csectname LINE nnnn COL cc
Explanation: Fully qualified C host variable names
language HOST VARIABLE name WAS
cannot contain more than 256 characters.
DECLARED IN location
Severity: 8 (error)
Explanation: Host variable name should not be
System Action: If the containing SQL statement is declared in this location of the source program. This
executable, it is replaced by host language statements message is issued only at reference time.
that will, if executed, set an error code in the SQLCA.
Severity: 4 (warning)
User Response: Reduce the length of names or the
System Action: Processing continues.
level of qualification of the host variable name in error.
User Response: If this host variable is used, the user
assumes responsibility for possible exposure of
DSNH303I W csectname LINE nnnn COL cc
incorrect output. Refer to Part 2 of DB2 Application
STATEMENT SELECTS INCOMPATIBLE
Programming and SQL Guide to determine where host
DATA TYPE INTO hostvar
variables can be validly declared.
Explanation: The data type of host variable hostvar is
Declaring a COBOL host variable in the File Section
not compatible with the apparent type of the
might lead to incorrect output from SQL statements or
corresponding select expression. One of them is
abend 04E with RC=00E7000C.
numeric and the other is character, or one of them is
character and the other is graphic. If the select
expression is a column reference, the data type is DSNH312I E csectname LINE nnnn COL cc
obtained from its declaration. UNDEFINED OR UNUSABLE HOST
VARIABLE name
Severity: 4 (warning)
Explanation: The name in the message is used in an
System Action: Processing continues.
SQL statement, but either no declaration was found in
User Response: Ensure that the table definitions are the application program so far, or the attributes are
current and that the host variable has the proper data improper for this use. Declarations for host variables
type. used in a DECLARE CURSOR statement must precede
the SQL statement, regardless of the ONEPASS or
System Programmer Response: Ensure that the
TWOPASS option for the precompiler, or a parameter
table definitions are current, and that the host variable
marker was expected in an EXECUTE IMMEDIATE
has the proper data type.
statement. This message is issued only at reference
time.
Severity: 8 (error)
System Action: If the containing SQL statement is a
230 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNH313I • DSNH350I
declaration, it is discarded. If the containing SQL User Response: Check the declaration and the
statement is executable, it is replaced by host language attributes of the named host variable. Refer to Part 2 of
statements that will, if executed, set an error code in the DB2 Application Programming and SQL Guide for the
SQLCA. allowable host variable type and length.
User Response: Check the declaration and the
attributes of the named host variable. If you intended DSNH314I E csectname LINE nnnn COL cc
the name to refer to a column, the colon (:) should not REFERENCE TO HOST VARIABLE
be present. If you intended a literal, you need to name IS AMBIGUOUS
enclose the value in string delimiters (apostrophes or
Explanation: The host variable name was defined
quotation marks).
more than once in this application program. The
If you intended to use a host variable, only a subset of precompiler cannot distinguish which host variable
the possible variable declarations are valid for use as a definition should be used here. The following table
DB2 host variable. The rules for host variables are listed indicates some possible combinations. DB2 supports
in the application programming guides. Use the only a single adjacent qualifier for a host variable name.
cross-reference listing and precompiler source listing to
determine the source of the problem. Suggested
Case Ref Definition Result Change
v If you use the STDSQL(YES) option for the
precompilation, make sure that all of the host variable 1 a x.a Valid None
declarations are declared within BEGIN/END 2 x.a x.a, y.a Valid None
DECLARE SECTIONs.
3 a x.a, y.a DSNH314I Reference
v If the cross-reference listing does not contain the host x.a or y.a
variable name, the declaration is missing. If the 4 a x.a, a Valid None
source for a declaration is present, a missing 5 x.a q.x.a, v.x.a DSNH314I Variable
terminator from a comment or from a string might name
cause this type of error. The margins could also changes
cause this type of error. 6 a a, a DSNH314I Variable
v If the name is present, but the data type is not listed, name
the host variable is not usable; it does not follow the changes
rules outlined for valid host variable definitions.
v If several definitions exist for the name, the first Severity: 8 (error)
reference might occur before the definition. The use
of the TWOPASS option helps by processing System Action: If the SQL statement is a declaration,
DECLARE statements before the other types of it is discarded. If the containing SQL statement is
statements. However, host variable declarations and executable, it is replaced by host language statements
cursor declarations are processed in the same pass. that will, if executed, set an error code in the SQLCA.
The host variables referenced in cursor declarations
User Response: Make the host variable name unique
must be defined before the cursor is defined in the
or use qualification to indicate which host variable
application program.
definition is to be used, as suggested in the above
v A parameter marker is expected rather than a host table.
variable in an EXECUTE IMMEDIATE statement.
v The data type of a host variable passed in a CALL
| DSNH350I E csectname LINE nnnn COL cc.
statement is not character or varying character.
| INVALID SPECIFICATION OF A LARGE
v The length attribute of a character or varying | OBJECT COLUMN
character host variable passed in a CALL statement
exceeds 255 characters. | Explanation: The ALTER TABLE, CREATE TABLE, or
| CREATE INDEX statement is invalid for one of the
| following reasons:
DSNH313I E csectname LINE nnnn COL cc
| v A LOB column cannot be added to a temporary table.
INVALID TYPE OR LENGTH OF HOST
VARIABLE 'name' | v A LOB column cannot be added to a table defined
| with an EDITPROC.
Explanation: The host variable name is used in an
| v The PRIMARY KEY clause cannot specify a LOB
SQL statement, but either the type or the length is
| column as a column of the primary key.
improper for this use.
| v The UNIQUE clause cannot specify a LOB column as
Severity: 8 (error) | a column of the unique key.
System Action: The corresponding SQL statement is | v The referential-constraint clause cannot specify a
replaced by host language statements that will, if | LOB column as a column of a foreign key.
executed, set an error code in the SQLCA.
Chapter 9. DB2 Messages 231
DSNH372I • DSNH408I
| v The CREATE INDEX statement cannot name a LOB Severity: 4 (warning)
| column as a column of the index key.
System Action: Processing continues.
| v A LOB column cannot be specified in a references
| clause. User Response: Make both operands compatible
character data types. Ensure that the table declaration
| v A table check constraint cannot be specified in the
is correct.
| definition of a LOB column.
| Severity: 8 (error)
DSNH402I W csectname LINE nnnn COL cc
| System Action: The statement cannot be executed. STATEMENT APPLIES name TO
CHARACTER DATA
| User Response: Correct and reissue the failing
| statement. Explanation: The numeric operation or function name
is used with a non-numeric operand.
DSNH372I E csectname LINE nnnn COL cc. ONLY Severity: 4 (warning)
ONE COLUMN DEFINED AS ROWID IS
System Action: Processing continues.
ALLOWED IN A TABLE
User Response: Make the operand numeric or use a
Explanation: An attempt was made to create a table
character function. Ensure that the table declaration is
with more than one ROWID column or to add a ROWID
correct.
column to a table which already has one.
Severity: 8 (error)
DSNH404I W csectname LINE nnnn COL cc
System Action: The statement cannot be executed. STATEMENT INSERTS OR UPDATES
COLUMN name WITH VALUE THAT IS
User Response: For a CREATE TABLE statement,
TOO LONG
select only one column to have the row ID data type.
For an ALTER TABLE statement, a ROWID column Explanation: An INSERT or UPDATE statement
already exists for the table. Do not attempt to add specifies a value that is longer than the maximum
another column with data type row ID to the table. length string that can be stored in that column,
according to the DECLARE TABLE statement.
| DSNH385I W csectname LINE nnnn COL cc Severity: 4 (warning)
| ASSIGNMENT TO AN SQLSTATE OR
System Action: Processing continues.
| SQLCODE VARIABLE IN AN SQL
| PROCEDURE MAY BE OVER-WRITTEN User Response: Ensure that the length is allowed and
| AND DOES NOT ACTIVATE ANY that the table declaration is correct.
| HANDLER
| Explanation: The SQL procedure includes at least DSNH405I E csectname LINE nnnn COL cc
| one statement that assigns a value to the SQLSTATE or LITERAL number IS OUT OF RANGE
| SQLCODE special variables. Since DB2 assigns values
| to those variables to indicate the results of SQL Explanation: The number is not in the proper range:
| statement execution, DB2 overwrites the values v +5.4E−79 to 7.2E+75 for floating-point
| assigned by the SQL assignment statement. v −(1031 -1) to +(1031 -1) for packed decimal
v −2147483648 to 2147483647 for integers
| An SQL procedure cannot activate a handler by
| assigning a value to SQLSTATE. Severity: 8 (error)
| Severity: 4 (warning) System Action: If the containing SQL statement is a
declaration, it is discarded. If the containing SQL
| System Action: Processing continues. statement is executable, it is replaced by host language
statements that will, if executed, set an error code in the
| User Response: To prevent this warning, do not
SQLCA.
| assign values to the SQLCODE or SQLSTATE special
| variables. User Response: Correct the number.
DSNH401I W csectname LINE nnnn COL cc DSNH408I W csectname LINE nnnn COL cc
STATEMENT SPECIFIES STATEMENT INSERTS OR UPDATES
INCOMPATIBLE OPERANDS FOR COLUMN name WITH INCOMPATIBLE
COMPARISON OPERATOR name DATA TYPE
Explanation: The comparison operation name is used Explanation: The data type of the value to be inserted
with a mixture of incompatible data type operands. into column name by an INSERT or UPDATE statement
is incompatible with the declared data type of the
232 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNH414I • DSNH473I
column. Both must be numeric or both must be | v The external name must be a short identifier with
character. | letters or digits. The first character must be a letter.
| (This is the MVS naming convention for load
Severity: 4 (warning)
| modules). A possible cause for this error is the
System Action: Processing continues. | inclusion of a blank in the name.
Programmer Response: Be sure that the table | v If the external name is omitted, the external name
definitions are current, and that host variables and | defaults to function-name. However, if the function or
literals have the proper data types and are matched. | procedure name is longer than eight characters then
| the EXTERNAL NAME clause must be explicitly
| specified to specify a valid short identifier as the
DSNH414I E csectname LINE nnnn COL cc THE | external name.
NUMERIC OR DATETIME COLUMN
column-name IS SPECIFIED IN A LIKE | If LANGUAGE is COMPJAVA, the length of the
PREDICATE | EXTERNAL NAME parameter value must be less than
Explanation: Column column-name with a numeric | or equal to 254 bytes.
data type was specified in a LIKE predicate. Columns | Severity: 8 (error)
specified in a LIKE predicate must be character or
graphic string columns. | System Action: The corresponding SQL statement is
| replaced by host language statements that will, if
Severity: 8 (error) | executed, set an error code in the SQLCA.
System Action: If the containing SQL statement is a | User Response: Correct the syntax of the SQL
declaration, it is discarded. If the containing SQL | statement. Refer to the DB2 SQL Reference for
statement is executable, it is replaced by host language | information on the EXTERNAL NAME clause.
statements that will, if executed, set an error code in the
SQLCA.
| DSNH457I E csectname LINE nnnn COL cc. A
User Response: Correct the statement. | FUNCTION OR DISTINCT TYPE
| CANNOT BE CALLED name SINCE IT
DSNH434I OPTION keyword IS A DEPRECATED | IS RESERVED FOR SYSTEM USE.
FEATURE | Explanation: The user-defined function or distinct type
Explanation: keyword is a deprecated feature that will | cannot be created or referenced because the name
not be supported in releases following DB2 Version 7. It | selected is reserved for use by the system.
is accepted, but we recommend that you discontinue | A number of names used as keywords are reserved for
the use of this keyword. | system use. These names may not be used as
For indexes, we recommend that you use type 2 | user-defined functions or distinct-type-names, even if
indexes rather than type 1 indexes. | they are delimited identifiers. These names are:
| = < > >= <=
Severity: 4 (warning) | <> ¬= ¬> ¬>
System Action: Processing continues normally. | ALL AND ANY BETWEEN DISTINCT
| EXCEPT EXISTS FALSE FOR FROM
User Response: No change is required for the current | IN IS LIKE MATCH NOT
release. However, we recommend that you change your | NULL ONLY OR OVERLAPS SIMILAR
SQL statement to remove this feature to prepare for | SOME TABLE TRUE TYPE UNIQUE
future releases when this feature is not supported. | UNKNOWN
| Severity: 8 (error)
| DSNH449I W csectname LINE nnnn COL cc | System Action: The statement cannot be executed.
| CREATE FUNCTION OR PROCEDURE
| FOR routine-name CONTAINS AN | User Response: Select a name for the function or
| INVALID FORMAT OF THE EXTERNAL | distinct type that is not reserved for system use.
| NAME CLAUSE OR IS MISSING THE
| EXTERNAL NAME CLAUSE DSNH473I E csectname LINE nnnn COL cc. A
| Explanation: An error was found in the EXTERNAL USER DEFINED DATA TYPE CANNOT
| NAME clause of the CREATE FUNCTION or CREATE BE CALLED THE SAME NAME AS A
| PROCEDURE statement for name, or the clause is SYSTEM PREDEFINED TYPE (BUILT-IN
| needed but was not specified. TYPE).
| If LANGUAGE is not COMPJAVA, the external name Explanation: The name of a data type to be created
| must follow these conventions: has an unqualified name that is the same as a
system-predefined data type or is BOOLEAN. This is
Chapter 9. DB2 Messages 233
DSNH490I • DSNH521I
not allowed. Adding delimiters does not make the name System Action: If the containing SQL statement is a
valid. The following names are restricted: declaration, it is discarded. If the containing SQL
BIGINT BINARY BLOB BOOLEAN CHAR statement is executable, it is replaced by host language
CHARACTER CLOB DATALINK DATE DBCLOB statements that will, if executed, set an error code in the
DEC DECIMAL DOUBLE FLOAT GRAPHIC SQLCA.
INT INTEGER NUMERIC REAL REF
ROWID SMALLINT TIME TIMESTAMP VARCHAR User Response: Correct or add the required cursor
VARGRAPHIC declaration.
Severity: 8 (error)
DSNH506I E csectname LINE nnnn COL cc
System Action: The statement cannot be executed. DECLARE CURSOR FOR STATEMENT
User Response: Correct the statement to use another NAME MUST PRECEDE THE PREPARE
identifier for the name of the new user-defined type. STATEMENT FOR THAT STATEMENT
NAME
| DSNH490I E csectname LINE: MV.NNNN COL cc Explanation: This DECLARE name CURSOR
| NUMBER number DIRECTLY SPECIFIED statement is preceded by a PREPARE name statement.
| IN A SQL STATEMENT IS OUTSIDE In DB2, declarations must precede action statements.
| THE RANGE OF ALLOWABLE VALUES This is not the same as in SQL/DS.
| IN THIS CONTEXT (minval, maxval) Severity: 8 (error)
| Explanation: A number (number) was specified that is System Action: The declaration is noted as being in
| not valid in the context in which it was specified. The error and discarded.
| minimum allowed value in this context is minval. The
| maximum allowed value in this context is maxval. n User Response: Move the DECLARE or PREPARE
| must be within the range specified by minval and statement so that they are in the proper order, or
| maxval (minval =< n =< maxval). specify the TWOPASS option if the host language is
PLI, ASM, or C. The TWOPASS option has the
| Severity: 8 (error) precompiler check for declarations on the first pass and
| System Action: The statement was not executed. avoids this problem.
| User Response: Change the value n to a valid value
| in the statement. DSNH520I E csectname THE OPEN STATEMENT
FOR CURSOR cursor-name IS INVALID
BECAUSE THE CURSOR WAS
DSNH491I E csectname LINE nnnn COL cc. DEFINED BY AN ALLOCATE CURSOR
CREATE STATEMENT FOR STATEMENT
USER-DEFINED FUNCTION
function-name MUST HAVE A RETURNS Explanation: The cursor was not successfully
CLAUSE, AND EITHER THE EXTERNAL declared, so it was assumed to be defined by an
CLAUSE (WITH OTHER REQUIRED ALLOCATE CURSOR statement. A cursor defined by an
KEYWORDS) OR THE SOURCE ALLOCATE CURSOR statement is open after
CLAUSE. successful completion of the statement. Attempting to
OPEN an allocated cursor is an error.
Explanation: A required clause is missing in the
CREATE for function function-name. If EXTERNAL was Severity: 8 (error)
specified, the following must also be specified: System Action: The statement cannot be executed.
v LANGUAGE
v PARAMETER STYLE User Response: Add or fix the declaration of the
cursor. If the cursor is supposed to be defined by an
Severity: 8 (error) ALLOCATE CURSOR statement then remove the
System Action: The statement cannot be executed. OPEN statement.
User Response: Correct and reissue the failing
statement. DSNH521I W csectname THE statement FOR
CURSOR cursor-name IS ASSUMED TO
APPLY TO A DYNAMIC ALLOCATE
DSNH504I E csectname LINE nnnn COL cc CURSOR STATEMENT.
CURSOR name WAS NOT DECLARED
Explanation: A FETCH, CLOSE, or DESCRIBE for an
Explanation: Identifier name is used as a cursor, but undeclared cursor was issued. The cursor is assumed
was not declared. The declaration might have been to be defined using a dynamic ALLOCATE CURSOR
discarded because of errors. statement.
Severity: 8 (error)
234 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNH522I • DSNH585I
Severity: 4 (warning). Reference for valid keywords for the GRANT or
REVOKE statement.
System Action: The cursor is assumed to be
allocated dynamically.
DSNH580I E csectname LINE nnnn COL cc THE
User Response: Ensure that the cursor in the FETCH,
RESULT-EXPRESSIONS OF A CASE
CLOSE, or DESCRIBE statement is dynamically
EXPRESSION CANNOT ALL BE NULL
allocated.
Explanation: There is a CASE expression in the
statement that has all the result-expressions
DSNH522I E csectname DESCRIBE CURSOR
(expressions following the THEN and ELSE keywords)
cursor-name IS INVALID BECAUSE
coded with the keyword NULL.
THE CURSOR WAS DEFINED BY A
DECLARE CURSOR STATEMENT. Severity: 8 (error)
Explanation: DESCRIBE CURSOR is allowed for System Action: The statement was not processed.
cursors defined using the ALLOCATE CURSOR
Programmer Response: Change the CASE
statement.
expression to include at least one result-expression with
Severity: 8 (error). a keyword other than NULL.
System Action: The statement cannot be executed.
| DSNH581I E csectname LINE nnnn COL cc THE
User Response: Remove the DESCRIBE CURSOR
| DATA TYPES OF THE
statement. Issue a DESCRIBE of the statement used to
| RESULT-EXPRESSIONS OF A CASE
define the declared cursor.
| EXPRESSION ARE NOT COMPATIBLE
| Explanation: A CASE expression in the statement has
DSNH557I E csectname LINE nnnn COL cc
| at least one result-expression (expressions following the
INCONSISTENT GRANT/REVOKE
| THEN and ELSE keywords) whose data type does not
KEYWORD keyword; PERMITTED
| match that of one of the other result-expressions.
KEYWORDS ARE keyword list
| Severity: 8 (error)
Explanation: The identified keyword is not permitted.
The keyword list is a list of the keywords that are | System Action: The statement was not processed.
permitted in this context. The combination of privileges
requested on a GRANT or REVOKE statement is not
| Programmer Response: Change the CASE
allowed. The authorities must all be of one type and
| expression so that the data types of all of the
consistent with the form of GRANT or REVOKE.
| result-expressions are compatible.
REVOKE UPDATE(column list) is not allowed; only
REVOKE UPDATE is permitted. DSNH582I E csectname LINE nnnn COL cc THE
SEARCH-CONDITION IN A
Severity: 8 (error)
SEARCHED-WHEN-CLAUSE CANNOT
System Action: The containing SQL statement is BE A QUANTIFIED PREDICATE, IN
replaced by host language statements that will, if PREDICATE, OR AN EXISTS
executed, set an error code in the SQLCA. PREDICATE
User Response: Correct the syntax. If necessary, Explanation: The search-condition in a
refer to Chapter 5 of DB2 SQL Reference for the correct searched-when-clause specifies a quantified predicate,
syntax. an IN predicate or an EXISTS predicate, but is not
allowed.
DSNH558I E csectname LINE nnnn COL ccc Severity: 8 (error)
INVALID CLAUSE OR COMBINATION
System Action: The statement was not processed.
OF CLAUSES ON A GRANT OR
REVOKE Programmer Response: Correct the search-condition.
Explanation: “PUBLIC AT ALL LOCATIONS” is invalid
for non-table privilege GRANT or REVOKE statements. DSNH585I W csectname LINE nnnn COL cc
It is also invalid for table privilege GRANT or REVOKE DUPLICATE schema name SCHEMA
statements that specify the ALTER or INDEX privilege. NAME
Severity: 8 (error) Explanation: The identified schema name was
specified twice in the statement.
System Action: The statement cannot be executed.
Severity: 4 (error)
User Response: Refer to Chapter 5 of DB2 SQL
Chapter 9. DB2 Messages 235
DSNH586I • DSNH628I
System Action: The duplicated schema name is
DSNH612I E csectname LINE nnnn COL cc
ignore.
column-name IS A DUPLICATE
User Response: Remove/correct the duplicate COLUMN NAME
specification.
Explanation: The CREATE INDEX, CREATE TABLE,
CREATE VIEW or ALTER TABLE statement specifies
DSNH586I E csectname LINE nnnn COL cc. THE the same 'column-name' for two (or more) columns of
TOTAL LENGTH OF THE CURRENT the index, table, view, or the UPDATE OF clause of a
PATH SPECIAL REGISTER CANNOT trigger definition specifies the same column name more
EXCEED 254 CHARACTERS. than once. Column names must be unique within an
index, a table, a view, or in the UPDATE OF clause of a
Explanation: The CURRENT PATH special register is trigger definition. A column cannot be specified in more
defined as a VARCHAR(254). The content of the string than one ALTER TABLE clause except if it is specified
includes each schema name delimited with double in an ALTER COLUMN clause and ADD CHECK
quotes and separated from the next schema name by a CONSTRAINT clause.
comma. The total length of the string of all schema
names in the CURRENT PATH cannot exceed 254 Severity: 8 (error)
characters. A SET CURRENT PATH statement causing
System Action: The statement cannot be executed.
this message would exceed this limit.
User Response: Correct the CREATE statement to
Severity: 8 (error)
specify unique names for each of the columns of the
System Action: The statement cannot be executed. index, table, view, or the columns in the UPDATE OF
clause of a trigger definition. Correct the ALTER
User Response: Remove schema names to reduce statement to specify unique names for each of the
the total length to fit the 254 character maximum length. ALTER COLUMN clauses.
If all the schema names are required, it may be
necessary to consolidate some user-defined functions This error can also occur on CREATE TABLE when a
so that fewer schema names are required for the column list of a PRIMARY KEY, FOREIGN KEY, or
CURRENT PATH. UNIQUE clause contains two or more occurrences of
the same column name.
| DSNH590I E csectname LINE nnnn COL cc NAME
| name IS NOT UNIQUE IN ROUTINE DSNH628I E csectname LINE nnnn COL cc
| routine-name MUTUALLY EXCLUSIVE CLAUSES
HAVE BEEN SPECIFIED.
| Explanation: Name name is a parameter, SQL
| variable, condition name, or label in SQL procedure Explanation: Mutually exclusive clauses were
| routine-name. name is not unique. specified in one or more of the following ways:
| System Action: The statement cannot be processed. v A CREATE TABLESPACE statement contains both
the SEGSIZE and NUMPARTS clauses
| Severity: 8 (error) v A CREATE TABLESPACE statement contains both
| User Response: Change the name to make it unique the SEGSIZE and LARGE clauses.
| within the routine. v A CREATE TABLESPACE statement contains both
the SEGSIZE and MEMBER CLUSTER clauses.
DSNH599I W csectname LINE nnnn COL cc. v A CREATE or ALTER TABLESPACE contains both
COMPARISON FUNCTIONS ARE NOT the LOCKPART YES and LOCKSIZE TABLESPACE
CREATED FOR A DISTINCT TYPE v A 'column-definition' contains both NOT NULL and
BASED ON A LONG STRING DATA DEFAULT NULL clauses.
TYPE. v A 'column-definition' contains both FIELDPROC and
Explanation: Comparison functions are not created for DEFAULT clauses.
a distinct type based on a long string data type (BLOB, v A select-statement contains both the update-clause
CLOB, DBCLOB, LONG VARCHAR, LONG and the FOR FETCH ONLY clause.
VARGRAPHIC) since the corresponding function are not v An ALTER TABLE statement contains both a DROP
available for these built-in data types. CONSTRAINT clause and either a DROP FOREIGN
Severity: 4 (warning) KEY clause or a DROP CHECK clause.
v A CREATE or ALTER TABLESPACE contains both
System Action: Processing continues.
the LOCKPART YES and LOCKSIZE TABLESPACE
User Response: No action is required. v A CREATE TRIGGER statement specifies more than
one correlation name for OLD, NEW, OLD_TABLE, or
236 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNH630E • DSNH683I
NEW_TABLE. Each of these correlation specific can System Action: If the containing SQL statement is a
appear no more than once in the CREATE TRIGGER declaration, it is discarded. If the containing SQL
statement. statement is executable, it is replaced by host language
v A CREATE FUNCTION statement contains both a statements that will, if executed, set an error code in the
CAST FROM clause and a SOURCE clause. SQLCA.
v A CREATE FUNCTION statement contains both a User Response: Remove the duplicate specification.
SOURCE clause and a RETURNS TABLE clause.
v A CREATE FUNCTION statement contains both a DSNH644I E csectname INVALID VALUE
SOURCE clause and a clause used to define an SPECIFIED FOR KEYWORD keyword IN
external function (EXTERNAL, LANGUAGE, NO stmt-type STATEMENT
SQL).
Explanation: The value specified for the keyword
v A CREATE or ALTER PROCEDURE statement
parameter in the stmt-type SQL statement is not a
attempts to use the NO WLM ENVIRONMENT and
permitted value.
PROGRAM TYPE SUB options. When NO WLM
ENVIRONMENT is used, then PROGRAM TYPE Severity: 8 (error)
MAIN must also be used.
System Action: If the SQL statement containing the
v A CREATE or ALTER PROCEDURE statement problem is a declaration, it is discarded. If the SQL
attempts to use both NO WLM ENVIRONMENT and statement containing the problem is executable, it is
either USER or DEFINER for EXTERNAL SECURITY. replaced by host language statements that will, if
When NO WLM ENVIRONMENT is used, then executed, set an error code in the SQLCA.
PARAMETER STYLE must be either GENERAL or
SIMPLE CALL WITH NULLS. User Response: Correct the statement. Refer to
| v A CREATE or ALTER PROCEDURE statement Chapter 5 of DB2 SQL Reference for information about
| contains both a LANGUAGE REXX clause, and a the allowable values for the keyword in the stmt-type
| PARAMETER STYLE DB2SQL or PARAMETER statement.
| STYLE JAVA clause.
v An ALTER TABLE statement contains both an ALTER DSNH683I E csectname LINE nnnn COL cc. THE
COLUMN clause and a VALIDPROC clause. SPECIFICATION FOR COLUMN,
v An ALTER TABLE statement contains both an ALTER DISTINCT TYPE, FUNCTION, OR
COLUMN clause and a clause other than the check PROCEDURE data-item CONTAINS
constraint clause. INCOMPATIBLE CLAUSES
Severity: 8 (error) Explanation: There is an error in the data item
specification in a statement. Incompatible specifications
System Action: The statement was not executed. are present such as ″INTEGER and FOR BIT DATA″, or
″INTEGER AS LOCATOR″. The location of the error is
Programmer Response: Change the options
given by data-item as follows:
specified in the statement and reissue the statement.
v For a CREATE or ALTER TABLE statement,
data-item gives the name of the column containing
DSNH630E E csectname LINE nnnn COL cc THE the error. The error could be an invalid specification
WHERE NOT NULL SPECIFICATION IS of FOR BIT DATA, FOR SBCS DATA, FOR MIXED
INVALID FOR TYPE 1 INDEXES DATA, or FIELDPROC for column data-item.
Explanation: Type 1 indexes cannot be created with v For a CREATE FUNCTION or CREATE
the WHERE NOT NULL specification. PROCEDURE statement, data-item is a token that
identifies the area of the problem in the statement.
Severity: 8 (error)
For example, ″PARAMETER 3″, ″RETURNS″, or
System Action: The statement cannot be executed. ″CAST FROM″.
Programmer Response: Either the index must be v For a CREATE DISTINCT TYPE statement, data-item
created as a type 2 index, or the WHERE NOT NULL gives the name of the type being defined
specification must not be used. v Otherwise, data-item is a token that identifies the
area of the problem in a parameter list for a function.
For example, ″PARAMETER 5″.
DSNH637I E csectname LINE nnnn COL cc
DUPLICATE keyword KEYWORD Severity: 8 (error)
Explanation: The identified keyword was specified System Action: The statement cannot be processed.
twice in the statement.
User Response: Correct and reissue the failing
Severity: 8 (error) statement.
Chapter 9. DB2 Messages 237
DSNH684I • DSNH707I
DSNH684I E csectname LINE nnnn COL cc DSNH704I W csectname LINE nnnn COL cc.
LENGTH OF LITERAL LIST BEGINNING THERE IS A NONSTANDARD
string IS TOO LONG EMBEDDED COMMENT
Explanation: The length of the literal list beginning Explanation: A comment embedded within an SQL
with string, excluding insignificant blanks and delimiting statement does not meet the requirements of the
parenthesis, is greater than 255. standard being flagged: The FIPS standard is being
checked and the comment does not begin with at least
Severity: 8 (error)
two consecutive hyphens.
System Action: The SQL statement cannot be
Severity: 4
executed.
User Response: Check and correct the SQL
System Programmer Response: Correct the SQL
statement.
statement. Refer to Chapter 2 of DB2 SQL Reference
for information about writing literal lists.
DSNH705I W csectname LINE nnnn COL cc. AN
SQL SYNTAX DEVIATION OCCURRED.
DSNH700I I csectname THE FIPS STANDARD IS
THE STATEMENT IS NOT COMPLETE
USED FOR FLAGGING
Explanation: The SQL statement terminated before all
Explanation: This message identifies the standard
required elements were found.
used for flagging during execution.
Severity: 4
Severity: 0 (informational)
User Response: Check and correct the SQL
System Action: Processing continues.
statement.
DSNH701I I csectname THE IBM SQL STANDARD
DSNH706I W csectname LINE nnnn COL cc. THE
IS USED FOR FLAGGING
IDENTIFIER token IS GREATER THAN
Explanation: This message identifies the standard 18 CHARACTERS
used for flagging during execution.
Explanation: Authorization identifier, table identifier,
Severity: 0 (informational) column name, correlation name, module name, cursor
name, procedure name, or parameter name has a
System Action: Processing continues. length of more than 18 characters.
Severity: 4
DSNH702I W csectname LINE nnnn COL cc THE
STATEMENT DEVIATES FROM THE User Response: Note the deviation from the
SQL STANDARD AT THE TOKEN applicable standard. Check and correct the SQL
COMMENCING WITH THE TEXT text statement.
Explanation: A syntax deviation from the standard
named in the earlier message (FIPS or IBM SQL) was DSNH707I W csectname LINE nnnn COL cc. THE
found in the SQL statement. COLUMN column HAS AN INVALID
LENGTH, PRECISION, OR SCALE
Severity: 4 ATTRIBUTE
User Response: Check and correct the SQL Explanation: One of the following conditions was not
statement. met:
v The length value should be greater than zero.
DSNH703I W csectname LINE nnnn COL cc. A v The precision value should be greater than zero.
DATA DEFINITION STATEMENT IS NOT v The scale value should not be greater than precision.
WITHIN A CREATE SCHEMA Severity: 4
STATEMENT
User Response: Note the deviation from the
Explanation: The FIPS standard requires all data applicable standard. Check and correct the SQL
definition statements to be contained within a CREATE statement.
SCHEMA statement.
Severity: 4
User Response: Check and correct the SQL
statement.
238 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNH708I • DSNH715I
DSNH708I W csectname LINE nnnn COL cc. THE DSNH712I W csectname LINE nnnn COL cc THE
DATA TYPE OF token SHOULD BE COLUMN column IS NOT UNIQUE AND
EXACT NUMERIC WITH A SCALE OF REQUIRES QUALIFICATION.
ZERO
Explanation: The identified column is duplicated within
Explanation: The data type of INDICATOR the current scope. Qualification must be given to
PARAMETER or INDICATOR VARIABLE should be uniquely identify the required column.
exact numeric with a scale of zero.
Severity: 4
Severity: 4
User Response: Note the deviation from the
User Response: Note the deviation from the applicable standard. Check and correct the SQL
applicable standard. Check and correct the SQL statement.
statement.
DSNH713I W csectname LINE nnnn COL cc. A
DSNH709I W csectname LINE nnnn COL cc. THE VALUE EXPRESSION MAY NOT
SET FUNCTION REFERENCES CONTAIN A SET FUNCTION
COLUMN column SPECIFICATION
Explanation: One of the following conditions was not Explanation: The value expression of an ALL set
met: function might not contain a set function specification.
v A column specification of a DISTINCT set function Severity: 4
cannot reference a column derived from a set
function specification. User Response: Note the deviation from the
applicable standard. Check and correct the SQL
v A column specification of an ALL set function cannot
statement.
reference a column derived from a set function
specification.
DSNH714I W csectname LINE nnnn COL cc. THE
Severity: 4
COLUMN column DOES NOT IDENTIFY
User Response: Note the deviation from the A COLUMN OF A TABLE WITHIN THE
applicable standard. Check and correct the SQL CURRENT SCOPE
statement.
Explanation: One of the following conditions was
found:
DSNH710I W csectname LINE nnnn COL cc. A v The table or correlation name used as a qualifier
VALUE EXPRESSION CONTAINING does not exist.
column CANNOT INCLUDE
v The column name does not exist within the current
OPERATORS
scope or the scope of the qualifier.
Explanation: A value expression cannot include
Severity: 4
operators in an outer reference column specification.
User Response: Note the deviation from the
Severity: 4
applicable standard. Check and correct the SQL
User Response: Note the deviation from the statement.
applicable standard. Check and correct the SQL
statement.
DSNH715I W csectname LINE nnnn COL cc. A SET
FUNCTION THAT CONTAINS THE
DSNH711I W csectname LINE nnnn COL cc. THE OUTER REFERENCED COLUMN column
COLUMN SPECIFICATION IS MISSING IS NOT IN THE SUBQUERY OF A
OR INVALID FOR THE ALL SET HAVING CLAUSE
FUNCTION function
Explanation: A set function specification must be
Explanation: The value expression of an ALL set contained in a subquery of a HAVING clause if it
function specification should include a column contains an outer referenced column specification.
specification.
Severity: 4
Severity: 4
User Response: Note the deviation from the
User Response: Note the deviation from the applicable standard. Check and correct the SQL
applicable standard. Check and correct the SQL statement.
statement.
Chapter 9. DB2 Messages 239
DSNH716I • DSNH722I
DSNH716I W csectname LINE nnnn COL cc THE DSNH719I W csectname LINE nnnn COL cc. THE
RESULT OF A SUM OR AVG FUNCTION OPERAND IN THE LIKE PREDICATE IS
CANNOT BE A CHARACTER STRING NOT A CHARACTER STRING
Explanation: The character string is not valid for the Explanation: One of the following conditions was
result of a SUM or AVG set function specification. found:
Severity: 4 v The data type of the column in a LIKE predicate is
not a character string.
User Response: Note the deviation from the
v The data type of the pattern in a LIKE predicate is
applicable standard. Check and correct the SQL
not a character string.
statement.
Severity: 4
DSNH717I W csectname LINE nnnn COL cc. THE User Response: Note the deviation from the
OPERATOR operator IS INVALID IN applicable standard. Check and correct the SQL
THIS CONTEXT statement.
Explanation: One of the following conditions was not
met: DSNH720I W csectname LINE nnnn COL cc. THE
v A value expression containing a distinct set function ESCAPE CHARACTER MUST BE A
cannot include dyadic operators. ONE-BYTE CHARACTER STRING
v The first character following a monadic operator Explanation: The escape character in a LIKE
cannot be a plus or minus sign. predicate must have the data type of character string
v The value expression should not contain operators if with a length of 1.
primary is a character string. Severity: 4
Severity: 4 User Response: Note the deviation from the
User Response: Note the deviation from the applicable standard. Check and correct the SQL
applicable standard. Check and correct the SQL statement.
statement.
DSNH721I W csectname LINE nnnn COL cc. THE
DSNH718I W csectname LINE nnnn COL cc. THE WHERE CLAUSE, GROUP BY CLAUSE,
exptype EXPRESSION IS COMPARING OR HAVING CLAUSE IS INVALID FOR
INCOMPATIBLE DATA TYPES THE GROUPED VIEW table.
Explanation: The data types of one of the following Explanation: If the table identified in the FROM clause
(identified by exptype) do not match: is a grouped view, then the table expression must not
contain a WHERE clause, GROUP BY clause, or
exptype HAVING clause.
Meaning
Severity: 4
COMPARISON
Comparison operators must match. User Response: Note the deviation from the
applicable standard. Check and correct the SQL
BETWEEN statement.
The three value expressions must match.
IN Value expression, subquery, and all value DSNH722I W csectname LINE nnnn COL cc. name
specifications must match. OCCURS MORE THAN ONCE IN A
QUANTIFIED FROM CLAUSE
Value expression and subquery must match. Explanation: One of the following conditions was
Severity: 4 found:
v The table name occurs more than once in a FROM
User Response: Note the deviation from the clause.
applicable standard. Check and correct the SQL
statement. v The correlation name is identical to a table name or
to another correlation name in a FROM clause.
Severity: 4
User Response: Note the deviation from the
applicable standard. Check and correct the SQL
statement.
240 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNH723I • DSNH730I
DSNH723I W csectname LINE nnnn COL cc. ONLY DSNH727I W csectname LINE nnnn COL cc. THE
ONE TABLE REFERENCE IS ALLOWED COLUMN column IS DUPLICATED
IN THE FROM CLAUSE FOR A WITHIN THE CURRENT SCOPE
GROUPED VIEW
Explanation: The specified column is duplicated within
Explanation: If the table identified by table name is a the current scope.
grouped view, then the FROM clause must contain
Severity: 4
exactly one table reference.
User Response: Note the deviation from the
Severity: 4
applicable standard. Check and correct the SQL
User Response: Note the deviation from the statement.
applicable standard. Check and correct the SQL
statement.
DSNH728I W csectname LINE nnnn COL cc. THE
COLUMN SPECIFICATION FOR table
DSNH724I W csectname LINE nnnn COL cc. A SHOULD BE A GROUPING COLUMN
REFERENCE TO THE COLUMN column OR SHOULD BE SPECIFIED WITHIN A
WHICH IS DERIVED FROM A SET SET FUNCTION
FUNCTION IS INVALID IN A WHERE
Explanation: Each column specification contained in a
CLAUSE
subquery in the search condition of a HAVING clause
Explanation: A value expression directly contained in must reference a grouping column or be specified within
the search condition of a WHERE clause must not a set function specification.
include a reference to a column derived from a set
Severity: 4
function specification.
User Response: Note the deviation from the
Severity: 4
applicable standard. Check and correct the SQL
User Response: Note the deviation from the statement.
applicable standard. Check and correct the SQL
statement.
DSNH729I W csectname LINE nnnn COL cc. THE
DEGREE OF TABLE table SHOULD BE
DSNH725I W csectname LINE nnnn COL cc. A 1 WHEN USING A RESULT
WHERE CLAUSE MUST BE SPECIFICATION OF *
CONTAINED IN A HAVING CLAUSE
Explanation: The degree of the table expression must
WHEN A FUNCTION IS USED
be 1 if the result specification ’*’ is specified in a
Explanation: If a value expression directly contained subquery of any predicate other than an EXISTS
in the search condition is a set function specification, predicate.
then the WHERE clause must be contained in a
Severity: 4
HAVING clause.
User Response: Note the deviation from the
Severity: 4
applicable standard. Check and correct the SQL
User Response: Note the deviation from the statement.
applicable standard. Check and correct the SQL
statement.
DSNH730I W csectname LINE nnnn COL cc. THE
SET FUNCTION IS NOT VALID FOR
DSNH726I W csectname LINE nnnn COL cc. THE THE TABLE EXPRESSION BEGINNING
COLUMN SPECIFICATION FOR column WITH table
MUST BE AN OUTER REFERENCE
Explanation: One of the following conditions was not
Explanation: If a value expression directly contained met:
in the search condition is a function, then the column v If the table expression is a grouped view, the result
specification in the function must be an outer reference. specification of a subquery cannot contain a set
Severity: 4 function specification.
v If the table expression is a grouped view, the select
User Response: Note the deviation from the
list of a query specification cannot contain a function.
applicable standard. Check and correct the SQL
statement. Severity: 4
User Response: Note the deviation from the
applicable standard. Check and correct the SQL
statement.
Chapter 9. DB2 Messages 241
DSNH731I • DSNH738I
FROM clause identifies the named table must not
DSNH731I W csectname LINE nnnn COL cc. THE
identify a grouped view.
COLUMN SPECIFICATION FOR column
IS INVALID Severity: 4
Explanation: One of the following conditions was not User Response: Note the deviation from the
met: applicable standard. Check and correct the SQL
v For a grouped table, the column specification must statement.
reference a grouping column or be specified within a
set function specification. DSNH735I W csectname LINE nnnn COL cc.
v If it is not a grouped table, and the value expression INVALID AUTHORIZATION IDENTIFIER
includes a set function specification, then each authid
column specification must be specified within a set
function. Explanation: The authorization identifier prefixed to
the table name is invalid.
Severity: 4
Severity: 4
User Response: Note the deviation from the
applicable standard. Check and correct the SQL User Response: Note the deviation from the
statement. applicable standard. Check and correct the SQL
statement.
DSNH732I W csectname LINE nnnn COL cc.
DISTINCT IS SPECIFIED MORE THAN DSNH736I W csectname LINE nnnn COL cc. THE
ONCE. TABLE OR VIEW name ALREADY
EXISTS
Explanation: One of the following conditions has not
been met: Explanation: The table name or view name specified
already exists in the catalog.
v DISTINCT must not be specified more than once in a
query specification, excluding any subquery of that Severity: 4
query specification.
User Response: Note the deviation from the
v DISTINCT must not be specified more than once in a applicable standard. Check and correct the SQL
subquery, excluding any subquery contained in that statement.
subquery.
Severity: 4 DSNH737I W csectname LINE nnnn COL cc. THE
User Response: Note the deviation from the COLUMN DEFINITION IS MISSING
applicable standard. Check and correct the SQL Explanation: At least one column definition should be
statement. specified for a CREATE TABLE.
Severity: 4
DSNH733I W csectname LINE nnnn COL cc. THE
COMPARISON PREDICATE SUBQUERY User Response: Note the deviation from the
CANNOT CONTAIN A GROUP BY OR applicable standard. Check and correct the SQL
HAVING CLAUSE statement.
Explanation: If a subquery is specified in a
comparison predicate, then the table expression whose DSNH738I W csectname LINE nnnn COL cc. THE
FROM clause identifies the named table must not DATA TYPE type1 OF THE TARGET IS
contain a GROUP BY clause or a HAVING clause. NOT COMPATIBLE WITH THE DATA
TYPE type2 OF THE SOURCE
Severity: 4
Explanation: Data types should match between
User Response: Note the deviation from the source and target in a FETCH and SELECT statement.
applicable standard. Check and correct the SQL
statement. Severity: 4
User Response: Note the deviation from the
DSNH734I W csectname LINE nnnn COL cc. THE applicable standard. Check and correct the SQL
COMPARISON PREDICATE SUBQUERY statement.
CANNOT IDENTIFY A GROUPED VIEW
Explanation: If a subquery is specified in a
comparison predicate, then the table expression whose
242 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNH739I • DSNH752I
DSNH739I E csectname LINE nnnn COL cc. DSNH741I process1(NO) IMPLIES THAT process2
CREATE FUNCTION function-name CANNOT BE RUN
FAILED BECAUSE FUNCTIONS
Explanation: An inconsistent processing set was
CANNOT MODIFY DATA WHEN THEY
specified. An earlier phase and a later phase were
ARE PROCESSED IN PARALLEL.
requested, but not the intermediate step needed to
Explanation: The function cannot be created because process data between them. For example, requesting
ALLOW PARALLEL and MODIFIES SQL DATA were the precompile and the link edit without the compile
both specified explicitly or implicitly. A function cannot produces this error. Values for process1 are PRECOMP,
be parallelized if it modifies data. CICSXLAT, COMPILE, LINK, or BIND. Values for
process2 are COMPILE, LINK, or RUN.
Severity: 8 (error)
This message is issued by the following CLIST: DSNH
System Action: The statement cannot be executed.
Severity: 4 (warning)
User Response: Specify DISALLOW PARALLEL or
change the MODIFIES SQL DATA to NO SQL, System Action: process2 is not performed, but other
CONTAINS SQL or READS SQL DATA. processing is done.
User Response: Specify a consistent combination of
DSNH740I xxxxxx phase FINISHED, RC = retcode, processing. Application program preparation needs to
LISTING IN data-set run all the steps to provide a correct application
program. The process does allow beginning or ending
Explanation: The DSNH INST phase completed with
steps to be run at a different time. See message
return code retcode. The phase is one of the following:
DSNH740I for the required step order.
PLI Macro Pass
Precompiler
CICS Command Translator DSNH750I INVALID DATA SET: clist-keyword
Bind Package clist-keyword-parameter
Bind Plan
Explanation: The data set name specified on the
Compile/assembly
clist-keyword-parameter contains unbalanced
PLI
parenthesis.
Prelink (unique to C/370 Compiler)
Link This message is issued by the following CLIST: DSNH
Run
Severity: 8 (error)
If the CLIST puts the listing into a data set, the name of
the data set is shown as data-set. If the PRINT System Action: The CLIST is terminated.
parameter is LEAVE, NONE, or TERM, the 'LISTING IN User Response: If a member name is to be
data-set' part of this message is omitted. associated with the specified data set, the member
name must be enclosed in parentheses.
Refer to message DSNH756I for an explanation of the
print data set names assigned during processing.
DSNH751I clist ERROR IN parameter VALUE value
This message is issued by the following CLIST: DSNH Explanation: The specified CLIST keyword parameter
does not have an acceptable value.
Severity: retcode
Severity: 8 (error)
System Action: Processing continues as requested.
System Action: The CLIST processing is terminated.
User Response: This phase is complete. If there are
errors, other messages are produced. The next phase User Response: Refer to the DSNH (TSO clist)
requested begins. The order of the phases is: section in DB2 Command Reference for a complete list
1. PLI Macro Pass of the supported CLIST parameters and their associated
2. Precompiler values. Correct the invalid parameter, and resubmit the
3. CICS Command Translator job.
4. Bind Package
5. Bind Plan
6. ASM, ASMH, C (C/370 Compiler), COBOL, DSNH752I INPUT DATA SET NAME IS MISSING
COBOL2, FORTRAN, PLI OR NONE
7. Prelink Explanation: The DSNH CLIST requires a value for
8. Link the input data set name (INPUT). You cannot use an
9. Run input data set name of NONE.
This message is issued by the following CLIST: DSNH
Chapter 9. DB2 Messages 243
DSNH753I • DSNH758I
Severity: 0 (successful) User Response: Correct the input request. Specify a
different OUTNAME. The default for OUTNAME is
System Action: The CLIST prompts for a name, if
TEMP.
prompting is allowed. If prompting is not allowed, for
example in batch or when PROFILE NOPROMPT was
entered, the CLIST terminates. DSNH756I clist PRINT PARAMETER name MUST
NOT CONTAIN SPECIAL CHARACTERS
User Response: Specify an INPUT name. See
message DSNH753I. Explanation: The DSNH and DSNHC CLISTs (clist)
use the PRINT parameter to build names for data sets
used for the print listings from various phases. These
DSNH753I ENTER INPUT DATA SET NAME
names are prefixed by an authorization ID or a TSO
Explanation: The CLIST is requesting the name of the prefix value and have a number of suffixes. The PRINT
input data set. parameter name can contain a period or national
characters, but it cannot contain special characters. It
This message is issued by the following CLIST: DSNH cannot have apostrophes to specify a single data set
Severity: 0 (successful) name.
System Action: The system waits for user to enter The data set names built using the PRINT(print)
data set name or for the CLIST to be terminated. qualifier are the following:
print.CXLIST
User Response: Enter the name of the data set. Do CICS Command Translator
not specify the parameter or command, but just enter print.LINKLIST
the name of the data set. The standard TSO prefixing Linkage Editor
will be done if the data set name is not entered within print.LIST
apostrophes. Compiler or Assembler
print.PCLIST
DSNH754I clist OUTNAME PARAMETER name DB2 Precompiler
MUST NOT CONTAIN SPECIAL print.SYSCPRT.LIST
CHARACTERS C/370 Compiler
print.SYSOUT.PRELLIST
Explanation: The DSNH and DSNHC CLISTs, clist, C/370 Prelink Utility
use the OUTNAME parameter to build names for a
number of data sets that are passed from phase to Severity: 8 (error)
phase. These names are prefixed by an authorization ID System Action: The CLIST terminates.
or TSO prefix value and have a number of suffixes. For
this reason, OUTNAME parameter name must not User Response: Correct the name specified with the
contain special characters. It can contain a period or PRINT parameter.
national characters. It cannot have apostrophes to
specify a single data set name. DSNH757I ERROR IN PLAN NAME LENGTH value
Severity: 8 (error) Explanation: The value is too long for a plan name. A
System Action: The CLIST is terminated. plan name has a maximum of 8 characters.
User Response: Correct the input request. The This message is issued by the following CLIST: DSNH
default for this parameter is TEMP, which should be Severity: 8 (error)
adequate for most usage.
System Action: The CLIST is terminated.
DSNH755I OUTNAME PARAMETER name MUST User Response: Specify a plan name with 8 or fewer
NOT BEGIN THE SAME AS INPUT input characters.
Explanation: The DSNH CLIST uses the OUTNAME
parameter name to build a number of data sets that are DSNH758I HOST(host-language) IS NOT
passed from phase to phase. These data sets could PERMITTED WITH RUN(IMS) OR
conflict with the INPUT data set (input) if the names are RUN(CICS)
the same, causing the INPUT data set to be overwritten.
Explanation: There is no facility for connecting a
To avoid this problem, the names are not allowed to
FORTRAN program to either IMS or CICS.
have the same initial characters.
This message is issued by the following CLIST: DSNH
This message is issued by the following CLIST: DSNH
Severity: 8 (error)
Severity: 8 (error)
System Action: The CLIST terminates.
System Action: The CLIST is terminated.
244 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNH759I • DSNH773I
User Response: Use the specified language in the
DSNH760I PRELINK OPTION INVALID WITH HOST
TSO or batch environment.
LANGUAGE (host-language)
Explanation: Invocation of the PRELINK step is not
DSNH759I clist TERMINATING, phase RC = retcode
supported by host-language. This option is only valid for
Explanation: The DSNH or DSNHC clist terminated at the following DSNH HOST language compilers: C, CPP,
phase because the return code retcode was greater and IBMCOB.
than or equal to the RCTERM parameter value.
This message is issued by the following CLIST: DSNH
The phase is one of the following:
Severity: 4 (error)
ASM ASMH System Action: The DSNH PRELINK parameter is
BIND Package BIND Plan ignored and prelink utility processing is bypassed. Clist
CICS Command Translator processing continues normally with a return code of 4.
COBOL COB2
CLIST CHECKING FORTRAN User Response: Refer to the description of the DSNH
PLI C (C/370 Compiler) PRELINK keyword option in DB2 Command Reference.
Prelink Link
PLI Macro Pass Precompiler DSNH770I W csectname LINE nnnn COL cc. YOU
Run MUST DECLARE COLUMN column AS
NOT NULL
Severity: retcode Explanation: All columns identified as UNIQUE must
System Action: The CLIST terminates. be defined with the NOT NULL option.
User Response: Determine the cause for the high Severity: 4
return code. If the parameters include TERM(NONE) User Response: Note the deviation from the
and direct the PRINT to a data set, you might need to applicable standard. Check and correct the SQL
search the print data sets for the listing of the error. statement.
Refer to message DSNH756I for an explanation of the
print data set names assigned during processing.
DSNH771I W csectname LINE nnnn COL cc. THE
Problem Determination: The location of the VIEWED TABLE table MUST BE
messages describing the prior errors depends upon the UPDATEABLE
values of the TERM and PRINT parameters. The
messages can be directed to the terminal, to Explanation: When the WITH CHECK OPTION is
preallocated data sets, or to data sets dynamically specified, then the viewed table must be updateable.
allocated during CLIST processing. Severity: 4
If TERM(NONE) PRINT(NONE) was specified, the User Response: Note the deviation from the
messages are not available. Execute the CLIST again applicable standard. Check and correct the SQL
and specify a location for the error messages. statement.
To find the documentation, note the immediately
preceding DSNH740I message for the location of the DSNH772I W csectname LINE nnnn COL cc.
listings. If the 'LISTING IN data-set' portion of the INVALID NUMBER OF COLUMN
message is missing, specify a PRINT data set, NAMES
SOURCE(YES) and XREF(YES), and execute the
CLIST again. Use TERM(TERM) to direct error Explanation: The number of column names in the
messages to your terminal. These listings and execution view column list should be the same as the degree of
of the DSNH CLIST are required for problem diagnosis. the table specified by the query specification.
If the error is in the CLIST or the error location is CLIST Severity: 4
CHECKING, use CONTROL(SYMLIST) to produce a
User Response: Note the deviation from the
detailed trace of the CLIST execution and provide the
applicable standard. Check and correct the SQL
trace listing.
statement.
Check for DSNH751I messages that describe the error.
DSNH773I W csectname LINE nnnn COL cc. YOU
MUST DECLARE THE CURSOR cursor
BEFORE USE
Explanation: The cursor specified was not declared in
a DECLARE CURSOR statement.
Chapter 9. DB2 Messages 245
DSNH774I • DSNH781I
Severity: 4 applicable standard. Check and correct the SQL
statement.
User Response: Note the deviation from the
applicable standard. Check and correct the SQL
statement. DSNH778I W csectname LINE nnnn COL cc. THE
TABLE table IS A READ-ONLY TABLE
DSNH774I W csectname LINE nnnn COL cc. THE Explanation: A DELETE, an INSERT, or an UPDATE
CURSOR cursor IS ALREADY statement was specified on a read-only table.
DECLARED
Severity: 4
Explanation: The cursor specified was already
User Response: Note the deviation from the
declared in a DECLARE CURSOR statement.
applicable standard. Check and correct the SQL
Severity: 4 statement.
User Response: Note the deviation from the
applicable standard. Check and correct the SQL DSNH779I W csectname LINE nnnn COL cc. THE
statement. TABLE table MUST NOT BE IDENTIFIED
IN A FROM CLAUSE OF ANY
SUBQUERY CONTAINED IN A SEARCH
DSNH775I W csectname LINE nnnn COL cc. ONLY
CONDITION
’*’ OR COLUMN NAMES ARE VALID IN
THIS CONTEXT Explanation: A table specified in a DELETE or an
UPDATE statement cannot be used in a FROM clause
Explanation: When UNION is specified, the select list
of any subquery contained in its search condition.
for the specification of the two table expressions
identified by the query expression and query term Severity: 4
should consist of ’*’ or column specifications.
User Response: Note the deviation from the
Severity: 4 applicable standard. Check and correct the SQL
statement.
User Response: Note the deviation from the
applicable standard. Check and correct the SQL
statement. DSNH780I W csectname LINE nnnn COL cc. THE
TABLE table1 IS NOT THE FIRST
TABLE table2 SPECIFIED IN THE
DSNH776I W csectname LINE nnnn COL cc. THE
DECLARE CURSOR STATEMENT
DESCRIPTIONS OF TABLES
IDENTIFIED BY THE QUERY Explanation: The table specified in a DELETE or an
EXPRESSION BEGINNING WITH UPDATE statement should be the first table specified in
TABLE: table1 AND THE QUERY TERM the FROM clause of the DECLARE CURSOR
BEGINNING WITH TABLE: table2 statement.
SHOULD BE IDENTICAL
Severity: 4
Explanation: When UNION is specified, the
User Response: Note the deviation from the
descriptions of the two tables should be identical,
applicable standard. Check and correct the SQL
except for the column names.
statement.
Severity: 4
User Response: Note the deviation from the DSNH781I W csectname LINE nnnn COL cc. THE
applicable standard. Check and correct the SQL NUMBER OF TARGET
statement. SPECIFICATIONS DO NOT MATCH THE
DEGREE OF TABLE table
DSNH777I W csectname LINE nnnn COL cc. THE Explanation: The number of target specifications in
SORT SPECIFICATION number IS the FETCH statement do not match the degree of the
OUTSIDE THE DEGREE OF TABLE table specified.
table
Severity: 4
Explanation: If the sort specification contains an
User Response: Note the deviation from the
unsigned integer, it should be greater than zero and not
applicable standard. Check and correct the SQL
greater than the number of columns in the table.
statement.
Severity: 4
User Response: Note the deviation from the
246 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNH782I • DSNH789I
v If the data type of the column name is approximate
DSNH782I W csectname LINE nnnn COL cc. THE
numeric, then the corresponding item in the INSERT
TARGET TABLE table OF THE INSERT
or UPDATE statement should be approximate
STATEMENT IS ALSO IN THE FROM
numeric or exact numeric.
CLAUSE OR IN A CONTAINED
SUBQUERY Severity: 4
Explanation: The named table must not be identified User Response: Note the deviation from the
in a FROM clause of a query specification or of any applicable standard. Check and correct the SQL
subquery contained in the query specification. statement.
Severity: 4
DSNH786I W csectname LINE nnnn COL cc. YOU
User Response: Note the deviation from the
CANNOT USE A GROUP BY OR
applicable standard. Check and correct the SQL
HAVING CLAUSE OR IDENTIFY A
statement.
GROUPED VIEW IN THIS CONTEXT
Explanation: The table identified in the FROM clause
DSNH783I W csectname LINE nnnn COL cc. THE
of the table expression in a SELECT statement should
NUMBER OF COLUMNS SPECIFIED
not include a GROUP BY or HAVING clause and should
DOES NOT MATCH THE NUMBER OF
not identify a grouped view.
VALUES SPECIFIED
Severity: 4
Explanation: In an INSERT statement, the number of
columns specified does not match the number of values User Response: Note the deviation from the
specified. applicable standard. Check and correct the SQL
statement.
Severity: 4
User Response: Note the deviation from the
DSNH787I W csectname LINE nnnn COL cc. THE
applicable standard. Check and correct the SQL
NUMBER OF ELEMENTS SPECIFIED IN
statement.
THE SELECT LIST SHOULD MATCH
THE NUMBER IN THE TARGET LIST
DSNH784I W csectname LINE nnnn COL cc. THE
Explanation: In the SELECT statement, the number of
NUMBER OF COLUMNS SPECIFIED
elements specified in the select list should match the
DOES NOT MATCH THE DEGREE OF
number of elements in the target list.
TABLE table IN THE QUERY
SPECIFICATION Severity: 4
Explanation: The number of columns specified in an User Response: Note the deviation from the
INSERT statement does not match the degree of the applicable standard. Check and correct the SQL
table specified in the query specification. statement.
Severity: 4
DSNH788I W csectname LINE nnnn COL cc. THE
User Response: Note the deviation from the
SET FUNCTION function IS NOT
applicable standard. Check and correct the SQL
ALLOWED IN AN UPDATE STATEMENT
statement.
Explanation: A value expression in a SET clause of
an UPDATE statement should not include a set function
DSNH785I W csectname LINE nnnn COL cc.
specification.
THERE IS A DATA TYPE OR LENGTH
MISMATCH BETWEEN COLUMN column Severity: 4
AND ITS INSERT OR UPDATE ITEM
User Response: Note the deviation from the
Explanation: One of the following conditions was not applicable standard. Check and correct the SQL
met: statement.
v If the data type of the column name is character
string, then the corresponding item in the INSERT or DSNH789I W csectname LINE nnnn COL cc. YOU
UPDATE statement should be character string with a CANNOT SPECIFY NULL FOR NOT
length equal to or less than the length of the column NULL COLUMN column
name.
v If the data type of the column name is exact numeric, Explanation: If NULL is specified in the SET clause of
then the corresponding item in the INSERT or the UPDATE statement, then the corresponding column
UPDATE statement should be exact numeric. should allow nulls.
Severity: 4
Chapter 9. DB2 Messages 247
DSNH790I • DSNH867I
User Response: Note the deviation from the
DSNH794I W csectname LINE nnnn COL cc. THE
applicable standard. Check and correct the SQL
OBJECT object-name CANNOT BE
statement.
CREATED BECAUSE THE FIRST
THREE CHARACTERS ARE RESERVED
DSNH790I W csectname LINE nnnn COL cc. FOR SYSTEM OBJECTS
THERE IS AN INVALID SQL
Explanation: In general, SYS is a reserved prefix for
TERMINATOR FOR THE HOST
names. The only exceptions are:
LANGUAGE
v SYSPROC is a valid schema name for stored
Explanation: The SQL statement was not terminated procedures.
by the correct construct for the host language being v SYSADM is a valid schema name.
processed.
This condition is similar to the condition reported in
Severity: 4
SQLCODE -707.
User Response: Note the deviation from the
Severity: 4
applicable standard. Check and correct the SQL
statement. User Response: Select a name that does not start
with a reserved prefix.
DSNH791I W csectname LINE nnnn COL cc. YOU
MUST DEFINE THE HOST VARIABLE DSNH795I E csectname LINE nnnn COL cc.
identifier INVALID SPECIFICATION OF A ROWID
COLUMN
Explanation: The host variable named was either not
defined within the program or defined outside the SQL Explanation: For a CREATE TABLE statement, the
declaration section. specification of a ROWID column may be invalid for one
of the following reasons:
Severity: 4
v A ROWID column cannot be a column of a temporary
User Response: Note the deviation from the table
applicable standard. Check and correct the SQL
v A ROWID column cannot be a column of a table with
statement.
an EDITPROC
v A ROWID column cannot be a column of a foreign
DSNH792I W csectname LINE nnnn COL cc. THE key
TABLE table WAS NOT FOUND IN THE
v A ROWID column cannot be a column of a primary
CATALOG
key
Explanation: The named table does not exist in the v A ROWID column cannot be referenced in the
catalog. check-condition of a table check constraint.
Severity: 4 Severity: 8
User Response: Note the deviation from the System Action: The statement was not executed.
applicable standard. Check and correct the SQL
statement. User Response: Correct the syntax.
DSNH793I W csectname LINE nnnn COL cc. | DSNH867I E csectname LINE nnnn COL cc.
THERE IS AN INVALID IDENTIFIER | INVALID SPECIFICATION OF A ROWID
FORMAT identifier FOR HOST | COLUMN
LANGUAGE language | Explanation: For a CREATE TABLE statement, the
Explanation: The format of the identifier name | specification of a ROWID column might be invalid for
displayed does not meet the requirements of the host | one of the following reasons:
language. | v A ROWID column cannot be a column of a temporary
| table.
Severity: 4
| v A ROWID column cannot be a column of a table with
User Response: Note the deviation from the | an EDITPROC.
applicable standard. Check and correct the SQL
| v A ROWID column cannot be a column of a foreign
statement.
| key.
| v A ROWID column cannot be a column of a primary
| key.
248 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNH870I • DSNH876I
| v A ROWID column cannot be referenced in the System Action: Precompiling continues but flagger
| check-condition of a table check constraint. operation is discontinued.
| Severity: 8 User Response: If you suspect an error in DB2, refer
to Part 2 of DB2 Diagnosis Guide and Reference for
| System Action: The statement was not executed. information on identifying and reporting the problem.
| User Response: Correct the syntax.
DSNH874I W csectname AN ERROR OCCURRED
DSNH870I W csectname THERE IS NOT ENOUGH WHEN TERMINATING THE FLAGGER
MEMORY FOR THE FLAGGER;
Explanation: An internal error occurred during flagger
FLAGGING IS DISCONTINUED
termination.
Explanation: The flagger could not allocate enough
Severity: 4
storage to load all required modules.
System Action: Precompiling continues but flagger
Severity: 4
operation is discontinued.
System Action: Precompiling continues but flagger
User Response: If you suspect an error in DB2, refer
operation is discontinued.
to Part 2 of DB2 Diagnosis Guide and Reference for
User Response: Increase the region size in the JCL information on identifying and reporting the problem.
for the application. Allocate more storage for flagger
operation.
DSNH875I W csectname AN ERROR OCCURRED
WHEN ATTACHING TO DB2, REASON
DSNH871I W csectname AN ERROR OCCURRED CODE: X'reason'; FLAGGING
WHEN ATTEMPTING TO LOAD THE CONTINUED AS SYNTAX ONLY
FLAGGER MODULE module.
Explanation: An error occurred while trying to connect
FLAGGING IS DISCONTINUED
or disconnect from the DB2 subsystem.
Explanation: A flagger module was not found during
Severity: 4
flagger initialization.
System Action: Processing continues without
Severity: 4
semantics flagging.
System Action: Precompiling continues but flagger
User Response: Refer to the reason code returned in
operation is discontinued.
this message and perform corrective actions.
User Response: Refer to the message produced by
the operating system for details of causes and proceed
DSNH876I W csectname AN ERROR SQLCODE
as instructed for that message.
sqlcode WAS RETURNED DURING
FLAGGER ACCESS TO THE CATALOG
DSNH872I W csectname AN ERROR OCCURRED OBJECT authid.table. MODULE NAME:
WHEN INITIALIZING THE FLAGGER. module ERROR REASON CODE:
FLAGGING IS DISCONTINUED X'reason'; FLAGGING CONTINUES
WITH SYNTAX CHECK ONLY
Explanation: An internal error occurred during flagger
initialization. Explanation: An error occurred during the execution
of a flagger access to the DB2 catalog.
Severity: 4
Severity: 4
System Action: Precompiling continues but flagger
operation is discontinued. System Action: Processing continues without
semantics flagging.
User Response: If you suspect an error in DB2, refer
to Part 2 of DB2 Diagnosis Guide and Reference for User Response: Use the provided SQL return code,
information on identifying and reporting the problem. object type, and name to identify the problem. If you
suspect an error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on
DSNH873I W csectname THE FLAGGER COULD identifying and reporting the problem.
NOT PROCESS THE SQL STATEMENT.
FLAGGING IS DISCONTINUED
Explanation: An SQL statement passed to the flagger
caused an internal error within the flagger.
Severity: 4
Chapter 9. DB2 Messages 249
DSNH877I • DSNH901I
information on identifying and reporting the problem.
DSNH877I W csectname NOT ENOUGH MEMORY
FOR FLAGGER OPERATION: RETURN
CODE: return DSNH901I S csectname U LINE nnnn COL cc
INTERNAL PRECOMPILER ERROR –
Explanation: Insufficient storage is available for
REASON CODE ccc
flagger operation.
Explanation: An internal compiler consistency check
Severity: 4
failed. Reason codes are:
System Action: Processing continues without
000 The message formatter was called with an
flagging.
unlisted internal message number.
User Response: Check whether the storage allocation
001 The parser received a token code of 0 from the
for the precompiler can be increased. Allocate more
lexical scan. Lexical scan refers to a scan of
storage for flagger operation.
words rather than syntax.
002 Error in storage suballocation control blocks.
DSNH878I W csectname ERROR RELEASING
FLAGGER MEMORY; FLAGGING IS v The error might have occurred because a
DISCONTINUED DB2 SQL statement limitation was
exceeded. The SQL statement might be
Explanation: An error occurred when a flagger referencing, creating, or declaring more
module attempted to release storage back to the flagger columns than the DB2 defined maximum
pool. number allowed for an SQL statement.
Severity: 4 Another possibility is that too many host
variables are being referenced in the SQL
System Action: Processing continues without statement.
flagging.
003 Error in a storage suballocation request.
User Response: If you suspect an error in DB2, refer
v This error might have occurred because of
to Part 2 of DB2 Diagnosis Guide and Reference for
storage constraints when building the DBRM
information on identifying and reporting the problem.
entry for the SQL statement or because the
SQL statement exceeds the DB2 maximum
DSNH879I W csectname ERROR RELEASING statement length.
FLAGGER MEMORY; RETURN CODE
004 Error in pointer structures.
return
005 On BIND or REBIND, a host variable was not
Explanation: An error occurred when a flagger
found.
module attempted to release storage back to the
operating system. 006 Unexpected value for parser option.
Severity: 4 007 The internal limit was exceeded.
System Action: Processing continues without v A fully qualified name exceeds the maximum
flagging. length of 255 characters.
v The size of a DBRM record exceeds 65536
User Response: If you suspect an error in DB2, refer
bytes of storage.
to Part 2 of DB2 Diagnosis Guide and Reference for
information on identifying and reporting the problem. 008 Internal conversion error.
v An error occurred when converting a
DSNH880I W csectname AN ERROR WAS timestamp version-id.
RETURNED DURING FLAGGER Severity: 16 (unrecoverable error)
ACCESS TO THE DB2 CATALOG;
REASON CODE: X'reason' RETURN System Action: The precompiler is terminated
CODE X'return' immediately.
Explanation: An error occurred when a flagger User Response: Notify the system programmer.
module attempted to access the system catalog. System Programmer Response: If you suspect an
Severity: 4 error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and
System Action: Processing continues without reporting the problem.
flagging.
Problem Determination: A copy of the application
User Response: If you suspect an error in DB2, refer program source and the printout is useful (specify
to Part 2 of DB2 Diagnosis Guide and Reference for SOURCE and XREF).
250 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNH904I • DSNH4785I
| System Action: The statement cannot be processed.
DSNH904I csectname U STORAGE OVERFLOW
| User Response: Examine the current definition for the
Explanation: More storage is needed, but could not
| parameter or SQL variable and ensure that it has the
be obtained during precompiler/parser execution.
| proper data type.
Severity: 16 (unrecoverable error)
System Action: The precompiler/parser is terminated | DSNH4779I E csectname LINE nnnn COL cc LABEL
immediately. | label SPECIFIED ON A GOTO OR
| LEAVE STATEMENT IS NOT VALID
System Programmer Response: The storage
required for the current statement could not be acquired | Explanation: In an SQL procedure, label is specified
or exceeds the maximum for a single request. If the | on a GOTO or LEAVE statement. label is not defined or
region size is being used completely, check whether the | is not a valid label for the statement.
region can be expanded. If it cannot be expanded, the
| The label on a LEAVE statement must be the label for a
SQL statement is too large to be processed.
| LOOP, REPEAT, WHILE, or compound statement.
| The label in a GOTO statement must be defined within
DSNH1760I E csectname LINE nnnn COL cc.
| a scope that the GOTO statement can reach.
CREATE STATEMENT FOR STORED
PROCEDURE procedure-name MUST | v If the GOTO statement is defined in a compound
HAVE A VALID LANGUAGE CLAUSE | statement, label must be defined inside the same
AND EXTERNAL CLAUSE. | compound statement.
| v If the GOTO statement is defined in a handler, label
Explanation: The CREATE statement for procedure
| must be defined in the same handler and must follow
procedure-name must have both a valid LANGUAGE
clause and a valid EXTERNAL clause.
| the other scope rules.
| v If the GOTO statement is defined outside a handler,
Severity: 8 (error) | label must not be defined within a handler.
System Action: The statement cannot be executed. | Severity: 8 (error)
User Response: Correct and reissue the failing | System Action: The statement cannot be processed.
statement.
| User Response: Change the label in the LEAVE
| statement to match the label on the LOOP, REPEAT,
| DSNH4001I HOST LANGUAGE STATEMENT | WHILE, or COMPOUND statement that contains the
| EXCEEDS MAXIMUM OF 1000 LINES | LEAVE statement.
| Explanation: A user put more than 1000 lines in a | Ensure that the label in the GOTO statement is defined
| single PL/I DCL statement. | within a scope that the GOTO statement can reach.
| Severity: 8
| System Action: Processing continues. | DSNH4785I E csectname LINE nnnn COL cc THE
| DECLARATION OR USE OF THE
| User Response: Split the DCL statement into two | SQLSTATE OR SQLCODE VARIABLE IS
| parts. | NOT VALID
| Explanation: The declaration or use of an SQLCODE
| DSNH4408I E csectname LINE nnnn COL cc THE | or SQLSTATE special variable is not valid for one of the
| VALUE IS NOT COMPATIBLE WITH | following reasons:
| THE DATA TYPE OF ITS TARGET
v SQLSTATE is declared with a data type other than
|
| Explanation: The data type of the value to be | CHAR(5).
| assigned to the parameter or SQL variable is | v SQLCODE is declared with a data type other than
| incompatible with the declared data type of the | INTEGER.
| assignment target. Both must be:
v NULL is assigned to SQLCODE or SQLSTATE.
|
| v Numerals
| v Characters | Severity: 8 (error)
| v Graphics
v Dates or character
| System Action: The statement cannot be processed.
|
| v Times or character | User Response: Declare SQLSTATE only as
| v Timestamps or character | CHAR(5) and SQLCODE only as INTEGER. Do not
| v Row ID’s | assign the null value to SQLCODE or SQLSTATE.
| v The same distinct types
| Severity: 8 (error)
Chapter 9. DB2 Messages 251
DSNH4911I • DSNH4999I
| DSNH4911I E csectname SQL TYPE OF HOST | compilation or precompilation currently in progress may
| VARIABLE IS INVALID
| continue.
| Explanation: SQLGALHV received a host variable
| with an invalid SQL data type code. | DSNH4916I E csectname SQLGINIT HAS NOT BEEN
| INVOKED
| Severity: 8 (error)
| Explanation: A call to SQLGINIT has not been made.
| System Action: The invalid host variable is ignored.
| Severity: 8 (error)
| User Response: Correct the SQL data type code and
| register the host variable again. | System Action: Control is returned to caller with no
| other action taken.
| DSNH4912I E csectname LENGTH OF HOST | User Response: Change the compiler or precompiler
| VARIABLE IS OUT OF RANGE
| code so that SQLGINIT is called before any of the other
| API entry points.
| Explanation: SQLGALHV received a host variable
| with an invalid data area. The length of the data area in
| parameter SQL_LENGTH is either too large or too
| DSNH4919I E csectname TASK ARRAY TOO SMALL
| negative. | Explanation: Precompiler Services need more task
| Severity: 8 (error) | array entries than the precompiler allocated.
| System Action: The host variable is ignored. | Severity: 8 (error)
| User Response: Correct the data area length | System Action: Control is returned to caller with no
| parameter and register the host variable again. | other action taken.
| User Response: Allocate a larger task array and
| DSNH4913I E csectname TOKEN IDENTIFIER HAS | make the call to SQLGCMPL again.
| ALREADY BEEN USED
| Explanation: The token identifier passed to | DSNH4920I E csectname TOKEN ID ARRAY TOO
| SQLGALHV already exists for another host variable. | SMALL
| Severity: 8 (error) | Explanation: Precompiler Services needs more token
| identifier array entries than the precompiler allocated.
| System Action: The host variable is ignored.
| Severity: 8 (error)
| User Response: Assign a different token identifier and
| register the host variable again. | System Action: Control is returned to caller with no
| other action taken.
| DSNH4914I E csectname INVALID TOKEN | User Response: Allocate a larger token identifier
| IDENTIFIER
| array and make the call to SQLGCMPL again.
| Explanation: The token identifier passed to
| SQLGALHV is invalid. | DSNH4941I U csectname BLANK OR EMPTY SQL
| STATEMENT TEXT
| Severity: 8 (error)
| Explanation: The SQL statement passed to
| System Action: The host variable is ignored. | SQLGCMPL was blank.
| User Response: Assign a token identifier that is a | Severity: 8 (error)
| valid 4-byte integer, and register the host variable again.
| System Action: Control is returned to caller with no
| other action taken.
| DSNH4915I E csectname SQLGINIT HAS ALREADY
| BEEN INVOKED
| User Response: Assign the SQL statement buffer to
| the correct parameter and call SQLGCMPL again.
| Explanation: A call to SQLGINIT has already been
| made.
| DSNH4999I U csectname PRECOMPILER SERVICES
| Severity: 8 (error) | INTERNAL ERROR
| System Action: Control is returned to caller with no | Explanation: Precompiler Services encountered an
| other action taken. | unrecoverable internal error.
| User Response: Change the compiler or precompiler | Severity: 16 (unrecoverable error)
| code so that SQLGINIT is only called once. The
252 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNH5012I • DSNH5037I
| System Action: Control is returned to caller with no | LOCATOR or DBCLOB AS LOCATOR is not
| other action taken. | considered a CLOB or DBCLOB.
| User Response: Terminate compilation or | v FOR BIT DATA, CCSID 65535, FOR MIXED DATA,
| precompilation. | FOR SBCS DATA is specified and the variable is
| defined as graphic, varying-length graphic, or
| DBCLOB.
| DSNH5012I HOST VARIABLE host-variable IS NOT
| v FOR BIT DATA, or CCSID 65535 is specified and the
| EXACT NUMERIC WITH SCALE ZERO
| variable is defined as CLOB.
| Explanation: A host variable host-variable was
| Severity: 8 (error)
| specified, but it is not valid in the context in which it was
| used. Host variable host-variable was specified as part | System Action: The statement cannot be
| of ABSOLUTE or RELATIVE in a FETCH statement, or | precompiled.
| in a ROWS clause of a FETCH or INSERT statement.
| The host variable was not usable for one of the
| User Response: Correct the definition of the host
| following reasons:
| variable. Precompile the program again.
| v It is not an exact numeric type (A Floating Point Data
| type is not exact numeric) | DSNH5035I HOST VARIABLE variable IS SPECIFIED
| v The scale is not zero (A decimal data type must have
| TWICE IN A DECLARE VARIABLE
| zero decimal digits to qualify as scale zero)
| STATEMENT
| System Action: DB2 cannot process the statement.
| Explanation: The host variable variable was specified
| in two or more DECLARE VARIABLE statements, or
| Programmer Response: Correct the application | was specified two or more times in one DECLARE
| program to declare the host variable to be an exact | VARIABLE statement. A host variable can be specified
| numeric with scale zero. | once at most in a DECLARE VARIABLE statement.
| SQLSTATE: 42618 | Severity: 8 (error)
| System Action: The statement cannot be processed.
| DSNH5033I DECLARE VARIABLE NOT VALID FOR
| variable
| User Response: Specify the host variable at most
| once in a DECLARE VARIABLE statement.
| Explanation: Host variable variable specified in a
| DECLARE VARIABLE statement is not valid. The
| DECLARE VARIABLE statement occurs after any SQL
| DSNH5036I CCSID VALUE OUT OF RANGE
| statement (in a COBOL or FORTRAN application | Explanation: The CCSID for a DECLARE VARIABLE
| program) or after a DECLARE CURSOR statement (in | statement is outside the range of 1 to 65533, or the the
| an application program in any other host language), | value 65535. The value must be within the range of 1 to
| where the SQL statement and the DECLARE | 65533, or the value must be 65535.
| VARIABLE refer to the same variable.
| Severity: 8 (error)
| Severity: 8 (error)
| System Action: The statement cannot be processed.
| System Action: The statement cannot be processed.
| User Response: If this message is issued for a
| User Response: Ensure that the DECLARE | ″DECLARE VARIABLE CCSID integer″ statement,
| VARIABLE occurs before the use of the host variable in | change the value to be within the range of 1 to 65533
| an SQL statement in the application. | or the value 65535. If this message is issued for a
| DECLARE VARIABLE statement with the ″FOR SBCS
| DATA″ or ″FOR MIXED DATA″ clause, then the CCSIDs
| DSNH5034I DECLARE VARIABLE NOT VALID FOR
| variable
| specified on panel DSNTIPF at installation time need to
| be updated with valid values.
| Explanation: Host variable variable specified in a
| DECLARE VARIABLE statement is not valid for one of
| the following reasons:
| DSNH5037I DECLARE VARIABLE STATEMENT
| FOUND WITH ONE-PASS
| v A reference is made to a variable that does not exist. | PRECOMPILATION
| v A reference is made to a variable that is a structure.
| Explanation: A DECLARE VARIABLE statement was
| v A reference is made to a variable that is a component | found, but the source program is being precompiled with
| of two more structures. | only one pass. If a DECLARE VARIABLE is used in an
| v The host variable is not defined as character, | assembler source program, the ONEPASS precompiler
| varying-length character, graphic, varying-length | option must not be used. If a DECLARE VARIABLE is
| graphic, CLOB, or DBCLOB. In this case, CLOB AS | used in a C, C++, or PL/I source program, the
Chapter 9. DB2 Messages 253
DSNH20008I
| TWOPASS precompiler option must be used.
| Severity: 8 (error)
| System Action: The source program cannot be
| precompiled.
| User Response: Specify the TWOPASS precompiler
| option or, for assembler, do not specify the ONEPASS
| precompiler option.
| DSNH20008I UNSUPPORTED OPTION keyword
| SPECIFIED
| Explanation: keyword is a deprecated feature that
| was supported in releases prior to DB2 Version 7, and
| is no longer supported.
| For indexes, only one type is currently supported —
| type 2.
| Severity: 8 (error)
| System Action: The statement cannot be executed.
| User Response: Correct the syntax of the SQL
| statement to remove reference to the unsupported
| keyword. Refer to the DB2 SQL Reference for more
| information.
| SQLSTATE: 560A9
254 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 10. DSNI... Messages
a table space, an index space, or a partition within a
DSNI001I RESTART HAS BEEN DEFERRED
table space or an index space.
REASON reason TYPE type NAME
name The 'object-type' identifies the type and 'object-name'
identifies the name. If the DB2 catalog is unavailable,
Explanation: Restart could not be performed for one
'object-type' contains binary zeros and 'object-name'
or more pages of the resource identified by type and
contains blanks.
name. Those pages are placed in the logical page list
(LPL) and restart for those pages is deferred. The The resource that was unavailable is identified by 'type'
reason code explains why restart was not performed. and 'name'. The 'type' code identifies the type of the
resource as well as the format and content of the
Refer to Table 3 on page 1283 for an explanation of
resource, 'name'. For an explanation of resource type
resource type codes.
codes, see “Resource types” on page 1283. The
System Action: DB2 restart continues. Pages for 'reason' contains the reason code explaining why the
which restart activity was not performed are put into the resource was unavailable.
LPL.
System Action: The specified database, space, or
User Response: Correct the problem indicated by the partition is not stopped and remains in the current state.
reason code. Then use the START DATABASE If there are other databases, spaces, or partitions to be
command or the RECOVER utility to remove the pages stopped, they are processed normally.
from the LPL.
User Response: Correct the resource unavailable
problem and reissue the -STOP command.
DSNI002I csect-name UNABLE TO START
OBJECT TYPE object-type OBJECT
DSNI004I RESOURCE HAS BEEN STOPPED
NAME object-name REASON reason
TYPE type NAME name
TYPE type NAME name
Explanation: The resource identified by TYPE and
Explanation: The resource identified could not be
NAME could not be opened/closed, initialized, or was
started because it was unavailable. The resource could
found to be in an inconsistent state. The resource has
be a database, a table space, an index space, or a
been 'stopped' by DB2. If an open error occurred during
partition within a table space or an index space. The
DB2 startup, restart processing for the resource was
'object-type' identifies the type. The 'object-name'
deferred.
identifies the name. If the DB2 catalog is unavailable,
'object-type' contains binary zeros and 'object-name' TYPE and NAME identify the resource that has been
contains blanks. stopped. The TYPE code identifies the type of the
resource as well as the format and content of the
The resource that was unavailable is identified by 'type'
resource, NAME.
and 'name'. The 'type' code identifies the type of the
resource as well as the format and content of the For an explanation of resource type codes, see
'name'. For an explanation of resource type codes, see “Resource types” on page 1283.
“Resource types” on page 1283. The 'reason' contains
the reason code explaining why the resource was System Action: The database, table space or index
unavailable. space is stopped by DB2.
System Action: The specified database, space, or User Response: Previous messages provide
partition is not started and remains in its current state. If information to allow you to determine the cause of the
there are other databases, spaces, or partitions to be problem and the method of correcting it. Refer to them,
started, they are processed normally. and correct the problem. Then restart the database,
table space, or index space using the -START
User Response: Correct the resource unavailable command; and invoke the application again.
problem and reissue the -START command.
DSNI005I csect-name LPL OR GRECP RECOVERY
DSNI003I csect-name UNABLE TO STOP OBJECT CANNOT BE DONE FOR START
TYPE object-type OBJECT NAME DATABASE COMMAND-ID =
object-name REASON reason TYPE type command-id OBJECT TYPE object-type
NAME name OBJECT NAME object-name REASON
reason TYPE type NAME name
Explanation: The identified object could not be
stopped because a resource required to perform the Explanation: The resource identified could not be
stop was unavailable. The object could be a database, recovered during a START DATABASE command
© Copyright IBM Corp. 1982, 2001 255
DSNI006I • DSNI007I
identified by the 'command-id' because of problems
DSNI007I csect-name UNABLE TO
during LPL or GRECP recovery. The resource could be
START/RECOVER BECAUSE UNABLE
a table space, an index space, or a partition within a
TO DIRECT READ A LOG RECORD
table space or an index space. The 'object-type'
LOGRBA logrba
identifies the type. The 'object-name' identifies the
name. Explanation: Unable to START (or RECOVER)
because the necessary log records could not be
The resource that could not be recovered is identified
accessed. Either an error occurred while attempting to
by 'type' and 'name'. The 'type' code identifies the type
allocate or open the log data set or an expected log
of the resource as well as the format and content of the
record was not found on the log.
'name'. The 'reason' contains the reason code
explaining why the resource could not be recovered. For If the message is in response to a START command,
an explanation of resource type codes, see “Resource issue the -DISPLAY command to determine which
types” on page 1283. The 'reason' contains the reason resource(s) was not started. If the message is in
code explaining why the resource could not be response to a RECOVER utility, the resource is the
recovered. table space or index space that is the object of the
RECOVER.
The 'command-id' is a decimal number that represents a
START DATABASE command. LOGRBA gives the log RBA of the log record that is
unavailable.
This message, in combination with message DSNI006I
or DSNI022I, provides the LPL or GRECP recovery System Action: The resource is not started (or
information for a START DB command identified by the recovered) and remains in the current state. If this is a
'command-id'. START command, the resources are processed
normally if there are other databases or spaces to be
System Action: The specified space, or partition is
started and they do not involve reading the log.
started but remains in a LPL/GRECP state. If there are
other spaces or partitions to be recovered, they are User Response: Resubmit the utility, or reissue the
processed normally. START command, when the problem with the log has
been resolved.
User Response: Correct the problem specified by the
reason code and reissue the -START command. System Programmer Response: Run the print log
map (DSNJU004) utility. This may be run with DB2 up
or down. Find the data set that contains the requested
DSNI006I csect-name ASYNCHRONOUS GRECP
RBA in the output of DSNJU004. If the required RBA is
OR LPL RECOVERY IN PROGRESS
not in a listed data set, one of the following may have
FOR START DATABASE COMMAND-ID
occurred:
= command-id TYPE type NAME name
v The data set was deleted from the bootstrap data set
Explanation: This message is issued in response to a by a run of the change log inventory (DSNJU003)
START DATABASE command when the object (table utility. In this case, rerun the utility to insert the
space or index space) identified by TYPE and NAME missing data set name. DB2 must be down to run
had group buffer pool recovery pending (GRECP) or this utility.
logical page list (LPL) status, and recovery was
v The bootstrap data set has been damaged. In this
triggered.
case, the BSDS must be restored from the dump that
The 'command-id' is a decimal number that represents a occurred with the most recent archive log data set.
START DATABASE command. DSNJU003 must be run to supply changes that
occurred during and after the last off-load operation.
Refer to “Resource types” on page 1283 for an Changes may be determined from the operator’s
explanation of resource type codes. console listing.
System Action: The object is started. Also, GRECP or
LPL recovery is initiated. During LPL or GRECP If a listed log data set contains the required RBA, this
recovery process, message DSNI022I might be issued message will be preceded by one or more error
periodically to indicate the recovery status. If the messages from the log manager (DSNJ). See these
recovery completes successfully, message DSNI021I messages for appropriate action.
will appear at the end of recovery, otherwise message
Problem Determination: Issue the -DISPLAY
DSNI005I will indicate the error.
command to verify what got started.
User Response: Wait for the DSNI021I or the
DSNI005I message to be issued to the console. You
can periodically issue a DISPLAY DATABASE
RESTRICT command for the specified table space or
index space to determine whether the GRECP or LPL
exception state has been cleared.
256 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNI008I • DSNI012I
The module named modname has called a page
DSNI008I DATABASE VALIDATION PROCEDURE
checking routine, which discovered an error in the page.
name COULD NOT BE LOADED
The ERQUAL gives the trace id for the error in the
Explanation: The database validation procedure
page. If you suspect an error in DB2, refer to Part 2 of
identified by 'name' could not be loaded.
DB2 Diagnosis Guide and Reference for information on
User Response: Correct the name, and rerun the identifying and reporting the problem.
application.
System Action: Automatic recovery for the page has
been scheduled. The current agent will abend with
DSNI009I csect-name DATABASE EDIT reason code '00C90105', and a dump will be taken. The
PROCEDURE name COULD NOT BE page will be unavailable to this and other agents until
LOADED the online recovery has completed successfully.
Message DSNI010I will be issued, and a 'resource
Explanation: The database edit procedure identified
unavailable' condition will be returned to any agents that
by 'name' could not be loaded.
attempt to access the page. If the online recovery fails,
User Response: Correct the name, and rerun the the page will be marked as broken until it is repaired or
application. recovered (see message DSNI012I).
User Response: Save the dump. Watch for message
DSNI010I BROKEN PAGE ACCESSED TYPE type DSNB215I (indicating successful recovery of the page),
NAME name MODNAME csect-name or DSNI012I (indicating failure of recovery of the page).
CONN-ID id CORR-ID id LUW-ID id
Explanation: The page identified by TYPE and NAME DSNI012I PAGE LOGICALLY BROKEN TYPE type
could not be accessed, because it is marked as logically NAME name MODNAME modname
broken. ERQUAL erqual
The TYPE and NAME identify the resource that is Explanation: The page identified by TYPE and NAME
currently unavailable. The TYPE code identifies the type is logically incorrect. Additional attempts to access the
of the resource as well as the format and content of the page will be denied.
resource NAME.
The TYPE and NAME identify the resource that is
Type codes '00000301', '00000302', and '00000303' currently unavailable. The TYPE code identifies the type
apply to this message. Refer to “Appendix B. Problem of the resource as well as the format and content of the
determination” on page 1281 for a table showing all resource NAME. Refer to Table 3 on page 1283 for an
types and names. explanation of resource type codes.
'csect-name' has encountered the logically broken page. The module named 'modname' has called a page
CONN-ID, CORR-ID, and LUW-ID identify the thread checking routine, which discovered an error in the page.
involved in the problem. If the LUW-ID is an '*', the
The ERQUAL gives the trace id for the error in the
thread originated at this site. Correlation IDs beginning
page. If you suspect an error in DB2, refer to Part 2 of
with '0nn', where 'nn' is a number from 01 to 28, identify
DB2 Diagnosis Guide and Reference for information on
system agents.
identifying and reporting the problem. An ERQUAL of
User Response: If the TYPE is '00000300', use X'0000' indicates that an abend occurred during online
NAME to determine if the page is in an index space or recovery or recover utility. The page has been marked
a table space. Use the REPAIR utility to fix the broken as broken, and the recovery has failed.
page. If you suspect an error in DB2, refer to Part 2 of
System Action: The page is marked as logically
DB2 Diagnosis Guide and Reference for information on
broken, an 04E abend with reason code '00C90102' is
identifying and reporting the problem.
issued, and a dump is taken. The page will be
unavailable to this and other agents until it is repaired.
DSNI011I PAGE TEMPORARILY UNAVAILABLE
User Response: Save the dump for analysis by IBM
TYPE type NAME name MODNAME
Support Center. Copy the table space or index space to
modname ERQUAL erqual
another data set for later analysis by IBM Support
Explanation: The page identified by TYPE and NAME Center. If you suspect an error in DB2, refer to Part 2 of
has been temporarily marked as logically broken to DB2 Diagnosis Guide and Reference for information on
prevent access until it can be recovered. identifying and reporting the problem.
The TYPE and NAME identify the resource that is Operator Response: Notify the system programmer.
currently unavailable. The TYPE code identifies the type
System Programmer Response: See the Explanation
of the resource as well as the format and content of the
section of this message.
resource NAME. Refer to Table 3 on page 1283 for an
explanation of resource type codes.
Chapter 10. DB2 Messages 257
DSNI013I • DSNI016I
Problem determination” on page 1281 for an explanation
DSNI013I csect-name POTENTIALLY
of resource type codes.
INCONSISTENT DATA REASON reason
ERQUAL erqual TYPE type NAME name CONN-ID, CORR-ID, and LUW-ID together identify the
CONN-ID id CORR-ID id LUW-ID id agent involved in the problem. If the LUW-ID is an '*',
the thread originated at this site. Correlation IDs
Explanation: This message identifies a page with
beginning with '0nn' where 'nn' is a number from 01 to
potentially inconsistent data. This message is issued for
28, identify system agents.
each page involved in the current data manager
operation. The 'csect-name' in the message identifies System Action: The job abends with reason code
the CSECT that issued the message. 00C90101 after this message appears.
The 'erqual' in the message identifies the specific abend User Response: Notify the system programmer.
in the CSECT that caused this message to be issued.
This information and the reason code are used by IBM Operator Response: Collect the console output from
Support Center to identify the cause of the problem. the system on which the job was run for the period of
time spanning the failure. Save this output for use in
'name' and 'type' identify the page and its type. The problem determination.
TYPE code identifies the type, as well as the format and
content, of the NAME. Refer to “Appendix B. Problem System Programmer Response: See abend reason
determination” on page 1281 for a table showing all code 00C90101 for more information.
types and names. Problem Determination: In general, the data in these
CONN-ID, CORR-ID, and LUW-ID together identify the pages is fine. However, if problems are reported that
thread involved in the problem. If the LUW-ID is an '*', repeatedly involve the same pages or if the same pages
the thread originated at this site. Correlation IDs are reported by other abends, you might want to
beginning with '0nn' where 'nn' is a number from 01 to analyze the set of pages involved.
28, identify system agents. If you suspect an error in DB2, refer to Part 2 of DB2
For further information, see the Explanation section for Diagnosis Guide and Reference for information on
the abend reason code specified in this message. identifying and reporting the problem.
System Action: The job is abended shortly after this
message appears. DSNI015I OBJECT name IS ALREADY STARTED
FOR RW ACCESS. THE OBJECT WILL
User Response: Notify the system programmer. REMAIN STARTED FOR RW ACCESS
Operator Response: Collect the console output from Explanation: The -START DATABASE command with
the system on which the job was run. Save this output the ACCESS(FORCE) keyword was entered, but the
for use in problem determination. object specified was already started for read/write
access.
System Programmer Response: See the Problem
Determination section for the specific abend reason
code. DSNI016I RESOURCE TYPE type NAME name
MUST FIRST BE STOPPED BEFORE IT
Problem Determination: See the System Programmer
CAN BE STARTED IN A DIFFERENT
Response section of the abend reason code specified in
ACCESS MODE
this message.
Explanation: When issuing the -START DATABASE
command on the ROSHARE OWNER system, the
DSNI014I csect-name DATA IN USE DURING
object to be started must first be stopped before
ABEND REASON 00C90101 ERQUAL
changing access modes. For example, if a table space
erqual TYPE type NAME name CONN-ID
in a database defined as ROSHARE OWNER is started
id CORR-ID id LUW-ID id
for RW access, before it can be started for RO access it
Explanation: This message identifies a page that was must be stopped via the -STOP DATABASE command.
in use at the time an abend condition occurred with It can then be started for RO access via the -START
reason code 00C90101. This message is issued for DATABASE command.
each page involved in the current operation.
Severity: 8 (error)
ERQUAL identifies the specific abend in the CSECT
System Action: The -START DATABASE command is
that caused this message to be issued. This information
not allowed to proceed.
and the reason code are used by IBM Support Center
to identify the cause of the problem. User Response: Issue a -STOP DATABASE
command to stop the object before attempting to start it.
NAME and TYPE identify the page and its type. The
TYPE code identifies the type, as well as the format and
content, of the NAME. Refer to Table 3 in “Appendix B.
258 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNI017I • DSNI021I
The lock request is made again for this resource.
DSNI017I RESOURCE TYPE type NAME name IS
INCONSISTENT DUE TO ONE OR The 'type' and 'name' identify the resource trying to get
MORE PENDING STATES a lock. The 'type' code identifies the type of resource as
well as the format and content of the resource 'name'.
Explanation: There are two possible reasons for this
message: Refer to Table 3 in “Appendix B. Problem determination”
1. The header page of a table space, index, or partition on page 1281 for an explanation of resource type
belonging to a database defined as ROSHARE codes.
OWNER could not be marked as consistent during Severity: 0 (informational)
the processing of the STOP DATABASE command
because one or more of the following was true: System Action: The lock request is made again for
v The table space, index, or partition is in recovery the specified resource.
pending status.
v The table space, index, or partition is in check DSNI019I THE STOP COMMAND FOR OBJECT
pending status. name WAS OVERRIDDEN BY A START
v The table space, index, or partition has pages in FORCE. THE STOP COMMAND IS
the logical page list (LPL). IGNORED.
v The table space, index, or partition status has a Explanation: The object identified by 'name' was not
utility in progress (UTUT status on the output stopped because a START FORCE command on this
from a DISPLAY DATABASE command). object was subsequently issued and processed.
v The table space, index, or partition has a utility in This message is informational only.
progress that allows read-only access (UTRO on
the output from a a DISPLAY DATABASE Severity: 0 (informational)
command). System Action: The object is not stopped.
v An I/O error range exists.
2. A retained lock is held on the table space, index, or DSNI020I csect-name UNABLE TO DRAIN
partition. The retained lock could be signifying a RESOURCE TYPE type NAME name.
pending status. WILL RETRY DRAINING THE
RESOURCE.
If the STOP DATABASE command was issued without
specifying the SPACENAM parameter, then one or more Explanation: The resource identified by 'type' and
of the conditions stated above is true for one or more 'name' could not be drained. The 'type' code identifies
table spaces, indexes, or partitions in the specified the type of resource as well as the format and content
database. of the resource 'name'. The drain request is made again
for this resource.
Severity: 4 (warning)
Refer to Table 3 in “Appendix B. Problem determination”
System Action: For case 1, if the STOP DATABASE on page 1281 for an explanation of resource type
command was specified with the SPACENAM codes.
parameter, the table space, index, or partition is
stopped. DB2 does not allow access to an inconsistent System Action: The drain request is made again for
table space, index, or partition by any ROSHARE READ the specified resource.
system.
For case 2, no access to an inconsistent table space, DSNI021I csect-name GRECP OR LPL RECOVERY
index, or partition is allowed until the retained lock is FOR START DATABASE COMMAND-ID
released by the failed system at completion of its = command-id TYPE type NAME name
restart. HAS COMPLETED SUCCESSFULLY.
User Response: Issue a DISPLAY DATABASE Explanation: The group buffer pool recovery pending
command to display the status of the object in question. (GRECP) or logical page list (LPL) exception state of
Resolve the pending states and then reissue the STOP the table space or index space identified by TYPE and
DATABASE command to ensure that the consistency NAME has been cleared.
indicator is reset. The 'command-id' is a decimal number that represents a
START DATABASE command.
DSNI018I UNABLE TO GET LOCK FOR Refer to “Resource types” on page 1283 for an
RESOURCE TYPE type NAME name. explanation of resource type codes.
WILL RETRY TO GET LOCK.
This message is always preceded by the DSNI006I
Explanation: The resource identified by 'type' and message, which indicates the beginning of the LPL or
'name' could not be locked because of lock contention.
Chapter 10. DB2 Messages 259
DSNI022I • DSNI030I
GRECP recovery for the object.
DSNI025I csect-name THE FAST LOG APPLY
System Action: The identified table space or index PROCESS REQUIRES aaaaaaaa BYTES
space is started normally. OF STORAGE, BUT GOT ONLY
bbbbbbbb BYTES
DSNI022I csect-name LPL or GRECP RECOVERY Explanation: The Fast Log Apply process could not
LOG APPLY FOR START DATABASE obtain all the required storage. However, the storage
COMMAND-ID = command-id AT acquired is enough for the Fast Log Apply process to
LOGPOINT xxx TO LOGPOINT yyy continue.
Explanation: This message periodically shows the Severity: 0 (informational)
progress of the LPL or GRECP recovery of a START
System Action: The Fast Log Apply process
DATABASE command.
continues with the smaller amount of storage for the log
The 'command-id' is a decimal number that represents a buffers.
START DATABASE command.
The 'xxx' is the LOGPOINT of the log record currently DSNI026I csect-name THE FAST LOG APPLY
being processed. The 'yyy' is the LOGPOINT of the last PROCESS IS DISABLED BECAUSE
log record that will be applied in this recovery. The ALL OF THE ALLOWABLE STORAGE
value of logpoint is RBA in a non-data sharing IS EXHAUSTED
environment and LRSN in a data sharing environment.
Explanation: There is no ssnmDBM1 storage
This message, in combination with message DSNI006I, available for the Fast Log Apply process to use. There
DSNI005I or DSNI021I, provides the LPL or GRECP are too many jobs (RECOVER or -START DB
recovery information for a START DATABASE command command) running in parallel.
identified by the 'command-id'.
Severity: 0 (informational)
System Action: The LOGAPPLY phase continues
System Action: The recovery of the requested objects
normally.
continues without the Fast Log Apply process.
DSNI023I csect-name PAGE SET dbnam.psnam
DSNI027I csect-name THE FAST LOG APPLY
PART part IS RESTP ON BEHALF OF
PROCESS IS DISABLED BECAUSE IT
UR urid. BACKOUT TO RBA rba IS
IS UNABLE TO ACQUIRE THE
REQUIRED.
MINIMUM REQUIRED STORAGE
Explanation: ’Status’ is either RESTP (Restart
Explanation: There is not enough ssnmDBM1 storage
Pending) or AREST (Advisory Restart Pending). This
available or reserved for the Fast Log Apply process to
message indicates that the named UR has backout
use.
work pending against the named page set or partition.
The backout work for this UR against this page set or Severity: 0 (informational)
partition will be complete once backward processing of
System Action: The recovery of the requested objects
the log reaches the identified RBA.
continues without the Fast Log Apply process.
For non-partitioned page sets, the partition given in the
message is the string n/a.
DSNI030I csect-name BACKOUT PROCESSING IS
CONTINUING BEYOND THE
DSNI024I csect-name BACKOUT PROCESSING IS REQUESTED LIMIT DUE TO CATALOG
COMPLETE FOR PAGE SET OR DIRECTORY ACTIVITY OF UR urid.
dbnam.psnam PART part.
Explanation: The number of log records requested to
Explanation: This message indicates that backout be processed during restart’s backward phase have
processing is complete for the named table space, been processed. Under other circumstances further
index space, or partition. If the object was in restrictive backout processing would be postponed. However,
restart pending state, that state is lifted. If the object because the indicated UR has catalog or directory
was in an advisory restart pending state, locks held on updates that are not backed out yet (and because
the object on behalf of postponed abort URs by the DB2 backout against catalog or directory page sets cannot
member issuing the message are released. The be postponed), backout processing is continuing. It will
advisory restart pending state is lifted if the DB2 continue until this UR’s backout is complete.
member issuing the message is the only member still
System Action: Backout processing continues.
contributing to the state.
For non-partitioned page sets, the partition given in the
message is the string ″n/a″.
260 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNI031I • DSNI034I
| why the request was rejected.
| DSNI031I csect-name - LOCK ESCALATION HAS
| OCCURRED FOR RESOURCE NAME = | token Identifies a thread whose processing you
| name, LOCK STATE = state, PLAN | requested to cancel. The token is a 1- to
| NAME : PACKAGE NAME = id1:id2, | 15-digit decimal number.
| STATEMENT NUMBER = id3,
| CORRELATION-ID = id4, | reason Indicates the reason why the command failed.
| CONNECTION-ID = id5, LUW-ID = id6, | System Action: Processing terminates normally.
| THREAD-INFO = id7:id8:id9:id10
| User Response: The reason code specifies the action
Explanation: Lock escalation balances concurrence | to be taken.
with performance by using page locks while a process
accesses relatively few pages, then changing to table
space or table locks when the process accesses a | DSNI033I csect-name PAGE SET dbname.psname
number of pages that exceeds a defined threshold | PART part IS MARKED REFP AND
(LOCKMAX) for the tablespace. | status ON BEHALF OF UR ur-id.
| RECOVERY TO logout IS REQUIRED
| name The name of the escalated resource.
| Explanation: No further backout processing will be
state The lock state (after escalation) of the | attempted on the specified page set or partition
escalated resource. | because backout for unit of recovery ur-id has been
id1 The name of the executing plan associated | cancelled. The specified page set or partition is marked
with this thread. | Refresh pending (REFP).
id2 The name of the executing package (if any) | Severity: 0 (informational)
associated with this thread. | User Response: If the object in Refresh pending
id3 The statement number of the executing SQL | status is a table space, you can resolve the REFP,LPL
statement associated with this plan. | state of the specified page set or partition in more than
| one way. You can run the RECOVER utility to perform
id4 The correlation identifier of the thread | point-in-time recovery, or run the LOAD utility with the
associated with the escalated resource. | REPLACE option to resolve the REFP,LPL state.
id5 The connection identifier of the thread | If page set is an index space, run the REBUILD utility to
associated with the escalated resource. | perform point-in-time recovery and resolve the
id6 The logical-unit-of-work identifier of the thread
| REFP,RBDP or REFP,LPL status. You can use the
associated with the escalated resource.
| RBA;LRSN value indicated in this message for
| point-in-time recovery.
id7 Thread Info - the primary authorization_id
associated with the thread.
# DSNI034I csect-name TABLE SPACE
id8 Thread Info - Work station name of the end # table-space-name IS IN AUX WARNING
user’s work station. An asterisk (*) indicates # STATE
that it is not relevant to the thread or was not
provided by the client.
# Explanation: DB2 attempted to recover table space
# table-space-name, but no log records exist because the
id9 Thread Info - User-Id of the end user. An # table space was created with the LOG NO option. The
asterisk (*) indicates that it is not relevant to # table space is placed in an auxiliary warning state. You
the thread or was not provided by the client. # can use SQL statements to update the LOB values that
# are in error or to delete the row that contains the LOB
id10 Thread Info - Application name of the end
# values. In addition, you can use SQL statements to
user’s application. An asterisk (*) indicates that
# access valid LOBs. However, you cannot use SQL
it is not relevant to the thread or was not
# statements to retrieve a LOB value that is not valid.
provided by the client.
# Severity: 0 (informational)
System Action: Escalation has occurred for the
specified object # System Action: DB2 marks the LOB values that are
# in error as not valid. Processing continues.
| DSNI032I csect-name CANCEL THREAD # Programmer Response: Use SQL statements to
| NOBACKOUT COMMAND FAILED FOR # update or delete the LOB values in error. Use the
| THE THREAD = token REASON = # CHECK LOB utility to verify that all errors were
| reason # corrected and to reset the auxiliary warning state. The
# auxiliary warning state can also be reset using the
| Explanation: DB2 displays this message when it
# REPAIR utility with SET NOAUXWARN.
| cannot grant a request to cancel a thread without
| backing out data changes. The reason code explains
Chapter 10. DB2 Messages 261
DSNI035I • DSNI038I
DSNI035I csect-name THE REAL-TIME
STATISTICS COLLECTION PROCESS
IS STOPPED
Explanation: The statistics database stopped
successfully, and the real-time statistics process is
halted.
Severity: 0 (informational)
System Action: DB2 will not externalize in-memory
statistics.
DSNI036I csect-name THE REAL-TIME
STATISTICS COLLECTION PROCESS
IS DISABLED
Explanation: An error prevents DB2 from externalizing
the in-memory statistics. The error is generally a
persistent error and must be remedied before the
process can be enabled. Look for prior messages to
identify the nature of the problem.
System Action: The statistics database is implicitly
stopped and no further attempt will be made to
externalize the in-memory statistics.
Operator Response: Notify the system programmer.
System Programmer Response: Inspect the console
for prior messages and refer to those messages for
problem determination.
DSNI037I csect-name THE REAL-TIME
STATISTICS COLLECTION PROCESS
COULD NOT ACCESS AN OBJECT IN
THE REAL-TIME STATISTICS
DATABASE
Explanation: An error prevents DB2 from externalizing
the in-memory statistics. An attempt failed to insert,
update, or delete a row in the statistics database. The
error is generally transient (lock time-out or resource
unavailable). If the operation is retried, it is likely to
succeed.
System Action: The statistics are kept in-memory until
the next opportunity to externalize them.
DSNI038I csect-name THE REAL-TIME
STATISTICS COLLECTION PROCESS
IS ENABLED
Explanation: The statistics database started
successfully. The required onject descriptors in the
statistics database exist and have the correct attributes.
DB2 proceeds to externalize in-memory statistics for all
modified objects.
Severity: 0 (informational)
System Action: The database is started read/write.
262 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 11. DSNJ... Messages
bootstrap data set (BSDS) has been updated with the
DSNJ001I csect-name CURRENT COPY n ACTIVE
information in the message:
LOG DATA SET IS DSNAME=...,
DSNAME
STARTRBA=..., ENDRBA=...
The name of the archive log data set.
Explanation: This message is generated for one of STARTRBA
two reasons: The starting RBA contained in the volume.
1. When the log manager is initialized, it sends this ENDRBA
informational message to identify the current active The ending RBA contained in the volume.
log data sets (copy-1 and, if dual logging is used, STARTLRSN
copy-2). The starting LRSN contained in the volume for
data sharing systems.
2. When the current active log data set is full, DB2 will
ENDLRSN
switch to the next available active log data set. This
The ending LRSN contained in the volume for
message identifies the next available active log data
data sharing systems.
set which will be used for logging.
STARTTIME
The starting store-clock value of the log
The value specified by the STARTRBA=value keyword records in the volume for non-data sharing
is the RBA of the first byte of log data in the named systems.
data set. The value specified by the ENDRBA=value ENDTIME
keyword is the RBA of the last possible byte in the data The ending store-clock value of the log records
set. These values may later be needed for a conditional in the volume for non-data sharing systems.
restart. UNIT The device unit to which the data set was
System Programmer Response: None required. allocated.
However, if recovery is required, information from this COPYnVOL
message may be required as input to the change log The name of the volume. This message
inventory (DSNJU003) utility. keyword is displayed as COPY1VOL if this is
the copy-1 archive log data set, and as
COPY2VOL if this is the copy-2 archive log
DSNJ002I FULL ACTIVE LOG DATA SET data set.
DSNAME=..., STARTRBA=..., VOLSPAN
ENDRBA=... An indicator to denote one of four conditions:
Explanation: This message is sent at the time the log v If '00', the data set is entirely contained on
manager fills an active log data set and switches to a the volume specified by 'COPYnVOL'.
new empty data set. The message shows the name and v If '01', this is the first entry of a multivolume
log RBA range of the full data set. data set.
v If '11', this is the middle entry of a
System Programmer Response: None required. multivolume data set.
However, if recovery is required information from this v If '10', this is the last entry of a multivolume
message may be required as input to the change log data set.
inventory (DSNJU003) utility. CATLG An indicator to denote one of two conditions:
v If 'NO', the archive log data set is
DSNJ003I csect-name FULL ARCHIVE LOG uncataloged.
VOLUME DSNAME=..., STARTRBA=..., v If 'YES', the archive log data set is
ENDRBA=..., STARTxxxx=..., cataloged.
ENDxxxx=..., UNIT=..., COPYnVOL=...,
VOLSPAN=..., CATLG=... The BSDS is automatically updated with the information
contained in this message; however, if recovery is
Explanation: Offloading for the specified archive log required, information from this message may be
data set was successfully completed for the given required as input to the change log inventory
volume. If the data set spans multiple tape volumes, this (DSNJU003) utility.
message is generated for each tape volume. If the data
set spans multiple dasd volumes, only one message will
be generated displaying the first VOLSER appended DSNJ004I ACTIVE LOG COPY n INACTIVE, LOG
with a ’+’ to indicate the data set spans multiple IN SINGLE MODE, ENDRBA=...
volumes. ’xxxx’ is replaced by either TIME or LRSN. Explanation: This message is sent when the dual
System Action: An archive log data set has been active logging option is selected and copy 'n' becomes
created, and the archive log data set inventory in the inactive. A log copy becomes inactive when the next
active log data set is not ready when required. ENDRBA
© Copyright IBM Corp. 1982, 2001 263
DSNJ005I • DSNJ008E
is the last byte of log data written on copy 'n'. This is
DSNJ007I csect-name OPERATOR CANCELED
usually caused by a delay in off-load.
MOUNT OF ARCHIVE VOL SER= volser
System Action: The log is switched to single mode
Explanation: If the operator answers 'N' to the WTOR
until the next data set for copy 'n' is ready for logging.
message DSNJ009I, this message is issued. The
If DB2 is shut down or abends while in single mode with variable 'volser' is the volume serial of an archive log
the ZPARM option still set for dual active data sets, the volume required for the read request.
previous state of the active log data sets determines
System Action: The read request for the archive log
what happens when DB2 is started, as follows:
volume fails. If the request was issued with the
v If fewer than two data sets are available (not flagged COND=YES parameter, return code 12 and reason
as STOPPED) for each set of active logs, DB2 code 00D1032B are returned to the requester.
startup terminates and message DSNJ112E is Otherwise, DB2 abends with reason code 00D1032B.
issued.
v If an active log data set is in NOTREUSABLE state,
DSNJ008E nn OF mm ACTIVE LOGS ARE FULL.
DB2 can be started in single logging mode, but dual
ssname NEEDS ARCHIVE SCRATCH.
mode takes effect when the other active log data set
REPLY Y WHEN DEVICE READY OR N
becomes available after offloading.
TO CANCEL.
Operator Response: Execute an MVS Display
Explanation: The installation has requested a WTOR
System Requests command (D R,L for example) to
before archive log data set allocation. DB2 needs a
ensure that there are no outstanding requests that are
scratch volume for offloading an active log data set.
related to the log off-load process. Take the necessary
'ssname' is the name of the DB2 subsystem. 'nn' is the
action to satisfy any requests, and permit off-load to
number of full active log data sets. 'mm' is the total
continue.
number of active log data sets.
System Programmer Response: If the switch to
System Action: The off-load task waits for the
single mode was caused by the lack of a resource
operator’s reply.
required for off-load, the necessary resource should be
made available to allow off-load to complete and thus Operator Response: The operator has three options:
permit dual logging to proceed. If recovery is required, v Get a scratch volume ready, make sure there is an
information from this message might be required as available unit for the volume, and reply 'Y'. DB2 then
input to the change log inventory (DSNJU003) utility. continues with the off-load.
v Determine from the number of active log data sets
DSNJ005I ACTIVE LOG COPY n IS ACTIVE, LOG available whether the off-load can be delayed until
IN DUAL MODE, STARTRBA=... the next time an active log data set becomes full. If
the process can be delayed, then reply 'N'.
Explanation: This message is sent when copy 'n' of
the log becomes active after previously being flagged as This response has two possible effects.
inactive. STARTRBA is the RBA of the first byte of log – If dual archive logging is in effect and this
data written on copy 'n' after it was activated. allocation is for a copy 1 archive data set, the 'N'
response delays the off-load process until the next
System Programmer Response: None required.
active log data set becomes full.
However, if recovery is required, information from this
message may be required as input to the change log – However, if the copy 1 archive data set has
inventory (DSNJU003) utility. already been allocated and this request is for copy
2, the 'N' response causes the off-load to switch to
single archive mode (the switch is for this data set
DSNJ006I ALLOCATION FOR NEW ARCHIVE LOG only).
DATA SET HAS BEEN CANCELLED BY
v Defer giving a response. This causes off-load to wait
OPERATOR.
before processing. However, because off-load is a
Explanation: This message is sent if the operator separate service task, the wait does not affect DB2
answers 'N' to the WTOR message DSNJ008E. performance.
System Action: If the allocation is for copy 1 archive
If offloading to DASD, an error has occurred attempting
log data set, off-load terminates processing until the
to allocate an archive log data set. Reply 'Y' to receive
next time it is activated. If copy 1 has already been
the error messages.
allocated and this request is for copy 2, off-load
switches to single off-load mode for this data set only.
264 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ009E • DSNJ013I
(DSNJU003) utility, check whether the time and date in
DSNJ009E ssname NEEDS VOL SER=nnnnnn.
the message agree with when you created that record.
REPLY Y TO CONTINUE OR N TO
If they do, reply 'Y' to the outstanding WTOR. If they do
CANCEL
not, reply 'N' and investigate the discrepancy.
Explanation: The installation requested WTOR before
archive log data set allocation. DB2 needs the specified
DSNJ012I ERROR ccc READING RBA rrr IN DATA
archive volume for a read operation. The subsystem
SET ddd CONNECTION-ID=xxxxxxxx,
name is 'ssname'.
CORRELATION-ID=yyyyyyyyyyyy
System Action: The archive log read service task
Explanation: While scanning log records read into a
waits for the operator’s reply. This wait affects the agent
buffer, the log manager detected a logical error with
for which the log read was issued and any other agents
reason code 'ccc'. 'rrr' is the log RBA of the segment in
that might be waiting on the log read service task
the buffer at which the error was detected. 'ddd' is the
queue.
name of the active or archive log data set from which
Operator Response: Locate the requested volume, the record was read. If 'ddd' is blank, the data was read
ensure that a device is available, and reply 'Y'. DB2 from an active log output buffer.
continues with dynamic allocation and then begins
The connection and correlation IDs identify the user or
reading the log.
application that encountered the problem. Messages
If dual archiving is in effect, a response of 'N' causes that have the same connection ID and correlation ID
archive read to reissue the message for the copy 'Z' relate to the same user. Correlation IDs beginning with
copy 2 archive VOLSER with the same RBA range. A '0nn' where 'nn' is a number from 01 to 28, identify
response of 'N' to this second WTOR, or to the initial system agents.
WTOR for single archiving, causes the archive read
Refer to Part 4 (Volume 1) of DB2 Administration Guide
service task to fail with unpredictable results.
for information about recovery from log failures.
System Action: The application program that invoked
DSNJ010I csect-name INVALID RESPONSE. WTOR
the log manager is terminated with reason code 'ccc'.
WILL BE REPEATED.
However, information in this message may be useful in
Explanation: A WTOR was issued during archive data diagnosing the abend that will follow.
set allocation. The user did not respond correctly to the
message. Either 'Y' or 'N' must be entered.
DSNJ013I TERMINAL ERROR ccc IN BUFFER rrr
System Action: The original WTOR is repeated. BEFORE ACTIVE LOG WRITE
Operator Response: Reply as indicated in the Explanation: A scan of the log output buffer just prior
repeated message. to writing the buffer detected an inconsistency in the log
data. 'ccc' is the abend reason code associated with the
SDUMP that is produced. 'rrr' is the log RBA at which
DSNJ011I CONDITIONAL RESTART RECORD rrr
the error was detected.
CREATED AT .... WAS FOUND. REPLY
Y TO USE, N TO CANCEL System Action: DB2 will terminate with a dump, and
will not write the damaged buffer to either COPY 1 or
Explanation: When the log manager was initialized, a
COPY 2 active log data set.
conditional restart control record was found in the
bootstrap data set. Both the record identifier (a 4 byte Operator Response: Notify the system programmer.
hexadecimal number) and the creation time stamp Start DB2 after it terminates.
(yy.ddd hh:mm) are displayed to help identify the
System Programmer Response: Because the
conditional restart record which will be used. If you want
damaged buffer has not been written to a log data set,
a conditional restart using that record, reply 'Y' to the
DB2 may be restarted. No corrective action is required.
message. Otherwise, reply 'N' and notify the system
programmer. Problem Determination: In the DB2 formatted block
section of the dump, locate the chain of LBCE blocks.
System Action: If 'Y' is the response, DB2 is started
Those are log buffer control elements, and each LBCE
conditionally, using the record found. If 'N' is the
controls one 4KB log output buffer. LBCEBUFF, at offset
response, DB2 startup is terminated.
X'20' in the LBCE, points to the buffer, which is always
Operator Response: If a DB2 conditional restart is to on a 4KB boundary. The log RBA of the first byte of the
be done and if the date and time displayed are correct, buffer is in a 6-byte field at offset X'FF2' in the buffer
then reply 'Y' to the outstanding message. If you are not itself. The layout of the buffer is described by the
sure, then contact the system programmer. DSNDLCID mapping macro. The header of each record
within the buffer is described by the DSNDLRH mapping
System Programmer Response: If a normal restart of
macro. Locate the buffer that contains the log RBA from
DB2 has failed and you have created a conditional
the message and find the damage by referring to the
restart control record with the change log inventory
Chapter 11. DB2 Messages 265
DSNJ014I • DSNJ030I
description of the reason code later in this book. Operator Response: To continue this CSRONLY
processing, reply 'Y' to this message. If you are not
sure, contact the system programmer.
DSNJ014I TERMINAL ERROR ccc IN BUFFER rrr
AFTER ACTIVE LOG WRITE. System Programmer Response: The conditional
restart control record will not be deactivated at the end
Explanation: A scan of the log output buffer, after
of the CSRONLY processing. To deactivate this record,
writing to the COPY 1 active log data set and before
either cancel this record or create a new record. Refer
writing to COPY 2, detected an inconsistency in the log
to Part 4 (Volume 1) of DB2 Administration Guide for
data. 'ccc' is the abend reason code associated with the
more information.
SDUMP that is produced. 'rrr' is the log RBA at which
the error was detected.
DSNJ020I csect-name RECEIVED REPLY OF N TO
System Action: DB2 will terminate with a dump, and
msg-num. SUBSYSTEM STARTUP IS
will not write the damaged buffer to the COPY 2 data
TERMINATED.
set.
Explanation: The operator chose to terminate DB2
Operator Response: Notify the system programmer.
startup by answering 'N' to 'msg-num'.
System Programmer Response: The block
System Action: DB2 will not restart.
containing the indicated log RBA may be damaged. The
buffer was found to be in error at the completion of the Operator Response: To restart DB2, follow the
write to the COPY 1 data set of the active log. 'operator response' of 'msg-num'.
If dual active logs are being used, use print log map
(DSNJU004) to list the active log data sets for both DSNJ030I RBA RANGE startrba TO endrba NOT
copies of the active log. Find the COPY 2 data set with AVAILABLE IN ACTIVE LOG DATA
the corresponding RBA, and copy that data set (using SETS
access method services REPRO) to the COPY 1 data
Explanation: Previous errors have made the active
set. Start DB2.
log data set(s) that contain the relative byte address
If only a single active log is used, contact the IBM (RBA) range reported in the message unavailable to
support center for assistance. An attempt to start DB2 DB2. The status of these log(s) is STOPPED in the
may succeed if the damage to the buffer occurred after bootstrap data set (BSDS).
completion of the write to DASD.
System Action: DB2 terminates with a dump.
Problem Determination: In the DB2 formatted block
Operator Response: Notify the system programmer.
section of the dump, locate the chain of LBCE blocks.
Those are log buffer control elements, and each LBCE System Programmer Response: The log RBA range
controls one 4KB log output buffer. LBCEBUFF, at offset must be available for DB2 to be recoverable. Correct
X'20' in the LBCE points to the buffer, which is always previous errors and restore the active log data set(s)
on a 4KB boundary. The log RBA of the first byte of the that contain the RBA range reported in the message.
buffer is in a 6-byte field at offset X'FF2' in the buffer v If the log data set(s) are recoverable, the active log
itself. The layout of the buffer is described by the data set inventory in the BSDS must be modified to
DSNDLCID mapping macro. The header of each record reset the STOPPED status. Use the print log map
within the buffer is described by the DSNDLRH mapping (DSNJU004) utility to obtain a copy of the BSDS log
macro. Locate the buffer that contains the log RBA from inventory. Next, use the change log inventory
the message and find the damage by referring to the (DSNJU003) utility to delete the active log data sets
description of the reason code later in this book. marked STOPPED (use the DELETE statement), and
then add them again (use the NEWLOG statement).
DSNJ015I CSRONLY PROHIBITS LOG The starting and ending RBA for each active log data
ALTERATIONS. RECORD rrr CREATED set must be specified on the NEWLOG statement
.... REPLY Y TO USE, N TO CANCEL. when the log(s) are added back to the BSDS using
the DSNJU003 utility.
Explanation: During DB2 startup, the log manager
v If the log data set(s) are not recoverable, it is
found an inactive conditional restart control record in the
necessary to conditionally restart DB2. See Part 4
bootstrap data set. Because this control record indicates
(Volume 1) of DB2 Administration Guide for additional
CSRONLY, no log data sets will be modified. If log
information on conditional restart and recovering from
truncation was specified, it will be simulated. Only the
log failures.
first phase of restart (current status rebuild) will be
performed. The hexadecimal identifier (rrr) and creation Problem Determination: Examine previous messages
timestamp (yy.ddd hh:mm) identify the record found. to determine the reason the active log data set(s) are
unavailable to DB2.
System Action: A 'Y' reply will continue the
conditional restart. A 'N' reply will terminate DB2 startup.
266 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ031I • DSNJ071I
| DSNJ031I DSNJ050I LOAD MODULE DSNJL003 DOES NOT
HAVE RMODE(24) ATTRIBUTE
| csect-name WARNING - UNCOMMITTED UR HAS WRITTEN nn LOG RECORDS -
Explanation: The named load module was not link
| CORRELATION NAME = xxxxxxxxxxxx
edited with the required RMODE(24) attribute.
| CONNECTION ID = yyyyyyyy
| LUWID = LOGICAL-UNIT-OF-WORK-ID=tokenSystem Action: DB2 startup is terminated.
| PLAN NAME = xxxxxxxx
Operator Response: Notify the system programmer of
| AUTHID = xxxxxxxx
the failure.
| END USER ID = xxxxxxxx
| TRANSACTION NAME = xxxxxxxx System Programmer Response: Verify that all
| WORKSTATION NAME = xxxxxxxx installation and maintenance activities against this
module were executed using SMP. Verify that the JCLIN
| Explanation: This message indicates that a unit of
for SMP includes the correct RMODE control statement,
| recovery (UR) reached the threshold number of log
and that the Linkage Editor provided with the Data
| records written without a COMMIT or ROLLBACK. This
Facility Product (DFP) for the version of MVS being
| threshold was defined during installation.
used was invoked by SMP for the link edits. Correct the
| The value nn is cumulative, and indicates the number of procedure or JCL which caused the error and rerun the
| log records that were written since the beginning of the necessary SMP jobs.
| UR.
Problem Determination: The MVS service aid
| CORRELATION name, CONNECTION ID, and LUWID AMBLIST provides Linkage Editor module attributes in
| together identify a thread associated with the UR. token the summary section of the LISTLOAD function output.
| is a unique token number associated with the LUWID. If
| the LUWID is an '*', it indicates that the thread
DSNJ070I csect-name ARCHIVE LOG DSN PREFIX
| originated at this site.
NOT IN PROPER FORMAT TO RECEIVE
| PLAN NAME and AUTHID further identify the thread TIMESTAMP DATA. TIMESTAMPING OF
| associated with the UR. dsnname BYPASSED
| If the thread’s creator included End User information, Explanation: By way of a ZPARM parameter, the user
| then DB2 displays the End User’s ID, TRANSACTION has specified that the date and time of creation of an
| NAME, and WORKSTATION NAME. Otherwise, these archive log data set be included as part of the archive
| fields will contain an '*'. log data set name (DSN). To accomplish this, the DB2
subsystem requires that the length of the archive log
| System Action: DB2 continues processing. If statistics
data set name prefix not exceed 19 characters if using
| class 3 is active, IFCID 0313 is written. This message
the standard DATE formate (YYDDD), or 17 characters
| will be repeated each additional time the threshold is
if using the extended DATE format (YYYYDDD). If the
| reached.
prefix requirement is not met, this message is issued
| System Programmer Response: Consult with the just prior to the allocation of the archive log data set
| application programmer to determine if this is a problem specified in the message.
| UR. See Part 4 (Volume 1) of DB2 Administration Guide
System Action: The archive log data set will be
| for more information about problems caused by
allocated using the archive log prefix. However, the
| uncommitted UR’s.
archive log DSN will not contain the date and time as
| If an application program caused the UR to reach its the user requested.
| threshold number of log records, you can use CANCEL
Operator Response: Notify the system programmer.
| THREAD to cancel the UR. If you cancel an
| uncommitted UR, DB2 will undo the changes. The System Programmer Response: The ZPARM
| amount of time required for this process depends on the parameters for the log archive function must be
| amount of work done by the UR. The amount of time changed. Specifically, the TSTAMP and ARCPFXn fields
| required for this process depends on the amount of are not consistent with one another. For details
| work done by the UR. concerning the course of action required to eliminate
this problem, refer to Part 2 of DB2 Installation Guide,
| Programmer Response: Ensure that the application
under the DSNTIPH panel and DSN6ARVP macro
| commits frequently enough, or consult with your DB2
subtopics.
| administrator about decreasing the frequency of the
| check.
DSNJ071I csect-name TIMER FAILURE CAUSED
TIMESTAMPING OF ARCHIVE dsname
TO BE BYPASSED
Explanation: By way of a ZPARM parameter, the user
has specified that the date and time of creation of an
Chapter 11. DB2 Messages 267
DSNJ072E • DSNJ073I
archive log data set be included as part of the archive 8 (X'08')
log data set name (DSN). However an attempt to get The device type (unit name) on which the
the current date and time from the system failed. This archive log data set is to be allocated is
message is issued just prior to the allocation of the specified by the user in the DB2 system
archive log data set specified in the message. parameters. This device type (unit name) could
not be found in the MVS eligible device table
System Action: The archive log data set will be
(EDT).
allocated using the archive log prefix. However, the
archive log DSN will not contain the date and time as 32 (X'20')
the user requested. DB2 was able to obtain a list of devices
corresponding to the device type (unit name)
specified in ZPARMs. However, it was
DSNJ072E ARCHIVE LOG DATA SET dsname HAS
determined by DB2 that this list contained a
BEEN ALLOCATED TO NON-TAPE
mixture of tape and nontape devices.
DEVICE AND CATALOGED. ZPARM
CATALOG OPTION OF 'NO' HAS BEEN 40 (X'28')
OVERRIDDEN. The device type (unit name) specified by the
user in ZPARMs is valid. However, no devices
Explanation: By way of an archive log DSNZPARM
are currently associated with the given device
parameter, the user specified that all archive log data
type (unit name).
sets should be uncataloged (CATLG=NO). However,
DB2 requires that all archive log data sets allocated to 44 (X'2C')
nontape devices must be cataloged. The archive log The device type (unit name) specified by the
data set specified by 'dsname' has been allocated to a user in ZPARMs is valid. However, no DASD
nontape device, and has thus been cataloged. The volumes are available with a volume use
user’s DSNZPARM CATLG setting of 'NO' has been attribute of 'storage'.
overridden.
48 (X'30')
System Action: The archive log data set has been The CVT indicates that UCB services are not
allocated to a nontape device, and has been cataloged. available.
The DSNZPARM CATLG=NO setting has been
System Action: This message is issued by DB2 after
overridden. The BSDS reflects that the data set has
the SVC99 text entries are built, but prior to the
been cataloged.
allocation of the new archive log data set. As a result of
Operator Response: Notify the system programmer. the error, the dynamic allocation of the archive log data
set will be attempted using standard default values. The
System Programmer Response: The DSNZPARM
standard default values are generally acceptable;
parameters for the log archive function must be
however, the allocation may fail or the subsequent
changed. Specifically, the ARCHCTLG and ARCHDEVT
off-load may produce undesirable processing results.
fields are not consistent with one another. For details
For example:
concerning the course of action required to eliminate
this problem, refer to Part 2 of DB2 Installation Guide v A return code of 4 or 44 (X'2C') will foretell an
under the DSNTIPA panel and DSN6ARVP macro allocation error (DSNJ103I) when the SVC99 is
subtopics. issued for the archive data set.
v Off-load processing to tape may fail. DB2 uses a
volume count of 20 when allocating to tape, and uses
DSNJ073I LOG ARCHIVE UNIT ALLOCATION
the standard MVS volume count default of 5 volumes
FAILURE DETECTED, RETURN
when writing to nontape devices. In the case of most
CODE=nnnn. ALLOCATION OR
of the above errors, it would be impossible for the
OFF-LOAD OF ARCHIVE LOG DATA
DB2 subsystem to determine the device type on
SET MAY FAIL.
which the data set is to be allocated. Therefore, the
Explanation: While building the SVC99 text entries to standard MVS default is assumed for the volume
dynamically allocate a new archive log data set, a unit count. If the data set is successfully allocated to a
allocation failure was detected. This message is only tape device, and the volume of data is such that
generated when a trace for IFCID 320 is active . The more than five volumes will be used for the archive
reason code, indicated by 'nnnn' in the message, further data set, the off-load processing will receive an MVS
clarifies the problem as follows: ABEND 837-08 with message IEC028I when
attempting to write to the sixth tape volume.
4 (X'04')
The device type (unit name) on which the v Off-load processing to a direct access device may
archive log data set is to be allocated is fail. When allocating a new archive log data set on a
specified by the user in the DB2 system direct access device, the DB2 subsystem will use a
parameters. No UCBs could be found for the unit count to facilitate multivolume archive data sets.
device type (unit name). With most of the above errors, it may be impossible
for the DB2 subsystem to correctly determine the
268 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ097E • DSNJ100I
type of device on which the data set is to be System Programmer Response: Run the Change
allocated. Therefore, the standard default (1) is Log Inventory (DSNJU003) utility with the CRESTART
assumed for the unit count. If the data set is CANCEL parameters to cancel the conditional restart
successfully allocated to a direct access device, and control record. Restart DB2.
during the off-load processing it becomes necessary
to extend the data set to another device, the off-load
DSNJ098E csect-name CRCR ENDLRSN OF rrr IS
processing will receive an MVS B37 (out of space)
xxx THAN ANY KNOWN LRSN, NO
ABEND, and the archive log data set will be
TRUNCATION WILL OCCUR
deallocated.
Explanation: Truncation cannot take place because
Operator Response: Notify the system programmer.
the CRCR ENDLRSN is not in the range of LRSN
System Programmer Response: The required action values known to either the active or archive logs. rrr is
is based on the return code indicated in the message. the end LRSN specified in the active record. xxx is
replaced by either HIGHER or LOWER. If HIGHER is
4 (X'04') or 8 (X'08')
the case, the CRCR ENDLRSN is higher than the LRSN
The most likely cause is an incorrect
of the last record written to the log data sets. LOWER
specification in the archive log ZPARMs
means the CRCR ENDLRSN is lower than the starting
(DSNTIPA panel). Correct the DEVICE TYPE
LRSN of the oldest archive data set.
field. If the DEVICE TYPE field from the
archive log ZPARMs appears to be correct, System Action: DB2 startup is terminated.
check the EDT to ensure that the esoteric or
Operator Response: Notify the system programmer.
generic unit name specified in the ZPARMs is
actually in the EDT. Subsequent off-load System Programmer Response: Confirm that the
processing will archive the log data which ENDLRSN value specified in the Conditional Restart
could not be previously archived due to the control record is correct. If it is not correct, run the
allocation failure (DSNJ103I). Change Log Inventory (DSNJU003) utility with the
CRESTART CANCEL parameters to cancel the
32 (X'20') or 40 (X'28')
conditional restart. If log truncation is desired, run the
To correct this situation, change the archive log
the DSNJU003 utility with the correct ENDLRSN.
DEVICE TYPE ZPARM to use a device type
Restart DB2.
(unit name) which contains homogenous
devices, or modify the device list associated
with the device type (unit name) via a system DSNJ099I LOG RECORDING TO COMMENCE
generation to supply a list of homogenous WITH STARTRBA=...
devices.
Explanation: This message is generated when the log
44 (X'2C') manager is initialized during DB2 startup. The value
To correct this situation, issue an MVS mount specified by the STARTRBA=value keyword is the RBA
command to change the volume use attribute of the next byte of log data to be recorded in the DB2
of a mounted 'private' volume to 'storage'. If active log data set(s). This information may later be
this is a recurring problem, a system needed for a conditional restart.
generation may be required to add
permanently resident volumes with a volume This message is preceded by one DSNJ001I message
use attribute of 'storage' to the esoteric or (if single logging) or two DSNJ001I messages (if dual
generic unit, or ZPARMs may have to be logging).
changed to use a different esoteric or generic System Programmer Response: None required.
unit name for the DEVICE TYPE (on the However, if recovery is required, information from this
DSNTIPA installation panel). message may be required as input to the change log
48 (X'30') inventory (DSNJU003) utility.
UCB services became available in MVS/ESA
Version 4.1 (HBB4410). DSNJ100I csect-name ERROR OPENING BSDSn
DSNAME=..., ERROR STATUS=eeii
DSNJ097E csect-name LOG TRUNCATION BY Explanation: Log manager initialization or the
ENDLRSN IS ONLY VALID IN DATA -RECOVER BSDS command could not open the
SHARING. specified bootstrap data set (BSDS). BSDSn matches
Explanation: ENDLRSN was specified in the active the ddname in the log startup JCL of the data set that
conditional restart control record but this DB2 is not a cannot be opened. The value of 'n' is 1 or 2. Refer to
member of a data sharing group. Part 4 (Volume 1) of DB2 Administration Guide for
information about recovery from BSDS or log failures.
System Action: DB2 startup is terminated.
System Action: When this error occurs at initialization
Operator Response: Notify the system programmer. time, DB2 startup must be terminated, because the log
Chapter 11. DB2 Messages 269
DSNJ101E • DSNJ103I
data sets cannot be determined and allocated without (DSNJU003) utilities to make the BSDS consistent with
the BSDS. When this error occurs during -RECOVER the log data sets.
BSDS processing, the command is terminated, and the
system continues in single BSDS mode.
DSNJ103I csect-name LOG ALLOCATION ERROR
Operator Response: Notify the system programmer. DSNAME=dsname, ERROR
STATUS=eeeeiiii, SMS REASON
System Programmer Response: Recover the BSDS
CODE=ssssssss
that cannot be opened. Normally, if dual BSDSs are
being used, recovery consists of making a copy of the Explanation: The log manager encountered an error
remaining good BSDS. while attempting to allocate the active or archive log
data set indicated by the DSNAME=keyword. The
Problem Determination: The 'error status' contains
STATUS=keyword indicates the error reason code
the VSAM open return code in 'ee', and the VSAM open
returned by MVS dynamic allocation (SVC99).
reason code in 'ii'. Refer to DFSMS/MVS: Macro
Instructions for Data Sets for a list of the VSAM open This message might be preceded by message
return codes and reason codes, and the steps required DSNJ073I.
to take corrective action.
System Action: Subsequent log manager actions are
based upon the type of data set involved.
DSNJ101E csect-name CRCRERBA OF rrr IS xxx
For active log data sets, if the error is encountered
THAN ANY KNOWN RBA, BUT COLD
during log manager initialization, DB2 startup is
START WAS NOT SPECIFIED
terminated. If two copies of the active log data sets are
Explanation: Truncation cannot take place because defined, this message appears only once.
the CRCR end RBA is not in the range of RBA values
For archive log data sets, if two copies of the archive
known to either the active or archive logs. 'rrr' is the end
log data sets are defined, processing continues on the
RBA specified in the active record. 'xxx' is replaced by
remaining archive log data set.
either HIGHER or LOWER. If HIGHER is the case, the
CRCRERBA is higher than the end RBA of the most Operator Response: Notify the system programmer.
recent active log data set. LOWER means the
CRCRERBA is lower than the starting RBA of the oldest System Programmer Response: The error status
archive data set. portion of this message contains a 2-byte error code
(S99ERROR) followed by the 2-byte information code
System Action: DB2 startup is terminated. (S99INFO) from the SVC99 request block. If the
S99ERROR code indicates an SMS allocation error
Operator Response: Notify the system programmer.
(97XX), then 'ssssssss' contains additional SMS reason
System Programmer Response: Most likely, the code information obtained from S99ERSN. Refer to
archive log data set that contained the requested RBA | OS/390 MVS Programming: Authorized Assembler
has been deleted from the bootstrap data set (BSDS) | Services Guide for a description of these codes.
by the change log inventory (DSNJU003) utility. Locate
For active log data sets, if the problem occurred during
the output from an old Print Map run, and identify the
DB2 initialization, you can resolve the problem by either:
data set that contains the missing RBA. If the data set
has not been reused, run the DSNJU003 utility to add v Resolving the error associated with the active log
this data set back into the inventory of log data sets. data set as indicated by STATUS=keyword
Restart DB2. v Using AMS, providing another copy of the active log
data set
DSNJ102I LOG RBA CONTENT OF LOG DATA v Updating the BSDS with the change log inventory
SET DSNAME=..., STARTRBA=..., (DSNJU003) utility
ENDRBA=..., DOES NOT AGREE WITH v Restarting DB2.
BSDS INFORMATION
Explanation: The log RBA range shown in the BSDS For archive log data sets:
for the specified data set does not agree with the v If the problem occurred during allocation with the
content of the data set. This message indicates that the intent to write the data set, no immediate action is
change log inventory (DSNJU003) utility was used required. However, failure to resolve the SVC99 error
incorrectly or that a down-level volume is being used. (indicated by the STATUS value in the message)
might eventually cause the available space in the
System Action: DB2 startup processing is terminated. active log to be exhausted (DSNJ111E), since all
Operator Response: Notify the system programmer. future off-loads might fail due to the same error.
v If the problem occurred during allocation with the
System Programmer Response: Use the print log
intent to read the data set, determine the problem,
map (DSNJU004) and change log inventory
and use the DSNJU003 utility DELETE function to
270 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ104I • DSNJ105I
delete the archive log data set from the BSDS v For a CLOSE of an archive log data set, the return
archive log inventory. Then use the NEWLOG code is the TCB completion code for an abend
function to add the data set back into the archive log received during CLOSE processing. This abend is
inventory, pointing to the correct volume and device. normally preceded by an IEC210I or IEC212I
message that defines the error.
If additional information is required about recovery from v For EDTINFO and UCBLOOK errors, the first 2 bytes
log failures, refer to Part 4 (Volume 1) of DB2 contain the return code and the second 2 bytes
Administration Guide. contain the reason code.
This message can also be issued as the result of a Refer to Part 4 (Volume 1) of DB2 Administration Guide
possible user error. If the STATUS=keyword displays a for information about recovery from log failures.
value of '17080000', then the site might have one or
more active log data sets defined in the BSDS, but not System Action: If this condition is encountered during
allocated on DASD. To correct the situation, print the log manager initialization, DB2 startup is terminated. If
contents of the current active log data set inventory the error occurs later and the data set is needed either
using the print log map (DSNJU004) utility, and then do for offload or for input operations, DB2 processing
one of the following: continues. If a second copy of the data is available,
DB2 attempts to allocate and open the second data set.
v For each active log data set listed in the BSDS, but
not actually allocated on DASD, allocate the active If the data set is needed as an active log data set, the
log data set using access method services. The log manager attempts to retry the failing request. If the
access method services command syntax for active retry fails, the DB2 subsystem is terminated.
log data sets can be found in the DSNTIJIN
Operator Response: Notify the system programmer.
installation job stream.
v Use the DSNJU003 utility DELETE statement to System Programmer Response: If the error occurred
delete the errant active log data set name, and the during initialization, the installation must either correct
NEWLOG statement to add the correct name to the the problem so that the data set is available or provide
active log data set inventory. The name specified on another copy of the data set and change the BSDSs to
the NEWLOG statement must be the same as the point to the new data set.
name of the actual DB2 active log data set allocated If the error occurred during DB2 processing, the return
on DASD. code should be reviewed and the appropriate action
taken to correct the problem so that the data set can be
DSNJ104I csect-name RECEIVED ERROR STATUS used at a later time or the data set entry can be
nnn FROM macro-name FOR DSNAME removed from the BSDS via the change log inventory
dsname (DSNJU003) utility.
Explanation: DB2 encountered an error while issuing If the error was received from PROTECT, there may be
macro 'macro-name'. Error status is the return code a problem with the PASSWORD data set. You should
from the specified macro. refer to the appropriate DADSM publication to determine
the cause of the problem. When the problem has been
v For an OPEN of a VSAM data set, the return code in
corrected, you should ensure the archive log data sets
the error field of the access method services control
receiving the error are added to the PASSWORD data
block is included in this message as the error status
set. If these archive log data sets are not added to the
value. Refer to the appropriate VSAM publication for
PASSWORD data set, archive read will fail when
a definition of these values.
attempting to OPEN these data sets.
v If the OPEN was for a non-VSAM data set, the error
status is zero. If the error was received from EDTINFO or UCBLOOK
and the allocation for the archive log data set fails,
v For MMSRV errors, error status contains the error
verify that the archive UNIT names are correct in
information returned by media manager services. If
ZPARMs.
an MMSRV CATUPDT failure occurs attempting to
truncate an active log data set, the log data set will
be unavailable to DB2 and the status of the log data DSNJ105I csect-name LOG WRITE ERROR
set will be flagged as 'STOPPED' in the BSDS. DSNAME=..., LOGRBA=..., ERROR
v For VSAM OPEN and MMSRV errors, this message STATUS=ccccffss
is preceded by an IEC161I message that defines the Explanation: The log manager encountered a write
error that occurred. error in the specified active log data set. If 'csect-name'
v For a PROTECT of an archive log data set, the is DSNJW107, the error occurred writing the log buffers
return code is from DADSM PROTECT. Refer to the to an active log data set. If 'csect-name' is DSNWJ207,
appropriate MVS publication for a description of the the error occurred while preformatting the next control
MMSRV return codes. area before writing log data into it.
Chapter 11. DB2 Messages 271
DSNJ106I • DSNJ108I
Error status contains the error information returned by For additional information about recovery from log
media manager in the form 'ccccffss', where 'cccc' is a failures, refer to Part 4 (Volume 1) of DB2
2-byte return code that describes the error, 'ff' is a Administration Guide
1-byte code that defines the functional routine that
This message can also be issued as the result of a
detected the error, and 'ss' is the 1-byte status code that
possible user error. If the data set name associated with
defines a general category of error. Refer to the
the DSNAME=keyword is missing, and the
appropriate MVS publication for a description of the
STATUS=keyword displays a value of '00180408' or
MMCALL return codes.
'00100408', then the site is using dual logging, but only
If the dual active logging option is selected, the log one set of active log data sets are defined in the BSDS.
manager switches to the next data set for this copy. If To resolve this condition, do one of the following:
the next data set is not ready, the log manager v Define a second set of active log data sets using
temporarily enters single logging mode and allocates a access method services (if they are not defined
replacement data set for the one that encountered the already), and update the BSDS log inventory using
error. Dual logging is resumed as soon as possible. the DSNJU003 NEWLOG operation.
If single active logging option is selected and the next v Reset the log parameters ZPARM to indicate single
data set is not ready, the log manager waits for that logging. To do this, set the TWOACTV parameter in
data set to be available. In this case, log writing is the DSN6LOGP ZPARMs to NO.
inhibited until the replacement is ready for output.
System Action: See the Explanation section of this DSNJ107I READ ERROR ON BSDS DSNAME=...
message. ERROR STATUS=...
Operator Response: Notify the system programmer. Explanation: The log manager encountered an error
while reading the specified bootstrap data set. Error
System Programmer Response: See the Explanation
Status contains the VSAM return and feedback codes. It
section of this message.
is a 2-byte field with the first byte containing the
hexadecimal return code and the second containing the
DSNJ106I LOG READ ERROR DSNAME=..., hexadecimal feedback code. Refer to the appropriate
LOGRBA=..., ERROR STATUS=ccccffss MVS publication for a description of VSAM return and
reason codes.
Explanation: The log manager encountered an error
while reading an active log data set. The 'error status' Refer to Part 4 (Volume 1) of DB2 Administration Guide
contains the error information returned by the media for information about recovery from BSDS or log
manager in the form 'ccccffss', where 'cccc' is a 2-byte failures.
return code that describes the error, 'ff' is a 1-byte code
System Action: If dual BSDSs are available, the log
that defines the functional routine that detected the
manager attempts to read from the other BSDS. If read
error, and 'ss' is the 1-byte status code that defines a
from the second BSDS fails or if there is only one
general category of error.
BSDS, an error code is returned to the log request that
System Action: If another log data set contains the caused access to the BSDS.
data, the log manager attempts to read the data from
If read error is detected during start-up, DB2
the alternate source. If an alternate source is not
initialization process is terminated to prevent users from
available, the log manager returns a read error return
operating in a cripple mode. User should take action to
code to the program requesting the log data.
correct the problem.
Operator Response: Notify the system programmer.
Operator Response: Notify the system programmer.
System Programmer Response: If the site is using
System Programmer Response: It may be necessary
dual logging, the requested RBA was probably retrieved
to replace or repair the BSDS, depending on what
from the corresponding dual active log data set, and no
conditions resulted from the read error. To replace a
immediate response is necessary. However, if this error
BSDS, first delete the bad BSDS, and then define the
occurs frequently, or if the site is using single logging,
new BSDS with the same name and attributes. If a new
immediate attention may be required.
name is used for the new BSDS, change the log startup
Since this condition might indicate an error detected by JCL to specify the new BSDS name.
the media manager, refer to DFSMS/MVS: Diagnosis
Reference for DFSMSdfp for a description of media
DSNJ108I WRITE ERROR ON BSDS DSNAME=...
manager return codes. Take corrective action based on
ERROR STATUS=...
these codes.
Explanation: The log manager encountered an error
It might be necessary to replace the bad data set with a
while writing to the specified bootstrap data set. Error
new data set containing the log data, and to update the
Status contains the VSAM return and feedback codes. It
BSDSs to reflect the new data set using the change log
is a 2-byte field with the first containing the hexadecimal
inventory (DSNJU003) NEWLOG operation.
272 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ109I • DSNJ111E
return code and the second containing the hexadecimal Operator Response: To clear this condition, steps
feedback code. Refer to the appropriate VSAM must be taken to complete other waiting off-load tasks.
publication for a description of VSAM return and reason Once an active log data set is made available
codes. (reusable) by completing the off-load process for it, the
DB2 logging activity can continue.
System Action: If dual BSDSs are available, the log
manager enters single BSDS mode using the remaining Execute an MVS Display System Requests command
good BSDS. Otherwise, an error code is returned to the (D R,L for example) to determine the outstanding
log request that caused access to the BSDS. requests related to the log off-load process. Take the
necessary action to satisfy any requests, and permit
Operator Response: Notify the system programmer.
off-load to continue. If off-load fails to complete normally
System Programmer Response: If dual BSDS mode or cannot be initiated, notify the system programmer.
is being used, execute an offline access method
System Programmer Response: Either correct the
services job to rename the error BSDS and define a
problem that is causing the off-load process to fail, or
new BSDS with the same name. Then enter the log
add more active log data sets. Note that the latter action
manager -RECOVER BSDS command to reestablish
requires DB2 to be down and the change log inventory
dual BSDS mode.
(DSNJU003) utility to be run.
If dual BSDS mode is not being used, the DB2
Possible causes for the shortage of active log data
subsystem must be shut down, and the BSDS must be
space are:
recovered from a backup copy. To recover the BSDS,
use the change log inventory (DSNJU003) utility. v Excessive logging. For example, too many users
have requested logs at the same time or too many
utilities have specified LOG(YES).
DSNJ109I OUT OF SPACE IN BSDS DSNAME=...
v Delayed or slow off-loading. For example, failure to
Explanation: There is no more space in the specified mount archive volumes, incorrect replies to off-load
bootstrap data set. The operation that encountered the messages, or slow device speeds.
out-of-space condition did not complete properly. v Excessive use of the -ARCHIVE LOG command.
System Action: If dual BSDSs are available, the log Each invocation of the -ARCHIVE LOG command
manager enters single BSDS mode using the remaining causes the DB2 subsystem to switch to a new active
good BSDS. Otherwise, an error code is returned to the log data set and to initiate an off-load of the active
log request that caused access to the BSDS. log. Although the -ARCHIVE LOG command will not
be processed when only one active log data set
Operator Response: Notify the system programmer. remains in a copy of the active log (see DSNJ319I),
excessive use of the command could have consumed
System Programmer Response: If dual BSDS mode
all space in the active log except the current active
is being used, execute an offline access method
log data sets.
services job to rename the full BSDS and define a new,
larger BSDS with the same name. Enter the DB2 v Off-loads failed. See Operator Response.
-RECOVER BSDS command to reestablish dual BSDS v Insufficient active log space. See Operator Response.
mode. v Offload task no longer functioning. Issue the
If dual BSDS mode is not being used, the DB2 -ARCHIVE LOG CANCEL OFFLOAD command to
subsystem must be shut down and the BSDS recovered abnormally terminate and restart the offload process.
offline. In this case, execute the same access method
services job mentioned above to rename the full data DSNJ111E OUT OF SPACE IN ACTIVE LOG DATA
set and define a larger data set. Next, execute an SETS
access method services REPRO job to copy the full
BSDS into the new BSDS. Explanation: Due to delays in off-load processing, all
available space in all active log data sets has been
exhausted. DB2 recovery logging cannot continue.
DSNJ110E LAST COPYn ACTIVE LOG DATA SET
IS nnn PERCENT FULL System Action: The DB2 log manager waits for an
available data set.
Explanation: This message is issued when the last
available active log data set is 5% full, and is reissued Operator Response: Execute an MVS Display
after each additional 5% of the data set space is filled. System Requests command (D R,L for example) to
ensure that there are no outstanding requests that are
System Action: Each time the message is issued, the related to the log off-load process. Take the necessary
off-load processing is retried. If the situation is not action to satisfy any requests, and permit off-load to
corrected, the active log data space fills to capacity, continue.
message DSNJ111E is issued, and the DB2 online
processing halts. System Programmer Response: If the delay was
caused by the lack of a resource required for off-load,
Chapter 11. DB2 Messages 273
DSNJ112E • DSNJ116I
the necessary resource must be made available to allow Most likely, the archive log data set that contained the
off-load to complete and thus permit logging to proceed. requested log value has been deleted from the
For additional information on recovery from this bootstrap data set (BSDS) by the change log inventory
condition, refer to the discussion on DB2 system (DSNJU003) utility. Locate the output from an old print
resource failures and active log failures in Part 4 log map run of the BSDS for the DB2 member identified
(Volume 1) of DB2 Administration Guide. by member-id, and identify the data set that contains
the missing log-value. If the data set has not been
reused, run the DSNJU003 utility to add this data set
DSNJ112E csect-name INSUFFICIENT ACTIVE LOG
back into the inventory of log data sets. Restart DB2.
DATA SETS DEFINED IN BSDS
Explanation: There are not enough active log data
DSNJ114I ERROR ON ARCHIVE DATA SET,
sets defined in the BSDS to start DB2. This condition
OFFLOAD CONTINUING WITH ONLY
usually exists for one of the following reasons.
ONE ARCHIVE DATA SET BEING
v Fewer than two data sets are defined for one of the GENERATED
active log copy sets.
Explanation: An error occurred while accessing one of
v DSN6LOGP specified TWOACTV=YES in DB2
the archive data sets being created by off-load.
initialization parameters, but data sets for two copies
Because the dual archive option is specified, off-load is
of active log are not defined in BSDS.
continuing with the other archive data set. For the RBA
v Fewer than two data sets are available (not flagged range being off-loaded, there is only one copy of
as STOPPED) for one of the active log copy sets. archive instead of the usual two copies.
System Action: DB2 startup is terminated. System Action: Off-load produces a single archive
Operator Response: Notify the system programmer. data set.
System Programmer Response: Use the change log System Programmer Response: A second copy of
inventory (DSNJU003) utility to make the number of this archive log data set can be made, and the BSDS(s)
active log data sets defined in the BSDS consistent with can be updated with the change log inventory
the parameters specified on DSN6LOGP. Log data sets (DSNJU003) utility.
that are flagged as 'STOPPED' will not be reused by
DB2. These data sets must be recovered (either DSNJ115I OFFLOAD FAILED, COULD NOT
redefined or recovered from the other copy of the log) ALLOCATE AN ARCHIVE DATA SET
and the log data sets must be deleted and re-added to
the BSDS (using DSNJU003) with the appropriate Explanation: Off-load could not allocate an archive log
RBA’s, to clear the STOPPED status. Restart DB2. data set. The off-load was not performed. This message
is usuallypreceded by message DSNJ103I.
DSNJ113E csect-name log-type log-value NOT IN System Action: Off-load will be tried at a later time.
ANY ACTIVE OR ARCHIVE LOG DATA Operator Response: Notify the system programmer.
SET. CONNECTION-ID=aaaaaaaa,
CORRELATION-ID=aaaaaaaa, System Programmer Response: Review the error
MEMBER-ID=member-id status information of message DSNJ103I. Correct the
condition that caused the data set allocation to fail so
Explanation: A request was made to read the log that, on retry, the off-load can take place.
starting at this log-value and log-type (RBA or LRSN).
However, the log value cannot be found in any active or
archive log data set for the indicated member. The DSNJ116I ERROR ATTEMPTING TO ADD
member-id contains the ID of the data sharing member ARCHIVE ENTRY TO BSDS
whose logs were being requested at the time of the Explanation: Off-load could not add an archive entry
failure or zero if data sharing is not active. The to the BSDS. The off-load is considered incomplete. The
connection and correlation IDs identify the user or active log data set is not marked as reusable for new
application that encountered the problem. Correlation log data. This message is preceded by message
IDs beginning with '0nn' where 'nn' is a number from 01 DSNJ107I, DSNJ108I, or DSNJ109I.
to 28, identify system agents. Refer to Part 4 (Volume
1) of DB2 Administration Guide for information about System Action: Off-load will be retried at a later time.
recovery from log failures.
Operator Response: Notify the system programmer.
System Action: Depending upon what log record is
System Programmer Response: Refer to the specific
being read and why, this may result in an abend with a
preceding message for action.
reason code of '00D1032A'.
Operator Response: Notify the system programmer.
System Programmer Response: Probable user error.
274 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ117I • DSNJ123I
shown for each BSDS. The time stamps have the
DSNJ117I INITIALIZATION ERROR READING
format yy.ddd hh:mm:ss.th.
BSDS DSNAME=......, ERROR
STATUS=... System Action: DB2 startup is terminated.
Explanation: The log manager encountered an error Operator Response: Notify the system programmer.
during initialization reading from the specified bootstrap
data set. Error status contains the VSAM return and System Programmer Response: Run the print log
feedback codes. It is a two byte field with the first map (DSNJU004) utility against each BSDS. From the
containing the hexadecimal return code and the second output, determine which data set is obsolete, delete it,
byte containing the hexadecimal feedback code. Refer define a replacement for it, and copy the remaining
to the appropriate VSAM publication for a description of BSDS to the replacement.
VSAM return and reason codes. If output from the print log map (DSNJU004) utility for
System Action: DB2 startup is terminated. both data sets is similar, delete the data set with the
oldest time stamp, and copy the data set with the most
Operator Response: Notify the system programmer. recent time stamp.
System Programmer Response: Determine the
cause of the read error using the VSAM error status DSNJ121I LOG MANAGER ENCOUNTERED AN
information provided. Restart DB2. ERROR READING THE JFCB.
DDNAME=nnnnnnnn
DSNJ118I LOG INITIALIZATION RECEIVED Explanation: During log manager initialization (if dual
RETURN CODE nnn FROM xxxxxxxx BSDS data sets are specified), the job file control block
MACRO (JFCB) in MVS is read to obtain the data set names
associated with DDNAME BSDS1 and BSDS2. This
Explanation: Log manager initialization received a bad
error is caused by a missing DD statement.
return code from the named macro.
System Action: DB2 is terminated.
System Action: DB2 initialization is terminated.
Operator Response: Notify the system programmer.
Operator Response: Notify the system programmer.
System Programmer Response: Ensure that a DD
System Programmer Response: Determine the
statement exists in the DB2 startup procedure for
problem from the documentation on the named macro
DDNAME BSDS1. If dual BSDS data sets are used,
and return code. Then take appropriate steps, and
ensure that a DD statement also exists in the DB2
restart the DB2 subsystem.
startup procedure for DDNAME BSDS2.
DSNJ119I BOOTSTRAP ACCESS INITIALIZATION
DSNJ122I DUAL BSDS DATA SETS ARE OUT OF
PROCESSING FAILED
SYNCHRONIZATION
Explanation: During log manager initialization, the
Explanation: During log manager initialization, the
bootstrap data set access function was unable to
dual BSDS data sets were found to differ in content.
complete its initialization process. Refer to Part 4
(Volume 1) of DB2 Administration Guide for information System Action: DB2 startup is terminated.
about recovery from BSDS or log failures.
Operator Response: Notify the system programmer.
System Action: DB2 startup is terminated.
System Programmer Response: Run the print log
Operator Response: Notify the system programmer. map (DSNJU004) utility against each BSDS to
determine which data set was last used as copy 1.
System Programmer Response: One or more error
Delete the copy 2 data set, define a replacement for the
messages describing the specific error have preceded
deleted data set, and copy the remaining BSDS to the
this message. Refer to the specific message(s) for error
replacement.
analysis and the appropriate action to take.
DSNJ123I CHANGE LOG INVENTORY FAILURE
DSNJ120I DUAL BSDS DATA SETS HAVE
DETECTED
UNEQUAL TIMESTAMPS, BSDS1
SYSTEM=..., UTILITY=..., BSDS2 Explanation: During log manager initialization, the
SYSTEM=..., UTILITY=... BSDS data set was found to have been incompletely
processed by the change log inventory (DSNJU003)
Explanation: When the log manager was initialized,
utility.
the time stamps of the dual bootstrap data sets (BSDS)
did not agree. The time stamps from the system and System Action: DB2 startup is terminated.
from the change log inventory (DSNJU003) utility are
System Programmer Response: Run the print log
Chapter 11. DB2 Messages 275
DSNJ124I • DSNJ128I
map (DSNJU004) utility to determine what operation
DSNJ127I SYSTEM TIMESTAMP FOR BSDS=...
against the BSDS did not complete. Run the change log
inventory (DSNJU003) utility against the BSDS(s) to Explanation: When the log manager is initialized, the
allow any unfinished processing to be completed. system time stamp for the bootstrap data sets (BSDS)
is displayed. The time stamp is of the format yy.ddd
hh:mm:ss.th. This time stamp should be close to the
DSNJ124I OFFLOAD OF ACTIVE LOG
last time at which this subsystem was stopped. If not,
SUSPENDED FROM RBA xxxxxx TO
then it may indicate a restart is being attempted with the
RBA xxxxxx DUE TO I/O ERROR
wrong BSDS.
Explanation: During off-load, an unrecoverable I/O
System Action: DB2 startup continues.
error was encountered on an active log data set. The
data set experiencing the error is marked unusable, and Operator Response: If the time displayed does not
no further logging is done to that data set. appear to be close to the time this subsystem was last
stopped, contact the system programmer.
System Action: Active log data sets continue to be
off-loaded as they become full. System Programmer Response: If you cannot
explain the apparent time discrepancy, cancel the
Operator Response: Notify the system programmer to
subsystem. From the startup procedure for the
allow recovery actions to be initiated.
subsystem services address space, determine the data
System Programmer Response: Recover the data set names of the bootstrap data sets and run the print
manually from the data set, copy it to an archive data log map (DSNJU004) utility. Check whether the active
set, run the change log inventory (DSNJU003) utility to and archive log data sets all belong to this subsystem. If
make the new archive data set available to the DB2, not, then change the startup procedure for the
and remove the error-prone active log data set from subsystem services address space to use the correct
DB2 by using the change log inventory utility. bootstrap data sets.
DSNJ125I ERROR DUMPING BSDS, OFFLOAD DSNJ128I LOG OFF-LOAD TASK FAILED FOR
CONTINUING WITHOUT PRODUCING ACTIVE LOG nnnnn
THE BSDS DUMP
Explanation: The off-load task abended while
Explanation: An error occurred while dumping the attempting to offload the relative byte address (RBA)
BSDS data set during the off-load process. The data set range in active log data set 'nnnnn'.
is not produced, but the off-load process continues. The
System Action: The off-load task terminates and the
volume containing the off-loaded data set does not
archive data sets allocated to the off-load task are
contain a BSDS for recovery use.
deallocated and deleted. The status of the active log
System Action: The system continues the off-load data sets involved in the failed off-load processing
process without producing a dump of the bootstrap data remains set to 'not reusable'.
set.
The log off-load task will be reinitiated by one of several
events. The most common are:
DSNJ126I BSDS ERROR FORCED SINGLE BSDS v All the available space in the current active log data
MODE set has been used (normal case).
Explanation: The log manager encountered an I/O v A DSNJ110E message is issued.
error or a VSAM logical error on a bootstrap data set. v The master address space is started, but data in the
This message is preceded by message DSNJ107I or active log has not been archived.
DSNJ108I.
v An I/O error occurs on the active log, which will force
System Action: The log manager enters single BSDS the system to truncate and off-load the active log
mode using the remaining BSDS. data set, and switch to a new active log data set.
Operator Response: Notify the system programmer. Operator Response: This message is the result of an
off-load failure, and will be preceded by one or more
System Programmer Response: Execute an offline DB2 messages (for example, DSNJ073I) and/or MVS
access method services job to rename the error BSDS ABEND messages (for example, IEC030I, IEC031I,
and define a new BSDS with the same name. Then IEC032I). If DB2 is operating with restricted active log
enter the log manager -RECOVER BSDS command to resources (see message DSNJ110E), quiesce the
reestablish dual BSDS mode. system to restrict logging activity until the ABEND or the
DSNJ110E condition can be resolved. Notify the system
programmer.
System Programmer Response: This message is the
result of an off-load failure, and will be preceded by one
276 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ129I • DSNJ140I
or more DB2 messages (for example, DSNJ073I) and/or
DSNJ130I ICF CATALOG NAME IN BSDS DOES
MVS ABEND messages (for example, IEC030I, IEC031I
NOT AGREE WITH DSNZPARM. BSDS
IEC032I). Investigate and correct the cause of the
CATALOG NAME=name, DSNZPARM
ABEND before the off-load is attempted again by DB2.
CATALOG NAME=name
Problem Determination: This message is the result of
Explanation: The ICF catalog name defined in
an off-load ABEND and will be preceded by one or
DSNZPARM does not agree with the name contained in
more DB2 messages and/or MVS ABEND messages.
the bootstrap data set (BSDS).
See the documentation for the associated DB2 and/or
MVS messages to formulate a course of corrective System Action: DB2 startup is abended.
action. Use the print log map (DSNJU004) utility to print
User Response: Notify the system programmer.
the BSDS (both copies if running in dual mode), and
then use the DSNJU004 output to determine the current Operator Response: If you attempt to start the DB2
status of the active and archive log data sets. subsystem, you will receive this same message and
abnormal termination will result until the problem is
This message can be generated for a variety of
resolved.
reasons. However, the most likely are:
v Archive log data set allocation errors. Refer to the System Programmer Response: Change the ICF
text for message DSNJ103I for corrective action. catalog name in the BSDS to agree with the name
defined in DSNZPARM during DB2 initialization. To
v The size of the archive log data set is too small to
change the ICF catalog name in the BSDS, use the
contain the active log data set(s) during off-load
BSDS change log inventory (DSNJU003) utility with the
processing. All secondary space allocations have
NEWCAT control statement.
been used. This condition is normally accompanied
by MVS ABEND message IEC030I. Problem Determination: During log manager
v All available space on the DASD volume(s) to which initialization, the ICF catalog name defined in
the archive data set is being written has been DSNZPARM is compared to the catalog name in the
exhausted. This condition is normally accompanied BSDS to ensure that the catalog name used by the log
by MVS ABEND message IEC032I. manager during DB2 processing is correct. These
names were found not to be the same.
v The primary space allocation for the archive log data
set (as specified in ZPARMs) is too large to allocate
to any available online DASD device. This condition DSNJ139I LOG OFFLOAD TASK ENDED
is normally accompanied by MVS ABEND message
IEC032I. Explanation: Processing of the active log off-load
ended.
DSNJ129I END OF log-rba eol-rba X COULD NOT System Action: This message is written to the MVS
BE FOUND IN ANY ACTIVE LOG DATA console.
SET HIGHEST RBA FOUND WAS hi-rba Operator Response: This message does not
X guarantee that the off-load completed without errors.
Explanation: The log manager has been requested to Check the console log and task messages to review the
find 'eol-rba', the log record which has been recorded in execution of the off-load task to determine whether any
the bootstrap data set (BSDS) as the highest RBA abnormal events occurred during the off-load.
written. This RBA cannot be found in any active log data
set. The highest RBA which could be found in any DSNJ140I csect-name INVALID BSDS RELEASE
active data set was 'hi-rba'. LEVEL ACTIVE=xxxxxx
System Action: DB2 startup processing is terminated. ARCHIVE=yyyyyy DSN=zzzzzz
Operator Response: Notify the system programmer. Explanation: At initialization time DB2 detected that
the BSDS log records are not at the proper release
System Programmer Response: Most likely, the level for this release of DB2. 'xxxxxx' contains the
active log data set containing the requested RBA has release level for the ACTIVE log records and 'yyyyyy'
been deleted from the BSDS by the change log contains the release level for the ARCHIVE log records.
inventory (DSNJU003) utility. If the data set has not 'zzzzzz' contains the data set name for the BSDS
been reused, run DSNJU003 to add this data set back encountering the error.
into the BSDS. Restart DB2.
System Action: DB2 startup will be terminated.
If the data set is not available, a conditional restart must
be performed to either truncate the log prior to the RBA Operator Response: Notify the system programmer
value of the missing data set, or to cold start at a higher so operating procedures can be changed.
RBA value. Refer to Part 4 (Volume 1) of DB2 System Programmer Response: Run the appropriate
Administration Guide for more information. conversion program (DSNJMIG0 or DSNJFAL0) to
Chapter 11. DB2 Messages 277
DSNJ150E • DSNJ153E
convert the BSDS data set to a compatible release application abnormally terminated or DB2 could not
level. recover successfully, this message is followed by one or
more messages. Refer to the information in this
message and the subsequent messages to determine
DSNJ150E LOG CAPTURE EXIT ABEND, EXIT
the appropriate corrective action. For information about
DEACTIVATED
recovery from log failures, refer to Part 4 (Volume 1) of
Explanation: An abnormal program interrupt was DB2 Administration Guide .
detected while executing in the installation-supplied log
capture exit code (i.e. entry point DSNJW117 in load
DSNJ152I csect-name ERROR ENCOUNTERED
module DSNJL004). As a result of the abend, the log
WHEN ATTEMPTING TO BUILD
capture exit will no longer be active; log data will no
ARCHIVE LOG VOLUME LIST.
longer be available for Exit capture/processing.
CONNECTION-ID=xxxx,
This message can only occur when an CORRELATION-ID=yyyyyy,
installation-supplied log capture exit (entry DSNJW117) REASON-CODE=ccc
is active for this instance of DB2.
Explanation: An error occurred while attempting to
System Action: The log capture exit (entry point create the Archive Log Volumes report. An RBA range
DSNJW117) is terminated. No further calls will be could not be successfully mapped into one or more
attempted for this DB2 instance. A full dump is provided archive data sets due to reason code 'ccc'. The user or
for diagnostic purposes. application that encountered the error is identified by the
connection and correlation ID. This message might be
User Response: See “System Programmer preceded by one or more related error messages.
Response” below. Messages that have the same connection ID and
Operator Response: Notify the system programmer. correlation ID relate to the same user. Correlation IDs
beginning with '0nn', where 'nn' is a number from 01 to
System Programmer Response: Determine the 28, identify system agents.
cause of the DSNJL004 load module (DSNJW117 entry
point) abend and take corrective action. This failure could be caused by one or more missing
archive log data sets, or a system error (for example, an
Note: A correctly-functioning copy of load module I/O error reading BSDS).
DSNJL004/entry DSNJW117 must be available in The Archive Log Volumes report (see message
order to start DB2. If the problem which caused DSNJ330) is not produced. In addition, no premounting
the above abend cannot be corrected, ensure of tapes is possible.
that the default DSNJW117 entry (load module
DSNJL004 - supplied with the DB2 release) is System Action: The user or application continues
available during the next DB2 subsystem start. execution. The physical read process for the user or
application continues until the job completes normally or
terminates abnormally. The job can terminate
DSNJ151I csect-name IN READING log-type abnormally if the error is encountered again when the
log-value, A NONZERO REASON CODE data set is physically required for the read process.
WAS RETURNED. CONNECTION-
ID=xxxx, CORRELATION-ID=yyyyyy, System Programmer Response: If the user or
REASON-CODE=ccc, application completes successfully, no further action is
MEMBER-ID=member-id necessary. If the user or application does not complete
successfully, refer to the messages related to the actual
Explanation: DB2 could not successfully complete the failure to determine the appropriate corrective actions.
read of this 'log-value' and 'log-type' (RBA or LRSN) due For information about recovery from log failures, refer to
to reason code 'ccc'. The member-id contains the ID of Part 4 (Volume 1) of DB2 Administration Guide.
the data sharing member whose logs were being
requested at the time of the failure or zero if data
sharing is not active. The user or application that | DSNJ153E
encountered the error is identified by the connection
and correlation ID. Messages that have the same | csect-name CRITICAL LOG READ ERROR
connection ID and correlation ID relate to the same | CONNECTION-ID = connection-id
application. Correlation IDs beginning with '0nn', where | CORRELATION-ID = correlation-id
'nn' is a number from 01 to 28, identify system agents. | LUWID = logical-unit-of-work-id=token
| REASON-CODE = reason-code
System Action: DB2 attempts to recover from the
error. | Explanation: While processing a DB2 must-complete
| function, DB2 encountered an error during an attempt to
System Programmer Response: If DB2 was able to | access the required log data sets.
recover from the error and successfully complete the
application, no further action is required. If the | CONNECTION-ID, CORRELATION-ID, and LUWID
278 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ154I • DSNJ205I
| together identify the thread associated with the request.
DSNJ201I csect-name xxxxxxxx UTILITY
| token is a unique token number associated with the
PROCESSING WAS UNSUCCESSFUL
| LUWID. reason-code identifies the most recent log-read
| failure. Explanation: The control section 'csect-name' was
unable to successfully complete processing of 'xxxxxxxx'
| System Action: The DSNJ154I message requests to
utility.
| retry the log-read request, and immediately follows this
| error message. DB2 will wait for a reply to message System Action: The current utility is terminated. DB2
| DSNJ154I before retrying the failed log-read request, or writes this message to the SYSPRINT data set, not to a
| before abending. console.
| System Programmer Response: Review the User Response: Review other messages produced by
| description of the reason-code associated with the the utility to determine the appropriate action to be
| log-read failure. Examine the system console log for taken.
| additional messages regarding the log- read error.
| Correct the cause of the error, if possible, and reply 'Y'
DSNJ202I csect-name INSUFFICIENT VIRTUAL
| to the DSNJ154I message in order to retry the log-read
STORAGE AVAILABLE TO CONTINUE
| request. If it is not possible to correct the problem
WITH UTILITY
| causing the log-read errors, quiesce the work on the
| DB2 system before replying 'N' to the DSNJ154I Explanation: A GETMAIN macro instruction has failed,
| message in preparation for DB2 termination. because virtual storage is unavailable for the job-step.
System Action: The current utility is terminated. This
| DSNJ154I csect-name REPLY Y TO RETRY LOG message is written to the SYSPRINT data set, not to a
| READ REQUEST, N TO ABEND console.
| Explanation: While processing a DB2 must-complete User Response: Rerun the utility after providing a
| function, DB2 encountered an error during an attempt to larger virtual storage allocation for the job-step.
| access the required log data sets.
| System Action: The DSNJ153E message identifies DSNJ203I xxxxxxxx OPERATION IS INVALID
| the critical log-read error, and immediately precedes this
| message. DB2 will wait for the operator’s reply to Explanation: The user entered a utility control
| proceed with the log-read request. statement operation of 'xxxxxxxx' that is invalid.
| Operator Response: Notify the system programmer. System Action: The current utility is terminated. This
| Once actions have been taken to correct the cause of message is written to the SYSPRINT data set, not to a
| the log-read errors, reply ’Y’ to request a retry of the console.
| failing log-read request. A reply of ’N’ will fail the User Response: Correct the control statement, and
| log-read request and DB2 will abend. rerun the utility.
| System Programmer Response: Review the
| description of the reason-code associated with the DSNJ204I xxxxxxxx PARAMETER IS INVALID
| log-read failure, and examine the system console log for
| additional messages regarding the log-read error. Explanation: The user specified a utility control
| Correct the cause of the error, if possible, and reply ’Y’ statement parameter of 'xxxxxxxx' that is invalid.
| to the DSNJ154I message to retry the log-read request. System Action: The current utility is terminated. This
| If it is not possible to correct the problem causing the message is written to the SYSPRINT data set, not to a
| log-read errors, quiesce the work on the DB2 system console.
| before replying ’N’ to the DSNJ154I message in
| preparation for DB2 termination. User Response: Correct the control statement, and
rerun the utility.
DSNJ200I csect-name xxxxxxxx UTILITY
PROCESSING COMPLETED DSNJ205I xxxxxxxx PARAMETER HAS NO
SUCCESSFULLY ARGUMENT
Explanation: The control section 'csect-name' Explanation: 'xxxxxxxx' contains the name of a
successfully completed the 'xxxxxxxx' utility. parameter that requires an argument.
System Action: DB2 writes this message to the System Action: The current utility is terminated. This
SYSPRINT data set, not to a console. message is written to the SYSPRINT data set, not to a
console.
User Response: Specify an argument for the
identified parameter and then rerun the utility.
Chapter 11. DB2 Messages 279
DSNJ206I • DSNJ212I
DSNJ206I xxxxxxxx PARAMETER REQUIRES NO DSNJ209I ENDRBA VALUE MUST BE GREATER
ARGUMENT THAN STARTRBA VALUE
Explanation: 'xxxxxxxx' contains the name of the Explanation: The 'STARTRBA' and 'ENDRBA'
parameter that has been incorrectly followed by an = parameters specify an RBA range. Hence, the ENDRBA
symbol. value must be greater than the STARTRBA value.
System Action: The current utility is terminated. This System Action: The current utility is terminated. This
message is written to the SYSPRINT data set, not to a message is written to the SYSPRINT data set, not to a
console. console.
User Response: Correct the control statement, and User Response: Correct the control statement, and
rerun the utility. rerun the utility.
DSNJ207I csect-name PARAMETERS DSNJ210I OLD ICF CATALOG NAME=oldname,
INCONSISTENT WITH SPECIFIED NEW CATALOG NAME=newname
OPERATION
Explanation: Change log inventory (DSNJU003) utility
Explanation: The user has specified utility control processing for the NEWCAT control statement has
statement parameters that are inconsistent with the completed successfully.
specified utility operation.
oldname
System Action: The current utility is terminated. This Either:
message is written to the SYSPRINT data set, not to a v The name of the prior ICF catalog or
console.
v 'NULL' if no prior name existed.
User Response: Correct the control statement, and
newname
rerun the utility.
The name of the ICF catalog defined by the
VSAMCAT keyword.
DSNJ208E csect name MEMBER member name
WAS NOT FOUND IN THE BSDS
DSNJ211I UNEXPECTED END OF DATA ON
SPECIFIED IN THE GROUP DD
SYSIN DATA SET
STATEMENT.
Explanation: Additional control statements were
Explanation: You are running the print log map
expected but could not be found.
(DSNJU004) utility. No member record exists for this
member in the bootstrap data set (BSDS) specified in System Action: The current utility is terminated. This
the GROUP DD statement. message is written to the SYSPRINT data set, not to a
console.
System Action: The log map for this member is not
printed. If the records for other members are requested User Response: Correct the control statement(s), and
and are found in the BSDS specified in the GROUP DD rerun the utility.
statement, they are printed.
User Response: Use the DISPLAY GROUP command DSNJ212I csect-name ERROR RETURNED FROM
to verify that the member name is a valid name and that BSDS READ, RPLERRCD=yy,
the member has successfully joined the group. Also DDNAME=xxxxxxxx
verify that the BSDS specified in the GROUP DD
statement is correct. If the member name and the BSDS Explanation: A VSAM GET was issued that resulted
name are correct, then the most likely causes of this in a nonzero return code. 'yy' contains the error code
message are: returned by VSAM. 'xxxxxxxx' contains the ddname of
the BSDS encountering the error.
v The 'missing member' never joined the group
because it was never started. System Action: The current utility is terminated. This
v The member whose BSDS you specified in the message is written to the SYSPRINT data set, not to a
GROUP DD statement was down when the missing console.
member joined the group and has not been restarted. User Response: The action taken is dictated by the
return code. The BSDS may have to be recovered by
To gather the information from the missing member, you use of a backup copy.
can rerun the utility, using the BSDS DDNAME option to
point to the missing member’s BSDS. To avoid this
problem in the future, make sure the BSDS named in
the GROUP statement is from a recently started
member.
280 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ213I • DSNJ219I
Problem Determination: If you suspect an error in
DSNJ213I csect-name ERROR RETURNED FROM
DB2, refer to Part 2 of DB2 Diagnosis Guide and
BSDS WRITE, RPLERRCD=yy,
Reference for information on identifying and reporting
DDNAME=xxxxxxxx
the problem.
Explanation: A VSAM PUT was issued that resulted in
Collect the following diagnostic items listed in
a nonzero return code. 'yy' contains the error code
“Appendix B. Problem determination” on page 1281 : 4,
returned by VSAM. 'xxxxxxxx' contains the ddname of
32.
the BSDS encountering the error.
System Action: The current utility is terminated. This
DSNJ216I BSDS ACTIVE LOG DATA SET
message is written to the SYSPRINT data set, not to a
RECORD IS FULL, DDNAME=xxxxxxxx
console.
Explanation: The maximum number of active log data
User Response: The action to be taken is dictated by
sets is fixed. No further entries can be inserted after the
the return code. The BSDS may have to be recovered
maximum has been reached. 'xxxxxxxx' contains the
by use of a backup copy.
ddname of the subject BSDS.
System Action: The current utility is terminated. This
DSNJ214I SPECIFIED DSNAME ALREADY EXISTS
message is written to the SYSPRINT data set, not to a
IN BSDS, DDNAME=xxxxxxxx
console.
Explanation: The user attempted a NEWLOG
User Response: Run the print log map utility to
operation with a data set name that already exists in the
determine the current status of the BSDS. Subsequent
BSDS. An entry is never made in a BSDS if the
actions can then be formulated, depending upon the
specified DSNAME currently exists in either the active
status of the BSDS.
or archive records of that BSDS. 'xxxxxxxx' contains the
ddname of the subject BSDS.
DSNJ217I SPECIFIED DSNAME DOES NOT EXIST
System Action: The current utility is terminated. This
IN BSDS, DDNAME=xxxxxxxx
message is written to the SYSPRINT data set, not to a
console. Explanation: The DELETE operation specifies a
DSNAME that cannot be found in the BSDS. 'xxxxxxxx'
User Response: Either correct the control statement
contains the ddname of the subject BSDS.
and rerun the utility, or delete the existing DSNAME
from the BSDS and rerun the utility. System Action: The current utility is terminated. This
message is written to the SYSPRINT data set, not to a
console.
DSNJ215I csect-name SVC 99 INFORMATION
REQUEST FOR DD NAME ’ddname’ User Response: Correct the control statement, and
FAILED. RC= rc, RSN= rsncd, AND INFO rerun the utility.
CODE infocode.
Explanation: The Print Log Map utility requested DSNJ218I SPECIFIED VOLUME DOES NOT EXIST
information from the MVS Dynamic Allocation facility IN BSDS, DDNAME=xxxxxxxx
about the DD name shown in the message, but the
system was unable to provide the information. The Explanation: The DELETE operation specifies a
return code, reason code, and information code were COPY1VOL or COPY2VOL argument that cannot be
returned by the system’s SVC 99 facility. See MVS/ESA found in the BSDS. 'xxxxxxxx' contains the ddname of
Programming: Authorized Assembler Services Guide for the subject BSDS.
an explanation of these codes. System Action: The current utility is terminated. This
System Action: If the information request was for the message is written to the SYSPRINT data set, not to a
SYSIN DD statement, the Print Log Map utility assumes console.
the control statement was not provided and attempts to User Response: Correct the control statement, and
continue the request using the SYSUT1 DD statement rerun the utility.
to locate the BSDS to be mapped.
If the information request was for the DD name of a DSNJ219I csect-name OPEN ERROR,
BSDS, attempts to get information about BSDS data DDNAME=xxxxxxxx
sets is terminated. If information about any BSDS data
sets was previously acquired, the maps of those BSDS Explanation: An error occurred when the CSECT
data sets are printed. Otherwise, the utility terminates. 'csect-name' tried to open a data set named 'xxxxxxxx'.
System Programmer Response: Use the MVS This error can be caused by a number of different
manual (or the equivalent manual for the level of MVS conditions. The most probable conditions are:
on your system) to help you in problem determination.
Chapter 11. DB2 Messages 281
DSNJ220I • DSNJ224I
1. The ddname of the SYSPRINT, SYSIN, or SYSUT1
DSNJ221I PREVIOUS ERROR CAUSED xxxxxxxx
data set was not specified in the user’s job control
OPERATION TO BE BYPASSED
language (JCL).
2. The DB2 subsystem is currently executing. Explanation: DB2 encountered errors while
processing a utility. These errors subsequently caused
3. The bootstrap data set (BSDS) was allocated by
'xxxxxxxx' to be bypassed.
another job with a disposition (DISP) that conflicts
with the DISP specified in the user’s JCL. This message is a warning only and is displayed after
4. The data set associated with 'xxxxxxxx' is already messages that specify the error or errors that caused
open, possibly due to an earlier system abend. the utility operation to abend. Note that the error or
errors may not be associated with the current 'xxxxxxxx'
5. The user is not authorized to access the data set
operation; rather, under log utility processing, a
associated with 'xxxxxxxx'
significant error in any operation causes the control
6. Insufficient virtual storage is available to perform the statements for this and any subsequent operations to
OPEN command. be checked for syntax only. BSDS updates do not occur
7. The catalog indicates that the data set associated for any operation specified in this message.
with 'xxxxxxxx' has an invalid physical record size.
System Action: The log utility continues to process.
System Action: The current utility is terminated. However, for this and all subsequent operations, the
bootstrap data set (BSDS) is not updated and the utility
DB2 writes this message to the SYSPRINT data set, not only checks the syntax of the control statements.
to a console.
DB2 writes this message to the SYSPRINT data set, not
User Response: The user’s action depends on the to a console.
condition that caused the OPEN error. The following is a
list of appropriate actions corresponding to the User Response: Consult the previous messages and
conditions listed in the explanation: correct any errors that caused this message to be
1. Provide the missing DD statements, and then rerun generated. Resubmit the log utility job for all operations
the utility. Refer to DB2 Utility Guide and Reference that have been bypassed.
for details about the required DD statements.
2. Wait until the DB2 subsystem is inactive before DSNJ222I INVALID SPECIFICATION OF xxxx
running the utility again because the log utility PARAMETER ARGUMENT
cannot execute while the DB2 subsystem is active.
Explanation: You specified the parameter 'xxxx'. This
3. Correct the disposition conflict and then rerun the parameter is not valid for the argument.
utility.
System Action: The current utility is terminated. This
4. Submit an access method services (IDCAMS)
message is written to the SYSPRINT data set, not to a
VERIFY job against the data set associated with
console.
'xxxxxxxx'. Rerun the log utility job.
5. In the case of an authorization failure, a separate User Response: Correct the parameter argument on
message is usually generated from the authorization the control statement, and rerun the utility.
facility (RACF, for example). Investigate the
authorization messages and obtain the proper DSNJ223I xxxx PARAMETER ARGUMENT
authorization before running the utility again. EXCEEDS MAXIMUM ALLOWABLE
6. Insufficient virtual storage is usually accompanied by LENGTH
a separate error from the MVS operating system.
Explanation: The argument value of the parameter
Increase the REGION size on the JCL job step and
named 'xxxx' exceeds the maximum length allowed.
rerun the utility.
7. Contact the system programmer. System Action: The current utility is terminated. This
message is written to the SYSPRINT data set, not to a
console.
DSNJ220I BSDS IN CREATE MODE. NO DATA TO
MAP, DDNAME=nnnnnnnn User Response: Correct the parameter argument on
the control statement, and rerun the utility.
Explanation: The print log map utility found the BSDS
to be in create mode, so it cannot contain data to map.
'xxxxxxxx' contains the ddname of the data set. DSNJ224I xxxx PARAMETER APPEARS TOO
OFTEN
System Action: The current utility is terminated. This
message is written to the SYSPRINT data set, not to a Explanation: The parameter named 'xxxx' was
console. specified more than once on the same control
statement.
User Response: Correct the JCL so that a nonnull
data set can be processed. System Action: The current utility is terminated. This
282 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ225I • DSNJ231I
message is written to the SYSPRINT data set, not to a MVS/ESA SPL: Application Development Guide for a
console. description of these codes.
User Response: Remove the redundant parameter,
and rerun the utility. DSNJ229I csect-name OPEN FAILED FOR SYSIN
Explanation: An error occurred when the DB2 Print
DSNJ225I xxxx OPERATION SUCCESSFULLY Log Map utility tried to open the SYSIN data set.
COMPLETED
Possible causes are:
Explanation: The change log inventory (DSNJU003) 1. The DD name of the SYSIN data set was not
utility operation named 'xxxx' completed successfully. specified in the user’s job control language (JCL).
System Action: This message is written to the 2. Insufficient virtual storage is available to perform the
SYSPRINT data set, not to a console. OPEN command.
3. The characteristics of the SYSIN data set are
DSNJ226I SPECIFIED VOLUME ALREADY EXISTS different from those expected by the print log map
IN BSDS, DDNAME=xxxxxxx (DSNJU004) utility.
Explanation: The specified volume currently exists in System Action: DSNJU004 attempts to continue
the archive log records of the BSDS. 'xxxxxxxx' processing without an input control statement. DB2
specifies the ddname of the subject BSDS. writes this message to the SYSPRINT data set, not to
the system console.
System Action: The current utility is terminated. This
message is written to the SYSPRINT data set, not to a User Response: Take one of the following actions
console. based on the cause of the error.
1. Provide the missing DD statement and rerun the
User Response: Either correct the parameter
utility. Refer to DB2 Utility Guide and Reference for
argument on the control statement, or delete the
details about the required DD statements.
specified volume and rerun the utility.
2. Insufficient virtual storage is usually accompanied by
a separate error message from the MVS operating
DSNJ227I NO SPACE AVAILABLE IN BSDS FOR system. Increase the REGION size on the JCL job
ADDITIONAL ARCHIVE VOLUME step and rerun the utility.
ENTRIES, DDNAME=xxxxxxxx
3. Check that the SYSIN data set is a fixed record
Explanation: The maximum number of archive format (blocked or unblocked) with an LRECL of 80.
volumes has been exceeded, and no more space is You might need to contact the system programmer
available for volume entries in the copy specified. for help if this is a JES data set.
System Action: The current utility is terminated.
DSNJ230I LOG OFFLOAD SUBCOMPONENT
User Response: Delete some of the archive entries in INITIALIZATION PROCESSING FAILED
the specified copy number, and rerun the utility.
Explanation: During log manager initialization, the
off-load function was unable to complete its initialization
DSNJ228I csect-name LOG DEALLOCATION process.
ERROR DSNAME=dsname, ERROR
STATUS=eeeeiiii, SMS REASON System Action: DB2 startup is terminated.
CODE=ssssssss
Operator Response: Notify the system programmer.
Explanation: The log manager encountered an error
System Programmer Response: One or more error
while trying to dynamically deallocate the data set. Error
messages describing the specific error preceded this
status is the error reason code returned by MVS
message. Refer to the specific message(s) for error
dynamic allocation.
analysis and the appropriate actions to take.
System Action: Log manager processing continues.
Operator Response: Notify the system programmer. DSNJ231I LOG COMMAND INITIALIZATION
PROCESSING FAILED
System Programmer Response: The error status
portion of this message contains the 2-byte error code Explanation: During log manager initialization, the log
(S99ERROR) followed by the 2-byte information code command function was unable to complete its
(S99INFO) from the SVC request block. If the initialization process.
S99ERROR code indicates an SMS deallocation error
System Action: DB2 startup is terminated.
(97XX), then 'ssssssss' contains additional SMS reason
code information obtained from S99ERSN. Refer to the Operator Response: The rest of subsystem
termination will direct the actions you should take.
Chapter 11. DB2 Messages 283
DSNJ232I • DSNJ238I
System Programmer Response: One or more error Operator Response: Notify the system programmer.
messages describing the specific error preceded this
System Programmer Response: One or more error
message. Refer to the specific message(s) for error
messages describing the specific error preceded this
analysis and the appropriate action to take.
message. Refer to the specific message(s) for error
This message will be of interest to the IBM support analysis and the appropriate action to take.
center when the problem is described.
DSNJ236I BOOTSTRAP ACCESS TERMINATION
DSNJ232I OUTPUT DATA SET CONTROL PROCESSING FAILED
INITIALIZATION PROCESSING FAILED
Explanation: During log manager termination, the
Explanation: During log manager initialization, the bootstrap data set access function was unable to
output data set control function was unable to complete complete its termination process.
its initialization process.
System Action: Log manager shutdown continues to
System Action: DB2 startup is terminated. the next step.
System Programmer Response: One or more error Operator Response: Notify the system programmer.
messages describing the specific error preceded this
System Programmer Response: One or more error
message. Refer to the specific message for error
messages describing the specific error preceded this
analysis and the appropriate action to take.
message. Refer to the specific message(s) for error
This message will be of interest to the IBM support analysis and the appropriate action to take.
center when the problem is described.
DSNJ237I csect-name INVALID CONTROL
DSNJ233I ARCHIVE LOG READ INITIALIZATION STATEMENT. THE FIRST WORD MUST
PROCESSING FAILED BE ’MEMBER’.
Explanation: During log manager initialization, the Explanation: The print log map (DSNJU004) utility
archive log read function was unable to complete its read an invalid control statement from the SYSIN data
initialization process. set.
System Action: DB2 startup is terminated. System Action: DSNJU004 ignores the control
statement and attempts to continue processing by
Operator Response: Notify the system programmer.
looking for a SYSUT1 DD statement to describe the
System Programmer Response: One or more error BSDS that is to be printed.
messages describing the specific error preceded this
User Response: Refer to DB2 Utility Guide and
message. Refer to the specific message(s) for error
Reference for information on creating a print log map
analysis and the appropriate action to take.
(DSNJU004) utility control statement. Correct or remove
the control statement and rerun the job.
DSNJ234I ARCHIVE LOG COMMAND QUIESCE
Problem Determination: If you suspect an error in
INITIALIZATION PROCESSING FAILED
DB2, refer to Part 2 of DB2 Diagnosis Guide and
Explanation: During log manager initialization, the Reference for information on identifying and reporting
quiesce function which supports the -ARCHIVE LOG the problem.
MODE(QUIESCE) command processing was unable to
Collect the following diagnostic items listed in
complete its initialization process.
“Appendix B. Problem determination” on page 1281 : 32.
System Action: DB2 startup is terminated.
Operator Response: Notify the system programmer. DSNJ238I LOG OFFLOAD TERMINATION
PROCESSING FAILED
System Programmer Response: One or more error
messages describing the specific error preceded this Explanation: During log manager termination, the
message. Refer to the specific message(s) for error off-load function was unable to complete its termination
analysis and the appropriate action to take. process.
System Action: Log manager shutdown continues to
DSNJ235I OUTPUT BUFFER WRITER the next step.
INITIALIZATION PROCESSING FAILED
Operator Response: Notify the system programmer.
Explanation: During log manager initialization, the
System Programmer Response: One or more error
output buffer writer function was unable to complete its
messages describing the specific error preceded this
initialization process.
message. Refer to the specific message(s) for error
System Action: DB2 startup is terminated. analysis and the appropriate action to take.
284 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ239I • DSNJ245I
message. Refer to the specific message(s) for error
DSNJ239I LOG COMMAND TERMINATION
analysis and the appropriate action to take.
PROCESSING FAILED
Explanation: During log manager termination, the log
DSNJ243I OUTPUT BUFFER WRITER
command function was unable to complete its
TERMINATION PROCESSING FAILED
termination process.
Explanation: During log manager termination, the
System Action: Log manager shutdown continues to
output buffer writer function was unable to complete its
the next step.
termination process.
Operator Response: Notify the system programmer.
System Action: Log manager shutdown continues to
System Programmer Response: One or more error the next step.
messages describing the specific error preceded this
Operator Response: Notify the system programmer.
message. Refer to the specific message(s) for error
analysis and the appropriate action to take. System Programmer Response: One or more error
messages describing the specific error preceded this
message. Refer to the specific message(s) for error
DSNJ240I OUTPUT DATA SET CONTROL
analysis and the appropriate action to take.
TERMINATION PROCESSING FAILED
Explanation: During log manager termination, the
DSNJ244I LOG TERMINATION RECEIVED
output data set control function was unable to complete
RETURN CODE nnn FROM xxxxxxxx
its termination process.
MACRO
System Action: The log manager shutdown continues
Explanation: Log manager termination was passed a
to the next step.
bad return code from the named macro.
Operator Response: Notify the system programmer.
System Action: Log manager termination processing
System Programmer Response: One or more error continues.
messages describing the specific error preceded this
Operator Response: Record the return code and
message. Refer to the specific message(s) for error
macro-name, and notify the system programmer.
analysis and the appropriate action to take.
System Programmer Response: This message is
associated with a failure in the named macro. If you
DSNJ241I ARCHIVE LOG READ TERMINATION
suspect an error in DB2, refer to Part 2 of DB2
PROCESSING FAILED
Diagnosis Guide and Reference for information on
Explanation: During log manager termination, the identifying and reporting the problem.
archive log read function was unable to complete its
termination process.
DSNJ245I CONDITIONAL RESTART RECORD
System Action: Log manager shutdown continues to INDICATES TRUNCATION AT xxx rrr.
the next step. REPLY Y TOCONTINUE, N TO CANCEL
Operator Response: Notify the system programmer. Explanation: The conditional restart control record in
use indicates that the DB2 log should be truncated at
System Programmer Response: One or more error
the specified RBA or LRSN.xxx is replaced by either
messages describing the specific error preceded this
RBA or LRSN, and rrr is the value specified in the
message. Refer to the specific message(s) for error
current record.
analysis and the appropriate action to take.
System Action: If Y, DB2 startup continues. If N, DB2
startup is terminated.
DSNJ242I ARCHIVE LOG COMMAND QUIESCE
TERMINATION PROCESSING FAILED Operator Response: Reply N if the truncation is going
to occur at an undesirable point. Notify system
Explanation: During log manager termination, the
programmer. Reply Y to continue the restart.
quiesce function which supports the -ARCHIVE LOG
MODE(QUIESCE) command processing was unable to System Programmer Response: Rerun the change
complete its termination process. log inventory (DSNJU003) utility to modify the
conditional restart record.
System Action: Log manager shutdown continues to
the next step.
Operator Response: Notify the system programmer.
System Programmer Response: One or more error
messages describing the specific error preceded this
Chapter 11. DB2 Messages 285
DSNJ246I • DSNJ301I
System Action: DB2 startup is terminated.
DSNJ246I CONDITIONAL RESTART RECORD
INDICATES COLD START AT RBA rrr. Operator Response: Notify the system programmer.
REPLY Y TO CONTINUE, N TO CANCEL
System Programmer Response: One or more error
Explanation: The conditional restart control record in messages describing the specific error precede this
use indicates that DB2 is to be cold started and that message. Refer to these messages for error analysis
logging is to be begin at the specified RBA. and the appropriate action to take.
System Action: If 'Y', DB2 startup continues. If 'N',
DB2 startup is terminated. DSNJ250E csect-name DATA SHARING REQUIRES
ALL ACTIVE LOG DATA SETS TO BE
Operator Response: Reply 'N' if the truncation is
DEFINED WITH SHAREOPTIONS(2 3)
going to occur at an undesirable point. Notify the
OR HIGHER.
system programmer. Reply 'Y' to continue the cold start.
Explanation: DB2 detected an active log data set
System Programmer Response: Rerun the change
defined with share options that do not permit recovery
log inventory (DSNJU003) utility to modify the
operations in a data sharing environment. This message
conditional restart record.
is followed by message DSNJ251E, which identifies the
specific active log data set.
DSNJ247E csect-name I/O ERROR DURING
All active log data sets for a DB2 data sharing member
PROCESSING OF rrr RC = rc, REASON
must be defined with a minimum of SHAREOPTIONS(2
= reason
3) for successful DB2 initialization. See the description
Explanation: The I/O error occurred at record 'rrr'. 'rc' of message DSNJ251E for more details.
indicates the return code received from the I/O
System Action: The DB2 subsystem detecting this
operation. 'reason' indicates the reason code received
condition is terminated.
from the I/O operation.
If a return code '4' was received, this indicates that the
DSNJ251E csect-name DATA SET dsname FAILS
log manager detected a problem. If a return code '8'
TO MEET THE MINIMUM REQUIRED
was received, this indicates a VSAM error.
SHAREOPTIONS FOR DATA SHARING.
System Action: DB2 startup terminates.
Explanation: The share options defined for the data
Operator Response: Notify the system programmer. set named in the message are too low to permit the
data set to participate in a DB2 data sharing group. All
System Programmer Response: For a return code of
active log data sets must be defined with
'4', if you suspect an error in DB2, refer to Part 2 of
SHAREOPTIONS(2 3) or higher in order to participate
DB2 Diagnosis Guide and Reference for information on
in a data sharing group.
identifying and reporting the problem. For a return code
of '8', execute an offline access method services job to System Action: The DB2 subsystem detecting this
determine the cause of the VSAM error. error is terminated.
System Programmer Response: Using IDCAMS
DSNJ248I ARCHIVE LOG READ DEALLOCATION LISTCAT or TSO LISTCAT, display the share options of
INITIALIZATION PROCESSING FAILED all of the active log data sets of all of the members in
the data sharing group. For any active log data set that
Explanation: During log initialization, the archive log
is defined with less than SHAREOPTIONS(2 3), use
read deallocation process was unable to complete its
IDCAMS ALTER or TSO ALTER to alter the data set
initialization.
definitions to SHAREOPTIONS(2 3) or higher.
System Action: DB2 startup is terminated.
Problem Determination: If you suspect an error in
Operator Response: Notify the system programmer. DB2, refer to Part 2 of DB2 Diagnosis Guide and
Reference for information on identifying and reporting
System Programmer Response: One or more error the problem.
messages describing the specific error precede this
message. Refer to these messages for error analysis Collect the following diagnostic items listed in
and the appropriate action to take. “Appendix B. Problem determination” on page 1281: 1,
2, 5, 11.
DSNJ249I ARCHIVE LOG READ SCHEDULER
INITIALIZATION PROCESSING FAILED DSNJ301I csect-name ERROR action ONLINE
BOOTSTRAP DATA SET
Explanation: During log initialization, the archive log
read scheduling process was unable to complete its Explanation: During command processing for the
initialization. -RECOVER BSDS command or the -ARCHIVE LOG
286 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ302I • DSNJ305I
command, an error occurred while performing an
DSNJ303I WRITE ERROR ON REPLACEMENT
operation on the Bootstrap Data Set. The type of
BSDS DSNAME=... ERROR STATUS=...
operation is specified in the 'action' keyword in the
message text: Explanation: The -RECOVER BSDS command
v ACCESSING Unable to OPEN the BSDS. encountered an error while attempting to write to the
specified bootstrap data set. Error Status contains the
v READING Unable to read a required record from the
VSAM return and feedback codes. It is a 2-byte field
BSDS.
with the first containing the hexadecimal return code
v UPDATING Unable to write a required record to the and the second containing the hexadecimal feedback
BSDS. code.
v RESTORING DUAL The contents of the stable BSDS
System Action: Processing of the command is
was successfully copied to the replacement BSDS;
terminated. The system continues in single BSDS
however, the DB2 subsystem was unable to
mode.
successfully restore dual BSDS operation.
Operator Response: Notify the system programmer.
System Action: If this message was received during
processing of the -RECOVER BSDS command, then System Programmer Response: Execute an offline
the DB2 subsystem will continue in single BSDS mode. access method services job to delete or rename the
If this message was received during processing of the replacement BSDS and define a new BSDS with the
-ARCHIVE LOG command, the archive log history same name. Reenter the log manager -RECOVER
record in the BSDS will not be updated to reflect the BSDS command to reestablish dual BSDS mode.
occurrence of an -ARCHIVE LOG command; logging
and the off-load processing will continue.
DSNJ304I ERROR CLOSING REPLACEMENT
Operator Response: Inform the system programmer BSDS DSNAME=... ERROR STATUS=...
of the type of error that occurred, and whether the error
Explanation: The -RECOVER BSDS command
occurred while processing a -RECOVER BSDS
encountered an error while attempting to close the
command or an -ARCHIVE LOG command.
specified bootstrap data set. Error Status contains the
System Programmer Response: If this message was VSAM return and feedback codes. It is a 2-byte field
received during processing of the -RECOVER BSDS with the first containing the hexadecimal return code
command, then recovery action must be performed on and the second containing the hexadecimal feedback
the bootstrap data set before reentering the command. code.
If this message was received during processing of the
System Action: Processing of the command is
-ARCHIVE LOG command, no action is necessary.
terminated. The system continues in single BSDS
mode.
DSNJ302I ALLOCATION ERROR ON
Operator Response: Notify the system programmer.
REPLACEMENT BSDS DSNAME=...
ERROR STATUS=... System Programmer Response: Execute an offline
access method services job to delete or rename the
Explanation: The RECOVER BSDS command
replacement BSDS and define a new BSDS with the
encountered an error while trying to dynamically allocate
same name. Reenter the log manager -RECOVER
the specified data set. DSNAME is the data set name.
BSDS command to reestablish dual BSDS mode.
Error Status is the error code and information code
returned by MVS dynamic allocation.
DSNJ305I REPLACEMENT BSDS NOT EMPTY
System Action: Processing of the command is
DSNAME=...
terminated. The system continues in single BSDS
mode. Explanation: The -RECOVER BSDS command was
issued, but the replacement bootstrap data set was not
Operator Response: Determine the cause of the error
empty; that is, it contained data.
from the error status contained in the message, and
correct the condition. Then reenter the -RECOVER System Action: Processing of the command is
BSDS command. terminated. DB2 continues in single BSDS mode.
System Programmer Response: The error status Operator Response: Notify the system programmer.
portion of this message contains the 2-byte error code
(S99ERROR) followed by the 2-byte information code System Programmer Response: Execute an offline
(S99INFO) from the SVC request block. Refer to the access method services job to delete or rename the
appropriate MVS publication for a description of these error BSDS and define a new BSDS with the same
codes. name. Reenter the log manager -RECOVER BSDS
command to reestablish dual BSDS mode.
Chapter 11. DB2 Messages 287
DSNJ306I • DSNJ313I
This message will be followed by message DSNJ311I or
DSNJ306I DUAL BSDS MODE ALREADY
DSNJ317I.
ESTABLISHED
Operator Response: No operator response is
Explanation: The -RECOVER BSDS command was
necessary. However, it can be expected that users and
issued, but DB2 was already in dual BSDS mode.
jobs using DB2 resources will be suspended (queued)
System Action: The command is ignored. by DB2 through the duration of the specified time
interval, or until the DB2 subsystem can be certain that
all update activity has been effectively blocked. At some
DSNJ307I LOG INITIALIZED IN SINGLE BSDS
point, this message will be followed by the DSNJ311I
MODE
message or DSNJ317I message.
Explanation: The -RECOVER BSDS command was
issued, but the system was initialized in single BSDS
DSNJ311I csect-name ASYNCHRONOUS LOG
mode.
ARCHIVE (OFFLOAD) TASK INITIATED
System Action: Processing of the command is
Explanation: A user-initiated -ARCHIVE LOG
terminated. The system continues in single BSDS
command has been accepted by the DB2 subsystem.
mode.
An asynchronous task to archive (off-load) the active log
data set has been started.
DSNJ310I (A)SYNCHRONOUS ARCHIVE LOG
System Action: The current active log data set(s) will
COMMAND QUIESCE PROCESSING
be truncated and switched to the next available active
STARTED FOR MAXIMUM OF xxx
log data set(s), and an asynchronous off-load task will
SECONDS
be initiated to archive the Active log data set(s).
Explanation: An -ARCHIVE LOG command with the
The term ASYNCHRONOUS is used to indicate that
MODE(QUIESCE) option has been accepted by the
control will be returned to the invoker as soon as the
DB2 subsystem. The quiesce processing has
off-load task has been started. Thus, the DB2 command
commenced.
processor will accept — and process — any DB2
System Action: The DB2 subsystem will attempt to commands while the off-load task is running.
stop all updates to DB2 resources within the time period
This message is followed by message DSNJ312I if the
specified in the message. Users/jobs operating on the
MODE(QUIESCE) option was used with the -ARCHIVE
DB2 subsystem will be allowed to reach a point of
LOG command.
consistency (commit point) before being blocked from
further update activity. Jobs and users will be Operator Response: The operator should respond per
suspended until they are released by DB2 following the normal operational procedures when the off-load task
initiation of the off-load processing. If the DB2 begins.
subsystem can effectively block all users from
performing updates before the maximum specified time,
DSNJ312I ARCHIVE LOG QUIESCE ENDED.
then the off-load will be initiated immediately, and
UPDATE ACTIVITY AGAINST DB2
normal processing will be resumed.
RESOURCES IS NOW RESUMED.
The message will display either the word
Explanation: An -ARCHIVE LOG command with the
SYNCHRONOUS or ASYNCHRONOUS, to inform the
MODE(QUIESCE) option was processed by the DB2
user of the type of quiesce processing which has been
subsystem. As part of the MODE(QUIESCE)
used.
processing, an attempt was made to stop all new
v If the word SYNCHRONOUS is displayed, then the update activity against DB2 resources. This message
invoker used the WAIT(YES) option. This means that signals the end of the quiesce processing, and the
quiesce processing will be synchronous to the user; resumption of normal DB2 activity for all users and jobs
that is, the user can enter additional DB2 commands, which were blocked during the quiesce period.
but the commands will not be processed by the DB2
command processor until the quiesce processing has This message follows message DSNJ311I or DSNJ317I.
ended. System Action: The DB2 subsystem has now
v If the word ASYNCHRONOUS is displayed, then the resumed all normal DB2 activity for all users and jobs
invoker used the WAIT(NO) option, or did not specify that were blocked during the quiesce period.
the WAIT option. This means that quiesce processing
will be asynchronous to the user; that is, control will
be returned to the invoker as soon as the quiesce DSNJ313I PARAMETER SPECIFIED ON THE
task has been started. Thus, the DB2 command keyword KEYWORD (value) IS NOT IN
processor will accept - and process - any new DB2 THE RANGE OF ALLOWABLE VALUES
commands while the quiesce task is running. Explanation: This message was generated by an
error occurring in one of the following commands:
288 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ314I • DSNJ317I
v ARCHIVE LOG command with MODE(QUIESCE)
DSNJ317I ARCHIVE LOG QUIESCE PERIOD
v SET ARCHIVE EXPIRED. NUMBER OF OUTSTANDING
v SET LOG UR'S = xxxx. ARCHIVE LOG
PROCESSING WILL BE TERMINATED,
You specified a value for one of the command options AND UPDATE ACTIVITY AGAINST DB2
that was outside of the range of allowed values. RESOURCES WILL BE RESUMED.
HH:MM:SS
System Action: Processing for the ARCHIVE LOG,
SET ARCHIVE, or SET LOG command is terminated. Explanation: An -ARCHIVE LOG MODE(QUIESCE)
This message is followed by message DSN9023I. command was processed by the DB2 subsystem;
however, the DB2 subsystem was not able to quiesce
Operator Response: Refer to DB2 Command all update activity in the user-specified quiesce time
Reference for the correct syntax of the command. interval.
Correct the command syntax and reenter the command.
System Action: This message is informational only.
The DB2 subsystem determined that 'xxxx' units of
DSNJ314I xxxx KEYWORD REQUIRES yyyy recovery (URs) did not reach a point of consistency
KEYWORD TO ALSO BE SPECIFIED during the quiesce period, and therefore could not be
ON THE COMMAND stopped from continuing their associated update
Explanation: A command was entered which specified processing.
the 'xxxx' keyword. However, use of the 'xxxx' keyword Consequently, the -ARCHIVE LOG processing will be
requires that the 'yyyy' keyword also be used. terminated. The current active log data set(s) will not be
System Action: Command processing terminates for truncated, and will not be switched to the next available
the -ARCHIVE LOG or -RECOVER BSDS command. active log data set(s). The log archive (off-load) task will
This message is followed by message DSN9023I. not be created. All jobs and users suspended during the
quiesce will be resumed, and normal update activity
Operator Response: Refer to the DB2 Command against DB2 resources will be commenced.
Reference for the correct syntax of the command.
Correct the command syntax, and reenter the This message will be followed by the DSNJ312I
command. message.
Operator Response: Contact the system programmer.
DSNJ315I -STOP DB2 MODE(FORCE) IN System Programmer Response: A determination
PROGRESS must be made whether the outstanding (nonquiesced)
Explanation: An attempt was made to issue an URs represent significant work.
-ARCHIVE LOG command when a -STOP DB2 Each user on the system has a unit of recovery if they
MODE(FORCE) command was already in progress. are modifying DB2 resources. URs are also created by
System Action: Command processing terminates for the DB2 subsystem itself for internal processing. Since
the -ARCHIVE LOG command. The -STOP DB2 the purpose of the MODE(QUIESCE) option is to have
MODE(FORCE) processing continues. all URs reach a point of consistency (commit point)
before the active log data set is truncated and
off-loaded, determine all outstanding nonqueued jobs
DSNJ316I SYSTEM QUIESCE ALREADY IN and users by using -DISPLAY THREAD and the MVS 'D
PROGRESS A,L' operator command.
Explanation: An attempt was made to issue an It should be noted that URs may be outstanding due to
-ARCHIVE LOG command with the MODE(QUIESCE) lock contention between a user or job which holds a
option when a system quiesce was already in progress. resource (and has reached a point of consistency), and
The system quiesce could be the result of processing a user or job which wants a lock (and therefore cannot
by another -ARCHIVE LOG MODE(QUIESCE) reach a point of consistency).
command, or by a -STOP DB2 MODE(QUIESCE)
command. Before resubmitting the -ARCHIVE LOG command with
the MODE(QUIESCE) option, either:
System Action: Command processing will terminate.
v Wait until the threads have been deallocated.
The system quiesce currently in progress will continue.
v Wait until the DB2 subsystem is less busy.
v Force the offending thread(s) to terminate.
v Use the TIME option to dynamically override and
extend the maximum quiesce time period specified in
ZPARMS.
Chapter 11. DB2 Messages 289
DSNJ318I • DSNJ320I
v Or, if having all URs reach a point of consistency in must be taken to complete other waiting off-load tasks.
the active log is no longer critical, issue the Once another active log is made available (re-usable)
-ARCHIVE LOG command without the by completing the off-load process for it, the command
MODE(QUIESCE) option. processing for the current active log can proceed.
Execute an MVS Display System Requests command
Important: If the decision is made to use the -ARCHIVE
(D R,L for example) to determine the outstanding
LOG command without the MODE(QUIESCE) option,
requests related to the log off-load process. Take the
the active log data set(s) will be truncated without
necessary action to satisfy any requests, and permit
regard to quiescing activity on the DB2 subsystem. If
off-load to continue. If off-load fails to complete
the resulting archive log data set is used for recovery, it
normally, or cannot be initiated, notify the systems
is possible that some URs may be found to be In-flight,
programmer.
In-Abort, In-Commit, or In-doubt during DB2
initialization. System Programmer Response: Either correct the
problem that is causing the off-load process to fail, or
If expiration of the quiesce period before all URs reach add more active log data sets. Note that the latter action
a consistent point are a chronic problem, an adjustment requires DB2 to be down and the change log inventory
to ZPARMs may have to be made. The quiesce period (DSNJU003) utility to be run.
is controlled by the 'Maximum Quiesce Period' ZPARM.
Possible causes for the shortage of active log data
Refer to the discussion about the Archive Log
space are:
Parameters (DSNTIPA) panel in Part 2 of DB2
Installation Guide. v Excessive logging. For example, too many users
requesting logs at the same time, or too many utilities
specifying LOG (YES).
DSNJ318I csect-name ARCHIVE LOG COMMAND
v Delayed or slow off-loading. For example, failure to
ALREADY IN PROGRESS
mount archive volumes, incorrect replies to off-load
Explanation: An attempt was made to issue an messages, or slow device speeds.
ARCHIVE LOG command when an ARCHIVE LOG v Excessive use of the -ARCHIVE LOG command.
command was already in progress. In data sharing, the Each invocation of the command causes the DB2
ARCHIVE LOG command currently in progress could be subsystem to switch to a new active log data set.
initiated by another member. Excessive use could consume the available active log
Operator Response: If the conflicting command data space if the resulting off-loads were not
satisfies your archival request, do not reissue the processed in a timely manner.
command. Otherwise, wait for the conflicting command v Off-loads(s) failed (see Operator Response).
to complete and then reissue the -ARCHIVE LOG v Insufficient active log space (see Operator
command. Response).
DSNJ319I csect name CURRENT ACTIVE LOG DSNJ320I csect-name UNABLE TO PROCESS
DATA SET IS THE LAST AVAILABLE LOG TRUNCATION REQUEST DUE TO
ACTIVE LOG DATA SET. ARCHIVE LOG SUBSYSTEM COMPONENT action
PROCESSING WILL BE TERMINATED. FAILURE
Explanation: The -ARCHIVE LOG command was Explanation: While processing an -ARCHIVE LOG
rejected because the current active log is the last command, an internal request was made of the log
available active log data set. To process the command buffer output routine to force-write the log buffers and to
when these conditions exist would cause the DB2 truncate and switch the active log to the next available
subsystem to exhaust its available active log resources active log data set(s). The request failed during the
and immediately halt processing. processing of the 'action' specified in the message.
System Action: Processing for the command is System Action: Processing for the command is
terminated. If the situation is not corrected, the DB2 terminated.
subsystem will issue the DSNJ110E message (if it has
not already done so) as the available active log data User Response: Notify the system programmer.
space reaches critically low levels. Ultimately, message Operator Response: Notify the system programmer.
DSNJ111E will be issued when the available active log
data space is exhausted, and the DB2 online System Programmer Response: This error is an
processing will halt until active log space is made internal error detected by the DB2 subsystem. The error
available. may be caused by an unrelated ABEND in the Log
Buffer Writer component (DSNJWxxx), by a -STOP DB2
User Response: Notify the operator or system MODE(FORCE) command, or by abnormal subsystem
programmer. termination. Refer to messages and ABENDS which
Operator Response: To clear this condition, steps precede this message.
290 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ321I • DSNJ328I
DSNJ321I UNABLE TO CONTINUE ARCHIVE LOG DSNJ325I name count time
QUIESCE DUE TO INTERNAL
Explanation: This message, in combination with
SUBSYSTEM ERROR. ARCHIVE LOG
messages DSNJ323I and DSNJ324I, provides the
PROCESSING WILL BE TERMINATED,
parameter information that is a part of the -DISPLAY
AND UPDATE ACTIVITY AGAINST DB2
ARCHIVE report.
RESOURCES WILL BE RESUMED.
name Identifies the count and time values in the
Explanation: An -ARCHIVE LOG command with the
message line.
MODE(QUIESCE) option was processed by the DB2
subsystem. As part of the MODE(QUIESCE) DSNZPARM
processing, an attempt was made to stop all new Values specified during DB2
update activity against DB2 resources. During the installation.
internal subsystem interaction between the log manager
and the recovery manager, an internal interface error CURRENT
was detected by the recovery manager. Current values in the DB2 system.
System Action: The -ARCHIVE LOG count The value for COUNT as specified in name.
MODE(QUIESCE) processing is terminated. This time The value for TIME as specified in name.
message will be followed by message DSNJ312I after
all users and jobs quiesced by the MODE(QUIESCE) The message number is not included in this message.
processing are resumed.
User Response: Notify the system programmer. DSNJ326I
Operator Response: Notify the system programmer. Explanation: This message separates messages
System Programmer Response: This error is an DSNJ325I and DSNJ327I that are generated by the
internal error detected by the DB2 subsystem. Retry the -DISPLAY ARCHIVE command. The message number
-ARCHIVE LOG MODE(QUIESCE) command. If the is not included in this message.
error persists, the active log data sets may be switched
using the -ARCHIVE LOG command without the DSNJ327I ADDR STATUS CORR-ID VOLSER
MODE(QUIESCE) option. DATASET_NAME
Explanation: This message displays the column
DSNJ322I DISPLAY ARCHIVE REPORT headings for the DISPLAY ARCHIVE report.
FOLLOWS—
The message number is not included in this message.
Explanation: This message is always generated as
the title for the -DISPLAY ARCHIVE command report
output. It precedes the other messages generated by DSNJ328I tapeaddr status corr-id vname dsname
this command. Explanation: This message, in combination with
The series of messages DSNJ323I through DSNJ329I message DSNJ327I, provides the tape unit information
provide the formatted report for -DISPLAY ARCHIVE. that is part of the -DISPLAY ARCHIVE report.
tapeaddr
DSNJ323I COUNT TIME The physical tape address of the tape unit
allocated to read archive log.
Explanation: The column headings for the list of
parameter specifications generated by the -DISPLAY status Status of tape address:
ARCHIVE command are displayed. The message BUSY Tape address is actively processing
number is not included in this message. an archive log data set.
PREM Tape address is active and allocated
DSNJ324I (TAPE UNITS) (MIN,SEC) for premount.
Explanation: The format of the COUNT and TIME AVAIL Tape unit is inactive and waiting for
parameter specifications displayed by the -DISPLAY work.
ARCHIVE command are shown. The message number
is not included in this message. corr-id The correlation id associated with the user of
the tape being processed. If the status is
PREM or AVAIL, this column might contain
’*****’, indicating no current user is associated
with this tape.
vname The name of the tape volume that is mounted
on the tape address.
Chapter 11. DB2 Messages 291
DSNJ329I • DSNJ336I
dsname
DSNJ333I csect-name SYSTEM CHECKPOINT
The data set on the tape volume that is being
INITIATED
processed (BUSY and PREM) or was last
processed (AVAIL). Explanation: This message indicates that the SET
LOG command processed successfully and that a
The message number is not included in this message. system checkpoint has been initiated.
DSNJ329I END OF DISPLAY ARCHIVE REPORT DSNJ334I PARAMETER SPECIFIED ON THE
keyword KEYWORD (VALUE)
Explanation: This message follows messages CONTAINS INVALID CHARACTERS
DSNJ322I through DSNJ328I and indicates that the
-DISPLAY ARCHIVE report was generated successfully. Explanation: A -SET ARCHIVE command was
The message number is not included in this message. processed by the DB2 subsystem. One of the command
keywords specified a value that contains an invalid
character.
DSNJ330I ARCHIVE LOG VOLUMES REQUIRED
FOR CONNECTION ID conn-id System Action: Processing for the -SET ARCHIVE
CORRELATION ID corr-id command is terminated. This message is followed by
the DSN9023I message.
Explanation: This message is the title for the
ARCHIVE LOG VOLUMES report output. The ARCHIVE Operator Response: Refer to DB2 Command
LOG VOLUMES report lists the archive log volumes Reference for the syntax of the command. Correct the
needed by the correlation ID for that connection ID. This syntax and reenter the command.
message is generated automatically by the archive read
process at the first archive log tape mount for corr-id.
DSNJ335I INVALID KEYWORDS COMBINATION IN
This message precedes the other messages generated
SET ARCHIVE COMMAND
by this action.
Explanation: This command requires that keyword
This message, in combination with messages DSNJ331I
COUNT or keyword TIME be specified. If both are
and DSNJ332I, provides the formatted report for the
omitted, the keyword DEFAULT must be specified. It is
ARCHIVE LOG VOLUMES requested.
invalid to specify keyword DEFAULT when either the
conn-id COUNT keyword or TIME keyword is specified.
An identifier representing the 'connection name'
System Action: Processing for the -SET ARCHIVE
used to establish the thread.
command is terminated. This message is followed by
corr-id An identifier associated with a specified thread. the DSN9023I message.
In TSO, it is either the authorization ID or the
Operator Response: Refer to DB2 Command
job name.
Reference for the syntax of the command. Correct the
syntax and reenter the command.
DSNJ331I avolume, avolume, avolume, avolume
...
DSNJ336I UNABLE TO ALLOCATE TAPE UNIT
Explanation: This message provides the tape volume FOR conn-id corr-id, x ALLOCATED, y
information for the Archive Log Volumes report output. ALLOWED.
avolume Explanation: An attempt to allocate a tape unit for
The name of the archive log volume required connection ID 'conn-id' failed. The current maximum
for this correlation ID. An ’avolume’ prefixed tape unit specified is ’y’, but only ’x’ are physically
with an ’*’ signifies that the data on the archive available.
log volume is also mapped by an active log
System Action: The 'conn-id corr-id' process is
data set. As such, the ’avolume’ might not be
queued until either an allocated tape unit becomes free
required for the read process, since the data is
or more tape units are varied online and made available
read from the active log, if possible.
to the DB2 archive read task.
Operator Response: This situation rectifies itself over
DSNJ332I END OF ARCHIVE LOG VOLUMES
time as currently allocated tape units become available.
REPORT
To improve throughput, vary additional tape units online
Explanation: This message follows messages and make them available to DB2. Note that a queue
DSNJ330I and DSNJ331I and indicates that the rescan is not attempted until the -SET ARC READ
ARCHIVE LOG VOLUMES report was generated COUNT command is issued or when an allocated tape
successfully. The message number is not included in dismounts.
this message.
292 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ337I • DSNJ351I
| command when logging has been resumed by the -SET
DSNJ337I SET ARCHIVE COMMAND
| LOG RESUME command.
COMPLETED COUNT(count)
TIME(minute,second)
DSNJ350I csect-name (A)SYNCHRONOUS
Explanation: This message indicates that the -SET
ARCHIVE LOG COMMAND QUIESCE
ARCHIVE command processed successfully and
PROCESSING STARTED IN DATA
displays the current values for COUNT and TIME.
SHARING
count The value for the COUNT parameter
Explanation: The DB2 subsystem of a data sharing
minute The 'minute' value for the TIME parameter group accepted an ARCHIVE LOG command with the
MODE(QUIESCE) option.
second
The 'second' value for the TIME parameter Each active DB2 member in the data sharing group
performs the quiesce operation. The member originating
the quiesce issues message DSNJ350I; all other
DSNJ338I NO TAPE ARCHIVE READING
members issue DSNJ310I as they start quiescing.
ACTIVITY
Explanation: This message indicates that there is no
DSNJ351I csect-name MEMBER member name
current archive tape reading activity to report.
STATUS=member status
The message number is not included in this message.
Explanation: This message appears in response to
MODE(QUIESCE) being specified with the ARCHIVE
DSNJ339I csect-name SET LOG COMMAND LOG command. It is one of a list of elements that
| COMPLETED, type(quantity) display archive related status of the indicated member
of the data sharing group. These member status
Explanation: This message indicates that the SET messages are preceeded by the message DSNJ359I
LOG command processed successfully, and displays and are followed by DSNJ361I.
| the current checkpoint frequency. The checkpoint
| frequency remains in effect until DB2 is restarted or until member name identifies the member of the data sharing
| the value is modified by a SET LOG or SET SYSPARM group.
| command.
member status indicates archive related status of the
| type Along with quantity, determines the current named member. It appears as one of the following:.
| system checkpoint frequency. It indicates
ABNORMALLY TERMINATING
| MINUTES for a time-based checkpoint
The named member was undergoing abnormal
| frequency, or LOGRECORDS if the checkpoint
subsystem termination at the time ARCHIVE
| frequency is determined by the number of log
LOG processing was active for the data
| records that are written.
sharing group. ARCHIVE LOG command
| quantity processing for the remainder of the data
| The number of minutes, or the number of log sharing group terminates unsuccessfully.
| records that determine the current checkpoint
ARCHIVE ALREADY ACTIVE
| frequency.
ARCHIVE LOG command processing was
running at the named member at the time a
DSNJ340I csect-name COMMAND KEYWORD xxx succeeding ARCHIVE LOG command was
IS ONLY VALID FOR DATA SHARING issued. The succeeding ARCHIVE LOG
command terminates unsuccessfully for the
Explanation: An attempt was made to issue a DB2 remaining members of the data sharing group.
command with KEYWORD xxx on a DB2 that was not
initialized to participate in data sharing. CANCELED
ARCHIVE LOG command processing for the
System Action: The command request is rejected. named member was canceled due to a
problem encountered elsewhere in the data
| DSNJ341I csect-name -ARCHIVE LOG COMMAND sharing group. The quiesce operation is
| NOT ALLOWED, LOGGING IS interrupted and terminated and update activity
| SUSPENDED against DB2 resources is resumed before
command processing is terminated for the
| Explanation: An attempt to issue an -ARCHIVE LOG member.
| command failed because a -SET LOG SUSPEND
| command has suspended logging. COMMUNICATIONS FAILURE
A communications failure occurred between the
| System Action: Command processing terminates for named member and one or more other
| the -ARCHIVE LOG command. You may reissue the members in the data sharing group. The
Chapter 11. DB2 Messages 293
DSNJ352W • DSNJ355I
quiesce operation is interrupted and update interrupted and update activity is resumed
activity against DB2 resources is resumed before command processing is terminated for
before command processing is terminated for the member. ARCHIVE LOG command
the member. ARCHIVE LOG command processing for the remainder of the data
processing for the remainder of the data sharing group is unsuccessfully terminated.
sharing group terminates unsuccessfully.
FAILED DSNJ352W csect-name MEMBERS WERE NOT
The named member was inactive at the time OFFLOADED
the ARCHIVE LOG command was issued.
Explanation: DB2 issues this message during
Termination of the DB2 subsystem for this
processing of an ARCHIVE LOG command with the
member was abnormal. This status, if
MODE(QUIESCE) option. One or more quiesced
displayed for any member, will cause ARCHIVE
members were not available to receive the archive
LOG command processing for the entire data
request. DSNJ351I messages follow to display the
sharing group to terminate unsuccessfully.
quiesced members.
NOT AVAILABLE
At the next start up of the quiesced member, DB2
Archive command status for the named
switches (truncates) the current active log and initiates
member could not be determined. This
the archive task.
condition typically occurs when the named
member fails to respond during ARCHIVE LOG
command processing and is usually DSNJ353I csect-name DSNJ353I MEMBER member
accompanied by message DSNJ353I and/or name NOT RESPONDING.
message DSNJ355I.
Explanation: This message is displayed when a
QUIESCED response is needed but not received within an expected
The named member was active at the time the period of time during ARCHIVE LOG MODE(QUIESCE)
ARCHIVE LOG command was issued. Update command processing. This can occur as a result of
activity against DB2 resources had successfully abnormal subsystem termination under the named
quiesced for that member (no active URs) in member or, possibly from communications problems
response to specifying MODE(QUIESCE). among members of the data sharing group.
QUIESCED/OFFLOADING Operator Response: Examine the console log of the
The named member was active at the time the named member for operator information messages that
ARCHIVE LOG command was issued. Update might relate to the problem.
activity against DB2 resources had successfully
quiesced for that member (no active URs) in
response to specifying MODE(QUIESCE). The DSNJ354I csect-name DSNJ354I ARCHIVE LOG:
active log at the time was truncated and an ALL ACTIVE MEMBER(S) STARTED
offload process was initiated after all members OFFLOAD TASKS
in the data sharing group had reached a Explanation: This message is displayed when
quiesce point. MODE(QUIESCE) is specified with the ARCHIVE LOG
STOPPED command, after all active members in the data sharing
The named member was inactive at the time group have successfully quiesced their update activity
the ARCHIVE LOG command was issued. within the allotted time period. For each active member
Termination of the DB2 subsystem for this in the data sharing group, the active log is truncated
member was normal with no incomplete URs and switched, and an offload task is initiated to begin
outstanding. Log truncation and offload the offload process. Log truncation, switch and offload
processing are scheduled to be performed processing for stopped (and quiesced) members is
automatically the next time the named member performed the next time they are started.
is started. When the member is started, it is
important to ensure that archive processing DSNJ355I csect-name ARCHIVE LOG: ONE OR
occurs automatically. Certain error conditions MORE ACTIVE MEMBERS FAILED TO
might require entering an ARCHIVE LOG RESPOND OR START OFFLOAD
command via the operator console to cause TASKS
log truncation and offload processing to be
performed. This member status is Explanation: This message is displayed when
accompanied by warning message DSNJ362A. MODE(QUIESCE) is specified with the ARCHIVE LOG
command, and one or more active members could not
TIME EXCEEDED successfully quiesce their update activity in the time
The named member could not quiesce its allotted. Subsystem activity already quiesced is
update activity within the allotted period of resumed, and ARCHIVE LOG command processing
time. The incomplete quiesce operation is terminates unsuccessfully for all active members in the
294 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ356I • DSNJ370I
data sharing group. Message DSNJ353I might also processing does automatically occur when the inactive
appear with this message. members are started. Certain error conditions might
require the ARCHIVE LOG command to be individually
Operator Response: See the list of DSNJ351I
issued for a member if ARCHIVE LOG processing does
member status messages following message DSNJ359I
not occur automatically. Refer to messages DSNJ359I,
to determine the reason for the archive command
DSNJ351I, and DSNJ361I to identify the inactive
failure.
members.
DSNJ356I csect-name COMMUNICATIONS
DSNJ370I csect-name LOG DISPLAY CURRENT
FAILURE TERMINATED COMMAND
COPY1 LOG = dsname1 IS pct% FULL
Explanation: This message appears as a result of the CURRENT COPY2 LOG = dsname2 IS
failure of a communications request by one or more | pct% FULL H/W RBA = hw-rba, H/O
members of the data sharing group. This message is | RBA = ho-rba FULL LOGS TO
likely to be accompanied by DSN7xxx or other error OFFLOAD = nn OF mm, OFFLOAD
messages and/or an SVC dump. TASK IS status
System Action: ARCHIVE LOG command processing Explanation: This message, in combination with
terminates unsuccessfully for all members in the group. message DSNJ371I, provides the output from the
DISPLAY LOG command.
DSNJ357E SYSTEM QUIESCE FAILED dsname1
The data set name of the current active log
Explanation: This message indicates the unsuccessful copy1 data set. If this copy of the log is not
outcome of an ARCHIVE LOG MODE(QUIESCE) currently active, dsname1 will display
command. This message indicates that one or more INACTIVE.
members were unable to quiesce their update activity in
the time allowed. It is usually accompanied by one or dsname2
more related messages (e.g., DSNJ355I), and a list of The data set name of the current active log
member status messages indicating the reason for the copy2 data set. If this copy of the log is not
failure. currently active, dsname2 will display
INACTIVE.
Operator Response: Refer to messages DSNJ359I,
DSNJ351I and DSNJ361I to determine archive related pct The percentage of log space within the active
status of members in the data sharing group. log data set that has been written.
| hw-rba The RBA of the most recently written log
DSNJ359I MEMBER RESPONSES | record.
Explanation: This message marks the beginning of a | ho-rba The highest log RBA that has been offloaded
list of one or more DSNJ351I member status messages | to an archive log data set.
and precedes the first status message in the list.
nn The number of full active log data sets that
have not been archived.
DSNJ361I csect-name END OF MEMBER
mm The total number of active log data sets.
RESPONSES LIST
status Status of the offload task:
Explanation: This message marks the end of a list of
one or more DSNJ351I member status messages and BUSY,ALLC
follows the last status message in the list. Task is busy, allocating an archive log
data set. This could indicate a tape
mount request is outstanding.
DSNJ362E csect-name WARNING: LOGS OF nn
STOPPED OR FAILED MEMBERS NOT BUSY,BSDS
OFFLOADED. Task is busy, copying the BSDS data
set.
Explanation: This message is displayed when either
MODE(QUIESCE) or SCOPE(GROUP) is specified with BUSY,ACTV
the ARCHIVE LOG command, and one or more Task is busy, copying an active log
members of the data sharing group either stopped or data set.
failed and were not available to receive the archive
BUSY Task is busy, other processing.
request. Active log truncation, log switch and offload
processing for these inactive members is scheduled to AVAILABLE
be performed the next time those members are started. Task is available for work.
Operator Response: Verify that log switch and offload
Chapter 11. DB2 Messages 295
DSNJ371I • DSNJ402I
DSNJ371I DB2 RESTARTED time-date-1 RESTART DSNJ374I csect-name SET LOG options
| RBA rstrt-rba, CHECKPOINT COMMAND FAILED, reason
| FREQUENCY quantity type LAST
Explanation: A -SET LOG command has failed.
| SYSTEM CHECKPOINT TAKEN
options were specified on the command. reason
| time-date-2
describes the cause of the failure:
Explanation: This message, in combination with
ALREADY SUSPENDED
message DSNJ370I, provides the output from the
A -SET LOG SUSPEND command was issued
DISPLAY LOG command.
while update activity was suspended by a
| time-date-1 previous command.
The time and date when DB2 started.
DB2 STOPPING
rstrt-rba A -SET LOG SUSPEND command was issued,
The RBA that DB2 began logging when but DB2 is stopping.
started.
QUIESCE ACTIVE
| quantity A -SET LOG SUSPEND command was issued,
| The number of minutes, or the number of log but a system quiesce that was initiated by an
| records that determine the current checkpoint -ARCHIVE LOG command is in progress.
| frequency.
NOT SUSPENDED
| type Along with quantity, determines the current A -SET LOG RESUME command was issued,
| system checkpoint frequency. It indicates but update activity is not suspended.
| MINUTES for a time-based checkpoint
COMMAND ABEND
| frequency, or LOGRECORDS if the checkpoint
A -SET LOG command abnormally terminated.
| frequency is determined by the number of log
Update activity is not suspended.
| records that are written.
System Action: Command processing terminates.
| time-date-2
| The time and date of the last system
| checkpoint. DSNJ401I csect-name rrrr RECORD NOT FOUND
Explanation: An attempt was made to read the 'rrrr'
| DSNJ372I csect-name UPDATE ACTIVITY HAS record from the BSDS. In so doing, the read routine
| BEEN SUSPENDED FOR aaaa AT RBA (DSNJU01B) could not find the record.
| xxxxxxxxxxxx, LRSN yyyyyyyyyyyy,
| PRIOR CHECKPOINT RBA zzzzzzzzzzzz System Action: Utility processing continues. This
message is written to the SYSPRINT data set, not to a
Explanation: This message indicates that the -SET console.
LOG command with the SUSPEND option has
completed successfully.
DSNJ402I UNABLE TO LOCATE aaaa TBLSPACE
System Action: All log and database update activity NAME IN SYSTEM CATALOG OR
has been suspended for DB2 subsystem aaaa. DIRECTORY DATABASES
xxxxxxxxxxxx contains the RBA of the last record written
to the log. In a data sharing environment, yyyyyyyyyyyy Explanation: The table space name specified on the
contains the LRSN of the last record written to the log. TBLSPACE parameter of the change log inventory
Otherwise, yyyyyyyyyyyy contains the high written RBA. (DSNJU003) utility SYSTEMDB statement could not be
| zzzzzzzzzzzz contains the RBA of the last system found in any DB2 subsystem catalog or directory
| checkpoint. database. The table space name in error is named in
the 'aaaa' message keyword.
Operator Response: Issue the -SET LOG command
with the RESUME keyword when ready to resume System Action: All subsequent DSNJU003 utility
update activity. statements are bypassed, and DSNJU003 processing is
terminated with a return code of 4. The DB2
SYSTEMDB record is not updated.
DSNJ373I csect-name UPDATE ACTIVITY HAS
BEEN RESUMED FOR xxxx This message is written to the SYSPRINT data set, not
to a console.
Explanation: This message indicates that the -SET
LOG command with the RESUME option has completed User Response: Correct the table space name
successfully. specified on the TBLSPACE parameter, and resubmit
the change log inventory (DSNJU003) utility job.
System Action: All log and database update activity
has been resumed for DB2 subsystem xxxx.
296 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ403I • DSNJ409I
DSNJ403I CAPACITY OF BSDS SYSTEMDB DSNJ407E csect-name NO VALID CHECKPOINT
RECORD EXCEEDED RBA FOUND
Explanation: The BSDS SYSTEMDB record contains Explanation: After completing its search through the
VSAM passwords for data sets in the DB2 catalog and resource manager status table and the checkpoint
directory, and has a maximum capacity of 168 entries. queue, no valid checkpoint RBA was found within the
This message is issued when the number of eligible specified range.
DB2 catalog and directory data sets exceeds the
System Action: The current utility processing is
maximum capacity of the BSDS SYSTEMDB record.
terminated. This message is written to the SYSPRINT
This is an internal error.
data set, not to a console.
System Action: All subsequent change log inventory
User Response: The last 100 checkpoints are
(DSNJU003) utility statements are bypassed, and
recorded in the BSDS, including the log STARTRBA and
DSNJU003 processing is terminated with a return code
log ENDRBA of the checkpoint range. When either
of 4. The DB2 SYSTEMDB record is not updated.
STARTRBA or ENDRBA are specified, the change log
This message is written to the SYSPRINT data set, not inventory (DSNJU003) utility attempts to locate a valid
to a console. checkpoint in the range. In this case, DSNJU003 was
unsuccessful in finding a valid checkpoint.
User Response: Notify the systems programmer.
Do one of the following, as appropriate:
DSNJ404E keyword NOT ALLOWED FOR v If no checkpoint exists in the STARTRBA/ENDRBA
operation OPERATION range, set STARTRBA=ENDRBA and cold start DB2.
v If the ENDRBA is less than all recorded checkpoints
Explanation: An invalid keyword was used during the
or the STARTRBA is higher than all recorded
operation named 'operation'.
checkpoints, then use DSN1LOGP to locate a valid
System Action: The current utility processing is checkpoint. Use DSN1LOGP SUMMARY(ONLY)
terminated. This message is written to the SYSPRINT option to find a valid checkpoint. Message DSN1153I
data set, not to a console. is issued if any complete checkpoint is found.
DSN1153I identifies the log RBA of the checkpoint.
User Response: Correct the control statement and Update the CHKPTRBA parameter using the log RBA
rerun the utility. identified in DSN1153I and resubmit DSNJU003.
DSNJ405E keyword1 KEYWORD MUTUALLY DSNJ408I csect-name CHECKPOINT RBA FOUND,
EXCLUSIVE WITH keyword2 RBA = rba, TIME = time
KEYWORD
Explanation: After completing its search through the
Explanation: 'keyword1' and 'keyword2' are mutually resource manager status table and the checkpoint
exclusive and cannot appear on the same control queue, 'rba' was the most recent checkpoint RBA in the
statement. specified range and 'time' was the time of the
System Action: The current utility processing is checkpoint.
terminated. This message is written to the SYSPRINT System Action: Utility processing continues.
data set, not to a console.
User Response: Determine the extraneous keyword DSNJ409I UNABLE TO WRITE ACTIVE LOG
and remove it from the control statement. Rerun the RECORD TO THE BSDS DATASET.
utility. DDNAME=xxxxxx
Explanation: A program encountered an I/O error
DSNJ406E EITHER keyword1 KEYWORD OR when attempting to write a BSDS active log record to
keyword2 KEYWORD MUST BE the BSDS data set. 'xxxxxx' is the DDNAME of the
SPECIFIED BSDS data set being accessed.
Explanation: A required keyword was not used on the System Action: The program will terminate.
control statement. Use either 'keyword1' or 'keyword2'
with the attempted control statement type. Operator Response: Notify the system programmer.
System Action: The current utility processing is System Programmer Response: One or more error
terminated. This message is written to the SYSPRINT messages describing the specific error preceded this
data set, not to a console. message. This error is considered unrecoverable and
will leave the BSDS data set in an uncertain state. It will
User Response: Correct the control statement and be necessary to either: recreate the data set using
rerun the utility. access method service routines and then use change
log inventory (DSNJU003) to make the active and
Chapter 11. DB2 Messages 297
DSNJ410E • DSNJ417I
archive log data set(s) known to the BSDS, or recover correct and correspond to the other log range values
the BSDS using a backup copy. either specified or defaulted. A valid log range is where
STARTRBA is less than or equal to CHKPTRBA, and
CHKPTRBA is less than ENDRBA. The STARTRBA
DSNJ410E csect-name I/O ERROR DURING nnn
most be less than or equal to the ENDRBA.
PROCESSING OF yyy RECORD
Explanation: An I/O error occurred during a READ or
DSNJ414I csect-name COLD START WILL RESULT
WRITE of a record. 'nnn' is either READ or WRITE,
FROM THIS RESTART CONTROL
depending on the operation. 'yyy' specifies the
RECORD. FORWARD AND BACKOUT
Conditional Restart control record, checkpoint queue
SET TO NO.
record, archive log command history record, or resource
manager status table. Explanation: STARTRBA and ENDRBA are equal. A
cold start will result if this restart control record is used
System Action: The current utility processing is
during DB2 restart. No forward or backout processing
terminated. This message is written to the SYSPRINT
will be performed.
data set, not to a console, and will be accompanied by
message DSNJ212E or DSNJ213E. System Action: CRESTART processing continues.
User Response: Determine the cause of the I/O error User Response: No additional actions are required if
based upon the error status information provided in a cold start of the system is desired. If a cold start is not
messages DSNJ212E or DSNJ213E. desired, reissue the CRESTART and either CANCEL
the current restart control record, or CREATE a new
restart control record.
DSNJ411I csect-name CRESTART nnnn FOR
CRCRID = yyyy, DDNAME = ddname
DSNJ415E csect-name ENDRBA = rba IS INVALID,
Explanation: A CRESTART request has just
MUST BE A MULTIPLE OF 4K
completed. 'nnnn' is either CREATE or CANCEL. 'yyyy'
is the restart control record hexadecimal identifier and Explanation: The specified ENDRBA at 'rba' is not a
'ddname' is the BSDS data set (SYSUT1 or SYSUT2) multiple of 4KB.
associated with the request.
System Action: CRESTART processing is terminated.
System Action: Current utility processing continues.
User Response: Correct the ENDRBA value on the
This message is written to the SYSPRINT data set, not
CRESTART statement and rerun the utility.
to a console.
User Response: Note the record identifier for future
DSNJ416I WARNING - BSDS UTILITY TIMESTAMP
reference.
MISMATCH DETECTED. PROCESSING
CONTINUES.
DSNJ412E csect-name RESTART CONTROL
Explanation: As a result of a change log inventory
RECORD NOT FOUND IN BSDS
(DSNJU003) update, it was discovered that the
Explanation: The CRESTART CANCEL keyword was SYSUT1 BSDS and SYSUT2 BSDS timestamps are
specified but the conditional restart control record does unequal. Being unequal indicates the possibility of a
not exist in the BSDS data set. BSDS mismatch.
System Action: Current utility processing is System Action: Current utility processing continues.
terminated. This message is written to the SYSPRINT
User Response: Run the print log map (DSNJU004)
data set, not to a console.
utility against the SYSUT1 BSDS and SYSUT2 BSDS.
User Response: CREATE the conditional restart Determine if each BSDS is current. If each BSDS is
control record prior to attempting the CANCEL function. current, this warning can be ignored. If either BSDS is
not current, delete the obsolete data set and define a
replacement data set, then copy the current BSDS into
DSNJ413E csect-name INVALID LOG RANGE
the replacement data set.
SCOPE OR CHECKPOINT SPECIFIED
Explanation: The values specified thru the
DSNJ417I REQUIRED xxxxxxxx PARAMETER FOR
STARTRBA, ENDRBA, and CHKPTRBA keywords are
yyyyyyyy OPERATION IS MISSING
invalid.
Explanation: A required parameter 'xxxxxxxx' for a
System Action: Current utility processing is
Log utility operation was missing from the Log utility
terminated. This message is written to the SYSPRINT
control statement. The attempted operation is
data set, not to a console.
'yyyyyyyy'.
User Response: Ensure that the log range values are
System Action: The Log utility 'yyyyyyyy' operation
298 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ418I • DSNJ423I
does not perform its function. All subsequent Log utility messages describing the specific error preceded this
control statements are processed. A nonzero return message. Refer to the specific message(s) for error
code is issued by the utility. analysis and the appropriate action to take.
DB2 writes this message to the SYSPRINT data set, not
to a console. DSNJ421I THE BSDS IS NOT AT THE PROPER
RELEASE LEVEL. DDNAME=xxxxx
User Response: Add the missing parameter to the
control statements associated with the specified Explanation: This message is issued when a program
operation and rerun the utility. attempting to access The BSDS data set is not at a
compatible release level. This can be one of the
following:
DSNJ418I WARNING - A NOTREUSEABLE
ACTIVE LOG DATA SET WAS DELETED v The program accessing the BSDS data set is at a
FROM BSDS LOG INVENTORY, NEW release level and the BSDS is at the old level.
STARTRBA=...,ENDRBA=... v The program accessing the BSDS data set is at an
OLD release level and the BSDS is at the NEW level.
Explanation: The data set name specified on the
DSNAME parameter of the change log inventory v The program encountered an UNKNOWN release
(DSNJU003) utility DELETE statement was a level on the BSDS data set.
NOTREUSABLE active log. System Action: The program will terminate with no
System Action: DSNJU003 processing continues, it action taken.
will terminate with a return code of 4. This message is System Programmer Response: If the program that
written to the SYSPRINT data set, not to a console. encountered the error was one of the BSDS conversion
User Response: No additional actions are required if programs (DSNJMIG0 or DSNJFAL0) an unrecoverable
a deletion of a NOTREUSABLE active log was desired. error was found on the BSDS data set and it must be
If this was not desired, recreate the deleted log by using recreated. If the error was encountered running some
the NEWLOG statement with the RBA values specified other utility program (i.e., change log inventory or print
in the warning message. log map), one of the following actions may be taken:
v Run a version of the program that is compatible with
the release level of the BSDS.
DSNJ419I UNABLE TO WRITE ARCHIVE LOG
RECORD TO THE BSDS DATASET. v Run the appropriate formatting program (DSNJMIG0
DDNAME=xxxxxx or DSNJFAL0) to convert the BSDS data set to a
release level compatible with the running program. If
Explanation: A program encountered an I/O error this was successful, rerun the original program.
when attempting to write a BSDS archive record to the
BSDS data set. 'xxxxxx' is the DDNAME of the BSDS
data set being accessed. DSNJ422I LOG RECORDS HAVE ALREADY BEEN
FORMATTED - THIS UTILITY WILL
System Action: The program will terminate. TERMINATE
Operator Response: Notify the system programmer. Explanation: This message will occur when one of the
System Programmer Response: One or more error BSDS formatting programs detects the BSDS had
messages describing the specific error preceded this already been re-formatted or was already at the desired
message. This error is considered unrecoverable and format level.
will leave the BSDS data set in an uncertain state. It will System Action: The program will terminate without
be necessary to either: recreate the data set using any action being taken.
access method service routines and then use change
log inventory (DSNJU003) utility to make the active and System Programmer Response: If the appropriate
archive log data set(s) known to the BSDS, or recover BSDS formatting program was being run, no further
the BSDS using a backup copy. action is necessary.
DSNJ420I UNABLE TO WRITE BCR1 RECORD TO DSNJ423I ACTIVE LOG MAY NOT HAVE BEEN
BSDS DATASET. DDNAME=xxxxxx ARCHIVED. DSN=xxxxxx
Explanation: A program encountered an I/O error Explanation: The program was attempting to convert
when attempting to write the BSDS control record to the an old BSDS data set with more than 31 active log data
BSDS data set. 'xxxxxx' is the DDNAME of the BSDS sets to the new format. The program will drop the oldest
data set being accessed. active log data set(s) to get to the new maximum (31)
limit. When dropping one of the old active log data sets
Operator Response: Notify the system programmer. from the BSDS, it was found to have been flagged as
System Programmer Response: One or more error NOT REUSABLE (i.e., this data set MAY NOT have
Chapter 11. DB2 Messages 299
DSNJ424I • DSNJ430I
been archived). 'xxxxxx' will contain the data set name User Response: Correct the control statement and
of the active log in question. rerun the utility.
System Action: The program will remove this active
log data set from the BSDS and continue. DSNJ427I CHECKPOINT RECORD ADDED TO
QUEUE
System Programmer Response: Check to see if this
data set had been archived. The active log data set was Explanation: The checkpoint record specified has
not deleted on disk but removed only from the BSDS been added to the checkpoint queue.
data set, so it may still be archived, if needed. Use
System Action: The BSDS checkpoint queue is
access method service routines to copy the VSAM
modified as stated. This message is written to the
active log data set to a sequential archive log data set.
SYSPRINT data set, not to a console.
DSNJ424I csect-name INVALID CONTROL
DSNJ428I CHECKPOINT RECORD DELETED
STATEMENT. THE SECOND WORD
FROM QUEUE, STARTRBA=startrba,
MUST BE ’DDNAME’ OR ’*’ OR MUST
ENDRBA=endrba
START WITH A PARENTHESIS.
Explanation: The checkpoint record specified has
Explanation: The control statement is invalid.
been deleted from the Checkpoint Queue. 'startrba' and
System Action: The control statement is ignored. DB2 'endrba' was the RBA range indicated in the deleted
uses the SYSUT1 DD statement to locate the BSDS to checkpoint record.
be mapped. If the SYSUT1 DD statement is not
System Action: The BSDS checkpoint queue is
available, the utility terminates.
modified as stated. This message is written to the
User Response: Refer to DB2 Utility Guide and SYSPRINT data set, not to a console.
Reference for information on creating a print log map
(DSNJU004) utility control statement. Correct or remove
DSNJ429I RBA RANGE CONFLICTS WITH
the control statement and rerun the job.
EXISTING CHECKPOINT RECORD RBA
Problem Determination: If you suspect an error in RANGE
DB2, refer to Part 2 of DB2 Diagnosis Guide and
Explanation: The specified RBA range for the new
Reference for information on identifying and reporting
checkpoint record either exists or overlaps an existing
the problem.
RBA range in the checkpoint queue.
Collect the following diagnostic items listed in
System Action: The current utility is terminated. This
“Appendix B. Problem determination” on page 1281: 32.
message is written to the SYSPRINT data set, not to a
console.
DSNJ425I INVALID xxxxxx VALUE/FORMAT FOR
User Response: Run the print log map (DSNJU004)
yyyyyyyy PARAMETER
utility against the SYSUT1 BSDS and SYSUT2 BSDS.
(YYYYDDDHHMMSST)
Determine the correct RBA range and correct the
Explanation: 'xxxxxx' is the field in the 'yyyyyyyy' STARTRBA and ENDRBA parameters and rerun the
parameter that contains an incorrect value or incorrect utility.
format.
System Action: The current utility is terminated. This DSNJ430I SPECIFIED ENTRY CANNOT BE
message is written to the SYSPRINT data set, not to a ADDED WITHOUT OVERLAYING
console. EXISTING LOWEST ENTRY
User Response: Correct the control statement and Explanation: The specified RBA range for the new
rerun the utility. checkpoint record is less than the existing lowest entry.
The checkpoint queue is currently full and cannot add
the new entry without overlaying the lowest entry.
DSNJ426I ENDTIME VALUE CANNOT BE LESS
THAN STARTIME VALUE System Action: The current utility is terminated. This
message is written to the SYSPRINT data set, not to a
Explanation: The 'STARTIME' and 'ENDTIME'
console.
parameters specify a time range. Hence, the ENDTIME
value must be equal to or greater than STARTIME User Response: Run the print log map (DSNJU004)
value. utility against the SYSUT1 BSDS and SYSUT2 BSDS.
Determine the lowest existing entry and either change
System Action: The current utility is terminated. This
the STARTRBA and ENDRBA parameters or delete the
message is written to the SYSPRINT data set, not to a
existing lowest entry and add the new low checkpoint
console.
entry and rerun the utility.
300 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ431I • DSNJ436I
mapped. If the SYSUT1 DD statement is not available,
DSNJ431I STARTRBA SPECIFIED NOT FOUND IN
the utility terminates.
CHECKPOINT QUEUE
User Response: Refer to DB2 Utility Guide and
Explanation: The specified STARTRBA could not be
Reference for information on creating a print log map
located in the checkpoint queue.
(DSNJU004) utility control statement. Correct or remove
System Action: The current utility is terminated. This the control statement and rerun the job.
message is written to the SYSPRINT data set, not to a
Problem Determination: If you suspect an error in
console.
DB2, refer to Part 2 of DB2 Diagnosis Guide and
User Response: Run the print log map (DSNJU004) Reference for information on identifying and reporting
utility against the SYSUT1 BSDS and SYSUT2 BSDS. the problem.
Determine the correct STARTRBA value and correct the
Collect the following diagnostic items listed in
STARTRBA parameter and rerun the utility.
“Appendix B. Problem determination” on page 1281: 32.
DSNJ432I THE OFFLRBA VALUE MUST END
DSNJ435I csect-name THE MEMBER LIST OF A
WITH 'FFF'
CONTROL STATEMENT MUST BE
Explanation: The OFFLRBA value is invalid. It must TERMINATED WITH A PARENTHESIS.
end with 'FFF'.
Explanation: The control statement contained the
System Action: The current utility is terminated. This correct format for starting a list of members, but the
message is written to the SYSPRINT data set, not to a terminating parenthesis was not found.
console.
System Action: The control statement is accepted
User Response: Correct the control statement and with an assumed parenthesis after the last member
rerun the utility. name recognized, and processing continues.
User Response: Refer to DB2 Utility Guide and
DSNJ433I csect-name INVALID CONTROL Reference for information on creating a print log map
STATEMENT. A MEMBER LIST MUST (DSNJU004) utility control statement. Correct or remove
CONTAIN AT LEAST ONE MEMBER the control statement and rerun the job.
NAME.
Problem Determination: If you suspect an error in
Explanation: The control statement is invalid. The DB2, refer to Part 2 of DB2 Diagnosis Guide and
member list is either empty or in the wrong format. Reference for information on identifying and reporting
the problem.
System Action: The control statement is ignored. DB2
uses the SYSUT1 DD statement to locate the BSDS to Collect the following diagnostic items listed in
be mapped. If the SYSUT1 DD statement is not “Appendix B. Problem determination” on page 1281: 32.
available, the utility terminates.
User Response: Refer to DB2 Utility Guide and DSNJ436I csect-name THE DD STATEMENT FOR
Reference for information on creating a print log map ddname IS MISSING.
(DSNJU004) utility control statement. Correct or remove
Explanation: The print log map (DSNJU004) utility
the control statement and rerun the job.
requested information about the identified ddname from
Problem Determination: If you suspect an error in the MVS Dynamic Allocation facility, but the DD
DB2, refer to Part 2 of DB2 Diagnosis Guide and statement was not found in the job.
Reference for information on identifying and reporting
System Action: The job is terminated.
the problem.
User Response: Refer to DB2 Utility Guide and
Collect the following diagnostic items listed in
Reference for information on required JCL statements.
“Appendix B. Problem determination” on page 1281: 32.
Correct the JCL and rerun the job.
Problem Determination: If you suspect an error in
DSNJ434I csect-name SYSIN MUST CONTAIN AT
DB2, refer to Part 2 of DB2 Diagnosis Guide and
LEAST ONE RECORD.
Reference for information on identifying and reporting
Explanation: A SYSIN DD statement was provided, the problem.
but the data set was null, or the JCL statement
Collect the following diagnostic items listed in
″//SYSIN DD *″ was immediately followed by the
“Appendix B. Problem determination” on page 1281: 32.
statement ″/*″.
System Action: The error is ignored. DB2 uses the
DD SYSUT1 statement to locate the BSDS to be
Chapter 11. DB2 Messages 301
DSNJ437I • DSNJ702E
explanation for the associated DB2 reason code for
DSNJ437I csect-name UNABLE TO ALLOCATE
further action.
BSDS dsname. SVC 99 RTN CODE rc,
RSN CODE rsncd, INFO infocd.
DSNJ701E csect-name MEMBER NAME
Explanation: The print log map (DSNJU004) utility
(membername) IN BSDS DOES NOT
attempted to allocate a BSDS data set using the MVS
MATCH MEMBER NAME (membername)
Dynamic Allocation facility, but the system was unable
IN DB2 SYSTEM PARAMETERS
to complete the allocation. The return code, reason
dsnzparm
code, and information code were returned by the
system’s SVC 99 facility. See MVS/ESA Programming: Explanation: During startup, DB2 detected that the
Authorized Assembler Services Guide for an member name listed in its bootstrap data set (BSDS)
explanation of these codes. does not match the member name in the DB2 system
parameters load module.
System Action: The processing of the BSDS named
in the message is terminated. If this is the last (or only) Operator Response: Notify the system programmer.
BSDS to be processed by this job, the job is terminated.
System Programmer Response: Restore the BSDS
User Response: Refer to DB2 Utility Guide and or specify a different system parameters load module on
Reference for information on required JCL statements. the START DB2 command.
Correct the JCL and rerun the job.
Problem Determination: If you suspect an error in DSNJ702E csect_name GENERIC LU NAME
DB2, refer to Part 2 of DB2 Utility Guide and Reference lu-name IN BSDS DOES NOT MATCH
for information on identifying and reporting the problem. THE GENERIC LU NAME lu-name
ASSOCIATED WITH THE DATA
Collect the following diagnostic items listed in
SHARING GROUP.
“Appendix B. Problem determination” on page 1281: 32.
Explanation: DB2 issues this message during startup
when it detects that the generic LU name in the
DSNJ438I csect-name THE xxx VALUE MUST END
bootstrap data set (BSDS) does not match the generic
WITH ’yyy’
LU name in the shared communications area (SCA)
Explanation: The STARTRBA or ENDRBA value structure.
specified on the NEWLOG statement is invalid. ’xxx’ is
System Action: DB2 startup continues.
either STARTRBA or ENDRBA, depending on which
parameter is invalid. If ’xxx’ equals STARTRBA, then Operator Response: Notify the system programmer.
’yyy’ equals ’000’ and if ’xxx’ equals ENDRBA, then
’yyy’ equals ’FFF’. System Programmer Response: Depending on the
accuracy of the BSDS value, take one of the following
System Action: The current utility is terminated. This actions:
message is written to the SYSPRINT data set, not to a v BSDS value is correct: DB2 startup will automatically
console. replace the generic LU name in the SCA with the
User Response: Correct the control statement and correct value. The BSDS for each member of this
rerun the utility. DB2 data sharing group must specify this same value
for generic LU name. If any member specifies a
different value for generic LU name, use the change
DSNJ700I csect_name ERROR ATTEMPTING TO log inventory utility (DSNJU003) to change the
ACCESS BSDS FOR PEER MEMBER generic LU name, as described in DB2 Utility Guide
ID= member-id, MEMBER NAME= and Reference.
member-name, REASON-CODE=
v BSDS value is not correct: DB2 startup will replace
reason-code.
the generic LU name in the SCA. The SCA value will
Explanation: DB2 issues this message to identify the be incorrect when startup is complete. Take the
peer member ID, and if known, the peer member name following actions to correct this situation:
associated with listed DB2 reason code. – Stop this DB2 subsystem.
System Action: An execution unit issues this – Use the change log inventory utility (DSNJU003)
message and then, if this was an unconditional request, to change the generic LU name of this member,
writes a record to SYS1.LOGREC and requests an SVC as described in DB2 Utility Guide and Reference.
dump. The execution unit then terminates. – Issue START DB2 for this member. START DB2
Operator Response: Collect all relevant diagnostic will correct the generic LU name contained in the
materials, including SYS1.LOGREC, SVC dump, and SCA.
console output of peer and host.
System Programmer Response: Review the
302 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ703E • DSNJ707E
If this DB2 is not a member of a data sharing group,
DSNJ703E csect-name GROUP NAME (groupname)
reassemble the system parameters load module and
IN BSDS DOES NOT MATCH GROUP
specify DSHARE=NO.
NAME (groupname) IN DB2 SYSTEM
PARAMETERS dsnzparm If this DB2 is attempting to disable the data sharing
group, then reassemble the system parameters load
Explanation: During startup, DB2 detected that the
module and specify DSHARE=NO, then execute the
group name listed in its bootstrap data set (BSDS) does
installation job DSNTIJGF, and then restart this DB2.
not match the group name in the DB2 system
Job DSNTIJGF must be used with caution, this will
parameters load module.
disable the data sharing group. For more information,
Operator Response: Notify the system programmer. see Chapter 2 of DB2 Data Sharing: Planning and
Administration.
System Programmer Response: Restore the BSDS
or specify a different system parameters load module on
the START DB2 command. DSNJ706I csect-name THE DB2 SYSTEM
PARAMETERS SPECIFY NON-DATA
SHARING, BUT THE BSDS SPECIFIES
DSNJ704I csect-name NEW MEMBER(member-
DATA SHARING.
name) START-UP NOT ALLOWED
WHEN GROUP-RESTART IS REQUIRED Explanation: The system parameters passed on the
FOR GROUP(group-name). DB2 START command specified non-data sharing, but
the bootstrap data set (BSDS) indicates this is a data
Explanation: One of the following occurred:
sharing member.
v A new member member-name tried to start when a
group restart of data sharing group group-name is System Action: The DB2 subsystem stops.
required. Operator Response: If this DB2 is a member of a
v A member other than the originating member of a data sharing group, restart DB2 with the correct system
data sharing group attempted to start the new DB2 parameters load module. If this DB2 is not a member of
data sharing group. The originating member of a a data sharing group, inform the system programmer.
group is either an existing DB2 subsystem which
System Programmer Response: If this DB2 should
formed the data sharing group or a new DB2
be a member of a data sharing group, reassemble the
subsystem which was installed to form the group.
system parameters load module and specify
System Action: The DB2 subsystem stops. DSHARE=YES. If this DB2 is not a member of a data
sharing group, execute the installation job DSNTIJGF,
Operator Response: Start a previously active member
which updates the BSDS for non-data sharing.
of this group. When the required group restart is
completed, start the new member again.
DSNJ707E csect_name LOCATION NAME
If this is the very first startup of the group, you must
location-name IN BSDS DOES NOT
start the originating member first before starting any
MATCH THE LOCATION NAME
other member.
location-name ASSOCIATED WITH THE
DATA SHARING GROUP.
DSNJ705I csect-name THE DB2 SYSTEM
Explanation: DB2 issues this message during startup
PARAMETERS SPECIFY DATA
when it detects that the LOCATION name in the
SHARING, BUT THE BSDS SPECIFIES
bootstrap data set (BSDS) does not match the
NON-DATA SHARING.
LOCATION name in the system communications area
Explanation: The system parameters passed on the (SCA) structure.
DB2 start command specified data sharing, but the
System Action: DB2 startup continues.
bootstrap data set (BSDS) did not indicate this DB2 is a
data sharing member. Operator Response: Notify the system programmer.
System Action: The DB2 subsystem stops. System Programmer Response: Depending on the
accuracy of the BSDS value, take one of the following
Operator Response: If this DB2 should be a member
actions:
of a data sharing group, inform the system programmer.
If this DB2 is not a member of a data sharing group, v BSDS value is correct: DB2 startup will automatically
restart DB2 with the correct system parameters load replace the LOCATION name in the SCA with the
module correct value. The BSDS for each member of this
DB2 data sharing group must specify this same value
System Programmer Response: If this DB2 should for LOCATION. If any member specifies a different
be a member of a data sharing group, execute the value for LOCATION, use the change log inventory
installation job DSNTIJUZ, which updates the BSDS for utility (DSNJU003) to change the LOCATION name,
data sharing. as described in DB2 Utility Guide and Reference .
Chapter 11. DB2 Messages 303
DSNJ711E • DSNJ995I
v BSDS value is not correct: DB2 startup will replace console for possible DSN7xxxx and/or SVC dump
the LOCATION name in the SCA. The SCA value will messages that could relate to this problem.
be incorrect when startup is complete. Take the
If you suspect an error in DB2, refer to Part 2 of DB2
following actions to correct this situation:
Diagnosis Guide and Reference for information on
– Stop this DB2 subsystem. identifying and reporting the problem.
– Use the change log inventory utility (DSNJU003)
to change the LOCATION name of this member,
DSNJ991I csect-name START OF LOG DATA SET
as described in DB2 Utility Guide and Reference.
PREFORMATFOR JOB job-name
– Issue START DB2 for this member. START DB2 step-name
will correct the LOCATION name contained in the
SCA. Explanation: The active log data set preformat utility
has started.
DSNJ711E csect-name SCA OPEN FAILURE Severity: 0 (informational)
ENCOUNTERED.
Explanation: A failure occurred during command DSNJ992I csect-name LOG DATA SET NAME =
processing in an attempt to open an object in the SCA. data-set-name
System Action: Command processing terminates Explanation: The indicated data-set-name is to be
unsuccessfully. preformatted.
System Programmer Response: Obtain Severity: 0 (informational)
SYS1.LOGREC and possible SVC dump for analysis.
Problem Determination: Review the DB2 system DSNJ993I csect-name LOG DATA SET IS NOT A
console for possible DSN7xxxx and/or SVC dump VSAM DATA SET
messages that could relate to this problem. Explanation: The input log dataset is not a VSAM
If you suspect an error in DB2, refer to Part 2 of DB2 data set.
Diagnosis Guide and Reference for information on Severity: 8 (error)
identifying and reporting the problem.
System Action: Processing terminates.
DSNJ712E csect-name SCA READ FAILURE User Response: Use the AMS IDCAMS Service to
ENCOUNTERED. define the active log data set as a VSAM Linear data
set.
Explanation: A failure occurred during command
processing attempting to read from the SCA.
DSNJ994I csect-name VSAM OPEN ERROR,
System Action: Command processing terminates ACBERRFLG = error-code
unsuccessfully.
Explanation: VSAM OPEN failed with the indicated
System Programmer Response: Obtain ACB error-code.
SYS1.LOGREC and possible SVC dump for analysis.
Severity: 8 (error) if error is greater than or equal to
Problem Determination: Review the DB2 system 128; otherwise, 4 (warning)
console for possible DSN7xxxx and/or SVC dump
messages that could relate to this problem. System Action: Processing terminates if the error
code is greater than or equal to 128; otherwise,
If you suspect an error in DB2, refer to Part 2 of DB2 processing continues normally.
Diagnosis Guide and Reference for information on
identifying and reporting the problem. User Response: Notify the system programmer.
System Programmer Response: Follow standard
DSNJ713E csect-name SCA WRITE FAILURE VSAM diagnostic procedure. Refer to DFSMS/MVS:
ENCOUNTERED. Macro Instructions for Data Sets. See also MVS/DFP
V3R3 Diagnosis Guide for more information about the
Explanation: A failure occurred during command VSAM procedures.
processing attempting to write to the SCA.
System Action: Command processing terminates DSNJ995I csect-name VSAM PUT
unsuccessfully. ERROR,RPLERREG = return-code,
System Programmer Response: Obtain RPLERRCD = reason-code
SYS1.LOGREC and possible SVC dump for analysis. Explanation: VSAM PUT failed with the indicated
Problem Determination: Review the DB2 system return-code and reason-code.
304 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNJ996I • DSNJ998I
Severity: 8 (error)
System Action: Processing terminates.
User Response: Notify system programmer.
System Programmer Response: Follow standard
VSAM diagnostic procedure. Refer to DFSMS/MVS:
Macro Instructions for Data Sets. See also MVS/DFP
V3R3 Diagnosis Guide for more information about the
VSAM procedures.
DSNJ996I csect-name LOG PREFORMAT
COMPLETED SUCCESSFULLY,nn
RECORDS FORMATTED
Explanation: The active log data set has been
preformatted successfully. ’nn’ records (or VSAM control
intervals) have been formatted.
Severity: 0 (informational)
DSNJ997I csect-name LOG PREFORMAT
TERMINATED
Explanation: Preformatting of the active log data set
did not complete successfully.
Severity: 8 (error)
System Action: Processing terminates.
User Response: Examine other error messages
associated with this job.
DSNJ998I csect-name LOG DATA SET IS NOT
EMPTY
Explanation: The input log data set is not an empty
data set. The input data set must be empty to prevent
the loss of actual log data.
Severity: 8 (error)
System Action: Processing terminates.
User Response: Use the AMS IDCAMS Service to
delete and redefine the active log data set or correct the
input log data set name.
Chapter 11. DB2 Messages 305
306 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 12. DSNL... Messages
SYSIBM.IPNAMES. If you are a DB2 Connect
DSNL001I DDF IS ALREADY STARTED
requester, the CATALOG TCPIP NODE
Explanation: The distributed data facility (DDF) was command (or the equivalent command for your
already active when you issued -START DDF command. environment) is used to specify the TCP/IP
domain name. The value '-NONE' indicates
System Action: The issued command is not executed.
that TCP/IP is not supported, or TCP/IP
initialization failed.
DSNL002I DDF IS ALREADY STOPPED
tcpport The TCP/IP port number used by this DB2
Explanation: The distributed data facility (DDF) had subsystem to accept incoming DRDA
already been stopped when the -STOP DDF command connection requests.
was issued. v A zero indicates TCP/IP is not supported.
System Action: The issued command is not executed. The BSDS DDF record is not configured
with a PORT.
v A value of ’-NONE’ indicates that DB2 will
DSNL003I DDF IS STARTING not accept connections on this port.
Explanation: The distributed data facility (DDF) This may be due to specifying 0 for the
-START command is starting. DSN6SYSP MAXDBAT installation
parameter defined in DSNZPARM. For more
System Action: DB2 begins processing the -START
information, see the ″MAX REMOTE
DDF command.
ACTIVE″ specification of the DSNTIPE
installation panel in the DB2 Installation
DSNL004I csect DDF START COMPLETE Guide.
LOCATION locname LU netname.luname
resport The TCP/IP port number used by this DB2
GENERICLU netname.gluname DOMAIN
subsystem to accept incoming two-phase
domain TCPPORT tcpport RESPORT
commit resynchronization requests.
resport
A zero indicates TCP/IP is not supported. The
Explanation: The distributed data facility (DDF)
BSDS DDF record is not configured with a
started.
RESPORT.
locname
System Action: The DDF start up process completed.
The LOCATION of the DB2 subsystem.
However, it might fail for reasons specified by messages
netname.luname DSNL013I, DSNL015I, DSNL016I, DSNL017I,
The fully qualified LU name for the DB2 DSNL018I, DSNL019I, DSNL700I, or DSNL705I.
subsystem.
System Programmer Response: Use the
netname.gluname recommended domain name when configuring network
The fully qualified VTAM generic LU name for definitions for TCP/IP requesters.
the DB2 subsystem. The value '-NONE'
indicates that no VTAM generic LU name is
DSNL005I DDF IS STOPPING
used by the DB2 subsystem.
Explanation: The distributed data facility (DDF)
domain For non-data sharing systems, domain is the
-STOP command has been initiated.
name returned by the DNS for the system’s
default IP address. For data sharing systems, System Action: The -STOP DDF command is
domain is the name that represents the DB2 initiated.
group. For the remote DB2 data sharing group,
the DRDA requester should use a domain
name of the following form: DSNL006I DDF STOP COMPLETE
location.sysplex.domainname Explanation: The distributed data facility (DDF)
-STOP command has completed.
where location is the DB2 location name, System Action: The DDF has stopped.
sysplex is the sysplex name in the COUPLExx
parmlib member and domainname is the
domain name specified in the TCPIP.DATA file. DSNL007I DDF IS ABNORMALLY TERMINATING
If you are an MVS requester, the domain name
Explanation: Abnormal termination of the distributed
is specified in column IPADDR of catalog table
data facility (DDF) has started.
© Copyright IBM Corp. 1982, 2001 307
DSNL008I • DSNL015I
System Action: Abnormal termination of the DDF is termination. This message is not issued when DDF
starting. terminates normally.
System Action: Termination of the distributed data
DSNL008I DDF ABNORMAL TERMINATION facility is initiated.
COMPLETE
Explanation: Abnormal termination of the distributed DSNL013I VTAM OPEN ACB FAILED
data facility (DDF) has completed. ERROR=error-code
System Action: The DDF has stopped. Explanation: VTAM returned a nonzero return code
after DB2 invoked the OPEN ACB macro instruction
during termination of the distributed data facility (DDF).
DSNL009I INVALID DDF THREAD
VTAM return codes for OPEN error conditions are
logical-unit-of-work-id SPECIFIED
defined in VTAM for MVS/ESA Programming.
Explanation: No distributed transaction with the
System Action: Termination of the distributed data
specified 'logical-unit-of-work-id' exists.
facility is initiated.
System Action: The specified thread is not canceled.
Operator Response: Notify the system programmer.
User Response: Determine the correct
System Programmer Response: Determine the
'logical-unit-of-work-id' of the distributed thread that is to
cause of the OPEN ACB failure, correct the error, and
be canceled and then reissue the command.
issue the -START DDF command.
Problem Determination: Determine the correct value.
Problem Determination: Refer to VTAM for MVS/ESA
The -DISPLAY THREAD command can be used to
Programming for failure analysis during an OPEN macro
display all distributed activity.
instruction.
DSNL010I DDF THREAD logical-unit-of-work-id HAS
DSNL014I VTAM CLOSE ACB FAILED
BEEN CANCELED
ERROR=error-code
Explanation: The distributed data facility (DDF) thread
Explanation: VTAM returned a nonzero return code
'logical-unit-of-work-id' was canceled.
after DB2 invoked the CLOSE ACB macro instruction
If 'logical-unit-of-work-id' is an LUWID (LU network during termination of the distributed data facility (DDF).
name and an LUW instance number) instead of an VTAM return codes for CLOSE error conditions are
LUWID TOKEN, then in rare circumstances more than defined in VTAM for MVS/ESA Programming.
one DDF thread might be canceled.
System Action: Termination of DDF continues.
This situation only arises when an application accesses
Operator Response: Notify the system programmer.
the same DB2 server by different access paths (for
example, A->B->C and A->D->C). In such a case, System Programmer Response: Determine the
multiple threads with the same LUWID exist at the cause of the failure, fix the error condition, and then
server (for example, C). If CANCEL DDF THREAD is issue the -START DDF command.
issued at the server specifying this LUWID, every thread
Problem Determination: Refer to VTAM for MVS/ESA
at the server with the LUWID is canceled.
Programming for failure analysis during a CLOSE macro
System Action: The specified thread is canceled. instruction.
DSNL011I VTAM STOPPING DDF DSNL015I VTAM SETLOGON FAILED
RTNCD=error-code FDBK2=open-flags
Explanation: The operator issued a HALT NET
command to terminate VTAM. Explanation: VTAM returned a nonzero return code
after DB2 invoked the SETLOGON macro during
System Action: The distributed data facility (DDF)
initialization of the distributed data function (DDF).
-STOP command is initiated.
VTAM return codes are defined in VTAM for MVS/ESA
Programming.
DSNL012I VTAM TERMINATING DDF
System Action: Termination of the DDF is started.
Explanation: The operator issued a HALT NET
Operator Response: Notify the system programmer.
QUICK command or a HALT NET CANCEL command,
or VTAM is terminating abnormally. This message can System Programmer Response: Refer to VTAM for
be issued any time after -START DDF and occurs when MVS/ESA Programming to determine the cause of the
VTAM is stopped, which can occur prior to DDF failure. After the error is fixed, issue the -START DDF
command.
308 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL016I • DSNL022I
(API). The APPC API bit is not set in the VTAM
DSNL016I DDF RECORD NOT FOUND IN BSDS
function-list vector in the access-method-support vector
Explanation: DDF cannot find the DDF list.
communication record in the BSDS.
System Action: Termination of the distributed data
System Action: DDF termination process is initiated. facility (DDF) is initiated.
Operator Response: Notify the system programmer. Operator Response: Notify the system programmer.
System Programmer Response: Use the change log System Programmer Response: Determine whether
inventory to add the DDF communication record to the the installed release of VTAM supports the APPC API. If
BSDS. VTAM does not support the APPC API, a VTAM release
that supports the APPC API must be installed before the
Problem Determination: Collect the following
DDF can be started.
diagnostic item:
v Print the contents of the BSDS using the print log
map utility. DSNL020I KEYWORD 'THREAD' PARAMETER
parameter FORMAT IN ERROR
DSNL017I INVALID DDF RECORD FOUND IN Explanation: The parameter value specified for the
BSDS logical-unit-of-work ID on the CANCEL DDF THREAD
has an invalid format. The correct form is
Explanation: A invalid or incomplete DDF 'netid.luname.luwunique', where:
communication record was found in the BSDS.
netid A 1- to 8-character network ID.
System Action: DDF termination process is initiated.
luname
Operator Response: Notify the system programmer. A 1- to 8-character luname.
System Programmer Response: Use the change log luwunique
inventory to add a valid DDF communication record to A 12-character hex number.
the BSDS.
Problem Determination: Collect the following Luname and luwunique are separated by a '.' delimiter.
diagnostic item: Netid is optional. If netid is specified, then netid and
luname are separated by a '.' delimiter. If netid is not
v Print the contents of the BSDS using the print log
specified, then the '.' delimiter before luname is not
map utility.
present.
System Action: The specified thread is not canceled.
DSNL018I VSAM ERROR READING DDF RECORD
IN BSDS RPLERRCD=error-code User Response: Determine the correct
logical-unit-of-work ID of the distributed thread that is to
Explanation: A VSAM GET command was issued that
be canceled and reissue the command.
resulted in a nonzero return code. RPLERRCD
'error-code' is the VSAM return code. Problem Determination: Determine the correct value.
The -DISPLAY THREAD command can be used to
System Action: Termination of the distributed data
display all distributed activity.
facility (DDF) is initiated.
Operator Response: Notify the system programmer.
DSNL021I command IS ACCEPTED
System Programmer Response: Determine the
Explanation: The 'command' command has been
cause of the failure, fix the error condition, and issue
accepted and asynchronous processing of 'command'
the -START DDF command.
has been initiated. The command can only be -START
The cause of the failure is dictated by the VSAM return or -STOP the distributed data facility.
code. The BSDS may have to be recovered by using a
System Action: The command was accepted and
backup copy.
asynchronous processing has been initiated.
Problem Determination: Refer to the appropriate
VSAM publications.
DSNL022I csect-name DDF THREAD
logical-unit-of-work-id WAS PREVIOUSLY
DSNL019I VTAM DOES NOT SUPPORT APPC CANCELED
FUNCTIONS
Explanation: A command to cancel the distributed
Explanation: The installed release of VTAM does not data facility (DDF) thread logical-unit-of-work-id was
support the advanced program-to-program previously issued. Either the CANCEL DDF THREAD or
communications (APPC) application program interface the CANCEL THREAD command was entered. The
Chapter 12. DB2 Messages 309
DSNL023I • DSNL026I
thread is currently being canceled. The CANCEL Operator Response: Determine if the inconsistency is
command terminates a thread only if the thread is due to network conditions or a DB2 error. If a DB2 error
processing in DB2 or is currently suspended by DB2. is suspected, acquire documentation to diagnose the
The thread might not be processing in DB2 in these problem.
situations: 1. Console dump of DB2 address spaces (ssnmDBM1,
v The thread is processing in the application and has ssnmMSTR, ssnmDIST), VTAM, and user's address
not made a request to DB2. The DISPLAY THREAD space at the requesting site.
command indicates this. 2. Console dump of DB2 address spaces (ssnmDBM1,
v The user placed the thread on an MVS resource ssnmMSTR, ssnmDIST), and VTAM at the server
using the ENQUE command. The CANCEL command site.
has no effect on the thread until ENQUE completes 3. SYSLOG from requesting and server sites.
and the thread returns to DB2.
4. LOGREC from requesting and server sites.
v The thread is processing in VTAM and is waiting for a
response from a partner. The DISPLAY THREAD If an indefinite inconsistency is suspected, use the
DETAIL command indicates this. In this case the CANCEL DDF THREAD command to terminate the
thread does not terminate until VTAM returns to DB2. thread. If CANCEL DDF THREAD fails to terminate the
VTAM commands, which will terminate the session or agent, use VTAM commands to terminate the thread
LU, can be used to cause VTAM to return to DB2. conversations.
Problem Determination: Use the DB2 DISPLAY
DSNL023I DDF IS ALREADY IN THE PROCESS THREAD command with DETAIL option at each DB2
OF STARTING subsystem to display information about the agent and
Explanation: The distributed data facility (DDF) was its conversations. Use VTAM commands to display
starting when the -START DDF or -STOP DDF additional information about the conversations being
command was issued. used by the thread and also about network conditions.
System Action: The issued command is not executed. Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
3, 5.
DSNL024I DDF IS ALREADY IN THE PROCESS
OF STOPPING
DSNL026I LUW-ID luw-id=token APPEARS TO BE
Explanation: The distributed data facility (DDF) was SUSPENDED PARTNER LOCATION
stopping when the -STOP DDF or -START DDF location PARTNER LU luname
command was issued.
Explanation: The DDF error monitor has detected that
System Action: The -START or -STOP DDF a distributed agent with the specified 'luw-id' at this
command is not executed. location and at the named partner 'location' may be
suspended indefinitely.
DSNL025I A DISTRIBUTED AGENT FOR Where
luw-id=token EXISTS AT THIS
LOCATION BUT NOT AT SITE WITH luw-id=token
LOCATION location AND LU luname The logical unit of work ID of the thread
followed by an '=' sign and a token which may
Explanation: The DDF error monitor has detected that be used in place of 'luw-id' in any DB2
a distributed agent exists at this location but not at the command that accepts 'luw-id' as input.
named partner location.
location
Where The location name of the partner site where a
luw-id=token thread with the same 'luw-id' exists.
The logical unit of work ID of the thread luname
followed by an '=' sign and a token which may The 8-character LUNAME of the partner
be used in place of 'luw-id' in any DB2 location.
command that accepts 'luw-id' as input.
Operator Response: Determine if the inconsistency is
location due to network conditions or a DB2 error. If a DB2 error
The location name of the partner site where a is suspected, acquire documentation to diagnose the
thread with the same 'luw-id' does not exist. problem.
luname 1. Console dump of DB2 address spaces (ssnmDBM1,
The 8-character LUNAME of the partner ssnmMSTR, ssnmDIST), VTAM, and hung user's
location. address space at the requesting site.
310 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL027I • DSNL028I
2. Console dump of DB2 address spaces (ssnmDBM1, v Work station name of the end user’s work
ssnmMSTR, ssnmDIST), and VTAM as the server station. An asterisk (*) indicates that it is not
site. relevant to the thread or was not provided
3. SYSLOG from requesting and server sites. by the client.
4. LOGREC from requesting and server sites. v End user’s user-ID. An asterisk (*) indicates
that it is not relevant to the thread or was
If an indefinite inconsistency is suspected, use the not provided by the client.
CANCEL DDF THREAD command to terminate the v Application name of the end user’s
thread. If CANCEL DDF THREAD fails to terminate the application. An asterisk (*) indicates that it is
agent, use VTAM commands to terminate the thread not relevant to the thread or was not
conversations. provided by the client.
Problem Determination: Use the DB2 DISPLAY abnd The abend code or zeros if the abend code is
THREAD command with DETAIL option at each DB2 indeterminate.
subsystem to display information about the agent and
reason The DB2 reason code or zeros if the reason
its conversations. Use VTAM commands to display
code is indeterminate.
additional information about the conversations being
used by the thread and also about network conditions. Problem Determination: Gather appropriate
diagnostic information (refer to the System Programmer
Collect the following diagnostic items listed in
Response section of the abend reason code specified in
“Appendix B. Problem determination” on page 1281: 1,
this message if applicable). Refer to DSNL028I
3, 5.
message(s) for the names of the other location(s).
DSNL027I dis-agent-type DISTRIBUTED AGENT
DSNL028I luw-id=token ACCESSING DATA
WITH LUW-ID luw-id=token
preposition LOCATION location nettype
THREAD-INFO thread-info RECEIVED
netvalue
ABEND=abnd REASON=reason
Explanation: This message follows DSNL027I and
Explanation: A distributed agent has abended at this
identifies a remote location where work might have
location. This message will be followed by zero or more
been occurring for the distributed thread. This message
occurrences of DSNL028I, each of which describes a
is informational and with the DSNL027I message
remote location where the distributed agent also exists
identifies a remote location where diagnostic information
and where diagnostic information might also need to be
might have to be collected.
collected. This message is informational and with the
DSNL028I message(s) identifies the remote locations luw-id=token
where diagnostic information may have to be collected. The logical unit-of-work ID of the thread
followed by an '=' sign and a token which may
Where
be used in place of 'luw-id' in any DB2
dis-agent-type command that accepts 'luw-id' as input.
'REQUESTING' if the thread that abended is
preposition
an allied thread that has distributed activity and
'FOR' if the thread is a database access thread
SERVER if the thread that abended is a
and 'AT' if the thread is an allied thread that
database access thread.
has distributed activity.
luw-id=token
location
The logical-unit-of-work ID of the thread
The LOCATION name of the remote site.
followed by an '=' sign and a 5 digit token
value which may be used in any DB2 nettype
command that accepts luw-id as input. Identifies the type of network used to access
the remote site. There are two possible values:
thread-info
Thread-info contains additional identifiers that LU -- indicates that VTAM is used to
define more specific information regarding the connect to the remote site.
identity of the thread.
IPADDR --
In many distributed configurations, the primary indicates that TCP/IP is used to
authorization-ID used with DB2 is not connect to the remote site.
necessarily the user-ID of the end user.
netvalue
The following identifiers, separated by a The network address of the remote location.
colon(:), are provided: netvalue can be blank.
v The primary authorization-ID associated with v If nettype is LU, netvalue specifies the
the thread. VTAM LU name of the remote location.
Chapter 12. DB2 Messages 311
DSNL029I • DSNL031I
v If nettype is IPADDR, netvalue specifies the A DRDA exception condition, detected at the application
dotted decimal IP address of the remote requester, is one of the following:
location. v An error reply message and severity code received
Problem Determination: See message DSNL027I. from the server.
v A parsing error detected while processing a reply
message or reply data object
DSNL029I DDF IS NOT INITIALIZED
v A DRDA protocol violation, (for example, an object
Explanation: A -START DDF or -STOP DDF returned that is not valid for this command).
command was issued before DDF was initialized during
DB2 startup processing. The variables have the following meanings:
Operator Response: Wait for the DSN9022I 'START luwid The logical unit of work (LUW) ID that identifies
DB2' NORMAL COMPLETION message and re-issue the thread and is also included in the trace
the command. record.
reason The DB2 reason code for this specific error.
DSNL030I csect-name DDF PROCESSING
FAILURE FOR LUWID=luwid error id
AUTHID=authid REASON=reason The module name concatenated with a 4-byte
source id that uniquely determines the source
Explanation: A requesting conversation was within the module where the exception is
terminated because of DDF processing failure. The encountered.
requesting agent is identified by the 'luwid' and 'authid'
values, if they are available. If the authorization ID is not correlation-id
available, the value '-UNKNOWN' will be displayed. If The correlation identifier of the thread that
the 'luwid' is not available, the string detected the DRDA exception condition.
'netid.luname.000000000000' will be displayed, Correlation-IDs beginning with '0nn', where nn
describing the LU that made the request. is a number from 01 to 28, identify system
agents.
The reason code in this message describes the nature
of the DDF processing failure. connection-id
The connection name of the thread that
System Action: The system will eventually abend the detected the DRDA exception condition.
database access agent.
ifcid The IFCID number of the trace record that was
Operator Response: Notify the system programmer written.
for analysis.
seq-no The IFCID sequence number associated with
System Programmer Response: If you suspect an the trace record. The trace record contains
error in DB2, refer to Part 2 of DB2 Diagnosis Guide information that can be used to determine what
and Reference for information on identifying and caused the DRDA exception condition, and is
reporting the problem. written to statistics class 4. Statistics class 4 is
Problem Determination: Inspect the reason code and directed to SMF by default during DB2
determine if the system is operating as expected. installation, and must be directed to a
Collect the following diagnostic items listed in permanent destination (SMF or GTF) for the
“Appendix B. Problem determination” on page 1281: 1, trace record to be accessible. The message
2, 5. and the trace record are only written the first
time an error is detected. This avoids flooding
the console and the trace. The sequence
DSNL031I csect-name DRDA EXCEPTION number is printed in hexadecimal.
CONDITION IN RESPONSE FROM
SERVER LOCATION=location FOR If the sequence number is zero this has been
THREAD WITH LUWID=luwid caused by one of two conditions:
REASON=reason code ERROR v statistics class 4 was not directed to a
ID=module_name and source id permanent destination
CORRELATION ID=correlation-id v statistics class 4 was directed to the resident
CONNECTION ID=connection-id trace table as its permanant destination.
IFCID=ifcid SEE TRACE RECORD WITH
IFCID SEQUENCE NUMBER=seq-no If this message first occurred because statistics
Explanation: A DRDA exception condition was class 4 was not directed to a permanent
detected in response data returned from the application destination, then the same message recurs
server (AS) with location name location. later (along with trace record) when the
312 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL032I • DSNL033I
statistics class is directed to the resident table written to statistics class 4. Statistics class 4 is
as its permanent destination instead of SMF or directed to SMF by default during DB2
GTF. installation, and must be directed to a
permanent destination (SMF or GTF) for the
System Action: An alert was generated. Additionally,
trace record to be accessible. The message
the system wrote a trace record with IFCID=ifcid to
and the trace record are only written the first
statistics class 4 that can be used to diagnose the
time an error is detected. This avoids flooding
problem.
the console and the trace. The sequence
Problem Determination: Determine the destination of number is printed in hexadecimal.
statistics class 4 and locate and print the trace record
If the sequence number is zero this has been
with SEQUENCE NUMBER=seq-no. The reason code is
caused by one of two conditions:
described in “Part 4. DB2 Codes” on page 707. The
description of the reason code can be used in v statistics class 4 was not directed to a
conjunction with the publication Distributed Relational permanent destination
Database Architecture Reference to determine the type v statistics class 4 was directed to the resident
of DRDA exception that has been detected. Use the trace table as its permanant destination.
procedures described in Part 4 of DB2 Diagnosis Guide
and Reference to determine the problem and which If this message first occurred because statistics
system is responsible. class 4 was not directed to a permanent
destination, then the same message recurs
later (along with trace record) when the
DSNL032I csect-name DRDA EXCEPTION
statistics class is directed to the resident table
CONDITION IN REQUEST FROM
as its permanent destination instead of SMF or
REQUESTER LOCATION=location FOR
GTF.
THREAD WITH LUWID=luwid
REASON=reason code ERROR System Action: An alert was generated and the
ID=module_name and source id system wrote a trace record with IFCID=ifcid to statistics
IFCID=ifcid SEE TRACE RECORD WITH class 4 that can be used to diagnose the problem.
IFCID SEQUENCE NUMBER=seq-no
Operator Response: Notify the system programmer
Explanation: A DRDA exception condition was for analysis.
detected while processing a command or command
data received from the application requester (AR) with System Programmer Response: Determine the
location name location. A DRDA exception condition, destination of statistics class 4 and locate and print the
detected at the application server (AS), is a parsing trace record with SEQUENCE NUMBER=seq-no. The
error detected while processing a command or a reason code is described in “Part 4. DB2 Codes” on
command data object. page 707. The description of the reason code can be
used in conjunction with the publication Distributed
location Relational Database Architecture Reference to
This field contains one of the following: determine the type of DRDA exception that has been
v The requester's relational database name detected. Use the procedures described in DB2
(location name) Diagnosis Guide and Reference to determine the
problem and which system is responsible.
v The requester's VTAM LU name (<luname>)
v The requester's dotted decimal IP address
(nnn.nnn.nnn.nnn) DSNL033I csect-name DDF TERMINATION
SCHEDULED DUE TO DETECTION OF
luwid The logical unit of work (LUW) ID that identifies ABEND abend REASON reason
the thread and is also included in the trace
record, or 'NETID.LUNAME.000000000000' if Explanation: A severe error was detected during DDF
the error detected involves an invalid FMH5. processing. DDF processing can no longer continue so
DDF termination has been scheduled. 'Csect-name' is
reason The DB2 reason code for this specific error. the DB2 module that detected the condition and
error id requested DDF termination.
The module name concatenated with a 4-byte The abend and reason may also contain additional
source id that uniquely determines the source information about the cause.
within the module where the exception was
encountered. abend The abend code or zeros if no abend is
associated with the termination of DDF.
ifcid The IFCID sequence number associated with
the trace record. The trace record contains If the abend was a DB2 04E abend, the reason
information that can be used to determine what code will contain additional information about
caused the DRDA exception condition, and is the abend.
Chapter 12. DB2 Messages 313
DSNL034E • DSNL035I
reason The DB2 reason code or zeros if no DB2 v If the name must be changed, you must first remove
reason code is associated with the termination all of the resynchronization responsibility that DB2
of DDF. had using the old names. You can purge this
information, allow automatic resynchronization to take
If no abend is associated with the problem, the
place, or use a combination of both.
reason code describes the cause for the
termination. You can purge resynchronization information by using
the RESET INDOUBT command with the FORCE
System Action: Termination of the distributed data option. You can purge all information regardless of
facility (DDF) is initiated. partner name (LOCATION (*)), or you can selectively
Operator Response: Notify the system programmer purge by specifying a location name. DDF does not
for analysis. have to be started to use this command. You can use
the DISPLAY THREAD command to generate a
System Programmer Response: Determine the report of indoubt threads. This report indicates all
cause of the failure. Correct the condition and restart resynchronization responsibility known by DB2.
DDF using the -START DDF command. If you do not purge the resynchronization information,
Problem Determination: If an abend is associated or only selectively purge, and you want automatic
with the failure, a dump may have been provided. resynchronization to occur before changing the
LOGREC will also contain information about the abend. names, you must first use the change log inventory
(DSNJU003) utility to change the LUNAME and/or
LOCATION name back to the correct value. Then
DSNL034E DDF CANNOT BE STARTED BECAUSE START DDF. At this point, automatic
OF BSDS INCONSISTENCIES, resynchronization begins. You can monitor the
ORIGINAL LUNAME=luname1, BSDS progress by periodically using the DISPLAY THREAD
LUNAME=luname2, ORIGINAL command for TYPE (INDOUBT) threads.
LOCATION=location1, BSDS Resynchronization does not complete until all needed
LOCATION=location2 communications paths are available and all needed
Explanation: The LUNAME or the LOCATION name partner logical units are available. If you cannot wait
stored in the bootstrap data set (BSDS) was changed for availability, use the RESET INDOUBT command
since the distributed data facility (DDF) was last started, with the FORCE option to purge information
but DDF still has resynchronization responsibility with associated with unavailable partners.
one or more partner logical units using the old LUNAME
and LOCATION name. Both the original and current DSNL035I DDF CANNOT BE STOPPED BECAUSE
BSDS values of LUNAME and LOCATION name are AN INDOUBT DATA BASE ACCESS
displayed. THREAD EXISTS
luname1 Explanation: DDF is the connection manager for a
The LUNAME required for resynchronization database access thread (DBAT) that is indoubt. A STOP
luname2 DDF MODE(QUIESCE) command is rejected until the
The LUNAME currently stored in the BSDS indoubt logical unit of work is resolved.
location1 System Action: DDF is not stopped.
The LOCATION name required for Operator Response: Inform the database
resynchronization administrator.
location2 Database Administrator Action: You have the
The LOCATION name currently stored in the following options:
BSDS
v Wait for automatic resynchronization to be performed.
System Action: DDF cannot be started until the When this occurs, either message DSNL407I or
inconsistencies are corrected. DSNL415I is displayed.
Operator Response: Inform the database After the indoubt thread is resolved, reissue the
administrator. STOP DDF command.
v Use the DISPLAY THREAD TYPE(INDOUBT)
Database Administrator Action: You have the
command to find the LOCATION that has coordinator
following options, depending on whether there is a
responsibility for the indoubt LUW. Contact that
requirement to change the LUNAME or LOCATION
location and determine whether the LUW committed
name in the BSDS:
or aborted. Then use the RECOVER INDOUBT
v If the names were changed in error, use the change command to cause the indoubt DBAT to be resolved
log inventory (DSNJU003) utility to change the with the same decision.
LUNAME and/or LOCATION name back to the
After the indoubt thread is resolved, reissue the
correct value. Then START DDF.
STOP DDF command.
314 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL036I • DSNL042E
v Issue the STOP DDF MODE(FORCE) command. The must be terminated before the command is accepted.
indoubt thread remains indoubt and can be resolved
lu The value supplied on the RESET
by using automatic resynchronization after DDF is
GENERICLU command
started again, or it can be resolved manually as
described above. System Action: The command is rejected.
System Programmer Response: Terminate the VTAM
DSNL036I DDF THREAD logical-unit-of-work-id sessions to the remote LU and reissue the -RESET
SPECIFIED IS INDOUBT GENERICLU command.
Explanation: A database access thread that is indoubt
cannot be canceled by using the -CANCEL DDF DSNL040E csect-name RESET GENERICLU lu
THREAD command. FAILED DUE TO INDOUBT
RESOLUTION INFORMATION
System Action: The specified thread is not canceled.
Explanation: The RESET GENERICLU command was
Operator Response: Use the -DISPLAY THREAD
not accepted because information is currently being
TYPE(*) command to display all distributed activity.
retained for resolution of indoubt threads for the
indicated partner LU. The DISPLAY THREAD
DSNL037I csect-name RESET GENERICLU lu TYPE(INDOUBT) command can be used to view this
SUCCESSFUL information.
Explanation: The RESET GENERICLU command lu The value supplied on the RESET
successfully purged the VTAM sysplex information from GENERICLU command
shared memory.
System Action: The command is rejected.
lu The value supplied on the RESET
System Programmer Response: Make sure that all
GENERICLU command
indoubt threads at the remote site are resolved before
System Action: The VTAM information contained in issuing the RESET GENERICLU command.
the sysplex shared memory for the indicated LU is
When DB2 performs automatic indoubt thread
purged.
resolution, the information contained in the DISPLAY
THREAD TYPE(INDOUBT) display is purged at the end
DSNL038E csect-name RESET GENERICLU lu of the resynchronization process.
FAILED DUE TO VTAM RTNCD=xx and
If required, use the -RESET INDOUBT command to
FDB2=yy
manually purge the indoubt resolution information.
Explanation: The VTAM
CHANGE,OPTCD=(SYN,ENDAFFIN) macro returned an
DSNL041E csect-name DB2 GENERIC LU NAME
unexpected return code, which is described by the
REQUESTED, BUT REQUIRED VTAM
indicated VTAM RTNCD and FDB2 values.
LEVEL IS NOT INSTALLED
lu The value supplied on the RESET
Explanation: The DB2 GENERIC LUNAME installation
GENERICLU command
option was specified. This option requires VTAM Version
xx The hexadecimal value of the VTAM RTNCD 4 Release 2 or a later release.
field
System Action: The DB2 GENERIC LUNAME
yy The hexadecimal value of the VTAM FDB2 installation option is ignored.
field
System Programmer Response: If the DB2
System Action: VTAM was not able to purge the GENERIC LUNAME is required, install VTAM Version 4
sysplex shared memory information for the indicated Release 2 or a later release.
LU.
System Programmer Response: Refer to VTAM for DSNL042E csect-name DB2 SYSPLEX TP WAS
MVS/ESA Programming for the meaning of the VTAM INVOKED BY LU lu, BUT REQUIRED
RTNCD and FDB2 values. MVS LEVEL IS NOT INSTALLED
Explanation: A request for the DB2 sysplex
DSNL039E csect-name RESET GENERICLU lu transaction program (TP) was received by a DB2 server
FAILED DUE TO ACTIVE VTAM that is a member of a data sharing group. The DB2
SESSIONS sysplex TP is used by the requesting systems to
determine which DB2 systems within the group are
Explanation: The RESET GENERICLU command was
currently available for DDF conversations.
not accepted because one or more active VTAM
sessions exist to the indicated LU. All VTAM sessions The DB2 sysplex TP uses Work Load Manager (WLM)
Chapter 12. DB2 Messages 315
DSNL043I • DSNL070I
functions in MVS Version 5 Release 2 or a later release xx The hexadecimal value of the MVS RETCODE
to balance distributed workload among the DB2 systems field.
in the group. Because the required MVS release is not
yy The hexadecimal value of the MVS RSNCODE
installed or DB2 is not registered with WLM, the DB2
field.
sysplex TP is not able to provide the requested
information. System Action: If a sysplex routing macro failed, then
sysplex routing may not be performed in which case, all
lu The name of the LU in the network that
SQL statements received from the client will be
invoked the DB2 sysplex TP
processed by this DB2 subsystem. If an enclave macro
System Action: The DB2 sysplex TP returns the failed, the distributed thread may not be able to execute
NETID.LUNAME of the local DB2 system as the only in an MVS enclave, however the distributed thread will
available DB2 server in the group. The requester is not continue to execute as an MVS SRB.
provided the names of other DB2 systems in the group,
System Programmer Response: Refer to MVS/ESA
so all sessions from the requester are routed to the
Programming: Workload Management Services for the
local DB2 server.
meaning of the MVS RETCODE and RSNCODE values.
System Programmer Response: Install MVS Version
5 Release 2 or a later release if you want to have the
DSNL065I csect-name CURRENT DDF STATE
DB2 sysplex TP return multiple NETID.LUNAME values
DOES NOT PERMIT STOP DDF
to the requester or refer to the DSNL044I on why DB2
MODE(SUSPEND)
could not register with WLM.
Explanation: The current DDF state does not allow
suspend processing to be initiated. DDF must be started
DSNL043I csect-name RESET GENERICLU luname
for normal processing in order for suspend processing
INVALID
to be initiated.
Explanation: The luname value specified is invalid.
System Action: The command is not executed.
The correct format is either a
v 1 to 8 character luname, or
DSNL066I csect-name STOP DDF
v 1 to 8 character network ID, a period, and a 1 to 8
MODE(SUSPEND) COMPLETE
character luname.
Explanation: DDF suspend processing has completed
System Action: The parameter is ignored. Processing
successfully. DDF has suspended all inbound activity.
continues with the next luname, if any.
System Action: Processing continues normally.
User Response: Determine the correct luname and
reissue the command.
DSNL067I csect-name CURRENT DDF STATE
DOES NOT PERMIT START DDF
DSNL044I csect-name MVS macname MACRO
FAILED WITH RETCODE=xx AND Explanation: The current DDF state does not allow
RSNCODE=yy START DDF processing to be initiated.
Explanation: An MVS Workload Manager (WLM) System Action: The command is not executed.
macro returned an unexpected return code, which is
described by the indicated RETCODE and RSNCODE
values. DDF uses MVS Workload Manager macros to DSNL068I csect-name START DDF (RESUME
obtain data sharing sysplex routing information for PROCESSING) COMPLETE
incoming DDF work requests, and to establish an MVS Explanation: DDF has resumed normal processing.
enclave for the execution environment of the distributed
thread. System Action: Processing continues normally.
macname
The name of the MVS macro that returned the DSNL069I csect-name DDF IS SUSPENDING
unexpected return code. The possible values Explanation: DDF has initiated suspend processing.
are:
System Action: Processing continues normally.
v IWMSRSRG: Register with WLM for sysplex
routing.
v IWMSRSRS: Request sysplex routing DSNL070I csect-name DDF IS RESUMING
information. Explanation: DDF has initiated resume processing.
v IWMSRDRS: Deregister with WLM for
sysplex routing. System Action: Processing continues normally.
v IWMECREA: Create enclave.
316 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL071I • DSNL083I
| STOPDQ
DSNL071I csect-name WAIT OR CANCEL
| Stopped Quiesce. Last stopped normally, such
REQUIRES KEYWORD SUSPEND
| as by the ″Stop DDF Mode(Quiesce)″
Explanation: The WAIT(n) or CANCEL(n) keywords | command or DDF has not yet been started
require that MODE(SUSPEND) be specified. For
| STOPGF
information about the STOP DDF command, see DB2
| Stopping Force. Currently stopping abnormally,
Command Reference.
| such as by the ″Stop DDF Mode(Force)″
System Action: The command is not executed. | command
| SUSPND
DSNL072I csect-name WAIT TIME EXPIRED, DDF | Suspended. Currently suspended, such as by
RESUME PROCESSING INITIATED | the ″Stop DDF Mode(Suspend)″ command
Explanation: The DDF suspend process has not | SUSPNG
completed successfully in the period of time specified | Suspending. Currently suspending, such as by
for the WAIT keyword, so DDF resume processing has | the ″Stop DDF Mode(Suspend)″ command
been initiated. For information about the STOP DDF
| NOINIT Not initialized. DDF is not configured. A ″DDF
command, see DB2 Command Reference.
| STARTUP OPTION″ value of ″NO″ is specified
System Action: DDF resume processing has been | in the DSNTIPR installation panel.
initiated.
| System Action: Processing continues normally.
DSNL073I csect-name CANCEL TIME EXPIRED,
| DSNL082I LOCATION LUNAME GENERICLU
CANCEL ACTIVE DBAT PROCESSING
HAS BEEN INITIATED | Explanation: This message is issued as a result of
| the DISPLAY DDF command. This message displays
Explanation: The DDF suspend process has not
| the column headings for the DSNL083I message that
completed successfully in the period of time specified
| follows
for the CANCEL keyword so DDF is cancelling all active
data base access threads (DBATS). For information | System Action: Processing continues normally.
about the STOP DDF command, see DB2 Command
Reference.
| DSNL083I location luname genericlu
System Action: DDF is attempting to terminate all
active database access threads. | Explanation: This message is issued as a result of
| the DISPLAY DDF command. This message provides
| the column values for hte headings described by the
| DSNL080I csect DISPLAY DDF REPORT | DSNL082I message.
| FOLLOWS -
| location
| Explanation: This message is issued as a result of | The location name of DDF as defined by the
| the DISPLAY DDF command. This message is always | ″DB2 LOCATION NAME″ value in the
| generated as the title for the DISPLAY DDF command | DSNTIPR installation panel. Also, it is the
| report output. It precedes the other messages | location value of the BDSD DDF record that is
| generated by this command. | defined by the ’LOCATION’ value in the DDF
| System Action: Processing continues normally. | satatement of the DSNJU003 Change Log
| Inventory utility. A value of ’NONE’ indicates
| that a location name has not been configured.
| DSNL081I STATUS=status | This information also appears in mssage
| DSNL004I when DDF is started. See the
| Explanation: This message is issued as a result of
| DSNL004I message for additional information.
| the DISPLAY DDF command. This message displays
| the status of DDF where status is | luname
| The DDF LU name. You can determine the LU
| STARTD
| name from the ’DB2 NETWORK LUNAME’
| Started
| value in the DSNTIPR installation panel. You
| STARTG | may also determine the LU NAME from the LU
| Starting | name value of the BSDS DDF record that is
| defined by the ’LUNAME’ value in the DDF
| STOPDF | statement of the DSNJU003 Change Log
| Stopped Force. Last stopped abnormally, such | Inventory utility. A value of ’-NONE’ indicates
| as by ″Stop DDF Mode(Force)″ command | that an LU name has not been configured. If
| an LU name has been configured, then the
| field will contain the fully qualified LU name
Chapter 12. DB2 Messages 317
DSNL084I • DSNL090I
| that consists of a network ID, a period | ’DRDA PORT’ value in the DSNTIP5
| delimiter, and the LU name. The network ID is | installation panel, and the port value of the
| determined from VTAM once DDF is started. A | BSDS DDF record. The ’PORT’ value in the
| network ID of ’-NONE’ indicates that DDF has | DDF statement of the DSNJU003 Change Log
| not yet ben started, or initialization with VTAM | Inventory utility defines the port value of the
| has failed. This information also appear in | BSDS DDF record.
| message DSNL004I when DDF is started. See | v A value of 0 indicates that an SQL listener
| the DSNL004I message for additional | port has not been specified, and DDF is not
| information. | configured to use TCP/IP network protocols.
| genericlu | v A value of ’NONE’ indicates that DB2 will not
| The DDF generic LU name. The generic LU | accept connections on this port. This may be
| name is determined from the ’DB2 GENERIC | due to specifying 0 for the DSN6SYSP
| LUNAME’ value in the DSNTIPR installation | MAXDBAT installaiton parameter defined in
| panel, and the generic LU name value of the | DSNZPARM. For more information, see the
| BSDS DDF record which is defined by the | ’MAX REMOTE ACTIVE’ specification in the
| ’GENERIC’ value in the DDF statement of the | DSNTIPE installation panel in the DB2
| DSNJU003 Change Log Inventory utility. A | Installation Guide. The current ’MAX
| value of ’-NONE’ indicates that a generic LU | REMOTE ACTIVE’ value can also be seen
| name has not been configured. If a generic LU | in theMDBAT’ value of the DSNL090I
| name has been conifgured, then the field will | message that is included in the ’DISPLAY
| contain the fully qualified generic LU name | DDF DETAIL’ report.
| which consists of a network ID, a period
| delimiter, and the generic LU name. The
| This information also appears in message
| network ID is determined from VTAM once
| DSNL004I when DDF is started. See the
| DDF is started. A network ID of ’-NONE’
| DSNL004I message for additional information.
| indicates thtat DDF has not yet been started, | resport
| or initialization with VTAM has failed. This | The two phase commit resynchronization
| information also appears in message | (resync) listener TCP/IP port number. The
| DSNL004I when DDF is started. See the | resync listener port is determined from the
| DSNL004I message for additional information. | ’RESYNC PORT ’ value in the DSNTIP5
| System Action: Processing continues normally. | installation panel, and the resynchronization
| port value of the BSDS record. The
| ’RESPORT’ value in the DDF statement of the
| DSNL084I IP-ADDRESS TCPPORT RESPORT | DSNJU003 Change Log Inventory utility
| defines the resynchronization port value of the
| Explanation: This message is issued as a result of
| BSDS DDF record. A value of 0 indicates that
| the DISPLAY DDF command. This message displays
| a resyncronization listener port has not been
| the column heading for the DSNL085I message that
| specified, and DDF is not configured to use
| follows.
| TCP/IP network protocols. This information
| System Action: Processing continues normally. | also appears in message DSNL004I when DDF
| is started. See the DSNL004I message for
| additional information.
| DSNL085I ip-address tcpport resport
| System Action: Processing continues normally.
| Explanation: This message is issued as a result of
| the DISPLAY DDF command. This message provides
| the column values for the headings described by the | DSNL090I DT=dt CONDBAT=condbat
| DSNL084I message. | MDBAT=mdbat
| ip-address | Explanation: This message is issued as a result of
| The IP address of DDF. During DDF start | the DISPLAY DDF DETAIL command. This message
| processing, DDF issues a GetHostID (USS | displays some of the system parameter information
| BPX1HST macro) socket call to determine its | associated with DDF.
| IP address if the listener ports are defined. A
DDF thread value. It indicates the ″DDF
| dt
| value of ’-NONE’ indicates that DDF is not
| THREADS″ value specified in the DSNTIPR
| configured to use TCP/IP network protocols
| installation panel.
| (see tcpport), DDF has not yet been started, or
| TCP/IP initialization has failed. | v A - DDF is configured with DDF THREADS
| ACTIVE
| tcpport v I - DDF is configured with DDF THREADS
|
| The SQL listener TCP/IP port number. The
| INACTIVE
| SQL listener port is determined from the
318 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL092I • DSNL093I
| condbat | access threads to service the request (see
| Maximum number of inbound connections as | DSNL093I dscdbat) value, or if DDF is
| determined by the ″MAX REMOTE | suspended or suspending (see DSNL081I
| CONNECTED″ value in the DSNTIPE | status value), then these requests cannot yet
| installation panel. | be serviced. If DDF is suspending or stopped
| suspended (see DSNL081I status value), then
| mdbat Maximum number of database access threads
| these conqued connections will not be
| as determined by the ″MAX REMOTE ACTIVE″
| processed until DDF is started (resumed). If
| value in the DSNTIPE installation panel. This
| the adbat value is equal to or greater than the
| effectively determines the maximum number of
| DSNL090I mdbat value, then these conqued
| active slots. That is, the maximum number of
| connections will not be processed until another
| concurrent active database access threads that
| active database access thread releases its slot
| could potentially be executing SQL.
| by either terminating or by moving to the
| System Action: Processing continues normally. | inactive state (see the in1dbat or DSNL093I
| in2cons value).
| DSNL092I ADBAT=adbat QUEDBAT=quedbat | System Action: Processing continues normally.
| IN1DBAT=in1dbat CONQUED=conqued
| Explanation: This message is issued as a result of | DSNL093I DSCDBAT=dscdbat IN2CONS=in2cons
| the DISPLAY DDF DETAIL command.
| Explanation: This message is issued as a result of
| adbat Current number of active database access | the DISPLAY DDF DETAIL command.
| threads. This value increases as new database
| dscdbat
| access threads get created or become active.
| Current number of disconnected database
| The value decreases as database access
| access threads. Only applies if the dt value
| threads terminate or become inactive. When
| specified in the DSNL090I message indicates
| this value reaches or exceeds the mdbat value
| that DDF INACTIVE support is enabled. This is
| as indicated in the DSNL090I message, then
| effetively the number of DBAT pool threads.
| new or inactive (type 1) database access
| DBAT pool threads are the database access
| threads, or new or inactive (type 2)
| threads that are available to service queued
| connections must be queued.
| connections requests (see DSNL092I conqued
| quedbat | value). Database access threads reflected here
| Curent number of database access threads | will also be accounted for in the DSNL092I
| that are suspended because the mdbat value | adbat value. Over time, disconnected DBATs
| has been reached. See message DSNL090I | may hold allocation duration locks, such as
| for information about mdbat. Also see | locks related to DDL. These disconnected
| information regarding the adbat value. | DBATs can be temrinated by the STOP DDF
| MODE SUSPEND command, which allows
| in1dbat | their held allocation dureation locks to be
| Current number of type 1 inactive threads. | released. Stopping DDF with mode SUSPEND
| Only aplies if the ″dt″ value specified in the | allows nthese disconnected DBATs to be
| DSNL090I message indicates that DDF | terminated without affecting current or new
| INACTIVE support is enabled. Any database | connections, although activity on these current
| access threads reflected here can also be | or new connections will not be processed until
| observed in the DISPLAY THREAD | DDF is started (resumed). Disconnect DBATs
| TYPE(INACTIVE) command report. | can also be made to terminate when they have
| conqued | been unused for a certain lengh of time, thus
| Current number of connection requests that | releasing their allocate duration locks. This can
| have been queued and are waiting to be | be done by adjusting the DBAT pool thread
| serviced. Only applies if the ″dt″ value | timeout value as described by ″POOL
| specified in the DSNL090I mesage indiactes | THREAD TIMEOUT″ in the DSNTIP5
| that DDF INACTIVE support is enabled. These | installation panel.
| connections can represent newly attached | in2cons
| connections, or inactive connections for which | Current number of type 2 inactive connections.
| a new request has arrived from the client | Only applies if the dt value specified in the
| (connections that were represented in the | DSNL090I message indicates that DDF
| in2cons value of the DSNL093I message). If | INACTIVE support is enabled. This value
| the maximum number of database access | represents connections with clients where the
| threads has been reached (adbat value is | client last ended a unit of work (commit or
| equal to or greater than the DSNL090I mdbat | rollback) and thus DB2 changes the state of
| value) and there are no disconnected database
Chapter 12. DB2 Messages 319
DSNL099I • DSNL202I
| the connection to ″type 2″ inactive. That is, the CONVS
| DBAT is separated from the connection and The total number of conversations in use
| connection becomes inactive while the DBAT is between this site and the remote location
| made available to service new client
| ocnnections or to service new requests on See message DSNL202I a for more specific description
| existing client connections. This value is not of these items.
| included in the DSNL092I in1dbat value. When
| a new request arrives from the client system The message number and subsystem recognition
| on the connection, the connection will then be character are not included in this message.
| moved to the DSNL092I conqued value. Any
| connections reflected here can also be System Action: Processing continues normally.
| observed in the DISPLAY THREAD
| TYPE(INACTIVE) command report. DSNL202I LOCATION PRDID LINKNAME
| System Action: Processing continues normally. REQUESTERS SERVERS CONVS
Explanation: This message lists the status of
| DSNL099I csect DISPLAY DDF REPORT communications between a remote location and this
| COMPLETE DB2 subsystem. Information about the status appears
below:
| Explanation: This message indicates that the
| DISPLAY DDF report successfully completed. Item Description
| System Action: Processing continues normally. LOCATION
A 16-byte name for the remote site.
DSNL200I DISPLAY LOCATION REPORT PRDID Identifies the database product at the location
FOLLOWS— in the form nnnvvrrm.
v nnn - Identifies the database product. E.g.,
Explanation: This message is the title for the
DSN=DB2.
-DISPLAY LOCATION command report output. It
precedes the other messages generated by this v vv - Product version.
command. This message is followed by messages v rr - Product release.
DSNL201I and DSNL202I. The final message for the v m - Product modification level.
report is be message DSNL205I.
LINKNAME
System Action: The -DISPLAY LOCATION command The VTAM LU name or dotted decimal IP
continues normally. address associated with the remote location.
REQUESTERS
DSNL201I LOCATION PRDID LINKNAME A count of the threads at this location that
REQUESTERS SERVERS CONVS access data at the remote location. The count
Explanation: The column headings for the list of includes all the allied threads associated with
locations generated by the -DISPLAY LOCATION the remote location, and any database access
command are displayed. The definitions are listed threads that are accessing data at the remote
below: location.
Heading SERVERS
Description A count of the database access threads at this
location that access data for agents at the
LOCATION remote location.
The location name associated with the remote
site CONVS
A count of the total number of conversations
PRDID Identifies the database product at the location between the two systems. The count includes
LINKNAME both allied and database threads.
The VTAM LU name associated with the
remote location The message number and subsystem recognition
character are not included in this message.
REQUESTERS
The number of agents at this site that are System Action: Processing continues normally.
requesting data from the remote location
SERVERS
The number of agents at this site that are
acting as a server to the remote location
320 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL203I • DSNL204I
a conversation that it uses to send
DSNL203I L203-SYSTASK SESSID A ST TIME
information to the remote site, and another
Explanation: This message forms the heading for the that it uses to receive information from the
listing of DB2 system threads that communicate with remote site. A DB2 system thread is created
other locations. It follows each occurrence of message to manage ’outbound’ (used for sending)
DSNL202I if the DETAIL keyword of the DISPLAY conversations and another to manage
LOCATION command is used. This message is followed ’inbound’ (used for receiving) conversations.
by one or more occurrences of message DSNL204I, v RESYNC
which describe the DB2 system threads communicating
A conversation used to resynchronize a unit
with the remote site and its conversation information.
of work that encountered a previous thread
Items in this part of the heading are:
or communication error. There can be one
SYSTASK entry representing each thread needing
Heading that describes the DB2 system thread resynchronization with the remote site.
SESSID sessid Two possible values can appear in this column:
Heading for the associated conversation 1. For VTAM network connections, this
identifiers column contains the VTAM-defined session
A Heading for the associated active indicators instance identifier of the session on which
the conversation is executing. If the
ST Heading for the associated status indicators session identifier is not applicable, this field
TIME Heading for the associated timestamps contains zeros.
VTAM does not supply the entire session id
See message DSNL204I for descriptions of these items. to DB2. The first two digits of the session id
are incorrect. Therefore, the session id, as
The message number and subsystem recognition presented in this message, is not
character are not included in this message. However, acceptable in VTAM commands. Use the
L203 is included in the message text to identify the VTAM DISPLAY NET,ID=db2-
message. luname,SCOPE=ACT command to obtain
the full session ID. The DISPLAY NET
System Action: Processing continues normally. command lists all sessions (SID) for the
DB2 logical unit. Scan the DISPLAY NET
DSNL204I L204-SYSTASK SESSID ACTIVE output for the complete SID.
STATUS TIME 2. For TCP/IP network connections, this
column contains a string of the form
Explanation: This message follows the DSNL203I 'local:remote', where:
message for a remote location when a detail display is
specified on the DISPLAY LOCATION command. This local -- specifies the local DB2 system's
message is displayed for each conversation owned by a TCP/IP port number
DB2 system thread that communicates with the site. It
remote --
lists detailed information about the conversations
specifies the remote partner's
associated with the DB2 system thread.
TCP/IP port number
systask
active One of the following:
Describes the DB2 system threads as follows:
v SYSCON-x V The conversation is active within
VTAM or TCP/IP.
Where x =
W The conversation is suspended in
O The system thread that manages
DB2 waiting for VTAM or TCP/IP
’outbound’ DB2 system
notification that the function is
conversations.
complete.
I The system thread that manages
Blank, otherwise.
’inbound’ DB2 system
conversations. status Status of the conversation:
A Conversation in allocation.
When DB2 is communicating with other DB2
locations using system-directed access, DB2 C Session limits are being negotiated
establishes ’system conversations’ to the with the partner (CNOS) prior to
remote DB2 location. DB2 uses these conversation allocation.
conversations internally. The conversations
D Conversation in deallocation.
created are one directional. That is, DB2 has
Chapter 12. DB2 Messages 321
DSNL205I • DSNL400E
R Receiving. User Response: Reissue the -DISPLAY LOCATION
request specifying a specific location or list of locations.
S Sending.
Blank otherwise.
DSNL400E INDOUBT THREAD RESOLUTION WITH
time The timestamp (yydddhhmmssth) of the last COORDINATOR location SHOWS
message sent or received on the conversation. HEURISTIC DAMAGE FOR luwid=token -
REMOTE COMMIT VERSUS LOCAL
The message number and subsystem recognition ABORT. INFORMATION RECORDED IN
character are not included in this message. However, TRACE RECORD WITH IFCID=207 AND
L204 is included in the message text to identify the IFCID SEQUENCE NUMBER=seq-no1
message. AND IN TRACE RECORD WITH
IFCID=203 AND IFCID SEQUENCE
System Action: Command processing continues NUMBER=seq-no2
Explanation: DB2 has participant responsibility in the
DSNL205I DISPLAY LOCATION REPORT logical unit of work identified by ’luwid=token’.
COMPLETE Resolution with the coordinator identified by ’location’
Explanation: This message follows messages shows heuristic damage occurred. The DB2 thread
DSNL200I, DSNL201I, and DSNL202I and indicates representing the logical unit of work was previously
that the -DISPLAY LOCATION report successfully resolved using the RECOVER INDOUBT command.
completed. The action taken was to abort the thread. Subsequently,
communication was reestablished with the coordinator
The message number and subsystem recognition and resolution shows that the coordinator committed the
character are not included in this message. thread.
System Action: Processing continues normally. v The application was told that commit succeeded.
v Any resources updated at the coordinator were
committed.
DSNL206I csect-name named-command COMMAND v Updated resources at this DB2 were rolled back.
INVALID, DDF NOT STARTED
location
Explanation: The 'named-command' command was The field contains one of the following:
issued before the distributed data facility (DDF) was v The relational database name (location
started. The 'named-command' command executes name)
successfully only if the DDF is operating.
v The VTAM LU name (<luname>)
System Action: Processing continues normally. v The dotted decimal IP address
(nnn.nnn.nnn.nnn).
DSNL207I DISPLAY LOCATION NO LOCATIONS luwid=token
FOUND The global logical unit of work id and the local
Explanation: The -DISPLAY LOCATION command token that identify the thread.
was unable to find any locations associated with the seq-no1
specified list of locations. If all locations were specified, The IFCID sequence number associated with
there is no distributed activity. the 207 trace record. The sequence number is
System Action: Processing completed normally. printed in hexadecimal format. If the sequence
number is zero, IFCID 207 was not active or it
User Response: If a location list was specified, was active with a destination of the resident
reissue the -DISPLAY LOCATION command using the trace table only. IFCID 207 is a member of
LOCATION(*) parameter to display information for all statistics class 4, which has a default
locations, if desired. destination of SMF. This trace record is written
when the heuristic damage condition was
DSNL208I DISPLAY LOCATION TERMINATED detected and contains information about the
WITH MAX LINES damage condition.
Explanation: The message indicates the -DISPLAY seq-no2
LOCATION report was truncated. The report was The IFCID sequence number associated with
generated in response to a command from an MVS the 203 trace record. The sequence number is
console and more than 254 response messages were printed in hexadecimal format. If the sequence
generated. Only 254 response messages are returned. number is zero, IFCID 203 was not active or it
was active with a destination of the resident
System Action: Command processing completes. The trace table only. IFCID 203 is a member of
truncated report is written to the MVS console. statistics class 4, which has a default
322 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL401E
destination of SMF. This trace record was v Any resources updated at the coordinator were rolled
written when the heuristic decision to commit back.
or abort was made and contains information v Updated resources at this DB2 were committed.
about the decision, including the names of any
location
downstream participants.
The field contains one of the following:
System Action: Alert A004 is generated. A trace v The relational database name (location
record whose IFCID=207 is written. Indoubt resolution name)
with the coordinator completes.
v The VTAM LU name (<luname>)
System Programmer Response: Determine the v The dotted decimal IP address
destination of statistics class 4 and locate and print the (nnn.nnn.nnn.nnn).
trace record with SEQUENCE NUMBER=’seq-no1’. Call
the database administrator. luwid=token
The global logical unit of work id and the local
Database Administrator Action: Correct the damage. token that identify the thread.
This is not an easy task. Since the time of the heuristic
action, the data that was aborted with the RECOVER seq-no1
INDOUBT command might have been used by many The IFCID sequence number associated with
applications - read and/or write. Correcting the damage the 207 trace record. The sequence number is
might involve reversing the effects of these applications printed in hexadecimal format. If the sequence
as well. Tools available are: number is zero, IFCID 207 was not active or it
was active with a destination of the resident
v The statistics trace class 4 contains an IFCID 207
trace table only. IFCID 207 is a member of
trace record. This record contains the RBA of the first
statistics class 4, which has a default
DB2 log record written for the logical unit of work
destination of SMF. This trace record is written
whose LUWID is included in this message.
when the heuristic damage condition was
v The DSN1LOGP utility provides a summary report detected and contains information about the
that identifies the table spaces modified by the logical damage condition.
unit of work and any downstream participant locations
involved in the logical unit of work. seq-no2
The IFCID sequence number associated with
v DISPLAY THREAD TYPE(INDOUBT) displays the
the 203 trace record. The sequence number is
RBA of the first DB2 log record written for the logical
printed in hexadecimal format. If the sequence
unit of work whose LUWID is included in this
number is zero, IFCID 203 was not active or it
message. This information continues to appear in the
was active with a destination of the resident
DISPLAY THREAD report until it is purged with the
trace table only. IFCID 203 is a member of
RESET INDOUBT command.
statistics class 4, which has a default
destination of SMF. This trace record was
Contact your IBM Support Center for further assistance.
written when the heuristic decision to commit
or abort was made and contains information
DSNL401E INDOUBT THREAD RESOLUTION WITH about the decision, including the names of any
COORDINATOR location SHOWS downstream participants.
HEURISTIC DAMAGE FOR luwid=token -
System Action: Alert A004 is generated. A trace
REMOTE ABORT VERSUS LOCAL
record whose IFCID=207 is written. Indoubt resolution
COMMIT. INFORMATION RECORDED IN
with the coordinator completes.
TRACE RECORD WITH IFCID=207 AND
IFCID SEQUENCE NUMBER=seq-no1 System Programmer Response: Determine the
AND IN TRACE RECORD WITH destination of statistics class 4. Locate and print the
IFCID=203 AND IFCID SEQUENCE trace record with SEQUENCE NUMBER=’seq-no1’. Call
NUMBER=seq-no2 the database administrator.
Explanation: DB2 has participant responsibility in the Database Administrator Action: Correct the damage.
logical unit of work identified by ’luwid=token’. This is not an easy task. Since the time of the heuristic
Resolution with the coordinator identified by ’location’ action, the data that was committed with the RECOVER
shows heuristic damage occurred. The DB2 thread INDOUBT command might have been used by many
representing the logical unit of work was previously applications - read and/or write. Correcting the damage
resolved with the RECOVER INDOUBT command. The might involve reversing the effects of these applications
action taken was to commit the thread. Subsequently, as well. Tools available are:
communication was reestablished with the coordinator v The statistics trace class 4 contains an IFCID 207
and resolution shows that the coordinator aborted the trace record. This record contains the RBA of the first
thread. DB2 log record written for the logical unit of work
v The application was told that commit failed. whose LUWID is included in this message.
Chapter 12. DB2 Messages 323
DSNL402I • DSNL403I
v The DSN1LOGP utility provides a summary report administrator at ’location’ that heuristic damage
that identifies the table spaces modified by the logical occurred for the logical unit of work with LUWID=’luwid’.
unit of work, and any downstream participant DB2 was the coordinator for the logical unit of work and
locations involved in the logical unit of work. made the decision to abort the database updates made
v DISPLAY THREAD TYPE(INDOUBT) displays the by ’luwid’. At ’location’ a heuristic decision was made to
RBA of the first DB2 log record written for the logical COMMIT the updates made by ’luwid’.
unit of work whose LUWID is included in this Information about the heuristic damage continues to
message. This information continues to appear in the appear in the DISPLAY THREAD TYPE(INDOUBT)
DISPLAY THREAD report until it is purged with the report until it is purged with the RESET INDOUBT
RESET INDOUBT command. command.
Contact your IBM Support Center for further assistance.
DSNL403I INDOUBT THREAD RESOLUTION WITH
PARTICIPANT location SHOWS
DSNL402I INDOUBT THREAD RESOLUTION WITH HEURISTIC DAMAGE FOR luwid=token -
PARTICIPANT location SHOWS REMOTE ABORT VERSUS LOCAL
HEURISTIC DAMAGE FOR luwid=token - COMMIT. INFORMATION RECORDED IN
REMOTE COMMIT VERSUS LOCAL TRACE RECORD WITH IFCID=207 AND
ABORT. INFORMATION RECORDED IN IFCID SEQUENCE NUMBER=seq-no
TRACE RECORD WITH IFCID=207 AND
IFCID SEQUENCE NUMBER=seq-no Explanation: DB2 has coordinator responsibility for
the logical unit of work identified by ’luwid=token’.
Explanation: DB2 has coordinator responsibility for Resolution with a participant shows heuristic damage
the logical unit of work identified by ’luwid=token’. occurred. The participant identified by ’location’
Resolution with a participant shows heuristic damage manually resolved the indoubt thread identified by
occurred. The participant identified by ’location’ ’luwid=token’. The action taken was to abort the thread.
manually resolved the indoubt thread identified by This is inconsistent with the commit decision of the
’luwid=token’. The action taken was to commit the coordinator.
thread. This is inconsistent with the abort decision of the v The application was told that commit succeeded.
coordinator. v Any resources updated at the participant were rolled
v The application was told that commit failed. back.
v Any resources updated at the participant were v Updated resources at this DB2 were committed.
committed.
v Updated resources at this DB2 were rolled back. location
The relational database name (location-name),
location SNA LU name (<luname>), or dotted decimal
The field contains one of the following: IP address of the participant.
v The relational database name (location
luwid=token
name)
The global logical unit of work id and the local
v The VTAM LU name (<luname>) token that identify the thread.
v The dotted decimal IP address
seq-no The IFCID sequence number associated with
(nnn.nnn.nnn.nnn).
the trace record. The sequence number is
luwid=token printed in hexadecimal format. If the sequence
The global logical unit of work id and the local number is zero, IFCID 207 was not active or it
token that identify the thread. was active with a destination of the resident
trace table only. IFCID 207 is a member of
seq-no The IFCID sequence number associated with statistics class 4, which has a default
the trace record. The sequence number is destination of SMF.
printed in hexadecimal format. If the sequence
number is zero, then IFCID 207 was not active System Action: Alert A004 is generated. A trace
or it was active with a destination of the record with IFCID 207 is written. Indoubt resolution with
resident trace table only. IFCID 207 is a the participant completes.
member of statistics class 4, which has a
System Programmer Response: Call the database
default destination of SMF.
administrator.
System Action: Alert A004 is generated. A trace
Database Administrator Action: Inform the database
record whose IFCID=207 is written. Indoubt resolution
administrator at ’location’ that heuristic damage
with the participant completes.
occurred for the logical unit of work with LUWID=’luwid’.
System Programmer Response: Call the database DB2 was the coordinator for the logical unit of work and
administrator. made the decision to COMMIT the database updates
made by ’luwid’. At ’location’ a heuristic decision was
Database Administrator Action: Inform the database
324 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL404E • DSNL405I
made to back out (ABORT) the updates made by steps can be taken at the DB2 coordinator to determine
’luwid’. the commit or abort decision.
Information about the heuristic damage continues to 1. If the coordinator DB2 system is running and a DB2
appear in the DISPLAY THREAD TYPE(INDOUBT) conditional restart was not performed since the error
report until it is purged with the RESET INDOUBT was detected at this (the participant) location, ask
command. the database administrator at the DB2 coordinator
location to issue one of the following DISPLAY
THREAD TYPE(INDOUBT) commands:
DSNL404E PROTOCOL ERROR DURING INDOUBT
v A -DISPLAY THREAD TYPE(INDOUBT), using
THREAD RESOLUTION WITH
the LOCATION keyword and specifying the
COORDINATOR location
location name of the local DB2.
LUWID=luwid=token INFORMATION
RECORDED IN TRACE RECORD WITH v A -DISPLAY THREAD TYPE(INDOUBT)
IFCID=206 AND IFCID SEQUENCE LUWID(luwid)
NUMBER=seq-no If a thread with LUWID=luwid appears in the display,
Explanation: DB2 has participant responsibility for the then the display also includes the commit or abort
logical unit of work identified by ’luwid=token’. The DB2 decision. If no thread with LUWID=luwid appears in
thread associated with the logical unit of work is the display, the thread was aborted.
indoubt. A protocol error occurred during indoubt 2. If the DB2 coordinator is down, or if a conditional
resolution with the coordinator identified by ’location’. restart was performed there, ask the database
administrator at the DB2 coordinator to run
location
DSN1LOGP, specifying SUMMARY(ONLY) FILTER
Either the relational database name
LUWID(luwid). The output from DSN1LOGP
(location-name) or the logical unit name
includes the commit or abort decision.
(<luname>) of the coordinator.
luwid=token Use the RECOVER INDOUBT command at this (the
The global logical unit of work id and the local participant) location to resolve the indoubt thread.
token that identify the thread.
seq-no The IFCID sequence number associated with DSNL405I THREAD luwid=token PLACED IN
the trace record. The sequence number is INDOUBT STATE BECAUSE OF
printed in hexadecimal format. If the sequence COMMUNICATION FAILURE WITH
number is zero, IFCID 206 was not active or it COORDINATOR location. INFORMATION
was active with a destination of the resident RECORDED IN TRACE RECORD WITH
trace table only. IFCID 206 is a member of IFCID=209 AND IFCID SEQUENCE
statistics class 4, which has a default NUMBER=seq-no
destination of SMF.
Explanation: During execution of the two phase
System Action: The indoubt thread remains indoubt. commit protocol with the coordinator identified by
Alert A003 is generated. A trace record whose ’location’, communication failed. Phase 1 of the protocol
IFCID=206 is written. completed and the thread is prepared for either commit
or abort.
System Programmer Response: This is an
APARable error, probably at the coordinator, but The thread is placed in the indoubt state and appears in
possibly at the DB2 participant. The DB2 documentation a DISPLAY THREAD TYPE (INDOUBT) report. Periodic
required is contained in the statistics class 4 trace attempts are made to reestablish communication with
record that was written. Determine the destination of the coordinator for automatic indoubt resolution. If
statistics class 4. Locate and print the trace record with successful, message DSNL407 or DSNL415 is written.
SEQUENCE NUMBER=’seq-no’.
luwid=token
Call the database administrator. The global logical unit of work id and the local
token that identify the thread.
Database Administrator Action: DB2 does not attempt
to automatically resolve the indoubt thread. The indoubt location
thread must be manually resolved. The commit or abort The field contains one of the following:
decision made at the coordinator must be determined v The relational database name (location
so that the same decision can be made at this name)
participant DB2.
v The VTAM LU name (<luname>)
Contact the database administrator at the coordinator v The dotted decimal IP address
location to determine whether the thread with (nnn.nnn.nnn.nnn).
LUWID=luwid committed or aborted.
seq-no The IFCID sequence number associated with
If the coordinator system is another DB2, the following
Chapter 12. DB2 Messages 325
DSNL406I
the trace record. The sequence number is v Use the RECOVER INDOUBT command to commit
printed in hexadecimal format. If the sequence or abort the thread.
number is zero, IFCID 209 was not active or it
was active with a destination of the resident
DSNL406I THREAD luwid=token AT PARTICIPANT
trace table only. IFCID 209 is a member of
location MAY BE INDOUBT BECAUSE
statistics class 4, which has a default
OF A COMMUNICATION FAILURE. DB2
destination of SMF.
COMMITTED THE THREAD.
System Action: Alert A006 is generated. A trace INFORMATION RECORDED IN TRACE
record whose IFCID=209 is written. RECORD WITH IFCID=209 AND IFCID
SEQUENCE NUMBER=seq-no
Operator Response: If message DSNL407 or
DSNL415 for the LUWID specified in the DSNL405 Explanation: During execution of the two phase
message does not appear in a reasonable amount of commit protocol with the participant identified by
time, call the system programmer. ’location’, communications failed. Phase 1 of the
protocol completed with the participant, which is
System Programmer Response: Determine the
prepared to either commit or abort. The decision to
cause of the communication failure and have the
commit the thread was made, but cannot be
problem fixed. DB2 periodically attempts to reestablish
communicated to the participant at this time. The
communication. If the problem cannot be fixed in a
participant is indoubt.
reasonable amount of time, call the database
administrator. Manual resolution of the indoubt thread DB2 becomes responsible for indoubt resolution with
might be necessary to release locked resources. the participant. This responsibility appears in a
DISPLAY THREAD TYPE (INDOUBT) report. Periodic
Database Administrator Action: Take the following
attempts are made to reestablish communication with
actions to resolve this thread using manual means (that
the participant for automatic indoubt resolution. If
is, take heuristic action) if it is necessary to release
successful, message DSNL423 is written.
locks held by this thread.
v Determine the proper commit or abort decision by luwid=token
contacting the database administrator at the The global logical unit of work id and the local
coordinator ’location’ shown in this message in order token that identify the thread.
to determine whether the thread with LUWID=luwid location
committed or aborted. The field contains one of the following:
If the coordinator system is another DB2, the v The relational database name (location
following steps can be taken at the DB2 coordinator name)
to determine the commit or abort decision.
v The VTAM LU name (<luname>)
1. If the coordinator DB2 system is running and a
v The dotted decimal IP address
DB2 conditional restart was not performed since
(nnn.nnn.nnn.nnn).
the error was detected at this (the participant)
location, ask the database administrator at the seq-no The IFCID sequence number associated with
DB2 coordinator location to issue one of the the trace record. The sequence number is
following DISPLAY THREAD TYPE(INDOUBT) printed in hexadecimal format. If the sequence
commands: number is zero, IFCID 209 was not active or it
– A -DISPLAY THREAD TYPE(INDOUBT), using was active with a destination of the resident
the LOCATION keyword and specifying the trace table only. IFCID 209 is a member of
location name of the local DB2. statistics class 4, which has a default
destination of SMF.
– A -DISPLAY THREAD TYPE(INDOUBT)
LUWID(luwid) System Action: Alert A006 is generated. A trace
record whose IFCID=209 is written.
If a thread with LUWID=luwid appears in the
display, then the display also includes the commit Operator Response: If message DSNL423 for the
or abort decision. If no thread with LUWID=luwid LUWID specified in message DSNL406 does not appear
appears in the display, then the thread was in a reasonable amount of time, call the system
aborted. programmer.
2. If the DB2 coordinator is down or if a conditional System Programmer Response: Determine the
restart was performed there, ask the database cause of the communication failure and have the
administrator at the DB2 coordinator to run problem fixed. DB2 periodically attempts to reestablish
DSN1LOGP, specifying SUMMARY(ONLY) communication. If the problem cannot be fixed in a
FILTER LUWID(luwid). The output from reasonable amount of time, call the database
DSN1LOGP includes the commit or abort administrator. The participant might need to manually
decision. resolve the indoubt state to release locked resources.
326 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL407I • DSNL408I
Database Administrator Action: If the unit of work with v The dotted decimal IP address
LUWID=luwid is indoubt at ’location’, inform the (nnn.nnn.nnn.nnn).
database administrator there that the logical unit of work
luwid=token
with LUWID=luwid was committed to assist in manual
The global logical unit of work id and the local
resolution of the indoubt thread at ’location’.
token that identify the thread.
seq-no The IFCID sequence number associated with
DSNL407I AUTOMATIC RESOLUTION OF
the trace record. The sequence number is
luwid=token WITH COORDINATOR
printed in hexadecimal format. If the sequence
location RESULTED IN COMMIT
number is zero, then IFCID 207 was not active
Explanation: The identified indoubt logical unit of work or it was active with a destination of the
was automatically resolved by communication with the resident trace table only. IFCID 207 is a
coordinator location. After automatic resolution, this member of statistics class 4, which has a
message is issued if message DSNL405 was previously default destination of SMF.
issued to report the thread as indoubt. This message is
System Action: Alert A004 is generated. A trace
not issued if message DSNL405 occurs in one restart of
record whose IFCID=207 is written. Indoubt resolution
DDF or DB2, and automatic resolution occurs in a
with the coordinator completes.
different restart of DDF or DB2.
System Programmer Response: Determine the
luwid=token
destination of statistics class 4. Locate and print the
The global logical unit of work id and the local
trace record with SEQUENCE NUMBER=’seq-no’. Call
token that identify the thread
the database administrator.
location
Database Administrator Action: Inform the database
The field contains one of the following:
administrator at the coordinator ’location’ and at the
v The relational database name (location participant ’location’ of the problem.
name)
Correcting the damage at the participant is not an easy
v The VTAM LU name (<luname>)
task. Since the time of the heuristic action, the data that
v The dotted decimal IP address was aborted using manual means might have been
(nnn.nnn.nnn.nnn). used by many applications - read and/or write.
System Action: Processing continues normally. Correcting the damage might involve reversing the
effects of these applications as well. The following
information that is available at DB2 might be helpful in
DSNL408I INDOUBT THREAD RESOLUTION WITH correcting the problem:
COORDINATOR location SHOWS
v The statistics trace class 4 contains an IFCID 207
HEURISTIC DAMAGE AT PARTICIPANT
trace record. This record contains the RBA of the first
location FOR luwid=token -
DB2 log record written for the logical unit of work
COORDINATOR COMMIT VERSUS
whose LUWID is included in this message.
PARTICIPANT ABORT. INFORMATION
RECORDED IN TRACE RECORD WITH v The DSN1LOGP utility provides a summary report
IFCID=207 AND IFCID SEQUENCE that identifies the table spaces modified by the logical
NUMBER=seq-no unit of work at the local DB2 as well as any
downstream participant locations involved in the
Explanation: DB2 has participant responsibility in the logical unit of work. This information, while not
logical unit of work identified by ’luwid=token’ for the directly related to the damage at the participant,
coordinator at COORDINATOR ’location’ and might be useful in determining the scope of the
coordination responsibility in the same logical unit of problem.
work for the participant at PARTICIPANT ’location’.
v DISPLAY THREAD TYPE(INDOUBT) displays the
Heuristic damage occurred.
RBA of the first DB2 log record written for the logical
v The application was told that commit succeeded.
unit of work whose LUWID is included in this
v Any resources updated at the coordinator and at this
message. This information continues to appear in the
DB2 were committed.
DISPLAY THREAD report until it is purged with the
v Updated resources at the participant were rolled
RESET INDOUBT command.
back.
location Contact your IBM Support Center for further assistance.
The field contains one of the following:
v The relational database name (location
name)
v The VTAM LU name (<luname>)
Chapter 12. DB2 Messages 327
DSNL409I • DSNL410I
v The statistics trace class 4 contains an IFCID 207
DSNL409I INDOUBT THREAD RESOLUTION WITH
trace record. This record contains the RBA of the first
COORDINATOR location SHOWS
DB2 log record written for the logical unit of work
HEURISTIC DAMAGE AT PARTICIPANT
whose LUWID is included in this message.
location FOR luwid=token -
COORDINATOR ABORT VERSUS v The DSN1LOGP utility provides a summary report
PARTICIPANT COMMIT. INFORMATION that identifies the table spaces modified by the logical
RECORDED IN TRACE RECORD WITH unit of work at the local DB2 and any downstream
IFCID 207 AND IFCID SEQUENCE participant locations involved in the logical unit of
NUMBER=seq-no work. This information, while not directly related to
the damage at the participant, might be useful in
Explanation: DB2 has participant responsibility in the determining the scope of the problem.
logical unit of work identified by ’luwid=token’ for the
v DISPLAY THREAD TYPE(INDOUBT) displays the
coordinator at COORDINATOR ’location’ and
RBA of the first DB2 log record written for the logical
coordination responsibility in the same logical unit of
unit of work whose LUWID is included in this
work for the participant at PARTICIPANT ’location’.
message. This information continues to appear in the
Heuristic damage occurred.
DISPLAY THREAD report until it is purged with the
v The application was told that commit failed.
RESET INDOUBT command.
v Any resources updated at the coordinator and at this
DB2 were rolled back.
v Updated resources at the participant were committed. Contact your IBM support center for further assistance.
location
The field contains one of the following: DSNL410I WARM START CONNECTION BY
PARTNER location REJECTED.
v The relational database name (location PARTNER CHANGED AT LEAST 1 OF -
name) OUR LOG NAME
v The VTAM LU name (<luname>) oldourname(newourname), THEIR LOG
v The dotted decimal IP address NAME oldtheirname(newtheirname),
(nnn.nnn.nnn.nnn). PA_SUPPORT oldpa(newpa),
FLAG_BYTE_SENT oldfb(newfb),
luwid=token CCLUNAME_SENT oldccls(newccls),
The global logical unit of work id and the local AND INDOUBT THREADS REQUIRE
token that identify the thread. RESOLUTION. SEE IFCID=205 TRACE
seq-no The IFCID sequence number associated with RECORD WITH IFCID SEQUENCE
the trace record. The sequence number is NUMBER=seq-no.
printed in hexadecimal format. If the sequence Explanation: An attempt to make a warm start
number is zero, then IFCID 207 was not active connection with a partner was rejected because the
or it was active with a destination of the partner specified a different set of sync point
resident trace table only. IFCID 207 is a parameters than the ones that were in use when
member of statistics class 4, which has a communications were lost. DB2 has knowledge of
default destination of SMF. indoubt threads that involve the partner as either the
System Action: Alert A004 is generated. A trace coordinator or a participant. This error might be a
record whose IFCID=207 is written. Indoubt resolution recoverable error if the partner can restart with the
with the coordinator completes. original sync point parameters. If this is not possible,
then the partner must perform a cold start connection
System Programmer Response: Determine the with DB2.
destination of statistics class 4. Locate and print the
trace record with SEQUENCE NUMBER=’seq-no’. Call location
the database administrator. The ’location’ with which the connection failed:
either the relational database name
Database Administrator Action: Inform the database (location-name) or the logical unit name
administrator at the coordinator ’location’ and at the (<luname>) of the partner.
participant ’location’ of the problem.
oldourname
Correcting the damage at the participant is not an easy The log name for this DB2 subsystem. This
task. Since the time of the heuristic action, the data that value is null if the partner did not initiate the
was committed using manual means might have been log name exchange.
used by many applications - read and/or write.
Correcting the damage might involve reversing the newourname
effects of these applications as well. This information is The log name for this DB2 subsystem, as
available at DB2 and might be helpful in correcting the remembered by our partner and sent to us in
problem.
328 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL411E
the attempted warm start connection. This If this cannot be done, then there are two other possible
value is null if the partner did not initiate the solutions:
log name exchange. v Have the partner ’location’ perform a cold start
oldtheirname connection with this DB2 subsystem.
The log name used by the partner during the v Use the RESET INDOUBT command with the
last connection, as remembered by DB2. FORCE option in conjunction with the LOCATION
parameter to cause the next connection with the
newtheirname
partner to be a cold start connection.
The log name used by the partner in the
attempted warm start connection.
DSNL411E COLD START CONNECTION BY
oldpa The sync point protocol used during the last
COORDINATOR location ACCEPTED.
connection, as remembered by the DB2 (PA -
INDOUBT THREADS NEED MANUAL
Presumed Abort, PN - Presumed Nothing).
RESOLUTION. INFORMATION
newpa The sync point protocol used during the last RECORDED IN TRACE RECORD WITH
connection, as remembered by the partner (PA IFCID=204 AND IFCID SEQUENCE
- Presumed Abort, PN - Presumed Nothing). NUMBER=seq-no
oldfb The use of the PS header byte 2 during the Explanation: DB2 has participant responsibility for
last connection, as remembered by DB2 (F - indoubt threads. The coordinator informed DB2 that it
used as flag byte, N - not used as flag byte). performed a cold start operation and lost all knowledge
of indoubt threads. The indoubt threads at this DB2
newfb The use of the PS header byte 2 during the must be manually resolved with the RECOVER
last connection, as remembered by the partner INDOUBT command.
(F - used as flag byte, N - not used as flag
byte). location
The field contains one of the following:
oldccls
Whether the luname of the conversation v The relational database name (location
correlator was exchanged as part of the sync name)
point protocol during the last connection, as v The VTAM LU name (<luname>)
remembered by DB2. (E - was exchanged, N - v The dotted decimal IP address
was not exchanged). (nnn.nnn.nnn.nnn).
newccls seq-no The IFCID sequence number associated with
Whether the luname of the conversation the trace record. The sequence number is
correlator was exchanged as part of the sync printed in hexadecimal format. If the sequence
point protocol during the last connection, as number is zero, then IFCID 204 was not active
remembered by the partner (E - was or it was active with a destination of the
exchanged, N - was not exchanged). resident trace table only. IFCID 204 is a
seq-no The IFCID sequence number associated with member of statistics class 4, which has a
the trace record. The sequence number is default destination of SMF.
printed in hexadecimal format. If the sequence System Action: The connection with the partner is
number is zero, then IFCID 0205 was not accepted. Alert A001 is generated. A trace record whose
active or it was active with a destination of the IFCID=204 is written.
resident trace table only. IFCID 0205 is a
member of statistics class 4, which has a System Programmer Response: Call the database
default destination of SMF. administrator.
System Action: The connection with the partner is Database Administrator Action: DB2 is a participant
rejected. Alert A002 is generated. DB2 retains indoubt with one or more indoubt threads where the coordinator
knowledge. is ’location’. The DBMS at ’location’ performed a cold
start. The DB2 participant assumes that the coordinator
System Programmer Response: Call the database recovery log was lost or damaged and indoubt thread
administrator. resolution cannot be achieved. There is probably
Database Administrator Action: Contact the database inconsistent data at the coordinator. A list of indoubt
administrator at the partner ’location’ and determine if it threads involving the coordinator ’location’ can be
is possible for the partner to perform a warm start with displayed using the DISPLAY THREAD command for
same sync point parameters as ours (’oldourname’, indoubt type threads by including the
’oldtheirname’, ’oldpa’, ’oldfb’, ’oldccls’). If this is LOCATION(’location’) parameter in the command.
possible, the next attempt to connect will succeed. The heuristic decision (that is, to commit or abort the
logical unit of work) should be coordinated with any
Chapter 12. DB2 Messages 329
DSNL412I
other participants. The existence of other participants luwid=token
might not be easy to determine. The information might The global logical unit of work id and the local
be available in the coordinators recovery log even token that identify the thread.
though the coordinator performed a cold start. If the
seq-no The IFCID sequence number associated with
coordinator is a DB2, then it might be possible to
the trace record. The sequence number is
execute the DSN1LOGP utility to produce a summary
printed in hexadecimal format. If the sequence
report. If this is possible, the following information might
number is zero, IFCID 208 was not active or it
be produced:
was active with a destination of the resident
v The LUWID of the thread. trace table only. IFCID 208 is a member of
v The NID used by IMS or CICS to identify the thread. statistics class 4, which has a default
v The name of all participants. destination of SMF.
v The name of an upstream coordinator if the
If the protocol error was detected before the commit
coordinator is also a participant. This could happen
decision, the unit of work at the DB2 system might be
when an application requester accesses a DB2 AS
indoubt. DB2 does not automatically resolve such an
using application-directed access, which in turn
indoubt thread.
accesses another DB2 server with system-directed
access. (The local DB2 might be the third system in
this scenario.) If the protocol error was detected after the commit
decision, the unit of work either completed commit or
abort processing.
At this DB2 participant, all indoubt threads coordinated
by the cold starting location must be resolved with the System Action: Alert A005 is generated. A trace
RECOVER INDOUBT command. Locked data remains record whose IFCID=208 is written.
unavailable until resolution. Threads that were already
resolved with this command are discarded. Threads not System Programmer Response: This is an
yet resolved are discarded after resolution with the APARable error, probably at the coordinator, but
command. possibly at DB2. The DB2 documentation required is
contained in the statistics class 4 trace record.
Determine the destination of statistics class 4. Locate
The commit or abort decision provided using the
and print the trace record with SEQUENCE
RECOVER INDOUBT command for a logical unit of
NUMBER=’seq-no’.
work are propagated to all downstream participants, if
any. The database administrator might need to manually
resolve the indoubt thread.
DSNL412I PROTOCOL ERROR DETECTED IN Database Administrator Action: Determine if the
SYNCPOINT REQUEST/RESPONSE ’luwid’ is indoubt by using the DISPLAY THREAD
FROM COORDINATOR location command for type indoubt threads and including the
LUWID=luwid=token. INFORMATION LUWID(’token’) parameter in the command. If the thread
RECORDED IN TRACE RECORD WITH is indoubt, it must be manually resolved using the
IFCID=208 AND IFCID SEQUENCE RECOVER INDOUBT command. The commit or abort
NUMBER=seq-no decision made at the coordinator must be determined
so that the same decision can be made at DB2.
Explanation: DB2 is a participant in the logical unit of
work identified by ’luwid=token’. A protocol error Contact the database administrator at the coordinator
occurred during the SNA sync point exchange with the location to determine whether the thread with
coordinator identified by ’location’. The protocol error fits LUWID=luwid committed or aborted.
into one of the following categories:
If the coordinator system is another DB2, then the
v An unknown SNA PS header was received. following steps can be taken at the DB2 coordinator to
v An SNA PS header was received in the wrong determine the commit or abort decision.
sequence. 1. If the coordinator DB2 system is running and a DB2
v An invalid LU6.2 verb sequence was used to deliver conditional restart was not performed since the error
the SNA PS header. was detected at this (the participant) location, ask
v A DEALLOCATE TYPE(ABEND_SVC) was received the database administrator at the DB2 coordinator
from the coordinator, indicating that the coordinator location to issue one of the following DISPLAY
detected a protocol violation in the PS headers THREAD TYPE(INDOUBT) commands:
transmitted by DB2. v A -DISPLAY THREAD TYPE(INDOUBT), using
the LOCATION keyword and specifying the
location
location name of the local DB2.
Either the relational database name
(location-name) or the logical unit name v A -DISPLAY THREAD TYPE(INDOUBT)
(<luname>) of the coordinator. LUWID(luwid)
330 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL413I • DSNL414E
If a thread with LUWID=luwid appears in the display, System Action: Alert A005 is generated. A trace
then the display also includes the commit or abort record whose IFCID=208 is written.
decision. If no thread with LUWID=luwid appears in
System Programmer Response: This is an
the display, then the thread was aborted.
APARable error, probably at the participant, but possibly
2. If the DB2 coordinator is down or if a conditional at the DB2 coordinator. The DB2 documentation
restart was performed there, ask the database required is contained in the statistics class 4 trace
administrator at the DB2 coordinator to run record. Determine the destination of statistics class 4.
DSN1LOGP, specifying SUMMARY(ONLY) FILTER Locate and print the trace record with SEQUENCE
LUWID(luwid). The output from DSN1LOGP NUMBER=’seq-no’.
includes the commit or abort decision.
Call the database administrator. The participant might
need to manually resolve the indoubt thread.
DSNL413I PROTOCOL ERROR DETECTED IN
SYNCPOINT REQUEST/RESPONSE Database Administrator Action: The DB2 coordinator
FROM PARTICIPANT location does not know the status of the thread at the
LUWID=luwid=token. INFORMATION participant. The DB2 coordinator assumes that it is
RECORDED IN TRACE RECORD WITH indoubt and maintains knowledge of the indoubt
IFCID=208 AND IFCID SEQUENCE participant until it is purged with the RESET INDOUBT
NUMBER=seq-no command. If the thread is indoubt at the participant, it
must be resolved using manual (heuristic) means. The
Explanation: DB2 is the coordinator of the logical unit status of the thread at the local DB2 (the coordinator)
of work identified by ’luwid=token’. A protocol error can be determined with the DISPLAY THREAD
occurred during the SNA sync point exchange with the command for type indoubt threads by including the
participant identified by ’location’. The protocol error fits LUWID(’token’) parameter in the command.
into one of the following categories:
If the ’participant’ location is also a DB2, the RECOVER
v An unknown SNA PS header was received.
INDOUBT command can be used at the participant to
v An SNA PS header was received in the wrong resolve the indoubt thread.
sequence.
v An invalid LU6.2 verb sequence was used to deliver
DSNL414E PROTOCOL ERROR DURING INDOUBT
the SNA PS header.
THREAD RESOLUTION WITH
v A DEALLOCATE TYPE(ABEND_SVC) was received PARTICIPANT location
from the participant, indicating that the participant LUWID=luwid=token INFORMATION
detected a protocol violation in the PS headers RECORDED IN TRACE RECORD WITH
transmitted by DB2. IFCID=206 AND IFCID SEQUENCE
location NUMBER=seq-no
The relational database name (location-name) Explanation: DB2 has coordinator responsibility for
of the participant. the logical unit of work identified by ’luwid=token’. The
luwid=token DB2 thread associated with the logical unit of work is
The global logical unit of work id and the local either committed or aborted. A protocol error occurred
token that identify the thread. during indoubt resolution with the participant identified
by ’location’.
seq-no The IFCID sequence number associated with
the trace record. The sequence number is The thread at the participant remains indoubt. DB2
printed in hexadecimal format. If the sequence rejects further attempts to automatically resolve the
number is zero, IFCID 208 was not active or it indoubt thread.
was active with a destination of the resident location
trace table only. IFCID 208 is a member of The relational database name (location-name)
statistics class 4, which has a default of the participant.
destination of SMF.
luwid=token
If the protocol error is detected before the commit The global logical unit of work id and the local
decision, the unit of work is backed out. token that identify the thread.
seq-no The IFCID sequence number associated with
If the protocol error is detected after the commit the trace record. The sequence number is
decision, the outcome of the unit of work is unchanged. printed in hexadecimal format. If the sequence
In this case, the remote participant might be indoubt. number is zero, IFCID 206 was not active or it
DB2 does not automatically resolve the indoubt thread was active with a destination of the resident
with the partner 'location' after a protocol error is trace table only. IFCID 206 is a member of
detected. statistics class 4, which has a default
destination of SMF.
Chapter 12. DB2 Messages 331
DSNL415I • DSNL417E
System Action: Alert A003 is generated. A trace location
record whose IFCID=206 is written. Either the relational database name
(location-name) or the logical unit name
System Programmer Response: This is an
(<luname>) of the partner.
APARable error, probably at the participant, but possibly
at the DB2 coordinator. The DB2 documentation System Action: The connection was not made.
required is contained in the statistics class 4 trace
System Programmer Response: Call the database
record. Determine the destination of statistics class 4.
administrator.
Locate and print the trace record with SEQUENCE
NUMBER=’seq-no’. Database Administrator Action: DB2 is not able to
connect the partner ’location’ until the partner ’location’
Call the database administrator. The participant might
allows a cold-start connection with DB2. Contact the
need to manually resolve the indoubt thread.
database administrator at the partner ’location’.
Database Administrator Action: The DB2 coordinator
Contact your IBM Support Center for further assistance.
maintains knowledge of the indoubt participant until it is
purged with the RESET INDOUBT command. If the
thread is indoubt at the participant, it must be manually DSNL417E csect-name COLD START DETECTED
(heuristically) resolved. The status of the thread at the AT COORDINATOR LOCATION location
local DB2 (the coordinator) can be determined with the FOR INDOUBT THREAD WITH
DISPLAY THREAD command for type indoubt threads luwid=token. MANUAL RESOLUTION IS
by including the LUWID(’token’) parameter in the REQUIRED. INFORMATION RECORDED
command. IN TRACE RECORD WITH IFCID=204
and IFC SEQUENCE NUMBER=seq-no.
If the participant is another DB2, the RECOVER
INDOUBT command can be used to resolve the indoubt Explanation: DB2 has resync responsibility for the
thread. indoubt thread identified. The partner location informed
DB2 that it had performed a cold start operation and
lost all knowledge of this indoubt thread. This indoubt
DSNL415I AUTOMATIC RESOLUTION OF
thread must be manually resolved with the RECOVER
luwid=token WITH COORDINATOR
INDOUBT command, followed by the RESET INDOUBT
location RESULTED IN ABORT
command.
Explanation: The identified indoubt logical unit of work
location
was automatically resolved by communication with the
The field contains one of the following:
coordinator location. After automatic resolution, this
message is issued if message DSNL405 was previously v The relational database name (location
issued to report the thread as indoubt. This message is name)
not issued if message DSNL405 occurs in one restart of v The VTAM LU name (<luname>)
DDF or DB2, and automatic resolution occurs in a v The dotted decimal IP address
different restart of DDF or DB2. (nnn.nnn.nnn.nnn).
luwid=token luwid=token
The global logical unit of work id and the local The logical unit of work id and the local token
token that identify the thread that identify the thread.
location seq-no The IFCID sequence number associated with
The field contains one of the following: the trace record. The sequence number is
v The relational database name (location printed in hexadecimal format. If the sequence
name) number is zero, then IFCID 204 was not active
v The VTAM LU name (<luname>) or it was active with a destination of the
resident trace table only. IFCID 204 is a
v The dotted decimal IP address
member of statistics class 4, which has a
(nnn.nnn.nnn.nnn).
default destination of SMF and contains
System Action: Processing continues normally. information about a partner’s cold start.
System Action: Alert A001 is generated. A trace
DSNL416I COLD START CONNECTION record whose IFCID=204 is written.
REJECTED BY PARTNER location
System Programmer Response: Call the database
Explanation: DB2 attempted to make a cold-start administrator.
connection with a partner location. The partner rejected
Database Administrator Action: DB2 is a participant
this attempted connection. DB2 never rejects cold-start
with one or more indoubt threads where the coordinator
connections by partners.
is ’location’. The DBMS at ’location’ performed a cold
start. The DB2 participant assumes that the coordinator
332 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL418E • DSNL419I
recovery log was lost or damaged and indoubt thread v The VTAM LU name (<luname>)
resolution cannot be achieved. There may be v The dotted decimal IP address
inconsistent data at the coordinator. A list of indoubt (nnn.nnn.nnn.nnn).
threads involving the coordinator ’location’ can be
displayed using the DISPLAY THREAD command for luwid=token
indoubt type threads by including the The global logical unit of work id and the local
LOCATION(’location’) parameter in the command. token that identify the thread.
The heuristic decision (that is, to commit or abort the seq-no The IFCID sequence number associated with
logical unit of work) should be coordinated with any the trace record. The sequence number is
other participants. The existence of other participants printed in hexadecimal format. If the sequence
might not be easy to determine. The information might number is zero, then IFCID 204 was not active
be available in the coordinators recovery log even or it was active with a destination of the
though the coordinator performed a cold start. If the resident trace table only. IFCID 204 is a
coordinator is a DB2, then it might be possible to member of statistics class 4, which has a
execute the DSN1LOGP utility to produce a summary default destination of SMF.
report. If this is possible, the following information might System Action: Alert A001 is generated. A trace
be produced: record whose IFCID=204 is written.
v The LUWID of the thread.
System Programmer Response: Call the database
v The NID used by IMS or CICS to identify the thread. administrator.
v The name of all participants.
Database Administrator Action: DB2 is the
v The name of an upstream coordinator if the coordinator with indoubt thread resolution responsibility
coordinator is also a participant. This could happen for one or more indoubt logical units of work at
when an application requester accesses a DB2 AS ’location’. The DBMS at ’location’ performed a cold start.
using application-directed access, which in turn DB2 assumes that the participant recovery log was lost
accesses another DB2 server with system-directed or damaged and indoubt thread resolution cannot be
access. (The local DB2 might be the third system in achieved. There is probably inconsistent data at the
this scenario.) participant. Minimally, the participant might not
completely reflect the final outcome of the threads that
At this DB2 participant, all indoubt threads coordinated were indoubt at the time the failure occurred. A list of
by the cold starting location must be resolved with the indoubt threads involving the partner ’location’ can be
RECOVER INDOUBT command. Locked data remains displayed using the DISPLAY THREAD command for
unavailable until resolution. Threads that were already type indoubt threads by including the
resolved with this command are discarded. Threads not LOCATION(’location) parameter in the command.
yet resolved are discarded after resolution with the
command. Information about the indoubt participant continues to
appear in the DISPLAY THREAD TYPE(INDOUBT)
The commit or abort decision provided using the report until it is purged with the RESET INDOUBT
RECOVER INDOUBT command for a logical unit of command.
work are propagated to all downstream participants, if
any. DSNL419I PARTNER location HAS RESOLVED
WARM START STATUS AND
DSNL418E csect-name COLD START DETECTED CONNECTION IS ACCEPTED
AT PARTICIPANT LOCATION location Explanation: A successful warm start connection was
FOR INDOUBT THREAD WITH made with a partner. A previous attempt to make a
luwid=token. POSSIBLE DAMAGE. warm start connection with the partner was rejected with
INFORMATION RECORDED IN TRACE a DSNL410I message because the partner specified an
RECORD WITH IFCID=204 and IFC incorrect log name.
SEQUENCE NUMBER=seq-no.
location
Explanation: DB2 has coordinator responsibility for Either the relational database name
the indoubt thread identified. The partner location (location-name) or the logical unit name
informed DB2 that it had performed a cold start (<luname>) of the partner
operation and lost all knowledge of this indoubt thread.
There might be damage at the participant. System Action: The connection was successful.
Normal processing continues.
location
The field contains one of the following:
v The relational database name (location
name)
Chapter 12. DB2 Messages 333
DSNL420I • DSNL422I
DSNL420I COLD START CONNECTION BY DSNL421I SNA XLN PROTOCOL VIOLATION BY
PARTICIPANT location ACCEPTED. PARTNER location. INFORMATION
POSSIBLE DAMAGE. INFORMATION RECORDED IN TRACE RECORD WITH
RECORDED IN TRACE RECORD WITH IFCID=0236 AND IFCID SEQUENCE
IFCID=204 AND IFCID SEQUENCE NUMBER=seq-no
NUMBER=seq-no
Explanation: DB2 detected a protocol violation in the
Explanation: DB2 has coordinator responsibility for SNA Exchange Log Names (XLN) exchange with the
indoubt threads at a participant and just connected with partner at the specified location.
the participant, which lost all knowledge of indoubt
location
threads because of a previous cold start. There might
Either the relational database name
be damage at the participant.
(location-name) or the logical unit name
location (<luname>) of the partner that sent the invalid
The field contains one of the following: XLN message.
v The relational database name (location seq-no The IFCID sequence number associated with
name) the trace record. The sequence number is
v The VTAM LU name (<luname>) printed in hexadecimal format. If the sequence
v The dotted decimal IP address number is zero, then IFCID 0236 was not
(nnn.nnn.nnn.nnn). active or it was active with a destination of the
resident trace table only. IFCID 0236 is a
seq-no The IFCID sequence number associated with member of statistics class 4, which has a
the trace record. The sequence number is default destination of SMF.
printed in hexadecimal format. If the sequence
number is zero, then IFCID 204 was not active System Action: The attempt to connect with the
or it was active with a destination of the remote site fails. DB2 writes a trace record with IFCID
resident trace table only. IFCID 204 is a 0236.
member of statistics class 4, which has a Operator Response: Call the system programmer.
default destination of SMF.
System Programmer Response: Contact the system
System Action: The connection with the partner is programmer for the remote site. The invalid XLN
accepted. Alert A001 is generated. A trace record whose message is recorded in the IFCID 0236 trace record.
IFCID=204 is written. The system logic error that causes the invalid XLN
System Programmer Response: Call the database message must be corrected at the remote site.
administrator.
Database Administrator Action: DB2 is the DSNL422I WARM START CONNECTION BY
coordinator with indoubt thread resolution responsibility PARTNER location REJECTED
for one or more indoubt logical units of work at BECAUSE THE PARTNER
’location’. The DBMS at ’location’ performed a cold start. REMEMBERS OUR LOG NAME
DB2 assumes that the participant recovery log was lost INCORRECTLY. OUR LOG NAME IS
or damaged and indoubt thread resolution cannot be name1 AND THE PARTNER
achieved. There is probably inconsistent data at the REMEMBERS IT AS name2
participant. Minimally, the participant might not Explanation: An attempt to make a warm start
completely reflect the final outcome of the threads that connection with a partner was rejected because the
were indoubt at the time the failure occurred. A list of partner specified our log name as name2. Our log name
indoubt threads involving the partner ’location’ can be is name1, which is the LUNAME of the local DB2. This
displayed using the DISPLAY THREAD command for error might be a recoverable error if the partner can
type indoubt threads by including the restart with our log name as name1. If this is not
LOCATION(’location) parameter in the command. possible, then the partner must perform a cold start
Information about the indoubt participant continues to connection with DB2.
appear in the DISPLAY THREAD TYPE(INDOUBT) location
report until it is purged with the RESET INDOUBT The ’location’ with which the connection failed:
command. either the relational database name
(location-name) or the logical unit name
(<luname>) of the partner.
name1 Our log name, as remembered by us.
name2 Our log name, as remembered by our partner
and sent to us in the attempted warm start
connection.
334 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL423I • DSNL425I
System Action: The connection with the partner is luwid=token
rejected. DB2 retains indoubt knowledge. The global logical unit of work id and the local
token that identify the thread
System Programmer Response: Call the database
administrator. location
The field contains one of the following:
Database Administrator Action: Contact the database
administrator at the partner ’location’ and determine if it v The relational database name (location
is possible for the partner to perform a warm start with name)
our log name specified as the LUNAME of this DB2. If v The VTAM LU name (<luname>)
this is possible, the next attempt to connect will v The dotted decimal IP address
succeed. (nnn.nnn.nnn.nnn).
If this cannot be done, then there are two other possible System Action: Processing continues normally.
solutions.
v Have the partner ’location’ perform a cold start
DSNL425I THREAD luwid=token AT PARTICIPANT
connection with this DB2 subsystem.
location MAY BE INDOUBT BECAUSE
v Use the RESET INDOUBT command with the OF A COMMUNICATION FAILURE. DB2
FORCE option in conjunction with the LOCATION ABORTED THE THREAD.
parameter to cause the next connection with the INFORMATION RECORDED IN TRACE
partner to be a cold start connection. RECORD WITH IFCID=209 AND IFCID
SEQUENCE NUMBER=seq-no
DSNL423I AUTOMATIC RESOLUTION OF Explanation: During execution of the two phase
luwid=token WITH PARTICIPANT location commit protocol with the participant identified by
RESULTED IN COMMIT ’location’, communications failed. Phase 1 of the
Explanation: The identified indoubt logical unit of work protocol completed with the participant and it is
was automatically resolved through communication with prepared for either commit or abort. The decision to
the participant location. After automatic resolution, this abort the thread was made, but cannot be
message is issued if message DSNL406 was previously communicated to the participant at this time. The
issued reporting the thread as indoubt. This message is participant is indoubt.
not issued if message DSNL406 occurs in one restart of DB2 becomes responsible for indoubt resolution with
DDF or DB2, and automatic resolution occurs in a the participant. This responsibility appears in a
different restart of DDF or DB2. DISPLAY THREAD TYPE (INDOUBT) report. Periodic
luwid=token attempts are made to reestablish communication with
The global logical unit of work id and the local the participant for automatic indoubt resolution. If
token that identify the thread. successful, message DSNL424 is written.
location luwid=token
The field contains one of the following: The global logical unit of work id and the local
token that identify the thread.
v The relational database name (location
name) location
v The VTAM LU name (<luname>) The field contains one of the following:
v The dotted decimal IP address v The relational database name (location
(nnn.nnn.nnn.nnn). name)
v The VTAM LU name (<luname>)
System Action: Processing continues normally.
v The dotted decimal IP address
(nnn.nnn.nnn.nnn).
DSNL424I AUTOMATIC RESOLUTION OF
luwid=token WITH PARTICIPANT location seq-no The IFCID sequence number associated with
RESULTED IN ABORT the trace record. The sequence number is
printed in hexadecimal format. If the sequence
Explanation: The identified indoubt logical unit of work number is zero, IFCID 209 was not active or it
was automatically resolved by communication with the was active with a destination of the resident
participant location. After automatic resolution, this trace table only. IFCID 209 is a member of
message is issued if message DSNL425 was previously statistics class 4, which has a default
issued reporting the thread as being indoubt. This destination of SMF.
message is not issued if message DSNL425 occurs in
one restart of DDF or DB2, and automatic resolution System Action: Alert A006 is generated. A trace
occurs in a different restart of DDF or DB2. record whose IFCID=209 is written.
Operator Response: If message DSNL424 for the
Chapter 12. DB2 Messages 335
DSNL429I • DSNL433I
LUWID specified in message DSNL406 does not appear
DSNL432I DDF IS COORDINATOR FOR nnnn
in a reasonable amount of time, call the system
THREADS WITH mmmm INDOUBT
programmer.
REMOTE PARTNERS
System Programmer Response: Determine the
Explanation: This message is issued when DDF is
cause of the communication failure and have the
started or stopped, if DDF determines that this DB2 has
problem fixed. DB2 periodically attempts to reestablish
coordinator responsibility for one or more indoubt
communication. If the problem cannot be fixed in a
threads with one or more partners. This is a summary
reasonable amount of time, call the database
status message.
administrator. The participant might need to resolve the
indoubt state manually in order to release locked nnnn The number of indoubt threads for which DB2
resources. is the coordinator
Database Administrator Action: If the unit of work with mmmm
LUWID=luwid is indoubt at ’location’, inform the The number of remote partners where the
database administrator there that the logical unit of work threads are indoubt
with LUWID=luwid was aborted to assist in manual
System Action: Processing continues normally.
resolution of the indoubt thread at ’location’.
Operator Response: If the message was issued as a
result of DDF starting, no action is necessary. If the
DSNL429I INCONSISTENT DDF LOG DATA, THE
message was issued as a result of DDF stopping,
FIRST CONNECTION WITH EACH
contact the database administrator.
REMOTE LOCATION WILL BE A COLD
START CONNECTION Database Administrator Action: If the message was
issued as a result of stopping DDF, then DB2
Explanation: DB2 detected an inconsistency in the
maintained all information necessary to perform
DB2 log during restart operations. Since the log is
automatic resynchronization with partner locations and
inconsistent and cannot be trusted, DB2 performs a cold
resolve all indoubt units of work. Issue the START DDF
start connection with each partner LU the next time a
command to initiate this process.
connection with that LU is attempted. If DB2 has
indoubt resolution responsibility either as a coordinator If the message was issued as a result of starting DDF,
or as a participant, then this information is lost as then DDF started automatic resynchronization.
indicated by messages DSNL438 and/or DSNL439,
which might follow this message. This means that:
DSNL433I DDF IS PARTICIPANT FOR nnnn
v All information that DB2 maintained about having INDOUBT THREADS WITH mmmm
coordinator responsibility for remote participants was REMOTE PARTNERS
purged. These remote participants need manual
resolution for any indoubt threads for which DB2 was Explanation: This message is issued when DDF is
the coordinator. A DSNL439I message is displayed started or stopped, if DDF determines that this DB2 has
for each indoubt remote participant. participant responsibility for one or more indoubt threads
v All information that DB2 maintained about having with one or more partners. This is a summary status
participant responsibility for remote coordinators was message.
purged. A DSNL438I message is displayed for each nnnn The number of indoubt threads for which DB2
database access thread that has a remote is the participant
coordinator. If a database access thread remains
indoubt at the end of restart, then the thread must be mmmm
manually resolved. A -DISPLAY THREAD (*) The number of remote partners that have
TYPE(INDOUBT) LOCATION (*) command provides coordinator responsibility
a report that lists the indoubt threads that need System Action: Processing continues normally.
manual resolution.
Operator Response: If the message was issued as a
System Action: Processing continues normally. result of DDF starting, no action is necessary. If the
System Programmer Response: Call the database message was issued as a result of DDF stopping,
administrator. contact the database administrator.
Database Administrator Action: See the DSNL438I Database Administrator Action: If the message was
and DSNL439I messages to determine what action to issued as a result of stopping DDF, then DB2
take. maintained all information necessary to perform
automatic resynchronization with partner locations and
resolve all indoubt units of work. Issue the START DDF
command to initiate this process.
If you do not want to perform automatic
336 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL434E • DSNL438I
resynchronization, you can still resolve the indoubt units v The relational database name (location
of work for which DB2 is a participant and which hold name)
database resources locked. Use the DISPLAY THREAD v The VTAM LU name (<luname>)
command for type indoubt threads to produce a display
v The dotted decimal IP address
that lists these threads. Then use the RECOVER
(nnn.nnn.nnn.nnn).
INDOUBT command to either commit or abort these
units of work. luwid The global logical unit of work id that identifies
the logical unit of work.
To avoid data inconsistency, coordinate this manual
resolution with the database administrators at the urid The unit of recovery identifier. This is the RBA
locations that have coordinator responsibility for each on the DB2 recovery log of the log record that
indoubt unit of work. If any of the indoubt units of work marks the beginning of the logical unit of work.
at DB2 also have coordinator responsibility for This is the earliest RBA required to process the
participant locations, then you should notify the logical unit of work during restart.
database administrators at the participant locations of
the commit or abort decision so they can make the s Restart status of the logical unit of work. When
same decision. DB2 came down, the logical unit of work was
in one of these states:
DSNL434E DDF NOT STARTED - INCORRECT A INABORT: The logical unit of work
VTAM RELEASE LEVEL was in the “must-complete” phase of
abort, but abort has not yet
Explanation: The local VTAM release level is older completed.
than the minimum release level required by DB2. When
DB2 issues the VTAM OPEN macro, the VTAM release C INCOMMIT: The logical unit of work
level is returned to DB2. DB2 examines the VTAM was in the “must-complete” phase of
release level to determine whether the local VTAM commit, but commit has not yet
system provides the function required by DB2. completed.
System Action: The attempt to START DDF fails. D INDOUBT: The logical unit of work
completed the first phase of commit,
Operator Response: Call the system programmer. but DB2 has not yet received the
commit or abort decision from the
System Programmer Response: Install a release of
coordinator.
VTAM that is compatible with the DB2 system. The DB2
Program Directory identifies the required VTAM release F INFLIGHT: The logical unit of work
level. has not yet completed the first phase
of commit and should be backed out.
DSNL438I RESYNC STATUS PURGED FOR U UNKNOWN: The status of the logical
COORDINATOR location. LUWID=luwid, unit of work is not known to DB2
URID=urid, STATUS=s INFORMATION because of conditional restart.
RECORDED IN TRACE RECORD WITH
IFCID=235 and IFCID SEQUENCE seq-no The IFCID sequence number associated with
NUMBER=seq-no the trace record. The trace record is written to
statistics class 4, which is started to SMF as a
Explanation: The information related to default during DB2 installation. Statistics class
resynchronization with the remote coordinator location 4 must be started to a permanent destination
for the logical unit of work identified by ’luwid’, which is (SMF or GTF) for the trace record to be
displayed in this message, is being purged by DB2. accessible. The sequence number is printed in
Automatic indoubt resolution responsibility for this hexadecimal.
distributed logical unit of work can no longer be
performed. System Action: Processing continues normally.
This situation can arise in one of two ways; System Programmer Response: Call the database
v A DB2 conditional restart (other than a DB2 cold administrator.
start; that is, a DB2 conditional restart with Database Administrator Action: The resynchronization
STARTRBA=ENDRBA) is being performed. information that was purged by DB2 is recorded in this
v An inconsistency in the DB2 log was detected during message. To determine the proper commit or abort
DB2 restart processing (indicated by a DSNL429I decision made by the coordinator at ’location’, use the
message). status code as follows:
location A The correct decision is to abort the logical unit
The field contains one of the following: of work.
Chapter 12. DB2 Messages 337
DSNL439I • DSNL440I
C The correct decision is to commit the logical D INDOUBT: The logical unit of work
unit of work. completed the first phase of commit,
but DB2 has not yet received the
D Contact the database administrator at ’location’
commit or abort decision from the
to determine the correct decision.
coordinator.
F The correct decision is to abort the logical unit
F INFLIGHT: The logical unit of work
of work.
has not yet completed the first phase
U Contact the database administrator at ’location’ of commit and should be backed out.
to determine the correct decision.
U UNKNOWN: The status of the logical
unit of work is not known to DB2
DSNL439I RESYNC STATUS PURGED FOR because of conditional restart.
PARTICIPANT location. LUWID=luwid,
seq-no The IFCID sequence number associated with
URID=urid, STATUS=s INFORMATION
the trace record. The trace record is written to
RECORDED IN TRACE RECORD WITH
statistics class 4, which is started to SMF as a
IFCID=235 and IFCID SEQUENCE
default during DB2 installation. Statistics class
NUMBER=seq-no
4 must be started to a permanent destination
Explanation: DB2 is purging the information related to (SMF or GTF) for the trace record to be
resynchronization with the remote participant location for accessible. The sequence number is printed in
the logical unit of work identified by ’luwid’, which is hexadecimal.
displayed in this message. Automatic indoubt resolution
System Action: Processing continues normally.
responsibility for this distributed logical unit of work can
no longer be performed. System Programmer Response: Call the database
administrator.
This situation can arise in one of two ways:
v A DB2 conditional restart (other than a DB2 cold Database Administrator Action: The resynchronization
start; that is, a DB2 conditional restart with information that was purged by DB2 is recorded in this
STARTRBA=ENDRBA) is being performed. message. When communicating the proper commit or
abort decision to the database administrator at
v An inconsistency in the DB2 log was detected during
’location’, use the status code as follows:
DB2 restart processing (indicated by a DSNL429I
message). A Abort the logical unit of work.
location C Commit the logical unit of work.
The field contains one of the following:
D See the DSNL438I message produced for the
v The relational database name (location same ’luwid’ and ’urid’ to determine the
name) coordinator ’location’. Contact the database
v The VTAM LU name (<luname>) administrator at ’location’ to determine the
v The dotted decimal IP address correct decision.
(nnn.nnn.nnn.nnn). F Abort the logical unit of work.
luwid The global logical unit of work id that identifies U If there is a DSNL438I message for the same
the logical unit of work. ’luwid’ and ’urid’, proceed as described above
urid The unit of recovery identifier. This is the RBA under ’D’. Otherwise, there might be
on the DB2 recovery log of the log record that information available on the DB2 log that a
marks the beginning of the logical unit of work. DSN1LOGP summary report can provide. If
This is the earliest RBA required to process the this is not successful, contact the IBM Support
logical unit of work during restart. Center.
s Restart status of the logical unit of work. When
DB2 came down, the logical unit of work was DSNL440I csect-name RESET INDOUBT
in one of these states: COMMAND SPECIFICATION IN ERROR
A INABORT: The logical unit of work Explanation: A RESET INDOUBT command was
was in the “must-complete” phase of issued, but the specification of keywords or keyword
abort, but abort has not yet parameter values was in error.
completed. System Action: No indoubt information was purged.
C INCOMMIT: The logical unit of work System processing continues normally.
was in the “must-complete” phase of User Response: One of the following errors was
commit, but commit has not yet made in the RESET INDOUBT command specification:
completed.
338 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL441I • DSNL444I
v RESET INDOUBT was issued without any other TYPE(INDOUBT) command to display all units of work
keywords specified. At least one of the following for which indoubt information exists. Then reissue the
keywords must also be specified: LUNAME, IPADDR, RESET INDOUBT command, specifying the correct
LOCATION, or LUWID. LUWID parameter value.
v RESET INDOUBT was issued with both the LUWID
and LOCATION keywords specified, but a list of DSNL442I QUALIFYING INDOUBT INFORMATION
LOCATION keyword parameter values was specified. FOR LOCATION location NOT FOUND
When both the LUWID and LOCATION keywords are
specified only one LOCATION keyword parameter Explanation: A -RESET INDOUBT
value is allowed. LOCATION(’location’) command was issued, but DB2
has no indoubt information about the specified location.
v RESET INDOUBT was issued with at least one
LOCATION keyword parameter value that began with location
a '<', but did not end with a '>', or the length of the The value specified after the LOCATION
bracketed value was not 1 to 8 characters. When the keyword in the RESET INDOUBT command.
LOCATION keyword parameter value is specified in
the <luname> format, the luname value must be System Action: No indoubt information was purged.
bracketed with '<' and '>' and be 1 to 8 characters System processing continues normally.
long. User Response: Use the -DISPLAY THREAD(*)
v RESET INDOUBT was issued with an invalid TYPE(INDOUBT) LOCATION(*) command to list the
IPADDR keyword parameter value. Verify that the locations for which DB2 has indoubt information. After
specified IPADDRs are in the proper dotted decimal determining the correct location, reissue the command.
form, that there is a colon delimeter between the
IPADDR and port, and that the port number is valid.
DSNL443I QUALIFYING INDOUBT INFORMATION
FOR LUWID=value NOT FOUND
If needed, issue the DISPLAY THREAD
TYPE(INDOUBT) command to display information Explanation: A -RESET INDOUBT LUWID(’value’)
(including LOCATION, LUWID, and LUNAME values) command was issued where ’value’ is either an luwid or
about all indoubt threads. Correct the RESET INDOUBT the local token that represents an luwid. Either DB2 has
command specification, and reissue the command. no indoubt information about the specified luwid or
token, or DB2 has indoubt information that cannot be
purged using the -RESET INDOUBT command with the
DSNL441I KEYWORD ’LUWID’ PARAMETER LUWID option.
VALUE parmvalue FORMAT IN ERROR
value The global logical unit of work id or the local
Explanation: A RESET INDOUBT command with the token that was specified for the LUWID
LUWID parameter was issued, but the specified keyword in the RESET INDOUBT command.
parameter value (parmvalue) has an invalid format for
an LUWID. There are two correct formats for the System Action: No indoubt information was purged.
LUWID parameter. The first correct format is called a System processing continues normally.
token, and is a 1 to 5 digit decimal number. The second
User Response: Use the -DISPLAY THREAD(*)
correct format is ’netid.luname.luwunique.comseq’,
TYPE(INDOUBT) LOCATION(*) command to list the
where:
indoubt information known to DB2. If the -DISPLAY
netid A 1 to 8 character network ID THREAD output does not include information about the
specified luwid, then that is the reason the message
luname was issued. If the -DISPLAY THREAD output does
A 1 to 8 character luname include information about the specified luwid, this
luwunique information cannot be purged using the -RESET
A 12 character hexadecimal number INDOUBT command with the LUWID option. Refer to
the description of each message produced by the
comseq -DISPLAY THREAD output that relates to the specified
A 4 character hexadecimal number luwid in order to determine how to proceed. After
determining the correct luwid or token, reissue the
All fields in the second correct format must be command.
separated by a period (.) delimiter.
System Action: Indoubt information about the DSNL444I QUALIFYING INDOUBT INFORMATION
specified logical unit of work is not purged from the FOR LOCATION location HAS BEEN
system. PURGED
User Response: To determine the correct LUWID Explanation: A -RESET INDOUBT
value for the unit of work indoubt information that you LOCATION(’location’) command issued to purge indoubt
want to purge, issue the DISPLAY THREAD information about the named location completed
Chapter 12. DB2 Messages 339
DSNL445I • DSNL447I
successfully and the indoubt information was purged. LOCATION(value), or LUWID(value). The ’value’ is an
LU name, an IP address, a location, ora LUWID (or its
location
token), that identifies a logical unit of work for which
Either the relational database name
DB2 has participant indoubt resolution responsibility,
(location-name) or the logical unit name
coordinator indoubt resolution responsibility, or both.
(<luname>) that was specified after the
LOCATION keyword on the RESET INDOUBT System Action: Resynchronization responsibility
command. information was not purged. System processing
continues normally.
System Action: The specified indoubt information was
purged. System processing continues normally. User Response: Use the information in this section to
determine the correct action to take. Then issue the
proper command to perform that action.
DSNL445I QUALIFYING INDOUBT INFORMATION
FOR LUWID value HAS BEEN PURGED The two most probable causes for the problem are that
the -RESET INDOUBT command was issued with the
Explanation: A -RESET INDOUBT LUWID(’value’)
wrong parameters, or that an incorrect ’value’ was
command, which was issued to purge indoubt
specified. Use the -DISPLAY THREAD(*)
information about the specified luwid, completed
TYPE(INDOUBT) LOCATION(*) command to display the
successfully. The indoubt information was purged.
indoubt information known to DB2.
value The value specified for the LUWID keyword in 1. If the intent was to purge participant or coordinator
the -RESET INDOUBT LUWID(value) indoubt resolution responsibility, then examine the
command that is being processed. -DISPLAY THREAD output to determine the location
System Action: System processing continues name, or names, for which this responsibility is to be
normally. purged. Then use the -RESET INDOUBT
LUNAME(luname) command with the FORCE option
or the -RESET INDOUBT IPADDR(ipaddr) command
DSNL446I COLD START WILL BE PERFORMED with the FORCE option to purge this responsibility.
WITH nettype netvalue To determine the luname or IP address and resync
Explanation: A -RESET INDOUBT LUNAME(’luname’) port for an upstream coordinator that can be used
FORCE or a -RESET INDOUBT IPADDR(’ipaddr’) with the FORCE option, look at the coordinator
FORCE command issued to force a cold start information from the DSNV408I message in the
completed successfully. The next connection with -DISPLAY THREAD output. There are two tokens
’luname’ or ’ipaddr’ is a cold start. associated with the coordinator information that are
delimited by a colon (″:″).
nettype
v The first token is the partner location name or
Identifies the type of network used to access
″<luname>″ for an SNA connection, or the dotted
the remote site. There are two possible values:
decimal IP address for a TCP/IP connection
LU -- indicates that VTAM is used to (nnn.nnn.nnn.nnn).
connect to the remote site. v The second token is the partner LU name for an
IPADDR -- SNA connection, or the resync port number for a
indicates that TCP/IP is used to TCP/IP connection.
connect to the remote site.
To determine the luname or IP address and resync
netvalue port for downstream participants that can be used
The network address of the remote location. with the FORCE option, look at the location names
v If nettype is LU, netvalue specifies the from the DSNV450I and DSNV446I messages.
VTAM LU name of the remote location. There are two or three tokens associated with the
v If nettype is IPADDR, netvalue specifies the participant location which are delimited by a colon
dotted decimal IP address of the remote (″:″).
location. v The first token is the partner location name.
System Action: System processing continues v The second token is the partner LU name for an
normally. SNA connection, or the dotted decimal IP address
for a TCP/IP connection (nnn.nnn.nnn.nnn).
v The third token only appears if the second token
DSNL447I CANNOT DELETE ENTRY ’value’
is an IP address in which case the third token is
BECAUSE THERE IS AN INDOUBT
the partner resync port number.
THREAD TO BE RESOLVED FIRST
Explanation: A -RESET INDOUBT command was
issued with LUNAME(value), IPADDR(value),
340 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL448I • DSNL450I
See the description of the -RESET INDOUBT System Action: System processing continues
command in DB2 Command Reference for more normally.
information.
User Response: For SNA, you can use the VTAM
command DISPLAY NET to determine the existence of
Remember that the FORCE option causes DB2 to
sessions between two logical units. Terminate the
purge all knowledge of indoubt resolution
sessions by using the VTAM command VARY
responsibility involving the luname or ipaddrspecified
NET,TERM to allow the RESET INDOUBT to occur. For
on the command.
TCP/IP, terminate all connections to the IP
address.Determine the correct luname or ipaddr and
Use caution when using the FORCE parameter to reissue the command.
purge participant indoubt information when no errors
are precluding automatic resolution. Normally, after
the use of the RECOVER INDOUBT command, DSNL449I DB2 HAS NO INFORMATION RELATED
automatic resolution with the coordinator determines TO LUNAME luname
if heuristic damage occurred. This detection is lost if
Explanation: A -RESET INDOUBT LUNAME(’luname’)
RESET INDOUBT is used before automatic
FORCE command was issued but DB2 has no
resolution with the coordinator can be achieved.
knowledge of the specified ’luname’.
Use caution when using the FORCE parameter to luname
purge coordinator indoubt information when no The logical unit name, as defined to VTAM, of
errors are precluding automatic resolution. Once the the coordinator or participant
information is purged, any participant that is indoubt
System Action: No information was purged. System
is forced to use a heuristic decision process to
processing continues normally.
resolve the indoubt logical unit of work.
2. Examine the -DISPLAY THREAD output. If the value User Response: Determine the correct luname as
specified in the command (and displayed in the follows:
DSNL447I message) is incorrect, determine the v Use the -DISPLAY THREAD(*) TYPE(INDOUBT)
correct value and reissue the command using the LOCATION(*) command to determine locations for
correct value. which DB2 has indoubt responsibility.
v Query the SYSIBM.LOCATIONS table to correlate a
DSNL448I UNABLE TO FORCE COLD START location name with an luname. The LINKNAME
WITH nettype netvalue, SESSION STILL column contains the luname associated with the
EXISTS location name in the LOCATION column.
Explanation: A -RESET INDOUBT LUNAME(’luname’) Then reissue the command, specifying the correct
FORCE or a -RESET INDOUBT IPADDR(’ipaddr’) luname.
FORCE command was issued to force a cold start, but
network connections still exist between DB2 and the DSNL450I DDF THREAD luwid=token IS BETWEEN
partner ’luname’ or ’ipaddr’. The information related to PHASE 1 AND PHASE 2 OF COMMIT.
this partner was not purged, so a cold start is not THREAD IS NOW AN INDOUBT
performed. THREAD AS A RESULT OF CANCEL
nettype REQUEST.
Identifies the type of network used to access Explanation: The identified DDF thread was in a
the remote site. There are two possible values: prepared state waiting for the commit or backout
LU -- indicates that VTAM is used to decision of the commit coordinator. The thread cannot
connect to the remote site. be canceled in this state. However, the thread was
removed from the active state and placed into the
IPADDR -- indoubt state. The conversation with the coordinator
indicates that TCP/IP is used to was deallocated. The thread is now indoubt and
connect to the remote site. appears in the display thread report for indoubt threads.
netvalue The resources held by the thread continue to be held.
The network address of the remote location. Automatic resolution of the indoubt state is attempted
periodically. Resources held by the thread are released
v If nettype is LU, netvalue specifies the after indoubt resolution occurs.
VTAM LU name of the remote location.
v If nettype is IPADDR, netvalue specifies the luwid=token
dotted decimal IP address of the remote The global logical unit of work id and the local
location. token that identify the thread
System Action: Processing continues normally.
Chapter 12. DB2 Messages 341
DSNL451I • DSNL455I
Operator Response: If the purpose of canceling this csect The CSECT name of the DB2 module that
thread was to free the resources held by the thread, call issued the message
the database administrator.
ipaddr The dotted decimal IP address of the
Database Administrator Action: To release the coordinator or participant
resources held by the indoubt thread before automatic
System Action: No indoubt information was purged.
resolution with the coordinator, a manual commit or
System processing continues normally.
abort decision can be made with the RECOVER
INDOUBT command. First, issue the DISPLAY THREAD User Response: Use the -DISPLAY THREAD(*)
command for an indoubt thread report, which includes TYPE(INDOUBT) LOCATION(*) command to list the
the subject thread. From this report, determine the locations for which DB2 has indoubt information. Entries
name of the coordinator. Contact the coordinator system associated with TCP/IP have a string with this format in
and find out whether a commit or abort decision was the LOCATION field: ″nnn.nnn.nnn.nnn″.
made.
After determining the correct ipaddr, reissue the
command.
DSNL451I QUALIFYING INDOUBT INFORMATION
FOR LUNAME luname NOT FOUND
DSNL454I csect QUALIFYING INDOUBT
Explanation: A -RESET INDOUBT LUNAME(’luname’) INFORMATION FOR IP ADDRESS ipaddr
command was issued, but DB2 has no indoubt HAS BEEN PURGED
information about the specified luname.
Explanation: A -RESET INDOUBT IPADDR(’ipaddr’)
luname command, which was issued to purge indoubt
The logical unit name, as defined to VTAM, of information about the specified IP address completed
the coordinator or participant successfully. The indoubt information was purged.
System Action: No indoubt information was purged. csect The CSECT name of the DB2 module that
System processing continues normally. issued the message
User Response: Use the -DISPLAY THREAD(*) ipaddr The IP address specified for the IPADDR
TYPE(INDOUBT) LOCATION(*) command to list the keyword in the -RESET INDOUBT
locations for which DB2 has indoubt information. Entries IPADDR(ipaddr) command being processed
associated with a particular LUNAME have a location
name in this form: ’<luname>’. Use ’luname’ (without the System Action: The specified indoubt information was
enclosing brackets) as the input string to RECOVER purged. System processing continues normally.
INDOUBT.
After determining the correct luname, reissue the DSNL455I csect DB2 HAS NO INFORMATION
command. RELATED TO IP ADDRESS ipaddr
Explanation: A -RESET INDOUBT IPADDR(’ipaddr’)
DSNL452I QUALIFYING INDOUBT INFORMATION FORCE command was issued but DB2 has no
FOR LUNAME luname HAS BEEN knowledge of the specified ’ipaddr’.
PURGED csect The CSECT name of the DB2 module that
Explanation: A -RESET INDOUBT LUNAME(’luname’) issued the message.
command, which was issued to purge indoubt ipaddr The dotted decimal TCP/IP address of the
information about the specified luname completed coordinator or participant
successfully. The indoubt information was purged.
System Action: No information was purged. System
luname processing continues normally.
The luname specified for the LUNAME
keyword in the -RESET INDOUBT User Response: Determine the correct luname as
LUNAME(luname) command being processed. follows:
v Use the -DISPLAY THREAD(*) TYPE(INDOUBT)
System Action: The specified indoubt information was
LOCATION(*) command to determine locations for
purged. System processing continues normally.
which DB2 has indoubt responsibility. Entries
associated with TCP/IP locations specify
DSNL453I csect QUALIFYING INDOUBT ″nnn.nnn.nnn.nnn″ in the LOCATION field.
INFORMATION FOR IP ADDRESS ipaddr
Reissue the command; specify the correct ipaddr.
NOT FOUND
Explanation: A -RESET INDOUBT IPADDR(’ipaddr’)
command was issued, but DB2 has no indoubt
information about the specified IP address.
342 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL500I • DSNL502I
that start with 00 represent DB2 reason codes.
DSNL500I CONVERSATION FAILED TO
LOCATION=locname The variables are described as follows:
RESOURCE=luname.modename.
convid.sessid RTNCD=global vtam Variable
primary return code FDBK2=global vtam Description
secondary return code luname
RCPRI=appc-specific primary return code The VTAM LU name associated with the
RCSEC=appc-specific secondary return remote location.
code SENSE=sna sense code
modename
Explanation: An advanced program-to-program The logon mode used by DB2 to allocate the
communications (APPC) conversation failed, or could conversation.
not be allocated, because a VTAM return code indicates
a conversation failure. VTAM return codes are defined System Action: All communication to the remote
in VTAM for MVS/ESA Programming for LU 6.2. location fails until the limits can be negotiated with the
remote location.
SNA sense codes that start with 00 represent DB2
reason codes. Refer to “Part 6. SNA CODES” on Operator Response: Notify the system programmer.
page 1269 for a description of more common SNA System Programmer Response: Refer to VTAM for
sense codes returned to DB2 by VTAM. MVS/ESA Programming for LU 6.2 for failure analysis or
The variables that are not return codes are described as “Part 4. DB2 Codes” on page 707 for information on
follows: reason codes.
Variable
Description DSNL502I SYSTEM CONVERSATION FAILED TO
LOCATION locname
locname RESOURCE=luname.modename.
The location name associated with the remote convid.sessid RTNCD=global vtam
site. primary return code FDBK2=global vtam
luname The VTAM LU name associated with the secondary return code
remote location. RCPRI=appc-specific primary return code
RCSEC=appc-specific secondary return
modename code SENSE=sna sense code
The logon mode used by DB2 to allocate the
conversation. Explanation: A system conversation failed, or could
not be allocated, because VTAM returned a nonzero
convid The conversation identifier given DB2 by VTAM return code. VTAM return codes are defined in VTAM
when the conversation was allocated. for MVS/ESA Programming for LU 6.2.
sessid The session identifier given DB2 by VTAM SNA sense codes that start with 00 represent DB2
when the conversation was allocated. reason codes. Refer to “Part 6. SNA CODES” on
page 1269 for a description of more common SNA
System Action: Communication on the conversation
sense codes returned to DB2 by VTAM.
is discontinued.
The variables are described as follows:
Operator Response: Notify the system programmer.
Variable
System Programmer Response: Refer to VTAM for
Description
MVS/ESA Programming for LU 6.2 for failure analysis or
“Part 4. DB2 Codes” on page 707 for information on locname
reason codes. The location name associated with the remote
site.
DSNL501I CNOS PROCESSING FAILED FOR LU luname The VTAM LU name associated with the
luname AND MODE modename remote location.
RTNCD=global vtam return code
FDBK2=global vtam secondary return modename
code RCPRI=appc-specific primary return The logon mode used by DB2 to allocate the
code RCSEC=appc-specific secondary conversation.
return code SENSE=vtam sense code convid The conversation identifier given DB2 by VTAM
Explanation: A failure occurred while attempting to when the conversation was allocated.
negotiate limits with the specified location for a LU and sessid The session identifier given DB2 by VTAM
mode. VTAM return codes are described in VTAM for when the conversation was allocated.
MVS/ESA Programming for LU 6.2. VTAM sense codes
Chapter 12. DB2 Messages 343
DSNL504I • DSNL512I
System Action: Communication on the conversation
DSNL511I csect TCP/IP CONVERSATION FAILED
is not allowed.
TO LOCATION locname IPADDR=ipaddr
Operator Response: Notify the system programmer. PORT=port SOCKET=socket RETURN
CODE=’rc’X REASON CODE=’reason’X
System Programmer Response: Refer to VTAM for
MVS/ESA Programming for LU 6.2 for failure analysis or Explanation: A TCP/IP socket call failed with the error
“Part 4. DB2 Codes” on page 707 for information on condition identified by rc and reason.
reason codes.
Variable
Description
DSNL504I csect-name RESOURCE UNAVAILABLE
csect The CSECT name of the DB2 module that
REASON=reason TYPE=type
issued the message.
LOCATION=location NAME=name
locname
Explanation: The requested function requires a
The location name associated with the remote
resource that is currently unavailable. The reason code,
site.
type, location, and name identifies the resource.
ipaddr The IP address of the remote site in dotted
Operator Response: Note the reason, type codes,
decimal format.
location, and name.
port The TCP/IP port used by the remote site.
Problem Determination: The reason for the
resource’s unavailability is identified by the reason code. socket The TCP/IP socket call that returned the error.
The reason codes that appear in this message are
rc The error condition reported by TCP/IP. The
described in “Part 4. DB2 Codes” on page 707. Refer to
return code values are documented in OS/390
Table 3 in “Appendix B. Problem determination” on
UNIX System Services Programming:
page 1281 for an explanation of resource type codes.
Assembler Callable Services Reference.
reason Provides further detail associated with the
DSNL510I csect-name CONVLIMIT NEGOTIATED
TCP/IP return code. The reason code values
FROM x TO y WITH LOCATION locname
are documented in OS/390 UNIX System
FOR LU luname AND MODE modename
Services Programming: Assembler Callable
Explanation: The maximum conversation limit is Services Reference.
changed for a mode with a remote subsystem. The limit
System Action: Communication on the conversation
might change when a CNOS request is received from or
is discontinued.
sent to a remote subsystem, and the limit is determined
by VTAM. User Response: Notify the system programmer.
x The most recent value of CONVLIMIT before Operator Response: Notify the system programmer.
the last CNOS request was processed by
advanced program-to-program communications System Programmer Response: Refer to OS/390
(APPC)/VTAM for the specified mode name to UNIX System Services Programming: Assembler
the specified location. Callable Services Reference for an explanation of the
error.
y The current value of CONVLIMIT for the
specified mode name to the specified location. Problem Determination: See System Programmer
Response.
locname
The location name associated with the remote
site that sent the CNOS request to the local DSNL512I csect TCP/IP socket FAILED WITH
DB2 subsystem, or received the CNOS request RETURN CODE='rc'X AND REASON
from the local DB2 subsystem. CODE='reason'X
luname Explanation: A TCP/IP socket call used to establish
The VTAM LU name associated with the communication between DB2 and TCP/IP failed.
remote location that had its CONVLIMIT Variable
changed. Description
modename csect The CSECT name of the DB2 module that
The logon mode for the specified location that issued the message.
had its CONVLIMIT changed.
socket The name of the TCP/IP socket call that failed.
System Action: Conversation requests are queued
when the maximum conversation limit is reached for a rc The return code reported by TCP/IP. The return
mode to remote subsystem. | code values are documented in OS/390 UNIX
344 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL513I
| System Services Programming: Assembler Using this IP address, DB2 issues a GetHostByAddr
| Callable Services Reference. socket call to determine the associated domain
name. The OS/390 Resolver handles the
reason The reason code reported by TCP/IP. The
GetHostByAddr socket call because DB2 uses the
| reason code values are documented in OS/390
OS/390 Open Edition Asynchronous Sockets
| UNIX System Services Programming:
interface. This resolver uses the resolver
| Assembler Callable Services Reference.
configuration information available to DDF. Until this
| System Action: DB2 may periodically retry the socket information for the selected TCP/IP stack is correctly
| call to establish TCP/IP communication. specified for DDF, the OS/390 Resolver will be
unable to determine the domain name for DDF. You
User Response: Notify the system programmer. can find the search order for the ″resolver
Operator Response: Notify the system programmer. configuration files″ for an OS/390 application, such as
DDF, in the IP Configuration manual for the
| System Programmer Response: Refer to OS/390 appropriate level of the Communication Server for
| UNIX System Services Programming: Assembler your OS/390 operating system.
| Callable Services Reference for an explanation of the
error. Problem Determination: See System Programmer
Response.
v If socket=SETRLIMIT and reason code=1148033C,
then you should define DB2 as a superuser. See DB2
Installation Guide for instructions on enabling DDF as DSNL513I csect TCP/IP GETHOSTBYNAME
a superuser. FAILED WITH ERRNO=errno FOR
| v If socket=TCPKEEPALIVE, then DB2 issues this DOMAIN domain
| socket call as a result of the TCP/IP KeepAlive value Explanation: DB2 encountered a TCP/IP
| specified in the DB2 parameters module (usually gethostbyname socket call error when attempting to
| DSNZPARM). You may specify this value by the convert a TCP/IP domain name into an IP address.
| TCP/IP KEEPALIVE value in the DSNTIP5 installation
| panel. Another way to specify the value is through the Variable
| TCPKPALV value in the DSN6FAC macro, used to Description
| build the DB2 parameters module.
csect The CSECT name of the DB2 module that
| In this situation, processing continues, and DB2 does issued the message.
| not retry the socket call. Verify that the TCP/IP stack
| being used by DB2 contains the required companion errno The error condition reported by TCP/IP. The
| support for this function. If not, modify the DB2 errno values are documented in IBM TCP/IP
| parameter module to prevent DB2 from attempting to for MVS: Application Programming Reference.
| override the TCP/IP stack value. domain
v If socket=GETHOSTBYADDR(ip-address), then DB2 The TCP/IP domain name that DB2 wants to
invoked a TCP/IP GetHostByAddr socket call to convert into an IP address. DB2 obtains the
determine the domain name for the specified IP domain value from the IPADDR column of the
address. However, the call failed, and DB2 is not able SYSIBM.IPNAMES communications database
to determine the domain name. DB2 retries the table.
socket call periodically.
System Action: The row in SYSIBM.IPNAMES
During DDF initialization, DB2 first determines the IP containing the specified domain in the IPADDR column
address via a GetHostID socket call. The IP address is invalid. If the error occurs during DDF startup, the row
returned is the first IP address listed in the HOME in SYSIBM.IPNAMES is ignored. If the error occurs
statement of the TCP/IP profile for the selected during an SQL statement, the SQL statement fails and
TCP/IP stack. Verify the IP address. DDF must be the location associated with the SYSIBM.IPNAMES row
stopped and restarted in order for DDF to obtain a is not available for TCP/IP communication.
new IP address.
User Response: Notify the system programmer.
Note: The IP address returned could depend on the Operator Response: Notify the system programmer.
selected TCP/IP stack, in the event that there
are multiple TCP/IP stacks. DB2 requires System Programmer Response: Refer to IBM
OS/390 Open Edition sockets, and it is Open TCP/IP for MVS: Application Programming Reference
Edition that determines the TCP/IP stack to for an explanation of the error. Correct the IPADDR
use. OS/390 Open Edition provides a way for column value in SYSIBM.IPNAMES or register the
users to select a specific TCP/IP stack by domain with TCP/IP.
using the BPXTCAFF utility. For more Problem Determination: See System Programmer
information on BPXTCAFF, see UNIX System Response.
Services Planning, SC28-1890.
Chapter 12. DB2 Messages 345
DSNL514I • DSNL517I
caused by DB2 restarting on a CEC that already has
DSNL514I csect-name TCP/IP SERVICE serv IS
another DB2 subsystem using the DRDA port number.
NOT DEFINED
DB2 will continue to try to activate the TCP/IP port
Explanation: The TCP/IP getservbyname socket call number periodically.
did not find a matching definition for serv.
If this error occurs for the DRDA resynchronization port,
Variable DB2 invokes internal processing that is equivalent to
Description STOP DDF MODE(FORCE).
serv The TCP/IP service name that DB2 wants to User Response: Notify the system programmer.
convert into a TCP/IP port number. DB2
Operator Response: Notify the system programmer.
obtains the service name from the PORT
column of the SYSIBM.LOCATIONS System Programmer Response: Refer to OS/390
communication database table. UNIX System Services Programming: Assembler
Callable Services Reference for an explanation of the
System Action: The row in SYSIBM.LOCATIONS
error.
containing the specified service name in the PORT
column is invalid. The associated LOCATION cannot be Define DB2’s TCP/IP port number to the TCP/IP
used for TCP/IP communication. If the error occurs instance, or use the change log izxentory utility to
during an SQL statement, the SQL statement fails. correct the TCP/IP port number used by DB2.
User Response: Notify the system programmer. Problem Determination: See System Programmer
Response.
Operator Response: Notify the system programmer.
System Programmer Response: If the value
specified by serv is incorrect, correct the PORT column
| DSNL516I csect-name LANGUAGE ENVIRONMENT
SERVICES NOT AVAILABLE. CEEPIPI
value in SYSIBM.LOCATIONS.
ROUTINE CANNOT BE LOADED
If the value specified by serv is correct, register the
Explanation: DB2 must load the Language
service name with TCP/IP.
Environment interface module (CEEPIPI) to process
TCP/IP service names are case sensitive, so make sure | functions requiring Language Environment services.
that the PORT column in SYSIBM.LOCATIONS is an | These Language Environment services are required for
exact match for the service name defined to TCP/IP. | TCP/IP socket calls, encryption and decryption, and so
| on. If the CEEPIPI module is not included in an
Problem Determination: See System Programmer
accessible data set such as STEPLIB data sets or the
Response.
| LPA library, DDF is unable to use the Language
| Environment.
DSNL515I csect TCP/IP BIND FOR PORT port
System Action: DDF startup continues, but DDF
FAILED WITH RETURN CODE=’rc’X
| users cannot use DB2 functions that require Language
AND REASON CODE=’reason’X
| Environment services.
Explanation: DB2 encountered an error on the TCP/IP
System Programmer Response: Add the Language
bind socket call while attempting to register a TCP/IP
Environment library to the DDF STEPLIB concatenation
port number with the TCP/IP instance.
| or to the LPA library. The Language Environment library
Variable must be APF authorized when it appears in the DDF
Description STEPLIB concatenation.
csect The CSECT name of the DB2 module that Problem Determination: Collect the following
issued the message. diagnostic item listed in “Appendix B. Problem
determination” on page 1281: 1.
port The TCP/IP port number DB2 wants to register
with the TCP/IP instance.
DSNL517I csect-name CEEPIPI func SERVICE
rc The return code reported by TCP/IP. The return FAILED WITH RETURN CODE=rc
code values are documented in OS/390 UNIX
System Services Programming: Assembler Explanation: DB2 uses the Language Environment
Callable Services Reference. CEEPIPI service to issue certain TCP/IP socket calls.
The Language Environment return code rc was not
reason The reason code reported by TCP/IP. The expected for the indicated Language Environment
reason code values are documented in OS/390 function call.
UNIX System Services Programming:
Assembler Callable Services Reference. func The function requested by DB2. Possible
values are:
System Action: If this error occurs for the TCP/IP port
used for incoming DRDA requests, the error is probably
346 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL518I • DSNL520I
add_entry(module-name) message identifiers are constructed from the
Add an entry to the Language Language Environment condition token.
Environment PIPI table dynamically.
The message identifiers are constructed as
| Module-name is the name of the
follows:
| module that failed to be added to the
v Single message: Facility_Id combined with
| PIPI table.
Msg_No
call_sub v Two messages: Facility_Id combined with
Run a program that issues a TCP/IP Class_Code and Facility_Id combined with
socket call using an existing Cause_Code
Language Environment run time
System Action: The SQL statement fails with
environment.
SQLCODE -904.
del_sub
System Programmer Response: A description of the
Delete an entry from the Language
Language Environment enclave return code and the
Environment PIPI table dynamically.
condition token are documented in Language
init_sub Environment for OS/390 & VM Programming Guide.
Create Language Environment sub
Problem Determination: Collect the following
run time environment.
diagnostic items listed in “Appendix B. Problem
term Terminate the Language Environment determination” on page 1281: 1. 4.
run time environment.
rc The return code received from CEEPIPI. DSNL519I csect TCP/IP SERVICES AVAILABLE
FOR DOMAIN domainAND PORT tcpport
System Action: The attempt to issue the LE/370
request fails. Explanation: DB2 encountered a TCP/IP failure during
DDF startup processing. The DSNL515I message
If this message is issued during DDF startup, DDF
identifies the cause of the failure. After the failure is
startup continues.
detected, DDF periodically attempts to reinitialize
If this message is issued during an SQL statement, a TCP/IP to allow remote connections. This message is
-904 SQLCODE is returned to the calling application. issued when reinitialization is successful.
| System Programmer Response: See Problem Variable
| Determination. Description
Problem Determination: Collect the following csect The CSECT name of the DB2 module that
diagnostic item listed in “Appendix B. Problem issued the message.
determination” on page 1281: 1.
domain
| Refer to the Language Environment return codes from The TCP/IP domain name used by this DB2
| CEEPIPI in Language Environment for OS/390 & VM subsystem to accept incoming DRDA
| Programming Guide for additional information. connection requests.
| If the function requested by DB2 was tcpport
| add-entry(module-name), an incorrect link edit of the The TCP/IP port number used by this DB2
| module could create unresolved references. To subsystem to accept incoming DRDA
| determine if link edit problems exist, run the OS/390 connection requests.
| AMBLIST utility with LISTLOAD and OUTPUT=XREF.
System Action: The DB2 TCP/IP port number is
available to accept incoming DRDA connection
DSNL518I csect-name LE/370 ENCLAVE FAILED requests.
WITH RETURN CODE=erc AND
FEEDBACK=fi
DSNL520I csect TCP/IP SERVICES AVAILABLE
Explanation: DB2 uses the Language Environment FOR RESPORT port
CEEPIPI call_sub service to execute certain TCP/IP
Explanation: DB2 encountered a TCP/IP failure during
socket calls. The CEEPIPI interface returned information
DDF startup processing. The DSNL515I message
indicating a failure occurred while executing the TCP/IP
identifies the cause of the failure. After the failure is
socket.
detected, DDF periodically attempts to reinitialize
erc The Language Environment enclave return TCP/IP to allow TCP/IP resynchronization to occur. This
code. message is issued when reinitialization is successful.
fi Contains one or two message identifiers. The Variable
Description
Chapter 12. DB2 Messages 347
DSNL521I • DSNL700I
csect The CSECT name of the DB2 module that
DSNL600I RESOURCE UNAVAILABLE
issued the message.
CORRELATION ID=correlation-id
port The TCP/IP port number used by this DB2 CONNECTION ID=connection-id LUW
subsystem to accept incoming ID=luw-id=token REASON=reason-code
resynchronization connection requests. TYPE=resource-type
LOCATION=location-name
System Action: The DB2 TCP/IP port is available to NAME=resource-name
accept incoming resynchronization connection requests.
Explanation: This message is produced at the
requesting site when a distributed request requires a
DSNL521I csect-name INVALID DDF BSDS resource that is not available.
VALUES DETECTED
(PORT=port,RESPORT=rport). The resource identified by 'resource-name' and
'resource-type' was not available at 'location-name' due
Explanation: DB2 encountered invalid values for the to the indicated reason code.
TCP/IP port numbers in the DDF record of the BSDS.
Valid TCP/IP port numbers must obey the following correlation-id
rules: The correlation identifier of the thread
v If PORT is non-zero, RESPORT must also be associated with the requester of the resource.
non-zero. Correlation IDs beginning with '0nn' where 'nn'
is a number from 01 to 28, identify system
v If RESPORT is non-zero, PORT must also be agents.
non-zero.
v PORT and RESPORT must not specify the same connection-id
value. The connection identifier of the requester.
Variable luw-id=token
Description The logical unit of work ID of the thread
followed by an '=' sign and a token which may
port The TCP/IP port number used by this DB2 be used in place of luw-id in any DB2
subsystem to accept incoming DRDA SQL command that accepts luw-id as input.
connection requests.
rport The TCP/IP port number used by this DB2 Refer to message DSNT500I under “Chapter 17.
subsystem to accept incoming 2-phase commit DSNT... Messages” on page 375 for an explanation of
resynchronization requests. the resource type and resource name.
System Action: DDF startup terminates abnormally. System Action: The SQL statement cannot be
executed.
System Programmer Response: Use the Change
Log Inventory utility (DSNJU003) to correct the TCP/IP Operator Response: See Problem Determination.
port numbers used by DB2. Problem Determination: The reason the resource is
unavailable is identified by the reason code. The reason
DSNL522I csect-name REQUIRED TCP/IP codes are described in “Part 4. DB2 Codes” on
SUPPORT NOT AVAILABLE page 707. Collect the information described for the
reason code received.
Explanation: The DB2 BSDS indicated that TCP/IP
access was required, but the required TCP/IP interfaces Collect the following diagnostic items listed in
were not available on this system. The required TCP/IP “Appendix B. Problem determination” on page 1281: 1.
interfaces are provided by OS/390 Release 3.
System Action: DDF startup terminates abnormally. DSNL700I csect-name CDB RESOURCE
UNAVAILABLE, DEFAULTS MAY BE
System Programmer Response: Take one of the USED REASON=reason TYPE=type
following actions: NAME=name
v Install OS/390 Release 3 or later, so that the required Explanation: This message indicates that a requested
TCP/IP interfaces are available. function required the CDB which is currently
v Use the Change Log Inventory utility (DSNJU003) to unavailable. Defaults can be used to allocate
deactivate DB2’s TCP/IP support, by specifying conversations or set conversation limits with VTAM and
PORT=0 and RESPORT=0 on the DDF statement. TCP/IP partners.
System Action: If the SYSIBM.MODESELECT table is
unavailable, VTAM defaults are used to allocate
conversations. If the the SYSIBM.LUMODES table is
unavailable, VTAM defaults can be used for
348 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNL701I • DSNL706I
conversation limits. If the SYSIBM.LOCATIONS, definition is missing or incorrect.
SYSIBM.IPNAMES, SYSIBM.LULIST, or
System Action: The distributed data facility (DDF)
SYSIBM.LUNAMES tables areunavailable,
terminates.
conversations can not be allocated to remote
LOCATIONs. Operator Response: Notify the system programmer.
Operator Response: Note the REASON code, the System Programmer Response: Define the index as
TYPE code, and the NAME. See Problem Determination required and issue the -START DDF command. Refer to
section for an explanation of the collected data. Part 3 of DB2 Installation Guide.
Problem Determination: The reason the resource is Problem Determination: Print the definition of the
unavailable is identified by a reason code. The reason communications database (CDB).
codes that appear in this message are described in
“Part 4. DB2 Codes” on page 707. Use the table defined
for message DSNT500I to find the TYPE of resource DSNL704I CDB OBJECT object-name DOES NOT
identified in the message. HAVE PROPER REFERENTIAL
CONSTRAINT DEFINITIONS
DSNL701I CDB OBJECT object-name DOES NOT Explanation: The communications database (CDB)
EXIST requires referential constraint definitions for
'object-name'. The current definition is missing or
Explanation: The communications database (CDB) incorrect.
does not contain object-name. The incorrect
object-name can be the database name, the table System Action: Termination of the distributed data
space name, or the table name. facility (DDF) is initiated.
System Action: Termination of the distributed data Operator Response: Notify the system programmer.
facility (DDF) is initiated. System Programmer Response: Determine what
Operator Response: Notify the system programmer. caused the failure, define the missing referential
constraint, and issue the -START DDF command. Refer
System Programmer Response: Determine what to Part 3 of DB2 Installation Guide .
caused the failure, define the object as required, and
issue the -START DDF command. Problem Determination: Print the definition of the
communications database (CDB).
Problem Determination: Print the definition of the
communications database (CDB).
DSNL705I CDB IS UNAVAILABLE OR
INCORRECTLY DEFINED
DSNL702I CDB TABLE table-name DOES NOT
HAVE PROPER COLUMN DEFINITIONS, Explanation: During start-up of the distributed data
COLUMN column-name IS MISSING OR facility, the required CDB was unavailable or incorrectly
INCORRECTLY DEFINED defined.
Explanation: The communications database (CDB) System Action: Termination of the DDF is initiated.
needs a definition for 'column-name' in 'tablename'. The Operator Response: Notify the system programmer.
current definition is missing or incorrect.
System Programmer Response: Refer to the
System Action: Termination of the distributed data previous message that specifies the cause of the CDB
facility (DDF) is initiated. failure (DSNL700I, DSNL701, DSNL702I, DSNL703I, or
Operator Response: Notify the system programmer. DSNL704I). Determine what caused the failure, fix the
error condition, and issue the -START DDF command.
System Programmer Response: Determine what
caused the failure, define the column as required, and Collect the following diagnostic items listed in
issue the -START DDF command. “Appendix B. Problem determination” on page 1281: 1.
Problem Determination: Print the definition of the
communications database (CDB). DSNL706I csect-name AN ERROR HAS
OCCURRED IN DDF EXIT ROUTINE
routine
DSNL703I CDB TABLE table-name DOES NOT
HAVE PROPER INDEX DEFINITIONS, Explanation: An error occurred following invocation of
INDEX index-name IS MISSING OR a DDF exit routine by DB2.
INCORRECTLY DEFINED The variable “routine” is the name of the exit routine,
Explanation: The communications database (CDB) DSNLHLIx, invoked by DB2.
requires an index name for table-name. The current
Chapter 12. DB2 Messages 349
System Action: The system abends the failing
database-access agent.
350 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 13. DSNM... Messages
All of the DSNM... messages are sent to the IMS master terminal operator (MTO),
and to the appropriate MVS console.
DSNM001I IMS/TM xxxx CONNECTED TO DSNM003I IMS/TM xxxx FAILED TO CONNECT TO
SUBSYSTEM yyyy SUBSYSTEM yyyy RC=rc
Explanation: This is an information message only. Explanation: The IMS/TM system (named 'xxxx')
The control region of the IMS/TM system specified in control region did not connect to the DB2 subsystem
the message as 'xxxx' has successfully connected to (named 'yyyy'). This message is sent to the IMS/TM
the DB2 subsystem specified in the message as 'yyyy'. master terminal operator. The return code 'rc' indicates
The message is sent to the IMS/TM master terminal the reason for the failure.
operator.
Value Description
System Action: IMS/TM transactions can access DB2
00 The DB2 subsystem is not operational.
resources.
However, a notify message has been queued
and, when the DB2 subsystem is started, it will
DSNM002I IMS/TM xxxx DISCONNECTED FROM automatically connect to IMS/TM.
SUBSYSTEM yyyy RC=rc
04 The connection attempt failed between IMS/TM
Explanation: The IMS/TM system named 'xxxx' and the DB2 subsystem.
control region has disconnected from the DB2
System Action: IMS/TM transactions cannot access
subsystem named 'yyyy' for the RC, reason code, of 'rc'.
DB2 resources.
The message is sent to the IMS/TM master terminal
operator. The reason code values are: Operator Response: For return code 00, start the
DB2 subsystem. For return code 04, notify the system
Value Description
programmer.
A IMS/TM is terminating normally (for example,
System Programmer Response: For return code 04,
/CKPT FREEZE command).
refer to Part 4 (Volume 1) of DB2 Administration Guide
B IMS/TM is terminating abnormally. for failure analysis procedures.
C DB2 is terminating in a quiesce fashion (for Problem Determination: For return code 04, an
example, DB2 stop quiesce command). IMS/TM attachment facility snap record (code
X'5501FF') is written to the IMS/TM log to indicate the
D DB2 is terminating abnormally.
reason for the failure.
E The connection between IMS/TM and the DB2
subsystem is terminating; however, both
DSNM004I RESOLVE INDOUBT ENTRY(S) ARE
subsystems remain operational.
OUTSTANDING FOR SUBSYSTEM xxxx
System Action: The connection between IMS/TM and
Explanation: The DB2 subsystem ID of 'xxxx' has
DB2 terminated. IMS/TM transactions can no longer
'indoubt' entry(s) remaining after the IMS/TM subsystem
access DB2 resources.
has attempted to resolve the work units that are
Operator Response: Notify the system programmer. indoubt. This message is sent to the IMS/TM master
terminal operator.
System Programmer Response: Reason code A, C,
or E makes this an information message. Reason code System Action: The connection between the DB2 and
D indicates that a serious problem occurred in the DB2 IMS/TM subsystems remains active, and applications
subsystem, and that the SYS1.LOGREC should be can access DB2 resources.
examined. For reason code B or D, determine the failing
Operator Response: Notify the system programmer.
subcomponent, and if you suspect an error in DB2, refer
to Part 2 of DB2 Diagnosis Guide and Reference for System Programmer Response: Refer to Part 4
information on identifying and reporting the problem. (Volume 1) of DB2 Administration Guide for failure
analysis procedures. DB2 commands (DISPLAY
Problem Determination: SYS1.LOGREC and/or dump
THREAD and RECOVER INDOUBT) may be used to
information may be available for reason codes B and D.
display and resolve the work unit(s) that are indoubt.
Problem Determination: Recovery information is
available on the DB2 log and IMS/TM log to assist in
the resolution of the work unit(s) indoubt. For each
© Copyright IBM Corp. 1982, 2001 351
DSNM005I • DSNM104I
indoubt work unit, an IMS/TM attachment facility snap subsystem is operational, and if you suspect an error in
record (code X'5501FE') is written to the IMS/TM log. DB2, refer to Part 2 of DB2 Diagnosis Guide and
Reference for information on identifying and reporting
the problem. The person entering the request may not
DSNM005I IMS/TM RESOLVE INDOUBT
be authorized to execute the command. If the DB2
PROTOCOL PROBLEM WITH
subsystem is not operational, DB2 commands from
SUBSYSTEM xxxx
IMS/TM cannot be processed.
Explanation: The DB2 subsystem ID of 'xxxx' has
Problem Determination: A snap record (X'5501FF') is
protocol incompatibilities with IMS/TM. The DB2 resolve
written to the IMS/TM log if a connection request failed.
indoubt process received an unknown or invalid
recovery request (RRE) from IMS/TM. The request was
rejected by DB2 and kept by IMS/TM. The message is DSNM104I xxxx COMMAND FAILED
sent to the IMS/TM master terminal operator.
Explanation: The DB2 command specified by 'xxxx'
System Action: The connection between the DB2 and failed to complete.
IMS/TM subsystems remains active, and applications
System Action: The command terminated without
can access DB2 resources.
providing an output message. Commands will still be
Operator Response: Notify the system programmer. allowed by the IMS/TM attachment facility.
System Programmer Response: Call the support System Programmer Response: If you suspect an
center after extracting from the IMS/TM log the IMS/TM error in DB2, refer to Part 2 of DB2 Diagnosis Guide
attachment facility snap records (code X'5501FE') using and Reference for information on identifying and
the IMS/TM utility DFSERA10. reporting the problem.
These records contain the complete request from Problem Determination: If the command failed
IMS/TM to DB2, the request type is at offset X'01C', this because of an abend, a snap record (X'5501FF') is
is a four-character identifier which should contain any of written to the IMS/TM log and SYS1.LOGREC
the following words: information is available.
'SHOW', 'IDBT', 'COMM', or 'ABRT'.
If the IMS/TM recovery request (RRE) found in the log
is an invalid one, (not 'COMM' or 'ABRT'), you may
manually delete it using the IMS/TM/CHANGE SUBSYS
RESET command after consulting with the support
center.
If the IMS/TM request is a valid one (abort or commit),
you must find the action that IMS/TM performed for that
RRE by locating the X'3730' (commit) or X'3801' (abort)
record in the IMS/TM log and perform the same action
under DB2 by using the -RECOVER INDOUBT
command. Also refer to Part 4 (Volume 1) of DB2
Administration Guide for more information about
resolve-indoubt failure analysis.
Problem Determination: Recovery information is
available on the DB2 log and IMS log to assist in the
resolution of the problem. For each indoubt work unit,
an IMS/TM attachment facility snap record (code
X'5501FE') is written to the IMS/TM log.
DSNM100I SUBSYSTEM xxxx NOT AVAILABLE
Explanation: The IMS/TM command facility which
routes commands to the DB2 subsystem cannot
perform its functions because the DB2 subsystem
named 'xxxx' is considered not operational.
System Action: The connection to the DB2
subsystem failed for the command. The command is
rejected.
System Programmer Response: If the DB2
352 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 14. DSNN... Message
DSNN40 THE NUMBER YOU SELECTED IS NOT
A VALID SQL RETURN CODE NUMBER
Explanation: The user looking at the SQL Return
Codes Menu in DB2 HELP selected a number that is
not a valid SQL return code.
System Action: The SQL Return Codes Menu
continues to be displayed.
User Response: Select a valid SQL return code
number, and try again.
Operator Response: Select a valid SQL return code
number, and try again.
© Copyright IBM Corp. 1982, 2001 353
354 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 15. DSNP... Messages
The DSNP-prefixed messages contain a connection ID, a correlation ID, and a
logical-unit-of-work ID. Messages that have the same connection ID, correlation ID,
and logical-unit-of-work ID relate to the same user. This makes it possible to scan a
number of DSNP-prefixed messages and group activities involving a given user.
v If the table space or index is backed by storage
DSNP001I csect – data-set-name IS WITHIN nk
group-defined data sets and this data set is not at
BYTES OF AVAILABLE SPACE.
maximum (123) extents, use the ALTER STOGROUP
RC=rrrrrrrr CONNECTION-ID=xxxxxxxx,
statement to add volumes to the storage group (up to
CORRELATION-ID=yyyyyyyyyyyy,
133 of them).
LUW-ID=logical-unit-of-work-id=token
v If the table space or index is backed by 'user-defined'
Explanation: This message warns of an impending data sets, and not at maximum (123) extents for the
space shortage. The data space manager (DSM) extend data set, issue an ALTER ADDVOLUMES access
function CSECT 'DSNPmmmm' detected the space method services command to provide additional
shortage through the use of a 'hedge' quantity 'n'. volumes (up to 133 of them). Or, if the table space is
Reason code 'rrrrrrrr' gives some information about why nonpartitioned and the high allocated RBA is greater
space could not be obtained. (See “Part 4. DB2 Codes” than or equal to 2GB (2,147,483,648) for the
on page 707.) indicated data set, define the data set required for the
next sequential piece. (Actually, in this case, there
There might also be some preceding DSM and VSAM
should be an indication in console messages or the
messages that can help to determine why space cannot
reason code that the data set required for the next
be obtained. The connection, correlation, and
piece was not found.)
logical-unit-of-work IDs identify the user or application
v If the data set is at maximum (123) extents, try
that encountered the problem. Correlation IDs beginning
reorganizing the table space or index into a data set
with '0nn', where 'nn' is a number, identify system
or data sets having larger primary and secondary
agents.
values. This process is discussed in Part 2 (Volume
A LUW-ID of '*' indicates that the thread does not have 1) of DB2 Administration Guide.
a LUW-ID. If the LUW-ID is not an '*', the value is a
Problem Determination: Examine the console
logical-unit-of-work-id that is assigned to the thread
messages, SYS1.LOGREC information, and SYSLOG
followed by an '=' sign and a token value, which can be
to determine the reason for the condition. Try to resolve
used in place of logical-unit-of-work-id in any DB2
it by the methods described in the Operator Response
command that accepts logical-unit-of-work-id as input.
section of this message. If you feel that this message
Messages that have the same connection ID, correlation indicates a problem in an IBM program, you should
ID, and LUW-ID relate to the same user. This makes it provide the following sources of information about the
possible to scan a number of DSNP-prefixed messages problem:
and group activities involving a given user. v Console sheet showing the message and related
messages that might precede or follow it.
System Action: If sufficient space is available for the v System log printout (obtained via MVS WRITELOG
current request, continue. Otherwise, message operator command) showing related VSAM/media
DSNP007I follows, and the current SQL request fails. manager messages that might appear there (usually
Operator Response: DSM messages are directed to needed only if you have a message or reason code
the database administrator (DBA) or system that indicates a media manager services problem
administrator. However, the DBA or system occurred).
administrator can request that the operator issue an v Integrated catalog facility (ICF) catalog listing
MVS WRITELOG operator command (for example, 'W showing characteristics of the data set in question
A') to obtain MVS SYSLOG output. The SYSLOG and of the ICF catalog itself.
sometimes contains media manager messages that v VTOC listing of packs associated with the request,
might be helpful to the DBA or system administrator in showing space available for data sets, catalogs,
determining why space could not be allocated. VTOC index, and the VTOC itself, as well as data set
extent information.
System Programmer Response: Based on the v Any associated dumps.
reason code (RC) in the message, as well as v SYS1.LOGREC listing showing entries at or near the
information that might be available in access method time of the problem (unless these appear in an
services or VSAM messages preceding this one, try one associated dump).
of the following:
v If you do not anticipate further extension of this table
space or index, ignore the message.
© Copyright IBM Corp. 1982, 2001 355
DSNP002I • DSNP004I
v Depending on the reason code, the results of certain 'DSNPmmmm' for the reason identified by RC. (See
SQL SELECT operations on DB2 catalog tables may “Part 4. DB2 Codes” on page 707.) The connection ID,
be needed. (See “Part 4. DB2 Codes” on page 707.) correlation ID, and logical-unit-of-work ID (LUW-ID)
identify the user or application that encountered the
problem. Correlation IDs beginning with '0nn', where 'nn'
DSNP002I csect – DEFINE FAILED FOR
is a number, identify system agents.
data-set-name RC=rrrrrrrr
CONNECTION-ID=xxxxxxxx, A LUW-ID of '*' indicates that the thread does not have
CORRELATION-ID=yyyyyyyy, a LUW-ID. If the LUW-ID is not an '*', the value is a
LUW-ID=logical-unit-of-work-id =token logical-unit-of-work-id that is assigned to the thread
followed by an '=' sign and a token value, which can be
Explanation: Data set definition failed (in CSECT
used in place of logical-unit-of-work-id in any DB2
'DSNPmmmm') for the reason identified by RC. (See
command that accepts logical-unit-of-work-id as input.
“Part 4. DB2 Codes” on page 707.) The connection ID,
correlation ID, and logical-unit-of-work ID (LUW-ID) Messages that have the same connection ID, correlation
identify the user or application that encountered the ID, and LUW-ID relate to the same user. This makes it
problem. The connection, correlation, and possible to scan a number of DSNP-prefixed messages
logical-unit-of-work IDs identify the user or application and tie together activities involving a given user.
that encountered the problem. Correlation IDs beginning
System Action: DSM terminates its actions
with '0nn', where 'nn' is a number, identify system
associated with the current SQL request. Higher level
agents.
functions might terminate the current SQL request or
A LUW-ID of '*' indicates that the thread does not have the unit of recovery that issued the request.
a LUW-ID. If the LUW-ID is not an '*', the value is a
Operator Response: This message is directed to the
logical-unit-of-work-id that is assigned to the thread
database administrator or the system administrator.
followed by an '=' sign and a token value, which can be
Bring it to that person’s attention if it appears on the
used in place of logical-unit-of-work-id in any DB2
MVS operator’s console. The installation should
command that accepts logical-unit-of-work-id as input.
consider directing DB2 messages to a console other
Messages that have the same connection ID, correlation than the operator’s console.
ID, and LUW-ID relate to the same user. This makes it
System Programmer Response: Investigate the
possible to scan a number of DSNP-prefixed messages
problem indicated by the reason code and preceding
and group activities involving a given user.
DB2, access method services, or VSAM messages, if
System Action: The data space manager (DSM) any, and correct it, if possible.
terminates its actions associated with the current SQL
It might be necessary to delete and redefine the data
request. Higher level functions might terminate the
set using access method services. Consider making a
current SQL request or the unit of recovery that issued
backup copy before doing this. (Use DB2 utilities to
the request.
make the copy; in general, VSAM utilities do not work
Operator Response: This message is directed to on DB2 database services data sets.)
either the database administrator or the system
Problem Determination: See Problem Determination
administrator. Bring the message to their attention if it
for message DSNP001I for this information.
appears on the MVS operator’s console. The installation
should consider directing DB2 messages to a console
other than the operator’s console. DSNP004I csect – DELETE FAILED FOR
data-set-name. RC=rrrrrrrr
System Programmer Response: Investigate the
CONNECTION-ID=xxxxxxxx,
problem indicated by the reason code and preceding
CORRELATION-ID=yyyyyyyyyyyy,
access method services messages, if any, and correct
LUW-ID=logical-unit-of-work-id=token
it, if possible. If an out-of-space condition exists, see the
description of message DSNP001I for actions to Explanation: Deletion failed in CSECT 'DSNPmmmm'
consider. for the reason identified by RC. (See “Part 4. DB2
Codes” on page 707.) The connection ID, correlation ID,
Problem Determination: See Problem Determination
and logical-unit-of-work ID (LUW-ID) identify the user or
of message DSNP001I for this information.
application that encountered the problem. Correlation
IDs beginning with '0nn', where 'nn' is a number, identify
DSNP003I csect – RESET FAILED FOR system agents.
data-set-name. RC=rrrrrrrr
The value of the LUWID is alogical-unit-of-work-id that
CONNECTION-ID=xxxxxxxx,
is assigned to the thread followed by an '=' sign and a
CORRELATION-ID=yyyyyyyyyyyy,
token value, which can be used in place of
LUW-ID=logical-unit-of-work-id=token
logical-unit-of-work-id in any DB2 command that accepts
Explanation: Reset, a data space manager (DSM) logical-unit-of-work-id as input.
function invoked by DB2 utilities, failed in CSECT
356 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNP005I • DSNP006I
Messages that have the same connection ID, correlation If needed, the storage group in question can be
ID, and LUWID relate to the same user. This makes it identified by issuing an SQL SELECT to get information
possible to scan a number of DSNP-prefixed messages about the table space or index that is identified by the
and group activities involving a given user. third and fourth qualifiers (database name, table space
name) in the data set name.
Severity: 8 (error)
System Action: Operation continues.
System Action: DB2 terminates its actions associated
with the current SQL request. DB2 might terminate the Operator Response: This message is directed to the
current SQL request or the unit of recovery that issued database administrator or the system administrator.
the request. Bring it to that person’s attention if it appears on the
MVS operator’s console. The installation should
Operator Response: This message is directed to the
consider directing DB2 messages to a console other
database administrator or the system administrator.
than the operator’s console.
Bring it to that person’s attention if it appears on the
MVS operator’s console. The installation should System Programmer Response: Look for associated
consider directing DB2 messages to a console other DSM and access method services messages preceding
than the operator’s console. this one to get additional information. Attempt an ALTER
REMOVEVOLUMES access method services command,
System Programmer Response: Investigate the
if appropriate, after issuing a LISTCAT to see which
problem indicated by the reason code and preceding
volumes are recorded as 'candidate' in the integrated
access method services messages if any, and correct it,
catalog facility (ICF) catalog.
if possible. Check the data set and delete it by using
access method services directly if reasonable to do so. Problem Determination: See Problem Determination
Consider making a backup copy before doing this. (Use for message DSNP001I for this information. (However,
DB2 utilities to make the copy; in general, VSAM utilities there should not be a need for VTOC or SYSLOG
do not work on DB2 data sets.) information for this case.)
Problem Determination: See Problem Determination
for message DSNP001I for this information. DSNP006I csect – REQUIRED STOGROUP
DEFINED DATA SET NOT AVAILABLE—
data-set-name RC=rrrrrrrr
DSNP005I csect – COULD NOT REMOVE EXCESS
CONNECTION-ID=xxxxxxxx,
VOLUMES FROM CANDIDATE LIST OF
CORRELATION-ID=yyyyyyyyyyyy,
data-set-name CONNECTION-
LUW-ID=logical-unit-of-work-id=token
ID=xxxxxxxx, CORRELATION-
ID=yyyyyyyyyyyy, LUW-ID=logical-unit-of- Explanation: An attempt to alter the shareoptions of
work-id=token this data set failed. The data set could not be accessed
for the reason indicated by RC. (See “Part 4. DB2
Explanation: Volumes from a storage group were
Codes” on page 707.) The connection ID, correlation ID,
entered in the data set’s candidate list and could not be
and logical-unit-of-work ID (LUWID) identify the user or
removed by CSECT 'DSNPmmmm' after some data
application that encountered the problem. Correlation
space manager (DSM) operation. The connection ID,
IDs beginning with '0nn', where 'nn' is a number, identify
correlation ID, and logical-unit-of-work ID (LUW-ID)
system agents.
identify the user or application that encountered the
problem. Correlation IDs beginning with '0nn', where 'nn' The value of the LUWIDis a logical-unit-of-work-id that
is a number, identify system agents. is assigned to the thread followed by an '=' sign and a
token value, which can be used in place of the
A LUW-ID of '*' indicates that the thread does not have
logical-unit-of-work-id in any DB2 command that accepts
a LUW-ID. If the LUW-ID is not an '*', the value is a
the logical-unit-of-work-id as input.
logical-unit-of-work-id that is assigned to the thread
followed by an '=' sign and a token value, which can be Messages having the same connection ID, correlation
used in place of logical-unit-of-work-id in any DB2 ID, and LUWID relate to the same user. This makes it
command that accepts logical-unit-of-work-id as input. possible to scan a number of DSNP-prefixed messages
and group activities involving a given user.
Messages that have the same connection ID, correlation
ID, and LUW-ID relate to the same user. This makes it Severity: 8 (error)
possible to scan a number of DSNP-prefixed messages
System Action: DB2 terminates its actions associated
and group activities involving a given user.
with the current SQL request. DB2 might terminate the
This is not a major problem. However, the data set will current SQL request or the unit of recovery that issued
not properly reflect subsequent deletions from the the request.
volume list in its storage group (via ALTER STOGROUP
Operator Response: This message is directed to the
command in SQL), because the data set’s integrated
database administrator or the system administrator.
catalog facility (ICF) catalog entry still contains the
Bring it to that person’s attention if it appears on the
volume serial numbers.
Chapter 15. DB2 Messages 357
DSNP007I • DSNP008I
MVS operator’s console. The installation should the RC indicates 'resource unavailable', console
consider directing DB2 messages to a console other messages identify the resource that is unavailable.
than the operator’s console. Most likely, the message will be DSNT500I.
System Programmer Response: If you suspect an v Retrieve diagnostic information from the output of the
error in DB2, refer to Part 2 of DB2 Diagnosis Guide DISPLAY DB...RESTRICT or DISPLAY UTIL(*)...
and Reference for information on identifying and commands.
reporting the problem. v If the extend failed on a result table space, refer to
“Sort Data Sets” in Part 5 (Volume 2) of DB2
Problem Determination: See Problem Determination
Administration Guide.
for message DSNP001I for this information.
v If the extend failed on an SQL insert or update, refer
to Part 2 of DB2 Diagnosis Guide and Reference for
DSNP007I csect – EXTEND FAILED FOR information on identifying and reporting the problem.
data-set-name. RC=rrrrrrrr
v If you need to enlarge your data set, refer to “Out of
CONNECTION-ID=xxxxxxxx,
DASD Space” in Part 4 (Volume 1) of DB2
CORRELATION-ID=yyyyyyyyyyyy,
Administration Guide.
LUW-ID=logical-unit-of-work-id =token
v To find out how the extend function operates, refer to
Explanation: Extension failed in CSECT “Improving DASD Utilization” in Part 5 (Volume 2) of
'DSNPmmmm' of the data space manager (DSM). The DB2 Administration Guide.
'data-set-name' identifies the data set that is being
extended. RC is the reason code, which indicates why Operator Response: See Operator Response for
the extend process failed. (See “Part 4. DB2 Codes” on message DSNP001I for this information.
page 707.) The 'connection ID', 'correlation ID', and System Programmer Response: See System
'logical-unit-of-work ID' (LUW-ID) identify the user or Programmer Response for message DSNP001I for this
application that encountered the problem. Correlation information.
IDs beginning with '0nn', where 'nn' is a number, identify
system agents. Problem Determination: See Problem Determination
for message DSNP001I
A LUW-ID of '*' indicates that the thread does not have
a LUW-ID. If the 'LUW-ID' is not an '*', the value is a
'logical-unit-of-work-id' that is assigned to the thread DSNP008I csect– REQUIRED USER–DEFINED
followed by an '=' sign and a token value, which can be DATA SET NOT AVAILABLE—data-set-
used in place of 'logical-unit-of-work-id' in any DB2 name RC=rrrrrrrr CONNECTION-
command that accepts 'logical-unit-of-work-id' as input. ID=xxxxxxxx, CORRELATION-
ID=yyyyyyyyyyyy, LUW-ID=logical-unit-of-
Messages that have the same 'connection ID', work-id=token
'correlation ID', and 'LUW-ID' relate to the same user.
This makes it possible to scan a number of Explanation: One of the following actions applied
DSNP-prefixed messages and group activities involving against user-defined data sets failed in CSECT
a given user. 'DSNPmmmm' of the data space manager (DSM):
v Create table space or index
System Action: The DSM terminates its actions
associated with this extend request. Higher level v Extend table space or index
functions might terminate if they cannot continue without v Process the SQL ALTER DATABASE statement
a successful extend. In this case, additional console v Process the REORG TABLESPACE utility with
messages and/or SQL codes are produced. In other SHRLEVEL REFERENCE or CHANGE
cases, higher level functions might be able to resolve
the space need without the extend, so they continue Correlation IDs beginning with '0nn', where 'nn' is a
normally. number, identify system agents.
System Programmer Response: The following
One or more of the data sets could not be accessed for
sources of information are available to help determine
the reason indicated by RC. (See “Part 4. DB2 Codes”
the cause of the failure:
on page 707.) The connection ID, correlation ID, and
v See the Programmer Response for message logical-unit-of-work ID (LUWID) identify the user or
DSNP001I. application that encountered the problem.
v Analyze the RC value in conjunction with the console
messages. The value of the LUWID is alogical-unit-of-work-id that
v The reason code might apply to the data set is assigned to the thread followed by an '=' sign and a
identified in the message or to another data set that token value, which can be used in place of
is needed for the extend process. If the reason code logical-unit-of-work-id in any DB2 command that accepts
indicates a data set access failure, the console logical-unit-of-work-id as input.
messages indicate the data set name. For example, if
358 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNP009I • DSNP011I
Messages having the same connection ID, correlation The prefix of the messages in the block is usually IDC
ID, and LUWID relate to the same user. This makes it (access method services messages). However, the
possible to scan a number of DSNP-prefixed messages prefix can also be IKJ (dynamic allocation) or other
and group activities involving a given user. system subcomponent IDs. Refer to the appropriate
MVS publication for descriptions of the enclosed
If the name of the data set in the message is different messages.
from the name of the original data set (for example,
'....A002' instead of '...A001'), a new data set might The operation can be DEFINE CLUSTER, ALTER
need to be created. A different name indicates that the ADDVOLUMES, ALTER REMOVEVOLUMES, or
original data set exceeded its limit. DELETE CLUSTER. One or more other DSM messages
follow this message to explain what happened as a
Severity: 8 (error)
result of the failure of this access method services
System Action: DB2 terminates its actions associated request. The connection ID, correlation ID, and
with the current SQL request or utility. DB2 might logical-unit-of-work ID (LUW-ID) identify the user or
terminate the current SQL request or utility or the unit of application that encountered the problem.
recovery that issued the request.
A LUW-ID of '*' indicates that the thread does not have
Operator Response: This message is directed to the
a LUW-ID. If the LUW-ID is not an '*', the value is a
database administrator or the system administrator.
logical-unit-of-work-id that is assigned to the thread
Bring it to that person’s attention if it appears on the
followed by an '=' sign and a token value, which can be
MVS operator’s console. The installation should
used in place of logical-unit-of-work-id in any DB2
consider directing DB2 messages to a console other
command that accepts logical-unit-of-work-id as input.
than the operator’s console.
System Programmer Response: Refer to the reason Messages that have the same connection ID, correlation
code in “Part 4. DB2 Codes” on page 707. The return ID, and LUW-ID relate to the same user. This makes it
code description might indicate that one of the following possible to scan a number of DSNP-prefixed messages
actions needs to be performed or it indicates the and group activities involving a given user. Correlation
necessary steps: IDs beginning with '0nn', where 'nn' is a number, identify
v If the data set does not exist, create it before system agents.
attempting the create table space/index or extend System Action: Operation continues.
data set again.
Operator Response: This message is directed to the
v If the data set shareoptions are incorrect, modify the
database administrator or the system administrator.
shareoptions with access method services (AMS).
Bring it to that person’s attention if it appears on the
v The appropriate AMS command is ALTER MVS operator’s console. The installation should
SHAREOPTIONS. consider directing DB2 messages to a console other
Problem Determination: See Problem Determination than the operator’s console.
for message DSNP001I for this information. System Programmer Response: Use this information
to help resolve problems indicated by other DSM
DSNP009I THE FOLLOWING ERROR MESSAGES messages that follow this one.
WERE RECEIVED FOR operation ON Problem Determination: See Problem Determination
data-set-name for message DSNP001I for this information.
DSNP010I END OF ERROR MESSAGES. DSNP011I csect – MEDIA MANAGER SERVICES
CONNECTION-ID=xxxxxxxx, ERROR FOR data-set-name.
CORRELATION-ID=yyyyyyyyyyyy, MMRC=cccccccc DSMRC=ffffffff
LUW-ID=logical-unit-of-work-id=token CONNECTION-ID=xxxxxxxx,
Explanation: Messages DSNP009I and DSNP010I CORRELATION-ID=yyyyyyyyyyyy,
enclose a block of messages that are received by the LUW-ID=logical-unit-of-work-id =token
data space manager (DSM) subcomponent of DB2 in Explanation: The MMRC is the return code that DB2
response to an access method services (AMS) received from media manager services. Refer to the
operation. appropriate MVS publication for a description of these
operation codes. DSMRC is a DSM reason code that indicates
The access method services operation that which of the media manager services functions, update
was being performed. or extend, failed. (See “Part 4. DB2 Codes” on
data-set-name page 707.) The message is from CSECT 'DSNPmmmm'
The data set on which the operation was being of the data space manager (DSM). The connection ID,
performed. correlation ID, and logical-unit-of-work ID (LUW-ID)
identify the user or application that encountered the
Chapter 15. DB2 Messages 359
DSNP012I • DSNP013I
problem. Correlation IDs beginning with '0nn', where 'nn' number, identify system agents.
is a number, identify system agents.
An LUW-ID of '*' indicates that the thread does not have
A LUW-ID of '*' indicates that the thread does not have an LUW-ID. If the LUW-ID is not an '*', the value is a
a LUW-ID. If the LUW-ID is not an '*', the value is a 'logical-unit-of-work-id' that is assigned to the thread
logical-unit-of-work-id that is assigned to the thread followed by an '=' sign and a token value, which can be
followed by an '=' sign and a token value, which can be used in place of 'logical-unit-of-work-id' in any DB2
used in place of logical-unit-of-work-id in any DB2 command that accepts 'logical-unit-of-work-id' as input.
command that accepts logical-unit-of-work-id as input.
Messages that have the same connection ID, correlation
Messages that have the same connection ID, correlation ID, and LUW-ID relate to the same user. This makes it
ID, and LUW-ID relate to the same user. This makes it possible to scan a number of DSNP-prefixed messages
possible to scan a number of DSNP-prefixed messages and group activities involving a given user.
and group activities involving a given user.
System Action: DB2 terminates its actions associated
System Action: The DSM terminates its actions with the current SQL request. Higher level functions
associated with the current SQL request. Higher level might terminate the current SQL request or the unit of
functions might terminate the current SQL request or recovery that issued the request.
the unit of recovery that issued the request.
System Programmer Response: Correct the problem
Operator Response: DSM messages are directed to indicated by the catalog return and reason codes.
either the database administrator (DBA) or the system
Problem Determination: See Problem Determination
administrator. However, they can request that the
for message DSNP001I for this information.
operator issue an MVS WRITELOG operator command
(for example, 'W A') to obtain MVS SYSLOG output.
The SYSLOG sometimes contains media manager DSNP013I INSUFFICIENT PRIMARY ALLOCATION
messages that might be helpful to the DBA or system SPACE TO FORMAT CONTROL PAGES
administrator in determining why space could not be IN DATA SET data-set-name
allocated. CONNECTION-ID=xxxxxxxx,
CORRELATION-ID=yyyyyyyyyyyy,
System Programmer Response: This message might
LUW-ID=logical-unit-of-work-id =token
be preceded by one or more IEC or ICY messages on
the console or in SYSLOG. These messages help to Explanation: Data space manager (DSM) discovered
determine what happened and what action to take. that the primary space quantity given in the data set
definition was not large enough. Formatting of required
Problem Determination: See Problem Determination
control information in the first several pages was not
for message DSNP001I for this information.
possible. The connection ID, correlation ID, and
logical-unit-of-work ID (LUW-ID) identify the user or
DSNP012I csect – ERROR IN ICF CATALOG application that encountered the problem.
LOCATE FUNCTION FOR data-set-name
A LUW-ID of '*' indicates that the thread does not have
CTLGRC=cc CTLGRSN=zzzzrrrr
a LUW-ID. If the LUW-ID is not an '*', the value is a
CONNECTION-ID=xxxxxxxx,
logical-unit-of-work-id that is assigned to the thread
CORRELATION-ID=yyyyyyyyyyyy,
followed by an '=' sign and a token value, which can be
LUW-ID=logical-unit-of-work-id=token
used in place of logical-unit-of-work-id in any DB2
Explanation: CTLGRC and CTLGRSN are the return command that accepts logical-unit-of-work-id as input.
and reason codes that DB2 received from the SVC 26
Messages that have the same connection ID, correlation
(ICF catalog locate function). The reason code is in the
ID, and LUW-ID relate to the same user. This makes it
same format as that returned to DB2 by the SVC 26. In
possible to scan a number of DSNP-prefixed messages
it, zzzz is the hexadecimal value of the last two
and group activities involving a given user. Correlation
characters of the SVC 26 CSECT that set the code. The
IDs beginning with '0nn', where 'nn' is a number, identify
full CSECT name is derived by appending these two
system agents.
characters to 'IGG0CL'; rrrr is the numeric part of the
reason code, in hexadecimal. System Action: DSM terminates its actions
associated with the current SQL request. Higher level
See the description of access method services message
functions might terminate the current SQL request or
IDC3009I in the appropriate MVS publication for
the unit of recovery that issued the request.
explanations of the return code and the numeric portion
(rrrr) of the reason code. The values documented there Operator Response: This message is directed to the
are decimal, whereas the value in this message is database administrator or the system administrator.
hexadecimal. Bring it to that person’s attention if it appears on the
MVS operator’s console. The installation should
The connection ID, correlation ID, and LUW-ID identify
consider directing DB2 messages to a console other
the user or application that encountered the problem.
than the operator’s console.
Correlation IDs beginning with '0nn', where 'nn' is a
360 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNP014I • DSNP016I
System Programmer Response: This should occur Diagnosis Guide and Reference for information on
only for table spaces or indexes that are not storage identifying and reporting the problem. Refer to the
group defined. (The DB2 interpreter forces the initial explanation section of this message for additional
allocation to be large enough if a storage group is problem determination information.
used.) Check both the page size specification (4KB or
32KB) and the number of control pages required (2 for
DSNP015I csect – IRLM MANUAL UNLOCK
table space, 3 for index space). Specify the primary
REQUEST FAILED FOR data-set-name.
allocation value again so that at least (pages × page
RC=rr,SC=ssssssss,
size) bytes are allocated.
CONNECTION-ID=xxxxxxxx,
Problem Determination: See Problem Determination CORRELATION-ID=yyyyyyyyyyyy,
for message DSNP001I for this information. LUW-ID=logical-unit-of-work-id=token
Explanation: DB2 requested a manual unlock on a
DSNP014I IRLM MANUAL LOCK REQUEST data set, but the unlock could not be performed for
FAILED FOR data-set-name. reasons specified in RC and SC. RC and SC are the
RC=rr,SC=ssssssss, return code and reason code from IRLM. RC and the
CONNECTION-ID=xxxxxxxx, first two digits of SC are documented in “Part 5. IRLM
CORRELATION-ID=yyyyyyyyyyyy, Messages and Codes” on page 1235. The connection
LUW-ID=logical-unit-of-work-id=token ID, correlation ID, and logical-unit-of-work ID (LUW-ID)
identify the user or application that encountered the
Explanation: DB2 requested a manual lock on a data
problem.
set, but the lock could not be obtained for reasons
specified in RC and SC. RC and SC are the return code A LUW-ID of '*' indicates that the thread does not have
and reason code from IRLM. RC and the first two digits a LUW-ID. If the LUW-ID is not an '*', the value is a
of SC are documented in “Part 5. IRLM Messages and logical-unit-of-work-id that is assigned to the thread
Codes” on page 1235. The connection ID, correlation followed by an '=' sign and a token value, which can be
ID, and logical-unit-of-work ID (LUW-ID) identify the used in place of logical-unit-of-work-id in any DB2
user or application that encountered the problem. command that accepts logical-unit-of-work-id as input.
A LUW-ID of '*' indicates that the thread does not have Messages that have the same connection ID, correlation
a LUW-ID. If the LUW-ID is not an '*', the value is a ID, and LUW-ID relate to the same user. This makes it
logical-unit-of-work-id that is assigned to the thread possible to scan a number of DSNP-prefixed messages
followed by an '=' sign and a token value, which can be and group activities involving a given user. Correlation
used in place of logical-unit-of-work-id in any DB2 IDs beginning with '0nn', where 'nn' is a number, identify
command that accepts logical-unit-of-work-id as input. system agents.
Messages that have the same connection ID, correlation System Action: The current SQL or the unit of
ID, and LUW-ID relate to the same user. This makes it recovery that issued the request might be terminated.
possible to scan a number of DSNP-prefixed messages
Operator Response: This message is directed to the
and group activities involving a given user. DSNP001I or
database administrator or the system administrator.
DSNP007I follow this message. Correlation IDs
Bring it to that person’s attention if it appears on the
beginning with '0nn', where 'nn' is a number, identify
MVS operator’s console. The installation should
system agents.
consider directing DB2 messages to a console other
If message DSNT376I was received before message than the operator’s console.
DSNP014I, the lock request failed because of a timeout
System Programmer Response: Investigate the
condition. Otherwise, refer to the IRLM return and
problem indicated by the IRLM return and reason code.
reason codes for an explanation of the failure.
Problem Determination: Provide the console sheet
System Action: The current SQL or the unit of
and a dump. A GTF trace might also be required. If you
recovery that issued the request might be terminated.
suspect an error in DB2, refer to Part 2 of DB2
Operator Response: This message is directed to the Diagnosis Guide and Reference for information on
database administrator or the system administrator. identifying and reporting the problem. See the
Bring it to that person’s attention if it appears on the explanation section of this message for additional
MVS operator’s console. The installation should problem determination information.
consider directing DB2 messages to a console other
than the operator’s console.
DSNP016I CREATE FAILED FOR pageset-name.
System Programmer Response: Investigate the RC=rrrrrrrr CONNECTION-ID=xxxxxxxx,
problem indicated by the IRLM return and reason code. CORRELATION-ID=yyyyyyyyyyyy,
LUW-ID=logical-unit-of-work-id =token
Problem Determination: Provide the console sheet
and a dump. A GTF trace might also be required. If you Explanation: Creation of a table space or index space
suspect an error in DB2, refer to Part 2 of DB2 failed in the data space manager (DSM) for the reason
Chapter 15. DB2 Messages 361
DSNP017I • DSNP018I
given in RC. (See “Part 4. DB2 Codes” on page 707.) a LUW-ID. If the LUW-ID is not an '*', the value is a
| The pageset-name format is 'dbname.tiname.instance', logical-unit-of-work-id that is assigned to the thread
where 'dbname' is the database name and 'tiname' is followed by an '=' sign and a token value, which can be
the table space or index space name. used in place of logical-unit-of-work-id in any DB2
command that accepts logical-unit-of-work-id as input.
This message identifies the function that was in
progress at the time of a failure. The specific failure is Messages that have the same connection ID, correlation
usually identified by a preceding message. The ID, and LUW-ID relate to the same user. This makes it
connection ID, correlation ID, and logical-unit-of-work ID possible to scan a number of DSNP-prefixed messages
(LUW-ID) identify the user or application that and group activities involving a given user. Correlation
encountered the problem. IDs beginning with '0nn', where 'nn' is a number, identify
system agents.
A LUW-ID of '*' indicates that the thread does not have
a LUW-ID. If the LUW-ID is not an '*', the value is a System Action: DSM terminates its actions
logical-unit-of-work-id that is assigned to the thread associated with the current SQL request. Higher level
followed by an '=' sign and a token value, which can be functions might terminate the current SQL request or
used in place of logical-unit-of-work-id in any DB2 the unit of recovery that issued the request.
command that accepts logical-unit-of-work-id as input.
Operator Response: This message is directed to the
Messages that have the same connection ID, correlation database administrator or the system administrator.
ID, and LUW-ID relate to the same user. This makes it Bring it to that person’s attention if it appears on the
possible to scan a number of DSNP-prefixed messages MVS operator’s console. The installation should
and group activities involving a given user. Correlation consider directing DB2 messages to a console other
IDs beginning with '0nn', where 'nn' is a number, identify than the operator’s console.
system agents.
System Programmer Response: Investigate the
System Action: DSM terminates its actions problem indicated by the reason code and preceding
associated with the current SQL request. Higher level messages, and correct it, if possible.
functions might terminate the current SQL request or
Problem Determination: See Problem Determination
the unit of recovery that issued the request.
for message DSNP001I for this information.
Operator Response: This message is directed to the
database administrator or the system administrator.
DSNP018I DROP FAILED FOR pageset-name.
Bring it to that person’s attention if it appears on the
RC=rrrrrrrr CONNECTION-ID=xxxxxxxx,
MVS operator’s console. The installation should
CORRELATION-ID=yyyyyyyyyyyy,
consider directing DB2 messages to a console other
LUW-ID=logical-unit-of-work-id =token
than the operator’s console.
Explanation: Drop failed in the data space manager
System Programmer Response: Investigate the
(DSM) subcomponent of DB2 for a table space or index
problem indicated by reason code and preceding
space for the reason given in RC. Refer to “Part 4. DB2
messages, and correct it, if possible.
Codes” on page 707. The 'pageset-name' format is
Problem Determination: See Problem Determination 'dbname.tiname', where 'dbname' is the database name
for message DSNP001I for this information. and 'tiname' is the table space or index space name.
This message identifies the function that was in
progress at the time of a failure. The specific failure is
DSNP017I RESET FAILED FOR pageset-name.
usually identified by a preceding message. The
RC=rrrrrrrr CONNECTION-ID=xxxxxxxx,
connection ID, correlation ID, and logical-unit-of-work ID
CORRELATION-ID=yyyyyyyyyyyy,
(LUW-ID) identify the user or application that
LUW-ID=logical-unit-of-work-id =token
encountered the problem.
Explanation: Reset failed in the data space manager
A LUW-ID of '*' indicates that the thread does not have
(DSM) subcomponent of DB2 for a table space or index
a LUW-ID. If the LUW-ID is not an '*', the value is a
space for the reason given in RC. (See “Part 4. DB2
logical-unit-of-work-id that is assigned to the thread
Codes” on page 707.) The 'pageset-name' format is
followed by an '=' sign and a token value, which can be
'dbname.tiname', where 'dbname' is the database name
used in place of logical-unit-of-work-id in any DB2
and 'tiname' is the table space or index space name.
command that accepts logical-unit-of-work-id as input.
This message identifies the function that was in
Messages that have the same connection ID, correlation
progress at the time of a failure. The specific failure is
ID, and LUW-ID relate to the same user. This makes it
usually identified by a preceding message. The
possible to scan a number of DSNP-prefixed messages
connection ID, correlation ID, and logical-unit-of-work ID
and group activities involving a given user. Correlation
(LUW-ID) identify the user or application that
IDs beginning with '0nn', where 'nn' is a number, identify
encountered the problem.
system agents.
A LUW-ID of '*' indicates that the thread does not have
System Action: DSM terminates its actions
362 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNP019I • DSNP021I
associated with the current SQL request. Higher level
DSNP020I csect-name - USER DEFINED
functions might terminate the current SQL request or
ATTRIBUTES INCORRECT FOR
the unit of recovery that issued the request.
data-set-name. RC=rrrrrrrr
Operator Response: This message is directed to the CONNECTION-ID=xxxxxxxx,
database administrator or the system administrator. CORRELATION-ID=yyyyyyyy,
Bring it to that person’s attention if it appears on the LUW-ID=logical-unit-of-work-id =token
MVS operator’s console. The installation should
Explanation: The specified data set was access
consider directing DB2 messages to a console other
method services user-defined and does not have the
than the operator’s console.
required DB2 attributes. The connection ID, correlation
System Programmer Response: Investigate the ID, and LUW-ID identify the user or application that
problem indicated by the reason code and preceding encountered the problem.
messages, and correct it, if possible.
The value of the LUWID is a'logical-unit-of-work-id' that
Problem Determination: See Problem Determination is assigned to the thread, followed by an '=' sign and a
for message DSNP001I for this information. token value, which can be used in place of
'logical-unit-of-work-id' in any DB2 command that
accepts 'logical-unit-of-work-id' as input.
DSNP019I csect – REALLOCATE FAILED FOR
data-set-name. RC=rrrrrrrr Messages having the same connection ID, correlation
CONNECTION-ID=xxxxxxxx, ID, and LUWID relate to the same user. This makes it
CORRELATION-ID=yyyyyyyyyyyy, possible to scan a number of DSNP-prefixed messages
LUW-ID=logical-unit-of-work-id =token and group activities involving a given user. Correlation
IDs beginning with '0nn', where 'nn' is a number, identify
Explanation: After a successful ALTER system agents.
REMOVEVOLUMES request, the data space manager
(DSM) subcomponent of DB2 was unable to reallocate This message is issued by the following CSECTs:
the data set for the reason indicated by RC. (See DSNPATS0 DSNPSCT0 DSNPSCTC DSNPRNM0
“Part 4. DB2 Codes” on page 707.) The connection ID,
Severity: 8 (error)
correlation ID, and logical-unit-of-work ID (LUW-ID)
identify the user or application that encountered the System Action: No action is taken with the named
problem. data set. An error code is returned and a dump is not
taken.
A LUW-ID of '*' indicates that the thread does not have
a LUW-ID. If the LUW-ID is not an '*', the value is a Operator Response: Notify the system programmer.
logical-unit-of-work-id that is assigned to the thread
System Programmer Response: Delete the named
followed by an '=' sign and a token value, which can be
data set and define it with the correct attributes.
used in place of logical-unit-of-work-id in any DB2
command that accepts logical-unit-of-work-id as input. Problem Determination: Obtain an access method
services LISTCAT for the named data set’s attributes.
Messages that have the same connection ID, correlation
Refer to Part 2 (Volume 1) of DB2 Administration Guide
ID, and LUW-ID relate to the same user. This makes it
for the correct data set definition attributes.
possible to scan a number of DSNP-prefixed messages
and group activities involving a given user. Correlation
IDs beginning with '0nn', where 'nn' is a number, identify DSNP021I csect-name EXTEND NOTIFY FAILED
system agents. FOR data-set-name, SC=ssssssss,
NOTESC=nnnnnnnn,
System Action: Operation continues.
CONNECTION-ID=xxxxxxxx,
Operator Response: This message is directed to the CORRELATION-ID=yyyyyyyyyyyy,
database administrator or the system administrator. LUW-ID=logical-unit-of-work-id=token
Bring it to that person’s attention if it appears on the
Explanation: This is an internal error. The connection
MVS operator’s console.
ID, correlation ID, and logical-unit-of-work ID (LUW-ID)
System Programmer Response: The data set and identify the user or application that encountered the
corresponding page set piece or partition can usually problem.
continue to be used by the DB2 subsystem. However,
An LUW-ID of '*' indicates that the thread does not have
they should be stopped and restarted at the earliest
an LUW-ID. If the LUW-ID is not an '*', the value is a
possible time in order to synchronize the allocation
logical-unit-of-work-id that is assigned to the thread
control blocks with the integrated catalog facility (ICF)
followed by an '=' sign and a token value, which can be
catalog volume list.
used in place of the logical-unit-of-work-id in any DB2
Problem Determination: See Problem Determination command that accepts the logical-unit-of-work-id as
for message DSNP001I for this information. input.
Messages that have the same connection ID, correlation
Chapter 15. DB2 Messages 363
DSNP022I • DSNP027I
ID, and LUW-ID relate to the same user. This makes it due to an attempt to delete a regular table or index
possible to scan a number of DSNP-prefixed messages space data set. Refer to Part 2 of DB2 SQL Reference
and group activities involving a given user. Correlation for information about online REORG. The connection
IDs beginning with '0nn', where 'nn' is a number, identify ID, correlation ID, and logical unit of work ID (LUWID)
system agents. identify the user or application that encountered the
problem. Correlation IDs beginning with '0nn', where 'nn'
If message DSNT376I was received before message
is a number, identify system agents.
DSNP021I, the notify request failed because of a
timeout condition. The value of the LUWID is assigned to the thread
followed by an '=' sign and a token value, that can be
System Action: The current SQL statement or the unit
used in place of the LUWID in any DB2 command that
of recovery that issued the request might be terminated.
accepts it as input.
Problem Determination: Obtain the console sheet
Messages that have the same connection ID, correlation
and a dump. A GTF trace might also be required.
ID, and LUWID relate to the same user. This makes it
Refer to Part 2 of DB2 Diagnosis Guide and Reference possible to scan a number of DSNP-prefixed messages
for information on identifying and reporting the problem. and group activities involving a given user.
System Action: No action is taken with the named
DSNP022I csect-name EXTEND DBET data set. An error code is returned and a dump is not
RECORDING FAILED FOR taken.
data-set-name, RC=rrrrrrrr, SC=ssssssss,
Operator Response: Notify the system programmer.
DBETSC=nnnnnnnn,
CONNECTION-ID=xxxxxxxx, System Programmer Response: Determine the
CORRELATION-ID=yyyyyyyyyyyy, failing environment. Refer to Part 2 of DB2 Diagnosis
LUW-ID=logical-unit-of-work-id=token Guide and Reference for information on identifying and
reporting the problem.
Explanation: This is an internal error. The connection
ID, correlation ID, and logical-unit-of-work ID (LUW-ID) Problem Determination: This is an internal error in
identify the user or application that encountered the the online REORG of utility. See the 'Problem
problem. Determination' section of message DSNP001I for this
information.
An LUW-ID of '*' indicates that the thread does not have
an LUW-ID. If the LUW-ID is not an '*', the value is a
logical-unit-of-work-id that is assigned to the thread DSNP027I csect-name RENAME FAILED OLD
followed by an '=' sign and a token value, which can be DATASET=data-set-name, NEW
used in place of the logical-unit-of-work-id in any DB2 DATASET=data-set-name, RC=rrrrrrrr,
command that accepts the logical-unit-of-work-id as CONNECTION-ID=xxxxxxxx,
input. CORRELATION-ID=yyyyyyyyyyyy,
LUW-ID=logical-unit-of-work-id=token
Messages that have the same connection ID, correlation
ID, and LUW-ID relate to the same user. This makes it Explanation: An attempt to alter the data set name
possible to scan a number of DSNP-prefixed messages failed. The connection ID, correlation ID, and logical unit
and group activities involving a given user. Correlation of work ID (LUWID) identify the user or application that
IDs beginning with '0nn', where 'nn' is a number, identify encountered the problem. Correlation IDs beginning with
system agents. '0nn', where 'nn' is a number, identify system agents.
System Action: The current SQL statement or the unit The value of the LUWID is assigned to the thread
of recovery that issued the request might be terminated. followed by an '=' sign and a token value, that can be
used in place of the LUWID in any DB2 command that
Problem Determination: Obtain the console sheet
accepts it as input.
and a dump. A GTF trace might also be required.
Messages that have the same connection ID, correlation
Refer to Part 2 of DB2 Diagnosis Guide and Reference
ID, and LUWID relate to the same user. This makes it
for information on identifying and reporting the problem.
possible to scan a number of DSNP-prefixed messages
and group activities involving a given user.
DSNP026I csect-name DATASET IS NOT
Severity: 8 (error)
ALLOWED TO BE DELETED
data-set-name, RC=rrrrrrrr, System Action: DB2 terminates its actions associated
CONNECTION-ID=xxxxxxxx, with the current SQL request. DB2 might terminate the
CORRELATION-ID=yyyyyyyyyyyy, current SQL request or the unit of recovery that issued
LUW-ID=logical-unit-of-work-id=token the request.
Explanation: During clean up of the shadow data set Operator Response: This message is directed to the
in the final step of online REORG, an error is detected database administrator or the system administrator.
364 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNP028I • DSNP030I
Bring it to that person's attention if it appears on the For all other reason codes (HSMRSN), refer to the
MVS operator's console. The installation should DFSMS/MVS: DFSMShsm Managing Your Own Data
consider directing DB2 messages to a console other for an explanation of HSM user messages. The HSM
than the operator's console. user messages can be determined by appending the
value in the HSMRC field of this message to ARC1100I
System Programmer Response: If you suspect an
(that is, HSMRC=12, HSM message is ARC1112I). The
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
HSMRSN reason code is referenced in the ARC1100I
and Reference for information on identifying and
messages.
reporting the problem.
Problem Determination: See 'Problem Determination'
| DSNP030I csect-name THE CURRENT EXTENT
for message DSNP001I for this information.
| REACHES THE LAST VOLUME FOR
| data-set-name. CONNECTION-
DSNP028I csect-name HSM RECALL FAILED FOR | ID=xxxxxxxx, CORRELATION-
DSNAME = dsn | ID=yyyyyyyyyyyy, LUW-ID=logical-unit-of-
HSMRC=rrrrrrrr,HSMRSN=ssssssss | work-id=token
CONNECTION ID=xxxxxxxx,
| Explanation: This message indicates that the last
CORRELATION ID=yyyyyyyyyyyy,
| volume to which the data set data-set-name can extend
LUW-ID=logical-unit-of-work-id =token
| has been reached. You cannot add more volumes if the
Explanation: This message indicates that a required | current volume runs out of space.
data set was migrated by HSM and an attempt to recall
| The connection, correlation, and logical-unit-of-work IDs
the data set failed, preventing DB2 from accessing the
| identify the user or application that encountered the
data set. The HSMRC and HSMRSN fields can be used
| problem. Correlation IDs beginning with '0nn', where 'nn'
to determine the HSM failure. See Problem
| is a number, identify system agents.
Determination below. The connection ID, correlation ID,
and 'logical-unit-of-work ID' (LUW-ID) identify the user | A LUW-ID of '*' indicates that the thread does not have
or application that encountered the problem. | a LUW-ID. If the LUW-ID is not an '*', the value is a
| logical-unit-of-work-id that is assigned to the thread
A LUW-ID of '*' indicates that the thread does not have
| followed by an '=' sign and a token value, which can be
a LUW-ID. If the LUW-ID is not an '*', the value is a
| used in place of logical-unit-of-work-id in any DB2
'logical-unit-of-work-id' that is assigned to the thread
| command that accepts logical-unit-of-work-id as input.
followed by an '=' sign and a token value, which can be
used in place of 'logical-unit-of-work-id' in any DB2 | Messages that have the same connection ID, correlation
command that accepts 'logical-unit-of-work-id' as input. | ID, and LUW-ID relate to the same user. This makes it
| possible to scan a number of DSNP-prefixed messages
Messages that have the same connection ID, correlation
| and group activities involving a given user.
ID, and LUW-ID relate to the same user. This makes it
possible to scan a number of DSNP-prefixed messages | Severity: 0 (informational)
and group activities involving a given user. Correlation
IDs beginning with '0nn', where 'nn' is a number, identify
| System Action: If sufficient space in current volume is
system agents.
| available for the current request, DB2 continues.
| Otherwise, message DSNP007I is issued, and the
System Action: DSM terminates its action with the | current SQL request fails.
associated data set. Higher level functions that issued
the recall request might terminate.
| Operator Response: For more information, issue an
| MVS WRITELOG operator command (for example, 'W
Operator Response: Notify the system programmer. | A') to obtain MVS SYSLOG output. The SYSLOG
| sometimes contains VSAM or media manager
System Programmer Response: Investigate the
| messages that might be helpful in determining why
reason for the HSM recall failure. Use the information in
| space could not be allocated.
this message to help resolve this problem. Additional
messages on the MVS operator's console might be | System Programmer Response: Depending on what
associated with this message. | information is available in the access method services
| or VSAM messages preceding this one, try one of the
Problem Determination: If the HSMRSN is 999, refer
| following:
to the following list for the explanation:
| v If you do not anticipate further extension of this table
HSMRC Description | space or index, ignore the message.
4 HSM is not active. | v If the table space or index is backed by
8 No storage is available for MWE in CSA. | SMS-managed data sets, use LISTCAT to choose
36 Input MWE is not within user storage. | another SMS storage group that has more space
40 Allocated amount of CSA for MWEs was | available and recover or reorganize the table space
exceeded. | or index into the new SMS storage group.
100 There was an invalid function used.
Chapter 15. DB2 Messages 365
DSNP031I
| v If the table space or index is DB2-managed but is not System Programmer Response: Based on the
| SMS-managed, rearrange the DB2 storage group information that might be available in the access
| volume list by shifting volumes with free space or by method services or VSAM messages preceding this
| adding new volumes. Use the SQL statements one, try one of the following actions:
| ALTER STOGROUP ADD VOLUMES and ALTER v If you do not anticipate further extension of this table
| STOGROUP REMOVE VOLUMES and then recover space or index, ignore the message.
| or reorganize the table space or index. v If the table space or index is DB2-managed and has
| v If the table space or index is user-managed and not not yet reached the maximum number of extents,
| SMS-managed, delete and redefine the data set with obtain an access method services LISTCAT for the
| more space and then recover or reorganize the table named data set’s to see how the extensions are
| space or index. distributed. Your options then include:
| Problem Determination: Obtain an access method – If there are multiple small extents, you can use the
| services LISTCAT for the named data set’s VOLUME SQL statement ALTER TABLESPACE SECQTY to
| list for current extent space distribution of volumes. alter to a larger secondary space allocation
quantity.
| See the Problem Determination section of message
– Otherwise, use the ALTER STOGROUP statement
| DSNP001I for more information.
to add volumes to the storage group (up to 133 of
them).
DSNP031I csect-name CURRENT SPACE HAS cc v If the table space or index is user-managed and has
EXTENTS FOR data-set-name. THE not yet reached the maximum number of extents,
MAXIMUM EXTENTS WITH DFSMS vv.rr issue the access method services command ALTER
IS mm. CONNECTION-ID=xxxxxxxx, ADDVOLUMES to provide additional volumes (up to
CORRELATION-ID=yyyyyyyyyyyy, 59 of them).
LUW-ID=logical-unit-of-work-id=token v If the data set is at the maximum number of extents,
recover or reorganize the table space or index into a
Explanation: This message indicates that data set data set or data sets having larger primary and
data-set-name has almost reached the maximum secondary values. This process is discussed in Part 2
number of extents. The maximum number is indicated (Volume 1) of DB2 Administration Guide.
by mm. You cannot add more volumes if the current
volume runs out of space. Problem Determination: Obtain an access method
services LISTCAT for the named data set’s VOLUME
The current version and release of DFSMS are list for the extent space distribution.
indicated by vv and rr.
See the Problem Determination section of message
The connection, correlation, and logical-unit-of-work IDs DSNP001I for more information.
identify the user or application that encountered the
problem. Correlation IDs beginning with '0nn', where 'nn'
is a number, identify system agents.
A LUW-ID of '*' indicates that the thread does not have
a LUW-ID. If the LUW-ID is not an '*', the value is a
logical-unit-of-work-id that is assigned to the thread
followed by an '=' sign and a token value, which can be
used in place of logical-unit-of-work-id in any DB2
command that accepts logical-unit-of-work-id as input.
Messages that have the same connection ID, correlation
ID, and LUW-ID relate to the same user. This makes it
possible to scan a number of DSNP-prefixed messages
and group activities involving a given user.
Severity: 0 (informational)
System Action: DB2 continues. If the table space or
index space is not able to extend when needed,
Message DSNP007I is issued and the current SQL
request fails.
Operator Response: For more information, issue an
MVS WRITELOG operator command (for example, 'W
A') to obtain MVS SYSLOG output. The SYSLOG
sometimes contains VSAM or media manager
messages that might be helpful in determining why
space could not be allocated.
366 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 16. DSNR... Messages
The following information messages indicate the progress of DB2 through a restart
process.
completed phase 1 of the commit process nor began
DSNR001I RESTART INITIATED
the process of backing out. These must undergo
Explanation: This message delimits the beginning of backward recovery to restore resources modified by
the restart process within startup. The phases of restart them to their previous consistent state.
are about to begin. These phases are necessary to
The IN ABORT count specifies the number that were in
restore the operational environment to that which
the process of backing out. These must undergo
existed at the time of the previous termination and to
backward recovery to restore resources modified by
perform any recovery actions that may be necessary to
them to their previous consistent state.
return DB2-managed resources to a consistent state.
The POSTPONED ABORT count specifies the number
whose backout was postponed in an earlier restart
DSNR002I RESTART COMPLETED
process and not attended to prior to this restart process.
Explanation: This message delimits the completion of These must undergo backward recovery after
the restart process within startup. completion of restart, via the -RECOVER POSTPONED
command, to restore resources modified by them to
their previous consistent state.
DSNR003I RESTART...PRIOR CHECKPOINT
RBA=xxxxxxxxxxxx This message is issued by the following CSECT:
DSNRRCSR
Explanation: The message indicates the first phase of
the restart process is in progress and identifies (as
'xxxxxxxxxxxx') the log positioning RBA of the DSNR005I RESTART...COUNTS AFTER FORWARD
checkpoint from which the restart process will obtain its RECOVERY IN COMMIT=nnnn,
initial recovery information. INDOUBT=nnnn
Explanation: The message indicates the completion of
DSNR004I RESTART...UR STATUS COUNTS IN the forward recovery restart phase. The counts indicate
COMMIT=nnnn, INDOUBT=nnnn, the number of units of work whose recovery actions
INFLIGHT=nnnn, IN ABORT=nnnn could not be completed during the phase. Typically,
those in an IN COMMIT state remain because the
Explanation: This message indicates the completion
recovery actions of some subcomponents have not
of the first phase of the restart process. The counts
been completed. Those units of work in an INDOUBT
indicate the number of units of work whose execution
state will remain until connection is made with the
state during a previous DB2 termination was such that
subsystem that acts as their commit coordinator.
(to ensure DB2 resource consistency) some recovery
action must be performed during this restart process or Operator Response: No action is required unless the
(by the user) upon completion of the restart process. conditions persist beyond some installation-defined
The counts of IN COMMIT, INDOUBT, INFLIGHT and IN period of time. Recovery action will be initiated when
ABORT may provide an indication of the time required the resource is brought online. Indoubt resolution will be
to perform the remaining two phases of restart (forward initiated as part of the process of reconnecting the
and backward recovery). The counts of POSTPONED subsystems.
ABORT URs may provide an indication of the time
required to perform -RECOVER POSTPONED
DSNR006I RESTART...COUNTS AFTER
processing.
BACKWARD RECOVERY
The IN COMMIT count specifies the number that had INFLIGHT=nnnn, IN ABORT=nnnn,
started but not completed phase 2 of the commit POSTPONED ABORT=nnnn
process. These must undergo forward recovery to
Explanation: The message indicates the completion of
complete the commit process.
the backward recovery restart phase. The counts
The INDOUBT count specifies the number that were indicate the number of units of work whose recovery
interrupted between phase 1 and phase 2 of the commit actions could not be completed during the phase.
process. These must undergo forward recovery to
When INFLIGHT or IN ABORT URs do not complete
ensure resources modified by them are unavailable until
backout during restart, they are converted to
their indoubt status is resolved.
POSTPONED ABORT status, so the INFLIGHT and IN
The INFLIGHT count specifies the number that neither ABORT counts should be zero. The POSTPONED
© Copyright IBM Corp. 1982, 2001 367
DSNR007I • DSNR009I
ABORT count indicates the number of URs for which A INABORT: The UR was in the
backout work still exits (from this or a previous restart). 'must-complete' phase of abort, and is
yet to be completed.
Backout work for the POSTPONED ABORT URs should
be completed by the user (via the -RECOVER C INCOMMIT: The UR was in the
POSTPONED command), once DB2 restart has 'must-complete' phase of commit, and
completed. is yet to be completed.
This message is issued by the following CSECT: D INDOUBT: The UR had completed the
DSNRRAUB first phase of commit, but DB2 had
not received the second phase
Operator Response: No action is required unless the
instruction. The UR must be
condition persists beyond some installation-defined
remembered so it can be resolved
period of time. Recovery action will be initiated when
when the owning subsystem
the resource collection is brought online.
reattaches.
F INFLIGHT: The UR had not completed
DSNR007I RESTART...STATUS TABLE
the first phase of commit, and will be
Explanation: This message precedes a table showing backed out.
the status of units of recovery (URs) after each restart
P POSTPONED ABORT: The UR has
phase. The message and the table will accompany the
not yet completed backout. Backout
DSNR004I, DSNR005I, or DSNR006I message after
must be completed outside of DB2
each nested phase. At the end of the current status
restart by means of the -RECOVER
rebuild phase, it shows the status of any URs that
POSTPONED command.
require processing. At the end of the forward recovery
and backoutphases, it shows the status of only those URID UR identifier, the log RBA of the beginning of
URs which needed processing but were not processed. this unit of work. It is the earliest RBA required
The table helps to identify the URs that were active to process the UR during Restart.
when DB2 came down, and to determine the log scope
DAY The day the UR was created, in the format
required to bring DB2 up.
'ddd'. It is approximately the time of the first
The format of the table is shown below: SQL statement of the application or the first
T CONID CORRID AUTHORIZATION ID PLAN S URID DAY TIME SQL statement following a commit point.
TIME The time the UR was created, in the format 'hh
where the columns contain the following information: mm ss '. It is approximately the time of the first
T Connection type. The values may be: SQL statement of the application or the first
SQL statement following a commit point.
B Batch: a batch program or QMF user.
I Internal: a system service being This message is issued by the following CSECT:
performed on some user’s behalf. DSNRUDIS
S Subsystem: work that originated from
an attached subsystem, either CICS DSNR009I STORAGE IS NOT AVAILABLE FOR
or IMS/VS. THE UR DISPLAY TABLE, THE SIZE
REQUESTED = xxxx, STORAGE
CONID Connection identifier for related URs. Batch MANAGER REASON CODE = yyyyyyyy
connections are not related to any other
connection. Subsystem connections with the Explanation: There was not enough storage available
same identifier indicate URs that originated during the creation of the recoverable UR (RURE)
from the same subsystem. display table (DSNDRUDT).
CORRID System Action: The system continues to restart but
Correlation identifier; unique within a the RESTART... STATUS TABLE is not displayed.
subsystem connection, it relates a UR to a System Programmer Response: Increase the region
particular CICS or IMS/VS transaction. size of the ssnmMSTR address space before restarting
AUTHORIZATION ID DB2 again.
Authorization identifier of the user for whom Operator Response: Save the console output and
this UR was created. inform the system programmer.
PLAN Name of the plan allocated to the UR. Problem Determination: The size requested is
S Restart status of the UR. When DB2 came approximately 110 bytes for each unit of recovery (UR).
down, the UR was in one of these situations: See the message DSNR004I to determine the total
number of URs to process. Then get the 00E2xxxx
368 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNR010I • DSNR016I
reason code from the DSNR009I header. Use these two Error codes other than X'0006' indicate an application
numbers to determine the reason for the shortage. program check of some type. Code X'0006' indicates an
error attempting to locate the table text. The trace entry
for DSNRUDIS contains the return and reason codes
DSNR010I AN ERROR OCCURRED IN THE RURE
from the Get Text request. That information should be
STATUS TABLE SORT/TRANSLATE
used to fill in the problem description.
MODULE (DSNRUSOR), THE ERROR
LOCATION CODE = xxxx
DSNR014I EXCLUDED RURE TABLE
Explanation: There was an error in processing the
RURE display table. One of these ERROR LOCATION Explanation: This is a list of RUREs which are being
CODES tells what function the module was attempting bypassed because of the conditional restart. Either they
to perform: were to be processed in a phase that was bypassed or
X'0001' Trace entry to the module they were outside the log range.
X'0002' Sort the recoverable UR display table
The following shows the format of the table headings.
X'0003' Translate the recoverable UR table
See message DSNR007I for an explanation of the table
X'0004' Convert the store clock value for display
columns.
X'0005' Trace exit from the module
T CONID CORRID AUTHORIZATION ID PLAN S URID DAY TIME
System Action: The system continues to restart but
the RESTART... STATUS TABLE is not displayed. System Action: Restart continues.
System Programmer Response: Use the error code
in the message to fill in the problem description. DSNR015I THE CHKPTRBA xxxxxxxxxxxx
SPECIFIED IN THE CRCR IS INVALID
Operator Response: Save the console output and
inform the system programmer. Explanation: The checkpoint RBA specified in the
conditional restart control record (CRCR) is either not
Problem Determination: The ERROR CODE tells the available or is not a begin checkpoint record.
problem area and should be used in the problem
description. A record was added to the SYS1.LOGREC System Action: Restart is abended with reason code
that contains the PSW and module at the time of the '00D99001'.
error. This error indicates an application program check Operator Response: Inform the system programmer.
of some type.
System Programmer Response: By specifying the
STARTRBA and/or ENDRBA on the CRESTART control
DSNR011I AN ERROR OCCURRED IN THE RURE statement, change log inventory (DSNJU003) utility
STATUS TABLE DISPLAY MODULE selects an appropriate RBA.
(DSNRUDIS), THE ERROR LOCATION
CODE = xxxx Problem Determination: Print the complete
checkpoint records queue by using the print log map
Explanation: There was an error in processing the (DSNJU004) utility. Select a checkpoint RBA from this
RURE display table. One of these ERROR LOCATION queue or let the change log inventory (DSNJU003)
CODES tells what function the module was attempting utility make the selection.
to perform:
X'0001' Trace entry to the module
X'0002' Build header for the display table DSNR016I STARTRBA xxxxxxxxxxxx VALIDATION
X'0003' Build entries for the display table FAILED
X'0004' Call DSNRWTO to display the table
Explanation: A scan from the STARTRBA failed to
X'0005' Trace exit from the module
find a complete log record. Either the entire log was
X'0006' Get message text
scanned and no complete record was found, or the log
System Action: The system continues to restart but manager found an invalid log record. The log manager
the RESTART... STATUS TABLE is not displayed. sends the error messages to the console indicating a
bad log record.
System Programmer Response: Use the error code
in the message to fill in the problem description. System Action: Restart abends.
Operator Response: Save the console output and Operator Response: Record the log manager
inform the system programmer. message numbers and inform the system programmer.
Problem Determination: The ERROR CODE System Programmer Response: Use DSN1LOGP to
describes the problem area and should be used in the determine a STARTRBA to use for restart. The recovery
problem description. A record was added to the manager uses the STARTRBA as a starting point for its
SYS1.LOGREC containing the value DSNRUDIS, and search of the beginning of a valid log record.
the PSW and CSECT at the time of the error. This error
indicates an application program check of some type.
Chapter 16. DB2 Messages 369
DSNR017I • DSNR022I
-STOP DB2 MODE(QUIESCE) command and it stopped
DSNR017I RESTART IS BEING TERMINATED
with no indoubt units of recovery and no distributed
BECAUSE OF CSRONLY
resynchronization responsibility, then you can reply
SPECIFICATION IN CRCR
'QUIESCED' to this message. Replying 'QUIESCED' to
Explanation: The restart procedure only completed this message causes message DSNR030I to be issued
the first phase of startup. The status displayed during as a reminder that group restart will continue without
this partial restart can be used to build the conditional using the log from the identified member.
restart control record (CRCR).
System Action: This group member waits for the
System Action: Restart is abended. identified member to be started or for a valid reply to
this message.
System Programmer Response: To prevent the
restart control record from being reused during the next v If the identified member is started, group restart
restart attempt, the current restart control record must continues.
be canceled. Use the change log inventory (DSNJU003) v If the reply is 'NO', this DB2 terminates with a reason
CRESTART CANCEL option, or create a new restart code of 00D900E1.
control record. The newly created restart control record v If the reply is 'QUIESCED', group restart continues
will automatically cancel the previous record. without using the log from the identified member.
DSNR018I csect-name RESTART...BACKWARD DSNR021I csect-name DB2 SUBSYSTEM MUST
RECOVERY PROCESSED FROM RBA PERFORM GROUP RESTART FOR
ffffffffffff TO RBA tttttttttttt PEER MEMBERS
Explanation: This message indicates the range of log Explanation: This DB2 subsystem must perform the
processed during the backward phase of RESTART group restart phase to recover either the shared
when postponed backout processing has been communications area (SCA) or the retained locks for
requested. Processing began with the LR of RBA nonstarting members in the data sharing group.
ffffffffffff and proceeded backwards to the LR of RBA
tttttttttttt. This message marks the beginning of group restart
processing for peer members. Messages DSNR023I
System Action: This message is followed by and DSNR024I or messages DSNR025I and DSNR026I
messages DSNR006I and DSNR007I. The former tells are issued for each peer that is processed by this DB2
how many URs had some backout work postponed. The subsystem. Message DSNR022I marks the end of
latter, identifies the postponed abort URs. The amount group restart processing for peer members.
of log that need to be processed to complete backout
processing for the postponed abort URs can be gauged This message is issued before this DB2 member enters
by comparing the RBA reached during RESTART’s the group restart process. The group restart process is
backward processing (RBA tttttttttttt), and the URIDs of synchronized among all group members that are
the postponed abort URs. starting and therefore participating in this group restart.
After this DB2 member synchronizes with other
members, it is possible that no peer processing will be
DSNR020I csect-name START MEMBER member, necessary; in that case message DSNR022I
OR REPLY 'NO' OR 'QUIESCED' immediately follows this message.
Explanation: During a group restart, the group If it is necessary to recover both the SCA and retained
member issuing this message attempted to access the locks, this message is issued twice; once for SCA
BSDS for member member, and either was not able to recovery and again for the recovery of the retained
access the BSDS, or discovered that the BSDS was locks.
modified by the change log inventory (DSNJU003) utility
since that member was last started. In either case, this System Action: The subsystem begins group restart
DB2 is not able to perform peer restart for member processing.
member.
For group restart to continue, the identified member DSNR022I csect-name DB2 SUBSYSTEM HAS
must be started. COMPLETED GROUP RESTART FOR
PEER MEMBERS
If it is not possible to start the other member and you
want to terminate this group restart, you can reply 'NO' Explanation: This DB2 subsystem, which previously
to this message. Replying 'NO' to this message causes issued message DSNR021I, completed the group
this DB2 to terminate with a reason code of 00D900E1. restart phase to recover the shared communications
You then have to reply 'NO' to this message for all area (SCA) or retained locks for nonstarting DB2
remaining members participating in this group restart. members in the data sharing group.
If you are sure that the identified member was quiesced System Action: The subsystem continues with the
the last time it was started, that is, it was stopped with a next restart phase of its own subsystem.
370 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNR023I • DSNR032E
DSNR023I csect-name GROUP RESTART DSNR030I csect-name WILL CONTINUE WITHOUT
INITIATED TO RECOVER THE SCA FOR THE member MEMBER'S LOG, REPLY
GROUP MEMBER membname 'YES' OR 'NO'
Explanation: The DB2 subsystem that issued this Explanation: The reply to message DSNR020I was
message is performing the group restart phase to 'QUIESCED'. This message is issued as a reminder that
recover the shared communications area (SCA) for group restart will continue without using the log from
nonstarting member membname of the data sharing the identified member.
group.
If you are sure that the identified member was quiesced
This message is followed by message DSNR024I after the last time it was started, that is, it was stopped with a
the group restart phase to recover the SCA for the -STOP DB2 MODE(QUIESCE) command and it stopped
identified member is complete. with no indoubt units of recovery and no distributed
resynchronization responsibility, then reply 'YES';
System Action: The subsystem continues the group
otherwise, reply 'NO'.
restart process.
System Action: This group member waits for a valid
reply to this message.
DSNR024I csect-name GROUP RESTART
COMPLETED TO RECOVER THE SCA v If the reply is 'YES', group restart continues without
FOR GROUP MEMBER membname using the log from the identified member.
v If the reply is 'NO', message DSNR020I is reissued to
Explanation: The DB2 subsystem that issued this
allow you to enter a different response.
message completed the group restart phase to recover
the shared communications area (SCA) for member
membname of the data sharing group. DSNR031I csect-name PROCESSING LOG
RECORD AT RBA rba1 TO RBA rba1
This message is issued only if messages DSNR021I
and DSNR023I were issued. Explanation: This message is produced periodically
during the forward and backward processing phases of
System Action: The subsystem continues the group
restart. The RBAs presented in this message can be
restart process.
used to monitor the progress of the phases of restart.
Forward processing occurs between messages
DSNR025I csect-name GROUP RESTART
DSNR004I and DSNR005I. During forward processing,
INITIATED TO RECOVER RETAINED
the log is read in a forward direction.
LOCKS FOR GROUP MEMBER
membname Backward processing occurs between messages
DSNR005I and DSNR006I. During backward
Explanation: The DB2 subsystem that issued this
processing, the log is read in a backward direction and
message is performing the group restart phase to
will stop reading at the RBA matching the URID of the
recover the retained locks for nonstarting member
oldest in-flight or in-abort UR.
membname of the data sharing group.
rba1 is the RBA of the log record currently being
This message is followed by message DSNR026I after
processed. rba2 is the RBA of the last log record that
the group restart phase to recover the retained locks for
will be read in this phase of restart.
the identified member is complete.
System Action: DB2 restart continues.
System Action: The subsystem continues the group
restart process. User Response: This is an information only message.
DSNR026I csect-name GROUP RESTART DSNR032E csect-name DB2 IS STARTING AT
COMPLETED TO RECOVER RETAINED RELEASE LEVEL code-level-1, WHICH
LOCKS FOR GROUP MEMBER IS NOT COMPATIBLE WITH RELEASE
membname LEVEL code-level-2
Explanation: The DB2 subsystem that issued this Explanation: The DB2 you tried to start is not at the
message completed the group restart phase to recover proper code release, or does not have the correct
the retained locks for member membname of the data fallback/coexistence SPE applied.
sharing group.
code-level-1 and code-level-2 are a string of three
This message is issued only if messages DSNR021I numeric characters as follows:
and DSNR025I were issued. v Version
v Release
System Action: The subsystem continues the group
v Modification level
restart process.
Chapter 16. DB2 Messages 371
DSNR033E • DSNR035I
code-level-1 System Action: After detecting the first member with
The current release level of the starting DB2. which it cannot coexist, DB2 terminates with reason
code 00D900FA.
code-level-2
One of the following: System Programmer Response: If you want to start
v In non-data-sharing, the highest release with a higher release level of DB2, you must ensure that all
which this DB2 has ever been started. active members in the group have the proper SPE
v In a data sharing environment, the highest applied. If you intended to start a lower release level of
release with which any DB2 in the data of DB2, make sure your startup procedure is pointing to
sharing group has ever been started. This is the correct set of load libraries.
known as the group release level.
For more information about what SPE is needed, see
the program directory or preventive service planning
This message can occur in the following situations:
(PSP) updates.
v The starting DB2 fell back from a later release and
does not have the proper fallback SPE applied.
DSNR034E csect-name THERE CANNOT BE MORE
v The starting DB2 does not have the proper
THAN TWO RELEASE LEVELS OF DB2
coexistence SPE to start in a data sharing group,
RUNNING IN THE GROUP
which is at the higher release level.
v The starting DB2 is at a release in which coexistence Explanation: You attempted to start a DB2 that was at
with the current group release level is not supported. a release level that cannot coexist in the data sharing
group. There are already two different releases of DB2
System Action: DB2 terminates with reason code currently running in the data sharing group.
00D900FA.
System Action: DB2 terminates.
System Programmer Response: Verify that:
System Programmer Response: If you are sure that
v Coexistence is supported between the releases you
the startup procedure is pointing to the correct set of
are trying to run.
load libraries, you must stop any DB2 subsystems that
v The startup procedure is pointing to the correct set of cannot coexist with the one you are attempting to start.
load libraries.
See DB2 Data Sharing: Planning and Administration for
v The correct SPE has been applied.
more information about release coexistence in a data
sharing group.
For more information about what SPE is needed, see
the program directory or preventative service planning
(PSP) undates. DSNR035I csect-name WARNING - UNCOMMITTED
UR AFTER nn CHECKPOINTS -
CORRELATION NAME = xxxxxxxxxxxx
DSNR033E csect-name MEMBER member-name IS CONNECTION ID = yyyyyyyy LUWID =
AT RELEASE LEVEL code-level-1 logical-unit-of-work-id=token PLAN NAME
WHICH IS NOT COMPATIBLE WITH = xxxxxxxx AUTHID = xxxxxxx END
THE STARTING MEMBER AT RELEASE USER ID = xxxxxxxx TRANSACTION
LEVEL code-level-2 NAME = xxxxxxxx WORKSTATION
Explanation: The code level for the started DB2 NAME = xxxxxxxx
member and the starting DB2 member are not Explanation: This message indicates that during
compatible until you apply the correct SPE to the lower checkpoint, DB2 encountered an uncommitted UR that
level release. has an INFLIGHT status.
code-level-1 and code-level-2 are a string of three The value nn is cumulative, and it indicates the number
numeric characters as follows: of checkpoints taken since the beginning of the UR.
v Version CORRELATION name, CONNECTION ID, and LUWID
v Release together identify a thread associated with the UR. If the
v Modification level LUWID is an '*', it indicates that the thread originated at
code-level-1 this site. token is a unique token number associated
The release level of the active DB2 member with the LUWID. PLAN NAME and AUTHID further
member-name. identify the thread associated with the UR. If the thread
was created with client End User information, the End
code-level-2 User’s ID, TRANSACTION NAME, and WORKSTATION
The release level of the starting DB2. NAME will be displayed. Otherwise, these fields will
contain an '*'.
This message occurs when a starting DB2 member is at
a higher release than can coexist with an existing DB2 System Action: DB2 continues processing. If statistics
member. class 3 is turned on, IFCID 0313 is written.
372 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNR036I • DSNR038I
System Programmer Response: Consult with the port number, and DB2 startup continues.
application programmer to determine if this is a problem
Operator Response: Contact the system programmer.
UR. See Part 4 (Volume 1) of DB2 Administration Guide
for more information about problems caused by System Programmer Response: If the TCP/IP DRDA
uncommitted URs. If the UR is caused by an application port number was changed inadvertently, stop DB2
program, you can use CANCEL THREAD to delete the immediately. Use the change log inventory utility
UR, if necessary. If an uncommitted UR is deleted, DB2 (DSNJU003) to correct the PORT value, and restart
will undo the changes. The amount of time required for DB2.
this process depends on the amount of work done by
the UR. If this message reflects a change that you want to make
to DB2’s DRDA port number, no action is required. The
Programmer Response: Ensure that the application DRDA port number stored in the coupling facility is
commits frequently enough, or consult with your DB2 updated, and this new port number will be used when
administrator about decreasing the frequency of the DB2 validates each member’s DRDA port number.
check.
DSNR038I csect-name WARNING - THE TCP/IP
DSNR036I csect-name UNRESOLVED UR RESYNCHRONIZATION PORT NUMBER
ENCOUNTERED DURING CHECKPOINT IS CHANGED FROM port_1 TO port_2
- CORRELATION NAME = xxxxxxxxxxx
CONNECTION ID = yyyyyyyy LUWID = Explanation: The TCP/IP resynchronization port
logical-unit-of-work-id PLAN NAME = number obtained from the DDF record of the BSDS is
xxxxxxxx AUTHID = xxxxxxxx different than the value specified the last time DB2
started.
Explanation: DB2 has detected an INDOUBT unit of
recovery (UR) during a checkpoint. The purpose of this Changing the TCP/IP resynchronization port number
message is to remind the operator that an INDOUBT can cause problems during distributed 2-phase commit
UR or POSTPONED ABORT UR exists. processing. Remote DRDA partners record DB2’s
resynchronization port number in their recovery logs.
CORRELATION name, CONNECTION ID, and LUWID The resynchronization port number is used to reconnect
together identify a thread associated with the UR. If the to the appropriate DB2 member when communication
LUWID is an '*', it indicates that the thread originated at failures occur during 2-phase commit processing. If a
this site. PLAN NAME and AUTHID further identify the DB2 member changes its resynchronization port
thread associated with the indoubt UR. number, the remote DRDA partners may be unable to
resolve indoubt units of work.
System Action: DB2 continues processing. If statistics
class 3 is turned on, IFCID 0313 is written. port_1 The TCP/IP resynchronization port number that
was obtained from the DB2 BSDS during DB2
System Programmer Response: Consult with the
startup.
application programmer to determine whether this is a
problem UR. See Part 4 (Volume 1) of DB2 port_2 The TCP/IP resynchronization port number that
Administration Guide for more information about was obtained from the coupling facility during
resolving INDOUBT URs. DB2 startup. This is the TCP/IP
resynchronization port number that was used
the last time this member was started.
DSNR037I csect-name WARNING - THE TCP/IP
DRDA PORT NUMBER IS CHANGED System Action: DB2 accepts the new TCP/IP
FROM port_1 TO port_2 resynchronization port number, and DB2 startup
continues.
Explanation: The TCP/IP DRDA port number specified
in the DB2 BSDS is different from the value used the Operator Response: Contact the system programmer.
last time a member of the DB2 data sharing group
started. All members of a DB2 data sharing group must System Programmer Response: If the DB2
use the same TCP/IP DRDA port number. resynchronization port number was changed
inadvertently, stop DB2 immediately. Use the change
port_1 The TCP/IP DRDA port number that was log inventory utility (DSNJU003) to correct the
obtained from the DB2 BSDS during DB2 RESPORT value, and restart DB2.
startup.
If this message reflects a change that you want to make
port_2 The TCP/IP DRDA port number that was to DB2’s resynchronization port number, no action is
obtained from the coupling facility during DB2 required. The resynchronization port number stored in
startup. This is the TCP/IP DRDA port number the coupling facility for this member is updated, and this
that was used the last time a member of the new port number will be used when DB2 validates the
data sharing group was started. resynchronization port number for other DB2 members.
System Action: DB2 accepts the new TCP/IP DRDA
Chapter 16. DB2 Messages 373
DSNR039I • DSNR046I
DSNR039I csect-name WARNING - TCP/IP | DSNR042I csect-name WARNING - UR ROLLBACK
RESYNCHRONIZATION PORT NUMBER | HAS BEEN CANCELED AND IS
port_1 IS THE SAME AS MEMBER | INCOMPLETE FOR CORRELATION
member_name | NAME = corrid CONNECTION ID =
| connid AUTHID = authid PLAN NAME =
Explanation: The TCP/IP resynchronization port of the
| plan-name URID = urid
starting DB2 is the same as the member indicated by
member_name. | Explanation: DB2 issues this message when rollback
| for the indicated thread has been canceled by either the
port_1 The TCP/IP resynchronization port number that
| CANCEL THREAD NOBACKOUT command or the
was obtained from the DB2 BSDS during DB2
| RECOVER POSTPONED CANCEL command.
startup.
| System Action: Rollback processing for the thread
member_name
| stops and the unit of recovery is logged as canceled
The member name of the DB2 data sharing
| and complete.
member that used the same resynchronization
port number. | User Response: Examine the console for messages
| indicating what objects are being marked as
System Action: The TCP/IP port number specified in
| REFP,RECP; those objects will need to be recovered.
the BSDS is accepted, and DB2 startup continues.
Operator Response: Contact the system programmer.
| DSNR046I csect-name INCOMPLETE UNITS OF
System Programmer Response: Each member of the | RECOVERY EXIST FOR subsys
DB2 data sharing group should have a unique TCP/IP
| Explanation: This message is issued during DB2
resynchronization port number. Use the change log
| shutdown if any incomplete units of recovery exist for
inventory utility (DSNJU003) to specify a unique
| the referenced member of a data sharing group. The
RESPORT value for this DB2 member and the DB2
| message indicates that retained locks will be held by
member identified by member_name.
| subsystem subsys.
| System Action: DB2 shutdown continues normally.
DSNR040I csect-name TRACKER RESTART
ENDLRSN lrsn DOES NOT MATCH | User Response: Restart DB2 and resolve the
ENDLRSN lrsn ASSOCIATED WITH THE | incomplete units of recovery to release the retained
DATA SHARING GROUP | locks held by subsystem subsys.
Explanation: In a data sharing environment, a
TRKRSITE DB2 will not restart if it detects
inconsistencies in the reported values for ENDLRSN.
The ENDLRSN specified on the Conditional Restart
Control Record does not match the ENDLRSN in the
system communications area (SCA) structure for the
data sharing group.
System Action: DB2 startup terminates.
Operator Response: Collect the SYS1.LOGREC and
SVC dump, and contact the system programmer.
System Programmer Response: If the ENDLRSN
value for this member is incorrect, take the following
actions:
v Restore the BSDS and Logs for his Tracker DB2 from
the primary DB2
v Ensure the Conditional Restart Control Record is
correct
v Restart DB2
If the ENDLRSN value in the SCA is incorrect, delete
the SCA structure and restart all members of the
TRKRSITE data sharing group with the same
ENDLRSN.
374 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 17. DSNT... Messages
Messages issued by DSNTINST, DSNTINS1, and DSNTINS2 installation CLISTs
have an internal severity level as follows:
0 Successful execution: CLIST progress and tracing messages (processing
continues)
4 Warning: some adjustments might be made by the installation CLISTs
(processing and JCL editing continues)
8 Error: unable to continue (no JCL is edited)
record was read by the recovery log manager (RLM)
DSNT101I A VSAM ERROR HAS BEEN
subcomponent. This is a DB2 error.
ENCOUNTERED WHILE CSECT
DSNTSTR2 WAS READING THE DB2 System Action: The DB2 start up process continues.
BSDS VSAM RETURN CODE = x, VSAM However, any references to DB2 password-protected
REASON CODE = y system databases will cause a 'resource unavailable'
error. Any agent-related requests for DB2 subsystem
Explanation: CSECT DSNTSTR2 attempted to read
database resources will result in an SQLCODE -904.
the DB2 bootstrap data set (BSDS), and a VSAM error
Any requests that are not agent-related for unavailable
has occurred. In the message, 'x' is a 1-byte VSAM
resources will result in the following messages:
return code and 'y' is a 1-byte VSAM reason code.
System Action: The start up process continues. DSNI001I DSNI002I DSNI003I DSNI004I
However, any references to password-protected system DSNI005I DSNI006I DSNT408I DSNT414I
databases will cause a 'resource unavailable' error. Any DSNT415I DSNT416I DSNT417I DSNT500I
agent-related requests for subsystem database
resources will result in an SQLCODE -904. Any
requests that are not agent-related for unavailable Abend X'04E' with reason code X'00E30010' is also
resources will result in the following messages: produced. However, the error results in a retry. DB2
does not terminate, but a dump is produced.
DSNI001I DSNI002I DSNI003I DSNI004I
DSNI005I DSNI006I DSNT408I DSNT414I Operator Response: Notify the system programmer.
DSNT415I DSNT416I DSNT417I DSNT500I System Programmer Response: Obtain a copy of
SYS1.LOGREC and the SVC dump. If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
Abend X'04E' with reason code X'00E30010' is also and Reference for information on identifying and
produced. However, the error results in a retry. DB2 reporting the problem.
does not terminate, but a dump is produced.
Problem Determination: This message is generated
Operator Response: Notify the system programmer. when the recovery log manager (RLM) subcomponent
of DB2 encounters an invalid DB2 database services
System Programmer Response: A VSAM error
password record. A copy of the BSDS record with key
occurred while reading the BSDS record with key
'200000001', which is the invalid database services
'200000001'. Either the BSDS record does not exist or
record retrieved, should be obtained.
an I/O error occurred (indicating that the record is bad).
Further information may be obtained from a VSAM Collect the following diagnostic items listed in
diagnostics manual. Refer to Part 4 (Volume 1) of DB2 “Appendix B. Problem determination” on page 1281: 1,
Administration Guide for procedures on recovering or 2, 5, 16.
repairing the DB2 bootstrap data set.
Problem Determination: Collect the following DSNT103I THE CURRENTLY LOADED DSN6SPRM
diagnostic items listed in “Appendix B. Problem IS NOT THE MVS/XA VERSION
determination” on page 1281: 1, 2, 5, 16.
Explanation: A -START DB2 PARM=xxxxxxxx was
issued where 'xxxxxxxx' is the version of the system
DSNT102I CSECT DSBTSTR2 ENCOUNTERED AN parameter CSECTs. DB2 executes in a MVS/XA
INVALID DATABASE SERVICES environment and will not execute in any other
BOOTSTRAP RECORD environment.
Explanation: CSECT DSNTSTR2 attempted to read System Action: The message DSNV086E is
the DB2 bootstrap data set (BSDS), and an invalid generated with a reason code of X'00E30008'. DB2 is
© Copyright IBM Corp. 1982, 2001 375
DSNT104I • DSNT107I
terminated with abend code X'04F'.
DSNT106I THE LOADED DSN6SYSP CSECT IS
Operator Response: Notify the system programmer. OBSOLETE. PLEASE REASSEMBLE
THE DSN6SYSP CSECT AND
System Programmer Response: Restart DB2 with a RELINKEDIT THE DSNZPARM LOAD
-START DB2 PARM= command, where the parameter MODULE.
block that follows the 'PARM=' parameter specifies an
MVS/XA version of the DB2 subsystem parameters. Explanation: DSNTSTR2 loaded an out-of-date
system parameter CSECT DSN6SYSP. This error can
Problem Determination: Collect the following only occur if code maintenance has been applied and
diagnostic items listed in “Appendix B. Problem CSECT DSN6SYSP has not been reassembled. This
determination” on page 1281: 1, 2, 3, 5, 9. CSECT is contained in the load module specified in the
'PARM=' parameter of the -START DB2 command.
DSNT104I THE CURRENTLY LOADED DSN6SPRM System Action: The message DSNV086E is
IS NOT THE MVS/370 VERSION generated with a reason code of X'00E30008'. DB2 is
Explanation: A -START DB2 PARM=xxxxxxxx was terminated with abend code X'04F'.
issued, where 'xxxxxxxx' is the version of the system Operator Response: Notify the system programmer.
parameter CSECTs. DB2 executes in an MVS/370
environment and does not execute in any other System Programmer Response: Reassemble
environment. DSN6SYSP, and relink-edit the DSNZPARM load
module. This is done by resubmitting the install job
System Action: Message DSNV086E is generated stream, DSNTIJUZ, that built the load module that is
with reason code X'00E30009'. DB2 is terminated with named following the 'PARM=' parameter of the -START
abend code X'04F'. DB2 command.
Operator Response: Notify the system programmer. Problem Determination: Collect the following
System Programmer Response: Restart DB2 with a diagnostic items listed in “Appendix B. Problem
-START DB2 PARM= command, where the parameter determination” on page 1281: 1, 2, 3, 5, 9.
block that follows the PARM= parameter specifies an
MVS/370 version of the DB2 subsystem parameters. DSNT107I INVALID AMODE OR RMODE
Problem Determination: Collect the following ATTRIBUTE FOUND FOR LOAD
diagnostic items listed in “Appendix B. Problem MODULE module-name
determination” on page 1281: 1, 2, 3, 5, 9. Explanation: During DB2 startup, the service
controller establishes the addressability to the DB2
DSNT105I THE LOADED DSN6SPRM CSECT IS database services functional recovery and the
OBSOLETE. PLEASE REASSEMBLE emergency shutdown routines. Two load modules,
THE DSN6SPRM CSECT AND DSNTF, and DSNTLCLE, are loaded into CSA. In the
RELINKEDIT THE DSNZPARM LOAD MVS/XA environment, DSNTLCLE must be link-edited
MODULE. with attributes AMODE(24) and RMODE(ANY). At least
one of the modules did not have the correct addressing
Explanation: DSNTSTR2 loaded an out-of-date attribute when it was loaded. 'module-name' in the error
system parameter CSECT DSN6SPRM. This error can message is the name of the first load module that has
only occur if code maintenance has been applied and an invalid addressing mode.
CSECT DSN6SPRM has not been reassembled. This
CSECT is contained in the load module specified in the System Action: DB2 database services start up is
'PARM=' parameter of the -START DB2 command. terminated.
System Action: The message DSNV086E is Operator Response: Notify the system programmer.
generated with a reason code of X'00E30008'. DB2 is System Programmer Response: Verify that all install
terminated with abend code X'04F'. and maintenance activities against these modules were
Operator Response: Notify the system programmer. executed using SMP. Verify that the JCLIN for SMP
includes the correct AMODE and RMODE control
System Programmer Response: Reassemble statements, and that the linkage editor provided with the
DSN6SPRM, and relink-edit the DSNZPARM load Data Facility Product (DFP) was invoked by SMP for the
module. This is done by resubmitting the install job link edits. Correct the procedure or JCL which caused
stream, DSNTIJUZ, that built the load module that is the error and rerun the necessary SMP jobs.
named following the 'PARM=' parameter of the -START
DB2 command. Problem Determination: A DB2 dump was requested
to an MVS/XA SYS1.DUMP data set.
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem The MVS service aid AMBLIST provides linkage editor
determination” on page 1281: 1, 2, 3, 5, 9.
376 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT200I • DSNT207I
module attributes in the summary section of the parameter of the bind subcommand can be used to limit
LISTLOAD function output. the types of messages that are generated.
DSNT200I type bind-type FOR PLAN plan-id DSNT205I name IS A DUPLICATE name-type, IT
SUCCESSFUL WILL BE USED ONLY ONCE
Explanation: A BIND, REBIND or FREE PLAN Explanation: Name 'name' has been specified more
subcommand has completed successfully. than once in a list of names.
type Indicates that a test bind was in progress. A name Name that was specified more than once.
test bind means that no plan name was
name-type
specified. The token is omitted if a normal
Indicates the type of list in which the name was
BIND PLAN was processed.
duplicated.
bind-type v MEMBER NAME - List of DBRM Members
Type of bind subcommand: BIND, REBIND, or v PLAN-ID - List of plan IDs
FREE. v SYSTEM NAME - List of system connection
names on a DISABLE or ENABLE list.
plan-id Name of application plan specified in the
v PACKAGE NAME - List of package IDs
subcommand.
System Action: Duplicates are removed from
System Action: The plan was successfully bound,
'name-type' list and the bind process continues.
rebound, or freed.
System Programmer Response: Verify the list that
contains the duplicate. If the error is only in entering a
DSNT201I type bind-type FOR PLAN plan-id NOT
name incorrectly, which happens to duplicate another
SUCCESSFUL
entry, enter the name correctly and reissue the bind
Explanation: Errors have been detected during the statement. If the entry is really a duplicate, no action is
processing of the indicated BIND, REBIND, or FREE required.
PLAN subcommand.
type Indicates that a test bind was in progress. A DSNT207I PROGRAM program-name WITH MARK
test bind means that no plan name was release-dependency-mark FAILED
specified. The token is omitted if a normal BECAUSE IT DEPENDS ON
BIND PLAN was processed. FUNCTIONS OF THE RELEASE FROM
WHICH FALL BACK HAS OCCURRED
bind-type
Type of bind subcommand: BIND, REBIND, or Explanation: Program 'program-name' depends on a
FREE. function of DB2 that is not supported by the current
active release.
plan-id Name of application plan specified in the
subcommand. program-name
Name of the application program.
System Action: The BIND, REBIND, or FREE PLAN
was not performed. release-dependency-mark
A one-character mark showing the oldest DB2
System Programmer Response: See other release supporting this program.
messages issued to determine the error that caused the
bind subcommand to terminate unsuccessfully.
This message is issued by the following CSECTs:
DSNTBCM1, DSNTBCM2
DSNT202I MESSAGE LIMIT EXCEEDED
System Action: The bind operation for this plan or
Explanation: A fixed amount of space exists in which package is not performed.
to generate bind subcommand messages. This
User Response: The program cannot be used until
message says that the bind subcommand generated
the DB2 subsystem is remigrated to the newer release.
more messages than will fit in that space.
Notify the system programmer.
System Action: For bind subcommands that affect a
System Programmer Response: Warn users not to
single plan, the bind subcommand process continues.
use plans or packages containing this program until the
However, no other messages are generated except for
DB2 subsystem has been remigrated to the newer
message DSNT200I or DSNT201I. For bind
release.
subcommands that affect more than one plan, the bind
subcommand process terminates and no other
messages are generated.
System Programmer Response: The 'FLAG'
Chapter 17. DB2 Messages 377
DSNT208I • DSNT212I
bind-type
DSNT208I PROGRAM program-name
Type of BIND subcommand: BIND, REBIND,
PRECOMPILED WITH INCORRECT
FREE.
LEVEL FOR THIS RELEASE
authorization ID
Explanation: Program 'program-name' was
Authorization ID of the plan owner.
precompiled under a release not supported by the
current level of DB2, or the contents of the DBRM have plan-id Application plan specified in the BIND
been modified after the precompilation phase. subcommand.
System Action: The BIND operation was not privilege
performed. Missing privilege: BIND, BINDADD
User Response: Precompile the named program System Action: The BIND, REBIND, or FREE
again using the current precompiler. Reissue the BIND operation for 'plan-id' is not performed.
command.
System Programmer Response: If the indicated
Problem Determination: If the application program privilege is BINDADD, then the privilege to invoke the
was precompiled at an appropriate release, and the BIND subcommand with the ACTION(ADD) option must
problem persists, collect the following diagnostic items be granted to the indicated authorization ID. If the
listed in “Appendix B. Problem determination” on indicated privilege is BIND, the privilege to invoke a
page 1281: 79, 80, 81. BIND subcommand against the indicated application
plan must be granted to the indicated authorization ID.
DSNT209I bind-type FOR PLAN plan-id WITH
MARK release-dependency-mark FAILED DSNT211I REBIND FOR PLAN plan-id FAILED
BECAUSE PLAN DEPENDS ON BECAUSE IBMREQD OF ibmreqd IS
FUNCTIONS OF THE RELEASE FROM INVALID
WHICH FALL BACK HAS OCCURRED.
Explanation: The IBMREQD column of the
Explanation: Plan 'plan-id' depends on a function of SYSIBM.SYSPLAN catalog table for the named plan
DB2 which is not supported by the currently active contains an unrecognizable character.
release.
System Action: The REBIND operation for the plan
bind-type was not performed.
REBIND
System Programmer Response: You must do a
plan-id Name of the application plan BIND ACTION(REPLACE) for this plan.
release-dependency-mark
A one-character mark showing the oldest DSNT212I bind-type AUTHORIZATION ID auth-id IN
release of DB2 which can support this plan. THE OWNER KEYWORD IS INVALID
The release dependency mark for the plan is
kept in the IBMREQD columns in the DB2 Explanation: The authorization ID specified in the
catalog in SYSIBM.SYSPLAN. OWNER keyword of the BIND or REBIND subcommand
is invalid. To specify an OWNER that is not the primary
System Action: The REBIND operation for this plan is authorization ID, or one of the secondary IDs of the
not performed. process requires additional authority. See DB2
Command Reference for the authority required.
User Response: The plan cannot be used until the
DB2 subsystem is remigrated to the newer release. bind-type
Type of bind subcommand: BIND or REBIND
Operator Response: Notify the system programmer.
auth-id The authorization ID specified as owner.
System Programmer Response: Warn users not to
use the plan until the DB2 subsystem has been System Action: The BIND or REBIND subcommand
remigrated to the newer release. is not executed.
System Programmer Response: Rerun the
DSNT210I bind-type AUTHORIZATION ERROR subcommand and specify a valid authorization ID for the
USING authorization-id AUTHORITY OWNER keyword. You may need to add the required
PLAN=plan-id PRIVILEGE=privilege authorization ID for this user to the security system.
Explanation: The indicated authorization ID does not
have the indicated privilege and therefore cannot invoke
the indicated BIND subcommand against the indicated
application plan.
378 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT213I • DSNT224I
bind-type
DSNT213I THE DCB BLOCK SIZE OF THE INPUT
Type of bind subcommand: REBIND or FREE.
DBRM LIBRARY IS INVALID
auth-id Authorization ID of the plan owner.
Explanation: An invalid DCB block size is specified for
the DBRM library of the BIND subcommand. plan-id Application plan specified in the BIND
subcommand.
System Programmer Response: Correct the DCB
block size of the DBRM library, and reissue the BIND System Programmer Response: Check the
subcommand. SYSPLAN catalog table for the correct 'plan-id' to use.
DSNT214I I/O ERROR ON DBRM LIBRARY DBRM DSNT223I csect-name bind-type WARNING FOR
MEMBER= dbrm-name DBRM object-type = object-name USE OF
LIBRARY= dbrm-pds-name xxxxxx OPTHINT IS DISALLOWED BY A DB2
SUBSYSTEM PARAMETER. THE
Explanation: An I/O error was encountered attempting
DEFAULT OPTHINT VALUE IS USED.
to read database request module (DBRM) during a
BIND subcommand. 'xxxxxx' is a portion of the message Explanation: The DB2 subsystem parameters have
text generated by the SYNADAF macro instruction to not been configured to enable the use of OPTHINT in
describe the permanent I/O error This text may contain the bind-type subcommand. The default OPTHINT value
information such as jobname, stepname, unit address, of all blanks is used.
device type, ddname, operation attempted, and error
description. bind-type
Type of BIND subcommand: BIND or REBIND.
dbrm-name
Name of the DBRM associated with the error. object-type
PLAN or PACKAGE
dbrm-pds-name
Partitioned data set associated with the error. object-name
If object-type is PLAN, object-name is the
System Action: No application plan is created. name of the plan.
System Programmer Response: Determine if an If object-type is PACKAGE, object-name is the
incorrect dbrm-pds-name was specified in the LIBRARY name of the package in the format
parameter of the BIND subcommand, or an incorrect ’location-id.collection-id.package-id’.
data set name was specified for the DBRMLIB DD
statement. Check correctly specified data sets for I/O System Action: Processing continues normally using
errors or modified DCB attributes. the default OPTHINT value.
System Programmer Response: Enable the use of
DSNT220I BIND ADD ERROR USING auth-id OPTHINT by changing the value of OPTIMIZATION
AUTHORITY PLAN plan-id ALREADY HINTS on the DB2 Installation panel, DSNTIP4.
EXISTS If, after further consideration, you do not want to use
Explanation: An attempt was made to use the BIND OPTHINT, remove OPTHINT from the bind-type
subcommand with the 'ACTION(ADD)' option that subcommand or set the value to all blanks.
specified a 'plan-id' that already exists.
auth-id Authorization ID of the owner of the plan. | DSNT224I csect-name bind-type ERROR FOR
| object-type object-name CCSID = ccsid IS
plan-id Application plan specified in the BIND | INVALID FOR ENCODING SCHEME =
subcommand. | scheme
System Action: No application plan is created. | Explanation: The system does not have a valid
System Programmer Response: Check the
| CCSID defined for the specified encoding scheme, or
SYSIBM.SYSPLAN catalog table for names of existing
| the specified CCSID is not defined on the system.
application plans. Reinvoke the BIND subcommand with | bind-type
a 'plan-id' that is not in use. | Type of bind subcommand: BIND or REBIND.
| object-type
DSNT221I bind-type ERROR USING auth-id | PLAN or PACKAGE.
AUTHORITY PLAN plan-id DOES NOT
EXIST | object-name
| If object-type is PLAN, object-name is the
Explanation: The indicated bind subcommand was | name of the application. Otherwise, it is the
issued against an application plan that does not exist. | name of the package in
The individual variable fields contain: | ’location.collection.package’ format.
Chapter 17. DB2 Messages 379
DSNT228I • DSNT230I
| scheme version2
| The encoding scheme specified in the Version-id of package that is to be created
| ENCODING bind option on the subcommand
System Action: The bind will fail.
| or defaulted from the system default
| Application Encoding Scheme. If scheme is System Programmer Response: There are two
| UNKNOWN, then the CCSID value specified in approaches to solve this problem. The first is to
| the ENCODING bind option or defaulted from re-precompile the program with a new version name
| the system default Application Encoding and re-issue the original BIND subcommand. The other
| Scheme is not defined, and therefore the approach is not to do the precompile but re-issue the
| encoding scheme is not known. BIND subcommand without the REPLVER parameter.
| ccsid The numeric CCSID corresponding to the
| specified ccsid-type. DSNT229I BIND ERROR, ATTEMPTING TO
REPLACE PACKAGE = package-name
| Severity: 8 (error)
THERE ARE ENABLE OR DISABLE
| System Action: The bind-type operation is not ENTRIES CURRENTLY ASSOCIATED
| performed WITH THE PACKAGE
| User Response: Verify that the correct encoding Explanation: The BIND subcommand was issued to
| scheme was specified in the ENCODING bind option on replace a package that has ENABLE or DISABLE
| the bind-type subcommand. If correct, see System entries currently associated with the package. The
| Programmer Response and contact the System individual variable fields contain:
| Programmer. If incorrect, specify the correct scheme in
package-name
| the ENCODING option and reissue the bind-type
Name of the package
| subcommand.
(location.collection.package)
| System Programmer Response: If the bind option
System Action: Package not bound.
| ENCODING was not specified, and instead the value for
| ENCODING was defaulted from the system default System Programmer Response: FREE the package
| Application Encoding Scheme, verify the Application first and then BIND the package.
| Encoding Scheme is set to a defined CCSID.
| If the value specified for the ENCODING option was DSNT230I BIND DBRM MEMBER NAME ERROR
| ASCII, EBCDIC or UNICODE, verify the corresponding USING auth-id AUTHORITY object-type =
| CODED CHAR SET subsystem parameter on the object-name MEMBER dbrm-name NOT
| installation panel DSNTIPF has been set to a defined FOUND IN PDS SEARCH ORDER
| CCSID.
Explanation: The indicated 'dbrm-name' was not
| Otherwise, inform the user of the correct CCSID. Refer found in the search order in the PDSs specified on the
| to Appendix A of DB2 Installation Guide for more BIND PLAN or BIND PACKAGE subcommand.
| information regarding CCSIDs and character sets.
auth-id Authorization ID of the plan or package owner
DSNT228I BIND ERROR, ATTEMPTING TO object-type
REPLACE PACKAGE = package_name The type of object being bound: PLAN or
WITH VERSION = (version2) BUT THIS PACKAGE
VERSION ALREADY EXISTS object-name
Explanation: An attempt is made to create a version If 'object-type' is PLAN, 'object-name' is the
of a package that already exists. The version specified name of the application plan. Otherwise, it is
in the REPLVER keyword is different from the version the name of the package in
specified for the precompile. The version specified for 'location.collection.package' format.
the precompile already exists in the catalog. The dbrm-name
combination of 'location.collection.package.version' must Member name of the DBRM that was not
be unique in the SYSIBM.SYSPACKAGE catalog table. found.
A common mistake is that the user may believe that the
version he is creating is the one specified in the System Action: The bind is unsuccessful.
REPLVER keyword. This is not the case. The version System Programmer Response: Determine if an
specified in the REPLVER keyword is the name of the incorrect 'dbrm-member-name' or PDS was specified.
version being replaced. The version that will be created Reinvoke the BIND subcommand specifying the correct
is the version that was given to the program when it names.
was precompiled.
package_name
Fully qualified package name
380 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT231I • DSNT235I
messages issued to determine the error that caused the
DSNT231I BIND DBRM ERROR USING auth-id
subcommand to terminate unsuccessfully.
AUTHORITY object-type = object-name
DBRM dbrm-name IS IN AN
INCONSISTENT STATE DSNT234I MESSAGE LIMIT EXCEEDED
Explanation: The contents of a DBRM have been Explanation: A fixed amount of space exists in which
modified after the precompilation process, or the DBRM to generate bind subcommand messages. This
contains incorrect information in the header. message says that the bind subcommand generated
more messages than will fit in that space.
auth-id Authorization ID of the invoker of the BIND
subcommand. System Action: For bind subcommands that affect a
single package, the bind subcommand process
object-type
continues. However, no other messages are generated
The type of object being bound: PLAN or
except for completion message DSNT232I or
PACKAGE
DSNT233I. For bind subcommands that affect more
object-name than one package, the bind subcommand process
If 'object-type' is PLAN, 'object-name' is the terminates and no other messages are generated.
name of the application plan. Otherwise, it is
System Programmer Response: The 'FLAG'
the name of the package in
parameter of the bind subcommand may be used to
'location.collection.package' format.
limit the types of messages that are generated.
dbrm-name
Name of the DBRM that is in error.
DSNT235I csect-name bind-type AUTHORIZATION
System Action: The bind is unsuccessful. ERROR USING auth-id AUTHORITY
PACKAGE = package-name PRIVILEGE
System Programmer Response: Precompile the
= privilege
application program associated with the indicated
DBRM. Reinvoke the BIND subcommand. Explanation: The authorization ID given does not
have the privilege indicated and cannot invoke the bind
subcommand on the named package.
DSNT232I SUCCESSFUL bind-type FOR PACKAGE
= package-name bind-type
Type of bind subcommand: BIND, REBIND, or
Explanation: A BIND, REBIND or FREE PACKAGE
FREE
subcommand has completed successfully.
auth-id Authorization ID of of the package owner
bind-type
Type of bind subcommand: BIND, REBIND, or package-name
FREE Name of the package in the following format:
’location.collection.package.(version)’
package-name
Name of the package in the following format: privilege
'location.collection.package.(version)' Name of the privilege not held:
System Action: The package was successfully bound, BINDADD or BINDADD *
rebound, or freed. The authority to create a new package
using BIND with the ADD option.
DSNT233I UNSUCCESSFUL bind-type FOR BIND The authority to BIND (REPLACE) or
PACKAGE = package-name REBIND a package.
Explanation: Errors have been detected during the BIND * The authority to add a new version of
processing of the indicated BIND, REBIND, or FREE an existing package using BIND with
PACKAGE subcommand. the ADD option.
bind-type FREE There is no FREE privilege, but the
Type of bind subcommand: BIND, REBIND, or user needs the proper authority to free
FREE the package.
package-name COPY The authority to COPY from the
Name of the package in the following format: indicated package.
'location.collection.package.(version)'
CREATE IN or CREATE IN *
System Action: The indicated package was not The authority to create a package in
bound, rebound, or freed. the indicated collection.
System Programmer Response: See other
Chapter 17. DB2 Messages 381
DSNT236I • DSNT239I
A blank and asterisk ( *) in the privilege values package-name
’BINDADD *’, ’BIND *’, and ’CREATE IN *’ in the Name of the package in the following format:
message indicates that the DB2 system parameter 'location.collection.package.(version)'
BIND NEW PACKAGE has the value BIND. When ’ *’
System Action: No package is created.
does not appear in these privilege values, BIND NEW
PACKAGE has the value BINDADD. System Programmer Response: Check the
SYSIBM.SYSPACKAGE catalog table for names of
The system parameter BIND NEW PACKAGE affects existing application packages. Re-invoke the BIND
the authorization required to add a new package or a subcommand with a 'location.collection.package.version'
new version of an existing package to a collection. For that is not in use.
more information about this system parameter, see:
v ″Installing, Migrating, and Updating System DSNT238I bind-type error-type USING auth-id
Parameters″ (Panel: DSNTIPP) in Part 2 of DB2 AUTHORITY PACKAGE = package-name
Installation Guide. DOES NOT EXIST
v ″Controlling Access to DB2 Objects″ in Part 3
Explanation: The indicated subcommand was issued
(Volume 1) of DB2 Administration Guide .
against a package that does not exist. The individual
System Action: The indicated package is not bound, variable fields contain:
rebound, or freed.
bind-type
System Programmer Response: You must grant the Type of bind subcommand (BIND COPY |
indicated privilege to the authorization ID of the package BIND REPLACE | REBIND | FREE| BIND
owner. PLAN | REBIND PLAN | DROP PACKAGE). If
BIND or REBIND PLAN is specified, the
package-name refers to a package on the
DSNT236I REBIND FOR PACKAGE package-name
PKLIST for the plan.
FAILED BECAUSE IBMREQD OF
ibmreqd IS INVALID error-type
Type of error: WARNING or ERROR.
Explanation: The IBMREQD column of the
SYSIBM.SYSPACKAGE catalog table for the named auth-id Authorization ID of the invoker of the BIND
package contains an unrecognizable character. This subcommand.
usually means that the package depends on a function
package-name
of DB2 which is not supported by the currently active
Name of the package in the following format
release.
’location.collection.package.(version)’.
This message is issued by the following CSECT:
System Action: Package not rebound or freed.
DSNTBRB2
System Programmer Response: Check the
package-name
SYSPACKAGE catalog table for the correct
Name of the package in the following format:
'location.collection.package.version' to use.
'location.collection.package.(version)'
System Action: The package was not rebound.
DSNT239I PLAN plan-id CONTAINS NO DBRMS
System Programmer Response: Warn users not to AND NO PACKAGES
use the package until the DB2 subsystem is remigrated
Explanation: A plan with no DBRMs was rebound with
to the newer release.
the NOPKLIST option specified. This creates an empty
plan. No SQL can be executed. The individual variable
DSNT237I csect-name BIND sub-type ERROR fields contain:
USING auth-id AUTHORITY PACKAGE =
plan-id Plan name specified on the REBIND
package-name ALREADY EXISTS
command.
Explanation: An attempt is made to add a package
System Action: This is a warning message. The
that already exists. The combination of
REBIND process will continue.
'location.collection.package.version' must be unique in
the SYSIBM.SYSPACKAGE table. In addition, the System Programmer Response: If an empty plan is
combination of 'location.collection.package.consistency- not desired, reissue the REBIND command with the
token' must be unique. PKLIST keyword specifying a new list.
sub-type
The sub-type can have the values: COPY, ADD
or REPLACE.
auth-id Authorization ID of the owner of the package.
382 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT240I • DSNT245I
auth-id Authorization ID of the plan or package owner.
DSNT240I csect-name bind-type ERROR,
ASTERISK NOT ALLOWED ON System Action: The plan or package is not bound or
REMOTE bind-type PACKAGE rebound.
Explanation: When remotely rebinding or freeing a System Programmer Response: If the indicated
package, an asterisk (*) cannot be specified anywhere authorization ID should be allowed to bind, change the
in the name of a package. In other words, it is not entry in the active RLST table.
possible to remotely rebind or free multiple packages.
System Programmer Response: Remove the DSNT243 BIND ERROR FOR PACKAGE = pkg-id
asterisk and rebind, or free a specific package. Refer to CONTOKEN = ’contoken’X IS NOT
DB2 Command Reference for the correct syntax for UNIQUE SO IT CANNOT BE CREATED
REBIND or FREE PACKAGE.
Explanation: An attempt is made to add or replace a
package with a consistency token that is not unique for
DSNT241I bind-type AUTHORIZATION error-type that package. In other words, the combination of
ON PLAN plan-id AUTHORIZATION ID 'location.collection.package.consistency-token' already
auth-id NOT AUTHORIZED TO exists.
EXECUTE PACKAGE package-name
pkg-id Fully qualified name of the package.
Explanation: The indicated authorization ID does not
have EXECUTE authority on the specified package in contoken
the package list. Consistency token in hexadecimal.
bind-type System Action: The BIND will fail.
Type of bind subcommand: BIND or REBIND System Programmer Response: Check the
error-type SYSIBM.SYSPACKAGE catalog table for names of
Type of error: WARNING or ERROR. If existing application packages with the indicated
VALIDATE(BIND) was specified, this is an consistency token. Re-issue the BIND subcommand
ERROR message. Otherwise, it is a WARNING such that the 'location.collection.package.consistency-
message. token' is unique within the catalog. The following SQL
statement can be used to query the catalog,
plan-id Name of application plan specified in the SELECT COLLID,NAME
subcommand. FROM loc-id.SYSIBM.SYSPACKAGE
auth-id Authorization ID of the plan owner. WHERE HEX(CONTOKEN) = 'contokn';
package-name
Name of the package (collection.package). The DSNT244I bind-type ERROR keyword KEYWORD IS
location of the package is the local DB2 NOT SUPPORTED FOR REMOTE
location name. PROCESSING
System Action: If the bind subcommand was invoked Explanation: The indicated keyword is not supported
with VALIDATE(BIND), the BIND or REBIND operation for the remote bind or rebind subcommand.
is not performed. If VALIDATE(RUN) was used then the bind-type
BIND or REBIND operation will continue. Type of bind subcommand: BIND or REBIND
System Programmer Response: The indicated plan keyword
owner should be granted the EXECUTE privilege on the Name of the keyword that is not supported.
package.
Programmer Response: Check DB2 Command
Reference for the correct syntax.
DSNT242I bind-type ERROR USING auth-id
AUTHORITY NO BIND OR REBIND
SUBCOMMANDS ARE ALLOWED FOR DSNT245I LOCATION location CANNOT BE
THIS AUTHID SPECIFIED. THE LOCAL DB2 IS NOT
DEFINED
Explanation: The authorization ID is not allowed to
perform the indicated 'bind-type' against a plan or Explanation: Since the local DB2 location name is
package because entries in the RLST table prohibit undefined, no location name may be given when
binding and rebinding by this authorization ID, or all specifying a package name on a bind subcommand.
authorization IDs. location
bind-type Location specified on the bind subcommand.
Type of bind subcommand: BIND or REBIND System Action: The bind subcommand was not
performed.
Chapter 17. DB2 Messages 383
DSNT246I • DSNT250I
System Programmer Response: The location name or package name and reissue the REBIND or FREE
of the local DB2 must be defined in BSDS if the location subcommand.
is used in the BIND, REBIND, or FREE subcommand.
DSNT249I csect-name bind-type WARNING FOR
DSNT246I bind-type FOR PACKAGE package-name PLAN plan-name keyword LOCATION-ID
WITH MARK release-dependency-mark location-id NOT FOUND IN
FAILED BECAUSE PACKAGE SYSIBM.LOCATION
DEPENDS ON FUNCTIONS OF THE
Explanation: A 'location-id' was specified on the
RELEASE FROM WHICH FALL BACK
PKLIST or CURRENTSERVER keyword on a bind
HAS OCCURRED
subcommand. That location is not defined in the
Explanation: The named package depends on a SYSIBM.LOCATIONS table.
function of DB2 which is not supported by the currently
bind-type
active release.
Type of bind subcommand: BIND or REBIND
bind-type
plan-name
Type of bind subcommand: REBIND
Name of the plan
package-name
keyword
Name of the package in the following format:
The bind subcommand containing the
'location.collection.package.(version)'
nonexistent location: PKLIST or
release-dependency-mark CURRENTSERVER
A one-character mark showing the oldest
location-id
release of the DB2 which can support this
The nonexistent location
package. The release dependency mark for the
package is kept in the IBMREQD column in the System Action: The bind process will continue.
DB2 catalog in SYSIBM.SYSPACKAGE.
System Programmer Response: Define the
System Action: The 'bind-type' operation for this appropriate 'location-ids' in the SYSIBM.LOCATION
package is not performed. catalog table prior to executing the plan.
User Response: The package cannot be bound until
the DB2 subsystem is remigrated to the newer release. DSNT250I BIND UNABLE TO OPEN DBRM
LIBRARY USING authorization-
System Programmer Response: Warn users not to
id AUTHORITY object-type =
use plans containing this package until the DB2
object-name
subsystem has been remigrated to the newer release.
Explanation: The BIND subcommand was unable to
open the DBRM partitioned data set(s).
DSNT247I bind-type ERROR object-type NOT
FOUND FOR object-type = object-name authorization-id
Authorization ID of the invoker of the BIND
Explanation: You attempted to FREE or REBIND
subcommand.
multiple plans or packages using the asterisk (*) but no
plans or packages were found. object-type
PLAN | PACKAGE
bind-type
Type of bind subcommand: REBIND or FREE object-name
If 'object-type' is PLAN, 'object-name' is the
object-type
name of the application plan. Otherwise, it is
Type of object to be freed or rebound: PLAN or
the name of the package in
PACKAGE
'location.collection.package' format.
object-name
User Response: Contact the system programmer,
If object-type is PLAN, object-name is the
providing all material associated with the error.
name of the application plan. Otherwise, it is
the name of the package in System Programmer Response: Determine why the
'location.collection.package' format. BIND subcommand was unable to open the DBRM
library, and correct the problem.
System Action: The REBIND or FREE operation is
not performed. Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
User Response: Check the plan or package name. If
determination” on page 1281: 1, 2, 5, 32.
it is correct, no plans or packages were found and no
operation can be performed; otherwise, correct the plan
384 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT251I • DSNT254I
DSNT251I BIND UNABLE TO LOCATE DBRM DSNT253I csect-name bind-type OPTIONS FOR
LIBRARY MEMBERS PLAN plan-name
USING authorization-id AUTHORITY
:
object-type = object-name
Explanation: The BIND subcommand received an I/O (DEFER | NODEFER) PREPARE
error while attempting to locate the specified DBRM CACHESIZE bind-option1
library member(s). QUALIFIER bind-option2
CURRENTSERVER bind-option3
authorization-id CURRENTDATA bind-option4
Authorization ID of the invoker of the BIND DEGREE bind-option5
subcommand. SQLRULES bind-option6
object-type DISCONNECT bind-option7
PLAN | PACKAGE (REOPT | NOREOPT) VARS
KEEPDYNAMIC bind-option8
object-name | IMMEDWRITE bind-option9
If object-type is PLAN, object-name is the DBPROTOCOL bind-option10
name of the application plan. Otherwise, it is OPTHINT bind-option11
the name of the package in | ENCODING bind-option12(bind-option13)
'location.collection.package' format. PATH bind-option14
System Programmer Response: Correct the reason
for the I/O error, and reissue the BIND subcommand. Explanation: This message shows the BIND or
Problem Determination: Collect the following REBIND options that were used for the plan specified
diagnostic items listed in “Appendix B. Problem by plan-name during bind or rebind processing.
determination” on page 1281: 1, 2, 5, 32. Severity: 0 (informational)
DSNT252I csect-name bind-type OPTIONS FOR DSNT254I csect-name bind-type OPTIONS FOR
PLAN plan-name
:
:
PACKAGE =package-name
ACTION bind-option1 bind-option2 ACTION (ADD | REP)
OWNER bind-option3 OWNER owner
VALIDATE bind-option4 QUALIFIER qualifier
ISOLATION bind-option5 VALIDATE (BIND | RUN)
ACQUIRE bind-option6 EXPLAIN (NO | YES)
RELEASE bind-option7 ISOLATION (RR | CS | RS | UP | blank)
EXPLAIN bind-option8 RELEASE (COMMIT | DEALLOCATE | blank)
DYNAMICRULES bind-option9 COPY package-name
Explanation: This message shows the BIND or Explanation: This message shows the BIND or
REBIND options that were used for the plan specified REBIND options that were used for the local package
by plan-name during bind or rebind processing. specified by package-name during bind or rebind
Severity: 0 (informational) processing.
Severity: 0 (informational)
Chapter 17. DB2 Messages 385
DSNT255I • DSNT260I
bind-type
DSNT255I csect-name bind-type OPTIONS FOR
Type of bind subcommand: BIND or REBIND
:
plan-name
SQLERROR bind-option1 Name of plan
CURRENTDATA bind-option2 location-id
DEGREE bind-option3 Location of CURRENTSERVER
DYNAMICRULES bind-option4
(DEFER | NODEFER) PREPARE System Action: The bind process will continue.
(REOPT | NOREOPT) VARS System Programmer Response: Add a package list
KEEPDYNAMIC bind-option5 with package(s) that reference the location specified in
| IMMEDWRITE bind-option6 the CURRENTSERVER or delete the
DBPROTOCOL bind-option7 CURRENTSERVER from the BIND or REBIND
OPTHINT bind-option8 subcommand.
| ENCODING bind-option9(bind-option10)
PATH bind-option11
DSNT259I bind-type WARNING FOR PLAN
plan-name NO PACKAGES IN THE
Explanation: This message shows the BIND or PACKAGE LIST REFERENCE THE
REBIND options that were used for the local package LOCATION-ID location-id SPECIFIED IN
specified by package-name during bind or rebind CURRENTSERVER
processing.
Explanation: There are no packages in the package
Severity: 0 (informational) list that reference the location specified in the
CURRENTSERVER keyword.
DSNT256I DBRM MEMBER member-name IS bind-type
EMPTY, A PACKAGE CANNOT BE Type of bind subcommand: BIND or REBIND
BOUND
plan-name
Explanation: The named DBRM member is empty, a Name of plan
package cannot be created.
location-id
System Action: No package is created. Location of CURRENTSERVER
System Action: The bind process will continue.
DSNT257I BIND ERROR, PACKAGE package-name
CANNOT BE CREATED BECAUSE IT System Programmer Response: Change
HAS THE SAME NAME AS THE 'location-ids' for the packages in the package list to
PACKAGE BEING COPIED reference the location in the CURRENTSERVER or
change the location specified in CURRENTSERVER.
Explanation: The location and collection-id of the
package being created are the same as the local
location and the collection-id specified with the COPY DSNT260I csect-name bind-type - THE SUBMITTED
keyword. You cannot create a package that is the same PARAMETERS RESULT IN AN INVALID
name as the package being copied. COMBINATION OF bind-option1 AND
bind-option2 FOR object-type =
package-name object-name
Name of the package
(location.collection.package.(version)) Explanation: The BIND or REBIND subcommand has
been submitted with an invalid combination of bind
System Action: The package is not bound. option or parameter values.
System Programmer Response: Choose a different bind-type
collection id for the package you are creating and Type of bind subcommand: BIND or REBIND.
resubmit the subcommand.
object-type
PLAN or PACKAGE
DSNT258I bind-type WARNING FOR PLAN
plan-name THE LOCATION-ID location-id object_name
SPECIFIED IN CURRENTSERVER MAY If object-type is PLAN, object-name is the
NEED A PACKAGE LIST name of the application plan. If object_type is
PACKAGE, object_name is the name of the
Explanation: If binding a PLAN with a nonlocal package in the format ’location-id.collection-
location specified in the CURRENTSERVER, a package id.package-id’.
list is required using the PKLIST keyword to access any
packages at the location specified.
386 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT261I • DSNT263I
bind-option1 and bind-option2 connection names associated with one of the
The invalid combination of bind option values, connection types (DLIBATCH, CICS, IMSBMP, IMSMPP,
where bind-option1 and bind-option2 are each or REMOTE. REMOTE is only valid for BIND/REBIND
an option name and value. PACKAGE)
If object-type is PLAN, then one of the
following applies: DSNT262I csect-name bind-type WARNING -
v bind-option1 was used on the REBIND ISOLATION old-iso NOT SUPPORTED.
subcommand and bind-option2 exists in the CHANGING TO ISOLATION new-iso
SYSIBM.SYSPLAN catalog table for PLAN Explanation: DB2 does not support the isolation level
object-name, or specified on the local BIND or REBIND PACKAGE
v bind-option2 was used on the REBIND subcommand. The isolation level specified by new-iso is
subcommand and bind-option1 exists in the used instead.
SYSIBM.SYSPLAN catalog table for PLAN
Severity: 4
object-name.
System Action: Processing continues
If object-type is PACKAGE, then one of the
User Response: If the new isolation level is not
following applies:
satisfactory, change the ISOLATION option on the BIND
v bind-option1 was used on the BIND COPY or REBIND PACKAGE subcommand and rebind the
or REBIND subcommand and bind-option2 package. Use a value that DB2 supports.
exists in the SYSIBM.SYSPACKAGE catalog
table for PACKAGE object-name, or
DSNT263I csect-name bind-type FOR object-type =
v bind-option2 was used on the BIND COPY
object-name FAILED BECAUSE THE
or REBIND subcommand and bind-option1
bind-type DEPENDS ON FUNCTIONS IN
exists in the SYSIBM.SYSPACKAGE catalog
A LATER DB2 RELEASE WITH MARK
table for PACKAGE object-name.
release-dependency-mark OR HIGHER
The combination of bind-option1 and bind-option2 is not Explanation: The current DB2 does not support a bind
supported by DB2. option or feature specified in the indicated bind
subcommand. The bind option or feature depends on
System Action: The BIND or REBIND process is
functions in a later DB2 release.
terminated for the indicated plan or package.
bind-type
User Response: Refer to DB2 Command Reference
Type of bind subcommand: BIND or REBIND
for valid combinations of the indicated bind option
values, and reissue the BIND or REBIND subcommand object-type
with a valid combination. PLAN or PACKAGE
Problem Determination: See the Explanation section object-name
of this message. If object-type is PLAN, object-name is the
name of the plan.
DSNT261I bind-type WARNING FOR object-type = If object-type is PACKAGE, object-name is the
object-name ALL CONNECTION TYPES name of the package in the format
ARE DISABLED ’location-id.collection-id.package-id’.
Explanation: All possible connection types are release-dependency-mark
disabled. The plan or package cannot be executed. A one-character mark indicating the oldest DB2
release that can support the bind
bind-type
subcommand.
Type of bind subcommand: BIND or REBIND
object-type This message can be issued in the following situations:
PLAN or PACKAGE v When the DSN command explicitly or implicitly uses
object-name the name of a DB2 subsystem that does not support
If object-type is PLAN, object-name is the a bind option or feature used in the DSN bind
name of the application plan. Otherwise, it is subcommand bind-type, or
the name of the package in v When the DSN command uses a group attachment
’location.collection.package’ format. name for a DB2 data sharing group and the receiving
DB2 data sharing member does not support a bind
System Action: The bind process will continue.
option or feature used in the DSN bind subcommand
System Programmer Response: Delete one or more bind-type.
connection types from DISABLE clause or add a list of
Chapter 17. DB2 Messages 387
DSNT264I • DSNT266I
System Action: The bind-type operation is not auth-id Authorization ID attempting the REBIND
performed.
package-name
User Response: In the DSN command, specify the Name of the package in the following format:
name of a DB2 subsystem having release dependency ’collection.package’
mark release-dependency-mark or higher that supports
System Action: The package specified is not
all of the bind options or features used in the bind-type
rebound.
subcommand.
System Programmer Response: For a package that
For a list of the DB2 release dependency marks and
is not a trigger package, rebind using the subcommand
their meanings, refer to the IBMREQD column in the
REBIND PACKAGE. Re-invoke the bind subcommand
SYSIBM.SYSPLAN or SYSIBM.SYSPACKAGE DB2
with a ’collection.package’ that is a trigger package.
catalog tables described in Appendix D of DB2 SQL
Reference.
DSNT266I csect-name bind-type FOR object-type =
System Programmer Response: See the 'User
object-name FAILED. THE TOTAL
Response' section of this message.
LENGTH OF THE PATH SCHEMA NAME
LIST EXCEEDS 254 CHARACTERS
DSNT264I csect-name bind-type bind-subtype WITH SCHEMA NAME schema-name
ERROR USING auth-id AUTHORITY
Explanation: DB2 uses the schema name list you
PACKAGE package-name IS A
specified in the bind option PATH to set the DB2 SQL
TRIGGER PACKAGE
Path that will be used for the bind process. The SQL
Explanation: To rebind a trigger package, you must Path is a VARCHAR(254) string containing the list of
use the DSN subcommand REBIND TRIGGER schema names you specified, where each schema
PACKAGE. To free a trigger package, you must use the name is delimited with double quotes and separated
SQL statement DROP TRIGGER. You cannot copy a from the next schema name by a comma. The total
trigger package. length of this SQL Path string, including the delimiters
and commas, cannot exceed 254 characters. The
bind-type
indicated schema name schema-name in the bind
Type of bind subcommand: BIND, REBIND, or
option PATH causes the SQL Path string to exceed 254
FREE
characters.
bind-subtype
bind-type
Subtype of bind subcommand: COPY or blank
Type of bind subcommand: BIND or REBIND
auth-id Authorization ID attempting the prohibited
object-type
action
PLAN or PACKAGE
package-name
object-name
Name of the package in the following format:
If object-type is PLAN, object-name is the
’collection.package’
name of the plan.
System Action: The trigger package is not copied,
If object-type is PACKAGE, object-name is the
rebound, or freed.
name of the package in the format
System Programmer Response: Check the ’location-id.collection-id.package-id.(version-id)’.
SYSIBM.SYSPACKAGE catalog table for names of
schema-name
existing trigger packages. Re-invoke the bind
The schema name specified in the bind option
subcommand with a ’collection.package’ that is not a
PATH causing the SQL Path to exceed 254
trigger package.
characters.
System Action: The bind-type operation is not
DSNT265I csect-name bind-type bind-subtype
performed.
ERROR USING auth-id AUTHORITY
PACKAGE package-name IS NOT A User Response: In the bind option PATH, specify a
TRIGGER PACKAGE schema name list that does not cause the SQL Path to
exceed 254 characters.
Explanation: The subcommand REBIND TRIGGER
PACKAGE can be used only for trigger packages. For more information about the bind option PATH and
the schema name list, please see: Commmand
bind-type
Reference.
Type of bind subcommand: REBIND
System Programmer Response: See the 'User
bind-subtype
Response' section of this message.
Subtype of bind subcommand: TRIGGER
388 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT267I • DSNT271I
a program change is necessary. SQLWARNx fields are
DSNT267I csect-name A TRIGGER PACKAGE
described in Appendix C of DB2 SQL Reference . A
CANNOT BE FREED USING THE FREE
change to the application may be necessary or the
PACKAGE COMMAND
system programmer may have to be consulted
Explanation: A FREE PACKAGE command was depending on the situation.
received that identified the trigger package to be freed.
If you suspect an error in DB2, refer to Part 2 of DB2
Trigger packages can only be deleted using the DROP
Diagnosis Guide and Reference for information on
TRIGGER SQL statement.
identifying and reporting the problem.
System Action: The TSO Attachment Facility is ready
Problem Determination: Collect the following
for more input.
diagnostic items listed in “Appendix B. Problem
User Response: Use the SQL statement DROP determination” on page 1281: 1, 2, 5.
TRIGGER to delete the trigger package.
DSNT271I THE FOLLOWING SQLCA
DSNT268I csect-name A BIND COMMAND USING INFORMATION WAS RETURNED FROM
THE COPY OPTION NAMED A subsystem
TRIGGER PACKAGE AS THE SOURCE
:
FOR THE BIND
SQLCODE = sqlcode
Explanation: A trigger package cannot be used as the SQLSTATE = sqlstate
source for a BIND COPY command. SQLERRMT = tokens
SQLWARN warn_fields
System Action: The TSO Attachment Facility is ready
STATEMENT = stmt_num
for more input.
Explanation: A warning or error has been received
User Response: Correct the BIND command and
from a database server using advanced SQL protocols
resubmit.
(ASP) of the Distributed Relational Database
Architecture (DRDA), during remote program BIND
DSNT270I THE FOLLOWING SQLCA processing. The tokens of the message are:
INFORMATION WAS RETURNED FROM 1. subsystem - database server,
subsystem 2. sqlcode - SQL return code,
3. sqlstate - additional set of return codes common to
: the four relational products,
SQLCODE = sqlcode 4. tokens - specific tokens passed in the message
SQLSTATE = sqlstate portion of the SQLCA for problem determination,
SQLERRMT = tokens 5. warn_fields - the warning information indicators, and
SQLWARN warn_fields 6. stmt_num - the statement number of the failing
Explanation: A warning or error has been received statement.
from a database server using Advanced SQL protocols
(ASP) of the Distributed Relational Database This message is issued by the following CSECT:
Architecture (DRDA), during remote program BIND DSNLXMSG
processing. The tokens of the message are:
System Action: See the System Action associated
1. subsystem - the database server,
with the indicated SQLCODE.
2. sqlcode - SQL return code,
3. sqlstate - additional set of return codes common to System Programmer Response: Take note of the
the four relational products, warning or error (as indicated in the SQLCODE,
4. tokens - specific tokens passed in the message SQLSTATE, or one or more of the SQLWARN fields),
portion of the SQLCA for problem determination, and determine if a program change is necessary.
and SQLWARNx fields are described in Appendix C of DB2
5. warn_fields - the warning information indicators. SQL Reference . A change to the application may be
necessary or the system programmer may have to be
This message is issued by the following CSECT: consulted depending on the situation.
DSNLXMSG
If you suspect an error in DB2, refer to Part 2 of DB2
System Action: See the System Action associated Diagnosis Guide and Reference for information on
with the indicated SQL return code. identifying and reporting the problem.
System Programmer Response: See the Problem Determination: Collect the following
Programmer Response associated with the indicated diagnostic items listed in “Appendix B. Problem
SQLCODE and/or SQLSTATE. Take note of the warning determination” on page 1281: 1, 2, 5.
or error (as indicated in the SQLCODE, SQLSTATE, or
one or more of the SQLWARN fields), and determine if
Chapter 17. DB2 Messages 389
DSNT300I • DSNT306I
DSNT300I AUTH-ID authorization-id NOT DSNT305I SUBSYSTEM FAILURE DURING
AUTHORIZED TO PERFORM function command-name DATABASE COMMAND
ON DATABASE dbname. REQUEST PROCESSING. RC = yy, REASON = zz
REJECTED
Explanation: An error was found while processing the
Explanation: The invoker’s 'authorization-id' as -START, -STOP or -DISPLAY DATABASE command. In
designated by AUTHORIZATION ID is not authorized to the message, 'command-name' is the string 'DISPLAY',
perform the specified database control command 'STOP', or 'START' (depending upon the command
function on this database. The 'function' is either processed).
-START, -STOP, or -DISPLAY. The name of the
System Action: Originating from CSECT DSNTDCST:
database is 'dbname'.
v For relational data system (RDS) subcomponent
System Action: The request is rejected. errors:
– 'yy' is a 4-byte return code of 8.
User Response: Notify the system programmer.
– 'zz' is a 4-byte abend code of '00E30085'.
System Programmer Response: The privilege to v For data manager (DM) subcomponent errors:
issue the command must be granted to the indicated – 'yy' is a 4-byte return code consisting of a 2-byte
'authorization-id'. return code and a 2-byte reason code returned by
the data manager function invoked by
DSNTDCST.
DSNT301I INVALID DATABASE dbname – 'zz' is a 4-byte abend code '00E30086'.
Explanation: The databases named in the -START, A record is written to SYS1.LOGREC, and an SVC
-STOP, or -DISPLAY DATABASE command do not exist. dump is requested before the execution unit is
The name of the database is 'dbname'. abended.
System Action: The request is rejected. This
message may be repeated. Originating from CSECT DSNTDDIS:
v 'yy' is a 4-byte return code of 12.
System Programmer Response: Reissue the v 'zz' is a 4-byte abend code of '00E30089'.
command with a valid name. The request is abended.
DSNT302I INVALID NAME spname Originating from CSECTs DSNTDMUL or DSNTDMSG:
v 'yy' is a 4-byte return code returned by the message
Explanation: In the message, 'spname' is the name of generator.
the table space or index space. The 'spname' specified v 'zz' is a 4-byte abend code of '00E30084'.
in the SPACENAM keyword on the -START, -STOP, or
-DISPLAY DATABASE command does not exist. The request is abended.
System Action: The request is rejected. This System Programmer Response: Refer to “Part 4.
message may be repeated. DB2 Codes” on page 707 for the particular abend
reason code issued.
System Programmer Response: Reissue the
command with a valid table space name or index name. Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 1, 2, 5, 17.
DSNT304I csect-name INSTALLATION SYSOPR IS
NOT AUTHORIZED TO CHANGE
OBJECT STATUS ON DATABASE DSNT306I RESPONSE MESSAGE LIMIT HAS
dbname. REQUEST IS REJECTED. BEEN REACHED
Explanation: INSTALLATION SYSOPR is not Explanation: A fixed amount of space exists in which
authorized to perform the START DATABASE command to generate DISPLAY, START, or STOP database
function on this database because the command can command messages. This message indicates that the
change an objects status in this database. INSTALL DISPLAY, START, or STOP database command that
SYSOPR can use the START DATABASE command was specified generated more messages than will fit in
only to recover LPL pages or GRECP objects. The that space.
name of the database is dbname. User Response: Specify individual databases and/or
System Action: The request is rejected. table spaces rather than specifying '*' (that is, all
names).
Operator Response: Reissue the -START DATABASE
command using the correct access mode or contact
your system programmer.
390 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT307I • DSNT310I
v The 'state' is:
DSNT307I INVALID RANGE SPECIFICATION
string1 IS GREATER THAN string2 – START RW, if the specified object is currently
started read/write
Explanation: A range was specified on a DISPLAY
– START RO, if the specified object is currently
DB(string1:string2) or DISPLAY DB(..)
started read only
SPACENAM(string1:string2) command or on a database
command (START DB, STOP DB, or DISPLAY DB) on – START UT, if the specified object is currently
PART(string1:string2) keywordwhere the first string, started for utility processing
specified alphanumerically, collates after the second – STOPPED, if the specified object is currently
string. stopped or is stopping
User Response: Specify the command again. Make – STOP PENDING, if the specified object currently
sure the first string does not alphanumerically collate is in stop pending status.
after the second string specified.
If there are pages in the logical page list (LPL) for the
object, or if the object is in group buffer pool recovery
DSNT308I AFTER KEYWORD ONLY VALID FOR A pending (GRECP) status, a START DATABASE
SINGLE DATABASE OR A SINGLE ACCESS(RO) or START DATABASE ACCESS(RW)
TABLESPACE/INDEXSPACE WITHIN A command triggers a recovery of that object even if this
DATABASE. REQUEST REJECTED message is issued for that object. For each object that
Explanation: The AFTER keyword may be specified has LPL or GRECP recovery that is initiated, DB2
by one of the following: issues a DSNI006 message followed by either a
DSNI021 message (when the recovery completes
v A single database name after the keyword
successfully) or a DSNI005 message (when the
DATABASE
recovery is unsuccessful).
v A single table space name or index space name after
the keyword SPACENAM. User Response: No response is necessary. This
message is informational only.
User Response: Specify the command correctly.
DSNT310I csect-name ALL object CURRENTLY
DSNT309I csect-name object_name IS CURRENTLY state.
state.
Explanation: A database and all of its table spaces
Explanation: One of the following is already in the and index spaces are already in the requested state.
requested state: This occurred following the processing of one of these
v A database listed in START DB(list) or STOP DB(list) commands:
v A table space listed in START DB(name) v START DB(*)
SPACENAM(list) or STOP DB(name) v STOP DB(name)
SPACENAM(list) v START DB(name) SPACENAM(*)
v STOP DB(name) SPACENAM(*).
v An index space listed in START DB(name)
SPACENAM(list) or STOP DB(name)
In this message:
SPACENAM(list)
v The 'object' is either:
v A partition of a partitioned table space listed in
START DB(list) SPACENAM(list) PART(n), STOP – TABLESPACE(S) if the specified table space was
DB(list) SPACENAM(list) PART(n), START DB(list) currently in the requested state
SPACENAM(list), or STOP DB(list) SPACENAM(list) – INDEXSPACE(S) if the specified index space was
currently in the requested state
In the message: – DATABASE(S) if the database was currently in the
v The 'object' is the database, table space, index space requested state.
or partition number with table space name or the v The 'state' is either:
index space name.
– START RW if the specified table space is currently
– TABLESPACE, if the specified table space was started read/write
currently in the requested state
– START RO if the specified table space is currently
– INDEXSPACE, if the specified index space was started read only
currently in the requested state
– START UT if the specified table space is currently
– DATABASE, if the database was currently in the started for utility processing
requested state
– STOPPED if the specified table space is currently
– PARTITION, if the specified partition of a stopped, has a stop pending against it, or is
partitioned table space or partitioned index was stopping.
currently in the requested state
Chapter 17. DB2 Messages 391
DSNT311I • DSNT315I
If there are pages in the logical page list (LPL) for the The object object-name can be either a table space or
object, or if the object is in group buffer pool recovery an index space.
pending (GRECP) status, a START DATABASE
ACCESS(RO) or START DATABASE ACCESS(RW) No action for this table space or index space is
command triggers a recovery of that object even if this performed by the START DATABASE, STOP
message is issued for that object. For each object that DATABASE or DISPLAY DATABASE command.Any
has LPL or GRECP recovery that is initiated, DB2 other valid table space or index space specified is
issues a DSNI006 message followed by either a processed by the command.
DSNI021 message (when the recovery completes
successfully) or a DSNI005 message (when the Severity: 8 (error)
recovery is unsuccessful). System Action: The desired command is not
User Response: No response is necessary. This processed for the table space or index space in
message is informational only. question. All other valid table spaces or index spaces
specified in the command are processed.
DSNT311I MESSAGE LIMIT EXCEEDED. DISPLAY User Response: Resubmit the command for the
IS TERMINATED. nonpartitioned table space or index space without using
the PART keyword.
Explanation: The number of messages generated
exceeds the maximum number of messages specified in Problem Determination: SYSIBM.SYSTABLESPACE
the LIMIT keyword or exceeds the system default. in the DB2 catalog indicates whether a table space is
partitioned. SYSIBM.SYSINDEXSPACE in the DB2
catalog indicates whether an index space is partitioned
DSNT312I object name MUST BE STARTED RW. and whether the index space is a type 1 or a type 2
NO ACTION TAKEN. index. Type 2 nonpartitioned indexes can be started,
stopped, or displayedat the logical partition level; type 1
Explanation: The ACCESS keyword is either RO or
cannot.
UT, and the object must be started ACCESS (RW).
In the message, 'object' is either:
DSNT315I csect_name INVALID PARTITION
v TABLESPACE(S) IN if the START DB(name)
NUMBER OR RANGE SPECIFIED -
SPACENAM(...) is specified, or
part-numFOR OBJECT object-name
v DATABASE if the START DB(name) is specified.
Explanation: An invalid partition number or rangewas
specified in the PART keyword for a START
DSNT313I ACCESS(FORCE) IS VALID ONLY WITH
DATABASE, STOP DATABASE or DISPLAY DATABASE
EXPLICIT TABLESPACE OR
command.
INDEXSPACE NAMES. COMMAND IS
REJECTED Partition number or range part-numis invalid for the
object object-name.
Explanation: The ACCESS(FORCE) keyword can be
specified when either: Severity: 8 (error)
v A single table space or index space name appears System Action: The part number or rangeis ignored.
after the keyword SPACENAM in a START All other valid partitions specified are processed if PART
DATABASE command. was specified as list.
v A list of table space and/or index space names
appears after the keyword SPACENAM in a START User Response: Determine the correct partition
DATABASE command. specification for the table space or index that was the
subject of the specified command and resubmit the
Operator Response: Specify the command correctly. command.
Problem Determination: SYSIBM.SYSTABLESPACE
DSNT314I csect_name INVALID PARTITION in the DB2 catalog indicates the correct range of
SPECIFICATION FOR OBJECT partition numbers for the table space.
object-name SYSIBM.SYSINDEXSPACE in the DB2 catalog
indicates whether an index space is partitioned and
Explanation: The PART keyword is invalidly specified
whether the index space is a type 1 or a type 2 index.
in a START DATABASE, STOP DATABASE, or
Type 2 indexes can be started, stopped, or displayedat
DISPLAY DATABASE command.
the logical partition level; type 1 cannot.
The PART keyword is invalid if it is specified for:
v A nonpartitioned table space
v A nonpartitioned type 1 index
v A type 2 index not defined on a partitioned table
space
392 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT316I • DSNT358I
on all members of the DB2 data sharing group.
DSNT316I csect-name A LOGICAL PARTITION OF
AN INDEX WHICH HAS PAGES IN THE
LPL OR HAS BEEN MARKED GRECP DSNT332I TABLESPACES AND INDEXSPACES
CANNOT BE STARTED FOR RW OR ARE UNAVAILABLE BECAUSE
RO ACCESS DATABASE name IS STOPPED
Explanation: The START DATABASE command was Explanation: The database 'name' is currently marked
specified for a logical partition of a nonpartitioned index as stopped. Consequently, its table spaces and index
which has pages in the logical page list (LPL) or is spaces are unavailable even though they may have
marked group buffer pool recovery pending (GRECP). been started.
To start a nonpartitioned index with one of these
exception conditions, the START DB command must be
specified without the PART keyword. DSNT350I –luw-id ACCESSING DATA FOR
location
Severity: 8 (error)
Explanation: This message follows message
System Action: The command is not processed for DSNT394I or DSNT396I for each thread reported that is
the index space. All other valid table spaces or index participating in distributed data access (database
spaces specified in the command are processed. access thread). This additional line reports the
distributed identification as follows:
User Response: Submit the command for the
nonpartitioned index space without using the PART luw-id=token
keyword. The logical-unit-of-work identifier (LUW-ID) is a
unique identifier that is assigned to the thread
Problem Determination: If more information on the
followed by an '=' sign and a token. The token
status of the index space is required, use the -DISPLAY
can be used in place of luw-id in any DB2
DATABASE command.
command that accepts luw-id as input.
location
DSNT317I csect-name ANY USER-DEFINED
The LOCATION name assigned to the
INDEXES ON DSNDB06 COULD NOT
requesting site.
BE cmd-type DUE TO A RESOURCE
UNAVAILABLE ON THE CATALOG OR
DIRECTORY. The message number and subsystem recognition
character are not included in this message.
Explanation: If user-defined indexes exist on
DSNDB06, they could not be displayed, started or This message is issued by the following CSECT:
stopped (depending on cmd-type) because the catalog DSNTDMUL
or directory was not available. DB2-defined indexes and
table spaces are not affected by this unavailability.
DSNT358I csect_name INVALID PARTITION
Programmer Response: When you get this message, SPECIFICATION FOR OBJECT
correct the resource unavailable problem and reissue object-name
the command.
Explanation: Specification of the PART keyword in a
System Action: Any user-defined indexes on DISPLAY DATABASE command is invalid.
DSNDB06 were not affected by the command issued.
All other table spaces and index spaces were The PART keyword is invalid if it is specified for:
processed by the command. v A nonpartitioned table space
v A nonpartitioned type 1 index
v A type 2 index not defined on a partitioned table
DSNT331I csect-nameDATABASE name AND ANY space
SPACE IT CONTAINS CANNOT BE
STOPPED. IT IS THE ACTIVE The object object-name can be either a table space or
COMMUNICATIONS DATABASE an index space.
Explanation: The database specified in the message
cannot be stopped because it is the active No action for this table space or index space is
communications database. In addition, spaces within performed by the DISPLAY DATABASE command. Any
the active communications database cannot be stopped. other valid table space or index space specified is
processed by the command.
System Action: Nothing is stopped.
Severity: 8 (error)
Operator Response: If the database or any space
within it must be stopped, you must stop the distributed System Action: The desired command is not
data facility (STOP DDF). In a DB2 data sharing processed for the table space or index space in
environment, you must stop the distributed data facility question. All other valid table spaces or index spaces
Chapter 17. DB2 Messages 393
DSNT359I • DSNT363I
specified in the command are processed. GLOBAL
All requested database information is listed.
User Response: Resubmit the command for the
This title is produced if ACTIVE, DISABLED,
nonpartitioned table space or index space without using
and RESTRICT are omitted.
the PART keyword.
LOCKS
Problem Determination: SYSIBM.SYSTABLESPACE
The connection identifiers and correlation
indicates whether a table space is partitioned.
identifiers of all applications holding, retaining,
SYSIBM.SYSINDEXSPACE indicates whether an index
or waiting for locks on the specified table
space is partitioned and whether the index space is a
spaces or index spaces are displayed.
type 1 or a type 2 index. Type 2 nonpartitioned indexes
can be displayed at the logical partition level; type 1 RESTRICT
indexes cannot. All databases with restricted usage (that is,
RO, started UT) are listed.
DSNT359I csect_name INVALID PARTITION USE The connection identifiers and correlation
NUMBER SPECIFIED - part-num FOR identifiers of all allocated applications are
OBJECT object-name listed.
Explanation: An invalid partition number was specified CLAIMERS
in the PART keyword for a DISPLAY DATABASE The connection identifiers and correlation
command. identifiers of all applications holding claims on
the specified database are displayed.
Partition number part-num is invalid for the object
object-name. LPL The page number ranges of the pages that are
included in the logical page list for the table
Severity: 8 (error)
space or index space.
System Action: The part number is ignored. All other
valid partitions specified are processed.
DSNT362I DATABASE = data-base-name STATUS
User Response: Determine the correct partition = status DBD LENGTH = dbd-length
specification for the table space or index that was the
Explanation: This message signals the beginning of
subject of the specified command and resubmit the
display information from the DISPLAY DATABASE
command.
command. It lists the name, status, and DBD length of
Problem Determination: SYSIBM.SYSTABLESPACE the database. All table space and index space names
in the DB2 catalog indicates the correct range of listed in the following DSNT392I, DSNT394I, or
partition numbers for the table space. DSNT396I messages are contained within this
SYSIBM.SYSINDEXSPACE in the DB2 catalog database.
indicates whether an index space is partitioned and
data-base-name
whether the index space is a type 1 or a type 2 index.
The database name.
The PART keyword can be used to display the status of
logical partitions of type 2 indexes but not type 1 status A combination of one or more of the following
indexes. strings delimited by a comma. The maximum
length of the string is 18 characters.
DSNT360I ******************************** RO The database is started for read
activity only.
Explanation: This message consists of 35 asterisks
that begin the display of any database and the display RW The database is started for read and
of space names for any database. write activity.
STOP The database is stopped.
DSNT361I *DISPLAY DATABASE SUMMARY*
STOPP A stop is pending or is in progress for
report-type-list
this database.
Explanation: This message is a multiple-line message
UT The database is started for utility
that labels the requested set of databases, table
processing only.
spaces, and index spaces.
In the message, 'report-type-list' lists all options
DSNT363I PHYSICAL ERROR PAGE RANGE FOR
specified on the command delimited by spaces.
DATA SET data-set-name LOW=lowphy,
Possible values are:
HIGH=hiphy
ACTIVE
Explanation: This message is the response to a
All allocated databases are listed.
-DISPLAY DATABASE command when the SPACENAM
394 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT364E • DSNT375I
keyword is specified in order to notify the user of any Note that either DSNT301I or DSNT302I is produced if
physical I/O errors encountered on a data set. no object is found and the keywords ACTIVE and
RESTRICT are omitted.
In the message, 'data-set-name' is the name of the data
set with errors. The variables 'lowphy' and 'hiphy' System Action: Processing continues normally.
identify the range of physical pages, within the data set,
that were being read when the I/O errors occurred.
DSNT368W csect-name MORE THAN ONE
Physical page numbers are assigned in relationship to
MUTUALLY EXCLUSIVE KEYWORD
the beginning of the data set in which the pages reside.
WAS SPECIFIED IN THE DISPLAY
This message is always preceded by messages DATABASE COMMAND.
DSNT360I and DSNT361I, which identify the name of
Explanation: The keywords, LOCKS, LPL,
the database and page set that the specified data set
CLAIMERS, WEPR and USE are mutually exclusive.
supports.
Only one should be specified in a DISPLAY DATABASE
Page sets (table spaces or index spaces) are made up command. The precedence order for which keyword
of supporting data sets. Physical pages are pages in takes precedence over the others is:
supporting data sets that are numbered from the 1. LPL
beginning of the particular data set in which they reside. 2. CLAIMERS
This message refers to physical pages in a data set that 3. LOCKS
support (are part of) some page set. 4. USE
5. WEPR
System Action: See the Explanation section for this
message. System Action: The DISPLAY DATABASE command
is processed with this warning message.
DSNT364E csect-name KEYWORD ONLY IS USED User Response: Remove keywords from DISPLAY
INCORRECTLY DATABASE command until only one of these mutually
exclusive keywords is specified.
Explanation: Keyword ONLY is used incorrectly in the
DISPLAY DATABASE command. When the SPACENAM
keyword is specified, keyword ONLY is valid only if one DSNT367I NO INFORMATION AVAILABLE
of the following keywords is also used:
Explanation: This message indicated there is no
LOCKS
LOCK, USE, LPL, WEPR or CLAIMER information
LPL
available when DISPLAY DB(...) SPACENAM(...) ONLY
CLAIMERS
is entered with the keywords LOCKS, USE, LPL, WEPR
WEPR
or CLAIMERS.
USE
System Action: The process continues normally.
System Action: The DISPLAY DATABASE command
is not processed.
DSNT375I PLAN=plan-id1 WITH
User Response: Add one of the keywords mentioned
CORRELATION-ID=id1
above in the explanation to the DISPLAY DATABASE
CONNECTION-ID=id2 LUW-ID=id3
command and issue the command again.
THREAD-INFO=id4 IS DEADLOCKED
WITH PLAN=plan-id2 WITH
DSNT365I NO DATABASES FOUND CORRELATION-ID=id5
CONNECTION-ID=id6 LUW-ID=id7
Explanation: This message is produced when a
THREAD-INFO= id8 ON MEMBER id9
DISPLAY DB(name) is entered and no databases were
found to satisfy the request. Explanation: This message is issued whenever plan
plan-id1 with correlation id1, connection id2, and LUW
System Action: The process continues normally.
id3 is denied an IRLM lock because of a detected
deadlock. Plan plan-id2 identifies one of the members of
DSNT366I DATABASE name NOT type the deadlock.
Explanation: A database listed in the DISPLAY DB(...) DB2 does not attempt to identify all survivors of a
is not of the correct type. The variables are as follows: deadlock or all participants in a deadlock in the
DSNT375I message. Plan plan-id2 in message
name The name of the object. DSNT375I might be just one of several plans holding
type The type of request specified: ACTIVE, locks on the desired resource.
RESTRICTED, ACTIVE OR RESTRICTED If multiple deadlocks are detected during the same
deadlock-detection interval, the lock holder identified by
plan-id2 in one DSNT375I message might be selected
to break a deadlock identified by a different DSNT375I
Chapter 17. DB2 Messages 395
DSNT375I
message. The lock holder identified by plan-id2 is not LUW-ID. If the LUW-ID is not an asterisk, the
guaranteed to be a winner in all deadlocks in which it value is a logical-unit-of-work-identifier that is
participates. assigned to the thread followed by an equal (=)
sign and a token value, which can be used in
A DB2 IFCID 172 trace record contains the information
place of logical-unit-of-work identifier in any
needed to determine all participants in, and survivors of,
DB2 command that accepts logical-unit-of-work
a given deadlock.
identifier as input.
plan-id1, plan-id2
| id8 This ID contains additional identifiers that
The names of the executing plans.
| define more specific information regarding the
id1 The correlation identifier of the thread | identity of the agent.
associated with plan-id1. Correlation IDs
| In many distributed configurations, the primary
beginning with '0nn', where 'nn' is a number
| authorization-ID used with DB2 is not
from 01 to 28, identify a system agent.
| necessarily the user-ID of the end-user. If
id2 The connection identifier of the thread | provided by the client, the additional tokens
associated with plan-id1. | further assist in identifying the client end-user.
id3 The logical-unit-of-work identifier of the thread | The following identifiers, separated by a colon
associated with plan-id1. An asterisk (*) | (:), are provided:
indicates that the thread does not have an | v The primary authorization-ID associated with
LUW-ID. If the LUW-ID is not an asterisk, the | the thread.
value is a logical-unit-of-work identifier that is
| v Workstation name of the end-user’s
assigned to the thread. It is followed by an
| workstation. An asterisk (*) indicates it is not
equal (=) sign and a token value, which can be
| relevant to the thread or was not provided
used in place of the logical-unit-of-work
| by the client.
identifier in any DB2 command that accepts a
logical-unit-of-work identifier as input. | v End-user’s user-ID. An asterisk (*) indicates
| it is not relevant to the thread or was not
| id4 This ID contains additional identifiers that | provided by the client.
| define more specific information regarding the
v Application name of the end-user’s
|
| identity of the agent.
| application. An asterisk (*) indicates that is
| In many distributed configurations, the primary | not relevant to the thread or was not
| authorization-ID used with DB2 is not | provided by the client.
| necessarily the user-ID of the end-user. If
id9 Identifies the member name of the DB2
| provided by the client, the additional tokens
subsystem on which the thread associated with
| further assist in identifying the client end-user.
plan-id2 is executing.
| The following identifiers, separated by a colon
| (:), are provided: DB2 can recover from a lock denial in some cases and
| v The primary authorization-ID associated with can complete successfully. In such a case, the SQLCA
| the thread. is not filled in. One example is during setup of
performance enhancements during bind time for
| v Workstation name of the end-user’s
execution time.
| workstation. An asterisk (*) indicates it is not
| relevant to the thread or was not provided
The SQLCA corresponding to correlation id id1,
| by the client.
connection id id2, and LUW-ID id3 contains an
| v End-user’s user-ID. An asterisk (*) indicates SQLCODE of -904, -911, -913, or -923 and the name of
| it is not relevant to the thread or was not the resource involved in the deadlock.
| provided by the client.
| v Application name of the end-user’s If you receive a system plan in this message, see the
| application. An asterisk (*) indicates that is information about system plans in message DSNT376I.
| not relevant to the thread or was not
| provided by the client. Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
id5 The correlation identifier of the thread determination” on page 1281: 1, 2, 5, 18.
associated with plan-id2.
id6 The connection identifier of the thread
associated with plan-id2.
id7 The logical-unit-of-work identifier of the thread
associated with plan-id2. An asterisk (*)
indicates that the thread does not have an
396 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT376I
| v End-user’s user-ID. An asterisk (*) indicates
DSNT376I PLAN=plan-id1 WITH
| it is not relevant to the thread or was not
CORRELATION-ID=id1
| provided by the client.
CONNECTION-ID=id2 LUW-ID=id3
THREAD-INFO=id4 IS DEADLOCKED | v Application name of the end-user’s
WITH PLAN=plan-id2 WITH | application. An asterisk (*) indicates that is
CORRELATION-ID=id5 | not relevant to the thread or was not
CONNECTION-ID=id6 LUW-ID=id7 | provided by the client.
THREAD-INFO= id8 ON MEMBER id9 id5 The correlation identifier of the thread
Explanation: This message is issued whenever plan associated with plan-id2. If the execution of the
plan-id1 with correlation id1, connection id2, and LUW plan was switched by DB2 to a system agent,
id3 is denied a lock by IRLM, because the amount of the correlation identifier identifies the system
time to wait for a locked resource was exceeded. Plan agent. Correlation IDs beginning with '0nn',
plan-id2 identifies one of the plans holding a lock on the where 'nn' is a number from 01 to 28, identify
desired resource. The listed plan is not necessarily system agents.
responsible for the time-out condition. id6 The connection identifier of the thread
plan-id1, plan-id2 associated with plan-id2. If the execution of the
The names of the executing plans. plan was switched by DB2 to a system agent,
the connection identifier is the DB2 subsystem
id1 The correlation identifier of the thread name.
associated with plan-id1. If the execution of the
plan was switched by DB2 to a system agent, id7 The logical-unit-of-work identifier of the thread
the correlation identifier identifies the system associated with plan-id2. An '*' indicates that
agent. Correlation IDs beginning with '0nn', the thread does not have a LUW-ID. If the
where 'nn' is a number from 01 to 28, identify LUW-ID is not an '*', the value is a
system agents. logical-unit-of-work-ID that is assigned to the
thread followed by an "=" sign and a token
id2 The connection identifier of the thread value, which can be used in place of
associated with plan-id1. If the execution of the logical-unit-of-work-ID in any DB2 command
plan was switched by DB2 to a system agent, that accepts logical-unit-of-work-ID as input.
the connection identifier is the DB2 subsystem
name. | id8 This ID contains additional identifiers that
| define more specific information regarding the
id3 The logical-unit-of-work identifier of the thread | identity of the agent.
associated with plan-id1. An '*' indicates that
the thread does not have a LUW-ID. If the | In many distributed configurations, the primary
LUW-ID is not an '*', the value is a | authorization-ID used with DB2 is not
logical-unit-of-work-ID that is assigned to the | necessarily the user-ID of the end-user. If
thread followed by an "=" sign and a token | provided by the client, the additional tokens
value, which can be used in place of | further assist in identifying the client end-user.
logical-unit-of-work-ID in any DB2 command | The following identifiers, separated by a colon
that accepts logical-unit-of-work-ID as input. | (:), are provided:
| id4 This ID contains additional identifiers that | v The primary authorization-ID associated with
| define more specific information regarding the | the thread.
| identity of the agent. | v Workstation name of the end-user’s
| In many distributed configurations, the primary | workstation. An asterisk (*) indicates it is not
| authorization-ID used with DB2 is not | relevant to the thread or was not provided
| necessarily the user-ID of the end-user. If | by the client.
| provided by the client, the additional tokens | v End-user’s user-ID. An asterisk (*) indicates
| further assist in identifying the client end-user. | it is not relevant to the thread or was not
| The following identifiers, separated by a colon
| provided by the client.
| (:), are provided: | v Application name of the end-user’s
v The primary authorization-ID associated with
| application. An asterisk (*) indicates that is
|
| the thread.
| not relevant to the thread or was not
| provided by the client.
| v Workstation name of the end-user’s
| workstation. An asterisk (*) indicates it is not id9 Identifies the member name of the DB2
| relevant to the thread or was not provided subsystem on which the thread associated with
| by the client. plan-id2 is executing.
Chapter 17. DB2 Messages 397
DSNT376I
DB2 can recover from a lock denial in some cases and lock escalation to a table or table space lock. The
can complete successfully. In such a case, the SQLCA timeout can be resolved by changing the value on
is not filled in. One example is during setup of the DSNTIPK update panel or by binding the
performance enhancements during bind time for application’s plan with RELEASE(COMMIT) and
execution time. doing commits more frequently.
3. You can use EXPLAIN (described in Part 5 of
The SQLCA corresponding to correlation-ID id1, DB2 Application Programming and SQL Guide)
connection-ID id2, and LUW-ID id3 contains an with the failing SQL statement and check the
SQLCODE of -904 or -923 and the name of the TSLOCKMODE column for every table/table
resource involved in the timeout. space in the EXPLAIN output. If the competing
applications are attempting to obtain incompatible
Several different system plans can appear in plan-id1 locks, you might be able to resolve the timeout by
and plan-id2. These system plans are not documented running the applications sequentially rather than
in SYSIBM.SYSPLAN. If you receive a system plan in concurrently or by following the suggestions in
this message, you are in contention with another user. If other steps listed here, such as changing lock
you are not doing an automatic rebind, message size, ACQUIRE/RELEASE parameters or
DSNT500I or DSNT501I might accompany this ISOLATION type.
message and identify that resource. If you need 4. Check the ACQUIRE/RELEASE values specified
additional information, refer to the SQLCA and any on the plan. ACQUIRE(ALLOCATE) acquires all
additional bind messages. If you are doing an auto locks for all tables and table spaces referenced in
rebind, the SQLCA is not available. Refer to Part 5 of the plan, even if the program logic does not
DB2 Application Programming and SQL Guide for more cause the table/table space to be accessed.
information about automatic rebinding. The system Binding with RELEASE(DEALLOCATE) causes
plans are: table, table space and DBD locks to be held
ACT longer than binding with RELEASE(COMMIT),
BCT possibly causing a timeout.
DISTSERV
DSNBIND 5. Use the DISPLAY DB LOCKS command during
STARTCT program execution to verify that the locks being
DSNUTIL. held at the time of the timeout are as expected. If
they are not, you may need to use ALTER to
Operator Response: Notify the system programmer. change the locksize of the table space if possible,
or rebind your plan with different ACQUIRE,
System Programmer Response: Timeouts can
RELEASE or ISOLATION values.
happen for many reasons, including factors relating to
DB2 or IRLM. Some of those reasons are listed below 6. ISOLATION level affects the mode of table/table
along with possible ways to reduce or eliminate your space locks chosen and may be of concern if the
timeout. Refer to Part 5 (Volume 2) of DB2 plan is bound with RR and there is a page set
Administration Guide for more detail about the concepts scan.
discussed in this list. See also SQLCODEs -911 and v Check the ISOLATION level specified on the plan in
-913. SYSIBM.SYSPLAN. A value of RR is more likely to
cause a timeout because it requires more page or
Timeouts can result from the definition of objects or the
row locks and also has a greater potential than CS
structure of applications as explained below.
for causing lock escalation, which can cause timeouts
v If the resource involved in the timeout is listed in the as noted above.
DSNT500I/DSNT501I message as a table or table
v Check the frequency of COMMITs in the application.
space, check the following items for other possible
A large number of updates without any COMMITs can
causes of timeout:
cause a timeout because the more pages that are
1. Check the LOCKRULE column value in changed, the more page or row locks held, and the
SYSIBM.SYSTABLESPACES for the table space greater potential for lock escalation.
being accessed. A lock size of TABLE or
TABLESPACE could cause a timeout. If your This condition might be caused by an undetected
application does not need to lock the entire table deadlock, for example, an agent holding a lock on the
or table space, you can resolve the timeout by resource for a period of time that exceeds either the
changing the lock size to PAGE or ANY using the specified time or the IRLM default wait time.
ALTER statement.
2. Check the number of LOCKS PER If the time limit is too small, you can increase the limit
TABLE(SPACE), which was set at the time DB2 by specifying a new IRLM locked resource wait time
was installed. If a large number of page or row limit. To do this, you can either use the parameter in the
locks are acquired and held, a small value for DSN6SPRM assembler macro in the DSNTIJUZ job
LOCKS PER TABLE(SPACE) could be causing stream or update the 'wait-time' field of the DB2
398 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT377I • DSNT378I
installation IMS Resource Lock Manager panel, | v Workstation name of the end-user’s
IRLMRWT. You must also specify all other parameters | workstation. An asterisk (*) indicates it is not
contained in this version of the CSECT. Then do one of | relevant to the thread or was not provided
the following: | by the client.
v Resubmit installation job DSNTIJUZ with the link-edit | v End-user’s user-ID. An asterisk (*) indicates
SYSIN file 'NAME' parameter that matches the | it is not relevant to the thread or was not
-START DB2 'PARM=' parameter. | provided by the client.
v Reassemble DSN6SPRM and relink-edit DSNZPARM | v Application name of the end-user’s
by resubmitting installation job DSNTIJUZ. The | application. An asterisk (*) indicates that is
link-edit SYSIN file 'NAME' parameter must match the | not relevant to the thread or was not provied
-START DB2 'PARM=' parameter. | by the client.
Problem Determination: Collect the following id5 Identifies the member name of the DB2
diagnostic items listed in “Appendix B. Problem subsystem on which the indoubt thread is
determination” on page 1281: 1, 2, 5, 9, 18. executing.
The SQLCA corresponding to correlation-ID id1,
DSNT377I PLAN=plan-id1 WITH
connection-ID id2, and LUW-ID id3 contains an
CORRELATION-ID=id1
SQLCODE -904, -911, -913, or -923 and the name of
CONNECTION-ID=id2 LUW-ID=id3
the resource currently being recovered by DB2.
THREAD-INFO=id4 IS IN CONFLICT
WITH AN INDOUBT THREAD ON
MEMBER id5 If you receive a system plan in this message, see the
information about system plans in message DSNT376I.
Explanation: This message is issued by the service
controller subcomponent. A plan cannot gain an IRLM System Action: Processing continues.
lock because a required resource is currently Problem Determination: Collect the following
undergoing recovery. The message identifies the plan in diagnostic items listed in “Appendix B. Problem
this way: determination” on page 1281: 1, 2, 4.
plan-id1
The name of the executing plan. DSNT378I csect-name PLAN=plan-id1 WITH
id1 The correlation identifier (ID) of the thread CORRELATION-ID=id1
associated with plan plan-id1. Correlation IDs CONNECTION-ID=id2 LUW-ID=id3
beginning with '0nn', where 'nn' is a number THREAD-INFO=id4 TIMED OUT
from 01 to 28, identify system agents. BECAUSE OF A RETAINED LOCK
HELD BY MEMBER id5
id2 The connection-ID of plan plan-id1.
Explanation: A plan cannot get an IRLM lock because
id3 The logical-unit-of-work identifier ('LUW-ID') of the resource is held by a retained lock on behalf of
plan-id1. An '*' indicates that the thread does another member in the data sharing group, and the
not have a LUW-ID. If the LUW-ID is not an '*', amount of time to wait for the locked resource was
the value is a logical-unit-of-work ID that is exceeded. The member holding the retained lock is
assigned to the thread followed by an "=" sign either failed, or is in the process of restarting to recover
and a token value, which can be used in place its retained locks. This message is only issued if the
of logical-unit-of-work-id in any DB2 command RETLWAIT installation parameter in DSN6SPRM is set
that accepts logical-unit-of-work-id as input. to ’YES’. If RETLWAIT is set to ’NO’ (this is the default),
then any IRLM lock that conflicts with a retained lock
| id4 This ID contains additional identifiers that
will not wait, but instead will be immediately rejected
| define more specific information regarding the
(see reason codes 00C900BE and 00C20254).
| identity of the agent.
The following identifiers are used in the message:
| In many distributed configurations, the primary
| authorization-ID used with DB2 is not plan-id1
| necessarily the user-ID of the end-user. If The name of the executing plan.
| provided by the client, the additional tokens
| further assist in identifying the client end-user. id1 The correlation identifier (ID) of the thread
associated with plan plan-id1. Correlation IDs
| The following identifiers, separated by a colon beginning with '0nn', where 'nn' is a number
| (:), are provided: from 01 to 28, identify system agents.
| v The primary authorization-ID associated with id2 The connection-ID of plan plan-id1.
| the thread.
id3 The logical-unit-of-work identifier ('LUW-ID') of
plan-id1. An '*' indicates that the thread does
Chapter 17. DB2 Messages 399
DSNT379I • DSNT382I
not have a LUW-ID. If the LUW-ID is not an '*', System Programmer Response: This is probably a
the value is a logical-unit-of-work id that is user error. Change the IRLMSID parameter in the DB2
assigned to the thread followed by an "=" sign DSN6SPRM initialization macro to match the MVS
and a token value, which can be used in place subsystem table, or start IRLM if IRLM is not already
of logical-unit-of-work-id in any DB2 command up. See return code 00E30079 for further information
that accepts logical-unit-of-work-id as input. about determining the cause of the error.
| id4 This ID contains additional identifiers that
| define more specific information regarding the DSNT380I CANNOT IDENTIFY TO IRLM, SSNAME
| identity of the agent. ALREADY IN USE
| In many distributed configurations, the primary Explanation: Either DB2 previously terminated and did
| authorization-ID used with DB2 is not not successfully sign off from IRLM, or another
| necessarily the user-ID of the end-user. If subsystem is identified to IRLM with this
| provided by the client, the additional tokens installation-defined SSNAME. This message
| further assist in identifying the client end-user. accompanies abend reason code X'00E30071'.
| The following identifiers, separated by a colon System Action: DB2 is abended with an abend code
| (:), are provided: of X'04E'.
| v The primary authorization-ID associated with Operator Response: Notify the system programmer.
| the thread.
System Programmer Response: Either manually stop
| v Workstation name of the end-user’s
IRLM, or change the installation-defined SSNAME.
| workstation. An asterisk (*) indicates it is not
| relevant to the thread or was not provided Problem Determination: Collect the following
| by the client. diagnostic items listed in “Appendix B. Problem
| v End-user’s user-ID. An asterisk (*) indicates determination” on page 1281: 1, 2, 5, 9, 18.
| it is not relevant to the thread or was not
| provided by the client. DSNT381I IRLM QUIT REQUEST FAILED, RC = xx
| v Application name of the end-user’s , SC = yy
| application. An asterisk (*) indicates that is
| not relevant to the thread or was not provied Explanation: During the QUIT (or signoff) request to
| by the client. the IMS/VS Resource Lock Manager, a return code and
subcode were returned indicating an unsuccessful
id5 Identifies the member name of the failed or completion of the request. Refer to “Part 5. IRLM
restarting DB2 subsystem which holds the Messages and Codes” on page 1235, for IRLM return
conflicting retained lock. codes and subcode meanings.
System Action: The SQLCA corresponding to System Action: This message indicates that the DB2
correlation-ID id1, connection-ID id2, and LUW-ID id3 subsystem shutdown could not be completed normally.
contains an SQLCODE -904, -911 , -913 or -923 and
the name of the resource involved in the timeout. Operator Response: Notify the system programmer.
System Programmer Response: Restart the member System Programmer Response: Determine the
holding the retained lock if it has not yet been restarted. cause of the failure from the return code and subcode,
and correct the error. Refer to “Part 5. IRLM Messages
Problem Determination: Collect the following and Codes” on page 1235, for IRLM return codes and
diagnostic items listed in “Appendix B. Problem subcode meanings. DB2 has terminated but has not
determination” on page 1281: 1, 2, 4. signed off from IRLM. It will be necessary to issue the 'F
irlmproc, ABDUMP' command to stop the IRLM. This
must be done before issuing another -START DB2
DSNT379I CANNOT IDENTIFY TO IRLM. INVALID
command.
SSNAME OR IRLM IS NOT
CURRENTLY ACTIVE Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
Explanation: Either an attempt was made to identify
determination” on page 1281: 1, 2, 5, 9, 18.
the IRLM with a subsystem name not recognized by
MVS, or the IRLM is not currently active. This message
is also issued if common service area (CSA) storage is DSNT382I IRLM AUTO-START FAILED
insufficient.
Explanation: During the IDENTIFY to IRLM, the
System Action: DB2 abends with a reason code of AUTO-START of IRLM using SVC 34 failed. This
X'04E'. message accompanies abend code X'00E30080'.
Operator Response: Notify system programmer. System Action: DB2 is terminated with an abend
code of X'04E'.
400 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT383I • DSNT389I
Operator Response: Notify the system programmer.
DSNT389I space type part status conn-id corr-id
System Programmer Response: Determine the claims
cause of failure from the SVC 34 return code preserved
Explanation: This message contains the display
in register 2.
information that results from a -DISPLAY DATABASE
command when the keyword CLAIMERS is specified.
DSNT383I csect-name IRLM AUTO-STOP FAILED This message contains the column data describing the
status of a table space or index space in the database
Explanation: During a sign off from IRLM caused by listed in message DSNT362I.
either DB2 normal shutdown (CSECT DSNTLQUI) or space The table space name or index space name.
DB2 subsystem termination (CSECT DSNTLCLE), an type TS for a table space, IX for an index space, LS
AUTO-STOP of IRLM using SVC 34 failed. If this for a LOB table space.
occurred during normal sign off, this message part The partition number. For a nonpartitioned
accompanies abend reason code X'00E30075'. table space or an index on a nonpartitioned
System Action: DB2 abends. table space, it is blank. For nonpartitioned
indexes on a partitioned table space, it is the
Operator Response: Notify the system programmer. logical partition number preceded by the
System Programmer Response: Manually stop character L (for example, L001).
IRLM. status Blank, or one or more of the following,
delimited by commas. The maximum length of
Problem Determination: Determine the cause of the string is 18 characters.
failure from the SVC return code preserved in register 2. ACHKP
Collect the following diagnostic items listed in The table space is in aux check
“Appendix B. Problem determination” on page 1281: 1, pending state. ACHKP on a table
2, 5, 9. space indicates that CHECK DATA
detected an orphan or missing LOB or
an out-of-sync condition between the
DSNT384I IRLM AUTO-START WAIT TIME row in the base table and the LOB in
EXCEEDED the LOB table space.
AREST The object (a table space, index
Explanation: An attempt was made to automatically
space, or a physical partition of a
start IRLM. However, the wait time specified was
table space or index space) is in an
exceeded.
Advisory Restart Pending state. If
System Action: DB2 is abended. backout activity against the object is
not already underway, it should be
Operator Response: Notify the system programmer.
initiated either by issuing the
System Programmer Response: Either manually RECOVER POSTPONED command
start IRLM or modify the installation-defined auto-start or by recycling the system with the
wait time. Restart DB2. system parameter
LBACKOUT=AUTO.
Problem Determination: Collect the following AUXW The table space is in aux warning
diagnostic items listed in “Appendix B. Problem state. AUXW on a LOB table space
determination” on page 1281: 1, 2, 5, 9. indicates that one or more LOBs in
Check the IRLMID given in the IRLM procedure against the LOB table space is invalid. AUXW
the IRLMSID in macro DSN6SPRM which was in the on a base table space indicates that
DSNZPARM used at startup. CHECK DATA detected an orphan or
missing LOB or an out-of-sync
condition between the row in the base
DSNT388I NAME TYPE PART STATUS CONNID table and the LOB in the LOB table
CORRID CLAIMINFO space.
Explanation: This message is the heading for a set of CHKP The object (a table space or a
messages that display information as a result of a partition within a table space) is in
-DISPLAY DATABASE command when the keyword check pending status.
CLAIMERS is specified. The message number for this COPY The object (a table space or a
message is not displayed. This message is always partition within a table space) is in
followed by multiple DSNT389I messages containing the copy pending status. An image copy
column data. Refer to message DSNT389I for a is required for this object.
description of the data these headings identify. GRECP
The object (a table space, a table
space partition, index space, or index
space partition) is marked recovery
Chapter 17. DB2 Messages 401
DSNT390I
pending because of the failure of a a Message DSNT500I or DSNT501I is
group buffer pool. This status value issued when the error is detected to
appears only on spaces. It does not indicate the inconsistency.
apply to databases. See DB2 Data STOPP A stop is pending for the database,
Sharing: Planning and Administration table space, table space partition,
for information about resolving this index space or index space partition.
restricted status. UT The table space, table space partition,
ICOPY The object (an index space or index index space or index space partiti is
partition) is in informational copy started for utility processing only.
pending status. UTRO A utility is in process on the table
LPL The object has pages or ranges of space, table space partition, index
pages that are unavailable because of space, or index space partition that
logical or physical damage. allows only RO access.
LSTOP The logical partition is stopped. UTRW A utility is in process on the table
PSRBD space, table space partition, index
The index space is in page set rebuild space or index space partition that
pending status. allows RW access.
RBDP The object (an index space, index UTUT A utility is in process on the table
partition or logical index partition) is in space, table space partition, index
rebuild pending status. For logical space or index space partition that
partitions, the RBDP status can allows only UT access.
appear as RBDP*. WEPR This object has pages or ranges of
RBDP Indicates that the entire index is pages that are unavailable because of
inaccessible to SQL applications, physical damage. To reset this flag,
however only the logical partition you can use either the RECOVER
needs to be recovered. utility with the option as ERROR
RECP The object (a table space, table space RANGE or the LOAD utility with the
partition, index space, index partition option as REPLACE.
or logical index partition) is in recovery
pending status. If the status for a nonpartitioned index is blank,
| REFP The object (a table space, a table then the status information is displayed at the
| space partition, index space, or index logical partition level.
| space partition) in in refresh pending conn-id A connection identifier for the thread.
| status. For a table space, run LOAD corr-id A correlation identifier of the thread associated
| REPLACE or the RECOVER utility to with the space name.
| resolve this restricted status, or use claims The type and duration of currently held claims.
| the REBUILD INDEX utility to rebuild The claim is composed of a claim class
| the index from the data. descriptor and a claim duration descriptor.
REORP
The object (a table space or table The claim class descriptor has one of the
space partition) is in recovery pending following values:
status. CS Cursor stability claim class
RESTP The object is in the Restart Pending RR Repeatable-read claim class
state. Backout activity against the WR Write claim class
object must be completed by using
the -RECOVER POSTPONED The claim duration descriptor describes the
command, or by recycling the system duration of the claims as follows:
with system parameter A The claim is held until deallocation.
LBACKOUT=AUTO. C The claim is held until the next commit
RO The table space, table space partition, point.
index space or index space partiti is H The claim is held across commit.
started for read-only activity.
RW The table space, table space partition, DSNT390I * DISPLAY OF DATABASE name
index space or index space partiti is action*
started for read and write activity.
STOP The table space, table space partition, Explanation: This message indicates the end of a set
index space or index space partiti is of DSNT391I and DSNT392I messages, a set of
stopped. DSNT393I and DSNT394I messages, or a set of
STOPE The table space or index space was DSNT395I and DSNT396I messages.
implicitly stopped because there is a In this message:
problem with the log RBA in a page.
402 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT391I • DSNT394I
v The 'name' is the name of the database. hexadecimal number identifying the highest page
v The 'action' is one of the following: number containing an I/O error. This column is blank
if there are no physical errors.
CONTINUES
v When a data set supporting the specified table space
The remaining table space and index space
or index space has physical I/O errors, cat-name
names within this database are continued to
identifies the catalog owning the data set with the I/O
a new display.
errors. This column is blank if there are no physical
TERMINATED errors.
The remaining table space and index space v When a data set supporting the specified table space
names within this database are terminated. or index space has physical I/O errors, piece is an
ENDS The display for this database is complete. integer number identifying the piece within the table
space or index space having the error. This column is
blank if there are no physical errors.
DSNT391I NAME TYPE STATUS PHYERRLOW The piece number can be used to construct the name
PHYERRHI CATALOG PIECE of the data set supporting the space containing the
Explanation: This message indicates the beginning of physical error as follows:
a set of messages used to display information as a cat-name.DSNDBC.databas
result of a DISPLAY DATABASE command when the name.space-name.I0001.Axxxx
keywords WEPR, LOCKS, LPL, CLAIMERS and USE
are omitted. (The message appears in one continuous The value xxxx is the piece number plus one and
line across the screen, not as shown above.) This database-name is the name displayed in the
message forms the headings of the display and is preceding DSNT362I message. If the table space or
always followed by multiple DSNT392I messages index space is partitioned, the partition number
containing the column data. Refer to message should equal the piece number plus one.
DSNT392I for a description of the data these headings
identify.
DSNT393I NAME TYPE PART STATUS CONNID
CORRID USERID
DSNT392I space type part status lo-page hi-page
cat-name piece Explanation: This message indicates the beginning of
a set of messages used to display information as a
Explanation: This message contains the display result of a DISPLAY DATABASE command when the
information as a result of a DISPLAY DATABASE keyword USE is specified. This message contains the
command when the keywords LOCK, CLAIMERS, LPL headings of the display. (The message appears in one
and USE are omitted. This message contains the continuous line across the screen, not as shown above.)
column data describing the status of a table space or This message is always followed by multiple DSNT394I
index space in the database listed in the preceding messages containing the column data. Refer to
DSNT362I message. This message is always preceded message DSNT394I for a description of the data these
by its column headings in message DSNT391I. The headings identify.
message number for this message is not displayed.
However, messages DSNT391I, DSNT392I, and
DSNT390I are always produced with a multiple line DSNT394I space type part status conn-id corr-id
WTO and are never interrupted. user-id
In this message: Explanation: This message contains the display
information resulting from a DISPLAY DATABASE
v The space is the table space name or index space command when the keyword USE is specified. This
name. message contains the column data describing the status
v The type is TS for a table space, IX for an index of a table space or index space in the database listed in
space or LS for a LOB table space. the preceding DSNT362I message. This message is
v The part is the partition number. It is blank for a always preceded by message DSNT393I containing the
simple table space or simple index space. column headings. The message number for this
message is not displayed. However, messages
v See DSNT389I for a list of the possible status display
DSNT393I, DSNT394I, and DSNT390I are always
strings.
produced with a multiple line WTO and are never
v When a data set supporting the specified table space interrupted.
or index space has physical I/O errors, lo-page is a
hexadecimal number identifying the lowest page In this message:
number containing an I/O error. This column is blank v The type is TS for a table space, IX for an index
if there are no physical errors. space or LS for a LOB table space.
v When a data set supporting the specified table space v The type is TS for a table space or IX for an index
or index space has physical I/O errors, hi-page is a space.
Chapter 17. DB2 Messages 403
DSNT395I • DSNT396I
v The part is the partition number. It is blank for a parameter of the DDM EXCSAT command
simple table space or simple index space. received as part of the SQL CONNECT
v See DSNT389I for a list of the possible status display v The user-id is one of the following:
strings. – 'TSO logon identifier' if the thread is from a TSO
v The conn-id is a connection identifier for the thread. It terminal.
is one of the following: – 'sign-on id' or the LTERM if the thread is from an
– BATCH if the thread is from a batch region. IMS message-drive region.
– TSO if the thread is from a TSO terminal. – AXBUSER if the thread is from an IMS
– UTILITY if the thread is from a utility. message-driven region and RACF is used.
– 'IMS identifier' if the thread is from an IMS – 'PSB name' if the thread is from an IMS
terminal. nonmessage-driven region and RACF is not used.
– 'CICS identifier' if the thread is from a CICS – 'user-id', 'term id', 'tran id' or other, as specified in
terminal. the resource control table (RCT), if the thread is
from CICS.
– CONSOLE if the thread is from the console.
v The corr-id is a correlation identifier of the thread
associated with the space name. It is one of the DSNT395I NAME TYPE PART STATUS CONNID
following: CORRID LOCKINFO
– 'job name' if the thread is from a batch region. Explanation: This message indicates the beginning of
– 'TSO logon identifier' if the thread is from a TSO a set of messages used to display information as a
terminal. result of a DISPLAY DATABASE command when the
keyword LOCKS is specified. This message forms the
– PST#.PSBNAME if the thread is from an IMS
headings of the display. (The message appears in one
terminal.
continuous line across the screen, not as shown above.)
– 'entry ID.thread number.tran id' if the thread is This message is always followed by multiple DSNT396I
from a CICS terminal. messages containing the column data. Refer to
– CONSOLE if the thread is from the console. message DSNT396I for a description of the data these
– '0nn', where 'nn' is a number , if the thread is for a headings identify.
system agent.
– For distributed database access threads, this field DSNT396I space type part status conn-id corr-id lock
contains the following:
Explanation: This message contains the display
- While the thread is being created: information that results from a DISPLAY DATABASE
1. ’028.DBAA nn’, where nn ranges from 01 to command when the keyword LOCKS is specified. This
99. This indicates that the database access message contains the column data describing the status
agent (DBAA) is in its connection of a table space or index space in the database listed in
processing, which consists of establishing the preceding DSNT362I message. This message is
the DBAA thread, and validating and always preceded by its column headings in message
verifying the user’s ID. Refer to ″Controlling DSNT395I. The message number for this message is
Access to a DB2 Subsystem″ in DB2 not displayed. However, the messages DSNT395I,
Administration Guide for descriptions of the DSNT396I, and DSNT390I are always produced with a
authorization checks that might be multiple line WTO and are never interrupted.
performed.
In this message:
All RACF requests are serialized on a single
v The space is the table space name, index space
DB2 RACF service task, which might
name, or table OBID.
increase the validation time when multiple
DBAAs are being created concurr v The type is TS for a table space, IX for an index
space, LS for a LOB table space or TB for a table.
- After the thread is created:
v The part is the partition number. It is blank for a
1. For threads using system-directed access
simple table space, simple index space, or
and threads using application-direct access
segmented table space.
from a DB2 requester, this variable displays
the correlation ID of the thread at the v See DSNT389I for a list of the possible status display
requesting location. strings. If the type is TB, the status field is blank.
2. For threads using application-directed v The conn-id is a connection identifier for the thread. It
access from a non-DB2 requester, this is one of the following:
variable displays the first twelve characters – BATCH if the thread is from a batch region.
in the DDM external name (EXTNAM) – TSO if the thread is from a TSO terminal.
– UTILITY if the thread is from a utility.
404 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT396I
– 'IMS identifier' if the thread is from an IMS Multiple locks held by an agent are listed on
terminal. multiple lines of the report followed by any locks
– 'CICS identifier' if the thread is from a CICS the agent is currently awaiting.
terminal. – Physical locks (P-locks) and retained locks are
– CONSOLE if the thread is from the console. identified by their DB2 data sharing member
names.
When the displayed lock is a P-lock or a retained Multiple P-locks or retained locks held by a DB2
lock, conn-id is not specified. data sharing member are listed on multiple lines of
v The corr-id is a correlation identifier of the thread the report followed by any locks the member is
associated with the space name. It is one of the currently awaiting.
following: The lock is composed of a 'lock status' and followed
– 'job-name' if the thread is from a batch region. by a dash ’-’, a 'lock state' followed by a 'lock type',
– 'TSO logon identifier' if the thread is from a TSO and a 'lock duration' delimited by commas.
terminal. – The 'lock status' is a value of:
– PST#.PSBNAME if the thread is from an IMS H The lock is held by the agent or the DB2
terminal. member.
– 'entry ID.thread number.tran id' if the thread is
W The agent or the member is awaiting the
from a CICS terminal.
lock.
– CONSOLE if the thread is from the console.
R The lock is retained.
– For distributed database access threads, this field
contains the following: – The 'lock state' describes themode of the lock as
follows:
- While the thread is being created:
- For L-locks and drain locks,
1. ’028.DBAA nn’, where nn ranges from 01 to
99. This indicates that the database access IS A lock with read intentions.
agent (DBAA) is in its connection
IX A lock with update intentions.
processing, which consists of establishing
the DBAA thread, and validating and S A lock with read-only capability.
verifying the user’s ID. Refer to ″Controlling
Access to a DB2 Subsystem″ in DB2 U A lock with update capability.
Administration Guide for descriptions of the SIX A table space or table lock with a
authorization checks that might be protocol that does not lock a page
performed. while reading, but locks the page with
All RACF requests are serialized on a single update intention while updating.
DB2 RACF service task, which might
X An exclusive lock.
increase the validation time when multiple
DBAAs are being created concurr - For L-locks on LOB table spaces,
- After the thread is created: IS A lock with intent to reserve space
1. For threads using system-directed access within the LOB table space
and threads using application-direc access IX A lock with intent to insert LOBs in the
from a DB2 requester, this variable displays LOB table space.
the correlation ID of the thread at the
requesting location. S A lock which reserves space within the
LOB table space.
2. For threads using application-directed
access from a non-DB2 requester, this SIX A lock which allows the owner to read
variable displays the first twelve characters and update LOBs.
in the DDM external name (EXTNAM)
parameter of the DDM EXCSAT command X An exclusive lock.
received as part of the SQL CONNECT - For P-locks,
IS This DB2 member has R/O interest.
corr-id is not specified when the displayed lock is a The page set or partition is group
P-lock or a retained lock. buffer pool (GBP) dependent.
v The lock describes the type and duration of locks:
IX This DB2 member has R/W interest.
– Transaction locks (also called L-locks) are The page set or partition is
identified by their correspondin agents’ connection GBP-depende
and correlation IDs
Chapter 17. DB2 Messages 405
DSNT397I
S This DB2 member has R/O interest.
DSNT397I
The page set or partition is not
GBP-dep Explanation: This message indicates the beginning of
a multiple line display generated as a result of a
SIX This DB2 member has R/W interest.
DISPLAY DATABASE command. The format of this
The page set or partition is
multiple line display has three parts:
GBP-depende
v The column headers, which are dependent on the
NSU This DB2 member has R/W interest. keywords issued. The headers are underlined.
The page set or partition is
v The space information for all spaces and partitions
GBP-depende
requested by the command
X This DB2 member has R/W interest. v An ending message to state whether the spaces
The page set or partition is not were displayed or not.
GBP-dep
– The 'lock type' describes the type of locking as There are five different headers for the DISPLAY
follows: DATABASE commands. The headers are dependent on
the presence of the keywords: CLAIMERS, LOCKS,
S A table space L-lock
USE, LPL, or no keyword. These five different DISPLAY
T A table L-lock DATABASE command formats are described below.
C A cursor-stability read drain lock v DISPLAY DATABASE CLAIMERS
This DISPLAY DATABASE command displays the
R A repeatable-read drain lock claims that are on certain table spaces, index spaces,
W A write drain lock and partitions.
The column headers in this command are as follows:
P A partition L-lock
NAME TYPE PART STATUS CONNID CORRID
PP A page set or partition P-lock CLAIMINFO
– If the 'lock status' is H, the 'lock duration' – NAME is the table space name or index space
describes the duration of the lock: name.
A The lock is freed at deallocation. – TYPE is TS for a table space, IX for an index
space, LS for a LOB table space.
C The lock is freed at commit.
– PART is the partition number. It is blank for a
H The lock is freed when all cursors are simple table space or simple index space. For
closed. nonpartitioned indexes on a partitioned table
M The lock is freed by the system. space, it is the logical partition number preceded
by the character L (for example, L01).
P The lock is freed when the plan is – See DSNT389I for a list of the possible status
complete. display strings.
I The lock is a page set or partition P-lock. – For L-locks on LOB table spaces,
It is released when the pageset or IS A lock with intent to reserve space within
partition data set is closed. the LOB table space
– If the 'lock status' is W, the 'lock duration' is a IX A lock with intent to insert LOBs in the
2-digit number indicating the waiter’s position in LOB table space.
the local DB2 system’s lock waiting queue. When S A lock which reserves space within the
this lock is acquired, its duration is the same as all LOB table space.
locks held by the user. SIX A lock which allows the owner to read
and update LOBs.
– For a P-lock, the lock is owned by the system, not
X An exclusive lock.
the user, and its duratio is not related to the
duration of the locks that are owned by the user.
If the type is TB, the status field is blank.
– Retained locks do not have a lock duration.
If the status for an index is blank, then the status
All index spaces on tables are implicitly locked with information is displayed at the logical partition
transaction locks at the same level as the table spaces level.
containing those tables. P-locks are acquired by DB2 on
index spaces as well as on table spaces. – The CONNID is a connection identifier for the
thread. It is one of the following:
- BATCH if the thread is from a batch region.
- TSO if the thread is from a TSO terminal.
406 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT397I
- UTILITY if the thread is from a utility. 2. For threads using application-directed
- 'IMS identifier' if the thread is from an IMS access from a non-DB2 requester, this
terminal. variable displays the first twelve
characters in the DDM external name
- 'CICS identifier' if the thread is from a CICS
(EXTNAM) parameter of the DDM
terminal.
EXCSAT command received as part of
- CONSOLE if the thread is from the console. the SQL CONNECT
- For distributed database access threads, this – CLAIMINFO is the type and duration of currently
field contains the following: held claims. The claim is composed of a claim
v For threads using system-directed access class descriptor and a claim duration descriptor.
and for threads using application-directed The claim class descriptor has one of the following
access from a DB2 Version 3 or later values:
requester, this variable displays the CS Cursor stability claim class
connection name of the thread at the RR Repeatable-read claim class
requesting location. WR Write claim class
v For threads using application-directed access
from a non-DB2 requester or from a DB2 The claim duration descriptor describes the
Version 2 Release 3 requester, this field duration of the claims as follows:
displays the constant SERVER. A The claim is held until deallocation.
– CORRID is a correlation identifier of the thread C The claim is held until the next commit
associated with the space name. It is one of the point.
following: H The claim is held across commit.
- 'job name' if the thread is from a batch region. v DISPLAY DATABASE LOCKS
- 'TSO logon identifier' if the thread is from a This DISPLAY DATABASE command displays the
TSO terminal. locks that are on certain table spaces, index spaces
and partitions.
- PST#.PSBNAME if the thread is from an IMS
terminal. The column headers in this command are as follows:
- 'entry ID.thread number.tran id' if the thread is NAME TYPE PART STATUS CONNID CORRID
from a CICS terminal. LOCKINFO
- CONSOLE if the thread is from the console. – The NAME column states the table space name,
index space name, or table object ID.
- '0nn', where 'nn' is a number, if the thread is for
a system agent. – The TYPE column states TS for table space, IX
for index, or TB for table.
- For distributed database access threads, this
field contains the following: – The PART, STATUS, CONNID, and CORRID
columns are described in the DISPLAY
v While the thread is being created:
DATABASE CLAIMERS section.
1. ’028.DBAA nn’, where nn ranges from 01
– The conn-id and corr-id are not specified when the
to 99. This indicates that the database
display lock is a P-lock or a retained lock (either
access agent (DBAA) is in its connection
L-lock or P-lock). For page set P-locks, the DB2
processing, which consists of establishing
member name is used to identify the lock.
the DBAA thread, and validating and
verifying the user’s ID. Refer to – The LOCKINFO describes the type and duration
″Controlling Access to a DB2 Subsystem″ of locks used by corresponding agents identified
in DB2 Administration Guide for by their connection and correlation IDs (for
descriptions of the authorization checks transaction locks, which are also called L-locks) or
that might be performed. used by corresponding subsystems identified by
their DB2 data sharing member names (for
All RACF requests are serialized on a
physical locks, which are called P-locks, and
single DB2 RACF service task, which
retained locks). Multiple locks held by an agent
might increase the validation time when
are listed on multiple lines of the report followed
multiple DBAAs are being created
by any locks the agent is currently awaiting.
concurr
Multiple P-locks or retained locks held by a DB2
v After the thread is created: data sharing member are listed on multiple lines of
1. For threads using system-directed access the report followed by any locks the member is
and threads using application-direc currently awaiting. The LOCKINFO consists of a
access from a DB2 requester, this 'lock status', followed by a dash ’-’, a 'lock state', a
variable displays the correlation ID of the 'lock typeßand a 'lock duration' delimited by
thread at the requesting location. commas.
- The 'lock status' is a value of:
Chapter 17. DB2 Messages 407
DSNT397I
H The lock is held by the agent or the M The lock is freed by the system.
DB2 member.
P The lock is freed when the plan is
W The agent or the member is awaiting
complete.
the lock.
R The lock is retained. I The lock is a page set or partition
- The 'lock state' describes the mode of lock as P-lock. It is released when the page
follows: set or partition data set is closed.
v For L-locks and drain locks, - If the 'lock status' is W, the 'lock duration' is a
IS A lock with read intentions. 2-digitnumber indicating the waiter’s position in
IX A lock with update intentions. the local DB2 system’s lock waiting queue.
S A lock with read-only capability. When this lock is acquired, its duration is the
U A lock with update capability. same as all locks held by the user.
SIX A lock with a protocol that does not - For a P-lock, the lock is owned by the system,
lock a page while reading, but locks not the user, and its duratio is not related to the
the page with update intention while duration of the locks that are owned by the
updating. user.
X An exclusive lock. - Retained locks do not have a lock duration.
v For P-locks,
IS This DB2 member has R/O interest. There are no explicit index space locks. However, all
The page set or partition is group index spaces on tables are implicitly locked at the
buffer pool (GBP) dependent. same level as the table spaces containing those
tables. P-locks are acquired by DB2 on index spaces
IX This DB2 member has R/W interest. as well as on table spaces.
The page set or partition is v DISPLAY DATABASE USE
GBP-depend
This DISPLAY DATABASE command displays the
S This DB2 member has R/O interest. user IDs that are accessing certain table spaces,
The page set or partition is not index spaces, and partitions.
GBP-dependent. The column headers in this command are as follows:
SIX This DB2 member has R/W interest. NAME TYPE PART STATUS CONNID CORRID
The page set or partition is USERID
GBP-depend – The NAME, TYPE, PART, STATUS, CONNID, and
NSU This DB2 member has R/W interest. CORRID columns are described in the DISPLAY
The page set or partition is DATABASE CLAIMERS section.
GBP-depend – The USERID is one of the following:
X This DB2 member has R/W interest. - 'TSO logon identifier' if the thread is from a
The page set or partition is not TSO terminal.
GBP-dependent. - 'sign-on id' or the LTERM if the thread is from
- The 'lock type' describes the type of locking as an IMS message-drive region.
follows: - AXBUSER if the thread is from an IMS
message-driven region and RACF is used.
S A table space L-lock
- 'PSB name' if the thread is from an IMS
T A table L-lock nonmessage-driven region and RACF is not
C A cursor-stability read drain lock used.
- 'userid', 'term id', 'tran id' or other, as specifie in
R A repeatable-read drain lock
the resource control table (RCT), if the thread is
W A write drain lock from CICS.
P A partition L-lock v DISPLAY DATABASE LPL
NAME TYPE PART STATUS LPL PAGES
PP A page set or partition P-lock
This message contains the display information
- If the 'lock status' is H,the 'lock duration' resulting from a DISPLAY DATABASE command
describes the duration of the lock: when the keyword LPL is specified. It contains the
A The lock is freed at deallocation. column data describin the status of a table space or
index space in the database listed in the precedi
C The lock is freed at commit. DSNT362I message. This message is always
H The lock is freed when all cursors are
closed.
408 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT397I
preceded by its column headings message There are other informational messages that can be
DSNT805I. The message number for this message is displayed that are not related to one specific keyword.
not displayed. They are listed below:
In this message: v –luw-id ACCESSING DATA FOR location
– The LPL PAGES column lists the pages in the This message is issued for each thread reported that
specified space that are unavailable because of is participating in distributed data access (database
logical or physical damage. access thread). The thread that corresponds to this
v DISPLAY DATABASE (with no LOCKS, USE, LPL or message is the thread named by the correlation id
CLAIMERS keyword). and connection id of the data line preceding this
message. This additional line reports the distributed
This DISPLAY DATABASE command displays the
identification as follows:
error page range information for certain table spaces,
index spaces, and partitions. luw-id=token
The column headers in this command are as follows: The logical-unit-of-work identifier (LUW-ID) is
a unique identifier that is assigned to the
NAME TYPE PART STATUS PHYERRLO PHYERRHI
thread followed by an '=' sign and a token.
CATALOG PIECE
The token can be used in place of luw-id in
In this message: any DB2 command that accepts luw-id as
– The NAME, TYPE, PART, and STATUS columns input.
are described in the DISPLAY DATABASE
location
CLAIMERS section.
The LOCATION name assigned to the
– When a data set supporting the specified table requesting site.
space or index space has physical I/O errors,
v –MEMBER NAME member-name
PHYERRLO is a hexadecimal number identifying
the lowest page number containing an I/O error. This message is issued with messages DSNT389I,
This column is blank if there are no physical DSNT394I or DSNT396I for each thread in a data
errors. sharing environment. This additional line reports the
member name of the DB2 subsystem accessing this
– When a data set supporting the specified table
object.
space or index space has physical I/O errors,
PHYERRHI is a hexadecimal number identifying If the characters ’(CO)’ follow the member name,
the highest page number containing an I/O error. then this member is the castout owner for the page
This column is blank if there are no physical set or partition. The castout owner for a page set or
errors. partition is the DB2 member responsible for doing all
of the castout I/O for that page set or partition.
– When a data set supporting the specified table
space or index space has physical I/O errors, The message number and subsystem recognition
CATALOG identifies the catalog owning the data character are not included in this message.
set with the I/O errors. This column is blank if v INVALID space-name
there are no physical errors. The space-name specified in the SPACENAM
– When a data set supporting the specified table keyword on the -DISPLAY DATABASE command
space or index space has physical I/O errors, does not exist. The name of the table space or index
PIECE is an integer number identifying the piece space is 'space-name'. The request is rejected.
within the table space or index space having the v NO SPACES FOUND
error. This column is blank if there are no physical
This message is produced when a DISPLAY
errors.
DB(name) SPACENAM is entered and no spaces
The piece number can be used to construct the were found to satisfy the request. SPACENAM(...)
name of the data set supporting the space might have been entered as a range, a subset, or a
containing the physical error as follows: list of spaces.
cat-name.DSNDBC.database- v spacetype name NOT type
name.space-name.I0001.Axxxx
This message is produced when no table space or
index space listed in the DISPLAY DB(...)
The value xxxx is the piece number plus one and
SPACENAM(...) satisfies your request.
database-name is the name displayed in the
preceding DSNT362I message. Note that if the spacetype
table space or index space is partitioned, the TABLESPACE if the space is a table space
partiti number should equal the piece number plus or INDEXSPACE if the space is an index
one. space.
name The name of the space.
type A character string that indicates the type of
Chapter 17. DB2 Messages 409
DSNT398I • DSNT405E
request specified. The string is a list of the
DSNT400I SQLCODE = 0, SUCCESSFUL
following, delimited by 'OR':
EXECUTION
– ACTIVE if the keyword ACTIVE is
specified Explanation: The SQLCODE was 0, indicating
successful execution of the function. SQLWARN
– RESTRICTED if the keyword RESTRICT
indicators may note some warnings. SQLWARNx fields
is specified.
are described in Appendix C of DB2 SQL Reference.
v NO INFORMATION AVAILABLE
This message is produced when there is no LOCK or
DSNT401I DSNT401I WARNING - HELP IS NOT
USE information available. When DISPLAY DB(...) is
INSTALLED
entered, and DB(...) is a list of databases or a list of
names, this message indicates that no listed Explanation: You invoked the installation process with
database has LOCK or USE information available. the DSNTINST CLIST. To enable online help, you must
If DISPLAY DB(...) or DISPLAY DB(...) SPACENAM(*) use the DSNTINS0 CLIST instead of the DSNTINST
is entered, and DB(...) is a range or subset of CLIST.
databases, or all databases ('*'), this message This message is issued by panel: DSNTIPA1
indicates that no databases, for which the invoker
has authority to display, have LOCK or USE System Action: The panel is displayed with the
information available. This message is produced only warning message.
when the keywords USE and LOCKS are specified. User Response: No response is necessary if you do
not desire online help for the panel. Press ENTER to
The ending message looks like this: continue with the installation process after filling in
desired panel values. If panel help is desired: exit this
* DISPLAY OF DATABASE name action * panel, make sure BookManager or the online help
reader is installed on your system, and invoke the
In this message: installation process with the DSNTINS0 CLIST.
name The name of the database
DSNT402I ONLINE BOOK DATA SET NAMES
action One of the following:
MUST END IN ’.BOOK’
CONTINUES
The remaining table space and index Explanation: All book names entered on this panel
space names within this database are must end in ″.BOOK″.
continued to a new display.
TERMINATED This message is issued by panel: DSNTIPA0
The remaining table space and index System Action: The panel is redisplayed with the
space names within this database are error message.
terminated.
ENDS The display for this database is User Response: Replace the book name or names
complete. with a value that ends in ″.BOOK″.
DSNT398I DSNT404I SQLCODE = xxx, explanation
Explanation: This message appears within a multiple Explanation: This message contains an SQL return
line WTO message set and precedes DSNT391I, code and a brief explanation, with text inserted from the
DSNT393I, and DSNT395I. It is used to underscore the SQLERRM field. The SQL return code is positive,
column headings. indicating a warning condition. For more information
about this SQL return code, see “Part 2. SQL Return
This message is issued by CSECT: DSNTDMUL Codes” on page 9.
System Programmer Response: Determine the
DSNT399I INVALID space-name cause for the SQL warning code, and correct the
Explanation: The space-name specified in the situation if needed. Rerun the application program or
SPACENAM keyword on the -DISPLAY DATABASE SQL statement.
command does not exist. The name of the table space
or index space is 'space-name'. The request is rejected. DSNT405E csect-name DISPATCH PRIORITIES
NOT IN SYNC: ccccccc1: hhh1
COMPARED TO ccccccc2: hhh2
Explanation: The dispatch priorities of task 'ccccccc1'
(dispatch priority 'hhh1') and task 'ccccccc2' (dipatch
priority 'hhh2') are found to be incorrect in relation to
410 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT406I • DSNT412I
each other. This can cause severe performance
DSNT409I BUFFERPOOL SIZES SHOWN MAY BE
problems and possible failure of either task 'ccccccc1',
OBSOLETE
task 'ccccccc2', or other tasks.
Explanation: The buffer pool sizes shown here were
System Action: DB2 continues with possible problems
set at installation or migration time and might not be the
described above.
most current. Updates might have occurred using the
Operator Response: Notify the system programmer. ALTER BUFFERPOOL command.
System Programmer Response: Modify the dispatch This message is issued by the following panels:
priority algorithms for the two tasks to meet documented DSNTIP1, DSNTIP2, DSNTIP6
requirements. For instance, IRLM must have a higher
System Action: Processing continues.
dispatch priority than DB2.
User Response: No response is required.
DSNT406I THE ART/ORT ESCAPE CHARACTER
CANNOT BE % OR _ DSNT410I THE SUBSYSTEM COMMAND PREFIX
ENTERED IS INCORRECT
Explanation: You specified the percent sign (%) or the
underscore character (_) as the application registration Explanation: You entered an incorrect command
table/object registration table (ART/ORT) escape prefix. The first character of the command prefix must
character. The ART/ORT escape character can be any be one of the following:
other character.
@ $ # . / ’ ? " % ! <
System Action: The panel is redisplayed and the ) * + − = ¢ : _ ; |
cursor is placed on the field that produced the error.
User Response: Change the ART/ORT escape The remaining characters of the command prefix must
character value. be one of the above, A-Z, or 0-9.
This message is issued by the following panel:
DSNT407I THIS FIELD HAS AN INVALID FORMAT DSNTIPM
Explanation: The field must be NOLIMIT, 1440, 0, or System Action: The panel is redisplayed and the
minutes and seconds separated by a comma. cursor is placed on the field in error
This message is issued by the following panel: User Response: Enter a valid command prefix
DSNTIPA
System Action: The panel is redisplayed and the DSNT411I SQLCAID = xxxx, SQLCA IDENTIFIER
cursor is placed on the field in error.
Explanation: The SQLCA ID field (SQLCAID) is not
User Response: Correct the input. the expected value, C'SQLCA'.
System Programmer Response: The SQLCA area is
DSNT408I SQLCODE = -xxx, explanation invalid. This type of error is usually the result of one of
Explanation: This message contains an SQL return the following:
code and a brief explanation, with text inserted from the v Calling the DSNTIAR formatting routine before an
SQLERRM field. The SQL return code is negative, SQL statement initializes the area
indicating that an error has occurred. For more v Overlaying the SQLCA area
information about this SQL return code, see “Part 2.
v Passing the wrong address to the DSNTIAR routine.
SQL Return Codes” on page 9.
Correct the error, and rerun the application program.
System Programmer Response: Determine the
cause for the SQL error by using information about that
specific SQLCODE. Correct the error if desired. Rerun DSNT412I SQLCABC = xxxx, SQLCA BYTE
the application program or SQL statement. COUNT
Problem Determination: Collect the following Explanation: The size of the SQLCA is not the
diagnostic items listed in “Appendix B. Problem expected value (136 bytes).
determination” on page 1281: 1, 2, 5, 14, 17.
System Programmer Response: The SQLCA area is
invalid. Correct the error. It is probably an overlay or an
incorrect SQLCA address. Rerun the application
program.
Chapter 17. DB2 Messages 411
DSNT413I • DSNT417I
DSNT413I SQLCODE = xxxx, INVALID SQLCODE DSNT416I SQLERRD = xx,xx,xx,xx,xx,xx SQL
DIAGNOSTIC INFORMATION
Explanation: The SQL return code is not a valid
value. Explanation: At least one of the six diagnostic fields is
not the expected value. The expected values are:
System Programmer Response: Either the SQLCA
v 00, 00, 00, 00, 00, 00 or
area is invalid or the maintenance was not coordinated
v 00, 00, 00, -1, 00, 00
correctly. As a result, the SQL return code was added to
the DB2 subsystem but not to the formatting routine. The SQL diagnostic information for each of the six
values is as follows:
An invalid SQLCA area is usually the result of one of
1 DB2 unique internal relational data system
the following:
code
v Calling the DSNTIAR formatting routine before an 2 DB2 internal data manager error code
SQL statement initializes the area 3 One of the following:
v Overlaying the SQLCA area v Number of rows inserted, updated, or
v Passing the wrong address to the DSNTIAR routine. deleted following an INSERT, UPDATE, or
DELETE statement
If the maintenance was not coordinated correctly, the
DSNTIAR and DSNTIAM CSECTs were probably not Note: A '-1' in this field indicates that a
replaced in the code that is now running. Link-edit the mass delete of a table in a
load module, and replace DSNTIAR and DSNTIAM. segmented table space was
Correct the error, and rerun the application program. performed, wherein DB2 does not
access nor count individual rows.
DSNT414I SQLERRM = xxxx, SQLCA ERROR v For SQLCODE -911 or -913, a reason code
MESSAGE INSERTION TEXT that indicates whether a deadlock or timeout
occurred.
Explanation: This message results from an SQL
return code that is not recognized by DSNTIAR. Note: The most common reason codes are:
SQLERRM contains error message text. – 00C90088 - deadlock
System Programmer Response: Either the SQLCA – 00C9009E - timeout
area is invalid or the maintenance was not coordinated 4 Reserved
correctly. As a result, the SQL return code was added to 5 Position or column of a syntax error for
the DB2 subsystem but not to the formatting routine. PREPARE or EXECUTE IMMEDIATE
6 DB2 internal buffer manager error code
An invalid SQLCA area is usually the result of one of
the following: System Programmer Response: Refer to Appendix C
of DB2 SQL Reference for further information on the
v Calling the DSNTIAR formatting routine before an contents of the SQLERRD fields. The SQL diagnostic
SQL statement initializes the area information may be of help in diagnosing an error or in
v Overlaying the SQLCA area indicating the results of successful execution. If this
v Passing the wrong address to the DSNTIAR routine. error or warning should not occur, correct the error.
Rerun the program or SQL statement.
If the maintenance was not coordinated correctly, the
DSNTIAR and DSNTIAM CSECTs were probably not DSNT417I SQLWARNn-n SQL WARNINGS
replaced in the code that is now running. Link-edit the
load module, and replace DSNTIAR and DSNTIAM. Explanation: At least one of the 11 warning values is
Correct the error, and rerun the application program. not the expected value (a blank). A nonblank value in
one of the 11 warning fields has the following meaning:
DSNT415I SQLERRP = xxxx, SQL PROCEDURE SQLWARN0
DETECTING ERROR Any other warning code is set.
Explanation: The name of the procedure detecting the SQLWARN1
error is provided in the SQLERRP. String truncation.
System Programmer Response: (The SQL SQLWARN2
procedure detecting the error may be of help in Null value(s) eliminated.
diagnosing an error or warning.) Correct the error if SQLWARN3
there is one noted in other messages. Rerun the Number of host variables provided did not
program or SQL statement. equal degree of the table.
412 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT418I • DSNT422I
SQLWARN4 requester only. Press ENTER to continue. Otherwise,
No WHERE clause on UPDATE or DELETE. either change the DDF STARTUP OPTION to NO or
MAX REMOTE ACTIVE to the number of threads you
SQLWARN5
want.
Not a DB2 SQL statement.
SQLWARN6
DSNT420I YOU NEED AT LEAST 1 32K DS IF THE
Date or timestamp value adjusted.
TEMP 32K SPACE IS GREATER THAN
SQLWARN7 0
Conversion of decimal number from precision
Explanation: You entered zero for the TEMP 32K
31 to precision 15 caused truncation of
DATA SETS field on the SIZES panel. You need at least
fractional digits.
one TEMP 32K DATA SET if TEMP 32K SPACE on
SQLWARN8 DSNTIPD is not zero.
Untranslatable character replaced with
This message is issued by the following panel:
substitute.
DSNTIPD
SQLWARN9
System Action: The panel is redisplayed and the
Arithmetic exceptions have been ignored
cursor is placed on the field in error.
during processing of COUNT DISTINCT.
User Response: Enter a value of one or greater for
SQLWARNA
the TEMP 32K DATA SETS field or change the TEMP
At least one character field of the SQLCA is
32K SPACE value to zero.
invalid due to a string translation error.
User Response: The SQL warning information may
DSNT421I YOU NEED AT LEAST 1 32K BUFFER
be of help in diagnosing an error or in indicating the
FOR THE <num32kds> 32K DATA SETS
results of successful execution. If this warning should
occur, correct the error and rerun the program or SQL Explanation: You specified zero for the 32KB buffers.
statement. If field TEMP 32K DATA SETS on installation panel
DSNTIPD is greater than zero, you need at least one
32KB buffer on installation panel DSNTIP2.
DSNT418I SQLSTATE = sqlstate, SQLSTATE
RETURN CODE This message is issued by the following panel:
DSNTIP2
Explanation: The SQLSTATE is a return code that
indicates the outcome of the most recently executed System Action: The panel is redisplayed and the
SQL statement. The execution of every SQL statement cursor is placed on the field in error.
sets SQLSTATE to a five-digit code in the range of
User Response: Enter a value of 1 or more for at
00000 to 65535. This has no effect on the existing use
least one of the buffer pools (BP32K - BP32K9) on
of any other field in the SQLCA.
panel DSNTIP2, or change the TEMP 32K DATA SETS
User Response: For further information on the value to zero.
meaning of an SQLSTATE return code, see the “Part 2.
SQL Return Codes” on page 9. If necessary, correct the
DSNT422I THE ART TABLE NAME MUST BE
SQL statement and return it.
DIFFERENT FROM THE CRT TABLE
NAME
DSNT419I WARNING - MAX REMOTE ACTIVE
Explanation: You entered the same name for the
PREVIOUSLY SPECIFIED AS 0.
Application Registration Table and the Object
Explanation: You specified a value of 0 for the Registration Table on the Data Definition Control
number of active database access threads on a Support panel.
previous panel. This value might be inconsistent with a
This message is issued by the following panel:
DDF STARTUP OPTION of AUTO or COMMAND.
DSNTIPZ
This message is issued by the following panel:
System Action: The panel is redisplayed and the
DSNTIPR
cursor is placed on the field in error.
Severity: 4 (warning)
User Response: Change either the APPL
System Action: The panel is redisplayed and the REGISTRATION TABLE field or the OBJT
cursor is placed on the DDF STARTUP OPTION field. REGISTRATION TABLE field to make these two fields
unique with respect to each other.
User Response: No response is necessary if your
intent is to have DDF started with no active database
access threads allocated and DDF is used as a
Chapter 17. DB2 Messages 413
DSNT424I • DSNT431I
data set and member in that data set. Also verify that
DSNT424I OUTPUT DATA SETS MUST BE
the data set is cataloged.
DIFFERENT FROM THE INPUT DATA
SETS
DSNT428I WHEN USING TIMESTAMPS, THE
Explanation: You specified an output data set name
PREFIX MUST BE <= preflen
that is the same as one of the input data set names
CHARACTERS LONG
built from the PREFIX and SUFFIX fields on the main
panel DSNTIPA1. Explanation: YOU HAVE ENTERED AN ARCHIVE
LOG PREFIX LONGER THAN ALLOWED. The archive
This message is issued by the following panel:
log prefix names must not exceed 19 characters when
DSNTIPT
the TIMESTAMP ARCHIVES value is YES and must not
System Action: The panel is redisplayed and the exceed 17 characters when the TIMESTAMP
cursor is placed on the field in error. ARCHIVES value is EXT.
User Response: Either change the data set name This message is issued by the following panel:
under the cursor or change the PREFIX or SUFFIX DSNTIPH
fields on panel DSNTIPA1.
System Action: The panel is redisplayed and the
cursor is placed on the field in error.
DSNT425I ALL THREE OUTPUT DATA SETS
User Response: Reduce the length of the prefix or
MUST BE UNIQUE
change the TIMESTAMP ARCHIVES value to NO.
Explanation: You specified the same name for two or
more of the output data sets.
DSNT429I THE SUM OF MAX USERS AND MAX
This message is issued by the following panel: REMOTE ACTIVE MUST BE <= TO 2000
DSNTIPV
Explanation: The total number of threads determined
System Action: The panel is redisplayed and the by MAX USERS and MAX REMOTE fields is too large.
cursor is placed on the field in error.
This message is issued by the following panel:
User Response: Change the data set name under the DSNTIPE
cursor or the data set field(s) that are the same as the
System Action: The panel is redisplayed and the
one under the cursor.
cursor is placed on the field in error.
User Response: Reduce the MAX USERS field, or
DSNT426I ALL THREE DATA SETS ARE
the MAX REMOTE field, or both.
REQUIRED FOR OUTPUT
Explanation: You specified one or more output data
DSNT430I THIS FIELD MAY ONLY BE FILLED IN
sets and left one or more output data set fields blank.
FOR MIGRATE MODE
This message is issued by the following panel:
Explanation: You can only specify the FROM
DSNTIPT
RELEASE or DATA SET NAME(MEMBER) fields for
System Action: The panel is redisplayed and the INSTALL TYPE of MIGRATE.
cursor is placed on the field in error.
This message is issued by the following panel:
User Response: You must specify all or none of the DSNTIPA1
output data set fields. Leave blank all output data set
System Action: The panel is redisplayed and the
fields if you do not want the installation CLIST to edit
cursor is placed on the field in error.
any CLISTs or JCL.
User Response: Change the INSTALL TYPE to
MIGRATE or blank out the field under the cursor.
DSNT427I THE DATA SET OR MEMBER
SPECIFIED COULD NOT BE LOCATED
DSNT431I DDF, MIXED DATA, OR DEF ENCODING
Explanation: The input parameter member for the
SCHEME CONFLICTS WITH CODED
INPUT MEMBER NAME field or the DATA SET
CHAR SET
NAME(MEMBER) field for migration could not be found.
Explanation: You have entered an invalid EBCDIC or
This message is issued by the following panel:
ASCII coded character set (CCSID) value for the DDF,
DSNTIPA1
MIXED DATA, or DEF ENCODING SCHEME value you
System Action: The panel is redisplayed and the specified. The following restrictions apply to these
cursor is placed on the field in error. values:
User Response: Verify that you entered an existing v With a MIXED DATA value of 'YES', you must choose
a valid mixed CCSID value for the EBCDIC CODED
414 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT433I • DSNT437I
CHAR SET. The ASCII CODED CHAR SET must be 2. Press RETURN to leave the installation process; the
a valid mixed value or zero. data set(s) will not be deleted OR
v With a MIXED DATA value of 'NO', you must choose 3. Change the data set name(s); the new name will be
a valid SBCS CCSID value or zero for EBCDIC or checked for existence.
ASCII CODED CHAR SETs.
v With a DDF value of 'AUTO' or 'COMMAND', you DSNT435I DSNT435I OVERRIDE VALUES ARE IN
must choose a non-zero value for the EBCDIC EFFECT
CODED CHAR SET.
Explanation: Calculated values for EDMPOOL,
v With a DEF ENCODING SCHEME value of 'ASCII',
SORTPOOL, or RIDPOOL on panel DSNTIPC were
you must choose non-zero values for EBCDIC and
previously overridden. Installation uses any override
ASCII CODED CHAR SETs.
values displayed.
Refer to Appendix C of DB2 Installation Guide for a list Severity: 4
of the best general CCSID for each country.
System Action: Override values are used instead of
calculated values, when displayed.
This message is issued by the following panels:
DSNTIPF, DSNTIPR User Response: No response is necessary if you
want to use the override values. If you want to use the
System Action: The panel is redisplayed and the
calculated values, erase the values in the override
cursor is placed on the field in error.
column.
User Response: Correct either the DDF, MIXED
DATA, or DEF ENCODING SCHEME value or the
DSNT436I REGION SIZE MAY BE TOO LARGE
EBCDIC or ASCII CODED CHAR SET value to correct
the incompatibility. Explanation: The numbers you specified produced a
region size estimate of more than 5000KB. This region
size estimate does not include the storage required for
DSNT433I MAX REMOTE ACTIVE MUST BE <=
SWA because it is assumed that SWA has been placed
MAX REMOTE CONNECTED.
above the line. If a larger private area is permitted, you
Explanation: The number of active database access should increase the region size on the DB2 start
threads cannot be larger than the number of concurrent procedures. The region size calculation is shown in the
database access threads. DSNT485I through DSNT487I messages and is
discussed in Part 2 of DB2 Installation Guide.
This message is issued by the following panel:
DSNTIPE This message is issued by the following installation
CLIST: DSNTINST
Severity: 8 (error)
Severity: 4 (warning)
System Action: The panel is redisplayed and the
cursor is placed on the field in error. System Action: The CLIST continues.
User Response: Reduce the MAX REMOTE ACTIVE User Response: Check the values entered for
field, increase the MAX REMOTE CONNECTED field, numbers of concurrent users and databases, buffers,
or both. and plan sizes. Check the available private region size.
If this region size is not permitted, these numbers need
to be reduced. If the size is permitted, this warning can
DSNT434I WARNING, DATA SETS MARKED WITH be ignored.
ASTERISKS EXIST AND WILL BE
OVERWRITTEN Problem Determination: If you suspect an error in the
process, set CONTROL(CONLIST) and invoke the
Explanation: The data sets marked with asterisks CLIST. This produces tracing for error documentation.
already exist. If you continue, the installation process
will delete the existing data set and allocate a new one
for tailored job output. DSNT437I REGION SIZE IS TOO LARGE
This message is issued by the following panel: Explanation: The numbers you specified produced a
DSNTIPT region size estimate of more than 8000KB. This
estimate does not include the storage required for SWA,
Severity: 4 because it is assumed that you placed SWA above the
User Response: You should: 16MB line. The region size calculation is discussed in
Part 2 of DB2 Installation Guide.
1. Press ENTER to continue; the data set(s) will be
deleted and reallocated OR This message is issued by the following installation
CLIST: DSNTINST
Chapter 17. DB2 Messages 415
DSNT438I • DSNT442E
Severity: 8 (error) This message is issued by the following installation
CLIST: DSNTINST
System Action: The CLIST continues, but does not
produce edited jobs. Severity: 4 (warning)
User Response: Check the numbers entered for System Action: The CLIST will continue. This is only
numbers of concurrent users and databases, buffers, a warning.
and plan sizes. One or more of these numbers needs to
User Response: Turn off lock escalation and/or user
be reduced.
lock limiting.
Problem Determination: If you suspect an error in the
process, set CONTROL(CONLIST) and invoke the
DSNT440I TOTAL BP SIZE TOO LARGE
CLIST. This produces tracing for error documentation.
Explanation: The total size of a VIRTUAL or HIPER
buffer pool is too large. The summation of the
DSNT438I WARNING, IRLM LOCK MAXIMUM
ssnmDBM1 address space storage requirements for all
SPACE = irlmreg K, AVAILABLE SPACE
virtual buffer pools cannot exceed 1.6GB, and the total
= irlmav K
number of buffers cannot exceed 8,000,000. When
Explanation: You specified a maximum number of calculating the storage requirements for the virtual
locks per user that could use a total space larger than buffer pools, DB2 uses the page size (4K, 8K, 16K, or
that available to the IRLM, causing it to abend. It is not 32K) for each VPTYPE(PRIMARY) buffer and 128 bytes
likely that all threads will have the maximum number of for each VPTYPE(DATASPACE) buffer. For hiperpools,
locks, but if the maximum exceeds the amount of space the maximum is 8GB.
by a significant factor, the possibility of abends in the
This message is issued by the following panels:
IRLM is increased.
DSNTIP1, DSNTIP2, DSNTIP6
If the CROSS MEMORY value from the DSNTIPJ
System Action: The panel is redisplayed and the
installation panel is YES, the private region size is the
cursor is placed on the field in error.
space available for the IRLM. The available space is
estimated as 60000K since extended private address User Response: Reduce one or more of the buffer
space is used. If the CROSS MEMORY value is NO, pool sizes.
then the MAXIMUM ECSA value space is available for
the IRLM. The maximum space used is estimated as
the MAX USERS value from the DSNTIPE panel times DSNT441I INVALID HIPERPOOL SIZE
the number of LOCKS PER USER value on the Explanation: If a nonzero hiperpool value is specified,
DSNTIPJ panel times 250 bytes per lock. the corresponding virtual buffer pool value must also
This message is issued by the following installation have a nonzero value. For example, if a nonzero value
CLIST: DSNTINST is specified for the BP1 hiperpool size, then the value
for the BP1 virtual buffer pool size must be greater than
Severity: 4 (warning) zero.
System Action: The CLIST will continue. This message is issued by the following panels:
DSNTIP1, DSNTIP2
User Response: Choose one of the following
responses: System Action: The panel is redisplayed and the
v Ensure that you can run with the overcommitment of cursor is placed on the field in error.
lock address space, or
v Lower the value of the MAX USERS or LOCKS PER User Response: Enter a value greater than zero for
USER field. the virtual buffer pool size or reduce the value for the
hiperpool size to zero.
DSNT439I IRLM NO LOCK ESCALATION OR NO
USER MAXIMUM DSNT442E ERROR, VIRTUAL STORAGE OF main
EXCEEDS THE SYSTEM LIMIT OF 2
Explanation: You specified the number 0 for: GIGABYTES
v The number of table or table space locks that will
cause lock escalation, or Explanation: The total of all virtual storage
v The number of locks that will terminate a DB2 user. calculations exceeds the maximum amount possible for
an address space.
A lock escalation value of 0 turns off lock escalation and
means that DB2 cannot use this means of conserving This message is issued by the following CLIST:
lock space. A user maximum of 0 means that the DSNTINST
calculation noted in the DSNT438 message cannot be Severity: 8 (error)
performed to see if the IRLM has sufficient address
space for all users, since there is no maximum per user. System Action: The installation CLIST returns to the
416 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT443I • DSNT450I
initial panel without editing the installation jobs. have valid names. If the DB2 LOCATION NAME is
unknown, leave both fields blank and the remote
User Response: Respecify installation values that
sample jobs will not be edited.
determine storage sizes so that the 2 GB limit is not
exceeded. This message is issued by the following panel:
DSNTIPY
DSNT443I VALUES MARKED WITH AN ASTERISK System Action: The panel is displayed.
HAVE BEEN UPDATED
User Response: Either scroll back to the
Explanation: An asterisk is placed before the DISTRIBUTED DATA FACILITY panel and enter a value
description of fields which were generated by the for the DB2 LOCATION NAME, or enter a blank in the
DSNTINST CLIST. This message only appears when REMOTE LOCATION field on the job editing panel.
you update field(s) from a prior panel used to generate
the fields on the current panel.
DSNT448I RECOMMEND REAL STORAGE = size
This message is issued by the following panels: K
DSNTIPA, DSNITPL
Explanation: This is the estimated amount of real
System Action: The panel is displayed. storage recommended to support the virtual storage
sizes chosen.
User Response: Verify that the current value is what
you want. If it is not, enter the desired value. The amount of real storage needed will vary greatly.
Some customers will find that they need several times
the estimate shown. For more information on storage
DSNT444I SCROLLING BACKWARD MAY
calculations, refer to Part 2 of DB2 Installation Guide.
CHANGE FIELDS MARKED WITH
ASTERISKS This message is issued by the following CLIST:
DSNTINST
Explanation: The marked fields on the current panel
are generated from fields on other panels. If you scroll Severity: 0 (successful execution)
backward, these fields may be updated to reflect new
System Action: The CLIST continues.
values from other panels. For example, the ARCHIVE
PREFIX field is generated from the CATALOG ALIAS User Response: Compare this recommended value
field on DSNTIPA2. Message DSNT443I will be with the actual available real storage.
displayed to inform you when fields are changed by the
DSNTINST CLIST.
DSNT449I NUMBER OF LOGS REDUCED FROM
This message is issued by the following panels: old-num TO MAXIMUM OF 31
DSNTIPA, DSNITPL
Explanation: The number of active log data sets used
System Action: The panel is displayed. in the DB2 release you are migrating from is greater
than the new maximum number of data sets allowed for
User Response: No action required.
the current release of DB2. Installation job DSNTIJUZ
will update your bootstrap data sets to contain only the
DSNT445I REMOTE LOCATION NAME MUST NOT last 31 data sets.
BE THE SAME AS LOCAL LOCATION
This message is issued by the following panel:
Explanation: The name entered for the remote DSNITPL
sample location was the same as the local location
System Action: The value is reduced to the maximum
name.
of 31 and the panel is displayed.
This message is issued by the following installation
User Response: Update any other fields on the panel
panel: DSNTIPY
and continue.
System Action: The panel is displayed.
User Response: Enter a remote location name or DSNT450I type ENTRY MUST BE EXACTLY TWO
leave the field blank to indicate that the organization CHARACTERS
sample will only be executed locally.
Explanation: These entries are used to complete
SYS1.PARMLIB member names and must be exactly
DSNT446I SAMPLE LOCATION MUST BE BLANK two characters. The type is:
IF LOCAL LOCATION IS BLANK APF AUTH
For the APF-authorized library list IEAAPFxx
Explanation: In order to edit the remote sample jobs,
LINK LIST
both the DB2 LOCATION NAME (local location) on
For the link list library concatenation LNKLSTxx
panel DSNTIPR and the REMOTE LOCATION must
Chapter 17. DB2 Messages 417
DSNT451I • DSNT458I
MVS SUBSYS
DSNT456I ERROR IN VARIABLE varname, VALUE
For the MVS subsystem list IEFSSNxx
IS value
This message is issued by the following installation Explanation: The variable named 'varname' does not
CLIST: DSNTINST have a valid value. Its current value is 'value'.
Subsequent messages will describe the reason the
Severity: 8 (error) value is invalid and the action taken by the CLIST.
System Action: The CLIST will continue. If the error is in the CONTROL value, the value was
User Response: Check your entries for these fields specified when the CLIST was invoked. The value is not
on the MVS panel and make them exactly two valid, and no additional tracing will be done. The
characters. See job DSNTIJMV that was produced and permitted values are NONE, LIST, CONLIST, and
correct the IEBUPDTE CHANGE statement. SYMLIST. Each value produces more CLIST tracing
information than those which precede it. If the error is in
other values, the value was specified when the CLIST
DSNT451I WARNING-THE LOCAL DATE LENGTH was invoked on the ISPF panels.
OR LOCAL TIME LENGTH HAS BEEN
INCREASED This message is issued by the following installation
CLIST: DSNTINST
Explanation: The LOCAL DATE LENGTH or LOCAL
TIME LENGTH has been increased and a REBIND Severity: 8 (error)
command must be issued for any dependent plans. System Action: The CLIST will continue, but will not
This message is issued by the following installation produce jobs or parameter data.
CLIST: DSNTINST User Response: Check the subsequent messages.
Severity: 4 (warning) Exit, then invoke the CLIST with a valid value for the
variable.
System Action: Processing continues.
Problem Determination: If you suspect an error in the
User Response: Rebind all application plans that process, set CONTROL(CONLIST) and invoke the
depend upon the length of the local format that was CLIST in batch, so that the tracing can be sent with the
changed. error documentation. The CLIST itself and the
parameter member read in should be sent as well.
DSNT454I ERROR CODE = errcode, CNT = count
Explanation: An error was encountered during CLIST DSNT457I The SUBSYSTEM NAME MUST BE
processing for reading the parameter member. Most of DIFFERENT THAN THE PROC NAME
these errors are caused by having a mismatch between Explanation: Internal MVS restrictions require that the
the level of the CLIST and that of the parameter IRLM subsystem name be different than the procedure
member being read. name.
The 'errcode' is an error code defined for the CLIST. This message is issued by the following panel: DSNTIPI
The error code values and associated meanings are
found in TSO/E CLISTS. System Action: The panel is redisplayed and the
cursor is placed on the field in error.
The 'count' value is the number of parameter values
already read. User Response: Change either the SUBSYSTEM
NAME or the PROC NAME so these fields are unique
This message is issued by the following installation with respect to each other.
CLIST: DSNTINST
System Action: The CLIST will terminate. DSNT458I VALUE MUST BE NUMERIC
User Response: Be sure the parameter member and Explanation: The variable named in message
the CLIST are at the same level. DSNT456I must be an integer. Only digits are allowed,
Problem Determination: If you suspect an error in the with no decimal point or fractions. If the value is a
process, set CONTROL(CONLIST) and invoke the number suffixed by K or M, it is interpreted as the
CLIST in batch, so that the tracing can be sent with the indicated number multiplied by 1024 or 1048676. If any
error documentation. You will also need the listing of the other non-numeric character is present in the value, or if
CLIST and the parameter member being read. the K or M is not the final character, this message is
produced.
This message is issued by the following installation
CLIST: DSNTINST
Severity: 8 (error)
418 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT459I • DSNT465I
System Action: The CLIST will continue, but will not
DSNT462I VALUE IS TOO LONG, MAXIMUM IS
produce edited jobs or parameter data.
length CHARACTERS
User Response: This CLIST will continue, but will not
Explanation: The variable named in message
produce edited jobs. The value of the variable has been
DSNT456I must be shorter than its current value. The
set to the value shown in message DSNT465I. You will
maximum length allowed is 'length'.
need to reenter the output parameter and output data
set prefix. Examine the value and reset it if needed. This message is issued by the following installation
CLIST: DSNTINST
DSNT459I VALUE IS TOO LOW, MINIMUM IS min Severity: 8 (error)
Explanation: The variable named in message System Action: The CLIST will continue, but will not
DSNT456I must be larger than its current value. The produce edited jobs. The CLIST resets the value to the
minimum value allowed is 'min'. default value.
This message is issued by the following installation User Response: See message DSNT465I for the
CLIST: DSNTINST CLIST action.
Severity: 8 (error)
DSNT463I DATA SHARING FIELD MUST BE
System Action: The CLIST will continue, but will not
BLANK IN UPDATE MODE.
produce edited jobs. The CLIST resets the incorrect
value to 'min'. Explanation: This field is not relevant in Update mode
and must be blank This message is issued by panel:
User Response: See message DSNT465I for the
DSNTIPA1
CLIST action.
System Action: The panel is redisplayed and the
cursor is placed on t field in error.
DSNT460I VALUE IS TOO HIGH, MAXIMUM IS
max User Response: Replace the value with a blank.
Explanation: The variable named in message
DSNT456I must be smaller than its current value. The DSNT464I VALUES PERMITTED ARE values
maximum value allowed is 'max'.
Explanation: The variable named in message
This message is issued by the following installation DSNT456I must be one of the 'values' listed.
CLIST: DSNTINST
This message is issued by the following installation
Severity: 8 (error) CLIST: DSNTINST
System Action: The CLIST will continue, but will not Severity: 8 (error)
produce edited jobs. The CLIST resets the incorrect
System Action: The CLIST will continue, but will not
value to 'max'.
produce edited jobs.
User Response: See message DSNT465I for the
User Response: See message DSNT465I for the
CLIST action.
CLIST action.
DSNT461I THE BUFFER POOL MAXIMUM IS LESS
DSNT465I VARIABLE varname SET TO value
THAN THE MINIMUM VALUE ENTERED
Explanation: The variable, 'varname', named in
Explanation: Buffer pool maximums must be greater
message DSNT456I is in error. Possible reasons for the
than or equal to the minimum value for the same buffer
error are listed in messages: DSNT458I, DSNT459I,
pool.
DSNT460I, DSNT462I, DSNT463I, DSNT464I.
This message is issued by the following panel:
This message is issued by the following installation
DSNTIPE
CLIST: DSNTINST
System Action: The panel is redisplayed and the
System Action: The CLIST will continue, but will not
cursor is placed on the field in error.
produce edited jobs. The value has been set to the
User Response: Either reduce the minimum value or value shown.
increase the maximum value for the indicated buffer
User Response: Specify the output data again on the
pool buffer.
primary install panel. You will be able to see and
change the value. If this value is not acceptable,
change it, noting the limits.
Chapter 17. DB2 Messages 419
DSNT466I • DSNT472I
This message is issued by the following installation
DSNT466I Output member CANNOT BE
CLIST: DSNTINST
DSNTIDVB OR DSNTIDXA
Severity: 8 (error)
Explanation: The OUTPUT MEMBER NAME field
must not be DSNTIDVB or DSNTIDXA. These two System Action: The CLIST will return to the main
members are shipped with DB2 and must not be install panel, DSNTIPA1.
overwritten.
User Response: Specify DSNTIDXA as the INPUT
This message is issued by the following panel: MEMBER NAME and specify the current value for the
DSNTIPA1 migration member.
System Action: The panel is redisplayed and the
cursor is placed on the field in error. DSNT470I WARNING, ONLY ONE VOLUME WAS
SPECIFIED
User Response: Change the value of the field under
the cursor. Explanation: Only one volume serial number was
specified on the install panel or CLIST invocation. This
Note: If the member you specify already exists, it will does not allow adequate recovery or performance
be overwritten. unless it is intended to be a single volume test system.
This message is issued by the following installation
DSNT467I OUTPUT MEMBER SHOULD BEGIN CLIST: DSNTINST
WITH DSNTID
Severity: 4 (warning)
Explanation: The output parameter member will be
System Action: The CLIST will continue.
placed into prefix.SDSNSAMP. This data set already
has a large number of members. To avoid replacing a User Response: If this subsystem is intended to be
member that you need, a naming convention with prefix recoverable, more than one volume is needed. Rerun
'DSNTID' is strongly suggested. The suffixes 'VB' and the installation tailoring process, specifying at least one
'XA' are not allowed (see message DSNT466I). more volume on the DSNTIPA2 panel. If this is just a
single volume test system, be sure that you specify a
This message is issued by the following installation
single copy of the log data sets. The boot strap data
CLIST: DSNTINST
sets are small and not active, so that two are
Severity: 4 (warning) recommended even on a single volume system.
System Action: The CLIST will continue.
DSNT471I BEGINNING PARAMETER INPUT
User Response: Specify a different name for the
MEMBER inmem
output member.
Explanation: The input parameter member, 'inmem', is
being read. This data includes values for all of the
DSNT468I ERROR(S) ENCOUNTERED, OUTPUT IS
installation parameters.
BYPASSED
This message is issued by the following installation
Explanation: An error was detected earlier in this run.
CLIST: DSNTINST
Because of the error, data set editing was not
performed. Severity: 0 (successful execution)
This message is issued by the following installation System Action: The CLIST will continue.
CLIST: DSNTINST
Severity: 8 (error) DSNT472I WORK FILE DATABASE NAME
CANNOT START WITH DSNDB EXCEPT
System Action: The CLIST will continue, but will not
FOR DSNDB07
produce edited jobs.
Explanation: The work file database name cannot
User Response: Correct the errors noted earlier, and
start with the characters DSNDB unless the name is
specify the output prefix name again to produce the
DSNDB07.
edited data.
This message is issued by the following panel:
DSNTIPK
DSNT469I INPUT PARAMETERS MUST BE READ
BEFORE MIGRATION System Action: The panel is redisplayed and the
cursor is placed on the field in error.
Explanation: The INPUT MEMBER NAME on panel
DSNTIPA1 must have a value to allow migration values User Response: Change the name so that it does not
to be read. This is to permit the new values to be start with DSNDB.
initialized.
420 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT473I • DSNT480I
DSNT473I BEGINNING CHECK PHASE DSNT477I OUTPUT count, varname, type, minval,
maxval, currentval
Explanation: This message indicates the following:
v The values entered on the panels are being checked. Explanation: The values entered on the panels are
v Values which use the K or M suffix are being being written to the output parameter member. The
translated to numbers. count, the variable name, the data type, the minimum
value, the maximum value, and the current value are
This message is issued by the following installation shown. This message occurs when the CONTROL
CLIST: DSNTINST keyword requests a trace.
Severity: 0 (successful execution) This message is issued by the following installation
CLIST: DSNTINST
System Action: The CLIST will continue.
Severity: 0 (successful execution)
DSNT474I READING count, varname, datatype, System Action: The CLIST will continue.
data sharing scope, minval, maxval,
currentval
DSNT478I BEGINNING EDITED DATA SET
Explanation: The values are being read from the OUTPUT
parameter member. The count, the variable name, the
Explanation: The output jobs and data are being
data type, the data sharing scope, the minimum value,
edited to tailor them. Edited JCL output was requested
the maximum value, and the current value are shown.
and no severe errors were encountered.
This message occurs when the CONTROL keyword
requests a trace. This message is issued by the following installation
CLIST: DSNTINST
This message is issued by the following installation
CLIST: DSNTINST Severity: 0 (successful execution)
Severity: 0 (successful execution) System Action: The CLIST will continue.
System Action: The CLIST will continue.
DSNT479I THE IRLM GROUP NAME AND DB2
GROUP NAME MUST BE DIFFERENT
DSNT475I CHECK count, varname, type, minval,
maxval, currentval Explanation: You entered an IRLM group name on
panel DSNTIPJ that is the same as the DB2 group
Explanation: This message indicates the following:
name entered on panel DSNTIPK. The names must be
v The values read in or entered on the panels are
different.
being checked.
v Values which use the K or M suffix are being This message is issued by the following panel:
translated to numbers. DSNTIPJ
The count, the variable name, the data type, the System Action: The panel is redisplayed and the
minimum value, the maximum value, and the current cursor is placed on the field in error.
value are shown. This message occurs when the
User Response: Either change the DB2 group name
CONTROL keyword requests a trace.
entered on panel DSNTIPK or the IRLM group name on
panel DSNTIPJ.
This message is issued by the following installation
CLIST: DSNTINST
DSNT480I NAME MUST BE 1-16 CHARS, BEGIN
Severity: 0 (successful execution)
WITH A-Z, AND NOT INCLUDE #, @,
System Action: The CLIST will continue. OR $.
Explanation: The location name specified on panel
DSNT476I BEGINNING PARAMETER OUTPUT DSNTIPR is invalid. The location name must be 1-16
MEMBER outmem alphanumeric characters, excluding the alphabetic
extenders #, @ or $, and must begin with a letter.
Explanation: The output parameter member named
'outmem' is being written. This data includes values for This message is issued by panel: DSNTIPR
all the install parameters.
System Action: The panel is redisplayed and the
This message is issued by the following installation cursor is placed on the field in error.
CLIST: DSNTINST
User Response: Change the location name to meet
Severity: 0 (successful execution) the allowable criteria.
System Action: The CLIST will continue.
Chapter 17. DB2 Messages 421
DSNT481I • DSNT486I
v Reenter smaller values for NUMCONDB,
DSNT481I DSNTINST data set DATA SET SIZE
NUMTABLE, or NUMTABSP on the SIZES and
MAY BE TOO SMALL
STORAGE SIZES panels. You can do this by either
Explanation: The DSNTINST CLIST encountered an using the END key to go back to those panels or by
arithmetic overflow during calculation of this data set’s running the CLIST again.
size.
System Action: DSNTINST continues processing and DSNT483I NAME MUST BE 1-8 CHARS AND
uses 2147483647 for the result of the calculation that MUST BEGIN WITH A-Z
caused the overflow. Thus, the size of the data set
Explanation: The DB2 data sharing group name
might be too small.
specified on panel DSNTIPK or the IRLM data sharing
User Response: Check the data set size in installation group name specified on panel DSNTIPJ is invalid. The
job DSNTIJIN. If it is too small, increase it. DB2 or IRLM group name must be 1-8 characters, and
must begin with a letter.
DSNT482I TOO MANY CONCURRENTLY This message is issued by panels: DSNTIPJ, DSNTIPK
ALLOCATED DATA SETS, opnds
System Action: The panel is redisplayed and the
Explanation: The number (opnds) calculated for the cursor is placed on the field in error.
number of concurrent databases, tables per database,
User Response: Change the group name to meet the
and table spaces per database, is too large. The
allowable criteria.
maximum number of data sets that can be allocated to
an MVS address space is 32 767. However, note that
10 000 is the maximum for releases prior to OS/390 DSNT485I type SIZE = size K
Version 2 Release 6 and that virtual storage below the
16 MB line may be the limiting factor. See DSNT436I Explanation: This is the estimated main storage size
and DSNT437I for more information. for part of the DB2 database address space. This is the
most constrained address space. The 'type' can be
The number of concurrently allocated data sets is BUFFER POOL, SORT POOL SIZE, RID POOL SIZE,
calculated using the formula: EDMPOOL STORAGE, DATA SET STORAGE, CODE
OPNDS = (NUMCONDB X NUMTABLE X NUMINDEX) + STORAGE, or WORKING STORAGE.
(NUMCONDB X NUMTABSP)
The storage for buffer pools, sort pools, rid pools,
Where Represents EDMPOOL, and code is above the 16MB line. Most of
the main storage for data set control blocks is below the
NUMCONDB 16MB line and is included in the region size. Working
The maximum number of concurrently active storage includes storage above and below the 16MB
databases (DATABASES on panel DSNTIPE) line, but storage above the line is not included in the
NUMTABLE region. Refer to Part 2 of DB2 Installation Guide for
The estimated average number of tables per more information regarding this calculation.
database (TABLES on panel DSNTIPD) This message is issued by the following installation
NUMINDEX CLIST: DSNTINST
The estimated average number of indexes per Severity: 0 (successful execution)
table (set to 2)
System Action: The CLIST continues.
NUMTABSP
The estimated average number of table spaces
per database (TABLE SPACES on panel DSNT486I TOTAL MAIN STORAGE = totregion K
DSNTIPD)
Explanation: This is the estimated total region size. It
includes storage above the 16MB line. Refer to Part 2
This message is issued by the following installation of DB2 Installation Guide for more details regarding this
CLIST: DSNTINST calculation.
Severity: 4 (warning) This message is issued by the following installation
System Action: The CLIST reduces the value of CLIST: DSNTINST
NUMCONDB so that the calculated value for OPNDS is Severity: 0 (successful execution)
within the allowed range. CLIST processing continues.
System Action: The CLIST continues.
User Response: Do one of the following:
v Accept the reduced value for NUMCONDB calculated
by the CLIST.
422 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT487I • DSNT491I
These size estimates are for system data only. They do
DSNT487I TOTAL STORAGE BELOW 16MB =
not include: user data, archive logs, image copies, or
region K (ASSUMING SWA IS ABOVE
temporary work data sets other than the temporary
THE LINE)
database.
Explanation: This message provides an estimate of
the virtual storage required below the 16MB line to
DSNT489I CLIST EDITING dsname(member),
check for virtual storage constraints. This calculation
explanation
presumes that you have moved the SWA for DB2 above
the 16MB line. Refer to Part 2 of DB2 Installation Guide Explanation: The CLIST is editing the data set and
for details regarding this calculation. member dsname(member). The explanation is the type
of data being edited and has one of these values:
This message is issued by the following installation
CLIST: DSNTINST INSTALL JCL
Jobs that are edited and run as directed during
Severity: 0 (successful execution)
the installation process.
System Action: The CLIST continues.
MIGRATE JCL
User Response: Check for virtual storage constraints. Jobs that are edited and run as directed only
Your MVS should permit at least this amount of virtual during the migration process.
storage below the 16MB line.
FALL BACK JCL
A job that is only run as directed when falling
DSNT488I VOLUME voln WILL REQUIRE AT back to the previous release.
LEAST nn 4K BLOCKS
RECOVERY JCL
Explanation: This message states the number of 4KB A job that is only run as directed during a
blocks of space that will be required for the specified recovery process. It deletes the DB2 data sets.
volume in order to install or migrate the current release
SAMPLE JCL
of DB2.
Jobs that are edited and run during installation
Volume 'voln' is specified in the VOLUME SERIAL fields verification to add the sample application.
on install panel DSNTIPA2, or with the VOLSDATn input
SAMPLE DATA
parameters to the Install CLIST. The message indicates
Edited data that installation verification jobs
how much space will be needed on the selected volume
require.
to install or migrate this release of DB2.
CLIST Customized CLISTs to reflect your names used
This message is issued by the following installation
during the installation process.
CLIST: DSNTINST
Severity: 0 (successful execution) This message is issued by the following installation
CLISTs:
System Action: Processing continues.
User Response: Ensure that the volume has at least DSNTINST DSNTINS1 DSNTINS2
as much available storage as the message indicates it
should have. If it does not, rerun the INSTALL CLIST Severity: 0 (successful execution)
specifying different volumes, or create more available
space on the originally specified volume. System Action: The CLIST continues.
In order to convert the number of 4KB blocks required
to the number of cylinders required, use the table below. DSNT490I SAMPLE DATA UNLOAD PROGRAM
Divide the number of 4KB blocks (in the DSNT488I
Explanation: This is the header, indicating a normal
message) by the number of 4KB blocks per cylinder (in
start for the application program.
the table) to get the number of cylinders required.
Device Type 4KB Blocks per 4KB Blocks per DSNT491I TOO MANY TABLES ENTERED
Cylinder Track (MAXIMUM OF 100 TABLES)
3330 57 3 Explanation: The number of tables entered for
3340 24 2 unloading exceeded the maximum of 100 tables. The
3350 120 4 first 100 tables in the input should have been
3375 96 8 processed.
3380 150 10 System Action: The application program is
terminated.
Chapter 17. DB2 Messages 423
DSNT492I • DSNT498I
User Response: Split the run into multiple runs, none
DSNT495I SUCCESSFUL UNLOAD n ROWS OF
with more than 100 tables.
TABLE tttttttt
Problem Determination: Check the application
Explanation: The message indicates that 'n' rows of
program input. Make sure there are no more than 100
table or view 'tttttttt' were unloaded. The 'n' rows were
tables.
counted during the unload processing.
System Action: The request was executed
DSNT492I SQL WARNING DURING SQL
successfully.
STATEMENT func, TABLE tttttttt
Explanation: The SQL statement may not be
DSNT496I UNRECOGNIZED DATA TYPE CODE OF
executed correctly. The function 'func' may be
nnnnn
PREPARE, OPEN, FETCH, or CLOSE, indicating the
type of SQL statement encountering the error. Table Explanation: The PREPARE returned an invalid data
'tttttttt' is the name of the table or view being unloaded. type code of decimal 'nnnnn'.
System Action: The request may not be executed System Action: The next table is processed.
correctly.
User Response: Notify the system programmer.
User Response: Refer to “Part 2. SQL Return Codes”
System Programmer Response: See the Problem
on page 9.
Determination section.
Problem Determination: Determine which SQL
Problem Determination: There is an error in the
statement in the application program caused the
unload program or a new data type has been added.
warning and see if it is reproducible. Follow the
The recognized data types are fullword integer, halfword
diagnosis approach suggested for the warning.
integer, fixed-length character, variable length character,
packed decimal, floating-point, fixed-length graphic,
DSNT493I SQL ERROR DURING SQL STATEMENT variable length graphic, and long, variable length
func, TABLE tttttttt graphic.
Explanation: The SQL statement may not be
executed correctly. The function 'func' may be DSNT497I RETURN CODE FROM MESSAGE
PREPARE, OPEN, FETCH, or CLOSE, indicating the ROUTINE DSNTIAR
type of SQL statement encountering the error. Table
Explanation: The message formatting routine detected
tttttttt is the name of the table or view being unloaded.
an error.
System Action: The request was not executed
System Action: The application program is
correctly.
terminated.
User Response: Refer to “Part 2. SQL Return Codes”
User Response: Notify the system programmer.
on page 9.
System Programmer Response: See the Problem
Problem Determination: Determine which SQL
Determination section.
statement in the application program caused the error
and see if it is reproducible. Follow the diagnosis Problem Determination: There is an error in the
approach suggested for the SQL return code. unload program. The return code from DSNTIAR is
given in the MVS output of your job. When reporting this
problem, have the return code, the application program
DSNT494I ERROR DURING OPEN OF DDNAME
listing, and JCL available.
SYSRECnn
Explanation: The ddname listed, where 'nn' ranges
DSNT498I ERROR, NO VALID COLUMNS FOUND
from 00 to 99, could not be successfully opened. A
possible reason is that the DD statement to the data set Explanation: The PREPARE returned data which did
was not present in the JCL. not produce a valid output record. The data was not
recognized as valid, so the columns were not unloaded.
System Action: The application program is
terminated. System Action: The next table is processed.
User Response: Check the JCL to ensure that this User Response: Notify the system programmer.
DD statement is provided and is able to be used for
output. System Programmer Response: See the Problem
Determination section.
Problem Determination: Make sure that the same
number of DD statements and table names were Problem Determination: There is an error in the
provided. unload program. When reporting this problem, have the
application program listing and its JCL available.
424 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT499I • DSNT501I
DSNT499I ERROR IN INPUT PARAMETER LIST DSNT501I csect-name RESOURCE UNAVAILABLE
Explanation: The parameter list specified when :
DSNTIAUL or DSNTEP2 was invoked contains one or
more invalid values. CORRELATION-ID = id1
CONNECTION-ID = id2
System Action: The application program is LUW-ID = id3
terminated. REASON = reason
User Response: Notify the system programmer. TYPE = type
NAME = name
System Programmer Response: Check the
parameter values entered when DSNTIAUL or
DSNTEP2 was invoked. For DSNTIAUL, the correct Explanation: The requested function requires a
parameter value is 'SQL'. This parameter indicates that resource that is currently unavailable. This message is
DSNTIAUL input is in complete SQL statements issued with other messages that identify the system
terminated by a semicolon. For DSNTEP2, the correct action and the action the installer or operator should
parameter values are either 'ALIGN(LHS)', take.
'ALIGN(MID)', 'MIXED', or 'NOMIXED'. The first two DB2 can recover from a resource not available in some
parameter values represent the two output alignment cases and can complete successfully. One example is
options available in DSNTEP2 where 'ALIGN(LHS)' will during setup of a performance enhancement during bind
align the output on the left margin and 'ALIGN(MID)' will time for execution time. If DB2 recovers successfully,
center the output. The remaining two parameter values then no action is necessary.
designate whether or not DSNTEP2 will recognize
mixed character data where 'MIXED' means that it will For type=905, reason=00C90092, and name=IRLM,
and 'NOMIXED' means that it will not recognize mixed message DSNT501I is usually issued once. It is
character data. suppressed at the DB2 subsystem level until the IRLM
out-of-storage condition is relieved.
DSNT500I csect-name RESOURCE UNAVAILABLE id1 The correlation identifier of the thread
REASON reason TYPE type NAME name associated with the requester of the resource.
Explanation: The requested function requires a id2 The connection identifier of the requester.
resource that is currently unavailable. In conjunction id3 The logical-unit-of-work identifier (LUW-ID) of
with other messages this message will identify the the thread associated with the requester of the
system action and the action that should be taken by resource. An asterisk (*) indicates that the
the installation or operator. thread does not have a LUW-ID. If the LUW-ID
'type' and 'name' identify the resource that is currently is not an asterisk, the value is a
unavailable. The type code identifies the type, format, logical-unit-of-work-id assigned to the thread.
and content of the resource named. This is followed by an equal sign (=) and a
token value, which can be used in place of
Operator Response: Note the reason code, the type logical-unit-of-work-id in any DB2 command
code, and the name. See the Problem Determination that accepts logical-unit-of-work-id as input.
section for an explanation of the collected data.
type The type of resource that is currently
Problem Determination: The reason the resource is unavailable. The 'type' identifies the type, as
unavailable is identified by a reason code. The reason well as the format and content, of the resource
codes that appear in this message are described in 'name'. Use Table 3 in “Appendix B. Problem
“Part 4. DB2 Codes” on page 707. Use Table 3 in determination” on page 1281 to find the type of
“Appendix B. Problem determination” on page 1281 to resource identified in the message.
find the type of resource identified in the message.
name The name of the resource that is currently
If type is X'D00' or X'D01', the table name can be unavailable.
determined by using the following SQL statement:
reason The reason code that tells why the resource is
SELECT CREATOR, NAME
FROM SYSIBM.SYSTABLES unavailable.
WHERE DBID = dbid AND OBID = obid; Operator Response: Note the 'reason' code, the 'type'
code, and the 'name'.
However, if the failing table has been dropped, then the
above SELECT fails or possibly might return an Problem Determination: A type X’401’ indicates that
incorrect name. a cascading revoke of SYSADM or SYSCTRL in a
lower-level release attempted to revoke privileges or
Collect the following diagnostic item listed in grants on objects that are available only in a
“Appendix B. Problem determination” on page 1281: 1. higher-level release. Because the cascading revoke
Chapter 17. DB2 Messages 425
DSNT502I • DSNT508I
affects objects that are unknown to the lower-level
DSNT506I INPUT STATEMENT WAS NOT SELECT
release, you can only revoke SYSADM or SYSCTRL
* FROM A SINGLE TABLE. LOAD
from the higher-lever release.
STATEMENT WILL NEED
Collect the following diagnostic item listed in MODIFICATION.
“Appendix B. Problem determination” on page 1281: 1.
Explanation: The SELECT statement used to request
a table unload contained one of the following:
DSNT502I ERROR IN DSNTIAUL SQL INPUT: v A SELECT clause other than ″SELECT * FROM″
statement
v A FROM clause that does not contain exactly one
Explanation: The DSNTIAUL input SQL statement table name
could not be prepared.
The table to be loaded is therefore not the same as the
System Action: The application program terminates.
table from which the data is unloaded. DSNTIAUL is
User Response: Notify the system programmer. unable to determine the table name and all column
names for the table to be loaded.
System Programmer Response: Check that the
DSNTIAUL input statement is a complete SQL Severity: 4 (warning)
statement, ending with a semicolon.
System Action: DSNTIAUL generates a LOAD
statement containing the string ’TBLNAME’ for the table
DSNT503I UNLOAD DATA SET ddname RECORD name. Some column names may be blank.
LENGTH SET TO nnnnn.
User Response: Change the LOAD statement table
Explanation: If the ddname is SYSRECnn, the record name to the name of a table with the indicated column
length specified in the JCL for the data set is not large descriptions.
enough to contain an entire row of unloaded data, or
the record length was not specified in the JCL.
DSNT507I csect-name RECORD LENGTH NEEDED
If the ddname is SYSPUNCH, the record length IS GREATER THAN MAXIMUM
specified in the JCL is not between 80 and 255, or the ALLOWED FOR TABLE table-name
record length was not specified in the JCL.
Explanation: In order to unload table table-name, DB2
System Action: DB2 sets the record length of the needs an output data set with a record length greater
unload data set to the value specified in the message than the system maximum of 32760 bytes. This occurs
text. when the table to be unloaded is in a 32KB page table
space and contains a combination of long columns and
a number of date, time, or timestamp columns.
DSNT504I UNLOAD DATA SET ddname
BLOCKSIZE SET TO nnnnn. Severity: 8 (error)
Explanation: The block size for the SYSRECnn or System Action: The application program is
SYSPUNCH data set was one of the following: terminated.
v Not specified in the JCL
v Set to zero in the JCL DSNT508I WARNING - NONSTANDARD JOB
v Less than the required record length CARD (cardstat), NO JOB CARDS WILL
BE ADDED TO THE EDITED JOBS
v Not an even multiple of the required record length
Explanation: The job card you entered in field 3 of
System Action: DB2 sets the block size of the unload panel DSNTIPY contains one or more of the following
data set to the value specified in the message text. errors:
v Less than 7 characters ('cardstat' = TOO SHORT)
DSNT505I DSNTIAUL OPTIONS USED: ’nnn’. v "//" missing as the first 2 characters ('cardstat' =
Explanation: You specified these options when you MISSING //)
invoked DSNTIAUL. ’SQL’ is the only valid option. v Missing the word ″JOB″ ('cardstat' = MISSING
"JOB"TOKEN)
Severity: 0 (informational)
This message is issued by the following installation
CLIST: DSNTINST
System Action: The message is written to the screen,
after all panels are displayed and before any job editing.
No JCL is added to the edited jobs.
User Response: You can continue with job editing
426 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT509I • DSNT514I
and manually add JCL to the edited jobs. Alternatively, This message is issued by the following panel: DSNTIPI
you can repeat the installation process and make
User Response: Enter unique names in these fields
corrections to the job card entered on panel DSNTIPY.
for each member of a DB2 data sharing group.
DSNT509I WARNING - MIGRATION INPUT
DSNT512I DSNT512I WARNING: ENTER UNIQUE
MEMBER LEVEL IS rel_ind. LEVEL
NAMES FOR LUNAME AND LOCATION
prev_rel IS REQUIRED. RETURN TO
NAME
PANEL DSNTIPA1 TO CHANGE
MIGRATION INPUT MEMBER Explanation: This warning message is issued to
remind you that you must enter values for DB2
Explanation: The migration input member you entered
LOCATION NAME and DB2 NETWORK LUNAME
on panel DSNTIPA1 contains incorrect release indicator
fields.
’rel_ind’. It should contain the indicator for the prior
release (’prev_rel’). If your input member does not LUNAME is used to uniquely identify this DB2
contain a release indicator, ’rel_ind’ will be <null>. This subsystem within the network and to uniquely identify
probably indicates that you are using a down-level trace records for correlation of accounting records. The
member. NETWORK LUNAME must be unique within the
network. The installation process does not check for
This message is issued by the following installation
uniqueness of this name within a data sharing group.
CLIST: DSNTINST
The LOCATION NAME must be unique within the
System Action: The message is written to the screen,
network, but must be the same on all members within a
after display of panel DSNTIPA1.
DB2 data sharing group.
User Response: Press ENTER to proceed to the next
This message is issued by the following panel:
panel, and then PF3 to return to panel DSNTIPA1 in
DSNTIPR
order to enter an input member with the correct release
indicator. User Response: Enter unique names in these fields.
DSNT510I WARNING - INPUT MEMBER inmem DSNT513I FIELD 2 MUST BE UNIQUE FOR EACH
LEVEL IS rel_ind. LEVEL curr_rel IS NEW MEMBER INSTALLED
REQUIRED. RETURN TO PANEL
DSNTIPA1 TO CHANGE INPUT Explanation: This warning message is issued to
MEMBER remind you that the DB2 PROC NAME field on panel
DSNTIPX or the RESYNC PORT fieldon panel
Explanation: The input member ’inmem’ you entered DSNTIP5 must be unique for each new member
in field 6 on panel DSNTIPA1 contains incorrect release installed within a DB2 data sharing group. The
indicator ’rel_ind’. It should contain the indicator for the installation process does not check for uniqueness of
current release (’curr_rel’). If your input member does these values within a group.
not contain a release indicator, ’rel_ind’ will be <null>.
This probably indicates that you are using a down-level This message is issued by the following panels:
member. DSNTIPX and DSNTIP5
This message is issued by the following installation User Response: Enter unique values in these fields
CLIST: DSNTINST for each member of a DB2 data sharing group.
System Action: The message is written to the screen,
after display of panel DSNTIPA1. DSNT514I FIELDS 2 AND 3 MUST BE UNIQUE
FOR EACH NEW MEMBER INSTALLED
User Response: Press ENTER to proceed to the next
panel, and then PF3 to return to panel DSNTIPA1 in Explanation: This warning message is issued to
order to enter an input member with the correct release remind you that the MEMBER NAME and WORK FILE
indicator. DB NAME must be unique for each new member
installed within a DB2 data sharing group. The
installation process does not check for uniqueness of
DSNT511I FIELDS 2 AND 5 MUST BE UNIQUE these names within a group.
FOR EACH NEW MEMBER INSTALLED
This message is issued by the following panel:
Explanation: This warning message is issued to DSNTIPK
remind you that the IRLM SUBSYSTEM and IRLM
PROC names must be unique for each new member User Response: Enter unique names in these fields
installed within a DB2 data sharing group. The for each member of a DB2 data sharing group.
installation process does not check for uniqueness of
these names within a group.
Chapter 17. DB2 Messages 427
DSNT515I • DSNT524I
This message is issued by the following panel:
DSNT515I FIELD 7 MUST BE UNIQUE FOR EACH
DSNTIP5
NEW MEMBER INSTALLED
System Action: The panel is redisplayed and the
Explanation: This warning message is issued to
cursor is placed on the field in error.
remind you that the MEMBER IDENTIFIER field on
panel DSNTIPJ or the DSNZPARM NAME field on User Response: Change either the DRDA PORT or
panel DSNTIPO must be unique for each new member the RESYNC PORT value so that they are different.
installed within a DB2 data sharing group. The
installation process does not check for uniqueness of
these values within a group. DSNT519I IF YOU SPECIFY EITHER DRDA OR
RESYNC PORT, BOTH MUST BE
This message is issued by the following panels: SPECIFIED
DSNTIPJ and DSNTIPO
Explanation: You entered a value for either DRDA
User Response: Enter unique values in these fields PORT or RESYNC PORT, but not the other. If either
for each member of a DB2 data sharing group. DRDA PORT or RESYNC PORT is specified, both must
be specified.
DSNT516I FIELDS 1, 2, AND 4 MUST BE UNIQUE This message is issued by the following panel:
FOR EACH NEW MEMBER INSTALLED DSNTIP5
Explanation: This warning message is issued to System Action: The panel is redisplayed and the
remind you that the SUBSYSTEM NAME, COMMAND cursor is placed on the field in error.
PREFIX, and SUBSYSTEM SEQUENCE fields must be
unique for each new member installed within a DB2 User Response: Either enter a value for the null field,
data sharing group. The installation process does not or blank out both DRDA PORT and RESYNC PORT.
check for uniqueness of these values within a group.
This message is issued by the following panel: DSNT522I csect-name REQUIRED TCP/IP
DSNTIPM SUPPORT NOT AVAILABLE
User Response: Enter unique values in these fields Explanation: The DB2 BSDS indicated that TCP/IP
for each member of a DB2 data sharing group. access was required, but the required TCP/IP interfaces
were not available on this system. The required TCP/IP
interfaces are provided by OS/390 Release 3.
| DSNT517I CHARACTERS 2-18 MUST BE A-Z, 0-9,
| #, @, $, OR UNDERSCORE System Action: DDF startup terminates abnormally.
| Explanation: WLM environment names that do not System Programmer Response: Take one of the
| meet the following criteria are not allowed. A WLM following actions:
| environment name may contain up to eighteen v Install OS/390 Release 3 or later, so that the required
| characters. The first character of a WLM environment TCP/IP interfaces are available.
| name must either be an alphabetic character (A-Z) or a v Use the change log inventory utility (DSNJU003) to
| standard alphabetic extender (in the United States, the deactivate DB2’s TCP/IP support, by specifying
| standard alphabetic extenders are '#', '@', '$'). For PORT=0 and RESPORT=0 on the DDF statement.
| characters two through eighteen, a character may be an
| alphabetic character (A-Z), an alphabetic extender ('#',
| '@', '$'), a numeric character (0-9), or the underscore | DSNT524I SQL PROCEDURE DATA MIGRATION
| character ('_'). | HAS COMPLETED SUCCESSFULLY.
| rowcount ROWS WERE COPIED FROM
| This message is issued by panel: DSNTIPX | TABLE SYSIBM.SYSPSM TO TABLE
| System Action: The panel is redisplayed, and the | SYSIBM.SYSROUTINES_SRC. rowcount
| cursor is placed on the field with the error. | ROWS WERE COPIED FROM TABLE
| SYSIBM.SYSPSMOPTS TO TABLE TO
| User Response: Change the WLM environment name | SYSIBM.SYSROUTINES_OPTS
| to meet the criteria described above.
| Explanation: DB2 program DSNTIGR issued this
| message after it completed a one-time migration of SQL
DSNT518I THE VALUES FOR DRDA PORT AND | procedure data. DSNTIGR migrated the SQL procedure
RESYNC PORT CANNOT BE THE | data from user-maintained tables SYSIBM.SYSPSM and
SAME | SYSIBM.SYSPSMOPTS to the DB2 catalog tables
Explanation: You entered the same value for DRDA
| SYSIBM.SYSROUTINES_SRC and
PORT and RESYNC PORT. The values for these fields
| SYSIBM.SYSROUTINES_OPTS.
must be different. | System Action: Migration of SQL procedure data to
428 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT525I
| the DB2 catalog is complete. All changes were | already contains data. DSNTIGR was
| committed. | cancelled because the migration integrity
| cannot be guaranteed.
| User Response: None.
| 30 An SQL error occurred when DSNTIGR copied
| data from table SYSIBM.SYSPSM to table
| DSNT525I SQL PROCEDURE DATA MIGRATION
| SYSIBM.SYSROUTINES_SRC. Message
| CANCELLED, ERROR CODE error-code
| DSNT408I provides more information about the
| Explanation: DB2 program DSNTIGR issued this | SQL error.
| message after it encountered errors during a once-only
| 40 An SQL error occurred when DSNTIGR copied
| migration of SQL procedure data. DSNTIGR attempted
| data from table SYSIBM.SYSPSMOPTS to
| to migrate the SQL procedure data from
| table SYSIBM.SYSROUTINES_OPTS.
| user-maintained tables SYSIBM.SYSPSM and
| Message DSNT408I provides more information
| SYSIBM.SYSPSMOPTS to the DB2 catalog tables
| about the SQL error.
| SYSIBM.SYSROUTINES_SRC and
| SYSIBM.SYSROUTINES_OPTS. The error-code | 50 An SQL error occurred when DSNTIGR
| identifies the specific cause of the problem as follows: | requested a row count of table
| SYSIBM.SYSPSM. Message DSNT408I
| 01 SQL procedure data cannot be migrated to the
| provides more information about the SQL error.
| DB2 catalog because the user-maintained SQL
| procedure source table, SYSIBM.SYSPSM, | 52 An SQL error occurred when DSNTIGR
| does not exist. | requested a row count of table
| SYSIBM.SYSPSMOPTS. Message DSNT408I
| 02 An SQL error occurred when DSNTIGR
| provides more information about the SQL error.
| searched SYSIBM.SYSTABLES for table
| SYSIBM.SYSPSM. Message DSNT408I | 54 An SQL error occurred when DSNTIGR
| provides more information about the SQL error. | requested a row count of table
| SYSIBM.SYSROUTINES_SRC. Message
| 03 An object named SYSIBM.SYSPSM exists, but
| DSNT408I provides more information about the
| it is not a table. This situation can occur if
| SQL error.
| DSNTIGR was run before, and
| SYSIBM.SYSPSM is now a view of | 56 An SQL error occurred when DSNTIGR
| SYSIBM.SYSROUTINES_SRC. | requested a row count of table
| SYSIBM.SYSROUTINES_OPTS. Message
| 07 SQL procedure data cannot be migrated to the
| DSNT408I provides more information about the
| DB2 catalog because the user-maintained SQL
| SQL error.
| procedure options table,
| SYSIBM.SYSPSMOPTS, does not not exist. | 57 After all rows were copied from the
| SYSIBM.SYSPSM to
| 08 An SQL error occurred when DSNTIGR
| SYSIBM.SYSROUTINES_SRC, the row counts
| searched SYSIBM.SYSTABLES for table
| of the tables did not match. This indicates that
| SYSIBM.SYSPSMOPTS. Message DSNT408I
| a data integrity error has occurred.
| provides more information about the SQL error.
| 59 After all rows were copied from the
| 09 An object named SYSIBM.SYSPSMOPTS
| SYSIBM.SYSPSMOPTS to
| exists but it is not a table. This situation can
| SYSIBM.SYSROUTINES_OPTS, the row
| occur if DSNTIGR was run before, and
| counts of the tables did not match. This
| SYSIBM.SYSPSMOPTS is now a view of
| indicates that a data integrity error has
| SYSIBM.SYSROUTINES_OPTS.
| occurred.
| 10 An SQL error occurred when DSNTIGR
| 60 An SQL error occurred when DSNTIGR tried to
| requested an exclusive lock on table
| drop the database that contains the
| SYSIBM.SYSPSM. Message DSNT408I
| user-maintained SQL procedures tables,
| provides more information about the SQL error.
| SYSIBM.SYSPSM and
| 12 An SQL error occurred when DSNTIGR | SYSIBM.SYSPSMOPTS. Message DSNT408I
| requested an exclusive lock on table | provides more information about the SQL error.
| SYSIBM.SYSPSMOPTS. Message DSNT408I
| 70 An SQL error occurred when DSNTIGR tried to
| provides more information about the SQL error.
| create view SYSIBM.SYSPSM on table
| 21 Catalog table SYSIBM.SYSROUTINES_SRC | SYSIBM.SYSROUTINES_SRC. Message
| already contains data. DSNTIGR was | DSNT408I provides more information about the
| cancelled because the migration integrity | SQL error.
| cannot be guaranteed.
| 72 An SQL error occurred when DSNTIGR tried to
| 23 Catalog table SYSIBM.SYSROUTINES_OPTS | create view SYSIBM.SYSPSMOPTS on table
Chapter 17. DB2 Messages 429
DSNT601I • DSNT694I
| SYSIBM.SYSROUTINES_OPTS. Message error in DB2, refer to Part 2 of DB2 Diagnosis Guide
| DSNT408I provides more information about the and Reference for information on identifying and
| SQL error. reporting the problem.
| 80 An SQL error occurred during a COMMIT
| operation. Message DSNT408I provides more DSNT602I NO SPACES FOUND
| information about the SQL error.
Explanation: This message is issued for multiple line
| 82 An SQL error occurred during a ROLLBACK WTO. It is produced when a DISPLAY DB(name)
| operation. Message DSNT408I provides more SPACENAM(...) is entered and no spaces were found to
| information about the SQL error. satisfy the request. SPACENAM(...) might have been
entered as a range, a subset, or a list of spaces.
| System Action: DB2 discontinues the migration of
| SQL procedure data to the DB2 catalog, and all
| changes are rolled back. DSNT603I spacetype name NOT type
| User Response: If an SQL error has occurred, see Explanation: This message is issued for multiple-line
| message DSNT408I to determine the specific error. WTO. It is produced when no table space or index
| Refer to “Part 2. SQL Return Codes” on page 9 for more space listed in the DISPLAY DB(...) SPACENAM(...)
| information on the SQL error. satisfies your request.
| If table SYSIBM.SYSPSM or SYSIBM.SYSPSMOPTS spacetype
| has been deleted, recover database DSNDPSM to TABLESPACE if the space is a table space or
| restore the table. INDEXSPACE if the space is an index space.
| You can run DSNTIGR successfully only once. For data name The name of the space.
| sharing migration, run DSNTIGR only on the first
type A character string that indicates the type of
| member of the group to migrate. Do not run DSNTIGR
request specified. The string is a list of the
| after remigration.
following, delimited by 'OR':
| Catalog tables SYSIBM.SYSROUTINES_SRC and v 'ACTIVE' if the keyword ACTIVE is specified
| SYSIBM.SYSROUTINES_OPTS must be empty before
v 'RESTRICTED' if the keyword RESTRICT is
| you run DSNTIGR. If you have already added rows to
specified.
| these catalog tables, drop the SQL procedures whose
| creation added the rows. Run job DSNTIGR to migrate System Action: Message DSNT301I or DSNT302I is
| SYSIBM.SYSPSM and SYSIBM.SYSPSMOPTS, then produced if no object is found and the keywords
| recreate the dropped SQL procedures. ACTIVE and RESTRICT are omitted.
| If the error code indicates a data integrity problem,
| notify the system programmer. DSNT604I NO INFORMATION AVAILABLE
Explanation: This message is issued for multiple line
DSNT601I THE DESCRIPTOR FOR type name WTO. It is produced when there is no LOCK or USE
DOES NOT EXIST IN DBD01 information available. When DISPLAY DB(name)
SPACENAM(...) is entered, and SPACENAM(...) is a list
Explanation: This message is issued for multiple-line
of spaces, this message indicates that no table spaces
WTO. The database, table space, or index space 'name'
or index spaces whose names are listed have LOCK or
is in the DB2 catalog but a descriptor for the object
USE information available. If DISPLAY DB(name)
does not exist in the DBD01 table space of database
SPACENAM(...) is entered, and SPACENAM(...) is a
DSNDB01. This error can be produced when one of the
range or a subset of spaces, no table spaces and index
following is true:
spaces within the specified database have LOCK or
v The Version 7 catalog has been migrated into Version USE information available. This message is produced
6. There is an object in the Version 6 catalog but only when the keywords USE and LOCKS are specified.
there is not a descriptor for the object in the Version
6 directory (DBD01).
DSNT694I DATABASE name CANNOT BE
v The user did not completely restore the DBD01 table
STOPPED. IT CONTAINS THE DDL
space during a recovery process.
REGISTRATION TABLES
v There is a DB2 logic error.
Explanation: The database specified in the message
In the message, 'type' is either 'DATABASE' or 'SPACE' cannot be stopped because it contains the application
and 'name' is the eight character name of the database, and object registration tables. Install SYSADM or install
table space, or index space. SYSOPR authority is needed to stop the database.
System Action: The process continues normally. System Action: The database specified in the
message is not stopped.
System Programmer Response: If you suspect an
430 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT695I • DSNT705I
User Response: Reissue the command with the User Response: See Operator Response.
proper authority.
Operator Response: If you want to activate the
governor, specify the ID of the resource limit
DSNT695I TABLESPACE name CANNOT BE specification table to be used and issue the START
STOPPED. IT CONTAINS A DDL RLIMIT command.
REGISTRATION TABLE
System Programmer Response: If the facility is
Explanation: The table space specified in the already active (that is, a DSNT703 message was
message cannot be stopped because it contains an previously received), verify that the DSNT703 message
application or object registration table. Install SYSADM appeared before the DISPLAY RLIMIT command was
or install SYSOPR authority is needed to stop the table entered. If uncertain, reissue the DISPLAY RLIMIT
space. command. If you suspect an error in DB2, refer to Part
2 of DB2 Diagnosis Guide and Reference for
System Action: The table space specified in the
information on identifying and reporting the problem.
message is not stopped.
Problem Determination: Collect the following
User Response: Reissue the command with the
diagnostic items listed in “Appendix B. Problem
proper authority.
determination” on page 1281: 1, 5.
DSNT696I INDEXSPACE name CANNOT BE
DSNT702I RESOURCE LIMIT FACILITY HAS BEEN
STOPPED. IT IS DEFINED ON A DDL
STOPPED. WAS USING table-name
REGISTRATION TABLE
Explanation: This message is the normal response for
Explanation: The index space specified in the
a STOP RLIMIT command. Table 'table-name' was
message cannot be stopped because it is defined on an
being used to determine resource limits.
application or object registration table. Install SYSADM
or install SYSOPR authority is needed to stop the index System Action: The governor is stopped.
space.
System Programmer Response: May be used to
System Action: The index space specified in the resolve questions about what table was being used.
message is not stopped.
User Response: Reissue the command with the DSNT703I RESOURCE LIMIT FACILITY IS
proper authority. ALREADY INACTIVE. STOP LIMIT
COMMAND IS IGNORED
DSNT700I table-name IS THE ACTIVE RESOURCE Explanation: A STOP RLIMIT command was entered
LIMIT SPECIFICATION TABLE but the resource limit facility was already stopped. The
command is ignored.
Explanation: This is a response message to the
DISPLAY RLIMIT command. The resource limit facility System Action: The system continues normal
(governor) is currently active and is using table processing.
'table-name' to determine resource limits.
System Action: The system continues normal DSNT704I table-name HAS BEEN STARTED FOR
processing. THE RESOURCE LIMIT FACILITY
User Response: See Operator Response. Explanation: This message is the normal response for
a START RLIMIT command. Table 'table-name' is
Operator Response: To have the governor active
currently being used to determine resource limits.
while utilizing a different resource limit specification
table, issue the START RLIMIT command specifying the System Action: The governor has started utilizing the
ID of the desired table. If you do not want the facility to specified table.
be active, issue the STOP RLIMIT command.
System Programmer Response: May be used to
System Programmer Response: May be used to resolve questions about what table is being used.
resolve questions about what table is being used.
DSNT705I csect-name DATABASE name CANNOT
DSNT701I RESOURCE LIMIT FACILITY IS BE STOPPED. IT CONTAINS AN
INACTIVE ACTIVE RESOURCE LIMIT
SPECIFICATION TABLE
Explanation: This is a response message to the
DISPLAY RLIMIT command. It results whenever the Explanation: Database name cannot be stopped
governor is not active. because it contains an active resource limit specification
table.
System Action: Normal processing continues.
Chapter 17. DB2 Messages 431
DSNT706I • DSNT708I
System Action: The database is not stopped.
DSNT707I START RLIMIT COMMAND FAILED.
Operator Response: If the database must be COLUMN column-name IN TABLE
stopped, either stop the resource limit facility (STOP table-name IS INCORRECTLY DEFINED.
RLIMIT), or switch it to use a resource limit specification THE COLUMN DEFINITION IS attribute
table that is not in the database (START RLIMIT,ID=xx). WITH LENGTH length AND NULL
In a DB2 data sharing environment, you must either ATTRIBUTE null-attribute. THE
stop the resource limit facility on all members of the COLUMN DEFINITION SHOULD BE
DB2 data sharing group or switch it to use a resource attribute WITH LENGTH length AND
limit specification table that is not in the database. NULL ATTRIBUTE null-attribute
Explanation: The START RLIMIT command has been
DSNT706I table-name DOES NOT EXIST. START entered but failed because TABLE 'table-name' does not
LIMIT COMMAND FAILED have the proper column definition for a resource limit
specification table. The current column definition is
Explanation: The START RLIMIT command has been given as well as the proper column definition.
entered but failed because table 'table-name' does not
exist. System Action: The START RLIMIT command is
ignored.
System Action: The START RLIMIT command is
ignored. User Response: See Operator Response.
User Response: See Operator Response. Operator Response: Verify that the 1 or 2 characters
following DSNRLST are what was intended to be
Operator Response: Verify that the 1 or 2 characters entered as the ID on the START RLIMIT command. If
following DSNRLST are what was intended to be not, reenter the command specifying the proper ID. If
entered as the ID on the START RLIMIT command. If the ID appears to be correct, contact the system
not, reenter the command specifying the proper ID. If programmer.
the ID appears correct, contact the system programmer.
System Programmer Response: TABLE 'table-name'
System Programmer Response: DB2 was unable to does not have the proper column definition for a
find the specified table in the catalog. Verify that the resource limit specification table. Compare the current
FULLY QUALIFIED name is the one expected. The table column definition to the proper column definition
table name is built by appending the 1 or 2 character ID given in the message.
specified on the START RLIMIT command to the
authorization ID.DSNRLST. The authorization ID is Problem Determination: Collect the console output
determined from the DSNZPARMs used when starting showing the failing START command.
the subsystem.
If everything appears to be in order, from a TSO DSNT708I INDEX index-name DOES NOT EXIST.
terminal with the proper authorization, enter the START RLIMIT COMMAND FAILED
following SQL statement:
Explanation: The START RLIMIT command has been
SELECT * FROM SYSIBM.SYSTABLES WHERE NAME=DSNRLSTxx entered but failed because INDEX DSNARLxx does not
AND CREATOR=authorization ID exist for the corresponding resource limit specification
table, DSNRLSTxx.
Where
DSNRLSTxx System Action: The START RLIMIT command is
Table-name starting with the DSNRLST ignored.
authorization ID User Response: See Operator Response.
Table-name up to but not including the period.
Operator Response: Verify that the 1 or 2 characters
If an entry is found, save the output and if you suspect following DSNRLST are what was intended to be
an error in DB2, refer to Part 2 of DB2 Diagnosis Guide entered as the ID on the START RLIMIT command. If
and Reference for information on identifying and not, reenter the command specifying the proper ID. If
reporting the problem. the ID appears to be correct, contact the system
programmer.
Problem Determination: Collect the following
diagnostic items: System Programmer Response: The resource limit
v Console output showing the failing START command specification table DSNRLSTxx does not define the
v The output of the SELECT command. required index DSNARLxx. Create the required index
and reissue the START RLIMIT command.
Problem Determination: Collect the console output
showing the failing START command.
432 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT709I • DSNT713I
ALTER TABLE to define the column as specified in the
DSNT709I new-table-name NOW ACTIVE.
message.
old-table-name WAS OLD RESOURCE
LIMIT SPECIFICATION TABLE Problem Determination: Collect the console output
showing the failing START command.
Explanation: A START RLIMIT command was entered
while the facility was already active. The facility remains
active and switches from using the old table name to DSNT712I INDEX index-name IS NOT FOR TABLE
the new one. table-name. START RLIMIT COMMAND
FAILED
User Response: Notify the system programmer.
Explanation: The START RLIMIT command has been
Operator Response: Notify the system programmer.
entered but failed because INDEX 'index-name' is not
defined for resource limit specification table
DSNT710I table-name ALREADY ACTIVE. START 'table-name'.
LIMIT COMMAND IGNORED
System Action: The START RLIMIT command is
Explanation: A START RLIMIT command was entered ignored.
and the governor is already active utilizing the specified
User Response: See Operator Response.
table. The command is ignored.
Operator Response: Verify that the 1 or 2 characters
System Action: The governor continues to use table
following DSNRLST are what was intended to be
'table-name'.
entered as the ID on the START RLIMIT command. If
User Response: See Operator Response. not, reenter the command specifying the proper ID. If
the ID appears to be correct, contact the system
Operator Response: Verify that the ID specified on
programmer.
the START RLIMIT command was the one desired. If
not, reenter the command specifying the correct ID. If it System Programmer Response: INDEX 'index-name'
is correct, no action is needed since the facility is is not defined in resource limit specification table
already active and is using the desired table. 'table-name'. resource limit specification table
DSNRLSTxx does not define the required index
System Programmer Response: If you suspect an
DSNARLxx. The last two characters of the table name
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
correspond to the last two characters of the index. Drop
and Reference for information on identifying and
the existing DSNARLxx index and create the correct
reporting the problem.
index in the resource limit specification Table.
Problem Determination: Collect the following
Problem Determination: Collect the console output
diagnostic items listed in “Appendix B. Problem
showing the failing START command.
determination” on page 1281: 1, 5.
DSNT713I INDEX index-name IS NOT UNIQUE.
DSNT711I COLUMN column-name IS MISSING IN
START RLIMIT COMMAND FAILED
TABLE table-name. SHOULD BE
DEFINED AS attribute WITH LENGTH Explanation: The START RLIMIT command has been
length AND NULL INDICATOR OF entered but failed because INDEX 'index-name' in the
null-attribute resource limit specification table is not defined as a
UNIQUE index.
Explanation: The START RLIMIT command has been
entered but failed because COLUMN 'column-name' in System Action: The START RLIMIT command is
resource limit specification table 'table-name' is not ignored.
defined. The proper column definition is given in the
User Response: See Operator Response.
message.
Operator Response: Verify that the 1 or 2 characters
System Action: The START RLIMIT command is
following DSNRLST are what was intended to be
ignored.
entered as the ID on the START RLIMIT command. If
User Response: See Operator Response. not, reenter the command specifying the proper ID. If
the ID appears to be correct, contact the system
Operator Response: Verify that the 1 or 2 characters
programmer.
following DSNRLST are what was intended to be
entered as the ID on the START RLIMIT command. If System Programmer Response: INDEX 'index-name'
not, reenter the command specifying the proper ID. If in resource limit specification table is not UNIQUE.
the ID appears to be correct, contact the system Redefine it as unique.
programmer.
Problem Determination: Collect the console output
System Programmer Response: TABLE 'table-name' showing the failing START command.
does not have COLUMN 'column-name' defined. Use
Chapter 17. DB2 Messages 433
DSNT714I • DSNT717I
Reference for information on identifying and reporting
DSNT714I INDEX index-name IS INCORRECTLY
the problem.
DEFINED. START RLIMIT COMMAND
FAILED Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
Explanation: The START RLIMIT command has been
determination” on page 1281: 1, 5.
entered but failed because INDEX 'index-name' in
resource limit specification table 'table-name' is not
properly defined. DSNT716E AN ERROR OCCURRED
ESTABLISHING A RESOURCE LIMIT
System Action: The START RLIMIT command is
FOR CORRELATION-ID correlation-id,
ignored.
CONNECTION-ID connection-id,
User Response: Contact the system programmer. LUW-ID luw-id =token. limit WILL BE
USED AS THE LIMIT
Operator Response: Contact the system programmer.
Explanation: An internal error occurred while the
System Programmer Response: INDEX 'index-name'
resource limit for the specified requester was being
in the resource limit specification table does not have
established. The 'limit' is determined from the default
the proper definition. Refer to Part 5 (Volume 2) of DB2
specified in the system parameters. This default can be:
Administration Guide for an example to define the
NOLIMIT
resource limit specification table.
No limit applies.
Problem Determination: Collect the console output NORUN
showing the failing START command. Zero time limit.
integer The limit to be used.
DSNT715E ERROR reason-code READING
A logical-unit-of-work identifier (LUW-ID) of '*' indicates
table-name. default WILL BE
that the thread does not have a LUW-ID. If the LUW-ID
RESOURCE LIMIT FOR
is not an '*', the value is a logical-unit-of-work-id that is
CORRELATION-ID correlation-id,
assigned to the thread followed by an '=' sign and a
CONNECTION-ID connection-id,
token value, which can be used in place of
LUW-ID luw-id =token
logical-unit-of-work-id in any DB2 command that accepts
Explanation: An error occurred while the resource logical-unit-of-work-id as input. Correlation IDs
limit specification table 'table-name' was being read. beginning with '0nn', where 'nn' is a number from 01 to
The limit is determined from the default specified in the 28, identify system agents.
system parameters. This default can be:
NOLIMIT This message is issued by the following CSECT:
No limit applies. DSNTCGET
NORUN
System Action: Processing continues using the
Zero time limit.
system-defined default.
integer The limit to be used.
Operator Response: Notify the system programmer.
The reason code that defines the read error is included
System Programmer Response: If you suspect an
in the message text, as are the 'connection-ID',
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
'correlation-ID', and the logical-unit-of-work identifier
and Reference for information on identifying and
(LUW-ID) of the thread. An LUW-ID of an '*' indicates
reporting the problem.
that the thread does not have a LUW-ID. If the LUW-ID
is not an '*', the value is a logical-unit-of-work-id that is Problem Determination: Collect the following
assigned to the thread followed by an '=' sign and a diagnostic items listed in “Appendix B. Problem
token value, which can be used in place of determination” on page 1281: 1, 5.
logical-unit-of-work-id in any DB2 command that accepts
logical-unit-of-work-id as input. Correlation IDs
beginning with '0nn', where 'nn' is a number from 01 to DSNT717I csect-name TABLE SPACE name
28, identify system agents. CANNOT BE STOPPED. IT CONTAINS
AN ACTIVE RESOURCE LIMIT
System Action: Processing continues using the SPECIFICATION TABLE
system-defined default.
Explanation: Table space name cannot be stopped
Operator Response: Notify the system programmer. because it contains an active resource limit specification
table.
System Programmer Response: This is an I/O error.
Investigate the problem indicated by the reason code System Action: The table space is not stopped.
and preceding messages. If you suspect an error in
DB2, refer to Part 2 of DB2 Diagnosis Guide and Operator Response: If the table space must be
stopped, either stop the resource limit facility (STOP
434 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT718I • DSNT723I
RLIMIT), or switch it to use a resource limit specification Problem Determination: Collect the console output
table that is not in the table space (START showing the failing START command.
RLIMIT,ID=xx). In a DB2 data sharing environment, you
must either stop the resource limit facility on all
DSNT721I csect-name DATABASE name CANNOT
members of the DB2 data sharing group or switch it to
BE STARTED WITH ACCESS (UT). IT
use a resource limit specification table that is not in the
CONTAINS AN ACTIVE RESOURCE
table space.
LIMIT SPECIFICATION TABLE
Explanation: Database name cannot be started with
DSNT718I csect-name INDEX SPACE name
access (UT) because it contains an active resource limit
CANNOT BE STOPPED. IT IS DEFINED
specification table.
ON AN ACTIVE RESOURCE LIMIT
SPECIFICATION TABLE System Action: The START DATABASE command is
ignored.
Explanation: Index space name cannot be stopped
because it contains an index on an active resource limit Operator Response: If the database must be started
specification table. with access (UT), either stop the resource limit facility
(STOP RLIMIT), or switch it to use a resource limit
System Action: The index space is not stopped.
specification table that is not in the database (START
Operator Response: If the index space must be RLIMIT,ID=xx). In a DB2 data sharing environment, you
stopped, either stop the resource limit facility (STOP must either stop the resource limit facility on all
RLIMIT), or switch it to use a different resource limit members of the DB2 data sharing group or switch it to
specification table that does not have an index in the use a resource limit specification table that is not in the
index space (START RLIMIT,ID=xx). In a DB2 data database.
sharing environment, you must either stop the resource
limit facility on all members of the DB2 data sharing
DSNT722I csect-name TABLE SPACE name
group or switch it to use a different resource limit
CANNOT BE STARTED WITH ACCESS
specification table that does not have an index in the
(UT). IT CONTAINS AN ACTIVE
index space.
RESOURCE LIMIT SPECIFICATION
TABLE
DSNT719I TABLE table-name CANNOT BE READ.
Explanation: Table space name cannot be started
START RLIMIT COMMAND FAILED
with access (UT) because it contains an active resource
Explanation: TABLE 'table-name' cannot be accessed. limit specification table.
This message may be preceded by related error
System Action: The START DATABASE command is
messages that explain why the table cannot be
ignored.
accessed.
Operator Response: If the table space must be
System Action: The START RLIMIT command failed.
started with access (UT), either stop the resource limit
User Response: See Operator Response. facility (STOP RLIMIT), or switch it to use a resource
limit specification table that is not in the table space
Operator Response: TABLE 'table-name' cannot
(START RLIMIT,ID=xx). In a DB2 data sharing
currently be accessed for reading. In the case of a
environment, you must either stop the resource limit
deadlock or timeout, reissue the START RLIMIT
facility on all members of the DB2 data sharing group or
command.
switch it to use a resource limit specification table that is
not in the table space.
DSNT720I csect-name INDEX index-name NEEDS
TO BE index-type
DSNT723I csect-name INDEX SPACE name
Explanation: The START RLIMIT command was CANNOT BE STARTED WITH ACCESS
entered but failed because the named index defined for (UT). IT IS DEFINED ON AN ACTIVE
the resource limit specification table is not defined RESOURCE LIMIT SPECIFICATION
properly. TABLE
System Action: The system ignores the START Explanation: Index space name cannot be started
RLIMIT command. with access (UT) because it contains an index on an
active resource limit specification table.
User Response: Contact the system programmer.
System Action: The START DATABASE command is
Operator Response: Contact the system programmer. ignored.
System Programmer Response: The named index Operator Response: If the index space must be
defined on the resource limit specification table does not started with access (UT), either stop the resource limit
have the proper definition. facility (STOP RLIMIT), or switch it to use a different
Chapter 17. DB2 Messages 435
DSNT724E • DSNT735I
resource limit specification table that does not have an allowed to perform bind operations.
index in the index space (START RLIMIT,ID=xx). In a
An LUW-ID '*' indicates that the request originated at
DB2 data sharing environment, you must either stop the
this site. If not an '*', the LUW-ID is assigned to the
resource limit facility on all members of the DB2 data
allied thread at the requesting site. Correlation IDs
sharing group or switch it to use a resource limit
beginning with '0nn' where 'nn' is a number from 01 to
specification table that does not have an index in the
28, identify system agents.
index space.
This message is issued by the following module:
DSNTCAUT
DSNT724E csect-name ERROR reason-code IN
READING RESOURCE LIMIT System Action: Processing occurs assuming the
SPECIFICATION TABLE table-name. authorization ID is allowed to perform bind operations.
FOR AUTHORIZATION ID auth-id
RUNNING THREAD WITH User Response: Notify the system programmer.
CORRELATION ID correlation-id, System Programmer Response: If you suspect an
CONNECTION ID connection-id, AND error in DB2, refer to Part 2 of DB2 Diagnosis Guide
LUWID luw-id, USE OF operation-name and Reference for information on identifying and
IS NOT GOVERNED. reporting the problem.
Explanation: An error occurred reading resource limit Operator Response: Notify the system programmer.
specification table 'table-name'. 'Auth-id' is assumed to
be allowed to perform 'operation-name'. Problem Determination: Collect the following
'Operation-name' is BIND or PARALLEL PROCESSING. diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 1, 2, 5.
The reason code defining the read error is included in
the message text as well as the connection ID,
correlation ID, and logical unit of work (LUW) ID of the DSNT726I csect-name DATABASE name AND ANY
thread. An LUW-ID '*' indicates that the request SPACE IT CONTAINS CANNOT BE
originated at this site. If not an '*', the LUW-ID is STARTED WITH ACCESS (UT). IT IS
assigned to the allied thread at the requesting site. THE ACTIVE COMMUNICATIONS
Correlation IDs beginning with '0nn', where 'nn' is a DATABASE
number from 01 to 28, identify system agents. Explanation: The database specified in the message
System Action: If the 'operation-name' is BIND, cannot be started with access (UT) because it is the
processing continues if the 'auth-id' is authorized to active communications database. In addition, spaces
perform the BIND. If the 'operation-name' is PARALLEL within the active communications database cannot be
PROCESSING, query parallelism is not disabled and started with access (UT).
can be used if the value of the CURRENT DEGREE System Action: The START DATABASE command is
special register is ’ANY’. ignored.
User Response: Notify the system programmer. Operator Response: If the database or any space
System Programmer Response: Investigate the within it must be started with access (UT), you must
problem indicated by the reason code and preceding stop the distributed data facility (STOP DDF). In a DB2
messages. If you suspect an error in DB2, refer to Part data sharing environment, you must stop the distributed
2 of DB2 Diagnosis Guide and Reference for data facility on all members of the DB2 data sharing
information on identifying and reporting the problem. group.
Operator Response: Notify the system programmer.
DSNT735I object name CANNOT BE STARTED. IT
Problem Determination: Collect the following CONTAINS OR IS DEFINED ON THE
diagnostic items listed in “Appendix B. Problem DDL REGISTRATION TABLE(S)
determination” on page 1281: 1, 2, 5.
Explanation: The object specified in the message
cannot be started because it contains or is defined on
DSNT725E AN ERROR OCCURRED WHILE the DDL registration table(s). Install SYSADM or install
GOVERNING BIND OPERATIONS OF SYSOPR authority is needed to start the object.
auth-id RUNNING WITH
CORRELATION-ID correlation-id, In the message, 'object' is either:
CONNECTION-ID connection-id, v DATABASE if the specified database contains the
LUW-ID luw-id. auth-id IS ALLOWED application and object registration tables
TO PERFORM BIND OPERATIONS v TABLESPACE if the specified table space contains
Explanation: An internal error occurred while an application or object registration table
determining whether or not 'auth-id' is allowed to v INDEXSPACE if the specified index space is defined
perform bind operations. It is assumed that 'auth-id' is on an application or object registration table
436 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT736I • DSNT803I
System Action: The object specified in the message v IRLM could not join its data sharing group. The
is not started. reason for the join failure is given in IRLM message
DXR134E.
User Response: Reissue the command with the
proper authority. v IRLM joined the wrong group. The set of IRLMs that
are connected to a given lock structure must all be
members of the same group. Ensure that the
DSNT736I csect-name ASYNCHRONOUS STOP GROUP parameter is correctly specified in the IRLM
DATABASE COMMAND HAS startup procedure. If you give an incorrect group
COMPLETED FOR COMMAND name, IRLM connects the lock structure, and then
command_string times out waiting for responses from other
Explanation: Asynchronous processing for the STOP connectors. IRLM issues message DXR133I for the
DATABASE command completed for the command timeout.
whose syntax is shown in the message.
command_string is the STOP DATABASE command DSNT801I ACTION A (ADD) DOES NOT ALLOW
string for the command that is completed. The string GENERIC DISPLAY (% IN DATA FIELD).
always uses the abbreviation DB for DATABASE and Explanation: You have to specify a specific data item
SPACE for SPACENAM to save characters. in the DATA field.
Only the first 100 characters of the STOP DATABASE This message is issued by the following panel:
command are displayed. DSN8SSH
System Action: Asynchronous processing for the System Action: The panel is redisplayed, and the
STOP DATABASE command is complete. cursor is placed on the field in error.
System Programmer Response: No action is User Response: Enter specific data in the DATA field.
required.
DSNT802I ONLY ACTION D (DISPLAY) IS
DSNT800I csect-name DB2 CANNOT IDENTIFY TO ALLOWED FOR DEPARTMENT
IRLM. IRLM CANNOT CONNECT TO ITS STRUCTURE.
DATA SHARING GROUP. THE LOCK
STRUCTURE THAT IRLM ATTEMPTED Explanation: You cannot add, update, or erase a
TO ACCESS WAS strname. department structure. You can only display it.
Explanation: IRLM failed to connect to the IRLM data This message is issued by the following panel:
sharing group. This message accompanies abend DSN8SSH
reason code 00E30806. System Action: The panel is redisplayed, and the
System Action: DB2 terminates abnormally with cursor is placed on the field in error.
reason code 00E30806. User Response: Change the ACTION field to D, or
System Programmer Response: Some possible change the OBJECT field to DE or EM.
reasons why IRLM could not connect to its data sharing
group are: DSNT803I csect-name DB2 CANNOT IDENTIFY TO
v The lock structure is not properly defined in the active IRLM. THE REQUESTED FUNCTION
MVS CFRM administrative policy. The lock structure LEVEL IS NOT SUPPORTED.
name is a concatenation of the DB2 data sharing
Explanation: An attempt was made to identify to an
group name and the string ’LOCK1’ separated by an
IRLM that does not support the level of function DB2
underscore (_). For example, if the DB2 data sharing
needs. This message accompanies abend reason code
group name is DSNCAT, DSNCAT_LOCK1 is the lock
00E30800.
structure name.
Ensure that the lock structure is properly defined in System Action: DB2 terminates abnormally with
the active CFRM policy. The name of the lock reason code 00E30800.
structure that IRLM attempted to access is given in System Programmer Response: Ensure that the
this message. IRLM issues message DXR138E to STEPLIB statement in your IRLM startup procedure is
indicate that the lock structure definition could not be referencing the correct IRLM code library and that IRLM
accessed in the active CFRM policy. is at the appropriate level of maintenance.
v IRLM could not connect the lock structure. The
reason for the connect failure is given in IRLM
message DXR135E.
Chapter 17. DB2 Messages 437
DSNT804I • DSNT806I
detected an orphan or missing LOB or
DSNT804I csect-name THERE ARE MODIFY
an out-of-sync condition between the
LOCKS OWNED BY THIS DB2 THAT
row in the base table and the LOB in
HAVE BEEN RETAINED
the LOB table space.
Explanation: When DB2 disconnected from IRLM
AUXW The table space is in aux warning
during DB2 shutdown, IRLM indicated that there were
state. AUXW on a LOB table space
still outstanding modify locks. These locks were retained
indicates that one or more LOBs in
by IRLM. The retained locks continue to protect the
the LOB table space is invalid. AUXW
resources on which they are held from requests from
on a base table space indicates that
other DB2s in the data sharing group. That is, IRLM
CHECK DATA detected an orphan or
rejects any lock request from another DB2 that is
missing LOB or an out-of-sync
incompatible with the retained state of the lock. The
condition between the row in the base
locks are retained until the terminating DB2 subsystem
table and the LOB in the LOB table
is restarted and the resources on which the locks are
space.
held are recovered.
CHKP The table space is in check pending
System Action: DB2 continues with its shutdown
status.
processing.
COPY An image copy is required for this
System Programmer Response: No response is
object (table space or data set within
necessary.
this table space). STOP is also
displayed. If the image copy is
DSNT805I NAME TYPE PART STATUS LPL required because DB2 encountered a
PAGES problem during RESTART, STOPE is
displayed instead of STOP.
Explanation: This message indicates the beginning of
a set of messages used to display information as a GRECP
result of a DISPLAY DATABASE command when the The object (a table space, a table
keyword LPL is specified. This message contains the space partition, index space, or index
headings of the display. (The message appears in one space partition) is marked recovery
continuous line across the screen, not as shown above.) pending because of the failure of a
This message is always followed by one or more group buffer pool. This status value
DSNT806I messages containing the column data. Refer appears only on spaces. It does not
to message DSNT806I for a description of the data apply to databases. See DB2 Data
these headings identify. Sharing: Planning and Administration
for information about resolving this
restricted status.
DSNT806I space type part status LPL pages
LPL The object has pages or ranges of
Explanation: This message contains the display
pages that are unavailable because of
information resulting from a DISPLAY DATABASE
logical or physical damage.
command when the keyword LPL is specified. It
contains the column data describing the status of a LSTOP The logical partition is stopped.
table space or index space in the database listed in the
RECP The table space or index space is in
preceding DSNT362I message. This message is always
recovery pending status. The member
preceded by its column headings message DSNT805I.
must be restarted to restore full
The message number for this message is not displayed.
access to the data. For logical
The message fields have the following meanings: partitions, the RECP status can
appear as RBDP*.
space The table space name or index space name.
RBDP* indicates that the entire index is
type TS for a table space, IX for an index space, LS
inaccessible to SQL applications,
for a LOB table space.
however only the logical partition
part The partition number. It is blank for a needs to be recovered.
nonpartitioned table space or index space.
RO The database, table space, or index
status One or more of the following, delimited by space is started for read activity only.
commas. The maximum length is 18
RW The database, table space, or index
characters:
space is started for read and write
ACHKP activity.
The table space is in aux check
STOP The database, table space, or index
pending state. ACHKP on a table
space is stopped.
space indicates that CHECK DATA
438 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNT807I • DSNT812I
STOPE DB2 implicitly stopped the table space but the associated IRLM is running with local scope
or index space because of an internal (SCOPE=LOCAL in the IRLM startup procedure). If you
inconsistency. A DSNT500I or are running DB2 in data sharing mode, ensure that the
DSNT501I message is issued at time associated IRLM startup procedure specifies
of error detection to indicate the SCOPE=GLOBAL. Conversely, if you are not running
inconsistency. DB2 in data sharing mode, ensure that the associated
IRLM startup procedure specifies SCOPE=LOCAL.
STOPP A stop is pending or is in process for
this database, table space, or index
space. DSNT810E csect-name DB2 CANNOT IDENTIFY TO
IRLM. AN INVALID LOCK STRUCTURE
UT The database, table space, or index
NAME WAS DETECTED.
space is started for utility processing
only. Explanation: DB2 could not identify to IRLM because
of an invalid lock structure name. This message
UTRO Although the table space or index
accompanies abend reason code 00E30807.
space is started as RW, a utility is in
process and only RO access is System Action: DB2 startup terminates abnormally
allowed. with reason code 00E30807.
UTRW The table space or index space is System Programmer Response: This condition
started as RW and a utility is in happens if you are not running DB2 in data sharing
process. mode, but the associated IRLM is running with global
scope (SCOPE=GLOBAL in the IRLM startup
UTUT Although the table space or index
procedure). If you are not running DB2 in data sharing
space is started as RW, a utility is in
mode, ensure that the associated IRLM startup
process and only UT access is
procedure specifies SCOPE=LOCAL. Conversely, if you
allowed.
are running DB2 in data sharing mode, ensure that the
LPL pages associated IRLM startup procedure specifies
The pages in the specified space that are SCOPE=GLOBAL.
unavailable because of logical or physical
damage.
DSNT811E csect-name DB2 CANNOT IDENTIFY TO
IRLM. REQUEST VIOLATES ONE DB2
DSNT807I csect-name IRLM PURGE OF RETAINED PER IRLM RULE.
LOCKS FAILED. RETURN CODE =
Explanation: DB2 could not identify to IRLM because
retcode SUB-CODE = subcode
another DBMS is already identified to the IRLM. This
Explanation: DB2 issued a PURGE request to IRLM message accompanies abend reason code 00E30802.
to purge retained locks for this DB2. The PURGE
System Action: DB2 abends with reason code
request did not complete successfully. This message
00E30802.
shows the return code and subcode from IRLM.
System Programmer Response: IRLM Version 2.1
This message is issued by the following CSECT:
enforces a one to one (1:1) mapping between IRLM and
DSNTRSTE
DB2. Multiple DBMS subsystems can no longer use the
System Action: DB2 abends with reason code same IRLM. Ensure that:
00E30808. Restart processing is terminated. v Each DB2 subsystem is associated with its own IRLM
System Programmer Response: Refer to the IRLM subsystem.
codes. v The correct IRLM procedure name and subsystem
name are specified in the DB2 system parameters.
DSNT809E csect-name FEEDBACK FROM IRLM
IDENTIFY INDICATED IRLM DID NOT DSNT812I –MEMBER NAME member-name
CONNECT TO THE LOCK STRUCTURE
Explanation: This message is issued with messages
Explanation: DB2 identified to IRLM, but cannot DSNT389I, DSNT394I or DSNT396I for each thread in a
continue because IRLM did not connect to the lock data sharing environment. This additional line reports
structure. Global locking is ignored. This message the member name of the DB2 subsystem accessing this
accompanies abend reason code 00E30809. object.
System Action: DB2 abnormally terminates with If the characters ’(CO)’ follow the member name, then
reason code 00E30809. this member is the castout owner for the page set or
partition. The castout owner for a page set or partition is
System Programmer Response: This condition the DB2 member responsible for doing all of the castout
happens if you are running DB2 in data sharing mode, I/O for that page set or partition.
Chapter 17. DB2 Messages 439
DSNT813I • DSNT814I
The message number and subsystem recognition
character are not included in this message.
DSNT813I ---- status(es) page(s)
Explanation: This message follows message
DSNT389I, DSNT392I, DSNT394I, DSNT396I or
DSNT806I to display more statuses, or more pages that
are in the logical page list (LPL).
LPL pages can be in two formats, single pages
(represented by the page number) or a range of pages
(represented by the starting page number followed by a
dash and the ending page number in the range).
The message number and subsystem recognition
character are not included in this message because this
message is part of a DISPLAY DATABASE data line.
DSNT814I NON-LOCAL INFORMATION
UNAVAILABLE FOR object = name
Explanation: One member of the DB2 data sharing
group was unable to obtain information from another
member for one of these reasons:
v Overflow of the maximum buffer area sent to the DB2
subsystem running the DISPLAY. This buffer area
contains the DISPLAY information.
v Problems occurred while requesting DISPLAY DB
information from peer DB2 subsystems.
Terms pertinent to this message:
object Either DATABASE or SPACE
name The name of the DATABASE or SPACE
User Response:
v Issue DISPLAY GROUP to see if any DB2 members
are down or unresponsive and then reissue the
DISPLAY DATABASE command.
v Specify individual database names or space names
instead of specifying ’*’.
440 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 18. DSNU... Messages
The severity values shown for the utility messages that follow are returned as the
job-step condition code from the job step during which the message is issued. If
additional messages having higher severity values are issued during the same job
step, the higher value is reflected as the job-step condition code.
Severity values have the following meanings:
0 Informational No error occurred
4 Warning A condition was detected; the user might
need to take further action
8 Error An error was detected and processing could
not continue
System Action: The utility job is abended.
DSNU000I csect-name OUTPUT START FOR
UTILITY, UTILID = uuuuuuu User Response: Refer to the appropriate MVS
publication.
Explanation: This message marks the start of output
for the given utility job. The utility ID used to identify the
utility job is 'uuuuuuu'. DSNU003I csect-name NOT INVOKED APF
AUTHORIZED
Severity: 0 (informational)
Explanation: The DSNUTILS stored procedure was
System Action: Utility processing continues.
not invoked authorized.
Severity: 8 (error)
DSNU001I csect-name- RELEASE DEPENDENT
MODULE module-name WAS NOT System Action: The utility is not run by the stored
FOUND procedure.
Explanation: The system could not find the specified User Response: Notify the system programmer.
module in the indicated library (private library, job
library, or link library). System Programmer Response: Make sure that the
DSNUTILS entry in SYSIBM.SYSPROCEDURES
System Action: The utility job is abended. specifies that the stored procedure runs in a
WLM-established address space (WLM_ENV not blank),
User Response: Ensure that the load module library
make sure that the DSNUTILS load module is link
is indicated correctly and that the indicated library
edited with AC(1), make sure the DSNUTILS load
contains the requested program. If the indicated library
module is in an APF authorized library, and make sure
does not contain the requested program, contact the
all the libraries in STEPLIB JOBLIB are APF authorized.
system programmer.
If you suspect an error in DB2, refer to Part 2 of DB2
System Programmer Response: The last three Diagnosis Guide and Reference for information on
characters of the module name indicate the DB2 identifying and reporting the problem.
release level of the subsystem identified in the
Problem Determination: Collect the following
parameters passed to DSNUTILB. However, LOAD
diagnostic items listed in “Appendix B. Problem
could not find the release dependent utility module for
determination” on page 1281: 1, 532, 46, 60, 61.
that release in the indicated library. This is probably a
maintenance problem.
DSNU004I csect-name UTILITY utility NOT
SUPPORTED
DSNU002I csect-name - COULD NOT LOAD
RELEASE DEPENDENT MODULE Explanation: Refer to DB2 Utility Guide and
module-name CODE=code Reference for a description of utilities supported by the
REASON=reason stored procedure.
Explanation: During the load of 'module-name', MVS Severity: 8 (error)
returned the indicated system completion code and
reason. System Action: The utility is not run by the stored
procedure.
© Copyright IBM Corp. 1982, 2001 441
DSNU005I • DSNU010I
User Response: Run the utility as a batch job. correct DB2 subsystem has been started via the
-START DB2 command.
DSNU005I csect-name input record Problem Determination: DB2 must be started in order
to execute DB2 utilities.
Explanation: This message displays the utility
statements as they were provided as input to the utility
parser. An additional error message follows this DSNU008I csect-name SPECIFIED USER FAILED
message and identifies why the utility statement caused VALIDITY CHECK
a parser error.
Explanation: Utility startup processing has been
Severity: 8 (error) unable to connect to DB2, because the user failed the
connection validity check.
System Action: Utility processing is not initiated. No
SYSIBM.SYSUTIL record is created. Severity: 8 (error)
User Response: Correct the input error, and resubmit System Action: Utility processing is terminated
the job. Do not restart the job. without invoking the requested utility or utilities.
User Response: Contact the system programmer for
DSNU006I csect-name DB2 SYSTEM system-name assistance with your installation’s security checking.
HAS NOT BEEN STARTED
System Programmer Response: Locally defined
Explanation: Utility startup processing has been RACF or equivalent security system connection
unable to connect to the indicated DB2 subsystem, authorization have denied the user access to DB2.
because a -START DB2 command has not been issued Permit DB2 connection authorization if this user should
for that subsystem. be allowed access.
Severity: 8 (error)
DSNU009I csect-name SPECIFIED USER NOT
System Action: Utility processing is terminated
AUTHORIZED FOR DB2 UTILITIES
without invoking the requested utility or utilities.
Explanation: Utility startup processing for the user
User Response: Correct your JCL to specify the
indicated on the job statement failed, because the user
correct subsystem-name on the EXEC statement, and
is not authorized to execute DB2 utilities.
resubmit the job. Otherwise, contact the system
programmer to determine when the subsystem will be Severity: 8 (error)
available for processing.
System Action: Utility processing is terminated
Operator Response: Contact the system programmer without invoking the requested utility or utilities.
to determine if a -START DB2 command should be
User Response: Contact your system programmer for
issued for the indicated subsystem.
assistance with your installation’s security checking.
System Programmer Response: Have the operator
System Programmer Response: If the USER
issue a -START DB2 command for the indicated
specified something on the job statement that is
subsystem.
incorrect, correct it, and resubmit the job. Use the SQL
Problem Determination: DB2 must be started in order GRANT command to give the user the desired authority.
to execute DB2 utilities.
DSNU010I csect-name UTILITY EXECUTION
DSNU007I csect-name DB2 SYSTEM system-name COMPLETE, HIGHEST RETURN CODE
DOES NOT EXIST = rr
Explanation: Utility startup processing has been Explanation: The utility completed processing with a
unable to connect to the indicated DB2 subsystem, return code of 'rr'. This indicates that no terminating
because it does not exist on this system. error was detected.
Severity: 8 (error) Severity: 0 (informational) or 4 (warning)
System Action: Utility processing is terminated System Action: In most cases, the SYSIBM.SYSUTIL
without invoking the requested utility or utilities. record for this job step is deleted from
SYSIBM.SYSUTIL. However, if the utility used was
User Response: Correct your JCL to specify the
REORG and UNLOAD(PAUSE), the SYSIBM.SYSUTIL
correct subsystem-name on the EXEC statement, and
record remains intact so that REORG can be restarted
resubmit the job. Contact your system programmer if
at the RELOAD phase.
you are not sure which DB2 subsystem you should
specify. User Response: If the return code ('rr') is 0, no
response is required.
System Programmer Response: Ensure that the
442 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU012I • DSNU017I
If the return code ('rr') is 4, the utility output should be System Action: Utility processing is not initiated.
examined for other messages.
User Response: Use the -DISPLAY utility command
to determine the correct qualifier. The job can then be
DSNU012I csect-name UTILITY EXECUTION resubmitted.
TERMINATED, HIGHEST RETURN
CODE = rr
DSNU016I csect-name UTILITY BATCH MEMORY
Explanation: The utility execution was terminated. An EXECUTION ABENDED, REASON=X0rrr
error was detected that would not allow processing to
Explanation: The utility batch address space has
continue. The return code has a value of 8.
abended. If X'0rrr' is four characters in length (that is,
Severity: 8 (error) X'00C1'), the abend was a system X'rrr' abend. If X'0rrr'
is four characters in length and system abend X'000'
System Action: Utility processing is terminated.
was indicated, a user abend was issued. If X'0rrr' is
User Response: Examine utility output for other error eight characters in length, the abend was a system
messages. X'04E' abend, and X'0rrr' is an abend reason code.
System Action: The utility job is abended. The
DSNU013I csect-name JOB WITH DUPLICATE SYSIBM.SYSUTIL entry for the job is retained in the
UTILID FOUND IN SYSUTIL SYSUTIL table.
Explanation: An entry with the same qualifier was User Response: Consult the system programmer to
found in the SYSIBM.SYSUTIL table. The current job obtain information on failure analysis. If the cause of the
did not specify restart. failure is correctable, the utility job can be restarted. If
the error cannot be corrected, the -TERM command
System Action: The utility job is abended with reason should be used to delete the failing job’s utility id from
code X'00E40018'. SYSIBM.SYSUTIL.
User Response: If the job was intended to restart the System Programmer Response: If a system abend
utility, RESTART should be added to the EXEC was encountered (4 characters), refer to the appropriate
parameters. If the job was intended to rerun the utility, MVS publication. If an abend reason code was
the -TERM utility command should be used to delete encountered (8 characters), refer to DB2 Utility Guide
the entry that has the same qualifier from the and Reference for problem determination.
SYSIBM.SYSUTIL table. If the job had no relation to the
SYSIBM.SYSUTIL entry job, a new qualifier should be
used. DSNU017I csect-name UTILITY DATABASE
SERVICES MEMORY EXECUTION
ABENDED, REASON=X0rrr
DSNU014I csect-name JOB WITH DUPLICATE
UTILID CURRENTLY EXECUTING Explanation: The database services address space
has abended. If X'0rrr' is four hexadecimal digits in
Explanation: A job with the same qualifier was found length (for example, X'00C1'), the abend was an MVS
to be executing. X'rrr' abend. If X'0rrr' is eight hexadecimal digits in
System Action: The utility job is abended with reason length, the abend was a DB2 subsystem X'04E' abend,
code X'00E40018'. and X'0rrr' is an abend reason code.
User Response: If the job with the same qualifier that System Action: The utility job is abended. The entry
is currently executing is correct, either wait for the job to for the job is retained in the SYSIBM.SYSUTIL table.
complete before using the same qualifier, or use User Response: Consult with the system programmer
another qualifier. If the job currently executing is to obtain information about failure analysis. If the cause
incorrect, the -TERM command can be used to of the failure is correctable, the utility job can be
terminate it, and the failing job can be resubmitted. Do restarted. If the error cannot be corrected, the -TERM
not -TERM UTILITY a utility job step that is currently command should be used to delete the failing job’s
active in REORG beyond the UNLOAD phase. utility id from SYSIBM.SYSUTIL.
System Programmer Response: If an MVS system
DSNU015I csect-name JOB WITH UTILID NOT abend was encountered (4 hexadecimal digits), refer to
FOUND IN SYSUTIL FOR RESTART the appropriate MVS publication. If an abend reason
Explanation: A utility job was submitted to restart a code was encountered (8 hexadecimal digits), look up
utility job that had previously failed. The the reason code in “Part 4. DB2 Codes” on page 707,
SYSIBM.SYSUTIL entry for the specified qualifier and if you suspect an error in DB2, refer to Part 2 of
provided was not found. DB2 Diagnosis Guide and Reference for information on
identifying and reporting the problem.
Severity: 8 (error)
Chapter 18. DB2 Messages 443
DSNU018I • DSNU030I
User Response: Resubmit the job with the
DSNU018I csect-name JOB IS NOT RESTARTABLE
RESTART(PHASE) parameter after the desired user
DUE TO -START ACCESS FORCE
action has been taken with the unload data set.
COMMAND
Problem Determination: Refer to DB2 Utility Guide
| Explanation: A utility job was submitted to restart a
and Reference for a description of the REORG utility
| utility job that previously failed. Although the
and the UNLOAD PAUSE option.
| SYSIBM.SYSUTIL entry for the specified qualifier was
| found, the job is not restartable because of a -START
| DATABASE ACCESS FORCE command. The -START DSNU024I csect-name PARM FIELD ERROR
| DATABASE ACCESS FORCE command deleted the parm-field
| utility-in-process state of one or more (but not all) target
| objects in the job. Explanation: An error was detected in the PARM field
on the EXEC statement. 'parm-field' was the input
System Action: The utility job is abended with reason parameter field.
code X'00E40018'.
Severity: 8 (error)
| User Response: If the specified qualifier is correct,
| use the -TERM UTILITY command to terminate the System Action: Utility processing is not initiated.
| utility and resubmit the job as a nonrestartable job. If User Response: Correct the indicated parameter on
| the -TERM UTILITY command fails, use the -START the EXEC DD statement, and resubmit the job.
| DATABASE ACCESS FORCE command to force ALL
| target objects (table spaces and indexes) in the job. Problem Determination: Refer to DB2 Utility Guide
| When the last object is forced, the SYSIBM.SYSUTIL and Reference for parameter requirements.
| record is deleted. If the qualifier is incorrect, correct it
| and restart the job. DSNU025I csect-name INVALID RESTART
PARAMETER (restart)
DSNU019I csect-name THIS UTILITY IS NOT Explanation: Only the following values may be
ALLOWED AT A DB2 TRACKER SITE specified for the restart parameter: NO or null,
Explanation: When a DB2 subsystem serves as a CURRENT, or PHASE.
tracker site, it cannot run utility csect-name. A DB2 Severity: 8 (error)
subsystem is also a tracker site if the value of
subsystem parameter TRKRSITE is YES. You may run System Action: The utility is not run by the stored
only the following utilities at a tracker site DB2: procedure.
v REPORT User Response: Correct and re-run.
v RECOVER without the TORBA, TOLOGPOINT, or
TOCOPY options DSNU028I csect-name UNABLE TO CONNECT TO
v DIAGNOSE DB2, REASON=Xreason code
Severity: 8 (error) Explanation: A connection to the DB2 subsystem
failed. 'reason-code' is the DB2 reason code that was
System Action: The utility terminates.
returned.
System Programmer Response: If this DB2
Severity: 8 (error)
subsystem does not need to serve as a remote site
tracker system, remove its tracker site status before System Action: The utility job is terminated.
re-trying the utility. You may remove the tracker site
status by stopping the DB2 subsystem, then restarting it User Response: Check the subsystem ID specified in
with TRKRSITE = NO. the EXEC DD statement. If it is correct, the subsystem
was not ready for processing. Ask the system
User Response: Contact the system programmer. programmer when the requested subsystem will again
be available for processing.
DSNU020I csect-name JOB STEP INCOMPLETE
Explanation: The REORG utility was invoked with the
| DSNU030I csect-name UNABLE TO ALLOCATE
UNLOAD PAUSE option. This causes the immediate
| dsn, RC=rr, CODE=ccc
suspension of the job after the unload phase completes. Explanation: The utility was unable to allocate a
Subsequent utilities that are invoked in the same job necessary image copy data set. dsn is the data set
step are not run. name that the utility attempted to dynamically allocate.
rr is the return code from the MVS dynamic allocation
Severity: 4 (warning)
service, and ccc is the reason code associated with the
System Action: Further utility processing is return code.
terminated.
444 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU031I • DSNU036I
System Action: The utility proceeds along one or the data set during the RELOAD phase, the job can be
following paths: restarted if an undamaged output data set is provided.
If the data set was an incremental image copy data set, Problem Determination: Refer to the appropriate
the utility proceeds as if it and any later incremental MVS publication for the format of the error message.
image copies did not exist.
If the data set was a full image copy data set, the utility DSNU034I DATA SET TYPE INVALID FOR
attempts to use the most recent prior full image copy DDNAME 'dddddddd'
data set.
Explanation: A required DD statement with
If the data set is used by the COPYTOCOPY utility, and DDNAME='dddddddd' was found to have a data set
the utility job step includes an OPTIONS control type which is not valid for this application.
statement with the EVENT(ITEMERROR,SKIP) option,
Severity: 8 (error)
COPYTOCOPY processes the next item in the list.
System Action: The utility is terminated with a return
The allocation failure may create other problems that
code 8.
will cause the utility to fail. This is indicated by other
messages. User Response: The data set must be capable of
storing intermediate data that can be retrieved by DB2.
User Response: If the job fails, contact the system
Check that the data set is not specified as type
programmer.
DUMMY, SYSIN, or SYSOUT. If you require assistance
System Programmer Response: If the utility fails in specifying a valid data set type, consult the system
because of the allocation error (as shown by a programmer.
subsequent message), correct the error, then resubmit
System Programmer Response: Correct the JCL and
the job.
resubmit the job.
Problem Determination: Refer to the appropriate
MVS publication for a complete description of the
DSNU035I csect-name UNABLE TO FIND DD
possible return and reason codes from dynamic
CARD FOR DDNAME, 'dddddddd'
allocation.
Explanation: A DD statement with ddname =
'dddddddd' was expected, but not found.
DSNU031I csect-name UNABLE TO UNALLOCATE
dsn, RC=rr, CODE=ccc Severity: 8 (error)
Explanation: The recover utility was unable to System Action: The utility is terminated with a return
unallocate an image copy data set. The data set name code 8.
that the utility attempted to unallocate is dsn. The return
code from the MVS dynamic unallocation service is rr. User Response: If the DDNAME is one you
The reason code associated with the return code is ccc. submitted, review and correct it. If the DDNAME was
not provided by you, but by the system, consult the
System Action: The unallocation error is ignored and system programmer.
the utility execution continues.
System Programmer Response: Correct the JCL and
Problem Determination: Refer to MVS/ESA resubmit the job.
Programming: Authorized Assembler Services Guide for
a complete description of the possible return and reason
codes from dynamic allocation. DSNU036I csect-name UNABLE TO OPEN DCB
FOR DDNAME dddddddd
DSNU032I I/O ERROR ON WORKFILE, xxxxxx Explanation: The DCB associated with DDNAME
'dddddddd' could not be opened.
Explanation: An I/O error was encountered on a
necessary OS/VS data set. 'xxxxxx' is a message that System Action: The utility job is abended with a
describes the error and the data set in error. This reason code of X'00E40070'. The utility job step is in
message is returned to the DB2 utility by SVC 68 the stopped state.
(SYNADAF) from BSAM. The data set may have been User Response: If the ddname is one you submitted,
needed for an unload data set, image copy data set, or review and correct it. If the ddname was not provided by
load or reorganization work file data set. The utility is you but by the system, consult the system programmer.
stopped at the beginning of the phase that used the
OS/VS data set. System Programmer Response: Correct the job
control language and resubmit the job.
System Action: The utility job is abended. The utility
job step is in the stopped state.
Operator Response: Except in the case of an unload
Chapter 18. DB2 Messages 445
DSNU037I • DSNU042I
DSNU037I csect-name - RECFM=U FOR DDNAME DSNU040I csect-name ERROR ACCESSING
dddddddd DDNAME ddname, DECB=Xhex string
Explanation: A data set to be used by the utility has Explanation: An error has occurred during BSAM
an undefined record format RECFM=U. All data sets access of a utility temporary file identified by 'ddname'.
must be fixed or variable, blocked or unblocked. The DECB indicating the error is given as a
hexadecimal string.
System Action: The utility job is abended with a
reason code of X'00E40070'. The utility job step is in System Action: The executing utility issues an X'04E'
the stopped state. abend with abend reason code '00E40071' following this
message.
Operator Response: Notify the system programmer.
User Response: Refer to the information given in the
System Programmer Response: Ensure that no data
Problem Determination section of this message. Correct
sets involved in the utility job have RECFM=U.
the problem. Either issue the -TERM command to
Resubmit the job after ending the stopped utility by the
terminate the utility job and resubmit it, or specify the
TERM UTILITY command, or do a RESTART(PHASE)
RESTART parameter and resubmit it.
of the stopped utility.
Operator Response: An operator with SYSOPR
authority can issue the -TERM UTILITY command to
DSNU038I csect-name BLOCK SIZE FOR DCB,
release the resources claimed by the stopped utility (this
DDNAME dddddddd, IS TOO SMALL,
may not be necessary).
MUST BE AT LEAST bbbbb BYTES
Problem Determination: The DECB provided contains
Explanation: The data set with DDNAME 'dddddddd'
the ECB in the first four bytes. The first byte of the ECB
has a block size that is too small to accommodate a
contains status bits that indicate the cause of the error.
record that needs to be written.
Refer to the appropriate MVS publication for the
System Action: The utility job is abended with a meaning of the status bits.
reason code of X'00E40079'. The utility job step is left in
the stopped state.
DSNU041I csect-name INVALID CONCATENATED
User Response: Delete the data set in error. Change DATA SET FOR DDNAME dddddddd
the JCL so that the block size for the data set with
Explanation: A non-input concatenated data set was
DDNAME 'dddddddd' is at least 'bbbbb' bytes. Resubmit
detected. Only input data sets can be concatenated.
the utility job with the RESTART(PHASE) option.
System Action: The utility job abended with reason
code X'00E40070'. The utility job step is in the stopped
DSNU039I csect-name - LRECL=0 FOR DDNAME
state.
dddddddd
Operator Response: Notify the system programmer.
Explanation: A data set to be used by the DB2 utility
has a record length of zero after OPEN. All data sets System Programmer Response: Remove the
with a record format of fixed or fixed blocked must have concatenated data sets from the data set with DDNAME
a valid record length greater than zero. ’dddddddd’. Resubmit the job after ending the stopped
utility with the TERM UTILITY command, or restart the
System Action: The utility job is abended with reason
utility at the beginning of the stopped phase by using
code X'00E40070'. The utility job step is left in the
RESTART(PHASE).
stopped state.
User Response: If the DDNAME is for a data set that
DSNU042I csect-name SORT PHASE STATISTICS.
you submitted, review and correct it. It might be
NUMBER OF RECORDS=n ELAPSED
necessary to provide a valid LRECL in the DCB
TIME=hh/mm/ss
parameter in the JCL. If the DDNAME was not provided
by you but by the system, consult the system Explanation: This message provides statistics on the
programmer. SORT phase of a utility. The number of records sorted,
'n', and the duration of the SORT phase in hours,
Operator Response: Notify the user or system
minutes, and seconds are provided.
programmer.
Severity: 0 (informational)
System Programmer Response: Correct the data set
definition, or add DCB information to the JCL. Do a System Action: The system continues to process
RESTART(PHASE) of the stopped utility, or resubmit the normally.
job after issuing a -TERM UTILITY command for the
stopped utility.
446 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU044I • DSNU051I
Operator Response: Notify the system programmer.
DSNU044I csect-name ERROR FROM SORT
COMPONENT RC=n, UTILITY STOPPED System Programmer Response: Correct the JCL to
include the indicated DD statement or add a
Explanation: A nonzero return code 'n' was returned
TEMPLATE control statement. Refer to DB2 Utility
from an MVS sort. Error messages from sort are printed
Guide and Reference for information about required DD
on the UTPRINT data set.
statements.
System Action: The executing utility job is placed in
the stopped state.
DSNU048I csect-name INVALID OPERAND FOR
User Response: Determine the cause of the error. If KEYWORD kkkkkkkk
the error can be corrected, the utility may be restarted
Explanation: The utility parser has determined that
from the beginning of the sort phase by using the
the operand specified for keyword 'kkkkkkkk' is invalid.
RESTART(PHASE) option. If the error is such that the
utility cannot complete, the -TERM command should be Severity: 8 (error)
issued to remove the stopped utility from the system.
The -TERM utility option should rarely be exercised System Action: Utility processing is not initiated.
when the stopped utility is REORG. User Response: Correct the operand in error, and
Operator Response: An operator with SYSOPR resubmit the utility job. Refer to DB2 Utility Guide and
authority can issue the -TERM UTILITY command to Reference for correct operand definitions.
release the resources claimed by the stopped utility (this
may not be necessary). DSNU049I csect-name - INVALID OPERAND
Problem Determination: This abend is accompanied oooooooo FOR KEYWORD kkkkkkkk
by abend reason code X'00E40005', and an SVC dump Explanation: The utility parser has determined that
is requested. In most cases, error messages from MVS operand 'oooooooo' cannot be specified for keyword
sort identify the problem and the dump is not needed. If 'kkkkkkkk'. This includes a negative value following the
sort is unable to open the UTPRINT data set, only the keywords MAXRO or DELAY.
message and the abend are provided. For example, if
the UTPRINT DD statement is omitted, correct the Severity: 8 (error)
problem with UTPRINT, and resubmit the job. System Action: Utility processing is not initiated.
User Response: Correct the operand in error, and
DSNU046I csect-name UTILITY STATEMENT IS resubmit the utility job. Refer to DB2 Utility Guide and
TOO LONG OR TOO COMPLEX Reference for proper option specifications.
Explanation: The utility command and associated
control statements have caused internal fields to exceed DSNU050I csect-name utility-statement
DB2 subsystem limits.
Explanation: This message echoes the utility
Severity: 8 (error) statement that was input from SYSIN.
System Action: Utility processing is not initiated. Severity: 0 (informational)
User Response: Reduce the size or complexity of the System Action: Utility processing continues.
utility statement where possible. For example, a LOAD
into several tables may be broken up into a separate
load statement for each table or the size of comparison DSNU051I csect-name INSUFFICIENT OPERANDS
fields for 'when', 'continueif', and 'nullif' operands may FOR KEYWORD kkkkkkkk
be reduced in size. Explanation: An operand that is required when the
Problem Determination: Refer to DB2 Utility Guide keyword 'kkkkkkkk' is specified was omitted.
and Reference for correct operand definitions. Severity: 8 (error)
System Action: Utility processing is not initiated.
| DSNU047I csect-name A REQUIRED DD CARD OR
| TEMPLATE IS MISSING User Response: Correct the operand specification,
| NAME=missing-dd and resubmit the job. Refer to DB2 Utility Guide and
Reference to determine the correct set of operands for
Explanation: The DB2 utility being executed requires 'kkkkkkkk'.
| a data set to continue processing. The DDNAME or
| TEMPLATE name for the missing data set is provided.
Severity: 8 (error)
System Action: Utility processing terminates.
Chapter 18. DB2 Messages 447
DSNU052I • DSNU058I
DSNU052I csect-name KEYWORD kkk DSNU056I csect-name TABLE tttttttt NOT FOUND
INCOMPATIBLE WITH OTHER
Explanation: A utility specified a table name 'tttttttt',
KEYWORDS OR OPERANDS
but the table does not exist.
Explanation: The specified keyword 'kkk' cannot be
Severity: 8 (error)
used with other keywords or operands.
System Action: The error is sufficient to terminate
Severity: 8 (error)
further processing of the utility job step. The utility job
System Action: Processing terminates. step is terminated, and resources are released to their
prior state.
User Response: Refer to the DB2 Utility Guide and
Reference for the right syntax for the specified keyword. User Response: Correct the table name and/or
database name, and resubmit the utility job step.
DSNU053I csect-name FIELD cccccccc NOT Problem Determination: The correct table names can
FOUND be found by querying the SYSIBM.SYSTABLES catalog
table.
Explanation: Either the column name specified,
'cccccccc', was not found in the catalog as a valid
column name for the table being processed, or a WHEN DSNU057I csect-name DATABASE database-name
keyword field name was not found in the field name list. NOT FOUND
Severity: 8 (error) Explanation: The operand of the DATABASE
keyword, 'database-name', did not specify an existing
System Action: Utility processing is not initiated.
database name.
User Response: Correct the LOAD utility statement,
Severity: 8
and resubmit the job.
System Action: The error is sufficient to terminate
Problem Determination: Valid column names can be
further processing of the utility job step. The utility job
found in the SYSIBM.SYSCOLUMNS table.
step is terminated, and resources are released to their
prior state.
DSNU054I csect-name TABLESPACE ssssssss NOT
User Response: Correct the database name and
FOUND
resubmit the utility job step.
Explanation: The operand of the TABLESPACE
Problem Determination: The correct database names
keyword, 'ssssssss', did not specify an existing table
can be found by querying the SYSIBM.SYSDATABASE
space name.
catalog table.
Severity: 8 (error)
System Action: Utility processing is not initiated. | DSNU058I csect-name utility-name UTILITY NOT
| ALLOWED AGAINST AN OBJECT IN
User Response: Correct the table space name and/or | RECOVER PENDING STATE
database name, and resubmit the job.
Explanation: An attempt has been made to execute a
Problem Determination: Valid table space names can utility against an object that is in RECOVER PENDING
be found in the SYSIBM.SYSTABLESPACE catalog STATE. CHECK, COPY, MODIFY, LOAD, QUIESCE,
table. REORG, and RUNSTAT are not allowed.
Severity: 8 (error)
DSNU055I csect-name INDEX iiiiiiii NOT FOUND
System Action: Utility processing is not initiated.
Explanation: The index name specified, 'iiiiiiii', was
invalid. User Response: Remove the object from the
RECOVERY PENDING STATE by using either LOAD
Severity: 8 (error) REPLACE, RECOVER, or REPAIR against the object.
System Action: Utility processing is not initiated. Resubmit the job.
User Response: Correct the index name, and System Programmer Response: Determine which of
resubmit the job. the three utilities, LOAD REPLACE, RECOVER, or
REPAIR, should be used to remove the object from the
Problem Determination: Valid index names can be RECOVER PENDING STATE.
found in the SYSIBM.SYSINDEXES catalog table.
448 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU059I • DSNU064I
terminated by the submitter of the job or by a
DSNU059I csect-name utility-name UTILITY NOT
holder of SYSOPR, SYSCTRL, or SYSADM
ALLOWED TO RUN ON A ROSHARE
authority.
READ DATABASE
Explanation: An attempt was made to execute a utility Any user can issue a -DISPLAY UTILITY command.
on a ROSHARE READ database. Only the RUNSTATS,
DIAGNOSE, and REPAIR DBD utilities are allowed to System Action: The -TERM UTILITY request for utility
run on read-only shared databases. identifier utilid is rejected.
Severity: 8 (error) User Response: Take the appropriate action:
v Wait to allow the utility to identify the databases it will
System Action: Utility processing is not initiated. access; then reissue the command.
User Response: Resubmit the utility job on the v Obtain the required authorization and reissue the
owning system, if necessary. command.
v Have another user with proper authorization issue the
DSNU060I csect-name USER userid NOT command.
AUTHORIZED FOR util-name UTILITY
ON DATABASE dbase-name DSNU062I csect-name util-name UTILITY MAY NOT
Explanation: User 'authorization ID' attempted to BE RUN ON OBJECT
execute utility 'util-name' against an object in database qualifier.object-name
'dbase-name'. The user was either not authorized to Explanation: An attempt was made to execute utility
execute utilities for the named database, or the user’s 'util-name' against object 'qualifier.object-name'. This is
authorization did not include this utility. not allowed. The named object cannot be processed by
Severity: 12 (error) the named DB2 utility.
System Action: Utility processing is not initiated. Severity: 8 (error)
User Response: Ensure that the correct database System Action: The utility job is terminated.
was specified. If the specification is correct, consult the User Response: Remove the invalid utility control
system programmer concerning authorization. statements and resubmit the job.
System Programmer Response: Determine why the
user was denied access. Either the authorization should DSNU063I csect-name utility-name UTILITY NOT
be corrected, or another authorized user should invoke ALLOWED AGAINST AN OBJECT IN
the utility. REBUILD PENDING STATE
Problem Determination: The following catalog tables Explanation: An attempt has been made to execute a
can be examined to determine who has proper utility against an object that is in REBUILD PENDING
authority: SYSIBM.SYSUSERAUTH, STATE. CHECK, COPY, MODIFY, LOAD, QUIESCE,
SYSIBM.SYSDBAUTH, or SYSIBM.SYSRESAUTH. REORG, and RUNSTAT are not allowed.
Severity: 8 (error)
DSNU061I csect-name USER userid NOT
AUTHORIZED, UTILID=utilid System Action: Utility processing is not initiated.
Explanation: The named user issued a utility User Response: Remove the object from the
command and was not authorized to do so. REBUILD PENDING STATE by using either LOAD
REPLACE, RECOVER, or REPAIR against the object.
The -TERM UTILITY command can only be issued by: Resubmit the job.
v The submitter of the utility job.
System Programmer Response: Rebuild the index
v Users with SYSOPR, SYSADM, or SYSCTRL with the REBUILD utility to remove the object from
authority. REBUILD PENDING state.
v Users with DBADM, DBCTRL, or DBMAINT authority
over every database used by the utility.
DSNU064I csect-name UTILITY NOT ALLOWED
Even for users with sufficient database authority, the AGAINST SYSTEM DATABASE
TERM UTILITY command will fail in these situations:
– The user issued the command before the utility Explanation: An attempt was made to execute a utility
determined what databases it would access. against database DSNDB01 or DSNDB06. The following
utilities are not allowed against DSNDB01:
– The utility job included the DIAGNOSE, REPORT, LOAD
or STOSPACE utility. Those utilities must be REORG TABLESPACE against SYSUTILX (allowed
against other DSNDB01 table spaces)
Chapter 18. DB2 Messages 449
DSNU065I • DSNU073I
CHECK DATA table space reported by the message may not be
REPAIR DBD explicitly named in the utility statement.
RUNSTATS
System Action: The utility processing proceeds.
MODIFY STATISTICS
The following utilities are not allowed against DSNDB06: DSNU069I csect-name - AUXILIARY TABLE
LOAD (except SYSIBM.SYSSTRINGS) table-name NOT PERMITTED AS
CHECK DATA EXCEPTION TABLE
REPAIR DBD
Explanation: A auxiliary table was specified as an
Severity: 8 (error) exception table.
System Action: Execution of the utility job is stopped. System Action: Utility returns completion code=8.
User Response: Remove the invalid utility control Programmer Response: Specify an exception table
statements and resubmit the job. that is not an auxiliary table.
DSNU065I csect-name UTILITY NOT ALLOWED DSNU070I csect-name KEYWORD OR OPERAND x
AGAINST A WORK FILE INVALID WITH y
Explanation: An attempt has been made to execute a Explanation: The use of KEYWORD or OPERAND 'x'
utility against database DSNDB07. Utilities are not is inconsistent with KEYWORD or OPERAND 'y'.
allowed against work files.
Severity: 8 (error)
Severity: 8 (error)
System Action: The control statement in error is
System Action: Execution of the utility job is stopped. rejected and processing is halted.
User Response: Remove the invalid utility control User Response: Correct the control statement in error
statement(s) and resubmit the job. and resubmit the job.
DSNU066I csect-name OPERAND oooooo NOT DSNU071I csect-name KEYWORD x REQUIRES
ALLOWED FOR uuuuuu UTILITY KEYWORD y
against tttttt TABLE
Explanation: When keyword 'x' is specified, keyword
Explanation: An attempt was made to specify the 'y' must also be specified.
REPLACE option when executing the LOAD utility on a
Severity: 8 (error)
DB2 catalog table. It is not permissible to replace
existing rows in a DB2 catalog table. Rows can only be System Action: The control statement in error is
added to the existing rows in a DB2 catalog table. rejected and processing is halted.
Severity: 8 (error) User Response: Correct the control statement in
error, and resubmit the job.
System Action: Utility processing is not initiated.
User Response: Correct the operand, and resubmit
DSNU072I csect-name INVALID KEYWORD(S)
the job.
SPECIFIED FOR TABLESPACE LIST
Explanation: The specified keyword cannot be
DSNU067I csect-name - TABLE SPACE
included in a list of table spaces.
table-space-name IS NOT A LOB TABLE
SPACE Severity: 8 (error)
Explanation: The table space specified, System Action: Processing terminates.
table-space-name, is not a LOB table space. The object
of the utility must be LOB table space. User Response: Remove the specified keyword from
the list of table spaces.
System Action: Utility returns completion code=8.
Programmer Response: Correct the utility statement. DSNU073I csect-name - KEYWORD 'wwwww'
IGNORED
DSNU068I csect-name - function IS NOT Explanation: The keyword, 'wwwww' is no longer
SUPPORTED FOR LOB TABLE supported.
SPACES
Severity: 0 (informational)
Explanation: The function specified, function, is not
supported for the LOB table space specified. The LOB System Action: Utility processing proceeds.
450 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU074I • DSNU080I
Problem Determination: Refer to DB2 Utility Guide
DSNU078I csect-name INVALID DBCS IDENTIFIER
and Reference for the current syntax.
iiii
Explanation: The DBCS identifier iiii is invalid. Reason
DSNU074I csect-name - utility UTILITY NOT
codes are:
SUPPORTED FOR LOB TABLE SPACE:
table-space-name 101 An odd number of bytes exists between the
shift-out and the shift-in
Explanation: The utility statement failed because the
table space specified was a LOB space and the utility 102 No shift-in was found at the end of the
does not support LOB table spaces. identifier
System Action: The statement cannot be executed. 103 DBCS blanks X’4040’ are not allowed
Programmer Response: Correct the utility statement. 104 There are no characters between the shift-out
and the shift-in
| DSNU075I csect-name - TABLE table_name, LOB 105 Shift-out can not be the first byte of the DBCS
| COLUMN column-name - DEFINITION IS character between the shift-out and the shift-in.
| NOT COMPLETE
Severity: 8 (error)
Explanation: The definition of the LOB column,
System Action: Processing is terminated.
column-name in table table_name is not complete.
User Response: Correct the DBCS identifier and
System Action: Utility returns completion code=8.
resubmit the job.
Programmer Response: Complete the LOB column
Problem Determination: Refer to Chapter 2 of DB2
definitions. A LOB column definition is not complete until
SQL Reference to determine the correct syntax for
the LOB table space, auxiliary table and index on the
DBCS identifiers.
auxiliary table have been created for the LOB column.
DSNU079I csect-name UNBALANCED PARENS IN
DSNU076I csect-name - KEYWORD=keyword
CONTROL STATEMENT
INVALID FOR type TABLE
SPACE=table_space_name Explanation: The utility parser has determined that
there is an unbalanced parenthesis in the input string.
Explanation: The keyword, keyword, is invalid when
the object of the utility is a type table space. Severity: 8 (error)
System Action: Utility returns completion code=8. System Action: Utility processing is not initiated.
Programmer Response: Correct the utility statement. User Response: Determine the location of the missing
parenthesis and insert it. The utility job can then be
resubmitted.
DSNU077I csect-name - utility IS PROHIBITED
BECAUSE object IS pending-state Problem Determination: Refer to DB2 Utility Guide
and Reference to determine the correct syntax for
Explanation: The utility specified is prohibited
option specification.
because the object is in a pending-state.
Severity: 8 (error)
DSNU080I csect-name NO UTILITY STATEMENTS
System Action: Utility terminates and returns FOUND IN dd-name
completion code=8.
Explanation: The data set identified by dd-name did
Programmer Response: not contain any text. The system might have processed
v Run the CHECK LOB utility if the object is a LOB the end of file prematurely, or this job requires that the
table space and the state is CHECK PENDING. utility statements be skipped.
v Run the REBUILD INDEX utility if the object is an Severity: 4 (warning)
auxiliary index and the state is REBUILD PENDING.
System Action: Processing continues.
v Run the CHECK INDEX utility if the object is an
auxiliary index and the state is CHECK PENDING. User Response: If the data set is SYSIN, provide at
least one utility statement, if none now exists, or verify
that this job executes no utility statements. If the data
set is the LISTDEF (SYSLISTD) or TEMPLATE
(SYSTEMPL) data set, provide the required control
statements in that data set or in SYSIN.
Chapter 18. DB2 Messages 451
DSNU081I • DSNU086I
DSNU081I csect-name OPERAND 'ooooooo' DSNU085I csect-name INVALID SPECIAL
EXCEEDS KEYWORD 'kkkkkkkk' CHARACTER OPERAND ssss
MAXIMUM LENGTH
Explanation: The utility parser has determined that
Explanation: The utility parser has determined that the operand 'ssss' is invalid as a special character
operand 'oooooooo' exceeds the maximum length for operand. For a special character operand to be invalid,
keyword 'kkkkkkkk'. it must have either a shift-out or a shift-in character and
be missing the corresponding shift character, or not
Severity: 8 (error)
have an even number of characters between the
System Action: Utility processing is not initiated. shift-out, shift-in characters.
User Response: Correct the operand, and resubmit Severity: 8 (error)
the job.
System Action: Processing is terminated.
Problem Determination: Refer to DB2 Utility Guide
User Response: Correct the utility statement, and
and Reference to determine the correct operand
resubmit the job.
specification.
DSNU086I csect-name ttttt I/O ERRORS ON
DSNU082I csect-name INVALID KEYWORD
SPACE= dddddddd. DATA SET
kkkkkkkk
NUMBER= nnn. I/O ERROR PAGE
Explanation: The given keyword was not recognized RANGE= aaaaaa, bbbbbb.
within the context of this control statement.
Explanation: DB2 detected an error. This message is
Severity: 8 (error) issued for, but not limited to the following reasons:
System Action: Utility processing is not initiated. v I/O errors were detected on the named object. ttttt is
either 'READ' or 'WRITE'. nnn; is the data set
User Response: Correct the keyword, and resubmit number. aaaaaa is the first damaged page and
the job. bbbbbb is the last damaged page of the data set.
v A broken page was detected.
DSNU083I csect-name INVALID HEXADECIMAL v A page parity error was detected for a 'must
OPERAND hhhhhhhh complete' agent.
Explanation: The utility parser has determined that v A read or write I/O error was detected. A LPL
the operand 'hhhhhhhh' is invalid as a hexadecimal recovery might be in progress so the page is added
operand. It either contains a character that is not to the WEPR instead of the LPL.
hexadecimal or has an odd number of characters. Severity: 0 (informational)
Severity: 8 (error) System Action: Processing continues, but the pages
System Action: Utility processing is not initiated. within the error range are no longer accessible.
User Response: Correct the keyword, and resubmit System Programmer Response: Determine the
the job. appropriate level of recovery, and invoke the recovery
utility. If user-defined data sets are being used and full
data set or table space RECOVER is to be used, then,
DSNU084I csect-name INVALID GRAPHIC prior to invoking the RECOVER utility, the table space
OPERAND gggg must be stopped, new data set(s) defined, and the table
Explanation: The utility parser has determined that space restarted. If the data set is part of a ROSHARE
the operand 'gggg' is invalid as a hexadecimal operand. READ database, determine whether it was a link or
The graphic operand is either missing one or both of the DASD failure. It there was a link failure, then fix the link,
shift characters or is not an even number of characters. and issue a -START DATABASE with the
ACCESS(FORCE) parameter. If the error was caused
Severity: 8 (error) by a DASD failure, then correct the problem from the
System Action: Processing is terminated. system on which the database was defined as
ROSHARE OWNER.
User Response: Correct the utility statement, and
resubmit the job. Problem Determination: Refer to Part 4 (Volume 1) of
DB2 Administration Guide for a discussion of database
recovery procedures.
There may be an IOS message on the MVS console
SYSLOG indicating the type of I/O error that occurred. If
an IOS message was issued, follow the Problem
Determination directions for the message.
452 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU087I • DSNU095I
to Part 2 of DB2 Diagnosis Guide and Reference for
DSNU087I csect-name INVALID OPERAND TYPE
information on identifying and reporting the problem.
FOR KEYWORD kkkkkkkk - oooooooo
Explanation: The utility parser has determined that
DSNU091I csect-name DDNAME nnn IS A
the operand 'oooooooo' is the wrong type for the
DUPLICATE
keyword 'kkkkkkkk'. An example of such an error would
be a decimal operand where only a hexadecimal Explanation: The DDNAME 'nnn' was used as
operand is allowed. operand in the input statement more than once.
Severity: 8 (error) Severity: 8 (error)
System Action: Utility processing is not initiated. System Action: Processing terminates.
User Response: Correct the keyword, and resubmit User Response: Change the ddname to a different
the job. one.
Problem Determination: Refer to DB2 Utility Guide
and Reference to determine valid operand types for the DSNU092I csect-name NUMBER OF OPERANDS
designated keyword. FOR KEYWORD kkk EXCEEDS
MAXIMUM
DSNU088I csect-name INVALID CHARACTER Explanation: The keyword 'kkk' contains more than
OPERAND cccccccc the maximum number of operands.
Explanation: The utility parser has determined that Severity: 8 (error)
the operand 'cccccccc' is invalid as a character
operand. System Action: Processing terminates.
Severity: 8 (error) User Response: Refer to DB2 Utility Guide and
Reference for the limit on the number of operands for
System Action: Utility processing is not initiated. the specified keyword.
User Response: Correct the keyword, and resubmit
the job. DSNU094I csect-name KEYWORD 'wwwww' IS
DUPLICATED
Problem Determination: Refer to DB2 Utility Guide
and Reference for correct specification of the character Explanation: The keyword 'wwwww' is not allowed
operand. twice.
Severity: 8
DSNU089I csect-name OPERAND oooooooo IS
TOO LONG System Action: The control statement in error is
rejected and the processing is halted.
Explanation: The utility parser has determined that
the operand 'oooooooo' is too long for the keyword User Response: Correct the control statement in
specified. error, and resubmit the job.
Severity: 8 (error)
DSNU095I csect-name UTILITY uuuuuuuu
System Action: Utility processing is not initiated. INCONSISTENT WITH LAST
INVOCATION
User Response: Correct the keyword, and resubmit
the job. Explanation: This message can occur when a utility
job step is restarted and a utility statement was
Problem Determination: Refer to DB2 Utility Guide
modified, added or deleted from SYSIN.
and Reference for correct operand length specification.
Severity: 8 (error)
| DSNU090I csect-name DD OR TEMPLATE NAME System Action: Utility processing is terminated. The
| nnn IS INVALID FOR KEYWORD kkk utility job step remains in SYSIBM.SYSUTIL in the
stopped state.
Explanation: The DDNAME or TEMPLATE nnn was
used as an improper input of the specified keyword kkk User Response: Restart the utility job with the
or from one of the reserved ddnames: SYSIN, statements in the same order as they were in when the
SYSPRINT, UTPRINT, SORTWKnn, SORTLIB. job was first run. If a statement was modified, change
the statement back to the format in the original
Severity: 8 (error)
invocation and restart the job. Utility statements should
System Action: Processing terminates. not be altered for restart.
User Response: If you suspect an error in DB2, refer
Chapter 18. DB2 Messages 453
DSNU096I • DSNU100I
UTIL, or -START DATABASE ACCESS(FORCE)
DSNU096I csect-name OPERAND oooooooo
command, then the command can be reissued.
INCONSISTENT WITH LAST
INVOCATION System Programmer Response: Determine the
cause of the IRLM error and take appropriate action.
Explanation: When the utility job step was restarted,
the indicated operand was found to be inconsistent with Problem Determination: Obtain the system console
the restart point. log output, dump, and SYS1.LOGREC information. If
you suspect an error in DB2, refer to Part 2 of DB2
System Action: The restart of utility processing is not
Diagnosis Guide and Reference for information on
initiated.
identifying and reporting the problem.
User Response: To restart, restore the operand to its
prior definition. If this is not acceptable, terminate the
DSNU100I csect-name USERID = userid MEMBER =
utility job step, take corrective action, and resubmit the
member-name UTILID = utilid
job.
| PROCESSING UTILITY STATEMENT
Operator Response: An operator with SYSOPR | statement-number UTILITY = utility-name
authority can terminate the utility job step (this may not | PHASE = utility-phase COUNT =
be necessary). A REORG utility that is beyond the | object-count NUMBER OF OBJECTS IN
UNLOAD phase should rarely be terminated. | LIST = list-size LAST OBJECT
| STARTED = last-started STATUS =
Problem Determination: Refer to DB2 Utility Guide
| STOPPED
and Reference for operand definitions. Refer to Part 4
(Volume 1) of DB2 Administration Guide for a Explanation: This message is issued in response to a
discussion of utility restart constraints. DISPLAY UTILITY command. The utility job with
identifier utilid stopped during processing. The utility
stopped for one of these reasons:
DSNU097I csect-name - input WILL BE REQUIRED
SYNTAX IN FUTURE RELEASES v The REORG utility stopped in response to its
UNLOAD(PAUSE) option. The utility is stopped in the
Explanation: The identified 'input' is not required in RELOAD phase.
this release, but it will be part of the required syntax in
v The utility is stopped because of a DB2 subsystem
future releases.
failure or cancellation (for example, a STOP DB2
Severity: 4 (warning) command).
System Action: Utility processing continues.
In a data sharing environment, member-name identifies
Programmer Response: Refer to DB2 Utility Guide the DB2 member. In a non data-sharing environment,
and Reference for the current syntax. member-name is blank. At the time of the request,
object-count records or pages were processed.
DSNU099I csect-name - IRLM 'req-type' REQUEST
If the utility job step is restarted with the
FAILED, IRLM RETURN CODE =
RESTART(PHASE) option, it begins with PHASE
X'return-code' IRLM REASON CODE =
utility-phase. However, not all utilities have phases.
X'reason-code'
Those that do have phases restart from the beginning of
Explanation: The request to the IRLM to obtain or that phase.
release a lock failed for the reasons specified in
return-code and reason-code. In a non data-sharing COUNT indicates the number of pages or records
environment, the requested lock is the utility processed in a utility phase. COUNT has different
serialization lock. In a data sharing environment, the meanings for different utilities. For utilities not
requested lock is the utility serialization lock, the utility mentioned below, ignore this field.
identifier lock, or the utility execution lock. The IRLM v For CHECK INDEX, LOAD, REBUILD INDEX, and
return and reason codes are documented in “Part 5. REORG: number of records processed (log records
IRLM Messages and Codes” on page 1235. The type of for the LOG phase of REORG), or 0 (for the SWITCH
request is indicated by req-type. or BUILD2 phase of REORG).
System Action: Utility and command processing v For COPY, MERGECOPY, RECOVER (restore
terminates. phase), and RUNSTATS: number of pages
processed.
User Response: Refer to the IRLM messages and
codes section for problem determination and the v For STOSPACE: number of table spaces or indexes
appropriate action. Restart the utility by specifying the processed.
RESTART parameter, or terminate the utility with the | If the utility is processing a list of objects, list-size gives
-TERM command and then resubmit the job. If this | the total number of objects in the list and last-started
message was received during the -DIS UTIL, -TERM | gives the item number of the last object for which
454 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU103I • DSNU105I
| processing was started. These values may not be DSNDB01.SYSUTILX. If you suspect an error in DB2,
| accurate in the UTILINIT before the list size has been refer to Part 2 of DB2 Diagnosis Guide and Reference
| determined. for information on identifying and reporting the problem.
Severity: 0 (informational)
DSNU105I csect-name - USERID=userid
System Action: DB2 waits for directions to either
MEMBER=member-name UTILID=utilid
restart or terminate the utility.
PROCESSING UTILITY STATEMENT n
User Response: If you have the required authority, UTILITY=utility-name
restart or terminate the utility job step. PHASE=phase-name COUNT=n
| NUMBER OF OBJECTS IN LIST=list-size
To restart the job step, you must have authority to run | LAST OBJECT STARTED=last-started
the indicated utility and to complete any other utility STATUS=ACTIVE
functions in the utility job step.
Explanation: This message is issued in response to a
To terminate the utility with the -TERM UTILITY DISPLAY UTILITY command.
command, you must be the originator or have SYSOPR
or SYSADM authority. It is also issued by the REORG utility if the user
specified SHRLEVEL REFERENCE or CHANGE and
Operator Response: If necessary, and if you have DB2 estimates that the switch phase will not start by the
SYSOPR authority, you can issue the -TERM UTILITY deadline specified by the DEADLINE phrase.
command to release the resources claimed by the
stopped utility. This message gives the user an estimate of how much
processing the utility completed. The utility-name utility
in the utility job step identified by utilid was executing in
DSNU103I csect-name - UNABLE TO ACCESS phase utility-phase at the time the -DISPLAY UTILITY
SYSUTIL TABLE AT THIS TIME request was made. In a data sharing environment,
Explanation: An -ALTER UTILITY, -DISPLAY UTILITY, member-name identifies the DB2 member. In a
or -TERM UTILITY command was issued at the same non-data-sharing environment, member-name is blank.
time that the DSNDB01.SYSUTILX table space was the COUNT n is the number of pages or records processed
object of an active utility job. The utility job might be in a utility phase. COUNT has different meanings for
holding locks that would cause a deadlock condition to different utilities. For utilities not mentioned below,
occur. ignore this field.
Severity: 8 (error) v For CHECK INDEX, LOAD, REBUILD INDEX, and
REORG: number of records processed (log records
System Action: The command processing is
for the LOG phase of REORG), or 0 (for the SWITCH
terminated.
or BUILD2 phase of REORG).
User Response: Enter the command again. This v For COPY, MERGECOPY, RECOVER(restore
message is issued in response to each command until phase), and RUNSTATS: number of pages processed
the utility action on the DSNDB01.SYSUTILX table
v For STOSPACE: number of table spaces or indexes
space completes.
processed.
DSNU104I csect-name - DSNDB01.SYSUTILX IN A
| If the utility is processing a list of objects, list-size gives
PENDING STATE PROHIBITS FURTHER
| the total number of objects in the list and last-started
PROCESSING
| gives the item number of the last object on which
| processing was started. These values may not be
Explanation: The -ALTER UTILITY, -TERM UTILITY, | accurate in the UTILINIT before the list size has been
or -DISPLAY UTILITY command was issued when the | determined.
DSNDB01.SYSUTILX table space was in a pending
Severity: 0 (informational)
state, which prohibits further processing. The pending
state was either copy or recovery pending. System Action: The message reflects the state of
DB2 at the time of the -DISPLAY UTILITY command or
Severity: 0 (informational)
the time when DB2 estimated that the switch phase in
System Action: Command processing is terminated. the REORG utility with SHRLEVEL REFERENCE or
CHANGE would not start by the deadline specified by
User Response: Notify the system programmer so
the DEADLINE phrase.
that the pending condition can be resolved.
If this message was issued for -DISPLAY UTILITY, the
System Programmer Response: Issue a -DISPLAY
system continues processing. A subsequent -DISPLAY
DATABASE command to determine the state of the
UTILITY command reflects that processing.
DSNDB01.SYSUTILX table space. If the state is copy
pending, do a full image copy. If the state is recovery
pending, use the RECOVER utility to recover
Chapter 18. DB2 Messages 455
DSNU106I • DSNU112I
Activeutility jobs can be terminated or altered only from
DSNU106I csect-name utility-name UTILITY,
the system on which they were running.
MEMBER = member-name UTILID =
utilid TERMINATING Severity: 8 (error)
Explanation: This message is issued in response to a System Action: If this message was issued for the
DISPLAY UTILITY command. The utility-name utility in -TERM UTILITY command, the command ignores the
the utility job step identified by utilid was in the process utilid and continues to process the next utilid, if any. If
of terminating at the time the DISPLAY UTILITY request this message was issued for the -ALTER UTILITY
was issued. The utility is terminating in response to a command, the command is rejected, and further
previous TERM UTILITY request. processing of the command is ended.
In a data sharing environment, member-name identifies User Response: Make sure the utilid identifies the
the DB2 member. In a non data-sharing environment, utility you want to terminate or alter. If it does, issue the
member-name is blank. command from the DB2 member identified in the
message.
Severity: 0 (informational)
System Action: The system is stopping the utility and
DSNU110I csect-name UTILID = uuuu INVALID
releasing all resources associated with the utility. After
the utility terminates, DB2 can reuse the utility identifier. Explanation: This message is issued in response to
an invalid specification of a UTILID on an -ALTER
UTILITY, -DISPLAY UTILITY, or -TERM UTILITY
DSNU107I csect-name MEMBER NAME
command.A UTILID is a 1- to 16-byte alphanumeric
member-name IS NOT A MEMBER OF
token that can contain any number of periods.
THIS DATA SHARING GROUP.
Severity: 8 (error)
Explanation: This message is issued by the DISPLAY
UTILITY command when an invalid member-name is System Action: The -ALTER UTILITY, -DISPLAY
encountered in the member list. UTILITY, or -TERM UTILITY command is rejected.
Further processing of the command is ended.
Severity: 4
User Response: Review the UTILID provided in the
System Action: The DISPLAY UTILITY command
message to determine why it does not conform to the
ignores the invalid member-name and continues to
syntax rules of a utility identifier token, and reissue the
process the next member name specified.
request.
User Response: Correct the member name and
reissue the command.
DSNU111I csect-name - SUBPHASE=subphase-
name COUNT=n
DSNU108I csect-name DATA SHARING
Explanation: This message is issued in response to a
ENVIRONMENT IS NOT ACTIVE,
-DISPLAY UTILITY command. It immediately follows a
MEMBER KEYWORD NOT
prior DSNU105I message if the utility is using subtasks
APPLICABLE.
to perform processing in parallel. There will be one of
Explanation: This message is issued by the DISPLAY these messages for each subtask.
UTILITY command when the MEMBER keyword is
This message gives the user an estimate of how much
specified, but data sharing is not active.
processing the utility subtask has completed.
Severity: 4
SUBPHASE subphase-name identifies the activity that
System Action: The DISPLAY UTILITY command the subtask was performing at the time the -DISPLAY
ignores the MEMBER keyword and its associated UTILITY command was issued.
parameters, but continues processing.
COUNT n is the number of records processed by the
User Response: Make sure data sharing is active utility subtask.
before issuing the DISPLAY UTILITY command with the
Severity: 0 (informational)
MEMBER keyword.
System Action: The system continues processing.
| DSNU109I csect-name UTILITY utilid CAN ONLY BE
| TERMINATED OR ALTERED BY DSNU112I csect-name - NO AUTHORIZED UTILITY
| MEMBER = member-name FOUND FOR UTILID = utilid
Explanation: The -TERM UTILITY or -ALTER UTILITY Explanation: This message is issued in response to
command cannot terminate or alter the utility job with an -ALTER UTILITY, -DISPLAY UTILITY, or -TERM
identifier utilid, because it belongs to member UTILITY command. DB2 has no record of the utility job
member-name of the DB2 data sharing group. identified by the utility identifier utilid. The utilid might
456 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU114I • DSNU164I
not be correct, or the utility might have already
DSNU160I csect-name - utility-name UTILITY,
terminated.
UTILID = utilid REQUESTED TO
Severity: 4 (warning) TERMINATE, PHASE = utility-phase
WAS ACTIVE
System Action: The system rejects the -ALTER
UTILITY, -DISPLAY UTILITY, or -TERM UTILITY request Explanation: This message is issued in response to a
for the indicated utility job. -TERM UTILITY command. It acknowledges that the
request for termination was received and verified. At the
User Response: Verify that the utility identifier of the time the -TERM UTILITY request was received, utility
utility job to be altered, displayed, or terminated was 'utility-name' was ACTIVE in the utility job step identified
correctly entered.To view all currently valid identifiers, by UTILID 'utilid'.
issue the -DISPLAY UTILITY (*) or (partial-utility-id*)
command. System Action: DB2 has accepted the request to
terminate the indicated utility job step. The utility
terminates at its next cleanup point.
DSNU114I csect-name UTILITY COMMANDS
SUBSYSTEM FAILURE, User Response: This message is an
REASON=Xcode acknowledgement that the request has been accepted
and is in progress.
Explanation: This message indicates an abend has
occurred in the utility commands subsystem.
DSNU161I csect-name - utility-name UTILITY WITH
System Action: The command abends. In the case of UTILID = util-id CAN NOT BE
the -TERM command, termination actions taken TERMINATED AT THE DB2 TRACKER
previously under this command are backed out. SITE
User Response: Prior messages and/or the SVC Explanation: DB2 does not permit the termination of
dump identify the failure. If the condition can be certain utilities at a tracker site because terminating
corrected, the command may be reissued. these utilities may leave the target objects in an
Problem Determination: In most cases, the failure is unpredictable state. The next recovery cycle should
not user related. In some cases, prior messages cause the utilities to resolve. You may not terminate the
indicate a user error that may be corrected. The following utilities at a tracker site:
problem may be as simple as SYSIBM.SYSUTIL being v COPY
temporarily locked by another command or a utility job. v LOAD
If you suspect an error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on v REORG
identifying and reporting the problem. v REPAIR
Severity: 8 (error)
DSNU115I csect-name utility-name UTILITY WITH
System Action: The utility does not terminate.
UTILID = utilid CAN ONLY BE
TERMINATED BY A MEMBER WITH System Programmer Response: Monitor the status
THE SAME RELEASE = release of these utilities after the next tracker site recovery
cycle.
Explanation: Command TERM UTILITY cannot
terminate the utility job with identifier utilid because it User Response: Contact the system programmer.
belongs to a member with a release level identified in
the message. Some utilities can be terminated only from
DSNU164I csect-name cccccccc UTILITY, UTILID =
a member of the DB2 data sharing group with the same
uuuu ALREADY TERMINATING
release level.
Explanation: This message is in response to a -TERM
Severity: 0 (informational)
UTILITY command. It indicates that the utility job step
System Action: Command TERM UTILITY is rejected indicated by UTILID 'uuuuu' has already been requested
for the indicated utility job. to terminate and is in the process of doing so now.
User Response: Make sure the utilid identifies the Severity: 0 (informational)
utility you want to terminate. If it does, issue command
System Action: DB2 is currently in the process of
TERM UTILITY from a member with a release level
terminating the indicated utility job step. Upon
identified in the message in the DB2 data sharing
completion, all resources will have been released to
group.
their prior state, and all tracking of the indicated UTILID
will have been removed. At that point, the UTILID is
available for reuse.
User Response: This message indicates that either
Chapter 18. DB2 Messages 457
DSNU166I • DSNU182I
the request was redundant, or someone else is also
DSNU180I csect-name UTILITY IS NOT
interested in the termination of the subject utility job
COMPATIBLE WITH THE utility-name
step.
UTILITY, UTILID = uid, OBJECT =
spacename.object-name.
DSNU166I csect-name utility-name UTILITY, UTILID
Explanation: Certain utilities cannot process the same
= uid NOT EXECUTING, CLEANUP
table or index space at the same time. The message
COMPLETE
identifies the objects for which the incompatibility
Explanation: This message is in response to a -TERM occurred.
UTILITY command. The 'utility-name' utility identified by
These objects might be target objects of the utilities, a
UTILID 'uid' was found to be stopped at the time of the
mapping table, or they might be catalog or directory
request to terminate.
table spaces that are updated by the utilities. For
Severity: 0 (informational) example, DSNDB06.SYSCOPY is updated by LOAD.
System Action: Cleanup is performed for the Severity: 8 (error)
indicated stopped utility. All resources held by the utility
System Action: The starting utility is not initiated, and
are freed and all storage of the utility job is deleted. The
further utility processing in that utility job step is
utility job is no longer restartable.
terminated.
System Programmer Response: Resources held by
User Response: Use -DISPLAY UTILITY with the
this utility may have prevented applications, commands,
provided 'uid' to determine when the utility that caused
and other utilities from executing. These have been
your utility to be rejected is completed. Refer to Part 5
freed, so that the inhibited tasks may now be
(Volume 2) of DB2 Administration Guide for a
performed.
discussion of which utilities are mutually compatible.
DSNU170I csect-name UTILITY JOB TERMINATED
DSNU181I csect-name RESTART NOT ALLOWED
BY TERM COMMAND
FOR utility-name UTILITY
Explanation: A -TERM UTILITY command was issued
Explanation: An attempt was made to restart the
for this utility job step.
named utility. DB2 does not allow this utility to be
Severity: 8 (error) restarted.
System Action: The executing utility terminates System Action: Utility processing is abended. Abend
processing and frees all held resources. All storage of reason code 00E40018 might be issued.
the utility job has been deleted. Therefore, the job is not
User Response: Issue the -TERM UTIL command to
restartable. Subsequent utilities in the same job step are
terminate the utility job and then rerun the job without
not executed.
the RESTART parameter.
User Response: All or portions of the utility job step
System Programmer Response: If necessary, take
can be resubmitted as needed.
actions to prevent access to the table space before
terminating the utility.
| DSNU172I csect-name UTILITY JOB STOPPED BY
STOP DB2 COMMAND
DSNU182I csect-name utility-name MUST BE THE
Explanation: A -STOP DB2 command was issued ONLY UTILITY IN SYSIN
during execution of the utility job step.
Explanation: The submitted utility control statements
Severity: 8 (error) contain a utility on the table space
DSNDB01.SYSUTILX. This table space is integral to
System Action: The executing utility stops processing controlling the execution of utilities. Control over
but continues to hold resources. Subsequent utilities in previous or subsequent utilities in the job step would be
the same job step are not executed. The storage of the lost if the utility were allowed to execute. Therefore, the
utility job is retained. Therefore, the utility job step is identified utility must be the only utility in a job step.
restartable.
This message is also issued if you recover the
User Response: Following a -START DB2 command, SYSUTILX indexes, DSNLUX01 and DSNLUX02, or
the utility job step may be restarted. Alternatively, the table space DSNDB01.DBD01 and include other utility
utility may be terminated using the -TERM UTILITY control statements in the same job step.
command and resubmitted as a new job. A REORG
utility that has passed the UNLOAD phase should rarely Severity: 8 (error)
be terminated.
System Action: Work performed by utilities in the
same utility job step prior to the starting utility persist.
458 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU183I • DSNU202I
The utility identified and subsequent utilities are not | created with DEFINE NO. Only the LOAD REPLACE
allowed to execute, and the utility job step is placed in | utility can be run on an object that is undefined.
the stopped state.
| Severity: 8 (error)
User Response: Terminate the utility execution that
| System Action: The utility ends without processing
received this message using the -TERM UTILITY
| the object.
command. Submit a subsequent job step containing
only the identified utility. Execute additional utilities, if | Operator Response: Remove the object name from
any, in a separate job step. | the utility statement and resubmit the utility job.
DSNU183I csect-name - utility-name UTILITY NOT DSNU200I csect-name - ERROR RANGE ON
COMPATIBLE WITH OTHER ACTIVE TABLE SPACE database.tablespace-
UTILITIES name PROHIBITS PROCESSING
Explanation: The utility identified by 'utility-name' is Explanation: The utility encountered an error range on
executing against table space DSNDB01.SYSUTILX. the identified table space or partition, which prohibits it
This table space is integral to controlling the execution from continuing.
of utilities. Control over other utilities running at the
same time would be lost if the utility were allowed to Severity: 8 (error)
execute. Therefore, the identified utility must be System Action: The utility fails serialization and
executed alone. There must be no other active DB2 terminates.
utilities in the system.
User Response: Correct the error range for the table
Severity: 8 (error) space by running RECOVER ERROR RANGE. Then
System Action: Utility execution is terminated. resubmit the original failing utility.
User Response: Rerun the utility when there are no
other utilities executing. Use the -DISPLAY UTILITY DSNU201I csect-name - ERROR RANGE ON INDEX
command to see what utilities are ACTIVE. Utilities in creator.index-name PROHIBITS
the STOPPED state are allowed. PROCESSING
Explanation: The utility encountered an error range on
DSNU184I csect-name - DO NOT RECOVER the identified index space or partition which prohibits it
OBJECT qual.obj-nm UNTIL THE NEXT from continuing.
TRACKER SITE RECOVERY CYCLE Severity: 8 (error)
Explanation: If DB2 detects an inconsistency relating System Action: The utility fails serialization and
to a utility’s status on object ’qual.obj-nm’ at the tracker terminates.
site, DB2 issues this message. This event can occur if
the SYSUTIL record for the utility either does not exist, User Response: Identify the incorrect error range by
or reflects incorrect information about hte status of the issuing the DISPLAY command for the index. Run the
utility. RECOVER or REBUILD INDEX utility to restore the
index or index partition that has the error range. Then
Severity: 8 (error) resubmit the original failing utility.
System Action: The utility issues ABEND04E with
return code 00E40009. | DSNU202I csect-name - RECOVER PENDING ON
User Response: Contact the system programmer. TABLE SPACE database.tablespace-
name PROHIBITS PROCESSING
System Programmer Response: Wait for the next
recovery cycle to reover the object named in this Explanation: An attempt was made to execute a utility
message. If the object named in this message is a against a table space that is in a rebuild pending state.
catalog or directory object, you cannot recover this Severity: 8 (error)
object, or any other objects in the list of catalog and
drectory objects, or any user data or indexes. Wait until System Action: Utility processing is not initiated.
the next recovery cycle to recover the object. User Response: Remove the table space from the
rebuild pending state by using either LOAD REPLACE,
| DSNU185I csect-name THE VSAM DATA SET REBUILD, or REPAIR against the object. LOAD
| DOES NOT EXIST FOR obj-type REPLACE with KEEPDICTIONARY is not allowed on a
| obj-qual.obj-name part part-number table space (with compression active) in the rebuild
pending state. Resubmit the job.
| Explanation: The VSAM data set(s) for the specified
| object has not been defined yet because the object was System Programmer Response: Determine which of
the three utilities, LOAD REPLACE, REBUILD, or
Chapter 18. DB2 Messages 459
DSNU203I • DSNU209I
REPAIR, should be used to remove the object from the the index to identify the logical error range (LPL). There
rebuild pending state. are two ways to restore the index or index partition that
has the LPL before resubmitting the original failed utility.
v Issue the START DATABASE command to clear the
| DSNU203I csect-name - RECOVER PENDING ON
LPL status, then run the RECOVER or REBUILD
| INDEX creator.index-name PROHIBITS
INDEX utility.
| PROCESSING
v Run the RECOVER or REBUILD INDEX utility to
Explanation: An attempt was made to execute a utility restore the entire nonpartitioning index (NPI).
against an index that is in a rebuild pending state.
Severity: 8 (error) DSNU207I csect-name - GROUP BUFFER POOL
RECOVERY PENDING ON TABLE
System Action: Utility processing is not initiated. SPACE database.tablespace-name
User Response: Remove the index from the rebuild PROHIBITS PROCESSING
pending state by using the REBUILD INDEX utility Explanation: You cannot execute a utility on a table
against the index. . Resubmit the job. space that is in a group buffer pool recovery pending
status.
DSNU204I csect-name - PAGESET REBUILD Severity: 8 (error)
PENDING ON INDEX creator.name
PROHIBITS PROCESSING System Action: Utility processing does not start.
Explanation: An attempt was made to execute a utility User Response: Use the -START DATABASE
against a logical partition of an index when the index is command to remove the table space from the group
in PAGESET REBUILD pending state, buffer pool recovery pending status. Then resubmit the
job.
Severity: 8 (error)
System Action: Utility processing terminates. DSNU208I csect-name - GROUP BUFFER POOL
User Response: Remove the index space from RECOVERY PENDING ON INDEX
PAGESET rebuild pending state by running the creator.index-name PROHIBITS
REBUILD INDEX utility against the entire index, not just PROCESSING
a single logical partition. Resubmit the job. Explanation: You cannot execute a utility on an index
that is in a group buffer pool recovery pending (GRECP)
DSNU205I csect-name - LOGICAL ERROR RANGE status.
(LOGICAL PAGE LIST) ON TABLE Severity: 8 (error)
SPACE database.tablespace-name
PROHIBITS PROCESSING System Action: Utility processing does not start.
Explanation: The utility cannot continue because it User Response: Run the REBUILD INDEX utility on
encountered a logical error range (logical page list) on the index to remove the table space from the group
the identified table space or partition. buffer pool recovery pending status. Then resubmit the
job.
Severity: 8 (error)
System Action: The utility terminates. DSNU209I csect-name - RESTART PENDING ON
User Response: Use the -START DATABASE obj-type database.tablespace-name
command to correct the logical error range (LPL) for the PROHIBITS PROCESSING
table space. Then resubmit the original failing utility. Explanation: An attempt was made to execute a utility
against a table space or index space that is in a restart
DSNU206I csect-name - LOGICAL ERROR RANGE pending state.
(LOGICAL PAGE LIST) ON INDEX Severity: 8 (error)
creator.index-name PROHIBITS
PROCESSING System Action: Utility processing is not initiated.
Explanation: The utility cannot continue because it System Programmer Response: Use the DISPLAY
encountered a logical error range (logical page list) on THREAD TYPE(POSTPONED) to determine the status
the identified index space or partition. of the resource. Use the RECOVER POSTPONED
command if recover has not already been started.
Severity: 8 (error) Resubmit the job.
System Action: The utility terminates.
User Response: Issue the -DISPLAY command for
460 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU210I • DSNU231I
INVALIDATE option. If there are no AUX CHECK errors,
DSNU210I csect-name - INFORMATIONAL COPY
AUX CHECK PENDING will be reset. If AUX CHECK
PENDING ON obj-type obj-qual.obj-name
errors are found, AUX CHECK PENDING will be reset
PROHIBITS PROCESSING
and the table space will be set to an AUX WARNING
Explanation: An attempt was made to execute the state. This allows the rows with AUX CHECK errors to
RECOVER utility with the ERROR RANGE or PAGE be corrected. Correct the errors and rerun CHECK
options against an index in the informational copy DATA. If no more AUX CHECK errors are found, the
pending state. AUX WARNING state will be reset.
Severity: 8 (error)
DSNU214I csect-name - REBUILD PENDING ON
System Action: Utility processing is not initiated.
INDEX creator.index-name PROHIBITS
User Response: Use the REBUILD INDEX utility PROCESSING
instead.
Explanation: An attempt was made to execute a utility
against an index that is in rebuild pending state.
DSNU211I csect-name CHECK PENDING ON
Severity: 8 (error)
obj-type obj-qual.obj-name PROHIBITS
PROCESSING System Action: Utility processing is not initiated.
Explanation: The requested utility can not be run User Response: Remove the index from the rebuild
against an index in the check pending state. The index pending state by using REBUILD INDEX against the
may be out of sync with its table space. index, then resubmit the job.
Severity: 8 (error)
| DSNU215I csect-name REFRESH PENDING ON
System Action: Utility processing is not initiated.
| ob-type database.objectname
User Response: Run either the CHECK INDEX utility | PROHIBITS PROCESSING
or the REBUILD INDEX utility. The CHECK INDEX
| Explanation: DB2 attempted to execute a utility
utility will identify any errors (for example, if the index
| against a table space or index that has refresh pending
keys do not match the data in the table space.) If there
| status.
are no errors, the check pending state will be reset. The
REBUILD INDEX utility will rebuild the index from the | Severity: 8 (error)
data in the table space.
| System Action: Utility procesing is not initiated.
| DSNU212I csect-name - REORG PENDING ON
| User Response: If the object in refresh pending status
| TABLE SPACE database.index-name
| is a table space, use the RECOVER utility to recover
| PROHIBITS PROCESSING
| the table space to a prior point in time. You can also
| reload the table space with LOAD REPLACE. If the
Explanation: An attempt was made to execute a utility | object in refresh pending status is an index, use the
against a table space that is in a REORG PENDING | REBUILD INDEX utility to rebuild the index from the
state. | data.
Severity: 8 (error)
DSNU231I csect-name DICTIONARY WITH n
System Action: Utility processing is not initiated.
ENTRIES HAS BEEN SUCCESSFULLY
User Response: Execute REORG with SHRLEVEL BUILT FROM m ROWS FOR
NONE against the partitions in REORG PENDING state TABLESPACE tablespace-name
to rebalance the partitions and remove the REORG
Explanation: A compression dictionary was built for
PENDING state.
the specified tablespace. This message is issued during
the RELOAD phase of the LOAD utility and at the end
DSNU213I csect-name - AUX CHECK PENDING ON of the UNLOAD phase of the REORG utility.
TABLE SPACE table-space PROHIBITS
The variable n is the number of dictionary entries, and
PROCESSING
can be any of the following values: 512, 1024, 2048,
Explanation: The processing is prohibited because 4096, or 8192. n depends on the number of rows being
the table-space is in an AUX CHECK PENDING state. loaded or reorganized.
System Action: Utility terminates and returns m is the number of rows used to build the dictionary.
completion code=8.
Severity: 0 (informational)
Programmer Response:
System Action: Processing continues.
Run the CHECK DATA utility with the AUXERROR
Chapter 18. DB2 Messages 461
DSNU232I • DSNU234I
compressed. This message is issued at the end of the
DSNU232I csect-name KEEPDICTIONARY
RELOAD phase for the LOAD and REORG utility. The
REQUESTED BUT COMPRESS
statistics that follow apply only to the data that was
ATTRIBUTE NOT DEFINED FOR TABLE
loaded or reorganized. For example, RESUME(YES)
SPACE table-space-name
reports statistics only on the additional rows that were
Explanation: The KEEPDICTIONARY option was loaded, not what was previously in the table space.
specified in the LOAD or REORG TABLESPACE utility
The compression statistics follow:
statement. This keyword should only be used with table
spaces that have the COMPRESS YES attribute. noncmpbytes
Otherwise, it is ignored. The COMPRESS column of The total number of uncompressed KB (where
SYSIBM.SYSTABLEPART contains the current KB = 1024 bytes) for the loaded or reorganized
compression status. data rows (including the row prefix). This
number was rounded to the nearest KB.
Severity: 4 (warning)
cmpbytes
System Action: Processing continues. If the dictionary
The total number of compressed KB for the
exists, it is erased if LOAD REPLACE or REORG is
loaded or reorganized data rows (including the
specified.
row prefix). This number was rounded to the
nearest KB.
DSNU233I csect-name COMPRESSION
percsave
DICTIONARY DOES NOT EXIST FOR
The percentage of bytes saved from the
TABLE SPACE table-space-name
loaded or reorganized data rows as a result of
Explanation: The KEEPDICTIONARY option was compression.
specified in the LOAD or REORG TABLESPACE utility
statement for a table space that does not have a The values above reflect only the number of bytes for
compression dictionary. the data row and the respective row prefix (6 bytes).
DB2 page and dictionary page overhead is not included.
Severity: 4 (warning)
pctrowcomp
System Action: Processing continues. A dictionary is
The percentage of the rows that were
built for the table space.
compressed within the total number of rows
that were loaded or reorganized. The stored
DSNU234I csect-name COMPRESSION REPORT length and the external length of a row was
FOR TABLE SPACE table-space-name compared to determine if the row was
compressed. If an EDITPROC is involved, its
:
effect on the length of the row is considered in
noncmpbytes
the calculation.
KB WITHOUT COMPRESSION
cmpbytes noncmppages
KB WITH COMPRESSION The estimated number of DB2 pages required
percsave by the uncompressed data rows that were
PERCENT OF THE BYTES SAVED FROM loaded or reorganized. Space required for
COMPRESSED DATA ROWS PCTFREE and FREEPAGE is included. This
pctrowcomp number was rounded up to the next integer.
PERCENT OF THE LOADED ROWS WERE
cmppages
COMPRESSED
The estimated number of DB2 pages required
noncmppages
by the compressed data rows that were loaded
PAGES REQUIRED WITHOUT
or reorganized. Space required for PCTFREE
COMPRESSION
and FREEPAGE is included. Dictionary pages
cmppages
are also included unless a LOAD
PAGES REQUIRED WITH COMPRESSION
RESUME(YES) was run. This number was
auncmprowlen
rounded up to the next integer.
BYTES FOR AVERAGE UNCOMPRESSED
ROW LENGTH auncmprowlen
avgcmprowlen Average uncompressed row length.
BYTES FOR AVERAGE COMPRESSED ROW
LENGTH avgcmprowlen
pagesave Average compressed row length.
PERCENT OF THE DB2 DATA PAGES SAVED pagesave
USING COMPRESSED DATA An estimate of the percentage of DB2 pages
Explanation: The data in the table space was saved by compressing the loaded or
reorganized data rows.
462 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU235I • DSNU244I
Severity: 0 (informational)
DSNU242I csect-name KEEPDICTIONARY
System Action: Processing continues. REQUESTED BUT COMPRESS
ATTRIBUTE NOT DEFINED ON TABLE
SPACE table-space-name, PARTITION
DSNU235I csect-name THE COMPRESSION part-num
DICTIONARY WAS NOT BUILT FOR
TABLE SPACE table-space-name Explanation: The KEEPDICTIONARY option was
specified in the LOAD or REORG TABLESPACE utility
Explanation: There is insufficient data to build a statement. This keyword should only be used with table
compression dictionary. For the LOAD utility, the input space partitions that have the COMPRESS YES
data set is empty or all of the input records were attribute. Otherwise, it is ignored. The COMPRESS
discarded. For the REORG TABLESPACE utility, the column of SYSIBM.SYSTABLEPART contains the
table space is empty. The data was not compressed. current compression status.
Severity: 4 (warning) Severity: 4 (warning)
System Action: Processing continues. System Action: Processing continues. If the dictionary
User Response: The input data set must contain data exists, it is erased if LOAD REPLACE or REORG is
in order to build a compression dictionary while running specified.
the LOAD utility. Ensure that the input records are not
discarded by the WHEN clause or conversion errors. DSNU243I csect-name COMPRESSION
For the REORG TABLESPACE utility, the table space DICTIONARY DOES NOT EXIST FOR
must be populated with data in order to build a TABLE SPACE table-space-name,
compression dictionary. PARTITION part-num
Explanation: The KEEPDICTIONARY option was
DSNU236I csect-name DICTIONARY FOR TABLE specified in the LOAD or REORG TABLESPACE utility
SPACE table-space-name HAS BEEN statement for a table space partition that does not have
ERASED. a compression dictionary.
Explanation: The compression dictionary of the Severity: 4 (warning)
specified table space was erased.
System Action: Processing continues. A dictionary is
The COMPRESS attribute of the table space is NO, and built for the table space partition.
there are no active rows in this table space. In this
case, the LOAD RESUME NO utility erases the
dictionary. DSNU244I csect-name COMPRESSION REPORT
FOR TABLE SPACE table-space-name,
Severity: 0 (informational) PARTITION part-num
System Action: Processing continues. :
noncmpbytes
DSNU241I csect-name DICTIONARY WITH n KB WITHOUT COMPRESSION
ENTRIES HAS BEEN SUCCESSFULLY cmpbytes
BUILT FROM m ROWS FOR TABLE KB WITH COMPRESSION
SPACE table-space-name, PARTITION percsave
part-num PERCENT OF THE BYTES SAVED FROM
COMPRESSED DATA ROWS
Explanation: A compression dictionary was built for pctrowcomp
the specified partition of the table space. This message PERCENT OF THE LOADED ROWS WERE
is issued during the RELOAD phase of the LOAD utility COMPRESSED
and at the end of the UNLOAD phase of the REORG noncmppages
utility. PAGES REQUIRED WITHOUT
The variable n is the number of dictionary entries: 512, COMPRESSION
1024, 2048, 4096, or 8192. n depends on the number cmppages
of rows being loaded or reorganized. PAGES REQUIRED WITH COMPRESSION
auncmprowlen
m is the number of rows used to build the dictionary. BYTES FOR AVERAGE UNCOMPRESSED
Severity: 0 (informational) ROW LENGTH
avgcmprowlen
System Action: Processing continues. BYTES FOR AVERAGE COMPRESSED ROW
LENGTH
Chapter 18. DB2 Messages 463
DSNU245I • DSNU250I
pagesave pagesave
PERCENT OF THE DB2 DATA PAGES SAVED An estimate of the percentage of DB2 pages
USING COMPRESSED DATA saved by compressing the loaded or
reorganized data rows.
Explanation: The data in the table space partition was
compressed. This message is issued at the end of the Severity: 0 (informational)
RELOAD phase for the LOAD and REORG utility. The
System Action: Processing continues.
statistics that follow apply only to the data that was
loaded or reorganized. For example, RESUME(YES)
reports statistics only on the additional rows that were DSNU245I csect-name THE COMPRESSION
loaded, not what was previously in the table space. DICTIONARY WAS NOT BUILT FOR
TABLE SPACE table-space-name,
The compression statistics follow:
PARTITION part-num
noncmpbytes
Explanation: There is insufficient data to build a
The total number of uncompressed KB (where
compression dictionary. For the LOAD utility, the input
KB = 1024 bytes) for the loaded or reorganized
data set is empty or all of the input records were
data rows (including the row prefix). This
discarded. For the REORG TABLESPACE utility, the
number was rounded to the nearest KB.
partition is empty. The data was not compressed.
cmpbytes
Severity: 4 (warning)
The total number of compressed KB for the
loaded or reorganized data rows (including the System Action: Processing continues.
row prefix). This number was rounded to the
nearest KB. User Response: The input data set must contain data
in order to build a compression dictionary while running
percsave the LOAD utility. Ensure that the input records are not
The percentage of bytes saved from the all being discarded by the WHEN clause or conversion
loaded or reorganized data rows as a result of errors. For the REORG TABLESPACE utility, the
compression. partition must be populated with data in order to build a
compression dictionary.
The values above reflect only the number of bytes for
the data row and the respective row prefix (6 bytes).
DSNU246I csect-name DICTIONARY FOR TABLE
DB2 page and dictionary page overhead is not included.
SPACE table-space-name, PARTITION
pctrowcomp part-num HAS BEEN ERASED.
The percentage of the rows that were
Explanation: The compression dictionary of the
compressed within the total number of rows
specified partition of the table space was erased.
that were loaded or reorganized. The stored
length and the external length of a row was The COMPRESS attribute of the table space partition is
compared to determine if the row was NO, and there are no active rows in this partition. In this
compressed. If an EDITPROC is involved, its case, the LOAD RESUME NO utility erases the
effect on the length of the row is considered in dictionary.
the calculation.
Severity: 0 (informational)
noncmppages
The estimated number of DB2 pages required System Action: Processing continues.
by the uncompressed data rows that were
loaded or reorganized. Space required for DSNU250I csect-name UNLOAD PHASE
PCTFREE and FREEPAGE is included. This COMPLETE, ELAPSED TIME =
number was rounded up to the next integer. hh/mm/ss
cmppages Explanation: The UNLOAD phase of the REORG
The estimated number of DB2 pages required utility completed normally. The time that elapsed
by the compressed data rows that were loaded between the beginning of the REORG utility and the
or reorganized. Space required for PCTFREE completion of the UNLOAD phase was hh/mm/ss,
and FREEPAGE is included. Dictionary pages hours, minutes, and seconds, respectively.
are also included unless a LOAD
RESUME(YES) was run. This number was Severity: 0 (informational)
rounded up to the next integer. System Action: Action subsequent to this message
auncmprowlen depends on the UNLOAD option of the REORG utility
Average uncompressed row length. statement:
v If the UNLOAD option is CONTINUE, execution of
avgcmprowlen
the utility continues into the RELOAD phase.
Average compressed row length.
464 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU251I • DSNU254I
v If the UNLOAD option is PAUSE, execution of the
DSNU252I csect-name UNLOAD PHASE
utility is stopped at the beginning of the RELOAD
STATISTICS. NUMBER OF RECORDS
phase.
UNLOADED= mmmmmm FOR
| v If the UNLOAD option is ONLY or EXTERNAL, the TABLESPACE tttttttt
| REORG utility is finished. Processing continues to the
| next utility in the utility job step, or, if there are no Explanation: This message is issued at the
| more utility statements, the utility job step terminates completion of the UNLOAD phase of the REORG utility.
| normally. It gives the number of records that were unloaded
mmmmmm for the indicated table space tttttttt.
User Response: The user’s response depends on the
UNLOAD option in the REORG utility statement. Severity: 0 (informational)
v If the UNLOAD option is CONTINUE, no user System Action: Only valid table records are unloaded.
response is required. The message is informational Dropped table record counts are not reported.
only.
v If the UNLOAD option is PAUSE, the REORG utility User Response: Record count represents the current
is stopped in the reload phase. To complete the cardinality of the indicated table. Invocation of the
REORG process, the user must explicitly restart the RUNSTATS utility and a subsequent rebinding of the
utility job step using the RESTART(PHASE) option. involved PLANs should be considered if this value
| v If the UNLOAD option is ONLY or EXTERNAL, the differs greatly from the SYSTABLE.CARD value, so that
| REORG utility has completed, and the requested the SQL optimizer can bring the PLANs up to date.
| output is on the data set identified by the DD Operator Response: Count can be indicative of the
| statement of the UNLDDN REORG utility statement amount of processing remaining.
| option.
Operator Response: The operator’s response DSNU253I csect-name UNLOAD PHASE
depends on the UNLOAD option of the REORG STATISTICS. NUMBER OF RECORDS
statement: action= mmmmmm FOR TABLE
v If the UNLOAD option is CONTINUE, no operator table-name
response is required. The execution of the REORG
utility is proceeding. Explanation: This message is issued at the
v If the UNLOAD option is PAUSE, further processing completion of the UNLOAD phase of the REORG utility.
is dependent upon restarting the utility job step with If action is ″UNLOADED″, it gives the number of
the RESTART(PHASE) option. Until that time, records mmmmmm that were unloaded for the specified
resources are held exclusively by the REORG utility table name. If action is ″DISCARDED″, it gives the
job step. number of records mmmmmm that were discarded for
| v If the UNLOAD option is ONLY or EXTERNAL, the the specified table name.
| REORG utility processing is complete. The data set
Severity: 0 (informational)
| defined by the DD statement nominated by the
| UNLDDN option is available for installation System Action: Table records were unloaded or
| disposition. discarded.
DSNU251I csect-name UNLOAD PHASE DSNU254I csect-name - RECORD COUNTS
STATISTICS. NUMBER OF RECORDS INCONSISTENT FOR pppppppp PHASE,
UNLOADED= mmmmmm FOR NUMBER OF RECORDS EXPECTED =
TABLESPACE tttttttt PART nn nnnnnnnn, NUMBER OF RECORDS
PROCESSED = aaaaaaaa
Explanation: This message is issued at the
completion of the UNLOAD phase of the REORG utility. Explanation: This message is issued during the
It gives the number of records that were unloaded pppppppp phase for the REORG utility to report the
mmmmmm for the indicated partition nn of table space condition where the number of records, nnnnnnnn,
tttttttt. The count can indicate the amount of processing. passed to the current phase is not equal to the number
of records, aaaaaaaa, processed in this phase.
Severity: 0 (informational)
Severity: 4 (warning)
System Action: Only valid table records are unloaded.
Dropped table record counts are not reported. System Action: Processing continues if UNLOAD
PAUSE option was used.
User Response: The record count represents the
current cardinality of the indicated partition. Consider User Response: Check if unload data set was altered
invoking the RUNSTATS utility and then rebinding the by user. Determine if the inconsistent record counts
involved PLANs if this value differs greatly from the between the unload and reload phases is a potential
SYSTABLE.CARD value so that the SQL optimizer can problem. If it is an internal DB2 problem, report to
bring the PLANs up to date. system programmer.
Chapter 18. DB2 Messages 465
DSNU255I • DSNU259I
System Programmer Response: Determine the v if the indicated PART integer is not pertinent to the
failing environment. If you suspect an error in DB2, refer partitions existing for the indicated table space
to Part 2 of DB2 Diagnosis Guide and Reference for | v or if a ROWID column is part of the partitioning key
information on identifying and reporting the problem.
| v if LOAD INTO TABLE PART x is performed on a table
Problem Determination: If the unload data set was | space where an identity column is part of the
manipulated by user during restart process, make sure | partitioning key
it was handled properly. If you suspect an error in DB2,
refer to Part 2 of DB2 Diagnosis Guide and Reference The utility job step is terminated.
for information on identifying and reporting the problem.
System Action: The error is sufficient to terminate
Collect the following diagnostic items listed in further processing of the utility job step. The utility job
“Appendix B. Problem determination” on page 1281: 1, step is terminated, and resources are released to their
2, 5. previous state.
User Response: Determine the correct partition
DSNU255I csect-name - KEY COUNT specification for the table space that was the subject of
INCONSISTENT FOR pppppppp PHASE, the specified control utility statement, and resubmit the
NUMBER OF KEYS EXPECTED = utility job step. Examine the SYSIBM.SYSTABLESPACE
nnnnnnnn, NUMBER OF KEYS in the DB2 catalog for the correct range of partition
PROCESSED = aaaaaaaa. | numbers for the table space. If a ROWID column is part
Explanation: This message is issued during the
| of the partitioning key, the PART option is invalid.
pppppppp phase for the LOAD or REORG utility to
report the condition where the number of keys, DSNU257I csect-name UNABLE TO RESTART
nnnnnnnn, passed to the current phase is not equal to BUILD PHASE
the number of keys, aaaaaaaa, processed in this phase.
One or more of the affected indexes may be Explanation: Restarting in the BUILD PHASE or the
inconsistent. SORTBLD phase of the LOAD utility with the
RESUME(YES) option is not permitted.
Severity: 8 (error)
Severity: 8 (error)
System Action: Processing stops and all indexes are
placed in rebuild pending state. System Action: Utility processing is not initiated.
User Response: TERM the utility and re-access the User Response: Recover all indexes within the table
indexes by running REPAIR utility to reset the space which were left in a rebuild pending state when
rebuild-pending states on indexes. Run the CHECK the LOAD utility failed.
INDEX utility to determine if any of the affected indexes Problem Determination: Refer to DB2 Utility Guide
are inconsistent. Inconsistent indexes can be rebuilt by and Reference and Part 2 (Volume 1) of DB2
the REBUILD INDEX utility. Administration Guide for a discussion of LOAD
System Programmer Response: Determine the restarting constraints.
failing environment. If you suspect an error in DB2, refer
to Part 2 of DB2 Diagnosis Guide and Reference for DSNU258I csect-name BUILD PHASE STATISTICS.
information on identifying and reporting the problem. NUMBER OF INDEXES = mmm
Problem Determination: If the working data set was Explanation: This message is issued at normal
manipulated by the user during the restart process, completion of the BUILD phase of the LOAD or REORG
make sure it was handled properly. Refer to DB2 Utility or REBUILD INDEX utility. The number of indexes that
Guide and Reference. were updated is indicated as 'mmm'.
If you suspect an error in DB2, refer to Part 2 of DB2 Severity: 0 (informational)
Diagnosis Guide and Reference for information on
identifying and reporting the problem. System Action: The BUILD phase of either the LOAD
or REORG or REBUILD INDEX utility is completed.
Upon completion of the utility job step, they are
DSNU256I csect-name INVALID PARTITION available for REFERENCE processing.
SPECIFICATION
Explanation: This message is issued by the utility in DSNU259I csect-name BUILD PHASE COMPLETE,
response to an invalid PART option specification. ELAPSED TIME = hh/mm/ss
The PART option is invalid in the following situations: Explanation: This message is issued at the normal
v when it is specified for a nonpartitioned table space completion of the BUILD phase of the REORG, LOAD,
and REBUILD INDEX utilities. The time that has
elapsed between the beginning of the phase and the
466 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU260I • DSNU272I
completion of this phase was 'hh' hours, 'mm' minutes,
DSNU270I csect-name - table-name, column-name
and 'ss' seconds.
IN VIOLATION OF INSTALLATION
System Action: Processing continues to the next DEFINED FIELD PROCEDURE
phase of the LOAD or REORG or REBUILD INDEX procedure-name. function-code,
utility. If this is the last phase, processing continues to return-code, reason-code, message-token
the next utility statement in the utility job step, if any.
Explanation: An installation-supplied field procedure
has returned an error during encoding for LOAD or
DSNU260I csect-name obj-type obj-qual.obj-name IS decoding for REORG. See SQLCODE -681 for more
EMPTY detail.
Explanation: This message is issued as a warning Severity: 8 (error)
when REBUILD INDEX(ALL) or REORG TABLESPACE
System Action: The utility will issue a system '04E'
are executed on an empty table space.
abend with a reason code of '00E40336'.
This message is also issued when COPY detects that
User Response: Request the dump produced as a
the first space map page in the table space or partition
result of the error to the system programmer so that the
is missing. This is an error condition that might be
cause of the error can be determined and corrected.
caused by a delete and redefine of the data set outside
of DB2, or by a previous DB2 failure that occurred on System Programmer Response: Examine the field
the data set. procedure to determine why an error return code was
generated. Refer to DB2 Utility Guide and Reference for
Severity: 4 (warning) or 8 (error)
more information.
System Action: For REBUILD INDEX or REORG
TABLESPACE, the return code of 4 will allow the next
| DSNU271I csect-name - REORG PENDING ON FOR
utility function in the job step, if any, to be initiated.
| TABLE SPACE database.index-name
For COPY, the table space, index space, or partition | PART part number PROHIBITS
being copied will be placed in recover pending status. | PROCESSING
The return code of 8 will prohibit further utility
| Explanation: An attempt was made to execute a
processing in the job step.
| REORG utility to redistribute data in a partitioned table
User Response: Notify the system programmer if the | space. The partition number stated in this message was
return code is 8. If the return code is 4, no action is | found to have the REORP state on, but was not
required. | specified on the PART n1:n2 parameter of the REORG
| utility.
System Programmer Response: If the return code is
8, the table space, indexspace, or partition being copied | If you are running REORG to materialize identity column
should be recovered with the RECOVER utility. | values, you must reorganize the entire table space.
| Severity: 8 (error)
| DSNU269I csect-name FIELD field-name IS NOT
| System Action: Utility processing is not initiated.
| ALLOWED
| System Programmer Response: Identify the correct
| Explanation: You specified a ROWID GENERATED
| partition range specification for the REORG utility by
| ALWAYS in the field specification list. Only a ROWID
| issuing the DISPLAY command for the table space, and
| GENERATED BY DEFAULT is allowed to be specified in
| resubmit the utility job step.
| the field specification list.
| Identity columns that were defined as GENERATED
DSNU272I csect-name - FIELD PROCEDURE
| ALWAYS can not be specified in a LOAD field
procedure-name COULD NOT BE
| specification list, nor can these columns be implied in
LOADED
| LOAD FORMAT UNLOAD or LOAD with no field
| specification list. Explanation: An installation supplied field procedure
could not be loaded during encoding for LOAD or
| Severity: 8 (error) decoding for REORG. See SQLCODE -682 for more
| System Action: The LOAD utility is terminated detail.
| User Response: Omit the ROWID GENERATED Severity: 8 (error)
| ALWAYS column from the LOAD field specification list System Action: The utility will terminate with a return
| and rerun the job. code of 8.
User Response: Take the job output to the system
programmer.
Chapter 18. DB2 Messages 467
DSNU273I • DSNU286I
System Programmer Response: Determine why the
DSNU282I csect-name UNABLE TO RESTART AT
field procedure could not be loaded.
LAST CHECKPOINT WITH DDNAME
’dddddddd’
| DSNU273I csect-name - REORG WITH SHRLEVEL
Explanation: The data set with DDNAME 'dddddddd'
| REFERENCE OR CHANGE CANNOT
is a concatenated data set and the utility can be
| APPLY TO TABLE SPACE name PART
restarted only at the beginning of the phase (RESTART
| n1:n2
PHASE), not at the last checkpoint (RESTART
Explanation: REORG with SHRLEVEL REFERENCE CURRENT).
or CHANGE cannot be used on table space partitions
Severity: 8
with REORG PENDING restrictive state.
System Action: The utility will issue a system '04E'
Severity: 8 (error)
abend with a reason code of '00E40323'.
System Action: The REORG utility job is terminated.
User Response: Change the RESTART option to
User Response: Execute REORG with SHRLEVEL RESTART PHASE and resubmit the job step.
NONE against the partitions in REORG PENDING state
Collect the following diagnostic items listed in
to rebalance the partitions and remove the REORG
“Appendix B. Problem determination” on page 1281: 1,
PENDING state.
2, 5.
DSNU280I csect-name - ERROR=X'reason-code'
DSNU286I csect-name REORG TABLESPACE
FROM EDIT ROUTINE procedure-name
dbname.tsname OFFPOSLIMIT
FOR table-name
SYSINDEXPART ROWS
Explanation: The edit routine provided by your
Explanation: This is the header message for the
installation has returned an error during the load of a
SYSINDEXPART section of the REORG TABLESPACE
record into the table indicated. The reason code is set
OFFPOSLIMIT output. This section lists the
by the edit routine.
SYSINDEXPART rows for the table space or table
Severity: 8 (error) space partition as specified in the REORG
TABLESPACE input statement. The fields from
System Action: The LOAD or REORG utility will SYSINDEXPART are:
receive ABEND04E RC00E40323.
CREATOR
User Response: Correct any errors in the input data. Index creator name
Ensure that the edit routine provided is correct. The
utility can be restarted or terminated. IXNAME
Index name
System Programmer Response: Verify that the edit
routine is correct. CREATOR
Table creator name
| DSNU281I csect-name RECORD (n) OF TABLE TBNAME
| table-name VIOLATING VALID ROUTINE Table name
| validproc-name, ERROR
PART Partition number
| CODE=X'reason-code'
CARDF
Explanation: The validation exit routine provided by
Number of rows referenced (floating point)
your installation blocked the load of record 'n' into
TABLE 'table-name'. The reason-code was set by the FAROFFPOSF
exit routine. Number of rows referenced afar (floating point)
Severity: 4 (warning) NEAROFFPOSF
Number of rows referenced nearby (floating
System Action: The LOAD utility continues to process
point)
the following input record.
STATSTIME
User Response: Check the error input records against
TIMESTAMP of RUNSTATS update
the error reason code returned from the validation
procedure. Refer to DB2 Utility Guide and Reference for
Rows which meet the OFFPOSLIMIT criteria are
a definition of LOAD input field column specifications.
prefaced with ’*’.
System Programmer Response: Verify that the
Severity: 0 (informational)
validation routine is correct.
System Action: Processing continues normally
468 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU287I • DSNU290I
User Response: If the TIMESTAMP reported in the LEAFDIST
STATSTIME column is not recent, the OFFPOSLIMIT Number of pages between leaf pages
criteria might be evaluated with obsolete statistics. multiplied by 100
STATSTIME
DSNU287I csect-name REORG TABLESPACE TIMESTAMP of RUNSTATS update
dbname.tsname INDREFLIMIT
SYSTABLEPART ROWS Rows which meet the LEAFDISTLIMIT criteria are
prefaced with ’*’.
Explanation: This is the header message for the
SYSTABLEPART section of the REORG TABLESPACE Severity: 0 (informational)
INDREFLIMIT output. This section lists the
SYSTABLEPART rows for the table space or table System Action: Processing continues normally
space partition as specified in the REORG User Response: If the TIMESTAMP reported in the
TABLESPACE input statement. The fields from STATSTIME column is not recent, the LEAFDISTLIMIT
SYSTABLEPART are: criteria might be evaluated with obsolete statistics.
DBNAME
Database name DSNU289I csect-name type REORG LIMITS HAVE
TSNAME BEEN MET
Table space name Explanation: The REORG utility is indicating whether
PART Partition number any specified limits have been met. For REORG
TABLESPACE, this might be the OFFPOSLIMIT or the
CARD Number of rows in table space INDREFLIMIT. For REORG INDEX, this is the
LEAFDISTLIMIT. type values:
FARINDREF
Number of rows relocated afar NO If no limits are met.
NEARINDREF blank If at least one limit is met.
Number of rows relocated nearby
Severity: The return codes are:
STATSTIME
TIMESTAMP of RUNSTATS update 1 (informational)
If no limit is met.
Rows which meet the INDREFLIMIT criteria are 2 (informational)
prefaced with ’*’. If at least one limit is met.
Severity: 0 (informational) System Action: Utility processing continues.
System Action: Processing continues normally User Response: If the REPORTONLY option is
specified and the result of this job step is not used to
User Response: If the TIMESTAMP reported in the
conditionally execute other job steps, examine the utility
STATSTIME column is not recent, the INDREFLIMIT
messages for this table space, partition, or index to
criteria might be evaluated with obsolete statistics.
determine if a REORG should be performed.
DSNU288I csect-name REORG INDEX
DSNU290I csect-name type REORG WILL BE
dbname.ixname LEAFDISTLIMIT
PERFORMED
SYSINDEXPART ROWS
Explanation: The REORG utility is indicating whether
Explanation: This is the header message for the
any specified limits have been met and whether a
SYSINDEXPART section of the REORG INDEX
REORG will be performed. For REORG TABLESPACE,
LEAFDISTLIMIT output. This section lists the
this might be the OFFPOSLIMIT or the INDREFLIMIT.
SYSINDEXPART rows for the index or index partition as
For REORG INDEX, this is the LEAFDISTLIMIT. type
specified in the REORG INDEX input statement. The
values:
fields from SYSINDEXPART are:
NO If no limits are met.
CREATOR
Index creator name blank If at least one limit is met.
IXNAME Severity: 0 (informational)
Index name
System Action: Utility processing continues. A
PART Partition number REORG is performed if any limits are met.
Chapter 18. DB2 Messages 469
DSNU291I • DSNU295I
DSNDB06.SYSPLAN, DSNDB06.SYSVIEWS, and
DSNU291I MAXIMUM COMPOSITE UNLOAD
DSNDB01.DBD01.
RECORD SIZE TOO LARGE FOR SORT.
SORTDATA KEYWORD IS IGNORED. Severity: 8 (error)
Explanation: The SORTDATA keyword was specified System Action: REORG does not execute.
for a REORG utility job. However, the largest possible
record in the table space, prefixed by the largest key, User Response: Execute REORG with SHRLEVEL
produces a composite record that is too large to be NONE.
processed by the SORT component. The SORTDATA
keyword is ignored. DSNU294I csect-name - LARGEST COMPOSITE
This message is issued by the following CSECT: RECORD IS TOO BIG FOR REORG
DSNURFIT WITH SHRLEVEL CHANGE
Severity: 0 Explanation: SHRLEVEL CHANGE was specified for
a REORG utility job, and the table has a clustering
System Action: Processing continues normally. index. However, the largest possible record in the table
space, prefixed by the largest key, produces a
User Response: If you must use SORTDATA for the
composite record that is too large to be processed by
table space, try reducing the size of either the largest
the SORT component. See the computation of the
record or key field by redefining the table. In some
length under REORG in the DB2 Utility Guide and
cases, changing a field from LONG VARCHAR to
Reference. If the largest possible composite record to
VARCHAR with a specified maximum length might help.
be sorted exceeds 32760 bytes in length, which is the
Problem Determination: This problem should only maximum record size for a BSAM data set, REORG
occur on a table space with a 32KB page size. Analyze cannot operate if SHRLEVEL CHANGE is specified.
the requirement for maximum data length in VARCHAR
Severity: 8 (error)
and LONG VARCHAR columns to see if a shorter
length can be specified. It might be necessary to System Action: REORG does not execute.
remove the SORTDATA keyword from the utility
statement. User Response: Execute REORG with SHRLEVEL
NONE or REFERENCE. If you must use SHRLEVEL
CHANGE for the table space, try reducing the size of
DSNU292I csect-name - -ALTER UTILITY CANNOT either the largest record or key field by redefining the
APPLY TO THIS UTILITY, REASON=c table. In some cases, changing a field from LONG
VARCHAR to VARCHAR with a specified maximum
Explanation: The -ALTER UTILITY command only
length might help.
applies to a job that is executing REORG with
SHRLEVEL REFERENCE or CHANGE. In addition, if Problem Determination: This problem should only
-ALTER UTILITY specifies MAXRO, LONGLOG, or occur on a table space with a 32KB page size. Analyze
DELAY, the job must be executing REORG with the requirement for maximum data length in VARCHAR
SHRLEVEL CHANGE. and LONG VARCHAR columns to see whether a
shorter length can be specified.
1 The job is not executing REORG with
SHRLEVEL REFERENCE or CHANGE.
DSNU295I csect-name - IN UTILTERM PHASE OF
2 -ALTER UTILITY specifies MAXRO,
REORG WITH SHRLEVEL REFERENCE
LONGLOG, or DELAY, but the job is executing
OR CHANGE, DATA SET name COULD
REORG with SHRLEVEL REFERENCE.
NOT BE DELETED, DFP REASON
Severity: 8 (error) CODE = rrrrrrrr
System Action: -ALTER UTILITY does not execute. Explanation: For the area (table space or partition)
being reorganized, REORG with SHRLEVEL
User Response: Apply -ALTER UTILITY to a job that
REFERENCE or CHANGE unloads data from the
is executing the proper utility.
original data sets and reloads data into shadow data
sets. REORG then exchanges the names of the original
DSNU293I csect-name - REORG WITH SHRLEVEL and shadow data sets. The original name of a data set
REFERENCE OR CHANGE CANNOT is in the form
APPLY TO THE name TABLE SPACE “catname.DSNDBx.dbname.psname.I0001.Annn”. The
shadow name of a data set is in the form
Explanation: REORG with SHRLEVEL REFERENCE | “catname.DSNDBx.dbname.psname.J0001.Annn”.
or CHANGE cannot operate on the following catalog REORG uses such data sets for indexes as well as
and directory table spaces: DSNDB06.SYSDBASE, data.
DSNDB06.SYSDBAUT, DSNDB06.SYSGROUP,
If a data set is DB2-managed, the utilterm phase of
REORG deletes the shadow data set, which was the
470 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU296I
original data set. This message indicates that the 4 The original data set from the shadow name to
shadow data set name could not be deleted. rrrrrrrr the temporary name
indicates the DFP reason code.
5 The shadow data set from the original name to
Severity: 4 (warning) the shadow name
System Action: REORG continues execution, but it 6 The original data set from the temporary name
does not delete the specified data set. to the original name
User Response: Try to delete the data set. If you
The context code indicates the specific type of error:
cannot delete it, notify the system programmer.
1
System Programmer Response: Look up the DFP
reason code, and try to determine why the data set During the switch phase of REORG, on
could not be deleted. rename 1, REORG detected that a data set
with an original name does not exist. This error
condition can arise for a DB2-managed or
DSNU296I csect-name - IN REORG WITH
user-managed data set.
SHRLEVEL REFERENCE OR CHANGE,
DATA SET name DOES NOT EXIST, During the switch phase restart or a -TERM
CONTEXT=c UTILITY during the switch phase, on rename 4,
REORG detected that a data set with an
Explanation: For the area (table space or partition)
original name does not exist. This error
being reorganized, REORG with SHRLEVEL
condition can arise for a DB2-managed or
REFERENCE or CHANGE unloads data from the
user-managed data set.
original data sets and reloads data into shadow data
sets. REORG then exchanges the names of the original 2
and shadow data sets, using temporary names during
the renaming. The original name of a data set is in the During the switch phase of REORG, on
form “catname.DSNDBx.dbname.psname.I0001.Annn”. rename 2, REORG detected that a data set
The shadow name of a data set is in the form with a shadow name does not exist. This error
| “catname.DSNDBx.dbname.psname.J0001.Annn”. The condition can arise for a DB2-managed or
temporary name of a data set is in the form user-managed data set.
“catname.DSNDBx.dbname.psname.T0001.Annn”. During the switch phase restart or a -TERM
REORG uses such data sets for indexes as well as UTILITY during the switch phase, on rename 5,
data. REORG detected that a data set with a
During its initialization, REORG cannot execute if: shadow name does not exist. This error
condition can arise for a DB2-managed or
v Data sets with the temporary names already exist user-managed data set.
v DB2-managed data sets with the shadow names
already exist 3
v User-managed data sets with the shadow names do During the utilterm phase of REORG, on
not already exist rename 3, REORG detected that a data set
with a temporary name does not exist. This
To exchange the names of the original and shadow data error condition can arise for a user-managed
sets, REORG renames in the following ways: data set.
1 In the switch phase, it renames the original During switch phase restart or a -TERM
data set from the original name to the UTILITY during the switch phase, on rename 6,
temporary name. REORG detected that a data set with a
temporary name does not exist. This error
2 In the switch phase, it renames the shadow condition can arise for DB2-managed or
data set from the shadow name to the original user-managed data sets.
name.
Severity: 4 (warning) or 8 (error)
3 In the utilterm phase, it renames the original
data set from the temporary name to the System Action: For context codes 1 or 2, utility
shadow name (for user-managed data sets). It processing is abended. ABEND reason code 00E4031B
deletes the temporary name for DB2-managed is issued. The object is left in a recovery pending state.
data sets. For context code 3, the utility job step that caused the
function to be requested continues with no renaming.
If either a -TERM UTILITY command is issued, or the The utility job is placed in the stopped state. The object
REORG switch phase is restarted after REORG has is left in a recovery pending state, and a message will
begun renaming data sets, the names revert back to be issued. For context codes 1, 2, or 3, the following
their original form prior to the utilterm phase of REORG: messages are issued:
Chapter 18. DB2 Messages 471
DSNU297I • DSNU301I
v If the data set is part of a nonpartitioned table space,
DSNU299I csect-name - COLUMN 'column-name'
the object is the table space, and the message is
| REQUIRES TRANSLATION FROM
DSNU562I.
CCSID ccsid TO ccsid
v If the data set is part of a partition of a table space,
the object is the partition, and the message is Explanation: The LOAD utility was asked to translate
DSNU560I. an input value to a different coded character set, but the
particular translation is not described in the
v If the data set is part of a nonpartitioned index, the
| SYSSTRINGS catalog table nor could translation be
object is the index, and the message is DSNU557I.
| externalized. The first ccsid identifies the coded
v If the data set is part of a partition of a partitioned character set of the input value, and the second ccsid
index, the object is the partition of the index, and the identifies the coded character set to which it must be
message is DSNU559I. translated.
User Response: For context codes 1 or 2, execute Severity: 8 (error)
the RECOVER TABLESPACE or RECOVER or
REBUILD utilities. System Action: Further utility processing is
terminated.
For context code 3 do nothing.
User Response: If the CCSIDs are correct, the only
corrective action is to provide for the translation by
DSNU297I csect-name COMPOSITE RECORD SIZE inserting a row into SYSSTRINGS. For an SBCS
TOO LARGE FOR table-name translation, the row must contain a translate table or the
Explanation: The size of the record that would be name of a user-provided translate procedure. For a
unloaded for REORG DISCARD or REORG UNLOAD DBCS translation, the row must contain the name of a
EXTERNAL is greater than the largest allowed data set user-provided translate procedure.
logical record length (32760 bytes). If the CCSIDs are incorrect, correct the CCSID
Severity: 8 (error) specification on the LOAD statement and resubmit the
job.
System Action: The utility will terminate with a return
code of 8.
DSNU300I csect-name (RE)LOAD PHASE
User Response: If you are attempting to discard COMPLETE, ELAPSED TIME =
records during REORG, you will have to use SQL to hh/mm/ss
DELETE the records prior to the REORG. If you are
attempting to unload records in an external format, you Explanation: The reload phase of the REORG or
will have to use an application. LOAD utility has completed normally. The elapsed time
for the execution was 'hh' hours, 'mm' minutes, and 'ss'
Problem Determination: This problem will most likely seconds.
occur only on a table with BLOB, CLOB, or DBCLOB
columns.
DSNU301I csect-name - KEYWORD 'SORTDATA'
SPECIFIED AND/OR KEYWORD
DSNU298I csect-name - RESTART NOT ALLOWED 'NOSYSREC' WAS SPECIFIED BUT NO
IN phase-name PHASE OF REORG CLUSTERINGINDEX EXISTS,
UTILITY WITH SHRLEVEL CHANGE KEYWORD IS IGNORED
Explanation: An attempt was made to restart the Explanation: The 'SORTDATA' keyword was specified
REORG utility with SHRLEVEL CHANGE in the or the 'NOSYSREC' keyword was specified for a
phase-name phase. DB2 does not allow you to restart REORG utility job, or implied by the use of SHRLEVEL
the REORG utility with SHRLEVEL CHANGE in that CHANGE. But it was found that no clustering index
phase. existed for the table space being reorganized. The
keyword is ignored and processing continues normally.
Severity: 8 (error)
Severity: 0
System Action: Utility processing abends. Abend
reason code 00E40018 or 00E40310 might be issued. System Action: Processing continues normally.
User Response: Issue the -TERM UTILITY command User Response: If a clustering index was expected to
to terminate the utility job; then rerun the job without the be found for the table space being reorganized,
RESTART parameter. determine the reason the index could not be found.
System Programmer Response: If necessary, take Problem Determination: Probably a user error.
actions to prevent access to the table space or partition Determine if a cluster index should be defined on one of
before terminating the utility. the tables in the table space being reorganized. If so,
define the cluster index; otherwise, remove the
'SORTDATA' and/or 'NOSYSREC' keyword from the
472 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU302I • DSNU305I
utility statement if necessary.
DSNU304I csect-name (RE)LOAD PHASE
STATISTICS. NUMBER OF RECORDS =
DSNU302I csect-name (RE)LOAD PHASE nnnnnn FOR TABLE table-name
STATISTICS. NUMBER OF INPUT
Explanation: This message is issued at the normal
RECORDS PROCESSED = nnnnnnnn
completion of the RELOAD phase of the REORG utility
Explanation: This message is issued at the normal and the LOAD phase of the LOAD utility.
completion of the RELOAD phase of the REORG utility
It indicates the number of records loaded into TABLE
and the LOAD phase of the LOAD utility.
'table-name' from the source record data set (that is, the
It indicates the number of records processed from the data set identified by the JCL DD statement identified in
input record data set (that is, the data set identified the UNLDDN option for REORG, or the INDDN option
either by the JCL DD statement identified in the for LOAD).
UNLDDN option for REORG or the INDDN option for
This message is repeated for each TABLE loaded by
LOAD).
the current REORG or LOAD utility statement.
Severity: 0 (informational)
If the LOAD or REORG was restarted in a LOAD or
System Action: The LOAD or REORG utility RELOAD phase from the last commit point (i.e., the
completes the phase in which the records are 'RESTART' parm was specified), 'nnnnnn' indicates the
(re-)introduced into the DB2 database. This is also the number of records loaded after the restart.
last phase of the utility unless there are some indexes
Severity: 0 (informational)
that need to be built and/or updated.
System Action: The LOAD or RELOAD phase
User Response: The user can verify that the number
maintains a separate count for each table populated by
of records (re-)loaded is consistent with expectations.
this phase. Rejected rows are not included in the count.
For example, in REORG it matches the total number of
Each count is reported as a separate message at the
records unloaded. For LOAD, it matches the number of
end of the LOAD or RELOAD phase.
records submitted minus the number of records reported
rejected. The user can verify that the number of records
(re-)loaded into the table is consistent with expectations.
For example, in REORG it matches the number of
DSNU303I csect-name (RE)LOAD PHASE
records unloaded for that table. For LOAD, it matches
STATISTICS. NUMBER OF RECORDS=
the number of records processed.
nnnnnn FOR TABLE table-name
PART=part-number
DSNU305I csect-name - TABLE=table-name HAS
Explanation: This message is issued at the normal
AN INCOMPLETE TABLE DEFINITION
completion of the RELOAD phase of the REORG utility
and the LOAD phase of the LOAD utility. | Explanation: Table 'table-name' does not have an
| index defined to enforce the uniqueness of its primary
It indicates the number of records loaded into PART
| key or unique key.
'part-number' of 'table-name' from the source record
data set. This data set is identified by the JCL DD Severity: 8 (error)
statement in the UNLDDN option for REORG, or the
System Action: Processing stops. No table in the
INDDN option for LOAD.
table space is loaded.
This message is repeated for each INTO TABLE PART
clause in the LOAD utility statement or each
| User Response: The user can resubmit the LOAD job
TABLESPACE PART clause in the REORG utility
| after performing one of the following:
statement. | v Creating a unique index over the table’s primary key
| v Creating a unique index over the table’s unique
Severity: 0 (informational)
| key(s)
System Action: The LOAD or RELOAD phase | v Dropping the definition of the table’s primary key
maintains a separate count for each table part. Rejected
| v Dropping the definition of the table’s unique key(s)
rows are not included in the count. Each count is
reported as a separate message at the end of the Problem Determination: Issue SQL SELECT against
LOAD or RELOAD phase. the catalog to determine which indexes and relations
exist against 'table-name'. Determine whether
The user can verify the number of records loaded or
reloaded into the table part. In REORG, it should match
| uniqueness of the primary key or unique key has been
guaranteed through omission or through faulty definition
the number of records unloaded for that table part. In
of an index.
LOAD, it should match the number of records
processed.
Chapter 18. DB2 Messages 473
DSNU306I • DSNU310I
System Action: Utility processing is terminated.
DSNU306I csect-name - UNABLE TO DRAIN
WRITERS FROM object-type object-name User Response: Examine the preceding DSNU650I
INTO TABLE statements. The key size and number of
Explanation: The utility was unable to drain the
indexes affected by each INTO TABLE statement are
writers from an object because the resource was
accumulative. The combination of these elements may
unavailable. The object is identified by type and name.
produce a list of index keys, including header bytes, that
Message DSNT500I tells why the resource was
is too large to be contained within the maximum size
unavailable. If the QUIESCE utility issues this message,
buffer area during the load of each input data record. It
DSNT500I is not issued, but message DSNT501I might
may be necessary to reduce the number of INTO
be issued.
TABLE statements or to drop some of the indexes that
Severity: 8 (error) are affected by the load.
System Action: Utility processing terminates.
DSNU309I csect-name NOT ALL REQUIRED
Problem Determination: Refer to message DSNT500I
UNIQUE INDEXES HAVE BEEN
or DSNT501I.
DEFINED FOR TABLE table-name
Explanation: The table ’table-name’ was created with
DSNU307I csect-name PARENT TABLE
unique index requirements. Not all of these indexes
parent-table-name OF table-name IN
have been defined.
RELATIONSHIP relationship-name HAS
AN INCOMPLETE TABLE DEFINITION Severity: 8
Explanation: The 'table-name' identifies the target System Action: Processing stops. No table in the
table of the job for the LOAD utility or the dependent table space is loaded.
table to be checked by the CHECK DATA utility. The
User Response: The user may resubmit the LOAD
'parent-table-name' identifies the parent table of the
job after either:
target table for the LOAD utility or the dependent table
for the CHECK DATA utility in RELATIONSHIP v Creating all the required unique indexes, or
'relationship-name'. The primary index of PARENT v Dropping the table and re-creating it without the
TABLE 'parent-table-name' has been dropped. unique index requirements.
This message is repeated for each incompletely defined Problem Determination: Determine which unique
parent table in each relationship where the target table indexes need to be created. Determine if the
is a child. uniqueness requirement for the table is valid.
Severity: 8 (error)
DSNU310I csect-name RECORD 'n' WILL BE
System Action: The LOAD and CHECK DATA utilities
DISCARDED DUE TO field-name
stop further processing. No data is loaded by the LOAD
CONVERSION ERROR FOR table-name
utility and no relationships are checked by the CHECK
DATA utility. Explanation: The load utility found the input data
provided for a field to be incorrect. The corresponding
User Response: Check the existence of the primary
input data set record 'n' will be placed in the DISCARDS
index and its parent tables identified by RELATIONSHIP
data set.
'relationship-name'.
Problem Determination: If the incompletely defined
| If the NOSUBS keyword was specified, it is possible
tables were targets of the LOAD job, message
| that the record was discarded because the input
DSNU305I has been issued for each such table. Refer
| contained a code point that when translated from the
to the catalog to determine if any tables in the table
| source CCSID to the target CCSID resulted in a
space that were not targets of the LOAD job are
| substitution character being placed in the target string.
incompletely defined. Severity: 4 (warning)
System Action: The input data set record is noted
DSNU308I csect-name INDEX KEY LIST RECORD and will be discarded in the DISCARD phase. The
LENGTH EXCEEDS MAXIMUM KEY LOAD utility continues to process additional records in
BUFFER SIZE the input data set.
Explanation: The length of the index key list that will User Response: Following the completion of the
be built in the Data Base Services address space while current LOAD utility invocation, examine the record in
loading a data record may be larger than the maximum the DISCARDS data set. Correct the error in the
key buffer size. The LOAD statement may be too discarded input data. Submit a RESUME(YES) LOAD
complex. invocation with the DISCARDS data set as the input
data set. Refer to DB2 Utility Guide and Reference for a
Severity: 8 (error)
474 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU311I • DSNU315I
definition of LOAD input field column specifications.
DSNU313I csect-name RECORD 'n' WILL BE
DISCARDED DUE TO PART OR HIGH
DSNU311I csect-name RECORD 'n' WILL BE KEY VALUESPECIFICATION(S)
DISCARDED DUE TO INVALID
Explanation: The discarded record does not belong to
field-name COLUMN SPECIFICATION
any of the partitions being loaded. For a LARGE table
Explanation: The load utility calculated the location of space, this might be because the key is higher than the
an input data value using the field specifications high key value specified for the last partition.
supplied and VARCHAR length fields present within the
Severity: 4 (warning)
input data set record. The calculated position for the
field was determined to be incorrect. System Action: The input data set record number is
noted and will be discarded in the DISCARD phase.
Severity: 4 (warning)
The LOAD utility continues to process additional records
System Action: The input data set record number is in the input data set.
noted and will be discarded in the DISCARD phase.
User Response: Following the completion of the
The LOAD utility continues to process additional records
current LOAD utility invocation, examine the record in
in the input data set.
the DISCARDS data set. Correct the error in the
User Response: Following the completion of the discarded input data, if one exists. Submit a
current LOAD utility invocation, examine the record in RESUME(YES) LOAD invocation with the DISCARDS
the DISCARDS data set. Correct the error in the data set as the input data set. Refer to Part 2 of DB2
discarded input data, if one exists. Otherwise, correct Utility Guide and Reference for a definition of LOAD
the input field specification. Submit a RESUME(YES) input field column specifications.
LOAD invocation, which uses the DISCARDS data set
System Programmer Response: Verify that the
and the verified LOAD utility statement and field
validation routine is correct.
specifications. Refer to DB2 Utility Guide and Reference
for a definition of LOAD input field column
specifications. DSNU314I csect-name RECORD 'n' WILL BE
DISCARDED DUE TO WHEN
SPECIFICATION(S)
DSNU312I csect-name RECORD 'n' WILL BE
DISCARDED DUE TO ERROR = Explanation: The discarded record satisfies none of
X'reason-code' FROM EXIT ROUTINE the WHEN selection expressions provided.
procedure-name FOR table-name
Severity: 4 (warning)
Explanation: The exit routine provided by your
System Action: The input data set record is noted
installation blocked the load of record 'n' into the table
and will be discarded in the DISCARD phase. The
indicated. The reason-code was set by the exit routine.
LOAD utility continues to process additional records in
Severity: 4 (warning) the input data set.
System Action: The input data set record number is User Response: Following the completion of the
noted and will be discarded in the DISCARD phase. current LOAD utility invocation, examine the record in
error is placed in the DISCARDS data set. The LOAD the DISCARDS data set. Correct the error in the
utility continues to process additional records in the discarded input data, if one exists. Submit a
input data set. RESUME(YES) LOAD invocation with the DISCARDS
data set as the input data set. Refer to DB2 Utility
User Response: Following the completion of the
Guide and Reference for a definition of LOAD input field
current LOAD utility invocation, examine the record in
column specifications. If FORMAT UNLOAD was
the DISCARDS data set. Correct the error in the
specified on the load statement, the WHEN
discarded input data, if one exists. Ensure that the exit
specifications are built internally. This ensures that the
routine provided is correct. Submit a RESUME(YES)
rows are loaded back into the same object from which
LOAD invocation, which uses the DISCARDS data set
they were unloaded. Refer to DB2 Utility Guide and
and the verified LOAD utility statement and field
Reference for a description of the FORMAT UNLOAD
specifications. Refer to DB2 Utility Guide and Reference
option of LOAD.
for a definition of LOAD input field column
specifications.
DSNU315I csect-name RECORD 'n' WILL BE
System Programmer Response: Verify that the
DISCARDED DUE TO UNEXPECTED
validation routine is correct.
ERROR
Explanation: The LOAD of input data set record
number 'n' was attempted but was not successful due to
an unexpected error.
Chapter 18. DB2 Messages 475
DSNU316I • DSNU320I
Severity: 8 (error)
DSNU318I csect-name RECORD 'n' WILL BE
System Action: If the error was caused because a DISCARDED DUE TO INVALID
resource was not available, a DSNT500I message will field-name COLUMN SPECIFICATION
be issued. FOR table-name
The utility step will be abended with a system X'04E' Explanation: The load utility calculated the location of
and an abend reason code of '00E40318'. If a an input data value using the field specifications
DSNT500I message is not issued, an SVC dump will be supplied and VARCHAR length fields present within the
requested. A SYSABEND dump of batch storage is also input data set record 'n'. The calculated position for the
requested. field was determined to be incorrect.
User Response: If a DSNT500I message was issued, Severity: 4 (warning)
refer to the description under that message number. If
System Action: The input data set record number is
the unavailable resource becomes available, the utility
noted and will be discarded in the DISCARD phase.
step is restartable.
The LOAD utility continues to process additional records
If there is no DSNT500I message, the error is an in the input data set.
unexpected internal error and you should consult your
User Response: Following the completion of the
system programmer.
current LOAD utility invocation, examine the record in
Operator Response: An operator with SYSOPR the DISCARDS data set. Correct the error in the
authority can issue a TERM UTIL to free any held discarded input data, if one exists. Otherwise, correct
resources if that is necessary. the input field specification. Submit a RESUME(YES)
LOAD invocation, which uses the DISCARDS data set
System Programmer Response: Refer to DB2 and the verified LOAD utility statement and field
Command Reference for information about the TERM specifications. Refer to DB2 Utility Guide and Reference
UTIL command. If you suspect an error in DB2, refer to for a definition of LOAD input field column
Part 2 of DB2 Diagnosis Guide and Reference for specifications.
information on identifying and reporting the problem.
DSNU319I csect-name RESUME(YES) WAS
DSNU316I csect-name - UNABLE TO DRAIN SPECIFIED FOR EMPTY PARTITION nn.
WRITERS FROM object-type object-name RESUME(NO) IS ASSUMED
PART part-num
Explanation: This message is issued in response to a
Explanation: The utility was unable to drain the class LOAD utility request containing a partition level
of writers from a partition of an object because the RESUME(YES) option. The RESUME(YES) option
resource was unavailable. The partition is identified by implies that the specified partition 'nn' is populated, but
object type (object-type), object name (object-name), in this case it was not. The message alerts the invoker
and partition number (part-num). Message DSNT500I to this fact, and continues as if RESUME(YES) was not
tells why the resource was unavailable. specified.
Severity: 8 (error) Severity: 4 (warning)
System Action: Utility processing terminates. System Action: The LOAD utility, in attempting to
Problem Determination: Refer to message honor the RESUME(YES), found the partition was
DSNT500I. empty, ignored the option, and continued as if
RESUME(NO) was specified.
DSNU317I csect-name DISCARD LIMIT HAS BEEN User Response: The user is alerted to the fact that
REACHED the requested partition was empty rather than populated
as the RESUME LOAD option implied.
Explanation: The DISCARDS limit specified on the
LOAD utility statement was reached.
DSNU320I csect-name RESUME(YES) WAS
Severity: 8 (error) SPECIFIED FOR AN EMPTY
System Action: Processing abends to allow users to TABLESPACE
increase the discard limit and restart the utility. Explanation: RESUME(YES) was specified within the
User Response: Increase the discard limit and restart LOAD utility statement. However, the RESUME(YES)
the utility. Otherwise -TERM the utility. Review the file of option implies that the specified table space is
input records provided to LOAD and review table populated.
definitions to determine why the number of records Severity: 4 (warning)
discarded exceeds expectations.
System Action: Processing continues. The LOAD
Problem Determination: See user response. utility, in attempting to honor the RESUME(YES), found
476 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU321I • DSNU325I
the table space empty, so ignored the option, and User Response: Determine if the input data contains
proceeded as if RESUME(NO) was specified. If this the nonnullable column as a field. If it does, change the
table is currently defined as COMPRESS YES, a field specification to include it. If the input data does not
dictionary is not built. contain the nonnullable column as a field, determine
which is in error, the input data or the column
User Response: The user is alerted to the fact that
specification. Make the corresponding correction.
the requested table space was empty rather than
Resubmit the job if that is still appropriate.
populated as the RESUME LOAD option implied. Use
the RESUME(NO) option if you want a compression System Programmer Response: Corrective
dictionary built. procedures may require that a table be dropped and
created again. Refer to Part 2 (Volume 1) of DB2
Administration Guide for a discussion of how this can be
DSNU321I csect-name CHECK PENDING ON
accomplished. Refer to DB2 Utility Guide and Reference
TABLESPACE tablespace-name
for a discussion of field specification constraints with
PROHIBITS PROCESSING
regard to nonnullable columns.
Explanation: The requested utility cannot be run
against a tablespace or tablespace partition in a check
DSNU324I csect-name DEFERRED STATUS OF
pending state.
INDEX SPACE creator-name.index-name
Severity: 8 (error) PROHIBITS PROCESSING
System Action: Processing terminates after the check Explanation: The requested utility cannot be run
pending states of all target tablespaces or partitions of against an index space or index space partition in a
the utility are analyzed. deferred state.
User Response: Remove the named tablespace or Severity: 8 (error)
partition from its check pending state by using the
System Action: Processing terminates after the
CHECK DATA or REPAIR utility. If you want more
deferred state of all target index spaces or index
information on the extent of questionable data in the
partitions of the utility are analyzed.
table space, query the SYSTABLES and
SYSTABLEPART catalog tables. User Response: The deferred state can be removed
through recovery or rebuild of the index space or the
physical index partition. It can also be removed by the
DSNU322I csect-name DEFERRED STATUS OF
-START DATABASE command with ACCESS(RW) or
TABLE SPACE database-name.table-
ACCESS(RO). The RECOVER or REBUILD INDEX
space-name PROHIBITS PROCESSING
utility can be run at either the index space or index
Explanation: The requested utility cannot be run partition level. If more information on the status of the
against a table space or table space partition in a index space is required, use the -DISPLAY DATABASE
deferred state. command.
Severity: 8 (error)
DSNU325I csect-name - AN INVALID SQL/DS
System Action: Processing terminates after the FORMAT RECORD WAS
deferred state of all target table spaces or table space ENCOUNTERED
partitions of the utility are analyzed.
Explanation: The LOAD utility detected an invalid
User Response: To remove the deferred state, use SQL/DS format record type.
the RECOVER TABLESPACE, LOAD REPLACE utility,
or -START DATABASE command with ACCESS(RW) or Severity: 8 (error)
ACCESS(RO). If you want more information on the
System Action: Utility execution is terminated.
status of the table space, use the -DISPLAY DATABASE
command. User Response: Correct the input data and resubmit
the job. Data that has been transmitted from an SQL/DS
unload disk data set in a VM/370 system may have
DSNU323I csect-name COLUMN ccc IS OMITTED
extra block descriptors and record descriptors at the
Explanation: The column 'ccc' is a nonnullable column beginning of each record. Ensure that this situation
and is not being loaded. Field specifications must does not exist.
include all nonnullable columns. The identified column
Problem Determination: Refer to Part 2 (Volume 1) of
name was missing from the field specification.
DB2 Administration Guide for additional information
Severity: 8 (error) regarding loading data from SQL/DS and resubmitting a
partially completed load step.
System Action: Further utility processing is
terminated.
Chapter 18. DB2 Messages 477
DSNU326I • DSNU331I
description of the partition-level RESUME option of
DSNU326I csect-name - USER NOT AUTHORIZED
LOAD.
FOR LOAD REPLACE ON
TABLESPACE System Programmer Response: Determine whether
the partition should be empty. If it should, use SQL
Explanation: The indicated user attempted to use the
DELETE to empty it. Otherwise, instruct the user to use
REPLACE option of LOAD, and it will reset to empty all
the RESUME(YES) option for that partition.
tables in the table space before loading data. This
option requires load authorization on each table in the
table space, but the user did not have authority for one DSNU329I csect-name - FIELD field-name IS NOT
or more tables. DEFAULTABLE
Severity: 12 (severe error) Explanation: You specified a NULLIF or DEFAULTIF
field specification option for:
System Action: When LOAD REPLACE validation
v A column defined to be not nullable or not defaultable
encounters the first nonauthorized table in the table
v A field with no column counterpart.
space, the job step is terminated.
Severity: 8 (error)
User Response: Obtaining the LOAD on DATABASE
privilege for the database will allow you to proceed System Action: The utility abends to allow restart.
using the REPLACE option. The other alternative is to
first delete all rows from the tables which are to be User Response: Determine whether the field
loaded, and then use the RESUME option instead of specification refers to the correct column. If it does,
the REPLACE option. remove the NULLIF option from the field specification,
and restart the job. Alternatively, TERM the utility. Refer
to DB2 Utility Guide and Reference for LOAD NULLIF
DSNU327I csect-name TABLE b IS NOT IN SAME option constraints.
TABLESPACE AS TABLE a
Explanation: All tables that are the subject of a single DSNU330I csect-name TABLESPACE IS NOT
LOAD utility statement must belong to the same table EMPTY
space.
Explanation: The RESUME keyword either specified
Severity: 8 (error) or defaulted to a value of 'NO', which requires an empty
table space. However, the LOAD command named a
System Action: Further utility processing is
table space that was not empty.
terminated.
Severity: 8 (error)
User Response: Remove the INTO TABLE control
statement that specifies TABLE 'b' from the current System Action: Further utility processing is
LOAD request. If the data is to be loaded into TABLE terminated.
'b', create another LOAD utility statement that contains
the INTO TABLE control statement for TABLE 'b' and User Response: Determine why the assumption of an
resubmit the job. empty table space was wrong. This may require
consultation with the system programmer. Either remove
the current table(s) rows using an SQL DELETE, or
DSNU328I csect-name CANNOT PROCESS THE change the LOAD option to RESUME YES. Resubmit
NON-EMPTY PARTITION nn WITH the job. Refer to DB2 Utility Guide and Reference for a
RESUME(NO). PROCESSING definition of the RESUME option of LOAD.
TERMINATES
System Programmer Response: If the table space is
Explanation: The partition level RESUME keyword used by more than one application, determine whether
either specified or defaulted to a value of NO, which the table space should be empty. If it should be, use
requires the partition to be empty. However, the LOAD SQL DELETE to make it empty. Otherwise, instruct the
command named partition 'nn', which was not empty. user to use the RESUME(YES) option.
Severity: 8 (error)
DSNU331I csect-name FIELD LISTS ARE NOT
System Action: Further utility processing is
ALLOWED WITH FORMAT KEYWORD
terminated.
Explanation: LOAD field specifications are
User Response: Determine why the assumption of an
incompatible with the FORMAT option.
empty partition was wrong. This may require
consultation with the system programmer. Either remove Severity: 8 (error)
the current partition’s rows using an SQL DELETE, or
change the LOAD option to RESUME YES. Resubmit System Action: Further utility processing is
the job. Refer to DB2 Utility Guide and Reference for a terminated.
User Response: Determine whether the field
478 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU332I • DSNU334I
specifications or the FORMAT option is correct.
DSNU334I csect-name INPUT FIELD ffffffff INVALID
Eliminate whichever is incorrect, and resubmit the job.
FOR tttttttt, ERROR CODE cc
Refer to DB2 Utility Guide and Reference for a definition
of the LOAD FORMAT option constraints. Explanation: The LOAD utility found the input data
provided for field ffffffff in table tttttttt to be incorrect. The
error code cc, if present, identifies the problem. Possible
DSNU332I csect-name - INPUT VALUE X'hex-data'
error codes are:
OUT OF RANGE FOR COLUMN
'column-name' 01 Input numeric value is out of the range for the
table column.
Explanation: The LOAD utility detected a numeric
value outside of the range of permissible values for the 02 Input numeric field contains invalid numeric
column in the DB2 table. A loss of significant digits data.
results if the LOAD process continues. The input data
03 There was an error converting input numeric
type is SMALL INTEGER, INTEGER, DECIMAL, or
data to floating-point data.
FLOAT and is displayed in hexadecimal.
04 Input packed decimal data is in error.
Severity: 8 (error)
05 Input is too long for a date column.
System Action: Further utility processing is terminated
unless DISCARD processing is active. 06 Input is too short for a date column.
User Response: Correct the input data and resubmit 07 Input is too long for a time column.
the job. Make sure that the 'field specification' on the
LOAD statement is consistent with the table definition 08 Input is too short for a time column.
and the input data. This might mean changing: 09 Input is too long for a time stamp column.
v The table definition
v The LOAD statement 10 Input is too short for a time stamp column.
v The input data. 11 Input character field is too long for the table
column.
Refer to DB2 Utility Guide and Reference to determine
input constraints. Refer to Part 2 (Volume 1) of DB2 12 Input variable character field is too long for the
Administration Guide for information on resubmitting a table column.
partially completed LOAD step. 13 Input is out of range for the date/time column.
14 Input is invalid for the date/time column.
DSNU333I csect-name - INPUT VALUE
'ebcdic-data' OUT OF RANGE FOR 15 Input length is incorrect for numeric column.
COLUMN 'column-name' 16 Input contains a blank character.
Explanation: The LOAD utility detected a numeric 17 Input is too long for a graphic column.
value outside the range of permissible values for the
column in the DB2 table. A loss of significant digits 18 Input is invalid for a graphic column.
results if the LOAD process continues. The input data
19 Input is too long for the table column after a
type is INTEGER EXTERNAL, DECIMAL EXTERNAL,
required CCSID conversion.
or FLOAT EXTERNAL.
20 Input contained an invalid code point for a
Severity: 8 (error)
required CCSID conversion.
System Action: Further utility processing is
21 Input does not conform to the rules for valid
terminated.
data for a required CCSID conversion.
User Response: Correct the input data and resubmit
22 Input causes an error during CCSID
the job. Make sure that the 'field specification' on the
conversion. An example of this type of error
LOAD statement is consistent with the table definition
would be an error in a user exit routine.
and the input data. This might mean changing:
v The table definition | 23 Input is invalid for a rowid column.
v The LOAD statement
v The input data.
| 24 Input contained a code point that when
| translated from the source CCSID to the target
| CCSID resulted in a substitution character
Refer to DB2 Utility Guide and Reference to determine
| being placed in the target string. This condition
input constraints. Refer to Part 2 (Volume 1) of DB2
| can occur when the NOSUBS keyword was
Administration Guide for information on resubmitting a
| specified and no discard data set was
partially completed LOAD step.
| specified.
Chapter 18. DB2 Messages 479
DSNU335I • DSNU338I
| 25 The range of values for an identity column is System Action: Further utility processing is
| exhausted. terminated.
Severity: 8 (error) User Response: Correct the 'nullif' specification and
resubmit the job. Refer to DB2 Utility Guide and
System Action: Further utility processing is
Reference for a description of 'nullif' field selection
terminated.
options and Part 2 (Volume 1) of DB2 Administration
User Response: Correct the input data and resubmit Guide for information on resubmitting a partially
the job. Make sure that the 'field specification' on the completed LOAD step.
LOAD statement is consistent with the table definition
and the input data. This might mean changing:
DSNU337I csect-name RECORD(n),
v The table definition
CONCATENATED CONTINUEIF
v The LOAD statement
RECORD IS TOO LARGE
v The input data.
Explanation: The CONTINUEIF option was specified
Refer to DB2 Utility Guide and Reference to determine during LOAD to concatenate multiple physical records
input constraints. Refer to Part 2 (Volume 1) of DB2 into one logical record for loading. The resultant
Administration Guide for information on resubmitting a concatenated record is too large to be processed. The
partially completed LOAD step. maximum length allowed is 32767 bytes.
Severity: 8
DSNU335I csect-name INPUT FIELD 'ffffffff' NOT
System Action: When discard processing is specified,
ENTIRELY WITHIN INPUT RECORD
the input data set logical record is noted and will be
Explanation: The LOAD utility found that the input discarded in the DISCARD phase. The LOAD utility
field 'ffffffff' extends beyond the end of the input record. continues to process additional records in the input data
set, and the severity level is 4. When discard process is
If DISCARDS processing is active, the message not specified, the severity is 8 and the LOAD utility will
severity is 4 (warning). terminate.
Severity: 4 (warning) or 8 (error) User Response: When discard processing is
System Action: For fixed length records, with no specified, following the completion of the current LOAD
VARCHARs included, the length needed by the LOAD utility invocation, examine the record in the DISCARDS
utility can be calculated before processing. In this case, data set. Correct the error in the discarded input data,
when the LOAD utility determines that no records can and submit a RESUME(YES) LOAD invocation with the
be loaded because ALL of the INTO TABLE statements DISCARDS data set as the input data set. When
require input longer than the defined lengths, the LOAD discard processing is not specified: correct the error in
job terminates on the first record without discarding any the input data set and rerun the job.
records. Further utility processing with mixed or System Programmer Response: If you suspect an
non-fixed length records is terminated unless error in DB2, refer to Part 2 of DB2 Diagnosis Guide
DISCARDS processing is active. and Reference for information on identifying and
User Response: Correct the input data and resubmit reporting the problem.
the job. Make sure that the 'field specification' on the Problem Determination: Collect the following
LOAD statement is consistent with the table definition diagnostic items: “Appendix B. Problem determination”
and the input data. This might mean changing: on page 1281: 1, 2, 5.
v The table definition
v The LOAD statement
v The input data. DSNU338I csect-name INVALID COLUMN
SPECIFICATION FOR column name
Refer to DB2 Utility Guide and Reference to determine Explanation: The LOAD utility found the dynamically
input constraints. Refer to Part 2 (Volume 1) of DB2 determined column location for an input field to be
Administration Guide for information on resubmitting a incorrect.
partially completed LOAD step.
Severity: 8 (error)
DSNU336I csect-name INVALID nullif System Action: The utility abends to allow restart.
SPECIFICATION FOR INPUT FIELD
User Response: Correct the input field specification or
ffffffff
the input data and restart the job. Alternatively, TERM
Explanation: The LOAD utility found the 'nullif' field the utility.
specification to be incorrect.
Severity: 8 (error)
480 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU339I • DSNU342I
DSNU339I csect-name INVALID CONTINUEIF DSNU341I csect-name - IMAGE COPY MUST BE
SPECIFICATION TAKEN BEFORE REORG CAN BE RUN
ON A DB2 CATALOG OR DIRECTORY
Explanation: The CONTINUEIF clause of a LOAD
TABLE SPACE
utility extends beyond the end of the input record.
Explanation: The DB2 catalog or directory table space
Severity: 8 (error)
being reorganized does not have an image copy that
System Action: The LOAD utility is terminated. the RECOVER utility can use to recover the table space
to currency. Before running the REORG utility, you must
User Response: Correct the CONTINUEIF clause. run the COPY utility to create an image copy. This
The column specification must be reduced and/or the prevents having to recover the DB2 catalog or directory
value being compared must be shortened. The value table space to a prior point in time if a problem occurs
being compared must be entirely within the input record. during REORG processing.
Severity: 8
DSNU340I csect-name - ERROR LOADING INDEX,
DUPLICATE KEY, INDEX=index-name, System Action: Processing terminates
TABLE=table-name, RID OF INDEXED
User Response: Run the COPY utility to create an
ROW=rid-of-indexed-row, RID OF
image copy of the DB2 catalog or directory table space.
NON-INDEXED ROW=rid-of-non-indexed-
If more than one catalog or directory table space is to
row
be reorganized, consider using the QUIESCE and
Explanation: A duplicate key was found while building COPY utilities for the set of table spaces to be
the indicated index during the BUILD phase of the reorganized.
REORG or REBUILD INDEX utility. This violates the
Use the REPORT utility to view the recovery information
uniqueness rule for that index.
related to the table space. The output from the
Severity: 8 (error) REPORT utility should indicate either the absence of an
image copy, or the presence of a REORG LOG NO
System Action: All duplicate index entries of the SYSCOPY record.
indicated index are reported and the index is in
RECOVERY PENDING status. Duplicate rows are
present in the indexed table. DSNU342I csect-name ERROR LOADING INDEX,
ERROR = Xreason-code, INDEX =
Utility processing continues with any other utility index-name
functions within the utility job step.
Explanation: The LOAD, REORG or REBUILD INDEX
User Response: Duplicate rows are present in the utility encountered a processing error, which it could not
indexed table. The system programmer should be correct, while extending the index identified by
informed, so that any applications that are dependent 'index-name'. Refer to “Part 4. DB2 Codes” on page 707
upon the uniqueness of the table rows are not initiated for an explanation of the code given in 'reason-code'.
until corrective action has been taken.
Severity: 8 (error)
Operator Response: Notify the system programmer.
System Action: The building of index entries for the
System Programmer Response: Steps should be indicated index is not completed. An SVC dump of the
taken to inhibit any further processing until the index is database services address space is requested for
repaired. If the nonunique keys are correct, DROP and diagnostic purposes. The extension of other indexes
recreate the index as nonunique. If the records with associated with the tables being loaded is attempted.
duplicate keys should not be in the table, use REPAIR Any subsequent attempt to use the index directly or
DELETE to remove the erroneous rows. Use the RID indirectly will cause the invoker to abend.
values provided in this message as input to the REPAIR
utility. After the duplicate data rows are removed or the User Response: If the indexed table is used by more
unique index has been dropped, issue the -DISPLAY than one application, the system programmer should be
DATABASE command with RESTRICT against the informed so that applications that insert rows into, or
target database. Use the REBUILD INDEX utility to delete rows from, the table or use the index directly are
recover any indexes that are in the REBUILD pending inhibited until corrective action is taken.
state. CHECK INDEX can be run to verify that the data
Normal corrective action would be to use the REBUILD
and indexes are consistent.
INDEX utility option to reconstruct the index after the
Problem Determination: Use REPAIR LOCATE RID processing problem identified by the reason code has
DUMP to view the records with duplicate keys. been resolved. Alternatively, the index can be dropped
SQLSELECT may fail due to the inconsistent index. Use and then created again, unless the index in question is
CHECK INDEX to check the validity of the index. the partitioning index.
Operator Response: The table space in question
Chapter 18. DB2 Messages 481
DSNU343I • DSNU347I
might need to be stopped and started for utility-only
DSNU345I csect-name UNIQUE INDEX KEY
processing to inhibit attempted application use of the
DUPLICATES KEY FROM INPUT
defective index.
DATASET RECORD iiii LOADED AT RID
System Programmer Response: If the index is used rrrr INDEX = index-name TABLE =
by more than one application, applications that either table-name RECNO = recno RID = duprid
insert rows into, or delete rows from, the indexed table
Explanation: Input data set record recno was loaded
or use the index to access rows must be inhibited from
into table table-name at RID duprid, but it causes a
executing. One way to accomplish this is to place the
unique index violation for index index-name. It
table space in question under utility only processing
duplicates the key value of another record in the load
control via the -START and -STOP DATABASE
job: the record loaded at RID rrrr from input data set
commands until the REBUILD INDEX utility is executed.
record iiii.
Alternatively, the index can be dropped. Application
Severity: 4 (warning)
execution can then proceed, and the index can be
created again (unless the index was the partitioning System Action: Processing continues. Index entries
index). If you suspect an error in DB2, refer to Part 2 of are not created for either record. Both records will be
DB2 Diagnosis Guide and Reference for information on deleted in a subsequent phase of processing.
identifying and reporting the problem. Refer to “Part 4.
DB2 Codes” on page 707 to determine the processing
DSNU346I csect-name RECORD(n),
error indicated by the reason code. For a discussion of
CONCATENATED SQL/DS RECORD IS
how a table can be dropped and created again, or what
TOO LARGE
to do if a partitioning index is damaged, refer to the
discussion of LOAD processing in Part 2 (Volume 1) of Explanation: A LOAD utility was executing with
DB2 Administration Guide. FORMAT SQL/DS input data. Multiple spanned
segments of the input data were concatenated into one
logical record for loading. The resultant concatenated
DSNU343I csect-name - BUILD PHASE
record is too large to be processed. The maximum
STATISTICS. nnn DUPLICATE KEY
length allowed is 32764 bytes.
ERRORS ENCOUNTERED
Severity: 4 or 8
Explanation: The count of duplicate key errors
encountered during processing is 'nnn'. System Action: When discard processing is specified,
the input data set logical record is noted and is
Severity: 4 (warning) or 8 (error)
discarded in the DISCARD phase. The LOAD utility
System Action: Processing continues. For the LOAD continues to process additional records in the input data
utility, the records causing the duplicate key errors will set and the severity is 4. When discard processing is
be deleted in a subsequent phase. not specified, the severity is 8 and the LOAD utility
terminates.
DSNU344I csect-name - UNIQUE INDEX KEY User Response: When discard processing is
DUPLICATES KEY OF INDEXED ROW specified, examine the records in the DISCARDS data
AT RID rrrr INDEX = index-name TABLE set after the LOAD utility completes. Correct the error in
= table-name RECNO = the discarded input data. Then run the LOAD utility with
input-dataset-record-number RID = duprid the RESUME YES option using the DISCARDS data set
as input. When discard processing is not specified,
Explanation: The input data set record indicated was
correct the error in the input data set and rerun the job.
loaded into table table-name at RID duprid, but it
causes a unique index violation for index index-name. It System Programmer Response: If you suspect an
duplicates the key value of a record already in the table error in DB2, refer to Part 2 of DB2 Diagnosis Guide
at RID rrrr. and Reference for information on identifying and
reporting the problem.
Severity: 4 (warning)
Problem Determination: Collect the following
System Action: Processing continues. No index entry
diagnostic items listed in “Appendix B. Problem
is created for the record at RID duprid. The record will
determination” on page 1281: 1, 2, 5.
be deleted in a subsequent phase of processing.
DSNU347I csect-name DEADLINE =
yyyy-mm-dd-hh.mm.ss.mmmmmm
Explanation: This message applies only to REORG
with SHRLEVEL REFERENCE or CHANGE. It
supplements message DSNU105I, which can appear for
any utility (including REORG).
482 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU348I • DSNU352I
This message is issued in response to a -DISPLAY Severity: 0 (informational)
UTILITY command.
System Action: This message indicates the number
It is also issued by the REORG utility if the user of index key entries that were submitted to the DB2
specified SHRLEVEL REFERENCE or CHANGE and data manager to build the indicated index. Both unique
DB2 estimates that the switch phase will not start by the and nonunique key entries are counted. Rejected key
deadline specified by the DEADLINE phrase. entries are not counted.
This message indicates the most recently specified User Response: The user can verify that the number
values of the DEADLINE parameter to REORG. For this reported is consistent with expectations. For example,
parameter, a previous invocation of the -ALTER the user can determine if it matches the number of
UTILITY command might have specified a value. If no records loaded for the table indexed by the indicated
previous invocation of -ALTER UTILITY has specified a index.
value, then the most recently specified value is the
value that was specified with the invocation of the
DSNU350I csect-name - EXISTING RECORDS
REORG utility.
DELETED FROM TABLESPACE
yyyy-mm-dd-hh.mm.ss.mmmmmm indicates a
Explanation: A LOAD utility execution, in which
timestamp, according to the most recently specified
REPLACE was specified, has deleted all records from
value of DEADLINE.
the specified table space.
Severity: 0 (informational)
Severity: 0 (informational)
System Action: The message reflects the state of
System Action: Processing continues.
DB2 at the time of the -DISPLAY UTILITY command or
the time when DB2 estimated that the switch phase
would not start by the deadline specified by the DSNU351I csect-name - ’reorg-option’ OPTION IS
DEADLINE phrase. NOT APPLICABLE FOR A DB2
CATALOG OR DIRECTORY TABLE
If this message was issued for -DISPLAY UTILITY, the
SPACE. THE OPTION IS IGNORED.
system continues processing. If an -ALTER UTILITY
command is then executed, a subsequent -DISPLAY Explanation: The identified option does not apply
UTILITY command would reflect the results (if any) of when reorganizing one of the following DB2 catalog or
the -ALTER UTILITY command. directory table spaces:
DSNDB06.SYSDBASE
DSNDB06.SYSDBAUT
DSNU348I csect-name BUILD PHASE STATISTICS.
DSNDB06.SYSGROUP
NUMBER OF KEYS = nnnnnnnn FOR
DSNDB06.SYSPLAN
INDEX index-name PART part-num
DSNDB06.SYSVIEWS
Explanation: This message is issued by the BUILD DSNDB01.DBD01
phase of the REBUILD INDEX utility to report the total
number of index key entries used to build the indicated These table spaces are processed differently than other
index partition. table spaces and, consequently, do not make use of the
specified reorg-option.
Severity: 0 (informational)
Severity: 4 (warning)
System Action: This message indicates the number
of index key entries submitted to the DB2 data manager System Action: The option is ignored and processing
to build the indicated index partition. Both unique and continues.
nonunique key entries are counted. Rejected key
entries are not counted. User Response: None is required. However, you can
remove the option from the utility input statement.
User Response: The user can verify that the number
reported is consistent with expectations.
DSNU352I EXISTING RECORDS DELETED FROM
TABLESPACE PARTITION x
DSNU349I csect-name BUILD PHASE STATISTICS.
NUMBER OF KEYS = nnnnnnnn FOR Explanation: A LOAD utility execution, in which PART
index-name 'x' REPLACE was specified, has deleted all data
records from partition 'x'. Index records over partition 'x'
Explanation: This message is issued by the BUILD will be deleted in a subsequent phase of processing.
phase of the LOAD, REORG or REBUILD INDEX utility.
The message is repeated for each index built by the Severity: 0 (informational)
LOAD, REORG or REBUILD INDEX utility. It indicates System Action: Processing continues.
the total number of index key entries used to build the
indicated index.
Chapter 18. DB2 Messages 483
DSNU353I • DSNU358I
Severity: 4 (warning)
DSNU353I csect-name RECORD 'n' WILL BE
DISCARDED DUE TO CHECK System Action: Processing continues.
CONSTRAINT constraint-name
VIOLATION ON TABLE table-name User Response: Compare the number of duplicate
key errors corrected in the INDEXVAL phase to the
Explanation: The discarded record violates the check number of duplicate key errors detected in the BUILD
constraint named constraint-name defined on table phase (reported by message DSNU343I). If the counts
table-name. The record is not loaded and is discarded are unequal, notify the system programmer.
during the DISCARD phase.
If the counts are equal, following the LOAD utility
Severity: 4 (warning) execution, examine the discards file or the LOAD error
summary to determine which input data set records
System Action: The LOAD utility continues to process
caused the unique index violations. Revise the input
additional records in the input data set.
records so they will not introduce duplicate values into
User Response: After the LOAD utility completes, unique indexes and reapply the input records to the
examine the record in the DISCARDS data set. Correct table space. Alternatively, if appropriate, make the index
the error in the discarded input data. Submit a nonunique and reapply the rejected records to the table
RESUME(YES) LOAD job with the DISCARDS data set space.
as the input data set.
System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
DSNU354I csect-name RECORD 'n' VIOLATES and Reference for information on identifying and
CHECK CONSTRAINT constraint-name reporting the problem.
ON TABLE table-name
Problem Determination: Collect the following
Explanation: The LOAD utility cannot load record n diagnostic items listed in “Appendix B. Problem
into table table-name because the check constraint determination” on page 1281: 1, 5.
constraint-name would be violated. The record is not
loaded.
DSNU356I csect-name INDEXVAL PHASE
Severity: 8 (error) COMPLETE, ELAPSED TIME =
hh/mm/ss
System Action: Processing terminates. An abend is
requested so that the LOAD can be restarted after the Explanation: The INDEXVAL phase of the LOAD
error condition is corrected. utility has completed normally. The elapsed time for the
execution was 'hh' hours, 'mm' minutes, and 'ss'
User Response: Find the failing record in the input
seconds.
data set, correct the condition that caused the check
constraint to be violated, and restart the LOAD utility. Severity: 0 (informational)
You can optionally include a SYSDISC DD statement in
the JCL input to hold copies of records that are not
DSNU357I csect-name - ’LOG NO’ OPTION
loaded.
REQUIRED FOR DB2 CATALOG AND
DIRECTORY TABLE SPACES
DSNU355I csect-name INDEXVAL PHASE
Explanation: The LOG NO option must be specified
STATISTICS - nnn DUPLICATE KEY
when reorganizing a DB2 catalog or directory table
ERRORS CORRECTED BY DELETING
space.
rrr DATA ROWS
Severity: 8 (error)
Explanation: This message reports the results of the
INDEXVAL phase of the LOAD utility. Data rows which System Action: Processing terminates.
were added during the LOAD or RELOAD phase of this
LOAD utility invocation have been deleted because they User Response: Add the LOG NO option to the utility
caused unique index violations in the BUILD phase. A input statement.
total of 'rrr' data rows were deleted to correct 'nnn'
unique index violations. DSNU358I csect-name - ’UNLOAD ONLY’ OPTION
Unique index violations are counted in one of two ways. NOT VALID FOR DB2 CATALOG OR
An input data set record which has a value for a DIRECTORY TABLE SPACE
uniquely indexed column that duplicates a value that Explanation: The UNLOAD ONLY option is not
existed in the index prior to the LOAD job is counted as permitted for DB2 catalog or directory table spaces.
one duplicate key error. Two input data set records
which have like values for a uniquely indexed column Severity: 8
are counted as two unique index errors (that is, each of System Action: Processing terminates.
the two input data set records is in error).
484 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU359I • DSNU360I
User Response: Determine the purpose for using the 2 In the switch phase, it renames the shadow
UNLOAD ONLY option. There might be alternative ways data set from the shadow name to the original
of accomplishing the required function (for example, the name
UNLOAD PAUSE option).
3 In the utilterm phase, it renames the original
data set from the temporary name to the
DSNU359I KEYWORD 'SORTKEYS' SPECIFIED shadow name (for user-managed data sets). It
BUT NO INDEX OR FOREIGN KEYS deletes the temporary for DB2-managed data
EXIST, KEYWORD IS IGNORED sets.
Explanation: The 'SORTKEYS' keyword was specified
If a -TERM UTILITY command is issued after any
for a LOAD or REORG utility job; however, it was found
renaming, or a restart of the REORG switch phase
that no index and no foreign keys were defined for any
occurs after any renaming, the data set names revert
of the tables being loaded or reorganized. The keyword
back to their original form prior to the renaming:
is ignored and processing continues normally.
4 The original data set from the shadow name to
Severity: 0 (informational)
the temporary name
System Action: Processing continues normally.
5 The shadow data set from the original name to
User Response: If an index or foreign keys were the shadow name
expected to be found for the table or tables being
6 The original data set from the temporary name
loaded or reorganized, determine the reason the index
to the original name
or foreign keys could not be found.
Problem Determination: Probably a user error. The context code indicates the specific type of error:
Determine if an index should be defined on any of the
tables in the table space, or if foreign keys should be 1 During the switch phase of REORG, on
defined. If so, define the index or foreign keys; rename 1, REORG detected that a data set
otherwise, remove the 'SORTKEYS' keyword from the with a temporary name already exists. This
utility statement if necessary. error condition can arise for a DB2-managed or
user-managed data set.
DSNU360I csect-name - IN REORG WITH 2 During the switch phase of REORG, on
SHRLEVEL REFERENCE OR CHANGE, rename 2, REORG detected that a data set
DATA SET name EXISTS, CONTEXT=c with a original name already exists. This error
condition can arise for a DB2-managed or
Explanation: For the area (table space or partition) user-managed data set.
being reorganized, REORG with SHRLEVEL
REFERENCE or CHANGE unloads data from the 3 During the utilterm phase of REORG, on
original data sets and reloads data into shadow data rename 3, REORG detected that a data set
sets. REORG then exchanges the names of the original with a shadow name already exists. This error
and shadow data sets, using temporary names during condition can arise for a user-managed data
the renaming. The original name of a data set is in the set.
form “catname.DSNDBx.dbname.psname.I0001.Annn”. 4 During switch phase restart or a -TERM
The shadow name of a data set is in the form UTILITY during the switch phase, on rename 4
| “catname.DSNDBx.dbname.psname.J0001.Annn”. The (while reverting back to the original name),
temporary name of a data set is in the form -TERM UTILITY detected that a data set with a
“catname.DSNDBx.dbname.psname.T0001.Annn”. temporary name already exists. This error
REORG uses such data sets for indexes as well as condition can arise for a DB2-managed or
data. user-managed data set.
During its initialization, REORG cannot execute if: 5 During switch phase restart or a -TERM
v Data sets with the temporary names already exist. UTILITY during the switch phase, on rename 5
v DB2-managed data sets with the shadow names (while reverting back to the original name),
already exist. -TERM UTILITY detected that a data set with a
shadow name already exists. This error
v User-managed data sets with the shadow names do condition can arise for a DB2-managed or
not already exist. user-managed data set.
To exchange the names of the original and shadow data 6 During switch phase restart or a -TERM
sets, REORG performs the following renaming: UTILITY during the switch phase, on rename 6
(while reverting back to the original name),
1 In the switch phase, it renames the original -TERM UTILITY detected that a data set with a
data set from the original name to the original name already exists. This error
temporary name
Chapter 18. DB2 Messages 485
DSNU361I • DSNU363I
condition can arise for a DB2-managed or for the relationship with the name r1.
user-managed data set.
Severity: 4 (warning)
8 During initialization of REORG, REORG
System Action: Processing continues.
detected that a data set with a temporary name
already exists. This error condition can arise User Response: None required. The constraint
for a DB2-managed or user-managed data set. violation described will be rectified later in processing.
Severity: 8 (error)
DSNU362I csect-name - IN REORG WITH
System Action: For context code 1, or 2, the utility job
SHRLEVEL CHANGE, LOG HAS
step that caused the function to be requested abends
BECOME SHORT, BUT MAXRO IS
with code 00E4031B. The utility job is placed in the
DEFER, MEMBER=member-name,
stopped state.
UTILID=utilid
For context code 3, the utility job step that caused the
Explanation: In execution of the REORG utility with
function to be requested continues without performing
SHRLEVEL CHANGE, if the value of MAXRO is
this renaming.
DEFER, and the actual time for an iteration and the
For context code 4, 5, or 6, the object is left in a estimated time for the next iteration are both less than 5
recovery pending state, -TERM UTILITY continues to seconds, then DB2 adds a 5 second pause to the next
undo renaming, and a message is issued. The objects iteration. This pause limits the utility's consumption of
and messages are as follows: processor time.
v If the data set is part of a nonpartitioned table space, Within an execution of REORG, the first time that this
the object is the table space, and the message is situation occurs, DB2 produces this message, which
DSNU562I. announces the pause. On all later occurrences of this
v If the data set is part of a partition of a table space, situation, DB2 still adds the pause, but DB2 sends the
the object is the partition, and the message is message only if DB2 has not sent the message (for this
DSNU560I. execution of REORG) within the past 30 minutes. This
v If the data set is part of a nonpartitioned index, the is a WTO message; it is sent to the console, but it is not
object is the index, and the message is DSNU557I. an action message. It is not sent to SYSPRINT.
v If the data set is part of a partition of a partitioned In a data sharing environment, member-name identifies
index, the object is the partition of the index, and the the DB2 member. In a non-data-sharing environment,
message is DSNU559I. member-name is blank. utilid identifies the utility job
step.
For context code 8, REORG does not execute.
Severity: 0 (informational)
User Response: For context code 1 or 2, you can
System Action: REORG continues execution, with a 5
choose between these actions:
second pause. If the conditions in the explanation
v Delete the data set; then RESTART the utility. above continue to be true, DB2 will continue adding 5
v TERM the utility. Delete the data set before trying to second pauses.
execute REORG again with SHRLEVEL
User Response: If you have been planning to wait for
REFERENCE or CHANGE.
an appropriate time to execute the -ALTER UTILITY
command to choose the value of MAXRO and thus
For context code 3, if you want to perform the cause REORG to finish, now might be an appropriate
renaming, delete the data set with the shadow name time. However, you are not required to take any action.
and then perform the renaming.
Operator Response: If you have been planning to
For context code 4, 5, or 6, execute the RECOVER or wait for an appropriate time to execute the -ALTER
REBUILD INDEX utility; then delete the shadow and UTILITY command to increase the value of MAXRO and
temporary data sets (if they still exist). thus cause REORG to finish, now might be an
appropriate time. However, you are not required to take
For context code 8, delete the data set and then any action.
execute REORG.
DSNU363I csect-name - ENFORCE PHASE
DSNU361I csect-name FOREIGN KEY HAS NO STATISTICS - RELATIONSHIP r1
PRIMARY KEY FOR RELATIONSHIP=r1 FOREIGN KEYS CHECKED=n
INPUT RECORD NUMBER=nnnn, CONSTRAINT VIOLATIONS
RID=Xrrrr ENCOUNTERED=m
Explanation: Input record nnnn caused a row to be Explanation: This message provides statistics for the
loaded into table table at RID rrrr with no primary key enforce phase of the load utility. For relationship 'r1', the
486 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU364I • DSNU369I
number of foreign keys checked is 'n'. The number of
DSNU367I csect-name - ENFORCE PHASE
constraint violations found is 'm'.
STATISTICS - n ROWS DELETED FROM
Severity: 0 (informational) TABLE t
System Action: Processing continues. Explanation: This message reports the results of the
ENFORCE phase of the LOAD utility. Data rows added
during the RELOAD phase of the LOAD utility have
DSNU364I csect-name PARTITIONS WILL BE been deleted because they contained foreign keys
LOADED IN PARALLEL, NUMBER OF which did not have a corresponding primary key. A total
TASKS = nnnn of n data rows were deleted from table t.
Explanation: This message is issued by the RELOAD Primary errors may cascade and remove additional
phase of the LOAD utility. The message indicates that records. The count is the sum of both primary and
the LOAD utility is able to load partitions in parallel. The secondary constraint violations.
number of utility tasks used to load partitions is
indicated by nnnn. Severity: 4 (warning)
Severity: 0 System Action: Processing continues.
System Action: Processing of the RELOAD phase User Response: Determine why no primary key exists
continues. for the deleted record.
User Response: You can verify that the number of Problem Determination: All primary errors are
tasks reported is consistent with your expectations. For accompanied by a DSNU361I message which identifies
example, if 4 partitions are to be loaded, you might the relationship and input record which does not have a
expect to see the number of tasks = 4. primary key value. The report phase will report all
secondary errors and indicate the primary error record
which caused this record to be deleted.
DSNU365I csect-name - USER auth-id DOES NOT
HAVE AUTHORITY ON REORG The relevant parent table can be found by querying the
MAPPING TABLE SYSIBM.SYSRELS catalog table. The relevant columns
can be found by querying the
Explanation: The REORG utility was run with SYSIBM.SYSFOREIGNKEYS catalog table.
SHRLEVEL CHANGE and a mapping table, but user
auth-id does not have authority to delete, insert, select,
and update in the mapping table specified in the utility DSNU368I csect-name - REORG MAPPING TABLE
statement. HAS WRONG INDEX
Severity: 8 (error) Explanation: A mapping table was specified for a
utility job executing REORG with SHRLEVEL CHANGE.
System Action: Further utility processing is However, the table has the wrong index. This message
terminated. can arise for any parameters of CREATE INDEX that
User Response: Obtain authorization to delete, insert, are missing from, added to, or different from the
select, and update in the mapping table specified in the CREATE INDEX statement that appears for the
utility statement. mapping table in the REORG section of DB2 Utility
Guide and Reference. It can also arise for the existence
of any other indexes on the mapping table.
DSNU366I csect-name - REORG MAPPING TABLE
HAS WRONG COLUMNS Severity: 8 (error)
Explanation: A mapping table was specified for a System Action: REORG does not execute.
utility job executing REORG with SHRLEVEL CHANGE. User Response: Create a mapping table with the
However, the table has the wrong set of columns. This correct index, and no other indexes, as specified under
message can arise for any parameters of CREATE REORG in DB2 Utility Guide and Reference. Execute
TABLE that are missing from, added to, or different from REORG.
the CREATE TABLE statement that appears for the
mapping table in the REORG section of DB2 Utility
Guide and Reference. DSNU369I csect-name - ENFORCE PHASE
COMPLETE, ELAPSED TIME =
Severity: 8 (error) hh/mm/ss
System Action: REORG does not execute. Explanation: The ENFORCE phase of the LOAD
User Response: Create a mapping table with the utility has completed normally. The elapsed time for the
correct set of columns, and no other columns, as execution was 'hh' hours, 'mm' minutes, and 'ss'
specified under REORG in DB2 Utility Guide and seconds.
Reference. Execute REORG.
Chapter 18. DB2 Messages 487
DSNU370I • DSNU374I
Severity: 0 (informational)
DSNU373I csect-name - IN -ALTER UTILITY OR
REORG WITH SHRLEVEL REFERENCE
DSNU370I csect-name - THE LOCAL FORMAT OR CHANGE, DEADLINE HAS
OPTION HAS BEEN USED WITH A ALREADY OCCURRED, CONTEXT=c
DATE OR TIME AND NO LOCAL EXIT
Explanation: If a deadline is specified in the -ALTER
HAS BEEN INSTALLED.
UTILITY command or the REORG utility with
Explanation: The Installation Application Programming SHRLEVEL REFERENCE or CHANGE, the deadline
Defaults Panel indicated that an exit for date or time cannot occur before the time of execution of the
was supplied, but the exit supplied by DB2 was not -ALTER UTILITY or REORG that specified the deadline.
replaced. Context codes are:
Severity: 8 (error) 1 The error occurred on -ALTER UTILITY.
System Action: The statement cannot be executed. 2 The error occurred on REORG.
User Response: Contact the system programmer Severity: 8 (error)
about installation of the date or time exit.
System Action: -ALTER UTILITY or REORG does not
System Programmer Response: To replace the execute.
DB2-supplied exit routine, an SMP USERMOD must be
User Response: Execute -ALTER UTILITY or REORG
applied. If an SMP USERMOD is undesirable, the
with no deadline or with a deadline that has not already
replacement module may be linked into a user library
occurred. If you want to terminate an execution of
either included in the MVS LINKLIST or concatenated to
REORG, use the -TERM UTILITY command.
the STEPLIB in the started task JCL for ssnmDBM1
(ssnm is the subsystem name).
DSNU374I csect-name - REORG WITH SHRLEVEL
REFERENCE or CHANGE HAS BEEN
DSNU371I csect-name - REORG MAPPING
TERMINATED, REASON=c
TABLE’S TABLE SPACE MUST BE
SEGMENTED Explanation: REORG with SHRLEVEL REFERENCE
or CHANGE has been terminated.
Explanation: REORG with SHRLEVEL CHANGE
specified a mapping table for a table space that is not 1 REORG with SHRLEVEL CHANGE specified
segmented. The table space that contains the mapping LONGLOG TERM, and at the end of an
table must be segmented. iteration of log processing, the number of log
records that the next iteration would process is
Severity: 8 (error)
not sufficiently lower than the number that the
System Action: REORG does not execute. previous iterations processed.
User Response: Specify a mapping table that is in a 2 DB2 estimated that the switch phase of
table space that is segmented. REORG with SHRLEVEL REFERENCE or
CHANGE would not start by the deadline
specified in the DEADLINE phrase.
DSNU372I csect-name - CANNOT REORGANIZE
REORG MAPPING TABLE’S TABLE Severity: 8 (error)
SPACE
System Action: REORG terminates.
Explanation: REORG with SHRLEVEL CHANGE
User Response: For reason code 1, attempt a new
specified a mapping table that resides in the table
invocation of reorganization later, perhaps when you
space that is being reorganized. The table space that
expect that the application workload is lower or the
contains the mapping table must not be the table space
maximum desired amount of time for applications to
that is being reorganized.
have read-only access is longer.
Severity: 8 (error)
For reason code 2 on SHRLEVEL CHANGE, attempt a
System Action: REORG does not execute. new invocation of reorganization later, perhaps when
you expect to have a longer time available, you expect
User Response: Specify a mapping table that is not in that the application workload is lower, or you expect that
the table space that is being reorganized. the maximum desired amount of time for applications to
have read-only access is longer. For reason code 2 on
SHRLEVEL REFERENCE, attempt a new invocation of
reorganization later, perhaps when you expect to have a
longer time available.
488 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU375I • DSNU378I
Severity: 4 (warning)
DSNU375I csect-name DISCARD PHASE
STATISTICS - nnn INPUT DATA SET System Action: After a delay (specified by the DELAY
RECORDS DISCARDED phrase of the REORG utility or the -ALTER UTILITY
command), REORG performs the action specified by
Explanation: Input data set records were rejected by
the LONGLOG phrase of the REORG utility or the
the LOAD utility for one or several reasons. The
-ALTER UTILITY command.
rejected records have been placed in a discards data
set. The number of records rejected is 'nnn'. Message User Response: No action is required. However, if the
DSNU399I summarizes the errors causing the records action specified by the LONGLOG phrase is not
to be rejected. desired, the operator (or a user-written program that is
triggered by the message) can take an action. For a list
Severity: 4 (warning)
of possible actions, see the description of LONGLOG in
System Action: Processing continues. the REORG section of DB2 Utility Guide and Reference.
User Response: Examine the LOAD error summary Operator Response: No action is required. However,
and decide which of the discarded records, if any, if the action specified by the LONGLOG phrase is not
should be corrected and reapplied to the table space. desired, the operator (or a user-written program that is
triggered by the message) can take an action. For a list
of possible actions, see the description of LONGLOG in
DSNU376I csect-name DISCARD PHASE
the REORG section of DB2 Utility Guide and Reference.
COMPLETE, ELAPSED TIME =
hh/mm/ss
DSNU378I csect-name - REORG WITH SHRLEVEL
Explanation: The DISCARD phase of the LOAD utility
NONE HAS INAPPROPRIATE
has completed normally. The elapsed time for the
NOSYSREC KEYWORD, REASON=c
execution was 'hh' hours, 'mm' minutes, and 'ss'
seconds. Explanation: REORG with SHRLEVEL NONE allows
the following combinations of the SORTDATA and
Severity: 0 (informational)
NOSYSREC keywords:
v Neither keyword
DSNU377I csect-name - IN REORG WITH v SORTDATA alone (without NOSYSREC)
SHRLEVEL CHANGE, THE LOG IS v SORTDATA NOSYSREC
BECOMING LONG, MEMBER=member-
These combinations do not trigger this message.
name, UTILID=utilid
However, NOSYSREC alone (without SORTDATA) is
Explanation: During log processing for REORG with inappropriate and triggers this message with a reason
SHRLEVEL CHANGE, the number of log records that code of 1.
the next iteration will process is not sufficiently lower
than the number that the previous iterations processed. Also, for REORG with SHRLEVEL NONE, if you specify
This situation means that during reorganization, the log UNLOAD PAUSE, UNLOAD ONLY, or UNLOAD
is not being read quickly enough to catch up to the EXTERNAL, NOSYSREC is inappropriate and triggers
application writing the log. This is a WTO message; it is this message with a reason code of 2. If the two
sent to the console, but it is not an action message. It is conditions (omission of SORTDATA and inclusion of
also sent to SYSPRINT. UNLOAD PAUSE, ONLY, or EXTERNAL) are both true,
NOSYSREC triggers this message with a reason code
DB2 refrains from taking the action specified in the
of 2.
LONGLOG phrase if any one of the following events
occurs for this execution of REORG before the delay Severity: 8 (error)
expires:
System Action: REORG does not execute.
v An -ALTER UTILITY command is issued.
User Response: Specify an invocation of REORG
v A -TERM UTILITY command is issued.
with appropriate parameters. Specifically, for reason
v DB2 estimates that the time to perform the next code 1, if you want to execute REORG with SHRLEVEL
iteration will be less than or equal to the time NONE, add SORTDATA and/or remove NOSYSREC.
specified in the MAXRO phrase. For reason code 2, if you want to execute REORG with
v REORG terminates for any reason (including the SHRLEVEL NONE, remove NOSYSREC, UNLOAD
deadline). PAUSE, UNLOAD ONLY, or UNLOAD EXTERNAL .
member-name
Identifies the DB2 member in a data sharing
environment. Blank in a non-data-sharing
environment.
utilid Identifies the utility job step.
Chapter 18. DB2 Messages 489
DSNU379I • DSNU383I
process the TOCOPY keyword and put the
DSNU379I csect-name - ALTER UTILITY, UTILID =
recovering object in copy pending status.
utilid: SWITCH PHASE IN REORG HAS
ALREADY STARTED, NO ALTER IS
PERFORMED An image copy is required to establish a new base from
which the table space can be recovered. Otherwise, the
Explanation: The -ALTER UTILITY command was results of running the RECOVER utility on that table
applied to a job that is executing REORG with space are unpredictable.
SHRLEVEL REFERENCE or CHANGE. However,
nothing was altered, because REORG had already Severity: 4 (warning)
started its switch phase. User Response: Take an image copy of the
Severity: 4 (warning) associated table space. If the message was issued after
the COPY utility failed, correct all specified errors for the
System Action: ALTER UTILITY has no effect. associated table space before attempting another image
copy on that table space.
DSNU380I csect-name TABLESPACE
database.tablespace-name PARTITION DSNU382I csect-name - REORG UTILITY, UTILID =
part-num IS IN COPY PENDING utilid REQUESTED TO ALTER, PHASE =
utility-phase
Explanation: An image copy is required to establish a
new base from which the table space partition can be Explanation: This message is issued in response to
recovered. Otherwise, the results of running the an -ALTER UTILITY command. It acknowledges that the
RECOVER utility on that table space partition are request for alteration was received and verified. At the
unpredictable. time the -ALTER UTILITY request was received,
REORG was in the utility job step identified by UTILID
If the RECOVER TABLESPACE utility with the keyword
utilid.
TOCOPY is being used, the START_RBA or
START_LRSN value of the associated full image copy Severity: 0 (informational)
might be outside the available recovery information. To
verify this, look at the REPORT utility output. The System Action: DB2 has accepted the request to alter
RECOVER TABLESPACE utility will process the the indicated utility job step. The utility alters its
TOCOPY keyword and put the recovering object in copy parameter values.
pending status. User Response: This message is an
Severity: 4 (warning) acknowledgement that the request has been accepted
and is in progress.
User Response: Take an image copy of the
associated table space partition. If the message was
issued after the COPY utility failed, correct all specified DSNU383I csect-name CURRENT ITERATION
errors for the associated table space before attempting NUMBER = nnnnnn WRITE ACCESS
another image copy of that table space. ALLOWED IN CURRENT ITERATION =
www ITERATION BEFORE PREVIOUS
ITERATION: ELAPSED TIME = ha:ma:sa
DSNU381I csect-name TABLESPACE NUMBER OF LOG RECORDS
database.tablespace-name IS IN COPY PROCESSED = nnnnna PREVIOUS
PENDING ITERATION: ELAPSED TIME = hb:mb:sb
NUMBER OF LOG RECORDS
Explanation: This message is issued after:
PROCESSED = nnnnnb CURRENT
v A LOAD or REORG utility with the LOG(NO) option ITERATION: ESTIMATED ELAPSED
left the associated table space in an unrecoverable TIME = hc:mc:sc ACTUAL ELAPSED
state. TIME SO FAR = hd:md:sd ACTUAL
v An image copy failed because broken pages were NUMBER OF LOG RECORDS BEING
detected or an image copy was terminated. PROCESSED = nnnnnd CURRENT
v A partial recovery finished successfully. ESTIMATE FOR NEXT ITERATION:
ELAPSED TIME = he:me:se NUMBER
v A MODIFY RECOVERY left the associated table
OF LOG RECORDS TO BE
space in an unrecoverable state.
PROCESSED = nnnnne
If the RECOVER TABLESPACE utility with keyword
TOCOPY is being used, the START_RBA or Explanation: This message applies only during the
START_LRSN value of the associated full image LOG phase of REORG with SHRLEVEL CHANGE. It
copy might be outside the available recovery supplements message DSNU105I which can appear in
information. To verify this, look at the REPORT utility any phase (including the LOG phase).
output. The RECOVER TABLESPACE utililty will This message is issued in response to a -DISPLAY
UTILITY command.
490 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU384I • DSNU385I
It is also issued by the REORG utility if the user
DSNU384I csect-name - MAXRO = aaaaaaaaaa
specified SHRLEVEL REFERENCE or CHANGE and
SECONDS LONGLOG = llllllll DELAY =
DB2 estimates that the switch phase will not start by the
bbbbbbbbbb SECONDS
deadline specified by the DEADLINE phrase. This
message provides the user with an estimate of how far Explanation: This message applies only to REORG
the REORG utility has proceeded in the indicated utility with SHRLEVEL CHANGE. It supplements message
job step. DSNU105I, which can appear for any utility (including
REORG).
nnnnnn The current iteration number
This message is issued in response to a -DISPLAY
www 'YES' or 'NO' according to whether write
UTILITY command.
access is allowed in the current iteration of log
processing It is also issued by the REORG utility if the user
specified SHRLEVEL CHANGE and DB2 estimates that
For the iteration before the previous iteration: the switch phase will not start by the deadline specified
by the DEADLINE phrase.
ha:ma:sa
The elapsed time for the iteration This message indicates the most recently specified
values of certain parameters to REORG. For each such
nnnnna The number of log records processed in the parameter, a previous invocation of the -ALTER
iteration. UTILITY command might have specified a value. If no
previous invocation of -ALTER UTILITY has specified a
These values are 00:00:00 and 0 if the current iteration value, the most recently specified value is the value that
number is 1 or 2. was specified with the invocation of the REORG utility.
For the previous iteration: aaaaaaaaaa
A number of seconds, according to the most
hb:mb:sb recently specified value of MAXRO. A value of
The corresponding information. ″DEFER″ denotes that the log file will be
nnnnnb The corresponding information. deferred indefinitely.
llllllll “CONTINUE,” “TERM,” or “DRAIN” according
These values are 00:00:00 and 0 if the current iteration to the most recently specified value of
number is 1. LONGLOG
bbbbbbbbbb
For the current iteration:
A number of seconds, according to the most
hc:mc:sc recently specified value of DELAY
The estimated elapsed time
Severity: 0 (informational)
hd:md:sd
System Action: The message reflects the state of
The elapsed time so far
DB2 at the time of the -DISPLAY UTILITY command or
nnnnnd The actual number of log records being the time when DB2 estimated that the switch phase
processed would not start by the deadline specified by the
DEADLINE phrase.
For the next iteration:
If this message was issued for -DISPLAY UTILITY, the
he:me:se system continues processing. If an -ALTER UTILITY
The currently estimated elapsed time command is then executed, a subsequent -DISPLAY
UTILITY command reflects the results (if any) of the
nnnnne The currently estimated number of log records -ALTER UTILITY command.
to be processed
Severity: 0 (informational) DSNU385I csect-name - LOG PHASE COMPLETE,
System Action: The message reflects the state of ELAPSED TIME = hh/mm/ss
DB2 at the time of the -DISPLAY UTILITY command or Explanation: This message is issued at the normal
the time when DB2 estimated that the switch phase completion of the LOG phase of the REORG utility. The
would not start by the deadline specified by the time that has elapsed between the beginning and the
DEADLINE phrase. completion of this phase was:
If this message was issued for -DISPLAY UTILITY, the hh hours
system continues processing. A subsequent -DISPLAY mm minutes
UTILITY command reflects that processing. ss seconds
Severity: 0 (informational)
Chapter 18. DB2 Messages 491
DSNU386I • DSNU392I
System Action: Processing continues to the next
DSNU389I csect-name - BUILD2 PHASE
phase of the REORG utility.
STATISTICS. NUMBER OF
NONPARTITIONED INDEXES = mmm
DSNU386I csect-name - LOG PHASE STATISTICS.
Explanation: This message is issued at the normal
NUMBER OF ITERATIONS = iiiiiiii,
completion of the BUILD2 phase of the REORG utility.
NUMBER OF LOG RECORDS = rrrrrrrr
mmm The number of nonpartitioned indexes whose
Explanation: This message is issued at the normal
RIDs were corrected.
completion of the LOG phase of the REORG utility.
Severity: 0 (informational)
iiiiiiii The number of iterations of log processing that
were performed. This number includes one or System Action: The BUILD2 phase of the REORG
more iterations during which applications have utility is completed.
read/write access plus one final iteration during
which applications have read-only access.
DSNU390I csect-name INVALID CONVERSION FOR
rrrrrrrr The number of log records that were read. FIELD cccccccc
Explanation: The input field type for column,
Application of some of these log records might be
'cccccccc', is incompatible with its data type (as found in
unnecessary. Therefore, the LOG phase might apply
the catalog).
only a subset of these log records to the shadow copy
of the table space or partition. Severity: 8 (error)
Severity: 0 (informational) System Action: Utility processing is terminated.
System Action: The LOG phase of the REORG utility User Response: Correct the error, and resubmit the
is completed. job. Refer to DB2 Utility Guide and Reference for
compatible data types.
DSNU387I csect-name - SWITCH PHASE
COMPLETE, ELAPSED TIME = DSNU391I csect-name - SORTBLD PHASE
hh/mm/ss STATISTICS. NUMBER OF INDEXES =
mmm
Explanation: This message is issued at the normal
completion of the switch phase of the REORG utility. Explanation: This message is issued at normal
The time that has elapsed between the beginning and completion of the SORTBLD phase of the LOAD,
the completion of this phase was: REORG, or REBUILD INDEX utility. The number of
hh hours indexes that were built is indicated as mmm.
mm minutes
Severity: 0 (informational)
ss seconds
System Action: The SORTBLD phase of either the
Severity: 0 (informational)
LOAD, REORG, or REBUILD INDEX utility is
System Action: Processing continues to the next completed.
phase of the REORG utility.
DSNU392I csect-name - SORTBLD PHASE
DSNU388I csect-name - BUILD2 PHASE COMPLETE, ELAPSED TIME =
COMPLETE, ELAPSED TIME = hh:mm:ss
hh/mm/ss
Explanation: This message is issued at the normal
Explanation: This message is issued at the normal completion of the SORTBLD phase of the LOAD,
completion of the BUILD2 phase of the REORG utility. REORG, and REBUILD INDEX utility. The time that has
The time that has elapsed between the beginning and elapsed between the beginning of the phase and the
the completion of this phase was: completion of this phase was hh hours, mm minutes,
hh hours and ss seconds.
mm minutes
Severity: 0 (informational)
ss seconds
System Action: Processing continues to the next
Severity: 0 (informational)
phase of the LOAD, REORG, or REBUILD INDEX utility.
System Action: Processing continues to the next If this is the last phase, processing continues to the next
utility statement in the utility job step, if any. utility statement in the utility job step, if any.
492 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU393I • DSNU397I
tasks reported is consistent with expectations. For
DSNU393I csect-name SORTBLD PHASE
example, if 3 indexes are to be built, the user might
STATISTICS. NUMBER OF KEYS =
expect to see number of tasks = 6.
nnnnnnnn FOR INDEX index-name PART
part-num
DSNU396I csect-name REPORT PHASE
Explanation: This message is issued by the
COMPLETE, ELAPSED TIME =
SORTBLD phase of the LOAD, REORG, or REBUILD
hh/mm/ss
INDEX utility to report the total number of index key
entries used to build the indicated index partition. Explanation: The REPORT phase of the LOAD utility
has completed normally. The elapsed time for the
Severity: 0 (informational)
execution was 'hh' hours, 'mm' minutes, and 'ss'
System Action: This message indicates the number seconds.
of index key entries for the index partition being built.
Severity: 0 (informational)
Both unique and nonunique key entries are counted.
Rejected key entries are not counted.
DSNU397I csect-name NUMBER OF TASKS
User Response: You can verify that the number
CONSTRAINED BY xxxxxxxx
reported is consistent with expectations.
Explanation: This message indicates that while a
utility is able to start subtasks to perform operations in
DSNU394I csect-name SORTBLD PHASE
parallel, the number of tasks it will use has been
STATISTICS. NUMBER OF KEYS =
constrained by a lack of some resource. The
nnnnnnnn FOR INDEX index-name
constraining resource is specified by xxxxxxxx, which
Explanation: This message is issued by the can have the following values and meanings:
SORTBLD phase of the LOAD, REORG, or REBUILD
VIRTUAL STORAGE
INDEX utility. The message is repeated for each index
The utility could start additional tasks, but there
built by the LOAD, REORG, or REBUILD INDEX utility.
is insufficient virtual storage in the address
It indicates the total number of index key entries used to
space in which the utility job is running to make
build the indicated index. If the index is a partitioning
it effective to do so.
index, the total will equal the sum of the number of
index key entries reported in prior DSNU393I VIRTUAL STORAGE BELOW
messages. The utility could start additional tasks, but there
is insufficient virtual storage below the line in
Severity: 0 (informational)
the address space in which the utility job is
System Action: This message indicates the number running to make it effective to do so.
of index key entries for the index being built. Both
DD STATEMENTS
unique and nonunique key entries are counted.
The utility could start additional tasks, but the
Rejected key entries are not counted.
user has specified DD statements for the data
User Response: You can verify that the number sets to be used by SORT for sort work data
reported is consistent with expectations. For example, sets or for sort message data sets, and fewer
you can determine if it matches the number of records sort work data set groups or sort message data
loaded for the table indexed by the indicated index, sets have been specified than the maximum
which will have been reported in a DSNU303I message number of tasks the utility could otherwise
issued during the RELOAD phase. start.
CONNECTIONS
DSNU395I csect-name INDEXES WILL BE BUILT IN The utility could start additional tasks, but there
PARALLEL, NUMBER OF TASKS = are not enough free threads available to DB2
nnnn to do so.
Explanation: This message is issued by the RELOAD CPUS The utility could start additional tasks, but it
phase of the LOAD or REORG or UNLOAD phase of would not be efficient to do so because it
REBUILD INDEX utility. The message indicates that the would overtax the available CPUs.
LOAD, REORG, or REBUILD INDEX utility is able to
Severity: 0 (informational)
build indexes in parallel. The number of utility tasks
used to build the indexes is indicated by nnnn. System Action: Processing of the phase continues.
Severity: 0 (informational) User Response: No action is required. However, if
you want to increase the number of tasks used by the
System Action: Processing of the RELOAD phase
utility in order to reduce the elapsed time of the utility
continues.
job, then the possible actions to take depend on the
User Response: You can verify that the number of value of xxxxxxxx in the message:
Chapter 18. DB2 Messages 493
DSNU398I • DSNU399I
VIRTUAL STORAGE User Response: If a DSNT500I message was issued,
Increase the amount of virtual storage available refer to its description under that message number in
to the utility job by specifying a larger region this manual. If the unavailable resource becomes
size in the job JCL, altering the JES defaults available, the utility step is restartable.
for region size, or changing the system IEFUSI
If a DSNT500I message is not issued, the error is an
exit to allow a larger virtual region.
internal error. Notify the system programmer.
If the utility is using BSAM data sets for which
Operator Response: An operator with SYSOPR
the number of buffers have been specified
authority can issue a TERM UTIL to free any held
(BUFNO specified in the DCB field of the DD
resources (this may not be necessary).
statement for the data set), consider reducing
the number of buffers. System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
VIRTUAL STORAGE BELOW
and Reference for information on identifying and
If possible, increase the amount of virtual
reporting the problem.
storage below the line available to the utility job
by specifying a larger region size in the job
JCL or reducing the number of data sets DSNU399I csect-name - LOAD UTILITY ERROR
allocated in the job step. It might not be SUMMARY REPORT
possible to relieve this constraint.
Explanation: This message summarizes errors
DD STATEMENTS detected during the load job. Figure 1 shows the format
Define additional groups of sort work data sets, of the report. It is issued only if unique index or
or eliminate the SWnnWKmm DD statements referential constraint violations were detected. The
and specify the SORTDEVT keyword (and, report contains one line for each error. The errors are
optionally, the SORTNUM keyword) to allow listed first by error severity and within that by idsrn.
SORT to use dynamic allocation of its work
data sets. ERROR INPUT Discard ERROR TABLE FIELD/FANSET RELATED
SEVERITY RECORD Heading TYPE NAME NAME ERROR
If the limitation is due to sort message data sev idsrn ddsrn type name1 name2 idsrn2
sets rather than sort work data sets, define . . . . . . .
. . . . . . .
additional sort message DD statements or
eliminate the UTPRINnn DD statements and
allocate UTPRINT to SYSOUT so that the sort Figure 1. LOAD Utility Error Summary Report
message data sets can be dynamically
allocated. The Discard Heading is either DISCARD RECORD or
blank, depending on whether discard processing is in
CONNECTIONS
effect.
Increase the number of threads available to
DB2, or submit the job during a period of
reduced DB2 activity. The report fields have the following meanings:
CPUS Submit the job to a member that has more sev The severity of the error reported on this line:
processors.
Severity Type of Explanation
Error
DSNU398I csect-name UNEXPECTED 1 Primary Primary referential integrity errors
PROCESSING ERROR, and all nonreferential integrity
REASON=X00E40318, ON TABLE tttttttt errors.
Explanation: When attempting to load a record into 2 Secondary Secondary referential integrity
table 'tttttttt', an error was encountered. Refer to “Part 4. errors (that is, errors that result
DB2 Codes” on page 707 for an explanation of reason from a primary referential
code '00E40318'. integrity error in an ancestor).
Severity: 8 (error)
System Action: If the error was caused by a resource idsrn The relative record number in the input data
not being available, a DSNT500I message is issued. set of the record causing the error reported on
this line.
The utility step is abended with a system X'04E' with an
abend reason code of '00E40318'. If a DSNT500I ddsrn The relative record number in the input data
message is not issued, an SVC dump is requested. A set of the record causing the error reported on
SYSABEND dump of batch storage is also requested. this line, if discard processing is in effect.
Otherwise, ddsrn is blank.
The utility step is left in the stopped state.
494 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU400I • DSNU401I
type A description of the type of error reported on apply to pages included in the scope of the COPY
this line, as follows: request. This can either be a full table space, full index
Conversion space (DSNUM(ALL)) or a partition (DSNUM(integer)).
Field specification All the pages in the table space, index space, or
Validation partition can be copied (FULL(YES)), or only the
Part Specification changed pages can be copied (FULL(NO)). The
Unexpected message variables are:
Column specification
ff.ff The average percentage of free space within
Referential integrity
the copied pages. This indicates the amount of
Check constraint
change activity that can occur without
Duplicate key.
significant impairment of reference
name1 The name of the table for which the record performance.
causing the error was targeted, if this
nnnnnn The number of pages written out.
information is pertinent for the type of error
reported on this line. Otherwise, name1 is Image copies produced during LOAD or
blank. This field has nonblank values for the REORG will have more pages written than a
following error types: full image copy produced by running the COPY
Conversion utility on the same table space, because some
Validation pages will be written more than once.
Column specification
Referential integrity (primary). pp.pp The percentage of changed pages. This
Check constraint indicates the amount of change activity that
occurred since the last image copy or
name2 The name of the field or fanset involved in the reorganization. The percentage of changed
error reported on this line, if this information is pages is obtained by dividing the number of
pertinent for the type of error reported. changed pages by the number of pages in the
Otherwise, name2 is blank. This field contains object. Preformatted pages consisting of all
a field name for the following types of errors: zeros are included in the count of pages
Conversion scanned. Since these preformatted pages are
Field specification not copied to the output data set, the number
Column specification. of pages scanned is usually larger than the
number of pages copied.
For primary referential integrity errors, name2
When this message is issued for image copies
is a relationship name. For check constraint
produced during LOAD or REORG, this
errors, name2 is a check constraint name.
percentage will always be reported as 100%,
idsrn2 The input data set record number of a related because the utility is resetting and reformatting
error. For duplicate key errors, it gives the input the entire table space.
data set record number of the record whose
System Action: The COPY, LOAD or REORG utility
key is duplicated. For secondary referential
continues processing this message is for information
integrity errors, it gives the input data set
only. Message DSNU428I will be issued when the copy
record number of the record whose primary
processing is complete.
referential integrity error cascaded to cause
this secondary error. For other types of errors, User Response: Reported statistics could suggest
this field is unused. that either a RUNSTATS or REORG utility should be run
on the table space.
Severity: 4 (warning)
System Action: Processing continues.
DSNU401I csect-name CONCURRENT COPY
COMPLETE, ELAPSED TIME= hh:mm:ss
DSNU400I csect-name COPY PROCESSED FOR
Explanation: The DFSMS Concurrent Copy utility
obj-type obj-qual.obj-name NUMBER OF
completed normally.
PAGES=nnnnnn, AVERAGE PERCENT
FREE SPACE PER PAGE = ff.ff, Severity: 0 (informational)
PERCENT OF CHANGED PAGES =
pp.pp, ELAPSED TIME= hh/mm/ss System Action: Processing continues to the next
utility statement in the utility job step. If there are no
Explanation: This is an informational message to more utility statements, the utility job step is normally
report the copy statistics. This message is issued by the terminated, and the resources are released to their prior
COPY utility, and it can also be issued from LOAD or availability state. The utility identifier (UTILID) of the
REORG if a full image copy has been requested during utility job step becomes available for reuse.
a table space load or reorganization. The statistics
User Response: No action is required.
Chapter 18. DB2 Messages 495
DSNU402I • DSNU406I
conflicting image copy data sets on the output tape are
DSNU402I csect-name INCREMENTAL IMAGE
no longer needed, use MODIFY RECOVERY to
COPY DISALLOWED FOR obj-type
eliminate the related SYSIBM.SYSCOPY records. If the
obj-qual.obj-name FULL IMAGE COPY
data sets are still needed, you must place the new
WILL BE TAKEN
image copy on a different tape or you must take a FULL
Explanation: An incremental image copy for a table image copy.
space or data set was requested. However, a full image
copy is required. Possible reasons include:
DSNU404I csect-name LOCAL SITE AND
v The request was for one of the DB2-maintained table RECOVERY SITE INCREMENTAL
spaces DSNDB01.DBD01, DSNDB06.SYSCOPY, or IMAGE COPIES ARE NOT
DSNDB01.SYSUTILX. SYNCHRONIZED FOR obj-type
v A LOAD or REORG utility was run on the table space obj-qual.obj-name
or data set with no subsequent full image copy.
Explanation: No incremental image copy can be
v No full image copy was found for the requested sites. made if
v Copy pending status was set for the requested table 1. The incremental image copy is requested only for a
space or data set. site other than the current site.
v The request was for an entire table space, but the 2. The incremental image copies are requested for
most recent image copy for the table space is on the both sites but the most recent full image copy was
data set level. made only for the current site.
v The previous image copy is a DFSMS concurrent 3. The incremental image copies are requested for
copy. both sites and the most recent full image copies
were made for both sites, but between the most
The request for an incremental image copy is ignored, recent full image copy and current request, all
and a full image copy is taken. incremental image copies were made for current site
Severity: 4 (warning) only.
System Action: The request to take an incremental Severity: 8(error)
image copy is treated as a request to take a full image System Action: The utility will terminate with a return
copy. code of 8, and will not take the image copy or update
User Response: The capacity of the target image the SYSCOPY table.
copy data set might not be sufficient if its size was User Response: Take another full image copy of the
established assuming an incremental image copy. If this TABLESPACE for both LOCAL site and RECOVERY
condition occurs, terminate and then resubmit the job site or change the request to make incremental image
step. copy only for current site.
DSNU403I csect-name - FULL AND INCREMENTAL DSNU406I FULL IMAGE COPY SHOULD BE
COPIES OF THE SAME TABLESPACE TAKEN FOR BOTH LOCAL SITE AND
ON THE SAME TAPE DISALLOWED RECOVERY SITE FOR obj-type
DDNAME ddname obj-qual.obj-name
Explanation: The COPY utility has been invoked to Explanation: The requested full image is for one site
take an incremental image copy of a TABLESPACE. only but history shows that there were image copies
The specified output data set is on a tape which taken for both local site and recovery site and the table
contains another FULL or INCREMENTAL image copy space is in copy pending status, or point in time recover
of the same TABLESPACE. This is not allowed. has been done on the table space, or the table space is
Severity: 8 (error) in copy pending status and the requested full image
copy is for a site other than the current site. Be aware
System Action: The utility will terminate with a return of the following situations:
code of 8, and will not take the image copy or update 1. If the requested copy is made for current site, then
the SYSCOPY table. the other site can only do point in time recovery.
User Response: Change the VOLSER for the image 2. If the requested copy is for the site other than the
copy output data set or use the MODIFY RECOVERY current site, then the TABLESPACE will be in the
utility to delete SYSIBM.SYSCOPY records which are same state as before COPY has been made.
no longer needed for the same TABLESPACE and tape
volume. Severity: 4 (warning)
Problem Determination: Use the SQL SELECT System Action: COPY, LOAD, or REORG utility will
command to look at the SYSIBM.SYSCOPY table. If the continue to process the image copy.
496 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU407I • DSNU411I
User Response: Take another full image copy of the resides on a device with no hardware or software
TABLESPACE for both LOCAL site and RECOVERY support for the DFSMSdss DUMP command with the
site to guarantee the correct recovery on both sites or CONCURRENT option.
check DSNZPARM to ensure that the current site is the v The RECOVER utility invoked the DFSMSdss
site at which the image copy is being taken. RESTORE command without the supporting software.
Severity: 4 (for RECOVER) or 8 (for COPY)
DSNU407I csect-name - DATA SET ALREADY
USED FOR PREVIOUS IMAGE COPY System Action: The RECOVER utility falls back to the
previous image copy data set and continues. The COPY
Explanation: A COPY, LOAD, or REORG utility has utility job terminates.
been invoked to take an image copy to a data set which
is a duplicate of one already recorded in SYSCOPY. If User Response: If a list of objects is specified in the
the specified data set is cataloged, a matching COPY job, remove the object that has no hardware or
DSNAME exists. If the specified data set is not software support from the list. Resubmit the job or use
cataloged, a matching DSNAME, DSVOLSER, and the DB2 COPY utility instead of the DFSMS Concurrent
FILESEQNO exists. Copy utility.
Severity: 8 (error)
DSNU410I csect-name obj-type obj-qual.obj-name
System Action: The utility will terminate with a return CONTAINED NO CHANGED PAGES
code of 8, and will not take the image copy or update
the SYSCOPY table. Explanation: An incremental image copy (COPY
option FULL(NO)), which copies only changed pages,
User Response: Change the name of the data set or was requested. However, no changed pages were
use MODIFY utility to delete the old SYSCOPY record found.
containing the duplicate data set.
Severity: 4 (warning)
DSNU408I csect-name - dsn EXISTS WITH This message reflects a warning condition that did not
-VOLUME=vol, FILE prevent subsequent processing.
SEQUENCE-NUMBER=fseq, System Action: This message indicates normal
RBA=rba|lrsn, DATE=date, TIME=time completion of the image copy utility. Processing
Explanation: If this message is issued after continues to the next utility statement in the utility job
DSNU403I, it provides information from the SYSCOPY step, if any. If there are no more utility statements, the
catalog table about the previously created image copy utility job step is normally terminated, and the resources
of the table space. If this message is issued after are released to their prior availability state. The UTILID
DSNU407I, it provides information from the SYSCOPY of the utility job step becomes available for reuse.
table about the duplicate data set that was detected Because no output was produced, the
during image copy processing. SYSIBM.SYSCOPY catalog table remains unchanged.
For copies to DASD or MSS, fseq is 0; for copies of The requester may want to determine why the apparent
cataloged data sets, vol is (CATG). assumption that a change occurred was not true.
Severity: 8 (error) Operator Response: The target copy data set
System Action: The utility terminates with return code identified by the DD statement nominated by the COPY
8 and does not take the image copy or update the COPYDDN option was not required. It was not tracked
SYSCOPY table. in the DB2 catalog table SYSIBM.SYSCOPY. It need
not be kept for subsequent re-call.
User Response: Use the information provided to
change the name of the data set or to locate the
duplicate SYSCOPY record for deletion with the DSNU411I csect-name UNABLE TO LOGICALLY
MODIFY RECOVERY utility. COMPLETE obj-type obj-qual.obj-name
RETURN CODE return-code REASON
CODE reason-code
DSNU409I csect-name NO hardware-or-software
SUPPORT FOR obj-type Explanation: The DFSMSdss DUMP command with
obj-qual.obj-name the CONCURRENT option encountered an error during
the initialization of the target object being copied. The
Explanation: This message is issued by the COPY or return code and reason code are from the DFSMSdss
RECOVER utility for one of the following reasons. DUMP command.
v The COPY utility was invoked to take a DFSMS
Severity: 8
concurrent copy of a table space or index space that
System Action: The utility job terminates.
Chapter 18. DB2 Messages 497
DSNU412I • DSNU417I
User Response: See the return code and reason that DB2 system before the COPY job can be
code in DFSMS/MVS: Administration Reference for successfully run.
DFSMSdss to determine the problem. Resubmit the job
after resolving the problem.
DSNU415I csect-name INVALID OUTPUT BLOCK
SIZE SPECIFIED DDNAME ddname
DSNU412I csect-name UNABLE TO PHYSICALLY
Explanation: Valid block sizes for an image copy or
COMPLETE obj-type obj-qual.obj-name
mergecopy data set are multiples of 4KB and less than
RETURN CODE return-code
the device limitation.
Explanation: The DFSMSdss DUMP command with
Severity: 8 (error)
the CONCURRENT option encountered an error during
the backup process. The return code is from the System Action: Utility processing is terminated.
DFSMSdss DUMP command.
User Response: Correct the JCL statement, or use
Severity: 8 the default. Resubmit the request in a new utility job
step. Refer to DB2 Utility Guide and Reference for a
System Action: The utility job terminates.
discussion of image copy and work data set constraints.
User Response: See the return code description in
DFSMS/MVS: Administration Reference for DFSMSdss
DSNU416I csect-name THE OUTPUT IMAGE COPY
to determine the problem. Resubmit the job after
DATA SET CANNOT BE PARTITIONED.
resolving the problem, or use the DB2 Copy utility
DDNAME ddname
instead of the DFSMS Concurrent Copy utility for the
failed object. Explanation: The use of partitioned image copy data
sets is restricted. The COPY, MERGECOPY, LOAD, or
REORGutility job that was submitted has a partitioned
DSNU413I csect-name - CONCURRENT COPY
output image copy data set, specified by the COPYDDN
SUCCESSFUL FOR obj-type
ddname or RECOVERYDDN ddname parameter.
obj-qual.obj-name
Severity: 8 (error)
Explanation: The DFSMS Concurrent Copy utility
completed normally for the named object. This message System Action: Utility processing is terminated. The
is repeated for every copied object in the list. image copy will not be taken or the merge will not be
done, and the SYSIBM.SYSCOPY table will not be
Severity: 0 (informational)
updated.
System Action: Processing continues to the next
User Response: Correct the utility job by specifying a
object in the list. If there are no more objects, the utility
nonpartitioned data set as the output image copy data
ends normally with message DSNU401I.
set.
User Response: No action is required.
DSNU417I csect-name THE NUMBER OF
DSNU414I csect-name UNABLE TO RETRIEVE VOLUMES USED BY THE IMAGE COPY
RESTART/REDO LRSN obj-type DATA SET data-set-name HAS
obj-qual.obj-name REACHED THE LIMIT
Explanation: This message is issued by the DB2 Explanation: The image copy data set reached the
COPY utility when an error is encountered during the limit of 255 volumes and another volume is required.
retrieval of a log record sequence number (LRSN).
Severity: 8 (error)
This error can occur in these situations:
System Action: The utility job is terminated.
v Another DB2 in a data sharing group terminated
abnormally while trying to update the table space or User Response: You might want to use the DSNUM
index space. option of the COPY utility to identify a partition or data
set within the table space to be copied, or specify a
v A failure occurred while trying to communicate with
partition number to be loaded or reorganized if the copy
other DB2s in the data sharing group.
is being produced from a LOAD or REORG.Refer to
Severity: 8 DB2 Utility Guide and Reference for a description of the
COPY utility and the DSNUM option, and descriptions of
System Action: The utility job terminates.
the LOAD and REORG utilities and the PART option.
User Response: Issue a -DISPLAY DATABASE
command with the USE option to determine if any other
DB2 systems hold a retained lock on the table space or
index space (status = RSTRT). If so, you must restart
498 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU418I • DSNU425I
DFSMS messages might require action. See the
DSNU418I csect-name CANNOT TAKE IMAGE
DFSMS message manual.
COPY AT DATASET LEVEL FOR
NONPARTITIONED TABLESPACE
obj-qual.obj-name IN COPY PENDING DSNU423I csect name CANNOT TAKE
STATUS CONCURRENT COPY WITH SHRLEVEL
CHANGE OPTION FOR obj-type
Explanation: An image copy at the data set level was
obj-qual.obj-name WITH GREATER
requested. However, it is not allowed for one of the
THAN 4KB PAGE SIZE
following reasons:
v The table space is in copy pending status. Explanation: The DFSMS Concurrent Copy utility is
serialized at the extent level. The greater than 4KB
v The table space is not suitable for image copy at the
page size might span more than one extent. This might
data set level.
cause the output data set to contain inconsistent data.
A copy of the entire table space is required.
Severity: 8 (error)
Severity: 8 (error)
System Action: The COPY utility completes
System Action: The COPY utility completes unsuccessfully with return code 8.
unsuccessfully with return code 8.
System Programmer Response: You must take a
System Programmer Response: You must take a full concurrent copy with the SHRLEVEL REFERENCE
image copy of the entire table space by specifying the option or a DB2 image copy if you prefer the
DSNUM ALL option with the COPY utility. SHRLEVEL CHANGE option.
DSNU420I csect-name INCORRECT SHARE LEVEL DSNU424I csect-name INCOMPATIBLE
SPECIFIED FOR TABLE SPACE MAINTENANCE DETECTED.
database-name.tablespace-name DSNUM REFERENCE APAR NUMBER apar DO
dsnum THE FOLLOWING:
Explanation: When copying a table space that is not Explanation: This message indicates that there is a
recoverable, the share level (SHRLEVEL) must be maintenance incompatibility detected across restart.
REFERENCE. This message is followed by the actions the user should
take to resolve the incompatibility.
If the object is an entire table space, 'DSNUM dsnum' is
not displayed. apar The number of the APAR with closing text that
describes the incompatibility.
Severity: 8 (error)
System Action: Utility execution is abended.
System Action: Utility processing is terminated.
User Response: Refer to the action text in the
User Response: Correct the SHRLEVEL to
message.
REFERENCE, and resubmit the COPY utility in a new
utility job step. Refer to DB2 Utility Guide and System Programmer Response: Refer to the APAR
Reference for a discussion of COPY utility constraints. closing text.
DSNU421I csect-name START OF DFSMS DSNU425I csect-name obj-type obj-qual.obj-name
MESSAGES FOR obj-type DOES NOT HAVE THE COPY YES
obj-qualifier.obj-name ATTRIBUTE
Explanation: This message indicates the beginning of Explanation: The utility cannot process the identified
the DFSMS messages; DSNU422I indicates the end. index or index space because it was not defined with
the COPY YES attribute. Without the COPY YES
System Action: No action is required, but subsequent
attribute, the index cannot be specified as a target for
DFSMS messages might require action. See the
the RECOVER, COPY, or REPORT utilities. If the index
DFSMS message manual.
needs to be rebuilt from the data in the table space, use
the REBUILD INDEX utility instead.
DSNU422I csect-name END OF DFSMS
Severity: 4 (warning) or 8 (error)
MESSAGES FOR obj-type
obj-qualifier.obj-name System Action: The RECOVER utility terminates
processing with a return code of 8. The COPY utility
Explanation: This message indicates the end of the
skips this object but continues processing the other
DFSMS messages; DSNU421I indicates the beginning.
objects in the list. The final COPY utility return code will
System Action: No action is required, but preceding be 8. The REPORT utility issues this message with a
Chapter 18. DB2 Messages 499
DSNU426I • DSNU440I
return code of 4 and continues processing other objects | you are using COPY with the CONCURRENT option.
(if any). | The use of online REORG (SHRLEVEL REFERENCE
| or CHANGE) with the FASTSWITCH YES option has
User Response: Determine whether the index should
| created a mixture of ’I0001’ and ’J0001’ instance nodes
be altered to have the COPY YES attribute. If so, alter
| (fifth qualifier) for the underlying LDS’s for the partitions
the index then rerun the utility job. Otherwise remove
| of this object.
the index from the utility statement.
| Severity: 0 (informational)
DSNU426I csect-name CANNOT COPY ONE PIECE | System Action: Utility processing continues.
OF NON-PARTITIONING obj-type
obj-qual.obj-name
| DSNU440I csect-name IMAGE COPY
Explanation: The copy of a nonpartitioning index at | INFORMATION
the data set level is not allowed.
Explanation: This message gives statistical
Severity: 8 (error) information about the results of running the COPY utility.
It applies to a table space, partition, or data set, and is
System Action: The COPY utility skips this object but
based on the information in the space page map at the
continues processing the other objects in the list. The
time the utility is executed. The output contains the
final COPY utility return code will be 8.
following information:
User Response: Either remove the DSNUM option so
DBNAME
that it defaults to DSNUM(ALL) or modify your DSNUM
The name of the database to which the table
option to DSNUM(ALL).
space belongs.
TSNAME
DSNU427I csect-name OBJECTS WILL BE
The table space specified in the utility
PROCESSED IN PARALLEL, NUMBER
statement.
OF OBJECTS = nnnn
DSNUM
Explanation: This message is issued by COPY or
The partition or data set number of the table
RECOVER utilities. The message indicates that COPY
space. The value is ALL if information is about
or RECOVER is able to process the objects in the list in
the entire table space.
parallel. The number of objects used is indicated by
nnnn. 4KB or 32KB PAGES
The total number of 4KB or 32KB pages in the
Severity: 0 (informational)
partition, data set, or entire table space. This
System Action: Processing of the utility continues. value includes preformatted pages that contain
all zeroes.
User Response: You can verify that the number of
objects processed is consistent with expectations. EMPTY PAGES
The total number of empty pages in the data
set of the segmented table space, or entire
DSNU428I csect-name DB2 IMAGE COPY segmented table space. Empty pages can
SUCCESSFUL FOR obj-type result from deletes, or are pages that are not
obj-qual.obj-name yet formatted. They are not copied by the
Explanation: The image copy of the object processed utility.
by the COPY, LOAD, or REORG utility has completed CHANGED
successfully and the image copy data set information The number of pages in the partition, data set,
has been recorded in the SYSIBM.SYSCOPY catalog or table space that were changed since the last
table. time an image copy was created. If an
System Action: The COPY utility continues its incremental image copy is taken, this value is
processing on the next object in the list. The LOAD and the number of pages that are copied.
REORG utilities continue processing in the subsequent PERCENT CHANGED
phases. The percent of changed pages in the table
space, data set, or partition specified.
| DSNU429I csect-name RECOVERY OF objecttype ICTYPE
| database-name.tablespace-name MUST The type of image copy recommended for the
| BE EXECUTED AT THE PARTITION partition, data set, or table space specified.
| LEVEL ICTYPE is based on the comparison between
| Explanation: You must recover the partitioned object the percent of changed pages and the change
| at the partition level. You may receive this message if limit values. ICTYPE values:
500 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU441I • DSNU443I
I If the percent of changed pages is
DSNU442I csect-name CHANGELIMIT REPORT
greater or equal to the low
INFORMATION UNAVAILABLE FOR
CHANGELIMIT value and less than
obj-type obj-qual.obj-name WITH
the high CHANGELIMIT value. An
TRACKMOD NO
incremental image copy is
recommended, or COPY takes one if Explanation: This message is issued in response to a
the REPORTONLY option is not COPY utility. The CHANGELIMIT option cannot produce
specified. statistical information for a table space or a partition that
is defined with TRACKMOD NO, or before a copy has
F If the percent of changed pages is
been taken after the TRACKMOD attribute has been
equal to or greater than the high
changed from NO to YES.
CHANGELIMIT value. A full image
copy is recommended, and COPY Severity: 4 (informational)
takes one if the REPORTONLY option
System Action: If REPORTONLY is not specified then
is not specified.
a full image copy will be taken.
NONE If no pages were changed. An image
User Response: To obtain complete statistical
copy is not recommended, and COPY
information run CHANGELIMIT REPORTONLY after a
does not take one.
copy has been taken.
blank For the partition or data set if DSNUM
ALL is specified, or if CONCURRENT
DSNU443I csect-name type CHANGE LIMIT MET
is specified and the percent of
FOR obj-type obj-qual.obj-name
changed pages is less than the
CHANGELIMIT value. Explanation: The COPY utility is indicating whether
the percent of changed pages in the specified table
Severity: 0 (informational)
space, partition, or data set meets the CHANGELIMIT
System Action: Utility processing continues values. type values:
User Response: If the message indicates, NO If no CHANGELIMIT met.
“INFORMATION CANNOT BE DETERMINED” for a
INCREMENTAL
table space, partition, or data set, examine the utility
If the percent of changed pages is greater than
output for the DSNU441I message which lists the page
the low CHANGELIMIT value and less than the
numbers of the broken pages. See message DSNU441I
high CHANGELIMIT value.
for further instructions on repairing pages.
FULL If the percent of changed pages is greater than
or equal to the the high CHANGELIMIT value.
DSNU441I csect-name BROKEN PAGE FOUND
DBNAME = dbname TSNAME = tsname Severity: The return codes are:
DSNUM = dsnum PAGE = page
1 (informational)
Explanation: The COPY utility found a broken space If no CHANGELIMIT was met.
map page.
2 (informational)
dbname If the percent of changed pages is greater than
The name of the database to which the table the low CHANGELIMIT and less than the high
space belongs. CHANGELIMIT value.
tsname 3 (informational)
The table space containing the broken page. If the percent of changed pages is greater than
or equal to the high CHANGELIMIT value.
dsnum The partition or data set number of the table
space containing the broken page. System Action: Utility processing continues.
page The hexadecimal page number of the broken User Response: If the REPORTONLY option is
page. specified and the result of this job step is not used to
conditionally execute other job steps, examine the utility
Severity: 8 (error)
messages for this table space, partition, or data set to
System Action: Utility execution continues. determine if it has changed to such a degree that an
image copy or other step should be performed.
User Response: The data sets identified are in an
indeterminate state. Use RECOVER, RECOVER PAGE,
or the REPAIR utility to correct the broken page. Refer
to Part 2 of DB2 Diagnosis Guide and Reference.
Chapter 18. DB2 Messages 501
DSNU445I • DSNU458I
DSNU445I csect-name ictype IMAGE COPY WILL DSNU454I csect-name COPY MERGE COMPLETE.
BE TAKEN FOR obj-type NUMBER OF COPIES = iiiii, NUMBER
obj-qual.obj-name OF COPIES MERGED = cccccc, TOTAL
NUMBER OF PAGES MERGED = ttttt,
Explanation: The COPY utility is indicating whether
ELAPSED TIME = hh/mm/ss
the percent of changed pages in the table space meets
the change limit value, and whether an image copy will Explanation: This message marks the normal
be taken. ictype values: completion of the MERGECOPY utility. The variables
are:
NO If no CHANGELIMIT value met.
iiiii The number of copies found.
INCREMENTAL
If the percent of changed pages is greater than cccccc The number of image copies that were
the low CHANGELIMIT value and less than the merged. The number merged can be less than
high CHANGELIMIT value. the number found if a work data set was not
specified using the MERGECOPY WORKDDN
FULL If the percent of changed pages is greater than
option.
or equal to the high CHANGELIMIT value.
ttttt The total number of pages that were merged.
Severity: 0 (informational)
System Action: Utility processing continues. An image The merged incremental copies were consolidated
copy is taken if a change limit is met. If the low either into a single new incremental image copy or into
CHANGELIMIT value is met, then an incremental copy a new full image copy, depending upon the
is taken. If the high CHANGELIMIT value is met, then a MERGECOPY NEWCOPY option. The DB2 catalog
full image copy is taken. table SYSIBM.SYSCOPY was updated to reflect the
results.
DSNU446I csect-name - CHANGELIMIT REPORT
This message may indicate that prior data set entries
INFORMATION UNAVAILABLE FOR
were deleted and, consequently, that backup data set
obj-type obj-qual.obj-name, A FULL
resources were freed.
IMAGE COPY MUST BE TAKEN
Severity: 0/4 (informational/warning)
Explanation: The changelimit dataset statistical
information was requested, but is unavailable. A full System Action: Processing continues to the next
image copy is required. Possible reasons are as follows: utility statement in the utility job step, if any. If there are
v The request was for one of the DB2-maintained table no more utility statements, the utility job step is normally
spaces: DSNDB01.DBD01, DSNDB06.SYSCOPY, or terminated, and the resources are released to their prior
DSNDB01.SYSUTILX. availability state. The UTILID of the utility job step
becomes available for reuse.
v A LOAD or REORG utility was run on the table space
or data set with no subsequent full image copy. User Response: You can review the reported
v No full image copy was found for the requested sites. statistics to assess the effectiveness of performing
incremental image copies. You can examine the
v Copy pending status was set for the requested table
SYSIBM.SYSCOPY catalog table to review the
space or data set.
incremental and full image copies that are subject to
v The request was for an entire table space, but the DB2 recovery.
most recent image copy for the table space is on the
data set level. The full or incremental image copy data set identified by
the DD statement specified in the COPYDDN option
v The previous image copy is a DFSMS concurrent
was recorded in SYSIBM.SYSCOPY. DB2 assumes that
copy.
the image copy data set is now available for subsequent
recovery. Ensure that the data set is available for
The statistical information report will not be generated. If
recovery.
REPORTONLY was omitted, then a FULL image copy is
taken.
DSNU458I csect-name NO IMAGE COPIES TO
Severity: 4 (warning)
MERGE
System Action: The request for CHANGELIMIT
Explanation: This message is issued in response to a
without REPORTONLY is treated as a request to take a
MERGECOPY request. The MERGECOPY utility was
full image copy. The request for CHANGELIMIT with
invoked to merge existing incremental image copies.
REPORTONLY will not generate the report.
However, in checking the DB2 catalog table
User Response: If REPORTONLY is specified, then SYSIBM.SYSCOPY, no incremental image copies were
submit a job to take a full image copy. found.
502 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU459I • DSNU463I
Severity: 4 (warning) completion of the MERGECOPY utility. Processing
continues to the next utility statement in the utility job
A severity 4 condition is given to alert the invoker that
step, if any. If there are no more utility statements, the
processing did not proceed as defined. However,
utility job step is normally terminated, and the resources
processing is proceeding; nothing was encountered that
that were held become available for REFERENCE
would invalidate further processing.
processing. The UTILID of the utility job step becomes
System Action: This message indicates the available for reuse.
completion of the MERGECOPY utility. Processing
No output was produced and the SYSIBM.SYSCOPY
continues to the next utility statement in the utility job
catalog table remains unchanged.
step, if any. If there are no more utility statements, the
utility job step is normally terminated, and the resources User Response: A full image copy of the associated
that were held become available for REFERENCE table space should be taken. However, if it is preferred
processing. The UTILID of the utility job step becomes that a recovery be done on the data set level, a
available for reuse. MERGECOPY job should be submitted by specifying
'DSNUM(data set number)' for each data set for which
The requester may want to determine why the
MERGECOPY is required.
assumption that incremental copies existed was not
true.
DSNU461I csect-name PRIMARY FULL COPY
Operator Response: The target copy data set
DATA SET NOT FOUND, BACKUP WILL
identified by the DD statement nominated by the
BE USED INSTEAD
MERGECOPY COPYDDN option was not required. It
was not tracked in the DB2 catalog table Explanation: The primary full image copy cannot be
SYSIBM.SYSCOPY. It need not be kept for subsequent found. The backup full image copy will be located and
re-call. used for the merge process.
Severity: 0 (informational)
DSNU459I SYSCOPY P RECORD ENCOUNTERED
User Response: If the MERGECOPY utility can use
FOR obj-type obj-qual.obj-name, PIT RBA
the backup full image copy, the utility continues to
= xxxxxx
process. If no backup full image copy can be used, the
Explanation: The utility encountered a SYSCOPY P utility terminates.
record which requires that the SYSCOPY record at the
given RBA or LRSN be used. The utility properly
DSNU462I csect-name MERGECOPY
traverses the SYSCOPY records following this
DISALLOWED FOR REQUESTED
SYSCOPY P record.
TABLE SPACE
Severity: 0 (informational)
Explanation: MERGECOPY was requested for table
User Response: For further information on how the space DSNDB01.DB01, DSNDB01.SYSUTIL, or
SYSCOPY records are traversed, see Part 4 (Volume 1) DSNDB06.SYSCOPY. MERGECOPY is not permitted
of DB2 Administration Guide. for one of the following reasons:
v Only full image copies are allowed on these
DSNU460I csect-name IMAGE COPIES DB2-maintained tables.
INCONSISTENT. MERGECOPY v There is no record of the full image copies in the
REQUEST REJECTED SYSIBM.SYSCOPY catalog; the copy information is
in the DB2 log.
Explanation: MERGECOPY was requested for an
entire table space. However, the most recent image Severity: 8 (error)
copy for the associated table space was on the data set
System Action: Further utility processing is
level. In addition, if the associated table space was
terminated.
partitioned, this might indicate that any or all of its
partitions were being reorganized or loaded without System Programmer Response: Refer to Part 4
logging after the MERGECOPY starting point. The (Volume 1) of DB2 Administration Guide for more
MERGECOPY starting point is the most recent full information about MERGECOPY utility constraints.
image copy for the entire table space.
Severity: 4 (warning) DSNU463I csect - THE xxxxxxx IMAGE COPY DATA
SET data-set-name WITH DATE=dddddd
A severity 4 condition is given to alert the user that
AND TIME=tttttt, IS PARTICIPATING IN
processing did not proceed as defined. However,
MERGECOPY.
processing is proceeding; nothing was encountered that
would invalidate further processing. Explanation: This informational message indicates the
image copy that is used in the merge process. The
System Action: This message indicates the
Chapter 18. DB2 Messages 503
DSNU464I • DSNU474I
variables have the following meanings:
DSNU471I csect-name - COPY PENDING ON
xxxxxxxx TABLESPACE
PRIMARY or BACKUP, indicating a primary or databasename.tablespacename
backup image copy PROHIBITS PROCESSING
data-set-name Explanation: An attempt was made to execute a utility
The image copy data set name against a table space. Either the table space was in
copy pending state or DSNDB06.SYSCOPY was in
dddddd copy pending state.
The image copy date
Severity: 8 (error)
tttttt The image copy time
System Action: Utility processing is terminated.
Severity: 0 (informational)
User Response: Remove the table space from the
User Response: The utility continues to process copy pending state and resubmit the job.
normally.
Problem Determination: Refer to Part 4 (Volume 1) of
DB2 Administration Guide for a discussion of the
DSNU464I THIS IS A sitetype; outputtype WITH database recovery function.
NEWCOPY NO IS NOT ALLOWED.
Explanation: The 'NEWCOPY NO' option to create DSNU472I csect-name - TABLESPACE
incremental image copies is not supported for the tablespace-name HAS WRITE ERROR
current site. This error can be caused by: RANGE OR IS IN DEFERRED
v Running the MERGECOPY utility at sitetype RESTART.
LOCALSITE, but selecting the RECOVERYDDN with
the 'NEWCOPY NO' option. Explanation: The attempt to externalize table space
'tablespace-name' pages to the media has failed.
v Running the MERGECOPY utility at sitetype
RECOVERYSITE, but selecting the COPYDDN with Severity: 4 (warning)
the 'NEWCOPY NO' option.
System Action: QUIESCE still continues but you
Severity: 8 (error) cannot make an image copy of the table space.
Processing continues for all indexes within the table
System Action: The command cannot be executed. space and continues to the next table space in the
User Response: Correct the error and resubmit the tablespace-list, if any.
job. Refer to DB2 Utility Guide and Reference for User Response: Run DISPLAY DATABASE to
detailed information. determine what exception state, if any, would prevent
image copy on the table space.
DSNU470I TABLESPACE DSNDB01.SYSUTILX, ITS Problem Determination: Refer to Part 4 (Volume 1) of
TABLES AND INDEXES CANNOT BE DB2 Administration Guide for a discussion of the
INCLUDED IN A LIST OF OBJECTS. database recovery function.
Explanation: This message is issued by the running
utility when a control statement contains a list of DSNU473I csect-name - UNABLE TO
objects, or references a LISTDEF, which includes any of EXTERNALIZE TABLESPACE
the following SYSUTILX related objects: TABLESPACE tablespace-name PAGES
DSNDB01.SYSUTILX, INDEXSPACE
DSNDB01.DSNLUX01, INDEXSPACE Explanation: The attempt to externalize TABLESPACE
DSNDB01.DSNLUX02, TABLE SYSADM.SYSUTIL, 'tablespace-name' pages to the media has failed.
TABLE SYSADM.SYSUTILX, INDEX
Severity: 4 (warning)
SYSADM.DSNLUX01 or INDEX SYSADM.DSNLUX02.
System Action: QUIESCE still continues but the table
Severity: 8(error)
space cannot be volume-dumped.
System Action: The utility job terminates.
Problem Determination: The problem may be an I/O
User Response: Remove the invalid object from the error.
control statement and run the utility against
DSNDB01.SYSUTILX, its tables and indexes separately.
DSNU474I csect-name - QUIESCE AT RBA
rrrrrrrrrrrr AND AT LRSN xxxxxxxxxx
Explanation: This message displays the log RBA and
LRSN at the time of the quiesce. This value is unique
for all quiesced table spaces in the list and is recorded
504 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU475I • DSNU481I
in the START_RBA column of the SYSCOPY catalog to the next table space in the table space list, if any.
table entry for each quiesced table space in the list.
Severity: 0 (informational) DSNU478I csect-name - INDEX index-name HAS
PENDING STATE
System Action: Processing continues.
Explanation: Index 'index-name' has a PENDING
state.This message is repeated for all PENDING stated
DSNU475I csect-name - QUIESCE UTILITY
indexes in a table space.
COMPLETE, ELAPSED TIME=tttttt
Severity: 8 (error)
Explanation: The message marks the normal
completion of the QUIESCE utility. The elapsed clock System Action: QUIESCE stops processing but
time that the QUIESCE utility uses is shown by 'tttttt'. continues to check all table spaces and indexes for any
additional table space or index that has a PENDING
Severity: 0 (informational)
state. There is no update in SYSCOPY table for any
System Action: Processing continues to the next table space in the list.
utility statement in the utility job step, if any. If there are
User Response: Issue the DISPLAY DATABASE
no more utility statements, the utility job step is normally
command to look at the utility status byte in the DBA
terminated, and the resources are released to their prior
table for a specified PENDING state.
available state. The UTILID of the utility job step
becomes available for reuse. Problem Determination: Refer to Part 4 (Volume 1) of
DB2 Administration Guide for a discussion of the
database recovery function.
DSNU476I csect-name - INDEX index-name HAS
WRITE ERROR RANGE OR IS IN
DEFERRED RESTART DSNU479I csect-name - UNABLE TO
EXTERNALIZE INDEX index-name
Explanation: The attempt to externalize index
PAGES
'index-name' pages to the media failed.
Explanation: The attempt to externalize index
Severity: 4 (warning)
'index-name' pages to the media has failed.
System Action: QUIESCE processing continues.
Severity: 4 (warning)
User Response: Issue the DISPLAY DATABASE
System Action: QUIESCE still continues but the table
command to determine the exception state,
space cannot be volume-dumped.
Problem Determination: Refer to Part 4 (Volume 1) of
Problem Determination: The problem may be an I/O
DB2 Administration Guide for a discussion of the
error.
database recovery function.
DSNU480I csect-name - UNABLE TO
DSNU477I csect-name - QUIESCE SUCCESSFUL
EXTERNALIZE TABLESPACE
FOR obj-type obj-qual.obj-name
tablespace-name PARTITION
Explanation: The QUIESCE for this object was partition-number PAGES
successful. If the object is a table space, then the
Explanation: The attempt to externalize TABLESPACE
quiesce for all of its indexes was successful. This
'tablespace-name' PARTITION 'partition-number' pages
message will also be issued for each index with the
to the media failed.
COPY YES attribute over the quiesced table space.
This message will be repeated for every quiesced table Severity: 4 (warning)
space in list.
System Action: QUIESCE still continues, but the table
Severity: 0 (informational) space cannot be volume-dumped.
System Action: All data held in the DB2 buffer pool(s) Problem Determination: The problem might be an I/O
for the table space and its indexes have been written error.
out to the media if no message DSNU473 or DSNU479
were issued earlier. A SYSCOPY record of ICTYPE 'Q'
DSNU481I csect-name - QUIESCE SUCCESSFUL
has been recorded in the SYSCOPY catalog table for
FOR obj-type obj-qual.obj-name
the table space and for each of its indexes with the
PARTITION partition
COPY YES attribute. The START-RBA value in the
SYSCOPY record(s) is the same for all objects Explanation: The QUIESCE for PARTITION
quiesced during this invocation of the utility. This 'partition-number' of this object was successful. If the
RBA/LRSN value will be printed in the message object is a table space partition, then the quiesce for all
DSNU474 following this message. Processing continues of its indexes was successful. This message will also be
Chapter 18. DB2 Messages 505
DSNU482I • DSNU501I
issued for each index with the COPY YES attribute over
DSNU484I csect-name - INDEX index-name
the quiesced table space. This message is repeated for
PARTITION partition-number HAS WRITE
every quiesced table space in the list.
ERROR RANGE OR IS IN DEFERRED
Severity: 0 (informational) RESTART
System Action: All data held in the DB2 buffer pool(s) Explanation: The attempt to externalize index
for the table space and its indexes have been written 'index-name' pages partition 'partition-number' pages to
out to the media if message DSNU480 or DSNU482 the media failed.
was not issued earlier. A SYSCOPY record of ICTYPE
Severity: 4 (warning)
'Q' was recorded in the SYSCOPY catalog table for the
table space and for each of its indexes with the COPY System Action: QUIESCE processing continues.
YES attribute. The START-RBA value in this SYSCOPY
User Response: Issue DISPLAY DATABASE to
record is the same for all objects quiesced during this
determine the exception state.
invocation of the utility. This RBA value is printed in
message DSNU474 following this message. Processing Problem Determination: Refer to Part 4 (Volume 1) of
continues to the next table space in the table space list, DB2 Administration Guide for a discussion of the
if any. database recovery function.
DSNU482I csect-name - UNABLE TO DSNU500I csect-name RECOVERY COMPLETE,
EXTERNALIZE INDEX index-name ELAPSED TIME = hh/mm/ss
PARTITION partition-number PAGES
Explanation: This message is issued at the normal
Explanation: The attempt to externalize index completion of the RECOVER utility. The time that
'index-name' 'partition-number' pages to the media elapsed since the beginning of the RECOVER utility to
failed. its completion was 'hh' hours, 'mm' minutes, and 'ss'
seconds.
Severity: 4 (warning)
Severity: 0/4 (informational/warning)
System Action: QUIESCE still continues, but the table
space cannot be volume-dumped. System Action: This message indicates the normal
completion of the RECOVER utility. Processing
Problem Determination: The problem might be an I/O
continues to the next utility statement in the utility job
error.
step, if any. If not, the utility job step is normally
terminated, and the resources held become available for
DSNU483I csect-name - TABLESPACE further processing. The UTILID of the utility job step
tablespace-name PARTITION becomes available for reuse.
partition-number HAS WRITE ERROR
User Response: The recovered data is now available
RANGE OR IS IN DEFERRED
for further processing.
RESTART.
Operator Response: The recovered resources are
Explanation: The attempt to externalize table space
available for further processing.
'tablespace-name' partition 'partition-number' pages to
the media failed.
DSNU501I csect-name A PAGE HAS BEEN
Severity: 4 (warning)
STOPPED DURING RECOVERY. SEE
System Action: QUIESCE still continues, but you PREVIOUS DSNI012 MESSAGE
cannot make an image copy of the table space or
Explanation: This message is issued at the normal
partition. Processing continues for the index partition
completion of the RECOVER utility if the data manager
and all nonpartitioned indexes within the table space,
subcomponent cannot apply all the log records for the
and then proceeds to the next table space in the table
page because of an inconsistent DB2 log.
space list, if any.
Severity: 4 (warning)
User Response: Issue DISPLAY DATABASE to
determine what exception state, if any, would prevent System Action: This message indicates that the
image copy on the table space or partition. RECOVER utility completed normally except for the
page (or pages) indicated by the previous DSNI012
Problem Determination: Refer to Part 4 (Volume 1) of
messages. The data manager subcomponent marked
DB2 Administration Guide for a discussion of the
the pages as broken. All other pages were recovered
database recovery function.
successfully. Log apply stopped at the point of the
inconsistency in the DB2 log for that page.
User Response: For information about using the
REPAIR utility to apply changes that should have been
506 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU502I • DSNU507I
made by the log record in error, refer to DB2 Utility The elapsed time of the MERGE is 'hh/mm/ss', hours,
Guide and Reference. Then, if you were recovering to minutes, and seconds, respectively.
the current point in time, resubmit the RECOVER job,
System Action: The MERGECOPY or RECOVER
specifying 'PAGE(page-number) CONTINUE'. This
utility continues processing; this message is for
causes DB2 to retrieve the page from DASD and apply
information only.
log records starting after the faulty one.
User Response: The statistics are indicative of the
processing required. For MERGECOPY, it could indicate
DSNU502I csect-name PAGE page number WAS
that next time more input image copy data sets should
NOT FOUND IN ANY IMAGE COPY
be allocated. For example, if there was more than one
DATA SET
MERGE pass then this message will be issued more
Explanation: The page specified for 'RECOVER page' than once. For both MERGECOPY and RECOVER, it
was not found in any image copy data sets. could indicate that more frequent invocation of
MERGECOPY is appropriate.
This is an informational message only. It does not
indicate termination of processing.
DSNU505I csect-name PAGE page-number IS
Severity: 0 (informational)
BEYOND END OF obj-type
System Action: The RECOVER utility continues
Explanation: A page number was found to be beyond
processing. The assumption is that the page was
the end of the table space, index space, or the current
inserted after the last image copy was made. The page
data set.
is reset and recovered from the log, starting at the log
RBA recorded in the SYSCOPY record for the last Severity: 8 (error)
image copy data set.
System Action: The RECOVER utility terminates with
ABEND 04E reason code 00E40100. If RECOVER
DSNU503I csect-name PAGE page-number IS PAGE was specified, then the utility terminates with
WITHIN PHYSICAL ERROR RANGE return code 8 and no changes are made to the object.
Explanation: The page specified for 'RECOVER page' User Response: Check that the image copy data
is within the physical error range of the table space set(s) in use during the RECOVER contain valid pages.
partition, index space partition, or data set. 'RECOVER If running RECOVER with the PAGE option, then
page' cannot be effective in this case, because the resubmit the utility with the correct page specified.
page would still be within the physical error range and
therefore inaccessible to the user.
DSNU506I csect-name OBJECT
Severity: 8 (error) obj-qualifier.obj-name DSNUM dsnum IS
IN REORG PENDING STATE
System Action: The RECOVER utility terminates with
return code 8. No changes are made to the table space. | Explanation: This message is issued at completion of
| a utility when an object has the REORP state set.
User Response: Resubmit the RECOVER utility
specifying 'error range'. | The RECOVER utility can set the REORP state if the
| table space contains a table that includes an identity
| column. It can also set the REORP state when a
DSNU504I csect-name MERGE STATISTICS FOR
| partitoined table space, which has had its limiting keys
obj-type obj-qual.obj-name - NUMBER OF
| altered, is recovered to a point in time.
COPIES = cc, NUMBER OF PAGES
MERGED = nnnnnn, ELAPSED TIME = | Severity: 0 (informational)
hh/mm/ss
System Action: The RECOVER utility continues
Explanation: This message is issued at the processing, searching for a prior image copy data set.
completion of the MERGE process for the
MERGECOPY or RECOVER utility. The message
DSNU507I csect-name NO USABLE BACKUP FOR
indicates the number of image copies currently
RECOVER
processed ('cc') and the total number of pages that
were merged ('nnnnnn'). The same page can be Explanation: The RECOVER utility determined that a
obtained from more than one incremental image copy. backup was required but not found. The utility
MERGE is repeated for MERGECOPY if all of the input encountered one of the following situations:
image copy data sets cannot be allocated and a v An error occurred while processing the oldest
temporary work data set has been specified. available full image copy data set. This might be the
For the RECOVER utility, MERGE is executed whether only full image copy data set available.
or not there are incremental image copies participating.
In this case, the number of copies ('cc') is one.
Chapter 18. DB2 Messages 507
DSNU508I • DSNU511I
v While scanning backward through the SYSCOPY
DSNU510I csect-name NO GOOD FULL IMAGE
table, a LOAD LOG(NO) or REORG log(NO) record
COPY DATA SET FOR RECOVERY OF
type was found.
obj-type obj-qual.obj-name
Any of the following is acceptable as a backup: Explanation: It is not possible to locate a good image
v A full image copy. copy data set from which to recover. Either no back
level image copy exists, or an I/O error occurred while
v A LOAD LOG(YES). reading the back level image copies. The return code
v A REORG LOG(YES). that accompanies this message is 0 or 8 under the
v For RECOVER PAGE, an incremental image copy following conditions:
that contains the specified page. v The return code is 0 if a full image copy is not found
v A 'no record found' return from the first request for a in the SYSCOPY table during RECOVER initialization
SYSCOPY record indicates that the object was or during fall back processing. However, a LOG(YES)
entirely populated by 'inserts'. The object will be event was detected and recover continues from the
recovered from the DB2 log if its entire history lies log.
within the scope of the log, that is, archive log data v The return code is 8 if the RECOVER utility is in fall
sets containing updates for the object have not been back mode and no base recoverable point (a full
deleted. image copy or LOG(YES) event) was found in the
SYSCOPY table. Further utility processing is
Severity: 8 (error)
terminated.
System Action: The RECOVER utility terminates.
Severity: 0 (informational) or 8 (error)
User Response: Re-create the object that was to be
System Action: If the return code is 0, processing
recovered.
continues. If the return code is 8, further utility
processing is terminated.
DSNU508I csect-name IN FALL BACK
User Response: Notify the system programmer if the
PROCESSING TO PRIOR FULL IMAGE
return code is 8. If the return code is 0, no action is
COPY
required.
Explanation: One of the following occurred:
Operator Response: If the return code is 8, the object
v The RECOVER utility could not allocate the most in question should be started for utility-only processing
recent full image copy data set. The prior full image (if it is not in this state already) until corrective action is
copy is used. taken. If the return code is 0, no action is required.
Accompanying messages indicate why the image
System Programmer Response: If the return code is
copy data set could not be allocated.
8 and the object being recovered is a table space, the
v PAGE or ERROR RANGE was specified and the data must be repaired so that an image copy can be
recoverable point identified an image copy that was taken. An internal error might be involved, and system
created by the DFSMSdss DUMP command with the support might be required. If the return code is 8 and
CONCURRENT option. Such an image copy cannot the object being recovered is an index space, then the
be used to process PAGE or ERROR RANGE. A REBUILD INDEX utility can be used to rebuild the index
prior recoverable point is located. from the data. If the return code is 0, no action is
System Action: The RECOVER utility continues required. Refer to Part 4 (Volume 1) of DB2
processing, searching for the prior image copy. Administration Guide for a discussion of database
recovery procedures.
DSNU509I csect-name - NO ERROR RANGE TO
RECOVER DSNU511I csect-name RECOVERY INFORMATION
INDICATES THAT obj-type
Explanation: The RECOVER utility was invoked to obj-qual.obj-name IS NOT IN A
recover the existing ERROR RANGE. However, no RECOVERABLE STATE
ERROR RANGE was found.
Explanation: The requested recovery of an object
Severity: 4 (warning) would result in recovery entirely from the log. Because
System Action: This message indicates the the object is also in copy pending status, recovery might
completion of the RECOVER ERROR RANGE utility. fail in log apply in these situations:
Processing continues to the next utility statement in the v A previous MODIFY utility job deleted the last
utility job step. If there are no more utility statements, recoverable point indicated in the SYSCOPY catalog
the utility job step is normally terminated. table.
v A previous MODIFY utility job deleted all SYSCOPY
entries.
508 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU512I • DSNU516I
In either case, the MODIFY utility leaves the object in Severity: 0 (informational)
copy pending status and the RECOVER utility is unable
System Action: The RECOVER utility continues
to determine the reliability of recovery from the log.
processing.
Severity: 8 (error)
System Action: The RECOVER utility terminates with DSNU514I csect-name RECOVERY DATA DOES
return code 8. NOT PERMIT DSNUM(ALL) RECOVERY
OF obj-type obj-qual.obj-name
User Response: Determine the recoverability status of
the object. SYSCOPY information is probably not useful Explanation: Recovery was requested for an entire
as no recoverable point (FULL IMAGE COPY, REORG object. If the object is a table space, then the latest
LOG(YES) or LOAD REPLACE LOG(YES)) was found activity on the entire table space was a REORG LOG
by the RECOVER utility. User information might be the (NO) or a LOAD LOG (NO). If the object is an index
only indication about recoverability. space, then the latest activity on the entire index space
was a REORG INDEX or REBUILD INDEX. If full image
To allow RECOVER to execute, copy pending status
copies have been taken at the data set level since then,
must be turned off. It is safest to make a full image
recover the object on the data set level.
copy before attempting the recovery. Then run the
RECOVER utility with the TORBA or TOLOGPOINT Severity: 8 (error)
option.
System Action: RECOVER completes unsuccessfully
If you suspect an error in DB2, refer to Part 2 of DB2 with a return code of 8.
Diagnosis Guide and Reference for information on
User Response: Submit a recover job by specifying
identifying and reporting the problem.
DSNUM (data set number) for each data set requiring
Problem Determination: Collect the following recovery. If the object is an index space, then the
diagnostic items listed in “Appendix B. Problem REBUILD INDEX utility may be used to rebuild the
determination” on page 1281: 1, 2, 5. index. Refer to DB2 Utility Guide and Reference for a
discussion of RECOVERY utility constraints.
DSNU512I csect-name DATA SET LEVEL
RECOVERY IS REQUIRED FOR obj-type DSNU515I csect-name THE IMAGE COPY DATA
obj-qual.obj-name SET dsn WITH DATE=date AND
TIME=time IS PARTICIPATING IN
Explanation: Recovery was requested for an entire
RECOVERY OF obj-type
object. However, there is an image copy made for a
obj-qual.obj-name
specific data set associated with the object. Hence, the
object must be recovered by data set. Explanation: This message is issued by the
RECOVER utility for each participating image copy data
Severity: 8 (error)
set before it opens the data set and begins the restore
System Action: RECOVER completes unsuccessfully process. If an error occurs while processing, the utility
with a return code of 8. searches for a new recoverable base.
User Response: Terminate the current RECOVER job. This message is routed to SYSOUT.
Then, submit a RECOVER job by specifying
Severity: 0 (informational)
’DSNUM(data set number)’ for each data set for which
recovery is required. Refer to DB2 Utility Guide and System Action: RECOVER processing continues.
Reference for a discussion of RECOVERY utility
User Response: Refer to DB2 Utility Guide and
constraints.
Reference for a discussion of RECOVERY utility
constraints.
DSNU513I csect-name RECOVER UTILITY LOG
APPLY RANGE IS RBA xxx LRSN xxx
DSNU516I csect-name NO FULL IMAGE COPY
TO RBA yyy LRSN yyy
AFTER LOAD OR REORG LOG(NO) OF
Explanation: The RECOVER utility issues this obj-type obj-qual.obj-name
message one or more times to display the entire log
Explanation: RECOVERY was requested for a data
range before applying updates. The RBA and LRSN
set of an object. If the object is a table space, then a full
values are equal in a non-data sharing environment.
image copy was not taken after or during a LOAD or
The RBA values will be zero in a data sharing
REORG without logging. The table space is in an
environment for the catalog and directory objects that
unrecoverable state. If the object is an index space,
do not have DSNDB01.SYSLGRNX entries. This
then a full image copy was not taken after a REORG
includes catalog table spaces DSNDB06.SYSCOPY and
INDEX or REBUILD INDEX.
DSNDB06.SYSGROUP and all of their indexes, and all
of the directory objects. Severity: 8 (error)
Chapter 18. DB2 Messages 509
DSNU517I • DSNU520I
System Action: RECOVER completes unsuccessfully RECOVER, RECOVER PAGE, or REPAIR utility to
with a return code of 8. correct the broken page. Refer to Part 4 (Volume 1) of
DB2 Administration Guide. If you suspect an error in
User Response: If the object is a table space, the
DB2, refer to Part 2 of DB2 Diagnosis Guide and
data set is in an unrecoverable state. If the object is an
Reference for information on identifying and reporting
index space, then the REBUILD INDEX utility may be
the problem.
used to rebuild the index. Notify the system programmer
for corrective action.
DSNU519I csect-name TOCOPY DATA SET NOT
System Programmer Response: The data should be
FOUND
repaired before a full image copy is taken. The recovery
information for the object (use the REPORT Explanation: The data set specified with the keywords
RECOVERY utility) should be scrutinized. Refer to Part TOCOPY, TOVOLUME, or TOSEQNO cannot be found
4 (Volume 1) of DB2 Administration Guide for a in the SYSCOPY table for the object to be recovered.
discussion of database recovery procedures.
This may be caused by a mismatch in granularities. If
the RECOVER specifies a particular DSNUM, the data
DSNU517I csect-name - SYSCOPY RECORD set specified with the TOCOPY keyword may be for an
DELETED BY MODIFY UTILITY. image copy of this DSNUM or of the entire table space
DSN=dsn, VOL=SER=nnn, or index space. However, if the RECOVER is for the
FILESEQNO=fff entire table space or index space, the specified data set
must be for an image copy of the entire table space or
Explanation: This message is repeated for each
index space.
volume of a multivolume data set that is deleted.
This message may also be issued if TOVOLUME is
The variables have the following meanings:
specified for a cataloged data set.
dsn The name of the image copy data set whose
record was removed from the SYSCOPY table RECOVER TOCOPY can issue DSNU519I even if the
by the MODIFY utility. data set information was correct but the data set was
nnn The serial number of the volume containing the not for this site. For example, if the DB2 subsystem is
data set. specified as LOCALSITE, but the TOCOPY data set
fff The tape file sequence number. It will be zero information is for a RECOVERYSITE data set, this
for DASD data sets. message will be issued.
Severity: 0 (informational) Severity: 8 (error)
System Action: The MODIFY utility continues its System Action: RECOVER processing is terminated.
termination processing.
User Response: Correct the input and resubmit the
System Programmer Response: Because DB2 no RECOVER job.
longer has any knowledge of the image copy data set,
you may delete it and reuse the space. If the last full
DSNU520I csect-name RECOVER TO A PRIOR
image copy was deleted, ensure that another one is
POINT IN TIME MIGHT LEAVE TABLE
taken as soon as possible.
SPACE table-space-name
INCONSISTENT
DSNU518I csect-name object-type
Explanation: RECOVER DSNUM to a previous point
object-qualifier.object-name CONTAINS
in time (for example, using the TOLOGPOINT option)
BROKEN PAGE page-number, ERROR
was specified for a nonpartitioned table space. You
CODE error
might have recovered a data set that has different
Explanation: A broken page, page number, was compression characteristics than the replaced data set.
detected during execution of an image copy utility job. For example, the data set to which you recovered might
The copy step is terminated and the broken page is not have been compressed with a different dictionary.
copied to the output data set.
Severity: 4 (warning)
Severity: 8 (error)
System Action: Processing continues.
System Action: COPY utility ends with a return code
User Response: The table space might be in an
of 8.
inconsistent state. If the dictionary was not built with the
User Response: The associated data set has not data set that was just recovered, the results are
been copied. If the object is in the COPY-pending unpredictable and might jeopardize all the data in the
status, it is in an unrecoverable state. Notify the system entire table space.
programmer for corrective action.
Recover all of the data sets in the table space to the
System Programmer Response: Use either the same point in time. Do not ignore this message unless
510 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU521I • DSNU523I
all data sets in this table space were recovered to the use of an index’s full image copy by recovery is
same point in time. Otherwise, the state of this prohibited by a REORG or LOAD on its underlying table
nonpartitioned table space is inconsistent and space.
unpredictable.
Severity: 8 (error)
System Action: Utility processing is terminated. All
DSNU521I csect-name - RECOVER UTILITY
objects in the RECOVER statement are left in the same
FAILED. UNABLE TO READ REQUIRED
state as before the RECOVER utility was invoked.
LOG RECORDS.
User Response: Use the REBUILD INDEX utility to
Explanation: Recovery was requested for a table
rebuild the index from the table space. For more
space, index space, or data set. An attempt was made
information about the recoverability of this index, run the
to apply changes from the DB2 log, but the necessary
REPORT RECOVERY utility on both the index and its
log records could not be read from the log data set.
table space.
This message is accompanied by message DSNI007I.
Severity: 8 (error)
DSNU523I csect-name - RECOVER UTILITY
System Action: The RECOVER utility completes FAILED. NO FULL IMAGE COPY WAS
unsuccessfully with return code 8. AVAILABLE AND THE FIRST LOG
RECORD WAS NOT THE REQUIRED
User Response: Consult the system programmer for
INITIALIZATION RECORD.
corrective action.
Explanation: RECOVER was requested for a table
Operator Response: Provide the console listing of the
space or a data set of a table space and no image copy
DSNI007I message for the system programmer.
was available. Recovery was attempted from the log
System Programmer Response: Run the print log and failed due to missing data set initialization records.
map (DSNJU004) utility. Find the data set that contains Specifically, the log records which format space map
the requested RBA or LRSN from the output of the and header pages were missing.
utility.
Severity: 8 (error)
Problem Determination: If no listed data set contains
System Action: RECOVER completes unsuccessfully
the required RBA or LRSN, one of the following might
with a return code of 8.
have occurred:
v The data set was deleted from the bootstrap data set User Response: The associated data set has been
(BSDS) by the change log inventory (DSNJU003) reset to an empty state. Notify system programmer for
utility. Rerun the utility to insert the missing data set corrective action.
name. DB2 must be stopped to run this utility. System Programmer Response: Use the problem
v The BSDS was damaged. The BSDS can be restored determination information given below to determine if a
using the dump and the most recent archive log data user error has occurred. If possible, correct the error
set. Run the change log inventory (DSNJU003) tility and resubmit the RECOVER utility job for this table
to supply changes that occurred during and after the space or data set. Refer to Part 4 (Volume 1) of DB2
last offload operation. Changes can be determined Administration Guide for a discussion of possible
from the operator’s console listing. recovery procedures.
Problem Determination: This message was preceded
If a listed log data set contains the required RBA or
by message DSNU513I which identifies the log RBA
LRSN, this message is preceded by one or more
range being applied. Run the print log map (DSNJU004)
DSNJxxx error messages. See the explanation of those
utility for the table space in question over the indicated
messages for the appropriate action.
log RBA range.
This will show what log records are present and may
DSNU522I csect-name RECOVER CANNOT
assist in determining if a log data set has been
PROCEED FOR obj-type
damaged or deleted, or if the BSDS has been
obj-qual.obj-name BECAUSE A
damaged. If damage to table space
NON-RECOVERABLE EVENT HAS
DSNDB01.SYSLGRNX is suspected, recover it and
BEEN ENCOUNTERED FROM
attempt the earlier failing recovery again.
SYSIBM.SYSCOPY WHICH HAS
DBNAME=dbname TSNAME=tsname
DSNUM=dsnum ICTYPE=ictype
START_RBA=X’rba’
Explanation: Recovery was requested for an index,
but activity on its table space (identified by the
SYSIBM.SYSCOPY columns) prohibits recovery. The
Chapter 18. DB2 Messages 511
DSNU524I • DSNU528I
RECOVER utility with the TOCOPY, TORBA, or
DSNU524I csect-name INVALID DATA SET OR
TOLOGPOINT option to force recovery to an earlier
PARTITION NUMBER num SPECIFIED
point in time. You can use the DSN1COPY utility to
FOR obj-type obj-qual.obj-name
restore the data set to an earlier image copy. Refer to
Explanation: An invalid number was specified for the Part 4 (Volume 1) of DB2 Administration Guide for a
data set or partition of the object named in the utility discussion of database recovery procedures.
statement.
Severity: 8 (error) DSNU527I csect-name DB2 OBJECT REBUILT TO
AN INDETERMINATE POINT
System Action: Further utility processing terminates.
Explanation: The image copy data set specified with
User Response: Correct the data set/partition number,
the TOCOPY keyword of the REBUILD utility was one
or verify that the object name is specified correctly.
of the following:
Then resubmit the utility statement in a new utility job
step. Refer to DB2 Utility Guide and Reference for a v An image copy dataset made with the SHRLEVEL
description of the particular utility options. CHANGE option. In this mode, changes might have
been made to the object while image copy was in
progress. If a change was made to a page before
DSNU525I csect-name RECOVERY DATA DOES image copy processed the page, the update will be in
NOT PERMIT DSNUM(ALL) RECOVERY the copy data set. If a change was made to a page
OF obj-type obj-qual.obj-name after image copy processed it, the change will not
Explanation: Recovery was requested for an entire appear in the copy data set. The data set may
object. However, the object is not recoverable at that contain partial updates from some transactions.
level for one of the following reasons: v An image copy dataset made during the LOAD
v The object was recovered to a point in time (for REPLACE utility. An image copy produced during
example, TOLOGPOINT was specified), which LOAD REPLACE will not contain updates made to
required fall back processing. However, no the table space to correct unique index violations
subsequent image copy was taken to establish a during the INDEXVAL phase or referential constraint
base for recovery. violations during the ENFORCE phase. Therefore, it
is not recommended as a REBUILD y point.
v A partition of the object was recovered to a point in
time after the last full image copy of the object was
If the object REBUILT is a table space, then indexes on
taken.
the table space are placed in REBUILD pending status
Severity: 8 (error) and dependent table spaces, if any, are placed in check
pending status. The indexes placed in REBUILD
System Action: The RECOVER utility completes pending are identified by message DSNU557I, and the
unsuccessfully with return code 8. dependent table spaces placed in check pending are
User Response: Submit the RECOVER job with identified by message DSNU563I.
DSNUM specified for each data set for which recovery Severity: 4 (warning)
is required. Refer to DB2 Utility Guide and Reference
for information about the RECOVER utility. System Action: The utility terminates normally.
User Response: Based on the explanation above,
DSNU526I csect-name - NO FULL IMAGE COPY determine if the REBUILD y is satisfactory. Rebuild the
AFTER PARTIAL RECOVERY OF indexes identified by message DSNU557I in the job
obj-type obj-qual.obj-name output. Run CHECK DATA on the table spaces
identified by message DSNU563I to correct any
Explanation: Recovery was requested for a data set referential constraint violations.
of an object. However, an earlier point-in-time recovery
(for example, using the TOLOGPOINT option) was Refer to Part 4 (Volume 1) of DB2 Administration Guide
specified and no subsequent image copy was taken to for a discussion of database REBUILD procedures.
establish a base for recovery. The object is in a
nonrecoverable state.
DSNU528I NO FULL IMAGE COPY WAS
Severity: 8 (error) AVAILABLE AND THERE ARE NO
UPDATES TO APPLY FROM THE DB2
System Action: The RECOVER utility completes LOG FOR TABLESPACE
unsuccessfully with return code 8. tablespace-name DSNUM dsnum
User Response: The associated data set is in a Explanation: Recovery was requested for a table
nonrecoverable state. Consult the system programmer space or a data set of a table space and no image copy
for corrective action. was available. If dsnum is 0, then recovery was
System Programmer Response: You can use the requested at the table space level. Recovery was
512 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU529I • DSNU531I
attempted from the log, but no log records were applied SYSIBM.SYSCOPY for the object with the same data
because no SYSLGRNX records corresponding to the set name.
recovery scope were found.
Severity: 8 (error)
Severity: 8 (error)
System Action: Processing halts for this object.
System Action: The associated data set was reset to
RECOVER completes unsuccessfully with a return code
an empty state and the data set was placed in
of 8.
REBUILD PENDING status. If REBUILD was processing
a TABLESPACE list, only the associated data set was For the COPYTOCOPY utility, if the utility job step
reset to an empty state but all data sets in the list were includes an OPTIONS control statement with the
placed in REBUILD PENDING status. EVENT(ITEMERROR,SKIP) option, the utility will
process the next item in the list.
User Response: If the TORBA or TOLOGPOINT
option was specified, use the information in the problem User Response: Two or more DSNU531I messages
determination section to verify that it is a valid RBA or will follow this message providing more information
LRSN. Correct the error and resubmit the REBUILD about each duplicate data set. Select the correct data
utility for the table space. set from the DSNU531I messages.
System Programmer Response: Use the information Rerun the RECOVER job, specifying a unique
in the problem determination section to determine if a combination of TOVOLUME and TOSEQNO.
user error occurred. Correct the error and resubmit the
REBUILD utility for the table space. Also refer to Part 4 Rerun the COPYTOCOPY job, specifying an unique
(Volume 1) of DB2 Administration Guide for a combination of FROMVOLUME and FROMSEQ.
discussion of possible recovery procedures.
Problem Determination: Execute the REPORT DSNU531I csect-name - dsn EXISTS WITH -
RECOVERY utility for the table space at the appropriate VOLUME=vol, FILE SEQUENCE
table space or data set level (that is, DSNUM). The NUMBER=fseq, RBA=rba, DATE=date,
output shows the recovery points (SYSCOPY records) TIME=time
and the update log ranges (SYSLGRNX records) that Explanation: DB2 issues this message two or more
exist for the table space. times to document the duplicate data sets detected by
the RECOVER utility during TOCOPY processing, or by
DSNU529I csect-name INVALID SPECIFICATION the COPYTOCOPY utility during FROMCOPY
OF TORBA = xxx procesing. See the explanation for message DSNU530I.
Explanation: 'xxx' is the log RBA specified for the Severity: 8 (error)
RECOVER utility TORBA keyword. The RBA is not System Action: RECOVER completes unsuccessfully
within the scope of the log. with a return code of 8.
Severity: 8 (error) For COPYTOCOPY, if the utility job step includes an
System Action: The RECOVER utility terminates with OPTIONS control statement with the
a return code of 8 without making any changes to the EVENT(ITEMERROR,SKIP) option, the next item in the
object to be recovered. list will be processed.
User Response: Correct the input and resubmit the User Response: Use the information provided in all of
job. Refer to Part 4 (Volume 1) of DB2 Administration the DSNU531I messages to determine the correct data
Guide for a discussion of database recovery set for this recovery. 'rba', 'date' and 'time' are provided
procedures. for each data set to assist in the selection. The
DSNU531I message for the data set you select will
Problem Determination: The listing produced by the provide the correct 'vol' and 'fseq' values to be specified
print log map (DSNJU004) utility will show the current on the TOVOLUME and TOSEQNO keywords
extent of the DB2 log. respectively.
Rerun the RECOVER job specifying TOCOPY and
DSNU530I csect-name - MULTIPLE DATA SETS TOVOLUME(vol-ser). Include the TOSEQNO(fseq)
FOUND FOR THE COPY DATA SET keyword if it is necessary to distinguish an unique data
SPECIFICATION set.
Explanation: DB2 issues this message during the Rerun the COPYTOCOPY job specifying FROMCOPY
RECOVER or COPYTOCOPY utility when the and FROMVOLUME(vol-ser). Include the
specification of the input image copy dataset is FROMSEQNO(fseq) keyword if it is necessary to
ambigous and does not uniquely identify an image copy. distinguish a unique data set.
Multiple image copies were found in
Chapter 18. DB2 Messages 513
DSNU532I • DSNU537I
DSNU532I csect-name - RECOVER obj-type DSNU535I csect-name - FOLLOWING
obj-qual.obj-name START TABLESPACES RECOVERED TO A
CONSISTENT POINT
Explanation: This message is issued when there is
more than one object in the list. It indicates that the Explanation: This message will be issued by the
recover of a particular object is starting. If the RECOVER utility when it determines that a table space
PARALLEL keyword has been specified, then the set (a group of referentially related table spaces or a
restore phase messages for different objects in the list base table space and its lob table spaces) were
may be intermingled. recovered to a quiesce or to a common image copy
SHRLEVEL(REFERENCE) point. All table spaces in the
This message is routed to SYSPRINT.
table space set will be listed after this message
Severity: 0 (informational) heading.
System Action: RECOVER processing continues. Severity: 0 (informational)
System Action: No action is taken.
| DSNU533I csect-name - obj-type obj-qual.obj-name
| IS A DUPLICATE OF obj-type
DSNU536I csect-name - RELATIONSHIP r ON
| obj-qual.obj-name
TABLE t CREATED AFTER QUIESCE
| Explanation: The utility found a duplicate object in the POINT
| list. The object name may indicate a partition or piece
Explanation: The relationship named 'r' was created
| number.
on the dependent table, 't', after the quiesce point used
| Severity: 8 (error) for recovering to a point in time. The table space in
which 't' resides is set to check pending beginning with
| System Action: The utility job terminates processing. the first record of 't'.
| User Response: Correct the object list. Resubmit the Severity: 4 (warning)
| job if needed.
System Action: No action is taken.
DSNU534I csect-name TARGET RECOVERY POINT User Response: Refer to Part 2 (Volume 1) of DB2
IS NOT A QUIESCE POINT Administration Guide for the failure analysis procedure
for the check pending state.
Explanation: The RECOVER utility attempted to
recover to a point in time (for example, using the
TOLOGPOINT option) and one of the following DSNU537I csect-name obj-type obj-qual.obj-name IS
conditions has been detected: NOT ALLOWED IN THE LIST
v The table space set is not being recovered to a Explanation: The RECOVER or COPY utility found a
quiesce point or to a common image copy directory or catalog table space in a list with other table
SHRLEVEL(REFERENCE) point. spaces or with user-defined indexes.
v Not all table spaces in the table space set have the
The table spaces that the COPY utility will not allow in a
same quiesce point.
list with other table spaces are DSNDB01.SYSUTILX,
v A table space in the set contains a dependent table DSNDB06.SYSCOPY, and DSNDB01.SYSLGRNX.
with a referential constraint that was defined after the However, these table spaces may be specified with their
specified quiesce point. IBM-defined indexes in a list.
A table space set is a group of table spaces that are You cannot recover more than one directory or catalog
referentially related or it can be a base table space and table space in a list. Directory and catalog table spaces
its associated LOB table spaces. must be recovered individually in a particular order
because the recovery of some objects depends on
Severity: 4 (warning) information derived from others. The correct order is
documented in Part 4 (Volume 1) of DB2 Administration
User Response: If possible, recover the table space
Guide. IBM-defined indexes may be specified with their
set to a quiesce point or a common image copy
associated directory or catalog table space in a list.
SHRLEVEL(REFERENCE) point. Otherwise, use the
CHECK DATA utility to check and correct referential Severity: 8 (error)
violations. Use the CHECK DATA utility on the base
table space and the CHECK LOB utility on the LOB System Action: The utility job terminates.
table space(s) to validate the LOB columns. User Response: Remove the directory and catalog
object names from the list. Then submit the COPY or
RECOVER job again.
514 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU538I • DSNU545I
DSNU538I RECOVER ERROR RANGE OF DSNU541I UNABLE TO ALLOCATE THE PRIMARY
DSN=dataset name ON COPY DATASET data-set-name,
VOLUME=volser FROM BACKUP COPY IS USED
CCHH=X’cccchhhh’ TO
Explanation: If RECOVER or MERGECOPY has an
CCHH=X’cccchhhh’ CONTAINS
allocation error on the primary copy data set, it will
PHYSICAL ERROR
locate the backup copy data set for the same system
Explanation: This message indicates that the error (local or recovery). The utility continues.
range involved in the error range recover 'dataset name'
Severity: 0 (informational)
is the data set which has the physical error. The data
set resides on DASD volume 'volser' and the error
range is from track address X'cccchhhh' to track DSNU542I csect-name - UNABLE TO OPEN THE
address X'cccchhhh'. PRIMARY COPY DATASET
dataset-name, BACKUP COPY IS USED
If the error range of a data set covers more than one
extent or more than one volume, then there will be one Explanation: If RECOVER or MERGECOPY has an
message per extent per volume. open error in the primary copy data set, it will deallocate
that copy data set and try to allocate the backup copy
Severity: 8 (error)
data set for that same system (local or recovery). The
System Action: Physical I/O error is detected during utility continues.
error range recover, processing terminated with return
Severity: 0 (informational)
code 8.
System Programmer Response: A DSNU086
DSNU543I csect-name - I/O ERROR READING
message is issued to the console by DB2 while running
PAGE page_number IN THE PRIMARY
error range recovery; this indicates that the physical
COPY DATASET dataset-name,
error is not recovered. User must run ICKDSF or
BACKUP COPY IS USED
equivalent service utility to recover the physical error
then re-run the error range recover again. Explanation: If RECOVER or MERGECOPY has an
I/O error when reading a page, with the specified page
Problem Determination: Use the information provided
number, from the primary copied data set, it will locate
by this message to run ICKDSF and then run error
the backup copied data set in that same system (local
range recover again.
or recovery) and continue reading pages starting from
the page number in error.
DSNU539I csect-name - RECOVER PROCEEDS AT
Severity: 0 (informational)
THE site-type SYSTEM
Explanation: The RECOVER process continues at the
DSNU544I csect-name - UNABLE TO OPEN THE
RECOVERY SITE system, and/or the TRACKER SITE
COPY DATASET dataset-name FOR THE
system. DB2 issues this message for informational
RECOVERY OF obj-type
purposes only.
obj-qualifier.obj-name, RC= reason-code
Severity: 0 (informational)
Explanation: RECOVER was unable to open the data
System Action: The utility continues. set 'dataset-name'. because of 'reason-code' from the
open abend. The 'reason-code' is taken from field
SDWAABCC in the SDWA.
DSNU540I csect-name DYNAMIC ALLOCATION
FOR DATA SET data-set-name WILL Severity: 0 (informational)
WAIT FOR UNIT TO BECOME
System Action: The RECOVER utility continues
AVAILABLE
processing, searching for the prior image copy or
Explanation: A request to dynamically allocate a data applying log records.
set for a BATCH UTILITY job was refused because a
unit was not available. The request was repeated after
DSNU545I csect-name - I/O ERROR READING
setting an indicator in the dynamic allocation parameter
PAGE page-number IN THE COPY
list to cause the job to wait until a unit becomes
DATASET dataset-name DURING
available.
RECOVERY OF obj-type
Severity: 0 (informational) obj-qual.obj-name
System Action: Processing continues after a unit Explanation: An I/O error was detected while reading
becomes available and is allocated. page 'page-number' from copy dataset 'dataset-name'.
The message is issued when 1) The data set is the
primary copy data set and there is no backup data set.
Chapter 18. DB2 Messages 515
DSNU546I • DSNU551I
2) Open error is from the backup copy data set.
DSNU548I DBID=X'xxxx' and PSID=X'xxxx' IN THE
Severity: 0 (informational) HEADER PAGE OF obj-type
obj-qual.obj-name DO NOT MATCH THE
System Action: The RECOVER utility continues DB2 CATALOG.
processing, searching for the prior image copy or
applying log records. Explanation: The DBID and PSID in the header page
do not match the DB2 catalog. It is likely that the wrong
data sets were restored.
DSNU546I LOGONLY RECOVER CANNOT
PROCEED BETWEEN BEGINNING RBA Severity: 8 (error)
'xxxxxxxxxxxx' AND ENDING RBA
System Action: The RECOVER utility job terminates
'yyyyyyyyyyyy' ON DSNUM dsnum
with return code 8.
BECAUSE A NON-RECOVERABLE
EVENT HAS BEEN ENCOUNTERED System Programmer Response: Find the correct
FROM SYSIBM.SYSCOPY WHICH HAS data sets and rerun the job.
DBNAME=database-name
TSNAME=space-name DSNUM=dsnum
DSNU549I RECOVER obj-type obj-qual.obj-name
ICTYPE=x
dsnum USES ONLY DB2 LOGS
START_RBA=X'zzzzzzzzzzzz'.
STARTING FROM
Explanation: A nonrecoverable event (for example, LOGPOINT=X'xxxxxxxxxxxx'.
LOAD LOG(NO), REORG LOG(NO)) occurred within
Explanation: The RECOVER utility issues one
the log range between the beginning log RBA or LRSN
message for each DB2 object that uses only DB2 logs
and ending log RBA or LRSN for the RECOVER
to recover. In a non data-sharing environment, the
LOGONLY utility.
LOGPOINT value is specified by an RBA; in a data
This message is issued by the following CSECT: sharing environment it is specified by an LRSN.
DSNUCASA
Severity: 0 (informational)
Severity: 8 (error)
System Action: RECOVER utility processing
System Action: The RECOVER utility completes continues.
unsuccessfully with return code 8.
System Programmer Response: Find a proper prior DSNU550I csect-name INDEX NAME= index-name
point in time as a target recovery point and rerun the IS EMPTY
RECOVER utility job with the TORBA, TOCOPY, or
Explanation: While attempting to REBUILD the
TOLOGPOINT option. For a discussion of database
indicated index, it was determined that the table upon
recovery procedures, refer to Part 4 (Volume 1) of DB2
which the index is based is empty.
Administration Guide .
Severity: 4 (warning)
DSNU547I LOGONLY RECOVER CANNOT System Action: Utility processing proceeds to the
PROCEED BECAUSE THE STARTING next utility request, if any.
RBA=X'xxxxxxxxxxxx' IN THE HEADER
PAGE PGNO=X'xxxxxx' FOR obj-type
obj-qual.obj-name IS INVALID. DSNU551I csect-name INDEX NAME= index-name
PART=part-num IS EMPTY
Explanation: One of the following occurred:
Explanation: While attempting to REBUILD the
v The data set was restored from an earlier release indicated index partition, it was determined that the
backup that does not have a starting RBA or LRSN in partition upon which the specified index partition is
the header page. based is empty.
v The TORBA or TOLOGPOINT option is specified to
an RBA or LRSN that is lower than the starting RBA Severity: 4 (warning)
or LRSN in the header page. System Action: Utility processing proceeds to the
Severity: 8 (error) next utility request, if any.
System Action: The RECOVER utility job terminates
with return code 8.
System Programmer Response: Use the RECOVER
utility without the LOGONLY option, if possible, or
change the RBA or LRSN of the TORBA or
TOLOGPOINT option to a valid RBA or LRSN value.
516 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU552I • DSNU557I
DSNU552I csect-name RECOVER CANNOT DSNU556I csect-name - RECOVER CANNOT
PROCEED BECAUSE THE PROCEED FOR obj-type
starting/ending LOGPOINT xxx IS NOT obj-qual.obj-name DSNUM x BECAUSE
WITHIN THE RECOVERY RANGE OF A SYSIBM.SYSCOPY RECORD HAS
xxx AND xxx FOR obj-type BEEN ENCOUNTERED WHICH HAS
obj-qual.obj-name DBNAME= dbname TSNAME= tsname
DSNUM= dsnum ICTYPE= ictype
Explanation: The starting or ending LOGPOINT found
STARTRBA=X’rba’ LOWDSNUM=
for this recovery job is outside the available recovery
lowdsnum HIGHDSNUM=highdsnum.
information. A LOGPOINT value is an RBA or LRSN.
The RECOVER utility cannot process this request. Explanation: A SYSCOPY record has been
encountered that prohibits recovery processing. If the
Severity: 8
ICTYPE column is a:
System Action: The RECOVER utility terminates.
R,S,W, or X
User Response: Use the recovery information that is Then a SYSCOPY record for a REORG or
available from the REPORT utility. Execute the LOAD REPLACE that redistributed data across
RECOVER utility within the available recovery range. partitions has been encountered. The partitions
affected by the ALTER INDEX that changed
the limit keys must be recovered in the same
DSNU553I csect-name INVALID PARTITION list.
NUMBER=nnnn SPECIFIED FOR INDEX
NAME=iiii A An attempt has been made to recover an index
to a point in time prior to a first Alter Table
Explanation: An invalid partition number nnnn was Column that altered the index key column. This
specified for index iiii in the utility statement. is not allowed.
Severity: 8 (error) F An attempt has been made to recover an index
System Action: Further utility processing is to a prior point in time and more than sixteen
terminated. Alter Table Columns have been done that
altered the index key since that time. This is
User Response: Correct the partition number or verify not allowed.
that the index name is specified correctly, and resubmit
the utility statement in a new utility job step. Refer to Severity: 8 (error)
DB2 Utility Guide and Reference for a description of the System Action: The Recover Utility terminates with
particular utility options. RC8.
User Response: If a SYSCOPY record for a REORG
DSNU554I csect-name - DUPLICATE INDEX or LOAD REPLACE that redistributed partition data was
NAMES EXIST IN THE SPECIFIED encountered, then add the missing partitions to the
INDEX NAME LIST recover list using the LOWDSNUM and HIGHDSNUM
Explanation: When attempting to CHECK or values as a guide. For the other cases, use the
REBUILD the indicated indexes, it was determined that REBUILD INDEX Utility to rebuild the index.
duplicate index names were specified in the index name
list. DSNU557I csect-name - obj-type obj-qual.obj-name
Severity: 8 (error) IS IN REBUILD PENDING STATE
System Action: The utility job terminated. Explanation: If the REBUILD utility issued this
message, the corresponding table space to this index
User Response: Correct the index-name(s) in the was REBUILDed to a point in time with keyword
index name list and resubmit the job. TOCOPY, TOLOGPOINT, or TORBA. Thus, the index
was placed in REBUILDy pending status.
DSNU555I csect-name UNLOAD PHASE If the REBUILD INDEX utility issued this message, the
STATISTICS, NUMBER OF index is in REBUILD pending status. Either duplicate
RECORDS=xxxx index entries existed during the BUILD phase of the
Explanation: This message is issued at the normal REBUILD INDEX, or invalid KEY/RIDs, which do not
completion of the UNLOAD phase of the REBUILD belong to the partition of the cluster index, were
INDEX utility. It gives the number of records that were detected. The duplicate index entries or invalid KEY/RID
unloaded (xxxx) for the specified table space. entries must be resolved before starting the REBUILD
INDEX utility again to REBUILD the index and remove
Severity: 0 (informational) the index from REBUILD pending status.
If the REORG utility with SHRLEVEL REFERENCE or
Chapter 18. DB2 Messages 517
DSNU558I • DSNU561I
CHANGE (or -TERM UTILITY) issued this message, the one partition of a partitioned index was placed in rebuild
index is in REBUILD pending status. During the pending status. During the renaming of a data set
renaming of a data set during REORG, either a data set during REORG, either a data set with the source name
with the source name did not yet exist or a data set with did not yet exist or a data set with the target name
the target name already existed. already existed.
Severity: 4 (warning) or 8 (error) Severity: 4 (warning) or 8 (error)
User Response: If the REBUILD or REORG utility (or User Response: If the REBUILD or REORG utility (or
-TERM UTILITY) issued this message, use the -TERM UTILITY) issued the message, rebuild this index
REBUILD INDEX utility to REBUILD this index. with the REBUILD INDEX utility.
If the REBUILD INDEX utility issued this message, take If the REBUILD INDEX utility issued this message, take
one of the following actions: one of the following actions:
v Resolve the duplicate index entries or invalid keys v Resolve duplicate index entries or invalid keys and
and rerun the REBUILD INDEX utility. rerun the REBUILD INDEX utility.
v Use the REPAIR SET NORCVRPEND utility or the v Use the REPAIR SET NORCVRPEND utility or
START DATABASE FORCE command to reset the START DATABASE FORCE command to reset the
REBUILD pending status. However, these two rebuild pending status. However, these two options
options will not correct the index. will not correct the index.
DSNU558I csect-name ALL INDEXES OF DSNU560I csect-name - TABLESPACE=
TABLESPACE= table space-name ARE database.tablespace PART= partition
IN REBUILD PENDING number IS IN RECOVERY PENDING
STATE
Explanation: The REBUILD TORBA, TOLOGPOINT,
or TOCOPY utility issues this message to inform the Explanation: The table space partition of a table
user of the state of all indexes belonging to the space on which the utility was running is in recovery
REBUILDed table space. All indexes were put in pending status. A RECOVER TABLESPACE at the
REBUILD pending status to prevent data and index partition level is required.
inconsistency. All indexes should be REBUILDed before
Severity: 4 (warning)
they are used.
System Action: No action is taken.
System Action: The REBUILD utility completed
successfully. User Response: Take one of the following actions:
Severity: 4 (warning) v Run the RECOVER TABLESPACE utility on the table
space partition.
User Response: REBUILD or rebuild all indexes of
v Run the LOAD REPLACE utility on the table space
the REBUILD table space.
partition.
v Use the REPAIR SET NORCVRPEND utility or the
DSNU559I csect-name - obj-type obj-qual.obj-name START DATABASE FORCE command to reset the
PARTITION partition number IS IN recovery pending status. However, these two options
REBUILD PENDING STATE will not correct the table space.
Explanation: If the REBUILD utility issued this
message, one partition of a partitioned table space is DSNU561I csect-name - obj-type obj-qual.obj-name
being rebuilt to a point in time with keyword TOCOPY, PARTITION part-number IS IN CHECK
TOLOGPOINT, or TORBA. The corresponding index for PENDING
that partition was placed in rebuild pending status.
Explanation: This message is issued to report the
If the REBUILD INDEX utility issued this message, the check pending state of the specified partition.
index or the partition of a cluster index is in rebuild
pending status. Either duplicate index entries existed Severity: 4 (warning)
during the BUILD phase of the REBUILD INDEX or User Response: If the object is a table space partition
INDEX PART, or invalid KEY/RIDs, which do not belong with referential relationships, then run the CHECK DATA
to the partition of the cluster index, were detected. The utility to check for referential integrity violations.
duplicate index entries or invalid KEY/RID entries must
be resolved before starting the REBUILD INDEX utility If the object is a base table space partition, then run the
again to rebuild the index and remove the index from CHECK DATA utility to validate the auxiliary columns.
rebuild pending status.
If the object is an index space partition, then run the
If the REORG utility with SHRLEVEL REFERENCE or CHECK INDEX utility to verify that the index keys are
CHANGE (or -TERM UTILITY) issued this message, consistent with the data in the table space partition.
518 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU562I • DSNU566I
Correct all errors before attempting to use the object Severity: 8 (error)
again.
System Action: The utility job terminates. If
RECOVER acts on a list of objects, the restarted job
DSNU562I csect name - TABLESPACE terminates with the first object for which restart is not
database.tablespace IS IN RECOVERY allowed.
PENDING
User Response: For case 1, execute REPORT
Explanation: The table space against which the utility RECOVERY on the object and also collect the output
was running is in recovery pending status. A RECOVER from the previous execution of RECOVER
TABLESPACE is required. TABLESPACE. Using those two outputs and the
console log, determine the reason for the failure during
Severity: 4 (warning)
the RESTORE phase. Correct the reason for the failure,
System Action: No action is taken. if necessary. Terminate the outstanding utility then rerun
the RECOVER TABLESPACE without RESTART.
User Response: Take one of the following actions:
v Run the RECOVER TABLESPACE utility on the table For case 2, restart the utility with RESTART(CURRENT)
space. or restore the data sets and rerun the RECOVER job
from the beginning.
v Run the LOAD REPLACE utility on the table space.
v Use the REPAIR SET NORCVRPEND utility or the Collect the following diagnostic items listed in
START DATABASE FORCE command to reset the “Appendix B. Problem determination” on page 1281: 1,
recovery pending status. However, these two options
will not correct the table space. DSNU565I csect-name CHECK CONSTRAINT
constraint-name ON TABLE table-name
DSNU563I csect name- obj-type obj-qual.obj-name IS WAS CREATED AFTER THE TARGET
IN CHECK PENDING RECOVERY POINT
Explanation: This message is issued to report the Explanation: The check constraint constraint-name
check pending state of the specified object. was created on table table-name after the target
recovery point. The target recovery point is the specified
Severity: 4 (warning) time or RBA in the point-in-time recovery. The
associated table space was placed in check pending
User Response: If the object is a table space with
status because the RECOVER utility cannot determine
referential relationships, then run the CHECK DATA
whether check integrity was maintained. Data in the
utility to check for referential integrity violations.
table might have constraint violations.
If the object is a base table space with LOB columns,
Severity: 4 (warning)
then run the CHECK DATA utility to validate the
auxiliary columns. System Action: RECOVER processing continues.
If the object is a LOB table space, then run the CHECK User Response: Refer to Part 2 (Volume 1) of DB2
LOB utility to validate the structure of the LOB table Administration Guide for information about resolving the
space. check pending status.
If the object is an index space, then run the CHECK
INDEX utility to verify that the index keys are consistent DSNU566I csect-name RESTORE OF obj-type
with the data in the table space or table space partition. obj-qual.obj-name FROM DATA SET
data-set-name COMPLETED, ELAPSED
Correct all errors before attempting to use the object
TIME = hh:mm:ss
again.
Explanation: This message is issued at the successful
completion of the RESTORE phase of the RECOVER
DSNU564I csect - RESTART NOT ALLOWED FOR
utility when the DFSMSdss RESTORE command is
obj-type obj-qual.obj-name
issued. The data-set-name identifies the DFSMS
Explanation: Restart of the RECOVER utility is not concurrent copy that was being restored. The elapsed
allowed for one of the following reasons: time of the RESTORE is shown in hours, minutes, and
1. During the RESTORE phase, access to image seconds.
copies failed. Therefore, RECOVER determined an System Action: RECOVER utility processing
earlier point of recovery to search for available continues.
image copies. RECOVER might not be able to
recreate the original failures for restart. User Response: No action is required.
2. The utility uses the LOGONLY option and was
previously restarted with RESTART(CURRENT). It
cannot now be started with RESTART(PHASE).
Chapter 18. DB2 Messages 519
DSNU567I • DSNU572I
DB2, refer to Part 2 of DB2 Diagnosis Guide and
DSNU567I csect-name TABLESPACE=
Reference for information on identifying and reporting
dbname.tsname PART NUMBER =
the problem.
partition number IS IN REORG PENDING
STATE Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
Explanation: A SYSCOPY record for a range of
85,
partitions has be encountered. The RECOVER
TABLESPACE utility was executed against an object
which was the target of a partition rebalancing. The DSNU570I csect-name obj-type obj-qual.obj-name
RECOVER utility will set all of the partitions involved in PARTITION part-num IS IN
the partition rebalancing to REORG PENDING for one INFORMATIONAL COPY PENDING
of the following reasons:
Explanation: An image copy of the index partition is
v Recovery of a table space to a point in time prior to required to establish a new base from which the index
the resetting of the REORG PENDING state by the partition can be recovered. This is an advisory state, so
REORG utility. the index is available for read or write access.
v Recovery of a table space to currency, when the
table space is in REORG PENDING state. Severity: 4 (warning)
Severity: 4 (warning) User Response: Take an image copy of the index
partition or of the entire index, depending on your
System Action: The RECOVER utility completed backup and recovery procedures.
successfully.
User Response: Execute REORG with SHRLEVEL DSNU571I csect-name ALL site SYSCOPY
NONE on the partitions in REORG PENDING status to RECORDS FOR obj-type=
rebalance the partitions and to remove the REORG obj-qual.obj-name PARTITION=part-num
PENDING state. HAVE BEEN DELETED
Explanation: The MODIFY RECOVERY utility deleted
DSNU568I csect-name obj-type obj-qual.obj-name IS all of the SYSCOPY table records for the specified table
IN INFORMATIONAL COPY PENDING space or index space partition. Any related SYSLGRNX
rows are deleted if DSNUM ALL is specified. The
Explanation: An image copy of the index is required
'part-num' of specified table space or index space is no
to establish a new base from which the index can be
longer recoverable at the 'site'. The 'site' can be
recovered. This is an advisory state, so the index is
'LOCALSITE' or 'RECOVERYSITE'.
available for read or write access.
Severity: 4 (warning)
Severity: 4 (warning)
System Action: Utility processing continues.
User Response: Take an image copy of the index.
System Programmer Response: The 'part-num' of
specified table space or index space is no longer
DSNU569I csect-name RESTORE OF obj-type
recoverable at the 'site' after this message is received.
obj-qual.obj-name FROM DATA SET
Use the COPY utility to create one or more copies for
data-set-name FAILED WITH RETURN
the 'site' to establish a base for future recovery.
CODE return-code
Explanation: This message is issued in the
DSNU572I csect-name ALL site SYSCOPY
RESTORE phase of the RECOVER utility. The
RECORDS FOR obj-type=
DFSMSdss RESTORE command was issued to restore
obj-qual.obj-name HAVE BEEN
the DFSMS concurrent copy named data-set-name. The
DELETED
return code is from DFSMSdss RESTORE.
Explanation: The MODIFY RECOVERY utility deleted
Severity: 4 (warning)
all of the SYSCOPY table records for the specified table
System Action: The RECOVER utility searches for space or index space. Any related SYSLGRNX rows are
the next recoverable point. DFSMSdss issues ADR deleted if DSNUM ALL is specified. The table space or
messages to the job output to indicate the reason for index space is no longer recoverable at the 'site'. The
the return code. 'site' can be 'LOCALSITE' or 'RECOVERYSITE'.
User Response: You might want to investigate why Severity: 4 (warning)
this DFDSS RESTORE command failed. Collect any
System Action: Utility processing continues.
console messages. Look up the return code and any
ADR messages in the appropriate DFSMSdss manual. System Programmer Response: The table space or
index space is no longer recoverable at the 'site' after
Problem Determination: If you suspect an error in
this message is received. Use the COPY utility to create
520 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU573I • DSNU582I
one or more copies for the 'site' to establish a base for System Action: The LOGAPPLY phase continues
future recovery. normally.
DSNU573I csect-name NO BACKUP COPIES DSNU580I csect-name REPORT UTILITY
FOUND FOR THIS TABLESPACE OR COMPLETE, ELAPSED TIME=hh/mm/ss
DATASET
Explanation: The message is issued at the normal
Explanation: The MODIFY RECOVERY utility was completion of the REPORT utility. The time that elapsed
unable to locate any SYSCOPY records older than the since the beginning of the REPORT utility to its
specified AGE or prior to the specified DATE. No completion was 'hh' hours, 'mm' minutes, and 'ss'
records have been deleted. seconds.
Severity: 4 (warning) Severity: 0 (informational)
System Action: Processing completes normally. System Action: This message indicates the normal
completion of the REPORT utility. Processing continues
to the next utility statement in the utility job step, if any.
DSNU575I csect-name - MODIFY COMPLETED
If not, the utility job step is normally terminated, and the
SUCCESSFULLY
resources held become available for further processing.
Explanation: This message reports the successful The UTILID of the utility job step becomes available for
completion of the MODIFY utility. The requested reuse.
cleanup of old SYSIBM.SYSCOPY entries was
completed.
DSNU581I csect-name REPORT RECOVERY
Severity: 0 (informational) obj-type obj-qual.obj-name
System Action: The MODIFY utility completed Explanation: This message indicates the beginning of
normally. the recovery information report for a table space or
index space.
DSNU577I csect-name MODIFY HAS NOT Severity: 0 (informational)
DELETED ALL SYSCOPY RECORDS
System Action: Utility processing continues.
AS REQUESTED.
Explanation: If MODIFY RECOVERY is invoked with
DSNU582I csect-name REPORT RECOVERY
a partition-number (DSNUM), and the table space level
obj-type obj-qual.obj-name SYSCOPY
recoverable point is older than the user specified DATE
ROWS
or AGE, all SYSCOPY records after the table space
level recoverable point cannot be deleted. Explanation: This is the header message for the
SYSCOPY section of the REPORT RECOVERY output.
Severity: 4 (warning)
This section displays the SYSCOPY rows for the table
System Action: Processing continues normally. space or index space. Whether the information is
displayed at the partition level is determined by the
DSNUM specification in the REPORT RECOVERY input
DSNU578I csect-name SYSLGRNX INFORMATION statement. The fields in the SYSCOPY row are:
FOR MEMBER member-name v TIMESTAMP
Explanation: In the data sharing environment, the v ICTYPE
SYSLGRNX records reported with DSNU513 are The following delimiters may be present around the
grouped by the respective member name. Each group ICTYPE value: * * - Non image copy syscopy entry <
member has header message DSNU578 to identify the > - Image copy prior to rebalancing of table space
member. This message precedes DSNU513. partitions ( ) - Image copy prior to LOG(NO) event.
Note that for image copies of indexes, the LOG(NO)
System Action: The RECOVER utility continues with
event may have occurred on its underlying table
the LOGAPPLY phase.
space.
v DSNUM
DSNU579I csect-name RECOVER UTILITY LOG v FILESEQNO
APPLY AT LOGPOINT xxx v START_RBA
v SHRLEVEL
Explanation: This message shows the progress of the
v DEVTYPE
LOGAPPLY phase of the RECOVER utility. The highest
v ICBACKUP
LOGPOINT that was applied is xxx. The value of
v DSNAME
logpoint is RBA in a non data-sharing environment and
v STYPE
LRSN in a data sharing environment.
v PIT_RBA
Chapter 18. DB2 Messages 521
DSNU583I • DSNU589I
v DSVOLSER
DSNU585I csect-name REPORT RECOVERY
v HIGHDSNUM
obj-type obj-qual.obj-name CURRENT
v LOWDSNUM
Explanation: The message is issued in response to
For description of the fields, see SYSIBM.SYSCOPY the CURRENT option of REPORT RECOVERY utility. It
table in Appendix C of DB2 SQL Reference. indicates that only the information since the last
recoverable point for the specified table space or index
Severity: 0 (informational) space is reported.
Severity: 0 (informational)
DSNU583I csect-name SYSLGRNX ROWS FROM
REPORT RECOVERY FOR obj-type System Action: Normal utility processing continues.
obj-qual.obj-name
Explanation: This is the header message for the DSNU586I csect-name REPORT RECOVERY
SYSLGRNX section of the REPORT RECOVERY obj-type obj-qual.obj-name SUMMARY:
output. This section displays the SYSLGRNX rows for
Explanation: This is the header message for the
the table space, index space, or partition as specified in
SUMMARY section of the REPORT RECOVERY utility.
the REPORT RECOVERY input statement. The fields in
All the volumes to be used by the RECOVER utility are
the SYSLGRNX row are:
summarized.
v UCDATE - Modification date
v UCTIME - Modification time The volume name is marked with ’*’ at the end if any
v START RBA - Starting RBA archive log record in the volume was created after the
v STOP RBA - Stopping RBA last FULL IMAGE COPY, LOAD REPLACE LOG YES,
v START LRSN - Starting LRSN or REORG LOG YES.
v STOP LRSN - Stopping LRSN
System Action: Processing continues normally
v DSNUM - Partition number
v MEMBER - Data sharing member
DSNU587I csect-name REPORT TABLESPACE SET
An invalid SYSLGRNX record is marked with ’**’ at the WITH TABLESPACE dbname.tsname
end. The invalid SYSLGRNX record cannot be used for
Explanation: Header message for the REPORT
recovery because the range is outside recovery. If
TABLESPACESET output. The output contains all table
records are marked with ’**’, then a DSNU594 message
spaces, tables, and dependent tables associated with
should have been issued prior to this.
the table space specified in the REPORT
TABLESPACESET input statement.
A SYSLGRNX record created after the last FULL
IMAGE COPY, LOAD REPLACE LOG YES, or REORG Severity: 0 (informational)
LOG YES is marked with ’*’ at the end.
System Action: Utility processing continues normally.
Severity: 0 (informational)
System Action: Processing continues normally. DSNU588I csect-name NO DATA TO BE
REPORTED
DSNU584I csect-name REPORT RECOVERY Explanation: The message is issued when no data
obj-type obj-qual.obj-name BSDS can be found for a section of the REPORT output.
VOLUMES
Severity: 0 (informational)
Explanation: Message for the BSDS VOLUMES
System Action: Utility processing continues.
section of the REPORT RECOVERY output. This
section contains BSDS volumes for the archive log (1 or
2) records associated with the table space or index DSNU589I csect-name REPORT RECOVERY
space specified in the REPORT RECOVERY input obj-type obj-qual.obj-name COMPLETE
statement. The output contains the following
information: Explanation: The message is issued at the normal
completion of reporting the RECOVERY information for
START TIME END TIME START RBA END RBA UNIT VOLSER DATA the SET table
NAME space or index space by the REPORT
start end rba rba device volume data set name
RECOVERY utility.
timestamp timestamp
Severity: 0 (informational)
An archive log record created after the last FULL
System Action: This message indicates the normal
IMAGE COPY, LOAD REPLACE LOG YES, or REORG
completion of the REPORT RECOVERY utility.
LOG YES is marked with ’*’ at the end.
Processing continues to the next utility statement in the
System Action: Processing continues normally utility job step, if any. If not, the utility job step is
522 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU590I • DSNU596I
normally terminated, and the resources held become
DSNU593I csect-name REPORT RECOVERY
available for further processing. The UTILID of the utility
ENVIRONMENT INFORMATION:
job step becomes available for reuse. The output from
MINIMUM RBA: rba1 MAXIMUM RBA:
REPORT RECOVERY is now available for RECOVER
rba2 MIGRATING RBA: rba3
utility use.
Explanation: The REPORT utility issues this message
to display recovery environment information used by the
DSNU590I csect-name object RESOURCE NOT
RECOVER utility. The maximum and minimum RBAs
AVAILABLE - object-name REASON =
give the range of possible recovery points on the log
X’reason-code’
before the start of data sharing. The migrating RBA is
Explanation: A required object could not be accessed the RBA at the time of migration from DB2 Version 3 to
because of the reason shown in 'reason-code'. The Version 4. If there is data to report, other messages
'object-name' can be a database, table space, or index from the REPORT utility follow to display SYSCOPY,
space. If the object is in a stopped state and has SYSLGRNX and BSDS records.
partitions, then the stopped state applies to one or more
Severity: 0 (Informational)
of the partitions.
System Action: Utility processing continues.
Severity: 8 (error) or 4 (warning)
System Action: If the return code is 8, utility
DSNU594I csect-name DB2 ENCOUNTERED
processing is terminated. If the return code is 4, utility
SYSLGRNX RECORDS THAT CANNOT
processing continues to the next request.
BE USED FOR RECOVERY.
User Response: Determine the cause for
Explanation: The utility found one or more
unavailability. The -DISPLAY DATABASE command can
SYSLGRNX records that cannot be used for recovery
be used to determine the status. After ensuring the
because the range is outside recovery. Invalid
object is available, resubmit the job.
SYSLGRNX records are marked with ’**’ at the end of
the record under message DSNU583I.
DSNU591I csectname AN UNSUCCESSFUL
Severity: 4 (REPORT - warning) or 8 (RECOVER -
COMPLETION OF A LOG READ,
error)
REASON=X’reason-code’
System Action: REPORT utility processing continues.
Explanation: The log manager subcomponent of DB2
RECOVER utility terminates.
detected an error during a LOG READ of SYSCOPY
record for DSNDB06.SYSCOPY, DSNDB01.DBD01 or System Programmer Response: Run the RECOVER
DSNDB01.SYSUTIL. utility with the TOCOPY option.
Severity: 4 (warning)
DSNU595I csect-name ERROR IN GETTING THE
System Action: Processing continues.
HIGHEST MEMBER ID IN DATA
Problem Determination: Look up the reason code in SHARING.
“Part 4. DB2 Codes” on page 707 of this book for
Explanation: The REPORT utility could not find a
problem determination.
valid highest member ID. The highest member is the
last member to join a data sharing group. This message
DSNU592I csect-name REPORT RECOVERY is issued only in a data sharing environment.
INFORMATION FOR DATA SHARING
Severity: 8 (error)
MEMBER member-name
System Action: The REPORT utility abends.
Explanation: The REPORT RECOVERY utility
displays this message as the heading for SYSLGRNX System Programmer Response: This might be an
and BSDS records or BSDS summary information for internal DB2 problem. Refer to Part 2 of DB2 Diagnosis
each data sharing member. Records for this member Guide and Reference for information on identifying and
follow, if there is data to report. reporting the problem.
Severity: 0 (Informational)
DSNU596I csect-name ERROR IN GETTING THE
System Action: Utility processing continues.
MEMBER NAME FOR MEMBER ID
Explanation: The REPORT utility could not find a
valid member name for the member ID, or the member
ID supplied is invalid. This message is issued only in a
data sharing environment.
Severity: 8 (error)
Chapter 18. DB2 Messages 523
DSNU597I • DSNU603I
System Action: The REPORT utility abends. point to the same database and resubmit the
RUNSTATS job.
System Programmer Response: This might be a
DB2 internal problem. Refer to Part 2 of DB2 Diagnosis Problem Determination: Refer to catalog table
Guide and Reference for information on identifying and SYSIBM.SYSINDEXES to determine the table upon
reporting the problem. which the index is based. This table must be in the
database and table space targeted by the RUNSTATS
utility.
DSNU597I csect-name INVALID SYSLGRNX
INFORMATION FROM REPORT
RECOVERY DSNU601I csect-name INDEX creator.index-name
POINTS TO A DIFFERENT
Explanation: This is the header message for the
TABLESPACE.
invalid SYSLGRNX records section of the REPORT
RECOVERY output. This section lists SYSLGRNX Explanation: A specified index does not point to a
records containing information that is invalid for table in the table space selected. The table space is
recovery purposes. either the one specified in the TABLESPACE parameter
or the one which contains the table pointed to by the
Severity: 0 (Informational)
first specified index.
System Action: Utility processing continues.
Severity: 8 (error)
User Response: Examine the invalid SYSLGRNX
System Action: All remaining RUNSTATS invocation
records with a zero member ID which were generated
parameters are validated and the executing utility job
before enabling data sharing. The MODIFY utility can
terminates. Work performed by previous utilities in the
be used to delete the invalid SYSLGRNX records.
job step remains in effect. Subsequent utility control
statements are flushed. No record of the utility job step
DSNU599I csect-name obj-type obj-qual.obj-name is retained in the system; therefore, it cannot be
HAS BEEN RECOVERED TO A restarted.
CONSISTENT POINT IN TIME WITH
User Response: Ensure that all indexes in the list
obj-type obj-qual.obj-name
point to tables in the targeted table space and resubmit
Explanation: This message is issued when an index the RUNSTATS job.
and its underlying table space have been recovered to
Problem Determination: Refer to catalog table
a consistent point in time. A consistent point in time is a
SYSIBM.SYSINDEXES to determine the table upon
common QUIESCE point or a common SHRLEVEL
which the index is based. Using the table-name found in
REFERENCE copy set (objects were copied in the
SYSIBM.SYSINDEXES, refer to catalog table
same list with SHRLEVEL REFERENCE specified). The
SYSIBM.SYSTABLES to determine the containing table
index is available for read and write access when the
space.
recover completes.
Severity: 0 (informational)
DSNU602I csect-name STATISTICS ARE NOT
System Action: Recover processing continues. COLLECTED FOR NONPARTITIONED
INDEX creator.index-name
DSNU600I csect-name INDEX creator.index-name Explanation: For a LOAD or REORG utility when a
POINTS TO A DIFFERENT DATABASE. nonpartitioned index exists, inline statistics performs a
complete index scan. Statistics are collected for the
Explanation: A specified index does not point to a entire nonpartitioned index. This warning message will
table in the database selected. For a RUNSTATS be issued if the PART keyword & STATISTICS keyword
Format 1 invocation, the database is the one specified are specified for LOAD/REORG utilities. This is because
(or defaulted) in the TABLESPACE parameter. For a statistics are not collected on a logical part basis.
RUNSTATS Format 2 invocation, the database is the
one which contains the first index in the index-name list. System Action: This message will be issued for each
nonpartitioned index, when INDEX ALL is specified.
Severity: 8 (error)
Severity: 4 (warning)
System Action: All remaining RUNSTATS invocation
parameters are validated and the executing utility job User Response: Run the runstats utility on the object.
terminates. Work performed by previous utilities in the
job step remains in effect. Subsequent utility control
DSNU603I csect-name - OBJECT=object-name HAS
statements are flushed. No record of the utility job step
AN INCOMPLETE DEFINITION
is retained in the system; therefore, it cannot be
restarted. Explanation: The identified object (TABLE or TABLE
SPACE) does not have a complete definition. This can
User Response: Ensure that all indexes in the list
524 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU604I • DSNU608I
be caused by one of these errors:
DSNU606I csect-name USER NOT AUTHORIZED
v Not defining any tables in the table space (RC=4). TO ACCESS TABLESPACE
v Not creating the accompanying partitioned index if database-name.tablespace-name
the table space is partitioned (RC=8).
Explanation: This user is not authorized to execute
Severity: 8 (error) or 4 (warning) the RUNSTATS utility against TABLESPACE
'creator.tbspname'.
System Action: If the return code is 8, utility
processing terminates. If the return code is 4, utility Severity: 8 (error)
processing continues to the next request.
System Action: The executing utility job step
User Response: Complete the table space definition terminates. Work performed by previous utilities in the
by creating at least one table in the table space, or job step remains in effect. Subsequent utility control
create the accompanying partitioned index if the table statements are flushed. No record of the utility job step
space is partitioned. is retained in the system; therefore, it cannot be
restarted.
Problem Determination: Issue an SQL SELECT
statement on the catalog to determine if the tables or a User Response: Contact your system administrator to
partitioned index was not created for the table space. obtain the proper authority, or have another user with
the required authority execute the utility for you.
DSNU604I csect-name object IS EMPTY
DSNU607I csect-name ERROR OCCURRED
Explanation: The object currently to be scanned by ACCESSING INDEXSPACE
the RUNSTATS utility contains no records. The 'object' creator.index-name
can be TABLESPACE or INDEXSPACE.
Explanation: A previous error makes it impossible for
Severity: 0 (informational) RUNSTATS to scan INDEXSPACE
System Action: The object currently to be scanned is 'creator.indexspacename'.
recorded in the catalog as empty. The statistics for the Severity: 8 (error)
object are updated and RUNSTATS continues to the
next object, if there is one. System Action: The executing utility job step
terminates. Work performed by previous utilities in the
job step remains in effect. Subsequent utility control
DSNU605I csect-name ERROR OCCURRED statements are flushed. No record of the utility job step
ACCESSING TABLESPACE is retained in the system; therefore, it cannot be
database-name.tablespace-name restarted.
Explanation: A previous error makes it impossible for User Response: Examine prior error messages for
RUNSTATS to scan TABLESPACE 'creator.tbspname'. error identification. If the error can be corrected,
Severity: 8 (error) resubmit the RUNSTATS utility in a new utility job step.
System Action: The executing utility job step Problem Determination: Prior messages identify this
terminates. Work performed by previous utilities in the error. See the documentation for these messages in this
job step remains in effect. Subsequent utility control manual for additional problem determination. If you
statements are flushed. No record of the utility job step suspect an error in DB2, refer to Part 2 of DB2
is retained in the system; therefore, it cannot be Diagnosis Guide and Reference for information on
restarted. identifying and reporting the problem.
User Response: Examine prior error messages for
error identification. If the error can be corrected, DSNU608I csect-name USER NOT AUTHORIZED
resubmit the RUNSTATS utility in a new utility job step. TO ACCESS INDEXSPACE
If you suspect an error in DB2, refer to Part 2 of DB2 creator.index-name
Diagnosis Guide and Reference for information on Explanation: This user is not authorized to execute
identifying and reporting the problem. the RUNSTATS utility against INDEXSPACE
Problem Determination: Prior messages identify this 'creator.indexspacename'.
error. See the documentation for these messages in this Severity: 8 (error)
manual for additional problem determination.
System Action: The executing utility job step
terminates. Work performed by previous utilities in the
job step remains in effect. Subsequent utility control
statements are flushed. No record of the utility job step
is retained in the system; therefore, it cannot be
restarted.
Chapter 18. DB2 Messages 525
DSNU609I • DSNU613I
User Response: Contact your system administrator to
DSNU612I csect-name SYSTABLESPACE
obtain the proper authority, or have another user with
CATALOG STATISTICS FOR
the required authority execute the utility for you.
| tspace-name NACTIVE = nactive
| NACTIVEF = nactive
DSNU609I csect-name TABLE table-name IS IN A
Explanation: The RUNSTATS utility issues this
DIFFERENT TABLESPACE
message to report the statistics collected for table space
Explanation: A table listed in the table name list of the tspace-name.
RUNSTATS TABLE keyword was not found in the
nactive
specified table space.
The number of active pages in the table space
Severity: 8 (error)
This message is routed to SYSPRINT.
System Action: The executing utility job step
terminates. Work performed by previous utilities in the Severity: 0 (informational)
job step remains in effect. Subsequent utility control
System Action: RUNSTATS processing continues.
statements are flushed. No record of the utility job step
is retained by the system; therefore it cannot be User Response: Refer to DB2 Utility Guide and
restarted. Reference for information about RUNSTATS statistics.
User Response: Ensure that all tables in the list are in
the specified table space and resubmit the utility. DSNU613I csect-name SYSTABLEPART CATALOG
STATISTICS FOR table-space-name
Problem Determination: Refer to the catalog table
PARTITION part-num
SYSIBM.SYSTABLES to determine the table space in
which the table is located. :
CARD = cardinality
DSNU610I csect-name catalog-table-name | CARDF = cardinality
CATALOG UPDATE FOR object-name NEARINDREF = nearindref
SUCCESSFUL FARINDREF = farindref
Explanation: This message indicates that the updating PERCACTIVE = peractive
of the statistics columns in the CATALOG TABLE PERCDROP = percdrop
'catalog-table-name' was successful. PAGESAVE = pagesave
| SPACE = space
Severity: 0 (informational) | SPACEF = space
System Action: Processing continues with the next | PQTY = pqty
catalog table. | SQTY = sqty
| DSNUM = dsnum
| EXTENTS = extents
DSNU611I csect-name COLUMN column-name NOT
FOUND FOR TABLE creator.table-name
Explanation: The RUNSTATS utility issues this
Explanation: A column name, given as an operand of message to report the statistics collected. If the
the COLUMN keyword, was not found in the specified part-num equals 0, the statistics apply to the entire table
table. space. If the part-num is not 0, the statistics apply to the
Severity: 8 (error) specified partition of the table space.
System Action: Validation of the utility invocation cardinality
statement is completed and the executing utility job step The number of rows in the reported partition
is terminated. number
User Response: Ensure that the column name given nearindref
in the message is correct for the table specified. The number of rows that were relocated near
their original page
Problem Determination: Check that the column name
specified in the utility invocation statement is identical to farindref
that found in the SYSIBM.SYSCOLUMNS catalog table. The number of rows that were relocated far
Correct any errors and reissue the utility job. from their original page
peractive
The percentage of space occupied by actual
data from active tables
526 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU614I • DSNU615I
percdrop | avgrowlen
The percentage of space occupied by rows of | The total number of bytes divided by the
data from dropped tables | number of rows.
pagesave | space The space currently allocated for all extents,
The percentage of pages saved in the table | measured in kilobytes.
space or partition by using data compression
RUNSTATS uses floating point fields to report these
| space The space currently allocated for all extents,
statistics.
| measured in kilobytes.
| pqty The primary space allocation for the dataset in This message is routed to SYSPRINT.
| 4K blocks.
Severity: 0 (informational)
| sqty The secondary space allocation for the dataset
| in 4K blocks. System Action: RUNSTATS processing continues.
| dsnum The number of data sets. User Response: Refer to DB2 Utility Guide and
Reference for a discussion of RUNSTATS statistics.
| extents
| The number of extents for the last data set of
| the object. DSNU615I csect-name SYSCOLUMNS CATALOG
STATISTICS FOR column-name
This message is routed to SYSPRINT. :
Severity: 0 (informational)
COLCARD = cardinality
System Action: RUNSTATS processing continues. COLCARDF = cardinalityHIGH2KEY = high2key
LOW2KEY = low2key
User Response: Refer to DB2 Utility Guide and
Reference for information about RUNSTATS statistics. Explanation: The RUNSTATS utility issues this
message to report the statistics collected for column
'column-name'. Message DSNU619I is issued to identify
DSNU614I csect-name SYSTABLES CATALOG
the table.
STATISTICS FOR table-name
cardinality
:
The number of distinct values in the column
CARD = cardinality high2key
CARDF = cardinality The second highest value of the column
NPAGES = npages
| NPAGESF = npages low2key
PCTPAGES = pctpages The second lowest value of the column
PCTROWCOMP = pctrowcomp
| AVGROWLEN = avgrowlen If the values for 'high2key' and 'low2key' are null, the
| SPACEF = space invoker of RUNSTATS is not authorized to read the
table.
Explanation: The RUNSTATS utility issues this
For a LARGE table space, the value of COLCARD is
message to report the statistics collected for the
set to -1.
specified table. The statistics follow:
cardinality RUNSTATS uses floating point fields to report these
The number of rows in the table. statistics.
For a LARGE table space, the value of CARD
This message is routed to SYSPRINT.
is set to -1.
Severity: 0 (informational)
npages
The number of pages on which rows of the System Action: Processing continues.
table appear.
User Response: Refer to DB2 Utility Guide and
pctpages Reference for a description of RUNSTATS statistics.
The percentage of total pages of the table
space that contain rows from this table.
pctrowcomp
The percentage of rows compressed within the
total number of active rows in the table.
Chapter 18. DB2 Messages 527
DSNU616I • DSNU617I
DSNU616I csect-name SYSCOLDIST CATALOG DSNU617I csect-name SYSINDEXES CATALOG
STATISTICS FOR column-name, STATISTICS FOR index-name
column-name, column-name ...
:
: CARDINALITY = cardinality
CLUSTERED = clustered
FREQUENCY COLVALUE CLUSTERRATIO = clusterratio
CLUSTERRATIOF = clusterratio
frequency X “hex_string”
FIRSTKEYCARD = firstkeycard
frequency X “hex_string” FIRSTKEYCARDF = firstkeycard
... ... NLEAF = nleaf
NLEVELS = nlevels
frequency X “hex_string” | SPACEF = space
Explanation: The RUNSTATS utility issues this Explanation: The RUNSTATS utility issues this
message to report the statistics collected for the message to report the statistics collected for index
indexed column 'column-name'. If more than one 'index-name'.
column is listed, then the statistics collected and the
column values reported represent the concatenation of clustered
those columns. Whether the table is actually clustered by this
index (YES or NO)
The value for CARDINALITY is the number of distinct
values for the listed columns. This statistic appears only cluster-ratio
if the KEYCARD option was specified. The percentage of data rows that are in
clustering order for this index
The values under FREQUENCY are the same as those
that are inserted into the DB2 catalog. Consider each float-cluster-ratio
'frequency' as a four-digit number with an implied A number between 0 and 1 that when
decimal point two places to the left of the final digit. The multiplied by 100 gives the percentage of data
resulting number is the percentage of total rows in the rows in the partition that are in clustering order
table that contain a particular value for the named index for this index
columns. first-key
Frequency is associated with the occurrence of a single The number of distinct values of the first key
value which is listed under COLVALUE. column
Frequencies for the most frequent values are collected full-key
by default, or if the FREQVAL option is specified and The number of distinct values of the key
given a COUNT value greater than zero. If the default is nleaf The number of active leaf pages in the index
taken, then the ten most frequently occurring values are
reported in descending order of frequency. nlevels
The number of levels in the index tree
If fewer than ten values appear, then there are fewer
than ten distinct values in the index. | space The space currently allocated for all extents,
If no values appear, then the values are uniformly | measured in kilobytes.
distributed.
If frequencies appear but column values do not, then For a LARGE table space, the values of
the invoker of RUNSTATS is not authorized to read FIRSTKEYCARD and FULLKEYCARD are set to -1.
the table. Message DSNU619I is issued to identify RUNSTATS uses floating point fields to report these
the table. statistics.
This message is routed to SYSPRINT. This message is routed to SYSPRINT.
Severity: 0 (informational) Severity: 0 (informational)
System Action: Processing continues. System Action: Processing continues.
User Response: Refer to DB2 Utility Guide and User Response: Refer to DB2 Utility Guide and
Reference for a description of RUNSTATS statistics. Reference for a description of RUNSTATS statistics.
528 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU618I • DSNU621I
For a LARGE table space, the values of CARD,
DSNU618I csect-name SYSINDEXPART CATALOG
NEAROFFPOS, and FAROFFPOS are set to -1.
STATISTICS FOR index-name
RUNSTATS uses floating point fields to report these
PARTITION part-num
statistics.
:
This message is routed to SYSPRINT.
|| CARD = cardinality
| CARDF = cardinality Severity: 0 (informational)
| NEAROFFPOS = near-off System Action: Processing continues.
| NEAROFFPOSF = near-off
| FAROFFPOS = far-off User Response: Refer to DB2 Utility Guide and
| FAROFFPOSF = far-off Reference for a description of RUNSTATS statistics.
| LEAFDIST = leafdist
| SPACEF = space
DSNU619I csect-name - USER auth_id DOES NOT
| DSNUM = dsnum
HAVE PRIVILEGE ON TABLE
| EXTENTS = extents
table_name
| LEAFNEAR = leafnear
| LEAFFAR = leaffar Explanation: The RUNSTATS utility issues this
| PSEUDO_DEL_ENTRIES = pseudo_del_entries message to report that authorization ID 'auth_id' does
| not have privilege on table 'table_name'. Some column
values reported by messages DSNU615I, DSNU616I,
Explanation: The RUNSTATS utility issues this
DSNU625I, and DSNU626I contain the null value.
message to report the statistics collected for index
'index-name'. If 'part-num' equals 0, the statistics apply Severity: 0 (informational)
to the entire index. If 'part-num' is not 0, the statistics
System Action: RUNSTATS processing continues.
apply to the specified partition of the index.
User Response: To obtain the key values, the user
cardinality
must be granted authority on the table. The RUNSTATS
The number of rows in the partition or index.
utility can be rerun with the report option.
near-off
The number of rows pointed to that are near
DSNU620I csect-name RUNSTATS CATALOG
but not at their optimal positions.
STATISTICS STATSTIME = timestamp
far-off The number of rows pointed to that are far
Explanation: The RUNSTATS utility issues this
from their optimal positions.
message to report the timestamp value when statistics
leafdist were collected. The value 'timestamp' is common to all
100 times the average distance in page IDs of the statistic tables that were updated.
between successive leaf pages during a
Severity: 0 (informational)
sequential access of the index.
System Action: Processing continues.
| space The space currently allocated for all extents,
| measured in kilobytes. User Response: Refer to DB2 Utility Guide and
Reference for a description of the RUNSTATS statistics.
| dsnum The number of data sets.
| extents
DSNU621I csect-name RUNSTATS
| The number of extents for the last data set of
COMMIT/ROLLBACK FAILED
| the object.
Explanation: The RUNSTATS utility updated the
| leafnear
catalog with gathered statistics and has tried either to
| The number of leaf pages physically near the
commit those changes or to perform rollback processing
| previous leaf page for successive active leaf
to remove them following an error. The commit or
| pages.
rollback failed.
| leaffar The number of leaf pages located physically far
Severity: 8 (error)
| away from the previous leaf pages for
| successive active leaf pages accessed in an System Action: RUNSTATS processing is terminated.
| index scan. Subsequent utility control statements in the utility job
step are executed.
| pseudo_del_entries
| The number of entries that are logically System Programmer Response: If you suspect an
| deleted. error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and
reporting the problem.
Chapter 18. DB2 Messages 529
DSNU622I • DSNU625I
Problem Determination: This is an internal error. pctpages
The percentage of total pages of the table
space partition that contain rows from this table
| DSNU622I csect-name CATALOG ACCESS FOR
| object-name NOT SUCCESSFUL, nactive
| REASON=reason-code The number of active pages in the table space
partition
| Explanation: Due to catalog access error for object
| object-name and reason code reason-code, the catalog pctrowcomp
| update, insert, or select was not successful for the The percentage of rows compressed within the
| object when inline statistics was employed. total number of active rows in the partition
Severity: 4 (warning)
This message is routed to SYSPRINT.
User Response: Run the RUNSTATS utility against
Severity: 0 (informational)
the object.
System Action: RUNSTATS processing continues.
DSNU623I csect-name - catalog-table-name User Response: Refer to DB2 Utility Guide and
CATALOG NOT UPDATED WITH Reference for information about RUNSTATS statistics.
AGGREGATE STATISTICS FOR
object-name BECAUSE SOME
PARTITIONS HAVE NO VALID DSNU625I csect-name SYSCOLSTATS CATALOG
STATISTICS STATISTICS FOR column-name
PARTITION part-num
Explanation: Aggregate statistics were requested, but
partition statistics do not exist for every partition. :
Without partition statistics, the aggregate statistics
cannot be calculated. The statistics for 'object-name' are COLCARD = cardinality
not updated in the specified DB2 catalog table. HIGHKEY = highkey
HIGH2KEY = high2key
One possible cause for this message is that someone LOW2KEY = low2key
altered the length of a varying-length column and then LOWKEY = lowkey
tried to run RUNSTATS with the PART option.
Explanation: The RUNSTATS utility issues this
Severity: 4 (warning) message to report the statistics collected for column
System Action: Processing continues. 'column-name' partition 'part-num' of a table. Message
DSNU619I is issued to identify the table.
User Response: Run the RUNSTATS utility to collect
statistics for: cardinality
v The entire table space, table, column or index, or The number of distinct values in the column for
v Every partition. the partition
highkey
DSNU624I csect-name SYSTABSTATS CATALOG The highest value of the column in the partition
STATISTICS FOR table-name high2key
PARTITION part-num The second highest value of the column in the
: partition
low2key
| CARD or CARDF = cardinality The second lowest value of the column in the
NPAGES = npages partition
PCTPAGES = pctpages
NACTIVE = nactive lowkey The lowest value of the column in the partition
PCTROWCOMP = pctrowcomp
If the values for 'highkey', 'high2key', 'low2key', and
Explanation: The RUNSTATS utility issues this 'lowkey' are null, the invoker of RUNSTATS is not
message to report the statistics collected for the authorized to read the table.
specified partition of the table space containing the
table. The statistics follow: This message is routed to SYSPRINT.
cardinality Severity: 0 (informational)
The number of rows in the table space partition
System Action: Processing continues.
npages
The number of pages on which rows of the User Response: Refer to DB2 Utility Guide and
table space partition appear Reference for a description of RUNSTATS statistics.
530 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU626I • DSNU628I
DSNU626I csect-name SYSCOLDISTSTATS DSNU627I csect-name SYSINDEXSTATS CATALOG
CATALOG STATISTICS FOR STATISTICS FOR index-name
column-name, column-name, PARTITION part-num
column-name ... PARTITION part-num
:
: CARDINALITY = cardinality
CLUSTERRATIO or CLUSTERRATIOF = cluster-ratio
FREQUENCY COLVALUE FIRSTKEYCARD or FIRSTKEYCARDF = first-key
frequency X “hex_string” FULLKEYCARD or FULLKEYCARDF = full-key
NLEAF = nleaf
frequency X “hex_string” NLEVELS = nlevels
... ... KEYCOUNT or KEYCOUNTF = keycount
frequency X “hex_string” Explanation: The RUNSTATS utility issues this
message to report the statistics collected for partition
part-num of index index-name.
Explanation: The RUNSTATS utility issues this
message to report the statistics collected for the cluster-ratio
indexed column 'column-name' partition 'part-num'. If The percentage of data rows in the partition
more than one column is listed, then the statistics that are in clustering order for this index
collected and the column values reported represent the
first-key
concatenation of those columns.
The number of distinct values of the first key
The value for CARDINALITY is the number of distinct column in the partition
values for the listed columns. This statistic appears only
full-key
if the KEYCARD option was specified.
The number of distinct values of the key in the
The values under FREQUENCY are the same as those partition
that are inserted into the DB2 catalog. Consider each
nleaf The number of active leaf pages in the index
'frequency' as a four-digit number with an implied
partition
decimal point two places to the left of the final digit. The
resulting number is the percentage of total rows in the nlevels
table that contain a particular value for the named index The number of levels in the index tree in the
columns. partition
Frequency is associated with the occurrence of a single keycount
value which is listed under COLVALUE. The number of index keys (entries) in the
partition
Frequencies for the most frequent values are collected
by default, or if the FREQVAL option is specified and
given a COUNT value greater than zero. If the default is This message is routed to SYSPRINT.
taken, then the ten most frequently occurring values, Severity: 0 (informational)
plus the lowest and highest values in the partition (if not
already included in the ten greatest frequencies), are System Action: Processing continues.
reported in descending order of frequency. User Response: Refer to DB2 Utility Guide and
If fewer than ten values appear, then there are fewer Reference for a description of RUNSTATS statistics.
than ten distinct values in the index.
If no values appear, then the values are uniformly DSNU628I csect-name STATISTICS WILL NO
distributed. LONGER BE COLLECTED ON
If frequencies appear but column values do not, then RESTART
the invoker of RUNSTATS is not authorized to read
Explanation: Since inline statistics is not restartable,
the table. Message DSNU619I is issued to identify
Statistics will not be collected on restarting the
the table.
LOAD/REORG utility. The error message will be issued
on restart of a LOAD/REORG utility with STATISTICS
This message is routed to SYSPRINT.
keyword specified.
Severity: 0 (informational)
Severity: 4 (warning)
System Action: Processing continues.
User Response: Run the runstats utility on the object
User Response: Refer to DB2 Utility Guide and after the utility execution.
Reference for a description of RUNSTATS statistics.
Chapter 18. DB2 Messages 531
DSNU629I • DSNU641I
DSNU629I csect-name INLINE STATISTICS IS NOT DSNU639I csect - UTILITY NOT ALLOWED TO
SUPPORTED FOR object-name RUN ON INDEX SPACE = iiiiiiii IN
ROSHARE READ DATABASE =
Explanation: The collection of inline statistics is not
dddddddd
supported on the following directory and catalog
tablespaces : DSNDB06.SYSDBASE, Explanation: An attempt to execute the STOSPACE
DSNDB06.SYSDBAUT, DSNDB06.SYSGROUP, utility on an index space defined in a ROSHARE READ
DSNDB06.SYSPLAN, DSNDB06.SYSVIEWS, database failed. The STOSPACE utility is only allowed
DSNDB06.SYSSTATS, and DSNDB01.DBD01 to execute in a ROSHARE OWNER or nonshared
database.
This error message will be issued on execution of a
REORG or REBUILD INDEX utility on a catalog object Severity: 4 (warning)
when the STATISTICS keyword is specified.
System Action: Processing continues to the next
Severity: 4 (warning) table space or index space in the storage group, if any.
User Response: Remove the keyword STATISTICS User Response: Resubmit the utility job on the
from the utility job statement and rerun the utility. Run system in which the database was defined with the
the RUNSTATS utility afterwards. ROSHARE OWNER attribute.
DSNU630I csect-name - SYSLOBSTATS CATALOG DSNU640I csect-name DATA SET= nnn OF
STATISTICS FOR LOB table space TABLESPACE= tttttttt IN DATABASE=
AVGSIZE = avgsize FREESPACE = dddddddd HAS BEEN MIGRATED BY
freespace ORGRATIO = orgratio HSM
Explanation: The RUNSTATS utility issues this Explanation: The STOSPACE utility has found that a
message to report statistics collected for the LOB table DB2 data set has been migrated by the Data Facility
space. Hierarchical Storage Manager. The amount of storage
space used cannot be determined for DATA SET 'nnn'
AVGSIZE
of TABLESPACE 'tttttttt' in DATABASE 'dddddddd'. The
Average size of a LOB in the LOB table space.
space allocation information in the catalog will not
FREESPACE include the storage used by the migrated data set.
Amount of free space in the LOB table space.
Severity: 0 (informational)
ORGRATIO
System Action: Processing continues to the next data
The ratio of organization in the LOB table
set in the storage group, if any.
space. A value of 1 indicates perfect
organization of the LOB table space. The System Programmer Response: If required, the data
greater the value exceeds 1, the more set may be recalled using HSM, and the STOSPACE
disorganized the LOB table space. utility may be run again.
System Action: RUNSTATS processing continues.
DSNU641I csect-name DATA SET= nnn OF
INDEXSPACE= iiiiiiii IN DATABASE=
DSNU638I csect - UTILITY NOT ALLOWED TO
dddddddd HAS BEEN MIGRATED BY
RUN ON TABLESPACE = tttttttt IN
HSM
ROSHARE READ DATABASE =
dddddddd Explanation: The STOSPACE utility has found that a
DB2 data set has been migrated by the Data Facility
Explanation: An attempt to execute STOSPACE utility
Hierarchical Storage Manager. The amount of storage
on a table space defined in a ROSHARE READ
space used cannot be determined for DATA SET 'nnn'
database failed. The STOSPACE utility is only allowed
of INDEXSPACE 'iiiiiiii' in DATABASE 'dddddddd'. The
to execute in a ROSHARE OWNER or a nonshared
space allocation information in the catalog will not
database.
include the storage used by the migrated data set.
Severity: 4 (warning)
Severity: 0 (informational)
System Action: Processing continues to the next
System Action: Processing continues to the next data
table space or index space in the storage group, if any.
set in the storage group, if any.
User Response: Resubmit the utility job on the
System Programmer Response: If required, the data
system in which the database was defined with the
set may be recalled using HSM, and the STOSPACE
ROSHARE OWNER attribute.
utility may be run again.
532 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU642I • DSNU646I
DSNU642I csect-name UNABLE TO ACCESS DBD DSNU644I csect-name USER user-name NOT
FOR DATABASE = dddddddd, AUTHORIZED FOR STOSPACE UTILITY
TABLESPACE = tttttttt
Explanation: Utility processing for the user indicated
Explanation: A database descriptor control block on the job statement failed, because the user is not
could not be accessed by the STOSPACE utility. authorized to execute the STOSPACE utility.
Information in the DBD is required before space
Severity: 8 (error)
allocation data can be obtained from the appropriate
ICF catalog. Storage space used by table space 'tttttttt' System Action: Utility processing is terminated
in database 'dddddddd' cannot be determined. without invoking the requested utility or utilities.
Severity: 4 (warning) User Response: Contact the systems programmer for
assistance with your security classification.
System Action: Processing continues with the next
storage group. System Programmer Response: If the USER
specified on the job statement is incorrect, correct it,
User Response: Determine the cause for
and resubmit the job. To run the STOSPACE utility, the
unavailability. The database may be stopped or the
user must either have SYSADM authority or have been
DBD may be marked as invalid. The -DISPLAY
granted the STOSPACE privilege. Use the SQL GRANT
DATABASE command can be used to determine the
command to give the user the desired authority.
status.
System Programmer Response: Determine if the
DSNU645I csect-name NO STORAGE GROUPS
reason for the DBD unavailability may require system
NAME FOUND
corrective action.
Explanation: You requested the STOSPACE utility to
Problem Determination: A DSNT501I message may
report on all storage groups, but no storage group was
have been sent to the operator console. If so, see the
found.
problem determination section for message DSNT501I
in the “Chapter 17. DSNT... Messages” on page 375. Severity: 4 (warning)
This condition does not prevent subsequent processing.
DSNU643I csect-name UNABLE TO ACCESS DBD
FOR DATABASE = dddddddd, System Action: This message indicates completion of
INDEXSPACE = tttttttt the STOSPACE utility. Processing continues to the next
utility statement in the utility job step, if any. If not, the
Explanation: A database descriptor control block utility job step is normally terminated. Resources are
could not be accessed by the STOSPACE utility. released to their prior availability state. The UTILID of
Information in the DBD is required before space the utility job step becomes available for reuse.
allocation data can be obtained from the appropriate
ICF catalog. Storage space used by index space 'tttttttt' User Response: This message indicates that there
in database 'dddddddd' cannot be determined. are no storage groups defined. Consult the system
programmer to determine the reason for this condition.
Severity: 4 (warning)
System Programmer Response: This message
System Action: Processing continues with the next indicates either that no storage groups were defined by
storage group. the installation process (or by subsequent SQL
procedures) or they have all been dropped. If this is an
User Response: Determine the cause for
error, the required storage groups must be re-created
unavailability. The database may be stopped or the
with the CREATE STOGROUP SQL statement.
DBD may be marked as invalid. The -DISPLAY
DATABASE command can be used to determine the
status. DSNU646I csect-name STORAGE GROUP NAME
nnnnnnnn NOT FOUND
System Programmer Response: Determine if the
reason for the DBD unavailability may require system Explanation: This message is issued by STOSPACE
corrective action. when one of the requested storage groups is not found.
Problem Determination: A DSNT501I message may The following circumstances may exist:
have been sent to the operator console. If so, see the 1. When an inconsistency occurs between
problem determination section for message DSNT501I SYSIBM.SYSSTOGROUP at the beginning of
in the “Chapter 17. DSNT... Messages” on page 375 STOSPACE execution and
section. SYSIBM.SYSSTOGROUP during or at the end of
processing. The inconsistency may be due to a
storage group being dropped during the processing
of STOSPACE utility.
Chapter 18. DB2 Messages 533
DSNU647I • DSNU652I
2. The storage group name is misspelled. User Response: Use the 'reason-code' and
'type-code' to determine why the resource was
Severity: 4 (warning)
unavailable. When the problem has been resolved,
System Action: Processing proceeds normally to the resubmit the STOSPACE request.
next storage group if any.
System Programmer Response: Determine if the
User Response: Verify the existence or spelling of the 'reason-code' and 'type-code' require system corrective
storage group names by referring to action.
SYSIBM.SYSSTOGROUP. Submit another request with
Problem Determination: See the Problem
the correct storage group designated.
Determination section for message DSNT500I on page
425.
DSNU647I csect-name UNAVAILABLE REASON X
reason-code UNAVAILABLE TYPE X
DSNU650I csect-name control-statement-text
type-code, TABLESPACE NAME=
table-space-name NOT FOUND Explanation: Each control statement is returned to the
invoker as a part of the normal output. If an error
Explanation: The indicated table space was not
occurred while processing the statement, a separate
available for processing by the STOSPACE utility. The
error message follows this message.
reason for its unavailability is given in 'reason-code'.
The type of unavailability is given in 'type-code'. Severity: 0 (informational)
This message may be issued when an inconsistency System Action: The processing of the utility request
between SYSIBM.SYSSTABLESPACE and continues normally.
SYSIBM.SYSTABLEPART has been detected. The
inconsistency may be due to a table space being
DSNU651I csect-name SET NOCOPYPEND
dropped during the processing of the STOSPACE utility.
OPERATION SUCCESSFUL
Severity: 4 (warning)
Explanation: This message reports the successful
System Action: Processing continues to the next completion of the REPAIR SET TABLESPACE
table space in the storage group, if any. NOCOPYPEND utility operation. The COPY PENDING
restriction has been removed from the specified table
User Response: Use the 'reason-code' and
space.
'type-code' to determine why the resource was
unavailable. When the problem has been resolved, Severity: 0 (informational)
resubmit the STOSPACE request.
System Action: The REPAIR SET statement has
System Programmer Response: Determine if the completed normally.
'reason-code' and 'type-code' require system corrective
action.
DSNU652I csect-name VERIFY OPERATION
Problem Determination: See the Problem SUCCESSFUL
Determination section for message DSNT500I on page
Explanation: This message is issued during REPAIR
425.
utility processing in response to a VERIFY control
statement. It indicates the verification requested was
DSNU648I csect-name UNAVAILABLE REASON X successful, permitting a subsequent REPLACE request
reason code, UNAVAILABLE TYPE X to take effect.
type-code, INDEX NAME=index-name
Severity: 0 (informational)
NOT FOUND
System Action: The requested verification was
Explanation: The indicated index was not available for
successful. If this is the only verification required for the
processing by the STOSPACE utility. The reason for its
subsequent REPLACE control statement, the REPLACE
unavailability is given in 'reason-code'. The type of
control statement takes effect. If there are other
unavailability is given in 'type-code'.
verification control statements, they must also complete
This message may be issued when an inconsistency successfully before the subsequent REPLACE control
between SYSIBM.SYSINDEXES and statement takes effect.
SYSIBM.SYSINDEXPART has been detected. The
inconsistency may be due to an index being dropped
during the processing of the STOSPACE utility.
Severity: 4 (warning)
System Action: Processing continues to the next
index in the storage group, if any.
534 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU653I • DSNU658I
Severity: 0 (informational)
DSNU653I csect-name REPLACE OPERATION AT
OFFSET hex-data WITH DATA hex-data System Action: The data record specified on the
FAILED. ATTEMPTED TO REPLACE previous LOCATE statement and all of its related
CRITICAL NON-DATA INFORMATION INDEX entries have been deleted from the system.
ON THE PAGE page-num WITH Processing continues.
INCORRECT INFORMATION.
Explanation: The REPAIR utility job with the LOG DSNU656I csect-name REPLACE OPERATION
YES option was unable to replace certain critical, SUCCESSFUL, DATA WAS hex-data
nondata information in the page for one of these
reasons: Explanation: This message is issued by the REPAIR
utility in response to a REPLACE control statement
v Some critical information on any page at the request. The message indicates that replacement of the
indicated offset cannot be replaced by this method. data occurred and that the replaced data had the
v The page is a header page and some of the indicated hexadecimal value ('hex-data').
information at the indicated offset cannot be replaced
by this method. Severity: 0 (informational)
v The information can be replaced only by using the System Action: The REPAIR utility located the
LOG NO option. indicated record, performed all requested verifications,
and replaced the data in the record at the indicated
Severity: 8 (error) offset with the new data as defined by the REPLACE
System Action: REPAIR resumes executing at the control statement.
next LOCATE statement. Later control statements in the System Programmer Response: If a changed record
same LOCATE block are not executed. is recovered before an image copy is made, and the
User Response: Correct the REPAIR control REPAIR utility was run with LOG NO, the repair must
statements and resubmit the request in a new utility job be reapplied. If the REPAIR utility was run with LOG
step. YES, no image copy is required before recovering the
data after the repair.
User Response: Check the OFFSET option on the
REPLACE statement to be sure it does not cause
critical information to be replaced. If the replacement is DSNU657I csect-name REPLACE RESET
intentional, use the LOG NO option. OPERATION SUCCESSFUL
Explanation: This message is issued by the REPAIR
DSNU654I csect-name VERIFY OPERATION utility in response to a REPLACE RESET control
FAILED, DATA IS hex-data statement request. The message indicates that the
broken page indicator has been reset.
Explanation: The verify operation requested on the
control statement failed. The actual data is given as Severity: 0 (informational)
'hex-data'. System Action: The REPAIR utility has reset the
Severity: 4 (warning) broken page indicator for the specified page. Although
the reset indicator has been committed, it has not been
System Action: All REPAIR REPLACE actions subject logged. If the page is recovered before an image copy
to the current LOCATE scope are ignored. Processing is made, the REPAIR RESET must be reapplied.
continues at the next LOCATE request, if any.
However, to make the repair persist across subsequent
User Response: Determine why the data (as reported RECOVER operations, an image copy should be taken
in the message) does not match the expectations of subsequent to the completion of the REPAIR utility.
VERIFY option. Make the appropriate correction, and
resubmit the REPAIR request in a new utility job step.
DSNU658I csect-name MULTIPLE RECORDS
Problem Determination: The REPAIR DUMP option FOUND WITH SPECIFIED KEY
can help you determine the correct verification data.
Refer to DB2 Utility Guide and Reference for REPAIR Explanation: The specified key is not unique. Several
processing constraints. DSNU660I messages, giving possible RID values for
this KEY, follow this message.
DSNU655I csect-name DELETE OPERATION Severity: 8 (error)
SUCCESSFUL System Action: Processing continues normally.
Explanation: This message is issued during the User Response: Change the LOCATE statement to
REPAIR utility in response to a DELETE control locate the desired RID, and resubmit the request in a
statement. new utility job step.
Chapter 18. DB2 Messages 535
DSNU659I • DSNU665I
DSNU659I csect-name REPAIR LEVELID DSNU662I csect-name NO RECORD FOUND WITH
OPERATION DISALLOWED. SPECIFIED KEY
Explanation: The REPAIR utility with the LEVELID Explanation: A KEY was specified on the LOCATE
clause is not allowed. Possible reasons are: statement, but no entry exists in the clustering index for
v The data set was in use at the time the REPAIR that KEY.
utility was run. Severity: 8 (error)
v The page set has outstanding log apply activity (an
System Action: Processing begins at the next
indoubt UR has interest in the page set or the page
LOCATE statement, if there is one.
set has pages in the logical page list (LPL)).
User Response: Correct the LOCATE statement, and
Severity: 8 (error)
resubmit the REPAIR statements in a new utility job
System Action: Processing ends with this operation. step.
User Response: The REPAIR LEVELID operation for
the given index space or table space cannot continue at DSNU663I csect-name PAGE hex-page-number NOT
this stage. If the page set is in use, you should not FOUND
attempt to run REPAIR LEVELID. If the page set has
Explanation: The page identified a record identifier
log apply activity outstanding (in-doubt UR or pages in
(RID) or KEY does not exist in the specified table
LPL), the log apply activity must complete before using
space.
REPAIR LEVELID. Submit other REPAIR control
statements in a different job step. Severity: 0 (informational) when issued by DUMP
PAGES(n). 8 (error) when issued by LOCATE PAGE(n).
DSNU660I csect-name POSSIBLE RID rid System Action: Processing begins at the next
LOCATE statement, if there is one.
Explanation: 'rid' is one of several records that map to
the specified KEY. User Response: Correct the LOCATE statement, and
resubmit the REPAIR statements in a new utility job
Severity: 8 (error)
step.
System Action: Other records also mapping to the
specified KEY are identified by other DSNU660I
DSNU664I csect-name INVALID OFFSET OR
messages. This message is preceded by message
LENGTH FOR xxxxx
DSNU658I. Processing continues normally.
Explanation: 'xxxxx' is 'RECORD' or 'PAGE'. The
User Response: Change the LOCATE statement to
specified or default values for OFFSET and LENGTH
locate the desired RID, and resubmit the request in a
combine to extend beyond the specified record or page.
new utility job step. If you suspect an error in DB2, refer
to Part 2 of DB2 Diagnosis Guide and Reference for Severity: 4 (warning)
information on identifying and reporting the problem.
System Action: Processing continues at the next
LOCATE statement, if there is one.
DSNU661I csect-name RECORD NOT FOUND IN
PAGE, MAXID= hex-data User Response: Correct the OFFSET and/or
LENGTH specification, and resubmit the REPAIR
Explanation: A RID was either specified or obtained statements in a new utility job step. If you suspect an
from the clustering index via the specified KEY. The error in DB2, refer to Part 2 of DB2 Diagnosis Guide
PAGE indicated in the RID did not contain the RECORD and Reference for information on identifying and
indicated in the RID. reporting the problem.
Severity: 8 (error)
DSNU665I csect-name NO RECORD ASSOCIATED
System Action: Processing proceeds to the next
WITH SPECIFIED RID
LOCATE statement, if there is one.
Explanation: A record identifier (RID) was specified on
User Response: Either change the LOCATE
the LOCATE statement, but that RID is not associated
statement to locate a valid RID or KEY, or use LOCATE
with any record in the specified table space. If DELETE
PAGE and resubmit the REPAIR statements in a new
processing returns this message, the RID may exist but
utility job step. If you suspect an error in DB2, refer to
be invalid for DELETE.
Part 2 of DB2 Diagnosis Guide and Reference for
information on identifying and reporting the problem. Severity: 8 (error)
System Action: Processing begins at the next
LOCATE statement, if there is one. Subsequent utilities
in the same job step will not be executed.
536 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU666I • DSNU673I
User Response: Correct the LOCATE statement, and
DSNU670I csect-name PAGE X page-id IS A
resubmit the REPAIR statements in a new utility job
BROKEN PAGE
step.
Explanation: The indicated page located by the
Problem Determination: REPAIR DELETE will issue
REPAIR utility has been marked broken by the data
this message for RIDs which are internal and do not
manager. The 'page id' is given in hexadecimal. This
directly represent user data. The DUMP keyword may
page is not accessible until the broken page indicator is
be used to view the RID, if it exists. These internal
reset by the REPAIR REPLACE RESET option.
records may only be repaired using the REPLACE
keyword. Severity: 4 (warning)
System Action: The message reports that the page in
DSNU666I csect-name NO INDEX EXISTS which the REPAIR utility is requested to REPLACE
some data is broken.
Explanation: The KEY for this table space is not a full
clustering key. The statement is invalid. User Response: Determine the cause of the broken
page with the assistance of the system programmer.
Severity: 8 (error)
When it is repaired, use the REPAIR RESET option.
System Action: Processing continues at the next
System Programmer Response: Determine the
LOCATE statement, if there is one.
cause of the broken page. It could be an internal error
User Response: Correct the LOCATE statement to and require support center assistance. The REPAIR
use the clustering index, or change LOCATE by PAGE DUMP option can be used to determine the contents of
or RID. If you suspect an error in DB2, refer to Part 2 of the page for failure analysis. If you suspect an error in
DB2 Diagnosis Guide and Reference for information on DB2, refer to Part 2 of DB2 Diagnosis Guide and
identifying and reporting the problem. Reference for information on identifying and reporting
the problem.
DSNU668I csect-name UNABLE TO CONVERT KEY
TO format DSNU672I csect-name INDEX USED HAS
MULTIPLE-FIELD KEY
Explanation: 'format' specifies the data type to which
the KEY specification must be converted. The Explanation: A REPAIR LOCATE KEY operation was
conversion has failed. attempted against a table space using an index that has
a multiple-field key. LOCATE KEY does not support
Severity: 8 (error) multiple-field keys.
System Action: Processing begins at the next Severity: 8 (error)
LOCATE statement, if there is one.
System Action: Processing begins at the next
User Response: Correct the LOCATE statement to LOCATE scope, if any.
specify a KEY either of the indicated data type or of a
compatible data-type. Then resubmit the REPAIR User Response: Change the LOCATE statement to
statements in a new utility job step. Refer to DB2 Utility specify PAGE and RID, and resubmit the REPAIR
Guide and Reference for a discussion of conversion statements in a new utility job step.
constraints.
DSNU673I csect-name REPAIR LOCATE RID
DSNU669I csect-name INDEX NOT FOUND FOR LOCATED A NON-DATA PAGE
SPECIFIED TABLESPACE
Explanation: The LOCATE RID option of the REPAIR
Explanation: An index was specified on the LOCATE utility was used to process a nondata page.
KEY statement via the INDEX keyword, but no index by
Severity: 8 (error)
that name was found related to the specified
TABLESPACE. System Action: Processing continues at the next
LOCATE statement. Otherwise, processing stops.
Severity: 8 (error)
User Response: To process nondata pages, use the
System Action: Processing begins at the next
LOCATE PAGE option in the REPAIR control
LOCATE statement, if there is one.
statements and resubmit the new utility job step. If you
User Response: Correct the LOCATE statement and suspect an error in DB2, refer to Part 2 of DB2
resubmit the REPAIR statements in a new utility job Diagnosis Guide and Reference for information on
step. identifying and reporting the problem.
Problem Determination: Valid index names can be
found in the SYSIBM.SYSINDEXES catalog table.
Chapter 18. DB2 Messages 537
DSNU676I • DSNU685I
DSNU676I csect-name - ROWID=rowid DSNU681I csect-name SET NOCHECKPEND
VERSION=version IS NOT FOUND IN OPERATION SUCCESSFUL
AUXILIARY INDEX
Explanation: This message reports the successful
Explanation: The REPAIR utility was unable to locate completion of the REPAIR SET TABLESPACE
the ROWID rowid and VERSION version in the index on NOCHECKPEND utility operation. The check pending
the auxiliary table. restriction has been removed from the specified table
space.
System Action: Utility returns completion code=8.
Severity: 0(informational)
Programmer Response: Correct the ROWID or
VERSION. Only ROWID and VERSION values System Action: The REPAIR SET statement has
previously generated by DB2 can be used. The most completed normally.
likely source values of a ROWID and VERSION are
messages DSNU743I, DSNU805I, and DSNU806I from
DSNU682I csect-name SET NORCVRPEND
the CHECK DATA or CHECK LOB utilities.
OPERATION SUCCESSFUL
Explanation: This message reports the successful
DSNU678I csect-name VERIFY, REPLACE, DUMP,
completion of the REPAIR SET NORCVRPEND utility
OR DELETE BEFORE LOCATE
operation. The RECOVERY PENDING restriction has
Explanation: The REPAIR utility was requested to been removed from the specified table space, from the
VERIFY, REPLACE, or DUMP or DELETE a page or specified index, or from all indexes of the specified table
record and that page of record could not be located. space.
Severity: 8 (error) Severity: 0 (informational)
System Action: Processing begins at the next System Action: The REPAIR SET statement has
LOCATE statement, if there is one. Subsequent utilities completed normally.
in the same job step will not be executed.
User Response: Correct the REPAIR control DSNU683I csect-name REPAIR LEVELID
statements, and resubmit the request in a new utility job OPERATION SUCCESSFUL.
step. If you suspect an error in DB2, refer to Part 2 of
Explanation: The REPAIR utility with the LEVELID
DB2 Diagnosis Guide and Reference for information on
clause completed successfully.
identifying and reporting the problem.
Severity: 0 (informational)
DSNU679I csect-name MULTIPLE 'DELETE'S PER System Action: Processing completed successfully.
'LOCATE' NOT ALLOWED
User Response: Submit any other REPAIR control
Explanation: The REPAIR utility was requested to statements in a different job step.
DELETE the same record more than once. Only one
DELETE is allowed per LOCATE RID or LOCATE KEY.
DSNU684I csect-name - SET NOAUXCHKP
Severity: 8 (error) OPERATION SUCCESSFUL
System Action: Processing begins at the next Explanation: This message reports the successful
LOCATE scope, if any. Subsequent utilities in the same completion of the REPAIR SET NOAUXCHKP utility
job step are not executed. operation. The auxiliary check pending (ACHKP) state
has been removed for the specified base table space.
User Response: Remove all but one DELETE control
statement from each LOCATE scope which is intended System Action: Utility returns completion code=0.
to delete a record. If you suspect an error in DB2, refer
to Part 2 of DB2 Diagnosis Guide and Reference for
information on identifying and reporting the problem. DSNU685I csect-name SET NORBDPEND
OPERATION SUCCESSFUL
DSNU680I csect-name PAGE hex-page-number Explanation: This message reports the successful
completion of the REPAIR SET NORBDPEND utility
Explanation: This message is issued as an identifier operation. The three restrictions REBUILD PENDING,
at the top of each page dumped by the REPAIR DUMP REBUILD PENDING STAR and PAGESET REBUILD
PAGES facility. 'hex-page-number' identifies the page PENDING have been removed from the specified index
which is about to be dumped. or from all indexes of the specified table space.
Severity: 0 (informational) Severity: 0 (informational)
System Action: Processing continues.
538 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU686I • DSNU703I
System Action: The REPAIR SET statement has
DSNU702I csect-name INVALID INDEX
completed normally.
SPECIFICATION. INDEX=iiii
Explanation: All tables referenced by the INDEXES in
DSNU686I csect-name - SET NOAUXWARN
the CHECK or REBUILD utility must be in the same
OPERATION SUCCESSFUL
table space. Index 'iiii' is not over a table in the table
Explanation: This message reports the successful space specified with the TABLESPACE keyword.
completion of the REPAIR SET NOAUXWARN utility
Severity: 8 (error)
operation. The AUX WARNING state has been removed
for the specified table space. System Action: Utility processing is discontinued.
Severity: 0 (informational) User Response: Correct the index name and/or the
TABLESPACE parameters such that a single table
System Action: Utility returns completion code=0.
space is involved, and rerun the utility job.
Programmer Response: None.
Problem Determination: To CHECK or REBUILD ALL
INDEXES in a table space, use the TABLESPACE
DSNU687I csect-name - ROWID=rowid keyword, but do not use the list option. This is one way
VERSION=version LOB DELETED to correct this error. If you want to correct the list of
indexes specified in the index name list, the following
Explanation: The LOB with the ROWID rowid and procedure will locate the table space name related to
VERSION version was successully deleted from the the index 'iiii'.
specified LOB table space.
The index name 'iiii' reported in the message is of the
System Action: Utility returns completion code=0. form 'creator.name'. Obtain the TBCREATOR and
Programmer Response: None TBNAME columns from the DB2 catalog table
SYSIBM.SYSINDEXES where columns CREATOR and
NAME have the values reported in the message. Obtain
DSNU691I csect-name - LOB WITH ROWID=rowid the DBNAME and TSNAME columns from the DB2
VERSION=version NOT FOUND catalog table SYSIBM.SYSTABLES, where columns
Explanation: The REPAIR utility was unable to find a CREATOR and NAME have the values obtained from
LOB with the ROWID of rowid and VERSION version. TBCREATOR and TBNAME of SYSIBM.SYSINDEXES.
System Action: Utility returns completion code=8. The values for DBNAME and TSNAME must be the
same for all indexes specified in the index name list and
Programmer Response: Either the ROWID is must be the same as the table space name specified on
incorrect, or the index on the auxiliary table is broken. In the TABLESPACE keyword (if provided).
the first case correct the ROWID as specified on the
LOCATE ROWID statement. If the index on the auxiliary
table is broken, execute the REBUILD INDEX utility to DSNU703I csect-name INVALID INDEX
rebuild the index. SPECIFICATION. INDEX=iiii
Explanation: All tables referenced by the indexes in
DSNU700I csect-name nnnn INDEX ENTRIES the CHECK or REBUILD utility must be in the same
UNLOADED FROM INDEX=iiii table space. Index 'iiii' is not over a table in the same
PARTITION=pppp table space as the prior indexes listed in the index
name list.
Explanation: The CHECK utility UNLOAD phase
unloaded nnnn records from the index named iiii and Severity: 8 (error)
partition pppp. System Action: Utility processing is discontinued.
Severity: 0 (informational) User Response: Correct the index name and/or the
System Action: Processing continues. TABLESPACE parameters such that a single table
space is involved, and rerun the utility job.
DSNU701I csect-name nnnn INDEX ENTRIES Problem Determination: To CHECK or REBUILD ALL
UNLOADED FROM iiii INDEXES in a table space, use the TABLESPACE
keyword, but do not use the list option. This is one way
Explanation: The CHECK Utility UNLOAD phase to correct this error. If you want to correct the list of
unloaded nnnn records from the index named iiii. indexes specified in the index name list, the following
Severity: 0 (informational) procedure will locate the table space name related to
the index 'iiii'.
System Action: Processing continues.
The index name 'iiii' reported in the message is of the
form 'creator.name'. Obtain the TBCREATOR and
Chapter 18. DB2 Messages 539
DSNU705I • DSNU711I
TBNAME columns from the DB2 catalog table User Response: Run the REBUILD INDEX utility for
SYSIBM.SYSINDEXES, where columns CREATOR and index 'iiii'.
NAME have the values reported in the message. Obtain
the DBNAME and TSNAME columns from the DB2
DSNU708I csect-name INDEX IS NOT UNIQUE.
catalog table SYSIBM.SYSTABLES, where columns
INDEX=iiii, KEY=kkkk
CREATOR and NAME have the values obtained from
TBCREATOR and TBNAME of SYSIBM.SYSINDEXES. Explanation: The CHECK utility CHECKIDX phase
found that unique index 'iiii' contains a nonunique key,
The values for DBNAME and TSNAME must be the
'kkkk'.
same for all indexes specified in the index name list and
must be the same as the table space name specified on Severity: 4 (warning)
the TABLESPACE keyword if provided.
System Action: CHECK utility processing continues.
DSNU705I csect-name UNLOAD PHASE User Response: Drop the unique index, and delete
COMPLETE, ELAPSED TIME=tttt the duplicate rows. Re-create the index.
Explanation: The unload phase of the CHECK or
REBUILD INDEX utility is complete. DSNU709I csect-name NO INDEX ENTRY FOR
ROW. RID=rrrr, INDEX=iiii, KEY=kkkk
Severity: 0 (informational)
Explanation: The CHECK utility CHECKIDX phase
System Action: Processing continues. found that index 'iiii' is missing an entry for the row at
RID 'rrrr' with key 'kkkk'.
DSNU706I csect-name ROW IS IN WRONG Severity: 4 (warning)
PARTITION RID=rrrr, INDEX=iiii,
KEY=kkkk, CORRECT PART=pppp, System Action: CHECK utility processing continues.
WRONG PART=wwww User Response: Run the REBUILD INDEX utility for
Explanation: The row at RID 'rrrr' resides in the wrong index 'iiii'.
partition. The partitioning KEY 'kkkk' for partitioning
INDEX 'iiii' indicates that the row at RID 'rrrr' should DSNU710I csect-name INDEX ENTRY CONTAINS
reside in partition 'pppp', however the rid indicates that INVALID ZERO REPRESENTATION.
the row contains partition 'wwww'. RID=rrrr, INDEX=iiii, KEY=kkkk
Severity: 4 (warning) Explanation: The CHECK utility CHECKIDX phase
System Action: Utility processing continues. found that index 'iiii' has an entry that contains a
negative zero. The index entry is for the row at RID 'rrrr'
User Response: Run RECOVER TABLESPACE utility with key 'kkkk'.
to recover the data or run REPAIR DELETE utility to
delete the row 'rrrr' followed by CHECK INDEX and Severity: 4 (warning)
CHECK DATA utility if referential constraints are System Action: CHECK utility processing continues.
involved.
User Response: Run the REBUILD INDEX utility for
Problem Determination: The inconsistency between index 'iiii'.
the table space partition number of a row and the index
space partition number of the row’s clustering key may
be due to a DB2 internal error, but is most likely due to DSNU711I csect-name NO ROW FOR INDEX
a user using the DSN1COPY service aid to populate a ENTRY. RID=rrrr, INDEX=iiii, KEY=kkkk
target table space with data from a source table space Explanation: The CHECK utility CHECKIDX phase
when the clustering key values on the source and target found that the index 'iiii' contains an entry that has no
table spaces are not identical. row. The index entry contained RID 'rrrr' and key 'kkkk',
but RID 'rrrr' is not a valid record.
DSNU707I csect-name INDEX ENTRY POINTS TO Severity: 4 (warning)
WRONG TABLE. OBID=oooo, RID=rrrr,
INDEX= System Action: CHECK utility processing continues.
Explanation: The CHECK utility CHECKIDX phase User Response: Run the REBUILD INDEX utility for
found that index 'iiii' contains an entry for key 'kkkk' that index 'iiii'.
points to record at RID 'rrrr', but the record belongs to
the table with OBID 'oooo'.
Severity: 4 (warning)
System Action: CHECK utility processing continues.
540 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU712I • DSNU722I
statements following, the job step is terminated normally
DSNU712I csect-name INDEX OUT OF SEQUENCE.
and the UTILID of the job step becomes available for
INDEX=iiii, KEY=kkkk
reuse.
Explanation: The CHECK utility CHECKIDX phase
User Response: If the table space specification is in
found that index 'iiii' is not in correct sequence.
error, correct it and resubmit the utility. If the table
Severity: 4 (warning) space specification is correct, and the table space
contains no indexed tables, this is a normal indication
System Action: CHECK utility processing continues.
and no response is necessary.
User Response: Run the REBUILD INDEX utility for
index 'iiii'.
DSNU719I csect-name nnnn ENTRIES CHECKED
FOR INDEX iiii
DSNU713I csect-name KEYS MISMATCH. RID=rrrr,
Explanation: The CHECK utility has completed
INDEX=iiii, KEY=kkkk, DATA KEY=jjjj
checking index 'iiii' and has processed 'nnnn' index
Explanation: The CHECK utility CHECKIDX phase entries. This message will be issued once for each
found that index iiii contains an entry for the row at rid index checked.
rrrr that is inconsistent. KEY kkkk does not match DATA
Severity: 0 (informational)
KEY jjjj.
System Action: Processing continues.
Severity: 4 (warning)
System Action: CHECK utility processing continues.
DSNU720I csect-name CHECKIDX PHASE
User Response: Run the REBUILD INDEX utility for COMPLETE, ELAPSED TIME = tttt
index 'iiii'.
Explanation: The CHECK utility CHECKIDX phase is
complete.
DSNU715I csect-name MULTIPLE INDEX ENTRIES
Severity: 0 (informational)
FOR ROW. RID=rrrr, INDEX=iiii,
KEY=kkkk System Action: Processing continues.
Explanation: The CHECK utility CHECKIDX phase
found that index 'iiii' has multiple index entries for the DSNU721I csect-name - USER auth-id DOES NOT
row at RID 'rrrr' with key 'kkkk'. HAVE DELETE AUTHORITY ON TABLE
Severity: 4 (warning) Explanation: The CHECK DATA utility was run with
DELETE YES, but user auth-id does not have authority
System Action: CHECK utility processing continues.
to delete from a table specified in the utility statement or
User Response: Run the REBUILD INDEX utility for from one of its descendents.
index 'iiii'.
Severity: 8 (error)
System Action: Further utility processing is
DSNU717I csect-name nnnn ENTRIES CHECKED
terminated.
FOR INDEX=iiii PARTITION=pppp
User Response: Obtain authorization to delete from
Explanation: The CHECK utility completed checking
the tables specified in the utility statement and any of its
index iiii partition pppp and processed nnnn index
descendents that are affected.
entries. This message is issued once for each index
partition checked.
DSNU722I csect-name - USER userid DOES NOT
Severity: 0 (informational)
HAVE INSERT AUTHORITY ON
System Action: Processing continues. EXCEPTION TABLE
Explanation: The CHECK DATA utility was run with
DSNU718I csect-name NO INDEXES FOUND FOR FOR EXCEPTION specified but user 'userid' does not
TABLESPACE tttt have authority to insert into an exception table specified
in the utility statement.
Explanation: A utility has been invoked with the
TABLESPACE keyword specifying a table space Severity: 8 (error)
containing tables that have no indexes.
System Action: Further utility processing is
Severity: 4 (warning) terminated.
System Action: This message indicates completion of User Response: Obtain authorization to insert into all
the utility. Processing continues to the next utility of the exception tables specified in the utility statement.
statement in the job step, if any. If there are no utility
Chapter 18. DB2 Messages 541
DSNU725I • DSNU732I
terminate processing after all the exception tables have
DSNU725I csect-name DUPLICATE TABLESPACE
been examined.
tsp NAMES EXIST IN THE
TABLESPACE LIST User Response: Refer to Part 2 (Volume 1) of DB2
Administration Guide for a definition of the CREATE
Explanation: This message is issued by the CHECK
TABLE command with the LIKE operand to correct the
DATA utility when a duplicate table space 'tsp' is found
invalid exception table.
in the table space list. An entry in the list for the same
table space with a partition specified is also considered
a duplicate. This is because all partitions are the default DSNU729I csect-name TABLE table-name NOT
when no partition is specified for a partitioned table SPECIFIED IN THE ’FOR EXCEPTION’
space. The CHECK DATA utility proceeds and the CLAUSE
duplicate entry is skipped.
Explanation: The CHECK DATA utility did not find a
Severity: 4 (warning) required table listed in the FOR EXCEPTION clause. All
tables with constraints in the table spaces being
System Action: Processing continues.
checked and their descendents must be listed in the
FOR EXCEPTION clause of CHECK DATA utility.
DSNU726I csect-name SCOPE PENDING IS
Severity: 8 (error)
ACTIVE, BUT THE ENTIRE TABLE
SPACE tsp MUST BE CHECKED System Action: The CHECK DATA utility terminates
processing after all the required tables are examined.
Explanation: This message is issued by the CHECK
DATA utility when checking with the option SCOPE User Response: Examine the utility input statement to
PENDING. Table space tsp is in check pending status, determine the reason for the missing table named in the
but the utility is checking all rows in dependent tables or message. Correct the input statement to include the
tables defined with check constraints in that table missing table and resubmit the job. Refer to DB2 Utility
space. Guide and Reference for information about the FOR
EXCEPTION clause of the CHECK DATA utility and use
Severity: 4 (warning)
of exception tables.
System Action: The utility continues processing.
DSNU730I csect-name CHECKING TABLE tab
DSNU727I csect-name TABLESPACE tsp IS NOT
Explanation: This message is issued when the
CHECK PENDING
CHECK DATA utility begins to process a table. The
Explanation: This message is issued when 'CHECK name of table being checked is 'tab'.
DATA TABLESPACE tsp SCOPE PENDING' is specified
Severity: 0 (informational)
and the CHECK DATA utility finds that the table space
is not in a check pending state. The CHECK DATA utility System Action: Processing continues.
skips table space 'tsp' and will continue with any other
table space specified. The catalog fields that reflect the
extent of a check pending state are updated to ensure DSNU731I csect-name EXCEPTION LIMIT
that they indicate that no check is required. REACHED
Severity: 4 (warning) Explanation: The EXCEPTION limit specified on the
CHECK utility statement has been reached.
System Action: Processing continues.
Severity: 8 (error)
DSNU728I csect-name INVALID EXCEPTION System Action: The CHECK utility terminates
TABLE table2 FOR table1 processing.
Explanation: This message is issued when the User Response: If required, increase the exception
CHECK DATA utility finds an exception table is invalid. limit and resubmit the job.
The exception table named 'table2' which was specified
for rows from table, 'table1', is invalid. Either 'table2' DSNU732I NO TABLE TO BE CHECKED FOR
was missing columns of 'table1' or 'table2' contained TABLESPACE tsp
incompatible column attributes. The CHECK DATA utility
will terminate processing after all exception tables have Explanation: The CHECK DATA utility determined that
been examined. none of the tables in table space tsp has a constraint
defined. Therefore, no table in that table space is
Severity: 8 (error) checked.
System Action: The CHECK DATA utility will This message is issued by the following CSECT:
DSNUKINP
542 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU733I • DSNU742I
Severity: 4 (warning) table space partition is not in a check pending state.
The CHECK DATA utility skips table space 'tsp' partition
System Action: Utility processing continues.
'part' and continues with any other table space
specified. The catalog fields that reflect the extent of a
DSNU733I csect-name ROW (RID=rrrrrr) HAS NO check pending state are updated to ensure that they
PARENT FOR rel indicate that no check is required.
Explanation: This message is issued when the Severity: 4 (warning)
CHECK DATA utility finds a row in a dependent table
System Action: Processing continues.
without a parent. The row with RID, 'rrrrrr', has no
parent for the relationship named 'rel'. This message is
always proceeded by a DSNU730I message that DSNU739I csect-name CHECK TABLE tab
identifies the table in error. COMPLETE, elapsed time=t1
Severity: 4 (warning) Explanation: This message is issued when the
CHECK DATA utility finishes processing a table. The
System Action: Processing continues.
elapsed clock time that the check of table 'tab'
User Response: Refer to Part 2 (Volume 1) of DB2 consumed is 't1'.
Administration Guide for a discussion of the check
Severity: 0 (informational)
pending operation.
DSNU740I csect-name CHECKING TABLE tab
DSNU735I csect-name DUPLICATE TABLESPACE
PARTITION part
tsp PARTITION part NAMES EXIST IN
THE TABLESPACE LIST Explanation: This message is issued when the
CHECK DATA utility begins to process a table of a
Explanation: This message is issued by the CHECK
partitioned table space in which a single partition was
DATA utility when a duplicate table space 'tsp' and
specified. The name of the table and the number of the
partition 'part' is found in the table space list. An entry in
partition being checked are identified in the message.
the table space list with a partition specified is
considered to be a duplicate when another entry for the Severity: 0 (informational)
same table space with no partition specified (defaults to
System Action: Processing continues.
all partitions for a partitioned table space) is found. In
this case, the table space list entry with no partition
specified has priority and the entry with a partition DSNU741I csect-name nn ROWS DELETED FROM
specified is skipped. The CHECK DATA utility proceeds TABLE tab
and the duplicate entry is skipped.
Explanation: This message is issued by the CHECK
Severity: 4 (warning) DATA utility when the DELETE YES option is specified.
The number of rows deleted from TABLE tab is the
System Action: Processing continues.
number of rows that contain referential integrity
violations or check constraint violations, plus their
DSNU736I csect-name SCOPE PENDING IS descendent rows. The number of rows deleted from
ACTIVE, BUT THE ENTIRE TABLE TABLE tab is equal to the number of rows inserted into
SPACE tsp PARTITION part MUST BE the corresponding exception table.
CHECKED
Severity: 4 (warning)
Explanation: This message is issued by the CHECK
System Action: Processing continues.
DATA utility when checking with the option SCOPE
PENDING. Table space tsp partition part is in check
pending status, but the utility is checking all rows in that DSNU742I csect-name ROW (RID=rrrrrr) VIOLATES
table space partition. CHECK CONSTRAINT constraint-name
ON TABLE table-name
Severity: 4 (warning)
Explanation: The CHECK DATA utility found that the
System Action: The utility continues processing.
row with RID=rrrrrr in table table-name violated check
constraint constraint-name.
DSNU737I csect-name TABLESPACE tsp
Severity: 4 (warning)
PARTITION part IS NOT CHECK
PENDING System Action: Processing continues
Explanation: This message is issued when 'CHECK User Response: Refer to Part 2 (Volume 1) of DB2
DATA TABLESPACE tsp PART part SCOPE PENDING' Administration Guide for a discussion of the check
is specified and the CHECK DATA utility finds that the pending operation and recovery procedures.
Chapter 18. DB2 Messages 543
DSNU743I • DSNU760I
System Action: Utility processing continues normally.
DSNU743I csect-name - LOB WITH ROWID=rowid
VERSION=version IS INVALID
DSNU751I csect-name CATALOG operation OF
Explanation: The CHECK LOB utility found that the
TABLE - table-name
LOB column with rowid ROWID and VERSION version
was marked as invalid. Explanation: This message is issued the first time
data is operated upon for the designated table.
System Action: LOB table space is set Aux Warning.
Utility returns completion code=4. Severity: 0 (informational)
Programmer Response: The LOB column must be System Action: Utility processing continues normally.
updated or the row containing the LOB column deleted
using SQL to remove the invalid indication.
DSNU752I csect-name CATMAINT operation PHASE
phase-number COMPLETED
DSNU745I csect-name - ROWID=rowid
VERSION=version RID=rid MISSING IN Explanation: The CATMAINT utility PHASE
LOB TABLE SPACE=lob-table-space- phase-number processing completed for the indicated
name operation.
Explanation: The CHECK INDEX utility found an Severity: 0 (informational)
index entry key with ROWID rowid and VERSION System Action: Utility processing continues normally.
version in the index, but not in the LOB table space
named lob-table-space-name.
DSNU756I csect-name CATALOG TABLE IS EMPTY
System Action: The utility returns completion code=4. - table-name
The index is set Recover Pending.
Explanation: This message is issued when the named
Programmer Response: Use REBUILD INDEX or table is empty.
RECOVER to correct the index on the auxiliary table.
Severity: 0 (informational)
DSNU747I csect-name - ROWID=rowid System Action: Utility processing continues normally.
VERSION=version MISSING IN
INDEX=index-name DSNU759I csect-name INCORRECT UNLOAD
Explanation: The CHECK INDEX utility found a LOB DATASET HAS BEEN DETECTED
with ROWID rowid and VERSION version in the LOB Explanation: This message indicates an inconsistency
table space but not in the index on the auxiliary table, between the release level of the unloaded catalog and
index-name. the DB2 release that is running the CATMAINT utility.
System Action: Utility returns completion code=4. The Severity: 8 (error)
index is set Recover Pending.
System Action: Utility processing terminates.
Programmer Response: Use REBUILD INDEX to
correct the index on the auxiliary table. User Response: Review the JCL for the job to ensure
that the correct unload data set is specified. Verify that
the correct level of DB2 is up.
DSNU749I csect-name CHECK DATA COMPLETE,
ELAPSED TIME=t1
DSNU760I csect-name SPECIFIED USER NOT
Explanation: This message is issued when the DEFINED WITH INSTALLATION
CHECK DATA utility is complete. The elapsed clock time SYSADM AUTHORITY
that the CHECK DATA utility consumed is 't1'.
Explanation: The utility can be run only under a user
Severity: 0 (informational) defined with the installation SYSADM authority.
System Action: Processing ends. Severity: 8 (error)
System Action: Utility processing terminates.
DSNU750I csect-name CATMAINT operation PHASE
phase-number STARTED User Response: Rerun the utility with the proper
authorization.
Explanation: The CATMAINT utility phase
phase-number processing started for the indicated
operation.
Severity: 0 (informational)
544 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU762I • DSNU769I
| User Response: Depending on the migration error,
DSNU762I csect-name DUPLICATE RECORD
| perform the necessary actions:
DETECTED FOR TABLENAME -
table-name SEQNO OF THE INPUT | v If the catalog is not at the correct level for a
RECORD IS - seqno FOLLOWING IS UP | migration, fall back to the prevoius release. Migrate
TO 119 BYTES OFRECORD BEING | only from DB2 releases that support migration.
INSERTED | v Prior to attempting a Stored Procedure migration,
| migrate the DB2 catalog to the current release. After
Explanation: An object created in the target catalog
| migrating the DB2 catalog, then you can migrate the
has the same name as an object being migrated from
| Stored Procedures.
the source catalog.
Severity: 8 (error)
DSNU766I csect-name THE CATALOG HAS
System Action: Utility abends. ALREADY BEEN MIGRATED. NO
ACTION WILL BE TAKEN
User Response: User data should not be in the target
catalog before running the CATMAINT utility. Free or Explanation: The catalog was already successfully
drop the object from the target catalog and rerun the migrated. There is no reason to rerun the catalog
CATMAINT utility. migration job. Therefore, no action is taken to update
the DB2 catalog.
DSNU764I csect-name FOLLOWING IS UP TO 119 Severity: 0 (informational)
BYTES OF RECORDFOR TABLE
System Action: Processing ends.
table-name, SEQNO seqno BEING
PROCESSED AT THE TIME OF ERROR
DSNU767I csect-name DB2 SYSTEM MUST BE
Explanation: An abend occurred during the execution
STARTED ACCESS(MAINT)
of the CATMAINT utility, during the processing of the
table, 'table-name', with a sequence number of 'seqno'. Explanation: In order for the utility to execute, the
The cause of the abend is one of the following: DB2 subsystem must be started with ACCESS(MAINT).
v The record sequence number was invalid. This message indicates that the subsystem was not
v An unexpected return code was received from started in this manner.
DSNUEXLO.
v The table name was not found in the load table Severity: 8 (error)
(DSNUELTB). System Action: -STOP DB2, and then -START DB2
v The parent record could not be positioned. with ACCESS(MAINT).
v The position OBID was zero (DSNUELTB has
incorrect value).
v The record action code is incorrect. DSNU768I csect-name CATMAINT CONVERT
COMPLETE FOR INDEX index-name
Following this message, up to the first 119 bytes of the Explanation: The conversion is complete for index
recordin question is displayed. index-name.
Severity: 8 (error) Severity: 0 (informational)
System Action: Utility abends. System Action: Processing continues with the next
User Response: Verify that the record in the unloaded index.
data set is correct.
DSNU769I csect-name THE BUILD PHASE FAILED
| DSNU765I csect-name THE DB2 CATALOG IS NOT FOR INDEX index-name REASON
| AT THE REQUIRED LEVEL. CATALOG reason
| NOT UPDATED Explanation: The CATMAINT CONVERT build phase
| Explanation: The DB2 catalog is not at the proper failed for index index-name. This message and others
| catalog level to migrate the catalog. This error can identify the actions that should be taken.
| occur due to the following reasons: Severity: 8 (error)
| v Attempting to migrate the catalog from a DB2 release
Operator Response: Note the reason code and the
| that does not support migration
index name. See the Problem Determination section for
| v Attempting to migrate DB2 Stored Procedures prior to an explanation of the collected data.
| a catalog migration
System Action: Utility processing continues with the
| Severity: 8 (error) next index and will terminate with return code 8.
| System Action: Utility processing terminates User Response: Correct the problem indicated by the
Chapter 18. DB2 Messages 545
DSNU770I • DSNU777I
reason code. Either resubmit the CATMAINT CONVERT
DSNU774I csect-name - SPECIFIED DATABASE
job or recover the index that failed.
database NOT FOUND
Problem Determination: The reason the build phase
Explanation: The database indicated by the utility
failed is identified by the reason code, which is
control statement was not found in catalog table
described in “Part 4. DB2 Codes” on page 707.
SYSIBM.SYSDATABASE.
Severity: 8 (error)
DSNU770I csect-name - DBD type STARTED FOR
DATABASE database System Action: Utility processing terminates.
Explanation: This message marks the start of the User Response: Ensure that the database indicated
REPAIR DBD type utility. In the message, 'type' can be by the utility control statement exists in
DIAGNOSE, REBUILD, or TEST. The database name SYSIBM.SYSDATABASE.
specified in the REPAIR statement is 'database'.
Severity: 0 (informational) DSNU775I csect-name - DROP OF DATABASE
dbname FAILED WITH SQLCODE =
System Action: Utility processing continues normally.
sqlcode
Explanation: An error was encountered while using
DSNU771I csect-name - DBD type COMPLETE FOR
the REPAIR DBD DROP utility to drop DATABASE
DATABASE database
'dbname'. The SQL error code is indicated by 'sqlcode'.
Explanation: This message marks the completion of
Severity: 8 (error)
the REPAIR DBD type utility. In the message, 'type' can
be DIAGNOSE, REBUILD, or TEST. The database System Action: DATABASE 'dbname' is not dropped.
name specified in the REPAIR statement is 'database'.
User Response: For a description of the SQL error
Severity: 0 (informational) code that was issued, refer to “Part 2. SQL Return
Codes” on page 9.
System Action: Utility processing continues normally.
DSNU776I csect-name CATMAINT operation
DSNU772I csect-name - THE object-type
ERROR - error-text
qualifier.object-name IS UNAVAILABLE
IN THIS RELEASE Explanation: The CATMAINT utility halted because
the catalog contains view(s) on the SYSCOLDIST
Explanation: This message indicates that the
and/or SYSCOLDISTSTATS catalog tables.
specified object has a dependency on a release from
which fall back has occurred, and cannot be operated Severity: 0 (informational)
upon in the current release.
System Action: Utility processing halts.
Severity: 8 (error)
User Response: Remove the views on these catalog
System Action: Utility processing terminates. tables. Then retry the failing CATMAINT operation. This
message is followed by an abend04E RC00E40601.
User Response: Check the IBMREQD column of the
See the problem determination text of RC00E40601 for
catalog table associated with the specified object type. If
additional information.
the value in the catalog table is the release dependency
mark for a release of DB2 from which fall back has
occurred, the utility is not operational for the current DSNU777I csect-name CATMAINT operation
release of the targeted database. STATUS status-msg
Explanation: The CATMAINT utility is processing
DSNU773I csect-name - database IS A SYSTEM CATMAINT operation. status-msg indicates where
DATABASE AND CANNOT BE CATMAINT is in the operation process.
PROCESSED
Severity: 0 (informational)
Explanation: The database indicated is not eligible for
System Action: Utility processing continues normally.
processing by the type of the REPAIR DBD utility
involved.
Severity: 8 (error)
System Action: Utility processing terminates.
User Response: Ensure that the utility control
statement specifies the correct database.
546 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU778I • DSNU785I
DSNU778I csect-name - ERROR PROCESSING DSNU782I csect-name UNABLE TO RECOVER
SQL STATEMENT - SQL CODE IS: DUE TO ACTIVITY AT ANOTHER
sql-code SQL MESSAGE TOKENS: SYSTEM LEVEL
message-token(s) THE FOLLOWING IS
Explanation: The RECOVER utility is unable to
THE PROBLEM SQL STATEMENT:
recover the specified table space. Activity at another
sql-statement
system level has left all image copies for this table
Explanation: There was a utility abend in the DB2 space inconsistent with the DB2 LOG.
database services address space (ssnmDBM1) during
Severity: 8 (error)
CATMAINT UPDATE processing. The message-tokens
displayed are those found in the SQLERRMT field of System Action: The utility terminates with a return
the SQLCA, separated by commas, for the indicated code of 8.
SQLCODE sql-code. The problem SQL statement
sql-statement is also displayed. User Response: The table space, in its entirety can
not be recovered. Individual data sets may be
Severity: 0 (informaitonal). recoverable using the DSNUM() keyword.
System Action: Utility processing abends.
DSNU783I csect-name INDEXES DSNSCT02,
User Response: This message is followed by an
DSNLUX01, DSNLUX02 and DSNLLX02
abend04E RC00E40601. The sql-code,
HAVE SUBPAGES VALUE GREATER
message-tokens, and sql-statement listed in this
THAN 1 AND CANNOT BECOME
message are probably sufficient to diagnose and correct
GROUP BUFFER POOL DEPENDENT.
the problem. See the problem determination text of
RC00E40601 for additional information. Explanation: CATMAINT CONVERT TO TYPE 1
DIRECTORY alters the indexes DSNSCT02,
DSNLUX01, DSNLUX02, and DSNLLX02 to type 1 with
DSNU780I csect-name DSNUTILB LEVEL rel1
more than one subpage. In a data sharing environment,
INVALID WITH SUBSYSTEM LEVEL rel2
there cannot be inter-DB2 R/W interest on type 1
Explanation: JCL has been submitted which executes indexes with more than one subpage (they cannot
level 'rel1' of DSNUTILB against a level 'rel2' DB2 become group buffer pool dependent). This means that
subsystem. The levels must match. any read or update request that causes inter-DB2 R/W
interest on these directory indexes is denied with a
Severity: 8 (error)
'resource unavailable' condition.
System Action: The utility terminates with a return
For directory indexes, only type 2 indexes can have full
code of 8.
R/W sharing among data sharing members.
User Response: Determine the DB2 subsystem
Severity: 4 (warning)
against which you wish to execute. Determine which
STEPLIB data set contains the corresponding System Action: Processing continues.
DSNUTILB load module. Correct the JCL to specify the
User Response: With very few exceptions, indexes on
correct data set on the STEPLIB DD statement and the
the directory will have inter-DB2 R/W interest if there
correct DB2 subsystem on the EXEC statement and
are two or more members in your DB2 data sharing
resubmit the job.
group. Use CATMAINT CONVERT TO TYPE 2
DIRECTORY to convert the indexes to type 2 if you
DSNU781I csect-name RESTART OF LEVEL rel1 plan to have two or more DB2 members.
UTILITY AT LEVEL rel2 INVALID
Explanation: JCL has been submitted which attempts DSNU785I csect-name - PAGE=page-number IS
to RESTART a stopped utility. The utility began INVALID FOR REASON=reason-code
processing at level 'rel1' and cannot be restarted at
Explanation: The CHECK LOB utility found the LOB
level 'rel2'.
table space page numbered page-number was invalid
System Action: The utility job is abended with reason for reason reason-code. reason-code can be in the
code X'00E40018'. form: reason1, reason2. This reason code is supplied
for serviceability only.
User Response: Either restart the utility at the same
level it was originated or terminate the utility with the System Action: Utility returns completion code=4.
TERM command and resubmit it at the new level. Refer LOB table space is set check pending.
to DB2 Command Reference for special TERM
Programmer Response: Notify the system
command considerations.
programmer.
System Programmer Response: Notify the IBM
Chapter 18. DB2 Messages 547
DSNU787I • DSNU809I
Service Representative. Be prepared to provide the column is set invalid. The base table space is set to an
message number, reason code, and dump of the LOB Aux Warning state.
table space page.
Utility returns completion code=4.
Programmer Response: CHECK DATA relies on
DSNU787I csect-name - LOB WITH ROWID=rowid
information in LOB table space and in the auxiliary
VERSION=version PAGE=page IS IN
index being correct. Before running CHECK DATA to
ERROR FOR REASON=reason-code
check auxiliary columns, first run CHECK LOB and then
EXPECTED VALUE=expected-value
run REBUILD INDEX or CHECK INDEX. CHECK LOB
ACTUAL VALUE=actual-value
ensures the validity of the LOB table space. REBUILD
Explanation: The CHECK LOB utility found that the INDEX or CHECK INDEX ensures the validity of the
LOB with ROWID rowID and VERSION version is in auxiliary index.
error for reason reason-code. The error was found in
If AUXERROR REPORT was specified, run the CHECK
page page of the LOB table space. This reason code is
DATA utility with AUXERROR INVALIDATE to set the
supplied for serviceability only.
base table column invalid.
EXPECTED VALUE is the expected-value of the
If AUXERROR INVALIDATE was specified, use SQL to
condition that is checked by the CHECK LOG utility.
update the LOB column or delete the base table row.
ACTUAL VALUE is the actual-value of the condition.
Rerun the CHECK DATA utility with AUXERROR
System Action: Utility returns completion code=4. INVALIDATE specified. If all Auxiliary Column Check
LOB table space is set check pending. errors were corrected, Aux Warning will be reset.
Programmer Response: Notify the system The REPAIR utility can be used to reset the Aux
programmer. Warning state.
System Programmer Response: Notify the IBM
Service Representative. Be prepared to provide the DSNU806I csect-name - TABLE=table_name
message number and reason code. COLUMN=column_name WAS SET
INVALID ROWID=rowid
VERSION=version
DSNU795I csect-name - CHECKLOB PHASE
COMPLETE - ELAPSED TIME=time Explanation: The CHECK DATA utility with
AUXERROR INVALIDATE specified, set the LOB
Explanation: The CHECK LOB utility CHECKLOB
column named column_name invalid. The LOB column
phase was completed with the elapsed time of time.
was in the row with ROWID, rowid in the table named
Severity: 0 (informational) table_name. The version for the LOB column was
version.
System Action: The CHECKLOB phase is completed.
System Action: Utility returns completion code=4. The
base table space is set to a Aux Warning state.
DSNU796I csect-name - REPRTLOB PHASE
COMPLETE - ELAPSED TIME=time Programmer Response: None
Explanation: The CHECK LOB utility REPRTLOB Use SQL to update the LOB column or delete the base
phase was completed with the elapsed time of time. table row. Rerun the CHECK DATA utility with
AUXERROR INVALIDATE specified. If all Auxilary
Severity: 0 (informational) Column Check errors were corrected, Aux Warning will
System Action: The REPRTLOB phase is completed. be reset.
The REPAIR utility can be used to reset the Aux
DSNU805I csect-name - TABLE=table_name Warning state.
COLUMN=column_name IS OUT OF
SYNCH ROWID=rowid VERSION=version DSNU809I csect-name - TABLE=table_name
Explanation: The CHECK DATA utility found a base COLUMN=column_name IS MISSING IN
table row with ROWID, rowid, in table, table_name. The INDEX index-name ROWID=rowid
LOB column named column_name in the base table is VERSION=version
out of synch with the LOB table space. The version Explanation: The CHECK DATA utility found a record
reported is from the index on the auxiliary table. in the table named table-name in the row with a ROWID
System Action: If AUXERROR REPORT was of rowid. The column named column-name did not have
specified, this error is reported only. The base table an index entry in the on the auxiliary index named
space is set to a Aux Check Pending state. index-name. The version for the LOB column was
version.
If AUXERROR INVALIDATE was specified, the LOB
548 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU811I • DSNU815I
System Action: If AUXERROR REPORT was System Action: Utility returns completion code=4.
specified, this error is reported only. The base table
Programmer Response: CHECK DATA relies on
space is set to an Aux Check Pending state.
information in the index on the auxiliary table and LOB
If AUXERROR INVALIDATE was specified, the LOB table space being correct. Before running CHECK DATA
column is set invalid. The base table space is set to an to check auxiliary columns, first run CHECK LOB and
Aux Warning state. then run REBUILD INDEX or CHECK INDEX. CHECK
LOB ensures the validity of the LOB table space.
Utility returns completion code=4.
REBUILD INDEX or CHECK INDEX ensures the validity
Programmer Response: CHECK DATA relies on of the auxiliary index.
information in LOB table space and in the auxiliary
The LOB can be deleted using the REPAIR utility.
index being correct. Before running CHECK DATA to
Specify LOCATE ROWID VERSION DELETE.
check auxiliary columns, first run CHECK LOB and then
run REBUILD INDEX or CHECK INDEX. CHECK LOB
ensures the validity of the LOB table space. REBUILD DSNU814I csect-name - TABLE=table_name
INDEX or CHECK INDEX ensures the validity of the COLUMN=column_name IS ZERO OR
auxiliary index. NULL BUT ENTRY IN INDEX index-name
FOUND ROWID=rowid VERSION=version
If AUXERROR REPORT was specified, run the CHECK
DATA utility with AUXERROR INVALIDATE to set the Explanation: The CHECK DATA utility found a record
base table column invalid. in the table named table-name in the row with a ROWID
of rowid. The column named column-name was
If AUXERROR INVALIDATE was specified, use SQL to
indicated null or zero length, but an index entry with the
update the LOB column or delete the base table row.
same ROWID was found in the index on the auxiliary
Rerun the CHECK DATA utility with AUXERROR
table named index-name. The version for the LOB
INVALIDATE specified. If all Auxiliary Column Check
column was version.
errors were corrected, Aux Warning will be reset.
System Action: This is an informational message
The REPAIR utility can be used to reset the Aux
only. The fact that a LOB column entry exists in the
Warning state.
index on the auxiliary table when the LOB column is
marked null or has a null length does not hinder LOB
DSNU811I csect-name - TABLE=table_name column processing.
COLUMN=column_name IS INVALID
If AUXERROR INVALIDATE was specified, the LOB
ROWID=rowid VERSION=version
column is not set invalid for this error.
Explanation: The CHECK DATA utility found a record
Utility returns completion code=4.
in the table named table-name in the row with ROWID
rowid. The column named column-name was marked Programmer Response: CHECK DATA relies on
invalid by a prior execution of the CHECK DATA utility information in the index on the auxiliary table and LOB
with AUXERROR INVALIDATE specified. The version table space being correct. Both CHECK LOB, to ensure
for the LOB column was version. the validity of the LOB table space, and RECOVER
INDEX or CHECK INDEX, to ensure the validity of the
System Action: Utility returns completion code=4. The
index on the auxiliary table, should be executed in that
base table space is set to a Aux Warning state.
order prior to the execution of CHECK DATA with
Programmer Response: If AUXERROR INVALIDATE auxiliary column checking.
was specified, use SQL to update the LOB column or
The LOB can be deleted from the LOB table space by
delete the base table row. Rerun the CHECK DATA
using REPAIR LOCATE TABLESPACE ROWID
utility with AUXERROR INVALIDATE specified. If all
DELETE
Auxiliary Column Check errors were corrected, Aux
Warning will be reset.
DSNU815I csect-name - TABLESPACE
The REPAIR utility can be used to reset the Aux
table-space-name IS IN AUX CHECK
Warning state.
PENDING STATE
Explanation: The CHECK DATA utility found auxiliary
DSNU813I csect-name - LOB IN TABLE
check errors. AUXERROR REPORT was specified, so
SPACE=lob_table_space_name WITH
errors were left as found.
ROWID=rowid AND VERSION=version
HAS NO BASE TABLE ROW Auxiliary check pending is a prohibitive state.
Explanation: The CHECK DATA utility found a LOB in Previous error messages report the errors found.
the LOB table space named lob_table_space_name but
System Action: Utility returns completion code=8.
did not find a row in the base table for this LOB. The
LOB has a ROWID of rowid and version of version. Programmer Response: Use the CHECK DATA with
Chapter 18. DB2 Messages 549
DSNU816I • DSNU832I
AUXERROR INVALIDATE. This will modify the auxiliary CHANGE (or -TERM UTILITY) issued this message, the
check errors so they can be corrected and set the state index is in rebuild pending status. During the renaming
of the table space to auxiliary warning. of a data set during REORG, either a data set with the
source name did not yet exist or a data set with the
After running CHECK DATA with AUXERROR
target name already existed.
INVALIDATE, use SQL to update the LOB column or
delete the base table row. Rerun the CHECK DATA Severity: 4 (warning) or 8 (error)
utility with AUXERROR INVALIDATE specified. If all
User Response: If the RECOVER or REORG utility
auxiliary check errors were corrected, auxiliary warning
(or -TERM UTILITY) issued this message, use the
will be reset.
REBUILD INDEX utility to rebuild this index.
The auxiliary check pending state can also be reset
If the REBUILD INDEX utility issued this message
using REPAIR with SET NOAUXCHKP. Resetting
resolve the duplicate index entries or invalid keys and
auxiliary check pending with REPAIR will have
rerun the REBUILD INDEX utility.
unpredictable results.
DSNU831I csect-name ALL INDEXES OF
DSNU816I csect-name - TABLESPACE
TABLESPACE= table space-name ARE
table-space-name IS IN AUX WARNING
IN REBUILD PENDING
STATE
Explanation: The RECOVER TORBA, TOLOGPOINT,
Explanation: The CHECK DATA utility found auxiliary
or TOCOPY utility issues this message to inform the
check errors. AUXERROR INVALIDATE was specified,
user of the state of all indexes belonging to the
so LOB columns in error were marked invalid.
recovered table space. All indexes were put in rebuild
Auxiliary warning is a non-prohibitive state. Updating the pending status to prevent data and index inconsistency.
LOB column or deleting the row containing the LOB All indexes should be rebuilt before they are used.
column by SQL is permitted. Valid LOBs may be
System Action: The RECOVER utility completed
accessed, however any attempt to retrieve an invalid
successfully.
modified LOB column by SQL will result in a -904 return
code. Severity: 4 (warning)
Previous error messages report the errors found. User Response: Use the REBUILD utility with the ALL
option to rebuild all indexes over the recovered table
| Severity: 0 (informational)
space.
| System Action: Processing continues.
Programmer Response: Use SQL to update or delete DSNU832I csect-name - INDEX= creator.index-name
the LOB columns in error. Use CHECK DATA with PART= partition number IS IN REBUILD
AUXERROR INVALIDATE to verify all errors were PENDING STATE
corrected and to reset the auxiliary warning state.
Explanation: If the RECOVER utility issued this
The auxiliary warning state can also be reset using message, one partition of a partitioned table space is
REPAIR with SET NOAUXWARN. being recovered to a point in time with keyword
TOCOPY, TOLOGPOINT, or TORBA. The corresponding
index for that partition was placed in rebuild pending
DSNU830I csect-name - INDEX= index-name IS IN
status.
REBUILD PENDING STATE
If the REBUILD INDEX utility issued this message, the
Explanation: If the RECOVER utility issued this
index or the partition of a cluster index is in rebuild
message, the corresponding table space to this index
pending status. Either duplicate index entries existed
was recovered to a point in time with keyword TOCOPY,
during the BUILD phase of the REBUILD INDEX or
TOLOGPOINT, or TORBA. Thus, the index was placed
INDEX PART, or invalid KEY/RIDs, which do not belong
in rebuild pending status.
to the partition of the cluster index, were detected. The
If the REBUILD INDEX utility issued this message, the duplicate index entries or invalid KEY/RID entries must
index is in rebuild pending status. Either duplicate index be resolved before starting the REBUILD INDEX utility
entries existed during the BUILD phase of the REBUILD again to rebuild the index and remove the index from
INDEX, or invalid KEY/RIDs, which do not belong to the rebuild pending status.
partition of the cluster index, were detected. The
If the REORG utility with SHRLEVEL REFERENCE or
duplicate index entries or invalid KEY/RID entries must
CHANGE (or -TERM UTILITY) issued this message,
be resolved before starting the REBUILD INDEX utility
one partition of a partitioned index was placed in rebuild
again to rebuild the index and remove the index from
pending status. During the renaming of a data set
rebuild pending status.
during REORG, either a data set with the source name
If the REORG utility with SHRLEVEL REFERENCE or did not yet exist or a data set with the target name
already existed.
550 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU833I • DSNU864I
Severity: 4 (warning) or 8 (error)
| DSNU862I DISPLAY AVAILABLE UTILITIES. MAP:
User Response: If the RECOVER or REORG utility | bit-map
(or -TERM UTILITY) issued the message, rebuild this
| Explanation: This message is the end-result of a
index with the REBUILD INDEX utility.
| DIAGNOSE DISPLAY AVAILABLE control statement. It
If the REBUILD INDEX utility issued this message | displays the utilities that are available on this
resolve duplicate index entries or invalid keys and rerun | subsystem. The message contains a machine-readable
the REBUILD INDEX utility. | bit-map, and precedes a table of utility names. They are
| two representations of the same information. An
| available utility is represented by the utility name that
DSNU833I csect-name - UNABLE TO RECOVER | appears in the table and a ″1″ in the corresponding bit
object_type object_name DUE TO ALTER | position in the bit-map. An unavailable utility is
COLUMN | represented by a blank table entry and a ″0″ in the
Explanation: RECOVER utility is unable to recover | corresponding bit position in the bit-map.
the index or index space as requested because an | Utilities may be unavailable if separately-priced features
ALTER COLUMN VARCHAR has been performed. The | JDB771K and/or JDB771M are not installed, or installed
current column definition is no longer consistent with the | improperly.
image copy and log records which would be used to
perform the requested recovery. | The table position and bit position are fixed for any
| given utility, and maintenance cannot alter them. Bit
Severity: 8 (error) | positions correspond to table entries when you read the
User Response: Use the REBUILD INDEX utility to | table across each row, left to right, starting with the top
rebuild the index from the tablespace. | row. For example, bit 1 corresponds to CATMAINT, bit 2
| to CHECK, and bit 9 to OPTIONS.
DSNU834I csect-name - UNABLE TO RECOVER | The following example shows the partial output of this
object_type object_name DSNUM dsnum | message. Due to space constraints, the sample has
DUE TO ALTER COLUMN | been truncated. The actual table contains eight columns
| of identity names:
Explanation: RECOVER utility is unable to recover
| DSNU862I DSNUDIAG - DISPLAY AVAILABLE UTILITIES.
the index or index space partition as requested because
| MAP: 11111111111111111110000000000000
an ALTER COLUMN VARCHAR has been performed. | ---------------------------------------------
The current column definition is no longer consistent | |CATMAINT |CHECK |COPY |DIAGNOSE |...
with the image copy and log records which would be | |OPTIONS |QUIESCE |REBUILD |RECOVER |...
used to perform the requested recovery. | |STOSPACE |TEMPLATE |UNLOAD | |...
| | | | | |
Severity: 8 (error) | ---------------------------------------------
User Response: Use the REBUILD INDEX utility to | Severity: 0 (informational)
rebuild the index partition from the tablespace.
| System Action: The DIANGOSE DISPLAY
| AVAILABLE utility control statement has completed
DSNU860I csect-name DIAGNOSE UTILITY | normally.
COMPLETE
Explanation: This message is issued in response to DSNU863I csect-name DISPLAY OBD
the normal completion of the DIAGNOSE utility. dbname.tsname
Severity: 0 (informational) Explanation: This message is the heading message
System Action: This message indicates the normal for DIAGNOSE DISPLAY OBD output.
completion of the DIAGNOSE utility. Processing Severity: 0 (informational)
continues to the next utility statement in the utility job
step. System Action: This message indicates the start of
the output for the DIAGNOSE DISPLAY OBD function.
DSNU861I csectname DISPLAY MEPL
DSNU864I csect-name DISPLAY OBD, DBID=nn
Explanation: This is the header message for output of OBID=nn OBD TYPE=type
the DIAGNOSE DISPLAY MEPL function. The contents
of the MEPL is dumped to SYSPRINT. Explanation: This message is the heading message
for the OBD being displayed.
Severity: 0 (informational)
Severity: 0 (informational)
System Action: This message indicates the beginning
of DIAGNOSE DISPLAY MEPL processing.
Chapter 18. DB2 Messages 551
DSNU865I • DSNU874I
System Action: This message identifies the OBD
DSNU869I csect-name DISPLAY SYSUTIL
being displayed.
COMPLETE
Explanation: This message is issued in response to
DSNU865I csect-name DISPLAY OBD
normal completion of DISPLAY SYSUTIL processing.
dbname.tsname COMPLETE
Severity: 0 (informational)
Explanation: This message is issued in response to
normal completion of DISPLAY OBD processing. System Action: This message indicates the end of
DISPLAY SYSUTIL processing.
Severity: 0 (informational)
System Action: This message indicates the end of
DSNU870I csect-name NO SYSUTIL RECORD
DISPLAY OBD processing.
FOUND
Explanation: This message is issued if no SYSUTIL
DSNU866I csect-name DISPLAY SYSUTIL JOB
records are found when DISPLAY SYSUTIL is specified.
INFORMATION
Severity: 4 (warning)
Explanation: This message is the header message for
the SYSUTIL JOB INFORMATION section of the System Action: This message indicates the end of
DIAGNOSE DISPLAY SYSUTIL output. This section DISPLAY SYSUTIL processing.
displays the job information area of the SYSUTIL record
and contains information which identifies the utility the
DSNU871I csectname DISPLAY DBET DATABASE
SYSUTIL record is referencing.
dbname
Severity: 0 (informational)
Explanation: This message is the heading for display
System Action: This message identifies the SYSUTIL output of the database exception table (DBET) entry
JOB INFORMATION section of the DIAGNOSE associated with database dbname.
DISPLAY SYSUTIL output.
Severity: 0 (informational)
System Action: DIAGNOSE DISPLAY DBET
DSNU867I csect-name DISPLAY SYSUTIL
processing started for the named database.
CHECKPOINT/RESTART INFORMATION
Explanation: This message is the header message for
DSNU872I csectname DISPLAY DBET TABLE
the SYSUTIL UTILITY CHECKPOINT/RESTART
SPACE tsname
INFORMATION section of the DIAGNOSE DISPLAY
SYSUTIL output. This section displays the utility Explanation: This message is the heading for display
checkpoint/restart area of the SYSUTIL record and output of the database exception table (DBET) entry
contains information pertaining to utility processing associated with table space tsname.
needed for the restart of the utility.
Severity: 0 (informational)
Severity: 0 (informational)
System Action: DIAGNOSE DISPLAY DBET
System Action: This message identifies the SYSUTIL processing started for the named table space.
UTILITY CHECKPOINT/RESTART INFORMATION
section of the DIAGNOSE DISPLAY SYSUTIL output.
DSNU873I csectname DISPLAY DBET INDEX
index-name
DSNU868I csect-name DISPLAY SYSUTIL UTILITY
DEPENDENT AREA Explanation: This message is the heading for display
output of the database exception table (DBET) entry
Explanation: This message is the header message for associated with index index-name.
the SYSUTIL UTILITY DEPENDENT INFORMATION
section of the DIAGNOSE DISPLAY SYSUTIL output. Severity: 0 (informational)
This section displays the utility dependent area of the System Action: DIAGNOSE DISPLAY DBET
SYSUTIL record and contains information particular to processing started for the named index.
the utility which the SYSUTIL record is referencing.
Severity: 0 (informational) DSNU874I csectname NO DBET ENTRY FOUND
System Action: This message identifies the SYSUTIL FOR THE SPECIFIED OBJECT
UTILITY DEPENDENT INFORMATION section of the Explanation: There is no database exception table
DIAGNOSE DISPLAY SYSUTIL output. (DBET) entry associated with the specified object.
Severity: 4 (warning)
552 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU875I • DSNU905I
System Action: Processing continues normally. System Action: DBD checking continues normally.
DSNU875I csectname DIAGNOSE WAIT AT DSNU901I csect-name - OBD X'xxxx' obd-type HAS
MESSAGE=msgno INSTANCE=nn CORR THE FOLLOWING DIFFERENCES
ID=id1 CONN ID=id2 REPLY TO CONT
Explanation: This message marks the start of an OBD
Explanation: The DIAGNOSE WAIT function was comparison for the REPAIR DBD TEST or REPAIR DBD
invoked to wait at a specified message 'msgno' on the DIAGNOSE utility. This message is displayed when a
nn’th time that message was issued. The CORR ID is difference in the OBDs has been detected. The OBID of
the correlation identifier of the thread associated with the OBD being compared against the DB2 catalog is
the waiting application. The CONN ID is the connection 'xxxx'. The type of OBD being displayed is 'obd-type'.
identifier of the thread.
Severity: 0 (informational)
Severity: 4 (warning)
System Action: DBD checking continues normally.
System Action: Processing is stopped until the user
responds to this message.
DSNU902I csect-name - EXISTING OBD AT
User Response: See operator response. OFFSET X'xxxxxxxx' IN EXISTING DBD
Operator Response: After diagnosis procedure in Explanation: Following this message is a hexadecimal
progress is completed, reply to this message to dump of the OBD as it exists in the DSNDB01.DBD01
continue execution. Any reply is valid. page set. In the message, 'xxxxxxxx' is the hexadecimal
offset from the beginning of the existing DBD as it
appears later in the REPAIR DBD DIAGNOSE output.
DSNU876I csectname DIAGNOSE WAIT AT
TRACEID=X'trcid' INSTANCE=nn CORR Severity: 0 (informational)
ID=id1 CONN ID=id2 REPLY TO CONT
System Action: DBD checking continues normally.
Explanation: The DIAGNOSE WAIT function was
invoked to wait at a specified traceid 'trcid' on the nn'th
DSNU903I csect-name - REBUILT OBD AT OFFSET
time that traceid was encountered. The CORR ID is the
X'xxxxxxxx' IN REBUILT DBD
correlation identifier of the thread associated with the
waiting application. The CONN ID is the connection Explanation: Following this message is a hexadecimal
identifier of the thread. dump of the OBD that was rebuilt from the DB2
Catalog. In the message, 'xxxxxxxx' is the hexadecimal
Severity: 4 (warning)
offset from the beginning of the rebuilt DBD as it
System Action: Processing is stopped until the user appears later in the REPAIR DBD DIAGNOSE output.
responds to this message.
Severity: 0 (informational)
User Response: See operator response.
System Action: DBD checking continues normally.
Operator Response: After diagnosis procedure in
progress is complete, reply to this message to continue
DSNU904I csect-name - EXISTING VALUE X'xx..xx'
execution. Any reply is valid.
Explanation: This message shows a hexadecimal
string which is the value of a field in the OBD as it
DSNU877I event modulename+offset
exists on the DSNDB01.DBD01 page set. The
Explanation: Event ’event’ occurred at module hexadecimal string is 'xx..xx'.
’modulename’ plus ’offset’. The DIAGNOSE utility issues
Severity: 0 (informational)
this message to aid in diagnosing utility problems.
System Action: DBD checking continues normally.
Severity: 0 (informational)
System Action: Processing continues normally.
DSNU905I csect-name - REBUILT VALUE X'xx..xx'
Explanation: This message shows a hexadecimal
DSNU900I csect-name - DBD X'xxxx'
string which is the value of a field in the OBD which
COMPARISON STARTING
was rebuilt from the DB2 catalog. The hexadecimal
Explanation: This message marks the start of a DBD string is 'xx..xx'.
comparison for the REPAIR DBD TEST or REPAIR DBD
Severity: 0 (informational)
DIAGNOSE utility. The DBID of the DBD being
compared against the DB2 Catalog is 'xxxx'. System Action: DBD checking continues normally.
Severity: 0 (informational)
Chapter 18. DB2 Messages 553
DSNU906I • DSNU915I
DSNU906I csect-name - EXISTING VALUE 'cc..cc' DSNU912I csect-name - phase-completion-message
-- nn ERRORS WERE FOUND
Explanation: This message shows a character string
which is the value of a field in the OBD as it exists on Explanation: This message marks the end of a
the DSNDB01.DBD01 page set. The character string is processing phase in the DBD comparison for a REPAIR
'cc..cc'. DBD TEST or REPAIR DBD DIAGNOSE utility. In the
message, 'nn' indicates the number of errors detected
Severity: 0 (informational)
while processing. Informational and warning messages
System Action: DBD checking continues normally. are not added into the error count.
Severity: 0 (informational)
DSNU907I csect-name - REBUILT VALUE 'cc..cc'
System Action: DBD checking continues normally.
Explanation: This message shows a character string
which is the value of a field in the OBD which was
DSNU913I csect-name - OBD X'xxxx'
rebuilt from the DB2 catalog. The character string is
COMPARISON COMPLETE -- nn
'cc..cc'.
ERRORS WERE FOUND
Severity: 0 (informational)
Explanation: This message marks the end of an OBD
System Action: DBD checking continues normally. comparison for the REPAIR DBD TEST or REPAIR DBD
DIAGNOSE utility. This message is displayed only when
a difference has been detected. If there is no difference,
DSNU908I csect-name - EXISTING OBD IS obd-type this message will not be displayed. The OBID of the
Explanation: This message shows the OBD type of OBD being compared against the DB2 catalog is 'xxxx'.
the OBD which exists on the DSNDB01.DBD01 page The number of errors in this OBD is 'nn'. Informational
set. and warning messages are not added into the error
count.
Severity: 0 (informational)
Severity: 0 (informational)
System Action: DBD checking continues normally.
System Action: DBD checking continues normally.
DSNU909I csect-name - REBUILT OBD IS obd-type
DSNU914I csect-name - DBD X'xxxx'
Explanation: This message shows the OBD type of COMPARISON COMPLETE -- nn
the OBD which was rebuilt from the DB2 catalog. ERRORS WERE FOUND
Severity: 0 (informational) Explanation: This message marks the end of a DBD
System Action: DBD checking continues normally. comparison for the REPAIR DBD TEST or REPAIR DBD
DIAGNOSE utility. The DBID of the DBD being
compared against the DB2 catalog is 'xxxx'. The total
DSNU910I csect-name - EXISTING DBD number of errors found in this DBD is 'nn'.
Explanation: Following this message is a hexadecimal Severity: 0 (informational)
dump of the DBD which exists on the DSNDB01.DBD01
page set. System Action: DBD checking completed.
Severity: 0 (informational)
DSNU915I csect-name - OBD X'obid' E-X'xxxxxxxx'
System Action: DBD checking continues normally. R-X'yyyyyyyy' obd-description
Explanation: This message is used when listing the
DSNU911I csect-name - REBUILT DBD OBDs in the REPAIR DBD DIAGNOSE utility. The OBID
Explanation: Following this message is a hexadecimal of the OBD being listed is 'obid'. The offset to the OBD
dump of the DBD which was rebuilt from the DB2 within the EXISTING DBD which is displayed later in the
Catalog. output is 'xxxxxxxx'. The offset to the OBD within the
REBUILT DBD which is displayed later in the output is
Severity: 0 (informational) 'yyyyyyyy'. A short description of the state of the OBD is
'obd-description'.
System Action: DBD checking continues normally.
Severity: 0 (informational)
System Action: DBD checking completed.
554 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU916I • DSNU924I
DSNU916I csect-name - OBDS DIFFER AT OFFSET DSNU921I csect-name - OBD X'xxxx' MISSING IN
X'xxxxxxxx' field-name - INFORMATION EXISTING DBD
NOT IN DB2 CATALOG
Explanation: This message indicates that an OBD
Explanation: This message indicates the value of a which was rebuilt from the DB2 catalog does not exist in
field in the OBD differs from the DBD which exists on the DBD which exists on the DSNDB01.DBD01 page
the DSNDB01.DBD01 page set and the DBD rebuilt set. The DB2 catalog and DBD/OBD are inconsistent.
from the DB2 catalog. This is information which is not The OBID of the missing OBD is 'xxxx'.
kept in the DB2 catalog. This is an acceptable
Severity: 4 (warning)
difference and does not indicate that the OBD is
damaged. The hexadecimal offset from the beginning of System Action: DBD checking continues normally.
the OBD is 'xxxxxxxx'. The name of the field is
'field-name'.
DSNU922I csect-name - OBD X'xxxx' MISSING IN
Severity: 0 (informational) REBUILT DBD
System Action: DBD checking continues normally. Explanation: This message indicates that an OBD in
the DBD which exists on the DSNDB01.DBD01 page
set does not exist in the DBD which was rebuilt from the
DSNU917I csect-name - DBDS DIFFER AT OFFSET
DB2 catalog. The DB2 catalog and DBD/OBD are
X'xxxxxxxx' field-name - INFORMATION
inconsistent. The OBID of the missing OBD is 'xxxx'.
NOT IN DB2 CATALOG
Severity: 4 (warning)
Explanation: This message indicates that the value of
a field in the DBD differs from the DBD which exists on System Action: DBD checking continues normally.
the DSNDB01.DBD01 page set and the DBD rebuilt
from the DB2 Catalog. This is information which is not
kept in the DB2 catalog. This is an acceptable DSNU923I csect-name—OBDTYPE FOR OBD
difference and does not indicate that the DBD is X'xxxx' DOES NOT MATCH —NO
damaged. The hexadecimal offset from the beginning of FURTHER CHECKING DONE FOR THIS
the DBD is 'xxxxxxxx'. The name of the field is OBD
'field-name'. Explanation: The object descriptor (OBD) that exists
Severity: 0 (informational) on the DSNDB01.DBD01 page set is different from the
type of OBD that was rebuilt from the DB2 catalog. No
System Action: DBD checking continues normally. further processing can be done because the fields of
one OBD type are different from the fields of another.
The DB2 catalog and database descriptor (DBD)/OBD
DSNU919I csect-name - DBD X'xxxx' OBD X'yyyy' -
are inconsistent. The object identifier (OBID) of the OBD
details
that is inconsistent is 'xxxx'.
Explanation: This message gives detailed information
Severity: 4 (warning)
about the specified OBD. The DBID of the DBD is
'xxxx'. The OBID of the OBD is 'yyyy'. A description of System Action: Checking for OBD X'xxxx' stops.
the error is 'details'. Checking of the DBD continues normally.
Severity: 0 (informational)
DSNU924I csect-name—DBDS DIFFER AT OFFSET
System Action: DBD checking continues normally.
X'xxxxxxxx' field-name
Explanation: The value of a field in the database
DSNU920I csect-name - OBDS DIFFER AT OFFSET
descriptor (DBD) differs from the value of the
X'xxxxxxxx' field-name
corresponding field in the DBD that exists on the
Explanation: This message indicates that the value of DSNDB01.DBD01 page set and differs from the value of
a field in the OBD differs from the DBD which exists on the corresponding field in the DBD that was rebuilt from
the DSNDB01.DBD01 page set and the DBD rebuilt the DB2 catalog.
from the DB2 catalog. The DB2 Catalog and DBD/OBD xxxxxxxx
are inconsistent. The hexadecimal offset from the The hex offset from the beginning of the DBD.
beginning of the OBD is 'xxxxxxxx'. The name of the field-name
field is 'field-name'. The name of the field.
Severity: 4 (warning) Severity: 0 (informational)
System Action: DBD checking continues normally. System Action: Checking of the DBD continues
normally.
Chapter 18. DB2 Messages 555
DSNU925I • DSNU931I
identifier (OBID) of the OBD that is a hole is 'xxxx'.
DSNU925I csect-name—OBDDFILE AT OFFSET
X'xxxxxxxx' IN EXISTING DBD HAS Severity: 4 (warning)
OBID X'nnnn' WHICH IS NOT A FILE
OBD System Action: Checking of the DBD continues
normally.
Explanation: The field that points to the first FILE
OBD (OBDDFILE) in the database descriptor (DBD) that
exists on the DSNDB01.DBD01 page set does not point DSNU929I csect-name—OBD FIELD field-name
to a FILE OBD. The DB2 catalog and DBD/OBD (object HAS VALUE OUT OF RANGE AT
descriptor) are inconsistent. OFFSET X'xxxxxxxx' IN OBD X'nnnn'
xxxxxxxx Explanation: The object descriptor (OBD) field
The hex offset from the beginning of the 'field-name' has an unexpected value. The DB2 catalog
existing DBD. and database descriptor (DBD)/OBD are inconsistent.
nnnn The object identifier (OBID) of the OBD which field-name
should be a FILE OBD. The name of the field in the OBD.
Severity: 4 (warning) xxxxxxxx
The hex offset from the beginning of the OBD.
System Action: Checking of the DBD continues nnnn The object identifier (OBID) of the OBD.
normally.
Severity: 4 (warning)
DSNU926I csect-name—OBDDFILE AT OFFSET System Action: Checking of the DBD continues
X'xxxxxxxx' IN REBUILT DBD HAS normally.
OBID X'nnnn' WHICH IS NOT A FILE
OBD DSNU930I csect-name— INDEX index-name (OBD
Explanation: The field that points to the first FILE X'xxxx') MUST BE REBUILT
OBD (OBDDFILE) in the database descriptor (DBD) that Explanation: The index 'index-name' must be either
was rebuilt from the DB2 catalog does not point to a recovered or dropped and recreated to ensure that the
FILE OBD. The DB2 catalog and DBD/OBD (object index is consistent with the description in the INDEX
descriptor) are inconsistent. FANSET OBD. The object descriptor (OBD) is not
xxxxxxxx damaged. However, if the index is not either recovered
The hex offset from the beginning of the rebuilt or dropped and recreated, incorrect output can be
DBD. produced when the index is used as an access path.
nnnn The object identifier (OBID) of the OBD that index-name
should be a FILE OBD. The name of the index found in
Severity: 4 (warning) SYSIBM.SYSINDEXES.
xxxx The object identifier (OBID) of the OBD.
System Action: Checking of the DBD continues
normally. Severity: 8 (error)
System Action: Checking of the DBD continues
DSNU927I csect-name—OBD X'xxxx' IS A HOLE IN normally.
EXISTING DBD
Explanation: The object descriptor (OBD) that exists DSNU931I csect-name - OBDDMAX FIELD OF DBD
on the DSNDB01.DBD01 page set has been logically IS TOO LARGE
deleted, OBDHOLE = '1'B. The DB2 catalog and Explanation: The OBDDMAX field (maximum number
database descriptor (DBD)/OBD are inconsistent. The of ID in the DBD) is too large. It is larger than the
object identifier (OBID) of the OBD that is a hole is largest possible number of ID based upon the DBD
'xxxx'. size.
Severity: 4 (warning) Severity: 8
System Action: Checking of the DBD continues System Action: Checking of the DBD continues but
normally. using the largest possible number of ID instead of the
incorrect OBDDMAX.
DSNU928I csect-name—OBD X'xxxx' IS A HOLE IN
REBUILT DBD
Explanation: The object descriptor (OBD) that was
rebuilt from the DB2 catalog has been logically deleted,
OBDHOLE = '1'B. The DB2 catalog and database
descriptor (DBD)/OBD are inconsistent. The object
556 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU935I • DSNU944I
DSNU935I csect-name DATABASE database-name DSNU940I csect-name AUTHID OR LUNAME NOT
IS NOT STARTED FOR UTILITY BLANK FOR FOLLOWING
PROCESSING ONLY SYSPROCEDURES ROW:
Explanation: This message is issued when the Explanation: A SYSPROCEDURES row contains an
REPAIR utility with the DBD option is run on a database AUTHID or LUNAME value. AUTHID and LUNAME are
that is not started for utility processing only. not supported attributes for DB2 Version 6 stored
procedures. DSNU944I messages follow that show the
Severity: 8
contents of the SYSPROCEDURES row.
System Action: REPAIR DBD terminated.
System Action: The SYSPROCEDURES row is not
User Response: Stop the database. Then start the migrated. SYSPROCEDURES migration continues with
database with the ACCESS(UT) option. Resubmit the the next row.
REPAIR DBD job.
System Programmer Response: Execute a CREATE
PROCEDURE statement to add the stored procedure
DSNU936I csect-name DATABASE database-name definition. A schema name may be specified in place of
IS IN USE AUTHID and LUNAME in the stored procedure
definition.
Explanation: This message is issued when the
REPAIR utility with the DBD option is run on a database
that is in use by others. DSNU941I csect-name CREATE PROCEDURE
FAILED WITH SQLCODE=sqlcode
Severity: 8 SQLSTATE=sqlstate
System Action: REPAIR DBD terminated. Explanation: The migration of a SYSPROCEDURES
User Response: Wait until all users are finished, then row has failed. The SQLCODE and SQLSTATE values
resubmit the REPAIR DBD job. indicate the type of error that occurred.
System Action: The SYSPROCEDURES row is not
DSNU938I csect-name—OBD X'xxxx' HAD migrated. The SYSPROCEDURES migration continues
DIFFERENCES WHICH WERE NOT IN A with the next row.
NAMED FIELD System Programmer Response: Check the stored
Explanation: There is a difference between the object procedure attributes and parameters that are listed in
descriptor (OBD) in the database descriptor (DBD) that the DSNU942I message, which follows this message.
exists on the DSNDB01.DBD01 page set and the DBD Execute a CREATE PROCEDURE statement with
that was rebuilt from the DB2 catalog. This difference correct attributes and parameters to add the stored
does not exist in a named field. Therefore, the detailed procedure definition.
search by field name fails to find the difference. The
DB2 catalog and DBD/OBD are inconsistent. The object
identifier (OBID) of the OBD in error is 'xxxx'. DSNU942I csect-name create_procedure_statement
Severity: 4 (warning) Explanation: This message follows message
DSNU941I when the migration of a SYSPROCEDURES
System Action: Checking of the DBD continues row fails. This message contains the CREATE
normally. PROCEDURE statement that DB2 used for migration of
the SYSPROCEDURES row.
DSNU939I csect-name—DBD HEADER HAD System Action: The SYSPROCEDURES row is not
DIFFERENCES WHICH WERE NOT IN A migrated. SYSPROCEDURES migration continues with
NAMED FIELD the next row.
Explanation: There is a difference between the DBD System Programmer Response: Use the CREATE
header in the DBD that exists on the DSNDB01.DBD01 PROCEDURE statement in this message and the
page set and the DBD that was rebuilt from the DB2 SQLCODE and SQLSTATE information in message
catalog. This difference does not exist in a named field. DSNU941I to diagnose the error.
Therefore, the detailed search by field name fails to find
the difference. The DB2 catalog and database
descriptor (DBD)/object descriptor (OBD) are DSNU944I csect-name sysprocedures_column_name
inconsistent. - sysprocedures_column_value
Severity: 4 (warning) Explanation: This message lists a column value for a
SYSPROCEDURES row that could not be migrated.
System Action: Checking of the DBD continues This message follows message DSNU940I.
normally.
Chapter 18. DB2 Messages 557
DSNU945I • DSNU973I
System Action: The SYSPROCEDURES row is not System Action: Processing continues.
migrated. SYSPROCEDURES migration continues with
Problem Determination: The utility being processed
the next row.
requested the setting of check pending either on or off.
The updating of the STATUS column of
DSNU945I csect-name CREATE SUCCESSFUL SYSTABLESPACE, and of the CHECKFLAG and
FOR PROCEDURE procedure_name CHECKRID columns of SYSTABLES and
SYSTABLEPART failed. Processing continues normally.
Explanation: A SYSPROCEDURES row with a value
However, those columns for the rows being updated
of procedure_name. in column PROCEDURE has been
now contain invalid values. Subsequent utility
successfully migrated.
processing ignores these values, and the next setting or
System Action: SYSPROCEDURES migration resetting of check pending for that table space corrects
continues normally. the error in one of the following ways:
v If the table space is set to check pending and the
DSNU971I csect-name TABLESPACE catalog fields are in error, the scope of check pending
dbname.tsname IS CHECK PENDING is escalated in the catalog. (The STATUS column of
| OR AUX CHECK PENDING SYSTABLESPACE is set to 'P', and the CHECKFLAG
CORRELATION-ID id1 CONNECTION-ID and CHECKRID columns of SYSTABLES and
id2 LUW-ID id3 SYSTABLEPART are set to 'C' and binary zeros.)
v If the table space is set to not check pending and the
Explanation: This message is sent to the console catalog fields are in error, the scope of check pending
when TABLESPACE tsname is set to CHECK pending is set off in the catalog. (The STATUS column of
| or auxiliary CHECK pending state. The SYSTABLES is set to an 'A', and the CHECKFLAG
CORRELATION-ID id1 is the correlation identifier of the and CHECKRID columns of SYSTABLES and
| thread requesting CHECK pending or auxiliary CHECK SYSTABLEPART are set to blanks.)
| pending status. Correlation IDs beginning with '0nn',
where nn is a number from 01 to 28, identify system
After the catalog fields are corrected, the setting or
agents. The CONNECTION-ID id2 is the correlation
resetting of check pending continues as specified.
identifier of the thread. The LUW-ID id3 is the
logical-unit-of-work identifier of the thread. If the LUW-ID
Usually message DSNT500I or DSNT501I is also
is an '*', the thread has no LUW-ID. If it is not an '*', the
issued, because the probable cause of the error is
value is a logical-unit-of-work-id that is assigned to the
RESOURCE UNAVAILABLE. If the reason for the failure
thread followed by an '=' sign and a token value, which
was not RESOURCE UNAVAILABLE, an SVC dump is
can be used in place of logical-unit-of-work-id in any
requested and processing continues normally. To
DB2 command that accepts logical-unit-of-work-id as
determine the cause of the failure, refer to the dump
input.
listing and the following diagnostic items listed in
Severity: 4 (warning) “Appendix B. Problem determination” on page 1281: 1,
5, 32
System Action: Processing continues.
User Response: Refer to Part 2 (Volume 1) of DB2
| DSNU973I csect-name CHECK PENDING, AUX
Administration Guide for a discussion of the CHECK
| CHECK PENDING OR BOTH HAS BEEN
pending operation.
| RESET FOR TABLESPACE
dbname.tsname CORRELATION-ID id1
DSNU972I csect-name CATALOG UPDATING CONNECTION-ID id2 LUW-ID id3
FAILURE WHILE SETTING OR
Explanation: This message is sent to the console
RESETTING CHECK PENDING
| when CHECK pending, auxiliary CHECK pending or
CORRELATION-ID id1 CONNECTION-ID
| both states were reset for TABLESPACE tsname. The
id2
CORRELATION-ID id1 is the correlation identifier of the
Explanation: When the check pending state is set on | thread requesting that the CHECK pending state, the
or off, the updating of the catalog tables | auxiliary CHECK pending state or both states be reset.
(SYSTABLESPACE, SYSTABLES, and Correlation IDs beginning with '0nn', where nn is a
SYSTABLEPART) fails. The CORRELATION-ID, 'id1', is number from 01 to 28, identify system agents. The
the correlation identifier of the thread associated with CONNECTION-ID id2 is the correlation identifier of the
the application requesting that the check pending state thread. The LUW-ID id3 is the logical-unit-of-work
be set on or off. The CONNECTION-ID, 'id2', is the identifier of the thread. If the LUW-ID is an '*', the
correlation identifier of the application. Correlation IDs thread has no LUW-ID. If it is not an '*', the value is a
beginning with '0nn', where 'nn' is a number from 01 to logical-unit-of-work-id that is assigned to the thread
28, identify system agents. followed by an '=' sign and a token value, which can be
used in place of the logical-unit-of-work-id in any DB2
Severity: 0 (informational) or 4 (warning) command that accepts a logical-unit-of-work-id as input.
558 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU993I • DSNU1001I
Severity: 0 (informational) V3R3 Diagnosis Guide for more information about the
VSAM procedures.
System Action: Processing continues.
User Response: Refer to Part 2 (Volume 1) of DB2
DSNU997I csect-name OUTPUT DATA SET NAME
| Administration Guide for a discussion about clearing the = data-set-name
| CHECK pending status.
Explanation: The indicated data-set-name is used for
output.
DSNU993I csect-name IMAGE COPY RESTORE
TERMINATED Severity: 0 (informational)
Explanation: Catalog and directory initialization
(image copy restore) did not complete successfully. DSNU998I csect-name INPUT DATA SET NAME =
data-set-name
Severity: 8 (error)
Explanation: The indicated data-set-name is used for
System Action: Processing terminates.
input.
User Response: Examine other error messages
Severity: 0 (informational)
associated with this job.
DSNU999I csect-name START OF IMAGE
DSNU994I csect-name IMAGE COPY RESTORE
COPYRESTORE FOR JOB job-name
COMPLETED SUCCESSFULLY
step-name
Explanation: Catalog and directory initialization
Explanation: The catalog and directory initialization
(image copy restore) completed successfully.
(image copy restore) started.
Severity: 0 (informational)
Severity: 0 (informational)
DSNU995I csect-name VSAM PUT
| DSNU1000I csect-name - PROCESSING CONTROL
ERROR,RPLERREG = return-code,
| STATEMENTS IN PREVIEW MODE
RPLERRCD = reason-code
| Explanation: The PREVIEW option has been
Explanation: VSAM PUT failed with the indicated
| specified either on the OPTIONS control statement or
return-code and reason-code.
| as a JCL parameter. Control statements will be
Severity: 8 (error) | previewed in this execution for TEMPLATE and
| LISTDEF use but the utility control statements will not
System Action: Processing terminates. | be executed. PREVIEW via JCL parameter will continue
User Response: Notify system programmer. | to the end of the job step. PREVIEW via OPTIONS
| PREVIEW will contine until the end of the job step or
System Programmer Response: Follow standard | another OPTIONS control statement.
VSAM diagnostic procedure. Refer to DFSMS/MVS:
Macro Instructions for Data Sets. See also MVS/DFP | Severity: 0 (informational)
V3R3 Diagnosis Guide for more information about the | System Action: Utility control statements are
VSAM procedures. | previewed but not executed.
| User Response: If the return code is 8, PREVIEW
DSNU996I csect-name VSAM OPEN ERROR, | detected errors which must be corrected. If the return
ACBERRFLG = error-code | code is 4, PREVIEW detected potential problems, but
Explanation: VSAM OPEN failed with the indicated | the previewed statements are valid.
ACB error-code. | Examine the preview output shown in informational
Severity: 8 (error) if error is greater than or equal to | messages DSNU1010I, DSNU1020I, DSNU1021I,
128; otherwise, 4 (warning) | DSNU1022I, DSNU1023I and DSNU1025I, plus any
| error messages. Correct any statements that are in
System Action: Processing terminates if the error | error and remove the PREVIEW option to execute the
code is greater than or equal to 128; otherwise, | control statements.
processing continues normally.
User Response: Notify the system programmer. | DSNU1001I csect-name - LISTDEF list-name
System Programmer Response: Follow standard | CLAUSE IDENTIFIES NO OBJECTS:
VSAM diagnostic procedure. Refer to DFSMS/MVS: | clause-type object-type qualifier.name
Macro Instructions for Data Sets. See also MVS/DFP | Explanation: An INCLUDE or EXCLUDE clause of a
| LISTDEF control statement returned no objects.
Chapter 18. DB2 Messages 559
DSNU1002I • DSNU1008I
| Severity: 4 (warning)
| DSNU1005I csect-name - UTILITY name NOT
| System Action: Utility processing continues. | ALLOWED IN dd-type DD dd-name
| User Response: Correcting the clause in error will | Explanation: The utility parser detected a control
| eliminate this message in the future. | statement other than TEMPLATE in the SYSTEMPL
| data set or LISTDEF in the SYSLISTD data set.
| DSNU1002I csect-name - INVALID KEYWORD | Severity: 8 (error)
| SPECIFIED ON CLAUSE: clause-type
| System Action: Utility processing is not initiated.
| object-type qualifier.name
| User Response: Remove the invalid control
| Explanation: An INCLUDE or EXCLUDE clause of a
| statements and resubmit the utility job. Refer to DB2
| LISTDEF control statement has an invalid keyword
| Utility Guide and Reference for the correct option
| specified.
| specifications.
| Catalog and directory objects may only be specified via
| their TABLESPACE or INDEXSPACE names.
| DSNU1006I csect-name - object-type object-name
| DATABASE, TABLE and INDEX may not be specified.
| NOT FOUND
| Catalog and directory object names may not contain
| pattern matching characters. They must be included or | Explanation: A utility control statement used a LIST or
| excluded explicitly using their complete names. Those | TEMPLATE that was not found in SYSIN or either of the
| include or exclude clauses may not contain the | SYSTEMPL or SYSLISTD data sets. These DD names
| keywords RI, BASS, LOB, ALL. | may vary if OPTIONS LISTDEFDD or OPTIONS
| TEMPLATEDD were specified.
| Severity: 8 (error)
| Severity: 8 (error)
| System Action: Utility processing stops.
| System Action: Utility processing is not initiated.
| User Response: Correct the invalid LISTDEF clause
| and rerun the utility. | User Response: Provide the missing LISTDEF or
| TEMPLATE definition in SYSIN prior to its use and
| resubmit the utility job. If the definition utility exists in
| DSNU1003I csect-name - INVALID LIST FOR
| another data set, provide the SYSTEMPL or SYSLISTD
| utility-name UTILITY
| DD card for the data set. Refer to DB2 Utility Guide and
| Explanation: The list name referenced on this control | Reference for the correct option specifications.
| statement is not valid for the specified utility. The list
| either contains no objects or contains objects which
| DSNU1007I csect-name - DATE/TIME VALUES MAY
| cannot be processed by this specific utility.
| CHANGE BEFORE EXECUTION
| Severity: 8 (error)
| Explanation: PREVIEW processing has detected DSN
| System Action: Utility processing is not initiated. | date/time variables on a TEMPLATE control statement
| being used. These values may change before the actual
| User Response: Correct the LISTDEF in error, and | utility execution, resulting in different data set names.
| resubmit the utility job. Refer to DB2 Utility Guide and
| Reference for the correct option specifications. | Severity: 4 (warning)
| System Action: Preview processing continues
| DSNU1004I csect-name - DUPLICATE object-type | normally.
| object-name FOUND IN SYSIN dd-name
| Explanation: Duplicate LISTDEF or TEMPLATE | DSNU1008I csect-name - LISTDEF name CONTAINS
| statements (duplicate names) were detected in the | NO OBJECTS
| SYSIN, listdef, or template dataset.
| Explanation: The indicated LISTDEF list definition
| Severity: 8 (error) | expands to contain no objects.
| System Action: Utility processing is not initiated. | Severity: 8 (error)
| User Response: Eliminate the duplicate LISTDEF or | System Action: Utility processing is not initiated.
| TEMPLATE names and resubmit the utility job. Refer to
| User Response: Correct the LISTDEF definition and
| DB2 Utility Guide and Reference for the correct option
| resubmit the utility job. Refer to DB2 Utility Guide and
| specifications.
| Reference for the correct option specifications.
560 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU1009I • DSNU1016I
| DSNU1009I csect-name - TEMPLATE name DSN= | Guide and Reference for the correct option
| dataset-name
| specifications.
| Explanation: PREVIEW processing has expanded a
| referenced TEMPLATE data set name to the value
| DSNU1014I csect-name - INDEXSPACE name NOT
| shown. If the data set name contains date/time
| FOUND
| variables, the date/time values might change before | Explanation: The specified INDEXSPACE does not
| actual utility execution. | exist.
| Severity: 8 (error) | Severity: 8 (error)
| System Action: PREVIEW processing continues. | System Action: Utility processing is not initiated.
| User Response: If the data set names shown are not | User Response: Correct the operand in error, and
| acceptible, correct the TEMPLATE control statements, | resubmit the utility job. Refer to DB2 Utility Guide and
| and resubmit the utility job. Refer to DB2 Utility Guide | Reference for the correct option specifications.
| and Reference for the correct option specifications.
| DSNU1015I csect-name - ERROR ALLOCATING
| DSNU1010I csect-name - LISTDEF name EXPANDS | DATA SET DSN=name
| TO THE FOLLOWING OBJECTS: | CODE=X'reason-code'
| Explanation: This message is followed by an | Explanation: An error was returned by SVC 99 during
| equivilent LISTDEF control statement with all pattern | TEMPLATE data set dynamic allocation. This message
| matching characters removed and all INCLUDE and | is followed by text which explains the reason-code
| EXCLUDE clauses evaluated. For static applications, | shown.
| this expanded LISTDEF may be saved to a dataset and
| reused to avoid list expansion overhead. | Severity: 8 (error)
| Severity: 0 (informational) | System Action: Utility processing for the current
| object halts. If a list is being processed, utility
| System Action: PREVIEW processing continues. | processing of the next object will proceed or halt based
| User Response: Examine the list, correct the
| on the OPTIONS ITEMERROR control statement. By
| LISTDEF if necessary and and resubmit the utility job.
| default, execution will HALT.
| Refer to DB2 Utility Guide and Reference for the correct | User Response: Correct the error preventing dynamic
| option specifications. | allocation, and resubmit the utility job. In some cases,
| TEMPLATE dynamic allocation may not be possible and
| DSNU1012I csect-name - LISTDEF MUST BEGIN | a JCL DD card may be required. See DYNALLOC (SVC
| WITH AN INCLUDE CLAUSE
| 99) text unit documentation for limitations.
| Explanation: A LISTDEF control statement begins
| with an EXCLUDE clause. The LISTDEF control | DSNU1016I csect-name - TEMPLATE DSN
| statement must begin with an INCLUDE clause. | VARIABLE var-name HAS NO VALUE
| Severity: 8 (error) | Explanation: A utility has attempted to build a data set
| name based on a TEMPLATE that specifies DSN
| System Action: Utility processing is not initiated. | variables. The variable shown has no value in this
| particular use. For example, PART when the object is
| User Response: Correct the LISTDEF in error, and
| not partitioned or ICTYPE when an image copy is not
| resubmit the utility job. Refer to DB2 Utility Guide and
| being allocated.
| Reference for the correct option specifications.
| Severity: 8 (error)
| DSNU1013I csect-name - dd-type DD CARD dd-name | System Action: Utility processing for the current
| NOT FOUND | object halts. If a list is being processed, utility
| processing of the next object will proceed or halt based
| Explanation: An OPTIONS control statement specifies
| on the OPTIONS ITEMERROR control statement. By
| a DD name 'dd-name' that does not exist in the JCL.
| default, execution will HALT.
| Severity: 8 (error)
| User Response: Correct the TEMPLATE DSN
| System Action: Utility processing is not initiated. | specification to eliminate the invalid variable or use a
| different TEMPLATE, and resubmit the utility job. Refer
| User Response: Correct the DD name on the | to DB2 Utility Guide and Reference for the correct
| OPTIONS statement or include the missing JCL DD | option specifications.
| card, and resubmit the utility job. Refer to DB2 Utility
Chapter 18. DB2 Messages 561
DSNU1017I • DSNU1025I
| DSNU1017I csect-name - TEMPLATE DSN | message DSNU1023I to show the final expanded list..
| VARIABLE var-name TRUNCATED TO | Severity: 0 (informational)
| value
| System Action: PREVIEW processing continues.
| Explanation: While performing dynamic allocation of a
| TEMPLATE data set the DSN variable shown was
| truncated to the value shown. | DSNU1022I csect-name - CLAUSE IDENTIFIES n
| OBJECTS
| Severity: 4 (warning)
| Explanation: PREVIEW processing has expanded
| System Action: Utility processing continues. | one INCLUDE or EXCLUDE clause of a LISTDEF
| control statement. The clause expanded to the indicated
| DSNU1018I csect-name - USER user-id NOT | n number of objects. The sum of the values shown on
| AUTHORIZED TO ACCESS CATALOG
| the DSNU1022I messages may not match the quantity
| TABLE qualifier. name
| shown on DSNU1023I due to INCLUDEs, EXCLUDEs
| and list overlap.
| Explanation: The user executing the utility does not
| have the required authority to access the catalog table
| Severity: 0 (informational)
| shown. This access is required to expand the LISTDEF | System Action: PREVIEW processing continues.
| control statement being used.
| Severity: 8 (error) | DSNU1023I csect-name - LISTDEF name CONTAINS
| System Action: Utility processing is not initiated. | n OBJECTS
| User Response: GRANT the required authority to
| Explanation: PREVIEW processing has finished
| access the DB2 catalog to the user executing the utility.
| expanding a LISTDEF. The final list contains the
| Refer to the LISTDEF section of DB2 Utility Guide and
| indicated number of objects. The value shown may not
| Reference for valid authorities.
| match the sum of previous DSNU1022I quantities due
| to INCLUDEs, EXCLUDEs and list overlap.
| DSNU1019I csect-name - INVALID TEMPLATE | Severity: 0 (informational)
| NAME template-name | System Action: PREVIEW processing continues.
| Explanation: A TEMPLATE control statement specifies
| an invalid TEMPLATE name. The names UTPRINT, | DSNU1024I csect-name - OPTIONS EVENT
| SORTLIB and any name starting with SORTWK or SYS | WARNING HAS SET RETURN CODE TO
| may not be used. | return-code
| Severity: 8 (error) | Explanation: Utility processing has ended with
| System Action: Utility processing terminates. | WARNING messages and a return code of 4. However,
| due to a previous OPTIONS EVENT WARNING control
| User Response: Correct the TEMPLATE name in | statement, the return code has been changed to the
| error, and resubmit the utility job. Refer to DB2 Utility | indicated return code.
| Guide and Reference for the correct option
| specifications.
| Severity: 0 (informational) or 8 (warning)
| System Action: Utility processing halts if WARNING
| DSNU1020I csect-name - EXPANDING LISTDEF | RC8 was specified, or continues if WARNING RC0 was
| list-name
| specified.
| Explanation: PREVIEW processing is performing the | User Response: Use OPTIONS WARNING RC0 only
| catalog lookup necessary to expand the specified | on repetitive utility executions where WARNING
| LISTDEF. | messages are expected and acceptable.
| Severity: 0 (informational)
| DSNU1025I csect-name - name IS A DD NAME
| System Action: PREVIEW processing continues.
| Explanation: PREVIEW processing has checked the
| current utility control statement for TEMPLATE dynamic
| DSNU1021I csect-name - PROCESSING clause-type | allocation and has found the specified name refers to a
| CLAUSE object-type qualifier.name | JCL DD card, not a template. In all cases the presence
| of a DD card takes precedent over any TEMPLATE of
| Explanation: PREVIEW processing is expanding the
| the same name.
| specified clause of a LISTDEF. A DSNU1022I message
| follows this message to indicate how many objects are | Severity: 0 (informational)
| identified by each INCLUDE or EXCLUDE clause and
| System Action: PREVIEW processing continues.
562 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU1026I • DSNU1031I
| User Response: If a TEMPLATE and DD card have | determine the data set type. Either remove the tape
| the same name, the DD card always takes precedence. | keyword from the TEMPLATE control statement, or
| If the indicated name should not reference a DD card, | correct the UNIT operand to refer to a tape unit. Refer
| perform one of the following actions: | to DB2 Utility Guide and Reference for the correct
| v Remove the DD card | option specifications.
| v Change the TEMPLATE name on the TEMPLATE
| control statement and the utility control statement that | DSNU1029I csect-name - INVALID KEYWORD
| refers to it | kkkkkkkk FOR TAPE TEMPLATE
| If the reference to the DD card is correct, no action is | Explanation: A tape TEMPLATE control statement
| necessary. Refer to DB2 Utility Guide and Reference for | cannot include the DASD TEMPLATE keyword
| the correct option specifications. | kkkkkkkk.
| Severity: 8 (error)
| DSNU1026I csect-name - LIST using-list REUSES
| LIST used-list
| System Action: Utility processing does not initiate.
| Explanation: A LISTDEF list is INCLUDING or
| User Response: DB2 uses the UNIT operand to
| EXCLUDING another list that has already been used in
| determine the data set type. Either remove the DASD
| expansion of this clause. This ″circular reference″ is not
| keyword from the TEMPLATE control statement, or
| allowed. For example, the following specification is not
| correct the UNIT operand to refer to a DASD unit. Refer
| allowed: LISTDEF A INCLUDE LIST B LISTDEF B
| to DB2 Utility Guide and Reference for the correct
| INCLUDE LIST A
| option specifications.
| Severity: 8 (error)
| DSNU1030I csect-name - QUALIFIER qqqqqqqq TOO
| System Action: Utility processing does not initiate. | LONG
| User Response: Correct one or more LISTDEF | Explanation: The TEMPLATE DSN qualifier
| control statements to eliminate the circular reference | 'qqqqqqqq' is greater than eight characters.
| and resubmit the utility job. Refer to DB2 Utility Guide
| and Reference for the correct option specifications.
| Severity: 8 (error)
| System Action: Utility processing for the current
| DSNU1027I csect-name - PROCESSING | object halts. If a list is being processed, utility
| CONTINUES DUE TO OPTIONS
| processing of the next object will proceed or halt based
| ITEMERROR SKIP
| on the OPTIONS ITEMERROR control statement. By
| default execution will HALT.
| Explanation: An error has occurred during utility
| processing, indicated by previous error messages.
| User Response: Correct the TEMPLATE DSN
| However, because an OPTIONS ITEMERROR SKIP
| expression and resubmit the utility job. Refer to DB2
| control statement is in force, processing continues.
| Utility Guide and Reference for the correct option
| specifications.
| Severity: 8 (error)
| System Action: Utility processing continues on the | DSNU1031I csect-name - DSN name TOO LONG
| current utility control statement only. Subsequent utility
| control statements in the same job step will not be
| Explanation: The TEMPLATE DSN operand results in
| processed.
| a data set name 'name' that is too long for the type of
| data set being allocated.
| User Response: Correct the previous error, and
| resubmit the utility for the objects in error. If the utility
| Severity: 8 (error)
| experiencing an error is QUIESCE and a single quiesce | System Action: Utility processing for the current
| point is required for the entire list, the entire list must be | object halts. If a list is being processed, utility
| resubmitted. | processing of the next object will proceed or halt based
| on the OPTIONS ITEMERROR control statement. By
| DSNU1028I csect-name - INVALID KEYWORD | default execution will HALT.
| kkkkkkkk FOR DASD TEMPLATE | User Response: Correct the TEMPLATE DSN
| Explanation: A DASD TEMPLATE control statment | operand in error, and resubmit the utility job. Refer to
| cannot include the tape TEMPLATE keyword kkkkkkkk. | DB2 Utility Guide and Reference for the correct option
| specifications.
| Severity: 8 (error)
| System Action: Utility processing does not initiate.
| User Response: DB2 uses the UNIT operand to
Chapter 18. DB2 Messages 563
DSNU1032I • DSNU1037I
| DSNU1032I csect-name - INVALID QUALIFIER | DSNU1035I csect-name - statement-type
| qualifier IN TEMPLATE name | STATEMENT PROCESSED
| SUCCESSFULLY
| Explanation: The TEMPLATE DSN qualifier either
| contains invalid characters or does not start with an | Explanation: DB2 issues this message following the
| alpha character. | successful execution of an OPTIONS, LISTDEF, or
| TEMPLATE utility control statement.
| Severity: 8 (error)
| Severity: 0 (informational)
| System Action: Utility processing for the current
| object halts. If a list is being processed, utility | System Action: DB2 processed and retained the
| processing of the next object will proceed or halt based | options or definitions specified on the control statement
| on the OPTIONS ITEMERROR control statement. By | for use on subsequent utility control statements.
| default, execution will HALT.
| User Response: Correct the TEMPLATE DSN | DSNU1036I csect-name - UNABLE TO ESTIMATE
| operand in error, and resubmit the utility job. A common | SPACE REQUIREMENTS FOR
| cause of this error message is leaving the trailing period | dataset-use
| off of a TEMPLATE DSN variable name. All TEMPLATE
| DSN variable names are of the form &xyz. and must
| Explanation: While processing a TEMPLATE control
| contain the trailing period. Refer to DB2 Utility Guide
| statement that does not include a SPACE keyword, DB2
| and Reference for the correct option specifications.
| could not calculate the default data set size. DB2 bases
| default calculations on the size of existing data sets. In
| this situation, DB2 could not determine the size of
| DSNU1033I csect-name - PROCESSING LIST ITEM: | existing data sets because one or more of those
| object-type qualifier.name | existing data sets are:
| Explanation: While processing a LISTDEF list, utility | v in-stream data sets,
| processing has begun on the indicated object. | v members of partitioned data sets,
| Severity: 0 (informational) | v on tape,
# v or results sets generated by DECLARE CURSOR
| System Action: Utility processing continues.
# executed with an EXEC SQL utility statement.
| Severity: 8 (error)
| DSNU1034I csect-name - primary-secondary SPACE
| units quantity TOO LARGE FOR DATA | System Action: DB2 halts utility processing for the
| SET name | current object. If the utility is processing a list of objects,
| utility processing of the next object will proceed or halt
| Explanation: The TEMPLATE PRIMARY or
| based on the OPTIONS ITEMERROR control
| SECONDARY SPACE quantity indicated is too large. It
| statement. By default, processing will HALT.
| is not possible to dynamically allocate a data set larger
| than 16 777 215 units. | User Response: Add the SPACE keyword and its
| operands to the TEMPLATE control statement in error
| Severity: 8 (error)
| and rerun the utility. If the utility is the LOAD utility, you
| System Action: Utility processing for the current | must add SPACE keywords for all TEMPLATE control
| object halts. If a list is being processed, utility | statements referenced in the LOAD, except for the input
| processing of the next object will proceed or halt based | data set.
| on the OPTIONS ITEMERROR control statement. By
| default, execution will HALT.
| DSNU1037I csect-name - PREVIEW PROCESSING
| User Response: The DB2-calculated required space | CONTINUES DUE TO JCL PARAMETER
| is too large to be dynamically allocated in the units
| Explanation: An OPTIONS utility control statement
| shown. If the primary allocation is too large, use the
| has attempted to turn off PREVIEW processing.
| PCTPRIME keyword to reduce the primary and increase
| PREVIEW processing continues because the PREVIEW
| the secondary. If the secondary allocation is too large,
| JCL parameter has been specified. This parameter
| use the NBRSECND keyword to increase the number of
| applies to the entire job step and can not be overridden
| secondary allocations. It is not possible to use
| by an OPTIONS control statement.
| TEMPLATE dynamic allocation for data sets larger than
| 16×(16 777 215) MB. If an object requires a data set of | Severity: 0 (informational)
| this size it must be processed individually using a DD
| card, not a template.
| System Action: Utility processing continues in
| PREVIEW mode.
| User Response: If PREVIEW processing must be
| turned off in the middle of a utility job step, remove the
564 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU1038I • DSNU1103I
| PREVIEW JCL parameter. Activate or deactivate Otherwise, correct the input field specification. Submit a
| PREVIEW processing by using the OPTIONS utility RESUME(YES) LOAD invocation, which uses the
| control statement, not the PREVIEW JCL parameter. DISCARDS data set and the verified LOAD utility
statement and field specifications. Refer to DB2 Utility
Guide and Reference for a definition of LOAD input field
| DSNU1038I csect-name - DATASET ALLOCATED. column specifications.
| TEMPLATE=template-name
| DDNAME=dd-name DSN=ds-name
| DSNU1102I csect-name RECORD 'n' FOR
| Explanation: The indicated data set has been
| PARTITION m WILL BE DISCARDED
| successfully allocated based on a TEMPLATE control
| DUE TO ERROR = X'reason-code'
| statement.
| FROM EXIT ROUTINE procedure-name
| Severity: 0 (informational) | FOR table-name
| System Action: Utility processing continues. | Explanation: The exit routine provided by your
| installation blocked the load of record 'n' for partition m
| into the table indicated. The reason-code was set by the
| DSNU1100I csect-name RECORD 'n' FOR | exit routine.
| PARTITION m WILL BE DISCARDED
| DUE TO field-name CONVERSION | Severity: 4 (warning)
| ERROR FOR table-name
| System Action: The input data set record number is
| Explanation: The load utility found the input data | noted and will be discarded in the DISCARD phase.
| provided for a field to be incorrect. The corresponding | The record in error is placed in the DISCARDS data set.
| input data set record 'n' from the input data set specified | The LOAD utility continues to process additional records
| for partition m will be placed in the DISCARDS data set. | in the input data set.
| Severity: 4 (warning) | User Response: Following the completion of the
| current LOAD utility invocation, examine the record in
| System Action: The input data set record is noted | the DISCARDS data set for partition m. Correct the
| and will be discarded in the DISCARD phase. The | error in the discarded input data, if one exists. Ensure
| LOAD utility continues to process additional records in | that the exit routine provided is correct. Submit a
| the input data set. | RESUME(YES) LOAD invocation, which uses the
| User Response: Following the completion of the | DISCARDS data set and the verified LOAD utility
| current LOAD utility invocation, examine the record in | statement and field specifications. Refer to DB2 Utility
| the DISCARDS data set for partition m. Correct the | Guide and Reference for a definition of LOAD input field
| error in the discarded input data. Submit a | column specifications.
| RESUME(YES) LOAD invocation with the DISCARDS | System Programmer Response: Verify that the
| data set as the input data set. Refer to DB2 Utility | validation routine is correct.
| Guide and Reference for a definition of LOAD input field
| column specifications.
| DSNU1103I csect-name RECORD 'n' FOR
| PARTITION m WILL BE DISCARDED
DSNU1101I csect-name RECORD 'n' FOR | DUE TO PART OR HIGH KEY
PARTITION m WILL BE DISCARDED | VALUESPECIFICATION(S)
DUE TO INVALID field-name COLUMN
SPECIFICATION | Explanation: The discarded record does not belong to
| the partition m being loaded. For a LARGE table space,
Explanation: The load utility calculated the location of | this might be because the key is higher than the high
an input data value using the field specifications | key value specified for the last partition.
supplied and VARCHAR length fields present within the
input data set record. The calculated position for the | Severity: 4 (warning)
field was determined to be incorrect.
| System Action: The input data set record number is
Severity: 4 (warning) | noted and will be discarded in the DISCARD phase.
| The LOAD utility continues to process additional records
System Action: The input data set record number is | in the input data set.
noted and will be discarded in the DISCARD phase.
The LOAD utility continues to process additional records | User Response: Following the completion of the
in the input data set. | current LOAD utility invocation, examine the record in
| the DISCARDS data set for partition m. Correct the
User Response: Following the completion of the | error in the discarded input data, if one exists. Submit a
current LOAD utility invocation, examine the record in | RESUME(YES) LOAD invocation with the DISCARDS
the DISCARDS data set for partition m. Correct the | data set as the input data set. Refer to Part 2 of DB2
error in the discarded input data, if one exists. | Utility Guide and Reference for a definition of LOAD
Chapter 18. DB2 Messages 565
DSNU1104I • DSNU1107I
| input field column specifications. | resources if that is necessary.
| System Programmer Response: Verify that the | System Programmer Response: Refer to DB2
| validation routine is correct. | Command Reference for information about the TERM
| UTIL command. If you suspect an error in DB2, refer to
| Part 2 of DB2 Diagnosis Guide and Reference for
| DSNU1104I csect-name RECORD 'n' FOR
| information on identifying and reporting the problem.
| PARTITION m WILL BE DISCARDED
| DUE TO WHEN SPECIFICATION(S)
| DSNU1106I csect-name RECORD 'n' FOR
| Explanation: The discarded record does not satisfy
| PARTITION m WILL BE DISCARDED
| the WHEN selection expression provided for partition m.
| DUE TO INVALID field-name COLUMN
| Severity: 4 (warning) | SPECIFICATION FOR table-name
| System Action: The input data set record is noted | Explanation: The load utility calculated the location of
| and will be discarded in the DISCARD phase. The | an input data value using the field specifications
| LOAD utility continues to process additional records in | supplied and VARCHAR length fields present within the
| the input data set. | input data set record 'n' for partition m. The calculated
| position for the field was determined to be incorrect.
| User Response: Following the completion of the
| current LOAD utility invocation, examine the record in | Severity: 4 (warning)
| the DISCARDS data set for partition m. Correct the
| System Action: The input data set record number is
| error in the discarded input data, if one exists. Submit a
| noted and will be discarded in the DISCARD phase.
| RESUME(YES) LOAD invocation with the DISCARDS
| The LOAD utility continues to process additional records
| data set as the input data set. Refer to DB2 Utility
| in the input data set.
| Guide and Reference for a definition of LOAD input field
| column specifications. If FORMAT UNLOAD was | User Response: Following the completion of the
| specified on the load statement, the WHEN | current LOAD utility invocation, examine the record in
| specifications are built internally. This ensures that the | the DISCARDS data set for partition m. Correct the
| rows are loaded back into the same object from which | error in the discarded input data, if one exists.
| they were unloaded. Refer to DB2 Utility Guide and | Otherwise, correct the input field specification. Submit a
| Reference for a description of the FORMAT UNLOAD | RESUME(YES) LOAD invocation, which uses the
| option of LOAD. | DISCARDS data set and the verified LOAD utility
| statement and field specifications. Refer to DB2 Utility
| Guide and Reference for a definition of LOAD input field
| DSNU1105I csect-name RECORD 'n' FOR
| column specifications.
| PARTITION m WILL BE DISCARDED
| DUE TO UNEXPECTED ERROR
| DSNU1107I csect-name - UNIQUE INDEX KEY
| Explanation: The LOAD of input data set record
| DUPLICATES KEY OF INDEXED ROW
| number 'n' for partition m was attempted but was not
| AT RID rrrr INDEX = index-name TABLE
| successful due to an unexpected error.
| = table-name RECNO =
| Severity: 8 (error) | input-dataset-record-number FOR PART
| = m RID = duprid
| System Action: If the error was caused because a
| resource was not available, a DSNT500I message will | Explanation: The input data set record indicated was
| be issued. | loaded into table 'table-name', partition m, at RID
| 'duprid', but it causes a unique index violation for index
| The utility step will be abended with a system X'04E' | 'index-name'. It duplicates the key value of a record
| and an abend reason code of '00E40318'. If a | already in the table at RID 'rrrr'.
| DSNT500I message is not issued, an SVC dump will be
| requested. A SYSABEND dump of batch storage is also | Severity: 4 (warning)
| requested.
| System Action: Processing continues. No index entry
| User Response: If a DSNT500I message was issued, | is created for the record at RID 'duprid'. The record will
| refer to the description under that message number. If | be deleted in a subsequent phase of processing.
| the unavailable resource becomes available, the utility
| step is restartable.
| If there is no DSNT500I message, the error is an
| unexpected internal error and you should consult your
| system programmer.
| Operator Response: An operator with SYSOPR
| authority can issue a TERM UTIL to free any held
566 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU1108I • DSNU1113I
|
| DSNU1108I csect-name UNIQUE INDEX KEY | DSNU1111I csect-name FOREIGN KEY HAS NO
| DUPLICATES KEY FROM INPUT | PRIMARY KEY FOR RELATIONSHIP=r1
| DATASET RECORD iiii FOR PART m | INPUT RECORD NUMBER=nnnn, PART
| LOADED AT RID rrrr INDEX = | m, RID=X'rrrr'
| index-name TABLE = table-name
| | Explanation: Input record 'nnnn' for partition m caused
RECNO = recno RID = duprid
| a row to be loaded into table 'table' at RID 'rrrr' with no
| Explanation: Input data set record 'recno' was loaded | primary key for the relationship with the name 'r1'.
| into table 'table-name', partition m, at RID 'duprid', but it
| | Severity: 4 (warning)
causes a unique index violation for index 'index-name'.
| It duplicates the key value of another record in the load | System Action: Processing continues.
| job: the record loaded at RID 'rrrr' from input data set
| record 'iiii'. | User Response: None required. The constraint
| violation described will be rectified later in processing.
| Severity: 4 (warning)
| System Action: Processing continues. Index entries | DSNU1112I csect-name DISCARD PHASE
| are not created for either record. Both records will be | STATISTICS - nnn INPUT DATA SET
| deleted in a subsequent phase of processing. | RECORDS DISCARDED FOR
| PARTITION m
| DSNU1109I csect-name RECORD 'n' FOR | Explanation: Input data set records were rejected by
| PARTITION m WILL BE DISCARDED | the LOAD utility for one or several reasons. The
| DUE TO CHECK CONSTRAINT | rejected records have been placed in a discards data
| constraint-name VIOLATION ON TABLE | set. The number of records rejected for partition m is
| table-name | 'nnn'. Message DSNU399I summarizes the errors
| | causing the records to be rejected.
Explanation: The discarded record violates the check
| constraint named constraint-name defined on table | Severity: 4 (warning)
| table-name. The record is not loaded and is discarded
| during the DISCARD phase. | System Action: Processing continues.
| Severity: 4 (warning) | User Response: Examine the LOAD error summary
| and decide which of the discarded records, if any,
| System Action: The LOAD utility continues to process | should be corrected and reapplied to the table space.
| additional records in the input data set.
| User Response: After the LOAD utility completes, DSNU1113I csect-name - LOAD UTILITY ERROR
| examine the record in the DISCARDS data set for SUMMARY REPORT
| partition m. Correct the error in the discarded input data.
| Submit a RESUME(YES) LOAD job with the DISCARDS Explanation: This message summarizes errors
| data set as the input data set. detected during the load job. Figure 2 shows the format
of the report. It is issued only if unique index or
referential constraint violations were detected.
| DSNU1110I csect-name RECORD 'n' FOR The report contains one line for each error. The errors
| PARTITION m VIOLATES CHECK ERROR INPUT PART Discard ERROR TABLE FIELD/FANSET
| CONSTRAINT constraint-name ON SEVERITY RECORD Heading TYPE NAME NAME E
|| TABLE table-name sev idsrn pno ddsrn type name1 name2
|| Explanation: The LOAD utility cannot load record n . . . . . . .
| . . . . . . .
| into table table-name partition m because the check
| constraint constraint-name would be violated. The
|| record is not loaded.
| Figure 2. LOAD Utility Error Summary Report
|| Severity: 8 (error)
are listed first by error severity and within that by idsrn.
| System Action: Processing terminates. An abend is
| requested so that the LOAD can be restarted after the The Discard Heading is either DISCARD RECORD or
| error condition is corrected. blank, depending on whether discard processing is in
| User Response: Find the failing record in the input effect.
| data set for partition m, correct the condition that
| caused the check constraint to be violated, and restart The report fields have the following meanings:
| the LOAD utility.
sev The severity of the error reported on this line:
Chapter 18. DB2 Messages 567
DSNU1114I • DSNU1121I
Severity
Type of Explanation key is duplicated. For secondary referential
Error integrity errors, it gives the input data set
record number of the record whose primary
1 Primary Primary referential integrity errors and referential integrity error cascaded to cause
all nonreferential integrity errors. this secondary error. For other types of errors,
2 SecondarySecondary referential integrity errors this field is unused.
(that is, errors that result from a Severity: 4 (warning)
primary referential integrity error in an
ancestor). System Action: Processing continues.
idsrn The relative record number in the input data | DSNU1114I csect-name (RE)LOAD PHASE
set, for the partition identified by pno, of the | STATISTICS NUMBER OF RECORDS
record causing the error reported on this line. | LOADED = nnnn FOR TABLE
| table-name
pno The partition number for the input data set of
the record causing the error reported on this | Explanation: When the SHRLEVEL CHANGE option
line. | is selected, DB2 issues this message upon normal
| completion of the (RE)LOAD phase of the LOAD utility.
ddsrn The relative record number in the input data | It indicates the number of records loaded into TABLE
set of the record causing the error reported on | table-name from the scource record data set (that is,
this line, if discard processing is in effect. | the data set identified by the JCL DD statement
Otherwise, ddsrn is blank. | identified in the INDDN option for the LOAD. This
type A description of the type of error reported on | message is repeated for each TABLE loaded by the
this line, as follows: | current LOAD utility statement
Conversion | Severity: 0 (informational)
Field specification
Validation | System Action: Processing of the RELOAD phase
Part Specification | continues.
Unexpected
| User Response: Verify that the number of record
Column specification
| loaded reported is consistent with expectations. For
Referential integrity
| example, if four records are processed, the user should
Check constraint
| expect to see NUMBER OF RECORD LOADED = 4.
Duplicate key.
name1 The name of the table for which the record
| DSNU1120I AUX TABLE NOT DEFINED FOR LOB
causing the error was targeted, if this
| TABLE SPACE dbname.tsname
information is pertinent for the type of error
reported on this line. Otherwise, name1 is | Explanation: The LOB table space dbname.tsname
blank. This field has nonblank values for the | has been created, but no auxiliary table has been
following error types: | created in it.
Conversion
Validation
| Severity: 8 (error)
Column specification | System Action: Utility operation is terminated with
Referential integrity (primary). | return code 8.
Check constraint
| User Response: Complete the definition of the LOB
name2 The name of the field or fanset involved in the | table space before resubmitting the utility.
error reported on this line, if this information is
pertinent for the type of error reported.
Otherwise, name2 is blank. This field contains | DSNU1121I csect-name (RE)LOAD PHASE
a field name for the following types of errors: | STATISTICS - NUMBER OF RECORDS
Conversion | LOADED = nnnn FOR TABLE
Field specification | table-name PART m
Column specification. | Explanation: When the SHRLEVEL CHANGE option
| is selected, DB2 issues this message upon normal
For primary referential integrity errors, name2 | completion of the (RE)LOAD phase of the LOAD utility.
is a relationship name. For check constraint | It indicates the number of records that were loaded into
errors, name2 is a check constraint name. | part m of table table-name from the source record data
idsrn2 The input data set record number of a related
| set. The message repeats for each INTO TABLE PART
error. For duplicate key errors, it gives the input
| clause in the LOAD utility statement.
data set record number of the record whose | Severity: 0 (informational)
568 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU1122I • DSNU1202I
| System Action: Processing continues.
| DSNU1125I csect-name FOREIGN KEY HAS NO
| User Response: Verify that the number of records | PRIMARY KEY FOR RELATIONSHIP=r1
| loaded reported is consistent with expectations. | INPUT RECORD NUMBER=nnnn,FOR
| PART m
| DSNU1122I JOB job-name PERFORMING util-type | Explanation: Input record nnnn for partition m for
| WITH UTILID util-id UNABLE TO DRAIN | table table has no primary key for the relationship with
| object-name. RETRY n OF m WILL BE | the name r1. The row is not loaded.
| ATTEMPTED IN s SECONDS
| Severity: 4 (warning)
| Explanation: A utility with the RETRY option specified
| System Action: Processing continues.
| has been unable to drain a tablespace, tablespace part,
| or index. The utility will make another attempt to acquire | User Response: None required.
| the drain after a delay.
| Severity: 0 (informational) | DSNU1126I csect-name PARTITION n IS SPECIFIED
| IN MORE THAN ONE INTO TABLE
| System Action: The utility job continues.
| PART CLAUSE, PARTITION
| User Response: The utility job attempts to acquire a | PARALLELISM IS DISALLOWED
| restrictive access to the referenced object, and will retry
| Explanation: LOAD partition parallelism was
| if unsuccessful. Optionally, the user may determine who
| requested via INDDN or INCURSOR following INTO
| has claims on the object via the -DIS DATABASE
| TABLE PART clauses. However, the same partition was
| command with CLAIMERS option, and cancel or end
| specified on more than one INTO TABLE PART clause.
| those threads.DSNU1123I
| Partition parallelism is not supported for this case.
LOGICAL PARTITIONS WILL BE
| Severity: 8 (error)
LOADED IN PARALLEL, NUMBER OF
TASKS = nnnn | System Action: Utility operation is terminated with
| return code 8.
Explanation: This message is issued by the BUILD2
phase of the REORG utility. The message indicates that | User Response: Correct the LOAD statement to either
the REORG utility is able to update logical partitions in | specify a different partition number on each INTO
parallel. The number of utility tasks used to update | TABLE PART clause, or remove the parallelism by
logical partitions is indicated by :mv.nnnn:emv.. .*:p.This | removing the INDDN or INCURSOR keywords from the
message is issued by the following CSECT(s): | INTO TABLE PART clauses.
.*DSNURBD2
Severity: 0 | DSNU1201I csect-name - PARTITIONS WILL BE
| UNLOADED IN PARALLEL, NUMBER
System Action: Processing of the BUILD2 phase
| OF TASKS = nnnn
continues.
| Explanation: The message indicates that the
Programmer Response: You can verify that the
| UNLOAD utility is able to unload partitions in parallel.
number of tasks reported is consistent with
| The number of utility tasks used to unload partitions is
expectations. For example, if 4 logical partitions are to
| indicated by nnnn.
be updated, the user might expect to see number of
tasks = 4. | Severity: 0 (informational)
| System Action: Processing of the UNLOAD phase will
| DSNU1124I csect-name - UNIQUE INDEX KEY | continue.
| DUPLICATES KEY OF INDEXED
| RECORD AT RID rrrr INDEX =
| index-name TABLE = table-name
| DSNU1202I csect-name - SAMPLING LIMIT HAS
| RECNO = input-dataset-record-number
| BEEN REACHED FOR TABLE
| FOR PART = m
| table-name
| Explanation: The input data set record indicated for
| Explanation: In the UNLOAD statement, the LIMIT
| PART m of table table-name causes a unique index
| option is specified for table table-name and the number
| violation for index index-name. It duplicates the key
| of unloaded rows from the table has reached the
| value of a record already in the table at RID rrrr. The
| specified LIMIT value.
| record was not loaded. | Severity: 0 (informational)
| Severity: 4 (warning) | System Action: No more rows will be unloaded from
| System Action: Processing continues. | the table, but the unloading operation will continue for
| the previously unloaded tables if they exist.
Chapter 18. DB2 Messages 569
DSNU1203I • DSNU1218I
| DSNU1203I csect-name - GENERATION OF LOAD | DSNU1214I csect-name - INVALID FIELD POSITION
| STATEMENT IS BYPASSED FOR | SPECIFICATION FOR FIELD field-name,
| TABLE table-name | TABLE table-name
| Explanation: The PUNCHDDN specification is omitted | Explanation: For a UNLOAD statement, specified field
| in a UNLOAD statement when partition parallelism is | positions are not in ascending order in the field
| activated. The LOAD statement will not be generated for | specification list of the indicated table.
| the indicated table.
| Severity: 8 (error)
| Severity: 0 (informational)
| System Action: The utility job terminates.
| System Action: The UNLOAD job will continue.
| User Response: Specify the field positions in the
| ascending order in the field specification list. If a certain
| DSNU1211I csect-name - INPUT DATA SET IS NOT | order of the output fields is desired, change the order of
| AN IMAGE COPY | the field in the list so that the field positions are in the
| ascending order.
| Explanation: The input data set specified by the
| FROMCOPY or FROMCOPYDDN option of the
| UNLOAD utility was not identified as an image copy | DSNU1217I csect-name - CONFLICTING FIELD
| data set. | POSITION AND/OR LENGTH
| SPECIFICATION FOR FIELD field-name,
| Severity: 8 (error)
| TABLE table-name
| System Action: The utility job terminates.
| Explanation: For a UNLOAD statement, the specified
| User Response: Specify the correct image copy data | field position for the indicated field caused a conflict with
| set name to the FROMCOPY option, or to the DD-name | the previous field. This is caused either by
| that is referred to by the FROMCOPYDDN option. | v The position value specified for the field is too small.
| v The length specification for the previous field is too
| DSNU1212I csect-name - INVALID FIELD NAME | large.
| field-name FOR TABLE table-name
| Severity: 8 (error)
| Explanation: The specified field name in the field
| System Action: The utility job terminates.
| specification list of the UNLOAD utility is:
| v Not a column name of the specified table, or | User Response: Specify the correct position or length
| parameters in the field specification list so that there are
| v An existing column name for the CONSTANT option.
| enough space for the output fields.
| The field name is not valid.
| Severity: 8 (error) | DSNU1218I csect-name - LOGICAL RECORD
| LENGTH OF OUTPUT RECORD
| System Action: The utility job terminates. | EXCEEDED THE LIMIT FOR TABLE
| User Response: For a CONSTANT field, specify a | table-name
| non-existing field name. Otherwise, specify the field | Explanation: The maximum length of the output
| name as a column name of the indicated table. | records exceeded the physical limit for the UNLOAD
| utility.
| DSNU1213I csect-name - INVALID FIELD TYPE FOR | Severity: 8 (error)
| FIELD field-name FOR TABLE
| table-name | System Action: The utility job terminates.
| Explanation: The specified field type in the field | Problem Determination: This problem will most likely
| specification list of the UNLOAD utility is incompatible | occur when BLOB, CLOB, or DBCLOB columns are
| with the base type of the corresponding column of the | selected from a table to be unloaded.
| table.
| User Response: Consider one or more of the
| Severity: 8 (error) | following options that can reduce the length of the
| output record, if possible:
| System Action: The utility job terminates.
| v Use the NOPAD option.
| User Response: Specify only a compatible type | v Unload only the necessary fields using the field
| allowed for the unload operation in the field specification | specification options.
| list.
| v Specify the LENGTH option with TRUNCATE and/or
| STRIP options for the applicable fields.
570 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU1219I • DSNU1223I
| If the above options can not be applied, you will have to | consist of multiple table spaces.
| use an application to unload the data from the table.
| Severity: 8 (error)
| DSNU1219I csect-name - THE NUMBER OF | System Action: The utility job terminates.
| RECORDS IN ERROR REACHED THE | Problem Determination: When the source objects of
| LIMIT nnnn | the UNLOAD utility consist of multiple table spaces, an
| Explanation: For the UNLOAD utility, the number of | output data set corresponding to each table space is
| records in error reached the specified MAXERR limit. | required.
| Severity: 8 (error) | User Response: Include an appropriate TEMPLATE
| statement in the unload job step that contains the table
| System Action: The utility job terminates. | space name as a variable. If the table space is selected
| from different databases, the database name must also
| Problem Determination: This problem will occur when
| be included as a variable. Specify the template name to
| the number of errors in the output record formatting,
| the UNLDDN option.
| including data conversion errors, detected by the
| UNLOAD utility reached the limit specified by the
| MAXERR option. For each record in error, the | DSNU1222I csect-name - TEMPLATE template-name
| corresponding message has been issued. The records | SPECIFIED FOR PUNCHDDN IS
| in error will not be unloaded to the output data set. This | INVALID FOR MULTIPLE TABLE
| message is issued only once, even though there can be | SPACES
| a situation in which the number of individual error
| messages exceeds the specified MAXERR value. This
| Explanation: For the UNLOAD utility, the specification
| situation occurs only when the UNLOAD utility is
| of output data set to store the generated LOAD
| running in the partition parallel mode and the multiple
| statement is invalid when the source objects consist of
| tasks have reached the MAXERR value concurrently.
| multiple table spaces.
| User Response: Investigate the individual error
| Severity: 8 (error)
| message and determine the cause of the errors. The | System Action: The utility job terminates.
| corrective action will differ by the type of the error. In
| certain situations, this condition may be anticipated. In | Problem Determination: When the source objects of
| this case, the total number of records unloaded before | the UNLOAD utility consist of multiple table spaces, an
| the job terminates can be adjusted by changing the | output data set corresponding to each table space is
| MAXERR option value. | required.
| User Response: Include an appropriate TEMPLATE
| DSNU1220I csect-name - UNLOADING LOB | statement in the unload job step that contains the table
| COLUMNS FROM IMAGE COPY IS NOT | space name as a variable. If the table space is selected
| SUPPORTED FOR TABLE table-name | from different databases, the database name must also
| be included as a variable. Specify the template name to
| Explanation: For the UNLOAD utility, one or more | the PUNCHDDN option. The TEMPLATE should be
| BLOB, CLOB, and/or DBCLOB columns are selected on | different from the one used for UNLDDN.
| the indicated table when the source object is an image
| copy data set.
| DSNU1223I csect-name - TABLESPACE
| Severity: 8 (error) | SPECIFICATION IS MISSING FOR
| System Action: The utility job terminates. | FROMCOPY OR FROMCOPYDDN
| Problem Determination: When the source object of | Explanation: For the UNLOAD utility, the FROMCOPY
| the UNLOAD utility is an image copy, selection of a | or FROMCOPYDDN option is used but the TEMPLATE
| LOB column is not supported. | specification is missing.
| User Response: Specify a field selection list that does | Severity: 8 (error)
| not include any BLOB, CLOB, or DBCLOB column from | System Action: The utility job terminates.
| the indicated table.
| Problem Determination: When the source objects of
| the UNLOAD utility is an image copy, the TABLESPACE
| DSNU1221I csect-name - UNLDDN IS NOT | option is required to specify the table space name of the
| SPECIFIED OR SPECIFIED TEMPLATE | image copy.
| template-name IS INVALID FOR
| MULTIPLE TABLE SPACES | User Response: Add the TABLESPACE option in the
| UNLOAD statement to specify the table space name of
| Explanation: For the UNLOAD utility, the output data | the image copy.
| set specification is invalid when the source objects
Chapter 18. DB2 Messages 571
DSNU1224I • DSNU1229I
| DSNU1224I csect-name - TABLE table-name IS NOT | DSNU1227I csect-name - THE CONTENT OF THE
| IN THE TABLE SPACE table-space-name | IMAGE COPY DATA SET IS
| INCONSISTENT WITH TABLE SPACE
| Explanation: The indicated table-name given in a
| table-space
| FROM TABLE option is not in the table space specified
| by the TABLESPACE option. | Explanation: For the UNLOAD utility, the data set
| specified by the FROMCOPY or the FROMCOPYDDN
| Severity: 8 (error)
| option is not corresponding to the table space.
| System Action: The utility job terminates.
| Severity: 8 (error)
| Problem Determination: There is an unmatch
| System Action: The utility job terminates.
| between the TABLESPACE and FROM TABLE
| specifications or the specified table was dropped. | User Response: Specify a correct image copy data
| Dropped tables are not supported by the UNLOAD | set name for the table space, or specify the correct
| utility. | table space name for the image copy.
| User Response: Correct either the TABLESPACE or
| the FROM TABLE specification to select a table in the | DSNU1228I csect-name - A ROWID COLUMN
| specified table space. If the table was dropped, remove | column-name, TABLE table-name IS
| the FROM TABLE option for the dropped table. | SELECTED FOR UNLOAD BUT THE
| PAGE SET HEADER PAGE IS MISSING
| IN THE SPECIFIED IMAGE COPY DATA
| DSNU1225I csect-name - TABLESPACE KEYWORD
| SET
| IS NOT SPECIFIED. AT LEAST ONE
| FROM TABLE SPECIFICATION IS | Explanation: For the UNLOAD utility, a ROWID
| REQUIRED. | column is selected for unloading from an image copy,
| but the required information to form the ROWID can not
| Explanation: There is no TABLESPACE nor FROM
| be retrieved because the page set header page is not
| TABLE specification in a UNLOAD statement. The
| included in the specified image copy data set.
| source object for unloading can not be identified.
| Severity: 8 (error)
| Severity: 8 (error)
| System Action: The utility job terminates.
| System Action: The utility job terminates.
| Problem Determination: The problem will most likely
| User Response: If the TABLESPACE specification is
| occur when a piece of copy data set, not the first one, is
| omitted, specify at least one FROM TABLE option to
| specified to the FROMCOPY option.
| identify the source object. Instead of a TABLESPACE
| specification, the LIST option can be used, if a LISTDEF | User Response: Use the FROMCOPYDDN, instead of
| statement defines a list of objects. When the LIST | FROMCOPY, to specify a DD name where the first
| option is used, the FROM TABLE option can not be | piece of copy that contain the page set header page is
| specified. | concatenated to the source image copy data set.
| DSNU1226I csect-name - THE NUMBER OF | DSNU1229I csect-name - ERROR IN LOADING
| OBJECTS IS TOO LARGE | DICTIONARY FOR TABLE SPACE
| table-space
| Explanation: The number of source objects for the
| UNLOAD utility is too large. Overflow in some of the | Explanation: For the UNLOAD utility, an error was
| internal data structures occurred. | detected in loading the dictionary for decompression
| while reading an image copy data set.
| Severity: 8 (error)
| Severity: 8 (error)
| Problem Determination: This problem will most likely
| occur when the LIST option is used and the | System Action: The utility job terminates.
| corresponding LISTDEF definition is expanded to a
| large number of objects.
| Problem Determination: Possibly the image copy
| data set is corrupted.
| System Action: The utility job terminates.
| User Response: If the right image copy data set is
| User Response: Divide the UNLOAD job step into two | specified to the FROMCOPY or FROMCOPYDDN, it will
| or more job steps and, in each job step, use a LISTDEF | be required to take a new image copy for the table
| that expands to less number of objects. | space by running the COPY utility or using other
| alternative methods.
572 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU1230I • DSNU1234I
| DSNU1230I csect-name - INCONSISTENT STRIP | decompression has not been loaded for the table
| CHAR LENGTH FOR FIELD field-name,
| space.
| TABLE table-name | Severity: 4 (warning)
| Explanation: An invalid strip character was specified | System Action: The record in error will not be
| for the indicated field of the table. | unloaded to the output data set. The UNLOAD utility
| Severity: 8 (error) | continues until the total number of records in error
| reaches the value specified by the MAXERR option (the
| System Action: The utility job terminates. | default is 1). If the total number of records reaches the
| MAXERR value, the UNLOAD utility issues the
| Problem Determination: For an SBCS or MIXED
| DSNU1219I message and terminates with the return
| character field, the strip character, if specified, must be
| code 8.
| an SBCS character; for a DBCS field, it must be a
| DBCS character. | Problem Determination: This message is issued
| when a copy of pieces (not the first piece) of a
| User Response: Specify the correct strip character
| compressed table space is specified in the FROMCOPY
| applicable to the field.
| or FROMCOPYDDN option of the UNLOAD utility.
| User Response: To unload compressed rows from the
| DSNU1231I csect-name - LENGTH OF OUTPUT
| copy of pieces, use COPYDDN option to specify a DD
| RECORD IS TOO LONG FOR TABLE
| name under which the first copy of pieces that contains
| table-name
| the compression dictionary is concatenated.
| Explanation: An output record for the indicated table
| exceeded the physical limit.
| DSNU1233I csect-name - DATA IS TOO LONG FOR
| Severity: 4 (warning) | FIELD field-name, TABLE table-name
| System Action: The record in error will not be | Explanation: The space for the field in an output
| unloaded to the output data set. The UNLOAD utility | record is not enough to unload the data from the
| continues until the total number of records in error | corresponding column of a row in the indicated table.
| reaches the value specified by the MAXERR option (the
| Severity: 4 (warning)
| default is 1).
| System Action: The record in error will not be
| If the total number of records reaches the MAXERR
| unloaded to the output data set. The UNLOAD utility
| value, the UNLOAD utility issues the DSNU1219I
| continues until the total number of records in error
| message and terminates with the return code 8.
| reaches the value specified by the MAXERR option (the
| Problem Determination: This message is issued only | default is 1).
| when the NOPAD option is specified in the UNLOAD
| If the total number of records reaches the MAXERR
| statement and most likely when BLOB, CLOB, or
| value, the UNLOAD utility issues the DSNU1219I
| DBCLOB columns are selected for unload from the
| message and terminates with the return code 8.
| table. It is also possible that, if the expansion of output
| strings occurs due to the encoding scheme specified for | Problem Determination: This message is issued
| the output, the total length of some output records | when the space of a field in an output record is limited
| becomes longer than expected. | by the LENGTH specification for the field or the
| POSITION specification for the next field.
| User Response: Consider the following options to
| reduce the size of the output records: | User Response: Apply appropriate values to the
| v Unload only the necessary fields using the field | LENGTH and/or POSITION parameters in the field
| specification options. | specification list to accommodate the data in the output
| records. Alternatively, specify TRUNCATE option to the
| v Specify the LENGTH option with TRUNCATE and/or
| field, if applicable. Specifying the STRIP option, if
| STRIP options for the applicable fields.
| applicable, can also reduce the length of data if the
| If the above options can not be applied, you will have to | data contains leading or trailing blanks.
| use an application to unload the data from the table.
| DSNU1234I csect-name - NUMERIC CONVERSION
| DSNU1232I csect-name - COMPRESSED ROW IS | ERROR OCCURRED FOR FIELD
| IGNORED BECAUSE THE DICTIONARY | field-name, TABLE table-name
| IS NOT AVAILABLE FOR TABLE
| Explanation: The UNLOAD utility encountered an
| table-name
| error when it tried to convert a data of one numeric type
| Explanation: The UNLOAD utility encountered a | to another.
| compressed row when unloading the data from an
| Severity: 4 (warning)
| image copy data set but the dictionary for
Chapter 18. DB2 Messages 573
DSNU1235I • DSNU1301I
| System Action: The record in error will not be | DSNU1219I message and terminates with the return
| unloaded to the output data set. The UNLOAD utility | code 8.
| continues until the total number of records in error
| reaches the value specified by the MAXERR option (the
| Problem Determination: This message will be issued
| default is 1).
| only when the NOPAD option is specified in the
| UNLOAD statement. The POSITION specification for
| If the total number of records reaches the MAXERR | the field caused a conflict with the positioning and/or the
| value, the UNLOAD utility issues the DSNU1219I | length of a previous field.
| message and terminates with the return code 8.
| User Response: Consider the following options to
| Problem Determination: This message is issued most | eliminate this situation:
| likely when an overflow occurs in converting a data of | v Remove the POSITION specifications from the field
| one numeric type to another. For example, an attempt | specification list.
| to convert an INTEGER 32768 to a SMALL INT causes
| v Adjust the POSITION parameter for the field to
| an overflow.
| preserve enough space for the previous fields.
| User Response: To eliminate any numeric overflow | v Adjust the LENGTH, possibly with the TRUNCATE
| error, specify the same numeric data type for the output | option, of the previous fields, if applicable.
| as the base type of the columns in the table. Convert
| numeric types only when it is known that the range of
| the source data fits in the allowable range of the | DSNU1237I csect-name - ERROR IN CCSID
| specified numeric type for the output. | CONVERSION FOR FIELD field-name,
| TABLE table-name
| DSNU1235I csect-name - CCSID SUBSTITUTION IS | Explanation: The CCSID translation process detected
| ATTEMPTED WITH NOSUBS OPTION | a code point or form exception while the UNLOAD utility
| FOR FIELD field-name, TABLE | was running.
| table-name | Severity: 4 (warning)
| Explanation: While the UNLOAD utility is running with | System Action: The record in error will not be
| the NOSUBS option, a CCSID substitution is attempted | unloaded to the output data set. The UNLOAD utility
| in the CCSID translation process for the indicated field. | continues until the total number of records in error
| Severity: 4 (warning) | reaches the value specified by the MAXERR option (the
| default is 1). If the total number of records reaches the
| System Action: The record in error will not be | MAXERR value, the UNLOAD utility issues the
| unloaded to the output data set. The UNLOAD utility | DSNU1219I message and terminates with the return
| continues until the total number of records in error | code 8.
| reaches the value specified by the MAXERR option (the
| default is 1). If the total number of records reaches the | User Response: If the specified CCSID for output is
| MAXERR value, the UNLOAD utility issues the | incorrect, correct the CCSID specification. If a valid
| DSNU1219I message and terminates with the return | CCSID is specified, notify the system programmer.
| code 8. | System Programmer Response: Verify the contents
| User Response: If it is desired to eliminate any | of SYSSTRINGS. If necessary, insert a row into
| CCSID substitution, specify an appropriate CCSID that | SYSSTRINGS for the translation. For an SBCS
| has the corresponding entries to the original CCSID, if | translation, the row must contain a translate table or the
| available. To allow the default CCSID substitution, | name of a user-provided translate procedure. For a
| remove the NOSUBS option. | DBCS translation, the row must contain the name of a
| user-provided translate procedure.
| DSNU1236I csect-name - POSITION SPECIFICATION
| CAUSES FIELD OVERLAP FOR FIELD | DSNU1300I csect-name MODIFY STATISTICS
| field-name, TABLE table-name | COMPLETED SUCCESSFULLY
| Explanation: For the UNLOAD utility, the space for an | Explanation: This message reports the successful
| output field was overlapped by the indicated field to | completion of the MODIFY STATISTICS utility operation.
| which the POSITION parameter is specified. | Severity: 0 (informational)
| Severity: 4 (warning)
| System Action: The record in error will not be | DSNU1301I csect-name n
| unloaded to the output data set. The UNLOAD utility | SYSIBM.SYSCOLDIST_HIST ROWS
| continues until the total number of records in error | WERE DELETED
| reaches the value specified by the MAXERR option (the | Explanation: This message displays the number n of
| default is 1). If the total number of records reaches the | SYSIBM.SYSCOLDIST_HIST rows that were deleted by
| MAXERR value, the UNLOAD utility issues the
574 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU1302I • DSNU1400I
| the MODIFY STATISTICS utility.
| DSNU1307I csect-name n
| Severity: 0 (informational) | SYSIBM.SYSTABLEPARTS_HIST ROWS
| WERE DELETED
| DSNU1302I csect-name n | Explanation: This message displays the number n of
| SYSIBM.SYSCOLUMNS_HIST ROWS | SYSIBM.SYSTABLEPARTS_HIST rows that were
| WERE DELETED | deleted by the MODIFY STATISTICS utility. The rows
| were deleted due to the AGE criteria or the DATE
| Explanation: This message displays the number n of | criteria that the user specified.
| SYSIBM.SYSCOLUMNS_HIST rows that were deleted
| by the MODIFY STATISTICS utility. The rows were | Severity: 0 (informational)
| deleted based on the AGE criteria or the DATE criteria
| that the user specified.
| DSNU1308I csect-name n
| Severity: 0 (informational) | SYSIBM.SYSTABLES_HIST ROWS
| WERE DELETED
| DSNU1303I csect-name n | Explanation: This message displays the number of
| SYSIBM.SYSINDEXES_HIST ROWS | SYSIBM.SYSTABLES_HIST rows that were deleted by
| WERE DELETED | the MODIFY STATISTICS utility. The rows were deleted
| due to the AGE criteria or the DATE criteria that the
| Explanation: This message displays the number n of | user specified.
| SYSIBMS.SYSINDEXES rows that were deleted by the
| MODIFY STATISTICS utility. The rows were deleted | Severity: 0 (informational)
| based on the AGE criteria or the DATE criteria that the
| user specified.
| DSNU1309I csect-name n
| Severity: 0 (informational) | SYSIBM.SYSTABSTATS_HIST ROWS
| WERE DELETED
| DSNU1304I csect-name n | Explanation: This message displays the number n of
| SYSIBM.SYSINDEXPART_HIST ROWS | SYSIBM.SYSTABSTATS_HIST rows that were deleted
| WERE DELETED | by the MODIFY STATISTICS utility. The rows were
| deleted due to the AGE criteria or the DATE criteria that
| Explanation: This message displays the number n of | the user specified.
| SYSIBM.SYSINDEXPART_HIST rows that were deleted
| by the MODIFY STATISTICS utility. The rows were | Severity: 0 (informational)
| deleted due to the AGE criteria or the DATE criteria that
| the user specified.
DSNU1400I csect-name - COPYTOCOPY UTILITY
| Severity: 0 (informational) NOT SUPPORTED FOR obj-type
obj-qual.obj-name DSNUM n
| DSNU1305I csect-name n Explanation: COPYTOCOPY cannot make copies of:
| SYSIBM.SYSINDEXSTATS_HIST ROWS v DSNDB01.SYSUTILX, DSNDB01.DBD01, or
| WERE DELETED DSNDB06.SYSCOPY table spaces, or any of their
| Explanation: This message displays the number n of indexes.
| SYSIBM.SYSINDEXSTATS_HIST rows that were v An image copy that was taken using the COPY utility
| deleted by the MODIFY STATISTICS utility. The rows with the CONCURRENT option.
| were deleted due to the AGE criteria or the DATE
Severity: 8 (error)
| criteria that the user specified.
System Action: Processing halts for this object. If the
| Severity: 0 (informational) utility job step includes an OPTIONS control statement
with the EVENT(ITEMERROR,SKIP) option,
| DSNU1306I csect-name n COPYTOCOPY processes the next item in the list.
| SYSIBM.SYSLOBSTATS_HIST ROWS
User Response: If the unsupported object is a
| WERE DELETED
restricted catalog or directory object listed in the
| Explanation: This message displays the number n of explanation, use another method to make all image
| SYSIBM.SYSLOBSTATS_HIST rows that were deleted copies for this object.
| by the MODIFY STATISTICS utility. The rows were
If the unsupported object is an image copy made with
| deleted due to the AGE criteria or the DATE criteria that
the CONCURRENT option, then make a primary local
| the user specified.
image copy by running the COPY utility without the
| Severity: 0 (informational)
Chapter 18. DB2 Messages 575
DSNU1401I • DSNU1407I
CONCURRENT option. Rerun COPYTOCOPY to make its completion was hh hours, mm minutes, and ss
additional image copies. seconds.
Severity: 0 (informational)
DSNU1401I csect-name - UNABLE TO LOCATE
System Action: The COPYTOCOPY utility completed
IMAGE COPY FOR obj-type
normally for this object. Processing continues.
obj-qual.obj-name DSNUM n
Explanation: The COPYTOCOPY utility attempted to
DSNU1405I csect-name - site-type SITE PRIMARY
make additional image copies from the referenced
IMAGE COPY DOES NOT EXIST FOR
object. However, SYSIBM.SYSCOPY does not contain a
obj-type obj-qual.obj-name DSNUM n
record of the referenced object.
Explanation: The COPYTOCOPY utility attempted to
Severity: 8 (error)
make a backup image copy for the site, but the primary
System Action: Processing halts for this object. If the image copy does not exist.
utility job step includes an OPTIONS control statement
Severity: 8 (error)
with the EVENT(ITEMERROR,SKIP) option,
COPYTOCOPY processes the next item in the list. System Action: The utility cannot make the site
backup copy. If the utility job includes an OPTIONS
User Response: Make a primary local image copy by
control statement with the EVENT(ITEMERROR,SKIP)
running the COPY utility. Then run COPYTOCOPY to
option, COPYTOCOPY processes the next item on the
make additional image copies.
list.
User Response: Modify your COPYTOCOPY job,
DSNU1402I csect-name - copy-type FOR obj-type
COPYDDN or RECOVERYDDN option, to include the
obj-qual.obj-name DSNUM n WITH
ddname for the primary copy.
START_RBA rba ALREADY EXISTS
Explanation: COPYTOCOPY attempted to make an
DSNU1406I csect-name - COPYTOCOPY
image copy that already exists.
COMPLETED. ELAPSED TIME =
Severity: 4 (warning) elapsed_time
System Action: The utility does not make the image Explanation: DB2 issues this message at the normal
copy for the specified object type. COPYTOCOPY completion of the COPYTOCOPY utility. The time that
makes the remaining types of image copies. If there is a elapsed since the beginning of the COPYTOCOPY
list of objects to be copied, COPYTOCOPY processes utility to its completion was hh hours, mm minutes, and
the next object in the list. ss seconds.
User Response: Run the REPORT utility to determine Severity: 0 (informational)
the image copy types that you need. Modify your
System Action: Processing continues to the next
COPYTOCOPY job, and rerun it as needed.
utility statement in the utility job step, if any. If not, the
utility job step halts, and the UTILID of the utility job
DSNU1403I csect-name - copy-type DATA SET dsn step becomes available for reuse.
WITH START_RBA rba IS IN USE BY
COPYTOCOPY FOR obj-type
DSNU1407I csect-name - MISMATCH BETWEEN
obj-qual.obj-name DSNUM n
THE NUMBER OF PAGES READ=count
Explanation: The COPYTOCOPY utility issues this AND THE NUMBER OF PAGES
message before it opens an image copy data set and ORIGINALLY COPIED=count FOR
begins the copying process. INPUT DATA SET dsname OBJECT
NAME obj-type obj-qual.obj-name
Severity: 0 (informational)
DSNUM n
System Action: COPYTOCOPY processing continues.
Explanation: The COPYTOCOPY or RECOVER utility
issues this message when it detects that the number of
DSNU1404I csect-name - COPYTOCOPY pages read from the input image copy does not match
PROCESSING COMPLETED FOR the original number of pages copied by the COPY utility.
obj-type obj-qual.obj-name DSNUM n. The utility retrieves the number of pages originally
ELAPSED TIME = elapsed time. copied from the COPYPAGESF column of the
NUMBER OF PAGES COPIED = n SYSIBM.SYSCOPY record for the input image copy
data set.
Explanation: COPYTOCOPY issues this message at
the normal completion of an object. The time that Severity: 8 (error)
elapsed since the beginning of processing the object to
System Action: The COPYTOCOPY utility terminates
576 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNU1408I • DSNU3330I
processing of this object. The RECOVER utility attempts the MVS console SYSLOG indicating the type of I/O
to continue by falling back to the previous full image error that occurred. If an IOS message was issued,
copy, if any. If the utility job step includes an OPTIONS follow the Problem Determination directions for the
control statement with the EVENT(ITEMERROR,SKIP) message.
option, COPYTOCOPY processes the next item in the
list.
DSNU1410I csect-name - INCREMENTAL IMAGE
User Response: Report to IBM Center. Provide output COPY DISALLOWED FOR obj-type
of COPYTOCOPY job, the data set referenced in the obj-qual.obj-name DSNUM n. FULL
message, and run REPORT utility on the object and IMAGE COPY WILL BE USED
provide its output.
Explanation: An incremental image copy is disallowed
for the specified object type. The utility ignores the
DSNU1408I csect-name - SOURCE DATA SET request, and creates a full image copy if available.
dsname DOES NOT obj-type
Severity: 4 (warning)
obj-qual.obj-name DSNUM n
System Action: The system treats the request to copy
Explanation: The COPYTOCOPY or RECOVER utility
an incremental image copy as a request to copy a full
issues this message when the DBID or PSID of the
image copy.
source data set does not match the DBID or PSID of
the table space or index space for which the copy is User Response: The capacity of the target image
made. This error can occur if the data set was reused. copy data set may not be sufficient if its size was
established assuming an incremental image copy. If this
Severity: 4 (warning)
condition occus, halt the utility and resubmit the job step
System Action: RECOVER attempts to continue with the appropriate size.
processing by falling back to the previous full image
copy, if any.
DSNU1411I csect-name - ut_name DOES NOT
COPYTOCOPY searches for the next available image SUPPORT RESTART(PHASE). PHASE
copy data set with the same START_RBA value as the CHANGED TO CURRENT.
START_RBA value registered in SYSIBM.SYSCOPY for
Explanation: This utility does not support the
dsname. If COPYTOCOPY finds a data set, it uses that
RESTART(PHASE).
data set. Otherwise, COPYTOCOPY issues message
DSNU1401I. Severity: 0 (informational)
If FROMCOPY is specified, processing of this object System Action: The utility overrides
halts. RESTART(PHASE) with RESTART(CURRENT).
User Response: Determine why the data set was
reused for the image copy data set that is registered in | DSNU1502I csect-name - RECOVER OF obj-type
SYSIBM.SYSCOPY. | obj-qual.objname dsnum n WILL
If FROMCOPY is specified, correct the COPYTOCOPY
| PROCEED TO LOG POINT X'rba/lrsn'
utility control statement. Specify a source data set that | Explanation: DB2 issues this message if the
is an image copy of the table space or index space for | RECOVER utility statement includes the TOLASTCOPY
which you want additional image copies. | or TOLASTFULLCOPY keyword. The message provides
| information on the point in time that the object was
DSNU1409I csect-name - ttttt ERRORS ON DATA
| recovered to. In a data sharing environment, the log
SET NAME=dsname obj-type
| point identified is an LRSN. Otherwise, the log point
obj-qual.obj-name DSNUM n
| identified is an RBA.
Explanation: DB2 detected I/O errors on the named
| Severity: 0 (informational)
object. ttttt is either 'READ' or 'WRITE'. | System Action: The RECOVER utility statement
Severity: 4 (warning)
| continues processing.
System Action: If FROMCOPY is specified,
processing is terminated. Otherwise, processing will
| DSNU3330I csect-name - The utility-name UTILITY IS
continue. The utility will attempt to use the next
| PART OF A SEPARATELY LICENSED
available image copy data set that matches
| FEATURE WHICH WAS NOT FOUND
COPYTOCOPY job specification with the same START_
| ON THIS SYSTEM.
RBA as the data set named in error. If it fails to find | Explanation: DB2 could not find the specified utility in
one, processing of this object is terminated. | the load library concatenation specified in the submitted
User Response: There may be an IOS message on
| JCL. The specified utility is part of an optional feature of
| DB2.
Chapter 18. DB2 Messages 577
DSNU3331I • DSNU3332I
| Severity: 8 (error)
| System Action: Utility processing does not initiate.
| User Response: Obtain and install one of the optional
| utility features (JDB771K or JDB771M) that contains the
| utility you wish to execute.
| DSNU3331I csect-name - THERE ARE n DAYS
| REMAINING IN THE TRIAL PERIOD
| FOR THE utility-name UTILITY
| Explanation: The specified utility is part of an optional
| feature of DB2, and it will remain active for a 90-day
| trial period. This message displays the number of days
| remaining in the trial period.
| Severity: 0 (informational)
| System Action: Utility processing continues.
| User Response: To continue executing the utility after
| the trial period, obtain and install one of the optional
| utility features (JDB771K or JDB771M) that contains the
| utility.
| DSNU3332I csect-name - THE EVALUATION
| PERIOD FOR THE utility-name UTILITY
| HAS EXPIRED
| Explanation: The specified utility is part of an optional
| feature of DB2, and it has remained active for a 90-day
| trial period. The trial period has expired.
| Severity: 8 (error)
| System Action: Utility processing does not initiate.
| User Response: Obtain and install one of the optional
| utility features (JDB771K or JDB771M) that contains the
| utility you wish to execute.
578 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 19. DSNV... Messages
System Action: Abnormal termination processing
DSNV029E LOAD MODULE module-name DOES
continues.
NOT HAVE AMODE(31) ATTRIBUTE
Operator Response: Notify the system programmer,
Explanation: During DB2 startup, Agent Services
and restart DB2.
establishes the tasking structure for the control and
resource manager address spaces. Three load System Programmer Response: This message is
modules, DSNVEUS3, DSNVEUS4, and DSNVRCT, are accompanied by one or more dumps. Obtain a copy of
loaded and attached as the control programs for each SYS1.LOGREC after DB2 completely terminates; also
subtask created. All three load modules must have been obtain a copy of the SVC dump(s). If you suspect an
link-edited with the attributes AMODE(31) and error in DB2, refer to Part 2 of DB2 Diagnosis Guide
RMODE(ANY). At least one of the modules did not have and Reference for information on identifying and
the 31-bit addressing attribute when it was loaded. The reporting the problem.
'module-name' in the error message is the alias name of
the first load module whose addressing mode was Problem Determination: Collect the following
invalid. diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 1, 5.
System Action: DB2 startup is terminated.
System Programmer Response: Verify that all DSNV400I ARCHIVE LOG WITH MODE(QUIESCE)
installation and maintenance activities against these CURRENTLY ACTIVE
modules were executed using SMP, that the JCLIN for
SMP includes the correct AMODE and RMODE control Explanation: An -ARCHIVE LOG MODE(QUIESCE)
statements, and that the Linkage Editor provided with command is currently active. This message follows the
the Data Facility Product (DFP) for the version of MVS DSNV401I message as part of the -DISPLAY THREAD
being used was invoked by SMP for the link-edits. command report.
Correct the procedure or JCL which caused the error System Action: This message is issued as
and rerun the necessary SMP jobs. information only. The message indicates that the
Operator Response: Notify the system programmer of -ARCHIVE LOG MODE(QUIESCE) command has not
the failure. completed, and consequently, updates against DB2
resources have been temporarily suspended. This may
Problem Determination: A DB2 dump was requested result in active threads being suspended awaiting
to a SYS1.DUMP data set. termination of the quiesce period. DB2 processing
otherwise continues normally.
Load module names and aliases are as follows:
Load module Alias
DSNV401I DISPLAY THREAD REPORT FOLLOWS
DSNVEUS3 DSNVEU3I -
DSNVEUS4 DSNVEU4I Explanation: This message is always generated as
the title for the DISPLAY THREAD command report
DSNVRCT DSNVRCTI
output. It precedes the other messages generated by
this command.
The MVS service aid AMBLIST provides Linkage Editor
module attributes in the summary section of the System Action: Processing continues normally.
LISTLOAD function output.
DSNV402I ACTIVE THREADS-
DSNV086E DB2 ABNORMAL TERMINATION
Explanation: This message precedes the listing of
REASON=xxxxxxxx
active threads.
Explanation: The DB2 subsystem is being abended,
The series of messages DSNV402I through DSNV405I
because an error that cannot be corrected has
provide the formatted report for the -DISPLAY THREAD
occurred. This message, which is not automatically
TYPE(ACTIVE) when the status of active threads is
deleted from the operator console, is issued during DB2
requested.
abnormal termination. 'REASON' is the subsystem
termination reason code. If DB2 abnormal termination is The series of messages DSNV444I through DSNV448I
invoked multiple times, the subsystem termination augment the formatted report for the -DISPLAY
reason code that accompanies this message is the THREAD TYPE(ACTIVE) when LOCATION, LUWID, or
reason associated with the first invocation. For DETAIL keywords are used to show distributed activity.
additional information, look up the reason code in
System Action: Processing continues normally.
“Part 4. DB2 Codes” on page 707.
© Copyright IBM Corp. 1982, 2001 579
DSNV403I • DSNV404I
connection and is available to be
DSNV403I NAME ST A REQ
assigned to a type 2 inactive thread.
ID AUTHID PLAN ASID TOKEN
DI The thread is disconnected from an
Explanation: This message displays the column
execution unit. There is no TCB
headings for the list of threads generated by the
associated with the DB2 thread. This
-DISPLAY THREAD TYPE(ACTIVE) or -DISPLAY
state is only valid when ’connection
THREAD TYPE(INACTIVE) command.
name’=RRSAF.
The message number and subsystem recognition
N The thread is in either IDENTIFY or
character are not included in this message.
SIGNON status.
System Action: Processing continues normally.
PT A parallel task thread was established
(plan allocated).
DSNV404I name status act-ind req-ct corr-id auth-id
QD The thread is queued for termination
pname asid token
as a result of the termination of the
Explanation: This message provides the status associated allied task. If this thread is
information on an active or inactive thread and is part of also the last (or only) DB2 thread for
the response to the -DISPLAY THREAD command. the address space, the associated
Information provided is: allied task is placed in a wait state.
name A 1- to 8-character variable representing the QT The CREATE THREAD request was
'connection name' used to establish the thread. queued. The associated allied task is
For distributed database access threads, this placed in a wait state.
field contains the following:
R2 A distributed thread is performing a
v For threads using system-directed access
remote access on behalf of a request
and for threads using application-directed
from another location. The thread is
access from a DB2 Version 3 or later
currently a type 2 inactive thread and
requester, this variable displays the
is waiting for an agent to become
connection name of the thread at the
available to process.
requesting location.
v For threads using application-directed RA The distributed thread is performing a
access from a non-DB2 requester or from a remote access on behalf of a request
DB2 Version 2 Release 3 requester, this from another location.
variable displays the constant SERVER.
v If the thread has a status of PT, the | RK A distributed thread is performing
connection name contains blanks if the | remote access on behalf of a request
thread of the originating task is running on | from another location. The thread is
the same DB2. This helps to show that | performing an operation that invoked
these parallel tasks are related to the | Kerberos services. This status is
originating task above. If the parallel task is | displayed until Kerberos services
running on a different DB2 for the originating | returns control to DB2.
task, then the connection name will be RN A distributed thread is performing a
supplied and the entry will be followed by remote access on behalf of a request
DSNV443I. from another location. The request
actually accesses data at yet another
If the thread has a status of D, the connection (DB2) location, so the thread was
name might be either the connection name for suspended because DB2 must first
the allied address space or the DB2 subsystem connect to the partner location
name. (establish DB2 system conversations
with the partner).
status A 1- or 2- character connection status code
with the following values: When another DB2 site is being
contacted for the first time using
D The thread is in the process of
system-directed access, DB2 must
termination as a result of the
establish DB2 system conversations
termination of the associated allied
with the partner location. A request is
task. If this thread is also the last (or
presented to a DB2 DDF service task
only) DB2 thread for the address
that establishes a system
space, the associated allied task is
conversation. The thread is
placed in a wait state.
suspended until the request is
DA The database access thread slot is processed. If the thread remains in
currently not associated with a remote this status for an extended period of
580 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNV404I
time, the DB2 service task that LOCATION command (’DISPLAY
establishes the system conversations LOCATION(*) DETAIL’) shows you
might be busy processing other conversation activity for this DB2
requests. The DB2 DISPLAY system conversation (SYSCON-O)
LOCATION command (’DISPLAY service task.
LOCATION(*) DETAIL’) shows you
TR An allied thread was distributed to
conversation activity for this DB2
access data at another location.
system conversation (SYSCON-O)
service task. act-ind An asterisk if the thread is active within DB2;
blank otherwise.
RQ A distributed thread is performing a
remote access on behalf of a request req-ct A wraparound counter to show the number of
from another location. The thread is DB2 requests.
suspended because the maximum
number of active database access corr-id A 1- to 12-character variable representing the
threads (as described by the MAX recovery 'correlation-id' associated with the
REMOTE ACTIVE value of the thread.
DSN6SYSP macro in the DB2 startup For distributed database access threads, this
parameter, usually DSNZPARM) was field contains the following:
reached. Database access agents
v While the thread is being created:
(DBAAs) are queued until other
DBAAs deallocate or go inactive, – ’028.DBAA nn’ - Where nn ranges from
providing an available slot. The DBAA 01 to 99. This indicates that the DBAA is
resumes when a slot becomes in its connection processing, which
available, and the DBAA is next in the consists of establishing the DBAA thread,
queue. Alternatively, you should and validating and verifying the user’s ID.
consider increasing the MAX Refer to the ″Controlling Access to a DB2
REMOTE ACTIVE value. Subsystem″ chapter in Part 3 (Volume 1)
of DB2 Administration Guide for
SP A thread is executing within a stored descriptions of the authorization checks
procedure. This status is displayed that might be performed.
until the stored procedure terminates
RACF requests are serialized on one of
and returns control to DB2.
the DB2 RACF service tasks, which
SW A thread is waiting for a stored might increase the validation time when
procedure to be scheduled. This multiple DBAAs are being created
status is displayed until the stored concurrently.
procedure begins execution. v After the thread is created:
T An allied, nondistributed thread was – For threads using system-directed access
established (plan allocated). and threads using application-directed
access from a DB2 requester, this
TN An allied thread was distributed to variable displays the correlation-id name
access data at another DB2 location, of the thread at the requesting location.
but it was suspended because DB2
must first connect to the partner – For threads using application-directed
location (establish DB2 system access from a non-DB2 requester, this
conversations with the partner). variable displays the first twelve
characters in the DDM external name
When another DB2 site is being (EXTNAM) parameter of the DDM
contacted for the first time using EXCSAT command received as part of
system-directed access, DB2 must the SQL CONNECT.
establish DB2 system conversations
with the partner location. A request is authorization ID
presented to a DB2 DDF service task The authorization ID associated with a
that establishes a system signed-on connection. If not signed-on, this
conversation. The thread is field is blank.
suspended until the request is pname A 1- to 8-character variable representing the
processed. If the thread remains in plan name associated with the thread. For
this status for an extended period of distributed database access threads, this field
time, the DB2 service task that contains the following:
establishes the system conversations
v For threads using system-directed access
might be busy processing other
and threads using application-directed
requests. The DB2 DISPLAY
Chapter 19. DB2 Messages 581
DSNV405I • DSNV408I
access from a DB2 Version 3 or later System Action: Processing continues normally.
requester, this variable displays the plan
name being executed at the requesting
DSNV407I COORDINATOR STATUS RESET URID
location.
AUTHID
v For threads using application-directed
access from a non-DB2 requester or from a Explanation: This message displays the column
DB2 Version 2 Release 3 requester, this headings for the list of threads generated by the
field displays the constant DISTSERV. DISPLAY THREAD TYPE (INDOUBT) command, or for
the list of Postponed Abort URs generated by the
For RRSAF connected threads that did not DISPLAY THREAD TYPE(POSTPONED) or DISPLAY
specify a plan name at connect time, the value THREAD TYPE(*) command.
?RRSAF is displayed. If a thread was not The message number and the subsystem recognition
established, this field is blank. character are not included in this message.
If you receive a system plan in this field, see System Action: Processing continues normally.
the information about system plans in message
DSNT376I. DSNV408I coordinator status reset urid authid
asid A 1- to 4-character hexadecimal number Explanation: This message lists status information on
representing the ASID of the home address an indoubt thread or for a Postponed Abort UR.
space.
coordinator
token A 1- to 5-character number representing the The name of the two-phase commit
thread token assigned to the thread. For coordinator.
threads with a status value of ’N’, this value will v If the thread is an allied thread, the
be 0. coordinator name is either the IMS
connection name, the CICS connection
The message number and subsystem recognition name, OS/390 RRS (for Recoverable
character are not included in this message. Resource Manager Services attachment
System Action: Processing continues normally. facility connected threads) or the location
name of the local DB2 (if it is not one of the
System Programmer Response: If you have active above). DSNV449I is displayed if the
threads with QD or D status codes, use the information coordinator is IMS or CICS.
in message DSN3201I to diagnose a possible DB2 v If the thread is a database access thread,
problem. the coordinator name takes one of four
forms:
DSNV405I DISPLAY ACTIVE REPORT COMPLETE – location:luname -- where ″location″ is the
coordinator’s relational database name
Explanation: This message follows messages and ″luname″ is the coordinator’s SNA
DSNV402I through DSNV404I augmented by the series LU name.
of messages DSNV444I through DSNV448I when
– location:port -- where ″location″ is the
LOCATION and/or DETAIL keywords are used to show
coordinator’s relational database name
distributed activity. It indicates that the -DISPLAY
and ″port″ is the coordinator’s TCP/IP
THREAD TYPE(ACTIVE) report has completed
port number for two-phase commit
successfully.
resynchronization.
The message number and subsystem recognition – <luname>:luname -- where ″luname″ is
character are not included in this message. the coordinator’s SNA LU name.
System Action: Processing continues normally. – nnn.nnn.nnn.nnn:port -- where
″nnn.nnn.nnn.nnn″ is the coordinator’s IP
address and ″port″ is the coordinator’s
DSNV406I INDOUBT THREADS-
TCP/IP port number for two-phase
Explanation: This message precedes the listing of commit resynchronization.
indoubt threads. v If the thread is distributed, message
DSNV467I is included in the display. This
The series of messages DSNV406I through DSNV409I, message shows the logical unit of work id
DSNV446I, DSNV449I through DSNV453I, DSNV457I and the local token that identifies the
through DSNV464I, DSNV466I, DSNV467I provides distributed thread.
theformatted report for the -DISPLAY THREAD
TYPE(INDOUBT) command when the status of indoubt status The status of the thread.
threads is requested.
582 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNV408I
A status of ABORTED is not displayed unless continues to appear in the display until it is
DB2 believes a participant using PN protocols deleted with the RESET INDOUBT
might be indoubt. If the status of a thread for a command. The database administrators at
logical unit of work at a participant is all involved locations need to know that
INDOUBT, COMMITTED-H, or ABORTED-H, heuristic damage occurred and at which
and the coordinator is a DB2 location that has location.
not cold started, then the lack of any v COMMITTED-H: The indoubt thread was
information about the thread in a DISPLAY heuristically resolved with the RECOVER
THREAD(INDOUBT) report indicates that the INDOUBT command. The thread continues
decision at the coordinator was to abort the to appear in the display until the coordinator
logical unit of work. In all other cases, a is informed of the heuristic decision, and all
DSNV408I message for the thread is downstream participants, if any, complete
displayed. indoubt resolution. Detail lines DSNV450I
v INDOUBT: The thread is indoubt and and DSNV446I list the downstream
continues to appear in the display until all participants that have pending resolution.
indoubt resolution responsibilities are Additional detail lines that might appear in
complete. Additional detail lines that might the report are:
appear in the report are: – DSNV451I is displayed if resolution with
– DSNV450I and DSNV446I: The names of the coordinator is not complete. All
downstream participants who might be database locks were released.
indoubt. – DSNV461I is displayed if resolution with
– DSNV452I or DSNV453I: A heuristic the coordinator completed and heuristic
action was taken at a downstream damage was detected after the
participant. DSNV452I or DSNV453I coordinator aborted the logical unit of
continues to appear in the display until work. This line continues to appear in the
DB2 resolves the indoubt status with the display until it is deleted with the RESET
coordinator. If the coordinator decision is INDOUBT command.
the same as the heuristic decision of the v ABORTED-H: The indoubt thread was
partner, then the detail line is no longer heuristically resolved with the RECOVER
displayed. If the coordinator status is INDOUBT command. The thread continues
COMMITTED and the heuristic decision to appear in the display until the coordinator
of the participant is ABORTED, then the is informed of the heuristic decision.
message continues to appear in the Additional detail lines that might appear in
display until it is deleted with the RESET the report are:
INDOUBT command. The database
– DSNV451I is displayed if resolution with
administrators at all involved locations
the coordinator is not yet complete. All
need to know that heuristic damage
database locks were released.
occurred and at which location.
– DSNV461I is displayed if resolution with
– DSNV466I: For a database access thread
the coordinator completed and heuristic
participant, the elapsed time that the
damage was detected after the
thread was indoubt.
coordinator committed the logical unit of
v COMMITTED: The thread is committed. This work. This line continues to appear in the
status is displayed when DB2 is the display until it is deleted with the RESET
coordinator and has downstream participants INDOUBT command.
that might be indoubt. The thread appears in
v ABORTED: This is a coordinator status and
the display until all downstream participants
DB2 has one or more downstream
complete indoubt resolution. Detail lines
participants using the Presumed Nothing
DSNV450I and DSNV446I list the
(PN) protocol that might be indoubt. The
downstream participants that have pending
thread appears in the display until all
resolution. Database locks held for the
downstream PN participants complete
thread were released.
indoubt resolution. Detail lines DSNV450I
If a participant resolved the indoubt thread and DSNV446I list the downstream
with a heuristic decision, and the decision participants that have pending resolution.
was ABORT (rollback), detail line DSNV453I Database locks held for the thread were
is displayed. This detail line contains the released.
name of the participant and the heuristic
If a participant resolved the indoubt thread
decision that it made. Since the coordinator
with a heuristic decision, and the decision
committed and the participant aborted, this
was COMMIT, detail line DSNV452I is
indicates heuristic damage. This line
displayed. This detail line contains the name
Chapter 19. DB2 Messages 583
DSNV408I
of the participant and the heuristic decision permanent and prevent completion of the
that it made. Since the coordinator aborted automatic indoubt resolution process.
and the participant committed, this indicates An indoubt display thread report shows
heuristic damage. This line continues to these protocol errors, as follows:
appear in the display until it is deleted with
– A DB2 coordinator detecting a sync point
the RESET INDOUBT command. The
protocol error by a participant, such that
database administrators at all involved
the coordinator believes that the
locations need to know that heuristic
participant might be indoubt, adds this
damage occurred and at which location.
thread to the indoubt thread display, if the
v ABORT-P: This line represents a Postponed decision is to commit. Message
Abort UR. Objects for which this UR has DSNV460I is included in the display
backout work pending are inaccessible indicating the protocol error and the
(Restart Pending) until the abort is potential need for heuristic action at the
completed (for example, by means of the participant. The thread continues to be
-RECOVER POSTPONED command). included in the report until the entry is
v ABORT-PSTRT: This line represents a purged with the RESET INDOUBT
Postponed Abort UR that is currently command. If the participant is actually
undergoing -RECOVER POSTPONED indoubt, the database administrator at the
processing or automatic DB2 backout participant needs to know the status of
processing (requested by restarting with the thread so that the correct heuristic
system parameter LBACKOUT = AUTO). decision can be made.
– A DB2 participant detecting a sync point
Additional detail lines might appear in an protocol error by a coordinator when the
indoubt thread report, as follows: participant is indoubt adds this thread to
v Cold Start: When a coordinator cold starts, the indoubt thread display. Message
indoubt participants cannot achieve DSNV459I is included in the display,
automatic resolution. A DB2 participant indicating the protocol error and
includes message DSNV463I in the display, requesting heuristic resolution. The
indicating coordinator cold start and thread continues to be included in the
requesting heuristic resolution. Message report until the thread is resolved with the
DSNV458I is included in the display if the RECOVER INDOUBT command. The
coordinator cold started. This message DBA at the participant might need to
contains information that can be used to contact the coordinator to determine the
identify the thread. This information is status of the thread.
provided by the coordinator. A DB2 – If a DB2 coordinator detects an indoubt
coordinator provides the connection-name resolution protocol error by a participant,
used to establish the thread at the DB2 message DSNV457I is included in the
coordinator and the correlation-id used by indoubt report, indicating the error and
that connection. requesting heuristic action at the
When a participant cold starts, the participant. The thread continues to be
coordinator cannot fulfill its indoubt included in the report until the entry is
resolution responsibility. A DB2 coordinator purged with the RESET INDOUBT
displays message DSNV462I indicating command. The database administrator at
participant cold start. The thread continues the participant needs to know the status
to be displayed in the report, even after of the thread so that the correct heuristic
resolution with all other indoubt participants, decision can be made.
if any. The RESET INDOUBT command – If a DB2 participant detects an indoubt
must be used to purge this thread from the resolution protocol error by a coordinator,
report. The reason for this is that the cold and the thread status is INDOUBT,
starting participant might have been message DSNV464I is included in the
coordinating downstream participants that indoubt report, indicating the error and
are now indoubt. The database administrator requesting heuristic action. The thread
at these participants might need to know the continues to be included in the report
status of the thread at the coordinator so until the thread is resolved with the
correct heuristic decisions can be made. RECOVER INDOUBT command.
v Protocol Errors: A communications protocol
reset This column contains YES if the RESET
error might occur during sync point
INDOUBT command must be used to purge
processing and during indoubt resolution
this thread from the indoubt display.
processing. These protocol errors are
584 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNV409I • DSNV415I
urid The RBA of the DB2 recovery log. This point is
DSNV413I csect-name verbname pkwname
the beginning of recovery logging for this
TERMINATED, DEFAULT UNAVAILABLE
thread.
Explanation: This message indicates that the
authid The primary authorization-id associated with
command ’verbname’ abnormally terminated because
the thread.
the command was entered from an MVS console and a
System Action: Processing continues. required parameter was not supplied with the command.
csect-name
DSNV409I DISPLAY INDOUBT REPORT The name of the command program CSECT
COMPLETE that issued the message.
Explanation: This message follows messages verbname
DSNV406I through DSNV408I and indicates that the The command verb as entered by the
-DISPLAY THREAD TYPE(INDOUBT) report was requester. The error depends on which
generated successfully. command was entered.
v DISPLAY THREAD - neither the
The message number and subsystem recognition ’connection-name’, LOCATION, nor LUWID
character are not included in this message. was specified.
System Action: Processing continues normally. v RECOVER INDOUBT - neither
’connection-name’ nor LUWID was specified.
DSNV410I NO CONNECTION FOUND FOR pkwname
NAME=connection-name The command primary keyword as entered by
the requester.
Explanation: The -DISPLAY THREAD TYPE(ACTIVE)
or TYPE(INACTIVE) command was unable to find any System Action: Command processing terminates.
connection associated with 'connection-name'. This Operator Response: Reenter the command specifying
message is generated once for each requested one of the required parameters.
connection name that was not found.
System Action: Command processing continues. DSNV414I THREAD xxx COMMIT SCHEDULED
Explanation: In this message, 'xxx' is the recovery
DSNV411I NO THREADS FOUND FOR identifier specified with the -RECOVER INDOUBT
NAME=connection-name command to identify the indoubt thread and is one of
Explanation: The -DISPLAY THREAD TYPE(ACTIVE) the following:
or TYPE(INACTIVE) command was unable to locate ID= The recovery correlation-id specified with the
any threads associated with 'connection-name'. This command.
message is generated once for each connection name NID= The recovery network-id specified with the
for which no threads were found. command.
LUWID =
System Action: Command processing continues. Luwid=token indicates the luwid and token that
identify the thread specified with the command.
DSNV412I csect-name NO INDOUBT THREADS System Action: The thread specified on the
FOUND FOR NAME=connection name -RECOVER INDOUBT command is scheduled for
Explanation: In this message, 'csect-name' is the COMMIT recovery action.
name of the command program CSECT that issued the
message. 'NAME' is the connection name specified on DSNV415I THREAD xxx ABORT SCHEDULED
the command.
Explanation: In this message, 'xxx' is the recovery
The named command was unable to locate any indoubt identifier specified with the -RECOVER INDOUBT
threads associated with the 'connection name'. This command to identify the indoubt thread and is one of
message is generated once for each 'connection name' the following:
for which no threads were found. ID= The recovery correlation-id specified with the
System Action: Command processing continues. command.
NID= The recovery network-id specified with the
command.
LUWID =
The luwid=token indicates the luwid and token
that identify the thread specified with the
command.
Chapter 19. DB2 Messages 585
DSNV416I • DSNV422I
The thread specified on the -RECOVER INDOUBT
DSNV419I NO CONNECTIONS FOUND
command is scheduled for ABORT recovery action.
Explanation: The -DISPLAY THREAD command
System Action: Command processing continues.
found no active or inactive connections within the
system. This message is generated when the command
DSNV416I THREAD NID=net-node.number IS requests thread information for all (TYPE=*), active
INVALID (TYPE=ACTIVE), or inactive (TYPE=INACTIVE)
connections within the system, but no active or inactive
Explanation: In this message, 'net-node' is the connections currently exist.
recovery 'network-id' specified with the command.
System Action: Command processing continues.
The -RECOVER INDOUBT command
(NID=net-node.number) determined that the input format
for the specified network-id is invalid. DSNV420I NO INDOUBT THREADS FOUND
System Action: Command processing continues. Explanation: The -DISPLAY THREAD command
found no indoubt threads within the system. This
Operator Response: Prior to reentering the message is generated when the command requests
command, ensure that the network-id entered is in the information about all (*) threads currently residing within
correct format as specified on the -RECOVER an indoubt state (TYPE=INDOUBT) within the system,
INDOUBT command. but no threads currently exist within this state.
System Action: Command processing continues.
DSNV417I THREAD xxx NOT FOUND
Explanation: In this message, 'xxx' is the recovery DSNV421I DISPLAY TERMINATED WITH MAX
identifier specified with the -RECOVER INDOUBT LINES
command to identify the indoubt thread and is one of
the following: Explanation: This message indicates the -DISPLAY
ID= The recovery correlation-id specified with the THREAD TYPE(ACTIVE) or the DISPLAY THREAD
command TYPE(INACTIVE) report was truncated. The report was
NID= The recovery network-id specified with the generated in response to a command from an MVS
command console and more than 254 response messages were
LUWID = generated. Only 254 response messages are returned.
The luwid or token specified with the command
The message number and subsystem recognition
character are not included in this message.
The -RECOVER INDOUBT command was unable to
locate the specified thread to be scheduled for recovery. System Action: The truncated report is written to the
Either the thread identifier is incorrect, or the thread no MVS console.
longer is in an indoubt state.
Operator Response: Reissue the -DISPLAY THREAD
System Action: Command processing continues. request specifying a specific connection name, location,
luwid, or a combination of these, as appropriate, to
Operator Response: Before reentering the command, further reduce the display.
ensure that the thread still is in an indoubt state.
DSNV422I DISPLAY INDOUBT TERMINATED WITH
DSNV418I RECOVER INDOUBT REJECTED FOR MAX LINES
ID= correlation-id
Explanation: This message indicates the -DISPLAY
Explanation: In this message, 'ID=' indicates the THREAD TYPE(INDOUBT) report was truncated. The
recovery 'correlation-id' specified with the command. report was generated in response to a command from
The -RECOVER INDOUBT command determined that an MVS console and more than 254 response
more than one 'network-id' is associated with the messages were generated. Only 254 response
specified 'correlation-id'. No recovery action is taken messages are returned.
against the indoubt threads associated with the The message number and subsystem recognition
'correlation-id'. character are not included in this message.
System Action: Command processing continues. System Action: The truncated report is written to the
Operator Response: To indicate the specific indoubt MVS console.
thread to be scheduled for resolution, the 'network-id' Operator Response: Reissue the -DISPLAY THREAD
associated with the thread must be specified. request specifying a specific connection name.
586 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNV423I • DSNV429I
DSNV423I DISPLAY THREAD MESSAGE POOL DSNV427I csect-name INVALID THREAD token
SIZE EXCEEDED SPECIFIED
Explanation: The virtual storage requirement needed Explanation: This message is issued in response to
to generate a -DISPLAY THREAD response display the CANCEL THREAD command. No thread with the
exceeded the maximum size of the message buffer specified token was found.
pool.
System Action: The specified thread is not canceled.
System Action: Processing is terminated.
User Response: Determine the correct token of the
User Response: Reissue the -DISPLAY THREAD thread you want to cancel and reissue the command.
request specifying TYPE(INDOUBT), TYPE(ACTIVE), or You can use the -DISPLAY THREAD command to
TYPE(INACTIVE) and a specific connection name, display all thread activity.
location, luwid, or a combination of these, as
appropriate, to further reduce the display.
DSNV428I csect-name THREAD token WAS
Operator Response: Refer to the User Response. PREVIOUSLY CANCELED
Explanation: The thread with the specified token was
DSNV424I INACTIVE THREADS- previously canceled by either the CANCEL THREAD or
CANCEL DDF THREAD command, or is already in the
Explanation: This message precedes the listing of
process of termination.
inactive threads.
The CANCEL command terminates the thread only if
The series of messages DSNV402I through DSNV405I
the thread is processing in DB2 or is currently
provide the formatted report for the -DISPLAY THREAD
suspended by DB2. The thread might not be processing
TYPE(INACTIVE) when the status of inactive threads is
in DB2 in these situations:
requested.
v The thread is processing in the application and has
The series of messages DSNV444I through DSNV448I not made a request to DB2. The DISPLAY THREAD
augment the formatted report for the -DISPLAY command indicates this.
THREAD TYPE(INACTIVE) when LOCATION, LUWID,
v The user placed the thread on an MVS resource
or DETAIL keywords are used to show idle distributed
using the ENQUE command. The CANCEL command
threads.
has no effect on the thread until ENQUE completes
System Action: Processing continues normally. and the thread returns to DB2.
v The thread is processing in VTAM and is waiting for a
DSNV425I DISPLAY INACTIVE REPORT response from a partner. The DISPLAY THREAD
COMPLETE DETAIL command indicates this. The thread does not
terminate until VTAM returns to DB2. VTAM
Explanation: This message follows messages commands, which will terminate the session or LU,
DSNV424I, DSNV403I and DSNV404I, which are can be used to cause VTAM to return to DB2.
augmented by the series of messages DSNV444I
through DSNV448I when LOCATION and/or DETAIL
keywords are used to show idle distributed threads. It DSNV429I V429 CALLING PROCEDURE=proc,
indicates that the -DISPLAY THREAD TYPE(INACTIVE) LOAD MODULE=loadmod,
report completed successfully. PROC=jclproc, ASID=asid,
WLM_ENV=wlmenv
The message number and subsystem recognition
character are not included in this message. Explanation: This message appears in the output of
the DISPLAY THREAD command when a thread is
System Action: Processing continues normally. running a stored procedure.
proc The name of the stored procedure the SQL
DSNV426I csect-name THREAD token HAS BEEN application is running.
CANCELED
loadmod
Explanation: This message is issued in response to The MVS load module associated with the
the CANCEL THREAD command. The thread is stored procedure. This field will contain blanks
scheduled for termination. until the load module name has been
determined.
System Action: The specified thread is scheduled for
termination. The termination of the thread does not jclproc The name of the JCL PROC used to start the
occur unless processing is occurring within DB2. address space where the stored procedure is
running. This field will contain blanks until the
stored procedure has been assigned to a
specific stored procedure address space.
Chapter 19. DB2 Messages 587
DSNV431I • DSNV436I
asid The MVS ASID of the address space where System Action: The command (or auto-resolution
the stored procedure is running. This field will processing) completes normally.
contain 0000 until the stored procedure has
been assigned to a specific stored procedure
DSNV435I action OF POSTPONED ABORT URS
address space.
HAS BEEN SCHEDULED
wlmenv The name of the WLM application environment
Explanation: This message is issued by the
where the stored procedure is running. If it is
RECOVER POSTPONED command, and also by
running in the DB2-established stored
automatic online backout processing (invoked by
procedure address space, this field will contain
restarting with system parameter LBACKOUT=AUTO). It
blanks.
indicates that postponed abort URs exist and their
System Action: The DISPLAY THREAD command backout processing will proceed asynchronously.
continues processing.
| ACTION
| Description of request
DSNV431I POSTPONED ABORT THREADS
| RESOLUTION
Explanation: This message precedes the listing of | Indicates that backout processing for the
Postponed Abort URs. | postponed units of recovery has been
| requested.
The series of messages DSNV431I, DSNV407I,
DSNV408I and DSNV432I provide the formatted report | CANCELLATION
for the -DISPLAY THREAD TYPE(POSTPONED) | Indicates that the CANCEL option was
command. The series also provides a section of the | specified on the RECOVER POSTPONED
formatted report for -DISPLAY THREAD TYPE(*). | command and that the backout process will be
| canceled.
DSNV432I DISPLAY POSTPONED ABORT System Action: The command (or auto-resolution
REPORT COMPLETE processing) completes normally.
Explanation: This message follows messages
DSNV431I and DSNV408I and indicates that the DSNV436I PGM=collection.package, SEC=section,
-DISPLAY THREAD TYPE(POSTPONED) report was STMNT=statement
completed successfully, or that the section of the
Explanation: This message appears in the output of a
-DISPLAY THREAD TYPE(*) report for Postponed Abort
DISPLAY THREAD report when a detail display is
URs has been completed successfully.
specified. If DB2 is currently processing an SQL
System Action: Processing continues normally. statement, this message identifies the program which
contains that statement and displays the SQL statement
being executed.
DSNV433I NO POSTPONED ABORT THREADS
FOUND FOR NAME = connection name collection
The collection ID associated with package. If
Explanation: The -DISPLAY THREAD command
the SQL statement being executed is
found no postponed abort URs for the named
associated with a DBRM that was directly
connection. This message is generated when the
bound as part of the plan, and is not
command requests information about threads for the
associated with a package, then collection is
given connection name currently residing within a
not applicable and is indicated by an asterisk
postponed abort state, but none currently exist within
(*).
this state.
package
System Action: Command processing continues.
The package or DBRM member.
section
DSNV434I csect-name NO POSTPONED ABORT
The SQL section number associated with the
THREADS FOUND
package or DBRM.
Explanation: This message is issued by the
statement
RECOVER POSTPONED command, automatic online
The SQL statement number associated with
backout processing (invoked by restarting with system
the package or DBRM.
parameter LBACKOUT=AUTO), and also by the
DISPLAY THREAD TYPE(POSTPONED) command. It
The message number and subsystem recognition
indicates that no postponed abort threads were found to
character are not included in this message. However,
process. The 'csect-name' is the name of the command
V436 is included in the message text to identify the
program CSECT that issued the message.
message.
588 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNV437I • DSNV445I
System Action: Command processing continues. The message number and subsystem recognition
character are not included in this message. However,
V443 is included in the message text to identify the
DSNV437I V437-WORKSTATION=wsname,
message.
USERID=user-id, APPLICATION NAME
=appl-name System Action: Command processing continues.
Explanation: This message appears in the output of a
DISPLAY THREAD report when a non-detail display is DSNV444I V444-luwid=token ACCESSING DATA AT.
specified. If the appropriate information is provided by
Explanation: This message follows a DSNV404I
the client system, this message is issued and identifies
message for each thread that was distributed to other
more specific information regarding the identity of the
locations when a nondetail display is specified. This
end-user associated with this thread.
message gives the logical-unit-of-work identifier for the
wsname distributed thread, followed by an equal sign (=) and a
The client end-user workstation name. token, which can be used in place of luw-id in any DB2
command that accepts luw-id as input. Message
If not provided by the client system, this field
DSNV446I follows with the names of the locations
contains an asterisk.
associated with this 'luw-id'.
user-id The client end-user user-id.
luwid=token
If not provided by the client system, this field The global logical unit of work id and the local
contains an asterisk. token that identifies the thread. If the thread
becomes indoubt, a new token is assigned for
appl-name the indoubt thread.
The client end-user application name.
If not provided by the client system, this field The message number and subsystem recognition
contains an asterisk. character are not included in this message. However,
V444 is included in the message text to identify the
statement message.
The SQL statement number associated with
the package or DBRM. System Action: Command processing continues.
This message number and subsystem recognition DSNV445I V445-luwid=token ACCESSING DATA
character are not included in this message. However, FOR location
V437 is included in the message text to identiy the
message. Explanation: This message follows a DSNV404I
message for a database access thread.This message
System Action: Command processing continues. displays the logical-unit-of-work identifier assigned to
the database access thread.
| DSNV439I csect-name NOBACKOUT OPTION luwid=token
| INVALID FOR THREAD ’token’ The global logical unit of work id and the local
| Explanation: This message is issued in response to token that identifies the thread. If the thread
| the CANCEL THREAD command with the becomes indoubt, a new token is assigned for
| NOBACKOUT option. The NOBACKOUT option will not the indoubt thread.
| be honored because the canceled thread is part of a location
| global transaction. Identifies the requesting site. The value
| System Action: The specified thread is not canceled. specified in location is one of the following:
v The relational database name of the
requester or the VTAM LU name of the
DSNV443I V443-PARALLELISM
requester (<luname>), a colon (″:″) delimiter,
COORDINATOR=member-name,
and the LU name of the requester for SNA
ORIGINATING TOKEN=token
connections.
Explanation: This message follows a DSNV404I v The dotted decimal IP address of the
message for each parallel task thread that is running on requester (nnn.nnn.nnn.nnn) for TCP/IP
an assisting DB2. This message gives the DB2 member connections.
name and the originating task's thread token.
member-name The message number and subsystem recognition
The coordinating DB2 member where the character are not included in this message. However,
originating task thread is running. V445 is included in the message text to identify the
message.
token The originating task thread token.
Chapter 19. DB2 Messages 589
DSNV446I • DSNV448I
System Action: Command processing continues. The message number and subsystem recognition
character are not included in this message. However,
V447 is included in the message text to identify the
DSNV446I V446--location-i location-j ...
message.
Explanation: This message is a continuation of
System Action: Processing continues normally.
message DSNV444I or message DSNV450I and
provides a list of 'location-i'.
DSNV448I V448--location sessid active status time
location-i
Identifies the name of a remote DBMS at which Explanation: This message follows the DSNV447I
data is being accessed or where a thread is message for a database access thread or distributed
indoubt. allied thread when a detail display is specified. This
message is displayed for each conversation connected
The location-i string includes two or three
to the thread. It lists detailed information about the
tokens delimited by a colon (″:″):
conversations associated with the thread.
v The first token is the partner location name.
location
v The second token is the partner LU name
If displaying an allied thread, the location is the
for an SNA connection, or the dotted
name of the server; otherwise, it is the name of
decimal IP address for a TCP/IP connection
the requester. The name can be any of the
(nnn.nnn.nnn.nnn).
following: the relational database name of the
v The third token only appears if the second partner, the VTAM LU name of the partner
token is an IP address in which case the (<luname>), or the dotted decimal IP address
third token is a port number. of the partner (nnn.nnn.nnn.nnn).
When the message appears after message
sessid There are two possible values for this field:
DSNV450I, the port number represents a
resync port number. Otherwise the message v For VTAM partners, this field contains the
appears after a DSNV444I message in VTAM-defined session instance identifier of
which case it represents an SQL port the session on which the conversation is
number. executing. Zeros if the session identifier is
not applicable.
A 'location-i' identifier is repeated for each VTAM does not supply the entire session id
DBMS where data is being accessed or where to DB2. The first two digits of the session id
a thread is indoubt. are incorrect. Therefore, the session id as
presented in this message is not acceptable
The message number and subsystem recognition in VTAM commands. The VTAM DISPLAY
character are not included in this message. However, NET,ID=db2-luname,SCOPE=ACT command
V446 is included in the message text to identify the must be used to obtain the full session ID.
message. The DISPLAY NET command lists all
sessions (SID) for the DB2 logical unit. Scan
System Action: Command processing continues. the DISPLAY NET output for the complete
SID.
DSNV447I V447--LOCATION SESSID A ST TIME v For TCP/IP connections, this field contains
the local DB2 TCP/IP port number, followed
Explanation: This message forms the heading for the
by the partner’s TCP/IP port number. The
listing of distributed active or inactive threads in
two port numbers are separated by a colon
message DSNV448I. Items in this part of the heading
(e.g 5001:28191).
are:
active One of the following:
LOCATION
Heading for the associated location names V The conversation is active within
VTAM or TCPIP.
SESSID
Heading for the associated VTAM-defined W The conversation is suspended in
session identifiers DB2 waiting for VTAM or TCP/IP
notification that the function is
A Heading for the associated active indicators
complete.
ST Heading for the associated status indicators
Blank, otherwise.
TIME Heading for the associated time stamps
status Status of the conversation.
See message DSNV448I for descriptions of these items. This information is presented as two
characters, each of which has significance.
590 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNV449I • DSNV451I
First Character
DSNV449I V449-HAS NID=nid AND ID=correlation-id
A Conversation in allocation.
Explanation: This message is a detail line, which
C Session limits are being negotiated might be displayed with a DISPLAY THREAD TYPE
with the partner (CNOS) prior to (INDOUBT) report.
conversation allocation.
nid The network-id assigned by IMS or CICS or, if
D Conversation in deallocation. the connection type is RRSAF, the OS/390
RRS unit of recovery ID (URID)
R Receiving
v At the requesting site, this indicates correlation-id
that the conversation is receiving a The correlation-id assigned by IMS or CICS or
response from a request. if the connection type is RRSAF, the
correlation-id assigned by the connected
v At the server site, this indicates that application
the conversation is receiving or
waiting for a request.
The message number and subsystem recognition
S Sending character are not included in this message. However,
v At the requesting site, this indicates V449 is included in the message text to identify the
that the conversation can send message.
requests to the server. System Action: Processing continues normally.
v At the server site, this indicates that
the conversation is sending or
DSNV450I V450-HAS PARTICIPANT INDOUBT AT
preparing to send a response.
Explanation: This message is a detail line which
X Exchanging log name information with
might be displayed with a DISPLAY THREAD TYPE
the partner before conversation
(INDOUBT) report. This message is followed by one or
allocation to determine if the partner
more DSNV446I messages that name the ’locations’
supports protected conversations. If
where indoubt participant threads are located. The
the thread remains in this status for
’luwid’ of the indoubt thread is displayed in the
an extended period of time, the DB2
preceding DSNV408I message.
service task that exchanges log
names might be busy processing The message number and subsystem recognition
other requests. The DB2 DISPLAY character are not included in this message. However,
LOCATION command (’DISPLAY V450 is included in the message text to identify the
LOCATION(*) DETAIL’) shows you message.
conversation activity for this
System Action: The thread remains indoubt and
(RESYNC) service task.
processing continues normally.
Blank, otherwise.
Operator Response: See message DSNL406I for
Second Character more information. The indoubt participants displayed
can also result from an abnormal termination of this
1 Unprotected conversation using
DB2 subsystem.
system-directed access is active.
2 Unprotected conversation using
DSNV451I V451-RESYNC WITH COORDINATOR
application-directed access is active.
STILL PENDING
3 Protected conversation using
Explanation: This message is a detail line which
system-directed access is active.
might be displayed with a DISPLAY THREAD TYPE
4 Protected conversation using (INDOUBT) report. When an indoubt thread is manually
application-directed access is active. resolved with the RECOVER INDOUBT command, this
message is included in the report if indoubt resolution
Blank otherwise. with the coordinator was not complete. The ’coordinator’
time The time stamp (yydddhhmmssth) of the last and the ’luwid’ of the indoubt thread are displayed in the
message sent or received on the conversation. previous DSNV408I message.
The message number and subsystem recognition
The message number and subsystem recognition character are not included in this message. However,
character are not included in this message. However, V451 is included in the message text to identify the
V448 is included in the message text to identify the message.
message.
System Action: The thread remains indoubt and
System Action: Command processing continues
Chapter 19. DB2 Messages 591
DSNV452I • DSNV457I
processing continues normally.
DSNV454I LOCATION OR LUWID KEYWORD
INVALID WHEN DDF NOT STARTED
DSNV452I V452-HEURISTIC COMMIT BY
Explanation: The -DISPLAY THREAD TYPE(ACTIVE)
PARTICIPANT AT LOCATION location
command was issued with the keyword LOCATION or
Explanation: This message is a detail line which LUWID and it was found that the distributed data facility
might be displayed with a DISPLAY THREAD TYPE (DDF) was not started. The LOCATION or LUWID
(INDOUBT) report. A decision was made at the keyword can be used only if DDF is in operation.
participant to force the indoubt thread to commit without
System Action: Command processing is complete.
waiting for automatic resynchronization to be performed.
The ’luwid’ of the thread is displayed in the preceding
DSNV408I message. DSNV456I INVALID PARAMETER WITH LUWID
KEYWORD luwid-parameter
location
The ’location’ where the HEURISTIC COMMIT Explanation: The -DISPLAY THREAD TYPE(ACTIVE),
was performed. The ’location’ is either the -DISPLAY THREAD TYPE(INACTIVE), or the
relational database name (location-name), the -RECOVER INDOUBT command was issued with the
logical unit name (<luname>), or the dotted keyword LUWID and its required parameter list.
decimal IP address (nnn.nnn.nnn.nnn) of the However, one of the parameters was syntactically
participant. invalid as a logical-unit-of-work identifier.
System Action: Command processing is complete.
The message number and subsystem recognition
character are not included in this message. However, Operator Response: The syntax of the DISPLAY
V452 is included in the message text to identify the THREAD and RECOVER INDOUBT commands is
message. described in DB2 Command Reference. Reenter the
command specifying valid LUWID values.
System Action: Processing continues normally.
Operator Response: See message DSNL402E for
DSNV457I V457-RESYNC PROTOCOL ERROR
more information.
WITH PARTICIPANT location
Explanation: This message is a detail line which
DSNV453I V453-HEURISTIC ABORT BY
might be displayed with a DISPLAY THREAD TYPE
PARTICIPANT AT LOCATION location
(INDOUBT) report. Manual resolution of an indoubt
Explanation: This message is a detail line which thread at the participant location might be required. A
might be displayed with a DISPLAY THREAD TYPE protocol error was detected during attempted automatic
(INDOUBT) report. A decision was made at the indoubt resolution with the participant. The ’luwid’ of the
participant to force an indoubt thread to abort without thread that might require manual resolution at the
waiting for automatic resynchronization to be performed. participant is displayed in the preceding DSNV408I
The ’luwid’ of the thread that was forced to abort is message.
displayed in the preceding DSNV408I message.
location
location The ’location’ where manual resolution might
The ’location’ where the HEURISTIC ABORT be needed. The ’location’ is either the relational
was performed. The ’location’ is either the database name (location-name) of the
relational database name (location-name), the participant or the logical unit name (<luname>)
logical unit name (<luname>), or the dotted of the participant.
decimal IP address (nnn.nnn.nnn.nnn) of the
participant. The message number and subsystem recognition
character are not included in this message. However,
The message number and subsystem recognition V457 is included in the message text to identify the
character are not included in this message. However, message.
V453 is included in the message text to identify the
System Action: Processing continues normally.
message.
Operator Response: See message DSNL414E for
System Action: Processing continues normally.
more information.
Operator Response: See message DSNL403E for
more information.
592 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNV458I • DSNV462I
that might require manual resolution at the participant is
DSNV458I V458-CONNECTION-NAME
displayed in the preceding DSNV408I message.
connection-name CORRELATION-ID
correlation-id location
The ’location’ where manual resolution might
Explanation: This message is a detail line which
be needed. The ’location’ is either the relational
might be displayed with a DISPLAY THREAD TYPE
database name (location-name) of the
(INDOUBT) report. It is displayed only if message
participant or the logical unit name (<luname>)
DSNV463I is also displayed.
of the participant.
connection-name
The connection-name assigned by the The message number and subsystem recognition
coordinator if the coordinator is another DB2 character are not included in this message. However,
system. The constant SERVER if the V460 is included in the message text to identify the
coordinator is not a DB2 system. message.
correlation-id System Action: Processing continues normally.
The correlation-id assigned by the coordinator
if the coordinator is another DB2 system. The Operator Response: See message DSNL413I for
first 12 characters of the EXTNAME parameter more information.
of the EXCSAT command sent by the
coordinator if the coordinator is not a DB2 DSNV461I V461-RESYNC WITH COORDINATOR
system. SHOWS HEURISTIC DAMAGE
The message number and subsystem recognition Explanation: This message is a detail line which
character are not included in this message. However, might be displayed with a DISPLAY THREAD TYPE
V458 is included in the message text to identify the (INDOUBT) report. Indoubt resolution with the
message. coordinator completed. Heuristic damage was detected
at this location because the heuristic decision made at
System Action: Processing continues normally. this location is different than the decision made at the
coordinator. The ’coordinator’ and the ’luwid’ of the
Operator Response: See message DSNV463I for
thread are displayed in the previous DSNV408I
more information.
message. The ’status’ field in the previous DSNV408I
message shows the heuristic decision made at this
DSNV459I V459-SYNCPOINT PROTOCOL ERROR location. This message continues to appear until it is
WITH COORDINATOR deleted with a RESET INDOUBT command.
Explanation: This message is a detail line which The message number and subsystem recognition
might be displayed with a DISPLAY THREAD TYPE character are not included in this message. However,
(INDOUBT) report. Manual resolution of an indoubt V461 is included in the message text to identify the
thread at this location is required. A protocol error was message.
detected during sync point processing with the
System Action: The thread remains indoubt and
coordinator. The ’coordinator’ and the ’luwid’ of the
processing continues normally.
thread that requires manual resolution are both
displayed in the preceding DSNV408I message. Operator Response: See message DSNL400E and
DSNL401E for more information.
The message number and subsystem recognition
character are not included in this message. However,
V459 is included in the message text to identify the DSNV462I V462-COLD START BY PARTICIPANT
message. AT LOCATION location
System Action: Processing continues normally. Explanation: This message is a detail line which
might be displayed with a DISPLAY THREAD TYPE
Operator Response: See message DSNL412I for
(INDOUBT) report. There was an indoubt thread at the
more information.
participant whose ’luwid’ is displayed in the preceding
DSNV408I message. DB2 has coordinator responsibility
DSNV460I V460-SYNCPOINT PROTOCOL ERROR for the indoubt thread and the participant informed DB2
WITH PARTICIPANT location that it performed a cold start operation and lost all
knowledge of indoubt threads. There might be heuristic
Explanation: This message is a detail line which
damage at the participant. The RESET INDOUBT
might be displayed with a DISPLAY THREAD TYPE
command must be used to purge this message from the
(INDOUBT) report. Manual resolution of an indoubt
indoubt report. The reason for this is that the
thread at the participant location might be required. A
cold-starting participant might have been coordinating
protocol error was detected during sync point
downstream participants that are now indoubt. The
processing with the participant. The ’luwid’ of the thread
database administrator at these participants might need
Chapter 19. DB2 Messages 593
DSNV463I • DSNV466I
to know the status of the thread at the coordinator, so
DSNV465I V465-THREAD HAS REMAINED IN A
that correct heuristic decisions can be made.
PREPARED STATE FOR hh:mm:ss
location
Explanation: This message might be displayed with a
The ’location’ where the cold start was
DISPLAY THREAD TYPE (ACTIVE) report. The thread
performed. The ’location’ is either the relational
was ’prepared’ for the specified period of time. This
database name (location-name), the logical unit
means that DB2 is the participant in the logical unit of
name (<luname>), or the dotted decimal IP
work and completed the first phase of commit and is
address (nnn.nnn.nnn.nnn) of the participant.
waiting for the commit or abort decision to be
transmitted from the coordinator for the specified period
The message number and subsystem recognition of time. The thread is identified in the preceding
character are not included in this message. However, DSNV404I message. This message does not appear in
V462 is included in the message text to identify the a report until the thread was in the prepared state for 60
message. seconds.
System Action: Processing continues normally. hh:mm:ss
Operator Response: See message DSNL420E for The length of time the thread was prepared
more information. (expressed in hours, minutes and seconds).
The maximum number of hours reported is
65535, which is roughly 7.5 years. After this
DSNV463I V463-COORDINATOR HAS COLD time period elapses, the count is reset to zero.
STARTED
Explanation: This message is a detail line which The following actions might be taken to resolve this
might be displayed with a DISPLAY THREAD TYPE thread by manual means (that is, take heuristic action) if
(INDOUBT) report. Manual resolution of an indoubt it is necessary to release locks held by this thread.
thread at this location is required. The coordinator for a v Use the -CANCEL DDF THREAD command to force
thread that is indoubt at DB2 was cold started and the thread from the prepared state to the indoubt
therefore lost all knowledge of indoubt threads. The state. When the thread is indoubt, it appears in the
’coordinator’ and the ’luwid’ of the thread for which display generated by issuing the DISPLAY THREAD
manual resolution is required are displayed in the command for type indoubt threads.
preceding DSNV408I message. v Determine the proper decision (commit or abort) by
The message number and subsystem recognition contacting the coordinator ’location’ shown in the
character are not included in this message. However, display of indoubt threads.
V463 is included in the message text to identify the v Use the RECOVER INDOUBT command to
message. heuristically commit or abort the thread.
System Action: Processing continues normally.
The message number and subsystem recognition
Operator Response: See message DSNL411I for character are not included in this message. However,
more information. V465 is included in the message text to identify the
message.
DSNV464I V464-RESYNC PROTOCOL ERROR
WITH COORDINATOR This message is issued by the following CSECT:
DSNVDTM
Explanation: This message is a detail line which
might be displayed with a DISPLAY THREAD TYPE System Action: Processing continues normally.
(INDOUBT) report. Manual resolution of an indoubt
thread at this location is required. A protocol error was DSNV466I V466-THREAD HAS BEEN INDOUBT
detected during attempted automatic indoubt resolution FOR hh:mm:ss
with the coordinator. The ’coordinator’ and the ’luwid’ of
the thread that requires manual resolution are both Explanation: This message is a detail line which
displayed in the preceding DSNV408I message. might be displayed with a DISPLAY THREAD TYPE
(INDOUBT) report. The thread entered the indoubt state
The message number and subsystem recognition at the specified time. This means that DB2 is the
character are not included in this message. However, participant in the logical unit of work and completed the
V464 is included in the message text to identify the first phase of commit and is waiting for the commit or
message. abort decision to be transmitted from the coordinator.
System Action: Processing continues normally. However, DB2 lost communications with the coordinator.
The thread is identified in the preceding DSNV408I
Operator Response: See message DSNL404E for message.
more information.
594 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNV467I • DSNV475I
hh:mm:ss This message is issued by the following CSECT:
The length of time the thread was indoubt DSNVDTM
(expressed in hours, minutes and seconds).
System Action: Command processing continues.
The maximum number of hours reported is
65535, which is roughly 7.5 years. After this
time period elapses, the count is reset to zero. DSNV473I ACTIVE THREADS FOUND FOR
MEMBER: memname-
The following actions might be taken to resolve this
Explanation: This message precedes the listing of
thread by manual means (that is, take heuristic action) if
active threads found on another member of a data
it is necessary to release locks held by this thread.
sharing group as the result of the SCOPE(GROUP)
v Determine the proper decision (commit or abort) by keyword.
contacting the coordinator ’location’ shown in the
display of indoubt threads. Message DSNV473I and the series of messages
DSNV403I through DSNV405I provide the formatted
v Use the RECOVER INDOUBT command to
report for the -DISPLAY THREAD TYPE(ACTIVE)
heuristically commit or abort the thread.
SCOPE(GROUP) when the status of active threads is
requested.
The message number and subsystem recognition
character are not included in this message. However, The series of messages DSNV444I through DSNV448I
V466 is included in the message text to identify the augment the formatted report for the -DISPLAY
message. THREAD TYPE(ACTIVE) SCOPE(GROUP) when
LOCATION, LUWID, or DETAIL keywords are used to
System Action: Processing continues normally.
show distributed activity.
memname
DSNV467I V467-HAS LUWID luwid=token
Member name for which thread information is
Explanation: This message is a detail line, which being displayed.
might be displayed with a DISPLAY THREAD TYPE
System Action: Processing continues normally.
(INDOUBT) report.
luwid=token
DSNV474I INDOUBT THREADS FOUND FOR
The global logical unit of work id and the local
MEMBER: memname-
token that identifies the thread.
Explanation: This message precedes the listing of
The message number and subsystem recognition indoubt threads found on member memname as the
character are not included in this message. However, result of the SCOPE(GROUP) keyword.
V467 is included in the message text to identify the
Messages DSNV474I, DSNV403I, DSNV404I and
message.
DSNV409I provide the formatted report for the
System Action: Processing continues normally. -DISPLAY THREAD TYPE(INDOUBT) SCOPE(GROUP)
command when the status of indoubt threads is
requested.
DSNV471I V471-luwid=token
memname
Explanation: This message follows a DSNV404I Member name for which thread information is
message and indicates the agent is currently not being displayed.
associated with a remote location. The agent is
available to be assigned to process; System Action: Processing continues normally.
v the completion of a queued receive request on a type
2 inactive thread, or
DSNV475I INACTIVE THREADS FOUND FOR
v a request that a new connection be established, after
MEMBER: memname-
MAX REMOTE ACTIVE has been reached.
Explanation: This message precedes the listing of
This message displays the logical-unit-of-work identifier
inactive threads found on member memname as the
assigned to the agent.
result of SCOPE(GROUP) keyword.
luwid=token
Messages DSNV475I, DSNV403I, DSNV404I and
The global logical unit of work id and the local
DSNV425I provide the formatted report for the
token that identifies the agent.
-DISPLAY THREAD TYPE(INACTIVE) SCOPE(GROUP)
when the status of inactive threads is requested.
The message number and subsystem recognition
character are not included in this message. However, The series of messages DSNV444I through DSNV448I
V471 is included in the message text to identify the augment the formatted report for the -DISPLAY
message. THREAD TYPE(INACTIVE) SCOPE(GROUP) when
Chapter 19. DB2 Messages 595
DSNV476I • DSNV481I
LOCATION, LUWID, or DETAIL keywords are used to
| DSNV480I V480-DB2 IS PARTICIPANT FOR RRS
show idle distributed threads.
| URID=rrs-urid
memname
| Explanation: This message is a detail line that could
Member name for which thread information is
| be displayed with a DISPLAY THREAD TYPE(ACTIVE)
being displayed.
| report when the Recoverable Resource Services Unit of
System Action: Processing continues normally. | Recovery ID (RRS URID) keyword is specified on the
| command. The RRS URID=rrs-urid identifies the RRS
| URID of the RRS Unit of Recovery that this thread is a
DSNV476I POSTPONED ABORT THREADS | participant in.
FOUND FOR MEMBER: memname
| The message number and subsystem recognition
Explanation: This message precedes the listing of | character are not included in this message. However,
Postponed Abort units of recovery found on another | V480 is included in the mesage text to identify the
member of a data sharing group as the result of the | message.
SCOPE(GROUP) keyword.
| System Action: Command processing continues
Messages DSNV476I, DSNV403I, DSNV404I and | normally.
DSNV432I provide the formatted report for the
-DISPLAY THREAD TYPE(POSTPONED)
SCOPE(GROUP) command. | DSNV481I V481-DB2 IS COORDINATOR FOR RRS
| URID=rrs-urid
memname
Member name for which thread information is | Explanation: This message is a detail line that could
being displayed. | be displayed with a DISPLAY THREAD TYPE(ACTIVE)
| report when the Recoverable Resource Services Unit of
System Action: Processing continues normally. | Recovery ID (RRS URID) keyword is specified on the
| command. The RRS URID=rrs-urid identifies the RRS
DSNV478I SCOPE(GROUP) DISPLAY | URID of the RRS Unit of Recovery that this thread is a
TERMINATED DUE TO IRLM | coordinator for.
TRUNCATION | This message is a detail line that also could be
Explanation: This message displays as a result of the | displayed with a DISPLAY TYPE(INDOUBT) report
-DISPLAY THREAD command when the | when the RRSURID keyword is specified on the
SCOPE(GROUP) keyword is specified and IRLM has | command. The RRS URID=rrs-urid identifies the RRS
truncated the responses gathered from other members. | URID of the RRS Unit of Recovery that this thread is a
This is a DB2 internal error. | coordinator for. When this message appears in an
| INDOUBT thread report, the preceding DSNV408I
System Action: The -DISPLAY THREAD report is | message tells the status of the DB2 Unit of Recovery
terminated and processing abnormally terminates. | that contains the RRS Unit of Recovery. If manual
Operator Response: Notify the system programmer. | recovery of the RRS Unit of Recovery is required, the
| outcome of the DB2 Unit of Recovery can determine
System Programmer Response: Refer to Part 2 of | whether to COMMIT or ROLLBACK the RRS Unit of
DB2 Diagnosis Guide and Reference for information on | Recovery.
identifying and reporting the problem.
| The message number and subsystem recognition
Problem Determination: This is an internal error. | character are not included in this message. However,
| V481 is included in the message text to identify the
DSNV479I SCOPE(GROUP) DATA UNAVAILABLE | message.
IRLM RETURN CODE: retcode IRLM | System Action: Command processing continues
REASON DATA: reason | normally.
Explanation: This message displays as a result of the
-DISPLAY THREAD command when the
SCOPE(GROUP) keyword is specified and the IRLM
NOTIFY to other members has returned a bad return
code.
retcode Return code from IRLM on the Notify request.
reason Reason code diagnostic information from IRLM
on the Notify request.
596 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 20. DSNW... Messages
DSNW001I ASYNCHRONOUSLY GATHERED DATA DSNW006I THE ERLY BLOCK CANNOT BE
IS BEING FORMATTED IN THIS DUMP ACCESSED OR IT IS INVALID
Explanation: The subsystem formatting exit is not Explanation: The subsystem formatting exit could not
using DB2 summary dump records for formatting. The locate its anchor block.
formatted control blocks may not contain the same
System Action: Control returns to AMDPRDMP or
values as they did at the time of the error.
IPCS to terminate the exit.
System Action: Dump formatting continues.
System Programmer Response: Specify
System Programmer Response: If you want DB2 'SUBSYS=subsystem name', 'SUMDUMP=NO' on the
summary dump records to be used, do not specify the dump control statement. The subsystem name should
'SUMDUMP=NO' operand on the dump control have between 1 and 4 characters.
statement.
DSNW007I THE FOLLOWING OPERAND
DSNW002I SUMMARY DUMP RECORDS ARE SPECIFIED ON THE DSNWDMP
BEING FORMATTED IN THIS DUMP CONTROL CARD IS INVALID: xxxx
Explanation: The subsystem formatting exit is using Explanation: The specified operand was not one of
DB2 summary dump record information to format its the valid dump control statement operands.
control blocks.
System Action: Control returns to AMDPRDMP or
System Action: Dump formatting continues. IPCS to terminate the exit.
System Programmer Response: If you do not want System Programmer Response: Check the dump
DB2 summary dump records to be used in formatting, control statement operands.
specify the 'SUMDUMP=NO' and 'SUBSYS=subsystem
name' on the dump control statement. Both operands
DSNW008I THE SCOM CANNOT BE ACCESSED
are required.
OR IT IS INVALID
Explanation: An error was encountered while trying to
DSNW004I ONE OR MORE INVALID OPERANDS
retrieve the SCOM.
WERE FOUND ON THE DSNWDMP
CONTROL CARD. SUBSYSTEM System Action: Control returns to AMDPRDMP or
FORMATTING TERMINATED IPCS to terminate the exit.
Explanation: An invalid operand was found on the System Programmer Response: If 'SUMDUMP=NO'
dump control statement. The operand was not 'SG', was specified on the dump control statement, omit this
'LG', 'SA', 'AA', or 'ALL'. operand, and resubmit the job. Otherwise, specify this
operand on the dump control statement, and resubmit
System Action: Control returns to AMDPRDMP or
the job.
IPCS to terminate the exit.
System Programmer Response: Correct the dump
DSNW009I THE ADDRESS SPACE REQUESTED IS
control statement operand specified by message
NOT AVAILABLE
DSNW007I.
Explanation: The DB2 control blocks for the address
space specified on the 'SA=asid' dump operand could
DSNW005I DUMP FORMATTER WORK BUFFER
not be located.
(DSNWDBUF) CANNOT BE LOCATED
System Action: Formatting continues if other dump
Explanation: The subsystem formatting exit could not
operands were specified.
locate its work buffer.
System Programmer Response: Check the ASID
System Action: Control returns to AMDPRDMP or
specified on the 'SA=' dump operand. The ASID must
IPCS to terminate the exit.
be specified in hexadecimal.
System Programmer Response: Increase the region
size.
DSNW010I THE TRACE RMFT CANNOT BE
ACCESSED OR IT IS INVALID
Explanation: The DB2 trace table could not be
located.
© Copyright IBM Corp. 1982, 2001 597
DSNW011I • DSNW020I
System Action: Formatting of the DB2 trace table is subsystem name on the control statement was not
bypassed, and formatting continues of any other found.
requested dump segment.
System Action: Formatting for the named subsystem
System Programmer Response: If 'SUMDUMP=NO' is not done.
was specified on the dump control statement, omit this
Operator Response: Check the 'SUBSYS=' operand
operand. Otherwise, specify this operand on the dump
on the control statement.
control statement. In either case, resubmit the job.
System Programmer Response: Correctly specify the
subsystem name on the control statement.
DSNW011I A LARGER REGION SIZE IS REQUIRED
FOR THIS JOB
DSNW016I THE RMVT CANNOT BE ACCESSED
Explanation: The subsystem formatting exit could not
OR IT IS INVALID
obtain a large enough work buffer to process the
summary dump records. Explanation: The subsystem formatting exit could not
locate the RMVT. The RMVT is required for formatting
System Action: Subsystem formatting continues.
the DB2 trace table and a number of other DB2 control
System Programmer Response: Rerun the job, blocks.
specifying a larger region size in the JCL.
System Action: Formatting of the DB2 trace table is
bypassed, and formatting of other requested dump
DSNW013I DMPW NOT FOUND IN SUMMARY segments continues.
DUMP
System Programmer Response: If 'SUMDUMP=NO'
Explanation: The subsystem formatting exit was was specified on the dump control statement, omit this
unable to locate the DMPW control block in the operand. Otherwise, try specifying this operand on the
summary record portion of the dump data set. Because dump control statement. In either case, resubmit the
the DMPW provides the main anchor block for the dump job.
formatter, processing is terminated.
System Action: Control returns to AMDPRDMP or DSNW017I MAXIMUM STACK LEVEL EXCEEDED
IPCS to terminate the exit.
Explanation: This condition is usually caused by the
System Programmer Response: If this is not a DB2 DB2 control block formatter looping. The stack array is
dump data set, specify 'SUBSYS=xxxx,SUMDUMP=NO' depleted and can no longer accommodate control
on the dump control statement (where xxxx is the 1- to blocks.
4-character subsystem name), so that the subsystem
System Action: Dump formatting is terminated.
formatting exit does not attempt to use summary dump
data. System Programmer Response: Examine the control
block chains to see if they are looping. If those chains
are not looping, increase the dimension of the stack
DSNW014I REQUIRED SUMMARY DUMP
array.
RECORDS ARE NOT IN THIS DUMP.
WILL ATTEMPT TO FORMAT FROM
NON- SUMMARY DUMP DSNW018I SUBSYS= NOT SPECIFIED ON THE
CONTROL CARD OR MISSING.
Explanation: Expected data could not be found in the
REQUIRED IF SUMDUMP=NO
summary dump. This message is issued for information
SPECIFIED
only. Dump formatting continues. However, it will take
longer, because a greater volume of data COMMAND Explanation: The 'SUMDUMP=NO' option was
PQUIT must be analyzed. specified, but either the 'SUBSYS=' operand is missing,
or it was incorrectly specified.
System Action: Formatting is attempted using the full
dump instead of the summary dump. System Action: Dump formatting is terminated.
System Programmer Response: Though processing Operator Response: Run the dump printing job after
continues, this message is an indication of a problem, the error has been corrected.
and should be pursued as such.
DSNW020I UNSUCCESSFUL SEARCH FOR THE
DSNW015I SSCVT NOT LOCATED. CHECK THE ERLY CONTROL BLOCK
SUBSYSTEM NAME ON THE CONTROL
CARD Explanation: The 'ERLY' control block could not be
located in the dump.
Explanation: In a search through the SSCVT chain, a
match of the subsystem name in the SSCVTs and the System Action: Dump formatting is terminated.
598 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNW022I • DSNW035I
Operator Response: Check that the 'SUBSYS='
DSNW029I CONTROL BLOCK SUMMARY (SHORT
operand was correctly specified, and rerun the job.
FORM GLOBAL)
System Programmer Response: This message can
Explanation: Messages DSNW026I through
mean that the 'ERLY' control block has been overlaid.
DSNW029I provide descriptive information regarding the
Examine the full dump to determine whether the
type of formatting being produced.
subsystem is present. If it is, you may be able to
determine why the control block could not be located. System Action: Dump formatting continues.
DSNW022I THE RESIDENT TRACE WAS NOT DSNW030I DUMP ACCESS ERROR ACCESSING
ACTIVE AT THE TIME OF DUMP THE CONTROL BLOCK STRUCTURE
TABLE IN THE DUMP
Explanation: Trace table formatting has been
attempted, but no trace table existed at the time of the Explanation: The control block structure table cannot
dump. be accessed from the dump.
System Action: Dump formatting continues with any System Action: Control block formatting is terminated.
other control blocks that were to be formatted.
Operator Response: Notify the system programmer.
System Programmer Response: If you suspect an
DSNW023I THE TRACE TABLE ENTRY IS OUT OF
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
SEQUENCE OR OVERLAID
and Reference for information on identifying and
Explanation: A trace entry is overlaid by another trace reporting the problem.
entry of a different timestamp. This message is issued
to flag an unrecognized trace entry. This can occur
DSNW032I DUMP ACCESS ERROR ACCESSING
when the oldest entry in the table is the second half of a
ANCHOR CONTROL BLOCK
double entry.
Explanation: The anchor control block cannot be
System Action: Formatting of the trace table
accessed from the dump.
continues.
System Action: Control block formatting is terminated.
DSNW024I TRACE TABLE Operator Response: Notify the system programmer.
Explanation: The trace table follows. System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
System Action: Trace table formatting follows.
and Reference for information on identifying and
reporting the problem.
DSNW025I DUMP ACCESS ERROR ACCESSING
THE TRACE TABLE IN THE DUMP
DSNW033I BEGINNING FORMATTING
Explanation: A nonzero return code was returned
Explanation: Formatting of DB2 control blocks is
from the storage access routine when accessing the
beginning.
trace table.
System Action: Trace table formatting is bypassed.
DSNW034I TRACE TABLE AND GLOBAL BLOCKS
System Programmer Response: Check the address ALREADY DUMPED
and ASID of the trace table.
Explanation: An indicative dump is being requested.
The DB2 trace table and the global blocks have already
DSNW026I CONTROL BLOCK SUMMARY (ALL been dumped with first dump (full dump) for this abend
ADDRESS SPACES) dump (SNAP) invocation. These are, therefore, not
dumped in the dump for this task.
DSNW027I CONTROL BLOCK SUMMARY (SINGLE
ADDRESS SPACE) DSNW035I WARNING – NO TASK RELATED
CONTROL BLOCKS FOR THIS TASK
DSNW028I CONTROL BLOCK SUMMARY (LONG Explanation: The TCB for which the dump is being
FORM GLOBAL) requested is not IDENTIFIED to DB2. Task-related
control blocks are not dumped. The DB2 trace table and
global blocks are dumped only if the 'SYSABEND' DD
statement is present and only if this is the first of the
dump(s) (full dump) for this abend dump (SNAP)
invocation.
Chapter 20. DB2 Messages 599
DSNW036I • DSNW041I
System Action: No DB2 formatting is done for the hexadecimal values associated with the 'VVV=XX'
specified task. keyword. This keyword is provided on the title line of
each control block selected for formatting. It indicates
any unusual conditions encountered during the
DSNW036I CONTROL BLOCKS FOR TASKS
validation and format processing of the current control
ASSOCIATED WITH THE ABOVE
block structure.
RECOVERY COORDINATOR TASK
System Action: Dump formatting continues.
Explanation: The formatted blocks following this
message are associated with TCBs that have System Programmer Response: All nonzero 'XX'
IDENTIFIED to DB2 with the 'recovery coordinator = no' values should be examined. If an error is indicated, the
option. These TCBs may not have invoked SNAP, but printout of the dump should be used for the problem
they are associated with the TCB that did. documentation.
System Action: Related control blocks are dumped. Problem Determination: Possible errors include:
v X'80'
System Programmer Response: Examine the control
v X'40'
blocks for relevant information.
v X'20'
v X'04'
DSNW037I TASK RELATED CONTROL BLOCKS
FOR THIS TASK The current state of the individual control block
structures at the time of error might vary with the type of
Explanation: The formatted blocks following this
error involved. Examine control block structures with
message are associated with the TCB that is being
one of these 'XX' values based on the specific ABEND
dumped.
code.
System Action: Relevant control blocks are dumped.
Example: A X'04' associated with the referencing control
System Programmer Response: Examine the control
block and the X'20' associated with the referenced
blocks for relevant information.
control block may mean the ABEND occurred between
the release of the referenced control block and
DSNW038I END OF FORMATTING re-initialization of the address within the referencing
one.
Explanation: Formatting of DB2 control blocks is
completed.
DB2 validation errors include:
v X'10'
DSNW039I SUBSYSTEM FORMATTING v X'08'
COMPLETE FOR THIS DUMP v X'02'
v X'01'
Explanation: The subsystem formatting routine has
completed its processing for this dump data set.
These values indicate that a validation error occurred
while formatting the associated control block.
DSNW040I 'VVV'CONTROL BLOCK FORMATTER
ERROR FLAGS For example, an X'08' associated with the referenced
control block indicates the storage area has been
:
overlaid or the address in the referencing control block
v X'80': FIELD EXPECTED TO BE ZERO IS is incorrect. Subsequent examination of the values in
NONZERO this control block is not reliable.
v X'40': LAST BLOCK IN CHAIN DOES NOT POINT
BACK TO PARENT BLOCK
DSNW041I THE TAB CANNOT BE ACCESSED OR
v X'20': BLOCK NOT FOUND IN DUMP IT IS INVALID
v X'10': BLOCK LENGTH INCORRECT
Explanation: The DB2 trace table anchor block could
v X'08': VERIFICATION CODE INCORRECT not be located.
v X'04': BLOCK CHAINED FROM THIS BLOCK NOT
System Action: Formatting of the DB2 trace table is
FOUND IN DUMP
bypassed, and formatting of any other requested dump
v X'02': BLOCK CHAINED FROM THIS BLOCK HAS segment continues.
WRONG VERIFICATION CODE
System Programmer Response: If 'SUMDUMP=NO'
v X'01': VALIDATION CONSTANT DOES NOT MATCH
was specified on the dump control statement, omit this
EXPECTED VALUE
operand. Otherwise, specify this operand on the dump
Explanation: The message DSNW040I appears at the control statement. In either case, resubmit the job.
beginning of a formatted dump. It defines the
600 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNW049I • DSNW053I
If you suspect an error in DB2, refer to Part 2 of DB2 recovery routine. The primary reason for an SDWA not
Diagnosis Guide and Reference for information on being provided to an ESTAE routine is insufficient
identifying and reporting the problem. storage available during recovery processing. Examine
the region sizes allocated to the failing function to
Problem Determination: Collect the following
ensure that sufficient storage is available.
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 1, 2, 5. In a nonrecovery environment, no SDWA is provided
because only RTM can create one.
DSNW049I OLDEST SLOT ADDRESS INVALID,
FORMATTING TRACE TABLE FROM DSNW051I ERROR DURING DUMP PROCESSING
FIRST ENTRY
Explanation: This message is generated by the
Explanation: The next trace table entry location is 'SDUMP dump data gathering service' recovery routine
invalid. when an error is encountered during dump processing.
System Action: Dump formatting continues. System Programmer Response: This error is
documented in a SYS1.LOGREC record. This message
System Programmer Response: The printout of the
can be issued because of an error in the invocation of
dump should be used for the problem documentation.
SDUMP, or because of an error in SDUMP itself, or
Problem Determination: The Trace Anchor Block has during control block examination and access.
been initialized incorrectly, or overlaid during execution.
System Action: Processing of the 'SUMLSTA' user
storage areas is terminated, an SVC dump is requested,
DSNW050I ssid,NO SDWA/LOGREC, and control is returned to RTM.
ABND=comp-reason,U=user-id,
M=module,C=XYR00.vrm.comp-function
DSNW052I ERROR ENCOUNTERED DURING
Explanation: This message provides the default SVC LOAD OR VALIDATION OF A CONTROL
dump title (SDUMP) associated with the SYS1.DUMP BLOCK STRUCTURE TABLE MODULE
data set when an SDWA was unavailable during
Explanation: The DB2 dump formatting facility cannot
recovery processing. The variable fields are:
be used to format control blocks. An error occurred
ssid 4-character DB2 subsystem name during the DB2 startup process while attempting to
LOAD one of the Control Block Structures Table (CBDS)
comp-reason modules from the DB2 subsystem program library.
Abend completion code, followed by the abend
reason code. System Action: Subsystem startup processing
continues.
user-id Authorization-ID for the individual subsystem
user. Operator Response: If intervention is desired, notify
the system programmer.
module Functional recovery routine responsible for the
dump. System Programmer Response: If intervention is
desired, the DB2 subsystem can be terminated by either
vrm.comp-function an MVS CANCEL command or a -STOP DB2
Component-ID, as follows: command. If you suspect an error in DB2, refer to Part
vrm DB2 version, release number, and 2 of DB2 Diagnosis Guide and Reference for
modification level. information on identifying and reporting the problem.
comp-function Problem Determination: The modules must reside in
Component-ID function. a DB2 program library named on the execution
procedure used to start a DB2 subsystem address
System Action: Dump processing continues. space.
System Programmer Response: Since the SDWA The named modules prohibit the use of the DB2 dump
provides important diagnostic information to assist in formatting facility to format SVC dumps that occur
problem determination, examine the recovery during the current execution cycle of the DB2
environment at time of error to determine why an SDWA subsystem. The named modules are not required for
was not provided for this abend. DB2 execution.
In a nonrecovery environment, there may be valid
reasons for the lack of an SDWA. DSNW053I VRA DIAGNOSTIC INFORMATION
Problem Determination: In a recovery environment, REPORT
functional recovery routines (FRRs) are guaranteed an Explanation: All DB2 diagnostic information in the
SDWA by Recovery Termination Manager (RTM). Variable Recording Area (VRA) at the time of the error
Therefore, the recovery routine is most likely an ESTAE
Chapter 20. DB2 Messages 601
DSNW054I • DSNW060I
is extracted and displayed in this report.
DSNW056I VRA DIAGNOSTIC REPORT
The address of the SDWA, the contents of SDWARA, COMPLETE
and SDWARA’s hexadecimal offset into SDWA are also
Explanation: The VRA Diagnostic Report is done.
displayed. Individual diagnostic entries are identified by
a hexadecimal VRA 'key', followed by the length of the System Action: Dump format processing continues.
subsequent data. Data fields are displayed in
hexadecimal and EBCDIC formats. If you suspect an
DSNW060I BEGIN SAVE AREA TRACE
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and Explanation: This message identifies the start of the
reporting the problem. DB2 register Save Area Trace report which appears in
the formatted section of a DB2 SVC Dump. The save
System Action: Dump format processing continues.
areas for the current failing agent execution block (EB),
System Programmer Response: If you suspect an and all associated Agent EBs, are traced from the point
error in DB2, refer to Part 2 of DB2 Diagnosis Guide of error and displayed in order of invocation.
and Reference for information on identifying and
The format of this report is as follows:
reporting the problem.
Save Area Identification
DSNW054I NO VRA DATA RECORDED IN SDWA The address and contents of each save area is
displayed and identified by the invoking module.
Explanation: The SDWA obtained from the
SYS1.DUMP data set contained no diagnostic Module-name Service-level-identifier
information in the VRA.
SA .... WD1 .... HSA .... LSA ....
System Action: VRA report generation is bypassed, RET .... EPA .... R0 ....
dump format processing continues. R1 .... R2 .... R3 ....
R4 .... R5 .... R6 ....
System Programmer Response: If an error is R7 .... R8 .... R9 ....
indicated, the printout of the dump should be used for R10 .... R11 .... R12 ....
the problem documentation. If VRA data is needed, the
abending DB2 subcomponent has failed to supply it. If Module-name
you suspect an error in DB2, refer to Part 2 of DB2 Identifies the module responsible for obtaining
Diagnosis Guide and Reference for information on the save area as indicated in the DB2 module
identifying and reporting the problem. entry point list (MEPL) at the time of the error.
If the MEPL does not contain an entry that
DSNW055I FORMAT ROUTINE UNABLE TO corresponds to the module entry point address
LOCATE SDWA (EPA), this field is set to:
Explanation: The MVS Summary Dump Data Access MODULE INFORMATION UNAVAILABLE
Service Routine (IEAVTFRD) was unable to locate the Service-level-identifier
SDWA in the summary data portion of the SYS1.DUMP The service level information associated with
data set. the module name is obtained from the
System Action: VRA report generation is terminated corresponding module MEPL entry, and
and dump format processing continues. consists of the compilation-date and the PTF
number of the latest maintenance applied.
System Programmer Response: Take the
appropriate action, as indicated in the next section. If an If no maintenance has been applied for this
error is indicated, use the printout of the dump for module, this field defaults to the Function
problem documentation. Modification Identifier (FMID).
Problem Determination: The SDWA is placed in the SA Identifies the address and contents of each
summary data portion of the SYS1.DUMP data set by word of the save area and is displayed using
AMDPRDMP or IPCS. It indicates either CSA or Local the format and register abbreviation
Storage Residency. conventions defined by MVS SNAP. All save
area data references indicate the primary
If the SDWA is not in the dump data set, no error is address space at the time of execution.
indicated.
Execution Environment
Displays the current execution environment at the time
of error for the save areas that follow. This information
is repeated each time the current Agent execution EB
changed during processing.
602 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNW061I • DSNW063I
CURRENT EB=address JOBNAME=name determine the register contents, module invocation
HASID=hasid PASID=pasid sequence, and execution environments leading up to
EXECUTION MODE=mode the point of error.
address
Address of the associated Agent EB. DSNW061I SAVE AREA TRACE COMPLETE
name The 8-character MVS jobname associated with Explanation: This message indicates that the DB2
the home address space. formatted save area trace report (DSNW060I) is
hasid Home address space identifier. complete.
pasid Primary address space identifier. System Action: Dump format processing continues.
mode Agent EB MVS execution mode:
TCB Task Control Mode DSNW062I R6 (R6-contents) DOES NOT CONTAIN
SRB Supervisory Request Mode A VALID EB ADDRESS
Explanation: During dump format processing of the
Register Save Area Contents for Agent EBs DB2 formatted Save Area Trace report (DSNW060I),
register 6 (R6) did not contain the address of a valid
The contents of the register save area chains for the Agent execution block (EB).
current failing Agent EB, and all suspended Agent EBs
R6-contents:
at the time of error, are displayed using the save area
The contents of register 6.
(SA) format.
REGISTERS IN (CB-name) AT TIME OF System Action: save area trace format processing is
execution-status terminated for the current Agent EB, and all prior EBs.
CB-name System Programmer Response: The dump formatter
Identifies the name of the control block from expects the contents of register 6 to contain the address
which the registers for the current Agent EB of a valid EB.
were obtained:
Problem Determination: Register 6 does not contain
SDWA MVS System Diagnostic Workarea
the current EB address or a prior EB address.
(Failure).
TCB MVS Task Control Block (Suspend). Refer to the abend reason and completion codes
STSV MVS SRB Status Save Area associated with the original error to determine the use
(Suspend). of register 6 prior to the failure.
execution-status
Indicates the current execution status of the DSNW063I name (address) ASID (asid) NOT
Agent EB at the time of error: FOUND IN DUMP
Failure Failing execution EB.
Explanation: During dump formatter processing of the
Suspend
save area trace report (DSNW060I), a control block or
Suspended execution EB.
save area was not found in the dump data set.
Change of Primary Address Space Since the dump formatter utilizes the DB2 and MVS
control blocks defined under the 'name' field of this
Since all register data references refer to the primary message to locate individual register save areas,
address space associated with the currently active subsequent save areas located via the 'named' control
execution EB, the following information is displayed block or save area will not be displayed in the report.
each time the primary address changed during
name Identifies the name of the control block or save
execution:
area that was not found in the dump data set:
CHANGE OF ADDRESS SPACE, NEW PASID=pasid SA Indicates a Save Area
pasid Indicates the new primary address space ASCE DB2 Address Space Control Element
identifier associated with the save areas that EB DB2 Execution Block
follow. TCB MVS Task Control Block
RB MVS Request Block
System Action: save area trace format processing XSB MVS Extended Status Block
continues for the failing agent EB, and all associated PSA MVS Prefix Save Area
agent EBs. SDWA MVS System Diagnostic Work Area
STSV MVS SRB Status Save Area
System Programmer Response: See the Problem
STKE MVS Cross Memory Stack Element
Determination section.
Problem Determination: This report may be used to
Chapter 20. DB2 Messages 603
DSNW108I • DSNW123I
address
DSNW120I A SPECIFIED keyword VALUE IS
The address of the 'named' control block or
INVALID FOR type TRACE
save area.
Explanation: A trace command has been entered, but
asid The address space identifier associated with
a specified keyword value is not valid for the trace type
the control block or save area.
requested.
System Action: Register save area trace format
System Action: Processing for the TRACE command
processing for the current save area chains is
is terminated.
terminated. Subsequent save area processing will vary
depending on the specific control block or save area Operator Response: If a -START TRACE command
that was available, and the DB2 Agent execution was entered, specify a valid destination for the trace.
environments at the time of the error. Otherwise, issue a -DISPLAY TRACE command to
determine what traces are currently active. Refer to DB2
System Programmer Response: Due to the
Command Reference for detailsabout valid destinations.
execution structures and environmental restrictions of
selected DB2 and MVS control structures, some control Problem Determination: Obtain a copy of the system
blocks and save areas associated with these execution or terminal log to verify command entry.
environments will not be included in the dump data set.
Problem Determination: During MVS/RTM recovery DSNW121I A SPECIFIED CLASS VALUE IS
processing, IFC Dump Services attempts to include all INVALID FOR type TRACE
control blocks (both DB2 and MVS), and the pertinent
Explanation: A trace command has been entered, but
DB2 save areas in the dump data set, regardless of the
a specified class value is not valid for the trace type
type of error. Control blocks and save areas associated
requested.
with the following address spaces at time of error will be
included in the dump data set: System Action: Processing for the TRACE command
v Primary, Secondary, and Home address spaces. is terminated.
v DB2 System Services and Database Services Operator Response: If a -START TRACE command
address spaces. was entered, specify a valid class for the trace.
Otherwise, issue a -DISPLAY TRACE command to
determine what options are currently active. Refer to
DSNW108I UNABLE TO AUTOMATICALLY START
DB2 Command Reference for details about valid
type TRACE
classes.
Explanation: System parameters indicated that a DB2
Problem Determination: Obtain a copy of the system
trace should be started automatically during DB2
or terminal log to verify command entry.
subsystem initialization, but the DB2 subsystem was
unable to start the trace. A nonzero return code was
received from the -START TRACE command. DSNW122I THE KEYWORD keyword IS NOT VALID
FOR type TRACE
System Action: Subsystem initialization continues.
Explanation: A trace command has been entered, but
Operator Response: Start the trace via the -START
'keyword' is not valid for the trace type specified.
TRACE command after DB2 subsystem initialization is
complete. System Action: Processing for the TRACE command
is terminated.
DSNW109I TRACE INITIALIZATION PARAMETERS Operator Response: Either the named keyword must
UNAVAILABLE, DEFAULTS ASSUMED be omitted from the command, or a different type of
trace must be specified. Refer to DB2 Command
Explanation: The trace function was unable to access
Reference for details about valid combinations of
the trace initialization parameters defined by the
keywords and trace types.
DSN6SYSP macro. Default values as defined by that
macro are assumed for trace parameters. Problem Determination: Obtain a copy of the system
or terminal log to verify command entry.
System Action: Subsystem initialization continues.
Operator Response: Determine if the system
DSNW123I csect-name TRACE RECORDING HAS
parameters module DSNZPARM is missing or
BEEN RESUMED ON dest
inaccessible. If not, determine if the CSECT DSN6SYSP
is missing. Trace can be started with the -START Explanation: 'dest' destination resumes acceptance of
TRACE command. trace data after a failure.
System Action: Data recording is resumed.
604 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNW124I • DSNW129I
Problem Determination: Obtain a copy of the system
DSNW124I csect-name type TRACE TERMINATED
or terminal log to verify command entry.
RC=code RMID=nn
Explanation: During processing 'type' trace,
DSNW126I type TRACE NOT ALLOWED, ACTIVE
processing abended due to an error. A trace type of
TRACE TABLE FULL
blank indicates all tracing has stopped. 'RMID',
displayed in decimal, identifies the resource manager. Explanation: The 'type' trace cannot be started
'RC', displayed in hexadecimal, specifies the because the active trace table is has reached the
return/reason/abend code associated with the action. maximum number of active traces allowed.
Further collection of the named trace is stopped. If it is This message is issued by the following CSECT:
necessary to resume collection of the trace, a -START DSNWVCM1
TRACE command may be issued. However if another
failure is experienced, the problem should be resolved System Action: Processing for the TRACE command
before starting the trace collection again. is terminated.
System Action: Processing for the named trace type Operator Response: Use the -DISPLAY TRACE
is stopped. The message is not externalized by the command to see if an active trace could be stopped. An
functional recovery routine, but is outputted whenever a active trace must be stopped before any other start
IFC event is driven at a later time. A trace type of blank trace command will be processed.
indicates all tracing has stopped. Problem Determination: Obtain a copy of the system
User Response: Investigate the reasons for the or terminal log to verify command entry.
failure.
Operator Response: If necessary to collect the DSNW127I CURRENT TRACE ACTIVITY IS–
named trace, issue a -START TRACE command to Explanation: This message is the title for the
resume processing. -DISPLAY TRACE command output. The DSNW127I
Problem Determination: Obtain a copy of the system message is followed by the DSNW128I message, one
or terminal log. If a dump was produced, have it printed. or more DSNW129I messages, and the DSNW147I
Print a copy of the contents of the SYS1.LOGREC for message.
the time period involved. Forward these items along This message is issued by the following CSECT:
with a copy of the system log to the system DSNWVCM1
programmer.
DSNW128I TNO TYPE CLASS DEST QUAL
DSNW125I MULTIPLE ENTRIES NOT ALLOWED
FOR keyword AND keyword Explanation: This message is issued before any
-DISPLAY TRACE responses. The message follows
Explanation: The following matrix shows keywords message DSNW127I. The title indicates the trace
which can have multiple entries and the valid number that is active, the type of trace, the class within
combinations. If the row keyword has multiple values type, and the destination specified for the active trace
then the column keyword can have multiple (M) entries entries. Whether the trace is qualified is also displayed.
or a maximum of one (1). If QUAL=YES, the trace is qualified by authorization ID,
Certain keywords are not allowed with some plan, RMID, or location. If QUAL=NO, the trace is not
commands. Refer to DB2 Command Reference for qualified. Qualification information can be requested by
additional information. specifying DETAIL(2) on -DISPLAY TRACE. Refer to
messages DSNW143I, DSNW144I, DSNW145I, and
Class Dest Plan Auth. ID RMID TNO IFCID Loca DSNW148I for more information about -DISPLAY
Class M M M M M M M TRACE. The message number is not displayed to save
Dest M M M M M M M space on the message line.
Plan M M 1 M 1 M 1
Auth. ID M M 1 M 1 M 1 This message is issued by the following CSECT:
RMID M M M M M M M DSNWVCM1
TNO M M 1 1 M M 1
IFCID M M M M M M M
Loca M M 1 1 M 1 M DSNW129I tno type class dest qual
Explanation: This message is issued for -DISPLAY
System Action: Processing for the TRACE command TRACE responses. The message indicates the trace
is terminated. number that is active, the type of trace, the class within
Operator Response: Reenter the command omitting type, and the destination specified for the active trace
the invalid keyword. entries. Whether the trace is qualified is also displayed.
If QUAL=YES, the trace is qualified by authorization ID,
Chapter 20. DB2 Messages 605
DSNW130I • DSNW137I
plan, RMID, or location. If QUAL=NO, the trace is not 04 No OPn buffer is assigned to an application
qualified. Qualification information may be requested by to collect data.
specifying DETAIL(2) on -DISPLAY TRACE. Refer to v The hexadecimal return code from the OPX request.
messages DSNW143I, DSNW144I, and DSNW145I for 04 No OPn buffer is assigned to an application
trace qualification information. to collect data.
The message follows message number DSNW128I or 08 The OPX trace destination buffer is full
DSNW129I. If more information is available than can be causing data to be lost.
displayed on one line, subsequent lines of information v The hexadecimal return code from the SRV request.
are displayed. The message number is not displayed to 10 The serviceability routine is absent.
save space on the message line. xx The serviceability routine return code.
System Action: Trace processing continues although
DSNW130I type TRACE STARTED ASSIGNED data will be lost.
TRACE NUMBER tno
This message will also be issued if a -START TRACE
Explanation: 'type' trace has been started and command is entered from the console or from the DB2I
assigned the decimal trace number 'tno'. Multiple commands panel to an unassigned OPn or OPX
messages are possible when the start request specifies destination. This is because the OP destination is not
multiple plans or multiple authorization ids. activated until an application program claims the buffer.
DB2 will begin writing trace records to the buffer when
This message is issued by the following CSECT:
an application program issues a -START TRACE to this
DSNWVCM1
same OP buffer destination.
System Action: Processing for the -START TRACE
Operator Response: Investigate the GTF or SMF
command will continue.
facility to determine why data is not being accepted. You
may want to issue a -START TRACE command to
DSNW131I STOP TRACE SUCCESSFUL FOR record the data at another destination. The -DISPLAY
TRACE NUMBER(S) tno,... TRACE command shows what types of data were
recorded at the specified destination. Message
Explanation: The trace number(s), 'tno,...', have been DSNW133I with RC=8 is due to exhaustion of storage
stopped. Up to five decimal trace numbers may be in an OPx buffer.
listed. If more than five traces have been stopped, then
another DSNW131I message is sent. Problem Determination: Obtain a copy of the system
or terminal log to verify command. Refer to MVS/ESA
System Action: Processing for the -STOP TRACE System Management Facilities (SMF) for an explanation
command will continue. of the return code value. For instances of message
DSNW133I with RC=8, consult Appendix E (Volume 2)
DSNW132I MODIFY TRACE SUCCESSFUL FOR of DB2 Administration Guide. The OPx buffer to which
TRACE NUMBER(S) tno,... the records were to be written has been filled, and all
subsequent records intended for the buffer will be lost
Explanation: The trace numbers, 'tno,...', have been until an IFI READA request is issued to read and clear
modified. Up to five numbers may be listed. If more than the contents of the buffer. Suggested actions include
five traces have been modified, then another increasing the size of the OPx buffer and/or issuing the
DSNW131I message is sent. IFI READA request more frequently so that the OPx
System Action: Processing for the modify command buffer is read and cleared before buffer storage is
will continue. exhausted.
DSNW133I csect-name TRACE DATA LOST, dest DSNW135I type TRACE ALREADY ACTIVE, TRACE
NOT ACCESSIBLE RC=code NUMBER tno
Explanation: The destination specified stopped Explanation: 'type' trace was already active with trace
accepting trace data during a trace. Some condition number 'tno'.
external to DB2 caused the data rejection. The reason System Action: Processing for the -START TRACE
for failure is defined by the return code (RC). The RC command will continue.
hexadecimal value can be:
v The hexadecimal return code from SMF. Refer to the
DSNW137I SPECIFIED TRACE NOT ACTIVE
appropriate MVS publication for the specific value.
v The hexadecimal return code from the GTF request. Explanation: The specified trace could not be found in
04 GTF trace and/or USR tracing is not active. the active trace table.
v The hexadecimal return code from the OPn request. System Action: Processing for the -STOP or
-DISPLAY TRACE command will continue.
606 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNW138I • DSNW143I
Operator Response: You may wish to issue an System Action: Processing of the trace command is
unqualified -DISPLAY TRACE command to determine all terminated.
the active trace entries. If no traces are active then an
User Response: Investigate the reason for the failure.
unqualified -DISPLAY TRACE command response
message is a DSNW137I message. Operator Response: Investigate the reason for the
problem by doing a display trace to analyze the active
traces.
DSNW138I IFCID ifcid-number IS INVALID
Problem Determination: The problem is caused
Explanation: The specified IFCID number is outside
either because one or more prior start traces to an OPn
the range of valid IFCID numbers or is an IFCID
destination used all the storage in the IFC OPn storage
number which is not allowed on a trace command as
pool or because ECSA contiguous storage was not
specified in Part 5 (Volume 2) of DB2 Administration
available. The IFC OPn storage pool limit is
Guide.
approximately 4 megabytes. When a trace is stopped
System Action: Processing of the trace command is the buffer storage is not free. If another start trace is
terminated before any trace functions are performed. issued to the same destination, the storage will be
reused. If the requested storage is greater than the
Operator Response: Investigate the reason for the
current unassigned buffer, it is free and a larger buffer is
problem.
obtained. If the requested storage is less than the
Problem Determination: Refer to DB2 Command current unassigned buffer, the buffer is reused.
Reference for the range of valid IFCID numbers. Fragmentation can occur if either application programs
or an operator specify numerous start commands for
varying size buffers.
DSNW139I AUTHORIZATION FAILURE BECAUSE
authorization-privilege PRIVILEGE
REQUIRED DSNW142I SPECIFIED BUFSIZE IS INCOMPATIBLE
WITH ASSIGNED BUFFER
Explanation: The user of the command does not have
the required authorization privilege to execute the Explanation: The request could not be processed
command. because the start trace command specified a BUFSIZE
value for an OPn destination which has a buffer already
System Action: Command processing is stopped. assigned with a different BUFSIZE.
User Response: Notify the security administrator. System Action: Processing of the trace command is
Operator Response: Notify the security administrator. terminated.
Problem Determination: Obtain a copy of the User Response: Investigate the reason for the failure.
command input and verify the user’s current Operator Response: Investigate the reason for the
authorization from the DB2 subsystem catalog. problem.
Problem Determination: The problem may be caused
DSNW140I ALL OPN DESTINATIONS ARE by one application program attempting to start a trace to
ASSIGNED a destination owned by another program. This is a site
Explanation: The request could not be processed problem and can be solved by having application
because destinations OP1 - OP8 were assigned. programs start traces to an OPX destination rather than
a specific OPn destination. If only one application
System Action: Processing of the trace command is program is starting traces, then the program should
terminated before any trace functions are performed. either specify the same BUFSIZE for all requests or
User Response: Investigate the reason for the failure. should not specify BUFSIZE.
Operator Response: Investigate the reason for the
problem by doing a display trace to analyze the active DSNW143I CURRENT TRACE QUALIFICATIONS
traces. ARE -
Problem Determination: Analyze why all the OPn Explanation: This message is issued before
destinations are active after doing a display trace. -DISPLAY TRACE responses when DETAIL(2) or
DETAIL(*) is specified. Message DSNW143I is followed
by the DSNW144I message, one or more DSNW145I
DSNW141I STORAGE NOT AVAILABLE FOR messages, and the DSNW148I message.
BUFFER SIZE size K BYTES
Explanation: The request could not be processed
because storage cannot be obtained for the OPn
destination storage buffer.
Chapter 20. DB2 Messages 607
DSNW144I • DSNW149I
or not specified at all. Message DSNW147I follows one
DSNW144I TNO AUTHID PLAN RMID LOCATION
or more DSNW129I messages. The message number is
Explanation: This message is issued before not displayed to save space on the message line.
-DISPLAY TRACE responses when DETAIL(2) is
System Programmer Response: If you suspect an
specified. The title indicates the trace number that is
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
active, the authorization ID, the plan, the RMID, and the
and Reference for information on identifying and
location specified for the active trace entries. The
reporting the problem.
message follows message DSNW143I. The message
number is not displayed to save space on the message Problem Determination: Collect the following
line. diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 1, 2, 5.
DSNW145I tno authid plan rmid location
DSNW148I ***END OF DISPLAY TRACE
Explanation: This message is issued for -DISPLAY
QUALIFICATION DATA***
TRACE responses when DETAIL(2) is specified. The
message indicates the trace number that is active, the Explanation: This message is produced when all
authorization ID, the plan, the RMID, and the location qualification data for the -DISPLAY TRACE command
specified for the active trace entries. has been written. Qualification data is written when the
DETAIL keyword of the -DISPLAY TRACE command is
The message follows messages DSNW143I or
specified as '2', or '*'. Message DSNW148I follows one
DSNW144I. If more information is available than can be
or more DSNW145I messages. The message number is
displayed on one line, subsequent lines of information
not displayed to save space on the message line.
are displayed. The message number is not displayed to
save space on the message line. System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and
DSNW146I MULTIPLE ENTRIES NOT ALLOWED
reporting the problem.
FOR keyword, keyword AND keyword
Problem Determination: Collect the following
Explanation: The following matrix shows keywords
diagnostic items listed in “Appendix B. Problem
that can have multiple entries and the valid
determination” on page 1281: 1, 2, 5.
combinations. If the row keyword has multiple values,
the column keyword can have multiple (M) entries or a
maximum of one (1). DSNW149I STOP TRACE COMMAND WAS
UNSUCCESSFUL BECAUSE MONITOR
Class Dest Plan Auth. ID RMID TNO Loca
TRACE CLASS 6 IS ACTIVE FOR
Class M M M M M M
Dest M M M M M M
QUALIFYING TRACE NUMBER(S) tno,...
Plan M M 1 M 1 1 Explanation: No traces were stopped by the -STOP
Auth. ID M M 1 M 1 1
TRACE command. Either -STOP TRACE(*) or -STOP
RMID M M M M M M
TRACE(MON) CLASS(*) was issued when monitor trace
TNO M M 1 1 M 1
Loca M M 1 1 M 1
class 6 was active. An asterisk (*) is not allowed for the
TRACE and CLASS keywords when monitor trace class
6 is active. The trace numbers, ’tno,...’, indicate the
Certain keywords are not allowed with some traces that met any other specified -STOP TRACE
commands. Refer to DB2 Command Reference for qualifying criteria (PLAN, AUTHID, RMID, LOCATION,
additional information. TNO) and also activated monitor trace class 6, thereby
preventing all qualifying traces from being stopped. This
System Action: Processing for the TRACE command special handling of the asterisk on the -STOP TRACE
is terminated. command for monitor trace class 6 reduces the
Operator Response: Omit the invalid keyword and possibility of accidentally stopping monitor trace class 6,
reenter the command. which enables and disables DB2 data propagation.
Problem Determination: Obtain a copy of the system System Action: No traces are stopped. Processing of
or terminal log to verify command entry. the -STOP TRACE command is terminated.
User Response: Reissue the -STOP TRACE
DSNW147I ***END OF DISPLAY TRACE SUMMARY command without using an asterisk for the trace type.
DATA*** You can use a asterisk for the CLASS keyword to stop
all trace types except the monitor (MON) trace.
Explanation: This message is produced when all
summary information for the -DISPLAY TRACE Operator Response: If you do not want DB2 data
command has been written. Summary information is propagation capability, you can stop monitor trace class
written when the DETAIL keyword is specified as '1', '*', 6 to allow full use of the asterisk. First stop the traces
608 DB2 UDB for OS/390 and z/OS: Messages and Codes
indicated by the trace numbers, ’tno,...’, and then
reissue the command.
If you want DB2 data propagation capability, do not stop
monitor trace class 6. You must specify the trace TYPE.
You can stop traces without specifying the trace CLASS
as long as the trace TYPE is not (MON). If the trace
TYPE is (MON), then you must specify the CLASS
keyword explicitly (for example, -STOP TRACE(MON)
CLASS(1,2)).
Refer to DB2 Command Reference for information on
restrictions to the -STOP TRACE command when
monitor trace class 6 is active.
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 1, 2, 5.
Chapter 20. DB2 Messages 609
610 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 21. DSNX... Messages
DSNX100I bind-type SQL WARNING USING DSNX101I bind-type SQL WARNING USING
authorization-id AUTHORITY authorization-id AUTHORITY
PLAN=plan-id DBRM=dbrm name PLAN=plan-id DBRM=dbrm name
STATEMENT=statement number object STATEMENT=statement number THE
name IS NOT DEFINED SPECIFIED AUTHORIZATION-ID DOES
NOT HAVE THE PRIVILEGE TO
Explanation: The indicated object is not defined in the
PERFORM OPERATION op name ON
DB2 catalog.
OBJECT object name
bind-type
Explanation: The identified authorization ID does not
Type of BIND subcommand that caused the
have a privilege required for application plan execution.
warning: BIND, REBIND
bind-type
authorization-id
Type of BIND subcommand that caused the
Authorization ID used during the BIND process:
warning: BIND or REBIND
for a BIND subcommand, indicates the
authorization ID of the plan owner; for a authorization-id
REBIND subcommand, indicates the Authorization ID used during the bind process.
authorization ID of the owner specified by the For a BIND subcommand, it is the
subcommand, or the latest owner of the plan. If authorization ID of the plan owner. For a
this is a remote rebind, and the OWNER was REBIND subcommand, it is the authorization
not specified in the subcommand, then ID of the owner specified by the subcommand,
“REMOTE OWNER” will be output. or the latest owner of the plan. If this is a
remote operation, and the OWNER was not
plan-id Name of the application plan specified in the
specified in the subcommand, then REMOTE
BIND subcommand, blank if the application
OWNER is output.
plan is not specified.
plan-id Name of the application plan specified in the
dbrm name
BIND subcommand. If the application plan is
Name of the DBRM that contains the reference
not specified, this field is blank.
to the indicated object.
dbrm name
statement number
Name of the DBRM that contains the
Statement number of the SQL statement
unauthorized operation.
referencing the name of the object.
statement number
object name
Statement number of the SQL statement
Name of the object that is not defined in the
containing the unauthorized operation.
DB2 catalog.
System Action: A valid plan is created if no errors are
System Action: A valid plan is created if no errors are
detected and VALIDATE(RUN) is in effect.
detected and VALIDATE(RUN) is in effect.
System Programmer Response: You must take one
System Programmer Response: Ensure that the
of the following actions before the statement can be
indicated table is created before the statement is
executed. Otherwise, the execution of the statement
executed. Otherwise, execution of this statement results
results in an error.
in an error.
v Ensure that the appropriate authority is granted to the
This statement is bound dynamically on each execution invoker of the latest BIND subcommand against this
of the statement. For better performance, REBIND the application plan
application program after the indicated object is created.
v Invoke the BIND subcommand again using an
authorization ID with authority to perform all the
operations in this application plan.
This statement is bound dynamically on each execution
of the statement. For better performance, rebind the
application program after the appropriate authority is
granted to the invoker of the BIND subcommand against
this application plan.
© Copyright IBM Corp. 1982, 2001 611
DSNX102I • DSNX104I
bind-type
DSNX102I bind-type SQL WARNING USING
Type of BIND subcommand that caused the
authorization-id AUTHORITY
warning: BIND or REBIND
PLAN=plan-id DBRM=dbrm name
STATEMENT=statement number THE authorization-id
REQUIRED INDEX HAS NOT BEEN Authorization ID used during the bind process.
CREATED ON TABLE table name IN For a BIND subcommand, it is the
PARTITIONED TABLESPACE table authorization ID of the plan owner. For a
space name REBIND subcommand, it is the authorization
ID of the owner specified by the subcommand,
Explanation: There was an attempt to reference the
or the latest owner of the plan. If this is a
table in the table space (both specified in the message)
remote operation, and the OWNER was not
when the required index was not yet created.
specified in the subcommand, then REMOTE
bind-type OWNER is output.
Type of BIND subcommand that caused the
plan-id Name of the application plan specified in the
warning: BIND or REBIND
BIND subcommand. If the application plan is
authorization-id not specified, this field is blank.
Authorization ID used during the bind process.
dbrm name
For a BIND subcommand, it is the
Name of the DBRM that contains the reference
authorization ID of the plan owner. For a
to the indicated table.
REBIND subcommand, it is the authorization
ID of the owner specified by the subcommand, statement number
or the latest owner of the plan. If this is a Statement number of the SQL statement
remote operation, and the OWNER was not referencing the indicated table.
specified in the subcommand, then REMOTE
OWNER is output. System Action: A valid plan is created if no errors are
detected. Table space locking is used. RR isolation level
plan-id Name of the application plan specified in the is preserved.
BIND subcommand. If the application plan is
not specified, this field is blank. System Programmer Response: If you do not want
table space locking, use isolation level UR, CS or RS.
dbrm name
Name of the DBRM that contains the reference
to the indicated table. DSNX104I bind-type SQL WARNING USING
authorization-id AUTHORITY
statement number PLAN=plan-id DBRM=dbrm name
Statement number of the SQL statement STATEMENT=statement number THE
referencing the indicated table. RESULT OF DECIMAL
MULTIPLICATION MAY CAUSE
System Action: A valid plan is created if no errors are
OVERFLOW
detected and VALIDATE(RUN) is in effect.
Explanation: An arithmetic expression contains a
System Programmer Response: Ensure that the
decimal multiplication that might cause an overflow
required index on the indicated table in the partitioned
condition when the statement is executed. The problem
table space is created before the statement is executed.
can be corrected by restructuring the arithmetic
Otherwise, execution of this statement results in an
expression so that decimal multiplication precedes
error. This statement is bound dynamically on each
decimal division or by changing the precision and scale
execution of the statement. For better performance,
of the operands in the arithmetic expression. Refer to
rebind the application program after the required index
Chapter 2 of DB2 SQL Reference for the precision and
is created.
scale of the decimal multiplication and division results.
bind-type
DSNX103I bind-type SQL WARNING USING
Type of BIND subcommand that caused the
authorization-id AUTHORITY
warning: BIND or REBIND
PLAN=plan-id DBRM=dbrm name
STATEMENT=statement number BIND authorization-id
ISOLATION LEVEL RR CONFLICTS Authorization ID used during the bind process.
WITH TABLESPACE LOCKSIZE PAGE For a BIND subcommand, it is the
OR LOCKSIZE ROW authorization ID of the plan owner. For a
REBIND subcommand, it is the authorization
Explanation: Because of the possible inconsistency
ID of the owner specified by the subcommand,
between the isolation level of the application and the
or the latest owner of the plan. If this is a
LOCKSIZE of the table space, table space locking is
used to protect the integrity of the application.
612 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNX105I • DSNX200I
remote operation, and the OWNER was not token list
specified in the subcommand, then REMOTE Sequence of one or more tokens separated by
OWNER is output. blanks. Refer to “Part 2. SQL Return Codes” on
page 9 for an explanation of tokens.
plan-id Name of the application plan specified in the
BIND subcommand. If the application plan is System Action: A valid plan is created if no errors are
not specified, this field is blank. detected.
dbrm name System Programmer Response: Refer to “Part 2.
Name of the DBRM that contains the reference SQL Return Codes” on page 9, for the particular SQL
to the indicated table. return code given in this message. If the reason code is
negative, this statement is bound dynamically on each
statement number
execution of the statement. For better performance,
Statement number of the SQL statement
rebind the application program after correcting this
referencing the indicated table.
statement or after the required object is created or
System Action: A valid plan is created if no errors are altered.
detected.
DSNX106I ATTEMPTED REBIND OF PACKAGE
DSNX105I bind-type SQL WARNING USING pkg-id RESULTED IN A TOTAL OF
authorization-id AUTHORITY number ERRORS
PLAN=plan-id DBRM=dbrm name
Explanation: Errors have been detected during the
STATEMENT=statement number
remote REBIND process. Only the first REBIND error
SQLCODE=sqlcode
will produce a specific message. Additional errors will
SQLSTATE=sqlstateTOKENS=token list
simply be totaled, and the number will be returned to
Explanation: An SQL warning code was generated the user.
while processing an SQL statement.
pkg-id Name of the package specified in the
bind-type subcommand.
The type of subcommand that caused the
number
warning: BIND or REBIND
Total number of errors in the remote REBIND
authorization-id
System Action: The package was not rebound.
Indicates the authorization ID used during the
bind process. For a BIND subcommand, it is System Programmer Response: See previously
the authorization ID of the plan owner. For a output message to determine the initial error that
REBIND subcommand, it is the authorization caused the subcommand to be terminated
ID of the owner specified by the subcommand, unsuccessfully.
or the latest owner of the plan. If this is a
remote operation, and the OWNER was not
DSNX200I bind-type SQL ERROR USING
specified in the subcommand, then REMOTE
authorization-id AUTHORITY
OWNER is output.
PLAN=plan-id DBRM=dbrm name
plan-id Name of the application plan specified in the STATEMENT=statement number
BIND subcommand. If the application plan is SQLCODE=sqlcode
not specified, this field is blank. SQLSTATE=sqlstateTOKENS=token list
CSECT=csect name RDS
sqlcode
CODE=location code
A product specific code which identifies the
particular SQL warning condition. The value Explanation: An error has been detected while
and semantics of the code are the same as the processing an SQL statement.
SQL return codes documented in “Part 2. SQL
bind-type BIND | REBIND
Return Codes” on page 9.
indicates type of BIND subcommand that
sqlstate caused the error.
A common code which identifies the particular
authorization-id
SQL warning condition.
indicates the authorization ID used during the
dbrm name bind process. For a BIND subcommand,
Name of the DBRM that contains the problem. indicates the authorization ID of the plan
owner. For a REBIND subcommand, indicates
statement number
the authorization ID of the owner specified by
Statement number of the SQL statement
the subcommand, or the latest owner of the
containing the problem.
plan.
Chapter 21. DB2 Messages 613
DSNX201I • DSNX203I
plan-id Name of the application plan specified in the System Action: No application plan is created.
BIND subcommand. Blank if the application
System Programmer Response: Precompile the
plan is not specified.
application program associated with the indicated
sqlcode DBRM. Reinvoke the BIND subcommand.
A product specific code which identifies the
particular SQL error detected. The value and
DSNX202I INVALID AMODE ATTRIBUTE FOUND
semantics of the code are the same as the
FOR DATE OR TIME INSTALLATION
SQL return codes documented in “Part 2. SQL
REPLACEABLE EXIT ROUTINE
Return Codes” on page 9.
module-name
sqlstate
Explanation: During DB2 startup, the Relational Data
A common code which identifies the particular
System subcomponent loads the Date (DSNXVDTX)
SQL error detected.
and Time (DSNXVTMX) exit routines. These routines
dbrm name must have the link-edited attributes AMODE(31) and
Name of the DBRM that contains the error. RMODE(ANY). The module listed in the message
'module-name' did not have the correct addressing
statement-number
attributes. If the date and time LOCAL installation option
Statement number containing the SQL error.
is specified, DB2 will be unable to execute the date and
token list time functions required by the exit routine that failed to
Optional sequence of one or more tokens load.
separated by blanks. These are the tokens that
System Action: The load module is deleted. DB2
are to be substituted into the text of the error
startup will continue.
code as described at the beginning of “Part 2.
SQL Return Codes” on page 9. Operator Response: Notify the system programmer.
csect Name of the CSECT detecting the problem. System Programmer Response: When DB2 is
stopped, the date and time exit routine must be
rds code
link-edited again with the correct AMODE and RMODE
Unique code that identifies the location within
control statements. For more information, refer to
the CSECT when the problem is detected.
Appendix B (Volume 2) of DB2 Administration Guide.
System Action: No application plan is created.
System Programmer Response: Correct the SQL DSNX203I LOAD OF THE DATE OR TIME
errors in the application program associated with the INSTALLATION REPLACEABLE EXIT
indicated DBRM. Precompile the application program, ROUTINE module-name FAILED WITH
and reinvoke the BIND subcommand. MVS ABEND CODE = abend-code
REASON CODE = reason-code DB2
STARTUP WILL CONTINUE
DSNX201I bind-type SQL ERROR USING
authorization-id AUTHORITY Explanation: During DB2 startup, the Relational Data
PLAN=plan-id DBRM=dbrm name System subcomponent loads the date (DSNXVDTX)
STATEMENT=statement number SQL and time (DSNXVTMX) exit routines. During the load of
CODE=sql code TOKENS=token list; EXIT ROUTINE 'module-name', MVS issued the abend
bind-type DBRM ERROR USING code and reason code that would cause abnormal
authorization-id AUTHORITY termination of the task, but the abend was suppressed.
PLAN=plan-id DBRM dbrm name IS IN If the date and time LOCAL option is specified, DB2 will
AN INCONSISTENT STATE be unable to execute the date and time functions
required by the exit routine that failed to load.
Explanation: The content of a DBRM has been
modified after the precompilation process. System Action: The load failed. DB2 startup will
continue.
bind-type
Type of BIND subcommand that caused the Operator Response: Notify the system programmer.
warning: BIND, REBIND
System Programmer Response: When DB2 is
authorization-id stopped, the date and time exit routine must be
Authorization ID of the plan owner. link-edited correctly. For more information, refer to
Appendix B (Volume 2) of DB2 Administration Guide .
plan-id Name of the application plan specified in the
BIND or REBIND subcommand (or blank if the
application plan is not specified).
dbrm name
Name of the DBRM that is in error.
614 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNX204I • DSNX207I
System Programmer Response: Use the same data
DSNX204I csect-name ERROR LOADING THE DB2
definition control table object definitions and attributes
CATALOG, REASON reason: DB2
for all members of the DB2 data sharing group. See
STARTED ACCESS(MAINT)
Part 2 of DB2 Installation Guide for information about
Explanation: The internal structure (DBD) for the defining data definition control objects and attributes in
catalog database (DSNDB06) was either not found or DSNZPARM.
inconsistent when DB2 was started. See the appropriate
reason for a more detailed description of the problem.
| DSNX206I LOAD OF THE ACCESS CONTROL
The reason is one of the following: | AUTHORIZATION INSTALLATION
| REPLACEABLE EXIT ROUTINE
0 An error occured reading the DBD01 table
| module-name FAILED WITH MVS
space. Check the Console for messages and
| ABEND CODE = abend-code AND
SYS1.LOGREC for abends.
| REASON CODE = reason-code DB2
1 The expected level of the DBD for DSNDB06 is | STARTUP WILL CONTINUE
the previous release, but objects exist in the
| Explanation: During DB2 startup, the Relational Data
DBD for a current or later release.
| System subcomponent loads the Access Control
2 The expected level of the DBD for DSNDB06 is | Authorization (DSNX@XAC) exit routine. During the
the current release, but objects exist in the | load of EXIT ROUTINE module-name, MVS issued the
DBD for a later release. | abend code and reason code that indicates abnormal
| termination of the task. However, the abend was
3 The expected level of the DBD for DSNDB06 is | suppressed. DB2 will not use the Access Control
a later release, but objects do not exist in the | Authorization (DSNX@XAC) exit to perform
DBD for a later release. | authorization checking. DB2 authorization checking will
4 The level of the DBD for DSNDB06 is unknown | be performed.
to this version of DB2. | System Action: The load failed. DB2 startup will
System Action: DB2 was started ACCESS(MAINT). | continue.
System Programmer Response: Do not run any | Operator Response: Notify the system programmer.
CREATES, ALTERS, DROPS, GRANTs, REVOKEs or | System Programmer Response: After DB2 has
BINDs when in this state; it might corrupt your catalog | stopped, you must properly link-edit the Access Control
and directory. Determine the problem with the | Authorization exit routine. For more information, refer to
DSNDB01.DBD01 table space. An improper REPAIR or | Appendix B (Volume 2) of DB2 Administration Guide.
RECOVER of the table space might have been run. Fix
the problem while in ACCESS(MAINT) mode and then
stop and start DB2. See Section 4 (Volume 1) of | DSNX207I INVALID AMODE ATTRIBUTE FOUND
Administration Guide for more information on recovering | FOR ACCESS CONTROL
the DSNDB01.DBD01 table space. | AUTHORIZATION INSTALLATION
| REPLACEABLE EXIT ROUTINE
Problem Determination: If you suspect an error in | module-name
DB2 or the table space is in an inconsistent state refer
to Part 2 of DB2 Diagnosis Guide and Reference for | Explanation: During DB2 startup, the Relational Data
information on identifying and reporting the problem. | System subcomponent loads the Access Control
| Authorization (DSNX@XAC) exit routine. This routine
Collect the following diagnostic items listed in | must have the link-edited attributes AMODE(31) and
“Appendix B. Problem determination” on page 1281: 1, | RMODE(ANY). The module listed in the message
2. | module-name did not have the correct addressing
| attributes. DB2 will not use the Access Control
DSNX205I csect-name THE DATA DEFINITION | Authorization (DSNX@XAC) exit to perform
CONTROL OBJECT DEFINITIONS AND | authorization checking. DB2 authorization checking will
ATTRIBUTES ON MEMBER | be performed.
member-name ARE NOT THE SAME. | System Action: The system deletes the load module.
Explanation: One or more data definition control | DB2 startup will continue.
object definitions and attributes on member | Operator Response: Notify the system programmer.
member-name and on this member are not the same.
The data definition control object definitions and | System Programmer Response: After DB2 has
attributes are defined in the initialization parameter | stopped, you must properly link-edit the Access Control
module DSNZPARM. | Authorization exit routine with the correct AMODE and
| RMODE control statements. For more information, refer
System Action: Processing continues. | to Appendix B (Volume 2) of DB2 Administration Guide.
Chapter 21. DB2 Messages 615
DSNX905I • DSNX908I
System Action: The SQL CALL statement fails, and
DSNX905I csect-name PROCEDURE OR
the SQL application is forced to roll back.
FUNCTION name TERMINATED
ABNORMALLY ASID= asid WLM_ENV= The abnormal termination count for procedure
wlmenv procname was reached. The procedure is stopped and
further requests for the procedure are rejected.
Explanation: A stored procedure terminated
abnormally while attempting to satisfy an SQL CALL System Programmer Response: Correct the cause of
statement for an SQL application. the abnormal termination. If the correction requires the
stored procedure to be linkedited again, then it might be
name The name of the stored procedure or function
necessary to cause the corrected MVS load module to
that terminated abnormally.
be reloaded. Different commands must be used to
asid The MVS ASID of the address space where cause this reloading depending on the environment in
the stored procedure executed. which the stored procedure was executed.
wlmenv The name of the WLM application environment If it was run in a WLM-established stored procedures
where the stored procedure executed. If it address space, issue the MVS VARY
executed in the DB2-established stored WLM,APPLENV=name,REFRESH command.
procedures address space, this field will
If it was run in the DB2-established stored procedures
contain blanks.
address space, issue the -START PROCEDURE
System Action: The SQL CALL statement fails, and command.
the SQL application is forced to roll back.
After the appropriate command has been issued to
System Programmer Response: Correct the cause of refresh the stored procedure load module,use the
the abnormal termination. If the correction requires the -START PROCEDURE command to activate the stored
stored procedure to be linkedited again, then it might be procedure.
necessary to cause the corrected MVS load module to
Problem Determination: Collect the following
be reloaded. Different commands must be used to
diagnostic items listed in “Appendix B. Problem
cause this reloading depending on the environment in
determination” on page 1281: 1, 4, 5.
which the stored procedure was executed.
If it was run in a WLM-established stored procedures
DSNX908I csect-name PROCEDURE OR
address space, issue the MVS VARY
FUNCTION name WITH LOAD MODULE
WLM,APPLENV=name,REFRESH command.
module EXCEEDED CPU RESOURCE
If it was run in the DB2-established stored procedures LIMIT SSN= ssn PROC= jclprocASID=
address space, issue the -START PROCEDURE asid WLM_ENV= wlmenv
command.
Explanation: A stored procedure or function
Problem Determination: Collect the following consumed more CPU service units than allowed by the
diagnostic items listed in “Appendix B. Problem ASUTIME column of the ALTER PROCEDURES catalog
determination” on page 1281: 1, 4, 5. table. The stored procedure might be in a loop.
name The name of the stored procedure or function
DSNX906I csect-name PROCEDURE OR being processed
FUNCTION name TERMINATED
module The MVS load module associated with the
ABNORMALLY. THE PROCEDURE HAS
stored procedure
BEEN STOPPED. ASID= asid
WLM_ENV= wlmenv ssn The name of the DB2 subsystem that called
the stored procedure.
Explanation: A stored procedure terminated
abnormally while attempting to satisfy an SQL CALL jclproc The name of the JCL PROC used to start this
statement for an SQL application. stored procedures address space.
name The name of the stored procedure or function asid The MVS ASID of the address space where
that terminated abnormally the stored procedure executed.
asid The MVS ASID of the address space where wlmenv The name of the WLM application environment
the stored procedure executed. where the stored procedure executed. If it
executed in the DB2-established stored
wlmenv The name of the WLM application environment
procedures address space, this field will
where the stored procedure executed. If it
contain blanks.
executed in the DB2-established stored
procedures address space, this field will System Action: DB2 detaches the TCB associated
contain blanks. with the stored procedure, which causes abnormal
termination of the stored procedure.
616 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNX921I • DSNX942I
Operator Response: Contact the system programmer. DB2 and the stop of DB2 will continue.
System Programmer Response: If the stored WLM-established stored procedure address spaces are
procedure is looping, correct the stored procedure. terminated by WLM after the disconnection from DB2.
If the stored procedure is performing correctly, increase
the ASUTIME value in the CREATE PROCEDURES row DSNX940I csect-name - DISPLAY PROCEDURE
associated with the stored procedure. REPORT FOLLOWS-
Problem Determination: Collect the following Explanation: This message is the title for the report
diagnostic items listed in “Appendix B. Problem output from the DISPLAY PROCEDURE command. It
determination” on page 1281: 1, 4, 5. precedes messages DSNX941I and DSNX942I.
Message DSNX943I might also be displayed. The final
message for the report is DSNX945I.
DSNX921I csect-name SOME SQL CALL
STATEMENTS CANNOT BE System Action: The DISPLAY PROCEDURE
PROCESSED, BECAUSE REQUIRED command processing continues.
RESOURCES ARE NOT AVAILABLE
REASON=reason TYPE=type
DSNX941I PROCEDURE MODULE STATUS
NAME=name
ACTIVE QUEUED MAXQUE TIMEOUT
Explanation: DB2 was unable to validate the WLM_ENV
attributes of the SYSIBM.SYSROUTINES catalog table
Explanation: This message displays the column
and related objects because of an unavailable resource.
headings for the list of stored procedures generated by
reason The DB2 reason code describing the the DISPLAY PROCEDURE command. The definitions
unavailable resource are:
type The resource type PROCEDURE
The name of the stored procedure
name The name of the resource
STATUS
System Action: SQL CALL statements are rejected.
The status of the stored procedure
System Programmer Response: Resolve the
ACTIVE
unavailable resource problem. Then use the -START
The number of DB2 agents that are currently
PROCEDURE(*) command to cause DB2 to accept
running this stored procedure
SQL CALL statements.
QUEUED
Operator Response: Note the reason code, the type
The number of DB2 agents that are currently
code, and the name. See the Problem Determination
waiting for this stored procedure to be
section for an explanation of the collected data.
scheduled
Problem Determination: The reason code tells why
MAXQUE
the resource is unavailable. Reason codes are
The maximum number of DB2 agents that
described in ″Part 4. Reason Codes″. Use the table
have waited for this stored procedure to be
defined for message DSNT500I to find the type of
scheduled since DB2 was started
resource identified in the message.
TIMEOUT
The number of times a request for this
DSNX922I csect-name BEGINNING
procedure timed out while waiting to be
DISCONNECTION OF STORED
scheduled since DB2 was started
PROCEDURE ADDRESS SPACES
WLM_ENV
Explanation: This message is produced during -STOP
The MVS Workload Manager environment
DB2 processing. It indicates that DB2 SQL processing
name for this stored procedure
has been quiesced, and DB2 is now beginning the
termination process for the stored procedures address System Action: The DISPLAY PROCEDURE
spaces. command processing continues.
DSNX923I csect-name ALL STORED PROCEDURE DSNX942I procedure module status active maxact
ADDRESS SPACES ARE NOW queued maxque timeout
DISCONNECTED.
Explanation: This message lists the DISPLAY
Explanation: This message is produced during -STOP PROCEDURE information for a given stored procedure.
DB2 processing. It indicates that all of the stored The definitions of the columns are:
procedure address spaces are now disconnected from
Chapter 21. DB2 Messages 617
DSNX943I • DSNX944I
procedure timeout The number of times an SQL CALL statement
The name of the stored procedure. timed out while waiting for a stored procedure
to be scheduled since DB2 was started.
module The MVS load module associated with the
stored procedure. An SQL CALL statement can time out for
several reasons:
If the module column contains blanks, the
request for the procedure is in a state in which v The procedure can be stopped by the STOP
the MVS load module name cannot yet be PROCEDURE ACTION(QUEUE) command,
determined. causing requests for the procedure to be
queued until the installation-defined time
status The status of the stored procedure. The status interval expires.
can be any of the following values:
v There might not be enough MVS TCBs in
STARTED the DB2 stored procedures address space to
The stored procedure is able to satisfy the volume of SQL CALL statements.
accept SQL CALL requests. v The MVS dispatching priority of the DB2
STOPABN stored procedures address space might be
The stored procedure was stopped too low to process the stored procedure
because of the previous abnormal requests in a timely manner.
termination of the stored procedure System Action: The DISPLAY PROCEDURE
application. SQL CALL requests for command processing continues.
the stored procedure are rejected.
The -START PROCEDURE command DSNX943I PROCEDURES begin - end STOP (act)
can be used to place the stored
procedure in STARTED status. Explanation: This message indicates a STOP
PROCEDURE command was issued with an invalid
STOPQUE procedure name, causing a range of procedure names
The stored procedure was stopped. to be stopped. This message follows the DSNX940I,
SQL CALL requests for the stored DSNX941I, and any DSNX942I messages.
procedure are queued until the stored
procedure is started or the begin The first procedure name in the range of
installation-defined timeout interval procedure names that are currently stopped
expires. end The last procedure name in the range of
The -START PROCEDURE command procedure names that are currently stopped
can be used to place the stored act The action provided on the STOP
procedure in STARTED status. PROCEDURE command
STOPREJ System Action: The DISPLAY PROCEDURE
The stored procedure was placed in command processing continues.
this status by the STOP
PROCEDURE ACTION(REJECT)
command. SQL CALL requests for the DSNX944I csect-name THE STORED PROCEDURE
stored procedure are rejected. FUNCTION IS NOT AVAILABLE
The -START PROCEDURE command Explanation: This message is returned by the START,
can be used to place the stored STOP, and DISPLAY PROCEDURE command when the
procedure in STARTED status. stored procedure facility is not available. It can also be
produced when an MVS START command is used to
active The number of DB2 agents that are currently start the stored procedures address space.
running this stored procedure.
The following conditions cause the stored procedure
maxact The maximum number of DB2 agents that facility to be unavailable:
have run this stored procedure concurrently
v The DB2 DSNZPARM module does not include a
since DB2 was started.
value for the stored procedure JCL procedure name.
queued The number of DB2 agents that are currently This prevents DB2 from starting the stored procedure
waiting for this stored procedure to be function.
scheduled. v DB2 was unable to start the stored procedures
maxque address space. This can be caused by a JCL error in
The maximum number of DB2 agents that the stored procedures JCL procedure.
have waited for this stored procedure to be v DB2 is running on MVS/XA, which does not support
scheduled since DB2 was started. the stored procedure function.
618 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNX945I • DSNX954I
System Action: If a START, STOP, or DISPLAY not allowed because the START and STOP
PROCEDURE command is in progress, the command PROCEDURE commands might cause the stored
terminates. procedures address space tasks to terminate.
If an MVS START command is used to start the stored System Action: The START or STOP PROCEDURE
procedures address space, the stored procedures command is rejected.
address space terminates.
DSNX952I csect-name THE DB2-Established
DSNX945I DISPLAY PROCEDURE REPORT STOREDPROCEDURE ADDRESS
COMPLETE SPACE IS ALREADY STARTED
Explanation: The output from the DISPLAY Explanation: DB2 supports only one DB2-established
PROCEDURE command is complete. This message stored procedure address space.
follows the DSNX940I, DSNX941I, and any DSNX942I
An MVS address space attempted to connect to DB2 as
messages.
a DB2-established stored procedure address space, but
System Action: The DISPLAY PROCEDURE another DB2-established stored procedure address
command processing continues. space is already connected to DB2.
DB2 supports multiple WLM-established stored
DSNX946I csect-name START PROCEDURE procedure address spaces.
SUCCESSFUL FOR token
System Action: The attempt to connect to DB2 is
Explanation: The START PROCEDURE command rejected.
completed successfully.
token The procedure name supplied on the START DSNX953E csect-name STORED PROCEDURE
PROCEDURE command. JOBNAME OR STARTED TASK NAME
DOES NOT MATCH ZPARM
System Action: The START PROCEDURE
COMMAND processing continues. Explanation: An MVS address space attempted to
identify itself to DB2 as the DB2-established stored
procedure address space,but the JOBNAME or started
DSNX947I csect-name STOP PROCEDURE
task name of the address space did not match the
SUCCESSFUL FOR token
stored procedure’s MVS procedure name recorded in
Explanation: The STOP PROCEDURE command the DB2 DSNZPARM module.
completed successfully.
System Action: The attempt to connect to DB2 is
token The procedure name supplied on the STOP rejected.
PROCEDURE command
System Programmer Response: If you want to start
System Action: The STOP PROCEDURE command the DB2-established stored procedure address space
processing continues. fromthe MVS console, you must use an MVS procedure
name that matches the value in the DB2 DSNZPARM
module.
DSNX950I csect-name PROCEDURE procname
HAS NOT BEEN ACCESSED
DSNX954I csect-name ATTEMPT TO START
Explanation: The procedure name supplied on the DB2-Established STORED
DISPLAY PROCEDURE command has not yet been PROCEDURE ADDRESS SPACE
accessed by any SQL CALL statement. The specified PROC= jclproc FAILED
procname might not be present in the
SYSIBM.SYSROUTINES catalog table. Explanation: DB2 attempted to start the
DB2-established stored procedure address space using
procname the JCL proc name specified in the DB2 DSNZPARM
The name of the stored procedure module. MVS failed the request.
System Action: Processing continues for any Possible causes for the start failing include:
additional procedure names supplied on the command.
v JCL proc not found
v JCL error in the proc
DSNX951I csect-name A STORED PROCEDURE
CANNOT ISSUE START/STOP jclproc The name of the JCL PROC used to start the
PROCEDURE COMMANDS stored procedures address space.
Explanation: A stored procedure attempted to issue System Action: The DB2-established stored
the START or STOP PROCEDURE command. This is procedures address space will not be available.
Chapter 21. DB2 Messages 619
DSNX955I • DSNX961I
System Programmer Response: Correct the error asid The MVS ASID of the address space where
and use the -START PROCEDURE(*) command to start the load was issued.
the DB2-established stored procedure address space.
wlmenv The name of the WLM application environment
where the load was issued. If it executed in the
DSNX955I DB2-established stored procedures address
space, this field will contain blanks.
Explanation: A blank line that appears in the
DISPLAY PROCEDURE or DISPLAY FUNCTION System Action: The address space attempting to
command. process stored procedures or functions terminates.
System Action: The DISPLAY command processing System Programmer Response: Change the
continues. STEPLIB DD statement in the JCL used to start the
stored procedure address space, or install the CEEPIPI
module in one of the libraries already accessible to the
DSNX956I ------ SCHEMA = schema
address space.
Explanation: This message reports the schema name
After the CEEPIPI module is accessible, use one of the
requested on the DISPLAY PROCEDURE or DISPLAY
following techniques to restart the failing stored
FUNCTION command.
procedure address space:
schema v If the error was in a WLM-established stored
The schema name for the stored procedure or procedures address space, use the MVS VARY
function. WLM,APPLENV=name,RESUME command.
System Action: The DISPLAY command processing v If the error was in the DB2-established stored
continues. procedures address space, use the -START
PROCEDURE(*) command.
DSNX957I csect-name INSUFFICIENT AUTHORITY Problem Determination: Collect the following
FOR OBJECT object diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 1.
Explanation: This message is issued when a START,
STOP, or DISPLAY command is issued for a stored
procedure or user-defined function that the user is not | DSNX961I csect-name ATTEMPT TO PERFORM
authorized to START, STOP, or DISPLAY. | JNI FUNCTION function FAILED FOR
| STORED PROCEDURE procedure-name
object The stored procedure or user-defined function | SSN=ssn PROC=jclproc ASID=asid
that failed the authorization test. | CLASS=class-name METHOD=method-
System Action: The START, STOP, or DISPLAY | name ERROR INFO= error-information
command continues. | Explanation: A WLM-established stored procedures
| address space was unable to perform a Java Native
DSNX960E csect-name SOME SQL CALL | Interface (JNI) function.
STATEMENTS CANNOT BE | function
PROCESSED, BECAUSE THE | The JNI function that failed. Possible values are:
Language Environment ROUTINE
CEEPIPI CANNOT BE LOADED SSN= | GET_DEFAULTS
ssn PROC= jclproc ASID= asid | JNI_GetDefaultJavaVMInitArgs
WLM_ENV= wlmenv
| CREATE_VM JNI_CreateJavaVM
Explanation: To execute an SQL CALL statment, DB2
| CALL_METHOD
must load the Language Environment interface module
| CallStaticVoidMethodA
(CEEPIPI). If the CEEPIPI module is not included in an
accessible data set such as STEPLIB data sets, | procedure-name
JOBLIB data sets, or the LPA library, DB2 is unable to | The name of the stored procedure that was
call Language Environment to process stored procedure | invoked.
or function requests.
| ssn
ssn The name of the DB2 subsystem to which the | The name of the DB2 subsystem to which the
stored procedures address space was | stored procedures address space is connected.
connected.
| jclproc
ssn The name of the JCL PROC used to start this | The name of the JCL procedure that was used to
stored procedures address space. | start the stored procedures address space.
620 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNX962I
| asid end_seq
| The MVS ASID of the address space in which End a sequence of calls using
| function was invoked. CEEPIPI.
| classname identify
| The name of the class that contains the Java Identify the language the module was
| method to be invoked. written in.
| method init_main
| The name of the Java method to be invoked. Create Language Environment run
time environment.
| error-information
| The error information from the toString method for init_sub_dp
| the Java error. Create Language Environment sub
run time environment.
| System Action: The CALL statement fails.
term Terminate the Language Environment
| System Programmer Response: Take the run time environment.
| appropriate action, depending on the value of function:
start_seq
| GET_DEFAULTS or CREATE_VM Start a sequence of calls using
| Ensure that the ET/390 DLLs are in the STEPLIB
CEEPIPI.
| concatenation for the stored procedures address
| space, or the OS/390 UNIX System Services ssn The name of the DB2 subsystem to which the
| external link is set correctly to the PDSE that stored procedures address space was
| contains the DLLs. connected.
| CALL_METHOD jclproc The name of the JCL PROC used to start this
| Fix the problem that is identified in stored procedures address space.
| error-information.
asid The MVS ASID of the address space where
| the CEEPIPI error was encountered.
DSNX962I csect-name THE Language Environment
wlmenv The name of the WLM application environment
CEEPIPI SERVICE RETURNED AN
where the CEEPIPI error was encountered. If it
UNEXPECTED RETURN CODE rc FOR
executed in the DB2-established stored
FUNCTION func SSN= ssn PROC=
procedures address space, this field will
jclproc ASID= asid WLM_ENV= wlmenv
contain blanks.
Explanation: DB2 uses the Language Environment
System Action: The attempt to run a stored
CEEPIPI service to load and execute user-written stored
procedure fails. The DB2 stored procedure address
procedures. The Language Environment return code rc
space attempts any new stored procedure requests it
was not expected for the indicated Language
receives.
Environment function call.
System Programmer Response: The Language
rc The return code received from CEEPIPI.
Environment return codes from CEEPIPI are
func The function requested by DB2. Possible documented in Language Environment for OS/390 &
values are: VM Programming Guide.
add_entry If the values of func and rc are ’ADD_ENTRY’ and
Add an entry to the Language X'0000000C', the error might be caused by using a
Environment PIPI table dynamically. compiler that is not Language Environment enabled to
create the stored procedure. DB2 stored procedures
call_main
must be compiled with a compiler that supports
Run a main program stored procedure
Language Environment.
using an existing Language
Environment run time environment. Problem Determination: Collect the following
diagnostic item listed in “Appendix B. Problem
call_sub
determination” on page 1281: 1.
Run a sub program stored procedure
using an existing Language
Environment run time environment.
delete_entry
Delete an entry from the Language
Environment PIPI table dynamically.
Chapter 21. DB2 Messages 621
DSNX964I • DSNX967I
ssn The name of the DB2 subsystem that called
DSNX964I csect-name THE DB2-
the stored procedure or function.
EstablishedSTORED PROCEDURES
ADDRESS SPACE FOR SUBSYSTEM jclproc The name of the JCL PROC used to start this
subs IS STARTED stored procedures address space.
Explanation: The DB2-established stored procedures asid The MVS ASID of the address space where
address space is now available to process SQL CALL the stored procedure executed.
statements.
wlmenv The name of the WLM application environment
subs The name of the DB2 subsystem to which the where the stored procedure executed. If it
DB2-established stored procedures address executed in the DB2-established stored
space is connected. procedures address space, this field will
contain blanks.
System Action: Processing continues.
System Action: The attempt to run this stored
procedure failed. The DB2 stored procedure address
DSNX965I csect-name THE DB2-Established
space attempts any new stored procedure requests it
STORED PROCEDURES ADDRESS
receives.
SPACE FOR SUBSYSTEM subs IS
STOPPING System Programmer Response: A description of the
Language Environment enclave return code and the
Explanation: The DB2-established stored procedures
condition token are documented in Language
address space is terminating. Termination occurs when
Environment for OS/390 & VM Programming Guide. In
all active stored procedures in the DB2-established
many cases the feedback information contains a
stored procedures address space return control to DB2.
Language Environment message number. These are
subs The name of the DB2 subsystem to which the documented in Language Environment for MVS & VM.
DB2-established stored procedures address
Problem Determination: Collect the following
space was connected.
diagnostic item listed in “Appendix B. Problem
System Action: DB2 continues to process any stored determination” on page 1281: 1. 4.
procedures that are currently running. If a new SQL
CALL statement is received that is to be executed in the
DSNX967I csect-name ATTEMPT TO PERFORM
DB2-established stored procedures address space the
WLM FUNCTION func FAILED WITH
request is queued.
WLM RC= rc RSN= rsn SSN= ssn
PROC= jclproc ASID= asid WLM_ENV=
DSNX966I csect-name STORED PROCEDURE OR wlmenv
FUNCTION sp FAILED. Language
Explanation: A WLM-established stored procedures
Environment ENCLAVE RC = erc,
address space was unable to perform a WLM operation
FEEDBACK INFORMATION = fi SSN=
required to communicate with WLM.
ssn PROC= jclproc ASID= asid
WLM_ENV= wlmenv func The WLM function that failed. Possible values
are:
Explanation: DB2 uses the Language Environment
v IWMCONN
CEEPIPI call_main or call_sub service to execute
v IWMSSEL
user-written stored procedures or user-defined function.
v IWMSTBGN
The CEEPIPI interface returned information indicating a
v IWMSTEND
failure while executing the stored procedure.
ssn The name of the DB2 subsystem to which this
sp The stored procedure or function name that
stored procedure address space was
was called using CEEPIPI.
connected.
erc The Language Environment enclave return
jclproc The name of the JCL PROC used to start this
code.
stored procedures address space.
fi Contains one or two message identifiers. The
asid The MVS ASID of the address space where
message identifiers are constructed from the
this function was invoked.
Language Environment condition token.
wlmenv The name of the WLM application environment
The message identifiers are constructed as
where this function was invoked.
follows:
v Single message: Facility_Id combined with System Action: The stored procedures service task
Msg_No that encountered the error terminates. If this is the last
v Two messages: Facility_Id combined with service task in that address space, then that address
Class_Code and Facility_Id combined with space terminates.
Cause_Code
622 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNX968I • DSNX970I
The WLM return codes and reason codes are the previous abnormal termination of
documented in MVS/ESA SP 5.3 Workload the function application. SQL statment
Management Services. In some cases the failures are requests for the function are rejected.
caused by the WLM application environment being The -START SPECIFIC FUNCTION
incorrectly defined or in a quiesced state. If you suspect command can be used to place the
an error in DB2, refer to Part 2 of DB2 Diagnosis Guide function in STARTED status.
and Reference for information on identifying and
STOPQUE
reporting the problem.
The function was stopped. SQL
Problem Determination: Collect the following statement requests for the function
diagnostic items listed in “Appendix B. Problem are queued until the function is started
determination” on page 1281: 1, 4, 5. or the installation-defined timeout
interval expires. The -START
SPECIFIC FUNCTION command can
DSNX968I csect-name STORED PROCEDURE
be used to place the function in
ADDRESS SPACE IS UNABLE TO
STARTED status.
CONNECT TO WLM BECAUSE
WLM_ENV = wlmenv IS STOPPED OR STOPREJ
QUIESCED The function was placed in this status
by the STOP SPECIFIC FUNCTION
Explanation: A DB2 stored procedures address space
ACTION(REJECT) command. SQL
could not connect to the Work Load Manager services
statement requests for the function
of MVS because the WLM application environment was
are rejected. The -START SPECIFIC
in a stopped or quiesced state.
FUNCTION command can be used to
wlmenv The name of the WLM application environment place the function in STARTED status.
for which the stored procedure address space
active The number of DB2 agents that are currently
was being started.
running this function.
System Action: The stored procedures address space
queued
terminates.
The number of DB2 agents that are currently
System Programmer Response: Correct the WLM waiting for this function to be scheduled.
application environment name that is being used by
maxque
stored procedures address space JCL proc.
The maximum number of DB2 agents that
To change the status of the application environment use have waited for this function to be scheduled,
the MVS VARY WLM,APPLENV=wlmenv,RESUME since the last START SPECIFIC FUNCTION
command. command was issued for this function.
If you suspect an error in DB2, refer to Part 2 of DB2 timeout
Diagnosis Guide and Reference for information on The number of times an SQL statement timed
identifying and reporting the problem. out while waiting for a function to be scheduled
since the last START SPECIFIC FUNCTION
Problem Determination: Collect the following command was issued for this function. An SQL
diagnostic items listed in “Appendix B. Problem statement can time out because the function
determination” on page 1281: 1, 4, 5. can be stopped by the STOP SPECIFIC
FUNCTION ACTION(QUEUE) command,
DSNX969I function status active queued maxque causing requests for the function to be queued
timeout wlm_env until the installation-defined time interval
expires.
Explanation: This message lists the DISPLAY
SPECIFIC FUNCTION information for a given external wlm_env
function. The definitions of the columns are: The MVS Workload Manager environment
name for this function.
function
The name of the external function. System Action: The DISPLAY SPECIFIC FUNCTION
command processing continues.
status The status of the function. The status can be
any of the following values:
DSNX970I FUNCTION STATUS ACTIVE QUEUED
STARTED MAXQUE TIMEOUT WLM_ENV
The function is able to accept SQL
statement requests. Explanation: This message displays the column
headings for the list of external functions generated by
STOPABN the DISPLAY SPECIFIC FUNCTION command. The
The function was stopped because of definitions are:
Chapter 21. DB2 Messages 623
DSNX971I • DSNX980E
FUNCTION
DSNX974I csect-name STOP FUNCTION SPECIFIC
The name of the external function.
SUCESSFUL FOR token
STATUS
Explanation: The function name supplied on the
The status of the function.
STOP FUNCTION SPECIFIC command completed
ACTIVE sucessfully.
The number of DB2 agents that are currently
token The function name supplied on the STOP
running this function.
FUNCTION SPECIFIC command.
QUEUED
System Action: The STOP FUNCTION SPECIFIC
The number of DB2 agents that are currently
command processing continues.
waiting for this function to be scheduled.
MAXQUE
DSNX975I csect-name - DISPLAY FUNCTION
The maximum number of DB2 agents that
SPECIFIC REPORT FOLLOWS-
have waited for this function to be scheduled,
since the last START SPECIFIC FUNCTION Explanation: This message is the title for the report
command was issued for this function. output from the DISPLAY FUNCTION SPECIFIC
command. It precedes messages DSNX969I and
TIMEOUT
DSNX970I. Message DSNX971I might also be
The number of times an SQL statement timed
displayed. The final message for the report is
out while waiting for a function to be scheduled
DSNX972I.
since the last START SPECIFIC FUNCTION
command was issued for this function. System Action: The DISPLAY FUNCTION SPECIFIC
command processing continues.
WLM_ENV
The MVS Workload Manager environment
name for this function. DSNX977I csect-name FUNCTION funcname HAS
NOT BEEN ACCESSED
System Action: The DISPLAY SPECIFIC FUNCTION
command processing continues. Explanation: The function name supplied on the
DISPLAY FUNCTION SPECIFIC command has not yet
been accessed by any SQL statement. The specific
DSNX971I FUNCTIONS begin - end STOP (act)
funcname might not be present in the
Explanation: This message indicates a STOP SYSIBM.SYSROUTINES catalog table.
SPECIFIC FUNCTION command was issued with an
funcname
asterisk (’*’) in the function name, causing a range of
The name of the function.
function names to be stopped. This message follows the
DSNX975I, DSNX969I, and any DSNX970I messages. System Action: Processing continues for any
additiona function names supplied on the command.
begin The first function name in the range of function
names that are currently stopped
DSNX980E csect-name ATTEMPT TO PERFORM
end The last function name in the range of function
CALL ATTACH FUNCTION func FAILED
names that are currently stopped
WITH DB2 SUBSYSTEM subsys.
act The action provided on the STOP SPECIFIC RETURN CODE=rc, REASON
FUNCTION command CODE=reason
System Action: The DISPLAY SPECIFIC FUNCTION Explanation: The DB2 stored procedures address
command processing continues. space was unable to perform a DB2 call attach
operation required to communicate with DB2.
DSNX972I DISPLAY FUNCTION SPECIFIC func The DB2 call attach function that failed.
REPORT COMPLETE Possible values are:
CONNECT
Explanation: The output from the DISPLAY OPEN
FUNCTION SPECIFIC command is complete. This CLOSE
message follows DSNX975I, DSN969I, and any DISCONNECT
DSNX970I messages.
subsys The DB2 subsystem name involved in the call
System Action: The DISPLAY FUNCTION SPECIFIC attach function
command processing continues.
rc The DB2 call attach return code
reason The DB2 reason code
624 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNX981E • DSNX982I
System Action: The stored procedures service task string The value provided for the parameter in error.
that encountered the error terminates. If this is the last
jclproc The name of the JCL PROC used to start this
service task in the address space, the the DB2 stored
stored procedures address space.
procedures address space terminates.
System Action: The DB2 stored procedures address
System Programmer Response: Consult the DB2
space terminates.
DB2 Application Programming and SQL Guide to
determine the cause of the DB2 call attach return code If MVS WLM is used to establish the stored procedure
and reason code. address space, WLM will retry the start of the address
space two more times. If all three attempts fail, WLM
will quiesce the WLM environment associated with the
DSNX981E csect-name THE PARAMETER parm
stored procedure address space.
CONTAINS AN INVALID VALUE ″string″
PROC= jclproc System Programmer Response: Correct the JCL
parameter used to invoke the DB2 stored procedure
Explanation: The DB2 stored procedures address
address space.
space received an invalid value in the JCL parameter
used to start the address space. If MVS WLM is used to establish the stored procedure
address space, the MVS VARY
parm The JCL parameter is specified incorrectly.
WLM,APPLENV=wlmenv,RESUME command might be
Possible values are:
required to resume the WLM application environment
SUBSYS (wlmenv) associated with the stored procedures address
This parameter can be invalid for the space.
following reasons:
v The SUBSYS parameter is null. DSNX982I csect-neme ATTEMPT TO PERFORM
v The SUBSYS parameter is too RRS ATTACH FUNCTION func FAILED
long. WITH RRS ATTACH RC= rc RSN= rsn
v The SUBSYS parameter contained SSN= ssn PROC = jclproc ASID= asid
an invalid character. WLM_ENV= wlmenv
NUMTCB Explanation: A WLM-established stored procedures
This parameter can be invalid for the address space was unable to perform an RRS attach
following reasons: operation required to communicate with DB2.
v A comma was not present in the func The RRS attach function that failed. Possible
parameter list to separate the values are:
NUMTCB parameter from the v SPAS_ID
previous parameter.
v SPAS_INIT_SP
v The NUMTCB parameter is null.
v SPAS_TERM_SP
v The NUMTCB parameter contained
nonnumeric characters. ssn The name of the DB2 subsystem involved with
the RRS attach function.
v The value of the NUMTCB
parameter is zero. jclproc The name of the JCL PROC used to start the
v The value of the NUMTCB stored procedures address space.
parameter is negative. asid The MVS ASID of the address space where
v The value of the NUMTCB the function was attempted.
parameter is greater than the
maximum number of TCBs allowed wlmenv The name of the WLM application environment
in the DB2 stored procedures where the function was attempted.
address space. System Action: The stored procedures service task
APPLENV that encountered the error terminates. If this is the last
This parameter can be invalid for the service task in that address space, then that address
following reasons: space terminates.
v A comma was not present in the System Programmer Response: If you suspect an
parameter list to separate the error in DB2, refer to Part 2 of DB2 Diagnosis Guide
APPLENV parameter from the and Reference for information on identifying and
previous parameter. reporting the problem.
v The value of the APPLENV Problem Determination:
parameter is longer than eighteen
characters. Collect the following diagnostic items listed in
Chapter 21. DB2 Messages 625
DSNX983I • DSNX988I
“Appendix B. Problem determination” on page 1281: 1,
| DSNX986I ATTEMPT TO func FAILED WITH RV =
4, 5.
| rv RC = rc RSN = rsn SSN = ssn PROC
| = jclproc
DSNX983I csect-neme DB2 STORED PROCEDURE
| Explanation: A WLM-established stored procedures
SUPPORT CODE AND SUBSYSTEM
| address space was unable to register itself to OS/390
CODE ARE NOT AT THE SAME LEVEL
| UNIX System Services. OS/390 UNIX System Services
SSN= ssn PROC = jclproc
| are not available to stored procedures running in the
Explanation: A DB2 stored procedures address space | address space.
could not connect to the DB2 subsystem. This occurred
| func The dub setting used by OS/390 UNIX System
because the DB2 code in the stored procedures
| Services BPX1SDD callable service. This can
address space was not at the same release level as the
| be DUBPROCESS or DUBTHREAD.
code in the DB2 subsystem.
| rv The return value given by OS/390 UNIX
ssn The name of the DB2 subsystem that the
| System Services BPX1SDD callable service.
stored procedure address space was
attempting to connect with. | rc The return code given by OS/390 UNIX
| System Services BPX1SDD callable service.
jclproc The name of the JCL PROC used to start the
stored procedures address space. | rsn The reason code given by OS/390 UNIX
| System Services BPX1SDD callable service.
System Action: The stored procedures address space
terminates. | ssn The name of the DB2 subsystem to which this
| stored procedure address space was
System Programmer Response: Correct the DB2
| connected.
library name in the STEPLIB for the JCL proc for the
stored procedures address space. Make the library | proc The name of the JCL PROC used to start this
name the same as the library name used for the DB2 | stored procedures address space.
subsystem address spaces. If you suspect an error in
DB2, refer to Part 2 of DB2 Diagnosis Guide and
| System Action: The stored procedure address space
Reference for information on identifying and reporting
| initialization continues. OS/390 UNIX System Services
the problem.
| callable services’ return values, return codes, and
| reason codes are documented in OS/390 UNIX System
Problem Determination: Collect the following | Services Messages and Codes.
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 1, 4, 5.
| Most failures are due to the user ID associated with the
| WLM-established stored procedures address space not
| being RACF defined. If you suspect an error in DB2,
DSNX984I csect-name ALL FUNCTIONS STARTED | refer to Part 3 of DB2 Diagnosis Guide and Reference
FOR THIS SCHEMA. | for information on identifying and reporting the problem.
Explanation: All functions are started for the schema
listed in the preceeding DSNX956I message. This DSNX987I csect-name SCHEMA NAME
message is issued only when STOP FUNCTION schema-name INVALID, COMMAND
SPECIFIC(*.*) was in effect. IGNORED
System Action: The DISPLAY SPECIFIC FUNCTION Explanation: The function name or procedure name
command processing continues. supplied on the DISPLAY, START, or STOP, FUNCTION
SPECIFIC or PROCEDURE command uses a invalid
wildcard schema name. The qualified routine name
DSNX985I csect-name ALL PROCEDURES
must specify a full schema name, ″*″, ″*.*″, or blanks.
STARTED FOR THIS SCHEMA.
schema-name
Explanation: All procedures are started for the
The schema name containing invalid
schema listed in the preceeding DSNX956I message.
characters.
This message is issued only when a STOP
PROCEDURE(*.*) was in effect. System Action: The START, STOP, or DISPLAY
command is rejected.
System Action: The DISPLAY PROCEDURE
command processing continues.
DSNX988I csect-name ALL OTHER FUNCTIONS IN
OTHER SCHEMAS STOPPED act
Explanation: A STOP FUNCTION SPECIFIC(*.*) is
currently in effect. Any functions not listed in the
626 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSNX989I • DSNX993I
preceeding DSNX969, DSNX971, and DSNX976 | System Action: The stored procedure address space
messages are stopped act. | initialization continues.
act The action provided on the STOP FUNCTION
command | DSNX993I csest-name CALL TO REXX
| PROCEDURE execname FAILED,
System Action: The DISPLAY SPECIFIC FUNCTION
| FUNCTION = function RC = rc RSN = rsn
command processing continues.
| Explanation: An attempt to establish an environment
| to run a REXX stored procedure has failed. Use the
DSNX989I csect-name ALL OTHER PROCEDURES
| following pieces of information to identify the error:
IN OTHER SCHEMAS STOPPED act
| execname
Explanation: A STOP PROCEDURE(*.*) is currently in
| The name of the REXX exec.
effect. Any functions not listed in the preceeding
DSNX942, DSNX943, and DSNX950 messages are | function
stopped act. | The TSO or REXX function call that failed. It
| can be one of three values: IKJTSOEV,
act The action provided on the STOP
| IRXINIT, or IRXEXEC. For more information
PROCEDURE command
| regarding the IKJTSOEV function, refer to
System Action: The DISPLAY PROCEDURE | OS/390 TSO/E Programming Services. For
command processing continues. | information regarding IRXINIT and IRXEXEC,
| refer to OS/390 TSO/E REXX Reference
| DSNX990E csect-name IMS ODBA INITIALIZATION | rc The return code for the specific function,
| FAILED BECAUSE THE CALLABLE | provided by TSO or REXX. For return code
| INTERFACE CANNOT BE LOADED | explanations, refer to OS/390 TSO/E
| Programming Services and OS/390 TSO/E
| Explanation: The IMS ODBA callable interface module | REXX Reference.
| cannot be loaded. No IMS database DL/I calls will be
| supported from stored procedures. Ensure the load | reason The reason code for the specified function,
| module named AERTDLI is located within the | provided by TSO or REXX. For reason code
| partitioned dataset specified in the stored procedure | explanations, refer to OS/390 TSO/E
| address space startup procedure’s DFSRESLB dd card | Programming Services and OS/390 TSO/E
| statement. | REXX Reference.
| System Action: The stored procedure address space | System Action: The stored procedure address space
| initialization continues. | initialization continues.
| Problem Determination: View the file associated with
| DSNX991I csect-name IMS ODBA INITIALIZATION | the SYSTSPRT DD card in the Stored Procedure
| COMPLETED | Address Space start-up procedure. This file contains
| diagnostic messages issued by TSO regarding the
| Explanation: The initialization of the IMS ODBA | failing function. Refer to OS/390 TSO/E Messages for
| callable interface has completed. Stored procedure | any messages found in the SYSTSPRT.
| applications may use DL/I calls to access IMS
| databases.
| System Action: The stored procedure address space
| initialization continues.
| DSNX992E csect-name IMS ODBA INITIALIZATION
| FAILURE, AIB RC = rc
| Explanation: The initialization of the IMS ODBA
| callable interface has failed. Stored procedure
| applications cannot use DL/I calls to access IMS
| databases.
| rc The AIB return code provided by IMS for the
| CIMS INIT call. Refer to the section on DL/I
| Return and Reason Codes in IMS Application
| Programming: Database Manager for more
| information regarding the failure.
Chapter 21. DB2 Messages 627
628 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 22. DSNY... Messages
DSNY001I SUBSYSTEM STARTING DSNY006I csect-name INVALID AMODE OR
RMODE ATTRIBUTE FOUND FOR
Explanation: The -START DB2 command is accepted.
LOAD MODULE module name
This message is issued to the MVS console that issued
the -START command. The DSN9022I message is sent Explanation: The Initialization Procedures
when the DB2 subsystem startup process has subcomponent detected that a module had an invalid
completed. Refer to the DSN9022I message for AMODE or RMODE attribute when it was loaded. In the
additional information. error message, 'module name' is the name of the load
module with an invalid addressing or residency mode.
System Action: DB2 startup processing begins.
System Action: DB2 subsystem startup is terminated.
DSNY002I SUBSYSTEM STOPPING Operator Response: Notify the system programmer of
the failure.
Explanation: The -STOP DB2 command is accepted.
The DSN9022I message is issued when the DB2 System Programmer Response: Verify that all
subsystem shutdown process has completed. The installation and maintenance activities against DB2 were
message is issued either to the origin of the -STOP executed using SMP, that the JCLIN for SMP includes
DB2 command (for MVS MCS console) or to the MVS the correct AMODE and RMODE control statements,
console from which the -START DB2 command was and that the Linkage Editor provided with the Data
received. Refer to the DSN9022I message for additional Facility Product (DFP) was invoked by SMP for the link
information. edits. Correct the procedure or JCL that caused the
error and rerun the necessary SMP jobs.
System Action: DB2 subsystem shutdown is initiated.
Problem Determination: A DB2 dump was requested
to an MVS SYS1.DUMP data set. The MVS service aid
DSNY003I SUBSYSTEM IS ALREADY ACTIVE
AMBLIST provides Linkage Editor module attributes in
Explanation: The -START DB2 command has not the summary section of the LISTLOAD function output.
been accepted, because the DB2 subsystem is active.
The DSN9023I message is issued after this message.
DSNY007I LOAD MODULE DSNHDECP DOES
Refer to the DSN9023I message for additional
NOT HAVE RMODE(24) ATTRIBUTE
information.
Explanation: The named load module was not
link-edited with the required RMODE(24) attribute.
DSNY004I SUBSYSTEM IS ALREADY STOPPING
System Action: DB2 startup is abended with reason
Explanation: The -STOP DB2 command has not been
code 00E80160.
accepted either because the DB2 subsystem shutdown
is in progress for the specified option (QUIESCE or Operator Response: Notify the system programmer.
FORCE), or because the QUIESCE option was
System Programmer Response: Verify that all
specified after a FORCE option had been previously
installation and maintenance activities against
accepted. The DSN9023I message is issued after this
DSNHDECP were executed using SMP. JCLIN for SMP
message. Refer to the DSN9023I message for
must have included the correct AMODE and RMODE
additional information.
control statements. The Linkage Editor, provided with
System Action: DB2 subsystem shutdown is the Data Facility Product (DFP), was invoked by SMP
continued. for the link-edits. Correct the procedure or JCL that
caused the error and rerun the necessary SMP jobs.
DSNY005I SUBSYSTEM STARTUP TERMINATED, Problem Determination: The MVS service aid
INVALID START COMMAND AMBLIST provides Linkage Editor module attributes in
the summary section of the LISTLOAD function output.
Explanation: The DB2 subsystem can be started only
by a -START DB2 command.
DSNY008I SUBSYSTEM SHUTDOWN REQUEST
System Action: DB2 subsystem startup is terminated.
NOT ACCEPTED
Operator Response: Start the DB2 subsystem via the
Explanation: The -STOP DB2 command has not been
-START DB2 command, and reenter the rejected
accepted because a subsystem startup has not
command.
completed to the point where shutdown can occur. The
DSN9023I message is issued after this message. Refer
to the DSN9023I message for additional information.
© Copyright IBM Corp. 1982, 2001 629
DSNY009I • DSNY020I
System Action: DB2 startup continues and the -STOP and an address-space is in the message, then the
DB2 command is ignored. return code for the MVS service is located in
ASCEMULC for that address space.
User Response: Reissue the -STOP DB2 command
after subsystem startup has completed.
| DSNY009I SUBSYSTEM STARTING IN LIGHT
| MODE, NORMAL TERMINATION TO
| FOLLOW RELEASE OF RETAINED
| LOCKS
| Explanation: DB2 issues this message during DB2
| startup if it is restarted in light mode.
| System Action: DB2 startup continues normally.
DSNY010I LOAD MODULE module name IS NOT
AT THE CORRECT RELEASE/VERSION
LEVEL
Explanation: The named load module is not at the
correct release/version level for the version of DB2 that
was being started.
System Action: DB2 startup is abended with reason
code 00E80161.
Operator Response: Notify the system programmer.
System Programmer Response: Verify that the
correct load libraries are being used. Also verify that the
application of maintenance did not result in modules
being link edited into the wrong load libraries.
| DSNY015I LIGHT(YES) ON START DB2
| COMMAND WAS IGNORED, SYSTEM IS
| NOT ENABLED FOR DATA SHARING
| Explanation: DB2 issues this message during startup
| if DB2 is started with the LIGHT(YES) keyword and the
| system is not enabled for data sharing.
| System Action: DB2 startup continues normally,
| ignoring the LIGHT(YES) keyword.
DSNY020I csect-name MEASURED USAGE DATA
IS NOT BEING RECORDED FOR
subsystem/address-space
Explanation: For measured usage data to be
recorded, SMF type 89 records must be collected. Two
PTFs must be applied: one to the early code and one to
the base. Until both are active, measured usage data
cannot be recorded.
System Action: Processing continues, but measured
usage for either the DB2 subsystem or the specified
DB2 address space is not recorded.
Programmer Response: If measured usage data is
needed, be sure that SMF type 89 records are collected
and that both PTFs are applied to the running system.
An IPL is required for the change to early code.
If the records are being recorded, the PTFs are applied,
630 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 23. DSNZ... Messages
parm-csect is down level and must be reassembled.
DSNZ002I src DSNZINIT SUBSYSTEM ssnm
SYSTEM PARAMETERS LOAD System Action: DB2 subsystem startup processing
MODULE NAME IS dsnzparm-name stops.
Explanation: DB2 subsystem 'ssnm' is being started Operator Response: Verify that the correct system
with the 'dsnzparm-name' DSNZPARM load module. parameters name was specified. If the correct name
This message is written to the MVS console which was specified, then notify the system programmer.
entered the -START DB2 command. The message will
also appear in the JES SYSLOG and on the JES job System Programmer Response: Verify that:
log of ssnmMSTR. The message contains the name of v The system parameters load module is for the
the DSNZPARM load module entered by the operator or release of DB2 being started.
the default name (DSNZPARM) if no name was entered. v The correct load libraries are being used to load the
System Action: DB2 startup processing continues. system parameters load module.
If these are correct, then reassemble and relink-edit
DSNZ003I csect-name DSNZINIT CSECT your system parameters load module.
parm-csect NOT FOUND IN SYSTEM
PARAMETERS.
| DSNZ006I src SUBSYS ssnm SYSTEM
Explanation: The named parm-csect was not found in | PARAMETERS LOAD MODULE NAME
the system parameters (ZPARM) specified when starting | module-name IS BEING LOADED
DB2. This CSECT is required to start DB2. The name of
the system parameters load module that is missing this | Explanation: DB2 subsystem ssnm is loading
CSECT is identified in previously issued message | parameters from module-name subsystem parameters
DSNZ002I. | load module.
This error can occur if the system parameters load | System Action: DB2 online refresh of subsystem
module specified is for a different release of DB2. | parameters continues.
System Action: DB2 subsystem startup processing
stops. | DSNZ007I src SUBSYS ssnm SYSTEM
| PARAMETERS LOAD MODULE NAME
Operator Response: Verify that the correct system | module-name LOAD COMPLETE
parameters name was specified. If the correct name
was specified, notify the system programmer. | Explanation: DB2 subsystem ssnm has loaded
| subsystem parameters load module module-name, and
System Programmer Response: Verify that: | has notified all resource managers.
v The system parameters load module is for the
release of DB2 being started.
| DSNZ008I src CSECT parm-csect NOT FOUND IN
v The correct load libraries are being used to load the | SYSTEM PARAMETERS
system parameters load module.
| Explanation: The named parm-csect was not found in
If these are correct, then reassemble and relink-edit | the subsystem parameters load module specified in the
your system parameters load module. | -SET SYSPARM command. Message DSNZ007I, which
| was issued prior to this message, identifies the name of
DSNZ004I csect-name DSNZINIT INCORRECT | the subsystem parameters load module that is missing
LEVEL wrong-level FOUND IN | this CSECT.
parm-csect SYSTEM PARAMETERS. | System Action: DB2 online refresh of subsystem
LEVEL correct-level IS REQUIRED. | parameters terminates.
Explanation: The system parameters load module | System Programmer Response: Verify that:
CSECT parm-csect contains an incorrect level identifier.
| v The system parameters load module matches the
The CSECT contains a level identifier of wrong-level
| release level of the DB2 that was started.
and the DB2 that is starting requires a level identifier of
correct-level. | v The correct load libraries are being used to load the
| system parameters load module.
This error can occur if the system parameters load
module specified is for a different release of DB2. This | If these are correct, then reassemble and relink-edit
error can also occur if the system parameters load | your system parameters load module.
module is missing some maintenance. In this case the
© Copyright IBM Corp. 1982, 2001 631
DSNZ009I • DSNZ014I
| DSNZ009I src INCORRECT LEVEL wrong-level | DSNZ013I src SUBSYS ssnm SYSPARM
| FOUND IN parm-csect SYSTEM | COMMAND REJECTED, COMMAND
| PARAMETERS. LEVEL correct-level IS | ALREADY IN PROGRESS
| REQUIRED.
| Explanation: The current -SET SYSPARM command
| Explanation: This message, issued during -SET | is rejected due to processing of a previous -SET
| SYSPARM command processing, indicates the specified | SYSPARM command.
| subsystem parameters load module CSECT parm-csect
| contains an incorrect level identifier. The CSECT | System Action: Online refresh of subsystem
| contains a level identifier of wrong-level. | parameters for this command is rejected.
| The active DB2 subsystem requires a level identifier of
| User Response: Retry the command after the
| correct-level. This error can occur if the specified
| previous -SET SYSPARM command completes.
| subsystem parameters load module does not match the
| release level of the DB2 system. This error can also | DSNZ014I src PARAMETER parm-name IN CSECT
| occur if the subsystem parameters load module requires | load-csect-name CANNOT BE
| additional maintenance. In the latter case, the | CHANGED ONLINE. PARAMETER
| parm-csect is down-level and requires reassembly. | CHANGE IGNORED.
| System Action: DB2 online refresh of subsystem | Explanation: Subsystem parameter parm-name in
| parameters terminates. | load-csect-name is different from its start-up value, but
| parm-name cannot be changed online.
| DSNZ010I src SUBSYS ssnm SYSTEM | System Action: DB2 uses the start-up value for
| PARAMETERS LOAD MODULE NAME | parameter parm-name.
| module-name NOT FOUND, BLDL
| R15=rc, R0=rsn
| Explanation: During -SET SYSPARM command
| processing on subsystem ssnm, the specified
| subsystem parameters load module module-name could
| not be located during MVS BLDL processing. The BLDL
| issued a return code of rc and a reason code of rsn.
| System Action: DB2 online refresh of subsystem
| parameters terminates.
| System Programmer Response: Verify that the
| named load module exists, and that DB2 can access it.
| DSNZ011I src SUBSYS ssnm SYSTEM
| PARAMETERS SET TO STARTUP
| Explanation: DB2 issues this message when the
| STARTUP parameter is specified on the -SET
| SYSPARM command. The message indicates that the
| subsystem parameters specified at DB2 startup are now
| in effect.
| System Action: Processing continues.
| DSNZ012I src SUBSYS ssnm SYSTEM
| PARAMETERS LOAD MODULE NAME
| module-name NOT LOADED, LOAD
| R15=rc, R1=rsn
| Explanation: DB2 issues this message during -SET
| SYSPARM command processing on subsystem ssnm,
| where the load of module-name failed. rc and rsn are
| the return and reason codes from the MVS LOAD.
| System Action: Online refresh of subsystem
| parameters terminates.
632 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 24. DSN1... Messages
The messages in this section apply to DSN1LOGP, DSN1COPY, DSN1COMP,
DSN1PRNT, and DSN1CHKR.
The value shown for 'severity' is the value returned as the job-stepcondition code
from the job step in which the message is issued. If additional messages having
higher severity values are issued during the same job step, the higher value is
reflected as the job-step condition code.
Severity values have the following meanings:
0 An informational message. No error occurred.
4 A warning message. A condition was detected of which the user should be
aware. The user might need to take further action.
8 An error message. An error situation was detected and processing could
not continue.
12 A severe error message. A severe error situation was detected and
processing could not continue.
DSN1110E LIMIT OF 50 STATEMENTS EXCEEDED DSN1113E VALUE FOR KEYWORD xxxxxxxx
INVALID
Explanation: DSN1LOGP allows a total of 50
statements for a given job. Explanation: The SYSIN input contains the keyword
'xxxxxxxx'. The value specified for that keyword is not of
Severity: 8 (error)
the form '( value )'.
System Action: Processing is terminated.
Severity: 8 (error)
User Response: Resubmit the job using no more than
System Action: Processing is terminated.
50 statements.
User Response: Resubmit the job with the correct
form of the keyword. The problem might be that the
DSN1111E LIMIT OF 80 TOKENS EXCEEDED
closing parenthesis ')' is missing or that an extra blank
Explanation: DSN1LOGP allows a total of 80 exists in the value.
keywords and corresponding value specifications. A
keyword with its value is considered two tokens.
DSN1114E RBASTART MULTIPLY DEFINED
Severity: 8 (error)
Explanation: The RBASTART parameter can be
System Action: Processing is terminated. specified only once for a given job.
User Response: Resubmit the job using no more than Severity: 8 (error)
80 keywords.
System Action: Processing is terminated.
User Response: Resubmit the job using a single
DSN1112E TOKEN xx..xx EXCEEDS 64
RBASTART value.
HEXADECIMAL CHARACTERS
Explanation: The SYSIN input contains the character
DSN1115E csect-name KEYWORD keyword
string 'xx..xx'. This string is invalid.
ALLOWS ONLY number HEX
Severity: 8 (error) CHARACTERS
System Action: Processing is terminated. Explanation: The value given for keyword is too long.
User Response: Resubmit the job with the specified Severity: 8 (error)
token being no more than 64 hexadecimal characters in
System Action: Processing is terminated.
length.
User Response: Resubmit the job providing no more
than the maximum number of characters allowed for the
keyword.
© Copyright IBM Corp. 1982, 2001 633
DSN1116E • DSN1126E
DSN1116E csect-name keyword IS USED MORE DSN1121E DBID > 4 HEX CHARACTERS
THAN ONCE.
Explanation: A DBID is 2 bytes in length (hence, 4
Explanation: The keyword can be used only once in a characters maximum).
single job.
Severity: 8 (error)
Severity: 8 (error)
System Action: Processing is terminated.
System Action: Processing is terminated.
User Response: Resubmit the job providing a DBID
User Response: Resubmit the job providing a single which is no longer than 4 hexadecimal characters.
keyword.
DSN1122E OBID MULTIPLY DEFINED
DSN1117E csect-name keyword SPECIFIED WITH
Explanation: The OBID keyword can be specified only
NO VALUE OR INCORRECT VALUE
once for a given job.
Explanation: The keyword must be followed by a
Severity: 8 (error)
correct value.
System Action: Processing is terminated.
Severity: 8 (error)
User Response: Resubmit the job providing a single
System Action: Processing is terminated.
OBID value.
User Response: Resubmit the job providing a correct
value for the keyword.
DSN1123E OBID SPECIFIED WITH NO VALUE
Explanation: The OBID keyword specifies a
DSN1118E RBAEND > 12 HEX CHARACTERS
hexadecimal database object identifier. OBID must be
Explanation: The maximum size of a log RBA in DB2 followed by a value.
is 6 bytes (hence, 12 characters).
Severity: 8 (error)
Severity: 8 (error)
System Action: Processing is terminated.
System Action: Processing is terminated.
User Response: Resubmit the job providing an OBID
User Response: Resubmit the job providing an (value).
RBAEND value that is no more than 12 hexadecimal
characters.
DSN1124E OBID > 4 HEX CHARACTERS
Explanation: An OBID is 2 bytes in length (hence, 4
DSN1119E DBID MULTIPLY DEFINED
characters maximum).
Explanation: The DBID keyword can be specified only
Severity: 8 (error)
once for a given job.
System Action: Processing is terminated.
Severity: 8 (error)
User Response: Resubmit the job providing an OBID
System Action: Processing is terminated.
which is no longer than 4 hexadecimal characters.
User Response: Resubmit the job providing a single
DBID value.
DSN1125E PAGE SPECIFIED WITH NO VALUE
Explanation: The PAGE keyword specifies a
DSN1120E DBID SPECIFIED WITH NO VALUE
hexadecimal page number. PAGE must be followed by
Explanation: The DBID keyword specifies a a value.
hexadecimal database identifier and must be followed
Severity: 8 (error)
by a value.
System Action: Processing is terminated.
Severity: 8 (error)
User Response: Resubmit the job providing a PAGE
System Action: Processing is terminated.
(value).
User Response: Resubmit the job providing a DBID
(value).
DSN1126E PAGE > 6 HEX CHARACTERS
Explanation: A page number is 3 bytes in length
(hence, 6 characters maximum).
Severity: 8 (error)
634 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN1127E • DSN1136E
System Action: Processing is terminated. System Action: Processing is terminated.
User Response: Resubmit the job providing a PAGE User Response: Resubmit the job providing a correct
value which is no longer than 6 hexadecimal characters. hexadecimal value specification.
DSN1127E KEYWORD xxxxxxxx UNKNOWN DSN1132E URID SPECIFIED WITH NO VALUE
Explanation: DSN1LOGP does not recognize the Explanation: The URID keyword specifies the
keyword 'xxxxxxxx'. hexadecimal unit of recovery identifier. URID must be
followed by a value.
Severity: 8 (error)
Severity: 8 (error)
System Action: Processing is terminated.
System Action: Processing is terminated.
User Response: Check to make sure all keywords are
valid and resubmit the job. User Response: Resubmit the job providing an
associated value for the URID parameter.
DSN1128E csect-name keyword KEYWORD
SPECIFIED WITHOUT keyword DSN1133E URID > 12 HEX CHARACTERS
Explanation: The identified keywords are associated Explanation: The maximum size of a URID in DB2 is
with each other. You cannot specify one keyword 6 bytes (hence, 12 characters).
without the other keyword.
Severity: 8 (error)
Severity: 8 (error)
System Action: Processing is terminated.
System Action: Processing is terminated.
User Response: Resubmit the job providing a valid
User Response: Resubmit the job providing the URID value of no more than 12 hexadecimal characters.
corresponding correct keywords.
DSN1134E csect-name LIMIT OF number keywordS
DSN1129E PAGE WITHOUT DBID OBID IS EXCEEDED
Explanation: DB2 pages exist in objects called 'page Explanation: The keyword was specified more than
sets'. When you specify a page, you must also identify the maximum number of times allowed in any given job.
the page set by using the appropriate DBID and OBID
Severity: 8 (error)
specifications.
System Action: Processing is terminated.
Severity: 8 (error)
User Response: Resubmit the job specifying this
System Action: Processing is terminated.
keyword no more than the maximum number of times.
User Response: Resubmit the job providing the
associated DBID (value) and OBID (value) that
DSN1135E SUMMARY MULTIPLY DEFINED
correspond to the given page.
Explanation: The SUMMARY option can be specified
only once.
DSN1130E OBID WITHOUT DBID
Severity: 8 (error)
Explanation: When you specify an OBID, you must
also identify the database that contains that OBID by System Action: Processing is terminated.
specifying the DBID of the database.
User Response: Resubmit the job using a singe
Severity: 8 (error) SUMMARY specification.
System Action: Processing is terminated.
DSN1136E SUMMARY SPECIFIED WITH NO
User Response: Resubmit the job providing both an
VALUE OR INCORRECT VALUE
OBID (value) and a DBID (value).
Explanation: The permitted values for summary are
YES, NO, ONLY, or FILTER.
DSN1131E OFFSET/VALUE PAIR NUMBER xx
CONTAINS INVALID HEX DATA Severity: 8 (error)
Explanation: A hexadecimal specification is required. System Action: Processing is terminated.
The value for offset/value pair number 'xx' contains an
invalid hexadecimal character. User Response: Resubmit the job providing a valid
parameter for the SUMMARY option.
Severity: 8 (error)
Chapter 24. DB2 Messages 635
DSN1137I • DSN1146E
DSN1137I csect-name FIRST PAGE SET DSN1142E DATAONLY MULTIPLY DEFINED
CONTROL RECORD AFTER RESTART
Explanation: The DATAONLY option limits the log
LOG seq nnnnnnnnnnnn
records extracted in the detail report to those that
Explanation: This message shows the log sequence represent data modifications. This option can be
number of a record that serves as an implicit indication specified only once.
that a restart occurred just prior to this point.
Severity: 8 (error)
seq RBA or LRSN
System Action: Processing is terminated.
nnnnnnnnnnnn
User Response: Resubmit the job specifying
The log sequence number
DATAONLY once.
Severity: 0 (informational)
System Action: Processing continues. DSN1143E DATAONLY SPECIFIED WITH NO
VALUE OR INCORRECT VALUE
DSN1138E csect-name keyword AND keyword Explanation: The DATAONLY keyword must be
CANNOT BOTH BE SPECIFIED specified with either a YES or NO value. Any other
value (including no value) is incorrect.
Explanation: You cannot specify both keywords in one
job. Severity: 8 (error)
Severity: 8 (error) System Action: Processing is terminated.
System Action: Processing is terminated. User Response: Resubmit the job specifying the
correct value for the DATAONLY parameter.
User Response: Resubmit the job specifying only one
of the keywords.
DSN1144E RBASTART SPECIFIED WITH NO
VALUE
DSN1139E RID SPECIFIED WITH NO VALUE
Explanation: The RBASTART keyword specifies the
Explanation: The RID keyword specifies a 4-byte
hexadecimal log RBA from which to begin extraction.
hexadecimal number, with the first 3 bytes representing
RBASTART must be followed by a value.
the page number and the last byte representing the
record ID. A value must be associated with the RID. Severity: 8 (error)
Severity: 8 (error) System Action: Processing is terminated.
System Action: Processing is terminated. User Response: Resubmit the job providing an
associated value for the RBASTART parameter.
User Response: Resubmit the job providing a RID
(value).
DSN1146E CURRENT END CHECKPOINT
TIMESTAMP TIMESTAMP=yy.ddd
DSN1140E RID > 8 HEX CHARACTERS
hh.mm.ss LOG RBA=xxxxxx IS OUT
Explanation: The maximum size of a RID in DB2 is 4 OF SEQUENCE. THE GREATEST
bytes (hence, 8 characters). TIMESTAMP SEEN SO FAR IS
TIMESTAMP=yy.ddd hh.mm.ss LOG
Severity: 8 (error) RBA=xxxxxx Multiple processors may
System Action: Processing is terminated. be writing to the same log.
User Response: Resubmit the job providing a valid Explanation: This message indicates that the current
RID value of no more than 8 hexadecimal characters. log record has a timestamp that is less than the
previous timestamp processed. This may be a potential
problem.
DSN1141E RID WITHOUT DBID OBID
Severity: 4 (warning)
Explanation: The DBID and OBID associated with the
given RID value must be specified. System Action: Processing continues.
Severity: 8 (error) User Response: Examine current log to determine
whether multiple processors are writing to the same log.
System Action: Processing is terminated. (Data may be being overwritten.) This may lead to data
User Response: Resubmit the job providing the inconsistencies.
associated DBID (value) and OBID (value) that
correspond to the given RID value.
636 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN1147E • DSN1151I
DSN1147E SYSCOPY MULTIPLY DEFINED DSN1151I csect-name mbn UR CONNID=cc
CORRID=bb AUTHID=aa PLAN=pp
Explanation: The SYSCOPY option can only be
START DATE=yy.ddd TIME=hh:mm:ss
specified once.
DISP=xx INFO=ii STARTRBA=ss
Severity: 8 ENDRBA=ee STARTLRSN=rr
ENDLRSN=nn NID=nid LUWID=luwid
System Action: Processing is terminated. COORDINATOR=name PARTICIPANTS:
User Response: Resubmit the job using a single (list of participants)
SYSCOPY specification. Explanation: This message describes a unit of
System Programmer Response: If you suspect an recovery (UR) that terminated for data sharing member
error in DB2, refer to Part 2 of DB2 Diagnosis Guide mbn.
and Reference for information on identifying and mbn MEMBER=membername, where membername
reporting the problem. is the member of a data sharing group. This is
Problem Determination: Collect the following printed only for a data sharing record.
diagnostic items listed in “Appendix B. Problem cc Connection ID (for example, BATCH).
determination” on page 1281: 1, 2, 5.
bb Correlation ID (for example, JOB xxx).
DSN1148E SYSCOPY SPECIFIED WITH NO VALUE aa Authorization ID executing the UR.
OR INCORRECT VALUE
pp Plan name used by the UR.
Explanation: The SYSCOPY keyword must be
DSN1LOGP returns a plan name of SYSTEM
specified with either a YES or NO value. Any other
in this field if the UR was generated as a result
value (including no value) is incorrect.
of a system event (such as the first update of a
This message is issued by the following CSECT: table space). In such a case, no bound plan
DSN1LPAR exists for the UR described.
Severity: 8 yy.ddd Starting date of the UR.
System Action: Processing is terminated. hh:mm:ss
Starting time of the UR.
User Response: Resubmit the job specifying the
correct value for the SYSCOPY parameter. xx Disposition of the UR. Values reported are:
Inflight
System Programmer Response: If you suspect an In-abort
error in DB2, refer to Part 2 of DB2 Diagnosis Guide In-commit
and Reference for information on identifying and Indoubt
reporting the problem. Committed
Problem Determination: Collect the following Aborted
diagnostic items listed in “Appendix B. Problem P-Abort
determination” on page 1281: 1, 2, 5.
If the UR was bypassed by a conditional
restart, DSN1LOGP indicates this by preceding
DSN1150I SUMMARY OF COMPLETED EVENTS the disposition value with the word
Explanation: This message heads the summary of BYPASSED.
completed units of recovery (URs) and checkpoints. If ii The status of the data is one of the following:
you suspect an error in DB2, refer to Part 2 of DB2 COMPLETE, indicating that all page sets
Diagnosis Guide and Reference for information on modified by this UR were identified.
identifying and reporting the problem. PARTIAL, indicating that the list of page
Severity: 0 (informational) sets modified by this UR is incomplete.
DSN1LOGP indicates PARTIAL status if all
System Action: Processing continues. records associated with a UR are not
available, and no checkpoint is found
before the UR’s completion.
ss RBA of the first log record associated with the
UR (that is, the URID).
ee RBA of the last log record associated with the
UR.
Chapter 24. DB2 Messages 637
DSN1152I • DSN1154I
rr LRSN of the first log record associated with the mbn MEMBER=membername, where membername
UR. is the member of a data sharing group. This is
printed only for a data sharing record.
nn LRSN of the last log record associated with the
UR
The remaining information (DISP, INFO, START, END,
nid The identifier assigned by IMS or CICS for this NID, LUWID, COORDINATOR and PARTICIPANTS)
UR. This is blank if the UR is a result of TSO, appears just as it does in message DSN1151I. If the UR
batch, or remote access. did not complete, the END RBA or LRSN values are not
printed.
luwid The logical unit of work identifier associated
with the UR
This message is followed by messages that identify the
name The name of the remote coordinator associated page sets modified by the UR. Details of that are in the
with the UR. This is blank if the coordinator is explanation of message DSN1151I.
the local DB2, IMS, or CICS.
Severity: 0 (informational)
list of participants
System Action: Processing continues.
The names of all remote participants that might
have updated data in this UR.
DSN1153I csect-name CHECKPOINT mbn
This message is followed by messages that identify the STARTRBA=ss ENDRBA=ee
page sets modified by the UR. For each page set, a STARTLRSN=rr ENDLRSN=nn
single message is printed in the following form: DATE=yy.ddd TIME=hh:mm:ss
DATABASE=dbid=dbname Explanation: This message describes a complete
PAGE SET=obid=psname checkpoint on the log starting and ending RBA or LRSN
for data sharing member mbn. If the information is
Where: available, DSN1LOGP also returns the date and time
dbid Internal database identifier | that the checkpoint started.
dbname When this message follows message DSN1157I
Database name corresponding to the dbid RESTART SUMMARY, it identifies the checkpoint that
would be used at restart. If no checkpoint is available,
obid Internal page set identifier message DSN1158I is printed instead.
psname mbn MEMBER=membername, where membername
Page set name corresponding to the OBID is the member of a data sharing group. This is
The dbname and psname fields might be printed only for a data sharing record.
absent if a full checkpoint was unavailable to Severity: 0 (informational)
DSN1LOGP or was caused by overlapped
processing of DB2 during a checkpoint. System Action: Processing continues.
If no data was modified by the UR (for example, certain DSN1154I csect-name RESTART mbn AT RBA=xx
URs might be created merely to track information that is LRSN=ll DATE=yy.ddd TIME=hh:mm:ss
valid only for the life of the application), the phrase NO
DATA MODIFIED is printed. Explanation: A normal restart occurred at log RBA xx
or LRSN ll.
Severity: 0 (informational)
mbn MEMBER=membername, where membername
System Action: Processing continues. is the member of a data sharing group. This is
printed only for a data sharing record.
DSN1152I csect-name mbn UR CONNID=**
CORRID=** AUTHID=** PLAN=** START DSN1LOGP also returns the date and time of that
DATE=** TIME=** DISP=xx INFO=ii restart.
STARTRBA=ss STARTLRSN=** Severity: 0 (informational)
ENDRBA=ee ENDLRSN=nnNID=nid
LUWID=luwid COORDINATOR=name System Action: Processing continues.
PARTICIPANTS: (list of participants)
Explanation: This message describes a unit of
recovery (UR) for data sharing member mbn. The UR
identifying information (**) described in message
DSN1151I is unavailable.
638 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN1155I • DSN1162I
DSN1155I csect-name CONDITIONAL RESTART DSN1159I NO DATABASE WRITES PENDING
mbn AT RBA=xx LRSN=ll DATE=yy.ddd
Explanation: All database I/O has been completed. If
TIME=hh:mm:ss STARTRBA=ss
the Log Extractor can find no complete checkpoint, it
ENDRBA=ee FORWARD=ff
will return an additional message '(BASED ON
BACKOUT=bb
INCOMPLETE LOG INFORMATION)', to warn you that
Explanation: A conditional restart occurred at the log there may in fact be pending database writes.
RBA xx and LRSN ll. DSN1LOGP also returns the date
Severity: 0 (informational)
and time of that restart.
System Action: Processing continues.
mbn MEMBER=membername, where membername
is the member of a data sharing group. This is
printed only for a data sharing record. DSN1160I DATABASE WRITES PENDING:
ss Relative byte address of the beginning of the Explanation: Database writes are pending at restart.
restart Each page set with outstanding I/O is identified by a
separate message following this one:
ee Relative byte address of the conclusion of the
restart
DATABASE=dbid=dbname
ff Whether forward log recovery phase was to be PAGESET=obid=psname START=ss
bypassed (YES | NO)
bb Whether backward log recovery phase was to Where:
be bypassed (YES | NO) dbid Internal database identifier
Severity: 0 (informational) dbname
System Action: Processing continues. Database name corresponding to the dbid
obid Internal page set identifier
DSN1156I ALL URS COMPLETE psname
Explanation: There are no URs outstanding for Page set name corresponding to the obid
restart.
Note: dbname and psname may be absent if a
Severity: 0 (informational) full checkpoint was unavailable to the
System Action: Processing continues. Log Extractor or was caused by
overlapped processing of DB2 during a
checkpoint.
DSN1157I RESTART SUMMARY
ss Log RBA of the earliest log record required to
Explanation: This message heads the summary of the complete outstanding writes for this page set. If
description of work to be performed at restart. Restart the value of ss is returned as **, this
information that follows is based on the scope of the log information is unavailable. Such will be the
scanned. If you suspect an error in DB2, refer to Part 2 case if the Log Extractor is unable to locate a
of DB2 Diagnosis Guide and Reference for information full checkpoint. In this event, DSN1LOGP will
on identifying and reporting the problem. return an additional message (LIST MAY BE
INCOMPLETE), to alert you to the possibility
Severity: 0 (informational)
that the list of page sets with outstanding
System Action: Processing continues. writes may be incomplete.
Severity: 0 (informational)
DSN1158I NO CHECKPOINT AVAILABLE —
System Action: Processing continues.
RESTART SUMMARY INCOMPLETE
Explanation: No checkpoint is available within the
DSN1162I csect-name mbnUR CONNID=cc
scope of the log scanned. The information following this
CORRID=bb AUTHID=aa PLAN=pp
message includes:
START DATE=yy.ddd TIME=hh:mm:ss
v URs that have not completed
DISP=xx INFO=ii STARTRBA=ss
v Page sets modified by these URs
STARTLRSN=ll NID=nidLUWID=luwid
v Page sets with writes pending.
COORDINATOR=name PARTICIPANTS:
The information cannot be considered complete. (list of participants)
Severity: 0 (informational) Explanation: This message describes a unit of
recovery (UR) that has not terminated. The information
System Action: Processing continues.
returned is the same as for message DSN1151I, except
Chapter 24. DB2 Messages 639
DSN1163E • DSN1175E
that the END field is not included in the message
DSN1171E SUBTYPE SPECIFIED WITH NO VALUE
because the UR did not terminate.
Explanation: The SUBTYPE parameter specifies a
mbn MEMBER=membername, where membername
decimal set subtype. The SUBTYPE must be followed
is the member of a data sharing group. This is
by a value, i.e. SUBTYPE(value).
printed only for a data sharing record.
Severity: 12 (severe error)
Severity: 0 (informational)
System Action: Processing terminates.
System Action: Processing continues.
User Response: Provide a SUBTYPE value and
resubmit the job.
DSN1163E NO CHECKPOINT AVAILABLE DUE TO
LOG ERROR -- RESTART SUMMARY
INCOMPLETE DSN1172E SUBTYPE > 2 DECIMAL CHARACTERS
Explanation: A log error was encountered. Explanation: The maximum size of a SUBTYPE is 2
DSN1LOGP marked any checkpoints encountered decimal characters.
before the log error as invalid. There were no complete
Severity: 12 (severe error)
checkpoints following the log error in the specified log
range. The information following this message includes: System Action: Processing terminates.
v URs that have not completed
v Page set modified by these URs User Response: Provide a SUBTYPE value with a
v Page sets with writes pending. maximum of 2 decimal characters and resubmit the job.
This information cannot be considered complete.
DSN1173E csect-name INVALID VALUE value
Severity: 0 (informational) SPECIFIED FOR KEYWORD keyword
System Action: Processing continues. Explanation: The specified keyword value is not valid.
Severity: 12 (severe error)
DSN1164E INVALID xxxx FOUND AT RBA =
yyyyyyyyyyyy System Action: Processing terminates.
Explanation: While processing the SUMMARY option, User Response: Refer to DB2 Utility Guide and
an invalid checkpoint record (either URE or RURE Reference for a list of valid values. Provide a valid value
identified by 'xxxx') was encountered in the log. and resubmit the job.
Severity: 0 (informational)
DSN1174E OFFSET SPECIFIED WITH NO
System Action: Processing continues. SUBTYPE
User Response: If the checkpoint record identified in Explanation: The given OFFSET has no
the message is used to restart DB2, the restart will fail corresponding SUBTYPE.
because DB2 will not be able to process the unit of
recovery presented by the invalid URE or RURE. DB2 This message is issued by the following CSECT:
must be restarted from a previous checkpoint to DSN1LPAR
correctly process all units of recovery. The print log map Severity: 12 (severe error)
(DSNJU004) utility can be used to list the checkpoint
records in the BSDS, and the CHKPTRBA parameter of System Action: Processing terminates.
the change log inventory (DSNJU003) utility can be User Response: Provide a valid SUBTYPE for the
used to direct the DB2 restart to use a particular given OFFSET and resubmit the job.
checkpoint.
DSN1175E OFFSET SPECIFIED WITH NO VALUE
DSN1170E SUBTYPE MULTIPLY DEFINED OR INCORRECT VALUE
Explanation: The SUBTYPE parameter can be Explanation: The given OFFSET has no
specified only once for any given job. corresponding VALUE given or an incorrect VALUE is
Severity: 12 (severe error) specified, such as specifying another keyword in place
of a value.
System Action: Processing terminates.
Severity: 12 (severe error)
User Response: Provide a single SUBTYPE value
and resubmit the job. System Action: Processing terminates.
User Response: Provide a valid VALUE for the given
OFFSET and resubmit the job.
640 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN1176E • DSN1185E
DSN1176E OFFSET > 8 HEX CHARACTERS DSN1181E VALUE SPECIFIED WITH NO
CORRESPONDING OFFSET
Explanation: The maximum size for an OFFSET is 4
bytes (hence, 8 characters). Explanation: The given VALUE has no corresponding
OFFSET specified.
Severity: 12 (severe error)
Severity: 12 (severe error)
System Action: Processing terminates.
System Action: Processing terminates.
User Response: Provide an OFFSET with a maximum
of 8 characters and resubmit the job. User Response: Provide a valid OFFSET for the
given VALUE and resubmit the job.
DSN1177E LIMIT OF 10 OFFSET, VALUE PAIRS
EXCEEDED DSN1182E LIMIT OF 10 LUWIDs EXCEEDED
Explanation: A maximum of 10 OFFSET, VALUE pairs Explanation: A maximum of 10 LUWID keywords can
can be specified for a given log record SUBTYPE. be specified in any given job.
Severity: 12 (severe error) Severity: 8 (error)
System Action: Processing terminates. System Action: DSN1LOGP processing is terminated.
User Response: Provide a maximum of 10 OFFSET, User Response: Resubmit the job providing no more
VALUE pairs for a given SUBTYPE and resubmit the than 10 LUWID keywords.
job.
DSN1183E LUWID SPECIFIED WITH INCORRECT
DSN1178E OFFSET SPECIFIED WITH NO VALUE OR NO VALUE
CORRESPONDING VALUE
Explanation: The LUWID consists of an LU network
Explanation: The given OFFSET has no name, an LUW instance number, and a commit
corresponding VALUE keyword specified. sequence number. The LU network name consists of a
1 to 8 character network ID, a period, and a 1 to 8
Severity: 12 (severe error)
character network LU name. The LUW instance number
System Action: Processing terminates. consists of a period followed by 12 hexadecimal
characters. The LUW sequence number consists of a
User Response: Provide an associated VALUE period followed by 4 hexadecimal characters.
(value) for the given OFFSET and resubmit the job.
Severity: 8 (error)
DSN1179E VALUE SPECIFIED WITH NO System Action: DSN1LOGP processing is terminated.
CORRESPONDING OFFSET OR
User Response: Resubmit the job providing a valid
SUBTYPE PARAMETER
LUWID value.
Explanation: The given VALUE has either no
corresponding OFFSET or SUBTYPE parameter
DSN1184E FILTER KEYWORD MULTIPLY DEFINED
specified.
Explanation: The FILTER keyword was specified
Severity: 12 (severe error)
more than once.
System Action: Processing terminates.
Severity: 8 (error)
User Response: Provide an associated OFFSET or
System Action: DSN1LOGP processing is terminated.
SUBTYPE for the given VALUE and resubmit the job.
User Response: Correct the input to provide only one
FILTER keyword and resubmit the job.
DSN1180E VALUE SPECIFIED WITH NO VALUE
OR INCORRECT VALUE
DSN1185E FILTER KEYWORD SPECIFIED
Explanation: The given VALUE has no corresponding
WITHOUT SUMMARY KEYWORD
value given, an incorrect value is specified, such as
specifying a keyword in place of a value, or an uneven Explanation: The FILTER keyword was specified
number of characters were specified. without an associated SUMMARY keyword.
Severity: 12 (severe error) Severity: 8 (error)
System Action: Processing terminates. System Action: DSN1LOGP processing is terminated.
User Response: Provide a valid value for the given User Response: Correct the input to include the
VALUE and resubmit the job. SUMMARY keyword and resubmit the job.
Chapter 24. DB2 Messages 641
DSN1210E • DSN1216E
System Action: Processing continues.
DSN1210E DSNJSLR ERROR RETCODE=xxxxxxxx
REASON CODE =yyyyyyyy
DSN1215I NO LOG RECORDS WERE READ
Explanation: The stand-alone log read function
detected an error. The return code (RETCODE) is Explanation: DSN1LOGP read no log records.
explained in Appendix C (Volume 2) of DB2
Administration Guide. The reason code is explained in Severity: 0 (informational)
“Part 4. DB2 Codes” on page 707. System Action: Processing continues. Possible
Severity: 8 (error) explanations:
v An error prevents DSN1LOGP from continuing, so no
System Action: Processing is terminated. log records have yet been processed. If this is the
case, an error message should precede this
DSN1211E DSNJSLR RETURNED BAD LOG RBA message.
v You specified the active log data sets or archive log
Explanation: One of the three problems listed below
data sets out of RBA sequence.
exists.
v You specified a STARTRBA that is greater than any
1. The recovery log data set is damaged.
RBA in the active and/or archive data sets available.
2. You identified a data set that isn’t a recovery log
data set.
DSN1216E csect-name DSNJSLR ERROR
3. The stand-alone log read service has a problem.
RETCODE = xxxxxxxx REASON CODE =
Severity: 0 (informational) yyyyyyyy seq = nnnnnnnnnnnn
System Action: Processing continues. Explanation: The stand-alone log read function
returned an error indicating that either the log has an
User Response: Determine if the problem is your
error in one of the control intervals (CI) or a data set
error by dumping the data set and determining if it is a
containing the requested sequence number cannot be
log data set.
located. The sequence number shown in the message
Problem Determination: A common error is to specify indicates where the error was detected.
the first data set on an archive tape (the 'Bxxxxxxx' data
seq RBA or LRSN
set) as a log data set; it is actually a BSDS.
The sequence number points:
DSN1212I csect-name FIRST LOG seq v To the start of the CI, if there is a problem with the
ENCOUNTERED nnnnnnnnnnnn log control interval definition (LCID), or with any of
Explanation: This message identifies the sequence the general control information within a CI.
number of the first log record that was read. v To the log record in the CI, if there is a problem with
a log record header (LRH).
seq RBA or LRSN
Severity: 0 (informational) If this is the first log record read during this execution of
DSN1LOGP, and if there is a problem with the LCID,
System Action: Processing continues.
the sequence number is all zeros.
DSN1213I csect-name LAST LOG seq Before returning any records, DSN1LOGP checks the
ENCOUNTERED nnnnnnnnnnnn control information (LCID) at the end of a CI, and
analyzes the LRH to ensure that all records are properly
Explanation: This message identifies the sequence
chained together within the CI. If an error is detected
number of the last log record that was read.
while performing this process, DSN1LOGP issues this
seq RBA or LRSN message before dumping the entire CI. It will not format
individual records within the CI, but will, if possible,
Severity: 0 (informational) continue processing by reading the next CI.
System Action: Processing continues. Severity: 0 (informational)
System Action: Processing continues.
DSN1214I NUMBER OF LOG RECORDS READ
nnnnnnnnnnnnnnnn Problem Determination: The reason code identifies
the nature of the error and is explained in “Part 4. DB2
Explanation: This identifies the number (in decimal) of Codes” on page 707. The return code is explained in
'logical' log records read during DSN1LOGP processing. Appendix C (Volume 2) of DB2 Administration Guide .
Severity: 0 (informational)
642 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN1217E • DSN1222E
Severity: 8 (error)
DSN1217E csect-name mbn DSNJSLR WARNING
RETCODE = xxxxxxxx REASON CODE = System Action: Processing terminates.
yyyyyyyy CURRENT LOG seq =
nnnnnnnnnnnn User Response: Resubmit the job with a SYSSUMRY
DD statement included in the JCL invocation.
Explanation: A gap in the log sequence range was
encountered for member mba. The CURRENT LOG
sequence number shows the log record for the member DSN1220E ARCHIVE LOG TRUNCATED AT
following the gap, and is formatted following this xxxxxxxx - INVALID LOG RECORDS
message. WERE READ
Previous log record can be found with same member Explanation: At a restart of DB2, an archive log was
ID. truncated. This archive log data set could not be
physically altered to reflect this truncation, and invalid
mbn MEMBER=membername, where membername log records therefore still exist. DSN1LOGP has already
is the member of a data sharing group. This is reported this information in the summary report, and
printed only for a data sharing record. cannot retract it. Nor can it disregard the invalid log
information already read in order adequately to
seq RBA or LRSN
summarize what has occurred. Therefore, all information
Severity: 0 (informational) up to this point in the log will be summarized, and a
new summary report initiated. Consequently, the same
System Action: Processing continues.
UR may be reported twice with different dispositions
Problem Determination: The reason code identifies and different page sets modified. To avoid this condition,
the nature of the error and is explained in “Part 4. DB2 use the BSDS DD statement instead of the ARCHIVE
Codes” on page 707. The return code is explained in DD statement.
Appendix C (Volume 2) of DB2 Administration Guide .
Severity: 0 (informational)
System Action: Processing continues.
DSN1218I NUMBER OF LOG ERROR MESSAGES
nnnnnnnnnnnnnnnn
DSN1221E DSNJSLR ERROR RETCODE=xxxxxxxx
Explanation: DSN1LOGP distinguishes three classes
REASON CODE=yyyyyyyy VSAM
of errors:
RETURN CODE=aaaa ERROR
1. Code problems existing in the DB2 or system code CODE=bbbb
used for DSN1LOGP. In the event of a SYSABEND
dump, a user abend code of U0153 will be issued, Explanation: The stand-alone log read function
and DSN1LOGP will be terminated. resulted in a VSAM error. The DSNJSLR return code
'xxxxxxxx', and reason code 'yyyyyyyy', included in the
2. Incorrect invocation of DSN1LOGP caused,
message are documented in Appendixes (Volume 2) of
perhaps, by your having used an incorrect keyword
DB2 Administration Guide.
or missed a DD statement. Under these
circumstances, DSN1LOGP will issue appropriate The VSAM return code (aaaa), and error code (bbbb),
error messages, and the program will be terminated. identify the nature of the VSAM error. Refer to the
3. Failure by a given log CI under the scrutiny of appropriate VSAM publication for an explanation of
DSN1LOGP. Such scrutiny is performed before any these codes.
of the records within the CI are processed. Failure is Severity: 0 (informational)
an indication of logical damage, and error messages
are issued by the Log Extractor. The CI or failing log System Action: Processing continues.
record is printed, and DSN1LOGP continues to the
next CI or log record. DSN1222E DSNJSLR ERROR RETCODE=xxxxxxxx
The count 'nnnnnnnnnnnnnnnn' provided REASON CODE=yyyyyyyy DYNAMIC
summarizes the number (in decimal) of errors ALLOCATION INFORMATION
DSN1LOGP detected while accessing the log. CODE=aaaa ERROR CODE=bbbb
Severity: 0 (informational) Explanation: An error occurred while dynamically
allocating a log data set. DSNJSLR return code
System Action: Processing continues.
'xxxxxxxx', and reason code 'yyyyyyyy', included in the
message, are documented in Appendixes (Volume 2) of
DSN1219E SYSSUMRY DD STATEMENT MISSING DB2 Administration Guide. Information code 'aaaa' and
error code 'bbbb' were returned by the dynamic
Explanation: You requested the SUMMARY option,
allocation SVC and identify the nature of the error. Refer
but failed to include the SYSSUMRY DD statement in
to the appropriate MVS publication for an explanation of
your JCL invocation.
these codes.
Chapter 24. DB2 Messages 643
DSN1223E • DSN1704E
Severity: 12 (severe error)
DSN1700E VALUE FOR KEYWORD xxxxxxxx IS
System Action: Processing terminates. INVALID
Explanation: The SDMPIN input contains the
DSN1223E DSNJSLR ERROR RETCODE=xxxxxxxx 'xxxxxxxx'. The value specified for that keyword is
REASON CODE=yyyyyyyy RDJFCB invalid.
RETURN CODE=aaaa
Severity: 8 (error)
Explanation: An error occurred while trying to read
System Action: Processing is terminated.
the job file control block. The DSNJSLR return code
'xxxxxxxx', and reason code 'yyyyyyyy', included in the User Response: Provide a correct keyword value and
message are documented in Appendixes (Volume 2) of resubmit the job.
DB2 Administration Guide .
The RDJFCB return code (aaaa), identifies the nature of DSN1701E START TRACE MISSING
the error. Refer to the appropriate MVS publication for
Explanation: The START TRACE command is
an explanation of these codes.
required. The first keyword record of the SDMPIN input
Severity: 0 (informational) does not contain a START TRACE command.
System Action: Processing continues. Severity: 8 (error)
System Action: Processing is terminated.
DSN1300E csect-name RBA RANGE CANNOT BE
User Response: Resubmit the job with START
USED TO PRINT LOG RECORDS FROM
TRACE as the first keyword record in the SDMPIN
MULTIPLE DB2 SYSTEMS
input.
Explanation: RBASTART and RBAEND cannot be
used to define the range when selecting log records
DSN1702E KEYWORD xxxxxxxx MULTIPLY
from multiple DB2 systems. LRSNSTART and
DEFINED
LRSNEND should be used instead.
Explanation: Keyword 'xxxxxxxx' was specified
System Action: Processing terminates.
multiple times in the SDMPIN input. All keywords are
User Response: Resubmit the job with either RBA allowed only once.
values only or LRSN values only.
Severity: 8 (error)
System Action: Processing is terminated.
DSN1303E csect-name INCOMPATIBLE DD
STATEMENTS WERE SPECIFIED FOR User Response: Specify the keyword only once.
LOG PROCESSING Resubmit the job.
Explanation: Either MxxACTn or MxxARCHV was
erroneously specified in conjunction with MxxBSDS to DSN1703E KEYWORD xxxxxxxx UNKNOWN
locate the log data sets of a member of a DB2 data
sharing group for a DSN1LOGP job. Explanation: DSN1SDMP does not recognize the
keyword 'xxxxxxxx'.
System Action: Processing terminates.
Severity: 8 (error)
User Response: Correct the DD statement and
resubmit the job. System Action: Processing is terminated.
User Response: Make sure that all keywords are valid
DSN1309E csect-name SPECIFIED END RANGE IS and then resubmit the job.
LESS THAN START RANGE
Explanation: The value specified for ENDLRSN or DSN1704E UNABLE TO OBTAIN RETURN-AREA
ENDRBA is less than the value of STARTLRSN or STORAGE
STARTRBA for a DSN1LOGP job. Explanation: An error resulted when DSN1SDMP
System Action: Processing terminates. attempted to obtain storage for an instrumentation
facility interface (IFI) return area.
User Response: Resubmit the job with correct start
and end values. Severity: 8 (error)
System Action: Processing is terminated.
User Response: When you resubmit the job either:
v Specify a larger region size in the job control
language.
644 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN1705E • DSN1713I
v Reduce the value of BUFSIZE on START TRACE. User Response: Ensure that the 'xxxxxxxx' DD
statement in the job control language is valid and
resubmit the job.
DSN1705E SYNTAX ERROR, LINE = ll, COLUMN =
cc
DSN1710E UNABLE TO OPEN SDMPTRAC
Explanation: A syntax error was encountered in the
SDMPIN input. The location of the error is given by: Explanation: An error resulted when DSN1SDMP
attempted to open the SDMPTRAC data set.
ll The line number within the input stream that is
in error. Severity: 8 (error)
cc The column number. System Action: Processing is terminated.
Severity: 8 (error) User Response: Ensure that the SDMPTRAC DD
statement in the job control language is valid and
System Action: Processing is terminated.
resubmit the job.
User Response: Correct the syntax error and then
resubmit the error.
DSN1711E START TRACE ERROR,
REASON=xxxxxxxx
DSN1706E INVALID ABEND CODE SPECIFIED
Explanation: DB2 did not process the submitted
Explanation: An invalid abend code was specified on START TRACE command. The reason code 'xxxxxxxx'
the ACTION keyword. is returned from the instrumentation facility interface
(IFI).
Severity: 8 (error)
Severity: 8 (error)
System Action: Processing is terminated.
System Action: Processing is terminated.
User Response: Allowable abend codes are
00E60100 through 00E60199. Specify an allowable User Response: Check the return area that follows
abend code and then resubmit the job. message DSN1712I. Possible problems are:
v The syntax of the START TRACE command is
DSN1707E LIMIT OF 50 STATEMENTS EXCEEDED invalid. Correct the command and resubmit the job.
Do not include the subsystem recognition character
Explanation: DSN1SDMP allows a maximum of 50 before the command text.
statements for a given job. v The user does not have authority to issue trace
Severity: 8 (error) commands. Obtain trace authority and resubmit the
job.
System Action: Processing is terminated.
User Response: Use no more than 50 statements DSN1712I START TRACE RETURN-AREA
when you resubmit the job. FOLLOWS:
Explanation: DSN1SDMP issued the START TRACE
DSN1708E TOO MANY SELECT CRITERIA command and the return area resulting from the
VALUES instrumentation facility interface (IFI) COMMAND call
Explanation: DSN1SDMP allows a maximum of eight follows this message. The return area contains DB2
SELECT criteria values. command response messages.
Severity: 8 (error) Severity: 0 (informational)
System Action: Processing is terminated. System Action: Processing continues.
User Response: Use no more than eight SELECT
criteria values and then resubmit the job. DSN1713I READA ERROR, REASON=xxxxxxxx
Explanation: An error resulted when DSN1SDMP
DSN1709E INPUT/OUTPUT ERROR, issued a instrumentation facility interface (IFI) READA
DDNAME=xxxxxxxx call in an attempt to obtain DB2 trace records. Reason
code 'xxxxxxxx' is the IFI reason code returned in
Explanation: An error resulted when DSN1SDMP IFCARC2.
attempted to do I/O. The ddname of the data set to
which I/O failed is 'xxxxxxxx' Severity: 0 (informational)
Severity: 8 (error) System Action: DSN1SDMP writes any records that
were returned and processing continues.
System Action: Processing is terminated.
Chapter 24. DB2 Messages 645
DSN1714I • DSN1720I
User Response: Possible reason codes are:
DSN1717I STOP TRACE RETURN-AREA
00E60802 FOLLOWS:
The DSN1SDMP return area was not large
Explanation: DSN1SDMP issued the STOP TRACE
enough to hold the returned trace records. This
command and the return area resulting from the
condition should not occur because the
instrumentation facility interface (IFI) COMMAND call
DSN1SDMP return area is the same size as
follows this message. The return area contains DB2
the requested OPn monitor buffer.
command response messages.
00E60803
Severity: 0 (informational)
No trace data was available when the READA
request was made. This condition occurs when System Action: Processing continues.
the trace started by DSN1SDMP is stopped
from the operator console or by another
DSN1718E STOP TRACE ERROR,
application program.
REASON=xxxxxxxx
Explanation: DSN1SDMP attempted to submit a DB2
DSN1714I TRACE RECORDS WERE LOST
STOP TRACE command at the end of its processing;
Explanation: DB2 trace records were lost and are not however, the command failed. The reason code
contained in the SDMPTRAC data set. returned from the instrumentation facility interface (IFI)
is 'xxxxxxxx'.
Severity: 0 (informational)
Severity: 8 (error)
System Action: Processing continues.
System Action: Processing is terminated.
User Response: Possible reasons for lost trace
records are: User Response: Check the return area that follows
v The OP buffer is not large enough. Specify a larger message DSN1717I. One possible problem is:
BUFSIZE on the START TRACE command and then v The trace has already been stopped from the
resubmit the job. operator’s console or by another application program.
v The trace data is too voluminous and buffer is
overflowing before the data can be read. Specify a DSN1719I ACTIONS ARE COMPLETE
more granular selectivity on the START TRACE
command and then resubmit the job. Explanation: All requested IFC selective dump actions
finished. All trace records have been written to the
specified destination(s). If an abend action was
DSN1715E UNABLE TO OBTAIN WORK SPACE requested, all abends have taken place.
Explanation: An error resulted when DSN1SDMP Severity: 0 (informational)
attempted to obtain work area storage.
System Action: DSN1SDMP stops the trace that it
Severity: 8 (error) started and completes processing.
System Action: Processing is terminated.
User Response: Specify a larger region size in the job DSN1720I READA ERROR, REASON=xxxxxxxx
control language and then resubmit the job. Explanation: An error resulted when DSN1SDMP
issued a instrumentation facility interface (IFI) READA
DSN1716E UNABLE TO OPEN SDMPIN call in an attempt to obtain DB2 trace records. Reason
code 'xxxxxxxx' is the IFI reason code returned in
Explanation: An error resulted when DSN1SDMP IFCARC2.
attempted to open the SDMPIN data set.
Severity: 8 (error)
Severity: 8 (error)
System Action: Processing is terminated.
System Action: Processing is terminated.
User Response: One possible reason code is:
User Response: Ensure that the SDMPIN DD
statement in the job control language is valid and 00E60824
resubmit the job. The user does not have correct monitor
authority. Obtain the correct monitor authority
(MONITOR1 or MONITOR2) and resubmit the
job.
646 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN1800I • DSN1807I
DSN1800I START OF DSN1CHKR FOR JOB DSN1804I CURRENT RID = nnnnnnnn
job-name step-name
Explanation: This message supplies the record id
Explanation: This message indicates that DSN1CHKR 'nnnnnnnn' for the current record at the time the broken
started processing. ring or link was detected. This is one of a series of
messages associated with a broken ring or link. It will
Severity: 0 (informational)
appear in combination with DSN1802I, DSN1803I, and
System Action: DSN1CHKR starts processing. DSN1805I.
Severity: 4 (warning)
DSN1801I ANCHOR POINT mm IN ERROR IN
System Action: Processing continues.
PAGE nnnnnn
Problem Determination: Contact your IBM Support
Explanation: This message indicates that anchor point
Center for assistance.
'mm' is in error in page 'nnnnnn'. Either the backward
pointer is not zero when the forward pointer is zero, or
the backward pointer does not point to the last record DSN1805I PREVIOUS IN CHAIN = nnnnnnnn
ID in the parent chain. If this message is preceded by
Explanation: This message supplies the record id
DSN1835I then the child pointer is pointing to a page
'nnnnnnnn' of the record prior to when the broken ring
beyond the high used RBA of the data set. Either the
or link was detected. This is one of a series of
child pointer is invalid or the data set has been
messages associated with a broken ring or link. It will
truncated.
appear in combination with DSN1802I, DSN1803I, and
Severity: 4 (warning) DSN1804I.
System Action: The page is marked for output if the Severity: 4 (warning)
FORMAT/DUMP option is in effect. Processing
System Action: Processing continues.
continues.
Problem Determination: Contact Your IBM Support
Problem Determination: Contact your IBM Support
Center for assistance.
Center for assistance.
DSN1806I IDMAP ENTRY entry-number IN PAGE
DSN1802I RING/LINK CHAIN BROKEN - type RID
page-number IS IN ERROR
= nnnnnnnn
Explanation: This message indicates that the IDMAP
Explanation: This message indicates that there is a
entry 'entry-number' in page 'page-number' is not valid.
broken ring or link chain beginning at 'type' (anchor or
Valid entries are from X'0014' to X'0Fhh' (depending on
parent) with record id equal to 'nnnnnnnn'. This is one
the number of IDMAP entries in the page).
of a series of messages associated with a broken ring
or link. It will appear in combination with DSN1803I, Severity: 4 (warning)
DSN1804I, and DSN1805I.
System Action: The page is marked for output if the
Severity: 4 (warning) FORMAT/DUMP option is in effect. Processing
continues.
System Action: The page is marked for output if the
FORMAT/DUMP option is in effect. Processing Problem Determination: Contact your IBM Support
continues. Center for assistance.
Problem Determination: Contact your IBM Support
Center for assistance. DSN1807I CHILD POINTER chd-rid IN ERROR IN
PARENT RECORD par-rid IN PAGE
pppppp
DSN1803I PARENT RID = nnnnnnnn
Explanation: This message indicates that the parent
Explanation: This message supplies the record id
record with record ID 'par-rid' in page 'pppppp' has a
'nnnnnnnn' for the parent record of a detected broken
child pointer with an invalid record ID of 'chd-rid'. If this
ring or link. This is one of a series of messages
message is preceded by DSN1835I, then the child
associated with a broken ring or link. It will appear in
pointer is pointing to a page beyond the high used RBA
combination with DSN1802I, DSN1804I, and DSN1805I.
of the data set. Either the child pointer is invalid or the
Severity: 4 (warning) data set has been truncated.
System Action: Processing continues. Severity: 4 (warning)
Problem Determination: Contact your IBM Support System Action: The page is marked for output if the
Center for assistance. FORMAT/DUMP option is in effect. Processing
continues.
Chapter 24. DB2 Messages 647
DSN1808I • DSN1815I
Problem Determination: Contact your IBM Support can be found only on pages 2 through 14 (E in
Center for assistance. hexadecimal). Any anchor point page specified beyond
that range is invalid.
DSN1808I OVERFLOW RECORD IN ERROR - Severity: 4 (warning)
OVERFLOW RID = ovf-rid, POINTER
System Action: Processing continues with the next
RID = ptr-rid
set of parameters.
Explanation: This message indicates that the record
at record id 'ovf-rid', pointed to by the pointer record at
DSN1812I ORPHAN ID = orph-id ID ENTRY =
record id 'ptr-rid', is not an overflow record.
entry-val FOUND IN PAGE
Severity: 4 (warning) page-number
System Action: The page is marked for output if the Explanation: This message indicates that the record
FORMAT/DUMP option is in effect. Processing with id = 'orph-id' and id entry = 'entry-val' in page
continues. 'page-number' is an orphan.
Problem Determination: Contact your IBM Support Severity: 4 (warning)
Center for assistance.
System Action: Processing continues.
Problem Determination: Contact your IBM Support
DSN1809I OVERFLOW RECORD IN ERROR -
Center for assistance.
OVERFLOW RID = ovf-rid, HAS NO
POINTER RECORD
DSN1813I UNABLE TO DUMP PAGE page-number
Explanation: This message indicates no pointer
record points to the overflow record with record id Explanation: An error was encountered while
'ovf-rid'. retrieving the page and therefore page 'page-number'
could not be dumped.
Severity: 4 (warning)
Severity: 4 (warning)
System Action: The page is marked for output if the
FORMAT/DUMP option is in effect. Processing System Action: Processing continues.
continues.
Problem Determination: Examine previous diagnostic
Problem Determination: Contact your IBM Support and system messages, correct problem, and rerun job.
Center for assistance.
DSN1814I UNEXPECTED END OF DATA AT PAGE
DSN1810I INPUT DATA SET INVALID, NOT A page-number
CHECKABLE SYSTEM TABLESPACE
Explanation: The END-OF-DATA condition was
Explanation: This message indicates that the data set reached before expected at page 'page-number'.
defined by SYSUT1 is not a checkable table space and
therefore cannot be analyzed. Severity: 8 (error)
Severity: 8 (error) System Action: Processing terminates.
System Action: Processing terminates. Problem Determination: Examine previous diagnostic
and system messages, correct problem and rerun job.
System Programmer Response: Correct the
SYSUT1 DD statement and rerun the job.
DSN1815I DSN1CHKR COMPLETED
Problem Determination: Checkable system table SUCCESSFULLY, pg-cnt PAGES
spaces must be referenced by a hashed entry or PROCESSED
contain links. Single-record table spaces referenced by
an index are not checkable. If you suspect an error in Explanation: This message indicates the DSN1CHKR
DB2, refer to Part 2 of DB2 Diagnosis Guide and successfully completed processing; all checks
Reference for information on identifying and reporting completed. The 'pg-cnt' represents the number of pages
the problem. read during check processing, not the number of pages
in the table space.
DSN1811I ANCHOR POINT PAGE page IS OUT OF Severity: 0 (informational)
RANGE — VALUE IS LESS THAN 2 OR System Action: Processing terminates.
GREATER THAN 'E'X
Explanation: The ANCHOR function has an incorrect
page value for the page-slot argument. Anchor points
648 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN1816I • DSN1824I
Severity: 0 (informational)
DSN1816I DSN1CHKR TERMINATED WITH
ERRORS, pg-cnt PAGES PROCESSED System Action: Processing continues.
Explanation: This message indicates the DSN1CHKR
did not successfully complete processing. The 'pg-cnt' DSN1820I MAPPING OF map-opt (val1,val2) HAS
represents the number of pages read during check STARTED
processing, not the number of pages in the table space.
Explanation: This message indicates that mapping of
Severity: 4 (warning) or 8 (error) the indicated option 'map-opt', which is either ANCHOR,
HASH, PAGE or RID, has started. The option’s
System Action: Processing terminates.
arguments, 'val1' and 'val2' will also be mapped.
Problem Determination: Examine previous diagnostic Following this message will be the records of the chain.
messages, correct problems if possible and rerun job.
Severity: 0 (informational)
Otherwise contact your IBM Support Center for
assistance. System Action: Processing continues.
DSN1817I ARGUMENT arg-val OF THE MAP DSN1821I MAPPING OF 'map-opt' (val1,val2) HAS
COMMAND IS INVALID COMPLETED
Explanation: This message indicates that the Explanation: This message indicates that mapping of
argument 'arg-val' of the MAP command is invalid. the indicated option 'map-opt', which is either ANCHOR,
HASH, PAGE, or RID, started. The option’s arguments,
Severity: 8 (error)
'val1' and 'val2', will also be mapped. Preceding this
System Action: Processing terminates. message will be the records of the chain.
Problem Determination: Refer to DB2 Utility Guide Severity: 0 (informational)
and Reference for the correct syntax.
System Action: Processing continues.
Examples of invalid arguments are:
v The offset value of the ANCHOR or HASH option is DSN1822I DBID dbid HASHED TO AN EMPTY
neither zero (0) nor four (4). ANCHOR POINT - NO ENTRIES FOR
v When the ANCHOR and RID option has been THE GIVEN DBID ARE AVAILABLE IN
specified, the page number specified is less than two, THE TABLESPACE
which would be a nondata page.
Explanation: DBID 'dbid' hashed to an empty anchor
point. An anchor point with a value of 0 (empty) means
DSN1818I IDMAP ENTRY entry-number IN PAGE that no entries are available in the table space.
page-number IS BEING USED BY Therefore, no links are checked.
MULTIPLE CHAINS - ONE OF WHICH IS
Severity: 4 (warning)
IN ERROR
System Action: Processing continues with the next
Explanation: This message indicates that a record is
set of parameters.
part of two different chains and therefore creates an
invalid structure within the table space. If using the MAP
option, the mapping of the chain stops since the path DSN1823I INVALID SYNTAX, c EXPECTED
back to the starting record is lost.
Explanation: This message indicates that an
Severity: 4 (warning) unexpected character was found while parsing the
parmlist and that 'c' was the expected character.
System Action: Processing continues.
Severity: 8 (error)
Problem Determination: Contact your IBM Support
Center for assistance. System Action: Processing terminates.
Problem Determination: Refer to DB2 Command
DSN1819I HASH VALUE FOR dbid Reference for the correct syntax.
CORRESPONDS TO: PAGE =
page-number AND ANCHOR POINT
OFFSET = offset DSN1824I INVALID HEX DATA: hex-data
Explanation: This message indicates the hash values Explanation: This message indicates that the input
for the given 'dbid', after applying the hash function, value 'hex-data' is not a valid hexadecimal number.
where 'page-number' is the page and 'offset' is the Severity: 8 (error)
anchor point.
System Action: Processing terminates.
Chapter 24. DB2 Messages 649
DSN1825I • DSN1831I
Problem Determination: Correct input value and This message is issued by the following CSECTs:
rerun job. DSN1MAP, DSN1LNKF
Severity: 4 (warning)
DSN1825I INPUT VALUE EITHER TOO LONG OR
System Action: Processing continues with the next
OMITTED: in-val
set of parameters.
Explanation: This message indicates that the input
Problem Determination: If using the MAP command,
value 'in-val' is either greater than 8 hexadecimal digits
insure that all user supplied offsets actually point to
or was totally omitted.
valid data. If you suspect an error in DB2, refer to Part
Severity: 8 (error) 2 of DB2 Diagnosis Guide and Reference for
information on identifying and reporting the problem.
System Action: Processing terminates.
Problem Determination: Correct input value and
DSN1829I MAPPING MUST STOP AT PARENT
rerun job.
RECORD WHEN USING THE
BACKWARD POINTER
DSN1826I RECORD WITH OBID = rec-obid IS
Explanation: This message indicates that the
INVALID FOR THIS CHAIN
requested mapping stopped at the parent record rather
Explanation: This message indicates that the record than the starting record because of the use of backward
with OBID 'rec-obid' is invalid for the chain currently pointers.
being processed, assuming the OBID of the parent or
Severity: 4 (warning)
first record processed was not in error.
System Action: Processing continues.
Severity: 4 (warning)
System Action: Processing terminates.
DSN1830I INVALID NUMBERS OF VALUES
Problem Determination: If using the MAP function, SPECIFIED FOR func-name
make sure the given values point to a valid record.
Explanation: This message indicates that either:
Otherwise, contact your IBM Support Center for
assistance. v No value was specified.
v An odd number of values was specified for a function
that requires an even number of values.
DSN1827I THE SPECIFIED PAGE IS NOT A
HASHED DATA PAGE - THE Severity: 8 (error)
REQUESTED FUNCTION REQUIRES A
System Action: Processing terminates.
HASHED DATA PAGE.
Problem Determination: Refer to DB2 Utility Guide
Explanation: This message indicates that the HASH
and Reference for the parameter specifications. Correct
or ANCHOR option of the MAP command was issued
the parmlist and rerun the job.
against a nonhashed data page (that is, a page with no
anchor points).
DSN1831I END OF DATE REACHED, PAGE =
Severity: 4 (warning)
page-number IS OUT OF RANGE
System Action: Processing continues with the next
Explanation: This message indicates that page
set of parameters.
'page-no', specified as a parameter of the MAP option,
Problem Determination: If using the ANCHOR caused the END-OF-DATA condition to be reached. The
function, examine the page-slot argument to ensure that page number is invalid for the table space being
the page value is correct. If using the HASH function, mapped.
ensure that the 'dbid' value is correct. Otherwise,
Severity: 4 (warning)
examine the SYSUT1 DD statement to ensure that the
table space is correct. If so, use the RID or PAGE System Action: Processing continues with the next
function to achieve the desired mapping. set of parameters.
Problem Determination: Correct the page parameter
DSN1828I OBID = rec-obid IS INVALID FOR THIS of the MAP option and rerun the job.
DATABASE
Explanation: This message indicates that the record
with OBID 'rec-obid' is invalid for the database currently
being processed.
650 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN1833I • DSN1940I
numscanrows
DSN1833I ANCHOR POINT IS NOT IN USE
ROWS SCANNED TO PROVIDE
Explanation: The anchor point to be mapped has a COMPRESSION ESTIMATE
value of 0, which means that it is not in use. Therefore, numdictents
no links are checked. DICTIONARY ENTRIES
auncmprowlen
Severity: 4 (warning)
BYTES FOR AVERAGE UNCOMPRESSED
System Action: Processing continues with the next ROW LENGTH
set of parameters. avgcmprowlen
BYTES FOR AVERAGE COMPRESSED ROW
LENGTH
DSN1834I GETMAIN FOR BUFFERS FAILED. NO dictpages
MORE AVAILABLE STORAGE IN DICTIONARY PAGES REQUIRED
ADDRESS SPACE. noncmppages
Explanation: The GETMAIN for page buffers failed. PAGES REQUIRED WITHOUT
There is no more virtual storage available in the COMPRESSION
address space. The table space being checked is too cmppages
large to be processed with the current system PAGES REQUIRED WITH COMPRESSION
configuration. pctpgsave
PERCENT OF THE DB2 DATA PAGES
Severity: 8 (error) WOULD BE SAVED
System Action: Processing terminates. Explanation: DSN1COMP completed successfully.
Problem Determination: Make changes to the system This report contains the compression savings estimate
configuration, if possible, to allow more virtual storage to based on the input data set. For a sample of the report,
be available in the address space. see the DSN1COMP utility in DB2 Utility Guide and
Reference.
DSN1835I THE REQUESTED PAGE page-no IS The compression statistics follow:
BEYOND THE END OF THE noncmpbytes
TABLESPACE. The total number of uncompressed KB (where
Explanation: A request for a page number from an KB = 1024 bytes) for the data rows (including
anchor point or a child pointer in a parent record is the row prefix). This number was rounded to
pointing beyond the high used RBA of the data set. the nearest KB.
Either the rid is in error or the data set has been cmpbytes
truncated. The total number of compressed KB for the
Severity: 4 (warning) data rows (including the row prefix). This
number was rounded to the nearest KB.
System Action: The page is marked for output if the
FORMAT/DUMP option is in effect. Processing percsave
continues. The percentage of bytes that would be saved if
the rows were compressed.
Problem Determination: Examine previous diagnostic
and system messages, correct problem if possible and The values above reflect only the number of bytes for
rerun the job. Otherwise, contact your IBM Support the data row and the associated row prefix (6 bytes).
Center for assistance. DB2 page and dictionary page overhead is not included.
numdictrows
DSN1940I csect-name COMPRESSION REPORT The number of data rows that were used to
: build the dictionary.
noncmpbytes numscanrows
KB WITHOUT COMPRESSION The number of data rows that were processed
cmpbytes using the dictionary to produce the
KB WITH COMPRESSION compression savings estimate.
percsave
PERCENT OF THE BYTES WOULD BE numdictents
SAVED The number of entries contained in the
numdictrows compression dictionary.
ROWS SCANNED TO BUILD DICTIONARY auncmprowlen
Average uncompressed row length.
Chapter 24. DB2 Messages 651
DSN1941I • DSN1950I
avgcmprowlen Severity: 8 (error)
Average compressed row length.
System Action: Processing terminated.
dictpages
User Response: Run DSN1COMP on a data set
The number of DB2 pages required for the
containing data that is not in a compressed format.
compression dictionary.
noncmppages
DSN1944I csect-name INPUT PARAMETERS
The estimated number of DB2 pages required
by the uncompressed data rows. Space Explanation: The input parameters used by
required for PCTFREE and FREEPAGE is DSN1COMP are either user-supplied or default values.
included. This number was rounded up to the
next integer. Severity: 0 (informational)
cmppages System Action: Processing continues.
The estimated number of DB2 pages required
by the compressed data rows. Space required DSN1945I csect-name DICTIONARY TREE
for PCTFREE and FREEPAGE is included.
Dictionary pages are also included. This Explanation: The compression dictionary tree follows.
number was rounded up to the next integer. Each node is formatted in the SYSPRINT data set.
pctpgsave Severity: 0 (informational)
An estimate of the percentage of DB2 pages System Action: Processing continues.
that would be saved by compressing the data
rows.
DSN1946I csect-name IMAGE COPY CONTAINING
Severity: 0 (informational) MULTIPLE PARTITIONS
System Action: The utility completed successfully. Explanation: An image copy containing multiple
partitions is not acceptable input to the DSN1COMP
DSN1941I csect-name COMPRESSION ESTIMATE utility.
WAS NOT CALCULATED Severity: 8 (error)
Explanation: There is insufficient data to build a System Action: Processing terminated.
compression dictionary. Either the input data set is
empty, or the number of rows in the input data set was User Response: Run DSN1COMP on an image copy
insufficient to build the dictionary. containing a single partition.
Severity: 8 (error)
DSN1947I DSN1947I csect-name COMPRESSION
System Action: Processing terminated. UNAVAILABLE FOR INDEX SPACES
User Response: Increase the number of rows in the Explanation: Index data was provided as input to
input data set. DSN1COMP. Compression is supported only for table
space data.
DSN1942I csect-name ERROR WHEN BUILDING Severity: 8 (error)
THE COMPRESSION DICTIONARY
System Action: Processing terminated.
Explanation: An internal error was encountered while
building the dictionary. User Response: Provide DSN1COMP with data
containing table space data.
Severity: 8 (error)
System Action: Processing terminated. DSN1950I DSN1COPY HAS SUPPRESSED VSAM
System Programmer Response: Determine the OPEN VERIFY, ACBERRFLG=acb-error-
failing environment. Refer to Part 2 of DB2 Diagnosis code.open-option
Guide and Reference for information on identifying and Explanation: DSN1COPY suppresses the VSAM
reporting the problem. VERIFY done by the VSAM OPEN for the SYSUT1 data
set. The VSAM VERIFY is not needed for the VSAM
DSN1943I csect-name DICTIONARY PAGE data sets used by DB2. For DB2 VSAM data sets, the
ENCOUNTERED data set hi-used RBA in the ICF catalog is always
current.
Explanation: A dictionary page was encountered while
processing the input data set. This indicates that the This message is issued by the following CSECT:
data is in compressed format. DSN1COPY
652 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN1951I • DSN1957I
Severity: 0 (informational) number are correct. If it is correct, change the input
data set name as indicated by the message.
System Action: Processing continues.
Problem Determination: Refer to DSN1COPY or
DSN1PRNT documentation for parameter requirements.
DSN1951I ODD NUMBER OF HEX CHARACTERS
SPECIFIED IN VALUE PARM.
DSN1954I csect-name PARAMETER PAGESIZE
Explanation: The VALUE parameter contained an odd
OR LOB IS MISSING OR
number of hexadecimal characters. Only even numbers
INCORRECTLY SPECIFIED.
of hexadecimal characters are allowed.
Explanation: This message is issued in the following
This message is issued by the following CSECT:
situations:
DSN1VAL
v The program tried to determine the page size from
Severity: 8 (error) the first page of the data set, but the first page is not
System Action: Processing terminates. a header page, or
v The first page is a LOB header page and the LOB
User Response: Correct the number of hexadecimal parameter is missing.
digits specified for the VALUE parameter and resubmit
the job.
This message is issued by the following CSECTs:
Problem Determination: Refer to DSN1COPY DSN1COPY, DSN1PRNT.
documentation for parameter requirements in DB2 Utility
Severity: 8 (error)
Guide and Reference .
System Action: Processing terminates.
DSN1952I UNEXPECTED END OF INPUT DATA - User Response: If the input data set is not a LOB
CHECK FOR INVALID SPECIFICATION table space, specify the PAGESIZE parameter. If the
OF THE 32K PARAMETER. input data set is a LOB table space, specify the LOB or
PAGESIZE parameter or both, as appropriate.
Explanation: End of data occurred for the image copy
data set specified in SYSUT1 before the first page could
be read. Either the wrong input data set was specified DSN1955I SYSUT1 DD CARD IS MISSING
or 32KB was specified even though the input data set
Explanation: No SYSUT1 DD statement was
contains 4KB pages.
provided.
This message is issued by the following CSECT:
This message is issued by the following CSECTs:
DSN1COPY
DSN1COPY, DSN1PRNT, DSN1COMP
Severity: 8 (error)
Severity: 8 (error)
System Action: Processing terminates.
System Action: Processing terminates.
User Response: Remove the 32KB parameter if the
User Response: Rerun the job with a SYSUT1 DD
input data set contains 4KB pages, change the name of
statement.
the input data set to specify a valid image copy, or
remove the FULLCOPY or INCRCOPY parameter.
DSN1956I csect-name SYNTAX ERROR: parm2 IS
Problem Determination: Refer to DSN1COPY
SPECIFIED WITHOUT parm1
documentation for parameter requirements.
Explanation: The keyword parm1 must be specified
with parm2.
DSN1953I STARTING PAGE NUMBER REQUIRES
AN INPUT DATA SET NAME OF Severity: 8 (error)
data-set-name
System Action: Processing terminates.
Explanation: The starting page number of the page
range to be printed is inconsistent with the input data User Response: Resubmit the job specifying the
set specified. correct keyword.
This message is issued by the following CSECTs:
DSN1COPY, DSN1PRNT DSN1957I csect-name COMPRESSED RECORDS
CANNOT BE EXPANDED DUE TO
Severity: 8 (error) INCORRECT INPUT DATA SET
SPECIFICATION.
System Action: Processing terminates.
Explanation: DSN1PRNT issues this message when
User Response: Ensure that NUMPARTS, the 32KB
the EXPAND option is specified. The input data set
parameter (or its default of 4KB), and the starting page
Chapter 24. DB2 Messages 653
DSN1958I • DSN1964I
might be an incremental image copy data set.
DSN1961I PIECE NUMBER value IS INVALID.
Severity: 8 (error)
Explanation: A page was retrieved that has a piece
System Action: Processing terminates. number greater than NUMPARTS for partitioned table
spaces or greater than the default of 32 for linear table
User Response: Resubmit the job specifying the spaces. 'DPIECNUM value' is the piece number for the
correct input data set. retrieved page. For page range printing, this message is
issued if the starting page number has an invalid piece
DSN1958I INVALID DATA SET NAME. number as determined from calculations involving
NUMPARTS and the page size.
Explanation: A DB2 table space was given an
incorrect name. Severity: 8 (error)
This message is issued by the following CSECT: System Action: Processing will terminate.
DSN1CHDS User Response: Look in SYSIBM.SYSTABLESPACE
Severity: 8 (error) for the correct number of partitions for this page.
Correct NUMPARTS or 32KB if they were specified
System Action: Processing terminates. incorrectly, resubmit the job with a valid image copy, or
User Response: Correct the output data set name if correct the starting page number for page range
FULLCOPY or INCRCOPY were specified. If a page printing.
range is being printed, correct the input data set name.
Refer to Part 2 (Volume 1) of DB2 Administration Guide DSN1962I OUTPUT DATA SETS MUST BE VSAM
for a discussion of DB2 data set naming conventions. WHEN IMAGE COPY DATA SETS ARE
USED AS INPUT TO DSN1COPY.
DSN1959I BOTH FULLCOPY AND INCRCOPY Explanation: If image copy data sets are used as
PARAMETERS CANNOT BE input to DSN1COPY, the output data sets must be
SPECIFIED. VSAM. QSAM data sets cannot be used for output.
Explanation: DSN1COPY cannot apply to both full Severity: 8 (error)
images copies and incremental image copies in the
same execution. The full image copies are applied first. System Action: Processing will terminate.
Each incremental image copy must then be applied in User Response: Change the output data set to
separate steps, starting with the oldest incremental VSAM, or remove the FULLCOPY and NUMPARTS
copy. parameters.
This message is issued by the following CSECT:
DSN1SDEF DSN1963I ZERO PAGES ARE INVALID WHEN
Severity: 8 (error) IMAGE COPY DATA SETS ARE USED
AS INPUT TO STAND ALONE
System Action: Processing will terminate. UTILITIES.
User Response: Omit either FULLCOPY or Explanation: A page in an IMAGE COPY data set has
INCRCOPY. a zero header. Pages with zero headers are illegal if
image copy data sets are used as input to stand-alone
DSN1960I csect-name input/output DATA SET utilities.
ALLOCATION ERROR. ERROR FIELD Severity: 4 (warning)
IS ERRFIELD value1. INFORMATION
FIELD IS INFFIELD value2. System Action: Processing continues.
Explanation: The allocation of an input or output data User Response: If the image copy data set name was
set failed. The ERRFIELD value1 contains the error invalid, look in SYSIBM.SYSCOPY for valid names.
number; the INFFIELD value2 contains the information Resubmit the valid IMAGE COPY data set to the
| number. See SVC99 error codes in OS/390 MVS stand-alone utility. If the IMAGE COPY data set had a
| Diagnosis: Reference or OS/390 MVS Programming: valid name, use the REPAIR utility to replace the zero
| Authorized Assembler Services Guide for help in pages with valid data pages.
determining the cause of the error.
Severity: 8 (error) DSN1964I NO VALUE HAS BEEN SPECIFIED FOR
THE NUMBER OF PARTITIONS.
System Action: Processing terminates.
Explanation: No value was given for the number of
User Response: Correct the cause of the allocation partitions. This value should follow the 'NUMPARTS'
error and resubmit the job. parameter.
654 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN1965I • DSN1972I
Severity: 8 (error) System Action: Processing is terminated.
System Action: Processing will terminate. User Response: Notify system programmer.
User Response: Look in SYSIBM.SYSTABLESPACE System Programmer Response: Provide a SYSXLAT
for the correct number of partitions for this page. DD statement if OBID translate is to be done.
Specify the correct number of partitions and resubmit Otherwise, remove the SYSXLAT parameter and rerun.
the job. If the page is not partitioned, then either omit
Problem Determination: Follow standard QSAM
the NUMPARTS parameter or specify NUMPARTS as
diagnostic procedures.
zero.
DSN1970I DATA PAGE CONTAINING OBID xxxx,
DSN1965I THE PARTITION NUMBER VALUE IS
HAS NO MATCHING VALUE IN THE
INVALID.
SYSXLAT FILE
Explanation: The partition number value following the
Explanation: One of the OBID records of the
'NUMPARTS' parameter is not between 1 and 64.
SYSXLAT file contains a source OBID value that does
Severity: 8 (error) not match the OBID value of the source system.
System Action: Processing will terminate. Severity: 8 (error)
User Response: Look in SYSIBM.SYSTABLESPACE System Action: Processing is terminated.
for the correct number of partitions for this page.
User Response: Provide that record of the SYSXLAT
file which contains an unmatched OBID value with an
DSN1966I OUTPUT DATA SET odsname NOT OBID that matches the OBID value of the source
FOUND system.
Explanation: DB2 cannot find 'odsname' because it This error can also be caused when an OBIDXLAT is
has not yet been defined. attempted on an incremental image copy of a
compressed segmented table space. For more
Severity: 8 (error)
information on how to proceed, see the OBIDXLAT
System Action: Processing is terminated. option description under DSN1COPY in DB2 Utility
Guide and Reference.
User Response: Use access method services to
define 'odsname' and any other VSAM data sets that
have not yet been defined. DSN1971I DBID xxxx NOT FOUND IN THE
SYSXLAT FILE. REPLACE SOURCE
DBID xxxx OF THE SYSXLAT FILE
DSN1967I THE OBID ARRAYS ARE FULL WITH IT.
Explanation: More than 500 records of OBIDs were Explanation: The first record of the SYSXLAT file has
specified in the SYSXLAT file. the incorrect source DBID value.
Severity: 8 (error) Severity: 8 (error)
System Action: Processing stops. System Action: Processing is terminated.
Problem Determination: DSN1COPY cannot be used User Response: Provide the first record of the
for table spaces containing more than 500 tables. SYSXLAT file with a source DBID value which matches
the DBID value of the source system.
DSN1968I OBIDS SHOULD NOT BE DUPLICATED
Explanation: There should not be any repeated DSN1972I PSID xxxx NOT FOUND IN THE
source OBIDs or target OBIDs within the SYSXLAT file. SYSXLAT FILE REPLACE SOURCE
DBID xxxx OF THE SYSXLAT FILE
Severity: 8 (error) WITH IT
System Action: Processing is terminated. Explanation: The second record of the SYSXLAT file
User Response: Change the SYSXLAT file. has the incorrect source PSID value.
Severity: 8 (error)
DSN1969I SYSXLAT FILE CAN NOT BE OPENED System Action: Processing is terminated.
Explanation: The QSAM OPEN for the SYSXLAT file User Response: Provide the second record of the
failed because no DD statement was provided. SYSXLAT file with the correct PSID value.
Severity: 8 (error)
Chapter 24. DB2 Messages 655
DSN1973I • DSN1981I
DSN1973I SOURCE DBID IS MISSING DSN1979I csect-name SOURCE & TARGET
VALUES MUST BE WITHIN THE
Explanation: The first record of the SYSXLAT file
RANGE OF 1 TO 65535.
contains no DBID value.
Explanation: The SOURCE and TARGET values of
Severity: 8 (error)
the SYSXLAT file must be between 1 and 65535.
System Action: Processing is terminated.
Severity: 8 (error)
User Response: Provide the first record of the
System Action: Processing is terminated.
SYSXLAT file with a pair of source and target DBID
values which match the DBID values of the source and User Response: Provide the SYSXLAT file with
target systems. values that are between 1 and 65535.
DSN1975I SOURCE PSID IS MISSING DSN1980I BROKEN PAGE BIT SET, WILL RESET
AND RETRY BROKEN PAGE TEST
Explanation: The second record of the SYSXLAT file
contains no PSID value. Explanation: This message indicates that a broken
page was detected. If message DSN1990I is issued
Severity: 8 (error)
following this message, determine the cause of the
System Action: Processing is terminated. broken page. If message DSN1990I is not issued, reset
the broken page bit with the REPAIR utility to correct
User Response: Provide the second record of the the problem. If you suspect an error in DB2, refer to
SYSXLAT file with a pair of source and target PSID Part 2 of DB2 Diagnosis Guide and Reference for
values which match the PSID values of the source and information on identifying and reporting the problem.
target systems.
Severity: 4 (warning)
DSN1976I TARGET PSID IS MISSING System Action: Processing continues.
Explanation: The target PSID is missing from the Operator Response: Notify the system programmer.
second record of the SYSXLAT file.
System Programmer Response: Use either the
Severity: 8 (error) RECOVER or REPAIR utility to correct the broken page.
If you suspect an error in DB2, refer to Part 2 of DB2
System Action: Processing is terminated. Diagnosis Guide and Reference for information on
User Response: Provide the second record of the identifying and reporting the problem.
SYSXLAT file with a target PSID value which matches Problem determination should have been done when
the PSID values of the target system. the dump associated with the setting of the broken page
bit was requested.
DSN1977I SOURCE OBID IS MISSING
Explanation: There is a record in the SYSXLAT file DSN1981I INVALID PARAMETER FIELD:
with no OBID value. bad-parameter
Severity: 8 (error) Explanation: An invalid input parameter was detected
on the EXEC statement. The parameter is either not a
System Action: Processing is terminated. valid keyword or it has invalid subparameters
User Response: Correct the SYSXLAT file so that all associated with it.
the records following the first and second records will Examples of invalid subparameters are:
contain a pair of source and target OBID values.
v The NUMPARTS subparameter was other than '(nn)'.
'nn' is a decimal number.
DSN1978I TARGET OBID IS MISSING v The NUMPARTS subparameter was missing either a
Explanation: There is a record in the SYSXLAT file left or right parenthesis.
with no target OBID value specified. v The PRINT subparameter was missing either a left or
right parenthesis.
Severity: 8 (error)
v The PRINT subparameter specified a digit in a page
System Action: Processing is terminated. number which was not hexadecimal.
User Response: Provide the SYSXLAT file with an v The PRINT subparameter contained a starting page
OBID value that matches the OBID value of the target number that is larger than the ending page number.
system. v The PRINT subparameter contains a page number
larger than six hexadecimal digits.
656 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN1982I • DSN1986I
Severity: 8 (error) dump the table space or index space. If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
System Action: Processing terminates.
and Reference for information on identifying and
User Response: Correct the indicated parameter on reporting the problem.
the EXEC DD statement, and resubmit the job.
Problem Determination: Refer to DSN1COPY, DSN1985I ZERO PAGES ENCOUNTERED. FIRST
DSN1PRNT, or DSN1COMP documentation for PAGE = first-zero-page-number, LAST
parameter requirements. PAGE = last-zero-page-number
Explanation: One or more pages zero pages were
DSN1982I NO BLANKS ARE ALLOWED WITHIN encountered with valid data pages after them. A zero
THE PARAMETER LIST page is a page of all zeros or a page with only the
page-synchronization bit on in the first and last byte of
Explanation: There is a space or spaces between one the page. The ’first zero page number’ and the ’last zero
or more parameters in the utility list. page number’ displayed in hexadecimal are the pages
Severity: 8 (error) where zeros were first encountered and last
encountered. In most cases, this is not an error
System Action: Processing is terminated. condition. This is a normal condition for segmented
User Response: Check the parameter list and make table spaces and also for index spaces created with a
sure that there are no spaces between any of the FREEPAGE parameter not equal to zero. In addition, it
parameters. is also normal for nonsegmented table spaces to
contain zero pages after certain update scenarios
terminated abnormally and data rollback was required.
DSN1983I csect-name DICTIONARY IS INVALID,
REASON= X’nnnn’ Severity: 4 (warning)
Explanation: The dictionary found in the data set is System Action: Processing continues.
invalid. A DB2 internal error occurred during the User Response: Notify the system programmer.
validation of the expansion dictionary.
System Programmer Response: If the zero page is
Severity: 8 (error) the result of segmenting, no action is necessary.
System Action: Processing terminates. Similarly, if the zero page is a valid zero page that was
introduced by DB2, no action is necessary as this page
User Response: Verify that the correct data set is is free space and is used by DB2 when needed. If the
specified. You can delete the EXPAND option and zero page is a valid zero page and you want to remove
resubmit the job. it from the table space, run the REORG utility.
System Programmer Response: Determine the To help determine if the zero page was validly
failing environment. Refer to Part 2 of DB2 Diagnosis introduced by DB2, run the CHECK INDEX utility. This
Guide and Reference for information on identifying and assumes that at least one index is defined on the
reporting the problem. affected table space.
Problem Determination: The REASON identifies the If the zero page is determined to be invalid, you need to
nature of the error. The REASON is used for diagnostic run the RECOVER utility.
purposes by the IBM Support Center.
DSN1986I NEITHER FULLCOPY NOR INCRCOPY
DSN1984I UNEXPECTED PAGE NUMBER, PARAMETERS MAY BE SPECIFIED
EXPECTING: expected-page-number WITH THE SEGMENT PARAMETER.
Explanation: This message indicates that an Explanation: The parameters SEGMENT, FULLCOPY,
unexpected page number was encountered. This and INCRCOPY describe the type of input that SYSUT1
message may be received if the input data set is an references. SEGMENT is only relevant when a table
image copy but the FULLCOPY or INCRCOPY space or index space is the input. FULLCOPY and
parameters were not specified. The 'expected page INCRCOPY are only relevant when a image copy is the
number' that is displayed (in hexadecimal) is the page input. If the input data set is a segmented table space,
number that was expected, not the one that was then the FULLCOPY or INCRCOPY parameters should
encountered. not be specified. If the input data set is a full or
Severity: 8 (error) incremental image copy, then SEGMENT should not be
specified.
System Action: Processing is terminated.
Severity: 8 (error)
User Response: Notify the system programmer.
System Action: Processing will terminate.
System Programmer Response: Use DSN1PRNT to
Chapter 24. DB2 Messages 657
DSN1987I • DSN1992I
User Response: Omit the incorrect parameter.
DSN1990I csect-name BROKEN PAGE. PAGE
NUMBER = broken-page-number.
DSN1987I csect-name INDEX PAGE CONTAINING REASON: comment, SERVICE INFO:
OBID id HAS NO MATCHING VALUE IN CODE = c1, d1 = v1 ... dn = vn
THE SYSXLAT FILE.
Explanation: During page checking, the page was
Explanation: This message is issued when the OBID detected as broken for the reason given in the
on the page does not find a matching value in the input message. The page number is displayed in hexadecimal
source OBID list. This message can also be issued format.
when the input does not have enough OBID values.
Severity: 4 (warning)
Severity: 8 (error)
System Action: Processing continues.
System Action: Processing terminates with a dump of
Operator Response: Notify the system programmer.
the page on which the OBID does not find a match in
the source list. System Programmer Response: Use either the
RECOVER or REPAIR utility to correct the broken page.
User Response: Resubmit the job with correct input
OBID values. Problem Determination: If you suspect an error in
DB2, refer to Part 2 of DB2 Diagnosis Guide and
Reference for information on identifying and reporting
DSN1988I csect-name EXPAND KEYWORD IS
the problem.
SPECIFIED BUT DICTIONARY IS NOT
FOUND Service information is used for diagnostic purposes by
the IBM Support Center.
Explanation: DSN1PRNT issues this message when
the EXPAND option is specified. The dictionary was not
found in the data set. An incorrect data set piece is DSN1991I UNCLUSTERED DATA DETECTED. RID:
specified or an incorrect data set number is specified for ’xxxxxxxx’X TABLE: tablename INDEX
a multi-piece linear data set. KEY: index-key
Severity: 8 (error) Explanation: Data is not broken. Only the
arrangement of data on one of the following DB2
System Action: Processing terminates.
Catalog table spaces: SYSDBASE, SYSPLAN, and
User Response: Resubmit the job specifying the SYSVIEWS has been affected. Normally, data on these
correct keyword or the correct data set name. pages is arranged to minimize locking contention.
DSN1COPY found that the arrangement of data no
longer minimizes locking contention for the objects
DSN1989I csect-name IS PROCESSED WITH THE named by the INDEX KEY for the given TABLE.
FOLLOWING OPTIONS: Therefore, an increase in the number of deadlocks and
: timeouts may be seen on SYSDBASE, SYSPLAN, and
SYSVIEWS.
v check/32K/fullcopy/incrcopy/segment/
v numparts=n/format/expand/swonly/ System Action: If you suspect an error in DB2, refer
to Part 2 of DB2 Diagnosis Guide and Reference for
v print/value/obidxlat/reset/no check/4K/
information on identifying and reporting the problem.
v no imagecopy/nonsegment/numparts=0/
Problem Determination: Contact your IBM Support
v no print/no value/no obidxlat/
Center for assistance. Collect the following diagnostic
v no format/no reset/no expand/no swonly items listed in “Appendix B. Problem determination” on
Explanation: The stand-alone utility named page 1281: 1, 2, 5, 64.
csect-name is processing with the options that are
either specified or supplied by default. DSN1992I VSAM PUT ERROR, RPLERREG =
Severity: 0 (informational) return-code, RPLERRCD = reason-code
System Action: Processing continues. Explanation: VSAM PUT failed with the indicated
error code.
User Response: Make sure that the parameters are
correct. Not specifying the parameters correctly can give Severity: 8 (error)
unpredictable results. System Action: Processing terminates.
User Response: Notify system programmer.
System Programmer Response: Follow standard
VSAM diagnostic procedures. See DFSMS/MVS: Macro
658 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN1993I • DSN1999I
Instructions for Data Sets for more information on the User Response: Notify system programmer.
standard VSAM procedures, the RPL fields, and the
System Programmer Response: Follow standard
VSAM control blocks.
VSAM diagnostic procedure. See DFSMS/MVS: Macro
Instructions for Data Sets for more information on the
DSN1993I DSN1COPY/DSN1PRNT/DSN1COMP standard VSAM procedures and the VSAM control
TERMINATED, page-count PAGES blocks.
PROCESSED
Explanation: This message indicates that a DSN1997I OUTPUT DSNAME = data-set-name,
stand-alone utility has not successfully completed data-set-type
processing. The page count is displayed in decimal
Explanation: The indicated 'data set name' is used for
format.
output. 'data set type' is either VSAM or SEQ (for
Severity: 8 (error) sequential).
System Action: Processing terminates. Severity: 0 (informational)
User Response: Examine the previous error message
of the application program. DSN1998I INPUT DSNAME = data-set-name,
data-set-type
System Programmer Response: Correct the previous
error and resubmit the job. Explanation: The indicated 'data-set-name' is used for
input. 'data-set-type' is either VSAM or SEQ (indicating
sequential).
DSN1994I DSN1COPY/DSN1PRNT/DSN1COMP
COMPLETED SUCCESSFULLY, Severity: 0 (informational)
page-count PAGES PROCESSED
Explanation: This message indicates that a DSN1999I START OF
stand-alone utility successfully completed processing. DSN1COPY/DSN1PRNT/DSN1COMP
The page count is displayed in decimal format. FOR JOB job-name step-name
Severity: 0 (informational) Explanation: This message indicates that a
stand-alone utility started processing.
System Action: Processing terminates.
Severity: 0 (informational).
DSN1995I VSAM GET ERROR, RPLERREG = System Action: The stand-alone utility starts
return-code, RPLERRCD = reason-code processing.
Explanation: VSAM GET failed with the indicated
error code.
Severity: 8 (error)
System Action: Processing terminates.
User Response: Notify system programmer.
System Programmer Response: Follow standard
VSAM diagnostic procedures. See DFSMS/MVS: Macro
Instructions for Data Sets for more information on the
standard VSAM procedures, the RPL fields, and the
VSAM control blocks.
DSN1996I VSAM OPEN ERROR, ACBERRFLG =
ACB error-code. OPEN option
Explanation: VSAM OPEN failed with the indicated
'ACB error-code'. The OPEN option was either 'INPUT'
or 'OUTPUT'.
Severity: 8 (error) if error is greater than or equal to
128; otherwise, severity code is 4.
System Action: Processing terminates if error code is
greater than or equal to 128; otherwise, processing
continues normally.
Chapter 24. DB2 Messages 659
660 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 25. DSN2... Messages
There are two versions of the CICS attachment facility:
v The version shipped with DB2 requires CICS Version 3 Release 3 or an earlier
release. This attachment facility issues DSNCxxx messages.
v The version shipped with CICS requires a CICS release later than Version 3
Release 3. This attachment facility issues DSN2xxx messages.
DSN2001I CICS UR INDOUBT RESOLUTION IS DSN2004I THE PLAN NAME IS NOT FOUND IN
INCOMPLETE FOR ssid THE RCT
Explanation: CICS cannot resolve the disposition of Explanation: This message is the response to a
the units of recovery that DB2 holds indoubt from the DSNC DISPLAY or DSNC DISCONNECT command.
previous connection because CICS was cold started. The plan specified in the command was not found in the
resource control table (RCT).
System Action: The CICS attachment facility
continues the startup process. System Action: The CICS attachment facility
command is not processed.
Operator Response: Notify the CICS system
programmer. Operator Response: Reenter the command with the
correct plan name.
System Programmer Response: You must resolve
the indoubt units of recovery manually by issuing the
DB2 -DISPLAY THREAD and -RECOVER INDOUBT DSN2005I THE TRANSACTION NAME IS NOT
commands. FOUND IN THE RCT
Explanation: This message is the response to a
DSN2002I csect-name DSN2CTxx MODULE NOT DSNC DISPLAY or DSNC MODIFY command. The
FOUND transaction specified in the command was not found in
the resource control table (RCT).
Explanation: The resource control table DSN2CT with
suffix xx could not be loaded. System Action: The CICS attachment facility
command is not processed.
System Action: The CICS attachment facility
initialization terminates. Operator Response: Reenter the command with the
correct transaction name.
User Response: Reenter the start command with the
correct suffix. Ensure that the resource control table
DSN2CT is in the correct application program library, DSN2006I THE dest DESTINATION ID IS INVALID
which is concatenated in the JOBLIB or STEPLIB
Explanation: This message is the response to a CICS
statement of your CICS startup JCL.
attachment facility command. The destination ID dest
If DSN2CT is not in your application program library, specified in the command was not found in the CICS
ensure that you are using the correct version of the destination control table (DCT) or the resource control
DSNCRCT macro to assemble DSN2CT. For CICS table (RCT).
versions later than Version 3 Release 3, the correct
System Action: The CICS attachment facility
DSNCRCT macro is in the CICS macro library rather
command is not processed.
than in the DB2 macro library.
Operator Response: Reenter the command with the
correct destination ID.
DSN2003I THE ATTACHMENT FACILITY IS
ALREADY ACTIVE
DSN2007I THE COMMAND VERB IS MISSING OR
Explanation: The CICS attachment facility is already
INVALID
active and enabled to CICS.
Explanation: The CICS attachment facility does not
System Action: The CICS attachment facility
recognize the ACTION keyword on the entered
initialization is terminated.
command.
Operator Response: Only one CICS attachment
System Action: The command is not processed.
facility is permitted.
Operator Response: Reenter the command with the
correct syntax.
© Copyright IBM Corp. 1982, 2001 661
DSN2008I • DSN2014I
v Regenerate the RCT and make more threads
DSN2008I KEYWORD IS MISSING OR INVALID
available to the transaction that failed. Stop and then
Explanation: A CICS attachment facility command restart the CICS attachment facility to make the new
contains an unknown positional keyword or a keyword is RCT active.
missing.
System Action: The command is not processed. DSN2012I THE ATTACHMENT FACILITY STOP
QUIESCE IS PROCEEDING
Operator Response: Reenter the command with the
correct syntax. Explanation: A DSNC STOP command entered by the
master terminal operator is being processed.
DSN2009I THE VALUE IN THE COMMAND IS System Action: The CICS attachment facility releases
INVALID the terminal entering the command and proceeds with
the quiesce process.
Explanation: The numeric value in the DSNC
MODIFY command might be invalid. Otherwise, the Operator Response: If the quiesce is not completed
error is caused by one of the following: within the required time period, you can enter a DB2
v The value in the command is greater than the value -STOP FORCE command.
specified for the THRDM parameter in the resource
control table (RCT). DSN2013I DISPLAY REPORT FOLLOWS
v If the POOL RCT entry is being changed, the active
Explanation: A CICS attachment facility display was
thread count cannot be set to less than 3.
requested and follows this message.
System Action: The command is not processed.
System Action: Processing continues.
Operator Response: Reenter the command with a
valid value.
DSN2014I STATISTICS REPORT FOR rct-name
System Programmer Response: If the number of FOLLOWS
threads required is more than the number allowed in the
Explanation: A CICS attachment facility statistics
resource control table (RCT), specify a larger number of
display was requested and follows this message. The
threads in the THRDM parameter and regenerate the
name of the resource control table (RCT) that is
table.
currently in use is rct-name.
The following information is displayed for each entry in
DSN2011I tran TRANSACTION ABENDED
the RCT:
BECAUSE THREADS ARE
UNAVAILABLE TRAN CICS transaction name.
Explanation: The transaction with CICS transaction ID PLAN DB2 plan name.
tran was abnormally terminated because a thread
connection to DB2 was not available for the transaction. CALLS Total number of SQL statements in this
This error message can occur when: connection.
v TWAIT of the transaction entry in the resource control AUTHS
table is NO. Total number of sign-on invocations for
v TWAIT of the transaction entry is POOL, TWAIT in transactions associated with this entry. A
the pool entry is NO, and all threads in the POOL are sign-on does not indicate whether a new
active. thread is created or an existing thread is
reused. If the thread is reused and
System Action: The indicated transaction is abended. TOKENE=NO, a sign-on occurs only if the
No other action is taken by the CICS attachment facility authorization ID or transaction ID has changed.
Operator Response: Notify the CICS system W/P Number of times all available threads for this
programmer. entry were busy and the transaction had to
wait or the thread request was diverted to the
System Programmer Response: Determine which of
POOL.
the following actions will correct the problem:
v If more threads are available with the current HIGH Maximum number of concurrent threads
generation of the resource control table (RCT), tell required by transactions associated with this
the master terminal operator to make more threads entry at any time since the CICS attachment
active by using the DSNC MODIFY command. facility was started.
ABORTS
Total number of units of recovery that were
rolled back.
662 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN2015E • DSN2023I
COMMITS is requested to abend the transaction.
One of the following two fields is incremented
Operator Response: Notify the system programmer.
each time a DB2 transaction associated with
this entry has an explicit or implicit (such as System Programmer Response: The error might be
EOT) sync point. caused by one of the following:
1-PHASE v There is a shortage of storage in the local storage
The total number of single phase commits for queue area (LSQA).
transactions associated with this entry. v The maximum number of thread subtasks allowed
was reached. The maximum is specified in the
2-PHASE
THRDMAX parameter of RCT. The DSNC DISPLAY
The total number of two phase commits for
STATISTICS command is useful in analyzing the
transactions associated with this entry.
current thread usage.
For a more detailed explanation of the fields in the
statistics report, refer to ″Controlling CICS Connections″ DSN2018I name IS NOT ACTIVE
in Part 4 (Volume 1) of DB2 Administration Guide.
Explanation: The DSNC STRT command cannot
System Action: Processing continues normally. proceed because subsystem name is not active.
System Action: The DSNC STRT command
DSN2015E csect THE ATTACHMENT FACILITY FOR processing ends without starting the CICS attachment
name IS IN STANDBY facility.
Explanation: The CICS attachment facility has Operator Response: Reenter the CICS attachment
dropped into standby mode because DB2 has stopped facility command after DB2 is started.
and STANDBY=SQLCODE was specified in the RCT.
System Action: The CICS attachment facility will DSN2019I THE MODIFY COMMAND IS
issue negative SQLCODEs for all SQL requests. COMPLETE
Operator Response: Restart the attachment after Explanation: The DSNC MODIFY command
DB2 is restarted. completed successfully.
DSN2016I csect-name THE CONNECTION OF CICS DSN2020I THE DISPLAY COMMAND IS
WITH name FAILED, ’reason-code’ COMPLETE
Explanation: The CICS attachment facility is Explanation: The DSNC DISPLAY command
terminating abnormally because an error occurred while completed successfully.
connecting with DB2. The error is indicated by
reason-code, and the specific DB2 subsystem is
DSN2021I THE DISCONNECT COMMAND IS
indicated by name.
COMPLETE
System Action: The CICS attachment facility
Explanation: The DSNC DISCONNECT command
terminates with abend completion code X'04E'. If the
completed successfully.
initial identify fails because of an authorization error,
DSN2042I is issued and no dump is requested.
DSN2022I THE ATTACHMENT FACILITY STOP
Operator Response: Notify the system programmer.
FORCE IS PROCEEDING
System Programmer Response: Look up
Explanation: A DSNC STOP FORCE command
reason-code to determine the specific failure that
entered by the master terminal operator is being
caused the termination.
processed.
System Action: The CICS attachment facility releases
DSN2017I ATTACHMENT OF A THREAD
the terminal entering the command and proceeds with
SUBTASK FAILED
the STOP FORCE processing.
Explanation: The CICS attachment facility continues
processing but is unable to start as many thread
DSN2023I THE ATTACHMENT FACILITY HAS
subtasks as are allowed in a resource control table
CONNECTED TO name USING rct-name
(RCT) entry.
Explanation: The DSNC STRT command successfully
System Action: The CICS attachment facility
completed. Subsystem name is now available to CICS.
attempted to terminate all subtasks that are currently
The name of the resource control table (RCT) that was
unused, but none could be terminated. If other subtasks
are not active to process the current transaction, CICS
Chapter 25. DB2 Messages 663
DSN2024I • DSN2030E
specified for this start of the CICS attachment facility is
DSN2027I SHUTDOWN IS IN PROGRESS.
rct-name.
transaction COMMANDS MAY NOT BE
System Action: The DSNC STRT command ENTERED
completes processing. The CICS attachment facility is
Explanation: The CICS attachment facility does not
active.
accept commands directed to DB2 during or after the
termination of the CICS attachment facility.
DSN2024I dest CANNOT BE LOCATED IN THE
System Action: The command is rejected.
DCT
User Response: Notify the CICS attachment facility
Explanation: The destination shown in the message
system programmer.
cannot be located in the CICS destination control table
(DCT).
DSN2028I USER IS NOT AUTHORIZED FOR
System Action: The CICS attachment facility startup
transaction COMMANDS
process continues. The destination entry in the resource
control table (RCT) is set to '*' for potential modification Explanation: DB2 rejected the command request
by the CICS attachment facility. during the sign-on of the user. Therefore, the user is
assumed to be unauthorized for the requested function
Operator Response: Notify the system programmer.
in the command.
Use the DSNC MODIFY command to set the error
destination to the correct identification characters. System Action: The command is rejected.
System Programmer Response: Correct either the Operator Response: Notify the CICS attachment
RCT or the DCT to synchronize the error destinations. facility system programmer.
System Programmer Response: The authorization ID
DSN2025I THE ATTACHMENT FACILITY IS used is described in the generation procedures of the
INACTIVE resource control table (RCT). If this user should be
allowed access to the command, use the GRANT
Explanation: This is the final message issued by the
statement to grant authorization.
CICS attachment facility to inform the resource control
table error destinations that the CICS attachment facility
completed the shutdown process. DSN2029I transaction COMMAND FAILED,
REASON CODE rc
System Action: The CICS attachment facility is
terminated. Explanation: The DB2 command, identified in the
message as transaction, failed to return a response
message indicating the action taken by the command.
DSN2026I DSN2STOP FAILED TO DISABLE THE
DB2 returned reason code rc.
name RMI EXIT
System Action: The results of the command are
Explanation: The CICS attachment facility failed to
unknown.
disable the named resource manager interface (RMI)
exit. Either the exit was in use at the time DSN2STOP Operator Response: Notify the CICS attachment
tried to disable it, or an abend occurred in the RMI exit facility system programmer.
code while the 'in use' flag was on. The CICS system
System Programmer Response: Check the master
must be stopped and restarted before the CICS
console for any messages indicating why the command
attachment facility can be restarted.
failed. Refer to the explanation of the reason code
System Action: The CICS attachment facility returned by DB2 in “Part 4. DB2 Codes” on page 707.
continues termination processing after dumping the
CICS trace, the resource control table (RCT), and the
DSN2030E AN ERROR HAS OCCURRED WRITING
connection control table (CCT).
TO THE TRANSIENT DATA OUTPUT
Operator Response: Notify the CICS attachment DESTINATION destination
facility system programmer. CICS must be stopped and
Explanation: The CICS attachment facility
restarted before restarting the CICS attachment facility.
encountered an error while writing to the indicated
System Programmer Response: This could be a destination.
problem in the CICS 'task-related user exit'. Analyze the
System Action: The CICS attachment facility
trace and any dumps associated with this execution to
continues operation.
determine the source of the error.
Operator Response: Notify the system programmer. If
the destination is one of the resource control table error
destinations, use the CICS MODIFY command to
664 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN2031I • DSN2037A
change the destination code to another destination, if -DISPLAY THREAD and -RECOVER INDOUBT
one is available. commands to ensure that all indoubt units of recovery
are resolved.
System Programmer Response: Follow CICS
procedures to correct the error. Refer to CICS/ESA You must identify the reason for the inconsistency. A
Problem Determination Guide for additional information. DB2 cold start, for example, might cause the problem.
DSN2031I THE COMMAND IS INVALID. THE DSN2035I INDOUBT RESOLUTION FOR ur-id IS
ATTACHMENT FACILITY IS INACTIVE INCOMPLETE
Explanation: STRT is the only valid command when Explanation: CICS indicates recovery should not be
the CICS attachment facility is inactive. No other required for the ur-id, but DB2 is indoubt.
commands to the CICS attachment facility are accepted.
System Action: The CICS attachment facility
System Action: The command is rejected. continues the startup process.
Operator Response: Notify the CICS system
DSN2032I transaction COMMAND ALTERNATE programmer.
DESTINATION OUTPUT COMPLETE
System Programmer Response: CICS cannot
Explanation: The DB2 command identified in the recover a unit of recovery using an identifier that was in
message as transaction is complete. The resulting the resolution request list from DB2. Use the DB2
output should be available at the requested device. -DISPLAY THREAD and -RECOVER INDOUBT
commands to ensure that all indoubt units of recovery
System Action: Processing continues normally.
are resolved.
You must identify the cause of the error. A CICS cold
DSN2033I TERMINAL termid IS NOT SUPPORTED
start could cause this problem.
BY BMS OR IS INVALID
Explanation: This message is issued in response to a
DSN2036I INDOUBT RESOLUTION FOR ur-id IS
CICS attachment facility or DB2 command that
INCONSISTENT
requested an alternate destination for the response.
CICS basic mapping support (BMS) encountered an Explanation: CICS indicates recovery resolution for
error while routing to the requested terminal named the ur-id should be ABORT (backout), but DB2 indicates
termid. the resolution should be COMMIT.
System Action: The output from the command might This error can be caused by a damaged CICS system
be suppressed. journal file.
Operator Response: Ensure that the terminal ID was System Action: DB2 committed the unit of recovery.
correctly entered. Otherwise, notify the system The CICS attachment facility continues the startup
programmer. process.
System Programmer Response: Verify that the Operator Response: Notify the CICS system
terminal ID is valid. This message might occur if the programmer.
destination device is not supported by BMS or if it is not
System Programmer Response: CICS and/or DB2
defined to CICS. If termid is CSMT, this message might
restart processes are not in synchronization. You must
also follow message DSN2030E. The attachment facility
identify the cause of the error. Take appropriate action
unconditionally routes output to terminal CSMT following
to return all resources to a consistent state.
a transient data destination error.
DSN2037A subsystem IS NOT ACTIVE transaction IS
DSN2034I INDOUBT RESOLUTION FOR ur-id IS
WAITING
INCORRECT
Explanation: The CICS attachment facility start
Explanation: CICS indicates recovery is required for
transaction identified in the message is waiting for
the ur-id, but the unit of recovery is not indoubt to DB2.
notification from the indicated DB2 subsystem that it is
System Action: The CICS attachment facility active. The start of the CICS attachment facility is
continues the startup process. complete after DB2 has started.
Operator Response: Notify the CICS system System Action: The CICS attachment facility waits to
programmer. complete the start process.
System Programmer Response: CICS tried to Operator Response: Start the DB2 subsystem.
recover a unit of recovery using an identifier that was
not in the resolution request list from DB2. Use the DB2
Chapter 25. DB2 Messages 665
DSN2038I • DSN2045I
named DB2 subsystem. Refer to Part 3 (Volume 1) of
DSN2038I THE COMMAND IS INVALID WHILE
DB2 Administration Guide for information on how to
WAITING FOR subsystem name
authorize a user to access DB2.
Explanation: The command entered cannot be
processed while the CICS attachment facility is waiting
DSN2043I DSN2STOP ENCOUNTERED ERROR,
for the DB2 subsystem to start. The name of the DB2
RECOVERY ROUTINE
subsystem that is not yet operational is subsystem
started/completed
name.
Explanation: A CICS abend occurred while
System Action: The command is rejected.
disconnecting the CICS attachment facility from DB2
and deleting it from storage. This message might be
DSN2039I THE ERROR DESTINATIONS ARE: d1 issued twice. It is issued at the start of the abend
d2 d3 recovery routine, which is indicated by 'started' in the
message text. If the recovery routine is successful, the
Explanation: This message is the response to the
message is issued with 'completed' in the message text.
DSNC MODIFY DESTINATION command that lists the
currently active message destinations known to the System Action: If the recovery routine is not
CICS attachment facility. Null entries that show as '****' successful, program DSN2STOP terminates with a
can be modified so they identify actual destinations. CICS transaction dump. If the recovery routine is
successful, the CICS attachment facility is terminated
normally.
DSN2040I MODULE name COULD NOT BE
FOUND Operator Response: Notify the system programmer.
Explanation: During the CICS attachment facility System Programmer Response: Analyze any abend
initialization, an attempt was made to locate and load dumps associated with this message to determine the
the named module, but it was not found in any of the cause of the failure.
libraries accessible to MVS through the MVS LOAD
macro.
DSN2044I DSNCRCT ENTRY HAS BEEN
System Action: The CICS attachment facility CORRUPTED OR OVERLAID
initialization is terminated.
Explanation: The CICS attachment facility detected
Operator Response: Notify the CICS attachment that a resource control table (RCT) entry was corrupted
facility system programmer. or overlaid since the CICS attachment facility was last
started.
System Programmer Response: Check the CICS
JOBLIB/STEPLIB libraries and ensure that the CICS System Action: The CICS task is abended with
SDFHAUTH and the DB2 SDSNLOAD libraries are reason code 00C30011. No other action is taken by the
defined there. CICS attachment facility.
Operator Response: Notify the system programmer.
DSN2041I NO ACTIVE THREADS
System Programmer Response: Analyze the abend
Explanation: A DSNC DISPLAY TRANSACTION or dumps associated with this message to determine which
DSNC DISPLAY PLAN command was entered, but CICS transaction and RCT entry was corrupted. Restart
there were no active threads created. The CICS the CICS attachment facility to obtain a valid copy of the
attachment facility might have identified and signed on RCT.
the attached subtasks, but a create thread was not
issued for any of the subtasks.
DSN2045I RESOURCE MANAGER rmi-name IS
UNKNOWN TO CICS ATTACH FACILITY
DSN2042I CONNECTION NOT AUTHORIZED TO
Explanation: The CICS attachment facility received a
name
request from a resource manager interface (RMI)
Explanation: The attempt to connect to the named named rmi-name. This RMI is not known by the CICS
DB2 subsystem failed because the user was not attachment facility.
authorized to access DB2. Authorization was denied by
System Action: The CICS task is abended with a
either RACF or a user-written connection exit.
CICS transaction dump.
System Action: The CICS attachment facility
Operator Response: Notify the system programmer.
terminates.
System Programmer Response: Analyze the CICS
Operator Response: Notify the system programmer.
transaction dump to determine the source of the
System Programmer Response: The user specified unknown resource manager interface (RMI) request.
on the CICS job was not authorized to connect to the
666 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN2046I • DSN2052I
Problem Determination: CICS dump information, situation the information supplied by the Execution
such as the trace table and program storage, can aid in Diagnostic Facility (EDF) of CICS for SQL statements
determining which module issued the request. The consists of:
CICS EXEC interface block resource name field, v The EDF status: ABOUT TO EXECUTE or
EIBRSRCE, contains the name of the RMI. COMMAND EXECUTION COMPLETE
If you suspect an error in DB2, refer to Part 2 of DB2 v The processing status: CALL TO RESOURCE
Diagnosis Guide and Reference for information on MANAGER DSNCSQL
identifying and reporting the problem. v The ARG values associated with this call to the CICS
attachment facility resource manager
DSN2046I RCT RELEASE LEVEL nnnn IS No other information is provided about the SQL
INCONSISTENT WITH CICS ATTACH statement.
RELEASE LEVEL mmmm
Explanation: The resource control table (RCT) release DSN2049E csect-name RECOVER INDOUBT FOR
level nnnn does not match the CICS attachment facility urid FAILED WITH reason-code
release level mmmm.
Explanation: A resolve indoubt request passed to DB2
This message is issued by the following CSECT: from CICS failed.
DSN2STRT
System Action: The attachment leaves the unit of
Operator Response: Notify the system programmer. recovery indicated by 'urid' indoubt in CICS and DB2.
System Programmer Response: Reassemble the The attachment requests a system dump of the CICS
RCT using the correct DB2 release level mmmm region.
DSNCRCT macro. System Programmer Response: Use the reason
code to determine why the RECOVER INDOUBT
DSN2047I TWA SIZE IS TOO SMALL FOR request failed. If necessary, manually resolve the unit of
TRANSID tran recovery using the RECOVER INDOUBT command.
Explanation: The CICS TWASIZE defined for Problem Determination: If you suspect an error in
transaction tran is too small to support the CICS DB2, refer to Part 2 of DB2 Diagnosis Guide and
attachment facility command processor program Reference for information on identifying and reporting
(DSN2COM1). the problem.
System Action: The CICS attachment facility abends Collect the following diagnostic items listed in
this CICS task with a CICS transaction abend. “Appendix B. Problem determination” on page 1281: 82,
Operator Response: Notify the system programmer.
DSN2052I INSUFFICIENT STORAGE AVAILABLE
System Programmer Response: Redefine the TO START ATTACHMENT FACILITY
command processor transaction to specify the correct
TWASIZE. Explanation: During startup the CICS attachment
facility was unable to allocate the required amount of
storage. This message might be issued if an error
DSN2048I UNABLE TO INTERPRET SQL CALL occurs while the attachment facility is loading the data
WHILE FORMATTING AN EDF DISPLAY only load module, DSN2CTxx.
TRAN tran TASK task
System Action: The CICS attachment facility is not
Explanation: The CICS attachment facility was unable initialized.
to decipher storage associated with an SQL statement
for CICS transaction tran and task id task. Either the System Programmer Response: Allow a larger
SQL communications area (SQLCA) or the RDS input amount of dynamic storage on your CICS system.
parameter list (RDI) storage could not be interpreted by Alternatively, you can delete unused entries or lower
the CICS attachment facility. THRDA and THRDM values in your RCT, which reduces
the size of the storage that the attachment facility
System Action: A CICS transaction dump is taken of requires.
the storage in question.
For a load error, check the MVS console log for any
Programmer Response: Ensure that CICS storage preceding messages to determine why the load failed. If
associated with this task was not altered or overlaid. there is not enough free REGION space to load the
Analyzing the storage in the CICS transaction dump RCT, see the appropriate CICS documentation for
might provide clues about the source of the problem. information on tuning your CICS system.
Problem Determination: Analyze the CICS
transaction dump of the storage in question. In this
Chapter 25. DB2 Messages 667
DSN2053I • DSN2060I
User Response: Ensure that the CSD definition of the
DSN2053I INSUFFICIENT TWASIZE FOR
DSNC transaction specifies program DSNCCOM1. If
DSN2COM1. REQUIREMENT IS twasize
you are initializing the attachment facility using CICS
Explanation: The CICS attachment facility requires a program list table (PLT) processing, ensure that your
TWASIZE of twasize on all transactions that execute CICS PLTPI table uses program DSNCCOM0 to
DSN2COM1. Either the TWASIZE that was specified is initialize the attach.
less than the requirement, or no TWASIZE was
specified at all.
DSN2059I csect-name CICS ATTACHMENT
System Action: The attachment facility terminates. FACILITY MISMATCH WITH RESOURCE
CONTROL TABLE rct-name
System Programmer Response: Ensure that CSD
group DFHDB2 was installed in the CSD. Any Explanation: The wrong macro library was used to
transaction that executes program DSN2COM1 should assemble DSN2CT, the resource control table.
specify TWASIZE(twasize) on its transaction entry.
There are two versions of the CICS attachment facility.
The version shipped with DB2 requires CICS Version 3
DSN2054I DYNAMIC PLAN PROGRAM LINK Release 3 or an earlier release; the one shipped with
FAILED FOR TRANSACTION CICS requires a CICS release later than Version 3
’transaction’. EIBRESP WAS ’eibresp’. Release 3. This error message indicates CICS is using
the attachment facility shipped with CICS, but the RCT
Explanation: The attachment facility was unable to
was assembled using the DB2 macro libraries.
link to the dynamic plan exit program specified in
DSNCRCT. The reason code provided by CICS in the System Action: The CICS attachment facility
EIBRESP field of the EIB is given in this message. initialization terminates.
System Action: The transaction is abended with a User Response: Reassemble DSN2CT using the
DSNC abend. DSNCRCT macro shipped in the CICS macro libraries.
User Response: Look up the eibresp value in CICS
for MVS/ESA Application Programming Reference. This DSN2060I csect-name INITPARM IS IGNORED
value was returned from CICS after the attachment BECAUSE FORMAT IS INVALID.
facility attempted to link to the dynamic plan exit. Take
Explanation: The DSN2STRT INITPARM specified on
appropriate action based on the eibresp. For example, if
the CICS initialization job is incorrect. The format of the
eibresp was PGMIDERR, check your RCT entry for
INITPARM should be:
transaction transaction to ensure that the dynamic plan
exit program name (PLNPGME or PLNPGMI) is the INITPARM=(DSN2STRT='xx,yyyy')
name of a valid program known to CICS.
where xx is the suffix of the RCT and yyyy is the DB2
subsystem id. The RCT suffix cannot be greater than 2
DSN2055I SINGLE PHASE COMMIT FAILED FOR characters, and the subsystem ID cannot be greater
TRANSACTION ’transaction’. EIBTASKN than 4 characters.
WAS ’task number’.
Explanation: CICS requested a single phase commit To specify an RCT suffix only, use the format:
from DB2, but DB2 was unable to comply. INITPARM=(DSN2STRT='xx')
System Action: The transaction is abended with a
DSNC abend. To specify a subsystem ID override only, use the format:
INITPARM=(DSN2STRT=',yyyy')
User Response: Contact the IBM Support Center for
assistance. System Action: The attachment facility attempts to
initialize with the subsystem ID specified in the DSNC
STRT command. If no subsystem ID is provided there, it
DSN2056I csect-name CICS RELEASE release IS
attempts to initialize with the subsystem ID specified in
DOWN LEVEL FOR THIS ATTACHMENT
the resource control table.
FACILITY
User Response: If you want to override the
Explanation: The attachment facility that you are
subsystem ID, restart the attachment facility using the
using requires a CICS release later than Version 3
DSNC STRT command with the correct SSID.
Release 3. You are using CICS Version 3 Release 3 or
Alternatively, you can correct the DSN2STRT INITPARM
an earlier release. For this release of CICS, you must
and reinitialize CICS.
use the attachment facility shipped with DB2.
System Action: The attachment facility does not
initialize.
668 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN2061I • DSN2901I
the abend, correct it if necessary, and restart the
DSN2061I csect-name INITPARM IS INVALID.
attachment facility.
ATTACHMENT FACILITY NOT
STARTED.
DSN2065I csect-name INVALID LENGTH. DATA
Explanation: No resource control table suffix was
NOT DISPLAYABLE.
specified on the DSNC STRT command, and the format
of the DSN2STRT INITPARM on the CICS initialization Explanation: The module running under the CICS
job is incorrect. The format of the INITPARM should be: Execution Diagnostic Facility (EDF) attempted to display
INITPARM=(DSN2STRT='xx,yyyy') an input or output variable that had an incorrect length
indicator.
where xx is the suffix of the RCT and yyyy is the DB2 System Action: EDF processing continues, but the
subsystem id. The RCT suffix cannot be greater than 2 value of the variable is not displayed.
characters, and the subsystem ID cannot be greater
than 4 characters.
DSN2070I csect ROLLBACK FAILED FOR
To specify an RCT suffix only, use the format: TRANSACTION transaction EIBRESP2
= X’eibresp2’
INITPARM=(DSN2STRT='xx')
Explanation: The attachment facility was unable to
To specify a subsystem ID override only, use the format: issue a CICS ROLLBACK. The reason code provided
INITPARM=(DSN2STRT=',yyyy') by CICS in the EIBRESP2 field of the EIB is shown in
eibresp2.
System Action: The attachment facility does not
initialize. System Action: The transaction is abended with a
DSNC abend.
User Response: To start the attachment facility, use
the DSNC STRT command and specify a resource System Programmer Response: Look up the
control table suffix on the command. Alternatively, you eibresp2 value in CICS for MVS/ESA Application
can correct the DSN2STRT INITPARM and reinitialize Programming Reference. This value was returned from
CICS. CICS after the attachment facility attempted a
ROLLBACK requested by the ROLBE=YES option.
DSN2063I csect-name NOT AUTHORIZED TO
START TRANSACTION transaction. DSN2700I DSN2SAMG message-id HAS BEEN
ATTACHMENT FACILITY NOT STARTED ISSUED
Explanation: The user was not authorized to start Explanation: This message is issued only if the
transaction transaction. requested message was not found in the message
directory (DSN2MSGT).
The CICS-DB2 attachment facility starts transaction
during initialization. Before it starts transaction, it checks System Action: The system proceeds as though the
external security (such as RACF) using CICS’s QUERY requested message was issued.
SECURITY command. When CICS returns the value Operator Response: Notify the system programmer.
NOTREADABLE for transaction, the attachment facility
produces this message. System Programmer Response: Refer to this manual
for the message text.
System Action: The attachment facility does not
initialize. Problem Determination: If you suspect an error in
DB2, refer to Part 2 of DB2 Diagnosis Guide and
System Programmer Response: Identify the Reference for information on identifying and reporting
authorization ID of the user who started the attachment the problem.
facility. Use your external security product to authorize
that user to start transaction.
DSN2901I UNRECOVERABLE IOERROR IN
PROGRAM DSN2COM1. THE
DSN2064I csect-name transaction ABENDED. ATTACHMENT FACILITY WILL
ATTACHMENT FACILITY IS SHUTDOWN.
TERMINATING.
Explanation: An attempt to retrieve data stored for
Explanation: The CICS-DB2 transaction transaction program DSN2COM1 failed when CICS returned an
abended. exceptional condition of IOERR (EIBRESP = X'11').
System Action: The CICS-DB2 attachment facility System Action: The DB2-CICS attachment facility is
terminates. shutdown.
System Programmer Response: Identify the cause of Operator Response: Notify the system programmer.
Chapter 25. DB2 Messages 669
System Programmer Response: An IOERR occurs if
an input or output error occurs during a RETRIEVE
operation. Examine the CICS auxiliary trace records and
the CICS system log to determine the cause of the
IOERR.
670 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 26. DSN3... Messages
see the URs still indoubt. It may show that all indoubt
DSN3001I csect-name ABNORMAL DISCONNECT
URs have already been resolved. The -RECOVER
FROM SUBSYSTEM INTERFACE
INDOUBT command should be used, either from an
Explanation: This message indicates that 'csect-name' MVS console or through an attachment facility, to
detected that an online routine was still supporting SSI resolve the indoubt URs and to release the resources
calls (IEFSSREQ) even though DB2 was nearly done they hold.
terminating or no longer executing. This occurs with
Problem Determination: This error is probably
'csect-name' DSN3RS0Xwhen the service address
caused by a cold start after an abnormal termination of
space has reached end-of-memory and neither normal
either subsystem or by offline alterations of the logs of
termination nor online error recovery routines have
either subsystem.
successfully completed termination of the DB2
subsystem. This occurs with 'csect-name' DSN3SSTM
when this condition is discovered during online DSN3004I DESCRIPTOR GET FAILURE RC=X
termination. xxxxxxxx, REASON=X xxxxxxxx
System Action: The connection is terminated. All Explanation: The parameter list required to create the
IEFSSREQ requests are handled by the DB2 ERLY DB2 agents under which IEFSSREQ calls are
code until DB2 is restarted. processed could not be obtained from the subsystem
support subcomponent directory of internal parameters
Problem Determination: An SVC dump is requested.
(DSN3DIR1). The RC indicates the return code received
This SVC dump and associated SYS1.LOGREC entries
from the system parameter manager and REASON
provide information to determine which resource
indicates the reason code (from register 0).
managers had not removed their support of particular
SSI function codes. The return code is always 4 when this message is
presented, indicating that the IEFSSREQ descriptor was
For dumps requested by DSN3RS0X,all pertinent
not found in the subsystem support subcomponent
control blocks and stack storage are dumped. The
directory. This is a system error and results in
primary control block of interest is the SSVT for DB2.
termination of the DB2 subsystem. The reason code is
For DSN3SSTM, the DB2 'standard dump' facility is always 0.
used to dump the information necessary for problem
System Action: Subsystem initialization is
diagnosis. The primary control blocks of interest are the
discontinued. Termination occurs.
'active' CONN blocks.
System Programmer Response: Repair the master
directory (DSNZPARM) and/or the DB2 program
DSN3002I RECOVERY INCOMPLETE FOR
libraries, and restart the DB2 subsystem.
connection-name
Problem Determination: If the problem persists, use
Explanation: At least one DB2 unit of recovery (UR),
any dumps and the console log to diagnose the
related to an identified subsystem ('connection-name'),
problem. If you suspect an error in DB2, refer to Part 2
is still 'indoubt' after restart synchronization has taken
of DB2 Diagnosis Guide and Reference for information
place. ('Indoubt' URs are those for which commit has
on identifying and reporting the problem.
been voted by DB2 but which have not been
acknowledged by 'connection-name'.)
DSN3006I xxxx SSI FUNCTION WAS ALREADY
This message may appear if the 'connection-name'
ACTIVE WHEN ACTIVATE WAS
subsystem has begun to do new work before having
ATTEMPTED
resolved all indoubt URs. The 'connection-name'
subsystem may be in the process of resolving the Explanation: An initialization sequence error has
indoubt URs. occurred. The subsystem support for SSI services
resource manager (SSSS) has discovered during its
System Action: Resources held (locked) by these
initialization that another resource manager ('xxxx') has
'indoubt' URs are unavailable to any other work units
already activated the EOM or FEOT SSI call by calling
until their status is resolved.
DSN3AC0X. If this occurs, the error is a serious one.
System Programmer Response: The system
System Action: Subsystem initialization is
programmer and/or system administrator must
discontinued. DB2 termination occurs.
determine the correct recovery action to resolve the
'indoubt' situations. This involves either 'ensure-commit' System Programmer Response: Ensure that all
or 'backout' decisions for all 'indoubt' URs. maintenance has been applied to the DB2 program
libraries, and then restart the DB2 subsystem.
The -DISPLAY THREAD command should be used to
© Copyright IBM Corp. 1982, 2001 671
DSN3007I • DSN3011I
Problem Determination: If the problem persists, use
DSN3010I csect-name PARTICIPANT OS/390 RRS
any dumps and the console log to diagnose the
IS COLD STARTING AND HAS LOST
problem. If you suspect an error in DB2, refer to Part 2
ITS LOG. OTHER RECOVERABLE
of DB2 Diagnosis Guide and Reference for information
RESOURCE MANAGERS MIGHT HAVE
on identifying and reporting the problem.
INDOUBT UNITS OF RECOVERY.
Explanation: DB2 has coordinator responsibility for
DSN3007I xxxx SSI FUNCTION WAS ALREADY
indoubt units of recovery and OS/390 RRS has a
INACTIVE WHEN DEACTIVATE WAS
participant role in the unit of recovery. OS/390 RRS has
ATTEMPTED
cold started and has lost knowledge of indoubt units of
Explanation: A termination sequence error has recovery. There might be damage at OS/390 RRS
occurred. The subsystem support for SSI services Recoverable Resource Managers that also participated
resource manager (SSSS) has discovered during its in the unit of recovery.
termination that another resource manager ('xxxx') has
System Action: Processing continues.
already deactivated the EOM or FEOT SSI call by
calling DSN3AC0X. If this occurs, the error is a serious System Programmer Response: Contact the
one. database administrator.
System Action: Termination continues. Database Administrator Action: DB2 is the
coordinator for one or more indoubt units of recovery at
System Programmer Response: Ensure that all
other OS/390 RRS recoverable resource managers.
maintenance has been applied to the DB2 program
OS/390 RRS has lost all knowledge of these units of
libraries.
recovery. The participant OS/390 RRS Recoverable
Problem Determination: If the problem persists, use Resource Managers might still have indoubt units of
any dumps and the console log to diagnose the recovery. DB2 has no knowledge of other OS/390 RRS
problem. If you suspect an error in DB2, refer to Part 2 Recoverable Resource Manager except for the OS/390
of DB2 Diagnosis Guide and Reference for information RRS unit of recover ID (URID) that identifies such a unit
on identifying and reporting the problem. of recovery. Subsequent DSN3017I, DSN3018I or
DSN3019I messages describe the status of each unit of
recovery and contain the OS/390 RRS URID for each.
DSN3008I csect-name ABNORMAL DISCONNECT
FOR PROGRAM REQUEST
HANDLER(S) DSN3011I csect-name COORDINATOR OS/390
RRS IS COLD STARTING AND HAS
Explanation: This message indicates that 'csect-name' LOST ITS LOG. INDOUBT DB2
has discovered that one or more resource managers THREADS NEED MANUAL
are still supporting application program calls through RESOLUTION.
their program request handler, even though DB2 was
almost done terminating or was no longer executing. Explanation: DB2 has participant responsibility for
This occurs when the system services address space indoubt threads. OS/390 RRS, the commit coordinator,
has gone to end of memory and neither normal has informed DB2 that it lost all knowledge of DB2
termination nor online error recovery routines have indoubt threads. The indoubt threads at this DB2 must
successfully completed termination of the DB2 be manually resolved with the RECOVER INDOUBT
subsystem. command.
System Action: The program request handler (PRH) System Action: Processing continues.
connection is terminated. All application program
System Programmer Response: Contact the
support requests are rejected with an indication that
database administrator.
DB2 is not up.
Database Administrator Action: DB2 is a participant
System Programmer Response: See the Problem
with one or more indoubt threads. The coordinator is
Determination section of this message.
OS/390 RRS. OS/390 RRS has lost knowledge of the
Problem Determination: An SVC dump is requested. indoubt DB2 threads. A list of indoubt threads where
This SVC dump and associated SYS1.LOGREC entries OS/390 RRS is the coordinator can be displayed using
provide information to determine which resource the DISPLAY THREAD command for indoubt type
managers were still supporting application program threads by specifying RRSAF as the connection name.
support calls. All pertinent control blocks and stack A DSNV408I message with coordinator = RRSAF
storage are dumped. The primary control block of identifies a thread of this type. The DSNV449I message
interest is the program request handler block (PRHB). in the DISPLAY THREAD report that follows contains
the OS/390 RRS unit of recovery ID (URID) that
identifies the OS/390 RRS unit of recovery in the NID
field.
672 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN3012I • DSN3015I
The heuristic decision (that is, to commit or abort the RRS has recorded the DB2 unit of recovery ID as
logical unit of work) should be coordinated with any ’db2_urid’.
other participant OS/390 RRS Recoverable Resource
System Action: Restart with OS/390 RRS continues.
Managers. The existence of other participants might not
be easy to determine. The information might be Operator Response: Notify the database
available in the MVS/RRS recovery log even though administrator.
information has been lost.
Database Administrator Action: This message might
At this DB2, all indoubt threads coordinated by the indicate a DB2 or OS/390 RRS problem, or it might be
OS/390 RRS must be resolved with the RECOVER produced normally because one of the following prior
INDOUBT command. Locked data remains unavailable actions:
until resolution. Threads that were already resolved with v A DB2 conditional restart was performed that resulted
this command are discarded. Threads not yet resolved in the loss of part or all of the DB2 log. This
are discarded after resolution with the command. conditional restart might have happened at any time
The commit or abort decision provided using the in the past.
RECOVER INDOUBT command for a logical unit of v The DB2 RECOVER INDOUBT command was used
work are propagated to all downstream participants, if to resolve the DB2 unit of recovery with URID
any. ’db2_urid’.
DSN3012I csect-name DB2 WAS RESTARTED ON If either of these occurred, the message can be ignored.
THE WRONG SYSTEM AND CANNOT If neither occurred, there might be a DB2 or an OS/390
CONNECT TO RRS. THERE ARE RRS problem. If the ’db2_urid’ appears to be a valid log
UNRESOLVED UNITS OF RECOVERY RBA, use the DSN1LOGP utility with the SUMMARY
WHERE DB2 IS THE COORDINATOR. option and URID options using the ’db2-urid’ value. If
DSN1LOGP finds the ’db2-urid’, the disposition will
Explanation: DB2 is the commit coordinator for one or indicate whether the DB2 UR was committed or aborted
more indoubt units of recovery. DB2 is unable to (rolled back). If possible, use the OS/390 RRS ISPF
connect to OS/390 RRS to resolve these indoubt units interface to commit or abort the OS/390 RRS URID to
of recovery. avoid heuristic damage.
System Action: Processing continues. Problem Determination: If you suspect an error in
DB2, refer to Part 2 of DB2 Diagnosis Guide and
Operator Response: Use the OS/390 RRS IPCS
Reference for information on identifying and reporting
interface to determine the correct system and restart
the problem.
DB2 on that system.
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
DSN3013I csect-name DB2 WAS RESTARTED ON
6, 33. 72.
THE WRONG SYSTEM AND CANNOT
CONNECT TO RRS. THERE ARE
UNRESOLVED UNITS OF RECOVERY DSN3015I csect-name DB2 HAS NO KNOWLEDGE
WHERE DB2 IS A PARTICIPANT. OF RRS URID=rrs_urid. THE RRS UR IS
INDOUBT. THE DB2 URID RECORDED
Explanation: DB2 has one or more indoubt threads
BY RRS=db2_urid.
and is unable to connect to OS/390 RRS to resolve
these indoubt units of recovery. Explanation: DB2 is restarting with OS/390 RRS
where DB2 is the coordinator and OS/390 RRS is the
System Action: Processing continues.
participant. OS/390 RRS has a unit of recovery that
Operator Response: Use the OS/390 RRS IPCS DB2 should be the coordinator of, but DB2 has no
interface to determine the correct system and restart knowledge of the OS/390 RRS unit of recovery. The
DB2 on that system. OS/390 RRS unit of recovery ID is ’rrs_urid’. OS/390
RRS has recorded the DB2 unit of recovery ID as
’db2_urid’.
DSN3014I csect-name DB2 HAS NO KNOWLEDGE
OF RRS URID=rrs_urid. THE RRS UR IS System Action: Restart with OS/390 RRS continues.
INDOUBT. THE DB2 URID RECORDED
Operator Response: Notify the database
BY RRS=db2_urid.
administrator.
Explanation: DB2 is restarting with OS/390 RRS
Database Administrator Action: This message might
where DB2 is a participant and OS/390 RRS is the
indicate a DB2 or OS/390 RRS problem, or it might be
coordinator. OS/390 RRS has a unit of recovery that
produced normally because a DB2 conditional restart
DB2 should be a participant in, but DB2 has no
was performed that resulted in the loss of part or all of
knowledge of the OS/390 RRS unit of recovery. The
the DB2 log. This conditional restart might have
OS/390 RRS unit of recovery ID is ’rrs_urid’. OS/390
Chapter 26. DB2 Messages 673
DSN3016I • DSN3018I
happened at any time in the past. v OS/390 RRS might have had a partial loss of log
data during restart. In this case, message DSN3016I
If the ’db2_urid’ appears to be a valid log RBA, use the
should have been produced.
DSN1LOGP utility with the SUMMARY option and URID
options using the ’db2-urid’ value. If DSN1LOGP finds v The OS/390 RRS ISPF interface might have been
the ’db2-urid’, the disposition will indicate whether the used to heuristically commit or roll back the UR.
DB2 UR was committed or aborted (rolled back). Use
the OS/390 RRS ISPF interface to commit or abort the If any of the above are true, the message can be
OS/390 RRS URID to avoid heuristic damage. ignored. If not, there might be a DB2 or an OS/390 RRS
problem.
Problem Determination: If you suspect an error in
DB2, refer to Part 2 of DB2 Diagnosis Guide and Problem Determination: If you suspect an error in
Reference for information on identifying and reporting DB2, refer to Part 2 of DB2 Diagnosis Guide and
the problem. Reference for information on identifying and reporting
the problem.
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1, Collect the following diagnostic items listed in
6, 33. 72. “Appendix B. Problem determination” on page 1281: 1,
6, 33. 72.
DSN3016I csect-name RRS HAS LOST DATA
FROM ITS LOG. DSN3018I csect-name RRS HAS NO KNOWLEDGE
OF DB2 URID=db2_urid. THE DB2 UR
Explanation: DB2 is restarting with OS/390 RRS and WAS COMMITTED. THE RRS URID
OS/390 RRS has lost some portion of its log. RECORDED BY DB2=rrs_urid.
System Action: Restart with RRS continues. Explanation: DB2 is restarting with OS/390 RRS
Operator Response: Notify the database where DB2 is the coordinator and OS/390 RRS is a
administrator. participant. DB2 has a unit of recovery that OS/390
RRS should be a participant in, but OS/390 RRS has no
Database Administrator Action: DB2 might not be knowledge of the DB2 unit of recovery. The DB2 unit of
able to resolve indoubt Units of Recovery successfully recovery ID is ’db2_urid’. DB2 has recorded the OS/390
with RRS because of the loss of RRS log data. This RRS unit of recovery ID as ’rrs_urid’.
message might be followed by one or more of the
following messages: DSN3017I, DSN3018I, DSN3019I, System Action: Restart with OS/390 RRS continues.
DSN3020I, DSN3021I, DSN3022I and DSN3023I. Operator Response: Notify the database
administrator.
DSN3017I csect-name RRS HAS NO KNOWLEDGE Database Administrator Action: This message might
OF DB2 URID=db2_urid. THE DB2 UR IS indicate a DB2 or OS/390 RRS problem, or it might be
INDOUBT. THE RRS URID RECORDED produced normally because of one of the following:
BY DB2=rrs_urid.
v An OS/390 RRS cold start was performed that
Explanation: DB2 is restarting with OS/390 RRS resulted in the loss of the OS/390 RRS log. In this
where DB2 is the coordinator and OS/390 RRS is a case, message DSN3010I should have been
participant. DB2 has a unit of recovery that OS/390 produced.
RRS should be a participant in, but OS/390 RRS has no v OS/390 RRS might have had a partial loss of log
knowledge of the DB2 unit of recovery. The DB2 unit of data during restart. In this case, message DSN3016I
recovery ID is ’db2_urid’. DB2 has recorded the OS/390 should have been produced.
RRS unit of recovery ID as ’rrs_urid’.
v The OS/390 RRS ISPF interface might have been
System Action: Restart with OS/390 RRS continues. used to heuristically commit or roll back the UR.
Operator Response: Notify the database
If any of the above are true, the message can be
administrator.
ignored. If not, there might be a DB2 or an OS/390 RRS
Database Administrator Action: This message might problem.
indicate a DB2 or OS/390 RRS problem, or it might be
Problem Determination: If you suspect an error in
produced normally because of one of the following:
DB2, refer to Part 2 of DB2 Diagnosis Guide and
v An OS/390 RRS cold start was performed that Reference for information on identifying and reporting
resulted in the loss of the OS/390 RRS log. In this the problem.
case, message DSN3010I should have been
produced. Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
6, 33. 72.
674 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN3019I • DSN3022I
will be no heuristic damage. If the DB2 UR is resolved
DSN3019I csect-name RRS HAS NO KNOWLEDGE
to abort, heuristic damage will have occurred since
OF DB2 URID=db2_urid. THE DB2 UR
OS/390 RRS committed the same UR.
WAS ROLLED BACK. THE RRS URID
RECORDED BY DB2=rrs_urid.
DSN3021I csect-name POSSIBLE HEURISTIC
Explanation: DB2 is restarting with OS/390 RRS
DAMAGE. RRS HAS ROLLED BACK
where DB2 is the coordinator and OS/390 RRS is a
THE UR WITH RRS. URID=rrs_urid. THE
participant. DB2 has a unit of recovery that OS/390
DB2 UR WITH DB2 URID=db2_urid IS
RRS should be a participant in, but OS/390 RRS has no
INDOUBT.
knowledge of the DB2 unit of recovery. The DB2 unit of
recovery ID is ’db2_urid’. DB2 has recorded the OS/390 Explanation: DB2 is restarting with OS/390 RRS and
RRS unit of recovery ID as ’rrs_urid’. has a unit of recovery (UR) DB2 URID=db2_urid that is
indoubt. DB2 is the commit coordinator for the UR and
System Action: Restart with OS/390 RRS continues.
OS/390 RRS is a participant. OS/390 RRS has rolled
Operator Response: Notify the database back the same UR. The OS/390 RRS URID=rrs_urid.
administrator.
System Action: Restart with OS/390 RRS continues.
Database Administrator Action: This message might
Operator Response: Notify the database
indicate a DB2 or OS/390 RRS problem, or it might be
administrator.
produced normally because of one of the following:
v An OS/390 RRS cold start was performed that Database Administrator Action: If possible, insure that
resulted in the loss of the OS/390 RRS log. In this the DB2 UR is resolved to abort. If this is done, there
case, message DSN3010I should have been will be no heuristic damage. If the DB2 UR is resolved
produced. to commit, heuristic damage will have occurred since
OS/390 RRS rolled back the same UR.
v OS/390 RRS might have had a partial loss of log
data during restart. In this case, message DSN3016I
should have been produced. DSN3022I csect-name HEURISTIC DAMAGE HAS
v The OS/390 RRS ISPF interface might have been OCCURRED. RRS HAS COMMITTED
used to heuristically commit or roll back the UR. THE UR WITH RRS URID=rrs_urid, AND
DB2 HAS ROLLED BACK THE SAME
If any of the above are true, the message can be UR. THE DB2 URID=db2_urid
ignored. If not, there might be a DB2 or an OS/390 RRS Explanation: DB2 is restarting with OS/390 RRS and
problem. has a unit of recovery (UR) with DB2 URID=db2_urid
Problem Determination: If you suspect an error in that was rolled back. DB2 is the commit coordinator for
DB2, refer to Part 2 of DB2 Diagnosis Guide and the UR and OS/390 RRS is a participant. OS/390 RRS
Reference for information on identifying and reporting has committed the same UR. The OS/390 RRS
the problem. URID=rrs_urid.
Collect the following diagnostic items listed in System Action: Restart with OS/390 RRS continues.
“Appendix B. Problem determination” on page 1281: 1, Operator Response: Notify the database
6, 33. 72. administrator.
Database Administrator Action: Heuristic damage has
DSN3020I csect-name POSSIBLE HEURISTIC occurred since DB2 rolled back the UR and OS/390
DAMAGE. RRS HAS COMMITTED THE RRS has committed the same UR. Correct the damage.
UR WITH RRS URID=rrs_urid. THE DB2 This is not an easy task. Knowledge of the application is
UR WITH DB2 URID=db2_urid IS required to determine which Recoverable Resource
INDOUBT. Managers are involved in the UR. Since the time of the
Explanation: DB2 is restarting with OS/390 RRS and heuristic action, the data that was updated might have
has a unit of recovery (UR) DB2 URID=db2_urid that is been used by many applications - read and/or write.
indoubt. DB2 is the commit coordinator for the UR and Correcting the damage might involve reversing the
OS/390 RRS is a participant. OS/390 RRS has effects of these applications as well. Tools available are:
committed the same UR. The OS/390 RRS v The OS/390 RRS ISPF functions can provide
URID=rrs_urid. assistance in determining the set of resource
managers involved and what action they took.
System Action: Restart with OS/390 RRS continues.
v The DB2 DSN1LOGP utility provides a summary
Operator Response: Notify the database report that identifies the table spaces modified by the
administrator. unit of recovery.
Database Administrator Action: If possible, insure that
the DB2 UR is resolved to commit. If this is done, there Contact your IBM Support Center for further assistance.
Chapter 26. DB2 Messages 675
DSN3023I • DSN3025I
Managers are involved in the UR. Since the time of the
DSN3023I csect-name HEURISTIC DAMAGE HAS
heuristic action, the data that was updated might have
OCCURRED. RRS HAS ROLLED BACK
been used by many applications - read and/or write.
THE UR WITH RRS URID=rrs_urid, AND
Correcting the damage might involve reversing the
DB2 HAS COMMITTED THE SAME UR.
effects of these applications as well. Tools available are:
THE DB2 URID=db2_urid
v The OS/390 RRS ISPF functions can provide
Explanation: DB2 is restarting with OS/390 RRS and assistance in determining the set of resource
has a unit of recovery (UR) with DB2 URID=db2_urid managers involved and what action they took.
that was committed. DB2 is the commit coordinator for
v The DB2 DSN1LOGP utility provides a summary
the UR and OS/390 RRS is a participant. OS/390 RRS
report that identifies the table spaces modified by the
has rolled back the same UR. The OS/390 RRS
unit of recovery.
URID=rrs_urid.
System Action: Restart with OS/390 RRS continues. Contact your IBM Support Center for further assistance.
Operator Response: Notify the database
administrator. DSN3025I csect-name HEURISTIC DAMAGE HAS
OCCURRED. COORDINATOR DB2 HAS
Database Administrator Action: Heuristic damage has
ROLLED BACK THE UR WITH DB2
occurred since DB2 committed the UR and OS/390
URID=db2_urid, AND RRS HAS
RRS has rolled back the same UR. Correct the
INDICATED THE OUTCOME WAS
damage. This is not an easy task. Knowledge of the
MIXED. THE RRS URID=rrs_urid.
application is required to determine which Recoverable
Resource Managers are involved in the UR. Since the Explanation: DB2 is the commit coordinator and
time of the heuristic action, the data that was updated OS/390 RRS is a participant. DB2 rolled back the UR
might have been used by many applications - read with URID = db2_urid and OS/390 RRS has indicated
and/or write. Correcting the damage might involve that one or more Recoverable Resource Managers that
reversing the effects of these applications as well. Tools participated in the OS/390 RRS UR with URID =
available are: rrs_urid has committed the same UR.
v The OS/390 RRS ISPF functions can provide System Action: Processing continues.
assistance in determining the set of resource
managers involved and what action they took. Operator Response: Notify the database
v The DB2 DSN1LOGP utility provides a summary administrator.
report that identifies the table spaces modified by the Database Administrator Action: Heuristic damage has
unit of recovery. occurred since DB2 rolled back the UR and at least one
OS/390 RRS Recoverable Resource manager has
Contact your IBM Support Center for further assistance. committed the same UR. Correct the damage. This is
not an easy task. Knowledge of the application is
required to determine which Recoverable Resource
DSN3024I csect_name HEURISTIC DAMAGE HAS
Managers are involved in the UR. Since the time of the
OCCURRED. COORDINATOR DB2 HAS
heuristic action, the data that was updated might have
COMMITTED THE UR WITH DB2
been used by many applications - read and/or write.
URID=db2_urid, AND RRS HAS
Correcting the damage might involve reversing the
INDICATED THAT THE OUTCOME WAS
effects of these applications as well. Tools available are:
MIXED. THE RRS URID=rrs_urid.
v The OS/390 RRS ISPF functions can provide
Explanation: DB2 is the commit coordinator and assistance in determining the set of resource
OS/390 RRS is a participant. DB2 committed the UR managers involved and what action they took.
with URID = db2_urid and OS/390 RRS has indicated
v The DB2 DSN1LOGP utility provides a summary
that one or more Recoverable Resource Managers that
report that identifies the table spaces modified by the
participated in the OS/390 RRS UR with URID =
unit of recovery.
rrs_urid has rolled back the same UR.
System Action: Processing continues. Contact your IBM Support Center for further assistance.
Operator Response: Notify the database
administrator.
Database Administrator Action: Heuristic damage has
occurred since DB2 committed the UR and at least one
OS/390 RRS Recoverable Resource manager has
rolled back the same UR. Correct the damage. This is
not an easy task. Knowledge of the application is
required to determine which Recoverable Resource
676 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN3026I • DSN3102I
CSECT DSN3EC0Xafter termination of the previous
DSN3026I csect-name POSSIBLE HEURISTIC
execution of DB2 is complete. Message DSN3104I is
DAMAGE. COORDINATOR DB2 HAS
also issued during this processing.
COMMITTED THE UR WITH DB2
URID=db2_urid, AND RRS HAS Operator Response: Issue the -START command
INDICATED THAT THE OUTCOME IS when DB2 execution is desired.
PENDING. THE RRS URID=rrs_urid.
Explanation: DB2 is the commit coordinator for the DSN3101I csect-name INVALID EARLY
DB2 UR with URID=db2_urid and OS/390 RRS is a PROCESSING MODULE NAME IN
participant. OS/390 RRS has also committed the UR but PARMLIB RECORD. ssnm IS NOT
has indicated that at least one OS/390 RRS AVAILABLE
Recoverable Resource manager has not completed
commit processing for the OS/390 RRS UR with Explanation: CSECT DSN3UR00 has discovered that
URID=rrs_urid. a parameter passed to DB2 subsystem initialization is in
error. Either the Early processing load module name is
System Action: Processing continues. not between 1 and 8 characters long, or there are
syntax errors in the parameter string. The entire
Operator Response: Notify the database
parameter string must be between 3 and 10 characters
administrator.
long, and the next to the last character must be a ','.
Database Administrator Action: If possible, insure that The parameters were obtained from the parameter
the OS/390 RRS Recoverable Resource Manager fields of a record defining a DB2 subsystem in member
commits the OS/390 RRS UR. If this is done, there will IEFSSNxx of SYS1.PARMLIB.
be no heuristic damage. If the OS/390 RRS UR is rolled
The subsystem recognition character is not inserted in
back by the OS/390 RRS Recoverable Resource
this message as it is not yet known. 'ssnm' is the name
manager, heuristic damage will have occurred since
of the DB2 subsystem undergoing IPL-time initialization.
DB2 committed the same UR.
System Action: The DB2 subsystem with the
indicated name is not available for this IPL of MVS.
DSN3027I csect-name POSSIBLE HEURISTIC
DAMAGE. COORDINATOR DB2 HAS Operator Response: Notify the system programmer.
ROLLED BACK THE UR WITH DB2
URID=db2_urid, AND RRS HAS System Programmer Response: Correct the
INDICATED THAT THE OUTCOME IS parameter fields in the record of SYS1.PARMLIB
PENDING. THE RRS URID=rrs_urid. member IEFSSNxx, and re-IPL MVS. Refer to Part 2 of
DB2 Installation Guide for the format of an IEFSSNxx
Explanation: DB2 is the commit coordinator for the record which defines a DB2 subsystem.
DB2 UR with URID=db2_urid and OS/390 RRS is a
participant. OS/390 RRS has also rolled back the UR
but has indicated that at least one OS/390 RRS DSN3102I csect-name INVALID SUBSYSTEM
Recoverable Resource manager has not completed roll RECOGNITION CHARACTER IN
back processing for the OS/390 RRS UR with PARMLIB RECORD. ssnm IS NOT
URID=rrs_urid AVAILABLE
System Action: Processing continues. Explanation: CSECT DSN3UR00 detected that the
subsystem recognition character is invalid; it must be
Operator Response: Notify the database nonblank. The subsystem recognition character is the
administrator. last field of the parameter string passed to DB2 IPL
initialization. It is obtained from a record for the named
Database Administrator Action: If possible, insure that
subsystem in member IEFSSNxx of SYS1.PARMLIB.
the OS/390 RRS Recoverable Resource Manager rolls
back the OS/390 RRS UR. If this is done, there will be The subsystem recognition character is not inserted in
no heuristic damage. If the OS/390 RRS UR is this message as it cannot be determined. 'ssnm' is the
committed by the OS/390 RRS Recoverable Resource name of the DB2 subsystem undergoing IPL-time
manager, heuristic damage will have occurred since initialization.
DB2 rolled back the same UR.
System Action: The DB2 subsystem with the
indicated name is not available for this IPL of MVS.
DSN3100I csect-name SUBSYSTEM ssnm READY
FOR START COMMAND Operator Response: Notify the system programmer.
Correct the parameter fields in the SYS1.PARMLIB
Explanation: This message is issued by CSECT record of member IEFSSNxx, and re-IPL MVS. Refer to
DSN3RRSR when DB2 subsystem initialization is Part 2 of DB2 Installation Guide for the format of an
complete. The 'ssnm' in the message is the name of the IEFSSNxx record which defines a DB2 subsystem.
subsystem that issued the message. This occurs during
MVS IPL processing. The message is also issued by
Chapter 26. DB2 Messages 677
DSN3103I • DSN3108I
module in a link-listed library. Re-IPL MVS.
DSN3103I csect-name - UNABLE TO LOAD EARLY
PROCESSING MODULE SPECIFIED IN If you suspect an error in DB2, refer to Part 2 of DB2
PARMLIB RECORD. ssnm IS NOT Diagnosis Guide and Reference for information on
AVAILABLE identifying and reporting the problem.
Explanation: CSECT DSN3UR00 is unable to load the Problem Determination: An entry is made in
early processing load module named in the first SYS1.LOGREC. No SVC dump is taken. Refer to MVS
parameter passed to DB2 subsystem IPL initialization. linklist requirements in MVS/ESA JES2 Initialization and
'ssnm' is the name of the DB2 subsystem undergoing Tuning Guide.
IPL-time initialization.
Collect the following diagnostic items listed in
Either the load module name was specified incorrectly “Appendix B. Problem determination” on page 1281: 1,
or the load module does not reside in a library included 5.
in the MVS linklist.
System Action: DSN3UR00 abends with code X'04E' DSN3106I csect-name SUBSYSTEM STOPPED.
and reason code X'00F30103'. The DB2 subsystem with THIS COMMAND NOT PROCESSED:
the indicated name is not available for this IPL of MVS. command-text
Operator Response: Notify the system programmer. Explanation: A command has been received which
cannot be processed due to one of the following:
System Programmer Response: Identify the cause of
the error. Either correct the early processing load v The DB2 subsystem has not been started.
module or take the necessary steps to include the v The command was queued for processing while DB2
module in a link-listed library. Re-IPL MVS. Refer to Part was starting, but startup terminated with an error.
2 of DB2 Installation Guide for the format of an v DB2 terminated before the command could be
IEFSSNxx record that defines a DB2 subsystem. Refer processed.
to the appropriate MVS publication for MVS linklist
requirements. System Action: The command is not processed.
Problem Determination: An entry is made to Operator Response: Start the DB2 subsystem, then
SYS1.LOGREC. No SVC dump is taken. reenter the command.
DSN3104I csect-name - TERMINATION COMPLETE DSN3107I csect-name COMMAND REJECTED.
REQUESTER NOT AUTHORIZED
Explanation: This message indicates that a DB2
subsystem has terminated. The actual MVS termination Explanation: CSECT DSN3EC0X has discovered that
of the DB2 address space(s) may have completed the source of the command was a console that does not
earlier. This message is presented for every termination, have 'system' authority.
normal or abnormal.
System Action: The command is not processed. This
Operator Response: Issue a DISPLAY ACTIVE message is sent to the console that entered the
command to see if MVS has completed termination command.
processing of the address space(s).
Operator Response: Enter the command from
another console that has 'system' authority.
DSN3105I csect-name - UNABLE TO LOAD EARLY
System Programmer Response: Verify that this
PROCESSING MODULE 'DSN3EPX'
console should be used for entering DB2 commands. If
ssnm IS NOT AVAILABLE
so, authorize it for 'system' commands by using MVS
Explanation: CSECT DSN3UR00 is unable to load the services.
early processing module DSN3EPX required for MVS.
The name of the DB2 subsystem undergoing IPL-time
DSN3108I csect-name COMMAND REJECTED.
initialization is 'ssnm'. Either the load module has been
COMMAND FACILITY PATH
inadvertently deleted, or does not reside in a library
UNAVAILABLE
included in the MVS linklist.
Explanation: CSECT DSN3EC0X has discovered that
System Action: DSN3UR00 abends with code X'04E'
the path from MVS consoles to the DB2 command
and reason code X'00F30105'. DB2 subsystem 'ssnm' is
processor is unavailable. It may still be possible to enter
not available for this IPL of MVS.
commands through one of the attachment facilities.
Operator Response: Notify the system programmer.
System Action: The command is not processed. This
System Programmer Response: Identify the cause of message is delivered to the console that entered the
the error. Either correct the early processing load command.
module or take the necessary steps to include the
System Programmer Response: The console
678 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN3109I • DSN3113I
command facility is available again the next time DB2 is System Programmer Response: Verify that all of the
started. If it is necessary to regain this facility following were done:
immediately, DB2 should be canceled and restarted. v The installation and maintenance activities against
DB2 were executed using SMP.
DSN3109I csect-name - UNABLE TO OBTAIN v The JCLIN for SMP included the correct AMODE and
SUBSYSTEM AFFINITY TABLE INDEX RMODE control statements.
FOR SUBSYSTEM ssnm. IEFSSREQ RC v The appropriate Linkage Editor provided with the
= nn Data Facility Product (DFP) for the version of MVS
Explanation: CSECT DSN3UR00 was unable to being used was invoked by SMP for the link-edit
obtain a subsystem affinity table index for the named steps.
subsystem. MVS did not recognize the named
subsystem name as a known subsystem. If this Correct and rerun the procedure or JCL which caused
message is issued, a serious error has occurred in MVS the error. If necessary, REJECT all SMP APPLY steps
or DB2. which were executed incorrectly and rerun the rejected
steps. Request a re-IPL of MVS.
In the message, 'nn' is the return code from the
IEFSSREQ MVS service. 'ssnm' is the name of the DB2 Problem Determination: A record is written to
subsystem undergoing IPL-time initialization. SYS1.LOGREC. No SVC dump is taken.
System Action: DSN3UR00 abends with completion The MVS service aid AMBLIST provides Linkage Editor
code X'04E' and reason code X'00F30104'. The DB2 module attributes in the summary section of the
subsystem with the indicated name is not available for LISTLOAD function output.
this IPL of MVS.
Operator Response: Notify the system programmer. DSN3112I csect-name UNABLE TO REGISTER
COMMAND PREFIX, CPF RETURN
System Programmer Response: Try to re-IPL. If the CODE = xxyy. ssnm IS NOT AVAILABLE
problem persists, follow standard DB2 problem reporting
procedures. Explanation: DB2 is unable to register the
installation-specified command prefix with MVS. The
Problem Determination: A record is written to command prefix is specified in the subsystem definition
SYS1.LOGREC. No SVC dump is taken. Return codes parameter. xx is the hexadecimal return code, and yy is
from IEFSSREQ are documented under control block the hexadecimal reason code from the CPF MVS
SSOB in the appropriate MVS publication. service. Subsystem ssnm is not available.
System Action: This DB2 subsystem is not available.
DSN3111I csect-name LOAD MODULE
module-name DOES NOT HAVE System Programmer Response: Refer to the MVS
AMODE(31) ATTRIBUTE. ssnm IS NOT documentation on the CPF macro service to determine
AVAILABLE the reason for the xx and yy codes. Ensure that the
specified command prefix is not already registered, or is
Explanation: The DB2 program which establishes not a substring or superstring of an already registered
DB2 as an MVS subsystem during Master Scheduler command prefix. Use the MVS DISPLAY OPDATA
initialization has determined that either its own load command, if necessary, to see command prefixes
module or a load module loaded by it does not have the registered with MVS.
linkage editor attributes AMODE(31) and RMODE(ANY).
Most DB2 load modules must be capable of running in
the 31-bit addressing mode. DSN3113I csect-name INVALID SUBSYSTEM
DEFINITION PARAMETER IN PARMLIB
In the message, 'csect-name' is the name of the RECORD. ssnm IS NOT AVAILABLE.
program detecting the error, 'module-name' is the name
of the first load module found with an invalid AMODE Explanation: DB2 detected an error in the subsystem
attribute, and 'ssnm' is the name of the DB2 subsystem definition parameter, which is obtained from the
undergoing IPL-time initialization. IEFSSNxx member of SYS1.PARMLIB. Some possible
causes for this error are:
System Action: Program DSN3UR00 abends with a
v The early processing load module name is not
code of X'04E' and a reason code of X'00F30111'. The
between 1 and 8 characters long.
DB2 subsystem named 'ssnm' is not initialized. The
subsystem will not be available until the error is v The command prefix is not between 1 and 8
corrected and MVS is re-IPLed. characters long.
v The command prefix scope is not 1 character long.
Operator Response: Notify the system programmer of
the failure. v The command prefix scope is not X, S, or M.
Chapter 26. DB2 Messages 679
DSN3114I • DSN3201I
v The group attach name is not between 1 and 4
DSN3201I ABNORMAL EOT IN PROGRESS FOR
characters long.
USER=xxxxxxxx CONNECTION-
The command prefix is not inserted into this message ID=yyyyyyyy CORRELATION-
because it is unknown. The name of the subsystem ID=zzzzzzzzzzzz JOBNAME=aaaaaaaa
attempting to initialize is ssnm. TCB=99999999
System Action: The DB2 subsystem is not available. Explanation: Abnormal termination started for the
agent with the values shown for USER,
System Programmer Response: Correct the CONNECTION-ID, CORRELATION-ID, JOBNAME and
subsystem definition parameter and re-IPL MVS. Refer TCB address. These values are the last known set of
to DB2 Installation Guide for the format of the identifiers for the terminating agent.
subsystem definition parameter that defines a DB2
subsystem. The abnormal termination could be the result of a failure
in the allied agent’s address space or the result of an
operator cancel command.
DSN3114I csect-name GROUP ATTACH NAME IS
NOT ALLOWED WITH THIS RELEASE The value for the USER and/or CORRELATION-ID
OF MVS. ssnm IS NOT AVAILABLE might be blank. If the terminating agent is connected to
DB2 at the IDENTIFY level and was not previously
Explanation: DB2 found an installation-specified group signed on, or was not previously authorized to a plan at
attachment name specified in the subsystem definition the time of the failure, then no CORRELATION-ID is
parameter, IEFSSNxx, but DB2 group attachment is not associated with the agent. Otherwise, the values for the
supported with this release of MVS. DB2’s group USER, CONNECTION-ID, CORRELATION-ID, and
attachment feature requires MVS/ESA SP4.2.2 or a later JOBNAME are the last values established to DB2 for
release. The DB2 subsystem ssnm is not available. this connection. They might represent the current
System Programmer Response: Delete the group activity of the agent. The TCB value is the address of
attachment name in the subsystem definition parameter the TCB that is terminating. Previous DB2 work by this
and re-IPL. agent might have completed successfully. Correlation
IDs beginning with '0nn', where nn is a number from 01
to 28, identify system agents.
DSN3115I csect-name UNABLE TO REGISTER
GROUP ATTACH NAME, NAME/TOKEN System Action: The agent was previously queued to
RC = xx. ssnm IS NOT AVAILABLE a System Services service task for termination
processing. This message indicates that the agent was
Explanation: DB2 is unable to register the taken from the queue for processing. Any uncommitted
installation-specified group attach name with MVS. The database changes are rolled back.
group attach name is specified in the subsystem
definition parameter. xx is the hexadecimal return code User Response: Your job or TSO session cannot be
from the MVS Name/Token service. Subsystem ssnm is canceled. The PA1 key has no effect in this
not available. circumstance. To avoid long waits when your application
program is canceled or terminates abnormally, issue
System Action: This DB2 subsystem is not available. frequent commits.
System Programmer Response: Refer to MVS System Programmer Response: See the Problem
documentation about the Name/Token macro service to Determination section for this message. The MVS
determine the reason for the xx return codes. CANCEL and FORCE commands have no effect and
should not be issued. DB2 should not be canceled. If an
DSN3116I csect-name THE VERSION OF THE DB2 extensive rollback is in progress, the subsequent DB2
EARLY CODE IS INCOMPATIBLE WITH restart might take a very long time because of additional
THIS VERSION OF MVS. ssnm IS NOT log activity.
AVAILABLE Problem Determination: You can detect a deferred
Explanation: This version of DB2 early code requires termination condition for a task by examining several
MVS/ESA 4.2.0. Subsystem ssnm is not available. indicators. Some or all of the following might be present:
v The allied address space might be swapped out and
System Programmer Response: The version of the appear to be in a never-ending WAIT condition.
DB2 early code that was loaded from the LINKLIST v The MVS commands CANCEL and FORCE appear
library is not compatible with the release of MVS that to have no effect.
you are using. Change the concatenation order of the v The allied task holds an MVS-shared ENQ on
LINKLIST library so that a compatible release of DB2 resource SYSZDSN3.ERLYOLRHerly-block-address.
early code is used. v During abnormal termination of the agent associated
with the failing task, but before this message was
written, the task's connection appears on the
680 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN3458I • DSN3581I
-DISPLAY THREAD output with a QD status. See
| DSN3581I csect-name SAF service FAILED WITH
message DSNV404I for the definition of this status
| SAF RETURN CODE = saf-retc, RACF
code.
| RETURN CODE = racf-retc, AND RACF
v This message, DSN3201I, is written to the MVS
| REASON CODE = racf-reac. DB2
console after the agent is removed from the service
| REASON CODE = db2-reac
task work queue when termination processing begins.
v During abnormal termination of the agent associated | Explanation: DB2 invoked the specified SAF (Security
with the failing task, the task's connection appears on | Authorization Facility) service which failed with the
the -DISPLAY THREAD output with a D status. See | following codes:
message DSNV404I for the definition of this status
code.
| Variable
| Definition
DSN3458I csect-name MODULE modname MUST
| csect The CSECT name of the DB2 module that
HAVE THE AMODE (31) ATTRIBUTE
| issued the message.
Explanation: An authorization exit load module was
| service
not link-edited with the 31-bit addressing mode
| The name of the service that failed.
(AMODE) attribute. Either load module DSN3@ATH or | saf-retc
DSN3@SGN is specified by 'modname'. | The SAF return code.
System Action: Subsystem startup is terminated. | racf-retc
System Programmer Response: Relink-edit the
| The RACF return code.
authorization exit module specifying the attributes | db2-retc
AMODE(31), RMODE(ANY). | The DB2-assigned reason code for the failure.
Problem Determination: Check the load module | DB2 associates the failure with a DB2 reason
attributes used for the link-edit. | code which may appear in other messages
| associated with this failure.
DSN3580I CONNECTION FOR [EOM | FEOT | | System Action: The call fails. Other messages
IDEN] GAVE RC=X xxxxxxxx, | associated with this feature may follow.
REASON=X xxxxxxxx
| User Response: Notify the system programmer.
Explanation: A nonzero return code has been
returned to DSN3AMI2 from the SSSS connect to | Operator Response: Notify the system programmer.
subsystem interface call. The variables in the message | System Programmer Response: The action to take
indicate which SSI call is involved and the actual return | depends on the service being used.
and reason codes associated with it.
| v R_ticketserv
System Action: The current task (TCB) is abended | DB2 requests this service to parse a Kerberos ticket
with a system completion code of X'04E' and with an | received from a remote client. Refer to OS/390
abend reason code of '00F30580' The DB2 subsystem | Security Server (RACF) Callable services for an
terminates. | exlanation of the error.
Operator Response: Notify the system programmer. | DB2 uses the SAF R_ticketserv service to parse a
| Kerberos ticket that was received from a remote
System Programmer Response: Restart the DB2 | client. Refer to OS/390 SecureWay Security Server
subsystem. | RACF Callable Services for an explanation of the
Problem Determination: The trace table and stack | error. A SAF and RACF return code of 8 and 16
storage associated with the EB in register 6 must be | indicate a failure from the Network Authentication
examined to locate the error. | Privacy Service (Kerberos) when parsing the ticket in
| which case the RACF reason code contains a status
Collect the following diagnostic items listed in | code from the Network Authentication Privacy
“Appendix B. Problem determination” on page 1281: 2, | Service. These status codes are documented in the
5. | OS/390 SecureWaySecurity Server Network
| Authentication and Privacy Service Administration
| manual. Additional information for some of the more
| common status codes and how they relate to DB2
| follows:
| 96C73A07
| One possibility is that you must associate
| the ssnmDIST started task user ID with a
Chapter 26. DB2 Messages 681
DSN3581I
| principal name and the client system must
| use this principal name in the Kerberos
| target principal.
| Note: DB2 Connect client systems must
| catalog a DB2 for OS/390 database
| with ″AUTHENTICATION
| KERBEROS TARGET PRINCIPAL
| principal_name″. Assume that
| SYSDSP is the user ID associated
| with the ssnmDIST started task. A
| principal, say SYSDSPp, must be
| associated to the SYSDSP user ID by
| a RACF ALTUSER command.
| Further, the SYSDSPp principal name
| must appear in the target principal
| name of the DB2 Connect database
| configuration for the DB2 for OS/390
| database.
| v R_ticketserv(principal name)
| DB2 uses the SAF R_usermap service to determine
| the user ID associated with a Kerberos ticket
| received from a remote client. Refer to OS/390
| SecureWay Security Server RACF Callable Services
| for an explanation of the error. The principal name
| obtained from the ticket is included in parenthesis to
| assist the user in determining the cause of the
| problem. Either the client system is using an invalid
| principal name, or a principal name to user ID
| association has not been defined to RACF.
| Principals authenticated on the local OS/390 realm
| must have a mapping that associates the local
| principal name to a local RACF user ID. This
| association can be made by using the RACF
| ADDUSER or ALTUSER commands with the
| KERBNAME parameter.
| Principals authenticated on a foreign realm must
| have a mapping that associates the foreign fully
| qualified principal name to a local RACF user ID.
| This association can be made by using the RACF
| RDEFINE or RALTER commands with the KERBLINK
| parameter.
| v R_usermap
| DB2 requests this service to determine the user ID
| associated with a Kerberos ticket received from a
| remote client. Refer to OS/390 Security Server
| (RACF) Callable services for an explanation of the
| error.
682 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 27. DSN7... Messages
DSN7000I csect-name REQUIRED CSECT DSN7102I -----------------------------
DSN6GRP COULD NOT BE FOUND IN
Explanation: This message is a line of output from a
SYSTEM PARAMETERS LOAD
DISPLAY GROUP command.
MODULE.
Explanation: The required CSECT DSN6GRP was not
DSN7103I DB2 DB2 SYSTEM IRLM
found in the system parameters load module.
Explanation: This message is a line of output from a
System Action: The DB2 subsystem terminates with
DISPLAY GROUP command.
reason code 00F70001.
Operator Response: Restart DB2 with the correct
DSN7104I MEMBER ID SUBSYS CMDPREF
system parameters load module.
STATUS LVL NAME SUBSYS
System Programmer Response: Reassemble the IRLMPROC
system parameters load module and include the
Explanation: This message is a line of output from a
DSN6GRP macro.
DISPLAY GROUP command.
MEMBER
DSN7001I csect-name DATA SHARING SPECIFIED
Name of the DB2 data sharing member.
IN SYSTEM PARAMETERS, BUT NOT
RUNNING ON A MVS SYSTEM LEVEL ID Internally assigned ID for each data sharing
WHICH IS REQUIRED FOR DATA member.
SHARING.
SUBSYS
Explanation: A DB2 subsystem was started with the Subsystem name of the data sharing member.
data sharing option, but MVS is not at the required
level. DB2 data sharing requires MVS Version 5 CMDPREF
Release 1.0 or a later release. Command prefix of the data sharing member.
System Action: The DB2 subsystem terminates with STATUS
reason code 00F70002. State of the data sharing member which can
be 'ACTIVE', 'FAILED', 'QUIESCED', 'QI', 'QR',
Operator Response: Restart DB2 on MVS Version 5 'QC', 'QIC', 'QIR', or 'QICR' where:
Release 1.0 or a later release. v Active status means the member is currently
up and running.
v Failed status means the member has
DSN7100I csect-name
terminated abnormally.
Explanation: This message indicates the beginning of v Quiesced status means the member is down
the output from a DISPLAY GROUP command. It is the normally.
first line of a multi-line message response. v QI status means the member is down with
indoubt URs.
v QR status means the member is down with
DSN7101I *** BEGIN DISPLAY OF
resynchronization responsibility.
GROUP(group-name) GROUP
v QC status means the member is down with
LEVEL(group-level)
group buffer pool castout responsibility.
Explanation: This message is a line of output from a v QICR is a possible combination of the above
DISPLAY GROUP command. quiesced states.
group-name is the name of the data sharing group. SYSTEM NAME
Name of the MVS system on which the data
group-level is a string of three numeric characters: sharing member runs.
v Version
v Release LVL String of three numeric characters as follows:
v Modification level v DB2 Version
v DB2 Release
group-level is the highest release with which any DB2 in v DB2 Modification level
the data sharing group has ever been started. IRLM SUBSYS
The accompanied IRLM’s subsystem name for
this DB2.
© Copyright IBM Corp. 1982, 2001 683
DSN7105I • DSN7109I
IRLMPROC
DSN7107I GROUP ATTACH NAME(group-attach)
The accompanied IRLM’s startup procedure
name. Explanation: This message is a line of output from a
DISPLAY GROUP command.
DSN7105I -------- --- ---- -------- -------- --- -------- ---- group-attach is the group attach name for the data
-------- sharing group.
Explanation: This message is a line of output from a
DISPLAY GROUP command. DSN7108I NUMBER LOCK ENTRIES: nnnnnnnnnnn
Explanation: This line of output from a DISPLAY
DSN7106I member-name subsystem-name GROUP command shows information about the LOCK1
command-prefix member-status coupling facility structure. The maximum number of lock
mvs-system-name irlm-subsystem-name table entries is displayed.
irlm-procedure-name
Explanation: This message is a line of output from a DSN7109I SCA STRUCTURE SIZE: nnnnnnn KB,
DISPLAY GROUP command. The member-status can STATUS = xx, SCA IN USE: < nnn %
be ACTIVE, QUIESCED, or FAILED.
Explanation: This message is a line of output from a
QUIESCED DISPLAY GROUP command.
This is a normal quiesced state, as the result
If the % value is > 0 but < 1, then a ″<″ character is
of a normal STOP DB2 command.
shown before the 1 % value, e.g. ″< 1 %″. This can
Q The member is quiesced, but with additional happen if the shared communications area (SCA)
conditions. Q (quiesced) can be paired with structure is very large or if only a small number of SCA
one or more of the following letters: entries are in use.
I Indoubt units of recovery (URs) are The SCA status can have following values:
outstanding. This means retained
IN SCA is in initialization phase.
locks are held.
AC SCA is active.
C There was a castout error. The last
updated of the page set or partition DS SCA loss of connectivity, delayed action
could not write from the coupling started.
facility to DASD.
DC SCA loss of connectivity, delayed action
Make sure there is connectivity from completed.
the coupling facility to DASD before
restarting DB2. QS SCA rebuild quiesce function started.
R There is retained information needed QC SCA rebuild quiesce function completed.
for DB2 to perform resynchronization CS SCA rebuild connect function started.
with one or more remote locations.
CC SCA rebuild connect function completed.
When DB2 is restarted, this
resynchronization occurs. OS SCA rebuild connect complete function started.
ACTIVE RS SCA rebuild resource manager invocation
This is a normal active state without conditions started.
A The member is active, but with the addtional RC SCA rebuild resource manager invocation
conditions. A (active) can be paired with the completed.
following letter: OC SCA rebuild connect complete function
I Indoubt or postponed abort units of completed.
recovery (URs) are outstanding. This LS SCA rebuild cleanup function started.
means retained locks are held.
US SCA rebuild resource manager invocation
The subsystem-name, command-prefix, started.
irlm-subsystem-name, and irlm-procedure-name show UC SCA rebuild resource manager invocation
'****' if this information is unknown. completed.
LC SCA rebuild cleanup function completed.
PS SCA rebuild process complete function started.
684 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN7110I • DSN7403I
PC SCA rebuild process complete function nnnnnnnn could be IXCQUERY or IXLMG.
completed.
System Action: The DB2 subsystem displays the
SS SCA rebuild stop function started. group, but some XCF or coupling facility structure
information is missing. Refer to MVS/ESA Programming:
SC SCA rebuild stop function completed.
Sysplex Services Reference for an explanation of
ES SCA rebuild stop complete function started. IXCQUERY or IXLMG return and reason codes.
EC SCA rebuild stop complete function completed.
DSN7120I DB2 PARALLEL PARALLEL
VS SCA volatility change function started.
Explanation: This message is a line of output from a
VC SCA volatility change function completed. DISPLAY GROUP command with the DETAIL option.
TE SCA is in termination phase.
DSN7121I MEMBER COORDINATOR ASSISTANT
DSN7110I LOCK1 STRUCTURE SIZE: nnnnnnn Explanation: This message is a line of output from a
KB, LOCK1 IN USE: < nnn % DISPLAY GROUP command with the DETAIL option.
Explanation: This line of output from a DISPLAY
GROUP command shows the size and the % in use DSN7122I -------- ----------- ---------
value of the LOCK1 coupling facility structure.
Explanation: This message is a line of output from a
If the % value is > 0 but < 1, then a ″<″ character is DISPLAY GROUP command with the DETAIL option.
shown before the 1 % value, e.g. ″< 1 %″. This can
happen if the LOCK1 structure is vary large or only a
small number of LOCK1 entries are in use. The % value DSN7123I member-name parallel-coordinator
shown is based on the largest value of either ″lock parallel-assistant
entries in use″ or ″list entries in use″.
Explanation: This message is a line of output from a
DISPLAY GROUP command with the DETAIL option.
DSN7111I NUMBER LIST ENTRIES: nnnnnnnnnnn, This message is only issued for ACTIVE DB2 members
LIST ENTRIES IN USE: < nnnnnnnnnnn that support Sysplex query parallelism.
Explanation: This line of output from a DISPLAY
GROUP command shows information about the LOCK1 DSN7401I csect-name INCONSISTENT DATA
coupling facility structure. The maximum number of SHARING PARAMETER DETECTED,
modify lock list entries and the number of those entries parameter-name IN DB2 SYSTEM
currently in use are displayed. (MVS documentation PARAMETERS (sysparm-parm) IS NOT
refers to these list entries as “record data”.) EQUAL TO PARAMETER IN THE DB2
START-UP PROCEDURE (start-parm).
DSN7112I *** END DISPLAY OF Explanation: At least one data sharing parameter in
GROUP(group-name) the member’s system parameters is not equal to the
data sharing parameter value passed on the DB2
Explanation: This message is the last line of output start-up procedure.
from a DISPLAY GROUP command.
System Action: The DB2 subsystem terminates with
reason code 00F70003.
DSN7113I DISPLAY TERMINATED DUE TO
INSUFFICIENT MESSAGE SPACE. Operator Response: Restart DB2 with the correct
system parameters load module or inform the system
Explanation: There is not enough storage available to programmer to change the DB2 start-up procedure.
store the required information from this command.
System Programmer Response: Reassemble the
System Action: The DB2 subsystem displays the system parameters load module. Make sure that the
group information, but some information is missing. group name and the member name match the values in
the DB2 start-up procedure, or correct the parameters
DSN7114I XCF OR STRUCTURE INFORMATION on the DB2 start-up procedure.
NOT AVAILABLE. MVS nnnnnnnn
RETURN CODE=xxxxxxxx, MVS DSN7403I csect-name MEMBER(member-name) IS
nnnnnnnn REASON CODE=yyyyyyyy. ALREADY ACTIVE ON
Explanation: An error occurred during the query of the SYSTEM(mvs-system-name).
cross-system coupling facility (XCF) or CF structure Explanation: The started DB2 subsystem is already
information. active on another MVS system.
Chapter 27. DB2 Messages 685
DSN7404I • DSN7409I
System Action: The DB2 subsystem terminates with XCF,GROUP command to ensure that XCF is
reason code 00F70003. functional. Then try to restart the DB2 subsystem again.
Operator Response: If you want the DB2 subsystem System Programmer Response: Refer to MVS/ESA
to run on this MVS system, stop the DB2 subsystem on Programming: Sysplex Services Reference for an
the other MVS. After the DB2 subsystem stops, restart explanation of the IXCQUERY return and reason codes.
the DB2 on this MVS.
DSN7407I csect-name AUTOMATIC RESTART
DSN7404I csect-name INVALID MANAGER function FAILED. MVS
MEMBER(member-name) WAS FOUND IXCARM RETURN CODE = xxxxxxxx,
IN DB2 XCF GROUP(db2-group-name). MVS IXCARM REASON CODE =
MEMBER HAS BEEN DELETED. yyyyyyyy.
Explanation: The invalid member was found in a DB2 Explanation: DB2 encountered an error using the
data sharing group, which is a particular type of specified MVS automatic restart manager (ARM)
cross-system coupling facility (XCF) group. The invalid function.
name member-name was found in data sharing group
System Action: DB2 continues. However, if DB2
db2-group-name and was deleted. member-name might
abnormally terminates, the MVS ARM cannot
represent an unauthorized program, other than DB2 for
automatically restart DB2.
MVS/ESA, that attempted to join the data sharing
group. System Programmer Response: Refer to MVS/ESA
Programming: Sysplex Services Reference for the
System Action: The DB2 subsystem continues.
function, return code, and reason code from the
Operator Response: Report the occurrence of this IXCARM request.
message to your system programmer.
System Programmer Response: Investigate which DSN7408I csect-name ARM EVENT EXIT FAILED.
unauthorized program joined the DB2 group and find its DB2 SUBSYSTEM ssnm NOT
owner. This could indicate a security violation. RESTARTED. MVS IEFSSI RETURN
CODE = xxxxxxxx, MVS IEFSSI
REASON CODE = yyyyyyyy.
DSN7405I csect-name MEMBER(member-name)
UNABLE TO JOIN DATA SHARING Explanation: The DB2 ARM event exit encountered
GROUP(group-name), MVS IXCJOIN an error while attempting to define the DB2 subsystem
RETURN CODE=xxxxxxxx, MVS to MVS.
IXCJOIN REASON CODE=yyyyyyyy.
System Action: The automatic restart of the DB2
Explanation: An unexpected error occurred when the subsystem is stopped.
data sharing DB2 member attempted to join the MVS
System Programmer Response: Refer to MVS/ESA
cross-system coupling facility (XCF) data sharing group.
Programming: Assembler Services Reference for return
System Action: The DB2 subsystem terminates with and reason codes from the IEFSSI request. If the
reason code 00F70408. IEFSSI return code and reason code are 0, look in the
console log for previous messages that indicate why the
Operator Response: Issue an MVS ’DISPLAY
definition of the DB2 subsystem failed. You can
XCF,GROUP’ command to ensure that XCF is
manually start DB2 by using the -START DB2 command
functional; then try to restart the DB2 subsystem.
on any system where the DB2 subsystem is defined.
System Programmer Response: Refer to MVS/ESA
Programming: Sysplex Services Reference for an
DSN7409I csect-name MEMBER(member-name)
explanation of the IXCJOIN return and reason codes.
UNABLE TO QUIESCE FROM DATA
SHARING GROUP(group-name), MVS
DSN7406I csect-name UNABLE TO QUERY DATA IXCQUIES RETURN CODE=xxxxxxxx,
SHARING GROUP INFORMATION, MVS MVS IXCQUIES REASON
IXCQUERY RETURN CODE=xxxxxxxx, CODE=yyyyyyyy.
MVS IXCQUERY REASON
Explanation: An unexpected error occurred when the
CODE=yyyyyyyy.
data sharing DB2 member attempted to place itself in
Explanation: An unexpected error occurred during the an MVS cross-system coupling facility (XCF) quiesced
execution of the MVS IXCQUERY macro. state.
System Action: The DB2 subsystem terminates with System Action: The DB2 subsystem termination
reason code 00F70406. continues.
Operator Response: Issue an MVS DISPLAY Operator Response: Inform your system programmer.
686 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN7501A • DSN7506A
System Programmer Response: Refer to MVS/ESA 12 The new SCA structure failed during the rebuild
Programming: Sysplex Services Reference for an process.
explanation of the IXCQUIES return and reason codes.
16 A DB2 member lost connectivity to the new
SCA in the rebuild process.
DSN7501A csect-name SCA STRUCTURE
20 An MVS service used during the rebuild
sca-structure-name CONNECTIVITY
process failed. A message was issued from the
FAILURE.
failed MVS service.
Explanation: The specified DB2 member lost
System Action: This DB2 member terminates with
connectivity to the shared communication area (SCA)
reason code 00F70601. Other members can continue
structure.
processing.
System Action: The specified DB2 disconnects from
System Programmer Response: See the termination
the SCA and terminates with reason code 00F70600.
code for more details.
Operator Response: Notify the system programmer.
System Programmer Response: Find out why the DSN7505A csect-name THERE IS A SHORTAGE OF
link from this central processor complex (CPC) to the FREE STORAGE IN SCA STRUCTURE
SCA structure was lost. After fixing it, restart DB2. sca-structure-name
Explanation: The amount of free storage in the
DSN7502I csect-name SCA STRUCTURE shared communications area (SCA) coupling facility
sca-structure-name FAILURE, ATTEMPT structure is low. The SCA is 75 percent full. Because
TO REBUILD IS IN PROGRESS. SCA storage space is required by some DB2
commands and processes, the availability of those
Explanation: The specified DB2 member detected the
processes might be affected. Completely running out of
shared communications area (SCA) structure failure.
SCA storage can cause DB2 subsystem outages.
System Action: DB2 tries to rebuild the SCA structure
This message stays on the MVS console and is
on a coupling facility in the preference list for the
highlighted.
coupling facility.
System Action: DB2 processing continues.
Operator Response: Wait for message DSN7503I or
DSN7504A. This message might remain highlighted and might not
be automatically deleted in a pre SP5.2.1-JES3
environment.
DSN7503I csect-name SCA STRUCTURE
sca-structure-name REBUILD Operator Response: If the message remains
SUCCESSFUL. highlighted after the error situation is cleared up,
manually delete the message from the console.
Explanation: This member successfully connected to
a shared communications area (SCA) structure on the System Programmer Response: You can monitor the
same or an alternate coupling facility and completed amount of SCA storage in use with the DISPLAY
restoration of its information in the shared GROUP command.
communications area (SCA).
You can free SCA storage by removing exception
System Action: DB2 processing continues. conditions. Another thing you can do is issue START
DATABASE commands with the SPACENAM option or
use the RECOVER utility to remove pages from the
DSN7504I csect-name SCA STRUCTURE
logical page list (LPL).
sca-structure-name REBUILD
UNSUCCESSFUL. REASON CODE = xx. If you don’t do anything to reclaim space, message
DSN7512A appears when the SCA is 90 percent full.
Explanation: This member has not successfully
connected to a shared communication area (SCA)
structure on an alternate coupling facility and completed DSN7506A csect-name CONNECT TO THE SCA
restoration of its information in the shared STRUCTURE sca-structure-name
communications area (SCA). This message follows FAILED. MVS IXLCONN RETURN
message DSN7502I. CODE=xxxxxxxx, MVS IXLCONN
REASON CODE=yyyyyyyy.
04 An operator requested to stop the rebuild
process. Explanation: DB2 cannot connect to the shared
communications area (SCA) coupling facility structure.
08 A DB2 resource manager requested to stop the
rebuild process. System Action: DB2 startup terminates with reason
code 00F70602.
Chapter 27. DB2 Messages 687
DSN7507I • DSN7512A
System Programmer Response: DB2 uses the MVS Operator Response: Wait until the SCA rebuild
IXLCONN service to connect to the SCA structure. process is finished and then start the failed DB2 again.
Refer to MVS/ESA Programming: Sysplex Services
Reference for return and reason codes from the
DSN7511I csect-name RESPONSE TO MVS
IXLCONN request.
REBUILD COMPLETE OF SCA
STRUCTURE sca-structure-name
DSN7507I csect-name SCA STRUCTURE FAILED. MVS IXLREBLD RETURN
sca-structure-name IS ALLOCATED IN A CODE = xxxxxxxx, MVS IXLREBLD
VOLATILE STRUCTURE. REASON CODE = yyyyyyyy.
Explanation: The shared communications area (SCA) Explanation: DB2 encountered an error during the
structure is volatile. rebuild of the shared communications area (SCA)
structure.
System Action: DB2 processing continues.
System Action: DB2 stops.
System Programmer Response: One DB2 issues
this message whenever the structure has the volatile System Programmer Response: DB2 uses the MVS
attribute. DB2 detects this either on the first connection IXLREBLD service during the SCA structure rebuild.
to the SCA or on the attribute changes later. DB2 Refer to MVS/ESA Programming: Sysplex Services
always requests a nonvolatile SCA. If this is not what Reference for return and reason codes from the
you want, change the MVS CFRM administrative policy IXLREBLD request.
and request a rebuild of the SCA with the MVS
SETXCF START,REBUILD command.
DSN7512A csect-name THERE IS A CRITICAL
SHORTAGE OF FREE STORAGE IN
DSN7508I csect-name ACCESS TO THE SCA SCA STRUCTURE sca-structure-name
STRUCTURE sca-structure-name
Explanation: The amount of free storage in the
FAILED. MVS IXLLIST RETURN CODE
shared communications area (SCA) coupling facility
= xxxxxxxx, MVS IXLLIST REASON
structure is critically low. The SCA is 90 percent full.
CODE = yyyyyyyy.
This message stays on the MVS console and is
Explanation: DB2 encountered an error in accessing
highlighted.
the shared communications area (SCA) structure.
System Action: DB2 processing continues. However,
System Action: DB2 terminates with reason code
DB2 limits use of SCA to critical information. Some
00F70603.
utilities or commands that cannot be completed can
System Programmer Response: DB2 uses the MVS cause one or more members of the group to come
IXLLIST service to access the SCA structure. Refer to down.
MVS/ESA Programming: Sysplex Services Reference
This message might remain highlighted and might not
for return and reason codes from the IXLLIST request.
be automatically deleted in a pre SP5.2.1-JES3
environment.
DSN7509I csect-name SCA STRUCTURE
Operator Response: If the message remains
sca-structure-name IS ALLOCATED IN A
highlighted after the error situation is cleared up,
NONVOLATILE STRUCTURE.
manually delete the message from the console.
Explanation: The SCA structure is now contained in a
System Programmer Response: You can monitor the
nonvolatile coupling facility structure.
amount of SCA storage in use with the DISPLAY
System Action: DB2 processing continues. GROUP command.
You can free SCA storage by removing exception
DSN7510I csect-name SCA STRUCTURE conditions. Another thing you can do is issue START
sca-structure-name REBUILD REQUEST DATABASE commands with the SPACENAM option or
RECEIVED, BUT SUBSYSTEM IS NOT use the RECOVER utility to remove pages from the
READY TO PARTICIPATE. logical page list (LPL). Then restart any failed DB2s.
Explanation: The DB2 subsystem received a request If your actions do not free up enough space, or if the
from MVS to rebuild the shared communications area problem continues to occur, you have the following
(SCA), but DB2 is not ready to participate in this options, depending on what level of MVS and the
process because DB2 startup has not yet completed. coupling facility control code you are running with:
System Action: DB2 terminates with reason code v If all members of the group are running with MVS
00F70604. The SCA rebuild process might continue for Version 5 Release 2 and with a coupling facility
other DB2s in the data sharing group. control code level greater than 0, issue the SETXCF
START,ALTER command to increase the size of the
688 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN7513I • DSN7514I
SCA. The size you specify must be less than or
equal to the maximum size defined the CFRM policy
for the SCA structure.
If the maximum size (SIZE in the CFRM policy) is still
not big enough, take the actions described below for
MVS Version 5 Release 1 systems.
v If any or all members of the group are running with
MVS Version 5 Release 1 or with a coupling facility
control code level of 0, increase the storage for the
SCA in the CFRM policy. Then issue the MVS
SETXCF START,REBUILD command to rebuild the
structure.
Refer to DB2 Data Sharing: Planning and Administration
for more detailed recovery information.
DSN7513I csect-name SCA STRUCTURE
sca-structure-name HAS ADEQUATE
FREE STORAGE
Explanation: The shared communications area (SCA)
coupling facility structure has adequate free storage to
function properly.
This message is shown in the following circumstances:
v After the SCA was rebuilt.
v After the SCA usage goes below 67%, after its usage
was up to 75% or higher.
System Action: DB2 processing continues.
DSN7514I csect-name RESPONSE TO AN MVS
REBUILD RELATED EVENT FOR THE
SCA STRUCTURE sca-structure-name
FAILED. MVS IXLEERSP RETURN
CODE = xxxxxxxx, MVS IXLEERSP
REASON CODE = yyyyyyyy.
Explanation: DB2 encountered an error during the
rebuild of the shared communications area (SCA)
structure.
System Action: DB2 terminates.
System Programmer Response: DB2 uses the MVS
IXLEERSP service to respond to SCA structure rebuild.
Refer to MVS/ESA Programming: Sysplex Services
Reference for return and reason codes from the
IXLEERSP request.
Chapter 27. DB2 Messages 689
690 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 28. DSN8... Messages
User Response: Display the existing employee data.
DSN8000I REQUEST IS: request
If this is the desired employee, update the employee
Explanation: The input statement is listed as received. entry. Otherwise, choose a new employee number.
This message is issued by the following CSECTs: Problem Determination: List the contents of the
DSN8BD3, DSN8BF3 employee view, VEMP, and the department view,
VDEPT.
System Action: The request is listed.
User Response: See if the input request is what you
DSN8006E csect EMPLOYEE DOES NOT EXIST,
want.
ERASE NOT DONE
Explanation: The erase requested was not performed.
DSN8001I csect EMPLOYEE NOT FOUND
The employee number requested was not present in the
Explanation: The 'l' or 'list' request found no employee table.
data that match your request.
System Action: No employee data is erased.
System Action: No employees are listed.
User Response: Determine if the employee data to be
User Response: If no employee data was expected to erased should exist. Verify that the correct search
be found, continue. criteria and data were entered. If appropriate, correct
the entries and continue processing.
Problem Determination: If the error is unexpected,
list the contents of the employee and department views Problem Determination: List the contents of the
VEMP and VDEPT to determine why the entry is employee view, VEMP, and the department view,
missing. VDEPT.
DSN8002I csect EMPLOYEE SUCCESSFULLY DSN8007E csect EMPLOYEE DOES NOT EXIST,
ADDED UPDATE NOT DONE
Explanation: Employee data was added as requested. Explanation: The update requested was not
performed. The employee number requested was not
System Action: The request was executed present in the table.
successfully.
System Action: No employee data is updated.
DSN8003I csect EMPLOYEE SUCCESSFULLY User Response: Verify that the correct search criteria
ERASED and data were entered.
Explanation: Data for an employee was erased as Problem Determination: List the contents of the
requested. employee table (VPHONE, VEMPLP, or EMP) and see
if the employee number to be updated is in the table.
System Action: The request was executed Correct the update request or the table.
successfully.
DSN8008I csect NO EMPLOYEE FOUND IN TABLE
DSN8004I csect EMPLOYEE SUCCESSFULLY
UPDATED Explanation: No employees match the selection
criteria.
Explanation: Data for an employee was updated as
requested. System Action: No employee data is listed.
System Action: The request was executed User Response: If no employee data was expected,
successfully. continue processing.
Problem Determination: List the contents of the
DSN8005E csect EMPLOYEE EXISTS ALREADY, VPHONE view and the underlying tables.
ADD NOT DONE
Explanation: A request was made to add data for a DSN8011I csect DEPARTMENT NOT FOUND
new employee, but the employee number already
Explanation: No departments match the selection
exists.
criteria.
System Action: No employee data is added.
System Action: No departments are listed.
© Copyright IBM Corp. 1982, 2001 691
DSN8012I • DSN8021I
User Response: If no departments are expected to be Problem Determination: If the error is unexpected,
found, continue. list the contents of the department views VDEPT and
VDEPMG1 and their underlying tables to determine why
Problem Determination: If the error is unexpected,
the entry is missing.
list the contents of the department views VDEPT and
VDEPMG1 and their underlying tables to determine why
the entry is missing. DSN8017E csect DEPARTMENT DOES NOT EXIST,
UPDATE NOT DONE
DSN8012I csect DEPARTMENT SUCCESSFULLY Explanation: The update request found no
ADDED department data which matches your request.
Explanation: A department was added as requested. System Action: No department data is updated.
System Action: The request was executed User Response: See if the department data to be
successfully. updated should exist. If you did not enter the correct
combination of search criteria and data, correct the
entries and continue.
DSN8013I csect DEPARTMENT SUCCESSFULLY
ERASED Problem Determination: If the error is unexpected,
list the contents of the department views VDEPT and
Explanation: Data for a department was erased as
VDEPMG1 and their underlying tables to determine why
requested.
the entry is missing.
System Action: The request was executed
successfully.
DSN8018I csect CURRENT DEPARTMENT NOT
FOUND
DSN8014I csect DEPARTMENT SUCCESSFULLY
Explanation: A request was made by a 'current'
UPDATED
department to reference a 'higher' department. The
Explanation: Data for a department was updated as 'current' department was not found.
requested.
System Action: No department data is processed.
System Action: The request was executed
User Response: If the 'current' department was not
successfully.
expected to exist, continue processing.
Problem Determination: List the contents of the
DSN8015E csect DEPARTMENT EXISTS ALREADY,
department views VDEPMG1, VEMP, VASTRDE1, and
ADD NOT DONE
VASTRDE2 and their underlying tables.
Explanation: You requested that a new department be
added, but the department exists already.
DSN8019E csect NO HIGHER DEPARTMENT
System Action: No departments are added. EXISTS
User Response: Display data for the existing Explanation: A request was made by a 'current'
department. If it is what you want, continue. If not, you department to reference a 'higher' level of the
can update data for this department or choose a new department structure. A 'higher' level does not exist for
department id. the requested 'current' department.
Problem Determination: If the error is unexpected, System Action: No department data is processed.
list the contents of the department views VDEPT and
User Response: If a 'higher' department was not
VDEPMG1 and their underlying tables to see if the data
expected to be found, continue processing.
differs from what is expected.
Problem Determination: List the contents of the
department views VDEPMG1, VEMP, VASTRDE1, and
DSN8016E csect DEPARTMENT DOES NOT EXIST,
VASTRDE2 and their underlying tables.
ERASE NOT DONE
Explanation: The erase request found no departments
DSN8021I csect ACTIVITY NOT FOUND
which match your request.
Explanation: No activities match the selection criteria.
System Action: No department data is erased.
System Action: No activity is listed.
User Response: See if the department data to be
erased should exist. Did you enter the correct User Response: If no activity was expected to be
combination of search criteria and data? If not, correct found, continue processing.
the entries and continue.
Problem Determination: List the contents of the
692 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN8022I • DSN8034I
activity views VPROJRE1, VACT, and VPROJACT and updated should exist. Verify that the correct search
their underlying tables. criteria and data were entered. If appropriate, correct
the entries and continue processing.
DSN8022I csect ACTIVITY SUCCESSFULLY Problem Determination: List the contents of the
ADDED activity views VPROJRE1, VACT, and VPROJACT and
their underlying tables.
Explanation: An activity was added as requested.
System Action: The request was executed
DSN8028I csect ACTIVITY TYPE NOT FOUND,
successfully.
PLEASE ADD IT INTERACTIVELY
Explanation: The add or update was not performed.
DSN8023I csect ACTIVITY SUCCESSFULLY
The activity type entered was not found.
ERASED
System Action: No activity is listed.
Explanation: An activity was erased as requested.
User Response: If the activity type was not expected
System Action: The request was executed
to be found, add it interactively.
successfully.
Problem Determination: List the contents of the
activity view, VACT, and its underlying tables.
DSN8024I csect ACTIVITY SUCCESSFULLY
UPDATED
DSN8031I csect PROJECT NOT FOUND
Explanation: An activity was updated as requested.
Explanation: No projects match the selection criteria.
System Action: The request was executed
successfully. System Action: No projects are listed.
User Response: If no projects are expected to be
DSN8025E csect ACTIVITY EXISTS ALREADY, ADD listed, continue.
NOT DONE
Problem Determination: If the error is unexpected,
Explanation: The addition requested was not list the contents of the project view VPROJ and its
performed. The activity requested was already present. underlying tables to determine why the entry is missing.
System Action: No activity is added.
DSN8032I csect PROJECT SUCCESSFULLY
User Response: If the activity was expected to
ADDED
already exist, continue processing.
Explanation: A project was added as requested.
Problem Determination: List the contents of the
activity views VPROJRE1, VACT, and VPROJACT and System Action: The request was executed
their underlying tables. successfully.
DSN8026E csect ACTIVITY DOES NOT EXIST, DSN8033I csect PROJECT SUCCESSFULLY
ERASE NOT DONE ERASED
Explanation: The erase requested was not performed. Explanation: A project was erased as requested.
The activity requested was not found.
System Action: The request was executed
System Action: No activity is erased. successfully.
User Response: If the activity was not expected to be
found, continue processing. DSN8034I csect PROJECT SUCCESSFULLY
UPDATED
Problem Determination: List the contents of the
activity views VPROJRE1, VACT, and VPROJACT and Explanation: The update was performed as
their underlying tables. requested.
System Action: The request was executed
DSN8027E csect ACTIVITY DOES NOT EXIST, successfully.
UPDATE NOT DONE
Explanation: The update requested was not
performed. The activity requested was not found.
System Action: No activity is updated.
User Response: Determine if the activity to be
Chapter 28. DB2 Messages 693
DSN8035E • DSN8044I
VPSTRDE2 and their underlying tables.
DSN8035E csect PROJECT EXISTS ALREADY,
ADD NOT DONE
DSN8039E csect NO HIGHER PROJECT EXISTS
Explanation: You requested that a new project be
added, but the project exists already. Explanation: A request was made by a 'current'
project to reference a 'higher' level of the project
System Action: The request was not executed
structure. A 'higher' level does not exist for the
successfully.
requested 'current' project.
User Response: Display the existing project. If it is
System Action: No project data is processed.
what you want, continue. If not, you can update this
project or choose a new project id. User Response: If a 'higher' project was not expected
to be found, continue processing.
Problem Determination: If the error was unexpected,
list the contents of the project view VPROJ and its Problem Determination: List the contents of the
underlying tables to see if the data differs from what is project views VPROJRE1, VDEPT, VEMPPROJACT,
expected. VEMP, VSTAFAC1, VSTAFAC2, VPSTRDE1, and
VPSTRDE2 and their underlying tables.
DSN8036E csect PROJECT DOES NOT EXIST,
ERASE NOT DONE DSN8041I csect STAFFING NOT FOUND
Explanation: The erase request found no project Explanation: No project staffing matches the selection
which matches your request. criteria.
System Action: No projects are erased. System Action: No project staffing is listed.
User Response: See if the project to be erased User Response: If no project staffing was expected to
should exist. Did you enter the correct combination of be found, continue processing.
search criteria and data? If not, correct the entries and
continue. Problem Determination: List the contents of the
project activity views VPROJRE1, VEMPPROJACT,
Problem Determination: If the error was unexpected, VACT, and VEMP and their underlying tables.
list the contents of the project view VPROJ and its
underlying tables to determine why the entry is missing.
DSN8042I csect STAFFING SUCCESSFULLY
ADDED
DSN8037E csect PROJECT DOES NOT EXIST,
UPDATE NOT DONE Explanation: A project staffing was added as
requested.
Explanation: The update request found no project
which matches your request. System Action: The request was executed
successfully.
System Action: No projects are updated.
User Response: See if the project to be updated DSN8043I csect STAFFING SUCCESSFULLY
should exist. If you did not enter the correct combination ERASED
of search criteria and data, correct the entries and
continue. Explanation: A project staffing was erased as
requested.
Problem Determination: If the error is unexpected,
list the contents of the project view VPROJ and its System Action: The request was executed
underlying tables to determine why the entry is missing. successfully.
DSN8038I csect CURRENT PROJECT NOT FOUND DSN8044I csect STAFFING SUCCESSFULLY
UPDATED
Explanation: A request was made by a 'current'
project to reference a 'higher' project. The 'current' Explanation: A project staffing was updated as
project was not found. requested.
System Action: No project data is processed. System Action: The request was executed
successfully.
User Response: If the 'current' project was not
expected to be found, continue processing.
Problem Determination: List the contents of the
project views VPROJRE1, VDEPT, VEMPPROJACT,
VEMP, VSTAFAC1, VSTAFAC2, VPSTRDE1, and
694 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN8045E • DSN8061E
DSN8045E csect STAFFING EXISTS ALREADY, DSN8056I csect NO MORE DATA TO DISPLAY
ADD NOT DONE
Explanation: The last page of data has been
Explanation: A request was made to add a project displayed.
staffing, but the project staffing already exists.
System Action: No more data is shown on screen.
System Action: No project staffing is added.
User Response: If you expect no more data to be
User Response: Display the existing project staffing. If displayed, continue.
this is the desired project staffing, update it. Otherwise,
Problem Determination: If more displayed data is
choose a new project staffing.
expected, list the contents of the view and the
Problem Determination: List the contents of the underlying tables to see if the data differs from what is
project activity views VPROJRE1, VEMPPROJACT, expected.
VACT, and VEMP and their underlying tables.
DSN8057I csect FURTHER ENTRIES IN TABLE -
DSN8046E csect STAFFING DOES NOT EXIST, UPDATE POSSIBLE
ERASE NOT DONE
Explanation: More data exists beyond that shown on
Explanation: The project staffing was not erased as the screen.
requested.
System Action: No more data is shown on screen.
System Action: No project staffing is erased.
User Response: Update entries as needed.
User Response: Determine if the project staffing to be
erased should exist. Verify that the correct search
DSN8058I csect PRESS PA1 FOR NEXT PAGE /
criteria and data were entered. If appropriate, correct
ENTER FOR SELECTION MENU
the entries and continue processing.
Explanation: Press the PA1 key to see the data on
Problem Determination: List the contents of the
the next page or press the ENTER key to return to the
project activity views VPROJRE1, VEMPPROJACT,
selection menu.
VACT, and VEMP and their underlying tables.
User Response: Press the PA1 key or the ENTER
key depending on the function you want to perform.
DSN8047E csect STAFFING DOES NOT EXIST,
UPDATE NOT DONE
DSN8060E csect SQL ERROR, RETURN CODE IS:
Explanation: The update was not performed because
sqlcode
the project staffing requested was not found.
Explanation: The SQL statement did not execute
System Action: No project staffing is updated.
correctly. The 'sqlcode' can be found elsewhere in this
User Response: Determine if the project staffing to be manual. This may be an SQL error or an SQL warning.
updated should exist. Verify that the correct search
System Action: The request was not executed
criteria and data were entered. If appropriate, correct
successfully.
the entries and continue processing.
User Response: Refer to “Part 2. SQL Return Codes”
Problem Determination: List the contents of the
on page 9 for more information about the error.
project activity views VPROJRE1, VEMPPROJACT,
VACT, and VEMP and their underlying tables. Problem Determination: Determine which SQL
statement in the application program caused the error
and see if it is reproducible. Follow the diagnosis
DSN8051I csect PROGRAM ENDED
approach suggested for the sqlcode.
Explanation: The application program finished.
DSN8061E csect ROLLBACK FAILED, RETURN
DSN8053I csect ROLLBACK SUCCESSFUL, ALL CODE IS: sqlcode
UPDATES REMOVED
Explanation: The SQL ROLLBACK statement was not
Explanation: After any SQLWARNING or executed correctly.
SQLERROR, all updates are removed via a ROLLBACK
System Action: The request was not executed
statement to prevent invalid updates.
successfully.
System Action: The ROLLBACK was executed
User Response: Refer to “Part 2. SQL Return Codes”
successfully.
on page 9.
User Response: Correct the prior error.
Problem Determination: Determine which SQL
Chapter 28. DB2 Messages 695
DSN8062E • DSN8072E
statement in the application program caused the error of the view and the underlying tables to see if the data
and see if it is reproducible. Follow the diagnosis differs from what is expected. If after checking the view
approach suggested for the sqlcode. and the underlying tables, you find the search criteria
values you entered should provide valid selections, the
error is in the sample program. Report the error.
DSN8062E csect AN OBJECT WAS NOT
SELECTED
DSN8068E csect INVALID REQUEST SHOULD BE
Explanation: You did not specify an object code on
'L' OR 'U'
the input line.
Explanation: The input must begin with 'L' or 'U'.
User Response: Select one of the object codes listed
on the panel. System Action: The request is ignored.
User Response: Correct the input request.
DSN8064E csect INVALID DL/I STC-CODE ON GU
MSG: status-code
DSN8069E csect NO VALID SELECTIONS QUALIFY
Explanation: In attempting to get a message from FOR THIS REQUEST
IMS, an unexpected status-code was received.
Explanation: You entered a search criteria value and
System Action: The application program is a data values that do not find any selections.
terminated.
System Action: The request was not executed
Problem Determination: Refer to the messages and successfully.
codes manual for IMS/VS to determine the reason for
User Response: Enter new search criteria values.
the unexpected status code.
Problem Determination: If the criteria values you
entered are expected to provide valid selections, check
DSN8065E csect INVALID DL/I STC-CODE ON ISRT
the contents of the view and the underlying tables to
MSG: status-code
see if the data differs from what is expected. If after
Explanation: In attempting to insert a message for checking the view and the underlying tables, you find
IMS, an unexpected status-code was received. the search criteria values you entered should provide
valid selections, the error is in the sample program.
System Action: The application program is
Report the error.
terminated.
Problem Determination: Refer to the messages and
DSN8070E csect VITAL DATA IS MISSING IN
codes manual for IMS/VS to determine the reason for
TABLE TOPTVAL
the unexpected status code.
Explanation: No valid entries exist in the table that
contains possible valid entries.
DSN8066E csect UNSUPPORTED PFK OR LOGIC
ERROR System Action: The request was not executed
successfully.
Explanation: The sample application found an
unsupported program function key or logic error while User Response: There is no valid entry you can enter.
trying to execute a request. Report the error in the sample program.
System Action: The request was not executed
successfully. DSN8072E csect INVALID SELECTION ON
SECONDARY SCREEN
User Response: Report the error in the application
program. Explanation: You gave an invalid line number.
System Action: The request was not executed
DSN8067E csect UNSUPPORTED SEARCH successfully.
CRITERIA FOR OBJECT
User Response: You entered a number that is not in
Explanation: You entered a search criteria value and the list on the left under the heading NO for line
an object value that do not find any selections. number. Enter a valid number.
System Action: The request was not executed Problem Determination: If the line number you
successfully. entered is in the list on the left under the heading NO
for line number, then the error is in the sample program.
User Response: Enter new search criteria values.
Problem Determination: If the values you entered are
expected to provide valid selections, check the contents
696 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN8073E • DSN8082E
User Response: Call the desired program through the
DSN8073E csect SPECIFIED LINE-NUMBER NOT
connection manager, DSN8SCM or DSN8SPM.
FOUND IN PREVIOUS SCREEN
Explanation: You gave an invalid line number.
DSN8080E APPLICATION TERMINATED WITH
System Action: The request was not executed CALL ATTACH REASON CODE
successfully. reason-code
User Response: You entered a number that is not in Explanation: The call attachment facility service
the list on the left under the heading NO for line requested by the application program did not execute
number. Enter a valid number. If the line number is in successfully.
the previous screen, then this is an error in the sample
This message is issued by the following CSECTs:
program. Report the error.
DSN8SCM, DSN8SPM
System Action: The requested service is not
DSN8074E csect DATA IS TOO LONG FOR
executed.
SEARCH CRITERIA
User Response: Notify the system programmer.
Explanation: You entered a data value that has too
many characters for the type of search criterion you System Programmer Response: Check the call
selected. For example, department ids have a maximum attachment facility reason code.
of 3 characters and most other ids have a maximum of
6 characters. Problem Determination: Follow the failure analysis
procedures for the call attachment facility reason code.
System Action: The request was not executed
successfully.
DSN8081E RESULTS FROM THE CALL ATTACH
User Response: Enter a data value with the correct TRANSLATE SERVICE
number of characters.
Explanation: The call attachment facility OPEN
service that was requested from the application program
DSN8075E csect MESSAGE FORMAT ROUTINE did not execute successfully. The TRANSLATE service
ERROR, RETURN CODE IS: sqlcode was requested to provide information about the OPEN
failure.
Explanation: There is an error in the parameters
passed to the SQLCA formatting routine, DSNTIAR. System Action: The requested OPEN service was not
executed.
System Action: The SQLCA could not be formatted
properly. User Response: Refer to “Part 2. SQL Return Codes”
on page 9.
User Response: This is an error in the program.
Check the return code listing of DSNTIAR in Part 2 of Problem Determination: Refer to “Part 2. SQL Return
DB2 Application Programming and SQL Guide. Report Codes” on page 9 for more information about the error.
the error.
DSN8082E THE DISCONNECT TERMINATED WITH
DSN8076E csect VITAL DATA IS MISSING IN REASON CODE reason-code
TABLE 'TDSPTXT'
Explanation: The call attachment facility
Explanation: No valid entries exist in the table that DISCONNECT service requested by the application
contains possible valid entries. program did not execute successfully.
System Action: The request was not executed System Action: The requested DISCONNECT service
successfully. is not executed.
User Response: There is no valid entry you can enter. User Response: Notify the system programmer.
Report the error in the application program.
System Programmer Response: Check the call
attachment facility reason code.
DSN8079E CONNECTION TO DB2 NOT
ESTABLISHED Problem Determination: Follow the failure analysis
procedures for the call attachment facility reason code.
Explanation: Sample programs DSN8SC3, DSN8SP3,
and DSN8HC3 cannot be called directly from TSO.
Instead, they must be called from the ISPF sample
connection manager, DSN8SCM or DSN8SPM.
System Action: The program ends.
Chapter 28. DB2 Messages 697
DSN8083E • DSN8215E
DSN8083E AN UNKNOWN SERVICE service WAS DSN8210I csect INVALID MGRNO, DEPARTMENT
REQUESTED NOT ADDED
Explanation: The user is requesting an invalid service. Explanation: The department that is to be added has
a manager number that is not contained in the table
This message is issued by the following CSECTs:
EMP. The add cannot be completed.
DSN8SCM, DSN8SPM
System Action: No department is added.
System Action: The requested service was not
executed. User Response: Ensure that the correct manager
number was entered.
User Response: Notify the system programmer.
Problem Determination: List the contents of the
System Programmer Response: The service request
employee table EMP.
must be a valid call attachment facility service. Ensure
that the request is one of the services supported by the
call attachment facility. DSN8212E csect DEPARTMENT NUMBER HAS
DEPENDENT ROWS, NOT ERASED
Problem Determination: There is an error in the
Sample Application Program. Explanation: The department number that is to be
erased is the same as a project department number in
table PROJ. The department cannot be erased.
DSN8200E csect INVALID DEPARTMENT NUMBER,
EMPLOYEE NOT ADDED System Action: No department data is erased.
Explanation: The employee number that is to be User Response: Ensure that the correct department
added refers to a department number that is not number was entered.
contained in the table DEPT.
Problem Determination: List the contents of the
System Action: The employee number is not added. project table PROJ.
User Response: Ensure that the correct department
number was entered. DSN8213E csect INVALID ADMIN DEPT ID,
DEPARTMENT NOT ADDED
Problem Determination: List the contents of the
department table DEPT. Explanation: The department that is to be added has
a department number that is not contained in the table
DEPT. The add cannot be completed.
DSN8202E csect EMPLOYEE NUMBER HAS
DEPENDENT ROWS, NOT ERASED System Action: No department is added.
Explanation: The employee number to be erased is User Response: Ensure that the correct department
the same as a responsible employee number in the number was entered.
table PROJ or an employee number in the table
Problem Determination: List the contents of the
EMPPROJACT. The employee number cannot be
employee table DEPT.
erased from the table EMP.
System Action: No employee data is erased.
DSN8214E csect INVALID MANAGER ID,
User Response: Ensure that the correct employee DEPARTMENT NOT UPDATED
number was entered.
Explanation: The department that is to be updated
Problem Determination: List the contents of the has a manager number that is not contained in the table
PROJ and EMPPROJACT tables. EMP. The update cannot be completed.
System Action: No department data is updated.
DSN8203E csect INVALID WORK DEPT,
User Response: Ensure that the correct manager
EMPLOYEE NOT UPDATED
number was entered.
Explanation: The employee that is to be updated has
Problem Determination: List the contents of the
a department number that is not contained in the table
employee table EMP.
DEPT. The update cannot be completed.
System Action: No employee data is updated.
DSN8215E csect INVALID ADMIN DEPT ID,
User Response: Ensure that the correct department DEPARTMENT NOT UPDATED
number was entered.
Explanation: The department that is to be updated
Problem Determination: List the contents of the has a administrative department number that is not in
employee table DEPT. the table DEPT. The update cannot be completed.
698 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN8216E • DSN8233E
System Action: No department data is updated. User Response: Ensure that the correct activity was
entered.
User Response: Ensure that the correct department
number was entered. Problem Determination: List the contents of the
PROJACT and EMPPROJACT tables.
Problem Determination: List the contents of the
employee table DEPT.
DSN8223E csect ACTIVITY HAS DEPENDENT
ROWS, NOT UPDATED
DSN8216E csect DEPT NOT AT SPECIFIED
LOCATION, EMPLOYEE NOT ADDED Explanation: A start date in table PROJACT is to be
updated, but there is a project staffing for this activity in
Explanation: The employee number that is to be
table EMPPROJACT. The start date in table PROJACT
added refers to a department number whose
cannot be updated.
LOCATION field in the DEPT table is different from that
specified for the employee. The add cannot be System Action: No activity data is updated.
completed.
User Response: Ensure that the correct start date
System Action: No employee is added. was entered.
User Response: Ensure that the correct department Problem Determination: List the contents of the
number was entered. project-activity-staffing table EMPPROJACT and
project-activity table PROJACT.
Problem Determination: List the contents of the
department table DEPT.
DSN8230E csect INVALID DEPARTMENT NUMBER,
PROJECT NOT ADDED
DSN8217E csect DEPT NOT AT SPECIFIED
LOCATION, EMP NOT UPDATED Explanation: The project that is to be added contains
a department number that is not present in the table
Explanation: The employee number that is to be
DEPT. The add cannot be completed.
updated refers to a department number whose
LOCATION field in the DEPT table is different from that System Action: No project is added.
specified for the employee. The update cannot be
User Response: Ensure that the correct department
completed.
number was entered.
System Action: No employee data is updated.
Problem Determination: List the contents of the
User Response: Ensure that the correct department department table DEPT.
number was entered.
Problem Determination: List the contents of the DSN8231E csect INVALID RESPONSIBLE ID,
department table DEPT. PROJECT NOT ADDED
Explanation: The project that is to be added contains
DSN8220E csect INVALID PROJECT NUMBER, an employee number that is not contained in the table
ACTIVITY NOT ADDED EMP. The add cannot be completed.
Explanation: The activity that is to be added contains System Action: No project is added.
a project number that is not contained in the table
User Response: Ensure that the correct employee
PROJ. The add cannot be completed.
number was entered.
System Action: The activity is not added.
Problem Determination: List the contents of the
User Response: Ensure that the correct project employee table EMP.
number was entered.
Problem Determination: List the contents of the DSN8233E csect PROJECT NUMBER HAS
project table PROJ. DEPENDENT ROWS, NOT ERASED
Explanation: A project number in table PROJ is to be
DSN8222E csect ACTIVITY HAS DEPENDENT erased, but it is the same as a project number in table
ROWS, NOT ERASED PROJACT. The project cannot be erased from table
PROJ.
Explanation: The activity that is to be erased from
table PROJACT is the same as the corresponding System Action: No project is erased.
activity in the table EMPPROJACT. The activity cannot
User Response: Ensure that correct project number
be erased from the table PROJACT.
was entered.
System Action: No activity data is erased.
Problem Determination: List the contents of the
Chapter 28. DB2 Messages 699
DSN8235E • DSN8243E
PROJ and PROJACT tables.
DSN8240E csect INVALID EMPLOYEE NUMBER,
STAFFING NOT ADDED
DSN8235E csect INVALID MAJOR PROJECT ID,
Explanation: The staffing that is to be added refers to
PROJECT NOT ADDED
an employee number that is not present in table EMP.
Explanation: The project that is to be added contains The add cannot be completed.
a major project ID that is not contained in the table
System Action: No staffing is added.
PROJ. The add cannot be completed.
User Response: Ensure that the correct employee
System Action: No project is added.
number was entered.
User Response: Ensure that the correct major project
Problem Determination: List the contents of
number was entered.
employee table EMP.
Problem Determination: List the contents of the
project table PROJ.
DSN8242E csect INVALID PROJECT ACTIVITY
DATA, STAFFING NOT ADDED
DSN8236E csect INVALID ASSOCIATE DEPT ID,
Explanation: The staffing that is to be added refers to
PROJECT NOT UPDATED
a project number, activity number, and start date that is
Explanation: The project that is to be updated has a not present in table PROJACT. The add cannot be
department number that is not contained in the table completed.
DEPT. The update cannot be completed.
System Action: No staffing is added.
System Action: No project data is updated.
User Response: Ensure that the correct project
User Response: Ensure that the correct department number, activity number, and start date were entered.
number was entered.
Problem Determination: List the contents of the
Problem Determination: List the contents of the project table PROJACT.
department table DEPT.
DSN8243E csect INVALID START DATE, STAFFING
DSN8237E csect INVALID RESPONSIBLE ID, NOT UPDATED
PROJECT NOT UPDATED
Explanation: The start date given is not currently in
Explanation: The project that is to be updated has a the project-activity table PROJACT. The update cannot
employee number that is not contained in the table be completed.
EMP. The update cannot be completed.
System Action: No staffing data is updated.
System Action: No project data is updated.
User Response: Ensure that the correct start date
User Response: Ensure that the correct employee was entered.
number was entered.
Problem Determination: List the contents of the
Problem Determination: List the contents of the project-activity table PROJACT and the
employee table EMP. project-activity-staffing table EMPPROJACT.
DSN8238E csect INVALID MAJOR PROJECT ID,
PROJECT NOT UPDATED
Explanation: The project that is to be updated has a
major project number that is not contained in the table
PROJ. The update cannot be completed.
System Action: No project data is updated.
User Response: Ensure that the correct project
number was entered.
Problem Determination: List the contents of the
project table PROJ.
700 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 29. DSN9... Messages
two adjacent apostrophes must be entered. If the
DSN9000I KEYWORD keyword-name APPEARS
parameter is a hexadecimal value, it must be entered as
MORE THAN ONCE
X'hex characters'.
Explanation: The same keyword (specified in the
System Action: Processing for the command is
messages as 'keyword-name') appears more than once
terminated.
in the command. This message will be issued for each
occurrence of the keyword after the first. System Programmer Response: Correct the error,
and reissue the command.
System Action: Processing for the command is
terminated. Problem Determination: Obtain a copy of the system
or terminal log to verify the command entry.
System Programmer Response: Correct the
command by using the keyword only once, and reenter
the command. DSN9004I KEYWORD keyword-name RANGE (c)
INCORRECTLY SPECIFIED
Problem Determination: Obtain a copy of the system
or terminal log to verify the command entry. Explanation: The range for a keyword (specified in
the message as 'keyword-name') was incorrectly
specified using the syntax character specified in the
DSN9001I KEYWORD keyword-name IS INVALID
message as 'c'. The standard syntax character used to
Explanation: The keyword (specified in the message denote a range is a colon (:). Either the ending limit of
as 'keyword-name') is unknown or undefined. The the range was omitted or a subset was specified within
keyword may be misspelled, or the keyword may not be the range.
applicable to the command being processed.
Examples of this error are LINE(1:) and GROUP(A*:B*).
System Action: Processing for the command is
Examples of a correctly specified range are LINE(1:3)
terminated.
and GROUP(A:B).
System Programmer Response: Correct the
System Action: Processing for the command is
keyword, and reissue the command.
terminated.
Problem Determination: Obtain a copy of the system
System Programmer Response: Refer to DB2
or terminal log to verify the command entry.
Command Reference to verify that the command you
are using allows a range for the given keyword. Correct
DSN9002I UNBALANCED PARENTHESES WERE the error, and reissue the command.
FOUND FOLLOWING KEYWORD
Problem Determination: Obtain a copy of the system
keyword-name
or terminal log to verify the command entry.
Explanation: An invalid combination of parentheses
has been encountered following the keyword (specified
DSN9005I KEYWORD keyword-name SUBSET (c)
in the message as 'keyword-name'). Parenthesis must
INCORRECTLY SPECIFIED
be paired open and close, and a close parenthesis must
follow an open parenthesis before another open Explanation: The subset for a keyword (specified in
parenthesis is encountered. the message as 'keyword-name') was incorrectly
specified for use with the syntax character 'c' in the
System Action: Processing for the command is
message. The standard syntax character used to
terminated.
denote a subset is an asterisk (*).
System Programmer Response: Correct the error,
For example, consider a group of objects named
and reissue the command.
BLACK, BLUE, GREEN, RED, and WHITE. You may
Problem Determination: Obtain a copy of the system either explicitly specify BLACK and BLUE, or you may
or terminal log to verify the command entry. specify BL*, meaning all members of the group whose
names begin with BL. The character that follows the
asterisk must be a blank, comma, close parenthesis, or
DSN9003I KEYWORD keyword-name PARAMETER
colon.
CONTAINS UNBALANCED
APOSTROPHES Examples of such an error are NAME(BL*CK) and
NAME(*LUE).
Explanation: An odd number of apostrophes is
present in a parameter. If the parameter is a quoted Examples of correct specification are NAME(BL*) and
string, it must have one apostrophe at each end of the UNIT(2*).
string. If an apostrophe is to appear within the string,
© Copyright IBM Corp. 1982, 2001 701
DSN9006I • DSN9010I
System Action: Processing for the command is allowed. As an example, consider a keyword called
terminated. PRINT that could indicate that you want something
printed. If you did not want the material to be printed,
System Programmer Response: Refer to DB2
you might specify NOPRINT. This process of prefixing a
Command Reference to be sure that the command you
keyword with the characters NO is called negation.
are using allows a subset for the named keyword.
While negation may be meaningful on some keywords,
Correct the error, and reissue the command.
it is not allowed on all keywords.
Problem Determination: Obtain a copy of the system
System Action: Processing for the command is
or terminal log to verify command entry.
terminated.
System Programmer Response: Reenter the
DSN9006I KEYWORD keyword-name ASTERISK
command, but do not negate the named keyword. Refer
(c) INCORRECTLY USED
to DB2 Command Reference for further information
Explanation: For the keyword specified in the concerning this command.
message (as 'keyword-name'), an asterisk (c) was used
Problem Determination: Obtain a copy of the system
as the first character of a parameter to specify ALL.
or terminal log to verify the command entry.
However, the asterisk appears in a list, or the
characters in juxtaposition are not a blank, comma,
equal sign, or parentheses. DSN9009I KEYWORD keyword-name IS MISSING
AND MUST BE SPECIFIED
Examples of such errors are LINE(LINE1,*,LINE7),
NAME(**), and GROUP(PQR:*). Explanation: The keyword specified in the message
(as 'keyword-name') must be present, but it was not
Examples of correct specification are UNIT(*) and
entered. This keyword must be present in order for the
LINE=* etc.
command to process properly.
System Action: Processing for the command is
System Action: Processing for the command is
terminated.
terminated.
System Programmer Response: Refer to DB2
System Programmer Response: Enter the command
Command Reference to be sure the command you are
again, and include the specified keyword.
using allows specification of ALL for the given keyword.
Correct the error, and reissue the command. Problem Determination: Obtain a copy of the system
or terminal log to verify the command entry.
Problem Determination: Obtain a copy of the system
or terminal log to verify command entry.
DSN9010I REQUIRED PARAMETER FOR
KEYWORD keyword-name IS MISSING
DSN9007I THIS COMMAND REQUIRES ONE OF
THE FOLLOWING KEYWORDS BE Explanation: A parameter must be specified for the
SPECIFIED, keyword1 keyword2 keyword specified in the message (as 'keyword-name'),
keyword3 keyword4 keyword5 keyword6 but no parameter was entered.
keyword7 keyword8
As an example of this error, consider a keyword called
Explanation: One of the keywords identified in the list PRIORITY whose value can range from 0 to 9.
must be specified on this command, but none of these Specification of PRIORITY(1) is acceptable, but, if you
keywords was present. specify PRIORITY with no parameter value, the
keyword is meaningless.
System Action: Processing for the command is
terminated. System Action: Processing for the command is
terminated.
System Programmer Response: Identify the
appropriate keyword from the list, include that keyword, System Programmer Response: Supply appropriate
and reissue the command. Refer to DB2 Command parameters for the specified keyword and reissue the
Reference for descriptions of the keywords. command. Refer to DB2 Command Reference for valid
parameter values.
Problem Determination: Obtain a copy of the system
or terminal log to verify command entry. Problem Determination: Obtain a copy of the system
or terminal log to verify the command entry.
DSN9008I KEYWORD keyword-name MAY NOT BE
NEGATED
Explanation: The negation characters (NO) appear in
front of the keyword (specified in the message as
'keyword-name'), but negating this keyword is not
702 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN9011I • DSN9016I
System Programmer Response: Refer to DB2
DSN9011I PARAMETER(S) CANNOT BE
Command Reference for a list of acceptable
SPECIFIED FOR KEYWORD
parameters. Correct the error, and reissue the
keyword-name
command.
Explanation: No parameter(s) can be specified for the
Problem Determination: Obtain a copy of the system
keyword specified in the message (as 'keyword-name').
or terminal log to verify the command entry.
You may have misspelled the keyword-name, causing it
to be interpreted as a different keyword, or the
parameter may actually belong with another keyword DSN9014I KEYWORD keyword-name LIMIT OF nn
instead of the one on which you entered it. PARAMETER(S) EXCEEDED
System Action: Processing for the command is Explanation: Too many parameters have been
terminated. specified for the keyword that is specified in the
message. The command processor does not accept
System Programmer Response: Correct the error,
more than the limit (specified in the message as 'nn') of
and reissue the command. Refer to DB2 Command
parameters. This error is probably caused by entering
Reference for details on how to enter the command.
too many parameters. It could also be caused by a
Problem Determination: Obtain a copy of the system missing close parenthesis that has not yet been
or terminal log to verify the command entry. detected.
System Action: Processing for the command is
DSN9012I KEYWORD keyword-name terminated.
PARAMETER(S) MUST BE
System Programmer Response: Reissue the
HEXADECIMAL
command, and enter no more than the specified limit of
Explanation: Parameter values for the keyword parameters for the given keyword. If necessary, issue
specified in the message (as 'keyword-name') must be the command more than once to process all the desired
hexadecimal values. The value must be specified as parameter values. Refer to DB2 Command Reference
X'hex characters'. Hexadecimal characters are defined for further details.
as the numeric digits 0 through 9 and the letters A
Problem Determination: Obtain a copy of the system
through F. Either uppercase or lowercase is acceptable
or terminal log to verify the command entry.
for the letters A through F.
As an example of this error, consider the keyword
DSN9015I PARAMETER parameter-value IS
OFFSET, for which you are expected to enter a
UNACCEPTABLE FOR KEYWORD
hexadecimal value. If you enter OFFSET(X'2C'), it is
keyword-name
acceptable. However, entering OFFSET(Jones) is not
acceptable. Explanation: The parameter value specified in the
message is not an acceptable value for the named
System Action: Processing for the command is
keyword.
terminated.
As an example, consider a keyword called PRINT that
System Programmer Response: Reissue the
can have parameters of YES or NO. Specification of
command, but ensure that the parameters for the
PRINT(YES) or PRINT(NO) is valid. However,
named keyword are hexadecimal values.
specification of PRINT(MAYBE) is unacceptable.
Problem Determination: Obtain a copy of the system
System Action: Processing for the command is
or terminal log to verify the command entry.
terminated.
System Programmer Response: Refer to DB2
DSN9013I KEYWORD keyword-name PARAMETER
Command Reference for a list of acceptable
parameter value EXCEEDS
parameters. Correct and reissue the command.
ALLOWABLE LENGTH OF nn
Problem Determination: Obtain a copy of the system
Explanation: The parameter value (specified in the
or terminal log to verify the command entry.
message as 'parameter value') exceeds the limit of 'nn'
characters in length.
DSN9016I verb-name COMMAND REJECTED,
As an example of this type of error, consider a
UNAUTHORIZED REQUEST
PRIORITY keyword whose value may range from zero
to nine. If you specify PRIORITY(21) or PRIORITY(006), Explanation: The command specified in the message
the value you have entered exceeds the limit of one (as 'verb-name') requires that you have proper
character. authorization in order to use the command. You do not
have the required authorization.
System Action: Processing for the command is
terminated.
Chapter 29. DB2 Messages 703
DSN9017I • DSN9021I
System Action: The command is not executed. reason for insufficient storage available to the
Processing is terminated. command. If a cursory examination of the system
indicates that the region sizes for DB2 are sufficient,
Operator Response: If the command must be
and the current workload does not seem excessive,
executed on behalf of the user and your installation
then a MVS Console dump (MVS DUMP command)
operating procedures permit it, enter the command on
may be required.
request.
Insure that any retry steps defined by the command are
System Programmer Response: Contact the system
performed prior to reissuing the command.
programmer responsible for system security, and
request that this person grant you authorization to use Problem Determination: The invoked command had
the command. Otherwise, you must have someone who completed processing and returned to the Command
is authorized issue the command for you. If necessary, Preprocessor when an attempt was made to obtain
request the system operator to enter the command for storage from the address space from which the
you. command was entered. Since sufficient storage was
unavailable, no response messages from the invoked
Problem Determination: Obtain a copy of the system
command are available.
or terminal log to verify the command entry.
DSN9019I VERB verb-name IS NOT A KNOWN
DSN9017I FAILURE WHILE PROCESSING
COMMAND
verb-name pkw-name COMMAND,
PROCESSING TERMINATED Explanation: The command represented by the verb
specified in the message is not known to the system; it
Explanation: The DB2 command processor has
is an undefined command. A possible cause for this
abended while processing the command (specified in
error is that you made a spelling error while entering the
the message as 'verb-name pkw-name'). The error is
command.
been recorded in SYS1.LOGREC, and an SVC dump is
requested. The command may have partially completed. System Action: Processing for the command is
Refer to any prior response messages to determine terminated.
what has been done.
System Programmer Response: Refer to DB2
System Action: Processing for the command is Command Reference for the correct command format.
terminated.
Problem Determination: Obtain a copy of the system
Operator Response: If a dump was produced, have it or terminal log to verify the command entry.
printed. Print a copy of the contents of the
SYS1.LOGREC data set for the time period involved.
DSN9020I ONLY ONE OF THE FOLLOWING
Forward these items with a copy of the system log to
KEYWORDS MAY BE SPECIFIED ON
the system programmer.
THIS COMMAND, keyword1 keyword2
System Programmer Response: Reissue the keyword3 keyword4 keyword5 keyword6
command. If a second failure occurs, consult your keyword7 keyword8
supervisor.
Explanation: Only one of the identified keywords can
Problem Determination: Obtain a copy of the system be specified at the same time on this command.
or terminal log to verify command entry. Contact the
System Action: Processing for the command is
system operator to make sure that diagnostic
terminated.
information is forwarded to you.
System Programmer Response: Identify the
appropriate keyword from the list, include only that
DSN9018I csect-name ABORTING verb-name
keyword, and reissue the command. Refer to DB2
PROCESSING DUE TO INSUFFICIENT
Command Reference for descriptions of the keywords.
STORAGE AVAILABLE
Problem Determination: Obtain a copy of the system
Explanation: The command processor was unable to
or terminal log to verify the command entry.
obtain sufficient storage to complete processing of any
response messages generated by the invoked
command. DSN9021I VERB verb-name REQUIRED
KEYWORD IS MISSING
System Action: Processing for the command is
terminated abnormally. Explanation: The command specified in the message
(as 'verb-name') was entered, but at least one required
Operator Response: Notify the system programmer
keyword is missing. The command processor was
before attempting to reissue the command.
unable to determine which keyword or keywords were
System Programmer Response: Determine the missing.
704 DB2 UDB for OS/390 and z/OS: Messages and Codes
DSN9022I • DSN9029I
System Action: Processing for the command is
DSN9025I csect-name verb-name pkw-name
terminated.
NORMAL COMPLETION FOR
System Programmer Response: Refer to DB2 SYNCHRONOUS PHASE, AND IN
Command Reference for the proper format of the PROGRESS FOR ASYNCHRONOUS
named command, and then reenter the command. PHASE.
Problem Determination: Obtain a copy of the system Explanation: All synchronous processing for the
or terminal log to verify command entry. If a failure is command specified as 'verb-name pkw-name' in this
suspected, take a storage dump. message completed successfully. Any tasks executing
asynchronously for the specified command might still be
executing when this message is displayed.
DSN9022I csect-name verb-name pkw-name
NORMAL COMPLETION System Action: Synchronous processing for the
specified command is complete. Subsequent system
Explanation: All synchronous processing for the actions defined by the command that can occur during
command specified in the message as 'verb-name the asynchronous phase of command processing are
pkw-name' completed successfully. Any tasks executing documented in DB2 Command Reference.
asynchronously for the specified command might still be
executing when this message is displayed.
DSN9026I KEYWORD keyword-name
System Action: Synchronous processing for the PARAMETER(S) MUST BE
specified command is complete. Subsequent system ALPHABETIC
actions defined by the command are documented in
DB2 Command Reference .
DSN9027I KEYWORD keyword-name
PARAMETER(S) MUST BE
DSN9023I csect-name verb-name pkw-name ALPHAMERIC
ABNORMAL COMPLETION
Explanation: The command specified in the message DSN9028I KEYWORD keyword-name
as 'verb-name pkw-name' completed unsuccessfully. PARAMETER(S) MUST BE NUMERIC
The command issued one or more error messages
before this message. The name of the CSECT that Explanation: Parameter values for the keyword
issued the message is shown at the beginning of the (specified on these messages) must be of a specific
message as a diagnostic aid. type, such as all ALPHABETIC or all ALPHAMERIC /
NATIONAL characters, or all NUMERIC values.
System Action: Processing for the command ended.
As an example of this type of error, consider the
System Programmer Response: Proceed as keyword NAME, where you are expected to enter a
indicated by previous error messages. person’s last name. If you enter NAME(Jones) it is
acceptable, but if you enter NAME(Jon4s), it is not
DSN9024I KEYWORD keyword-name PARAMETER acceptable.
MAY NOT SPECIFY A RANGE OF As a second example, consider a keyword WEIGHT
VALUES that specifies a numeric weight. Entering WEIGHT(47)
Explanation: The parameter of the keyword specified is acceptable, but entering WEIGHT(4u) is not.
in the message specifies a range using the colon System Action: Processing for the command is
operator, (for instance, 1:3), but a range of values is not terminated.
allowed.
System Programmer Response: Reissue the
As an example, consider a keyword called CLASS. You command but ensure that the parameters for the named
might enter CLASS(1,2,3) to specify classes 1, 2, and 3, keyword are of the required type.
or you might enter CLASS(1:3). However, not all
commands allow you to specify a range of values. Problem Determination: Obtain a copy of the system
or terminal log to verify the command entry.
System Action: Processing for the command is
terminated.
DSN9029I csect-name FAILURE WHILE
System Programmer Response: Correct the keyword PROCESSING A COMMAND
parameter, and reenter the command.
Explanation: A failure has been encountered while
Problem Determination: Obtain a copy of the system processing a command. The command may or may not
or terminal log to verify command entry. have been executed. The error has been recorded in
the system error log (the SYS1.LOGREC data set), and
an SVC dump was attempted.
Chapter 29. DB2 Messages 705
DSN9030I • DSN9034I
System Action: Processing for the command is you have followed the rules for command entry, and
terminated. reenter the command.
Operator Response: If a dump was produced, have it Problem Determination: Obtain a copy of the system
printed. Print a copy of the contents of the or terminal log to verify command entry.
SYS1.LOGREC data set for the time period involved.
Forward these items with a copy of the system log to
DSN9032I REQUESTED FUNCTION IS NOT
the system programmer.
AVAILABLE
System Programmer Response: Reissue the
Explanation: An attempt was made to invoke a
command. If a second failure occurs, consult your
command processor that was not loaded. An example of
supervisor or the system programmer.
this is invoking -START DDF or -STOP DDF when DDF
Problem Determination: Obtain a copy of the system is not loaded (not selected during the installation
or terminal log to verify command entry. Contact the process).
system operator to make sure that diagnostic
System Action: The requested function is not
information is forwarded to the system programmer.
performed.
User Response: Determine what function was
DSN9030I KEYWORD keyword-name PARAMETER
requested. Do not invoke this function until DB2 is
MAY NOT SPECIFY A SUBSET OF
reinstalled and DDF is selected.
VALUES
Problem Determination: Look at the console log to
Explanation: The parameter for the keyword specified
determine which command caused the error.
in the message identifies a subset using the asterisk
operator (for instance, ABC*, *ABC, or *ABC*DEF*), but
using a subset is not allowed for this command. DSN9033I KEYWORD name1 REQUIRES
KEYWORD name2
As an example, consider a keyword called NAME, for
which you can specify people’s names. You might Explanation: When keyword 'name1' is specified,
specify NAME(ROBERT ROBERTS ROBERTSON) to keyword 'name2' must also be specified.
enter three names, or you might specify NAME(ROB*)
to indicate all names that begin with the characters System Action: Processing for the command
ROB. NAME(*BERT*) could also be specified to indicate terminates.
all names that contain the characters BERT within the User Response: Resubmit the command with the
name. However, not all commands allow you to specify missing keyword.
a subset of values in this way.
Problem Determination: Obtain a copy of the system
System Action: Processing for the command is or terminal log to verify the command entry.
terminated.
System Programmer Response: Correct the keyword DSN9034I THE TOTAL LENGTH OF COMMAND
parameter, and reenter the command. RESPONSE MESSAGES EXCEEDED
Problem Determination: Obtain a copy of the system ITS LIMIT. DISPLAY IS TERMINATED.
or terminal log to verify command entry. Explanation: The total length of all response
messages returned from a single DB2 command
DSN9031I SYNTAX ERROR DETECTED exceeded the internal limit set by the system. The
FOLLOWING KEYWORD keyword-name message chain was truncated. This message was
appended at the end of the chain to inform the user of
Explanation: The text that follows the named keyword the termination of the report.
contains invalid syntax.
As an example, consider specification of CLASS==A.
The double equal signs do not conform to the rules of
syntax and make the keyword meaningless. This is just
one example of invalid syntax. It is not practical to try to
illustrate every possible error here. You could, however,
correctly specify CLASS=A or CLASS(A).
System Action: Processing for the command is
terminated.
System Programmer Response: Examine the text
following the named keyword to ensure that no errors
were made as the command was entered. Ensure that
706 DB2 UDB for OS/390 and z/OS: Messages and Codes
Part 4. DB2 Codes
Chapter 30. Section 4. DB2 Codes . . . . . . . . . . . . . . . . 709
Chapter 31. X’C1......’ Codes . . . . . . . . . . . . . . . . . . . 711
Chapter 32. X’C2......’ Codes . . . . . . . . . . . . . . . . . . . 719
Chapter 33. X’C3......’ Codes . . . . . . . . . . . . . . . . . . . 755
Chapter 34. X’C5......’ Codes . . . . . . . . . . . . . . . . . . . 761
Chapter 35. X’C6......’ Code . . . . . . . . . . . . . . . . . . . 767
Chapter 36. X’C8......’ Codes . . . . . . . . . . . . . . . . . . . 769
Chapter 37. X’C9......’ Codes . . . . . . . . . . . . . . . . . . . 771
Chapter 38. X’D1......’ Codes . . . . . . . . . . . . . . . . . . . 805
Chapter 39. X’D3......’ Codes . . . . . . . . . . . . . . . . . . . 847
Chapter 40. X’D4......’ Codes . . . . . . . . . . . . . . . . . . . 987
Chapter 41. X’D6......’ Codes . . . . . . . . . . . . . . . . . . . 995
Chapter 42. X’D7......’ Codes . . . . . . . . . . . . . . . . . . . 997
Chapter 43. X’D9......’ Codes . . . . . . . . . . . . . . . . . . 1007
Chapter 44. X’E2......’ Codes . . . . . . . . . . . . . . . . . . 1025
Chapter 45. X’E3......’ Codes . . . . . . . . . . . . . . . . . . 1037
Chapter 46. X’E4......’ Codes . . . . . . . . . . . . . . . . . . 1055
Chapter 47. X’E5......’ Codes . . . . . . . . . . . . . . . . . . 1107
Chapter 48. X’E6......’ Codes . . . . . . . . . . . . . . . . . . 1131
Chapter 49. X’E6......’ Reason Codes . . . . . . . . . . . . . . . 1133
Chapter 50. X’E6......’ Abend Codes . . . . . . . . . . . . . . . . 1143
Chapter 51. X’E7......’ Codes . . . . . . . . . . . . . . . . . . 1147
Chapter 52. X’E8......’ Codes . . . . . . . . . . . . . . . . . . 1163
Chapter 53. X’E9......’ Codes . . . . . . . . . . . . . . . . . . 1177
Chapter 54. X’F1......’ Codes . . . . . . . . . . . . . . . . . . 1179
Chapter 55. X’F3......’ Codes . . . . . . . . . . . . . . . . . . 1181
Chapter 56. X’F7......’ Codes . . . . . . . . . . . . . . . . . . 1225
© Copyright IBM Corp. 1982, 2001 707
Chapter 57. X’F9......’ Codes . . . . . . . . . . . . . . . . . . 1229
708 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 30. Section 4. DB2 Codes
This section contains DB2 abend reason codes and reason codes. In addition, this
section contains DB2 instrumentation facility interface reason codes.
Conventions used in DB2 abend reason codes are described in “Part 1.
Introduction” on page 1.
© Copyright IBM Corp. 1982, 2001 709
710 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 31. X’C1......’ Codes
makes the CONNECT call to DSNALI. Ensure that the
00C10002
CONNECT call uses a valid ECB address.
Explanation: The DB2 call attachment facility control
Problem Determination: See the Explanation above.
block (the CAB) indicated that a thread was present
when it should not have been present.
00C10201
This abend reason code is issued by the following
CSECT: DSNACA00 Explanation: The application program passed two
CONNECT calls to the call attachment facility (CAF)
User Response: Notify your system programmer.
from the same TCB. The first CONNECT could have
System Programmer Response: Collect a been either implicit or explicit.
DSNTRACE trace stream and request a SYSABEND or
This abend reason code is issued by the following
SYSUDUMP dump.
CSECT: DSNACA00
Problem Determination: This is probably a call
User Response: You can continue processing with a
attachment facility error.
corrected request.
Problem Determination: See the Explanation above.
00C10003
Explanation: The DB2 call attachment facility received
00C10202
control after a nonstandard entry that did not use the
call attachment facility language interface. Explanation: The application program passed two
OPEN commands to the call attachment facility (CAF)
This abend reason code is issued by the following
from the same TCB. The first OPEN could have been
CSECT: DSNACA00
either implicit or explicit.
User Response: Modify or repair your application so
This abend reason code is issued by the following
that DSNACA00, the main call attachment facility code
CSECT: DSNACA00.
will receive control only through the language interface.
User Response: You can continue processing with a
Problem Determination: This is probably a user error.
corrected request.
Problem Determination: See the Explanation above.
00C10004
Explanation: The call attachment facility encountered
00C10203
an error retrieving a trace message during processing of
a call attachment facility request. Explanation: A CLOSE command was issued when
there was no active OPEN.
This abend reason code is issued by the following
CSECT: DSNACA00 This abend reason code is issued by the following
CSECT: DSNACA00
User Response: Notify your system programmer.
User Response: You can continue processing with a
System Programmer Response: Collect a
corrected request.
DSNTRACE trace stream and request a SYSABEND or
SYSUDUMP dump. Problem Determination: See the Explanation above.
Problem Determination: This is probably a call
attachment facility error. 00C10204
Explanation: A DISCONNECT command was issued
00C10005 when there was no active CONNECT.
Explanation: The application program passed an ECB This abend reason code is issued by the following
address of 0 to the call attachment facility on a CSECT: DSNACA00
CONNECT call. The trace message preceding the
abend indicates whether the ECB was a start-up or User Response: You can continue processing with a
termination ECB. corrected request.
This abend reason code is issued by the following Problem Determination: See the Explanation above.
CSECT: DSNACA00
User Response: Correct the application program that
© Copyright IBM Corp. 1982, 2001 711
00C10205 • 00C12002
00C10205 00C10824
Explanation: A TRANSLATE command was issued Explanation: The CAB is reset and a new connection
when the DB2 subsystem was not connected to the call may be made.
attachment facility (CAF).
This abend reason code is issued by the following
This abend reason code is issued by the following CSECT: DSNACA70
CSECT: DSNACA00
User Response: You can continue processing.
User Response: You can continue processing with a
Problem Determination: See the Explanation
corrected request.
associated with message DSNA824I.
Problem Determination: See the Explanation above.
00C10831
00C10206
Explanation: The call attachment facility (CAF) has
Explanation: One of the following conditions exists: detected a release level incompatibility between itself
v The wrong number of parameters were issued. and DB2. Either the current CAF or DB2 release levels
v The end-of-list bit was off. do not support coexistence, or the SPE level of the
lower level release does not meet the compatibility
This abend reason code is issued by the following requirements for coexistence between the two releases.
CSECT: DSNACA00
This reason code is issued by the following CSECT:
User Response: You can continue processing with a DSNACA70
corrected request.
System Action: The connection is not successful.
Problem Determination: See the Explanation above.
User Response: If you used JCL or a TSO logon
procedure to invoke CAF, check to insure the correct
00C10207 DB2 libraries are defined in your JOBLIB and STEPLIB
allocations. See your system programmer if you invoke
Explanation: The application program passed an CAF using procedures supplied by your system
unrecognized function parameter to the call attachment programmer.
facility (CAF).
Problem Determination: If CAF trace (DSNTRACE) is
This abend reason code is issued by the following active, message DSNA831E will indicate the release
CSECT: DSNACA00 levels of CAF and the DB2 subsystem.
User Response: You can continue processing with a
corrected request. 00C12001
Problem Determination: See the Explanation above. Explanation: The DB2 RRSAF attachment facility
function AUTH SIGNON was invoked by a program that
00C10208 was not APF authorized. This condition can indicate a
security violation.
Explanation: The call attachment facility (CAF)
received requests from the same TCB to CONNECT to System Action: The application is abended.
the DB2 subsystem and to another subsystem. User Response: The AUTH SIGNON function can
This abend reason code is issued by the following only be invoked from an APF authorized program. Either
CSECT: DSNACA00 modify your program to use the RRSAF attachment
facility function SIGNON which may be invoked from a
User Response: You can continue processing with a non-authorized program, or contact your security
corrected request. administrator to make the changes required to make
Problem Determination: See the Explanation above. your program an APF authorized program.
Problem Determination: This is a user error.
00C10209 This abend reason code is issued by the following
Explanation: The call attachment facility (CAF) CSECT: DSNARA00
received an explicit call to DSNALI from a DB2 stored
procedure. This is not allowed. 00C12002
This abend reason code is issued by the following Explanation: An abend has occurred during an
CSECT: DSNACA00 attempt to access the caller-provided subsystem name
User Response: You can continue processing with a parameter while executing in the PSW key of the caller.
corrected request.
712 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C12003 • 00C12007
This is probably the result of a logic error in the “Appendix B. Problem determination” on page 1281: 1,
requesting program. 5, 49.
System Action: The application is abended.
00C12005
User Response: A dump should be taken for problem
analysis. Explanation: The DB2 RRSAF attachment facility
received control after a nonstandard entry that did not
Problem Determination: This reason code is placed
use the call attachment facility language interface.
in register 15 during any access to caller-provided
information. When any abend occurs, this register System Action: The application is abended.
indicates which parameter caused the error.
User Response: Modify or repair your application so
This abend reason code is issued by the following that DSNACA00, the main call attachment facility code,
CSECT: DSNARA00 will receive control only through the language interface.
Collect the following diagnostic items listed in Problem Determination: This is probably a user error.
“Appendix B. Problem determination” on page 1281: 1,
This abend reason code is issued by the following
5, 49.
CSECT: DSNARA00
00C12003
00C12006
Explanation: An abend has occurred during an
Explanation: An abend has occurred during an
attempt to access the caller-provided ribptr parameter
attempt to access the caller-provided termination ECB
while executing in the PSW key of the caller. This is
parameter while executing in the PSW key of the caller.
probably the result of a logic error in the requesting
This is probably the result of a logic error in the
program.
requesting program.
System Action: The application is abended.
System Action: The application is abended.
User Response: A dump should be taken for problem
User Response: A dump should be taken for problem
analysis.
analysis.
Problem Determination: This reason code is placed
Problem Determination: This reason code is placed
in register 15 during any access to caller-provided
in register 15 during any access to caller-provided
information. When any abend occurs, this register
information. When any abend occurs, this register
indicates which parameter caused the error.
indicates which parameter caused the error.
This abend reason code is issued by the following
This abend reason code is issued by the following
CSECT: DSNARA00
CSECT: DSNARA00
Collect the following diagnostic items listed in
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
“Appendix B. Problem determination” on page 1281: 1,
5, 49.
5, 49.
00C12004
00C12007
Explanation: An abend has occurred during an
Explanation: An abend has occurred during an
attempt to access the caller-provided eibptr parameter
attempt to access the caller-provided startup ECB
while executing in the PSW key of the caller. This is
parameter while executing in the PSW key of the caller.
probably the result of a logic error in the requesting
This is probably the result of a logic error in the
program.
requesting program.
System Action: The application is abended.
System Action: The application is abended.
User Response: A dump should be taken for problem
User Response: A dump should be taken for problem
analysis.
analysis.
Problem Determination: This reason code is placed
Problem Determination: This reason code is placed
in register 15 during any access to caller-provided
in register 15 during any access to caller-provided
information. When any abend occurs, this register
information. When any abend occurs, this register
indicates which parameter caused the error.
indicates which parameter caused the error.
This abend reason code is issued by the following
This abend reason code is issued by the following
CSECT: DSNARA00
CSECT: DSNARA00
Collect the following diagnostic items listed in
Collect the following diagnostic items listed in
Chapter 31. DB2 Codes 713
00C12008 • 00C12012
“Appendix B. Problem determination” on page 1281: 1, in register 15 during any access to caller-provided
5, 49. information. When any abend occurs, this register
indicates which parameter caused the error.
00C12008 This abend reason code is issued by the following
CSECT: DSNARA00
Explanation: An abend has occurred during an
attempt to access the caller-provided correlation Collect the following diagnostic items listed in
parameter while executing in the PSW key of the caller. “Appendix B. Problem determination” on page 1281: 1,
This is probably the result of a logic error in the 5, 49.
requesting program.
System Action: The application is abended. 00C12011
User Response: A dump should be taken for problem Explanation: An abend has occurred during an
analysis. attempt to access the caller-provided authid parameter
while executing in the PSW key of the caller. This is
Problem Determination: This reason code is placed
probably the result of a logic error in the requesting
in register 15 during any access to caller-provided
program.
information. When any abend occurs, this register
indicates which parameter caused the error. System Action: The application is abended.
This abend reason code is issued by the following User Response: A dump should be taken for problem
CSECT: DSNARA00 analysis.
Collect the following diagnostic items listed in Problem Determination: This reason code is placed
“Appendix B. Problem determination” on page 1281: 1, in register 15 during any access to caller-provided
5, 49. information. When any abend occurs, this register
indicates which parameter caused the error.
00C12009 This abend reason code is issued by the following
CSECT: DSNARA00
Explanation: An abend has occurred during an
attempt to access the caller-provided accounting token Collect the following diagnostic items listed in
parameter while executing in the PSW key of the caller. “Appendix B. Problem determination” on page 1281: 1,
This is probably the result of a logic error in the 5, 49.
requesting program.
System Action: The application is abended. 00C12012
User Response: A dump should be taken for problem Explanation: An abend has occurred during an
analysis. attempt to access the caller-provided secondary authid
parameter while executing in the PSW key of the caller.
Problem Determination: This reason code is placed
This is probably the result of a logic error in the
in register 15 during any access to caller-provided
requesting program.
information. When any abend occurs, this register
indicates which parameter caused the error. System Action: The application is abended.
This abend reason code is issued by the following User Response: A dump should be taken for problem
CSECT: DSNARA00 analysis.
Collect the following diagnostic items listed in Problem Determination: This reason code is placed
“Appendix B. Problem determination” on page 1281: 1, in register 15 during any access to caller-provided
5, 49. information. When any abend occurs, this register
indicates which parameter caused the error.
00C12010 This abend reason code is issued by the following
CSECT: DSNARA00
Explanation: An abend has occurred during an
attempt to access the caller-provided accounting interval Collect the following diagnostic items listed in
parameter while executing in the PSW key of the caller. “Appendix B. Problem determination” on page 1281: 1,
This is probably the result of a logic error in the 5, 49.
requesting program.
System Action: The application is abended.
User Response: A dump should be taken for problem
analysis.
Problem Determination: This reason code is placed
714 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C12013 • 00C12019
This abend reason code is issued by the following
00C12013
CSECT: DSNARA00
Explanation: An abend has occurred during an
Collect the following diagnostic items listed in
attempt to access the caller-provided ACEE parameter
“Appendix B. Problem determination” on page 1281: 1,
while executing in the PSW key of the caller. This is
5, 49.
probably the result of a logic error in the requesting
program.
00C12016
System Action: The application is abended.
Explanation: An abend has occurred during an
User Response: A dump should be taken for problem
attempt to access the caller-provided reuse parameter
analysis.
while executing in the PSW key of the caller. This is
Problem Determination: This reason code is placed probably the result of a logic error in the requesting
in register 15 during any access to caller-provided program.
information. When any abend occurs, this register
System Action: The application is abended.
indicates which parameter caused the error.
User Response: A dump should be taken for problem
This abend reason code is issued by the following
analysis.
CSECT: DSNARA00
Problem Determination: This reason code is placed
Collect the following diagnostic items listed in
in register 15 during any access to caller-provided
“Appendix B. Problem determination” on page 1281: 1,
information. When any abend occurs, this register
5, 49.
indicates which parameter caused the error.
This abend reason code is issued by the following
00C12014
CSECT: DSNARA00
Explanation: An abend has occurred during an
Collect the following diagnostic items listed in
attempt to access the caller-provided plan name
“Appendix B. Problem determination” on page 1281: 1,
parameter while executing in the PSW key of the caller.
5, 49.
This is probably the result of a logic error in the
requesting program.
00C12018
System Action: The application is abended.
Explanation: An abend has occurred during an
User Response: A dump should be taken for problem
attempt to access the caller-provided user-id parameter
analysis.
while executing in the PSW key of the caller. This is
Problem Determination: This reason code is placed probably the result of a logic error in the requesting
in register 15 during any access to caller-provided program.
information. When any abend occurs, this register
System Action: The application is abended.
indicates which parameter caused the error.
User Response: A dump should be taken for problem
This abend reason code is issued by the following
analysis.
CSECT: DSNARA00
Problem Determination: This reason code is placed
Collect the following diagnostic items listed in
in register 15 during any access to caller-provided
“Appendix B. Problem determination” on page 1281: 1,
information. When any abend occurs, this register
5, 49.
indicates which parameter caused the error.
00C12015
00C12019
Explanation: An abend has occurred during an
Explanation: An abend has occurred during an
attempt to access the caller-provided collection
attempt to access the caller-provided applname
parameter while executing in the PSW key of the caller.
parameter while executing in the PSW key of the caller.
This is probably the result of a logic error in the
This is probably the result of a logic error in the
requesting program.
requesting program.
System Action: The application is abended.
System Action: The application is abended.
User Response: A dump should be taken for problem
User Response: A dump should be taken for problem
analysis.
analysis.
Problem Determination: This reason code is placed
Problem Determination: This reason code is placed
in register 15 during any access to caller-provided
in register 15 during any access to caller-provided
information. When any abend occurs, this register
information. When any abend occurs, this register
indicates which parameter caused the error.
Chapter 31. DB2 Codes 715
00C12020 • 00C12207
indicates which parameter caused the error.
00C12203
Explanation: A TERMINATE THREAD command was
00C12020
issued when there was no active thread.
Explanation: An abend has occurred during an
User Response: You can continue processing with a
attempt to access the caller-provided ws parameter
corrected request.
while executing in the PSW key of the caller. This is
probably the result of a logic error in the requesting Problem Determination: This reason code is issued
program. by the following CSECT: DSNARA00
System Action: The application is abended.
00C12204
User Response: A dump should be taken for problem
analysis. Explanation: The application issued a function request
other than IDENTIFY when no connection with DB2
Problem Determination: This reason code is placed
existed. Only IDENTIFY may be issued when a
in register 15 during any access to caller-provided
connection does not exist.
information. When any abend occurs, this register
indicates which parameter caused the error. User Response: You can continue processing with a
corrected request.
00C12021 Problem Determination: This reason code is issued
by the following CSECT: DSNARA00
Explanation: An abnormal termination has occurred
during an attempt to access the caller-provided xid
parameter while executing in the PSW key of the caller. 00C12205
This is probably the result of a logic error in the
Explanation: The task that invoked the DB2 RRSAF
requesting program.
attachment facility function SWITCH TO has not yet
System Action: The application is abnormally identified to the DB2 subsystem specified in the request.
terminated.
System Action: The SWITCH TO function is
User Response: Correct the problem and submit your performed.
job again.
User Response: Use IDENTIFY to connect to a DB2
Problem Determination: This reason code is placed subsystem before attempting to invoke any other
in register 15 during any access to caller-provided function at the specified subsystem.
information. Register 15 indicates which parameter
Problem Determination: This reason code is issued
caused the error when any abnormal termination
by the following CSECT: DSNARA00
occurs.
00C12206
00C12201
Explanation: One of the following conditions exists:
Explanation: The application program invoked
v The wrong number of parameters were issued.
IDENTIFY while it was already connected to DB2.
v The end-of-list bit was off.
User Response: You can continue processing with a
User Response: You can continue processing with a
corrected request.
corrected request.
Problem Determination: This reason code is issued
Problem Determination: This reason code is issued
by the following CSECT: DSNARA00
by the following CSECT: DSNARA00
00C12202
00C12207
Explanation: The application program invoked the
Explanation: The application program either omitted
CREATE THREAD function request while there was
the function name parameter or passed an
already a thread created.
unrecognized function parameter to the RRSAF.
User Response: You can continue processing with a
System Action: The application is abended.
corrected request.
User Response: Modify or repair your application to
Problem Determination: This reason code is issued
pass a valid function request to RRSAF.
by the following CSECT: DSNARA00
Problem Determination: This reason code is issued
by the following CSECT: DSNARA00
716 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C12208 • 00C12823
User Response: You can continue processing with a
00C12208
corrected request.
Explanation: The application program issued an
Problem Determination: This reason code is issued
IDENTIFY function request but omitted the ribptr
by the following CSECT: DSNARA00
parameter from the parameter list. An ribptr parameter
is a required parameter on an IDENTIFY request.
00C12217
System Action: The IDENTIFY request is rejected.
Explanation: The application program issued a
User Response: You can continue processing with a
CREATE THREAD function request without having
corrected request.
completed SIGNON processing. At least one successful
Problem Determination: This reason code is issued SIGNON must be completed before a CREATE
by the following CSECT: DSNARA00 THREAD request can be issued.
User Response: You can continue processing with a
00C12209 corrected request.
Explanation: The application program issued an Problem Determination: This reason code is issued
IDENTIFY function request but omitted the eibptr by the following CSECT: DSNARA00
parameter from the parameter list. An eibptr parameter
is a required parameter on an IDENTIFY request.
00C12218
System Action: The IDENTIFY request is rejected.
Explanation: The application program issued an SQL
User Response: You can continue processing with a or IFI function request without completing SIGNON and
corrected request. CREATE THREAD processing. SQL or IFI requests
cannot be issued until SIGNON and CREATE THREAD
Problem Determination: This reason code is issued
processing is complete.
by the following CSECT: DSNARA00
User Response: You can continue processing with a
corrected request.
00C12212
Problem Determination: This reason code is issued
Explanation: The application program issued a
by the following CSECT: DSNARA00
CREATE THREAD function request and did not specify
a plan name and also did not specify a collection name.
If a plan name is not provided, then a collection name 00C12219
must be supplied.
Explanation: The application program issued an SQL
User Response: You can continue processing with a or IFI function request without completing CREATE
corrected request. THREAD processing. SQL or IFI requests cannot be
issued until CREATE THREAD processing is complete.
Problem Determination: This reason code is issued
by the following CSECT: DSNARA00 User Response: You can continue processing with a
corrected request.
00C12214 Problem Determination: This reason code is issued
by the following CSECT: DSNARA00
Explanation: The application program issued a
TRANSLATE function request but omitted the sqlca
parameter from the parameter list. An sqlca parameter 00C12822
is a required parameter on a TRANSLATE request.
Explanation: The RRSAF received an explicit call to
User Response: You can continue processing with a DSNRLI from a DB2 stored procedure. This is not
corrected request. allowed.
Problem Determination: This reason code is issued User Response: You can continue processing with a
by the following CSECT: DSNARA00 corrected request.
Problem Determination: This reason code is issued
00C12216 by the following CSECT: DSNARA00
Explanation: The application program issued an SQL
or IFI function request without a DB2 connection. SQL 00C12823
or IFI requests cannot be issued until IDENTIFY,
Explanation: An attempt was made to initiate a stored
SIGNON and CREATE THREAD processing have been
procedure for a task, but one already exists. This is not
completed.
allowed.
Chapter 31. DB2 Codes 717
00C12824 • 00C12831
User Response: You can continue processing with a
corrected request.
Problem Determination: This reason code is issued
by the following CSECT: DSNARA00
00C12824
Explanation: The previous connection to DB2 has
been terminated. Cleanup processing was performed
and the RRSAF is now ready to process additional
IDENTIFY requests.
User Response: You can continue processing, and
issue an IDENTIFY request.
Problem Determination: This reason code is issued
by the following CSECT: DSNARA00
00C12825
Explanation: An attempt was made to terminate a
stored procedure for a task, but no stored procedure
exists. This is not allowed.
User Response: You can continue processing with a
corrected request.
Problem Determination: This reason code is issued
by the following CSECT: DSNARA00
00C12831
Explanation: The release of the RRSAF code is not
compatible with the earlier release of the DB2 program.
System Action: The connection is not made.
User Response: Ensure that the release of the
RRSAF library is not later than the release of DB2 to
which you are attempting to connect.
Problem Determination: This problem can be caused
by improper DB2 data set allocation in a LOGON
procedure or CLIST.
This reason code is issued by the following CSECT:
DSNARA70
718 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 32. X’C2......’ Codes
00C20021 00C2006A
Explanation: A member of a DB2 data sharing group Explanation: DB2 was unable to perform the drain
was unable to perform a global drain because a function on an object (table space, index space, or
physical close failure occurred in a peer DB2 due to an partition) because the object was held by one or more
exceptional state or CASTOUT process failure. indoubt threads.
DSNT501I is sent to the console to report the condition.
System Action: If the problem was encountered by
System Action: A 'resource not available' return code, DB2 when trying to automatically recover a group buffer
reason code, and object name are sent back to the pool recovery pending (GRECP) object following the
requesting function. failure of a group buffer pool (GBP), then DB2 issues
message DSNB350I or DSNB351I to the console with
This returned reason code is issued by the following
this reason code indicating that the object cannot be
CSECT: DSNB1LDA
automatically recovered.
System Programmer Response: Use the DB2
00C20031
DISPLAY DB CLAIMERS command to find the indoubt
Explanation: An attempt to acquire a page latch in threads. If the threads have been left indoubt because
either shared mode or exclusive mode was rejected due DB2 or a transaction manager was unable to
to a time-out on the agent’s wait time. automatically resolve the indoubts, you can use the DB2
RECOVER INDOUBT command to resolve the indoubt
System Action: A 'resource not available' return code, thread and remove the indoubt claimer on the object
reason code, and object name are sent back to the (the DB2 RECOVER INDOUBT command should only
requesting function. be used when automatic resolution does not work).
System Programmer Response: A diagnostic dump If DSNB350I or DSNB351I messages were issued, then
with reason code 00C2010F should follow 00C20031. after you resolve the indoubt threads, recover the
This reason code is issued by the following CSECTs: GRECP objects as indicated in the ″System
DSNB1LTX, DSNB1LTS Programmer Response″ for DSNB350I or DSNB351I.
00C20069 . 00C200A1
Explanation: DB2 is unable to perform the drain Explanation: This is a DB2 internal error. The caller of
function on an object (a table space, an index space, or the buffer manager (BM) is trying to release a page
a partition) because a DB2 member in the data sharing latch that is not currently held.
group was in the process of restarting. This abend reason code is issued by the following
System Action: If the problem was encountered by CSECTs:
DB2 when trying to automatically recover a group buffer
pool recovery pending (GRECP) object following the DSNB1REL DSNB1RWI DSNIB DSNICLAP
failure of a group buffer pool (GBP), then DB2 issues DSNICUMW DSNICUR DSNIDILS DSNIDLEO
message DSNB350I or DSNB351I to the console with DSNIFFRE DSNIFNP DSNIGLOK DSNILGBW
this reason code indicating that the object cannot be DSNILREP DSNILSMG DSNIMSCU DSNIMS1W
automatically recovered. DSNIOSL2 DSNIOW DSNIPOCI DSNIRELS
DSNIRELU DSNIREPR DSNIRFNX DSNISEGD
Otherwise, a 'resource not available' return code, DSNISEGF DSNISFS DSNISFXL DSNISGAU
reason code and object name are sent back to the DSNISGFO DSNISGNS DSNISGRT DSNISGSU
requesting function. DSNT501I is sent to the console to DSNISMFO DSNISMRT DSNISMSU DSNIUPPR
report the condition. DSNIUSME DSNI1OP
System Programmer Response: If DSNB350I or
DSNB351I messages were issued, wait for the failed System Action: The requesting application process is
DB2 member to complete its restart processing and abended.
then recover the GRECP objects as indicated in the
″System Programmer Response″ for DSNB350I or Operator Response: Notify the system programmer,
DSNB351I. print the SYS1.LOGREC, and request the SVC dump.
System Programmer Response: Refer to Part 2 of
DB2 Diagnosis Guide and Reference for information on
identifying and reporting the problem.
© Copyright IBM Corp. 1982, 2001 719
00C200A2 • 00C200A5
Problem Determination: Collect the following determination” on page 1281: 1, 2, 5.
diagnostic items listed in “Appendix B. Problem
determination” on page 1281 : 1, 2, 5.
00C200A4
Explanation: This code usually indicates a problem
00C200A2
internal to DB2; however, the problem can result from
Explanation: This is a DB2 internal error. The caller of errors in other products. An unexpected reason code
the buffer manager (BM) is trying to get a page latch was returned by the media manager function when it
that is currently held on the requesting page. was invoked to process a database I/O request.
This abend reason code is issued by the following System Action: The requesting execution unit is
CSECTs: abended.
DSNB1GET DSNB1SWS DSNB1GNV DSNBLTCH User Response: Notify the system programmer and
DSNIB DSNICLAP DSNICUMW DSNICUR rerun the application.
DSNIDEFR DSNIFFRE DSNIFNP DSNIGLOK Operator Response: Notify the system programmer,
DSNILSMG DSNILSMU DSNIMS1W DSNIRELS print the SYS1.LOGREC, and request the SVC dump.
DSNIRELU DSNIREPR DSNIRFNX DSNIRNXT
DSNISEGF DSNISFS DSNISFXL DSNISGAU Problem Determination: If you suspect an error in
DSNISGFO DSNISGNS DSNISGRT DSNISMRT DB2, refer to Part 2 of DB2 Diagnosis Guide and
DSNIUSME DSNI1OP Reference for information on identifying and reporting
the problem.
System Action: The requesting application process is The unexpected media manager reason code is saved
abended. in register 8.
Operator Response: Notify the system programmer, Check the MVS console log for an IOS error message
print the SYS1.LOGREC, and request the SVC dump. indicating the type of I/O error that occurred. If an IOS
message was issued, follow the problem determination
System Programmer Response: Refer to Part 2 of directions for that message.
DB2 Diagnosis Guide and Reference for information on
identifying and reporting the problem. Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
Problem Determination: Collect the following 2, 5, 10, 12.
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 1, 2, 5. This abend reason code is issued by the following
CSECTs:
00C200A3 DSNB5COM DSNB5FOR DSNB5RAP DSNB5RDP
DSNB5PCO
Explanation: This is a DB2/MVS internal error. The
execution unit driving a buffer manager (BM)
asynchronous function, which would normally run
indefinitely, has been canceled. However, work being 00C200A5
done by the execution unit is allowed to complete
before the execution unit terminates. Explanation: Typically, this indicates a problem
internal to DB2; however, the problem can result from
This abend reason code is issued by the following errors in other products. DB2 was unable to drain a
CSECTs: pageset in preparation for page set cleanup processing.
This might be caused by one of the following:
DSNB1CMS DSNB5COM DSNB5RAP v An IRLM out-of-storage condition
v An internal error in the lock acquisition function
System Action: The affected asynchronous function is
terminated. If the affected function is the deferred write
This abend reason code is issued by the following
processor (DSNB1CMS), DB2 is abended with the
CSECT: DSNB1CFC
abend code '00C200D3'.
System Action: The execution unit driving this
Operator Response: Notify the system programmer,
function proceeds normally. The abend status is
print the SYS1.LOGREC, and request the SVC dump.
recorded in SYS1.LOGREC.
Start DB2 if it is abended.
Operator Response: Notify the system programmer
System Programmer Response: Refer to Part 2 of
and print the SYS1.LOGREC.
DB2 Diagnosis Guide and Reference for information on
identifying and reporting the problem. System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
Problem Determination: Collect the following
and Reference for information on identifying and
diagnostic items listed in “Appendix B. Problem
720 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C200A6 • 00C200AA
reporting the problem. Restart DB2. This abend reason code is issued by the following
CSECTs: DSNB1SCR, DSNB1DLK
Problem Determination: The unexpected reason
code returned by the drain functionin register 8 might
help determine the cause of the problem. If the problem 00C200A9
is caused by an unavailable DB2 resource, message
Explanation: A return code greater than 4 was
DSNT500I might also be issued.
returned by the IRLM UNLOCK request invoked by DB2
Collect the following diagnostic items listed in to release any of the following locks:
“Appendix B. Problem determination” on page 1281: 1, v SYSLGRNG or SYSLGRNX recording lock on a table
5. space
v Group buffer pool dependent conversion lock on a
00C200A6 page set or partition
Explanation: This is a DB2/MVS internal error. The v Group buffer pool start or stop lock
execution unit scheduled by the buffer manager (BM) v ALTER BUFFERPOOL lock.
subcomponent of DB2 to drive the page set cleanup
This is a DB2 or IRLM error.
function has been canceled.
System Action: The requesting execution unit is
This abend reason code is issued by the following
abended.
CSECT: DSNB1CFC
User Response: Notify the system programmer and
System Action: DB2 is abended.
rerun the application.
Operator Response: Notify the system programmer,
Operator Response: Notify the system programmer,
print the SYS1.LOGREC, and request the SVC dump.
print the SYS1.LOGREC, and request the SVC dump.
Restart DB2.
Problem Determination: Refer to Part 2 of DB2
System Programmer Response: Refer to Part 2 of
Diagnosis Guide and Reference for information on
DB2 Diagnosis Guide and Reference for information on
identifying and reporting the problem.
identifying and reporting the problem.
The unexpected IRLM reason code is saved in register
Problem Determination: Refer to similar reason code
8. It might help determine the cause of the error.
'00E50013'.
Collect the following diagnostic items listed in
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
“Appendix B. Problem determination” on page 1281: 1,
2, 5.
2, 5.
This abend reason code is issued by the following
CSECTs: DSNB1SCR, DSNB1DLK
00C200A8
Explanation: An error code other than timeout,
00C200AA
insufficient storage, or an MVS system error was
returned by the IRLM LOCK request invoked by DB2 to Explanation: This is a DB2 internal error. The caller of
acquire any of the following locks: the buffer manager (BM) is trying to change a page
v SYSLGRNG or SYSLGRNXrecording lock on a table latch type, but the requesting agent already holds this
space latch type on this page.
v Group buffer pool-dependent conversion lock on a This abend reason code is issued by the following
page set or partition CSECT: DSNBCLTH
v Group buffer pool start or stop lock System Action: The requesting application process is
v ALTER BUFFERPOOL lock abended.
This is a DB2 or IRLM internal error. Operator Response: Notify the system programmer,
print the SYS1.LOGREC, and request the SVC dump.
System Action: The requesting execution unit
abends. System Programmer Response: Refer to Part 2 of
DB2 Diagnosis Guide and Reference for information on
User Response: Notify the system programmer and
identifying and reporting the problem.
rerun the application.
Problem Determination: Collect the following
Operator Response: Notify the system programmer,
diagnostic items listed in “Appendix B. Problem
print the SYS1.LOGREC, and request the SVC dump.
determination” on page 1281: 1, 2, 5.
Problem Determination: Refer to Part 2 of DB2
Diagnosis Guide and Reference for information on
identifying and reporting the problem.
Chapter 32. DB2 Codes 721
00C200AB • 00C200B0
System Programmer Response: Refer to Part 2 of
00C200AB
DB2 Diagnosis Guide and Reference for information on
Explanation: This is a DB2 internal error. The caller of identifying and reporting the problem.
the buffer manager (BM) is trying to get another page
Problem Determination: Collect the following
latch, which would cause the total number of page
diagnostic items listed in “Appendix B. Problem
latches held by the caller to exceed the maximum
determination” on page 1281: 1, 2, 5.
allowable number of 2.
This abend reason code is issued by the following
00C200AF
CSECTs: DSNBLTCH DSNB2LTH
Explanation: This is a DB2 internal error. The caller of
System Action: The requesting application process is
the buffer manager(BM) is attempting to update a page
abended.
under the critical mode without holding an exclusive
Operator Response: Notify the system programmer, latch on the page.
print the SYS1.LOGREC, and request the SVC dump.
This abend reason code is issued by the following
System Programmer Response: Refer to Part 2 of CSECT: DSNB1SWS
DB2 Diagnosis Guide and Reference for information on
System Action: The requesting application process is
identifying and reporting the problem.
abended.
Problem Determination: Collect the following
Operator Response: Notify the system programmer,
diagnostic items listed in “Appendix B. Problem
print the SYS1.LOGREC, and request the SVC dump.
determination” on page 1281: 1, 2, 5.
System Programmer Response: Refer to Part 2 of
DB2 Diagnosis Guide and Reference for information on
00C200AD
identifying and reporting the problem.
Explanation: This is a DB2 internal error. The caller of
Problem Determination: Collect the following
the buffer manager (BM) is trying to get a page latch for
diagnostic items listed in “Appendix B. Problem
a page that belongs to one type of page set (index or
determination” on page 1281: 1, 2, 5.
data). However, the caller already holds a page latch on
another page that belongs to a different type of page
set. 00C200B0
This abend reason code is issued by the following Explanation: Typically, this indicates a problem
CSECT: DSNB2LTH internal to DB2, however the problem can result from
errors in other products. The buffer address passed by
System Action: The requesting application process is
the buffer manager (BM) invokers does not contain the
abended.
requested page. The buffer manager detected this error
Operator Response: Notify the system programmer, by comparing the information stored in the buffer control
print the SYS1.LOGREC, and request the SVC dump. block (BB) with the information passed with the buffer
manager by its invokers. The information that is
System Programmer Response: Refer to Part 2 of
compared is the page set piece block, the page number,
DB2 Diagnosis Guide and Reference for information on
and the buffer address.
identifying and reporting the problem.
This abend reason code is issued by the following
Problem Determination: Collect the following
CSECTs:
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 1, 2, 5. DSNB1REL DSNB1RWI DSNB1SWS
DSNB1GNV DSNB5COM
00C200AE
Explanation: This is a DB2 internal error. The caller of System Action: The requesting execution unit is
the buffer manager (BM) is trying to get a page latch on abended.
a page for which there are latch waiters, but no latch Operator Response: Notify the system programmer,
holders. print the SYS1.LOGREC, and request the SVC dump.
This abend reason code is issued by the following System Programmer Response: If you suspect an
CSECTs: DSNB1LTS DSNB1LTX error in DB2, refer to Part 2 of DB2 Diagnosis Guide
System Action: The requesting application process is and Reference for information on identifying and
abended. reporting the problem.
Operator Response: Notify the system programmer, Problem Determination:
print the SYS1.LOGREC, and request the SVC dump. The following general purpose registers (GPRs) contain
the indicated diagnostic information:
722 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C200B1 • 00C200B5
GPR Content buffer manager invoker is invalid. The page set piece
7 Address of the page buffer size is expressed by n, where 2 to the power of n is the
8 Address of the page set block (PB) total number of pages that can be contained within a
page set piece. This error was detected during open
Collect the following diagnostic items listed in page set processing.
“Appendix B. Problem determination” on page 1281: 1,
This abend reason code is issued by the following
2, 5, 10, 12.
CSECT: DSNB1OPS.
System Action: The requesting execution unit is
00C200B1
abended.
Explanation: This is a DB2 internal error. Either the
Operator Response: Notify the system programmer,
buffer manager (BM) subcomponent of DB2 is unable to
print the SYS1.LOGREC, and request the SVC dump.
locate the requesting page in the buffer pool or the
invoker of the buffer manager is attempting to decrease System Programmer Response: Refer to Part 2 of
the buffer use count which is already 0. DB2 Diagnosis Guide and Reference for information on
identifying and reporting the problem.
This abend reason code is issued by the following
CSECTs: Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
DSNB1REL DSNB1RWI DSNB1SWS determination” on page 1281: 1, 2, 5.
System Action: The requesting execution unit is 00C200B4
abended.
Explanation: This is a DB2 internal error. The buffer
Operator Response: Notify the system programmer, manager (BM) subcomponent of DB2 is unable to open
print the SYS1.LOGREC, and request the SVC dump. a page set required by the requesting function. The
System Programmer Response: Refer to Part 2 of highest page set piece number passed by the buffer
DB2 Diagnosis Guide and Reference for information on manager invoker exceeds the maximum value allowed.
identifying and reporting the problem. The maximum number of data sets that can be defined
for a given page set is dependent on the page set piece
Problem Determination: Collect the following size. This error was detected during open page set
diagnostic items listed in “Appendix B. Problem processing.
determination” on page 1281: 1, 2, 5.
This abend reason code is issued by the following
CSECT: DSNB1OPS
00C200B2
System Action: The requesting execution unit is
Explanation: This is a DB2 internal error. The buffer’s abended.
write intent count is already 0 and the buffer manager
(BM) invoker is attempting to decrease it. Operator Response: Notify the system programmer,
print the SYS1.LOGREC, and request the SVC dump.
This abend reason code is issued by the following
CSECT: DSNB1RWI System Programmer Response: Refer to Part 2 of
DB2 Diagnosis Guide and Reference for information on
System Action: The requesting execution unit is identifying and reporting the problem.
abended.
Problem Determination: Collect the following
Operator Response: Notify the system programmer, diagnostic items listed in “Appendix B. Problem
print the SYS1.LOGREC, and request the SVC dump. determination” on page 1281: 1, 2, 5.
System Programmer Response: Refer to Part 2 of
DB2 Diagnosis Guide and Reference for information on 00C200B5
identifying and reporting the problem.
Explanation: This is a DB2 internal error. The buffer
Problem Determination: Collect the following manager (BM) subcomponent of DB2 is unable to open
diagnostic items listed in “Appendix B. Problem a page set required by the requesting function. During
determination” on page 1281: 1, 2, 5. the open page set processing, the page set options
passed by the buffer manager invoker were in conflict
with the same page set that was opened earlier. The
00C200B3
page set options are the writing protocol (SYSTEM or
Explanation: This is a DB2 internal error. The buffer UW), the recovery option (recoverable or
manager (BM) subcomponent of DB2 is unable to open unrecoverable), and the page size.
a page set required by the requesting function. The
This abend reason code is issued by the following
page size or the page set piece size passed by the
CSECT: DSNB1OFA
Chapter 32. DB2 Codes 723
00C200B6 • 00C200BB
System Action: The requesting execution unit is Problem Determination: Collect the following
abended. diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 1, 2, 5, 10, 12.
Operator Response: Notify the system programmer,
print the SYS1.LOGREC, and request the SVC dump.
00C200B8
System Programmer Response: Refer to Part 2 of
DB2 Diagnosis Guide and Reference for information on Explanation: This is a DB2 internal error. DB2 is
identifying and reporting the problem. unable to update the SYSLGRNG or SYSLGRNXpage
set. The utility returned an unexpected reason code.
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem This abend reason code is issued by the following
determination” on page 1281: 1, 2, 5. CSECT: DSNB1SWS
System Action: A 'resource not available' code is
00C200B6 returned. This reason code and the table space name
are recorded in the cursor table (CT) and made
Explanation: Typically, this indicates a problem
available to the user in the SQLCA or in messages.
internal to DB2; however, the problem can result from
errors in other products. The buffer manager (BM) System Programmer Response: Refer to Part 2 of
subcomponent of DB2 is unable to reallocate a data set DB2 Diagnosis Guide and Reference for information on
that is required after extending a data set to a new identifying and reporting the problem.
volume. The data set reallocation was requested and
Problem Determination: Collect the following
the corresponding data set was not opened. This error
diagnostic items listed in “Appendix B. Problem
was detected during open page set piece processing.
determination” on page 1281: 1, 5.
This abend reason code is issued by the following
CSECT: DSNB1OPP
00C200BA
System Action: The requesting execution unit is
Explanation: This is a DB2 internal error. DB2 has
abended.
encountered an unexpected error while attempting to
Operator Response: Notify the system programmer, access a system page of a page set.
print the SYS1.LOGREC, and request the SVC dump.
This abend reason code is issued by the following
System Programmer Response: If you suspect an CSECTs: DSNB1CPP, DSNB1OPP
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
System Action: The requesting execution unit is
and Reference for information on identifying and
abended. The SVC dump and the SYS1.LOGREC
reporting the problem.
recording are requested.
Problem Determination: Collect the following
Operator Response: Notify the system programmer,
diagnostic items listed in “Appendix B. Problem
print the SYS1.LOGREC and the SVC dump.
determination” on page 1281: 1, 2, 5, 10, 12.
System Programmer Response: Refer to Part 2 of
DB2 Diagnosis Guide and Reference for failure for
00C200B7
information on identifying and reporting the problem.
Explanation: Typically, this indicates a problem
Problem Determination: Collect the following
internal to DB2; however, the problem can result from
diagnostic items listed in “Appendix B. Problem
errors in other products. The buffer manager (BM)
determination” on page 1281: 1, 2, 5.
subcomponent of DB2 is unable to open a page set
required by the requesting function. The linear page set
was not formatted contiguously. This error was detected 00C200BB
during open page set processing.
Explanation: This is a DB2 internal error to indicate
This abend reason code is issued by the following that an invalid buffer pool ID is specified.
CSECT: DSNB1OPS
This abend reason code is issued by the following
System Action: The requesting execution unit is CSECT: DSNBRBPA
abended.
System Action: The requesting application process is
Operator Response: Notify the system programmer, abended.
print the SYS1.LOGREC, and request the SVC dump.
Operator Response: Notify the system programmer,
System Programmer Response: If you suspect an print the SYS1.LOGREC, and request the SVC dump.
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and System Programmer Response: Refer to Part 2 of
reporting the problem. DB2 Diagnosis Guide and Reference for information on
identifying and reporting the problem.
724 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C200BC • 00C200C1
Problem Determination: Collect the following System Programmer Response: Refer to Part 2 of
diagnostic items listed in “Appendix B. Problem DB2 Diagnosis Guide and Reference for information on
determination” on page 1281 : 1, 2, 5. identifying and reporting the problem.
Problem Determination: Collect the following
00C200BC diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 1, 2, 5.
Explanation: This is a DB2 internal error. The Buffer
Manager (BM) subcomponent of DB2 has discovered
that the BM invoker is attempting to release the page 00C200C0
which does not belong to the work file database.
Explanation: DB2 is unable to perform I/O processing
This abend reason code is issued by the following for the requesting function. An error code (other than a
CSECT: DSNB1REL permanent I/O error) was returned by the media
manager during the I/O backend processing.
System Action: The requesting execution unit is
abnormally terminated. System Action: The requesting execution unit is
abended.
Operator Response: Notify the system programmer,
and print the SYS1.LOGREC and the SVC dump. Operator Response: Notify the system programmer,
print the SYS1.LOGREC, and request the SVC dump.
System Programmer Response: Refer to Part 2 of
DB2 Diagnosis Guide and Reference for information on System Programmer Response: If you suspect an
identifying and reporting the problem. error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and
Problem Determination: Collect the following
reporting the problem.
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 1, 5. Problem Determination: The unexpected media
manager reason code is saved in register 8. It might
help determine the cause of the failure.
00C200BD
Check the MVS console log for an IOS error message
Explanation: This is a DB2 internal error. The caller of
indicating the type of I/O error that occurred. If an IOS
the buffer manager (BM) is still holding a page latch on
message was issued, follow the problem determination
the page which is currently being released by the
directions for that message.
application.
Collect the following diagnostic items listed in
This abend reason code is issued by the following
“Appendix B. Problem determination” on page 1281: 1,
CSECT: DSNB1REL
2, 5, 10, 12.
System Action: The requesting application process is
This abend reason code is issued by the following
abended.
CSECTs:
Operator Response: Notify the system programmer,
print the SYS1.LOGREC, and request the SVC dump. DSNB5COM DSNB5FOR DSNB5RAP DSNB5PCO
DSNB5RDP
System Programmer Response: Refer to Part 2 of
DB2 Diagnosis Guide and Reference for information on
identifying and reporting the problem.
00C200C1
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem Explanation: The page version number in the
determination” on page 1281: 1, 2, 5. database page header is outside the valid range of
values. This can be caused by one of the following:
v Copying data sets improperly from another DB2
00C200BE
subsystem.
Explanation: This is a DB2 internal error. The buffer v In a CREATE TABLESPACE statement, specifying a
manager (BM) is trying to dequeue a page latch waiter VCAT catalog name that is the same as the name of
from the wait queue, but there are no waiters. an object in another DB2 subsystem on the same
This abend reason code is issued by the following processor.
CSECTs: DSNB1CLT DSNB1ULT v Conditionally starting DB2 to a prior time with an
invalid RBA range.
System Action: The requesting application process is
abended. v Incorrect use of the REPAIR utility (modifying the
page RBA).
Operator Response: Notify the system programmer, v The page was damaged by a DB2 system error.
print the SYS1.LOGREC, and request the SVC dump.
Chapter 32. DB2 Codes 725
00C200C2 • 00C200C5
v TOD clock values are out of synch between systems System Action: The BM does not decrease the
in a Parallel Sysplex. page’s WIC as requested, and the execution unit driving
this function is abended. An SVC dump is requested
System Action: The requesting execution unit is
and the abend status is recorded in the
abended. If DSNB1SWS issues the ABEND, then it is
SYS1.LOGREC.
preceded by a DSNT500I message indicating which
page is in error and a DSNI004I message indicating the Operator Response: Notify the system programmer,
page set is put in STOPE mode. print the SYS1.LOGREC, and request the SVC dump.
Operator Response: Notify the system programmer, System Programmer Response: Refer to Part 2 of
print the SYS1.LOGREC, and request the SVC dump. DB2 Diagnosis Guide and Reference for information on
identifying and reporting the problem.
User Response: One of the following:
v If the data set was copied from another DB2 Problem Determination: Collect the following
subsystem, run DSN1COPY with the RESET option diagnostic items listed in “Appendix B. Problem
to set the log RBAs in each page to 0. determination” on page 1281: 1, 2, 5, 13, 19, 33.
v If a table space was created with the wrong VCAT
catalog name, drop the object and create it again. 00C200C3
v If DB2 was conditionally started with an invalid RBA Explanation: This is a DB2 internal error. The buffer
range, correct the RBA range and restart DB2 with manager (BM) subcomponent of DB2 discovered that
conditions again. the BM invoker is attempting to set the page’s write
v If the page was damaged by the REPAIR utility, intent count (WIC), but the invoker has no read intent
restore it with the RECOVER utility using the PAGE request outstanding.
option.
This abend reason code is issued by the following
v If you are running data sharing, check the CSECT: DSNB1SWS
connectivity of the systems to the sysplex timers. The
TOD clock values of all systems in the sysplex System Action: The BM does not increase the page’s
should all be within one microsecond. TOD clock WIC as requested, and the execution unit driving this
values will not drift more than one microsecond apart function is abended. An SVC dump is requested and
unless a sysplex timer is malfunctioning. the abend status is recorded in the SYS1.LOGREC.
v Otherwise, inform your system programmer that you Operator Response: Notify the system programmer,
suspect an error. print the SYS1.LOGREC, and request the SVC dump.
Problem Determination: If you suspect an error in System Programmer Response: Refer to Part 2 of
DB2, refer to Part 2 of DB2 Diagnosis Guide and DB2 Diagnosis Guide and Reference for information on
Reference for information on identifying and reporting identifying and reporting the problem.
the problem.
Problem Determination: Collect the following
The following general purpose registers (GPRs) contain diagnostic items listed in “Appendix B. Problem
the indicated diagnostic information: determination” on page 1281: 1, 2, 5, 19, 33.
GPR Content
7 Address of the page buffer 00C200C5
8 Address of the page set block (PB)
Explanation: This is a DB2 internal error. The buffer
manager (BM) subcomponent of DB2 discovered that its
Collect the following diagnostic items listed in
invoker was attempting to decrease the write
“Appendix B. Problem determination” on page 1281: 1,
dependency count (WDC) for a buffer. However, the
2, 5, 13, 33.
buffer contains database updates that have not yet
been written back to DASD. The buffer manager makes
This abend reason code is issued by the following
the buffer available for reassignment.
CSECT: DSNB1SWS.
This abend reason code is issued by the following
CSECTs: DSNB1REL DSNB1RWI
00C200C2
System Action: The buffer manager does not
Explanation: This is a DB2 internal error. The buffer
decrease the WDC as requested, and the execution unit
manager (BM) subcomponent of DB2 has discovered
driving this function proceeds normally. An SVC dump is
that the BM invoker is attempting to decrease the
requested and the abend status is recorded in
page’s write intent count (WIC), but the invoker has no
SYS1.LOGREC.
write intent request outstanding.
Operator Response: Notify the system programmer,
This abend reason code is issued by the following
print the SYS1.LOGREC, and request the SVC dump.
CSECT: DSNB1RWI
726 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C200C6 • 00C200CB
System Programmer Response: Refer to Part 2 of
00C200C8
DB2 Diagnosis Guide and Reference for information on
identifying and reporting the problem. Explanation: A return code greater than 4 was
returned by the IRLM UNLOCK request invoked to
Problem Determination: Collect the following
release a open lock after completing a physical open or
diagnostic items listed in “Appendix B. Problem
close.
determination” on page 1281: 1, 2, 5, 13, 19, 33.
This abend reason code is issued by the following
CSECT: DSNB1ULK
00C200C6
System Action: The requesting execution unit is
Explanation: This is a DB2 internal error. The buffer
abended.
manager (BM) subcomponent of DB2 has discovered
that the BM invoker is attempting to release a page that User Response: Rerun the application.
was not held by the invoker or the page has an
Operator Response: Print the SYS1.LOGREC and
unbalanced write intent (for example, reset write intent
request the SVC dump.
has not yet been issued prior to releasing the page).
System Programmer Response: If you suspect an
This abend reason code is issued by the following
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
CSECTs: DSNB1REL DSNB1RWI
and Reference for information on identifying and
System Action: The BM does not release the page as reporting the problem.
requested, and the execution unit driving this function
Problem Determination: The unexpected IRLM
terminates abnormally. An SVC dump is requested and
reason code is saved in register 8. It may help
the abend status is recorded in the SYS1.LOGREC.
determine the cause of the error.
Operator Response: Notify the system programmer,
Collect the following diagnostic items listed in
print the SYS1.LOGREC, and request the SVC dump.
“Appendix B. Problem determination” on page 1281: 1,
System Programmer Response: Refer to Part 2 of 2, 5.
DB2 Diagnosis Guide and Reference for information on
identifying and reporting the problem.
00C200C9
Problem Determination: Collect the following
Explanation: The buffer manager (BM) subcomponent
diagnostic items listed in “Appendix B. Problem
of DB2 discovered a damaged PBG control block while
determination” on page 1281: 1, 2, 5, 13, 19, 33.
attempting to write a check point log record.
This abend reason code is issued by the following
00C200C7
CSECT: DSNB1CHK
Explanation: An error code, other than timeout,
System Action: DB2 is abended.
insufficient storage, or MVS system error, was returned
by the IRLM LOCK request. The IRLM LOCK request Operator Response: Notify the system programmer,
was invoked to acquire an open lock to perform a print the SYS1.LOGREC, and request the SVC dump.
physical open or close. Restart DB2.
This abend reason code is issued by the following System Programmer Response: If you suspect an
CSECT: DSNB1LCK error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and
System Action: The requesting execution unit is
reporting the problem.
abended.
Problem Determination: Collect the following
User Response: Rerun the application.
diagnostic items listed in “Appendix B. Problem
Operator Response: Print the SYS1.LOGREC and determination” on page 1281: 1, 2, 5, 33.
request the SVC dump.
System Programmer Response: If you suspect an 00C200CB
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
Explanation: The buffer manager (BM) subcomponent
and Reference for information on identifying and
of DB2 discovered a damaged ABG or AB control block
reporting the problem.
while attempting to write a checkpoint.
Problem Determination: The unexpected IRLM
This abend reason code is issued by the following
reason code is saved in register 8. It may help
CSECT: DSNB1CHK
determine the cause of the error.
System Action: DB2 is abnormally terminated; if
Collect the following diagnostic items listed in
processing were to continue, an invalid checkpoint
“Appendix B. Problem determination” on page 1281: 1,
2, 5.
Chapter 32. DB2 Codes 727
00C200CC • 00C200D1
would be created which would damage data on a in register 8. It might help determine the cause of the
subsequent DB2 restart. error.
Operator Response: Notify the system programmer, Collect the following diagnostic items listed in
print the SYS1.LOGREC, and request the SVC dump. “Appendix B. Problem determination” on page 1281: 1,
Restart DB2. 2, 5.
System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide 00C200CF
and Reference for information on identifying and
Explanation: DB2 could not acquire enough virtual
reporting the problem.
storage for allocating private buffers for an internal
Problem Determination: Collect the following castout process. The castout operation is queued until
diagnostic items listed in “Appendix B. Problem an existing castout process becomes available.
determination” on page 1281: 1, 5.
System Action: The requesting execution unit is
abended. No dump is produced.
00C200CC
Problem Determination: This abend reason code is
Explanation: The buffer manager (BM) subcomponent issued by the following CSECT: DSNB5PCO
of DB2 discovered a close task has been waiting for
prefetch to complete for two checkpoints.
00C200D0
This abend reason code is issued by the following
Explanation: The buffer manager (BM) subcomponent
CSECT: DSNB1CHK
of DB2 is unable to perform I/O processing for the
System Action: An SVC dump is produced and requesting function. A prior abend has occurred in the
checkpointing continues. buffer manager (BM) I/O termination exit routine. Retry
of the prior abend is not allowed by MVS.
Operator Response: Notify the system programmer,
print the SYS1.LOGREC, and request the SVC dump. This abend reason code is issued by the following
CSECT: DSNB5UTX
System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide System Action: DB2 is abended.
and Reference for information on identifying and
Operator Response: Notify the system programmer,
reporting the problem.
print the SYS1.LOGREC, and request the SVC dump.
Problem Determination: Collect the following Restart DB2.
diagnostic items listed in “Appendix B. Problem
System Programmer Response: If you suspect an
determination” on page 1281: 1, 2, 5.
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and
00C200CD reporting the problem.
Explanation: This usually indicates a problem internal Problem Determination: The functional recovery
to DB2. However, the problem can result from errors in routine (FRR) parameter list was recorded in the SDWA
other products. An unexpected reason code was variable recording area (VRA) when the original abend
returned by the Asynchronous Data Mover Facility when occurred. Examine the VRA to determine whether the
it was called to move a set of pages between the virtual media manager request block (MMRB) is properly
buffer pool and the hiperpool. passed by the media manager.
This abend reason code is issued by the following If you suspect an error in DB2, refer to Part 2 of DB2
CSECT: DSNB1GHP Diagnosis Guide and Reference for information on
identifying and reporting the problem.
System Action: The page-move operation is
terminated. An SVC dump is requested and the abend Collect the following diagnostic items listed in
status is recorded in SYS1.LOGREC. “Appendix B. Problem determination” on page 1281: 1,
2, 5.
Operator Response: Notify the system programmer,
print the SYS1.LOGREC, and request the SVC dump.
00C200D1
System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide Explanation: The buffer manager (BM) subcomponent
and Reference for information on identifying and of DB2 is unable to perform I/O processing for the
reporting the problem. requesting function. A prior abend has occurred in the
buffer manager I/O termination exit routine. An attempt
Problem Determination: The unexpected
to retry and to continue main line processing (after
Asynchronous Data Mover Facility reason code is saved
completion of processing of this prior abend) resulted in
728 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C200D2 • 00C200D5
recursion to the I/O termination exit routine’s functional
00C200D3
recovery routine (FRR).
Explanation: A prior abend occurred in a 'must
This abend reason code is issued by the following
complete' processing window of a buffer manager (BM)
CSECT: DSNB5UTX
function.
System Action: DB2 is abended.
This abend reason code is issued by the following
Operator Response: Notify the system programmer, CSECT: DSNB1RRR
print the SYS1.LOGREC, and request the SVC dump.
System Action: DB2 is abended.
Restart DB2.
Operator Response: Notify the system programmer,
Problem Determination: The FRR parameter list was
print the SYS1.LOGREC, and request the SVC dump.
recorded in the SDWA variable recording area (VRA)
Restart DB2.
when the original abend occurred. Examine the VRA to
determine whether the media manager request block System Programmer Response: If you suspect an
(MMRB) is properly passed by the media manager. error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and
If you suspect an error in DB2, refer to Part 2 of DB2
reporting the problem.
Diagnosis Guide and Reference for information on
identifying and reporting the problem. Problem Determination: See the Problem
Determination section of the original abend code.
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1, Collect the following diagnostic items listed in
2, 5. “Appendix B. Problem determination” on page 1281: 1,
2, 5.
00C200D2
00C200D4
Explanation: The buffer manager (BM) subcomponent
of DB2 is unable to perform I/O processing for the Explanation: A prior abend occurred in an I/O
requesting function. A prior abend has occurred in the processing window of a buffer manager (BM) function.
buffer manager I/O error exit routine during processing I/O functional recovery cannot be reliably performed
of a database I/O error. because the tracking data required to do so is
incomplete. The required data is probably missing
This abend reason code is issued by the following
because the functional recovery routine (FRR) that is
CSECT: DSNB5UEX
protecting the abending I/O processing function was
System Action: DB2 is abended. bypassed by MVS.
Operator Response: Notify the system programmer, This abend reason code is issued by the following
print the SYS1.LOGREC, and request the SVC dump. CSECT: DSNB1RRR
Restart DB2.
System Action: DB2 is abended.
System Programmer Response: If you suspect an
Operator Response: Notify the system programmer,
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and print the SYS1.LOGREC and the SVC dump.
and Reference for information on identifying and
Restart DB2.
reporting the problem.
System Programmer Response: If you suspect an
Problem Determination: The functional recovery
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
routine (FRR) parameter list was recorded in the SDWA
and Reference for information on identifying and
variable recording area (VRA) when the original abend
reporting the problem.
occurred. Examine the VRA to determine whether the
media manager request block (MMRB) is properly Problem Determination: See the Problem
passed by the media manager. If you suspect an error Determination section of the original abend code.
in DB2, refer to Part 2 of DB2 Diagnosis Guide and
Collect the following diagnostic items listed in
Reference for information on identifying and reporting
“Appendix B. Problem determination” on page 1281: 1,
the problem.
2, 5.
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
00C200D5
2, 5.
Explanation: An abend occurred in the I/O termination
exit routine while resuming the suspended execution
unit. The status of resume was 'indoubt' at the time of
the abend.
Chapter 32. DB2 Codes 729
00C200D6 • 00C200E0
This abend reason code is issued by the following This abend reason code is issued by the following
CSECT: DSNB5UTX CSECT: DSNB1RRR
System Action: DB2 is abended. System Action: DB2 is abended.
Operator Response: Notify the system programmer, Operator Response: Notify the system programmer,
print the SYS1.LOGREC, and request the SVC dump. print the SYS1.LOGREC, and request the SVC dump.
Restart DB2. If you suspect an error in DB2, refer to Restart DB2.
Part 2 of DB2 Diagnosis Guide and Reference for
System Programmer Response: If you suspect an
information on identifying and reporting the problem.
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
Problem Determination: The functional recovery and Reference for information on identifying and
routine (FRR) parameter list was recorded in the SDWA reporting the problem.
variable recording area (VRA) when the original abend
Problem Determination: See the Problem
occurred. Examine the VRA to determine whether the
Determination section of the original abend code.
media manager request block (MMRB) is properly
passed by the media manager. If you suspect an error Collect the following diagnostic items listed in
in DB2, refer to Part 2 of DB2 Diagnosis Guide and “Appendix B. Problem determination” on page 1281: 1,
Reference for information on identifying and reporting 2, 5.
the problem.
Collect the following diagnostic items listed in 00C200D8
“Appendix B. Problem determination” on page 1281: 1,
2, 5. Explanation: This is a DB2 internal error. The buffer
manager (BM) subcomponent of DB2 discovered that
some buffer manager resources are inconsistent.
00C200D6
This abend reason code is issued by the following
Explanation: An abend occurred in the I/O termination CSECTs: DSNB5COM DSNB1CMS
exit routine while resuming the suspended execution
unit. The status of resume was 'indoubt' at the time of System Action: DB2 is abended.
the abend. Operator Response: Notify the system programmer,
This abend reason code is issued by the following print the SYS1.LOGREC, and request the SVC dump.
CSECT: DSNB5UTX Restart DB2.
System Action: DB2 is abended. System Programmer Response: Refer to Part 2 of
DB2 Diagnosis Guide and Reference for information on
Operator Response: Notify the system programmer, identifying and reporting the problem.
print the SYS1.LOGREC, and request the SVC dump.
Restart DB2. Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
System Programmer Response: If you suspect an determination” on page 1281: 1, 2, 5.
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and
reporting the problem. 00C200E0
Problem Determination: The functional recovery Explanation: A table space or index space cannot be
routine (FRR) parameter list is recorded in the SDWA accessed because DB2 is unable to create the
variable recording area (VRA) when the original abend referenced virtual buffer pool. The referenced virtual
occurred. Examine the VRA to determine whether the buffer pool size was zero, which indicates to DB2 that
media manager request block (MMRB) is properly this buffer pool should not be activated. DB2 message
passed by the media manager. If you suspect an error DSNB602I was issued to inform the operator of the
in DB2, refer to Part 2 of DB2 Diagnosis Guide and error. This reason code and the table space or index
Reference for information on identifying and reporting space name are recorded in the cursor table (CT) and
the problem. made available to the user in the SQLCA.
Collect the following diagnostic items listed in This abend reason code is issued by the following
“Appendix B. Problem determination” on page 1281: 1, CSECTs: DSNB1OPP DSNB1OPS
2, 5. System Action: An SQLCODE -904 (resource not
available) is returned to the user. The SVC dump and
00C200D7 the SYS1.LOGREC recording are not requested.
Explanation: A prior abend occurred while resuming a System Programmer Response: Analyze the virtual
suspended execution unit. The status of resume was storage content of the ssnmDBM1 address space to
'indoubt' at the time of the abend. determine further action. If appropriate, use the ALTER
TABLESPACE or ALTER INDEX statement to modify the
730 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C200E1 • 00C200E6
affected table space or index to indicate a usable buffer System Programmer Response: The error code
pool. To determine a usable buffer pool, use the returned from the dynamic allocation function was
DISPLAY BUFFERPOOL command. If necessary, use externalized in the DSNB207I message. Refer to the
the ALTER BUFFERPOOL command to activate the appropriate MVS publication for an explanation of this
failing buffer pool by setting its VPSIZE to a nonzero error code. Correct the situation, and notify the user to
value. invoke the application again.
Problem Determination: The unexpected dynamic
00C200E1 allocation return code is saved in register 8. It may help
determine the cause of the failure.
Explanation: The buffer manager (BM) subcomponent
of DB2 is unable to open a data set that is required to Collect the following diagnostic items listed in
be accessed by the requesting function. An error was “Appendix B. Problem determination” on page 1281: 1,
returned by the media manager CONNECT function, 5, 10, 12.
which was invoked to open a VSAM data set. DB2
message DSNB204I was issued to inform the operator
00C200E5
of the error condition. This reason code and the data
set name are recorded in the cursor table (CT) and Explanation: The buffer manager (BM) subcomponent
made available to the user in the SQLCA or in of DB2 is unable to perform the I/O operation on a data
messages. set that is required by the requesting function. A logical
I/O error was detected by the buffer manager I/O
This abend reason code is issued by the following
functions. The logical I/O error indicates that a
CSECT: DSNB1OST
requested page (read operation) resides within the error
System Action: A 'resource not available' code is page range of the data set. This reason code and the
returned to the user. Abend status is recorded in data set name are recorded in the cursor table (CT) and
SYS1.LOGREC. made available to the user in the SQLCA or in
messages.
Operator Response: Notify the system programmer.
This abend reason code is issued by the following
System Programmer Response: Refer to system
CSECT: DSNB1GET
message IEC161I and DB2 message DSNB204I for
assistance in determining the cause of the error. Correct System Action: A 'resource not available' code is
the situation, and notify the user to invoke the returned to the user.
application again.
User Response: Notify the system programmer.
Problem Determination: The unexpected media Invoke the application after the system programmer has
manager return code is saved in register 8. It may help corrected the error.
determine the cause of the failure.
Operator Response: Use the -DISPLAY DB command
Collect the following diagnostic items listed in to obtain the error page range. Notify the system
“Appendix B. Problem determination” on page 1281: 1, programmer.
5, 10, 12.
System Programmer Response: The error page
range can be located from the console sheet or through
00C200E2 the -DISPLAY DB command. Correct the error pages
with the recovery utility, and notify the user to invoke the
Explanation: The buffer manager (BM) subcomponent
application again. If you suspect an error in DB2, refer
of DB2 is unable to open a data set that is required by
to Part 2 of DB2 Diagnosis Guide and Reference for
the requesting function. An error was returned by the
information on identifying and reporting the problem.
dynamic allocation function that was invoked to allocate
a VSAM data set. DB2 message DSNB207I was issued Problem Determination: Collect the following
to inform the operator of the error condition. This reason diagnostic items listed in “Appendix B. Problem
code and the data set name are recorded in the cursor determination” on page 1281: 1, 10, 12.
table (CT) and made available to the user in the SQLCA
or in messages.
00C200E6
This abend reason code is issued by the following
Explanation: The buffer manager (BM) subcomponent
CSECT: DSNB1OST
of DB2 is unable to perform the I/O operation on a data
System Action: A 'resource not available' code is set that is required by the requesting function. A
returned to the user. Abend status is recorded in permanent I/O error was detected by the media
SYS1.LOGREC. manager during preformat processing. This reason code
and the data set name are recorded in the cursor table
User Response: Notify the system programmer.
(CT) and made available to the user in the SQLCA or in
Invoke the application again after the system
messages.
programmer has corrected the error.
Chapter 32. DB2 Codes 731
00C200E8 • 00C200EB
This abend reason code is issued by the following the user in the SQLCA or in messages.
CSECT: DSNB5FOR
This abend reason code is issued by the following
System Action: A 'resource not available' code is CSECTs: DSNB1GWB DSNIBMOC DSNIWKFD
returned to the user.
System Action: An SQLCODE -904 (resource not
User Response: Notify the system programmer. available) is returned to the user. The SVC dump and
Invoke the application after the system programmer has the SYS1.LOGREC recording are not requested.
corrected the error.
Operator Response: Notify the system programmer.
System Programmer Response: Recover the entire
System Programmer Response: Reduce concurrent
data set with the recovery utility, and notify the user to
activity by reducing the number of DB2 threads, or, if
invoke the application again. Refer to Part 2 of DB2
necessary, increase the size of the failing virtual buffer
Diagnosis Guide and Reference for information on
pool by using the ALTER BUFFERPOOL command.
identifying and reporting the problem.
Problem Determination: Collect the following
00C200EA
diagnostic items listed in “Appendix B. Problem
determination” on page 1281 : 1, 10, 12. Explanation: DB2 is unable to perform the drain
function on an object (a table space, an index space, or
Check the MVS console log for an IOS error message
a partition) because the object was held by other
indicating the type of I/O error that occurred. If an IOS
claimers and the drain request timed out waiting for the
message was issued, follow the problem determination
claim count to reach zero.
directions for that message.
System Action: If the problem was encountered by
DB2 when trying to automatically recover a group buffer
00C200E8
pool recovery pending (GRECP) object following the
Explanation: The virtual buffer pool (indicated in the failure of a group buffer pool (GBP), then DB2 issues
SQLCA) cannot be created because of insufficient message DSNB350I or DSNB351I to the console with
virtual storage. Message DSNB603I or DSNB605I was this reason code indicating that the object cannot be
issued to inform the operator of the error. This reason automatically recovered.
code and the buffer pool ID are recorded in the cursor
Otherwise, a 'resource not available' return and reason
table (CT) and made available to the user in the SQLCA
code are sent back to the requesting function. DB2
or in messages.
| message DSNT500I may be sent to the console. The
This abend reason code is issued by the following reason code and the object name are recorded in the
CSECTs: DSNIBMOC DSNIWKFD DSNB1ABS cursor table (CT) and made available to the user in the
DSNB1AHS DSNB1BHP DSNB1BVP DSNB1CHS SQLCA or in the message.
System Action: An SQLCODE -904 (resource not System Programmer Response: Take one of these
available) is returned to the user. The SVC dump and actions:
the SYS1.LOGREC recording are not requested. v Reevaluate the utility timeout factor on installation
Operator Response: Notify the system programmer. panel DSNTIPI and increase it, if necessary.
v Find the threads holding the object through the
System Programmer Response: Analyze the virtual
-DISPLAY DB CLAIMERS command on the object.
storage content of the ssnmDBM1 address space to
Either terminate those threads or wait until no one
determine further action. If appropriate, use the ALTER
holds the object. Then invoke the application again.
TABLESPACE or ALTER INDEX statement to indicate
use of a different buffer pool. Otherwise, use ALTER
If DSNB350I or DSNB351I messages were issued, then
BUFFERPOOL commands to balance virtual storage
after you take one of the actions above, recover the
usage for all buffer pools.
GRECP objects as indicated in the ″System
Programmer Response″ for DSNB350I or DSNB351I.
00C200E9
Explanation: A buffer could not be assigned in the 00C200EB
virtual buffer pool (indicated in the SQLCA) because all
Explanation: A data sharing group member is not able
buffers in the virtual buffer pool are in a nondisplaceable
to perform a global drain request on an object (a table
state. (Buffers are in a nondisplaceable state when they
space, an index space, or a partition). One or more
contain actively referenced pages or updated pages for
peer members in the group hold retained locks on the
which writes are pending.)
object. Message DSNT501I is sent to the console to
Message DSNB601I was issued to inform the operator report the condition.
of the error. This reason code and the buffer pool ID are
System Action: A 'resource not available' return code,
recorded in the cursor table (CT) and made available to
732 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C200EC • 00C200F1
reason code, and object name are sent back to the User Response: Notify the system programmer.
requesting function.
System Programmer Response: Refer to Part 2 of
System Programmer Response: Use the DISPLAY DB2 Diagnosis Guide and Referencefor information on
DATABASE command with the LOCKS option to display identifying and reporting the problem.
the member names owning the retained locks. You must
Reduce concurrent activity by reducing the number of
restart those subsystems to remove the 'resource
DB2 threads, or, if other VPTYPE(PRIMARY) virtual
unavailable' condition.
buffer pools exist, convert these to
Problem Determination: This reason code is issued VPTYPE(DATASPACE) to free up somessnmDBM1
by the following CSECT: DSNB1DRA address space storage.
Problem Determination: refer to Part 2 of DB2
00C200EC Diagnosis Guide and Referencefor information on
identifying and reporting the problem.
Explanation: A member of a DB2 data sharing group
was unable to perform a global drain request on an
object (a table space, an index space, or a partition). | 00C200EF
One or more peer DB2s in the group failed to drain the
object because some error occurred. Both the DB2
| Explanation: DB2 is unable to open a necessary data
running the request and the peer DB2 send DB2
| set. The data set attributes stored in the DB2 catalog
message DSNT500I to the console to report the
| are not supported by the version of DFSMS that is
problem.
| currently running.
System Action: A 'resource not available' return code,
| This reason code and the data set name are recorded
reason code and object name are sent back to the
| in the SQLCA or in messages.
requesting function. | System Action: A 'resource not available' code is
Operator Response: Notify the system programmer.
| returned to the user.
System Programmer Response: Retrieve the
| System Programmer Response: This data set cannot
DSNT501I messages from the console and analyze the
| be opened unless this DB2 is running with DFSMS
corresponding reason and error codes.
| Version 1 Release 5 or a subsequent release. The data
| set must also be associated with an extended
Problem Determination: This reason code is issued | addressability data class.
by the following CSECT: DSNB1DRA
00C200F0
00C200ED
Explanation: DB2 encountered an error on an
Explanation: DB2, in a data sharing environment, IXLCACHE request while trying to write a page to the
detected that the requested use of a type 1 index with a group buffer pool during physical lock (P-lock)
SUBPAGES value greater than 1 would have caused negotiation.
the index to become group buffer pool dependent. DB2
System Action: The requesting execution unit
does not allow type 1 indexes with a SUBPAGES value
abends. The error is recorded to SYS1.LOGREC, but
greater than 1 to become group buffer pool dependent.
the dump is suppressed and the abend is retried in the
System Action: The use of the index is not allowed. functional recovery. Another group member, requesting
the P-lock that caused the negotiation on this member,
User Response: If the index is to be used in group
receives a resource not available code of 00C20252,
buffer pool dependent mode, then either the index
and its P-lock request is denied.
should be converted to a type 2 index or it should be
converted to a type 1 index with SUBPAGES 1. Problem Determination: If you suspect an error in
DB2, refer to Part 2 of DB2 Diagnosis Guide and
Reference for information on identifying and reporting
00C200EE
the problem.
Explanation: A VPTYPE(DATASPACE) buffer could
This abend reason code is issued by the following
not be accessed for a virtual buffer pool (indicated in
CSECT: DSNB5SCM
the SQLCA) because DB2 did not have sufficient
internal ssnmDBM1 address space working storage to
access the buffer. 00C200F1
System Action: An SQLCODE -904 (resource not Explanation: The buffer manager (BM) subcomponent
available) is returned to the user. The SVC dump and of DB2 is unable to unallocate a DB2 data set. An error
the SYS1.LOGREC recording are requested. This was returned by the dynamic unallocation function that
reason code and the buffer pool ID are made available was invoked to unallocate a data set. This reason code
to the user in the SQLCA. and the data set name are recorded in the cursor table
Chapter 32. DB2 Codes 733
00C200F2 • 00C200F6
(CT) and made available to the user in the SQLCA or in
00C200F3
messages.
Explanation: DB2 is unable to obtain one of the
This abend reason code is issued by the following
following locks:
CSECT: DSNB1CST
v SYSLGRNG or SYSLGRNXrecording lock on a table
System Action: A 'resource not available' code is space
returned to the user. The SVC dump and the
v Group buffer pool dependent conversion lock on a
SYS1.LOGREC recording are requested.
page set or partition
Operator Response: Notify the system programmer. v Group buffer pool start or stop lock
System Programmer Response: If you suspect an v ALTER BUFFERPOOL lock
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
The IRLM LOCK request detected a timeout error.
and Reference for information on identifying and
reporting the problem. System Action: A 'resource not available' code is
returned to the user. This reason code and the data set
Problem Determination: The unexpected dynamic
name are recorded in the cursor table (CT) and are
unallocation reason code is saved in register 8. It may
available to the user in the SQLCA or in messages.
help determine the cause of the failure. Refer to the
appropriate MVS publication for an explanation of the User Response: Resubmit the failing application.
error code.
Problem Determination: This abend reason code is
Collect the following diagnostic items listed in issued by the following CSECTs: DSNB1SCR,
“Appendix B. Problem determination” on page 1281: 1, DSNB1DLK.
2, 5, 10, 12.
00C200F4
00C200F2
Explanation: DB2 is unable to obtain one of the
Explanation: The buffer manager (BM) subcomponent following locks:
of DB2 is unable to close a DB2 data set. An error was v SYSLGRNG or SYSLGRNXrecording lock on a table
returned by the media manager DISCONNECT function space
that was invoked to close a data set. This reason code
v Group buffer pool dependent conversion lock on a
and the data set name are recorded in the cursor table
page set or partition
(CT) and in the SQLCA or in messages.
v Group buffer pool start or stop lock
This abend reason code is issued by the following
v ALTER BUFFERPOOL lock
CSECT: DSNB1CST
The IRLM LOCK request detected an out-of-storage
System Action: A 'resource not available' code is
condition.
returned to the user. The SVC dump and the
SYS1.LOGREC recording are requested. System Action: A 'resource not available' code is
returned to the user. This reason code is recorded in
Operator Response: Notify the system programmer.
the cursor table (CT) and is available to the user in the
System Programmer Response: If you suspect an SQLCA or in messages.
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
User Response: Resubmit the failing application.
and Reference for information on identifying and
reporting the problem. Problem Determination: This abend reason code is
issued by the following CSECTs: DSNB1SCR,
Problem Determination: The unexpected media
DSNB1DLK
manager disconnect reason code is saved in register 8
and may help determine the cause of the failure. Locate
the corresponding IEC161I message in the operator 00C200F6
console sheet, and refer to the appropriate MVS
publication for assistance in determining the cause of Explanation: The buffer manager (BM) subcomponent
the error. of DB2 is unable to open a data set that is required to
be accessed by the requesting function. The data set
Collect the following diagnostic items listed in has been migrated by DFHSM and the data set must be
“Appendix B. Problem determination” on page 1281: 1, recalled before being accessed. Since the RECALL(yes)
2, 5, 10, 12. option was selected by the installation, a recall for the
migrated data set has been initiated. A recall was not
complete after the amount of time specified in the
RECALL option had elapsed.
This reason code and the data set name are recorded
in the cursor table (CT) and made available to the user
734 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C200F7 • 00C200F9
in the SQLCA or in messages. The data set name and
00C200F8
the reason code indicated are the last migrated data set
requested. Other migrated data sets within the table Explanation: The buffer manager (BM) subcomponent
space may exist. For each one that exists, a DSNT500I of DB2 is unable to perform the I/O operation on a data
message containing the data set name and reason set. A physical I/O error was detected by the buffer
code has been sent to the console. manager I/O functions.
This abend reason code is issued by the following This reason code and the data set name are recorded
CSECT: DSNB1RST in the cursor table (CT) and made available to the user
in the SQLCA or in messages.
System Action: A 'resource not available' code is
returned to the user. A DSNT500I message is sent to This abend reason code is issued by the following
the console. CSECTs: DSNB1GET DSNB5COM
User Response: After the data set has been restored, System Action: A 'resource not available' code is
rerun the application program, transaction, or query. If returned to the user. A DSNB224I message is issued,
necessary, contact the operator to find out the status of unless it has already been issued 10 times for the data
the migrated data set. set.
If the I/O is a write operation, or if the I/O is a read
00C200F7 operation performed during restart or rollback, then the
error page range of the data set is updated. A
Explanation: The page found in the buffer is not the
DSNU086E message is issued indicating the data set
page requested by the buffer manager. The buffer
name and its corresponding I/O error page range,
manager detected the error by comparing the page
unless it has already been issued 10 times for the data
number of the page returned with the requested page
set.
number. This error may be caused by one of the
following: User Response: Notify the system programmer.
v Either the VTOC or VVDS is damaged, causing Invoke the application after the system programmer has
multiple data sets to occupy the same extents on corrected the error.
DASD.
Operator Response: Use the -DISPLAY DB command
v The page was altered incorrectly by a non-DB2
to obtain the error page range. Notify the system
facility or a DB2 service aid.
programmer.
v An internal DB2 error damaged the page. The
recovery log will be required for problem System Programmer Response: The error page
determination. range can be located from the console sheet or with the
-DISPLAY DB command. Correct the error pages with
This abend reason code is issued by the following the recovery utility, and notify the user to invoke the
CSECT: DSNB1GET application again. If you suspect an error in DB2, refer
to Part 2 of DB2 Diagnosis Guide and Reference for
System Action: The requesting execution unit is
information on identifying and reporting the problem.
abended.
Problem Determination: Collect the following
Operator Response: Notify the system programmer,
diagnostic items listed in “Appendix B. Problem
print the SYS1.LOGREC, and request the SVC dump.
determination” on page 1281: 1, 10, 12.
System Programmer Response: If you suspect an
Check the MVS console log for an IOS error message
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
indicating the type of I/O error that occurred. If an IOS
and Reference for information on identifying and
message was issued, follow the problem determination
reporting the problem.
directions for that message.
Problem Determination: The following general
purpose registers (GPRs) contain the indicated
00C200F9
diagnostic information:
Explanation: DB2 is unable to open a data set that
GPR Content
the requesting function must access. The data set was
7 Address of the page buffer
migrated by HSM and must be recalled before being
8 Address of the page set block (PB)
accessed. DB2’s attempt to initiate a recall of the
migrated data set was unsuccessful.
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1, This reason code and the data set name are recorded
10, 12, 28, 29, 30. in the cursor table (CT) and made available to the user
in the SQLCA or in messages. The data set name and
the reason code indicated are the last requested
migrated data set. Other migrated data sets might exist.
For each existing data set, message DSNT500I
Chapter 32. DB2 Codes 735
00C200FA • 00C200FE
containing the data set name and reason code was sent User Response: Resubmit the failing application.
to the console.
System Action: A 'resource not available' code is 00C200FD
returned to the user. A DSNT500I message is sent to
Explanation: The buffer manager is unable to perform
the console.
the I/O operation on a data set due to an error on
User Response: Issue the HSM command page's parity flag detected by the buffer manager's I/O
(HRECALL) to restore the migrated data set. Rerun function.
your application program, transaction, or query after the
This abend reason code is issued by the following
data set is restored.
CSECT: DSNB1GET
Problem Determination: This abend reason code is
System Action: A 'resource not available' return code
issued by the following CSECT: DSNB1OST
is returned to the user. The related reason code
00C200FD, the page number, the page set name, and
00C200FA the data base name in question are recorded in the
cursor table (CT) and made available to the user in the
Explanation: The buffer manager (BM) subcomponent
SQLCA.
of DB2 is unable to obtain an open lock to perform a
physical open or close of a page set. A timeout error Operator Response: Notify the system programmer.
was detected by the IRLM LOCK request. The reason
System Programmer Response: The error page can
code and the database and page set names are
be found via SQLCA. Correct the error pages with the
recorded in the cursor table (CT). They are made
recovery utility, and notify the user to invoke the
available to the user in the SQLCA or in messages.
application again.
This abend reason code is issued by the following
If you suspect an error in DB2, refer to Part 2 of DB2
CSECT: DSNB1LCK
Diagnosis Guide and Reference for failure for
System Action: A 'resource not available' code is information on identifying and reporting the problem.
returned to the user.
Problem Determination: Collect the following
User Response: Resubmit the failing application. diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 1, 10, 12.
00C200FB
00C200FE
Explanation: The buffer manager (BM) subcomponent
of DB2 is unable to obtain an open lock to perform a Explanation: DB2 is unable to open a data set that
physical open or close of a page set. An out-of-storage the requesting function must access. The data set was
condition was detected by the IRLM LOCK request. The migrated by DFHSM and must be recalled before being
reason code and the database and page set names are accessed. Since the RECALL(no) option was selected
recorded in the cursor table (CT). They are available to by the installation, recall for the migrated data set was
the user in the SQLCA or in messages. not initiated.
This abend reason code is issued by the following This reason code and the data set name are recorded
CSECT: DSNB1LCK in the cursor table (CT) and made available to the user
in the SQLCA or in messages. The data set name and
System Action: A 'resource not available' code is
the reason code indicated are the last migrated data set
returned to the user.
requested. Other migrated data sets within the table
User Response: Resubmit the failing application. space might exist. For each existing data set, message
DSNT500I containing the data set name and reason
code has been sent to the console.
00C200FC
System Action: A 'resource not available' code is
Explanation: The buffer manager (BM) subcomponent returned to the user. A DSNT500I message is sent to
of DB2 is unable to obtain an open lock to perform a the console.
physical open or close of a page set. A system error
was detected by the IRLM LOCK request. The reason User Response: Notify the system programmer. After
code and the database and page set names are the data set is restored, rerun the application program,
recorded in the cursor table (CT). They are made transaction, or query.
available to the user in the SQLCA or in messages.
System Programmer Response: Issue the DFHSM
This abend reason code is issued by the following command (HRECALL) to restore the migrated data set.
CSECT: DSNB1LCK
Problem Determination: This abend reason code is
System Action: A 'resource not available' code is issued by the following CSECT: DSNB1OST
returned to the user.
736 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C200FF • 00C20103
owning system, which will make the header page
00C200FF
consistent with the owner’s DBD, and force this change
Explanation: An attempted open of a page set failed to DASD, making it available to other systems.
because DB2 has reached the MVS limit on concurrent
If it is a nonshared database, then the sharing attribute
open data sets.
can only be corrected via the REPAIR utility.
This reason code is issued by the following CSECT:
Problem Determination: Collect the following
DSNB1OST
diagnostic items listed in “Appendix B. Problem
System Action: A 'resource not available' (SQLCODE determination” on page 1281: 1.
-904) is returned to the user and the requested open is
not performed. This reason code and the data set name
00C20102
are recorded in the cursor table (CT) and made
available to the user in the SQLCA. A DSNB207I Explanation: A read-only system attempted to access
message is displayed on the operator console. The an inconsistent data set. This reason code and the data
SVC dump and the SYS1.LOGREC recording are not set name are made available to the user in the SQLCA
requested. or in messages.
Operator Response: Notify the system programmer. This reason code is issued by the following CSECT:
DSNB1OPP
System Programmer Response: Reduce the number
of page sets that must be kept open by DB2 by limiting System Action: A “resource not available” code is
the amount of concurrent activity. returned to the user.
Problem Determination: Collect the following User Response: Notify the system programmer.
diagnostic item from “Appendix B. Problem
determination” on page 1281: 1. System Programmer Response: On the system in
which the database is defined as ROSHARE OWNER,
perform the following tasks:
00C20101 v Use the -DISPLAY DATABASE command to insure
Explanation: The sharing attribute is inconsistent there is no exceptional state for this table space or
between the header page of a data set and the DBD. index.
This reason code and the data set name are made v Issue the -STOP DATABASE command with the
available to the user in the SQLCA or in messages. SPACENAM parameter to stop this table space or
index.
This reason code is issued by the following CSECT:
DSNB1OPP Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
System Action: A “resource not available” code is
determination” on page 1281: 1.
returned to the user.
User Response: Notify the system programmer.
00C20103
System Programmer Response: First determine
Explanation: DB2 is unable to access a data set
whether the database is shared, and whether it is
because its system page is inaccessible. This reason
owned by this system. This can be achieved by issuing
code and the data set name are available to the user in
a SELECT on the SYSIBM.SYSDATABASE catalog
the SQLCA or in messages.
table, where the database name is the database you
are checking, and by examining the ROSHARE column. This reason code is issued by the following CSECT:
DSNB1OPP
If the DB2 catalog indicates that it is a ROSHARE
OWNER database, the problem can be corrected by the System Action: A ″resource not available″ code is
REPAIR utility or the -STOP DATABASE command. The returned to the user.
-STOP DATABASE command will reformat the header
page and make it consistent with the DBD. User Response: Notify the system programmer.
If the database is ROSHARE READ on this system, System Programmer Response: Determine why the
then check the definition of the database on the owning system page is inaccessible by examining any error
system. If, on the owning system, the database is no messages that appeared on the console at the time of
longer defined as ROSHARE OWNER, then the table the error, or by issuing a -DISPLAY DATABASE
space or index should be dropped on the system on command. Take the appropriate action to correct the
which the error was detected, since the database has situation.
been altered to nonshared by the owning system. Problem Determination: Collect the following
However, if the database is defined as ROSHARE diagnostic items listed in “Appendix B. Problem
OWNER on the owning system, then issue a -STOP determination” on page 1281: 1.
DATABASE with the SPACENAM parameter from the
Chapter 32. DB2 Codes 737
00C20104 • 00C20107
and then issuing the -START DATABASE command to
00C20104
start it. The -STOP DATABASE command will reformat
Explanation: DB2 is unable to access a shared data the header page using the information retrieved from
set because it was down leveled by a DSN1COPY job, the DBD.
or a REPAIR utility with REPLACE RESET specified.
For a data set in a ROSHARE READ database, a
This reason code and the data set name are made
timestamp mismatch indicates that the table space or
available to the user in the SQLCA or in messages.
index has been dropped and re-created on the owning
This reason code is issued by the following CSECT: system, and must also be dropped and re-created on
DSNB1OPP this system.
System Action: A “resource not available” code is For a data set in a nonshared database, the timestamp
returned to the user. value in the header page can only be corrected via the
REPAIR utility.
User Response: Notify the system programmer.
Problem Determination: Collect the following
System Programmer Response: On the system in
diagnostic items listed in “Appendix B. Problem
which the database is defined as ROSHARE OWNER,
determination” on page 1281: 1.
perform the following tasks:
v Use the -DISPLAY DATABASE command to insure
there is no exceptional state for this table space or 00C20106
index. Explanation: An update was attempted on a database
v Issue the -STOP DATABASE command with the defined as ROSHARE READ. This reason code and the
SPACENAM parameter to stop this table space or data set name are made available to the user in the
index. SQLCA or in messages.
Problem Determination: Collect the following This reason code is issued by the following CSECTs:
diagnostic items listed in “Appendix B. Problem DSNB1SWS DSNB5FOR.
determination” on page 1281: 1.
System Action: A “resource not available” code is
returned to the user.
00C20105
User Response: An update operation is not allowed in
Explanation: The page set creation timestamp is this database. Check to insure that the target of the
inconsistent between the header page and the DBD. update was correct, and also that the database is
This reason code and the data set name are made defined as ROSHARE READ. If the update should
available to the user in the SQLCA or in messages. occur, then it should be issued on the system in which
the database was defined as ROSHARE OWNER.
This reason code is issued by the following CSECT:
DSNB1OPP Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
System Action: A “resource not available” is returned
determination” on page 1281: 1,
to the user.
User Response: Notify the system programmer.
00C20107
System Programmer Response: First determine
Explanation: An update was attempted in a
whether the database is shared, and whether it is
ROSHARE OWNER database, but the data set was
owned by this system. This can be achieved by issuing
opened in RO mode. This reason code and the data set
a SELECT on the SYSIBM.SYSDATABASE catalog
name are made available to the user in the SQLCA or
table, where the database name is the database you
in messages.
are checking, and examining the ROSHARE column.
This reason code is issued by the following CSECTs:
For a data set in a ROSHARE OWNER database, if the
DSNB1SWS DSNB5FOR.
failure occurs on a CREATE TABLESPACE or CREATE
INDEX, the timestamp mismatch indicates that the table System Action: A “resource not available” code is
space or index was previously dropped, but DB2 was returned to the user.
unable to delete the data set. In this case, the data set
User Response: Notify the system programmer.
must be deleted using AMS DELETE CLUSTER before
the CREATE can take place. System Programmer Response: Issue the -STOP
DATABASE command with the SPACENAM parameter
For a data set in a ROSHARE OWNER database at any
to explicitly stop this table space/index space and then
time other than CREATE TABLESPACE or CREATE
issue the -START DATABASE ACCESS(RW) command.
INDEX, the inconsistent timestamp can be corrected by
first stopping the table space or index via the -STOP Problem Determination: Collect the following
DATABASE command with the SPACENAM parameter, diagnostic items listed in “Appendix B. Problem
738 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C20108 • 00C2010C
determination” on page 1281: 1.
00C2010A
Explanation: DB2 is attempting to open a shared data
00C20108
set in a ROSHARE READ database, but the system
Explanation: An object in a ROSHARE OWNER cannot locate the data set. The table space or index
database cannot be accessed. At least one system with might already be dropped from the owning system.
the database defined as ROSHARE READ is still
System Action: A 'resource not available' code is
accessing it. This reason code and the data set name
returned to the user. This reason code and the data set
are made available to the user in the SQLCA or in
name are made available to the user in the SQLCA or
messages.
in messages.
This reason code is issued by the following CSECT:
User Response: Notify the system programmer.
DSNB1OST
System Programmer Response: Run IDCAMS
System Action: A “resource not available” code is
LISTCAT to verify the existence of this data set. Verify
returned to the user.
whether the associated table space or index exists in
User Response: Notify the system programmer. the database defined as ROSHARE OWNER. If not,
issue DROP TABLESPACE or INDEX on all systems in
System Programmer Response: Insure that there are which the database is defined as ROSHARE READ.
no systems on which the database is defined as
ROSHARE READ that are still accessing the database. Problem Determination: Collect the following
Issue the -STOP DATABASE command with the diagnostic items listed in “Appendix B. Problem
SPACENAM parameter on the ROSHARE READ determination” on page 1281: 1.
systems that are accessing the database.
This reason code is issued by the following CSECT:
Problem Determination: Collect the following DSNB1OST
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 1.
00C2010B
Explanation: DB2 is attempting to open a shared data
00C20109
set in a database defined for ROSHARE, but the data
Explanation: An object in a ROSHARE READ set cannot be accessed because it is not defined with
database cannot be accessed. The system with the SHAREOPTIONS(1,3).
database defined as ROSHARE OWNER still has RW
System Action: A 'resource not available' code is
access. This reason code and the data set name are
returned to the user. This reason code and the data set
made available to the user in the SQLCA or in
name are made available to the user in the SQLCA or
messages.
in messages.
This reason code is issued by the following CSECT:
User Response: Notify the system programmer.
DSNB1OST
System Programmer Response: Ensure that this
System Action: A “resource not available” code is
data set belongs to a shared database, and check the
returned to the user.
SHAREOPTIONS using IDCAMS LISTCAT. If so, use
User Response: Notify the system programmer. AMS ALTER SHAREOPTIONS to alter the data set to
SHAREOPTIONS(1,3), and resubmit the failing
System Programmer Response: On the system in application.
which the database is defined as ROSHARE OWNER,
perform the following tasks: Problem Determination: Collect the following
v Use the -DISPLAY DATABASE command to insure diagnostic items listed in “Appendix B. Problem
there are no exceptional states for this table space or determination” on page 1281: 1.
index. This reason code is issued by the following CSECT:
v Issue the -STOP DATABASE command with the DSNB1OST
SPACENAM parameter to stop this table space or
index.
00C2010C
Problem Determination: Collect the following
Explanation: DB2 was unable to update the high-used
diagnostic items listed in “Appendix B. Problem
RBA in the VSAM volume data set (VVDS) when it was
determination” on page 1281: 1.
ready to close a data set. VVDS must be updated to
reflect data loaded by a RECOVER, LOAD, or REORG
utility job. Message DSNB200Iis issued to the console
with the VSAM media manager return codes.
This reason code and the data set name are recorded
Chapter 32. DB2 Codes 739
00C2010D • 00C20203
in the cursor table (CT) and made available in the
00C2010F
SQLCA or in messages.
Explanation: This dump provides assistance for
This reason code is issued by the following CSECT:
diagnosing the page latch time-out problem after
DSNB1CST
00C20031 is returned as the reason code for 'resource
System Action: A ’resource not available’ code is not available'.
returned to the user. A DSNB200Imessage is issued to
System Action: The requesting execution unit is
the console. DB2 continues to close the data set.
abended to take a diagnostic dump then recovered to
User Response: Contact the system programmer. return an SQLCODE -904 (resource not available) to
Restart or rerun the RECOVER, LOAD, or REORG job the user with the 00C20031 reason code. The resource
after the system programmer corrects the error. name is also provided.
System Programmer Response: Refer to system User Response: Contact the system programmer to
messages IEC161I and DB2 message DSNB200A for determine why the resource is unavailable. Print the
assistance in determining the cause of the error. Correct SYS1.LOGREC and the SVC dump.
the condition, and notify the user to reinvoke the
This reason code is issued by the following CSECTs:
application.
DSNB1LTX, DSNB1LTS.
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
| 00C20200
determination” on page 1281: 1, 10, 11.
| Explanation: DB2 was unable to open a required
| index data set because the index was formatted
00C2010D
| incorrectly. For example, it may have been formatted as
Explanation: DB2 was unable to open a required data | a Type 1 index when the DB2 catalog indicates that it
set because an unexpected level ID was encountered. | should be Type 2.
The reason code and the data set name are made | The reason code and index data set name are made
available in the SQLCA or in messages. | available in the SQL communication area or in related
| messages.
System Action: A 'resource unavailable' code is
returned to the user. Message DSNB232I is issued to | System Action: A 'resource unavailable' code is
the console if it was not already issued for the data set. | returned to the user.
DB2 failed to open the data set.
| Operator Response: Notify the system programmer.
Operator Response: Notify the system programmer.
| System Programmer Response: Use the RECOVER
System Programmer Response: Refer to message | utility to restore the index to a consistent state.
DSNB232I for help in determining the cause of the
| Problem Determination: This reason code is issued
error. Run the utility REPAIR LEVELID or recover the
| by the following CSECT: DSNB1OPP.
table space or index, and then tell the user to rerun the
application.
00C20203
Problem Determination: This reason code is issued
by the following CSECT: DSNB1OPD Explanation: DB2 cannot connect to a group buffer
pool. The group buffer pool is not usable by this release
of DB2. This DB2 subsystem is a member of a data
00C2010E
sharing group containing DB2 members of different
Explanation: This is a DB2 internal error. DB2 release levels. A later release level of DB2 specified an
encountered a problem while trying to add a page to the option for this group buffer pool that is not supported by
logical page list (LPL). the previous DB2 releases. The presence of this option
makes the group buffer pool inaccessible to the
System Action: The requesting execution unit is previous DB2 releases.
abended.
System Action: DB2 takes the following actions:
Operator Response: Notify the system programmer,
print SYS1.LOGREC, and request an SVC dump. v Unless already issued, message DSNB301E is sent
to the console with this reason code to indicate that a
Problem Determination: Refer to Part 2 of DB2 connect failure occurred.
Diagnosis Guide and Reference for information on v SQLCODE -904 (resource not available) is returned
identifying and reporting the problem. to the user with this reason code. The resource type
This reason code is issued by the following CSECT: and resource name are also returned.
DSNB1LPL User Response: Contact the system programmer.
740 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C20204 • 00C20206
System Programmer Response: Do one of the v If DB2 tries to read a page from the group buffer pool
following: for rollback, backout, or restart and finds that the
v Issue the -ALTER GROUPBUFFERPOOL command group buffer pool is in DAP status, the following
from a DB2 that is at the later release level to actions are taken:
remove the new option so that previous release – The page is added to the logical page list (LPL)
levels of DB2 can access the group buffer pool. for the page set.
v Migrate the previous release levels to the current – Message DSNB250E is issued to the console with
release. this reason code.
Problem Determination: This reason code is issued v If DB2 tries to write a page to the group buffer pool
by the following CSECT: DSNB1GC0 and finds that the group buffer pool is in DAP status,
the following actions are taken:
– The page is added to the logical page list (LPL)
00C20204
for the page set.
Explanation: DB2 is unable to connect to a group – Message DSNB250E is issued to the console with
buffer pool because MVS detected a problem on the this reason code.
IXLCONN request.
v If DB2 detects DAP status when it tries to connect
System Action: SQLCODE -904 (resource not the group buffer pool, or if DB2 detects a group
available) and the group buffer pool name are returned buffer pool version ID mismatch after a successful
to the user. Unless already issued for the IXLCONN connection, the following actions are taken:
code, message DSNB301E, which contains this reason – The damage assessment process is triggered for
code and the IXLCONN code, is issued to the console. this group buffer pool.
User Response: Contact the system programmer. – SQLCODE -904 (resource not available) is
returned to the user with this reason code. The
Problem Determination: The reason code returned by name of the group buffer pool is also returned.
the IXLCONN request is given in message DSNB301E.
– Unless already issued, message DSNB301E,
If the connection problem was caused by insufficient which contains this reason code, is issued to the
storage in a coupling facility, tell the MVS system console.
administrator to alleviate the storage constraint problem
by making additional storage available to the involved User Response: Contact the system programmer.
coupling facility, or by changing the active MVS CFRM System Programmer Response: Message DSNB304I
administrative policy to redefine the coupling facility is issued when the group buffer pool is entered into
structure to a different coupling facility. Another DAP state and message DSNB305I is issued when the
alternative is to have the database administrator DAP status is cleared. During the damage assessment
reassign those inter-DB2 sharing page sets to a process, DB2 must determine which page sets or
different DB2 buffer pool. partitions might have had changed pages in the failed
Refer to MVS/ESA Programming: Sysplex Services coupling facility structure and thus need to be
Reference for the MVS IXLCONN reason code. recovered. Each page set/partition fitting this criteria is
entered into 'group buffer pool REBUILD pending
This abend reason code is issued by the following (GRECP)' status. A page set/partition in GRECP status
CSECT: DSNB1GC1 remains unavailable for read or update until it is
recovered.
00C20205 Problem Determination: This reason code is issued
by the following CSECT: DSNB1GC0
Explanation: DB2 is unable to access a group buffer
pool because of a damage assessment pending (DAP)
status against the group buffer pool. 00C20206
System Action: The action DB2 takes depends on the Explanation: An attempt was made to access a page
situation, as follows: which is currently in the logical page list (LPL). LPL
v If DB2 tries to read a page from the group buffer pool pages are unavailable until recovery on the affected
and finds that the group buffer pool is in DAP status, page set completes.
the following actions are taken: System Action: SQLCODE -904 (resource not
– SQLCODE -904 (resource not available) is available) is returned to the user with this reason code.
returned to the user with this reason code. The The resource name is also given.
name of the group buffer pool is also returned.
User Response: Contact the system programmer.
System Programmer Response: For those page sets
Chapter 32. DB2 Codes 741
00C20207 • 00C20220
in the LPL, use the RECOVER utility or the -START System Action: SQLCODE -904 (resource not
DATABASE command. available) is returned with this reason code. The
resource name is also given. GRECP page sets or
Problem Determination: This reason code is issued
partitions remain unavailable until recovery against the
by the following CSECTs: DSNB1LPL DSNB1GET
affected page set or partition is complete.
DSNB1SWS
User Response: Contact the system programmer to
determine when the resource will be available for use.
00C20207
System Programmer Response: Use the START
Explanation: DB2 is unable to connect to a group
DATABASE command with the ACCESS RW option to
buffer pool because of a DB2 system error during
recover the page set or partition and remove the
connect processing. This is an internal DB2 problem.
GRECP status. In extreme or unusual circumstances,
System Action: A SYS1.LOGREC entry is produced you can also remove GRECP status as follows:
and an SVC dump is requested for the original abend v RECOVER, either to currency, or to a prior point in
which caused this condition. After doing resource and time
latch recovery, DB2 retries the abend if retry is allowed. v REPAIR SET with NORCVRPEND
SQLCODE -904 (resource not available) is returned to v LOAD REPLACE
the user with this reason code and the group buffer pool v START DATABASE with ACCESS FORCE (Not
name. Unless already issued, message DSNB301E, recommended. Specifying this option can result in
which contains this reason code, is issued to the inconsistent data.)
console.
Problem Determination: This reason code is issued
Problem Determination: Refer to Part 2 of DB2 by the following CSECT: DSNB1OPP
Diagnosis Guide and Reference for information on
identifying and reporting the problem.
00C20211
This reason code is issued by the following CSECT:
Explanation: DB2 is unable to access a group buffer
DSNB1GC1
pool because the group buffer pool is rebuilding, and
the attempt to access the group buffer pool timed out
00C20208 waiting for the rebuild to complete.
Explanation: The user attempted to access a System Action: 'Resource not available' return and
group-buffer-pool-dependent page set or partition. reason codes are sent back to the requesting function.
However, the DB2 member was unable to connect to
User Response: Resubmit the request.
the group buffer pool because there was not enough
hardware system area (HSA) storage in which to System Programmer Response: Use the DB2
allocate the local cache vector (LCV). DISPLAY GROUPBUFFERPOOL command or the MVS
D XCF,STR command to monitor the status of the
System Action: DB2 disconnects from the group
rebuild. Also, monitor the status messages that the DB2
buffer pool and issues message DSNB301E with this
members issue as the rebuild progresses (refer to
reason code, if it has not yet been issued. DSNB301E
messages DSNB331I, DSNB332I, and DSNB338I). If
is usually preceded by a DSNB306I message.
the rebuild is not progressing satisfactorally, you can
SQLCODE -904 is returned to the user with this reason use the MVS command SETXCF,STOP,REBUILD to
code. stop the rebuild.
User Response: Contact the system programmer.
00C20220
System Programmer Response: Refer to message
DSNB306I. Explanation: While DB2 was accessing a group buffer
pool, MVS detected an environmental error during an
Problem Determination: IXLCACHE request from DB2.
Collect the following diagnostic items listed in System Action: The requesting execution unit
“Appendix B. Problem determination” on page 1281: 1, abends.
This reason code is issued by the following CSECT: Problem Determination: The IXLCACHE reason code
DSNB1GC1 saved in register 8 can help determine the cause of the
error. Refer to MVS/ESA Programming: Sysplex
00C20210 Services Reference for the MVS IXLCACHE reason
code.
Explanation: An attempt was made to access a page
set or partition which is currently in group buffer pool If you suspect an error in DB2, refer to Part 2 of DB2
recovery pending (GRECP) status. Diagnosis Guide and Reference for information on
identifying and reporting the problem.
742 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C20221 • 00C20230
This abend reason code is issued by the following
00C20223
CSECTs:
Explanation: DB2 encountered an error while invoking
DSNB5BPL DSNB5GGP DSNB5PCO DSNB5SCM the IXLCACHE macro.
DSNB5SCO
System Action: The requesting execution unit
abends. DB2 terminates abnormally causing MVS to
reset the castout locks.
00C20221
Problem Determination: If you suspect an error in
Explanation: While accessing a group buffer pool, DB2, refer to Part 2 of DB2 Diagnosis Guide and
DB2 received an unexpected error from MVS, which Reference for information on identifying and reporting
detected an invalid parameter on an IXLCACHE request the problem.
from DB2. This code usually indicates a DB2 internal
problem. However, the problem can result from errors in This abend reason code is issued by the following
other products. CSECT: DSNB5PCO
System Action: The requesting execution unit
abends. 00C20224
Problem Determination: The IXLCACHE reason code Explanation: DB2 received an unexpected return and
saved in register 8 can help determine the cause of the reason code from the MVS IXLFCOMP macro for a
error. Refer to MVS/ESA Programming: Sysplex group buffer pool.
Services Reference for the MVS IXLCACHE reason System Action: DB2 abends the agent and requests
code. a dump. If the group buffer pool is in duplex mode, then
If you suspect an error in DB2, refer to Part 2 of DB2 DB2 may stop duplexing for the group buffer pool in
Diagnosis Guide and Reference for information on response to this error.
identifying and reporting the problem. System Programmer Response: If the group buffer
This abend reason code is issued by the following pool was duplexed and is entered back into simplex
CSECTs: mode as a result of this error, and duplexing is not
automatically reestablished, then use the MVS SETXCF
DSNB5BPL DSNB5GGP DSNB5PCO DSNB5SCM command to enter the group buffer pool back into
DSNB5SCO duplex mode if duplexing is desired. If
DUPLEX(ENABLED) is specified in the active CFRM
policy for the group buffer pool, then the system
attempts to automatically reestablish duplexing for the
00C20222 structure.
Explanation: While accessing a page in a buffer pool, Problem Determination: See MVS/ESA
DB2 received an unexpected error from MVS, which Programming: Sysplex Services Reference for an
detected an invalid parameter on an IXLVECTR request explanation of the MVS IXLREBLD reason code.
from DB2. This code usually indicates a DB2 internal
problem. However, the problem can result from errors in Refer to Section 3 of Dianosis Guide and Reference for
other products. more information on identifying and reporting the
problem.
System Action: The requesting execution unit
abends.
00C20230
Problem Determination: See the IXLVECTR return
code in register 8 to help determine the cause of the Explanation: DB2 could not establish duplexing for a
error. Refer to MVS/ESA Programming: Sysplex group buffer pool because a coupling facility with
Services Reference for the MVS IXLVECTR reason CFLEVEL = 5 functionality was not available in which to
code. allocate the secondary group buffer pool.
If you suspect an error in DB2, refer to Part 2 of DB2 System Action: The group buffer pool is entered back
Diagnosis Guide and Reference for information on into simplex mode. Message DSNB741I is issued
identifying and reporting the problem. indicating the reason code as the reason why the
process to establish duplexing failed.
This abend reason code is issued by the following
CSECTs: System Programmer Response: Upgrade the
coupling facilities to CFLEVER = 5 or above. Or change
DSNB1LTS DSNB1LTX DSNB1RSS the PREFLIST for the group buffer pool to name only
coupling facilities that have CFLEVER = 5 functionality.
Chapter 32. DB2 Codes 743
00C20231 • 00C20255
System Action: SQLCODE -904 is returned to the
00C20231
user with this reason code. This reason code and the
Explanation: DB2 could not establish duplexing for a resource name are returned in the cursor table (CT) and
group buffer pool because the primary structure made available to the user in the SQLCA.
instance of that group buffer pool is allocated in a
Operator Response: Notify the system programmer.
coupling facility that does not have CFLEVEL = 5
functionality. System Programmer Response: IRLM exhausted the
amount of virtual storage available to it to represent
System Action: The group buffer pool is entered back
locks. Refer to code 00C90092 for methods to reduce
into simplex mode. Message DSNB741I is issued
the storage needed by IRLM.
indicating the reason code as the reason why the
process to establish duplexing failed. Problem Determination: This reason code is issued
by the following CSECT: DSNB1PER
System Programmer Response: Upgrade the
coupling facilities to CFLEVER = 5 or above. Or change
the PREFLIST for the group buffer pool to name only 00C20252
coupling facilities that have CFLEVER = 5 functionality.
Explanation: DB2 is unable to obtain a physical lock
(P-lock). Another DB2 holds the P-lock in an
00C20232 incompatible state, but is unable to downgrade because
it does not have access to the corresponding group
Explanation: DB2 could not establish duplexing for a
buffer pool.
group buffer pool because the group buffer pool is
defined with GBPCACHE(NO). DB2 does not allow System Action: SQLCODE -904 (resource not
GBPCACHE(NO) group buffer pools to be duplexed. available) is returned to the user. The other DB2
produces additional diagnostic information in the form of
System Action: The group buffer pool is entered back
messages, trace records, SYS1.LOGREC entries,
into simplex mode. Message DSNB741I is issued
and/or an SVC dump. This reason code and the
indicating the reason code as the reason why the
resource name are returned in the cursor table (CT) and
process to establish duplexing failed.
made available to the user in the SQLCA.
System Programmer Response: If duplexing is
Problem Determination: This reason code is issued
desired for the group buffer pool, issue the DB2 ALTER
by the following CSECT: DSNB1PER
GROUPBUFFERPOOL command to specify
GBPCACHE(YES) before trying to initiate duplexing.
00C20254
00C20233 Explanation: DB2 is unable to acquire or upgrade a
physical lock (P-lock) because of an incompatible
Explanation: DB2 detected a version id mismatch for
retained lock held by one or more other DB2
the secondary group buffer pool when connecting to a
subsystems in the DB2 data sharing group. Retained
duplexing group buffer pool. The version id mismatch
locks are locks that persist across DB2 abnormal
indicates that the process to establish duplexing
terminations.
completed prematurely (for example due to a system
failure), and thus the secondary group buffer pool in not System Action: SQLCODE -904 is returned to the
in synch with the primary. user. This reason code and the resource name are
returned in the cursor table (CT) and made available to
System Action: DB2 stops duplexing for the group
the user in the SQLCA.
buffer pool. The group buffer pool is entered back into
simplex mode. Message DSNB743I is issued indicating System Programmer Response: Use the -DISPLAY
the reason code as the reason why the process to DATABASE command to display the DB2 member
establish duplexing was stopped. If DUPLEX(AUTO) is names owning the retained locks. You must restart
specified for the group buffer pool in the active CFRM those subsystems to remove the 'resource unavailable'
policy, then duplexing is automatically reinitiated. condition.
System Programmer Response: If duplexing is Problem Determination: This reason code is issued
desired for the group buffer pool and duplexing is not by the following CSECT: DSNB1PER
automatically reinitiated, then use the MVS SETXCF
command to initiate duplexing for the group buffer pool.
00C20255
00C20251 Explanation: DB2 is unable to obtain a physical lock
(P-lock). This is a DB2 internal error.
Explanation: DB2 is unable to obtain a physical lock
(P-lock) because of an out-of-storage condition detected System Action: SQLCODE -904 (resource not
by IRLM. available) is returned to the user. This reason code and
the resource name are returned in the cursor table (CT)
744 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C20256 • 00C2025B
and made available to the user in the SQLCA. The System Action: SQLCODE -904 (resource not
other DB2 produces additional diagnostic information in available) is returned to the user. This reason code and
the form of messages, trace records, SYS1.LOGREC the resource name are made available to the user in the
entries and/or an SVC dump. SQLCA.
Problem Determination: Refer to Part 2 of DB2 User Response: Resubmit the failing application. The
Diagnosis Guide and Reference for information on P-lock becomes available after the peer member
identifying and reporting the problem. completes its restart processing.
This reason code is issued by the following CSECT: Problem Determination: This reason code is issued
DSNB1PER by the following CSECT: DSNB1PER
00C20256 00C20259
Explanation: DB2 is unable to obtain a physical lock Explanation: This is a DB2 internal error. This reason
(P-lock). This is a DB2 internal error. code and the group buffer pool name are recorded in
the cursor table (CT) and made available to the user in
System Action: SQLCODE -904 (resource not
the SQLCA or in messages.
available) is returned to the user. This reason code and
the resource name are returned in the cursor table (CT) System Action: A 'resource not available' code is
and made available to the user in the SQLCA. The returned to the user. Abend status is recorded in
other DB2 produces SYS1.LOGREC entries, and, SYS1.LOGREC.
depending on the type of abend, might also produce an
Operator Response: Notify the system programmer,
SVC dump.
print the SYS1.LOGREC, and request the SVC dump.
Problem Determination: Refer to Part 2 of DB2
System Programmer Response: Refer to Part 2 of
Diagnosis Guide and Reference for information on
DB2 Diagnosis Guide and Reference for information on
identifying and reporting the problem.
identifying and reporting the problem.
This reason code is issued by the following CSECT:
Problem Determination: This reason code is issued
DSNB1PER
by the following CSECT: DSNB1SCR
00C20257
00C2025A
Explanation: DB2 is unable to obtain a physical lock
Explanation: DB2 encountered an unexpected error
(P-lock) because of an 'out of record list storage'
from IRLM while trying to acquire a global lock for MBA
condition that IRLM detected. The record list is that part
(multiple buffer pool) object.
of the coupling facility lock structure that IRLM uses to
record 'modify locks' (those locks that would be retained System Action: The requesting execution unit
in case of a failure). abends. A SYS1.LOGREC entry is written and an SVC
dump is requested. Collect messages DSNT376I,
System Action: SQLCODE -904 is returned to the
DSNT500I, and DSNT501I for further diagnosis.
user with this reason code. This reason code and the
resource name are returned in the cursor table (CT) and Problem Determination: Refer to Part 2 of DB2
made available to the user in the SQLCA. Diagnosis Guide and Reference for information on
identifying and reporting the problem.
System Programmer Response: Allocate a larger
coupling facility lock structure by using the MVS This abend reason code is issued by the following
SETXCF,REBUILD command. Make sure that the active CSECTs: DSNB1BSD, DSNB1GIO, DSNB1PM2,
MVS CFRM policy specifies a larger structure size for DSNB1PMT
the IRLM coupling facility lock structure before you
initiate the rebuild. You can use the MVS
SETXCF,STOP,POLICY and SETXCF,START,POLICY 00C2025B
commands to change the active MVS CFRM policy. Explanation: DB2 encountered an unexpected error
Problem Determination: This reason code is issued while trying to read from the shared communications
by the following CSECT: DSNB1PER area (SCA) for MBA (multiple buffer pool) object.
System Action: The requesting execution unit
00C20258 abends. A SYS1.LOGREC entry is written and an SVC
dump is requested.
Explanation: DB2 is not able to obtain a physical lock
(P-lock) until a peer member restarts. Another DB2 Problem Determination: Refer to Part 2 of DB2
holds the P-lock in an incompatible state but cannot Diagnosis Guide and Reference for information on
downgrade until it completes its restart. identifying and reporting the problem.
Chapter 32. DB2 Codes 745
00C2025C • 00C20267
This abend reason code is issued by the following
00C20262
CSECTs: DSNB1BSD, DSNB1GIO, DSNB1PMT
Explanation: This is a DB2 internal error. Castout was
unsuccessful due to errors in writing a page to DASD.
00C2025C
System Action: A 'resource not available' code is
Explanation: DB2 encountered an unexpected error
returned to the user.
while trying to write to the shared communications area
(SCA) for MBA (multiple buffer pool) object. User Response: Notify the system programmer.
System Action: The requesting execution unit System Programmer Response: Refer to Part 2 of
abends. A SYS1.LOGREC entry is written and an SVC DB2 Diagnosis Guide and Reference for information on
dump is requested. identifying and reporting the problem.
Problem Determination: Refer to Part 2 of DB2 Problem Determination: This reason code is issued
Diagnosis Guide and Reference for information on by the following CSECT: DSNB5PCO
identifying and reporting the problem.
This abend reason code is issued by the following 00C20263
CSECT: DSNB1BSD, DSNB1GIO, DSNB1PM2,
Explanation: This is a DB2 internal error. Castout was
DSNB1PMT
unsuccessful due to an unexpected error.
System Action: A 'resource not available' code is
00C20260
returned to the user. An SVC dump and the
Explanation: This is a DB2 internal error. Castout was SYS1.LOGREC recording were requested.
unsuccessful because DB2 lost connectivity to the
User Response: Notify the system programmer.
group buffer pool.
System Programmer Response: Refer to Part 2 of
System Action: A 'resource not available' code is
DB2 Diagnosis Guide and Reference for information on
returned to the user.
identifying and reporting the problem.
User Response: Notify the system programmer.
Problem Determination: This reason code is issued
System Programmer Response: Establish this DB2’s by the following CSECT: DSNB5PCO
connectivity to the group buffer pool before allowing
operations that reference this group buffer pool.
00C20264
Problem Determination: Refer to Part 2 of DB2
Explanation: DB2 is unable to acquire or upgrade a
Diagnosis Guide and Reference for information on
physical lock (P-lock) because at least one other DB2
identifying and reporting the problem.
subsystem in the data sharing group is holding an
This reason code is issued by the following CSECT: incompatible retained lock. The amount of time this DB2
DSNB5PCO can wait for a locked resource was exceeded. This
reason code is only issued if the RETLWAIT installation
parameter in DSN6SPRM is set to ’YES’. If RETLWAIT
00C20261
is set to ’NO’ (this is the default), then any IRLM lock
Explanation: This is a DB2 internal error. Castout was that conflicts with a retained lock will not wait, but
unsuccessful due to a group buffer pool structure instead will be immediately rejected (see reason code
failure. 00C20254).
System Action: A 'resource not available' code is System Action: An SQLCODE -904, -911 , -913 or
returned to the user. -923 is issued, and message DSNT501I is issued. Also,
message DSNT378I is issued.
User Response: Notify the system programmer.
System Programmer Response: Refer to the
System Programmer Response: Establish this DB2’s 'System Programmer Response' in message DSNT378I.
connectivity to the group buffer pool before allowing
operations that reference this group buffer pool. Problem Determination: This reason code is issued
by the following CSECT: DSNB1PER
Problem Determination: Refer to Part 2 of DB2
Diagnosis Guide and Reference for information on
identifying and reporting the problem. 00C20267
This reason code is issued by the following CSECT: Explanation: DB2 is unable to recover GRECP status
DSNB5PCO for a table space or index because one or more sharing
group members could not perform a global drain
request on the object.
746 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C20268 • 00C202A5
System Action: A DB2 message of DSNB350 or This abend reason code is issued by the following
DSNB351 is issued. CSECT: DSNB1GD1
User Response: Issue a START DB command to
explicitly recover the page set from GRECP/LPL status. 00C202A3
System Programmer Response: Refer to the Explanation: MVS returned an unexpected error from
'System Programmer Response' in message DSNB350 an IXLFORCE request to deallocate a group buffer pool.
or DSNB351.
System Action: A SYS1.LOGREC entry is written and
an SVC dump is requested. The IXLFORCE reason
00C20268 code is saved in register 8 for SYS1.LOGREC recording
and the SVC dump.
Explanation: DB2 is unable to recover GRECP status
for a table space or index because one or more sharing System Programmer Response: Refer to MVS/ESA
group members could not perform a global drain Programming: Sysplex Services Reference for the MVS
request on the object. One or more peer DB2s in the IXLFORCE reason code.
group failed to drain the object because some error
Problem Determination: If you suspect an error in
occurred.
DB2, refer to Part 2 of DB2 Diagnosis Guide and
System Action: A DB2 message of DSNB350 or Reference for information on identifying and reporting
DSNB351 is issued. the problem.
User Response: Issue a START DB command to This abend reason code is issued by the following
explicitly recover the page set from GRECP/LPL status. CSECT: DSNB1GD1
System Programmer Response: Refer to the
'System Programmer Response' in message DSNB350 00C202A4
or DSNB351.
Explanation: MVS detected an error on an IXLCONN
request from DB2.
00C202A1
System Action: A SYS1.LOGREC entry is written and
Explanation: DB2 encountered an unexpected error an SVC dump is requested. Unless already issued,
while trying to read from or write to the shared message DSNB301E, which contains this reason code,
communications area (SCA). is issued to the console. The IXLCONN reason code is
saved in register 8 for SYS1.LOGREC recording and
System Action: The requesting execution unit
the SVC dump. This reason code and the group buffer
abends. A SYS1.LOGREC entry is written and an SVC
pool name are returned to the user in the SQLCA.
dump is requested.
System Programmer Response: Refer to MVS/ESA
Problem Determination: Refer to Part 2 of DB2
Programming: Sysplex Services Reference for the MVS
Diagnosis Guide and Reference for information on
IXLCONN reason code.
identifying and reporting the problem.
Problem Determination: If you suspect an error in
This abend reason code is issued by the following
DB2, refer to Part 2 of DB2 Diagnosis Guide and
CSECT: DSNB1GBS
Reference for information on identifying and reporting
the problem.
00C202A2
This abend reason code is issued by the following
Explanation: MVS returned an unexpected error from CSECT: DSNB1GC1
an IXLDISC request to disconnect a group buffer pool.
System Action: The requesting execution unit 00C202A5
abends. A SYS1.LOGREC entry is written and an SVC
Explanation: The cache coupling facility structure
dump is requested. The IXLDISC reason code is saved
attributes passed back by MVS on an IXLCONN request
in register 8 for SYS1.LOGREC recording and the SVC
were incorrect.
dump.
System Action: A SYS1.LOGREC entry is written.
System Programmer Response: Refer to MVS/ESA
The newly-connected group buffer pool is disconnected.
Programming: Sysplex Services Reference for the MVS
If this is a non-rebuild connect then message
IXLDISC reason code.
DSNB301E, which contains this reason code, is issued
Problem Determination: If you suspect an error in to the console (unless it has already been issued). In
DB2, refer to Part 2 of DB2 Diagnosis Guide and the message this reason code and the group buffer pool
Reference for information on identifying and reporting name are returned to the user in the SQLCA. If this is a
the problem. rebuild connect, then message DSNB330E, which
contains this reason code, is issued to the console and
Chapter 32. DB2 Codes 747
00C202A6 • 00C202AB
this reason code is used to stop the rebuild.
00C202AA
Problem Determination: Check the SYS1.LOGREC
Explanation: An error occurred in IRLM on a physical
variable recording area (VRA) for the following
lock (P-lock) or change request from DB2. This a DB2
information:
internal error.
v VRARRK30 - Error mask, set as follows:
– If bit X'40' is set, DB2 specified a structure System Action: A record is written to SYS1.LOGREC
disposition of KEEP, but the structure was not and an SVC dump is requested. SQLCODE -904 is
allocated this way. issued. This reason code and the resource name are
– If bit X'20' is set, the data element size was not returned in the SQLCA.
allocated as DB2 requested. VRARRK31 contains System Programmer Response: Examine
the requested data element size, and VRARRK32 SYS1.LOGREC for a previous error related to IRLM.
contains the allocated data element size.
– If bit X'10' is set, the allocated vector was not long Problem Determination: Refer to Part 2 of DB2
enough to cover the corresponding buffer pool. Diagnosis Guide and Reference for information on
VRARRK31 contains the requested vector length, identifying and reporting the problem.
and VRARRK32 contains the allocated vector SYS1.LOGREC contains information in the variable
length. recording area (VRA) of the system diagnostic work
area (SDWA). Significant fields in the VRA for this code
This abend reason code is issued by the following are: VRARRK13, VRARRK14, VRARRK15, VRARRK30,
CSECT: DSNB1GC1 and VRARRK33.
The information recorded with VRARRK30 is mapped
00C202A6 as follows:
Explanation: This is a DB2 internal error. Unless v IRLM return code (4 bytes)
already issued, message DSNB301E, which contains v IRLM reason code (4 bytes)
this reason code, is issued to the console. v IRLM function code (1 byte)
v Lock state (1 byte)
System Action: A SYS1.LOGREC entry is written and v Flags from RLPLFLG1 (1 byte)
an SVC dump is requested. The newly-connected group v Flags from RLPLFLG4 (1 byte)
buffer pool is disconnected. This reason code and the v Returned cached state (1 byte)
group buffer pool name are returned to the user in the v Unused (1 byte)
SQLCA. v P-lock exit reason code (2 bytes)
Problem Determination: Refer to Part 2 of DB2
Diagnosis Guide and Reference for information on VRARRK33 records information from the RLPPL
identifying and reporting the problem. (mapped by DXRRLPPL) and is mapped as follows:
v RLPHSTAT (1 byte): Current held state of the P-lock
This abend reason code is issued by the following by this DB2
CSECT: DSNB1GC1 v RLPCCSTA (1 byte): New cached state of the P-lock
for this DB2
00C202A7 v RLPRSTAT (1 byte): Requested state of the P-lock by
the other DB2 that is in conflict with the state held by
Explanation: While processing an ALTER this DB2
GROUPBUFFERPOOL command request, DB2 v Unused (1 byte)
encountered an unexpected return code from the MVS v RLPWUID (8 bytes): Owning work unit
IXCQUERY service.
System Action: The requesting execution unit This abend reason code is issued by the following
abends. A SYS1.LOGREC entry is written. An SVC CSECT: DSNB1PER
dump is requested if it appears to be a DB2 problem
(return code 8 from IXCQUERY). Command processing 00C202AB
is terminated.
Explanation: The IRLM UNLOCK request returned an
Problem Determination: If you suspect an error in error code when DB2 attempted to release a physical
DB2, refer to Part 2 of DB2 Diagnosis Guide and lock (P-lock). This is a DB2 internal error.
Reference for information on identifying and reporting
the problem. System Action: The requesting execution unit
abends. The SVC dump and SYS1.LOGREC recording
This abend reason code is issued by the following are requested.
CSECT: DSNB1AGB
User Response: Resubmit the failing application.
System Programmer Response: Request the
748 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C202AC • 00C202AE
SYS1.LOGREC and the SVC dump. v RLPHSTAT (1 byte): Current held state of the P-lock
by this DB2
Problem Determination: Refer to Part 2 of DB2
v RLPCCSTA (1 byte): New cached state of the P-lock
Diagnosis Guide and Reference for information on
for this DB2
identifying and reporting the problem.
v RLPRSTAT (1 byte): Requested state of the P-lock by
SYS1.LOGREC contains information in the variable the other DB2 that is in conflict with the state held by
recording area (VRA) of the system diagnostic work this DB2
area (SDWA). Significant fields in the VRA for this code v Unused (1 byte)
are: VRARRK13, VRARRK14, VRARRK15, VRARRK30, v RLPWUID (8 bytes): Owning work unit
and VRARRK33.
This abend reason code is issued by the following
The information recorded with VRARRK30 is mapped CSECT: DSNB1PPP
as follows:
v IRLM return code (4 bytes)
00C202AD
v IRLM reason code (4 bytes)
v IRLM function code (1 byte) Explanation: DB2 could not start even one castout
v Lock state (1 byte) process. A probable cause is that no virtual storage is
v Flags from RLPLFLG1 (1 byte) available to acquire private buffers for the castout
v Flags from RLPLFLG4 (1 byte) process.
v Returned cached state (1 byte)
System Action: The requesting execution unit abends
v Unused (1 byte)
and DB2 terminates abnormally.
v P-lock exit reason code (2 bytes)
System Programmer Response: Restart DB2 after
VRARRK33 records information from the RLPPL increasing the REGION parameter value on the
(mapped by DXRRLPPL) and is mapped as follows: ssnmDBM1 startup procedure to get more virtual
v RLPHSTAT (1 byte): Current held state of the P-lock storage.
by this DB2
Problem Determination: This abend reason code is
v RLPCCSTA (1 byte): New cached state of the P-lock
issued by the following CSECT: DSNB5PCO
for this DB2
v RLPRSTAT (1 byte): Requested state of the P-lock by
the other DB2 that is in conflict with the state held by 00C202AE
this DB2
v Unused (1 byte) Explanation: IRLM returned an invalid cached state
v RLPWUID (8 bytes): Owning work unit on a physical lock (P-lock) request from DB2. This is an
internal error.
This abend reason code is issued by the following System Action: SQLCODE -904 is issued. A record is
CSECT: DSNB1PER written to SYS1.LOGREC and an SVC dump is
requested.
00C202AC System Programmer Response: Examine
SYS1.LOGREC for a preceding error related to IRLM.
Explanation: There was an error during physical lock
(P-lock) negotiation. This is a DB2 internal error. Problem Determination: Refer to Part 2 of DB2
Diagnosis Guide and Reference for information on
System Action: An SVC dump and SYS1.LOGREC
identifying and reporting the problem.
recording are requested. A 'resource unavailable'
condition is returned to the P-lock requester that caused SYS1.LOGREC contains information in the variable
the conflict and the subsequent negotiation. recording area (VRA) of the system diagnostic work
area (SDWA). Significant fields in the VRA for this code
System Programmer Response: Request the
are: VRARRK13, VRARRK14, VRARRK15, VRARRK30,
SYS1.LOGREC and the SVC dump.
and VRARRK33.
Problem Determination: Refer to Part 2 of DB2
The information recorded with VRARRK30 is mapped
Diagnosis Guide and Reference for information on
as follows:
identifying and reporting the problem.
v IRLM return code (4 bytes)
SYS1.LOGREC contains information in the variable v IRLM reason code (4 bytes)
recording area (VRA) of the system diagnostic work v IRLM function code (1 byte)
area (SDWA). Significant fields in the VRA for this code v Lock state (1 byte)
are: VRARRK13, VRARRK14, VRARRK15, and v Flags from RLPLFLG1 (1 byte)
VRARRK33. v Flags from RLPLFLG4 (1 byte)
v Returned cached state (1 byte)
VRARRK33 records information from the RLPPL
v Unused (1 byte)
(mapped by DXRRLPPL) and is mapped as follows:
v P-lock exit reason code (2 bytes)
Chapter 32. DB2 Codes 749
00C202AF • 00C202B1
VRARRK33 records information from the RLPPL System Programmer Response: Request the
(mapped by DXRRLPPL) and is mapped as follows: SYS1.LOGREC and the SVC dump.
v RLPHSTAT (1 byte): Current held state of the P-lock
Problem Determination: Refer to Part 2 of DB2
by this DB2
Diagnosis Guide and Reference for information on
v RLPCCSTA (1 byte): New cached state of the P-lock
identifying and reporting the problem.
for this DB2
v RLPRSTAT (1 byte): Requested state of the P-lock by SYS1.LOGREC contains information in the variable
the other DB2 that is in conflict with the state held by recording area (VRA) of the system diagnostic work
this DB2 area (SDWA). Significant fields in the VRA for this code
v Unused (1 byte) are: VRARRK13, VRARRK14, VRARRK15, and
v RLPWUID (8 bytes): Owning work unit VRARRK33.
VRARRK33 records information from the RLPPL
This abend reason code is issued by the following
(mapped by DXRRLPPL) and is mapped as follows:
CSECT: DSNB1PLK
v RLPHSTAT (1 byte): Current held state of the P-lock
by this DB2
00C202AF v RLPCCSTA (1 byte): New cached state of the P-lock
for this DB2
Explanation: There was an incompatible physical lock
v RLPRSTAT (1 byte): Requested state of the P-lock by
(P-lock) held. This is a DB2 internal error.
the other DB2 that is in conflict with the state held by
System Action: An SVC dump and SYS1.LOGREC this DB2
recording are requested. A 'resource unavailable' v Unused (1 byte)
condition is returned to the P-lock requester that caused v RLPWUID (8 bytes): Owning work unit
the conflict and the subsequent negotiation.
This abend reason code is issued by the following
System Programmer Response: Request the CSECT: DSNB1PPP
SYS1.LOGREC and the SVC dump.
Problem Determination: Refer to Part 2 of DB2 00C202B1
Diagnosis Guide and Reference for information on
Explanation: An error occurred during physical
identifying and reporting the problem.
(P-lock) negotiation. This is a DB2 internal error.
SYS1.LOGREC contains information in the variable
System Action: An SQLCODE -904 is issued. A
recording area (VRA) of the system diagnostic work
record is written to SYS1.LOGREC and an SVC dump
area (SDWA). Significant fields in the VRA for this code
is requested. This reason code and the resource name
are: VRARRK13, VRARRK14, VRARRK15, and
are returned in the SQLCA.
VRARRK33.
System Programmer Response: Examine
VRARRK33 records information from the RLPPL
SYS1.LOGREC for a previous error related to IRLM.
(mapped by DXRRLPPL) and is mapped as follows:
v RLPHSTAT (1 byte): Current held state of the P-lock Problem Determination: Refer to Part 2 of DB2
by this DB2 Diagnosis Guide and Reference for information on
v RLPCCSTA (1 byte): New cached state of the P-lock identifying and reporting the problem.
for this DB2
SYS1.LOGREC contains information in the variable
v RLPRSTAT (1 byte): Requested state of the P-lock by
recording area (VRA) of the system diagnostic work
the other DB2 that is in conflict with the state held by
area (SDWA). Significant fields in the VRA for this code
this DB2
are: VRARRK13, VRARRK14, VRARRK15, VRARRK30,
v Unused (1 byte)
and VRARRK33.
v RLPWUID (8 bytes): Owning work unit
The information recorded with VRARRK30 is mapped
This abend reason code is issued by the following
as follows:
CSECT: DSNB1PPP
v IRLM return code (4 bytes)
v IRLM reason code (4 bytes)
00C202B0 v IRLM function code (1 byte)
v Lock state (1 byte)
Explanation: This is a DB2 internal error.
v Flags from RLPLFLG1 (1 byte)
System Action: An SVC dump and SYS1.LOGREC v Flags from RLPLFLG4 (1 byte)
recording are requested. A 'resource unavailable' v Returned cached state (1 byte)
condition is returned to the physical lock (P-lock) v Unused (1 byte)
requester that caused the conflict and the subsequent v P-lock exit reason code (2 bytes)
negotiation.
VRARRK33 records information from the RLPPL
User Response: Resubmit the failing application.
(mapped by DXRRLPPL) and is mapped as follows:
750 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C202B2 • 00C202B7
v RLPHSTAT (1 byte): Current held state of the P-lock System Programmer Response: Refer to Part 2 of
by this DB2 DB2 Diagnosis Guide and Reference for information on
v RLPCCSTA (1 byte): New cached state of the P-lock identifying and reporting the problem.
for this DB2
Problem Determination: This reason code is issued
v RLPRSTAT (1 byte): Requested state of the P-lock by
by the following CSECTs: DSNB1CPX, DSNB1GC0,
the other DB2 that is in conflict with the state held by
DSNB1GC1
this DB2
v Unused (1 byte)
v RLPWUID (8 bytes): Owning work unit 00C202B5
This abend reason code is issued by the following Explanation: This is a DB2 internal error. The
CSECT: DSNB1PER execution unit received an error return code while doing
damage assessment for a group buffer pool.
00C202B2 System Action: The requesting execution unit is
abended.
Explanation: DB2 could not obtain a page set or
partition physical lock (P-lock). Operator Response: Notify the system programmer,
print the SYS1.LOGREC, and request the SVC dump.
System Action: A 'resource unavailable' condition is
returned to the user. This reason code and the resource System Programmer Response: Refer to Part 2 of
name are returned in the cursor table (CT) and made DB2 Diagnosis Guide and Reference for information on
available to the user in the SQLCA. identifying and reporting the problem.
System Programmer Response: This problem might Problem Determination: This reason code is issued
be caused by having multiple DB2 release levels in the by the following CSECTs: DSNB1GC0, DSNB1GC1
DB2 data sharing group.
Problem Determination: If you suspect an error in 00C202B6
DB2, refer to Part 2 of DB2 Diagnosis Guide and
Reference for information on identifying and reporting Explanation: This is a DB2 internal error. The
the problem. execution unit received an error return code while trying
to translate the DB2 member name to a member ID.
This abend reason code is issued by the following
CSECTs: DSNB1PPP, DSNB1PPG. System Action: The requesting execution unit is
abended.
00C202B3 Operator Response: Notify the system programmer,
print the SYS1.LOGREC, and request the SVC dump.
Explanation: This is a DB2 internal error. The
execution unit encountered an error while doing damage System Programmer Response: Refer to Part 2 of
assessment for a group buffer pool. DB2 Diagnosis Guide and Reference for information on
identifying and reporting the problem.
System Action: The requesting execution unit is
abended. Problem Determination: This reason code is issued
by the following CSECTs: DSNB1DA2
Operator Response: Notify the system programmer,
print the SYS1.LOGREC, and request the SVC dump.
00C202B7
System Programmer Response: Refer to Part 2 of
DB2 Diagnosis Guide and Reference for information on Explanation: This is a DB2 internal error. An
identifying and reporting the problem. unexpected error occurred during recovery processing
from a group buffer pool link failure.
Problem Determination: This reason code is issued
by the following CSECTs: DSNB1DAO System Action: The requesting execution unit
abends. A SYS1.LOGREC entry is written and an SVC
dump is requested.
00C202B4
System Programmer Response: Refer to Part 2 of
Explanation: This is a DB2 internal error. The DB2 Diagnosis Guide and Reference for information on
execution unit received an error return code while doing identifying and reporting the problem.
damage assessment for a group buffer pool.
Problem Determination: This abend reason code is
System Action: The requesting execution unit is issued by the following CSECT: DSNB1LNK
abended.
Operator Response: Notify the system programmer,
print the SYS1.LOGREC, and request the SVC dump.
Chapter 32. DB2 Codes 751
00C202C0 • 00C202D0
00C202C0 00C202C3
Explanation: DB2 timed out waiting for the use count Explanation: DB2 received an unexpected return and
on a group buffer pool to reach zero during rebuild reason code from the MVS IXLEERSP macro during
quiesce processing for the group buffer pool. This is a rebuild processing for a group buffer pool.
DB2 internal problem.
System Action: The DB2 system agent that is
System Action: The DB2 system agent that is processing the rebuild abends and takes a dump. The
processing the rebuild abends and takes a dump. The rebuild is stopped. Message DSNB340I is issued
rebuild is stopped. Message DSNB335I is issued indicating that the IXLEERSP request failed and
indicating this reason code as the reason why the message DSNB335I is issued indicating this reason
rebuild stopped. code as the reason why the rebuild stopped.
Problem Determination: Refer to Part 2 of DB2 Problem Determination: See MVS/ESA
Diagnosis Guide and Reference for information on Programming: Sysplex Services Reference for an
identifying and reporting the problem. explanation of the MVS IXLEERSP reason code.
This abend reason code is issued by the following Refer to Part 2 of DB2 Diagnosis Guide and Reference
CSECT: DSNB1xxx for information on identifying and reporting the problem.
This abend reason code is issued by the following
00C202C1 CSECT: DSNB1xxx
Explanation: DB2 encountered a problem trying to
connect to the new group buffer pool coupling facility 00C202C4
structure while trying to rebuild the group buffer pool.
Explanation: DB2 detected that the number of
System Action: A dump may or may not be taken changed pages in the new structure is greater than the
depending on the nature of the error. The rebuild is number of changed pages in the original structure at the
stopped. Message DSNB335I is issued indicating this time that the rebuild of the group buffer pool was about
reason code as the reason why the rebuild stopped. to be completed.
Problem Determination: Check the console log for System Action: DB2 abends and takes a dump. The
previous error messages (for example, DSNB330E or rebuild is stopped. Message DSNB335I is issued
DSNB306I) to determine why DB2 could not connect to indicating this reason code as the reason why the
the new group buffer pool structure. rebuild stopped.
Refer to Part 2 of DB2 Diagnosis Guide and Reference Problem Determination: Refer to Part 2 of DB2
for information on identifying and reporting the problem. Diagnosis Guide and Reference for information on
identifying and reporting the problem.
This abend reason code is issued by the following
CSECT: DSNB1RBC This abend reason code is issued by the following
CSECT: DSNB1xxx
00C202C2
00C202D0
Explanation: DB2 received an unexpected return and
reason code from the MVS IXLREBLD macro during Explanation: DB2 is unable to respond to an event
rebuild processing for a group buffer pool. that was reported by MVS. This is a DB2 internal error.
System Action: The DB2 system agent that is System Action: DB2 terminates abnormally.
processing the rebuild abends and takes a dump. The
Operator Response: Notify the system programmer,
rebuild is stopped. Message DSNB340I will be issued
print the SYS1.LOGREC, and request the SVC dump.
indicating that the IXLREBLD request failed and
Restart DB2.
message DSNB335I is issued indicating this reason
code as the reason why the rebuild stopped. Problem Determination: Refer to Part 2 of DB2
Diagnosis Guide and Reference for information on
Problem Determination: See MVS/ESA
identifying and reporting the problem.
Programming: Sysplex Services Reference for an
explanation of the MVS IXLREBLD reason code. This abend reason code is issued by the following
CSECT: DSNB5REE
Refer to Part 2 of DB2 Diagnosis Guide and Reference
for information on identifying and reporting the problem.
This abend reason code is issued by the following
CSECT: DSNB1xxx
752 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C202D1 • 00C20304
00C202D1 00C20302
Explanation: This is a DB2 internal error. DB2 Explanation: This is a DB2 internal error. A page set
encountered an unrecoverable error while trying to add was not logically opened by the execution unit that was
a page to the logical page list (LPL). attempting to do one of the following:
System Action: The DB2 subsystem is abnormally v Logical close a page set
terminated. v Physical close a page set or partition
Operator Response: Notify the system programmer,
This reason code is issued by the following CSECT:
print SYS1.LOGREC, and request an SVC dump.
DSNB1DDN
Problem Determination: Refer to Part 2 of DB2
System Action: The requesting execution unit is
Diagnosis Guide and Reference for information on
abended.
identifying and reporting the problem.
Operator Response: Notify the system programmer,
This reason code is issued by the following CSECT:
print the SYS1.LOGREC, and request the SVC dump.
DSNB1LPL
System Programmer Response: Refer to Part 2 of
DB2 Diagnosis Guide and Reference for information on
00C20300
identifying and reporting the problem.
Explanation: This is a DB2 internal error. The
execution unit attempted to access, claim, or drain a
00C20303
page set or partition, but the page set was not logically
opened. Explanation: This is a DB2 internal error. A page set
is not in-use, but an execution unit was attempting to do
This reason code is issued by the following CSECTs:
one of the following:
DSNB1CLM DSNIOPNP DSNISGSC DSNITFFS
DSNIWPSC DSNUQUIA v Logical close a page set
v Physical close a page set or partition
System Action: The requesting execution unit is
abended.
This reason code is issued by the following CSECT:
Operator Response: Notify the system programmer, DSNB1CPS
print the SYS1.LOGREC, and request the SVC dump.
System Action: The requesting execution unit is
System Programmer Response: Refer to Part 2 of abended.
DB2 Diagnosis Guide and Reference for information on
identifying and reporting the problem. Operator Response: Notify the system programmer,
print the SYS1.LOGREC, and request the SVC dump.
00C20301 System Programmer Response: Refer to Part 2 of
DB2 Diagnosis Guide and Reference for information on
Explanation: This is a DB2 internal error. The identifying and reporting the problem.
execution unit attempted to access, claim, or drain a
logical partition, but the page set is not a type 2
nonpartitioned page set. 00C20304
System Action: The requesting execution unit is Explanation: This is a DB2 internal error. During force
abended. write processing, the buffer manager detected that the
write claim class count is not zero or there are pending
Operator Response: Notify the system programmer, updates on the page set or partition.
print the SYS1.LOGREC, and request the SVC dump.
This reason code is issued by the following CSECT:
Problem Determination: Refer to Part 2 of DB2 DSNB1WFO
Diagnosis Guide and Reference for information on
identifying and reporting the problem. System Action: The requesting execution unit is
abended.
This reason code is issued by the following CSECTs:
Operator Response: Notify the system programmer,
DSNB1LCM DSNB1LDN DSNB1CPP DSNBWFOR print the SYS1.LOGREC, and request the SVC dump.
DSNBLCLM DSNBDRN DSNBDDRN System Programmer Response: Refer to Part 2 of
DB2 Diagnosis Guide and Reference for information on
identifying and reporting the problem.
Chapter 32. DB2 Codes 753
00C20305 • 00C20307
00C20305
Explanation: This is a DB2 internal error. The
execution unit attempted to access, claim, drain, open,
or close a partition or piece, but the partition or piece
number is invalid.
This reason code is issued by the following CSECTs:
DSNB1ABP, DSNB1CLM, DSNB1CPP, DSNB1DCM,
DSNB1DDN, DSNB1DRA, DSNB1GET, DSNB1SWS,
DSNICLDR, DSNICLOS, DSNICLTO, DSNICMTC,
DSNICMT2, DSNIDALC, DSNIERST, DSNIWPSC,
DSNIOPNP, DSNIRCLS, DSNISGSC, DSNITFFS,
DSNPXTN0, DSNUQUIA, DSNXISB2
System Action: The requesting execution unit is
abended.
Operator Response: Notify the system programmer,
print the SYS1.LOGREC, and request the SVC dump.
System Programmer Response: Refer to Part 2 of
DB2 Diagnosis Guide and Reference for information on
identifying and reporting the problem.
00C20306
Explanation: This is a DB2 internal error.
System Action: The requesting execution unit is
abended.
Operator Response: Notify the system programmer,
print SYS1.LOGREC, and request an SVC dump.
Problem Determination: Refer to Part 2 of DB2
Diagnosis Guide and Reference for information on
identifying and reporting the problem.
This reason code is issued by the following CSECTs:
DSNB1GET, DSNB1LTS, DSNB1LTX, DSNB1SWS
00C20307
Explanation: This is a DB2 internal error.
System Action: The requesting execution unit is
abended.
Operator Response: Notify the system programmer,
print SYS1.LOGREC, and request an SVC dump.
Problem Determination: Refer to Part 2 of DB2
Diagnosis Guide and Reference for information on
identifying and reporting the problem.
This reason code is issued by the following CSECT:
DSNBLTCH
754 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 33. X’C3......’ Codes
For information about the CICS transaction abend/dump code DSNC, refer to
“Appendix A. CICS Transaction Abend/Dump Code” on page 1279.
abend X'04E' with abend reason code 00C30002) is
00C30001
requested unless FRBRC2 equals 00F30013 or
Explanation: The CICS attachment facility terminated 00F30058. Within the dump, register 7 contains the
because of errors that cannot be corrected. The address of the resource control table load module. In
attachment facility task-related user exit detected one of this load module, location CRCTCCTA contains the
the following conditions: address of the connection control table (CCT) in
v The life of task block (LOT) is invalid. subpool 99. The CCT contains the FRB control block for
the IDENTIFY to DB2. The FRB control block begins at
v The LOT and connection control table (CCT) element
CCCTFRB within the CCT. You can also locate the FRB
were disconnected before the end of a unit of
with the CCT control block by scanning the CCT for the
recovery
FRB character string eye catcher. The FRB contains
v The previous application program support (APS) call two fields, FRBRC1 and FRBRC2, which contain the
failed and a commit call is being attempted return code and reason code from the IDENTIFY to the
These symptoms might be caused by an overlay of the DB2 subsystem.
LOT and/or the CCT.
00C30003
This abend reason code is issued by the following
CSECTs: DSNCMSUB DSN2MSUB Explanation: The CICS attachment facility could not
complete a recover indoubt call because of the return
System Action: The CICS attachment facility and reason codes from DB2.
terminates.
This abend reason code is issued by the following
Operator Response: Notify the system programmer. CSECTs: DSNCMSUB DSN2MSUB
System Programmer Response: Analyze the dumps System Action: The CICS attachment facility
and system console messages for storage violations. terminates. The unit of recovery (UR) is not resolved
and remains indoubt.
Problem Determination: One or more control blocks
do not pass validity checks. The most probable cause is Operator Response: Notify the system programmer.
that they were overlaid by some user application. A
CICS dump (DSNC) and a subtask dump (system Problem Determination: The return code from the
abend X'04E' with abend reason code 00C30001) were recover indoubt process does not allow the CICS
requested. Register 9 in the CICS transaction dump attachment facility to complete the unit of recovery (UR).
contains the address of the LOT. If the UR included in the error is valid, an attempt
should be made to resolve the UR manually, using the
If the LOT is valid, CLOTCCTE contains the CCT DB2 -RECOVER command.
element address, and CCCTLOT contains the LOT
address. Use these pointers (CLOTCCTE and A subtask dump (system abend X'04E' with abend
CCCTLOT) to verify the validity of the LOT and the CCT reason code 00C30003) is requested. Register 7
element. Both control blocks should contain seven contains the address of the resource control table.
character eye catchers (DSNCLOT and DSNCCCT or Location CRCTCCTA in load module DSNCRCTx or
DSN2LOT and DSN2CCT). If they are in error, check DSN2CTxx contains the address of the connection
the application program for possible storage violations. control table (CCT) in subpool 99.
The CCT contains the FRB control block, which can be
00C30002 located by scanning the CCT for the FRB character
string eye catcher. FRBRC1 and FRBRC2 contain the
Explanation: The CICS attachment facility was not return code and reason code from DB2.
able to start.
A nonzero return code indicates problems specified by
This abend reason code is issued by the following the reason code. Higher return codes (4, 8, and 12)
CSECTs: DSNCMSUB DSN2MSUB indicate higher severity.
System Action: The CICS attachment facility Examine the MVS console for DB2 messages that might
terminates. indicate any related errors. If an SVC dump was also
taken, print it as well as the SYS1.LOGREC to obtain
Operator Response: Notify the system programmer.
further diagnostic information. The CICS SYSTEM LOG
Problem Determination: A subtask dump (system
© Copyright IBM Corp. 1982, 2001 755
00C30004 • 00C30007
might help to determine the final disposition of the Operator Response: Notify the system programmer.
indoubt unit of work.
Problem Determination: The return code from the
Register 6 in the subtask abend dump plus X'20' commit or abort does not allow the CICS attachment
contains the address of a 16-byte area that contains the facility to complete the transaction’s unit of recovery.
network id (NID). The last 8 bytes of the NID contain Register 7 in the subtask dump contains the address of
the store clock value that was passed to DB2 by CICS the resource control table (RCT).
to identify the logical unit of work (LUW). This value can
Location CRCTCCTA in the RCT load module contains
be used to correlate the DB2 unit of recovery with the
the address of the connection control table (CCT) in
CICS logical unit of work.
subpool 99. CCCTCSUB in the CCT contains the
address of the subtask work area (CSUB or C2UB).
00C30004
The subtask work area contains the FRB control block,
Explanation: A thread subtask failed because of a which you can locate by scanning DSNCSUB or
validity check failure of a transaction-related life of task DSN2SUB for the FRB character string eye catcher.
block (LOT). FRBRC1 and FRBRC2 contain the return code and
reason code from DB2.
This abend reason code is issued by the following
CSECTs: DSNCEXT3 DSN2EXT3 A nonzero return code indicates trouble specified by the
reason code. Higher return codes (4, 8, and 12) indicate
System Action: The CICS attachment facility
higher severity.
continues operation; however, the one subtask is
abended and a subtask dump (system abend X'04E' Refer to the reason code in “Part 4. DB2 Codes” on
with abend reason code 00C30004) is requested. page 707 and prepare a search argument, using the
reason code as the appropriate keyword. If the reason
Because the LOT contains an ECB on which the CICS
code is not listed, it is an internal code that is useful
application is waiting and this error indicates the LOT
only as a keyword.
was overlaid, the effect on the CICS application is
unpredictable. If an SVC dump was also taken, print it and the
SYS1.LOGREC to obtain further diagnostic information.
Operator Response: Notify the system programmer.
If you suspect an error in DB2, refer to Part 2 of DB2
Problem Determination: The most probable cause is
Diagnosis Guide and Reference for information on
that the LOT was overlaid by some user application. In
identifying and reporting the problem.
the subtask abend dump, register 7 contains the
address of the resource control table (RCT).
00C30006
CRCTCCTA in the RCT contains the address of the
CCT, and CCCTLN in the CCT contains its length. Explanation: The CICS attachment facility failed
Register 9 contains the CCT element that was assigned because of return codes from the MVS ATTACH macro
to the application in error. while attempting to start a thread subtask.
This CCT element address can be validated by ensuring This abend reason code is issued by the following
that it lies within the CCT. If the CCT address is valid, CSECTs: DSNCMSUB DSN2MSUB
CCCTLOT contains the address of the LOT in error. To
System Action: The CICS attachment facility
determine the source of the error, analyze the subtask
terminates.
dump and check the CICS master terminal for any
storage violation messages. Operator Response: Notify the system programmer.
Problem Determination: A subtask dump (system
00C30005 abend X'04E' with abend reason code 00C30006) is
requested. To determine why the ATTACH failed, use
Explanation: The CICS attachment facility could not
the MVS dump, MVS system trace, SYS1.LOGREC,
complete a commit or abort call for a transaction
and MVS console listing. Refer to the appropriate MVS
because of return codes from the application program
publication to interpret the meaning of return codes from
support call.
the MVS ATTACH macro.
This abend reason code is issued by the following
CSECTs: DSNCEXT3 DSN2EXT3
00C30007
System Action: The CICS attachment facility
Explanation: The start of the CICS attachment facility
continues operation, but the one subtask abends with a
failed because of return codes while attempting to
subtask dump (system abend X'04E' with abend reason
establish a shutdown listen exit with DB2.
code 00C30005). The CICS transaction that is
associated with the abend is also abended with a CICS This abend reason code is issued by the following
transaction dump CSECTs: DSNCMSUB DSN2MSUB
756 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C30008 • 00C30010
System Action: The CICS attachment facility
00C30009
terminates.
Explanation: The CICS attachment facility failed
Operator Response: Notify the system programmer.
because of the return code and reason code from DB2
Problem Determination: The return code from the for the SHOW INDOUBT units of recovery process.
establish exit process does not allow the CICS
This abend reason code is issued by the following
attachment facility to start. A subtask dump (system
CSECTs: DSNCMSUB DSN2MSUB
abend X'04E' with abend reason code 00C30007) is
requested. Register 7 contains the address of the System Action: The CICS attachment facility
resource control table (RCT). terminates, and a subtask dump is requested.
Location CRCTCCTA in the RCT load module Operator Response: Notify the system programmer.
(DSNCRCTx or DSN2CTxx) contains the address of the
Problem Determination: The return code from the
connection control table (CCT) in subpool 99. The CCT
SHOW INDOUBT process does not allow the CICS
contains the FRB control block, which can be located by
attachment facility to continue. A subtask dump (system
scanning the CCT for the FRB character string eye
abend X'04E' with abend reason code 00C30009) is
catcher. FRBRC1 and FRBRC2 contain the return code
requested. Register 7 contains the address of the
and reason code from DB2.
resource control table (RCT).
A nonzero return code indicates trouble specified by the
Location CRCTCCTA in the RCT load module
reason code. Higher return codes (4, 8, and 12) indicate
(DSNCRCTx or DSN2CTxx) contains the address of the
higher severity.
connection control table (CCT) in subpool 99. The CCT
Refer to the reason code in “Part 4. DB2 Codes” on contains the FRB control block, which can be located by
page 707. If the reason code is not listed, it is an scanning the CCT for the FRB character string eye
internal code that is useful only as a keyword. catcher. FRBRC1 and FRBRC2 contain the return code
and reason code from DB2.
If an SVC dump was also taken, print it as well as the
SYS1.LOGREC to obtain further diagnostic information. A nonzero return code indicates trouble specified by the
reason code. Higher return codes (4, 8, and 12) indicate
If you suspect an error in DB2, refer to Part 2 of DB2
higher severity. Analyze the subtask dump.
Diagnosis Guide and Reference for information on
identifying and reporting the problem. Refer to the reason code in “Part 4. DB2 Codes” on
page 707. If the reason code is not listed, it is an
internal code that is useful only as a keyword.
00C30008
If an SVC dump was also taken, print it and the
Explanation: The start of the CICS attachment facility
SYS1.LOGREC to obtain further diagnostic information.
failed while attempting to establish an ESTAE recovery
exit. because of reasons indicated by the return codes. If you suspect and error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on
This abend reason code is issued by the following
identifying and reporting the problem.
CSECTs: DSNCMSUB DSN2MSUB
System Action: An X'04E' abend subtask dump is
00C30010
taken, and the CICS attachment facility remains partially
initialized. Explanation: An IDENTIFY call to DB2 from a CICS
attachment facility connection subtask failed, indicating
Operator Response: Notify the system programmer,
that DB2 is no longer active.
and issue the DSNC STOP FORCE command.
This abend reason code is issued by the following
Problem Determination: The return code from the
CSECTs: DSNCEXT3 DSN2EXT3
ESTAE macro does not allow the CICS attachment
facility to start. A subtask dump (system abend X'04E' System Action: A subtask dump is requested for the
with abend reason code 00C30008) is requested. To failing task thread, and the automatic STOP of the CICS
determine why the ESTAE failed, use the MVS dump, attachment facility is initiated.
MVS system trace, SYS1.LOGREC, and MVS console
Operator Response: Notify the system programmer.
listing. The MVS trace contains the return code from the
ESTAE macro. Refer to the appropriate MVS publication Problem Determination: Some other error, which is
for the meaning of return codes from the MVS ESTAE the source of the failure, probably occurred prior to this
macro. action. Use the subtask dump, SYS1.LOGREC, MVS
console listing, and any SVC dumps that might have
been requested if DB2 failed.
Chapter 33. DB2 Codes 757
00C30011 • 00C30100
00C30011 00C30021
Explanation: The CICS attachment facility detected Explanation: The CICS attachment facility detected an
that a resource control table (RCT) entry was corrupted application which is using the instrumentation facility
or overlaid since the CICS attachment facility was last interface (IFI) and is link-edited with a back level version
started. of the CICS attachment facility language interface
module DSNCLI.
This abend reason code is issued by the following
CSECTs: DSNCEXT3 DSN2EXT3 This abend reason code is issued by the following
CSECTs: DSNCEXT1 DSN2EXT1
System Action: The CICS attachment facility abends
CICS task with a CICS transaction abend. System Action: The transaction is abended with a
DSNC abend. The life of task block (LOT) contains
Operator Response: Notify the system programmer.
reason code 00C30021.
System Programmer Response: Stop and then
User Response: Relink-edit the application with the
restart the CICS attachment facility to refresh the RCT.
appropriate version of the CICS attachment facility
Problem Determination: Analyze the CICS dumps to language interface module DSNCLI which corresponds
determine which CICS trans-id and corresponding RCT to the current CICS attachment facility maintenance
entries were affected. The CICS transaction dump level.
contains the RCT storage at the time of the failure.
System Programmer Response: Ensure the
Location CRCTAUWD in the affected RCT entry was
appropriate level of the CICS attachment facility
altered since the CICS attachment facility was last
language interface module DSNCLI is available to all
started. This might be caused by an application program
users. Discard any back level version of DSNCLI.
modifying storage it does not own (a CICS storage
violation). If you suspect an error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on
identifying and reporting the problem.
00C30020
Problem Determination: If the problem continues to
Explanation: A previous error occurred during create
occur after link-editing the application again with the
thread processing which put the transaction in a
proper level of the CICS attachment facility language
must-abort state. The only request allowed in this state
interface module, validate that the correct DSNCLI is
is a SYNCPOINT ROLLBACK.
being used.
This abend reason code is issued by the following
The eye catcher in DSNCLI should have the proper
CSECTs: DSNCEXT1 DSN2EXT1
maintenance level identified. Look at the DSNCLI, which
System Action: The transaction is placed in a is actually link-edited with the application to ensure the
must-abort state and remains in that state until the proper level.
transaction terminates or issues a SYNCPOINT
ROLLBACK. Any SQL statement issued by a
00C30100
transaction while in a must-abort state receive an
SQLCODE -906. SYNCPOINT requests without the Explanation: An application attempted to issue an
ROLLBACK option cause an ASP7 abend. SQL request when the CICS attachment was not
operational. This reason code results when the
User Response: If the create thread error was
attachment is in STANDBY mode and the RCT
anticipated, and the transaction can correct the situation
STANDBY option is “SQLCODE”.
that caused the create thread error, the transaction
might issue a SYNCPOINT ROLLBACK and continue System Action: The SQL request is not executed.
processing.
User Response: Wait until the CICS attachment
System Programmer Response: If it is undesirable facility is started. Then resubmit the transactions that
for a transactions to continue after create thread errors, failed.
reassemble the resource control table (RCT) and
Operator Response: Restart the CICS attachment
change the PCTEROP parameter to AEY9, or remove it
facility after ensuring that DB2 is active.
completely and take the default.
System Programmer Response: Collect any dumps
Problem Determination: Unless PCTEROP=N906,
produced by the CICS attachment facility or DB2, the
this error reason code is preceded by a DSNC
MVS system console log, and any record of -STOP DB2
transaction dump, which provides diagnostic information
commands that might have been issued. Determine if
about the create thread failure. The SQLCA also
the termination of the CICS attachment facility was the
contains the SQL return code identifying the create
result of a DB2 stop command or abnormal termination
thread error.
of DB2.
758 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C30200 • 00C30805
Problem Determination: The CICS attachment facility attachment facility detected an unexpected condition, if
was in standby mode. This occurs if DB2 stops and the the DB2 STOP MODE(FORCE) command was issued,
RCT STANDBY option is “SQLCODE”. Locate all the or if DB2 abnormally terminated. If the stop command
CICS attachment facility dumps and all DB2 termination with the force option was not issued, locate all the CICS
dumps. Follow the problem determination procedures attachment facility abnormal termination dumps and all
documented for the error conditions that caused the DB2 abnormal termination dumps. Follow the problem
dumps to be produced. determination procedures documented for the error
conditions that caused the dumps to be produced.
00C30200
Explanation: An application attempted to issue an
SQL request but no thread resource was available for
that request. This reason code results when the
CICS-DB2 attachment DB2ENTRY definition for the
transaction is disabled.
System Action: The SQL request is not executed.
User Response: Retry the transaction after the
DB2ENTRY has been reenabled.
System Programmer Response: Enable the
transaction’s DB2ENTRY or set the DISABLEDACT to
POOL to allow transactions in that entry to run.
00C30805
Explanation: The caller’s connection with DB2
terminated because the CICS attachment facility is
terminating in stop force mode. This reason code
indicates that the CICS attachment facility is terminating
because stop force was initiated. Stop force was
probably initiated by the DSNC STOP FORCE
command, the STOP DB2 MODE(FORCE) command,
DB2 abnormally terminating, or the CICS attachment
facility abnormally terminating. If a command was not
used to cause stop force processing, abnormal
termination dumps are produced by either DB2 if it is
abnormally terminating, or by the CICS attachment
facility if it is abnormally terminating.
This abend reason code is issued by the following
CSECTs: DSNCEXT1 DSN2CEXT1
System Action: All current requests are returned with
an indication that the CICS attachment facility is
terminating.
User Response: Wait until the CICS attachment
facility is restarted; then resubmit the transactions that
failed.
Operator Response: Restart the CICS attachment
facility after ensuring that DB2 is active.
System Programmer Response: Collect any dumps
produced by the CICS attachment facility or DB2, the
MVS system console log, and any record of DSNC
STOP commands that might have been issued.
Determine if the termination of the CICS attachment
facility was the result of a STOP command or abend.
Problem Determination: The CICS attachment facility
was forced into termination. This occurs if the DSNC
STOP FORCE command is issued, if the CICS
Chapter 33. DB2 Codes 759
760 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 34. X’C5......’ Codes
For these codes, the standard documentation to be collected is a SYSUDUMP and
a printout of the DSNTRACE data set. The standard SPUFI documentation is a
SYSUDUMP and a printout of the ISPF log for this session. A SYSUDUMP data set
must be allocated in advance to collect your dump. A DSNTRACE data set must be
allocated in advance to collect your DSN trace stream unless you are running in the
background, in which case the SYSTSPRT data set contains the DSNTRACE
output. ISPF normally runs with an active log data set. ISPF suppresses dumps
unless it is invoked with the TEST parameter. If you suspect an error in DB2, refer
to Part 2 of DB2 Diagnosis Guide and Reference for information on identifying and
reporting the problem.
In the TSO attachment facility, the user can control whether or not message IDs are
displayed. To see them, type PROFILE MSGID. To suppress them, type PROFILE
NOMSGID.
The following abends can occur in the TSO attachment facility.
SPUFI documentation should be collected. Refer to
00C50001
“Chapter 34. X’C5......’ Codes” for information about
Explanation: This is probably a DB2 subsystem error. obtaining dumps and displaying message IDs.
DSNESM30 has detected an illegal value in the YTYPE
Problem Determination: An illegal value was
portion of the SQLTYPE field of the SQLDA.
detected in the YTYPE of the SQLDA. This may have
This abend reason code is issued by the following been caused by this field being overlaid in error.
CSECT: DSNESM30 Analyze the SQLDA in the storage dump to determine
the source of the error.
User Response: If the problem persists, notify the
system programmer. Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 4,
System Programmer Response: The standard
21.
SPUFI documentation should be collected. Refer to
“Chapter 34. X’C5......’ Codes” for information about
obtaining dumps and displaying message IDs. 00C50003
Problem Determination: An illegal value was Explanation: This could be either a user or a system
detected in the SQLTYPE field of the SQLDA. This may error. SPUFI was unable to obtain the required storage
have been caused by this field being overlaid in error. via GETMAIN.
To determine the source of the error, analyze the
This abend reason code is issued by the following
SQLDA in the storage dump.
CSECTs: DSNESM10, DSNESM20
Collect the following diagnostic items listed in
System Action: SPUFI task abends. User returns to
“Appendix B. Problem determination” on page 1281: 4,
ISPF main menu.
21.
User Response: If the problem persists, notify the
system programmer. You may have to specify a larger
00C50002
machine size at logon time.
Explanation: This is probably a DB2 subsystem error.
System Programmer Response: If the problem
DSNESM32 has detected an illegal value in the YTYPE
persists, the standard SPUFI documentation should be
portion of the SQLTYPE field of the SQLDA. This
collected. Refer to “Chapter 34. X’C5......’ Codes” for
suggests that an illegal value was in the SQLTYPE field
information about obtaining dumps and displaying
of the SQLDA.
message IDs.
This abend reason code is issued by the following
Problem Determination: Register 2 contains the
CSECT: DSNESM32
amount of storage that was requested. Message
User Response: If the problem persists, notify the DSNE392E, in the ISPF log data set, gives the name of
system programmer. the module that issued this abend.
System Programmer Response: The standard Collect the following diagnostic items listed in
© Copyright IBM Corp. 1982, 2001 761
00C50005 • 00C50009
“Appendix B. Problem determination” on page 1281: 4,
00C50008
21.
Explanation: This could be either a user or a system
error. The DYNALLOC SVC returned an unexpected
00C50005
return code when attempting to deallocate a data set.
Explanation: This could be either a user or a system
This abend reason code is issued by the following
error. The DYNALLOC SVC returned an unexpected
CSECT: DSNESM55
return code when attempting to allocate a data set.
System Action: The contents of the field are written to
This abend reason code is issued by the following
the ISPF log
CSECT: DSNESM55
User Response: If the problem persists, notify the
System Action: The contents of the field are written to
system programmer.
the ISPF log.
System Programmer Response: The standard
User Response: If the problem persists, notify the
SPUFI documentation should be collected. Refer to
system programmer.
“Chapter 34. X’C5......’ Codes” on page 761 for
System Programmer Response: The standard information about obtaining dumps and displaying
SPUFI documentation should be collected. Refer to message IDs.
“Chapter 34. X’C5......’ Codes” on page 761 for
Problem Determination: Message DSNE384E, in the
information about obtaining dumps and displaying
ISPF log data set, gives the return code and reason
message IDs.
code values returned from the dynamic allocation
Problem Determination: Message DSNE381E, in the request. Analyze these values to determine the source
ISPF log data set, gives the return code and reason of the error.
code values returned from the dynamic allocation
Collect the following diagnostic items listed in
request. Refer to the appropriate MVS publication to
“Appendix B. Problem determination” on page 1281: 4,
determine the source of the error and analyze these
21.
values.
Collect the following diagnostic items listed in
00C50009
“Appendix B. Problem determination” on page 1281: 4,
21. Explanation: This is probably caused by an error in
the SPUFI code. The SQLCODE translation service
(module DSNTIAR) has returned an unexpected return
00C50007
code.
Explanation: This is probably an error in the SPUFI
This abend reason code is issued by the following
code. The field describing the record format of the
CSECT: DSNESM40
output data set is not valid.
System Action: The contents of the field have been
This abend reason code is issued by the following
written to the ISPF log.
CSECT: DSNESM55
User Response: If the problem persists, notify the
System Action: The contents of the field are written to
system programmer.
the ISPF log.
System Programmer Response: The standard
User Response: If the problem persists, notify the
SPUFI documentation should be collected. Refer to
system programmer.
“Chapter 34. X’C5......’ Codes” on page 761 for
System Programmer Response: The standard information about obtaining dumps and displaying
SPUFI documentation should be collected. Refer to message IDs.
“Chapter 34. X’C5......’ Codes” on page 761 for
Problem Determination: Message DSNE387A, in the
information about obtaining dumps and displaying
ISPF log data set, gives the return code value returned
message IDs.
from DSNTIAR. The meanings of these return codes
Problem Determination: Message DSNE383A, in the are:
ISPF log data set, gives the record format of the output 4 More data was available than could fit into the
data set that was determined to be in error. The output message area provided.
data set record format must be one of the following: F, 8 The LRECL was not within the limits: 72 ≥
FB, FBA, V, VB, or VBA. LRECL ≤ 240
12 The message area was not large enough.
Collect the following diagnostic items listed in Message length ≥ 240
“Appendix B. Problem determination” on page 1281: 4, 16 Error in message routine (IKJEFF02).
21.
762 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C50100 • 00C50104
Collect the following diagnostic items listed in This abend reason code is issued by the following
“Appendix B. Problem determination” on page 1281: 4, CSECT: DSNECP12
21.
System Action: Immediately after writing this
message, DSN abends with an abend code of X'04E'
00C50100 and an abend reason code of '00C50102'.
Explanation: This is probably caused by an error in User Response: If the problem persists, notify the
the DSN command processor code. Module DSNECP66 system programmer.
(in the DSN command processor) called module
System Programmer Response: See the Problem
DSNTIAR to format an error message to explain an
Determination section of this message.
unexpected SQL return code received by DCLGEN.
DSNTIAR failed. Problem Determination: Rerun the job with DSN
tracing turned on. You may need a SYSUDUMP from
This abend reason code is issued by the following
the TSO address space. You probably need a DB2
CSECT: DSNECP66
dump. If you suspect an error in DB2, refer to Part 2 of
User Response: If the problem persists, notify the DB2 Diagnosis Guide and Reference for information on
system programmer. identifying and reporting the problem.
System Programmer Response: The standard Collect the following diagnostic items listed in
documentation should be collected, including a DSN “Appendix B. Problem determination” on page 1281: 4,
trace stream. Refer to “Chapter 34. X’C5......’ Codes” on 20.
page 761 for information about obtaining dumps and
displaying message IDs.
00C50103
Problem Determination: Message DSNE004E in the
Explanation: An error probably occurred in DB2 while
output gives the return code value returned from
it attempted to process an ESTABLISH EXIT request
DSNTIAR. For an explanation of these return codes,
from the DSN command processor. DSN received an
see abend reason code '00C50009'.
unexpected return code (FRBRC1 or FRBRC2) from
Collect the following diagnostic items listed in DB2.
“Appendix B. Problem determination” on page 1281: 4,
This abend reason code is issued by the following
20.
CSECT: DSNECP12
System Action: Immediately after writing this
00C50101
message, DSN abends with an abend code of X'04E'
Explanation: The user has entered the ABEND and an abend reason code of '00C50103'.
subcommand of the DSN command processor. This
User Response: If the problem persists, notify the
causes a X'04E' abend and a dump to be requested. In
system programmer.
order to retain the dump, you must have previously
allocated a SYSUDUMP or SYSADUMP data set. The System Programmer Response: See the Problem
ABEND subcommand can be useful for debugging. Determination section of this message.
This abend reason code is issued by the following Problem Determination: Rerun the job with DSN
CSECT: DSNECP19 tracing turned on. You may need a SYSUDUMP from
the TSO address space. You probably need a DB2
System Action: A X'04E' abend results, and a dump
dump. If you suspect an error in DB2, refer to Part 2 of
is requested.
DB2 Diagnosis Guide and Reference for information on
System Programmer Response: The standard identifying and reporting the problem.
documentation may be needed. Refer to “Chapter 34.
Collect the following diagnostic items listed in
X’C5......’ Codes” on page 761 for information about
“Appendix B. Problem determination” on page 1281: 4,
obtaining dumps and displaying message IDs.
20.
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
00C50104
determination” on page 1281: 4, 20.
Explanation: An error probably occurred in DB2 while
it attempted to process a CREATE THREAD request
00C50102
from the DSN command processor. DSN received an
Explanation: An error probably occurred in DB2 while unexpected return code (FRBRC1 or FRBRC2) from
it attempted to process an IDENTIFY request from the DB2.
DSN command processor. DSN received an unexpected
This abend reason code is issued by the following
return code (FRBRC1 or FRBRC2) from DB2.
CSECT: DSNECP13
Chapter 34. DB2 Codes 763
00C50108 • 00C50111
System Action: Immediately after writing this User Response: If the problem persists, notify the
message, DSN abends with an abend code of X'04E' system programmer.
and an abend reason code of '00C50104'.
System Programmer Response: See the Problem
User Response: If the problem persists, notify the Determination section of this message.
system programmer.
Problem Determination: Rerun the job with DSN
System Programmer Response: See the Problem tracing turned on. You may need a SYSUDUMP from
Determination section of this message. the TSO address space. You probably need a DB2
dump. If you suspect an error in DB2, refer to Part 2 of
Problem Determination: Rerun the job with DSN
DB2 Diagnosis Guide and Reference for information on
tracing turned on. You may need a SYSUDUMP from
identifying and reporting the problem.
the TSO address space. You probably need a DB2
dump. If you suspect an error in DB2, refer to Part 2 of Collect the following diagnostic items listed in
DB2 Diagnosis Guide and Reference for information on “Appendix B. Problem determination” on page 1281: 4,
identifying and reporting the problem. 20.
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 4, 00C50110
20.
Explanation: This is a DSN command processor error.
It occurs when the DSN STAX routine (DSNEBP01) is
00C50108 entered and the DSN control blocks cannot be located;
the AEPLUSR field did not contain the CIB address.
Explanation: An error probably occurred in DB2 while
it attempted to process a BIND, REBIND, or FREE This code is issued by the following CSECT:
request from the DSN command processor. DSN DSNECP01
received an unexpected return code (FRBRC1 or
Severity: 4
FRBRC2) from DB2.
System Action: The DSN command processor
This abend reason code is issued by the following
abended.
CSECT: DSNECP30
User Response: If you allocated a SYSUDUMP or
System Action: Immediately after writing this
SYSABEND dump data set, collect the dump.
message, DSN abends with an abend code of X'04E'
Otherwise, allocate SYSUDUMP and DSNTRACE data
and an abend reason code of '00C50108'.
sets, turn on DSN tracing, and try to recreate the error.
User Response: If the problem persists, notify the Save these data sets.
system programmer.
System Programmer Response: See the Problem 00C50111
Determination section of this message.
Explanation: Your application program made an
Problem Determination: Rerun the job with DSN instrumentation facility component application program
tracing turned on. You may need a SYSUDUMP from interface (instrumentation facility interface) call to DB2
the TSO address space. You probably need a DB2 language interface module DSNELI, but your application
dump. If you suspect an error in DB2, refer to Part 2 of program was not running under the DSN command
DB2 Diagnosis Guide and Reference for information on processor. You must run all application programs using
identifying and reporting the problem. DSNELI under DSN. To do this, first issue the DSN
command, then start your application using the RUN
Collect the following diagnostic items listed in
subcommand of the DSN command processor, and
“Appendix B. Problem determination” on page 1281: 4,
finally, when the application completes, stop DSN with
20.
an END subcommand.
This reason code is issued by the following CSECT:
00C50109
DSNELI
Explanation: An error probably occurred in DB2 while
System Action: Control returns to the application.
it attempted to process a TERMINATE request from the
Your application can continue processing. Further
DSN command processor. DSN received an unexpected
attempts at instrumentation facility interface (IFI) calls
return code (FRBRC1 or FRBRC2) from DB2.
will continue to produce this return and reason code.
This abend reason code is issued by the following
User Response: Rerun your application under the
CSECT: DSNECP18
DSN command processor.
System Action: Immediately after writing this
Operator Response: Notify your system programmer.
message, DSN abends with an abend code of X'04E'
and an abend reason code of '00C50109'. System Programmer Response: Modify the job to
764 DB2 UDB for OS/390 and z/OS: Messages and Codes
invoke DSN. Initiate the application program using the
RUN subcommand of the DSN command processor.
Chapter 34. DB2 Codes 765
766 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 35. X’C6......’ Code
00C60001
Explanation: DB2 received return code X'20' when
issuing a WTO request to display a DB2 console
message. MVS sets this return code when there are no
message buffers for either Multiple Console Support
(MCS) or JES3, or when there is a JES3 WTO staging
area excess. The WTO request is terminated. The
current DB2 console message and all subsequent DB2
informational console messages are ignored until the
MVS problem is corrected.
At the time of the abend, general register zero contains
the return code from WTO request.
This abend reason code is issued by the following
CSECT: DSNFWTO
System Action: A record is written to SYS1.LOGREC.
A retry is requested and execution continues. DB2
resumes issuing console messages when the condition
is corrected.
© Copyright IBM Corp. 1982, 2001 767
768 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 36. X’C8......’ Codes
Abends in the precompiler are not intercepted via ESTAE, so standard system
abends might occur. The SYNAD exit is not used, so I/O errors cause S001 or
S002 abends. S04E abends are generated for precompiler internal errors. Following
is a list of reason codes.
00C8901x 00C89041
Explanation: An internal precompiler/parser Explanation: More storage is needed, but could not
consistency check failed. An S04E abend is generated. be obtained during the precompiler execution. An S04E
The error type and reason code are found in register 15 abend occurs. The error type and reason code are
of the dump. found in register 15 of the dump.
In the reason code, x is one of the following: This reason code is issued by the following CSECT:
DSNHCORE
1 Parser received a token code of 0 from a
lexical scan. A lexical scan refers to a scan of System Programmer Response: The storage
words rather than syntax. required for the current statement could not be acquired
or exceeds the maximum (64KB) for a single request. If
2 Error in storage suballocation control blocks.
the region is full, determine if the region can be
The error might occur when a DB2 SQL
expanded. If it cannot be expanded, the SQL statement
statement limitation is exceeded. The SQL
is too large to be processed.
statement might be referencing, creating, or
declaring more columns than the DB2 defined
maximum number allowed for an SQL
statement. Another possibility is that too many
host variables are being referenced in the SQL
statement.
3 Error in storage suballocation request. This
error might occur because of storage
constraints when building the DBRM entry for
the SQL statement or because the SQL
statement exceeds the DB2 maximum
statement length.
4 Error in pointer structures.
5 Host variable information in the
precompiler/parser dictionary or in the DBRM is
not consistent with host variable information for
an SQL statement. The error might occur when
the precompiler misinterprets an illegal host
variable declaration.
6 Unexpected value for parser option.
7 Internal limit exceeded. A fully qualified name
exceeds the maximum length of 255
characters.
8 Internal conversion error. An error occurred
when converting a timestamp version-id.
9 Internal stack storage exhausted.
System Programmer Response: Obtain the SVC
dump and a copy of the application program source. If
the abend reason code is 00C89015, obtain a copy of
the DBRM being bound (IEBCOPY).
© Copyright IBM Corp. 1982, 2001 769
770 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 37. X’C9......’ Codes
System Action: The table space or partition is
00C9007D
implicitly stopped by DB2. Messages DSNT501I and
Explanation: The compression dictionary for the table DSNI004I are displayed to inform the operator that the
space or partition cannot be stored in the table space or dictionary and the object for which the dictionary is
partition. Therefore, the LOAD or REORG utility cannot defined are unavailable. An SQLCODE -904 is returned
complete successfully. to the SQL end user.
This abend reason code is issued by the following Operator Response: Notify the system programmer.
CSECTs: DSNIZLDL, DSNIDLOD
System Programmer Response: Recover and start
System Action: The table space or partition is the table space or partition and tell the user to resubmit
implicitly stopped by DB2. Messages DSNT501I and the request.
DSNI004I are displayed to inform the operator that the
dictionary and the object for which the dictionary is
00C90080
defined are unavailable. An SQLCODE -904 is returned
to the SQL end user. Explanation: An attempt was made to allocate a
resource for update operations. However, the resource
Operator Response: Notify the system programmer.
was already started for read-only access.
System Programmer Response: Correct the problem
This reason code is issued by the following CSECTs:
and resubmit the LOAD or REORG job. If you suspect
an error in DB2, refer to Part 2 of DB2 Diagnosis Guide DSNIDBCA DSNIDBCI DSNIDBCN DSNIDBCP
and Reference for information on identifying and DSNIDBET
reporting the problem.
System Action: The allocation process is not allowed.
00C9007E
User Response: Determine when the resource is
Explanation: The compression dictionary for the table started for read/write access, and rerun the job.
space or partition was not successfully retrieved.
Therefore, the data request failed. Operator Response: If this reason code appears in
message DSNT501I, determine whether the named
This abend reason code is issued by the following resource should be started for read-only access.
CSECTs: DSNIRFNX, DSNIRLPG, DSNICUMR,
DSNIMSMS, DSNINXPT, DSNIRIDC, DSNIRNXT, Problem Determination: The requested operation is
DSNIRSET, DSNISRID, DSNISFS, DSNISFX, not performed. An SQLCODE -904 is issued, and/or
DSNISRTI, DSNICUMW, DSNILREP, DSNIMS1W, message DSNT501I is issued. For more information,
DSNIRELF, DSNIRELS, DSNIREDR, DSNIENSR refer to the SQL return code in “Part 2. SQL Return
Codes” on page 9 or to the description of the DSNT501I
System Action: The table space or partition is message in “Chapter 17. DSNT... Messages” on
implicitly stopped by DB2. Messages DSNT501I and page 375.
DSNI004I are displayed to inform the operator that the
dictionary and the object for which the dictionary is SYS1.LOGREC contains information in the variable
defined are unavailable. An SQLCODE -904 is returned recording area (VRA) of the system diagnostic work
to the SQL end user. area (SDWA). Significant fields for this code are:
VRARRK13, VRARRK14, and VRARRK15.
Operator Response: Notify the system programmer.
If you suspect an error in DB2, refer to Part 2 of DB2
System Programmer Response: Correct the problem Diagnosis Guide and Reference for information on
and inform the user to resubmit the request. If you identifying and reporting the problem.
suspect an error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on Collect the following diagnostic items listed in
identifying and reporting the problem. “Appendix B. Problem determination” on page 1281: 1,
3, 5, 32.
00C9007F
00C90081
Explanation: The compression dictionary for the table
space or partition is invalid. Therefore, the table space Explanation: An attempt was made to allocate a
or partition cannot be opened. resource that is stopped for all access.
This abend reason code is issued by the following This reason code is issued by the following CSECTs:
CSECT: DSNIZLDR
© Copyright IBM Corp. 1982, 2001 771
00C90082 • 00C90083
DSNIDBCA DSNIDBCI DSNIDBCJ DSNIDBCN recording area (VRA) of the system diagnostic work
DSNIDBCO DSNIDBCP DSNIDBCQ DSNISTDB area (SDWA). Significant fields for this code are:
DSNISTPS VRARRK13, VRARRK14, and VRARRK15.
If you suspect an error in DB2, refer to Part 2 of DB2
System Action: The allocation process is not allowed. Diagnosis Guide and Reference for information on
identifying and reporting the problem.
User Response: Determine when the resource is no
longer stopped, and rerun the job. Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
Operator Response: If this reason code appears in 3, 5, 32, 72.
message DSNT500I or DSNT501I, determine whether
the resource should be stopped.
00C90083
Problem Determination: The requested operation is
not performed. An SQLCODE -904 or -923 is issued, Explanation: An attempt was made to allocate a
and/or message DSNT500I or message DSNT501I is resource for update operations. However, the resource
issued. For more information, refer to the SQL return is already allocated to a DB2 utility function that allows
code in Part 2. SQL Return Codes, or to the description other users to have read-only access.
of the DSNT500I or DSNT501I message in Chapter 17. This reason code is issued by the following CSECTs:
DSNT... Messages.
DSNIDBCJ DSNIDBCO DSNIDBCQ
SYS1.LOGREC contains information in the variable
recording area (VRA) of the system diagnostic work
area (SDWA). Significant fields for this code are: System Action: DB2 determines whether there is a
VRARRK13, VRARRK14, and VRARRK15. utility function that would prohibit allocation of the
resource. If it finds an indication of a such a utility, the
If you suspect an error in DB2, refer to Part 2 of DB2
allocation of the resource is not allowed.
Diagnosis Guide and Reference for information on
identifying and reporting the problem. User Response: Determine when the resource is no
longer restricted by a utility and is started for read/write
Collect the following diagnostic items listed in
access, and rerun the job.
“Appendix B. Problem determination” on page 1281: 1,
3, 5, 32. Problem Determination: The requested operation is
not performed. An SQLCODE -904 or -923 is issued,
and/or message DSNT501I is issued.
00C90082
The resource allocated to the DB2 utility function might
Explanation: An attempt was made to allocate a
be either in use by a utility or reserved for a utility. If the
resource that is already allocated to a DB2 utility
resource is reserved for a utility, but not currently in use,
function.
the -DISPLAY UTILITY command will indicate that no
This reason code is issued by the following CSECTs: utilities are operating on that object. The -DISPLAY
DATABASE command shows which restrictive states
DSNIDBCJ DSNIDBCO DSNIDBCQ DB2 assigned to the resource in question. Utilities set a
restrictive state (for example, UTRO) on the resource
System Action: The allocation process is not allowed. that they are processing, and then remove this state
when the utility successfully completes. Therefore, if the
User Response: Determine when the resource is -DISPLAY DATABASE command is issued after the
available and rerun the job. successful completion of the utility, the restrictive state
set by the utility is not displayed. To access a resource
Problem Determination: The requested operation is
that is reserved for a utility, use the -TERM UTILITY
not performed. An SQLCODE -904 or -923 is issued,
command. For more information, refer to the SQL return
and/or message DSNT501I is issued. The resource
code in “Part 2. SQL Return Codes” on page 9, or to the
allocated to the DB2 utility function might be either in
description of the DSNT501I message in “Chapter 17.
use by a utility or reserved for a utility. If the resource is
DSNT... Messages” on page 375.
reserved for a utility, but not currently in use, the
-DISPLAY UTILITY command will indicate that no SYS1.LOGREC contains information in the variable
utilities are operating on that object. To access a recording area (VRA) of the system diagnostic work
resource that is reserved for a utility, use the -TERM area (SDWA). Significant fields for this code are:
UTILITY command. For more information, refer to the VRARRK13, VRARRK14, and VRARRK15.
SQL return code in “Part 2. SQL Return Codes” on
page 9, or to the description of the DSNT501I message If you suspect an error in DB2, refer to Part 2 of DB2
in “Chapter 17. DSNT... Messages” on page 375. Diagnosis Guide and Reference for information on
identifying and reporting the problem.
SYS1.LOGREC contains information in the variable
Collect the following diagnostic items listed in
772 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C90084 • 00C90086
“Appendix B. Problem determination” on page 1281: 1, User Response: To resolve the above situation, do
3, 5, 32, 72. one of the following:
v Reduce the number of concurrent transactions.
v Increase primary/secondary quantity defined for the
00C90084
table space(s) in the temporary file database.
Explanation: The temporary file with the page size v Increase space allocated to temporary file database.
shown in NAME is not available. An error was detected
Problem Determination: The requested operation is
either during the opening of the page set or during the
not performed. An SQLCODE -904 is issued, and/or
formatting of the header and the space map pages of
message DSNT500I is issued. For more information,
the page set.
refer to the SQL return code in “Part 2. SQL Return
This reason code is issued by the following CSECTs: Codes” on page 9, or to the description of the
DSNIWKFL, DSNITFFS DSNT500I message in “Chapter 17. DSNT... Messages”
on page 375.
System Action: DB2 startup/restart continues if this
reason code appears in a DSNT500I message issued SYS1.LOGREC contains information in the variable
during the startup process. recording area (VRA) of the system diagnostic work
area (SDWA). Significant fields for this code are:
If the reason code appears in a DSNT500I message VRARRK13, VRARRK14, and VRARRK15. If you
issued during the -START DATABASE command, the suspect an error in DB2, refer to Part 2 of DB2
request fails. In either case, the temporary file function Diagnosis Guide and Reference for information on
does not allocate any temporary file on the page set. identifying and reporting the problem.
User Response: Delete and redefine the temporary Collect the following diagnostic items listed in
data set(s) in question, and then issue the -START “Appendix B. Problem determination” on page 1281: 1,
DATABASE command to start the temporary file. 3, 5, 17, 32, 52.
Problem Determination: The requested operation is
not performed. An SQLCODE -904 is issued, and/or 00C90086
message DSNT500I is issued. For more information,
refer to the SQL return code in “Part 2. SQL Return Explanation: An attempt was made to allocate a
Codes” on page 9, or to the description of the resource that is started for DB2 utility access only.
DSNT500I message in “Chapter 17. DSNT... Messages”
This reason code is issued by the following CSECTs:
on page 375.
SYS1.LOGREC contains information in the variable DSNIDBCA DSNIDBCI DSNIDBCN DSNIDBCP
recording area (VRA) of the system diagnostic work
area (SDWA). Significant fields for this code are: System Action: The allocation process is not allowed.
VRARRK13, VRARRK14, and VRARRK15. If you
suspect an error in DB2, refer to Part 2 of DB2 User Response: Determine when the resource is
Diagnosis Guide and Reference for information on available for use, and rerun the job.
identifying and reporting the problem. Operator Response: If this reason code appears in
Collect the following diagnostic items listed in message DSNT501I, determine whether the resource
“Appendix B. Problem determination” on page 1281: 1, should be started for utility access only.
3, 4, 5, 10, 32. Problem Determination: The requested operation is
not performed. An SQLCODE -904 or -923 is issued,
00C90085 and/or message DSNT501I is issued. For more
information, refer to the SQL code in “Part 2. SQL
Explanation: The limit of 253 extends for a temporary Return Codes” on page 9, or to the description of the
file has been reached. DSNT500I message in “Chapter 17. DSNT... Messages”
One of the following could be the reason. on page 375.
v Large number of concurrent transactions requiring SYS1.LOGREC contains information in the variable
use of temporary files. recording area (VRA) of the system diagnostic work
v Small primary/secondary quantity defined for table area (SDWA). Significant fields for this code are:
space(s) in temporary file database. VRARRK13, VRARRK14, and VRARRK15.
v Inadequate space allocated to temporary file
database. If you suspect an error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on
This reason code is issued by the following CSECT: identifying and reporting the problem.
DSNIWCUB Collect the following diagnostic items listed in
System Action: The request to extend temporary file “Appendix B. Problem determination” on page 1281: 1,
is not allowed. 3, 5, 32.
Chapter 37. DB2 Codes 773
00C90087 • 00C90089
diagnostic information. For a discussion of the effects of
00C90087
locking, see Part 5 (Volume 2) of DB2 Administration
Explanation: A page that is marked as 'broken' has Guide . If you suspect and error in DB2, refer to Part 2
been read. The database, table space or index space, of DB2 Diagnosis Guide and Reference for information
and the page number are identified in NAME. on identifying and reporting the problem.
This reason code is issued by the following CSECT: Collect the following diagnostic items listed in
DSNIADBR “Appendix B. Problem determination” on page 1281: 1,
3, 5, 18, 32, 36, 38.
System Action: The data manager function that
detected this condition returns a 'resource not available'
condition to its invoker. Access to the page is not be 00C90089
permitted until it is repaired.
Explanation: The environmental descriptor manager
User Response: If the TYPE is '00000300', examine (EDM) function of the data manager subcomponent did
the name to determine if the page is in an index space not have enough storage in its pool or data space to
or a table space. Use the REPAIR utility to fix the support the retrieval of object with ID 'object id' (DBD
broken page. ID, SKCT plan name or SKPT package name). The
object can be either a database descriptor (DBD), a
Problem Determination: The requested operation is
skeleton cursor table (SKCT) or a skeleton package
not performed. An SQLCODE -904 or -923 is issued,
table (SKPT).
and/or message DSNT500I is issued. For more
information, refer to the SQL return code in “Part 2. SQL This reason code is issued by the following CSECTs:
Return Codes” on page 9, or to the description of the
DSNT500I message in “Chapter 17. DSNT... Messages” DSNGEDLC DSNGEDST DSNGEELC DSNGEFSP
on page 375. DSNGESLC DSNGEPLC
SYS1.LOGREC contains information in the variable
recording area (VRA) of the system diagnostic work System Action: The requested operation is not
area (SDWA). Significant fields for this code are: performed.
VRARRK13, VRARRK14, and VRARRK15. If you User Response: Invoke the application again. If, after
suspect an error in DB2, refer to Part 2 of DB2 several attempts, there is still not enough space, the
Diagnosis Guide and Reference for information on following actions can be taken to reduce EDM storage
identifying and reporting the problem. requirements:
Collect the following diagnostic items listed in v Reduce the number of concurrent users using DB2.
“Appendix B. Problem determination” on page 1281: 1, v Try reducing the number of SQL statements in the
3, 5, 32. plan or package and rebind.
v Try to simplify the database design—for example,
reduce the number of partitions in the database.
00C90088
Explanation: The resource identified by NAME in To increase the EDM pool size definition, on the
message DSNT501I is involved in a deadlock condition. UPDATE install panels:
v If EDM storage shortage is a recurring problem,
This reason code is issued by the following CSECT: change the installation parameters that affect the size
DSNILMCL of the EDM pool—that is, increase the number of
System Action: The requested operation is not concurrent users and the number of currently active
performed. databases, then restart DB2.
User Response: Rerun the application. Problem Determination: The requested operation is
not performed. An SQLCODE -904 or -923 is issued,
System Programmer Response: If the deadlock and/or message DSNT500I is issued. For more
condition becomes chronic, examine the mix of information, refer to the SQL return code in “Part 2. SQL
applications running to determine why the deadlock is Return Codes” on page 9, or to the description of the
occurring. DSNT500I message in “Chapter 17. DSNT... Messages”
Problem Determination: The requested operation is on page 375.
not performed. An SQLCODE -911, -913, or -923 is SYS1.LOGREC contains information in the variable
issued, and/or message DSNT501I is issued. For more recording area (VRA) of the system diagnostic work
information, refer to the SQL return code in “Part 2. SQL area (SDWA). Significant fields for this code are:
Return Codes” on page 9, or to the description of the VRARRK13, VRARRK14, and VRARRK15. If you
DSNT501I message in “Chapter 17. DSNT... Messages” suspect an error in DB2, refer to Part 2 of DB2
on page 375. Diagnosis Guide and Reference for information on the
If statistics trace class 3 is active, IFCID 172 contains identifying and reporting the problem.
774 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C9008A • 00C9008D
Collect the following diagnostic items listed in Diagnosis Guide and Reference for information on the
“Appendix B. Problem determination” on page 1281: 1, identifying and reporting the problem.
3, 5, 32.
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
00C9008A 3, 5, 32.
Explanation: The database procedure installation exit
identified by NAME could not be loaded for execution. 00C9008C
This reason code is issued by the following CSECTs: Explanation: An attempt was made to allocate or bind
DSNIREDR, DSNIENSR to a partitioned table space for which no clustering
index was defined.
System Action: The requested operation is not
performed. This reason code is issued by the following CSECTs:
User Response: Determine the reason the installation DSNISPSC DSNICUBC DSNIALLC
exit could not be loaded, correct the problem, and rerun
the job.
System Action: The bind or allocation process is not
Problem Determination: The requested operation is allowed.
not performed. An SQLCODE -904 is issued, and/or
message DSNT500I is issued. For more information, User Response: Define the clustering index for the
refer to the SQL return code in “Part 2. SQL Return partitioned table space, and rerun the job.
Codes” on page 9, or to the description of the Problem Determination: The requested operation is
DSNT500I message in “Chapter 17. DSNT... Messages” not performed. An SQLCODE -904 is issued, and/or
on page 375. message DSNT501I is issued. For more information,
SYS1.LOGREC contains information in the variable refer to the SQL return code in “Part 2. SQL Return
recording area (VRA) of the system diagnostic work Codes” on page 9, or to the description of the
area (SDWA). Significant fields for this code are: DSNT501I message in “Chapter 17. DSNT... Messages”
VRARRK13, VRARRK14, and VRARRK15. If you on page 375.
suspect an error in DB2, refer to Part 2 of DB2 SYS1.LOGREC contains information in the variable
Diagnosis Guide and Reference for information on the recording area (VRA) of the system diagnostic work
identifying and reporting the problem. area (SDWA). Significant fields for this code are:
Collect the following diagnostic items listed in VRARRK13, VRARRK14, and VRARRK15. If you
“Appendix B. Problem determination” on page 1281: 1, suspect an error in DB2, refer to Part 2 of DB2
3, 5, 32. Diagnosis Guide and Reference for information on
identifying and reporting the problem.
00C9008B Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
Explanation: An attempt was made to create a 3, 5, 15, 17, 32, 33, 35.
database, but no DBIDs are available; that is, the
system limit has been reached.
00C9008D
This reason code is issued by the following CSECT:
DSNGDCID Explanation: An attempt was made to bind to a table
space that had an incomplete clustering definition.
System Action: The create is not allowed.
This reason code is issued by the following CSECTs:
User Response: DROP all unused databases, and DSNISPSC, DSNIPSFI
rerun the job.
System Action: The bind process is not allowed.
Problem Determination: The requested operation is
not performed. An SQLCODE -904 is issued, and/or User Response: Complete the clustering definition for
message DSNT500I is issued. For more information, the table space, and rerun the job.
refer to the SQL return code in “Part 2. SQL Return Problem Determination: The requested operation is
Codes” on page 9, or to the description of the not performed. An SQLCODE -904 is issued, and/or
DSNT500I message in “Chapter 17. DSNT... Messages” message DSNT501I is issued. For more information,
on page 375. refer to the SQL return code in “Part 2. SQL Return
SYS1.LOGREC contains information in the variable Codes” on page 9, or to the description of the
recording area (VRA) of the system diagnostic work DSNT501I message in “Chapter 17. DSNT... Messages”
area (SDWA). Significant fields for this code are: on page 375.
VRARRK13, VRARRK14, and VRARRK15. If you SYS1.LOGREC contains information in the variable
suspect an error in DB2, refer to Part 2 of DB2 recording area (VRA) of the system diagnostic work
Chapter 37. DB2 Codes 775
00C9008E • 00C90090
area (SDWA). Significant fields for this code are: available only after all of the following:
VRARRK13, VRARRK14, and VRARRK15. If you v The DROP is committed.
suspect an error in DB2, refer to Part 2 of DB2
v The DB2 REORG is run on the table space and there
Diagnosis Guide and Reference for information on
is no point in time recover after the REORG.
identifying and reporting the problem.
v MODIFY is run to delete all image copies of data that
Collect the following diagnostic items listed in contains rows of the dropped table, that is, copies
“Appendix B. Problem determination” on page 1281: 1, that were taken before the REORG. Note that
3, 5, 15, 17, 32, 33, 35. MODIFY will reclaim space in the DBD only if there
are SYSCOPY rows to delete.
00C9008E Problem Determination: The requested operation is
Explanation: A lock request for the resource identified not performed. An SQLCODE -904 is issued, and/or
by NAME could not be granted, and the request waited message DSNT500I is issued. For more information,
for a period longer than the maximum specified by the refer to the SQL return code in “Part 2. SQL Return
installation. Codes” on page 9, or to the description of the
DSNT500I message in “Chapter 17. DSNT... Messages”
This reason code is issued by the following CSECT: on page 375.
DSNILMCL
SYS1.LOGREC contains information in the variable
System Action: The data manager function that recording area (VRA) of the system diagnostic work
detected this condition returns 'resource not available' to area (SDWA). Significant fields for this code are:
its invoker. VRARRK13, VRARRK14, and VRARRK15. If you
Message DSNT378I might also be issued. suspect an error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on
Problem Determination: The requested operation is identifying and reporting the problem.
not performed. An SQLCODE -904, -911, -913, or -923
is issued, and/or message DSNT501I is issued. For Collect the following diagnostic items listed in
more information, refer to the SQL return code in “Appendix B. Problem determination” on page 1281: 1,
“Part 2. SQL Return Codes” on page 9, or to the 3, 5, 32.
description of the DSNT501I message in “Chapter 17.
DSNT... Messages” on page 375. If a time-out occurs, 00C90090
see also the "System Programmer Response" in
message DSNT376I for problem determination. Explanation: An attempt to lock a required resource
failed.
SYS1.LOGREC contains information in the variable
recording area (VRA) of the system diagnostic work System Action: The operation is not performed.
area (SDWA). Significant fields for this code are: User Response: Wait for all jobs which hold a lock on
VRARRK13, VRARRK14, and VRARRK15. If you the resource in an incompatible lock state to complete
suspect an error in DB2, refer to Part 2 of DB2 before reissuing the failing statement.
Diagnosis Guide and Reference for information on
identifying and reporting the problem. Problem Determination: The requested operation is
not performed.
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1, If the resource type is table space, table, or index, then
3, 5, 18, 32, 36, 38. issue the -DISPLAY DATABASE command with the
LOCKS option to get a list of jobs which currently hold
locks on the required resource.
00C9008F
If the resource type is a package, then wait for BIND
Explanation: The database descriptor's size (DBD) activity on that package to complete before reissuing
has reached the limit of 25% of the EDM Pool size. the failing request.
This reason code is issued by the following CSECT: If the problem persists after jobs which hold
DSNGDCPD incompatible locks complete, gather diagnostic
System Action: The request to create/alter a information to pursue the problem.
database object is not allowed. SYS1.LOGREC contains information in the variable
User Response: Create the database object in a recording area (VRA) of the system diagnostic work
different database or drop unused database objects area (SDWA). Significant fields for this code are:
from the database. If you drop an object that is an index VRARRK13, VRARRK14, and VRARRK15. If you
or a table space, the space becomes available in the suspect an error in DB2, refer to Part 2 of DB2
DBD as soon as the drop is committed. If you drop an Diagnosis Guide and Reference for information on
object that is a table, the space in the DBD is made identifying and reporting the problem.
776 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C90091 • 00C90093
Collect the following diagnostic items listed in locking protocol on one or more table spaces. Use one
“Appendix B. Problem determination” on page 1281: 1, of the following:
3, 5, 32, 33. v ALTER TABLESPACE...LOCKSIZE ANY
v ALTER TABLESPACE...LOCKSIZE TABLESPACE
v LOCK TABLE statements
00C90091
Explanation: The table space or index space could If application logic permits, reduce the number of page
not be started, because there is an outstanding indoubt or row locks concurrently held for SELECT statements
UR that must be resolved before the start is allowed. by re-binding application plans with isolation level of
cursor stability instead of repeatable read or read
This reason code is issued by the following CSECT:
stability.Refer to Chapter 4 of DB2 SQL Reference for
DSNILSTS
further information on SELECT.
System Action: The START operation is not
performed. You can reduce the total number of LOB locks that
applications concurrently hold by changing the locking
Problem Determination: Message DSNI002I is
protocol on one or more LOB table space. Use one of
issued. See the description of that message for
the following:
additional information.
v ALTER TABLESPACE...LOCKSIZE TABLESPACE
SYS1.LOGREC contains information in the variable v LOCK TABLE statement
recording area (VRA) of the system diagnostic work
Problem Determination: One or more of the following
area (SDWA). Significant fields for this code are:
might be issued:
VRARRK13, VRARRK14, and VRARRK15. If you
v An SQLCODE -904 or -923
suspect an error in DB2, refer to Part 2 of DB2
v Message DSNT501I
Diagnosis Guide and Reference for information on
v An abend
identifying and reporting the problem.
Collect the following diagnostic items listed in SYS1.LOGREC contains information in the variable
“Appendix B. Problem determination” on page 1281: 1, recording area (VRA) of the system diagnostic work
3, 5, 32, 33. area (SDWA). Significant fields for this code are:
VRARRK13, VRARRK14, and VRARRK15. If you
suspect an error in DB2, refer to Part 2 of DB2
00C90092
Diagnosis Guide and Reference for information on
Explanation: DB2 received an out-of-storage identifying and reporting the problem.
indication from IRLM resulting from a lock, unlock, or
lock change request. Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
This reason code is issued by the following CSECT:
3, 5, 18, 32, 35, 36.
DSNILMCL
System Action: A record is written to SYS1.LOGREC
00C90093
only when an abend is issued. No dump is requested.
Explanation: An error occurred in IRLM.
Operator Response: Notify the system programmer.
This reason code is issued by the following CSECT:
System Programmer Response: IRLM has
DSNILMCL
exhausted the amount of virtual storage available to it to
represent locks. Insufficient virtual storage remains to System Action: A record is written to SYS1.LOGREC,
satisfy this request. Refer to Part 5 (Volume 2) of DB2 and an SVC dump is requested.
Administration Guide for the IRLM procedure to
Operator Response: Notify the system programmer.
determine the amount of storage space available.
System Programmer Response: Examine
The current mix of transactions caused all available
SYS1.LOGREC for a preceding error related to IRLM.
storage to be used. You can find the number of locks
held by a particular transaction by either using the DB2 Problem Determination: One or more of the following
performance trace facility or by performing IRLM tracing. might be issued:
Refer to Part 5 (Volume 2) of DB2 Administration Guide v An SQLCODE -904 or -923
for information about the DB2 performance trace facility. v Message DSNT501I
v An abend
Determine what transactions were running and the
number of locks they held. You might want to schedule
some of these transactions at a different time. SYS1.LOGREC contains the same diagnostic
information in the variable recording area (VRA) as
You can reduce the total number of page or row locks shown for abend reason code '00C90101'. The first four
that applications concurrently hold by changing the
Chapter 37. DB2 Codes 777
00C90094 • 00C90095
bytes of CTSIWHY contain the return code from the status of the data set. If the data set is stopped, use the
IRLM function. The fifth byte of CTSIWHY contains the START command before performing recovery.
request code, as follows:
Problem Determination: For more information, refer
X'02' Lock
to the SQL return code in “Part 2. SQL Return Codes”
X'03' Unlock
on page 9, or to the description of the DSNT500I
X'04' Change
message in “Chapter 17. DSNT... Messages” on
page 375.
SYS1.LOGREC contains information in the variable
recording area (VRA) of the system diagnostic work This error is detected at a time when the specific name
area (SDWA). Significant fields for this code are: of the data set involved cannot be determined by DB2.
VRARRK13, VRARRK14, and VRARRK15. If you However, the SQL return code or message DSNT500I
suspect an error in DB2, refer to Part 2 of DB2 provides the name of the table space or index space in
Diagnosis Guide and Reference for information on which the data set resides. When the table or index
identifying and reporting the problem. space consists of a single data set, this is specific.
Otherwise, the system programmer must find the
Collect the following diagnostic items listed in particular data set within the table or index space.
“Appendix B. Problem determination” on page 1281: 1,
SYS1.LOGREC contains information in the variable
3, 5, 18, 32, 35, 36.
recording area (VRA) of the system diagnostic work
area (SDWA). Significant fields for this code are:
00C90094 VRARRK13, VRARRK14, and VRARRK15. If you
suspect an error in DB2, refer to Part 2 of DB2
Explanation: A data set is in a state that is different Diagnosis Guide and Reference for information on
from what DB2 expects. Possible causes are: identifying and reporting the problem.
v A data set was deleted and redefined without DB2’s
knowledge. Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
v A previous DB2 failure involving the data set might 3, 5, 10, 32, 33, 35.
have occurred.
This reason code is issued by the following CSECT: 00C90095
DSNIBMCL Explanation: An attempt was made during DB2 restart
System Action: The requested action is not to access a page in order to apply a log record but DB2
performed. If the invoker of this module (DSNIBMCL) was unable to access the page. This abend reason
abends, a record is written to SYS1.LOGREC, and the code appears as the reason code in message
invoker probably initiates a dump. If the invoker does DSNI001I.
not abend, no record is written to SYS1.LOGREC, and This abend reason code is issued by the following
no dump is requested. If this occurs, an SQL return CSECTs: DSNIBMOC, DSNIIMPD
code is issued, and/or message DSNT500I is issued. If
the invoker of DSNIBMCL is not a utility, the data set is System Action: The restart of the named table space,
placed in a stopped status. index space, or partition is deferred by the subsystem.
User Response: If the code was received while Operator Response: Notify the system programmer.
processing a user table, DB2 determined that the data
System Programmer Response: Correct the
set is empty. A DROP TABLESPACE statement followed
problem, and then use either the -START DATABASE
by a CREATE TABLESPACE statement and a CREATE
command or the RECOVER utility to make the table
TABLE statement defines the dropped table to DB2.
space, index space, or partition available.
Use the IDCAMS LISTCAT for the failing DB2 dataset.
Check the HI-USED-RBA for this dataset; if Problem Determination: Examine previous messages
HI-USED-RBA = 0, the dataset is empty.If it was on the console to determine why DB2 could not access
received while processing a DB2 catalog or directory, the page. One possible reason is that a back-level pack
then recover the object as specified in DB2 was mounted. That is, the page to which the log record
Administration Guide in the section ″Recovering Catalog applies was not yet formatted by VSAM. DB2 does not
and Directory Objects″. extend data sets during restart.
Operator Response: Notify the system programmer. SYS1.LOGREC contains information in the variable
recording area (VRA) of the system diagnostic work
System Programmer Response: If you do not have
area (SDWA). Significant fields for this code are:
the current level of the data set, you must perform DB2
VRARRK13, VRARRK14, and VRARRK15. If you
recovery to return the data set to its expected state.
suspect an error in DB2, refer to Part 2 of DB2
See the Problem Determination section of this message
Diagnosis Guide and Reference for information on
for procedures to determine the name of the data set to
identifying and reporting the problem.
be corrected. Use the DISPLAY command to check the
778 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C90096 • 00C90097
Collect the following diagnostic items listed in information refer to the SQL return code in “Part 2. SQL
“Appendix B. Problem determination” on page 1281: 1, Return Codes” on page 9, or message DSNT500I or
3, 5, 13, 32, 33. DSNT501I in “Chapter 17. DSNT... Messages” on
page 375.
00C90096 SYS1.LOGREC contains information in the variable
recording area (VRA) of the system diagnostic work
Explanation: The page, row or LOB lock on the page
area (SDWA). Significant fields for this code are:
or subpage identified by NAME in message DSNT500I
VRARRK13, VRARRK14, and VRARRK15.
or DSNT501I caused the total number of page, row or
LOB locks concurrently held to reach the installation If you suspect an error in DB2, refer to Part 2 of DB2
maximum number of page, row or LOB locks Diagnosis Guide and Reference for information on
(NUMLKUS) allowed for a single agent in the system. identifying and reporting the problem.
This reason code is issued by the following CSECT: Collect the following diagnostic items listed in
DSNILMCL “Appendix B. Problem determination” on page 1281: 1,
3, 5, 32.
System Action: The operation that encountered this
condition is not executed. If a utility job encountered this
condition, the utility is stopped. Otherwise, any database 00C90097
updates for the statement that was executing are
Explanation: An attempt was made to allocate to a
backed out. Any database reads for the statement that
table space for update operations. However, the table
was executing are not executed. The position of the
space was marked as 'image copy' required, and
cursor is unpredictable.
updates are not allowed. This condition occurs as a
User Response: Rerun the application after correcting result of any of the following:
the cause of this resource unavailable condition. v Running a REORG LOG NO or LOAD LOG NO utility
Programmer Response: Reduce the total number of on the table space without running a copy that
page, row or LOB locks that the application concurrently specifies FULL YES.
holds by changing the locking protocol on one or more v Execution of a RECOVER utility which specifies the
of the table spaces to table space level locking. To do TORBA or TOCOPY options, without following it with
this, use the ALTER ... LOCKSIZE TABLESPACE or the required COPY utility.
LOCK TABLE statements. v Execution of a -TERM UTILITY command on a
Review the application to see if a different choice of COPY utility that failed during the copy phase or was
SQL statements can be used to perform the same active in the copy phase. Until the COPY utility
operation with less concurrent access to multiple tables completes, SQL updates are not allowed because the
with page, row or LOB locking. the integrity of the data would be compromised.
v Execution of a MODIFY utility after all back up copies
If application logic permits, reduce the number of page,
of the table space or data set were deleted from the
row or LOB locks concurrently held for SELECT
SYSCOPY catalog table.
statements by rebinding the application plan with
isolation level of cursor stability instead of repeatable
This reason code is issued by the following CSECTs:
read or read stability, or add more frequent commits.
System Programmer Response: If the application DSNIDBCJ DSNIDBCO DSNIDBCQ
should be able to run with the current page, row or LOB
locking protocol and SQL statements, increase the System Action: The allocation process is not allowed.
NUMLKUS value for the installation to allow a higher
limit of page, row or LOB locks to be concurrently held User Response: Run the COPY utility. However, if the
by a single application. If a utility job encountered this table space is to be used for read-only access, or if
resource unavailable condition, the NUMLKUS value recoverability of the data is not required, instead of
must be increased to accommodate the utility, because taking a full image copy you can run the REPAIR utility
utilities are programmed to use the minimum number of and request that the image copy required condition be
page, row or LOB locks possible. Refer to Part 5 removed.
(Volume 2) of DB2 Administration Guide for further
Problem Determination: The requested operation is
information about choosing the value for NUMLKUS.
not performed. An SQLCODE -904 and/or message
Operator Response: If a utility job encountered this DSNT501I is issued. For more information, refer to the
resource unavailable condition, terminate the utility and SQL return code in “Part 2. SQL Return Codes” on
restart it after the cause of the resource unavailable page 9 or to the description of the DSNT501I message
condition has been corrected. in “Chapter 17. DSNT... Messages” on page 375.
Problem Determination: An SQLCODE -904 and SYS1.LOGREC contains information in the variable
message DSNT500I or DSNT501I are issued. For more recording area (VRA) of the system diagnostic work
Chapter 37. DB2 Codes 779
00C90098 • 00C9009B
area (SDWA). Significant fields for this code are: System Programmer Response: Use the -TERM
VRARRK13, VRARRK14, and VRARRK15. UTILITY command to terminate the load utility and
reduce the UIP (utility in process) counts.
If you suspect an error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on Problem Determination: For more information, refer
identifying and reporting the problem. to the explanation of message DSNT500I in the Service
Controller Messages section of this book.
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1, Collect the following diagnostic items listed in
3, 5, 32. “Appendix B. Problem determination” on page 1281: 1,
32, 37.
00C90098
00C9009A
Explanation: An attempt was made to increase
read-only or write-access counts of the utility in process Explanation: An attempt was made to create a
beyond the maximum (255) allowed. system database which, according to the DBID space
map, has already been created. However, the catalog
This abend reason code is issued by the following
shows the database was not created. This discrepancy
CSECT: DSNIDBMF.
between the catalog and the space map for DBIDs may
User Response: Use the -DISPLAY UTILITY be due to an unsuccessful migration.
command to determine how many utility jobs are
This abend reason code is issued by the following
currently active. If a number of utility jobs are active but
CSECT: DSNGDCID
not in the stopped state, notify the system programmer.
If the utility jobs are running, resubmit your job after System Action: Database is not created.
they complete.
Operator Response: Notify the system programmer.
System Programmer Response: Determine why
System Programmer Response: Drop the database,
active utilities are in the stopped state. Use the -TERM
then create it (using DROP and CREATE commands). If
UTILITY command to terminate utilities and reduce the
this fails to resolve the error, follow the steps in problem
UIP (utility in process) counts. If no active utilities are
determination.
indicated, then use the -DISPLAY DATABASE command
to show which table spaces or partitions are in a UTRO Problem Determination: The requested operation is
or UTRW state. not performed. An SQLCODE -904 is issued, and/or
message DSNT500I is issued. For more information,
Problem Determination: Message DSNT500I is
refer to the SQL return code in “Part 2. SQL Return
issued. For more information, refer to the explanation of
Codes” on page 9, or to the description of the
message DSNT500I.
DSNT500I message in “Chapter 17. DSNT... Messages”
on page 375.
00C90099
SYS1.LOGREC contains information in the variable
Explanation: An attempt was made to load data into a recording area (VRA) of the system diagnostic work
partition, but the partition is full. Based on the High Key area (SDWA). Significant fields for this code are:
value specified in the Index for each partition, utilities VRARRK13, VRARRK14, and VRARRK15. If you
instructed Data Manager to load a record into the suspect an error in DB2, refer to Part 2 of DB2
proper partition. This required Data Manager to build a Diagnosis Guide and Reference for information on
new page with a page number one higher than the last identifying and reporting the problem.
page in the partition. However, this new page is in the
Collect the following diagnostic items listed in
next partition.
“Appendix B. Problem determination” on page 1281: 1,
This abend reason code is issued by the following 3, 5, 32, 38, 39.
CSECT: DSNILPG
System Action: The requested action is not 00C9009B
performed.
Explanation: An attempt was made to load data into a
User Response: Redefine the High Key values in the linear table space, but the table space is full. A linear
Index and retry the load. table space can contain a maximum of 64GB of data.
If you receive this code during a reorganization, query This abend reason code is issued by the following
the catalog to check the PCTFREE and FREEPAGE CSECT: DSNILPG
values. You might be able to decrease the amount of
System Action: The requested action is not
free space to allow the REORG utility to complete
performed.
successfully.
User Response: Use the -TERM UTILITY command
Operator Response: Notify the system programmer.
780 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C9009C • 00C9009E
to terminate the LOAD utility. Use ALTER TABLE System Action: A 'resource not available' code is
SPACE to reduce the amount of free space within a returned to the end user and the requested action is not
page (PCTFREE) and the number of free pages within performed. The SVC dump and the SYS1.LOGREC
the table space (FREEPAGE). Then retry the load. If it recording are not requested.
is a resume load job, reorganize the table space before
User Response: Notify the system programmer to
rerunning the load.
reclaim some free space in the associated table space
Problem Determination: For more information, refer or index space and rerun the job.
to the explanation of message DSNT500I in
System Programmer Response: The table space or
“Chapter 17. DSNT... Messages” on page 375.
index space name is identified in the DSNT501I
Collect the following diagnostic items listed in message. If it is a table space, run the DB2 REORG
“Appendix B. Problem determination” on page 1281: 1, utility to attempt to reclaim additional free space. If it is
32, 37. an index space, drop and recreate the index with a
fewer number of SUBPAGEs. If free space cannot be
reclaimed, notify the database administrator to
00C9009C
redistribute the data into different table spaces or index
Explanation: An attempt was made to insert data into spaces.
a partitioned table space or index space, but the
If you suspect an error in DB2, refer to Part 2 of DB2
partition is full. For table space partition, the data to be
Diagnosis Guide and Reference for information on
inserted is based on the high-key value specified in the
identifying and reporting the problem.
cluster index. If it is an index space partition, the index
entry to be inserted is also based on the high-key value Problem Determination: For more information, refer
associated with the index. to the explanation of message DSNT501I in
“Chapter 17. DSNT... Messages” on page 375.
This abend reason code is issued by the following
CSECTs: DSNISMPI, DSNISMXP Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
System Action: A 'resource not available' code is
37.
returned to the end user and the requested action is not
performed. The SVC dump and the SYS1.LOGREC
recording are not requested. 00C9009E
User Response: Notify the system programmer to Explanation: The object depends on new facilities of
redefine the partitions and rerun the job. the release and is therefore unavailable for processing.
For data-sharing systems, the object will be available on
System Programmer Response: Refer to Part 2
a new release in a data-sharing group. For
(Volume 1) of DB2 Administration Guide to redefine a
non-data-sharing systems, the object will be available
partition. The partition that must be redefined is
after re-migration if release fall back has occurred.
identified in the DSNT501I message.
This abend reason code is issued by the following
If you suspect an error in DB2 refer to Part 2 of DB2
CSECTs: DSNICUBC, DSNIPSFI
Diagnosis Guide and Reference for information on
identifying and reporting the problem. System Action: The operation is not allowed. The
data manager function that detected this condition
Problem Determination: For more information, refer
returns 'resource not available' to its invoker.
to the explanation of message DSNT501I in
“Chapter 17. DSNT... Messages” on page 375. Operator Response: Notify the system programmer.
Collect the following diagnostic items listed in System Programmer Response: In order to perform
“Appendix B. Problem determination” on page 1281: 1, the operation on the object:
37. v For non-data sharing systems a re-migration is
required.
00C9009D v For data sharing systems, insure that the operation is
performed on a member at the correct level of DB2.
Explanation: An attempt was made to insert data into
a linear table space or index space, but the table space
If you suspect an error in DB2, refer to Part 2 of DB2
or index space is full. A linear table space or index
Diagnosis Guide and Reference for information on
space can contain a maximum of 64GB of data.
identifying and reporting the problem.
This abend reason code is issued by the following
Problem Determination: The requested operation is
CSECTs:
not performed. An SQLCODE -904 is issued. Message
DSNISGPI DSNISMPI DSNISMXP DSNT500I or message DSNT501I may also be issued.
For more information, refer to the “Part 2. SQL Return
Codes” on page 9 or to the description of the DSNT500I
Chapter 37. DB2 Codes 781
00C9009F • 00C900A3
and DSNT501I messages in “Chapter 17. DSNT...
00C900A1
Messages” on page 375.
Explanation: An attempt was made to allocate a table
Collect the following diagnostic items listed in
space or index that is in group recovery pending state.
“Appendix B. Problem determination” on page 1281: 1,
3, 5. System Action: The use of the object is not allowed.
User Response: Run the RECOVER utility, LOAD
00C9009F utility or START DATABASE command to recover the
object.
| Explanation: A table has been referenced that has a
| primary key or unique key but no index exists to enforce Operator Response: Determine whether the
| its uniqueness. The reference is usually to a parent RECOVER utility or START DATABASE command
| table when attempting to verify the referential constraint should be run to complete recovery of the object.
| of an insert or update operation to a dependent table.
Problem Determination: The requested operation is
| This abend reason code is issued by the following not performed because the table space or index might
| CSECTs: be in an inconsistent state. An SQLCODE -904 and/or
message DSNT501I is issued. For more information,
|| DSNIALLC DSNICUBC DSNIKESR DSNIRELI refer to “Part 2. SQL Return Codes” on page 9, or to the
| description of the DSNT501I message in “Chapter 17.
| System Action: The use of the table is not allowed. DSNT... Messages” on page 375.
| User Response: Create a unique index on the Collect the following diagnostic items listed in
| referenced table to enforce the primary key or unique “Appendix B. Problem determination” on page 1281: 1,
| key. 5.
Problem Determination: The requested operation is
not performed. An SQLCODE -904 or -923 is issued. 00C900A3
For more information, refer to “Part 2. SQL Return Explanation: An attempt was made to allocate a table
Codes” on page 9, or to the description of the space, index space, or a related index space while the
DSNT501I message in “Chapter 17. DSNT... Messages” table space or index space was in check pending
on page 375. status.
This abend reason code is issued by the following
00C900A0 CSECTs:
Explanation: An attempt was made to allocate or
DSNIDBCI DSNIDBCJ DSNIDBCN DSNIDBCO
acccess a table space or index that is in the rebuild
DSNIDBCP DSNIDBCQ DSNIDBET DSNIRCCA
pending status (PSRBD) or an index in pageset rebuild
pending status (PSRBD).
System Action: The operation is not allowed.
System Action: The use of the object is not allowed.
Operator Response: Notify the system programmer.
User Response: Determine when the resource is
available for use and rerun the job. System Programmer Response: The check pending
status needs to be resolved before the operation will be
Operator Response: Determine whether the
allowed.
RECOVER utility should be run to complete recovering
the object. If the object is a table space with referential
relationships, then run the CHECK DATA utility to check
Problem Determination: The requested operation is
for referential integrity violations.
not performed because the table space or index might
be in an inconsistent state. An SQLCODE -904 and/or If the object is a base table space with LOB columns,
message DSNT501I and/or message DSNI005I is then run the CHECK DATA utility to validate the
issued. For more information, refer to “Part 2. SQL auxiliary columns.
Return Codes” on page 9, or to the description of the
If the object is a LOB table space, then run the CHECK
DSNT501I message in “Chapter 17. DSNT... Messages”
LOB utility to validate the structure of the LOB table
on page 375.
space.
Collect the following diagnostic items listed in
If the object is an index space, then run the CHECK
“Appendix B. Problem determination” on page 1281: 1,
INDEX utility to verify that the index keys are consistent
5.
with the data in the table space or table space partition.
For more information, see Part 2 (Volume 1) of DB2
Administration Guide.
782 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C900A4 • 00C900A6
Problem Determination: The requested operation is User Response: If the reason code appears in a
not performed. An SQLCODE -904 or -923 is issued. DSNT501I message, issue -DISPLAY THREAD to
For more information, refer to “Part 2. SQL Return determine the total number of concurrent users. If there
Codes” on page 9, or to the description of the were a large number of users using temporary file(s),
DSNT501I message in “Chapter 17. DSNT... Messages” resubmit the job when concurrent users are low.
on page 375. IDCAMS LISTCAT may be used to determine the VSAM
data set(s) space allocations.
v If there was no space available on a volume(s), then
00C900A4
clear space from the volume(s) or add more volumes
Explanation: An attempt was made to allocate a to the STOGROUP or redefine the VSAM data set to
segment for a table in a segmented table space, but concatenate more volumes.
there are no free segments. A segmented table space v If the maximum number of extensions has been
can contain a maximum of 64GB of data. A segment will exceeded for the VSAM data set(s), then ALTER or
be allocated under one of the following conditions: delete and redefine the temporary data set(s) with a
v When a table is ready to be created in a segmented larger size.
table space with the CREATE TABLE statement. v If all the temporary files are full, then create or define
more temporary files.
v When a record is inserted/loaded into a segmented
table and free space is not available from existing
Issue the -START DATABASE command to start the
segments.
temporary file.
This abend reason code is issued by the following Problem Determination: The requested operation is
CSECTs: DSNISEGF, DSNISGNS not performed. An SQLCODE -904 or message
DSNT501I is issued, and/or message DSNT501I is
System Action: A 'resource not available' code is issued. For more information, refer to SQLCODE -904
returned to the end user and the requested action is not in SQL Return Codes, “Part 2. SQL Return Codes” on
performed. page 9, or to the description of the DSNT501I message
User Response: Notify the system programmer to in “Part 3. DB2 Messages” on page 133.
reclaim some free space in the associated segmented Collect the following diagnostic items listed in
table space and rerun the job. “Appendix B. Problem determination” on page 1281: 1,
System Programmer Response: An SQLCODE -904 32, 10, and definitions of temporary file(s) involved in
is issued, and/or message DSNT501I is issued. The the error.
segmented table space name is identified in SQLCA
and/or in the DSNT501I message. If the requested 00C900A6
function is the CREATE TABLE statement, create the
table in a different segmented table space. Otherwise, Explanation: Access to the catalog was requested but
run the DB2 REORG utility to attempt to reclaim denied because the catalog was not migrated to the
additional free space. If no free space can be reclaimed, current release level. The object in the catalog is
then notify the database administrator to redistribute the available after the catalog is migrated.
data into different table spaces.
This abend reason code is issued by the following
Problem Determination: For more information, refer CSECT: DSNICUBC
to the explanation of message DSNT501I in
System Action: The operation is not allowed. The
“Chapter 17. DSNT... Messages” on page 375.
data manager function that detected this condition
Collect the following diagnostic items listed in returns 'resource not available' to its invoker.
“Appendix B. Problem determination” on page 1281: 1,
Operator Response: Notify the system programmer.
37.
System Programmer Response: To perform the
operation on the object, you must migrate the catalog to
00C900A5
the current release. To do this, run DSNTIJTC. Refer to
Explanation: The temporary file(s) is full or the Part 2 of DB2 Installation Guide for information about
maximum number of extensions for a VSAM data set(s) this job.
has been exceeded for all temporary files or the
Problem Determination: The requested operation is
volume(s) has no space available in which to extend.
not performed. SQLCODE -904 and message
This reason code is issued by the following CSECT: DSNT501I are issued. For more information refer to the
DSNIXWKF SQL Return Code section or to the description of the
DSNT501I message in “Chapter 17. DSNT... Messages”
System Action: The reason code appears in a on page 375.
DSNT501I message, and the requested operation is not
performed.
Chapter 37. DB2 Codes 783
00C900A7 • 00C900AA
The abend reason code is issued by the following
00C900A7
CSECT: DSNIDBCN
Explanation: At allocation of a bound plan or a bound
System Action: The allocation process is not allowed.
package, a lock inconsistency is detected. A DB2
internal bind error is probably responsible for this User Response: Determine the reason for which the
condition. The plan or the package cannot be allocated. resource was deferred and take the appropriate action
to correct the problem. Such actions include issuing the
This reason code is issued by the following CSECT:
START DATABASE command or running the RECOVER
DSNIALLC
TABLESPACE, RECOVER INDEX, RECOVER, or
System Action: The plan or the package is not LOAD REPLACE utility.
allocated. A DSNT501I message is issued and an
Problem Determination: The requested operation is
SQLCODE -923 is returned to the application.
not performed. An SQLCODE -904 is issued, and/or
System Programmer Response: Re-bind the plan or message DSNT500I or DSNT501I is issued. For more
the package. information, refer to the SQL return code or to the
description of the DSNT500I or DSNT501I message.
Problem Determination: If the problem persists after
SYS1.LOGREC contains information in the variable
the plan or the package is rebound, collect the following
recording area (VRA) of the system diagnostic work
diagnostic items listed in “Appendix B. Problem
area (SDWA). Significant fields for this code are:
determination” on page 1281: 1, 3, 5, 32, 33.
VRARRK13, VRARRK14, and VRARRK15.
If you suspect an error in DB2, refer to Part 2 of DB2
00C900A8
Diagnosis Guide and Reference for information on
Explanation: The table space, index, or partition could identifying and reporting the problem.
not be started because of a failure to acquire the lock.
Collect the following diagnostic items listed in
Activity on the table space, index, or partition must
“Appendix B. Problem determination” on page 1281: 1,
quiesce before the START DB ACCESS(FORCE)
3, 5, 32, 33
command can acquire the necessary lock.
The abend reason code is issued by the following
00C900AA
CSECT: DSNISTFO
Explanation: The table space or index space could
System Action: The START operation is not
not be stopped because it is indoubt.
performed.
The abend reason code is issued by the following
User Response: Wait for all activity on the table
CSECTs: DSNILSTS DSNIPDBA
space, index, or partition to complete before reissuing
the START command. System Action: The STOP operation is not
performed.
Problem Determination: The requested operation is
not performed. Message DSNI002I is issued. For more User Response: Resolve the indoubt unit of recovery
information, refer to the description of this message in (UR) using the RECOVER INDOUBT command.
“Chapter 10. DSNI... Messages” on page 255. If the
Problem Determination: Message DSNI003I is
problem persists after all activity on the table space,
issued. For more information, refer to the description of
index, or partition completes, gather diagnostic
this message. If the problem persists after all indoubts
information to pursue the problem.
with locks on the table space/index space are resolved,
SYS1.LOGREC contains information in the variable gather diagnostic information to pursue the problem.
recording area (VRA) of the system diagnostic work
SYS1.LOGREC contains information in the variable
area (SDWA). Significant fields for this code are:
recording area (VRA) of the system diagnostic work
VRARRK13, VRARRK14, and VRARRK15. If you
area (SDWA). Significant fields for this code are:
suspect an error in DB2, refer to Part 2 of DB2
VRARRK13, VRARRK14, and VRARRK15. If you
Diagnosis Guide and Reference for information on
suspect an error in DB2, refer to Part 2 of DB2
identifying and reporting the problem.
Diagnosis Guide and Reference for information on
Collect the following diagnostic items listed in identifying and reporting the problem.
“Appendix B. Problem determination” on page 1281: 1,
Collect the following diagnostic items listed in
3, 5, 32, 33
“Appendix B. Problem determination” on page 1281: 1,
3, 5, 32,
00C900A9
Explanation: An attempt was made to allocate a
resource that is deferred.
784 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C900AB • 00C900BA
v DROP tablespace
00C900AB
Problem Determination: The requested operation is
Explanation: An attempt was made to access a
not performed because the table space might be in an
resource that is in the restart pending state.
inconsistent state. A SQLCODE -904 is issued.
System Action: The use of the resource is not
allowed.
00C900AE
System Programmer Response: Use the DISPLAY
Explanation: An attempt was made to allocate or
THREAD TYPE(POSTPONED) to determine the status
access an index that is in the rebuild pending status.
of the resource.
This abend reason code is issued by the following
Use the RECOVER POSTPONED command if recover
CSECTs:
has not already been started.
Problem Determination: The requested operation is DSNIDBCJ DSNIDBCO DSNIDBCQ
not performed because the table space might be in an
inconsistent state. An SQLCODE -904 is issued. For System Action: The use of the object is not allowed.
more information, refer to the ″Section 2. SQL Return
Codes″ in topic A.2 or to the description of the User Response: Determine when the resource is
DSNT501I messages in ″Section 3. DSNT Messages″ available for use and rerun the job.
in topic A.3.
Operator Response: Determine whether the
REBUILD utility should be run to complete recovering
00C900AC the object.
Explanation: The DB2 subsystem currently serves as Problem Determination: The requested operation is
a remote site tracker system. Users cannot have write not performed because the index may be in an
access for tracker systems, and a tracker DB2 will not inconsistent state. An SQLCODE -904 and/or message
allow the use of any SQL statement that requires write DSNT501I and/or message DSNI005I is issued. For
access. more information, refer to “Part 2. SQL Return Codes”
on page 9, or to the description of the DSNT501I
System Action: DB2 cannot process the operation. message in “Chapter 17. DSNT... Messages” on
System Programmer Response: None. page 375.
Problem Determination: A tracker DB2 does not Collect the following diagnostic items listed in
allow the use of any SQL statement that requires write “Appendix B. Problem determination” on page 1281: 1,
access, such as DDL, GRANT/REVOKE, INSERT, 5.
DELETE, or UPDATE. DB2 issues SQL code -904 in
conjunction with this message. You can also find more 00C900BA
information in the description for message DSNT501I,
which DB2 issues along with this reason code. Explanation: A request for a drain lock for the
resource identified by NAME in messages DSNT500I
Additionally, a tracker DB2 does not allow the START and DSNT501I could not be granted. The request
DATABASE command to perform LPL/GRECP recovery. waited for a period longer than the maximum specified
If you attempt a START DATABASE command on a by the installation.
tracker DB2, DB2 will issue message DNSI005I with this
reason code. This reason code is issued by the following CSECT:
DSNILMCL
00C900AD System Action: The requested action is not
performed. The Data Manager function that detected
Explanation: An attempt was made to access a this condition returns 'resource not available' to its
resource that is in the REORG pending state. caller.
This reason code is issued by the following CSECT: User Response: Wait for all jobs that hold a drain lock
System Action: The use of the resource is not on the resource in an incompatible state to complete
allowed. before reissuing the failing statement. To display drain
locks, issue a DISPLAY DB LOCKS command. In order
System Programmer Response: Use the REORG to avoid a potential deadlock, the application should
utility with SHRLEVEL(NONE) PART n1:n2 to resolve either commit or roll back to the previous COMMIT.
the REORG pending state. The following methods may
be used to resolve the REORD pending state: System Programmer Response: See SQLCODE
-913 or -911 and/or message DSNT501I, which
v REORG SHRLEVER(NONE) PART (m:n)
accompany this abend reason code.
v LOAD REPLACE tablespace
If you suspect an error in DB2, refer to Part 2 of DB2
Chapter 37. DB2 Codes 785
00C900BC • 00C900C1
Diagnosis Guide and Reference for information on that would be retained in case of a failure).
identifying and reporting the problem.
This reason code is issued by the following CSECT:
Problem Determination: Collect the following DSNILMCL
diagnostic items listed in “Appendix B. Problem
System Action: SQLCODE -904 is returned to the
determination” on page 1281: 1, 3, 5, 32, 35.
user with this reason code. This reason code and the
resource name are returned in the cursor table (CT) and
00C900BC made available to the user in the SQLCA. If it is active,
an IFCID 0021 trace record is written and might contain
Explanation: The statement depleted the record
additional diagnostic information.
identifier (RID) storage available.
System Programmer Response: If this becomes a
This abend reason code is issued by the following
prevalent problem, you will need to redistribute the
CSECT: DSNIREFS
coupling facility lock structure storage resource to make
System Action: The requested action is not more room for the record list. You can do this in one of
performed. two ways:
v issue a rebuild, or
Operator Response: Notify the system programmer. v dynamically change the lock structure size
System Programmer Response: Restructure the See Chapter 6 of DB2 Data Sharing: Planning and
SQL statement so that fewer RIDs are needed. The Administration for more details about these options.
best way to do this is to split the statement into two or
more SQL statements equivalent to the original
statement. Also, in some cases, increasing the virtual 00C900C0
storage might eliminate the times when storage is
Explanation: A request for an internal lock could not
depleted.
be granted. The request waited for a longer period than
If you suspect an error in DB2, refer to Part 2 of DB2 is allowed.
Diagnosis Guide and Reference for information on
This reason code is issued by the following CSECT:
identifying and reporting the problem.
DSNILMCL
Problem Determination: SQL return code -904 and/or
System Action: The request action is not performed.
message DSNT500I is issued. For more information,
A 'resource not available' reason code is returned to the
refer to the explanation of message DSNT500I.
caller.
User Response: If the user is a DB2 utility, rerun or
00C900BE
restart the utility. If it is a DB2 command, reissue the
Explanation: DB2 is unable to acquire a lock on a command. DB2 applications should either commit or roll
resource because another DB2 subsystem in the DB2 back to the previous commit, then retry from the commit
data sharing group holds an incompatible retained lock point.
on that resource. Retained locks are locks that persist
System Programmer Response: See SQLCODE
across DB2 abnormal terminations.
-911 or -913 and/or message DSNT500I, which
System Action: The requested action is not accompany this reason code. If you suspect an error in
performed. SQLCODE -904 is issued. A 'resource not DB2, refer to Part 2 of DB2 Diagnosis Guide and
available' code is returned to the user. This reason code Reference for information on identifying and reporting
and the resource name are returned in the cursor table the problem.
(CT) and made available to the user in the SQLCA.
Problem Determination: SYS1.LOGREC contains 00C900C1
information in the variable recording area (VRA) of the
Explanation: An attempt was made to allocate an
system diagnostic work area (SDWA). Significant fields
index that has one or more logical partitions in a rebuild
for this code are: VRARRK13, VRARRK14, and
pending state.
VRARRK15.
System Action: Use of the object is not allowed.
This reason code is issued by the following CSECT:
DSNILMCL User Response: Determine when the resource is
available for use and rerun the job.
00C900BF Operator Response: Determine when the REBUILD
utility should be run to complete recovering the object.
Explanation: DB2 is unable to obtain a lock because
Only the logical partitions marked as rebuild pending
IRLM detected an ’out of record list’ storage condition.
need to be recovered.
The record list is that part of the coupling facility lock
structure that contains the ’modify locks’ (those locks Problem Determination: The requested operation is
786 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C900C4 • 00C900C8
not performed because the index might be in an
00C900C6
inconsistent state. An SQLCODE -904 or message
DSNT501I is issued. For more information, refer to the Explanation: DB2 detected an uncommitted write on
SQL return code in Part 2. SQL Return Codes, or to the an index being altered to change the type during the
description of the DSNT501I. same commit scope. This is not allowed. Commit or
rollback all changes to an index before alter index
If you suspect an error in DB2, refer to Part 2 of DB2
convert type is used to change the index type.
Diagnosis Guide and Reference for information on
identifying and reporting the problem. System Action: The alter index convert type of the
index is not allowed.
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1, System Programmer Response: The requested
3, 5, 32. 72. operation is not performed and SQLCODE -904 is
issued. For more information, refer to the SQL code in
″Section 2. SQL Return Codes″. Commit or rollback
00C900C4
changes to the index and retry the Alter Index convert
Explanation: An attempt was made to insert values type.
into a table that has a ROWID column with the
Problem Determination: The requested operation is
generated by default attribute but no index exists to
not performed and SQLCODE -904 is issued. For more
enforce its uniqueness.
information, refer to the SQL return code in ″Section 2.
System Action: The use of the table is not allowed. SQL Return Codes.″
System Programmer Response: Create a unique
single column index for the ROWID column. 00C900C7
Problem Determination: The requested operation is | Explanation: The requested function was either:
not performed. An SQLCODE -904 is issued. For more | v not supported by the current release or maintenance
information, refer to the “Part 2. SQL Return Codes” on | level of DB2, or
page 9 or to the description of the DSNT501I messages
| v deactivated by a modified the system parameters.
in “Chapter 17. DSNT... Messages” on page 375.
| In the former case, the NAME field of the accompanying
| message indicates the required level of maintenance. In
00C900C5
| the latter case, the NAME field indicates the
Explanation: An attempt was made to access a table | deactivating system parameter.
space that is in the auxiliary check pending state
System Action: The requested action is not
(ACHKP).
performed.
System Action: The operation is not allowed. DB2
User Response: Inform the system administrator.
returns ’resource not available’ to its invoker.
| System Programmer Response: To permit the use of
System Programmer Response: Use the CHECK
| the function, take the appropriate actions according to
DATA utility to identify the invalid LOBs. Use the SQL
| the situation. Apply the indicated maintenance, migrate
UPDATE statement to replace the invalid LOBs or the
| to the indicated release of DB2, or use an alternate
SQL DELETE statement to remove the rows with the
| setting for the indicated system parameter.
invalid LOBs. After rectifying all invalid LOBs, run
CHECK DATA again to clear the ACHKP state from the
table space. 00C900C8
Problem Determination: If you suspect an error in Explanation: Access to the index is disallowed within
DB2, refer to Part 2 of DB2 Diagnosis Guide and the same commit scope as an ALTER TABLE statement
Reference for information on identifying and reporting that alters the key column in the index. If the ALTER
the problem. TABLE statement failed, then commit the changes to
the index and retry the ALTER TABLE statement. If an
An SQLCODE -904 is issued. Message DSNT500I or
INSERT, DELETE, UPDATE, or SELECT statement
message DSNT501I may also be issued. For more
failed, then commit the ALTER and retry the statement.
information, refer to the “Part 2. SQL Return Codes” on
page 9 or to the description of the DSNT500I and System Action: The operation is not allowed.
DSNT501I messages in “Chapter 17. DSNT...
User Response: Commit and then retry the operation.
Messages” on page 375.
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
3, 5.
Chapter 37. DB2 Codes 787
00C900C9 • 00C900D1
| 00C900C9 | This reason code is issued by the following CSECT:
| DSNILABR
| Explanation: After being expanded to process
| triggers, a row has grown too large to fit into a 32K | System Action: DB2 rejects the NOBACKOUT
| page of a workfile. | request.
| System Action: DB2 does not perform the requested | Problem Determination: DB2 does not perform the
| operation. | requested operation because at least one object
| involved in the operation is also updated by other active
| Programmer Response: Drop and recreate triggers to | transactions in DB2. Wait for the other transactions to
| use less LOB columns as transition variables, or | finish, then reissue the request.
| eliminate the use of the ROWID column as a transition
| variable. For a table with LOB columns or a ROWID
| column whose row size is very close to 32K, it may not
| 00C900CE
| be possible to use transition tables with triggers. | Explanation: Resource is unavailable because the
| Problem Determination: DB2 does not perform the
| resource is in a state that is incompatible with this
| requested operation. DB2 issues SQL code -904, and
| version of DB2.
| may also issue message DSNT500I or DSNT501I. For | System Action: DB2 does not allow the use of the
| more information, refer to “Part 2. SQL Return Codes” | resource.
| on page 9, or to the description of the DSNT500I and
| DSNT501I messages in “Chapter 17. DSNT... | Problem Determination: DB2 does not perform the
| Messages” on page 375. | requested operation because the table space or index
| space might be in an inconsistent state. DB2 issues
| Collect the following terms listed in “Appendix B. | SQL code -904. For more information, refer to the SQL
| Problem determination” on page 1281: 1, 3, 5, 37. | return code or to the description of the DSNT501I
| message.
| 00C900CB
00C900D0
| Explanation: Resource is unavailbe because the
| resource is in a refresh pending state. Explanation: An attempt was made to access a value
in a column with one of the LOB data types (BLOB,
| System Action: The use of the resource is not
CLOB, DBCLOB), but the value of the column is no
| allowed.
longer valid.
| Problem Determination: DB2 does not perform the
System Action: The operation is not allowed. DB2
| requested operation because the table space or index
returns 'resource not available' to its invoker.
| space might be in an inconsistent state. DB2 issues
| SQL code -904. For more information, refer to the SQL System Programmer Response: Use the CHECK
| return code, or to the description of the DSNT501I LOB utility to identify the invalid LOBs. Use update to
| message. replace or delete the invalid LOBs.
If you suspect an error in DB2, refer to Part 2 of DB2
| 00C900CC Diagnosis Guide and Reference for information on
identifying and reporting the problem.
| Explanation: DB2 does not accept the NOBACKOUT
| request during the rollback of a non-global transaction Problem Determination: The requested operation is
| while the backout of catalog changes is in progress. not performed. An SQLCODE -904 is issued. Message
DSNT500I or message DSNT501I may also be issued.
| System Action: DB2 rejects the NOBACKOUT
For more information, refer to the “Part 2. SQL Return
| request.
Codes” on page 9 or to the description of the DSNT500I
| Problem Determination: DB2 does not perform the and DSNT501I messages in “Chapter 17. DSNT...
| requested operation because the backout in progress Messages” on page 375.
| must be complete before the NOBACKOUT request can
Collect the following diagnostic items listed in
| succeed. Wait for the backout to complete, then reissue
“Appendix B. Problem determination” on page 1281: 1,
| the request.
3, 5.
| 00C900CD
00C900D1
| Explanation: DB2 does not accept the NOBACKOUT
Explanation: The amount of space allowed for
| request during the rollback of a non-global transaction.
processing LOB values by a user has been exceeded.
| At least one of the objects of the transaction is shared
The amount of space allowed per user is indicated by
| by another transaction.
panel DSNTIP7.
788 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C900D2 • 00C90101
This reason code is issued by the following CSECTs: If you suspect an error in DB2, refer to Part 2 of DB2
DSNOTCSO Diagnosis Guide and Reference for information on
identifying and reporting the problem.
System Action: The operation is not allowed. DB2
returns 'resource not available' to its invoker. Problem Determination: The requested operation is
not performed. An SQLCODE -904 is issued. Message
System Programmer Response:
DSNT500I or message DSNT501I may also be issued.
If you suspect an error in DB2, refer to Part 2 of DB2 For more information, refer to the “Part 2. SQL Return
Diagnosis Guide and Reference for information on Codes” on page 9 or to the description of the DSNT500I
identifying and reporting the problem. and DSNT501I messages in “Chapter 17. DSNT...
Messages” on page 375.
Problem Determination: The requested operation is
not performed. An SQLCODE -904 is issued. Message Collect the following diagnostic items listed in
DSNT500I or message DSNT501I may also be issued. “Appendix B. Problem determination” on page 1281: 1,
For more information, refer to the “Part 2. SQL Return 3, 5.
Codes” on page 9 or to the description of the DSNT500I
and DSNT501I messages in “Chapter 17. DSNT...
00C90101
Messages” on page 375.
Explanation: The data manager detected an internal
Collect the following diagnostic items listed in
error within DB2. This error may indicate inconsistent
“Appendix B. Problem determination” on page 1281: 1,
data or an error in internal DB2 control structures or
3, 5.
code.
This abend reason code is issued by the following
00C900D2
CSECT: DSNnnnnn
Explanation: The amount of space allowed for
'nnnnn' is the CSECT name identifier given in
processing LOB locators for a system has been
VRARRK5 of the VRA in the SDWA (see the Problem
exceeded. The amount of space allowed for a system is
Determination section of this message). 'DSNnnnnn' is
indicated by panel DSNTIP7.
the full CSECT name given in the dump title.
This reason code is issued by the following CSECTs:
Possible causes of this error include:
DSNOTCSO
v Improper migration or fall back procedures,
System Action: The operation is not allowed. DB2 v DB2 directory and DB2 Catalog restored to different
returns 'resource not available' to its invoker. points in time,
v Table space restored improperly,
System Programmer Response: v An internal DB2 failure.
If you suspect an error in DB2, refer to Part 2 of DB2 System Action: A record is written to SYS1.LOGREC,
Diagnosis Guide and Reference for information on and an SVC dump is requested.
identifying and reporting the problem.
User Response: Notify the system programmer.
Problem Determination: The requested operation is
not performed. An SQLCODE -904 is issued. Message Operator Response: Collect the console output from
DSNT500I or message DSNT501I may also be issued. the system on which the job was run for the period of
For more information, refer to the “Part 2. SQL Return time spanning the failure. Save this output for use in
Codes” on page 9 or to the description of the DSNT500I problem determination.
and DSNT501I messages in “Chapter 17. DSNT...
System Programmer Response: If you suspect an
Messages” on page 375.
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
Collect the following diagnostic items listed in and Reference for information on identifying and
“Appendix B. Problem determination” on page 1281: 1, reporting the problem.
3, 5.
Problem Determination: If this abend occurred while
processing data in one or more pages, message
00C900D3 DSNI014I is issued to identify each page involved. In
general, the data in these pages is fine. However, if
Explanation: No more space in the data space is problems are reported that repeatedly involve the same
available for processing LOB values. pages or if the same pages are reported by other
This reason code is issued by the following CSECTs: abends, you may want to analyze the set of pages
DSNOTCSO specified.
System Action: The operation is not allowed. DB2 Run the CHECK utility to determine the extent of index
returns 'resource not available' to its invoker. inconsistency if:
v The page type indicated in message DSNI014I is
System Programmer Response: index.
Chapter 37. DB2 Codes 789
00C90102 • 00C90105
v The page type indicated in message DSNI014I is Collect the following diagnostic items listed in
data. “Appendix B. Problem determination” on page 1281: 1,
v There is an index defined on a table in the indicated 2, 5, 6, 13, 32.
page set.
00C90103
The LOC keyword in the dump title gives the
Load-module.CSECT:qualifier of the location where the Explanation: Bad data was returned from either the
abend occurred. 'Qualifier' is a unique, 4-digit edit or the validation exit.
hexadecimal number that identifies the place within the
This abend reason code is issued by the following
source module (CSECT) where the abend was issued.
CSECTs: DSNIREDR, DSNIENSR
Refer also to Table 4 in “Appendix B. Problem System Action: A record is written to SYS1.LOGREC,
determination” on page 1281 for further information on and an SVC dump is requested.
DSN1COPY misuse.
System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
SYS1.LOGREC contains information in the variable
and Reference for information on identifying and
recording area (VRA) of the system diagnostic work
reporting the problem.
area (SDWA). Significant fields for this abend code are:
VRARRK5, VRARRK6, VRARRK7, VRARRK8, and Problem Determination: SYS1.LOGREC contains the
VRARRK9. same diagnostic information in the variable recording
area (VRA) as in abend reason code '00C90101'. Refer
Collect the following diagnostic items listed in to the table accompanying that abend reason code for
“Appendix B. Problem determination” on page 1281: 1, details.
2, 5, 31, 32, 33, 40, 41.
The '00C90103' abend reason code was issued
because one of the checks described in the following
If the abend reason code was issued by a CSECT with list failed:
name DSNGxxxx, where 'xxxx' is any value, make a v Save first and last byte of the input record. On return
copy of DSNDB01.DBD01, DSNDB01.SCT02, and from exit, see if either group has been modified. If so,
DSNDB01.DSNSCT02 on tape with DSN1COPY. This abend.
might be a large copy. v Check length of edited data. If greater than maximum
allowed for this row, or less than one, abend.
00C90102 v Store a special character in the first byte past the end
of the output area (place for edit procedure to put
Explanation: An inconsistent page was detected. This edited or (original unedited) row), to make sure the
has been caused by a DB2 internal error. exit doesn’t overrun this area. On return, check if it is
This abend reason code is issued by the following still the same special character. If not, abend.
CSECT: DSNIBROK
SYS1.LOGREC contains information in the variable
System Action: A record is written to SYS1.LOGREC, recording area (VRA) of the system diagnostic work
and an SVC dump is requested. area (SDWA). Significant fields for this code are:
System Programmer Response: If you suspect an VRARRK5, VRARRK6, VRARRK7, VRARRK8, and
error in DB2, refer to Part 2 of DB2 Diagnosis Guide VRARRK9.
and Reference for information on identifying and
reporting the problem. 00C90105
Problem Determination: SYS1.LOGREC contains Explanation: An inconsistent page was detected. This
information in the variable recording area (VRA) of the has been caused by a DB2 internal error.
system diagnostic work area (SDWA). Significant fields
for this code are: VRARRK5, VRARRK6, VRARRK7, This abend reason code is issued by the following
VRARRK8, and VRARRK9. CSECT: DSNIBROK
In addition, the following general purpose registers System Action: A record is written to SYS1.LOGREC,
(GPRs) contain the indicated diagnostic information: an SVC dump is requested, and the page will be
scheduled for automatic recovery. If automatic recovery
GPR Content is successful, message DSNB215I is issued. If
2 Address of the page set block (PB) automatic recovery fails, message DSNI012I is issued,
3 Address of the log record, if any and an abend '04E' with reason code 00C90102 will
8 Address of the buffer block (BB) occur.
9 Address of the page buffer
790 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C90106 • 00C90110
Note: If the resource required for automatic recovery is This abend reason code is issued by the following
in use, automatic recovery will be delayed until CSECT: DSNICMT2
the resource is available.
System Action: A record is written to SYS1.LOGREC,
System Programmer Response: Refer to Part 2 of an SVC dump is requested. The thread is aborted.
DB2 Diagnosis Guide and Reference for information on
System Programmer Response: If you suspect an
identifying and reporting the problem.
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
Problem Determination: SYS1.LOGREC contains and Reference for information on identifying and
information in the variable recording area (VRA) of the reporting the problem.
system diagnostic work area (SDWA). Significant fields
Problem Determination: Collect the following
for this code are: VRARRK5, VRARRK6, VRARRK7,
diagnostic items listed in “Appendix B. Problem
VRARRK8, and VRARRK9. Exceptions to the table
determination” on page 1281: 1, 2, 5, 31, 32, 33.
definitions of the VRA fields are:
v VRARRK5 is the name of the module that called the
check page routine that detected the error in the 00C90108
page.
v VRARRK6 identifies the error in the page. Explanation: At commit phase 2, a nonzero read
intent count or write intent count was detected. An error
in DB2 logic is probably responsible for this condition.
The following general purpose registers (GPRs) contain
the indicated diagnostic information: This abend reason code is issued by the following
CSECT: DSNICMT2
GPR Content
2 Address of the page set block (PB) System Action: A record is written to SYS1.LOGREC,
3 Address of the log record, if any and a SVC dump is requested. The thread is committed
8 Address of the buffer block (BB) and the application is allowed to continue without
9 Address of the page buffer notification of the error.
System Programmer Response: If you suspect an
Refer also to Table 4 in “Appendix B. Problem
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
determination” on page 1281 for further information on
and Reference for information on identifying and
DSN1COPY misuse.
reporting the problem.
Collect the following diagnostic items listed in Problem Determination: Collect the following
“Appendix B. Problem determination” on page 1281: 1, diagnostic items listed in “Appendix B. Problem
2, 5, 6, 13, 32. determination” on page 1281: 1, 2, 5, 31, 32, 33.
00C90106 00C90109
Explanation: The entry is not found for a table space Explanation: At deallocate, a nonzero read intent
that is being set for deferred restart. An error in DB2 count or write intent count was detected. An error in
logic is probably responsible for this condition. DB2 logic is probably responsible for this condition.
This abend reason code is issued by the following This abend reason code is issued by the following
CSECT: DSNIIMPD CSECT: DSNIDALC
System Action: A record is written to SYS1.LOGREC, System Action: A record is written to SYS1.LOGREC,
an SVC dump is requested, and the DB2 restart is and a SVC dump is requested. The thread is
terminated. deallocated normally.
System Programmer Response: If you suspect an System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and and Reference for information on identifying and
reporting the problem. reporting the problem.
Problem Determination: Collect the following Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 1, 2, 5, 32, 33. determination” on page 1281: 1, 2, 5, 31, 32, 33.
00C90107 00C90110
Explanation: At commit phase 1, a nonzero write Explanation: The data manager detected an
intent count was detected. An error in DB2 logic is inconsistent data condition. This may be caused by an
probably responsible for this condition. inconsistency in either the DB2 catalog or the DB2
directory. In this case, the OBD for the requested OBID
Chapter 37. DB2 Codes 791
00C90111 • 00C90112
cannot be located in the database descriptor (DBD). Diagnosis Guide and Reference for information on
The DBD in storage may be inconsistent. Specifically, identifying and reporting the problem.
the OBDDMAP(OBID) array element should contain an
Problem Determination: Since the DB2 directory
offset into the DBD where the OBD should be located.
does not agree with the DB2 catalog, either of these
However, in this case the OBD expected was not at the
may be inconsistent. Since the nature and extent of the
indicated offset.
inconsistency between the DB2 catalog the DBD is not
To prevent further damage and possible loss of data, immediately known, an analysis of the entire DBD must
the inconsistency must be corrected before any further be done.
SQL access is attempted to this database.
The inconsistency may be due to:
System Action: A record is written to SYS1.LOGREC, v Incomplete recovery of DB2 catalog and/or DB2
and an SVC dump is requested. directory.
v Invalid restore of DB2 catalog and/or DB2 directory to
Operator Response: Notify the system programmer.
a prior point in time.
System Programmer Response: Determine which v A conditional restart which bypassed recovery of
databases were being used when the error occurred. DSNDB01.DBD01 or DSNDB06.SYSDBASE page
Prevent further SQL access to the databases. If you sets.
suspect an error in DB2, refer to Part 2 of DB2 v A DB2 internal error.
Diagnosis Guide and Reference for information on
identifying and reporting the problem. Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
Problem Determination: The DBD in use at the time
5, 69, 70, 71, 72.
of the abend is inconsistent in storage and may be
inconsistent on DASD. Since the nature and extent of
the damage done to the DBD is not immediately known, 00C90112
an analysis of the entire DBD must be done.
Explanation: The data manager detected an
The inconsistency may be due to: inconsistent data condition. There may be more than
v Incomplete recovery of DB2 catalog and/or DB2 one object with the same OBID in the DB2 Catalog. To
directory. prevent further damage and possible loss of data, the
v Invalid restore of DB2 catalog and/or DB2 directory to inconsistency must be corrected before any further SQL
a prior point in time. access is attempted to this database.
v A conditional restart which bypassed recovery of
This abend reason code is issued by the following
either the DSNDB01.DBD01 page set or the
CSECT: DSNGDCOB
DSNDB06.SYSDBASE page set.
v A DB2 internal error. System Action: A record is written to SYS1.LOGREC
and an SVC dump is requested.
Collect the following diagnostic items listed in
Operator Response: Notify the system programmer.
“Appendix B. Problem determination” on page 1281: 1,
5, 69, 70, 71, 72. System Programmer Response: Determine which
databases were being used when the error occurred.
Prevent further SQL access to the databases. If you
00C90111
suspect an error in DB2, refer to Part 2 of DB2
Explanation: The data manager detected an Diagnosis Guide and Reference for information on
inconsistent data condition. In this case, the OBD for identifying and reporting the problem.
the requested OBID does not exist. This may be caused
Problem Determination: Since the extent of this
by an inconsistency in either the DB2 catalog or the
inconsistency is not immediately known, an analysis of
DB2 directory. Specifically, the OBDDMAP(OBID) entry
the entire DBD must be done.
is zero rather than an offset to an OBD within the DBD.
The inconsistency may be due to:
To prevent further damage and possible loss of data,
the inconsistency must be corrected before any further v Incomplete recovery of the DB2 Catalog and/or the
SQL access is attempted to this database. DB2 Directory.
v Invalid restore of the DB2 Catalog and/or the DB2
System Action: A record is written to SYS1.LOGREC,
Directory to a prior point in time.
and an SVC dump is requested.
v A conditional restart which bypassed recovery of
Operator Response: Notify the system programmer. DSNDB01.DBD01 or DSNDB06.SYSDBASE page
System Programmer Response: Determine which sets.
databases were being used when the error occurred. v A DB2 internal error.
Prevent further SQL access to the databases. If you
suspect an error in DB2, refer to Part 2 of DB2
792 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C90124 • 00C90203
Collect the following diagnostic items listed in error in DB2, refer to Part 2 of DB2 Diagnosis Guide
“Appendix B. Problem determination” on page 1281: 1, and Reference for information on identifying and
5, 69, 70, 71, 72. reporting the problem.
Problem Determination: Message DSNI013I is issued
00C90124 to identify the data pages. It identifies the database
name and table space name. This message is issued
Explanation: An attempt was made to apply
for all pages in use at the time of the abend. Within this
prior-version/release DB2 log records other than
group of pages, at least one page is involved in the
checkpoint records.
inconsistency. The other pages were present at the time
System Action: A record is written to SYS1.LOGREC, of the abend.
and an SVC dump is requested.
The LOC keyword in the dump title gives the
User Response: Notify the system programmer. Load-module.CSECT:qualifier of the location where the
abend occurred. 'Qualifier' is a unique, 4-digit
Operator Response: Collect the console output from hexadecimal number that identifies the place within the
the system on which the job was run for the period of source module (CSECT) where the abend was issued.
time spanning the failure. Save this output for use in
problem determination. SYS1.LOGREC contains information in the variable
recording area (VRA) of the system diagnostic work
System Programmer Response: If you suspect an area (SDWA). Significant fields for this abend code are:
error in DB2, refer to Part 2 of DB2 Diagnosis Guide VRARRK5, VRARRK6, VRARRK7, VRARRK8, and
and Reference for information on identifying and VRARRK9.
reporting problems.
Collect the following diagnostic items listed in
Problem Determination: This abend can occur in “Appendix B. Problem determination” on page 1281: 1,
migration/remigration when some necessary 2, 5, 31, 32, 33, 42.
migration/remigration steps are skipped. It indicates that
some DB2 activity occurred or was pending after the
last complete checkpoint on the prior system. See Part 00C90203
2 of DB2 Installation Guide for a complete list of
Explanation: The data manager detected an
migration/remigration steps. If this was the cause of the
inconsistent data condition. In this case, one of the
problem, it can be corrected by falling back to the prior
pointers in a hash chain does not point to a valid row or
version/release long enough to bring DB2 up, then bring
anchor (that is, the hash chain is 'broken'). The pointer,
it down while conforming to all migration/remigration
the target row/anchor, or the page that contains the
steps. Pay specific attention to resolving all indoubts
pointer or target row/anchor is in error.
and to performing a stop mode quiesce.
This abend reason code is issued by the following
CSECT: DSNnnnnn
00C90202
'nnnnn' is the CSECT name identifier given in the dump
Explanation: The data manager detected an
header and appearing in VRARRK5 of the VRA in the
inconsistent data condition. In this case, one of the
SDWA (see the Problem Determination section of this
pointers in a link does not point to a valid child or parent
message). 'DSNnnnnn' is the full CSECT name given in
row (that is, the link is 'broken'). The pointer, the target
the dump title.
row, or the page that contains the pointer or target row
is in error. System Action: A record is written to SYS1.LOGREC,
and an SVC dump is requested.
This abend reason code is issued by the following
CSECT: DSNnnnnn User Response: Notify the system programmer.
'nnnnn' is the CSECT name identifier given in Operator Response: Collect the console output from
VRARRK5 of the VRA in the SDWA (see the Problem the system on which the job was run for the period of
Determination section of this message). 'DSNnnnnn' is time spanning the failure. Save this output for use in
the full CSECT name given in the dump title. problem determination.
System Action: A record is written to SYS1.LOGREC, System Programmer Response: If you suspect an
and an SVC dump is requested. error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and
User Response: Notify the system programmer.
reporting the problem.
Operator Response: Collect the console output from
Problem Determination: Message DSNI013I is issued
the system on which the job was run for the period of
to identify the data pages. It identifies the database
time spanning the failure. Save the output for use in
name and the table space name. This message is
problem determination.
issued for all pages in use at the time of the abend.
System Programmer Response: If you suspect an Within this group of pages, at least one page is involved
Chapter 37. DB2 Codes 793
00C90205 • 00C90206
in the inconsistency. The other pages were present at v There is an index defined on a table in the indicated
the time of the abend. page set.
SYS1.LOGREC contains information in the variable
The LOC keyword in the dump title gives the
recording area (VRA) of the system diagnostic work
Load-module.CSECT:qualifier of the location where the
area (SDWA). Significant fields for this abend code are:
abend occurred. 'Qualifier' is a unique, 4-digit
VRARRK5, VRARRK6, VRARRK7, VRARRK8, and
hexadecimal number that identifies the place within the
VRARRK9.
source module (CSECT) where the abend was issued.
The LOC keyword in the dump title gives the
Load-module.CSECT:qualifier of the location where the SYS1.LOGREC contains information in the variable
abend occurred. 'Qualifier' is a unique, 4-digit recording area (VRA) of the system diagnostic work
hexadecimal number that identifies the place within the area (SDWA). Significant fields for this abend code are:
source module (CSECT) where the abend was issued. VRARRK5, VRARRK6, VRARRK7, VRARRK8, and
VRARRK9.
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
2, 5, 31, 32, 33, 42. Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
2, 5, 31, 32, 33, 41, 42.
00C90205
Explanation: The data manager detected an 00C90206
inconsistent data condition. In this case, a row obtained
from an index entry does not point to a valid row in a Explanation: The data manager detected an
data page. The error is probably caused by an extra inconsistent data condition. In this case, a row that
index entry, but it could also result from a table update should be pointed to by an index does not have an
not being redone when it should have been. index entry. The error is probably caused by a missing
index entry, but it could also be caused by a table
This abend reason code is issued by the following update that was not backed out when it should have
CSECT: DSNnnnnn been.
'nnnnn' is the CSECT name identifier given in the dump This abend reason code is issued by the following
header and appearing in VRARRK5 of the VRA in the CSECT: DSNnnnnn
SDWA (see the Problem Determination section of this
message). 'DSNnnnnn' is the full CSECT name given in 'nnnnn' is the CSECT name identifier given in the dump
the dump title. header and appearing in VRARRK5 of the VRA in the
SDWA (see the Problem Determination section of this
System Action: A record is written to SYS1.LOGREC, message). 'DSNnnnnn' is the full CSECT name given in
and an SVC dump is requested. the dump title.
User Response: Notify the system programmer. System Action: A record is written to SYS1.LOGREC,
and an SVC dump is requested.
Operator Response: Collect the console output from
the system on which the job was run for the period of User Response: Notify the system programmer.
time spanning the failure. Save this output for use in
problem determination. Operator Response: Collect the console output from
the system on which the job was run for the period of
System Programmer Response: If you suspect an time spanning the failure. Save this output for use in
error in DB2, refer to Part 2 of DB2 Diagnosis Guide problem determination.
and Reference for information on identifying and
reporting the problem. System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
Problem Determination: Message DSNI013I is issued and Reference for information on identifying and
to identify the index page. It identifies the database reporting the problem.
name, table space name, and index space name. This
message is issued for all pages in use at the time of the Problem Determination: Message DSNI013I is issued
abend. Within this group of pages, at least one page is to identify the data pages. It identifies the database
involved in the inconsistency. The other pages were name, table space name, and index space name. This
present at the time of the abend. message is issued for all pages in use at the time of the
abend. Within this group of pages, at least one page is
Run the CHECK utility to determine the extent of index involved in the inconsistency. The other pages were
inconsistency if: present at the time of the abend.
v The page type indicated in message DSNI014I is
index Run the CHECK utility to determine the extent of index
v The page type indicated in message DSNI014I is inconsistency if:
data
794 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C90207 • 00C90210
v The page type indicated in message DSNI014I is in the inconsistency. The other pages were present at
index the time of the abend.
v The page type indicated in message DSNI014I is
The LOC keyword in the dump title gives the
data
Load-module.CSECT: qualifier of the location where the
v There is an index defined on a table in the indicated
abend occurred. 'Qualifier' is a unique, 4-digit
page set.
hexadecimal number that identifies the place within the
source module (CSECT) where the abend was issued.
The LOC keyword in the dump title gives the
Load-module.CSECT:qualifier of the location where the SYS1.LOGREC contains information in the variable
abend occurred. 'Qualifier' is a unique, 4-digit recording area (VRA) of the system diagnostic work
hexadecimal number that identifies the place within the area (SDWA). Significant fields for this abend code are:
source module (CSECT) where the abend was issued. VRARRK5, VRARRK6, VRARRK7, VRARRK8, and
VRARRK9.
Refer also to “Appendix B. Problem determination” on
Collect the following diagnostic items listed in
page 1281 Table 4 for further information on
“Appendix B. Problem determination” on page 1281: 1,
DSN1COPY misuse.
2, 5, 31, 32, 33, 42.
SYS1.LOGREC contains information in the variable
recording area (VRA) of the system diagnostic work 00C90210
area (SDWA). Significant fields for this abend code are:
Explanation: The data manager detected an
VRARRK5, VRARRK6, VRARRK7, VRARRK8, and
inconsistent data condition. In this case, the subpage
VRARRK9.
directory of an index leaf page indicates that a given
search key doesn’t belong to any of the subpages.
Collect the following diagnostic items listed in Either this leaf page is the index tree or the nonleaf
“Appendix B. Problem determination” on page 1281: 1, portion of the index tree lead to this leaf page as the
2, 5, 31, 32, 33, 41, 42. one that should contain the given key.
This abend reason code is issued by the following
00C90207 CSECT: DSNnnnnn
Explanation: The data manager detected an 'nnnnn' is the CSECT name identifier given in the dump
inconsistent data condition. In this case, a pointer header and appearing in VRARRK5 of the VRA in the
record does not point to a valid overflow record. The SDWA (see the Problem Determination section of this
pointer record, the overflow record, or the page that message). 'DSNnnnnn' is the full CSECT name given in
contains the pointer or overflow record is in error. the dump title.
This abend reason code is issued by the following System Action: A record is written to SYS1.LOGREC,
CSECT: DSNnnnnn and an SVC dump is requested.
'nnnnn' is the CSECT name identifier given in the dump User Response: Notify the system programmer.
header and appearing in VRARRK5 of the VRA in the
SDWA (see the Problem Determination section of this System Programmer Response: If you suspect an
message). 'DSNnnnnn' is the full CSECT name given in error in DB2, refer to Part 2 of DB2 Diagnosis Guide
the dump title. and Reference for information on identifying and
reporting the problem.
System Action: A record is written to SYS1.LOGREC,
and an SVC dump is requested. Problem Determination: Message DSNI013I is issued
to identify the index page. It also identifies the database
User Response: Notify the system programmer. name and index space name. This message is issued
Operator Response: Collect the console output from for all pages in use at the time of the abend. Within this
the system on which the job was run for the period of group of pages, at least one page is involved in the
time spanning the failure. Save this output for use in inconsistency. The other pages were present at the time
problem determination. of the abend.
System Programmer Response: If you suspect an The LOC keyword in the dump title gives the Load
error in DB2, for information on identifying and reporting module.CSECT:qualifier of the location where the abend
the problem. occurred. 'Qualifier' is a unique, 4-digit hexadecimal
number that identifies the place within the source
Problem Determination: Message DSNI013I is issued module (CSECT) where the abend was issued.
to identify the data pages. It also identifies the database
name and the table space name. This message is Refer also to “Appendix B. Problem determination” on
issued for all pages in use at the time of the abend. page 1281 Table 4 for further information on
Within this group of pages, at least one page is involved DSN1COPY misuse.
Chapter 37. DB2 Codes 795
00C90211 • 00C90213
SYS1.LOGREC contains information in the variable removes empty pages from the index tree.)
recording area (VRA) of the system diagnostic work
This abend reason code is issued by the following
area (SDWA). Significant fields for this abend code are:
CSECT: DSNnnnnn
VRARRK5, VRARRK6, VRARRK7, VRARRK8, and
VRARRK9. 'nnnnn' is the CSECT name identifier given in the dump
header and appearing in VRARRK5 of the VRA in the
Collect the following diagnostic items listed in
SDWA (see the Problem Determination section of this
“Appendix B. Problem determination” on page 1281: 1,
message). 'DSNnnnnn' is the full CSECT name given in
2, 5, 31, 32, 33, 43.
the dump title.
System Action: A record is written to SYS1.LOGREC,
00C90211
and an SVC dump is requested.
Explanation: The data manager detected an
User Response: Notify the system programmer.
inconsistent data condition. In this case, a row is
missing a column that is not nullable and does not allow System Programmer Response: If you suspect an
default values. error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and
This abend reason code is issued by the following
reporting the problem.
CSECT: DSNnnnnn
Problem Determination: Message DSNI013I is issued
'nnnnn' is the CSECT name identifier given in the dump
to identify the index leaf page. It also identifies the
header and appearing in VRARRK5 of the VRA in the
database name and index space name. This message
SDWA (see the Problem Determination section of this
is issued for all pages in use at the time of the abend.
message). 'DSNnnnnn' is the full CSECT name given in
Within this group of pages, at least one page is involved
the dump title.
in the inconsistency. The other pages were present at
System Action: A record is written to SYS1.LOGREC, the time of the abend.
and an SVC dump is requested.
Run the CHECK utility to determine the extent of index
User Response: Notify the system programmer. inconsistency if:
v The page type indicated in message DSNI014I is
System Programmer Response: If you suspect an
index.
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
v The page type indicated in message DSNI014I is
and Reference for information on identifying and
data.
reporting the problem.
v There is an index defined on a table in the indicated
Problem Determination: Message DSNI013I is issued page set.
to identify the data page. It also identifies the database
name and table space name. This message is issued The LOC keyword in the dump title gives the Load
for all pages in use at the time of the abend. Within this module.CSECT:qualifier of the location where the abend
group of pages, at least one page is involved in the occurred. 'Qualifier' is a unique, 4-digit hexadecimal
inconsistency. The other pages were present at the time number that identifies the place within the source
of the abend. module (CSECT) where the abend was issued.
The LOC keyword in the dump title gives the Load
Refer also to “Appendix B. Problem determination” on
module.CSECT:qualifier of the location where the abend
page 1281 Table 4 for further information on
occurred. 'Qualifier' is a unique, 4-digit hexadecimal
DSN1COPY misuse.
number that identifies the place within the source
module (CSECT) where the abend was issued.
SYS1.LOGREC contains information in the variable
SYS1.LOGREC contains information in the variable recording area (VRA) of the system diagnostic work
recording area (VRA) of the system diagnostic work area (SDWA). Significant fields for this abend code are:
area (SDWA). Significant fields for this abend code are: VRARRK5, VRARRK6, VRARRK7, VRARRK8, and
VRARRK5, VRARRK6, VRARRK7, VRARRK8, and VRARRK9.
VRARRK9.
Collect the following diagnostic items listed in Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1, “Appendix B. Problem determination” on page 1281: 1,
2, 5, 31, 32, 33, 42, 62. 2, 5, 31, 32, 33, 41, 43.
00C90212 00C90213
Explanation: The data manager detected an Explanation: The data manager detected an
inconsistent data condition. In this case, there is an inconsistent data condition. In this case, a row has an
empty index leaf page other than the root. (DB2 unexpected OBID stored in its prefix. A possible cause
is that the table space was restored (via DSN1COPY or
796 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C90214 • 00C90215
similar tool) improperly. For example, the wrong data set The index space may have been improperly restored by
was copied for the given table space. using DSN1COPY or the wrong data set may have
been copied for the given index.
This abend reason code is issued by the following
CSECT: DSNnnnnn
This abend reason code is issued by the following
'nnnnn' is the CSECT name identifier given in the dump CSECT: DSNnnnnn
header and appearing in VRARRK5 of the VRA in the
SDWA (see the Problem Determination section of this 'nnnnn' is the CSECT name identifier given in
message). 'DSNnnnnn' is the full CSECT name given in VRARRK5 of the VRA in the SDWA. 'DSNnnnnn' is the
the dump title. full CSECT name given in the dump title.
System Action: A record is written to SYS1.LOGREC, System Action: A record is written to SYS1.LOGREC,
and an SVC dump is requested. and an SVC dump is requested.
User Response: Notify the system programmer. User Response: Notify the system programmer.
System Programmer Response: If you suspect an System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and and Reference for information on identifying and
reporting the problem. reporting the problem.
Problem Determination: Message DSNI013I is issued Problem Determination: Message DSNI013I will be
to identify the data page. It also identifies the database issued for each index page. It identifies the database,
name and table space name. This message is issued and the index name. This message is issued for all
for all pages in use at the time of the abend. Within this pages in use at the time of the abend. Within this group
group of pages, at least one page is involved in the of pages, at least one page is involved in the
inconsistency. The other pages were present at the time inconsistency. The other pages were present at the time
of the abend. of the abend.
The LOC keyword in the dump title gives the Load The LOC keyword in the dump title gives the
module.CSECT: qualifier of the location where the Load-module.CSECT:qualifier of the location where the
abend occurred. 'Qualifier' is a unique, 4-digit abend occurred. 'Qualifier' is a unique, 4-digit
hexadecimal number that identifies the place within the hexadecimal number that identifies the place within the
source module (CSECT) where the abend was issued. source module (CSECT) where the abend was issued.
Refer also to Table 4 in “Appendix B. Problem Refer also to Table 4 in “Appendix B. Problem
determination” on page 1281 for further information on determination” on page 1281 for further information on
DSN1COPY misuse. DSN1COPY misuse.
SYS1.LOGREC contains information in the variable SYS1.LOGREC contains information in the variable
recording area (VRA) of the system diagnostic work recording area (VRA) of the system diagnostic work
area (SDWA). Significant fields for this abend code are: area (SDWA). Significant fields for this abend code are:
VRARRK5, VRARRK6, VRARRK7, VRARRK8, and VRARRK5, VRARRK6, VRARRK7, VRARRK8, and
VRARRK9. VRARRK9.
Collect the following diagnostic items listed in Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1, “Appendix B. Problem determination” on page 1281: 1,
2, 5, 31, 32, 33, 42, 62. 2, 5, 31, 32, 33, 42, 44, 62.
00C90214 00C90215
Explanation: The data manager detected a condition Explanation: The data manager detected a condition
of inconsistent data. The description of the index in the of inconsistent data. The index manager subcomponent
index OBD does not match the attributes of an index has been passed a key with a key length not equal to
page. The problems consists of one of the following the key length in pages of the index. The index space
conditions: may have been improperly restored by using
v IPPNUNI does not equal OBDKNUNI, DSN1COPY or the wrong data set may have been
v IPPTLTH does not equal OBDKLEN, copied for the given index.
v IPPOLTH does not equal OBDLENO, or
v If the page is a leaf page, the segmentation flag or This abend reason code is issued by the following
number of subpages conflict (IPPNLPG does not CSECT: DSNnnnnn
equal OBDINLPG or IPPSEGM conflicts with 'nnnnn' is the CSECT name identifier given in
OBDINLPG). VRARRK5 of the VRA in the SDWA. 'DSNnnnnn' is the
full CSECT name given in the dump title.
Chapter 37. DB2 Codes 797
00C90216 • 00C90218
System Action: A record is written to SYS1.LOGREC, Problem Determination: Message DSNI013I is issued
and an SVC dump is requested. to identify the data page that contains the record that is
longer than allowed by its corresponding record
User Response: Notify the system programmer.
definition. This could occur if the DB2 directory was
System Programmer Response: If you suspect an recovered to a previous point, allowing new object
error in DB2, refer to Part 2 of DB2 Diagnosis Guide creations (with a shorter record length) to be created
and Reference for information on identifying and having record identifiers identical to objects previously
reporting the problem. created in the table space. Also the table space may
have been improperly restored by using DSN1COPY or
A rebuild index or recover index will restore the index to the wrong data set may have been copied for the given
a correct condition. table space.
Problem Determination: Message DSNI013I will be Refer also to Table 4 in “Appendix B. Problem
issued for each index page. It identifies the database, determination” on page 1281 for further information on
the index name. This message is issued for all pages in DSN1COPY misuse.
use at the time of the abend. Within this group of
pages, at least one page is involved in the Collect the following diagnostic items listed in
inconsistency. The other pages were present at the time “Appendix B. Problem determination” on page 1281: 1,
of the abend. 2, 5, 32, 33, 42, 62. 65, 66.
The LOC keyword in the dump title gives the
Load-module.CSECT:qualifier of the location where the 00C90218
abend occurred. 'Qualifier' is a unique, 4-digit
Explanation: The data manager detected an
hexadecimal number that identifies the place within the
inconsistent data condition in a segmented table space.
source module (CSECT) where the abend was issued.
In this case, an unallocated segment was found on a
Refer also to Table 4 in “Appendix B. Problem segment chain.
determination” on page 1281 for further information on
This abend reason code is issued by the following
DSN1COPY misuse.
CSECT: DSNnnnnn
SYS1.LOGREC contains information in the variable
The CSECT name identifier given in the dump header
recording area (VRA) of the system diagnostic work
and appearing in VRARRK5 of the VRA in the SDWA is
area (SDWA). Significant fields for this abend code are:
'nnnnn' (see the Problem Determination section of this
VRARRK5, VRARRK6, VRARRK7, VRARRK8, and
message). The full CSECT name given in the dump title
VRARRK9.
is 'DSNnnnnn'.
Collect the following diagnostic items listed in
System Action: A record is written to SYS1.LOGREC
“Appendix B. Problem determination” on page 1281: 1,
and an SVC dump is requested.
2, 31, 32, 33, 42, 44, 62, 63, 64.
User Response: Notify the system programmer.
00C90216 Operator Response: Collect the console output from
the system on which the job was run for the period of
Explanation: The data manager has detected an
time spanning the failure. Save this output for use in
inconsistent data condition. Either the length of a record
problem determination.
in a table space is longer than the maximum-defined
record length as defined in the DB2 directory or a System Programmer Response: If you suspect an
variable-length column has a longer length than the error in DB2, refer to Part 2 of DB2 Diagnosis Guide
length defined in the DB2 directory. and Reference for information on identifying and
reporting the problem.
This abend reason code is issued by the following
CSECTs: Problem Determination: Message DSNI013I is issued
to identify the space map page that contains the bad
DSNIOSET DSNIRNXT DSNIRSET DSNISFWL segment entry. The database name and table space
DSNISFX DSNISRID name will also be identified.
SYS1.LOGREC contains information in the variable
System Action: A record is written to SYS1.LOGREC, recording area (VRA) of the system diagnostic work
and an SVC dump is requested. area (SDWA). Significant fields for this abend code are:
User Response: Notify the system programmer. VRARRK5, VRARRK6, VRARRK7, VRARRK8, and
VRARRK9.
System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide Refer also to Table 4 in “Appendix B. Problem
and Reference for information on identifying and determination” on page 1281 for further information on
reporting the problem. DSN1COPY misuse.
798 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C90219 • 00C9021B
Collect the following diagnostic items listed in The CSECT name identifier given in the dump header
“Appendix B. Problem determination” on page 1281: 1, and appearing in VRARRK5 of the VRA in the SDWA is
3, 32, 37. 'nnnnn' (see the Problem Determination section of this
message). The full CSECT name given in the dump title
is 'DSNnnnnn'.
00C90219
System Action: A record is written to SYS1.LOGREC,
Explanation: The data manager detected an
and an SVC dump is requested.
inconsistent data condition in a segmented table space.
In this case, an allocated segment was found on a User Response: Notify the system programmer.
wrong segment chain (that is, a segment chain contains
Operator Response: Collect the console output from
a segment that belongs to a different table).
the system on which the job was run for the period of
This abend reason code is issued by the following time spanning the failure. Save this output for use in
CSECT: DSNnnnnn problem determination.
The CSECT name identifier given in the dump header System Programmer Response: If you suspect an
and appearing in VRARRK5 of the VRA in the SDWA is error in DB2, refer to Part 2 of DB2 Diagnosis Guide
'nnnnn' (see the Problem Determination section of this and Reference for information on identifying and
message). The full CSECT name given in the dump title reporting the problem.
is 'DSNnnnnn'.
Problem Determination: Message DSNI013I is issued
System Action: A record is written to SYS1.LOGREC to identify the data page that contains the bad data
and an SVC dump is requested. record. The database name and table space name will
also be identified.
User Response: Notify the system programmer.
SYS1.LOGREC contains information in the variable
Operator Response: Collect the console output from
recording area (VRA) of the system diagnostic work
the system on which the job was run for the period of
area (SDWA). Significant fields for this abend code are:
time spanning the failure. Save this output for use in
VRARRK5, VRARRK6, VRARRK7, VRARRK8, and
problem determination.
VRARRK9.
System Programmer Response: If you suspect an
Refer also to Table 4 in “Appendix B. Problem
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
determination” on page 1281 for further information on
and Reference for information on identifying and
DSN1COPY misuse.
reporting the problem.
Collect the following diagnostic items listed in
Problem Determination: Message DSNI013I is issued
“Appendix B. Problem determination” on page 1281: 1,
to identify the space map page that contains the bad
3, 32, 37.
segment entry. The database name and table space
name will also be identified.
00C9021B
SYS1.LOGREC contains information in the variable
recording area (VRA) of the system diagnostic work Explanation: The data manager detected an
area (SDWA). Significant fields for this abend code are: inconsistent data condition in a segmented table space.
VRARRK5, VRARRK6, VRARRK7, VRARRK8, and In this case, the space map page indicates a data page
VRARRK9. that is not empty exists. However, the data page is
either not formatted by the data manager or it is beyond
Refer also to Table 4 in “Appendix B. Problem
the highest VSAM formatted area.
determination” on page 1281 for further information on
DSN1COPY misuse. This abend reason code is issued by the following
CSECT: DSNnnnnn
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1, The CSECT name identifier given in the dump header
3, 32, 37. and appearing in VRARRK5 of the VRA in the SDWA is
'nnnnn' (see the Problem Determination section of this
message). The full CSECT name given in the dump title
00C9021A
is 'DSNnnnnn'.
Explanation: The data manager detected an
System Action: A record is written to SYS1.LOGREC
inconsistent data condition in a segmented table space.
and an SVC dump is requested.
In this case, a data page contains a record which
belongs to a table that has not been allocated for the User Response: Notify the system programmer.
page.
Operator Response: Collect the console output from
This abend reason code is issued by the following the system on which the job was run for the period of
CSECT: DSNnnnnn time spanning the failure. Save this output for use in
problem determination.
Chapter 37. DB2 Codes 799
00C9021C • 00C9021E
System Programmer Response: If you suspect an
00C9021D
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and Explanation: During a LOAD/REORG utility or
reporting the problem. termination of a utility, the data manager detected an
inconsistent data condition. A space map page was
Problem Determination: Message DSNI013I is issued
missing from the table space. This abend may indicate
to identify the inconsistent data page and its covering
an internal DB2 error (caused by the utilities
space map page. The database name and table space
subcomponent passing a bad start position to the data
name will also be identified.
manager), but most likely occurs due to a user error.
SYS1.LOGREC contains information in the variable Possible causes are that the table space data set has
recording area (VRA) of the system diagnostic work been deleted and redefined without DB2’s knowledge,
area (SDWA). Significant fields for this abend code are: or that the table space was incorrectly restored from an
VRARRK5, VRARRK6, VRARRK7, VRARRK8, and improper DSN1COPY of the table space.
VRARRK9.
This abend reason code is issued by the following
Collect the following diagnostic items listed in CSECT: DSNIDLOD
“Appendix B. Problem determination” on page 1281: 1,
System Action: A record is written to SYS1.LOGREC,
3, 32, 37.
and an SVC dump is requested. The dump is required
in the event that the problem is determined to be a DB2
00C9021C internal error.
Explanation: While running a utility, the data manager User Response: Notify the system programmer.
detected an inconsistent data condition. A row was
System Programmer Response: Determine if the
encountered that is not represented by a record OBD in
data set was improperly restored or deleted and
the database descriptor (DBD). This abend may indicate
redefined by the user. If you suspect an error in DB2,
an internal DB2 error, but most likely occurs due to a
refer to Part 2 of DB2 Diagnosis Guide and Reference
user error. Possible user errors may include:
for information on identifying and reporting the problem.
v Data from a DB2 subsystem was copied to another
DB2 subsystem incorrectly. This is the most common Problem Determination: Message DSNI013I will be
error. issued. If the message information describes page
'xx0001'X of the table space, this indicates that the data
v DSNDB01.DBD01 was regressed to a time prior to a
set was deleted and redefined without DB2’s
table being created.
knowledge.
If you suspect an error in DB2, refer to Part 2 of DB2
If a DB2 internal error is indicated, collect the following
Diagnosis Guide and Reference for information on
diagnostic items listed in “Appendix B. Problem
identifying and reporting the problem.
determination” on page 1281: 1, 2, 5, 10, 12, 31, 32, 33,
37, 43.
This abend reason code is issued by the following
CSECTs: DSNIRFNX, DSNISNPG
00C9021E
System Action: A record is written to SYS1.LOGREC
and an SVC dump is requested. The dump is required Explanation: The data manager detected an
in the event that the problem is determined to be a DB2 inconsistent data condition in a segmented table space.
internal error. An invalid page was requested. The page number is
outside the highest formatted RBA for the page set.
User Response: Notify the system programmer. Either the segment chain is broken, or the table space
System Programmer Response: Determine if has been truncated. A truncated table space could be a
improper procedures were used to restore the table possible user error.
space or DBD that would lead to the inconsistency. This abend reason code is issued by the following
Problem Determination: Message DSNI013I will be CSECTs: DSNISGSC, DSNISNPG
issued. System Action: A record is written to SYS1.LOGREC,
If a DB2 internal error is indicated, collect the following and an SVC dump is requested.
diagnostic items: User Response: Notify the system programmer.
v DSN1COPY of the user table space.
v DSN1COPY of DSNDB01.DBD01. Operator Response: Collect the console output from
the system on which the job was run for the period of
Also collect the following diagnostic items listed in time spanning the failure. Save this output for use in
“Appendix B. Problem determination” on page 1281: 1, problem determination.
2, 5, 31, 32, 33, 37.
System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
800 DB2 UDB for OS/390 and z/OS: Messages and Codes
00C9021F • 00C90221
and Reference for information on identifying and System Action: A record is written to SYS1.LOGREC,
reporting the problem. and an SVC dump is requested.
Problem Determination: Collect the following User Response: Notify the system programmer.
diagnostic items listed in “Appendix B. Problem
Operator Response: Collect the console output from
determination” on page 1281: 1, 5, 3, 32, 37.
the system on which the job was run for the period of
time spanning the failure. Save this output for use in
00C9021F problem determination.
Explanation: The data manager detected an System Programmer Response: If you suspect an
inconsistent data condition in a segmented table space. error in DB2, refer to Part 2 of DB2 Diagnosis Guide
A duplicate first segment block for a table is found and Reference for information on identifying and
during the rebuilding of the first segment block in a reporting the problem.
segmented table space. The segment chain may be
Problem Determination: Message DSNI013I is issued
broken.
to identify the data pages. It identifies the database
This abend reason code is issued by the following name, table space name, and index space name. This
CSECT: DSNISEGR message is issued for all pages in use at the time of the
abend. Within this group of pages, at least one page is
System Action: A record is written to SYS1.LOGREC,
involved in the inconsistency. The other pages were
and an SVC dump is requested.
present at the time of the abend.
User Response: Notify the system programmer.
From the console output, determine if resource
Operator Response: Collect the console output from unavailable message DSNT500I/DSNT501I was given
the system on which the job was run for the period of prior to the abend. If there is and the reason code given
time spanning the failure. Save this output for use in is 00C90092, 00C90093, or 00C90096, then refer to the
problem determination. description of the appropriate message in this book for
more information. Otherwise, collect the following
System Programmer Response: If you suspect an diagnostic items listed in “Appendix B. Problem
error in DB2, refer to Part 2 of DB2 Diagnosis Guide determination” on page 1281: 1, 2, 5, 31, 32, 33. Also
and Reference for information on identifying and collect a DSN1COPY output of the tables and indexes
reporting the problem. before any recover is performed.
Problem Determination: Collect the following
diagnostic items: 00C90221
v Console output from the system on which the job was
run and a listing of SYSLOG data set for the period Explanation: The data manager detected an
of time spanning the failure. inconsistent data condition. In this case, a
nonsegmented space map page was read for a table
v Listing of SYS1.LOGREC data set, obtained by space that had been defined as segmented. This
executing IFCEREP1. problem could be caused by incorrect use of the
v SVC dump (or system dump), taken to DSN1COPY service aid or a DB2 internal problem
SYS1.DUMPxx data set, as a result of operator reading the space map page.
initiated dump command or SLIP trap exit.
This abend reason code is issued by the following
v SYSPRINT output, including JCL, for the batch job CSECT: DSNISGAU
and system messages that were issued
v Definitions of table spaces, tables, and indexes System Action: A record is written to SYS1.LOGREC,
involved in the error and an SVC dump is requested.
v Listing of the entire table space User Response: Notify the system programmer.
v Listing of the DBD, obtained by executing UTILITY Operator Response: Collect the console output from
DIAGNOSE OBD. the system on which the job was run for the period of
time spanning the failure. Save this output for use in
00C90220 problem determination.
Explanation: The data manager detected an System Programmer Response: If you suspect an
inconsistent data condition. In this case, free index page error in DB2, Refer to Part 2 of DB2 Diagnosis Guide
cannot be found in the index space. The problem could and Reference for information on identifying and
be caused by a problem detected by IRLM, such as reporting the problem.
out-of-storage, or some other problem. Problem Determination: SYS1.LOGREC contains
This abend reason code is issued by the following information in the variable recording area (VRA) of the
CSECT: DSNISMXF. system diagnostic work area (SDWA). Significant fields
for this abend code are: VRARRK5, VRARRK6,
Chapter 37. DB2 Codes 801
00C90222 • 00C90D01
VRARRK7, VRARRK8, and VRARRK9. System Programmer Response: Refer to Part 2 of
DB2 Diagnosis Guide and Reference for information on
Refer also to Table 4 in “Appendix B. Problem
identifying and reporting the problem.
determination” on page 1281 for further information on
DSN1COPY misuse. Collect the following diagnostic Problem Determination: Collect the following
items listed in “Appendix B. Problem determination” on diagnostic items listed in “Appendix B. Problem
page 1281: 1, 2, 32, 37. determination” on page 1281: 1, 2, 5, 32, 37.
00C90222 00C90303
Explanation: While starting DB2, the data manager Explanation: An attempt to make the database
detected a utility in process (UTUT, UTRO or UTRW) exception table (DBET) consistent failed after an agent
state on an object that originated from Version 2 failure.
Release 3. This abend might indicate an internal DB2
System Action: The DB2 subsystem abends, a record
error, but most likely occurs because of a user error. A
is written to SYS1.LOGREC, and an SVC dump is
possible user error is a result of not terminating all
requested.
utilities before migrating to this release.
Problem Determination: This reason code is issued
This abend reason code is issued by the following
by the following CSECT: DSNIDBPX
CSECT: DSNIERST
Restarting the member rebuilds the local DBET. Analyze
System Action: The -START DB2 command fails. A
SYS1.LOGREC and the dump to determine why the
record is written to SYS1.LOGREC and an SVC dump
agent failed and why the attempt to make the DBET
is requested. The dump is required if the problem is
consistent failed.
determined to be a DB2 internal error.
User Response: Notify the system programmer.
00C90304
System Programmer Response: Determine if an
Explanation: START DATABASE recovery of GRECP
improper procedure was used to migrate to this release.
cannot proceed because the recover base RBA value in
If the utilities were not terminated before migrating, fall
the header page for the object is invalid. The following
back to Version 2 Release 3 and restart DB2. Use the
might have occurred:
-TERM UTILITY command to terminate utilities, use the
-DISPLAY UTILITY command to make sure no utility job v The data set was restored from an earlier release
is currently active, stop DB2, and remigrate to this backup that does not have a starting RBA or LRSN in
release. the header page.
v DSN1COPY RESET utility command.
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem System Action: The GRECP recovery for this object
determination” on page 1281: 1, 2, 5, 31, 33. is terminated; all other objects being recovered by this
START DATABASE command are not affected.
00C90301 System Programmer Response: Use the RECOVER
utility without the LOGONLY option.
Explanation: The data manager detected an internal
error with DB2 during RID LIST processing. The Problem Determination: If you suspect an error in
requested RIDMAP pointer can not be found in the DB2, refer to Part 2 of DB2 Diagnosis Guide and
specified CUB control block. Reference for information on identifying and reporting
the problem.
This abend reason code is issued by the following
CSECTs: Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
DSNICMT2 DSNIRIDR DSNITCUS DSNXRFCH 2, 5.
DSNXRRID DSNXRSFN DSNXRSGB DSNXRT1J
DSNXSMIN DSNXSMRL DSNXSMUN DSNXSRID This abend reason code is issued by the following
CSECT: DSNISREC
System Action: A record is written to SYS1.LOGREC
and an SVC dump is requested. 00C90D01
User Response: Notify the system programmer. Explanation: DB2 detected an inconsistent condition.
An entry in the auxiliary index was not found. The error
Operator Response: Collect the console output from is probably caused by not recovering all table spaces in
the system on which the job was run from the period of a table space set to the same point-in-time.
time spanning the failure. Save this output for use in
problem determination. This abend reason code is issued by the following
CSECTs: DSNONLLE and DSNOTCSO
802 DB2 UDB for OS/390 and z/OS: Messages and Codes
System Action: A record is written to SYS1.LOGREC
and an SVC dump is requested.
System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and
reporting the problem.
Problem Determination: Message DSNI013I is issued
to identify the index page. Run CHECK INDEX on the
auxiliary index followed by CHECK DATA on the base
table space in order to identify the inconsistencies. See
DB2 Utility Guide and Reference for information about
CHECK INDEX and CHECK DATA.
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
3, 5.
Chapter 37. DB2 Codes 803
804 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 38. X’D1......’ Codes
For X'D1' codes, DB2 provides the following diagnostic information in the
SYS1.LOGREC variable recording area (VRA) of the SDWA for many of the reason
codes:
MODID
Name of module issuing the abend
LEVEL
Change level
COMPONENT
Subcomponent ID
REGISTERS
General purpose registers (GPRs) 0 through 15 at time of abend
information required to process this request. An MVS
00D10010
GETMAIN failed when attempting to obtain the required
Explanation: The DB2 stand-alone log services OPEN storage.
processing macro (DSNJSLR) issues this reason code.
This reason code is issued by the following CSECTs:
The RANGE parameter on the OPEN request specifies
the address of a 12-byte area containing the log relative DSNJRS01 DSNJRS03 DSNJRS04
byte address (RBA) range to be processed by
subsequent GET requests. However, the RBA specified
in the second six bytes of the RANGE parameter (which System Action: In response to the DSNJSLR
indicates the end of the log RBA ) is less than or equal FUNC=OPEN or FUNC=GET call, DB2 places a return
to the RBA specified in the first six bytes of the RANGE code of 8 in register 15 and a reason code of 00D10011
parameter (which indicates the start of the log RBA). in register 0. No abend is issued by the stand-alone log
services CSECT (DSNJRS01), and no information is
This reason code is issued by the following CSECT: written to SYS1.LOGREC data set.
DSNJRS01
The stand-alone log services program is under the
System Action: In response to the DSNJSLR control of a user-written program that uses the
FUNC=OPEN call, DB2 places a return code of 8 in DSNJSLR macro. The user program must therefore
register 15 and a reason code of 00D10010 in register anticipate and react to a nonzero return code and a
0. No abend is issued by the stand-alone log services nonzero reason code, possibly by terminating the
CSECT (DSNJRS01), and no information is written to execution of the user program.
SYS1.LOGREC data set.
For additional details about the stand-alone log
The stand-alone log services program is under the services, including a sample of an application program
control of a user-written program that uses the which reacts to nonzero return codes and nonzero
DSNJSLR macro. The user application program must reason codes, refer to Appendix C (Volume 2) of DB2
therefore anticipate and react to a nonzero return code Administration Guide.
and a nonzero reason code, possibly by terminating the
execution of the user program. System Programmer Response: In all likelihood, the
REGION parameter on the EXEC statement for the user
For additional details about the stand-alone log program is too small. Increase the REGION size, and
services, including a sample of an application program resubmit the user program.
which reacts to nonzero return codes and nonzero
reason codes, refer to Appendix C (Volume 2) of DB2
Administration Guide. 00D10012
System Programmer Response: Correct the RANGE Explanation: The DB2 stand-alone log services OPEN
RBA parameter input, and resubmit the request. processing macro (DSNJSLR) issued this reason code.
The Job Control Language (JCL) for the user program
that uses the DSNJSLR macro must specify either the
00D10011 use of the bootstrap data set (BSDS) or, in the absence
Explanation: The DB2 stand-alone log services OPEN of the BSDS, the active or archive data set(s) which is
and GET processing macro (DSNJSLR) issued this used in the processing. The FUNC=OPEN request
reason code. During the initial processing of a failed because neither BSDS nor any log data set is
FUNC=OPEN or FUNC=GET request, storage is allocated for the job.
obtained to contain the control blocks and other
© Copyright IBM Corp. 1982, 2001 805
00D10013 • 00D10015
This reason code is issued by the following CSECT: returned in SLRFERCD. Take appropriate action, and
DSNJRS01 resubmit the FUNC=OPEN request.
System Action: In response to the DSNJSLR
FUNC=OPEN call, DB2 places a return code of 8 in 00D10014
register 15 and a reason code of 00D10012 in register
Explanation: The DB2 stand-alone log services OPEN
0. No abend is issued by the stand-alone log services
processing macro (DSNJSLR) issued this reason code.
CSECT (DSNJRS01), and no information is written to
The Job Control Language (JCL) associated with the
SYS1.LOGREC data set.
user-written application determines how access to the
The stand-alone log services program is under the DB2 log data is achieved. Access can either be through
control of a user-written program that uses the the bootstrap data set (BSDS), or through the explicit
DSNJSLR macro. The user program must therefore inclusion of ddnames in the JCL for the active or
anticipate and react to a nonzero return code and a archive log data set(s) which are to be examined. If the
nonzero reason code, possibly by terminating the BSDS method is used, the user must specify a RANGE
execution of the user program. parameter on the FUNC=OPEN call. This reason code
indicates that the user used the BSDS method, but did
For additional details about the stand-alone log
not specify the range of RBAs to be examined.
services, including a sample of an application program
which reacts to nonzero return codes and nonzero This reason code is issued by the following CSECT:
reason codes, refer to Appendix C (Volume 2) of DB2 DSNJRS01
Administration Guide.
System Action: In response to the DSNJSLR
System Programmer Response: Correct the JCL and FUNC=OPEN call, DB2 places a return code of 8 in
resubmit the user program. register 15 and a reason code of 00D10014 in register
0. No abend is issued by the stand-alone log services
CSECT (DSNJRS01), and no information is written to
00D10013
SYS1.LOGREC data set.
Explanation: The DB2 stand-alone log services OPEN
The stand-alone log services program is under the
processing macro (DSNJSLR) issued this reason code.
control of a user-written program that uses the
A VSAM OPEN error occurred while opening the
DSNJSLR macro. The user program must therefore
bootstrap data set (BSDS).
anticipate and react to a nonzero return code and a
This reason code is issued by the following CSECT: nonzero reason code, possibly by terminating the
DSNJRS04 execution of the user program.
System Action: In response to the DSNJSLR For additional details about the stand-alone log
FUNC=OPEN call, DB2 places a return code of 12 in services, including a sample of an application program
register 15 and a reason code of 00D10013 in register which reacts to nonzero return codes and nonzero
0. No abend is issued by the stand-alone log services reason codes, refer to Appendix C (Volume 2) of DB2
CSECT (DSNJRS01), and no information is written to Administration Guide.
SYS1.LOGREC data set.
System Programmer Response: Two choices are
Information about the results of the OPEN request is available:
also returned in the stand-alone log GET Feedback 1. Continue to use the BSDS method of access. If this
Area (SLRF). The VSAM OPEN error return code is choice is made, then the FUNC=OPEN invocation
placed in SLRFRG15. The ACB error code must specify a range of RBAs to be examined by
(ACBERFLG) is placed in SLRFERCD. use of the RANGE parameter.
The stand-alone log services program is under the 2. Replace the use of the BSDS method of access.
control of a user-written program that uses the This can be done be using explicit archive data set
DSNJSLR macro. The user program must therefore ddnames and/or active log data set ddnames in the
anticipate and react to a nonzero return code and a JCL used to invoke the user-written application
nonzero reason code, possibly by terminating the program.
execution of the user program.
For additional details about the stand-alone log 00D10015
services, including a sample of an application program
Explanation: The DB2 stand-alone log services OPEN
which reacts to nonzero return codes and nonzero
processing macro (DSNJSLR) issued this reason code.
reason codes, refer to Appendix C (Volume 2) of DB2
The VSAM OPEN of the bootstrap data set was
Administration Guide.
successful but the record format of the BSDS is
System Programmer Response: Refer to the incompatible with this release of the stand-alone log
DFSMS/MVS: Macro Instructions for Data Sets to services.
determine the meaning of the VSAM OPEN error
returned in SLRFRG15, and the ACB error code
806 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D10016 • 00D10018
This reason code is issued by the following CSECT: Correct the JCL and rerun the job. Specify either the
DSNJRS04 DD statements for the log data sets (MxxARCHV and
MxxACTN) or the DD statement for the BSDS
System Action: In response to DSNJSLR
(MxxBSDS) for a given member; do not specify both.
FUNC=OPEN call, DB2 places a return code of 12 in
register 15 and a reason code of 00D10015 in register For additional details about the stand-alone log
0. No abend is issued by the stand-alone log services services, including a sample of an application program
CSECT (DSNJRS01), and no information is written to that reacts to the nonzero return codes and nonzero
SYS1.LOGREC data set. reason codes, refer to Appendix C (Volume 2) of DB2
Administration Guide.
The stand-alone log services program is under the
control of a user-written program that uses the
DSNJSLR macro. The user program must, therefore, 00D10017
anticipate and react to a nonzero return code and a
Explanation: The DB2 stand-alone log services OPEN
nonzero reason code, possibly by terminating the
processing macro (DSNJSLR) issued this reason code.
execution of the user program.
The job control language (JCL) associated with the
For additional details about the stand-alone log user-written application indicated that the logs from
services, including a sample of an application program more than one DB2 member were to be read in CI
which reacts to the nonzero return codes and nonzero mode. However, CI mode is allowed only when reading
reason codes, refer to Appendix C (Volume 2) of DB2 the log of a single DB2 system.
Administration Guide.
This reason code is issued by the following CSECT:
System Programmer Response: Determine the DSNJRS06
BSDS release level by running the print log map
System Action: In response to DSNJSLR
(DSNJU004) utility and then run the appropriate BSDS
FUNC=OPEN call, DB2 places a return code of 12 in
MIGRATION/FALLBACK program to reformat the
register 15 and a reason code of 00D10017 in register
bootstrap data set.
0. No abend is issued by the stand-alone log services,
v If the release level of the BSDS data set is at 2.2 and and no information is written to SYS1.LOGREC data
below, then run the BSDS conversion program set.
(DSNJMIG0) to migrate forward to the 2.3 and above
release level. User Response:
v If the release level of the BSDS data set is at 2.3 and Either remove the CI mode from the OPEN request to
above, then run the BSDS conversion program read log records of more than one member or change
(DSNJFAL0) to fall back to the 2.2 and below release the JCL to specify only one system’s log to read its log
level. in CI mode.
For additional details about the stand-alone log
When the BSDS data set has been converted to the
services, including a sample of an application program
new format, rerun the original application program.
that reacts to the nonzero return codes and nonzero
reason codes, refer to Appendix C (Volume 2) of DB2
00D10016 Administration Guide.
Explanation: The DB2 stand-alone log services OPEN
processing macro (DSNJSLR) issued this reason code. 00D10018
In the job control language (JCL) associated with the
Explanation: The DB2 stand-alone log services OPEN
user-written application, MxxARCHV and/or MxxACTn
processing macro (DSNJSLR) issued this reason code.
DD statements were specified for a DB2 member while
In the job control language (JCL) associated with the
MxxBSDS was also specified for the same member.
user-written application, more than one DB2 system’s
However, the specification of MxxARCHV and MxxACTn
logs were identified. However, on the OPEN request an
DD statements is mutually exclusive with the
RBA range was specified. When reading logs from more
specification of MxxBSDS DD statement for the same
than one DB2 system, you cannot specify an RBA
member.
range; you must specify an LRSN range.
This reason code is issued by the following CSECT:
This reason code is issued by the following CSECT:
DSNJRS06
DSNJRS06
System Action: In response to DSNJSLR
System Action: In response to DSNJSLR
FUNC=OPEN call, DB2 places a return code of 12 in
FUNC=OPEN call, DB2 places a return code of 12 in
register 15 and a reason code of 00D10016 in register
register 15 and a reason code of 00D10018 in register
0. No abend is issued by the stand-alone log services,
0. No abend is issued by the stand-alone log services,
and no information is written to SYS1.LOGREC data
and no information is written to SYS1.LOGREC data
set.
set.
User Response:
Chapter 38. DB2 Codes 807
00D10019 • 00D10021
User Response: Correct the range specification on
00D10020
the OPEN request, and rerun the job. If range is
specified when reading log records from multiple Explanation: The DB2 stand-alone log services GET
members, LRSN=YES must also be specified. Also processing macro (DSNJSLR) issued this reason code.
range must be specified if GROUP DD or a MxxBSDS The end of data has been reached (end of the log, end
(BSDS) DD is specified in the JCL. of the user-specified log data set(s), or end of the log
RBA range specified by the RANGE parameter).
For additional details about the stand-alone log
services, including a sample of an application program This reason code is issued by the following CSECTs:
which reacts to the nonzero return codes and nonzero DSNJRS02, DSNJRS03
reason codes, refer to Appendix C (Volume 2) of DB2
System Action: In response to the DSNJSLR
Administration Guide.
FUNC=GET call, DB2 places a return code of 4 in
register 15 and a reason code of 00D10020 in register
00D10019 0. No abend is issued by the stand-alone log services
CSECT (DSNJRS01), and no information is written to
Explanation: The DB2 stand-alone log services OPEN
SYS1.LOGREC data set.
processing macro (DSNJSLR) issued this reason code.
A VSAM OPEN error occurred while opening the The stand-alone log services program is under the
bootstrap data set (BSDS). The error was determined to control of a user-written program that uses the
be one which could be corrected by use of an AMS DSNJSLR macro. The user program must therefore
VERIFY, but the VERIFY also failed. anticipate and react to a nonzero return code and a
nonzero reason code, possibly by terminating the
This reason code is issued by the following CSECT:
execution of the user program.
DSNJRS04
For additional details about the stand-alone log
System Action: In response to the DSNJSLR
services, including a sample of an application program
FUNC=OPEN call, DB2 places a return code of 12 in
which reacts to nonzero return codes and nonzero
register 15 and a reason code of 00D10019 in register
reason codes, refer to Appendix C (Volume 2) of DB2
0. No abend is issued by the stand-alone log services
Administration Guide.
CSECT (DSNJRS01), and no information is written to
SYS1.LOGREC data set. System Programmer Response: This is not an error;
rather, this reason code denotes a normal end of data
Information about the results of the OPEN request is
condition. No action is necessary.
also returned in the stand-alone log GET Feedback
Area (SLRF). The VSAM return code from the original
VSAM OPEN error is placed in SLRFRG15. The ACB 00D10021
error code (ACBERFLG) from the ACB used in the
Explanation: The DB2 stand-alone log services GET
original VSAM OPEN operation is placed in
processing macro (DSNJSLR) issued this reason code.
SLRFERCD.
A gap in the log RBA range has been encountered
The stand-alone log services program is under the when switching log data sets, indicating missing log
control of a user-written program that uses the records.
DSNJSLR macro. The user program must therefore
This condition may or may not be intentional on the part
anticipate and react to a nonzero return code and a
of the user. Normally, a continuous set of log records
nonzero reason code, possibly by terminating the
are supplied as input by the ACTIVEn and ARCHIVE
execution of the user program.
ddnames in the user’s JCL. If a log data set was
For additional details about the stand-alone log intentionally (or unintentionally) removed, this condition
services, including a sample of an application program will arise.
which reacts to nonzero return codes and nonzero
This reason code is issued by the following CSECT:
reason codes, refer to Appendix C (Volume 2) of DB2
DSNJRS02
Administration Guide.
System Action: In response to the DSNJSLR
System Programmer Response: Refer to the
FUNC=GET call, DB2 places a return code of 4 in
DFSMS/MVS: Macro Instructions for Data Sets to
register 15 and a reason code of 00D10021 in register
determine the meaning of the VSAM OPEN error
0. No abend is issued by the stand-alone log services
returned in SLRFRG15, and the ACB error code
CSECT (DSNJRS01), and no information is written to
returned in SLRFERCD. take appropriate action, and
SYS1.LOGREC data set.
resubmit the FUNC=OPEN request.
Information about the results of the GET request is also
returned in the stand-alone log GET Feedback Area
(SLRF). A pointer to the next log record following the
gap is placed in SLRFFRAD.
The stand-alone log services program is under the
808 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D10022 • 00D10023
control of a user-written program that uses the For additional details about the stand-alone log
DSNJSLR macro. The user program must therefore services, including a sample of an application program
anticipate and react to a nonzero return code and a which reacts to nonzero return codes and nonzero
nonzero reason code, possibly by terminating the reason codes, refer to Appendix C (Volume 2) of DB2
execution of the user program. Administration Guide.
If you suspect an error in DB2, refer to Part 2 of DB2 System Programmer Response: As mentioned
Diagnosis Guide and Reference for information on above, this may or may not be an intentional error.
identifying and reporting the problem. Check the RBA range specified on the RANGE
parameter to determine if the end RBA value was in
System Programmer Response: As mentioned
error. Check the user’s JCL to ensure that a continuous
above, this may or may not be an intentional error.
string of log records has been supplied. If the BSDS
Check the user’s JCL to ensure that a continuous string
method is being used, use the print log map
of log records has been supplied. If the BSDS method
(DSNJU004) utility to examine the RBA ranges as
is being used, use the print log map (DSNJU004) utility
recorded in the BSDS, and note any RBA gaps which
to examine the RBA ranges as recorded in the BSDS,
may have resulted from the deletion of an active log
and note any RBA gaps which may have resulted from
data set or an archive log data set.
the deletion of an active log data set or an archive log
data set. If it appears that a log error may have occurred,
execute the log print utility (DSN1LOGP) to attempt to
If it appears that a log error may have occurred,
obtain a detailed report of the log record(s) associated
execute the log print utility (DSN1LOGP) to attempt to
with the failure. If the DSN1LOGP utility fails, refer to
obtain a detailed report of the log record(s) associated
Part 4 (Volume 1) of DB2 Administration Guide for
with the failure. If the DSN1LOGP utility fails, refer to
information about recovery from log failures.
Part 4 (Volume 1) of DB2 Administration Guide for
information about recovery from log failures.
00D10023
00D10022 Explanation: The DB2 stand-alone log services GET
processing macro (DSNJSLR) issued this reason code.
Explanation: The DB2 stand-alone log services GET
A gap in the log RBA range has been encountered, and
processing macro (DSNJSLR) issued this reason code.
a conditional restart record has been found beyond a
A gap in the log RBA range has been encountered
conditional restart truncation point. This condition exists
when switching log data sets, indicating missing log
when a log RBA gap was intentionally forced by the
records, and the log RBA of the next record following
user as part of log truncation during conditional restart.
the gap is greater than the end RBA of the RBA range
specified by the RANGE parameter. This reason code is issued by the following CSECT:
DSNJRS02
This condition may or may not be intentional on the part
of the user. Normally, a continuous set of log records System Action: In response to the DSNJSLR
are supplied as input by the ACTIVEn and ARCHIVE FUNC=GET call, DB2 places a return code of 4 in
ddnames in the user’s JCL. If a log data set was register 15 and a reason code of 00D10023 in register
intentionally (or unintentionally) removed, this condition 0. No abend is issued by the stand-alone log services
will arise. CSECT (DSNJRS01), and no information is written to
SYS1.LOGREC data set.
This reason code is issued by the following CSECTs:
DSNJRS03, DSNJRS04 Information about the results of the GET request is also
returned in the stand-alone log GET Feedback Area
System Action: In response to the DSNJSLR
(SLRF). The length, address, and RBA of the
FUNC=GET call, DB2 places a return code of 8 in
conditional restart record are placed in fields
register 15 and a reason code of 00D10022 in register
SLRFRCLL, SLRFFRAD and SLRFRBA, respectively.
0. No abend is issued by the stand-alone log services
CSECT (DSNJRS01), and no information is written to The stand-alone log services program is under the
SYS1.LOGREC data set. control of a user-written program that uses the
DSNJSLR macro. The user program must therefore
Information about the results of the GET request is also
anticipate and react to a nonzero return code and a
returned in the stand-alone log GET Feedback Area
nonzero reason code, possibly by terminating the
(SLRF). A pointer to the next log record following the
execution of the user program.
gap is placed in SLRFFRAD.
For additional details about the stand-alone log
The stand-alone log services program is under the
services, including a sample of an application program
control of a user-written program that uses the
which reacts to nonzero return codes and nonzero
DSNJSLR macro. The user program must therefore
reason codes, refer to Appendix C (Volume 2) of DB2
anticipate and react to a nonzero return code and a
Administration Guide.
nonzero reason code, possibly by terminating the
execution of the user program. System Programmer Response: Use the print log
Chapter 38. DB2 Codes 809
00D10024 • 00D10026
map (DSNJU004) utility to examine the conditional starting with the ACTIVE1 ddname, and progressing
restart control records and the RBA ranges of log data through the ACTIVEn ddname.
sets. Note any RBA gaps which may have resulted from
the truncation of the log during a conditional restart. Following the above adjustments, resubmit the user’s
JCL.
If it appears that a log error may have occurred,
execute the log print utility (DSN1LOGP) to attempt to
obtain a detailed report of the log record(s) associated 00D10025
with the failure. If the DSN1LOGP utility fails, refer to
Part 4 (Volume 1) of DB2 Administration Guide for Explanation: The DB2 stand-alone log services GET
information about recovery from log failures. processing macro (DSNJSLR) issued this reason code.
A VSAM error occurred while reading an active log data
set.
00D10024
This reason code is issued by the following CSECT:
Explanation: The DB2 stand-alone log services GET DSNJRS03
processing macro (DSNJSLR) issued this reason code.
A log RBA sequence error has occurred. The RBA of System Action: In response to the DSNJSLR
the previous log record is greater than the RBA of the FUNC=GET call, DB2 places a return code of 12 in
current log record. register 15 and a reason code of 00D10025 in register
0. No abend is issued by the stand-alone log services
This reason code is issued by the following CSECT: CSECT (DSNJRS01), and no information is written to
DSNJRS03 SYS1.LOGREC data set.
System Action: In response to the DSNJSLR Information about the results of the GET request is also
FUNC=GET call, DB2 places a return code of 8 in returned in the stand-alone log GET Feedback Area
register 15 and a reason code of 00D10024 in register (SLRF). The VSAM GET error return code is placed in
0. No abend is issued by the stand-alone log services SLRFRG15. The RPL error code (RPLERRCD) is
CSECT (DSNJRS01), and no information is written to placed in SLRFERCD. The ddname of the data set on
SYS1.LOGREC data set. which the activity occurred is placed in SLRFDDNM.
Information about the results of the GET request is also The stand-alone log services program is under the
returned in the stand-alone log GET Feedback Area control of a user-written program that uses the
(SLRF). A pointer to the next log record following the DSNJSLR macro. The user program must therefore
gap is placed in SLRFFRAD. anticipate and react to a nonzero return code and a
nonzero reason code, possibly by terminating the
The stand-alone log services program is under the
execution of the user program.
control of a user-written program that uses the
DSNJSLR macro. The user program must therefore For additional details about the stand-alone log
anticipate and react to a nonzero return code and a services, including a sample of an application program
nonzero reason code, possibly by terminating the which reacts to nonzero return codes and nonzero
execution of the user program. reason codes, refer to Appendix C (Volume 2) of DB2
Administration Guide.
For additional details about the stand-alone log
services, including a sample of an application program System Programmer Response: Refer to the
which reacts to nonzero return codes and nonzero DFSMS/MVS: Macro Instructions for Data Sets to
reason codes, refer to Appendix C (Volume 2) of DB2 determine the meaning of the VSAM GET error returned
Administration Guide. in SLRFRG15, and the RPL error code returned in
SLRFERCD. Take appropriate action to correct the
System Programmer Response: The DD statements
error.
in the user’s Job Control Language (JCL) must specify
the log data sets in ascending log RBA range order. If
both ARCHIVE and ACTIVEn DD statements are 00D10026
included, the first archive data set must contain the
lowest log RBA value. Explanation: The DB2 stand-alone log services GET
processing macro (DSNJSLR) issued this reason code.
Use the print log map (DSNJU004) utility to obtain a The GET processing was unable to locate a log data
listing of the RBA ranges associated with each archive set containing the requested RBA.
log data set and active log data set. If necessary:
This reason code is issued by the following CSECT:
v Adjust the concatenation sequence of the archive DSNJRS04
data sets in the user’s JCL to ensure that the log
records are read in ascending RBA sequence. System Action: In response to the DSNJSLR
v Adjust the order of the active log data sets such that FUNC=GET call, DB2 places a return code of 8 in
the RBA range is arranged in ascending order, register 15 and a reason code of 00D10026 in register
0. No abend is issued by the stand-alone log services
810 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D10027 • 00D10029
CSECT (DSNJRS01), and no information is written to SLRFRG15. The RPL error code (RPLERRCD) is
SYS1.LOGREC data set. placed in SLRFERCD.
Information about the results of the GET request is also The stand-alone log services program is under the
returned in the stand-alone log GET Feedback Area control of a user-written program that uses the
(SLRF). The RBA for which the GET request failed is DSNJSLR macro. The user program must therefore
placed in SLRFRBA. anticipate and react to a nonzero return code and a
nonzero reason code, possibly by terminating the
The stand-alone log services program is under the
execution of the user program.
control of a user-written program that uses the
DSNJSLR macro. The user program must therefore For additional details about the stand-alone log
anticipate and react to a nonzero return code and a services, including a sample of an application program
nonzero reason code, possibly by terminating the which reacts to nonzero return codes and nonzero
execution of the user program. reason codes, refer to Appendix C (Volume 2) of DB2
Administration Guide.
For additional details about the stand-alone log
services, including a sample of an application program System Programmer Response: Refer to the
which reacts to nonzero return codes and nonzero DFSMS/MVS: Macro Instructions for Data Sets to
reason codes, refer to Appendix C (Volume 2) of DB2 determine the meaning of the VSAM GET error returned
Administration Guide. in SLRFRG15, and the RPL error code returned in
SLRFERCD. Take appropriate action to correct the
System Programmer Response: There could be
error.
several reasons for this error:
v The RBA range supplied in the RANGE parameter
may have exceeded the upper or lower bound of 00D10028
RBAs available on all active log data sets and all Explanation: The DB2 stand-alone log services OPEN
archive log data sets. This will normally occur when processing macro (DSNJSLR) issued this reason code.
the user has specified the bootstrap data set (BSDS) Both LRSN range and CI mode read were specified on
method in the JCL. the OPEN request when reading the log of a DB2
v The RBA range supplied in the RANGE parameter system. However, when reading the log in CI mode,
may have exceeded the upper or lower bound of range can be specified only in RBA.
RBAs available on the active log data sets and/or
This reason code is issued by the following CSECT:
archive log data sets supplied in the user’s JCL. This
DSNJRS06
will occur when the user has supplied log data sets
using the ACTIVEn and ARCHIVE ddnames. System Action: In response to DSNJSLR
FUNC=OPEN call, DB2 places a return code of 12 in
To resolve the problem, use the print log map register 15 and a reason code of 00D10028 in register
(DSNJU004) utility to obtain a listing of the archive and 0. No abend is issued by the stand-alone log services,
active log data sets, and their corresponding RBA and no information is written to SYS1.LOGREC data
ranges. Check the user’s JCL and the user’s RANGE set.
parameter to ensure that they are in harmony with one
User Response: Correct the range specification on
another. Correct the JCL and RANGE parameters as
the OPEN request, and rerun the job.
necessary, and rerun the application.
For additional details about the stand-alone log
services, including a sample of an application program
00D10027
which reacts to the nonzero return codes and nonzero
Explanation: The DB2 stand-alone log services GET reason codes, refer to Appendix C (Volume 2) of DB2
processing macro (DSNJSLR) issued this reason code. Administration Guide.
A VSAM error occurred while reading the bootstrap data
set (BSDS).
00D10029
This reason code is issued by the following CSECT:
Explanation: The DB2 stand-alone log services OPEN
DSNJRS03
processing macro (DSNJSLR) issued this reason code.
System Action: In response to the DSNJSLR The BSDS data set of a member named in the BSDS
FUNC=GET call, DB2 places a return code of 12 in data set pointed to by the GROUP DD statement cannot
register 15 and a reason code of 00D10027 in register be allocated.
0. No abend is issued by the stand-alone log services
This reason code is issued by the following CSECT:
CSECT (DSNJRS01), and no information is written to
DSNJRS06
SYS1.LOGREC data set.
System Action: In response to DSNJSLR
Information about the results of the GET request is also
FUNC=OPEN call, DB2 places a return code of 12 in
returned in the stand-alone log GET Feedback Area
register 15 and a reason code of 00D10029 in register
(SLRF). The VSAM GET error return code is placed in
Chapter 38. DB2 Codes 811
00D1002A • 00D1002B
0. No abend is issued by the stand-alone log services, returned in SLRFERCD. Take appropriate action, and
and no information is written to SYS1.LOGREC data then resubmit the application job.
set.
User Response: Make sure the BSDS data set of 00D1002B
every member named in the BSDS data set pointed to
Explanation: The DB2 stand-alone log services GET
by the GROUP DD statement is available for allocation.
processing macro (DSNJSLR) issued this reason code.
If the missing BSDS data set belongs to a member that
The GET processing has requested an RBA in an active
is no longer active and its BSDS data set does not exist
log data set which was previously not opened. A VSAM
any more, then do not use GROUP DD to allocate
OPEN error occurred while opening the active log data
required BSDS and log data sets. To read log records of
set. The error was determined to be one which could be
other active members, specify a MxxBSDS DD
corrected; however, a system error occurred while
statements for each active member. The print log map
executing an MVS TESTCB macro to determine
(DSNJU004) utility can be used to find the name of
whether the active log data set which had just been
every member’s BSDS data set.
opened was a VSAM ESDS data set or a VSAM LDS
For additional details about the stand-alone log data set.
services, including a sample of an application program
This reason code is issued by the following CSECT:
which reacts to the nonzero return codes and nonzero
DSNJRS03
reason codes, refer to Appendix C (Volume 2) of DB2
Administration Guide. System Action: In response to the DSNJSLR
FUNC=GET call, DB2 places a return code of 12 in
register 15 and a reason code of 00D1002B in register
00D1002A
0. No abend is issued by the stand-alone log services
Explanation: The DB2 stand-alone log services GET CSECT (DSNJRS01), and no information is written to
processing macro (DSNJSLR) issued this reason code. SYS1.LOGREC data set.
The GET processing has requested an RBA in an active
Information about the results of the GET request is also
log data set which was previously not opened. A VSAM
returned in the stand-alone log GET Feedback Area
OPEN error occurred while opening the active log data
(SLRF). The VSAM return code from the original VSAM
set.
OPEN error is placed in SLRFRG15. The ACB error
This reason code is issued by the following CSECT: code (ACBERFLG) from the ACB used in the original
DSNJRS03 VSAM OPEN operation is placed in SLRFERCD. The
ddname of the data set on which the activity occurred is
System Action: In response to the DSNJSLR
placed in SLRFDDNM.
FUNC=GET call, DB2 places a return code of 12 in
register 15 and a reason code of 00D1002A in register The stand-alone log services program is under the
0. No abend is issued by the stand-alone log services control of a user-written program that uses the
CSECT (DSNJRS01), and no information is written to DSNJSLR macro. The user program must therefore
SYS1.LOGREC data set. anticipate and react to a nonzero return code and a
nonzero reason code, possibly by terminating the
Information about the results of the GET request is also
execution of the user program.
returned in the stand-alone log GET Feedback Area
(SLRF). The VSAM OPEN error return code is placed in For additional details about the stand-alone log
SLRFRG15. The ACB error code (ACBERFLG) is services, including a sample of an application program
placed in SLRFERCD. The ddname of the data set on which reacts to nonzero return codes and nonzero
which the activity occurred is placed in SLRFDDNM. reason codes, refer to Appendix C (Volume 2) of DB2
Administration Guide.
The stand-alone log services program is under the
control of a user-written program that uses the System Programmer Response: Refer to the
DSNJSLR macro. The user program must therefore DFSMS/MVS: Macro Instructions for Data Sets to
anticipate and react to a nonzero return code and a determine the meaning of the VSAM OPEN error
nonzero reason code, possibly by terminating the returned in SLRFRG15, and the ACB error code
execution of the user program. returned in SLRFERCD. Take appropriate action, and
resubmit the application job.
For additional details about the stand-alone log
services, including a sample of an application program If the SLRFERCD field contains X'1001' (decimal 4097),
which reacts to nonzero return codes and nonzero then the error is the result of an inconsistency between
reason codes, refer to Appendix C (Volume 2) of DB2 the TESTCB parmlist generated in DSNJRS03 and the
Administration Guide. level of MVS under which the application program was
executed. Contact IBM for assistance if SLRFERCD
System Programmer Response: Refer to the
reflects this value.
DFSMS/MVS: Macro Instructions for Data Sets to
determine the meaning of the VSAM OPEN error
returned in SLRFRG15, and the ACB error code
812 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D1002C • 00D10030
This reason code is issued by the following CSECT:
00D1002C
DSNJRS03
Explanation: The DB2 stand-alone log services GET
System Action: In response to the DSNJSLR
processing macro (DSNJSLR) issued this reason code.
FUNC=GET call, DB2 places a return code of 12 in
The GET processing has requested an RBA in an active
register 15 and a reason code of 00D1002D in register
log data set which was previously not opened. A VSAM
0. No abend is issued by the stand-alone log services
OPEN error occurred while opening the active log data
CSECT (DSNJRS01), and no information is written to
set. The error was determined to be one which could be
SYS1.LOGREC data set.
corrected by use of an access method services VERIFY,
but the access method services VERIFY failed. Information about the results of the GET request is also
returned in the stand-alone log GET Feedback Area
This reason code is issued by the following CSECT:
(SLRF). The VSAM return code from the original VSAM
DSNJRS03
OPEN error is placed in SLRFRG15. The ACB error
System Action: In response to the DSNJSLR code (ACBERFLG) from the ACB used in the original
FUNC=GET call, DB2 places a return code of 12 in VSAM OPEN operation is placed in SLRFERCD. The
register 15 and a reason code of 00D1002C in register ddname of the data set on which the activity occurred is
0. No abend is issued by the stand-alone log services placed in SLRFDDNM.
CSECT (DSNJRS01), and no information is written to
The stand-alone log services program is under the
SYS1.LOGREC data set.
control of a user-written program that uses the
Information about the results of the GET request is also DSNJSLR macro. The user program must therefore
returned in the stand-alone log GET Feedback Area anticipate and react to a nonzero return code and a
(SLRF). The VSAM return code from the original VSAM nonzero reason code, possibly by terminating the
OPEN error is placed in SLRFRG15. The ACB error execution of the user program.
code (ACBERFLG) from the ACB used in the original
For additional details about the stand-alone log
VSAM OPEN operation is placed in SLRFERCD. The
services, including a sample of an application program
ddname of the data set on which the activity occurred is
which reacts to nonzero return codes and nonzero
placed in SLRFDDNM.
reason codes, refer to Appendix C (Volume 2) of DB2
The stand-alone log services program is under the Administration Guide.
control of a user-written program that uses the
System Programmer Response: Refer to the
DSNJSLR macro. The user program must therefore
DFSMS/MVS: Macro Instructions for Data Sets to
anticipate and react to a nonzero return code and a
determine the meaning of the VSAM OPEN error
nonzero reason code, possibly by terminating the
returned in SLRFRG15, and the ACB error code
execution of the user program.
returned in SLRFERCD. Take appropriate action (in
For additional details about the stand-alone log most cases, the problem can be solved by use of an
services, including a sample of an application program AMS VERIFY against the active log data set named in
which reacts to nonzero return codes and nonzero the SLRFDDNM field of the SLRF). Once the problem is
reason codes, refer to Appendix C (Volume 2) of DB2 solved, resubmit the application job.
Administration Guide.
System Programmer Response: Refer to the 00D10030
DFSMS/MVS: Macro Instructions for Data Sets to
Explanation: The DB2 stand-alone log services GET
determine the meaning of the VSAM OPEN error
and CLOSE processing macro (DSNJSLR) issued this
returned in SLRFRG15, and the ACB error code
reason code. The stand-alone log services uses a
returned in SLRFERCD. Take appropriate action, and
request block to establish communication between itself
resubmit the application job.
and the invoking application program. The address to
the request block is returned to the application program
00D1002D on a FUNC=OPEN call, and is required for all
subsequent stand-alone FUNC=GET and
Explanation: The DB2 stand-alone log services GET
FUNC=CLOSE calls in the RBR parameter. This reason
processing macro (DSNJSLR) issued this reason code.
code is returned to the invoking application when the
The GET processing has requested an RBA in an active
RBR does not address a valid stand-alone request
log data set which was previously not opened. A VSAM
block. Subsequently, the application program’s request
OPEN error occurred while opening the active log data
cannot be processed.
set. The open error was corrected by use of an access
method services VERIFY, but a subsequent attempt to This reason code is issued by the following CSECT:
reposition the VSAM pointer back to the beginning of DSNJRS01
the active log data set (via access method services
System Action: In response to the DSNJSLR
POINT) failed.
FUNC=GET or FUNC=CLOSE call, DB2 places a return
code of 8 in register 15 and a reason code of 00D10030
Chapter 38. DB2 Codes 813
00D10031 • 00D10040
in register 0. No abend is issued by the stand-alone log services, including a sample of an application program
services CSECT (DSNJRS01), and no information is which reacts to nonzero return codes and nonzero
written to SYS1.LOGREC data set. reason codes, refer to Appendix C (Volume 2) of DB2
Administration Guide.
The stand-alone log services program is under the
control of a user-written program that uses the System Programmer Response: Refer to the
DSNJSLR macro. The user program must therefore appropriate MVS publication to determine the meaning
anticipate and react to a nonzero return code and a of the SVC 99 error code (S99ERROR) returned in
nonzero reason code, possibly by terminating the SLRFRG15, and SVC 99 information code (S99INFO)
execution of the user program. returned in SLRFINFO. Take the appropriate action to
correct the error, and resubmit the application job.
For additional details about the stand-alone log
services, including a sample of an application program
which reacts to nonzero return codes and nonzero 00D10040
reason codes, refer to Appendix C (Volume 2) of DB2
Explanation: The DB2 stand-alone log services GET
Administration Guide.
processing macro (DSNJSLR) issued this reason code.
System Programmer Response: On a FUNC=OPEN The GET processing has requested an RBA in an
call, the RBR value is returned in register 1. The archive log data set which was previously not opened.
application program must preserve this value for all An attempt is made to open the second file on the
subsequent stand-alone FUNC=GET and archive log tape (the first file normally contains the
FUNC=CLOSE calls. Due to an application program bootstrap data set, while the second is normally the
logic error in the program which invokes the stand-alone archive log data set). If this first attempt failed because
log services, the RBR value has been compromised. the archive log data set was not the second file on an
Repair the application program, and resubmit the archive tape, then the RDJFCB macro is used to
application job. change the data set sequence number from the default
value of 2 to a value of 1, before the OPEN is
attempted again. This reason code is generated when
00D10031
an error was returned from the RDJFCB macro.
Explanation: The DB2 stand-alone log services GET
This reason code is issued by the following CSECT:
processing macro (DSNJSLR) issued this reason code.
DSNJRS03
The GET processing has requested an RBA in a log
data set which was previously not opened. The user’s System Action: In response to the DSNJSLR
Job Control Language (JCL) has specified that the FUNC=GET call, DB2 places a return code of 12 in
bootstrap data set (BSDS) be used as the guide to register 15 and a reason code of 00D10040 in register
determining which log data sets are required. An 0. No abend is issued by the stand-alone log services
attempt to dynamically allocate the appropriate log data CSECT (DSNJRS01), and no information is written to
set (via MVS SVC 99) failed. SYS1.LOGREC data set.
This reason code is issued by the following CSECT: Information about the results of the GET request is also
DSNJRS05 returned in the stand-alone log GET Feedback Area
(SLRF). The RDJFCB error code is placed in
System Action: In response to the DSNJSLR
SLRFRG15. The ddname of the data set on which the
FUNC=GET call, DB2 places a return code of 12 in
activity occurred is placed in SLRFDDNM.
register 15 and a reason code of 00D10031 in register
0. No abend is issued by the stand-alone log services The stand-alone log services program is under the
CSECT (DSNJRS01), and no information is written to control of a user-written program that uses the
SYS1.LOGREC data set. DSNJSLR macro. The user program must therefore
anticipate and react to a nonzero return code and a
Information about the results of the GET request is also
nonzero reason code, possibly by terminating the
returned in the stand-alone log GET Feedback Area
execution of the user program.
(SLRF). The SVC 99 error code (S99ERROR) and
information code (S99INFO) are placed in the SLRFRC For additional details about the stand-alone log
and SLRFINFO fields, respectively. The ddname of the services, including a sample of an application program
data set on which the activity occurred is placed in which reacts to nonzero return codes and nonzero
SLRFDDNM. reason codes, refer to Appendix C (Volume 2) of DB2
Administration Guide.
The stand-alone log services program is under the
control of a user-written program that uses the System Programmer Response: Refer to the
DSNJSLR macro. The user program must therefore DFSMS/MVS: Using Advanced Services to determine
anticipate and react to a nonzero return code and a the meaning of the RDJFCB error code returned in
nonzero reason code, possibly by terminating the SLRFRG15. Take the appropriate action to correct the
execution of the user program. error, and resubmit the application job.
For additional details about the stand-alone log
814 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D10044 • 00D10061
DSNJSLR macro. The user program must therefore
00D10044
anticipate and react to a nonzero return code and a
Explanation: The DB2 stand-alone log services GET nonzero reason code, possibly by terminating the
processing macro (DSNJSLR) issued this reason code. execution of the user program.
The GET processing has requested an RBA in an
For additional details about the stand-alone log
archive log data set which was previously not opened.
services, including a sample of an application program
The attempt to open the archive log data set failed.
which reacts to nonzero return codes and nonzero
This reason code is issued by the following CSECT: reason codes, refer to Appendix C (Volume 2) of DB2
DSNJRS03 Administration Guide.
System Action: In response to the DSNJSLR System Programmer Response: Determine the
FUNC=GET call, DB2 places a return code of 12 in cause of the QSAM GET error, take the appropriate
register 15 and a reason code of 00D10044 in register action to correct the error, and resubmit the application
0. No abend is issued by the stand-alone log services job.
CSECT (DSNJRS01), and no information is written to
SYS1.LOGREC data set.
00D10050
Information about the results of the GET request is also
Explanation: The DB2 stand-alone log services GET
returned in the stand-alone log GET Feedback Area
processing macro (DSNJSLR) issued this reason code.
(SLRF). The ddname of the data set on which the
The bootstrap data set (BSDS) was erroneously
activity occurred is placed in SLRFDDNM.
specified as one of the ARCHIVE data sets in the user’s
The stand-alone log services program is under the Job Control Language (JCL). Consequently, the GET
control of a user-written program that uses the request failed.
DSNJSLR macro. The user program must therefore
This reason code is issued by the following CSECT:
anticipate and react to a nonzero return code and a
DSNJRS03
nonzero reason code, possibly by terminating the
execution of the user program. System Action: In response to the DSNJSLR
FUNC=GET call, DB2 places a return code of 8 in
For additional details about the stand-alone log
register 15 and a reason code of 00D10050 in register
services, including a sample of an application program
0. No abend is issued by the stand-alone log services
which reacts to nonzero return codes and nonzero
CSECT (DSNJRS01), and no information is written to
reason codes, If you suspect an error in DB2, refer to
SYS1.LOGREC data set.
Part 2 of DB2 Diagnosis Guide and Reference for
information on identifying and reporting the problem. Information about the results of the GET request is also
returned in the stand-alone log GET Feedback Area
System Programmer Response: Determine the
(SLRF). The RBA of the requested log record control
cause of the QSAM OPEN error, take the appropriate
interval is placed in SLRFRBA.
action to correct the error, and resubmit the application
job. The stand-alone log services program is under the
control of a user-written program that uses the
DSNJSLR macro. The user program must therefore
00D10048
anticipate and react to a nonzero return code and a
Explanation: The DB2 stand-alone log services GET nonzero reason code, possibly by terminating the
processing macro (DSNJSLR) issued this reason code. execution of the user program.
A QSAM GET error occurred while reading an archive
For additional details about the stand-alone log
log data set.
services, including a sample of an application program
This reason code is issued by the following CSECT: which reacts to nonzero return codes and nonzero
DSNJRS03 reason codes, refer to Appendix C (Volume 2) of DB2
Administration Guide.
System Action: In response to the DSNJSLR
FUNC=GET call, DB2 places a return code of 12 in System Programmer Response: Examine the user’s
register 15 and a reason code of 00D10048 in register JCL, and remove the occurrence of the BSDS data set
0. No abend is issued by the stand-alone log services as one of the concatenated ARCHIVE data sets.
CSECT (DSNJRS01), and no information is written to Resubmit the application job.
SYS1.LOGREC data set.
Information about the results of the GET request is also 00D10061
returned in the stand-alone log GET Feedback Area
Explanation: The DB2 stand-alone log services GET
(SLRF). The ddname of the data set on which the
processing macro (DSNJSLR) issued this reason code.
activity occurred is placed in SLRFDDNM.
The log record control interval (CI) requested by the
The stand-alone log services program is under the application program was read successfully from an
control of a user-written program that uses the active log data set or an archive log data set. However,
Chapter 38. DB2 Codes 815
00D10062 • 00D10063
the physical record length returned from reading the CI 0. No abend is issued by the stand-alone log services
is not the expected length. The GET function will CSECT (DSNJRS01), and no information is written to
complete, but will issue this reason code as a warning. SYS1.LOGREC data set. The GET function will
complete, but will issue this reason code as a warning.
The length of a log CI in an active log data set is
expected to be 4089 bytes. The length of a log CI in an Information about the results of the GET request is also
archive log data set is expected to be 4096 bytes. returned in the stand-alone log GET Feedback Area
(SLRF). The length and address of the requested record
This reason code is issued by the following CSECT:
are placed in fields SLRFRCLL and SLRFFRAD,
DSNJRS03
respectively. The RBA associated with the log record
System Action: In response to the DSNJSLR segment is placed in SLRFRBA. The ddname of the
FUNC=GET call, DB2 places a return code of 4 in data set on which the activity occurred is placed in
register 15 and a reason code of 00D10061 in register SLRFDDNM.
0. No abend is issued by the stand-alone log services
The stand-alone log services program is under the
CSECT (DSNJRS01), and no information is written to
control of a user-written program that uses the
SYS1.LOGREC data set. The GET function will
DSNJSLR macro. The user program must therefore
complete, but will issue this reason code as a warning.
anticipate and react to a nonzero return code and a
Information about the results of the GET request is also nonzero reason code, possibly by terminating the
returned in the stand-alone log GET Feedback Area execution of the user program.
(SLRF). The length and address of the CI are placed in
For additional details about the stand-alone log
fields SLRFRCLL and SLRFFRAD, respectively. The
services, including a sample of an application program
RBA associated with the CI is placed in SLRFRBA. The
which reacts to nonzero return codes and nonzero
'ddname' of the data set on which the activity occurred
reason codes, refer to Appendix C (Volume 2) of DB2
is placed in SLRFDDNM.
Administration Guide.
The stand-alone log services program is under the
System Programmer Response: Several possibilities
control of a user-written program that uses the
exist for the cause of this condition:
DSNJSLR macro. The user program must therefore
anticipate and react to a nonzero return code and a v The Recovery Log Manager component of DB2 did
nonzero reason code, possibly by terminating the not originally construct the LRH properly.
execution of the user program. v The log record header (LRH) for the log record
segment was damaged after it was written by the
For additional details about the stand-alone log
DB2 subsystem.
services, including a sample of an application program
which reacts to nonzero return codes and nonzero v The application program continued to process after
reason codes, refer to Appendix C (Volume 2) of DB2 receipt of a 00D10021 reason code (gap in the log).
Administration Guide.
If the error was caused by the application program,
System Programmer Response: The RDF/CIDF modifications to the application program may be
control information in the CI has been compromised. If required.
the SLRFRCLL field indicates a value greater than
expected, then the data within the CI can still be used If the error is a suspected DB2 problem, run the log
by the application program. If the SLRFRCLL field print (DSN1LOGP) utility, specifying a range of RBAs
indicates a value less than expected, then the data which would encompass the problem RBA. Determine if
within the CI in all likelihood can still be used, but with the LRH of the log record segment is truly in error by
caution (additional error checking routines may be looking at the record segments directly preceding and
required by the user program). after the record segment in question.
00D10062 00D10063
Explanation: The DB2 stand-alone log services GET Explanation: The DB2 stand-alone log services GET
processing macro (DSNJSLR) issued this reason code. processing macro (DSNJSLR) issued this reason code.
The requested record was found to be a middle The requested record was found to be a last spanned
spanned record segment, but a preceding first record record segment, but a preceding first record segment
segment does not exist. The GET function will does not exist. The GET function will complete, but will
complete, but will issue this reason code as a warning. issue this reason code as a warning.
This reason code is issued by the following CSECT: This reason code is issued by the following CSECT:
DSNJRS02 DSNJRS02
System Action: In response to the DSNJSLR System Action: In response to the DSNJSLR
FUNC=GET call, DB2 places a return code of 4 in FUNC=GET call, DB2 places a return code of 4 in
register 15 and a reason code of 00D10062 in register register 15 and a reason code of 00D10063 in register
816 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D10101 • 00D10103
0. No abend is issued by the stand-alone log services statement that has an RBA value known to the system
CSECT (DSNJRS01), and no information is written to in the BSDS, or that has the ENDRBA and STARTRBA
SYS1.LOGREC data set. The GET function will specifying the same RBA (cold start).
complete, but will issue this reason code as a warning.
Refer to Part 4 (Volume 1) of DB2 Administration Guide
Information about the results of the GET request is also for more information.
returned in the stand-alone log GET Feedback Area
(SLRF). The length and address of the requested record
00D10102
are placed in fields SLRFRCLL and SLRFFRAD,
respectively. The RBA associated with the log record Explanation: A request to disable data sharing failed.
segment is placed in SLRFRBA. The ddname of the
data set on which the activity occurred is placed in This abend reason code is issued by the following
SLRFDDNM. CSECT: DSNJS001
The stand-alone log services program is under the System Action: DB2 startup terminates.
control of a user-written program that uses the Operator Response: Collect an SVC dump, and
DSNJSLR macro. The user program must therefore contact the system programmer.
anticipate and react to a nonzero return code and a
nonzero reason code, possibly by terminating the System Programmer Response: Obtain the SVC
execution of the user program. dump for the return code. To disable data sharing, you
must run the disable data sharing job (DSNTIJGF) and
For additional details about the stand-alone log then restart DB2. For more information, see Chapter 2
services, including a sample of an application program of DB2 Data Sharing: Planning and Administration.
which reacts to nonzero return codes and nonzero
reason codes, refer to Appendix C (Volume 2) of DB2 Problem Determination: General register 2 contains a
Administration Guide. return code. Explanation of the return code is as
follows:
System Programmer Response: Several possibilities 2 A request to disable data sharing is in the
exist for the cause of this condition: BSDS, but a conditional restart record is not
v The Recovery Log Manager component of DB2 did present. You must use job DSNTIJGF for the
not originally construct the log record header (LRH) correct conditional restart control record.
properly. 4 A request to disable data sharing is recorded in
v The LRH for the log record segment was damaged the BSDS, but the conditional restart record is
after it was written by the DB2 subsystem. not correct. You cannot request a normal
conditional restart with a disable request. You
v The application program continued to process after must use job DSNTIJGF.
receipt of a 00D10021 reason code (gap in the log). 8 Update of the BSDS failed. Data sharing was
not disabled. See DB2 code 00D10411 for
If the error was caused by the application program, problem determination. After the BSDS
modifications to the application program may be problem is fixed, run DSNTIJGF to disable data
required. sharing, and then restart DB2.
10 A delete in the BSDS failed. Data sharing was
If the error is a suspected DB2 problem, run the log not disabled. See DB2 code 00D10413 for
print (DSN1LOGP) utility, specifying a range of RBAs problem determination. After the BSDS
which would encompass the problem RBA. Determine if problem is fixed, run DSNTIJGF to disable data
the LRH of the log record segment is truly in error by sharing, and then restart DB2.
looking at the record segments directly preceding and
after the record segment in question.
00D10103
00D10101 Explanation: DB2 failed to open the shared
communications area (SCA) structure.
Explanation: The ENDRBA value specified in the
control statement was either greater or less than any This abend reason code is issued by the following
known RBA, but cold start was not specified for the CSECT: DSNJS001
conditional restart. System Action: DB2 startup terminates.
This abend reason code is issued by the following Operator Response: Collect the SYS1.LOGREC and
CSECT: DSNJW306 SVC dump and contact the system programmer.
System Action: DB2 startup is terminated. System Programmer Response: Obtain the
Operator Response: Notify the system programmer. SYS1.LOGREC and SVC dump for analysis.
System Programmer Response: Run the change log Problem Determination: Review the DB2 system
inventory (DSNJU003) utility with a CRESTART control
Chapter 38. DB2 Codes 817
00D10104 • 00D10109
console for possible DSN7xxxx messages that could System Programmer Response: Obtain the
relate to this problem. SYS1.LOGREC and SVC dump for analysis.
Problem Determination: See DB2 code 00D10411 for
00D10104 problem determination.
Explanation: DB2 failed to find the data sharing
member record in the BSDS during DB2 startup. 00D10107
This abend reason code is issued by the following Explanation: DB2 failed to insert an internal control
CSECT: DSNJS001 record in the BSDS for data sharing re-enable.
System Action: DB2 startup terminates. This abend reason code is issued by the following
CSECT: DSNJS001
Operator Response: Collect the SYS1.LOGREC and
SVC dump and contact the system programmer. System Action: DB2 startup terminates.
System Programmer Response: Obtain the Operator Response: Collect the SYS1.LOGREC and
SYS1.LOGREC and SVC dump for analysis. SVC dump and contact the system programmer.
Problem Determination: If this is the first startup of a System Programmer Response: Obtain the
new member joining the data sharing group, run the SYS1.LOGREC and SVC dump for analysis.
DSNTIJUZ job created to enable data sharing for this
Problem Determination: See DB2 code 00D10412 for
DB2 subsystem, and then restart this DB2 subsystem.
problem determination.
Also, check whether the correct BSDS is specified in
the DB2 master startup procedure. See message
DSN7501A for additional problem determination. 00D10108
Explanation: DB2 failed to write an internal control
00D10105 record for re-enable in the shared communications area
(SCA) structure.
Explanation: DB2 found a mismatch in the shared
communications area (SCA) while a new member was This abend reason code is issued by the following
attempting to join a data sharing group. CSECT: DSNJS001
This abend reason code is issued by the following System Action: DB2 startup terminates.
CSECT: DSNJS001
Operator Response: Collect the SYS1.LOGREC and
System Action: DB2 startup terminates. SVC dump and contact the system programmer.
Operator Response: Collect the SYS1.LOGREC and System Programmer Response: Obtain the
SVC dump and contact the system programmer. SYS1.LOGREC and SVC dump for analysis.
System Programmer Response: Obtain the Problem Determination: See message DSN7501A for
SYS1.LOGREC and SVC dump for analysis. problem determination.
Problem Determination: This indicates that a new
member is attempting to join the data sharing group. If 00D10109
this a migration from DB2 3.1, then catalog migration
must be completed before a new member can join this Explanation: DB2 found a shared communications
data sharing group. Wait until catalog migration area (SCA) structure during the data sharing re-enable
completes, then restart this DB2 to join the group. process. This structure should not be built at this time.
Otherwise, group restart is required. Wait until group This abend reason code is issued by the following
restart completes, then restart this DB2 to join the CSECT: DSNJS001
group. For more information, see Chapter 2 of DB2
Data Sharing: Planning and Administration . System Action: DB2 startup terminates.
Operator Response: Collect the SYS1.LOGREC and
00D10106 SVC dump and contact the system programmer.
Explanation: DB2 failed to update an internal control System Programmer Response: Display the existing
record in the BSDS for data sharing. SCA structures on this MVS system.
This abend reason code is issued by the following Problem Determination: If an SCA structure already
CSECT: DSNJS001 exists for this DB2 data sharing group, use the MVS
command SETXCF to delete this structure, then restart
System Action: DB2 startup terminates. DB2 to complete the re-enable process.
Operator Response: Collect the SYS1.LOGREC and
SVC dump and contact the system programmer.
818 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D1010A • 00D10110
System Action: DB2 startup terminates.
00D1010A
Operator Response: Collect the SYS1.LOGREC and
Explanation: DB2 failed to write a record for re-enable
SVC dump and contact the system programmer.
in the shared communications area (SCA) structure.
System Programmer Response: Obtain the
This abend reason code is issued by the following
SYS1.LOGREC and SVC dump for analysis.
CSECT: DSNJS001
Problem Determination: Check to be sure that this
System Action: DB2 startup terminates.
DB2 system is supposed to be part of a data sharing
Operator Response: Collect the SYS1.LOGREC and group. If this DB2 is in a group, you can restart another
SVC dump and contact the system programmer. DB2 subsystem that is in the same DB2 data sharing
group first, and then restart. If no other DB2 subsystems
System Programmer Response: Obtain the
exist in this group, you must recover the BSDS before
SYS1.LOGREC and SVC dump for analysis.
restarting.
Problem Determination: Review the DB2 system
console for possible DSN7xxxx messages that could
00D1010E
relate to this problem.
Explanation: DB2 failed to write an internal control
record for a data sharing restart in the shared
00D1010B
communications area (SCA) structure.
Explanation: DB2 failed to update an internal control
This abend reason code is issued by the following
record in the BSDS to enable data sharing.
CSECT: DSNJS001
This abend reason code is issued by the following
System Action: DB2 startup terminates.
CSECT: DSNJS001
Operator Response: Collect the SYS1.LOGREC and
System Action: DB2 startup terminates.
SVC dump and contact the system programmer.
Operator Response: Collect the SYS1.LOGREC and
System Programmer Response: Obtain the
SVC dump and contact the system programmer.
SYS1.LOGREC and SVC dump for analysis.
System Programmer Response: Obtain the
Problem Determination: Review the DB2 system
SYS1.LOGREC and SVC dump for analysis.
console for possible DSN7xxxx messages that could
Problem Determination: See DB2 Code 00D10411 relate to this problem.
for problem determination.
00D1010F
00D1010C
Explanation: DB2 failed an attempt to change the
Explanation: DB2 failed to write an internal control generic LU or location name in the shared
record in the shared communications area (SCA) to communications area (SCA) structure for the data
enable data sharing. sharing group.
This abend reason code is issued by the following This abend reason code is issued by the following
CSECT: DSNJS001 CSECT: DSNJS001
System Action: DB2 startup terminates. System Action: DB2 startup terminates.
Operator Response: Collect the SYS1.LOGREC and Operator Response: Collect the SYS1.LOGREC and
SVC dump and contact the system programmer. SVC dump and contact the system programmer.
System Programmer Response: Obtain the System Programmer Response: Obtain the
SYS1.LOGREC and SVC dump for analysis. SYS1.LOGREC and SVC dump for analysis. All
members in the data sharing group must first be
Problem Determination: Review the DB2 system stopped, then this DB2 subsystem can be restarted to
console for possible DSN7xxxx messages that could make this change.
relate to this problem.
Problem Determination:
00D1010D
00D10110
Explanation: DB2 could not find an internal control
record for data sharing in the BSDS or the shared Explanation: DB2 failed to write an internal control
communications area (SCA). record for a generic LU or location name change in the
shared communications area (SCA) structure.
This abend reason code is issued by the following
CSECT: DSNJS001
Chapter 38. DB2 Codes 819
00D10111 • 00D10116
This abend reason code is issued by the following
00D10113
CSECT: DSNJS001
Explanation: DB2 failed to update a data sharing
System Action: DB2 startup terminates.
member’s information record in the BSDS to enable
Operator Response: Collect the SYS1.LOGREC and data sharing.
SVC dump and contact the system programmer.
This abend reason code is issued by the following
System Programmer Response: Obtain the CSECT: DSNJS001
SYS1.LOGREC and SVC dump for analysis.
System Action: DB2 startup terminates.
Problem Determination: DB2 failed in a write to the
Operator Response: Collect the SYS1.LOGREC and
SCA structure for a data sharing restart change. Review
SVC dump and contact the system programmer.
the DB2 system console for possible DSN7xxxx
messages that could relate to this problem. System Programmer Response: Obtain the
SYS1.LOGREC and SVC dump for analysis.
00D10111 Problem Determination: See DB2 Code 00D10411
for problem determination.
Explanation: DB2 failed to find an internal record in
the shared communications area (SCA) that is needed
to re-enable data sharing. 00D10114
This abend reason code is issued by the following Explanation: DB2 failed to write a data sharing
CSECT: DSNJS001 member information record in the shared
communications area (SCA) for a restart of data
System Action: DB2 startup terminates.
sharing.
Operator Response: Collect the SYS1.LOGREC and
This abend reason code is issued by the following
SVC dump and contact the system programmer.
CSECT: DSNJS001
System Programmer Response: Obtain the
System Action: DB2 startup terminates.
SYS1.LOGREC and SVC dump for analysis. To
re-enable data sharing, you must start the surviving Operator Response: Collect the SYS1.LOGREC and
DB2 member first before other members can be started. SVC dump and contact the system programmer.
If this is meant to be a re-enable attempt, check
System Programmer Response: Obtain the
whether the surviving member was started first. If this
SYS1.LOGREC and SVC dump for analysis.
re-enable is already complete, check that this is the
correct data sharing group. Problem Determination: Review the DB2 system
console for possible DSN7xxxx messages that could
Another possibility is that the SCA is damaged. Use the
relate to this problem.
MVS command SETXCF to rebuild the SCA.
00D10115
00D10112
Explanation: DB2 failed to update the data sharing
Explanation: DB2 failed to update an internal control
record in the BSDS to reset the enable flag.
record in the BSDS for a generic LU or location name
change. This abend reason code is issued by the following
CSECT: DSNJS001
This abend reason code is issued by the following
CSECT: DSNJS001 System Action: DB2 startup terminates.
System Action: DB2 startup terminates. Operator Response: Collect the SYS1.LOGREC and
SVC dump and contact the system programmer.
Operator Response: Collect the SYS1.LOGREC and
SVC dump and contact the system programmer. System Programmer Response: Obtain the
SYS1.LOGREC and SVC dump for analysis.
System Programmer Response: Obtain the
SYS1.LOGREC and SVC dump for analysis. Problem Determination: See DB2 code 00D10411 for
problem determination.
Problem Determination: DB2 failed in an update to
the BSDS for a data sharing generic LU or location
name change. See DB2 Code 00D10411 for problem 00D10116
determination.
Explanation: DB2 failed to update an internal control
record in the BSDS for non-data sharing migration or
fallback with DB2.
820 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D10117 • 00D10221
This abend reason code is issued by the following
00D10219
CSECT: DSNJS001
Explanation: DB2 found that the current LRSN is less
System Action: DB2 startup terminates.
than the prior LRSN after calculating a delta for the
Operator Response: Collect the SYS1.LOGREC and current LRSN.
SVC dump and contact the system programmer.
System Action: DB2 terminates.
System Programmer Response: Obtain the
Operator Response: Collect the SYS1.LOGREC and
SYS1.LOGREC and SVC dump for analysis.
SVC dump and contact the system programmer.
Problem Determination: See DB2 Code 00D10411
System Programmer Response: Obtain the
for problem determination.
SYS1.LOGREC and SVC dump for analysis.
Problem Determination: This indicates that the
00D10117
system time is now less than the time recorded earlier
Explanation: DB2 failed to truncate and switch to a in the DB2 log data set. Check that this DB2 subsystem
new log for data sharing re-enable. is using the correct BSDS and log data sets. Also check
that the correct system time is being used.
This abend reason code is issued by the following
CSECT: DSNJS001 If you suspect an error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on
System Action: DB2 startup terminates. identifying and reporting the problem.
Operator Response: Collect the SYS1.LOGREC and
SVC dump and contact the system programmer. 00D10220
System Programmer Response: Obtain the Explanation: An unsuccessful completion of a LOG
SYS1.LOGREC and SVC dump for analysis. WRITE has occurred. An invalid write cursor ID was
Problem Determination: Determine why DB2 failed to supplied.
truncate and switch to a new log. DB2 might be using This abend reason code is issued by the following
the last log. If so, determine why off-load has not CSECT: DSNJW001
occurred. See DB2 messages DSNJ319I and DSNJ320I
for problem determination. System Action: An execution unit writes a record to
SYS1.LOGREC and requests an SVC dump. The
execution unit then terminates abnormally.
00D10210
Operator Response: Collect the SYS1.LOGREC and
Explanation: An unsuccessful completion of a SET SVC dump. Notify the system programmer.
WRITE CURSOR has occurred. An invalid write cursor
ID was supplied. System Programmer Response: Obtain the
SYS1.LOGREC and the SVC dump. If you suspect an
This abend reason code is issued by the following error in DB2, refer to Part 2 of DB2 Diagnosis Guide
CSECT: DSNJW002 and Reference for information on identifying and
System Action: An execution unit writes a record to reporting the problem.
SYS1.LOGREC and requests an SVC dump. The Problem Determination: RLM standard diagnostic
execution unit then terminates abnormally. information is provided in “Chapter 38. X’D1......’ Codes”
Operator Response: Collect the SYS1.LOGREC and on page 805.
SVC dump. Notify the system programmer. Collect the following diagnostic items listed in
System Programmer Response: Obtain the “Appendix B. Problem determination” on page 1281: 2,
SYS1.LOGREC and the SVC dump. If you suspect an 5, 16.
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and 00D10221
reporting the problem.
Explanation: An unsuccessful completion of a LOG
Problem Determination: RLM standard diagnostic WRITE has occurred. An invalid number of areas was
information is provided in “Chapter 38. X’D1......’ Codes” specified.
on page 805.
This abend reason code is issued by the following
Collect the following diagnostic items listed in CSECT: DSNJW001
“Appendix B. Problem determination” on page 1281: 2,
5, 16. System Action: An execution unit writes a record to
SYS1.LOGREC and requests an SVC dump. The
execution unit then terminates abnormally.
Chapter 38. DB2 Codes 821
00D10222 • 00D10232
Operator Response: Collect the SYS1.LOGREC and
00D10230
SVC dump. Notify the system programmer.
Explanation: A CHECK LOG was issued and the log
System Programmer Response: Obtain the
RBA specified in the macro had not been written to
SYS1.LOGREC and the SVC dump. If you suspect an
DASD at the time.
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and This abend reason code is issued by the following
reporting the problem. CSECT: DSNJW004
Problem Determination: RLM standard diagnostic System Action: An execution unit writes a record to
information is provided in “Chapter 38. X’D1......’ Codes” SYS1.LOGREC and requests an SVC dump. The
on page 805. execution unit then terminates abnormally.
Collect the following diagnostic items listed in Problem Determination: RLM standard diagnostic
“Appendix B. Problem determination” on page 1281: 2, information is provided in “Chapter 38. X’D1......’ Codes”
5, 16. on page 805.
Collect the following diagnostic items listed in
00D10222 “Appendix B. Problem determination” on page 1281: 2,
5, 16.
Explanation: An unsuccessful completion of a LOG
WRITE has occurred. The record length specified was
greater than 32767. 00D10231
This abend reason code is issued by the following Explanation: An unsuccessful completion of a CHECK
CSECT: DSNJW001 LOG has occurred. The specified RBA is beyond the
end of the log.
System Action: An execution unit writes a record
SYS1.LOGREC and requests an SVC dump. The This abend reason code is issued by the following
execution unit then terminates abnormally. CSECT: DSNJW004
Operator Response: Collect the SYS1.LOGREC and System Action: An execution unit writes a record to
SVC dump. Notify the system programmer. SYS1.LOGREC and requests an SVC dump. The
execution unit then terminates abnormally.
System Programmer Response: Obtain the
SYS1.LOGREC and the SVC dump. If you suspect an Operator Response: Collect the SYS1.LOGREC and
error in DB2, refer to Part 2 of DB2 Diagnosis Guide SVC dump. Notify the system programmer.
and Reference for information on identifying and
System Programmer Response: Obtain the
reporting the problem.
SYS1.LOGREC and the SVC dump. If you suspect an
Problem Determination: RLM standard diagnostic error in DB2, refer to Part 2 of DB2 Diagnosis Guide
information is provided in “Chapter 38. X’D1......’ Codes” and Reference for information on identifying and
on page 805. reporting the problem.
Collect the following diagnostic items listed in Problem Determination: RLM standard diagnostic
“Appendix B. Problem determination” on page 1281: 2, information is provided in “Chapter 38. X’D1......’ Codes”
5, 16. on page 805.
Collect the following diagnostic items listed in
00D10223 “Appendix B. Problem determination” on page 1281: 2,
5, 16.
Explanation: There was an attempt to modify a log
data set while doing a conditional restart with
CSRONLY specified. 00D10232
This abend reason code is issued by the following Explanation: A request was made to force an LRSN
CSECTs: DSNJB001, DSNJW001 in non-data sharing mode.
System Action: DB2 startup terminates. System Action: DB2 issues an SVC dump and
returns an error to the requesting function.
Operator Response: Notify the system programmer.
Operator Response: Collect the SYS1.LOGREC and
System Programmer Response: If a complete DB2
SVC dump and contact the system programmer.
startup is desired, remove CSRONLY from the control
statement. Restart DB2. System Programmer Response: Obtain the
SYS1.LOGREC and SVC dump for analysis.
Problem Determination: The requesting function can
be determined from the SVC dump. It has requested a
822 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D10240 • 00D10252
data sharing log manager function in non-data sharing. was a BSDS error or an MVS catalog update error.
If you suspect an error in DB2, refer to Part 2 of DB2 Collect the following diagnostic items listed in
Diagnosis Guide and Reference for information on “Appendix B. Problem determination” on page 1281: 1,
identifying and reporting the problem. 2, 5, 16.
00D10240 00D10251
Explanation: An unsuccessful completion of a CLOSE Explanation: An unrecoverable error occurred in the
LOG FOR WRITE has occurred. An invalid write cursor log buffer writer.
ID was supplied.
This abend reason code is issued by the following
This abend reason code is issued by the following CSECT: DSNJW008
CSECT: DSNJW002
System Action: An execution unit writes a record to
System Action: An execution unit writes a record to SYS1.LOGREC and requests an SVC dump. DB2 then
SYS1.LOGREC and requests an SVC dump. The terminates abnormally.
execution unit then terminates abnormally.
Operator Response: Collect the SYS1.LOGREC and
Operator Response: Collect the SYS1.LOGREC and SVC dump. Notify the system programmer.
SVC dump. Notify the system programmer.
System Programmer Response: Obtain the
System Programmer Response: Obtain the SYS1.LOGREC and the SVC dump.
SYS1.LOGREC and the SVC dump. If you suspect an
This error is usually caused by a previous error that was
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
recorded on SYS1.LOGREC and produced an SVC
and Reference for information on identifying and
dump. The SYS1.LOGREC entries and SVC dump
reporting the problem.
should be examined to determine the primary error that
Problem Determination: RLM standard diagnostic occurred.
information is provided in “Chapter 38. X’D1......’ Codes”
Problem Determination: RLM standard diagnostic
on page 805.
information is provided in “Chapter 38. X’D1......’ Codes”
Collect the following diagnostic items listed in on page 805. In addition, see abend reason code
“Appendix B. Problem determination” on page 1281: 2, '00D10252' for a description of the information recorded
5, 16. in the variable recording area (VRA) of the SDWA. If
you suspect an error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on
00D10250
identifying and reporting the problem.
Explanation: An unrecoverable error occurred while
Collect the following diagnostic items listed in
updating either the BSDS or the MVS catalog to reflect
“Appendix B. Problem determination” on page 1281: 1,
changes in active log data sets.
2, 5, 16.
This abend reason code is issued by the following
CSECT: DSNJW307
00D10252
System Action: An execution unit writes a record to
Explanation: This abend reason code is used to
SYS1.LOGREC and requests an SVC dump. DB2 then
define the format of the information recorded in the
terminates abnormally.
variable recording area (VRA) of the SDWA.
Operator Response: Collect the SYS1.LOGREC and
This abend reason code is issued by the following
SVC dump. Notify the system programmer.
CSECT: DSNJW008
System Programmer Response: Obtain the
System Action: An execution unit writes a record to
SYS1.LOGREC and SVC dump. Correct the error, and
SYS1.LOGREC and requests an SVC dump.
restart DB2.
Operator Response: Collect the SYS1.LOGREC and
Problem Determination: RLM standard diagnostic
SVC dump. Notify the system programmer.
information is provided in “Chapter 38. X’D1......’ Codes”
on page 805. In addition, see abend reason code System Programmer Response: Obtain the
'00D10252' for a description of the information recorded SYS1.LOGREC and SVC dump.
in the variable recording area (VRA) of the SDWA. If
Problem Determination: RLM standard diagnostic
you suspect an error in DB2, refer to Part 2 of DB2
information is provided in “Chapter 38. X’D1......’ Codes”
Diagnosis Guide and Reference for information on
on page 805. In addition, the following information is
identifying and reporting the problem.
contained in the variable recording area (VRA) of the
Examine the console log for a DSNJxxxx message SDWA:
preceding this abend to determine whether the error v Reason code '00D10252' stored with key=VRARC.
Chapter 38. DB2 Codes 823
00D10253 • 00D10256
v The log buffer writer recovery tracking area is stored key, or the address may be the cause of the problem.
with key=VRARRP. These fields in the VRA are The failing instruction has a DB opcode and indicates
described by the system mapping macro IHAVRA. the registers showing address and length to be moved.
Problem Determination: RLM standard diagnostic
If you suspect an error in DB2, refer to Part 2 of DB2
information is provided in “Chapter 38. X’D1......’ Codes”
Diagnosis Guide and Reference for information on
on page 805.
identifying and reporting the problem.
Collect the following diagnostic items listed in
Collect the following diagnostic items listed in “Appendix B. Problem determination” on page 1281: 5,
“Appendix B. Problem determination” on page 1281: 2, 16.
5.
00D10255
00D10253
Explanation: DSNJR008 attempted to resume the
Explanation: An application program check occurred waiting execution unit, and a failure occurred leaving the
in an MVCP instruction that attempted to move a state of the resume indoubt.
parameter list or other data from the caller’s address
This abend reason code is issued by the following
space to the recovery log manager address space.
CSECTs: DSNJRE08, DSNJW206
This abend reason code is issued by the following
System Action: An execution unit writes a record to
CSECTs:
SYS1.LOGREC and requests an SVC dump. The DB2
DSNJR001 DSNJW001 DSNJW002 subsystem then terminates to avoid leaving the
execution unit in a state of indefinite suspension.
System Action: An execution unit writes a record to Operator Response: Collect the SYS1.LOGREC and
SYS1.LOGREC and requests an SVC dump. SVC dump. Notify the system programmer.
Operator Response: Collect the SYS1.LOGREC and System Programmer Response: If you suspect an
SVC dump. Notify the system programmer. error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and
System Programmer Response: Obtain the reporting the problem.
SYS1.LOGREC and SVC dump. Examine the area from
which data was to be moved. It may be in the wrong Problem Determination: RLM standard diagnostic
key, or the address may be the cause of the problem. information is provided in “Chapter 38. X’D1......’ Codes”
The failing instruction has a DA opcode and indicates on page 805. In addition, register 6 has the address of
the registers showing address and length to be moved. the execution block (EB).
Problem Determination: RLM standard diagnostic Collect the following diagnostic items listed in
information is provided in “Chapter 38. X’D1......’ Codes” “Appendix B. Problem determination” on page 1281: 5,
on page 805. 16.
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 5, 00D10256
16. Explanation: Recursive abends were detected while
trying to reinitialize an archive log read service task.
00D10254 This abend reason code is issued by the following
Explanation: An application program check occurred CSECTs: DSNJR008 DSNJR206 DSNJR208
in an MVCS instruction that attempted to move data System Action: An execution unit writes a record to
from the recovery log manager address space to the SYS1.LOGREC and requests an SVC dump. The DB2
caller’s address space. subsystem then terminates to avoid leaving an
This abend reason code is issued by the following execution unit in a state of indefinite suspension.
CSECT: DSNJR103 Operator Response: Collect the SYS1.LOGREC,
System Action: An execution unit writes a record to SVC dump, and console output. Notify the system
SYS1.LOGREC and requests an SVC dump. programmer.
Operator Response: Collect the SYS1.LOGREC and System Programmer Response: Obtain the
SVC dump. Notify the system programmer. SYS1.LOGREC, the SVC dump, and a listing of the
BSDS by running the print log map (DSNJU004) utility.
System Programmer Response: Obtain the If you suspect an error in DB2, refer to Part 2 of DB2
SYS1.LOGREC and SVC dump. Examine the area to Diagnosis Guide and Reference for information on
which data was to be moved. It may be in the wrong identifying and reporting the problem.
824 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D10261 • 00D10262
Problem Determination: RLM standard diagnostic For additional details about the stand-alone log
information is provided in “Chapter 38. X’D1......’ Codes” services, refer to Appendix C (Volume 2) of DB2
on page 805 . Administration Guide.
Collect the following diagnostic items listed in Operator Response: If the reason code is issued by
“Appendix B. Problem determination” on page 1281: 1, an active DB2 subsystem, collect the SYS1.LOGREC
2, 5, 16, 32. and SVC dump, and notify the system programmer.
System Programmer Response: If the reason code
00D10261 is issued by an active DB2 subsystem, obtain the
SYS1.LOGREC and the SVC dump from the operator.
Explanation: While scanning the records and record
segments in a log control interval (CI), it was discovered Collect the following diagnostic items listed in
that the forward record chain was broken. This condition “Appendix B. Problem determination” on page 1281: 2,
is the result of an incorrect record length in the log 5, 16.
record header of some record in the log CI.
Problem Determination: If the reason code is issued
This reason code is issued by the following CSECTs: by an active DB2 subsystem:
v RLM standard diagnostic information is provided
DSNJOFF1 DSNJRS01 DSNJR005 DSNJW009
under “Chapter 38. X’D1......’ Codes” on page 805.
DSNJW107
v Refer to Part 4 (Volume 1) of DB2 Administration
Guide for information about recovery from log
System Action: This reason code can be issued by failures.
an active DB2 subsystem as the log buffers are
v Refer to Appendix C (Volume 2) of DB2
scanned before they are written to the active log, or by
Administration Guide for failure analysis procedures,
the DB2 stand-alone log services GET processing
with particular emphasis on the use of the DB2
macro (DSNJSLR) as a CI is retrieved from a
stand-alone log services.
user-specified active or archive log data set.
v Obtain a DSN1LOGP detail report containing the log
If the reason code is issued by an active DB2 record(s) associated with the failure.
subsystem, then an abend is issued. A diagnostic
record is written to SYS1.LOGREC, and an SVC dump If the reason code is issued upon return of an
is requested. invocation of the DB2 stand-alone log services macro
v If the error was detected by DSNJOFF1, then the (DSNJSLR), then an additional user-written exit or
archiving of the active log data set is terminated and diagnostic routine may have to be written.
the faulty active log data set is marked 'stopped'.
v If the error was detected by DSNJR005, then 00D10262
message DSNJ012I is issued and the calling agent is
terminated. Explanation: While scanning a log control interval
(CI), the offset to the last record or record segment in
v If the error was detected by DSNJW009, then
the CI was found to be incorrect.
message DSNJ012I is issued and the DB2
subsystem is terminated. This reason code is issued by the following CSECTs:
v If the error was detected by DSNJW107, then the
DB2 subsystem is terminated. DSNJOFF1 DSNJRS01 DSNJR005 DSNJW009
DSNJW107
If this reason code is issued as the result of DB2
stand-alone log services GET processing, no abend is System Action: This reason code can be issued by
issued by the stand-alone log services CSECT an active DB2 subsystem as the log buffers are
(DSNJRS01), and no information is written to scanned before they are written to the active log, or by
SYS1.LOGREC data set. Rather, in response to the the DB2 stand-alone log services GET processing
DSNJSLR FUNC=GET call, DB2 places a return code macro (DSNJSLR) as a CI is retrieved from a
of 4 in register 15 and a reason code of 00D10261 in user-specified active or archive log data set.
register 0. Information about the results of the GET
request is also returned in the stand-alone log GET If the reason code is issued by an active DB2
feedback area (SLRF). The RBA of the record in error is subsystem, then an abend is issued. A diagnostic
placed in SLRFRBA. The address and length of the CI record is written to SYS1.LOGREC, and an SVC dump
which contains the errant log record header are placed is requested.
in SLRFFRAD and SLRFRCLL, respectively. The v If the error was detected by DSNJOFF1, then the
ddname of the data set on which the activity occurred is archiving of the active log data set is terminated and
placed in SLRFDDNM. the faulty active log data set is marked 'stopped'.
Chapter 38. DB2 Codes 825
00D10263
v If the error was detected by DSNJR005, then
00D10263
message DSNJ012I is issued and the calling agent is
terminated. Explanation: While scanning a log control interval
v If the error was detected by DSNJW009, then (CI), the VSAM RDF/CIDF control information was
message DSNJ012I is issued and the DB2 found to be incorrect.
subsystem is terminated. This reason code is issued by the following CSECTs:
v If the error was detected by DSNJW107, then the
DB2 subsystem is terminated. DSNJOFF1 DSNJRS01 DSNJR005 DSNJW009
DSNJW107
If this reason code is issued as the result of DB2
stand-alone log services GET processing, no abend is System Action: This reason code can be issued by
issued by the stand-alone log services CSECT an active DB2 subsystem as the log buffers are
(DSNJRS01), and no information is written to scanned before they are written to the active log, or by
SYS1.LOGREC data set. Rather, in response to the the DB2 stand-alone log services GET processing
DSNJSLR FUNC=GET call, DB2 places a return code macro (DSNJSLR) as a CI is retrieved from a
of 4 in register 15 and a reason code of 00D10262 in user-specified active or archive log data set.
register 0. Information about the results of the GET
request is also returned in the stand-alone log GET If the reason code is issued by an active DB2
Feedback Area (SLRF). The RBA of the beginning of subsystem, then an abend is issued. A diagnostic
the CI is placed in SLRFRBA. The address and length record is written to SYS1.LOGREC, and an SVC dump
of the CI are placed in SLRFFRAD and SLRFRCLL, is requested.
respectively. The ddname of the data set on which the v If the error was detected by DSNJOFF1, then the
activity occurred is placed in SLRFDDNM. archiving of the active log data set is terminated and
the faulty active log data set is marked 'stopped'.
For additional details about the stand-alone log v If the error was detected by DSNJR005, then
services, refer to Appendix C (Volume 2) of DB2 message DSNJ012I is issued and the calling agent is
Administration Guide. terminated.
Operator Response: If the reason code is issued by v If the error was detected by DSNJW009, then
an active DB2 subsystem, collect the SYS1.LOGREC message DSNJ012I is issued and the DB2
and SVC dump, and notify the system programmer. subsystem is terminated.
System Programmer Response: If the reason code v If the error was detected by DSNJW107, then the
is issued by an active DB2 subsystem, obtain the DB2 subsystem is terminated.
SYS1.LOGREC and the SVC dump from the operator.
If this reason code is issued as the result of DB2
Collect the following diagnostic items listed in stand-alone log services GET processing, no abend is
“Appendix B. Problem determination” on page 1281: 2, issued by the stand-alone log services CSECT
5, 16. (DSNJRS01), and no information is written to
Problem Determination: If the reason code is issued SYS1.LOGREC data set. Rather, in response to the
by an active DB2 subsystem: DSNJSLR FUNC=GET call, DB2 places a return code
of 4 in register 15 and a reason code of 00D10263 in
v RLM standard diagnostic information is provided
register 0. Information about the results of the GET
under “Chapter 38. X’D1......’ Codes” on page 805.
request is also returned in the stand-alone log GET
v Refer to Part 4 (Volume 1) of DB2 Administration Feedback Area (SLRF). The RBA of the beginning of
Guide for information about recovery from log the CI is placed in SLRFRBA. The address and length
failures. of the CI are placed in SLRFFRAD and SLRFRCLL,
v Refer to Appendix C (Volume 2) of DB2 respectively. The ddname of the data set on which the
Administration Guide for failure analysis procedures, activity occurred is placed in SLRFDDNM.
with particular emphasis on the use of the DB2
stand-alone log Services. For additional details about the stand-alone log
v Obtain a DSN1LOGP detail report containing the log services, refer to Appendix C (Volume 2) of DB2
record(s) associated with the failure. Administration Guide.
Operator Response: If the reason code is issued by
If the reason code is issued upon return of an an active DB2 subsystem, collect the SYS1.LOGREC
invocation of the DB2 stand-alone log services macro and SVC dump, and notify the system programmer.
(DSNJSLR), then an additional user-written exit or
diagnostic routine may have to be written. System Programmer Response: If the reason code
is issued by an active DB2 subsystem, obtain the
SYS1.LOGREC and the SVC dump from the operator.
Collect the following diagnostic items listed in
826 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D10264 • 00D10265
“Appendix B. Problem determination” on page 1281: 2, SYS1.LOGREC data set. Rather, in response to the
5, 16. DSNJSLR FUNC=GET call, DB2 places a return code
of 4 in register 15 and a reason code of 00D10264 in
Problem Determination: If the reason code is issued
register 0. Information about the results of the GET
by an active DB2 subsystem:
request is also returned in the stand-alone log GET
v RLM standard diagnostic information is provided Feedback Area (SLRF). The expected RBA of the
under “Chapter 38. X’D1......’ Codes” on page 805. beginning of the CI is placed in SLRFRBA. The address
v Refer to Part 4 (Volume 1) of DB2 Administration and length of the CI are placed in SLRFFRAD and
Guide for information about recovery from log SLRFRCLL, respectively. The ddname of the data set
failures. on which the activity occurred is placed in SLRFDDNM.
v Refer to Appendix C (Volume 2) of DB2
Administration Guide for failure analysis procedures, For additional details about the stand-alone log
with particular emphasis on the use of the DB2 services, refer to Appendix C (Volume 2) of DB2
stand-alone log Services. Administration Guide.
v Obtain a DSN1LOGP detail report containing the log Operator Response: If the reason code is issued by
record(s) associated with the failure. an active DB2 subsystem, collect the SYS1.LOGREC
and SVC dump, and notify the system programmer.
If the reason code is issued upon return of an
System Programmer Response: If the reason code
invocation of the DB2 stand-alone log services macro
is issued by an active DB2 subsystem, obtain the
(DSNJSLR), then an additional user-written exit or
SYS1.LOGREC and the SVC dump from the operator.
diagnostic routine may have to be written.
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 2,
00D10264
5, 16.
Explanation: While scanning a log control interval
Problem Determination: If the reason code is issued
(CI), the beginning log RBA of the CI was not the
by an active DB2 subsystem:
expected RBA.
v RLM standard diagnostic information is provided
This reason code is issued by the following CSECTs: under “Chapter 38. X’D1......’ Codes” on page 805.
DSNJOFF1 DSNJRS01 DSNJR005 DSNJW009 v Refer to Part 4 (Volume 1) of DB2 Administration
DSNJW107 Guide for information about recovery from log
failures.
v Refer to Appendix C (Volume 2) of DB2
System Action: This reason code can be issued by Administration Guide for failure analysis procedures,
an active DB2 subsystem as the log buffers are with particular emphasis on the use of the DB2
scanned before they are written to the active log, or by stand-alone log Services.
the DB2 stand-alone log services GET processing
macro (DSNJSLR) as a CI is retrieved from a v Obtain a DSN1LOGP detail report containing the log
user-specified active or archive log data set. record(s) associated with the failure.
If the reason code is issued by an active DB2 If the reason code is issued upon return of an
subsystem, then an abend is issued. A diagnostic invocation of the DB2 stand-alone log services macro
record is written to SYS1.LOGREC, and an SVC dump (DSNJSLR), then an additional user-written exit or
is requested. diagnostic routine may have to be written.
v If the error was detected by DSNJOFF1, then the
archiving of the active log data set is terminated and
00D10265
the faulty active log data set is marked 'stopped'.
v If the error was detected by DSNJR005, then Explanation: While scanning the records and record
message DSNJ012I is issued and the calling agent is segments in a log control interval (CI), it was discovered
terminated. the backward record chain was broken. This condition is
the result of an incorrect record length in the log record
v If the error was detected by DSNJW009, then
header of some record in the log CI.
message DSNJ012I is issued and the DB2
subsystem is terminated. This reason code is issued by the following CSECTs:
v If the error was detected by DSNJW107, then the
DSNJOFF1 DSNJRS01 DSNJR005 DSNJW009
DB2 subsystem is terminated.
DSNJW107
If this reason code is issued as the result of DB2
stand-alone log services GET processing, no abend is System Action: This reason code can be issued by
issued by the stand-alone log services CSECT an active DB2 subsystem as the log buffers are
(DSNJRS01), and no information is written to scanned before they are written to the active log, or by
Chapter 38. DB2 Codes 827
00D10266
the DB2 stand-alone log services GET processing v Obtain a DSN1LOGP detail report containing the log
macro (DSNJSLR) as a CI is retrieved from a record(s) associated with the failure.
user-specified active or archive log data set.
If the reason code is issued upon return of an
If the reason code is issued by an active DB2
invocation of the DB2 stand-alone log services macro
subsystem, then an abend is issued. A diagnostic
(DSNJSLR), then an additional user-written exit or
record is written to SYS1.LOGREC, and an SVC dump
diagnostic routine may have to be written.
is requested.
v If the error was detected by DSNJOFF1, then the
archiving of the active log data set is terminated. 00D10266
v If the error was detected by DSNJR005, then Explanation: While scanning a log control interval
message DSNJ012I is issued and the calling agent is (CI), a unit of recovery ID or LINK RBA in some record
terminated. was found to be inconsistent with the beginning log
v If the error was detected by DSNJW009, then RBA of the CI.
message DSNJ012I is issued and the DB2 This reason code is issued by the following CSECTs:
subsystem is terminated.
v If the error was detected by DSNJW107, then the DSNJOFF1 DSNJRS01 DSNJR005 DSNJW009
DB2 subsystem is terminated. DSNJW107
If this reason code is issued as the result of DB2 System Action: This reason code can be issued by
stand-alone log services GET processing, no abend is an active DB2 subsystem as the log buffers are
issued by the stand-alone log services CSECT scanned before they are written to the active log, or by
(DSNJRS01), and no information is written to the DB2 stand-alone log services GET processing
SYS1.LOGREC data set. Rather, in response to the macro (DSNJSLR) as a CI is retrieved from a
DSNJSLR FUNC=GET call, DB2 places a return code user-specified active or archive log data set.
of 4 in register 15 and a reason code of 00D10265 in
register 0. Information about the results of the GET If the reason code is issued by an active DB2
request is also returned in the stand-alone log GET subsystem, then an abend is issued. A diagnostic
Feedback Area (SLRF). The RBA of the record in error record is written to SYS1.LOGREC, and an SVC dump
is placed in SLRFRBA. The address and length of the is requested.
CI are placed in SLRFFRAD and SLRFRCLL, v If the error was detected by DSNJOFF1, then the
respectively. The ddname of the data set on which the archiving of the active log data set is terminated and
activity occurred is placed in SLRFDDNM. the faulty active log data set is marked 'stopped'.
v If the error was detected by DSNJR005, then
If you suspect an error in DB2, refer to Part 2 of DB2 message DSNJ012I is issued and the calling agent is
Diagnosis Guide and Reference for information on terminated.
identifying and reporting the problem.
v If the error was detected by DSNJW009, then
Operator Response: If the reason code is issued by message DSNJ012I is issued and the DB2
an active DB2 subsystem, collect the SYS1.LOGREC subsystem is terminated.
and SVC dump, and notify the system programmer. v If the error was detected by DSNJW107, then the
System Programmer Response: If the reason code DB2 subsystem is terminated.
is issued by an active DB2 subsystem, obtain the
SYS1.LOGREC and the SVC dump from the operator. If this reason code is issued as the result of DB2
stand-alone log services GET processing, no abend is
Collect the following diagnostic items listed in issued by the stand-alone log services CSECT
“Appendix B. Problem determination” on page 1281: 2, (DSNJRS01), and no information is written to
5, 16. SYS1.LOGREC data set. Rather, in response to the
Problem Determination: If the reason code is issued DSNJSLR FUNC=GET call, DB2 places a return code
by an active DB2 subsystem: of 4 in register 15 and a reason code of 00D10266 in
register 0. Information about the results of the GET
v RLM standard diagnostic information is provided
request is also returned in the stand-alone log GET
under “Chapter 38. X’D1......’ Codes” on page 805.
Feedback Area (SLRF). The RBA of the log record with
v Refer to Part 4 (Volume 1) of DB2 Administration the invalid RBA is placed in SLRFRBA. The address
Guide for information about recovery from log and length of the CI are placed in SLRFFRAD and
failures. SLRFRCLL, respectively. The ddname of the data set
v If you suspect an error in DB2, refer to Part 2 of DB2 on which the activity occurred is placed in SLRFDDNM.
Diagnosis Guide and Reference for information on
identifying and reporting the problem.
828 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D10267
For additional details about the stand-alone log v If the error was detected by DSNJR005, then
services, refer to Appendix C (Volume 2) of DB2 message DSNJ012I is issued and the calling agent is
Administration Guide. terminated.
Operator Response: If the reason code is issued by v If the error was detected by DSNJW009, then
an active DB2 subsystem, collect the SYS1.LOGREC message DSNJ012I is issued and the DB2
and SVC dump, and notify the system programmer. subsystem is terminated.
v If the error was detected by DSNJW107, then the
System Programmer Response: If the reason code
DB2 subsystem is terminated.
is issued by an active DB2 subsystem, obtain the
SYS1.LOGREC and the SVC dump from the operator.
If this reason code is issued as the result of DB2
Collect the following diagnostic items listed in stand-alone log services GET processing, no abend is
“Appendix B. Problem determination” on page 1281: 2, issued by the stand-alone log services CSECT
5, 16. (DSNJRS01), and no information is written to
SYS1.LOGREC data set. Rather, in response to the
Problem Determination: If the reason code is issued
DSNJSLR FUNC=GET call, DB2 places a return code
by an active DB2 subsystem:
of 4 in register 15 and a reason code of 00D10267 in
v RLM standard diagnostic information is provided register 0. Information about the results of the GET
under “Chapter 38. X’D1......’ Codes” on page 805. request is also returned in the stand-alone log GET
v Refer to Part 4 (Volume 1) of DB2 Administration Feedback Area (SLRF). The RBA of the record segment
Guide for information about recovery from log in error is placed in SLRFRBA. The address and length
failures. of the CI are placed in SLRFFRAD and SLRFRCLL,
v Refer to Appendix C (Volume 2) of DB2 respectively. The ddname of the data set on which the
Administration Guide for failure analysis procedures, activity occurred is placed in SLRFDDNM.
with particular emphasis on the use of the DB2
stand-alone log Services. For additional details about the stand-alone log
services, refer to Appendix C (Volume 2) of DB2
v Obtain a DSN1LOGP detail report containing the log
Administration Guide.
record(s) associated with the failure.
Operator Response: If the reason code is issued by
If the reason code is issued upon return of an an active DB2 subsystem, collect the SYS1.LOGREC
invocation of the DB2 stand-alone log services macro and SVC dump, and notify the system programmer.
(DSNJSLR), then an additional user-written exit or
System Programmer Response: If the reason code
diagnostic routine may have to be written.
is issued by an active DB2 subsystem, obtain the
SYS1.LOGREC and the SVC dump from the operator.
00D10267
Collect the following diagnostic items listed in
Explanation: While scanning a log control interval “Appendix B. Problem determination” on page 1281: 2,
(CI), a middle or last spanned record segment was not 5, 16.
the first segment contained in the log CI.
Problem Determination: If the reason code is issued
This reason code is issued by the following CSECTs: by an active DB2 subsystem:
v RLM standard diagnostic information is provided
DSNJOFF1 DSNJRS01 DSNJ005 DSNJW009 under “Chapter 38. X’D1......’ Codes” on page 805.
DSNJW107
v Refer to Part 4 (Volume 1) of DB2 Administration
Guide for information about recovery from log
System Action: This reason code can be issued by failures.
an active DB2 subsystem as the log buffers are v Refer to Appendix C (Volume 2) of DB2
scanned before they are written to the active log, or by Administration Guide for failure analysis procedures,
the DB2 stand-alone log services GET processing with particular emphasis on the use of the DB2
macro (DSNJSLR) as a CI is retrieved from a stand-alone log Services.
user-specified active or archive log data set.
v Obtain a DSN1LOGP detail report containing the log
If the reason code is issued by an active DB2 record(s) associated with the failure.
subsystem, then an abend is issued. A diagnostic
record is written to SYS1.LOGREC, and an SVC dump If the reason code is issued upon return of an
is requested. invocation of the DB2 stand-alone log services macro
v If the error was detected by DSNJOFF1, then the (DSNJSLR), then an additional user-written exit or
archiving of the active log data set is terminated and diagnostic routine may have to be written.
the faulty active log data set is marked 'stopped'.
Chapter 38. DB2 Codes 829
00D10268 • 00D10301
“Appendix B. Problem determination” on page 1281: 2,
00D10268
5, 16.
Explanation: While scanning a log control interval
Problem Determination: If the reason code is issued
(CI), a first or middle spanned record segment was not
by an active DB2 subsystem:
the last segment contained in the log CI.
v RLM standard diagnostic information is provided
This reason code is issued by the following CSECTs: under “Chapter 38. X’D1......’ Codes” on page 805.
DSNJOFF1 DSNJRS01 DSNJR005 DSNJW009 v Refer to Part 4 (Volume 1) of DB2 Administration
DSNJW107 Guide for information about recovery from log
failures.
v Refer to Appendix C (Volume 2) of DB2
System Action: This reason code can be issued by
Administration Guide for failure analysis procedures,
an active DB2 subsystem as the log buffers are
with particular emphasis on the use of the DB2
scanned before they are written to the active log, or by
stand-alone log Services.
the DB2 stand-alone log services GET processing
macro (DSNJSLR) as a CI is retrieved from a v Obtain a DSN1LOGP detail report containing the log
user-specified active or archive log data set. record(s) associated with the failure.
If the reason code is issued by an active DB2 If the reason code is issued upon return of an
subsystem, then an abend is issued. A diagnostic invocation of the DB2 stand-alone log services macro
record is written to SYS1.LOGREC, and an SVC dump (DSNJSLR), then an additional user-written exit or
is requested. diagnostic routine may have to be written.
v If the error was detected by DSNJOFF1, then the
archiving of the active log data set is terminated and
00D10269
the faulty active log data set is marked 'stopped'.
v If the error was detected by DSNJR005, then Explanation: An unrecoverable error was found in one
message DSNJ012I is issued and the calling agent is of the buffers, while moving the current log buffer to the
terminated. static write buffer ('shadow buffer') in preparation for the
physical write to the active log. Refer to Part 4 (Volume
v If the error was detected by DSNJW009, then
1) of DB2 Administration Guide for information about
message DSNJ012I is issued and the DB2
recovery from log failures.
subsystem is terminated.
v If the error was detected by DSNJW107, then the This abend reason code is issued by the following
DB2 subsystem is terminated. CSECT: DSNJW107
System Action: An execution unit writes a record to
If this reason code is issued as the result of DB2 SYS1.LOGREC and requests an SVC dump. The
stand-alone log services GET processing, no abend is subsystem then terminates.
issued by the stand-alone log services CSECT
(DSNJRS01), and no information is written to Operator Response: Collect the SYS1.LOGREC and
SYS1.LOGREC data set. Rather, in response to the SVC dump. Notify the system programmer.
DSNJSLR FUNC=GET call, DB2 places a return code System Programmer Response: Obtain the
of 4 in register 15 and a reason code of 00D10268 in SYS1.LOGREC and the SVC dump. If you suspect an
register 0. Information about the results of the GET error in DB2, refer to Part 2 of DB2 Diagnosis Guide
request is also returned in the stand-alone log GET and Reference for information on identifying and
Feedback Area (SLRF). The RBA of the record segment reporting the problem.
in error is placed in SLRFRBA. The address and length
of the CI are placed in SLRFFRAD and SLRFRCLL, Problem Determination: RLM standard diagnostic
respectively. The ddname of the data set on which the information is provided under “Chapter 38. X’D1......’
activity occurred is placed in SLRFDDNM. Codes” on page 805.
Collect the following diagnostic items listed in
For additional details about the stand-alone log “Appendix B. Problem determination” on page 1281: 2,
services, refer to Appendix C (Volume 2) of DB2 5, 16.
Administration Guide.
Operator Response: If the reason code is issued by 00D10301
an active DB2 subsystem, collect the SYS1.LOGREC
and SVC dump, and notify the system programmer. Explanation: An unsuccessful completion of an OPEN
LOG FOR READ has occurred. An open log read cursor
System Programmer Response: If the reason code already exists for this execution block (EB). Only one
is issued by an active DB2 subsystem, obtain the log read cursor per EB is permitted.
SYS1.LOGREC and the SVC dump from the operator.
Collect the following diagnostic items listed in
830 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D10302 • 00D10306
This abend reason code is issued by the following This abend reason code is issued by the following
CSECT: DSNJR001 CSECT: DSNJR001
System Action: An execution unit writes a record to System Action: An execution unit writes a record to
SYS1.LOGREC and requests an SVC dump. The SYS1.LOGREC and requests an SVC dump. The
execution unit then terminates abnormally. execution unit then terminates abnormally.
Operator Response: Collect the SYS1.LOGREC and Operator Response: Collect the SYS1.LOGREC and
SVC dump. Notify the system programmer. SVC dump. Notify the system programmer.
System Programmer Response: Obtain the System Programmer Response: Obtain the
SYS1.LOGREC and SVC dump. Scan the read cursor SYS1.LOGREC and the SVC dump. If you suspect an
pool for a cursor with the same EB, or examine through error in DB2, refer to Part 2 of DB2 Diagnosis Guide
the DB2 trace for the problem. Trace IDs 040301 and and Reference for information on identifying and
040302 identify OPEN entries while 040303 and 040304 reporting the problem.
are for CLOSE.
Problem Determination: RLM standard diagnostic
Problem Determination: RLM standard diagnostic information is provided in “Chapter 38. X’D1......’ Codes”
information is provided in “Chapter 38. X’D1......’ Codes” on page 805.
on page 805. All log read cursors reside in a recovery
Collect the following diagnostic items listed in
log manager storage pool whose header address is in
“Appendix B. Problem determination” on page 1281: 2,
the log manager block (LMB) at LMBRCPHB. The LMB
5, 16.
is pointed to by register 5. Register 6 contains the
address of the EB.
00D10304
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 5, Explanation: An unknown function was requested in
16. an open of a log read cursor.
System Action: DB2 issues a return code of 4 and
00D10302 reason code of 00D10304 to the requesting function.
Explanation: An unsuccessful completion of an OPEN System Programmer Response: Review the DB2
LOG FOR READ has occurred. A valid scope was not console for related errors.
specified.
Problem Determination: If you suspect an error in
This abend reason code is issued by the following DB2, refer to Part 2 of DB2 Diagnosis Guide and
CSECT: DSNJR001 Reference for information on identifying and reporting
the problem.
System Action: An execution unit writes a record to
SYS1.LOGREC and requests an SVC dump. The
execution unit then terminates abnormally. 00D10305
Operator Response: Collect the SYS1.LOGREC and Explanation: A peer log read request was made
SVC dump. Notify the system programmer. without a peer log read cursor.
System Programmer Response: Obtain the System Action: DB2 issues a return code of 4 and
SYS1.LOGREC and the SVC dump. If you suspect an reason code of 00D10305 to the requesting function.
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and System Programmer Response: Review the DB2
reporting the problem. console for related errors.
Problem Determination: RLM standard diagnostic Problem Determination:
information is provided in “Chapter 38. X’D1......’ Codes” If you suspect an error in DB2, refer to Part 2 of DB2
on page 805. Diagnosis Guide and Reference for information on
Collect the following diagnostic items listed in identifying and reporting the problem.
“Appendix B. Problem determination” on page 1281: 5,
16. 00D10306
Explanation: A request to read merged log records
00D10303 failed.
Explanation: An unsuccessful completion of an OPEN System Action: DB2 issues a return code of 4 and
LOG FOR READ has occurred. An invalid log RBA reason code of 00D10306 to the requesting function.
range was specified. HIGHRBA is less than LOWRBA.
System Programmer Response: Review the DB2
console for related errors.
Chapter 38. DB2 Codes 831
00D10307 • 00D10311
Problem Determination: The requesting function has Reference for information on identifying and reporting
put this error code out. Check on this function. the problem.
If you suspect an error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on 00D10310
identifying and reporting the problem.
Explanation: An unsuccessful completion of a SET
READ CURSOR RANGE has occurred. The specified
00D10307 log read cursor was not opened by the execution block
submitting this request. All input requests must be
Explanation: A log read open in data sharing failed
submitted under the execution block that opened the
because the RBA values were not increasing or were
cursor.
overlapping.
This abend reason code is issued by the following
System Action: DB2 issues a return code of 4 and
CSECT: DSNJR001
reason code of 00D10307 to the requesting function.
System Action: An execution unit writes a record to
System Programmer Response: Review the DB2
SYS1.LOGREC and requests an SVC dump. The
console for related errors.
execution unit then terminates abnormally.
Problem Determination: If you suspect an error in
Operator Response: Collect the SYS1.LOGREC and
DB2, refer to Part 2 of DB2 Diagnosis Guide and
SVC dump. Notify the system programmer.
Reference for information on identifying and reporting
the problem. System Programmer Response: Obtain the
SYS1.LOGREC and the SVC dump. If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
00D10308
and Reference for information on identifying and
Explanation: A log read open in data sharing failed. reporting the problem.
System Action: DB2 issues a return code of 4 and Problem Determination: RLM standard diagnostic
reason code of 00D10308 to the requesting function. information is provided in “Chapter 38. X’D1......’ Codes”
on page 805. In addition, register 6 contains the
System Programmer Response: Review the DB2 address of the execution block (EB). All log read cursors
console for related errors. reside in a recovery log manager storage pool whose
Problem Determination: If you suspect an error in header address is in the log manager block (LMB) at
DB2, refer to Part 2 of DB2 Diagnosis Guide and LMBRCPHB. The LMB is pointed to by register 5.
Reference for information on identifying and reporting Collect the following diagnostic items listed in
the problem. “Appendix B. Problem determination” on page 1281: 5,
16.
00D10309
Explanation: A peer BSDS open request failed. 00D10311
System Action: DB2 issues a return code of 4 and Explanation: An unsuccessful completion of a SET
reason code of 00D10309 to the requesting function. READ CURSOR RANGE has occurred. An invalid write
cursor ID was specified.
System Programmer Response: Review the DB2
console for related errors. This abend reason code is issued by the following
CSECT: DSNJR001
Problem Determination: If you suspect an error in
DB2, refer to Part 2 of DB2 Diagnosis Guide and System Action: An execution unit writes a record to
Reference for information on identifying and reporting SYS1.LOGREC and requests an SVC dump. The
the problem. execution unit then terminates abnormally.
Operator Response: Collect the SYS1.LOGREC and
00D1030A SVC dump. Notify the system programmer.
Explanation: A peer log read request was made in System Programmer Response: Obtain the
non-data sharing. SYS1.LOGREC and the SVC dump. If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
System Action: DB2 issues a return code of 4 and and Reference for information on identifying and
reason code of 00D1030A to the requesting function. reporting the problem.
System Programmer Response: Review the DB2 Problem Determination: RLM standard diagnostic
console for related errors. information is provided in “Chapter 38. X’D1......’ Codes”
Problem Determination: If you suspect an error in on page 805. In addition, all log write cursors reside in
DB2, refer to Part 2 of DB2 Diagnosis Guide and a recovery log manager storage pool whose header
832 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D10312 • 00D10324
address is in the log manager block (LMB) at “Appendix B. Problem determination” on page 1281: 5,
LMBWCPHB. The LMB is pointed to by register 5. Read 16.
cursors are in a similar pool at LMBRCPHB.
Collect the following diagnostic items listed in 00D10323
“Appendix B. Problem determination” on page 1281: 2,
Explanation: An unsuccessful completion of a LOG
5, 16.
READ has occurred. MODE=DIRECT with record
matching the specified SCOPE is not found.
00D10312
This abend reason code is issued by the following
Explanation: An unsuccessful completion of a SET CSECT: DSNJR003
READ CURSOR RANGE has occurred. An invalid log
System Action: An execution unit writes a record to
RBA range was specified. HIGHRBA is lower than
SYS1.LOGREC and requests an SVC dump. The
LOWRBA.
execution unit then terminates abnormally.
This abend reason code is issued by the following
Operator Response: Collect the SYS1.LOGREC and
CSECT: DSNJR001
SVC dump. Notify the system programmer.
System Action: An execution unit writes a record to
System Programmer Response: Obtain the
SYS1.LOGREC and requests an SVC dump. The
SYS1.LOGREC and the SVC dump. If you suspect an
execution unit then terminates abnormally.
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
Operator Response: Collect the SYS1.LOGREC and and Reference for information on identifying and
SVC dump. Notify the system programmer. reporting the problem.
System Programmer Response: Obtain the Problem Determination: RLM standard diagnostic
SYS1.LOGREC and the SVC dump. If you suspect an information is provided in “Chapter 38. X’D1......’ Codes”
error in DB2, refer to Part 2 of DB2 Diagnosis Guide on page 805.
and Reference for information on identifying and
Collect the following diagnostic items listed in
reporting the problem.
“Appendix B. Problem determination” on page 1281: 5,
Problem Determination: RLM standard diagnostic 16.
information is provided in “Chapter 38. X’D1......’ Codes”
on page 805.
00D10324
Collect the following diagnostic items listed in
Explanation: An unsuccessful completion of a LOG
“Appendix B. Problem determination” on page 1281: 2,
READ has occurred. MODE=DIRECT with record
5, 16.
matching the specified CDATA is not found.
This abend reason code is issued by the following
00D10322
CSECT: DSNJR003
Explanation: An unsuccessful completion of a LOG
System Action: An execution unit writes a record to
READ has occurred. MODE=DIRECT with a record
SYS1.LOGREC and requests an SVC dump. The
matching the specified TYPE was not found.
execution unit then terminates abnormally.
This abend reason code is issued by the following
Operator Response: Collect the SYS1.LOGREC and
CSECT: DSNJR003
SVC dump. Notify the system programmer.
System Action: An execution unit writes a record to
System Programmer Response: Obtain the
SYS1.LOGREC and requests an SVC dump. The
SYS1.LOGREC and the SVC dump. If you suspect an
execution unit then terminates abnormally.
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
Operator Response: Collect the SYS1.LOGREC and and Reference for information on identifying and
SVC dump. Notify the system programmer. reporting the problem.
System Programmer Response: Obtain the Problem Determination: RLM standard diagnostic
SYS1.LOGREC and the SVC dump. If you suspect an information is provided in “Chapter 38. X’D1......’ Codes”
error in DB2, refer to Part 2 of DB2 Diagnosis Guide on page 805.
and Reference for information on identifying and
Collect the following diagnostic items listed in
reporting the problem.
“Appendix B. Problem determination” on page 1281: 5,
Problem Determination: RLM standard diagnostic 16.
information is provided in “Chapter 38. X’D1......’ Codes”
on page 805.
Collect the following diagnostic items listed in
Chapter 38. DB2 Codes 833
00D10325 • 00D10329
System Action: An execution unit writes a record to
00D10325
SYS1.LOGREC and requests an SVC dump. The
Explanation: An unsuccessful completion of a LOG execution unit then terminates abnormally.
READ has occurred. The sum of CDATA length value
Operator Response: Collect the SYS1.LOGREC and
and CDATA offset value is greater than 256.
SVC dump. Notify the system programmer.
This abend reason code is issued by the following
System Programmer Response: Obtain the
CSECT: DSNJR003
SYS1.LOGREC and the SVC dump. If you suspect an
System Action: An execution unit writes a record to error in DB2, refer to Part 2 of DB2 Diagnosis Guide
SYS1.LOGREC and requests an SVC dump. The and Reference for information on identifying and
execution unit then terminates abnormally. reporting the problem.
Operator Response: Collect the SYS1.LOGREC and Problem Determination: RLM standard diagnostic
SVC dump. Notify the system programmer. information is provided in “Chapter 38. X’D1......’ Codes”
on page 805.
System Programmer Response: Obtain the
SYS1.LOGREC and the SVC dump. If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide 00D10328
and Reference for information on identifying and
Explanation: A LOG READ completed unsuccessfully,
reporting the problem.
because a MODE request sequence was invalid. A read
Problem Determination: RLM standard diagnostic request specifying a sequential MODE (any MODE
information is provided in “Chapter 38. X’D1......’ Codes” except DIRECT) must be preceded by an open log for
on page 805. read, a set read cursor range, or a read with the same
MODE parameter value. It is invalid to intermix read
Collect the following diagnostic items listed in
requests with different sequential mode values.
“Appendix B. Problem determination” on page 1281: 5,
16. This abend reason code is issued by the following
CSECT: DSNJR003
00D10326 System Action: An execution unit writes a record to
SYS1.LOGREC and requests an SVC dump. The
Explanation: An unsuccessful completion of a LOG
execution unit then terminates abnormally.
READ has occurred. The macro invocation specified
that no wait was to occur because of a busy archive log Operator Response: Collect the SYS1.LOGREC and
data set (ADSWAIT(NO)). The macro invocation also SVC dump. Notify the system programmer.
specified that, rather than returning with a condition
System Programmer Response: Obtain the
code (COND(NO)), an abend should be issued by the
SYS1.LOGREC and the SVC dump. If you suspect an
recovery log manager (RLM) subcomponent. The RLM
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
determined that the record requested was on an archive
and Reference for information on identifying and
log data set that was in use.
reporting the problem.
This abend reason code is issued by the following
Problem Determination: RLM standard diagnostic
CSECT: DSNJR008
information is provided in “Chapter 38. X’D1......’ Codes”
System Action: An execution unit writes a record to on page 805.
SYS1.LOGREC and requests an SVC dump. The
Collect the following diagnostic items listed in
execution unit then terminates abnormally.
“Appendix B. Problem determination” on page 1281: 5,
Problem Determination: RLM standard diagnostic 16.
information is provided in “Chapter 38. X’D1......’ Codes”
on page 805.
00D10329
Collect the following diagnostic items listed in
Explanation: A LOG READ completed unsuccessfully,
“Appendix B. Problem determination” on page 1281: 5,
because an I/O error occurred while reading the log
16.
data set.
Refer to Part 4 (Volume 1) of DB2 Administration Guide
00D10327
for information about recovery from log failures.
Explanation: An unsuccessful completion of a LOG
This abend reason code is issued by the following
READ has occurred because of an invalid LOGRBA
CSECT: DSNJR003
value. MODE=DIRECT with requested RBA does not
match the start of a log record. System Action: An execution unit writes a record to
SYS1.LOGREC and requests an SVC dump. The
This abend reason code is issued by the following
execution unit then terminates abnormally.
CSECT: DSNJR003
834 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D1032A • 00D1032D
Operator Response: Collect the SYS1.LOGREC and SVC dump, if a dump was produced. Notify the system
SVC dump. Notify the system programmer. programmer.
System Programmer Response: Examine System Programmer Response: Examine LOGREC
SYS1.LOGREC and SVC dump information. Also, and SVC dump information, if a dump was produced.
examine any prior messages with a DSNJ prefix from Also, examine any prior messages with a DSNJ prefix
the log buffer reader. from recovery log manager allocation processing.
Problem Determination: RLM standard diagnostic Problem Determination: RLM standard diagnostic
information is provided in “Chapter 38. X’D1......’ Codes” information is provided in “Chapter 38. X’D1......’ Codes”
on page 805. on page 805.
Collect the following diagnostic items listed in Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 5, “Appendix B. Problem determination” on page 1281: 5,
16. 16.
This abend reason code is issued by the following
00D1032A CSECT: DSNJR003
Explanation: An unsuccessful completion of a LOG
READ has occurred. BSDS does not map the specified 00D1032C
RBA into a log data set. Either the BSDS is in error, or
Explanation: A LOG READ completed unsuccessfully,
the log data set has been deleted.
because an error occurred while opening or closing a
Refer to Part 4 (Volume 1) of DB2 Administration Guide log data set.
for information about recovery from BSDS or log
Refer to Part 4 (Volume 1) of DB2 Administration Guide
failures.
for information about recovery from log failures.
This abend reason code is issued by the following
This abend reason code is issued by the following
CSECT: DSNJR003
CSECT: DSNJR003
System Action: An execution unit writes a record to
System Action: An execution unit writes a record to
SYS1.LOGREC and requests an SVC dump. The
SYS1.LOGREC and requests an SVC dump. The
execution unit then terminates abnormally.
execution unit then terminates abnormally.
Operator Response: Collect the SYS1.LOGREC and
Operator Response: Collect the SYS1.LOGREC and
SVC dump. Notify the system programmer.
SVC dump. Notify the system programmer.
System Programmer Response: Obtain the
System Programmer Response: Examine LOGREC
SYS1.LOGREC and the SVC dump. Also, obtain a
and SVC dump information. Also, examine prior
listing of the BSDS by running the print log map
messages from recovery log manager open/close
(DSNJU004) utility. If you suspect an error in DB2, refer
processing. These messages have a prefix of DSNJ.
to Part 2 of DB2 Diagnosis Guide and Reference for
information on identifying and reporting the problem. Problem Determination: RLM standard diagnostic
information is provided in “Chapter 38. X’D1......’ Codes”
Problem Determination: RLM standard diagnostic
on page 805.
information is provided in “Chapter 38. X’D1......’ Codes”
on page 805. Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 5,
Collect the following diagnostic items listed in
16.
“Appendix B. Problem determination” on page 1281: 2,
5, 16.
00D1032D
00D1032B Explanation: An unsuccessful completion of a LOG
READ has occurred. The specified log read cursor was
Explanation: A LOG READ completed unsuccessfully
not opened by the execution block submitting this
because an error occurred while trying to allocate a log
request. All input requests must be submitted under the
data set.
execution block that opened the cursor.
Refer to Part 4 (Volume 1) of DB2 Administration Guide
This abend reason code is issued by the following
for information about recovery from log failures.
CSECT: DSNJR003
System Action: An execution unit writes a record to
System Action: An execution unit writes a record to
SYS1.LOGREC and might request an SVC dump. The
SYS1.LOGREC and requests an SVC dump. The
execution unit then terminates abnormally.
execution unit then terminates abnormally.
Operator Response: Collect the SYS1.LOGREC and
Operator Response: Collect the SYS1.LOGREC and
Chapter 38. DB2 Codes 835
00D1032E • 00D10331
SVC dump. Notify the system programmer. System Programmer Response: Obtain the
SYS1.LOGREC and the SVC dump. Refer to Part 2 of
System Programmer Response: Obtain the
DB2 Diagnosis Guide and Reference for information on
SYS1.LOGREC and the SVC dump. If you suspect an
identifying and reporting the problem.
error in DB2, refer to the Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and Problem Determination: RLM standard diagnostic
reporting the problem. information is provided in “Chapter 38. X’D1......’ Codes”
on page 805. In addition, register 6 contains the
Problem Determination: RLM standard diagnostic
address of the execution block (EB). All log read cursors
information is provided in “Chapter 38. X’D1......’ Codes”
reside in a recovery log manager storage pool whose
on page 805. In addition, all log read cursors reside in
header address is in the log manager block (LMB) at
a recovery log manager storage pool whose header
LMBRCPHB. The LMB is pointed to by register 5 and
address is in the log manager block (LMB) at
described by DSNDLMB.
LMBRCPHB. The LMB is pointed to by register 5.
Collect the following diagnostic items listed in
00D10330
“Appendix B. Problem determination” on page 1281: 5,
16. Explanation: An unsuccessful completion of a Close
Log for read has occurred. The specified log read
cursor was not opened by the execution block
00D1032E
submitting this request. All input requests must be
Explanation: A LOG READ completed unsuccessfully submitted under the execution block that opened the
due to an internal error. cursor.
This abend reason code is issued by the following This abend reason code is issued by the following
CSECT: DSNJR103 CSECT: DSNJR001
System Action: An execution unit writes a record to System Action: An execution unit writes a record to
SYS1.LOGREC and requests an SVC dump. The SYS1.LOGREC and requests an SVC dump. The
execution unit then terminates abnormally. execution unit then terminates abnormally.
Operator Response: Collect the SYS1.LOGREC and Operator Response: Collect the SYS1.LOGREC and
SVC dump. Notify the system programmer. SVC dump. Notify the system programmer.
System Programmer Response: Examine LOGREC System Programmer Response: Obtain the
and SVC dump information. LOG READ was passed a SYS1.LOGREC and the SVC dump. If you suspect an
bad parameter list. The field which was detected to be error in DB2, refer to Part 2 of DB2 Diagnosis Guide
in error (RDPLOPT1) is the third byte of the second and Reference for information on identifying and
word traced in the log manager 311 trace entry. The reporting the problem.
RET field of this trace entry along with the MEPL may
Problem Determination: RLM standard diagnostic
be used to determine which module issued the Log
information is provided in “Chapter 38. X’D1......’ Codes”
Read request. Both pieces of information are useful in
on page 805. In addition, register 6 contains the
isolating the failure.
address of the execution block (EB). All log read cursors
Problem Determination: RLM standard diagnostic reside in a recovery log manager storage pool whose
information is provided in “Chapter 38. X’D1......’ Codes” header address is in the log manager block (LMB) at
on page 805. LMBRCPHB. The LMB is pointed to by register 5 and
described by DSNDLMB.
Collect the following diagnostic item listed in
“Appendix B. Problem determination” on page 1281: 5.
00D10331
00D1032F Explanation: A LOG READ completed unsuccessfully
because a LINK RBA did not point to the beginning of a
Explanation: A LOG READ completed unsuccessfully LOG record. This is an internal error.
because the high range RBA provided was not the RBA
of a valid log record. This is an internal error. This abend reason code is issued by the following
CSECT: DSNJR103
This abend reason code is issued by the following
CSECT: DSNJR103 System Action: An execution unit writes a record to
SYS1.LOGREC and requests an SVC dump. The
System Action: An execution unit writes a record to execution unit then terminates abnormally.
SYS1.LOGREC and requests an SVC dump. The
execution unit then terminates abnormally. Operator Response: Collect the SYS1.LOGREC and
SVC dump. Notify the system programmer.
Operator Response: Collect the SYS1.LOGREC and
SVC dump. Notify the system programmer. System Programmer Response: Obtain the
836 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D10332 • 00D10335
SYS1.LOGREC and the SVC dump. Refer to Part 2 of User Response: Notify the system programmer.
DB2 Diagnosis Guide and Reference for information on
Operator Response: Collect the SYS1.LOGREC and
identifying and reporting the problem.
the SVC dump. Notify the system programmer.
Problem Determination: RLM standard diagnostic
System Programmer Response: Obtain the
information is provided in “Chapter 38. X’D1......’ Codes”
SYS1.LOGREC and the SVC dump. Refer to Part 2 of
on page 805. In addition, register 6 contains the
DB2 Diagnosis Guide and Reference for information on
address of the execution block (EB). All log read cursors
identifying and reporting the problem.
reside in a recovery log manager storage pool whose
header address is in the log manager block (LMB) at Problem Determination: RLM standard diagnostic
LMBRCPHB. The LMB is pointed to by register 5 and information is provided in “Chapter 38. X’D1......’ Codes”
described by DSNDLMB. on page 805 (X'D1'). In addition, the following
diagnostic information is provided in registers:
Register 0: the Data Mgr ERQUAL that identifies the
00D10332
place within CSECT DSNILGRX where the error was
Explanation: A log read completed unsuccessfully detected
because a link RBA pointed to a log record with a Register 2, 3: the RBA of the log record that was
different URID. This is an internal error. being read at the time of the error
Register 7: the address of DSCF selection bLock
This abend reason code is issued by the following
Register 8: the address of ssnmDBM1's selection
CSECT: DSNJR103
block.
System Action: A record is written to SYS1.LOGREC
and an SVC DUMP is requested. The requesting
00D10334
execution unit is abnormally terminated.
Explanation: An unsuccessful completion of a LOG
Operator Response: Collect the SYS1.LOGREC and
READ occurred because of an invalid LOGRBA value.
SVC dump. Notify the system programmer.
MODE=SEQUENTIAL DIRECT with the requested RBA
System Programmer Response: While reading the does not match the start of a log record.
log backwards using the LRHLINK RBAs, a log record
This abend reason code is issued by the following
was found that contained a different URID. A link read is
CSECT: DSNJR003
normally done when processing a rollback or an abort.
This abend is issued to prevent a rollback of the wrong System Action: An execution unit writes a record to
transaction. If this occurs during abort processing, the SYS1.LOGREC and requests an SVC dump. The
subsystem is brought down. If the abend reoccurs on execution unit then terminates abnormally.
the subsequent restart of DB2, a conditional restart is
Operator Response: Collect the SYS1.LOGREC and
necessary to bypass the invalid log record. Refer to Part
SVC dump. Notify the system programmer.
4 (Volume 1) of DB2 Administration Guide for
information on recovering from a log failure during System Programmer Response: Obtain the
restart and resolving inconsistencies resulting from SYS1.LOGREC and the SVC dump. If you suspect an
conditional restart. error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and
Problem Determination: RLM standard diagnostic
reporting the problem.
information is provided in “Recovery Log Manager
Reason Codes (X'D1')”. In addition, register 6 contains Problem Determination: RLM standard diagnostic
the address of the execution block (EB). All log read information is provided in ″Recovery Log Manager
cursors reside in a recovery log manager storage pool Reason Codes (X’D1’)″.
whose header address is in the log manager block
(LMB) at LMBRCPHB. The LMB is pointed to by
register 5 and described in the DSNDLMB macro. 00D10335
Explanation: An unsuccessful completion of a LOG
00D10333 READ occurred because the log was not being read in
ascending order for MODE=SEQUENTIAL DIRECT.
Explanation: A log read failed because an internal
error was detected by the Data Manager while This abend reason code is issued by the following
examining the log record during recover and deferred CSECT: DSNJR003
restart. System Action: An execution unit writes a record to
This abend reason code is issued by the following SYS1.LOGREC and requests an SVC dump. The
CSECT: DSNJR103 execution unit then terminates abnormally.
System Action: The execution unit writes a record to Operator Response: Collect the SYS1.LOGREC and
SYS1.LOGREC and requests an SVC dump. The SVC dump. Notify the system programmer.
execution unit then terminates abnormally.
Chapter 38. DB2 Codes 837
00D10340 • 00D10343
System Programmer Response: Obtain the header address is in the log manager block (LMB) at
SYS1.LOGREC and the SVC dump. If you suspect an LMBRCPHB. The LMB is pointed to by register 5 and
error in DB2, refer to Part 2 of DB2 Diagnosis Guide described by DSNDLMB.
and Reference for information on identifying and
reporting the problem.
00D10342
Problem Determination: RLM standard diagnostic
Explanation: A LOG READ completed unsuccessfully
information is provided in ″Recovery Log Manager
because an error was detected during a backward
Reason Codes (X’D1’)″.
READ of a log record. This is an internal error.
This abend reason code is issued by the following
00D10340
CSECT: DSNJR103
Explanation: An unsuccessful completion of a LOG
System Action: An execution unit writes a record to
READ has occurred. This reflects a logic failure internal
SYS1.LOGREC and requests an SVC dump. The
to the recovery log manager (RLM) subcomponent and
execution unit then terminates abnormally.
is probably caused by a passed parameter list being
lost or a previous abend processing a LOG READ Operator Response: Collect the SYS1.LOGREC and
request. SVC dump. Notify the system programmer.
This abend reason code is issued by the following System Programmer Response: Obtain the
CSECT: DSNJR008 SYS1.LOGREC and the SVC dump. Refer to Part 2 of
DB2 Diagnosis Guide and Reference for information on
System Action: An execution unit writes a record to
identifying and reporting the problem.
SYS1.LOGREC and requests an SVC dump. The
execution unit then terminates abnormally. Problem Determination: RLM standard diagnostic
information is provided in “Chapter 38. X’D1......’ Codes”
Operator Response: Collect all relevant diagnostic
on page 805. In addition, register 6 contains the
materials, including SYS1.LOGREC, SVC dump, and
address of the execution block (EB). All log read cursors
console output. Notify the system programmer.
reside in a recovery log manager storage pool whose
System Programmer Response: Examine LOGREC header address is in the log manager block (LMB) at
and SVC dump information for prior abends during LOG LMBRCPHB. The LMB is pointed to by register 5 and
READ processing. If you suspect an error in DB2, refer described by DSNDLMB.
to Part 2 of DB2 Diagnosis Guide and Reference for
information on identifying and reporting the problem.
00D10343
Problem Determination: Collect the following
Explanation: A LOG READ completed unsuccessfully
diagnostic items listed in “Appendix B. Problem
because an error was detected during a READ of a log
determination” on page 1281: 5, 16.
record due to an invalid CI offset. This is an internal
error.
00D10341
This abend reason code is issued by the following
Explanation: A LOG READ completed unsuccessfully CSECT: DSNJR103
because an error was detected during a Forward READ
System Action: An execution unit writes a record to
of the log record. This is an internal error.
SYS1.LOGREC and requests an SVC dump. The
This abend reason code is issued by the following execution unit then terminates abnormally.
CSECT: DSNJR103
Operator Response: Collect the SYS1.LOGREC and
System Action: An execution unit writes a record to SVC dump. Notify the system programmer.
SYS1.LOGREC and requests an SVC dump. The
System Programmer Response: Obtain the
execution unit then terminates abnormally.
SYS1.LOGREC and the SVC dump. Refer to Part 2 of
Operator Response: Collect the SYS1.LOGREC and DB2 Diagnosis Guide and Reference for information on
SVC dump. Notify the system programmer. identifying and reporting the problem.
System Programmer Response: Obtain the Problem Determination: RLM standard diagnostic
SYS1.LOGREC and the SVC dump. Refer to Part 2 of information is provided in “Chapter 38. X’D1......’ Codes”
DB2 Diagnosis Guide and Reference for information on on page 805. In addition, register 6 contains the
identifying and reporting the problem. address of the execution block (EB). All log read cursors
reside in a recovery log manager storage pool whose
Problem Determination: RLM standard diagnostic
header address is in the log manager block (LMB) at
information is provided in “Chapter 38. X’D1......’ Codes”
LMBRCPHB. The LMB is pointed to by register 5 and
on page 805. In addition, register 6 contains the
described by DSNDLMB.
address of the execution block (EB). All log read cursors
reside in a recovery log manager storage pool whose
838 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D10345 • 00D10402
00D10345 00D10349
Explanation: A LOG READ completed unsuccessfully Explanation: A deadlock occurred attempting to
because an error was received from a CATALOG allocate an archive log tape.
LOCATE request for an archive log data set. The
System Action: DB2 issues a return code of 8 and
requested archive log data set might have been
reason code of 00D10349 to the requesting function.
uncataloged or deleted.
System Programmer Response: Review the DB2
System Action: An execution unit might write a record
console for the terminated function.
to SYS1.LOGREC and request an SVC dump.
Problem Determination: The requesting function was
Operator Response: Collect the SYS1.LOGREC and
terminated. There was another function allocating the
SVC dump, if requested. Notify the system programmer.
same archive log tapes. Rerun the terminated function
System Programmer Response: Obtain the after the present function no longer has the archive log
SYS1.LOGREC and the SVC dump, if requested. Refer tapes allocated.
to Part 2 of DB2 Diagnosis Guide and Reference for
If you suspect an error in DB2, refer to Part 2 of DB2
information on identifying and reporting the problem.
Diagnosis Guide and Reference for information on
Problem Determination: RLM standard diagnostic identifying and reporting the problem.
information is provided in “Chapter 38. X’D1......’ Codes”
on page 805.
00D10350
This abend reason code is issued by the following
Explanation: A lock or unlock failed in an attempt to
CSECT: DSNJR106
allocate an archive log tape.
System Action: An execution unit writes a record to
00D10347
SYS1.LOGREC, requests an SVC dump, and then
Explanation: An attempt to notify a peer to force write terminates.
the log buffer failed.
Operator Response: Collect all relevant diagnostic
System Action: DB2 issues a return code of 4 and materials, including SYS1.LOGREC, an SVC dump, and
reason code of 00D10347 to the requesting function. console output. Notify the system programmer.
System Programmer Response: Review the DB2 System Programmer Response: This is an internal
console for related errors. DB2 error, refer to Part 2 of DB2 Diagnosis Guide and
Reference for information on identifying and reporting
Problem Determination: If you suspect an error in
the problem.
DB2, refer to Part 2 of DB2 Diagnosis Guide and
Reference for information on identifying and reporting
the problem. 00D10401
Explanation: A BSDS read was requested and the
00D10348 record was not found.
Explanation: The maximum retry count was exceeded System Action: DB2 returns a return code of 4 and
while attempting to read a log RBA. reason code of 00D10401 to the requesting function.
System Action: The execution unit writes a record to System Programmer Response: Review the DB2
SYS1.LOGREC and requests an SVC dump. The console for related errors.
execution unit then terminates abnormally.
Problem Determination: If you suspect an error in
System Programmer Response: Review the DB2 DB2, refer to Part 2 of DB2 Diagnosis Guide and
console for related errors. Reference for information on identifying and reporting
the problem.
Problem Determination: This problem might occur if
the user has added an archive log to the BSDS with an
incorrect RBA range using Change Log Inventory 00D10402
(DSNJU003) or if an active log dataset has been
Explanation: A BSDS read was requested and the
regressed such that the log dataset does not contain
input area was too small.
the RBA range that is listed in the BSDS.
System Action: DB2 returns a return code of 8 and
If you suspect an error in DB2, refer to Part 2 of DB2
reason code of 00D10402 to the requesting function.
Diagnosis Guide and Reference for information on
identifying and reporting the problem. System Programmer Response: Review the DB2
console for related errors.
Problem Determination: If you suspect an error in
Chapter 38. DB2 Codes 839
00D10403 • 00D10411
DB2, refer to Part 2 of DB2 Diagnosis Guide and materials, including SYS1.LOGREC, SVC dump, and
Reference for information on identifying and reporting console output. Notify the system programmer.
the problem.
System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
00D10403 and Reference for information on identifying and
reporting the problem.
Explanation: A BSDS update was requested and the
record was not found. Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
System Action: DB2 returns a return code of 4 and
determination” on page 1281: 5, 16.
reason code of 00D10403 to the requesting function.
System Programmer Response: Review the DB2
00D10410
console for related errors.
Explanation: An unsuccessful completion of a READ
Problem Determination: If you suspect an error in
BSDS RECORD has occurred. An error has been
DB2, refer to Part 2 of DB2 Diagnosis Guide and
returned from VSAM.
Reference for information on identifying and reporting
the problem. This abend reason code is issued by the following
CSECT: DSNJB002
00D10404 System Action: An execution unit writes a record to
SYS1.LOGREC and requests an SVC dump. The
Explanation: A BSDS insert was requested and the
execution unit then terminates abnormally.
record already exits.
Operator Response: Collect the SYS1.LOGREC and
System Action: DB2 returns a return code of 4 and
SVC dump. Notify the system programmer.
reason code of 00D10404 to the requesting function.
System Programmer Response: Use the
System Programmer Response: Review the DB2
SYS1.LOGREC and SVC dump to determine the cause
console for related errors.
of the problem.
Problem Determination: If you suspect an error in
Problem Determination: RLM standard diagnostic
DB2, refer to Part 2 of DB2 Diagnosis Guide and
information is provided in “Chapter 38. X’D1......’ Codes”
Reference for information on identifying and reporting
on page 805. In addition, the VSAM RPL fields
the problem.
RPLERRCD and RPLERREG are stored in the BSDS
request parameter list. The address of the BSDS
00D10405 request parameter list is stored in the BSDS request
element (BSDSRQEL) field (located at offset X'8' in the
Explanation: A BSDS delete was requested and the bootstrap data set block).
record does not exist.
Collect the following diagnostic items listed in
System Action: DB2 returns a return code of 4 and “Appendix B. Problem determination” on page 1281: 1,
reason code of 00D10405 to the requesting function. 2, 5, 16.
System Programmer Response: Review the DB2
console for related errors. 00D10411
Problem Determination: If you suspect an error in Explanation: An unsuccessful completion of a WRITE
DB2, refer to Part 2 of DB2 Diagnosis Guide and UPDATE BSDS RECORD has occurred. An error has
Reference for information on identifying and reporting been returned from VSAM.
the problem.
This abend reason code is issued by the following
CSECT: DSNJB002
00D10406
System Action: An execution unit writes a record to
Explanation: The bootstrap data set access service SYS1.LOGREC and requests an SVC dump. The
received a request with an invalid function code. execution unit then terminates abnormally.
This abend reason code is issued by the following Operator Response: Collect the SYS1.LOGREC and
CSECT: DSNJB001 SVC dump. Notify the system programmer.
System Action: If this was an unconditional request, System Programmer Response: Obtain the
an execution unit writes a record to SYS1.LOGREC and SYS1.LOGREC and SVC dump. Determine the cause
requests an SVC dump. The execution unit then of the problem from the diagnostic information in the
terminates abnormally. Problem Determination section of this message.
Operator Response: Collect all relevant diagnostic Problem Determination: RLM standard diagnostic
840 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D10412 • 00D10416
information is provided in “Chapter 38. X’D1......’ Codes” Problem Determination: RLM standard diagnostic
on page 805. In addition, the VSAM RPL fields information is provided in “Chapter 38. X’D1......’ Codes”
RPLERRCD and RPLERREG are stored in the BSDS on page 805. In addition, the VSAM RPL fields
request parameter list. The address of the BSDS RPLERRCD and RPLERREG are stored in the BSDS
request parameter list is stored in the BSDS request request parameter list. The address of the BSDS
element (BSDSRQEL) field (located at offset 8 in the request parameter list is stored in the BSDS request
bootstrap data set block). element (BSDSRQEL) field (located at offset 8 in the
bootstrap data set block).
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1, Collect the following diagnostic items listed in
2, 5, 16. “Appendix B. Problem determination” on page 1281: 1,
2, 5, 16.
00D10412
00D10414
Explanation: An unsuccessful completion of a WRITE
INSERT BSDS RECORD has occurred. An error has Explanation: DB2 cannot dynamically allocate a copy
been returned from VSAM. of the requested bootstrap data set (BSDS).
This abend reason code is issued by the following System Action: The system places the BSDS in
CSECT: DSNJB002 disabled mode.
System Action: An execution unit writes a record to User Response: Notify the system programmer.
SYS1.LOGREC and requests an SVC dump. The
System Programmer Response: Restore the BSDS
execution unit then terminates abnormally.
data set (or data sets) and restart the DB2 subsystem
Operator Response: Collect the SYS1.LOGREC and associated with the BSDS.
SVC dump. Notify the system programmer.
Problem Determination: This reason code is issued
System Programmer Response: Obtain the by the following CSECT: DSNJB002
SYS1.LOGREC and SVC dump. Determine the cause
of the problem from the diagnostic information in the
00D10415
Problem Determination section of this message.
Explanation: The bootstrap data set (BSDS) is not a
Problem Determination: RLM standard diagnostic
valid BSDS for the data sharing group.
information is provided in “Chapter 38. X’D1......’ Codes”
on page 805. In addition, the VSAM RPL fields System Action: The system places the BSDS in
RPLERRCD and RPLERREG are stored in the BSDS disabled mode.
request parameter list. The address of the BSDS
request parameter list is stored in the BSDS request User Response: Notify the system programmer.
element (BSDSRQEL) field (located at offset 8 in the System Programmer Response: Restore the BSDS
bootstrap data set block). data set (or data sets) and restart the DB2 subsystem
Collect the following diagnostic items listed in associated with the BSDS.
“Appendix B. Problem determination” on page 1281: 1, Problem Determination: This abend reason code is
2, 5, 16. issued by the following CSECT: DSNJB002
00D10413 00D10416
Explanation: An unsuccessful completion of a Explanation: A peer BSDS process was requested in
DELETE BSDS RECORD has occurred. An error has non-data sharing.
been returned from VSAM.
System Action: DB2 issues a return code of 8 and
This abend reason code is issued by the following reason code of 00D10416 to the requesting function.
CSECT: DSNJB002
System Programmer Response: Review the DB2
System Action: An execution unit writes a record to console for related errors.
SYS1.LOGREC and requests an SVC dump. The
execution unit then terminates abnormally. Problem Determination: Peer BSDS requests cannot
occur in non-data sharing.
Operator Response: Notify the system programmer.
If you suspect an error in DB2, refer to Part 2 of DB2
System Programmer Response: Obtain the Diagnosis Guide and Reference for information on
SYS1.LOGREC and SVC dump. Determine the cause identifying and reporting the problem.
of the problem from the diagnostic information in the
Problem Determination section of this message.
Chapter 38. DB2 Codes 841
00D10417 • 00D10701
of the problem from the diagnostic information in the
00D10417
Problem Determination section of this message.
Explanation: A peer BSDS process was requested for
Problem Determination: RLM standard diagnostic
a host BSDS.
information is provided in “Chapter 38. X’D1......’ Codes”
System Action: DB2 issues a return code of 8 and on page 805. The address of the DSPL is provided in
reason code of 00D10417 to the requesting function. register 3, and the invalid function in register 4.
System Programmer Response: Review the DB2 Collect the following diagnostic items listed in
console for related errors. “Appendix B. Problem determination” on page 1281: 2,
5.
Problem Determination: Peer BSDS requests cannot
be processed for the host BSDS.
00D10700
If you suspect an error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on Explanation: An error completion code was returned
identifying and reporting the problem. by SETLOCK OBTAIN.
This abend reason code is issued by the following
00D10500 CSECT: DSNJM002
Explanation: The recovery log manager’s dynamic System Action: An execution unit writes a record to
allocation function has been passed a bad function SYS1.LOGREC and requests an SVC dump. The
code (LRB4FUNC in control block LRB4). execution unit then terminates abnormally.
This abend reason code is issued by the following Operator Response: Notify the system programmer.
CSECT: DSNJDS01
System Programmer Response: Obtain the
System Action: An execution unit writes a record to SYS1.LOGREC and SVC dump. Determine the cause
SYS1.LOGREC and requests an SVC dump. The of the problem from the diagnostic information in the
execution unit then terminates abnormally. Problem Determination section of this message.
Operator Response: Notify the system programmer. Problem Determination: RLM standard diagnostic
information is provided in “Chapter 38. X’D1......’ Codes”
System Programmer Response: Obtain the
on page 805. In addition, register 0 contains the return
SYS1.LOGREC and SVC dump. Determine the cause
code from SETLOCK OBTAIN.
of the problem from the diagnostic information in the
Problem Determination section of this message. Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 2,
Problem Determination: RLM standard diagnostic
5.
information is provided in “Chapter 38. X’D1......’ Codes”
on page 805. In addition, trace entry 501 provides the
return address to the module that passed the LRB4 with 00D10701
the undefined function code. It also provides the
Explanation: An error completion code was returned
address of the LRB4. This address is also in register 7
by SETLOCK RELEASE.
at the time of the abend.
This abend reason code is issued by the following
Collect the following diagnostic items listed in
CSECT: DSNJM002
“Appendix B. Problem determination” on page 1281: 2,
5. System Action: An execution unit writes a record to
SYS1.LOGREC and requests an SVC dump. The
execution unit then terminates abnormally.
00D10501
Operator Response: Notify the system programmer.
Explanation: The recovery log manager’s common
access method services has been passed a bad System Programmer Response: Obtain the
function code (DSPLFUNC in control block DSPL). SYS1.LOGREC and SVC dump. Determine the cause
of the problem from the diagnostic information in the
This abend reason code is issued by the following
Problem Determination section of this message.
CSECT: DSNJDS05
Problem Determination: RLM standard diagnostic
System Action: An execution unit writes a record to
information is provided in “Chapter 38. X’D1......’ Codes”
SYS1.LOGREC and requests an SVC dump. The
on page 805. In addition, register 0 contains the return
execution unit then terminates abnormally.
code from SETLOCK RELEASE.
Operator Response: Notify the system programmer.
Collect the following diagnostic items listed in
System Programmer Response: Obtain the “Appendix B. Problem determination” on page 1281: 2,
SYS1.LOGREC and SVC dump. Determine the cause 5.
842 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D10800 • 00D10905
requests an SVC dump, and terminates.
00D10800
Operator Response: Collect all relevant diagnostic
Explanation: The log manager command processor
materials, including SYS1.LOGREC, an SVC dump, and
(DSNJC001) was entered with an invalid Tokenized
console output of peer and host.
Command Segment (TCS).
Problem Determination: Review the DB2 system
This reason code is issued by the following CSECT:
console for possible errors relating the peer’s BSDS on
DSNJC001
both the host and peer DB2 system.
System Action: A diagnostic record is written to
See the DB2 system console for messages DSNJ103I
SYS1.LOGREC, and an SVC dump is requested. The
and DSNJ700I that are issued with this DB2 condition
requesting execution unit is abended.
code.
Operator Response: Collect the SYS1.LOGREC and
If you suspect an error in DB2, refer to Part 2 of DB2
SVC dump, and notify the system programmer.
Diagnosis Guide and Reference for information on
System Programmer Response: Obtain the identifying and reporting the problem.
SYS1.LOGREC and the SVC dump from the operator. If
you suspect an error in DB2, refer to Part 2 of DB2
00D10903
Diagnosis Guide and Reference for information on
identifying and reporting the problem. Explanation: An open of a peer BSDS failed.
Problem Determination: RLM standard diagnostic System Action: If this was an unconditional request,
information is provided under “Chapter 38. X’D1......’ an execution unit writes a record to SYS1.LOGREC,
Codes” on page 805 . requests an SVC dump, and terminates.
General register 1 contains the address of the TCS as Operator Response: Collect all relevant diagnostic
passed to log manager. The character string 'TCS' materials, including SYS1.LOGREC, an SVC dump, and
should appear at the address provided in R1, plus 4. console output. Notify the system programmer.
The address of the GCPC Pool Header Block (PHB) is
provided in general register 2. The value X'0036' should Problem Determination: Review the DB2 system
appear at the address provided in R2. If these two items console for messages DSNJ100I and DSNJ700I that
are not present, then the DSNJC001 CSECT was are issued with this DB2 condition code.
invoked in error by an execution unit. If you suspect an error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on
00D10901 identifying and reporting the problem.
Explanation: DB2 failed to locate a data sharing
member in the SCA. 00D10904
System Action: If this was an unconditional request, Explanation: There was a VSAM MRKBFR error for a
an execution unit writes a record to SYS1.LOGREC, peer BSDS.
requests an SVC dump, and terminates. System Action: If this was an unconditional request,
Operator Response: Collect all relevant diagnostic an execution unit writes a record to SYS1.LOGREC,
materials, including SYS1.LOGREC, an SVC dump, and requests an SVC dump, and terminates.
console output. Operator Response: Collect all relevant diagnostic
Problem Determination: Review the DB2 system materials, including SYS1.LOGREC, an SVC dump, and
console for possible DSN7xxxx messages that could console output.
relate to this problem. Problem Determination: The VSAM MRKBFR error is
See the DB2 system console for message DSNJ700I placed in LRB1XRC.
that is issued with this DB2 condition code. See the DB2 system console for message DSNJ700I
If you suspect an error in DB2, refer to Part 2 of DB2 that is issued with this DB2 condition code.
Diagnosis Guide and Reference for information on If you suspect an error in DB2, refer to Part 2 of DB2
identifying and reporting the problem. Diagnosis Guide and Reference for information on
identifying and reporting the problem.
00D10902
Explanation: A dynamic allocation of a peer’s BSDS 00D10905
failed. Explanation: There is a mismatch between the two
System Action: If this was an unconditional request, BSDS timestamps of a peer.
an execution unit writes a record to SYS1.LOGREC, System Action: If this was an unconditional request,
Chapter 38. DB2 Codes 843
00D10906 • 00D10910
an execution unit writes a record to SYS1.LOGREC,
00D10908
requests an SVC dump, and terminates.
Explanation: An open of a peer’s active log failed.
Problem Determination: There is a mismatch
between the two BSDS system timestamps of a peer, System Action: If this was an unconditional request,
the BSDS change log inventory (DSNJU003) an execution unit writes a record to SYS1.LOGREC,
timestamps of a peer, or both. The peer log requests an SVC dump, and terminates.
environment might have changed. This must be
Operator Response: Collect all relevant diagnostic
resolved at the peer DB2 subsystem by determining
materials, including SYS1.LOGREC, an SVC dump, and
which BSDS is in error and recovering that BSDS.
console output of peer and host.
See the DB2 system console for message DSNJ700I
Problem Determination: Review the DB2 system
that is issued with this DB2 condition code.
console for possible errors relating the peer’s active log
If you suspect an error in DB2, refer to Part 2 of DB2 on both the host and peer DB2 system.
Diagnosis Guide and Reference for information on
The VSAM CONNECT return code is in LRB1XRC if an
identifying and reporting the problem.
SVC dump was taken.
See the DB2 system console for message DSNJ700I
00D10906
that is issued with this DB2 condition code.
Explanation: The change log inventory (DSNJU003)
If you suspect an error in DB2, refer to Part 2 of DB2
timestamp does not match the system timestamp in the
Diagnosis Guide and Reference for information on
peer BSDS.
identifying and reporting the problem.
System Action: If this was an unconditional request,
an execution unit writes a record to SYS1.LOGREC,
00D10909
requests an SVC dump, and terminates.
Explanation: There was no active BSDS found for the
Problem Determination: A change log inventory
peer DB2 subsystem.
(DSNJU003) job was executed against the peer BSDS
after the last peer DB2 subsystem restart. The peer log System Action: If this was an unconditional request,
environment might have changed. Restart the peer DB2 an execution unit writes a record to SYS1.LOGREC,
subsystem to reset this condition. requests an SVC dump, and terminates.
See the DB2 system console for message DSNJ700I Operator Response: Collect all relevant diagnostic
that is issued with this DB2 condition code. materials, including SYS1.LOGREC, SVC dump, and
console output of peer and host.
If you suspect an error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on Problem Determination: Review the DB2 system
identifying and reporting the problem. console for possible errors relating the peer’s BSDSs on
both the host and peer DB2 system.
00D10907 See the DB2 system console for message DSNJ700I
that is issued with this DB2 condition code.
Explanation: DB2 could not locate a peer’s active log
data set in the peer’s BSDS. The peer BSDSs have been placed in inactive mode.
There might have been an error against this peer’s
System Action: If this was an unconditional request,
BSDSs and a recovery is needed.
an execution unit writes a record to SYS1.LOGREC,
requests an SVC dump, and terminates. If you suspect an error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on
Operator Response: Collect all relevant diagnostic
identifying and reporting the problem.
materials including SYS1.LOGREC, an SVC dump, and
console output.
00D10910
Problem Determination: Run a print log map
(DSNJU004) job against the peer’s BSDS to compare Explanation: A BLDVRP/DLVRP macro failed for the
BSDS active log entries with the existing peer’s log data BSDS buffer.
sets. There is probably a mismatch between them.
System Action: An execution unit writes a record to
See the DB2 system console for message DSNJ700I SYS1.LOGREC, requests an SVC dump, and then
that is issued with this DB2 condition code. terminates.
If you suspect an error in DB2, refer to Part 2 of DB2 Operator Response: Collect all relevant diagnostic
Diagnosis Guide and Reference for information on materials, including SYS1.LOGREC, SVC dump, and
identifying and reporting the problem. console output.
Problem Determination: Review the DB2 system
844 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D10916 • 00D10917
console for possible errors relating to the BSDS.
A BLDVRP/DLVRP macro for a VSAM shared resource
pool failed for the BSDS. General register 2 will contain
a value of 1 for a BLDVRP macro or a value of 2 for a
DLVRP macro. The macro return code is contained in
general register 3. See the appropriate VSAM
publication for advanced VSAM applications.
If you suspect an error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on
identifying and reporting the problem.
00D10916
Explanation: DB2 received an error while attempting
to read shared communications area (SCA) information
from the coupling facility.
System Action: Standard DB2 diagnostic information
is recorded in SYS1.LOGREC, and an SVC dump is
requested. The subsystem will be terminated with the
same reason code.
System Programmer Response: Correct the problem
with the coupling facility, and restart DB2.
Problem Determination: Review the DB2 system
console for possible DSN7xxxx and DSNJxxxx
messages that might relate to this problem. If you
suspect an error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on
identifying and reporting the problem.
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
2, 5.
00D10917
Explanation: DB2 received an error while attempting
to write shared communications area (SCA) information
to the coupling facility.
System Action: Standard DB2 diagnostic information
is recorded in SYS1.LOGREC, and an SVC dump is
requested. The subsystem will be terminated with the
same reason code.
System Programmer Response: Correct the problem
with the coupling facility, and restart DB2.
Problem Determination: Review the DB2 system
console for possible DSN7xxxx and DSNJxxxx
messages that might relate to this problem. If you
suspect an error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on
identifying and reporting the problem.
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
2, 5.
Chapter 38. DB2 Codes 845
846 DB2 UDB for OS/390 and z/OS: Messages and Codes
Chapter 39. X’D3......’ Codes
00D30000 00D30002
Explanation: The operator canceled the allied agent Explanation: The distributed data facility (DDF)
at the requesting location and a dump was requested, standard ESTAE and FRR recovery routines detected a
or the agent abended with a reason code that indicated bad recovery element. This is a DB2 internal error.
a possible communication problem. In either case, the
System Action: A record is written to SYS1.LOGREC
database access agent at this location abended to take
and an SVC dump is requested at the site of the DB2
a dump to assist in problem determination.
abend.
This abend reason code is issued by the following
Operator Response: Notify the system programmer.
CSECT: DSNLABRT
System Programmer Response: Determine which
System Action: The agent terminates.
sites the abending agent was connected to by
Operator Response: Notify the system programmer. examining the DSNL027 and DSNL028 SYSLOG
console messages at the site of the DB2 abend. Obtain
System Programmer Response: The information
copies of the SYS1.LOGREC and SYSLOG data sets
collected as a result of this abend is related to
from each connected site, the SVC dump at the site of
information collected at the requesting location. Obtain a
the DB2 failure, and any related dumps from each
copy of the SYS1.LOGREC listing and the SVC dump.
connected site.
Contact the system programmer at the requesting
location (the location name can be determined from the Refer to Part 2 of DB2 Diagnosis Guide and Reference
dump header) to coordinate further action. for information on identifying and reporting the problem.
Problem Determination: This abend was initiated in Problem Determination: Collect the following
order to save diagnostic information that might be useful diagnostic items listed in “Appendix B. Problem
in problem determination. determination” on page 1281: 56, 57.
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1, 00D30003
2, 5.
Explanation: While establishing an ESTAE functional
recovery, DB2 detected a failure.
00D30001
System Action: A record is written to SYS1.LOGREC
Explanation: The DPS RALE was not initialized. The and an SVC dump is requested at the site of the DB2
DSNLSPRR was invoked with the DPSB defined as the abend.
functional recovery routine (FRR) anchor. The DPSB is
Operator Response: Notify the system programmer.
created after the DPS RALE is initialized.
System Programmer Response: Determine which
System Action: A record is written to SYS1.LOGREC
sites the abending agent was connected to by
and an SVC dump is requested at the site of the DB2
examining the DSNL027 and DSNL028 SYSLOG
abend.
console messages at the site of the DB2 abend. Obtain
Operator Response: Notify the system programmer. copies of the SYS1.LOGREC and SYSLOG data sets
from each connected site, the SVC dump at the site of
System Programmer Response: Determine which
the DB2 failure, and any related dumps from each
sites the abending agent was connected to by
connected site. If you suspect an error in DB2, refer to
examining the DSNL027 and DSNL028 SYSLOG
Part 2 of DB2 Diagnosis Guide and Reference for
console messages at the site of the DB2 abend. Obtain
information on identifying and reporting the problem.
copies of the SYS1.LOGREC and SYSLOG data sets
from each connected site, the SVC dump at the site of Problem Determination: Collect the following
the DB2 failure, and any related dumps from each diagnostic items listed in “Appendix B. Problem
connected site. determination” on page 1281: 56, 57.
If you suspect an error in DB2, refer to Part 2 of DB2
Diagnosis Guide and Reference for information on 00D30004
identifying and reporting the problem.
Explanation: A database access agent received an
Problem Determination: Collect the following invalid message. This is a DB2 internal error.
diagnostic items listed in “Appendix B. Problem
This abend reason code is issued by the following
determination” on page 1281: 56, 57.
CSECTs:
© Copyright IBM Corp. 1982, 2001 847
00D30005 • 00D3000A
DSNLABRT DSNLPREP DSNLRUSE DSNLTMRR System Programmer Response: Determine which
sites the abending agent was connected to by
examining the DSNL027 and DSNL028 SYSLOG
System Action: A record is written to SYS1.LOGREC console messages at the site of the DB2 abend. Obtain
and an SVC dump is requested at the site of the DB2 copies of the SYS1.LOGREC and SYSLOG data sets
abend. from each connected site, the SVC dump at the site of
Operator Response: Notify the system programmer. the DB2 failure, and any related dumps from each
connected site. Refer to Part 2 of DB2 Diagnosis Guide
System Programmer Response: Determine which and Reference for information on identifying and
sites the abending agent was connected to by reporting the problem.
examining the DSNL027 and DSNL028 SYSLOG
console messages at the site of the DB2 abend. Obtain Problem Determination: Collect the following
copies of the SYS1.LOGREC and SYSLOG data sets diagnostic items listed in “Appendix B. Problem
from each connected site, the SVC dump at the site of determination” on page 1281: 56, 57.
the DB2 failure, and any related dumps from each
connected site. Refer to Part 2 of DB2 Diagnosis Guide 00D30009
and Reference for information on identifying and
reporting the problem. Explanation: During allocation of a database access
agent, simultaneous use of an APLE was attempted. An
Problem Determination: Collect the following APLE can be used once during allocation of a database
diagnostic items listed in “Appendix B. Problem access agent. This is a DB2 internal error.
determination” on page 1281: 56, 57.
This abend reason code is issued by the following
CSECT: DSNLTMRA
00D30005
System Action: A record is written to SYS1.LOGREC
Explanation: DB2 detected a failure while retrying and an SVC dump is requested at the site of the DB2
DB2 recovery. abend.
This abend reason code is issued by the following Operator Response: Notify the system programmer.
CSECT: DSNLFRCV
System Programmer Response: Determine which
System Action: DB2 abends after it writes a sites the abending agent was connected to by
SYS1.LOGREC record and requests a SVC dump. examining the DSNL027 and DSNL028 SYSLOG
Operator Response: Notify the system programmer. console messages at the site of the DB2 abend. Obtain
copies of the SYS1.LOGREC and SYSLOG data sets
System Programmer Response: This is a DB2 from each connected site, the SVC dump at the site of
internal error. Obtain a copy of the SYS1.LOGREC the DB2 failure, and any related dumps from each
listing and the SVC dump. Determine the failing connected site. Refer to Part 2 of DB2 Diagnosis Guide
environment (DB2, IMS, CICS, or TSO). Refer to Part 2 and Reference for information on identifying and
of DB2 Diagnosis Guide and Reference for information reporting the problem.
on identifying and reporting the problem.
Problem Determination: Collect the following
Problem Determination: A distributed data facility diagnostic items listed in “Appendix B. Problem
(DDF) module retried recovery after an abend, but determination” on page 1281: 56, 57.
invalidly returned control to the DDF functional recovery
routine (DSNLFRCV) that issued the abend.
00D3000A
Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1, Explanation: DB2 invoked the DSNLTDSC macro or a
2, 5. function of the distributed transaction manager (DTM).
The required function could not be performed because
the DPSB control block does not exist. This is a DB2
00D30008 internal error.
Explanation: The distributed transaction manager This abend reason code is issued by the following
(DTM) could not allocate a RALE for the distributed data CSECTs:
facility (DDF). This is a DB2 internal error.
DSNLBABR DSNLCMT1 DSNLDALB DSNLTGBK
This abend reason code is issued by the following DSNLTMIG DSNLTRNA
CSECTs: DSNLARALDSNLTACCDSNLTMRA
System Action: A record is written to SYS1.LOGREC System Action: DB2 writes a SYS1.LOGREC record
and an SVC dump is requested at the site of the DB2 and requests a SVC dump. The execution unit
abend. abnormally terminates.
Operator Response: Notify the system programmer.
848 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D3000B • 00D3000E
Operator Response: Notify the system programmer. System Programmer Response: Determine which
sites the abending agent was connected to by
System Programmer Response: Obtain a copy of the
examining the DSNL027 and DSNL028 SYSLOG
SYS1.LOGREC listing and the SVC dump. Determine
console messages at the site of the DB2 abend. Obtain
the failing environment (DB2, IMS, CICS, or TSO).
copies of the SYS1.LOGREC and SYSLOG data sets
Refer to Part 2 of DB2 Diagnosis Guide and Reference
from each connected site, the SVC dump at the site of
for information on identifying and reporting the problem.
the DB2 failure, and any related dumps from each
Problem Determination: DB2 detects this error when connected site. Refer to Part 2 of DB2 Diagnosis Guide
the module that abnormally terminated is invoked and and Reference for information on identifying and
determines that the existence of the DDF agent local reporting the problem.
anchor block (DPSB) is not indicated by the DDF RALE
Problem Determination: Collect the following
or is not indicated by the ACE.
diagnostic items listed in “Appendix B. Problem
Collect the following diagnostic items listed in determination” on page 1281: 56, 57.
“Appendix B. Problem determination” on page 1281: 1,
2, 5
00D3000D
Explanation: A request using application-directed
00D3000B
access starting at site 'A' referenced an object at site 'B'
Explanation: A function of the distributed transaction that is stored at site 'A'.
manager (DTM) was invoked and attempted to establish
This abend reason code is issued by the following
a functional recovery environment. The functional
CSECT: DSNLTMIG
recovery element (FRE) that was created was not the
first one on the chain of FREs anchored in the DPSB. System Action: The application statement was not
This is a DB2 internal error. processed.
This abend reason code is issued by the following User Response: Recode the application to remove
CSECTs: DSNLAGNT, DSNLCMT1. the alias reference at the remote server that resolves to
an object stored at the local DB2. Objects stored at the
System Action: A record is written to SYS1.LOGREC
local site must be referenced using a local name.
and an SVC dump is requested at the site of the DB2
abend. Problem Determination: If necessary, consult with the
data base administrators at the local site and the
Operator Response: Notify the system programmer.
remote server location. Inspect the remote
System Programmer Response: Determine which SYSIBM.SYSTABLES catalog table to determine the
sites the abending agent was connected to by object at this location being referenced in a circular
examining the DSNL027 and DSNL028 SYSLOG manner.
console messages at the site of the DB2 abend. Obtain
copies of the SYS1.LOGREC and SYSLOG data sets
00D3000E
from each connected site, the SVC dump at the site of
the DB2 failure, and any related dumps from each Explanation: The DSNLFTMB macro was invoked to
connected site. Refer to Part 2 of DB2 Diagnosis Guide determine whether an update request was sent to a
and Reference for information on identifying and specified location, but the transaction has not yet been
reporting the problem. migrated to that location. This is a DB2 internal error.
Problem Determination: Collect the following System Action: A record is written to SYS1.LOGREC
diagnostic items listed in “Appendix B. Problem and an SVC dump is requested at the site of the DB2
determination” on page 1281: 56, 57. abend.
Operator Response: Notify the system programmer.
00D3000C
System Programmer Response: Determine which
Explanation: The location name received in a sites the abending agent was connected to by
response message from a responding site disagrees examining the DSNL027 and DSNL028 SYSLOG
with the location name to which the request message console messages at the site of the DB2 abend. Obtain
was sent. This is a DB2 internal error. copies of the SYS1.LOGREC and SYSLOG data sets
from each connected site, the SVC dump at the site of
This abend reason code is issued by the following
the DB2 failure, and any related dumps from each
CSECT: DSNLCMT1
connected site. Refer to Part 2 of DB2 Diagnosis Guide
System Action: A record is written to SYS1.LOGREC and Reference for information on identifying and
and an SVC dump is requested at the site of the DB2 reporting the problem.
abend.
Problem Determination: Collect the following
Operator Response: Notify the system programmer. diagnostic items listed in “Appendix B. Problem
Chapter 39. DB2 Codes 849
00D3000F • 00D30013
determination” on page 1281: 56, 57.
00D30011
Explanation: Only a certain number of resource
00D3000F
managers can participate in the allocation of a database
Explanation: A DB2 resource manager attempted to access agent at a remote site. The maximum has been
add a duplicate entry to the list of resource managers. attained and cannot be extended. This is a DB2 internal
This list contains the names of resource managers that error.
can participate in the allocation of a database access
This abend reason code is issued by the following
agent at a remote site. This is a DB2 error.
CSECT: DSNLADRA
This abend reason code is issued by the following
System Action: DB2 writes a SYS1.LOGREC record
CSECT: DSNLADRA
and requests a SVC dump. The execution unit abends.
System Action: DB2 writes a SYS1.LOGREC record
Operator Response: Notify the system programmer.
and requests a SVC dump. The execution unit abends.
System Programmer Response: Obtain a copy of the
Operator Response: Notify the system programmer.
SYS1.LOGREC listing and the SVC dump. Determine
System Programmer Response: Obtain a copy of the the failing environment (DB2, IMS, CICS, or TSO).
SYS1.LOGREC listing and the SVC dump. Determine Refer to Part 2 of DB2 Diagnosis Guide and Reference
the failing environment (DB2, IMS, CICS, or TSO). If for information on identifying and reporting the problem.
you suspect an error in DB2, refer to Part 2 of DB2
Problem Determination: Collect the following
Diagnosis Guide and Reference for information on
diagnostic items listed in “Appendix B. Problem
identifying and reporting the problem.
determination” on page 1281: 1, 2, 5.
Problem Determination: The module that incorrectly
invoked this function also invoked DSNLADRA.
00D30012
Collect the following diagnostic items listed in
Explanation: More than one resource manager
“Appendix B. Problem determination” on page 1281: 1,
attempted to reserve the same RALE for use in the
2, 5.
allocation of a database access agent at a remote site.
This is a DB2 internal error.
00D30010
This abend reason code is issued by the following
Explanation: A DB2 resource manager attempted to CSECT: DSNLTMIG
delete a resource manager that is not given in the list of
System Action: DB2 writes a SYS1.LOGREC record
resource managers that participate in the allocation of a
and requests a SVC dump. The execution unit abends.
database access agent at a remote site. This is a DB2
internal error. Operator Response: Notify the system programmer.
This abend reason code is issued by the following System Programmer Response: Obtain a copy of the
CSECT: DSNLADRA SYS1.LOGREC listing and the SVC dump. Determine
the failing environment (DB2, IMS, CICS, or TSO).
System Action: DB2 writes a SYS1.LOGREC record
Refer to Part 2 of DB2 Diagnosis Guide and Reference
and requests a SVC dump. The execution unit abends.
for information on identifying and reporting the problem.
Operator Response: Notify the system programmer.
Problem Determination: The RALE was previously
System Programmer Response: Obtain a copy of the reserved by another resource manager and is not
SYS1.LOGREC listing and the SVC dump. Determine available.
the failing environment (DB2, IMS, CICS, or TSO).
Collect the following diagnostic items listed in
Refer to Part 2 of DB2 Diagnosis Guide and Reference
“Appendix B. Problem determination” on page 1281: 1,
for information on identifying and reporting the problem.
2, 5.
Problem Determination: This module which
incorrectly invoked this function also invoked
00D30013
DSNLADRA.
Explanation: The facility section (DSN6FAC) in the
Collect the following diagnostic items listed in
DB2 initialization parameter module does not exist.
“Appendix B. Problem determination” on page 1281: 1,
2, 5. This abend reason code is issued by the following
CSECT: DSNLSSRW
System Action: DB2 writes a SYS1.LOGREC record
and requests a SVC dump. The distributed data facility
is terminated.
850 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D30014 • 00D30019
Operator Response: Notify the system programmer.
00D30016
System Programmer Response: This is probably an
Explanation: An allied agent received an invalid
installation error. Obtain a listing of the DSNZPARM
response. This is a DB2 internal error.
module used.
This abend reason code is issued by the following
Problem Determination: Ensure that DSN6FAC was
CSECT: DSNLCMT1
installed correctly.
System Action: A record is written to SYS1.LOGREC
and an SVC dump is requested at the site of the DB2
00D30014
abend.
Explanation: The distributed transaction manager
Operator Response: Notify the system programmer.
(DTM) detected an internal error. This is a DB2 internal
error. System Programmer Response: Determine which
sites the abending agent was connected to by
This abend reason code is issued by the following
examining the DSNL027 and DSNL028 SYSLOG
CSECTs:
console messages at the site of the DB2 abend. Obtain
DSNLATRN DSNLBABR DSNLCMT1 DSNLEDDA copies of the SYS1.LOGREC and SYSLOG data sets
DSNLEDPE DSNLEDTS DSNLITRC DSNLPREP from each connected site, the SVC dump at the site of
DSNLSSAB DSNLSSBP DSNLSSRC DSNLTAC1 the DB2 failure, and any related dumps from each
DSNLTCM1 DSNLTEXC DSNLTGBK DSNLTXAC connected site. Refer to Part 2 of DB2 Diagnosis Guide
DSNLMTOK DSNLTMRA and Reference for information on identifying and
reporting the problem.
System Action: A record is written to SYS1.LOGREC Problem Determination: Collect the following
and an SVC dump is requested at the site of the DB2 diagnostic items listed in “Appendix B. Problem
abend. determination” on page 1281: 56, 57.
Operator Response: Notify the system programmer.
00D30018
System Programmer Response: Determine which
sites the abending agent was connected to by Explanation: An agent exists at the site at which the
examining the DSNL027 and DSNL028 SYSLOG abend occurred, but an agent that should exist at
console messages at the site of the DB2 abend. Obtain another site does not exist at that site. This is probably
copies of the SYS1.LOGREC and SYSLOG data sets a DB2 internal error.
from each connected site, the SVC dump at the site of System Action: DB2 writes a SYS1.LOGREC record
the DB2 failure, and any related dumps from each and requests a SVC dump. The execution unit abends.
connected site. Refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and Operator Response: Notify the system programmer.
reporting the problem. System Programmer Response: Obtain a copy of the
Problem Determination: Collect the following SYS1.LOGREC listing and the SVC dump. Determine
diagnostic items listed in “Appendix B. Problem the failing environment (DB2, IMS, CICS, or TSO).
determination” on page 1281: 56, 57. Refer to Part 2 of DB2 Diagnosis Guide and Reference
for information on identifying and reporting the problem.
00D30015 Problem Determination: The distributed data facility
(DDF) error monitor, which terminates the agent that is
Explanation: The facility section (DSN6FAC) in the waiting for some action to be taken by the nonexistent
DB2 initialization parameter module is invalid. agent, detects this error. The module that was waiting
This abend reason code is issued by the following for the action of the nonexistent agent is the module
CSECT: DSNLSSRW that issued the abend.
System Action: DB2 writes a SYS1.LOGREC record Collect the following diagnostic items listed in
and requests a SVC dump. The distributed data facility “Appendix B. Problem determination” on page 1281: 1,
(DDF) is terminated. 2, 5.
Operator Response: Notify the system programmer.
00D30019
System Programmer Response: This is probably an
installation error. Obtain a listing of the DSNZPARM Explanation: The distributed data facility (DDF) error
module used. monitor detected an error at another site which caused
the agent at this site to be canceled. This is probably a
Problem Determination: Ensure that DSN6FAC was DB2 internal error.
installed correctly.
System Action: DB2 writes a SYS1.LOGREC record
Chapter 39. DB2 Codes 851
00D3001A • 00D3001C
and requests a SVC dump. The execution unit abends. When the USERNAMES column in SYSIBM.LUNAMES
specifies 'I' or 'B', requiring inbound name translation,
Operator Response: Notify the system programmer.
the SYSIBM.USERNAMES table must contain entries
System Programmer Response: Obtain a copy of the describing which DB2 authorization IDs are to be used
SYS1.LOGREC listing and the SVC dump. Determine for each remote authorization ID from the LU.
the failing environment (DB2, IMS, CICS, or TSO).
This abend reason code is issued by the following
Refer to Part 2 of DB2 Diagnosis Guide and Reference
CSECTs: DSNLTACC, DSNLTMRA.
for information on identifying and reporting the problem.
System Action: The DSNL030I message is issued at
Problem Determination: The DDF error monitor,
the server. The database access agent is not allocated.
which terminates the agent because of an error
detected at another site to which the agent is connected Operator Response: Notify the communications
and for which the agent is waiting, detected this error. database administrator
The module that was suspended to wait for the action to
System Programmer Response: Make sure the
be taken at the other site is the module that issued the
USERNAMES column in SYSIBM.LUNAMES has been
abend.
specified correctly for the indicated LUNAME. If you
Collect the following diagnostic items listed in intend to use remote authorization IDs that differ from
“Appendix B. Problem determination” on page 1281: 1, DB2 authorization IDs, verify that the
2, 5. SYSIBM.USERNAMES table has rows that correctly
specify the DB2 authorization IDs to be used for each
possible remote authorization ID.
00D3001A
Problem Determination: Analyze the
Explanation: A CANCEL THREAD or CANCEL DDF
SYSIBM.USERNAMES table for an incorrect or missing
THREAD command naming a distributed thread caused
entry.
the thread to be terminated. A dump is provided for
diagnostic purposes as a result of the CANCEL
command DUMP keyword. 00D3001C
System Action: DB2 writes a SYS1.LOGREC record Explanation: The database access request from a
and requests an SVC dump. The execution unit abends. remote site failed because the SYSIBM.USERNAMES
If the canceled distributed thread is an allied thread, table did not contain an inbound row, the TYPE column
DB2 requests the cancelation of each associated specified as an 'I' describing what DB2 authorization ID
database access thread at each of the server sites to be used for the remote new user primary
(refer to the explanation for 00D30000). authorization ID. When the USERNAMES column in
SYSIBM.LUNAMES specifies 'I' or 'B' requiring inbound
Operator Response: Notify the system programmer.
name translation, the SYSIBM.USERNAMES table must
System Programmer Response: The command contain entries describing which DB2 authorization IDs
might have been used to terminate a thread that was in are to be used for each remote authorization ID from
a state where no processing was occurring and the the LU.
thread could not continue.
This abend reason code is issued by the following
If you suspect an internal DB2 error, obtain a copy of CSECTs: DSNLRUSE, DSNLTEXC.
the SYS1.LOGREC listing and the SVC dump.
System Action: The DSNL030I message is issued at
Determine the failing environment (DB2, IMS, CICS, or
the server. The database access agent is not allocated.
TSO). Refer to Part 2 of DB2 Diagnosis Guide and
Reference for information on identifying and reporting Operator Response: Notify the communications
the problem. database administrator.
Problem Determination: Collect the following System Programmer Response: Make sure the
diagnostic items listed in “Appendix B. Problem USERNAMES column in SYSIBM.LUNAMES has been
determination” on page 1281 1, 2, 5. specified correctly for the indicated LUNAME. If you
intend to use remote authorization IDs that differ from
The module that was suspended while waiting for some
the DB2 authorization IDs, verify that the
action to be taken is the module that issued the abend.
SYSIBM.USERNAMES table has rows that correctly
specify the DB2 authorization IDs to be used for each
00D3001B possible remote authorization ID.
Explanation: The database access request from a Problem Determination: Analyze the
remote site failed because the SYSIBM.USERNAMES SYSIBM.USERNAMES table for an incorrect or missing
table did not contain an inbound row, the TYPE column entry.
specified as an 'I' describing what DB2 authorization ID
to be used for the remote primary authorization ID.
852 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D3001D • 00D30020
ACCRDBRM reply require data type and/or code page
00D3001D
translations that cannot be supported by the local DB2.
Explanation: The database access request from a The local DB2 has disconnected the conversation with
remote site failed because the SYSIBM.USERNAMES the remote server. DB2 requests neither a SVC dump
table did not contain an inbound row, the TYPE column nor a SYS1.LOGREC record.
specified as an 'I' describing what DB2 authorization ID
User Response: Notify the system programmer.
to be used for the remote plan owner authorization ID.
Invoke the application after the problem has been
When the USERNAMES column in SYSIBM.LUNAMES
corrected.
specifies 'I' or 'B', requiring inbound name translation,
the SYSIBM.USERNAMES table must contain entries System Programmer Response: If you suspect an
describing which DB2 authorization IDs are to be used error in DB2, refer to Part 2 of DB2 Diagnosis Guide
for each remote authorization ID from the LU. and Reference for information on identifying and
reporting the problem. Notify the system programmer at
This reason code is issued by the following CSECT:
the remote location that the remote server may not be
DSNLTMRA
usable.
System Action: The DSNL030I message is issued at
Problem Determination: Determine the server being
the server. The database access agent is not allocated.
accessed by examining the SQLCODE -30041 message
Operator Response: Notify the communications text. Refer also to the DDM documentation of the
database administrator. ACCRDB command and the ACCRDBRM reply
message.
System Programmer Response: Make sure the
USERNAMES column in SYSIBM.LUNAMES has been
specified correctly for the indicated LUNAME. If you 00D30020
intend to use remote authorization IDs that differ from
Explanation: The processing of the CONNECT
the DB2 authorization IDs, verify that the
statement at a remote server has failed. This is because
SYSIBM.USERNAMES table has rows that correctly
acceptable CONNECT information was not conveyed in
specify the DB2 authorization IDs to be used for each
the distributed relational database architecture (DRDA)
possible remote authorization ID.
EXCSAT command sent by the local DB2 to the remote
Problem Determination: Analyze the server.
SYSIBM.USERNAMES table for an incorrect or missing
This reason code is issued by the following CSECT:
entry.
DSNLTEXC
System Action: The remote server database access
00D3001E
agent (DBAA) sends a DRDA reply message (for
Explanation: The SYSTEM PARAMETER section example, MGRLVLRM) to the local DB2 which indicates
(DSN6SYSP) in the DB2 installation parameter module the specific nature of the problem. The above reason
does not exist. code is sent in the server diagnosis area of the reply
message. The DBAA awaits further DRDA commands
This abend reason code is issued by the following
from the local DB2.
CSECT: DSNLTMIN
User Response: The SQLCA returned in response to
System Action: A record is written to SYS1.LOGREC,
the CONNECT statement indicates what DRDA reply
and an SVC dump is requested. DDF is terminated.
message was sent by the remote server. The user
Operator Response: Notify the system programmer. should contact the local DB2 system administrator with
this information.
System Programmer Response: This is probably an
installation error. Obtain a listing of the DSNZPARM Operator Response: Operator will not detect this
module used. problem.
Problem Determination: Ensure that DSN6SYSP was System Programmer Response: If you suspect an
installed correctly. error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and
reporting the problem.
00D3001F
Problem Determination: This represents a DRDA
Explanation: ACCRDBRM received from the remote configuration mismatch between the local DB2 and the
server indicates incompatible server. remote server. The precise mismatch is determined
This abend reason code is issued by the following from the reply message sent from the remote server to
CSECT: DSNLTAC1 the local DB2. The reply message may be determined
by examining the SQLCODE and the SQLCA tokens
System Action: The TYPDEFNAM or TYPDEFOVR returned for the CONNECT statement.
values returned from the remote server in the DDM
The remote server and local DB2 system administrators
Chapter 39. DB2 Codes 853
00D30021 • 00D30022
should consult together to determine if this is a system v The local DB2 product is not recognized/supported by
configuration error, or if an internal error exists at either the remote server.
the local DB2 or remote server.
The system administrators for the two locations should
Collect the following diagnostic items listed in
consult together to determine if this is a system
“Appendix B. Problem determination” on page 1281: 1,
configuration error or if an internal error exists at either
5.
location.
Collect the following local DB2 diagnostic items:
v Application source code and runtime listing. Collect the following diagnostic items at the remote
server:
v Relevant error and system logs spanning the time of
the failure. v Console output from the system on which the job was
run and a listing of SYSLOG data set for the period
of time spanning the failure.
00D30021
v Listing of SYS1.LOGREC data set obtained by
Explanation: The processing of the CONNECT executing IFCEREP1.
statement at a DB2 remote server has failed. This is v The system CCSIDs.
because acceptable CONNECT information was not
conveyed in the distributed relational database Collect the following diagnostic items at the local DB2:
architecture (DRDA) ACCRDB command sent by the
local DB2 to the remote server. v Application source code and runtime listing.
v Relevant error and system logs spanning the time of
This reason code is issued by the following CSECT: the failure.
DSNLTACC
v The system CCSIDs.
System Action: The remote server database access
agent (DBAA) sends a DRDA reply message (for
example, VALNSPRM) to the local DB2 which indicates 00D30022
the specific nature of the problem. The above reason Explanation: The processing of the CONNECT
code is sent in the server diagnosis area of the reply statement at the remote server has failed and the local
message. The DBAA awaits further DRDA commands DB2 Data Base Access Agent (DBAA) has been
from the local DB2. abended. This is because authorization checking has
User Response: The SQLCA returned in response to failed at the remote server.
the CONNECT statement indicates what DRDA reply This abend reason code is issued by the following
message was sent by the remote server. The user CSECTs: DSNLTACC DSNLTEXC
should contact the local DB2 system administrator with
this information. System Action: The conversation with the local DB2
is terminated by the remote server with an LU6.2 SNA
Operator Response: Operator will not detect this sense code. The DBAA is abended. A DSNL030I
problem. message is written to the MVS console at the remote
System Programmer Response: If you suspect an server, and an alert is generated.
error in DB2, refer to Part 2 of DB2 Diagnosis Guide Operator Response: Notify the system programmer.
and Reference for information on identifying and
reporting the problem. System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
Problem Determination: This represents a DRDA and Reference for information on identifying and
configuration mismatch between the local DB2 and the reporting the problem.
remote server. The precise mismatch is determined
from the reply message sent from the DB2 remote Problem Determination: Either the user does not
server to the local DB2. The reply message may be have the proper authority to execute at the remote
determined by examining the SQLCODE and the server, or there is a security configuration mismatch
SQLCA tokens returned for the CONNECT statement. It between the local DB2 and the remote server. Examine
could indicate any one of the following problems (but is the DSNL030I message or the alert for a more specific
not limited to these): reason code describing the failure. Consult with the two
system administrators if necessary to fix the problem.
v The EXCSAT command was not successfully
No dump is generated for this abend.
processed prior to receipt of the ACCRDB command.
v The TYPDEFNAM parameter (specifies local DB2 Collect the following diagnostic items listed in
data types) in the ACCRDB command is not “Appendix B. Problem determination” on page 1281: 1,
supported. 5.
v The TYPDEFOVR parameter (specifies local DB2
CCSIDs) in the ACCRDB command is not supported.
854 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D3002D • 00D30030
Problem Determination: Collect the following
00D3002D
diagnostic items listed in “Appendix B. Problem
Explanation: The remote server was not successfully determination” on page 1281: 56, 57.
connected. The SYSIBM.USERNAMES table did not
contain an outbound row, the TYPE column specified as
00D3002F
an 'O' describing the remote authorization identifier to
be used for the plan owner DB2 authorization ID. When Explanation: An unrecognized function request was
the USERNAMES column in SYSIBM.LUNAMES detected during resynchronization. This is an internal
specifies 'O' or 'B' requiring outbound name translation, error.
the SYSIBM.USERNAMES table must contain entries
describing the remote authorization IDs to be used for This abend reason code is issued by the following
each DB2 authorization ID communicating with the LU. CSECTs:
This abend reason code is issued by the following DSNLTRD DSNLTRE DSNLTRLS DSNLTRTR
CSECTs: DSNLTXAC DSNLTMIG
System Action: A resource unavailable is returned to System Action: A record is written to SYS1.LOGREC
the application. The request is not sent to the remote and an SVC dump is requested at the site of the DB2
site. abend.
Operator Response: Notify the communications Operator Response: Notify the system programmer.
database administrator.
System Programmer Response: Determine the sites
System Programmer Response: Make sure the to which the abending agent was connected by
USERNAMES column in SYSIBM.LUNAMES has been examining the DSNL027 and DSNL028 SYSLOG
specified correctly for the indicated LUNAME. If you console messages at the site of the DB2 abend. Obtain
intend to use remote authorization IDs that differ from copies of the SYS1.LOGREC and SYSLOG data sets
DB2 authorization IDs, verify that the from each connected site, the SVC dump at the site of
SYSIBM.USERNAMES table has rows that correctly the DB2 failure, and any related dumps from each
specify the remote authorization ID to be used for each connected site.
possible DB2 authorization ID.
Refer to Part 2 of DB2 Diagnosis Guide and Reference
Problem Determination: Analyze the for information on identifying and reporting the problem.
SYSIBM.USERNAMES table for an incorrect or missing
Problem Determination: Collect the following
entry.
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57.
00D3002E
Explanation: No resync list entry exists during 00D30030
resynchronization when one is expected to exist. This is
Explanation: This site is not considered a coordinator
an internal error.
or participant during resynchronization. This is an
This abend reason code is issued by the following internal error.
CSECTs:
This abend reason code is issued by the following
DSNLTRLA DSNLTRLO DSNLTRPA DSNLTRPN CSECTs:
DSNLTRRH
DSNLTRE DSNLTRLO DSNLTRPV DSNLTRVS
System Action: A record is written to SYS1.LOGREC
System Action: A record is written to SYS1.LOGREC
and an SVC dump is requested at the site of the DB2
and an SVC dump is requested at the site of the DB2
abend.
abend.
Operator Response: Notify the system programmer.
Operator Response: Notify the system programmer.
System Programmer Response: Determine the sites
System Programmer Response: Determine the sites
to which the abending agent was connected by
to which the abending agent was connected by
examining the DSNL027 and DSNL028 SYSLOG
examining the DSNL027 and DSNL028 SYSLOG
console messages at the site of the DB2 abend. Obtain
console messages at the site of the DB2 abend. Obtain
copies of the SYS1.LOGREC and SYSLOG data sets
copies of the SYS1.LOGREC and SYSLOG data sets
from each connected site, the SVC dump at the site of
from each connected site, the SVC dump at the site of
the DB2 failure, and any related dumps from each
the DB2 failure, and any related dumps from each
connected site.
connected site.
Refer to Part 2 of DB2 Diagnosis Guide and Reference
Refer to Part 2 of DB2 Diagnosis Guide and Reference
for information on identifying and reporting the problem.
Chapter 39. DB2 Codes 855
00D30031 • 00D30034
for information on identifying and reporting the problem. Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
Problem Determination: Collect the following
determination” on page 1281: 56, 57.
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57.
00D30033
00D30031 Explanation: This site is invalidly an initiator of
resynchronization. This is an internal error.
Explanation: An unknown 2-phase COMMIT protocol
is being used during resynchronization. This is an This abend reason code is issued by the following
internal error. CSECT: DSNLTRPN
This abend reason code is issued by the following System Action: A record is written to SYS1.LOGREC
CSECTs: DSNLTRLO DSNLTRVS and an SVC dump is requested at the site of the DB2
abend.
System Action: A record is written to SYS1.LOGREC
and an SVC dump is requested at the site of the DB2 Operator Response: Notify the system programmer.
abend.
System Programmer Response: Determine the sites
Operator Response: Notify the system programmer. to which the abending agent was connected by
examining the DSNL027 and DSNL028 SYSLOG
System Programmer Response: Determine the sites
console messages at the site of the DB2 abend. Obtain
to which the abending agent was connected by
copies of the SYS1.LOGREC and SYSLOG data sets
examining the DSNL027 and DSNL028 SYSLOG
from each connected site, the SVC dump at the site of
console messages at the site of the DB2 abend. Obtain
the DB2 failure, and any related dumps from each
copies of the SYS1.LOGREC and SYSLOG data sets
connected site.
from each connected site, the SVC dump at the site of
the DB2 failure, and any related dumps from each Refer to Part 2 of DB2 Diagnosis Guide and Reference
connected site. for information on identifying and reporting the problem.
Refer to Part 2 of DB2 Diagnosis Guide and Reference Problem Determination: Collect the following
for information on identifying and reporting the problem. diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57.
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57. 00D30034
Explanation: An INDOUBT resync list entry does not
00D30032 have the correct associated structures during
resynchronization. This is an internal error.
Explanation: This site is not considered either an
initiator or recipient of resynchronization. This is an This abend reason code is issued by the following
internal error. CSECTs: DSNLTRPA DSNLTRPN
This abend reason code is issued by the following System Action: A record is written to SYS1.LOGREC
CSECTs: and an SVC dump is requested at the site of the DB2
abend.
DSNLTRCN DSNLTRLA DSNLTRLN DSNLTRPA
DSNLTRPN Operator Response: Notify the system programmer.
System Programmer Response: Determine the sites
System Action: A record is written to SYS1.LOGREC to which the abending agent was connected by
and an SVC dump is requested at the site of the DB2 examining the DSNL027 and DSNL028 SYSLOG
abend. console messages at the site of the DB2 abend. Obtain
copies of the SYS1.LOGREC and SYSLOG data sets
Operator Response: Notify the system programmer. from each connected site, the SVC dump at the site of
System Programmer Response: Determine the sites the DB2 failure, and any related dumps from each
to which the abending agent was connected by connected site.
examining the DSNL027 and DSNL028 SYSLOG Refer to Part 2 of DB2 Diagnosis Guide and Reference
console messages at the site of the DB2 abend. Obtain for information on identifying and reporting the problem.
copies of the SYS1.LOGREC and SYSLOG data sets
from each connected site, the SVC dump at the site of Problem Determination: Collect the following
the DB2 failure, and any related dumps from each diagnostic items listed in “Appendix B. Problem
connected site. determination” on page 1281: 56, 57.
Refer to Part 2 of DB2 Diagnosis Guide and Reference
for information on identifying and reporting the problem.
856 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D30035 • 00D30038
00D30035 00D30037
Explanation: A resolved unit of work still has internal Explanation: The resync list latch is erroneously still
structures associated with it during resynchronization. being held during resynchronization. This is an internal
This is an internal error. error.
This abend reason code is issued by the following This abend reason code is issued by the following
CSECTs: DSNLTRPA DSNLTRPN CSECT: DSNLTRTR
System Action: A record is written to SYS1.LOGREC System Action: A record is written to SYS1.LOGREC
and an SVC dump is requested at the site of the DB2 and an SVC dump is requested at the site of the DB2
abend. abend.
Operator Response: Notify the system programmer. Operator Response: Notify the system programmer.
System Programmer Response: Determine the sites System Programmer Response: Determine the sites
to which the abending agent was connected by to which the abending agent was connected by
examining the DSNL027 and DSNL028 SYSLOG examining the DSNL027 and DSNL028 SYSLOG
console messages at the site of the DB2 abend. Obtain console messages at the site of the DB2 abend. Obtain
copies of the SYS1.LOGREC and SYSLOG data sets copies of the SYS1.LOGREC and SYSLOG data sets
from each connected site, the SVC dump at the site of from each connected site, the SVC dump at the site of
the DB2 failure, and any related dumps from each the DB2 failure, and any related dumps from each
connected site. connected site.
Refer to Part 2 of DB2 Diagnosis Guide and Reference Refer to Part 2 of DB2 Diagnosis Guide and Reference
for information on identifying and reporting the problem. for information on identifying and reporting the problem.
Problem Determination: Collect the following Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57. determination” on page 1281: 56, 57.
00D30036 00D30038
Explanation: Either the coordinator or participant has Explanation: The storage calculation for the amount
an invalid status during resynchronzation. This is an of storage needed for -DISPLAY THREAD is invalid.
internal error. This is an internal error.
This abend reason code is issued by the following This abend reason code is issued by the following
CSECTs: CSECT: DSNLTDTI
DSNLTRCA DSNLTRCN DSNLTRLA DSNLTRLN System Action: A record is written to SYS1.LOGREC
DSNLTRLO DSNLTRPA DSNLTRPN DSNLTRRA and an SVC dump is requested at the site of the DB2
abend.
System Action: A record is written to SYS1.LOGREC Operator Response: Notify the system programmer.
and an SVC dump is requested at the site of the DB2 System Programmer Response: Determine the sites
abend. to which the abending agent was connected by
Operator Response: Notify the system programmer. examining the DSNL027 and DSNL028 SYSLOG
console messages at the site of the DB2 abend. Obtain
System Programmer Response: Determine the sites copies of the SYS1.LOGREC and SYSLOG data sets
to which the abending agent was connected by from each connected site, the SVC dump at the site of
examining the DSNL027 and DSNL028 SYSLOG the DB2 failure, and any related dumps from each
console messages at the site of the DB2 abend. Obtain connected site.
copies of the SYS1.LOGREC and SYSLOG data sets
from each connected site, the SVC dump at the site of Refer to Part 2 of DB2 Diagnosis Guide and Reference
the DB2 failure, and any related dumps from each for information on identifying and reporting the problem.
connected site. Problem Determination: Collect the following
Refer to Part 2 of DB2 Diagnosis Guide and Reference diagnostic items listed in “Appendix B. Problem
for information on identifying and reporting the problem. determination” on page 1281: 56, 57.
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57.
Chapter 39. DB2 Codes 857
00D30039 • 00D3003B
00D30039 00D3003B
Explanation: A resync conversation is invalid. This is Explanation: A distributed thread was canceled
an internal error. because the timeout value in the DB2 startup
parameters module (usually DSNZPARM) was
This abend reason code is issued by the following
exceeded. This value is specified by the IDLE THREAD
CSECT: DSNLTRVR
TIMEOUT value in the DSNTIPR installation panel or
System Action: A record is written to SYS1.LOGREC the IDTHTOIN value in the DSN6FAC macro, which is
and an SVC dump is requested at the site of the DB2 used to build the DB2 start up parameters module.
abend.
System Action: The execution unit abends.
Operator Response: Notify the system programmer.
Operator Response: Notify the system programmer.
System Programmer Response: Determine the sites
System Programmer Response: The server thread
to which the abending agent was connected by
was holding DB2 resources and the requester
examining the DSNL027 and DSNL028 SYSLOG
application did not make a request to the DB2 server
console messages at the site of the DB2 abend. Obtain
thread for an extended period of time. The server thread
copies of the SYS1.LOGREC and SYSLOG data sets
is terminated in order to releases resources that might
from each connected site, the SVC dump at the site of
affect other threads.
the DB2 failure, and any related dumps from each
connected site. This usually occurs for one of these reasons:
Refer to Part 2 of DB2 Diagnosis Guide and Reference v The ACTIVE thread option was specified in the DDF
for information on identifying and reporting the problem. THREADS field of the DSNTIPR installation panel,
and a requester application or its user did not make a
Problem Determination: Collect the following request to the DB2 server for an extended period.
diagnostic items listed in “Appendix B. Problem This can happen, for example, during a lengthy end
determination” on page 1281: 56, 57. user absence. As a result, the server thread becomes
susceptible to being canceled because of the timeout
00D3003A value.
Determine why the requester application has not
Explanation: An error occurred during made a request to the DB2 server in the specified
resynchronization. This is an internal error. time. If the design or use of the application requires
This abend reason code is issued by the following additional time, increase the IDLE THREAD
CSECTs: TIMEOUT value or set it to zero to deactivate the
function.
DSNLTRCA DSNLTRCN DSNLTRE DSNLTRLA v The INACTIVE thread option was specified in the
DSNLTRLN DSNLTRPA DSNLTRPN DSNLTRPV DDF THREADS field of the DSNTIPR installation
DSNLTRRA panel, and a requester application or its user:
– Failed to commit before an extended dormant
System Action: A record is written to SYS1.LOGREC period (such as end user absence), or
and an SVC dump is requested at the site of the DB2 – Committed before an extended dormant period
abend. (such as end user absence), but database
Operator Response: Notify the system programmer. resources are still held because of other existing
conditions.
System Programmer Response: Determine the sites
to which the abending agent was connected by As a result, the server thread cannot be moved to the
examining the DSNL027 and DSNL028 SYSLOG inactive state and becomes susceptible to being
console messages at the site of the DB2 abend. Obtain canceled because of the timeout value.
copies of the SYS1.LOGREC and SYSLOG data sets
from each connected site, the SVC dump at the site of Determine why the server thread was not moved to
the DB2 failure, and any related dumps from each the inactive state. For information about active and
connected site. inactive threads, see the description of the DDF
Refer to Part 2 of DB2 Diagnosis Guide and Reference THREADS option of the DSNTIPR installation panel
for information on identifying and reporting the problem. in ″Planning and Installing DB2″ in Part 2 of DB2
Installation Guide. If the design or use of the
Problem Determination: Collect the following application requires additional time, increase the
diagnostic items listed in “Appendix B. Problem IDLE THREAD TIMEOUT value or set it to zero to
determination” on page 1281: 56, 57. deactivate the function.
Problem Determination: This abend reason code is
issued by the following CSECT: DSNLBABR
858 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D300F1 • 00D300F4
00D300F1 00D300F3
Explanation: The DSNLTOKS macro was invoked to Explanation: The remote server was not successfully
extract error information from the DTMF block using the connected. The SYSIBM.USERNAMES table did not
CHECK_SQLCODE keyword and the DTMF block was contain an outbound row, the TYPE column specified as
either uninitialized or contained an SQL return code that an 'O' describing the remote authorization identifier to
was not negative. This is a DB2 internal error. be used for the new user primary DB2 authorization ID.
When the USERNAMES column in SYSIBM.LUNAMES
System Action: A record is written to SYS1.LOGREC
specifies 'O' or 'B' requiring outbound name translation,
and an SVC dump is requested. The execution unit is
the SYSIBM.USERNAMES table must contain entries
abnormally terminated.
describing the remote authorization IDs to be used for
Operator Response: Notify the system programmer. each DB2 authorization ID communicating with the LU.
System Programmer Response: This is a DB2 This abend reason code is issued by the following
internal error. Obtain a copy of SYS1.LOGREC and the CSECTs: DSNLTMIG DSNLTXAC
SVC dump. Determine the failing environment (DB2,
System Action: A resource unavailable is returned to
IMS, CICS, or TSO). Refer to Part 2 of DB2 Diagnosis
the application. The request is not sent to the remote
Guide and Reference for information on identifying and
site.
reporting the problem.
Operator Response: Notify the communications
Problem Determination: This name of the module
database administrator.
that invoked the function given as the abending module
name. This is not the module in error. An earlier failing System Programmer Response: Make sure the
module neglected to report error information in the USERNAMES column in SYSIBM.LUNAMES has been
DTMF block. specified correctly for the indicated LUNAME. If you
intend to use remote authorization IDs that differ from
Collect the following diagnostic items listed in
DB2 authorization IDs, verify that the
“Appendix B. Problem determination” on page 1281: 1,
SYSIBM.USERNAMES table has rows that correctly
2, 5.
specify the remote authorization ID to be used for each
possible DB2 authorization ID.
00D300F2
Problem Determination: Analyze the
Explanation: EXCSATRD reply received from a SYSIBM.USERNAMES table for an incorrect or missing
remote server indicates an incompatible server. entry.
This abend reason code is issued by the following
CSECT: DSNLTEX1 00D300F4
System Action: The manager levels returned from the Explanation: A DRDA protocol error occurred. Either a
local DB2 in the DDM EXCSATRD reply were too low reply chain is broken but there is no DDM reply with a
for the local DB2 to support. The local DB2 has high enough severity to break the chain, or a message
disconnected the conversation with the remote server. chain is unbroken in spite of a high severity code, or a
DB2 requests neither an SVC dump nor a conversation expected to be available has been
SYS1.LOGREC record written. terminated. The problem, though detected by DB2, is
believed to have originated at the remote server. The
User Response: Notify the system programmer. server might not be a DB2 subsystem.
Invoke the application after the problem has been
corrected. This abend reason code is issued by the following
CSECTs:
System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide DSNLBABR DSNLCMT1 DSNLTAC1 DSNLTEX1
and Reference for information on identifying and DSNLTXAC
reporting the problem. Notify the system programmer at
the remote location that the remote server is not usable.
System Action: This reason code is returned to the
Problem Determination: Determine the server being application. A request message has likely been sent to
accessed by inspecting the SQLCODE -30041 message the remote site but the outcome is uncertain. A
text. Refer to the DDM documentation of the EXCSAT DSNL031I message may have been written to the
command. console. Refer to the description of this message for
more information. If this reason code is returned for an
SQL 'COMMIT' statement, determine if manual recovery
of the unit of work is necessary.
Operator Response: Notify the operator or systems
programmer for the remote server.
Chapter 39. DB2 Codes 859
00D300F5 • 00D300F9
System Programmer Response: Determine the
00D300F7
product type of the server. The DISPLAY THREAD
command may be used. Refer to the server products' Explanation: A DDM reply message was too big to fit
diagnostic recommendations. If the server DBMS is in the DTM reply buffer.
DB2, contact your IBM representative to report the
This abend reason code is issued by the following
problem and open an APAR.
CSECTs:
Problem Determination: The problem originated with
the remote server. Follow the diagnostic DSNLBABR DSNLCMT1 DSNLTAC1 DSNLTEX1
recommendations published for the server DBMS DSNLTXAC
product, which might not be DB2.
System Action: The requesting allied agent is
00D300F5 terminated. A SYS1.LOGREC record is written and an
SVC dump is requested at the local DB2.
Explanation: DDM command chaining is in use.
Operator Response: Notify the system programmer.
This reason code is issued by the following CSECT:
DSNLTXAC System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
System Action: The DTM module returns to its and Reference for information on identifying and
invoker with a return code = 4. reporting the problem.
Problem Determination: This error should never
00D300F6 occur. Write an APAR.
Explanation: A valid but unexpected DDM reply was Collect the following diagnostic items listed in
received from a remote server during a connect, “Appendix B. Problem determination” on page 1281: 1,
commit, or abort operation. For a connect, the expected 3, 5.
DDM reply is EXCSATRD (for EXCSAT command) or
ACCRDBRM (for ACCRDB command). For a commit or
abort, the expected DDM reply is ENDUOWRM. (The 00D300F8
DDM command for a commit is RDBCMM. For a Explanation: An attempt was made to access data at
rollback, it is RDBRLLBCK). a remote location which has been started in restricted
This reason code is issued by the following CSECTs: access mode. No remote access is allowed.
This abend reason code is issued by the following
DSNLBABR DSNLCMT1 DSNLTAC1 DSNLTEX1
CSECT: DSNLAGNT
System Action: The attempt to create the database
System Action: The local DB2 tried to access a
access thread is rejected.
remote server and the server replied with an
unexpected DDM answer. The remote server may have Operator Response: Notify the system programmer.
suffered permanent damage. The local DB2 may or may
not subsequently disconnect the conversation to the System Programmer Response: Determine the
server. This is an internal-only DDF reason code. The remote location where the remote data access was
local DB2 requests neither a SVC dump nor a attempted. Retry the request when the remote location
SYS1.LOGREC record. has been restarted in full access mode.
User Response: Contact the system programmer
00D300F9
System Programmer Response: If the SQLCA is
available, examine all fields in the SQLCA. Using this Explanation: The DB2 server was unable to allocate a
information, try to determine what DDM reply was database access agent since the maximum number
received. Contact the system programmer at the server allowed was zero (ZPARM MAXDBAT value was zero).
site with this information. This is probably a This abend reason code is issued by the following
programming error at the server database system, CSECT: DSNLAGNT
although it may be a DB2 error. The server database
system may have recorded diagnostic information for System Action: The DB2 server terminates the
the problem. If this is a DB2 error, write an APAR. conversation with a 084B6031 SNA sense code for
application-directed access and a 00D300F9 DB2 code
Problem Determination: Examine the SQL return for system-directed access. A DSNL030I message
code in the SQLCA. It should give further indication of containing this reason code is written to the MVS
the real cause. operator console at the DB2 server site.
System Programmer Response: At the server,
currently no data base access agents are allowed
860 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D300FA • 00D300FF
because the MAXDBAT value in the ZPARM is zero. If Invoke the application after the problem has been
access to this site from a remote site is desirable, corrected.
change the MAXDBAT parameter in ZPARM to the
System Programmer Response: If you suspect an
maximum number of database access agents desired.
error in DB2, refer to Part 2 of the DB2 Diagnosis Guide
Restart DB2 at the server. Notify the user to rerun the
and Reference for information on identifying and
application.
reporting the problem.
Problem Determination: Determine the resource
00D300FA
being allocated and correct the problem.
Explanation: You attempted a COMMIT statement for
a plan that specified ISOLATION (RR) and update
00D300FD
operations were performed either at the local site or at a
remote site. The COMMIT operation could not be Explanation: An attempt was made to disconnect a
performed because the COMMIT request could not be connection with a specified location, but the transaction
transmitted to a remote site where Repeatable Read has not yet been connected to that location. This is a
operations had been performed. DB2 internal error.
This abend reason code is issued by the following System Action: A record is written to SYS1.LOGREC
CSECT: DSNLCMT1 and an SVC dump is requested. The execution unit is
abnormally terminated.
System Action: All update operations were backed
out. Problem Determination: Obtain a copy of
SYS1.LOGREC and the SVC dump. Determine the
System Programmer Response: Determine why the
failing environment (DB2, IMS, CICS, or TSO). Refer to
COMMIT failed and retry the application.
Part 2 of DB2 Diagnosis Guide and Reference for
information on identifying and reporting the problem.
00D300FB
The name of the module that invoked the function
Explanation: A resource was not available during incorrectly is given as the abending module name.
database access agent allocation at a remote site.
Collect the following diagnostic items listed in
This abend reason code is issued by the following “Appendix B. Problem determination” on page 1281: 1,
CSECTs: DSNLTACC DSNLTMRA 2, 5.
System Action: The allocation of the database access
agent was unsuccessful. A 'resource not available' code 00D300FE
is returned to the user. DB2 requests neither a SVC
Explanation: You executed a COMMIT statement and
dump nor a SYS1.LOGREC record.
update operations were performed at a remote site. The
User Response: Notify the system programmer. success of the COMMIT operation could not be
Invoke the application after the problem has been determined because a failure occurred at the remote
corrected. site or in the communication link with the remote site
after the request to commit the operation had been
System Programmer Response: If you suspect an
transmitted.
error in DB2, refer to Part 2 of the DB2 Diagnosis Guide
and Reference for information on identifying and This abend reason code is issued by the following
reporting the problem. CSECT: DSNLCMT1
Problem Determination: Determine the name of the System Action: The remote updates have been
resource being allocated and correct the problem. committed or backed out, depending on when the error
occurred.
00D300FC User Response: After communication has been
reestablished with the remote site, use SQL to query
Explanation: You attempted to allocate a resource at
the updated data to determine whether the updates
a remote site using an invalid name.
were committed. If the updates were not committed,
This abend reason code is issued by the following rerun the application and perform the updates again.
CSECTs: DSNLTACC DSNLTMRA
System Action: The allocation of the database access 00D300FF
agent was unsuccessful. A 'resource not available' code
Explanation: You attempted a COMMIT statement and
is returned to the user. DB2 requests neither a SVC
update operations were performed at a remote site. The
dump nor a SYS1.LOGREC record. This reason code is
attempt failed.
returned only for system-directed access (DSNLTMRA).
User Response: Notify the system programmer.
Chapter 39. DB2 Codes 861
00D30100 • 00D30103
This abend reason code is issued by the following the updates have been backed out to the prior COMMIT
CSECT: DSNLCMT1 point.
System Action: The updates at the remote site have This reason code is issued by the following CSECT:
been backed out. DSNLCMT1
User Response: Rerun the application. System Action: All update operations were backed
out.
Problem Determination: Determine why the COMMIT
failed and retry the application. Operator Response: Notify the system programmer.
System Programmer Response: Restart DDF at the
00D30100 affected sites and rerun the application.
Explanation: A COMMIT statement was chained to a
set of commands sent to an remote server. The remote 00D30103
server stopped processing the chained commands
Explanation: This reason code may be returned for a
before it reached the COMMIT. COMMIT was NOT
failed distributed commit using DRDA protocols. It
performed.
indicates that commit has failed because an
This reason code is issued by the following CSECT: ABNUOWRM reply message was received from the
DSNLCMT1 server for a prior SQL statement, but an abort had not
been driven at the DB2 requester prior to this commit
System Action: Any updates performed within the
and after the receipt of the ABNUOWRM.
current unit of Work have been backed out.
An ABNUOWRM reply message is sent by the server
User Response: Notify the system programmer of the
when it has rolled back its unit-of-work in response to
failure.
an unusual situation at the server (for example,
After the problem causing the chain to be broken at the deadlock or operator intervention). When an
remote server is fixed, rerun the application and perform ABNUOWRM reply message is received by the
the updates again. requester, an abort must be driven at the requester to
synchronize the distributed systems. Until an abort is
Operator Response: Operator will not detect this driven, all subsequent SQL statements will receive an
problem. SQLCODE -906. After an abort is driven, further SQL
System Programmer Response: See “Problem statements will be accepted.
Determination” section below. This reason code is issued by the following CSECT:
Problem Determination: Collect the following DSNLCMT1
diagnostic items from the local DB2 system. System Action: The commit at the DB2 requester
v Listing of application program and output from fails.
application program.
User Response: Scan backwards in your application
v Console output and a listing of SYSLOG data set for for the first non -906 SQLCODE prior to the commit.
the period of time spanning the failure. This SQLCODE was returned with the ABNUOWRM
v Listing of SYS1.LOGREC data set, obtained by from the server system. Use the server product
executing IFCEREP1. reference manuals to determine and correct whatever
problem this SQLCODE represents on the server and
Consult with the remote server system programmer to rerun your application. This may involve contacting your
determine the cause of the error. system programmer if the situation at the Server cannot
be corrected or improved by changes to the application
The remote server system programmer may need to program.
collect the following remote server diagnostic items:
Operator Response: The operator will not detect this
v Relevant error and system logs spanning the time of problem.
the failure.
System Programmer Response: Determine the
v Any relevant remote server dumps.
cause of the problem represented by the SQLCODE
returned with the ABNUOWRM and if necessary, work
00D30101 with the system programmer at the server to resolve it.
If you suspect an error in DB2, refer to Part 2 of DB2
Explanation: A COMMIT was attempted but failed due Diagnosis Guide and Reference for information on
to a prior error. Communications to a remote site have identifying and reporting the problem.
been lost. The COMMIT operation cannot be performed
because the COMMIT request could not be transmitted Problem Determination: Collect the following
to a remote site. If the program has performed updates, diagnostic items:
862 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D30104 • 00D30106
v User’s application output, including SQLCAs returned console and trace data set with diagnostic information.
for each SQL statement. You will have to find an earlier occurrence of the same
problem to start diagnosing it.
00D30104
Once you have found the two DSNL031I messages,
Explanation: The unit-of-work disposition (commit or locate the IFCID 0191 and 0193 trace records written
rollback) received from a DRDA server is inconsistent for the problem by using the IFCID sequence numbers
with the command sent (commit or rollback), and the from the DSNL031I messages.
SQL code returned from the server. For example, if a
commit is sent to the server, and the reply message The IFCID 0193 trace record will document the nature
indicates the unit of work (UOW) was committed, but of the inconsistency (command sent, UOW disposition
the SQL code returned is negative, then this reason received, SQL return code received).
code will be contained in the alert sent to NetView.
This reason code is issued by the following CSECTs: The IFCID 0191 trace record will document the exact
DSNLCMT1 DSNLBABR. data stream returned from the Server. Use this
information to determine if the reply message from the
System Action: An alert is generated and sent to server was correctly converted into the UOW disposition
NetView. Two trace records, IFCID 0191 and IFCID and the SQL return code reported in the IFCID 0193
0193, may be written to the Statistics Class 4 trace, and record. If the data stream was correctly converted, then
two DSNL031I messages may be written to the console. the problem lies at the server and you should contact
The trace records and messages will not be written if the system programmer at the server and have him or
this error was previously detected within the last 5 her analyze the data stream produced by the server.
minutes. The Statistics Class 4 trace must be active for
the trace records to be written.
00D30105
An SQLCODE +30100, -30020, or -30030 is returned to
the application. An SQLCODE -30020 indicates a Explanation: A distributed commit has failed because
rollback was sent to the DRDA server, but a commit the allied agent was cancelled as a result of a STOP
unit-of-work disposition was received. An SQLCODE DDF MODE(FORCE) command during a previous
+30100 or -30030 conveys the unit-of-work disposition execution of DDF which has terminated. When an allied
reported by the server, and replaces the original SQL agent does not issue database requests for more than 2
return code sent by the server, which was not consistent minutes after a STOP DDF MODE(FORCE) command
with the UOW disposition. The original SQL return code is issued, DDF will come down without terminating the
and SQLSTATE returned by the server are saved as allied agent. The agent is cancelled when it makes its
tokens in the SQLCA. next request to DB2.
Operator Response: Notify the system programmer. This reason code is issued by the following CSECT:
DSNLCMT1
System Programmer Response: This is a DRDA
distributed protocol problem. Once the nature of the System Action: The commit operation is failed and
inconsistency is known, the server system programmer the agent is cancelled. The last unit of work was rolled
may have to be contacted to help resolve the problem. back at all server systems when the STOP DDF
If you suspect an error in DB2, refer to Part 2 of DB2 MODE(FORCE) command was processed.
Diagnosis Guide and Reference for information on User Response: Contact the operator to re-start DDF.
identifying and reporting the problem. After DDF is re-started, continue your application’s work
Problem Determination: Collect the following starting with the last unit of work that was rolled back.
diagnostic items: Operator Response: Re-start DDF.
v Listing of the user’s application program output,
including printouts of the SQLCAs received for all
00D30106
SQL statements.
v Console output from the system on which the job was Explanation: The result of a DRDA distributed commit
run, and a listing of SYSLOG data set for the period could not be determined because the reply message
of time spanning the failure. from the server either was invalid or could not be
deciphered.
v Listing of the Statistics Class 4 trace records for the
LUWID associated with the failing request. This reason code is issued by the following CSECT:
DSNLCMT1
If no DSNL031I messages were written at the same
System Action: An alert is generated and sent to
time as the alert, then scan the log backwards for
NetView. An IFCID 0191 trace record may be written to
previous DSNL031I messages. A DB2 filter function
the statistics class 4 trace, and a DSNL031I message
prohibits multiple occurrences of the same problem
may be written to the console. The trace record and
detected within a 5 minute period from flooding the
Chapter 39. DB2 Codes 863
00D30109 • 00D3010A
message will not be written if this error was previously
00D30109
detected within the last 5 minutes. The statistics class 4
trace must be active for the trace records to be written. Explanation: Phase 1 of a distributed commit failed.
One or more remote servers did one of the following:
The requester disconnects from the server system. The
v Voted NO
state of the unit of work at the server is unknown. It
v Voted heuristic mixed
may have been committed, or it may have been rolled
v Experienced a communications error
back. An SQLCA indicating the nature of the DRDA
v Made an error in their use of commit protocol
reply message distortion is given to the application.
User Response: Notify the system programmer. After This reason code is issued by the following CSECT:
the problem has been resolved, re-connect to the server DSNLCMT1
site to determine whether the last unit of work was
System Action: The commit fails. The unit of work is
committed or rolled back. Continue your application
backed out.
after correcting the server database (if necessary).
For communication errors, message DSNL406I is
Operator Response: Notify the system programmer
written to the system console, alert A006 is generated,
whenever a DSNL031I message is written to the MVS
and trace record IFCID 0209 is produced to record the
console.
server affected (LUWID of the unit of work, and other
System Programmer Response: This is a DRDA information).
distributed protocol problem. Once the nature of the
For protocol errors, message DSNL413I is written to the
problem is known, the server system programmer may
system console, alert A005 is generated, and trace
have to be contacted to help resolve the problem.
record IFCID 0208 is produced to describe the nature of
If you suspect an error in DB2, refer to Part 2 of DB2 each server’s protocol violation.
Diagnosis Guide and Reference for information on
User Response: Contact the DB2 systems
identifying and reporting the problem.
programmer. If the commit failed for other than a
Problem Determination: Collect the following commit protocol violation by a remote server, resubmit
diagnostic items: your application. Otherwise, wait for resolution of the
v Listing of the user’s application program output, protocol error.
including printouts of the SQLCAs received for all System Programmer Response: For protocol errors,
SQL statements. contact the system programmer for the remote site. The
v Console output from the system on which the job was invalid sync point message is recorded in the IFCID
run, and a listing of SYSLOG data set for the period 0208 trace record. The system logic error that causes
of time spanning the failure. the invalid sync point message must be corrected at the
v Listing of the statistics class 4 trace records. remote site.
Problem Determination: Collect the following
If no DSNL031I message was written at the same time diagnostic items listed in “Appendix B. Problem
as the alert, then scan the log backwards for a previous determination” on page 1281: 1.
DSNL031I message. A DB2 filter function prohibits
multiple occurrences of the same problem detected
within a 5 minute period from flooding the console and 00D3010A
trace data set with diagnostic information. You will have Explanation: This might occur when a version of IMS
to find an earlier occurrence of the same problem to that does not support the COMMIT VERIFY exit is
start diagnosing it. running an IMS MODE=MULTI application with one or
more non-DB2 servers. This is probably a user error,
Once you have found the DSNL031I message, locate since this scenario is not supported by DB2 and IMS
the IFCID 0191 trace record written for the problem by unless the IMS version is 4 or later.
using the IFCID sequence number from the DSNL031I
message. IMS requested a new user SIGNON without an
immediately preceding commit or abort, and your
The IFCID 0191 trace record will document the exact application was connected to one or more remote
data stream returned from the server. Use this non-DB2 servers. In order to preserve the consistency
information to determine if the reply message from the of database updates made at several different servers,
Server was correct, and if so, the error resides with the when at least one server is a non-DB2 server, a commit
DB2 AR. or abort must precede any new user SIGNON.
This reason code is issued by the following CSECT:
If the data stream is incorrect, then the problem lies at DSNLXNEW
the server and you should contact the system
programmer at the server and have he or she analyze System Action: The execution unit writes a record to
the data stream produced by the server. SYS1.LOGREC. No dump is requested. The IMS
864 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D3010B • 00D3010D
application terminates as a result of the abend.
00D3010C
Operator Response: Collect the SYS1.LOGREC.
Explanation: Cached information was used to
Notify the system programmer.
determine whether updates are allowed at the server.
System Programmer Response: Determine if the From the time of the execution of the CONNECT
IMS version and release being used invokes the DB2 statement to the time that the first SQL statement was
COMMIT VERIFY exit, which is available in DB2 sent to the server, the partner was started with a
Version 3 and later. Obtain the SYS1.LOGREC. program that does not support two-phase commit.
If you suspect an error in DB2, refer to Part 2 of DB2 Such servers are not allowed to update in the current
Diagnosis Guide and Reference for information on unit of work. Since an update might have been
identifying and reporting the problem. performed by the partner during execution of the first
statement at the server, the application must roll back.
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem This reason code is returned as a token in the
determination” on page 1281: 1. SQLCODE -904.
This reason code is issued by the following CSECT:
00D3010B DSNLTAC1
Explanation: Cached information was used to System Action: The connection to the server is
determine whether updates are allowed at the server. deallocated. The server’s portion of the current unit of
From the time of the execution of the CONNECT work is rolled back at the server. The application is
statement to the time that the first SQL statement was placed in a must-abort state. All subsequent operations
sent to the server, the conversation SYNC_LEVEL except rollback or abort fail with an SQLCODE -918.
supported by the partner changed from a cached value The remainder of the current unit of work is backed out
of SYNC to the current of value NONE. when rollback or abort is performed or when the
application terminates.
SYNC_LEVEL NONE servers are not allowed to update
in the current unit of work. Since an update might have User Response: If your application does not do any
been performed by the partner during execution of the work at a server for a long time after issuing a
first statement at the server, the application must roll CONNECT, consider rewriting it to perform the
back (abort). CONNECT immediately before performing any work at
the server. This minimizes the possibility of the server
This reason code is returned as a token in the system going down and coming back up at a different
SQLCODE -904. level.
This reason code is issued by the following CSECT: Rerun your application starting with the unit of work
DSNLTAC1 containing the SQL statement that received the
System Action: The connection to the server is SQLCODE -904.
deallocated. The server’s portion of the current unit of
work is rolled back at the server. The application is 00D3010D
placed in a must-abort state. All subsequent operations
except rollback or abort fail with an SQLCODE -918. Explanation: DB2 requested updates at multiple
The remainder of the current unit of work is backed out servers, but at least one server does not support
when rollback or abort is performed or when the distributed two-phase commit.
application terminates.
This reason code is issued by the following CSECT:
User Response: If your application does not do any DSNLCMT1
work at a server for a long time after issuing a
System Action: The commit fails for this unit of work
CONNECT, consider rewriting it to perform the
(UOW). If the application is using TSO or BATCH
CONNECT immediately before performing any work at
attach, then DB2 rolls back the UOW. If the application
the server. This minimizes the possibility of the server
is using CICS or IMS attach, then CICS or IMS rolls
system going down and coming back up at a different
back the UOW after receiving the NO commit vote from
SYNC_LEVEL.
DB2.
Rerun your application starting with the unit of work
User Response: Change the application so that
containing the SQL statement that received an
updates to multiple servers (including the local server)
SQLCODE -904.
are not performed within a single UOW unless all the
update servers in the UOW support distributed
two-phase commit.
Problem Determination: In the UOW that was not
committed, the first SQL statement that performed an
update that was not allowed received an SQLCODE
Chapter 39. DB2 Codes 865
00D3010E • 00D31011
-919. All subsequent SQL statements also received an
00D31010
SQLCODE -919 until a ROLLBACK or a static
ROLLBACK SQL statement was executed (if either Explanation: An internal logic error occurred while a
occurred). DCRM functional service was being invoked.
This abend reason code is issued by the following
00D3010E CSECT: DSNLCnnn
Explanation: The DRDA server system does not DSNLCnnn identifies that a DCRM Conversation
support the authentication mechanism specified in the manager CSECT detected a logic error. Refer to the
communications database. For example, the dump title for the specific CSECT name.
communications database specified that RACF
System Action: A record is written to SYS1.LOGREC
passtickets were supposed to be used, but the server
and an SVC dump is requested at the site of the DB2
does not support it.
abend.
System Action: The attempt to access the remote
System Programmer Response: Determine which
server fails. An SQLCODE -30073 is returned to the
sites the abending agent was connected to by
application.
examining the DSNL027 and DSNL028 SYSLOG
User Response: Notify the system programmer. console messages at the site of the DB2 abend. Obtain
copies of the SYS1.LOGREC and SYSLOG data sets
System Programmer Response: Modify the row in
from each connected site, the SVC dump at the site of
SYSIBM.LUNAMES or SYSIBM.IPNAMES to specify a
the DB2 failure, and any related dumps from each
security mechanism in the SECURITY_OUT column that
connected site. If you suspect an error in DB2, refer to
the remote server supports.
Part 2 of DB2 Diagnosis Guide and Reference for
information on identifying and reporting the problem.
00D3010F
Problem Determination: Collect the following
Explanation: DB2 was unable to authenticate the diagnostic items listed in “Appendix B. Problem
DRDA end user, due to an error detected by RACF or determination” on page 1281: 56, 57.
DCE.
System Action: The end user’s attempt to connect is 00D31011
rejected. An SQLCODE -30082 is returned to the
Explanation: An internal logic error occurred while
application.
invoking a VTAM functional service.
User Response: Notify the system programmer.
This abend reason code is issued by the following
System Programmer Response: Correct the error CSECT: DSNLVnnn
detected by DCE or RACF. Both products write
DSNLVnnn identifies that a DCRM VTAM manager
messages to the MVS console describing the error.
CSECT detected a logic error. Refer to the dump title
for the specific CSECT name.
| 00D30110
System Action: A record is written to SYS1.LOGREC
| Explanation: A DRDA error occurred. The DB2 crypto and an SVC dump is requested at the site of the DB2
| security component detected an error and could not abend.
| process the encryption security tokens used to
User Response: Notify the system programmer.
| authenticate the end user.
Operator Response: Collect the SYS1.LOGREC
| System Action: The attempt to connect to DB2 fails, listing and the SVC dump.
| the failure is reported to the SQL application with an
| SQLCODE of -30082, and the connection is terminated. System Programmer Response: Determine which
sites the abending agent was connected to by
| System Programmer Response: Determine the
examining the DSNL027 and DSNL028 SYSLOG
| reason for the failure by verifying the DRDA data stream
console messages at the site of the DB2 abend. Obtain
| and by reviewing the server diagnostic work area
copies of the SYS1.LOGREC and SYSLOG data sets
| returned in the DRDA security check reply message.
from each connected site, the SVC dump at the site of
| Problem Determination: If you suspect an error in the DB2 failure, and any related dumps from each
| DB2, refer to Part 2 of DB2 Diagnosis Guide and connected site. If you suspect an error in DB2, refer to
| Reference for information on identifying and reporting Part 2 of DB2 Diagnosis Guide and Reference for
| the problem. information on identifying and reporting the problem.
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57.
866 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D31012 • 00D31018
diagnostic items listed in “Appendix B. Problem
00D31012
determination” on page 1281: 56, 57.
Explanation: A VTAM functional service request failed
because the state of the conversation was invalid for
00D31014
the request.
Explanation: One or more invalid parameters were
This abend reason code is issued by the following
supplied while invoking a VTAM functional service.
CSECTs: DSNLVDDC DSNLVFSM
This abend reason code is issued by the following
System Action: A record is written to SYS1.LOGREC
CSECTs:
and an SVC dump is requested at the site of the DB2
abend. DSNLVASY DSNLVDDC DSNLVFSM DSNLVINF
User Response: Notify the system programmer. DSNLVRCA DSNLVREQ DSNLVRQP DSNLVSCA
DSNLVSDA DSNLVSEA
Operator Response: Collect the SYS1.LOGREC
listing and the SVC dump.
System Action: A record is written to SYS1.LOGREC
System Programmer Response: Determine which and an SVC dump is requested at the site of the DB2
sites the abending agent was connected to by abend.
examining the DSNL027 and DSNL028 SYSLOG
console messages at the site of the DB2 abend. Obtain User Response: Notify the system programmer.
any related diagnostic information from each connected Operator Response: Collect the SYS1.LOGREC
site and the SVC dump and SYS1.LOGREC at the site listing and the SVC dump.
of the DB2 failure.
System Programmer Response: Determine which
If you suspect an error in DB2, refer to Part 2 of DB2 sites the abending agent was connected to by
Diagnosis Guide and Reference for information on examining the DSNL027 and DSNL028 SYSLOG
identifying and reporting the problem. console messages at the site of the DB2 abend. Obtain
Problem Determination: Collect the following any related diagnostic information from each connected
diagnostic items listed in “Appendix B. Problem site and the SVC dump and SYS1.LOGREC at the site
determination” on page 1281: 56, 57. of the DB2 failure.
If you suspect an error in DB2, refer to Part 2 of DB2
00D31013 Diagnosis Guide and Reference for information on
identifying and reporting the problem.
Explanation: A DB2 message was received with an
invalid message block header (MBH). The MBH is a Problem Determination: Collect the following
header that precedes all messages exchanged between diagnostic items listed in “Appendix B. Problem
two DB2 subsystems. determination” on page 1281: 56, 57.
This abend reason code is issued by the following
CSECTs: 00D31018
Explanation: A syntax error was detected in a DDM
DSNLVASY DSNLVRCA DSNLVRQP
reply received from a remote distributed database
remote server.
System Action: A record is written to SYS1.LOGREC
This abend reason code is issued by the following
and an SVC dump is requested at the site of the DB2
CSECTs: DSNLCSRR DSNLCMSR
abend.
System Action: The attempt to access the remote
User Response: Notify the system programmer.
database resource fails, and the failure is reported to
Operator Response: Collect the SYS1.LOGREC the application.
listing and the SVC dump.
A DSNL031I message might have been written to the
System Programmer Response: Determine which console. Refer to the description of this message for
connected sites the abending agent was connected to further information.
by examining the DSNL027 and DSNL028 SYSLOG
Operator Response: Notify the system programmer.
console messages at the site of the DB2 abend. Obtain
any related diagnostic information from each connected System Programmer Response: If you suspect an
site and the SVC dump and SYS1.LOGREC at the site error in DB2, refer to Part 2 of DB2 Diagnosis Guide
of the DB2 failure. If you suspect an error in DB2, refer and Reference for information on identifying and
to Part 2 of DB2 Diagnosis Guide and Reference for reporting the problem.
information on identifying and reporting the problem.
Problem Determination: Collect the following
Problem Determination: Collect the following diagnostic items listed in “Appendix B. Problem
Chapter 39. DB2 Codes 867
00D31019 • 00D31022
determination” on page 1281: 1, 83. fails, and the failure is reported to the local DB2.
A DSNL032I message may have been written to the
00D31019 console. Refer to the description of this message for
further information.
Explanation: A DDM protocol error was detected in a
DDM reply received from a remote distributed database Operator Response: Notify the system programmer.
remote server.
System Programmer Response: If you suspect an
This abend reason code is issued by the following error in DB2, refer to Part 2 of DB2 Diagnosis Guide
CSECTs: DSNLCMSR DSNLCSRR and Reference for information on identifying and
reporting the problem.
System Action: The attempt to access the distributed
resource fails, and the failure is reported to the local Problem Determination: Collect the following
DB2. diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 1, 83.
A DSNL031I message might have been written to the
console. Refer to the description of this message in this
book for further information. 00D3101C
Operator Response: Notify the system programmer. Explanation: DB2 has detected an error while
processing a connection request from DDCS. A DB2RA
System Programmer Response: If you suspect an
connection request was received from DDCS.
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and This reason code is issued by the following CSECTs:
reporting the problem. DSNLCRTD and DSNLIRTR.
Problem Determination: Collect the following System Action: A DDM reply message (SYNTAXRM)
diagnostic items listed in “Appendix B. Problem is returned to the DRDA client.
determination” on page 1281: 1, 83.
Operator Response: Notify the DDCS system
administrator.
00D3101A
System Programmer Response: This is probably not
Explanation: A syntax error was detected in a DDM a DB2 problem. This error is most likely caused by an
request received from a remote distributed database incorrect entry in the DCS directory on DDCS. Refer to
local DB2. IBM Distributed Database Connection Services
Installation and Configuration Guide for information on
This abend reason code is issued by the following
configuring your DDCS system.
CSECT: DSNLCRTD
System Action: The attempt to access the DB2 server
00D31022
fails, and the failure is reported to the local DB2.
Explanation: The requested VTAM function for
A DSNL032I message might have been written to the
allocating a conversation was not performed because
console. Refer to the description of this message for
the data manager returned an unavailable resource
further information.
when attempting to read the SYSIBM.LOCATIONS table
Operator Response: Notify the system programmer. in the communication database (CDB). The LOCATION
cannot be resolved to the remote DB2 subsystem
System Programmer Response: If you suspect an LUNAME.
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and This abend reason code is issued by the following
reporting the problem. CSECT: DSNLVCLM
Problem Determination: Collect the following System Action: Notification of the failure is returned
diagnostic items listed in “Appendix B. Problem to the application. The conversation is not allocated.
determination” on page 1281: 1, 83.
Operator Response: Notify the system programmer.
System Programmer Response: If you suspect an
00D3101B
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
Explanation: A DDM protocol error was detected in a and Reference for information on identifying and
DDM request received from a remote distributed reporting the problem.
database local DB2.
Problem Determination: For more information, refer
This abend reason code is issued by the following to the explanation of message DSNL700I. Collect the
CSECT: DSNLCRTD following diagnostic items:
System Action: The attempt to access the DB2 server v Definitions of the communication database (CDB)
table space, tables, and indexes involved in the error.
868 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D31023 • 00D31027
v Items 1 and 5 listed in “Appendix B. Problem This abend reason code is issued by the following
determination” on page 1281. CSECT: DSNLVCLM
System Action: Notification of the failure is returned
00D31023 to the application. The conversation is not allocated.
Explanation: A request for a protected SNA Operator Response: Notify the system programmer.
conversation was rejected by a DB2 server because the
System Programmer Response: Add the mode name
SNA exchange log names (XLN) process has not yet
to be selected in the SYSIBM.MODESELECT table for
completed with the requesting system.
the authorization ID, PLANNAME, and LUNAME of the
This abend reason code is issued by the following service request that failed.
CSECT: DSNLVPFV
Problem Determination: Collect the following
System Action: Message DSNL030I is displayed on diagnostic items listed in “Appendix B. Problem
the system console with reason code 00D31023. The determination” on page 1281: 75, 76.
SNA conversation is rejected with SNA sense code
08640001, indicating the SNA protocol for protected
00D31026
conversations was violated.
Explanation: The requested VTAM function was not
User Response: Notify the DB2 system programmer.
performed because VTAM returned a nonzero return
System Programmer Response: The requesting code while attempting to communicate on a
system should have sent a valid SNA XLN request conversation.
before starting a protected conversation. Contact the
This abend reason code is issued by the following
system programmer for the requesting system to
CSECT: DSNLVRPL
determine why the SNA XLN process was not
completed successfully. System Action: Notification of the failure is returned
to the application. The conversation is abnormally
Problem Determination: Collect the following
deallocated.
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 1. Operator Response: Notify the system programmer.
System Programmer Response: If you suspect an
00D31024 error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and
Explanation: The requested VTAM function for
reporting the problem.
allocating a conversation was not performed because
the location name is not defined in the Problem Determination: For more information, refer
SYSIBM.LOCATIONS table in the communication to the explanation of message DSNL500I or message
database (CDB). DSNL502I, depending on the type of conversation that
failed.
This abend reason code is issued by the following
CSECTs: Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 1,
DSNLVAAC DSNLVCLM DSNLVPF5 5,
System Action: Notification of the failure is returned 00D31027
to the application. The conversation is not allocated to
the specified location. Explanation: The requested VTAM function cannot be
performed because VTAM is abending or because the
Operator Response: Notify the system programmer. operator has issued a HALT NET command to terminate
System Programmer Response: Add the location to VTAM.
the SYSIBM.LOCATIONS table. This abend reason code is issued by the following
Problem Determination: Collect the following CSECTs:
diagnostic items listed in “Appendix B. Problem
DSNLVAAC DSNLVASY DSNLVCNS DSNLVDDC
determination” on page 1281: 73, 74.
DSNLVRCA DSNLVREQ DSNLVSCA DSNLVSDA
DSNLVSEA DSNLVPCS DSNLVPF5 DSNLVRQP
00D31025
Explanation: The requested VTAM function for System Action: Notification of DDF termination is
allocating a conversation was not performed because a reported to the application. No remote communications
mode name could not be found in the are allowed. The distributed data facility is terminated.
SYSIBM.MODESELECT table in the communication
Operator Response: Notify the system programmer.
database (CDB) for the requesting thread.
Chapter 39. DB2 Codes 869
00D31029 • 00D31033
System Programmer Response: Determine why System Action: Message DSNL030I is displayed on
VTAM was terminated. the system console with reason code 00D3102B. The
conversation is not allocated.
00D31029 Operator Response: Notify the system programmer.
Explanation: The requested VTAM function to allocate System Programmer Response: Correct the
a conversation failed. VTAM returned a nonzero return definitions at the partner LU to prevent conversations
code while attempting to negotiate limits with a remote from being allocated with a blank mode name.
location for a mode.
This abend reason code is issued by the following 00D31031
CSECT: DSNLVCNS
Explanation: The local distributed data facility (DDF)
System Action: Notification of the failure is returned is terminating.
to the application. All communications to the remote
This reason code is issued by the following CSECTs:
location on the mode fail until the CNOS is successfully
negotiated. DSNLCCCN DSNLVAAC DSNLVCNS DSNLVDDC
Operator Response: Notify the system programmer. DSNLVINF DSNLVRCA DSNLVREQ DSNLVSCA
DSNLVSDA DSNLVSEA
System Programmer Response: If you suspect an
error in DB2, refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and System Action: Notification of the failure is returned
reporting the problem. to the application. DB2 does not allow any new
distributed threads while DDF is in termination or is
Problem Determination: For more information, refer terminated.
to the explanation of message DSNL501I.
User Response: Contact your system programmer to
Collect the following diagnostic items listed in determine why DDF was terminated.
“Appendix B. Problem determination” on page 1281: 1,
5. Operator Response: Contact the system to determine
the cause of DDF termination.
00D3102A System Programmer Response: To determine why
DDF was terminated and then start DDF.
Explanation: A conversation was not allocated
because a VTAM LU name contained in the LUNAME
column of the SYSIBM.LULIST table was also present 00D31032
in the LUNAME column of the SYSIBM.LUNAMES Explanation: The requested VTAM function failed
table. A given VTAM LU name can appear in only one because the distributed data facility (DDF) at the remote
of these two tables. location is terminating.
System Action: The conversation is not allocated. This abend reason code is issued by the following
Operator Response: Notify the system programmer. CSECTs:
System Programmer Response: Make sure each DSNLCRTR DSNLCTRM DSNLVRPL
remote VTAM LU is defined in the SYSIBM.LULIST
table or the SYSIBM.LUNAMES table, but not both
tables. System Action: DB2 writes a SYS1.LOGREC record.
No communication on the conversation is allowed.
Problem Determination: Collect the following
diagnostic items: Operator Response: Notify the system programmer.
v Print the contents of the SYSIBM.LUNAMES table. System Programmer Response: To determine the
v Print the contents of the SYSIBM.LULIST table. cause of the DDF termination, contact the
communication administrator at the location.
This abend reason code is issued by the following
CSECT: DSNLVCLM 00D31033
Explanation: The VTAM function request to allocate a
00D3102B conversation failed because the thread timed-out while
waiting for a session.
Explanation: A conversation was not allocated
because the partner LU attempted to allocate a This abend reason code is issued by the following
conversation using a blank mode name. Although DB2 CSECT: DSNLVALM
tolerates CNOS requests with a blank mode name, DB2
does not accept conversations with a blank mode name.
870 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D31034 • 00D31037
System Action: Notification of the failure is returned the DB2 failure, and any related dumps from each
to the application. connected site. Refer to Part 2 of DB2 Diagnosis Guide
and Reference for information on identifying and
Operator Response: Notify the system programmer.
reporting the problem.
System Programmer Response: The defined session
Problem Determination: Collect the following
limit for the mode used by the thread might be too
diagnostic items listed in “Appendix B. Problem
small. The CONVLIMIT specified for the mode might
determination” on page 1281: 56, 57.
have to be negotiated with the communication
administrator at the remote subsystem.
00D31036
Problem Determination: Refer to message DSNL510I
for the limit negotiated by VTAM for the location and Explanation: The LINKNAME column of the
mode used by the thread. Collect the following SYSIBM.LOCATIONS table was invalid. Since
diagnostic items listed in “Appendix B. Problem LINKNAME is a foreign key of the SYSIBM.LUNAMES
determination” on page 1281: 1, 5, 77. table, the LINKNAME column must specify one of the
values provided in the LUNAME column of the
SYSIBM.LUNAMES table. This error should not occur.
00D31034
This abend reason code is issued by the following
Explanation: The MAX REMOTE CONNECTED limit
CSECT: DSNLVCLM
was reached and the conversation was abnormally
deallocated. The thread was not allowed to connect to System Action: A record is written to SYS1.LOGREC
DB2. and an SVC dump is requested at the site of the DB2
abend.
This abend reason code is issued by the following
CSECT: DSNLVPFV User Response: Notify the system programmer.
System Action: The requester is not connected to Operator Response: Collect the SYS1.LOGREC, and
DB2. the SVC dump.
Operator Response: Notify the system programmer. System Programmer Response: Obtain copies of the
SYS1.LOGREC and SYSLOG data sets from the DB2
System Programmer Response: The maximum
site with the inconsistently defined communications
number of database access threads that can
database (CDB).
concurrently exist is defined by the installation option
MAX REMOTE CONNECTED. When the MAX If you suspect an error in DB2, refer to Part 2 of DB2
REMOTE CONNECTED limit is equal to the number of Diagnosis Guide and Reference for information on
active database access threads plus the number of identifying and reporting the problem.
inactive database access threads, additional threads are
Problem Determination: Collect the following
not allowed to connect to DB2. Use the DDF global
diagnostic items listed in “Appendix B. Problem
statistics to determine if the limit should be increased.
determination” on page 1281: 56, 57.
Problem Determination: Collect the following
diagnostic items:
00D31037
v DDF global statistics to determine the number of
requests that failed because of the MAX REMOTE Explanation: The remote server was not successfully
CONNECTED limit. connected. The SYSIBM.USERNAMES table did not
contain an outbound row, the TYPE column specified as
an 'O' describing the remote authorization identifier to
00D31035 be used for the primary DB2 authorization ID. When the
Explanation: The requested VTAM function failed. The USERNAMES column in SYSIBM.LUNAMES specifies
database access agent was aborted at the remote 'O' or 'B' requiring outbound name translation, the
location. Notification of the failure is returned to the SYSIBM.USERNAMES table must contain entries
application. This is an internal error. describing the remote authorization IDs to be used for
each DB2 authorization ID communicating with the LU.
This abend reason code is issued by the following
CSECT: DSNLCTRC This reason code is issued by the following CSECTs:
System Action: DB2 writes a SYS1.LOGREC record DSNLCCCN DSNLCSRR DSNLTMIG
and requests an SVC dump at the failed DB2 site.
Operator Response: Notify the system programmer. System Action: A resource unavailable is returned to
the application. The request is not sent to the remote
System Programmer Response: Obtain copies of the
site.
SYS1.LOGREC and SYSLOG data sets or similar data
from each connected site, the SVC dump at the site of
Chapter 39. DB2 Codes 871
00D31038
Operator Response: Notify the communications LOCATION column for the failing LOCATION, which
database administrator. causes the request to be sent to the wrong remote
DBMS.
System Programmer Response: Make sure the
USERNAMES column in SYSIBM.LUNAMES has been v The SYSIBM.LULIST table at the local DB2 system
specified correctly for the indicated LUNAME. If you has an incorrect value in the LUNAME column for the
intend to use remote authorization IDs that differ from failing LOCATION, which causes the request to be
the DB2 authorization IDs, verify that the sent to the wrong remote DBMS.
SYSIBM.USERNAMES table has rows that correctly v Not all LU names in the requesting DB2 sysplex are
specify the remote authorization ID to be used for each defined in the SYSIBM.LULIST table at the remote
possible DB2 authorization ID. site.
Problem Determination: Analyze the v Not all LU names in the requesting DB2 sysplex are
SYSIBM.USERNAMES table for an incorrect or missing defined in the SYSIBM.LULIST table at the server
entry. DB2 subsystem. The remote LU is not allowed
access to the server subsystem.
In general, when the requester is a member of a
00D31038
sysplex, each member of the requesting sysplex
Explanation: A conversation was not allocated for one should be defined in SYSIBM.LULIST of the server
of these reasons: subsystem. However, there may be causes where an
v The requesting LU is part of a DB2 sysplex. When LU of a remote sysplex is not defined in
one or more LU names within a DB2 sysplex appear SYSIBM.LULIST of the local subsystem to prevent
in the SYSIBM.LULIST table at the remote site, all the remote LU from being a candidate member when
LU names within the sysplex must be identified in the accessing the remote sysplex. This is known as
SYSIBM.LULIST table at the remote site. ″member specific routing″. If the remote sysplex LU
attempts to access the local subsystem, this reason
– You might have intended to list all the sysplex’s code will be returned if the remote LU is not defined
LU names in the SYSIBM.LULIST table, but you in the local SYSIBM.LULIST table and is also not
did not include one or more LU names. defined in SYSIBM.LUNAMES. Remote requesting
– You listed a subset of the LU names in sysplex members can be defined in SYSIBM.LULIST,
SYSIBM.LULIST but none of the LU names you or, when member specific routing requirements to the
listed are currently available. Please note that it remote sysplex member are desired, the remote
can take up to 3 minutes for LU availability sysplex LU can be defined in SYSIBM.LUNAMES for
information to be updated following START DDF at inbound purposes from the remote sysplex LU that
the remote site. contain the appropriate inbound security
v The location name sent to a remote site does not characteristics.
match the location name recorded in the BSDS at v The local DB2 system contains a SYSIBM.LULIST
that remote site. row for a remote system that is not a member of a
v The local SYSIBM.LULIST table is incorrectly defined Data Sharing group. SYSIBM.LULIST rows CANNOT
for the remote location. be defined for remote non Data Sharing server
systems. Remove the SYSIBM.LULIST row for the
A DSNL030I message might have been written to the remote systems.
console.
Problem Determination:
System Action: A record is written to SYS1.LOGREC
v Determine the LUNAME and LOCATION name of the
and the conversation is not allocated.
DB2 system that attempted to start a VTAM
Operator Response: Notify the system programmer. conversation.
System Programmer Response: The CDB tables and v Print the contents of the SYSIBM.LOCATIONS table
DB2 BSDS parameters must correctly associate the at that site.
LOCATION names with their corresponding LUNAME v Print the contents of the SYSIBM.LULIST table at
names. both the local site and the remote site.
The cause of this error is usually one of the following: v Determine the LUNAME and LOCATION name of the
remote DBMS involved in the failure from the BSDS
v The BSDS at the remote site does not have the
at the remote site.
correct LOCATION or LUNAME value, which causes
the remote DBMS to respond to the wrong v Issue the -DISPLAY LOCATION command to
LOCATION name when receiving distributed determine which LUNAMEs and LOCATIONs were
database requests. active at the time of failure.
v The SYSIBM.LOCATIONS table at the local DB2
This abend reason code is issued by the following
system has an incorrect value in the LINKNAME or
CSECTs:
872 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D31039 • 00D3103C
DSNLCSIM DSNLVCLM DSNLVPF5 authorization ID column in SYSIBM.USERNAMES has
been specified correctly for the indicated LUNAME. If
you intend to use encrypted passwords, the new
authorization ID must be defined to your MVS security
00D31039 subsystem.
Explanation: The requested VTAM function to allocate Problem Determination:
a conversation was not performed because the v Analyze the SYSIBM.USERNAMES table for an
SYSIBM.USERNAMES table at the requesting site did incorrect or missing entry.
not contain a row describing the remote authorization ID v Verify that the names given in the NEWAUTHID
to be used for this DB2 authorization ID. When the column are defined to your MVS security subsystem
USERNAMES column in SYSIBM.LUNAMES specifies properly.
'O' or 'B', outbound name translation is in effect. The
SYSIBM.USERNAMES table must contain entries
describing the remote authorization ID to be used for 00D3103B
each DB2 authorization ID communicating with that Explanation: An attempt to allocate an LU6.2
LUNAME. conversation failed because the conversation limits for
This abend reason code is issued by the following the desired partner LU and VTAM MODE have been
CSECT: DSNLVCLM reached.
System Action: A record is written to SYS1.LOGREC, This abend reason code is issued by the following
and the conversation is not allocated. CSECT: DSNLVALM
Operator Response: Notify the system programmer. System Action: This reason code is generated
internally when an attempt is made to allocate an LU6.2
System Programmer Response: Make sure the conversation and conversation limits have been reached
USERNAMES column in SYSIBM.LUNAMES has been for the desired partner LU and VTAM MODE. In this
specified correctly for the indicated LUNAME. If you situation, the requesting DB2 system will attempt to
intend to use remote authorization IDs that differ from reuse one of the existing LU6.2 conversations that have
the DB2 authorization ID, verify that the already been allocated to the agent in question.
SYSIBM.USERNAMES table has rows that correctly
specify the remote authorization ID to be used for each The allocate process will be retried using the existing
possible DB2 authorization ID. These rows must specify conversation.
'O'in the TYPE column of the SYSIBM.USERNAMES System Programmer Response: If you increase the
table. LU6.2 conversation limits for the indicated partner LU
Problem Determination: Determine the LUNAME and and VTAM MODE, it will not be necessary for DB2 to
authorization ID for the failing VTAM conversation. reclaim conversations in order to allocate additional
Collect the following diagnostic items listed in LU6.2 conversations. The reclaiming process will reduce
“Appendix B. Problem determination” on page 1281: 58, system throughput, since the reclaimed conversation will
59. have to service multiple SQL statements.
00D3103A 00D3103C
Explanation: Database access agent allocation failed Explanation: An attempt to allocate an LU6.2
because the RACROUTE REQUEST=EXTRACT macro conversation failed because the specified partner LU
failed to locate a user profile for the DB2 primary cannot support the LU6.2 SECURITY=SAME capability
authorization ID obtained from the (that is, the LU6.2 Already-Verified security function).
SYSIBM.USERNAMES table. When the This abend reason code is issued by the following
ENCRYPTPSWDS column in SYSIBM.LUNAMES CSECT: DSNLVAAC
specifies 'Y', the requesting DB2 system must be able
to extract the encrypted password (via RACROUTE System Action: The attempt to allocate an LU6.2
REQUEST=EXTRACT) and send this encrypted conversation fails, and the error is reported to the DB2
password to the responding DB2 system for validation. application that requested access to the distributed
resource.
This reason code is issued by the following CSECT:
DSNLVINF User Response: Notify your DB2 system programmer.
System Action: The reason code is returned to the System Programmer Response: DB2 will attempt to
application. use SECURITY=SAME when connecting to remote
database systems whose USERSECURITY column in
Operator Response: Notify the communications the SYSIBM.LUNAMES table contains a value other
database administrator. than 'C'. In order to support the LU6.2
System Programmer Response: Make sure the new SECURITY=SAME function, the target DBMS must
Chapter 39. DB2 Codes 873
00D3103D • 00D3103E
declare support for the SECURITY=SAME function. specifies 'O' or 'B', the SYSIBM.USERNAMES table
will be used to determine the authorization ID and
If the target DBMS is DB2, support for the
password sent on the LU6.ALLOCATE request.
SECURITY=SAME function is declared by specifying
the following: If you intend to translate the authorization IDs, ensure
that the NEWAUTHID column of the
1. The DB2 VTAM APPL definition must specify
SYSIBM.USERNAMES table contains the correct
SECACPT=ALREADYV at the remote DB2
authorization ID to be used at the remote site.
subsystem.
v If the remote site is a DB2 system, the
2. The value in the USERSECURITY column of the
ENCRYPTPSWDS value in the SYSIBM.LUNAMES
SYSIBM.LUNAMES table at the remote DB2
table must exactly match the ENCRYPTPSWDS
subsystem must specify a value other than 'C' in the
column of the SYSIBM.LUNAMES table at the remote
row associated with the requesting DB2 subsystem.
site.
Problem Determination: Collect the following v If the remote site is not a DB2 system, the
diagnostic items: ENCRYPTPSWDS value in the SYSIBM.LUNAMES
v The VTAM APPL definition for the remote DB2 table must be set to 'N'.
system. v If you are transmitting passwords to the remote site,
v The contents of the SYSIBM.LUNAMES table. the password transmitted by the local DB2 system
must exactly match the value expected by the remote
site.
00D3103D
1. For encrypted passwords, the password sent to
Explanation: An attempt to allocate a VTAM LU6.2 the remote DB2 subsystem is obtained by
conversation with a remote site failed because the extracting the RACF password of the user
request did not contain the proper security information. identified by the NEWAUTHID column in the
SYSIBM.USERNAMES table. This user's RACF
This abend reason code is issued by the following
password must exactly match the password at the
CSECT: DSNLVRPL
remote site.
System Action: The attempt to access the remote 2. If password encryption is not used, the password
database resource failed and the failure is reported to will be taken from the PASSWORD column of the
the application. SYSIBM.USERNAMES table. This value must
User Response: Notify the communications database exactly match the password at the remote site.
administrator. Problem Determination: Collect the following
System Programmer Response: This error is usually diagnostic items listed in “Appendix B. Problem
caused by transmitting an invalid authorization ID or determination” on page 1281: 58, 59, 1.
password in a request to the remote site. However, this
is not always the case, so it is important to review the 00D3103E
diagnostic information at the remote site to determine
the cause of the failure. Explanation: The requested VTAM function to allocate
a conversation was not performed because the VTAM
v If the remote site is a DB2 subsystem, refer to the
MODE specified a conversation limit of zero. The
DSNL030I message at the remote site for the cause
conversation limits must be set to a value greater than
of the security failure. Additionally, an ALERT will be
zero before a conversation can be allocated.
recorded in NetView (if the NetView product is
available) to describe the security failure. This abend reason code is issued by the following
If the remote site is not a DB2 subsystem, obtain any CSECT: DSNLVALM
diagnostic information about the security failure at the System Action: The conversation is not allocated.
remote site.
Operator Response: Notify the system programmer.
If you suspect the authorization ID or password is not System Programmer Response: If you have placed
correct, the DB2 CDB on the local DB2 system should entries in the SYSIBM.LUMODES table, make sure
be examined to validate the following items: CONVLIMIT column has a nonzero value. If you are
v If the remote site requires both an authorization ID allowing the session limits to be chosen by VTAM, make
and a password on LU6.ALLOCATE requests (i.e., sure the DSESLIM values on the VTAM APPL and
the remote site does not accept already-verified mode entries are nonzero.
ALLOCATE requests), the USERNAMES column of
the SYSIBM.LUNAMES table at the local DB2 system Problem Determination: Collect the following
must specify either 'O' or 'B'. diagnostic items:
v If the USERNAMES column of the v Determine the LUNAME and MODE name of the DB2
SYSIBM.LUNAMES table at the local DB2 system system that attempted to start a VTAM conversation.
v Print the contents of the SYSIBM.LUMODES table.
874 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D3103F • 00D31043
v Determine the session limits defined on the VTAM requesting DB2 system. When the USERNAMES
APPL statement and the VTAM MODE entry. column in SYSIBM.LUNAMES specifies 'I' or 'B',
inbound name translation is in effect. The
SYSIBM.USERNAMES table must contain entries
00D3103F
describing the local DB2 authorization ID to be used for
Explanation: An attempt to allocate a VTAM LU6.2 each DB2 authorization ID sent by the requesting DB2
conversation with a remote site failed because the system.
server at the remote LU does not support the SNA
This abend reason code is issued by the following
two-phase commit process.
CSECT: DSNLVCLM
This abend reason code is issued by the following
System Action: A record is written to SYS1.LOGREC
CSECT: DSNLVRPL
and the conversation is not allocated.
System Action: DB2 starts a new conversation to the
Operator Response: Notify the system programmer.
remote site that does not use two-phase commit. DB2
does not attempt to use two-phase commit with this System Programmer Response: Make sure the
remote site until DDF is restarted. USERNAMES column in SYSIBM.LUNAMES has been
specified correctly for the indicated LUNAME. If you
System Programmer Response: This reason code is
intend to use local authorization IDs that differ from the
produced when the LU at the remote site supports
remote DB2 authorization ID, verify that the
two-phase commit, but the TPN at the remote LU does
SYSIBM.USERNAMES table has rows that correctly
not support two-phase commit. This is a normal
specify the local authorization ID to be used for each
situation, so no system programmer action is required.
possible remote authorization ID. These rows must
specify 'I' in the TYPE column of the
00D31040 SYSIBM.USERNAMES table.
Explanation: The requested VTAM function failed Problem Determination: Determine the LUNAME and
before the database access agent has failed. This is an authorization ID for the failing VTAM conversation.
internal error. Collect the following diagnostic items listed in
“Appendix B. Problem determination” on page 1281: 58.
This abend reason code is issued by the following
CSECTs:
00D31042
DSNLCTRC DSNLCRTR DSNLCRTD
Explanation: The requested VTAM function failed. The
connection to the remote location was interrupted. This
System Action: DB2 writes a SYS1.LOGREC record is an internal error.
and requests an SVC dump at the failed DB2 site.
This abend reason code is issued by the following
Operator Response: Notify the system programmer. CSECT: DSNLCSIM
System Programmer Response: Determine which System Action: A record is written to SYS1.LOGREC
sites the abending agent was connected to by and an SVC dump is requested at the failed DB2 site.
examining the DSNL027 and DSNL028 SYSLOG
console messages at the site of the DB2 failure. Obtain Operator Response: Notify the system programmer.
any related diagnostic information from each connected System Programmer Response: Obtain copies of the
site and the SVC dump and SYS1.LOGREC at the site SYS1.LOGREC and SYSLOG data sets from each
of the DB2 failure. connected site, the SVC dump at the site of the DB2
Problem Determination: If you suspect an error in failure, and any related dumps from each connected
DB2, refer to Part 2 of DB2 Diagnosis Guide and site.
Reference for information on identifying and reporting If you suspect an error in DB2, refer to Part 2 of DB2
the problem. Diagnosis Guide and Reference for information on
Collect the following diagnostic items listed in identifying and reporting the problem.
“Appendix B. Problem determination” on page 1281: 56, Problem Determination: Collect the following
57. diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57.
00D31041
Explanation: The requested VTAM function to allocate 00D31043
a conversation was not performed because the Explanation: The requested VTAM function failed. The
SYSIBM.USERNAMES table at the responding site did connection from the remote location was interrupted.
not contain a row whose authorization ID column This is an internal error.
matches the DB2 authorization ID received from the
Chapter 39. DB2 Codes 875
00D31044 • 00D31046
This abend reason code is issued by the following
00D31045
CSECT: DSNLCSIM
Explanation: A remote subsystem has attempted to
System Action: A record is written to SYS1.LOGREC
allocate a VTAM LU6.2 conversation, but the request
and an SVC dump is requested at the failed DB2 site.
was rejected because the request did not contain the
Operator Response: Notify the system programmer. proper security information. The FMH5 received from
the remote subsystem did not contain the security
System Programmer Response: Obtain copies of the subfield that supplies the USERID, or the USERID was
SYS1.LOGREC and SYSLOG data sets from each not 1 to 8 bytes in length.
connected site, the SVC dump at the site of the DB2
failure, and any related dumps from each connected This abend reason code is issued by the following
site. CSECT: DSNLVPF5
If you suspect an error in DB2, refer to Part 2 of DB2 System Action: The attempt to access the remote
Diagnosis Guide and Reference for information on database resource fails and the failure is reported to the
identifying and reporting the problem. application.
Problem Determination: Collect the following A DSNL032I message may have been written to the
diagnostic items listed in “Appendix B. Problem console. Refer to the description of this message for
determination” on page 1281: 56, 57. further information.
User Response: Notify the communications database
00D31044 administrator.
Explanation: A remote subsystem has attempted to Operator Response: Notify the system programmer.
allocate a VTAM LU6.2 conversation, but the request
System Programmer Response: Verify that the
was rejected because the request did not contain the
remote subsystem is configured to send valid security
proper security information. The FMH5 received from
subfields.
the remote subsystem did not contain any security
subfields. This represents SECURITY=NONE in the If you suspect an error in DB2, refer to Part 2 of DB2
LU6.2 architecture, which is not supported by DB2. Diagnosis Guide and Reference for information on
identifying and reporting the problem.
This abend reason code is issued by the following
CSECT: DSNLVPF5 Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
System Action: The attempt to access the remote
determination” on page 1281: 1, 58, 83, 59.
database resource fails and the failure is reported to the
application.
00D31046
A DSNL030I message may have been written to the
console. Explanation: A remote subsystem has attempted to
allocate a VTAM LU6.2 conversation, but the request
User Response: Notify the communications database
was rejected because the request did not contain the
administrator.
proper security information. The FMH5 received from
Operator Response: Notify the system programmer. the remote subsystem indicated SECURITY=SAME
(also known as Already-Verified) and the subsystem in
System Programmer Response: Verify that the question was not authorized to send requests with
remote subsystem is configured to send valid security SECURITY=SAME.
subfields.
This abend reason code is issued by the following
If the remote subsystem is DB2, make sure the VTAM CSECT: DSNLVPF5
APPL definition does not specify SECACPT=NONE,
which is the default for the VTAM APPL definition. System Action: The attempt to access the remote
SECACPT=NONE will cause VTAM to remove the database resource fails and the failure is reported to the
security subfields from the FMH5. application.
If you suspect an error in DB2, refer to Part 2 of DB2 A DSNL030I message may have been written to the
Diagnosis Guide and Reference for information on console.
identifying and reporting the problem.
User Response: Notify the communications database
Problem Determination: Collect the following administrator.
diagnostic items listed in “Appendix B. Problem
Operator Response: Notify the system programmer.
determination” on page 1281: 1, 58, 59.
System Programmer Response: The request was
rejected because the SECURITY_IN column of the
SYSIBM.LUNAMES table contained a 'V' in the row
876 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D31047 • 00D31048
associated with the remote system. The value 'V' This abend reason code is issued by the following
indicates that the remote system must send both a CSECT: DSNLVPF5
USERID and a PASSWORD, which corresponds to
System Action: The attempt to access the remote
SECURITY_PGM in the SNA LU6.2 architecture. Users
database resource fails and the failure is reported to the
should also be aware that in the absence of a
application.
SYSIBM.LUNAMES row that specifically identifies the
remote LU, a ″default″ SYSIBM.LUNAMES row (blank A DSNL032I message may have been written to the
LUNAME) may be utilized, if defined, if the inbound console. Refer to the description of this message for
connection is via DRDA protocols. This ″default″ row further information.
may not reflect the desired inbound security
characteristics in which case a SYSIBM.LUNAMES row User Response: Notify the communications database
can be defined that explicitly identifies the remote LU. administrator.
If the remote LU is a member of a remote sysplex and Operator Response: Notify the system programmer.
the local system requires access to the remote sysplex, System Programmer Response: Verify that the
then members of the remote sysplex to be accessed remote subsystem is configured to send valid security
must be defined in the local SYSIBM.LULIST table. In subfields.
this case, the remote sysplex LU can be defined in the
local SYSIBM.LULIST table although a If you suspect an error in DB2, refer to Part 2 of DB2
SYSIBM.LUNAMES definition, default row or explicit Diagnosis Guide and Reference for information on
definition, is appropriate in cases where it is undesirable identifying and reporting the problem.
to define the remote LU in SYSIBM.LULIST (for Problem Determination: Collect the following
example when you don’t want the remote LU to be a diagnostic items listed in “Appendix B. Problem
candidate member when outbound accessing the determination” on page 1281: 1, 58, 59, 83.
remote SYSPLEX location).
This problem can be corrected in two ways: 00D31048
1. If you would like DB2 to accept requests that are
Explanation: The requested VTAM function for
marked with SECURITY=SAME, change the
allocating a conversation at the DB2 server was not
SECURITY_IN value in the SYSIBM.LUNAMES
performed because the requester’s LUNAME is not
table to 'A' for the remote LU in question. Also the
defined in the SYSIBM.LUNAMES table of the
DB2 VTAM APPL definition should specify
communication database (CDB) at the server.
SECACPT=ALREADYV.
2. If you would like DB2 to continue to reject requests This abend reason code is issued by the following
of this kind, the remote LU must be configured to CSECT: DSNLVPF5
send requests that contain both a USERID and System Action: Notification of the failure is returned
PASSWORD (SECURITY=PGM in SNA LU6.2 to the application. The conversation is not allocated to
terms). the specified location.
If the remote LU is DB2, the SECURITY_OUT
column in the SYSIBM.LUNAMES table must Operator Response: Notify the system programmer.
specify either 'R' or 'P' in the row associated with System Programmer Response: Add the requester’s
the local DB2 subsystem. LUNAME to the SYSIBM.LUNAMES table at the server.
If the remote LU is DB2, the requester’s LUNAME is the
If you suspect an error in DB2, refer to Part 2 of DB2 label name, as opposed to the ACBNAME keyword, on
Diagnosis Guide and Reference for information on the DB2 VTAM APPL statement for the requester site. A
identifying and reporting the problem. server’s SYSIBM.LUNAMES table should contain and
entry for the requester’s LUNAME.
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem Users should also be aware that in the absence of a
determination” on page 1281: 1, 58, 59. SYSIBM.LUNAMES row that specifically identifies the
remote LU, a ″default″ SYSIBM.LUNAMES row (blank
LUNAME) may be utilized, if defined, if the inbound
00D31047
connection is via DRDA protocols. This ″default″ row
Explanation: A remote subsystem has attempted to may not reflect the desired inbound security
allocate a VTAM LU6.2 conversation, but the request characteristics in which case a SYSIBM.LUNAMES row
was rejected because the request did not contain the can be defined that explicitly identifies the remote LU.
proper security information. The FMH5 received from
If the remote LU is a member of a remote sysplex and
the remote subsystem did not contain the security
the local system requires access to the remote sysplex,
subfield that supplies the PASSWORD, or the
then members of the remote sysplex to be accessed
PASSWORD was not 1 to 8 bytes in length.
must be defined in the local SYSIBM.LULIST table. In
this case, the remote sysplex LU can be defined in the
Chapter 39. DB2 Codes 877
00D31049 • 00D3104C
local SYSIBM.LULIST table although a the unit of work had to be aborted.
SYSIBM.LUNAMES definition, default row or explicit
Problem Determination: Collect the following
definition, is appropriate in cases where it is undesirable
diagnostic items listed in “Appendix B. Problem
to define the remote LU in SYSIBM.LULIST (for
determination” on page 1281: 1.
example when you don’t want the remote LU to be a
candidate member when outbound accessing the
remote SYSPLEX location). 00D3104B
A DSNL030I message may have been written to the Explanation: An SNA conversation was rejected by a
console at the server. DB2 server because the SNA FMH5 specified SNA
persistent verification. DB2 does not support the SNA
Problem Determination: Collect the following
persistent verification option.
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 58. This abend reason code is issued by the following
CSECT: DSNLVPF5
00D31049 System Action: Message DSNL030I is displayed on
the system console with reason code 00D3104B. The
Explanation: A request using application-directed
SNA conversation is rejected with SNA sense code
access starting at site 'A' referenced an object at site 'B'
X'080F6051', indicating the SNA security parameters in
that is stored at site 'A'
the FMH5 were not acceptable.
This abend reason code is issued by the following
User Response: Notify the DB2 system programmer.
CSECT: DSNLCCCN
System Programmer Response: The SECACPT
System Action: The application statement was not
keyword on the VTAM APPL statement tells VTAM
processed.
whether DB2 supports persistent verification. Because
User Response: Recode the application to remove DB2 does not support persistent verification, the
the alias reference at the remote server that resolves to SECACPT=PERSISTV and SECACPT=AVPV options
an object stored at the local DB2. Objects stored at the cannot be used on DB2’s VTAM APPL statement.
local site must be referenced using a local name.
Problem Determination: Collect the following
Problem Determination: If necessary, consult with the diagnostic items listed in “Appendix B. Problem
database administrators at the local site and the remote determination” on page 1281: 1.
server location. Inspect the remote
SYSIBM.SYSTABLES catalog table to determine the
00D3104C
object at this location being referenced in a circular
manner. Explanation: The SNA Exchange Log Names (XLN)
process failed because of a log name mismatch
between DB2 and a remote LU in the network.
00D3104A
This abend reason code is issued by the following
Explanation: A remote server issued an SNA
CSECT: DSNLCXLI
BACKOUT, which was not sent as a reply to an SNA
PREPARE or REQUEST_COMMIT. This indicates the System Action: The attempt to allocate an SNA
server backed out the current unit of work without two-phase commit conversation fails with reason code
waiting for the SQL application to either commit or roll 00D3104C. Message DSNL410 is displayed on the
back. system console to describe the error.
This abend reason code is issued by the following User Response: Contact the DB2 systems
CSECT: DSNLVRPL programmer.
System Action: The attempt to access the remote System Programmer Response: The log name
database resource fails and the failure is reported to the recorded in the DB2 log does not match the log name
application. DB2 terminates the SNA conversation to the currently in use at the remote LU. There are indoubt
remote server and forces the application to roll back. units of work that need to be resolved at this DB2
system. The log name required to resolve the indoubt
User Response: Notify the DB2 systems programmer.
units of work is displayed in the DSNL410 message.
System Programmer Response: DB2 never issues
If a non-DB2 partner was started with the wrong log, it
an unsolicited SNA BACKOUT. Non-DB2 servers can
might be possible to restart the non-DB2 partner with
send an SNA BACKOUT indication when resources
the desired log name. This should cause the indoubt
required to complete the unit of work are not available.
units of work to be resolved automatically.
For example, a deadlock might cause the non-DB2
server to send an SNA BACKOUT. Contact the system If the partner cannot be restarted with the desired log
programmer for the remote system to determine why name, the -RECOVER INDOUBT command can be
878 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D3104D • 00D31050
used to resolve the indoubt units of work. Once the
00D3104F
indoubt units of work are resolved, DB2 will accept an
SNA XLN with a new partner log name. Explanation: A connection to a remote location was
lost during a previous communication operation.
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem This abend reason code is issued by the following
determination” on page 1281: 1. CSECTs:
DSNLCBCS DSNLCSRM DSNLCSRR DSNLCMSR
00D3104D
Explanation: The local DB2 system does not support System Action: If the communication failure occurred
connectivity to the DB2 release currently running at the during a commit or abort operation, the SQL application
remote DB2 site. might not be aware that a failure occurred. Messages
This abend reason code is issued by the following associated with the failure were written to the system
CSECT: DSNLCSIM console at the time of failure. Additionally, alerts were
reported to NetView at the time of failure.
System Action: The attempt to allocate an SNA
conversation is rejected with reason code 00D3104D. User Response: Reestablish the connection to the
remote site and reissue the SQL statement.
User Response: Contact the DB2 systems
programmer. Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
System Programmer Response: DB2 distributed determination” on page 1281: 1.
database connections can only be established between
compatible DB2 releases. For example, DB2 Version 3
can connect to DB2 2.3, but not to DB2 2.2. 00D31050
In order to establish connectivity, the down-level DB2 Explanation: DB2 expected to receive security
system must be migrated to a supported release of information for the remote client but a valid DRDA
DB2. SECCHK command was not received for a connection
request from a DRDA application requester (AR). The
Problem Determination: Collect the following DRDA SECCHK command is only valid with a DRDA
diagnostic items listed in “Appendix B. Problem security manager level greater than or equal to 5.
determination” on page 1281: 1.
This can be the case if one of the following occurs:
v The DRDA AR requested a DRDA security manager
00D3104E
less than level 5 for an SNA connection where the
Explanation: An SNA Exchange Log Names (XLN) APPL command for DB2 was specified with the
protocol violation was detected when attempting to SECACPT=NONE option.
establish a connection to a remote site. v The DRDA SECCHK command did not contain the
This abend reason code is issued by the following required security information.
CSECT: DSNLCXLI v The DRDA AR requested a DRDA security manager
less than level 5 for a TCP/IP connection.
System Action: The attempt to allocate an SNA
conversation is rejected with reason code 00D3104E.
This abend reason code is issued by the following
Message DSNL421E is written to the system console
CSECTs: DSNLTEXC, DSNLTSEC.
and IFCID 0213 is produced to describe the protocol
violation. System Action: The attempt to access the local
database resource fails, the failure is reported to the
User Response: Contact the DB2 systems
SQL application, and the conversation is terminated.
programmer.
System Programmer Response: For SNA
System Programmer Response: Contact the system
connections, if SECACPT=NONE and the DRDA AR
programmer for the remote site. The invalid XLN
does not support DRDA security manager level 5,
message is recorded in the IFCID 0213 trace record.
contact the DB2 security administrator to change the
The system logic error that causes the invalid XLN
SECACPT option to ALREADYV or CONV to allow for
message must be corrected at the remote site.
security information in the VTAM FMH-5 in the form of
Problem Determination: Collect the following userid or userid/password fields. If SECACPT=NONE is
diagnostic items listed in “Appendix B. Problem not changed, then DB2 cannot accept connection
determination” on page 1281: 1. requests from this remote client.
For SNA connections, If SECACPT=ALREADYV or
CONV, then even though userid or userid/password
fields in the FMH-5 are received and validated, DB2
Chapter 39. DB2 Codes 879
00D31052 • 00D31058
must evaluate a DRDA SECCHK command if it is sent. v If the remote site is correctly defined in the CDB,
If the DRDA AR requests this level of security but does examine the messages written to the console during
not provide the correct information in the form of a -START DDF processing. Those messages describe
SECCHK command, this is a DRDA protocol error any errors that would prevent DDF from using
committed by the DRDA AR implementation at the TCP/IP.
remote client.
Problem Determination: Collect the following
For TCP/IP connections, this is a DRDA protocol error diagnostic items listed in “Appendix B. Problem
committed by the DRDA AR implementation at the determination” on page 1281: 1.
remote client.
Problem Determination: If you suspect an error in 00D31056
DB2, refer to Part 2 of DB2 Diagnosis Guide and
Explanation: The PORT column of the
Reference for information on identifying and reporting
SYSIBM.LOCATIONS table could not be converted to a
the problem. Collect the following diagnostic items listed
TCP/IP port number by the getservbyname TCP/IP
in “Appendix B. Problem determination” on page 1281:
socket call.
1, 2, 5.
This abend reason code is issued by the following
CSECT: DSNLxxxx
00D31052
System Action: The request to connect to a remote
Explanation: An application caused recursive access
site fails. The SQL application receives a -904
to a remote location, followed by access to another
SQLCODE, and message DSNL514, DSNL517, or
remote location, which is not permitted.
DSNL518 is written to the console describing the error.
For example, an application at location LOC1 might
User Response: Notify the system programmer.
have connected to location LOC2 and accessed a table
using an alias that resolves back to LOC1. There was a Operator Response: Notify the system programmer.
subsequent remote access from LOC1 to LOCn, which
caused the error. System Programmer Response: Use the information
in the DSNL514, DSNL517, or DSNL518 message to
System Action: The attempt to access the remote resolve the erorr.
location fails. The SQL application receives a -904
SQLCODE. Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
System Programmer Response: Correct the determination” on page 1281: 1.
application program so that it does not cause recursive
access to a location followed by remote access from
that location. The application might have used table 00D31057
aliases, three-part table names, stored procedures, Explanation: DB2 was able to find the row in
user-defined functions, or triggers to cause the SYSIBM.LOCATIONS for the LOCATION specified in
condition. the SQL request. However, the LINKNAME column
Problem Determination: Collect the following value specified in LOCATIONS did not match any row in
diagnostic items listed in “Appendix B. Problem SYSIBM.LUNAMES or SYSIBM.IPNAMES.
determination” on page 1281: 1, 35, 73, 74. This abend reason code is issued by the following
CSECT: DSNLxxxx
00D31055 System Action: The request to connect to a remote
Explanation: The remote location defined in the site fails. The SQL application receives a -904
SYSIBM.LOCATIONS table could not be accessed SQLCODE.
because the TCP/IP interface to DDF is not available. User Response: Notify the system programmer.
System Action: The request to connect to a remote Operator Response: Notify the system programmer.
site fails. The SQL application receives a -904
SQLCODE. System Programmer Response: Insert a row in
SYSIBM.LUNAMES or SYSIBM.IPNAMES that matches
User Response: Notify the system programmer. the LINKNAME specified in SYSIBM.LOCATIONS.
Operator Response: Notify the system programmer.
System Programmer Response: One of two actions 00D31058
should be taken: Explanation: The IPADDR column of the
v If the remote site is not supposed to be using TCP/IP, SYSIBM.IPNAMES table could not be converted to an
add a row to SYSIBM.LUNAMES defining the IP address by the gethostbyname TCP/IP socket call.
LUNAME used by the remote location.
880 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D31059 • 00D31102
This abend reason code is issued by the following System Action: A record is written to SYS1.LOGREC
CSECT: DSNLxxxx and an SVC dump is requested at the site of the DB2
abend.
System Action: The request to connect to a remote
site fails. The SQL application receives a -904 Operator Response: Notify the system programmer.
SQLCODE, and message DSNL513, DSNL517, or
System Programmer Response: Determine which
DSNL518 is written to the console describing the error.
sites the abending agent was connected to by
User Response: Notify the system programmer. examining the DSNL027 and DSNL028 SYSLOG
console messages at the site of the DB2 abend. Obtain
Operator Response: Notify the system programmer.
any related diagnostic information from each connected
System Programmer Response: Use the information site and the SVC dump and STS1.LOGREC at the site
in the DSNL513, DSNL517, or DSNL518 message to of a DB2 abend.
resolve the erorr.
Refer to Part 2 of DB2 Diagnosis Guide and Reference
Problem Determination: Collect the following for information on identifying and reporting the problem.
diagnostic items listed in “Appendix B. Problem
Problem Determination: Collect the following
determination” on page 1281: 1.
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57.
| 00D31059
| Explanation: An attempt to allocate a conversation to 00D31101
| the remote site failed because DB2 was unable to
Explanation: A data communications functional
| obtain a RACF PassTicket. The user specified an 'R' in
service was invoked with the cursor table marked
| the SECURITY_OUT column of the SYSIBM.IPNAMES
invalid. This is an internal error.
| and/or SYSIBM.LUNAMES communications database
| (CDB) tables for the partner site. As a result, DB2 This abend reason code is issued by the following
| invokes RACF to extract a PassTicket for the partner CSECTs:
| site. However, RACF could not provide a PassTicket,
| and the attempt faild. DSNLCCCN DSNLCCDR DSNLCSRM
| System Action: The attempt to access the remote
| database resource failed, and the failure is reported to System Action: A record is written to SYS1.LOGREC
| the application. and an SVC dump is requested at the site of the DB2
abend.
| User Response: Notify the system programmer.
Operator Response: Notify the system programmer.
| System Programmer Response: The error usually
| occurs due to incorrect or mising RACF definitions. To System Programmer Response: Determine which
| avoid this error, specify the proper RACF definitions to sites the abending agent was connected to by
| provide for the PassTicket. Alternatively, you may avoid examining the DSNL027 and DSNL028 SYSLOG
| the use of PassTickets by changing the console messages at the site of the DB2 abend. Obtain
| SECURITY_OUT column of the SYSIBM.IPNAMES any related diagnostic information from each connected
| and/or SYSIBM.LUNAMES CDB table for the partner site and the SVC dump and SYS1.LOGREC at the site
| site. For information regarding PassTickets, refer to Part of the DB2 failure.
| 3 (Volume 1) of of DB2 Administration Guide. Refer to Part 2 of DB2 Diagnosis Guide and Reference
| Problem Determination: Collect the following for information on identifying and reporting the problem.
| diagnostic items listed in “Appendix B. Problem Problem Determination: Collect the following
| determination” on page 1281: 14, 58, 74. diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57.
00D31100
Explanation: The data communications function 00D31102
service was invoked with a parameter list that contained Explanation: A data communications functional
one or more invalid parameters. This is an internal error. service encountered an inconsistency in the requesting
This abend reason code is issued by the following thread control block structure. This is an internal error.
CSECTs: This abend reason code is issued by the following
CSECTs:
DSNLCBCS DSNLCBUF DSNLCCCN DSNLCCDR
DSNLCCNR DSNLCSIM DSNLCMSR DSNLCSRM DSNLCCCN DSNLCSRM DSNLCTCN
DSNLCTCN DSNLCTDR DSNLCTRC
System Action: A record is written to SYS1.LOGREC
Chapter 39. DB2 Codes 881
00D31103 • 00D31106
and an SVC dump is requested at the site of the DB2 Operator Response: Notify the system programmer.
abend.
System Programmer Response: Determine which
Operator Response: Notify the system programmer. sites the abending agent was connected to by
examining the DSNL027 and DSNL028 SYSLOG
System Programmer Response: Determine which
console messages at the site of the DB2 abend. Obtain
sites the abending agent was connected to by
any related diagnostic information from each connected
examining the DSNL027 and DSNL028 SYSLOG
site and the SVC dump and SYS1.LOGREC at the site
console messages at the site of the DB2 abend. Obtain
of the DB2 failure.
copies of the SYS1.LOGREC and SYSLOG data sets or
similar data from each connected site, the SVC dump at If you suspect an error in DB2, refer to Part 2 of DB2
the site of the DB2 failure, and any related dumps from Diagnosis Guide and Reference for information on
each connected site. identifying and reporting the problem.
Refer to Part 2 of DB2 Diagnosis Guide and Reference Problem Determination: Collect the following
for information on identifying and reporting the problem. diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57.
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57. 00D31105
Explanation: A data communications functional
00D31103 service detected an invalid or incorrect buffer size on a
send message operation. This is an internal error.
Explanation: A data communications functional
service received an invalid logical-unit-of-work ID This abend reason code is issued by the following
(LUWID) or no LUWID. This is an internal error. CSECT: DSNLCSRM
This abend reason code is issued by the following System Action: A record is written to SYS1.LOGREC
CSECTs: DSNLCCCN, DSNLCCDR and an SVC dump is requested at the site of the DB2
abend.
System Action: A record is written to SYS1.LOGREC
and an SVC dump is requested at the site of the DB2 Operator Response: Notify the system programmer.
abend.
System Programmer Response: Determine which
Operator Response: Notify the system programmer. sites the abending agent was connected to by
examining the DSNL027 and DSNL028 SYSLOG
System Programmer Response: Determine which
console messages at the site of the DB2 abend. Obtain
sites the abending agent was connected to by
copies of the SYS1.LOGREC and SYSLOG data sets
examining the DSNL027 and DSNL028 SYSLOG
from each connected site, the SVC dump at the site of
console messages at the site of the DB2 abend. Obtain
the DB2 failure, and any related dumps from each
any related diagnostic information from each connected
connected site.
site and the SVC dump and SYS1.LOGREC as the site
of the DB2 failure. Refer to Part 2 of DB2 Diagnosis Guide and Reference
for information on identifying and reporting the problem.
Refer to Part 2 of DB2 Diagnosis Guide and Reference
for information on identifying and reporting the problem. Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
Problem Determination: Collect the following
determination” on page 1281: 56, 57.
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57.
00D31106
00D31104 Explanation: A data communications functional
service detected an invalid message sequence. One or
Explanation: A data communications functional
more rows of data might have been lost. This is an
service cannot find a distributed processing block for the
internal error.
primary thread. This is an internal error.
This abend reason code is issued by the following
This abend reason code is issued by the following
CSECT: DSNLCSRM
CSECTs:
System Action: A record is written to SYS1.LOGREC
DSNLCSRM DSNLCTCN DSNLCBCS DSNLCCNR and an SVC dump is requested at the site of the DB2
DSNLCPCR DSNLCTDR abend.
Operator Response: Notify the system programmer.
System Action: A record is written to SYS1.LOGREC
and an SVC dump is requested at the site of the DB2 System Programmer Response: Determine which
abend. sites the abending agent was connected to by
882 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D31107 • 00D3110A
examining the DSNL027 and DSNL028 SYSLOG Refer to Part 2 of DB2 Diagnosis Guide and Reference
console messages at the site of the DB2 abend. Obtain for information on identifying and reporting the problem.
copies of the SYS1.LOGREC and SYSLOG data sets
Problem Determination: Collect the following
from each connected site, the SVC dump at the site of
diagnostic items listed in “Appendix B. Problem
the DB2 failure, and any related dumps from each
determination” on page 1281: 56, 57.
connected site.
Refer to Part 2 of DB2 Diagnosis Guide and Reference
00D31109
for information on identifying and reporting the problem.
Explanation: A data communications functional
Problem Determination: Collect the following
service was invoked incorrectly (protocol violation) to
diagnostic items listed in “Appendix B. Problem
send a message. This is an internal error.
determination” on page 1281: 56, 57.
This abend reason code is issued by the following
CSECTs: DSNLCSRM, DSNLCCNR
00D31107
System Action: A record is written to SYS1.LOGREC
Explanation: A data communications functional
and an SVC dump is requested at the site of the DB2
service was invoked incorrectly (protocol violation) to
abend.
wait for a message. This is an internal error.
Operator Response: Notify the system programmer.
This abend reason code is issued by the following
CSECTs: DSNLCSRM, DSNLCCNR System Programmer Response: Determine which
sites the abending agent was connected to by
System Action: A record is written to SYS1.LOGREC
examining the DSNL027 and DSNL028 SYSLOG
and an SVC dump is requested at the site of the DB2
console messages at the site of the DB2 abend. Obtain
abend.
any related diagnostic information from each connected
Operator Response: Notify the system programmer. site and the SVC dump and SYS1.LOGREC at the site
of the DB2 failure.
System Programmer Response: Determine which
sites the abending agent was connected to by Refer to Part 2 of DB2 Diagnosis Guide and Reference
examining the DSNL027 and DSNL028 SYSLOG for information on identifying and reporting the problem.
console messages at the site of the DB2 abend. Obtain
Problem Determination: Collect the following
any related diagnostic information from each connected
diagnostic items listed in “Appendix B. Problem
site and the SVC dump and SYS1.LOGREC at the site
determination” on page 1281: 56, 57.
of the DB2 failure.
Refer to Part 2 of DB2 Diagnosis Guide and Reference
00D3110A
for information on identifying and reporting the problem.
Explanation: A data communications functional
Problem Determination: Collect the following
service detected an invalid message sequence. One or
diagnostic items listed in “Appendix B. Problem
more rows of data might have been lost. This is an
determination” on page 1281: 56, 57.
internal error.
This abend reason code is issued by the following
00D31108
CSECTs: DSNLCSRM, DSNLCBCS
Explanation: A data communications functional
System Action: A record is written to SYS1.LOGREC
service was invoked incorrectly (protocol violation) to
and an SVC dump is requested at the site of the DB2
receive a message. This is an internal error.
abend.
This abend reason code is issued by the following
Operator Response: Notify the system programmer.
CSECTs: DSNLCSRM, DSNLCCNR
System Programmer Response: Determine which
System Action: A record is written to SYS1.LOGREC
sites the abending agent was connected to by
and an SVC dump is requested at the site of the DB2
examining the DSNL027 and DSNL028 SYSLOG
abend.
console messages at the site of the DB2 abend. Obtain
Operator Response: Notify the system programmer. copies of the SYS1.LOGREC and SYSLOG data sets
from each connected site, the SVC dump at the site of
System Programmer Response: Determine which
the DB2 failure, and any related dumps from each
sites the abending agent was connected to by
connected site.
examining the DSNL027 and DSNL028 SYSLOG
console messages at the site of the DB2 abend. Obtain Refer to Part 2 of DB2 Diagnosis Guide and Reference
any related diagnostic information from each connected for information on identifying and reporting the problem.
site and the SVC dump and SYS1.LOGREC at the site
Problem Determination: Collect the following
of the DB2 failure.
diagnostic items listed in “Appendix B. Problem
Chapter 39. DB2 Codes 883
00D3110B • 00D31112
determination” on page 1281: 56, 57. determination” on page 1281: 56, 57.
00D3110B 00D31111
Explanation: While a message was being sent or Explanation: The instrumentation facility component
received by the data communications resource (IFC) passed a nonzero return code to the data
manager, an internal error was detected in DB2. communications resource manager. This is an internal
Register 4 contains a reason code that provides error.
additional information about this error. This is an internal
This abend reason code is issued by the following
error.
CSECTs: DSNLCRTR, DSNLCRTD
This abend reason code is issued by the following
System Action: A record is written to SYS1.LOGREC
CSECTs:
and an SVC dump is requested at the site of the DB2
DSNLCSRM DSNLCSBC DSNLCSIM DSNLCSRR abend.
Operator Response: Notify the system programmer.
System Action: A record is written to SYS1.LOGREC System Programmer Response: Determine which
and an SVC dump is requested at the site of the DB2 sites the abending agent was connected to by
abend. examining the DSNL027 and DSNL028 SYSLOG
Operator Response: Notify the system programmer. console messages at the site of the DB2 abend. Obtain
any related diagnostic information from each connected
System Programmer Response: Determine which site and the SVC dump and SYS1.LOGREC at the site
sites the abending agent was connected to by of the DB2 failure.
examining the DSNL027 and DSNL028 SYSLOG
console messages at the site of the DB2 abend. Obtain Refer to Part 2 of DB2 Diagnosis Guide and Reference
any related diagnostic information from each connected for information on identifying and reporting the problem.
site and the SVC dump and SYS1.LOGREC at the site Problem Determination: Collect the following
of the DB2 failure. diagnostic items listed in “Appendix B. Problem
Refer to Part 2 of DB2 Diagnosis Guide and Reference determination” on page 1281: 56, 57.
for information on identifying and reporting the problem.
Problem Determination: Collect the following 00D31112
diagnostic items listed in “Appendix B. Problem Explanation: The data communications resource
determination” on page 1281: 56, 57. manager cannot find the LUWID for the remote thread
in the database thread control blocks. This is an internal
00D31110 error.
Explanation: Instrumentation facility component (IFC) This abend reason code is issued by the following
has passed a nonzero return code to the data CSECTs: DSNLCRTR, DSNLCRTD
communications resource manager. This is an internal System Action: A record is written to SYS1.LOGREC
error. and an SVC dump is requested at the site of the DB2
This abend reason code is issued by the following abend.
CSECTs: DSNLCRTR, DSNLCRTD Operator Response: Notify the system programmer.
System Action: A record is written to SYS1.LOGREC System Programmer Response: Determine which
and an SVC dump is requested at the site of the DB2 sites the abending agent was connected to by
abend. examining the DSNL027 and DSNL028 SYSLOG
Operator Response: Notify the system programmer. console messages at the site of the DB2 abend. Obtain
any related diagnostic information from each connected
System Programmer Response: Determine which site and the SVC dump and SYS1.LOGREC at the site
sites the abending agent was connected to by of the DB2 failure.
examining the DSNL027 and DSNL028 SYSLOG
console messages at the site of the DB2 abend. Obtain Refer to Part 2 of DB2 Diagnosis Guide and Reference
any related diagnostic information from each connected for information on identifying and reporting the problem.
site and the SVC dump and SYS1.LOGREC at the site Problem Determination: Collect the following
of the DB2 failure. diagnostic items listed in “Appendix B. Problem
Refer to Part 2 of DB2 Diagnosis Guide and Reference determination” on page 1281: 56, 57.
for information on identifying and reporting the problem.
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
884 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D31113 • 00D31116
00D31113 00D31115
Explanation: The data communications resource Explanation: The data communications resource
manager received an invalid set of control block manager attempt to enqueue a request for a database
pointers. This is an internal error. access thread failed. This is an internal error.
This abend reason code is issued by the following This abend reason code is issued by the following
CSECT: DSNLCRTR CSECT: DSNLCRTR
System Action: A record is written to SYS1.LOGREC System Action: A record is written to SYS1.LOGREC
and an SVC dump is requested at the site of the DB2 and an SVC dump is requested at the site of the DB2
abend. abend.
Operator Response: Notify the system programmer. Operator Response: Notify the system programmer.
System Programmer Response: Determine which System Programmer Response: Determine which
sites the abending agent was connected to by sites the abending agent was connected to by
examining the DSNL027 and DSNL028 SYSLOG examining the DSNL027 and DSNL028 SYSLOG
console messages at the site of the DB2 abend. Obtain console messages at the site of the DB2 abend. Obtain
copies of the SYS1.LOGREC and SYSLOG data sets or copies of the SYS1.LOGREC and SYSLOG data sets or
similar data from each connected site, the SVC dump at similar data from each connected site, the SVC dump at
the site of the DB2 failure, and any related dumps from the site of the DB2 failure, and any related dumps from
each connected site. each connected site.
Refer to Part 2 of DB2 Diagnosis Guide and Reference Refer to Part 2 of DB2 Diagnosis Guide and Reference
for information on identifying and reporting the problem. for information on identifying and reporting the problem.
Problem Determination: Collect the following Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57. determination” on page 1281: 56, 57.
00D31114 00D31116
Explanation: A data communications resource Explanation: The data communications resource
manager(DCCM) block for a deallocated conversation manager received an invalid DC message number. This
which belongs to a database access thread cannot be is an internal error.
found. This is an internal error.
This abend reason code is issued by the following
This abend reason code is issued by the following CSECT: DSNLCRTR
CSECT: DSNLCRTR
System Action: A record is written to SYS1.LOGREC
System Action: A record is written to SYS1.LOGREC and an SVC dump is requested at the site of the DB2
and an SVC dump is requested at the site of the DB2 abend.
abend.
Operator Response: Notify the system programmer.
Operator Response: Notify the system programmer.
System Programmer Response: Determine which
System Programmer Response: Determine which sites the abending agent was connected to by
sites the abending agent was connected to by examining the DSNL027 and DSNL028 SYSLOG
examining the DSNL027 and DSNL028 SYSLOG console messages at the site of the DB2 abend. Obtain
console messages at the site of the DB2 abend. Obtain copies of the SYS1.LOGREC and SYSLOG data sets or
copies of the SYS1.LOGREC and SYSLOG data sets or similar data from each connected site, the SVC dump at
similar data from each connected site, the SVC dump at the site of the DB2 failure, and any related dumps from
the site of the DB2 failure, and any related dumps from each connected site.
each connected site.
Refer to Part 2 of DB2 Diagnosis Guide and Reference
Refer to Part 2 of DB2 Diagnosis Guide and Reference for information on identifying and reporting the problem.
for information on identifying and reporting the problem.
Problem Determination: Collect the following
Problem Determination: Collect the following diagnostic items listed in “Appendix B. Problem
diagnostic items listed in “Appendix B. Problem determination” on page 1281: 56, 57.
determination” on page 1281: 56, 57.
Chapter 39. DB2 Codes 885
00D31117 • 00D3111A
00D31117 00D31119
Explanation: The data communications resource Explanation: The data communications resource
manager received a request with an invalid response manager processed a request with an unassigned or
type. This is an internal error. disconnected message class. This is an internal error.
This abend reason code is issued by the following This abend reason code is issued by the following
CSECT: DSNLCRTR CSECT: DSNLCRTR
System Action: A record is written to SYS1.LOGREC System Action: A record is written to SYS1.LOGREC
and an SVC dump is requested at the site of the DB2 and an SVC dump is requested at the site of the DB2
abend. abend.
Operator Response: Notify the system programmer. Operator Response: Notify the system programmer.
System Programmer Response: Determine which System Programmer Response: Determine which
sites the abending agent was connected to by sites the abending agent was connected to by
examining the DSNL027 and DSNL028 SYSLOG examining the DSNL027 and DSNL028 SYSLOG
console messages at the site of the DB2 abend. Obtain console messages at the site of the DB2 abend. Obtain
copies of the SYS1.LOGREC and SYSLOG data sets or copies of the SYS1.LOGREC and SYSLOG data sets
similar data from each connected site, the SVC dump at from each connected site, the SVC dump at the site of
the site of the DB2 failure, and any related dumps from the DB2 failure, and any related dumps from each
each connected site. connected site.
Refer to Part 2 of DB2 Diagnosis Guide and Reference Refer to Part 2 of DB2 Diagnosis Guide and Reference
for information on identifying and reporting the problem. for information on identifying and reporting the problem.
Problem Determination: Collect the following Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57. determination” on page 1281: 56, 57.
00D31118 00D3111A
Explanation: A message-processing routine returned Explanation: The data communications resource
to the data communications resource manager without manager received an unexpected communications error
the requested response. This is an internal error. when processing a request. This can occur for any of
the following reasons:
This abend reason code is issued by the following
CSECT: DSNLCRTR v A VTAM session failure caused the premature
termination of a DB2 conversation.
System Action: A record is written to SYS1.LOGREC
v A VTAM VARY NET, INACTIVE or HALT NET
and an SVC dump is requested at the site of the DB2
command was issued which interrupted a DB2
abend.
conversation.
Operator Response: Notify the system programmer. v A DB2 internal logic error occurred.
System Programmer Response: Determine which
sites the abending agent was connected to by This abend reason code is issued by the following
examining the DSNL027 and DSNL028 SYSLOG CSECTs:
console messages at the site of the DB2 abend. Obtain
DSNLCRTR DSNLCSIM DSNLCSND
copies of the SYS1.LOGREC and SYSLOG data sets or
similar data from each connected site, the SVC dump at
the site of the DB2 failure, and any related dumps from System Action: A record is written to SYS1.LOGREC
each connected site. and an SVC dump may be requested at the site of the
DB2 abend.
Refer to Part 2 of DB2 Diagnosis Guide and Reference
for information on identifying and reporting the problem. Operator Response: Notify the system programmer.
Problem Determination: Collect the following System Programmer Response: If the abend
diagnostic items listed in “Appendix B. Problem appears to have been caused by a DB2 logic error,
determination” on page 1281: 56, 57. determine which sites the abending agent was
connected to by examining the DSNL027 and DSNL028
SYSLOG console messages at the site of the DB2
abend. Obtain copies of the SYS1.LOGREC and
SYSLOG data sets or similar data from each connected
886 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D3111B • 00D3111F
site as well as any related dumps from each connected console messages at the site of the DB2 abend. Obtain
site. copies of the SYS1.LOGREC and SYSLOG data sets
from each connected site, the SVC dump at the site of
If you suspect an error in DB2, refer to Part 2 of DB2
the DB2 failure, and any related dumps from each
Diagnosis Guide and Reference for information on
connected site. If you suspect an error in DB2, refer to
identifying and reporting the problem.
Part 2 of DB2 Diagnosis Guide and Reference for
Problem Determination: Collect the following information on identifying and reporting the problem.
diagnostic items listed in “Appendix B. Problem
Problem Determination: Collect the following
determination” on page 1281: 56, 57.
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57.
00D3111B
Explanation: The data communications resource 00D3111F
manager cannot find the remote location for the
Explanation: The maximum amount of buffered query
requesting thread in the control blocks. This is an
data has been exceeded. Rather than return one block
internal error.
of query data, the DRDA server system elected to return
This abend reason code is issued by the following multiple extra blocks. Instead of fetching all rows in all
CSECT: DSNLCSIM the extra blocks, the requesting application executed an
SQL statement not related to the query or executed a
System Action: A record is written to SYS1.LOGREC commit while a held cursor was still open. DB2 buffers
and an SVC dump is requested at the site of the DB2 the extra in-transit blocks, however DB2 was not able to
abend. buffer the entire set of extra blocks and thus truncated
Operator Response: Notify the system programmer. the result set. The application then resumed fetching
and attempted to fetch data beyond the point of
System Programmer Response: Determine which truncation.
sites the abending agent was connected to by
examining the DSNL027 and DSNL028 SYSLOG System Action: The SQL statement fails.
console messages at the site of the DB2 abend. Obtain User Response: Notify the system programmer.
copies of the SYS1.LOGREC and SYSLOG data sets or
similar data from each connected site, the SVC dump at Operator Response: Notify the system programmer.
the site of the DB2 failure, and any related dumps from
System Programmer Response: Determine the
each connected site.
failing application program and consider the following
Refer to Part 2 of DB2 Diagnosis Guide and Reference resolutions:
for information on identifying and reporting the problem. v The cursor definition may cause the server to return
Problem Determination: Collect the following extra blocks. In this case, the cursor definition can be
diagnostic items listed in “Appendix B. Problem changed to reduce the number of rows, thus extra
determination” on page 1281: 56, 57. blocks, being returned by the server.
DB2 UDB Server for OS/390 and z/OS systems
return extra blocks for cursors defined with the
00D3111C Optimize For n Rows clause and will return only
Explanation: An internal logic error occurred while enough extra blocks in order to return n rows. When
invoking a TCP/IP functional service. a cursor is defined with Optimize For n Rows, either
in the application or in a stored procedure, this
This abend reason code is issued by the following indicates an application intent to fetch all n rows
CSECT: DSNLInnn before attempting to execute other SQL statements.
DSNLInnn identifies that a DCRM TCP/IP manager The application is not abiding by its intent and is
CSECT detected a logic error. Refer to the dump title executing other SQL, or committing, prior to fetching
for the specific CSECT name. all n rows. In this case, the cursor definition can be
changed to reduce the value of n, or the application
System Action: A record is written to SYS1.LOGREC logic can be modified to fetch all n rows or to close
and an SVC dump is requested at the site of the DB2 the cursor before executing the statement that
abend. caused the in-transit data to be buffered.
User Response: Notify the system programmer. v The number of extra blocks returned can be
controlled by DB2 installation parameters. The
Operator Response: Collect the SYS1.LOGREC maximum number of extra blocks requested by a
listing and the SVC dump. DB2 requester system is determined by the ″Extra
System Programmer Response: Determine which Blocks Req″ option of the DSNTIP5 DB2 installation
sites the abending agent was connected to by panel. This value can be reduced which prevents the
examining the DSNL027 and DSNL028 SYSLOG
Chapter 39. DB2 Codes 887
00D34401 • 00D34406
server system from returning more blocks than the examining the DSNL027 and DSNL028 SYSLOG
DB2 requester system can buffer. console messages at the site of the DB2 abend. Obtain
Similarly, the server system may also provide a copies of the SYS1.LOGREC and SYSLOG data sets or
method to regulate the maximum number of extra similar data from each connected site, the SVC dump at
blocks that it will return to a requester in which case the site of the DB2 failure, and any related dumps from
this number can also be reduced. For DB2 UDB each connected site. Refer to Part 2 of DB2 Diagnosis
Server for OS/390 and z/OS systems, this is Guide and Reference for information on identifying and
determined by the ″Extra Blocks Srv″ option of the reporting the problem.
DSNTIP5 DB2 installation panel. Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
For information about block fetching result sets, see determination” on page 1281: 56, 57.
Part 5 (Volume 2) of DB2 Administration Guide.
Problem Determination: Collect the following 00D34405
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 14, 17. Explanation: The data communications resource
manager (DCRM) passed an invalid LMPP message
number to the distributed relational data system
00D34401 (DRDS). This is either an internal DCRM error or an
Explanation: The relational data system (RDS) internal DRDS error.
passed an invalid function code to the distributed RDS This abend reason code is issued by the following
(DRDS). This is an internal error. CSECT: DSNLXRTR
This abend reason code is issued by the following System Action: A record is written to SYS1.LOGREC
CSECT: DSNLXRDS and an SVC dump is requested at the site of the DB2
System Action: A record is written to SYS1.LOGREC abend.
and an SVC dump is requested at the site of the DB2 Operator Response: Notify the system programmer.
abend.
System Programmer Response: Determine which
Operator Response: Notify the system programmer. sites the abending agent was connected to by
System Programmer Response: Determine which examining the DSNL027 and DSNL028 SYSLOG
sites the abending agent was connected to by console messages at the site of the DB2 abend. Obtain
examining the DSNL027 and DSNL028 SYSLOG copies of the SYS1.LOGREC and SYSLOG data sets or
console messages at the site of the DB2 abend. Obtain similar data from each connected site, the SVC dump at
copies of the SYS1.LOGREC and SYSLOG data sets or the site of the DB2 failure, and any related dumps from
similar data from each connected site, the SVC dump at each connected site.
the site of the DB2 failure, and any related dumps from Refer to Part 2 of DB2 Diagnosis Guide and Reference
each connected site. for information on identifying and reporting the problem.
Refer to Part 2 of DB2 Diagnosis Guide and Reference Problem Determination: Collect the following
for information on identifying and reporting the problem. diagnostic items listed in “Appendix B. Problem
Problem Determination: Collect the following determination” on page 1281: 56, 57.
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57. 00D34406
Explanation: The distributed relational data system
00D34404 (DRDS) detected a message of invalid length from the
Explanation: The relational data system (RDS) data communications resource manager (DCRM). The
passed the distributed RDS (DRDS) an invalid message is longer than the buffer size. This is either an
distributed interface block (DIB). This is an internal RDS internal DRDS error or an internal DCRM error.
error. This abend reason code is issued by the following
This abend reason code is issued by the following CSECTs: DSNLXQPR, DSNLXSQD
CSECT: DSNLXRDS System Action: A record is written to SYS1.LOGREC
System Action: A record is written to SYS1.LOGREC and an SVC dump is requested at the site of the DB2
and an SVC dump is requested at the site of the DB2 abend.
abend. Operator Response: Notify the system programmer.
Operator Response: Notify the system programmer. System Programmer Response: Determine which
System Programmer Response: Determine which sites the abending agent was connected to by
sites the abending agent was connected to by examining the DSNL027 and DSNL028 SYSLOG
888 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D34407 • 00D3440B
console messages at the site of the DB2 abend. Obtain System Programmer Response: Determine which
copies of the SYS1.LOGREC and SYSLOG data sets or sites the abending agent was connected to by
similar data from each connected site, the SVC dump at examining the DSNL027 and DSNL028 SYSLOG
the site of the DB2 failure, and any related dumps from console messages at the site of the DB2 abend. Obtain
each connected site. copies of the SYS1.LOGREC and SYSLOG data sets or
similar data from each connected site, the SVC dump at
Refer to Part 2 of DB2 Diagnosis Guide and Reference
the site of the DB2 failure, and any related dumps from
for information on identifying and reporting the problem.
each connected site. Refer to Part 2 of DB2 Diagnosis
Problem Determination: Collect the following Guide and Reference for information on identifying and
diagnostic items listed in “Appendix B. Problem reporting the problem.
determination” on page 1281: 56, 57.
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
00D34407 determination” on page 1281: 56, 57.
Explanation: The distributed relational data system
(DRDS) received an invalid return code from the data 00D34409
communications resource manager (DCRM) on a SEND
Explanation: The distributed relational data system
request. This is a DCRM internal error.
(DRDS) detected an internal inconsistency. An invalid
This abend reason code is issued by the following state transition occurred. This is a DRDS internal error.
CSECTs:
This abend reason code is issued by the following
DSNLXQEX DSNLXQFH DSNLXQOP DSNLXQPR CSECTs:
DSNLXOPF DSNLXQFH DSNLXRTR
System Action: A record is written to SYS1.LOGREC
and an SVC dump is requested at the site of the DB2
System Action: A record is written to SYS1.LOGREC
abend.
and an SVC dump is requested at the site of the DB2
Operator Response: Notify the system programmer. abend.
System Programmer Response: Determine which Operator Response: Notify the system programmer.
sites the abending agent was connected to by
System Programmer Response: Determine which
examining the DSNL027 and DSNL028 SYSLOG
sites the abending agent was connected to by
console messages at the site of the DB2 abend. Obtain
examining the DSNL027 and DSNL028 SYSLOG
copies of the SYS1.LOGREC and SYSLOG data sets or
console messages at the site of the DB2 abend. Obtain
similar data from each connected site, the SVC dump at
copies of the SYS1.LOGREC and SYSLOG data sets or
the site of the DB2 failure, and any related dumps from
similar data from each connected site, the SVC dump at
each connected site. Refer to Part 2 of DB2 Diagnosis
the site of the DB2 failure, and any related dumps from
Guide and Reference for information on identifying and
each connected site. Refer to Part 2 of DB2 Diagnosis
reporting the problem.
Guide and Reference for information on identifying and
Problem Determination: Collect the following reporting the problem.
diagnostic items listed in “Appendix B. Problem
Problem Determination: Collect the following
determination” on page 1281: 56, 57.
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57.
00D34408
Explanation: The distributed relational data system 00D3440B
(DRDS) received an invalid LMPP from the data
Explanation: The distributed relational data system
communications resource manager (DCRM). This is
(DRDS) detected an inconsistency. This is an internal
either a DCRM internal error or a DRDS internal error.
error.
This abend reason code is issued by the following
This abend reason code is issued by the following
CSECTs:
CSECTs:
DSNLXOPF DSNLXPCL DSNLXPEX DSNLXPPR
DSNLXPXI DSNLXRTR
System Action: A record is written to SYS1.LOGREC
and an SVC dump is requested at the site of the DB2
abend.
Operator Response: Notify the system programmer.
Chapter 39. DB2 Codes 889
00D3440C • 00D3440F
DSNLXCMT DSNLXCNV DSNLXCQS DSNLXDSA This abend reason code is issued by the following
DSNLXGET DSNLXIVB DSNLXOPF DSNLXOQS CSECT: DSNLXDSA
DSNLXPEX DSNLXPPR DSNLXPRS DSNLXPXI System Action: A record is written to SYS1.LOGREC
DSNLXQAL DSNLXQCL DSNLXQEX DSNLXQFH and an SVC dump is requested at the site of the DB2
DSNLXQOP DSNLXQPR DSNLXQR DSNLXQRO abend.
DSNLXQUR DSNLXQXI DSNLXRAP DSNLXRAX
DSNLXRBF DSNLXRCL DSNLXRCM DSNLXRCS Operator Response: Notify the system programmer.
DSNLXRCX DSNLXRCX DSNLXRDS DSNLXRDT System Programmer Response: Determine which
DSNLXRFT DSNLXROP DSNLXRSL DSNLXRSQ sites the abending agent was connected to by
DSNLXRSS DSNLXRTR DSNLXRUW DSNLXXSS examining the DSNL027 and DSNL028 SYSLOG
console messages at the site of the DB2 abend. Obtain
System Action: DB2 writes a SYS1.LOGREC record copies of the SYS1.LOGREC and SYSLOG data sets or
and requests an SVC dump at the failed DB2 site. similar data from each connected site, the SVC dump at
the site of the DB2 failure, and any related dumps from
Operator Response: Notify the system programmer. each connected site. Refer to Part 2 of DB2 Diagnosis
System Programmer Response: Obtain copies of the Guide and Reference for information on identifying and
SYS1.LOGREC and SYSLOG data sets or similar data reporting the problem.
from each connected site, the SVC dump at the site of Problem Determination: Collect the following
the DB2 failure, and any related dumps from each diagnostic items listed in “Appendix B. Problem
connected site. Refer to Part 2 of DB2 Diagnosis Guide determination” on page 1281: 56, 57.
and Reference for information on identifying and
reporting the problem.
00D3440E
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem Explanation: A distributed request was received, but
determination” on page 1281: 56, 57. the distributed data facility (DDF) is inactive.
This reason code is issued by the following CSECTs:
00D3440C DSNLXRDS, DSNLXRUW
Explanation: The distributed relational data system System Action: The request is not processed.
(DRDS) requesting site control block must exist at this User Response: Notify the system operator.
time but does not. This is an internal DRDS error.
Operator Response: Ensure that the DDF has been
This abend reason code is issued by the following started.
CSECT: DXNLXRDS
System Action: A record is written to SYS1.LOGREC 00D3440F
and an SVC dump is requested at the site of the DB2
abend. Explanation: The distributed relational data system
(DRDS) detected a message of invalid length from the
Operator Response: Notify the system programmer. data communications resource manager (DCRM). The
System Programmer Response: Determine which message is smaller than the buffer size, but the return
sites the abending agent was connected to by code from the DCRM indicates that the message is
examining the DSNL027 and DSNL028 SYSLOG greater than one buffer. This is either an internal DRDS
console messages at the site of the DB2 abend. Obtain error or an internal DCRM error.
copies of the SYS1.LOGREC and SYSLOG data sets or This abend reason code is issued by the following
similar data from each connected site, the SVC dump at CSECTs: DSNLXQPR, DSNLXSQD
the site of the DB2 failure, and any related dumps from
each connected site. Refer to Part 2 of DB2 Diagnosis System Action: A record is written to SYS1.LOGREC
Guide and Reference for information on identifying and and an SVC dump is requested at the site of the DB2
reporting the problem. abend.
Problem Determination: Collect the following Operator Response: Notify the system programmer.
diagnostic items listed in “Appendix B. Problem
System Programmer Response: Determine which
determination” on page 1281: 56, 57.
sites the abending agent was connected to by
examining the DSNL027 and DSNL028 SYSLOG
00D3440D console messages at the site of the DB2 abend. Obtain
copies of the SYS1.LOGREC and SYSLOG data sets or
Explanation: The distributed statistics and accounting similar data from each connected site, the SVC dump at
control block does not exist. This is an internal the site of the DB2 failure, and any related dumps from
distributed data facility (DDF) error. each connected site. Refer to Part 2 of DB2 Diagnosis
890 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D34410 • 00D34413
Guide and Reference for information on identifying and Problem Determination: Collect the following
reporting the problem. diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57.
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57. 00D34412
Explanation: The distributed relational data system
00D34410 (DRDS) detected an internal inconsistency. An internal
buffer offset variable contains an invalid value. This is
Explanation: The distributed relational data system
an internal DRDS error.
(DRDS) received an invalid return code from the data
communications resource manager (DCRM) on a This abend reason code is issued by the following
RECEIVE request. This is an internal DCRM error. CSECT: DSNLXQGT
This abend reason code is issued by the following System Action: A record is written to SYS1.LOGREC
CSECTs: DSNLXQPR, DSNLXQFH and an SVC dump is requested at the site of the DB2
abend.
System Action: A record is written to SYS1.LOGREC
and an SVC dump is requested at the site of the DB2 Operator Response: Notify the system programmer.
abend.
System Programmer Response: Determine which
Operator Response: Notify the system programmer. sites the abending agent was connected to by
examining the DSNL027 and DSNL028 SYSLOG
System Programmer Response: Determine which
console messages at the site of the DB2 abend. Obtain
sites the abending agent was connected to by
copies of the SYS1.LOGREC and SYSLOG data sets or
examining the DSNL027 and DSNL028 SYSLOG
similar data from each connected site, the SVC dump at
console messages at the site of the DB2 abend. Obtain
the site of the DB2 failure, and any related dumps from
copies of the SYS1.LOGREC and SYSLOG data sets or
each connected site. Refer to Part 2 of DB2 Diagnosis
similar data from each connected site, the SVC dump at
Guide and Reference for information on identifying and
the site of the DB2 failure, and any related dumps from
reporting the problem.
each connected site. Refer to Part 2 of DB2 Diagnosis
Guide and Reference for information on identifying and Problem Determination: Collect the following
reporting the problem. diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57.
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57. 00D34413
Explanation: The data header on the message
00D34411 received from the responding site contains invalid
information. This is an internal error.
Explanation: The distributed relational data system
(DRDS) detected an internal inconsistency. An invalid This abend reason code is issued by the following
state is specified. This is an internal DRDS error. CSECTs: DSNLXQGT, DSNLXQFH
This abend reason code is issued by the following System Action: A record is written to SYS1.LOGREC
CSECTs: and an SVC dump is requested at the site of the DB2
abend.
DSNLXOPF DSNLXQFH DSNLXRTR
Operator Response: Notify the system programmer.
System Action: A record is written to SYS1.LOGREC System Programmer Response: Determine which
and an SVC dump is requested at the site of the DB2 sites the abending agent was connected to by
abend. examining the DSNL027 and DSNL028 SYSLOG
console messages at the site of the DB2 abend. Obtain
Operator Response: Notify the system programmer. copies of the SYS1.LOGREC and SYSLOG data sets or
System Programmer Response: Determine which similar data from each connected site, the SVC dump at
sites the abending agent was connected to by the site of the DB2 failure, and any related dumps from
examining the DSNL027 and DSNL028 SYSLOG each connected site. Refer to Part 2 of DB2 Diagnosis
console messages at the site of the DB2 abend. Obtain Guide and Reference for information on identifying and
copies of the SYS1.LOGREC and SYSLOG data sets or reporting the problem.
similar data from each connected site, the SVC dump at Problem Determination: Collect the following
the site of the DB2 failure, and any related dumps from diagnostic items listed in “Appendix B. Problem
each connected site. Refer to Part 2 of DB2 Diagnosis determination” on page 1281: 56, 57.
Guide and Reference for information on identifying and
reporting the problem.
Chapter 39. DB2 Codes 891
00D34414 • 00D34418
This abend reason code is issued by the following
00D34414
CSECT: DSNLXQFH
Explanation: The relational data system (RDS) did not
System Action: A record is written to SYS1.LOGREC
specify an area for the null indicator of the data. This is
and an SVC dump is requested at the site of the DB2
an internal error.
abend.
This abend reason code is issued by the following
Operator Response: Notify the system programmer.
CSECT: DSNLXQGT
System Programmer Response: Determine which
System Action: A record is written to SYS1.LOGREC
sites the abending agent was connected to by
and an SVC dump is requested at the site of the DB2
examining the DSNL027 and DSNL028 SYSLOG
abend.
console messages at the site of the DB2 abend. Obtain
Operator Response: Notify the system programmer. copies of the SYS1.LOGREC and SYSLOG data sets or
similar data from each connected site, the SVC dump at
System Programmer Response: Determine which
the site of the DB2 failure, and any related dumps from
sites the abending agent was connected to by
each connected site.
examining the DSNL027 and DSNL028 SYSLOG
console messages at the site of the DB2 abend. Obtain If you suspect an error in DB2, refer to Part 2 of DB2
copies of the SYS1.LOGREC and SYSLOG data sets or Diagnosis Guide and Reference for information on
similar data from each connected site, the SVC dump at identifying and reporting the problem.
the site of the DB2 failure, and any related dumps from
Problem Determination: Collect the following
each connected site. Refer to Part 2 of DB2 Diagnosis
diagnostic items listed in “Appendix B. Problem
Guide and Reference for information on identifying and
determination” on page 1281: 56, 57.
reporting the problem.
Problem Determination: Collect the following
00D34417
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57. Explanation: DRDS detected an illegal attempt to
enter Continuous Block Fetch mode.
00D34415 This abend reason code is issued by the following
CSECT: DSNLXQFH
Explanation: The input host variable SQLDA format
specified in the RDI is not valid. This is an internal error. System Action: A record is written to SYS1.LOGREC
and an SVC dump is requested at the site of the DB2
This abend reason code is issued by the following
abend.
CSECT: DSNLXIVB
Operator Response: Notify the system programmer.
System Action: A record is written to SYS1.LOGREC
and an SVC dump is requested at the site of the DB2 System Programmer Response: Determine which
abend. sites the abending agent was connected to by
examining the DSNL027 and DSNL028 SYSLOG
Operator Response: Notify the system programmer.
console messages at the site of the DB2 abend. Obtain
System Programmer Response: Determine which copies of the SYS1.LOGREC and SYSLOG data sets or
sites the abending agent was connected to by similar data from each connected site, the SVC dump at
examining the DSNL027 and DSNL028 SYSLOG the site of the DB2 failure, and any related dumps from
console messages at the site of the DB2 abend. Obtain each connected site.
copies of the SYS1.LOGREC and SYSLOG data sets or
If you suspect an error in DB2, refer to Part 2 of DB2
similar data from each connected site, the SVC dump at
Diagnosis Guide and Reference for information on
the site of the DB2 failure, and any related dumps from
identifying and reporting the problem.
each connected site. Refer to Part 2 of DB2 Diagnosis
Guide and Reference for information on identifying and Problem Determination: Collect the following
reporting the problem. diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57.
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57. 00D34418
Explanation: The remote server was not successfully
00D34416 connected. The SYSIBM.USERNAMES table did not
contain an outbound row, the TYPE column specified as
Explanation: An incomplete response was received
an 'O' describing the remote authorization identifier to
on a conversation when a complete response was
be used for the plan owner DB2 authorization ID. When
expected.
the USERNAMES column in SYSIBM.LUNAMES
specifies 'O' or 'B' requiring outbound name translation,
892 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D34419 • 00D3441D
the SYSIBM.USERNAMES table must contain entries and an SVC dump is requested at the site of the DB2
describing the remote authorization IDs to be used for abend.
each DB2 authorization ID communicating with the LU.
Operator Response: Notify the system programmer.
This reason code is issued by the following CSECT:
System Programmer Response: Determine which
DSNLXQAL
sites the abending agent was connected to by
System Action: A resource unavailable is returned to examining the DSNL027 and DSNL028 SYSLOG
the application. The request is not sent to the remote console messages at the site of the DB2 abend. Obtain
site. copies of the SYS1.LOGREC and SYSLOG data sets or
similar data from each connected site, the SVC dump at
Operator Response: Notify the communications
the site of the DB2 failure, and any related dumps from
database administrator.
each connected site.
System Programmer Response: Make sure the
If you suspect an error in DB2, refer to Part 2 of DB2
USERNAMES column in SYSIBM.LUNAMES has been
Diagnosis Guide and Reference for information on
specified correctly for the indicated LUNAME. If you
identifying and reporting the problem.
intend to use remote authorization IDs that differ from
DB2 authorization IDs, verify that the Problem Determination: Collect the following
SYSIBM.USERNAMES table has rows that correctly diagnostic items listed in “Appendix B. Problem
specify the remote authorization ID to be used for each determination” on page 1281: 56, 57.
possible DB2 authorization ID.
Problem Determination: Analyze the 00D3441C
SYSIBM.USERNAMES table for an incorrect or missing
Explanation: Allocation of the distributed processing
entry.
services block (DPSB) failed.
This abend reason code is issued by the following
00D34419
CSECTs:
Explanation: RDS has passed an invalid DESCRIBE
request to DRDS. This is an internal error. DSNLXCNV DSNLXQCL DSNLXQEX DSNLXQFH
DSNLXQOP DSNLXQPR DSNLXSQD DSNLXQXI
This abend reason code is issued by the following
CSECT: DSNLXRDS
System Action: A record is written to SYS1.LOGREC
System Action: A record is written to SYS1.LOGREC and an SVC dump is requested at the site of the DB2
and an SVC dump is requested at the site of the DB2 abend.
abend.
Operator Response: Notify the system programmer.
Operator Response: Notify the system programmer.
System Programmer Response: Determine which
System Programmer Response: Determine which sites the abending agent was connected to by
sites the abending agent was connected to by examining the DSNL027 and DSNL028 SYSLOG
examining the DSNL027 and DSNL028 SYSLOG console messages at the site of the DB2 abend. Obtain
console messages at the site of the DB2 abend. Obtain copies of the SYS1.LOGREC and SYSLOG data sets or
copies of the SYS1.LOGREC and SYSLOG data sets or similar data from each connected site, the SVC dump at
similar data from each connected site, the SVC dump at the site of the DB2 failure, and any related dumps from
the site of the DB2 failure, and any related dumps from each connected site.
each connected site. Refer to Part 2 of DB2 Diagnosis
Guide and Reference for information on identifying and If you suspect an error in DB2, refer to Part 2 of DB2
reporting the problem. Diagnosis Guide and Reference for information on
identifying and reporting the problem.
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem Problem Determination: Collect the following
determination” on page 1281: 56, 57. diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57.
00D3441B
00D3441D
Explanation: DRDS detected an invalid use of a
conversation. Explanation: The distributed relational data system
(DRDS) subcomponent has determined that control
This abend reason code is issued by the following structures necessary for processing do not exist. This is
CSECT: DSNLXCNV a DB2 internal error.
System Action: A record is written to SYS1.LOGREC This abend reason code is issued by the following
CSECT: DSNLXRUW
Chapter 39. DB2 Codes 893
00D3441E • 00D34422
System Action: A record is written to SYS1.LOGREC System Action: A record is written to SYS1.LOGREC
and an SVC dump is requested at the site of the DB2 and an SVC dump is requested at the site of the DB2
ABEND. ABEND.
Operator Response: Notify the system programmer. Operator Response: Notify the system programmer.
System Programmer Response: Determine which System Programmer Response: Determine which
sites the ABENDing agent was connected to by sites the ABENDing agent was connected to by
examining the DSNL027 and DSNL028 SYSLOG examining the DSNL027 and DSNL028 SYSLOG
console messages at the site of the DB2 ABEND. console messages at the site of the DB2 ABEND.
Obtain copies of the SYS1.LOGREC and SYSLOG data Obtain copies of the SYS1.LOGREC and SYSLOG data
sets or similar data from each connected site, the SVC sets or similar data from each connected site, the SVC
dump at the site of the DB2 failure, and any related dump at the site of the DB2 failure, and any related
dumps from each connected site. dumps from each connected site. Refer to Part 2 of
DB2 Diagnosis Guide and Reference for information on
Refer to Part 2 of DB2 Diagnosis Guide and Reference
identifying and reporting the problem.
for information on identifying and reporting the problem.
Problem Determination: Collect the following
Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57.
determination” on page 1281: 56, 57.
00D34420
00D3441E
Explanation: The application executed a dynamic
Explanation: The distributed relational data system
COMMIT or ROLLBACK operation while executing in an
(DRDS) subcomponent has determined that the function
environment in which DB2 is not coordinating the
to be executed is not a valid function. This is a DB2
COMMIT/ROLLBACK process (for example, IMS or
internal error.
CICS). This is an application error.
This abend reason code is issued by the following
This abend reason code is issued by the following
CSECTs:
CSECT: DSNLXRUW
DSNLXRCM DSNLXRCN DSNLXRCX DSNLXRQX System Action: A record is written to SYS1.LOGREC
DSNLXRUW and an SVC dump is requested at the site of the DB2
abend.
System Action: A record is written to SYS1.LOGREC Operator Response: Notify the system programmer.
and an SVC dump is requested at the site of the DB2
ABEND. System Programmer Response: Determine which
sites the abending agent was connected to by
Operator Response: Notify the system programmer. examining the DSNL027 and DSNL028 SYSLOG
System Programmer Response: Determine which console messages at the site of the DB2 abend. Obtain
sites the ABENDing agent was connected to by copies of the SYS1.LOGREC and SYSLOG data sets or
examining the DSNL027 and DSNL028 SYSLOG similar data from each connected site, the SVC dump at
console messages at the site of the DB2 ABEND. the site of the DB2 failure, and any related dumps from
Obtain copies of the SYS1.LOGREC and SYSLOG data each connected site.
sets or similar data from each connected left 20he SVC If you suspect an error in DB2, refer to Part 2 of DB2
dump at the site of the DB2 failure, and any related Diagnosis Guide and Reference for information on
dumps from each connected site. Refer to Part 2 of identifying and reporting the problem.
DB2 Diagnosis Guide and Reference for information on
identifying and reporting the problem. Problem Determination: Collect the following
diagnostic items listed in “Appendix B. Problem
Problem Determination: Collect the following determination” on page 1281: 56, 57.
diagnostic items listed in “Appendix B. Problem
determination” on page 1281: 56, 57.
00D34422
00D3441F Explanation: The distributed relational data system
(DRDS) subcomponent has received an unexpected
Explanation: The distributed relational data system return code from the Distributed Transaction Manager
(DRDS) subcomponent is in an invalid state and cannot (DTM) subcomponent during CONNECT processing.
process the function requested. This is a DB2 internal This is a DB2 internal error.
error.
This abend reason code is issued by the following
This abend reason code is issued by the following CSECT: DSNLXRCN
CSECT: DSNLXRUW
894 DB2 UDB for OS/390 and z/OS: Messages and Codes
00D34423 • 00D34425
System Action: A record is written to SYS1.LOGREC This abend reason code is issued by the following
and an SVC dump is requested at the site of the DB2 CSECTs:
ABEND.
DSNLXRAX DSNLXRBF DSNLXRCL DSNLXRCM
Operator Response: Notify the system programmer. DSNLXRDT DSNLXRFT DSNLXROP DSNLXRQX
System Programmer Response: Determine which DSNLXRSL DSNLXRSQ
sites the ABENDing agent was connected to by
examining the DSNL027 and DSNL028 SYSLOG System Action: A record is written to SYS1.LOGREC
console messages at the site of the DB2 ABEND. and an SVC dump is requested at the site of the DB2
Obtain copies of the SYS1.LOGREC and SYSLOG data ABEND.
sets or similar data from each connected site, the SVC
dump at the site of the DB2 failure, and any related Operator Response: Notify the system programmer.
dumps from each connected site. Refer to Part 2 of System Programmer Response: Determine which
DB2 Diagnosis Guide and Reference for information on sites the ABENDing agent was connected to by
identifying and reporting the problem. examining the DSNL027 and DSNL028 SYSLOG
Problem Determination: Collect the following console messages at the site of the DB2 ABEND.
diagnostic items listed in “Appendix B. Problem Obtain copies of the SYS1.LOGREC and SYSLOG data
determination” on page 1281: 56, 57. sets or similar data from each connected site, the SVC
dump at the site of the DB2 failure, and any related
dumps from each connected site. Refer to Part 2 of
00D34423 DB2 Diagnosis Guide and Reference for information on
Explanation: The distributed relational data system identifying and reporting the problem.
(DRDS) subcomponent has received an unexpected Problem Determination: Collect the following
return code from the Distributed Data Interchange diagnostic items listed in “Appendix B. Problem
Service (DDIS) subcomponent on an invocation to determination” on page 1281: 56, 57.
generate a request. This is a DB2 internal error.
This abend reason code is issued by the following 00D34425
CSECTs:
Explanation: The distributed relational data system
DSNLXPRS DSNLXRAX DSNLXRBF DSNLXRCL (DRDS) subcomponent has received an unexpected
DSNLXRCM DSNLXRDT DSNLXRFT DSNLXROP return code from the Data Communications Resource
DSNLXRSL DSNLXRSQ Manager (DC) subcomponent. This is a DB2 internal
error.
System Action: A record is written to SYS1.LOGREC This abend reason code is issued by the following
and an SVC dump is requested at the site of the DB2 CSECTs:
ABEND.
DSNLXRAX DSNLXRBF DSNLXRCL DSNLXRCM
Operator Response: Notify the system programmer. DSNLXRCX DSNLXRCX DSNLXRFT DSNLXROP
System Programmer Response: Determine which DSNLXRQX DSNLXRQX DSNLXRSQ
sites the ABENDing agent was connected to by
examining the DSNL027 and DSNL028 SYSLOG System Action: A record is written to SYS1.LOGREC
console messages at the site of the DB2 ABEND. and an SVC dump is requested at the site of the DB2
Obtain copies of the SYS1.LOGREC and SYSLOG data ABEND.
sets or similar data from each connected site, the SVC
dump at the site of the DB2 failure, and any related Operator Response: Notify the system programmer.
dumps from each connected site. Refer to Part 2 of System Programmer Response: Determine which
DB2 Diagnosis Guide and Reference for information on sites the ABENDing agent was connected to by
identifying and reporting the problem. examining the DSNL027 and DSNL028 SYSLOG
Problem Determination: Collect the following console messages at the site of the DB2 ABEND.
diagnostic items listed in “Appendix B. Problem Obtain copies of the SYS1.LOGREC and SYSLOG data
determination” on page 1281: 56, 57. sets or similar data from each connected site, the SVC
dump at the site of the DB2 failure, and any related
dumps from each connected site. Refer to Part 2 of
00D34424 DB2 Diagnosis Guide and Reference for information on
Explanation: The distributed relational data system identifying and reporting the problem.
(DRDS) subcomponent has received an unexpected Problem Determination: Collect the following
return code from the Distributed Data Interchange diagnostic items listed in “Appendix B. Problem
Service (DDIS) subcomponent on an invocation to parse determination” on page 1281: 56, 57.
a reply. This is a DB2 internal error.
Chapter 39. DB2 Codes 895
00D34426 • 00D3442B
This abend reason code is issued by the following
00D34426
CSECT: DSNLXRSQ
Explanation: The distributed relational data system
System Action: A record is written to SYS1.LOGREC
(DRDS) subcomponent has detected an invalid date
and an SVC dump is requested at the site of the DB2
format in DSNHDECP. This is a DB2 internal error.
ABEND.
This abend reason code is issued by the following
Operator Response: Notify the system programmer.
CSECT: DSNLXRCM
System Programmer Response: Determine which
System Action: A record is written to SYS1.LOGREC
sites the ABENDing agent was connected to by
and an SVC dump is requested at the site of the DB2
examining the DSNL027 and DSNL028 SYSLOG
ABEND.
console messages at the site of the DB2 ABEND.
Operator Response: Notify the system programmer. Obtain copies of the SYS1.LOGREC and SYSLOG data
sets or similar data from each connected site, the SVC
System Programmer Response: Determine which
dump at the site of the DB2 failure, and any related
sites the ABENDing agent was connected to by
dumps from each connected site. Refer to Part 2 of
examining the DSNL027 and DSNL028 SYSLOG
DB2 Diagnosis Guide and Reference for information on
console messages at the site of the DB2 ABEND.
identifying and reporting the problem.
Obtain copies of the SYS1.LOGREC and SYSLOG data
sets or similar data from each connected site, the SVC Problem Determination: Collect the following
dump at the site of the DB2 failure, and any related diagnostic items listed in “Appendix B. Problem
dumps from each connected site. Refer to Part 2 of determination” on page 1281: 56, 57.
DB2 Diagnosis Guide and Reference for information on
identifying and reporting the problem.
00D3442A
Problem Determination: Collect the following
Explanation: The distributed relational data system
diagnostic items listed in “Appendix B. Problem
(DRDS) subcomponent has received a return code from
determination” on page 1281: 56, 57.
the Data Communications Resource Manager (DCRM)
indicating that an exit was chained; however, no exit
00D34427 should have been chained. This is a DB2 internal error.
Explanation: The distributed relational data system This abend reason code is issued by the following
(DRDS) subcomponent has detected an invalid time CSECTs:
format in DSNHDECP. This is a DB2 internal error.
DSNLXRBF DSNLXRCL DSNLXRFT
This abend reason code is issued by the following
CSECT: DSNLXRCM
System Action: A record is written to SYS1.LOGREC
System Action: A record is written to SYS1.LOGREC and an SVC dump is requested at the site of the DB2
and an SVC dump is requested at the site of the DB2 ABEND.
ABEND.
Operator Response: Notify the system programmer.
Operator Response: Notify the system programmer.
System Programmer Response: Determine which
System Programmer Response: Determine which sites the ABENDing agent was connected to by
sites the ABENDing agent was connected to by examining the DSNL027 and DSNL028 SYSLOG
examining the DSNL027 and DSNL028 SYSLOG console messages at the site of the DB2 ABEND.
console messages at the site of the DB2 ABEND. Obtain copies of the SYS1.LOGREC and SYSLOG data
Obtain copies of the SYS1.LOGREC and SYSLOG data sets or similar data from each connected site, the SVC
sets or similar data from each connected site, the SVC dump at the site of the DB2 failure, and any related
dump at the site of the DB2 failure, and any related dumps from each connected site. Refer to Part 2 of
dumps from each connected site. Refer to Part 2 of DB2 Diagnosis Guide and Reference for information on
DB2 Diagnosis Guide and Reference for information on identifying and reporting the problem.
identifying and reporting the problem.
Problem Determination: Collect the following
Problem Determination: Collect the following diagnostic items listed in “Appendix B. Problem
diagnostic items listed in “Appendix B. Problem determination” on page 1281: 56, 57.
determination” on page 1281: 56, 57.
00D3442B
00D34429
Explanation: The distributed relational data system
Explanation: The distributed relational data system (DRDS) subcomponent has received a nonzero SQL
(DRDS) subcomponent has detected that
You might also like
- NAME: Raghunath Marandi Class: Xii-C TOPIC: To Study Various Factors On Which The Internal Resistance / EMF of A Cell Depends100% (3)NAME: Raghunath Marandi Class: Xii-C TOPIC: To Study Various Factors On Which The Internal Resistance / EMF of A Cell Depends20 pages
- DB2 UDB For OS390 and ZOS V7 Installation GuideNo ratings yetDB2 UDB For OS390 and ZOS V7 Installation Guide652 pages
- Installation Guide: DB2 Universal Database For OS/390 and z/OSNo ratings yetInstallation Guide: DB2 Universal Database For OS/390 and z/OS612 pages
- IBM DB2 10.5 For Linux, UNIX, and Windows - Message Reference Volume 2No ratings yetIBM DB2 10.5 For Linux, UNIX, and Windows - Message Reference Volume 2873 pages
- Xpediter/Tso and Xpediter/Ims Messages and Codes: Release 7.2No ratings yetXpediter/Tso and Xpediter/Ims Messages and Codes: Release 7.2152 pages
- Installation Guide: DB2 Universal Database For OS/390No ratings yetInstallation Guide: DB2 Universal Database For OS/390576 pages
- Advanced Multiplayer Game Development with Ureal Engine 5: A Comprehensive Guide to C++ ScriptingFrom EverandAdvanced Multiplayer Game Development with Ureal Engine 5: A Comprehensive Guide to C++ ScriptingNo ratings yet
- What's New?: DB2 Universal Database Server For z/OS and OS/390No ratings yetWhat's New?: DB2 Universal Database Server For z/OS and OS/39070 pages
- MVS System Messages, Vol 7 (IEB-IEE) PDFNo ratings yetMVS System Messages, Vol 7 (IEB-IEE) PDF622 pages
- DOS American National Standard COBOL Programmers Guide Feb70No ratings yetDOS American National Standard COBOL Programmers Guide Feb70256 pages
- DB2 UDB For OS390 and ZOS V8 Installation GuideNo ratings yetDB2 UDB For OS390 and ZOS V8 Installation Guide630 pages
- DB2 Universal Database For OS/390 and z/OSNo ratings yetDB2 Universal Database For OS/390 and z/OS572 pages
- The Linux Terminal for Advanced Users - The Command Line Made Easy: First EditionFrom EverandThe Linux Terminal for Advanced Users - The Command Line Made Easy: First EditionNo ratings yet
- DB2 V9 Application Programming&SQL Guide Dsnapk13No ratings yetDB2 V9 Application Programming&SQL Guide Dsnapk131,157 pages
- DB2 - Application Programming & SQL Guide - Ver 7No ratings yetDB2 - Application Programming & SQL Guide - Ver 71,030 pages
- Brochure Construction DG-GROW March2016No ratings yetBrochure Construction DG-GROW March201616 pages
- XNND-041-955 NeuViz 16 PDS Ver.2.0 '2011-11-29No ratings yetXNND-041-955 NeuViz 16 PDS Ver.2.0 '2011-11-297 pages
- Intermediate Well Control Equipment Inspection Criteria: Equipment Group: SIDE OUTLET VALVESNo ratings yetIntermediate Well Control Equipment Inspection Criteria: Equipment Group: SIDE OUTLET VALVES3 pages
- Etabs Concrete Design Training Manual PDFNo ratings yetEtabs Concrete Design Training Manual PDF2 pages
- Css 350 - Comparitive Management Essay-1No ratings yetCss 350 - Comparitive Management Essay-13 pages
- Passive Surveillance Using Multilateration: High Flying Technology To Reduce Aircraft DelaysNo ratings yetPassive Surveillance Using Multilateration: High Flying Technology To Reduce Aircraft Delays2 pages
