Sun MTP J3270 User's Guide

This chapter covers the following topics:

• Starting Sun MTP J3270
• Command Line Parameters
• 3270 Emulator Window
• Connecting to a 3270 System
• Copy and Paste
• Color Schemes
• Specifying Keyboard Mapping
• Resizing Sun MTP J3270
• Diagnostic Information
• Using Sun MTP J3270 in DBCS Mode
• Making an Association With an Internet Browser
• Accessibility Features of Sun MTP J3270

---

Starting Sun MTP J3270

This section describes how to start Sun MTP J3270 on various platforms.

1. Change to the bin directory of the Sun MTP J3270 installation, or verify that the bin directory is in your path.

2. Type the j3270 command with or without parameters.

See Command Line Parameters.

Use one of the following methods:

• On the Windows Start menu, select Start Programs Sun MTP J3270 8.0.0 3270 Terminal.
• Create a Windows shortcut to start the j3270.exe program.
• If you are in the Sun MTP J3270 bin directory or if the Sun MTP J3270 bin directory is in your path, type j3270.

With all of these methods, you can specify startup parameters. You can modify the properties of the Start button entry for the 3270 Terminal or the properties of a shortcut you created. At a command prompt, specify the options on the command line. Command Line Parameters describes these parameters.

---

Command Line Parameters

You can start Sun MTP J3270 with a set of parameters. Supplying a URL or host and port causes the emulator to automatically attempt a connection to the specified host.

Format

j3270 [-h hostname [-p portnumber]] | [-u URL] [-m model] [-f font]
[-n netname] [-t timeout-value] [-s print-style] [-c codepage] [-x]
[-r [filename]] [-C colorscheme-name]

---

3270 Emulator Window

The emulator window has three parts: the menu bar, the emulator itself, and a status bar.

 FIGURE 2-1 Disconnected Emulator

The Menu Bar

The emulator's menu bar has five items: File, Edit, Settings, Advanced, and Help.

 FIGURE 2-2 Menu Bar

The menu bar enables you to:

• Connect to a TN3270 system, if the emulator is in a disconnected state
• Disconnect from the currently connected system, if the emulator is in a connected state
• Print the current display
• Modify the selection to be used in copying to the system clipboard
• Copy the selection to the system clipboard
• Paste the contents of the system clipboard to the emulator
• Change the font of the display
• Change the color settings of the emulator
• Change the way that SO and SI markers are displayed when running in DBCS mode
• Capture diagnostic information
• Display the current keyboard mapping

The File menu also displays the last four systems the emulator connected to. When the emulator is disconnected, clicking on one of the systems causes the emulator to attempt to connect to it.

The Emulator

When the emulator is connected, it responds to keyboard input like a standard 3270 terminal. For information on how 3270 keys are mapped to keys on your keyboard, see Specifying Keyboard Mapping.

By default, the terminal does not automatically disconnect (timeout) from a system that it is connected to. If you want it to automatically timeout, you must specify a terminal timeout value when starting Sun MTP J3270. See Command Line Parameters for information about the timeout startup parameter.

The Status Bar

The status bar displays information about the terminal and is divided into sections.

 FIGURE 2-3 Status Bar

The labels in FIGURE 2-3 indicate each section of the status bar and are described in the following table:

---

Connecting to a 3270 System

If you specify the -h hostname or -u URL parameters when starting Sun MTP J3270, the emulator automatically attempts to connect to the specified host system. If you do not specify the -h or -u parameters, use the following procedure to connect to a host.

1. Start Sun MTP J3270 by selecting it on the Start menu or by typing j3270 at a command prompt.

The terminal emulator window is displayed.

2. Select File Connect to display the Connect window.

 FIGURE 2-4 Emulator Connect Window

3. Set the attributes by typing values in the following fields:

a. In the Host field, type the host name.

b. Type a port number in the Port field; the default is 2001.

This is the same as the port number specified as the TNServer*ListenPort in the unikixrc.cfg file.

c. Select a terminal type for the Terminal Type field using the drop-down menu; the default is 3278-2-E.

d. Select a code page for the Host Codepage field by using the drop-down menu.

The default is IBM-1047 (Open Edition). The supported code pages are listed in Command Line Parameters.

e. The Coerce EW to EWA field is enabled only for Terminal types 3278-3,
3278-3-E, 3278-4, 3278-4-E, 3278-5, and 3278-5-E.

Some TN3270 servers do not generate correct 3270 datastreams for these terminal types. When you check this box, Sun MTP J3270 displays the screens correctly.

f. Check or deselect the Allow TN3270E check box, which allows the use of the TN3270E protocol when connecting to the remote system.

g. Type a value in the Netname field.

If you checked Allow TN3270E, you can request a specific netname for the terminal.

4. Click Connect to start the connection process.

A message is displayed if Sun MTP J3270 fails to connect to the specified host. If you connect successfully, the first screen of the 3270 host is displayed.

---

Copy and Paste

The copy action puts data from the selected area on the emulator onto the system clipboard.

The paste action types data from the system clipboard onto the emulator, starting at the current cursor position. The clipboard is processed one line at a time. Processing starts at the current cursor position, with each new line starting at the cursor column on successive rows. For each line, the characters are typed into the emulator at sequential positions. If the character cannot be typed successfully, the character and the emulator position are skipped. When the right edge of the emulator is reached, the rest of the clipboard line is ignored.

By default, Ctrl-C can be used for the copy command and Ctrl-V for the paste command. These keystrokes can be remapped in the usual manner.

Selecting an Area to Copy

To copy data to the clipboard, you must first make a selection on the emulator. A selection is a rectangular portion of the screen.

You can control the selection in several ways:

• Press mouse button 1 on the emulator and drag the mouse to create a selection.
• Press mouse button 1 on one of the selection boundary markers and drag the mouse to modify the selection.
• Use the Edit Select All menu option to select the whole screen.
• Use the Edit Select None menu option to deselect any existing selection.
• Use the Edit Select Field menu option to select the field containing the cursor.
• There are accelerator keys that map to the menu operations, as well as for modifying the selection area:

Accelerator Key	Key Mapping	Action
Ctrl-G	ctrl.pressed.G=selectAll	Selects the entire screen.
Ctrl-N	ctrl.pressed.N=selectNone	Deselects any existing selection.
Ctrl-F	ctrl.pressed.F=selectField	Selects the field containing the cursor.
Shift-Right Arrow	shift.pressed.RIGHT=selectionRight	Expands or contracts the right side of the selection.
Shift-Left Arrow	shift.pressed.LEFT=selectionLeft	Expands or contracts the left side of the selection.
Shift-Up Arrow	shift.pressed.UP=selectionUp	Expands or contracts the top of the selection.
Shift-Down Arrow	shift.pressed.DOWN=selectionDown	Expands or contracts the bottom of the selection.

If you are a new user of Sun MTP J3270, these key mappings are automatically set. Otherwise, you might have to modify the .j3270.keymap.properties file to add them.

The selection on the emulator screen is automatically cleared when a 3270 AID key is pressed, or when the copy action is invoked.

---

Color Schemes

A color scheme is a definition of the colors used to display the 3270 terminal.

Three system-defined color schemes are always available.

Use one of the following methods:

• Start the emulator from the command line and use the -C colorscheme-name option.
• Select an appropriate color scheme using the menu option Settings Color Scheme.

User-Defined Color Schemes

A user-defined color scheme is a file with the name colorscheme-name.colorscheme.

You can use any of the color schemes in your colorschemes directory.

On Solaris or UNIX systems, the colorschemes directory is:

${HOME}/.j3270/colorschemes

On Windows systems, the colorschemes directory is:

C:\Documents And Settings\userid\.j3270\colorschemes

A sample user-defined color scheme is provided in the samples/colorschemes directory of the Sun MTP J3270 installation. To make the sample available, copy it to your colorschemes directory.

A color scheme file consists of a set of entries in the format key=value. In most cases, value is a hexadecimal number in the form 0xRRGGBB, where RR, GG, and BB are the red, green, and blue components of the desired color. Examine the sample color scheme for details of the meanings of the various entries.

Color schemes can also have an optional display name. This is the name used in the Sun MTP J3270 GUI. If a display name is not specified in the color scheme, the actual color scheme name is displayed in the GUI. It is the color scheme name and not this display name that is used with the -C option of the j3270 command.

---

Specifying Keyboard Mapping

A real 3270 emulator has a number of special keys, such as Clear and Reset, that are not provided on the standard PC keyboard. Sun MTP J3270 maps certain keys and key combinations to the actions of these special keys. You can also use key mapping to control cursor movement on the screen. For more information about cursor control, see Accessibility Features of Sun MTP J3270.

On the emulator window, select Help Key Mapping.

Edit the .j3270.keymap.properties file, which is located in your $HOME directory.

The following example shows some lines from this file:

pressed.BACK_SPACE=backspace

shift.pressed.TAB=backtab

pressed.ESCAPE=pressClear

pressed.ENTER=pressEnter

ctrl.pressed.ENTER=newline

Each line in the .j3270.keymap.properties file maps one or more keystrokes to an action. Be careful when editing this file and be sure the keystrokes and action names are correct. If any actions are specified incorrectly, error messages are displayed when you start Sun MTP J3270.

It is permissible to map multiple keys to one action. For example, to map Ctrl-Z and Shift-Enter to the newline action, type the following lines in the properties file:

CTRL.pressed.Z=newline

SHIFT.pressed.ENTER=newline

Do not assign the same keystroke for two actions. For example the following lines, which attempt to assign Ctrl-Z to backspace and newline, will not work:

CTRL.pressed.Z=backspace

CTRL.pressed.Z=newline

You cannot change the key map while Sun MTP J3270 is running. You must stop Sun MTP J3270, edit the file, and restart Sun MTP J3270.

1. Stop Sun MTP J3270.

2. Delete the .j3270.keymap.properties file.

3. Restart Sun MTP J3270.

The .j3270.keymap.properties file is automatically recreated.

---

Resizing Sun MTP J3270

When you resize Sun MTP J3270, it attempts to change the font size of the emulator, so that the emulator fits the specified size. This provides a simple way to make the emulator display more readable. However, it might result in an area smaller than the one you specified. If you are having difficulty achieving the results you want using this method, use the Settings Font option to specify a particular size.

---

Diagnostic Information

There is a dump function within Sun MTP J3270 to enable you to obtain diagnostic information about the current state of the terminal.

The diagnostic dump command saves Sun MTP J3270 diagnostic information to a file. The file is saved to the directory from which the Sun MTP J3270 was started. When you issue a dump, a message displays the file and directory name. The dump saves general information about the emulator, as well as the current screen. If tracing is turned on, the file will also contain the data flows from the emulator to the host and from the host to the emulator. The trace information is from the time tracing was started until the time the dump was taken.

---

Using Sun MTP J3270 in DBCS Mode

To use Sun MTP J3270 in double-byte character set (DBCS) mode, choose one of the available DBCS code pages on the Connect window, or specify a DBCS code page using the -c parameter of the j3270 command.

Available 3270 Field Types

When running in DBCS mode, each 3270 field is one of the following types:

• A pure single-byte field
• A pure double-byte field
• A mixed single- and double-byte field known as a SOSI (shift-out, shift-in) field

Restrictions on a Pure Single-Byte Field

A pure single-byte field can only contain single-byte characters. Any attempt to type a character into a pure single-byte field that is not a single-byte character results in a terminal alarm.

Restrictions on a Pure Double-Byte Field

A pure double-byte field can only contain double-byte characters. A double-byte character occupies two display positions and is twice the physical width of a single-byte character. Any attempt to type a character that is not a double-byte character into a pure double-byte field results in a terminal alarm.

Restrictions on Mixed (SOSI) Fields

A SOSI field can contain both single- and double-byte characters. You must enclose all double-byte characters in a SOSI field within a pair of SOSI characters.

• SO and SI characters each occupy a display position.
• By default, an SO character appears as a "less than" symbol, <.
• By default, an SI character appears as a "greater than" symbol, >.
• SO and SI characters are inserted automatically as a terminal user types. The terminal user does not have to enter them.
• Any keyboard entry operation that would leave DBCS characters outside an enclosing SOSI pair is invalid and is rejected with a terminal alarm; for example, deleting an SI character that would leave a DBCS character immediately adjacent to a single-byte character set (SBCS) character.
• An attempt to enter DBCS characters that does not leave room for the required SO and SI characters to be automatically inserted in the field is rejected with a terminal alarm; for example, typing a DBCS character in the last two display positions of a SOSI field.

The appearance of SO and SI symbols can be changed from the default to display either as blank characters, or as right and left pointing arrows, respectively. Use the menu option Settings SO and SI to make the change.

---

Making an Association With an Internet Browser

You can configure some web browsers so that any links to TN3270 hosts are started with Sun MTP J3270. When you click on the link, the browser starts Sun MTP J3270 and attempts to make a connection to the TN3270 system.

On your Windows system, associate files of type URL:TN3270 Protocol with
j3270 -u. You must have Sun MTP J3270 in your path or you must specify the complete path name where the j3270 executable is installed. Refer to Windows Help for instructions on associating files.

---

Accessibility Features of Sun MTP J3270

The Sun MTP J3270 software contains accessibility features, which make it usable by assistive technologies. Using the Sun MTP J3270 software with the Sun MTP software makes Sun MTP accessible by assistive technologies.

The accessibility features of Sun MTP J3270 are:

• Three color schemes:
• Standard: The emulator displays colored text.
• High contrast 1: The emulator text is white and the background is black.
• High contrast 2: The emulator text is black and the background is white.

Controls to set the color scheme, are located on the Settings menu. See FIGURE 2-2.

• Controls that move the cursor around the screen:
• Move to first field: Moves the cursor to the first character position of the first field of the screen
• Move to next field: Moves the cursor to the first character position of the next field relative to the field where the cursor is located
• Move to previous field: Moves the cursor to the first character position of the previous field relative to the field where the cursor is located

These controls accommodate those assistive technologies that require the cursor to be in a field for that field to be accessed.

These movement controls differ from the Home, Tab, and Backtab controls, which only move the cursor to editable fields. These movement controls move the cursor to all fields.

To view the current key mappings for these controls, follow the procedure in To View the Current Key Mapping. To define these movement controls, see To Change the Current Key Mapping.

• Support for the Java Accessibility API, which ensures that Sun MTP J3270 is accessible by assistive technologies that conform to the API. For example, a screen reader technology that conforms to the Java Accessibility API can read the contents of the emulator screen.

The Java Access Bridge is required for an assistive technology to interact with a JVM. Before an assistive technology can be used with the Sun MTP J3270 emulator, the Java Access Bridge must be installed into the JVM that is to be used to run the emulator. Note that the Windows version of Sun MTP J3270 is distributed with its own JVM, which is used to run the emulator. You must ensure that this JVM has the Java Access Bridge applied to it to enable assistive technologies.

The Java Access Bridge can be obtained from:

http://java.sun.com/products/accessbridge

For instructions on how to install the Java Access Bridge, refer to its documentation.

Sun MTP J3270 User's Guide

816-5339-13

Copyright © 2004, Sun Microsystems, Inc. All rights reserved.