Mit Hilfe einer FT-Parameterbibliothek können Sie openFT an Ihre installationsspezifischen Bedürfnisse anpassen. In den Elementen dieser Bibliothek können Sie folgende Informationen ablegen:
Installationsparameter von openFT: Einige Installationsparameter werden auch beim Kommando FJGEN, siehe Abschnitt „FJGEN - Installationsparameter setzen“ und Abschnitt „Setzen der openFT-Installationsparameter mit FJGEN“, angegeben; die Installationsparameter, die Sie in der FT-Parameterbibliothek angeben, haben Vorrang vor den bei FJGEN angegebenen.
Festlegungen, welche Benutzer (User-IDs) FT- bzw. FTAC-Administrationsrechte besitzen.
Jobkarten für die Jobs zum Drucken der Ergebnisliste und für die Vor-, Nach- und Folgeverarbeitung.
Adressinformationen aus einer älteren openFT-Version, die in openFT V12 weiter verwendet werden sollen.
Angaben zur Verwendung von dateispezifischen Zeichensätzen (siehe Abschnitt„Aufbau des Elements FNAMECTB“ und Abschnitt „Code-Tabellen verwalten“).
Installationsparameter, die beim Einsatz von openFT-AC benötigt werden.
Angaben, um Diagnoseinformationen zu erstellen.
Format und Name der FT-Parameterbibliothek
Die Informationen der FT-Parameterbibliothek werden als Text in Elementen (Member) eines PO- oder PDSE-Dataset abgelegt. Die Bibliothek muss standardmäßig unter folgendem Namen angelegt werden:
<openft qualifier>.<inst>.PARM
Der OPENFT QUALIFIER (<openft qualifier>) und der INSTANCE NAME (<inst>) werden mit FJGEN festgelegt (siehe Abschnitt „FJGEN - Installationsparameter setzen“).
Außerdem gilt Folgendes:
Es wird empfohlen, dieses Dataset mit Satzformat F oder FB und Satzlänge 80 anzulegen. Ist die Satzlänge kleiner als 80, füllt openFT die Sätze mit Leerzeichen auf 80 Zeichen auf. Sätze, die länger sind als 80 Zeichen, werden nach dem 80. Zeichen abgeschnitten! Dies kann besonders bei den Elementen TSOJOB, TSOVVJOB, TSONVJOB, TSOVFJOB, JCLJOB und PRTJOB (siehe unten) zu Fehlern führen, wenn dadurch ungültige Jobkarten entstehen.
Die Elemente der FT-Parameterbibliothek dürfen keine Zeilennummerierung enthalten. Achten Sie darauf bitte beim Erstellen oder Ändern der Texte in den Elementen. (Bei Verwendung des PDF-Editors, z.B. unter der Menüoberfläche für den FT-Verwalter, müssen Sie also NUMBER OFF in Ihrem EDIT-Profil einstellen.)
Elemente der FT-Parameterbibliothek
Die folgenden Elemente der FT-Parameterbibliothek sind definiert:
PARM:
Installationsparameter für openFT. Der Aufbau des Elements ist im Abschnitt „Aufbau des Elements PARM“ beschrieben.
FTADM:
Liste der Benutzer mit FT-Administrationsberechtigung. Der Aufbau des Elements ist im Abschnitt „Aufbau der Elemente FTADM und FTACADM“ beschrieben.
FTACADM:
Liste der Benutzer mit FTAC-Administrationsberechtigung. Der Aufbau des Elements ist im Abschnitt „Aufbau der Elemente FTADM und FTACADM“ beschrieben.
FTPARM:
Hierbei handelt es sich um die Parameterwerte der Anweisung „EXEC PGM=OPENFT“ aus dem Batchjob des openFT. Der Aufbau des Elements ist im Abschnitt „Aufbau des Elements FTPARM“ beschrieben.
PRTJOB:
Jobkarten für den Druck der Ergebnisliste. Der Aufbau des Elements ist im Abschnitt „Aufbau der Elemente PRTJOB, JCLJOB, TSOJOB, TSOVVJOB, TSOVFJOB und TSONVJOB“ beschrieben.
JCLJOB:
Jobkarten für den Folgejob, der von openFT erzeugt wird, wenn die Folgeverarbeitung aus einer oder mehreren JCL-Anweisungen besteht. Der Aufbau des Elements ist im Abschnitt „Aufbau der Elemente PRTJOB, JCLJOB, TSOJOB, TSOVVJOB, TSOVFJOB und TSONVJOB“ beschrieben.
TSOJOB:
Jobkarten für den Folgejob, der von openFT erzeugt wird, wenn die Folgeverarbeitung aus einem oder mehreren TSO-Kommandos besteht. Der Aufbau des Elements ist im Abschnitt „Aufbau der Elemente PRTJOB, JCLJOB, TSOJOB, TSOVVJOB, TSOVFJOB und TSONVJOB“ beschrieben.
TSOVVJOB:
Jobkarten für den Vorverarbeitungsjob, der von openFT erzeugt wird, wenn ein oder mehrere TSO-Kommandos in einem FT-Auftrag als Vorverarbeitung verlangt wurden. Der Aufbau des Elements ist im Abschnitt „Aufbau der Elemente PRTJOB, JCLJOB, TSOJOB, TSOVVJOB, TSOVFJOB und TSONVJOB“ beschrieben.
TSOVFJOB:
Jobkarten für den Vorverarbeitungsjob, der von openFT erzeugt wird, wenn das Kommando "ftexec" für das z/OS angegeben wird. Der Aufbau des Elements ist im Abschnitt „Aufbau der Elemente PRTJOB, JCLJOB, TSOJOB, TSOVVJOB, TSOVFJOB und TSONVJOB“ beschrieben.
TSONVJOB:
Jobkarten für den Nachverarbeitungsjob, der von openFT erzeugt wird, wenn ein oder mehrere TSO-Kommandos in einem FT-Auftrag als Nachverarbeitung verlangt wurden. Der Aufbau des Elements ist im Abschnitt „Aufbau der Elemente PRTJOB, JCLJOB, TSOJOB, TSOVVJOB, TSOVFJOB und TSONVJOB“ beschrieben.
SUCCMSG:
Text der asynchronen Meldung, die openFT nach erfolgreicher Dateiübertragung an eine oder mehrere Consolen ausgibt. Dieses Element wird nur ausgewertet, wenn im Element PARM eine gültige Angabe zum Schlüsselwort SUCC_MSG gemacht wurde. Der Aufbau des Elements ist im Abschnitt „Aufbau der Elemente SUCCMSG und FAILMSG“ beschrieben.
FAILMSG:
Text der asynchronen Meldung, die openFT nach nicht erfolgreicher Dateiübertragung an eine oder mehrere Consolen ausgibt. Dieses Element wird nur ausgewertet, wenn im Element PARM eine gültige Angabe zum Schlüsselwort FAIL_MSG gemacht wurde. Der Aufbau des Elements ist im Abschnitt „Aufbau der Elemente SUCCMSG und FAILMSG“ beschrieben.
FNAMECTB:
Angaben darüber, welche dateispezifischen Zeichensätze (siehe Abschnitt „Code-Tabellen verwalten“) openFT verwenden soll und welche Dateien mit dem jeweiligen Zeichensatz codiert werden sollen. Der Aufbau des Elements ist im Abschnitt „Aufbau des Elements FNAMECTB“ beschrieben.
FTACPAR:
Installationsparameter, die beim Einsatz von openFT-AC benötigt werden. Der Aufbau des Elements ist im Abschnitt „Aufbau des Elements FTACPAR“ beschrieben.
DIAGPAR:
Angaben, um Diagnoseinformationen zu erstellen. Der Aufbau des Elements ist im Abschnitt „Diagnoseunterlagen erstellen“ beschrieben.
Die Elemente PARM, PRTJOB, JCLJOB, TSOJOB, TSOVVJOB, TSONVJOB, TSOVFJOB, SUCCMSG, FAILMSG, FTADM, FTACADM, FNAMECTB, FTACPAR und DIAGPAR werden beim Starten des openFT-Lademoduls eingelesen und ausgewertet, d.h. beim Starten des openFT-Batch-Jobs (mit FJINIT) bzw. der Started Task. Fehler beim Zugriff auf diese Elemente werden nicht gemeldet. openFT verhält sich so, als wäre das betreffende Element nicht vorhanden. Es gelten dann die jeweiligen Standard-Werte, soweit vorhanden.
Aktualisierungen in den Elementen FTADM, FTACADM, DIAGPAR und FNAMECTB können im laufenden Betrieb mit dem Kommando FTUPDPAR eingelesen werden (siehe Abschnitt „FTUPDPAR - Betriebsparameter aktualisieren“).