home *** CD-ROM | disk | FTP | other *** search
/ Piper's Pit BBS/FTP: ibm 0210 - 0219 / ibm0210-0219 / ibm0213.tar / ibm0213 / ATOPCK12.ZIP / ATOPCK.DOC next >
Encoding:
Text File  |  1994-06-19  |  14.1 KB  |  216 lines

  1.  
  2.                            AUTOPACK Version 1.01
  3.  
  4.          Copyright C-9 Communications - 1994 - All Rights Reserved
  5.                                  Shareware
  6.  
  7.        This document is Copyright 1994 by C-9 Communications, Inc.
  8.  
  9.        PCBoard(R) is Copyright by Clark Development, Inc. - Provo, UT (USA)
  10.  
  11.                                --DISCLAIMER--
  12.  
  13.    AUTOPACK IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
  14.    OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  15.    MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO
  16.    THE QUALITY AND PERFORMANCE IS WITH YOU. SHOULD AUTOPACK PROVE DEFECTIVE,
  17.    YOU (NOT C-9 COMMUNICATIONS, INC.) ASSUME THE ENTIRE COST OF SERVICING,
  18.    OR CORRECTION. IN NO EVENT WILL C-9 COMMUNICATIONS, INC. BE LIABLE TO YOU
  19.    FOR ANY DAMAGES ARISING OUT OF THE USE, OR INABILITY TO USE, THE
  20.    AUTOPACK SOFTWARE.
  21.  
  22.                               --DESCRIPTION--
  23.  
  24.        AutoPack is a COMMAND LINE Driven utility for PCBoard version 15.x
  25.     that enables the SysOp to automatically pack down the conferences
  26.     and save valuable drive space. This is the first utility designed to
  27.     automate the packing of PCBoard Conferences from the COMMAND LINE in
  28.     BATch files!
  29.  
  30.        Selectively pack your PCBoard Conference Files based on COMMAND LINE
  31.     parameters of your own choosing!
  32.  
  33.        Requirements:
  34.  
  35.             The PCBDAT environment variable must be set.
  36.             (example: SET PCBDAT=C:\PCB\PCBOARD.DAT)
  37.  
  38.             Will run on any system that will run MS QuickBasic 4.5!
  39.  
  40.             PCBPACK.EXE must be in your DOS PATH!
  41.  
  42.             You should run AUTOPACK.EXE from the PCB 'HOME' Directory
  43.             (in other words, be on the drive and in the subdirectory
  44.              that you would normally run PCBPACK.EXE from)
  45.  
  46.             DOS Share OR a LAN equivalent capable system (e.g. Novell 3+)
  47.             must be in use.
  48.  
  49.        Believe it or not (when you see it run!)...
  50.  
  51.             *FAST* for a small, stand-alone MS QuickBasic 4.5 Program
  52.             that has to read your CNAMES.@@@ and each MESSAGE BASE file!
  53.  
  54.  
  55.       How to run AUTOPACK:
  56.  
  57.       AUTOPACK is totally COMMAND LINE driven. All parameters must be entered
  58.     preceeded by a - (DASH) and separated from the next parameter by a space.
  59.   +---------------------------------------------------------------------------+
  60.   |  Parameters available:                                                    |
  61.   |                                                                           |
  62.   |  -l         Example: -l1000      (starting conference # to check)         |
  63.   |  -h         Example: -h2000      (ending conference # to check)           |
  64.   |  -d         Example: -d4         (use PCBPACK.EXE parameter /DAY:4)       |
  65.   |  -s         Example: -s3000000   (maximum size in bytes to skip packing   |
  66.   |                                   a conference)                           |
  67.   |  -a         Example: -a350       (minimum size to skip packing a          |
  68.   |                                   conference)                             |
  69.   |  -k         Example: -k          (have PCBPACK.EXE kill the backup file   |
  70.   |                                   that it creates) (this should always    |
  71.   |                                   be used!)                               |
  72.   |  -g        +Example: -g          (log packed conference information to    |
  73.   |                                   AUTOPACK.LOG)                           |
  74.   |  -n        +Example: -n          (spawn PCBPACK.EXE with the /NC          |
  75.   |                                   parameter)                              |
  76.   |  -1        +Example: -1MAX:30    (spawn PCBPACK.EXE with any of the       |
  77.   |                                   other valid parameters)                 |
  78.   |  -2        +Example: -2REN:30    (spawn PCBPACK.EXE with a second, other  |
  79.   |                                   valid parameter)                        |
  80.   | NOTE: -1 and -2 USER supplied PCBPACK.EXE parameters should never be      |
  81.   |       preceeded by a / (slash) (example: -1/MIN:450). AUTOPACK adds the   |
  82.   |       / (slash) for you. AREA: is not a valid -1 or -2 parameter as       |
  83.   |       AUTOPACK always uses that parameter.                                |
  84.   |---------------------------------------------------------------------------|
  85.   |                                                                           |
  86.   | Example:                                                                  |
  87.   |                                                                           |
  88.   | AUTOPACK.EXE -l1 -h6500 -d4 -s4000000 -a400 -k -g -n -1MIN:200            |             |
  89.   |                                                                           |
  90.   | Explanation of Above Example:                                             |
  91.   |                                                                           |
  92.   | Check all Conferences from 1 to 6500 and PCBPACK them if the conference   |
  93.   | message base file is *EITHER* larger than 4,000,000 bytes *OR* the        |
  94.   | conference message base file has more than 400 *ACTIVE* messages in it    |
  95.   | and use the parameters of /AREA:(1-6500) /DAYS:4 /KB /NC /MIN:200         |
  96.   |                                                                           |
  97.   | NOTE: Remember that in the above example, the -g, -n and -1 are only      |
  98.   |       active in the registered version.                                   |
  99.   |                                                                           |
  100.   | In our experience, the prime concern of determining if a conference       |
  101.   | needs to be packed is either if the message base disk file gets too large |
  102.   | or if the message base disk file has too many active messages.            |
  103.   |                                                                           |
  104.   | More Examples:                                                            |
  105.   |                                                                           |
  106.   | AUTOPACK -l10 -h500 -s5500000 -d4 -k -a550 would issue the command:       |
  107.   |     PCBPACK.EXE /AREA:(x) /DAYS:4 /MAX:550 /KB                            |
  108.   |     for any conference found that the Message Base file either            |
  109.   |     exceeded 5,500,000 bytes in size or had more than 550 active          |
  110.   |     messages in it. (and, it would check each conference from 10 to 500)  |
  111.   |                                                                           |
  112.   | AUTOPACK -l50 -h9000 -s3500000 -k -a500 would issue the command:          |
  113.   |     PCBPACK.EXE /AREA:(x) /KB /MAX:500 for any conference found that the  |
  114.   |     Message Base File either exceeded 3,500,000 bytes in size or had      |
  115.   |     more than 500 active messages in it. (and, check the range)           |
  116.   |                                                                           |
  117.   | AUTOPACK -l10 -h500 -d4 -k -a450 would issue the command:                 |
  118.   |     PCBPACK.EXE /AREA:(x) /DAYS:4 /MAX:450 /KB                            |
  119.   |     for any conference found that the Message Base file had more than     |
  120.   |     450 active messages in it. (and, check the range).                    |
  121.   |                                                                           |
  122.   | AUTOPACK -l50 -h9000 -s3500000 -d4 -k would issue the command:            |
  123.   |     PCBPACK.EXE /AREA:(x) /KB /DAYS:4 for any conference found that       |
  124.   |     the Message Base File exceeded 3,500,000 bytes in size. (and, check   |
  125.   |     the range)                                                            |
  126.   |---------------------------------------------------------------------------|
  127.   |                                                                           |
  128.   |  Parameters available showing a + before the Example: are only available  |
  129.   |  in the registered version.                                               |
  130.   |                                                                           |
  131.   |  -l, -h and one or more of the following *MUST* be entered: -s -a         |
  132.   |  AUTOPACK must have a start (low) and an end (high) conference            |
  133.   |  number to process. Likewise, AUTOPACK can not function if it can not     |
  134.   |  discern either a maximum size of the conference disk file OR a           |
  135.   |  maximum number of ACTIVE messages to look for. Remember, -a specifies    |
  136.   |  just the number of messages flagged by PCBOARD as ACTIVE in the file!    |
  137.   |                                                                           |
  138.   +---------------------------------------------------------------------------+
  139.  
  140.   +---------------------------------------------------------------------------+
  141.   |                                                                           |
  142.   |  Caveats ('gotchas'):                                                     |
  143.   |                                                                           |
  144.   |  PCBDAT environment variable NOT set.                                     |
  145.   |                                                                           |
  146.   |  Trying to spawn more than 10 conferences in the unregistered version:    |
  147.   |  AUTOPACK -l10 -h30 ....     ( 30-10 = 20 ))                              |
  148.   |                                                                           |
  149.   |  Setting the -a parameter greater than 16700000 (PCBOARD can't have that  |
  150.   |  many messages in one conference).                                        |
  151.   |                                                                           |
  152.   |  Setting the -l parameter higher than the -h parameter.                   |
  153.   |                                                                           |
  154.   |  Setting the -l parameter to 0 (we chose NOT to ever pack conference 0).  |
  155.   |                                                                           |
  156.   |  Setting the -h parameter either higher than what your PCBOARD.DAT is     |
  157.   |  configured for or higher than the ACTUAL conference disk files you have  |
  158.   |  physically on the disk(s) or higher than 65534 (PCBoard can't have)      |
  159.   |  more than 65535 physical conferences and 0 (Main Board) counts as 1      |
  160.   |                                                                           |
  161.   +---------------------------------------------------------------------------+
  162.  
  163.   +---------------------------------------------------------------------------+
  164.   |                                                                           |
  165.   | Registration:                                                             |
  166.   |                                                                           |
  167.   | A paltry $10.00 (Although this program is written in QB4.5, a lot of      |
  168.   | of hours were spent in optimizing for the speed this QB4.5 code has).     |
  169.   |                                                                           |
  170.   | Entitles you to all future upgrades free of charge.                       |
  171.   |                                                                           |
  172.   | How to register:  (fill out the following form)                           |
  173.   |                                                                           |
  174.   | Name:     __________________________________                              |
  175.   |                                                                           |
  176.   | Address: ___________________________________                              |
  177.   |                                                                           |
  178.   |          ___________________________________                              |
  179.   |                                                                           |
  180.   | City:    ___________________________________                              |
  181.   |                                                                           |
  182.   | State/Territory: ___________________________ Country: _______________     |
  183.   |                                                                           |
  184.   | ZIP/Mailing Code: __________________________                              |
  185.   |                                                                           |
  186.   | Line #2 (EXACT) of your PCBOARD.DAT file: _______________________________ |
  187.   |                                                                           |
  188.   | Line #94 (EXACT) of your PCBOARD.DAT file: ______________________________ |
  189.   |                                                                           |
  190.   | Mail US Funds to: C-9 Communications, Inc.                                |
  191.   |                   17560-B Keith Harrow                                    |
  192.   |                   Suite 103                                               |
  193.   |                   Houston, TX 77084                                       |
  194.   |                                                                           |
  195.   |                                                                           |
  196.   |   Registration FEE:                                     $10.00 US         |
  197.   |   Check Here if Texas Resident!: ______                                   |
  198.   |                                                                           |
  199.   |   FREQ the Registered version to you?                                     |
  200.   |     (must be in continental US)                                           |
  201.   |   Enter Complete Fido Node Number if FREQ requested! ___________________  |
  202.   |                                                                           |
  203.   |   Send UUENCODED via the InterNet?                                        |
  204.   |   Enter Complete InterNet Address if UUENCODE requested!                  |
  205.   |                                                                           |
  206.   |   ________________@_____________________________________________________  |
  207.   +---------------------------------------------------------------------------+
  208.  
  209.   For Support or Questions:
  210.  
  211.           FidoNet : 1:106/99
  212.           InterNet: autopack@cld9.com
  213.  
  214.   <AUTOPACK version 1.02 Documentation (revised 06/19/1994)>
  215.   <END OF FILE>
  216.