ICIMACS v5.5 Workstation Computer (WC) Command Set

(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

CONFIG

Display current instrument hardware configuration

VERSION

Returns the program version number, executable path and name, and compilation date and time

SYSINFO

Displays information on the computer hardware and BIOS

SAVECONFIG

Saves current settings to the WC.INI file

Disk Write Control

TRANSFER n m xx

Transfers m images from data disk n to the current mount point, and returns a write confirmation message to host xx.

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

ROUTE nn

Until <esc> is pressed, route all commands from the keyboard to machine nn

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

NEWTCS T/F

Set use of either old or new TCS telemetry stream format

TCSCMD command

Send command to the telescope controller