Op Code (Hex) | Operand 1 | Operand 2 | Operand 3 | |
---|---|---|---|---|
10A3 | Receiver | Source | Attributes |
Operand 2: Numeric scalar or data-pointer-defined numeric scalar.
Operand 3: Character(7) scalar or data-pointer-defined character(7) scalar.
The source numeric value (operand 2) is converted and copied to the receiver character string (operand 1). The receiver operand is treated as though it had the attributes supplied by operand 3. Operand 1, when viewed in this manner, receives the numeric value of operand 2 following the rules of the Copy Numeric Value (CPYNV) instruction.
The format of operand 3 is as follows:
Offset | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Dec | Hex |
| Field Name |
| Data Type and Length | ||||||||||||||||||
0 | 0 |
| Scalar attributes |
| Char(7) | ||||||||||||||||||
0 | 0 |
| Scalar type |
| Char(1) | ||||||||||||||||||
|
|
|
| ||||||||||||||||||||
1 | 1 |
| Scalar length |
| Bin(2) | ||||||||||||||||||
|
|
|
| ||||||||||||||||||||
|
|
|
If binary:
| ||||||||||||||||||||
1 | 1 |
| Length (L) (where L = 2 or 4) |
| Bits 0-15 | ||||||||||||||||||
|
|
|
If floating-point:
| ||||||||||||||||||||
1 | 1 |
| Length (where L = 4 or 8) |
| Bits 0-15 | ||||||||||||||||||
|
|
|
If zoned decimal or packed
decimal:
| ||||||||||||||||||||
1 | 1 |
| Fractional digits (F) |
| Bits 0-7 | ||||||||||||||||||
1 | 1 |
| Total digits (T) |
| Bits 8-15 | ||||||||||||||||||
|
|
|
(where
1 <= T <= 63
and 0 <= F <= T)
| ||||||||||||||||||||
3 | 3 |
| Reserved (binary 0) |
| Bin(4) | ||||||||||||||||||
|
|
|
| ||||||||||||||||||||
7 | 7 |
| --- End --- |
|
|
The byte length of operand 1 must be large enough to contain the numeric value described by operand 3. If it is not large enough, a scalar value invalid (hex 3203) exception is signaled. If it is larger than needed, the numeric value is placed in the leftmost bytes and the unneeded rightmost bytes are unchanged by the instruction.
If a decimal to binary conversion causes a size (hex 0C0A) exception to be signaled, the binary value contains the correct truncated result only if the decimal value contains 15 or fewer significant nonfractional digits.
06 Addressing
08 Argument/Parameter
0C Computation
10 Damage Encountered
1C Machine-Dependent
20 Machine Support
22 Object Access
24 Pointer Specification
2E Resource Control Limit
32 Scalar Specification
36 Space Management
44 Protection Violation