.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: troubleshooting and support</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>Troubleshooting and support</h2></td>
  <td align=right>
  <small>
  <a href="../doc/welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
  Version 2.40 Jan'08
  <td></tr></table>
</td></tr>
<td>
<br>
<br>
.>>

.TH Troubleshooting_and_support PL "15-JAN-2008   PL ploticus.sourceforge.net"
 

.SH Troubleshooting

.LP
.IP \(bu
Be sure that the \fCpl\fR executable can be located via your command PATH.

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

.IP \(bu
Set and export \fCPLOTICUS_PREFABS\fR environment variable.
It must contain the full path name of the directory (\fC./prefabs\fR)
where prefab files reside.  (Note: some installations hard-code this
at build time, making this step unnecessary).

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

.IP \(bu
To run an initial quick test, go into the \fCpltestsuite\fR directory.
If you're on a Unix/linux system with X11, just type: \fCpl stock.htm\fR 
.br
Otherwise, create a GIF file by typing this: \fCpl -gif stock.htm\fR 
.br
\0..or create a PNG file by typing this: \fCpl -png stock.htm\fR 
.br
You can run a series of examples by typing: \fCrun_script_test\fR
.br
\0...and: \fCrun_prefabs_test\fR

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

.IP \(bu
Verify that your data are being read and parsed correctly.
For tab-delimited or comma-delimited data be sure that you have specified \fBdelim\fR
appropriately.
Prefab users can verify the data by specifying \fCechodata=yes\fR.
Script writers can use specify \fCshowresults: yes\fR within \fCproc getdata\fR.

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

.IP \(bu
Use the \fB-debug\fR command line option.
If you're using direct CGI mode, there are some
.ig >>
<a href="cgi.html">
.>>
\0additional debugging tips.
.ig >>
</a>
.>>

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

.IP \(bu
If your script uses variables (etc.), 
try the \fB-echo\fR command line option to see the post-evaluation script source.

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

.IP \(bu
Be sure you know which version you are executing
(you might have earlier ploticus versions on your system and not realize it).
Use \fCpl -version\fR to print the ploticus
version; use the unix command \fCwhich pl\fR to print the file that you
are actually executing when you type \fCpl\fR.

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

.IP \(bu
Unix builds prior to 2.11 do not read native PC text files.  This problem occurs
if pl is compiled on a unix machine and you feed it native PC text files, 
either as scripts or data files.  
Symptoms may include truncated multi-line text
items, or garbage characters appearing at the end of text items.  

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

.IP \(bu
If you're attempting to create a large PNG/GIF/JPEG image (greater than 8" in either dimension) 
a sufficient \fBpagesize\fR must be specified, either on the 
.ig >>
<a href="pl.1.html#resultsize">
.>>
\0command line
.ig >>
</a>
.>>
or via 
.ig >>
<a href="page.html">
.>>
\0proc page.
.ig >>
</a>
.>>
Failure to do this results in the top or side of an image result being cut off or obliterated.

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

.IP \(bu
If viewing result images in a browser, remember that image caching is usually
being done, and that you might not be seeing the most recently generated image,
even when you Reload or Refresh.

.ig >>
<br><br>
.>>
.IP \(bu
If you're using a 
.ig >>
<a href="config.html">
.>>
\0ploticus config file
.ig >>
</a>
.>>
and want to confirm that it's being found and processed correctly, put the following line
at the top of your config file: \fCoption: -debug\fR .
This is because the config file is processed before command line args are evaluated, so a
\fC-debug\fR on the command line won't take effect in time.
(\fBNote:\fR this trick doesn't work if you're using direct CGI mode)

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

.IP \(bu
Use proc print or #write to print out variable contents.
Use #exit to stop script execution prematurely, so that you can "step thru" 
your script.

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

.IP \(bu
Check to be sure you aren't exceeding one of the
.ig >>
<a href="limits.html">
.>>
\0program limitations
.ig >>
</a>
.>>


.ig >>
<br><br><br>
.>>
.ig >>
<a name=bugreports></a>
.>>


.SH Support
.LP
\fBPlease follow all of the steps listed below when sending a support request.
Requests that are incomprehensible or incomplete will be given lowest priority.\fR
.ig >>
<br><br>
.>>
\fB1. First, make a fair effort towards learning the tool and solving the problem yourself..\fR
You should know your way around the ploticus documentation and examples.
Be sure to follow the troubleshooting procedures from this page (and the
.ig >>
<a href="cgi.html">
.>>
\0CGI page
.ig >>
</a>
.>>
if appropriate).
.ig >>
<br><br>
.>>
\fB2. Include a stripped-down self-contained example\fR that exhibits the problem.  
Often the first thing I do is attempt to reproduce the problem here. 
Isolate the problem to the least amount of code possible, but
send enough data that I can generate real results.  Describe the problem
succinctly and clearly.  If you make it easy for me to understand I'll tend to 
address it sooner.
.ig >>
<br><br>
.>>
\fB3. Use the -debug option\fR .. and send the diagnostic results 
.ig >>
<br><br>
.>>
\fB4. Indicate computing platform\fR (Red Hat 7.2?  Solaris 8?  NT 4.0?)
.ig >>
<br><br>
.>>
\fB5. Indicate the exact pl command you used\fR and describe exactly how you invoked pl
(command line?  CGI?)
If you use a config file please attach this as well.
.ig >>
<br><br>
.>>
\fB6.\fR \fBDouble check\fR to be sure everything is correct.  Did you attach the correct
script and data set?  Did you describe the problem clearly and succinctly?
.ig >>
<br><br>
.>>
\fBSend support requests\fR to the
.ig >>
<a href="http://yahoogroups.com/group/ploticus">
.>>
\0ploticus news group
.ig >>
</a>
.>>
or to me at \fCstevegrubb at gmail dot com\fR
\fR 
.ig >>
<br><br>
.>>
Much of the incremental improvement in this package has been due to
the careful reports that have been sent in by attentive users.  Thanks!

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

.LP
.ig >>
<a href="http://ploticus.sourceforge.net/steve.html">
.>>
\0Steve Grubb
.ig >>
</a>
.>>
is the author of ploticus.  
.LP
If you have interesting examples or web sites that use ploticus, please send the
URLs or script files.



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