home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / r / ritm25a.zip / RIGHTIME.TXT < prev    next >
Text File  |  1993-03-01  |  60KB  |  1,171 lines

  1. RighTime v2.53                                  Copyright 1991-93, GTBecker
  2. March 1, 1993                                           All Rights Reserved
  3.  
  4.                               Shareware Notice
  5.  
  6.       The following files are contained in the evaluation distribution file:
  7.  
  8.             RIGHTIME.COM                  TESTINCR.COM
  9.             RIGHTIME.TXT (this file)      TESTTIME.COM
  10.             RIGHTLOG.COM                  VIEWCMOS.COM
  11.             SETUPRT2.COM                                                   
  12.  
  13.       If any of these files are missing, you do not have a complete
  14. evaluation package.  A fresh distribution file of the latest version of
  15. RighTime and its associated programs is always available on the Air System
  16. Technologies BBS, 214/869-2780 (1200-14400 8N1).
  17.  
  18.       These files are the copyrighted property of G.T. Becker and Air System
  19. Technologies, Inc., of Dallas, Texas, USA.
  20.  
  21.       You may use these evaluation programs for up to one month, and you may
  22. - and are encouraged to - pass the unmodified evaluation distribution file
  23. along to others, but no one may modify, rename or sell the files or programs
  24. to anyone under any circumstances.  Although they will continue to function,
  25. the programs will notify you when the evaluation period has elapsed.
  26.  
  27.       If you choose to continue to use RighTime you must register your use. 
  28. Registered RighTime users receive a diskette containing the current version
  29. of the registered programs and additional utilities, a printed user manual
  30. and license agreement, automatic notification of new releases, and
  31. enthusiastic support from the author whenever needed.  The registered version
  32. of RighTime is functionally identical to the shareware distributed evaluation
  33. version, except that it lacks registration reminders, it is smaller in size,
  34. it can operate in a non-verbose and silent mode, and it is serial-numbered to
  35. the individual or business registrant.
  36.  
  37.       To register, fill in the form at the end of this document and send it
  38. with US $40 for each machine that is to run RighTime to Air System
  39. Technologies, Inc., 14232 Marsh Lane, Suite 339, Dallas, Texas 75234, USA.
  40.  
  41.  
  42.  
  43.                          What is RighTime Version 2?
  44.  
  45.       RighTime is a resident real time clock correcting program for MS-DOS,
  46. PC-DOS and DRDOS running on PC/AT-class machines.  It corrects both DOS and
  47. CMOS RTC clock rate error as large as 5.5 minutes per day, and it increases
  48. the DOS clock resolution from about 0.055 second to 0.01 second.  It occupies
  49. only about 6.5K of system RAM and can normally be loaded high.  If RighTime
  50. is installed as suggested, the system clock will behave as properly and
  51. accurately as the system clock of a computer should.
  52.  
  53.      RighTime brings exceptional system time-of-day clock performance to the
  54. machine with no additional hardware.  With RighTime installed, the standard
  55. real time clock system becomes an Adaptive Mathematically Compensated
  56. Crystal-controlled Oscillator based clock.  Under stable conditions, RighTime
  57. can produce a system clock that keeps time within 0.5 second per week or
  58. better (some users have reported consistent rate accuracy of 0.07 second per
  59. week).  An error rate 0.5 second per week is about 0.8 part per million, or
  60. more than 100 times better than an unconditioned crystal time base alone, or
  61. about 30 times better than a moderately conditioned one like a modern watch
  62. of quality.
  63.  
  64.      RighTime Version 2 exhibits many new features, but retains version 1.1
  65. compatibility (except /H).  In addition to numerous invisible internal
  66. improvements, RighTime Version 2 sports the following changes:
  67.  
  68.       *     True 0.01 second DOS clock resolution: the 55-millisecond barrier
  69.             is broken!  The DOS clock increments in 0.01 second steps while
  70.             maintaining the standard "tick" rate.  [See /TH below.]
  71.  
  72.       *     File mode correction storage can be directed to either
  73.             RighTime.COM or to a separate data file (RighTime.COR), which
  74.             will prevent anti-virus watchdog utilities from flagging
  75.             RighTime.  [/FR, /FM]
  76.  
  77.       *     Correction storage can be directed to any valid CMOS RAM address
  78.             that is available in the machine, including extended RTC CMOS and
  79.             MCA-type (PS/2 and -SL) CMOS RAM.  [/R, /RM]
  80.  
  81.       *     Four levels of function disabling.  [/TH, /TD, /TA, /K]
  82.  
  83.       *     Disabled cool correction and improved warm correction
  84.             application.  [/D, /U, /X]
  85.  
  86.       *     Options are provided that allow learning disabling and ignoring
  87.             time and date sets.  [/L, /I]
  88.  
  89.       *     Automatic Daylight/Standard time change in the USA.  [/A]
  90.  
  91.       *     Fixed offset values may now range from -90.00 to +90.00 seconds. 
  92.             [/O]
  93.  
  94.       *     Logging of all time-related activity.  [/G]
  95.  
  96.       *     Highlighting of significant data and ANSI color screens.  [/Y]
  97.  
  98.       *     On screen memory-jogging help.  [/?]
  99.  
  100.       *     Silent and defeatable self test.  [/Q]
  101.  
  102.       *     Non-verbose mode (registered version only).  [/V]
  103.  
  104.       *     /W, /C and /O values may be expressed as either integers
  105.             (hundredthseconds) or as fractional seconds (i.e. /W-1234 =
  106.             /W-12.34), consistent with a new displayed data format.
  107.  
  108.       *     RighTime's status report includes duration since last time set,
  109.             duration since last applied CMOS adjustment and percentage of
  110.             warm system operation (any /F and extended CMOS /R only).
  111.  
  112.       *     Intelligent application of warm and cool corrections, weighted
  113.             observed error and distributed modification of correction values
  114.             (both warm and cool corrections will be modified based on
  115.             observed error at timeset and percentage of warm system
  116.             operation) (any /F and extended CMOS /R only).  Although the
  117.             practice remains the ideal, it is no longer necessary to set the
  118.             clock immediately after booting and just prior to shutting the
  119.             system down to learn the cool and warm corrections; you may set
  120.             the time at any time, and RighTime will do its best to adjust the
  121.             corrections appropriately.
  122.  
  123.       *     Tools are provided to visualize and verify RighTime's actions. 
  124.             [TestTime, TestIncr, RighTLog, ViewCMOS]
  125.  
  126.             +     An improved TestTime is able to resolve clock error to four
  127.                   decimal places (to tenths of milliseconds), reports the
  128.                   DOS-CMOS offset immediately, and displays the DOS time to
  129.                   hundredths.
  130.  
  131.             +     TestIncr measures and displays the DOS clock resolution.
  132.  
  133.             +     RighTLog displays the record of all time-related activity
  134.                   on the system.  It identifies the source of each timeset
  135.                   and dateset by program name, making hidden timeset
  136.                   troubleshooting easy.
  137.  
  138.             +     ViewCMOS can now display the first 128 bytes of MCA-type
  139.                   CMOS on those machines equipped with it.
  140.  
  141.       *     SETUPRT2, a full-screen install program, eases first-time
  142.             installation and startup as well as reinstallation when changing
  143.             options.
  144.  
  145.       *     Professional TimeSet v7.10 or later by Pete Petrakis (Life
  146.             Sciences Software, Stanwood, Washington USA) can directly control
  147.             several RighTime functions and provides a RighTime status screen. 
  148.             These two programs were developed in concert and work
  149.             exceptionally well together.  TimeSet uses a modem to call any of
  150.             five atomic clock time standards (in the USA, Austria, Italy and
  151.             Sweden) to set the system clock to millisecond accuracy.  It is
  152.             highly recommended.  Its shareware evaluation file is available
  153.             on the Air System Technologies BBS.
  154.  
  155.  
  156.  
  157.                            What Does RighTime Do?
  158.  
  159.       First, here is what RighTime cannot do:
  160.  
  161.       -     RighTime cannot correct clock boards or computer motherboard
  162.             clocks that do not emulate the PC/AT hardware clock and its BIOS
  163.             support precisely.  The large majority of current 80286-, 80386-
  164.             and 80486-based machines (termed PC/AT-class) are compatible.
  165.  
  166.       -     RighTime cannot properly correct an unstable clock; most clocks
  167.             are slow or fast and they are essentially unvarying.  If your
  168.             clock wanders aimlessly or has suddenly changed behavior, your
  169.             hardware might need repair (perhaps simple battery or CMOS RTC
  170.             module replacement).
  171.  
  172.  
  173.       RighTime exploits the better qualities of each of the two clocks in the
  174.       system and improves upon them by doing four fundamental things:
  175.  
  176.       1)    RighTime slaves the DOS system clock (which has higher
  177.             resolution) to the hardware clock (which has higher stability).
  178.  
  179.       2)    RighTime augments the DOS clock driver routines with its own
  180.             routines, which provide resolution in excess of 0.01 second.
  181.  
  182.       3)    RighTime monitors time set commands (and the equivalent system
  183.             calls from any program) to learn the hardware clock error rate.
  184.  
  185.       4)    RighTime improves and maintains accuracy by regularly calculating
  186.             and applying corrections or adjustments to each clock.
  187.  
  188.  
  189.       RighTime intrinsically sets the hardware clock and solves the midnight
  190.       rollover date error that exists in most DOS/BIOS combinations,
  191.       eliminating the need for other utility programs or drivers that perform
  192.       these functions.  Unlike DOS alone, the hardware clock seconds
  193.       transition will be properly set by RighTime and the time will be set to
  194.       0.01 second resolution, and these qualities will survive through
  195.       rebooting.  If the machine is powered off, the clocks will be
  196.       appropriately adjusted for the off period at the next boot, and a
  197.       separate correction is learned and maintained for that period.
  198.  
  199.       Each time you set the time, RighTime will improve the accuracy of the
  200.       corrections, which will subsequently improve the accuracy of the
  201.       clocks.  It should be easy to achieve a worst-case error of less than
  202.       0.5 second per day (usually quickly improving to less than 0.5 second
  203.       per week).  Numerous options are provided that allow fine tuning the
  204.       correction process to your system and application.
  205.  
  206.       An option [/S] is provided which assists in automatic timesetting by
  207.       directing RighTime to notify a batch file when a specified number of
  208.       days has elapsed since the last timeset or if the program's correction
  209.       capabilities have been exceeded.  This feature is available both at
  210.       boot and when RighTime is resident.
  211.  
  212.       Large time changes will not affect the corrections.  This permits
  213.       seasonal time changes; these bi-annual changes can also be automated in
  214.       the USA.
  215.  
  216.       RighTime usually runs fine with Microsoft Windows (although Windows
  217.       itself always lags DOS by a few seconds) and with multitaskers and
  218.       DOS-based LANs.
  219.  
  220.  
  221.  
  222.                   Knowledge Saves Time - Contraindications
  223.  
  224.       Just as with medicine that cures ills, RighTime needs to involve itself
  225. in several areas of the operating system to do its work, and there can be
  226. side-effects.  Side-effects of RighTime are usually minor and correctable. 
  227. Be aware of the following so you'll know what you can do if you need to.
  228.  
  229.       *     Some programs (usually games) reprogram the 8254 timer-counter to
  230.             improve the video screen update rate or to produce sounds.  Since
  231.             the 8254 is part of the DOS clock mechanism, RighTime will
  232.             normally immediately correct the mode change - and slow the game. 
  233.             This protection can be relaxed without compromising the clock by
  234.             selectively disabling RighTime [usually /TD] for the duration of
  235.             the game and reenabling it afterward.
  236.  
  237.       *     High-speed (9600 and higher) communication sessions can sometimes
  238.             be disturbed by RighTime.  An option [/M] yields automatic
  239.             disabling during communication activity on selected ports.
  240.  
  241.       *     Programs that bypass the operating system and control the
  242.             hardware directly can cause odd symptoms.  Tape backup utilities
  243.             seem to be the most common offenders, potentially causing DMA
  244.             errors with RighTime's /F options.  Most of these programs offer
  245.             an option that uses the DOS and BIOS function calls instead; use
  246.             it, or disable RighTime [/TA] for the duration of the backup.
  247.  
  248.       *     Disk defragmenters (PCCOMPRESS, SPEEDDISK, DOG, etc.) can produce
  249.             cross-linked files resulting in loss of data if RighTime is
  250.             active (with any /F option).  DOS is not aware that these
  251.             utilities are moving files around, so RighTime isn't either. 
  252.             RighTime (with any /F option) must not be running [/K] when
  253.             defragmenting the disk drive on which it resides.
  254.  
  255.       *     Some screen savers and program schedulers misfire prematurely and
  256.             some on-screen clocks run fast due to RighTime's high resolution
  257.             DOS clock mode.  Some programs also have difficulty when run from
  258.             within a DOS window.  Disabling the 0.01 second DOS clock mode
  259.             [/TH] usually allows these programs to coexist with RighTime.
  260.  
  261.       *     No resident program that uses files (like a screen capture
  262.             utility or a scheduler) should be loaded before RighTime (with
  263.             any /F option).  The ideal location in the AUTOEXEC.BAT for
  264.             RighTime is first.  If you want to load RighTime in high memory,
  265.             be aware that the program uses several anti-virus and anti-
  266.             hacking techniques to protect itself.  This requires a large
  267.             (about 80K), but brief, use of memory.
  268.  
  269.       In most cases, a program conflict can be resolved by temporarily
  270.       disabling RighTime.  This can be accomplished manually at the DOS
  271.       prompt, with a batch file, or via a multiple-command line in 4DOS or
  272.       NDOS.  RighTime functions can be quickly reenabled afterward.
  273.  
  274.  
  275.  
  276.                             Standard Installation
  277.  
  278.       RighTime is now provided with a simple installation process that will
  279. assure successful startup.  We strongly suggest that you follow this
  280. procedure.  After you have some experience with the program you can
  281. manipulate options at the command line level if you wish, but even for these
  282. changes the supplied installer program, SETUPRT2, is recommended.
  283.  
  284.       1)    If you are currently running RighTime, kill it (RighTime /K).
  285.  
  286.       2)    Make a new directory and get in it, for example:
  287.                   MD \TEMP
  288.                   CD \TEMP
  289.  
  290.       3)    Copy the shareware distribution file into the new directory and
  291.             unzip it.  Verify that all of the files listed above are present.
  292.  
  293.       4)    Run from a DOS prompt:
  294.                   SETUPRT2
  295.  
  296.       5)    SETUPRT2 will allow you to select many options, but you can 
  297.             initially accept the defaults by simply selecting "Install"; you
  298.             can change them anytime later.
  299.  
  300.       6)    When asked to do so, set the time accurately (preferably with
  301.             TimeSet).  Then type "EXIT".  Your AUTOEXEC.BAT and, if required,
  302.             CONFIG.SYS files will have a line added to them.
  303.  
  304.       7)    You will normally be directed to reboot by pressing Ctrl-Alt-Del.
  305.  
  306.       8)    Set the time accurately for a few days, ideally immediately
  307.             before you shutdown your system for the night and immediately
  308.             after booting in the morning.  If you never shutdown your system,
  309.             set the time accurately a few times each day, well spaced.
  310.  
  311.       You should find that your system clocks rapidly become more accurate. 
  312. If they do not, check RighTLog for invisible, unexpected time sets (which
  313. will confuse RighTime's learning).  The name of the program that set the time
  314. is identified in the log.  You might be surprised to find that some programs
  315. - that have no apparent business doing so - set the clock, usually
  316. incorrectly and always disturbing RighTime.  You will need to consider an
  317. option [/I] that can deal with these rogue programs; read on.
  318.  
  319.  
  320.       You will normally not need to proceed beyond this point, but if you
  321. have trouble with the standard installation, the following sections discuss
  322. RighTime in greater detail.
  323.  
  324.  
  325.  
  326.                               Starting RighTime
  327.  
  328.       Part of the RighTime process requires storage of some correction data. 
  329. The amount of data is small and it must be stored in a place that will
  330. survive rebooting and power failures.  To use RighTime, first decide where to
  331. store the corrections.  There are two options: disk file and unused CMOS RAM. 
  332. In general, try the disk file option first if you can.  If you have a hard
  333. disk, you can use the disk file or possibly the CMOS RAM option.  If you have
  334. only floppies the disk file option is impractical, so consider the CMOS RAM
  335. option.  A diskless machine cannot use the disk option, unless it is equipped
  336. with a non-volatile RAM disk which appears to the system as any other disk
  337. would.
  338.  
  339.       The CMOS RAM option will involve some initial bravado: although only
  340. the first 52 bytes of a 64-byte CMOS RAM are defined by the original IBM PC
  341. standard (presumably leaving the last 12 bytes available), most modern BIOSs
  342. use these 12 bytes for other functions.  If you have adopted a user-specified
  343. hard disk format, for example, your specification might be stored there. 
  344. Sometimes the area is used for the power-on password in machines so equipped. 
  345. Many modern machines contain 128-byte CMOS RAM areas, and others (some PS/2
  346. models and SL-based machines) contain 256 bytes of CMOS RAM.  SETUPRT2 will
  347. only allow selection of CMOS RAM addresses that allow for the proper storage
  348. of RighTime's correction data, but there is no guarantee that the address you
  349. select is unused in your machine configuration.  You can run ViewCMOS to look
  350. at the CMOS RAM contents, but again, there is no guarantee that even a large
  351. block of zeros is free and safe to use.  Before attempting to use the CMOS
  352. RAM option, be forewarned that CMOS RAM contains system setup data that
  353. RighTime might inadvertently disturb; be prepared to reset the setup data if
  354. the CMOS RAM option is unsuccessful on your system.  If this dissuades you or
  355. if you are otherwise reluctant, use the disk file option if you can.
  356.  
  357.       If you choose the disk file option, RighTime will attempt to write to
  358. a disk file (its own program file or a separate data file) from time to time,
  359. so write access must be allowed.  If the "disk" is actually a non-volatile
  360. RAM disk card, the card must remain in the machine if this option is to work
  361. properly.  If you use the disk file option on a battery powered hard disk
  362. laptop, you might want to decrease the update frequency to allow your hard
  363. disk to spin down after periods of inactivity to increase the battery life
  364. (see the /U option, Command Line Syntax, below).  The disk file option causes
  365. RighTime to maintain an open handle to a file which will present a problem
  366. when running a file-defragmenting utility on the same disk drive that
  367. RighTime is updating, but RighTime can be killed during defragmentation and
  368. restarted afterwards (see the /K option, Killing, Disabling and Reenabling
  369. Resident RighTime, below).
  370.  
  371.       RighTime can also be configured with no correction storage, with
  372. consequential loss of some of its utility (see No Correction Storage Option,
  373. below).
  374.  
  375.       If you know how fast or slow your clock appears to run per day, you can
  376. optionally speed the learning process of RighTime by suggesting a correction
  377. to the program as a signed number in hundredths of seconds - positive for a
  378. slow clock, negative for a fast clock.  For example, if your clock runs about
  379. two minutes fast per day, the suggested correction should be -120.00 (120
  380. seconds).  There are actually two corrections that RighTime normally applies,
  381. one while the system is running and warm, and another when the system is
  382. turned off and cool.  If you know the cool correction, you can suggest it
  383. also.  If you don't know one or either correction, RighTime will determine
  384. them anyway; it'll just take a little longer for the corrections to mature to
  385. good accuracy.
  386.  
  387.       If you need to restart RighTime and it is currently resident and
  388. running, you must first kill the resident program (see Disabling and
  389. Reenabling Resident RighTime, below).  If appropriate, the corrections that
  390. RighTime has already learned can be suggested to the new program copy. 
  391.  
  392.       If you have been using another resident driver or TSR to correct the
  393. weaknesses of your clock, remove all references to it from your CONFIG.SYS
  394. and AUTOEXEC.BAT files and, once you are confident that RighTime is all it
  395. purports to be, remove the other driver or TSR from your system.
  396.  
  397.  
  398.  
  399.                               Setting the Time
  400.  
  401.       If you have access to a time standard, use it.  For best accuracy, use
  402. a telephone service time-setting program such as TimeSet.  Alternatively, you
  403. can listen to WWV, CHU or another shortwave time signal, or a radio network
  404. news broadcast, and be prepared to set your clock when you hear the beep on
  405. the minute or hour.  Don't use a radio station that is airing a call-in talk
  406. show; the audio is usually delayed six to ten seconds on such programs to
  407. allow for profanity dumping, and so the beep will be equally late.  An all-
  408. news format station is probably not delayed.  To be certain, call the radio
  409. station and ask for engineering; they will know.  Local telephone time
  410. services are usually poor; don't trust that they are correct.  What is
  411. important is accuracy.
  412.  
  413.       Do not set the time from within Microsoft Windows.  If you do, the
  414. resulting time set will be late.  This probably also applies to DESQView and
  415. other multitaskers.  Always set the time (or run the time setting program)
  416. from a pure DOS prompt.
  417.  
  418.       RighTime will monitor each time set occurrence, learning from your
  419. adjustments.  Whenever you notice or suspect that the indicated DOS system
  420. time is insufficiently correct to satisfy you, reset it accurately.  You will
  421. find that the clocks will become more and more accurate and the need for
  422. adjustment will decrease, becoming infrequent; however, you must set the time
  423. accurately at least once per month (an option is provided to assist in
  424. automating this [/S] (see Errorlevels, below).
  425.  
  426.       Allow sufficient time to elapse between time sets so that enough error
  427. exists for RighTime to use in its correction calculations; the more time that
  428. you allow, the better the correction factors that are determined.  Careless
  429. timesets will result in poor correction or even wild clock behavior; remember
  430. that you are "training" the program, so do it well.  If you are eager, four
  431. hours will probably be an adequate initial wait; of course, you can use your
  432. system as you normally would during this time.  Each time the time is set,
  433. RighTime will make appropriate adjustments to the cool and warm correction
  434. values.
  435.  
  436.  
  437.  
  438.                                  The Results
  439.  
  440.       After a few days of your diligent time setting, the corrections should
  441. settle to fairly constant numbers which will be true indications of the
  442. uncorrected performance of your hardware clock.  Once RighTime is installed,
  443. you can display the current corrections by simply running RighTime again at
  444. a DOS prompt (no parameters are required).  The correction values and other
  445. current status will be displayed and a functional self test will normally be
  446. performed, verifying that RighTime is currently running properly on your
  447. system.
  448.  
  449.       When running RighTime, whether at installation or when resident, the
  450. program will normally be silent.  If RighTime beeps, pay close attention to
  451. its report; it is warning you of an unusual condition or failure.  If data
  452. highlighting is not disabled [/Y0], unusual conditions or failures will be
  453. highlighted.
  454.  
  455.       As long as RighTime is in use and you've been diligent in your
  456. adjustments, and the corrections have matured, the CMOS RTC error will not be
  457. more than 0.5 second, and the DOS clock will be much more accurate than that.
  458.  
  459.       RighTime has limits of one week of inactivity, and one month between
  460. time sets, that can be corrected to a maximum of 5 minutes, 27.67 seconds per
  461. occasion; beyond that, all bets are off.  In that case, unpredictable, and
  462. probably incorrect, clock changes can occur, but RighTime will advise you of
  463. its difficulty if it can.  For example, if your clock runs two minutes slow
  464. per day and you don't use the system for three full days, when you boot up
  465. you will receive a message warning that the clock needs to be adjusted
  466. manually (or automatically; see Errorlevels, below).  The subsequent
  467. adjustment will not affect the corrections.
  468.  
  469.  
  470.  
  471.                         No Correction Storage Option
  472.  
  473.       If you have difficulty with both the CMOS RAM and disk file options or
  474. you need or wish to use neither option, RighTime can still correct the clocks
  475. for as long as the system runs continuously.  What RighTime has learned will
  476. be lost when you reboot or power down, and there can be no cool correction. 
  477. Otherwise, all of the comments above apply.  If you suggest a good warm
  478. correction and you set the clock after you boot, RighTime will serve well.
  479.  
  480.  
  481.  
  482.              Killing, Disabling and Reenabling Resident RighTime
  483.  
  484.       There will normally be few, if any, occasions that will require you to
  485. disable RighTime, but some instances exist that can only be resolved by
  486. temporarily removing RighTime from contention.  There are four levels of
  487. disabling; each level is more restrictive in what RighTime is permitted to
  488. do.  From least restriction to most, the disabling options are /TH, /TD, /TA,
  489. and /K.
  490.  
  491.       Once RighTime is resident, it can be disabled by running at a DOS
  492.       prompt:
  493.  
  494.             drv:\path\RighTime /TH  [disables 0.01 second DOS clock]
  495.                   or
  496.             drv:\path\RighTime /TD  [disables DOS clock maintenance]
  497.                   or
  498.             drv:\path\RighTime /TA  [disables all functions (including
  499.                                     logging)]
  500.  
  501.       Resident RighTime can then be reenabled by running:
  502.  
  503.             drv:\path\RighTime /E   [enables all functions]
  504.  
  505.       Programs that defragment or reorganize the hard disk must always be run
  506.       with no open files.  When using RighTime's disk file option [any /F],
  507.       an open handle is maintained to a file, so BEFORE RUNNING A DISK
  508.       REORGANIZING UTILITY, RighTime MUST BE KILLED.  After the utility
  509.       completes, RighTime can be restarted with the same command line used in
  510.       the AUTOEXEC.BAT file.  However, most defragmenting utilities suggest
  511.       rebooting afterward; in that case, AUTOEXEC.BAT will restart RighTime. 
  512.       This precaution is not required when using the CMOS RAM option.
  513.  
  514.       RighTime can be irreversibly disabled (or "killed") by running:
  515.  
  516.             drv:\path\RighTime /K   [entire resident program terminated]
  517.  
  518.       The /K switch will cause the function of RighTime to terminate, but the
  519.       memory that was allocated to RighTime will remain allocated and
  520.       unavailable.  If you wish, another copy of RighTime can be started with
  521.       different options; in that case, a memory map will indicate multiple
  522.       RighTime allocations, but only one will be active.
  523.  
  524.       If it is your intent to permanently remove RighTime from your system,
  525.       you can do so by killing the resident program and removing or REMing
  526.       the RighTime invocation in your AUTOEXEC.BAT.  Rebooting is not
  527.       immediately necessary.
  528.  
  529.       RighTime provides another method to temporarily disable its function in
  530.       instances where the program interferes with serial modem communication. 
  531.       An option will continually test for the presence of Data Carrier Detect
  532.       (DCD) from each specified serial port.  When DCD is active, RighTime
  533.       will be disabled, equivalent to /TA.  Normal function will resume when
  534.       DCD becomes inactive.  Multiple ports can be specified.
  535.  
  536.             To activate DCD monitoring, use the /M switch as follows:
  537.  
  538.                   drv:\path\RighTime /M1  [for COM1]
  539.                         or
  540.                   drv:\path\RighTime /M2  [for COM2]
  541.                         or
  542.                   drv:\path\RighTime /M3  [for COM3]
  543.                         or
  544.                   drv:\path\RighTime /M4  [for COM4]
  545.  
  546.             Several ports can be simultaneously monitored, for example:
  547.  
  548.                   drv:\path\RighTime /M1 /M2
  549.  
  550.             DCD monitoring can be disabled with
  551.  
  552.                   drv:\path\RighTime /M0
  553.  
  554.             For DCD monitoring to function properly, the active modem control
  555.             string must contain "&C1" for Hayes-compatible modems.  This will
  556.             cause DCD to properly reflect the presence of carrier.  If DCD is
  557.             stuck on and a /M switch specifies that port, RighTime will never
  558.             be permitted to function.  If you run RighTime to display a
  559.             status report, the current DCD state will be reported.  It should
  560.             normally report "... DCD monitoring is enabled", not "... DCD
  561.             active, RighTime function suspended".
  562.  
  563.             Microsoft Windows users (in 386-Enhanced mode) will need to
  564.             prevent a false contention report by clicking on Control Panel,
  565.             386-Enhanced, then select Never Warn for each affected port, then
  566.             OK.
  567.  
  568.       Normally, RighTime learns from each time set.  Some programs invisibly
  569.       set the clock - in most cases for no apparently good reason - which
  570.       disturbs RighTime's learning.  If RighTime is run with logging enabled
  571.       [/G], all time and date sets will be logged, and each log entry,
  572.       displayed by running RighTLog, identifies the program name of the
  573.       source of the time or date set.  Once the sources of the offending time
  574.       or date sets are identified, RighTime can be selectively controlled to
  575.       ignore those errant sets.  There are three approaches that work equally
  576.       well.
  577.  
  578.             1)    As when temporarily disabling RighTime in the examples
  579.                   above, the offending program can be preceded by a RighTime
  580.                   command which will cause the time sets to be ignored as if
  581.                   the program never issued them.  If the program always
  582.                   issues a pair of sets, one for the date and one for the
  583.                   time, RighTime can be directed to ignore the following two
  584.                   sets with
  585.  
  586.                         drv:\path\RighTime /I2  [ignore next two sets]
  587.                         OffendingProgramHere
  588.  
  589.                   If the program issues only a time set, it can be ignored
  590.                   with
  591.  
  592.                         drv:\path\RighTime /I1  [ignore following set]
  593.                         OffendingProgramHere
  594.  
  595.                   In each case, once the specified number of sets to be
  596.                   ignored has been issued by the offending program, RighTime
  597.                   will resume normal function, accepting and processing time
  598.                   and date sets.  If there are several offending programs,
  599.                   each will need to be treated similarly.
  600.  
  601.             2)    Another method, useful if the offending program issues a
  602.                   variable number of sets, is to precede the program with a
  603.                   RighTime command which causes all time and date sets to be
  604.                   ignored until further notice.  The program can then be
  605.                   followed by a Rightime command which discontinues ignoring
  606.                   time and date sets.  A small batch file might look like
  607.  
  608.                         drv:\path\RighTime /I-1 [ignore all sets]
  609.                         OffendingProgramHere
  610.                         drv:\path\RighTime /I0  [resume allowing sets]
  611.  
  612.             3)    A logical extension of that method is to issue the /I-1 in
  613.                   the AUTOEXEC.BAT invocation of RighTime.  This will cause
  614.                   all time and date sets to be ignored, regardless of the
  615.                   source - even the DOS prompt TIME and DATE commands - until
  616.                   otherwise directed.  Legitimate time sets - say, from
  617.                   TimeSet - can be permitted by surrounding the TimeSet
  618.                   invocation with the inverse of the commands above, i.e.
  619.  
  620.                         drv:\path\RighTime /I0  [allow sets]
  621.                         TimeSet
  622.                         drv:\path\RighTime /I-1 [resume ignoring all sets]
  623.  
  624.                   TimeSet v7.10 or later, however, provides for this ability
  625.                   through its RighTime Control Panel, so no additional
  626.                   RighTime commands are required.
  627.  
  628.       Learning itself can also be disabled.  This allows for time sets that
  629.       will not affect the current corrections.  The corrections are
  630.       essentially fixed while learning is disabled.  Learning can be disabled
  631.       in the AUTOEXEC.BAT RighTime invocation and it can be temporarily
  632.       controlled by TimeSet v7.10 or later.  It cannot be disabled at any
  633.       other time.  To disable learning, add the /L0 switch to the
  634.       AUTOEXEC.BAT RighTime invocation.
  635.  
  636.       In the registered version only, two additional options are allowed:
  637.  
  638.             drv:\path\RighTime /Q   [silences minor error reports and
  639.                                     disables self-testing]
  640.  
  641.             drv:\path\RighTime /V0  [non-verbose mode produces no screen
  642.                                     output (including errors), is completely
  643.                                     silent, and disables self-testing]
  644.  
  645.  
  646.  
  647.                                   TestTime
  648.  
  649.       Included with RighTime is a program tool that can provide some
  650. interesting insight into the relationship of the clocks in your system and
  651. the function of RighTime.  TestTime takes no command line parameters.  It
  652. will determine and express whether or not RighTime is running in the system,
  653. tests and reports on some critical modes, and it provides a continuous single
  654. line display of the clock system status.
  655.  
  656.       The status line is straightforward:
  657.  
  658.             CMOS=date:hh:mm:ss DOS=date:hh:mm:ss.hh !Appl=+0.00 Meas=+00.0000
  659.  
  660.       where:
  661.  
  662.       CMOS is the CMOS RTC clock data.  The equal sign that follows "CMOS"
  663.       will flash at a one second rate if the CMOS RTC interrupts are normal.
  664.  
  665.       DOS is the DOS system clock data, including hundredths.  The hundredths
  666.       digit might appear to be less than a blur due to your video vertical
  667.       scan rate.  It should be possible to see the difference between 0.01
  668.       second DOS clock mode and the standard 0.055 second mode [/TH].
  669.  
  670.       Appl is the current correction being applied to the DOS clock in
  671.       hundredths, if RighTime is resident.  The exclamation mark (!) before
  672.       it indicates the moment that the DOS clock is corrected.  This normally
  673.       occurs every four seconds, but can be skipped occasionally if internal
  674.       resources don't allow it.
  675.  
  676.       Meas is the signed time difference between the CMOS RTC and DOS clock
  677.       in seconds, resolved to four decimal places (tenths of milliseconds). 
  678.       A positive difference indicates that the DOS clock leads the hardware
  679.       clock (it displays a higher, later, advanced time).  Under normal
  680.       conditions, this value should be well within a few milliseconds
  681.       (normally it is within a few tenths of a millisecond) of the "Appl"
  682.       value.  It is usually possible to directly view the clock drift at this
  683.       resolution; the difference will increase for awhile, then suddenly
  684.       revert back to a value close to the "Appl" value each time the DOS
  685.       clock is corrected.
  686.  
  687.       You can use TestTime to learn much about the behavior of the two clocks
  688. in your system.  Try running it without RighTime installed and notice that
  689. the DOS clock is never the same as the hardware clock.  Set the time and run
  690. TestTime again.  If your DOS sets the hardware clock, check to see if the
  691. seconds are synchronized, which is indicated by a Meas value of zero.  They
  692. probably are not.  Run TestTime some time later and see if the relationship
  693. between the clocks has changed; there's a good chance that it will have. 
  694. Which, if either, is correct?  Notice also that the Meas value flops around
  695. several hundredths of a second; this is due to the 0.055 second standard DOS
  696. clock resolution.  Try these things with RighTime installed and see the
  697. difference for yourself.  If RighTime is doing its job, you should see that
  698. Appl and Meas are essentially the same value - the former is the cause, and
  699. the latter is the effect.
  700.  
  701.  
  702.  
  703.                                   TestIncr
  704.  
  705.       TestIncr measures and displays the difference between one unique DOS
  706. clock time and the next.  With RighTime running normally, this value should
  707. always be 0.01 second.  Without Rightime running or when the 0.01 DOS clock
  708. mode is disabled [/TH], the value will average about 0.0549 second.  TestIncr
  709. is for disbelievers.
  710.  
  711.  
  712.  
  713.                                   ViewCMOS
  714.  
  715.       ViewCMOS displays the content of the CMOS RAM.  It can be useful to the
  716. adventurous RighTime user who is searching for an available area in which to
  717. store the corrections.  Be warned once again, though, that it is not easy to
  718. identify such a space.  Further, even if many zeros appear to suggest that an
  719. area is unused, remember that zero is a perfectly valid number that might be
  720. significant to the BIOS, and that, even if available, the entire CMOS RAM
  721. might be checksummed.  A bad checksum will result from any changes that are
  722. not brought about by the BIOS itself.  The next boot might fail, forcing you
  723. into Setup.
  724.  
  725.       On systems that contain additional CMOS RAM that is addressed like PS/2
  726. MCA CMOS (the 386SL, for example), its presence is indicated.  The
  727. full-screen display can be switched from conventional CMOS RAM to the
  728. MCA-type CMOS RAM contents.
  729.  
  730.  
  731.  
  732.                                   RighTLog
  733.  
  734.       If RighTime is run with logging enabled [/G], file RighTime.Log will be
  735. present in the directory from which RighTime is run.  RighTLog will display
  736. this binary file.  Each time-related activity will be logged.
  737.  
  738.       The most important of the log's indications is the source of each time
  739. and date set.  If a time or date set is present whose source you do not
  740. recognize, it is likely that the time is being set by a program that has no
  741. business doing so.  These sets will disturb RighTime's learning and can
  742. compromise the accuracy of the system clocks.  As discussed above, these
  743. errant time and date sets must be ignored with RighTime's /I switch.
  744.  
  745.       Each timeset log entry also notes the percentage of time since the last
  746. timeset that the system was warm.  If this value is much smaller than you
  747. think it should be, RighTime might not have been active when you thought it
  748. should have been.  The most common cause of this is using a /M switch that
  749. monitors a communication port whose DCD is stuck active.  You might need to
  750. make "&C1" a default for your Hayes-compatible modem by doing the following:
  751.  
  752.       from within a communications program (ProComm, QModem, Telix, etc.),
  753.  
  754.             Type ATZ and press Enter      [you should get an OK]
  755.             Type AT&C1&W and press Enter  [you should get an OK]
  756.  
  757.       This will initialize your modem to the required DCD mode at power up
  758.       and, unless changed, each time "ATZ" is sent to the modem. 
  759.       Communication programs can change it, though; if you continue to have
  760.       this problem, you'll need to do some more study.
  761.  
  762.       /GA will also log each CMOS RTC adjustment.  These entries can become
  763. annoyingly numerous if the warm correction value is large.  /GA is not
  764. normally required.
  765.  
  766.  
  767.  
  768.                              Command Line Syntax
  769.  
  770.       RighTime must be executed in the AUTOEXEC.BAT (or a batch file called
  771. by it) so that it becomes a resident extension of DOS.  Most of the 28
  772. options available can be expressed at this initial resident invocation. 
  773. RighTime can also be run as a transient program at the DOS prompt to change
  774. modes or to report on its current status.  A smaller number of options are
  775. effective in the transient execution.  Each option listed below indicates
  776. when - resident or transient or both - it can be used.  The options are not
  777. case sensitive (either /f or /F will work) and space between options is not
  778. required.  There must be no space between an option switch and its associated
  779. parameter.
  780.  
  781.       RighTime    [/F[M|R]|/R[[M]n]|/N] [/Un] [/W[n]] [/C[n]] [/Dn] [/L0]
  782.                   [/In] [/G[A]] [/K|/T[H|D|A]|/E] [/Mn] [/A] [/Sn] [/Yn]
  783.                   [/On] [/Xn] [/Hn] [/Q] [/V0]
  784.  
  785.       Storage:    /F=File[com|cor] /R=cmosRam[[Mca]addr] /N=None /Umin=Update
  786.       Correction: /W[Warm] /C[Cool] /Dmin=warmupDelay /L0=noLearn
  787.       State:      /Inum=Ignoreset /K=Kill /T=Tempdisable[Hund|Dos|All]
  788.                   /E=Enable
  789.                   /Mport=comport(s) /A=autoseAsonchange /Sdays=autotimeSet
  790.       Other:      /G=log[All] /Ohunds=Offset /Xhours=eXtrapweight
  791.                   /V0=notVerbose /Ycolor=forceansi.Sys /Hbytes=stacklengtH
  792.                   /Q=Quiet,noselftest 
  793.  
  794. where:
  795.  
  796.       /A    Automatic Daylight/Standard time change.  Implements the American
  797.             standard biannual one hour adjustments at 0200 local time on the
  798.             first April and the last October Sundays whether the machine is
  799.             running or not.  If RighTime is running, there will be no
  800.             detrimental effects caused by the time change.  If the machine is
  801.             not running, the time change will shift the time-since-last-time-
  802.             set by one hour which will, in turn, have an effect upon the next
  803.             time set's learning.  The error will normally be small and will
  804.             diminish with subsequent time sets.  The Dallas Semiconductor
  805.             DS1287 and DS12887 and Motorola's MCCS146818B1M properly
  806.             implement the time change rule as do most modern brand name
  807.             chipset-based machines, but many machines are supplied with the
  808.             Motorola MC146818P or its equivalent even today.  Although they
  809.             might have been manufactured as late as mid-1991, these parts
  810.             will misbehave in April, advancing the clock on the last Sunday
  811.             (which was the convention prior to 1986).  Some modern
  812.             chipset-based machines will not change at all.
  813.             [Applicable in resident invocation only.]
  814.  
  815.       /Cn   Sets the initial cool correction rate.
  816.             (default 0, maximum +327.67 or -327.68).
  817.             [Resident only]
  818.  
  819.       /Dn   Changes the cool adjust period allowance (after boot) from the 30
  820.             minute default.  The valid range is 0 to 60.  Consider this
  821.             option if your system exhibits a large difference in warm and
  822.             cool corrections and cabinet temperature is suspect, or if you
  823.             need to disable cool correction.
  824.  
  825.             /D0   Disabled cool correction.  Applies the warm correction
  826.                   value at all times and learns only a warm correction value
  827.                   from observed error.  This is useful to users who never
  828.                   shut down their systems or who switch to and from other
  829.                   operating systems that cannot run RighTime.
  830.  
  831.             [Resident only]
  832.  
  833.       /E    Reenables all temporarily disabled RighTime functions.
  834.             [Transient only]
  835.  
  836.       /F (or /FM) Directs RighTime to store corrections in and retrieve 
  837.                   corrections from its own program file.
  838.  
  839.             /FR   Directs RighTime to store correction factors in
  840.                   RIGHTIME.COR, a data file that will be created in
  841.                   RighTime's directory.
  842.  
  843.             [Resident only]
  844.  
  845.       /G    Activity logging.  Creates and maintains a comprehensive file of
  846.             all user and program time-related activities.  It produces a
  847.             binary file, RighTime.Log, which is displayable with program
  848.             RighTLog.  This is an informative and valuable diagnostic tool.
  849.  
  850.              /GA  Includes routine one-second CMOS clock adjustments.  On a
  851.                   machine whose warm correction is large, these will be
  852.                   frequent and will clutter the log.
  853.  
  854.             [Resident only]
  855.  
  856.       /Hn   Internal stack length.  The default is 160 bytes; valid range is
  857.             64 to 1024 bytes.  Since RighTime is an operating system
  858.             extension, its stacks might be used by other programs for brief
  859.             periods.  RighTime reports on current internal stack usage. 
  860.             Following a system crash, when RighTime is restarted it will
  861.             report on the stack usage prior to the crash (/F and extended
  862.             CMOS /R, only).  If the crash was due to insufficient stack
  863.             space, this parameter value must be increased.  There is no
  864.             relationship between this option and the STACKS command in
  865.             Config.Sys.  [The /H switch of RighTime version 1.1 (for DR DOS
  866.             5.0) is no longer available, but a similar effect can be achieved
  867.             by using /O-3.]
  868.             [Resident only]
  869.  
  870.       /In   Ignore time and date sets, semi-permanently (/I-1, restored via
  871.             /I0) or for a specific count (e.g. /I2) to prevent the spurious
  872.             time and date sets of GEOS (America Online users take note),
  873.             several Norton utilities, games and other facilities from
  874.             confusing RighTime's learning and to allow time comparison
  875.             without setting.
  876.             [Resident or transient]
  877.  
  878.       /K    Terminates (kills) RighTime function.  The memory that is
  879.             occupied by RighTime remains allocated and unavailable.
  880.             [Transient only]
  881.  
  882.       /L0   Disables learning.  The program ignores errors at time set and
  883.             applies fixed corrections.  This is useful to programs that reset
  884.             the DOS clock and use it as an event timer.
  885.             [Resident only]
  886.  
  887.       /Mn   Directs RighTime to suspend all functions (except time and date
  888.             set and read processes) while the specified communications port
  889.             indicates that DCD (Carrier Detect) is active.  n may be any of
  890.             1 through 4, corresponding to COM1 through COM4.  This option
  891.             prevents RighTime from potentially interfering with high-speed
  892.             communications functions; it is usually only required for modem
  893.             speeds of 9600 bps and above.  Normal function will resume when
  894.             communications activity ceases.  PROPER DCD CONTROL REQUIRES THAT
  895.             &C1 BE PART OF THE ACTIVE HAYES-COMPATIBLE MODEM INITIALIZATION
  896.             STRING.  Several /M switches may be specified; for example, a
  897.             system with both COM1 and COM2 high-speed modems installed would
  898.             have /M1 /M2 specified in RighTime's invocation.  /M0 disables
  899.             DCD monitoring until the next /M invocation.  Microsoft Windows
  900.             might erroneously report that a communications port is in
  901.             contention when a /M switch is used; this can be avoided by
  902.             clicking on Control Panel, then 386-Enhanced, selecting the Never
  903.             Warn button for each affected port, then OK.
  904.             [Resident or transient]
  905.  
  906.       /N    Disables correction storage.  Learned corrections will be lost at
  907.             shutdown and there will be no cool correction possible.
  908.             [Resident only]
  909.  
  910.       /On   Offset allows DOS clock trim in seconds.  Default is 0; the
  911.             valid range is -90.00 to +90.00.  This can be used to anticipate
  912.             relay and contactor actuation delays and motor start times in
  913.             process control system applications;
  914.             [Resident only]
  915.  
  916.       /Q    Defeats self testing and quiets minor status messages.
  917.             [Resident or transient]
  918.  
  919.       /Rn   Directs RighTime to store corrections in CMOS RAM.
  920.  
  921.             /Raddr directs RighTime to store corrections in CMOS RAM.  The
  922.             default address is 63, but it is increasingly unlikely that this
  923.             will be a usable address; the address can range to 127.  The
  924.             specified location is that of the last of 12 bytes for the
  925.             default address, or the last of 22 bytes for any other location. 
  926.             Using the default will not provide full features and is
  927.             maintained for compatibility with earlier RighTime versions. 
  928.             This option is potentially harmful, since a careless value might
  929.             allow RighTime to overwrite setup data.  Inadvertently changing
  930.             a hard disk type, for example, can lead to sadness.  Be careful.
  931.  
  932.             /RMaddr will place the corrections in MCA-type CMOS RAM.  There
  933.             is no default: an address must be specified.  The specified
  934.             location is that of the last of 22 bytes.  The valid address
  935.             range is 22 to 127 for 82360SL-type CMOS RAM and 274 to 2047 for
  936.             PS/2 MCA-type CMOS RAM.
  937.  
  938.             [Resident only]
  939.  
  940.       /Sn   Changes the period that must elapse since the last timeset before
  941.             RighTime will set the corresponding program termination code. 
  942.             The termination code can be tested with the IF ERRORLEVEL command
  943.             in a batch file.  If this switch is not expressed, the default
  944.             period is 28 days.  If more than the specified period has elapsed
  945.             since the last time set, RighTime will terminate with ERRORLEVEL
  946.             set to 1.
  947.             [Resident or transient]
  948.  
  949.       /T    Temporarily disables RighTime functions.
  950.  
  951.             /TH         disables 0.01 second DOS clock maintenance.
  952.             /TD or /T   disables DOS clock maintenance.  CMOS clock
  953.                         maintenance continues.  This mode can persist
  954.                         indefinitely.
  955.             /TA         disables all RighTime functions (including logging)
  956.                         and reports the maximum safe disabled duration.
  957.  
  958.             These disabled modes can be reenabled with /E.
  959.  
  960.             [Resident or transient]
  961.  
  962.       /Un   Changes the CMOS RAM or disk file update period from the two
  963.             minute default.  The valid range is 2 to 60, and the value must
  964.             be even.  If you think the default is unnecessarily frequent, you
  965.             can decrease it by increasing this value.  Remember that this is
  966.             part of the cool correction process, and less frequency might
  967.             affect correction accuracy in severe situations.
  968.             [Resident only]
  969.  
  970.       /V0   Non-verbose.  No screen output will be generated (including error
  971.             messages).  Available to registered users only.
  972.             [Resident or transient]
  973.  
  974.       /Wn   Sets the initial warm correction rate in seconds per day
  975.             (default 0, maximum +327.67 or -327.68)
  976.             [Resident only]
  977.  
  978.       /Xn   Sets the error extrapolation weighting threshold.  This can
  979.             desensitize RighTime's learning by decreasing the significance of
  980.             the observed error from any time set whose previous time set was
  981.             less than n hours ago by a linear factor (e.g. for the 4-hour
  982.             default, the observed error from the second of two timesets that
  983.             are one hour apart is considered only 0.25 significant), range 1
  984.             to 72 hours.
  985.             [Resident only]
  986.  
  987.       /Yn   Forces data highlighting if a non-standard ANSI.SYS is
  988.             undetectable or if colors other than the white-on-black default
  989.             are desired.  n is normally a two-digit value whose first digit
  990.             represents the background color, while the second digit
  991.             determines the foreground color.  Standard ANSI color numbers are
  992.             expected:
  993.  
  994.                   0=Black     4=Blue
  995.                   1=Red       5=Magenta
  996.                   2=Green     6=Cyan
  997.                   3=Yellow    7=White
  998.  
  999.             White-on-red, for example, results from /Y17.  To force the
  1000.             default on a non-standard ANSI driver, use /Y07 or simply /Y7. 
  1001.  
  1002.             /Y0   Automatic significant data highlighting (if ANSI.SYS is
  1003.                   present) is defeated with /Y0.  To produce a text file of
  1004.                   RighTime's report without ANSI sequences, use /Y0,
  1005.                   redirected to disk.
  1006.  
  1007.             [Resident or transient]
  1008.  
  1009.       /?    On screen help memory jogger.  This is automatically produced if
  1010.             the command line contains a syntax error.
  1011.             [Resident or transient]
  1012.  
  1013.  
  1014.  
  1015.       A sophisticated AUTOEXEC.BAT invocation of RighTime might be:
  1016.  
  1017.       C:\RT2\RighTime /G /FR /D0 /U20 /S7 /A /M1 /Y57 > C:\RT2\RIGHTIME.RPT
  1018.       IF ERRORLEVEL 255 ECHO "** Trouble with RighTime load **"
  1019.       IF ERRORLEVEL 1 TIMESET [in automatic configuration]
  1020.       .
  1021.       .
  1022.       .
  1023.       TYPE C:\RT2\RIGHTIME.RPT
  1024.  
  1025.  
  1026.  
  1027.                                  Errorlevels
  1028.  
  1029.       RighTime provides four unique termination ERRORLEVELs.  The ERRORLEVEL
  1030. value can be tested in a batch file to guide subsequent operations.
  1031.  
  1032.       Code value  Indication
  1033.  
  1034.             0     Installed normally, cool correction within range, last
  1035.                   timeset within specified elapsed period.
  1036.  
  1037.             1     Installed, cool correction within range, but more than 
  1038.                   the specified period has elapsed since a timeset.
  1039.  
  1040.             2     Installed, but cool correction was out of range (the
  1041.                   system has been inactive too long), so a timeset is
  1042.                   externally required.
  1043.  
  1044.           255     Not installed due to syntax error, insufficient memory, 
  1045.                   incompatible hardware, etc.
  1046.  
  1047.       These codes can be tested in a batch file with the IF ERRORLEVEL
  1048. command.  For example, if the ERRORLEVEL value code is 1, then more than 28
  1049. days have elapsed since the last timeset (this duration can be changed with
  1050. the /S option).  It would be wise to have a NIST telephone service time
  1051. setting program such as TimeSet automatically set the time in this situation
  1052. to prevent RighTime from exceeding its one month limit, or you could cause
  1053. execution of the system DATE and TIME commands to urge the user to set them
  1054. manually.  
  1055.  
  1056.  
  1057.  
  1058.                              If You Have Trouble
  1059.  
  1060.       Please note the symptoms and circumstances as thoroughly as is
  1061. reasonably possible and contact
  1062.  
  1063.       Tom Becker
  1064.       Air System Technologies, Inc.
  1065.       14232 Marsh Lane, Suite 339
  1066.       Dallas, Texas  75234-3899  USA
  1067.  
  1068.       BBS:        214/869-2780
  1069.       Fax:        214/869-1166
  1070.       CompuServe:   76436,3210
  1071.       Telephone:  214/402-9660
  1072.                         Software License Agreement
  1073.  
  1074.       When you register, this will be the agreement between you (the user)
  1075. and Air System Technologies to which both parties are bound upon the payment
  1076. and acceptance of the license fee, which is part of the registration fee.
  1077.  
  1078.       Grant of License
  1079.       In consideration of the payment of each license fee by the user to Air
  1080. System Technologies, Air System Technologies will license to the user a
  1081. nonexclusive right to use one copy of each of the software programs on one
  1082. computer at a time.  The license is expressly for program use only, per the
  1083. terms of the license.  No other rights are implied.
  1084.  
  1085.       Ownership of Software
  1086.       Air System Technologies is the owner of the software programs and holds
  1087. full title to them.  The user may own the physical media on which the
  1088. software programs are recorded, including the original disk which is provided
  1089. by Air System Technologies to the user, but the user does not own the
  1090. software programs nor any copy of the software programs.
  1091.  
  1092.       Copies
  1093.       The software programs and the documentation are copyrighted and
  1094. therefore may not be copied without permission.  Permission is granted to the
  1095. licensed user to make copies of the software programs and the documentation
  1096. as required in the conventional course of computer system data backup. 
  1097. Permission is granted to copy the shareware distribution file in its
  1098. complete, unmodified form.  No other permission to copy is granted.
  1099.  
  1100.       Use and Transfer
  1101.       The Grant of License applies only to one copy of each of the software
  1102. programs.  Simultaneously functional resident copies of the software programs
  1103. each require licensing.  You may not transfer any copy (except the shareware
  1104. evaluation distribution file) of the software programs to a computer which is
  1105. not under your control, nor may you rent, lease, sell or otherwise assign
  1106. control of the software programs to anyone.
  1107.  
  1108.       Termination
  1109.       The license is in effect until it is terminated.  When the license is
  1110. terminated, the user's rights that are granted by the license are revoked. 
  1111. The license is automatically terminated without notice upon violation of any
  1112. of its terms.
  1113.  
  1114.       Disclaimer of Warranty
  1115.       No warranty of performance or suitability is expressed or implied. 
  1116. Every effort has been made to make the software programs deliver as the
  1117. documentation describes, but the correctness for your application or
  1118. environment cannot be assured.  Air System Technologies cannot assume
  1119. responsibility for the failure of the software programs, nor for any
  1120. consequence of their use.
  1121.  
  1122.  
  1123.       RighTime Use Registration Form       RighTime Evaluation Version 2.53
  1124.  
  1125.       Fill out this form, enclose the required funds and mail to:
  1126.  
  1127.       Air System Technologies, Inc.
  1128.       14232 Marsh Lane, Suite 339
  1129.       Dallas, Texas  75234-3899  USA
  1130.  
  1131.  
  1132.       I would like to register the use of RighTime.
  1133.  
  1134.  
  1135.       Name:________________________________________________________________
  1136.  
  1137.       Business name:_______________________________________________________
  1138.  
  1139.       Address:_____________________________________________________________
  1140.  
  1141.               _____________________________________________________________
  1142.  
  1143.       City:______________________________ State:_________ Zip:_____________
  1144.  
  1145.       Telephone:_________________________
  1146.  
  1147.  
  1148.       Where did you get RighTime?__________________________________________
  1149.  
  1150.  
  1151.       Registration is required for each copy of RighTime that is
  1152.       simultaneously machine resident.
  1153.  
  1154.       The registration fee is US$ 40.00 each up to 10 copies.  Call for
  1155.       larger quantity pricing. 
  1156.  
  1157.  
  1158.       How many copies of the RighTime package do you want?_________________
  1159.  
  1160.       On what media?  5.25"/360K______  3.5"/720K______
  1161.  
  1162.  
  1163.       Total enclosed:  US$____________
  1164.  
  1165.       Make your check or money order payable to Air System Technologies.
  1166.  
  1167.       Does your business require an invoice?____________
  1168.  
  1169.  
  1170.                                  Thank You!
  1171.