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

Chapter 6 315
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
VOPENBATCH also resets the global environment (save fields and so forth) to the
environment existing when collection stopped. (All this information is derived from the file
labels preceding each file.)
New File
If the named file does not exist, VOPENBATCH creates a new file with the specified name and
sets
recnum and numrecs to zero. A new batch file created by VOPENBATCH has the following
characteristics:
Record Format
The size of the fixed-length batch file records must be large enough to hold the largest data
buffer used by the forms file associated with the batch file, plus 10 two-byte words for
batch record control information. If the largest data buffer is an even number of bytes, an
additional two-byte word is added before the control information. This batch record
information consists of:
2 bytes (logical) — Delete flag (TRUE if record deleted)
16 bytes (character) — Current form name + extra character
2 bytes (logical) — Data buffer length
Total = 20 bytes
The above batch record information is written at the end of each record in the batch file,
starting on a two-byte word boundary. To illustrate, assume the record size is 74 bytes, and
the data only requires 35 bytes (bytes are numbered from 1):
Labels
In addition, VOPENBATCH creates sufficient user labels (each 256 bytes long) to hold any
save field buffers, plus 176 bytes for the collection environment and the forms file version.
The length of the save field buffers depends on how many (if any) save fields were defined
for the form and the length of each. The collection environment consists of the forms file
name and version number, the next form name, and 122 bytes of system information. This
• Non-KSAM file
• USASCII coded data
• Fixed-length records
• No carriage control
•:FILE command allowed (use actual file
designator)
• Update access
• Exclusive (nonshared) access
• No dynamic locking
• No multirecord access
• Normal buffering
1 (bytes) 35 55 57 73 74
data
delflag dbuflencfname
undefined
two-byte word boundary
batch record info