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 {
+booleanoption=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.
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
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.
l l l
___
rB l l.
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.
l l l
___
lB l lB.
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
IBM-5555-C01@DBCS color
IBM-5555-B01@DBCS monochrome
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.
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.
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.
Local variables:
mode: nroff
End:
