This routine acquires the specified length of a string beginning at the specified position on the screen.
Specification
01 position-on-screen. 02 line-position PIC 9(4) BINARY. 02 column-position PIC 9(4) BINARY. 01 character-buffer PIC X(n). 01 string-length PIC 9(4) BINARY. 01 status-code PIC S9(4) COMP-5.
CALL "CBL_READ_SCR_CHARS" USING position-on-screen character-buffer string-length RETURNING status-code.
Interface
Specifies a line by using a numeric value with the upper-most line assumed to be the origin (0).
Specifies a column by using a numeric value with the left-most column assumed to be the origin (0).
Specifies the area used to store the string to be acquired.
Specifies the length of the string to be acquired.
Return code
The return code is set in the status-code specified in the RETURNING clause.
0: Successful
Other than 0: Failure