Hi everyone!
I know this post might be outdated but since there is virtually no info on the internet about making this connection and I’m sure I’m not the only one who had this problem, this is what worked for our specific case.
This has been tested under Windows Server 2019, UiPath version 21.4, and 32-bit iSeries 1.1.7.3. IT WON’T WORK IN 64-BIT, TRY TO SWITCH TO 32-BIT I-SERIES VERSION.
Step 1: Go to IBM support at this link and download this package: EHLLAPI With the Access Client Solutions Emulator
It will ask for registration, go ahead. Then, move to the download page and download the following .exe:
Step 2: Execute it and install it (this is very important) in the same folder you have the .exe program. If it’s not the default path (it might be) go ahead and look for the folder that is similar to this one (the EHHLAPI folder won’t be there, you are about to install it). Next, next, next and now, go to UiPath and download the latest UiPath.Terminal.Activities (by the time this post was written it was 2.2.0):
Step 3: Open a .HOD file (the connection file) to your terminal session. It may ask you for a login in the Java terminal. Log there (you’ll need to automate this too or change the settings to avoid iSeries to ask twice for the login). Once you’ve done the first login, stop there. Go to UiPath and put a “Terminal Session” activity somewhere in the code. This is the configuration it worked for me (I’m from Spain, that’s why I selected Windows-1252, but yours could be different). Deselect EHLL enhanced (it wasn’t working for me).
Step 4: If everything is OK, two things can happen. If the connection is established but the encoding is wrong, the Terminal Wizard won’t show an error but the screen will be black. Try changing the encoding (you can check it somewhere in the configuration). If the connection is established and it’s working, you should be able to see the same info in both terminals. If that’s your case, you’ve successfully connected UiPath to IBM iSeries terminal.
Errors: This activity isn’t very descriptive when it comes to errors. In fact, it doesn’t tell you what’s going on. The things that happen to me the most are the following:
TerminalProxy error: You left Terminal.Host.Session.exe running. Kill the process manually.
Error “error” (literally that’s the error message): No error message at all. It can be thousands of things (and what led me to do all the previous things). Most of the time it’s because Terminal.Host.Session.exe is running (when you interrupt an execution, UiPath doesn’t terminate the process). It also can be related to the application, so kill both.
Timeout: Proceed the same way like in the “error” error.
I hope this is useful for other desperated developers like me who had to deal with this oldie but goodie terminal! Also if you are savvy with C, Java or C#, there is an API you can leverage. Automation using EHLLAPI - HCL SW Blogs