Connecting to z/OS by using the Remote Connection Emulator
Migration notes
- The session profile names might be changed. The Remote Connection Emulator creates profiles with
a default name that matches the connection name, but you can rename the profile:
- To open the profile, click
Edit profile.
- Expand the Connection information section and update the Profile name field.
- Save your changes and close the session.
- In the Remote Systems view, right-click the connection name and select Remote Connection Emulator. The new name is displayed in the list of profiles.
- To open the profile, click
- If session profile includes a key mapping to the paste command, that key mapping is not migrated. Keys can no longer be mapped to the paste command.
- For workspaces created on a macOS client, the certificate file for secure connection is not migrated. For more information about certificate files for secure connections on macOS, see Preparing a certificate file for secure connections from macOS.
The default session type is telnet 3279. If you use the 16.0.x or 17.0.x client to open a
workspace that was created by a 15.0.x client, and that workspace has an active Remote Connection
Emulator session, the Session type setting retains the value that was set in
the workspace. To change the session type, click
Edit profile, and expand the Connection information
section.
Before you start
Create a connection to a remote system. For instructions, see Creating a connection to a z/OS® system or watch the following demonstration.

Starting a host session
- In the Remote Systems view, select a z/OS system connection.
- If this is your first time starting a session and you have no profile, right-click and select
.json in the
RemoteConnectionEmulatorProjectFiles folder of the Eclipse workspace folder,
and opens the emulator window.
- If you already have at least one profile, you can either select it from the Remote
Connection Emulator menu or create another profile. If you select a profile, the product
opens the emulator window with the selected profile.Important: Because Remote Connection Emulator profiles are associated with specific connection names, renaming a remote system connection results in loss of the associated profiles. To reclaim lost profiles, restore the connection name.
- To connect to the remote system, click
Connect, and then log on to the remote system using your user ID and password.
- To maximize the session window size, double-click the session tab or click
Maximize. To detach the session window from the editor area of the perspective, right-click the emulator tab and select Detach. For more information about working with detached views, see Detaching views and editors.
- To open help for the Remote Connection Emulator window click
in the toolbar

Quick guide to emulator tools
Use the toolbar icons to interact with the terminal emulator, modify connection settings, and get help:
: Connect or disconnect from the remote
system.
: Open a crosshair to track the cursor location.
: Open the secondary keyboard. By default, the
keypad is opened on the left side of the emulator window. To move it to the bottom of the window,
edit the Display section of the session profile. For more information about
editing the profile, see Display
properties.
: Set connection, security, key mapping, terminal colors, and
screen type, size, font, and code page options for the session. To learn more about these options,
see Setting session properties.
: Open the IBM Documentation for Remote Connection
Emulator in an external browser window.

Copying, cutting, and pasting text
- Use the mouse or the Shift+arrow keys to select an area of text. Use the drag points to expand or contract the selection box. To move the selection box, place the cursor inside it, left-click, and drag the box to a new location.
- Press Ctrl+C or ⌘+C to copy, or Ctrl+X or ⌘+X to cut.
- Press Ctrl+V or ⌘+V to paste.

Splitting and cloning emulator sessions
- To split an emulator session window, click Edit profile page so that you can alter and save profile settings. or . These actions open a new emulator session in the same editor tab as the original session. The new session opens on the
- To clone an emulator session, click Edit profile page so that you can alter and save profile settings. . This action opens an emulator session in a new editor tab. The new session opens on the

Setting trace options for the Remote Connection Emulator
- In the Preferences window, click Tracing.
- In the Tracer Name list, select com.ibm.remote.connection.emulator.
- Set the tracing level to FINE or FINER. The FINEST level of tracing might generate too much data and is intended for use only in rare cases when extended traces are needed. During tracing, trace entries are produced and placed in the workspace\.metadata\.trace file.
Limitations and troubleshooting
- Click
and
to disconnect and reconnect.
- Close the Remote Connection Emulator session and restart it.

You might also see these issues and limitations with the emulator. This list is not comprehensive.
- Starting a host session
- If Remote Connection Emulator fails to start, you might need to configure a working directory for the S3270 executable file. Use the Remote Connection Emulator Preferences page to specify a working directory. For instructions, see Configuring a working directory.
- Creating and editing profiles
-
- If a profile is created and then the host connection name is changed, the profile might disappear.
- If a message window stating No more handles ... opens when you create a Remote Connection Emulator profile, restart your workspace and retry the operation.
-
If you configured the z/OS connection to use client certificates, and the profile page displays the message No certificate alias was found. when you try to select a client certificate, do these steps:
- Open the workbench Preferences window, and select Client Certificates.
- Clear the entry in the hostIdMappings object identifier (OID) field, and then click Apply and Close.
- Other issues and limitations
-
- A profile might become unusable if you change your network connection. This issue occurs in
these scenarios, and might occur in others as well:
- Connect to a profile over a wireless network connection. Disconnect. Try to reconnect through a VPN over a different wireless network connection.
- Connect through a VPN. Disconnect. Try to reconnect over a wireless hotspot.
- Connect through a VPN over one wireless network connection. Disconnect. Attempt to connect through the same VPN, but over a different wireless network connection.
- You might notice differences in terminal styling between Remote Connection Emulator and IBM® Personal Communications:
- The command line is yellow instead of red.
- In JCL the following characters are green instead of yellow: = ( )&
- In the ISPF editor, block selections are not highlighted.
- A profile might become unusable if you change your network connection. This issue occurs in
these scenarios, and might occur in others as well: