Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (M)
Guardian Procedure Calls Reference Manual—522629-013
9-42
MBCS_TANDEM_TO_EXTERNAL_ Procedure
Syntax for TAL Programmers
Parameters
error-code returned value
INT
returns a procedure error code. Possible error codes are:
0 Successful completion of the translation
-1 Translation truncated due to lack of destination buffer space
-2 Unknown translation requested
-3 Invalid source string length
-4 Invalid character in Kanji-only source string
-5 Control string parameter too long
29 Required parameter missing
source-string input, output
INT(32) .EXT:ref:1
is a pointer to a double-word integer containing the extended address of the source
text string to be translated. After translation, this address points to the byte
following the last byte in the source string that was successfully translated.
destination-string input, output
INT(32) .EXT:ref:1
is a pointer to a double-word integer containing the extended address of the
location to receive the translated text string. After translation, this address points
to the byte following the last byte in the destination string used by the translation
operation.
error-code := MBCS_TANDEM_TO_EXTERNAL_
( source-string ! i,o
,destination-string ! i,o
,source-length ! i
,maximum-length ! i,o
,intermediate ! i
,external-form ! i
,finished-length ! o
,[ shift-to-MBCS ] ! i
,[ shift-to-one-byte ] ); ! i