€•/¤Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œtranslations”Œ LanguagesNode”“”)”}”(hhh]”(hŒpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ"/translations/zh_CN/arch/s390/3270”Œmodname”NŒ classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ"/translations/zh_TW/arch/s390/3270”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ"/translations/it_IT/arch/s390/3270”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ"/translations/ja_JP/arch/s390/3270”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ"/translations/ko_KR/arch/s390/3270”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ"/translations/sp_SP/arch/s390/3270”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒIBM 3270 Display System support”h]”hŒIBM 3270 Display System support”…””}”(hh¨hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hh£hžhhŸŒ" This paper presumes you will be defining four 3270s with the CP/CMS commands:”h]”hXYou may have 3270s in-house and not know it. If youâ€™re using the VM-ESA operating system, define a 3270 to your virtual machine by using the command â€œDEF GRAF â€ This paper presumes you will be defining four 3270s with the CP/CMS commands:”…””}”(hjGhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khj(hžhubhÈ)”}”(hŒ<- DEF GRAF 620 - DEF GRAF 621 - DEF GRAF 622 - DEF GRAF 623 ”h]”hÎ)”}”(hhh]”(hÓ)”}”(hŒDEF GRAF 620”h]”h¸)”}”(hj^h]”hŒDEF GRAF 620”…””}”(hj`hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khj\ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhjYubhÓ)”}”(hŒDEF GRAF 621”h]”h¸)”}”(hjuh]”hŒDEF GRAF 621”…””}”(hjwhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khjsubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhjYubhÓ)”}”(hŒDEF GRAF 622”h]”h¸)”}”(hjŒh]”hŒDEF GRAF 622”…””}”(hjŽhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KhjŠubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhjYubhÓ)”}”(hŒ DEF GRAF 623 ”h]”h¸)”}”(hŒDEF GRAF 623”h]”hŒDEF GRAF 623”…””}”(hj¥hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khj¡ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhjYubeh}”(h]”h ]”h"]”h$]”h&]”j Œ-”uh1hÍhŸh¶h KhjUubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhŸh¶h Khj(hžhubh¸)”}”(hX#Your network connection from VM-ESA allows you to use x3270, tn3270, or another 3270 emulator, started from an xterm window on your PC or workstation. With the DEF GRAF command, an application such as xterm, and this Linux-390 3270 driver, you have another way of talking to your Linux box.”h]”hX#Your network connection from VM-ESA allows you to use x3270, tn3270, or another 3270 emulator, started from an xterm window on your PC or workstation. With the DEF GRAF command, an application such as xterm, and this Linux-390 3270 driver, you have another way of talking to your Linux box.”…””}”(hjÆhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khj(hžhubh¸)”}”(hŒPThis paper covers installation of the driver and operation of a dialed-in x3270.”h]”hŒPThis paper covers installation of the driver and operation of a dialed-in x3270.”…””}”(hjÔhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K%hj(hžhubeh}”(h]”Œintroduction”ah ]”h"]”Œintroduction”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒInstallation”h]”hŒInstallation”…””}”(hjíhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjêhžhhŸh¶h K*ubh¸)”}”(hŒŒYou install the driver by installing a patch, doing a kernel build, and running the configuration script (config3270.sh, in this directory).”h]”hŒŒYou install the driver by installing a patch, doing a kernel build, and running the configuration script (config3270.sh, in this directory).”…””}”(hjûhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K,hjêhžhubh¸)”}”(hX×WARNING: If you are using 3270 console support, you must rerun the configuration script every time you change the console's address (perhaps by using the condev= parameter in silo's /boot/parmfile). More precisely, you should rerun the configuration script every time your set of 3270s, including the console 3270, changes subchannel identifier relative to one another. ReIPL as soon as possible after running the configuration script and the resulting /tmp/mkdev3270.”h]”hXÛWARNING: If you are using 3270 console support, you must rerun the configuration script every time you change the consoleâ€™s address (perhaps by using the condev= parameter in siloâ€™s /boot/parmfile). More precisely, you should rerun the configuration script every time your set of 3270s, including the console 3270, changes subchannel identifier relative to one another. ReIPL as soon as possible after running the configuration script and the resulting /tmp/mkdev3270.”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K/hjêhžhubh¸)”}”(hŒÍIf you have chosen to make tub3270 a module, you add a line to a configuration file under /etc/modprobe.d/. If you are working on a VM virtual machine, you can use DEF GRAF to define virtual 3270 devices.”h]”hŒÍIf you have chosen to make tub3270 a module, you add a line to a configuration file under /etc/modprobe.d/. If you are working on a VM virtual machine, you can use DEF GRAF to define virtual 3270 devices.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K7hjêhžhubh¸)”}”(hX‡You may generate both 3270 and 3215 console support, or one or the other, or neither. If you generate both, the console type under VM is not changed. Use #CP Q TERM to see what the current console type is. Use #CP TERM CONMODE 3270 to change it to 3270. If you generate only 3270 console support, then the driver automatically converts your console at boot time to a 3270 if it is a 3215.”h]”hX‡You may generate both 3270 and 3215 console support, or one or the other, or neither. If you generate both, the console type under VM is not changed. Use #CP Q TERM to see what the current console type is. Use #CP TERM CONMODE 3270 to change it to 3270. If you generate only 3270 console support, then the driver automatically converts your console at boot time to a 3270 if it is a 3215.”…””}”(hj%hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K;hjêhžhubh¸)”}”(hŒIn brief, these are the steps:”h]”hŒIn brief, these are the steps:”…””}”(hj3hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KBhjêhžhubhÈ)”}”(hŒž1. Install the tub3270 patch 2. (If a module) add a line to a file in `/etc/modprobe.d/*.conf` 3. (If VM) define devices with DEF GRAF 4. Reboot 5. Configure ”h]”hŒenumerated_list”“”)”}”(hhh]”(hÓ)”}”(hŒInstall the tub3270 patch”h]”h¸)”}”(hjLh]”hŒInstall the tub3270 patch”…””}”(hjNhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KDhjJubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhjGubhÓ)”}”(hŒ>(If a module) add a line to a file in `/etc/modprobe.d/*.conf`”h]”h¸)”}”(hjch]”(hŒ&(If a module) add a line to a file in ”…””}”(hjehžhhŸNh NubhŒtitle_reference”“”)”}”(hŒ`/etc/modprobe.d/*.conf`”h]”hŒ/etc/modprobe.d/*.conf”…””}”(hjnhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jlhjeubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KEhjaubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhjGubhÓ)”}”(hŒ$(If VM) define devices with DEF GRAF”h]”h¸)”}”(hjŠh]”hŒ$(If VM) define devices with DEF GRAF”…””}”(hjŒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KFhjˆubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhjGubhÓ)”}”(hŒReboot”h]”h¸)”}”(hj¡h]”hŒReboot”…””}”(hj£hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KGhjŸubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhjGubhÓ)”}”(hŒ Configure ”h]”h¸)”}”(hŒ Configure”h]”hŒ Configure”…””}”(hjºhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KHhj¶ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhjGubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ.”uh1jEhjAubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhŸh¶h KDhjêhžhubh¸)”}”(hŒ5To test that everything works, assuming VM and x3270,”h]”hŒ5To test that everything works, assuming VM and x3270,”…””}”(hjßhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KJhjêhžhubhÈ)”}”(hŒy1. Bring up an x3270 window. 2. Use the DIAL command in that window. 3. You should immediately see a Linux login screen. ”h]”jF)”}”(hhh]”(hÓ)”}”(hŒBring up an x3270 window.”h]”h¸)”}”(hjöh]”hŒBring up an x3270 window.”…””}”(hjøhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KLhjôubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhjñubhÓ)”}”(hŒ$Use the DIAL command in that window.”h]”h¸)”}”(hj h]”hŒ$Use the DIAL command in that window.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KMhjubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhjñubhÓ)”}”(hŒ1You should immediately see a Linux login screen. ”h]”h¸)”}”(hŒ0You should immediately see a Linux login screen.”h]”hŒ0You should immediately see a Linux login screen.”…””}”(hj&hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KNhj"ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhjñubeh}”(h]”h ]”h"]”h$]”h&]”jÔjÕjÖhj×jØuh1jEhjíubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhŸh¶h KLhjêhžhubh¸)”}”(hŒ*Here are the installation steps in detail:”h]”hŒ*Here are the installation steps in detail:”…””}”(hjFhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KPhjêhžhubhÈ)”}”(hXy1. The 3270 driver is a part of the official Linux kernel source. Build a tree with the kernel source and any necessary patches. Then do:: make oldconfig (If you wish to disable 3215 console support, edit .config; change CONFIG_TN3215's value to "n"; and rerun "make oldconfig".) make image make modules make modules_install 2. (Perform this step only if you have configured tub3270 as a module.) Add a line to a file `/etc/modprobe.d/*.conf` to automatically load the driver when it's needed. With this line added, you will see login prompts appear on your 3270s as soon as boot is complete (or with emulated 3270s, as soon as you dial into your vm guest using the command "DIAL "). Since the line-mode major number is 227, the line to add should be:: alias char-major-227 tub3270 3. Define graphic devices to your vm guest machine, if you haven't already. Define them before you reboot (reipl): - DEFINE GRAF 620 - DEFINE GRAF 621 - DEFINE GRAF 622 - DEFINE GRAF 623 4. Reboot. The reboot process scans hardware devices, including 3270s, and this enables the tub3270 driver once loaded to respond correctly to the configuration requests of the next step. If you have chosen 3270 console support, your console now behaves as a 3270, not a 3215. 5. Run the 3270 configuration script config3270. It is distributed in this same directory, Documentation/arch/s390, as config3270.sh. Inspect the output script it produces, /tmp/mkdev3270, and then run that script. This will create the necessary character special device files and make the necessary changes to /etc/inittab. Then notify /sbin/init that /etc/inittab has changed, by issuing the telinit command with the q operand:: cd Documentation/arch/s390 sh config3270.sh sh /tmp/mkdev3270 telinit q This should be sufficient for your first time. If your 3270 configuration has changed and you're reusing config3270, you should follow these steps:: Change 3270 configuration Reboot Run config3270 and /tmp/mkdev3270 Reboot ”h]”(h¸)”}”(hŒ1. The 3270 driver is a part of the official Linux kernel source. Build a tree with the kernel source and any necessary patches. Then do::”h]”hŒŒ1. The 3270 driver is a part of the official Linux kernel source. Build a tree with the kernel source and any necessary patches. Then do:”…””}”(hjXhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KRhjTubhŒ literal_block”“”)”}”(hŒ¹make oldconfig (If you wish to disable 3215 console support, edit .config; change CONFIG_TN3215's value to "n"; and rerun "make oldconfig".) make image make modules make modules_install”h]”hŒ¹make oldconfig (If you wish to disable 3215 console support, edit .config; change CONFIG_TN3215's value to "n"; and rerun "make oldconfig".) make image make modules make modules_install”…””}”hjhsbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1jfhŸh¶h KVhjTubh¸)”}”(hX»2. (Perform this step only if you have configured tub3270 as a module.) Add a line to a file `/etc/modprobe.d/*.conf` to automatically load the driver when it's needed. With this line added, you will see login prompts appear on your 3270s as soon as boot is complete (or with emulated 3270s, as soon as you dial into your vm guest using the command "DIAL "). Since the line-mode major number is 227, the line to add should be::”h]”(hŒ^2. (Perform this step only if you have configured tub3270 as a module.) Add a line to a file ”…””}”(hjxhžhhŸNh Nubjm)”}”(hŒ`/etc/modprobe.d/*.conf`”h]”hŒ/etc/modprobe.d/*.conf”…””}”(hj€hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jlhjxubhXJ to automatically load the driver when itâ€™s needed. With this line added, you will see login prompts appear on your 3270s as soon as boot is complete (or with emulated 3270s, as soon as you dial into your vm guest using the command â€œDIAL â€). Since the line-mode major number is 227, the line to add should be:”…””}”(hjxhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K^hjTubjg)”}”(hŒalias char-major-227 tub3270”h]”hŒalias char-major-227 tub3270”…””}”hj˜sbah}”(h]”h ]”h"]”h$]”h&]”jvjwuh1jfhŸh¶h KfhjTubh¸)”}”(hŒs3. Define graphic devices to your vm guest machine, if you haven't already. Define them before you reboot (reipl):”h]”hŒu3. Define graphic devices to your vm guest machine, if you havenâ€™t already. Define them before you reboot (reipl):”…””}”(hj¦hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KhhjTubhÈ)”}”(hŒH- DEFINE GRAF 620 - DEFINE GRAF 621 - DEFINE GRAF 622 - DEFINE GRAF 623 ”h]”hÎ)”}”(hhh]”(hÓ)”}”(hŒDEFINE GRAF 620”h]”h¸)”}”(hj½h]”hŒDEFINE GRAF 620”…””}”(hj¿hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kkhj»ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhj¸ubhÓ)”}”(hŒDEFINE GRAF 621”h]”h¸)”}”(hjÔh]”hŒDEFINE GRAF 621”…””}”(hjÖhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KlhjÒubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhj¸ubhÓ)”}”(hŒDEFINE GRAF 622”h]”h¸)”}”(hjëh]”hŒDEFINE GRAF 622”…””}”(hjíhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kmhjéubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhj¸ubhÓ)”}”(hŒDEFINE GRAF 623 ”h]”h¸)”}”(hŒDEFINE GRAF 623”h]”hŒDEFINE GRAF 623”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Knhjubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhj¸ubeh}”(h]”h ]”h"]”h$]”h&]”j j¿uh1hÍhŸh¶h Kkhj´ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhŸh¶h KkhjTubh¸)”}”(hX4. Reboot. The reboot process scans hardware devices, including 3270s, and this enables the tub3270 driver once loaded to respond correctly to the configuration requests of the next step. If you have chosen 3270 console support, your console now behaves as a 3270, not a 3215.”h]”hX4. Reboot. The reboot process scans hardware devices, including 3270s, and this enables the tub3270 driver once loaded to respond correctly to the configuration requests of the next step. If you have chosen 3270 console support, your console now behaves as a 3270, not a 3215.”…””}”(hj$hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KphjTubh¸)”}”(hXG5. Run the 3270 configuration script config3270. It is distributed in this same directory, Documentation/arch/s390, as config3270.sh. Inspect the output script it produces, /tmp/mkdev3270, and then run that script. This will create the necessary character special device files and make the necessary changes to /etc/inittab.”h]”hXG5. Run the 3270 configuration script config3270. It is distributed in this same directory, Documentation/arch/s390, as config3270.sh. Inspect the output script it produces, /tmp/mkdev3270, and then run that script. This will create the necessary character special device files and make the necessary changes to /etc/inittab.”…””}”(hj2hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KvhjTubh¸)”}”(hŒiThen notify /sbin/init that /etc/inittab has changed, by issuing the telinit command with the q operand::”h]”hŒhThen notify /sbin/init that /etc/inittab has changed, by issuing the telinit command with the q operand:”…””}”(hj@hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K}hjTubjg)”}”(hŒGcd Documentation/arch/s390 sh config3270.sh sh /tmp/mkdev3270 telinit q”h]”hŒGcd Documentation/arch/s390 sh config3270.sh sh /tmp/mkdev3270 telinit q”…””}”hjNsbah}”(h]”h ]”h"]”h$]”h&]”jvjwuh1jfhŸh¶h K€hjTubh¸)”}”(hŒ•This should be sufficient for your first time. If your 3270 configuration has changed and you're reusing config3270, you should follow these steps::”h]”hŒ–This should be sufficient for your first time. If your 3270 configuration has changed and youâ€™re reusing config3270, you should follow these steps:”…””}”(hj\hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K…hjTubjg)”}”(hŒIChange 3270 configuration Reboot Run config3270 and /tmp/mkdev3270 Reboot”h]”hŒIChange 3270 configuration Reboot Run config3270 and /tmp/mkdev3270 Reboot”…””}”hjjsbah}”(h]”h ]”h"]”h$]”h&]”jvjwuh1jfhŸh¶h K‰hjTubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÇhŸh¶h KRhjêhžhubh¸)”}”(hŒ%Here are the testing steps in detail:”h]”hŒ%Here are the testing steps in detail:”…””}”(hj~hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KŽhjêhžhubhÈ)”}”(hX€1. Bring up an x3270 window, or use an actual hardware 3278 or 3279, or use the 3270 emulator of your choice. You would be running the emulator on your PC or workstation. You would use the command, for example:: x3270 vm-esa-domain-name & if you wanted a 3278 Model 4 with 43 rows of 80 columns, the default model number. The driver does not take advantage of extended attributes. The screen you should now see contains a VM logo with input lines near the bottom. Use TAB to move to the bottom line, probably labeled "COMMAND ===>". 2. Use the DIAL command instead of the LOGIN command to connect to one of the virtual 3270s you defined with the DEF GRAF commands:: dial my-vm-guest-name 3. You should immediately see a login prompt from your Linux-390 operating system. If that does not happen, you would see instead the line "DIALED TO my-vm-guest-name 0620". To troubleshoot: do these things. A. Is the driver loaded? Use the lsmod command (no operands) to find out. Probably it isn't. Try loading it manually, with the command "insmod tub3270". Does that command give error messages? Ha! There's your problem. B. Is the /etc/inittab file modified as in installation step 3 above? Use the grep command to find out; for instance, issue "grep 3270 /etc/inittab". Nothing found? There's your problem! C. Are the device special files created, as in installation step 2 above? Use the ls -l command to find out; for instance, issue "ls -l /dev/3270/tty620". The output should start with the letter "c" meaning character device and should contain "227, 1" just to the left of the device name. No such file? no "c"? Wrong major number? Wrong minor number? There's your problem! D. Do you get the message:: "HCPDIA047E my-vm-guest-name 0620 does not exist"? If so, you must issue the command "DEF GRAF 620" from your VM 3215 console and then reboot the system. ”h]”(h¸)”}”(hŒÕ1. Bring up an x3270 window, or use an actual hardware 3278 or 3279, or use the 3270 emulator of your choice. You would be running the emulator on your PC or workstation. You would use the command, for example::”h]”hŒÔ1. Bring up an x3270 window, or use an actual hardware 3278 or 3279, or use the 3270 emulator of your choice. You would be running the emulator on your PC or workstation. You would use the command, for example:”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KhjŒubjg)”}”(hŒx3270 vm-esa-domain-name &”h]”hŒx3270 vm-esa-domain-name &”…””}”hjžsbah}”(h]”h ]”h"]”h$]”h&]”jvjwuh1jfhŸh¶h K•hjŒubh¸)”}”(hŒŽif you wanted a 3278 Model 4 with 43 rows of 80 columns, the default model number. The driver does not take advantage of extended attributes.”h]”hŒŽif you wanted a 3278 Model 4 with 43 rows of 80 columns, the default model number. The driver does not take advantage of extended attributes.”…””}”(hj¬hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K—hjŒubh¸)”}”(hŒ™The screen you should now see contains a VM logo with input lines near the bottom. Use TAB to move to the bottom line, probably labeled "COMMAND ===>".”h]”hŒThe screen you should now see contains a VM logo with input lines near the bottom. Use TAB to move to the bottom line, probably labeled â€œCOMMAND ===>â€.”…””}”(hjºhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K›hjŒubh¸)”}”(hŒ„2. Use the DIAL command instead of the LOGIN command to connect to one of the virtual 3270s you defined with the DEF GRAF commands::”h]”hŒƒ2. Use the DIAL command instead of the LOGIN command to connect to one of the virtual 3270s you defined with the DEF GRAF commands:”…””}”(hjÈhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KŸhjŒubjg)”}”(hŒdial my-vm-guest-name”h]”hŒdial my-vm-guest-name”…””}”hjÖsbah}”(h]”h ]”h"]”h$]”h&]”jvjwuh1jfhŸh¶h K£hjŒubh¸)”}”(hŒ°3. You should immediately see a login prompt from your Linux-390 operating system. If that does not happen, you would see instead the line "DIALED TO my-vm-guest-name 0620".”h]”hŒ´3. You should immediately see a login prompt from your Linux-390 operating system. If that does not happen, you would see instead the line â€œDIALED TO my-vm-guest-name 0620â€.”…””}”(hjähžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K¥hjŒubh¸)”}”(hŒ"To troubleshoot: do these things.”h]”hŒ"To troubleshoot: do these things.”…””}”(hjòhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K©hjŒubh¸)”}”(hŒßA. Is the driver loaded? Use the lsmod command (no operands) to find out. Probably it isn't. Try loading it manually, with the command "insmod tub3270". Does that command give error messages? Ha! There's your problem.”h]”hŒçA. Is the driver loaded? Use the lsmod command (no operands) to find out. Probably it isnâ€™t. Try loading it manually, with the command â€œinsmod tub3270â€. Does that command give error messages? Ha! Thereâ€™s your problem.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K«hjŒubh¸)”}”(hŒ½B. Is the /etc/inittab file modified as in installation step 3 above? Use the grep command to find out; for instance, issue "grep 3270 /etc/inittab". Nothing found? There's your problem!”h]”hŒÃB. Is the /etc/inittab file modified as in installation step 3 above? Use the grep command to find out; for instance, issue â€œgrep 3270 /etc/inittabâ€. Nothing found? Thereâ€™s your problem!”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K°hjŒubh¸)”}”(hXzC. Are the device special files created, as in installation step 2 above? Use the ls -l command to find out; for instance, issue "ls -l /dev/3270/tty620". The output should start with the letter "c" meaning character device and should contain "227, 1" just to the left of the device name. No such file? no "c"? Wrong major number? Wrong minor number? There's your problem!”h]”hXŒC. Are the device special files created, as in installation step 2 above? Use the ls -l command to find out; for instance, issue â€œls -l /dev/3270/tty620â€. The output should start with the letter â€œcâ€ meaning character device and should contain â€œ227, 1â€ just to the left of the device name. No such file? no â€œcâ€? Wrong major number? Wrong minor number? Thereâ€™s your problem!”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KµhjŒubjF)”}”(hhh]”hÓ)”}”(hŒSDo you get the message:: "HCPDIA047E my-vm-guest-name 0620 does not exist"? ”h]”(h¸)”}”(hŒDo you get the message::”h]”hŒDo you get the message:”…””}”(hj1hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K½hj-ubjg)”}”(hŒ2"HCPDIA047E my-vm-guest-name 0620 does not exist"?”h]”hŒ2"HCPDIA047E my-vm-guest-name 0620 does not exist"?”…””}”hj?sbah}”(h]”h ]”h"]”h$]”h&]”jvjwuh1jfhŸh¶h K¿hj-ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÒhj*ubah}”(h]”h ]”h"]”h$]”h&]”jÔŒ upperalpha”jÖhj×jØŒstart”Kuh1jEhjŒubh¸)”}”(hŒfIf so, you must issue the command "DEF GRAF 620" from your VM 3215 console and then reboot the system.”h]”hŒjIf so, you must issue the command â€œDEF GRAF 620â€ from your VM 3215 console and then reboot the system.”…””}”(hj[hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KÁhjŒubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÇhŸh¶h Khjêhžhubeh}”(h]”Œinstallation”ah ]”h"]”Œinstallation”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K*ubh¢)”}”(hhh]”(h§)”}”(hŒ OPERATION.”h]”hŒ OPERATION.”…””}”(hjzhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjwhžhhŸh¶h KÇubh¸)”}”(hŒfThe driver defines three areas on the 3270 screen: the log area, the input area, and the status area.”h]”hŒfThe driver defines three areas on the 3270 screen: the log area, the input area, and the status area.”…””}”(hjˆhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KÉhjwhžhubh¸)”}”(hXUThe log area takes up all but the bottom two lines of the screen. The driver writes terminal output to it, starting at the top line and going down. When it fills, the status area changes from "Linux Running" to "Linux More...". After a scrolling timeout of (default) 5 sec, the screen clears and more output is written, from the top down.”h]”hX]The log area takes up all but the bottom two lines of the screen. The driver writes terminal output to it, starting at the top line and going down. When it fills, the status area changes from â€œLinux Runningâ€ to â€œLinux More...â€. After a scrolling timeout of (default) 5 sec, the screen clears and more output is written, from the top down.”…””}”(hj–hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KÌhjwhžhubh¸)”}”(hŒ«The input area extends from the beginning of the second-to-last screen line to the start of the status area. You type commands in this area and hit ENTER to execute them.”h]”hŒ«The input area extends from the beginning of the second-to-last screen line to the start of the status area. You type commands in this area and hit ENTER to execute them.”…””}”(hj¤hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KÒhjwhžhubh¸)”}”(hX$The status area initializes to "Linux Running" to give you a warm fuzzy feeling. When the log area fills up and output awaits, it changes to "Linux More...". At this time you can do several things or nothing. If you do nothing, the screen will clear in (default) 5 sec and more output will appear. You may hit ENTER with nothing typed in the input area to toggle between "Linux More..." and "Linux Holding", which indicates no scrolling will occur. (If you hit ENTER with "Linux Running" and nothing typed, the application receives a newline.)”h]”hX8The status area initializes to â€œLinux Runningâ€ to give you a warm fuzzy feeling. When the log area fills up and output awaits, it changes to â€œLinux More...â€. At this time you can do several things or nothing. If you do nothing, the screen will clear in (default) 5 sec and more output will appear. You may hit ENTER with nothing typed in the input area to toggle between â€œLinux More...â€ and â€œLinux Holdingâ€, which indicates no scrolling will occur. (If you hit ENTER with â€œLinux Runningâ€ and nothing typed, the application receives a newline.)”…””}”(hj²hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KÖhjwhžhubh¸)”}”(hŒVYou may change the scrolling timeout value. For example, the following command line::”h]”hŒUYou may change the scrolling timeout value. For example, the following command line:”…””}”(hjÀhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kßhjwhžhubjg)”}”(hŒ-echo scrolltime=60 > /proc/tty/driver/tty3270”h]”hŒ-echo scrolltime=60 > /proc/tty/driver/tty3270”…””}”hjÎsbah}”(h]”h ]”h"]”h$]”h&]”jvjwuh1jfhŸh¶h Kâhjwhžhubh¸)”}”(hŒnchanges the scrolling timeout value to 60 sec. Set scrolltime to 0 if you wish to prevent scrolling entirely.”h]”hŒnchanges the scrolling timeout value to 60 sec. Set scrolltime to 0 if you wish to prevent scrolling entirely.”…””}”(hjÜhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kähjwhžhubh¸)”}”(hŒÐOther things you may do when the log area fills up are: hit PA2 to clear the log area and write more output to it, or hit CLEAR to clear the log area and the input area and write more output to the log area.”h]”hŒÐOther things you may do when the log area fills up are: hit PA2 to clear the log area and write more output to it, or hit CLEAR to clear the log area and the input area and write more output to the log area.”…””}”(hjêhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kçhjwhžhubh¸)”}”(hŒ˜Some of the Program Function (PF) and Program Attention (PA) keys are preassigned special functions. The ones that are not yield an alarm when pressed.”h]”hŒ˜Some of the Program Function (PF) and Program Attention (PA) keys are preassigned special functions. The ones that are not yield an alarm when pressed.”…””}”(hjøhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Këhjwhžhubh¸)”}”(hŒ‹PA1 causes a SIGINT to the currently running application. You may do the same thing from the input area, by typing "^C" and hitting ENTER.”h]”hŒPA1 causes a SIGINT to the currently running application. You may do the same thing from the input area, by typing â€œ^Câ€ and hitting ENTER.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kïhjwhžhubh¸)”}”(hŒ]PA2 causes the log area to be cleared. If output awaits, it is then written to the log area.”h]”hŒ]PA2 causes the log area to be cleared. If output awaits, it is then written to the log area.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kòhjwhžhubh¸)”}”(hŒzPF3 causes an EOF to be received as input by the application. You may cause an EOF also by typing "^D" and hitting ENTER.”h]”hŒ~PF3 causes an EOF to be received as input by the application. You may cause an EOF also by typing â€œ^Dâ€ and hitting ENTER.”…””}”(hj"hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kõhjwhžhubh¸)”}”(hŒäNo PF key is preassigned to cause a job suspension, but you may cause a job suspension by typing "^Z" and hitting ENTER. You may wish to assign this function to a PF key. To make PF7 cause job suspension, execute the command::”h]”hŒçNo PF key is preassigned to cause a job suspension, but you may cause a job suspension by typing â€œ^Zâ€ and hitting ENTER. You may wish to assign this function to a PF key. To make PF7 cause job suspension, execute the command:”…””}”(hj0hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Køhjwhžhubjg)”}”(hŒ&echo pf7=^z > /proc/tty/driver/tty3270”h]”hŒ&echo pf7=^z > /proc/tty/driver/tty3270”…””}”hj>sbah}”(h]”h ]”h"]”h$]”h&]”jvjwuh1jfhŸh¶h Kýhjwhžhubh¸)”}”(hŒòIf the input you type does not end with the two characters "^n", the driver appends a newline character and sends it to the tty driver; otherwise the driver strips the "^n" and does not append a newline. The IBM 3215 driver behaves similarly.”h]”hŒúIf the input you type does not end with the two characters â€œ^nâ€, the driver appends a newline character and sends it to the tty driver; otherwise the driver strips the â€œ^nâ€ and does not append a newline. The IBM 3215 driver behaves similarly.”…””}”(hjLhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kÿhjwhžhubh¸)”}”(hX$Pf10 causes the most recent command to be retrieved from the tube's command stack (default depth 20) and displayed in the input area. You may hit PF10 again for the next-most-recent command, and so on. A command is entered into the stack only when the input area is not made invisible (such as for password entry) and it is not identical to the current top entry. PF10 rotates backward through the command stack; PF11 rotates forward. You may assign the backward function to any PF key (or PA key, for that matter), say, PA3, with the command::”h]”hX%Pf10 causes the most recent command to be retrieved from the tubeâ€™s command stack (default depth 20) and displayed in the input area. You may hit PF10 again for the next-most-recent command, and so on. A command is entered into the stack only when the input area is not made invisible (such as for password entry) and it is not identical to the current top entry. PF10 rotates backward through the command stack; PF11 rotates forward. You may assign the backward function to any PF key (or PA key, for that matter), say, PA3, with the command:”…””}”(hjZhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Mhjwhžhubjg)”}”(hŒ-echo -e pa3=\\033k > /proc/tty/driver/tty3270”h]”hŒ-echo -e pa3=\\033k > /proc/tty/driver/tty3270”…””}”hjhsbah}”(h]”h ]”h"]”h$]”h&]”jvjwuh1jfhŸh¶h M hjwhžhubh¸)”}”(hŒßThis assigns the string ESC-k to PA3. Similarly, the string ESC-j performs the forward function. (Rationale: In bash with vi-mode line editing, ESC-k and ESC-j retrieve backward and forward history. Suggestions welcome.)”h]”hŒßThis assigns the string ESC-k to PA3. Similarly, the string ESC-j performs the forward function. (Rationale: In bash with vi-mode line editing, ESC-k and ESC-j retrieve backward and forward history. Suggestions welcome.)”…””}”(hjvhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Mhjwhžhubh¸)”}”(hŒIs a stack size of twenty commands not to your liking? Change it on the fly. To change to saving the last 100 commands, execute the command::”h]”hŒŽIs a stack size of twenty commands not to your liking? Change it on the fly. To change to saving the last 100 commands, execute the command:”…””}”(hj„hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Mhjwhžhubjg)”}”(hŒ.echo recallsize=100 > /proc/tty/driver/tty3270”h]”hŒ.echo recallsize=100 > /proc/tty/driver/tty3270”…””}”hj’sbah}”(h]”h ]”h"]”h$]”h&]”jvjwuh1jfhŸh¶h Mhjwhžhubh¸)”}”(hŒUHave a command you issue frequently? Assign it to a PF or PA key! Use the command::”h]”hŒTHave a command you issue frequently? Assign it to a PF or PA key! Use the command:”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Mhjwhžhubjg)”}”(hŒ>echo pf24="mkdir foobar; cd foobar" > /proc/tty/driver/tty3270”h]”hŒ>echo pf24="mkdir foobar; cd foobar" > /proc/tty/driver/tty3270”…””}”hj®sbah}”(h]”h ]”h"]”h$]”h&]”jvjwuh1jfhŸh¶h Mhjwhžhubh¸)”}”(hŒµto execute the commands mkdir foobar and cd foobar immediately when you hit PF24. Want to see the command line first, before you execute it? Use the -n option of the echo command::”h]”hŒ´to execute the commands mkdir foobar and cd foobar immediately when you hit PF24. Want to see the command line first, before you execute it? Use the -n option of the echo command:”…””}”(hj¼hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Mhjwhžhubjg)”}”(hŒ;echo -n pf24="mkdir foo; cd foo" > /proc/tty/driver/tty3270”h]”hŒ;echo -n pf24="mkdir foo; cd foo" > /proc/tty/driver/tty3270”…””}”hjÊsbah}”(h]”h ]”h"]”h$]”h&]”jvjwuh1jfhŸh¶h M#hjwhžhubh¸)”}”(hŒXHappy testing! I welcome any and all comments about this document, the driver, etc etc.”h]”hŒXHappy testing! I welcome any and all comments about this document, the driver, etc etc.”…””}”(hjØhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h M'hjwhžhubh¸)”}”(hŒDick Hitt ”h]”(hŒDick Hitt <”…””}”(hjæhžhhŸNh NubhŒ reference”“”)”}”(hŒrbh00@utsglobal.com”h]”hŒrbh00@utsglobal.com”…””}”(hjðhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:rbh00@utsglobal.com”uh1jîhjæubhŒ>”…””}”(hjæhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h M*hjwhžhubeh}”(h]”Œ operation”ah ]”h"]”Œ operation.”ah$]”h&]”uh1h¡hh£hžhhŸh¶h KÇubeh}”(h]”Œibm-3270-display-system-support”ah ]”h"]”Œibm 3270 display system support”ah$]”h&]”uh1h¡hhhžhhŸh¶h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h¶uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¦NŒ generator”NŒ datestamp”NŒsource_link”NŒ source_url”NŒ toc_backlinks”Œentry”Œfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒreport_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j=Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h¶Œ_destination”NŒ _config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œ image_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jjjçjäjtjqjjuŒ nametypes”}”(j‰jç‰jt‰j‰uh}”(jh£jäj(jqjêjjwuŒ footnote_refs”}”Œ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”hŒsystem_message”“”)”}”(hhh]”h¸)”}”(hŒ:Enumerated list start value not ordinal-1: "D" (ordinal 4)”h]”hŒ>Enumerated list start value not ordinal-1: â€œDâ€ (ordinal 4)”…””}”(hj¤hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hj¡ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”h¶Œline”Kuh1jŸhjŒubaŒtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ decoration”Nhžhub.