forked from hercules-390/html
-
Notifications
You must be signed in to change notification settings - Fork 0
/
telnet.html
449 lines (420 loc) · 17.3 KB
/
telnet.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3.0//EN" "html.dtd">
<HTML>
<HEAD><TITLE>Hercules Version 4 Telnet Support</TITLE>
<link rel="Stylesheet" type="text/css" href="hercules.css"/>
<link rel="shortcut icon" href="../images/favicon.ico" />
<link rel="icon" href="../images/favicon.ico" />
<!-- define a table style for consistent layout and presentation. -->
<style>
table {
border: 2px solid black;
border-collapse:collapse;
}
th {
border: 1px solid black;
vertical-align:bottom;
padding:10px 5px 5px 5px;
}
td {
border: 1px solid black;
vertical-align: top;
padding:5px 5px 10px 5px;
}
</style>
</HEAD>
<BODY BGCOLOR="#ffffcc" TEXT="#000000" LINK="#0000A0"
VLINK="#008040" ALINK="#000000">
<h1 id="pagetop">Telnet/tn3270 Console How-To for Hercules Version 4</h1>
<hr noshade>
<p>Hercules Version 4 has been used with the following tn3270 and telnet
applications. Click on each name to view settings and other considerations
for using that application with Hercules.</p>
<ul>
<li><a href="#x3270">x3270 / c3270 / wc3270 tn3270</a> - Windows, Linux; no license fee</li>
<li><a href="#OSXtn3270">Tn3270 for the Macintosh</a> - OS X (multiple versions); no license fee</li>
<li><a href="#Vistatn3270">Vista tn3270</a> - Windows; nominal license fee</li>
<li><a href="#ZOCTerminal">ZOC Terminal</a> - Windows, OS X; nominal license fee</li>
<li><a href="#PuTTY">PuTTY Telnet</a> - Windows, Linux; no license fee</li>
</ul>
<ul>
<li><a href="#nixtelnet">Linux telnet</a> - The default Linux telnet client works well OOTB</li>
<li><a href="#Windows">Windows Telnet</a> - Windows has been used, others are likely to work</li>
<li><a href="#WindowsNT">Windows NT Telnet</a> - Windows NT only</li>
</ul>
<p>
The above list is neither an endorsement of those products nor a recommendation
to use them. If wish to share your experience with a different telnet and/or
tn3270 application, please post that experience to the
<a href="https://groups.yahoo.com/neo/groups/hercules-390/info" target="_blank">Hercules-390</a>
Yahoo group. Other telnet client applications that comply with the following
RFCs should work.
</p>
<p>
Remember that <b>local echo</b> needs to be set on for telnet connections.
</p>
<table style="border-style:none">
<tr style="border-style:none;text-align:center">
<th style="border-style:none">Telnet</th>
<th style="border-style:none"> </th>
<th style="border-style:none">tn3270</th>
</tr>
<tr style="border-style:none">
<td style="border-style:none">
<ul>
<li><a href="http://www.rfc-editor.org/info/rfc854" target="_blank">RFC854 Telnet Protocol Specification</a></li>
<li><a href="http://www.rfc-editor.org/info/rfc855" target="_blank">RFC855 Telnet Option Specifications</a></li>
<li><a href="http://www.rfc-editor.org/info/rfc1091" target="_blank">RFC1091 Telnet terminal-type option</a></li>
<li><a href="http://www.rfc-editor.org/info/rfc1143" target="_blank">RFC1143 The Q Method of Implementing TELNET Option Negotiation</a></li>
<li><a href="http://www.rfc-editor.org/info/rfc1572" target="_blank">RFC1572 Telnet Environment Option</a></li>
<li><a href="http://www.rfc-editor.org/info/rfc1571" target="_blank">RFC1571 Telnet Environment Option Interoperability Issues</a></li>
</ul>
</td>
<td style="border-style:none"> </td>
<td style="border-style:none">
<ul>
<li><a href="http://www.rfc-editor.org/info/rfc856" target="_blank">RFC856 Telnet Binary Transmission</a></li>
<li><a href="http://www.rfc-editor.org/info/rfc885" target="_blank">RFC885 Telnet end of record option</a></li>
<li><a href="http://www.rfc-editor.org/info/rfc1576" target="_blank">RFC1576 TN3270 Current Practices</a></li>
<li><a href="http://www.rfc-editor.org/info/rfc2355" target="_blank">RFC2355 TN3270 Enhancements</a></li>
</ul>
</td>
</tr>
</table>
<p>
<a href="##" onclick="history.go(-1)"><img src="images/back.gif" border=0 alt="back"></a>
<br />
<h4 id="x3270">x3270 / c3270 / wc3270</h4>
<p>
The x3270 family of tn3270 applications are available without charge
from <a href="http://x3270.bgp.nu/" target="_blank">x3270.bgp.nu</a>.
RPM's exist for many Linux distributions that use Redhat Package Manager files;
<a href="https://www.rpmfind.net/linux/rpm2html/search.php?query=x3270" target="_blank">check here for a list</a>.
It is also packaged for <a href="https://packages.debian.org/search?keywords=x3270" target="_blank">Debian</a>
and <a href="http://packages.ubuntu.com/search?keywords=x3270" target="_blank">Ubuntu</a>,
and the .deb packages can often be used with other Debian-based Linux distributions.
They are licensed under the BSD license as shown on the
<a href="http://x3270.bgp.nu/license.html">x3270 license page</a>.
</p>
<p>
The packaged installation files available for Linux distributions are
several minor releases older than the current stable release.
You may wish to build x3270 from source even when an installation package
exists for your Linux distribution.
Build instructions for a variety of environments are in the
Documentation - Miscelaneous page of the x3270 web site.
</p>
<p>
The x3270 family includes the following applications (there are additional applications in the family; visit the x3270 site):
</p>
<ul>
<li><b>x3270</b> - tn3270 for X11 servers driving graphical displays</li>
<li><b>c3270</b> - tn3270 for fixed-function character-mode terminals or telnet sessions</li>
<li><b>wc3270</b> - native Windows tn3270 application</li>
</ul>
<p>
Start an x3270 session and connect to Hercules with the following.
</p><blockquote>
<pre>
Windows: "c:\Program Files\wc3270\wc3270" -port nnnn -model 32xx-x hostname
Linux: x3270 -port nnnn -model 32xx-x hostname
</pre>
</blockquote>
<p>
Replace the port, model, and hostname options as follows.
</p>
<table border="1" style="border-style:solid; padding:3px">
<tr>
<td>-port nnnn</td>
<td>
<p>
This must match the port named in the Hercules configuration file
CNSLPORT statement.
</p>
</td>
</tr>
<tr>
<td>-model 32xx-x</td>
<td>
<ul>
<li>3278-2 (a good second choice)</li>
<li>3278-3</li>
<li>3278-4</li>
<li>3278-5</li>
<li>3279-2 (recommended)</li>
<li>3279-3</li>
</ul>
<p>
Unless you know that the application program running
under Hercules to which you will attach supports large
screen sizes, specify 3279-2 or 3278-2 to select a 24 x 80 screen size.
</p>
<p>
There's nothing wrong with a bit of trial and error here.
Try other screen sizes to see what works.
But start with a model 2.
</p>
</td>
</tr>
<tr>
<td style="width:175px">hostname<br /><br />
001f@hostname<br /><br />
console@hostname</td>
<td>
<p>
This identifies the ip address of the Hercules system and optionally the 3270 device in the Hercules configuration
to which this session should connect.</p>
<p>
You can specify a host name, IPv4 address, or IPv6 address. Most commonly, you'll use localhost for the host name.
</p>
<p>
If a hexadecimal number is provided before the host name, the session will try to
connect to that address in the Hercules configuration. </p>
<p>
If a groupname is provided, the session will try to connect to
any available 3270 device that names that group.
</p>
<p>
If no name or number is provided before the host name,
the session will connect to any available 3270 device.
</p>
</td>
</tr>
</table>
<p>
Example x3270 session startup command
</p><blockquote>
<pre>
Windows: "c:\Program Files\wc3270\wc3270" -port 3270 -model 3229-2 localhost
Linux: x3270 -port 3270 -model 3229-2 localhost
</pre>
</blockquote>
<p>
<a href="#pagetop">Return to top of page</a>
</p>
<br />
<h4 id="OSXtn3270">tn3270 for the Macintosh</h4>
<p>
Tn3270 for the Macintosh is available without charge from Brown University at
<a href="https://www.brown.edu/cis/tn3270/" target="_blank">https://www.brown.edu/cis/tn3270/</a>.
According to the web site as of May, 2016,
the current version of this tn3270 application can be used with
OS X 10.3.9 "Panther" through OS X 10.9 "Mavericks"
on POWER PC and Intel-based systems.
</p>
<p>
Older versions of tn3270 exist for older Macintosh systems.
</p>
<p>
This author does not have access to a Mac and regrets being unable to provide configuration options.
</p>
<p>
<a href="#pagetop">Return to top of page</a>
</p>
<br />
<h4 id="Vistatn3270">Vista tn3270</h4>
<p>
Vista tn3270 is a Windows application written and maintained by Tom Brennan,
and is used by members of the Hercules community.
You can learn more about it at <a href="http://www.tombrennansoftware.com/" target="_blank">Tom Brennan Software</a>.
The screenshots are worth a look.
</p>
<p>
Complete installation and setup instructions are included in the
<a href="http://hercdoc.glanzmann.org/V400/HerculesInstallation.pdf" target="_blank">Hercules Installation Guide</a> for Hercules Version 4
starting on page 123.
</p>
<p>
<a href="#pagetop">Return to top of page</a>
</p>
<br /><h4 id="ZOCTerminal">ZOC Terminal</h4>
<p>
ZOC Terminal, available for Windows and Macintosh, is offered by Emtec Innovative Software
and is used by members of the Hercules community.
You can learn more about it at the <a href="http://www.emtec.com/zoc/" target="_blank">ZOC Terminal</a> web site.
The screenshots are worth a look.
</p>
<p>
This author does not have access to a Mac and regrets being unable to provide configuration options.
</p>
<p>
<a href="#pagetop">Return to top of page</a>
</p>
<br /><h4 id="PuTTY">PuTTY Telnet</h4>
<p>
PuTTY version 0.67 has been tested on Windows and version 0.63
has been tested on Debian 8.4. Other recent versions of PuTTY should work as well.
</p>
<p>
PuTTY source and Windows builds are available without charge and
can be obtained from <a href="http://www.putty.org" target="_blank">putty.org</a>.
RPM's exist for many Linux distributions that use Redhat Package Manager files;
<a href="https://www.rpmfind.net/linux/rpm2html/search.php?query=putty" target="_blank">check here for a list</a>.
It is also packaged for
<a href="https://packages.debian.org/search?keywords=putty" target="_blank">Debian</a>
and
<a href="https://apps.ubuntu.com/cat/applications/oneiric/putty/" target="_blank">Ubuntu</a>,
and the .deb packages can often be used on other linux distributions based on
Debian.
It is distributed under the MIT license,
as shown on <a href="http://www.chiark.greenend.org.uk/~sgtatham/putty/licence.html" target="_blank">
PuTTY's license page</a>.
</p>
<p>
The following options must be set for correct operation. Click on the page name to open a screen shot in a new browser window:
</p>
<blockquote>
<table border="1" style="padding:10px">
<tr>
<th style="text-align:left">Page</th>
<th style="text-align:left">Setting</th>
<th style="text-align:left">Value needed for Hercules</th>
</tr>
<tr>
<td rowspan="2"><a href="images/telnetputtysession.png" target="_blank">Session</a></td>
<td>Port</td>
<td>Must match nnnn in the CNSLPORT statement in the Hercules configuration file</td>
</tr>
<tr>
<td>Connection type</td>
<td>Select "Telnet"</td>
</tr>
<tr>
<td rowspan="2"><a href="images/telnetputtyterminal.png" target="_blank">Terminal</a></td>
<td>Local echo</td>
<td>Select "Force on"</td>
</tr>
<tr>
<td>Local line editing</td>
<td>Select "Force on"</td>
</tr>
<tr>
<td><a href="images/telnetputtyconndata.png" target="_blank">Connection - Data</a></td>
<td>Terminal-type string</td>
<td>Must be set to "ANSI"</td>
</tr>
</table>
</blockquote>
<p>
Other options may be set as you wish.
Because mainframes that used printer-keyboards used continuous forms,
and "scrolling back" through the console log meant thumbing through a
stack of continuous forms paper, you may wish to set the size of the
window and the lines of scroll back on the Windows page to accomodate your preferences.
</p>
<p>
<a href="#pagetop">Return to top of page</a>
</p>
<br />
<h4 id="nixtelnet">Linux telnet</h4>
<p>
Virtually all Linux distributions come with a default telnet client
that should work well out of the box.
No special configuration should be needed.
</p>
<br />
<h4 id="Windows">Windows Telnet</h4>
<p>
The Telnet client included with Windows is known to have been
used successfully with Hercules Version 4. The telnet clients
included with Windows XP, Vista, 7, 8, 8.1 and 10 appear to
all be the same program, so the you should be able to set up a
connection using the information below. Please post any diffiuclties to the
<a href="https://groups.yahoo.com/neo/groups/hercules-390/info" target="_blank">Hercules-390</a>
Yahoo group, noting the symptoms, Windows version and error messages.
</p>
<p>
One settings change is needed to use the Windows Telnet client with
Hercules Version 4: '<b>set localecho</b>'. The defaults for the
remaining settings should work. Refer to the sample session below:
</p>
<blockquote>
<img src="images/telnetwin.png" border="0" alt="Windows Telnet settings" />
</blockquote>
<p>
Window size and scroll-back are controlled by the command prompt window
that Telnet is running in. You can use the set logfile and set logging
commands to record the Telnet session to a file.
</p>
<p>
It is difficult to set up a connection profile to pre-define the
<b>localecho</b> setting, the window size, and scroll-back. For this
reason, <a href="#PuTTY">PuTTY</a> is probably a better choice.
</p>
<p>
<a href="#pagetop">Return to top of page</a>
</p>
<br />
<h4 id="WindowsNT">Windows NT Telnet</h4>
<p>
There are many reasons not to use Windows NT Telnet to connect to Hercules.
Specifically:
</p>
<ul style="">
<li style="margin-bottom:10px">
There are better solutions. <a href="#PuTTY">PuTTY</a> for example.
</li>
<li style="margin-bottom:10px">
Windows NT Telnet is licensed by Microsoft for use only when you have a
valid Windows NT license. If you find a copy floating around on the Internet,
it's not properly licensed.
</li>
<li style="margin-bottom:10px">
If you do find it on the Internet, beware of the "gifts" that may have been added to the code.
</li>
<li>
If you copy it from your NT installation CD, help does not work on Windows 10.
And Hercules is not supported on Windows NT.
</li>
</ul>
<p>
If, after all that, you decide to crank up your NT workstation
to Telnet to Hercules on a more modern system, here's how you do it:
</p>
<blockquote>
<table style="padding:15px 15px 15px 15px">
<tr>
<td style="padding:15px 15px 15px 15px">
<img src="images/telnetwinntconnect.png" border="0" alt="Windows NT Telnet connect dialog" style="vertical-align:top" />
</td>
<td style="padding:15px 15px 15px 15px">
<p>
<em>Host Name:</em>
You can use "@ccuu" following the host name to
connect to a specific printer-keyboard address in the Hercules configuration file. Example:
</p>
<pre>
localhost@001f
</pre>
<p>
<em>Port:</em> must match the value of the CNSLPORT statement in the Hercules configuration file.
Although a drop-down box is shown, you can just type in a port number
</p>
<p>
<em>TermType:</em> must be ANSI.
</p>
</td>
</tr>
<tr>
<td style="padding:15px 15px 15px 15px">
<img src="images/telnetwinnttermpref.png" border="0" alt="Windows NT Telnet terminal preferences dialog" style="vertical-align:top" />
</td>
<td style="padding:15px 15px 15px 15px">
<p>
<em><b>Local echo</b></em> must be checked under <em>Terminal Options</em>.
</p>
<p>
<em>VT100/ANSI</em> must be selected for <em>Emulation</em>.
</p>
</td>
</tr>
</table>
</blockquote>
<p>
<a href="#pagetop">Return to top of page</a>
</p>
<p>
<a href="##" onclick="history.go(-1)"><img src="images/back.gif" border=0 alt="back"></a>
<small>
<p>Last updated 04 May 2016
</BODY>
</HTML>