Name

annotatePort

Synopsis

annotatePort nodeURL portName notation

Description

The annotatePort utility inserts a user-specified text annotation into an instrument service data stream. This is a convenient way to include notes about events that are contextually important to the data stream, but may not otherwise be captured.

The annotation is written to the instrument log file as a SIAM message packet. The annotation argument must be last; if it contains whitespace, it must be enclosed in quotes (single or double).

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
annotation Note to include in data stream. -

Example output:

annotatePort localhost /dev/tty.KeySerial1 "Instrument bitten by land shark - may need recalibration"
Looking for node server stub at rmi://localhost/node
Got proxy for node service "org.mbari.siam.moos.deployed.MOOSNodeService"
					

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