Guardian Procedure Calls Reference Manual

Returned Value
INT
Procedure error code:
Successful completion of the translation.0
Translation truncated due to lack of destination buffer space.-1
Unknown translation requested.-2
Invalid source string length.-3
Invalid character in Kanji-only source string.-4
Control string parameter too long.-5
Required parameter missing.29
Considerations
• All parameters except shift-to-MBCS and shift-to-one-byte are necessary for a
string translation operation.
• To determine the maximum length of the destination string, you must specify the
source-length, maximum-length, and external-form parameters. The other formal
parameters can be omitted if you want to determine only the maximum length of the destination
string, without performing any string translation. When performing string translation, if less
than this amount of space is allowed, the translation procedure might fail due to insufficient
space in the destination string.
• Any invalid two-byte character that is found in the source string is mapped to the value
%HFCFC. Any nondisplayable two-byte character that is found in the source string is mapped
to the value %HFCFB.
• The definition of nondisplayable and invalid characters varies with the target mapping format.
The IBM and Fujitsu character sets contain extensions that are not supported in the HP internal
character set. When extension character codes are encountered, they are mapped to the
nondisplayable character code for the HP character set.
The most common definition of an invalid character code is a character pair that is expected
to be a two-byte code but has an invalid first or second byte.
Any character mapped to either a nondisplayable or invalid character target code becomes
nonrecoverable for conversion to the original format.
MBCS_EXTERNAL_TO_TANDEM_ Procedure 801