DragonFly On-Line Manual Pages
TN5250RC(5) DragonFly File Formats Manual TN5250RC(5)
NAME
tn5250rc - tn5250 and lp5250d configuration file
DESCRIPTION
The tn5250rc file contains groups of options for tn5250 and lp5250d.
When a hostname is passed to one of these programs, the named group is
looked up in tn5250rc, and any options given in that group are
processed.
If a named group is found, and defines a host option, that option
specifies the server. Otherwise, the host parameter to the program is
used.
A group of options looks like this:
groupname {
+boolean
option=value
...
}
Each group of options starts with the group name, followed by a left
brace (curly bracket) character. Following lines should have one option
on each line. The last line of the group has a single right brace.
The global tn5250rc file may be overridden by the user's ~/.tn5250rc
file.
OPTIONS
The options given here may be used inside a section of the
configuration file, or on the tn5250 or lp5250d command line. Most
options take the form OPTION=VALUE. Options listed with a leading */-
can be either turned on (+OPTION) or off (-OPTION).
Common Options
These options apply to both printer and display emulation sessions.
host=URL
Set the host to connect to. The URL is of the form
[PROTOCOL:]HOSTNAME[:PORT]. The default protocol, if not
supplied, is tn5250. See Protocols below for descriptions of
the available protocols.
map=CCSID
Set the translation table between ASCII and EBCDIC. This should
match the CCSID of the interactive job. The default is 37. See
Translation Maps below for more information.
env.DEVNAME=NAME
Set the device name for the AS/400 to assign to the 5250
session. This should be up to ten characters long and consist
of only letters and numbers. It will be converted to uppercase
and used as the name of the 5250-compatible device on the
AS/400. There may only be one session active with any given
name at one time.
trace=TRACEFILE
Log all actions to TRACEFILE. This file will get very large,
and may contain sensitive information such as the password used
to log in.
*/-ssl_verify_server
If set, then verify that the server's certificate was issued by
a CA in the file given by the ssl_ca_file option. If the
certificate's issuer cannot be verified, do not connect to the
server.
ssl_ca_file=CAFILE
Specify the file containing the certificate for the CA that
issued the server's certificate. If the server certificate is
self-signed, CAFILE should contain the certificate displayed by
the Digital Certificate Manager option Copy and paste
certificate.
ssl_cert_file=CERTFILE
Specify the file containing the personal certificate, in PEM
format. This must be a certificate associated with your user
profile on the AS/400 by DCM.
ssl_pem_pass=PASSWORD
If the personal certificate given by ssl_cert_file is password
protected, the password may be given here to bypass the password
prompt.
Display Options
These options are specific to tn5250 and xt5250.
*/-underscores
Force or disable the use of underscore characters instead of the
underline attribute, for terminals that do not support
underlining but where tn5250 does not work this out itself.
*/-ruler
Turn the ruler feature on or off. When enabled, the row and
column of the cursor will be highlighted.
env.TERM=MODEL
Set the terminal model name for the emulation session to use.
The default depends on whether the terminal supports colour, and
whether it is large enough to support the large terminal size.
See Display Types below for valid model names.
The default model emulated is an IBM-3179-2, a 24x80 colour
terminal.
font_80=FONT
If tn5250 is running in an xterm, sets the font to change to
when the terminal is in 80 column mode. This should be a valid
X font name, such as can be chosen with xfontsel.
font_132=FONT
If the emulated terminal has a size of 27x132, set the font to
use in 132 column mode, as for the font_80 option.
beep_command=COMMAND
If present, will run the supplied command instead of using the
terminal beep.
*/-uninhibited
If enabled, automatically resets the input inhibited state when
cursor movement keys or function keys are pressed. The default
is disabled.
env.VARIABLE=VALUE
Set any other environment variables controlling the terminal
session. A list of relevant variables is given in section 5 of
RFC2877.
Printer Options
outputcommand=COMMAND
Set the command that will be run to receive printer output. The
default command is `scs2ascii |lpr'.
env.IBMMFRTYPMDL=NAME
Set the name of the host print transform description to use on
the AS/400. This is the same as the MFRTYPMDL parameter on the
CRTDEVPRT command. See the CL Reference or the online help for
a list of valid values.
env.VARIABLE=VALUE
Set any other environment variables controlling the printer
session. A list of relevant variables is given in section 7 of
RFC2877. More generally, the variables are the parameters of
the CRTDEVPRT command, with a prefix of IBM.
OPTION VALUES
Protocols
The supported protocols for the emulation session are listed below.
telnet Connect to the AS/400 using a normal unencrypted telnet
connection. tn5250 is an alias for telnet.
ssl Connect securely using an encrypted SSL session. This option is
only available if tn5250 was compiled with SSL support.
debug Instead of connecting to a server, replay the trace generated by
the trace option. The path to the trace file should be given
instead of the hostname.
Translation Maps
CCSIDs on the AS/400 are listed in Appendix G of IBM manual
SC41-5101-01, AS/400 National Language Support. This manual is
available on the web at
<http://publib.boulder.ibm.com/cgi-bin/bookmgr/BOOKS/QB3AWC01/G.2>.
Currently recognised values for the translation map are: 37, 256, 273,
277, 278, 280, 284, 285, 290, 297, 420, 424, 500, 870, 871, 875, 880,
905, and 1026. Most of these are translated to ISO-8859-1, also known
as Latin 1. Some of them contain characters only present in another
encoding, which is used instead. The valid CCSID values, and the Unix
encoding used, are listed below.
CCSID Unix encoding Description
-----------------------------------------------------
37 ISO-8859-1 US, Canada, Netherlands,
Portugal, Brazil, Australia,
New Zealand
256 ISO-8859-1 Netherlands
273 ISO-8859-1 Austria, Germany
277 ISO-8859-1 Denmark, Norway
278 ISO-8859-1 Finland, Sweden
280 ISO-8859-1 Italy
284 ISO-8859-1 Spanish, Latin America
285 ISO-8859-1 United Kingdom
290 JIS_X0201 Katakana Extended
297 ISO-8859-1 France
420 ISO-8859-6 Arabic
424 ISO-8859-8 Hebrew
500 ISO-8859-1 Belgium, Canada, Switzerland
870 ISO-8859-2 Eastern Europe
871 ISO-8859-1 Iceland
875 ISO-8859-7 Greek
880 ISO-8859-5 Cyrillic
905 ISO-8859-3 Turkey - Latin3
1026 ISO-8859-9 Turkey - Latin5
If possible, configure your terminal to use the appropriate encoding if
your AS/400 uses any of these CCSIDs.
Display Types
The following values are valid for the env.TERM option.
Name Description
------------------------------------
IBM-3179-2 24x80 color
IBM-3180-2 27x132 monochrome
IBM-3196-A1 24x80 monochrome
IBM-3477-FC 27x132 color
IBM-3477-FG 27x132 monochrome
IBM-5251-11 24x80 monochrome
IBM-5291-1 24x80 monochrome
IBM-5292-2 24x80 color
EXAMPLES
Define a connection named dsp01 that connects to the machine
iseries.example.com, using the German CCSID, a 132 column terminal, and
printing underscore characters instead of using underlines.
disp01 {
host = iseries.example.com
map = 273
env.TERM = IBM-3477-FC
+underscores
}
Define a printer connection, using host print transform to produce PCL
output for an HP Laserjet compatible printer.
print01 {
host = iseries.example.com
env.DEVNAME = HPLJ01
env.IBMMFRTYPMDL = *HP4
}
Define a secure SSL session, checking the server's certificate against
the CA certificare stored in cacert.pem, and using the client
certificate in jbloggs.pem to sign on automatically.
secure01 {
host = iseries.example.com
+ssl_verify_server
ssl_ca_file = cacert.pem
ssl_cert_file = jbloggs.pem
}
SEE ALSO
tn5250(1), lp5250d(1), http://tn5250.sourceforge.net/, RFC1205,
RFC2877, II10918.
COPYRIGHT
tn5250 is copyright 1997 - 2008 Michael Madore. This manpage is
copyright 2001 - 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.
12 November 2001 TN5250RC(5)