HP 3000 Manuals HP 3000 Manuals
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.
VTURNON {COMAREA,TERMFILE}
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.
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:
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:=` ';
VUTURNON(COMAREA,T1);