NetCOBOL V11.0 CBL Subroutines User's Guide

11.7 CBL_CLEAR_SCR

This routine clears the screen by using a specified character with the specified attribute.

Specification

Parameter data definition

01 c-character  PIC X(1).
01 attribute    PIC 1(8) BIT.
01 status-code  PIC S9(4) COMP-5.

Calling format

CALL "CBL_CLEAR_SCR"
    USING c-character
          attribute
    RETURNING status-code.

Interface

c-character

Specifies the character to clear the screen.

attribute

Specifies the attribute of the character used to clear the screen.

See "11.14 CBL_WRITE_SCR_ATTRS" for information about attributes.

Return code

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

status-code

• 0: Successful

• Other than 0: Failure