SCREEN PUT_LINE

SCREEN PUT_LINE writes one or more lines of characters to a window. The entire line is written, starting at the current cursor position. If the character string does not span the entire line, the line is padded with blanks. The cursor is positioned at column 1 of the next available line.

SYNTAX

SCREEN PUT_LINE /USING/ window_id string row_advance, 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.
string	is a string expression that specifies the character string to be written.
row_advance	is an integer expression that specifies the number of lines to advance after putting a line of text in the window.
rendition	specifies the video attributes of the written 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 if the line will wrap-around when the text does not fit on the line. The valid values are: @WRAP causes the line to wrap-around. @NOWRAP causes excess characters to be discarded.

EXAMPLE

SCREEN PUT_LINE USING MAIN_ID &
"Please select one of the options listed below:" &
2,@BOLD+@BLINK,@WRAP

This example inserts the text string in the MAIN_ID window, wrapping around as needed. It then advances the cursor position two lines. The text is displayed in bold, blinking attributes.