Changing the format of the function key area

The FKA and PFSHOW commands let you change the visual display of the function keys on a panel. You can display the keys in long form or short form, or remove them completely. You can also use the PFSHOW command with the TAILOR parameter or the "Tailor function key display" choice from the Function keys pull-down on the ISPF Settings panel to display the Tailor Function Key Definition Display panel shown in Figure 1.

Figure 1. Tailor Function Key Definition Display Panel (ISPOPFA)

   ┌───────────────────────────── ISPF Settings ─────────────────────────────┐
 s │                 Tailor Function Key Definition Display                  │
   │                                                                         │
   │ For all terminals:                                                      │
 O │   Number of keys  . . 2  1. 12                                          │
   │                          2. 24                                          │
   │                                                                         │
   │   Keys per line . . . 1  1. Six                                         │
   │                          2. Maximum possible                            │
   │                                                                         │
   │   Primary range . . . 1  1. Lower - 1 to 12                             │
   │                          2. Upper - 13 to 24                            │
   │                                                                         │
   │ For terminals with 24 PF keys:                                          │
   │   Display set . . . . 1  1. Primary - display keys 1 to 12              │
   │                          2. Alternate - display keys 13 to 24           │
   │                          3. All - display all keys                      │
   │                                                                         │
   │ Press ENTER key to save changes.  Enter END to save changes and exit.   │
 T │                                                                         │
   │                                                                         │
   │ Command ===>                                                            │
 C │  F1=Help     F3=Exit    F12=Cancel                                      │
   └─────────────────────────────────────────────────────────────────────────┘

This panel lets you select:

The number of function keys available for display.
See the information about 'Tailor Function Key Definition Display' in the Settings (Option 0) topic of z/OS ISPF User's Guide Vol II for a discussion of the rules governing the number of keys available for display.
The number of keys per line to display in each function key definition line. System variable ZPFFMT holds the value selected.
Table 1. ZPFFMT system variable on PFSHOW
Choice Description ZPFFMT value
Six Always displays six keys per line SIX
Maximum possible Displays as many keys as will fit on each line. MAX

Note: The Maximum possible option is forced when you select the Panel display CUA mode option on the ISPF Settings panel.
The set of function keys that are to be the primary and alternate keys. System variable ZPRIKEYS holds the value selected.
Table 2. ZPRIKEYS values
Choice Description ZPRIKEYS value
Lower - 1 to 12 Primary keys are 1-12 LOW
Upper - 13 to 24 Primary keys are 13-24. UPP

The default value is Lower - 1 to 12.

The set of function keys on terminals with 24 function keys for which definitions are to be displayed. System variable ZPFSET holds the value selected.

Table 3. ZPFSET system variable, on PFSHOW
Choice	Description	ZPFSET value
Primary - display keys 1 to 12	Primary set (1-12)	PRI
Alternate - display keys 13 to 24	Alternate set (13-24)	ALT
All - display all keys	All keys (1-24).	ALL

ISPF ignores these values for terminals with only 12 function keys.

Variables ZPFFMT, ZPRIKEYS, and ZPFSET are stored in the application profile pool. Dialogs can set these values directly by using the VPUT statement in a panel definition, or by using the VPUT service in a dialog function.

Dialog developers can control how the PFSHOW command behaves by using the ZPFCTL system variable. ZPFCTL is also stored in the application profile pool. Its possible values are:

USER: The user can control the display of function key definition lines by using the PFSHOW command. This is the default value.
ON: ISPF unconditionally displays function key definitions on all panels. Issuing PFSHOW OFF, FKA OFF, or toggling to the no display setting causes ISPF to issue an error message.
OFF: ISPF does not display function key definition lines. If PFSHOW ON, PFSHOW TAILOR, FKA ON, or toggling to the long or short form setting of either command is issued, ISPF displays an error message.

Applications can set the ZPFCTL variable value to either USER, ON, or OFF by using the VPUT service or by using a VPUT statement with the PROFILE keyword.

Note: The ZPFCTL variable is ignored if the PFSHOW/FKA command is invoked from a panel containing a )PANEL statement or if the panel was created using DTL.

Similarly, keylists can be controlled to some degree by the application.

The ZKLUSE can be set to Y or N. If KEYLIST is ON, the value in ZKLUSE in the application profile is Y. If KEYLIST is OFF, it is N. If an application VPUTs the variable to the application profile, the keylist setting is altered.

These variables can be used by an application to determine what keylist is being used, and where it comes from.

ZKLNAME - If KEYLIST is ON and it is a panel with the )PANEL statement, ZKLNAME contains the name of the keylist currently being used. Otherwise it is blank.
ZKLAPPL - If KEYLIST is ON and it is a panel with the )PANEL statement, ZKLAPPL contains the application ID that the keylist currently being used came from. Otherwise it is blank.
ZKLTYPE - If KEYLIST is ON and it is a panel with the )PANEL statement, ZKLTYPE contains either P (private) or S (shared), depending on the keylist currently being used. Otherwise it is blank.

Function key definitions appear at the bottom of each logical screen. There can be more than one logical screen, such as when you are using the split-screen function. If the application has not issued an ADDPOP service call, ISPF displays no more than four function key definition lines on one panel. If the application has issued an ADDPOP service call and the set of keys to be displayed is primary or alternate, ISPF displays no more than two lines. If all of the keys are to be displayed, no more than four lines appear. If all of the keys will not fit on the lines, ISPF wraps the keys and truncates the last keys.