Note on usage
Function: Set an instance
User group: FT user
Functional description
The . ftseti command allows you to select the openFT instance with which you want to work. Using the ftshwi @a command displays the names of all instances on your system.
In single-user mode a user may set an instance with the command ftseti only in case he is the owner of the instance.
Format
. ftseti -h | <instance 1..8> (Unix systems)
ftseti -h | <instance 1..8> (Windows systems)
Description
-h
Displays the command syntax on the screen. Entries after the -h are ignored.
instance
Name of the instance to be selected.
The command sets the OPENFTINSTANCE environment variable to the instance name. Alternatively, the OPENFTINSTANCE environment variable can also be set manually or in scripts to the desired instance name. On Unix systems, OPENFTINSTANCE can be exported.
Calling ftseti on Unix systems
. ftseti
Hence, OPENFTINSTANCE is set in the current shell. The std instance is set by default.
The first ftseti call sets an alias (ftseti=. ftseti) in the current shell that allows the preceding period to be dispensed with in subsequent calls.
In some variants of the Bourne shell, the transfer parameters are not forwarded when "." is used in a call.
It may therefore be necessary with a call from a Bourne shell (e.g. under su) to switch to the K shell (ksh).
Messages of the ftseti command
If ftseti could not be executed properly, a self-explaining message is output. The exit code is not equal zero in this case.