Next Previous Up Contents
Next: Class Path
Up: Top
Previous: Introduction


2 Invocation

There are two ways of invoking the commands in this package. If you're using a Unix-like operating system and have downloaded the package in a form which includes the shell scripts, the easiest way is to use the scripts tpipe, votlint etc. These will either be in the same location as the stilts.jar file or in starjava/bin The form of invocation in this case is:

    <command-name> <java-args> <application-args>
(the java should be on your path).

A simple example would be:

    votcopy -f binary t1.xml t2.xml
For convenience you can mix up java-args and application-args - the script will untangle them and reorder them properly. If you use the -classpath argument or have a CLASSPATH environment variable set, then classpath elements thus specified will be added to the classpath required to run the command. The examples in the command descriptions below use this form for convenience.

If you don't have a Unix-like shell available however, or if you don't have the STILTS shell scripts, you will need to invoke Java directly with the appropriate classes on your classpath. The general form of an invocation command in this case will depend on your system, but will probably look like:

    java <java-args> -classpath <command-classpath> <command-classname>
         <application-args>
The example above in this case would look something like:
    java -classpath some/where/stilts.jar uk.ac.starlink.table.VotCopy 
         -f binary t1.xml t2.xml

More detail is given on the parts of these command lines in the following subsections.


Next Previous Up Contents
Next: Class Path
Up: Top
Previous: Introduction

STILTS - Starlink Tables Infrastructure Library Tool Set
Starlink User Note 256
STILTS web page: http://www.starlink.ac.uk/stilts/
Author email: m.b.taylor@bristol.ac.uk