.ig >>
<STYLE TYPE="text/css">
<!--
        A:link{text-decoration:none}
        A:visited{text-decoration:none}
        A:active{text-decoration:none}
        OL,UL,P,BODY,TD,TR,TH,FORM { font-family: arial,helvetica,sans-serif;; font-size:small; color: #333333; }

        H1 { font-size: x-large; font-family: arial,helvetica,sans-serif; }
        H2 { font-size: large; font-family: arial,helvetica,sans-serif; }
        H3 { font-size: medium; font-family: arial,helvetica,sans-serif; }
        H4 { font-size: small; font-family: arial,helvetica,sans-serif; }
-->
</STYLE>
<title>shsql: sqlmode</title>
<body bgcolor=99cc99 vlink=0000FF>
<br>
<br>
<center>
<table cellpadding=2 bgcolor=FFFFFF width=550 ><tr>
<td align=right><a href="shsql_home.html">
<img src="img/shsql.gif" border=0><br><small>SQL database system</a> &nbsp; </td></tr>
<td>
.>>

.TH sqlmode TDH "18-MAR-2004   TDH scg@jax.org" 

.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

.ig >>
<br><br><br>
.>>

.SH Modes

.ig >>
<br><br><br>
.>>
.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
.ig >>
<a href="config.html#debugmode">
.>>
\0config file
.ig >>
</a>
.>>
or on the
.ig >>
<a href="shsql.1.html">
.>>
\0shsql(1) command line.
.ig >>
</a>
.>>

.ig >>
<br><br><br>
.>>

.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.

.ig >>
<br><br><br>
.>>

.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.

.ig >>
<br><br><br>
.>>

.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.

.ig >>
<br><br><br>
.>>
.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
.ig >>
<a href="config.html#dbwritelock_ntries">
.>>
\0config file.
.ig >>
</a>
.>>

.ig >>
<br><br><br>
.>>
.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
.ig >>
<a href="config.html#dbmaxrows_select">
.>>
\0config file
.ig >>
</a>
.>>
or on a command-by-command basis using the MAXROWS keyword.

.ig >>
<br><br><br>
.>>
.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
.ig >>
<a href="config.html#dbmaxrows_update">
.>>
\0config file
.ig >>
</a>
.>>
or on a command-by-command basis using the MAXROWS keyword.

.ig >>
<br><br><br>
.>>
.LP
\fBwildcard\fR
.IP
Wild-card character in WHERE clause. Default is \fC*\fR.  

.ig >>
<br><br><br>
.>>
.LP
\fBwildcard1\fR
.IP
Single-character wild-card character in WHERE clause.  Default is \fC?\fR.  

.ig >>
<br>
<br>
</td></tr>
<td align=right>
<a href="shsql_home.html">
<img src="img/shsql.gif" border=0></a><br>
<a href="Copyright.html">Copyright Steve Grubb</a> &nbsp;
</td></tr>
</table>
.>>
