Einsatzhinweis
Benutzergruppe: FT-Verwalter
Funktionsbeschreibung
Mit dem Kommando CREATE-FT-INSTANCE erzeugen Sie einen neuen Verwaltungseintrag für eine Instanz und laden die Instanz. Sie können die Instanz optional so erzeugen, dass beim Starten des Subsystems FT automatisch auch openFT in dieser Instanz gestartet wird (kein START-FT-Kommando mehr notwendig). Außerdem dient das Kommando zum erneuten Aktivieren/Laden einer mit DELETE-FT-INSTANCE entladenen Instanz.
Zusätzlich zur Standardinstanz können Sie bis zu 16 weitere Instanzen definieren.
Format
CREATE-FT-INSTANCE |
NAME = <alphanum-name 1..8> ,CONFIG-USERID = <text 1..15> ,AUTOMATIC-START = *OFF / *ON |
Beschreibung der Operanden
NAME = <alphanum-name 1..8>
Name der openFT-Instanz, die erzeugt werden soll. Dieser Name muss auf allen Rechnern identisch sein, auf denen diese Instanz eingesetzt werden soll.
CONFIG-USERID = <text 1..15>
Dateinamen-Präfix der variablen Dateien der openFT-Instanz. Das Präfix muss aus einem Katalognamen und einer Userid bestehen. Diese Userid wird als Konfigurations-Userid der Instanz bezeichnet.
AUTOMATIC-START=
Gibt an, ob nach dem Laden der Instanz openFT in dieser Instanz automatisch gestartet wird.
AUTOMATIC-START = *OFF
Nach dem Laden der Instanz wird openFT nicht gestartet.
AUTOMATIC-START = *ON
Nach jedem Laden der Instanz wird implizit in dieser Instanz auch ein START-FT-Kommando ausgeführt. Damit kann nach dem Laden sofort mit openFT gearbeitet werden. Es werden auch alle Komponenten gestartet, die bei der Standardinstanz zur Verfügung stehen wie z.B. openFT-AC, openFT-FTAM und openFT-FTP.
Kommando-Returncodes
(SC2) | SC1 | Maincode | Bedeutung |
195 | 1 | CMD0202 | Ungültiger Parameter. |
83 | 32 | CMD0221 | Interner Fehler. |
22 | 64 | FTR1022 | Instanz existiert bereits. |
23 | 64 | FTR1023 | Maximale Anzahl von Instanzen überschritten. |
2 | 0 | FTR1028 | Config-Userid ist nicht zugreifbar. |
SC1/2 = Subcode 1/2 in Dezimal-Darstellung Zusätzliche Informationen finden Sie im Abschnitt „Kommando-Returncodes“ | |||
Beispiel
/CREATE-FT-INSTANCE NAME=STEVEN,CONFIG-USERID=:HOME:$STEVEN