MPE/iX Intrinsics Reference Manual (32650-90875)

88 Chapter4
Command Definitions (ABORTSESS - FCLOSE)
CTRANSLATE
CTRANSLATE
NM and CM callable.
Converts a string of characters between EBCDIC and ASCII, or between EBCDIK
(HP-specific version of EBCDIC) and KANA8 (8-bit, Japanese International Standard
(JIS) version of USASCII code).
Syntax
I16V CA CA
CTRANSLATE(
transcode,inbuffer,outbuffer,
I16V CA
bufferlength , transtable );
Parameters
transcode 16-bit signed integer by value (required)
Passes one of the following translation identifiers:
VaIue Meaning
0 User-supplied table specified in the
transtable parameter
1 Convert EBCDIC to ASCII
2 Convert ASCII to EBCDIC
3 Reserved for operating system
4 Reserved for operating system
5 Convert EBCDIK to KANA8 (JIS)
6 Convert KANA8 (JIS) to EBCDIK
inbuffer character array (required)
Passes the string of characters to be translated.
outbuffer character array (optional)
Passes the translated character string. If an
outbuffer parameter is not
specified, all translation occurs within
inbuffer . The inbuffer and
outbuffer parameters can specify the same array.
bufferlength 16-bit signed integer by value (required)
Passes the number of characters to be converted.
transtable character array (required when transcode =0, otherwise optional)
Passes the user-defined translation table. The contents and order of
transtable define the translation process. Transtable must be <= 256
bytes.
Transtable is constructed so that each byte corresponds to a byte
value in the source string to be translated. For example, the first byte in