Filter
Top Products
548 Chapter 7
Command Definitions S-SO
SETCLOCK
NOW This option is meaningful only when the date and time specifications are
provided. NOW forces the change to be immediate. See the warning in the
Operation Notes section about the dangers of changing the system time
immediately.
CANCEL Cancels a current time correction. Any correction which has already taken
place before the cancellation will remain; this option does not undo a
correction which has already been accomplished. See the Operation Notes
and Examples sections for details.
Operation Notes
The SETCLOCK command is used to change the system time or to change the system's time
zone.
Changing the system time or time zone does not affect any interval timers in effect. Thus,
a PAUSE for a given time duration will maintain that same duration regardless of how the
system time is changed.
Changing the system time or time zone will cause any jobs streamed with a time
specification (;AT=, ;DAY=, ;DATE= or ;IN=) to be introduced in accordance with the
newly-changed system time. Thus, a job streamed with ;AT=9:00 will be introduced when
the changed system time is equal to 9:00.
The user may provide SETCLOCK with a date and time, a time correction, or a time zone.
The Date-Time form, the Correction form, and the Time Zone form are mutually exclusive;
for instance, the user may not provide specifications for both a time correction and a time
zone in a single command.
The Date-Time and Correction forms of the command are intended for slight adjustments
of the system time. For example, these forms would be used to move the time forward or
backward slightly in order to keep the system time synchronized with an external time
source. Both local and Universal (GMT) time are adjusted.
The Time Zone form of the command is intended for the larger time changes required to
move the system to a new time zone, such as moving between Standard Time and Daylight
Savings Time. This form of the command alters the local time without changing Universal
Time.
Date-Time: If the Date-Time form of the command is used, the system time is adjusted to
the specified date and time. This adjustment is gradual by default. It may be made
immediate if ;NOW is specified and the user has System Manager (SM) capability.
Correction: If the Correction form of the command is used, the system time is adjusted
forward or backward by the amount of the correction. This adjustment is always gradual.
Time Zone: If the Time Zone form is used, local time is adjusted to match that of the
specified time zone. In addition, the system time zone offset is changed to reflect the new
time zone.
The Use of The Time Zone Offset