home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / winsock / wlprs40b / wlprspl.asc < prev    next >
Encoding:
Text File  |  1995-05-19  |  30.6 KB  |  730 lines
  1. Windows LPR Spooler Version 4.0b - UserÆs Guide
  2.             Windows LPR Spooler Version 4.0b - UserÆs Guide
  3. 6
  4.                                                           1
  5.                              
  6.                              
  7.                              
  8.                              
  9.                              
  10.                              
  11.                              
  12.                              
  13.                              
  14.                              
  15.                              
  16.                              
  17.              Windows LPR Spooler Version 4.0b
  18.                              
  19.                              
  20.                  A Network Printer Spooler
  21.                  for Microsoft Windows 3.1
  22.                              
  23.                              
  24.                        UserÆs Guide
  25.                              
  26.                              
  27.                     September 29, 1994
  28.                              
  29.                              
  30.                              
  31.                              
  32.                              
  33.                              
  34.                              
  35.                              
  36. This  document was created with Microsoft Word for  Windows
  37. 6.0
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44. DISCLAIMER:
  45.  
  46. THE  SOFTWARE  IS PROVIDED AS-IS. THE AUTHOR DISCLAIMS  ALL
  47. WARRANTIES,  EITHER EXPRESS OR IMPLIED, INCLUDING  BUT  NOT
  48. LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS
  49. FOR  A  PARTICULAR  PURPOSE. NO LIABILITY  IS  ASSUMED  FOR
  50. DAMAGES, DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT FROM THE
  51. USE OF THIS SOFTWARE.
  52.  
  53. (C) Copyright 1992-94 by Thomas Heil.
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64. All  trademarks appearing in this document are the property
  65. of their respective owners.
  66.  
  67.  
  68. Table of Contents
  69.  
  70. Table of Contents                                         3
  71. Introduction                                              5
  72. New Features                                              5
  73. Requirements                                              5
  74. Package Contents                                          6
  75. Installation                                              6
  76. If you upgrade ...                                        7
  77. How Does the Spooler Work?                                8
  78. First Start                                               8
  79. Adding/Changing Network Printer Definitions               9
  80. Adjusting WLPRSPL Operating Parameters                   10
  81. WLPRSPL Running ...                                      11
  82. WLPRSPL Menu Options                                     12
  83. Usage Notes                                              14
  84. Troubleshooting                                          14
  85. Change Log                                               14
  86. Licensing and Registration                               16
  87.     Registration Fee                                       16
  88. One Final Word ...                                       17
  89. Registration Form                                        19
  90.  
  91.  
  92. Introduction
  93.  
  94. Windows  LPR  Spooler, in the following  text  abbreviated  as
  95. WLPRSPL,  is a program which allows transparent printing  from
  96. Microsoft   Windows  3.1  applications  to  network  printers.
  97. WLPRSPL allows you to define a large number of remote printers
  98. which may be addressed through different Protocol DLLs.
  99.  
  100. Included  with  the program is WLPR2.DLL which implements  the
  101. Line  Printer  Daemon (LPD, RFC1179) protocol that  is  widely
  102. used  on UNIX hosts. DLL's that support other network printing
  103. protocols will be developped over time. (For details on  which
  104. Protocol  DLLs  currently exist, please  contact  the  author.
  105. Note: Protocol DLLs other than those included in the shareware
  106. version will be available to registered users only.)
  107.  
  108.  
  109. New Features
  110.  
  111. Version 4.0b offers the following new features:
  112.  
  113.    Support  of  the new WLPR2.DLL API which allows WLPRSPL  to
  114.    use  different  Protocol DLLs for different remote  printer
  115.    queues  (like  the included WLPR2.DLL that  implements  the
  116.    LPR/LPD protocol).
  117.    The  spooler can run in a so-called "unattended  mode".  In
  118.    this  mode  the spooler automatically retries failed  print
  119.    file  transfers after a user-definable amount of time.  The
  120.    user  is not interactively notified of such failures. Spool
  121.    failures  are displayed in the relevant queue line  of  the
  122.    spooler window.
  123.  
  124.  
  125. Requirements
  126.  
  127. The following components are required to run WLPRSPL:
  128.  
  129.    Microsoft Windows 3.1
  130.    WLPR2.DLL or compatible Protocol DLL(s).
  131.  
  132. If  the  spooler is used together with the included WLPR2.DLL,
  133. the following additional components are required:
  134.  
  135.    TCP/IP networking software for the PC that offers a WinSock
  136.    1.1 compliant WINSOCK.DLL.
  137.    WSOCKAID.DLL Version 1.0 or later. Users that run a  TCP/IP
  138.    stack other than FTP Software's should note the comment  in
  139.    the "Installation" section below.
  140.  
  141.  
  142. Package Contents
  143.  
  144. This  package  contains  the  spooler  (WLPRSPL.EXE)  and  the
  145. supporting  libraries  WLPR2.DLL  Version  2.0a,  WSOCKAID.DLL
  146. Version  2.0,  and CTL3D.DLL Version 2.05,  as  well  as  this
  147. documentation in form of a PostScript file and a  plain  ASCII
  148. version.
  149. The following files are included in the standard distribution:
  150.  
  151. WLPRSPL.EXE        The main program.
  152. WLPRSPL.PS/.ASC    Program documentation.
  153. WLPR2.DLL          The Protocol DLL which supports the LPR/LPD
  154.                    protocol.
  155. WLPR2.PS/.ASC      The documentation for WLPR2.DLL.
  156. WSOCKAID.DLL       A  supporting  DLL that contains  functions
  157.                    missing in WINSOCK.DLL.
  158. WSOCKAID.PS/.ASC   The documentation for WSOCKAID.DLL.
  159. WSAIDCNF.CPL       A  Control Panel extension that allows  the
  160.                    setting of the username for WSOCKAID.DLL.
  161. CTL3D.DLL          A DLL that allows dialog boxes to have a 3D
  162.                    look.
  163. CTRLD10B.ZIP       An  archive  that contains a small  utility
  164.                    with  which  one  can  enable/disable   the
  165.                    generation  of  a leading Ctrld-D  for  any
  166.                    installed PostScript printer driver.
  167.  
  168.  
  169. Installation
  170.  
  171. Choose  a  directory  where you want to  install  WLPRSPL  and
  172. create it. Move the archive WLPRSnnn.ZIP to this directory and
  173. unzip  it  with  PKUNZIP  2.04g or a compatible  uncompression
  174. program. Move all W*.DLL files to the Windows directory or  to
  175. another  directory  that  is  in your  PATH,  or  include  the
  176. directory  where  you installed WLPRSPL into your  PATH.  Copy
  177. CTL3D.DLL to your WINDOWS/SYSTEM directory after checking that
  178. there is not already a newer version. Then either create a new
  179. Program  Manager  group or open an existing one,  and  install
  180. WLPRSPL.EXE  there (please refer to your Windows documentation
  181. on  how to do this). After that you can start the program  for
  182. the  first  time. For your convenience you should install  the
  183. spooler  also in your AUTOSTART group so that it gets launched
  184. automatically when you start Windows.
  185.  
  186. A  note  about WSOCKAID.DLL: This is a network software vendor
  187. specific DLL containing a few functions that WINSOCK.DLL  does
  188. not  offer.  Currently you will not get  this  DLL  from  your
  189. vendor.  The version in this pack was written by us explicitly
  190. for FTP Software's PC/TCP stack. The function that WLPRSPL (or
  191. better WLPR2.DLL) uses is retrieving the user's login name. If
  192. you  have  FTP Software's PC/TCP 2.1 or higher, this DLL  will
  193. take  the  needed  information from  the  PCTCP.INI  file  (or
  194. whatever  your PCTCP environment variable is set to).  If  you
  195. use  a  different  stack, you may copy  WSAIDCNF.CPL  to  your
  196. WINDOWS/SYSTEM directory. This small applet then allows you to
  197. set the username in the Control Panel.
  198. Note  that  the  username is the only  thing  which  WLPR2.DLL
  199. retrieves  from  WSOCKAID.DLL.  All  other  information   that
  200. WSOCKAID.DLL can give (as described in WSOCKAID.ASC or .PS) is
  201. ignored.  The local PC hostname for example is retrieved  from
  202. the  networking software directly (through WINSOCK.DLL), which
  203. means  that you have to have a PC hostname configured in  your
  204. networking  software. Protocol DLLs other than  WLPR2.DLL  may
  205. behave   differently.   Refer   to   the   corresponding   DLL
  206. documentation.
  207.  
  208. If  you  use a TCP/IP stack that offers a real Windows network
  209. driver,  then  WSOCKAID.DLL  tries  to  inquire  the  username
  210. through  this driver instead of returning the INI file  entry.
  211. You  can verify if your TCP/IP software uses such a driver  by
  212. looking  at  SYSTEM.INI section [boot]. If a  non-empty  entry
  213. "network.drv=<drivername>"  exists,   then   your   networking
  214. software has such a driver.
  215.  
  216. For further details concerning the included DLLs please take a
  217. look at the corresponding .ASC or .PS files.
  218.  
  219.  
  220. If you upgrade ...
  221.  
  222. If  you  upgrade  from  Version  3.x  to  4.0b,  WLPRSPL  will
  223. recognize  this the first time you start the new version.  You
  224. will  be prompted if the settings of the old version shall  be
  225. retained. If you accept this, you will further be prompted  if
  226. the  old  Queue Definition File shall be converted to the  new
  227. format (which now is in standard Windows .INI format).
  228.  
  229. The old Queue Definition File must be writable when you choose
  230. to  update it automatically. So if you have a shared QDF on  a
  231. network  drive you should start the new version on a  PC  with
  232. write  access to this file first. It then gets converted,  and
  233. on all other PCs you can skip the conversion when WLPRSPL 4.0b
  234. is started for the first time there.
  235.  
  236. You  can later load 3.x  style QDFs with the Setup/Queues/Load
  237. queue  definitions...  menu option. The program  automatically
  238. determines that the file is not a 4.0 QDF and asks if the file
  239. shall be read as 3.x QDF. After the file is read you can  save
  240. it as 4.0 file.
  241.  
  242. Note  that the spooler settings are no longer kept in  WIN.INI
  243. but in WLPRSPL.INI in the Windows directory.
  244.  
  245.  
  246. How Does the Spooler Work?
  247.  
  248. Every  printer used within Windows is connected to a so-called
  249. "port."  Examples are LPT1, LPT2, COM1, COM2  etc.  But  those
  250. ports can also be normal disk files. When you add the line
  251.    
  252.    C:\SPOOL\DRUCKER.DAT=
  253.    
  254. to  the  [ports]  section of WIN.INI you may later  connect  a
  255. printer  driver to this "port." Every print job sent  to  this
  256. port  is  written to the specified file. This is what  WLPRSPL
  257. relies on. WLPRSPL uses a dedicated directory on the PCs  hard
  258. disk  for spooling (i.e. C:\SPOOL). This directory has  to  be
  259. specified  the  first  time you start the  program.  For  each
  260. network  printer  you want to print to you have  to  define  a
  261. unique  file name (i.e. HP.PCL for a HP LaserJet in PCL mode).
  262. This  file name together with the chosen spool directory forms
  263. the   port   (in  this  case  C:\SPOOL\HP.PCL)  to  which   an
  264. appropriate  Windows  printer driver  can  be  connected.  The
  265. filename without path represents the local queue.
  266.  
  267. A  remote  printer  is  defined by the  local  queue  name  as
  268. described above, the remote printer name, the host name of the
  269. computer  that  acts as printer server, and the  name  of  the
  270. Protocol  DLL to be used for connecting to the remote printer.
  271. The  definitions of all remote printers are kept  in  a  Queue
  272. Definition  File (which will be abbreviated as  QDF  from  now
  273. on). When starting the spooler for the first time, you have to
  274. specifiy  the location of this file. It may either be  located
  275. on  a  local  drive, but it could also be on a shared  network
  276. drive   where  it  is  maintained  by  some  network   printer
  277. administrator.
  278.  
  279. You  define  remote  printers by filling  in  the  information
  280. described   above   into  the  queue  setup  dialog.   WLPRSPL
  281. automatically creates the needed port in WIN.INI so  that  you
  282. later  can  install  an appropriate printer  driver  for  this
  283. remote queue.
  284.  
  285. When  you  print  to  such a network  driver  from  a  windows
  286. application,  the printer data is written to the corresponding
  287. spool  file. WLPRSPL then puts the file into its own  queueing
  288. system and sends the data to the remote printer.
  289.  
  290.  
  291. First Start
  292.  
  293. When  you start WLPRSPL for the first time you have to specify
  294. the  spool  directory  you want to use.  In  the  dialog  that
  295. appears you can also create new subdirectories. Once you  have
  296. selected  the  spool directory, you have to define  the  place
  297. where the QDF shall be located. It is possible to use a shared
  298. QDF  that  resides on a network drive and which is  maintained
  299. centrally. The file that you specify does not have to exist at
  300. this  time. It will be created as soon as you define the first
  301. queue in WLPRSPL.
  302.  
  303. After  this  first  time configuration you  may  define  local
  304. queues  for all remote printers you want to utilize.  This  is
  305. described  in  the  next  section.  Then  you  should  install
  306. appropriate Windows printer drivers for your network  printers
  307. and connect them to the corresponding port.
  308.  
  309.  
  310. Adding/Changing Network Printer Definitions
  311.  
  312. In  order  to  define network printers in  WLPRSPL  start  the
  313. program if not yet running, restore the program window if  the
  314. program   is   iconized,   and   select   the   menu    option
  315. Setup/Queues/Define new queue... or press Alt-Insert. A dialog
  316. pops up where you can enter a new queue definition. The fields
  317. in this dialog have the following meaning:
  318.  
  319. Local Spool File:  Name of the spool file (without path) that
  320.                    shall be used for the local queue.
  321. Remote Queue Name: Name of the queue on the remote print
  322.                    server.
  323. Remote Host Name:  Internet host name or address of the remote
  324.                    print server.
  325. DLL to be used:    Specifies the Protocol DLL to be used for
  326.                    this remote printer. It may be either the
  327.                    name only (which lets WLPRSPL search for it
  328.                    in the standard search order) or a fully
  329.                    qualified path name. WLPR2.DLL is the
  330.                    default for new queues.
  331.  
  332. After  filling in all fields you can review/change the options
  333. that  are  in  effect  for this queue by  pressing  the  Queue
  334. properties...  button. The options in the  dialog  popping  up
  335. depend on the specified Protocol DLL. For the meaning of those
  336. options please refer to the DLL's documentation.
  337. When  you press OK in the "Edit queue data" dialog, a new port
  338. is   created  if  needed.  Now  you  can  go  to  the  Control
  339. Panel/Printer Setup, install a printer driver that matches the
  340. remote printer, and connect it to the corresponding port. Take
  341. care  that  all printer characteristics you define  match  the
  342. remote  printer. Normally a datastream from a Windows  printer
  343. driver  overrides settings of the remote printer defaults.  If
  344. you  select settings that the remote printer does not  support
  345. it may hang.
  346.  
  347. If  you  want  to  change the definition of a remote  printer,
  348. select it in the main window listbox and click the menu option
  349. Setup/Queues/Edit  queue data... or press Alt-Enter.  You  get
  350. the  queue  setup dialog box with the currently  valid  values
  351. filled in, ready to be altered.
  352. Changes to queues are not automatically saved. This has to  be
  353. done either through Setup/Queues/Save queue definitions, or by
  354. accepting  the automatic saving when WLPRSPL (or  Windows)  is
  355. terminated.
  356.  
  357. After  installing  the printer driver you  may  print  to  the
  358. remote queue from any Windows application.
  359.  
  360.  
  361. Adjusting WLPRSPL Operating Parameters
  362.  
  363. Through  the  menu (Setup/Preferences...) you  can  get  to  a
  364. dialog  box  where  you  can change  the  following  operating
  365. parameters of WLPRSPL.
  366.  
  367. Timer ticks in This entry defines the time steps used by
  368. sec.           WLPRSPL to periodically check for possible
  369.                spool files. It can be 0 which means that
  370.                this feature is disabled. With this feature
  371.                enabled it is possible to create spool
  372.                files in DOS sessions and have them
  373.                automatically entered into the WLPRSPL
  374.                queueing system (see Usage Notes).
  375.                Default is 0.
  376. Warn if        When this check box is activated (default),
  377. suspended      you get a warning every time you print to a
  378.                remote network printer if the spooler is
  379.                currently suspended.
  380.                Default is on.
  381. Unattended     When this check box is activated, the
  382. mode           spooler is in "Unattended Mode". This means
  383.                that the user is not notified of spooling
  384.                errors. Instead the faulty queue is
  385.                temporarily disabled, and is re-enabled
  386.                after the number of seconds specified.
  387.                Default is on.
  388. Automatically  If unattended mode is on, this entry
  389. re-enable      specifies after how long a failed print
  390. queue after    file transfer is retried.
  391. ... sec.       Default is 300 seconds.
  392.  
  393. Normally you can leave the default values as they are. If  you
  394. notice a performance degradation on slow PCs due to the  spool
  395. file polling set the Timer Ticks to a higher value, or set  it
  396. to 0 if this feature is not needed.
  397.  
  398.  
  399. WLPRSPL Running ...
  400.  
  401. When  WLPRSPL is active you normally don't notice anything  of
  402. its  existance because the spooling is done in the background.
  403. The  WLPRSPL  main window always shows you what  is  currently
  404. going on. You see the following information being displayed:
  405.  
  406.    the time the spooler was started
  407.    the mode in which Windows is running (Standard or Enhanced)
  408.    the current state of the spooler (suspended or active)
  409.    the  current  run  mode  of  the spooler  ("unattended"  or
  410.    "interactive")
  411.    the currently used spool directory
  412.    the currently used Queue Definition File
  413.    a  listbox displaying the states of all local queues  (more
  414.    detailed description below)
  415.    the  Windows printer driver used for the currently selected
  416.    (and therefore highlighted) queue
  417.  
  418. The  individual  columns  in the listbox  have  the  following
  419. meaning:
  420.  
  421. Symbol          If blank the local queue is currently not
  422.                 connected to a printer driver, if ">" it
  423.                 is connected, if "*" it is connected and
  424.                 is currently selected as default printer.
  425. Red "E"         If present, it indicates that there was
  426.                 some spool error. You can check this error
  427.                 with the Queues/Show last error... menu
  428.                 option and remove the flag with the
  429.                 Queues/Clear error flag menu option.
  430. Loc. Queue      Name of the local queue (and of the spool
  431.                 file).
  432. Rem. Queue      Name of the queue on remote print server.
  433. Host            Name of remote print server.
  434. Spool tries     Number of print jobs sent over this queue
  435. unsucc./succ.   since WLPRSPL was started or since the
  436.                 queue statistics were reset, and number of
  437.                 times the current spool file in a queue
  438.                 failed to be sent.
  439. Files queued    Number of unsent print jobs.
  440.  
  441. Permanently  disabled queues (that means "disabled  by  user")
  442. are   shown  with  red  text.  A  temporarily  disabled  queue
  443. (disabled because of spool error in unattended mode) is  shown
  444. with  yellow text. A queue that is active sending a print  job
  445. is  shown  in  green, and the statistics are replaced  with  a
  446. progress message.
  447.  
  448.  
  449. WLPRSPL Menu Options
  450.  
  451. Following  is a list with all available menu options.  On  the
  452. right hand side the keyboard short cut is shown.
  453.  
  454. Files
  455.    Delete next spool file                             (Delete)
  456.        Delete next spool file in selected local queue.
  457.    Delete all spool files in queue               (Ctrl-Delete)
  458.        Delete all spool files in selected local queue.
  459.    Delete all spool files                  (Shift-Ctrl-Delete)
  460.        Delete all spool files in all local queues.
  461.    Cancel spooling                                    (Ctrl-C)
  462.        A currently running transfer is cancelled.
  463.    Suspend/Resume spooler                             (Ctrl-S)
  464.        The  spooler is suspended, or its operation is resumed,
  465.        depending on the current state of the spooler. When the
  466.        spooler is suspended, no print jobs are transferred  to
  467.        remote printers.
  468.    Control Panel                                      (Ctrl-P)
  469.        Call the control panel.
  470.    Exit                                     (Ctrl-X or Alt-F4)
  471.        Exit WLPRSPL.
  472. Queues
  473.    Show remote queue status                           (Ctrl-Q)
  474.        Shows the state of the remote queue that corresponds to
  475.        the  selected local queue by executing an LPQ  request.
  476.        The  dialog  box showing the remote queue  status  then
  477.        allows  refreshing  the display and cancelling  one  or
  478.        more remote print jobs.
  479.    Show jobs in local queue                           (Ctrl-L)
  480.        Opens  a dialog box that shows all jobs which are still
  481.        in  the  currently selected local queue. In this dialog
  482.        box   you   have   the  possiblity  of  removing   jobs
  483.        individually.
  484.    Enable/Disable queue(Ctrl-A or doubleclick on queue in listbox)
  485.        The selected local queue is enabled/disabled.
  486.    Scan queues immediately
  487.         (Ctrl-I or click right mouse button on WLPRSPL symbol)
  488.        The  spool  directory is scanned for  new  spool  files
  489.        immediately.
  490.    Retry to spool now                                 (Ctrl-N)
  491.        If  the  queue is in retry timeout state (yellow  text)
  492.        because an error occured when trying to send the active
  493.        spool file, the spooler retries immediately to send the
  494.        file instead of waiting for the time to expire.
  495.    Select as default printer                          (Ctrl-D)
  496.        The  printer connected to the currently selected  queue
  497.        is made the Windows default printer.
  498.    Show last error...                                 (Ctrl-E)
  499.        A message describing the last spool error is displayed.
  500.    Clear error flag                                   (Ctrl-F)
  501.        A message describing the last spool error is displayed.
  502.    Reset selected queue                               (Ctrl-R)
  503.        The statistics of the selected local queue are reset.
  504.    Reset all queues                             (Shift-Ctrl-R)
  505.        The statistics of all local queues are reset.
  506. Setup
  507.    Preferences...
  508.        Activates  the  dialog described in "Adjusting  WLPRSPL
  509.        Operating Parameters"
  510.    Spool-Directory...
  511.        Activates  the  dialog  for  selection  of  the   spool
  512.        directory described in "First Start".
  513.    Queues >
  514.        Define new queue                           (Alt-Insert)
  515.            Activates  the  dialog  for defining  a  new  queue
  516.            described   in  "Adding/Changing  Network   Printer
  517.            Definitions".
  518.        Edit queue data                             (Alt-Enter)
  519.            Activates   the  dialog  for  editing  queue   data
  520.            described   in  "Adding/Changing  Network   Printer
  521.            Definitions". The dialog is filled with the data of
  522.            the currently selected local queue.
  523.        Delete queue                               (Alt-Delete)
  524.            Deletes the currently selected local queue.
  525.        Reload queue definitions
  526.            Reloads  the  queue definitions from the  currently
  527.            active QDF.
  528.        Load queue definitions...
  529.            Activates  the dialog for selecting a QDF described
  530.            in "First Start".
  531.        Save queue definitions
  532.            Saves  changes  made to a queue definition  in  the
  533.            currently active QDF.
  534.        Save queue definitions as...
  535.            Saves  the current queue definitions to a QDF which
  536.            must first be selected. If wanted, this new QDF can
  537.            be  made the currently active QDF, which will  then
  538.            be used the next time WLPRSPL starts.
  539.    Register Program...
  540.        Activates the program registration dialog. If you  have
  541.        a  pre-registered  version of the  program,  this  menu
  542.        option is grayed.
  543.  
  544.  
  545.  
  546. Usage Notes
  547.  
  548.    When  the  spool  directory  is  changed  after  the  first
  549.    installation, new ports are automatically generated for all
  550.    local  queues in the [ports] section of WIN.INI.  The  user
  551.    then  has to manually connect all printer drivers to  those
  552.    new ports. This is currently not done automatically.
  553.    If  you have a DOS application that can print to a file  in
  554.    addition  to printing to a real LPTx or COMx, you  can  use
  555.    WLPRSPL  to  spool  those files. Just let  the  application
  556.    print  to  the file that defines the port for  the  desired
  557.    network printer (i.e. C:\SPOOL\HP.PCL). Then there are  two
  558.    possibilities to initiate the transfer: Either you have set
  559.    the  Timer Ticks to a non-zero value. In this case you only
  560.    have  to  wait  for the specified number  of  seconds,  and
  561.    WLPRSPL puts the file into its queueing system. If you have
  562.    disabled  this feature you can also switch back to  WLPRSPL
  563.    with Alt-Tab and select Queues/Scan queues immediately from
  564.    the  menu or click on the WLPRSPL icon with the right mouse
  565.    button.
  566.    The state of all queues (enabled/disabled, number and names
  567.    of  spool  files) is saved in the spool directory  as  file
  568.    filename.SPL, where filename corresponds to the name of the
  569.    QDF.  When, for example, the name of the QDF is WLPRSPL.QS,
  570.    then  the name of the queue state file is WLPRSPL.SPL. This
  571.    file  should  not  be  deleted  because  it  is  needed  to
  572.    determine  to  which  local queue any  unsent  spool  files
  573.    belong.
  574.    When you print to a remote queue that automatically detects
  575.    PostScript  files and you get the PostScript text  printed,
  576.    this  usually  happens  due to the fact  that  the  Windows
  577.    PostScript driver prepends the PS datastream with a  Ctrl-D
  578.    (0x04).  This character normally causes a locally  attached
  579.    PS  printer  to reset, but it also makes it impossible  for
  580.    network  queues  to recognize the print data  as  PS  file.
  581.    Included   in   this  package  is  a  ZIP  archive   called
  582.    CTRLD10B.ZIP  which contains a small Windows  utility  that
  583.    allows  you  to  selectively enable or disable  the  Ctrl-D
  584.    generation for all installed PS printers.
  585.  
  586.  
  587. Troubleshooting
  588.  
  589. If  you  have problems with the spooler that can't be resolved
  590. through  this document please take a look at the documentation
  591. of  the  supporting DLLs. There are given some troubleshooting
  592. tips  which  are specific to those DLLs. If this  fails,  too,
  593. please  feel free to contact us. But do not forget to  provide
  594. us with info about the program version, your operating system,
  595. and  your  networking software, as well  as  info  about  what
  596. printer  and  printer server you use (model, operating  system
  597. etc.)
  598.  
  599.  
  600. Change Log
  601.  
  602. Version 4.0a:
  603.    Package includes WLPR2.DLL Version 2.0a.
  604.    The  logic  when  saving the state  of  a  queue  (enabled,
  605.    disabled,  retry timeout) was changed. Now, if a  queue  is
  606.    permanently disabled, it will stay in this state  when  you
  607.    close down the spooler and later restart it. Previously,  a
  608.    disabled  queue  went into "Retry timeout" state  when  the
  609.    spooler was restarted.
  610.    In the "Edit Queue Data" dialog the "Local Spool File" name
  611.    now is limited to 12 characters.
  612.    Long  queue and host names extended into the data right  of
  613.    it  in the main window list box. They are now truncated  in
  614.    the display.
  615.    In  unattended  mode,  the error code  of  a  failed  spool
  616.    attempt  is  now  kept  and  can  be  displayed  with   the
  617.    Queues/Show last error... menu option. If an error occured,
  618.    this  is also indicated with a red "E" at the beginning  of
  619.    the relevant line in the spooler's main window listbox.
  620.  
  621. Version 4.0b:
  622.    Package includes WLPR2.DLL Version 2.0b.
  623.    The  file  name generation scheme for the spool  files  has
  624.    been changed. Previously it was based on the time with a  1
  625.    second  resolution which caused two print jobs to be  given
  626.    the same name if printed within one second.
  627.    More keyboard accelerators for menu functions.
  628.    The  default Windows printer can now be changed within  the
  629.    spooler   to   one   of  the  WLPRSPL  queues   by   right-
  630.    doubleclicking on a spooler queue.
  631.  
  632.  
  633. Licensing and Registration
  634.  
  635. This  software is not free. It is shareware. You  are  granted
  636. the right to test this software for a period of 30 days. After
  637. this  you have to register the product (see registration  form
  638. at  the end of this document) and, if this applies to you, pay
  639. the required registration fee.
  640.  
  641. The  unregistered shareware version displays a message box  at
  642. the  program start reminding you that the program has not  yet
  643. been  registered.  When you register the program,  you  get  a
  644. serial  number  and  a corresponding key. Start  the  spooler,
  645. select  the  Setup/Register Program... menu option,  and  type
  646. your user information together with serial number and key into
  647. the dialog box. Then press the OK button.
  648.  
  649. You may redistribute this program to other persons as long  as
  650. you  keep  the  package complete with all the files  that  are
  651. listed  in  the  "Contents" section at the beginning  of  this
  652. document.
  653. Registration Fee
  654.  
  655. Contact  us (see next section) for the registration price.  We
  656. also offer site/company licenses.
  657.  
  658.  
  659. One Final Word ...
  660.  
  661. Tell  us everything you like or dislike about this program  in
  662. order  to let us make it better. Tell us about functions  that
  663. you  would like to see added. Tell us about problems you  have
  664. encountered.
  665.  
  666. You  can reach us under the following E-mail addresses  (first
  667. in the list preferred):
  668.  
  669.     th.heil@kfa-juelich.de
  670.     ich211@zam001.zam.kfa-juelich.de
  671.     ich211@djukfa11.bitnet
  672.     ich211@ich210.ich.kfa-juelich.de
  673.     CompuServe: 100434,2167
  674.  
  675. or by ordinary mail as
  676.  
  677.     Susanne Heil EDV-Vertrieb
  678.     Hindenburgstr. 50
  679.     41352 Korschenbroich
  680.     Germany
  681.  
  682. or by fax under +49 (0)2161 644337
  683.  
  684.  
  685. Registration Form
  686.  
  687. (Please register WLPRSPL 4.0b when you decide to use it beyond
  688. the trial period of 30 days.)
  689.  
  690.  
  691.                   Name: 
  692.            Institution: 
  693.             Department: 
  694.                 Street: 
  695.           City/Town and 
  696.          ZIP/Post Code: 
  697.                  State: 
  698.                Country: 
  699.           Phone number: 
  700.             FAX number: 
  701.         E-Mail address: 
  702.        Customer Number1 
  703.  
  704. I  would  like  to register _______ Windows LPR  Spooler  4.0b
  705. licenses
  706.  
  707. for          an educational/no-profit institution.Total price:
  708. DM
  709.              a commercial/for-profit institution. Total price:
  710. DM
  711.  
  712. Payment:   Remittance to:Bank: Stadtsparkasse  Korschenbroich,
  713. Germany
  714.                        Bank Routing Code: 310 512 40  Account:
  715. 149401
  716.           included Cheque (in German currency)
  717.  
  718.  
  719.  
  720.           Date/Signature
  721.  
  722. Please mail this form (with a possible fee included) to
  723.  
  724.        Susanne Heil EDV-Vertrieb
  725.        Hindenburgstr. 50
  726.        41352 Korschenbroich
  727.        Germany
  728. _______________________________
  729. 1from a previous registration
  730.