BSD 4_3_Tahoe development

[unix-history] / usr / man / cat1 / mset.0

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



N\bNA\bAM\bME\bE
    mset - retrieve ASCII to IBM 3270 keyboard map

S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
    m\bms\bse\bet\bt

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
    _\bM_\bs_\be_\bt retrieves mapping information for the ASCII keyboard to
    IBM 3270 terminal special functions.  Normally, these map-
    pings are found in /_\be_\bt_\bc/_\bm_\ba_\bp_\b3_\b2_\b7_\b0 (see _\bm_\ba_\bp_\b3_\b2_\b7_\b0(5)).        This
    information is used by the _\bt_\bn_\b3_\b2_\b7_\b0 command (see _\bt_\bn_\b3_\b2_\b7_\b0(1)).

    _\bM_\bs_\be_\bt can be used store the mapping information in the pro-
    cess environment in order to avoid scanning /_\be_\bt_\bc/_\bm_\ba_\bp_\b3_\b2_\b7_\b0
    each time _\bt_\bn_\b3_\b2_\b7_\b0 is invoked.  To do this, place the follow-
    ing command in your ._\bl_\bo_\bg_\bi_\bn file:

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

    _\bM_\bs_\be_\bt first determines the user's terminal type from the
    environment variable T\bTE\bER\bRM\bM.  Normally _\bm_\bs_\be_\bt then uses the file
    /_\be_\bt_\bc/_\bm_\ba_\bp_\b3_\b2_\b7_\b0 to find the keyboard mapping for that terminal.
    However, if the environment variable M\bMA\bAP\bP3\b32\b27\b70\b0 exists and con-
    tains the entry for the specified terminal, then that defin-
    ition is used.  If the value of M\bMA\bAP\bP3\b32\b27\b70\b0 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 u\bun\bnk\bkn\bno\bow\bwn\bn.\b. If that search also
    fails, then a default mapping is used.

F\bFI\bIL\bLE\bES\bS
    /etc/map3270        keyboard mapping for known terminals

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
    tn3270(1), map3270(5)

B\bBU\bUG\bGS\bS
    If the entry for the specific terminal exceeds 1024 bytes,
    _\bc_\bs_\bh(1) will fail to set the environment variable.    _\bM_\bs_\be_\bt
    should probably detect this case and output the path to the
    _\bm_\ba_\bp_\b3_\b2_\b7_\b0 file instead of the terminal entry.











Printed 7/9/88          January 11, 1986                        1