home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / zmodem / runzy.arc / RUNZY.TXT < prev   
Text File  |  1988-05-13  |  5KB  |  131 lines
  1.                                                              RUNZY.DOC
  2.  
  3. RUNZY.COM:                    *** ORIGIN ***
  4.  
  5. Developed using Borland's Turbo-C (c) v1.5, by Mark Stingley of Morgan
  6. Creek Computing, P.O. Box 308, Colorado City, Texas 79512.  Phone:
  7. (915) 728-5769 8AM-5PM (MCC BBS hours M-F 5P-2A, S-S 8A-2A, featuring
  8. a Smart Conference.  300/1200/2400 baud, 8-N-1.  BBS software is, of
  9. course, PC Board (c) v12.1, from Clark Development Corp.
  10.  
  11.  
  12.                               *** PURPOSE ***
  13.  
  14. RUNZY is a program that will drive the venerable "DSZ.COM" program
  15. from Omen Technology, Inc.  DSZ (c) features Forzberg's Zmodem, true
  16. Ymodem protocols.
  17.  
  18.  
  19. RUNZY (for RUN Z - Y) replaces the normal batch program drivers, which
  20. won't run under the DOS window in Smart Communications.  With RUNZY, it
  21. is easy to take advantage of these fast and accurate protocols, which
  22. are a considerable improvement over the Xmodem (checksum) with which
  23. the Smart Communications module is afflicted.
  24.  
  25.  
  26.                               *** DISCLAIMER ***
  27.  
  28. RUNZY is offered into the public domain for anyone who wishes to use
  29. it, since I wrote it, and that's the way I want it.  The only condition
  30. is that your use of the program be considered a release for the author
  31. of any and all liability.  It works on my fine equipment, so I don't
  32. think you'll have any trouble, though.  Still, there is no warranty ex-
  33. pressed or implied as to RUNZY's suitability for your uses.
  34.  
  35.  
  36. Be advised that the DSZ program is the property and trademark of Omen
  37. Technology, and they require a nominal registration fee.  Details re-
  38. garding registration of DSZ are in the DSZ.ARC file.  Honestly, since
  39. DSZ will shorten on-line time, the slight registration fee is well
  40. worth it.
  41.  
  42.  
  43.                               *** OPERATION ***
  44.  
  45. By now, you've gathered that DSZ is required for Zmodem and Ymodem op-
  46. eration with RUNZY.
  47.  
  48.  
  49. Here's how it works:
  50.  
  51. Normally, you can't call DSZ from the DOS window (Ctrl-O), since you
  52. can't pass parameters needed by the program, and batch files won't ex-
  53. ecute.  You would type in the long command line for DSZ every time you
  54. use it, but the host computer would probably timeout by the time you
  55. finished.  Since RUNZY is a menu driven .COM program, it is easily ex-
  56. ecuted from the DOS window, and then RUNZY will pass the necessary pa-
  57. rameters to DSZ for file transfer (upload or download).
  58.  
  59. All you have to do is unarchive RUNZY.ARC and DSZ.ARC, and place the
  60. program files in your "Smart\Comm" directory.  The routines should run
  61. OK from any "pathed" directory, though.  Another nice feature of RUNZY
  62. is that it should also run DSZ.EXE (yes, there's one of those too; for
  63. less compatible PC's).
  64.  
  65. Operating steps are like so:
  66.  
  67.                     1.  Make sure DOS path and directory are set.
  68.                     2.  Run Smart Communications.
  69.                     3.  Tell host computer to initiate down/upload.
  70.                     4.  Press F-3 and Crtl-O.
  71.                     5.  Type RUNZY <Enter>.
  72.                     6.  Follow the menu prompts accordingly.
  73.                     7.  After transfer, type Exit <Enter> then F-3.
  74.                     8.  You will now be back Online.
  75.  
  76.           or
  77.  
  78.                     build a comm project that says
  79.  
  80.                     " COMMAND /C RUNZY "
  81.  
  82.                     and execute it from the online screen (F-8)
  83.                     after telling the host computer to initiate 
  84.                     a file transfer.
  85.  
  86. IMPORTANT:  Make sure DSZ.COM and RUNZY.COM are in a pathed directory,
  87. and you should change to the directory containing your upload files to
  88. avoid having to type pathnames.  Change the directory BEFORE running
  89. Smart.  Also, if you aren't using COM1, you will need to issue the DOS
  90. SET command BEFORE starting Smart Communications.
  91.  
  92. While online with Smart Communications, simply get the Host computer
  93. prepared for your Y or Z protocol transfer, then immediately press
  94. Ctrl-O for the DOS window.  Type "RUNZY" then press enter.  The rest is
  95. menu prompted.
  96.  
  97.  
  98.                               *** INTERNALS ***
  99.  
  100. RUNZY does everything through TURBO-C DOS call conventions.  The actual
  101. function used is EXEC, with the -p switch set, so DOS will look for
  102. DSZ.COM or DSZ.EXE in the current directory, then the entire path. 
  103. When uploading a file, try to make sure it is in the logged, or cur-
  104. rent, directory so you don't have to type out a long path along with
  105. the filename.
  106.  
  107. RUNZY ain't fancy.  It does no error checking, and when transmitting a
  108. file, it will pass to DSZ whatever you enter as a filename.  DSZ will
  109. display progress and termination codes.
  110.  
  111. The parameters passed to DSZ are as follows:
  112.  
  113.      buffers are set = pB4096
  114.      handshake is set = both
  115.      serial port is COM1: (default)  For COM2-4, "SET DSZPORT=?"
  116.                                         from DOS. (See DSZ.DOC.)
  117.  
  118. These settings should be satisfactory for most systems.  As a matter of
  119. fact, RUNZY should enable operation of DSZ within Procomm or other pro-
  120. grams.
  121.  
  122.  
  123.                               *** SOURCE CODE ***
  124.  
  125. The C language source code for RUNZY can be obtained by sending a
  126. stamped, self-addressed envelope to:
  127.  
  128.      Morgan Creek Computing
  129.      (RUNZY offer)
  130.      P. O. Box 308
  131.      Colorado City, TX 79512