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

Chapter 6 327
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
2. The INTRINSIC calling mechanism must be used when calling the VPLUS intrinsics
from the main and all interacting parts of the application. For example, with COBOL
the application must use:
:CALL INTRINSIC <intrinsic name>
Refer to Appendix E of this manual, and to the COBOL and Pascal reference manuals, for
more information on calling mechanisms.
For applications that use a language id of 5 in the VPLUS
comarea , including Pascal,
FORTRAN/77 and HPBUSINESS BASIC, VPLUS uses the HEAP procedures for stack
allocation, so VPRINTSCREEN can be called in the standard format.
The programmer may implement this feature by defining a function key that allows the
user to print the screen contents at any time. This would be useful for providing immediate
output during production.
Modes of Operation
VPRINTSCREEN operates in two modes, normal and documentation mode. A VPLUS
supported terminal is required for execution of this intrinsic.
Normal Mode
This is the default calling mode for VPRINTSCREEN. When called, the value in the
printnumfile word of the comarea is used to determine the list device. If the calling
program opens the list file, it must supply the file number of this file in
printfilenum
VPRINTSCREEN opens the list file with the formal and actual file designator FORMLIST,
assigns it to the device class LP, and specifies its length as 80 characters. This is
equivalent to using the file equation:
:FILE FORMLIST;DEV=LP;REC=-80
The user may change any of these characteristics with a :FILE command.
NOTE It is recommended that VPRINTSCREEN and VPRINTFORM not be used in the
same program. Since the same list is used for both listings, output from the
two calls will be intermixed.
Each time VPRINTSCREEN is called, a PAGE EJECT is performed at the end of the print
operation.
Documentation Mode
You require TDP in order to use VPRINTSCREEN in this mode. VPRINTSCREEN, in conjunction
with TDP, provides the capability to print screen contents on a laser printer (HP2680A or
HP2688A). In this mode, field highlighting other than color, borders, alternate character
sets and active function keys are captured and converted to the requisite font for printing
on the laser printer.
Documentation mode is enabled by setting a JCW before running the program. It is:
:SETJCW VPRINTJCW=1
When VPRINTJCW is set to 1, the list file FORMLIST is NOT opened. Instead, a temporary file