HP 3000 Manuals

VSETLANG [ HP Data Entry and Forms Management System (VPLUS/V) ] MPE/iX 5.0 Documentation


HP Data Entry and Forms Management System (VPLUS/V)

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/V.

errorcode        Two-byte integer to which the error code is returned.

Discussion 

This intrinsic sets the native language to be used by VPLUS/V 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)



MPE/iX 5.0 Documentation