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 env.VARIABLE=VALUE
123 Set any other environment variables controlling the terminal
124 session. A list of relevant variables is given in section 5 of
125 RFC2877.
126 Printer Options
128 outputcommand=COMMAND
129 Set the command that will be run to receive printer output. The
130 default command is `scs2ascii |lpr'.
131 env.IBMMFRTYPMDL=NAME
133 Set the name of the host print transform description to use on
134 the AS/400. This is the same as the MFRTYPMDL parameter on the
135 CRTDEVPRT command. See the CL Reference or the online help for
136 a list of valid values.
137 env.VARIABLE=VALUE
139 Set any other environment variables controlling the printer ses‐
140 sion. A list of relevant variables is given in section 7 of
141 RFC2877. More generally, the variables are the parameters of
142 the CRTDEVPRT command, with a prefix of IBM.
143
145 Protocols
146 The supported protocols for the emulation session are listed below.
147 telnet Connect to the AS/400 using a normal unencrypted telnet connec‐
149 tion. tn5250 is an alias for telnet.
150 ssl Connect securely using an encrypted SSL session. This option is
152 only available if tn5250 was compiled with SSL support.
153 debug Instead of connecting to a server, replay the trace generated by
155 the trace option. The path to the trace file should be given
156 instead of the hostname.
157 Translation Maps
159 CCSIDs on the AS/400 are listed in Appendix G of IBM manual
160 SC41-5101-01, AS/400 National Language Support. This manual is avail‐
161 able on the web at <http://publib.boulder.ibm.com/cgi-bin/book‐
162 mgr/BOOKS/QB3AWC01/G.2>.
163 Currently recognised values for the translation map are: 37, 256, 273,
165 277, 278, 280, 284, 285, 290, 297, 420, 424, 500, 870, 871, 875, 880,
166 905, and 1026. Most of these are translated to ISO-8859-1, also known
167 as Latin 1. Some of them contain characters only present in another
168 encoding, which is used instead. The valid CCSID values, and the Unix
169 encoding used, are listed below.
170 CCSID Unix encoding Description
172 ─────────────────────────────────────────────────────
173 37 ISO-8859-1 US, Canada, Netherlands,
174 Portugal, Brazil, Australia,
175 New Zealand
176 256 ISO-8859-1 Netherlands
177 273 ISO-8859-1 Austria, Germany
178 277 ISO-8859-1 Denmark, Norway
179 278 ISO-8859-1 Finland, Sweden
180 280 ISO-8859-1 Italy
181 284 ISO-8859-1 Spanish, Latin America
182 285 ISO-8859-1 United Kingdom
183 290 JIS_X0201 Katakana Extended
184 297 ISO-8859-1 France
185 420 ISO-8859-6 Arabic
186 424 ISO-8859-8 Hebrew
187 500 ISO-8859-1 Belgium, Canada, Switzerland
188 870 ISO-8859-2 Eastern Europe
189 871 ISO-8859-1 Iceland
190 875 ISO-8859-7 Greek
191 880 ISO-8859-5 Cyrillic
192 905 ISO-8859-3 Turkey - Latin3
193 1026 ISO-8859-9 Turkey - Latin5
194 If possible, configure your terminal to use the appropriate encoding if
196 your AS/400 uses any of these CCSIDs.
197 Display Types
199 The following values are valid for the env.TERM option.
200 Name Description
202 ────────────────────────────────────
203 IBM-3179-2 24x80 color
204 IBM-3180-2 27x132 monochrome
205 IBM-3196-A1 24x80 monochrome
206 IBM-3477-FC 27x132 color
207 IBM-3477-FG 27x132 monochrome
208 IBM-5251-11 24x80 monochrome
209 IBM-5291-1 24x80 monochrome
210 IBM-5292-2 24x80 color
211
213 Define a connection named dsp01 that connects to the machine
214 iseries.example.com, using the German CCSID, a 132 column terminal, and
215 printing underscore characters instead of using underlines.
216 disp01 {
218 host = iseries.example.com
219 map = 273
220 env.TERM = IBM-3477-FC
221 +underscores
222 }
223 Define a printer connection, using host print transform to produce PCL
225 output for an HP Laserjet compatible printer.
226 print01 {
228 host = iseries.example.com
229 env.DEVNAME = HPLJ01
230 env.IBMMFRTYPMDL = *HP4
231 }
232 Define a secure SSL session, checking the server's certificate against
234 the CA certificare stored in cacert.pem, and using the client certifi‐
235 cate in jbloggs.pem to sign on automatically.
236 secure01 {
238 host = iseries.example.com
239 +ssl_verify_server
240 ssl_ca_file = cacert.pem
241 ssl_cert_file = jbloggs.pem
242 }
243
245 tn5250(1), lp5250d(1), http://tn5250.sourceforge.net/, RFC1205,
246 RFC2877, II10918.
247
249 tn5250 is copyright 1997 - 2001 Michael Madore. This manpage is copy‐
250 right 2001 Carey Evans.
251 This program is free software; you can redistribute it and/or modify it
253 under the terms of the GNU Lesser General Public License as published
254 by the Free Software Foundation; either version 2.1 of the License, or
255 (at your option) any later version.
256 This program is distributed in the hope that it will be useful, but
258 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
259 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
260 General Public License for more details.
261 You should have received a copy of the GNU Lesser General Public
263 License along with this program; if not, write to the Free Software
264 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
265 USA
266
268 tn5250 was written by Michael Madore, Jay Felice, Scott Klement and
269 others; see the AUTHORS file for details. This manual page was written
270 by Carey Evans.
271 12 November 2001 TN5250RC(5)