tifControl

NAME

SYNOPSIS

tifControl [-r dbRoot] [-n processName] [-c 1|0]

DESCRIPTION

The tifControl program forms the central command interface between the
various TCS modules (preset, tracking, mode switching, ...) and the users
of the TCS, e.g. instrumentation software. The purpose of the tifControl
program is to unify the interface to the TCS.

There will be one instance of the tifControl program for each focus, named
"tifNA" for Nasmyth A, "tifNB" for Nasmyth B and "tifCA" for Cassegrain.
Note that the tif instances must run in the same CCS environment as all TCS
processes.

The users send all their commands for the TCS to the appropriate tifControl
instance "tifNA", "tifNB" or "tifCA" which routes them to the proper TCS
module, gets the replies from and passes them back to the original caller.

The optional argument dbRoot is the root point of the TCS paket DB branch.
If omitted it is defaulted to value of the TCS_DBPOINT environment variable
or, if even this not defined, hard-coded to ":Appl_data:TCS".

The optional argument processName is the name under which the tif instance
registers with the CCS and hence the destination process name for commands
to it. If omitted, the instance registers with CCS with the same name with
which it was started, i.e. with its UNIX process name.

The optional argument -c 1|0 defines if checking must be performed on
commands sent. By default commands are always checked before sending
unless the environment variable TIF_CMD_CHECK is set to 0

FILES

none

ENVIRONMENT

TCS_DBPOINT specifies the root point of the TCS database branch
TIF_CMD_CHECK (0|1) specifies if check on commands sent must be performed.
              If not set, commands ARE checked (default value is 1).

COMMANDS

All the standard commands are provided and handled internally, i.e. affect
the tif itself but are not routed. For other commands see the documentation
of the corresponding TCS module and the tif Command Definition Table
tifControl.cdt.

RETURN VALUES

EXIT_SUCCESS on successful completion (EXIT, KILL command)
EXIT_FAILURE on a fatal error

CAUTIONS

If several tif instances are run in the same environment they must be
started with different process names and different DB root points.

EXAMPLES

shell> tifControl -n tifNA -r :testDB:TCS &

Starts a tif instance with process name tifNA (for Nasmyth A focus) and
specifies ":testDB:TCS" as the TCS branch root point.

Index

NAME

SYNOPSIS

DESCRIPTION

FILES

ENVIRONMENT

COMMANDS

RETURN VALUES

CAUTIONS

EXAMPLES