8.6.2 What Needs to be Installed?

Following is a checklist for your application:

Any other files that may be useful to the end user, such as samples of files to be uploaded, should be placed with the configuration file in the install directory.

Application Shortcut

In most cases, the shortcut (UserAgent.lnk in the example) will be a Windows shortcut. You can install this to a different location, such as the Start menu or the desktop. In either case, the shortcut should be configured to start in the install directory.

If you want the user to select the file to upload, use the configuration file as a single command line argument, for example:


javaw –Djava.ext.dirs=.\lib\ext com.lansa.jsf.useragent.JSFUserAgent mycompany.lih


If the file to upload will always have the same name, you can provide that file's name as a second argument:


javaw –Djava.ext.dirs=.\lib\ext com.lansa.jsf.useragent.JSFUserAgent mycompany.lih order.xml


If you don't want the user to interact with the User Agent at all, you can provide a third argument – the name of the response file – and the User Agent will run in batch mode. In this case, you should use a batch (.BAT) file instead of a Windows shortcut. See the upload.bat file in the User Agent install directory for an example. (For more examples, refer to 8.2 Getting Started with the User Agent.)

If the User Agent will be run on a platform other than Windows, you could provide another method for starting the User Agent, for example a shell script for Linux.

JAR Files

The {current directory}\lib\ext directory must contain at least jsfuseragent.jar. Other files may be required depending on the application: