1TN5250(1)                   General Commands Manual                  TN5250(1)
2
3
4

NAME

6       tn5250 - an implementation of the 5250 telnet protocol
7

SYNOPSIS

9       tn5250 [OPTIONS] HOSTNAME
10       xt5250 [OPTIONS] HOSTNAME
11       tn5250 -version
12

DESCRIPTION

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
19       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
24       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

OPTIONS

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

USAGE

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
37   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
44       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
67       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
83       1. Which keys generate f11-f24, backtab, backspace and delete  is  very
84          dependent on the configuration of the terminal.
85
86       2. + and - only work as Field+ and Field- in signed numeric fields.
87
88   Display
89       The  screen  display  tries  to  be the same as a colour 5250 terminal.
90       There are some unavoidable differences though:
91
92       ·  ASCII terminals (and curses) do not support the 5250 column  separa‐
93          tors.
94
95       ·  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
99       ·  Some terminals (such as xterm) do not support blinking text.
100

EXAMPLES

102       These are some examples of the use of tn5250:
103
104       tn5250 as400sys
105              Connect  to  the  system as400sys, using the default translation
106              map (37) and a generated session name (QPADEV####).
107
108       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

BUGS

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

SEE ALSO

118       tn5250rc(5),   lp5250d(1),   http://tn5250.sourceforge.net/,   RFC1205,
119       RFC2877, II10918.
120
122       tn5250 is copyright 1997 - 2001 Michael Madore.  This manpage is  copy‐
123       right 1999 - 2001 Carey Evans.
124
125       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
130       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
135       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

AUTHORS

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
145
146
147                               12 November 2001                      TN5250(1)
Impressum