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

Appendix L 675
A Programmer’s Guide to VPLUS
VPRINTSCREEN Intrinsic
VPRINTSCREEN
VPRINTSCREEN records the contents of the current screen to an off-line list device. A
documentation option allows formatting for printing to a laser printer (See Modes of
Operation). A VPLUS supported terminal is required during execution. TDP is required
for the laser printer output.
VPRINTSCREEN {COMAREA, READSIZE}
Parameters
COMAREA The following COMAREA items must be set before calling VPRINTSCREEN
(unless previously set):
CSTATUS Set to zero.
COMAREALEN Set to the total number of 2-byte words in COMAREA.
PRINTFILENUM Set to the file number of the list file to which form is
printed. If set to 0, VPRINTSCREEN opens the device “LP”
as the list file, and sets PRINTFILENUM to the file number
of the opened list file.
VPRINTSCREEN may set the following COMAREA values:
PRINTFILENUM If VPRINTSCREEN opened the list file, set to the file
number of the opened file.
CSTATUS Set to a nonzero value if call is unsuccessful.
FILEERRNUM Set to the MPE error code if an MPE file error is
encountered.
READSIZE 2-byte INTEGER. Reserved for system use; must be 0.
A possible implementation of this feature would be to define a function key which is
available to the user for printing the screen contents in any transaction. This feature
would be useful for providing immediate output of documents and data during production.
This new intrinsic is demonstrated with the program VPRTDEMO. See the section titled
“Viewing the VPRINTSCREEN Demo” in this note for directions on obtaining the demo.
Modes of Operation
VPRINTSCREEN operates in two modes; normal and documentation. Both of these modes are
discussed in detail below.
Normal Mode
This is the default calling mode of VPRINTSCREEN. When called, the value is the
PRINTFILNUM 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 PRINTFILNUM.
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