Merge pull request #8397 from MicrosoftDocs/NikosMoutzourakis-terminal-IBM-PComm-1

AB#4419: Create not-connecting-IBM-PComm.md

Author: lucciz01

support/power-platform/power-automate/desktop-flows/cannot-connect-to-ibm-personal-communications.md

@@ -0,0 +1,43 @@
+---
+title: Unable to Connect to IBM Personal Communications Session
+description: Solves an issue where you can't connect to an IBM Personal Communications session using the Open terminal session action with the HLLAPI provider.
+ms.custom: sap:Desktop flows
+ms.date: 04/29/2025
+ms.author: nimoutzo 
+author: NikosMoutzourakis
+---
+# Can't connect to an IBM Personal Communications session
+
+This article provides a resolution for an issue where you can't connect to an IBM Personal Communications session using the [Open terminal session](/power-automate/desktop-flows/actions-reference/terminalemulation) action with the HLLAPI provider in Power Automate for desktop.
+
+_Applies to:_   Power Automate for desktop
+
+## Symptoms
+
+When you try to use the **Open terminal session** action with the HLLAPI provider to connect to the IBM Personal Communications terminal emulator, you might receive the following error message:
+
+```output
+Exception of type 'Microsoft.Flow.RPA.Desktop.Modules.TerminalEmulation.Common.TerminalEmulationActionException' was thrown.: Microsoft.PowerPlatform.PowerAutomate.Desktop.Actions.SDK.ActionException: Error communicating with the emulator ---> Microsoft.Flow.RPA.Desktop.Modules.TerminalEmulation.Common.TerminalEmulationActionException: Exception of type 'Microsoft.Flow.RPA.Desktop.Modules.TerminalEmulation.Common.TerminalEmulationActionException' was thrown.
+   at Microsoft.Flow.RPA.Desktop.BridgeToHLLAPI.HLLAPIActionsImpl.<>c__DisplayClass16_0.<Open>b__0()
+   --- End of inner exception stack trace ---
+   at Microsoft.Flow.RPA.Desktop.Modules.TerminalEmulation.Actions.OpenTerminalSession.Execute(ActionContext context)
+   at Microsoft.Flow.RPA.Desktop.Robin.Engine.Execution.ActionRunner.Run(IActionStatement statement, Dictionary`2 inputArguments, Dictionary`2 outputArguments)
+```
+
+This issue can occur in the following desktop flow modes:
+
+- Unattended
+- Attended
+- Console/Designer
+
+## Cause
+
+The IBM Personal Communications terminal emulator requires access to HLLAPI DLLs for proper operation. However, the HLLAPI implementation in IBM Personal Communications version 14 (32-bit) might result in the error.
+
+## Resolution
+
+To resolve this issue, download and install the [64-bit version of IBM Personal Communications](https://www.ibm.com/docs/personal-communications) that includes the required HLLAPI DLLs. Ensure that you select the appropriate DLL file in the **Open terminal session** action.
+
+For more information, see [Terminal emulation actions](/power-automate/desktop-flows/actions-reference/terminalemulation).
+
+[!INCLUDE [Third-party disclaimer](../../../includes/third-party-disclaimer.md)]

support/power-platform/power-automate/toc.yml

@@ -114,6 +114,8 @@
       href: desktop-flows/application-certificate-error.md
     - name: Agent-related errors when running attended or unattended desktop flows
       href: desktop-flows/agent-connectivity-issues-pad.md
+    - name: Can't connect to an IBM Personal Communications session
+      href: desktop-flows/cannot-connect-to-ibm-personal-communications.md 
     - name: Can't silently join a machine group
       href: desktop-flows/silent-join-machine-group-troubleshoot.md
     - name: Can't create a connection from a shared canvas app