Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
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  terminal  sup-
     ported  by curses, and provides 132x27 and full colour support where possi-
     ble.

     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 stan-
     dard 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 versions.  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  it-
     self.

   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]
     ------------------------------------------
     Toggle mouse   C-v
     Refresh	    C-l, M-l
     Quit	    C-q

     1. Which keys generate f11-f24, backtab, backspace and delete is  very  de-
	pendent 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:

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

     *	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 automat-
	ically, you should pass the -u option.

     *	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  supporting
	    colour and a 132x27 display.

BUGS
     Please report any bugs you find to https://github.com/tn5250/tn5250/issues

SEE ALSO
     tn5250rc(5),   lp5250d(1),   https://tn5250.github.io/,  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 un-
     der  the terms of the GNU Lesser General Public License as published 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 MERCHANTABILITY or FIT-
     NESS 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  Foundation,
     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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=tn5250&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help