The conversion utility supports a keys help panel name on the KEYL tag. This allows a keys help panel to be associated with the key list. You can use the KEYLIST utility to add, change, or delete a keylist help panel name.

Alternatively, the application can provide the help panel name in the ZKEYHELP variable. However, the panel name specified as the keylist help panel either on the KEYL tag or by the KEYLIST utility overrides the panel name supplied by the ZKEYHELP variable.

Here is an example where we want only the F2, F3, and F6 keys to appear in the panel function key area, with F2 mapped to the SEARCH command defined in the application command table, F3 mapped to the EXIT command, and F6 mapped to the KEYSHELP command. We also want F1 to be active to support the ISPF HELP command. No other function keys are to be active for this key mapping list. To obtain this result, we define the function key mapping list like this:

<!doctype dm system>

<cmdtbl applid=abcd>
  <cmd name=search>Search
    <cmdact action=passthru>
</cmdtbl>
<keyl name=panlkeys help=pnlkeyh>
  <keyi key=f1 cmd=help>
  <keyi key=f2 cmd=search fka=yes>Search
  <keyi key=f3 cmd=exit fka=yes>Exit
  <keyi key=f6 cmd=keyshelp fka=yes>Keyshelp
</keyl>

<panel name=panl01 keylist=panlkeys>
⋮
</panel>

This is how the function key area appears when panel "panl01" is displayed:

  F2=Search  F3=Exit  F6=Keyshelp