{
                 {NEW FEATURES IN DOS TERMINAL EMULATION
                 {======================================

{  TN3270 Support
{  ==============

       With the TN3270 function, your PC can emulate IBM 3278 (Models 2
       through 5) terminals. The exact models supported depend on the
       display adapter you have.  You can open up to four simultaneous
       sessions. From each session you can exit to the DOS shell and
       return to a session without ending the session. A user-definable
       setup program, keyboard remapper, US code page support, and on-line
       keyboard-remapping display are also included. In addition, you can
       create a capture file and log file to assist with debugging.

{    Beginning a Session
{    -------------------

       After you make a TN3270 connection, you can work with host-specific
       applications such as PITS and XEDIT, just as though you were
       working on a 3278 terminal.

       To begin a TN3270 session, you can be in any directory, so long as
       the PATH= or SET PATH= statements list the directory containing
       the LANtastic for TCP/IP files.  To begin a TN3270 session, type:

              C:\LANTCP> tn3270 [-t terminal name] [-p port] hostname

       {-t terminal name} is the name of the terminal you are emulating.
       This entry is used for terminal-type negotiation. {-p port} is the
       number of the TN3270 destination port on the host. The default
       number of ports is 23. Enter {-p} followed by a space, then the
       port number.  {hostname} is the name or Internet address of the
       remote host you are contacting.

       After you enter TN3270 mode for the first time, you can specify a
       default host with which to connect. (Refer to "Configuring Your
       TN3270 Terminal Options" later in this section) After specifying
       this default host, each time you enter a TN3270 session, you can
       log onto the default host without specifying the hostname. Type:

              C:\LANTCP> tn3270

       To connect with a different host, type the tn3270 command, and
       specify the new hostname. The original hostname you specified
       remains the default. To change the default, see "Configuring Your
       TN3270 Terminal Options."

{    Ending the Session
{    ------------------

       To close a connection with an IBM host, type logoff at the system
       prompt on the IBM mainframe.

       {Note...}     You can also press {Alt+X} to end a TN3270 session.
                   If you are in an application when you press {Alt+X},
                   the TN3270 application will quit, but you remain logged
                   into the application on the host to which you were
                   connected. The port to which you were connected on the
                   host remains open. If you use {Alt+X} to exit, then try
                   to log in to the same host with the same log-in name,
                   you may be rejected by the host, since most hosts allow
                   only one active log-in per username.

{    Configuring Your TN3270 Terminal Options
{    ----------------------------------------

       After you connect with an IBM host, you can specify the following
       parameters:

           o Hostname (remote IBM host you connect with by default)

           o Display mode (color or monochrome)

           o KB Map File (TN_XTC.KBD, TN_ATC.KBD, TN_ENHC.KBD, or a
             user-specified filename based on these keyboard files)

       To configure these options, press {Alt+S}.

       To select a field on the TN3270 Setup screen, press the Up or Down
       arrow keys. Press the spacebar to toggle a field.  To save and
       quit, press {F10}. To quit without saving, press {Esc}.

       Table 1 describes each of the fields in the TN3270 Setup screen,
       as well as how to change them.

           {Table 1. Changing values in the TN3270 Setup screen}
    Ŀ
     Field       Description                    To Change             
    Ĵ
     Hostname  Lists the name, Internet         Highlight the         
               address or alias of the          Hostname field and    
               default 3270 host.  If a host    type a new name, IP   
               is specified, the next time      address or alias. This
               you log in you need not          new host becomes the  
               specify a hostname when you      default.              
               invoke the tn3270 command.                             
    Ĵ
     Display   Color or monochrome. If your PC  Highlight the Display 
     Mode      has a color monitor, Color is    mode field and press  
               the default. If your PC has a    the spacebar to toggle
               monochrome monitor, Mono is the  from Color to Mono    
               default. If you have a color                           
               monitor, you can change to Mono.                       
    Ĵ
     Port      The number of the TN3270 desti-  Highlight the Port    
     Number    nation port on the remote host.  Number field and type 
               The default is 23. If port 23    the new port number.  
               is being used on the remote                            
               host, use a different number.                          
    Ĵ
     Terminal  The terminal name is used for    Type the new terminal 
     Name      terminal-type negotiation when   type. Choose either   
               you begin a TN3270 session. The  IBM 3278 model 2 or   
               default is IBM-3278-2-E. This    model 2 enhanced.     
               stands for IBM 3278 model 2                            
               enhanced terminal.                                     
    Ĵ
     KB Map    Lists the keyboard remapping     Highlight this field  
     File      file you are using during        and type the name of  
               TN3270 sessions. You can use     the remapping file    
               TN_XTC.KBD, TN_ATC.KBD, or       you are using. If you 
               TN_ENHC.KBD.  These files        want to use a         
               correspond to the PC XT, the AT  remapping file that   
               and the AT Enhanced keyboards,   is in a directory     
               respectively. When you start a   other than the one    
               TN3270 session from DOS, TN3270  containing your       
               learns the type of keyboard you  TN3270 files, you     
               have and enters this into the    must specify the      
               3270.cfg file.  See "Remapping   full directory path   
               to a 3278 Keyboard" later in     for the file.         
               this section.                                          
    

{    Remapping to a 3278 Keyboard
{    ----------------------------

       The normal 3278 terminal has many keys that do not exist on the
       normal IBM PC XT, PC AT or PC AT Enhanced keyboards.  Therefore,
       the TN3270 emulator provides "Keyboard Remapping," a utility that
       maps the 3278 terminal keys to function keys on your PC. It
       provides a default mapping file for each type of PC keyboard. Each
       of these files shows how the PC keyboard keys are mapped to the
       3278 terminal keyboard. You can view the default settings in these
       files or you can remap the 3278 keys with different PC key
       combinations.

       To view or change the default keyboard remapping file, you cannot
       be connected to the IBM host. To display the file, invoke the
       following command from the DOS prompt:

           C:\LANTCP> keymap

       The "Keyboard Remapping" screen for the default keyboard appears.

       The "Keyboard Remapping" screen shows all the 3278 host function
       keys, and shows the default mapping provided by the TN3270
       emulator. You can remap the PC key assigned to many 3278 keys
       using any PC key shown on the screen that is highlighted.  The
       3278 keys do not change.  The PC keys mapped to each 3278 key can
       change. Assign any PC key to the given set of 3278 keys.

       Non-highlighted keys are not available for remapping. Some are
       already mapped; others cannot be mapped. You cannot map the
       alphanumeric keys, such as a, s, d, f, 1, 2, and 3.

       Each of the keys listed at the bottom of the screen can be mapped
       by itself, with the Shift key, the Ctrl key, or the Alt key. For
       example, if you want the F1 key on the PC keyboard to correspond to
       the PF1 key on the 3278 host, you can assign F1, or, alternatively,
       you can assign {Shift+F1}, {Ctrl+F1}, or {Alt+F1} (but you cannot
       assign more than one set of PC keys to one 3278 key).

       The PC keys are abbreviated on the Keyboard Remapping screens.
       The list below describes the meanings of these keys.

          Abbreviation     Key Sequence

           S_              Shift+
           C_              Control+
           A_              Alt+
           L_CTL           Left Control
           R_CTL           Right Control
           Ent             Enter
           PrS             Print Screen
           Ins             Insert
           Del             Delete
           NLK             Number Lock
           Hom             Home
           End             End
           PUp             Page Up
           PDn             Page Down
           P_              Keypad+key (press the key
                           indicated on the keypad)

       To see which Shift+function keys are assigned at any point, press
       the spacebar one time. The list of assigned keys at the bottom of
       the screen changes to show those assigned to the Shift+function
       keys.

       {Note...}     The assigned keys are not highlighted. The unassigned
                   (and available) keys are highlighted.

       Press the spacebar to see which Ctrl+function keys are assigned.
       Press it again to see which Alt+function keys are assigned.

       To remap your default keyboard after displaying it, follow
       this procedure:

           1. Use the arrow keys to move the cursor to the 3278 key you
              want to remap.

           2. Press {Delete} to remove the current PC key remapped to
              the specific 3278 key.

           3. Press the function key on your keyboard that you want
              to remap to the 3278 key.

       To return the keyboard remapping file to its default mapping, press
       {Alt+D}.

{    Example
{    -------

       To remove the S_F6 (Shift+F6) key from the PF18 key on the 3278
       host and use the A_F6 (Alt+F6) key instead, follow this procedure:

           1. Use the arrow keys to select S_F6.

           2. Press {Delete} to remove S_F6 from the PF18 key. (Note
              that if you press the spacebar to display the Shift keys
              assigned, then look at the bottom of the screen, you
              will see that the S_F6 key was now highlighted. This means
              the key is no longer mapped.)

           3. Press {Alt+F6} to assign that key to the PF18 key on the
              3278 host.

{    Exiting the Keymap File
{    -----------------------

       To save your changes and exit, press {Alt+S}. To exit without
       saving, press {Alt+X}.

{    Displaying Alternate Keyboards
{    ------------------------------

       You can open a keyboard mapping file other than the one that
       corresponds to your PC keyboard. You can also create new remapping
       files.  The TN3270 emulator permits you to create and save multiple
       keyboard remapping files for each style of keyboard.

       If you want to look at or alter a keyboard mapping file other than
       the one that corresponds to your PC keyboard, follow this
       procedure:

           1. Type:

              C:\LANTCP> keymap filename

              {filename} is the name of an existing or new keyboard
              remapping file you want to open. If the file exists, it
              opens and is shown on the screen. If the file does not
              already exist, a screen appears with a message asking you to
              enter the type of keyboard you would like to create.

           2. Type the number corresponding to the keyboard file you
              want to create {<Enter>}.

              The TN3270 emulator creates the file {filename} for you.
              When you press {Alt+S} to exit, the new file is saved.

       {Note...}     As indicated earlier, you can use this new file as
                   your default keyboard (see Table 1).

{  VT220 International Keyboard Support
{  ====================================

       Replace your default character set with the character set for a
       different language, if you are using 7-bit mode. Set up your system
       to use the multinational keyboard specified in your KEYB.COM file,
       if you are in 8-bit mode.

{    Character Set
{    -------------

       Multinational or National. The default is Multinational. This
       option uses the keyboard set up in the KEYB.COM file as your
       default. For example, if your KEYB.COM file is set up to French,
       and you want French remapping during a TELNET session, choose
       Multinational.

       If, after you enter a TELNET session, you want to use a National
       Replacement Character (NRC) set, choose National. The NRC set
       enables you to map your keyboard to the character set for another
       language. Refer to the next section, "Using International Keyboard
       Support" for more information about setting up your system for
       NRC sets.

{    Using International Keyboard Support
{    ------------------------------------

       This section describes how to:

           o Replace your default character set with the character
             set for a different language if you are using 7-bit mode.

           o Set up your system to use the multinational keyboard
             specified in your KEYB.COM file if you are in 8-bit mode.

       To use the international keyboard support option, you need to have
       VT220 set up as the default emulator in the ltcp_mgr program.

       If you are emulating a remote terminal in 8-bit mode, you need to
       configure your PC as follows:

           o MS-DOS must be configured with the capability of
             switching to Code Page 850 (Multilingual Character Set).

           o The PC must be set up with an EGA or better color
             monitor.

           o Include a statement in your CONFIG.SYS file such as:

                device=c:\dos\display.sys con=(ega,437,2)

           o Include the following statements in your AUTOEXEC.BAT file

                nlsfunc c:\dos\country.sys
                mode con cp prepare=((850) c:\dos\ega.cpi)

             or type them at the command line to execute them.

       If you are emulating a remote terminal in 7-bit mode, and if your
       applications use only the 7-bit mode ASCII character set or the DEC
       special graphics character set, you do NOT need to configure your
       PC as above.

       If you are emulating a remote terminal in 7-bit mode, your system
       is using the NRC set by default. You need to select the NRC set for
       the language you want to support:

           1. Enter a TELNET session.

           2. Press {Shift+F2}.

           3. The "Emulator Terminal Options" screen appears.

           4. Use the arrow keys to move the cursor down to the
              Select NRC Character Set box.

           5. The NRC Selection window appears, listing other
              character sets.

           6. Select the desired NRC set, then press {Alt+S} to save your
              changes and exit to the "Emulator Terminal Options" screen.

           7. Press {Alt+S} again to save your changes in the "Emulator
              Terminal Options" screen and exit to your TELNET session.

       If you are emulating a remote terminal in 8-bit mode, your
       system is using the multilingual keyboard specified in your
       KEYB.COM file. To make sure your system is using the multilingual
       keyboard, follow this procedure:

           1. Enter a TELNET session.

           2. Press {Shift+F2}.

           3. The "Emulator Terminal Options" screen appears.

           4. Use the arrow keys to move the cursor down to the
              Multinational check box.

           5. Press {Alt+S} to save your Terminal Emulator Options
              changes and exit to your TELNET session.

{  VT220 Keyboard Remapping
{  ========================

       The normal VT220 terminal has many keys that do not exist on the
       normal IBM PC keyboards. When you select VT220 as the terminal type
       in the LTCP Program, TELNET maps your keyboard as closely as
       possible to match a VT220 terminal keyboard.

       This section describes how keys on your PC keyboard have been
       mapped for use in VT220 mode, as well as how you can selectively
       remap PC keys to other functions.

       {Note...}     To map your keyboard to an international character
                   set, refer to your LANtastic for TCP/IP manual (Press
                   {Shift+F2}, move the cursor down to National, then move
                   the cursor to the Select NRC Character Set box. When
                   the NRC selection box appears, choose the character
                   set you want mapped to your keyboard and press {Alt+S}
                   to save your changes.)

       To begin remapping your PC keys, you must already be in a TELNET
       session. To remap your PC keys, press {Shift+F3}. The "Keyboard
       Mapping" screen appears with the default mapping.

       The "Keyboard Mapping" screen shows all the VT220 host function
       keys, and shows the default mapping provided by the TELNET
       emulator. Using any PC key, you can remap the PC key assigned to
       many VT220 keys. The VT220 keys do not change.  The PC keys mapped
       to each VT220 key can change. Assign any PC key to the given set
       of VT220 keys.

       To change the mapping, use the Up and Down arrow keys to move the
       cursor to the key you want to remap. Then enter the keystrokes that
       you want to initiate the VT220 function.

       You can map each VT220 function to a maximum of two keystrokes. If
       you try to map a third keystroke, the third keystroke replaces the
       previous keystrokes. If two keystrokes are mapped, either of the
       keystrokes can be used to initiate the VT220 function.

       {Note...}     The Alt key replaces the {Shift+Ctrl} keys. For
                   example, if you press {Shift+Ctrl+3}, Alt-3 appears in
                   the mapping screen, because you can have only two PC
                   key sequences mapped to any VT220 terminal key.

       If you delete or clear the mapping for a function, the remapping
       utility automatically inserts the default mapping value.

       {Note...}     Using keyboard remapping, you can map PC keys to the
                   same keys that are used for Help and Macros. If you do,
                   Help and macros supersede keyboard remapping key
                   sequences.

{  VT220 Color Support
{  ===================

       LANtastic for TCP/IP permits you to remap the attributes of your PC
       screen during a VT220 TELNET session. It permits you to change the
       background and foreground color, and to assign character
       underlining attributes. For example, you can change the screen
       color to white (background), the text color to blue (foreground),
       and the color that denotes underlined text (underline) to yellow.

       To change any of these attributes, display the "Screen Attribute
       Remapping" menu by pressing {Ctrl+Up arrow}.

       The keys you press to change the screen attributes are listed
       below.

               Key                    Attribute changed
               ---                    -----------------

          {Alt+Up arrow}     Changes the color of the screen foreground
                           (text that appears on the screen). Each time
                           you press {Alt+Up} arrow a different color
                           appears.

          {Alt+Down arrow}   Changes the color of the screen background
                           (the color of the screen). Each time you
                           press {Alt+Down} arrow a different color
                           appears.

          {Alt+Right arrow}
          {Alt+Left arrow}   Changes the color of underlined text.  For
                           example, if you issue a command that tells
                           the remote host to underline a block of text,
                           the text appears on the local PC in a text
                           box colored the shade you select. Cycle
                           through the choice of colors by pressing the
                           indicated keys.

          {Alt+R}            Resets the foreground, background, and
                           underline attributes back to their defaults.
                           The default is white text on a black
                           background with underlined text in reverse
                           video (black on white).

          {Alt+S}            Saves the changes you have made to screen
                           attributes since you began this session and
                           exits. Changes you save remain in effect
                           during subsequent TELNET sessions.

          {Esc}              Exits from the attribute remapping menu
                           without saving any changes you made during
                           this session.

       If you set screen attributes during a TELNET session, the
       attributes remain in effect during each subsequent VT220
       character-mode TELNET session.

{  Special Note
{  ============

{    Using TELWIN.EXE
{    ----------------

       When a terminal emulation session needs to be started from a
       Windows DOS box, type TELWIN, not TELNET.
