home *** CD-ROM | disk | FTP | other *** search
/ norge.freeshell.org (192.94.73.8) / 192.94.73.8.tar / 192.94.73.8 / pub / computers / pcjr / arc / PAKUTL12.LZH / PAKMAIL.DOC < prev    next >
Text File  |  1988-09-14  |  15KB  |  326 lines
  1.  
  2.  
  3.  
  4.         -----------------------------------------------------------------
  5.                  Using PAKAS and PAKSE for "safe" Archived Mail
  6.                          on the IFNA(tm) Amateur Network
  7.         -----------------------------------------------------------------
  8.  
  9.         This  text file should be part of a public-domain archive  titled 
  10.         "PAKUTLxx.PAK", where "xx" is the version/release number.  (xx=12 
  11.         for version 1.2, as of this writing.) The .PAK suffix is the Mike 
  12.         Housky's personal preference for naming archives produced by Phil 
  13.         Katz's  PKPAK/PKPAKJR programs (and which may not be  extractable 
  14.         by the SEA ARC and ARCE programs), but this may have been renamed 
  15.         to  .ARC  by  some overly-conformist sysop  along  the  line.  No 
  16.         matter.  You  should  find the  following  programs,  along  with 
  17.         documentation and complete *source*:
  18.  
  19.           PAKLIST.EXE  Quick list of .PAK/.ARC contents to console.
  20.           PAKSORT.EXE  Sort contents of .PAK/.ARC archives.
  21.           PAKAS.EXE    ARCA.COM replacement, uses PKPAK+PAKSORT to
  22.                        produce or update sorted .PAK/.ARC archives.
  23.           PAKSE.EXE    ARCE.COM replacement, uses PAKSORT+PKUNPAK to
  24.                        extract .PAK/.ARC archive members in sorted order.
  25.  
  26.         If any of the above are missing (or source is not included)  rush 
  27.         to your dealer for a refund!
  28.  
  29.         -----------------------------------------------------------------
  30.                                   Introduction
  31.         -----------------------------------------------------------------
  32.  
  33.         The substantial performance of the PKWARE archive utilities  over 
  34.         earlier archive programs (15-25% faster than ARCA, with generally 
  35.         better compression even in "compatibility" mode, by my reckoning) 
  36.         has prompted many sysops in the IFNA network and elsewhere to use 
  37.         these  programs  for archived (echo)mail processing. This  is  no 
  38.         problem  when  extracting archived packets,  since  PKUNPAK  (nee 
  39.         PKXARC)  is completely compatible with prior  programs.  However, 
  40.         the  PKPAK  utility (nee PKARC) is not entirely  compatible  with 
  41.         older archive programs:
  42.  
  43.           1. PKPAK  provides  an additional compression  method  (dynamic 
  44.              LZW,  or  "squashing")  which  is  not  understood  by   the 
  45.              "vanilla" ARCE program.
  46.  
  47.           2. PKPAK  timestamps the finished archive with the that of  the 
  48.              newest file contained, rather that the date/time of update.
  49.  
  50.           3. PKPAK  sorts the member files by file name/type rather  than 
  51.              order of entry into the archive.
  52.  
  53.           4. (Last  but least) the PKPAK command name and  arguments  are 
  54.              different from older programs.
  55.  
  56.         Item  4 is easily defeated with a "filter" program  that  adjusts 
  57.         the arguments. Also, PKPAK has command line options for timestamp 
  58.         and  compression method compatibility with the earlier  programs, 
  59.         which solve items 1 and 2. The order of files within the  archive 
  60.         is  not  usually  important,  but is  crucial  to  archived  mail 
  61.         processing.
  62.  
  63.  
  64.  
  65.         PAKMAIL.DOC [12-Sept-1988]                               Page 1
  66.  
  67.  
  68.  
  69.         -----------------------------------------------------------------
  70.                                   Introduction
  71.                                    (continued)
  72.         -----------------------------------------------------------------
  73.  
  74.         Typical  archived  mail programs will  accumulate  multiple  mail 
  75.         packets for a single destination node into a single archive until 
  76.         it  is  ultimately transferred. There is an  embedded  assumption 
  77.         (weak,  perhaps, but reasonable considering the state of  affairs 
  78.         when the archived mail concept was first put into practice)  that 
  79.         the  member packets would be extracted in order of creation,  and 
  80.         this  is  the  "raison d' etre" of PAKSORT  and  the  PAKAS/PAKSE 
  81.         front-end programs. 
  82.  
  83.         PAKSORT  will  resort the members of a .PAK  or  .ARC  compatible 
  84.         archive in a variety of orders. The most useful for archived mail 
  85.         is  date/time order, and this is the default if no sort  criteria 
  86.         are stated.
  87.  
  88.         PAKAS.EXE  is a plug-compatible replacement for  ARCA.COM,  which 
  89.         uses  PKPAK  to pack the mail packets and PAKSORT to  resort  the 
  90.         resulting  bundle (if necessary) into date/time  creation  order. 
  91.         This  should  have the intended result, except perhaps  around  a 
  92.         system  date/time change (use care during  the  Daylight/Standard 
  93.         time  changes.)  Other than that, PAKAS should produce  the  same 
  94.         packet  order withn a bundle as ARCA, and even correct for a  few 
  95.         unusual  circumstances  arising from manual interruption  of  the 
  96.         mail  process  and resumption after directory changes  have  been 
  97.         made.
  98.  
  99.         PAKSE.EXE  is a plug-compatible replacement for  ARCE.COM,  which 
  100.         uses  PAKSORT to reorder packets within an incoming  bundle  into 
  101.         date/time order before calling PKUNPAK to extract the  individual 
  102.         packets. This is mainly provided as a guard against unsorted  PK-
  103.         packed  bundles from a "first-level" feed. If any BBS  "upstream" 
  104.         has  unpacked and repacked messages from an out-of-order  bundle, 
  105.         then no correction is possible.
  106.  
  107.         The balance of this document is directed to sysops running  Opus-
  108.         CBCS,  but sysops of other IFNA mail-compatible BBS programs  may 
  109.         also find this useful. Also, I am assuming that "bundle" means an 
  110.         archived  file  containing mail packets. If this is  poor  usage, 
  111.         then I apologize.
  112.  
  113.         -----------------------------------------------------------------
  114.                                   Installation
  115.         -----------------------------------------------------------------
  116.  
  117.         The installation procedure below makes certain assumptions  about 
  118.         your setup:
  119.  
  120.         First, the examples presume that the Opus and related  executable 
  121.         files  are in a directory named "C:\OPUS", which is  included  at 
  122.         the  front  of  the search path during  BBS  execution,  but  not 
  123.         necessarily  part of the path during non-BBS keyboard  operation. 
  124.         This  directory is presumed to contain the regular  ARCA.COM  and 
  125.         ARCE.COM files.
  126.  
  127.  
  128.  
  129.  
  130.         PAKMAIL.DOC [12-Sept-1988]                               Page 2
  131.  
  132.  
  133.  
  134.         -----------------------------------------------------------------
  135.                                   Installation
  136.                                    (continued)
  137.         -----------------------------------------------------------------
  138.  
  139.         Second,  the examples presume that a temporary working  directory 
  140.         for  unpacking  the  archives  can be  created  on  drive  C:  as 
  141.         C:\PAKUTL.
  142.  
  143.         Third,  the  examples presume that your "regular"  utilities  are 
  144.         stored  in  a  directory named "C:\UTILS",  which  appears  AFTER 
  145.         C:\OPUS in the DOS PATH.
  146.  
  147.         INSTALLATION PROCEDURE:
  148.  
  149.           0.  First,  get a copy of PK361.EXE: Earlier versions  are  NOT 
  150.         recommended. 
  151.  
  152.           1. Make the working directory:
  153.              >C:
  154.              >MD \PAKUTL
  155.              >CD \PAKUTL
  156.  
  157.           2. Copy files (presuming originals on floppy drive A: root) and 
  158.         unpack archives:
  159.              >COPY A:PK361.EXE        -- Get PK v3.61 distribution file.
  160.              >COPY A:PAKUTL12.PAK     -- Get PAKUTL distribution file.
  161.              >PK361                   -- Extract PKWARE .EXE files (only)
  162.              >DEL PK361.EXE           -- Done with this now.
  163.              >PKUNPAK PAKUTL12.PAK    -- Extract PAKxxx utilities and
  164.                                          documentation.
  165.              >DEL PAKUTL12.PAK        -- Done with this now.
  166.  
  167.           3. Change to the Opus utility directory and make backup  copies 
  168.         of  your  existing  ARCA/ARCE  for quick  uninstall  in  case  of 
  169.         problems:
  170.              >C:
  171.              >CD \OPUS
  172.              >REN ARCA.COM ARCAOLD.COM
  173.              >REN ARCE.COM ARCEOLD.COM
  174.  
  175.          4. Copy executable files for PAKAS/PAKSE:
  176.              >COPY C:\PAKUTL\PAKSORT.EXE
  177.              >COPY C:\PAKUTL\PKPAK[JR].EXE PKPAK.EXE
  178.              >COPY C:\PAKUTL\PKUNPAK[J].EXE PKUNPAK.EXE
  179.              >COPY C:\PAKUTL\PAKAS.EXE ARCA.EXE
  180.              >COPY C:\PAKUTL\PAKSE.EXE ARCE.EXE
  181.  
  182.         Now  you  should be ready to test PAKAS and PAKSE  with  archived 
  183.         mail.  I strongly recommend that you test this with  "disposable" 
  184.         packets before committing to regular use with IFNA mail. The most 
  185.         likely  problem  to encounter is lack of memory to run  PKPAK  or 
  186.         PAKSE+PKUNPAK,  especially if you are running a multitasker.  See 
  187.         the  memory requirements below for estimates. I  recommend  using 
  188.         the  PKPAKJR and PKUNPAKJ programs when memory space is  limited. 
  189.         Even so, these utilities require substantially more RAM than  the 
  190.         "vanilla" ARCA/ARCE and may not run in your environment.
  191.  
  192.  
  193.  
  194.  
  195.         PAKMAIL.DOC [12-Sept-1988]                               Page 3
  196.  
  197.  
  198.  
  199.         -----------------------------------------------------------------
  200.                                   Installation
  201.                                    (continued)
  202.         -----------------------------------------------------------------
  203.  
  204.         If for any reason you need to "uninstall" PAKAS and/or PAKSE, the 
  205.         following procedure should get you right back to normal:
  206.              >DEL C:\OPUS\ARCA.EXE
  207.              >DEL C:\OPUS\ARCE.EXE
  208.              >REN C:\OPUS\ARCAOLD.COM ARCA.COM
  209.              >REN C:\OPUS\ARCEOLD.COM ARCE.COM
  210.  
  211.         -----------------------------------------------------------------
  212.                           PAKUTL12 Memory Requirements
  213.         -----------------------------------------------------------------
  214.  
  215.         Approximate memory requirements for version 1.2 PAKUTL programs:
  216.  
  217.              PAKSORT   50K
  218.              PAKLIST   48K
  219.              PAKAS     14K+125K if PKPAK is used     = 139K
  220.                        14K+90K  if PKPAKJR is used   = 104K
  221.              PAKSE     92K if PKUNPAK is used
  222.                        68K if PKUNPAKJ is used
  223.  
  224.         The PAKAS/PAKSE requirments are based upon PK[un]PAK memory usage 
  225.         as  published  by PKWARE, Inc. I have to take  these  figures  on 
  226.         faith,  since  these programs are  "undebuggable"  ...  defeating 
  227.         empirical  tests of memory use, or at least the easy ones that  I 
  228.         can think of at the moment. The versions of ARCA.COM and ARCE.COM 
  229.         which I have encountered seem to require much less:
  230.  
  231.              ARCA      32K (better performance if 36K+ is available)
  232.              ARCE      63K (better performance if 67K+ is available)
  233.  
  234.         As you can see, the main problem is that the PAKAS step (the most 
  235.         important,  of course) requires at least 72K more RAM than  ARCA. 
  236.         This   is  of  particular  importance  if  you  are   running   a 
  237.         multitasker. In some circumstances, you may be able to make  room 
  238.         by  reorganizing  your  mail  procedure  to  allow  packing   and 
  239.         unpacking  of bundles by smaller external programs,  rather  than 
  240.         as  a  part of a larger program's operation.
  241.  
  242.         One  of the testers was able to remove the  multitasker  entirely 
  243.         and  run  a  full-size  machine during  mail  processing,  on  an 
  244.         automated basis. Another tester reported that a partition of 320K 
  245.         was sufficient for mail processing with OMMM to pack bundles  and 
  246.         Opus  (with -u) to unpack them. Personally, I don't  have  enough 
  247.         experience with M'taskers to be more specific at this time.
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.         PAKMAIL.DOC [12-Sept-1988]                               Page 4
  261.  
  262.  
  263.  
  264.         -----------------------------------------------------------------
  265.                             Copyright, Warranty, Etc.
  266.         -----------------------------------------------------------------
  267.  
  268.         The  attached  programs  are the  copyrighted  original  work  of 
  269.         Michael J. Housky and Jeffrey J. Nonken. These have been released 
  270.         to the public domain with full source code as of September, 1988. 
  271.  
  272.         The  materials  herein  are provided "as  is",  with  no warranty 
  273.         expressed or implied.
  274.  
  275.              "Results are not guaranteed, but if not perfectly satisfied, 
  276.              your wasted time will be refunded."
  277.                      - Norton Juster, The Phantom Tollbooth
  278.  
  279.         -----------------------------------------------------------------
  280.  
  281.         The authors may be reached for comment via IFNA netmail at:
  282.  
  283.              Mike Housky, via Hog Heaven (1:103/522.6)
  284.  
  285.              Jeffrey Nonken, Sysop of Opus Julius (1:103/522)
  286.              (714)997-8958 (1200/2400)
  287.              (714)997-9342 (300/1200)
  288.  
  289.         First-person  references  in  this document  are  those  of  Mike 
  290.         Housky.
  291.  
  292.         -----------------------------------------------------------------
  293.                                 Acknowledgements
  294.         -----------------------------------------------------------------
  295.  
  296.            - PKWARE, PKPAK, PKPAKJR, PKUNPAK and PKUNPAKJ are trademarks 
  297.              of PKWARE Inc.
  298.            - ARC and SEA are trademarks of Software Enhancement 
  299.              Associates.
  300.            - ARCA and ARCE are names of programs distributed by Software 
  301.              Enhancement Associates and as such may be trademarks of 
  302.              same.
  303.            - FidoNet and IFNA are trademarks of the International FidoNet 
  304.              Association.
  305.  
  306.         Thanks  are due to Bowen Goletz (sysop: Post Central,  1:103/516) 
  307.         and  Dan Thomson (sysop: Sam's Place, 1:163/34) for  volunteering 
  308.         to test the programs prior to general release.
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.         PAKMAIL.DOC [12-Sept-1988]                               Page 5
  326.