Job Management Partner 1/Software Distribution Administrator's Guide Volume 1

[Contents][Glossary][Index][Back][Next]

9.1.4 Conversion rules for outputting CSV files in Unicode

You must determine conversion to Unicode for each host based on the host to code page mapping table and the locale to code page mapping table.

The following priority applies to the Unicode conversion rules:

Priority Conversion rule Description
1 Conversion based on the host to code page mapping table Conversion definitions in the host to code page mapping table apply to the hosts listed in that table.
2 Conversion based on the locale to code page mapping table Conversion definitions in the locale to code page mapping table apply to the hosts that are not listed in the host to code page mapping table.
3 Default Shift JIS is applied as the default encoding to the hosts that are not listed in the host to code page mapping table or in the locale to code page mapping table.

The following subsections describe the host to code page mapping table and the locale to code page mapping table.

Organization of this subsection
(1) Host to code page mapping table
(2) Locale to code page mapping table

(1) Host to code page mapping table

The host to code page mapping table is a text file that defines the correspondence between host ID and code page. This table enables you to define conversion rules for each client (host). You must create a host to code page mapping table if there is a client (host) for which conversion based on the locale to code page mapping table is not desired. For example, the system locale of a client (host) running an English-language OS is English even if Chinese-language software is installed on the client.

The following shows the format of the host to code page mapping table:

[Figure]host-ID[Figure]code-page[Figure]linefeed-code

Legend:
[Figure]: Single-byte space or tab

Notes
  • Enter a host ID in upper-case letters.
  • Each line must not exceed 1,024 bytes in length. If a line's length exceeds 1,024 bytes, an error results.
  • A line beginning with an asterisk (*) is treated as a comment line and is ignored.
  • A line consisting of only single-byte spaces and a tab or single-byte spaces and an end-of-line code is treated as a null line and is ignored.
  • For the code page, you must specify the correct value supported in Windows for the language corresponding to the locale ID.
  • If the same host ID is specified more than once, an error results.

Hitachi provides a default host to code page mapping table (hid-cp.ini). This default mapping table contains no valid lines. Edit the table as necessary. The host to code page mapping table is stored in the following directory:

JP1/Software-Distribution-installation-directory\COMMON\INV

The following shows the contents of the provided host to code page mapping table (default):

********************************************************************
*                  host id - code page list
********************************************************************
 
*#XXXXXXXXXXXXXXXXXXXXXXX                     1252

(2) Locale to code page mapping table

The locale to code page mapping table is a text file that defines the correspondence between locale ID and code page. This table enables you to define conversion rules for each locale ID. Note that conversion cannot be performed if the client's system information has not been acquired.

The following shows the format of the locale to code page mapping table:

[Figure]locale[Figure]code-page[Figure]linefeed-code

Legend:
[Figure]: Single-byte space or tab

Notes
  • Each line must not exceed 1,024 bytes in length. If a line's length exceeds 1,024 bytes, an error results.
  • A line beginning with an asterisk (*) is treated as a comment line and is ignored.
  • A line consisting of only single-byte spaces and a tab or single-byte spaces and an end-of-line code is treated as a null line and is ignored.
  • For code page, you must specify the correct value supported in Windows for the language corresponding to the locale ID.
  • If the same locale ID is specified more than once, an error results.

Hitachi provides a default locale to code page mapping table (lcid-cp.ini). Edit this table as necessary. The locale to code page mapping table is stored in the following directory:

JP1/Software-Distribution-installation-directory\COMMON\INV

The following shows the contents of the provided locale to code page mapping table (default):

********************************************************************
*                locale id - code page list
********************************************************************
 
*1033=English - United States               1252=Latin I
 1033                                       1252
*2057=English - United Kingdom              1252=Latin I
 2057                                       1252
                                            
*1041=Japanese                              932=Japanese Shift-JIS
 1041                                       932
                                            
*2052=Chinese - People's Republic of China  936=Simplified Chinese GBK
 2052                                       936
*4100=Chinese - Singapore                   936=Simplified Chinese GBK
 4100                                       936
                                            
*1028=Chinese - Taiwan                      950=Traditional Chinese Big5
 1028                                       950
*3076=Chinese - Hong Kong SAR               950=Traditional Chinese Big5
 3076                                       950
*5124=Chinese - Macao SAR                   950=Traditional Chinese Big5
 5124                                       950

In this case, Unicode conversion is performed based on locale ID 1041 and shift JIS as the client's (host) data.