home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / misc / gold03.lzh / GF_003 / SPOOL / README < prev    next >
Text File  |  1991-04-28  |  4KB  |  74 lines
  1. read-me: Simultaneous Peripheral Operation OLine
  2.  
  3. *** This is version 1.2 of the SPOOL system, updated December 25th, 1986!!! *
  4.  
  5. This is the documentation to the SPOOL system described in Ami Project
  6. Magazine, Volume 1, issue #5. For more complete information on how it works,
  7. rush on down to your nearest purveyor of high-quality Amiga publications.
  8.  
  9. DISTRIBUTION: Copyright (C) 1986, by Tim Holloway. This system may be freely
  10. distributed for non-commercial use by any means, as long as this and all
  11. other copyright notices are not removed.  These rights may not be abridged
  12. or modified in any way except by written permission of the author.
  13.  
  14. DESCRIPTION: The SPOOL system consists of 3 programs: A queue manager,
  15. a printer driver, and a SPOOL request program.  The queue manager can
  16. driver multiple printers simultaneously, however present versions of
  17. AmigaDOS only support one system printer, so other printers would have
  18. to be driven as non-ANSI devices (unless they're ANSI printers!).  To
  19. actually run the system, you need programs SPOOL, SPOOLER, and PRTSPOOL,
  20. as well as the SPOOL.go startup file.  To start SPOOLING, execute SPOOL.go.
  21. Try the AmigaDOS STATUS command and see what happens.  Whenever you wish to
  22. print a file or files, use the command:
  23.  
  24.     SPOOL file1 [file2] [file3] [...]
  25.  
  26. The names of the files will be placed in a queue.  As soon as a printer
  27. becomes idle, it will request another filename, open the file, and print
  28. it.  The only limit to the queue size is available memory.  To flush
  29. the queues and stop SPOOLing:
  30.  
  31.     SPOOL -shutdown
  32.  
  33. There is at present no provision to interrupt a print request in progress.
  34. Type carefully, then - SPOOLing a non-text file could be messy - the only
  35. way to abort an unwanted request is to deselect the printer, finish any
  36. other tasks in the system and reboot (so what did you expect, for free?).
  37.  
  38. BUGS:  There's always one more, so they say.  This version corrects a bug
  39. in the original Ami Project article where the memory occupied by queued
  40. filenames was not released.  There's probably more, especially since logic
  41. was modified so that PRTSPOOL and SPOOLER do all their talking through
  42. Intuition rather than stdout and stderr.  The "dates.c" file should provide
  43. laughs for years, particularly at the end of February.  Any and all help
  44. with this function will be VERY gratefully accepted.
  45.  
  46. MORE BUGS: Using earlier versions of this system, PRTSPOOL was prone to
  47. refuse to print perfectly legitimate files, saying that they weren't found.
  48. That's because the search for files whose higher-level directories were
  49. not explicitly given was mad based on PRTSPOOL's current directory, rather
  50. than SPOOL's.  SPOOL now calls ExpandPath to get the true pathname.
  51.  
  52. N.B.: The pathname.c, gripe.c and dates.c files are general-purpose functions
  53. which you can use in any programs you see fit.  Permission is granted to
  54. include them into commercial programs as well.
  55.  
  56. The SPOOL system demonstrates the power of the Amiga's mutitasking abilities
  57. in a very practical way.  It makes extensive use of Amiga Exec's message
  58. passing facilities and list-handling primitives, and is extremely flexible,
  59. both in its present form and in the ease in which it may be extended to
  60. provide all the functionality of a minicomputer or even mainframe SPOOLing
  61. system on a "home" computer.  Hopefully, you will find this system useful
  62. and even inspirational (let me know what kinds of improvements you come up
  63. with).
  64.  
  65.                                    Tim Holloway
  66.  
  67.             CIS 73026,2026
  68.             BIX tholloway
  69.  
  70.             And always,
  71.             Casa Mi AMiga: Fidonet 112/1 (904) 733-4515
  72.  
  73. Enjoy!
  74.