You can use the FT parameter library to tailor openFT to the specific requirements of your installation. You can store the following information in the members of this library:
openFT Installation parameters: Some installation parameters are also specified in the FJGEN command, see FJGEN - Set installation parameters and Setting openFT installation parameters with FJGEN; installation parameters entered in the FT parameter library take precedence over those specified in FJGEN.)
Definitions of the users (user IDs) who possess FT or FTAC administrator rights
Job cards for printing the result list and preprocessing, postprocessing and follow-up processing.
Address information from an older openFT version that is still to be used in openFT V12.
Details on the use of file-specific character sets (see section “Structure of the member FNAMECTB” and section “Administering code tables”)
Installation parameters required when openFT-AC is used
Specifications for creating diagnostics information.
Format and name of the FT parameter library
The information from the FT parameter library is stored as text in members of a PO or PDSE dataset. By default, the library must be created under the following name:
<openft qualifier>.<inst>. PARM
The OPENFT QUALIFIER (<openft qualifier>) and the INSTANCE NAME(<inst>) are defined using FJGEN (see FJGEN - Set installation parameters).
The following also applies:
It is advisable to create this data set with the record format F or FB and a record length of 80. openFT fills records with a length of less than 80 in order to make them 80 characters long. Records whose length exceeds 80 characters are truncated after the 80th character. This can lead to errors if invalid job cards are created as a result, particularly for the members TSOJOB, TSOVVJOB, TSONVJOB, TSOVFJOB, JCLJOB and PRTJOB (see below).
The members of the FT parameter library may not contain line numbering. Please observe this rule when creating or editing the text contained in the members. (If you use the PDF editor, e.g. via the menu interface for the FT administrator, you must therefore set NUMBER OFF in your EDIT profile)
Elements of the FT parameter library
PARM:
Installation parameters for openFT. The structure of this member is described in section “Structure of the PARM member”.
FTADM:
List of users with FT administration authorization. The structure of this member is described in section “Structure of the PARM member”.
FTACADM:
List of users with FTAC administration authorization. The structure of this member is described in section “Structure of the PARM member”.
FTPARM:
Parameter values of the "EXEC PGM = OPENFT" instruction from the openFT batch job. The structure of this member is described in section “Structure of the FTPARM member”.
PRTJOB:
Job cards for printing the result list. The structure of this member is described in section “Structure of the members PRTJOB, JCLJOB, TSOJOB, TSOVVJOB, TSOVFJOB and TSONVJOB”.
JCLJOB:
Job cards for the follow-up job which is created by openFT if the follow-up processing consists of one or more JCL statements. The structure of this member is described in section “Structure of the members PRTJOB, JCLJOB, TSOJOB, TSOVVJOB, TSOVFJOB and TSONVJOB”.
TSOJOB:
Job cards for the follow-up job which is created by openFT if the follow-up processing consists of one or more TSO commands. The structure of this member is described in section “Structure of the members PRTJOB, JCLJOB, TSOJOB, TSOVVJOB, TSOVFJOB and TSONVJOB”.
TSOVVJOB:
Job cards for the preprocessing job generated by openFT if one or more TSO commands have been requested as preprocessing commands in an FT request. The structure of this member is described in section “Structure of the members PRTJOB, JCLJOB, TSOJOB, TSOVVJOB, TSOVFJOB and TSONVJOB”.
TSOVFJOB:
Job cards for the preprocessing job generated by openFT if the "ftexec" command is issued for the z/OS system. The structure of this member is described in section“Structure of the members PRTJOB, JCLJOB, TSOJOB, TSOVVJOB, TSOVFJOB and TSONVJOB”.
TSONVJOB:
Job cards for the postprocessing job generated by openFT if one or more TSO commands have been requested as postprocessing commands in an FT request. The structure of this member is described in section “Structure of the members PRTJOB, JCLJOB, TSOJOB, TSOVVJOB, TSOVFJOB and TSONVJOB”.
SUCCMSG:
Text of the asynchronous message which openFT issues as a result of successful file transfer to one or several consoles. This member is evaluated only if a valid specification has been made for the SUCC_MSG keyword in the FTMSPPAR member. The structure of this member is described in section “Structure of the members SUCCMSG and FAILMSG”.
FAILMSG:
Text of the asynchronous message which openFT issues as a result of unsuccessful file transfer to one or several consoles. This member is evaluated only if a valid specification has been made for the FAIL_MSG keyword in the FTMSPPAR member. The structure of this member is described in section “Structure of the members SUCCMSG and FAILMSG”.
FNAMECTB:
Information on of which file-specific code character sets (see section “Administering code tables”) openFT is to use and which files are to be coded with the relevant character set. The structure of the member is described in section “Structure of the member FNAMECTB”.
FTACPAR:
Installation parameter needed when openFT-AC is used. The structure of the member is described in section “Structure of the member FTACPAR”.
DIAGPAR:
Specifications for creating diagnostics information. The structure of the member is described in section “Creating diagnostic records”.
The members PARM, PRTJOB, JCLJOB, TSOJOB, TSOVVJOB, TSONVJOB,
TSOVFJOB, SUCCMSG, FAILMSG, FTADM, FTACADM, FNAMECTB, FTACPAR and DIAGPAR are read and evaluated when the openFT load module is started, i.e. when the openFT batch job is started (with FJINIT) or when the started task commences. Errors in accessing a member are not reported. openFT acts as though the member concerned were not present. In this case the appropriate default values are used, if any are available.
Any updates to the FTADM, FTACADM, DIAGPAR and FNAMECTB members can be read in during system operation using the FTUPDPAR command (see FTUPDPAR - Update operating parameters).