home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_opus / echo309b.arj / ECHODOR.PRN < prev    next >
Encoding:
Text File  |  1991-05-27  |  172.7 KB  |  5,168 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.           ******   ******  *     *   *****   *****     *****    *****
  21.          *        *        *     *  *     *  *     *  *     *  *     *
  22.          ****     *        *******  *     *  *     *  *     *  ******
  23.          *        *        *     *  *     *  *     *  *     *  *  *
  24.          *        *        *     *  *     *  *     *  *     *  *   *
  25.           ******   ******  *     *   *****   *****     *****   *    *
  26.  
  27.  
  28.                            Echodor version 3.09
  29.                       Original Program By Scott Baker
  30.                     Modifications by Robert McCullough
  31.                       Documentation by Jonathan Woods
  32.  
  33.              If you should happen to find this program useful,
  34.                       Please send a contribution to:
  35.  
  36.                              Robert McCullough
  37.                               P.O. Box 101095
  38.                            Nashville, TN  37224
  39.                          Voice Phone 615 333-0557
  40.  
  41.               For the latest version of EchoDor, you may call
  42.  
  43.                      The NEW WorkBench BBS (9600/Hst)
  44.                           BBS Phone 615 333-1458
  45.                          FidoNet Node 1:116/1000.0
  46.                            RBBS Net 8:967/107.0
  47.                         File Requestable as ECHODOR
  48.  
  49.  
  50.  
  51.      1.0  Introduction
  52.  
  53.      EchoDor is a full featured echo mail conference processor that
  54.      incorporates features found in many door programs, and bulletin
  55.      board systems.  The Echo mail community has for some time been
  56.      lacking a really good echo mail door.  It is due to this lack
  57.      that EchoDor was created.
  58.  
  59.      Echodor may be used on several BBS systems.  It is configurable
  60.      to run under RBBS-PC Ver CPC 15.1 through 17.2, PCBOARD 14.1, and
  61.      Quickbbs.  The difference between these BBS systems is the way
  62.      they handle passing information to a  Door program.  RBBS 15.1
  63.      puts the information in the first record of the message file.
  64.      RBBS 16.1+ creates a  small text file called DORINFOx.DEF.  (the
  65.      'x'  being  the node number that called the door program).
  66.      PCBOARD creates a random access file called PCBOARD.SYS.  Quick
  67.      BBS passes all the parameters on the command line that calls the
  68.      door.
  69.  
  70.      The information that is passed includes the Users Name, the
  71.      Communications Port, the baud rate, the graphics type selected,
  72.      the time remaining, and the sysop name.  This information is used
  73.      by EchoDor to monitor the carrier of the appropriate port, and to
  74.      control various other functions of EchoDor.
  75.  
  76.      If you don't have echo mail currently operating, you probably
  77.      don't have a need for this program.  If you are adding  echo mail
  78.      to your system, and haven't completed installing it yet, STOP.
  79.      Go back to the echo mail programs, and get that working FIRST!
  80.      You should set up echo mail to work in a set of subdirectories
  81.      like FIDO, OPUS, and the rest of the net mail bulletin boards.
  82.      If you are using RBBS, DO NOT USE RBBSMAIL! RBBSMAIL puts the
  83.      echo mail messages in your RBBS conference files!  EchoDor can't
  84.      support this feature!
  85.  
  86.      If you are using PCBoard or QuickBBS, the installation procedures
  87.      are the same as for RBBS.
  88.  
  89.      Thus far PCBOARD does not support a net mail front end processor
  90.      due to the fact that it does not allow parameters to be passed on
  91.      the command line.  To support echo mail using PCBOARD,
  92.      BinkleyTerm has to be run in the "MAIL" mode as an event from
  93.      PCBOARD each evening.  Due to this, PCBOARD sysops cannot support
  94.      Crash mail.  Also, PCBOARD does not provide EchoDor will security
  95.      levels; therefor, security level access control will not work.
  96.      EchoDor provides a "default" security for all users of 50 when
  97.      running with PCBOARD.
  98.      EchoDor Version 3.09
  99.  
  100.  
  101.      2.0  INSTALLATION
  102.  
  103.      If you already have net mail running, the installation will be
  104.      very simple.  If you don't run net mail, some explanation is in
  105.      order.
  106.  
  107.      EchoDor uses FIDO type messages.  IE: each message is a separate
  108.      file (1.MSG, 2.MSG etc..).  The messages in each area
  109.      (Conference/Forum) are stored in their own Subdirectory.  EG:
  110.  
  111.          C:\------ RBBS
  112.               |
  113.               +--- MAIL ------- PRIVATE
  114.                            |
  115.                            +--- BAD_MSGS
  116.                            |
  117.                            +--- HUMOR
  118.                            |
  119.                            +--- RBBS-PC
  120.                            |
  121.                            +--- CHATTER
  122.                            |
  123.                            +--- POLITICS
  124.  
  125.      You need to get echo mail processor to  move all your incoming
  126.      messages to subdirectories like these. Examples of programs that
  127.      do this are ConfMail, QM (or QMail), or TossScan.
  128.  
  129.      Set up this subdirectory structure BEFORE proceeding to the next
  130.      section!
  131.  
  132.      You must also set up a fossil for EchoDor to use to communicate
  133.      with the modem.  A number of fossil programs are available
  134.      including X00, BNU, or OPUS!COM.  Get one of these if your not
  135.      already using one and get it installed.
  136.  
  137.      Then:
  138.  
  139.         1.  Create a directory to hold all the files in the EchoDor
  140.             archive.
  141.  
  142.         2.  Unpack the archive into the directory.
  143.  
  144.         3.  Edit the file DoorDriv.Ctl to reflect the information
  145.             about your system.  Follow the comments contained in the
  146.             file.
  147.  
  148.                a.  Enter your first name as SYSOPFIRST name.
  149.  
  150.                b.  Enter your last name as SYSOPLAST name.
  151.  
  152.                c.  Enter your BBS name as BBSNAME name.
  153.  
  154.                d.  Select your BBS type as BBSTYPE.  If your BBS type
  155.                    is not listed, you may have to run EchoDor with
  156.                    some converter program.
  157.  
  158.                e.  Place the drive and directory of your BBS into the
  159.                    line marked BBSPATH.  This tells EchoDor where to
  160.                    get the door information file.
  161.  
  162.  
  163.                                   Page 2
  164.  
  165.  
  166.                f.  If you run a "locked baud", uncomment the line BAUD
  167.                    and set your baud rate.  This will override the
  168.                    baud specified in the door drop file.
  169.  
  170.             We'll leave the rest of the entries as they are for now.
  171.             See the following sections for a complete list of
  172.             parameters and their uses.
  173.  
  174.         4.  Edit the file "ECHODOR.CTL" to reflect information about
  175.             the echos you intend to carry.  Follow the comments in the
  176.             file.
  177.  
  178.                a.  Enter your own zone, net and node numbers.
  179.  
  180.                b.  Enter your name as SYSOPNAME name.
  181.  
  182.                c.  Enter your name as COMMENTNAME name.
  183.  
  184.                d.  Edit the 2 tables, AREATABLE and AREADESC to your
  185.                    own echo mail areas. The comments in the file
  186.                    should explain how to do this.  See also the
  187.                    section titled ECHODOR.CTL parameter file.
  188.  
  189.         5.  Now run:
  190.  
  191.             EchoUtil /USERFILE
  192.  
  193.         6.  Echoutil will ask if you want Hot keys on as the default.
  194.             Answer either Y or N.  This will create the user file.
  195.  
  196.         7.  Run the CheckOut program.  This program checks a lot of
  197.             the entries and will help you resolve a number of
  198.             problems.  If Checkout generates too much output for your
  199.             screen, you can redirect the output to your printer by
  200.             using the command:
  201.  
  202.             Checkout > PRN
  203.  
  204.         8.  Set up a door batch file to something like the following:
  205.  
  206.             rem
  207.             rem switch to the EchoDor directory and start
  208.             rem EchoDor
  209.             rem
  210.             CD \EchoDor
  211.             rem
  212.             rem now run EchoDor and pass it the node number
  213.             rem in this example the node number is passed as
  214.             rem the first parameter of the batch file.  If you
  215.             rem only run a single node, change the %1 to 1.
  216.             rem
  217.             rem      | this is the parameter which is the port
  218.             rem      | number.  All other information will come
  219.             rem      | from the bbs door file.
  220.             rem      v
  221.             ECHODOR %1 %2
  222.             rem
  223.             CD \rbbs
  224.             rbbs
  225.  
  226.  
  227.  
  228.                                   Page 3
  229.  
  230.  
  231.             (SEE the Example Batch file called ECHODOR.BAT)
  232.  
  233.             Note: make sure that your batch file copies dorinfo*.def
  234.                   to the EchoDor directory. This is a very important
  235.                   file.
  236.  
  237.         9.  Test the door in local mode with "ECHODOR /L" to make sure
  238.             it is working.
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.                                   Page 4
  294.  
  295.  
  296.      3.0  DoorDriv.Ctl parameter file
  297.  
  298.      The DoorDriv.Ctl file controls the door's interaction with the
  299.      communication port and provides information about the BBS type
  300.      that is calling the door.  This file is required and must be in
  301.      the default directory when the door program is started.  The
  302.      DoorDriv.Ctl example file contains a number of comments which
  303.      should help you in editing this file.  This chapter contains a
  304.      list of all the parameters for DoorDriv.Ctl and their use.
  305.  
  306.      3.1  Multiple DoorDirv.Ctl files
  307.  
  308.      It is sometimes necessary to have multiple DoorDriv.Ctl file when
  309.      running a multiple line system.  One modem might be one speed or
  310.      different monitors might be used on different nodes.  Door Driver
  311.      now supports multiple control files.
  312.  
  313.      The specific file selected depends on the "node" number specified
  314.      when starting the door.  Local operation always uses "node" zero
  315.      (0).  The name of the file comes from replacing the last
  316.      character of the file name (before the period) with the node
  317.      number.  If that file dose not exist, Door Driver will then look
  318.      for the base file (DoorDriv.Ctl).  The different control files
  319.      might be named:
  320.  
  321.           DoorDriv.Ctl       < base file used as default >
  322.           DoorDri0.Ctl       < used for node 0 (local)   >
  323.           DoorDri1.Ctl       < used for node 1 >
  324.           DoorDri2.Ctl       < used for node 2 >
  325.                .
  326.                .
  327.           DoorDriX.Ctl       < X = node number >
  328.  
  329.      Up to nine nodes plus local is supported.  Remember that some
  330.      doors change the name of the Door Driver control file.  The
  331.      naming would be altered to use the new base name.
  332.  
  333.      3.2  Parameters
  334.  
  335.           BACKGROUND
  336.  
  337.                This parameter specifies the default background color
  338.                used by the door program.  See the list of available
  339.                colors at the end of this section for the color numbers
  340.                that can be used.  Only the numbers 0-7 can be used
  341.                here.  The format of this command is:
  342.  
  343.                BACKGROUND n
  344.  
  345.                Where n is the color number desired as the default
  346.                background color for the door.  Note that some doors
  347.                may not honor this parameter and use other colors.
  348.  
  349.           BAUD
  350.  
  351.                This parameter is used to set the baud rate of the door
  352.                if you use a system that runs a locked baud.  The
  353.                format of this parameter is:
  354.  
  355.                BAUD xxxxx
  356.  
  357.  
  358.                                   Page 5
  359.  
  360.  
  361.                The following fixed BAUD rates are supported:
  362.  
  363.                     300, 600, 1200, 2400, 4800, 9600, 19200, 38400
  364.  
  365.                If this parameter is not used the baud rate used will
  366.                be the baud in the door control file written by the BBS
  367.                system.
  368.  
  369.           BBSNAME
  370.  
  371.                This parameter is the name of the BBS that you want to
  372.                have displayed to the user when the door closes.  This
  373.                parameter is required.  The format of this line should
  374.                be:
  375.  
  376.                BBSNAME name of my board
  377.  
  378.                DO NOT put quotes around the name of your board or
  379.                they'll show, just enter the name as you would type it.
  380.  
  381.           BBSPATH
  382.  
  383.                Most doors require you to copy your door information
  384.                file (written by your BBS) into the directory where the
  385.                door resides.  By setting BBSPATH, you instruct this
  386.                door to read the door information file from the
  387.                specified drive and directory.  This avoids you having
  388.                to copy the file and reduces start up time.
  389.  
  390.                This parameter is optional.  If it is not specified,
  391.                the door will look for the door information file in the
  392.                current directory.
  393.  
  394.           BBSTYPE
  395.  
  396.                Most doors will only run with a specific type of BBS.
  397.                This door will run with a number of different types of
  398.                BBS systems.  To tell the door the type of BBS you have
  399.                you must set the BBS type.  This is a required
  400.                parameter.  The format of this parameter is:
  401.  
  402.                BBSTYPE type
  403.  
  404.                The type should be replaced with one of the following:
  405.  
  406.                     RBBS    - for RBBS-PC 16.1+  (DORINFOx.DEF file)
  407.                     QUICK   - for QuickBBS       (DORINFOx.DEF file)
  408.                     PCB12   - for PC-Board 12.
  409.                     PCB14   - for PC-Board 14.
  410.                     WWIV    - WWIV BBS           (CHAIN.TXT file)
  411.                     PHOENIX - Phoenix BBS
  412.                     WILDCAT - for WildCat! BBS   (CALLINFO.DEF file)
  413.                     OPUS    - for Opus 1.1x      (LASTUS##.DAT file)
  414.                     GT      - for GT PowerComm   (GTUSER.BBS file)
  415.                     LINE-A  - command line parameters (see below)
  416.                     LINE-B  - command line parameters (see below)
  417.  
  418.           COLOR1
  419.  
  420.  
  421.  
  422.  
  423.                                   Page 6
  424.  
  425.  
  426.                Some BBS systems set the color indicator differently
  427.                than the door expects.  If your users do not get color
  428.                when they should, try including this parameter in the
  429.                DoorDriv.Ctl file.
  430.  
  431.           COMPORT
  432.  
  433.                Some BBS systems do not write the communications port
  434.                number to the door control file.  One example of this
  435.                is PC-Board version 12.  If you run a BBS of this type,
  436.                you must tell the door which communications port to use
  437.                by using this parameter.  The format of this parameter
  438.                is:
  439.  
  440.                COMPORT x
  441.  
  442.                Where x is a 1, 2 .... max port.
  443.  
  444.           DIRECTVIDEO
  445.  
  446.                The door uses BIOS type writes to display information
  447.                on the local screen.  This mode is best for people that
  448.                run DV.  If you want faster screen writes, include the
  449.                DIRECTVIDEO parameter and the system will use direct
  450.                screen writes.
  451.  
  452.           FOREGROUND
  453.  
  454.                This parameter specifies the default foreground color
  455.                used by the door program.  See the list of available
  456.                colors at the end of this section for the color numbers
  457.                that can be used.  The format of this command is:
  458.  
  459.                FOREGROUND nn
  460.  
  461.                Where nn is the color number desired as the default
  462.                foreground color for the door.  Note that some doors
  463.                may not honor this parameter and use other colors.
  464.  
  465.           HILIGHTCOLOR
  466.  
  467.                This parameter specifies the color to be used for
  468.                highlight.  See the list of available colors at the end
  469.                of this section for the color numbers that can be used.
  470.                The format for this command is:
  471.  
  472.                HILIGHTCOLOR nn
  473.  
  474.                Where nn is the color number desired as the default
  475.                foreground highlight color for the door.  Note that
  476.                some doors may override this parameter.
  477.  
  478.           IDLETIME nn
  479.  
  480.                This specified the maximum idle time in seconds between
  481.                keystrokes.  When 2/3rds of the idle time has passed,
  482.                the program will issue a beep.  When the total time
  483.                lapses and no keystroke has been make, the door will
  484.                exit.
  485.  
  486.  
  487.  
  488.                                   Page 7
  489.  
  490.  
  491.                This may be disabled by setting IDLETIME 00.
  492.  
  493.           MAXTIME nn
  494.  
  495.                This parameter is used to sepcify the maximum time the
  496.                user is allowed in the door.  Some BBS systems require
  497.                this parameter because the time remaining is not
  498.                passed.  GT is an example of this.
  499.  
  500.                In boards where the maximum time is passed, if the user
  501.                has more time available than the value specified here,
  502.                the users time for the door will be reduced to the
  503.                specified MAXTIME.  Maximum time is specified in
  504.                minutes.
  505.  
  506.                This may be disabled by setting MAXTIME 00.
  507.  
  508.           MINTIME nn
  509.  
  510.                This parameter allows you to set the minimum amount of
  511.                time the user must have remaining to be able to use the
  512.                door.  If the total time remaining is less than the
  513.                time specified, the user will be told that he dosen't
  514.                have enought time and the door will exit.  Minimum time
  515.                is specified in minutes.
  516.  
  517.                This may be disabled by setting MINTIME 00.
  518.  
  519.           MONO
  520.  
  521.                This parameter if present will disable color on the
  522.                local display.  This is required if you run a
  523.                monochrome monitor.
  524.  
  525.           PROMPTCOLOR c1 c2 c3
  526.  
  527.                This parameter defines the colors used for some
  528.                requests made by the door.  All three items are color
  529.                numbers from the list below.  The first color number
  530.                (c1) is the foreground color of the input field.  The
  531.                second color number (c2) is the background color of the
  532.                input field.  The third color number (c3) is the
  533.                foreground color number of the "Prompt Text".
  534.  
  535.           QUIET
  536.  
  537.                This parameter will prevent ^G (bell) characters from
  538.                ringing the bell on the local system.
  539.  
  540.           STATFORE
  541.  
  542.                This parameter is the foreground color of the status
  543.                line.  If the status line is off (see the STATUS
  544.                parameter) this command has no effect.  Refer to the
  545.                list of colors at the end of this section for the color
  546.                numbers that can be used.  The format of this command
  547.                is:
  548.  
  549.                STATFORE nn
  550.  
  551.  
  552.  
  553.                                   Page 8
  554.  
  555.  
  556.                Where nn is the color number desired for the status
  557.                line foreground color.
  558.  
  559.           STATBACK
  560.  
  561.                This parameter is the background color of the status
  562.                line.  If the status line is off (see the STATUS
  563.                parameter) this command has no effect.  Refer to the
  564.                list of colors at the end of this section for the color
  565.                numbers that can be used.  The format of this command
  566.                is:
  567.  
  568.                STATBACK nn
  569.  
  570.                Where nn is the color number desired for the status
  571.                line background color.
  572.  
  573.           STATUS
  574.  
  575.                This parameter turns the status line on the local side
  576.                on and off.  I suggest you try it turned on.  If the
  577.                status line causes problems then turn it off.  The
  578.                format of the command is:
  579.  
  580.                STATUS ON
  581.                or
  582.                STATUS OFF
  583.  
  584.                Note:     Some doors disable the status line when
  585.                          running in Local Mode.
  586.  
  587.           SYSOPFIRST
  588.  
  589.                This is the first name of the SYSOP.  This parameter is
  590.                required and should be entered as:
  591.  
  592.                SYSOPFIRST Name
  593.  
  594.           SYSOPLAST
  595.  
  596.                This is the last name of the SYSOP.  This parameter is
  597.                required and should be entered as:
  598.  
  599.                SYSOPLAST Name
  600.  
  601.      3.3  Color Table
  602.  
  603.      The follow colors may be used for both background colors and
  604.      foreground colors:
  605.  
  606.            0 - Black
  607.            1 - Blue
  608.            2 - Green
  609.            3 - Cyan
  610.            4 - Red
  611.            5 - Magenta
  612.            6 - Brown
  613.            7 - Light Gray
  614.  
  615.      The following colors may be used only for foreground colors:
  616.  
  617.  
  618.                                   Page 9
  619.  
  620.  
  621.            8 - Dark Gray
  622.            9 - Light Blue
  623.           10 - Light Green
  624.           11 - Light Cyan
  625.           12 - Light Red
  626.           13 - Light Magenta
  627.           14 - Yellow
  628.           15 - White
  629.  
  630.      3.4  PC Board 14
  631.  
  632.      When using this door with PC Board 14 systems, a default security
  633.      level of 50 is assigned all users.
  634.  
  635.      3.5  PC Board 12
  636.  
  637.      When using this door with PC Board 12 systems, a default security
  638.      level of 50 is assigned to all users.
  639.  
  640.      3.6  Opus 1.1x
  641.  
  642.      When using the door with Opus 1.1x systems, the following
  643.      security levels will be used:
  644.  
  645.           Twit                32
  646.           Disgrace            48
  647.           Limited             64
  648.           Normal              80
  649.           Worthy              96
  650.           Privel              112
  651.           Favored             128
  652.           Extra               144
  653.           Clerk               160
  654.           Asst-Sysop          176
  655.           Sysop               208
  656.  
  657.      3.7  GT PowerComm
  658.  
  659.      If you use this Door with GT PowerComm, you must set the MAXTIME
  660.      parameter.  The GTUSER.BBS file does not contain the amount of
  661.      time remaining for the door.
  662.  
  663.      3.8  LINE-A operation
  664.  
  665.      This option is provided to allow doors to be called without door
  666.      information files.  All needed parameters are passed on the
  667.      command line.  The order of the parameters is not important;
  668.      however, if you wish to use multiple DoorDriv.Ctl files, you must
  669.      specify a port number (without a leading slash or dash) as the
  670.      first parameter on the command line.  Every other parameter
  671.      begins with either a slash (/) or a dash (-) followed immediately
  672.      by a single letter parameter type.  That type is then followed
  673.      immediately by the parameter.  There should be no spaces between
  674.      the dash/slash and the parameter type and there should be no
  675.      spaces between the parameter type and the parameter.  For
  676.      example:  -b2400 is valid, -b 2400 is not valid.
  677.  
  678.      The following parameters can be specified:
  679.  
  680.           -B   baud rate.  A baud rate of zero is assumed local.
  681.  
  682.  
  683.                                   Page 10
  684.  
  685.  
  686.           -P   communication port number, COM1 is -P0.
  687.  
  688.           -T   time remaining.  This is specified in minutes.
  689.  
  690.           -N   users name.  If specifying a users first & last name,
  691.                use an underscore as a seperator.  For example:
  692.  
  693.                     -NFirst_Last
  694.  
  695.           -S   numeric security level.  For example: -S50 is security
  696.                level 50.
  697.  
  698.           -M   sets the maximum time allowed in door.  If the time
  699.                remaining is greater than the maximum time, the maximum
  700.                time will be used.  This is specified in minutes.
  701.  
  702.           -G   Specifies graphics/ansi.  If the -G is followed by 0,
  703.                graphics will be disabled.  If the -G is followed by a
  704.                non zero value, graphics will be enabled.
  705.  
  706.      If you wish to use a "node number" this must be specified as the
  707.      first parameter without a slash or dash.
  708.  
  709.      These parameters should not be used with the /S (sysop log on) or
  710.      the /L (local log on) options.
  711.  
  712.      3.9  LINE-B operation
  713.  
  714.      This parameter is provided to allow doors to be called without
  715.      door information files.  All needed parameters are passed on the
  716.      command line.  Every parameter is order dependent.  This style of
  717.      operation does not allow user names and provides a default
  718.      security level of 50.  The following command line is used:
  719.  
  720.           door <port> <baud> <time> <maxtime>
  721.  
  722.           <port>    this is the communication port to be used. 1 is
  723.                     assumed to be COM1.  A port of 0 is assumed local.
  724.  
  725.           <baud>    this is the baud rate.  A baud rate of zero is
  726.                     assumed local.
  727.  
  728.           <time>    this is the time remaining.  It's value is in
  729.                     minutes.
  730.  
  731.           <maxtime> this is the maximum time allowed in the door.  If
  732.                     the <time> parameter is greater than the <maxtime>
  733.                     parameter, the <maxtime> parameter will be used.
  734.                     This parameter is optional.
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.                                   Page 11
  749.  
  750.  
  751.      4.0  ECHODOR.CTL parameter file
  752.  
  753.      ECHODOR.CTL is EchoDor's master configuration file.  All
  754.      communication between you and EchoDor is through this file.  Node
  755.      Number, Net Number, Sysop name, and many more parameters get
  756.      their values from this file.  An example file is distributed with
  757.      EchoDor and is well commented.
  758.  
  759.      4.1  Files
  760.  
  761.      Some of the parameters in the ECHODOR.CTL file specifies files
  762.      which can be displayed to the user.  Examples of such files are
  763.      the menu files (as specified by the MENUFILE, PACKMENUFILE, and
  764.      DOWNLOADTEXT parameter) and the welcome files (as specified by
  765.      the WELCOME parameter).
  766.  
  767.      EchoDor supports 4 types of displays:
  768.  
  769.           1. Basic text display
  770.           2. Graphics display
  771.           3. ANSI color display
  772.  
  773.      When EchoDor displays a file and the specified file has an
  774.      extension specified, that file will be displayed to the user
  775.      regardless of the type of display.
  776.  
  777.      If the file does not have an extension specified then EchoDor
  778.      will add an extension to the file depending on display type.  The
  779.      selection will be:
  780.  
  781.           file.ANS if the user has ANSI color
  782.           file.ASC if the user has Graphics
  783.  
  784.           No extension will be added if the user has basic text.
  785.  
  786.      If the user has ANSI color and EchoDor cannot find the specified
  787.      file with the extension .ANS, then EchoDor will look for a file
  788.      with the extension of .ASC.  If that file cannot be found then
  789.      EchoDor will look for the file name without an extension.
  790.  
  791.      4.2  Parameters
  792.  
  793.           AREATABLE
  794.  
  795.                This parameter begins the area of the control file that
  796.                defines each echo area.  Each line after this command
  797.                and prior to the ENDAREATABLE command consists of 9
  798.                space delimited sections.  Every section is required.
  799.                You may enter the areas in any order you wish, when
  800.                EchoDor checks and displays areas, it will be in the
  801.                same order as you enter them here.  Remember:  Do not
  802.                enter any spaces within the fields, if you do EchoDor
  803.                will get confused and will not correctly read the
  804.                table.
  805.  
  806.                Also, you MUST have a ZONE, NET, NODE, and optionally a
  807.                POINT command in the file prior to the AREATABLE line.
  808.  
  809.                The sections are:
  810.  
  811.  
  812.  
  813.                                   Page 12
  814.  
  815.  
  816.                   1.  The number.
  817.                       This is the area number the user would type in
  818.                       to get to that area.  This number must be from
  819.                       1-255 inclusive (you can use 1 or 255).  You may
  820.                       NOT duplicate this number on ANY other echo
  821.                       area, local area, or net mail area.
  822.  
  823.                   2.  The area tag.
  824.                       If the area you are defining is an echo, this
  825.                       field must contain the "defined" name of the
  826.                       echo.  You can get this name from your Echo Mail
  827.                       Coordinator.  If it is a local message area or
  828.                       net mail you may use any name you wish.
  829.  
  830.                       DO NOT ENTER ANY SPACES in the area tag!
  831.  
  832.                   3.  The listed tag.
  833.                       This field is shown to the user in the read
  834.                       menu, the scan menu, and the new messages
  835.                       displays.  This field may be anything you wish;
  836.                       however, you should keep this field to more more
  837.                       than about 30 characters as it may make the
  838.                       display of certain menus look strange.
  839.  
  840.                       DO NOT ENTER ANY SPACES in the listed tag!
  841.  
  842.                   4.  The path.
  843.                       This field tells where the messages for the
  844.                       specific area is located.  Each area must be
  845.                       located in a different subdirectory.  All areas
  846.                       do not have to be on the same drive.
  847.  
  848.                   5.  The type echo.
  849.                       This field is the "T" column in the ECHODOR.CTL
  850.                       file.  This field tells the kind of message
  851.                       base.  The "T" column can have the following
  852.                       values:
  853.  
  854.                       E - the area is a local message base.
  855.  
  856.                       I - the area is national/international echo
  857.                       mail.
  858.  
  859.                       N - the area is net mail.
  860.                            You should normally have one per zone.
  861.  
  862.                       B - the area is a local message or auto message
  863.                       area.
  864.  
  865.                   6.  The Private Flag.
  866.                       This field allows or prevents private messages
  867.                       in an area.  If this field is set to "Y",
  868.                       EchoDor will ask if the message should be marked
  869.                       private.  Most echo areas, local and national,
  870.                       DO NOT allow private messages, so the flag
  871.                       should be set to "N".  The net mail area does
  872.                       allow private messages so the flag should be set
  873.                       to "Y".  The local message areas may be set as
  874.                       needed.
  875.  
  876.  
  877.  
  878.                                   Page 13
  879.  
  880.  
  881.                   7.  File Transfer Flag.
  882.                       File transfer is available in Net Mail areas
  883.                       only.  If this flag is set to "Y", EchoDor will
  884.                       ask if you want to perform a File [A]ttach /
  885.                       File [R]equest when entering a message in the
  886.                       net mail area.
  887.  
  888.                       This should be used only for netmail areas.
  889.                       Putting file requests or file attaches into echo
  890.                       areas is undefined.
  891.  
  892.                   8.  Security.
  893.                       This field tells EchoDor the minimum security
  894.                       required to read messages in the area.  The
  895.                       specific security values are defined by your BBS
  896.                       software.  EchoDor reads the security value
  897.                       passed in the Door information file
  898.                       (DORINFO.DEF, CALLINFO.DEF, ...etc) and compares
  899.                       the security passed with that in this field.
  900.                       The the security pass is less, access to the
  901.                       area will not be allowed.
  902.  
  903.                       This field may also contain a 'Y' to indicate
  904.                       that it is a SYSOP only area.  If the user is
  905.                       not listed as a SYSOPNAME, the area will be
  906.                       restricted.
  907.  
  908.                       The field can also contain a 'N' to indicate an
  909.                       open area which is not restricted to anyone.
  910.  
  911.                   9.  WRACC (Write access).
  912.                       This field tells EchoDor the minimum security
  913.                       required to enter messages in the area.  This
  914.                       field works like security described above.
  915.  
  916.           CHECKDAYS <xx>
  917.  
  918.                This parameter is used to tell EchoDor how often the
  919.                user must check his/her mail.  This parameter is most
  920.                useful when you use the "/CHECK" or the "/AC" options
  921.                when starting EchoDor.
  922.  
  923.                The day counting may be turned off by specifying a
  924.                CHECKDAYS 0 parameter.
  925.  
  926.           CLOSINGSTRING bye bye
  927.  
  928.                This parameter will be displayed to the user when
  929.                he/she exits EchoDor to return back to the BBS.  All
  930.                the characters following the "CLOSINGSTRING" key word
  931.                will be displayed.  This parameter is optional.
  932.  
  933.           COMMANDSTRING <command str>
  934.  
  935.                Normally the main menu displayed by EchoDor is followed
  936.                by "Main Command ? ".  This is the default value.  You
  937.                can change this prompt by specifying the COMMANDSTRING
  938.                parameter.
  939.  
  940.  
  941.  
  942.  
  943.                                   Page 14
  944.  
  945.  
  946.                Anything you specify as <command str> up to 40
  947.                characters will be displayed to the user in place of
  948.                "Main Command ? ".  A blank character is always
  949.                appended to the end of the command string.  Do not
  950.                enclose the <command str> in quotes or the quotes will
  951.                be displayed.
  952.  
  953.           COMMENTAREA <xx>
  954.  
  955.                This is the message area number as defined in the
  956.                AREATABLE that will hold all comments to the sysop.
  957.                This parameter is not required if you do not enable
  958.                comments.
  959.  
  960.                When you select an area for comments, be sure this is a
  961.                local area (area type B).  If you choose a net mail or
  962.                echo area, your mail packer will probably send out your
  963.                comments into the net.
  964.  
  965.           COMMENTNAME Firstname Lastname
  966.  
  967.                Enter the one and only name of the person who will
  968.                receive comments to the sysop.  This parameter is not
  969.                required if you do not enable comments.
  970.  
  971.           COMPRESSCHAR <chars>
  972.  
  973.                This command specifies the valid characters for the
  974.                compression method to be used. The characters should be
  975.                entered one after another.  Case is not important.  An
  976.                example of using this command for Arc, Pak, and Zip
  977.                might be:
  978.  
  979.                     COMPRESSCHAR APZ
  980.  
  981.                This would only allow the characters A, P, or Z to be
  982.                specified for a compression method.
  983.  
  984.                The maximum number of characters that may be entered in
  985.                <char> is 20.  Characters beyond the 20th character
  986.                will be ignored.
  987.  
  988.           COMPRESSDIR <drive:\directory>
  989.  
  990.                This command specifies the directory which is used to
  991.                hold the compressed mail file after compression.  A
  992.                full directory name can be used.  Drive is optional.
  993.  
  994.                NOTE:     Don't specify any directory used by another
  995.                          program.  The contents of the directory are
  996.                          erased before each compress operation.
  997.  
  998.                The directory name specified can include a single pound
  999.                sign (#).  When EchoDor reads the EchoDor.Ctl file it
  1000.                will replace the pound sign (#) with the node number
  1001.                specified on the command line.  This allows multiple
  1002.                directories to be used for multiple nodes.
  1003.  
  1004.           COMPRESSFILE <drive:\path\file>
  1005.  
  1006.  
  1007.  
  1008.                                   Page 15
  1009.  
  1010.  
  1011.                This is the name of the file displayed to users when
  1012.                they select [C]ompress from the Pack Mail menu.  This
  1013.                file should list the compression programs that are
  1014.                available for compressing mail files.  The file name
  1015.                should not contain an extension.  You may create up to
  1016.                three files to display to the user.  See the preceding
  1017.                section on naming files.
  1018.  
  1019.           DELETEUSER <xx>
  1020.  
  1021.                This is the number of days that inactive users will
  1022.                remain in the EchoDor user file.
  1023.  
  1024.           DESCTABLE
  1025.  
  1026.                This area begins the description table.  This area is
  1027.                required only if there is not USERAREALIST and
  1028.                SYSOPAREALIST.  I suggest that you use this area only
  1029.                if you do not use the USERAREALIST and SYSOPAREALIST.
  1030.                If you use this table, it must FOLLOW the
  1031.                AREADESCTABLE.  After the DESCTABLE parameter the table
  1032.                has one line entries until the ENDDESCTABLE command.
  1033.                Each line must begin with an area number.  This number
  1034.                corresponds with the area number in the AREADESCTABLE,
  1035.                order is not important.  The number must be followed by
  1036.                a single space.  The next 70 characters is the
  1037.                description of the area, you may enter anything you
  1038.                like, I do suggest that you enter the area name
  1039.                somewhere in the line.  See the ECHODOR.CTL file for an
  1040.                example.
  1041.  
  1042.           DISPLAYLN Text to be dipslayed
  1043.  
  1044.                This command may be placed in the configuration file to
  1045.                cause EchoDor to display a line to the user while the
  1046.                configuration file is being loaded.
  1047.  
  1048.           DOWNLOADCHAR <chars>
  1049.  
  1050.                This command specifies the valid characters for
  1051.                download protocol specification.  The characters should
  1052.                be entered one after another.  Case is not important.
  1053.                The letter "Q" is not available for a protocol.  An
  1054.                example of using this command for X-Modem, Y-Modem, and
  1055.                Z-Modem might be:
  1056.  
  1057.                     DOWNLOADCHAR XYZ
  1058.  
  1059.                This would only allow the characters X, Y, or Z to be
  1060.                specified for a protocol.
  1061.  
  1062.                The maximum number of characters that can be entered
  1063.                for <char> is 20.  Characters beyond 20 will be
  1064.                ignored.
  1065.  
  1066.           DOWNLOADFILE <drive:\path\file>
  1067.  
  1068.                This is the name of the file displayed to users when
  1069.                they select [D]ownload from the Pack Mail menu.  This
  1070.                file should list the protocols that are available for
  1071.  
  1072.  
  1073.                                   Page 16
  1074.  
  1075.  
  1076.                downloading mail files.  The file name should not
  1077.                contain an extension.  You may create up to three files
  1078.                to display to the user.  See the preceding section on
  1079.                naming files.
  1080.  
  1081.           ENDAREATABLE
  1082.  
  1083.                This parameter ends the area table descriptions and
  1084.                must be present.  See the AREATABLE command for a
  1085.                description of how to create an area table.
  1086.  
  1087.           ENDDESCTABLE
  1088.  
  1089.                This parameter end the description table section and
  1090.                must be present if a DESCTABLE is used.
  1091.  
  1092.           FORUM
  1093.  
  1094.                Normally EchoDor refers to the message areas as
  1095.                conferences.  If your system uses the term "forum" you
  1096.                may include this word in your configuration file to
  1097.                have EchoDor refer to your areas as forums.
  1098.  
  1099.           HELPFILEPREFIX <Drive:\path\FilePrefix>
  1100.  
  1101.                This is the prefix for all help files.  The file name
  1102.                should not contain an extension.  The path is optional
  1103.                and if omitted, EchoDor will look for files in the
  1104.                current directory.
  1105.  
  1106.           HOTKEYS
  1107.  
  1108.                When this parameter is included in the EchoDor#.Ctl
  1109.                file, EchoDor will use hot keys for all menu
  1110.                operations.  The user will not have to press the enter
  1111.                key.  This is included for sysops wish to have EchoDor
  1112.                more closely emulate the operation of their BBS.
  1113.  
  1114.           INCLUDE <drive:\path\fileSpec>
  1115.  
  1116.                The INCLUDE parameter allows the sysop to tell EchoDor
  1117.                to read an additional file during startup.  This
  1118.                parameter is most useful for sysops that use multiple
  1119.                EchoDor#.Ctl files.  The parameters that are the same
  1120.                for each node can be placed in the "included" file.
  1121.                When EchoDor starts it will read the EchoDor#.Ctl file
  1122.                as normal.  When it encounters the INCLUDE parameter,
  1123.                the specified file will be read.  EchoDor will then
  1124.                complete reading the EchoDor#.Ctl file.
  1125.  
  1126.           LOGFILE <drive:\Path\FileSpec>
  1127.  
  1128.                This is the name of the file that EchoDor is to use for
  1129.                logging activity.  If the LOGFILE parameter is not
  1130.                specified, EchoDor will not do logging.
  1131.  
  1132.                The file name specified can include a single pound sign
  1133.                (#).  When EchoDor reads the EchoDor.Ctl file it will
  1134.                replace the pound sign (#) with the node number
  1135.  
  1136.  
  1137.  
  1138.                                   Page 17
  1139.  
  1140.  
  1141.                specified on the command line.  This allows multiple
  1142.                log files to be used for multiple nodes.
  1143.  
  1144.           LOGTYPE <chars>
  1145.  
  1146.                This specifies the type of logging information to be
  1147.                recorded.  The <chars> parameter contains the letter
  1148.                category(s) to be logged.  The following categories are
  1149.                available:
  1150.  
  1151.                     : (colon)  - general information
  1152.                     + (plus)   - read/scan information
  1153.                     $ (dollar) - write/change/kill information
  1154.  
  1155.                Multiple categories can be specified:
  1156.  
  1157.                     LOGTYPE +$
  1158.  
  1159.                If logging is enabled and the LOGTYPE parameter is not
  1160.                specified, full logging will occur.
  1161.  
  1162.           MAILFILE <Drive:\Path\FileSpec>
  1163.  
  1164.                This is the file name (and path) where you wish mail
  1165.                packed for download to be placed.  It should be in a
  1166.                directory that the files section of your BBS can access
  1167.                or somewhere where the download functions can find the
  1168.                file.  This parameter is not required if you do not
  1169.                enable packed mail.  The drive and path are optional
  1170.                and if omitted, EchoDor will create the mail file in
  1171.                the current directory.
  1172.  
  1173.                EchoDor will automatically create and delete this file
  1174.                depending on the user.
  1175.  
  1176.                The file name specified can include a single pound sign
  1177.                (#).  When EchoDor reads the EchoDor.Ctl file it will
  1178.                replace the pound sign (#) with the node number
  1179.                specified on the command line.  This allows multiple
  1180.                mail files to be used for multiple nodes.
  1181.  
  1182.           MAXUSERTIME  <xx>
  1183.  
  1184.                This is the maximum session time in minutes.
  1185.  
  1186.           MENU opt seclvl <Drive:\Path\FileSpec>
  1187.  
  1188.                This is an enhancement to the USERAREA and SYSOPAREA
  1189.                files which can be displayed to a user.  Normally a
  1190.                user will select an area by specifying either the name
  1191.                or number of the desired area.  Some BBS system carry a
  1192.                large number of conferences .. too many to place on a
  1193.                single screen.
  1194.  
  1195.                The "opt" is a single letter.  Any letter except Q & L
  1196.                can be used.  When that letter is selected the file
  1197.                specified on the MENU statement will be displayed to
  1198.                the user the the security level of the user is equal to
  1199.                or greater than the specified "seclvl".
  1200.  
  1201.  
  1202.  
  1203.                                   Page 18
  1204.  
  1205.  
  1206.                The "seclvl" is the security level the user must have
  1207.                to access the area.  The user level must be equal to or
  1208.                greater than the level specified.
  1209.  
  1210.                The "FileSpec" specified should not contain an
  1211.                extension.  Up to three files may be created.  See the
  1212.                preceding section on file names.
  1213.  
  1214.                Using the MENU command, the areas displayed to the user
  1215.                may be divided into sections.  The individual sections
  1216.                are selected by a single letter - the "opt".  When the
  1217.                letter is selected the file specified will be displayed
  1218.                to the user.
  1219.  
  1220.                A specific area may be selected from ANY menu by
  1221.                specifying the name or number of the area.  Also,
  1222.                access to every menu is available from any other menu.
  1223.  
  1224.           MENUFILE <Drive:\Path\FileSpec>
  1225.  
  1226.                This is the name of the main menu file.  It should not
  1227.                contain an extension. You should create 3 files for the
  1228.                menu.  See the preceding section on naming files.  The
  1229.                drive and path are optional and if omitted, EchoDor
  1230.                will look for the menu files in the current directory.
  1231.  
  1232.           MONO
  1233.  
  1234.                Use this option if you are using a monochrome system
  1235.                but still want your users to see color ANSI screens on
  1236.                their side.
  1237.  
  1238.           MSGTEXTCOLOR <xx>
  1239.  
  1240.                This is the color set when displaying or entering
  1241.                message text.  See the list of colors below.
  1242.  
  1243.           NET <xxx>
  1244.  
  1245.                This parameter specifies either a Fidonet NET number or
  1246.                a RBBSNET net number.
  1247.  
  1248.                This parameter MUST be specified before the first
  1249.                AREATABLE parameter.
  1250.  
  1251.           NOCOMMENT
  1252.  
  1253.                This option will disable the comment feature.
  1254.  
  1255.           NODE <xxx>
  1256.  
  1257.                This is your Fidonet or Rbbsnet node number.  It
  1258.                usually is between 1 and 4 digits in length, and SHOULD
  1259.                NOT include a point address IE: (100.0) leave off the
  1260.                point information.
  1261.  
  1262.                EchoDor requires that the node number specified be
  1263.                non-zero.
  1264.  
  1265.  
  1266.  
  1267.  
  1268.                                   Page 19
  1269.  
  1270.  
  1271.                This parameter MUST be specified before the first
  1272.                AREATABLE parameter.
  1273.  
  1274.           NODELISTPATH Type <drive:\path\>
  1275.  
  1276.                This tells EchoDor the subdirectory that contains the
  1277.                nodelist files and the type of nodelist file to use.
  1278.  
  1279.                Starting with EchoDor v3.09, two types of nodelists can
  1280.                be used.  The first is a compiled version 6 nodelist
  1281.                files (NODELIST.DAT & NODELIST.NDX).  When using this
  1282.                set the "Type" field in the NODELISTPATH line to V6.
  1283.                The second type of nodelist available is a special
  1284.                nodelist which is a combination of index files and the
  1285.                raw nodelist file.  The index files are created by the
  1286.                EchoDor nodelist compiler.  When using this type of
  1287.                nodelist specify ED as the "Type" field.
  1288.  
  1289.                Also, starting with EchoDor v3.09 this parameter is
  1290.                optional even if netmail is used; however, omitting
  1291.                this parameter will remove net/node number checking and
  1292.                verification as well as the ORIG/DEST lines while
  1293.                reading netmail.
  1294.  
  1295.           NODROPDOS
  1296.  
  1297.                This command will disable the drop to DOS option.
  1298.  
  1299.           NOIGNORE
  1300.  
  1301.                This will disable the ignore command.  The ignore
  1302.                command is used to exclude certain areas from the
  1303.                message check.  This is useful if you have a lot of
  1304.                echoes, and checking them all would take a very long
  1305.                time.
  1306.  
  1307.           NOPACKMAIL
  1308.  
  1309.                This disables the pack mail feature.  If you do not
  1310.                include this command then the "MAILFILE" command is
  1311.                required.
  1312.  
  1313.           NOSETNATIONAL
  1314.  
  1315.                By default, EchoDor will set everyone's ignore status
  1316.                to ignore national echoes.  This option will set All
  1317.                echoes to be checked.
  1318.  
  1319.           NOTAVAIL <drive:\path\filespec>
  1320.  
  1321.                If specified, this file will be displayed to users that
  1322.                try to access an area which they don't have access to
  1323.                because of security.  If this parameter is not
  1324.                specified, the system will issue an access not allowed
  1325.                type message.  The drive and path are optional.  If not
  1326.                specified EchoDor will look in the current directory
  1327.                for the file.
  1328.  
  1329.           NOWRITE <drive:\path\filespec>
  1330.  
  1331.  
  1332.  
  1333.                                   Page 20
  1334.  
  1335.  
  1336.                If specified, this file will be displayed to users that
  1337.                try to enter a message into an area for which they do
  1338.                not have write access.  If this parameter is not
  1339.                specified, the system will issue an access not allowed
  1340.                type message.  The drive and path are optional.  If not
  1341.                specified EchoDor will look in the current directory
  1342.                for the file.
  1343.  
  1344.           NUMHELPFILES <x>
  1345.  
  1346.                This is the number of help files (Not including the
  1347.                menu!).
  1348.  
  1349.           ORIGIN your origin line from your areas.BBS file
  1350.  
  1351.                This is the origin line that will be appended to all
  1352.                messages entered with EchoDor.  It should look the same
  1353.                as the one in your AREAS.BBS file (part of the echo
  1354.                mail system).  Do not include your net/node number in
  1355.                your origin line.  Versions of EchoDor later than 3.00
  1356.                will append your net node number to the end of your
  1357.                origin line.
  1358.  
  1359.                If you want an area to have different origin line from
  1360.                the one specified in the ORIGIN parameter, create a
  1361.                file called ORIGIN in that message area.  Put one line
  1362.                in this file, do not include your net/node number on
  1363.                the line.  When EchoDor saves your message it will
  1364.                check for this file.  If it finds one it will use the
  1365.                first line of the file to replace the ORIGIN line
  1366.                specified here.  You do not have to have an ORIGIN file
  1367.                in every area, if the ORIGIN file does not exist in
  1368.                some areas, EchoDor will use the ORIGIN line specified
  1369.                in this parameter.
  1370.  
  1371.           OUTBOUND <drive:\path>
  1372.  
  1373.                This is the full drive and path of your outbound
  1374.                directory.  The drive and path are required.  This
  1375.                parameter is only used by EchoUtil for tasks such as
  1376.                REQFILE, SENDFILE, ATTLIST .... this is not required
  1377.                for operation of EchoDor.
  1378.  
  1379.           PACKMENUFILE <drive:\path\file>
  1380.  
  1381.                This is the name of the pack menu file.  This file is
  1382.                displayed to the user when the [P] command on the main
  1383.                menu is selected.  It should not contain an extension.
  1384.                You should create 3 files for the menu.  See the
  1385.                preceding section on naming files.  The drive and path
  1386.                are optional and if omitted, EchoDor will look for the
  1387.                menu files in the current directory.
  1388.  
  1389.           PACKMAILTEXT <drive:\path\file>
  1390.  
  1391.                The file on this line will be displayed to any user
  1392.                that has caused a pack mail to be generated. This is
  1393.                usually used to tell the user where to find the mail
  1394.                file, for example:
  1395.  
  1396.  
  1397.  
  1398.                                   Page 21
  1399.  
  1400.  
  1401.                Your mail is packed ... you may download using [D].
  1402.  
  1403.           POINT <xx>
  1404.  
  1405.                This parameter specifies the POINT part of your net
  1406.                node number.  EchoDor does not currently provide point
  1407.                remaping; however, this value is placed in the ORIGIN
  1408.                line to complete the net node number.
  1409.  
  1410.                This parameter if used MUST be specified before the
  1411.                first AREATABLE command.
  1412.  
  1413.           SCANBARCOLOR <xx>
  1414.  
  1415.                This is the color set on the top line of the scan
  1416.                message display.
  1417.  
  1418.           SCANLINECOLOR <xx>
  1419.  
  1420.                This is the color set for each line displayed after the
  1421.                scan bar line during the Scan Messages function.
  1422.  
  1423.           SCANLOGNAME <drive:path\filespec>
  1424.  
  1425.                This tells EchoDor the full path name where the scan
  1426.                log file should be written.  This file is used by
  1427.                programs such as QM or CONFMAIL to specify the echo
  1428.                mail areas which contain new messages.  This file will
  1429.                only be written when a user enters a message into an
  1430.                echo mail or net mail area.  The drive and path are
  1431.                optional and if omitted, EchoDor will create the scan
  1432.                log file in the current directory.
  1433.  
  1434.                Note:  After mail is scanned by a mail scanner program
  1435.                (such as QM or CONFMAIL) this file MUST BE DELETED.
  1436.                Because a user may go in and out of EchoDor numerous
  1437.                times during a session, EchoDor will not delete this
  1438.                file but will read it in and append new areas to it.
  1439.  
  1440.                The file name specified can include a single pound sign
  1441.                (#).  When EchoDor reads the EchoDor.Ctl file it will
  1442.                replace the pound sign (#) with the node number
  1443.                specified on the command line.  This allows multiple
  1444.                scan log files to be used for multiple nodes.
  1445.  
  1446.           SYSOPAREALIST <drive:\path\Filespec>
  1447.  
  1448.                This is the file displayed to the SYSOP when the L)ist
  1449.                areas function is selected.  See the above description
  1450.                on naming files.  This parameter is required if you do
  1451.                not use the AREADESC.  The drive and path are optional.
  1452.  
  1453.           SYSOPNAME Firstname Lastname
  1454.  
  1455.                Enter one statement for each person you wish to access
  1456.                to the sysop conferences.  Each name must be enclosed
  1457.                in single quotes.  For more than one sysop, enter
  1458.                multiple statements.
  1459.  
  1460.  
  1461.  
  1462.  
  1463.                                   Page 22
  1464.  
  1465.  
  1466.                When a user logs on, his/her name is checked against
  1467.                the SYSOPNAME parameters.  If a match occurs, that
  1468.                person is considered a SYSOP and is given such status.
  1469.                If a match does not occur, the user is considered a
  1470.                regular user and is not given sysop status.  Also, the
  1471.                last SYSOPNAME listed is considered the SYSOP of the
  1472.                system.
  1473.  
  1474.           USERAREALIST <drive:\path\filespec>
  1475.  
  1476.                This is the file displayed to the user when the L)ist
  1477.                areas function is selected.  See the above description
  1478.                on naming files.  This parameter is required if you do
  1479.                not use the AREADESC.  The drive and path are optional.
  1480.  
  1481.           USERFILE <drive:\path\filespec>
  1482.  
  1483.                This is the name of the user file maintained by
  1484.                EchoDor.  If this parameter is not specified the
  1485.                default will be EchoUser.BBS in the current directory.
  1486.  
  1487.                Note:     This parameter is required when running a
  1488.                          multi-node system.  All copies of EchoDor
  1489.                          must share the same USERFILE.
  1490.  
  1491.           WELCOME <drive:\path\Filespec>
  1492.  
  1493.                This is the name of the welcome file that is to be
  1494.                displayed each time a user accesses the echo mail door.
  1495.                See the above description on naming files.  The drive
  1496.                and path are optional.
  1497.  
  1498.                If you do not wish to have a welcome file displayed to
  1499.                the user then remove this command.
  1500.  
  1501.           ZONE <xx>
  1502.  
  1503.                This parameter specifies you ZONE part of your net node
  1504.                number.  For FidoNet boards running in the US, this
  1505.                will be 1, for RBBSNet boards running in the US, this
  1506.                will be 8.
  1507.  
  1508.                This parameter MUST be specified before the AREATABLE
  1509.                command in the control file.
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.                                   Page 23
  1529.  
  1530.  
  1531.      Color Table
  1532.  
  1533.      The follow colors may be used for both background colors and
  1534.      foreground colors:
  1535.  
  1536.            0 - Black
  1537.            1 - Blue
  1538.            2 - Green
  1539.            3 - Cyan
  1540.            4 - Red
  1541.            5 - Magenta
  1542.            6 - Brown
  1543.            7 - Light Gray
  1544.  
  1545.      The following colors may be used only for foreground colors:
  1546.  
  1547.            8 - Dark Gray
  1548.            9 - Light Blue
  1549.           10 - Light Green
  1550.           11 - Light Cyan
  1551.           12 - Light Red
  1552.           13 - Light Magenta
  1553.           14 - Yellow
  1554.           15 - White
  1555.  
  1556.      Some parameters allow you to specify both a foreground and a
  1557.      background color; however, you must specify it in a single number
  1558.      (the parameter PROMPTCOLOR is an example of this).  To figure the
  1559.      number you want:
  1560.  
  1561.           First pick out your background color and multiply that
  1562.           number by 16.  Then add your foreground color.  For a
  1563.           background of red and a foreground of white.
  1564.  
  1565.                Red = 4.
  1566.                4 x 16 = 64.
  1567.                White = 15.
  1568.                64 + 15 = 79.
  1569.  
  1570.           Therefore the number you specify is 79.
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.                                   Page 24
  1594.  
  1595.  
  1596.      4.3  Pack Mail / Compress / Download Setup
  1597.  
  1598.      Starting with version 3.09 of EchoDor, a user may now pack mail,
  1599.      compress and then download this mail packet.  To fully impliment
  1600.      these features you must make modifications in the EchoDor batch
  1601.      file as well as changes in the EchoDor.CTL file.
  1602.  
  1603.      A compression is performed by external compression programs.  The
  1604.      mail file containing the text is passed as one of the parameters
  1605.      to the compression program.  A second parameter specifies the
  1606.      directory which should contain the compressed file.
  1607.  
  1608.      All downloads are implimented with external protocols.  One of
  1609.      the most popular is DSZ.  The included batch files give examples
  1610.      using DSZ.  Note that DSZ is a shareware program.  Registering
  1611.      EchoDor does not give you the right to use DSZ.  You should
  1612.      register that program also.
  1613.  
  1614.      4.3.1  Basic Setup
  1615.  
  1616.      To impliment Pack Mail you must include the following commands in
  1617.      the EchoDor.Ctl file:
  1618.  
  1619.           PACKMENU
  1620.  
  1621.           This command tells EchoDor where to find the PACKMENU files
  1622.           to be displayed to the user when he/she selects [P]ack Mail
  1623.           from the main menu.
  1624.  
  1625.           PACKMAILTEXT
  1626.  
  1627.           This command tells EchoDor the name of the file to display
  1628.           to the user when he/she has complete packing mail.  This
  1629.           file might say something like:
  1630.  
  1631.                Your mail is packed.  You may download using [D].
  1632.  
  1633.           MAILFILE
  1634.  
  1635.           This command tells EchoDor the name to use for the file
  1636.           created that contains the packed mail.
  1637.  
  1638.           Note that if you run multiple nodes, this file must be
  1639.           different for each node.  This difference may come by being
  1640.           in different directories or by using a different name in the
  1641.           differnt EchoDor#.Ctl files.  If you only run a single node,
  1642.           this file may be anything you want.
  1643.  
  1644.      You must also make sure that the NOPACKMAIL command in the
  1645.      EchoDor.Ctl file is commented out or removed.
  1646.  
  1647.      4.3.2  Compressing Mail
  1648.  
  1649.      To implement the mail compress feature of EchoDor, you must
  1650.      include the following additional parameters in the EchoDor.Ctl
  1651.      file.
  1652.  
  1653.           COMPRESSFILE <filename>
  1654.  
  1655.  
  1656.  
  1657.  
  1658.                                   Page 25
  1659.  
  1660.  
  1661.           This contains the name of the file to display to the user
  1662.           when [C]ompress is selected from the pack mail menu file.
  1663.           The file should contain a list of the available archive
  1664.           programs that can be used to compress the mail file.
  1665.  
  1666.           COMPRESSCHAR <characters>
  1667.  
  1668.           This command lists the characters used to select the
  1669.           compression program.  The case the user enters is not
  1670.           important.  A descripton of the compression program which is
  1671.           selected for each letter should be listed in the
  1672.           COMPRESSFILE.  For example:
  1673.  
  1674.                COMPRESSFILE APZ
  1675.  
  1676.           would allow the user to enter A or P or Z in response to the
  1677.           compress method query.
  1678.  
  1679.           COMPRESSDIR <drive:\path>
  1680.  
  1681.           This command specifies the directory which will be used by
  1682.           the compress program to hold the compressed mail file.  This
  1683.           file is checked by EchoDor during download to figure out of
  1684.           the user wants to download compressed mail or uncompressed
  1685.           mail.
  1686.  
  1687.           NOTE:     DO NOT USE THIS DIRECTORY FOR ANYTHING ELSE !!!!
  1688.  
  1689.                     This directory is completely erased by EchoDor
  1690.                     each time a new user logs into the system.
  1691.  
  1692.      The compress feature also requires you to change the main EchoDor
  1693.      batch file.  If you are already using the [D]ownload feature, no
  1694.      further changes will be needed.  When the user selects [C]ompress
  1695.      in the pack mail menu, EchoDor will do the following things:
  1696.  
  1697.           First, EchoDor will write a file called EchoEX#.BAT where
  1698.           the # is the node number which is passed as the first
  1699.           parameter on the command line that starts EchoDor.  This
  1700.           file will call the file EchoCMPS.BAT passing 4 parameters:
  1701.  
  1702.           1.   The letter of the selected compression program.  This
  1703.                will always be passed in upper case.  Only the letters
  1704.                listed on the COMPRESSCHAR statement will be passed.
  1705.  
  1706.                Use this parameter with "IF %1 == Z compress" type
  1707.                commands to select the correct compression program.
  1708.  
  1709.           2.   The node number.  This would be used for multi-node
  1710.                operation.  This is also passed back to EchoDor.BAT
  1711.                when restarting EchoDor after the download.
  1712.  
  1713.           3.   The mail file name.  This is the name of the file that
  1714.                contains the mail to be compressed.  The file name
  1715.                passed is exactly what is entered on the MAILFILE
  1716.                statement in the control file.
  1717.  
  1718.           4.   The directory that should contain the compressed
  1719.                MAILFILE.  The actual name of the file that you create
  1720.  
  1721.  
  1722.  
  1723.                                   Page 26
  1724.  
  1725.  
  1726.                is not important; however, IT MUST BE IN THE DIRECTORY
  1727.                specified as the forth parameter.
  1728.  
  1729.           Then, EchoDor will write a return file.  This file is used
  1730.           after EchoDor completes the download to figure who and how
  1731.           much time the user has.  This file is written in the default
  1732.           directory with the name EchoDor#.RET, where # is the node
  1733.           number.
  1734.  
  1735.           Finally, Echodor will exit with an errorlevel of 3.  This
  1736.           will signal the main batch file (ECHODOR.BAT) to run EchoEX#
  1737.           to start the compress process.  The '#' in 'EchoEX#' would
  1738.           be replaced with the node number.
  1739.  
  1740.           When the compress process is completed, the MAILFILE
  1741.           (parameter 3) file should be erased.  Then the main EchoDor
  1742.           batch file should be restarted passing %2 as the node
  1743.           parameter and /R to indicate restart (EchoDor.BAT %2 /R).
  1744.  
  1745.      Example batch files to impliment these procedures are included in
  1746.      the archive.
  1747.  
  1748.      4.3.3  Downloading Mail
  1749.  
  1750.      To implement the downloading feature of Echodor, you must include
  1751.      the following additional parameters in the EchoDor.Ctl file:
  1752.  
  1753.           DOWNLOADFILE <filename>
  1754.  
  1755.           This contains the name of the file to display to the user
  1756.           when [D]ownload is selected from the pack mail menu file.
  1757.           The file should contain a list of the available protocols
  1758.           that can be used to download.
  1759.  
  1760.           DOWNLOADCHAR <characters>
  1761.  
  1762.           This command lists the characters used to select the
  1763.           download protocol.  The case the user enters is not
  1764.           important.  A descripton of the protocol which is selected
  1765.           for each letter should be listed in the DOWNLOADFILE.  For
  1766.           example:
  1767.  
  1768.                DOWNLOADCHAR 12XYZ
  1769.  
  1770.           would allow the user to enter 1 or 2 or X or Y or Z in
  1771.           response to the protocol query.
  1772.  
  1773.      The download feature also requires you to change the main EchoDor
  1774.      batch file.  If you are using the [C]ompress feature, no further
  1775.      changes to the EchoDor batch file will be required.  When the
  1776.      user selects [D]ownload in the pack mail menu, EchoDor will do
  1777.      the following things:
  1778.  
  1779.           First, EchoDor will write a file called EchoEX#.BAT where
  1780.           the # is the node number which is passed as the first
  1781.           parameter on the command line that starts EchoDor.  This
  1782.           file will call the file EchoDNLD.BAT passing 5 parameters:
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.                                   Page 27
  1789.  
  1790.  
  1791.           1.   The letter of the selected protocol.  This will always
  1792.                be passed in upper case.  Only the letters listed on
  1793.                the DOWNLOADCHAR statement will be passed.
  1794.  
  1795.                Use this parameter with "IF %1 == Z protocol" type
  1796.                commands to select the correct protocol.
  1797.  
  1798.           2.   The node number.  This would be used for multi-node
  1799.                operation.  This is also passed back to EchoDor.BAT
  1800.                when restarting EchoDor after the download.
  1801.  
  1802.           3.   The com port number.  This is in the format of 1, 2, 3,
  1803.                ...etc.  If you need the format COMx in your batch file
  1804.                use COM%3.
  1805.  
  1806.           4.   The connected baud rate.  Some protocols need it, some
  1807.                don't.  If you are using EchoDor in a locked baud
  1808.                environment, this value will be passed at the locked
  1809.                rate.
  1810.  
  1811.           5.   The name of the mail file or the name of the compressed
  1812.                mail file.  This parameter is what should be downloaded
  1813.                to the user.  The file will contain a full drive / path
  1814.                / file name.  This file may or may not be compressed.
  1815.                If the user starts the download without requesting
  1816.                compression, the file will be the MAILFILE; otherwise,
  1817.                the file will be the compressed file.
  1818.  
  1819.                The download batch file dosen't have to worry about
  1820.                which file is to be downloaded.  The correct file will
  1821.                be passed to the batch file.
  1822.  
  1823.                After the download completes successfully, the
  1824.                downloaded file should be erased.
  1825.  
  1826.           Then, EchoDor will write a return file.  This file is used
  1827.           after EchoDor completes the download to figure who and how
  1828.           much time the user has.  This file is written in the default
  1829.           directory with the name EchoDor#.RET, where # is the node
  1830.           number.
  1831.  
  1832.           Finally, Echodor will exit with an errorlevel of 3.  This
  1833.           will signal the main batch file (ECHODOR.BAT) to run EchoEX#
  1834.           to start the download process.  The '#' in 'EchoEX#' would
  1835.           be replaced with the node number.
  1836.  
  1837.      When the download process is completed, the downloaded file
  1838.      should be erased.  Then the main EchoDor batch file should be
  1839.      restarted passing %2 as the node parameter and /R to indicate
  1840.      restart (EchoDor.BAT %2 /R).
  1841.  
  1842.      Example batch files to impliment these procedures are included in
  1843.      the archive.
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.                                   Page 28
  1854.  
  1855.  
  1856.      The following will graphically represent what what happens when
  1857.      you do a compress or download:
  1858.  
  1859.           +--------------+   The BBS starts EchoDor by shelling
  1860.           | BBS Calls    |   to a file called EchoDor.BAT with
  1861.           | EchoDor.bat  |   node number passed as the first
  1862.           |              |   parameter to the batch file.
  1863.           +--------------+
  1864.                  |<---------------------------------------------<--+
  1865.                  V                                                 |
  1866.           +--------------+                                         ^
  1867.           | EchoDor.EXE  |   When the user selects either          |
  1868.           | user selects |   [C]ompress or [D]ownload from         |
  1869.           | [C]ompress   |   the Pack Mail menu, EchoDor writes    |
  1870.           |     or       |   a file called EchoEx#.Bat then Echo-  |
  1871.           | [D]ownload   |   dor exits with an error level 3.      |
  1872.           +--------------+                                         |
  1873.                  |           The EchoDor.Bat file checks for an    |
  1874.                  V           ERRORLEVEL 3.  If present it starts   |
  1875.           +--------------+   EchoEX#.BAT, which will start either  |
  1876.           | EchoEX#.BAT  |   EchoCmps.Bat for [C]ompress or        |
  1877.           | Starts       |   EchoDnld.Bat for [D]ownloads.         |
  1878.           | Echoxxxx.BAT |                                         ^
  1879.           +--------------+                                         |
  1880.                  |           The batch file then either compresses |
  1881.                  V           the mail file (if EchoCmps.Bat) or    |
  1882.           +--------------+   does a download of the mail file      |
  1883.           | Download or  |   (if EchoDnld.Bat).  After completing  |
  1884.           | Compress     |   the task, the batch file restarts     |
  1885.           | EchoDor %1 /R|   EchoDor with the node number as the   |
  1886.           +--------------+   first parameter and /R as the second/ ^
  1887.                  |                                                 |
  1888.                  V                                                 |
  1889.                  +---->---------------------------------------->---+
  1890.  
  1891.           When EchoCmps.Bat finishes the mail file compress, or
  1892.           EchoDnld.BAT finishes with the download, it then restarts
  1893.           EchoDor be calling EchoDor.BAT with the same node number as
  1894.           way originally passed.  An additional parameter is passed on
  1895.           the restart line for EchoDor.  That is the /R parameter.
  1896.           This parameter tells EchoDor to restart the same user from
  1897.           information saved in the EchoDor#.RET file.
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.                                   Page 29
  1919.  
  1920.  
  1921.      4.4  Multiple Node Setup
  1922.  
  1923.      Another name of a multiple node setup is a multiple line setup.
  1924.      EchoDor has always supported multiple nodes.  However, with the
  1925.      additional options that are available and the somewhat varied
  1926.      systems supported, I thought a separate section explaining
  1927.      methods to be used to setup a multiple node system would be in
  1928.      order.
  1929.  
  1930.      There are two basic ways to set up EchoDor for multiple node
  1931.      operation.  The first way is the "common directory" method.
  1932.      Using this method, all the EchoDor files are in a single
  1933.      directory and node numbers are used to differentiae between users
  1934.      on the different nodes.  The second way is to use a separate
  1935.      directory for each node you plan to run.  This operation uses the
  1936.      "default" directory to keep multiple users separate.  Depending
  1937.      on the way you run your board and the BBS software you use will
  1938.      make one of the two methods most effective for your operation.
  1939.      The following sections explain how to set up each of the two
  1940.      methods and suggestions for when to use it.
  1941.  
  1942.      4.4.1  The Common Directory Method
  1943.  
  1944.      The common directory method places all the EchoDor files into a
  1945.      single directory.  EchoDor is then started with a different node
  1946.      number for each node.  This method is most effective when using
  1947.      BBS systems that run multiple nodes using node numbers and
  1948.      creates door information files with different names for each node
  1949.      (such as RBBS).
  1950.  
  1951.      How to set up the "common directory" system:
  1952.  
  1953.      1.   Create a directory to hold all the EchoDor files.  This is
  1954.           the same way you would set up EchoDor for a single node
  1955.           system.  We will call this the EchoDor Main Directory.
  1956.           EchoDor will never change directories during it's operation.
  1957.           You must make sure that the ECHODNLD & ECHOCMPS batch files
  1958.           don't change directories either, watch out for download
  1959.           protocol programs and compress programs that change the
  1960.           directory without you telling them.
  1961.  
  1962.      2.   If you intend to use the COMPRESS feature in EchoDor set up
  1963.           a separate subdirectory within the EchoDor Main Directory
  1964.           for each node.  Use names something like this:
  1965.  
  1966.                COMPRES0  -    local use
  1967.                COMPRES1  -    Node 1 use
  1968.                COMPRES2  -    Node 2 use
  1969.                     .
  1970.                     .
  1971.                COMPRES9  -    Node 9 use
  1972.  
  1973.      3.   Make the following changes to your EchoDor.Ctl file:
  1974.  
  1975.           a.   If you use the SCANLOGNAME command, change it to
  1976.                something like:
  1977.  
  1978.                SCANLOGNAME EchoDor\Scan#.Log
  1979.  
  1980.  
  1981.  
  1982.  
  1983.                                   Page 30
  1984.  
  1985.  
  1986.                Notice the '#' in the name.  This will be replaced with
  1987.                the node number you use to start EchoDor.
  1988.  
  1989.           b.   If you are using the mail file features of EchoDor
  1990.                (which is always used with COMPRESS & DOWNLOAD) you
  1991.                must change the MAILFILE command to something like
  1992.                this:
  1993.  
  1994.                MAILFILE Mail#.Txt
  1995.  
  1996.                Notice the '#' in the name.  This will be replaced with
  1997.                the node number you use to start EchoDor.
  1998.  
  1999.           c.   If you are using the mail compress feature of EchoDor
  2000.                you will need to change the COMPRESSDIR command to
  2001.                something like:
  2002.  
  2003.                COMPRESSDIR COMPRES#
  2004.  
  2005.                Notice the '#' in the directory name.  This is replaced
  2006.                with the node number you use to start EchoDor.  The
  2007.                "COMPRES#" name will be changed to names like
  2008.                "COMPRES0", "COMPRES1", and so on.  The names must
  2009.                match the directories you created in the above section.
  2010.  
  2011.      4.   Also, you will have to make your batch files that control
  2012.           scanning the mail after it is entered aware of the log
  2013.           names.  In place of making a very complex batch file to
  2014.           decide which log to pass to your mail packer, you can use
  2015.           SCANMRG to combine the various scan logs into a single log,
  2016.           then perform a single scan once a day.  To perform this
  2017.           operation you would add a command such as:
  2018.  
  2019.                SCANMRG EchoDor\Scan%1.Log EchoDor\ScanLog.Log
  2020.  
  2021.           This command goes in your EchoDor.Bat file after the IF
  2022.           ERRORLEVEL 3 line.  This would combine all the Scanlogs for
  2023.           the various nodes into a single ScanLog.  An explination of
  2024.           SCANMRG is in sections that follow.  You should not relpace
  2025.           the SCANMRG with a copy/append command as the operation of
  2026.           SCANMRG is different.
  2027.  
  2028.      5.   If the various nodes in your system need other changes in
  2029.           the EchoDor.Ctl file for reasons such as different echos,
  2030.           different privileges or other such reasons, EchoDor allows
  2031.           you to create a separate EchoDor.Ctl file for each node.
  2032.           The specific file used is created by changing the name of
  2033.           the base file:
  2034.  
  2035.                EchoDor.Ctl - this is the default file
  2036.                EchoDor0.Ctl - this would be used for local operation
  2037.                EchoDor1.Ctl - this would be used for node 1
  2038.                EchoDor2.Ctl - this would be used for node 2
  2039.                     .
  2040.                     .
  2041.                EchoDor9.Ctl - this would be used for node 9
  2042.  
  2043.           You should still make the changes outlined above in the
  2044.           EchoDor.Ctl file before you make copies of it for the
  2045.  
  2046.  
  2047.  
  2048.                                   Page 31
  2049.  
  2050.  
  2051.           various nodes.  This will help prevent errors when you
  2052.           create the EchoDor#.Ctl files for the various nodes.
  2053.  
  2054.           Also, be sure the EchoDor.Ctl file contains EVERY message
  2055.           are you intend to carry.  This is the file used by EchoUtil
  2056.           when performing maintenance.
  2057.  
  2058.           Finally, be aware that should a node look for it's
  2059.           EchoDo#.Ctl file and one is not present, EchoDor will use
  2060.           the default (EchoDor.Ctl) file.
  2061.  
  2062.      6.   If the various nodes in your system require different
  2063.           information in the DoorDriv.Ctl file, such as for different
  2064.           types of modems or different BBS names or different SYSOP
  2065.           names, EchoDor allows multiple DoorDriv.Ctl files to be used
  2066.           for each node.  The specific file used is created by
  2067.           changing the name of the base file:
  2068.  
  2069.                DoorDriv.Ctl - this is the default file
  2070.                DoorDri0.Ctl - this is used for local operation
  2071.                DoorDri1.Ctl - this is used for node 1
  2072.                DoorDri2.Ctl - this is used for node 2
  2073.                     .
  2074.                     .
  2075.                DoorDri9.Ctl - this is used for node 9
  2076.  
  2077.           If EchoDor looks for it's DoorDri#.Ctl file and cannot find
  2078.           it, it will use the default (DoorDriv.Ctl) file.
  2079.  
  2080.      4.4.2  Multiple Directory Method
  2081.  
  2082.      The multiple directory method sets up a single directory to hold
  2083.      all the "common" EchoDor files and separate directories for the
  2084.      "node specific" files.  This method is most effective when used
  2085.      with BBS systems that do not provide "node number" information
  2086.      and always names the door information file the same (such as
  2087.      WildCat!).
  2088.  
  2089.      To set  up a "multiple directory" system do the following:
  2090.  
  2091.      1.   Create a "common" directory which will be shared between all
  2092.           the nodes in the system.  Put the following files in this
  2093.           directory (check your EchoDor.Ctl file for the exact names):
  2094.  
  2095.                ECHOUSER.BBS - this is the main user file
  2096.                The MENUFILE files (used for the main menu)
  2097.                The PACKMENUFILE files (used for the pack menu)
  2098.                The USERAREALIST files (conference lists)
  2099.                The SYSOPAREALIST files (sysop conference list)
  2100.                The MENU files (conference menu files)
  2101.                The help files
  2102.                The DOWNLOADFILE
  2103.                The COMPRESSFILE
  2104.                The NOTAVAIL file
  2105.                The NOWRITE file
  2106.                The PACKMAILTEXT file
  2107.                The WELCOME files
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.                                   Page 32
  2114.  
  2115.  
  2116.           Also, put a copy of the DoorDriv.Ctl & EchoDor.Ctl file into
  2117.           this directory.  We will use the files in the "common"
  2118.           directory to make a model for all the other directories.
  2119.  
  2120.      2.   Now we will edit the EchoDor.Ctl file that we have placed in
  2121.           the common directory.  The following lines should be changed
  2122.           to include a full drive, path, and file name so that the
  2123.           various nodes can find these files:
  2124.  
  2125.                USERFILE <drive:\path\name>
  2126.  
  2127.                This is probally the most important line in the
  2128.                EchoDor.Ctl file when using mutliple node / multiple
  2129.                directory setups.  This tells EchoDor where to find the
  2130.                main user file.  Be sure to specify a full drive, path,
  2131.                and file name in this line.  This will cause EchoDor to
  2132.                share the file between nodes.
  2133.  
  2134.                MENUFILE
  2135.                PACKMENUFILE
  2136.                USERAREALIST
  2137.                SYSOPAREALIST
  2138.                NOWRITE
  2139.                NOTAVAIL
  2140.                HELPFILEPREFIX
  2141.                MENU
  2142.                DOWNLOADFILE
  2143.                COMPRESSFILE
  2144.                PACKMAILTEXT
  2145.                WELCOME
  2146.  
  2147.           Now we are going to edit the lines which are "node"
  2148.           dependent.  These lines will NOT include a full path but
  2149.           will only include file names or directory names.  DO NOT use
  2150.           the '#' in the file name.  This should only be used for
  2151.           "common directory" operation.
  2152.  
  2153.                MAILFILE <filename>
  2154.                     Only use a file name.  Don't include a drive or
  2155.                     path.  For example:
  2156.  
  2157.                          MAILFILE mailfile.txt
  2158.  
  2159.                COMPRESSDIR <directory name>
  2160.                     Only use a single name.  Don't include a drive or
  2161.                     path.  For example:
  2162.  
  2163.                          COMPRESSDIR compress
  2164.  
  2165.                SCANLOGNAME <filename>
  2166.                     Only use a file name.  Don't include a drive or
  2167.                     path.  For example:
  2168.  
  2169.                          SCANLOGNAME scanlog.log
  2170.  
  2171.           Be sure this "default" EchoDor.Ctl file contains ALL the
  2172.           message areas that you intend to carry on your system.  We
  2173.           will use this file during maintenance (EchoUtil /M) to tell
  2174.           EchoUtil where ALL the areas are to be processed.
  2175.  
  2176.  
  2177.  
  2178.                                   Page 33
  2179.  
  2180.  
  2181.           Save the EchoDor.Ctl file.
  2182.  
  2183.      3.   Now we need to edit the DoorDriv.Ctl file.  Make all the
  2184.           changes outlined in the above section.  Then:
  2185.  
  2186.                Remove the BBSPATH line.  It will be necessary to "pick
  2187.                up" the door information file from the default /
  2188.                current directory.
  2189.  
  2190.           We may have to make other changes in the DoorDriv.Ctl file
  2191.           based on the "node" but we'll save that for a little later.
  2192.           Save the DoorDriv.Ctl file.
  2193.  
  2194.      4.   Create a separate subdirectory for each node that you intend
  2195.           to run.
  2196.  
  2197.      5.   Switch to the subdirectory that you created for one of the
  2198.           nodes.  Remember which node this directory is going to be
  2199.           used for.  Then do the following:
  2200.  
  2201.                Copy the EchoDor.Ctl file in the "common" directory to
  2202.                this directory.  Do not rename the file.  It should
  2203.                still be EchoDor.Ctl.
  2204.  
  2205.                Copy the DoorDriv.Ctl file in the "common" directory to
  2206.                this directory.  Do not rename the file.  It should
  2207.                still be EchoDor.Ctl.
  2208.  
  2209.                Copy the EchoDor.BAT file into the current directory.
  2210.  
  2211.                If you are using the COMPRESSDIR command in your
  2212.                EchoDor.Ctl file, create a directory with the name you
  2213.                specified in the COMPRESSDIR command.  The COMPRESSDIR
  2214.                command in your EchoDor.Ctl file should only contain
  2215.                the name of the directory.  It should not include any
  2216.                drive or path specifications.
  2217.  
  2218.      6.   Depending on your BBS and system requirements, you may have
  2219.           to edit the DoorDriv.Ctl file.  Based on the node you may
  2220.           have to change:
  2221.  
  2222.                The BAUD line.  If this node runs a locked baud be sure
  2223.                to include a BAUD line.
  2224.  
  2225.                The COMPORT line.  If your BBS does not provide the com
  2226.                port in the door information file, edit this line to
  2227.                tell EchoDor which port to use for this node.
  2228.  
  2229.                Make any other changes that are needed for this
  2230.                specific node. Then save the DoorDriv.Ctl file.
  2231.  
  2232.      7.   Edit the EchoDor.BAT file:
  2233.  
  2234.                Include a line to copy the door information file from
  2235.                THIS NODE's BBS directory to the current directory.
  2236.  
  2237.                Perform the needed operations to get the SCANLOGFILE
  2238.                into where ever it needs to go.  This will depend a
  2239.                great deal on how you process the newly entered
  2240.                messages.
  2241.  
  2242.  
  2243.                                   Page 34
  2244.  
  2245.  
  2246.                Do what ever is needed to get you back to your bbs
  2247.                directory to restart / reload your BBS program.
  2248.  
  2249.      8.   If you use COMPRESS and/or DOWNLOAD, be sure the ECHOCMPS
  2250.           and the ECHODNLD batch files are placed somewhere on your
  2251.           PATH.  This is so the main EchoDor.BAT file can find them.
  2252.           If you don't want to place these batch files in your path,
  2253.           place a copy of them in each node's subdirectory.
  2254.  
  2255.      The following special considerations must be made when performing
  2256.      the mail compress and renumber.
  2257.  
  2258.      1.   Be sure that the EchoDor.Ctl file contained in the "common"
  2259.           directory contains EVERY message area that you are carrying
  2260.           online.
  2261.  
  2262.      2.   When performing purge and renumber, be sure to switch to
  2263.           this directory before you run EchoUtil /M.
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.                                   Page 35
  2309.  
  2310.  
  2311.      4.5  Multiple Net Setup
  2312.  
  2313.      Starting with version 3.03 of Echodor, multiple net/node numbers
  2314.      may be used.  The system will only allow one net/node number per
  2315.      echo area; however, your echo areas may be split up into groups
  2316.      with a different net/node number for each group.
  2317.  
  2318.      When an echo message in entered, the specified net/node number
  2319.      which applies to that area is appended to the origin line and
  2320.      placed in the origin fields in the message. Normally only one
  2321.      net/node number is specified in the ECHODOR.CTL file; however, if
  2322.      you follow the structure of the example below you can have
  2323.      EchoDor place the correct net/node number, in a multi-net setup,
  2324.      in the origin line and message depending on the echo area where
  2325.      the message was entered.
  2326.  
  2327.      To use multiple net/node numbers you must group your echo areas
  2328.      together using AREATABLE / ENDAREATABLE specifications and
  2329.      multiple ZONE, NET, NODE, and POINT commands.  Using the
  2330.      following as an example of what might be in a ECHODOR.CTL file:
  2331.  
  2332.      ;
  2333.      ;  Specify the secondary zone/net/node first
  2334.      ;
  2335.      ZONE 8
  2336.      NET 255
  2337.      NODE 128
  2338.      POINT 0
  2339.      ;
  2340.      ; Now specify the areas which should use 8:255/128.0 in
  2341.      ; their origin line.  The AREATABLE / ENDAREATABLE should
  2342.      ; be exactly like what would be used for a single net.  See
  2343.      ; the above description for how to specify an AREATABLE.
  2344.      ;
  2345.      AREATABLE
  2346.      1 echoone echotag path ...........ect
  2347.      2 echotwo echotag path ...........etc
  2348.      ENDAREATABLE
  2349.      ;
  2350.      ; now specify the primary zone/net/node (1:116/10.0)
  2351.      ;
  2352.      ZONE 1
  2353.      NET 116
  2354.      NODE 10
  2355.      POINT 0
  2356.      ;
  2357.      ;  Now the areas which should use 1:116/10.0 in their
  2358.      ;  origin line.
  2359.      ;
  2360.      AREATABLE
  2361.      3 echothree echotag .......
  2362.      4 echofour  echotag .......
  2363.      ENDAREATABLE
  2364.  
  2365.      Notice that the AREA NUMBERS in the first AREATABLE and the
  2366.      second AREATABLE were NOT duplicated.  An area number may only
  2367.      appear once even when you use multiple AREATABLEs.
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.                                   Page 36
  2374.  
  2375.  
  2376.      Also, if you use the AREADESC to specify the descriptions for
  2377.      your areas, all the areas in both nets may be specified in a
  2378.      single AREADESC / ENDAREADESC.
  2379.  
  2380.      EchoDor is not limited to only two nets.  You may specify as many
  2381.      net/node groups as you require for your setup.  The total number
  2382.      of areas (echo, local, and net mail) for all areas added together
  2383.      may not exceed 255.
  2384.  
  2385.  
  2386.  
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.                                   Page 37
  2439.  
  2440.  
  2441.      5.0  Purging & Renumbering Areas
  2442.  
  2443.      Purging and renumbering your message areas is a three step
  2444.      process.  You must not omit any of these steps otherwise the last
  2445.      read pointers will not be correctly set.  These steps include:
  2446.  
  2447.         1.  Old messages are deleted.  At this time the messages
  2448.             should NOT be renumbered.  This is purging.
  2449.  
  2450.         2.  Second, EchoUtil must be run in maintenance mode (EchoUtil
  2451.             /M) to figure out what each users last read pointer should
  2452.             be after the message bases are renumbered (next step).
  2453.             Note:  This step must be performed BEFORE the actual
  2454.             renumbering the message areas.
  2455.  
  2456.         3.  Third, the message areas are renumbered.
  2457.  
  2458.      There are a number of utilities which can perform the first
  2459.      (purge) and third (renumber) steps.  Starting with EchoDor 3.05,
  2460.      I am providing automated assistance in generating the required
  2461.      files to perform these operations using RASMSM v2.00 or later.
  2462.  
  2463.      RASMAM is a program written by Roger Smith, Jr of 1:366/14.  The
  2464.      program is geared for Opus but works great for any other system
  2465.      which uses the #.msg format for messages.  Please remember that
  2466.      this program is also a shareware program.  Registration of
  2467.      EchoDor does not entitle you to use RASMAM without registration.
  2468.  
  2469.      I currently have a copy of RASMAM available on the WorkBench BBS
  2470.      which can be downloaded using the name OMAM_200.ZIP.
  2471.  
  2472.      RASMAM uses script files to direct it's actions.  To use RASMAM
  2473.      for maintance, the following batch file could be used:
  2474.  
  2475.      REM - first purge the message areas
  2476.      REM -   "purge.mam" is the file that controls the purging
  2477.      REM
  2478.      RASMAM purge.mam
  2479.      REM
  2480.      REM - then run EchoDor maintanance
  2481.      REM - both EchoDor /M & EchoUtil /M will do it
  2482.      REM
  2483.      EchoUtil /M
  2484.      REM
  2485.      REM - then renumber the message areas
  2486.      REM     "renum.mam" is the file that controls renumbering
  2487.      REM
  2488.      RASMAM renum.mam
  2489.  
  2490.      In the above sample, two files are required for RASMAM.  This is
  2491.      PURGE.MAM which contains information on purging the areas and
  2492.      RENUM.MAM which contains information on renumbering the areas.
  2493.      EchoUtil will assist you in generating these files.  Use one of
  2494.      the following commands:
  2495.  
  2496.           ECHOUTIL /RASMAM
  2497.  
  2498.           ECHOUTIL /RASMAM nnn
  2499.  
  2500.           ECHOUTIL /RASMAM ?
  2501.  
  2502.  
  2503.                                   Page 38
  2504.  
  2505.  
  2506.      If you use the first command, ECHOUTIL will generate a PURGE.MAM
  2507.      file and a RENUM.MAM file (both in the current directory).  All
  2508.      message areas will be purged to contain 100 messages.
  2509.  
  2510.      If you use the second command, ECHOUTIL will generate the
  2511.      PURGE.MAM and RENUM.MAM files which will will maintain all
  2512.      message areas with "nnn" number of messages.  The "nnn" value may
  2513.      be from 1 to 255.  Any number outside this range will cause
  2514.      ECHOUTIL to use 100.
  2515.  
  2516.      If you use the third command, ECHOUTIL will generate the
  2517.      PURGE.MAM and RENUM.MAM files for all message areas.  It will ask
  2518.      for the number of messages to keep in each area as the files are
  2519.      generated.  Any number may be used.
  2520.  
  2521.      These files may be edited after they are created to include any
  2522.      special processing which can be provided by RASMAM.
  2523.  
  2524.      Note: EchoUtil will not check to see if you already have either
  2525.      of these two files in the current directory.  It will just
  2526.      overwrite them if they are out there.  Also, be sure that the TAG
  2527.      in the AREATABLE is unique for each area.  This "TAG" is used
  2528.      when generating the PURGE.MAM and RENUM.MAM files for naming the
  2529.      areas.
  2530.  
  2531.  
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.                                   Page 39
  2569.  
  2570.  
  2571.      6.0  EchoDor Operation
  2572.  
  2573.      EchoDor operation is simple.  It has been designed to look like
  2574.      part of your BBS.  The menu files can be changed to look like the
  2575.      rest of your system as well.  The command letters may NOT be
  2576.      changed.
  2577.  
  2578.      6.1  Menu Commands
  2579.  
  2580.      The valid commands from the main menu are as follows:
  2581.  
  2582.           J - Join Conference
  2583.           A - Area Change
  2584.  
  2585.                When this function is selected, the user is presented
  2586.                with a prompt asking for the echo mail area number, or
  2587.                the name, or 'L' to list the areas.  If you have
  2588.                defined a description table in your ECHODOR.CTL file,
  2589.                the description table will be listed. If you are using
  2590.                the USERAREAFILE and the SYSOPAREAFILE parameters, the
  2591.                corresponding file will be displayed. If graphic
  2592.                versions of the file exist, they will be displayed if
  2593.                the user supports ANSI or ASCII graphics.
  2594.  
  2595.                If your BBS system uses the term area instead of
  2596.                conference, modify the menu to say [A]rea Change.
  2597.                EchoDor will except either J or A to change
  2598.                conferences.
  2599.  
  2600.           C - Check Personal Mail
  2601.  
  2602.                When this function is selected, the user is presented
  2603.                with a prompt that asks him/her to verify that mail is
  2604.                to be checked.  During the check, only conferences that
  2605.                have been selected in the IGNORE EDITOR will be
  2606.                checked.  The user can abort the scan at any time by
  2607.                pressing 'S'.  When a message is found, the header
  2608.                information will be displayed.
  2609.  
  2610.           F - Toggle Full Screen Editor
  2611.  
  2612.                This function allows the user to turn the full screen
  2613.                editor on or off regardless of his/her graphics
  2614.                setting.  See the FULL SCREEN EDITOR reference section
  2615.                for instructions for its use.
  2616.  
  2617.           H - Invoke the Help System.
  2618.  
  2619.                This displays the help menu to the user.  See the HELP
  2620.                SYSTEM reference section for information of the help
  2621.                system.
  2622.  
  2623.           I - Ignore Editor.
  2624.  
  2625.                This editor allows the  user to include or exclude any
  2626.                conference from the 'check personal mail', 'check new
  2627.                messages', or 'Pack mail' functions.
  2628.  
  2629.           L - Leave Sysop a Comment.
  2630.  
  2631.  
  2632.  
  2633.                                   Page 40
  2634.  
  2635.  
  2636.                This option lets the user enter a message into the
  2637.                comment area.  This option is not valid if the
  2638.                NOCOMMENT parameter is specified.  If you decide to
  2639.                disable comments, you should edit the echo menus to
  2640.                remove the option.
  2641.  
  2642.           P - Pack Mail section.
  2643.  
  2644.                This function allows the user to enter the Pack Mail
  2645.                section.  Within this section the user can pack mail
  2646.                for download.
  2647.  
  2648.           R - Read Messages.
  2649.  
  2650.                This function allows the user to read & reply to the
  2651.                messages in the current echo mail area.  The user is
  2652.                presented with a sub-menu of options after each message
  2653.                is displayed.
  2654.  
  2655.           S - Scan Messages.
  2656.  
  2657.                This function allows the user to display a list of
  2658.                message headers.  (IE:  To....From....Sbj) Etc.
  2659.  
  2660.           E - Enter a Message.
  2661.  
  2662.                EchoDor users may select a line editor much like most
  2663.                BBS's, or a full screen editor.  This full screen
  2664.                editor is the same editor found in PRODOOR. (The
  2665.                PCBOARD Door).  See the full screen editor section for
  2666.                more information.
  2667.  
  2668.           X - Expert Toggle.
  2669.  
  2670.                This turns on and off the main menu display. Just like
  2671.                most BBS's.
  2672.  
  2673.           Q - Quit EchoDor.
  2674.  
  2675.                In local mode this function will return you to the DOS
  2676.                prompt.  In On-line mode, this function will return the
  2677.                caller to the BBS.
  2678.  
  2679.           Z - Sysop commands.
  2680.  
  2681.                This function enters the SYSOP menu.  From the SYSOP
  2682.                menu you may Copy or Doctor messages, read the nodelist
  2683.                or check EchoDor users.
  2684.  
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.                                   Page 41
  2699.  
  2700.  
  2701.      6.2  Reading messages
  2702.  
  2703.      After activating the read message command (R), you will then be
  2704.      shown the message in the area where your last read pointer is
  2705.      set.  At the bottom of the screen, a prompt line will be shown
  2706.      which will give you a set of options.  Each option is selected by
  2707.      typing the first letter of that option.  You may also select a
  2708.      specific message to be displayed by entering the message number
  2709.      of the desired message in place of an option letter.  If the
  2710.      message is public or address to you or from you, it will be
  2711.      displayed.
  2712.  
  2713.           [N]ext
  2714.                Attempt to go to the next message in the base.  If
  2715.                possible, the message pointer will be moved to the next
  2716.                message in the area until either a public or a private
  2717.                message addressed to you is found. The message will be
  2718.                displayed to you and the prompt line will once again be
  2719.                shown.
  2720.  
  2721.           [P]rev
  2722.                Attempt to go to the previous message in the area.  If
  2723.                possible, the message pointer will be moved to the
  2724.                message preceding the one that you just read.  Private
  2725.                messages not addressed to you will not be displayed.
  2726.  
  2727.           #
  2728.                Display a specific message.  Don't actually type a
  2729.                number sign (#), just type the number of the message
  2730.                you want to see. If the message exists and is public or
  2731.                addressed to you it will be displayed.
  2732.  
  2733.           +
  2734.                If the message you are reading has a reply the plus
  2735.                sign (+) will be displayed.  By pressing this you will
  2736.                read the reply.  From that point on, pressing <enter>
  2737.                will read each successive reply.  This is known as
  2738.                reading a thread.
  2739.  
  2740.           -
  2741.                If the message you are reading is a reply the minus (-)
  2742.                sign will be displayed.  By pressing this you will read
  2743.                the original message.  From that point on, pressing
  2744.                <enter> will read each original message.  This is also
  2745.                known as reading a thread.
  2746.  
  2747.           *
  2748.                The first time you press plus (+) or minus (-) to begin
  2749.                reading a thread, EchoDor remembers where you were in
  2750.                the message base.  While reading a thread, you can
  2751.                return to your starting point by pressing the asterisk
  2752.                (*) key.
  2753.  
  2754.           [R]eply
  2755.                This will allow you to enter a reply message to the
  2756.                message that you are currently reading. For more
  2757.                information on entering messages, please see the
  2758.                information on entering a message.
  2759.  
  2760.           [Q]uit
  2761.  
  2762.  
  2763.                                   Page 42
  2764.  
  2765.  
  2766.                Quit to the main menu.  This will bring you back to the
  2767.                main menu of the message system.  The last message you
  2768.                read in each area will be remembered for you.
  2769.  
  2770.           [K]ill
  2771.                If the current message is either to or from you, then
  2772.                you will be presented with the kill option.  The kill
  2773.                option will physically erase the message from disk.  It
  2774.                will be no longer readable and CANNOT BE RESTORED.
  2775.  
  2776.           [S]ave
  2777.                This will capture the current message to the
  2778.                usermail.txt file.
  2779.  
  2780.           [C]hange
  2781.                If the current message is either to or from you, then
  2782.                you will also be presented with this option. It will
  2783.                allow you to change the content of the current message.
  2784.                Do not remove the Origin or tear lines.
  2785.  
  2786.           [A]ll
  2787.                This option will allow you to display all the messages
  2788.                starting at your current message without stopping.
  2789.                This option is handy if you wish to "capture" the
  2790.                messages in an area using your terminal software.  If
  2791.                you enable this option it will stop if you press any
  2792.                key or you reach the end of the current area.
  2793.  
  2794.           [E]nter
  2795.                This option will allow you to enter a message from the
  2796.                read menu.  This operates exactly like the [E]nter
  2797.                function on the main menu.
  2798.  
  2799.      The following sysop functions are available from the read menu:
  2800.  
  2801.           [H]ard  Copy
  2802.                This option allows the sysop to request EchoDor to
  2803.                print a hard copy of the message.  LPT1 is always used.
  2804.                Make sure that the printer is on line as EchoDor does
  2805.                not have built in recovery from printer errors.
  2806.  
  2807.           [X]erox
  2808.                This is the Xerox message function.  It allows you to
  2809.                send a copy of the message to another user.  The
  2810.                message to be copied is always the just read message.
  2811.                The copied may be addressed to anyone.  It may also be
  2812.                placed into any area.
  2813.  
  2814.           [V]iewall
  2815.                This function is not listed but is available on the
  2816.                read menu.  This function allows the SYSOP to see all
  2817.                lines in the message.  This includes SEEN-BYs, PATH
  2818.                lines, and kludge lines.  The message is redisplayed
  2819.                with all lines visible.
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.                                   Page 43
  2829.  
  2830.  
  2831.      6.3  Entering messages
  2832.  
  2833.      There are two ways to enter messages:
  2834.  
  2835.           1) With the full-screen editor.
  2836.           2) With the line editor.
  2837.  
  2838.      Each of these methods will be described separately.  If you are
  2839.      using IBM ANSI graphics, then the full screen editor will be
  2840.      chosen for you.  If not, then the line editor will be chosen.
  2841.  
  2842.      6.3.1  Line Editor
  2843.  
  2844.      The line editor is the simplest of the two editors.  You are
  2845.      initially placed in "entry mode" where you will just have to type
  2846.      your message.  The lines will be wrapped automatically for you.
  2847.      You press enter at the beginning of a line to leave "entry mode".
  2848.      After leaving "entry mode", you will be presented with a small
  2849.      menu consisting of these options:
  2850.  
  2851.           [C]ont
  2852.                Continue the current message. This will simply place
  2853.                you back into the line editor's "entry mode" at the end
  2854.                of the last line you entered.
  2855.  
  2856.           [I]nsert
  2857.                This will allow you to insert a line anywhere into the
  2858.                message.  When you select this option the line editor
  2859.                will ask you where you want to insert the line.
  2860.  
  2861.           [D]elete
  2862.                This option will let you delete any line in the
  2863.                message.  When you select this option you will be asked
  2864.                the starting and ending line(s) you want to delete.
  2865.  
  2866.           [V]isual
  2867.                If you are using ANSI graphics, this will let you re-
  2868.                enter the full screen editor.
  2869.  
  2870.           [Q]uote
  2871.                If you are entering a reply, you may quote lines
  2872.                directly from the original message. When you select
  2873.                this option you will be given another small menu which
  2874.                will allow you to:
  2875.  
  2876.                List the original message.
  2877.                Specify the starting line number to quote.
  2878.                Specify the ending line number to quote.
  2879.                Display the message your current writing.
  2880.                Specify the line where the quoted lines are to be
  2881.                inserted.
  2882.  
  2883.           [A]bort
  2884.                This will throw the message that your are currently
  2885.                entering away and exit the line editor.
  2886.  
  2887.           [S]ave
  2888.                This will save the message you are entering and will
  2889.                exit the line editor.
  2890.  
  2891.  
  2892.  
  2893.                                   Page 44
  2894.  
  2895.  
  2896.      6.3.2  Full Screen Editor
  2897.  
  2898.      The EchoDor full screen editor is the same editor that appears in
  2899.      PRODOOR (Thanks  Sam!).  It provides full-screen editing for on
  2900.      line message entry.  Full screen editing requires ANSI terminal
  2901.      emulation.  The full screen editing commands are WordStar-Like
  2902.      control characters.  If your terminal program provides ANSI
  2903.      keyboard emulation, you will also be able to use the indicated
  2904.      function keys.  Here is a summary of the editor commands:
  2905.  
  2906.           << Cursor Motion >>
  2907.  
  2908.              Ctrl-S  Move left 1 character           (Left arrow key)
  2909.              Ctrl-D  Move right 1 character          (Right arrow key)
  2910.              Ctrl-E  Move up 1 line                  (Up arrow key)
  2911.              Ctrl-X  Move down 1 line                (Down arrow key)
  2912.              Ctrl-A  Move left 1 word
  2913.              Ctrl-F  Move right 1 word
  2914.              Ctrl-I  Tab cursor to next tab stop      (Tab key)
  2915.              Ctrl-P  Move cursor to line end         (End key)
  2916.  
  2917.  
  2918.           << Scrolling >>
  2919.  
  2920.              Ctrl-R  Move up a page                  (PgUp key)
  2921.              Ctrl-C  Move down a page                (PgDn key)
  2922.  
  2923.           << Delete >>
  2924.  
  2925.              Ctrl-G  Delete character under cursor
  2926.              Ctrl-H  Delete character to the left of the cursor
  2927.                                                      (Backspace)
  2928.              Ctrl-T  Delete the word following the cursor
  2929.              Ctrl-Y  Delete the current line
  2930.              Ctrl-J  Join current line with next line
  2931.  
  2932.           << Miscellaneous commands>>
  2933.  
  2934.              Ctrl-B  Reformat paragraph.  A paragraph ends with the
  2935.                      first line that is blank or that has leading
  2936.                      spaces.
  2937.  
  2938.              Ctrl-K  Visual quote mode.  This allows you to display
  2939.                      the original message and copy lines from it to
  2940.                      the current message.
  2941.  
  2942.              Ctrl-L  Clear screen and redisplay.       (Home key)
  2943.                      This also scrolls the screen so the cursor line
  2944.                      is in the middle of the display.
  2945.  
  2946.              Ctrl-N  Insert a RETURN.  Splits line at the cursor.
  2947.  
  2948.              Ctrl-O  Review the text of the Original message you were
  2949.                      reading or replying to.  If your not replying to
  2950.                      a message this key does nothing.
  2951.  
  2952.              Ctrl-Q  Visual quote mode.  This allows you to display
  2953.                      the original message and copy lines from it to
  2954.                      the current message.
  2955.  
  2956.  
  2957.  
  2958.                                   Page 45
  2959.  
  2960.  
  2961.              Ctrl-V  Toggle insert/overtype mode.      (Ins key)
  2962.  
  2963.              Ctrl-W  Display message header information (date, to,
  2964.                      from, subject, etc).
  2965.  
  2966.                      (Note: This option is not currently available.)
  2967.  
  2968.              ESC     Exit visual mode and return to the Message Entry
  2969.                      Command prompt.
  2970.  
  2971.  
  2972.  
  2973.      6.3.2.1  Insert Mode versus Overtype Mode
  2974.  
  2975.      In insert mode, all characters typed are INSERTED before the
  2976.      cursor. The ENTER key splits the line and BACKSPACE can re-join
  2977.      lines.
  2978.  
  2979.      In overtype mode, characters "type over" what was on the screen
  2980.      before. Overtype mode also disables the automatic line SPLIT /
  2981.      JOIN available in insert mode.  Use ^N(split) and ^J(join) to
  2982.      manually split and join lines while in overtype mode.
  2983.  
  2984.  
  2985.  
  2986.      6.3.2.2  Keyboard emulation
  2987.  
  2988.      The easiest way to control the cursor in Visual Edit mode is to
  2989.      use your cursor keys.  Most popular terminal programs provide
  2990.      some sort of keyboard emulation.  Unfortunately, this emulation
  2991.      is either incomplete or requires you to go through an involved
  2992.      configuration process.
  2993.  
  2994.      The WordStar* command set was chosen as a control-character
  2995.      command set because it can function on virtually any keyboard and
  2996.      with any terminal emulation mode.  It also has the advantage of
  2997.      letting you keep your fingers on the "home" keys while moving the
  2998.      cursor around.
  2999.  
  3000.  
  3001.  
  3002.      6.3.2.3  Visual Quote
  3003.  
  3004.      Echodor now has Visual Quote.  This allows users of the full
  3005.      screen editor to more easily quote from a message.  The use of
  3006.      Visual Quote is intuitive.
  3007.  
  3008.      The first time Ctrl-Q or Ctrl-K is pressed the original message
  3009.      is displayed to the user.  The user then uses the up and down
  3010.      arrow keys or the page up and page down keys to move the cursor
  3011.      to the line to be quoted.  Then the space bar is pressed.  A tag
  3012.      indicator is placed to the left hand side of the line and the
  3013.      cursor is moved to the next line.  The user may tag as many lines
  3014.      as desired.  When all the desired lines are tagged press Ctrl-Q
  3015.      or ESC to return to the message being written.
  3016.  
  3017.      To insert the lines tagged press Ctrl-Q or Ctrl-K again.  A
  3018.      message will appear at the bottom of the screen saying:
  3019.  
  3020.           [I]nert or [T]ag:
  3021.  
  3022.  
  3023.                                   Page 46
  3024.  
  3025.  
  3026.      If "I" is pressed the tagged lines will be inserted into the
  3027.      message above the current cursor line.  If "T" is pressed the
  3028.      user is returned to the original to allow tagging a new set of
  3029.      lines.
  3030.  
  3031.      EchoDor pays particular attention to the reformatting of inserted
  3032.      lines.  Each inserted line is preceded by "xx>" with "xx" being
  3033.      the initials of the person being quoted.  Every line within a
  3034.      paragraph is adjusted to make it correctly fit in the message.
  3035.      Blank lines and paragraph structure will be maintained.
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.  
  3050.  
  3051.  
  3052.  
  3053.  
  3054.  
  3055.  
  3056.  
  3057.  
  3058.  
  3059.  
  3060.  
  3061.  
  3062.  
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.  
  3070.  
  3071.  
  3072.  
  3073.  
  3074.  
  3075.  
  3076.  
  3077.  
  3078.  
  3079.  
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.                                   Page 47
  3089.  
  3090.  
  3091.      6.4  Using EchoDor Locally
  3092.  
  3093.      EchoDor also works very well as a local message reader.  To use
  3094.      it in this manner, start EchoDor with a batch file something like
  3095.      this:
  3096.  
  3097.          rem
  3098.          rem Set the directory and drive first
  3099.          rem
  3100.          C:
  3101.          cd \EchoDor
  3102.          rem
  3103.          rem Now start EchoDor as the sysop -- this is much like
  3104.          rem local mode but it will log you on with the name you
  3105.          rem specified as the sysop.
  3106.          rem
  3107.          ECHODOR /S
  3108.          rem
  3109.          rem Check for mail to be sent, the name of the SCANLOG.TXT
  3110.          rem file would depend on your configuration.
  3111.          rem
  3112.          rem
  3113.          IF NOT EXIST SCANLOG.TXT GOTO EXIT
  3114.          rem
  3115.          rem  Now run the mail packer/scanner (could be CONFMAIL).
  3116.          rem
  3117.          QM SCAN PACK <what ever commands you need>
  3118.          rem
  3119.          rem we're all done
  3120.          rem
  3121.          :EXIT
  3122.  
  3123.  
  3124.  
  3125.  
  3126.  
  3127.  
  3128.  
  3129.  
  3130.  
  3131.  
  3132.  
  3133.  
  3134.  
  3135.  
  3136.  
  3137.  
  3138.  
  3139.  
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.                                   Page 48
  3154.  
  3155.  
  3156.      6.5  Speical local keys
  3157.  
  3158.      While the user is online, EchoDor provides some additional
  3159.      functions to the SYSOP.
  3160.  
  3161.           ALT-I     System Information
  3162.  
  3163.                       This provides the following information:
  3164.  
  3165.                          Baud Rate
  3166.                          Local flag
  3167.                          Graphics Setting
  3168.                          Time Left
  3169.                          Com Port
  3170.                          User Name
  3171.                          Access Level
  3172.                          Time credit
  3173.                          Time left
  3174.                          Node Number
  3175.  
  3176.           ALT-C       Forced Chat
  3177.  
  3178.                       When ALT-C is pressed, the user is placed into
  3179.                       CHAT mode.  EchoDor does not provide a split
  3180.                       screen chat.
  3181.  
  3182.                       To exit chat the SYSOP must press <esc>.
  3183.  
  3184.           ALT-D       Drop to DOS
  3185.  
  3186.                       This allows the SYSOP to drop to DOS for those
  3187.                       Quick checks and fixes.
  3188.  
  3189.           Up Arrow    This will add 2 min to the users time.
  3190.  
  3191.           Down Arrow  This will subtract 2 min from the users time.
  3192.  
  3193.  
  3194.  
  3195.  
  3196.  
  3197.  
  3198.  
  3199.  
  3200.  
  3201.  
  3202.  
  3203.  
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.                                   Page 49
  3219.  
  3220.  
  3221.      7.0  Message Header Description
  3222.  
  3223.      Every message in the system contains control information along
  3224.      with the text that is entered by the user.  The sysop using
  3225.      EchoDor can modify the information in this header using the
  3226.      Doctor command (Z on the main menu then D).  The following fields
  3227.      can be modified:
  3228.  
  3229.        A. From
  3230.           This field contains the name of the person that entered the
  3231.           message.
  3232.  
  3233.        B. To
  3234.           This field contains the name of the person that is to
  3235.           receive the message.
  3236.  
  3237.        C. Subject
  3238.           This field contains the subject of the message.  In the case
  3239.           of a file request or file attach type message (see below)
  3240.           this field contains the file name that is being attached or
  3241.           requested.
  3242.  
  3243.        D. Date/Time
  3244.           This is the date and time when the message was entered.  The
  3245.           format of this field must be:
  3246.  
  3247.                16 Jan 90  13:01:05
  3248.  
  3249.        E. Origin
  3250.           This is the zone:net/node.point number that originated the
  3251.           message.  This field is not used with local messages (Type
  3252.           B).
  3253.  
  3254.        F. Destination
  3255.           The is the zone:net/node.point number where the message is
  3256.           going.  This field is not relevant in echo message (Type E
  3257.           or I) or in local messages (Type B).
  3258.  
  3259.        G. Cost
  3260.           This is amount of money it costs in cents to send the
  3261.           message.  This information is retrieved from the node list.
  3262.           This field is not used for echo messages or local messages.
  3263.  
  3264.        H. Reply
  3265.           When a person enters a reply this is the message number to
  3266.           which he/she is replying.  When the message is an initial
  3267.           entry, this field will be zero.
  3268.  
  3269.        I. Next-Reply
  3270.           When a person enters a reply this field is set in the
  3271.           original message to the message number of the reply.  When
  3272.           the message is an initial entry, this field will be zero.
  3273.  
  3274.           This field has a special use for echo mail.  Message number
  3275.           1 in an echo area is usually used by the mail processor
  3276.           (CONFMAIL or QM) to point to the highest message that has
  3277.           been scanned.  Message number 1 is usually refereed to as
  3278.           the "high water mark".  This field contains the message
  3279.           number of the highest message scanned.
  3280.  
  3281.  
  3282.  
  3283.                                   Page 50
  3284.  
  3285.  
  3286.        J. Private
  3287.           Messages in all areas may be marked private.  If this flag
  3288.           is set to "Yes" then only the sender, the receiver, and the
  3289.           sysop may read the message.  Although not allowed in most
  3290.           echoes, EchoDor does support private echo mail messages if
  3291.           present.
  3292.  
  3293.        K. Crash
  3294.           This flag is used to tell the mail processing program to try
  3295.           to get the message sent as soon as possible.  Some mailers
  3296.           refer to this type of mail as contentious mail.
  3297.  
  3298.        L. Sent
  3299.           This flag is set by the mail processor to indicate that the
  3300.           message has been bundled to be sent.  This flag does not
  3301.           indicate that the message has actually left your system.
  3302.  
  3303.        M. File Attach
  3304.           Some messages are sent with a file.  If this flag is set to
  3305.           "Yes" then the subject field will contain the full path name
  3306.           of the file(s) to be sent with the message.
  3307.  
  3308.        N. Kill-Sent
  3309.           After a message is sent, it is usually left in the area from
  3310.           where it came.  If this flag is set to "Yes" then the
  3311.           message will be delete after it is bundled by the mail
  3312.           packer.
  3313.  
  3314.        O. Local
  3315.           This flag is set to "Yes" if the message was entered on your
  3316.           system.  If the message came from some other system this
  3317.           flag will be set to "No".
  3318.  
  3319.        P. F'req
  3320.           This is a file request flag.  If set to "Yes" then the
  3321.           subject line contains the name of a file that you want sent
  3322.           to you from the destination system.  Files listed in this
  3323.           type of message should not contain path names.
  3324.  
  3325.  
  3326.  
  3327.  
  3328.  
  3329.  
  3330.  
  3331.  
  3332.  
  3333.  
  3334.  
  3335.  
  3336.  
  3337.  
  3338.  
  3339.  
  3340.  
  3341.  
  3342.  
  3343.  
  3344.  
  3345.  
  3346.  
  3347.  
  3348.                                   Page 51
  3349.  
  3350.  
  3351.      8.0  How do file-requests work?
  3352.  
  3353.      When a file request is generated, two files are created and
  3354.      placed in the outbound directory. The first file contains the
  3355.      name of the file(s) that you are requesting from the remote
  3356.      system. The second file specifies how and when the transfer will
  3357.      take place. (i.e. crash-mail, normal, direct, etc.). The stem for
  3358.      each of these files is made up of two four-character hexadecimal
  3359.      numbers specifying the net and node number that the request will
  3360.      be sent to.
  3361.  
  3362.      The first file created is the .REQ file. If this file already
  3363.      exists then it will be appended to. The name of the file being
  3364.      requested is simply placed in the file in plain ASCII.
  3365.  
  3366.      The second file created will have the extension of ".FLO",
  3367.      ".CLO", ".DLO", or ".HLO". This tells the front-end processor how
  3368.      and when the file will be transferred. The various methods are
  3369.      summarized below:
  3370.  
  3371.      Name         Ext  Description
  3372.      -----------  ---
  3373.      ----------------------------------------------------
  3374.      Normal       FLO  Normal transfer. It will occur at the time you
  3375.                        specify in your mailer program.
  3376.  
  3377.      Crash-mail   CLO  The request will be processed at the earliest
  3378.                        possible time.
  3379.  
  3380.      Hold         HLO  Hold-for-pickup. The remote system must poll
  3381.                        your system in order to receive the request.
  3382.  
  3383.      Direct       DLO  This is a direct request.  When this file is
  3384.                        created no routing will be used, the request
  3385.                        will be made directly from the specified BBS.
  3386.  
  3387.      EchoUtil generates file-requests with the "/GET" option. On the
  3388.      command line, you simply need to specify the filename and and the
  3389.      node that you want to request from.
  3390.  
  3391.      Examples:
  3392.  
  3393.           EchoUtil /GET echo308.arc from 300/9
  3394.  
  3395.                This generates a file request to a system for the file
  3396.                "ECHO308.ARC".  It will send this request to node
  3397.                300/9. Since no other method was specified, it will
  3398.                default to normal and generate a ".FLO" file for the
  3399.                request (as well as a .REQ file).  This transfer will
  3400.                take place at national mail hour.
  3401.  
  3402.           EchoUtil /GET echo308.arc from 300/9 C
  3403.  
  3404.                Like the above example, this will request the file
  3405.                "ECHO308.ARC" from 300/9, but it will generate a ".CLO"
  3406.                file instead of a ".FLO" file.  Therefore, this
  3407.                transfer will take place at the soonest available time.
  3408.  
  3409.           EchoUtil /GET ECHODOR from 300/9 H
  3410.  
  3411.  
  3412.  
  3413.                                   Page 52
  3414.  
  3415.  
  3416.                This example demonstrates a "magic" request. Magic
  3417.                requests are special type of request where you specify
  3418.                a magic file name (in this case, "ECHODOR"). The file
  3419.                must be set up as a magic file on the receivers end as
  3420.                well.  The advantage to a magic filename is that the
  3421.                sysop usually has it reference the most recent version
  3422.                of the file you are requesting -- that means you don't
  3423.                have to worry about the exact version number/filename.
  3424.                The "H" on the line specifies that the request will be
  3425.                marked as hold-for-pickup.  The request will not be
  3426.                sent out at all and the remote system must call your
  3427.                system for the request to be processed.  (This is not
  3428.                usually done).
  3429.  
  3430.      EchoDor can also do file requests with net mail.  To enable this
  3431.      feature set the 'F' flag on your net mail description line within
  3432.      the area description table to 'Y'.  Each time you enter a message
  3433.      in the net mail area, EchoDor will ask if you want to do a file
  3434.      attach or file request.  If you answer "R", meaning request,
  3435.      Echodor will prompt you for a file name.  Enter only the file
  3436.      name and extension of the desired file. EchoDor will then precede
  3437.      with the net mail message entry.
  3438.  
  3439.  
  3440.  
  3441.  
  3442.  
  3443.  
  3444.  
  3445.  
  3446.  
  3447.  
  3448.  
  3449.  
  3450.  
  3451.  
  3452.  
  3453.  
  3454.  
  3455.  
  3456.  
  3457.  
  3458.  
  3459.  
  3460.  
  3461.  
  3462.  
  3463.  
  3464.  
  3465.  
  3466.  
  3467.  
  3468.  
  3469.  
  3470.  
  3471.  
  3472.  
  3473.  
  3474.  
  3475.  
  3476.  
  3477.  
  3478.                                   Page 53
  3479.  
  3480.  
  3481.      9.0  File-attaches
  3482.  
  3483.      A file attach is a method of sending a file from your system to
  3484.      any remote system.  It is very similar to the file-request
  3485.      feature in operation, but no .REQ file is generated. Instead, the
  3486.      filename and path is placed in the FLO/CLO/DLO/HLO file.
  3487.  
  3488.      EchoUtil generates file-requests with the "/SEND" command line
  3489.      option. The syntax is very similar to file-attaching with a few
  3490.      differences shown in the examples below.
  3491.  
  3492.      Examples:
  3493.  
  3494.           EchoUtil /SEND c:\files\echo308.arc to 300/9
  3495.  
  3496.                This sends the file echo308.arc to node 300/9. The file
  3497.                will be defaulted to normal (.FLO) and sent at national
  3498.                mail hour.  The file to be sent (Echo305.arc) is
  3499.                located in the c:\files directory.  This an important
  3500.                difference from File-requesting -- With a file-attach,
  3501.                you MUST specify the full path of the file.
  3502.  
  3503.           EchoUtil /SEND c:\files\echo308.arc to 300/9 C
  3504.  
  3505.                This is the same as the above option except the mail
  3506.                will be set to crash-mail (.CLO) and sent at the first
  3507.                available time.
  3508.  
  3509.      EchoDor can also do file attaches with net mail.  To enable this
  3510.      feature set the 'F' flag on your net mail description line within
  3511.      the area description table to 'Y'.  Each time you enter a message
  3512.      in the net mail area, EchoDor will ask if you want to do a file
  3513.      attach or file request.  If you answer "A", meaning attach,
  3514.      EchoDor will prompt you for a file name.  Be sure to enter a
  3515.      fully qualified path name (include the drive and directory).
  3516.      EchoDor will check for the existance of the file and if found
  3517.      will continue with the entry of the message.
  3518.  
  3519.  
  3520.  
  3521.  
  3522.  
  3523.  
  3524.  
  3525.  
  3526.  
  3527.  
  3528.  
  3529.  
  3530.  
  3531.  
  3532.  
  3533.  
  3534.  
  3535.  
  3536.  
  3537.  
  3538.  
  3539.  
  3540.  
  3541.  
  3542.  
  3543.                                   Page 54
  3544.  
  3545.  
  3546.      10.0  Listing file-requests and file-attaches
  3547.  
  3548.      EchoUtil has the capability to produce a summary of all of your
  3549.      file requests or attaches that are presently in your outbound
  3550.      directory.
  3551.  
  3552.      To produce a list of current outbound file-requests:
  3553.  
  3554.           EchoUtil /REQLIST [INTO <filename>|PRINTER]
  3555.  
  3556.                The INTO parameter is optional and if specified will
  3557.                allow you to send the list to either the printer or a
  3558.                disk-file.
  3559.  
  3560.      To produce a list of all outbound file-attaches:
  3561.  
  3562.           EchoUtil /ATTACHLIST [INTO <filename>|PRINTER]
  3563.  
  3564.                The INTO parameter functions the same as above. upon
  3565.                the execution of this command, EchoUtil will list all
  3566.                of the file-attaches excluding normal arcmail packets
  3567.                (.MOx Files).
  3568.  
  3569.  
  3570.  
  3571.  
  3572.  
  3573.  
  3574.  
  3575.  
  3576.  
  3577.  
  3578.  
  3579.  
  3580.  
  3581.  
  3582.  
  3583.  
  3584.  
  3585.  
  3586.  
  3587.  
  3588.  
  3589.  
  3590.  
  3591.  
  3592.  
  3593.  
  3594.  
  3595.  
  3596.  
  3597.  
  3598.  
  3599.  
  3600.  
  3601.  
  3602.  
  3603.  
  3604.  
  3605.  
  3606.  
  3607.  
  3608.                                   Page 55
  3609.  
  3610.  
  3611.      11.0  Auto Messages
  3612.  
  3613.      The "auto message" ability of EchoDor is a very powerful feature
  3614.      that allows you to post news updates about your system in a
  3615.      special area.  When a user calls your system, all of the "auto
  3616.      messages" that he has not read will be displayed to him.  EchoDor
  3617.      will still honor private messages.  If the message is set private
  3618.      then only that user (and any sysop) will see the message.  Since
  3619.      the "auto message" area is treated by EchoDor as a normal mail
  3620.      area, it is very simple to enter "auto messages".
  3621.  
  3622.      To set up an auto message area, simply create a directory like
  3623.      you would for any other mail area.  Then, add an entry to
  3624.      EchoDor's area table for the auto message area.  The entry should
  3625.      be just like a regular message area except set it's type to "A"
  3626.      for auto message.  You should also set it to sysop-only to
  3627.      prevent your users from posting in it.
  3628.  
  3629.      You have two ways to use the "auto message" feature.  The first
  3630.      and simplest way is to do nothing.  When the user enters EchoDor,
  3631.      any auto messages that the user has not seen will be displayed to
  3632.      him/her.
  3633.  
  3634.      The second way requires you to set your BBS to shell out to
  3635.      EchoDor during the users logon process, preferably right after he
  3636.      checks his mail.  With RBBS you specify EchoDor as the "Door
  3637.      Program to check users at logon".  This is in the "doors setup"
  3638.      section.  You need to call EchoDor with either "ECHODOR Node-num
  3639.      /AUTO" or "ECHODOR Node-num /AC" where node-num is the same as
  3640.      the node-number use when you call EchoDor as a door. The "/AUTO"
  3641.      option will simply display all new "auto messages" and the "/AC"
  3642.      option will display all auto messages and then ask the user if he
  3643.      wishes to check for new echo mail messages.  This second method
  3644.      allows you to use EchoDor to display messages to all users
  3645.      regardless of them entering EchoDor to read mail.
  3646.  
  3647.  
  3648.  
  3649.  
  3650.  
  3651.  
  3652.  
  3653.  
  3654.  
  3655.  
  3656.  
  3657.  
  3658.  
  3659.  
  3660.  
  3661.  
  3662.  
  3663.  
  3664.  
  3665.  
  3666.  
  3667.  
  3668.  
  3669.  
  3670.  
  3671.  
  3672.  
  3673.                                   Page 56
  3674.  
  3675.  
  3676.      12.0  General info
  3677.  
  3678.           1.  Commands can be stacked (r;123 for read msg #123,
  3679.           a;2;r;4;q;a;3 switch to area #2, read message 4, quit to
  3680.           main, and switch to area #3).
  3681.  
  3682.           2.  There are 5 command switches:
  3683.  
  3684.           /L load up the door in local mode.
  3685.           /S run the door locally and log in the sysop.
  3686.           /H get help about the switches.
  3687.           /R return to running EchoDor
  3688.  
  3689.           3.  The system will check for loss of carrier and out of
  3690.           time.  If either condition occurs, EchoDor will return back
  3691.           to your BBS.  All user information will be saved before
  3692.           exiting.
  3693.  
  3694.           4.  A user will not be kicked off due to time in the middle
  3695.           of a message.
  3696.  
  3697.           5.  You should only log on for a max of 120 minutes at a
  3698.           time.  You might be able to log on longer, but the elapsed
  3699.           time functions might have some trouble.
  3700.  
  3701.           6.  You MUST have a fossil driver to run this door, I
  3702.           suggest X00, but OpusCom or BNU should work just as well.
  3703.  
  3704.           7.  If you run net mail you must provide a version 6
  3705.           nodelist.  The nodelist must be compiled with zone
  3706.           information.  If you use Parselst be sure to include the
  3707.           "UseZones" command.
  3708.  
  3709.           Starting with v3.09 of EchoDor, registered users can use the
  3710.           new EchoDor format NodeList.  This format is most useful for
  3711.           people that run Front Door or D'Bridge.  This new format
  3712.           uses index files and the "raw" nodelist files.
  3713.  
  3714.           8.  Messages with more than 512 lines will be truncated by
  3715.           EchoDor.
  3716.  
  3717.           9.  Messages larger than 32K will be truncated by EchoDor.
  3718.  
  3719.      10.  Message areas may not contain more than 5000 messages.
  3720.           Areas with more than 5000 messages will lose their last
  3721.           message pointers when renumbered.
  3722.  
  3723.  
  3724.  
  3725.  
  3726.  
  3727.  
  3728.  
  3729.  
  3730.  
  3731.  
  3732.  
  3733.  
  3734.  
  3735.  
  3736.  
  3737.  
  3738.                                   Page 57
  3739.  
  3740.  
  3741.      13.0  EchoUser Program
  3742.  
  3743.      The EchoUser program allows modification of special control
  3744.      information used by EchoDor.  The EchoUser program uses the same
  3745.      DoorDriv.Ctl and EchoDor.Ctl file as EchoDor and may be run
  3746.      remote (through the modem).
  3747.  
  3748.      13.1  User File Records
  3749.  
  3750.      The EchoDor user file contains two different types of records.
  3751.  
  3752.      13.1.1  Default User & Maintenance Record
  3753.  
  3754.      SECTION The first record in the file is called the Default User &
  3755.      Maintenance record.  The record contains information used by
  3756.      EchoDor when setting up new users.  Note that changing fields in
  3757.      the Default User & Maintenance record will not alter currently
  3758.      active users.
  3759.  
  3760.      The following fields are important during new user setup:
  3761.  
  3762.         1.  Graphics Mode
  3763.             Some BBS systems do not pass graphics information to
  3764.             EchoDor that works properly.  This will cause some users
  3765.             to get garbage on their screens.  If the default Graphics
  3766.             mode (Graphics in the Default record) is set to some value
  3767.             other than default, that value will override the value
  3768.             that is passed by the BBS.  You can then instruct the
  3769.             users to set their graphics level from the user menu.
  3770.  
  3771.         2.  Default Hot keys
  3772.             Some sysops like hotkeys some do not.  The value that is
  3773.             set for hotkeys in the Default record will be the value
  3774.             that every new user receives.  This value can be
  3775.             overridden by the user from the user menu.
  3776.  
  3777.         3.  Restrict Message Areas
  3778.             This is one of the most powerful features in the EchoDor /
  3779.             EchoUser system.  EchoDor normally controls access to
  3780.             different areas based on the users security level.  In
  3781.             many cases this method is adequate.  However, some sysops
  3782.             run special areas for their users.  Using the Restrict
  3783.             Message Areas, access to specific areas can be "Blocked".
  3784.             Every new user will then be excluded from the "blocked"
  3785.             areas.  The "Blocked" will be as if they did not exist.
  3786.             There is no indication given to the user that a blocked
  3787.             area is any different from a non existent area.
  3788.  
  3789.         4.  Sysop Flag
  3790.             The sysop flag cannot be altered in the Default User &
  3791.             Maintenance record.  New users will only be set to SYSOP
  3792.             if their name is in the EchoDor.Ctl file.
  3793.  
  3794.         5.  Security Level
  3795.             Some BBS systems do not pass a security level to EchoDor,
  3796.             as an example PC-Board will not pass a security level.  By
  3797.             default EchoDor uses the level 50 for these types of
  3798.             systems.  In most cases this will work fine; however,
  3799.             cases may arise where it would be better to use a
  3800.             different security when users first use EchoDor.  If the
  3801.  
  3802.  
  3803.                                   Page 58
  3804.  
  3805.  
  3806.             security level in the Default record is set, that level
  3807.             will be used in place of the BBS passed level.
  3808.  
  3809.         6.  Delete/Undelete
  3810.             The delete/undelete flag cannot be changed in the Default
  3811.             User & Maintenance record.  This record can never be
  3812.             deleted.
  3813.  
  3814.      The Default User & Maintenance record also contains a Date Last
  3815.      On.  This field is actually the last date when maintenance
  3816.      (EchoUtil /M or EchoUtil /MAINT) was run.
  3817.  
  3818.      13.1.2  User Records
  3819.  
  3820.      All other records in the User file are regular user records.
  3821.      Using EchoUser you can set specific access rights for individual
  3822.      users.
  3823.  
  3824.         1.  Graphics Mode
  3825.             Normally you will not want to alter the value in this
  3826.             field for specific users.  Users can set this from the
  3827.             User Menu within EchoDor.  Altering this field will
  3828.             override the graphics information passed in the Door
  3829.             Information file.
  3830.  
  3831.         2.  Default Hot keys
  3832.             Again, this is a user controlled field and you will not
  3833.             normally want to alter this for individual users.
  3834.  
  3835.         3.  Restrict Message Areas
  3836.             Like using this in the Default User & Maintenance record,
  3837.             you can "Block" or "Avail" (available) areas to specific
  3838.             users.  If an area is "Block", that user will not have any
  3839.             idea that the area exists.
  3840.  
  3841.         4.  Sysop Flag
  3842.             Sysops can be indicated by having their name in the
  3843.             EchoDor.Ctl file.  Adding and deleting sysops in this way
  3844.             can become bothersome.  The SYSOP flag in a user record
  3845.             can be set to have EchoDor treat this user like a sysop.
  3846.  
  3847.         5.  Security Level
  3848.             If the Security level for an individual user is set, that
  3849.             security level will be used in place of the security level
  3850.             passed by the BBS.
  3851.  
  3852.             Another user for this, involves SYSOPS.  When a sysop logs
  3853.             on locally into EchoDor using the /S option, EchoDor
  3854.             defines a default security level of 1024 for that user.
  3855.             This security level may not be high enough for some
  3856.             setups.  To override this 1024 value, enter a security
  3857.             level for the sysop that is adequate.
  3858.  
  3859.         6.  Delete/Undelete
  3860.             The Delete/Undelete section is actually two specific
  3861.             functions.  User records in the EchoDor user file can be
  3862.             marked as deleted.  When a user is marked as deleted, that
  3863.             user record will NEVER be deleted by EchoUtil.  Anytime
  3864.             that user attempts to use EchoDor, he will be denied
  3865.             access to the door.
  3866.  
  3867.  
  3868.                                   Page 59
  3869.  
  3870.  
  3871.             The Undelete question will be asked if the user is
  3872.             deleted.  If the Undelete questions is answered Y, that
  3873.             user will be returned to a normal user.
  3874.  
  3875.             The NoDelete function is different from the UnDelete
  3876.             question.  If a user is marked NoDelete, that user will
  3877.             NEVER be deleted by EchoUtil, and will always have access
  3878.             to the Door.
  3879.  
  3880.      The last selection on the Menu is the User Record Selection
  3881.      section.  Before you can change information in a user record or
  3882.      in the Default User & Maintenance record, the record to be
  3883.      changed must be selected.
  3884.  
  3885.      When selecting the record, you first enter a name (or partial
  3886.      name) of the user that you want to change.  For the Default User
  3887.      & Maintenance record, enter DEFAULT.  EchoUser will then present
  3888.      you with a list of users that match.  The names will be preceded
  3889.      by a user number.  EchoUser will then ask for the user number to
  3890.      change.  Enter the desired number of the user.  Then make the
  3891.      needed changes.
  3892.  
  3893.      There is no need to save the changes as this is performed by
  3894.      EchoUser when you either change users or exit the program.
  3895.  
  3896.      13.2  Remote Operation
  3897.  
  3898.      EchoUser can be run through the modem.  The command line to run
  3899.      EchoUser is:
  3900.  
  3901.           EchoUser %1
  3902.                     ^
  3903.                     |
  3904.                     +  This is replaced with the node number.
  3905.  
  3906.      This is exactly the same way used for EchoDor.
  3907.  
  3908.      13.3  Local Operation
  3909.  
  3910.      To run EchoUser locally use the command line:
  3911.  
  3912.           EchoUser /S
  3913.  
  3914.      Which will start EchoUser with the SYSOP as fast logon.
  3915.  
  3916.  
  3917.  
  3918.  
  3919.  
  3920.  
  3921.  
  3922.  
  3923.  
  3924.  
  3925.  
  3926.  
  3927.  
  3928.  
  3929.  
  3930.  
  3931.  
  3932.  
  3933.                                   Page 60
  3934.  
  3935.  
  3936.      14.0  Using SCANMRG
  3937.  
  3938.      The SCANMRG program is used to combine scan logs generated by
  3939.      EchoDor.  A scan log is a list of area names which contain new
  3940.      messages.  Normally, EchoDor generates a scan log file.  That
  3941.      file is then processed by a mail scanner program and outgoing
  3942.      packets are generated.
  3943.  
  3944.      However, some people only want to run the scanner program once a
  3945.      day.  Other people run multiple nodes and only run the scanner
  3946.      from a single node.  People that run their boards in this manor
  3947.      need a way to combine scan logs.  That is exactly what scanmrg
  3948.      does.
  3949.  
  3950.      The first question you may ask is why not just use copy and
  3951.      append each log to the end of a common file.  Ideally if every
  3952.      area was only used once this would work.  But, through out the
  3953.      day people will enter multiple messages in the same area.  In
  3954.      these cases you want to have that area only listed once.
  3955.  
  3956.      That is the way SCANMRG works.  First SCANMRG reads the output
  3957.      scan log into memory.  Then it reads each line of the input scan
  3958.      log and compares the just read area name with all the other area
  3959.      names.  If the name is new SCANMRG adds it to the list.  If it is
  3960.      already in the list, SCANMRG discards the entry.  When the last
  3961.      entry from the input file is read, all the entries are written to
  3962.      the output file.
  3963.  
  3964.      The format to use SCANMRG is:
  3965.  
  3966.           SCANMRG infile outfile
  3967.  
  3968.           Where "infile" is the just created input file.
  3969.  
  3970.           And "outfile" is the combined scan logs.  If SCANMRG is run
  3971.           and the "outfile" does not exist, one is created.
  3972.  
  3973.  
  3974.  
  3975.  
  3976.  
  3977.  
  3978.  
  3979.  
  3980.  
  3981.  
  3982.  
  3983.  
  3984.  
  3985.  
  3986.  
  3987.  
  3988.  
  3989.  
  3990.  
  3991.  
  3992.  
  3993.  
  3994.  
  3995.  
  3996.  
  3997.  
  3998.                                   Page 61
  3999.  
  4000.  
  4001.      15.0  The EchoDor Nodelist compiler
  4002.  
  4003.      Starting with version 3.09, EchoDor now allows the use of two
  4004.      different types of node lists.  The first type of node list is
  4005.      known as a version 6 node list.  This node list is most often
  4006.      used with BinkleyTerm mailers.  The second type of node list is
  4007.      exclusive to EchoDor.  This node list uses the St. Louis node
  4008.      list and three index files to allow rapid access to entries in
  4009.      the node list.
  4010.  
  4011.      This new node list is ideal for people who use Front Door or
  4012.      D'bridge which have proprietary node list structures.  During a
  4013.      test the index files for a full FidoNet node list took only 180k
  4014.      plus the size of the "raw" St. Louis node list.  This is much
  4015.      smaller than the 1 to 2 megabyte files created when a version 6
  4016.      node list is used.
  4017.  
  4018.      The node list compiler can not apply node diff files.  You must
  4019.      use a separate program to apply the diff's.
  4020.  
  4021.      The node list compiler EchoNLCP is only availble to registered
  4022.      users of EchoDor and is not included in the shareware
  4023.      distribution kit.
  4024.  
  4025.      15.1  How it works
  4026.  
  4027.      The idea is based on doing a single line compile of the "raw"
  4028.      node list when that line is needed.  The only real problem with
  4029.      this is finding the correct line to compile.  The correct line is
  4030.      located by EchoDor through the use of three files.
  4031.  
  4032.           The first file is the EchoDIdx.Idx file.  The structure of
  4033.           this file is exactly the same as the NodeList.Idx file used
  4034.           in a version 6 node list.  This file contains all the
  4035.           net/node numbers that are in all the node lists with special
  4036.           coding for zones and regions.  The position of the desired
  4037.           net/node number within this file allows EchoDor to locate
  4038.           the positional information in the next file.
  4039.  
  4040.           The positional information is used to read a specific record
  4041.           from the second index file.  This is the EchoDXId.Idx file.
  4042.           This file contains the full zone, net, and node number as
  4043.           well as the node's hub.  Also, two other very important
  4044.           pieces of information is contained in the file.  They are
  4045.           the file number and the line position.
  4046.  
  4047.           The file number is used to locate the name of the "raw" node
  4048.           list file within the third file called EchoDNLx.Idx.  This
  4049.           file is only used when the node list file must be switched.
  4050.           The line position is then used to read a single line of
  4051.           information from the "raw" node list file.
  4052.  
  4053.           The single line of information from the "raw" node list is
  4054.           them compiled by EchoDor "on the fly".
  4055.  
  4056.      Even though the above procedure sounds very slow,  EchoDor is
  4057.      able to perform the operations quiet rapidly.  You will notice
  4058.      very little difference between the speed of a version 6 node list
  4059.      and the new EchoDor node list indexing system.  What you will
  4060.      notice is a lot of disk space available that wasn't there before.
  4061.  
  4062.  
  4063.                                   Page 62
  4064.  
  4065.  
  4066.      15.2  The Control file
  4067.  
  4068.      The control file directs EchoNLCP to the node lists that are to
  4069.      be compiled and the directory that is to contain the index files.
  4070.      The following commands are valid in the EchoNLCP.CTL file:
  4071.  
  4072.           DIRECTORY <directory name>
  4073.  
  4074.                This is the diectory where the three index files
  4075.                (ECHODIDX.IDX, ECHODXID.IDX, and ECHODNLX.IDX) are to
  4076.                be placed.  This file does not have to be in the
  4077.                EchoDor directory nor does it have to be in the same
  4078.                directory as the St. Louis ("raw") node lists.
  4079.  
  4080.                The <directory name> must match the NODELISTPATH
  4081.                parameter in the EchoDor.Ctl file.
  4082.  
  4083.                There can be only one DIRECTORY parameter.
  4084.  
  4085.           NODELIST <drive:\path\nodelist.fil>
  4086.  
  4087.                This parameter tells EchoNLCP where to find the node
  4088.                list to be compiled.  The drive and path are optional;
  4089.                however, you should not use "relative" directories
  4090.                (such as . (dot) and .. (dot, dot)).
  4091.  
  4092.                If the nodelist.file is specified using a wild card,
  4093.                such as NODELIST.*, EchoNLCP will check all occurances
  4094.                and compile the most recent one.  Be careful that it
  4095.                dosen't pick up a file that is not a node list file.
  4096.                EchoNLCP will never attempt to compile a file that has
  4097.                an extension of DAT, FDX or IDX.
  4098.  
  4099.                You can specify as many NODELIST lines as needed to
  4100.                compile all the node lists you use.  The node list
  4101.                files do not all have to be in the same directory.
  4102.  
  4103.      15.3  Running EchoNLCP
  4104.  
  4105.      EchoNLCP must be run anytime a change is made to any of the node
  4106.      list files specified in the control file.
  4107.  
  4108.      EchoNLCP cannot apply node diff files.
  4109.  
  4110.      The command line to run EchoNLCP is:
  4111.  
  4112.           ECHONLCP
  4113.  
  4114.           or
  4115.  
  4116.           ECHONLCP cntlfile.ctl
  4117.  
  4118.      The "cntlfile.ctl" file specification is optional.  If not
  4119.      specified EchoNLCP will look in the current directory for a file
  4120.      named ECHONLCP.CTL.
  4121.  
  4122.      Operation of the compiler is very fast.
  4123.  
  4124.      15.4  EchoNLRD node list reader
  4125.  
  4126.  
  4127.  
  4128.                                   Page 63
  4129.  
  4130.  
  4131.      I have include a little utility which will allow you to read node
  4132.      list inforation from the node list indexes generated by EchoNLCP.
  4133.      This is a good check to see if all is ok as well as a "quicky"
  4134.      node list look up utility.
  4135.  
  4136.      To run EchoNLRD, go to the directory where the EchoNLCP.CTL file
  4137.      is located and type ECHONLRD.
  4138.  
  4139.      If you are not in the directory where then EchoNLCP.CTL file is
  4140.      located type ECHONLRD drive:\path\EchoNLCP.CTL.  This will start
  4141.      the reader and tell it the file to use as a control file.
  4142.  
  4143.  
  4144.  
  4145.  
  4146.  
  4147.  
  4148.  
  4149.  
  4150.  
  4151.  
  4152.  
  4153.  
  4154.  
  4155.  
  4156.  
  4157.  
  4158.  
  4159.  
  4160.  
  4161.  
  4162.  
  4163.  
  4164.  
  4165.  
  4166.  
  4167.  
  4168.  
  4169.  
  4170.  
  4171.  
  4172.  
  4173.  
  4174.  
  4175.  
  4176.  
  4177.  
  4178.  
  4179.  
  4180.  
  4181.  
  4182.  
  4183.  
  4184.  
  4185.  
  4186.  
  4187.  
  4188.  
  4189.  
  4190.  
  4191.  
  4192.  
  4193.                                   Page 64
  4194.  
  4195.  
  4196.      16.0  Opus 1.1x Converter (OPUSCNVT)
  4197.  
  4198.      This program is used to convert information in Opus SYSTEM##.DAT
  4199.      files to a format usable by EchoDor.  This utility takes two
  4200.      command line parameters.  The first is the directory where
  4201.      OPUSCNVT can find the SYSTEM##.DAT files.  The second parameter
  4202.      is the file that should be created by OPUSCNVT.  For Example:
  4203.  
  4204.           OPUSCNVT C:\OPUS C:\EchoDor\Areatab.Txt
  4205.  
  4206.      In the above example, OPUSCNVT will search the directory
  4207.      "C:\OPUS" for all SYSTEM##.DAT files.  After all the information
  4208.      is collected from the files, OPUSCNVT will write a file called
  4209.      Areatab.Txt in the directory C:\EchoDor.  This file will only
  4210.      contain AREATABLE & AREADESC entries.
  4211.  
  4212.      The following rules/exceptions are followed by OPUSCNVT:
  4213.  
  4214.         1.  If a SYSTEM00.DAT file exists it will be skipped.
  4215.  
  4216.         2.  All local areas will have a listed tag and an echo name of
  4217.             "Local".
  4218.  
  4219.         3.  All Net Mail aeras will have a listed tag and an echo name
  4220.             of "NetMail".
  4221.  
  4222.         4.  The "No Public" flag is ignored.
  4223.  
  4224.         5.  If there is no separate write priv in the Opus area, Read
  4225.             Priv will be used for WRACC.
  4226.  
  4227.         6.  File request will always be set "N".
  4228.  
  4229.      After running OPUSCNVT you will edit your EchoDor.Ctl file.  You
  4230.      would insert a line something like:
  4231.  
  4232.           INCLUDE C:\EchoDor\AreaTab.Txt
  4233.  
  4234.      This would eliminate the need for you to transfer the information
  4235.      from the created file to the EchoDor.Ctl file.
  4236.  
  4237.  
  4238.  
  4239.  
  4240.  
  4241.  
  4242.  
  4243.  
  4244.  
  4245.  
  4246.  
  4247.  
  4248.  
  4249.  
  4250.  
  4251.  
  4252.  
  4253.  
  4254.  
  4255.  
  4256.  
  4257.  
  4258.                                   Page 65
  4259.  
  4260.  
  4261.      17.0  Support for EchoDor
  4262.  
  4263.      For support and resistration you can reach me at:
  4264.  
  4265.           Robert McCullough
  4266.           P.O. Box 101095
  4267.           Nashville, TN  37224
  4268.           Voice Number 615 333-0557
  4269.  
  4270.      BBS Support is available from:
  4271.  
  4272.           The WorkBench BBS
  4273.           FidoNet Node 1:116/1000.0
  4274.           RBBSNet Node 8:967/107.0
  4275.           Nashville, TN  37210
  4276.  
  4277.           The BBS Number is 615 333-1458
  4278.           Available 23 hours a day.
  4279.           9600 Hst
  4280.  
  4281.           Note: We may be moving soon.  We will still be in Nashville.
  4282.           Check the node list for the correct number to use.
  4283.  
  4284.      For registration and support in Europe you can call:
  4285.  
  4286.           Chris Pelling
  4287.           84 Heathcote Dr
  4288.           East Grinstead
  4289.           West Sussex
  4290.           RH19 1ND
  4291.           ENGLAND
  4292.  
  4293.      BBS support in Europe is available from:
  4294.  
  4295.           SDS Data Design's IBM BBS
  4296.           FidoNet Node 2:254/41.0
  4297.           Available 8pm-8am GMT
  4298.           9600 Hst/DS/V42bis
  4299.           011 +44 342 317 976
  4300.  
  4301.      Information about EchoDor is also available in the National
  4302.      conference ECHODOR.  I understand that the conference is
  4303.      available on the FidoNet backbone and the RBBSNet area.  Please
  4304.      check with your net's National Echo Mail Coordinator about the
  4305.      availability of this echo.
  4306.  
  4307.  
  4308.  
  4309.  
  4310.  
  4311.  
  4312.  
  4313.  
  4314.  
  4315.  
  4316.  
  4317.  
  4318.  
  4319.  
  4320.  
  4321.  
  4322.  
  4323.                                   Page 66
  4324.  
  4325.  
  4326.      18.0  Revision History
  4327.  
  4328.      3.09 revisions:
  4329.  
  4330.         1.  EchoDor now has a "DIRECTVIDEO" option in the DoorDriv.Ctl
  4331.             file.  This will allow the sysop to configure EchoDor to
  4332.             either use BIOS writes (comment out the DirectVideo line)
  4333.             or direct screen writes (include the DirectVideo line).
  4334.  
  4335.         2.  A new parameter is now available in the EchoDor.Ctl file,
  4336.             this is the "INCLUDE" parameter.  This will be most used
  4337.             by sysops that run multiple line systems and want to only
  4338.             maintain one file that contains the AREATABLE and the
  4339.             AREADESC sections.
  4340.  
  4341.         3.  EchoDor will now allow the SYSOP to configure HotKeys.
  4342.  
  4343.         4.  There was a problem in the origin net/node number when
  4344.             generating Echo mail.  This problem would cause UUCP not
  4345.             to function correctly with messages generated by EchoDor.
  4346.             This has been corrected and UUCP should work with EchoDor
  4347.             now.
  4348.  
  4349.         5.  I have included a little utility which will be useful for
  4350.             Opus Sysops that want to use EchoDor.  This is the
  4351.             OpusCnvt program.  It will read SYSTEM##.DAT files and
  4352.             create a file that contains AREATABLE/ENDAREATABLE &
  4353.             AREADESC/ENDAREADESC sections.  If this is used with the
  4354.             INCLUDE option, conversion to EchoDor will be very fast.
  4355.  
  4356.         6.  Four new functions area available when selecting an area.
  4357.             These are the [+]Next Area, [-]Prior area and the [>]Next
  4358.             Area with messages, [<]Prior Area with messages functions.
  4359.             If the user selects "+", EchoDor will move that user to
  4360.             the next area that he/she has set to active.  When
  4361.             selecting "-", the user will be moved to the prior area.
  4362.             If the user selects ">", EchoDor will move to the next
  4363.             area that the user has set active which contains unread
  4364.             messages.  When selecting "<", EchoDor will move to the
  4365.             prior area that the user has set active which contains
  4366.             unread messages.  Also, when changing areas with the plus
  4367.             and minus, EchoDor will tell you if there are new messages
  4368.             in the area.
  4369.  
  4370.         7.  EchoDor now has "Hot Keys".  When enabled the menu
  4371.             response is very fast.  In places where the user might
  4372.             need to type in multiple characters, the "hot key" feature
  4373.             is disabled.  I think you'll like this feature.
  4374.  
  4375.         8.  I have rewritten the Xerox function.  The old function
  4376.             would only copy the current message to the current area.
  4377.             The new Xerox function will now allow the sysop to Xerox
  4378.             the current message to any area.
  4379.  
  4380.         9.  I have rewritten the sysop MESSAGE COPY function.  The old
  4381.             function would copy a message from any area to the current
  4382.             area.  This would confuse some people.  The new MESSAGE
  4383.             COPY function will now allow you to copy a message from
  4384.             any area to any area.  The default is now from the current
  4385.             area to another area which is the opposite of the old way.
  4386.  
  4387.  
  4388.                                   Page 67
  4389.  
  4390.  
  4391.        10.  There was a problem which would cause EchoDor to tell the
  4392.             user "You Don't have enough time left" when he actually
  4393.             did.  This problem was due to an error in the MINTIME
  4394.             function.  This has hopefully been corrected.
  4395.  
  4396.        11.  EchoDor will now tell you when you have exited chat mode.
  4397.             Prior to 3.09 you had to guess if you were still in chat
  4398.             after you pressed the ESC key.
  4399.  
  4400.        12.  In versions prior to 3.09 the "AutoMessage" function was
  4401.             only available if you started EchoDor %1 /AUTO.  Starting
  4402.             with this version, EchoDor will always execute the
  4403.             "AutoMessage" function when it starts in normal mode.
  4404.             This will allow a sysop to use the "AutoMessage" function
  4405.             without having to run EchoDor twice.
  4406.  
  4407.        13.  EchoDor now has a [V]iew function available from the read
  4408.             menu.  This function is not listed on the read menu but is
  4409.             available to all SYSOPs.  The function allows a sysop to
  4410.             see all the ^A kludge lines, the SEEN-BYs, and the PATH
  4411.             lines.  This is sometimes useful when trying to track
  4412.             where a message has come from.
  4413.  
  4414.        14.  I have added a new option to the File function when
  4415.             importing files.  This function is [F]old lines.  This
  4416.             option will retain the line structure, but it will break
  4417.             the lines on word boundaries.  This produces a much better
  4418.             appearance than just importing the file.
  4419.  
  4420.        15.  When quoting with the full screen editor, EchoDor now
  4421.             removes all ^A, SEEN-BY, and PATH lines from the message.
  4422.             Old versions prevented the user from quoting the message
  4423.             but the new version removes the lines.  This gives the
  4424.             quote a "cleaner" appearance.
  4425.  
  4426.        16.  EchoDor now sets the "received" bit when a message is
  4427.             either read or packed by the receiver.  This is also
  4428.             displayed when reading the message and scanning the
  4429.             message.  EchoDor also increments the number of "times
  4430.             read" counter in the message.  This counter can be used to
  4431.             tell if an area is active.
  4432.  
  4433.        17.  When a user first entered a message base and the first
  4434.             message was not 1 or 2, EchoDor would take a long time to
  4435.             read the first message.  EchoDor now keeps both a high
  4436.             message pointer and a low message pointer to an area.
  4437.             This allows EchoDor to go immediately to the first message
  4438.             in an area.  Also, the first message number as displayed
  4439.             in the read menu correctly reflects the first real message
  4440.             number.
  4441.  
  4442.        18.  The "Pack All Message Areas" question default has been
  4443.             changed from "Y" to "N".
  4444.  
  4445.        19.  When packing a single area, the starting message number
  4446.             now defaults to the last message read plus 1.
  4447.  
  4448.        20.  A problem was found which could cause Echodor to lock up
  4449.             when packing mail and the user dropped carrier.  This
  4450.  
  4451.  
  4452.  
  4453.                                   Page 68
  4454.  
  4455.  
  4456.             problem has been corrected.  Now when packing mail, if the
  4457.             user drops carrier, EchoDor will exit normally.
  4458.  
  4459.        21.  EchoDor no longer contains the NODOORMODE parameter.  When
  4460.             this parameter was not present, EchoDor displayed it's
  4461.             name and a closing string when exiting.  The extra code
  4462.             has been removed along with the parameter.
  4463.  
  4464.        22.  EchoUtil had problems with most of the functions that used
  4465.             the "outbound" area.  Hopefully most of these problems
  4466.             have been corrected.
  4467.  
  4468.        23.  EchoUtil no longer contains the /SCAN and /DUMP functions.
  4469.             They have been removed because of their size and because
  4470.             these functions are provided in EchoDor.
  4471.  
  4472.        24.  EchoUtil can now process message areas that contain 5000
  4473.             messages.  This is 3000 more than prior versions.
  4474.  
  4475.        25.  If EchoUtil /M was run multiple time, it would increment
  4476.             the check messages flag (asking the user to check for
  4477.             private messages) each time it was run.  This has been
  4478.             corrected.  The counter will only be incremented once per
  4479.             run per day.
  4480.  
  4481.        26.  EchoUtil now has the /RENUM function.  This will allow
  4482.             resetting the last read pointers without deleting old
  4483.             users.
  4484.  
  4485.        27.  A problem was found in the EchoNLCP compiler.  It would
  4486.             not write the last block to the EchoDXID.IDX file.  This
  4487.             would cause EchoDor not to be able to find the last 1000
  4488.             nodes in the nodelist file.  This problem has been
  4489.             corrected.
  4490.  
  4491.        28.  EchoNLCP will now skip files that have an extension of
  4492.             DAT, IDX or FDX.  Node list files must never have this
  4493.             extension.
  4494.  
  4495.        29.  EchoNLRD has been enhanced to allow node list searching.
  4496.             This is identical to the operation of the node list option
  4497.             in EchoDor.
  4498.  
  4499.        30.  A new program called EchoUser is now available.  This
  4500.             allows you to set individual usre's security and access
  4501.             levels as well as more precisely control new user access.
  4502.             This program will run either remote or local.
  4503.  
  4504.      3.08 revisions:
  4505.  
  4506.         1.  EchoDor now has new commands in the read menu to allow the
  4507.             user to read a thread.  These new commands are plus (+),
  4508.             minus (-), and asterisk (*).
  4509.  
  4510.         2.  Users can now enter messages from the Read menu by
  4511.             pressing the letter "E" for enter.  Because this was the
  4512.             old EDIT command, the new command to replace edit is
  4513.             CHANGE which uses the "C" key.
  4514.  
  4515.  
  4516.  
  4517.  
  4518.                                   Page 69
  4519.  
  4520.  
  4521.         3.  The "Doctor" command now understands all the "bits" in a
  4522.             message.  This has required some changes in the layout but
  4523.             it should present no problems.
  4524.  
  4525.         4.  EchoDor.Ctl file has been slightly altered.  This
  4526.             alteration allows EchoDor to load the file more quickly.
  4527.             See UPDATE.DOC on how to change your file to the new
  4528.             format.
  4529.  
  4530.         5.  Some commands have also been eliminated from the
  4531.             EchoDor.Ctl file.  These commands were duplicates of
  4532.             commands already in the DoorDriv.Ctl file.  These commands
  4533.             DO effect the display color.  Be sure to read UPDATE.DOC
  4534.             on setting new colors.
  4535.  
  4536.         6.  New NodeList format.  Starting with 3.08 of EchoDor, a
  4537.             special format Nodelist can be used in place of the
  4538.             version 6 nodelist required by prior versions.  This new
  4539.             nodelist uses a set of index files to allow use of the RAW
  4540.             nodelist file.  This will reduce the amount of disk space
  4541.             required to support EchoDor.  (A full nodelist required
  4542.             about 180k plus the raw nodelist file). People running
  4543.             FrontDoor and D'Bridge will gain the most from this
  4544.             feature.  Note:  Although the unregistered version of
  4545.             EchoDor supports this new nodelist format the compiler
  4546.             which is required to generate these files is included ONLY
  4547.             IN THE REGISTERED VERSION.
  4548.  
  4549.         7.  There are some slight changes in the user interface which
  4550.             should make EchoDor easer to use.
  4551.  
  4552.         8.  The [P]ack Mail feature now allows the user to select the
  4553.             type of compression to use to compress the mail files.
  4554.  
  4555.         9.  There were also problems when returning to EchoDor from
  4556.             [P]acking mail.  These problems have been corrected.
  4557.  
  4558.        10.  EchoDor now inserts the new ^AMSGTO: line into outbound
  4559.             messages.
  4560.  
  4561.        11.  The number of lines allowed in a message has been
  4562.             increased from 200 to 512.
  4563.  
  4564.        12.  When displaying a node list entry from the sysop menu,
  4565.             EchoDor now displays the baud rate of the BBS.
  4566.  
  4567.        13.  EchoDor had a problem displaying node list information
  4568.             which contained a password that was 8 characters long.
  4569.             This has been corrected.
  4570.  
  4571.        14.  Long messages would sometime cause EchoDor a run time
  4572.             error.  This has been corrected.  Now EchoDor will
  4573.             truncate the message to a maximum of 512 lines.
  4574.  
  4575.        15.  EchoDor would always attempt to verify a user when
  4576.             entering into the local message base even if the message
  4577.             wasn't private.  This has been corrected so that EchoDor
  4578.             will only verify private messages.
  4579.  
  4580.  
  4581.  
  4582.  
  4583.                                   Page 70
  4584.  
  4585.  
  4586.        16.  EchoDor can now import files when entering messages.  This
  4587.             feature is only available when running in local mode.
  4588.  
  4589.        17.  The "read lock" from value could not be set.  This has
  4590.             been corrected.
  4591.  
  4592.        18.  The arrow keys on remote systems should now work
  4593.             correctly.  Prior to version 3.08, EchoDor would have
  4594.             problems with the special character keys (arrow and such)
  4595.             from slow modems.  This has hopefully been corrected.
  4596.  
  4597.        19.  When copying a message EchoDor would not insert the
  4598.             "message copied from" information.  This has been
  4599.             corrected.
  4600.  
  4601.        20.  EchoDor had a problem when users returned from a download
  4602.             (using the EchoDor %1 /R line).  Sometimes it would reset
  4603.             the time back to when they first entered the door, other
  4604.             times it would just forget who was online.  This has
  4605.             hopefully been corrected.  I have been doing a lot of
  4606.             testing in this area and have not seen the problem with
  4607.             this version.
  4608.  
  4609.      3.07 revisions:
  4610.  
  4611.         1.  There were sometimes problems with EchoDor not generating
  4612.             the INTL line when sending messages in a multi zone
  4613.             environment.  This was because the decision to insert an
  4614.             INTL line depended on the origin zone compared to the
  4615.             destination zone in the message.  These could produce an
  4616.             equal condition even if the current zone was different.
  4617.             EchoDor now compares the destination zone with the current
  4618.             area's zone and decides if an INTL line is needed.
  4619.  
  4620.         2.  If a user were viewing a message and responded to the
  4621.             "[C]ontinue, [S]top, [N]on Stop" message with 'N', the
  4622.             rest of the area would be displayed non stop.  This was
  4623.             not the desired action.  EchoDor will now display the rest
  4624.             of the current message non stop then stop at the end of
  4625.             the message if the user is reading the messages one at a
  4626.             time.  If the user has done an [A]ll and presses [N]on
  4627.             stop, the rest of the area will continue to be displayed.
  4628.  
  4629.         3.  I have made some speed improvements in the [N]ew Messages
  4630.             section.  Once an area is checked by EchoDor, the highest
  4631.             message number will be remembered.  This will improve
  4632.             performance greatly when checking for new messages a
  4633.             second time because the high message numbers will already
  4634.             be known.  The [N]ew Messaegs section will also pause at
  4635.             the end of the screen and allow a "[C]ontinue, [S]top,
  4636.             [N]on Stop" message.  The list will also stop if any key
  4637.             is pressed.
  4638.  
  4639.         4.  I have also improved (at least slightly) the time it takes
  4640.             EchoDor to load in a message.  This is through rewriting
  4641.             the word wrap function.
  4642.  
  4643.         5.  The [S]can Message section will now pause with a
  4644.             "[C]ontinue, [S]top, [N]on Stop" message.  It will also
  4645.             pause if any key is pressed.
  4646.  
  4647.  
  4648.                                   Page 71
  4649.  
  4650.  
  4651.         6.  There was a problem with the "Copy Message" sysop
  4652.             function.  If a message was copied into an Echo area, that
  4653.             area would not be scanned if you used the "ScanLog"
  4654.             feature of EchoDor because a new message entry was not
  4655.             recorded.  This problem has been corrected.
  4656.  
  4657.         7.  There was a minor problem  with visual quote which would
  4658.             sometimes cause the end of one line to be butted aganist
  4659.             the beginning of the following line.  This would occur
  4660.             when the line being appended to did not end in a space.
  4661.             Visual Quote now checks for this and adds a space as
  4662.             needed.
  4663.  
  4664.         8.  ECHOUtil had problems with the /SEND, /GET, /RASMAM
  4665.             functions.  Hopefully these problems have been fixed.
  4666.  
  4667.         9.  A problem existed with PC Board 14 support.  When using PC
  4668.             Board 14, the "BBSPATH" parameter was not honored.  This
  4669.             has been corrected.
  4670.  
  4671.        10.  A problem existed that if the "ENDAREATABLE" and/or the
  4672.             "ENDDESCTABLE" line was missing or spelled incorrectly,
  4673.             echodor would hang.  The program has been altered to cause
  4674.             it to exit with an error should either of these be
  4675.             missing.
  4676.  
  4677.        11.  If the word "AREATABLE" or "DESCTABLE" were not
  4678.             capitalized, EchoDor would not recognize the entry.  This
  4679.             has been corrected.
  4680.  
  4681.        12.  The DoorDriver support program will now work with Opus
  4682.             1.1x type boards.
  4683.  
  4684.        13.  There was a problem which would sometimes cause EchoDor to
  4685.             not let a user reply to a message.  EchoDor would issue
  4686.             the message "No Message to Reply to.".  This would NEVER
  4687.             happen to SYSOPs.  This problem has been corrected.
  4688.  
  4689.        14.  The DoorDriver support program will now support locked
  4690.             baud rates up to 38400 .. if that rate is supported by the
  4691.             Fossil being used.
  4692.  
  4693.        15.  When entering a private message into a local message base,
  4694.             EchoDor now checks the "to name" against the user list.
  4695.             If the name is not found the user is given a chance to
  4696.             change the name, abort the entry, or use the name anyway.
  4697.             This check is only performed during initial entry and not
  4698.             during reply.
  4699.  
  4700.        16.  When scanning & packing mail, if a message is entered to
  4701.             "SYSOP" and the sysop is logged on, the message will be
  4702.             displayed/packed.
  4703.  
  4704.        17.  Node List selection when entering net mail has been
  4705.             altered slightly.  I have improved the way information is
  4706.             displayed to provide a more pleasing effect.  I also allow
  4707.             the user to stop the Node List display by pressing a key.
  4708.             Finally, if the Nodes within a net are displayed, the user
  4709.             is now asked to select a node.  If a valid node is
  4710.             selected, entry of the message will proceed.
  4711.  
  4712.  
  4713.                                   Page 72
  4714.  
  4715.  
  4716.        18.  It was possible to direct a net mail message to a net/node
  4717.             number that was not listed in the node list.  EchoDor now
  4718.             checks to insure net mail is not allowed to be sent to a
  4719.             node not in the list.
  4720.  
  4721.        19.  I have also added a Node List search (much like the entry
  4722.             procedure for net mail) from the SYSOP menu.  Have you
  4723.             found the SYSOP menu yet -- try "Z" from the main menu.
  4724.  
  4725.        20.  A problem existed when exiting EchoDor for mail packing
  4726.             and download.  When EchoDor reloaded it would forget the
  4727.             amount of time the user had already spent in the door.
  4728.             This problem could cause a user to be allowed excessive
  4729.             time in the door.  To correct this problem, EchoDor now
  4730.             writes, in the current directory, a file called
  4731.             EchoDor#.inf which contains the information required to
  4732.             reset the curent user back to the correct time.  When
  4733.             EchoDor is reloaded the /R (reload) switch is added to the
  4734.             start line (after the port number).  This will cause
  4735.             EchoDor#.inf to be reread and the correct parameters to be
  4736.             reset.
  4737.  
  4738.        21.  It was found that when using some BBS packages, EchoDor
  4739.             would not use the supplied port number for the
  4740.             EchoDld#.BAT file.  This would cause the creation of a
  4741.             file called EchoDld0.BAT.  EchoDor now uses the port
  4742.             number supplied regardless of the BBS program being used.
  4743.             Be sure to check user written batch files which might not
  4744.             correctly use the new port number.  Also, port number zero
  4745.             (0) is always used when someone logs on locally.
  4746.  
  4747.  
  4748.  
  4749.  
  4750.  
  4751.  
  4752.  
  4753.  
  4754.  
  4755.  
  4756.  
  4757.  
  4758.  
  4759.  
  4760.  
  4761.  
  4762.  
  4763.  
  4764.  
  4765.  
  4766.  
  4767.  
  4768.  
  4769.  
  4770.  
  4771.  
  4772.  
  4773.  
  4774.  
  4775.  
  4776.  
  4777.  
  4778.                                   Page 73
  4779.  
  4780.  
  4781.      19.0  Plans for next version
  4782.  
  4783.      A message renumbering utility which directly supports EchoDor.
  4784.      This didn't make it in 3.09, we'll keep this on the list of
  4785.      things to do.
  4786.  
  4787.      Further ability in the EchoNLCP compiler.
  4788.  
  4789.      A log file for EchoDor.  This request is to have EchoDor be able
  4790.      to generate a log of activity about what the user has been doing.
  4791.  
  4792.      UNIX e-mail and news group support.  With this addition EchoDor
  4793.      will understand how to write message to be understood by UUCP.
  4794.  
  4795.      Separate IGNORE system for reading and packing.
  4796.  
  4797.      Time estimates for downloads.
  4798.  
  4799.  
  4800.  
  4801.  
  4802.  
  4803.  
  4804.  
  4805.  
  4806.  
  4807.  
  4808.  
  4809.  
  4810.  
  4811.  
  4812.  
  4813.  
  4814.  
  4815.  
  4816.  
  4817.  
  4818.  
  4819.  
  4820.  
  4821.  
  4822.  
  4823.  
  4824.  
  4825.  
  4826.  
  4827.  
  4828.  
  4829.  
  4830.  
  4831.  
  4832.  
  4833.  
  4834.  
  4835.  
  4836.  
  4837.  
  4838.  
  4839.  
  4840.  
  4841.  
  4842.  
  4843.                                   Page 74
  4844.  
  4845.  
  4846.      20.0  Registration
  4847.  
  4848.      EchoDor represents MANY hours of work and if you find it useful,
  4849.      I would appreciate your sending in a donation of $25 or more.  I
  4850.      will send you back a DSDD 5.25" disk or a 3.5" disk with the
  4851.      latest copy of EchoDor, EchoNLCP, EchoNLRD and perhaps a few
  4852.      other small utilities that will fit on it. My address is:
  4853.  
  4854.                Robert McCullough
  4855.                P.O. Box 101095
  4856.                Nashville, TN  37224-1095
  4857.  
  4858.      When you register, please send me you name, address, voice phone,
  4859.      BBS name, BBS type, BBS phone, and where you got EchoDor.
  4860.  
  4861.      I'd like to thank the people that have supported EchoDor through
  4862.      their registration.  I will continue to support the users of
  4863.      EchoDor in a professional manor and will hope to receive your
  4864.      support in return.
  4865.  
  4866.      Also, if you use RASMAM be sure to follow the authors
  4867.      registration requirements.  Registration of EchoDor does NOT give
  4868.      you a registration to RASMAM.
  4869.  
  4870.  
  4871.  
  4872.  
  4873.  
  4874.  
  4875.  
  4876.  
  4877.  
  4878.  
  4879.  
  4880.  
  4881.  
  4882.  
  4883.  
  4884.  
  4885.  
  4886.  
  4887.  
  4888.  
  4889.  
  4890.  
  4891.  
  4892.  
  4893.  
  4894.  
  4895.  
  4896.  
  4897.  
  4898.  
  4899.  
  4900.  
  4901.  
  4902.  
  4903.  
  4904.  
  4905.  
  4906.  
  4907.  
  4908.                                   Page 75
  4909.  
  4910.  
  4911.      21.0  Disclaimer
  4912.  
  4913.      This program is being distributed under the following conditions:
  4914.  
  4915.      1.   This code or any of the files associated with it may not be
  4916.           distributed in modified form in any way.  You may archive
  4917.           this program and it's associated files in any manor that is
  4918.           suitable for your BBS.  Please do not delete any files from
  4919.           the archive.
  4920.  
  4921.      2.   You may not use any portion of the code distributed with
  4922.           this package in any other program without my written
  4923.           permission.
  4924.  
  4925.      3.   This software and/or code may not be distributed for a
  4926.           profit.  This does not exclude the archive from being on a
  4927.           pay for use BBS.
  4928.  
  4929.      4.   I am in no way responsible for any damage that may be caused
  4930.           due to the use or misuse of this software.  The user assumes
  4931.           all responsibility for any damages and holds the author
  4932.           harmless.
  4933.  
  4934.  
  4935.  
  4936.  
  4937.  
  4938.  
  4939.  
  4940.  
  4941.  
  4942.  
  4943.  
  4944.  
  4945.  
  4946.  
  4947.  
  4948.  
  4949.  
  4950.  
  4951.  
  4952.  
  4953.  
  4954.  
  4955.  
  4956.  
  4957.  
  4958.  
  4959.  
  4960.  
  4961.  
  4962.  
  4963.  
  4964.  
  4965.  
  4966.  
  4967.  
  4968.  
  4969.  
  4970.  
  4971.  
  4972.  
  4973.                                   Page 76
  4974.  
  4975.  
  4976.      22.0  Guarantee
  4977.  
  4978.      There is absolutely no guarantee, warranty or promise of any kind
  4979.      made with regard to the performance or quality of the EchoDor
  4980.      software, utilities, documentation, or any associated files. Any
  4981.      problems, risks, damages, disasters or lack of them are purely
  4982.      you're responsibility.  By using this software, documentation,
  4983.      utilities, or any associated materials, you acknowledge this in
  4984.      full.
  4985.  
  4986.  
  4987.  
  4988.  
  4989.  
  4990.  
  4991.  
  4992.  
  4993.  
  4994.  
  4995.  
  4996.  
  4997.  
  4998.  
  4999.  
  5000.  
  5001.  
  5002.  
  5003.  
  5004.  
  5005.  
  5006.  
  5007.  
  5008.  
  5009.  
  5010.  
  5011.  
  5012.  
  5013.  
  5014.  
  5015.  
  5016.  
  5017.  
  5018.  
  5019.  
  5020.  
  5021.  
  5022.  
  5023.  
  5024.  
  5025.  
  5026.  
  5027.  
  5028.  
  5029.  
  5030.  
  5031.  
  5032.  
  5033.  
  5034.  
  5035.  
  5036.  
  5037.  
  5038.                                   Page 77
  5039.  
  5040.  
  5041.           Contents
  5042.  
  5043.           Chapter 1  Introduction                               1
  5044.  
  5045.           Chapter 2  INSTALLATION                               2
  5046.  
  5047.           Chapter 3  DoorDriv.Ctl parameter file                5
  5048.              3.1  Multiple DoorDirv.Ctl files  . . . . . . . .  5
  5049.              3.2  Parameters . . . . . . . . . . . . . . . . .  5
  5050.              3.3  Color Table  . . . . . . . . . . . . . . . .  9
  5051.              3.4  PC Board 14  . . . . . . . . . . . . . . . . 10
  5052.              3.5  PC Board 12  . . . . . . . . . . . . . . . . 10
  5053.              3.6  Opus 1.1x  . . . . . . . . . . . . . . . . . 10
  5054.              3.7  GT PowerComm . . . . . . . . . . . . . . . . 10
  5055.              3.8  LINE-A operation . . . . . . . . . . . . . . 10
  5056.              3.9  LINE-B operation . . . . . . . . . . . . . . 11
  5057.  
  5058.           Chapter 4  ECHODOR.CTL parameter file                12
  5059.              4.1  Files  . . . . . . . . . . . . . . . . . . . 12
  5060.              4.2  Parameters . . . . . . . . . . . . . . . . . 12
  5061.              4.3  Pack Mail / Compress / Download Setup  . . . 25
  5062.                 4.3.1  Basic Setup . . . . . . . . . . . . . . 25
  5063.                 4.3.2  Compressing Mail  . . . . . . . . . . . 25
  5064.                 4.3.3  Downloading Mail  . . . . . . . . . . . 27
  5065.              4.4  Multiple Node Setup  . . . . . . . . . . . . 30
  5066.                 4.4.1  The Common Directory Method . . . . . . 30
  5067.                 4.4.2  Multiple Directory Method . . . . . . . 32
  5068.              4.5  Multiple Net Setup . . . . . . . . . . . . . 36
  5069.  
  5070.           Chapter 5  Purging & Renumbering Areas               38
  5071.  
  5072.           Chapter 6  EchoDor Operation                         40
  5073.              6.1  Menu Commands  . . . . . . . . . . . . . . . 40
  5074.              6.2  Reading messages . . . . . . . . . . . . . . 42
  5075.              6.3  Entering messages  . . . . . . . . . . . . . 44
  5076.                 6.3.1  Line Editor . . . . . . . . . . . . . . 44
  5077.                 6.3.2  Full Screen Editor  . . . . . . . . . . 45
  5078.                    6.3.2.1  Insert Mode versus Overtype Mode . 46
  5079.                    6.3.2.2  Keyboard emulation . . . . . . . . 46
  5080.                    6.3.2.3  Visual Quote . . . . . . . . . . . 46
  5081.              6.4  Using EchoDor Locally  . . . . . . . . . . . 48
  5082.              6.5  Speical local keys . . . . . . . . . . . . . 49
  5083.  
  5084.           Chapter 7  Message Header Description                50
  5085.  
  5086.           Chapter 8  How do file-requests work?                52
  5087.  
  5088.           Chapter 9  File-attaches                             54
  5089.  
  5090.           Chapter 10  Listing file-requests and file-attaches  55
  5091.  
  5092.           Chapter 11  Auto Messages                            56
  5093.  
  5094.           Chapter 12  General info                             57
  5095.  
  5096.           Chapter 13  EchoUser Program                         58
  5097.              13.1  User File Records . . . . . . . . . . . . . 58
  5098.                 13.1.1  Default User & Maintenance Record  . . 58
  5099.                 13.1.2  User Records . . . . . . . . . . . . . 59
  5100.              13.2  Remote Operation  . . . . . . . . . . . . . 60
  5101.  
  5102.  
  5103.                                      i
  5104.  
  5105.  
  5106.              13.3  Local Operation . . . . . . . . . . . . . . 60
  5107.  
  5108.           Chapter 14  Using SCANMRG                            61
  5109.  
  5110.           Chapter 15  The EchoDor Nodelist compiler            62
  5111.              15.1  How it works  . . . . . . . . . . . . . . . 62
  5112.              15.2  The Control file  . . . . . . . . . . . . . 63
  5113.              15.3  Running EchoNLCP  . . . . . . . . . . . . . 63
  5114.              15.4  EchoNLRD node list reader . . . . . . . . . 63
  5115.  
  5116.           Chapter 16  Opus 1.1x Converter (OPUSCNVT)           65
  5117.  
  5118.           Chapter 17  Support for EchoDor                      66
  5119.  
  5120.           Chapter 18  Revision History                         67
  5121.  
  5122.           Chapter 19  Plans for next version                   74
  5123.  
  5124.           Chapter 20  Registration                             75
  5125.  
  5126.           Chapter 21  Disclaimer                               76
  5127.  
  5128.           Chapter 22  Guarantee                                77
  5129.  
  5130.  
  5131.  
  5132.  
  5133.  
  5134.  
  5135.  
  5136.  
  5137.  
  5138.  
  5139.  
  5140.  
  5141.  
  5142.  
  5143.  
  5144.  
  5145.  
  5146.  
  5147.  
  5148.  
  5149.  
  5150.  
  5151.  
  5152.  
  5153.  
  5154.  
  5155.  
  5156.  
  5157.  
  5158.  
  5159.  
  5160.  
  5161.  
  5162.  
  5163.  
  5164.  
  5165.  
  5166.  
  5167.  
  5168.                                     ii