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

314 Chapter6
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
VOPENBATCH
Opens existing batch file for processing; or, if the specified file is new, creates a batch file
and then opens it for processing.
Syntax
VOPENBATCH { comarea,batchfile }
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 VOPENBATCH:
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 .
VOPENBATCH sets the following
comarea items:
nfname Set to the name of the form corresponding to the record
identified by
recnum .
recnum Set to zero if new file opened; to the next sequential record
number if existing file opened.
numrecs Set to zero if new file opened; to the number of nondeleted
records in file if existing file opened.
VOPENBATCH may set the following
comarea items:
cstatus Set to nonzero value if call unsuccessful.
filerrnum Set to file error code if MPE file error.
batchfile Character string of up to 36 characters (including a terminator) that
identifies the batch file being opened. Specified name can be any fully
qualified MPE file name.
Discussion
VOPENBATCH opens the specified batch file for processing by the calling program. The
batch file may be an existing file or a new file.
Existing File
If the named file already exists, VOPENBATCH initializes
recnum to the record number of the
next record in the file, and
numrecs to the total number of existing batch records. Thus, a
user resuming collection does not overwrite data collected into previous batch records.
VOPENBATCH sets
nfname to the name of the form associated with the batch record to be
collected. This record is identified by
recnum. VOPENBATCH keeps track of forms sequence
in order to associate a form with a record. For example, if a batch file is closed after record
6 of FORMA was collected, and FORMA is a repeating form, the batch file starts with
record 7 FORMA when it is next opened by VOPENBATCH.