11.14 CBL_WRITE_SCR

This routine writes a string of attributes 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 attribute-buffer. 
   02 attribute        PIC 1(8) BIT occurs n times.
01 string-length       PIC 9(4) BINARY.
01 status-code         PIC S9(4) COMP-5.

Calling format

CALL "CBL_WRITE_SCR_ATTRS"
USING position-on-screen
      attribute-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).

attribute-buffer

Specifies the attributes to be displayed.

Attributes are as follows.

B"10000000"OVERLINE
B"01000000"REVERSE-VIDEO
B"00100000"GRID
B"00010000"UNDERLINE
B"00001000"HIGHLIGHT
B"00000100"FOREGROUND-COLOR(RED)
B"00000010"FOREGROUND-COLOR(GREEN)
B"00000001"FOREGROUND-COLOR(BLUE)

For UNIX systems:

B"10000000"Reserved
B"01000000"Reserved
B"00100000"Reserved
B"00010000"Reserved
B"00001000"BLANK
B"00000100"REVERSE-VIDEO
B"00000010"UNDERLINE
B"00000001"HIGHLIGHT

string-length: Specifies the length of the string to be displayed.

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.14 CBL_WRITE_SCR_ATTRS