SCREEN INSERT_LINE

SCREEN INSERT_LINE inserts a line into a window at a position other than the first or last line. Existing lines are scrolled in the specified direction to create an open space. If the character string does not span the width of the window, it is padded with blanks.

SCREEN PUT_WITH_SCROLL is used to add lines and scroll at the first or last line in a window.

SYNTAX

SCREEN INSERT_LINE /USING/ window_id start_row string direction rendition wrap_flag

window_id	is an integer system field, Global Storage (GS) field, or user-defined field that contains the window ID assigned to the window.
start_row	specifies the line number at which the string is inserted and scrolling begins.
string	is a string expression that specifies the characters to be inserted.
direction	specifies the direction of the scroll. The valid values are: @UP scrolls the screen in an upward direction. @DOWN scrolls the screen in a downward direction.
rendition	specifies the video attributes of the inserted text. More than one attribute may be defined by separating the attributes with plus signs.
	The valid video attributes are: NORMAL specifies normal video attribute. [default setting] BLINK specifies blinking video attribute. BOLD specifies bold face video attribute. REVERSE specifies reverse video attribute. UNDERLINE specifies underlining video attribute.
wrap_flag	specifies the action to take if the text does not fit on the line. The valid values are: @WRAP wraps text which does not fit on the line to the next line. @NOWRAP does not wrap text to the next line if it does not fit on the line.

EXAMPLE

SCREEN INSERT_LINE MAIN_ID 10 &
'Enter your name in this format: last, first', & @DOWN NORMAL,@WRAP

This example enters the line of text in normal video at row 10. The original line is wrapped and scrolled to the next line.

SEE ALSO: SCREEN PUT_WITH_SCROLL (later in this section).