Non-keylist PF key settings

When you select Non-Keylist PF key settings from the Function keys pull-down on the ISPF Settings panel action bar, the PF Key Definitions and Labels panel shown in Figure 1 is displayed. If you enter the KEYS command on the command line of any panel, the system displays one of two panels:

If you are not using keylists (that is, keylists are disabled) or if there is no keylist associated with the panel from which you enter the KEYS command, the PF Key Definitions and Labels panel shown in Figure 1 is displayed.
If you are using keylists (that is, keylists are enabled) and there is a keylist associated with the panel from which you enter the KEYS command, the Keylist Change panel shown in Figure 2 is displayed.

If you define your application panels using panel definition statements, use the PF Key Definitions and Labels - Primary Keys panel to assign function keys and associated labels to ISPF commands.

Note: See Keylist settings to find out how to assign function keys that are associated with a keylist.

Figure 1. PF Key Definitions and Labels panel (ISPOPT3D)

                         PF Key Definitions and Labels
                                                                    More:     +
 Number of PF Keys . . . 12                         Terminal type  . : 3278

 PF1 . . . HELP                                                                
 PF2 . . . SPLIT                                                               
 PF3 . . . END                                                                 
 PF4 . . . RETURN                                                              
 PF5 . . . RFIND                                                               
 PF6 . . . RCHANGE                                                             
 PF7 . . . UP                                                                  
 PF8 . . . DOWN                                                                
 PF9 . . . SWAP                                                                
 PF10  . . LEFT                                                                
 PF11  . . RIGHT                                                               
 PF12  . . RETRIEVE                                                            

 PF1  label  . .            PF2  label  . .            PF3  label  . .         
 PF4  label  . .            PF5  label  . .            PF6  label  . .         
 PF7  label  . .            PF8  label  . .            PF9  label  . .         
 PF10 label  . .            PF11 label  . .            PF12 label  . .         

 Press ENTER key to display alternate keys. Enter END command to exit.
 Command ===>                                                                 
  F1=Help      F2=Split     F3=Exit      F7=Backward  F8=Forward   F9=Swap
 F12=Cancel

Note: The panel in Figure 1 is displayed for terminals with 12 function keys. For terminals with 24 function keys, the first panel displayed shows the primary keys (F1-F12). When you press the Enter key, ISPF displays a panel showing the alternate keys (F13-F24). To alternate between the two panels, press the Enter key.

You can assign function keys to system commands, such as HELP or END, to commands that are meaningful within a particular function or environment, such as the Edit FIND and CHANGE commands, and to line commands, such as the Edit or dialog test I or D commands.

Before changing function key assignments, verify the terminal type selected on the ISPF Settings panel and the number of function keys (12 or 24). For a list of valid terminal types refer to Figure 1.

You can define or change a function key function simply by equating the key to a command. For example:

 PF9 . . . CHANGE ALL ABC XYZ
 PF12  . . PRINT

In the example, F9 has been equated to an Edit command, and F12 has been equated to the system-defined PRINT command.

If you enter a blank for any function key definition, the key is restored to its ISPF default.

A function key definition beginning with a colon ( : ) is treated as a special case. The colon is stripped off, and the command to which the key is equated is inserted in the first input field on the line at which the cursor is currently positioned.

A function key definition beginning with a greater-than sign ( > ) is another special case. It causes the command to be passed to the dialog, regardless of whether the command appears in the command tables. When an ISPF function is executing, do not press the RESET key and then attempt to enter information or use a function key, because the results are unpredictable.

The label fields shown in Figure 1 allow you to specify user-defined labels for the displayed representations of function key definitions. This provides for displaying meaningful words of eight characters or fewer, rather than the first eight, possibly meaningless, characters of a lengthy function key definition.

If a label is not assigned, the definitions displayed for that function key consist of the first eight characters of the function key definition.

If the label value is BLANK, the function key number and the equal sign display, but the value portion of that function key definition displays as actual blanks. This label might be used if, for example, a function key is not defined or if it is meaningless to the user, but the dialog developer wants each function key number to appear sequentially in the function key definition lines.

No function key information, not even the number, appears if the label value for that key is NOSHOW.

Figure 2 shows how the function key panel can be used to assign definitions and labels. In this example, F4 has been equated to a TSO data management command, while F12 has been equated to a command that requests job submission. Labels for several function keys are defined as well.

Figure 2. Using the PF Key Definitions and Labels panel (ISPOPT3E)

                         PF Key Definitions and Labels
                                                                    More:     +
 Number of PF Keys . . . 24                         Terminal type  . : 3278

 PF1 . . . HELP                                                                
 PF2 . . . SPLIT                                                               
 PF3 . . . END                                                                 
 PF4 . . . TSO LISTALC ST                                                      
 PF5 . . . RFIND                                                               
 PF6 . . . RCHANGE                                                             
 PF7 . . . UP                                                                  
 PF8 . . . DOWN                                                                
 PF9 . . . SWAP                                                                
 PF10  . . LEFT                                                                
 PF11  . . RIGHT                                                               
 PF12  . . TSO SUBMIT NOTIFY                                                   

 PF1  label  . .            PF2  label  . . BLANK      PF3  label  . .         
 PF4  label  . . DATASETS   PF5  label  . . FIND       PF6  label  . . CHANGE  
 PF7  label  . . NOSHOW     PF8  label  . . NOSHOW     PF9  label  . .         
 PF10 label  . .            PF11 label  . .            PF12 label  . . SUBMIT  

 Press ENTER key to display alternate keys. Enter END command to exit.
 Command ===>                                                                 
  F1=Help      F2=Split     F3=Exit      F7=Backward  F8=Forward   F9=Swap
 F12=Cancel

This figure shows the function key settings that are displayed on a panel when defined using the key definitions and labels in Figure 2.

Figure 3. Example screen with function key definition lines

------------------------ EMPLOYEE SERIAL -------------- DUPLICATE NUMBER
COMMAND ===>

ENTER EMPLOYEE SERIAL BELOW:




   EMPLOYEE SERIAL ==> 598304       (MUST BE 6 NUMERIC DIGITS)



PRESS ENTER TO DISPLAY NEXT SCREEN FOR ENTRY OF EMPLOYEE DATA.

PRESS END KEY (PF3) TO END THIS SESSION.






 F1=HELP      F2=          F3=END       F4=DATASETS   F5=FIND   F6=CHANGE
 F9=SWAP     F10=LEFT     F11=RIGHT    F12=SUBMIT