HP 3000 Manuals

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