home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / robot-pd / 23103.ZIP / 23103B.DSK / ukm72b.doc < prev   
Text File  |  1997-12-18  |  9KB  |  191 lines
  1.  
  2.  
  3.                                      UKM72B
  4.  
  5.                         A SOFTWARE COMMUNICATIONS PROGRAM
  6.                                   FOR  CP/M-80.
  7.  
  8.                            By David R. Back. May 1983
  9.        Documentation altered by Stuart Williams for Version 2.B June 1986
  10.  
  11.  
  12.      This program, UKM72B has been adapted from MODEM7 for use in the UK.  MODEM
  13. was originally written in 1977 by Ward Christensen.  In  1980  Mark  Zeiger  and
  14. James Mills added the terminal file, batch mode and a great many  bugs,  at  the
  15. same time removed Wards comments and left the file, now called MODEM7 in a  very
  16. untidy state. The CRC checks were added by Paul  Hansknecht  in  1981  and  work
  17. well.
  18.  
  19.      MODEM7 was written principally for the American PMMI modem and although  it
  20. generally works, it contains many bugs and  problem  areas  and  is  very  modem
  21. dependent. As PMMI modems must be as rare as hen's teeth in the UK,  David  Back
  22. removed all of the modem dependent features and at the same time removed a great
  23. many bugs mainly from the Terminal mode. Further  he  tidied  up  the  file  and
  24. combined Terminal and Echo modes so that you may now echo whilst  retaining  all
  25. of the Terminal mode facilities. In spite of the appearance of the  Menu,  which
  26. is more complete than that of MODEM7, no functions useful in  the  UK  has  been
  27. omitted, indeed many of MODEM7's functions has been improved.  In  version  2.B,
  28. another option, DSB, or Dual Split Baud rate has been added, so that you may use
  29. modems that send and receive at different speeds, ie 1200/75  baud  as  used  in
  30. Prestel. You must first set up the baud rate of  the  RS232C  from  CP/M  before
  31. running UKM72B. You can then adjust the program using  the  DSB  toggle  between
  32. high and low speed transmit and receive.
  33.  
  34. 1) You may use UKM72B direct from a CP/M command line without any restrictions.
  35.  
  36. 2) All terminal file writing and closing has been made completely  automatic  so
  37. that it is now impossible to forget to write and close the file.
  38.  
  39. 3) You may return from Terminal mode to the main menu and perform any  allowable
  40. option, including Send and/or Receive files whilst retaining  an  open  terminal
  41. file.
  42.  
  43. 4) You may return to the same terminal file from menu level simply  by  entering
  44. T, both echo and filesave will be on or off as you left them.
  45.  
  46. 5) You may start a  new  terminal  file  by  exiting  to  MENU  level  and  then
  47. re-entering terminal mode with another, or even the same, filename.
  48.  
  49. 6) Automatic terminal file save has been added. If a terminal file is  open  and
  50. terminal file save is off then it can be remotely turned on by receipt of CTRL R
  51. and off by receipt of CTRL T.
  52.  
  53.      The file sending and receiving  protocols  of  UKM72B  are  exactly  as  in
  54. MODEM765. They are compatible with all of the MODEMX program series back  to  at
  55. least as far as MODEM4. The protocols work well, are relatively bug free and are
  56. widely used but do has some snags which will sometimes show up  on  a  bad  line
  57. David Back has documented them in the form of  flow  charts  but  they  are  too
  58. complex to present here.
  59.  
  60. UKM72B will work equally well with CP/M 1.4, CP/M 2.2 and CP/M 3.1 (Plus)
  61.  
  62.      Hopefully, the command syntax is self evident from the built in menus. Type
  63. M <CR> to get a menu  display  when  the  program  begins  in  expert  mode,  as
  64. supplied.
  65.  
  66.      Although the non batch mode of file transfer  is  redundant,  it  has  been
  67. retained for compatibility with some Bulletin Boards and because the protocol is
  68. simpler and more suitable than batch mode for  transmitting  files  over  a  non
  69. duplex link such as a radio channel. Note that batch mode is now  the  norm  and
  70. you have to include secondary option N to get non batch operation.
  71.  
  72.      The quiet mode is retained as original and is intended for situations where
  73. UKM72B is running on a remote CP/M system and being used remotely  for  software
  74. upload or download.
  75.  
  76.      In order to upload or download files from a remote system using UKM72B S or
  77. R modes it is necessary first to contact and sign on  with  the  remote  in  the
  78. normal way using Terminal mode. Assuming that  the  remote  station  has  UKM72B
  79. available it can then be given the command
  80.  
  81. UKM72B SQ afn list
  82. or UKM72B RQ
  83.  
  84. Having done this, you must then use ESC to return to main menu  level  and  give
  85. the RT or ST command as  appropriate.  File  transfer  will  commence  and  when
  86. complete the you will finish up in Terminal mode  and  the  remote  will  be  in
  87. UKM72B at main menu level. Thus further transfers may be initiated  or  the  CPM
  88. command may be given to return the remote to CP/M command level.
  89.  
  90.                   EXPLANATION  OF COMMAND SYNTAX AT MENU LEVEL
  91.  
  92.      The menu indicates a general command syntax which applies to  all  commands
  93. but as syntax varies somewhat from one command to another, the explanation below
  94. may be useful. Note that entry of CTRL X at either end of the communication link
  95. will abort the file transfer in progress - one way or another. (This feature has
  96. been altered slightly to make it more user friendly  in  version  2.B  and  will
  97. usually work well).
  98.  
  99. SEND FILES IN BATCH MODE, primaryoption S
  100.  
  101. Either single or multiple files may be sent with one  command  by  use  of  this
  102. option.
  103.  
  104. The Sending command is:
  105.  
  106.            S[Q][S|R|V][T]  [drive:]afn [ [drive:]afn]
  107.  
  108. i.e. you may use a list of ambiguous filenames separated by spaces.  Files  with
  109. the $SYS attribute set, i.e. system files, cannot  be  sent.  If  the  receiving
  110. station is not using UKM72B you must tell it that you are  going  to  use  Batch
  111. Mode.
  112.  
  113. RECEIVE FILES IN BATCH MODE,  primaryoption R
  114.  
  115.      Filenames are transmitted along with the file and used to make new files at
  116. the receiving station. If a file of the same name already  exists  the  existing
  117. file will be renamed .BAK
  118.  
  119. The Receiving command is:
  120.  
  121.                     R[Q][S|R|V][T]  [drive:]
  122.  
  123. If a drive is not specified then files will be directed to the default drive.
  124.  
  125. TERMINAL MODE, primaryoption  T
  126.  
  127. To enter Terminal mode:
  128.  
  129.                 T  [drive:][unambiguousfilename]
  130.  
  131. In order to start a terminal file, a filename must be  specified  when  entering
  132. terminal mode. Exit from terminal mode to Menu level (using ESC) does not close
  133. an existing terminal file. If a terminal file is open then re-entry to  terminal
  134. mode without a filename will allow its continued use.  Entry  to  terminal  mode
  135. with a filename specified will close the current terminal file, if one is  open,
  136. and open a new file with the specified name.
  137.  
  138. When a return is made to CP/M command level by using the CPM primary option, the
  139. current terminal file will be closed. Do not exit to CP/M by re-booting else  an
  140. open terminal file will not be closed and data will be lost.
  141.  
  142. The terminal menu may be displayed after entry to terminal mode  by  typing  ^D.
  143. When a terminal file is open, its name will be displayed in the  menu.  No  name
  144. means no file and data cannot then be saved.
  145.  
  146. The Computer  mode  may  be  entered  by  typing  CTRL C.  Only  one  end  of  a
  147. communication link may be in Computer mode at any one  time.  In  Computer  mode
  148. characters received via  the  Modem  are  echoed  back  to  the  originator  and
  149. characters sent are echoed to the local console. Line  feeds  are  automatically
  150. appended to carriage returns. Both terminal file save and file transfer with the
  151. ^T option work in Computer mode as they do in Terminal mode.
  152.  
  153. Remaining features of the terminal menu are self evident.
  154.  
  155. DIRECT ENTRY FROM CP/M COMMAND LEVEL
  156.  
  157.      Any of the above commands may be given to UKM72B direct from  CP/M  command
  158. level. For example
  159.                     A>UKM72B ST B:*.COM IQ*.ASM
  160. will transmit all .COM files from drive B: and all .ASM files which  begin  with
  161. IQ from drive A: and finish up in Terminal mode. There will be no terminal file.
  162.                     A>UKM72B T B:TFILE
  163. will open terminal file B:TFILE and enter terminal mode.
  164.  
  165. Both M and X commands may also be executed direct from CP/M command level.
  166.  
  167. NON BATCH MODE,  secondaryoption N
  168.  
  169.      This mode has been retained for compatibility with older software  used  on
  170. some Bulletin Boards, ie TBBS type systems. One unambiguous filename is required
  171. for both Send and Receive, i.e. only one file may be transferred at a time.
  172.  
  173. Send a file, non batch mode:
  174.  
  175.            SN[Q][S|R|V][T] [drive:]unambiguousfilename
  176.  
  177. Receive a file, non batch mode:
  178.  
  179.            RN[Q][S|R|V][T] [drive:]unambiguousfilename
  180.  
  181.  
  182. Please Note: all commands enclosed in [square] brackets are optional.  Refer  to
  183. your RS232C manual and your system manual for details on  how  to  set  up  your
  184. interface for the baud rate required to suit your modem, as  this  is  necessary
  185. before running UKM72B, and depends also on which CP/M you are using. Thanks  are
  186. due to Pete Franchi, Sysop of the TUG 2 Bulletin  Board  on  021  444  1484  for
  187. passing on  UKM72B  via  his  board,  and  to  Steve  Froeschke  who  apparently
  188. downloaded it originally from Compuserve in the USA and passed it  on  to  Pete.
  189. UKM72B is in the Public Domain and copies may be freely made, but it must not be
  190. sold. Stuart Williams, Secretary, West Midlands Amstrad User Group, June 1986.
  191. ╥ ─      press ENTER to return to textGφ[!╦808(╦#╦0±╖╔:_»WφZ(8≥╖φR7╔: