home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / va210-o2.zip / VQWK.DOC < prev    next >
Text File  |  1997-02-05  |  6KB  |  138 lines
  1.  
  2.          VQWK
  3.          ════
  4.  
  5.                 VQWK.EXE is dual-purpose program; it is an advanced QWK
  6.          mail door for you and your users to use to read mail offline
  7.          in the popular QWK format, and it is also capable of functioning
  8.          as a network interface (ie passing QWK packets between BBS's).
  9.          
  10.                Virtual Advanced features an extremely sophisticated
  11.          version of VQWK.EXE which can easily gate messages between itself 
  12.          and any other network type also supported by Virtual Advanced.  
  13.          
  14.                With VQWK, when used in QWK networking, it is easy to gate
  15.          messages:
  16.          
  17.          VQWK <--> VirtualNET-type                    (messages only)
  18.          VQWK <--> FIDOnet                            (messages only)
  19.          VQWK <--> Internet                           (messages only)
  20.  
  21.          VQWK.EXE COMMAND LINE USAGE
  22.          ════════════════════════════
  23.  
  24.                Note that <ch> refers to Virtual Advanced Channel Number,
  25.          and that <x> refers to the NETWORKID #, as defined by file
  26.          DATA\NETWORKS.LST.
  27.          
  28.          As a DOOR:
  29.  
  30.          VQWK.EXE <ch>
  31.           
  32.          (Example: VQWK %1)
  33.  
  34.          The default Virtual Advanced set-up already includes references
  35.          to VQWK.EXE in the default function blocks provided.  Knowing
  36.          the commandline usage is important, though, if you wish to
  37.          customize how the QWK door is accessed on your system, such
  38.          as running it from a script (example: DOOR "VQWK %1").
  39.  
  40.          As a NETWORK INTERFACE:
  41.  
  42.          Step 1. Generate Packet To Exchange (Send To) Other QWK net BBS
  43.  
  44.          VQWK 0 /EXPORT=<path and filename>,<user #> NETWORKID=<x>
  45.  
  46.          <path and filename> QWK Format File To Be Created
  47.          <user #>            Dummy User # Assigned To This QWK Net Connect
  48.  
  49.          Step 2. Get Packet From Remote BBS
  50.                  Send Packet Created In Step 1 to Remote BBS
  51.  
  52.          How this part is accomplished is up to you and the remote sysop.
  53.          
  54.          Typically, this is done by using a script-driven comm program
  55.          such as Telix or Telemate to call, login, and download a QWK
  56.          packet. After that, the packet created in step 1 is uploaded.
  57.  
  58.          Step 3. Get The Messages Onto Your BBS
  59.  
  60.          VQWK 0 /IMPORT=<path and filename>,<user #> NETWORKID=<x>
  61.  
  62.          <path and filename> QWK Format File To Be Imported
  63.          <user #>            Dummy User # Assigned To This QWK Net Connect
  64.          
  65.          Note: The <user #> dummy account is used for its "new-scan"
  66.          pointers, allowing your BBS and another BBS to exchange QWK
  67.          mail without duplicates, so long as each QWK net BBS you
  68.          exchange mail with has its own, consistent dummy account to use.
  69.  
  70.          SETTING UP QWK CONFERENCE NUMBERS
  71.          ═════════════════════════════════
  72.  
  73.                Defined by the QWK standard, each message base (or 
  74.          conference as they are sometimes called) has associated with it
  75.          a number between 1 and 32767.  This number helps QWK offline
  76.          readers, and QWK mail programs, track messages and make sure
  77.          everything gets put into the right place.
  78.  
  79.                Up to 4000 of the message bases you set-up under Virtual 
  80.          Advanced can be made available to your callers to download through 
  81.          the QWK door.  They will be able to download new messages when they
  82.          call in, and optionally upload their offline-written replies as well.
  83.          It does not matter what network or netowkrs a message base "belongs"
  84.          to, the QWK door can provide access to it for your callers.
  85.  
  86.                Of the up to 4000 message bases, you can use QWK numbers 2 to
  87.          32767 to identify them.  VCONFIG can automatically assign QWK
  88.          numbers to message bases for you, if you like, or you can do 
  89.          it manually.
  90.  
  91.                IMPORTANT: So far the discussion has dealt with QWK numbers
  92.          as used with VQWK operating as a DOOR.  It is important to note that
  93.          VQWK, when operating as a NETWORK INTERFACE, maintains a SEPARATE
  94.          set of QWK conference numbers for each separate QWK type network.
  95.          That way, if you have sub "100 IBM Discussion" on one QWK net,
  96.          and sub "100 Intelligent Conversation" on another QWK type net,
  97.          there is no conflict.  For setting up of QWK net conferences,
  98.          see the section titled "SETTING UP QWK NET MESSAGE BASES" below.
  99.          
  100.          VCONFIG SET-UP FOR QWK NETS
  101.          ═══════════════════════════
  102.  
  103.                QWK nets are extremely easy to set-up.   Just select
  104.          from within VCONFIG to turn a network on.  No configuration
  105.          information (ie node address, directories, etc) is required.
  106.          
  107.          SETTING UP QWK NET MESSAGE BASES
  108.          ════════════════════════════════
  109.  
  110.                 QWK net Message Bases can be quickly and easily set-up 
  111.          using the included VMB utility program.  Make sure you have 
  112.          QWKLIST.??? set-up in your DATA directory.  (Example:
  113.          For NETWORKID=54, the file would be QWKLIST.54)
  114.  
  115.                 An alternative method to message base set-up is to use 
  116.          VCONFIG to manually set-up/edit each database entry.  In this
  117.          case, you would use the DATABASE CONFIGURATION portion of
  118.          VCONFIG to display/edit a MESSAGE AREA DATABASE CONFIGURATION ENTRY.
  119.  
  120.          At this point, selecting the field "(G) Networks Configuration"
  121.          would let you manually do what VMB does automatically.
  122.          A typical message base number is in the range 1 to 32767.
  123.  
  124.                 To GATE a Message Base, you merely set-up its
  125.          DATABASE COFIGURATION ENTRY to show that the field 
  126.          "(G) Networks Configuration" shows multiple networks --
  127.          the QWK net, and the other network(s) you want to GATE to/from.
  128.          For example, you might see:
  129.  
  130.               CRS=100
  131.               VirtualNET=100000
  132.               
  133.          ADVANCED OPTIONS
  134.          ════════════════         
  135.  
  136.                 The features described hereafter are optional, and unneeded
  137.          in most cases.
  138.