#set TITLE = "sqlmode"
#include top

.SH SQLMODE
\fCSQLMODE\fR is a \fBshsql\fR SQL command extension that allows the
setting of certain \fBshsql\fR-specific modes.  Each setting affects all 
\fBshsql\fR activity conducted by the process making the setting.
Usage is:
.IP
\fCSQLMODE \fI  modename  value

#include space

.SH Modes

#include space
.LP
\fBdebugmode\fR
.IP
Default is \fC0\fR. 
If set to \fC1\fR or \fC2\fR, diagnostic output will be 
written to standard error.  \fC2\fR gives additional output
related to index lookups.  
This may also be set via the
#set FILE = "config.html#debugmode"
#set TAG = "config file"
#include link
or on the
#set FILE = shsql.1.html
#set TAG = "shsql(1) command line."
#include link

#include space

.LP
\fBlogcommands\fR
.IP
This option allows submitted SQL commands to be saved in a file for debugging purposes.
Value is a pathname.  To turn off logging, use: \fClogcommands no\fR.

#include space

.LP
\fBerrormode\fR
.IP
Default is \fCstderr\fR.
If set to \fCstdout\fR or \fCcgi\fR, error messages (but not debug info) are written to standard output.

.LP
\fBtranslog\fR
.IP
Default is \fC1\fR, meaning that database transaction logs are generated for
each insert, update, or delete.
If set to \fC0\fR, transaction logs are not generated.

#include space

.LP
\fBretain_und\fR
.IP
Default is \fCno\fR.  
If set to \fCyes\fR, embedded underscores within
data fields will be retained (normally they are assumed
to represent spaces and are converted by \fCSHSQL_getrow()\fR for 
output purposes).
Usually put in effect only for a specific retrieval
and then set back.

#include space
.LP
\fBwritelock_ntries\fR
.IP
Default is \fC8\fR.
If set to a higher number, the given number of tries will be attempted when 
trying to write to a table that is write-locked.
This may also be set via the
#set FILE = "config.html#dbwritelock_ntries"
#set TAG = "config file."
#include link

#include space
.LP
\fBmaxrows_select\fR
.IP
Default is \fC2000\fR.
This is the maximum number of rows that can be retrieved by a SELECT.
This may also be set via the
#set FILE = "config.html#dbmaxrows_select"
#set TAG = "config file"
#include link
or on a command-by-command basis using the MAXROWS keyword.

#include space
.LP
\fBmaxrows_update\fR
.IP
Default is \fC2000\fR.
This is the maximum number of rows that can be affected by an UPDATE or DELETE.
This may also be set via the
#set FILE = "config.html#dbmaxrows_update"
#set TAG = "config file"
#include link
or on a command-by-command basis using the MAXROWS keyword.

#include space
.LP
\fBwildcard\fR
.IP
Wild-card character in WHERE clause. Default is \fC*\fR.  

#include space
.LP
\fBwildcard1\fR
.IP
Single-character wild-card character in WHERE clause.  Default is \fC?\fR.  

#include bottom
