INSERT—Prepare Display for Data Insertion

The INSERT macro command inserts one or more blank lines, and allows you to fill them with data.

Syntax


Macro command syntax

>>-ISREDIT--INSERT--+-label---+--+----------+------------------><
                    '-linenum-'  '-numlines-'

label: A label that shows which line you want the inserted line or lines to follow.
linenum: A relative line number that shows which line you want the inserted line or lines to follow.
numlines: The number of lines to appear for data input; these lines are not saved until they contain data. If you do not type a number or if the number you type is 1, only one data input line appears.

Description

Use the INSERT macro command for data input. Inserted lines are initialized with data from the mask line. However, they are not data lines and cannot be referred to by any macro. Inserted lines are deleted if they do not contain data.

You must specify that the line referenced on INSERT should be displayed; otherwise, you will not see the inserted line. Use LOCATE to position a line at the top of the display.

Do not use this command for adding lines with specific data; instead, use the LINE_BEFORE and LINE_AFTER assignment statements.

Return codes

0: Normal completion
12: Invalid line number
20: Severe error

Examples

To open a 5-line area for data input after the line with the label .POINT, locate .POINT to position it to the top of the display. Then issue INSERT:

ISREDIT LOCATE .POINT
ISREDIT INSERT .POINT 5