home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / INFO / SYSUTL / TSRWRK32.ZIP / WORKTSRS.DOC < prev   
Encoding:
Text File  |  1989-06-01  |  7.9 KB  |  196 lines
  1.         WorkTSRs Documentation
  2.  
  3. IntroDuction:
  4.     It was humbling to learn that TSRwrk was uploaded to
  5.     CompuServe about the same time as the Version 2.8 of
  6.     TurboPower Software's TSRCOM.  This was particularly
  7.     so when a GROSS programming error became apparent in
  8.     UnMark that had been attributed to incompatibility
  9.     between the two systems.  The ASM replacements for
  10.     Pascal programs should NOT have been so different
  11.     since they were only written as exercises.  Even if
  12.     preference, such as being able to scroll the MAPMEM
  13.     data, produces a major change as with ShowTSRs vs
  14.     MAPMEM, the two systems should have been able to
  15.     work side-by-side.  MEA CULPA...
  16.  
  17.     TSRw31 is now placed in the public domain with the
  18.     same purposes as was TSRwrk.  The programs are for
  19.     user education with especial emphasis on stimulating
  20.     interest in programming.  Any OR ALL TSRw31 programs
  21.     may be used by anyone who finds them advantageous.
  22.  
  23.     It is still the case that Tom Gilbert's Heart & Mind
  24.     disclaims responsibility for damages from any use or
  25.     experimentation with these programs.  There is also
  26.     an acknowledgment and a reservation.
  27.  
  28. Acknowledgement:
  29.     Kim Kokkonen of TurboPower Software is the designer
  30.     of the MARK - RELEASE system.  Both the glory and
  31.     the leadership in its development belong to him.
  32.     Do NOT use WorkTSRs unless you first become familiar
  33.     with that system.  After Absorbing the documentation
  34.     and trying the Version 2.8 of the above programs,
  35.     try these alternatives and examine their source code
  36.     with the motivation of becoming a better informed
  37.     user.
  38.  
  39. Reservation:
  40.     WorkTSRs' programs are NOT intended for the "passive
  41.     user".  They are provided with source code because
  42.     they are for users who "take charge".  Any comments
  43.     or suggestions that help Tom Gilbert's Heart & Mind
  44.     to learn and grow will be welcomed. If you use your
  45.     computer like a TV set, on the other hand, and don't
  46.     like the programs, just don't use them.
  47.  
  48. WorkTSRs is an all assembly language replacement for a series of
  49. programs written by TurboPower Software to manage Terminate but
  50. Stay Resident programs.  Because TurboPower Software is in the
  51. business of providing Turbo-Pascal utilities, their six major
  52. management programs were written in the Pascal language.  The
  53. assembly language replacements were written as exercises.  They
  54. are placed in the public domain for educational purposes.  Use
  55. the WorkTSRs if you prefer them; but, the credit for this TSR
  56. management system belongs to Kim Kokkonen and The TurboPower
  57. Software company.  Some TSRCOM ASM programs were also rewritten.
  58.  
  59. FreeRAM  -   differs from RAMFREE only in that it uses the CHKDSK
  60.     algorithm and places a comma between the thousands
  61.     and hundreds places.  Rick Housh finds its report to
  62.     be more accurate on his system.  Take your choice.
  63.  
  64.         WorkTSRs Documentation            Page  1
  65.  
  66.  
  67. Mark.COM - Placing a MARK TSR before other TSRs that you
  68.     load allows TSR removal without making a "hole"
  69.     in memory or losing the INTerrupt chain.  The
  70.     WorkTSRs Mark releases its environment block to
  71.     be used by subsequently loaded programs.  When
  72.     used with the WorkTSRs Watch, there will be NO
  73.     spurious INTerrupt Vectors associated with it.
  74.     The Mark is simply a data area.  Actually, Mark
  75.     is obsolete.  Even the so-called advantage of
  76.     "Protected!" marks is eliminated by the use of
  77.     File Marks.  File Marks or the MarkNet counter-
  78.     part for networks stored in a RAM disk directory
  79.     dedicated to Marks is the best of all methods.
  80.  
  81. FMark.COM - The FMark and its replacement program reduce the
  82.     memory used by storing the Mark data in a File.
  83.     FMark means FileMark and is more efficient.
  84.  
  85. MarkNet - has been left to TurboPower along with its RelNet
  86.     RELEASE counterpart until we start using networks.
  87.  
  88. DeviceS - shows we are thinking about it.  See DeviceS.Doc...
  89.  
  90. UnMark.COM  - is the replacement for the RELEASE.EXE program.
  91.     It is more efficient but has different options.
  92.     Enter UnMark ? or /? or use >TYPE UnMark.COM to
  93.     see them.  The /Keep and /EMS left alone RELEASE
  94.     options are not used because the first panders to
  95.     user laziness and the second is a "kludge" for
  96.     inadequate EMS systems.  The /R option is for use
  97.     with DOUBLEDOS and /D can be used when you want
  98.     to see the blocks.  The /S(tuff keyboard buffer)
  99.     with a command is limited to the 15 Character PC
  100.     design INCLUDING Carriage Return.  Put BAT files
  101.     in your path vs "d:\bat\filename" <- TOO LONG.
  102.  
  103. ReMark.COM - is the replacement for the DISABLE.EXE program.
  104.     It returns a zero ERRORLEVEL when the status is
  105.     as desired so that batch processing can continue
  106.     and ERRORLEVELs of 1, 2 or 3 depending on what is
  107.     wrong IF the batch file SHOULD terminate.  If an
  108.     invalid TSR Name or PSP is entered, for example,
  109.     the ERRORLEVEL is 2.  No Watch installed returns
  110.     1 and No Room in Watch returns 3.  The / options
  111.     can be /D to DisAble or /A to Activate after the
  112.     TSR has been DisAbled.  A valid Name/PSP returns
  113.     the current status with no "/" option.  When you
  114.     call ReMark with NO Command Line it gives HELP.
  115.  
  116. Watch.COM - was added to the TurboPower system to permit the
  117.     DISABLE program to make a TSR inactive while it
  118.     remains in memory.  It is essential that Watch
  119.     be loaded before any TSR that you will disable.
  120.     The replacement does NOT capture INT 16h but
  121.     uses a different means to avoid reinstallations.
  122.     Its data area is kept clear for ease should you
  123.     wish to examine the ChangeBlocks.  As TSRs are
  124.     added, removed or made inactive, Watch is kept
  125.     up to date.  ShowTSRs uses it to know ALL the
  126.     interrupts which a TSR has captured.  In my
  127.     opinion, Watch is the best part of the system.
  128.     Watch.COM Version 3.1 releases its environment.
  129.  
  130.         WorkTSRs Documentation            Page  2
  131.  
  132.  
  133.  
  134. ShowTSRs.EXE - has replaced MapMem.EXE.  The WorkTSRs series
  135.     began with a desire to be able to scroll the
  136.     MapMem data.  The experience of translating
  137.     Pascal to assembly language for that project
  138.     induced a desire to replace RELEASE and DISABLE
  139.     as well.
  140.  
  141.     ShowTSRs was upgraded to Version 3.1 in order to
  142.     accommodate the LoadTSRs system described below.
  143.     It displays a "LoadTSR" line when MenuTSRs has
  144.     been installed.
  145.  
  146.     The source code has been streamlined.  There is
  147.     less parameter passing by stack frame.  Efforts
  148.     to improve the English in comments and the HELP
  149.     message were extensive.  Testing the ShareWare
  150.     Command.Com replacement, "4DOS" forced improved
  151.     programming techniques.  The environment is now
  152.     searched "top-down" for the "owner" name and the
  153.     MCBs are now fully sorted.  4DOS is recommended.
  154.  
  155. MenuTSRs.EXE - is a program that will display all .COM files in
  156.     a TSRdir directory.  It allows you to select one
  157.     from the menu including any parameters writing a
  158.     Load2TSR.BAT file with each of your selections.
  159.     When you have finished choosing TSRs to LOAD or
  160.     UpDate, the program exits.  MenuTSRs is invoked
  161.     from a TSRmenu.BAT file.  When it returns to the
  162.     TSRmenu.BAT file without error, the TSRmenu.BAT
  163.     file "chains" to the Load2TSR.BAT file that was
  164.     created by MenuTSRs.  Load2TSR.BAT calls on DOS
  165.     to FMark and LOAD or UpDate the chosen TSRs.  A
  166.     final KillLoad.BAT file is "chained" at the end
  167.     of Load2TSR.BAT to delete it from the directory
  168.     where it was created.  Be sure to read LoadTSRs
  169.     .DOC before trying to use the system.  Whether
  170.     this system is useful to you or not is your own
  171.     choice.  Again, any "power user" will profit by
  172.     studying the concept.  Don't bother to complain
  173.     about it; but, I'm interested in any changes to
  174.     enhance or improve it.
  175.  
  176. TSRmenu.BAT - has 6 lines.  See LoadTSRs.DOC
  177.  
  178. KillLoad.BAT - has 4 lines.  See LoadTSRs.DOC
  179.  
  180. Load2TSR.BAT - is created by MenuTSRs.EXE and therefore is NOT
  181.     included in TSRw31.ZIP  Again, see LoadTSRs.DOC
  182.  
  183.     Any comments or suggestions regarding the
  184.     WorkTSRs series of programs should go to:
  185.  
  186.         Tom Gilbert's Heart and Mind
  187.         7127 Lafayette Avenue
  188.         Kansas City, KS 66109
  189.         Phone: (913)299-2701
  190.  
  191.  
  192.     Compuserve Contact:
  193.  
  194.         Rick Housh
  195.         CIS PIN 72466,212
  196.