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

Chapter 6 363
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
VUNLOADFORM
Unloads the specified form from local form storage memory.
Syntax
VUNLOADFORM { comarea,whichform }
Parameters
comarea Must be comarea name specified when the forms file was opened with
VOPENFORMF. If not already set, the following
comarea items must be set
before calling VUNLOADFORM:
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 in comarea .
VUNLOADFORM may set the following
comarea values:
cstatus Set to nonzero value if call unsuccessful.
whichform The name of the form to be removed from local form storage. Each name
can be up to 15 characters and is stored in a 16-byte character array with a
one byte filler that is not part of the name.
Discussion
This intrinsic is used on terminals having local form storage. VUNLOADFORM purges the
form named by the
whichform parameter from terminal local form storage memory. Note
that the terminal keyboard may be locked briefly while VUNLOADFORM verifies whether or
not the form was purged. In case keys are pressed during this time, the terminal beeps to
indicate that the keystrokes and/or entered data are lost. You can avoid this by not calling
VUNLOADFORM between calls to VSHOWFORM and VREADFIELDS.
Example
COBOL
77 WHICH-FORM PIC X(16).
:
MOVE "FORMA " TO WHICH-FORM.
CALL "VUNLOADFORM" USING COMAREA, WHICH-FORM.
BASIC
10 DIM W$[16]
20 W$="FORMA "
100 CALL VUNLOADFROM(C[*],W$)
FORTRAN
CHARACTER*16 WFORM
WFROM="FORMA "
CALL VUNLOADFORM(COMAREA,WFORM)