.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.41 Mar2009
  <td></tr></table>
</td></tr>
<td>
<br>
<br>
.>>

.TH general_interpreter_settings PL "11-MAR-2009   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:

.LP
\fBallowinlinecodes\fR
.IP
If \fIvalue\fR is \fCyes\fR, evaluate 
.ig >>
<a href="inlinecodes.html">
.>>
\0inline codes
.ig >>
</a>
.>>
found in script content.  These are formatting codes particular to this software, that are useful in certain specialized formatting operations.
Example: \fCallowinlinecodes yes\fR

.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


.LP
\fBsuppressdll\fR
.IP
\fIvalue\fR should be \fCyes\fR to suppress data-less lines, and \fCno\fR
to show data-less lines.  Default is \fCno\fR.  
A data-less line is a line
having one or more variables, all of which evaluate to a zero-length value.
Suppressing data-less lines is sometimes useful, for example, when displaying
multi-line entities such as postal addresses.

.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>
<table><tr><td>
Ploticus is hosted at http://ploticus.sourceforge.net</td><td> &nbsp; </td><td>
<a href="http://sourceforge.net/projects/ploticus"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=38453&type=12" 
width="120" height="30" border="0" 
alt="Get ploticus data display engine at SourceForge.net. Fast, secure and Free Open Source software downloads" /></a>
</td></tr></table>


</center>
.>>
