Name

cachePort

Synopsis

cachePort nodeURL port [-clear]

Description

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.
cachePort node6 /dev/ttySX1 /dev/ttySX2 /dev/ttySX3

Options

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:  $
					

Environment

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

See Also