home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / BEEHIVE / TESERACT / TESS-025.ZIP / SP.DOC < prev    next >
Text File  |  1989-01-22  |  10KB  |  282 lines
  1.  
  2.                         SP: A PRINT SPOOLER
  3.                     for the IBM Personal Computer
  4.                             Version 3.6
  5.  
  6.                       Copyright Alan Jones 1983
  7.                          3717 Wildwood Drive
  8.                           Endwell, NY 13760
  9.                            (607) 754-2339
  10.                           January 29, 1984
  11.  
  12.  
  13. SP is a software printer buffer to hold data intended for the printer.
  14. It works like the buffers that can be installed in the printer but the
  15. data is stored in RAM storage instead of in the printer.  The buffer
  16. is unloaded to the printer at the printer's speed while DOS proceeds
  17. at its speed.  The size of the buffer is specified as a parameter when
  18. SP is invoked.  For example,
  19.  
  20.             SP 14
  21.  
  22. will produce a buffer of 14K (1K = 1024 bytes).
  23.  
  24. The complete syntax is:
  25.  
  26.      SP [ss] [C=cc] [P=pp]
  27.  
  28. where:
  29.  
  30.         ss: size of buffer in kilobytes.  One kilobyte = 1024 bytes.
  31.  
  32.         cc: number of copies desired.
  33.  
  34.         pp: printer port desired (1, 2, or 3).
  35.  
  36. NOTE: You do not type the square brackets.  They merely indicate that the
  37. contents are optional.  For example, if you want to use printer port 2 with
  38. a buffer size of 20 KB, you would enter:
  39.  
  40.         SP 20 P=2
  41.  
  42. If you want to keep the previous buffer and only change the number of
  43. copies to 3 copies, enter:
  44.  
  45.         SP C=3
  46.  
  47. For the "C" and "P" you can enter either upper or lower case characters.
  48.  
  49. If the size parameter is omitted, a default buffer of 16K is used.
  50.  
  51. The program will work for all work sent to the printer whether it is from
  52. the DOS TYPE command, a PrtSc command, a BASIC LLIST or LPRINT command, a
  53. print command from EasyWriter 1.1, etc.
  54.  
  55. If you start a printout and decide you don't want it, turn the printer
  56. off and then back on.  This will re-set the buffer.
  57.  
  58. If you want the printing to pause, hold down the ON LINE button until
  59. the printer stops (which it will do at the end of a line).  Pressing
  60. the ON LINE button again will allow printing to resume with no loss of
  61. data.
  62.  
  63. You can remove SP from the machine by specifying a buffer of zero.
  64. That is:
  65.  
  66.       SP 0
  67.  
  68. will return DOS to it's original state.
  69.  
  70. You can change the size of the buffer by re-invoking SP with the new
  71. parameter.  In this case, SP determines that there is already a copy
  72. present in the machine and just alters the size of the buffer of the
  73. older copy.  (This feature not available for DOS 2.0.  However, you can
  74. remove SP and then re-invoke it to get a different buffer size.)
  75.  
  76. MULTIPLE COPIES
  77.  
  78. SP creates multiple copies, when requested, by starting from the beginning
  79. of the buffer when the buffer empties.  If you have an application that is
  80. slower than the printer, the printer may get ahead of the data you are
  81. sending it and conclude that it is time to start the second copy.
  82. Therefore, the multiple copy capability is only of use where you can fill
  83. the buffer reasonable fast.
  84.  
  85.  
  86. SPC:  A PRINT SPOOLER for use with communications.
  87.  
  88. The program SP will not work well with communications due to the fact that
  89. SP takes over the computer for periods of time that causes received
  90. characters to be occasionally lost.  If you want to use SP with
  91. communications, invoke the program SPC instead.  This program works
  92. slightly differently than SP.  It speeds up the internal timer by a factor
  93. of 32 and then prints only one character on each timer tick.  While this
  94. will allow you to co-exist with communication programs, it causes a slight
  95. problem with BASICA and compiled BASIC.  In these environments, a BEEP or
  96. use of the PLAY command will cause strange sound effects and the printer
  97. will stop momentarily.
  98.  
  99. CAVEATS:
  100.  
  101. When using with VisiCalc, do not specify a buffer larger than 23K with DOS
  102. 1.1 or 10K with DOS 2.0 since VisiCalc will not load (it cannot cross a 64K
  103. boundary during loading.)
  104.  
  105. There is a problem when using SP with the Personal Editor Version 1.0 on
  106. some occasions when quiting a file.  This has turned out to be a problem in
  107. PE.  To patch PE:  On a scratch disk, rename a copy of PE.EXE to XX and
  108. DEBUG XX.  Type E DS:56E7 and change 6 bytes of code to hex 90 by typing 90
  109. and pressing the space bar 6 times.  The previous contents of those bytes
  110. should be C7 06 56 EF 00 00.  Then use the debug command W (write) to write
  111. the file back out.  Then Q (quit) to leave DEBUG and rename XX back to
  112. PE.EXE.
  113.  
  114. When using it in some environments such as EasyWriter, there may be
  115. commands that allow you to stop the printer.  However, when SP is present,
  116. the program will be way ahead of the printer and will only stop sending
  117. data to the buffer.  In cases like this, turn off the printer and then turn
  118. back on again to stop printing.
  119.  
  120. GRAPHICS ON PRINTER:  If you send graphics commands to an IBM or Epson
  121. printer with GRAFTRAX-80, GRAFTRAX-PLUS, or the IBM Printer-2 the printer
  122. will slow down.  This is due to the fact that the printer must be presented
  123. with the graphics information as fast as it can absorb it.
  124.  
  125. OPERATING ENVIRONMENTS
  126.  
  127. SP has been tested in the following environments:
  128.  
  129.    PrtSc command                   WordStar
  130.    DOS TYPE to printer             EasyWriter 1.1
  131.    BASIC LLIST                     VisiCalc
  132.    BASIC LPRINT                    With Communications
  133.    BASIC PRINT#                    The Personal Editor
  134.    Lotus 1-2-3                     Multiplan
  135.    PC-FILE                         PC-TALK
  136.  
  137. And with the following printers:
  138.  
  139.    IBM Printer and Printer-2       TI-800
  140.    C. Itoh PROWRITER               Okidata
  141.    Epson MX-80 or MX-80 F/T        NEC 7730
  142.  
  143. AVAILABILITY
  144.  
  145. Available from Alan Jones under the "user supported software" concept
  146. promoted by Jim Button.  See below.
  147.  
  148. COPYING
  149.  
  150. SP can be copied onto one of your own diskettes for use on your machine.
  151. In fact we recommend including it in your AUTOEXEC's so that it is always
  152. invoked.
  153.  
  154. DISCLAIMER.
  155.  
  156. In no event will the Author be liable to you for any damages, including any
  157. lost profits, lost savings or other incidental or consequential damages
  158. arising out of the use of or inability to use these programs, even if the
  159. Author has been advised of the possibility of such damages, or for any
  160. claim by any other party.
  161.  
  162. PERMISSION TO COPY:
  163.  
  164. Clubs and other non-profit organizations are granted permission by the
  165. author to freely copy these programs and documentation and share it with
  166. their members, so long as:
  167.  
  168. 1.  No price is charged for the software or documentation.  However, a
  169.     distribution cost may be charged for the cost of the diskette, so long
  170.     as it is not more than $10 total.
  171.  
  172. 2.  Club members are informed of the user-supported concept and encouraged
  173.     to support it with their donations.
  174.  
  175. 3.  The program or documentation are not modified in any way and are
  176.     distributed together.
  177.  
  178.  
  179. THE USER-SUPPORTED CONCEPT.
  180.  
  181.                         User-Supported Software
  182.        If you are using this program and find it to be of value
  183.                 your contribution will be appreciated.
  184.                           ($15 is suggested)
  185.  
  186.                             Alan Jones
  187.                          3717 Wildwood Drive
  188.                           Endwell, NY 13760
  189.  
  190.             Regardless of whether you make a contribution,
  191.           you are encouraged to copy and share this program.
  192.  
  193.  
  194.  
  195. User-supported software is an experiment in distributing computer
  196. programs, based on these beliefs:
  197.  
  198. 1.  That the value and utility of software is best assessed by the
  199.     user on his/her own system.
  200.  
  201. 2.  That the creation of personal computer software can and should
  202.     be supported by the computing community.
  203.  
  204. 3.  That copying of programs should be encouraged, rather than
  205.     restricted.
  206.  
  207. Anyone may request a copy of a user-supported program by sending a
  208. blank, formatted disk to the author of the program.  An addressed,
  209. postage-paid return mailer must accompany the disk (no exceptions,
  210. please). A copy of the program, with documentation on the disk,
  211. will be sent by return mail.  The program will carry a notice
  212. suggesting a contribution to the program's author.  Making a
  213. contribution is completely voluntary on the part of each user.
  214.  
  215. Free distribution of software and voluntary payment for its use
  216. eliminates costs for advertising and copy protection schemes.
  217.  
  218. Users obtain quality software at reduced cost. They can try it out
  219. before buying, and do so at their own pace and in the comfort of
  220. their own home or office.  The best programs will survive, based
  221. purely on their quality and usefulness.
  222.  
  223. Please join the experiment.
  224.  
  225. If you believe in these ideals, your contribution is solicited to
  226. help make them work.
  227.  
  228.  
  229.  
  230.  
  231.  
  232. Many of you have written requesting an invoice so that you could initiate
  233. payment through your company accounting system.  The following invoice is
  234. provided for those of you in this category, or for those who wish an
  235. invoice for your tax records.  Perhaps it will serve the purpose.
  236.  
  237.  
  238.  
  239.                        --------------------
  240.                               INVOICE
  241.                        --------------------
  242.  
  243.  
  244.  
  245.  
  246.    Purchased from:
  247.        ALAN JONES
  248.        3717 Wildwood Drive
  249.        Endwell, NY 13760
  250.  
  251.  
  252.   DATE:     /     /                           Invoice No. 831201
  253.   --------------------------------------------------------------
  254.                                        PRICE     PRICE
  255.   PRODUCT                    QTY       EACH      EXTENDED
  256.   -------------------------  ---       -----     --------
  257.  
  258.   SP: A Print Spooler
  259.     program and
  260.     documentation             1         $15         $15
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.                                       SALES TAX      0
  268.  
  269.                           --------------------------------------
  270.                           PLEASE PAY THIS AMOUNT    $15    TOTAL
  271.   --------------------------------------------------------------
  272.  
  273.  
  274.  
  275. Please make check payable to :ALAN JONES
  276.  
  277.  
  278. You may retain this Invoice
  279. for your tax records.
  280.  
  281.  
  282.