HP Data Entry and Forms Management System (VPLUS) Reference Manual (32209-90024)
Chapter 6 331
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
VPUTBUFFER
Copies data from an application to the data buffer in memory.
Syntax
VPUTBUFFER {
comarea,buffer,buflen
}
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 VPUTBUFFER:
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
. Must be
at least 70 words in length if the ARB feature is used.
buffercontrol
Set bit 15 to 1 to indicate that data is to be transformed
according to the ARB specifications.
VPUTBUFFER may set the following
comarea
items:
cstatus
Set to nonzero value if call unsuccessful
numerrs
May be decremented as a result of new data replacing data
in field with error.
bufferstatus
Bit 15 set to 1 if data conversion is successful
buffer
Character string in a application containing the data to be copied to the
data buffer in memory.
buflen
Two-byte integer variable that specifies the number of bytes to be copied to
the data buffer in memory. The
comarea
item
dbuflen
, which contains the
size of the data buffer in memory, may be used as this parameter.
Discussion
This intrinsic transfers data from a buffer in an application to the data buffer in memory.
The length of the data moved is based on the number of bytes specified in the
buflen
parameter and the number of bytes in the largest data buffer in the forms file, whichever is
less. The length of the buffer assigned to the current form is not considered since the user
may intend the data for another form with a longer buffer length.
For example, assume there are three forms in the forms file:
• Form A
dbuflen
= 100 bytes
• Form B
dbuflen
= 200 bytes
• Form C
dbuflen
= 75 bytes
In this case, the maximum data buffer length is 200 bytes. If the current form is form A
and the user calls VPUTBUFFER with a user buffer length (
buflen
parameter) of 200, he
may intend to call VGETNEXTFORM to get form B and then VSHOWFORM to display form B with