Interactive I/O Instructions

The Interactive Input/Output Instructions accept information from the keyboard and to display information on the user's screen.

BEEP	Sound an audible bell at the screen.
CHARRESTORE	Restore the text of a window.
CHARSAVE	Save the text of a window.
DISPLAY	Display text information on the screen.
KEYIN	Key in information from the keyboard.
MOUSE	Control the mouse attached to the system.
SCRNRESTORE	Restore the complete screen and all screen information.
SCRNSAVE	Save the complete screen and all screen information.
SCRNSIZE	Returns the size of the variable required for the SCRNSAVE instruction.
SETWTITLE	Set the title of a window in a graphical user environment.
SNDCLOSE	Close a sound file.
SNDOPEN	Open a sound file.
SNDPLAY	Play an open sound file.
STATERESTORE	Restore the screen information.
STATESAVE	Save the screen information.
STATESIZE	Returns the size of the variable required for the STATESAVE instruction.
WINERASE	Erase entire graphical window.
WINHIDE	Disable the current graphical window.
WINREFRESH	Redraw all the currently active graphical object in the window.
WINRESTORE	Restore the complete window.
WINSAVE	Save the complete window.
WINSHOW	Enable the current graphical window.
WINSIZE	Returns the size of the variable required for the WINSAVE instruction.

The following is a list of general notes concerning these instructions:

Program Execution Labels are optional.
When an interactive input or output instruction terminates, the cursor is normally repositioned with a line feed and a carriage return (column 1 of the next line). If the cursor is located on the bottom line of the screen and the instruction was not terminated with a semi-colon, the screen may roll up one line unless the *NOROLL control is in effect.
If an input or output instruction is terminated with a semi-colon (;), the line feed and carriage return are suppressed and the cursor remains after the last byte output.
Formatting of data items is handled by both the data definition and any list controls.
All Function Flags are cleared upon entering a KEYIN instruction. If a Function Key is struck, or a mouse button pressed, the appropriate Function Flag is set and the remainder of the KEYIN bypassed. Under most circumstances, the EOS Condition Flags remain unchanged.