Man Linux: Main Page and Category List

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