Appendix A: TCS commands

General TCS commands
All allowed in engineering mode.

$\bullet$

ACKNOWLEDGE   Turn off a limit or engineering mode alarm.

$\bullet$

HANDSET       Select handset mode.

$\bullet$

HELP          Get help on a command.

$\bullet$

RECALL        Recall a previous command.

$\bullet$

TCSEXIT       Close down the control system.

Source data entry
All allowed in engineering mode.

$\bullet$

DEC           Enter declination of edit source.

$\bullet$

DIFF_RATES    Enter non-sidereal tracking rates for the edit source.

$\bullet$

EPOCH         Enter epoch of position for edit source.

$\bullet$

EQUINOX       Enter equinox for edit source.

$\bullet$

PARALLAX      Enter parallax of edit source.

$\bullet$

PM            Synonym for PROPER_MOTION (q.v. ).

$\bullet$

PROPER_MOTION Enter proper motions of edit source.

$\bullet$

RA            Enter right ascension of edit source.

$\bullet$

RADIAL_VEL    Enter radial velocity of edit source.

$\bullet$

RV            Synonym for RADIAL_VEL (q.v. ).

$\bullet$

SOURCE        Enter name, right ascension, declination and equinox for edit source.

Catalogue handling
All allowed in engineering mode.

$\bullet$

ADD           Add the contents of the edit source data block to the catalogue as a named entry.

$\bullet$

ERASE         Clear the user catalogue.

$\bullet$

FIND          Get a named catalogue entry and put it in the edit source block.

$\bullet$

INCLUDE       Append a text catalogue to the current user catalogue.

$\bullet$

MARK          Store the current telescope position as a named catalogue entry.

$\bullet$

OUTPUT        Output the current catalogue to an ASCII file, terminal or line printer.

$\bullet$

REMOVE        Delete a catalogue entry.

Source change
None allowed in engineering mode.

$\bullet$

BLIND_OFFSET  New source (from catalogue) with local corrections to the pointing model.

$\bullet$

GOCAT         New source (from catalogue; specified by name only).

$\bullet$

GOTO          New source (direct input of name, right ascension, declination and equinox).

$\bullet$

NEXT          New source (using data in edit source block).

Positional and Aperture offsets
ENTER is allowed in engineering mode; the remainder are not.

$\bullet$

APERTURE      Execute a preset (numbered) aperture offset.

$\bullet$

BEAMSWITCH    Execute an aperture offset with direct input of x and y.

$\bullet$

ENTER         Input data for numbered aperture or positional offsets.

$\bullet$

OFFSET        Execute a positional offset with direct input of $\Delta\alpha$, $\Delta\delta$ or $\xi$, $\eta$.

$\bullet$

POSITION      Execute a preset (numbered) positional ($\xi$, $\eta$) or ( $\Delta\alpha$, $\Delta\delta$) offset.

$\bullet$

STORE         Store aperture or positional offsets set up using the handset.

Autoguiding
AGSELECT is allowed in engineering mode; AUTOGUIDE is not.

$\bullet$

ACQUIRE       Centre a guide star on the autoguider.

$\bullet$

AGSELECT      Identify the autoguider currently in use.

$\bullet$

AGSTOP        Send a SHUTDOWN shutdown command to the autoguider.

$\bullet$

AGWAIT        Send a WAIT command to the autoguider.

$\bullet$

AUTOGUIDE     Lock or unlock the autoguider loop.

$\bullet$

FIELD         Locate the brightest guide star in the autoguider field.

$\bullet$

GUIDE         The autoguider sends guiding errors to the TCS.

Calibration procedures
The keywords for this command which require the telescope to be moved are not allowed in engineering mode.

$\bullet$

CALIBRATE     Determine encoder zero-points and collimation errors.

Mechanism control
None allowed in engineering mode.

$\bullet$

DOME          Move the dome to a given azimuth and stop it.

$\bullet$

DFOCUS        Change the focus by a specified amount.

$\bullet$

FOCUS         Move the focus to a specified position.

$\bullet$

PARK          Move the telescope to a defined position.

$\bullet$

STOP          Stop a mechanism or combination of mechanisms.

Mechanism configuration
ZEROSET is allowed in engineering mode; TRACK is not.

$\bullet$

TRACK         Turn focus, dome, rotator or telescope tracking on or off.

$\bullet$

ZEROSET       Determine incremental encoder zero-points.

Change of focal station and instrument
Note that ``Select'' in this context means ``set up software and drive the correct rotator''. Both allowed in engineering mode.

$\bullet$

STATION       Select focal station.

$\bullet$

INSTRUMENT    Tell the TCS which instrument is in use.

Display functions
All allowed in engineering mode.

$\bullet$

DISPLAY       Change the coordinate system of the displayed telescope position.

$\bullet$

MOON          Give the current right ascension and declination of the Moon.

$\bullet$

PAGE          Switch to another information display page.

$\bullet$

SHOW          Display information about the system state.

Logging of test data
All allowed in engineering mode.

$\bullet$

LOG           Log tracking errors and associated data.

$\bullet$

POINT         Write encoder coordinates to a data file.

$\bullet$

RMS           Calculate and display mean and rms servo errors.

$\bullet$

SNAPSHOT      Record the current information display page.

Meteorological and Earth-rotation data
All allowed in engineering mode.

$\bullet$

HUMIDITY      Input relative humidity used in refraction calculation.

$\bullet$

POLE          Input values of polar motion.

$\bullet$

PRESSURE      Input barometric pressure used in refraction calculation.

$\bullet$

TEMPERATURE   Input temperature used in refraction calculation.

$\bullet$

UT1UTC        Input UT1 - UTC.

$\bullet$

WAVELENGTH    Input wavelength used in refraction calculation.