Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (M)
Guardian Procedure Calls Reference Manual—522629-013
9-43
MBCS_TANDEM_TO_EXTERNAL_ Procedure
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.
intermediate input
INT:value
is an optional logical flag indicating the desired format of the translated data string.
For translations to an EBCDIC type of data format, this parameter is interpreted as
follows:
When TRUE, the translated destination text string is in an intermediate form
which yields the final EBCDIC data format after passing the HP standard
ASCII/EBCDIC translation routine.
When FALSE, the translated destination text string is in final EBCDIC format
upon completion of this procedure.
For translations to a format containing JIS standard Kanji and a JIS or ASCII-like 1-
byte character set, this parameter is interpreted as follows:
When TRUE, the translated data stream is in shift-in/ shift-out (SI/SO) format.
An initial ASCII SI or SO character is placed at the beginning of the destination
string, depending on the value of the first byte of translated text. ASCII SI/SO
characters frame data character sub-strings which represent byte values of
octal 240 or greater. The high-order bit of each byte in these sub-strings is set
off.
When FALSE, the translated data stream is in an eight-bit data format. SI/SO
characters are not inserted in the translated data text stream.
external-form input
INT:value
indicates the target format for the destination text translation. The four high-order
bits of this parameter (
external-form.<0:3>) are reserved for use by the Kanji
EM3270 product. For all other uses, the four high order bits must be set to null.