![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to mset.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / tn3270|
Return to mset.1 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / tn3270 |
1.1 root 1: .\" Copyright (c) 1986, 1990 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms are permitted provided
5: .\" that: (1) source distributions retain this entire copyright notice and
6: .\" comment, and (2) distributions including binaries display the following
7: .\" acknowledgement: ``This product includes software developed by the
8: .\" University of California, Berkeley and its contributors'' in the
9: .\" documentation or other materials provided with the distribution and in
10: .\" all advertising materials mentioning features or use of this software.
11: .\" Neither the name of the University nor the names of its contributors may
12: .\" be used to endorse or promote products derived from this software without
13: .\" specific prior written permission.
14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
17: .\"
18: .\" @(#)mset.1 4.3 (Berkeley) 6/11/90
19: .\"
20: .Dd June 11, 1990
21: .Dt MSET 1
22: .Os BSD 4.3
23: .Sh NAME
24: .Nm mset
25: .Nd retrieve ASCII to IBM 3270 keyboard map
26: .Sh SYNOPSIS
27: .Nm mset
28: .Op Fl picky
29: .Op Fl shell
30: .Op Ar keyboardname
31: .Sh DESCRIPTION
32: .Nm Mset
33: retrieves mapping information
34: for the ASCII keyboard to IBM 3270 terminal
35: special functions.
36: Normally, these mappings are found
37: in
38: .Pa /usr/share/misc/map3270
39: (see
40: .Xr map3270 5 ) .
41: This information is used by the
42: .Xr tn3270
43: command (see
44: .Xr tn3270 1 ) .
45: .Pp
46: The default
47: .Nm mset
48: output can be used to store the mapping information in the process environment
49: in order to avoid scanning
50: .Nm map3270
51: each time
52: .Nm tn3270
53: is invoked.
54: To do this, place the following command in your
55: .Pa .login
56: file:
57: .Pp
58: .Dl set noglob; setenv MAP3270 "\(gamset\(ga"; unset noglob
59: .Pp
60: If the
61: .Ar keyboardname
62: argument is not supplied,
63: .Nm mset
64: attempts to determine the name of the keyboard the user is using,
65: by checking the
66: .Ev KEYBD
67: environment variable.
68: If the
69: .Ev KEYBD
70: environment variable is not set, then
71: .Nm mset
72: uses the user's terminal type from the environment variable
73: .Ev TERM
74: as the keyboard name.
75: Normally,
76: .Nm mset
77: then uses the file
78: .Xr map3270 5
79: to find the keyboard mapping for that terminal.
80: However, if the environment variable
81: .Ev MAP3270
82: exists and contains the entry for the specified keyboard, then that
83: definition is used.
84: If the value of
85: .Ev MAP3270
86: begins with a slash (`/') then it is assumed to be the full pathname
87: of an alternate mapping file and that file is searched first.
88: In any case, if the mapping for the keyboard is not found in
89: the environment, nor in an alternate map file, nor in the standard map file,
90: then the same search is performed for an entry for a keyboard with the name
91: .Ar unknown .
92: If that search also fails,
93: then a default mapping
94: is used.
95: .Pp
96: The arguments to
97: .Nm mset
98: are:
99: .Pp
100: .Tw Fl
101: .Tp Fl picky
102: When processing the various
103: .Pa map3270
104: entries (for the user's keyboard,
105: and all those encountered before the one for the user's keyboard),
106: .Nm mset
107: normally will not complain about entries for unknown functions (like
108: .Dq PFX1 ;
109: the
110: .Fl picky
111: argument causes
112: .Nm mset
113: to issue warning messages about these unknown entries.
114: .Tp Fl shell
115: If the
116: .Pa map3270
117: entry is longer than the shell's 1024 environmental variable
118: length limit, the default
119: .Nm mset
120: output cannot be used to store the mapping information in the process
121: environment to avoid scanning
122: .Pa map3270
123: each time
124: .Nm tn3270
125: is invoked.
126: The
127: .Fl shell
128: argument causes
129: .Nm mset
130: to generate shell commands to set the environmental variables
131: .Ev MAP3270 ,
132: .Ev MAP3270A ,
133: and so on, breaking up the entry to fit within the shell environmental
134: variable length limit.
135: To set these variables, place the following command in your
136: .Pa .login
137: file:
138: .Pp
139: .Dl mset -shell > tmp ; source tmp ; /bin/rm tmp
140: .Tp Ar keyboardname
141: When searching for the
142: .Pa map3270
143: entry that matches the user's keyboard,
144: .Nm mset
145: will use
146: .Ar keyboardname
147: instead of determining the keyboard name from the
148: .Ev KEYBD
149: or
150: .Ev TERM
151: environmental variables.
152: .Sh FILES
153: .Dw /usr/share/misc/map3270
154: .Di L
155: .Dp Pa /usr/share/misc/map3270
156: keyboard mapping for known keyboards
157: .Dp
158: .Sh ENVIRONMENT
159: .Sh SEE ALSO
160: .Xr tn3270 1 ,
161: .Xr map3270 5
162: .Sh HISTORY
163: .Nm mset
164: appeared in 4.3 BSD.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.