Convert Timestamp (CVTTS)


Op Code (Hex) Operand 1 Operand 2 Operand 3
043F Result timestamp Source timestamp Instruction template
Operand 1: Character variable scalar.

Operand 2: Character scalar.

Operand 3: Space pointer.

Bound program access
Built-in number for CVTTS is 106.
CVTTS (
       result_timestamp       : address
       source_timestamp       : address
       instruction_template   : address
)

Description

The timestamp specified in operand 2 is converted to another external or internal presentation and placed in operand 1. Operand 3 defines the data definitional attributes for operands 1 and 2.

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
Reserved (binary 0)
Char(2)
10 A
Operand 1 length
UBin(2)
12 C
Operand 2 length
UBin(2)
14 E
Reserved (binary 0)
Char(2)
16 10
Preferred/Found timestamp format
UBin(2)
18 12
Preferred/Found date separator
Char(1)
19 13
Preferred/Found time separator
Char(1)
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 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 and 2.

The DDATs for operands 1 and 2 must be valid for a timestamp. Otherwise, a template value invalid  (hex 3801) exception will be issued.

Operand 1 length and operand 2 length are specified in number of bytes.

If the data definitional attribute template numbers for operands 1 and 2 are the same, only data validation is performed. The validation will check for format and data value correctness.

A format of unknown date, time, or timestamp will indicate that operand 2 will be scanned for a valid format. For a list of formats that can be scanned, see Data Definitional Attribute Template. With an unknown format, the preferred/found timestamp format, preferred/found date separator, and preferred/found time separator can be specified to select an additional non-scanable format. The preferred format and preferred separators will be used first to find a matching format before scanning operand 2. When the preferred format and preferred separators have a hex value of zero, only the scan occurs.

When a format of unknown date, time, or timestamp is specified, the preferred/found timestamp format, preferred/found date separator, and preferred/found time separator fields will be set to the format and separators found.

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 2.

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 character operands will be defined by the templates. For a further description of the data definitional attribute template, see Data Definitional Attribute Template.

Authorization Required

Lock Enforcement

Exceptions

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