home *** CD-ROM | disk | FTP | other *** search
/ Network Support Encyclopedia 96-1 / novell-nsepro-1996-1-cd2.iso / download / netware / plpd8.exe / PLPD8.TXT < prev    next >
Text File  |  1995-09-11  |  7KB  |  197 lines
  1. NOVELL TECHNICAL INFORMATION DOCUMENT
  2.  
  3. TITLE:  PLPD8.EXE; PLPD 1.2C Maintenance Patch
  4. README FOR:  PLPD8.EXE
  5.  
  6. NOVELL PRODUCTS and VERSIONS:
  7. NetWare FLeX/IP 1.2C
  8. NetWare NFS 1.2C
  9.  
  10. ABSTRACT:
  11.  
  12. This patch includes all bug fixes to date for PLPD.NLM and
  13. PLPDCFG.NLM.  Not supported for 1.2b or other version previous to
  14. 1.2c.
  15.  
  16.  
  17.  
  18.  
  19. -----------------------------------------------------------------
  20.  DISCLAIMER
  21.  THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO
  22. NOVELL.  NOVELL MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY
  23. THIS INFORMATION.  HOWEVER, THE INFORMATION PROVIDED IN THIS
  24. DOCUMENT IS FOR YOUR INFORMATION ONLY.  NOVELL MAKES NO EXPLICIT
  25. OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION.
  26.  
  27. -----------------------------------------------------------------
  28.  
  29.  
  30. SYMPTOM:
  31.  
  32. 1.  Printing has ceased with a PKERNEL error message of "t_look()
  33. failed after t_rcv()".
  34.  
  35.  2.  PLPD may fail to release buffers when print jobs complete
  36. which eventually leads to malloc() failures.
  37.  
  38.  3.  Upon unloading PLPDCFG, "Module did not release xxx
  39. resources" displays on the console.
  40.  
  41.  4.  User needs one of the PLPD enhancements.   See SOLUTION for
  42. details.
  43.  
  44.  
  45. SOLUTION: 
  46.  
  47. This patch consists of PLPD.NLM, PLPDCFG.NLM (configuration
  48. utility), and PLPD128.TXT (this document).
  49.  
  50.  This PLPD.NLM is the socket version which replaces the TLI
  51. interface to the network with SPX socket connections.   The
  52. change was needed for enhancements made to the TLI state logic,
  53. which made it more robust but adversely affected the dependent
  54. module PLPD.NLM.   This PLPD eliminates all TLI-related problems.
  55.  
  56.  Additional enhancements are described below:
  57.  
  58.  1.  The way in which NetWare connections are used has been
  59. optimized.  Previously, a new NCP connection was made for every
  60. print job accepted  by PLPD, and later closed when the print job
  61. completed.  This incurred some computational expense, especially
  62. under NetWare 4.0x where NDS authentication takes place.   This
  63. enhanced version logs in only once per queue using the Default
  64. User account, and that connection stays active as long as PLPD is
  65. loaded.  The connection is made the first time a queue is used. 
  66. If the NetWare System Administrator has set up the PLPD (using
  67. PLPDCFG.NLM) with individual user accounts mapped, the algorithm
  68. works as before, i.e. log in for each print job.
  69.  
  70.  The first time a queue is used and successful login has
  71. occurred, a message will appear on the PKERNEL screen saying:
  72.  
  73.  "Default user <username> for queue <queue number> is using
  74. connection <connection number>"
  75.  
  76.  This is not an error, but an informational message.
  77.  
  78.  2. The queues can now be configured to suppress banner and form
  79. feed using the enhanced PLPDCFG.NLM.
  80.  
  81.  3.  PLPD.NLM now does disk capacity checking.  If an incoming
  82. spool job will fill the NetWare disk, the print job is rejected
  83. with -2 returned to the print client.  Most LPR clients
  84. understand -2 to mean "disk full", which follows the Sun
  85. convention.   Previously when the spool directory became full, 0
  86. (success) was returned to the client, effectively clearing the
  87. job from its queue.  With -2 returned, the LPR client will hold
  88. onto the job for retry later.  Administrators need to add
  89. capacity to the SYS: volume when space is low.  Since customers
  90. automatically submit very large jobs from mainframes without
  91. human attendance, disk full is still possible even with added
  92. space.  A debug message prints on the PKERNEL screen if a disk
  93. full is detected.
  94.  
  95.  Usage suggestion:  If acceptable to users and administrator,
  96. configure PLPD to use a single user for default mapping rather
  97. than mapping of individual user accounts.  Otherwise, the
  98. software will have to examine the configuration file to determine
  99. identity of user sending the print job,  and then create a server
  100. connection, causing some delay.  PLPD protocol always sends both
  101. a data file and a configuration file.  The configuration file has
  102. the user's name which must be read by PLPD to check that the
  103. user's disk space limitations.   If default mapping is used, PLPD
  104. already knows who the user is.
  105.  
  106.  4.  PLPD now checks to see if the client is attempting to use a
  107. non-reserved port.  Previously, the client could communicate with
  108. PLPD on any TCP/IP port.  This could be a security concern in
  109. some installations.  It also violates the RFC for the LPD
  110. protocol.
  111.  
  112.  Port checking can be disabled.  If experiencing the error "Login
  113. failed:  Attempt to use reserved port", use the command line
  114. option "ANYPORT" when loading PLPD.
  115.  
  116.  Example:  LOAD PLPD.NLM ANYPORT
  117.  
  118.  5.  Performance has been improved for NetWare 4.02 and newer
  119. versions of CLIB  and TCP/IP.   If performance is slow or packet
  120. traces show that the TCP/IP window size is going down to zero,
  121. buffer allocation can be increased.  Optional load parameters
  122. allocate additional buffers for each queue.  The default
  123. configuration will allocate 4KB per queue.  Typically you should
  124. increase the size and number of buffers if you print many large
  125. jobs.
  126.  
  127.  Usage: LOAD PLPD.NLM [number of buffers] [size of buffer] [delay
  128. interval] [debug level]
  129.  
  130.  number of buffers  -  default value 2
  131.  size of buffer  -  default value is 2KB  units in 1K increments
  132.  delay interval  -  default value is 55 milliseconds
  133.  debug level  -  default value is 0 = no debug
  134.     1 = summary statistics
  135.     2 = every read/write displayed
  136.  
  137.  When PLPD loads, it displays the number of data buffers, size of
  138. data buffers, and delay interval that the PLPD threads wait after
  139. a thread switch.  If debug level is 2, the number of messages
  140. going to the system console will be large.
  141.  
  142.  Examples:
  143.     LOAD PLPD.NLM 3 16 100 - 3 buffers per queue, 16k bytes each,
  144. delay interval 100
  145.     LOAD PLPD.NLM 10 1 - 10 buffers, 1K bytes each, delay 55
  146.  
  147.  6. Expanded the "Protocol Error"  PKERNEL messages to be more
  148. descriptive.
  149.  
  150.  7.  PLPD now checks if the printdef database exists before
  151. trying to open it.  This causes a 15 second delay for each print
  152. job when the printdef does not exist.   This affects customers
  153. using NetWare 4.02.
  154.  
  155.  
  156. Self-Extracting File Name: plpd8.exe
  157.  
  158. Files Included     Size     Date      Time
  159.  
  160. ..\
  161.        PLPD8.TXT     (This file)
  162.         PLPD.NLM           63448         7-31-95      1:17:00 pm
  163.      PLPDCFG.NLM           50128         2-17-95      2:46:06 am
  164.  
  165.  
  166. Installation Instructions:
  167.  
  168. 1)  Backup PLPD.NLM and PLPDCFG.NLM, as a precaution.
  169.  
  170.  2)  Expand the file PLPD8.EXE into its components,
  171.     PLPD.NLM
  172.     PLPDCFG.NLM
  173.     PLPD8.TXT
  174.  
  175.  3)  Copy program files PLPD.NLM and PLPDCFG.NLM into the
  176. SYS:SYSTEM subdirectory of the Flex/IP or NetWare NFS server.
  177.  
  178.  4)  If any of the new command line parameters will be used, add
  179. them to the load command for PLPD in the file 
  180. SYS:SYSTEM/UNISTART.NCF.
  181.  
  182.  5)  Unload the old PLPD and reload the new.
  183.  
  184.  6)  Load  NFSADMIN to review the new options in printer
  185. configuration.   NFSADMIN launches PLPDCFG.NLM.
  186.  
  187.  
  188.  
  189.  
  190. -----------------------------------------------------------------
  191.  Any trademarks referenced in this document are the property of
  192. their respective owners.  Consult your product manuals for
  193. complete trademark information.
  194.  
  195. -----------------------------------------------------------------
  196.  
  197.