| 1 | Input format | Input | Char(8) |
| 2 | Input variable | Input | Char(*) |
| 3 | Error Code | I/O | Char(*) |
The Set System Time (QWCSETTM) API sets the Coordinated Universal Time (UTC) for the system.
For additional information on setting the time, see Usage Notes.
The format of the date specified for the input variable. Valid values are:
| *YYMD | YYYYMMDD (4-digit year, month, day) format. |
| *MDYY | MMDDYYYY (month, day, 4-digit year) format. |
| *DMYY | DDMMYYYY (day, month, 4-digit year) format. |
The date as Coordinated Universal Time (UTC) that is used to set the time-of-day clock. See Input Variable Formats to determine the structure of the input variable.
The structure in which to return error information. For the format of the structure, see Error code parameter.
This table shows the formats used for the input variable parameter.
| Input Format | Input Variable |
|---|---|
| *YYMD, *MDYY, *DMYY in microseconds | The first 20 characters are used. See 20-Byte Character Date and Time Value Structure. |
This table shows the structure used for the input variable when the format is *YYMD, *MDYY, and *DMYY.
| Offset | Description |
|---|---|
| 0-7 | Date, left-justified. This value cannot be all blanks or all zeros. |
| 8-13 | Time, in HHMMSS (hours, minutes, seconds) format. |
| 14-19 | Microseconds. This value cannot be blanks. |
The supported date range is from August 23, 1928, 12:03:06.314752 to May 10, 2071, 11:56:53.685240. Setting an input date that is outside this range will result in a date within this range. If you specify a precision of microseconds, it is recommended that you use a microsecond value that is evenly divisible by 8.
The following messages may be sent from this function:
| Message ID | Error Message Text |
|---|---|
| CPF1060 E | Date not valid. |
| CPF1061 E | Time not valid. |
| CPF1890 E | *ALLOBJ authority required for requested operation. |
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF3C21 E | Format name &1 is not valid. |
| CPF3C36 E | Number of parameters, &1, entered for this API was not valid. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF3CF2 E | Error(s) occurred during running of &1 API. |
| CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |