TN5250(1)

✨ TN5250 ✨

okay bestie, welcome to the TN5250(1) page from the General Commands Manual 💖 this is the whole vibe: tn5250 is literally an implementation of the 5250 telnet protocol. no cap. sit down, grab a 🍓, and let's get into it.

---

🌸 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 so you can connect over TCP/IP to an IBM AS/400. 💅 The terminal emulation works on any local terminal supported by curses, and it provides 132x27 and full colour support where possible. it's giving main character energy, honestly.

An IBM 5250 terminal supports a number of special keys, and does a lot of processing itself before sending data to the host system. and because a standard ASCII terminal does not support all these keys, tn5250 uses control sequences to perform the operations. the way it has to work around the keyboard... iconic honestly. 🧚

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. iykyk. 💜

---

✨ OPTIONS ✨

tn5250 options are described in the tn5250rc(5) man page. that's it, that's the section — go read that one, bestie, it's where all the flags live. 🙈

---

👑 USAGE 👑

This manual assumes that you are familiar with a real 5250 terminal, or another 5250 emulator, and only describes features relevant to tn5250 itself. so like, we're not re-teaching you the whole 5250 thing, we're just doing the tn5250-specific part. periodt. 💅

🌈 Keyboard Mapping 🌈

The following list shows 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. 🎹

• 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 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####). lowkey the easiest way in 🫶
• 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. look at her go ✨

---

🎀 BUGS 🎀

Please report any bugs you find to https://github.com/tn5250/tn5250/issues — do not suffer in silence, bestie, tell the devs 💖

---

🌟 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 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.

---

and that's the whole page, bestie 💅✨ this little write-up is dated 12 November 2001 and it lives under the name TN5250 — go slay some AS/400 sessions, ily 🫶🎀🦋