Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (M)
Guardian Procedure Calls Reference Manual—522629-013
9-20
MBCS_EXTERNAL_TO_TANDEM_Procedure
•
JEF external formats
•
Data stream using KI/KO substring frames
3 JEF (Fujitsu) Kanji only
4 JEF (Fujitsu) Kanji EBCDIC
5 JEF (Fujitsu) Kanji/Katakana-EBCDIC
•
Other external formats
8 JIS X0208 Kanji/JIS X0201 (was C6226/C6220)
finished-length output
INT .EXT:ref:1
contains the byte count of the translated destination string upon successful
completion of the translation. For other cases, the value is undefined.
shift-to-MBCS input
STRING .EXT:ref:*
is an optional pointer to a string containing the escape or control string used to
indicate a shift to a multibyte character set in the source text string. This string
must always be in HP internal (not EBCDIC) character format, regardless of the
final form of the source string.
This procedure does not contain logic for identifying escape or control strings. The
control strings that are used are either the specified default control strings or user-
supplied alternative control strings. In earlier versions of this procedure, control
strings were null delimited. While null-delimited control strings are still supported,
an alternative format that supports control strings containing null bytes is now also
provided. The IBM Kanji character attribute (described following) is an example of
an alternative format.
The alternative format must be expressed as (null flag, count, string), where the
first byte is a null flag indicator of the alternative string form, the second byte
contains an integer value representing the length of the control string, and the third
and subsequent bytes represent the value of the control string.
The minimum length for a control string is 1 byte, and the maximum length is 20
bytes. If the procedure receives a zero-length control string, the results are
undefined.
When the control string values are not user-supplied, the default values used for
control strings expressed in the original null-delimited format are as follows:
IBM Kanji [%H0E,null]
JEF (Fujitsu) Kanji [%H88,null]
JIS X0208 Kanji [%H1B, %H24,%H42,null]