home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / PROTOCOL / VXY230.ZIP / VXY.DOC < prev    next >
Text File  |  1993-02-21  |  8KB  |  171 lines
  1.              VXY VBBS Xmodem/Ymodem/Zmodem Transfer Protocols 2.30
  2.                   (C) Copyright Roland De Graaf 1992, 1993
  3.           
  4.           VXY is a file transfer protocol program written specifically 
  5.           for The Virtual BBS/NET 5.60 and up. It provides VBBS with its 
  6.           own set of Xmodem, Ymodem, and now, Zmodem transfer protocols 
  7.           and many of their variants. If you run a multiline VBBS, running 
  8.           2 or more ports off of one machine, then you should take a look 
  9.           at VXY. VXY can also be used as a stand-alone protocol from almost
  10.           any program. (This capability was added so VGIX could make use of 
  11.           VXY for transfer protocols.)
  12.  
  13.                             ========================
  14.                             Using VXY with your VBBS
  15.                             ========================
  16.           
  17.           VXY uses the *exact same* method of accessing the serial 
  18.           ports as does the main VBBS program. VXY follows your VBBS 
  19.           configuration. If you are set to use internal serial 
  20.           routines, then VXY will use internal routine. If you are
  21.           set to use a FOSSIL, then VXY will use the FOSSIL. If you 
  22.           are set for DigiBoard, VXY will work thru your DigiBoard.
  23.  
  24.           Therefore, if you've got some type of weird serial port 
  25.           set-up, which runs OK with VBBS, it will run OK with VXY. 
  26.           VXY can be used in situations where DSZ is *not compatible. 
  27.           VXY is also 'Desqview-sensitive', if you have that switch 
  28.           turned on in VCONFIG.
  29.  
  30.           If you installed VBBS 5.60 as new installation, VXY is already
  31.           configured for you as part of the default configuration files,
  32.           along with DSZ.
  33.  
  34.           If installed VBBS 5.60 as an existing installation, setting up 
  35.           VXY is extremely easy -- just follow the examples below or copy 
  36.           the included default DOWNLOAD.CFG and UPLOAD.CFG files to your 
  37.           VBBS directory. VXY.EXE should reside in your VBBS main directory.
  38.  
  39.         **NOTE: A transfer in progress can be aborted by pressing the Esc key.
  40.  
  41.         **SPECIAL NOTE ABOUT USING VXY FOR NETWORKING:
  42.           
  43.           VXY is the protocol package used by the VFIDO Fidonet Mail Package
  44.           during FTS-0001 TSYNC mail sessions. If you run VFIDO, you must
  45.           have VXY.EXE resident on your system.
  46.  
  47.           VXY Ymodem is supported by the new, enhanced VNET program
  48.           in addition to DSZ Zmodem and HSlink. If you are on any
  49.           VirtualNET type networks, you must have VXY.EXE resident on
  50.           your system.
  51.           
  52.           VXY is a very *new program. Please report all discrepancies
  53.           to the author for immediate attention.
  54.  
  55.         Protocols Supported:        VBBS Set-Up:
  56.         - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  57.         Xmodem                   Sending: VXY %8 -XS %3
  58.                                  Recving: VXY %8 -XR %3
  59.         Xmodem Checksum
  60.         Xmodem CRC
  61.         Xmodem G
  62.         - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  63.         Xmodem 1k                Sending: VXY %8 -KS %3
  64.                                  Recving: VXY %8 -KR %3
  65.         Xmodem 1k Checksum
  66.         Xmodem 1k CRC
  67.         Xmodem 1k G
  68.         - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  69.         Ymodem CRC               Sending: VXY %8 -YS %3
  70.                                  Recving: VXY %8 -YR %3
  71.        
  72.         - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  73.         Ymodem G                 Sending: VXY %8 -GS %3               
  74.                                  Recving: VXY %8 -GR %3                
  75.  
  76.         - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  77.         Modem7                   Sending: VXY %8 -7S %3
  78.                                  Recving: VXY %8 -7R %3
  79.    
  80.         - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  81.         Zmodem                   Sending: VXY %8 -ZS %3               
  82.                                  Recving: VXY %8 -ZR %3                
  83.  
  84.         - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  85.  
  86. **It should be noted, that when sending files, Checksum vs CRC vs G selection
  87.   is made by the receiving end. The "nak" character sent by the receiving end
  88.   dictates the type of error correction: ascii 21 (nak) = Checksum, "C"=CRC,
  89.   "G" = G mode. You need not worry about all of this -- its automatic. This
  90.   information is merely provided for completeness.
  91.  
  92. **Modem7 is a Xmodem-variant that allows for batch file transfer.
  93.   The Virtual BBS FIDOnet Mailer calls VXY for this protocol
  94.   (and the Xmodem protocol) during basic FTS-0001 FIDOnet sessions.
  95.   Many term packages also support this protocol for general BBS use.
  96.                             
  97.                             ===================
  98.                             Using VXY with VGIX
  99.                             ===================
  100.  
  101.           Install VXY.EXE in the same directory where you run VGIX from.
  102.           Thats all there is to it. :)
  103.  
  104.  
  105.                        =============================
  106.                        Using VXY with Other Programs
  107.                        =============================
  108.  
  109.           When using VXY with programs other than VBBS, the 
  110.           command line syntax is as follows:
  111.  
  112.           VXY <port #> /S <options...> <command> <file or path spec>
  113.  
  114.           <port #> is the port number.
  115.           
  116.           /S specifies STAND-ALONE usage (as opposed to VBBS usage.)
  117.           
  118.           <options> 
  119.               
  120.               The default in standalone mode is standard internal COM support.
  121.                 /X instructs VXY to use a FOSSIL driver.
  122.                 /D instructs VXY to use DigiBoard.
  123.               The default in standalone mode is no flow control.
  124.                 /F turns CTS/RTS flow control ON.
  125.               The default is no sound.
  126.                 /Z enables Sound.
  127.               Other:
  128.                 /R enables Zmodem Crash Recovery when Receiving Files.
  129.                 (Zmodem Crash Recovery when Transmitting is automatic.)
  130.           
  131.           <command> is one of the following:
  132.                     -XS   Xmodem Send
  133.                     -XR   Xmodem Receive
  134.                     -KS   Xmodem 1k Send
  135.                     -KR   Xmodem 1K Receive
  136.                     -YS   Ymodem Send
  137.                     -YR   Ymodem Receive
  138.                     -GS   Ymodem G Send
  139.                     -GR   Ymodem G Receive
  140.                     -ZS   Zmodem Send
  141.                     -ZR   Zmodem Receive
  142.  
  143.           <path or file spec>
  144.  
  145.             Receiving:
  146.               
  147.               If the <path or file spec> ends with a "\" character,
  148.               then VXY assumes that this is a path specification,
  149.               otherwise it assumed to be a filename.
  150.               
  151.               Xmodem, Xmodem 1k    Requires a Filename
  152.               Ymodem, Zmodem       Can take a Pathname or Filename
  153.                                    (If none is specified, the current
  154.                                    directory is assumed.)
  155.             Sending:
  156.               
  157.               For sending, a filename is required.
  158.               If you precede the filenamne with a "@" character,
  159.               then VXY assumes that this specifies a ascii file
  160.               containing a list of files to be transmitted.
  161.  
  162.  
  163.          *********************************************************
  164.          VXY is copyrighted shareware, and as such this program
  165.          may be freely distributed in its original form only.
  166.          The author makes no warranty, expressed or implied, with
  167.          regards to claims of loss or damages arising from the use
  168.          of this software.
  169.          *********************************************************
  170.  
  171.