home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / network / 3commisc.zip / KEYDEF.DOC < prev    next >
Text File  |  1992-01-02  |  11KB  |  327 lines
  1. Version 1.3.0
  2. #  Maxess keyboard definition file format (KEYDEF.DAT)
  3. #
  4. #    File KEYDEF.DAT defines the workstation keyboard.  This file
  5. #    is a superset of file KEYDEF.DAT, containing explanatory comments.
  6. #    When making changes to the keyboard definition, first make the changes
  7. #    to this file and then copy it to file KEYDEF.DAT for testing.  After,
  8. #    testing is complete, remove all comments in file KEYDEF.DAT for
  9. #    faster operation.
  10. #  
  11. #    There are two sections defining the keyboard:
  12. #
  13. #    Section 1:  Specifies scan code/shift states for keys that
  14. #            are not supported by the BIOS (e.g. SysReq on an AT).
  15. #
  16. #    Section 2:  Specifies keyboard labels and BIOS codes for each
  17. #            key sequence.
  18. #
  19. #  General File Format:
  20. #
  21. #    All lines beginning with '#' and blank lines are ignored and
  22. #    can be used for comments.
  23. #
  24. #    Each section is terminated with ".e" starting in column 1
  25. #
  26. #  Note on number pad keys:
  27. #
  28. #    If you specify entries for number pad keys, the number
  29. #    pad option will no longer work with the Shift keys specified.
  30. #    For example, the following entry in Section 1 specifies the
  31. #    Right or Left Shift key, together with the End key.
  32. #
  33. #        03    4f    f000
  34. #
  35. #    This turns off the ability to use the '1' on the number pad
  36. #    by pressing either of the shift keys and the End key.  It does
  37. #    not turn off the Num Lock method of using the number pad.
  38. #
  39. #    It is recommended that NONE of the number pad keys be assigned
  40. #    with either of the shift keys to avoid confusion over the number
  41. #    pad.
  42. #
  43. #  Note on Extended Keyboards:
  44. #
  45. #    Extended keyboards have a duplicate set of cursor movement keys
  46. #    to allow the user to keep Num Lock on and still move around on
  47. #    the screen.  Since the duplicate keys produce the same basic
  48. #    Scan Codes, you cannot distinguish these duplicate keys from
  49. #    each other in Maxess.
  50.  
  51. #  Section 1 - BIOS Keyboard Extensions
  52. #
  53. #    This section is used to specify extensions to the BIOS's
  54. #    keyboard codes.  Many of the keystroke sequences available
  55. #    on the keyboard are not normally supported through the BIOS
  56. #    (e.g. Sys Req).
  57. #
  58. #    Scan code/shift states are specified with the following format:
  59. #
  60. #        <Shift Code> <Scan Code> <BIOS Code>
  61. #
  62. #    The Shift Code is a hex byte value specifying which shift
  63. #    keys are required for the keystroke sequence.  Bits in the
  64. #    Shift Code have the following meaning:
  65. #
  66. #        0 (LSB)        Right Shift
  67. #        1        Left Shift
  68. #        2        Ctrl
  69. #        3        Alt
  70. #
  71. #    If Left and Right Shift are both specified, either shift
  72. #    key will be recognized as Shift.  Other combinations must match
  73. #    exactly (e.g. Ctrl Alt).
  74. #
  75. #    Note that only a single Alt key is specified.  On keyboards
  76. #    with two Alt keys, either will be recognized as the Alt key.
  77. #
  78. #    The Scan Code is the byte value that is associated with the
  79. #    key.  Use the SCANCODE utility to determine the Scan Code of
  80. #    a key.
  81. #
  82. #    The BIOS Code must be a unique hex code that does not conflict
  83. #    with existing BIOS codes.  For a list of existing BIOS codes for
  84. #    your computer, consult your technical reference    documentation, or
  85. #    use the KBTEST Utility to display all BIOS codes.  When adding
  86. #    a new BIOS code for a non-data key (i.e. a function key), use
  87. #    00 for the low order byte.  This causes the key to be recognized
  88. #    as a function key and prevents interpretation of the low order
  89. #    byte as an ASCII character.
  90. #
  91. #    Use the KBTEST utility to determine if a key sequence is
  92. #    supported through the BIOS or with the currently defined extensions.
  93. #    If the desired key sequence is supported, the BIOS code will be
  94. #    displayed.  If not, nothing is displayed.
  95. #
  96. #    To add an entry to Section 1, determine the Shift Code from
  97. #    the codes described above.  Run the SCANCODE utility to determine
  98. #    the low-level scan code of the basic key.  Choose a unique
  99. #    BIOS extension value in the range F000 to FFFF.
  100. #
  101. #    DO NOT SPECIFY HOTKEY SEQUENCES FOR OTHER TSR PROGRAMS IN
  102. #    SECTION 1.  This will prevent the TSR from recognizing its
  103. #    hotkey when a Maxess program is in use.  Note that the Hotkey
  104. #    for the 3270 Program (Alt Pad +) is commented out.
  105.  
  106. #  Unshifted keys:
  107. #00    4c    0000    # Pad Center    # (TAKES AWAY Number Pad 5 key)
  108. 00    54    b100    # Sys Req
  109.  
  110. #  Shifted keys:
  111. 03    01    b200    # Shift Esc
  112. 03    54    b300    # Shift Sys Req
  113. 03    4a    b400    # Shift Pad -
  114. 03    4e    b500    # Shift Pad +
  115. 03    39    b600    # Shift Space
  116. 03    0e    b700    # Shift Backspace
  117. 03    1c    b800    # Shift Enter
  118. #03    35    0000    # Shift Pad / (TURNS OFF '?')
  119. #03    37    0000    # Shift Pad * (TURNS OFF PRINT SCREEN on 83/84 KBD)
  120.  
  121. #  Ctrl keys:
  122. 04    02    b900    # Ctrl 1
  123. 04    04    ba00    # Ctrl 3
  124. 04    05    bb00    # Ctrl 4
  125. 04    06    bc00    # Ctrl 5
  126. 04    08    bd00    # Ctrl 7
  127. 04    09    be00    # Ctrl 8
  128. 04    0a    bf00    # Ctrl 9
  129. 04    0b    c000    # Ctrl 0
  130. 04    0d    c100    # Ctrl =
  131. 04    28    c200    # Ctrl '
  132. 04    29    c300    # Ctrl `
  133. 04    27    c400    # Ctrl ;
  134. 04    33    c500    # Ctrl ,
  135. 04    34    c600    # Ctrl .
  136. 04    35    c700    # Ctrl /
  137. 04    01    c800    # Ctrl Esc
  138. 04    54    c900    # Ctrl Sys Req
  139. 04    48    ca00    # Ctrl Up Arrow
  140. 04    4c    cb00    # Ctrl Pad Center
  141. 04    50    cc00    # Ctrl Down Arrow
  142. 04    39    cd00    # Ctrl Space
  143.  
  144. #  Alt keys
  145. #
  146. #   Note:  To use the BIOS feature that allows entry of an arbitrary
  147. #       number via the Alt key and the number pad, remove the
  148. #       definitions for the number pad below (**).
  149. 08    54    ce00    # Alt Sys Req
  150. 08    1c    cf00    # Alt Enter
  151. 08    37    d000    # Alt Pad *
  152. 08    47    d100    # Alt Home (**)
  153. 08    48    d200    # Alt Up Arrow (**)
  154. 08    49    d300    # Alt PgUp (**)
  155. 08    4a    d400    # Alt Pad -
  156. 08    4b    d500    # Alt Left Arrow (**)
  157. 08    4c    d600    # Alt Pad Center (**)
  158. 08    4d    d700    # Alt Right Arrow (**)
  159. #08    4e    0000    # Alt Pad + (Used for 3270 Hotkey)
  160. 08    4f    d900    # Alt End (**)
  161. 08    50    da00    # Alt Down Arrow (**)
  162. 08    51    db00    # Alt PgDn (**)
  163. 08    39    dc00    # Alt Space
  164. 08    52    dd00    # Alt Ins (**)
  165. 08    53    de00    # Alt Del
  166. .e
  167.  
  168. #  Section 2 - Keyboard Labels and BIOS Codes
  169. #
  170. #    Each key sequence supported by the Maxess product must be
  171. #    specified in the matrix in this section.
  172. #
  173. #    Each line in this section has the format:
  174. #
  175. #        "<label>"    <Normal> <Shifted> <Ctrl> <Alt>
  176. #
  177. #    The <label> field specifies the text that appears on the key.
  178. #    This field must be enclosed in double quotes.  Special characters
  179. #    can be displayed using the '\ooo' format using three octal digits
  180. #    to form the binary number required.
  181. #
  182. #    The Normal, Shifted, Ctrl, and Alt fields specify the BIOS codes
  183. #    or BIOS extension codes (from Section 1) associated with the
  184. #    key sequence.  To get BIOS codes, use the KBTEST utility.
  185. #
  186. #    If a key has more than one label, multiple entries can be made.
  187. #    Note that the Tab key on a standard IBM PC has two labels - one
  188. #    for the normal tab, and another for the shifted tab, which is a
  189. #    backtab.  If one entry is made for the tab key, the shifted tab key
  190. #    label will appear in the product as "Shift -->|".  Instead,
  191. #    a second entry is made with the shifted label, and the shifted
  192. #    BIOS code is moved from the first entry's Shift column to the
  193. #    second entry's Normal column.
  194. #
  195. #    If the ASCII code produced by a key matches its label, a '0' can be
  196. #    used for the BIOS code.  Note that the normal ASCII data keys
  197. #    do not require BIOS codes.
  198. #
  199. #    The maximum number of characters in a label depends on the longest
  200. #    prefix used ("Shift", "Ctrl" or "Alt").  The total of the
  201. #    longest prefix length and the label string should not
  202. #    exceed 20 characters.  Octal codes (\020) are counted as one.
  203. #
  204. #    To support combined shifted keys, first add an entry in
  205. #    Section 1 with the appropriate shift code set for both shift keys
  206. #    and a unique BIOS code.  Then, add an entry in Section 2 which
  207. #    includes one of the shift labels in the basic label, and enter
  208. #    the unique BIOS code from Section 1 in the appropriate column
  209. #    for the other shift key.
  210. #
  211. #    For example, to add the "Ctrl Alt F1" key sequence, add
  212. #
  213. #        0c    3b    f0nn
  214. #
  215. #    to Section 1 (where f0nn is a unique BIOS extended code), and 
  216. #
  217. #        "Alt F1"    0    0    f0nn   0
  218. #
  219. #    to Section 2.  Do not use combinations that produce key labels
  220. #    greater than 20 bytes.
  221. #
  222. # Key Label    BIOS Codes:
  223. #        Normal    Shift    Ctrl    Alt
  224.  
  225. "F1"        3b00    5400    5e00    6800
  226. "F2"        3c00    5500    5f00    6900
  227. "`"        0    0    c300    2900
  228. "1"        0    0    b900     7800
  229. "2"        0    0    0300    7900
  230. "3"        0    0    ba00    7a00
  231. "4"        0    0    bb00    7b00
  232. "5"        0    0    bc00    7c00
  233. "6"        0    0    071e    7d00
  234. "7"        0    0    bd00    7e00
  235. "8"        0    0    be00    7f00
  236. "9"        0    0    bf00    8000
  237. "0"        0    0    c000    8100
  238. "-"        0    0    0c1f    8200
  239. "="        0    0    c100    8300
  240. "\\"        0    0    2b1c    2b00
  241. "\021--"    0e08    b700    0e7f    0e00    # Backspace
  242. "Esc"        011b    b200    c800    0100
  243. "Sys Req"    b100    b300    c900    ce00
  244. "F3"        3d00    5600    6000    6a00
  245. "F4"        3e00    5700    6100    6b00
  246. "--\020\263"    0f09    0    9400    a500    # Tab
  247. "\263\021--"    0f00    0    0    0    # Backtab
  248. "Q"        0    0    1011    1000
  249. "W"        0    0    1117    1100
  250. "E"        0    0    1205    1200
  251. "R"        0    0    1312    1300
  252. "T"        0    0    1414    1400
  253. "Y"        0    0    1519    1500
  254. "U"        0    0    1615    1600
  255. "I"        0    0    1709    1700
  256. "O"        0    0    180f    1800
  257. "P"        0    0    1910    1900
  258. "["        0    0    1a1b    1a00
  259. "]"        0    0    1b1d    1b00
  260. "Home"        4700    0    7700    d100
  261. "\030"        4800    0    ca00    d200    # Up Arrow
  262. "PgUp"        4900    0    8400    d300
  263.  
  264. # NOTE:  On 101/102 keyboards, CTRL-Pad-Star has a unique scan code
  265. #     so we include them both
  266. "Pad *"        372a    0    7200    d000
  267. "Pad *"        0    0    9600    0
  268.  
  269. "F5"        3f00    5800    6200    6c00
  270. "F6"        4000    5900    6300    6d00
  271. "A"        0    0    1e01    1e00
  272. "S"        0    0    1f13    1f00
  273. "D"        0    0    2004    2000
  274. "F"        0    0    2106    2100
  275. "G"        0    0    2207    2200
  276. "H"        0    0    2308    2300
  277. "J"        0    0    240a    2400
  278. "K"        0    0    250b    2500
  279. "L"        0    0    260c    2600
  280. ";"        0    0    c400    2700
  281. "'"        0    0    c200    2800
  282. "\021\304\331"    1c0d    b800    1c0a    cf00    # Enter (CR)
  283. "\021-"        4b00    0    7300    d500    # Left Arrow
  284. "Center"    0    0    cb00    d600    # No label center of pad
  285. "-\020"        4d00    0    7400    d700    # Right Arrow
  286. "Pad -"        4a2d    b400    8e00    d400
  287. "F7"        4100    5a00    6400    6e00
  288. "F8"        4200    5b00    6500    6f00
  289. "Z"        0    0    2c1a    2c00
  290. "X"        0    0    2d18    2d00
  291. "C"        0    0    2e03    2e00
  292. "V"        0    0    2f16    2f00
  293. "B"        0    0    3002    3000
  294. "N"        0    0    310e    3100
  295. "M"        0    0    320d    3200
  296. ","        0    0    c500    3300
  297. "."        0    0    c600    3400
  298. "/"        0    0    c700    3500
  299. "End"        4f00    0    7500    d900
  300. "\031"        5000    0    cc00    da00    # Down Arrow
  301. "PgDn"        5100    0    7600    db00
  302. "Pad +"        4e2b    b500    9000    d800
  303. "F9"        4300    5c00    6600    7000
  304. "F10"        4400    5d00    6700    7100
  305. "space-bar"    3920    b600    cd00    dc00
  306. "Ins"        5200    0    9200    dd00
  307. "Del"        5300    0    9300    de00
  308.  
  309. # 101/102 keyboard extended keys
  310. "F11"        8500    8700    8900    8b00
  311. "F12"        8600    8800    8a00    8c00
  312. "Pad Enter"    e00d    0    e00a    a600
  313. "Pad /"        e02f    0    9500    a400
  314.  
  315. # Duplicate 101/102 keys (not supported as separate keys)
  316. #"Home"        47e0    0    77e0    9700
  317. #"\030"        48e0    0    8de0    9800    # Up Arrow
  318. #"PgUp"        49e0    0    84e0    9900
  319. #"\021-"    4be0    0    73e0    9b00    # Left Arrow
  320. #"-\020"    4de0    0    74e0    9d00    # Right Arrow
  321. #"End"        4fe0    0    75e0    9f00
  322. #"\031"        50e0    0    91e0    a000    # Down Arrow
  323. #"PgDn"        51e0    0    76e0    a100
  324. #"Ins"        52e0    0    92e0    a200
  325. #"Del"        53e0    0    93e0    a300
  326. .e
  327.