home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilss / spool / !Spool / !Help next >
Encoding:
Text File  |  1995-02-06  |  8.8 KB  |  266 lines
  1. Instructions for !Spool by Andrew Sellors
  2.  
  3. *****************************************************************************
  4. * NOTE:                                                                     *
  5. * !Spool is FreeWare.                                                       *
  6. * This means that you may freely copy and distribute it, provided that it   *
  7. * is complete with all original files, and that you do not sell it.         *
  8. * PD libraries may charge a nominal fee for the cost of duplication,        *
  9. * postage etc.                                                              *
  10. * In no circumstances shall the author be liable for any damage, loss of    *
  11. * profits, time or data or any indirect or consequential loss rising out of *
  12. * the use of this software or inability to use this software.               *
  13. *****************************************************************************
  14.  
  15. Contents:
  16. ---------
  17.  
  18. Aims
  19. Features
  20. Before you start!
  21. Compatibility
  22. Problems
  23. Operation
  24. Iconbar menu
  25. "Spool Configuration" window
  26. "Sending File" window
  27. Buffers
  28. Setting the 3D bit
  29. Contacting the author
  30.  
  31. ********************************************************************************
  32.  
  33. Aims:
  34. -----
  35.  
  36. This program spools files in the background in the Desktop to either the serial
  37. or parallel ports.
  38.  
  39. ********************************************************************************
  40.  
  41. Features:
  42. ---------
  43.  
  44. Uses 3D bit in CMOS RAM to select 2D or 3D windows _and_ iconsprites on startup.
  45. (See the "Setting the 3D bit" section if you don't like 2D windows)
  46.  
  47. Uses Block Drivers so it can use serial ports other than the internal one.
  48.  
  49. Provides full control over the serial port used.
  50.  
  51. Can send a sequence of files one after another.
  52.  
  53. ********************************************************************************
  54.  
  55. Before you start!:
  56. ------------------
  57.  
  58. Before you can use this program you need the Block Drivers by Hugo Fiennes.
  59. If you don't have them then download them now! or look at your favourite
  60. PD library.
  61.  
  62. ********************************************************************************
  63.  
  64. Compatibility:
  65. --------------
  66.  
  67. This program is for RISC OS 3.10 or later.
  68. It has been tested on both RISC OS 3.10 and RISC OS 3.50 and with the internal
  69. port using Block Drivers v10a.
  70.  
  71. ********************************************************************************
  72.  
  73. Problems:
  74. ---------
  75.  
  76. If you have run !Printers and then run !Spool the error "Unable to use parallel
  77. port: Can't open 'devices#buffer3:$.Parallel'" will be seen and !Spool will not
  78. be able to use the parallel port. This is because !Printers opens the parallel
  79. port device for output and does not close it when quitted. The only way to
  80. enable !Spool to use the parallel port is to reset the machine.
  81.  
  82. ********************************************************************************
  83.  
  84. Operation:
  85. ----------
  86.  
  87. When the !Spool icon is double-clicked, it installs itself on the left of the
  88. icon bar with the configured Block Driver loaded. If the !SerialDev application
  89. that holds the Block Drivers has not been seen by the Filer then an error is
  90. reported and the program does not start up.
  91.  
  92. Dragging a file to the icon will cause it to be sent to the selected destination
  93. and a status window showing the progress displayed.
  94.  
  95. Dragging a file to the icon when a file is already sending causes it to be
  96. queued, the total number of files show in the status window will increace.
  97.  
  98. Dragging a selection of files to the icon will result in all the file being send
  99. to the selected destination port.
  100.  
  101. ********************************************************************************
  102.  
  103. Iconbar menu:
  104. -------------
  105.  
  106.    +--------------+
  107.    |    Spool     |
  108.    +--------------+
  109.    | Info    ⇨    | ⇨ opens "About this program" window
  110.    | Configure... | Opens "Spool Configuration" window
  111.    | Quit         | Quits program.
  112.    +--------------+
  113.  
  114. ********************************************************************************
  115.  
  116. "Spool Configuration" window:
  117. -----------------------------
  118.  
  119. This allows the serial port, destination of the file and filebuffer size to be
  120. setup.
  121.  
  122. Any changes made only take effect when either "Change" or "Save" are selected.
  123.  
  124.  
  125. "Serial Port" group:
  126.  
  127. The "Driver Name" pop-up menu allows you to change the Block Driver used.
  128. When a new driver is selected, the driver is scanned to find the baud rates
  129. and ports supported, and the relevant menus changed accordingly.
  130.  
  131. Clicking on "Rescan Drivers" rechecks the available Block Drivers and updates
  132. the list of drivers for the "Driver Name" menu. This can be used to update
  133. the list if any drivers have been added since the program was started.
  134.  
  135. The "Port Number" pop-up menu allows the serial port to be configured as
  136. some drivers support more than one serial port, the internal driver has only
  137. one port: 0.
  138.  
  139. The other menus are fairly self explanatory, these should be set to the same
  140. as the device that is connected to the serial port.
  141.  
  142.  
  143. "Destination" group:
  144.  
  145. This allows the destination of the file to be selected between either the
  146. serial or parallel ports.
  147. When !Spool cannot claim the parallel port for use, the icon will be greyed
  148. out.
  149.  
  150.  
  151. "Transfer" group:
  152.  
  153. The "Buffer Size" writeable icon allows the size of the filebuffer to be
  154. changed. This is the amount of memory that is claimed when a transfer is
  155. initiated (and released when finished) to be used to buffer the disc access.
  156. The file being transferred is read in chunks of the buffer size, so a larger
  157. size will reduce the disc access at the expense of more memory being used
  158. at transfer time.
  159.  
  160.  
  161. Clicking on "Change" makes any changes made take effect and removes the window
  162. from the screen. If adjust is used instead of select then the window is left
  163. on screen.
  164.  
  165. Clicking on "Cancel" throws away any changes made and removes the window from
  166. the screen.
  167.  
  168. Clicking on "Save" makes any changes made take effect and the saves the
  169. configuration to disc to be used the next time the program is loaded. If
  170. adjust is used instead of select then the window is left on screen.
  171.  
  172. ********************************************************************************
  173.  
  174. "Sending File" window:
  175. ----------------------
  176.  
  177. This window is displayed in the bottom left corner of the screen when a file
  178. is being sent. It shows the filename of the current file being sent, the amount
  179. of data transfered so far and the total ammount of data for that particular
  180. file. It also shows the total number of files in the queue and the number of
  181. the current file being sent.
  182.  
  183. The "Abort" icon stops all sending operations.
  184.  
  185. The "Skip" icon stops the current file from being sent and moves the program on
  186. to the next file in the queue if there is one. 
  187.  
  188. ********************************************************************************
  189.  
  190. Buffers:
  191. --------
  192.  
  193. Increasing the size of the printer buffer from its default size of 1K will
  194. improve the speed at which data is sent to the parallel port, and so reduce
  195. printing time.
  196.  
  197. The size of the printer buffer is shown by:
  198. *Status PrinterBufferSize
  199.  
  200. I recommend a size of at least 16K which is achieved by
  201. *Configure PrinterBufferSize 16K
  202.  
  203. Note: This amount is actually allocated in units of pages of memory so
  204. depending on the type of machine and the amount of memory fitted the value
  205. actually allocated could be higher.
  206.  
  207.  
  208. Increacing the size of the serial output buffer also increases the speed at
  209. which data can be sent to the serial port as the normal buffer is very small,
  210. only 191 bytes. This can be done by loading a module such as SerialBuff by
  211. David Pilling.
  212.  
  213. ********************************************************************************
  214.  
  215. Setting the 3D bit:
  216. -------------------
  217.  
  218. If you want to use the 3D windows in this program (and the handful of others
  219. that support it) then you need to set the 3D bit in the CMOS RAM. In RISC OS 
  220. there is no *configure command to change it so you can either:
  221.  
  222.    Use !DeskCtrl (another program I have written, well worth getting and
  223.                   hopefully released soon on the Acorn User coverdisc)
  224.  
  225.    OR
  226.  
  227.    By cutting out the following BASIC program and running it.
  228.    Note: this program toggles the bit, so if its off and you run it twice then
  229.          it is still off!
  230.  
  231.     10REM Toggle state of '3D look' bit in CMOS
  232.     20REM Read byte
  233.     30SYS "OS_Byte",161,140 TO ,,byte%
  234.     40REM EOR byte with mask for bit 0
  235.     50byte% = byte% EOR 1
  236.     60REM Write byte back again
  237.     70SYS "OS_Byte",162,140,byte%
  238.     80END
  239.  
  240.     OR
  241.  
  242.     If you have a RiscPC then it will probably be on, otherwise you will have
  243.     to then turn off "2D window tools" in the "Window Manager" part of
  244.     !Configure.
  245.     
  246. ********************************************************************************
  247.  
  248. Contacting the author
  249. --------------------
  250.  
  251. I, Andrew Sellors, can be contacted either at
  252.    57 Boundaries Road
  253.    Feltham
  254.    Middlesex
  255.    TW13 5DR
  256.  
  257. Or via Internet email at
  258.    k946949@king.ac.uk
  259.  
  260. Any feedback from users (bugs reports, requests for new features, praise,
  261. money etc.) is gladly received. 
  262.  
  263.  
  264.  
  265.  
  266.