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

676 AppendixL
A Programmer’s Guide to VPLUS
VPRINTSCREEN Intrinsic
A user may change any of these characteristics with a :FILE command.
It is recommended that VPRINTSCREEN and VPRINTFORM not be used together within the
same program. Since the same list file is used for both listings, output from the two calls
will be intermixed.
Another visible difference between VPRINTFORM and VPRINTSCREEN is that VPRINTFORM
gives you the option to underline fields. This option is NOT available with VPRINTSCREEN
(LP mode).
A PAGE EJECT is performed each time VPRINTSCREEN is called (at the completion of the
print operation).
Documentation Mode
The output provided in this mode of operation is intended for manual writers and/or
programmers who are familiar with TDP. The user must already have TDP on their
system or must purchase it to use VPRINTSCREEN in this mode.
In documentation mode, VPRINTSCREEN in conjunction with TDP, provides the capability to
print screen contents on a laser printer (HP2680A and HP2688A). With this more, borders,
field highlighting (other than color), alternate character sets, and active function keys are
captured and converted to the appropriate font for printing on the laser printer.
Documentation node is enabled by setting a JCW before running the program:
:SETJCW VPRINTJCW=1
When VPRINTJCW is set to “1”, the list file, FORMLIST is NOT opened. Instead, a temporary
ASCII disc file, EPOCLIST, is created (or appended to, if it already exists). This file can be
saved and renamed on completion, and then input to TDP and “finaled”. A documenter can
also add text to the file, or have a separate file, and use the TDP “include” statement to
access the screens. (Refer to the TDP Reference Manual for a detailed discussion on USE
and INCLUDE files).
In order to print the forms to a laser printer, an environment file must be created. (See the
IFS/3000 Reference Guide). We have supplied sample environment files which can be used
if the user does not already have his/her own files. If other environment files are used, they
must include the font ids shown under LIMITATIONS> The supplied files are:
VENV80 environment file for the HP2680 laser printer
VENV88 environment file for the HP2688 laser printer
VSETUP TDP include file which sets parameters for TDP listings and references the
environment files
VEPOCUSE TDP USE file which separates each screen contained in EPOCLIST into
separate files
VPRTDEMO Demo program which demonstrates the use of the VPRINTSCREEN
intrinsic
NOTE See the section titled “Viewing the VPRINTSCREEN Demo” for information
on obtaining these files.