HP 3000 Manuals

Insert Line From Macro [ HP EDIT Reference Manual ] MPE/iX 5.0 Documentation


HP EDIT Reference Manual

Insert Line From Macro 

Purpose 

Enables you to insert a new line within an executing macro.

Default Syntax 

$I

Description 

This command, when executed within a macro, suspends a currently
executing macro and enables you to insert a new line above the current
line.

Command Process 

When the macro pauses for your input, HP EDIT moves the cursor to the
first column of a new line above the current line, enabling you to add
new text.  You can add subsequent lines by pressing Return without
preceding it with the / key.  When you have finished adding text,
pressing / and Return returns you to Command mode.  After you have
returned to Command mode, HP EDIT resumes execution of the macro.

Syntax Considerations 

In order to use this command within a macro, you must properly construct
the macro using correct syntax.  Refer to the Define Macro command for
information about required syntax.

Since the standard Meta key (ESC) is displayed as ^[ when inserted in a
macro, HP EDIT provides the dollar sign ($) as an alternate Meta key.
Consequently, you should use the recommended syntax of $I within a macro.

Procedure 

To execute this command within a macro: 

   1.  Construct the macro containing this command using proper macro
       syntax.  Refer to the Define Macro command for information about
       constructing macros.  Skip to Step 3 if this macro is preemptive
       (preempts the command to which the key is ordinarily assigned).

   2.  Execute the macro by pressing the m key.  HP EDIT displays Specify 
       macroname on the message line.

   3.  Type the macro name as specified in the macro.  HP EDIT executes
       the macro and pauses for your input.

   4.  Provide the input and then press / and Return to return to Command
       mode.  HP EDIT resumes execution of the macro.

Example 

To construct, define, and execute a macro that pauses for you to insert a 
new line above the current line: 

   1.  Insert a new line in text by executing the Insert Line (I)
       command.

   2.  Type in the following macro beginning at the cursor position:

            mI=AInsert a line/^m$I; new text./^m

   3.  Press / and Return to exit Text Entry mode and enter Command mode.

   4.  Execute the Define Macro (z) command.  HP EDIT removes the macro
       from the screen and stores it for subsequent execution.

   5.  Press the m key.  HP EDIT displays the following prompt on the
       message line:

            Specify macroname

   6.  Press the I key.  HP EDIT executes the macro and waits for your
       input after the following text appears on your terminal:

            _
            Insert a line

   7.  Type to add beginning at the cursor position as shown:

            to add_
            Insert a line

   8.  Press / and Return to return to Command mode.  HP EDIT resumes and
       concludes the macro execution and appends new text.  following
       your input as shown:

            to add new text.
            Insert a line

Related Commands 

       Append Line From Macro
       Append To Character From Macro
       Append To End Of Line From Macro
       Append To Word From Macro
       Define Replace Pattern From Macro
       Define Search Pattern From Macro
       Insert Character From Macro
       Insert Line
       Replace Character From Macro
       Replace Line From Macro
       Replace Word From Macro
       Overwrite From Macro



MPE/iX 5.0 Documentation