home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / modem7 / m7fnk.not < prev    next >
Encoding:
Text File  |  1984-03-05  |  2.1 KB  |  70 lines
  1. MDM7 update information            02/17/84
  2.  
  3. Sigi Kluger, El Paso TX  02-17-84
  4.  
  5. Being used to a great non-public modem program with a number of function
  6. keys, I decided to add ten function keys to MDM7.  Great for things you
  7. do most, like DIR *.* $U0AD, or XMODEM S, or you could even save your
  8. name in a function key for logon.
  9.  
  10.  
  11. 1. HOW TO ACCESS (transmit) THE FUNCTION KEYS.
  12.  
  13. You transmit the contents of a function key by typing first the INTERCEPT
  14.  
  15. CHARACTER, then a digit 0..9.  The INTERCEPT CHARACTER is an unique char-
  16. acter which tells MDM7 that a function key command follows. The INTERCEPT
  17. CHARACTER is set to ^ (circumflex).  It could as easily be set to CTL-A
  18. or 'escape', for example.  In the distribution version, the following
  19. keys are defined:
  20.  
  21. ^A0    DIR <cr>
  22. ^A1    DIR *.* $U0AD <cr>
  23. ^A2    XMODEM S
  24. ^A3    XMODEM R
  25. ^A4    BYE <cr>
  26. ^A5    CBBS <cr>
  27.  
  28. (Function keys 2 and 3 have no trailing CR).
  29.  
  30.  
  31. 2. HOW MUCH ROOM?
  32.  
  33. A total of 256 bytes are reserved for the function key definition.  Each
  34. definition takes up the number of bytes in the string, PLUS 2.  Note that
  35. you must not enclose any control characters in the definitions (CR is
  36. allowed and is optional).
  37.  
  38.  
  39. 3. HOW TO CHANGE THE FUNCTION KEYS
  40.  
  41. In order to not increase the size of MDM7 considerably, I have written
  42. the M7FNK utility.  M7FNK.COM is virtually self-explanatory and it is
  43. covered by its own short DOC file.  (M7FNK.COM v1.10 is current.)
  44.  
  45.  
  46. 4. WHAT WILL NOT WORK
  47.  
  48. Do not attempt to use DDT to modify the function keys.  Especially, do
  49. not force any control characters into the definitions.  There can only
  50. be three non-printing characters in each definition, the start byte,
  51. an optional CR at the end, and the end byte.
  52.  
  53.  
  54. 5. DEFINITION FORMAT
  55.  
  56. This is an example of the definition for function key 1:
  57.  
  58. DB    1,'THIS IS A FUNCTION KEY',CR,0
  59.     |        |          |
  60.     |        |          |__stop character
  61.     |        |________________key definition plus CR
  62.     |________________________________start character
  63.  
  64. Each key definition string starts with the key number in binary.  The
  65. function key processor searches for that number.  Those numbers must be
  66. unique throughout the key definitions.  EMPTY key definitions are en-
  67. coded thusly:
  68.  
  69. DB    9,0        ;empty function key #9
  70.