LISTTOD subcommand — list TOD clock image

Use the LISTTOD subcommand to translate a hexadecimal GMT TOD clock value to the specified time stamp. The LISTTOD command supports three types of STCK or STCKE time stamps using the time-zone adjustments from your dump:

ABSOLUTE time stamps are produced by the STCK or STCKE instructions directly.
UTC time stamps are produced by adjusting the STCK or STCKE time stamps using a leap second adjustment factor maintained by the z/OS® timer services.
LOCAL time stamps are produced by adjusting the UTC time stamps using a time zone adjustment factor maintained by the z/OS timer services.

An INPUT option is now supported to allow the IPCS user to say which interpretation applies to the time stamp being entered, and LISTTOD now formats 26-character values corresponding to all three interpretations.

Use the INPUT option to specify the interpretation type for the time stamp. If you omit this option, the default value is ABSOLUTE. The system translates the TOD clock value to the time stamp as you specified, and it also formats other time stamps if the corresponding adjustment factors can be retrieved from the current dump. The first one to be displayed is for the specified option, and the other two are to be shown in the following order: ABSOLUTE, UTC, and LOCAL.

Syntax

  { LISTTOD|LTOD }(gmt-tod-value)[ EXTENDED ] 
                                 [ INPUT ({ ABSOLUTE | UTC | LOCAL })]

-------- SETDEF-Defined Parameters -------------------------
Note: You can override the following SETDEF parameters.
See SETDEF subcommand — set defaults.

               [ ACTIVE|MAIN|STORAGE           ]
               [ DSNAME(dsname)|DATASET(dsname)]
               [ FILE(ddname)|DDNAME(ddname)   ]
               [ PATH(hfspath)                 ]
               [ FLAG(severity)                ]
               [ PRINT | NOPRINT               ]
               [ TERMINAL | NOTERMINAL         ]
               [ TEST | NOTEST                 ]

Parameters
gmt-tod-value

Specifies the first 1-32 hexadecimal digits of a TOD clock value associated with a dump.

EXTENDED

Specifies that the value should be treated as a 16-byte STCKE value rather than an 8-byte TOD clock value that are stored by the STCK instruction. In the output line for each time stamp, the 8-byte STCK or 16-byte STCKE value used to format the time stamp is also displayed.

INPUT( { ABSOLUTE | UTC | LOCAL } )

Specifies the interpretation appropriate for the STCK or STCKE value entered.
ABSOLUTE

Specifies that the value is the direct product of STCK or STCKE instructions. If you omit the INPUT option, ABSOLUTE is the default value.

UTC

Specifies that the value is adjusted with leap second factor.

LOCAL

Specifies that the value is adjusted with both leap second and local time zone factors.
Return Codes
See Standard subcommand return codes for a description of the return codes produced by the LISTTOD subcommand.
Example 1: Translate the TOD clock value from a dump.
- Action
```
listtod BDC613404B435A0A
```
  The command treats the value as STCK value, translates it to the absolute time stamp and then formats the other two time stamps.
- Result
```
10/17/2005 10:46:26.479157 STCK   X'BDC61340 4B435A0A'
10/17/2005 10:46:04.479157 UTC    X'BDC6132B 502B5A0A'
10/17/2005 03:46:04.479157 LOCAL  X'BDC5B54A B86B5A0A'
```

Example 2: Translate the TOD clock value to local time stamp.

Action
```
listtod BDC613404B435A0A input(local)
```
The command treats the value as STCK value, translates it to the local time stamp and then formats the other two time stamps.

Result

10/17/2005 10:46:26.479157 LOCAL  X'BDC61340 4B435A0A'
10/17/2005 17:46:48.479157 STCK   X'BDC67135 DE1B5A0A'
10/17/2005 17:46:26.479157 UTC    X'BDC67120 E3035A0A'

Example 3: Translate the TOD clock value that is stored by the STCKE instruction.

Action
```
listtod 00BDC613404B435A0A extended
```
The command treats the value as STCKE value, translates it to the absolute time stamp and then formats the other two time stamps.

Result

10/17/2005 10:46:26.479157 STCKE  X'00BDC613 404B435A 0A000000 00000000'
10/17/2005 10:46:04.479157 UTC    X'00BDC613 2B502B5A 0A000000 00000000'
10/17/2005 03:46:04.479157 LOCAL  X'00BDC5B5 4AB86B5A 0A000000 00000000'

Example 4: Translate the TOD clock value to local time stamp, treating the value as stored by the STCKE instruction.

Action
```
listtod 00BDC613404B435A0A extended input(local)
```
The command treats the value as STCKE value, translates it to the local time stamp and then formats the other two time stamps.

Result

10/17/2005 10:46:26.479157 LOCAL  X'00BDC613 404B435A 0A000000 00000000'
10/17/2005 17:46:48.479157 STCKE  X'00BDC671 35DE1B5A 0A000000 00000000'
10/17/2005 17:46:26.479157 UTC    X'00BDC671 20E3035A 0A000000 00000000'