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

320 Chapter6
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
VOPENTERM
Opens a VPLUS 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. For additional information about about using the pseudo
intrinsic .LOC to put and address into a word of the COMAREA, refer to the
COBOL II/XL Reference Manual.
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 terminal type code.
environ Set to logical device number of terminal.
labinfo Set to appropriate number and length of labels used by
VPLUS.
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