Note on usage
Function: Create a new openFT instance or activate an unloaded openFT instance
User group: FT administrator
Functional description
Using this CREATE-FT-INSTANCE command, you create a new administration entry for an instance and load the instance. You can optionally create the instance in such a manner that when the subsystem FT is started, openFT is also automatically started in this instance (a START-FT command is no longer necessary). In addition, the command re-activates or reloads an instance that was unloaded using DELETE-FT-INSTANCE.
In addition to the standard instance, you can define up to 16 other instances, see also the manual "openFT (BS2000) - Installation and Operation".
Format
CREATE-FT-INSTANCE |
NAME = <alphanum-name 1..8> ,CONFIG-USERID = <text 1..15> ,AUTOMATIC-START = *OFF / *ON |
Operands
NAME = <alphanum-name 1..8>
The name of the openFT instance that is to be created. This name must be identical on all of the computers on which this instance is to be used.
CONFIG-USERID = <text 1..15>
The file name prefix of the openFT instance variable files. The prefix must consist of a catalog name and a USER-ID. This USER-ID is designated as the configuration user ID of the instance.
AUTOMATIC-START=
This is specified if an automatic start of openFT is to occur within an instance, after loading the instance.
AUTOMATIC-START = *OFF
openFT is not started after loading the instance.
AUTOMATIC-START = *ON
After each loading of the instance, a START-FT command is implicitly executed in this instance. By doing this, it is possible to immediately work with openFT after loading. All the components which are available to a standard instance are also started, such as, for example openFT-AC, openFT-FTAM and openFT-FTP.
Command return codes
(SC2) | SC1 | Maincode | Meaning |
195 | 1 | CMD0202 | Invalid parameter. |
83 | 32 | CMD0221 | Internal error. |
22 | 64 | FTR1022 | Instance already exists. |
23 | 64 | FTR1023 | Maximum number of instances exceeded. |
2 | 0 | FTR1028 | Config user ID not accessible. |
SC1/2 = Subcode 1/2 in decimal notation For additional information, see section “Command return codes” | |||
Example
/CREATE-FT-INSTANCE NAME=STEVEN,CONFIG-USERID=:HOME:$STEVEN