Add diclaimer of copyright to _osname() manual page.
[unix-history] / usr.bin / tn3270 / mset.0
MSET(1) 386BSD Reference Manual MSET(1)
N\bNA\bAM\bME\bE
m\bms\bse\bet\bt - retrieve ASCII to IBM 3270 keyboard map
S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
m\bms\bse\bet\bt [-\b-p\bpi\bic\bck\bky\by] [-\b-s\bsh\bhe\bel\bll\bl] [_\bk_\be_\by_\bb_\bo_\ba_\br_\bd_\bn_\ba_\bm_\be]
D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
M\bMs\bse\bet\bt retrieves mapping information for the ASCII keyboard to IBM 3270
terminal special functions. Normally, these mappings are found in
/_\bu_\bs_\br/_\bs_\bh_\ba_\br_\be/_\bm_\bi_\bs_\bc/_\bm_\ba_\bp_\b3_\b2_\b7_\b0 (see map3270(5)). This information is used by
the tn3270 command (see tn3270(1)).
The default m\bms\bse\bet\bt output can be used to store the mapping information in
the process environment in order to avoid scanning m\bma\bap\bp3\b32\b27\b70\b0 each time
t\btn\bn3\b32\b27\b70\b0 is invoked. To do this, place the following command in your
._\bl_\bo_\bg_\bi_\bn file:
set noglob; setenv MAP3270 "`mset`"; unset noglob
If the _\bk_\be_\by_\bb_\bo_\ba_\br_\bd_\bn_\ba_\bm_\be argument is not supplied, m\bms\bse\bet\bt attempts to determine
the name of the keyboard the user is using, by checking the KEYBD envi-
ronment variable. If the KEYBD environment variable is not set, then
m\bms\bse\bet\bt uses the user's terminal type from the environment variable TERM as
the keyboard name. Normally, m\bms\bse\bet\bt then uses the file map3270(5) to find
the keyboard mapping for that terminal. However, if the environment
variable MAP3270 exists and contains the entry for the specified key-
board, 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 map-
ping for the keyboard is not found in the environment, nor in an alter-
nate map file, nor in the standard map file, then the same search is per-
formed for an entry for a keyboard with the name _\bu_\bn_\bk_\bn_\bo_\bw_\bn. If that search
also fails, then a default mapping is used.
The arguments to m\bms\bse\bet\bt are:
-\b-p\bpi\bic\bck\bky\by When processing the various _\bm_\ba_\bp_\b3_\b2_\b7_\b0 entries (for the user's
keyboard, and all those encountered before the one for the
user's keyboard), m\bms\bse\bet\bt normally will not complain about en-
tries for unknown functions (like ``PFX1''; the -\b-p\bpi\bic\bck\bky\by argu-
ment causes m\bms\bse\bet\bt to issue warning messages about these un-
known entries.
-\b-s\bsh\bhe\bel\bll\bl If the _\bm_\ba_\bp_\b3_\b2_\b7_\b0 entry is longer than the shell's 1024 environ-
mental variable length limit, the default m\bms\bse\bet\bt output cannot
be used to store the mapping information in the process envi-
ronment to avoid scanning _\bm_\ba_\bp_\b3_\b2_\b7_\b0 each time t\btn\bn3\b32\b27\b70\b0 is in-
voked. The -\b-s\bsh\bhe\bel\bll\bl argument causes m\bms\bse\bet\bt to generate shell
commands to set the environmental variables MAP3270,
MAP3270A, and so on, breaking up the entry to fit within the
shell environmental variable length limit. To set these
variables, place the following command in your ._\bl_\bo_\bg_\bi_\bn file:
mset -shell > tmp ; source tmp ; /bin/rm tmp
_\bk_\be_\by_\bb_\bo_\ba_\br_\bd_\bn_\ba_\bm_\be
When searching for the _\bm_\ba_\bp_\b3_\b2_\b7_\b0 entry that matches the user's
keyboard, m\bms\bse\bet\bt will use _\bk_\be_\by_\bb_\bo_\ba_\br_\bd_\bn_\ba_\bm_\be instead of determining
the keyboard name from the KEYBD or TERM environmental vari-
ables.
F\bFI\bIL\bLE\bES\bS
/usr/share/misc/map3270 keyboard mapping for known keyboards
S\bSE\bEE\bE A\bAL\bLS\bSO\bO
tn3270(1), map3270(5)
H\bHI\bIS\bST\bTO\bOR\bRY\bY
The m\bms\bse\bet\bt command appeared in 4.3BSD.
4.3 Berkeley Distribution July 27, 1991 3