HP 3000 Manuals

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