HP Data Entry and Forms Management System (VPLUS) Reference Manual (32209-90024)

Chapter 6 359
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
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.
Syntax
VTURNOFF {COMAREA}
Parameters
COMAREA Must be COMAREA name specified when the forms file was opened with
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 in COMAREA.
VTURNOFF may set the following COMAREA fields:
CSTATUS Set to nonzero value if call is unsuccessful or if field’s error
flag is set.
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);