VTURNON [ HP Data Entry and Forms Management System (VPLUS/V) ] MPE/iX 5.0 Documentation
HP Data Entry and Forms Management System (VPLUS/V)
VTURNON
Turns on VPLUS/V block mode without disturbing the terminal screen.
Syntax
VTURNON {comarea,TERMFILE}
Parameters
comarea The comarea name must be unique for each open forms
file. The comarea must be the same one used in
VOPENTERM. The following comarea items must be set
before the call if not already set:
cstatus Set to zero.
language Set too 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.
fileerrnum Set to file error code if there is an
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
Discussion
VTURNON is normally used in an application when the terminal has already
been opened by VOPENTERM and VTURNOFF was called to switch out of VPLUS/V
block mode. VTURNON switches the application back to VPLUS/V block mode
without disturbing the image on the terminal screen.
VTURNON reconfigures the terminal and the driver without performing the
following operations, which are usually carried out by VOPENTERM.
* Initialize local form storage
* Clear screen
* Enable the USERKEYS 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 HP2640B or HP2644 terminal and the terminal is not on
block mode.
Example
The following examples illustrate a call to VTURNON:
COBOL
CALL "VTURNON" USING COMAREA, T1.
BASIC
90 T1$=" "
100 CALL VTURNON(C(*),T1$)
FORTRAN
T1=" "
VTURNON(COMAREA,T1);
SPL
MOVE T1:=" ";
VTURNON(COMAREA,T1);
PASCAL
T1:=' ';
VTURNON(COMAREA,T1);
MPE/iX 5.0 Documentation