home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / OFFLINE / AD2QWK9B.ZIP / ADD2QWK.DOC < prev    next >
Text File  |  1992-08-20  |  14KB  |  463 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.              Add2QWK - Adds personal downloads to .QWK packets
  20.  
  21.  
  22.              Release 0.90ß
  23.  
  24.  
  25.              August 20, 1992
  26.  
  27.  
  28.              (c) Copyright Eddie Rowe (Work in Progress)
  29.                  All Rights Reserved
  30.  
  31.  
  32.              Eddie Rowe
  33.              P.O. Box 434
  34.              Ruston, LA 71273
  35.  
  36.  
  37.              HOTLine RBBS
  38.              (318)-254-0019 (v.32bis)
  39.              Fidonet 1:19/124
  40.              RBBSNet 8:975/6
  41.  
  42.  
  43.              Table of Contents
  44.  
  45.  
  46.              Copyright and License                                 1
  47.              Warranty                                              1
  48.              What is Add2QWK?                                      1
  49.              Software Requirements                                 1
  50.              Hardware Requirements                                 2
  51.              Acknowledgments                                       2
  52.              Installation                                          3
  53.              Operation                                             4
  54.              Author's Committment                                  5
  55.              Future Enhancments                                    5
  56.              Add2QWK Development                                   5
  57.              Add2QWK History                                       6
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.         Add2QWK (.90b)                                            Page 1
  70.  
  71.  
  72.  
  73.          COPYRIGHT AND LICENSE
  74.  
  75.              Add2QWK is (c) by Eddie Rowe (Work in Progress)
  76.              All Rights Reserved.
  77.  
  78.              You are hereby granted a limited license to use, copy and
  79.              distribute Add2QWK on the following conditions:
  80.  
  81.              1.  You may use the program for any non-commercial or
  82.                  commercial purpose.
  83.  
  84.              2.  You may copy and distribute as many copies of this
  85.                  program, provided you do not charge money for the
  86.                  program.  A small fee (for copying, handling,
  87.                  mailing, and the disk containing the copy) is
  88.                  allowed, but this amount shall NOT exceed your real
  89.                  costs.
  90.  
  91.              3.  The program and documentation shall NOT be modified
  92.                  in any way.  While permission is granted for the
  93.                  conversion of the distribution archive to one's
  94.                  favorite flavor, files shall NOT be added or deleted
  95.                  from said archive.
  96.  
  97.  
  98.          WARRANTY
  99.  
  100.              No warranty of any kind is offered on Add2QWK except that
  101.              it may occupy valuable disk space.
  102.  
  103.              Furthermore, you use this program AT YOUR OWN RISK.
  104.              Under no circumstances shall the author be liable for
  105.              damage this software may inflict upon your or your
  106.              property - either by itself or with your help.
  107.  
  108.  
  109.          WHAT IS Add2QWK?
  110.  
  111.              Add2QWK is designed for the sysop who has users who
  112.              prefer to do a turbo logon directly to the QWK mail door.
  113.              Add2QWK will insert any outstanding personal downloads
  114.              into the user's QWK packet and overwrite the EPILOG
  115.              screen contained in the QWK packet so when the user exits
  116.              the packet they are alerted that their personal download
  117.              was included.
  118.  
  119.  
  120.          SOFTWARE REQUIREMENTS
  121.  
  122.              RBBS
  123.  
  124.              To use Add2QWK you must first have a copy of RBBS-PC
  125.              installed (and working).  This version of Add2QWK was
  126.              developed with RBBS-PC 17.4 with Maple merges and should
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.         Add2QWK (.90b)                                            Page 2
  136.  
  137.  
  138.  
  139.              work along side any previous/future versions of RBBS-PC
  140.              provided the Personal Directory's structure is in line
  141.              with RBBS-PC 17.4's.
  142.  
  143.              QWK Mail Door
  144.  
  145.              Add2QWK was developed alongside Chip Morrow and Doug
  146.              Wilson's Mail Manager Plus QWK mail door.  Add2QWK is NOT
  147.              hard coded to work only with Mail Manager.  I have used
  148.              their mail door for many months now and Add2QWK was
  149.              written for my users and is now being shared with you.
  150.              If you are using another mail door and make the necessary
  151.              modifications so that Add2QWK will work alongside your
  152.              QWK mail door, I would appreciate it if you would drop
  153.              off an archive with examples of how you did it.  This
  154.              will enable me to help others out in the future by
  155.              distributing such information.
  156.  
  157.              Archivers
  158.  
  159.              Add2QWK has been tested with Robert K. Jung's ARJ,
  160.              Haruyasu Yoshizaki's LHA and Phil Katz's PkZIP.  Add2QWK
  161.              is NOT hard coded to support only these, but does require
  162.              that the archiver read a filename which is actually a
  163.              list of files.  If you add some additional archivers, I
  164.              would sincerely appreciate a copy of your batch
  165.              file/command line to share with others.
  166.  
  167.              If you need to pickup these files, I have the following
  168.              versions which I have tested & use currently:
  169.  
  170.                                 ARJ230.EXE 200k
  171.                                 LHA213.EXE  44k
  172.                                 PKZ110.EXE 150k
  173.  
  174.              These are File Requestable the normal 23 hours per day at
  175.              v.32bis speeds from 1:19/124.  You could also logon as
  176.              (name) NOSNAIL LATEST (password) VERSION and access my
  177.              personal download directory which contains these.
  178.  
  179.  
  180.          HARDWARE REQUIREMENTS
  181.  
  182.              There should be no hardware requirements in excess of
  183.              those you are currently operating under with RBBS-PC.  To
  184.              quote Jan Terpstra, "think about that for a while....".
  185.  
  186.  
  187.          ACKNOWLEDGEMENTS
  188.  
  189.              The RBBS-PC community.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.         Add2QWK (.90b)                                            Page 3
  202.  
  203.  
  204.  
  205.          INSTALLATION
  206.  
  207.              Step 1 - RBBS-PC SETUP
  208.  
  209.              Your personal downloads directory should already be setup
  210.              and most likely contains a few entries of files.  If you
  211.              have not setup your personal downloads directory, refer
  212.              to the RBBS-PC documentation.
  213.  
  214.  
  215.              STEP 2 Add2QWK.CFG
  216.  
  217.              A sample configuration file is included in the
  218.              distribution archive - identical to the one presently
  219.              being used on my system.  There should NOT be any
  220.              comments in the configuration file!
  221.  
  222.              Sample Add2QWK.CFG File:
  223.  
  224.              c:\rbbs\personal\
  225.              priv.def
  226.  
  227.              Line 1 is the full path (with a trailing "\") to your
  228.              personal downloads directory.
  229.  
  230.              Add2QWK REQUIRES ALL personal files to be located here!!!
  231.  
  232.              Line 2 is the name of your personal download directory.
  233.  
  234.  
  235.              STEP 3 - Modification of RBBSQWK.BAT
  236.  
  237.              Your RBBSQWK.BAT file needs to be replace with one that
  238.              calls Add2QWK.  (Note to none Mail Manager users:
  239.              RBBSQWK.BAT is the batch file that Mail Manager uses to
  240.              create its archives.  You are on your own here if you do
  241.              not use Mail Manager.  Sorry.)  By all means SAVE A COPY
  242.              OF YOUR WORKING BATCH FILE!  I've included a copy of the
  243.              one I use so feel free to use it after making any
  244.              necessary changes for paths, etc.
  245.  
  246.  
  247.              STEP 4 - Placement of EPILOG
  248.  
  249.              The EPILOG screen (the one which will replace the normal
  250.              EPILOG screen in the QWK packet when the user has a
  251.              personal download) needs to be placed inside your
  252.              personal downloads directory.  I've included the one I
  253.              use as a beginning point for you.  I suggest if you have
  254.              users who are not capable of support IBM graphics that
  255.              you make this an ASCII file....
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.         Add2QWK (.90b)                                            Page 4
  268.  
  269.  
  270.  
  271.              STEP 5 - Placement of Add2QWK.EXE
  272.  
  273.              You may place the executable of Add2QWK anywhere as long
  274.              as you remember to edit RBBSQWK.BAT to provide a full
  275.              path to its directory should it NOT be in your DOS path.
  276.  
  277.  
  278.              STEP 6 - Setting DOS environmental variable for the port
  279.  
  280.              While I would like to learn to use the fossil to send
  281.              text out the COM port, I currently have not learned
  282.              enough about fossils to begin this task.  Single node
  283.              systems need only hard code their batch files to send
  284.              some text out the COM port, but multinode systems cannot
  285.              do this for obvious reasons. 8-)  If you are not using an
  286.              environmental variable for your ports, might I suggest
  287.              the following for com2:
  288.  
  289.              Set port = 2
  290.  
  291.              Then in your batch file you can echo text to the com port
  292.              like this:
  293.  
  294.              Echo This is neat stuff > com%port%
  295.  
  296.  
  297.          OPERATION
  298.  
  299.              Add2QWK's operation thrives on the command line.  Add2QWK
  300.              will not run if it does not find the necessary infomation
  301.              on the command line.  Multinode systems will want to make
  302.              use of the %node% environmental variable.  Here is the
  303.              syntax used to call Add2QWK:
  304.  
  305.              Add2QWK /CFG:xxx /DOR:yyy
  306.  
  307.              xxx = the full path and name of your configuration file
  308.              yyy = the full path and name of your dorinfox.def file
  309.  
  310.              As you might imagine Add2QWK does a bit of manipulation
  311.              of the personal download directory.  In order to
  312.              hopefully minimize problems, Add2QWK copies your personal
  313.              directory to the file ADD2QWK.OLD each time it runs.
  314.              Add2QWK reads in each line of the personal directory and
  315.              looks for matches.  As it reads the information in from
  316.              the personal directory, it writes a duplicate copy of the
  317.              personal directory as ADD2QWK.NEW.  The ONLY difference
  318.              between your ADD2QWK.OLD and ADD2QWK.NEW will be the
  319.              character in column 105.  If Add2QWK finds a file
  320.              belonging to the user in the QWK mail door, it replaces
  321.              the "*" in column 105 with a "!".  After Add2QWK reaches
  322.              the end of the file, it copies ADD2QWK.NEW on top of the
  323.              old personal directory.  If this does not work for you
  324.              (ie those who multitask) PLEASE LET ME KNOW!!!  I would
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.         Add2QWK (.90b)                                            Page 5
  334.  
  335.  
  336.  
  337.              also be grateful to any suggestions you could offer.
  338.  
  339.  
  340.          AUTHOR'S COMMITMENT
  341.  
  342.              Add2QWK was written for my users who prefer to do
  343.              business with the QWK mail door.  While I have some ideas
  344.              for fine turning Add2QWK, I cannot speculate as to when I
  345.              may have an opportunity to work on them.  If you enjoy
  346.              Add2QWK and would like to see something added/changed to
  347.              it then by all means drop me a netmail note detailing
  348.              your ideas.  I always relish netmail from people who have
  349.              found my software to be of use to them!  Might I suggest
  350.              you use my Fidonet address if possible as Fidonet is
  351.              netmail routing friendly.
  352.  
  353.  
  354.          BUG REPORTS
  355.  
  356.              If you experience any difficulty with Add2QWK, strip your
  357.              system of any software which may be resident and
  358.              potentially causing conflicts.  If you ARE able to point
  359.              the finger at a TSR or device driver, please pass this
  360.              information on to me so I can document it and attempt to
  361.              remedy.  If the item is a shareware product which would
  362.              allow you to send me a copy, please do.  If not please
  363.              supply me with complete information as to the name &
  364.              version of the software and the address & phone number of
  365.              the author.
  366.  
  367.              If you are unable to point the finger at anything on your
  368.              system, then it is time to let me try to duplicate it
  369.              here.  In order for me to do this I will need the
  370.              following as a minimum:
  371.  
  372.                   1.  DOS manufacturer and version
  373.                   2.  Machine type (microprocessor), manufacturer,
  374.                       bios manufacturer & date
  375.                   3.  Environment under which you operate.
  376.                   4.  Copy of your AUTOEXEC.BAT and CONFIG.SYS
  377.                   5.  Add2QWK.CFG
  378.                   6.  Complete details as to what is wrong, how
  379.                       discovered, and attempted futile remedies.
  380.  
  381.              Archive the various files into a unique archive which
  382.              includes your node address as part of the name if you
  383.              have an address, else dream something up.
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.         Add2QWK (.90b)                                            Page 6
  400.  
  401.  
  402.  
  403.          FUTURE ENHANCEMENTS
  404.  
  405.              For those that are curious, here are my tentative future
  406.              plans:
  407.  
  408.              1.  Continue to squash any buglets which spring up and
  409.                  a continued optimization of the code for efficiencies
  410.                  sake - no sense getting sloppy in the beginning.
  411.  
  412.              2.  Support a fossil driver to control messages going out
  413.                  the COM port.
  414.  
  415.  
  416.          Add2QWK DEVELOPMENT
  417.  
  418.              Add2QWK was developed under Digital Research's DOS 6.0
  419.              QuarterDeck's DESQview 2.41.  While there is NO support
  420.              coded for DESQview, it has been operating happily in the
  421.              window used for Binkley/RBBS-PC.
  422.  
  423.  
  424.          Add2QWK HISTORY
  425.  
  426.  
  427.              0.90ß  August 21, 1992 - First public release of Add2QWK
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.