z/VM: CP Commands and Utilities Reference - z/VM - IBM

SET PFnn RETRIEVE
►►
Set
PFnn
Authorization
Purpose
Operands
Usage Notes
RETrieve
Backward
Backward
Forward
CLEAR
1
Privilege Class: G
1
i
SET PFnn RETRIEVE
Use SET PFnn RETRIEVE to assign a RETRIEVE function to a PF key. Use the PF
key to retrieve commands and search forward and backward through the
RETRIEVE buffers.
nn is the number of the program function key for which you are setting the
RETRIEVE function.
Backward i
Forward i
indicates the direction that CP skips through the RETRIEVE buffers. When this
program function key is pressed, CP searches through the RETRIEVE buffers i
positions (or 1 if i is not specified) and displays the command saved in that
RETRIEVE buffer only.
CLEAR
causes CP to discard the contents of any existing RETRIEVE buffers. This
option also causes CP to define this program function key as if you had entered
the command SET PFnn RETRIEVE BACKWARD 1.
1. If your keyboard has 24 PF keys, specify the PF key number, nn, as a value
from 1 (or 01) to 24. If your keyboard has 12 PF keys, specify nn as a value
from 1 (or 01) to 12.
2. After you define a RETRIEVE program function key or run the SET RETRIEVE
command, CP starts saving your input lines. If you enter SET PF11 RETRIEVE
BACKWARD 5 and then SET PF12 RETRIEVE FORWARD 3, pressing PF11
will move a pointer to the RETRIEVE buffer five buffers back. If you then press
PF12, CP moves the pointer up three buffers to the second one back. Once you
press ENTER to enter what was in the RETRIEVE buffer you selected, CP
resets the pointer back to the most recent buffer.
3. As a default, CP keeps track of seven input lines. See the SET RETRIEVE
command for modifying the number of input lines that are saved and for the
effects that SET PFnn can have on the SET RETRIEVE command. Any input
line that is an exact duplicate of the previous input line is not saved. For
security reasons, input lines that are not displayed on the display device, such
as passwords, are not saved.
►◄
Chapter 2. CP Commands 1319