home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / comm / xfr57a.zip / TRANSFER.DOC < prev    next >
Text File  |  1992-04-21  |  14KB  |  348 lines
  1.  
  2.                                TRANSFER
  3.  
  4.                               Version 5.7
  5.  
  6.                       Copyright 1992-Steve Lewis
  7.  
  8.    NOW with HSlink BI-DIRECTIONAL protocol! (REGISTRATION REQUIRED) 
  9.  
  10.  
  11. The BATCHFLE file for Version 5.7 has a different format than that used
  12. with earlier versions of TRANSFER, in that the new version does not have
  13. "***" tacked onto the bottom of the file list. Be SURE to remake the
  14. BATCHFLE file, using MAKBATCH.EXE.
  15.  
  16. Version 5.7 supports the new HSlink bi-directional transfer protocol!
  17. REGISTRATION is required to access this protocol.
  18.  
  19. The PUMA protocol has been eliminated, due to its decreasing popularity.
  20.  
  21. Version 5.7, when REGISTERED, checks all filenames (paths included), when
  22. uploading in the manual mode. If a file is not found, the user will be
  23. prompted to re-enter the filename. If uploading is from a floppy drive,
  24. user is prompted if drive door is open.
  25.  
  26. Note also that TRANSFER may be used with the new GSZ.EXE and GSZ.COM
  27. programs. To use these programs, simply rename them DSZ.EXE or DSZ.COM.
  28.  
  29. Version 5.7 of TRANSFER is distributed in its NONREGISTERED state. By
  30. registering TRANSFER, you will receive a file named "AUTHORIZ". This
  31. file contains your personal serial number and checksum, and when present in
  32. the SAME directory as TRANSFER, it will UNLOCK the SPECIAL features of
  33. Version 5.7. Your copy of AUTHORIZ will be compatible with ALL future
  34. versions of TRANSFER. You will NOT need to purchase AUTHORIZ again!
  35.  
  36.  
  37. These special features are;
  38.  
  39.  
  40.                    (1) May be configured for a FIXED PROTOCOL, thus
  41.                        eliminating the need to manually select the protocol.
  42.  
  43.                    (2) May be configured for "Hotkeys", eliminating
  44.                        the necessity for carriage returns whenever
  45.                        possible.
  46.  
  47.                    (3) When configured for BOTH the program-selectable protocol
  48.                        AND the "Hotkeys" modes, a carriage return <cr> entered
  49.                        in response to a question returns the user to the "Enter
  50.                        protocol" line of text, permitting the user to re-enter
  51.                        the protocol number.
  52.  
  53.                    (4) When MANUALLY entering a filename for uploading, it is
  54.                        checked to make sure that it actually exists. If it
  55.                        doesn't exist, the user is prompted to re-enter the
  56.                        filename. If uploading is from a floppy drive, then
  57.                        user is prompted if drive door is open.
  58.  
  59.                    (5) HSlink bi-directional protocol and Tasy protocols are
  60.                        supported. 
  61.                   
  62.  
  63.  
  64.  
  65. Version 5.2 of TRANSCFG.EXE prompts for the additional information, but
  66. UNREGISTERED versions will NOT be able to take advantage of this information.
  67.  
  68. Future versions of TRANSFER will have MANY more SPECIAL features!
  69.  
  70. Version 5.7 corrects a defect in earlier versions that permitted other than
  71. integral values to be entered for the protocol number. Additionally,
  72. Version 5.7 does not permit the entering of a blank line for the filename.
  73.  
  74. When batch uploading with the MEGALINK protocol, A-L-L filenames MUST be
  75. from the S-A-M-E directory! The directory of the FIRST filename MUST be the
  76. directory for ALL the others. This limitation is due to the MLINK.EXE
  77. PROTOCOL, and is NOT due to the "TRANSFER.EXE" program.
  78.  
  79. When changing versions of TRANSFER.EXE, A-L-W-A-Y-S change the following
  80. files as well;
  81.  
  82.                                TRANSCFG.EXE
  83.                                MAKBATCH.EXE
  84.  
  85.                   ..... BECAUSE THEY MAY DIFFER FROM THOSE
  86.                         PACKED WITH THE PREVIOUS VERSION OF
  87.                         TRANSFER.EXE !!!
  88.  
  89. When installing a new version of TRANSFER, always RE-CONFIGURE with the
  90. supplied TRANSCFG.EXE program!
  91.  
  92. TRANSFER was written primarily as a file transfer shell for a communications
  93. program. If you are using PCPLUS, configure PCPLUS so you can shell out
  94. to TRANSFER by using the <ALT>J or <ALT>U keys.
  95.  
  96. TRANSFER can be used in the MODEM mode, or in the DIRECT mode by using a
  97. "Null Modem" cable. In the MODEM mode, TRANSFER assumes that communications
  98. have already been established by the communications program, therefore,
  99. neither the modem nor COM port are initialized. In the DIRECT mode, the COM
  100. port is initialized to the communications speed specified in the configuration
  101. routine, and in addition is set to 8 data bits, 1 stop bit, and no parity.
  102. After exiting TRANSFER in the DIRECT mode, you may want to manually reset
  103. your COM port.
  104.  
  105.  
  106. The following transfer protocols are supported by TRANSFER;
  107.  
  108.  
  109.                       (1)  Xmodem/CHK SUM
  110.                       (2)  Xmodem/CRC
  111.                       (3)  Ymodem/(1K Xmodem)
  112.                       (4)  Ymodem/CRC
  113.                       (5)  Ymodem-G
  114.                       (6)  Ymodem/Batch
  115.                       (7)  Jmodem
  116.                       (8)  Jmodem/Batch  (NOW TRUE BATCH!)
  117.                       (9)  Zmodem/Batch  (Z-MODEM 90)
  118.                       (10) Super8K
  119.                       (11) Super8K/Batch
  120.                       (12) Super8K-G
  121.                       (13) Super8K-G/Batch
  122.                       (14) K9Xmodem
  123.                       (15) K9Xmodem/Batch
  124.                       (16) Cmodem
  125.                       (17) Cmodem/Batch
  126.                       (18) WXmodem
  127.                       (19) WXmodem/Batch
  128.                       (20) Tmodem/Batch
  129.                 NEW!  (21) HSlink/(BI-DIRECTIONAL!---REGISTRATION REQUIRED!)
  130.                       (22) Nmodem
  131.                       (23) Tasy/Batch (REGISTRATION REQUIRED!)
  132.                       (24) Megalink/batch
  133.                       (25) Hyperprotocol/CRC
  134.                       (26) Hyperprotocol/Checksum
  135.  
  136.  
  137.                            *INSTALLATION*
  138.  
  139.  
  140. XFR57.ZIP contains five files;
  141.  
  142.                                 TRANSFER.EXE
  143.                                 TRANSFER.DOC
  144.                                 TRANSCFG.EXE
  145.                                 MAKBATCH.EXE
  146.                                 MAILER
  147.  
  148. On some Bulletin Boards, the files may be contained in XFR57.LZH,
  149. XFR57.ARC, or XFR57.PAK.
  150.  
  151.  
  152.  
  153. TRANSFER.EXE requires the following files to operate;
  154.  
  155. DSZ.COM (or DSZ.EXE) * (Required for Protocols #4-#6, #9) See par. 2
  156. SUPERK.COM * (Required for Protocols #1-#3, #10-#19)
  157. SUPERK.000 * (Comes w/SUPERK.COM) (Required for Protocols #1-#3, #10-#19)
  158. JBATCH.COM * (Required for Protocols #7, #8)
  159. JBA.COM    * (Required for Protocols #7, #8)
  160. TMODEM.EXE * (Required for Protocol #20)
  161. HSLINK.EXE * (Required for Protocol #21) *(REGISTRATION REQUIRED)
  162. NMODEM.EXE * (Required for Protocol #22)
  163. TASY.EXE   * (Required for Protocol #23) *(REGISTRATION REQUIRED)
  164. CMODEM.EXE * (Comes w/SUPERK.COM) (Required for Protocols #16, #17)
  165. MLINK.EXE  * (Required for Protocol #24)
  166. HYPERP.EXE * (Required for Protocols #25, #26)
  167. TRANSFER.EXE
  168. TRANSFER.BAT (Created by TRANSCFG.EXE)
  169. TRANSFER.CFG (Created by TRANSCFG.EXE)
  170. BATCHFLE     (Optional. Created by MAKBATCH.EXE)
  171. AUTHORIZ     (Optional. Needed to unlock special features)
  172.  
  173. *=USER SUPPLIED!
  174.  
  175.  
  176.                            VERY IMPORTANT---READ!!!
  177.  
  178.  
  179. The TRANSFER.EXE program needs to be able to locate the TRANSFER.CFG file
  180. in order to operate. TRANSCFG.EXE automatically creates a batch file named
  181. TRANSFER.BAT, and places it in the root directory. This batch file
  182. automatically changes the drive and directory to the location of the
  183. TRANSFER.EXE and TRANSFER.CFG files, which must exist in the SAME directory.
  184. All the transfer protocol files may exist in ONE separate directory. If
  185. SUPERK.COM and SUPERK.000 do not exist in the same directory as TRANSFER,
  186. then SUPERK.COM must be configured so that it can find its overlay file,
  187. SUPERK.000. To do this, type SUPERK @, which will bring SUPERK into the
  188. Configuration Mode, and then specify both the "wrkpath" to SUPERK.COM and the
  189. "Ovlpath" to SUPERK.000. They must BOTH be set to point to the directory where
  190. the SUPERK.COM and other protocol files reside. If the directory is named
  191. "FILES", then SUPERK expects the two paths to be shown in the following
  192.  format;
  193.  
  194.  
  195.                               C:\FILES\
  196.  
  197.  
  198. Note that when running TRANSCFG.EXE, the path to the above directory
  199. must be entered in the following format;
  200.  
  201.  
  202.                               C:\FILES  (NO ending backslash!!!)
  203.  
  204.  
  205. The same rule applies to JBATCH.COM, which must be able to locate the JBA.COM
  206. file. Type JBATCH @, and specify the path to JBA.COM using the same format
  207. as above.
  208.  
  209.  
  210.  
  211. NOTE:To take FULL advantage of the features of the user-supplied protocol
  212.      files, ALWAYS use REGISTERED versions of these files!!!!!!!
  213.  
  214.      UNREGISTERED versions of NMODEM will N-O-T support file transfers
  215.      outside of the directory that NMODEM resides in!
  216.  
  217.      UNREGISTERED versions of TMODEM do NOT support batch downloading of
  218.      more than ONE file. If you requst more than one file, only the first
  219.      file requested will be sent!
  220.  
  221.      When uploading in Cmodem, if the file is located in the root directory,
  222.      it must be entered as;
  223.  
  224.  
  225.                              C:\\FILENAME
  226.  
  227.                      Yes, TWO backslashes are used!
  228.  
  229.  
  230.      If however, the file is located in the directory C:\TEST\, then it must be
  231.      entered as;
  232.  
  233.  
  234.                              C:\TEST\FILENAME
  235.  
  236.  
  237.      A-L-W-A-Y-S READ THE DOCUMENTATION FOR THE PROTOCOL DRIVER YOU ARE USING,
  238.      IN ORDER TO KNOW ITS LIMITATIONS!
  239.  
  240.  
  241.  
  242. The TRANSFER.CFG file is created by using the TRANSCFG.EXE configuration
  243. program. To run the program, simply type "TRANSCFG" and enter the requested
  244. information. The configuration program creates the configuration file, named
  245. TRANSFER.CFG, which MUST be present for TRANSFER to operate, as well as
  246. TRANSFER.BAT, which is placed in the root directory of the drive where the
  247. TRANSFER files reside.
  248.  
  249.  
  250. If the download directory is named FILES, and is a subdirectory of a directory
  251. named PCPLUS, it should be entered in the TRANSCFG program as;
  252.  
  253.                                 C:\PCPLUS\FILES
  254.  
  255. If the DOWNLOAD directory is a subdirectory of the root directory, it
  256. should be entered as;
  257.  
  258.                                 C:\FILES
  259.  
  260. If the DOWNLOAD directory is the root directory, simply enter the drive
  261. letter followed by a colon;
  262.  
  263.                                 C:
  264.  
  265.  
  266. Do NOT enter it as;
  267.  
  268.                                 C:\
  269.  
  270.  
  271. The above rules also apply for specifying the location of the protocol files,
  272. and the location of the TRANSFER files.
  273.  
  274.  
  275.  
  276.                   ************** IMPORTANT **************
  277.  
  278. TRANSFER.EXE WILL AUTOMATICALLY CHECK FOR THE PRESENCE OF THE NECESSARY
  279. PROTOCOL FILES. IT WILL CHECK FOR BOTH THE COM AND EXE VERSIONS OF THE SAME
  280. FILES. IT WILL ALSO CHECK FOR NECESSARY SUPPORTING FILES. IF THE REQUIRED
  281. FILES FOR A GIVEN PROTOCOL ARE NOT PRESENT IN THE DIRECTORY INDICATED IN THE
  282. CONFIGURATION FILE, THEN THE LISTING OF THAT PROTOCOL IN THE MENU WILL BE
  283. BLANKED-OUT! KEEP IN MIND THAT IF AN ATTEMPT IS MADE TO SELECT ANY OF THE
  284. LOCKED-OUT PROTOCOLS, A MESSAGE WILL APPEAR, INFORMING THE USER THAT THE
  285. REQUIRED FILES ARE NOT PRESENT IN THE SPECIFIED DIRECTORY, AND TRANSFER WILL
  286. ABORT!
  287.  
  288.  
  289. If it is desired to operate in the "TEXTFILE" mode, listing files to be
  290. uploaded in a textfile named BATCHFLE, then BATCHFLE needs to be created by
  291. running the MAKBATCH.EXE program. To run this program, simply type "MAKBATCH"
  292. and follow the instructions. This will AUTOMATICALLY cause the file BATCHFLE to
  293. be created, conforming to the following format;
  294.  
  295.  
  296.          <full path>\FILENAME1
  297.          <full path>\FILENAME2
  298.                     .
  299.                     .
  300.                     .
  301.          <full path>\FILENAMEn
  302.  
  303.  
  304.  
  305.  
  306. If TRANSFER is configured to operate in the "TEXTFILE" mode, rather than the
  307. "MANUAL" mode, then if a batch protocol is chosen and (U)pload is selected,
  308. file transfer will AUTOMATICALLY proceed, the files being chosen from the
  309. listing in BATCHFLE.
  310.  
  311.  
  312.  
  313.  
  314.         Written by Steve Lewis for the  IBM PC using DOS 2.0 or
  315.         later, including DOS 5.0
  316.  
  317.         TRANSFER is supplied for personal, private use. Feel free to
  318.         distribute TRANSFER given these restrictions:
  319.  
  320.           o  the program shall be supplied in its original,
  321.              unmodified form, which includes this documentation;
  322.  
  323.           o  no fee is charged.
  324.  
  325.           o  commercial use is prohibited, except when operated with
  326.              a legal copy of AUTHORIZ.
  327.  
  328.           o  the program may not be included - or bundled - with
  329.              other goods or services. Exceptions may be granted
  330.              upon written request only.
  331.  
  332.         If you are using TRANSFER and find it of value, you are urged
  333.         to register it by sending $15 to the address shown below. In return
  334.         you will receive a copy of AUTHORIZ, containing your personal serial
  335.         number. An order form, entitled "MAILER", is enclosed for your
  336.         convenience.
  337.  
  338.  
  339.         Please make checks payable to:
  340.  
  341.                                  Steve Lewis
  342.                                  405 South Sunnyvale Ave.
  343.                                  #210
  344.                                  Sunnyvale, CA 94086
  345.  
  346.  
  347.  
  348.                          Voice: (415) 469-6623