Package: tnz
tnzUse a standard terminal emulator as a 3270 terminal interface. Write
scripts to automate 3270 terminal interaction. This is both a 3270
terminal emulator and a Python libary. The zti module provides a 3270
user interface through a Windows Command Prompt or a unix/ascii
terminal. The tnz module handles the interface to the 3270 data
stream. The ati module allows for easier 3270 terminal automation.FeaturesRuns on many platforms (including z/OS)Secure telnet (TLS)by defaultManages multiple 3270 sessions at the same timeLightweight - does not duplicate standard terminal functionCode page 310 for APL graphic symbols (i.e. 3278T terminal type)InstallingPython 3.6 or later is required.
Although not required, on platforms other than z/OS, it is suggested
you also install theebcdicpackage from PyPI.
Use pip to install the latest tnz:pip3 install ebcdic tnzUsageAutomationSeeexamplesto get started writing a script to automate 3270 interaction.EmulatorRun the installed zti (Z Terminal Interface) script to start the
emulator:ztiIf your path is not set up for running the installed zti console script,
you can run zti withpython -m tnz.ztiinstead.Startingztitakes you into the zti command line interface shell.
Key tab for command completion, up/down for command history.Thegotocommand takes you to a full screen 3270 interface. When
space is available in the terminal screen/window, a status line is
provided as well as a session selector.The basic syntax ofgotois:goto fully-qualified-host-name[:port]In Windows, the Lucida Console font works well with graphic character
APL symbols exploited by ISPF.Large and arbitrarily-sized screens are supported.Standard unix/ascii terminals are supported. In the screenshot below,
PuTTY is used as the terminal emulator. The connection was made from
PuTTY to z/OS via ssh and zti is running on z/OS.The code in this repository aims to be portable. To achieve this, the
number of dependencies is kept to a minimum. The only hard
requirement across platforms is Python and the Python Standard
Library. Though it is likely you will also want additional ebcdic
code pages in order to use your code page of choice (i.e. the ebcdic
package).Emulator FeaturesUse Alt+letter to access ISPF menusMouse click sets cursor positionMouse double-click sets cursor position and send EnterUse any EBCDIC code page available to PythonUse of code page 310 for APL graphic symbolsPaste multiline block of textRunning zti on WindowsThe trapping of the keyboard disables keyboard shortcuts documented
in the Control-menu->Edit menu. But the functions can still be
accessed through the Control-menu. For example: mouse click top-left
corner, E (Edit), F (Find) to find text.To copy text in Command Prompt, make sure that the Quick Edit Mode
option is selected in the Properties accessed through the
Control-menu. Then you can hold Shift while using the mouse to
select text. Once the text is selected, press Enter to copy the
text.There are other ways to select text, but I this to be the
easiest.Before establishing a session, get the window sized the way you want
it. Window resizing is not handled well in Windows. If youdoresize, just use Esc to get to the command prompt thengototo get
back to the session.Control-menu->Properties will take you to properties for the
terminal. The character size and font can be set. I recommendLucida Console- it is readable and the graphic symbols are
fairly good at connecting like they are supposed to.DocumentationSeehere.For additional details, see docstrings in source code.ContributingSeeCONTRIBUTING.md.AcknowledgmentsHats off to the team responsible for the IBM internal Automated Task
Interpreter (ATI) tool:
Richard Lynch, Karen Eickemeyer, and Ronald Barber.