Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (M)
Guardian Procedure Calls Reference Manual—522629-013
9-44
MBCS_TANDEM_TO_EXTERNAL_ Procedure
The twelve low-order bits of this parameter (external-form.<4:15>) have the
following meaning:
•
IBM external formats
•
Data stream without substring frames
0 IBM Kanji only
•
Data stream using SO/SI substring frames
1 IBM Kanji EBCDIC
2 IBM Kanji/Katakana-EBCDIC
•
Data stream using character attribute substring framing
(IBM 3270 data stream only)
11 IBM Kanji EBCDIC
12 IBM Kanji/Katakana-EBCDIC
•
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 part of the destination string containing data which
was successfully translated. When this parameter is missing, the translate function
attempts to return an estimate of the space required for the destination string.
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 destination 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