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

Chapter 6 361
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
VTURNON
The VTURNON intrinsic turns on VPLUS block mode without disturbing the terminal
screen. The syntax and parameter descriptions for this intrinsic are provided below.
Syntax
VTURNON {COMAREA,TERMFILE}
Parameters
COMAREA The COMAREA name must be unique for each open forms file. The COMAREA
must be the same COMAREA used in VOPENTERM. The following COMAREA
items must be set before the call, if not already set:
CSTATUS Set to zero.
LANGUAGE Set to code that identifies the programming language of
the calling program.
COMAREALEN Set to total number of 2-byte words in COMAREA.
VTURNON 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.
FILEN Set to MPE file number of terminal.
IDENTIFIER Set to appropriate VPLUS/V terminal ID.
LAB’INFO Set to appropriate number and length of labels.
TERMFILE Must be the same terminal file name used in VOPENTERM.
VTURNON is normally used in an application when the terminal is already opened by
VOPENTERM, and VTURNOFF was called to switch out of VPLUS block mode. VTURNON
switches the application back to VPLUS block mode without disturbing the image on the
terminal screen.
VTURNON reconfigures the terminal and the driver without performing the following
operations which are normally performed by VOPENTERM:
• Initialize local form storage
• Clear screen
• Enable the USER function keys
• Disable or enable the USER/SYSTEM key, as specified in the SHOWCONTROL word
Unlike VOPENTERM, VTURNON will not ask you to press the BLOCK MODE key, if you are
using an HP 2640B or HP 2644 terminal when the terminal is not in block mode.
The following examples illustrate a call to VTURNON using common programming
languages:
COBOL: