Guardian Procedure Calls Reference Manual

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 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 one 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:
[%H0E,null]IBM Kanji
[%H88,null]JEF (Fujitsu) Kanjis
[%H1B, %H24,%H42,null]JIS X0208 Kanji
When the control string values are not user-supplied, the default values used for control strings
expressed in the alternative format are as follows:
[null, %H03, %H88, %HA2, %H38]IBM Kanji character attribute
MBCS_TANDEM_TO_EXTERNAL_ Procedure 819