UTAB1 - Lower-to-Upper-Case Translation

#### Search Results

Search

# UTAB1 - Lower-to-Upper-Case Translation

This Natural profile parameter can be used to overwrite the definitions in the translation table `NTUTAB1` as contained in the configuration module `NATCONFG`.

Possible settings | See UTAB1 Parameter Syntax.
Default setting | As specified within the macro `NTUTAB1` in `NATCONFG`.
Dynamic specification | yes | This parameter can only be specified dynamically. In the Natural parameter module, the macro `NTUTAB1` is used instead.
Specification within session | no |

Notes:

1. `UTAB1` corresponds to the `NTUTAB1` macro in the Natural parameter module.
2. The `NTUTAB1` table is used for lower-to-upper-case translation.
3. If the `CP` profile parameter is set to a value other than `OFF`, values specified with `UTAB1` are ignored. See also Translation Tables in the Unicode and Code Page Support documentation.

The following topics are covered below:

- UTAB1 Parameter Syntax

- NTUTAB1 Macro Syntax

- Example of UTAB1 Parameter

- Example of NTUTAB1 Macro

## UTAB1 Parameter Syntax

The `UTAB1` parameter is specified as follows:

UTAB1=(a1,a2,b1,b2,c1,c2,...)

You specify pairs of characters, the first character of a pair being the character to be translated, the second character of a pair being the character into which the first character is to be translated.

You can specify each character either as the one-byte character itself (enclosed in apostrophes) or as the hexadecimal representation of that character.

With the `UTAB1` parameter, you must enclose the entire string of character pairs in parentheses; see Example of UTAB1 Parameter.

Or:

UTAB1=OFF

With `UTAB1=OFF` all (static and dynamic) definitions are reset to the values specified in the macro `NTUTAB1` in `NATCONFG`.

## NTUTAB1 Macro Syntax

The `NTUTAB1` macro is specified as follows:

             NTUTAB1 a1,a2,b1,b2,c1,c2,...

Notes:

1. For an explanation of the syntax elements, see UTAB1 Parameter Syntax. For an example, see Example of NTUTAB1 Macro.
2. The value `OFF` cannot be specified with the macro `NTUTAB1`, but only dynamically with the profile parameter `UTAB1`.

## Example of UTAB1 Parameter

    UTAB1=(5E,'Ä','ö',78,FF,00,'ü','Ü')

In this example, the character represented by `H'5E'` is translated into `'Ä'`, `'ö'` into the character represented by `H'78'`, the character represented by `H'FF'` into the character represented by `H'00'`, and `'ü'` into `'Ü'`.

## Example of NTUTAB1 Macro

             NTUTAB1 5E,'Ä','ö',78,FF,00,'ü','Ü'

In this example, the character represented by `H'5E'` is translated into `'Ä'`, `'ö'` into the character represented by `H'78'`, the character represented by `H'FF'` into the character represented by `H'00'`, and `'ü'` into `'Ü'`.

### On this page

- UTAB1 Parameter Syntax
- NTUTAB1 Macro Syntax
- Example of UTAB1 Parameter
- Example of NTUTAB1 Macro