Top
NetCOBOL V11.0 CBL Subroutines User's Guide
FUJITSU Software

11.22 CBL_READ_SCR_CHARS

This routine acquires the specified length of a string beginning at the specified position on the screen.

Specification

Parameter data definition
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.
Calling format
CALL "CBL_READ_SCR_CHARS"
    USING position-on-screen
          character-buffer
          string-length
    RETURNING status-code.

Interface

line-position

Specifies a line by using a numeric value with the upper-most line assumed to be the origin (0).

column-position

Specifies a column by using a numeric value with the left-most column assumed to be the origin (0).

character-buffer

Specifies the area used to store the string to be acquired.

string-length

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.

status-code
  • 0: Successful

  • Other than 0: Failure