1TN5250RC(5) File Formats Manual TN5250RC(5)
2
6 tn5250rc - tn5250 and lp5250d configuration file
7
9 The tn5250rc file contains groups of options for tn5250 and lp5250d.
10 When a hostname is passed to one of these programs, the named group is
11 looked up in tn5250rc, and any options given in that group are pro‐
12 cessed.
13 If a named group is found, and defines a host option, that option spec‐
15 ifies the server. Otherwise, the host parameter to the program is used.
16 A group of options looks like this:
18 groupname {
20 +boolean
21 option=value
22 ...
23 }
24 Each group of options starts with the group name, followed by a left
26 brace (curly bracket) character. Following lines should have one option
27 on each line. The last line of the group has a single right brace.
28 The global tn5250rc file may be overridden by the user's ~/.tn5250rc
30 file.
31
33 The options given here may be used inside a section of the configura‐
34 tion file, or on the tn5250 or lp5250d command line. Most options take
35 the form OPTION=VALUE. Options listed with a leading +/- can be either
36 turned on (+OPTION) or off (-OPTION).
37 Common Options
39 These options apply to both printer and display emulation sessions.
40 host=URL
42 Set the host to connect to. The URL is of the form [PROTO‐
43 COL:]HOSTNAME[:PORT]. The default protocol, if not supplied, is
44 tn5250. See Protocols below for descriptions of the available
45 protocols.
46 map=CCSID
48 Set the translation table between ASCII and EBCDIC. This should
49 match the CCSID of the interactive job. The default is 37. See
50 Translation Maps below for more information.
51 env.DEVNAME=NAME
53 Set the device name for the AS/400 to assign to the 5250 ses‐
54 sion. This should be up to ten characters long and consist of
55 only letters and numbers. It will be converted to uppercase and
56 used as the name of the 5250-compatible device on the AS/400.
57 There may only be one session active with any given name at one
58 time.
59 trace=TRACEFILE
61 Log all actions to TRACEFILE. This file will get very large,
62 and may contain sensitive information such as the password used
63 to log in.
64 +/-ssl_verify_server
66 If set, then verify that the server's certificate was issued by
67 a CA in the file given by the ssl_ca_file option. If the cer‐
68 tificate's issuer cannot be verified, do not connect to the
69 server.
70 ssl_ca_file=CAFILE
72 Specify the file containing the certificate for the CA that
73 issued the server's certificate. If the server certificate is
74 self-signed, CAFILE should contain the certificate displayed by
75 the Digital Certificate Manager option Copy and paste certifi‐
76 cate.
77 ssl_cert_file=CERTFILE
79 Specify the file containing the personal certificate, in PEM
80 format. This must be a certificate associated with your user
81 profile on the AS/400 by DCM.
82 ssl_pem_pass=PASSWORD
84 If the personal certificate given by ssl_cert_file is password
85 protected, the password may be given here to bypass the password
86 prompt.
87 Display Options
89 These options are specific to tn5250 and xt5250.
90 +/-underscores
92 Force or disable the use of underscore characters instead of the
93 underline attribute, for terminals that do not support underlin‐
94 ing but where tn5250 does not work this out itself.
95 +/-ruler
97 Turn the ruler feature on or off. When enabled, the row and
98 column of the cursor will be highlighted.
99 env.TERM=MODEL
101 Set the terminal model name for the emulation session to use.
102 The default depends on whether the terminal supports colour, and
103 whether it is large enough to support the large terminal size.
104 See Display Types below for valid model names.
105 The default model emulated is an IBM-3179-2, a 24x80 colour ter‐
107 minal.
108 font_80=FONT
110 If tn5250 is running in an xterm, sets the font to change to
111 when the terminal is in 80 column mode. This should be a valid
112 X font name, such as can be chosen with xfontsel.
113 font_132=FONT
115 If the emulated terminal has a size of 27x132, set the font to
116 use in 132 column mode, as for the font_80 option.
117 beep_command=COMMAND
119 If present, will run the supplied command instead of using the
120 terminal beep.
121 +/-uninhibited
123 If enabled, automatically resets the input inhibited state when
124 cursor movement keys or function keys are pressed. The default
125 is disabled.
126 env.VARIABLE=VALUE
128 Set any other environment variables controlling the terminal
129 session. A list of relevant variables is given in section 5 of
130 RFC2877.
131 Printer Options
133 outputcommand=COMMAND
134 Set the command that will be run to receive printer output. The
135 default command is `scs2ascii |lpr'.
136 env.IBMMFRTYPMDL=NAME
138 Set the name of the host print transform description to use on
139 the AS/400. This is the same as the MFRTYPMDL parameter on the
140 CRTDEVPRT command. See the CL Reference or the online help for
141 a list of valid values.
142 env.VARIABLE=VALUE
144 Set any other environment variables controlling the printer ses‐
145 sion. A list of relevant variables is given in section 7 of
146 RFC2877. More generally, the variables are the parameters of
147 the CRTDEVPRT command, with a prefix of IBM.
148
150 Protocols
151 The supported protocols for the emulation session are listed below.
152 telnet Connect to the AS/400 using a normal unencrypted telnet connec‐
154 tion. tn5250 is an alias for telnet.
155 ssl Connect securely using an encrypted SSL session. This option is
157 only available if tn5250 was compiled with SSL support.
158 debug Instead of connecting to a server, replay the trace generated by
160 the trace option. The path to the trace file should be given
161 instead of the hostname.
162 Translation Maps
164 CCSIDs on the AS/400 are listed in Appendix G of IBM manual
165 SC41-5101-01, AS/400 National Language Support. This manual is avail‐
166 able on the web at <http://publib.boulder.ibm.com/cgi-bin/book‐
167 mgr/BOOKS/QB3AWC01/G.2>.
168 Currently recognised values for the translation map are: 37, 256, 273,
170 277, 278, 280, 284, 285, 290, 297, 420, 424, 500, 870, 871, 875, 880,
171 905, and 1026. Most of these are translated to ISO-8859-1, also known
172 as Latin 1. Some of them contain characters only present in another
173 encoding, which is used instead. The valid CCSID values, and the Unix
174 encoding used, are listed below.
175 CCSID Unix encoding Description
177 ─────────────────────────────────────────────────────
178 37 ISO-8859-1 US, Canada, Netherlands,
179 Portugal, Brazil, Australia,
180 New Zealand
181 256 ISO-8859-1 Netherlands
182 273 ISO-8859-1 Austria, Germany
183 277 ISO-8859-1 Denmark, Norway
184 278 ISO-8859-1 Finland, Sweden
185 280 ISO-8859-1 Italy
186 284 ISO-8859-1 Spanish, Latin America
187 285 ISO-8859-1 United Kingdom
188 290 JIS_X0201 Katakana Extended
189 297 ISO-8859-1 France
190 420 ISO-8859-6 Arabic
191 424 ISO-8859-8 Hebrew
192 500 ISO-8859-1 Belgium, Canada, Switzerland
193 870 ISO-8859-2 Eastern Europe
194 871 ISO-8859-1 Iceland
195 875 ISO-8859-7 Greek
196 880 ISO-8859-5 Cyrillic
197 905 ISO-8859-3 Turkey - Latin3
198 1026 ISO-8859-9 Turkey - Latin5
199 If possible, configure your terminal to use the appropriate encoding if
201 your AS/400 uses any of these CCSIDs.
202 Display Types
204 The following values are valid for the env.TERM option.
205 Name Description
207 ────────────────────────────────────
208 IBM-3179-2 24x80 color
209 IBM-3180-2 27x132 monochrome
210 IBM-3196-A1 24x80 monochrome
211 IBM-3477-FC 27x132 color
212 IBM-3477-FG 27x132 monochrome
213 IBM-5251-11 24x80 monochrome
214 IBM-5291-1 24x80 monochrome
215 IBM-5292-2 24x80 color
216
218 Define a connection named dsp01 that connects to the machine
219 iseries.example.com, using the German CCSID, a 132 column terminal, and
220 printing underscore characters instead of using underlines.
221 disp01 {
223 host = iseries.example.com
224 map = 273
225 env.TERM = IBM-3477-FC
226 +underscores
227 }
228 Define a printer connection, using host print transform to produce PCL
230 output for an HP Laserjet compatible printer.
231 print01 {
233 host = iseries.example.com
234 env.DEVNAME = HPLJ01
235 env.IBMMFRTYPMDL = *HP4
236 }
237 Define a secure SSL session, checking the server's certificate against
239 the CA certificare stored in cacert.pem, and using the client certifi‐
240 cate in jbloggs.pem to sign on automatically.
241 secure01 {
243 host = iseries.example.com
244 +ssl_verify_server
245 ssl_ca_file = cacert.pem
246 ssl_cert_file = jbloggs.pem
247 }
248
250 tn5250(1), lp5250d(1), http://tn5250.sourceforge.net/, RFC1205,
251 RFC2877, II10918.
252
254 tn5250 is copyright 1997 - 2008 Michael Madore. This manpage is copy‐
255 right 2001 - 2008 Carey Evans.
256 This program is free software; you can redistribute it and/or modify it
258 under the terms of the GNU Lesser General Public License as published
259 by the Free Software Foundation; either version 2.1 of the License, or
260 (at your option) any later version.
261 This program is distributed in the hope that it will be useful, but
263 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
264 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
265 General Public License for more details.
266 You should have received a copy of the GNU Lesser General Public
268 License along with this program; if not, write to the Free Software
269 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
270 USA
271
273 tn5250 was written by Michael Madore, Jay Felice, Scott Klement and
274 others; see the AUTHORS file for details. This manual page was written
275 by Carey Evans.
276 12 November 2001 TN5250RC(5)