#set TITLE "common error codes"
#include top

.SH Common error codes

.LP
Applications should check the status of every submitted SQL command.
Some error conditions (as noted below) do not result in an error message.

#include space

.LP
\fB0\fR  success.
.LP
\fB1\fR  requested record not found.  No message is issued.
.LP
\fB7\fR  
#set FILE = "recordlocking.html"
#set TAG = "record locked"
#include link
by another identity and unavailable for update.  No message is issued.
This code may be returned by \fCSHSQL_sql()\fR when a
\fCUPDATE\fR or \fCDELETE\fR command is submitted, and by
\fCSHSQL_getrow()\fR when \fCSELECT..FOR UPDATE\fR encounters a locked row.
.LP
\fB9\fR 
#set FILE = "tablelocking"
#set TAG = "the table is write-locked"
#include link
and the process couldn't gain access.
This code may be returned by \fCSHSQL_sql()\fR when an \fCINSERT\fR,
\fCUPDATE\fR, \fCDELETE\fR or \fCSELECT..FOR UPDATE\fR command is submitted.
.LP
\fB20\fR  attempt to update a database that has been set to 
#set FILE = "config.html#dbreadonly"
#set TAG = "read-only."
#include link
This code may be returned by \fCSHSQL_sql()\fR when an \fCINSERT\fR,
\fCUPDATE\fR, \fCDELETE\fR or \fCSELECT..FOR UPDATE\fR command is submitted.

.LP
\fBOther\fR - see the error message text.


#include bottom


