1 ===============================
2 IBM 3270 Display System support
3 ===============================
4
5 This file describes the driver that supports l
6 of IBM 3270 devices. It consists of three sec
7
8 * Introduction
9 * Installation
10 * Operation
11
12
13 Introduction
14 ============
15
16 This paper describes installing and operating
17 Linux/390. A 3270 device is a block-mode rows
18 which I'm sure hundreds of millions were sold
19 twenty and thirty years ago.
20
21 You may have 3270s in-house and not know it.
22 VM-ESA operating system, define a 3270 to your
23 the command "DEF GRAF <hex-address>" This pap
24 defining four 3270s with the CP/CMS commands:
25
26 - DEF GRAF 620
27 - DEF GRAF 621
28 - DEF GRAF 622
29 - DEF GRAF 623
30
31 Your network connection from VM-ESA allows you
32 another 3270 emulator, started from an xterm w
33 workstation. With the DEF GRAF command, an ap
34 and this Linux-390 3270 driver, you have anoth
35 Linux box.
36
37 This paper covers installation of the driver a
38 dialed-in x3270.
39
40
41 Installation
42 ============
43
44 You install the driver by installing a patch,
45 running the configuration script (config3270.s
46
47 WARNING: If you are using 3270 console suppor
48 configuration script every time you change the
49 by using the condev= parameter in silo's /boot
50 you should rerun the configuration script ever
51 including the console 3270, changes subchannel
52 one another. ReIPL as soon as possible after
53 script and the resulting /tmp/mkdev3270.
54
55 If you have chosen to make tub3270 a module, y
56 configuration file under /etc/modprobe.d/. If
57 virtual machine, you can use DEF GRAF to defin
58
59 You may generate both 3270 and 3215 console su
60 other, or neither. If you generate both, the
61 not changed. Use #CP Q TERM to see what the c
62 Use #CP TERM CONMODE 3270 to change it to 3270
63 3270 console support, then the driver automati
64 at boot time to a 3270 if it is a 3215.
65
66 In brief, these are the steps:
67
68 1. Install the tub3270 patch
69 2. (If a module) add a line to a file
70 3. (If VM) define devices with DEF GRA
71 4. Reboot
72 5. Configure
73
74 To test that everything works, assuming VM and
75
76 1. Bring up an x3270 window.
77 2. Use the DIAL command in that window
78 3. You should immediately see a Linux
79
80 Here are the installation steps in detail:
81
82 1. The 3270 driver is a part of the o
83 source. Build a tree with the kernel
84 patches. Then do::
85
86 make oldconfig
87 (If you wish to disable 3215 c
88 .config; change CONFIG_TN3215'
89 and rerun "make oldconfig".)
90 make image
91 make modules
92 make modules_install
93
94 2. (Perform this step only if you have
95 module.) Add a line to a file `/etc/m
96 load the driver when it's needed. Wit
97 login prompts appear on your 3270s as
98 with emulated 3270s, as soon as you di
99 command "DIAL <vmguestname>"). Since
100 227, the line to add should be::
101
102 alias char-major-227 tub3270
103
104 3. Define graphic devices to your vm g
105 haven't already. Define them before y
106
107 - DEFINE GRAF 620
108 - DEFINE GRAF 621
109 - DEFINE GRAF 622
110 - DEFINE GRAF 623
111
112 4. Reboot. The reboot process scans h
113 3270s, and this enables the tub3270 dr
114 correctly to the configuration request
115 you have chosen 3270 console support,
116 as a 3270, not a 3215.
117
118 5. Run the 3270 configuration script c
119 distributed in this same directory, Do
120 config3270.sh. Inspect the output scr
121 /tmp/mkdev3270, and then run that scri
122 necessary character special device fil
123 changes to /etc/inittab.
124
125 Then notify /sbin/init that /etc/initt
126 the telinit command with the q operand
127
128 cd Documentation/arch/s390
129 sh config3270.sh
130 sh /tmp/mkdev3270
131 telinit q
132
133 This should be sufficient for your fir
134 configuration has changed and you're r
135 should follow these steps::
136
137 Change 3270 configuration
138 Reboot
139 Run config3270 and /tmp/mkdev3
140 Reboot
141
142 Here are the testing steps in detail:
143
144 1. Bring up an x3270 window, or use an
145 3279, or use the 3270 emulator of your
146 running the emulator on your PC or wor
147 the command, for example::
148
149 x3270 vm-esa-domain-name &
150
151 if you wanted a 3278 Model 4 with 43 r
152 default model number. The driver does
153 extended attributes.
154
155 The screen you should now see contains
156 lines near the bottom. Use TAB to mov
157 probably labeled "COMMAND ===>".
158
159 2. Use the DIAL command instead of the
160 to one of the virtual 3270s you define
161 commands::
162
163 dial my-vm-guest-name
164
165 3. You should immediately see a login
166 Linux-390 operating system. If that d
167 see instead the line "DIALED TO my-vm-
168
169 To troubleshoot: do these things.
170
171 A. Is the driver loaded? Use the lsmo
172 to find out. Probably it isn't. Try
173 the command "insmod tub3270". Does th
174 messages? Ha! There's your problem.
175
176 B. Is the /etc/inittab file modified a
177 above? Use the grep command to find o
178 "grep 3270 /etc/inittab". Nothing fou
179 problem!
180
181 C. Are the device special files create
182 step 2 above? Use the ls -l command t
183 issue "ls -l /dev/3270/tty620". The o
184 letter "c" meaning character device an
185 just to the left of the device name.
186 Wrong major number? Wrong minor numbe
187 problem!
188
189 D. Do you get the message::
190
191 "HCPDIA047E my-vm-guest-name
192
193 If so, you must issue the command "DEF
194 3215 console and then reboot the syste
195
196
197
198 OPERATION.
199 ==========
200
201 The driver defines three areas on the 3270 scr
202 input area, and the status area.
203
204 The log area takes up all but the bottom two l
205 driver writes terminal output to it, starting
206 down. When it fills, the status area changes
207 "Linux More...". After a scrolling timeout of
208 screen clears and more output is written, from
209
210 The input area extends from the beginning of t
211 line to the start of the status area. You typ
212 and hit ENTER to execute them.
213
214 The status area initializes to "Linux Running"
215 fuzzy feeling. When the log area fills up and
216 changes to "Linux More...". At this time you
217 nothing. If you do nothing, the screen will c
218 and more output will appear. You may hit ENTE
219 the input area to toggle between "Linux More..
220 which indicates no scrolling will occur. (If
221 Running" and nothing typed, the application re
222
223 You may change the scrolling timeout value. F
224 command line::
225
226 echo scrolltime=60 > /proc/tty/driver/
227
228 changes the scrolling timeout value to 60 sec.
229 you wish to prevent scrolling entirely.
230
231 Other things you may do when the log area fill
232 clear the log area and write more output to it
233 the log area and the input area and write more
234
235 Some of the Program Function (PF) and Program
236 preassigned special functions. The ones that
237 when pressed.
238
239 PA1 causes a SIGINT to the currently running a
240 the same thing from the input area, by typing
241
242 PA2 causes the log area to be cleared. If out
243 written to the log area.
244
245 PF3 causes an EOF to be received as input by t
246 cause an EOF also by typing "^D" and hitting E
247
248 No PF key is preassigned to cause a job suspen
249 job suspension by typing "^Z" and hitting ENTE
250 assign this function to a PF key. To make PF7
251 execute the command::
252
253 echo pf7=^z > /proc/tty/driver/tty3270
254
255 If the input you type does not end with the tw
256 driver appends a newline character and sends i
257 otherwise the driver strips the "^n" and does
258 The IBM 3215 driver behaves similarly.
259
260 Pf10 causes the most recent command to be retr
261 command stack (default depth 20) and displayed
262 may hit PF10 again for the next-most-recent co
263 command is entered into the stack only when th
264 invisible (such as for password entry) and it
265 current top entry. PF10 rotates backward thro
266 PF11 rotates forward. You may assign the back
267 key (or PA key, for that matter), say, PA3, wi
268
269 echo -e pa3=\\033k > /proc/tty/driver/
270
271 This assigns the string ESC-k to PA3. Similar
272 performs the forward function. (Rationale: I
273 editing, ESC-k and ESC-j retrieve backward and
274 Suggestions welcome.)
275
276 Is a stack size of twenty commands not to your
277 the fly. To change to saving the last 100 com
278 command::
279
280 echo recallsize=100 > /proc/tty/driver
281
282 Have a command you issue frequently? Assign i
283 the command::
284
285 echo pf24="mkdir foobar; cd foobar" >
286
287 to execute the commands mkdir foobar and cd fo
288 hit PF24. Want to see the command line first,
289 Use the -n option of the echo command::
290
291 echo -n pf24="mkdir foo; cd foo" > /pr
292
293
294
295 Happy testing! I welcome any and all comments
296 driver, etc etc.
297
298 Dick Hitt <rbh00@utsglobal.com>
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.