Translate Bytes (XLATEB)

Instruction Syntax

Bound Program Access

Bound Program Access
`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 )`

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