1*62366Sbostic.\" Copyright (c) 1986, 1990, 1993 2*62366Sbostic.\" The Regents of the University of California. All rights reserved. 325840Smckusick.\" 448764Sbostic.\" %sccs.include.redist.roff% 525840Smckusick.\" 6*62366Sbostic.\" @(#)mset.1 8.1 (Berkeley) 06/06/93 736128Sbostic.\" 843083Scael.Dd 943083Scael.Dt MSET 1 1043083Scael.Os BSD 4.3 1143083Scael.Sh NAME 1243083Scael.Nm mset 1350607Scael.Nd retrieve 1450607Scael.Tn ASCII 1550607Scaelto 1650607Scael.Tn IBM 1750607Scael3270 keyboard map 1843083Scael.Sh SYNOPSIS 1943083Scael.Nm mset 2043083Scael.Op Fl picky 2143083Scael.Op Fl shell 2243083Scael.Op Ar keyboardname 2343083Scael.Sh DESCRIPTION 2443083Scael.Nm Mset 2525603Sminshallretrieves mapping information 2650607Scaelfor the 2750607Scael.Tn ASCII 2850607Scaelkeyboard to 2950607Scael.Tn IBM 3050607Scael3270 terminal 3125603Sminshallspecial functions. 3225603SminshallNormally, these mappings are found 3325603Sminshallin 3443083Scael.Pa /usr/share/misc/map3270 3525603Sminshall(see 3643083Scael.Xr map3270 5 ) . 3725603SminshallThis information is used by the 3843083Scael.Xr tn3270 3925603Sminshallcommand (see 4043083Scael.Xr tn3270 1 ) . 4143083Scael.Pp 4236465SminshallThe default 4343083Scael.Nm mset 4436465Sminshalloutput can be used to store the mapping information in the process environment 4525603Sminshallin order to avoid scanning 4643083Scael.Nm map3270 4725603Sminshalleach time 4843083Scael.Nm tn3270 4925603Sminshallis invoked. 5025603SminshallTo do this, place the following command in your 5143083Scael.Pa .login 5225603Sminshallfile: 5350607Scael.Bd -literal -offset indent 5450607Scaelset noglob; setenv MAP3270 "\(gamset\(ga"; unset noglob 5550607Scael.Ed 5643083Scael.Pp 5736465SminshallIf the 5843083Scael.Ar keyboardname 5936465Sminshallargument is not supplied, 6043083Scael.Nm mset 6136465Sminshallattempts to determine the name of the keyboard the user is using, 6236465Sminshallby checking the 6343083Scael.Ev KEYBD 6436465Sminshallenvironment variable. 6536465SminshallIf the 6643083Scael.Ev KEYBD 6736465Sminshallenvironment variable is not set, then 6843083Scael.Nm mset 6936465Sminshalluses the user's terminal type from the environment variable 7043083Scael.Ev TERM 7136465Sminshallas the keyboard name. 7236465SminshallNormally, 7343083Scael.Nm mset 7425603Sminshallthen uses the file 7543083Scael.Xr map3270 5 7625603Sminshallto find the keyboard mapping for that terminal. 7725603SminshallHowever, if the environment variable 7843083Scael.Ev MAP3270 7936465Sminshallexists and contains the entry for the specified keyboard, then that 8025603Sminshalldefinition is used. 8125603SminshallIf the value of 8243083Scael.Ev MAP3270 8325603Sminshallbegins with a slash (`/') then it is assumed to be the full pathname 8425603Sminshallof an alternate mapping file and that file is searched first. 8536465SminshallIn any case, if the mapping for the keyboard is not found in 8625603Sminshallthe environment, nor in an alternate map file, nor in the standard map file, 8736465Sminshallthen the same search is performed for an entry for a keyboard with the name 8843083Scael.Ar unknown . 8925603SminshallIf that search also fails, 9025603Sminshallthen a default mapping 9125603Sminshallis used. 9243083Scael.Pp 9336465SminshallThe arguments to 9443083Scael.Nm mset 9536465Sminshallare: 9643083Scael.Pp 9750607Scael.Bl -tag -width Fl 9850607Scael.It Fl picky 9943083ScaelWhen processing the various 10043083Scael.Pa map3270 10143083Scaelentries (for the user's keyboard, 10236465Sminshalland all those encountered before the one for the user's keyboard), 10343083Scael.Nm mset 10436465Sminshallnormally will not complain about entries for unknown functions (like 10543083Scael.Dq PFX1 ; 10643083Scaelthe 10743083Scael.Fl picky 10836465Sminshallargument causes 10943083Scael.Nm mset 11036465Sminshallto issue warning messages about these unknown entries. 11150607Scael.It Fl shell 11243083ScaelIf the 11343083Scael.Pa map3270 11443083Scaelentry is longer than the shell's 1024 environmental variable 11536465Sminshalllength limit, the default 11643083Scael.Nm mset 11736465Sminshalloutput cannot be used to store the mapping information in the process 11836465Sminshallenvironment to avoid scanning 11943083Scael.Pa map3270 12036465Sminshalleach time 12143083Scael.Nm tn3270 12236465Sminshallis invoked. 12336465SminshallThe 12443083Scael.Fl shell 12536465Sminshallargument causes 12643083Scael.Nm mset 12736465Sminshallto generate shell commands to set the environmental variables 12843083Scael.Ev MAP3270 , 12943083Scael.Ev MAP3270A , 13036465Sminshalland so on, breaking up the entry to fit within the shell environmental 13136465Sminshallvariable length limit. 13236465SminshallTo set these variables, place the following command in your 13343083Scael.Pa .login 13436465Sminshallfile: 13550607Scael.Bd -literal -offset indent 13650607Scaelmset -shell > tmp ; source tmp ; /bin/rm tmp 13750607Scael.Ed 13850607Scael.It Ar keyboardname 13943083ScaelWhen searching for the 14043083Scael.Pa map3270 14143083Scaelentry that matches the user's keyboard, 14243083Scael.Nm mset 14336465Sminshallwill use 14443083Scael.Ar keyboardname 14536465Sminshallinstead of determining the keyboard name from the 14643083Scael.Ev KEYBD 14736465Sminshallor 14843083Scael.Ev TERM 14936465Sminshallenvironmental variables. 15043083Scael.Sh FILES 15150607Scael.Bl -tag -width /usr/share/misc/map3270 -compact 15250607Scael.It Pa /usr/share/misc/map3270 15343083Scaelkeyboard mapping for known keyboards 15450607Scael.El 15543083Scael.Sh SEE ALSO 15643083Scael.Xr tn3270 1 , 15743083Scael.Xr map3270 5 15843083Scael.Sh HISTORY 15950607ScaelThe 16043083Scael.Nm mset 16150607Scaelcommand appeared in 16250607Scael.Bx 4.3 . 163