Skip to content

RDS Remote Application: Mocha TN5250 Terminal

Mocha TN5250 Terminal is a Windows-based client used to establish interactive terminal sessions with IBM i (AS/400) systems. When integrated with the 12Port Access Broker via Remote Desktop Services (RDS), Mocha TN5250 enables Zero Trust access to IBM i systems through a fully monitored and credential-injected session.


Installation and Configuration

1. Download Required Files
* Executable:
https://bin.12port.com/product/remote-apps/MochaTN5250/MochaTN5250.exe
* Configuration File (.ini):
https://bin.12port.com/product/remote-apps/MochaTN5250/MochaTN5250.ini

Source file: https://bin.12port.com/product/remote-apps/MochaTN5250/MochaTN5250.au3

* Place both the Executable (.exe) and Configuration (.ini) files in the same directory on the RDS Server where the Remote Application will be published. For example: C:\12Port-RDSApps.
* Install and Configure the Mocha TN5250 Terminal application on the RDS Host Server so it will open to the login screen for the destination server. This may need to be done manually on the RDS Host Server first, for each RDS user, before 12Port will be able to launch it properly.


2. Modify Configuration (Optional)
The .ini configuration file can be updated to define the executable path and suppress the trial dialog presented by the Mocha TN5250 client. Example configuration:

[app]
exe=C:\Program Files (x86)\MochaSoft\Mocha TN5250 for Vista\tn5250.exe
trial=true
* exe: Absolute path to the Mocha TN5250 executable on the RDS host.
* trial: If set to true, the client will bypass the trial screen on startup.


3. Publish the Remote Application
Use the following PowerShell command as an example to publish Mocha TN5250 as a RemoteApp on the RDS server. This command must be executed from an elevated (Administrator) PowerShell session:

New-RDRemoteApp `
  -CollectionName "QuickSessionCollection" `
  -Alias "MochaTN5250" `
  -DisplayName "MochaTN5250" `
  -FilePath "C:\12Port-RDSApps\MochaTN5250.exe" `
  -ShowInWebAccess $true `
  -CommandLineSetting "Allow"

Ensure the CommandLineSetting is set to "Allow" to enable the Access Broker to pass connection parameters to the application.

Note

Make sure the -FilePath value accurately reflects the location of the executable on the RDS server.


RDS Application Asset Configuration

To enable Zero Trust access to Mocha TN5250 via the 12Port Access Broker:

  • In the RDS Remote Application asset, set the Remote App field to:
    ||MochaTN5250
    
  • Set the Remote Arguments field to:

    User,Password
    

    • Specify User as a privileged account for zero trust access to the destination IBM i (AS/400) system.

    • Specify Password for the privileged account for zero trust access to the destination IBM i (AS/400) system.

Mocha TN5250 Terminal Client - Asset View

These values allow the Access Broker to inject credentials into the terminal session without exposing them to the user.

RDS Session - Mocha TN5250 Terminal Client