isCOBOL Evolve : Appendices : Library Routines : CBL_WRITE_SCR_CHARS
CBL_WRITE_SCR_CHARS
The CBL_WRITE_SCR_CHARS library routine writes a string of characters to the screen.
This routine is implemented for compatibility with other COBOLs in order to facilitate migrations. Using this routine in new programs is not suggested; you should use DISPLAY and ACCEPT verbs instead.
Syntax:
 CALL "CBL_WRITE_SCR_CHARS" USING screenPosition 
                                  characterBuffer
                                  stringLength
                           GIVING returnCode
Parameters:
screenPosition
Group Item
Group item defined as follows:
 
01  screenPosition.
    03  rowNumber      PIC X COMP-X.
    03  columnNumber   PIC X COMP-X.
 
It specifies the screen position at which to start writing. The top left corner is row 0, column 0.
characterBuffer
PIC X(n)
Specifies the characters to write to the screen.
stringLength
PIC XX COMP-X
On entry, contains the length of the string to write.
Return code:
returnCode can be any numeric data item and provides additional information:
1
Operation successful.
0
Operation failed.