8.6.2 What Needs to be Installed?

Following is a checklist for your application:

• Do you have a configuration file (.LIH file) that connects to your JSM application?

• Do you have a shortcut or script to start the User Agent?

• Do you have all the appropriate JAR files in the {current directory}\lib\ext directory?

• Do you have shipped sample files so that the user knows the supported file structures?

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.3 Get 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:

• jsmxls.jar is required for handling Microsoft Excel files.

• jsmssh2.jar is required for handling SFTP.

• jsmbcprov.jar is required for cryptographic services.

• com.ibm.mq.jar, connector.jar and mqji.properties are required for MQ-Series communication. (These files may be obtained from IBM).