TN5250(1)						      General Commands Manual							 TN5250(1)

NAME

       tn5250 - an implementation of the 5250 telnet protocol

SYNOPSIS

       tn5250 [OPTIONS] HOSTNAME
       xt5250 [OPTIONS] HOSTNAME
       tn5250 -version

DESCRIPTION

       tn5250  emulates IBM's 5250 compatible terminals to connect over TCP/IP to an IBM AS/400.  The terminal emulation works on any local termi-
       nal supported by curses, and provides 132x27 and full colour support where possible.

       An IBM 5250 terminal supports a number of special keys, and does a lot of processing  itself  before  sending  data  to	the  host  system.
       Because a standard ASCII terminal does not support all these keys, tn5250 uses control sequences to perform the operations.

       Named session support (with the env.DEVNAME option) is available for most versions of OS/400, but is only supplied with V4R3 and later ver-
       sions.  For V3R2, V3R7, V4R1 and V4R2, please see informational APAR II10918.

OPTIONS

       tn5250 options are described in the tn5250rc(5) man page.

USAGE

       This manual assumes that the user is familiar with a real 5250 terminal, or another 5250 emulator, and only describes features relevant	to
       tn5250 itself.

   Keyboard Mapping
       The  following table lists the 5250 functions implemented by tn5250, and the corresponding keypresses.  Keys are represented as Emacs does:
       C-a means hold Ctrl and press A, M-a means press Esc or C-g followed by A, and C-M-a means press Esc or C-g followed by C-a.   Most  setups
       also let you use the Alt or Meta key for M- keypresses.

       Function     Keypress
       ----------------------------------------
       F1 - F10     f1 to f10, M-1 to M-
       F11	    f11 [1], M--
       F12	    f12 [1], M-=
       F13 - F24    f13 to f24 [1], M-! to M-+
       Enter	    return, enter, C-j, C-m
       Left	    left
       Right	    right
       Up	    up
       Down	    down
       Roll Up	    next, pagedown, C-d, C-f
       Roll Down    prev, pageup, C-b, C-u
       Backspace    backspace [1]
       Home	    home, C-o
       End	    end
       Insert	    insert, M-i, M-delete
       Delete	    delete [1]
       Reset	    C-r, M-r
       Print	    C-p, M-p
       Help	    M-h
       SysReq	    C-c, M-s
       Clear	    M-c
       FieldExit    C-k, M-x
       TestReq	    C-t
       Toggle	    M-t
       Erase	    C-e
       Attn	    C-a, M-a
       Dup	    M-d
       Field+	    C-x, + [2]
       Field-	    M-m, - [2]

       NewLine	    C-M-j
       Next Field   tab, C-i
       Prev Field   backtab [1]
       ----------------------------------------
       Refresh	    C-l, M-l
       Quit	    C-q

       1. Which keys generate f11-f24, backtab, backspace and delete is very dependent on the configuration of the terminal.

       2. + and - only work as Field+ and Field- in signed numeric fields.

   Display
       The screen display tries to be the same as a colour 5250 terminal.  There are some unavoidable differences though:

       o  ASCII terminals (and curses) do not support the 5250 column separators.

       o  Some	terminals  (mostly ones based on the VGA text mode) do not support underlining.  If this is the case and tn5250 does not detect it
	  automatically, you should pass the -u option.

       o  Some terminals (such as xterm) do not support blinking text.

EXAMPLES

       These are some examples of the use of tn5250:

       tn5250 as400sys
	      Connect to the system as400sys, using the default translation map (37) and a generated session name (QPADEV####).

       tn5250 map=870 env.DEVNAME=session1 env.TERM=IBM-3477-FC as400sys
	      Connect to as400sys using the translation map for CCSID 870 (Eastern Europe), the session name SESSION1 and with a terminal support-
	      ing colour and a 132x27 display.

BUGS

       Please report any bugs you find to the bug tracker or to the linux5250 mailing list.  See the tn5250 web site for more details.

SEE ALSO

       tn5250rc(5), lp5250d(1), http://tn5250.sourceforge.net/, RFC1205, RFC2877, II10918.

COPYRIGHT

       tn5250 is copyright 1997 - 2008 Michael Madore.	This manpage is copyright 1999 - 2008 Carey Evans.

       This  program  is  free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as pub-
       lished by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

       This program is distributed in the hope that it will be useful, but WITHOUT ANY	WARRANTY;  without  even  the  implied	warranty  of  MER-
       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for more details.

       You  should have received a copy of the GNU Lesser General Public License along with this program; if not, write to the Free Software Foun-
       dation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

AUTHORS

       tn5250 was written by Michael Madore, Jay Felice, Scott Klement and others; see the AUTHORS file for details.  This manual page was written
       by Carey Evans.

								 12 November 2001							 TN5250(1)