cachePort - cache current property values, or clear the cache, for service on specified node and port

cachePort nodeHost portName(s) [-clear]

The cachePort utility caches current instrument service property values for the instrument service running on specified node and port. Subsequent instantiations 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

The portName(s) can be abbreviated as an integer, i.e. "/dev/ttySX1" can be abbreviated as simply "1". Thus the above example is equivalent to

% cachePort node6 1 2 3

This utility may be run on the same host as the node, or on any networked host from which the node host is accessible. If run on the node's host, then nodeHost should be specified as "localhost".

The following environment variables must be set:

• JAVA_HOME - location of Java installation, e.g. /j9 or /opt/java/jdk1.3.1
• JAVA - name of the JVM. E.g. on a Sidearm, JAVA should be set to j9. On a workstation with Sun's Java installed, JAVA could be set to java.
• SIAM_HOME - top of the SIAM directory tree
• SIAM_CLASSPATH - on a Sidearm, SIAM_CLASSPATH should be set to $JAVA_HOME/lib/jclMax/classes.zip:$JAVA_HOME/lib/prsnlmot.jar:$JAVA_HOME/lib/RXTXcomm.jar:$SIAM_HOME/classes.  On X86 system, SIAM_CLASSPATH should be set to $SIAM_HOME/classes

SEE ALSO

instrument service properties,
scanPort , 
setProperty,
portProperties,
setSchedule