.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>quisp: examples, support, and troubleshooting</title>
<body bgcolor=99cc99 vlink=0000FF>
<br>
<br>
<center>
<table cellpadding=2 bgcolor=FFFFFF width=550 ><tr>
<td align=right><a href="handbook_home.html">
<img src="img/quisp2.gif" border=0><br><small>quick server pages</a> &nbsp; &nbsp; </td></tr>
<td>
.>>

.TH Examples, support, and troubleshooting TDH "08-MAR-2004   TDH scg@jax.org" 


.SH Examples

The
.ig >>
<a href="installing.html">
.>>
\0install page
.ig >>
</a>
.>>
walks you through an introductory example or two.

.LP
A number of additional examples are included with the distribution, in
the \fCmrexamples\fR directory.  See the README file there.



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

.SH Environment variable
.LP
\fBSHSQL_DB\fR - this environment variable must be set to contain the full path name 
of the project directory.  See the
.ig >>
<a href="installing.html">
.>>
\0install page
.ig >>
</a>
.>>
for more info.

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

.SH Troubleshooting hints
.IP \(bu
See the 
.ig >>
<a href="installing.html">
.>>
\0install page
.ig >>
</a>
.>>
for initial set up.

.ig >>
<br><br><br>
.>>
.IP \(bu
You can add \fC_DEBUG=1\fR to an invoking URL to get diagnostic information
(the name _DEBUG can be changed to something more obscure in your config file
if desired).

.ig >>
<br><br><br>
.>>
.IP \(bu
Use your browser's \fCShow source\fR feature to see the raw HTML.  Sometimes error messages
are hidden in formatted result (especially within tables or option lists), but will be visible 
in the raw HTML.  Note that 
standard error (eg. error messages from subprocesses) is not captured when in CGI mode.


.ig >>
<br><br><br>
.>>
.IP \(bu
Try invoking \fCmrcgi\fR manually.  Supply user variables and values on the command
line as var=value pairs, eg. \fCmrcgi rtn=mypage x=2\fR.  The generated HTML
will be written to the screen.  You will also see any standard error content.


.ig >>
<br><br><br>
.>>
.SH Support
For bug reports, or
if you've tried everything you can think of and need
assistance, contact the author Steve Grubb at \fCscg@jax.org\fR.
However, I can't assist with basic software development skills 
or local configuration issues (eg. what directory is my CGI bin, or 
why can't my web browser find the CGI bin).
.LP
.ig >>
<a href="http://ploticus.sourceforge.net/steve.html">
.>>
\0About the author.
.ig >>
</a>
.>>



.ig >>
<br>
<br>
</td></tr>
<td align=right>
<a href="handbook_home.html">
<img src="img/quisp2.gif" border=0></a><br>
<small>quick server pages &nbsp; &nbsp;<br>
<a href="Copyright.html">Copyright Steve Grubb</a> &nbsp; &nbsp;
</td></tr>
</table>
.>>
