Connecting to z/OS by using the Remote Connection Emulator
Many enterprises engaged in long-term mainframe application development have numerous tools, utilities, jobs, processes, and other best practices. The Remote Connection Emulator integrates traditional 3270 practices and tools into the Eclipse integrated development environment (IDE). It provides basic access to the mainframe for viewing unique information and other mainframe processes that are not available in the workbench. By using Remote Connection Emulator, you can connect to the remote system and open a full-screen emulator.
-
The default session type is telnet 3279. If you open a workspace that was created in an earlier version of the 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 Session Properties.
Before you start
Create a connection 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.
- Right-click and select Remote Connection Emulator.
- If this is your first time starting a session, the product prompts you to name it, such as rce-session-1. The product saves session settings in a file with extension .rces3270 in the RemoteConnectionEmulatorProjectFiles folder of the Eclipse workspace folder. You can also navigate to any location to save emulator session files.
- If you already have multiple session files, the product prompts you to choose a session to open.
- Log on to the remote system using your user ID and password.
- To maximize the session window size, double-click the top session tab or press Ctrl+M. To detach the session window from the editor area of the perspective, right-click the top session tab and select Detach.
- To open help for the main Remote Connection Emulator window and for the Session Properties, Keyboard Remap, and Terminal Styling slider windows, click the ? icon at the top or bottom of the window. The corresponding help topic opens in IBM® Documentation.
Cloning and splitting sessions
You can create and save multiple sessions by cloning and splitting active sessions.
- To clone a session, click the top tab of a session, and then select . The product prompts you to name the session file, for example, rce-session-2.
- To split a session, click the top tab of a session, and then select Toggle Split Editor (Vertical). The product prompts you to name the session file. or
The new sessions are independent of each other. Any changes you make to session settings, such as changing font colors, are saved in the session file. If you make changes to the settings of a session that you want to clone, save the session, then close and reopen it before cloning it. The saved settings are cloned to the new session.
Changing session settings
Use the toolbar icons to modify the connection or terminal emulator settings:
: Connect or disconnect from the remote system.
: Open the PF keyboard.
: Open a crosshair to track the cursor location.
- Linux, UNIX, and Windows: TCP/IP errors
- Windows: Windows Sockets Error Codes
- macOS and z/OS: Sockets return codes (ERRNOs)
: Set connection and security options for the session. You can also click the Host Properties tab to set session connection and security options. To learn more about these options, see Setting session properties.
: Change keyboard mappings for the session. To learn more about keyboard mappings, see Customizing the keyboard
: Change colors and fonts in the emulator. To learn more about these options, see Setting colors and fonts.
: Open the IBM Documentation for Remote Connection Emulator in an external browser window.
Copying, cutting, and pasting text
- Select an area of text.
- Press Ctrl+C or ⌘_C to copy, or Ctrl+X or ⌘+X to cut.
- Press Ctrl+V or ⌘+V to paste.
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.
- In the emulator, open the session settings and select Enable trace.
Limitations and troubleshooting
- To determine which browser the workbench is using, click .
- Expand the General folder, select Internal Web Browser, and then click Open.
- In the internal web browser address field, type https://www.whatismybrowser.com/, and then click .
- If the internal browser is Internet Explorer 11, do one of these options:
- Enable JavaScript by following the instructions at How to enable JavaScript in Windows.
- Override the default browser by following the instructions at Setting session properties.
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.
- If you cannot maximize the session window by double-clicking the top session tab, try pressing Ctrl+M.
- macOS:
When connecting to the host over a secure connection, you might see these issues on macOS:
- An exception might be written to the error log.
- If you configure the TLS session with a client certificate and password for the client
certificate, and then close and reopen the session, the connection fails. This failure to connect
occurs because the client certificate password is not retained in the Host Properties tab.To work around this issue:
- In the product Preferences window, navigate to .
- On the Password tab, clear the OS X Keystore Integration checkbox and click Save and Close.
- When prompted, enter a password and click Save.
- If you change settings in Session Properties, Keyboard Remap, or Terminal Styling, the certificate password is cleared and must be entered again.
Note: You must create and enter a master password for each secure session. If you shut down and restart a workspace that contains a secure Remote Connection Emulator connection, you are prompted to enter the master password again.
- Cloning and splitting sessions
-
- If you click Cancel during a cloning operation, the clone is created, but it is not named and saved.
- Changing session settings
-
- If you cannot see all of the fields in the sliding windows for Secondary Keyboard, Session Properties, Keyboard Remap, and Terminal Styling, maximize the Remote Connection Emulator window.
- macOS Keyboard Remap:
-
Remapping a key to eraseField, eraseInput, or insert might cause unexpected characters to be inserted in the entry field. To work around this limitation, remap these commands to the left ⌘ Command key or to any key on the secondary keyboard and use the secondary keyboard rather than the physical keyboard. Because the eraseInput and eraseField commands are already mapped to the secondary keyboard, you use secondary keys that are already defined for them.
- If you click the Clear key, enter text in the Remote Connection Emulator window, and then press Enter, the emulator session is disconnected.
-
- Copying, cutting, and pasting text
- On macOS, you can copy, cut, and paste text only within the Remote Connection Emulator window. You cannot paste text into the Remote Connection Emulator that was copied or cut from an external window or application, such as a text editor.
- ISPF sessions
- While using ISPF in the Remote Connection Emulator, you might experience these issues. This list
is not comprehensive.
- If the host sends an update to the client, the current input might be cleared.
- Resizing the Remote Connection Emulator session window can cause the lines that represent text entry fields to disappear or become disjointed. You can type into the entry fields even if the line is broken or not visible.
- When you type text in a command line, or press the space bar or backspace key to delete text from a command line, the text and fields might shift to the left or right.
- When you type text in a command line, the cursor does not always move to the correct location.
- Windows: In a multi-line input field, such as the ISPF Command Shell, if you press Backspace to delete the last character of a line, the cursor is not set to the correct position.
- Other issues and limitations
-
- 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.
- macOS: On macOS, entering a CICS command might disconnect your Remote Connection Emulator session. For some CICS commands, you can work around this issue by selecting New Line from the Secondary Keyboard.
- You might notice differences in terminal styling between Remote Connection Emulator and IBM Personal Communications: