tifControl.4

Manpage of tifControl

tifControl

Section: Devices and Network Interfaces (4)
Updated: 2012-04-23 10:10
Index Return to man pages list

NAME

tifControl - TCS Interface control program

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

This document was created by man2html, using the manual pages.
Time: 10:10:00 GMT, April 23, 2012

VLT Software Documentation