Name

setProperty

Synopsis

setProperty nodeURL port name="value" [name="value"...]

Description

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.

One or more invocations of the setProperty utility should be followed by restartPort to ensure that new property settings take effect.

For example, to set several property values for the service running on /dev/ttySX11 on the "surface" node:

setProperty surface /dev/ttySX11 powerPolicy=ALWAYS
setProperty surface /dev/ttySX11 defaultSkipInterval=-1
restartPort surface /dev/ttySX11

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

Example output:

					setProperty localhost /dev/tty.KeySerial1 powerPolicy=NEVER
					main() - args.length=3
					args[0]=localhost
					args[1]=/dev/tty.KeySerial1
					args[2]=powerPolicy=NEVER
					SIAM version $Name:  $
					args[2]=powerPolicy=NEVER
					
					NOTE: property change will take effect when restartPort is executed
					

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