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

Appendix L 663
A Programmer’s Guide to VPLUS
VPLUS Enhancements
User Environment Control File (Introduced on VPLUS B.04.20 in
MPE G.02.01)
With VPLUS version B.04.20 introduced in MPE G.02.01, there is an MPE file called
VENVCNTL.PUB.SYS which is opened and read on the VOPENTERM call. Currently, the
VPLUS USER ENVIRONMENT CONTROL file can control two items when VOPENTERM is
executed. Two options have been implemented for the user environment control file.
• The first option is an abbreviated terminal query. When VOPENTERM is called, it goes
through an involved process to identify the terminal type. With the VPLUS user
environment control file, this terminal identification process can be shortened. This
option should only be used if it is known that a query will return a valid terminal ID. To
effect a shortened terminal query, place a “1” in column 1 of the VENVCNTL file.
• The second option is the ability to enable A/M/U without using a program. Instead of
setting the SHOWCONTROL word of the user’s COMAREA in your program, use the
VENVCNTL file. Placing a “1” in column 2 of the VENVCNTL file enables the keys. This
option is particularly useful if you do not have source code for the software packages
that you are running, but would like to enable A/M/U.
To implement a user environment control file for VPLUS, build the file:
:BUILD VENVCNTL.PUB.SYS;DEV=DISC;REC=-80,1,F,ASCII
Use any type of editor tool to place “1” in column 1 and/or column 2. When VOPENTERM
executes, it looks for the user environment control file. If it doesn’t find it, VPLUS operates
as usual. If the file exists and columns 1 and/or 2 are set, VPLUS will perform the
abbreviated terminal query and/or the enabling of keys, depending on what columns are
set.
It is also possible to have a VENVCNTL file in a different group and account than PUB.SYS.If
the file is in another group and account, this file equation is necessary:
:FILE VENVCNTL.PUB.SYS=VENVCNTL.mygroup.myaccount
For more information on how to implement the features, refer to the VPLUS/V Reference
Manual.