Re: New version of the README file

mmadore <mmadore@blarg.net> writes:

> It seems to me that the number one (non-bug) problem people have been
> having with the emulator, is getting all of the function keys to work
> properly.  I have updated the README file in order to make the process a
> little bit clearer.  This has not yet made it into the source tree, so I
> am posting it here.  Please let me know if you find any problems.

[snip]

> It is very important to update your .Xdefaults file.  If you don't do this,
> the xterm (and therefore the emulator) won't see the proper keycodes and
> your function keys won't work.

There's another way to do this, that I use in my Debian package
(editing configuration files is not permitted in Policy).  You put the 
Xdefaults file in some file called XTerm, in /usr/share/tn5250/XTerm
for example, then make xt5250 be the following:

----------
#!/bin/sh

XUSERFILESEARCHPATH=/usr/share/tn5250/%N
export XUSERFILESEARCHPATH

xterm -geometry 80X25 -name "xt5250" -bg black -fg white -tn xt5250 +sb -e 
tn5250 "$@"  &
----------

(I've also added "+sb" to disable the scroll bar because it's useless
with tn5250.)

[snip]

> Running from the console:
> 
> % su                                  # become root (enter root password)     
>                        
> # loadkeys us5250.map                 # load the console keymap

I don't need to be root to run loadkeys on Debian 2.2-ish, kernel
2.2.12, console-tools 0.2.2.

> # exit                                        # become yourself again
> % export TERM=5250                    # select the 5250 terminal entry
> % tn5250 -u my.ip.address             # connect

If you don't want TERM to be 5250 for everything else, this /could/ be 

% TERM=5250 tn5250 -u my.ip.address

[snip]

> In addition to the map file you also need to make sure that the terminfo
> file that you are using is properly set up.  In particular, it needs to have
> definitions for all 24 function keys, and it must have the proper code for
> back tab.  To look at the current contents of your terminfo, use the infocmp
> command to dump them to a file.  After making any necessary changes, you can
> recompile the file with the tic command.

It is also possible to just specify the /changes/ in the terminfo
file.  For example, I have a terminfo which says:

5250|linux-5250|linux console 5250 terminal,
        kf21=\E[35~, kf22=\E[36~, kf23=\E[37~, kf24=\E[38~,
        use=linux,

and a separate one for my xt5250 which says:

xt5250|xterm-5250|xterm 5250 terminal,
        kf21=\E[35~, kf22=\E[36~, kf23=\E[37~, kf24=\E[38~,
        kcbt=\E[Z,
        use=xterm-xfree86,

[snip]

> Below is an example command line:
> 
>   xt5250 -s MIKEM01 192.168.1.10

Another good example would be:

% xt5250 -y IBM-3477-FC -s EVANSCS1 neptune

which gives me a 132x27 screen when the AS/400 wants it.


It's probably also worth mentioning the "-m" switch somewhere, with a
pointer to the IBM manual at

    http://publib.boulder.ibm.com/cgi-bin/bookmgr/BOOKS/QB3AWC01/G.2

which lists values for the CCSID.  You can also get some idea what
this should be with the command "DSPSYSVAL QCCSID".


Also, if you want to refer to the AS/400 by name instead of IP
address, but it doesn't work, add something like the following line to 
/etc/hosts:

10.1.1.5        neptune.example.com neptune

-- 
         Carey Evans  http://home.clear.net.nz/pages/c.evans/

               "This is where your sanity gives in..."
+---
| This is the LINUX5250 Mailing List!
| To submit a new message, send your mail to LINUX5250@midrange.com.
| To subscribe to this list send email to LINUX5250-SUB@midrange.com.
| To unsubscribe from this list send email to LINUX5250-UNSUB@midrange.com.
| Questions should be directed to the list owner/operator: david@midrange.com
+---