home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / at / atnudg2.arc / ATCLOCK.DOC < prev   
Text File  |  1988-12-04  |  7KB  |  183 lines
  1.  
  2.                                              ATCLOCK - Documentation Page 1
  3.  
  4.  
  5.     ATCLOCK.DOC - Description for program ATCLOCK.COM
  6.     This description was last updated 4 Dec. 1988. See last paragraph.
  7.  
  8.     This program provides three basic functions for AT computers and
  9.     compatibles:
  10.  
  11.     1. The CMOS clock is set to the current DOS clock time and date.
  12.  
  13.     2. Once per day, both the CMOS and DOS clocks can be 'nudged' by
  14.        a preset amount.  The amount of nudge is scaled up if the computer
  15.        is not turned on for several days.
  16.  
  17.     3. The program will adjust both system clocks forward or back one
  18.        hour for changes between standard and daylight time, if desired.
  19.  
  20.  
  21.     To use the program:
  22.  
  23.     Put the program ATCLOCK.COM ( or whatever you rename it to ) in the
  24.     directory where you intend to use it. This is necessary because the
  25.     program creates a file called 'TODAY.AT' in the directory in which
  26.     it resides. Note this is not necessarily the directory from which it
  27.     is run.
  28.  
  29.     Set the DOS clock to the correct time and date if needed, using the
  30.     DOS TIME and/or DATE commands.
  31.  
  32.     Run the program by typing "ATCLOCK/S" or "ATCLOCK/D" for standard or
  33.     daylight time.  Standard is used if no "/" command is entered.
  34.     (Do not type the quotation marks.)
  35.  
  36.     It's not necessary to use the "/S" or "/D" commands after the program
  37.     has been run once.  Atclock will note the setting in it's date file.
  38.     On the other hand, it won't hurt anything if you enter the same command
  39.     each time the program is run.
  40.  
  41.     The program will create it's file when run for the first time.  It
  42.     will re-write the file (TODAY.AT) any time it is run again on a new
  43.     day, or if you change parameters.
  44.  
  45.  
  46.     To adjust your clock with the 'nudge' feature:
  47.  
  48.     Run the program with the command ATCLOCK /Nxx, where xx is the amount
  49.     to adjust the clock each day.  This value is in DOS clock tick counts.
  50.     There are 18.2 (approx) ticks per second.  This value will then be
  51.     used to adjust the clock each day until it is reset.
  52.  
  53.     Examples:
  54.     Adjust the clock forward by 5 seconds each day:  ATCLOCK /N91
  55.     Adjust the clock backward by 2 seconds each day: ATCLOCK /N-36
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                              ATCLOCK - Documentation Page 2
  65.  
  66.  
  67.     To change from daylight to standard time:
  68.  
  69.     Run the program with ATCLOCK /S, after the clock has been set using
  70.     daylight time.  You will receive a prompt as follows:
  71.       "Do you want to set the clock back one hour for standard time?"
  72.     Enter Y to make the change, N to leave the clock where it is.  In
  73.     either case, the new time is recorded as standard.
  74.  
  75.     Changing to daylight is done the same way with the "/D" option.
  76.  
  77.     You can combine the /D or /S commmand with the /N command to set a new
  78.     nudge value at the same time.  Entering /S when the clock is already on
  79.     standard time will have no effect.  Note that you can't use this option
  80.     until you have run the program at least once so it knows which time you
  81.     are using.
  82.  
  83.     AtClock has one more command - The "/1" says to nudge the clock by one
  84.     day's nudge value (at most), regardless of the number of days that have
  85.     passed since the last time it was run.  This is for anyone who has the
  86.     older version of the program, which always worked this way.
  87.  
  88.  
  89.  
  90.  
  91.  
  92.     This program is Copyright T. McGuire.  It is entirely my own invention.
  93.     The program is free of charge, and no restrictions are placed on it's
  94.     use.  It is not guaranteed to do anything specific.  It also has no
  95.     "look and feel" that I can find.
  96.  
  97.     References used were the IBM PC-AT technical reference for the Bios
  98.     calls, PC-DOS 3.1 manual for the DOS calls.  The program was assembled
  99.     with Masm 5.1.
  100.  
  101.     The author can be reached for comments on CompuServe, IBMHW or via
  102.     Easyplex, PPN 73210,2531.
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.     Some details:
  114.  
  115.     The program writes the current date in the file TODAY.AT, along with
  116.     the specified 'nudge' value.  It also writes a D or S after the date
  117.     for daylight or standard time.  When run, it will read the file and
  118.     compare the date to the DOS date to find out if it is a new day. If
  119.     it is a new day, the number of days that have passed since the last run
  120.     are calculated.  If there is a non-zero nudge value, the DOS clock is
  121.     adjusted by the amount specified times the number of days passed.
  122.     In any case, the CMOS clock is set to the current time of the DOS
  123.     clock at the end of the program.
  124.  
  125.  
  126.  
  127.                                              ATCLOCK - Documentation Page 3
  128.  
  129.  
  130.  
  131.     The program converts the date from DOS to a Julian date to compare with
  132.     the previous date.  The Julian date is also saved in the date file,
  133.     along with the date in Ascii.
  134.  
  135.     If a "/S" or "/D" command is given, and it doesn't match the value in
  136.     the date file, you are prompted for changing the clock by one hour, as
  137.     mentioned above.
  138.  
  139.     If the clock is adjusted, a message is displayed to that effect.
  140.     The current time and date are always displayed.
  141.  
  142.     The program is intended to be run from an Autoexec file. It will then
  143.     keep the CMOS clock adjusted properly if run once per day. Running it
  144.     more than once will not cause any further adjustments.  If you haven't
  145.     turned on your computer in a few days, the adjustment is multiplied.
  146.  
  147.     The program can also be used to set the CMOS clock to the DOS clock
  148.     after you have entered the correct time/date to the DOS clock.  If you
  149.     change between standard and daylight via DOS, or replace your clock
  150.     battery, remember to run Atclock after setting the DOS clock.  It's
  151.     much easier than the Setup program!
  152.  
  153.     The data file TODAY.AT is an Ascii file that can be examined with a
  154.     word processor or other utility program, or TYPEd, PRINTed, etc.
  155.     The file is of the form:
  156.          Tue 01 Mar 1988 S****880306+0018
  157.     The last value is the 'nudge' value that was last selected (0 if
  158.     none selected). If you forget what you have set, you can examine
  159.     the file to find out.
  160.  
  161.     The "S****" represents Standard time, with 4 bytes of binary data for
  162.     the year and Julian date.
  163.  
  164.     Deleting the data file will have the same effect as setting the
  165.     'nudge' value to zero and the time to standard.
  166.  
  167.     The archive file includes assembly language source code for the main
  168.     portion of the program.  Some utility functions are performed by
  169.     programs in the library file 'Asmutils', which is also included.  The
  170.     header file 'Asmutils.asi' must be accessible to assemble the program.
  171.  
  172.     If you want to modify the program, it should be linked with the
  173.     ASMUTILS library after re-assembling.
  174.  
  175.     The program was assembled with MASM rev. 5.1. It does use some
  176.     assembler features that are new with this version.  The program
  177.     contains some 80286 instructions, so can not run on PCs or XTs.
  178.     It also requires DOS 3.0 or later.
  179.  
  180.     This version is a 1 byte change to the earlier version dated
  181.     7 Sept. 1988 to fix a bug when adjusting the clock between 23:00
  182.     and midnight.
  183.