hdsccnvedt (edit a mapping table for converting character codes)

Function

The hdsccnvedt command edits a mapping table for converting character codes.

You use this command to change the Gaiji character conversion method. The hdsccnvedt command provides the following functions:

Updating the mapping table for converting character codes
The hdsccnvedt command changes the conversion method for Gaiji characters that are defined in the mapping table for converting character codes.
Referencing the mapping table for converting character codes
The hdsccnvedt command outputs the conversion method for the Gaiji characters that are defined in the mapping table for converting character codes. You can use this output for updating the mapping table for converting character codes.
Migrating a Gaiji character mapping file
The hdsccnvedt command imports into the mapping table for converting character codes a Gaiji character mapping file created with Datareplicator version 05-02 or earlier.

Format

Updating the mapping table for converting character codes

hdsccnvedt -w
           -f source-character-code-set
           -t target-character-code-set
           -d conversion-definition-filename

Referencing the mapping table for converting character codes

hdsccnvedt -r
           -f source-character-code-set
           -t target-character-code-set
           -o output-filename
         [ -s output-start-code ]
         [ -e output-end-code ]

Migrating a Gaiji character mapping file

hdsccnvedt -c
           -f source-character-code-set
           -t target-character-code-set
           -g Gaiji-character-mapping-filename

Options

-w: Specify this option to update the mapping table for converting character codes. This option enables you to change the character code correspondences in the range equivalent to Gaiji characters in the mapping table for converting character codes.

-r: Specify this option to reference the mapping table for converting character codes.

-c: Specify this option to migrate definitions from an existing Gaiji character mapping file into the mapping table for converting character codes. This option imports into the mapping table for converting character codes the contents of a Gaiji character mapping file created with Datareplicator version 05-02 or earlier.

-f source-character-code-set: Specify the mnemonic for the source character set:; eck78: EBCDIC/KEIS78; eck83: EBCDIC/KEIS83; ekk78: EBCDIK/KEIS78; ekk83: EBCDIK/KEIS83; sjis: JIS8/Shift JIS; euc: EUC; ucs2: UCS2^#; #: If the character code set is UTF-8, specify the UCS2 code set (UTF-8 is managed as the UCS2 code set in the Datareplicator mapping table; actual encoding from UCS2 to UTF-8 is executed during code conversion).

-t target-character-code-set

Specify the mnemonic for the target character set:

ekk83: EBCDIK/KEIS83

sjis: JIS8/Shift JIS

euc: EUC

ucs2: UCS2^#

#: If the character code set is UTF-8, specify the UCS2 code set (UTF-8 is managed as the UCS2 code set in the Datareplicator mapping table; actual encoding from UCS2 to UTF-8 is executed during code conversion).

The following table shows the permitted combinations of character code sets that can be specified in the -f and -t options:

-f option	-t option
-f option	eck78	eck83	ekk78	ekk83	sjis	euc	ucs2
eck78	N	N	N	N	Y	Y	Y
eck83	N	N	N	N	Y	Y	Y
ekk78	N	N	N	N	Y	Y	Y
ekk83	N	N	N	N	Y	Y	Y
sjis	Y	Y	Y	Y	N	Y	Y
euc	Y	Y	Y	Y	Y	N	Y
ucs2	N	N	N	N	Y	Y	N

Legend:: Y: Permitted; N: Not permitted (if specified, the KFRB04104-E message is displayed).

-d conversion-definition-filename: ~ <pathname of 1-127 characters>; Specify the name of the conversion definition file containing the update information for the mapping table for converting character codes, as an absolute or relative pathname. If you specify a relative pathname, Datareplicator assumes the current directory. For details about the definitions in the conversion definition file, see Format of conversion definition file below.

-o output-filename: ~ <pathname of 1-127 characters>; Specify the name of the file to which the mapping table for converting character codes referencing results are to be output, as an absolute or relative pathname. If you specify a relative pathname, Datareplicator assumes the current directory.; Datareplicator outputs the results of referencing the mapping table for converting character codes to the output file in ascending order of the source character codes in the same definition format as the conversion definition file. Datareplicator outputs only those codes for which target codes are defined.

-s output-start-code

This option is applicable only when the -r option is specified. It specifies as a hexadecimal character string the source character code with which referencing is to begin.

When this option is omitted, Datareplicator starts referencing at the beginning of the mapping table for converting character codes. You must specify an output start code according to the following rules:

Specify two characters for a one-byte code, four characters for a two-byte code, and six characters for a three-byte code (applicable when the source character set is EUC or EUC-HJ). Specifying any other number of characters will result in an error.
If you specify 3-byte EUC-HJ or EUC as the source character code set, make sure that the codes begin with 8f. Specifying any other character will result in an error.
This value must be smaller than the output end code value specified with the -e option. An error will result if this value is greater than the output end code value.

-e output-end-code

This option is applicable only when the -r option is specified. It specifies as a hexadecimal character string the source character code with which referencing is to end.

When this option is omitted, Datareplicator references through the end of the mapping table for converting character codes. You must specify an output end code according to the following rules:

Specify two characters for a one-byte code, four characters for a two-byte code, and six characters for a three-byte code (applicable when the source character set is EUC). Specifying any other number of characters will result in an error.
A three-byte code must begin with 8f. Specifying any other character will result in an error.
This value must be greater than the output start code value specified with the -s option. An error will result if this value is smaller than the output start code value.

-g Gaiji-character-mapping-filename: ~ <pathname of 1-127 characters>; Specify the name of the Gaiji character mapping file that is to be migrated, as an absolute or relative pathname. If you specify a relative pathname, Datareplicator assumes the current directory.

Format of conversion definition file

Specify in your conversion definition file in the following format each source character code in the mapping table for converting character codes that you want to update and its target character code:

conversion-source-character-code,conversion-target-character-code

When you create a conversion definition file, you must observe the following rules:

Define one entry per line.
Specify the conversion source and target character codes as hexadecimal character strings (a through f can be either uppercase or lowercase).
Begin a comment with the hash mark (#). To enter a comment on the same line as a conversion definition, you must specify at least one space or tab between the definition and the comment delimiter hash mark (#).
When you specify a character code, specify two characters for a one-byte code, four characters for a two-byte code, and six characters for a three-byte code (applicable when the source character set is EUC or EUC-HJ). Specifying any other number of characters will result in an error.
A three-byte code must begin with 8f. Specifying any other character will result in an error.
The first space character that follows the specification of the source character codes is ignored.
Datareplicator ignores any spaces or tabs before or after a character code.

Rules

The permitted range of Gaiji characters is as follows:
- KEIS codes: Byte 1 is from 41 to A0; byte 2 is from A1 to FE.
- Shift JIS codes: Byte 1 is from F0 to FC; byte 2 is from 40 to FC (excluding 7F).
- EUC: Byte 1 is 8F; byte 2 is from A1 to FE; byte 3 is from A1 to FE.
- UCS2: Byte 1 is from E0 to F8; byte 2 is from 00 to FF.
The superuser must execute this command.
If you specify the same option more than once, an option specification error results.
If you specify the same character set for both the conversion source and the target, an error results and the mapping table for converting character codes is not updated.
If an error occurs during the command's execution, the mapping table for converting character codes is not updated.
When the mapping table for converting character codes is updated, Datareplicator stores the new mapping table as a user-created mapping table for converting character codes in installation-directory/lib/usermap. Do not delete the mapping table for converting character codes. If there is no mapping table for converting character codes under installation-directory/lib/usermap, Datareplicator will convert Gaiji character codes according to its character code conversion rules. For details about Datareplicator's character code conversion rules, see 4.3.5 Designing for character code sets.
If you update the mapping table for converting character codes after starting data linkage and the character code conversion results for a mapping key do not match because of the updating, import processing will not execute correctly. Exercise caution in updating the mapping table for converting character codes after data linkage has started.

Table 7-11 shows the combinations of source and target character sets that you can specify for migrating a Gaiji character mapping file (-c option); specifying any other combination will result in an error:

Table 7-11 Combinations of source and target character sets that you can specify for migrating a Gaiji character mapping file (-c option)

Conversion source character set	Conversion target character set
EBCDIC/KEIS78 EBCDIC/KEIS83 EBCDIK/KEIS78 EBCDIK/KEIS83	JIS8/Shift JIS
JIS8/Shift JIS	EBCDIC/KEIS78 EBCDIC/KEIS83 EBCDIK/KEIS78 EBCDIK/KEIS83
JIS8/Shift JIS	EUC
EUC	JIS8/Shift JIS