| Sun 3270 Pathway User's Guide |     |
| Sun 3270 Pathway User's Guide | |
| C H A P T E R 11 |
|
The Pathway Terminal |
This chapter describes the Pathway Terminal, a 3270 emulator. It contains the following topics:
The procedures in this section describe how to start the Pathway Terminal on various platforms.
On Solaris or UNIX systems, there are two ways to start the Pathway Terminal.
1. Ensure that the required level of JRE is on your path.
See Obtaining a Java Runtime Environment (JRE).
2. Run the pathway_terminal.sh shell script located in the bin directory of the product installation.
1. Ensure that the required level of JRE is on your path.
See Obtaining a Java Runtime Environment (JRE).
2. Run the executable JAR file located in the lib directory of the product installation.
Change to the lib directory and type the following command:
There are three ways to start the Pathway Terminal.
1. On the desktop, click the Start button.
2. Select Start 
Programs Sun 3270 Pathway 2.0.0 3270 Terminal.
Run the pathway_terminal.exe program located in the bin directory of the product installation.
1. Ensure that the required level of JRE is on your path.
See Obtaining a Java Runtime Environment (JRE).
2. Run the executable JAR file located in the lib directory of the product installation.
Change to the lib directory and type the following command:
With all of these methods, you can specify startup parameters. You can modify the properties of the Start button entry for the Pathway 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.
You can start the Pathway Terminal with a series of parameters. Supplying a URL or host and port causes the emulator to automatically attempt a connection to the specified host.
pathway_terminal [-h hostname [-p portnumber]] | [-u URL] [-m model] [-f font] [-n netname] [-t timeout-value] [-s print-style] [-c codepage] [-x] [-r [filename]]
The emulator window consists of three parts: the menu bar, the emulator itself, and a status bar.
The emulator's menu bar has five items: File, Edit, Settings, Advanced, and Help.
[ D ]
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.
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 the Pathway Terminal. See Command Line Parameters for information about the timeout startup parameter.
At the bottom of the emulator window is the status bar. See The Status Bar for a description of the sections of the status bar.
If you specify the -h hostname or -u URL parameters when starting the Pathway Terminal, 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 the Pathway Terminal using one of the methods described in Starting the Pathway Terminal.
The terminal emulator window is displayed.
2. Click File Connect to display the Connect dialog box.
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 must be 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 codepage for the Host Codepage field by using the drop-down menu.
The default is IBM-1047 (Open Edition). The supported codepages 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, the Pathway Terminal displays the screens correctly.
|
Note - The coerce option is available only on the Connect window. There is no equivalent command-line parameter. |
f. Check or deselect the Allow TN3270E check box, which allows the use of the TN3270E protocol when connecting to the remote system.
g. Optionally, 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 the Pathway Terminal fails to connect to the specified host. If you connect successfully, the first screen of the 3270 host is displayed.
Use the copy action to copy the current emulator display to the clipboard of your operating system. To paste the contents of the system clipboard to the Pathway Terminal, use the paste action. The emulator cursor must be in a field that permits keyboard input to perform a successful paste operation.
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.
A real 3270 emulator has a number of special keys, such as Clear, and Reset, that are not provided on the standard PC keyboard. The Pathway Terminal maps certain keys and key combinations to the actions of these special keys. For more information about cursor control, see Accessibility Features of the Pathway Terminal.
On the emulator window, select Help Key Mapping.
Edit the .pathway_terminal.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 .pathway_terminal.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 the Pathway Terminal.
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:
Do not assign the same keystroke for two actions. For example the following lines, which attempt to assign Ctrl-Z to backspace and to newline, will not work:
You cannot change the key map while the Pathway Terminal is running. You must stop the Pathway Terminal, edit the file, and restart the Pathway Terminal.
2. Delete the .pathway_terminal.keymap.properties file.
3. Restart the Pathway Terminal.
The .pathway_terminal.keymap.properties file is automatically recreated.
When you resize the Pathway Terminal, 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.
There is a dump function within Pathway Terminal to enable you to obtain diagnostic information about the current state of the terminal.
|
Note - This diagnostic information is primarily for the use of support personnel and is unlikely to be of direct interest to most users. |
The diagnostic dump command saves Pathway Terminal diagnostic information to a file. The file is saved to the directory from which the Pathway Terminal 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.
To use the Pathway Terminal in double-byte character set (DBCS) mode, choose one of the available DBCS codepages on the Connect window, or specify a DBCS codepage using the -c parameter of the pathway_terminal command.
When running in DBCS mode, each 3270 field is one of the following types:
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.
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.
|
Note - A character is considered double-byte if its representation in the selected host codepage is two bytes. |
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.
|
Note - This section applies to users on Microsoft Windows systems. |
You can configure some web browsers so that any links to TN3270 hosts are started with the Pathway Terminal. When you click on the link, the browser starts the Pathway Terminal and attempts to make a connection to the TN3270 system.
On your system, associate files of type URL:TN3270 Protocol with
pathway_terminal -u. You must have the Pathway Terminal in your path or you must specify the complete path name where the pathway_terminal executable is installed. Refer to Microsoft Windows Help for instructions on associating files.
The Pathway Terminal software contains accessibility features, which make it usable by assistive technologies. Using the Pathway Terminal with the Sun MTP software makes Sun MTP accessible by assistive technologies.
The accessibility features of the Pathway Terminal are:
Controls to set the color scheme, are located on the Settings menu. See FIGURE 11-2.
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.
The Java Access Bridge is required for an assistive technology to interact with a JVM. Before an assistive technology can be used with the Pathway Terminal, 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 3270 Pathway 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.
|
Note - DBCS and SOSI fields might not report the correct information when an assistive technology inquires about the fields' contents. |
| Sun 3270 Pathway User's Guide | 816-5340-11 | |
Copyright © 2003, Sun Microsystems, Inc. All rights reserved.
To Start the Pathway Terminal Using the Shell Script