Translate Bytes (XLATEB)

Built-in number for XLATEB is 24.
XLATEB (
        source_string      : address of aggregate(*)
        translate_table    : address of aggregate(256)
        translate_length   : unsigned binary(4) value which specifies the
                             length of the source string to translate
)

Description

Translates the data specified by source string. Translate length specifies the number of bytes to translate. Each byte of storage is modified with the corresponding entry in the translation table specified by translate table.

The translation table is exactly 256 bytes in length and specifies the translated values for the 256 possible byte values. The results are undefined if the table is less than 256 bytes.

The translate table and the source string should not overlap. Otherwise, the results are undefined.

Authorization Required

• None

Lock Enforcement

• None

Exceptions

06 Addressing

• 0601 Space Addressing Violation
• 0602 Boundary Alignment

24 Pointer Specification

• 2401 Pointer Does Not Exist

44 Protection Violation

• 4401 Object Domain or Hardware Storage Protection Violation
• 4402 Literal Values Cannot Be Changed