Begin Capture [ HP EDIT Reference Manual ] MPE/iX 5.0 Documentation
HP EDIT Reference Manual
Begin Capture
Purpose
Begins recording user input to define a macro.
Default Syntax
ESC (
Description
This command, along with the Capture Macro command, enables you to define
a macro from keyboard input.
When you execute the command, HP EDIT initiates the macro definition
process and indicates on the message line that the capture process has
been activated. You begin the capture process by typing any sequence of
keystrokes in both Command and Text Entry modes. HP EDIT stores these
keystrokes until you execute the Capture Macro command.
You should avoid pressing inactive terminal keys, such as the cursor
arrow keys, because HP EDIT does not record them.
The Capture Macro command completes the macro definition process by
prompting for information that HP EDIT requires to transform your keyed
text into a macro. Refer to the Capture Macro command for information
about command usage.
Procedure
To begin recording input to define a macro:
1. Press ESC, then press the ( key. HP EDIT displays Capture
activated on the message line.
2. Type the necessary keystrokes to perform the desired macro command
function.
Example
To define a macro assigned to the s key that splits a line at the cursor
position:
1. Execute the Begin Capture command by pressing ESC, then pressing
the ( key. HP EDIT displays the following prompt on the message
line:
Capture activated
2. Execute the Insert Character (i) command to enter Text Entry mode.
3. Press Return to split the line at the current cursor position.
4. Press / and Return to return to Command mode.
5. Execute the Capture Macro command by pressing ESC, then pressing
the ) key. HP EDIT displays the following prompt on the message
line:
Assign macro to which key? _
6. Press the s key. HP EDIT displays the following prompt on the
message line:
Is key prefixed with Meta? _
7. Press the n key to reply no. HP EDIT displays the following
prompt on the message line:
Is macro preemptive? _
8. Press the n key to reply no. If you reply yes instead, HP EDIT
automatically executes this macro whenever you press the s key,
rather than execute the Scroll Forward (s) command. Replying no
to the prompt necessitates using the Execute Macro (m) command or
the Go To Macro (M) command to execute the macro.
After you reply to the prompt, HP EDIT returns the cursor to its
former position on the macro text line and displays the following
message, indicating that the captured keystrokes have now been
defined as a macro named s:
Macro defined: s
Related Commands
Capture File
Capture Macro
MPE/iX 5.0 Documentation