home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / va210-o2.zip / VFIDO.DOC < prev    next >
Text File  |  1997-02-05  |  22KB  |  575 lines

  1.  
  2.          VFIDO & VTIC
  3.          ════════════
  4.  
  5.                 VFIDO.EXE is the FIDO network software provided with
  6.          Virtual Advanced software.  It supports FIDOnet, and the many
  7.          alternative FTS or FIDOnet-based networks.  VFIDO is complete --
  8.          there is no other mailer or software needed, and set-up couldn't
  9.          be easier.
  10.  
  11.                 VTIC.EXE is the TIC processor for Virtual Advanced
  12.          software.  It has been designed to recognize standard .TIC
  13.          files as received through FIDOnet and other sources.  It
  14.          can also recognize and adeptly handle the Planet Connect
  15.          ALLTICS.* format.
  16.          
  17.                Virtual Advanced features an extremely sophisticated
  18.          version of VFIDO.EXE which can gate netmail and echomail
  19.          between FIDOnet and other networks, and other network types.
  20.          VFIDO can even toss (unpack) mail in the background, so it 
  21.          doesn't tie up a serial port/modem.
  22.  
  23.          NOTE: If you intend to receive FIDOnet incoming calls,
  24.          don't forget to turn on the option "FIDOnet Detect" under
  25.          VCONFIG Main Configuration.
  26.  
  27.                With VFIDO, it's easy to gate email and messages:
  28.  
  29.          FIDOnet <--> VirtualNET-type
  30.          FIDOnet <--> Internet                        (messages only)
  31.          FIDOnet <--> QWK                             (messages only)
  32.          
  33.          VFIDO.EXE COMMAND LINE USAGE
  34.          ════════════════════════════
  35.  
  36.                Note that <ch> refers to Virtual Advanced Channel Number.
  37.          
  38.          VFIDO <ch> /U
  39.          
  40.          Update and packup any outgoing mail.  Automatically called 
  41.          by VME as needed.
  42.          
  43.          VFIDO <ch> /R
  44.          
  45.          Pull in data received by remote.
  46.          (Automatically run when data is received after a net call, however
  47.          you might use this function for special purposes.)
  48.          
  49.          VFIDO <ch> /D<full system address>
  50.          
  51.          Dial into the specified system.
  52.  
  53.          VFIDO /NC [/NL] NETWORKID=<net id>
  54.  
  55.          Compile the NodeList for the <net id> given. Compiling
  56.          the NodeList enables VFIDO to quickly search for phone
  57.          numbers and the like when handling crashmail and FREQ.
  58.  
  59.          If you include the option /NL, then DATA\NETLIST.<net id>
  60.          will be generated for viewing in the Network Listings
  61.          function of the BBS.
  62.          
  63.          VFIDO /ND NETWORKID=<net id>
  64.  
  65.          Process the NodeDiff for the <net id> given.
  66.  
  67.          NOTE: Only the /NC and /ND commands require that you supply
  68.          the NETWORKID= parameter.
  69.  
  70.          VTIC.EXE COMMAND LINE USAGE
  71.          ═══════════════════════════
  72.  
  73.                For standard usage (processing inbound), the following 
  74.          command line is suggested:
  75.          
  76.          VTIC /PATH=<Directory to be Processed>
  77.          
  78.                For PLANET CONNECT usage (processing inbound), the 
  79.          following command line is suggested:
  80.          
  81.          VTIC /PATH=<Directroy to be Processed> /NOT-TODAY
  82.  
  83.          The /NOT-TODAY parameter prevents VTIC from processing the
  84.          current day's ALLTICS.* file, thereby assuring that the receive
  85.          cycle is complete when the file is processed the following day.
  86.  
  87.          A good time of day to run this command line as an event seems
  88.          to be 1:30 eastern time, though you will want to keep on
  89.          eye on this until you've verified that the time you've chosen
  90.          is appropriate for you and your time zone.
  91.          
  92.                To process any pending, outgoing TICs:
  93.  
  94.          VTIC /U
  95.          
  96.          NOTE: For any of the VTIC command line options, if the 
  97.          NETWORKID= parameter is omitted from the VTIC command line, 
  98.          NETWORKID=4 (FIDOnet) is assumed.
  99.          
  100.          VCONFIG SET-UP FOR VFIDO & VTIC
  101.          ═══════════════════════════════
  102.          
  103.                 The set-up screen for FIDOnet has been greatly
  104.          simplified; you manipulate one configuration that controls
  105.          all of your FIDOnet-type networks.  From that point on,
  106.          VCONFIG, VFIDO, VMB, VME, and NETWORKS.LST do all of the work
  107.          for you in terms of keeping the multiple FIDOnets separate.
  108.          
  109.                 When setting FIDOnet using VCONFIG, you will be given 
  110.          the following choices:
  111.           
  112.          1. System Address: 
  113.  
  114.          This is where you enter your main FIDOnet address.
  115.          (Example: 1:228/999)
  116.  
  117.          2. Our AKAs: 
  118.  
  119.          This where you enter one or more same-net or other-net
  120.          AKAs.  1:228/990 would be an example of a same-net AKA,
  121.          56:1/3 would be an example of an other-net AKA.
  122.          
  123.          This field is important when setting up multiple FIDO-based
  124.          networks.  You may put multiple entries on this line, listing
  125.          all of your "secondary" fido-type network addresses.  Multiple
  126.          entries should be separated by spaces.
  127.  
  128.          NOTE: Planet Connect users should put in an AKA of 1:3615/51
  129.          in order for incoming packets from the Satellite Dish to be 
  130.          recognized as being tossable.
  131.          
  132.          NOTE: The software still keeps the networks separate, auto-adjusting 
  133.          by the zone information of the outgoing or incoming packet as needed.
  134.          
  135.          3. Net Directory
  136.  
  137.          This setting specifies the directory to be used by this network for
  138.          storage of outgoing mail, and temporary storage for incoming data.
  139.          (Example: C:\FIDO) 
  140.  
  141.          Directories will be created beneath this directory automatically,
  142.          on an as-needed basis.
  143.  
  144.          4. Use Alternate Zmodem
  145.  
  146.          If Disabled, VXY is used.  If Enabled, DSZ is used.  (DOS Ver Only!)
  147.          
  148.          5. Refeed Pass-Thru
  149.  
  150.          If disabled, you will only be able to refeed echos you are 
  151.          actually subscribing to on your BBS.  This greatly optimizes 
  152.          processing time if this situation applies to you.  You may
  153.          also use this as a security feature, if you do not intend to
  154.          allow your "downlinks" to pull echos you aren't actually
  155.          receiving yourself on your BBS.
  156.          
  157.          If enabled, you will be able to refeed anything you receive,
  158.          whether you subscribe to the echo on your board or not.
  159.          
  160.          D. Edit Remote List
  161.  
  162.          This choice lets you edit the list of systems you are connected to.
  163.          For each system, you can set a number of parameters:
  164.  
  165.          1) FIDO Address:
  166.  
  167.          The main system address of the remote system.  Typically
  168.          this will be their main FIDOnet address, though it could
  169.          be an address on an alternative fido-type network.  
  170.          
  171.          In cases where you will be using EMSI as the primary mail
  172.          session with this remote system, the address you put here
  173.          should be the FIRST ADDRESS they present during the
  174.          EMSI handshake sequence.  To see what's actually received
  175.          during an EMSI handshake, see FIDO.LOG in your DATA directory.
  176.          
  177.          2) Phone Number:
  178.  
  179.          The phone number, exactly as it needs to be dialed.  PHONE.FID,
  180.          described below, is used to perform translation on phone numbers
  181.          when VFIDO needs to automatically look-up a node and add them
  182.          to the dialing list.
  183.          
  184.          3) The next group a) through f) are Options specific to this 
  185.          Dial List entry:
  186.          
  187.            a) EMSI Enable:
  188.  
  189.            If disabled, EMSI mail sessions will not be attempted during 
  190.            dialouts to this system.
  191.          
  192.            b) YooHoo Enable:
  193.  
  194.            If disabled, YooHoo mail sessions will not be attempted during 
  195.            dialouts to this system.
  196.  
  197.            c) Default Echo Server:
  198.  
  199.            You can use this option to specify that this system is your
  200.            default EchoMail server.  You can enable this option ONLY if
  201.            all of the following conditions are met:
  202.  
  203.            Your are on only ONE FIDO-type network
  204.            You exchange EchoMail with only THIS ONE other system 
  205.  
  206.            You must always disable this option, and use the AREAS.BBS set-up
  207.            described below, if any of following conditions are met:
  208.          
  209.            You are on multiple FIDO-type networks
  210.            You exchange EchoMail with more than one other system
  211.            You have "downlinks" to refeed
  212.  
  213.            d) Default For AREAFIX Pass-Thru
  214.  
  215.            Setting this flag to Yes indicates that this site is to be the
  216.            default site for AREAFIX requests. You may have multiple default
  217.            AREAFIX Pass-Thru servers, BUT they must be in separate
  218.            fido-type networks. Put another way, you may have multiple
  219.            default AREAFIX Pass-Thru servers, BUT no more than ONE per
  220.            fido-type network.
  221.          
  222.            e) Default For ALLFIX Pass-Thru
  223.          
  224.            Setting this flag to Yes indicates that this site is to be the
  225.            default site for ALLFIX requests. You may have multiple default
  226.            ALLFIX Pass-Thru servers, BUT they must be in separate
  227.            fido-type networks. Put another way, you may have multiple
  228.            default ALLFIX Pass-Thru servers, BUT no more than ONE per
  229.            fido-type network.
  230.  
  231.            f) Automatic Dialout Option
  232.  
  233.            This controls how VME automatically dials this node for fido-type
  234.            network calls.  The possibilities are:
  235.         
  236.            Disabled     - No Automatic Polling
  237.            Daily/LD     - Long Distance, Once Per Day
  238.            Daily/Local  - Local Call, Once Per Day
  239.            Hourly/Local - Local Call, Once Per Hour
  240.  
  241.            Note that "Long Distance" implies that dialouts should occur
  242.            only during cheap long distance periods, such as 11 pm to 7 am.
  243.            Local calls, on the other hand, are permitted at any time of
  244.            day, however only once per day or per hour as set by the sysop.
  245.          
  246.          4) Storage Directory:
  247.  
  248.          Automatically assigned by VCONFIG or VFIDO.  Specifies where
  249.          files awaiting transmission to this particular system are stored.
  250.  
  251.          DO NOT EDIT THIS FIELD FROM ITS DEFAULT ASSIGNED VALUE
  252.          UNLESS YOU HAVE A SPECIFIC PURPOSE IN MIND, AND UNDERSTAND
  253.          THE FOLLOWING:
  254.          
  255.          This entry must be an 8-character or less directory name that 
  256.          DOES NOT include drive and/or path specification characters such 
  257.          as ":" or "\".
  258.  
  259.          5) Session Password:
  260.  
  261.          Specifies the session password for this connection.
  262.  
  263.          6) Packet Password:
  264.  
  265.          Specifies the packet password for this connection.
  266.  
  267.          NOTE: In most cases, Session Password and Packet Password
  268.          should be the SAME.
  269.          
  270.          7) AREAFIX Password:
  271.          
  272.          Specifies the AREAFIX password for this connection.
  273.          If none is specified, AREAFIX requests from this system
  274.          will be denied.
  275.          
  276.          8) ALLFIX Password:
  277.          
  278.          Specifies the ALLFIX password for this connection.
  279.          If none is specified, ALLFIX requests from this system
  280.          will be denied.
  281.  
  282.          9) Compression:
  283.  
  284.          Specifies the Compression type for this connection.
  285.          
  286.          0 = No Compression
  287.          1 = ZIP
  288.          2 = ARJ
  289.          3 = LZH
  290.          4 = ARC
  291.          
  292.          (As programmed in ARCS.CFG)
  293.          
  294.          T) Their AKA's:
  295.  
  296.          Allows you specify other aliases that the other system may
  297.          be known by.  This information is used during netmail routing
  298.          to ensure that mail to their aliases (same net and alternative net)
  299.          ends up in the outbound storage directory created for storing
  300.          packets destined for this remote system.
  301.  
  302.          Naturally, mail destined for different zones is still kept in 
  303.          separate packets, with proper packet headers on each.  But, by 
  304.          putting all of their packets in one directory, the process of 
  305.          transmitting the mail when they call in (or when you call them) 
  306.          is grealty simplified, stream-lined, and efficient.
  307.  
  308.          M) EMSI/Multiple AKA's:
  309.  
  310.          Specifies how we identify ourselves when we net into this system
  311.          for an EMSI session.  If this option is left at <Default>, we
  312.          identify ourselves by our main System Address configured on the
  313.          main screen, otherwise the identification sent is exactly
  314.          what you configure here.
  315.          
  316.          R. Routing
  317.  
  318.          This selection lets you set-up how netmail (EMAIL) is routed.
  319.  
  320.          Routing Line Format and Wildcards
  321.          ---------------------------------
  322.          
  323.          The format of each line is:
  324.          <system address> <destination address of netmail>
  325.  
  326.          <system address> is a system listed in your dialing
  327.          list, that you connect to for netmail exchange.
  328.          
  329.          The <destination address of netmail> field may contain the
  330.          wildcard character "*" to imply "any" or "all."
  331.  
  332.          For example, to route all netmail to zone 2 through 1:2/1,
  333.          you would add the line:
  334.  
  335.          1:2/1 2:*/*
  336.  
  337.          To route all netmail for zone 1, net 228, through 1:228/1:
  338.          
  339.          1:228/1 1:228/*
  340.  
  341.          To route all netmail, regardless of destination, through
  342.          your main netmail server (for example 1:10/1):
  343.  
  344.          1:10/1 *:*/*
  345.  
  346.          NOTE: The *:*/* wildcard should only be used on the LAST line 
  347.          in your routing set-up.  Routing statements are evaluated from
  348.          top to bottom, and should therefore be arranged from the
  349.          SPECIFIC (few or no wildcards) to the GENERAL (*:*/*).
  350.  
  351.          A Specific Example
  352.          ------------------
  353.  
  354.          To illustrate this set-up, let us look at a specific example;
  355.          
  356.          Let's say your address is 1:100/205.
  357.          
  358.          Your Main NetMail Server is 1:100/10.
  359.          
  360.          Your Zone-Gate for Zone 2 Netmail is 1:2/1.
  361.          Your Zone-Gate for Zone 3 Netmail is 1:3/1.
  362.          Your Zone-Gate for Zone 4 Netmail is 1:4/1.
  363.          Your Zone-Gate for Zone 5 Netmail is 1:5/1.
  364.          Your Zone-Gate for Zone 6 Netmail is 1:6/1.
  365.          Your Zone-Gate for Zone 7 Netmail is 1:7/1.
  366.  
  367.          Your also Connect To, and Exchange Netmail
  368.          with 1:100/204 and 1:100/206, two local nodes
  369.          in your area.
  370.  
  371.          Starting at the most specific:
  372.  
  373.          1:100/204 1:100/204
  374.          1:100/206 1:100/206
  375.  
  376.          Then the Zone-Gates:
  377.  
  378.          1:2/1 2:*/*
  379.          1:3/1 3:*/*
  380.          1:4/1 4:*/*
  381.          1:5/1 5:*/*
  382.          1:6/1 6:*/*
  383.          1:7/1 7:*/*
  384.          
  385.          And finally, the most general:
  386.  
  387.          1:100/10 *:*/*
  388.  
  389.          ASCII FILES TO SET UP
  390.          ═════════════════════
  391.  
  392.                 All of the files about to be described are to be stored 
  393.          in your FIDO directory, and are to be composed of one or more
  394.          lines of simple ASCII text.  The filenames are AREAS.BBS, 
  395.          TICS.BBS, PHONE.FID, MAGIC.FID, and ORIGIN.x.
  396.          
  397.          AREAS.BBS
  398.          ---------
  399.  
  400.          EchoMail Conference Redistribution Set-Up.
  401.          
  402.          Format:
  403.  
  404.          One entry per line
  405.          <echomail conference name> <system address> <system address> ... <system address>
  406.  
  407.          Example:
  408.  
  409.          BBS_CARNIVAL 1:228/998 1:228/997 56:1/3
  410.          
  411.          TICS.BBS
  412.          --------
  413.  
  414.          TIC Conference Redistribution Set-Up.
  415.          
  416.          Format:
  417.  
  418.          One entry per line
  419.          <tic conference name> <system address> <system address> ... <system address>
  420.  
  421.          Example:
  422.  
  423.          WIN_GAME 1:228/998 56:1/6
  424.          
  425.          PHONE.FID
  426.          ---------
  427.  
  428.          Phone Number Translation File.
  429.  
  430.          Format:
  431.  
  432.          One entry per line
  433.          <prefix to find> <replacement>
  434.  
  435.          Example:
  436.          1-616-399- 399-
  437.  
  438.          The above example would translate any phone number starting with
  439.          1-616-399- to starting with just 399-, effectively converting
  440.          a long distance dial to a local dial.
  441.          
  442.          MAGIC.FID
  443.          ---------
  444.  
  445.          FREQ Magic Names Set-up.
  446.  
  447.          Format:
  448.  
  449.          One entry per line
  450.          <magic name> <path and filename>
  451.  
  452.          Example:
  453.  
  454.          VDEMO f:\fs\vadvbeta\va1b1.zip
  455.  
  456.          ORIGIN.x (x = NETWORKID of FIDOnet type network)
  457.          --------
  458.  
  459.          SysOp-Definable ORIGIN Line Replaces VFIDO-generated ORIGIN Line.
  460.  
  461.          Format:
  462.  
  463.          One Line
  464.          
  465.          NOTE: It is responsibility of the SysOp to make sure that
  466.          they configure an ORIGIN line which conforms to the network's
  467.          rules and guidelines, if they intend to use the ORIGIN.x option.
  468.          
  469.          NODELISTs and NODEDIFFs
  470.          ═══════════════════════
  471.  
  472.                 Nodelist and Nodediff files should be placed in your FIDO 
  473.          directory.
  474.          
  475.          SETTING UP EMAIL
  476.          ════════════════
  477.  
  478.                 There is nothing extra you need to do, beyond the initial
  479.          VFIDO set-up described above, to be able to send and receive
  480.          FIDOnet Email.  There is nothing further you must do to be
  481.          able to GATE email to other networks, either.
  482.  
  483.          HOW TO SEND CRASHMAIL
  484.          ═════════════════════
  485.  
  486.                 When you send a "regular" email, by default it is
  487.          routed via the routing configuration you have set-up.  When
  488.          you send a crashmail, it is delivered directly to the system
  489.          receiving the email, with your system doing the calling.
  490.          
  491.                 To indicate that an email should be sent as crashmail
  492.          instead of as regular (routed) netmail, simply add **C.
  493.          For example, to crashmail Joe Public @ 1:1/1 you would
  494.          enter into VA an email address of Joe Public **C @ 1:1/1.
  495.          
  496.          HOW TO FREQ
  497.          ═══════════
  498.  
  499.                 FREQ is a mechanism which you can use to automatically
  500.          download files from another FIDO site, without logging in.
  501.          FREQ is a lot like crashmail in that your system must do the
  502.          calling to retrieve files from the other system.
  503.  
  504.                To FREQ a file, you simply send a FREQ email to the
  505.          Sysp of the BBS you want to FREQ files from.  To indicate
  506.          that an email is a FREQ email, simply add **F.  The file(s)
  507.          being requested are put on the SUBJECT line.
  508.  
  509.                For example, to FREQ the file EXAMPLE.ZIP from 1:1/1,
  510.          you would send email to SYSOP **F @ 1:1/1, with a subject
  511.          line of EXAMPLE.ZIP.
  512.          
  513.          SETTING UP FIDONET ECHO'S
  514.          ═════════════════════════
  515.  
  516.                 Echomail Areas can be quickly and easily set-up using the 
  517.          included VMB utility program.  Make sure you have ASCII file
  518.          FIDO-NA.4 installed in your DATA directory for VMB to function 
  519.          properly.
  520.  
  521.                 An alternative method to echomail set-up is to use 
  522.          VCONFIG to manually set-up/edit each database entry.  In this
  523.          case, you would use the DATABASE CONFIGURATION portion of
  524.          VCONFIG to display/edit a MESSAGE AREA DATABASE CONFIGURATION ENTRY.  
  525.          At this point, selecting the field "(G) Networks Configuration"
  526.          would let you manually do what VMB does automatically.
  527.          A typical echomail name looks like:
  528.  
  529.                BBS_CARNIVAL
  530.                -or-
  531.                PARADOX
  532.                
  533.                 To GATE an Echomail Area, you merely set-up its
  534.          DATABASE COFIGURATION ENTRY to show that the field 
  535.          "(G) Networks Configuration" shows multiple networks --
  536.          FIDOnet, and the other network(s) you want to GATE to/from.
  537.          For example, you might see:
  538.  
  539.               FIDOnet=BBS_CARNIVAL
  540.               VirtualNET=100000
  541.  
  542.          This means that this particular message base is a gateway
  543.          between FIDONnet's BBS_CARNIVAL Echo, and VirtualNET's
  544.          message sub number 100000.
  545.  
  546.          REMINDER: ECHOMAIL REDISTRIBUTION IS SET-UP USING THE AREAS.BBS
  547.          FILE MENTIONED EARLIER IN THIS DOCUMENT.
  548.          
  549.          SETTING UP FIDONET FILEBONE
  550.          ═══════════════════════════
  551.  
  552.                 Filebone areas can be quickly and easily set-up using the 
  553.          included VMB utility program.  Make sure you have ASCII file
  554.          FILE-NA.4 installed in your DATA directory for VMB to function 
  555.          properly.
  556.  
  557.                 An alternative method to filebone set-up is to use 
  558.          VCONFIG to manually set-up/edit each database entry.  In this
  559.          case, you would use the DATABASE CONFIGURATION portion of
  560.          VCONFIG to display/edit a FILE AREA DATABASE CONFIGURATION ENTRY.  
  561.          At this point, selecting the field "(G) Networks Configuration"
  562.          would let you manually do what VMB does automatically.
  563.          A typical filebone area name looks like:
  564.  
  565.                1-GAME
  566.                -or-
  567.                WIN_GAME
  568.                
  569.          For example, you might see:
  570.  
  571.               FIDOnet=1-GAME
  572.  
  573.          REMINDER: TIC REDISTRIBUTION IS SET-UP USING THE TICS.BBS
  574.          FILE MENTIONED EARLIER IN THIS DOCUMENT.
  575.