Return to em3277.1 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / usr.bin / bsc / doc

Power 6/32 Unix version 1.21

'\" t
.TH EM3277 1C DLBA 1.4
\" @(#)em3277.1	1.4
.SH NAME
em3277 \- 3277 Terminal Emulator
.SH SYNOPSIS 
.I
em3277 [\-Ttermtype] [hostname]
.SH DESCRIPTION 
The 
.I em3277 
utility is used to emulate the functions
possible on a synchronous terminal such as the IBM 3277.
The 
.I hostname 
parameter is used to specify the
control unit interface to be emulated; with the appropriate binary
synchronous driver and corresponding information in the host parameter
file, a 3277/3275 or 3277/3271 environment can be emulated.
.P
.I Em3277 
uses the 
.I termcap 
terminal capability database in order to provide cursor positioning, screen
image maintenance, and highlighting for a large variety of terminals.
The terminal type may be specified as a parameter
.I (\-Ttermtype) 
or be obtained through the environment
.I (TERM=termtype). 
For more information on terminal types and 
.I termcap, 
see the reference list at the end of this document.
.P
If the emulated controller requires a dial-up access instead of a
direct connection, a message will be displayed indicating the telephone
number to be dialed. If a direct connection is available, the connection
will be immediate.
Once the connection is made, the screen will generally behave as
would a 3277 terminal.
.P
As ASCII keyboards do not generally have the same special function
keys as are available on the 3277, some keyboard mapping is required.
The mapping is done through a combination of
.I termcap
special key descriptions and use of a simulated status line area.
Special keys as described in 
.I termcap(5) 
and below may be defined for the terminal, or they may default as shown below:
.P
.TS
center,box;
c|c|c|c|c|c
c|c|c|c|c|c
c|l|l|c|l|l.
TERMCAP		TERMCAP
Name	Description	Default	Name	Description	Default
_
S0	EM3277 Special	Cntl-[ (037)	P1	PF1	Cntl-Q (021)
	Function	(ESC)
S1	Enter	Cntl-N (016)	P2	PF2	Cntl-W (027)
S2	Clear	Cntl-O (017)	P3	PF3	Cntl-E (005)
S3	Backtab	Cntl-U (025)	P4	PF4	Cntl-R (022)
S4	Erase EOF	Cntl-Y (031)	P5	PF5	Cntl-T (024)
S5	Erase Input	Cntl-P (020)	P6	PF6	Cntl-A (001)
S6	Insert Mode	Cntl-^ (036)	P7	PF7	Cntl-S (023)
S7	Delete Char.	DEL (0177)	P8	PF8	Cntl-D (004)
S8	DUP	Cntl-\ (034)	P9	PF9	Cntl-F (006)
S9	FM	Cntl-] (035)	PA	PF10	Cntl-G (007)
ku	Cursor Up	Cntl-K (013)	PB	PF11	Cntl-V (026)
kd	Cursor Down	Cntl-J (012)	PC	PF12	Cntl-B (002)
kl	Cursor Left	Cntl-H (010)	A1	PA1	Cntl-Z (032)
kr	Cursor Right	Cntl-L (014)	A2	PA2 (Cancel)	Cntl-X (030)
					(CAN)
tc	Tab	Cntl-I (013)	A3	PA3	Cntl-C (003)
					(TAB)
.TE
.P
Many of these 
.I termcap 
entries are non-standard
and are likely not to appear in your terminal's description.
See your system administrator for a keyboard layout for your terminal.
.P
The BREAK key may be used to perform a 3277 RESET function
when the keyboard is locked and the user is expected to press the
RESET key to re-activate the keyboard (that is, if the host will not
send a keyboard unlock command to the terminal at some later time).
Indiscriminate use of the BREAK key for RESET during send and receive
operations is not wise, however \(hy it may terminate send and receive
operations prematurely and cause the host to undertake drastic error recovery
actions.
.P
The em3277 Special Function key is used to enter em3277 command mode
from the emulation mode. The last two lines of the screen will be
replaced temporarily with a status line and command line. The status
line indicates keyboard and system status (SYSTEM AVAILABLE, INPUT
INHIBITED, ...). The command line may be used to cause one of the
following actions:
.P
.TS
center,box;
c|c
c|lw(5i).
Command	Description
_
!	Temporary escape to shell \- following characters up
	to a newline are passed to the shell.
t	Test Request (emulate Test Request key)
r	Reset (emulate Reset key)
q	Quit (shut down communications and exit EM3277)
p	Control emulated printer (3275 mode):
	pd \- disable printer (none attached)
	pf<file> \- print to file (note: no space between pf and <file>).
	This causes the next local copy command (pr) to send its output
	to <file>.
	pp<pipe> \- print to program (note: no space between pp and <pipe>).
	This causes the next local copy command (pr) to send its output
	to <pipe>.
	pr \- do local copy to file or pipe; default is to /usr/bin/lpr
	if no other destination has been set by the pf<file> or pp<pipe>
	commands.
s	Show session statistics
h	Display keyboard map (help screen)
.TE
.P
After entering one of the Program Attention keys (Enter, Clear, PA1-3,
PF1-12, or Test Request), the status/command area will temporarily
overwrite the bottom two lines of the screen, showing the system
status. When the INPUT INHIBITED condition terminates, the normal
screen will be refreshed.
.SH "SEE ALSO"
.nf
bsclog(8) \- audit trail facility
bscmon(8) \- bsc monitor/trace utilities
bsc(4) \- Bisync Single-station device
bscm(4) \- Bisync Multi-station device
em3270(8) \- em327x administration
termcap(5) \- terminal capability data base
.I
3270 Component Description,
IBM document GA27-2749.
.fi
.SH DIAGNOSTICS
.TP
em3277 <host>: can't open host configuration file <filename>.
The configuration file for this host couldn't be opened.
Either the host name is incorrect, or the modes for the host configuration
file could be wrong.  Processing aborted.
.TP
em3277 <host>: <devname> cannot be opened for communications.
The communications device <devname> for the specified
host could not be opened. Either the mode is set wrong, or some other
process has the device open. Processing aborted.
.TP
em3277 <host>: unrecognized keyword, line <l> in <filename>.
While reading the host configuration file <filename>,
an unrecognized keyword was found on line <l>. Probably a typographical
error. Processing aborted.
.TP
em3277 <host>: invalid parameter for keyword <k> in <filename>.
While reading the host configuration file <filename>,
keyword <k> was found to have an invalid parameter. Probably a typographical
error, but it is also possible that the given parameter was out of
range. Processing aborted.
.TP
em3277 <host>: device <devname> reports modem failure.
The named device reported a transmit timeout error. The usual reason
for this is that the device did not get a transmit clock signal from
the modem. This could be due to improper modem option specification,
improper cable to the modem from the computer system, or to not having
jumpered the MODEM port for external timing. Transmission is
aborted.
.TP
em3277 <host>: file <filename> can't be created.
While attempting to create <filename> to hold received printer data,
an error was encountered. Check the modes on the directory and/or
file. Printer data will be discarded until another special function
command for the printer corrects the problem.
.TP
em3277 <host>: <program> not found or not executable.
While attempting to spawn <program> to receive printed data, an error
was encountered. Check the program name and permissions on the file.
Printer data will be discarded until another special function command
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.