ICIMACS v4.5 Workstation Computer (WC) Command Set

1/9/98 : JAM

(ICIMACS = Instrument Control and Image Acquisition System

USAGE: Commands for the WC can be entered either from its keyboard, with output appearing on the WC monitor, through a serial port, with output returned through that port, or through its telnet session over a network connection. See the ICIMACS Command Protocol page for inter-machine communication specifics.
For commands with optional parameters, entering the command alone will return its current values.


Program Control

QUIT
Saves the current configuration and quits the program
WCSTATUS
Returns the names of machines available
VERSION
Returns the program version number and name
SAVECONFIG
Saves current settings to the WC.INI file

Disk Write Control

TRANSFER n m
Transfers m images from data disk n to the current mount point.
REQ MOUNT
Returns a list of the current valid disks for writing data.
PATH [pathname]
Selects pathname as the disk and path for data writes
USE MOUNT [mountname/n]
Selects mountname as the current disk and path for data writes. Alternatively, the number n can be used, where n is the number of the desired mountpoint returned from the REQ MOUNT command (zero-based).

Utilities

TIME dd/mm/yy hh:mm:ss timezone
Sets the system time, and the timezone identifier.
SYNCHTIME
Sets the time on the WC, IC and IE to the time returned by the telescope controller, if available. Should be executed at least once a night to ensure that the time and date stamps in image FITS headers are accurate.
DISKS
Prints a list of the disk drives available
FREE
Prints the status of the system memory

Communication Control

ARIEL
Starts up the ariel program over the telnet session, if the telnet link is available
RECOVER
Reinitializes communication without resetting current table of active hosts
RESTART
Clears table of hosts and path mount table and reinitializes communication
PING [ALL]
Communication initialization request; responds with a PONG
PONG
Communication initialization acknowledge; no response is given
BUFFER n
Display contents of communication port n buffer
FLUSH n
Clear contents of communication port n buffer
PORTS
Returns a list of the active ports (keyboard/screen=0,com ports=1-4,head electronics com ports=7-9)
HOSTS
Lists all message sender addresses that have been received.
VERBOSE
Echoes all incoming and outgoing communications onscreen
CONCISE
Suppresses echoing of communications onscreen

Data Disk and Mount Point Synchronization

REQ INITDISK
A request for data disk synchronization from downstream; the WC response depends on its current state
REQ SWAP
A request for more data from downstream; the WC response depends on its current state
FOUND diskname
Indicates data disk diskname is accessible to downstream machine
FOUND ALL
Indicates the end of available data disks accessible to the downstream machine
FOUND MOUNT mountpoint
Adds mountpoint to the WC's list of mount points
UNMOUNT mountpoint
Removes mountpoint from the WC's list of mount points

Telescope Control

TCINIT
Initialize telescope controller link
TCSTATUS
Return status string from telescope controller

Imaging Sciences Laboratory
Revised: January 9, 1998 [jam]