Power-Programmierung/CD1.mdf/pascal/library/dos/teseract/doc/ver110.doc

Text File | 1988-10-02 | 9.1 KB | 442 lines

                               TesSeRact(TM)


        A Library of Routines for Developing Ram-Resident Programs

                                    and

        A Proposed Standard for Ram-Resident Program Communication


                   Documentation Update for Version 1.10
                              October 2, 1988


              Copyright (c) 1988, TesSeRact Development Team
                            All Rights Reserved


             _______
        ____|__     |               (TM)
     --|       |    |-------------------
       |   ____|__  |  Association of
       |  |       |_|  Shareware
       |__|   o   |    Professionals
     -----|   |   |---------------------
          |___|___|    MEMBER




                             Table of Contents


     Chapter 1.  Introduction........................................2
          Order Form.................................................3
     Chapter 2.  New TesSeRact Library Routine.......................4
          TsRestore2F................................................4
     Chapter 3.  New TesSeRact Multiplex Functions...................5
          TSR Utility Routines.......................................5
               Trigger PopUp (Function 22h)..........................5
               Trigger Background (Function 23h).....................6
     Chapter 4.  Changes to TesSeRact................................7













                                    -1-





                         Chapter 1.  Introduction

This file  contains necessary  update information  for Version  1.10 of the
TesSeRact Library.   Two  new Interrupt  2Fh Multiplex  Functions have been
added, and one additional TesSeRact Library routine has also been added.

In addition,  this document  also contains  a listing  of all bugs/problems
repaired since Version 1.00 of the library.

Finally, please note our new address:

  TesSeRact Development Team
  1657 The Fairways
  Suite 101
  Jenkintown, PA 19046

  Phone: [phone]
  CIS: 70731,20
  MCI: 315-5415
  FAX: [phone]





































                                    -2-









            TesSeRact(TM) Products Order And Registration Form


     Registration Number:     ____________________________

     Name:          ______________________________________

     Address:       ______________________________________

                    ______________________________________

     City:          ______________________________________

     State:         __________________________ Zip: ______

     Telephone:     ______________________________________

     Item                                      Quantity      Total
     --------------------------------------------------------------
     Registered User Upgrade ($10)_______________________|_________
        (to Version 1.10)
     Upgrade for Registrations after 9/15/88_____________|____0.00_
     TesSeRact Registration ($25 each)___________________|_________
     TesSeRact Source Code License ($25 each)____________|_________
     TesSeRact Trial Disk ($10)__________________________|_________
     Monthly Information NewsLetter______________________|_________
        ($10 per year)
     Product Identification String (Free!!)______________|____0.00_
     Your ID String: ______________ Product Name: ______________

     Shipping Charges:     Upgrade Order        Normal Registration
                          U.S.  :  $ 0.00         U.S.  :  $ 0.00
                          Canada:  $ 5.00         Canada:  $10.00
                          Europe:  $10.00         Europe:  $15.00
     Overnight:  $15.00 + Normal Shipping Charge (from above)
     Total Shipping Charges______________________________|_________
     --------------------------------------------------------------
     Total Due:                                          |_________

     Preferred Disk Size:  3.5" ____  5.25" ____

     Where did you hear about TesSeRact? __________________________
     Primary Language/Compiler: ___________________________________

     Mail Completed Form to:
                    TesSeRact Development Team
                    1657 The Fairways
                    Suite 101
                    Jenkintown, PA 19046




                                    -3-





                 Chapter 2.  New TesSeRact Library Routine

TsRestore2F -- Restore Interrupt 2Fh to original state

  This  function   should  be   called  by   any  program   that   calls
     TsCheckResident() and DOES NOT REMAIN RESIDENT.  Call this function
     BEFORE EXITING THE PROGRAM to ensure that the Interrupt 2Fh handler
     is set to its original default value of 00 00, if necessary.  It is
     not  necessary   to  call   this  routine  if  your  program  calls
     TsDoInit(), or  if your program does not call the TsCheckResident()
     library routine.

  Parameters:
     None.

  Returns:
     None.

  C Language Usage:

  extern void far TsRestore2F(void);

  Pascal Usage:

  procedure TsRestore2F;

  Assembler Usage:

  EXTRN    TSRESTORE2F:NEAR

     call  TSRESTORE2F
  ;
  ; NOTE:  AX, BX and ES registers destroyed
  ;























                                    -4-





               Chapter 3.  New TesSeRact Multiplex Functions


                           TSR Utility Routines



Trigger PopUp (Function 22h)

  This function  hass been added to permit an application to 'trigger' a
     POPUP procedure.   When this call is completed, the TSR will pop up
     at the  earliest opportunity,  just as  if the  TsrStatus flags had
     been manipulated  directly.   TsrMain() will  be called  (if it  is
     save) as  soon as possible, or a TsrBeep() procedure will be called
     to signal the TSR is unable to popup.

  Parameters:
     TsrIdNum.................Identification Number of TSR to call

  Returns:
     Non-Zero -- Unable to pass pointer -- invalid ID Number
     Zero -- Success

  C Language Usage:

  extern unsigned far pascal TsTriggerPop(
     unsigned short TsrIdNum
     );

  Pascal Usage:

  function TsTriggerPop(
     TsrIdNum : word
     ) : word;

  Assembler Usage:

     mov   ax,5453h
     mov   bx,22h
     mov   cx,TsrIdNum
     int   2fh
  ;
  ;  result returned in AX
  ;













                                    -5-





Trigger Background (Function 23h)

  This function  allows  a  program  to  directly  call  the  background
     procedures if it is safe for the background procedure to be called.
     PLEASE USE  CAUTION WHEN  CALLING THIS  FUNCTION!!  It will allow a
     background procedure  to be  called when  INDOS is  set to  1.  The
     purpose  of   this  function   is  to  allow  network  programs  to
     independently signal an idle status.

  Parameters:
     TsrIdNum.................Identification Number of TSR to call

  Returns:
     Non-Zero -- Unable to pass pointer -- invalid ID Number
     FFFFh -- Not safe to call Background procedure
     Zero -- Success

  C Language Usage:

  extern unsigned far pascal TsTriggerBack(
     unsigned short TsrIdNum
     );

  Pascal Usage:

  function TsTriggerBack(
     TsrIdNum : word
     ) : word;

  Assembler Usage:

     mov   ax,5453h
     mov   bx,23h
     mov   cx,TsrIdNum
     int   2fh
  ;
  ;  result returned in AX
  ;



















                                    -6-





                     Chapter 4.  Changes to TesSeRact

Critical Error Flag pointer now works correctly under OS/2 1.0.

Add check for DOS 4.0.

TsSetAdrTP4 now returns with the correct RET instruction.

TempParms data area reduced to correct size.

INT 21h 'gate' array must fall on EVEN boundary in Turbo Pascal versions.

Check to make sure stacks are set on EVEN boundaries.

Modified TESSDEMO to work better with MSC.

Added Turbo Pascal 5.0 source/unit.

Move EXTRN  for user  procedures outside  simplified CODE statement so they
can be called in large-model programs.

Change code for INT 16h, Fn 0 to get around XTREE bug that checks the FLAGS
register.

Force DOS to use AUXSTACK on INT 21h, Fn 0-12 if popped up from DOS command
line.  'C' programmers can now use getch().

Added TsTriggerPop and TsTriggerBack.

Added internal function _TESSBACKGROUND to check if safe to call background
procedure.

Added TsRestore2F() function; call this internally before releasing TSR!!

Fixed problem with popping up over INT 8






















                                    -7-