home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / v611docs.zip / VMAIN611.ZIP / V-N < prev    next >
Text File  |  1993-10-11  |  18KB  |  365 lines

  1.                                        VBBS 6.11 Documentation--N-1
  2.  
  3.            ╔══════════════════════════════════════════════════════════╗
  4.            ║ APPENDIX N       INTERFACING WITH WWIV-TYPE NETWORKS     ║
  5.            ╚══════════════════════════════════════════════════════════╝
  6.  
  7.  
  8.            Requirements
  9.            ════════════
  10.            It should be pointed out that in order to interface VBBS
  11.            with WWIVNet and WWIVLink (or other WWIVtype networks), you
  12.            should register VBBS as soon as possible. Multinet access in
  13.            the demo version is limited to 60 days, after which time
  14.            all network interface utilities with the exception of VNet,
  15.            become inoperable. By registering, you are guaranteed that
  16.            network access will not be interrupted, so please do register
  17.            VBBS as soon as possible to avoid any inconvenience.
  18.  
  19.            VWW4.EXE is the interface utility designed especially for
  20.            VBBS which carries out the net interface function for every
  21.            WWIV-type network, including WWIVNet, WWIVLink, and
  22.            ICENet. Before setting up the interface, however, you should be
  23.            aware that many subs from these networks are now being gated to
  24.            VirtualNET. Thus, it may not even be necessary for you to carry
  25.            out this interface at all if that is what you are after.
  26.  
  27.            Now, if you already have VWW4.EXE in hand and want to continue
  28.            with the interface installation, be aware that you MUST also
  29.            have a WWIVnet or WWIV-type node number in order to net. You
  30.            must also set up the appropriate WWIV network files according
  31.            to instructions from your AC/GC.
  32.  
  33.            WWIVNet network policy requires registration of the WWIV
  34.            network software within 60 days.  After this period ,
  35.            unregistered sysops are automatically dropped from the WWIV
  36.            bbslist. The WWIV network files may be registered separately
  37.            for $20, and we urge all sysops that wish to have access to
  38.            all WWIV-type subs to register this software. Contact your
  39.            local WWIV AC for more information.  As for WWIVLink sysops,
  40.            no such registration requirement currently exists and separate
  41.            network software is available.
  42.  
  43.  
  44.                                        VBBS 6.11 Documentation--N-2
  45.  
  46.          Installation
  47.          ════════════
  48.           Step 1 - Run option 7, Networks Configuration in VConfig
  49.                    and choose the appropriate slot to configure.
  50.                    Here you will see the following:
  51.  
  52.                    1. Node Number:
  53.                    2. Data Directory:
  54.                    3. Mode:
  55.                    4. EXE Directory:
  56.                    5. Dialout Init String:
  57.  
  58.                    U. Uninstall this Network
  59.  
  60.           Step 2 - Enter your WWIVnet node number in the first field.
  61.  
  62.           Step 3 - In the next field, enter the full path to the WWIVNet
  63.                    DATA directory (e.g. c:\wwiv\data).
  64.  
  65.           Step 4 - For Mode, select NET for WWIVNet-type networks, or
  66.                    LINK for WWIVLink-type networks.
  67.  
  68.           Step 5 - For the entry to the EXE (executeable) directory,
  69.                    specify the complete path to where the WWIV network
  70.                    executeable files are located  (e.g. c:\wwiv).
  71.  
  72.           Step 6 - For your Dialout Init String, leave this blank for now,
  73.                    unless you are using a version of WWIV prior to WWIV
  74.                    4.20. Later on when testing your WWIV connect with the
  75.                    multinet engine, it may be necessary for you to include
  76.                    the WWIV modem init string in this space if you fail to
  77.                    connect properly. This string would be the same one
  78.                    chosen from the WWIV modems.mdm file. Again, make sure
  79.                    you connect properly to your WWIV server independently
  80.                    from VBBS before attempting the interface here.
  81.  
  82.           Step 7 - After Vconfiguring the NETWORK option above, unzip the
  83.                    VWW4.exe file in your root VBBS directory and read the
  84.                    technical information given in the VWW4.DOC . It should
  85.                    be noted that the multinet engine in VBBS 6 is
  86.                    automatic and requires no batch files, but batch files
  87.                    may be used for convenience and flexibility depending
  88.                    upon your setup.
  89.  
  90.           Step 8 - You must now create an ANSWER.NET file based on the
  91.                    information provided in the MULTINET.DOC file. This
  92.                    should be placed in your VBBS DATA subdirectory.
  93.                    For a VBBS that is on WWIVNet, the ANSWER.NET file
  94.                    would look as follows:
  95.  
  96.                    !
  97.                    ?78=2
  98.                    ?32=2
  99.  
  100.                    For a VBBS on WWIVNet and WWIVLink, the ANSWER.NET
  101.                    would contain:
  102.  
  103.                                        VBBS 6.11 Documentation--N-3
  104.  
  105.  
  106.                    !
  107.                    ?78=2
  108.                    ?32=2
  109.                    ?76=3
  110.  
  111.                    Please refer to other parts of the MULTINET.DOC for
  112.                    more details. Just as an explanation, the ?78 above
  113.                    refers to the N N N sign that WWIVNet sends as an
  114.                    incoming identifier. The ?76 is an L L L that WWIVLink
  115.                    uses. These are ascii characters 78 and 76,
  116.                    respectively.
  117.  
  118.  
  119.           Step 9 - Copy NETWORKS.LST from the zip package to the VBBS NET
  120.                    subdirectory.
  121.  
  122.           Step 10 - If you are interfacing with both WWIVnet and WWIVLink,
  123.                     you MUST maintain separate directories for NET and
  124.                     LINK as mentioned previously. The same holds true for
  125.                     any other WWIV-type networks you subscribe to. In each
  126.                     directory make sure that all of the WWIV network files
  127.                     are in their proper places. Make sure you have run
  128.                     Vconfig's Network option and set the path correctly
  129.                     to where the respective networkx.exe files are
  130.                     located.
  131.  
  132.           NOTE :
  133.     
  134.           You will also have to maintain the DATA subdirectories in each
  135.           of these to create the necessary NNxxxx.net and Nxxxx.net
  136.           or NNALL.NET files needed later to subscribe and to host subs
  137.           on WWIVNet. If you are converting totally over to VBBS from WWIV
  138.           and would like to delete unnecessary/unwanted WWIV files, a list
  139.           of the required WWIV files may be found in the APPENDIX. Erasure
  140.           of unwanted files, however, should be the very last step you
  141.           take in the conversion process after verifying successful
  142.           net connections. As an alternative to deletion, we suggest that
  143.           you simply zip up the unnecessary files and keep them in a safe
  144.           place in the event you need them to reconfigure something in
  145.           WWIV itself later.
  146.  
  147.           Step 11- Run VConfig again and choose the Databases (option 3).
  148.                    Choose Sort Databases to allow the program to set up.
  149.                    Now choose the Compile Networks option. It is important
  150.                    to note than whenever ANY changes are made in the
  151.                    Network option or in Database entries, this must be
  152.                    followed by the Sorting and Compiling options above
  153.                    for the changes to take effect.
  154.  
  155.           This complete the network installation procedure.
  156.  
  157.  
  158.                                        VBBS 6.11 Documentation--N-4
  159.  
  160.           Installing Message Bases
  161.           ════════════════════════
  162.           Assuming you have placed VWW4.exe in your main VBBS
  163.           directory and vconfigured the networks properly,
  164.           then installing a message base is a fairly simple process.
  165.           Follow the instructions given in the main documentation
  166.           regarding adding databases.
  167.  
  168.           In the database entry for a sub, note that option G is for
  169.           Networks Configuration. Choosing this will bring up
  170.           a screen which allows you to A)dd D)elete E)dit  a
  171.           network.
  172.  
  173.           Pressing A) to add a network brings up a screen where you
  174.           can choose the appropriate network. For a sub carried on
  175.           WWIVNet, you would choose entry 2, for example.
  176.  
  177.           Doing so will bring up another prompt as follows:
  178.  
  179.           WWIVNet Network Conference Identifier:_
  180.  
  181.           Simply enter the subtype number of the message base you
  182.           want, and press enter.
  183.  
  184.           Exit out of the database to the main database menu and
  185.           once again, choose Sort Databases and Compile Networks.
  186.  
  187.           Please note that if a message base is being gated to
  188.           VirtualNET from any other network, you have the option
  189.           of subscribing to it as a VirtualNET sub or as a sub
  190.           from another network, but NOT both. Doing so will result
  191.           in duplicate posts.
  192.           NOTE:
  193.     
  194.           If you are subscribing to a Net or Link sub for the first
  195.           time, you must follow the normal procedure of requesting
  196.           the sub from the host and setting up the appropriate
  197.           NNxxx.NET files or NNALL.NET file in the proper data directory.
  198.           In addition this version of VBBS also supports WWIV's auto
  199.           request sub feature (req.exe) using the VREQ utility available.
  200.           It also accepts type 20 messages (subs.pub) using the VWWIV
  201.           utility.
  202.  
  203.  
  204.           Hosting a WWIV Sub
  205.           ══════════════════
  206.           If you are currently hosting a WWIV message base, be assured
  207.           that the same procedure above works for hosts. Again, simply
  208.           enter the appropriate subtype when asked for the Network
  209.           Conference Identifier. Don't forget that you must maintain your
  210.           distribution list through you Nxxxx.NET file as usual. Subs
  211.           flagged for validation may be validated from the SysOp SubMenu.
  212.  
  213.  
  214.                                        VBBS 6.11 Documentation--N-5
  215.  
  216.           Gating Subs to Other Networks
  217.           ═════════════════════════════
  218.           If you are currently hosting a sub on WWIVNet or another
  219.           network, you probably will be interested in 'gating' your sub
  220.           into VirtualNET or other networks to expand your subscriber
  221.           base. This is easily accomplished by adding additional networks
  222.           to your database entry. Entering more than one network and
  223.           respective Network Conference Identifier (subtype, sub number,
  224.           echo,area,etc.) effectively 'gates' that database.
  225.  
  226.           NOTE:
  227.  
  228.           If you are running VBBS as a chain, we do not recommend that you
  229.           attempt gating due to the mechanics of the multinet engine. If
  230.           you wish to gate to multiple networks, we strongly recommend
  231.           that you run VBBS as your main bbs software for simplicity's
  232.           sake.
  233.  
  234.           Please refer to the NETGUIDE.DOC for further details on how to
  235.           set up a hosted VirtualNET sub, sub numbers,etc.
  236.  
  237.           Forcing a Callout
  238.           ═════════════════
  239.           Please note that the VWW4 software is fully automatic, and will
  240.           callout and receive calls from your server depending upon your
  241.           main settings for Threshold and Polling in Vconfig. However, you
  242.           most likely will wish to force callouts to your server from
  243.           the WFC screen from time to time. To do so, you should Type 'N'
  244.           from the Control Panel. First, this will bring up all the
  245.           Networks you currently belong to. Select the appropriate network
  246.           followed by the appropriate system (server).  This will force
  247.           the system to call a particular node.
  248.           NOTE:
  249.           WWIVNet and WWIV-type callouts are completely automated if you
  250.           are running VBBS as your main program.  Be sure to set your
  251.           Threshold level and Polling frequency in Vconfig.  Note that the
  252.           settings of these levels apply generically to all networks,
  253.           (e.g. the same threshold and polling configurations apply to
  254.           VirtualNET, WWIVNet, and WWIVLink packets). Setting the
  255.           threshold level to 0 effectively tells the software never to
  256.           dial out automatically, so be sure to change this. For different
  257.           calling schedules, appropriate utilities such as POLLUTIL.ZIP
  258.           and VWW4-CHK.ZIP are available to customize your setup.
  259.  
  260.  
  261.           VWW4 Activity Log
  262.           ═════════════════
  263.           All net connections made by VWW4 are also listed in the VWW4.LOG
  264.           file which can be found in your main WWIV directory. We suggest
  265.           setting up a function key to be able to view this from the VBBS
  266.           WFC screen using the Control Panel option in Vconfig. For
  267.           example, a bat file called VWW4LOG.BAT could be created and
  268.           placed in your VBBS directory with the following command line:
  269.  
  270.           CD\WWIV
  271.           VLIST VWW4.LOG
  272.           CD\VBBS
  273.  
  274.                                        VBBS 6.11 Documentation--N-6
  275.  
  276.           If you are interfacing with both WWIVNet and WWIVLink, then a
  277.           second batch file similar to the above would need to be created
  278.           pointing to your Link directory, and a second function key set
  279.           up in the Control Panel.
  280.  
  281.           Viewing WWIV's  net logs may be done in the same fashion using
  282.           the Control Panel. Simple script mods are also available to view
  283.           all pending lists from the internal Sysop Menu in VBBS.
  284.  
  285.           Analyzing the BBSList
  286.           ═════════════════════
  287.           VBBS creates a listing of systems belonging to various networks
  288.           that is used for routing mail. You will need to compile this
  289.           information for WWIV the first time you set up so that it may be
  290.           viewed from inside of the board. Subsequent updates are made
  291.           automatically. Note that when WWIV calls in with new bbslists,
  292.           these will be compiled normally and no special maintenance is
  293.           necessary.
  294.  
  295.           To make a new indexed list of WWIV boards for use by VBBS,
  296.           please delete the existing BBSDATA.IDX file from your WWIV data
  297.           subdirectory first. Then, from the WWIV main directory type:
  298.           NETWORK3 /Y  . This will produce new a new idx file.
  299.  
  300.           Now, generate a new bbslist index for VBBS. Change to the root
  301.           VBBS directory where VWW4 is located and type:
  302.  
  303.           VWW4 B NETWORKID=2   for the WWIVNet list, or
  304.           VWW4 B NETWORKID=3   for the WWIVLink index
  305.  
  306.           You should now have succesfully created the new bbslist index
  307.           file that VBBS uses. This is located in your VBBS Data
  308.           subdirectory.
  309.  
  310.           The procedure is similar for generating bbs listings for other
  311.           WWIV-type networks. Be aware of the importance of specifying the
  312.           correct Network Identifer Number in the above command line
  313.           NETWORKID=  . Refer to the list of networks available in
  314.           VConfig's Network options if you need to refresh your memory on
  315.           what network the appropriate network number is.
  316.    
  317.           VWW4 Command Line Switches
  318.           ══════════════════════════
  319.            The Virtual MultiNet Engine (VME) handles WWIVtype networks
  320.            seamlessly. However, VWW4 functions may be called up from batch
  321.            files also, thus providing a flexible means for you to customize
  322.            your setup.
  323.  
  324.            VME will run the VWW4 as needed automatically, providing the
  325.            proper NETWORKID= and PORT= parameters. Running from a command
  326.            line, however, you must specify the following three command
  327.            line parameters:
  328.  
  329.                                        VBBS 6.11 Documentation--N-7
  330.  
  331.            VWW4 <command letter> NETWORKID=<net #> PORT=<COM port #>
  332.  
  333.            The command letter tells VWW4 what to do:
  334.  
  335.            Command Letters are:
  336.   
  337.            B      Bundle mail for WWIV (Update WWIV packets and bbslists)
  338.            U      Unbundle mail from WWIV and store in VBBS databases
  339.            D####  Dial WWIV System #, do transfer, and unbundle if
  340.                   successful
  341.            A      Answer WWIVnet call, do transfer, and unbundle if
  342.                   successful.
  343.  
  344.            The NETWORKID= parameter tells VWW4 which network to process.
  345.            WWIVnet is net #2, WWIVLink is net #3, ICEnet is net #6, and if
  346.            new WWIVnet based nets appear, they will have net numbers
  347.            assigned to them as well. Check NETWORKS.LST for the current 
  348.            network list.
  349.  
  350.            The PORT= parameter must be included when using VWW4 to answer,
  351.            or dial a network call. This specifies a COM port number.
  352.  
  353.            An example of forcing bundling from the command line would
  354.            look like this:
  355.  
  356.            VWW4 B NETWORKID=2 PORT=2
  357.  
  358.            This would bundle the mail for WWIVNet for processing on comport
  359.            2.
  360.  
  361.            Please refer to the extended VWW4 documentation included
  362.            with the VWW4.EXE file itself for more detailed information
  363.            about converting from WWIV to VBBS.
  364.  
  365.