1 .\" Copyright (c) 1986, 1990, 1993
2 .\" The Regents of the University of California. All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
12 .\" 3. All advertising materials mentioning features or use of this software
13 .\" must display the following acknowledgement:
14 .\" This product includes software developed by the University of
15 .\" California, Berkeley and its contributors.
16 .\" 4. Neither the name of the University nor the names of its contributors
17 .\" may be used to endorse or promote products derived from this software
18 .\" without specific prior written permission.
20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 .\" @(#)mset.1 8.1 (Berkeley) 6/6/93
51 retrieves mapping information
58 Normally, these mappings are found
60 .Pa /usr/share/misc/map3270
63 This information is used by the
70 output can be used to store the mapping information in the process environment
71 in order to avoid scanning
76 To do this, place the following command in your
79 .Bd -literal -offset indent
80 set noglob; setenv MAP3270 "\(gamset\(ga"; unset noglob
85 argument is not supplied,
87 attempts to determine the name of the keyboard the user is using,
93 environment variable is not set, then
95 uses the user's terminal type from the environment variable
102 to find the keyboard mapping for that terminal.
103 However, if the environment variable
105 exists and contains the entry for the specified keyboard, then that
109 begins with a slash (`/') then it is assumed to be the full pathname
110 of an alternate mapping file and that file is searched first.
111 In any case, if the mapping for the keyboard is not found in
112 the environment, nor in an alternate map file, nor in the standard map file,
113 then the same search is performed for an entry for a keyboard with the name
115 If that search also fails,
116 then a default mapping
125 When processing the various
127 entries (for the user's keyboard,
128 and all those encountered before the one for the user's keyboard),
130 normally will not complain about entries for unknown functions (like
136 to issue warning messages about these unknown entries.
140 entry is longer than the shell's 1024 environmental variable
141 length limit, the default
143 output cannot be used to store the mapping information in the process
144 environment to avoid scanning
153 to generate shell commands to set the environmental variables
156 and so on, breaking up the entry to fit within the shell environmental
157 variable length limit.
158 To set these variables, place the following command in your
161 .Bd -literal -offset indent
162 mset -shell > tmp ; source tmp ; /bin/rm tmp
165 When searching for the
167 entry that matches the user's keyboard,
171 instead of determining the keyboard name from the
175 environmental variables.
177 .Bl -tag -width /usr/share/misc/map3270 -compact
178 .It Pa /usr/share/misc/map3270
179 keyboard mapping for known keyboards