setProperty - set device service properties to specified values on specified host and port

setProperty nodeHost portName name=value[ name=value...]

The setProperty utility sets one or more SIAM instrument service property values of the service running on the specified node and port. Each property setting as specified as a 'key=value' pair. If a whitespace must be included in the key=value string, the entire string must be enclosed by single or double quotes. Multiple key=value pairs may be specifed in a single invocation of setProperty. For example, to set the power and communication policies of the device service running on port /dev/ttySX11 on the "surface" node:

% setProperty surface /dev/ttySX11 powerPolicy=ALWAYS commPowerPolicy=SAMPLING
NOTE: property change will take effect when restartPort is executed

As the message indicates, the user should use the restartPort utility after making desired property modifications, to guarantee that the changes take effect.

The portName can be abbreviated as an integer, i.e. "/dev/ttySX11" can be abbreviated as simply "11". Thus the above example is equivalent to

% setProperty surface 11 powerPolicy=ALWAYS commPowerPolicy=SAMPLING

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".

ENVIRONMENT

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,  portProperties ,  cachePort ,  restartPort