#### SUBCHAR

#### Synopsis

    HELP:   Default substitution character list (up to 8 code points)
    TYPE:   NUMBER
    SYNTAX: SUBCHAR[num/SYSTEM...]

#### Description

A substitution character (SUBCHR) is a list with up to 8 Unicode codepoints which are used for the substitution of invalid or incomplete characters if the corresponding codepoint is not defined in the substitution table (SUBTAB). Assigning the keyword SYSTEM is equivalent to value 0x1A.

If substitution is activated and no substatition character is defined, unsupported characters will be replaced with the codepoint 0x00001A.

SUBCHR results in replacement of every undefined code point in the substitution table. This is equivalent to using a USRTAB with corresponding SUBCHR values for every possible codepoint (000000-200000). If SUBCHR is used and no MODE is specified, the substitution mode is activated.

This conversion is pre-calculated once at the beginning of execution to reduce the required CPU time for the conversion.

#### Selections

- `SYSTEM - Use system specific substitution char (0x1A for ASCII/UTF, 0x3F for EBCDIC)`