The cachePort utility caches current instrument service property values for the instrument service running on specified node and port. The values set will then persist through restarts of SIAM or the instrument service. Subsequentinstantiations of the same service on the same node and port will use cached property values rather than the values specified in the associated jar file (or PUCK). Thus it is possible to start a service on a port (e.g. with scanPort), modify one or more property values with the setProperty or setSchedule utility, and then cache the current values with cachePort. The cached property values then persist for each subsequent service instantiation on the specified node and port until the contents of the service jar file (or PUCK) changes, in which case the service is initialized with property values specified in the jar. The properties cache can also be cleared using the -clear option;
Multiple ports may be specified on the command line, e.g.| Option | Description | Values |
|---|---|---|
| nodeURL | IP address or host name of SIAM node | e.g. 134.89.88.1, mooring.moos.mbari.org |
| portName | Name of instrument port (or alias) defined in siamPort.cfg | /dev/ttyS8, COM1, /dev/tty.KeySerial1 |
| -clear | clear the cache and restore property defaults | - |
Example output:
cachePort loc /dev/tty.KeySerial1 number of args: 2 main() - args.length=2 args[0]=loc args[1]=/dev/tty.KeySerial1 SIAM version $Name: $
The following environment variables must be set:
| Variable | Description | Example |
|---|---|---|
| JAVA_HOME | location of Java installation | /j9, /opt/java/jdk1.3.1, etc. |
| JAVA | Path to JVM command | For MMC $JAVA_HOME/bin/j9 For Sun JVM (e.g. linux, win32, mac OS) $JAVA_HOME/bin/java
|
| SIAM_HOME | top of the SIAM directory tree | - |
| SIAM_CLASSPATH | Path including all SIAM and supporting classes | For MMC $JAVA_HOME/lib/jclMax/classes.zip:$JAVA_HOME/lib/prsnlmot.jar:$JAVA_HOME/lib/RXTXcomm.jar:$SIAM_HOME/classes For linux/win32 $SIAM_HOME/classes |