Return to mset.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / tn3270

Annotation of 43BSDReno/usr.bin/tn3270/mset.1, revision 1.1

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.