Communicator 3000 MPE/iX Release 6.0 (Platform Software Release C.60.00) (30216-90269)

Chapter 10 183
Technical Articles
Year 2000 and Other Enhancements in VPLUS
Intrinsic VPUTYYYYMMDD
Converts a numeric value representing a date from an application and
copies the converted value to a field in the data buffer in memory.
Syntax
VPUTYYYYMMDD {comarea,fieldnum,variable}
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
VPUTYYYYMMDD:
cstatus set to zero.
comarealen set to total number of two-byte words in
comarea. Must be at least 70 words in
length.
VGETYYYYMMDD may set the following comarea item:
cstatus set to nonzero value if call is
unsuccessful or requested field has an
error.
numerrs may be decremented if the new value
replaces the value of a field with an
error.
fieldnum is a two-byte integer variable which specifies the
number assigned to the field by FORMSPEC.
variable is a character string in the application which contains
the value to be converted.
Discussion
VPUTYYYYMMDD converts the contents of the application variable to the
date order of the field specified by fieldnum and copies the converted
value into the corresponding field in the data buffer, right justified. The
application variable should contain a numeric value in YYYYMMDD
format. The YYYYMMDD format is an 8-byte ASCII value, for example,
19961225. If errors occur during conversion, cstatus is set to an error
code.
Refer to the VPUTtype intrinsic description in the Data Entry and
Forms Management System VPLUS Reference Manual for related
information.