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

354 Chapter6
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
VSETLANG
The VSETLANG intrinsic specifies the native language to be used with an international
forms file. For more information on Native Language Support, see Section 8.
Syntax
VSETLANG { comarea,langnum,errorcode }
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 VSETLANG:
comarealen Set to the total number of two-byte words in comarea .
VSETLANG may set the following
comarea items:
cstatus Set to nonzero value if call is unsuccessful.
langnum A two-byte integer, passed by value , containing the native language ID
number of the forms file language to be used by VPLUS.
errorcode Two-byte integer to which the error code is returned.
Discussion
This intrinsic sets the native language to be used by VPLUS at run time for an
international forms file. The forms file must be opened before calling VSETLANG. Otherwise,
cstatus returns a nonzero value.
If VSETLANG is called to set the native language ID for a language-dependent or unlocalized
forms file, an error code of -1 will be returned to
errorcode . For international forms files,
both
cstatus and errorcode return a value of zero and the forms file is processed with the
native language ID specified in
langnum .
Example
COBOL
CALL "VSETLANG" USING COMAREA,\LANGNUM\,ERRORCODE
BASIC Pass by value parameters not supported.
FORTRAN
CALL VSETLANG (COMAREA,LANGNUM,ERRORCODE)
SPL/PASCAL
VSETLANG(COMAREA,LANGNUM,ERRORCODE)