home *** CD-ROM | disk | FTP | other *** search
/ Australian Personal Computer 1998 July / apc37.iso / netkit / mac / dcomet / dcomet.hqx / Documents / 1. Emulators < prev    next >
Encoding:
Text File  |  1998-05-04  |  15.0 KB  |  237 lines

  1.  
  2.  
  3.                          1. Emulators
  4.  
  5. _____________________________________________________________________________
  6.  
  7.       dataComet documentation.  (Rev. 11/28/97) 
  8.       Copyright 1995 databeast, Inc. All Rights Reserved.
  9.  
  10.    This document has information on (select and use "Find..." to go to the section):
  11.  
  12.          Using ASCII terminal emulators
  13.          VT220 function key mapping
  14.          UNIX connections
  15.          Using dataComet with EMACS
  16.          Using dataComet with PC-ANSI hosts
  17.          Using dataComet with the IBM 7171
  18.  
  19.          Using the 3278 emulator (and ASCII IBM key mode)
  20.  
  21.          Using the IBM and ASCII menus            see "2. Menus"
  22.  
  23.          Using the "Control Emulator" dialog...   see "3. Dialogs"
  24.                    "Control Color" dialog             "3. Dialogs"
  25.                    "Control Keypad" dialog            "3. Dialogs"
  26.  
  27.        ___________________________________________________
  28.  
  29.          Using ASCII terminal emulators
  30.        ___________________________________________________
  31.  
  32.  
  33.    Many hosts use the ASCII (American Standard Code for Information Interchange) character set to simplify communication with other computers; for example, a Digital VAX running VMS,  almost all UNIX systems, and Macintosh or PC-DOS systems.  You can use either VT102, VT100, VT220, Heath-19, or PC-ANSI emulation with these hosts; the VAX requires one of the VT emulators.
  34.  
  35.    The buttons at the top and left side of the window provide a convenient method of sending frequently used commands to the host with the mouse.   You can set the buttons to send a macro instead of the default VT100 control sequences by clicking on the button while holding the Option key down.  You can also select text on the screen with the mouse to Copy, Paste, Append, or Print.  
  36.  
  37.    If the "Control Controls" dialog item "Show cursor-buttons at left of window" is enabled, the cursor is set to button numbers which appear when you move the cursor up and down the left margin of the window.  By default, these send key sequences equivalent to the Keypad keys in VT100 Application mode.  You can see the labels for the buttons when you click on the '?' control at the top left of the window.
  38.  
  39.       If the "Control Controls" dialog item "Show status bar at top of window" is  enabled, there are 11 buttons at the top of the emulator window which perform functions useful with hosts which use ASCII terminals.
  40.  
  41.          _____________________________________________________
  42.  
  43.             Key       Function
  44.          _____________________________________________________
  45.  
  46.             CR        Enter a line of text or a command.
  47.             LF        Send an ASCII Line Feed character.
  48.             ESC       Send an ASCII Escape character.
  49.             CTL-S     Stop transmission to your terminal.
  50.             CTL-Q     Restart transmission to your terminal.
  51.             DEL       Send an ASCII DEL character.
  52.             Break     Send a break.
  53.             CTL-C     Usually used to abort a command.
  54.             CTL-U     Usually used to abort a command.
  55.  
  56.          _____________________________________________________
  57.  
  58.  
  59.    To the right of the buttons are two counters; the left one shows the packets sent to the network, the right one shows the packets received.
  60.  
  61.    Moving the mouse over a point on the terminal screen will draw a heavy underline beneath that character position; pressing the mouse button will cause dataComet to attempt to move the terminal cursor to the underlined position.  (Cursor positioning can be disabled using the "!Ct" macro, or by setting the Single-click macro to an empty macro.)  Please note that if you click again while the cursor is still moving, it will not move to the point you expect it to!  If the cursor does not go to the proper position on the first mouse click, try it again; the presence of tabs in the text may cause incorrect positioning.  When using the UNIX vi editor, you can use "vi cursor motion" to get around this problem, in addition to speeding the process up.  ("vi cursor motion" does have a minor problem in that it does not handle wrapped lines properly.)
  62.  
  63.    You can modify ASCII key mapping using options in the "Control Emulator" dialog; the default keymapping has:
  64.  
  65.                  `   ->  Escape
  66.          Backspace   ->  Delete
  67.  
  68.  
  69.        ___________________________________________________
  70.  
  71.          VT220 key mapping
  72.        ___________________________________________________
  73.  
  74.    On the Apple extended keyboard, there are additional function keys available at the top of the keyboard and in between the keyboard and keypad.  
  75.  
  76.    The "ins", "home", "end", "x->", "page up", and "page down" keys are mapped by default to perform the expected local Mac-like function (i.e, paging and character deletion).  To send VT220 keys, hold down the Shift key while pressing the key.  You can use the "Control keypad..." dialog to switch so that the keys send VT220 keys ordinarily and perform the local functions when shifted.
  77.  
  78.    You can also use the "Control keypad..." dialog to control whether the keypad keys function as regular numeric keys or as "Application" keys which send special escape sequences; if you have problems using the keypad with an application, try using this dialog to switch the setting.
  79.  
  80.    The keys at the top of the keypad are mapped to F1 - F4.  The keys at the top of the keypad are mapped to F1 - F15 (shift to map F1 -> F13, F2 -> F14, etc., up to F8 -> F20).  In VT100 mode the keys send the following sequences:
  81.  
  82.           ______________________________________________
  83.  
  84.             Key          VT key name     Sends
  85.           ______________________________________________
  86.  
  87.             help         FIND           \027[1~
  88.             home         Insert Here    \027[2~
  89.             page up      Remove         \027[3~
  90.             X->          Select         \027[4~
  91.             end          Prev Screen    \027[5~
  92.             page down    Next Screen    \027[6~
  93.  
  94.             clear        F1 (Gold)      \027OP
  95.             =            F2 (Help)      \027OQ
  96.             /            F3             \027OR
  97.             *            F4             \027OS
  98.             F1           F1 (Gold)      \027OP
  99.             F2           F2 (Help)      \027OQ
  100.             F3           F3             \027OR
  101.             F4           F4             \027OS
  102.             F5
  103.             F6           F6             \027[17~
  104.             F7           F7             \027[18~
  105.             F8           F8             \027[19~
  106.             F9           F9             \027[20~
  107.             F10          F10            \027[21~
  108.             F11          F11            \027[23~
  109.             F12          F12            \027[24~
  110.             F13          F13            \027[25~
  111.             F14          F14            \027[26~
  112.             F15          F15 (Help)     \027[28~
  113.  
  114.             ^-F1         F13            \027[25~
  115.             ^-F2         F14            \027[26~
  116.             ^-F3         F15            \027[28~
  117.             ^-F4         F16 (Do)       \027[29~
  118.             ^-F5         F17            \027[31~
  119.             ^-F6         F18            \027[32~
  120.             ^-F7         F19            \027[33~
  121.             ^-F8         F20            \027[34~
  122.  
  123.  
  124.             NOTE that the host can also set the function 
  125.             keys using UDK escape sequences.
  126.  
  127.           ______________________________________________
  128.  
  129.                 Application mode keypad
  130.           ______________________________________________
  131.  
  132.             +                           \027Ol
  133.             -                           \027Om
  134.             .                           \027On
  135.             0                           \027Op
  136.             1                           \027Oq
  137.             2                           \027Or
  138.             3                           \027Os
  139.             4                           \027Ot
  140.             5                           \027Ou
  141.             6                           \027Ov
  142.             7                           \027Ow
  143.             8                           \027Ox
  144.             9                           \027Oy
  145.             ENTER                       \027OM
  146.  
  147.           ______________________________________________
  148.  
  149.  
  150.             * '\027' is the Escape character
  151.  
  152.        ___________________________________________________
  153.  
  154.          UNIX connections
  155.        ___________________________________________________
  156.  
  157.  
  158.    Resizing the terminal window when drivers don't support Telnet Window Size negotiation:  If your host does not have the correct terminal size set after you change the window size, you need to issue the following commands (e.g., where you want to set the size of your window to 50 rows X 80 columns):
  159.  
  160.    stty rows 50 columns 80
  161.    echo 'r'
  162.  
  163.    The second command clears the screen and resets the terminal's scrolling region to the full size of the screen so all the rows specified will be used before scrolling occurs.
  164.  
  165.    To get 8-bit connections:  UNIX terminal drivers normally do not pass 8 bit characters. To enable proper handling of ISO-Latin or other character sets which have more than 128 characters, add the following lines to your .cshrc: 
  166.  
  167.       tty -s
  168.       if ($status == 0) stty cs8 -istrip -parenb
  169.  
  170.    If you don't use csh, add equivalent code to your shell's start up file.  (Note that it is necessary to check whether your standard I/O streams are connected to a terminal. Only then should you reconfigure the terminal driver.)
  171.  
  172.        ___________________________________________________
  173.  
  174.          Using dataComet with EMACS
  175.        ___________________________________________________
  176.  
  177.    dataComet offers reliable performance with EMACS editor sessions.  "Control-Option" sends a meta-character; "Control-Shift" sends a meta-control-character.  You can also use the "Control Emulator" dialog item "Option is Meta Key" to set up the Option key to serve as a Meta Key (see description below) .  Alternatively, you can set the eight bit of the character to make it a Meta key using the !CM macro, which you need to associate with a key using a key macro.
  178.  
  179.        ___________________________________________________
  180.  
  181.          Using dataComet with PC-ANSI hosts
  182.        ___________________________________________________
  183.  
  184.    Note that "Substitute Comet-Font for characters > 127" needs to be OFF for PC-ANSI sessions to display the correct font consistently; if this is not the case, box characters will appear as odd characters.  (This is ordinarily automatic, but may not be set correctly if you reconfigure a session as a PC-ANSI session after connecting as a VT100).
  185.  
  186.        ___________________________________________________
  187.  
  188.          Using dataComet with the IBM 7171
  189.        ___________________________________________________
  190.  
  191.    Use the Heath-19 emulator and turn on the "Use IBM menus and key mapping" option in the "Control Emulator..." dialog if you want to communicate with an IBM mainframe through the 7171 ASCII terminal adapter.  This mode allows you to run programs such as the XEDIT full-screen editor as if you were using an IBM 3278 terminal.  Buttons and menu items are provided which allow you to conveniently produce the commands the 7171 accepts as the equivalent of keys on the 3278 terminal.  When the 7171 requests your terminal type, type in "C19".  (The C19 definition must be loaded into the 7171 configuration for this to work correctly.)
  192.  
  193.  
  194.  
  195.        ___________________________________________________
  196.  
  197.          Using the 3278 emulator (and ASCII IBM key mode)
  198.        ___________________________________________________
  199.  
  200.  
  201.    dataComet provides an emulation of the IBM 3278 display terminal; it allows you to run programs such as FILELIST or the XEDIT full-screen editor just as if you were using an IBM 3278 terminal.  Buttons and menu items are provided which allow the user to conveniently produce the commands produced by keys on the 3278 terminal.
  202.  
  203.    Moving the mouse over a point on the terminal screen will draw a heavy underline beneath that character position; pressing the mouse button will move the terminal cursor to the underlined position.  You can also select text on the screen with the mouse to Copy, Paste, Append, or Print.  (Note that Paste aborts if the text runs past the end of the current field.)
  204.  
  205.             ________________________________________
  206.  
  207.                Key Assignments (see IBM menus also)
  208.  
  209.                Key              3270 Action
  210.             ________________________________________
  211.  
  212.                Return           Enter
  213.                Shift-Return     New Line
  214.                Enter            Enter
  215.                Option-Enter     PA2
  216.                Shift-Tab        Back-Tab
  217.                Backspace        Backspace, Delete
  218.             ________________________________________
  219.  
  220.  
  221.    The Backspace key changes its behavior when the 3270 emulator is put into "Insert" mode.  Ordinarily it produces a Backspace-Space-Backspace, so that the text to the right of the cursor is left in its original position.  When Insert mode is ON, the Backspace key will produce a Backspace-Delete, so that the text to the right of the cursor shifts to the left.
  222.  
  223.    You can also use the Command, Shift, and Option keys to control which action you wish the Backspace to perform.  When Command is held down while Backspace is pressed, the character to the right of the cursor is deleted, and the remaining text is shifted left.  When the Option key is held down, the result is a Backspace-Delete, as is the case in Insert mode.  When the Shift key is held down, the standard Backspace-Space-Backspace will be produced.
  224.  
  225.    If the "Control Controls" dialog item "Show cursor-buttons at left of window" is enabled, the cursor is set to button numbers which appear when you move the cursor up and down the left margin of the window.  By default, these send the PF keys from 1 through 24.  You can see the labels for the buttons when you click on the '?' control at the top left of the window.
  226.  
  227.    If the "Control Controls" dialog item "Show status bar at top of window" is  enabled, there are 11 buttons at the top of the emulator window which (by default) perform actions available on 3270-type terminal keys.  (See "2. Menus", "Using IBM menus" for a description of their functions.)
  228.  
  229.    To the right of the buttons are two counters; the left one shows the packets sent to the network, the right one shows the packets received.  If you are using Telnet, the counter on the left may appear reversed (white on black)--this indicates that MacTCP is resending the packet to the host.
  230.  
  231.    A "HOST BUSY" indicator appears at the top of the screen when one the host system is busy processing your command; the host will not accept new commands from an Enter or PF key until the "HOST BUSY" indicator goes off.
  232.  
  233.    IMPORTANT NOTE:  You can enhance your communications efficiency when using the 3270 emulator by making sure that XEDIT has "SET FULLREAD OFF" in your PROFILE XEDIT file; XEDIT-based applications such as RICEMAIL may need to have this option turned off also to get optimal performance.  FULLREAD mode causes an extra 2,000 bytes to be sent with every PF-keystroke in the Action menu, and can significantly degrade performance on slower networks such as LocalTalk.
  234.  
  235.  
  236. _____________________________________________________________________________
  237.