home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / RA / QNET266A.ZIP / QECHO.DOC < prev    next >
Encoding:
Text File  |  1988-08-20  |  14.0 KB  |  595 lines

  1.  
  2.                      ****   *******   ****  **  **    ***
  3.                     **  **   **   *  **  ** **  **   ** **
  4.                     **  **   ** *   **      **  **  **   **
  5.                     **  **   ****   **      ******  **   **
  6.                     ** ***   ** *   **      **  **  **   **
  7.                      ****    **   *  **  ** **  **   ** **
  8.                        ***  *******   ****  **  **    ***
  9.           
  10.               Version 1.00 - (C) Copyright 1988 by Adam C. Hudson
  11.           
  12.                          A QuickBBS EchoMail Processor
  13.           
  14.           
  15.           
  16.           
  17.           
  18.           
  19.           
  20.           
  21.           
  22.           
  23.           
  24.           
  25.           
  26.           
  27.           
  28.           
  29.           
  30.           
  31.           
  32.           
  33.           
  34.           
  35.           
  36.           
  37.           
  38.           
  39.           
  40.           
  41.           
  42.           
  43.           
  44.           
  45.           
  46.           
  47.           
  48.           
  49.           
  50.           
  51.           
  52.           
  53.           
  54.           
  55.           
  56.           
  57.           
  58.           
  59.           
  60.           
  61.           
  62.           
  63.           
  64.           
  65.  
  66.  
  67.  
  68.                                TABLE OF CONTENTS
  69.                                -----------------
  70.           
  71.           
  72.                         Section 1:  Introduction
  73.                         Section 2:  Configuration File
  74.                         Section 3:  Command Line Parameters
  75.                         Section 4:  Defining EchoMail Areas
  76.           
  77.           
  78.           
  79.           
  80.           
  81.           
  82.           
  83.           
  84.           
  85.           
  86.           
  87.           
  88.           
  89.           
  90.           
  91.           
  92.           
  93.           
  94.           
  95.           
  96.           
  97.           
  98.           
  99.           
  100.           
  101.           
  102.           
  103.           
  104.           
  105.           
  106.           
  107.           
  108.           
  109.           
  110.           
  111.           
  112.           
  113.           
  114.           
  115.           
  116.           
  117.           
  118.           
  119.           
  120.           
  121.           
  122.           
  123.           
  124.           
  125.           
  126.           
  127.           
  128.           
  129.           
  130.           
  131.  
  132.  
  133.  
  134.                         Section 1 - QECHO Introduction
  135.                         ------------------------------
  136.           
  137.           
  138.               QECHO is the heart of EchoMail processing for QuickBBS.
  139.          It is used to import, export, or forward any EchoMail
  140.          messages in up to 200 conferences at one time.  This manual
  141.          assumes you have current knowledge on how EchoMail works and
  142.          it's purpose.  This manual also assume you have a current
  143.          copy of QuickBBS (2.03 or higher) up and running on your
  144.          system.
  145.           
  146.           
  147.           
  148.           
  149.           
  150.           
  151.           
  152.           
  153.           
  154.           
  155.           
  156.           
  157.           
  158.           
  159.           
  160.           
  161.           
  162.           
  163.           
  164.           
  165.           
  166.           
  167.           
  168.           
  169.           
  170.           
  171.           
  172.           
  173.           
  174.           
  175.           
  176.           
  177.           
  178.           
  179.           
  180.           
  181.           
  182.           
  183.           
  184.           
  185.           
  186.           
  187.           
  188.           
  189.           
  190.           
  191.           
  192.           
  193.           
  194.           
  195.           
  196.           
  197.  
  198.  
  199.  
  200.                       Section 2: QECHO Configuration File
  201.                       -----------------------------------
  202.           
  203.           
  204.               QECHO can reside in almost any directory of your drive
  205.          (or drives), but the configuration file must be located in
  206.          the current directory you run QECHO from.
  207.           
  208.               The configuration file is called QECHO.CTL, it is a text
  209.          file that can be edited/created by using most any popular
  210.          editor (even DOS's EDLIN!).  Here is a sample configuration
  211.          file:
  212.           
  213.          ;
  214.          ;  QECHO Control file for Adam Hudson (1:104/24.0)
  215.          ;
  216.          Node         104/24
  217.          Aka          1/114
  218.          ArcCommand   PKARC /OCT A
  219.          UnArcCommand PKXARC -R
  220.          PointNet     2400
  221.          ;
  222.          DupPath      C:\BINKLEY\DUPMSGS
  223.          MailPath     C:\BINKLEY\MESSAGES
  224.          FilesPath    C:\BINKLEY\FILES
  225.          ArchivePath  C:\BINKLEY\OUTARC
  226.          OutboundPath C:\BINKLEY\OUTBOUND
  227.          QuickBBSPath C:\QUICKBBS
  228.           
  229.          Explanations of control file statements are as follows:
  230.           
  231.            NODE  [Net]/[Node]
  232.           
  233.            This statement specifies what your network address is, this
  234.            is your main network address and NOT your alias addresses.
  235.           
  236.            AKA [Net]/[Node] [Net]/[Node] ...
  237.           
  238.            This statement specifies all of your additional network
  239.            addresses, you may specify up to ten alias addresses.
  240.           
  241.            ARCCOMMAND [Command Line]
  242.           
  243.            This statement defines the DOS command line to archive a
  244.            file.  This is used when you specify the -A command line
  245.            switch (explained later).  To use the popular PKARC utility
  246.            you would enter:
  247.               PKARC /OCT A
  248.           
  249.            UNARCCOMMAND [Command Line]
  250.           
  251.            This statement defines the DOS command line to extract an
  252.            archive.  This is used when you specify the -U command line
  253.            switch (explained later).  To use the popular PKXARC
  254.            utility, you would enter:
  255.               PKXARC -R
  256.           
  257.            POINTNET [Net Number]
  258.           
  259.            This control file line defines your private point network
  260.            number.  If you do not send to point systems then please
  261.            omit this line.
  262.           
  263.  
  264.  
  265.  
  266.            DUPPATH [d:][path][\]
  267.           
  268.            This line specifies the DOS path where duplicate messages
  269.            will be placed.  If this statement is omitted, then
  270.            duplicate messages will NOT be saved.
  271.           
  272.            MAILPATH [d:][path][\]
  273.           
  274.            This line specifies the DOS path where your network mail
  275.            is stored in the .MSG file form.  This is required!
  276.           
  277.            FILESPATH [d:][path][\]
  278.           
  279.            This line specifies the DOS path where your mailer places
  280.            inbound files.  This is required!
  281.           
  282.            ARCHIVEPATH [d:][path][\]
  283.           
  284.            This statement specifies the DOS path where QECHO will
  285.            place outbound archive files.  This should never be the
  286.            same as the FILESPATH!  This is required if using the -A
  287.            command line switch (explained later).
  288.           
  289.            OUTBOUNDPATH [d:][path][\]
  290.           
  291.            This statement specifies the DOS path where your oMMM
  292.            outbound bundle area is.  This statement is only used if
  293.            your system runs oMMM to archive mail (ie. BinkleyTerm).
  294.            This is required if using the -Z command line switch
  295.            (explained later).
  296.           
  297.            QUICKBBSPATH [d:][path][\]
  298.           
  299.            This statement specifies the DOS path where your QuickBBS
  300.            system files are stored (message base files, configuration
  301.            file, etc.).  This is required if using the -T command line
  302.            switch (explained later).
  303.           
  304.           
  305.           
  306.           
  307.           
  308.           
  309.           
  310.           
  311.           
  312.           
  313.           
  314.           
  315.           
  316.           
  317.           
  318.           
  319.           
  320.           
  321.           
  322.           
  323.           
  324.           
  325.           
  326.           
  327.           
  328.           
  329.  
  330.  
  331.  
  332.                    Section 3: QECHO Command Line Parameters
  333.                    ----------------------------------------
  334.           
  335.               QECHO has many command line parameters, they are as
  336.          follows:
  337.           
  338.               -A        Archive all mail generated, this is the
  339.                         ARCmail style of packaging mail.  This was
  340.                         originally introduced by SEA's ARCMAIL
  341.                         utility.
  342.           
  343.               -C        Mark all mail generated (or ARCmail) as
  344.                         (CRASH) priority.
  345.           
  346.               -E        Export QuickBBS outbound EchoMail messages,
  347.                         this is only to be used to export messages.
  348.                         This option disables QECHO from processing
  349.                         inbound mail.
  350.           
  351.               -F[name]  Use alternate areas file, QECHO defaults to
  352.                         using a areas file called AREAS.BBS.
  353.           
  354.               -G        This tells QECHO to process only inbound
  355.                         messages from a node listed for the specific
  356.                         conference in the areas file.
  357.           
  358.               -H        This tells QECHO to hide SEEN-BY lines by
  359.                         placing a control-a character before the
  360.                         SEEN-BY string.
  361.           
  362.               -K        This disables QECHO from checking for
  363.                         duplicate EchoMail messages.
  364.           
  365.               -L[name]  This tells QECHO to generate the text file
  366.                         [name] with a list of area names which QECHO
  367.                         tossed into.  This option is used in
  368.                         conjunction with the -T option.
  369.           
  370.               -N        This disables QECHO from processing any stray
  371.                         EchoMail located in the network mail
  372.                         directory.
  373.           
  374.               -P        This tells QECHO to process and parse ^aPATH:
  375.                         statements in EchoMail messages.
  376.           
  377.               -R        This tells QECHO to strip SEEN-BY: lines down
  378.                         to your own network and any addresses in which
  379.                         you forward to.
  380.           
  381.               -S[x]     This tells QECHO to check free drive space
  382.                         before processing mail.  [x] specifies the
  383.                         minimum number of kilobytes required to
  384.                         process.
  385.           
  386.               -T        This tells QECHO to import all EchoMail
  387.                         processed into the QuickBBS message base.
  388.           
  389.               -U        This tells QECHO to process any mail archives
  390.                         or stray packets.
  391.           
  392.               -V        This disables QECHO from forwarding any
  393.                         EchoMail to new nodes.
  394.           
  395.  
  396.  
  397.  
  398.               -X        Mark all mail generated (or ARCmail) as
  399.                         (HOLD FOR PICKUP).
  400.           
  401.               -Z        This tells QECHO that you are running in an
  402.                         oMMM environment (ie. BinkleyTerm).
  403.           
  404.           
  405.           
  406.           
  407.           
  408.           
  409.           
  410.           
  411.           
  412.           
  413.           
  414.           
  415.           
  416.           
  417.           
  418.           
  419.           
  420.           
  421.           
  422.           
  423.           
  424.           
  425.           
  426.           
  427.           
  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.  
  464.                       Section 4: Defining EchoMail Areas
  465.                       ----------------------------------
  466.           
  467.           
  468.               QECHO needs to be able to know what EchoMail areas you
  469.          are carrying and who to forward to.  To tell QECHO this
  470.          information you create a file called AREAS.BBS (see also -F
  471.          command line parameter).  QECHO parses the areas file line by
  472.          line.  All text to the right of a semi-colon is considered to
  473.          be a comment and is ignored.  Here is a sample AREAS.BBS
  474.          file:
  475.           
  476.          ;
  477.          ; Sample AREAS.BBS file for 1:104/24.0
  478.          ;
  479.          ;
  480.          ; Public Areas:
  481.          ;
  482.          4   FORSALE      104/20
  483.          5   COMM         104/20
  484.          6   TELIX        104/20
  485.          7   TECH         104/20
  486.          8   ECPROG       104/20
  487.          9   C_ECHO       104/20
  488.          10  PASCAL       104/20
  489.          11  TRADE_WARS   104/20
  490.          ;
  491.          ;  Sysop Areas:
  492.          ;
  493.          13  FIDOSYSP     104/20
  494.          14  SYSOP        104/20
  495.          15  SEADOG       104/20
  496.          16  NET_DEV      104/20
  497.          17  SIRIUS       104/20
  498.          19  QUICKBETA    104/610 46 54 51 63 105/55 114/25 132/114
  499.          25  DOGGIES      104/20
  500.          30  QUICKBBS     104/20 610 105/55 70/0
  501.          31  BINKLEY      104/20
  502.          32  HST          104/20
  503.          33  MTASK        104/20
  504.          34  DPCBW        104/20
  505.          35  DESQVIEW     104/20
  506.          36  CONFMAIL     104/20
  507.          P   PLEASE       104/51 381/1
  508.           
  509.          The first argument on each line is the QuickBBS board number
  510.          defined in QCONFIG.  This argument is used by the -T toss
  511.          command line option.  If the letter P is specified then the
  512.          area is considered a pass-thru area, all messages in such an
  513.          area just get forwarded and killed.
  514.           
  515.          The second argument is the EchoMail area name.  Area names
  516.          can be up to 20 characters long.
  517.           
  518.          All other arguments are considered network mail addresses in
  519.          which you forward that specific conference to.  Up to 50
  520.          network addresses may be specified.
  521.           
  522.          QECHO can handle up to 200 EchoMail areas at a time, if you
  523.          wish to use more than this you must use the -F command line
  524.          parameter to manipulate multiple areas files.
  525.           
  526.           
  527.  
  528.  
  529.  
  530.           
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.