home *** CD-ROM | disk | FTP | other *** search
/ Il CD di internet / CD.iso / SOURCE / XAP / X3270 / X3270-3.004 < prev    next >
Encoding:
Text File  |  1995-04-20  |  9.6 KB  |  274 lines
  1. x3270 3.0
  2. ===============================================================================
  3.  
  4. 0. Introduction
  5.  
  6. x3270 3.0 is an IBM 3278 terminal emulator for X windows.  It can be used to
  7. communicate with any IBM host that supports 3270-style connections over TELNET.
  8. It can also communcate with hosts that use line-by-line ASCII mode to do
  9. initial login negotiation before switching to full-screen 3270 mode.
  10.  
  11. It uses its own special fonts to fully emulate the special symbols displayed on
  12. a 3278.  If you grow tired of using a modern workstation to do an exact
  13. emulation of the appearance of a terminal, you can use any constant-width X
  14. font.
  15.  
  16. 0. History
  17.  
  18. x3270 3.0 is a heavy revision of Jeff Sparkes' x3270 1.2.  It incorporates
  19. almost all of the enhancements already available in other improved versions of
  20. x3270 (cut and paste, hollowing cursor, etc.) and a number of
  21. significant changes and improvements.
  22.  
  23. Thanks to --
  24.     Robert Viduya, for the original SunView 3270tool;
  25.     Jeff Sparkes, for the original X port and for inspiring so many of us to
  26.      improve on it;
  27.     Peter Johnston, for insisting that each new function he wanted was just an
  28.      itty bitty change, honest;
  29.     Thomas Vogler, for requesting the original ASCII functionality and helping
  30.      debug it;
  31.     Pekka Nikander, for helpful advice in internationalization and X trivia,
  32.      and yet more porting and debug help;
  33.     and everyone else who has put up with my naive stumblings through X.
  34.  
  35. 1. Enhancements from Release 1.2
  36.  
  37. 1.1 Performance
  38.  
  39. Screen painting is faster.  Much faster.
  40.  
  41. 1.2 Connect/Disconnect
  42.  
  43. You do not need to specify a hostname on the command line.
  44.  
  45. x3270 no longer exits when the host disconnects.
  46.  
  47. You can put a list of common IBM host names in a file.
  48.  
  49. You can specify a string to be be sent to a host when you connect to it.  This
  50. string can include TABs to enter data into multiple fields, and ENTER keys
  51. (newlines) to send an ENTER AID and wait for the keyboard to unlock.
  52.  
  53. 1.3 Menu Bar
  54.  
  55. There is a menu bar with the following options:
  56.     Quit...
  57.     Disconnect        break the current connection
  58.     Exit x3270        terminate the application
  59.     Options...
  60.     About x3270...        friendly informational pop-up
  61.     ---
  62.     Keypad (optional)    pop up (or down) the 3270 keypad
  63.     ---
  64.     Monocase
  65.     Blinking cursor
  66.     Show Timing        display time between sending an AID and the
  67.                  keyboard unlocking
  68.     Track Cursor        show cursor position on status line
  69.     ---
  70.     Trace 3270 DS        trace 3270 data semi-readably on stdout
  71.     Trace TELNET        trace TELNET negotiations and data on stdout
  72.     ---
  73.     Underline Cursor
  74.     Block Cursor
  75.     ---
  76.     3270 Font        the original 3270 font (14-point)
  77.     3270-12 Font        a smaller 3270 font (12-point)
  78.     Other Font...        pop-up to enter another font name
  79.     ---
  80.     Line Mode        change TELNET modes (if ASCII)
  81.     Character Mode
  82.     ---
  83.     Model 2            change 3270 model
  84.     Model 3
  85.     Model 4
  86.     Model 5
  87.     Connect...
  88.     (list of hosts)
  89.     Other... (popup window)
  90.  
  91. The menu bar is turned off with "*menuBar: false" or if the size of the
  92. emulator font makes the window too small to hold it.  The menus can also be
  93. popped up with Ctrl and the mouse buttons.
  94.  
  95. 1.4 Keypad
  96.  
  97. There is a mouse-clickable keypad containing all of the PF, PA, cursor control
  98. and miscellaneous 3270 keys.  It can be toggled on and off with a button in the
  99. upper right of the window.  The command-line option "-keypad" or the "*keypad"
  100. resource determines where it goes:
  101.     right    separate window, to the right of the main window (default)
  102.     bottom    separate window, below the main window
  103.     integral    integrated into the bottom of the main window
  104.  
  105. The keypad can be displayed at startup with "*keypadOn: true".
  106.  
  107. 1.5 Fonts
  108.  
  109. The font used by x3270 is configurable with the command-line option "-efont" or
  110. the resource "emulatorFont."
  111.  
  112. An additional 3270 font (3270-12) is provided.
  113.  
  114. Separate bold fonts are provided (3270bold and 3270-12bold) for speed.
  115.  
  116. x3270 can use any standard constant-spaced X font, but some of the cute stuff
  117. on the status line might not look as nice.
  118.  
  119. Many perfectly good constant-spaced fonts are misconfigured and x3270 doesn't
  120. like them; try a '!' in front of the name to override some of the checking.
  121.  
  122. The font can be changed at any time with a menu option or the SetFont action.
  123.  
  124. 1.6 Cut/Paste
  125.  
  126. Xterm-like mouse selection is supported.  The selection region is a rectangle,
  127. rather than a continuous band on the screen, because this is more "3270-like."
  128.  
  129. The middle mouse button performs a "paste" action like xterm's.
  130.  
  131. The mouse can be configured to act more like OpenWindows with a keymap option.
  132.  
  133. 1.7 ANSI Emulation
  134.  
  135. Placing "a:" in front of a host name causes x3270 to emulate an ANSI terminal
  136. (more or less a VT100 or xterm) until the remote host negotiates 3270
  137. emulation.  Un-negotiating 3270 mode causes a disconnect.
  138.  
  139. Line mode / character mode is negotiable with a menu option.
  140.  
  141. 1.8 Status Line
  142.  
  143. The cursor position is reported in the lower-right corner.  The resource
  144. "*cursorPos: false" or a menu option will turn it off.
  145.  
  146. The time between sending an AID key and the host unlocking the keyboard can be
  147. displayed next to the cursor position.  The resource "*timing: true" or a menu
  148. option will turn it on.  If the transaction takes more than 1 second, the
  149. timing display is updated once a second.
  150.  
  151. 1.9 Internationalization
  152.  
  153. This version of x3270 supports international EBCDIC character sets and
  154. keyboards in a manner similar (but not quite identical) to version 1.3.
  155. The "-charset" option or "*charset" resource specifies an alternative mapping
  156. between EBCDIC codes and displayed graphics.  Character sets supported include
  157. "us" (the default), german, finnish, uk, norwegian and french.  The character
  158. set name "oldibm" is also supported to deal with older U.S. hosts that use
  159. different EBCDIC codes for the square bracket characters.
  160.  
  161. Unlike version 1.3, specifying a "charset" does not modify your keyboard
  162. mapping.  Instead, the "-keymap" option and "*keymap" resource accept
  163. modifiers, that is, they can be specified as a comma-separated list of keymap
  164. names.  The keymap modifiers "finnish7" and "norwegian7" are defined, as is the
  165. modifier "ow", which swaps the middle and right mouse buttons to make them
  166. operate more like OpenWindows.  (For example, to speficy a Sun-4 keyboard with
  167. 7-bit Finnish key mappings and OpenWindows mouse buttons, speficy "-keymap
  168. sun-k4,finnish7,ow".
  169.  
  170. Character sets and keymap modifiers are implemented entirely in resources, so
  171. it is easy to add or correct definitions.
  172.  
  173. 1.10 Icons
  174.  
  175. The icon can either be a cute bitmap or a miniature of the screen image.  The
  176. -activeicon switch or "*activeIcon: true" resource turns on active icons.  The
  177. default font for the icon (*iconFont) is nil2.  Window manager dependencies
  178. abound.
  179.  
  180. Twm doesn't label application-supplied icon windows.  x3270 will supply its own
  181. icon label if "*labelIcon" is true.  The icon label font is controlled by
  182. "*iconLabelFont".
  183.  
  184. 1.11 Miscellany
  185.  
  186. The block cursor hollows out when the mouse cursor leaves the x3270 window.
  187.  
  188. The cursor can be made to blink with a resource (*blink: true) or a menu
  189. option.
  190.  
  191. For debugging, the TELNET and 3270 data streams can be traced on standard
  192. output.
  193.  
  194. The window and icon labels contain useful information.
  195.  
  196. The model number (screen size) may be changed while running, so long as you are
  197. disconnected.
  198.  
  199. The PA3 and 3270 ATTN keys (from v1.3) are implemented.
  200.  
  201. 2. Some Bugs Fixed
  202.  
  203. The last line of the display was not being refreshed on an expose event.
  204.  
  205. ERASE WRITE was not properly implemented (it is supposed to put the terminal in
  206. 24x80 mode until an ERASE WRITE ALTERNATE is received).
  207.  
  208. The "SYSTEM" wait condition on the status line was being displayed at
  209. inappropriate times.
  210.  
  211. A TAB key on a screen with no unprotected fields caused an infinite loop.
  212.  
  213. A field from which data had been deleted (with the DELETE key) was not marked
  214. as modified.
  215.  
  216. If the 3270 font could not be found, x3270 used the wrong font and painted the
  217. screen with garbage.
  218.  
  219. If there was a "*font" entry in the user's .Xdefaults, x3270 would find that
  220. font instead of its own font, with similarly unpleasant results.
  221.  
  222. If the host sent an invalid 3270 command, x3270 crashed silently.
  223.  
  224. If the host was not an IBM host, x3270 would either hang or fail cryptically.
  225.  
  226. Screen updates on ordinary field input were jerky and slow.
  227.  
  228. The 3270 READ MODIFIED command returned incorrect values for attribute bytes,
  229. causing all fields to appear to be nondisplayed.
  230.  
  231. Characters that changed attributes (but not character codes) were not always
  232. redisplayed properly.
  233.  
  234. The shift-key display was wrong if the mouse entered or left the window with
  235. a shift key pressed.
  236.  
  237. 3. Problems
  238.  
  239. 3.1 Missing Stuff
  240.  
  241. This code is distantly based on the 1.2 release of x3270.  It includes many of
  242. the features and fixes (but different implementations) of the subsequent
  243. releases (1.3 BETA and 2.54-apl).  The primary feature of those releases that
  244. is missing from 3.0 is APL support.
  245.  
  246. 3.2 Incompatibilities
  247.  
  248. This code *cannot* use the 3270 font supplied with the 2.54-apl release (and
  249. neither can any of the other versions of x3270).  It can use the font supplied
  250. with 1.2 and 1.3 BETA, or any constant-width X font.  I strongly disagree with
  251. 2.54's author's decision to re-order the 3270 font.
  252.  
  253. The X3270 app-defaults file must be updated in order to run this version.  The
  254. new file is backwards-compatible with 1.2.  I have not tested it with 1.3 BETA
  255. or 2.54-apl.
  256.  
  257. 4. Build Hints
  258.  
  259. To build on HP boxes, you may need to uncomment the following in Imakefile:
  260.  
  261.     EXTRA_DEFINES = -D_HPUX_SOURCE
  262.  
  263. If for some reason you are missing the font alias for the "nil2" font, you can
  264. uncomment the following in X3270.ad:
  265.  
  266.     x3270.iconFont: -misc-nil-medium-r-normal--2-20-75-75-c-10-misc-fontspecific
  267.  
  268. =====
  269.  
  270. Have fun.
  271.  
  272.                 Paul Mattes
  273.                 pdm@cray.com
  274.