TsetPops Routines -- Copyright 1995 Life Sciences Software

           TsetAuto   -- Pops up TsetTSR for automatic dialing
           TsetManual -- Pops up TsetTSR for manual operation
           TsetClock  -- Pops up TsetTSR's digital time display
        BBtoDosUpdate -- Update DOS from B&B clock (RighTime learning on)
 BBtoDosUpdateNoLearn -- Update DOS from B&B clock (RighTime learning off)

 These five routines, designed to be CALLed from other programs, poke 
 specific values into safe memory locations to cause TimeSet-TSR (tm) (the 
 memory-resident version of TimeSet) to pop up.  What TimeSet-TSR does after 
 it pops up depends on which subroutine was CALLed, as discussed below:
 
 1. Calling syntax: CALL TsetManual 
    
    TimeSet-TSR pops up and waits for keyboard input to initiate dialing or 
    perform other tasks.  Control is returned to the CALLing program by 
    pressing the ESC key in TimeSet-TSR. 

 2. Calling syntax: CALL TsetAuto
    
    TimeSet-TSR pops up and starts dialing a time service immediately.  
    Control is automatically returned to the CALLing program after the 
    phone call is completed and the clock is set. 
 
 3. Calling syntax: CALL TsetClock

    TimeSet-TSR's large digital running time display is invoked. Pressing
    the Page Up key brings full TimeSet-TSR functions for manual operation. 
    Any other key returns user to CALLing program.

    The following two routines are useful only if the B&B Real Time Clock 
    card and Air System Technologies' RighTime (TM) clock regulator software 
    are both used.  If both those conditions exist, it is recommended that 
    Life Sciences Software's driver RTCDRIVE.COM for the B&B clock be 
    installed instead of B&B's PCRTCDD.SYS driver. RTCDRIVE.COM must be 
    loaded ahead of RighTime in the AUTOEXEC.BAT file or in the CONFIG.SYS 
    file (using the INSTALL command).  Unlike B&B's driver PCRTCDD.SYS, 
    which updates the DOS clock every minute, RTCDRIVE.COM will trigger 
    TimeSet-TSR to update the DOS clock at user-selected intervals ranging 
    from 1 to 12 hours.  The longer update intervals give RighTime an 
    opportunity to learn the DOS clock drift rate and apply micro-corrections 
    throughout the day for maximum accuracy.
 
 
 4. Calling syntax: CALL BBtoDosUpdate
    
    If the B&B Electronics Real Time Clock card is installed in the computer, 
    this routine causes TimeSet-TSR to pop up, transfer time from the B&B 
    clock to the DOS clock, then pop down again.  If RighTime is installed, 
    its correction value can be affected by the clock set; that is, it's
    allowed to revise its correction if the difference between B&B time and 
    the old DOS time was significant.  
    
 5. Calling syntax: CALL BBtoDosUpdateNoLearn
    
    This is similar to the BBtoDosUpdate call (see 4, above), except that 
    RighTime's learning feature is temporarily disabled until this DOS clock 
    update from the B&B clock is completed.  This avoids any alteration of 
    RighTime's daily correction value. (This CALL is equivalent to pressing 
    the Ctrl-Alt-F8 hot keys when TimeSet-TSR is memory resident.)
 
 Programmers are welcome to incorporate these CALL procedures into their own 
 code. TSETPOPS.OBJ containing these assembled routines is included in the 
 TimeSet-TSR package for LINKing to your programs.  The source code is in
 TSETPOPS.ASM.  Use of these CALLs in a BASIC program is illustrated in
 POPDEMO.BAS and in POPDEMO.COM.

