Guardian Procedure Calls Reference Manual

screen-start-col
input, output
INT .EXT:ref:1
on input, contains the starting column on the current line of the screen where the first displayable
data character may appear.
On output, contains an integer which represents the sum of the screen-start-col and the
displayable length of the data inserted into the field by the translate function.
shift-to-MBCS
input
STRING .EXT:ref:*
is an optional pointer to a string containing the escape, control, or other string to be used to
indicate a shift to a multibyte character set in the destination text string. This string must always
be in HP internal format (not EBCDIC), regardless of the final form of the destination string.
When not supplied, a default string is used by the format routine (for Fujitsu terminals, it is
[%H88, null]).
shift-to-one-byte
input
STRING .EXT:ref:*
is an optional pointer to a string containing the escape, control, or other string to be used to
indicate a shift to a one-byte character set in the destination text string. This string must always
be in HP internal format (not EBCDIC), regardless of the final form of the destination string.
When not supplied, a default string is used by the format routine (for Fujitsu terminals, it is
[%H89, null]).
startmode
input
INT:value
specifies the optional start mode of the formatting operation. When this parameter has a value
of 1, the formatting operation begins in the one-byte mode. When this parameter has a value
of 2, the formatting operation begins in the two-byte (MBCS) mode. If any other value is
specified, or if this parameter is not used, the starting mode is determined from the source
string content. This parameter can be used to force a start in MBCS mode for a string that
begins with double spaces. This is the only known ambiguous condition that might require the
use of this parameter.
Returned Value
INT
Procedure error code:
Successful completion of the translation.0
Source string translation incomplete, ran out of destination buffer area or ran out of space in the screen field.-1
Unknown terminal type specified.-2
Invalid source string length.-3
Invalid character in Kanji-only source string.-4
Control string parameter too long.-5
Required parameter missing.29
Considerations
Determining the size of the destination buffer is the responsibility of the calling procedure.
804 Guardian Procedure Calls (M)