home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / modems / modem2 / ukm7.doc < prev    next >
Encoding:
Text File  |  1994-07-13  |  9.1 KB  |  197 lines
  1.                                   UKM7
  2.  
  3.              A SOFTWARE COMMUNICATIONS PROGRAM FOR CP/M-80.
  4.  
  5. UKM7 has been adapted from MODEM7 for use in the UK. MODEM7 was original-
  6. ly written in 1977 by Ward Christensen, principally for the American PMMI 
  7. modem and although it generally works,  many bugs and problem areas  were 
  8. in  evidence.  Being very modem dependent (PMMI modems must be as rare as 
  9. hen's teeth in the UK), David Back has removed all of the modem dependent 
  10. features and at the same time,  cleaned up a great many bugs, mainly from 
  11. the Terminal mode.  Further,  tidying up the file and combining  Terminal 
  12. and  Echo  modes,  so that you may now echo whilst retaining all  of  the 
  13. Terminal mode facilities.  In spite of the appearance of the Menu,  which 
  14. is more complete than that of MODEM7,  no functions useful in the UK have 
  15. been omitted, indeed, many of MODEM7's functions have been improved.
  16.  
  17. 1)   You  may  use  UKM7  direct from a CP/M  command  line  without  any    
  18.      restrictions.
  19.  
  20. 2)   All  terminal  file writing and closing  has  been  made  completely 
  21.      automatic so that it is now impossible to forget to write and  close 
  22.      the file.
  23.  
  24. 3)   You  may return from Terminal mode to the main menu and perform  any
  25.      allowable   option,  including  Send  and/or  Receive  files  whilst
  26.      retaining an open terminal file.
  27.  
  28. 4)   You may return to the same terminal file from menu level  simply  by
  29.      entering  T,  both ECHO and FILESAVE will be ON or OFF as  you  left 
  30.      them.
  31.  
  32. 5)   You may start a new terminal file by exiting to MENU level and  then
  33.      re-entering terminal mode with another, or even the same, filename.
  34.  
  35. 6)   An automatic LOG ON/answerback feature has been added,  activated by
  36.      receipt of a ^E, from the menu level.
  37.  
  38. 7)   Automatic terminal filesave  has been added.  If a terminal file  is
  39.      open and terminal file save is off then it can be remotely turned on
  40.      by receipt of ^R and off by receipt of ^T.
  41.  
  42. 8)   Echo on/off may be toggled whilst in terminal mode. (Control-C)
  43.  
  44. 9)   Printer On/Off toggle via control-P
  45.  
  46. As  UKM7 may be assembled with either ASM or MAC,  there is no  point  in 
  47. retaining  the elaborate patching facilities of the MODEM7  series.  They 
  48. are  still  there in a modified form but a UKM7.SET file is not provided.
  49. There are no modem dependent features in UKM7 and all system dependencies 
  50. are  gathered together at the beginning of the program.  The program  has 
  51. been  patched  with 820 port addresses and initialisation.  Other  simple 
  52. patches are possible, they are commented on in the source file and may be 
  53. altered to taste.
  54.  
  55. The  file sending and receiving protocols of UKM7 are exactly as those in 
  56. MODEM765.  They are compatible with all of the MODEMX program series back 
  57. to at least as far as MODEM4.  The protocols work well,  being relatively 
  58. bug free and are widely used, but does have some snags which will show up 
  59. sometimes on a bad line.  These are documented by David Back in the  form 
  60. of flow charts,  but they are too complex to present here. UKM7 will work 
  61. equally well with CP/M 1.4 or CP/M 2.2.
  62.  
  63. Hopefully,  the  command syntax is self evident from the built in  menus. 
  64. Type  M  followed by a carriage return to get the menu display  when  the 
  65. program begins in expert mode.
  66.  
  67. Although  the non-batch mode of file transfer is redundant,  it has  been 
  68. retained  for  compatibility  with other MODEM programs and  because  the 
  69. protocol  is simpler and more suitable than batch mode  for  transmitting 
  70. files  over  a non-duplex link such as a radio channel.  Note that  batch 
  71. mode  is now the norm and you have to include secondary option N  to  get 
  72. non-batch operation.
  73.  
  74. The quiet mode is retained as original.  This is intended for  situations 
  75. where  UKM7  is  running on a remote CP/M system.  (Suppress  all  system 
  76. messages (don't display the screen).
  77.  
  78. In order to upload or download files from a remote system using UKM7 S or 
  79. R modes,  it is first necessary to contact and sign on with the remote in 
  80. the normal way using the Terminal mode.  Assuming that the remote station 
  81. has UKM7 available, it can then be given the command:
  82.  
  83.             UKM7 SQ afn list          or           UKM7 RQ
  84.  
  85. Having done this, the local must then use ^E to return to main menu level 
  86. and give the RT or ST command as appropriate. File transfer will commence 
  87. and, when complete, the local station will finish up in Terminal mode and 
  88. the remote will be in UKM7 at main menu level.  Thus,  further  transfers 
  89. may be initiated, or the CPM command may be given to return the remote to 
  90. CP/M command level.
  91.  
  92. EXPLANATION OF COMMAND SYNTAX AT MENU LEVEL
  93.  
  94. The  menu  indicates  a  general command  syntax  which  applies  to  all 
  95. commands,  but as syntax varies somewhat from one command to another, the 
  96. explanation  below may be useful.  Note that entry of ^X at either end of 
  97. the communication link will abort the file transfer in progress - one way 
  98. or another.  (This feature has been left exactly as it was found and does 
  99. not work entirely satisfactorily.  An abort protocol needs to be invented 
  100. and the author may work on this for a later issue if nobody else comes up 
  101. with any ideas.)
  102.  
  103. SEND FILES IN BATCH MODE, primaryoption S
  104.  
  105. Either  single  or multiple files may be sent with one command by use  of 
  106. this option.
  107.  
  108. The Sending command is:         S[Q][S|R|V][T] [drive:]afn [ [drive:]afn]
  109.  
  110. i.e. you may use a list of ambiguous filenames separated by spaces. Files 
  111. with the $SYS attribute set,  i.e.  system files,  cannot be sent. If the 
  112. receiving  station is not using UKM7 you must tell it that you are  going 
  113. to use the Batch Mode.
  114.  
  115. RECEIVE FILES IN BATCH MODE, primaryoption R
  116.  
  117. Filenames are transmitted along with the file and used to make new  files 
  118. at  the receiving station.  If a file of the same name already exists the 
  119. existing file will be renamed .BAK
  120.  
  121. The Receiving command is:                         R[Q][S|R|V][T] [drive:]
  122.  
  123. If  the drive is not specified then files will be directed to the default 
  124. drive.
  125.  
  126. TERMINAL MODE, primaryoption T
  127.  
  128. To enter Terminal mode:                   T [drive:][unambiguousfilename]
  129.  
  130. In  order  to start a terminal file,  a filename must be  specified  when 
  131. entering terminal mode.
  132. Exit  from  terminal  mode to Menu level (using ^E) does  not   close  an 
  133. existing terminal file.
  134.  
  135. If  a  terminal  file is open then re-entry to terminal  mode  without  a 
  136. filename will allow its continued use.
  137.  
  138. Entry  to terminal mode with a filename specified will close the  current 
  139. terminal file, if one existed, then open a file with the specified name.
  140.  
  141. When  return is made to the CP/M command level by using the  CPM  primary 
  142. option,  the current terminal file will be closed. Do not exit to CP/M by 
  143. re-booting or else an open terminal file will not be closed and data will 
  144. be lost.
  145.  
  146. The terminal menu may be displayed after entry to terminal mode by typing 
  147. ^D. When a terminal file is open, its name will be displayed in the menu. 
  148. No name means no file and data cannot then be saved.
  149.  
  150. The Computer mode may be entered by typing ^C. Only one end of a communi-
  151. cation  link  may be in the Computer mode at any one  time.  In  Computer 
  152. mode, characters received via the Modem are echoed back to the originator 
  153. and  characters  sent are echoed to the local  console.  Line  feeds  are 
  154. automatically  appended to carriage returns.  Both terminal file save and 
  155. file  transfer  with the ^T option work in Computer mode as  they  do  in 
  156. Terminal mode.
  157.  
  158. Remaining features of the terminal menu are self evident.
  159.  
  160. DIRECT ENTRY FROM CP/M COMMAND LEVEL
  161.  
  162. Any  of  the  above commands may be given to UKM7 direct  from  the  CP/M 
  163. command level. For example:
  164.  
  165. A>UKM7 ST B:*.COM IQ*.ASM
  166.  
  167. will transmit all .COM files from drive B: and all .ASM files which begin 
  168. with  IQ from drive A:  and finish up in Terminal mode.  There will be no 
  169. terminal file.
  170.  
  171. A>UKM7 T B:TFILE
  172.  
  173. will open terminal file B:TFILE and enter terminal mode.
  174.  
  175. Both M and X commands may be executed direct from the CP/M command level.
  176.  
  177. NON BATCH MODE, secondaryoption N
  178.  
  179. This  mode  has been retained for compatibility with  older  versions  of 
  180. MODEMX.  One  unambiguous filename is required for both Send and Receive, 
  181. i.e. only one file may be transferred at a time.
  182.  
  183. Send a file, non batch mode:                 SN[Q][S|R|V][T] [drive:]unfn
  184.  
  185. Receive a file, non batch mode:              RN[Q][S|R|V][T] [drive:]unfn
  186.         
  187. PRACTICAL POINTS
  188.  
  189. The  author  has tried unsuccessfully to provided control such  that  the 
  190. modem  has  always  been  automatically  connected  and  disconnected  at 
  191. appropriate  times.  A manually operated switch on the modem  is  better. 
  192. A manual switch is also preffered for selecting Call or Answer modes  for 
  193. local attended operation. Smartmodems of the Hayes variety have yet to be 
  194. commercially available at reasonable prices in the UK.  This program will 
  195. therefore be of special interest to those users without "smart"
  196. features.
  197.