![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to em3277.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / usr.bin / bsc / doc|
Return to em3277.1 CVS log | Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / usr.bin / bsc / doc |
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.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.