home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 3: The Continuation / 17-Bit_The_Continuation_Disc.iso / amigan / amigan 17 / printspooler / manual.doc < prev    next >
Encoding:
Text File  |  1994-01-27  |  7.0 KB  |  160 lines
  1.                                 User's  Guide
  2.                                 Print Spooler
  3.                 The AmigaDOS Background Print Spooling System
  4.  
  5.  
  6. Introduction
  7.  
  8.  The Amiga family of super personal computers from Commodore-Amiga are basically
  9. wonderful systems. Here at 4SC, we've used Amigas for two and a half years.
  10. There was one thing that always bugged us, though. Every time we wanted to print
  11. a file out, we had to enter a command such as "Run Copy filename to PRT:", then
  12. had to wait until that file was done printing before we could print another one.
  13. So, the boss said, "My programmers, thou shalt devise and build for me a Print
  14. Spooler, so that I may print files to my heart's content." Well, we did it, and
  15. here it is!
  16.  
  17.   The package consists of two programs. The first program is simply called
  18. "Print". Its job is to submit files to the print queue and to report the print
  19. queue's status to the user. The second program is called "Spooler", and is
  20. designed to be run from the AmigaDOS CLI as a background task (by using the
  21. "Run" command). It actually prints out the files in the print queue.
  22.  
  23.   These programs are being released as "ShareWare", meaning that we don't ask
  24. for money up front. Use the programs, and if you feel that they are useful to
  25. you, send us a small stipend. The gremlins here at 4SC think that $25.00 U.S. is
  26. adequate. If you think that's too much, well, OK. Just send us what you think is
  27. appropriate. In either case, our address is:
  28.  
  29.  Small Scale Systems of Southern California 10447-1 Larwin Avenue Chatsworth,
  30. CA 91311 United States of America
  31.  
  32.   Heck, you can even snd us complaints or comments if you wish. Of course,
  33. compliments are always welcome!
  34.  
  35.  
  36. Installation
  37.  
  38.   Installing the system is a fairly straight forward, two-step process:
  39.  
  40. Step 1:  Copy the two programs to your "C:" directory (or a directory which is
  41. on your executable path).
  42.  
  43. Step 2:  Modify your  Startup-Sequence file  to include the following two lines:
  44.  
  45.          Assign SPOOL: <directory of your choice>
  46.          Run Spooler
  47.  
  48.   The first line associates the SPOOL: device with a directory of your choice.
  49. This directory is where Print puts the printer queue data file, and where
  50. Spooler expects to find it. An ideal place is in the RAM: device, so the command
  51. would be:
  52.  
  53.          Assign SPOOL: RAM:
  54.  
  55.   The second line runs the print spooling program as a background task. Once
  56. Spooler is running as a task, you never need to worry about it. It stays there
  57. forever. You can, of course, get out of it by using the Status command to see
  58. which task Spooler is, then use the BREAK command to halt the program. After a
  59. few seconds (maybe 15 or so), AmigaDOS will display a requester. Click on the
  60. ABORT gadget, and Spooler goes bye-bye!
  61.  
  62.   That's it! You've installed the print spooler system for your next reboot!
  63. If you want to use it now, just enter the following two lines at the CLI prompt
  64. and you're off:
  65.  
  66.       Assign SPOOL: RAM:
  67.       Run Spooler 2        [We dunno where that "2" came from. The original
  68.                             file of this doc was 136 columns wide, formatted,
  69.                             full of carriage returns and ^Ls. We reformatted
  70.                             it to 80 columns, took the CRs out, and MAY have
  71.                             left the "2" from one of them goddam format commands
  72.                             we didn't quite get out. --Dick Barnes.]
  73.  
  74. Operation:
  75.  
  76.   Once the system has been installed, you use the Print program to submit files
  77. to the printer queue or to obtain the status of the printer queue.
  78.  
  79. Submitting A File For Queued Printing:
  80.  
  81.   In order to submit a file to the print queue for printing, you use the Print
  82. command in the following format:
  83.  
  84.      Print [[<tof_flags>] [<path>]<filename>]
  85.  
  86.   Optional items are enclosed in square brackets ("[]"), and the stuff inside
  87. angle brackets ("<>") are descriptions of what you enter.
  88.  
  89.   If you enter a line like:
  90.  
  91.        Print df0:s/Startup-Sequence
  92.  
  93.    the program verifies that the file exists, assigns it a job number, then
  94. places it into the queue for printing. Print will display a message like:
  95.  
  96.     **PRINT-S-SUCCESS: Job n submitted to queue
  97.  
  98.   This indicates that the file is in the queue and will be printed. Both Print
  99. and Spooler use a similar format: two asterisks ("*"), the program name, a
  100. dash, a character indicating the type of message ("S" for status, "W" for
  101. warnings, "E" for errors), another dash, a shortened form of message, and
  102. finally, the full message text.
  103.  
  104.   If you have special paper handling problems on your printer such as tractors
  105. and such, you can also tell Print to print out a form feed in one of three
  106. different manners: before printing the file, after printing the file, or both
  107. before and after printing the file. You do this by placing a letter between the
  108. "Print" command and the file name. The valid letters are:
  109.  
  110.       H or h    Print a form feed before the file
  111.       T or t    Print a form feed after the file
  112.       B or b    Print a form feed before and after
  113.       K or k    Remove queue entry (don't print it)
  114.  
  115. Some examples:
  116.  
  117.    Print h df0:s/Startup-Sequence -- Form feed before the file
  118.  
  119.    Print t df0:s/Startup-Sequence -- Form feed after the file
  120.  
  121.    Print b df0:s/Startup-Sequence -- Form feed before and after the file
  122.  
  123.    When you enter the filename to be printed, you may enter just a filename or
  124. the entire path. If you enter just a filename, then Print assumes that the file
  125. is in the current directory, figures out which directory you are in, and
  126. prepends the filename with the directory path. In other words, once a file is in
  127. the queue, you can change directories, and Print will still find your file and
  128. print it. If you enter the full path, Print assumes that you've given it all
  129. that it needs to find the file.
  130.  
  131. Removing A File From Queue
  132.  
  133.   This is a special form of print submission. Use the "GkH" flag rather than
  134. "GhH", "GtH", or "GbH". The "GkH" flag means "Kill the entry". You can only kill
  135. the entry before it starts to print. If it starts to print, it will finish
  136. printing. Be careful!
  137.  
  138. Displaying Queue Status
  139.  
  140.   Entering the Print command all alone will display the current status of the
  141. print queue. The display will look like:
  142.  
  143.     **PRINT-S-DSPQUE: Display printer queue status:
  144.       Job 1, File: DF0:s/Startup-Sequence, Status: Pending
  145.  
  146.   The first line is a message from Print confirming what you asked for. The next
  147. line shows a file which is currently waiting to be printed. The job number is
  148. merely a number which indicates when the file was submitted to the queue. The
  149. file name with path is shown next, followed by the file's printing status. This
  150. status can be of four different types:
  151.                                                                                      Pending:       File is waiting to be printed
  152.      Printing:      File is currently being printed
  153.      Finished:      File has been fully printed
  154.      Removed:       File entry has been removed from queue
  155.      Not Found:     File not found
  156.  
  157.   The "not found" status usually occurs if you queue a file for printing, then
  158. delete it before it's printed. Print always verifies that the file exists before
  159. it is queued for printing.
  160.