CODEPAGE_TO_CCSID_MAP - UDM Manager configuration option

Owned by Stonebranch (Deactivated)
Jan 31, 2024
2 min read

Description


CAUTION!

This option is intended only for use by IBM i specialists who fully understand code pages, CCSIDs, how the two relate to each other, and how IBM i uses CCSIDs for data translation between data streams and files. If a code page and CCSID are not correctly matched, data corruption will occur.


The CODEPAGE_TO_CCSID_MAP option specifies whether to use the internal table or external table for code page to CCSID mapping.

An internal table provides code page to CCSID mapping for the code page specified by the open command. The mapping only occurs if the CCSID is required for text file mapping. For the LIB file system, this includes mapping text to source physical files or to data files with an associated DDS file. All files in the root and QOpenSys file systems have associated CCSIDs.

This CCSID is not the same as the CCSID attribute associated with the attrib command; the UDM CCSID attribute determines the CCSID of the target file if the file does not exist. This CCSID in the mapping table is used as the CCSID associated with the attrib command when the default value, CODEPAGE, is specified; it also identifies the data stream CCSID, allowing the operating system to translate the code page translated data stream to the file. However, data written to or read from a file, record, or field with a CCSID of 65535 (or 'HEX') will not be translated.

The code page (and the mapped CCSID) from the open command is used for data mapping between the two parties involved in a data transfer. For IBM i, the code page also is used for mapping the data stream to or from the IBM i file, whether a LIB or HFS transfer.

Under normal circumstances, the external mapping table will not be needed. This external table replaces the internal table, so all potentially needed code page to CCSID mappings must be provided in the external table.

Universal Agent for IBM i provides an example external table in file CP2CCSID_X, in product library UNVPRD510. For UDM to use the external table, create a single member file with the name CDPG2CCSID in the installation library. The example file may be used as a template by copying it to CDPG2CCSID in the same library.

Usage

Method

Syntax

IBM i

UNIX

Windows

z/OS

Command Line, Short Form

n/a





Command Line, Long Form

n/a





Environment Variable

n/a





Configuration File Keyword

codepage_to_ccsid_map_opt table

(tick)




STRUDM Parameter

n/a





Value

table is the specification for which table to use:

  • error
    Use the external table; if it is not found, report an error.
  • quiet
    Use the external table; if it is not found, use the internal table. No message is issued.
  • internal
    Use the internal table.

Default is internal.