TOD Clock Service

Start of change

The time-of-day (TOD) clock service provides a caller, including your exit routine, with a TOD clock image. The service supports values from May 11,1971, at 11:56:53.685248 to January 25, 2114, at 11:50:41.055743. In the clock image, bit 0 being off does not mean that the value was within the standard epoch (which began on January 1, 1900, at 12:00 AM). Rather, it means that the value is within the first epoch (which begins on September 17, 2042, at 23:53:47.370496). The system truncates partial microseconds and does no rounding.

Two services are provided, as described in the following table.

STCK (8-bytes) STCKE (16-bytes) Description
Start of changeBLSUXTID serviceEnd of change Start of changeBLSUETID serviceEnd of change Start of changeThese services are made available in MIGLIB for invocation through LINK or a similar invocation mechanism. The services each take two parameters:
  1. Input — a 26-character time stamp
  2. Output — a buffer for a binary STCK or STCKE value

The services update the output parameter, returning a binary TOD value (BLSUXTID service) or STCKE value (BLSUETID service). Return code 0 is returned if a supported time stamp is passed; otherwise return code 12 is returned.

End of change
End of change