--- name: "tn5250rc" section: "5" platform: "linux" package: "tn5250" version: "0.17.4-2" release: "Debian 6.0 (Squeeze)" platforms: ["linux"] url: "https://new.carta.tech/tn5250rc" --- # tn5250rc(5) tn5250 and lp5250d configuration file ## 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 | | | | | 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-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)](/tn5250/1.md), [**lp5250d**(1)](/lp5250d/1.md), **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.