SET PFnn RETRIEVE

Read syntax diagramSkip visual syntax diagram Set PF nn RETrieve Backward1BackwardForward1iCLEAR

Authorization

Privilege Class: G

Purpose

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.

Operands

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.

Usage Notes

  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.
  4. If the saved line is longer than the input area, the line is truncated to the input area length.
  5. Do not use any operands before RETRIEVE. If you do so, CP interprets the RETRIEVE as PF data rather than the RETRIEVE function.
  6. To use the RETRIEVE function on a 3101, you must be in block mode.
  7. If you press a PF key that has not been set, the following message is displayed: 
    PFnn UNDEFINED

Messages

  • HCP026E Operand missing or invalid
  • HCP6892E Invalid number of buffer positions - nnn