Using a custom character table

You can create a custom character table file and then translate it to a custom character conversion file by using the Custom Character Table Translate command. The custom character table file is stored in the "GTABLE" file in the library where HULFT is installed. The custom character conversion file is stored in the "GTEXTD" file in the library where HULFT is installed.

Table 3.16 Custom character table files
Input Encoding	Output Encoding	Custom Character Table File	Custom Character Table Conversion File	Default Used When Undefined
IBM Kanji	EUC-JP	GTITOE	GTITOE	0xA2A2
IBM Kanji	Shift-JIS	GTITOS	GTITOS	0x81A0
IBM Kanji	JEF	GTITOJ	GTITOJ	0xA2A2
IBM Kanji	UTF-8	GTITO8	GTITO8	0xE296A1
EUC-JP	IBM Kanji	GTETOI	GTETOI	0x44E9
Shift-JIS	IBM Kanji	GTSTOI	GTSTOI	0x44E9
JEF	IBM Kanji	GTJTOI	GTJTOI	0x44E9
UTF-8	IBM Kanji	GT8TOI	GT8TOI	0x44E9
UTF-8	IBM Simplified Chinese	GT8TOC	GT8TOC	0x44E9
GB18030	IBM Simplified Chinese	GTGTOC	GTGTOC	0x44E9
IBM Simplified Chinese	UTF-8	GTCTO8	GTCTO8	0xE296A1
IBM Simplified Chinese	GB18030	GTCTOG	GTCTOG	0xA1F5

Custom Character Table Translate command

Program interface

CALL library name/UTLGTFEXTD PARM(['LIB=library name'] 
['I=IE|IS|IJ|I8|EI|SI|JI|8I|8C|GC|C8|CG|A']
['O=IE|IS|IJ|I8|EI|SI|JI|8I|8C|GC|C8|CG|A'] 
['P=filename'] ['G'] ['OUTPUT=filename']['EXIT' CL Variable name])

Parameter explanation

LIB=library name

Library name in which HULFT is installed (HULFT by default)

Specify this parameter in alphanumeric characters within 10 bytes starting with an alphabetic character.

I=IE|IS|IJ|I8|EI|SI|JI|8I|8C|GC|C8|CG|A

Type of translation to be executed (Optional)

You can omit this parameter only if you specify 'O=' parameter.

IE	:	Translate the custom character table for IBM Kanji to EUC-JP conversion
IS	:	Translate the custom character table for IBM Kanji to Shift-JIS conversion
IJ	:	Translate the custom character table for IBM Kanji to JEF conversion
I8	:	Translate the custom character table for IBM Kanji to UTF-8 conversion
EI	:	Translate the custom character table for EUC-JP to IBM Kanji conversion
SI	:	Translate the custom character table for Shift-JIS to IBM Kanji conversion
JI	:	Translate the custom character table for JEF to IBM Kanji conversion
8I	:	Translate the custom character table for UTF-8 to IBM Kanji conversion
8C	:	Translate the custom character table for UTF-8 to IBM Simplified Chinese conversion
GC	:	Translate the custom character table for GB18030 to IBM Simplified Chinese conversion
C8	:	Translate the custom character table for IBM Simplified Chinese to UTF-8 conversion
CG	:	Translate the custom character table for IBM Simplified Chinese to GB18030 conversion
A	:	Translate all custom character tables

O=IE|IS|IJ|I8|EI|SI|JI|8I|8C|GC|C8|CG|A

Output the content of the custom character table conversion file (Optional)

You can omit this parameter only when you specify 'I=' parameter.

If you specify 'P=' parameter, the contents are output to the specified file, while if it is not specified, they are output to the standard output.

IE	:	Output the content of the custom character table for IBM Kanji to EUC-JP conversion
IS	:	Output the content of the custom character table for IBM Kanji to Shift-JIS conversion
IJ	:	Output the content of the custom character table for IBM Kanji to JEF conversion
I8	:	Output the content of the custom character table for IBM Kanji to UTF-8 conversion
EI	:	Output the content of the custom character table for EUC-JP to IBM Kanji conversion
SI	:	Output the content of the custom character table for Shift-JIS to IBM Kanji conversion
JI	:	Output the content of the custom character table for JEF to IBM Kanji conversion
8I	:	Output the content of the custom character table for UTF-8 to IBM Kanji conversion
8C	:	Output the content of the custom character table for UTF-8 to IBM Simplified Chinese conversion
GC	:	Output the content of the custom character table for GB18030 to IBM Simplified Chinese conversion
C8	:	Output the content of the custom character table for IBM Simplified Chinese to UTF-8 conversion
CG	:	Output the content of the custom character table for IBM Simplified Chinese to GB18030 conversion
A	:	Output the contents of all custom character tables

P=filename

Output destination of the content of the registered custom character table (Optional)

Specify this parameter in the format of 'Library name/File name(Member name).'

You can specify this parameter only if you specify 'O=' parameter.

As the output format is the same as the custom character table file (fixed filename), if the contents output in the file are copied or renamed, etc., and reflected in the custom character table file, they can be used as they are.

G

Control of error messages (Optional)

When omitted, HULFT displays error messages.

OUTPUT=filename

Destination of the error messages (Optional)

Specify this parameter in the format of 'Library name/File name(Member name).'

When omitted, error messages are not output.

The number of log records that a log file can retain is unlimited.

EXIT CL Variable name

Receiving of an error code and CL Variable name (Optional)

The CL Variable name must immediately follow EXIT tag.

When omitted, an error code is not set.

Command interface

UTLGTFEXTD INPUT( ) OUTPUT( ) PFILE( ) PMBR( ) 
   LIBRARY( ) MSG( ) FILE( ) MBR( )

Parameter explanation

INPUT

Type of translation to be executed (*NO by default)

You can select *NO only if you specify the OUTPUT parameter.

*NO	:	Translate no custom character table
IE	:	Translate the custom character table for IBM Kanji to EUC-JP conversion
IS	:	Translate the custom character table for IBM Kanji to Shift-JIS conversion
IJ	:	Translate the custom character table for IBM Kanji to JEF conversion
I8	:	Translate the custom character table for IBM Kanji to UTF-8 conversion
EI	:	Translate the custom character table for EUC-JP to IBM Kanji conversion
SI	:	Translate the custom character table for Shift-JIS to IBM Kanji conversion
JI	:	Translate the custom character table for JEF to IBM Kanji conversion
8I	:	Translate the custom character table for UTF-8 to IBM Kanji conversion
8C	:	Translate the custom character table for UTF-8 to IBM Simplified Chinese conversion
GC	:	Translate the custom character table for GB18030 to IBM Simplified Chinese conversion
C8	:	Translate the custom character table for IBM Simplified Chinese to UTF-8 conversion
CG	:	Translate the custom character table for IBM Simplified Chinese to GB18030 conversion
A	:	Translate all custom character tables

OUTPUT

Outputs the content of the custom character table conversion file (*NO by default)

You can select *NO only if you specify the INPUT parameter.

If you specify the PFILE parameter, the contents are output to the specified file, while if it is not specified, they are output to standard output.

*NO	:	Do not output any content
IE	:	Output the content of the custom character table for IBM Kanji to EUC-JP conversion
IS	:	Output the content of the custom character table for IBM Kanji to Shift-JIS conversion
IJ	:	Output the content of the custom character table for IBM Kanji to JEF conversion
I8	:	Output the content of the custom character table for IBM Kanji to UTF-8 conversion
EI	:	Output the content of the custom character table for EUC-JP to IBM Kanji conversion
SI	:	Output the content of the custom character table for Shift-JIS to IBM Kanji conversion
JI	:	Output the content of the custom character table for JEF to IBM Kanji conversion
8I	:	Output the content of the custom character table for UTF-8 to IBM Kanji conversion
8C	:	Output the content of the custom character table for UTF-8 to IBM Simplified Chinese conversion
GC	:	Output the content of the custom character table for GB18030 to IBM Simplified Chinese conversion
C8	:	Output the content of the custom character table for IBM Simplified Chinese to UTF-8 conversion
CG	:	Output the content of the custom character table for IBM Simplified Chinese to GB18030 conversion
A	:	Output the contents of all custom character tables

PFILE

Library name and file name of the output file (Optional)

Specify this parameter in the format of 'Library name/File name.'

Specify these names in alphanumeric characters within 10 bytes starting with an alphabetic character, respectively.

PMBR

Member name of the file to which the table is output (*FILE by default)

Specify this parameter in alphanumeric characters within 10 bytes starting with an alphabetic character.

LIBRARY

Library name in which HULFT is installed (HULFT by default)

Specify this parameter in alphanumeric characters within 10 bytes starting with an alphabetic character.

MSG

Control of error messages (*YES by default)

*NO :: Suppress error messages.
*YES :: Show error messages.

FILE

Name of the library and the file to which error messages are output (Optional)

Specify this parameter in the format of 'Library name/File name.'

Specify these names in alphanumeric characters within 10 bytes starting with an alphabetic character, respectively.

When omitted, error messages are not output. The number of log records that a log file can retain is unlimited.

MBR

Member name of the file to which error messages are output (*FILE by default)

Specify this parameter in alphanumeric characters within 10 bytes starting with an alphabetic character.