1TN5250(1) General Commands Manual TN5250(1)
2
6 tn5250 - an implementation of the 5250 telnet protocol
7
9 tn5250 [OPTIONS] HOSTNAME
10 xt5250 [OPTIONS] HOSTNAME
11 tn5250 -version
12
14 tn5250 emulates IBM's 5250 compatible terminals to connect over TCP/IP
15 to an IBM AS/400. The terminal emulation works on any local terminal
16 supported by curses, and provides 132x27 and full colour support where
17 possible.
18 An IBM 5250 terminal supports a number of special keys, and does a lot
20 of processing itself before sending data to the host system. Because a
21 standard ASCII terminal does not support all these keys, tn5250 uses
22 control sequences to perform the operations.
23 Named session support (with the env.DEVNAME option) is available for
25 most versions of OS/400, but is only supplied with V4R3 and later ver‐
26 sions. For V3R2, V3R7, V4R1 and V4R2, please see informational APAR
27 II10918.
28
30 tn5250 options are described in the tn5250rc(5) man page.
31
33 This manual assumes that the user is familiar with a real 5250 termi‐
34 nal, or another 5250 emulator, and only describes features relevant to
35 tn5250 itself.
36 Keyboard Mapping
38 The following table lists the 5250 functions implemented by tn5250, and
39 the corresponding keypresses. Keys are represented as Emacs does: C-a
40 means hold Ctrl and press A, M-a means press Esc or C-g followed by A,
41 and C-M-a means press Esc or C-g followed by C-a. Most setups also let
42 you use the Alt or Meta key for M- keypresses.
43 Function Keypress
45 ────────────────────────────────────────
46 F1 - F10 f1 to f10, M-1 to M-
47 F11 f11 [1], M--
48 F12 f12 [1], M-=
49 F13 - F24 f13 to f24 [1], M-! to M-+
50 Enter return, enter, C-j, C-m
51 Left left
52 Right right
53 Up up
54 Down down
55 Roll Up next, pagedown, C-d, C-f
56 Roll Down prev, pageup, C-b, C-u
57 Backspace backspace [1]
58 Home home, C-o
59 End end
60 Insert insert, M-i, M-delete
61 Delete delete [1]
62 Reset C-r, M-r
63 Print C-p, M-p
64 Help M-h
65 SysReq C-c, M-s
66 Clear M-c
68 FieldExit C-k, M-x
69 TestReq C-t
70 Toggle M-t
71 Erase C-e
72 Attn C-a, M-a
73 Dup M-d
74 Field+ C-x, + [2]
75 Field- M-m, - [2]
76 NewLine C-M-j
77 Next Field tab, C-i
78 Prev Field backtab [1]
79 ────────────────────────────────────────
80 Refresh C-l, M-l
81 Quit C-q
82 1. Which keys generate f11-f24, backtab, backspace and delete is very
84 dependent on the configuration of the terminal.
85 2. + and - only work as Field+ and Field- in signed numeric fields.
87 Display
89 The screen display tries to be the same as a colour 5250 terminal.
90 There are some unavoidable differences though:
91 · ASCII terminals (and curses) do not support the 5250 column separa‐
93 tors.
94 · Some terminals (mostly ones based on the VGA text mode) do not sup‐
96 port underlining. If this is the case and tn5250 does not detect it
97 automatically, you should pass the -u option.
98 · Some terminals (such as xterm) do not support blinking text.
100
102 These are some examples of the use of tn5250:
103 tn5250 as400sys
105 Connect to the system as400sys, using the default translation
106 map (37) and a generated session name (QPADEV####).
107 tn5250 map=870 env.DEVNAME=session1 env.TERM=IBM-3477-FC as400sys
109 Connect to as400sys using the translation map for CCSID 870
110 (Eastern Europe), the session name SESSION1 and with a terminal
111 supporting colour and a 132x27 display.
112
114 Please report any bugs you find to the bug tracker or to the linux5250
115 mailing list. See the tn5250 web site for more details.
116
118 tn5250rc(5), lp5250d(1), http://tn5250.sourceforge.net/, RFC1205,
119 RFC2877, II10918.
120
122 tn5250 is copyright 1997 - 2008 Michael Madore. This manpage is copy‐
123 right 1999 - 2008 Carey Evans.
124 This program is free software; you can redistribute it and/or modify it
126 under the terms of the GNU Lesser General Public License as published
127 by the Free Software Foundation; either version 2.1 of the License, or
128 (at your option) any later version.
129 This program is distributed in the hope that it will be useful, but
131 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
132 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
133 General Public License for more details.
134 You should have received a copy of the GNU Lesser General Public
136 License along with this program; if not, write to the Free Software
137 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
138 USA
139
141 tn5250 was written by Michael Madore, Jay Felice, Scott Klement and
142 others; see the AUTHORS file for details. This manual page was written
143 by Carey Evans.
144 12 November 2001 TN5250(1)