



                                   D_T.PRG
                                  D_T_E.PRG



                        documentation dec, 25. 1992




 program by Hinnerk Rmenapf
 (C) 1987 - 1992 HWR

 *Pentagramm Software Braunschweig
 Thomas Birke                                           Hinnerk Rmenapf
 Billrothstr. 31                                        Ottweilerstr. 18
 3300 Braunschweig                                      W-3300 Braunschweig
 -----------------

 GERMANY


 This software may be used by everyone who gives a (FREE) copy to anyone,
 who might want to use it.

 This software may be copied only if all (UNCHANGED) files are included:

        German version
                - D_T.PRG
                - D_T.TXT
                
        English version
                - D_T_E.PRG
                - D_T_E.TXT
                

 ALL RIGHTS RESERVED, I'm only letting you use it.

 There is absolutely NO WARRANTY whatsoever.
 


 What's the use ?
 ----------------

 A program for all ATARI ST -useres whose computers have no hardware-clock.
 


 Installation
 ------------

 Copy D_T_E.PRG (or, if you prefer the german version, D_T.PRG) into the
 AUTO-folder on your boot-drive.


 What does it do ?
 -----------------

 There are (at least) two clocks in your ST, one can be accessed via GEMDOS
 the other via XBIOS.
 
 The GEMDOS-clock is (almost) pure software. At system start (reset) it is set
 to midnight and the date of the TOS-version.
 The XBIOS accesses either the 'intelligent' keyboard (260, 520, 1040,...) or 
 battery powered hardware clock (MEGA ST[E], ...) (If you ST has such a
 hardware-clock, you don't need this program). The keyboard-processor clock
 keeps running until the power is switched off.
 
 So, after a reset the XBIOS-time stands a good chance of being correct.
 

 First a definition of three conditions :
        A) Is the current Date equal to the TOS-version date ?
        B) Is the day 0 ?
        C) Is the month 0 ?

If at least one of these conditions (A-C) is fullfilled, the date is called
invalid (B and C were only defined because my keyboard-processor always 
sets the date to 00.00.28 after power up). 


  1. First the GEMDOS-date is checked. If it is valid the program
     displays date and time and then exits.

  2. If the GEMDOS-date is invalid, the XBIOS-date is being tested.
     If the XBIOS-date is valid, GEMDOS time and date are set to XBIOS
     time and date, a message, time and date is displayed, and then
     the programm exits.
  
  3. If the XBIOS-date is invalid the program asks you to enter date and time.

     You can make the program ask for time and date by holding down the RIGHT
     SHIFT key at program start.
 
     First , you are asked to enter the current date, format MMDDYY.
     That means two figues for the month, two figues for the day and two
     figues for the year.

     EXAMPLES:
        Feb.  3. 1991    =>      020391
        Dec. 25. 1992    =>      122592

     After that you're asked the enter the current time, format HHMM.
     You've guessed it, two figures for the hour and two figures for the
     minutes. 

     EXAMPLES:
        5 past 9am       =>      0905
       25 past 2pm       =>      1425
       10 past midnight  =>      0010


     The input can be cleared with ESC, BACKSPACE and DELETE work as usual.


 dokumentation by Hinnerk Rmenapf

>> broken english spoken perfectly
>> to err is human, to forgive divine

+++
