Command line interface
Setting the classpath
For using the command line interface of catchXSL! you'll only need the catchXSL! and the XSLT classes in your classpath. For profiling with Xalan as processor include the following jar-files in your classpath:
For profiling with Saxon you need the following files in your classpath:
If you want to profile for both processors you simply add both to your classpath.
The simplest call of catchXSL! is as follows:
java ecube.xslprofiler.CommandLineStarter <source-xml> <source-xsl> <processor>
Important! The produced output is HTML, so you are doing well in redirecting the output to a new file as follows:
java ecube.xslprofiler. .... > result.htmlYou may then open the result file result.html with your preferred internet browser.
You may try out the samples we provide. Change to the directory $PROFILER_HOME and call:
java ecube.xslprofiler.CommandLineStarter samples/foo.xml samples/foo.xsl saxon
Under $PROFILER_HOME you'll find the simple UNIX shell script "profile" (resp. "profile.cmd" for Windows NT) where you can review the classpath settings and again check how catchXSL! is called. Thus, to run the script you may just change the PROFILER_HOME entry and then call it with:
profile samples/foo.xml samples/foo.xsl > result.html
See Troubleshooting if any problems occur when calling catchXSL!.
Output of catchXSL!
As already mentioned the profiler lists the profiling results to stdout. Thus, you should redirect the profiler output to a file. In case of HTML output you just open this file with your preferred internet browser. It is important to know that you must have the CSS file result.css in the same directory in order to see the profiling results properly. The file result.css is to be found directly under $PROFILER_HOME.
In case you have specified the option -format xml, you'll get the profiling results as XML. Take a look at this file with your preferred XML-editor.
Command line options
The following options are available:
The following two options determine the representation of the profiling results. With <runlist> you specify the run(s) for which you want that representation.
<runlist> has the following syntax:
If none of the three presentation options is set when calling catchXSL! the default setting is "-template avg", thus delivering the average run times of the templates.