HP 3000 Manuals HP 3000 Manuals
VTURNOFF
The VTURNOFF intrinsic turns off VPLUS block mode and enables character
mode access without disturbing the terminal screen. The syntax and
parameter descriptions for this intrinsic are provided below.
VTURNOFF {COMAREA}
COMAREA Must be COMAREA named when file was opened by
VOPENTERM. If not already set, the following
COMAREA items must be set before calling VTURNOFF.
CSTATUS Set to zero.
COMAREALEN Set to total number of 2-byte
words of COMAREA.
VTURNOFF may set the following COMAREA items:
CSTATUS Set to nonzero value if call
is unsuccessful.
FILERRNUM Set to file error code if MPE
file error.
VTURNOFF is used for momentarily switching from VPLUS block mode to
character mode. This procedure is designed for use after a terminal has
been previously opened by VOPENTERM or after a VTURNON.
VTURNOFF reconfigures the terminal and driver for character mode
operations without disturbing the screen image on the terminal. The
following operations normally performed in VCLOSETERM are not performed
in VTURNOFF:
* Clear local form storage
* Enable the USER/SYSTEM keys
* Disable touch reporting, delete touch fields
* Clear screen
* Unlock keyboard
* Close terminal file
Note that VTURNOFF does not close the terminal file. To close the file
and completely reset the driver and the terminal, VCLOSETERM must be
used.
The following examples illustrate a call to VTURNOFF:
COBOL:
CALL "VTURNOFF" USING COMAREA.
BASIC:
200 CALL VTURNOFF(C(*))
FORTRAN:
CALL VTURNOFF(COMAREA)
SPL:
VTURNOFF(COMAREA);
Pascal:
VTURNOFF(COMAREA);