source_replace_single_byte_charset_characters
This system parameter replaces matching characters in all columns of all tables. It is similar to %REPLACE, but applies to all in-scope source tables.
- Applies to
- Source datastores
- Values
- Set this parameter to a string value with one or more replacement specifications. Each
specification includes a single-byte IANA character set name, an ampersand (&), then a
comma-separated list of mappings. Each mapping specifies the original single‑byte hex code point and
its corresponding replacement hex code point, separated by a colon (
:). This format allows you to indicate which byte values in a given character set must be replaced with alternative values, ensuring proper handling of character substitutions during processing. Separate each replacement specification from the next with a semicolon. - Syntax
-
/replacementSpecification/[;/replacementSpecification/...] /replacementSpecification/ ::= IANACharacterSetName&/replacementCharSpecSet/ /replacementCharSpecSet/ ::= /replacementCharSpec/[,/replacementCharSpec/...] /replacementCharSpec/ ::= origHexCodePoint:replacementHexCodePointFor this system parameter to function correctly, these conditions must be met in order:- Specify one or more replacement specifications, separated by a semi-colon.
- Specify one or more replacement character specifications, separated by a comma.
- Trim and ignore any white space in the specification, except inside a replacementCharSpec, and ignore spaces between hex code point digits or between the hex code points and the separating colon.
- Specify a semi-colon only at the end of a character set replacement specification if there is a subsequent character set replacement specification. CDC Replication ignores any trailing semi-colon.
- Specify a comma only at the end of a replacement character specification if there is a subsequent replacement character specification. CDC Replication ignores any trailing comma.
- Provide the IANACharacterSetName as the exact IANA encoding name for that character set. CDC Replication ignores case while validating that the character set name exists and is a single‑byte character set.
- Specify origHexCodePoint and replacementHexCodePoint as exactly 2 hex characters long. The origHexCodePoint is the hex code for a character to replace in the specified character set and replacementHexCodePoint is the hex code for the substitute character in the specified character set.
For example,IBM037&00:40,0D:40,15:40;IBM1047&00:40,0D:40,15:40For this example, CDC Replication works as follows:- For the single‑byte EBCDIC character set IBM037:
- Replace the NULL character with a space (blank).
- Replace CR (carriage return) with a space.
- Replace LF (line feed) with a space.
- For the single‑byte EBCDIC character set IBM1047:
- Replace the NULL character with a space (blank).
- Replace CR with a space.
- Replace LF with a space.
- Default Setting
- null