z/OS ISPF User's Guide Vol II
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Keylist settings

z/OS ISPF User's Guide Vol II
SC19-3628-00

To create or change a keylist associated with your panels, or to refer to or delete a keylist help panel from your keylist, select the " Keylist settings" choice from the Function keys pull-down on the ISPF Settings panel action bar, or enter the KEYLIST command. The first panel displayed is similar to Figure 1. If you Enter the KEYS command from a panel that uses a keylist, the keylist change panel for the keylist active on the original panel is displayed.

Figure 1. Keylist Utility panel (ISPKLUP)
  ┌─────────────────────────── Keylist Utility ───────────────────────────┐
─ │   File  View                                                          │ ──
  │ ────────────────────────────────────────────────────────────────────  │
  │                     Keylist Utility for ISR         Row 1 to 11 of 16 │  +
O │                                                                       │
  │ Actions:   N=New  E=Edit  V=View  D=Delete  /=None                    │
  │                                                                       │
  │    Keylist   Type                                                     │
  │    ISRHELP   SHARED                                                   │
  │    ISRHLP2   SHARED                                                   │
  │    ISRNAB    SHARED                                                   │
  │    ISRNSAB   SHARED                                                   │
  │    ISRREFL   SHARED                                                   │
  │    ISRREFO   SHARED                                                   │
  │    ISRSAB    SHARED    *** Currently active keylist ***               │
  │    ISRSCRVT  SHARED                                                   │
  │    ISRSLAPP  SHARED                                                   │
  │    ISRSNAB   SHARED                                                   │
T │    ISRSPBC   SHARED                                                   │
  │                                                                       │
  │ Command ===>                                       Scroll ===> PAGE   │
C │  F1=Help       F2=Split      F3=Exit       F7=Backward   F8=Forward   │
  │  F9=Swap      F10=Actions   F12=Cancel                                │
F └───────────────────────────────────────────────────────────────────────┘

In Figure 1, ISPHELP, ISPHLP2, ISPNAB, ISPSAB, ISPSNAB, ISPTEST, ISRHELP, ISRNAB, and ISRNSAB have already been created for application ISR. ISPSAB, the currently active keylist, and ISPSNAB are keylists for the keylist utility panels. ISPKYLST is the ISPF default keylist for any DTL application panel or any panel defined with a )PANEL section that does not have a keylist defined. ISPHELP is the ISPF keylist for help panels created using DTL or using a )PANEL section.

The application ID is shown on the title line of the panel (ISR in Figure 1) and defaults to the application ID of the keys table in which the keylist was found when the KEYLIST command was entered. You can specify the keylist application ID on the )PANEL statement, or, if using DTL, it can be specified when you call the ISPF conversion utility using the KEYLAPPL option on the ISPDTLC command. If the panel does not specify an application ID, ISPF searches the currently executing application's keys table for a keylist that has the same name as the name specified on the PANEL tag. If the keylist is not found, and the current application ID is not ISP, ISPF searches the ISP application.

The column marked Type indicates whether a keylist is shared or is a private copy. For information about the KEYLIST SHARED and KEYLIST PRIVATE system commands, see the topic about Using Commands, Function Keys, and Light Pen or Cursor Selection in the z/OS ISPF User's Guide Vol I. Shared keylists are created by the ISPF DTL Conversion Utility. They cannot be deleted by the keylist utility. If a shared keylist is modified by the keylist utility, it is saved as a private keylist copy in a table named xxxxPROF, where xxxx is the application ID. The keylist utility now shows the keylist as a private copy. If you have issued the KEYLIST SHARED command, you can still modify a keylist, but you cannot see the changes reflected in the function keys until the KEYLIST PRIVATE command is issued.

Note: The keylist utility is meant for users to modify function keys for their own use. To define function keys for all users of an application or for site-wide use, the definitions in the Dialog Tag Language should be modified and a new xxxxKEYS table should be generated.

The Keylist Utility panel action bar choices function as follows:

File
Allows you to create a new keylist, to edit, view, or delete existing keylists, or to exit the keylist utility.
View
Enables you to display another set of keylists. These options are described in View pull-down.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014