


MSET(1)             UNIX Programmer's Manual		  MSET(1)



NAME
     mset - retrieve ASCII to IBM 3270 keyboard map

SYNOPSIS
     mset

DESCRIPTION
     _M_s_e_t retrieves mapping information for the ASCII keyboard to
     IBM 3270 terminal special functions.  Normally, these map-
     pings are found in /_u_s_r/_s_h_a_r_e/_m_i_s_c/_m_a_p_3_2_7_0 (see _m_a_p_3_2_7_0(5)).
     This information is used by the _t_n_3_2_7_0 command (see
     _t_n_3_2_7_0(1)).

     _M_s_e_t can be used store the mapping information in the pro-
     cess environment in order to avoid scanning
     /_u_s_r/_s_h_a_r_e/_m_i_s_c/_m_a_p_3_2_7_0 each time _t_n_3_2_7_0 is invoked.  To do
     this, place the following command in your ._l_o_g_i_n file:

	  set noglob; setenv MAP3270 "`mset`"; unset noglob

     _M_s_e_t first determines the user's terminal type from the
     environment variable TERM.  Normally _m_s_e_t then uses the file
     /_u_s_r/_s_h_a_r_e/_m_i_s_c/_m_a_p_3_2_7_0 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 termi-
     nal 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
     /usr/share/misc/map3270	    keyboard mapping for known
     terminals

SEE ALSO
     tn3270(1), map3270(5)

BUGS
     If the entry for the specific terminal exceeds 1024 bytes,
     _c_s_h(1) will fail to set the environment variable.	_M_s_e_t
     should probably detect this case and output the path to the
     _m_a_p_3_2_7_0 file instead of the terminal entry.









Printed 11/26/99	November 16, 1996			1



