home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / vol168 / readthis.1st < prev    next >
Encoding:
Text File  |  1984-05-30  |  8.1 KB  |  234 lines
  1.           PLEASE READ THIS FILE FIRST BEFORE YOU PROCEED
  2.  
  3.     
  4.     We have assembled all current overlays and other information
  5. on MDM727 on Volumes 168, 169 and 170 together with a completely separate
  6. communication program, COMM725. Both of these programs are excellent
  7. and one or both should suit your requirements.
  8.  
  9.         For both space and ease of use reasons, we have removed these
  10. files from the .LBR format.  We have had to leave them squeezed, but
  11. have included the current wildcard version of unsqueeze.
  12.  
  13.     In most cases to assemble MDM727 you unsqueeze the overlay file
  14. for your computer and edit in any changes called for by the file. All of
  15. these changes are clearly explained in the overlay files. Also in the 
  16. overlay file are instructions on how to assemble the file. COMM7 is 
  17. assembles with LASM.COM, which is provided.
  18.  
  19.     NOTE: Modem 727 grew in size from the earlier versions to 73
  20. sectors. Some of the overlays call for a smaller "SAVE." Please read the
  21. note at the end of this file.
  22.  
  23.     As part of this memorandum we have included the file note on the
  24. additional size and the update note explaining the function key addition.
  25. Please read them before you proceed.
  26.  
  27.                                                  SIG/M  
  28.  
  29. --------------------------------------------------------------------------
  30.  
  31. TOPIC:    MDM727.ASM MODEM PROGRAM
  32.  
  33. FROM :    IRV HOFF W6FFC
  34.  
  35. DATE :    03 MAR 84
  36.  
  37.  
  38.     NOTE:    This program when assembled is 73 sectors
  39.         long.  Use this figure when merging the
  40.         appropriate overlay file for your computer
  41.         via DDT, etc.  (Most of the overlays were
  42.         written when MDM7xx.COM was only 66 sectors
  43.         and the example included in each says to
  44.         store 66 sectors.)  For MDM727 use:
  45.  
  46.             B>SAVE 73 MDM727.COM
  47.  
  48.     NOTE:    Use M7FNK.COM to easily and quickly change
  49.         any of the 10 function key assignments.  You
  50.         can read the M7FNK.DOC file for additional
  51.         information.  (by Sigi Kluger.)
  52.  
  53.     NOTE:    M7LIB.COM is a rapid and surprisingly easy
  54.         way to quickly change any entries in the
  55.         phone number library.  See M7LIB.DOC if
  56.         instructions are needed.  M7NM-6.ASM is
  57.         necessary for setting or altering numbers
  58.         for 'SPRINT', 'MCI', etc.  It would also
  59.         be better if making a lot of changes such
  60.         as adding or deleting '1-' required for
  61.         long distance dialing in some areas.
  62.         
  63.     NOTE:    If using the phone number overlay to change
  64.         the phone library numbers, be sure to use:
  65.  
  66.                  M7NM-6.ASM
  67.  
  68.         (Previous versions of M7NM will not work with
  69.         this new version, as the phone number library
  70.         now contains 36 numbers (A-Z as usual plus 0-9)
  71.         rather than the 26 in versions prior to MDM722.)
  72.  
  73.      Most users will not need the lengthy (162k) source code at all.
  74.      Just get MDM727.COM and then check one of the associated over-
  75.      lay programs to obtain the overlay for your particular computer.
  76.      Merge that with MDM727.COM according to the instructions near
  77.      the start of the overlay file, using DDT.COM, etc.  (See above
  78.      note relative to saving 73 sectors.  STAT.COM would then show
  79.      146 records for 20k.)
  80.  
  81.      The following bytes can be changed easily with DDT, then SAVE 73
  82.  
  83.     0DFEH  -  HEXSHOW 00 = do not show hex record count
  84.               FF = show both hex and decimal count
  85.     0DFFH  -  SAVSIZ  20 = 4k file transfer buffer size
  86.                    (see table below for other options)
  87.     0E00H  -  NUMBLIB (start of telephone number library)
  88.  
  89.      To change the file transfer buffer size via DDT, change byte 0DFFH:
  90.  
  91.         10   (hex)   =   16 records   =   2k
  92.         20   (hex)   =   32 records   =   4k
  93.         40   (hex)   =   64 records   =   8K
  94.         60   (hex)   =   96 records   =  12k
  95.         80   (hex)   =  128 records   =  16k
  96.  
  97.                 - Irv Hoff
  98. RECENT CHANGES:
  99. --------------
  100.  
  101. (READ THE UPDATE HISTORY IN MDM727.ASM FOR MORE DETAILED INFORMATION)
  102.  
  103. MDM727 - function key character shown in menu.  Typing that character
  104.      on command line shows all function key definitions, providing
  105.      more versatility and ease in using the function keys.  Fixed
  106.      the dialing routine so phone library lines from (0-9) can now
  107.      redial and continuously redial properly.
  108.  
  109. MDM726 - 'T' no longer needed to return to terminal mode after a file
  110.      transfer, i.e., 'RT' or 'ST' no longer used, just 'R' or 'S'.
  111.      Exit routine changed to enable returning to CP/M even though
  112.      incoming characters are still arriving.
  113.  
  114. MDM725 - function key character can be used now even if it is a control
  115.      character and local character required before control character.
  116.      ACKNAK permanently set to robust mode.  Option permits a retry
  117.      for TYM-SHAR mainframes not using XMODEM, if set 'NO'.
  118.  
  119. MDM724 - added 10 function keys for auto-typing preselected messages
  120.  
  121. MDM723 - alphabetizes the phone library vertically for:
  122.          'CAL' - used with auto-dial modems including PMMI
  123.      'NUM' - used with manually-dialed modems
  124.  
  125. MDM722 - phone number library now has 36 entries rather than 26 (has
  126.      A-Z as usual plus 0-9).  Better supports single-digit result
  127.      codes for the Anchor Mark XII modem as well as Hayes and USR.
  128.  
  129. MDM721 - makes it easier to abort an auto-dial call with CTL-X.
  130.  
  131. MDM720 - changed from BIOS to BDOS call to run the printer.
  132.  
  133. MDM719 - modest changes, PMMI pulse dialing set faster.
  134.  
  135. MDM718 - now supports the Anchor Mark XII modem.  Buffer size for ASCII
  136.      capture set for 16k.  Buffer size for file transfers adjustable
  137.      from 1 sector to 16k.  (Allows for slow floppy disk systems so
  138.      XMODEM does not show a timeout error.)
  139.  
  140. MDM717 - Log-on now works properly on main frames that echo characters
  141.       with parity set.
  142.  
  143. MDM716 - Robust addition to minimize problems due to intermittent noise.
  144.      Gives added protection against timeouts on mainframes.  Batch
  145.      mode transfer improved.
  146.  
  147. CREDITS:
  148. -------
  149. MDM727 - Irv Hoff
  150. MDM726 - Irv Hoff
  151. MDM725 - Irv Hoff
  152. MDM724 - Sigi Kluger
  153. MDM723 - Irv Hoff with routine developed by Ken Lovett
  154. MDM722 - Bill Brehm with routines developed by Fred Viles
  155. MDM721 - Bill Brehm
  156. MDM720 - Irv Hoff
  157. MDM719 - Keith Petersen
  158. MDM718 - Irv Hoff with routine developed by Fred Viles
  159. MDM717 - Irv Hoff
  160. MDM716 - Bob Plouffe
  161.  
  162. ------------------------------------------------------------------------
  163. MDM7 update information            02/17/84
  164.  
  165. Sigi Kluger, El Paso TX  02-17-84
  166.  
  167. Being used to a great non-public modem program with a number of function
  168. keys, I decided to add ten function keys to MDM7.  Great for things you
  169. do most, like DIR *.* $U0AD, or XMODEM S, or you could even save your
  170. name in a function key for logon.
  171.  
  172.  
  173. 1. HOW TO ACCESS (transmit) THE FUNCTION KEYS.
  174.  
  175. You transmit the contents of a function key by typing first the INTERCEPT
  176.  
  177. CHARACTER, then a digit 0..9.  The INTERCEPT CHARACTER is an unique char-
  178. acter which tells MDM7 that a function key command follows. The INTERCEPT
  179. CHARACTER is set to ^ (circumflex).  It could as easily be set to CTL-A
  180. or 'escape', for example.  In the distribution version, the following
  181. keys are defined:
  182.  
  183. ^A0    DIR <cr>
  184. ^A1    DIR *.* $U0AD <cr>
  185. ^A2    XMODEM S
  186. ^A3    XMODEM R
  187. ^A4    BYE <cr>
  188. ^A5    CBBS <cr>
  189.  
  190. (Function keys 2 and 3 have no trailing CR).
  191.  
  192.  
  193. 2. HOW MUCH ROOM?
  194.  
  195. A total of 256 bytes are reserved for the function key definition.  Each
  196. definition takes up the number of bytes in the string, PLUS 2.  Note that
  197. you must not enclose any control characters in the definitions (CR is
  198. allowed and is optional).
  199.  
  200.  
  201. 3. HOW TO CHANGE THE FUNCTION KEYS
  202.  
  203. In order to not increase the size of MDM7 considerably, I have written
  204. the M7FNK utility.  M7FNK.COM is virtually self-explanatory and it is
  205. covered by its own short DOC file.  (M7FNK.COM v1.10 is current.)
  206.  
  207.  
  208. 4. WHAT WILL NOT WORK
  209.  
  210. Do not attempt to use DDT to modify the function keys.  Especially, do
  211. not force any control characters into the definitions.  There can only
  212. be three non-printing characters in each definition, the start byte,
  213. an optional CR at the end, and the end byte.
  214.  
  215.  
  216. 5. DEFINITION FORMAT
  217.  
  218. This is an example of the definition for function key 1:
  219.  
  220. DB    1,'THIS IS A FUNCTION KEY',CR,0
  221.     |        |          |
  222.     |        |          |__stop character
  223.     |        |________________key definition plus CR
  224.     |________________________________start character
  225.  
  226. Each key definition string starts with the key number in binary.  The
  227. function key processor searches for that number.  Those numbers must be
  228. unique throughout the key definitions.  EMPTY key definitions are en-
  229. coded thusly:
  230.  
  231. DB    9,0        ;empty function key #9
  232.  
  233.  
  234.