Op Code (Hex) | Operand 1 | Operand 2 | Operand 3 | Operand 4 |
---|---|---|---|---|
042C | Result timestamp | Source timestamp | Duration | Instruction template |
Operand 2: Character scalar.
Operand 3: Packed decimal scalar.
Operand 4: Space pointer.
Bound program access |
---|
|
The timestamp specified by operand 2 is decremented by the date, time, or timestamp duration specified by operand 3. The resulting timestamp is placed in operand 1. Operand 4 defines the data definitional attributes for operands 1 through 3.
The following describes the instruction template.
Offset | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Dec | Hex |
| Field Name |
| Data Type and Length | ||||||||
0 | 0 |
| Instruction template |
| Char(*) | ||||||||
0 | 0 |
| Instruction template size |
| Bin(4) | ||||||||
4 | 4 |
| Operand 1 data definitional attribute template number |
| UBin(2) | ||||||||
6 | 6 |
| Operand 2 data definitional attribute template number |
| UBin(2) | ||||||||
8 | 8 |
| Operand 3 data definitional attribute template number |
| UBin(2) | ||||||||
10 | A |
| Operand 1 length |
| UBin(2) | ||||||||
12 | C |
| Operand 2 length |
| UBin(2) | ||||||||
14 | E |
| Operand 3 length |
| UBin(2) | ||||||||
14 | E |
| Fractional number of digits |
| Char(1) | ||||||||
15 | F |
| Total number of digits |
| Char(1) | ||||||||
16 | 10 |
| Input indicators |
| Char(2) | ||||||||
16 | 10 |
| End of month adjustment |
| Bit 0 | ||||||||
|
|
|
| ||||||||||
16 | 10 |
| Tolerate data decimal errors |
| Bit 1 | ||||||||
|
|
|
| ||||||||||
16 | 10 |
| Reserved (binary 0) |
| Bits 2-15 | ||||||||
18 | 12 |
| Output indicators |
| Char(2) | ||||||||
18 | 12 |
| End of month adjustment |
| Bit 0 | ||||||||
|
|
|
| ||||||||||
18 | 12 |
| Reserved (binary 0) |
| Bits 1-15 | ||||||||
20 | 14 |
| Reserved (binary 0) |
| Char(22) | ||||||||
42 | 2A |
| Data definitional attribute template list |
| Char(*) | ||||||||
42 | 2A |
| Size of the DDAT list |
| UBin(4) | ||||||||
46 | 2E |
| Number of DDATs |
| UBin(2) | ||||||||
48 | 30 |
| Reserved (binary 0) |
| Char(10) | ||||||||
58 | 3A |
| DDAT offset |
| [*] UBin(4) | ||||||||
* | * |
| Data definitional attribute template |
| [*] Char(*) | ||||||||
* | * |
| --- End --- |
|
|
A data definitional attribute template (DDAT) number is a number that corresponds to the relative position of a template in the data definitional attribute template list. For example, the number 1 references the first template. The valid values for this field are 1, 2, and 3.
The DDATs for operands 1 and 2 must be valid for a timestamp and identical. The DDAT for operand 3 must be valid for a timestamp duration. Otherwise, a template value invalid (hex 3801) exception will be issued.
Operand 1 length, operand 2 length, and operand 3 length are specified in number of bytes.
The input indicator, end of month adjustment, is used to allow or disallow the occurrence of an end of month adjustment.
The input indicator, tolerate data decimal errors, is used to determine whether errors found in the packed data for the duration will generate exceptions or will be ignored. When the errors are to be tolerated, the following rules will apply:
The output indicator, end of month adjustment, is used to indicate an end of month adjustment, when end of month adjustments are allowed.
End of month adjustment is the following concept. For SAA®, the result of subtracting a 1 month duration from the date 03/31/1989 is 02/28/1989. The days portion is adjusted to fit the month, 31 is changed to 28. When this happens, the end of month adjustment output indicator is set to adjustment.
When end of month adjustments are not allowed, the month and year definitions in the data definition attribute template must have values greater than zero, otherwise a template value invalid (hex 3801) exception will be signaled. The result of subtracting a 1 month duration from the Gregorian date 03/31/1989 is 03/01/1989, when the definition of a month is 30 days.
The size of the DDAT list is specified in bytes.
The number of DDATs is the count of DDATs specified for this instruction template. The maximum number of DDATs that can be specified is 3.
The DDAT offset is the number of bytes from the start of the DDAT list to the start of the specific DDAT. There should be as many DDAT offsets as there are DDATs specified.
A data definitional attribute template defines the presentation of the data. Each template describes the definitional attributes of the operands. The length of the timestamp and duration character operands will be defined by the template. For a further description of the data definitional attribute template, see Data Definitional Attribute Template.
06 Addressing
08 Argument/Parameter
0C Computation
10 Damage Encountered
20 Machine Support
22 Object Access
24 Pointer Specification
2E Resource Control Limit
32 Scalar Specification
36 Space Management
38 Template Specification
44 Protection Violation