The W$FLUSH routine causes the screen and/or cursor to be refreshed. It can be used to ensure that the user sees the most current display (see the explanation under comments, below).
Usage
CALL "W$FLUSH" USING PARAM-NUM
Parameters
PARAM-NUM numeric data item (optional) Specifies what part of the display (screen or cursor) is refreshed. Possible values are:
0 (default) the screen is made current, but the cursor may appear in an arbitrary location. (This is due to output optimization.)
1 the screen and cursor are made current 2 on UNIX machines using the BUFFERED-SCREEN configuration option, the screen is made current at the next clock tick on all other machines this has the same behavior as setting the value to "1". 3 on UNIX machines using the BUFFERED-SCREEN configuration option, the screen and cursor are made current at the next clock tick on all other machines this has the same behavior as setting the value to "1".Comments
Calling this routine refreshes the display so that the user sees everything that is current, even if an ACCEPT has not been performed. Normally, the runtime ensures that the information the user sees is correct only when input is required from the user. This means that if you DISPLAY some text or control, and then perform extensive processing without also performing an ACCEPT, the text or control may not be immediately visible to the user. Prior to the introduction of W$FLUSH, some programs worked around this problem with the statement:
ACCEPT OMITTED BEFORE TIME 0