Guardian Procedure Calls Reference Manual

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.
While all formal parameters (except shift-to-MBCS and shift-to-one-byte) are
mandatory for string translation, specifying only the source-length, maximum-length,
and external-form parameters (omitting all other parameters), returns the maximum length
required for the destination string, without any string translation.
intermediate
input
INT:value
is a logical flag indicating the optional forms of the source data string.
For translations from an EBCDIC type of data format, this parameter is interpreted as follows:
• When TRUE, the source text string is in an intermediate form which must be further
processed to yield the correct ASCII/JIS format for one-byte characters. An example of
this is data from IBM Katakana devices which has already been through the HP "universal"
EBCDIC/ASCII conversion.
• When FALSE, the source data string is still in EBCDIC format. It has not been through the
HP universal EBCDIC/ASCII conversion.
For translations from a format containing JIS standard Kanji and a JIS or ASCII-like one-byte
character set, this parameter is interpreted as follows:
• When TRUE, the source text stream is in shift-in/ shift-out (SI/SO) format. Conversion of
the source text stream begins in shift-in state. ASCII SI/SO characters that frame data
character sub-strings are removed and each byte whose byte value is greater than octal
40, in the SI/SO framed substrings, has the high-order bit turned on.
• When FALSE, the source text stream is in eight-bit data format. SI/SO processing is not
done.
798 Guardian Procedure Calls (M)