Adjust Time (QWCADJTM) API


  Required Parameter Group:


  Default Public Authority: *USE

  Threadsafe: YES

The Adjust Time (QWCADJTM) API will adjust the time by increasing or decreasing the time-of-day clock to a maximum change of plus or minus two hours.

Note: A time-of-day adjustment will remain active until completed unless one of the following occurs:

The Retrieve System Time Information(QWCRTVTM) API can be used to determine if an adjustment to the time-of-day clock is allowed and can be used to retrieve information on any time adjustment that may be currently active.


Authorities and Locks

User Special Authority
*ALLOBJ

Required Parameter Group

Adjustment variable
INPUT; CHAR(*)

The variable that is used to specify the time adjustment details.

Length of adjustment variable
INPUT; BINARY(4)

The length of the adjustment variable. Minimum length is 9 bytes.

Adjustment format name
INPUT; CHAR(8)

The format name of the adjustment variable. The possible format name is:

ADJT0100
Basic time adjustment details.

See Format of Adjustment Variable for more information.

Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.


Format of Adjustment Variable

The following table describes the order and format of the data that is specified in the adjustment variable. For detailed descriptions of the fields in this table, see Field Descriptions.

ADJT0100


Field Descriptions

Time adjustment amount. The time value which specifies the amount of time in microseconds by which the time-of-day clock will be increased or decreased.

Note: The maximum value for the time adjustment interval is two hours.

Time adjustment direction. The direction of the time-of-day clock adjustment for the system.


Error Messages

The following messages may be sent from this function:




API introduced: V5R3

[ Back to top | Date and Time APIs | APIs by category ]