11.20 CBL_WRITE_SCR_N

This routine sets a specified number of specified characters having specified attributes from 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 w-character           PIC X.
01 attribute             PIC 1(8) BIT.
01 number-of-characters  PIC 9(4) BINARY.
01 status-code           PIC S9(4) COMP-5.

Calling format

CALL "CBL_WRITE_SCR_N_CHATTR"
    USING position-on-screen
          w-character
          attribute
          number-of-characters
    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).

w-character: Specifies the character to be written on the screen.

attribute: Specifies the attribute to be set for the character to be written on the screen. See "11.14 CBL_WRITE_SCR_ATTRS" about attributes.

number-of-characters: Specifies the number of characters and attributes to be written on the screen.

Return code

The return code is set in the status-code specified in the RETURNING clause.

status-code

0: Successful
Other than 0: Failure

11.20 CBL_WRITE_SCR_N_CHATTR