Annotation of cci/usr/src/usr.bin/bsc/doc/em3277.1, revision 1.1

1.1     ! root        1: '\" t
        !             2: .TH EM3277 1C DLBA 1.4
        !             3: \" @(#)em3277.1        1.4
        !             4: .SH NAME
        !             5: em3277 \- 3277 Terminal Emulator
        !             6: .SH SYNOPSIS 
        !             7: .I
        !             8: em3277 [\-Ttermtype] [hostname]
        !             9: .SH DESCRIPTION 
        !            10: The 
        !            11: .I em3277 
        !            12: utility is used to emulate the functions
        !            13: possible on a synchronous terminal such as the IBM 3277.
        !            14: The 
        !            15: .I hostname 
        !            16: parameter is used to specify the
        !            17: control unit interface to be emulated; with the appropriate binary
        !            18: synchronous driver and corresponding information in the host parameter
        !            19: file, a 3277/3275 or 3277/3271 environment can be emulated.
        !            20: .P
        !            21: .I Em3277 
        !            22: uses the 
        !            23: .I termcap 
        !            24: terminal capability database in order to provide cursor positioning, screen
        !            25: image maintenance, and highlighting for a large variety of terminals.
        !            26: The terminal type may be specified as a parameter
        !            27: .I (\-Ttermtype) 
        !            28: or be obtained through the environment
        !            29: .I (TERM=termtype). 
        !            30: For more information on terminal types and 
        !            31: .I termcap, 
        !            32: see the reference list at the end of this document.
        !            33: .P
        !            34: If the emulated controller requires a dial-up access instead of a
        !            35: direct connection, a message will be displayed indicating the telephone
        !            36: number to be dialed. If a direct connection is available, the connection
        !            37: will be immediate.
        !            38: Once the connection is made, the screen will generally behave as
        !            39: would a 3277 terminal.
        !            40: .P
        !            41: As ASCII keyboards do not generally have the same special function
        !            42: keys as are available on the 3277, some keyboard mapping is required.
        !            43: The mapping is done through a combination of
        !            44: .I termcap
        !            45: special key descriptions and use of a simulated status line area.
        !            46: Special keys as described in 
        !            47: .I termcap(5) 
        !            48: and below may be defined for the terminal, or they may default as shown below:
        !            49: .P
        !            50: .TS
        !            51: center,box;
        !            52: c|c|c|c|c|c
        !            53: c|c|c|c|c|c
        !            54: c|l|l|c|l|l.
        !            55: TERMCAP                TERMCAP
        !            56: Name   Description     Default Name    Description     Default
        !            57: _
        !            58: S0     EM3277 Special  Cntl-[ (037)    P1      PF1     Cntl-Q (021)
        !            59:        Function        (ESC)
        !            60: S1     Enter   Cntl-N (016)    P2      PF2     Cntl-W (027)
        !            61: S2     Clear   Cntl-O (017)    P3      PF3     Cntl-E (005)
        !            62: S3     Backtab Cntl-U (025)    P4      PF4     Cntl-R (022)
        !            63: S4     Erase EOF       Cntl-Y (031)    P5      PF5     Cntl-T (024)
        !            64: S5     Erase Input     Cntl-P (020)    P6      PF6     Cntl-A (001)
        !            65: S6     Insert Mode     Cntl-^ (036)    P7      PF7     Cntl-S (023)
        !            66: S7     Delete Char.    DEL (0177)      P8      PF8     Cntl-D (004)
        !            67: S8     DUP     Cntl-\ (034)    P9      PF9     Cntl-F (006)
        !            68: S9     FM      Cntl-] (035)    PA      PF10    Cntl-G (007)
        !            69: ku     Cursor Up       Cntl-K (013)    PB      PF11    Cntl-V (026)
        !            70: kd     Cursor Down     Cntl-J (012)    PC      PF12    Cntl-B (002)
        !            71: kl     Cursor Left     Cntl-H (010)    A1      PA1     Cntl-Z (032)
        !            72: kr     Cursor Right    Cntl-L (014)    A2      PA2 (Cancel)    Cntl-X (030)
        !            73:                                        (CAN)
        !            74: tc     Tab     Cntl-I (013)    A3      PA3     Cntl-C (003)
        !            75:                                        (TAB)
        !            76: .TE
        !            77: .P
        !            78: Many of these 
        !            79: .I termcap 
        !            80: entries are non-standard
        !            81: and are likely not to appear in your terminal's description.
        !            82: See your system administrator for a keyboard layout for your terminal.
        !            83: .P
        !            84: The BREAK key may be used to perform a 3277 RESET function
        !            85: when the keyboard is locked and the user is expected to press the
        !            86: RESET key to re-activate the keyboard (that is, if the host will not
        !            87: send a keyboard unlock command to the terminal at some later time).
        !            88: Indiscriminate use of the BREAK key for RESET during send and receive
        !            89: operations is not wise, however \(hy it may terminate send and receive
        !            90: operations prematurely and cause the host to undertake drastic error recovery
        !            91: actions.
        !            92: .P
        !            93: The em3277 Special Function key is used to enter em3277 command mode
        !            94: from the emulation mode. The last two lines of the screen will be
        !            95: replaced temporarily with a status line and command line. The status
        !            96: line indicates keyboard and system status (SYSTEM AVAILABLE, INPUT
        !            97: INHIBITED, ...). The command line may be used to cause one of the
        !            98: following actions:
        !            99: .P
        !           100: .TS
        !           101: center,box;
        !           102: c|c
        !           103: c|lw(5i).
        !           104: Command        Description
        !           105: _
        !           106: !      Temporary escape to shell \- following characters up
        !           107:        to a newline are passed to the shell.
        !           108: t      Test Request (emulate Test Request key)
        !           109: r      Reset (emulate Reset key)
        !           110: q      Quit (shut down communications and exit EM3277)
        !           111: p      Control emulated printer (3275 mode):
        !           112:        pd \- disable printer (none attached)
        !           113:        pf<file> \- print to file (note: no space between pf and <file>).
        !           114:        This causes the next local copy command (pr) to send its output
        !           115:        to <file>.
        !           116:        pp<pipe> \- print to program (note: no space between pp and <pipe>).
        !           117:        This causes the next local copy command (pr) to send its output
        !           118:        to <pipe>.
        !           119:        pr \- do local copy to file or pipe; default is to /usr/bin/lpr
        !           120:        if no other destination has been set by the pf<file> or pp<pipe>
        !           121:        commands.
        !           122: s      Show session statistics
        !           123: h      Display keyboard map (help screen)
        !           124: .TE
        !           125: .P
        !           126: After entering one of the Program Attention keys (Enter, Clear, PA1-3,
        !           127: PF1-12, or Test Request), the status/command area will temporarily
        !           128: overwrite the bottom two lines of the screen, showing the system
        !           129: status. When the INPUT INHIBITED condition terminates, the normal
        !           130: screen will be refreshed.
        !           131: .SH "SEE ALSO"
        !           132: .nf
        !           133: bsclog(8) \- audit trail facility
        !           134: bscmon(8) \- bsc monitor/trace utilities
        !           135: bsc(4) \- Bisync Single-station device
        !           136: bscm(4) \- Bisync Multi-station device
        !           137: em3270(8) \- em327x administration
        !           138: termcap(5) \- terminal capability data base
        !           139: .I
        !           140: 3270 Component Description,
        !           141: IBM document GA27-2749.
        !           142: .fi
        !           143: .SH DIAGNOSTICS
        !           144: .TP
        !           145: em3277 <host>: can't open host configuration file <filename>.
        !           146: The configuration file for this host couldn't be opened.
        !           147: Either the host name is incorrect, or the modes for the host configuration
        !           148: file could be wrong.  Processing aborted.
        !           149: .TP
        !           150: em3277 <host>: <devname> cannot be opened for communications.
        !           151: The communications device <devname> for the specified
        !           152: host could not be opened. Either the mode is set wrong, or some other
        !           153: process has the device open. Processing aborted.
        !           154: .TP
        !           155: em3277 <host>: unrecognized keyword, line <l> in <filename>.
        !           156: While reading the host configuration file <filename>,
        !           157: an unrecognized keyword was found on line <l>. Probably a typographical
        !           158: error. Processing aborted.
        !           159: .TP
        !           160: em3277 <host>: invalid parameter for keyword <k> in <filename>.
        !           161: While reading the host configuration file <filename>,
        !           162: keyword <k> was found to have an invalid parameter. Probably a typographical
        !           163: error, but it is also possible that the given parameter was out of
        !           164: range. Processing aborted.
        !           165: .TP
        !           166: em3277 <host>: device <devname> reports modem failure.
        !           167: The named device reported a transmit timeout error. The usual reason
        !           168: for this is that the device did not get a transmit clock signal from
        !           169: the modem. This could be due to improper modem option specification,
        !           170: improper cable to the modem from the computer system, or to not having
        !           171: jumpered the MODEM port for external timing. Transmission is
        !           172: aborted.
        !           173: .TP
        !           174: em3277 <host>: file <filename> can't be created.
        !           175: While attempting to create <filename> to hold received printer data,
        !           176: an error was encountered. Check the modes on the directory and/or
        !           177: file. Printer data will be discarded until another special function
        !           178: command for the printer corrects the problem.
        !           179: .TP
        !           180: em3277 <host>: <program> not found or not executable.
        !           181: While attempting to spawn <program> to receive printed data, an error
        !           182: was encountered. Check the program name and permissions on the file.
        !           183: Printer data will be discarded until another special function command
        !           184: for the printer corrects the problem.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.