xref: /csrg-svn/usr.bin/tn3270/mset/mset.1 (revision 36284)
Copyright (c) 1986 The Regents of the University of California.
All rights reserved.

Redistribution and use in source and binary forms are permitted
provided that the above copyright notice and this paragraph are
duplicated in all such forms and that any documentation,
advertising materials, and other materials related to such
distribution and use acknowledge that the software was developed
by the University of California, Berkeley. The name of the
University may not be used to endorse or promote products derived
from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

@(#)mset.1 4.1 (Berkeley) 12/04/88

MSET 1 ""
C 6
NAME
mset - retrieve ASCII to IBM 3270 keyboard map
SYNOPSIS
mset
DESCRIPTION
Mset retrieves mapping information for the ASCII keyboard to IBM 3270 terminal special functions. Normally, these mappings are found in /etc/map3270 (see map3270 (5)). This information is used by the tn3270 command (see tn3270 (1)).

Mset can be used store the mapping information in the process environment in order to avoid scanning /etc/map3270 each time tn3270 is invoked. To do this, place the following command in your .login file: set noglob; setenv \s-1MAP3270\s0 "\(gamset\(ga"; unset noglob

Mset first determines the user's terminal type from the environment variable TERM . Normally mset then uses the file /etc/map3270 to find the keyboard mapping for that terminal. However, if the environment variable MAP3270 exists and contains the entry for the specified terminal, then that definition is used. If the value of MAP3270 begins with a slash (`/') then it is assumed to be the full pathname of an alternate mapping file and that file is searched first. In any case, if the mapping for the terminal is not found in the environment, nor in an alternate map file, nor in the standard map file, then the same search is performed for an entry for a terminal type of unknown. If that search also fails, then a default mapping is used.

FILES
/etc/map3270 keyboard mapping for known terminals
SEE ALSO
tn3270(1), map3270(5)
BUGS
If the entry for the specific terminal exceeds 1024 bytes, csh(1) will fail to set the environment variable. Mset should probably detect this case and output the path to the map3270 file instead of the terminal entry.