Configuring the 3270 Emulator

3270 Emulator provides access to mainframe 3270 emulation mode from Eclipse. It is a port of the Open Source x3270 emulator.

To configure 3270 Emulator

1. From the Window menu, select Preferences. The Preferences dialog box appears.
2. Toggle open the BMC node and select 3270 Emulator. The 3270 Emulator page appears.
3. In the Hostname field, enter the z/OS host system name or IP address.
4. In the Port field, enter the port number to which Telnet is assigned to listen for client requests.
5. Select the Use SSL check box to have connections to the mainframe use a Secured Socket Layer, if desired. Note that a secure connection will be initiated regardless of this check box's setting if the user logs onto a host:port that supports it. Selecting this check box, however, quickens the connection process.
6. Select the Do not verify the host certificate check box to allow self-signed certificates, if desired. The hostname must match the name associated with the certificate.
7. From the Model list, select the model number of 3270 display to be emulated. The model number is in the format <model number> (<number of columns x number of rows>), for example 3 (80x32). The default model number is 3 (80x32).
8. From the Character set list, select the EBCDIC host character set to be used in the emulator.

9. If a different font is desired for viewing the emulator, in the Font box, click Change. The Font dialog box appears. Select the desired font attributes and click OK. The minimum font size can be changed by entering a size in the Minimal font size field.

   Important

   When viewing or editing datasets that have a mix of single- and double-byte characters, the Unifont font must be used. To use this font, first uninstall any previous versions of the font, then download the truetype version (.ttf) of Unifont from unifoundry.com and install it according to Microsoft's font installation documentation. Lastly, use the Preferences dialog box to change the font to be used by the 3270 Emulator according to the step above.

10. In the Color box, change the background color used in the emulator by clicking the Background Color box. The Color dialog box appears. Select the desired color and click OK.
11. In the Toggles box, select or clear the check boxes as desired:
    • Crosshair cursor - Select to display crosshairs (horizontal and vertical cursor ruler) in the emulator.
    • MonoCase - Select to have the emulator use uppercase; clear to use mixed case.
    • Blank Fill - Select to have the emulator change all nulls in a field to the left of a typed character to blanks and to treat trailing blanks in a field as nulls when using insert mode.
    • Paste with left margin - Set to have the emulator keep the left margin when pasting multi-line input, thus starting the paste at the cursor location.
    • Adapt font size to editor - Select to have the font size adjust to the editor window size when the editor window is resized. If this check box is cleared, the font size remains the same when the editor window is resized. This option has no affect if the selected font cannot be resized.
12. To use a custom keymap file that specifies actions to perform when a key or key sequence is pressed, in the Keymap file field, enter the full path and file name or browse to the keymap file.
13. Only set or change the Limit Host to Client file transfer size field at the direction of BMC Support.
14. Click OK. 3270 Emulator is now ready for use.