You call the initial panel of the menu interface (Primary Option Menu, i.e. FTMAIN panel for openFT without FTAC or FTACM panel for openFT with FTAC) under TSO as follows:
EXECUTE '<openft qualifier>.OPENFT.PANEL.CLIST(FJMENU)'
The structure of the menu system is described below. Detailed help on each individual panel can be found online by pressing the F1 key.
Terminal operation is subject to the rules that usually apply with IBM ISPF:
The ENTER key causes terminal input to be passed on and, where appropriate, verified. The particular reaction that follows depends on the panel currently displayed.
In many cases, a data entry panel appears in which you can or must make entries. An action is then executed which has the same effect as issuing the corresponding FT command. In the next step, the message issued by openFT in response to this action is displayed on the screen. You exit this display in the usual manner using END, RETURN or the "jump function" (see below).
The END command causes a return to the panel preceding the current panel in the panel hierarchy. In this case, no action is usually executed. This enables you to cancel actions which you have selected by mistake.
The RETURN command causes a return to the Primary Option Menu. In this case, too, no action is executed.
The "jump function" of ISPF (calling a sequence of panels in one step e.g. "=p.3") is supported. In this case, the effect of the END command differs from the one described above: as usual with ISPF, "the panel preceding the current panel in the panel hierarchy" is interpreted as the panel from which the "jump" was made; so the END command causes that panel to be displayed. In this case, too, no action is executed.
Function keys PF1 through PF12 (or through PF24) can be used as usual with ISPF.
If a syntax error or any other type of error is detected in the input, a short message is displayed in the top right-hand corner of the screen indicating the error. At the same time, the cursor is positioned at the input field concerned. Subsequent entry of the HELP command causes a more detailed message to be displayed in the third line on the screen. Repeating the HELP command causes a help panel to be displayed.
The HELP panels for the individual functions form a hierarchy; you can therefore use the usual commands to "browse" through these help panels (e.g. ENTER to display the next help panel, BACK to display the previous help panel, etc.).
Data you have entered in data entry panels is generally deleted as soon as you exit the panel. Exceptions are noted as appropriate for each panel.
The data you have entered is not deleted, however, if the same data entry panel is displayed again following execution of the function (ENTER). This is the case for a number of functions which can be effectively repeated a number of times in succession (e.g. the function ADD REMOTE SYSTEM TO NETWORK DESCRIPTION). In this case, the data you have entered is also displayed once again and you can modify it before executing the function again. This applies until you finally exit the panel using END (or RETURN or the "jump function").
In the case of "string" type input fields, the uppercase/lowercase notation is taken over, otherwise all inputs are converted to uppercase.
The equals sign "=" has its usual ISPF navigation function (e.g. "=x" to exit the interface). For this reason, it is not possible to pass openFT any values that start with "=" via the interface.
Refer to the relevant IBM manuals for further information about ISPF.
The entries you can or must make in the fields of the data entry panels correspond to the parameter values which you must specify for the corresponding FT administration command. They are described in the chapter “openFT commands”.
The messages issued by openFT in response to your actions are also the same as those issued at the command interface. These messages and their meanings are given in the manual "openFT (z/OS) - Installation and Operation".
openFT displays the "PRIMARY OPTION MENU" illustrated on the next page as the entry panel. Menu items 5 and 6 in this menu are only available if openFT-AC is installed.
PRIMARY OPTION MENU
--- openFT - PRIMARY OPTION MENU ----------------- OPTION ===> 1 ADMINISTRATION 2 FILE TRANSFER REQUESTS 3 EXECUTE REMOTE COMMANDS 4 EXECUTE REMOTE FTADM COMMANDS 5 ADMISSION SETS 6 ADMISSION PROFILES INSTANCE IN USE ===> STD COMMAND DISPLAY ===> Y (Y/N) ------------------------------------------------------ |(C) 2017 Fujitsu Technology Solutions GmbH | ------------------------------------------------------ F1=HELP F2=SPLIT F3=END F4=RETURN F5=RFIND F6=RCHANGE F7=UP F8=DOWN F9=SWAP F10=LEFT F11=RIIGHT F12=RETRIEVE
This is the initial panel of the menu interface for the FT administrator if FTAC is used. It is qualified as the "Primary Option Menu", which means that it is the panel to which you return from any subsequent panel after entering the RETURN command.
You enter YES or NO in the COMMAND DISPLAY field in order to specify whether or not the FT commands which correspond to the functions you select in the subsequent menus are to be displayed on the screen, together with all the parameters which correspond to your entries in the data entry panel, if applicable.
Provided you do not change this setting, it remains valid throughout the session and is retained after the session is terminated.
The following list illustrates the hierarchy of the subsequent menus and functions that can be accessed from the Primary Option Menu. FTAC-specific items are present only if openFT-AC is installed.
You can use the functions under 1 ADMINISTRATION only if you are the FT administrator.
1 ADMINISTRATION
1 OPERATING PARAMETERS
1 LOAD openFT (ONLY AS A BATCH JOB)
2 START LOCAL FT SYSTEM
3 STOP LOCAL FT SYSTEM
4 TERMINATE openFT
5 KEY MANAGEMENT
1 CREATE KEY SET
2 DELETE KEY SET WITH REFERENCE ... (1..9999999)
3 UPDATE KEY SET
4 MODIFY KEY
5 SHOW KEY
6 IMPORT KEY
6 MODIFY FT OPTIONS
2 REMOTE SYSTEMS
(add, list, modify, remove FT-partners)
3 ADDITIONAL PARTNER DEFINITIONS (EDIT TNSTCPIP)
4 FTAC ENVIRONMENT
1 EXPORT FTAC ENVIRONMENT
2 IMPORT FTAC ENVIRONMENT
3 SHOW FTAC ENVIRONMENT
5 INSTALLATION PARAMETERS
1 DISPLAY DIALOG ENVIRONMENT
2 DISPLAY PRESET INSTALLATION PARAMETERS
3 EDIT PARM (INSTALLATION PARAMETERS)
4 PRTJOB: ...
5 TSOJOB: ...
6 JCLJOB: ...
7 TSOVVJOB: ...
8 TSONVJOB: ...
9 TSOVFJOB : ...
S SUCCMSG: ...
F FAILMSG: ...
6 LOGGING/DIAGNOSTIC FUNCTIONS
1 SHOW LOGGING RECORDS OR FILES
2 DELETE LOGGING RECORDS OR FILES
3 SHOW DIAGNOSTIC INFORMATION
4 SHOW openFT TRACE DATA
2 FILE TRANSFER REQUESTS
1 ENTER FILE TRANSFER REQUEST
2 SHOW/MODIFY/CANCEL FILE TRANSFER REQUEST(S)
3 SHOW LOGGING RECORDS OR FILES
4 SHOW ALLOWED PARTNER SYSTEMS
3 EXECUTE REMOTE COMMANDS
4 EXECUTE REMOTE FTADM COMMANDS
5 ADMISSION SETS
6 ADMISSION PROFILES
(Create, list, modify, delete FT admission profiles)