MPE/iX Commands Reference Manual (32650-90864)

550 Chapter 7
Command Definitions S-SO
SETCLOCK
Any time during an on-going correction, issuing this command with the ;CANCEL
parameter will immediately set the correction to zero and cause the system clock to
resume its normal pace. Any previous correction will remain. When this option is used, the
system will report the amount of correction which was cancelled.
How a System Time Change Affects Accounting Information
Changing the system time, even gradually, may cause accounting CONNECT-MINUTES
to be distorted. Anyone logging on before the change and then logging off after the change
is completed will have their accounting CONNECT-MINUTES data distorted; if the time
change is forward, CONNECT-MINUTES will be increased by the amount of the time
change, and if the time change is backward, CONNECT-MINUTES will be decreased by
the amount of the time change.
Dangers in Using the ;NOW Parameter
The ;NOW parameter permits immediate forward or backward time changes. However,
several dangerous situations can occur:
• Any applications which rely on the forward progression of time may give inconsistent
results if the time is immediately set backwards. Such applications include the
processing of timestamped transactions in which the sequence of those transactions is
important.
• In order to recover data in case of an unexpected hardware or software failure, some
applications require that the system time must never seem to go backwards. For
instance, some applications log transactions to a circular file. These transactions are
timestamped, and if the transactions must be recovered, the recovery program
determines the end of data by looking for timestamps which are out of sequence. If the
system time is set backwards immediately, transactions which occur after the time
change may not be recovered. Therefore, do not set the time backwards using the ;NOW
option if there are applications which log their transactions using timestamps.
• Accounting CPU-SECONDS data may be distorted. The user whose process was active
during an immediate forward or backward change might seem to have a
CPU-SECONDS time which is an extremely large positive or negative number.
• STORE/RESTORE, TurboSTORE/XL, or any other file archive system based on dates
or times may not store or restore the files in the expected manner, since some files may
have creation or access times in the future or may even have access times which precede
their creation times.
• Some compilation tools like MAKE rely on the relative modification dates of the files in
the compilation unit. Setting the system time backward and then modifying the main
file in the compilation unit may force an unnecessary full compilation, since the main
file may have an earlier modification time than the files it depends on. Setting the
system time backward and then changing a file needed by the main file will cause
MAKE to think that the changed file's modification time precedes that of the main file.
Thus, the changed file will not be included in the recompilation.