Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (M)
Guardian Procedure Calls Reference Manual—522629-013
9-18
MBCS_EXTERNAL_TO_TANDEM_Procedure
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, the 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, the address points to
the byte following the last byte in the destination string.
source-length input
INT:value
is the length, in bytes, of the source text string.
maximum-length input, output
INT .EXT:ref:1
on input, is the maximum allowable number of bytes of space in the output
destination string.
When the
source-length, maximum-length, and external-form
parameters are supplied but other parameters are missing,
maximum-length
returns the maximum length required for a destination string.