home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / basic / xfer13.dqc / XFER13.DOC
Encoding:
Text File  |  1985-02-10  |  4.4 KB  |  93 lines
  1.               DOCUMENTATION FOR XFER.BAS PROGRAM
  2.  
  3.              Original program by AL JEWER 11/11/81
  4.             Re-written by Wayne M. Hammerly 11/19/81
  5.                Enhancements added 12/01/81 by wmh
  6.              Version 1.3 released 12/16/81 by wmh
  7.  
  8.                 +++YOU MUST HAVE SENDOUT.COM+++
  9.  
  10. HERE'S THE OLD PROBLEM:
  11.       You are  on your favorite  RCPM  systems and see five or six
  12. files to transfer  to your  system, or  perhaps  you  want to send
  13. a  group  of  programs over there  To reduce  your phone time, you
  14. could prepare a submit file which uses  SENDOUT.COM  and MODEM.COM
  15. to modem over the files automatically. Writing a SUBMIT file takes
  16. a while, and would be VERY  impolite  to tie up the RCPM while you
  17. hack away, editing the file. SYSOPs don't like that kind of thing!
  18.       Well,if you make a SHORT list of the programs you want, then
  19. run XFER.BAS, it will prompt you for  file names & other  commands
  20. for both your's and the Remote system, creating the file  XFER.SUB
  21. containing  all  the  commands  necessary  for the transfer. These
  22. commands would include change logged disks, and user areas.
  23.       Using this utility, you could be back in minutes,transfering
  24. programs with a minimum of delay.
  25.       One word of caution: Unless  you have the permission  of the
  26. SYSOP, please do not transfer a large batch of files, tying up the
  27. phone for hours on end.  I can think  of no better way to wear out
  28. a welcome! Most systems have one hour limits, so plan accordingly.
  29.  
  30. updated commands as of 12/16/81:
  31.         If you are Sending files, you will be  asked if the remote
  32. accepts the 'C' XMODEM option for CRC checking.
  33.         Very few, if any, RCPM  systems will  accept a  'COM' file
  34. A warning message will be issued if you try sending COM files. You
  35. may  eliminate this  feature in the source code to send COM files.
  36.  
  37.                    How to run XFER.BAS:
  38.       Upon running XFER,  you will be asked if you wish to send or
  39. receive, and at what baud  rate.  The  next prompt asks you if you
  40. would like to freeze the options.  Answer  Y (yes) if you want all
  41. transfers to  use the same  modem  options  (O,Q,C, ect.)  and all
  42. files  transfered  to or  from the same disk. The next two prompts
  43. are  self-explanitory.  Choosing  to freeze the options will cause
  44. the  program to  issue  only  the next  two commands listed below.
  45. Choosing  not  to  freeze  the  options  will give  you all of the
  46. following prompts:
  47.  
  48.                     COMMANDS TO THE REMOTE >
  49.  
  50. Answer with either a command to the remote such as moving to a new
  51. disk or user area, or a carriage return (CR) for no command.
  52.  
  53.                            FILENAME >
  54.  
  55. Use  the standard  CP/M format of  FN.FT  as usual.  If  you  need
  56. another  command  to the  remote, such as when changing both drive
  57. and user areas, enter '$$$'  at  the  FILENAME prompt.  This  will
  58. cause the  COMMANDS line to reappear, and you may enter additional
  59. command(s).  If you want  a command to your system, type 'XXX' for
  60. the filename.  Use this comand to to do a  DIR or a MODEM D at the
  61. end of the transfer. Be sure to send the BYE command to the remote
  62. before logging off!  A CR will terminate the program.
  63.  
  64.                           MODEM OPTIONS >
  65.  
  66. Enter any options IN ADDITION TO the mandatory R or S, such as the
  67. 'O' or 'Q' options DO NOT enter an R or S at this prompt!
  68.  
  69.                  YOUR DISK TO SEND/RECEIVE FROM/TO >
  70.  
  71. This is  your disk,  not  the  remote's! If  you  wish  to write or
  72. send from the default disk  of  your system, a carriage return (CR)
  73. will do.  You will now return to the top command.  YOU MUST INCLUDE
  74. A QUOTE!  Type 'B:' to send to or recieve from your drive B.
  75.  
  76. To end,  hit a CR for both the  COMMAND and the FILENAME.   Remember
  77. to  return to the  remote and log off with 'BYE' if it is not a part
  78. of the submit file!
  79.      Run Xfer a number of time for practice before trying it on line.
  80. Look at the XFER.SUB file to see how the process works.
  81.      Happy computing!
  82.  
  83. +++ Notes on compiling XFER.BAS:
  84.         You will see the following line during compilation, ignor it.
  85.  
  86. 0017  0007      300 CLEAR 1000
  87.                     ^ SI
  88.  
  89.         It will  not cause  an error either in assembly or running.
  90.         Using BASCOM 3.21, XFER.COM is 16K.  Editing out all of the
  91. REM statements doesn't seem to cut down the size or the run time.
  92.                                  END
  93.