HP 3000 Manuals HP 3000 Manuals
VOPENTERM
Opens a VPLUS/V supported terminal.
Syntax
VOPENTERM {comarea,termfile}
Parameters
comarea The comarea name must be unique for each open forms
file. The calling program should initialize the entire
comarea to zero before calling VOPENTERM. In addition,
the following comarea items must be set before calling
VOPENTERM:
cstatus Set to zero.
language Set to the code identifying the
programming language of the calling
program.
comarealen Set to total number of two-byte words
of comarea.
formstoresize Set to minus one, zero, or one through
255 to indicate the number of forms
allowed in the form storage directory.
VOPENTERM may set the following comarea items:
cstatus Set to nonzero value if call
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
type code.
environ Set to logical device number of
terminal.
labinfo Set to appropriate number and length of
labels used by VPLUS/V.
If the data capture devices are used:
leftmodule Set to appropriate value defining
terminal.
rightmodule Set to appropriate value defining
terminal.
keyboard Set to appropriate value defining
terminal.
display Set to appropriate value defining
terminal.
termfile Character string of up to 36 characters (including a
terminator) that identifies the terminal. If set to a
blank, the session device is used to get the ldev# of
the logon terminal. Otherwise, any fully qualified MPE
file name can be assigned to the terminal as its formal
file designator. If specified, the name must be
terminated by a special character (a blank is
suggested). Before using a terminal identified by name,
the formal designator may be equated to an actual
designator with a :FILE command.
Discussion
This intrinsic opens the terminal as a file. If you are running your
program as a session with your terminal as the open terminal file, the
terminal name should be left blank so that the session device is opened.
Once the terminal is opened for control by VPLUS/V, an application should
not call system intrinsics to communicate with the terminal. All
terminal I/O must be controlled through VPLUS/V intrinsics.
If you are using an HP 2640B or HP 2644 terminal and the terminal is not
in block mode, VOPENTERM asks you to press the BLOCK MODE key; other
terminals are set to block mode automatically. The data capture devices
are treated as character mode terminals.
Example
COBOL
77 T1 PIC X(8) VALUE "VTERM"
01 COMAREA.
:
:
PROCEDURE DIVISION.
:
OPENTERMINAL.
CALL "VOPENTERM" USING COMAREA, T1.
This example opens the device referenced by the file equation VTERM. If
no file equation exists, the default is the logon device.
BASIC
90 Tl$-#" "
100 CALL VOPENTERM(C(*),T1$)
FORTRAN
T1=" "
VOPENTERM(COMAREA,T1)
SPL/PASCAL
MOVE T1:=" ";
VOPENTERM(COMAREA,T1);
The examples shown above open the session device with comarea identified
as COMAREA (C(60) for BASIC).