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

Appendix J 629
HP PRECISION ARCHITECTURE
HPPA INTRINSICS
NOTE The field number is a unique number assigned to each field by FORMSPEC
and is completely independent of the field's position in the data buffer or the
form. It only changes if the batch command, RENUMBER, is used. You can alter
the length, position or other characteristics of a field without affecting the
field number. The field number provides a way to locate fields regardless of
their position.
VPUTIEEELONG
Writes a floating point number in IEEE standard long format from an application to a
specified field in the form data buffer, converting the value to character set coded external
representation.
Syntax
VPUTIEEELONG { comarea,fieldnum,variable }
Parameters comarea Must be the comarea name specified when the forms file was
opened with VOPENFORMMF. If not already set, the following
comarea items
must be set before calling VPUTIEEELONG:
cstatus Set to zero.
comarealen Set to total number of two-byte words in comarea .
VPUTIEEELONG may set the following
comarea items:
cstatus Set to nonzero value if call is unsuccessful.
numerrs May be decremented if a new value replaces the old value
of a field with an error.
fieldnum Two-byte integer variable containing the number assigned by FORMSPEC
to the field to which the value is written. The field itself may not be longer
than 80 characters.
variable Variable within application, of type IEEE floating point long (64 bits), that
contains the value to be converted to character set coded external
representation and copied to a field in the data buffer.
For example:
VPUTIEEELONG(COMAREA,FIELDNUM,VARIABLE);
Discussion This intrinsic converts an IEEE floating point long number to its character
coded form and writes the converted value to a particular field in the data buffer, right
justified. The exact format of the written data depends on the type of the destination field.
For example, if the number "34.56" were put to a field of type DIG, the result would be "34"
since such a field may contain only the digits 0 through 9. The destination field is
identified by the field number assigned by FORMSPEC, and must be defined as a numeric
field, that is, NUM,IMP or DIG.
If the specified field had an error, VPUTIEEELONG will clear the field's error flag and
decrement
nuerrs .