 |
To create, edit, view, or delete a keylist, use either of these
methods:
- Use a slash in the Select column to select a keylist from those
displayed, then select the appropriate choice from the File pull-down.
- Select a keylist from those displayed using one of these actions:
N(New), E(Edit), V(View), or D(Delete). If you use N(New), you are
prompted for the name of the keylist you are about to create.
The choices on the File pull-down function as follows:
- New
- To create a keylist, enter the keylist name when prompted. You
are prompted after selecting New from the File pull-down, or after
typing N next to any displayed keylist and pressing Enter. The screen
shown in Figure 1 is displayed.
Figure 1. Keylist Create panel (ISPKLUCR) ┌────────────────────────────── Keylist Utility ──────────────────────────────┐
│ File Defaults │
│ ────────────────────────────────────────────────────────────────────────── │
│ ISR Keylist SAMPLE1 Create Row 1 to 9 of 24 │
│ │
│ Make changes and then select File action bar choice. │
│ │
│ Keylist Help Panel Name . . . │
│ │
│ Key Definition Format Label │
│ F1 . . . │
│ F2 . . . │
│ F3 . . . │
│ F4 . . . │
│ F5 . . . │
│ F6 . . . │
│ F7 . . . │
│ F8 . . . │
│ F9 . . . │
│ │
│ Command ===> Scroll ===> PAGE │
│ F1=Help F2=Split F3=Exit F7=Backward F8=Forward │
│ F9=Swap F10=Actions F12=Cancel │
└─────────────────────────────────────────────────────────────────────────────┘
The Keylist Create panel action bar choices function as
follows:
- File
- The File pull-down offers these choices:
- 1
- Cancel. Cancels the creation of this keylist and returns
to the Keylist Utility panel.
- 2
- Save and Exit. Saves the keylist and returns to the Keylist
Utility panel.
- Defaults
- The Defaults pull-down offers you the choice of the five default
function key settings described in Table 1.
Table 1. Default key settings| Condition |
Function key settings |
|---|
| No defaults |
No values are filled in. |
| Non-scrollable, no action bar |
F1 HELP
F2 SPLIT
F3 EXIT
F9 SWAP
F12 CANCEL
|
| Scrollable, no action bar |
F1 HELP
F2 SPLIT
F3 EXIT
F7 BACKWARD
F8 FORWARD
F9 SWAP
F12 CANCEL
|
| Non-scrollable, with action bar |
F1 HELP
F2 SPLIT
F3 EXIT
F9 SWAP
F10 ACTIONS
F12 CANCEL
|
| Scrollable, with action bar |
F1 HELP
F2 SPLIT
F3 EXIT
F7 BACKWARD
F8 FORWARD
F9 SWAP
F10 ACTIONS
F12 CANCEL
|
If you are creating a keylist on a terminal defined to
have 24 keys, the 13-24 keys are set the same as the 1-12 keys. For
example, F13 is automatically set the same as F1. HELP, EXIT, ACTIONS,
and CANCEL all have display format SHORT. SPLIT, UP, DOWN, and SWAP
have display format LONG.
- Edit
- To edit the key definitions, display formats, and labels for a
keylist, enter the keylist name when prompted. Select a keylist with
a slash and select Edit from the File pull-down, or type E next to
a keylist name and press Enter. The screen shown in Figure 2 is displayed, showing the existing
values.
Figure 2. Keylist Change panel
(ISPKLUCH) ┌────────────────────────────── Keylist Utility ──────────────────────────────┐
│ File │
│ ────────────────────────────────────────────────────────────────────────── │
│ SHARED ISR Keylist SAMPLE1 Change Row 1 to 9 of 24 │
│ │
│ Make changes and then select File action bar. │
│ │
│ Keylist Help Panel Name . . . │
│ │
│ Key Definition Format Label │
│ F1 . . . HELP SHORT Help │
│ F2 . . . SPLIT LONG Split │
│ F3 . . . EXIT SHORT Exit │
│ F4 . . . │
│ F5 . . . │
│ F6 . . . │
│ F7 . . . UP LONG Backward │
│ F8 . . . DOWN LONG Forward │
│ F9 . . . SWAP LONG Swap │
│ │
│ Command ===> Scroll ===> PAGE │
│ F1=Help F2=Split F3=Exit F7=Backward F8=Forward │
│ F9=Swap F10=Actions F12=Cancel │
└─────────────────────────────────────────────────────────────────────────────┘
The Keylist Change panel action bar choice functions as
follows:
- File
- The File pull-down offers these choices:
- 1
- Cancel. Cancels the changes to this keylist and returns
to the Keylist Utility panel.
- 2
- Save and Exit. Saves the changes to this keylist and returns
to the Keylist Utility panel or the panel from which you issued the
KEYS command.
These fields appear on
the Keylist Utility Change panel:
- Row x to x of xx
- Indicates that you must scroll the panel to access the remaining
label definitions.
- Keylist Help Panel Name
- To
refer to a help panel from this keylist, enter the help panel name
in this field in this format:
- Must be 1-8 characters
- First, or only, character must be A-Z or a-z
- Remaining characters, if any, must be A-Z, a-z, 0-9
To remove a help panel name from
a keylist, replace the help panel name with blanks.
- Definition
- If a display format or a label is specified, a definition must
also be specified. Any definition is valid.
- Format
- The only valid display formats are:
- LONG
- The default. Indicates that the key label should be displayed
in the function key area when the FKA command is toggled to the first
cycle after OFF.
- SHORT
- Indicates that the key label should be displayed in the function
key area when the FKA command is toggled to the first or second cycle
after OFF. A key will display more often in the function key area
if it is given the SHORT display format.
- NO
- Indicates that the key label should never be displayed in the
function key area, regardless of the FKA command toggle cycle.
- Label
- Any label is valid. If the Label field is left blank, it will
default to the definition. This will happen only if the field is blank.
If the Label field is not blank and the definition is changed, the
Label field will not change automatically.
- View
- To view a keylist, but not modify it, enter the keylist name when
prompted. Select the keylist with a slash, then select View from the
File pull-down, or type V next to the keylist name displayed and press
Enter. The screen shown in Figure 3 is
displayed.
Figure 3. Keylist utility
view panel (ISPKLUB) ┌────────────────────────────── Keylist Utility ──────────────────────────────┐
│ SHARED ISR Keylist SAMPLE1 View Row 1 to 11 of 24 │
│ │
│ The definition of the SAMPLE1 keylist is below. │
│ │
│ Keylist Help Panel Name . . : ISPSAB │
│ │
│ Key Definition Format Label │
│ F1 . . . HELP SHORT Help │
│ F2 . . . SPLIT LONG Split │
│ F3 . . . EXIT SHORT Exit │
│ F4 . . . │
│ F5 . . . │
│ F6 . . . │
│ F7 . . . UP LONG Backward │
│ F8 . . . DOWN LONG Forward │
│ F9 . . . SWAP LONG Swap │
│ F10 . . │
│ F11 . . │
│ │
│ Command ===> Scroll ===> PAGE │
│ F1=Help F2=Split F3=Exit F7=Backward F8=Forward │
│ F9=Swap F12=Cancel │
└─────────────────────────────────────────────────────────────────────────────┘
If you select View, the help panel name, key definitions,
display formats, and labels are displayed but cannot be changed.
- Delete
- To delete a private copy of a keylist, enter the keylist name
when prompted. Select the keylist with a slash, then select Delete
from the File pull-down, or type D next to the keylist name displayed
and press Enter. The Delete Keylist Confirmation pop-up shown in Figure 4 is displayed.
Note: Shared keylists
can only be deleted using the Dialog Tag Language.
Figure 4. Keylist utility with delete keylist
confirmation pop-up (ISPKLUP) ┌─────────────────────────── Keylist Utility ───────────────────────────┐
─ │ File View │ ──
│ ─ ┌───────── Keylist Utility ──────────┐ ─────────────────────────── │
│ │ Delete Keylist Confirmation │ SR Row 2 to 12 of 17 │ +
O │ │ │ │
│ A │ Enter "/" to select option │ e /=View │
│ │ Confirm Delete of SAMPLE1 │ │
│ │ │ │
│ │ │ │
│ │ F1=Help F2=Split F3=Exit │ │
│ │ F9=Swap F12=Cancel │ │
│ └────────────────────────────────────┘ │
│ ┌────────────────┐ │
│ │ Delete Warning │ │
│ └────────────────┘ *** 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 └───────────────────────────────────────────────────────────────────────┘
Use caution when deleting a keylist from an application
that is currently running. If you delete a keylist that is required
by a panel in the application, an error message appears and the panel
does not display.
- Exit
- Select Exit from the File pull-down to exit the keylist utility.
|
z/OS ISPF User's Guide Vol II
Copyright IBM Corporation 1990, 2014