Concatenate (CAT)


Op Code (Hex) Operand 1 Operand 2 Operand 3
10F3 Receiver Source 1 Source 2

Operand 1: Character variable scalar.

Operand 2: Character scalar.

Operand 3: Character scalar.

Description  The character string value of the second source operand is joined to the right end of the character string value of the first source operand. The resulting string value is placed (left-adjusted) in the receiver operand.

The length of the operation is equal to the length of the receiver operand with the resulting string truncated or is logically padded on the right end accordingly. The pad value for this instruction is hex 40.

Substring operand references that allow for a null substring reference (a length value of zero) may be specified for operands 1, 2, and 3. The effect of specifying a null substring reference for one source operand is that the other source operand is used as the result of the concatenation. The effect of specifying a null substring reference for both source operands is that the bytes of the receiver are each set with a value of hex 40. The effect of specifying a null substring reference for the receiver is that a result is not set regardless of the value of the source operands.

Authorization Required

Lock Enforcement

Exceptions

06 Addressing

08 Argument/Parameter

10 Damage Encountered

1C Machine-Dependent

20 Machine Support

22 Object Access

24 Pointer Specification

2E Resource Control Limit

36 Space Management

44 Protection Violation