home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d6xx / d656 / jbspool.lha / JbSpool / JbSpool.DOC < prev    next >
Text File  |  1992-05-15  |  13KB  |  247 lines
  1.  
  2.                              JbSpool release 1
  3.  
  4.                                                           
  5.                      © Copyright 1992  Jaba Development   
  6.                         Written using  Dice v2.06.40      
  7.                            by  Jan van den Baard          
  8.                                                           
  9.                                       __  __         
  10.                                      / / /  \        
  11.                               __    / / / /\ \       
  12.                          _____\ \__/ /_/ /_/ /_____  
  13.                         (__________________________) 
  14.  
  15.  
  16.   DISCLAIMER
  17.   ---------------------------------------------------------------------------
  18.   The author is not responsible for any damage caused by the use or misuse of
  19.   this documentation and/or the program(s) it describes. Any damage resulting
  20.   from  the use  or  misuse of this  documentation  and/or the  program(s) it
  21.   describes is the sole responsibility of the user her/him self.
  22.   ---------------------------------------------------------------------------
  23.  
  24.   COPYRIGHT
  25.   ---------------------------------------------------------------------------
  26.   JbSpool, © Copyright 1992  Jaba Development.   All  rights  reserved.  This
  27.   program is FREEWARE so no financial donations are required. I would like to
  28.   get a postcard of your home town if you use this program!
  29.   ---------------------------------------------------------------------------
  30.  
  31.   Ever dreamed about the following?
  32.  
  33.     Copy file1 to PRT:
  34.     Copy file2 to PRT:
  35.     Copy file3 to PRT:
  36.  
  37.   And still being able to continue to work  without  having  to  wait for the
  38.   printer to finish? Well I did and I started to write my  own spooler  to do
  39.   the job  for me.   JbSpool  is a  printer  spooler  specially  written  for
  40.   AmigaDOS  release  2.04.   It  has  been implemented as a commodity and the
  41.   program  has  been  written  with   the  "User Interface Style Guide" close
  42.   at hand.    It features  a complete  font adaptable GUI containing a lot of
  43.   control gadgets and menus.    You can start JbSpool from the shell  and the
  44.   workbench.
  45.  
  46.   Installing
  47.   ---------------------------------------------------------------------------
  48.   There is one important thing that you _must_ do  before  starting  JbSpool.
  49.   You have to create a  directory  and  assign  it  as  JBS:.   This  is  the
  50.   directory that the program uses to look for files to print.   Please do not
  51.   use this directory for any other purpose than for JbSpool.   The reason for
  52.   this is that when JbSpool performs a directory scan it will delete all non-
  53.   ascii files and then it starts to  print  out  each  file  that is  in this
  54.   directory.    It's best to install this directory on a ram or harddisk.  To
  55.   make  the  directory  you must  insert the following lines in your startup-
  56.   sequence:
  57.  
  58.     MakeDir RAM:Jbs      ; can be DH0:Jbs or DF0:Jbs or what ever you want...
  59.     Assign  JBS: RAM:Jbs
  60.  
  61.   Starting JbSpool
  62.   ---------------------------------------------------------------------------
  63.   JbSpool has the following command-line/tooltype template:
  64.  
  65.      JbSpool  [CX_PRIORITY] [CX_POPUP] [CX_POPKEY] [QUIT] [MINUTES] [SECONDS]
  66.               [DONTSTART] [NOAPPICON]
  67.  
  68.      CX_PRIORITY/K/N,CX_POPUP/K,CX_POPKEY/K,QUIT/K,MINUTES/K/N,SECONDS/K/N,
  69.      DONTSTART/S NOAPPICON/S
  70.  
  71.      CX_PRIORITY   -: With this argument  you can set  JbSpool it's  priority
  72.                       in the commodities queue.
  73.                       Default : 0
  74.  
  75.      CX_POPUP      -: When you specify "CX_POPUP=NO"  for  this  argument the
  76.                       window will not be opened.
  77.                       Default : YES
  78.  
  79.      CX_POPKEY     -: This argument must be used to set the  hotkey that will
  80.                       tell JbSpool to open it's window.
  81.                       Default : control lshift j
  82.  
  83.      QUIT          -: This argument must be used to set the  hotkey that will
  84.                       tell JbSpool to quit.
  85.                       Default : control lshift q
  86.  
  87.      MINUTES       -: With  this  argument  you  can  specify  the  amount of
  88.                       minutes JbSpool must wait before scanning  the  spooler
  89.                       directory.
  90.                       Default : 1
  91.  
  92.      SECONDS       -: With  this  argument  you  can  specify  the  amount of
  93.                       seconds JbSpool must wait before scanning  the  spooler
  94.                       directory. Note: The total amount of seconds (minutes *
  95.                       60 + seconds) cannot be smaller than 5.   JbSpool makes
  96.                       sure that this is the case.
  97.                       Default : 0
  98.  
  99.      DONTSTART     -: When you specify this argument JbSpool will _not_ start
  100.                       printing the files  from the  queue until  you click on
  101.                       the "Continue" gadget.
  102.  
  103.      NOAPPICON     -: When  you  specify  this  argument  JbSpool  won't  add
  104.                       an application icon to the workbench screen.
  105.  
  106.   All the arguments can also be set as tooltypes in the  program  it's  icon.
  107.   Note that you dont have to "Run", "RunBack" or "ARun"  JbSpool  because  it
  108.   will automatically detach itself from the shell.
  109.  
  110.   The Window
  111.   ---------------------------------------------------------------------------
  112.   When the JbSpool window is open you will see the following gadgets:
  113.  
  114.     ListView       -: This  gadget  has  all  files  currently in the spooler
  115.                       queue listed.
  116.  
  117.     Printing       -: This  gadget  displays  the  name  of  the  file  which
  118.                       JbSpool is currently printing.    When no file is being
  119.                       printed this gadget can show "*** IDLE ***" which means
  120.                       that  no  files  are  left  in the queue or it can read
  121.                       "*** STOPPED ***" which means that there are files left
  122.                       in the queue but you have selected the "Stop" gadget or
  123.                       it can read "*** DELAYED ***" which means that you have
  124.                       cancelled the requester telling  you that  the  printer
  125.                       isn't on-line or the requester telling  you the printer
  126.                       is out of paper.    Note: When you cancel either of the
  127.                       above  mentioned  requesters the  file still remains in
  128.                       the queue and JbSpool will try to print it  again after
  129.                       the next directory scan.
  130.  
  131.     %              -: This gadget only shows the percentage of  the file that
  132.                       has already been send to the printer.
  133.  
  134.     Insert FF      -: When this gadget is checked JbSpool  will  send  a form
  135.                       feed afters each file it has printed. This will prevent
  136.                       that parts of different files will be  printed  on  the
  137.                       same sheet of paper.
  138.  
  139.     Abort          -: This  gadget  is  only  selectable (on) when JbSpool is
  140.                       busy printing a file.  Clicking  on  this  gadget  will
  141.                       abort the printing. Note: The file that is aborted will
  142.                       be deleted from the JbSpool queue  and  from  the  JBS:
  143.                       directory.
  144.  
  145.     Minutes        -: With this gadget you can change the amount  of  minutes
  146.                       JbSpool has to wait between directory scans.
  147.  
  148.     Seconds        -: With this gadget you can change the amount  of  seconds
  149.                       JbSpool has to wait between directory scans.
  150.  
  151.     Add...         -: This gadget will bringup the ASL FileRequester in which
  152.                       you can select a file which must be added to the queue.
  153.                       The ASL FileRequester is setup so that  you can  select
  154.                       multiple files. Just click on  the  filenames  that you
  155.                       want. To Add the file you can  either  double-click the
  156.                       last name or you can click on "Add". Note: The selected
  157.                       files  will be  copied into JBS:.
  158.  
  159.     Remove...      -: This gadget is  only  selectable  (on)  when  you  have
  160.                       clicked on one of the entries in the  ListView  gadget.
  161.                       This will remove the file from the  queue  and  it will
  162.                       delete it from the  JBS:  directory  after  asking  for
  163.                       confirmation.  Note: If you select  not to  let JbSpool
  164.                       delete the  file  from  the  JBS:  directory  the  file
  165.                       will re-appear in the queue when  the program  re-scans
  166.                       the JBS: directory.
  167.  
  168.     Up             -: This gadget is  only  selectable  (on)  when  you  have
  169.                       clicked on one of the entries in the  ListView  gadget.
  170.                       This will move up the file one place in the queue.
  171.  
  172.     Down           -: This gadget is  only  selectable  (on)  when  you  have
  173.                       clicked on one of the entries in the  ListView  gadget.
  174.                       This will move down the file one place in the queue.
  175.  
  176.     Top            -: This gadget is  only  selectable  (on)  when  you  have
  177.                       clicked on one of the entries in the  ListView  gadget.
  178.                       This will move the file to the top of the queue.
  179.  
  180.     Bottom         -: This gadget is  only  selectable  (on)  when  you  have
  181.                       clicked on one of the entries in the  ListView  gadget.
  182.                       This will move the file to the bottom of the queue.
  183.  
  184.     Stop          -:  Clicking on this gadget tell's  JbSpool  that  it  must
  185.                       wait until further notice when the file currently being
  186.                       printed is done.
  187.  
  188.     Continue      -:  Clicking on this gadget tell's JbSpool to continue with
  189.                       with printing.
  190.  
  191.     Hide          -:  A standard commodity gadget. This will hide the window.
  192.  
  193.     Quit          -:  When you click on this gadget  the  program  will  quit
  194.                       right after it has finished the  file  it is  currently
  195.                       printing.   Note: All file that where left in the queue
  196.                       will automatically be deleted from the JBS: directory.
  197.  
  198.   JbSpool also contains menus which have the same  function as  their related
  199.   gadgets. One exception is the "About.." menu which displays some info about
  200.   the program.
  201.  
  202.   How it works
  203.   ---------------------------------------------------------------------------
  204.   To get JbSpool to print your files you  must do  the  following _very_ easy
  205.   thing:
  206.  
  207.     Instead of saving your file to PRT: you must save it to JBS:.
  208.  
  209.   Simple eh?....
  210.  
  211.   Workbench support
  212.   ---------------------------------------------------------------------------
  213.   As if all of the above isn't enough JbSpool  also add's it's own AppIcon to
  214.   the workbench when the workbench is open.   When JbSpool was  started  from
  215.   the shell and the  workbench  isn't  open  JbSpool  will  try to  add  it's
  216.   AppIcon each time a directory scan is performed. This way the AppIcon  will
  217.   also be added after you  have  started  the  workbench.  The  usage of  the
  218.   AppIcon is simple. Double clicking it  will  cause  JbSpool  to  open  it's
  219.   window and dropping one or more icons on the AppIcon will cause  the  files
  220.   to  be copied in the JBS: directory.
  221.  
  222.   Notes
  223.   ---------------------------------------------------------------------------
  224.   JbSpool will check if the files that are copied into the JBS: directory are
  225.   plain ascii files. It will _only_ print plain ascii files.  It simply reads
  226.   the first 100 (or less) bytes of the files and if it  contains  one  of the
  227.   following bytes it won't print the file: (values are in hex)
  228.  
  229.     0x01 to 0x08
  230.     0x0E to 0x1A
  231.     0x1C to 0x1F
  232.     0x80 to 0x9A
  233.  
  234.   Because of this check the directory scan can take some time  when the  JBS:
  235.   directory is assigned to a slow device like a disk drive. To get full speed
  236.   you should assign JBS: to either a ram disk or a hard disk.
  237.  
  238.   Bug reports,  suggestions,  postcards,  flames,  criticism,  contributions,
  239.   ideas, gifts, etc., etc., etc......... to:
  240.  
  241.                                            Jan van den Baard
  242.                                            Bakkerstraat 176
  243.                                            3082 HE, Rotterdam
  244.                                            The Netherlands
  245.  
  246.                                            FIDO: 2:500/29 (Jan van.den.Baard)
  247.