HP 3000 Manuals HP 3000 Manuals
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 VUNLOADFORM(C[*],W$)
FORTRAN
CHARACTER*16 WFORM
WFROM="FORMA "
CALL VUNLOADFORM(COMAREA,WFORM)
SPL/PASCAL
BYTE ARRAY WHICH'FORM(0:15);
:
WHICH'FORM:="FORMA ";
VUNLOADFORM(COMAREA,WHICH'FORM);