home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 29 Fixes_o / 29-Fixes_o.zip / tcpcsd2.zip / BASECSD2.EXE / DOC / TN3270.DOC < prev   
Text File  |  1993-04-15  |  8KB  |  226 lines
  1.  
  2. -----------------------------------------------------------
  3. Changes to TN3270 parameters:
  4.  
  5. The -tx parameter is in the latest draft but without any explanation.  Here's
  6. the detail taken from the documentation that comes with the base CSD:
  7.  
  8.      Support for specifying external ASCII/EBCIDC translation table has been
  9.       added to TN3270 and PMANT.  This is supported by the following files:
  10.  
  11.          \tcpip\bin\tn3270.exe
  12.          \tcpip\bin\pmant.exe
  13.          \tcpip\etc\3278xlt.sam   (sample translate table)
  14.  
  15.       Both TN3270 and PMANT have the following syntax for specifying a
  16.       translate table.
  17.  
  18.        -tx translate_table_file_name
  19.  
  20.       If the  translate_table_file_name does not contain the full path then
  21.       the application will search the ETC directory.
  22.  
  23.       If the -tx option is not specified, the application will use the file
  24.       3278XLT.TBL in ETC directory.  Thus if you want to use a particular
  25.       translate table most of the time, you should copy your translate table
  26.       file to 3278XLT.TBL in your ETC directory.  If the file 3278XLT.TBL does
  27.       not exist, the application will use the default US translate table
  28.       internal to the application.
  29.  
  30.       3278XLT.SMP is shipped as an example and contains the US ASCII/EBCDIC
  31.       translations.  The format of the translation table is the same as that
  32.       of IBM TCP/IP for VM.  Thus TN3270 and PMANT can use a translation table
  33.       downloaded form IBM TCP/IP for VM.
  34.  
  35. The -t parameter provides debug terminal negotiation information in a
  36.       TN3270.LOG file.
  37. The -d parameter provides debug information about all data sent in a
  38.       TN3270.LOG file.
  39. The -t -d options together provide both of the debug information above
  40.       in a TN3270.LOG file.
  41.  
  42. -----------------------------------------------------------------------------
  43.  
  44. The menu item "Keyboard..." in the Configuration menu has changed to
  45. "Refresh key mapping".
  46.  
  47. The menu item "Attributes" has changed to "Change Color" and "Save Color".
  48.  
  49. The keyboard mapping has completely changed.  Keyboard mapping is now done
  50. using a text file rather than a dialog box.  The Keyboard dialog box has been
  51. removed. Here's the technical details on the new keyboard mapping:
  52.  
  53. -----------------------------------------------------------------------------
  54.  
  55. New Keyboard Binding for TN3270
  56. -------------------------------
  57.  
  58. A new scheme for binding keys has been implemented in TN3270, allowing
  59. for a greater flexibility.  TN3270 now allows you to bind a 3270
  60. function to the following keys:
  61.  
  62. function keys
  63. cursor keys
  64. editing keys (Insert, Home, Page Up, etc)
  65. escape
  66. tab
  67. backspace
  68. print screen
  69. scroll lock
  70. left control key
  71. right control key
  72.  
  73. and control, alt, and shift combinations of these keys.  TN3270 also
  74. allows you to bind 3270 functions to control-letter combinations and
  75. alt-letter combinations as well as the individual control and alt
  76. keys.
  77.  
  78. The key bindings are stored in a flat ASCII file named TN3270.KEY.
  79. When loading the key bindings, TN3270 first tries to open TN3270.KEY in
  80. the current directory.  If this fails, TN3270 tries to open TN3270.KEY
  81. in the directory defined in the ETC environment variable.
  82.  
  83. If the TN3270.KEY file is opened successfully, TN3270 reads the file
  84. line-by-line, parsing the bindings, and binding a 3270 datastream
  85. function to an OS/2 key.  Keys may be rebound on the fly by editting
  86. TN3270.KEY and using the "Refresh key mapping" menu option in the
  87. TN3270 main menu.  To access the TN3270 main menu, press ALT-M.
  88.  
  89. Since TN3270 is initialized with default key bindings, the TN3270.KEY
  90. file need only contain bindings to override the default or provide for
  91. bindings that are not defaults.
  92.  
  93. The TN3270.KEY file is line-oriented.  Each line is either blank,
  94. contains a comment, or contains 1 binding.  The semicolon is used to
  95. delimit comments which may appear anywhere on the line.  A comment
  96. begins with a semicolon and ends at the end of the line.
  97.  
  98. A line containing a binding follows the syntax:
  99.  
  100. <OS/2 Key> <whitespace> <3270 Function> <optional comment>
  101.  
  102. Where <OS/2 Key> is of the form:
  103.  
  104. <function key>
  105. control-<function key>
  106. alt-<function key>
  107. shift-<function key>
  108. control-'<unshifted keypress>'
  109. alt-'<unshifted keypress>'
  110.  
  111. <unshifted keypress> is one of the keyboard's white keys identifying
  112. letters, punctuation, numbers, and foreign language accented keys.
  113. This key should be the *unshifted* letter.  For example, to bind a
  114. function to control-2, the <unshifted keypress> would be:
  115.  
  116. control-'2'
  117.  
  118. It is not possible to bind to control-'@' since '@' is the shifted
  119. state of '2'.  There are some control combinations which can not be
  120. bound.  See "Limitations."
  121.  
  122. TN3270 does not allow binding to the quote key (see "Limitations".)
  123. However, PM-ANT does.  Therefore, the syntax of the TN3270.KEY file
  124. must allow this binding.  To bind to the quote character, the
  125. backslash is used as an "escape" to temporarily break the syntax that
  126. an unshifted keypress is surrounded by quotes.  Since the backslash is
  127. interpreted as an escape, there must be 2 backslashes when binding to
  128. the backslash.  For example,
  129.  
  130. control-'\''  ; escape the quote so it can be bound to,
  131.               ; ''' would be illegal syntax
  132. control-'\\'  ; escape the backslash so it can be bound to
  133.               ; '\' would be illegal syntax
  134.  
  135. control-'\a'  ; '\a' is exactly the same as 'a'
  136.  
  137. <function key> is a keyword identifying an OS/2 function key.
  138. Possible values are BACKSPACE, TAB, NEWLINE, ESCAPE, PAGEUP, PAGEDOWN,
  139. END, HOME, LEFT, UP, RIGHT, DOWN, INSERT, DELETE, ENTER, F1, F2, F3,
  140. F4, F5, F6, F7, F8, F9, F10, F11, F12, LEFT-CONTROL, RIGHT-CONTROL,
  141. LEFT-ALT, RIGHT-ALT.  Note that shift-tab is the same as backtab.  The
  142. keyword ENTER refers to the enter key on the numeric keypad whereas
  143. NEWLINE is the enter key with the alphabet.
  144.  
  145. The <3270 Function> specifies a 3270 function to bind the OS/2
  146. keypress to.  Possible values are UP, DOWN, LEFT, RIGHT, NEWLINE,
  147. HOME, TAB, BACKTAB, END, FORWARD-WORD, BACKWARD-WORD, INSERT, DELETE,
  148. BACKSPACE, KILL-WORD, BACKWARD-KILL-WORD, ERASE-EOF, ERASE-INPUT, PF1,
  149. PF2, PF3, PF4, PF5, PF6, PF7, PF8, PF9, PF10, PF11, PF12, PF13, PF14,
  150. PF15, PF16, PF17, PF18, PF19, PF20, PF21, PF22, PF23, PF24, CLEAR,
  151. ENTER, PA1, PA2, PA3, SYSREQ, RESET, ATTN, MENU.
  152.  
  153. A sample TN3270.KEY file looks like:
  154.  
  155. ; this is a sample TN3270.KEY file.  It should be in either
  156. ; the current directory or in the directory pointed by the environment
  157. ; variable TMP.
  158.  
  159. escape           clear  ; bind escape to clear (the default anyway)
  160. control-'a'      home
  161. newline          newline; make the keyboard enter just do a newline
  162. right-control    enter  ; make the right control key execute commands
  163. enter            enter  ; make the numeric keypad enter key execute cmds
  164. shift-backspace  pf3    ; shift backspace invokes the pf3 function key
  165. shift-tab        tab    ; make shift-tab go to the next field
  166.  
  167. Limitations
  168. -----------
  169.  
  170. There are some control combinations which are processed by OS/2 and
  171. not passed to the application program.  Since TN3270 is never informed
  172. when they are pressed, it is not possible to bind to these keys.
  173. These keys are:
  174.  
  175. control-'1'
  176. control-'2'
  177. control-'3'
  178. control-'4'
  179. control-'5'
  180. control-'6'
  181. control-'7'
  182. control-'8'
  183. control-'9'
  184. control-'0'
  185. control-'-'
  186. control-'='
  187. control-';'
  188. control-'\''
  189. control-'/'
  190. control-'.'
  191. control-','
  192. control-'`'
  193. alt-f4
  194. alt-f5
  195. alt-f7
  196. alt-f8
  197. alt-f9
  198. alt-f10
  199. alt-tab
  200. alt-escape
  201. shift-escape
  202. control-escape
  203.  
  204. -------------------------------------
  205.  
  206. Default key bindings
  207. --------------------
  208. NEWLINE                      ENTER
  209. ENTER                        ENTER
  210. ESCAPE                       CLEAR
  211. PAGEUP                       PF7
  212. PAGEDOWN                     PF8
  213. CONTROL-END                  ERASE-EOF
  214. CONTROL-LEFT                 BACKWARD-WORD
  215. CONTROL-RIGHT                FORWARD-WORD
  216. CONTROL-F1                   PA1
  217. CONTROL-F2                   PA2
  218. CONTROL-F3                   PA3
  219. SHIFT-F1 - SHIFT F13         PF13 - PF24
  220. ALT-'1'                      PA1
  221. ALT-'2'                      PA2
  222. ALT-'3'                      PA3
  223. ALT-'M'                      MENU
  224. CONTROL-']'                  MENU
  225.  
  226.