Message Handling; Viewing Neoview Database Messages; Sqlstate And Sqlcode - HP Neoview Messages Manual

Table of Contents

Advertisement

1 Message Handling

The Neoview database software reports exception condition messages at the HP Neoview
Database Connectivity Service conversational interface (NDCS) window.
Most Neoview database software exception condition messages describe error conditions for
which recovery action is required. Some messages are warnings that provide information for
which no action is required.
Error messages that appear in response to SQL commands are logged to the NDCS application's
log file if you have used the LOG command to request them.
The format of a Neoview database software error is "*** ERROR" followed by the error number
in brackets, and the descriptive text. Use the error number shown to find information about a
particular error in this manual. For example, information for Neoview database software error
1125 can be found under "SQL 1125."
Messages are listed in this manual in numeric order, broken down by the component that
produced them.

Viewing Neoview Database Messages

The message key is a sequential SQL message number that is returned automatically by Neoview
database software when an exception condition occurs. For example, the following message
might be displayed within your application development tool while you prepare an embedded
SQL program:
*** ERROR[1000] A syntax error occurred.
This message number is the SQLCODE value (without the sign). In this manual, you will find
the following message information for ERROR[1000]:
SQL 1000
1000 A syntax error occurred.
Cause
You specified a statement with incorrect syntax.
Effect
The HP Neoview database software statement fails.
Recovery

SQLSTATE and SQLCODE

SQLSTATE and SQLCODE status codes are returned to indicate either that an SQL statement
completed successfully or that an exception condition was raised during execution of an SQL
statement.
The ANSI SQL-92 SQLSTATE variable is a five-character string with a two-character class code
followed by a three-character subclass code. An SQLSTATE value of 00000 indicates successful
completion.
The Neoview database software extends the ANSI SQL-92 SQLSTATE values to include other
situations not described by the ANSI values. If an ANSI SQL-92 SQLSTATE value exists for an
error condition, the Neoview database software returns that value. Otherwise, Neoview database
software returns an SQLSTATE value that is defined by the Neoview database software.
The Neoview database software also returns a numeric SQLCODE value after SQL statement
execution. SQLCODE values with negative numbers signify errors. SQLCODE values with
positive numbers other than 0 (successful completion) or 100 (no data was found) signify warning
messages. The Neoview database software identifies all messages by their unsigned SQLCODE
value and their calculated SQLSTATE value. The SQLCODE is used to calculate the SQLSTATE
Correct the syntax and resubmit.
Viewing Neoview Database Messages
13

Advertisement

Table of Contents
loading

Table of Contents