── TIME ── ( ──<arithmetic expression>── ) ────────────────────────────┤
The TIME function makes various system time values available. The value of the arithmetic expression is rounded to an integer, if necessary, before being used. The results returned for different values of the integerized arithmetic expression are given in the following table. If the integerized value of the arithmetic expression is not one of the values listed in the table, the TIME function returns the value 0 (zero). All TIME results given in the following table are REAL values. To obtain a TIME result as a DOUBLE value, refer to the section, “DTIMEINTRINSIC Procedure,” in the MCP System Interfaces Programming Reference Manual.
|
Parameter |
Result Returned |
||||
|---|---|---|---|---|---|
|
1 |
The time of day, in 60ths of a second, as a rounded integer value. |
||||
|
2, 102, 202 |
The elapsed processor time of the program, in 60ths of a second, as a rounded integer value. The parameters yield the following results:
The normalized processor time can be used in conjunction with back-end process billing. |
||||
|
3 |
The elapsed I/O time of the program, in 60ths of a second, as a rounded integer value. |
||||
|
4 |
The value of a 6-bit clock that increments 60 times per second. |
||||
|
6, 16, 106, 116, 206 |
The current date and time (a timestamp) in the following form: [47:16] Date in YYDDD16 format [31:32] TIME(11) DIV 16 The YYDDD16 format represents any date from January 1, 1970 through December 31, 2147. For all date values through December 31, 2035, the two most significant digits represent the number of years since 1970, and the three least significant digits represent the day of year. For date values exceeding December 31, 2035, use the YD_FROM_YYDDD16 interface to convert any 16-bit date value to a year and day of year value. For more information on the YD_FROM_YYDDD16 interface, refer to the MCP System Interfaces Programming Reference Manual. To compare two timestamps for equality or inequality, use the IS or ISNT relational operators to ensure full word comparison. To compare two timestamps in a relational test, use the TSMAX interface. TSMAX accepts two timestamps with a TIME(6) format and returns the later of the two. For more information on the TSMAX interface, refer to the MCP System Interfaces Programming Reference Manual. |
||||
|
7 |
The current date and time in the following form: [47:12] Year (2000-2147) [35:06] Month (1-12) [29:06] Day (1-31) [23:06] Hour (0-23) [17:06] Minute (0-59) [11:06] Second (0-59) [05:06] Day of the week (0 = Sunday, 1 = Monday, and so on) |
||||
|
8 |
The elapsed Readyq time for the program, in increments of 1/60 seconds, as a rounded integer value. |
||||
|
9 |
The current time in EBCDIC characters in the format 8"HHMMSS," where HH is the hour, MM is the minute, and SS is the second. |
||||
|
10 |
The current date in EBCDIC characters in the Julian date format 8"YYDDD," where YY represents the last two digits of the year and DDD is the day of the year. This date is provided in the following format: [39:40] YYDDD provided by 5 EBCDIC characters To convert YY to a four-digit year, use the YYYY_FROM_YY interface. For more information on the YYYY_FROM_YY interface, refer to the MCP System Interfaces Programming Reference Manual. You can also use the TIME(210) function as an alternative to the TIME(10) function if you require a 4-digit year. |
||||
|
11 |
The same value as TIME(1), except that the time is expressed in multiples of 2.4 microseconds. |
||||
|
12, 112, 212 |
The same value as TIME(2), TIME(102), or TIME(202) except that the processor time is expressed in units of 2.4 microseconds. |
||||
|
13 |
The same value as TIME(3), except that the time is expressed in multiples of 2.4 microseconds. |
||||
|
14 |
The time available since the last halt/load expressed in multiples of 2.4 microseconds. Should be used as a type REAL expression. Unlike TIME(14), DTIMEINTRINSIC(14) does not lose precision when the system has been running for more than 15 days. For more information, refer to the section, “DTIMEINTRINSIC Procedure,” in the MCP System Interfaces Programming Reference Manual. |
||||
|
15, 115 |
The current date in EBCDIC characters in the format 8"MMDDYY," where YY represents the last two digits of the year. To convert YY to a four-digit year, use the YYYY_FROM_YY interface. For more information on the YYYY_FROM_YY interface, refer to the MCP System Interfaces Programming Reference Manual. You can also use the TIME(210) function as an alternative to the TIME(15) and TIME(115) functions if you require a 4-digit year. |
||||
|
18 |
The same value as TIME(8), except that the time is expressed in multiples of 2.4 microseconds. |
||||
|
19 |
This parameter enables a program to check whether advanced features such as Client Access Services are supported by the current hardware platform. The value returned does not determine whether the features are installed. |
||||
| Bit | Value | Description | |||
| 0 | 0 | MCP does not support Client Access Services | |||
| 1 | MCP supports Client Access Services | ||||
| 1 | 0 | Bit 0 is not valid | |||
| 1 | Bit 1 is valid | ||||
| 2 | 0 | The CPURATEBIAS feature is not supported | |||
| 1 | The CPURATEBIAS feature is supported | ||||
| 3 | 0 | Single quotes cannot be used with the SSHUSERNAME attribute | |||
| 1 | Single quotes can be used with the SSHUSERNAME attribute | ||||
|
This value is returned if the system supports MCP features such as Client Access Services. |
|||||
|
20 |
The program version number as set by the VERSION compiler control option. This value is the same as that returned by the preferred command COMPILETIME(20). |
||||
|
21 |
The program cycle number as set by the VERSION compiler control option. This value is the same as that returned by the preferred command COMPILETIME(21). |
||||
|
22 |
The program patch number as set by the VERSION compiler control option. This value is the same as that returned by the preferred command COMPILETIME(22). |
||||
|
23 |
The system identification information in the following format: [35:04] IO Type
0 - Unused
1 - IOM System
2 - IOP System
3 - IOA System
[31:08] E-mode level
5 - Level Epsilon
7 - Level Eta
[23:16] System serial number |
||||
|
24 |
The system type as a real value containing six EBCDIC characters. The name is left-justified with blank fill. |
||||
|
25 |
The integer value indicating the default compiler TARGET setting:
|
||||
|
26 |
The firmware version is as follows: [47:12] Firmware creation year [35: 6] Firmware creation month [29: 6] Firmware creation day [23:08] Firmware mark level [15:16] Firmware cycle number |
||||
|
27 |
The number of initial presence bits taken on a stack. |
||||
|
28, 128, 228 |
The amount of time taken to process the initial presence bits expressed in multiples of 2.4 microseconds. On Libra Series systems with MCP native partitions and capacity on demand (COD) and metering capabilities, the parameters yield the following results:
On other systems, parameters 28, 128, and 228 yield equal results. The normalized initial PBIT time can be used in conjunction with back-end process billing. |
||||
|
29 |
The number of other presence bits taken on a stack. |
||||
|
30, 130, 230 |
The amount of time taken to process the other presence bits expressed in multiples of 2.4 microseconds. On Libra Series systems with MCP native partitions and capacity on demand (COD) and metering capabilities, the parameters yield the following results:
On other systems, parameters 30, 130, and 230 yield equal results. The normalized other PBIT time can be used with back-end process billing. |
||||
|
31 |
The current MCP release level in the following format: [47:16] 2-digit mark level [31:16] 3-digit cycle number [15:16] 4-digit patch number The MCP release level is displayed by the WM (What MCP) system command. |
||||
|
32 |
Offset from Universal Time (UT), in the form of direction, hours, minutes, and the one-character military-style mnemonic, if the offset matches one, encoded in partial word fields. The format is as follows: TZ_VALIDF = [47:01] (1 if time zone valid) TZ_DIRECTIONF = [46:01] (which direction?) TZ_SUBV = 0 (Local Time = UT - offset) TZ_ADDV = 1 (Local Time = UT + offset) (not used) = [45:02] (not used) TZ_CUSTOMF = [43:01] (1 if custom time zone) (not used) = [42:03] (not used) TZ_HOURSF = [39:08] (hours offset 0-24) TZ_MINUTESF = [31:08] (minutes offset 0-59) TZ_MNEMONICF = [23:08] (military mnemonic) (not used) = [15:04] (not used) TZ_NUMBERF = [11:12] (if predefined, number) If a predefined time zone is configured, its number is also returned. This allows programs to use the MCPMESSAGESEARCHER or TIMEZONENAME interfaces to obtain the time zone name or abbreviation. For the MCPMESSAGESEARCHER interface, build the MSGNUM parameter with 80 in the WHOF field ([23:12]). The WHICH field ([11:12]) contains either 1 (for the time zone name) or 2 (for the time zone abbreviation). The parameter list contains parameter number <1>, the time zone number. The TIMEZONENAME interface requires only the time zone number. For more information on MCPMESSAGESEARCHER and TIMEZONENAME, see the MCP System Interfaces Programming Reference Manual. The military mnemonic is a single letter that identifies 25 time zones with integral hours offset values from -12 to +12 hours, including zero hours. The letters used are A through M for +1 through +12. The letter J is not used. The letters N through Y are used for -1 through -12. The letter Z is used for zero |
||||
|
33 |
Offset from UT as a four-digit signed integer for use by programs written in languages in which it is difficult to manipulate bits. The format is +/- HHMM. Note that if no time zone is configured, the value 9999 is returned. |
||||
|
34 |
Time zone abbreviation in left-justified blank-filled EBCDIC characters. If no time zone is configured, six nulls are returned. If a standard time zone is configured its abbreviation is returned in the task or system language. |
||||
|
36, 136 |
Halt/load time in TIME(6) format. |
||||
|
37 |
The abbreviation for the standard time zone returned as left-justified, blank-filled EBCDIC characters. If no time zone is configured, six blanks are returned. |
||||
|
38 |
The abbreviation for the daylight savings time zone is returned as left-justified, blank-filled EBCDIC characters. If no time zone is configured, six blanks are returned. |
||||
|
41 |
The current time of day, in 60ths of a second, an integer value. Times before noon are counted from midnight and are returned as negative numbers. Times after noon are returned as 12:00 through 12:59 and 1:00 through 11:59. |
||||
|
42 |
The current time of day, returned in universal time if the system time zone has been set and represented in the same way as TIME(41). |
||||
|
|||||
|
50 |
The same value as TIME(10), adjusted for Universal Time. |
||||
|
51 |
The same value as TIME(1), adjusted for Universal Time. |
||||
|
52 |
The same value as TIME(11), adjusted for Universal Time. |
||||
|
55, 155 |
The same value as TIME(15), adjusted for Universal Time. |
||||
|
56, 156 |
The same value as TIME(6), adjusted for Universal Time. |
||||
|
57 |
The same value as TIME(7), adjusted for Universal Time. |
||||
|
59 |
The same value as TIME(9), adjusted for Universal Time. |
||||
|
60 |
The time, date, and time zone in the following format: [46:07] Time zone number or 0 [39:16] Date in YYDDD16 format [23:24] Time of day in hundredths of a second For more information on the YYDDD16 date format, refer to TIME(6). |
||||
|
61 |
The current time of day. Represented in the same way as in TIME(41), but the value is in units of 2.4 microseconds. |
||||
|
62 |
The current time of day, returned in universal time if the system time zone has been set, and the value is in units of 2.4 microseconds. |
||||
|
65 |
The TARGET level set by the TARGET compiler control option or by the COMPILERTARGET if no TARGET compiler control option is used. The value is the same as returned by the preferred command COMPILETIME(65). If the parameter is a nonconstant expression that evaluates to 65, then the result is 0 (zero). |
||||
|
66 |
The percentage of the current code segment that is created by the compiler. The value is the same as returned by the preferred command COMPILETIME(66). If the parameter is a nonconstant expression that evaluates to 66, then the result is 0 (zero). |
||||
|
80 |
The version number of the compiler. This value is the same as that returned by the preferred command COMPILETIME(80). |
||||
|
81 |
The cycle number of the compiler. This value is the same as that returned by the preferred command COMPILETIME(81). |
||||
|
82 |
The patch number of the compiler. This value is the same as that returned by the preferred command COMPILETIME(82). |
||||
|
110 |
The current date in EBCDIC characters in the Julian date format of 8"YYYDDD. " To obtain a 4-digit year, add 1900 to the value of YYY. |
||||
|
150 |
The Universal date in EBCDIC characters in the Julian date format of 8"YYYDDD." To obtain a 4-digit year, add 1900 to the value of YYY. |
||||
|
210 |
The current date as a 7-digit integer in YYYYDDD format. The integer value DIV 1000 provides a 4-digit year, and the integer value MOD 1000 provides a 3-digit day of year. Note two TIME(210) values can be compared arithmetically using GTR, GEQ, LSS, LEQ, or EQL operators. |
||||
|
250 |
The same value as TIME(210), adjusted for Universal Time. |
||||

