As the openFT administrator, you can create, modify, and delete instances. In addition, you can set and get information on instances (like a user). The creation, modification and deletion of instances is only possible via the SDF interface, not via the POSIX command interface.
Creating an instance
Using the CREATE-FT-INSTANCE command, you can create an instance.
If an instance is created, an entry is made in the administration file. This entry consists of the name of the instance and the pubset and user ID in which the files required for operation are stored (the request file, partner list, etc.). All the initialization tasks are carried out in the same way as during START-SUBSYSTEM. In the event you have also specified the AUTOMATIC-START option, then openFT is subsequently and immediately started in this instance.
Modifying an instance
With the MODIFY-FT-INSTANCE command, you can rename an instance and modify its AUTOMATIC-START characteristics.
Deleting an instance
With the DELETE-FT-INSTANCE command, you can delete an instance. Deleting an instance removes the administration entry for the instance. All the variable data (the request file, partner list, etc.) of this instance continue to exist and can be re-activated by repeating the CREATE-FT-INSTANCE command. Any attempt to access a deleted instance is denied with FTR0236.
The standard instance cannot be deleted.
Setting an instance
Using the SET-FT-INSTANCE command, you can select the openFT instance with which you would like to work (see the user guide). This setting is then valid for all the SDF commands set under this task or program interface calls and remains valid until the task is ended or until the next SET-FT-INSTANCE command. If you want to continue to work with the set instance in a Posix shell then it is necessary to call the following command after starting the shell:
. ftseti
The dot (.) followed be a blank is mandatory!
It is therefore advisable to record this command in the /etc/profile file.
If no SET-FT-INSTANCE command is given in a task, then work proceeds using the standard instance.Displaying instance information
Using the SHOW-FT-INSTANCE command, you can request information regarding the instances, see the user guide.
Set or display the BCAM host
Using the MODIFY-FT-OPTIONS ...,HOST-NAME command, you can assign the current instance a BCAM host. This BCAM host will be used for communication of openFT. By doing this, an instance allows itself to be assigned a fixed transport address, which is independent of the computer on which the instance is running.
On executing the SHOW-FT-OPTIONS command, the name of the BCAM host with which the instance is working is displayed.