switchBIN400V - get status of HV switch, or toggle HV power to subnodes

switchBIN400V node portName [ON|OFF|channelON|channelOFF|ALLON|ALLOFF]

When two arguments are specified, the switchBIN400V utility shows status of the high voltage switch(es) as reported by the SIAM power service running on the specified node and port.  If a third argument is specified, switchBIN400V actually toggles high-voltage power to subnodes through the SIAM power service running on the specified node and port. The optional third argument specifies the particular switch to toggle, is case-insensitive, and can be one of the following:

• ON or OFF: valid for power systems with just one HV switch, such as the surface node
• channelON or channelOFF, where channel is "0" or "1": valid for power systems with two power channels, such as a BIN. NOTE: there is no space allowed between channel and ON/OFF.
  
• ALLON or ALLOFF: valid for any power system
  

The results of switchBIN400V depend on what is "downstream" in the power architecture from the specified node. The switchBIN400V utility supercedes the older switchHiVoltage utility, which is obsolete.

The portName can be abbreviated as an integer, i.e. "/dev/ttySX13" can be abbreviated as simply "13". Thus the following examples switches power through the service running on port /dev/ttySX13 of "surface":

% switchBIN400V surface 13 ON

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 node can be specified as "localhost" or simply "loc".

For example, the following command displays the switch status on node1, assuming the SIAM power service is running on port /dev/ttySX13:

% switchBIN400V node1 /dev/ttySX13

The following command switches 400V OFF on the "surface" node, assuming the SIAM service is running on port /dev/ttyS0:

% switchBIN400V surface 0 off

The following command switches 400V ON to switch channel 0, assuming the SIAM service is running on port /dev/ttySX13:

% switchBIN400V node5 13 0on

Note that there's no space between power channel number ("0") and "on".

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

 binBackups