.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>ploticus: general interpreter settings</title>
<body bgcolor=D0D0EE vlink=0000FF>
<br>
<br>
<center>
<table cellpadding=2 bgcolor=FFFFFF width=550><tr>
<td>
  <table cellpadding=2 width=550><tr>
  <td><br><h2>general interpreter settings</h2></td>
  <td align=right>
  <small>
  <a href="../doc/welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
  Version 2.33 Jun'06
  <td></tr></table>
</td></tr>
<td>
<br>
<br>
.>>

.TH general_interpreter_settings PL "02-JUN-2006   PL ploticus.sourceforge.net"

.SH General interpreter settings
The \fC#mode\fR directive can be used to make general
settings that affect how the QUISP template interpreter behaves.

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

.SH #mode
Set various operational modes.
.LP
Usage: \fC#mode  \fIattribute\fR  \fIvalue\fR

.LP
\fIattribute\fR may be one of the following:


.ig >>
<br><br>
.>>
.LP
\fBerror_mode\fR
.IP
Default is \fCstderr\fR, so that error messages are written to standard error.
This may be set to \fCstdout\fR for error messages to be written to standard output.

.ig >>
<br><br>
.>>
.LP
\fBdot_in_varnames\fR
.IP
Specifies whether variable names may contain periods (.).
Default is \fCyes\fR, which is convenient with SQL applications since join
results are named using a period.
.br
Example: \fC#mode  dot_in_varnames  no\fR

.ig >>
<br><br>
.>>
.LP
\fBevalvars\fR 
.IP
Default is \fCyes\fR.  Use \fCno\fR to turn off evaluation of variables.
.br
Example: \fC#mode  evalvars  no\fR


.ig >>
<br><br>
.>>
.LP
\fBnullrep\fR
.IP
This determines how NULL database fields will be represented.
Allowable values are \fCblank\fR, \fCnull\fR, \fCnbsp\fR, and \fCnoconvert\fR.
The default is \fCblank\fR which causes NULLs to be converted to zero length strings.
Use \fCnbsp\fR to convert NULLs to the HTML non-breaking space character \fC&nbsp;\fR
This should be invoked before result rows are fetched.
Conversion occurs after the row is retrieved from the database.
.nf
.fi
Example: \fC#mode  nullrep  nbsp\fR

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

.LP
\fBshellmetachars\fR
.IP
This specifies the set of characters that are to be screened out of
variables that are present when building a shell command
(see the opening paragraphs of the
.ig >>
<a href="shell.html">
.>>
\0#shell man page
.ig >>
</a>
.>>
).  There should be no embedded whitespace.
This can also be set in the
.ig >>
<a href="config.html">
.>>
\0project config file
.ig >>
</a>
.>>
.br
Default set of shell metacharacters is: \fC"'`$\\;\fR
.br
Example: \fC#mode shellmetachars "'`\fR



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

.SH Database mode settings
See also the 
.ig >>
<a href="../../sqlman/html/shsql_handbook.html">
.>>
\0shsql
.ig >>
</a>
.>>
SQLMODE command, which can be used to make certain database-specific settings.



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

.ig >>
<br>
<br>
</td></tr>
<td align=right>
<a href="../doc/welcome.html">
<img src="../doc/ploticus.gif" border=0></a><br><small>data display engine &nbsp; <br>
<a href="../doc/Copyright.html">Copyright Steve Grubb</a>
<br>
<br>
<center>
<img src="../gallery/all.gif"> 
</center>
</td></tr>
</table>
<br>
<center>
Ploticus is hosted at http://ploticus.sourceforge.net <br>
<img src="http://sourceforge.net/sflogo.php?group_id=38453" width="88" height="31" border="0" alt="SourceForge Logo">
</center>
.>>
