Capture File [ HP EDIT Reference Manual ] MPE/iX 5.0 Documentation
HP EDIT Reference Manual
Capture File
Purpose
Captures current process text input and commands in a separate file.
Default Syntax
None
This command does not have a default key assignment. You can either
assign a key to the command using the Assign Key command or issue the
command using Execute Editor Command.
Description
This command provides an alternative to the Capture Macro command for
recording keyboard input. Even though both commands are initiated by
executing the Begin Capture command, they have totally different
purposes. The Begin Capture command enables you to create macros within
text and then define them by responding to prompts generated by the
Capture Macro command. Instead of creating and defining macros, you may
alternatively use the Capture File command to record all input in Text
Entry and Command modes for future reference or for debugging.
To use this command, you first text in the desired file and then execute
the Begin Capture command when you want to begin recording commands. If
capturing an entire session, you would execute the Begin Capture command
immediately after texting in the file.
When you want to save your recorded input to a file, you execute the
Capture File command. HP EDIT responds by prompting you for the capture
file name. After replying to the prompt, HP EDIT checks whether the
specified file already exists. If the file does not exist, HP EDIT
indicates that it has saved your input to the indicated file name. You
could then text in the specified capture file to view all commands and
input you entered while working on the previous file.
If the specified file already exists, HP EDIT displays a prompt asking
you whether you want to purge the old file to prevent you from
inadvertently writing over an existing file.
Procedure
To capture all keyboard input in a separate file:
1. Text in the desired file by executing the Text File (t) command,
then immediately execute the Begin Capture
( ESC ( ) command.
2. Edit the file as you normally would. When finished, or if you
encounter a problem that you want to subsequently troubleshoot,
proceed to step 3.
3. Issue Execute Editor Command (E). HP EDIT displays the prompt
Command: on the message line.
4. Type capture file beginning at the cursor position beside the
prompt. HP EDIT displays the prompt Capture file name: on the
message line. Proceed to Step 5 unless you want to abort the
command.
To abort the command, press either Return or CTRL y. HP EDIT
displays Capture still active on the message line. You can then
either continue editing or terminate the capture by executing the
Capture Macro ( ESC ) ) command.
5. Type the name of the file to which you want to save the recorded
input. If the specified file does not exist, HP EDIT displays
Keystrokes captured to X on the message line, where X represents
the name of the file you specified.
If the specified file exists, HP EDIT displays Purge the old file
(n/y)? on the message line. If you reply no (n), the command
aborts. If you reply yes (y), HP EDIT writes over the old file
with the captured keystrokes.
Related Commands
Begin Capture
Capture Macro
MPE/iX 5.0 Documentation