[unix-history] / tn3270 / tn3270 / tn3270.1

.\" Copyright (c) 1986 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms are permitted
.\" provided that the above copyright notice and this paragraph are
.\" duplicated in all such forms and that any documentation,
.\" advertising materials, and other materials related to such
.\" distribution and use acknowledge that the software was developed
.\" by the University of California, Berkeley.  The name of the
.\" University may not be used to endorse or promote products derived
.\" from this software without specific prior written permission.
.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
.\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
.\"
.\"	@(#)tn3270.1	4.1 (Berkeley) 12/4/88
.\"
.TH TN3270 1 "December 4, 1988"
.UC 6
.SH NAME
tn3270 \- full-screen remote login to IBM VM/CMS
.SH SYNOPSIS
.B tn3270
sysname
.SH DESCRIPTION
.I Tn3270
permits a full-screen, full-duplex connection
from a VAX UNIX machine
to an IBM machine running VM/CMS
giving the appearance of being logged in
directly to the remote machine
on an IBM 3270 terminal.
Of course you must have an account on the machine
to which you wish to connect in order to log in.
.I Tn3270
looks to the user in many respects
like the Yale ASCII Terminal Communication System II.
.I Tn3270
is actually a modification of the Arpanet TELNET user interface (see
.IR telnet (1))
that interprets and generates raw 3270 control streams.
.PP
Emulation of the 3270 terminal is done in the Unix process.
This emulation involves mapping
3270-style commands from the host
into appropriate sequences to control the user's terminal screen.
.I Tn3270
uses
.IR curses (3x)
and the
.I /etc/termcap
file to do this.
The emulation also involves simulating the special 3270 keyboard keys
(program function keys, etc.)
by mapping sequences of keystrokes
from the ASCII keyboard into appropriate 3270 control strings.
This mapping is terminal dependent and is specified
in a description file,
.IR /etc/map3270 ,
(see
.IR map3270 (5))
or in an environment variable
.I MAP3270
(see
.IR mset (1)).
Any special function keys on the ASCII keyboard are used whenever possible.
If an entry for the user's terminal
is not found,
.I tn3270
looks for an entry for the terminal type
.B unknown.
If this is not found,
.I tn3270
uses a default keyboard mapping
(see
.IR map3270 (5)).
.PP
The first character of each special keyboard mapping sequence 
is either an ASCII escape (ESC),
a control character, or an ASCII delete (DEL).
If the user types an unrecognized function key sequence,
.I tn3270
sends an ASCII bell (BEL), or a visual bell if
defined in the user's termcap entry, to the user's terminal
and nothing is sent to the IBM host.
.PP
If
.I tn3270 
is invoked without specifying a remote host system name,
it enters local command mode,
indicated by the prompt ``tn3270>''.
In this mode,
.I tn3270
accepts and executes
the following
commands:
.sp 
.nf
.ta 0.5i 1.5i
	open	connect to a remote host
	close	close the current connection
	quit	exit tn3270
	z	suspend tn3270
	status	print connection status
	?	print help information
.fi
.sp
Other common
.I telnet
commands are not available in
.I tn3270.
.I Tn3270
command mode may also be entered, after connecting to a host, by typing
a special escape character
(typically control-C).
.PP
While in command mode, any host login session is still alive
but temporarily suspended.
The host login session may be resumed by entering an empty line
(press the RETURN key)
in response to the command prompt.
A session may be terminated by logging off the foreign host,
or by typing ``quit'' or ``close'' while in local command mode.
.SH FILES
/etc/termcap
.br
/etc/map3270
.SH AUTHOR
Greg Minshall
.SH SEE ALSO
mset(1), telnet(1), termcap(3x), termcap(5), map3270(5),
\fIYale ASCII Terminal Communication
System II Program Description/Operator's Manual\fR
(IBM SB30-1911)
.SH BUGS
Performance is slow and uses system resources prodigiously.
.PP
Not all 3270 functions are supported,
nor all Yale enhancements.
Commit	Line	Data
e3419641 C	1	.\" Copyright (c) 1986 The Regents of the University of California.
e3419641 C	2	.\" All rights reserved.
b5bef96d	3	.\"
e3419641 C	4	.\" Redistribution and use in source and binary forms are permitted
	5	.\" provided that the above copyright notice and this paragraph are
	6	.\" duplicated in all such forms and that any documentation,
	7	.\" advertising materials, and other materials related to such
	8	.\" distribution and use acknowledge that the software was developed
	9	.\" by the University of California, Berkeley. The name of the
	10	.\" University may not be used to endorse or promote products derived
	11	.\" from this software without specific prior written permission.
	12	.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
	13	.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
	14	.\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
b5bef96d	15	.\"
e3419641 C	16	.\" @(#)tn3270.1 4.1 (Berkeley) 12/4/88
	17	.\"
	18	.TH TN3270 1 "December 4, 1988"
b5bef96d	19	.UC 6
362e1db6 GM	20	.SH NAME
	21	tn3270 \- full-screen remote login to IBM VM/CMS
	22	.SH SYNOPSIS
	23	.B tn3270
	24	sysname
	25	.SH DESCRIPTION
	26	.I Tn3270
	27	permits a full-screen, full-duplex connection
	28	from a VAX UNIX machine
	29	to an IBM machine running VM/CMS
	30	giving the appearance of being logged in
	31	directly to the remote machine
	32	on an IBM 3270 terminal.
	33	Of course you must have an account on the machine
	34	to which you wish to connect in order to log in.
	35	.I Tn3270
	36	looks to the user in many respects
	37	like the Yale ASCII Terminal Communication System II.
	38	.I Tn3270
	39	is actually a modification of the Arpanet TELNET user interface (see
	40	.IR telnet (1))
	41	that interprets and generates raw 3270 control streams.
	42	.PP
	43	Emulation of the 3270 terminal is done in the Unix process.
	44	This emulation involves mapping
	45	3270-style commands from the host
	46	into appropriate sequences to control the user's terminal screen.
	47	.I Tn3270
	48	uses
	49	.IR curses (3x)
	50	and the
	51	.I /etc/termcap
	52	file to do this.
	53	The emulation also involves simulating the special 3270 keyboard keys
	54	(program function keys, etc.)
	55	by mapping sequences of keystrokes
	56	from the ASCII keyboard into appropriate 3270 control strings.
	57	This mapping is terminal dependent and is specified
	58	in a description file,
	59	.IR /etc/map3270 ,
	60	(see
	61	.IR map3270 (5))
	62	or in an environment variable
	63	.I MAP3270
	64	(see
	65	.IR mset (1)).
	66	Any special function keys on the ASCII keyboard are used whenever possible.
	67	If an entry for the user's terminal
	68	is not found,
	69	.I tn3270
	70	looks for an entry for the terminal type
	71	.B unknown.
	72	If this is not found,
	73	.I tn3270
	74	uses a default keyboard mapping
	75	(see
	76	.IR map3270 (5)).
	77	.PP
	78	The first character of each special keyboard mapping sequence
	79	is either an ASCII escape (ESC),
	80	a control character, or an ASCII delete (DEL).
	81	If the user types an unrecognized function key sequence,
	82	.I tn3270
	83	sends an ASCII bell (BEL), or a visual bell if
84	defined in the user's termcap entry, to the user's terminal
85	and nothing is sent to the IBM host.
86	.PP
87	If
88	.I tn3270
89	is invoked without specifying a remote host system name,
90	it enters local command mode,
91	indicated by the prompt ``tn3270>''.
92	In this mode,
93	.I tn3270
94	accepts and executes
95	the following
96	commands:
97	.sp
98	.nf
99	.ta 0.5i 1.5i
100	open connect to a remote host
101	close close the current connection
102	quit exit tn3270
103	z suspend tn3270
104	status print connection status
105	? print help information
106	.fi
107	.sp
108	Other common
109	.I telnet
110	commands are not available in
111	.I tn3270.
112	.I Tn3270
113	command mode may also be entered, after connecting to a host, by typing
114	a special escape character
115	(typically control-C).
116	.PP
117	While in command mode, any host login session is still alive
118	but temporarily suspended.
119	The host login session may be resumed by entering an empty line
120	(press the RETURN key)
121	in response to the command prompt.
122	A session may be terminated by logging off the foreign host,
123	or by typing ``quit'' or ``close'' while in local command mode.
124	.SH FILES
125	/etc/termcap
126	.br
127	/etc/map3270
128	.SH AUTHOR
129	Greg Minshall
130	.SH SEE ALSO
131	mset(1), telnet(1), termcap(3x), termcap(5), map3270(5),
132	\fIYale ASCII Terminal Communication
133	System II Program Description/Operator's Manual\fR
134	(IBM SB30-1911)
135	.SH BUGS
136	Performance is slow and uses system resources prodigiously.
137	.PP
138	Not all 3270 functions are supported,
139	nor all Yale enhancements.