Request current date and time of day.
Description
ASKTIME updates the date (EIBDATE) and CICS® time-of-day clock (EIBTIME) fields in the EIB. These two fields initially contain the date and time when the task started.
In response to an ASKTIME command, CICS issues an MVS™ STCK macro and modifies this by a local time difference. For example, if your MVS TOD (hardware) clock is set to GMT, and the local time is defined as British Summer Time (BST), it is BST that is stored in the EIBTIME field.
For details of the EIB, see EIB fields.
Options
- ABSTIME(data-area)
- Specifies the data area for the number of milliseconds
since 00:00 on 1 January 1900, which is known as absolute time. The
time is taken from the system time-of-day clock, adjusted for leap
seconds and to apply the local timezone offset (including daylight
saving time), truncated to the millisecond, and returned as a packed
decimal of length 8 bytes.
You can use FORMATTIME to change the data into other familiar formats.
Example
For example, after the following
command runs:
EXEC CICS ASKTIME ABSTIME(utime)utime contains a value similar in format to 002837962864820.
The format of data-area is:
COBOL: PIC S9(15) COMP-3
C char data_area[8];
PL/I: FIXED DEC(15)
ASM: PL8