---
name: "tn5250"
section: "1"
platform: "linux"
package: "tn5250"
version: "0.17.4-2"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/tn5250"
---

# tn5250(1)

an implementation of the 5250 telnet protocol

## 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 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 versions.  For V3R2, V3R7, V4R1 and V4R2, please see informational APAR II10918.

## OPTIONS

**tn5250** options are described in the [**tn5250rc**(5)](/tn5250rc/5.md) 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 |
|
| **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:

- •

  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 automatically, 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 the bug tracker or to the linux5250 mailing list.  See the **tn5250** web site for more details.

## SEE ALSO

[**tn5250rc**(5)](/tn5250rc/5.md), [**lp5250d**(1)](/lp5250d/1.md), **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 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 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 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.