x3270(1) x3270(1)
31 December 2001
NAME
x3270 - IBM host access tool
SYNOPSIS
x3270 [options] [host]
DESCRIPTION
x3270 opens a telnet connection to an IBM host in an X window. It
implements RFCs 2355 (TN3270E), 1576 (TN3270) and 1646 (LU name
selection), and supports IND$FILE file transfer. The window created
by x3270 can use its own font for displaying characters, so it is a
fairly accurate representation of an IBM 3278 or 3279. It is similar
to tn3270(1) except that it is X-based, not curses-based. The full
syntax for host is:
[prefix:]...[LUname@]hostname[:port]
Prepending a p: onto hostname causes the connection to go through the
telnet-passthru service rather than directly to the host. See
PASSTHRU below. Prepending an s: onto hostname removes the "extended
data stream" option reported to the host. See -tn below for further
information. Prepending an n: onto hostname turns off TN3270E support
for the session. A specific LU name to use may be specified by
prepending it to the hostname with an `@'. Multiple LU names to try
can be separated by commas. An empty LU can be placed in the list
with an extra comma. On systems that support the forkpty library
call, the hostname may be replaced with -e and a command string. This
will cause x3270 to connect to a local child process, such as a shell.
The port to connect to defaults to telnet. This can be overridden
with the -port option, or by appending a port to the hostname with a
colon `:'. (For compatability with previous versions of x3270 and
with tn3270(1), the port may also be specified as a second, separate
argument.)
OPTIONS
x3270 is a toolkit based program, so it understands standard Xt
options and resources. It also understands the following options:
-activeicon
Specifies that the icon should be a miniature version of the
screen image. See ICONS below.
-apl Sets up APL mode. This is actually an abbreviation for several
options. See APL SUPPORT below.
-cc range:value[,...]
Sets character classes. See CHARACTER CLASSES, below.
-charset name
Specifies an EBCDIC host character set. See CHARACTER SETS
below.
- 1 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
-clear toggle
Sets the initial value of toggle to false. The list of toggle
names is under MENUS below.
-efont name
Specifies a font for the emulator window. See FONTS below.
-iconname name
Specifies an alternate title for the program icon.
-iconx x
Specifies the initial x coordinate for the program icon.
-icony y
Specifies the initial y coordinate for the program icon.
-keymap name
Specifies a keymap name and optional modifiers. See KEYMAPS
below.
-keypad
Turns on the keypad as soon as x3270 starts.
-model name
The model of 3270 display to be emulated. The model name is in
three parts, any of which may be omitted:
The first part is the base model, which is either 3278 or 3279.
3278 specifies a monochrome 3270 display; 3279 specifies a color
3270 display. When 3278 emulation is specified for a color X
display, fields are displayed using pseudo-colors; see PSEUDO-
COLOR below.
The second part is the model number, which specifies the number
of rows and columns. Model 4 is the default.
center; c c c . T{ Model Number T} T{ Columns T} T{ Rows T} _ T{
2 T} T{ 80 T} T{ 24 T} T{ 3 T} T{ 80 T} T{ 30 T} T{ 4 T} T{
80 T} T{ 43 T} T{ 5 T} T{ 132 T} T{ 27 T}
Note: Technically, there is no such 3270 display as a 3279-4 or
3279-5, but most hosts seem to work with them anyway.
The third part specifies the Extended 3270 Data Stream, and is
given as -E. It signals the host that the 3270 display is
capable of displaying extended field attributes, and supports
structured fields and query replies. A 3279 always uses the
Extended Data Stream (whether or not -E is specified); for a 3278
it is optional.
- 2 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
The default model for a color X display is 3279-4-E. For a
monochrome X display, it is 3278-4-E. (The behavior of previous
versions of x3270 on color X displays can be specified as
3278-4).
-mono
Forces x3270 to believe it is running on a monochrome X display.
-once
Causes x3270 to exit after a host disconnects. This option has
effect only if a hostname is specified on the command line.
-oversize colsxrows
Makes the screen larger than the default for the chosen model
number. This option has effect only in combination with extended
data stream support (the -E suffix on the model), and only if the
host supports the Query Reply structured field. The number of
columns multiplied by the number of rows must not exceed 16383
(3fff hex), the limit of 14-bit 3270 buffer addressing.
-port n
Specifies a different TCP port to connect to. n can be a name
from /etc/services like telnet, or a number. This option changes
the default port number used for all connections. (The
positional parameter affects only the initial connection.)
-reconnect
Causes x3270 to automatically reconnect to the host if it ever
disconnects. This option has effect only if a hostname is
specified on the command line.
-sb Turns on the scrollbar.
+sb Turns the scrollbar off.
-scheme name
Specifes a color scheme to use in 3279 mode. This option has
effect only in combination with 3279 emulation. See COLOR
SCHEMES below.
-script
Causes x3270 to read commands from standard input, with the
results written to standard output. The protocol for these
commands is documented in x3270-script(1).
-sl n
Specifies that n lines should be saved for scrolling back. The
default is 64.
-set toggle
Sets the initial value of toggle to true. The list of toggle
- 3 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
names is under MENUS below.
-tn name
Specifies the terminal name to be transmitted over the telnet
connection. The default name is IBM-model_name, for example,
IBM-3279-4-E for a color X display, or IBM-3278-4-E for a
monochrome X display.
Some hosts are confused by the -E suffix on the terminal name,
and will ignore the extra screen area on models 3, 4 and 5.
Prepending an :s on the hostname removes the -E from the terminal
name when connecting to such hosts.
The name can also be specified with the "x3270.termName"
resource.
-trace
Turns on data stream tracing at startup. Unlike turning it on
from a menu option, there is no pop-up to confirm the file name,
which defaults to /tmp/x3trc.process_id.
-tracefile file
Specifies a file to save data stream and event traces into,
overriding the default of /tmp/x3trc.process_id. If the value
stdout is given, then traces will be written to standard output.
If the value none is given, then traces will be piped directly to
the monitor window, and no file will be created.
-tracefilesize size
Places a limit on the size of a trace file. If this option is
not specified, or is specified as 0 or none, the trace file will
be unlimited. If specified, the trace file cannot already exist,
and the (silently enforced) minimum size is 64 Kbytes. The value
of size can have a K or M suffix, indicating kilobytes or
megabytes respectively. After reading resource definitions from
the X server and any standandard X11 resource definition files
($HOME/.Xdefaults, etc.), x3270 will read definitions from the
file $HOME/.x3270pro. This file contains local customizations
and is also used to save changed options by the Save Changed
Options in File menu option. Note that -xrm options override any
definitions in the .x3270pro file.
FONTS
x3270 does not use the "*font" resource for its main window. Instead,
it uses a custom 14-point font called 3270, which is a close
approximation of a real 3270 display and allows x3270 to display the
ISO 8859-1 (Latin-1) character set and special status-line symbols. A
more compact font, 3270-12, is also supported, as are the various
sized fonts 3270gt8, 3270gt12, 3270gt16, 3270-20, 3270gt24, and
3270gt32. The fonts 3270h and 3270gr are also included to allow
display of Hebrew and Greek text, respectively. The font may be
- 4 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
specified with the -efont option or the "x3270.emulatorFont" resource.
x3270 can also use any X11 font that implements the display character
set required by the host EBCDIC character set.
An additional font, 3270d, is supplied. This font is identical to the
default 3270 font, except that it has bitmaps defined for field
attribute characters. This means that field attributes, which are
normally displayed as blanks, are now visible on the screen. The
characters displayed are hexadecimal codes, which can be translated
using a document provided with the x3270 sources. The font can be
changed at any time through a menu option. It can also be implicitly
changed by changing the size of the x3270 window with the mouse: if
the window is made larger, x3270 will try to change to a larger font,
and vice-versa.
CHARACTER SETS
The -charset option or the "x3270.charset" resource controls the
EBCDIC host character set used by x3270. Available sets include:
center; l l l lfB l l. T{ Charset Name T} T{ Code Page T} T{
Display Character Sets T} _ T{ apl T} T{ 37 T} T{ 3270cg-1a T} T{
belgian T} T{ 500 T} T{ 3270cg-1a 3270-cg1 iso8859-1 T} T{ bracket
T} T{ 37 T} T{ 3270cg-1a 3270-cg1 iso8859-1 T} T{ brazilian
T} T{ 275 T} T{ 3270cg-1a 3270-cg1 iso8859-1 T} T{ finnish T} T{
278 T} T{ 3270cg-1a 3270-cg1 iso8859-1 T} T{ french T} T{ 297
T} T{ 3270cg-1a 3270-cg1 iso8859-1 T} T{ german T} T{ 273 T} T{
3270cg-1a 3270-cg1 iso8859-1 T} T{ greek T} T{ 423 T} T{ 3270cg-7
T} T{ hebrew T} T{ 424 T} T{ 3270cg-8 T} T{ icelandic T} T{ 871
T} T{ 3270cg-1a 3270-cg1 iso8859-1 T} T{ iso-hebrew T} T{ 424
T} T{ iso8859-8 T} T{ iso-turkish T} T{ 1026 T} T{ iso8859-9 T}
T{ italian T} T{ 280 T} T{ 3270cg-1a 3270-cg1 iso8859-1 T} T{
norwegian T} T{ 277 T} T{ 3270cg-1a 3270-cg1 iso8859-1 T} T{
russian T} T{ 880 T} T{ koi8-r T} T{ solvenian T} T{ 870 T} T{
iso8859-2 T} T{ thai T} T{ 838 T} T{ iso8859-11 tis620.2529-0 T}
T{ uk T} T{ 285 T} T{ 3270cg-1a 3270-cg1 iso8859-1 T} T{ us-intl
T} T{ 37 T} T{ 3270cg-1a 3270-cg1 iso8859-1 T}
The default character set is bracket, which is useful for common IBM
hosts which use EBCDIC codes 0xAD and 0xBD for the `[' and `]'
characters, respectively.
Most 3270 fonts implement the 3270cg-1 display character set, which is
a reordered version of the ISO 8859-1 character set. Some implement
the 3270cg-1a display character set, which is a superset of 3270cg-1
that includes APL2 characters. 3270h and 3270gr implement special
character sets for Hebrew and Greek, respectively.
You can also specify national-language translations for your keyboard;
see KEYMAPS below.
- 5 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
CHARACTER CLASSES
x3270 supports character classes (groupings of characters chosen with
a double mouse click) in the same manner as xterm(1). The
"x3270.charClass" resource or the -cc option can be used to alter the
character class table. The default table is the same as xterm's; It
groups letters together, and puts most punctuation characters in
individual classes. To put all non-whitespace characters together in
the same class (and duplicate the behavior of some early versions of
x3270, use the following value:
33-127:48,161-255:48
See xterm(1) for further syntax details.
KEYPAD
A keypad may optionally be displayed, with a mouse-clickable button
for each 3270 function key (these functions are also available from
the keyboard). The keypad can be turned on and off by clicking on the
"keypad" button in the upper-right-hand corner of the window. The
"x3270.keypad" resource controls where it is displayed. Options are:
center; l l. T{ left T} T{ in a separate window, to the left of the
screen T} T{ right T} T{ in a separate window, to the right of the
screen T} T{ bottom T} T{ in a separate window, below the screen T}
T{ integral T} T{ in the same window as the screen, below it T}
The default is right.
If the "x3270.keypadOn" resource is set to true, the keypad will be
displayed at startup.
HOSTS DATABASE
x3270 uses the ibm_hosts database to construct a pull-down menu of
hosts to connect to. It also allows host name aliases to be defined,
as well as specifying macros to be executed when a connection is first
made. See ibm_hosts(5) for details. You may specify a different
ibm_hosts database with the "x3270.hostsFile" resource.
COLOR SCHEMES
When emulating a 3279 display, the X colors used to draw the display
are selected by two resources: the "x3270.colorScheme" resource, which
gives the name of the color scheme to use, and the individual
"x3270.colorScheme.xxx" resources, which give the actual definitions.
The color scheme resources are documented in the Resources file with
the x3270 source. The color scheme may also be changed while x3270 is
running with a selection from the Options menu.
PSEUDO-COLOR
When emulating a 3278 display on a color X display, x3270 does not
understand IBM 3270 color protocols. Instead, it draws text in one of
three colors depending on the field attributes. Those colors may be
- 6 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
customized using the following resources (shown with their default
values):
x3270.normalColor: green
x3270.boldColor: cyan
x3270.inputColor: orange
x3270.colorBackground: black
x3270.selectBackground: dim gray
NVT (ANSI) MODE
Some hosts use an ASCII front-end to do initial login negotiation,
then later switch to 3270 mode. x3270 will emulate an ANSI X.64
terminal until the host places it in 3270 mode (telnet BINARY and SEND
EOR modes, or TN3270E mode negotiation). The emulation is fairly
complete; however, it is not intended to make x3270 a replacement for
xterm(1).
If the host later negotiates to stop functioning in 3270 mode, x3270
will return to ANSI emulation.
In NVT mode, x3270 supports both character-at-a-time mode and line
mode operation. You may select the mode with a menu option. When in
line mode, the special characters and operational characteristics are
defined by resources:
center; l c c. T{ Mode/Character T} T{ Resource T} T{ Default T}
_ T{ Translate CR to NL T} T{ x3270.icrnl T} T{ true T} T{
Translate NL to CR T} T{ x3270.inlcr T} T{ false T} T{ Erase
previous character T} T{ x3270.erase T} T{ ^? T} T{ Erase entire
line T} T{ x3270.kill T} T{ ^U T} T{ Erase previous word T} T{
x3270.werase T} T{ ^W T} T{ Redisplay line T} T{ x3270.rprnt
T} T{ ^R T} T{ Ignore special meaning of next character T} T{
x3270.lnext T} T{ ^V T} T{ Interrupt T} T{ x3270.intr T} T{ ^C
T} T{ Quit T} T{ x3270.quit T} T{ ^\ T} T{ End of file T} T{
x3270.eof T} T{ ^D T} Separate keymaps can be defined for use only
when x3270 is in 3270 mode or NVT mode. See KEYMAPS for details.
MENUS
x3270 has a menu bar with three pull-down menus (File, Options, and
Connect) and a button to turn the keypad on and off. The pull-down
menus are also available as pop-up menus by using the "Ctrl" key and
the left, middle and right mouse buttons, respectively.
The menu bar can be turned off by setting the "x3270.menuBar" resource
to false.
Many sections of the File and Options menus are toggles, options that
may be either on or off. The entries under the File menu are as
follows:
File Transfer
Initiates transferring a file between the IBM host and the local
- 7 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
workstation, using the IND$FILE protocol. A pop-up menu allows
specifying the file names and other attributes of the transfer.
The IND$FILE program must be installed on the IBM host, and the
3270 cursor must be located in a field that will accept a TSO or
VM/CMS command.
Printer Session
Starts or stops a printer session.
Trace Data Stream
If set, network traffic (both a hexadecimal representation and
its interpretation) are logged to the file /tmp/x3trc.process_id,
and a window is popped up to monitor the data. The file name is
confirmed with a pop-up; the default directory name for the trace
file can be changed with the "x3270.traceDir" resource.
Trace Keyboard/Mouse Events
If set, information about keyboard and mouse events and the
actions that x3270 takes in response are logged to a file. This
is the same file as used for tracing the data stream, above.
Event tracing is useful for creating and debugging custom
keymaps, macros and scripts. For example, it will tell you
precisely what action was taken in response to pressing a
particular key. If the key is not mapped, it will tell you the
keysym name and keycode so you can add it to a custom keymap.
Save Screen(s) in File
If set, saves an ASCII representation of the current screen image
in the file /tmp/x3scr.process_id. A pop-up allows the file name
to be changed; the default directory name can be changed with the
"x3270.traceDir" resource. The pop-up also has buttons to choose
between saving just the current image, or continuously saving it
as it is redrawn.
Save Changed Options in File
Saves into a file the values of all options that have been
changed since x3270 was started. A pop-up allows the file name
to be changed; the default file is .x3270pro in the user's home
directory. If the file already exists, it is appended to. x3270
will read the contents of this file the next time it starts up.
The options settings in the file override any resources defined
with xrdb or in the user's .Xdefaults file; command-line switches
override the file. A different options file can be specified by
the X3270PRO environment variable. If the environment variable
NOX3270PRO is set, no options file will be read.
Execute an Action
Allows an action name and parameters to be entered from the
keyboard. This allows experimentation with actions without
having to edit keymaps and repeatedly restart x3270. The toggles
under the Options menu are as follows:
- 8 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
Monocase
If set, x3270 operates in uppercase-only mode.
Blinking Cursor
If set, the cursor blinks once per second.
Blank Fill
If set, x3270 behaves in some un-3270-like ways. First, when a
character is typed into a field, all nulls in the field to the
left of that character are changed to blanks. This eliminates a
common 3270 data-entry surprise. Second, in insert mode,
trailing blanks in a field are treated like nulls, eliminating
the annoying `lock-up' that often occurs when inserting into an
field with (apparent) space at the end.
Show Timing
If set, the time taken by the host to process an AID is displayed
on the status line.
Track Cursor
If set, the cursor position is displayed on the status line.
Scrollbar
If set, the scrollbar appears.
Wraparound
If set, the ANSI terminal emulator automatically assumes a
NEWLINE character when it reaches the end of a line.
Paste with Left Margin
If set, puts restrictions on how pasted text is placed on the
screen. The position of the cursor at the time the paste
operation is begun is used as a left margin. No pasted text will
fill any area of the screen to the left of that position. This
option is useful for pasting into certain IBM editors that use
the left side of the screen for control information.
Select by Rectangles
If set, x3270 will always select rectangular areas of the screen.
Otherwise, x3270 selects by rectangles when in 3270 mode, but in
ANSI mode it selects continuous regions of the screen like
xterm(1). The names of the toggles for use with the -set and
-clear options are as follows: center; l l . T{ Menu Option
T} T{ Name T} _ T{ Monocase T} T{ monoCase T} T{ Blinking
Cursor T} T{ cursorBlink T} T{ Blank Fill T} T{ blankFill T}
T{ Show Timing T} T{ showTiming T} T{ Track Cursor T} T{
cursorPos T} T{ Trace Data Stream T} T{ dsTrace T} T{ Trace
Keyboard/Mouse Events T} T{ eventTrace T} T{ Save Screen(s) in
File T} T{ screenTrace T} T{ Scrollbar T} T{ scrollBar T} T{
Wraparound T} T{ lineWrap T} T{ Paste with Left Margin T} T{
marginedPaste T} T{ Select by Rectangles T} T{ rectangleSelect
- 9 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
T} In addition, the toggle altCursor can be used to select the
cursor type. If set, an underline cursor will be used. If
clear, the normal block cursor will be used. These names also
represent resources that can be set in your .Xdefaults file. For
example, if you always want to have the scrollbar on, you can add
the following to your .Xdefaults:
x3270.scrollBar: true
STATUS LINE
The x3270 status line contains a variety of information. From left to
right, the fields are:
comm status
Three symbols indicate the state of the connection to the host.
If connected, the right-hand symbol is a solid box; if not, it is
a question mark.
keyboard lock
If the keyboard is locked, an "X" symbol and a message field
indicate the reason for the keyboard lock.
shift
Three characters indicate the keyboard modifier status. "M"
indicates the Meta key, "A" the Alt key, and an up-arrow or "^"
indicates the Shift key.
compose
The letter "C" indicates that a composite character is in
progress. If another symbol follows the "C", it is the first
character of the composite.
typeahead
The letter "T" indicates that one or more keystrokes are in the
typeahead buffer.
temporary keymap
The letter "K" indicates that a temporary keymap is in effect.
reverse
The letter "R" indicates that the keyboard is in reverse field
entry mode.
insert mode
A thick caret "^" or the letter "I" indicates that the keyboard
is in insert mode.
timing
A clock symbol and a time in seconds indicate the time it took to
process the last AID or the time to connect to a host. This
display is optional.
- 10 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
cursor position
The cursor row and column are optionally displayed, separated by
a "/".
ICONS
If the -activeicon option is given (or the "x3270.activeIcon" resource
is set to true), x3270 will attempt to make its icon a miniature
version of the current screen image. This function is highly
dependent on your window manager:
mwm The size of the icon is limited by the "Mwm.iconImageMaximum"
resource, which defaults to 50x50. The image will be clipped at
the bottom and right. The icon cannot accept keyboard input.
olwm The full screen image of all 3270 models can be displayed on the
icon. However, the icon cannot be resized, so if the model is
later changed with an x3270 menu option, the icon image will be
corrupted. The icon cannot accept keyboard input.
twm and tvtwm
The full screen image of all 3270 models can be displayed on the
icon, and the icon can be resized. The icon can accept keyboard
input.
However, twm does not put labels on application-supplied icon
windows. You can have x3270 add its own label to the icon by
setting the "x3270.labelIcon" resource to true. The default font
for icon labels is 8x13; you may change it with the
"x3270.iconLabelFont" resource.
KEYMAPS
The type of keyboard may be specified with the -keymap switch or using
either the KEYMAP or KEYBD environment variables. The types of
supported keyboards include sun_k3, sun_k4, sun_k5, hp-k1, hp-pc and
ncd.
The keymap may also be specified as a comma-separated list of names.
Later definitions override earlier ones. This is used to specify both
a primary keyboard type and a set of modifiers. The modifiers defined
include:
ow (OpenWindows) Swaps the middle and right mouse button
definitions, so the middle button performs the "Extend" function
and the right-hand button performs the "Paste" function. Also
changes the cut and paste actions to use the OpenWindows
CLIPBOARD.
alt Replaces the default "Meta" key definitions with "Alt"
definitions, for keyboards which do not have a "Meta" key.
- 11 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
apl Allows entry of APL characters (see APL SUPPORT below).
finnish7
Replaces the bracket, brace and bar keys with common Finnish
characters.
norwegian7
Replaces the bracket, brace and bar keys with common Norwegian
characters.
A temporary keymap can also be specified while x3270 is running with
the Keymap action. When the action Keymap(n) is executed, temporary
keymap n is added to or deleted from the current keymap. Multiple
temporary keymaps can be active simultaneously. The action
Keymap(None) restores the original keymap. Note: When Keymap() is
specified as part of a list of multiple actions in a keymap, it must
be the last action in the list.
The temporary keymap hebrew is provided to allow entry of Hebrew
characters.
The X Toolkit translation mechanism is used to provide keyboard
emulation. It maps events into actions. The best documentation can
be found with X toolkit documents, but the following should suffice
for simple customization.
An Xt event consists of (at least) four fields. The first is called a
modifier. It may be any combination of Meta, Shift and Ctrl. If it
is prefaced by !, it means those modifiers only. The second field is
the specific event, in x3270 usually just <Key>. The third field is
the detail field, which gives the actual key. The name of the key may
be determined using the xev program or with the "Trace X Events" menu
option. The last field is the action, which is the internal emulator
function. A complete list of actions may be found later in the
manual.
There are three levels of translation tables in x3270. The first is a
defined by the resource x3270.keymap.base. It defines alphabetic,
numeric, function keys, and such basic functions as Enter and Delete.
It allows a minimal useful functionality. It is generally compiled in
x3270, but can be overridden.
The second level is a keyboard specific table, which is selected by
the x3270.keymap resource, and defined by the x3270.keymap.name
resource (where name is the value of the x3270.keymap resource). This
keymap defines actions for such things as keypad keys, and keys unique
to certain keyboards. Several predefined keymaps are included with
x3270.
The third level is a user customizable table which may be used to
augment or override key definitions. This keymap is defined by the
- 12 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
x3270.keymap.name.user resource.
In addition, keymaps may be defined for use in 3270 mode or NVT mode
only. These keymaps use the suffixes .3270 and .nvt in their names,
respectively. If a keymap x3270.keymap.name.mode is defined, it will
augment the keymap x3270.keymap.name when x3270 is in the given mode.
If a keymap x3270.keymap.name.user.mode is defined, it will augment
the keymap x3270.keymap.name.user when x3270 is in the given mode.
The default translation table x3270.keymap.base is: l l . T{
<Key>Multi_key T} T{ Compose() T} T{ Shift<Key>Left T} T{
KybdSelect(Left,PRIMARY) T} T{ <Key>Left T} T{ Left() T} T{
Meta<Key>Right T} T{ NextWord() T} T{ Shift<Key>Right T} T{
KybdSelect(Right,PRIMARY) T} T{ <Key>Right T} T{ Right() T} T{
Shift<Key>Up T} T{ KybdSelect(Up,PRIMARY) T} T{ <Key>Up T} T{ Up()
T} T{ Shift<Key>Down T} T{ KybdSelect(Down,PRIMARY) T} T{ <Key>Down
T} T{ Down() T} T{ Ctrl<Btn1Down> T} T{ HandleMenu(quitMenu) T} T{
Ctrl<Btn2Down> T} T{ HandleMenu(optionsMenu) T} T{ Ctrl<Btn3Down>
T} T{ HandleMenu(hostMenu) T} T{ Shift<Btn1Down> T} T{
MoveCursor() T} T{ <Btn1Down> T} T{ select-start() T} T{
<Btn1Motion> T} T{ select-extend() T} T{ <Btn2Down> T} T{ ignore()
T} T{ <Btn2Motion> T} T{ ignore() T} T{ <Btn2Up> T} T{
insert-selection(PRIMARY) T} T{ <Btn3Down> T} T{ start-extend() T}
T{ <Btn3Motion> T} T{ select-extend() T} T{ <BtnUp> T} T{
select-end(PRIMARY) T} T{ Meta<Key>F1 T} T{ PF(13) T} T{ Meta<Key>F2
T} T{ PF(14) T} T{ Meta<Key>F3 T} T{ PF(15) T} T{ Meta<Key>F4
T} T{ PF(16) T} T{ Meta<Key>F5 T} T{ PF(17) T} T{ Meta<Key>F6
T} T{ PF(18) T} T{ Meta<Key>F7 T} T{ PF(19) T} T{ Meta<Key>F8
T} T{ PF(20) T} T{ Meta<Key>F9 T} T{ PF(21) T} T{ Meta<Key>F10
T} T{ PF(22) T} T{ Meta<Key>F11 T} T{ PF(23) T} T{ Meta<Key>F12
T} T{ PF(24) T} T{ <Key>F1 T} T{ PF(1) T} T{ <Key>F2 T} T{ PF(2)
T} T{ <Key>F3 T} T{ PF(3) T} T{ <Key>F4 T} T{ PF(4) T} T{ <Key>F5
T} T{ PF(5) T} T{ <Key>F6 T} T{ PF(6) T} T{ <Key>F7 T} T{ PF(7)
T} T{ <Key>F8 T} T{ PF(8) T} T{ <Key>F9 T} T{ PF(9) T} T{ <Key>F10
T} T{ PF(10) T} T{ <Key>F11 T} T{ PF(11) T} T{ <Key>F12 T} T{
PF(12) T} T{ Alt<Key>q T} T{ Quit() T} T{ :<Key> T} T{ Default()
T}
The default 3270-mode table x3270.keymap.base.3270 adds the following
definitions: l l . T{ Shift<Key>Return T} T{ Newline() T} T{
<Key>Return T} T{ Enter() T} T{ <Key>Linefeed T} T{ Newline() T}
T{ Shift<Key>Tab T} T{ BackTab() T} T{ <Key>Tab T} T{ Tab() T} T{
<Key>Home T} T{ Home() T} T{ Meta<Key>Left T} T{ PreviousWord() T}
T{ Meta<Key>Right T} T{ NextWord() T} T{ <Key>Insert T} T{
Insert() T} T{ <Key>Delete T} T{ Delete() T} T{ <Key>BackSpace
T} T{ BackSpace() T} T{ Ctrl Shift<Btn1Down> T} T{ MouseSelect()
T} T{ Shift<Btn1Down> T} T{ MoveCursor() T} T{ Meta<Key>1 T} T{
PA(1) T} T{ Meta<Key>2 T} T{ PA(2) T} T{ Meta<Key>3 T} T{ PA(3) T}
T{ Meta<Key>a T} T{ Attn() T} T{ Meta<Key>b T} T{ PrintWindow() T}
T{ Meta<Key>c T} T{ Clear() T} T{ Meta<Key>d T} T{ Delete() T} T{
Meta<Key>h T} T{ Home() T} T{ Meta<Key>i T} T{ Insert() T} T{
- 13 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
Meta<Key>l T} T{ Redraw() T} T{ Meta<Key>p T} T{ PrintText() T} T{
Meta<Key>r T} T{ Reset() T} T{ Meta<Key>u T} T{ Unselect() T} T{
Ctrl<Key>u T} T{ DeleteField() T} T{ Ctrl<Key>w T} T{ DeleteWord()
T} T{ :Meta<Key>asciicircum T} T{ Key(notsign) T}
Meta is the diamond shaped key on a sun_k4, "Alt" on an NCD, "Extend
Char" on an HP. The following xmodmap command must be used on the NCD
to allow use the the "Alt" key:
xmodmap -e "keysym Alt_L = Meta_L"
The left mouse button may be used to make a selection. Clicking once
unselects the current selection. Clicking twice selects the word
under the mouse cursor. Clicking three times selects the line under
the mouse cursor. Clicking and dragging selects a rectangular area of
the display.
The middle mouse button may be used to paste a selection.
The right mouse button may also be used for selections, selecting the
rectangular area between the current position and where the left
button was last pressed.
On color X displays, the "x3270.selectBackground" resource is used to
distinguish the selected text from the rest of the screen. On
monochrome X displays, selected text is in reverse video. (It can be
distinguished from a block cursor because the block cursor covers
slightly less than an entire character position on the screen.)
The left mouse button, when pressed with the "Shift" key held down,
moves the 3270 cursor to the where the mouse cursor is pointing.
This is the complete list of keymap-callable actions. Other actions
are defined for use by scripts and are documented in x3270-script(1);
still others are defined for internal use by x3270 and are not
documented here.
center; lw(3i) lw(3i). T{
Attn T} T{ attention key T} T{
AltCursor T} T{ switch between block and underscore cursor T} T{
BackSpace T} T{ move cursor left (or send ASCII BS) T} T{
BackTab T} T{ tab to start of previous input field T} T{
CircumNot T} T{ input "^" in NVT mode, or "notsign" in 3270
mode T} T{
Clear T} T{ clear screen T} T{
Compose T} T{ next two keys form a special symbol T} T{
Connect(l3h_t h, host) T} T{ connect to host T} T{
CursorSelect T} T{ Cursor Select AID T} T{
Cut T} T{ erase selected text T} T{
Default T} T{ enter key literally T} T{
Delete T} T{ delete character under cursor (or
- 14 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
send ASCII DEL) T} T{
DeleteField T} T{ delete the entire field T}
T{
DeleteWord T} T{ delete the current or
previous word T} T{
Disconnect T} T{ disconnect from host T}
T{
Down T} T{ move cursor down T} T{
Dup T} T{ duplicate field T} T{
Enter T} T{ Enter AID (or send
ASCII CR) T} T{
Erase T} T{ erase previous
character (or send ASCII BS) T}
T{
EraseEOF T} T{ erase to end of
current field T} T{
EraseInput T} T{ erase all
input fields T} T{
Execute(cmd) T} T{ execute
a command in a shell T} T{
FieldEnd T} T{ move
cursor to end of field
T} T{
FieldExit T} T{ clear
to end of field and
skip to next (5250
emulation) T} T{
FieldMark T} T{ mark
field T} T{
HandleMenu(name)
T} T{ pop up a
menu T} T{
HexString(l3h_t h,
hex_digits)
T} T{ insert
control-
character string
T} T{
Home T} T{
move cursor to
first input
field T} T{
Insert T} T{
set insert
mode T} T{
Interrupt
T} T{
send
TELNET IP
to host T}
T{
- 15 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
Key(l3h_t
h,
keysym)
T} T{
insert
key
keysym
T} T{
Key(l3h_t
h,
0xxx)
T} T{
insert
key
with
ASCII
code
xx T}
T{
Keymap(keymap)
T} T{
toggle
alternate
keymap
(or
remove
with
None)
T}
T{
KybdSelect(direction[,atom...])
T} T{
Extend
selection
by
one
row
or
column
T}
T{
Left
T} T{
move
cursor
left
T}
T{
Left2
T} T{
move
- 16 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
cursor
left
2
positions
T}
T{
Macro(macro)
T} T{
run
a
macro
T}
T{
MonoCase
T} T{
toggle
uppercase-
only
mode
T}
T{
MoveCursor
T} T{
move
cursor
to
mouse
position
T}
T{
MoveCursor(l3h_t
h,
row,
col)
T} T{
move
cursor
to
(row,col)
T}
T{
MoveCursorSelect
T} T{
move
cursor
to
mouse
position,
light
pen
selection
- 17 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
T}
T{
Newline
T} T{
move
cursor
to
first
field
on
next
line
(or
send
ASCII
LF)
T}
T{
NextWord
T} T{
move
cursor
to
next
word
T}
T{
PA(l3h_t
h,
n)
T} T{
Program
Attention
AID
(n
from
1
to
3)
T}
T{
PF(l3h_t
h,
n)
T} T{
Program
Function
AID
(n
from
1
- 18 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
to
24)
T}
T{
PreviousWord
T} T{
move
cursor
to
previous
word
T}
T{
Printer(Start[,lu]|Stop)
T} T{
Start
or
stop
printer
session
T}
T{
PrintText(command)
T} T{
print
screen
text
on
printer
T}
T{
PrintWindow(command)
T} T{
print
screen
image
(bitmap)
on
printer
T}
T{
Quit
T} T{
exit
x3270
T}
T{
Reconnect
T} T{
reconnect
to
- 19 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
previous
host
T}
T{
Redraw
T} T{
redraw
window
T}
T{
Reset
T} T{
reset
locked
keyboard
T}
T{
Right
T} T{
move
cursor
right
T}
T{
Right2
T} T{
move
cursor
right
2
positions
T}
T{
SetFont(font)
T} T{
change
emulator
font
T}
T{
Script(command[,arg...])
T} T{
run
a
script
T}
T{
String(l3h_t
h,
string)
T} T{
- 20 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
insert
string
(simple
macro
facility)
T}
T{
SysReq
T} T{
System
Request
AID
T}
T{
Tab
T} T{
move
cursor
to
next
input
field
T}
T{
ToggleInsert
T} T{
toggle
insert
mode
T}
T{
ToggleReverse
T} T{
toggle
reverse-
input
mode
T}
T{
Transfer(l3h_t
h,
option=value...)
T} T{
file
transfer
T}
T{
Unselect
T} T{
release
selection
- 21 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
T}
T{
Up
T} T{
move
cursor
up
T}
_
T{
(the
following
are
similar
to
xterm)
T}
_
T{
ignore
T} T{
do
nothing
T}
T{
insert-
selection([atom[,atom...]])
T} T{
paste
selection
T}
T{
move-
select
T} T{
a
combination
of
MoveCursor
and
select-
start
T}
T{
select-
end(atom[,atom...]])
T} T{
complete
selection
and
assign
- 22 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
to
atom(s)
T}
T{
select-
extend
T} T{
move
the
end
of
a
selection
T}
T{
select-
start
T} T{
mark
the
beginning
of
a
selection
T}
T{
set-
select(atom[,atom...]])
T} T{
assign
existing
selection
to
atom(s)
T}
T{
start-
extend
T} T{
begin
marking
the
end
of
a
selection
T}
MACROS AND SCRIPTS
There are several types of macros and script functions available.
- 23 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
The String Action
The simplest method for macros is provided via the String action.
The arguments to String are one or more double-quoted strings
which are inserted directly as if typed. The C backslash
conventions are honored as follows. (Entries marked * mean that
after sending the AID code to the host, x3270 will wait for the
host to unlock the keyboard before further processing the
string.) l l. T{ \b T} T{ Left T} T{ \f T} T{ Clear* T} T{
\n T} T{ Enter* T} T{ \pan T} T{ PA(n)* T} T{ \pfnn T} T{
PF(nn)* T} T{ \r T} T{ Newline T} T{ \t T} T{ Tab T} T{ \T
T} T{ BackTab T}
An example keymap entry would be:
Meta<Key>p: String("probs clearrdr\n")
Note: The strings are in ASCII and converted to EBCDIC, so beware
of inserting control codes. Also, a backslash before a p may
need to be doubled so it will not be removed when a resource file
is read.
There is also an alternate form of the String action, HexString,
which is used to enter non-printing data. The argument to
HexString is a string of hexadecimal digits, two per character.
A leading 0x or 0X is optional. In 3270 mode, the hexadecimal
data represent EBCDIC characters, which are entered into the
current field. In NVT mode, the hexadecimal data represent ASCII
characters, which are sent directly to the host.
The Script Action
This action causes x3270 to start a child process which can
execute x3270 actions. Standard input and output from the child
process are piped back to x3270. The Script action is fully
documented in x3270-script(1).
The macros Resource
An alternate method of defining macros is the "x3270.macros"
resource. This resource is similar to a keymap, but instead of
defining keyboard mappings, it associates a list of X actions
with a name. These names are displayed on a Macros menu that
appears when x3270 is connected to a host. Selecting one of the
names on the menu executes the X actions associated with it.
Typically the actions are String calls, but any action may be
specified. Here is a sample macros resource definition, which
would result in a four-entry Macros menu:
x3270.macros: \
log off: String("logout\n")\n\
vtam: String("dial vtam\n")\n\
pa1: PA(1)\n\
alt printer: PrintText("lpr -Plw2")
- 24 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
You can also a different set of macros for each host. If there
is a resource named `x3270.macros.somehost', it defines the
macros menu for when x3270 is connected to somehost.
The -script Option
This facility allows x3270 to operate under the complete control
of a script. x3270 accepts actions from standard input, and
prints results on standard output. The -script option is fully
documented in x3270-script(1).
COMPOSITE CHARACTERS
x3270 allows the direct entry of accented letters and special symbols.
Pressing and releasing the "Compose" key, followed by two other keys,
causes entry of the symbol combining those two keys. For example,
"Compose" followed by the "C" key and the "," (comma) key, enters the
"C-cedilla" symbol. A C on the status line indicates a pending
composite character.
The mappings between these pairs of ordinary keys and the symbols they
represent is controlled by the "x3270.composeMap" resource; it gives
the name of the map to use. The maps themselves are named
"x3270.composeMap.name". The default is "latin1", which gives
mappings for most of the symbols in the ISO 8859-1 Latin-1 character
set that are not in the 7-bit ASCII character set.
Note: The default keymap defines the "Multi_key" keysym as the
"Compose" key. If your keyboard lacks such a key, you may set up your
own "Compose" key with a keymap that maps some other keysym onto the
Compose action.
APL SUPPORT
x3270 supports the full APL2 character set and the entry of APL
characters from the keyboard.
APL characters are supported only in the special 3270 font.
Keyboard entry of APL characters is supported through the apl keymap
modifier. This modifier defines the "Alt" key as an APL key, with a
typical APL keyboard layout, e.g., "Alt" pressed with the A key
results in the APL "alpha" symbol. Overstruck characters such as
"quad-quote" are not defined as single keystrokes; instead they are
entered as composites (see COMPOSITE CHARACTERS above). A special
composite map, apl, is provided for this purpose.
Note: Some keyboards do not the "Alt" key as a modifier, so keymaps
that use the "Alt" key will not function. On a Sun for example, this
can be remedied with the command:
xmodmap -e "add mod2 = Alt_L"
- 25 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
For convenience, an -apl option is defined, which is an abbreviation
for the following resource definitions:
x3270.keymap: your_keymap_name,apl
x3270.charset: apl
x3270.composeMap: apl
There are a number of APL characters that are similar in appearance to
non-APL characters. In particular, the APL "stile", "slope," "tilde"
and "quotedot" characters are similar to the EBCDIC "bar",
"backslash," "tilde" and "exclaim" characters. The APL characters are
entered with the "Alt" key, and have slightly different appearances.
The complete list of special APL keysyms is as follows. Entries
marked with an asterisk (*) represent simple aliases for standard
EBCDIC characters. Entries marked with an (S) represent Sharp APL
charatcers.
l c l l l. T{ APL Symbol T} T{ Hex T} T{ x3270 Keysym T} T{
x3270 Key T} T{ x3270 Composed Keys T} _ T{ A underbar T} T{ 41
T} T{ apl_Aunderbar T} T{ Alt-A T} T{ A + underbar T} T{ alpha
T} T{ B0 T} T{ apl_alpha T} T{ Alt-a T} T{ T} T{ B underbar
T} T{ 42 T} T{ apl_Bunderbar T} T{ Alt-B T} T{ B + underbar T}
T{ bar T} T{ 60* T} T{ apl_bar T} T{ - T} T{ T} T{ brace
left T} T{ C0 T} T{ apl_braceleft T} T{ Alt-{ T} T{ T} T{
brace right T} T{ D0 T} T{ apl_braceright T} T{ Alt-} T} T{
T} T{ C underbar T} T{ 43 T} T{ apl_Cunderbar T} T{ Alt-C
T} T{ C + underbar T} T{ circle T} T{ 9D T} T{ apl_circle
T} T{ Alt-o T} T{ T} T{ circle bar T} T{ ED T} T{
apl_circlebar T} T{ T} T{ circle + bar T} T{ circle slope
T} T{ CF T} T{ apl_circleslope T} T{ T} T{ circle + slope T}
T{ circle star T} T{ FD T} T{ apl_circlestar T} T{ T} T{
circle + star T} T{ circle stile T} T{ CD T} T{ apl_circlestile
T} T{ T} T{ circle + stile T} T{ colon T} T{ 7A* T} T{
apl_colon T} T{ : T} T{ T} T{ comma T} T{ 6B* T} T{
apl_comma T} T{ , T} T{ T} T{ comma bar (S) T} T{ E5 T} T{
apl_commabar T} T{ T} T{ comma + bar T} T{ D underbar T} T{ 44
T} T{ apl_Dunderbar T} T{ Alt-D T} T{ D + underbar T} T{ del
T} T{ BA T} T{ apl_del T} T{ Alt-g T} T{ T} T{ del stile
T} T{ DC T} T{ apl_delstile T} T{ T} T{ del + stile T} T{
del tilde T} T{ FB T} T{ apl_deltilde T} T{ T} T{ del +
tilde T} T{ delta T} T{ BB T} T{ apl_delta T} T{ Alt-h T} T{
T} T{ delta stile T} T{ DD T} T{ apl_deltastile T} T{ T} T{
delta + stile T} T{ delta underbar T} T{ FC T} T{
apl_deltaunderbar T} T{ T} T{ delta + underbar T} T{ diamond
T} T{ 70 T} T{ apl_diamond T} T{ T} T{ up caret + down caret
T} T{ dieresis T} T{ 72 T} T{ apl_dieresis T} T{ Alt-1 T} T{
T} T{ dieresis circle (S) T} T{ E5 T} T{ apl_dieresiscircle
T} T{ T} T{ dieresis + circle T} T{ dieresis dot T} T{ EC
T} T{ apl_dieresisdot T} T{ T} T{ dieresis + dot T} T{
dieresis jot (S) T} T{ E4 T} T{ apl_dieresisjot T} T{ T} T{
dieresis + jot T} T{ divide T} T{ B8 T} T{ apl_divide T} T{
- 26 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
Alt-+ T} T{ T} T{ dot T} T{ 4B* T} T{ apl_dot T} T{ T} T{
T} T{ down arrow T} T{ 8B T} T{ apl_downarrow T} T{ Alt-u
T} T{ T} T{ down caret T} T{ 78 T} T{ apl_downcaret T} T{
Alt-9 T} T{ T} T{ down caret tilde T} T{ CB T} T{
apl_downcarettilde T} T{ T} T{ down caret + tilde T} T{ down
shoe T} T{ AB T} T{ apl_downshoe T} T{ Alt-v T} T{ T} T{
down stile T} T{ 8E T} T{ apl_downstile T} T{ Alt-d T} T{ T}
T{ down tack T} T{ AC T} T{ apl_downtack T} T{ Alt-b T} T{
T} T{ down tack jot T} T{ FE T} T{ apl_downtackjot T} T{
T} T{ down tack + jot T} T{ down tack up tack T} T{ DA T} T{
apl_downtackuptack T} T{ T} T{ down tack + up tack T} T{ E
underbar T} T{ 45 T} T{ apl_Eunderbar T} T{ Alt-E T} T{ E +
underbar T} T{ epsilon T} T{ B1 T} T{ apl_epsilon T} T{ Alt-e
T} T{ T} T{ epsilon underbar T} T{ 75 T} T{
apl_epsilonunderbar T} T{ T} T{ epsilon + underbar T} T{ equal
T} T{ 7E* T} T{ apl_equal T} T{ "=" T} T{ T} T{ equal
underbar T} T{ E1 T} T{ apl_equalunderbar T} T{ T} T{ equal
+ underbar T} T{ euro (S) T} T{ E7 T} T{ apl_euro T} T{
T} T{ C + = T} T{ F underbar T} T{ 46 T} T{ apl_Funderbar
T} T{ Alt-F T} T{ F + underbar T} T{ G underbar T} T{ 47 T} T{
apl_Gunderbar T} T{ Alt-G T} T{ G + underbar T} T{ greater T} T{
6E* T} T{ apl_greater T} T{ > T} T{ T} T{ H underbar T} T{
48 T} T{ apl_Hunderbar T} T{ Alt-H T} T{ H + underbar T} T{ I
underbar T} T{ 49 T} T{ apl_Iunderbar T} T{ Alt-I T} T{ I +
underbar T} T{ iota T} T{ B2 T} T{ apl_iota T} T{ Alt-i T} T{
T} T{ iota underbar T} T{ 74 T} T{ apl_iotaunderbar T} T{
T} T{ iota + underbar T} T{ J underbar T} T{ 51 T} T{
apl_Junderbar T} T{ Alt-J T} T{ J + underbar T} T{ jot T} T{ AF
T} T{ apl_jot T} T{ alt-j T} T{ T} T{ K underbar T} T{ 52
T} T{ apl_Kunderbar T} T{ Alt-K T} T{ K + underbar T} T{ L
underbar T} T{ 53 T} T{ apl_Lunderbar T} T{ Alt-L T} T{ L +
underbar T} T{ left arrow T} T{ 9F T} T{ apl_leftarrow T} T{
Alt-[ T} T{ T} T{ left bracket T} T{ AD T} T{ apl_leftbracket
T} T{ [ T} T{ T} T{ left paren T} T{ 4D* T} T{ apl_leftparen
T} T{ ( T} T{ T} T{ left shoe T} T{ 9B T} T{ apl_leftshoe
T} T{ Alt-z T} T{ T} T{ less T} T{ 4C* T} T{ apl_less
T} T{ < T} T{ T} T{ M underbar T} T{ 54 T} T{ apl_Munderbar
T} T{ Alt-M T} T{ M + underbar T} T{ N underbar T} T{ 55 T} T{
apl_Nunderbar T} T{ Alt-N T} T{ N + underbar T} T{ not equal
T} T{ BE T} T{ apl_notequal T} T{ Alt-8 T} T{ equal + slash T}
T{ not greater T} T{ 8C T} T{ apl_notgreater T} T{ Alt-4 T} T{
less + equal T} T{ not less T} T{ AE T} T{ apl_notless T} T{
Alt-6 T} T{ greater + equal T} T{ O underbar T} T{ 56 T} T{
apl_Ounderbar T} T{ Alt-O T} T{ O + underbar T} T{ omega T} T{
B4 T} T{ apl_omega T} T{ Alt-w T} T{ T} T{ overbar T} T{ A0
T} T{ apl_overbar T} T{ Alt-2 T} T{ T} T{ P underbar T} T{
57 T} T{ apl_Punderbar T} T{ Alt-P T} T{ P + underbar T} T{ plus
T} T{ 4E* T} T{ apl_plus T} T{ + T} T{ T} T{ Q underbar
T} T{ 58 T} T{ apl_Qunderbar T} T{ Alt-Q T} T{ Q + underbar T}
T{ quad T} T{ 90 T} T{ apl_quad T} T{ Alt-l T} T{ T} T{ quad
divide T} T{ EE T} T{ apl_quaddivide T} T{ T} T{ quad +
- 27 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
divide T} T{ quad jot T} T{ 73 T} T{ apl_quadjot T} T{ T} T{
quad + jot T} T{ quad quote T} T{ DE T} T{ apl_quadquote T} T{
T} T{ quad + quote T} T{ quad slope T} T{ CE T} T{ apl_quadslope
T} T{ T} T{ quad + slope T} T{ query T} T{ 6F* T} T{
apl_query T} T{ ? T} T{ T} T{ quote T} T{ 7D* T} T{
apl_quote T} T{ T} T{ T} T{ quote dot T} T{ DB T} T{
apl_quotedot T} T{ T} T{ quote + dot T} T{ R underbar T} T{ 59
T} T{ apl_Runderbar T} T{ Alt-R T} T{ R + underbar T} T{ rho
T} T{ B3 T} T{ apl_rho T} T{ Alt-r T} T{ T} T{ right arrow
T} T{ 8F T} T{ apl_rightarrow T} T{ Alt-] T} T{ T} T{ right
bracket T} T{ BD T} T{ apl_rightbracket T} T{ ] T} T{ T} T{
right paren T} T{ 5D* T} T{ apl_rightparen T} T{ ) T} T{ T}
T{ right shoe T} T{ 9A T} T{ apl_rightshoe T} T{ Alt-x T} T{
T} T{ S underbar T} T{ 62 T} T{ apl_Sunderbar T} T{ Alt-S
T} T{ S + underbar T} T{ semicolon T} T{ 5E* T} T{ apl_semicolon
T} T{ ; T} T{ T} T{ slash T} T{ 61* T} T{ apl_slash T} T{
/ T} T{ T} T{ slash bar T} T{ EA T} T{ apl_slashbar T} T{
T} T{ slash + bar T} T{ slope T} T{ B7 T} T{ apl_slope T} T{
Alt-\ T} T{ T} T{ slope bar T} T{ EB T} T{ apl_slopebar
T} T{ T} T{ slope + bar T} T{ squad T} T{ CC T} T{ apl_squad
T} T{ T} T{ quad + quad T} T{ star T} T{ 5C* T} T{ apl_star
T} T{ * T} T{ T} T{ stile T} T{ BF T} T{ apl_stile T} T{
Alt-| T} T{ T} T{ T underbar T} T{ 63 T} T{ apl_Tunderbar
T} T{ Alt-T T} T{ T + underbar T} T{ tilde T} T{ 80 T} T{
apl_tilde T} T{ Alt-~ T} T{ T} T{ times T} T{ B6 T} T{
apl_times T} T{ Alt-= T} T{ T} T{ U underbar T} T{ 64 T} T{
apl_Uunderbar T} T{ Alt-U T} T{ U + underbar T} T{ underbar
T} T{ 6D* T} T{ apl_underbar T} T{ "_" T} T{ T} T{ up arrow
T} T{ 8A T} T{ apl_uparrow T} T{ Alt-y T} T{ T} T{ up caret
T} T{ 71 T} T{ apl_upcaret T} T{ Alt-0 T} T{ T} T{ up caret
tilde T} T{ CA T} T{ apl_upcarettilde T} T{ T} T{ up caret +
tilde T} T{ up shoe T} T{ AA T} T{ apl_upshoe T} T{ Alt-c
T} T{ T} T{ up shoe jot T} T{ DF T} T{ apl_upshoejot T} T{
T} T{ up shoe + jot T} T{ up stile T} T{ 8D T} T{ apl_upstile
T} T{ Alt-s T} T{ T} T{ up tack T} T{ BC T} T{ apl_uptack
T} T{ Alt-n T} T{ T} T{ up tack jot T} T{ EF T} T{
apl_uptackjot T} T{ T} T{ up tack + jot T} T{ V underbar T} T{
65 T} T{ apl_Vunderbar T} T{ Alt-V T} T{ V + underbar T} T{ W
underbar T} T{ 66 T} T{ apl_Wunderbar T} T{ Alt-W T} T{ W +
underbar T} T{ X underbar T} T{ 67 T} T{ apl_Xunderbar T} T{
Alt-X T} T{ X + underbar T} T{ Y underbar T} T{ 68 T} T{
apl_Yunderbar T} T{ Alt-Y T} T{ Y + underbar T} T{ Z underbar
T} T{ 69 T} T{ apl_Zunderbar T} T{ Alt-Z T} T{ Z + underbar T}
5250 (AS/400) SUPPORT
x3270 provides limited support for 5250 (AS/400) emulation. This is
not native 5250 terminal emulation, but rather for use with hosts
which allow a 3270 terminal to emulate a 5250. A 5250 keymap is
defined, which maps the keyboard function keys to the 5250 emulators
PA/PF key sequences, as well as redefining the Return key to use the
special FieldExit action. The command line for 5250 support is:
- 28 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
x3270 -model 2 -keymap 5250
SCREEN PRINTING
Screen printing is handled through options on the File menu or by the
PrintText and PrintWindow actions. Each results in a pop-up to
confirm the print command.
The PrintText action (usually assigned to the key <Meta>p) sends the
current screen image to the printer as ASCII characters. The default
command used to print the data is controlled by the
"x3270.printTextCommand" resource; the default is lpr. You may also
use a keymap definition to pass a print command the PrintText action
itself. The command receives the screen text as its standard input.
For example, the following keymap will save the screen text in a file:
Meta<Key>f: PrintText("cat >screen.image")
Note: HardPrint is an alias for PrintText.
The PrintWindow action (usually assigned to the key <Meta>b) sends the
current screen image to the printer as a bitmap. The default command
used to print the data is controlled by the "x3270.printWindowCommand"
resource; the default is
xwd -id %d | xpr | lpr.
You may also use a keymap definition to pass a print command to the
PrintWindow action itself. If the command contains the text "%d", the
window ID of x3270 will be substituted before it is run. For example,
the following keymap will pop up a duplicate of the current screen
image:
Meta<Key>g: PrintWindow("xwd -id %d | xwud &")
If the command for PrintWindow or PrintText begins with an "@"
character, the initial pop-up menu to confirm the print command is not
displayed and the command cannot be edited.
BUGS
Cursor highlighting will not work with if you use the NoTitleFocus
option in your .twmrc file.
PASSTHRU
x3270 supports the Sun telnet-passthru service provided by the
in.telnet-gw server. This allows outbound telnet connections through
a firewall machine. When a p: is prepended to a hostname, x3270 acts
much like the itelnet(1) command. It contacts the machine named
internet-gateway at the port defined in /etc/services as telnet-
passthru (which defaults to 3514). It then passes the requested
- 29 - Formatted: September 8, 2024
x3270(1) x3270(1)
31 December 2001
hostname and port to the in.telnet-gw server.
FILES
/usr/lib/X11/x3270/ibm_hosts
$HOME/.x3270pro
SEE ALSO
s3270(1), c3270(1), tcl3270(1), ibm_hosts(5), x3270-script(1),
pr3287(1), telnet(1), tn3270(1)
X Toolkit Intrinsics
Data Stream Programmer's Reference, IBM GA23-0059
Character Set Reference, IBM GA27-3831
RFC 1576, TN3270 Current Practices
RFC 1646, TN3270 Extensions for LUname and Printer Selection
RFC 2355, TN3270 Enhancements
COPYRIGHTS
Modifications Copyright 1993, 1994, 1995, 1996, 1997, 1999, 2000, 2001
by Paul Mattes.
Original X11 Port Copyright 1990 by Jeff Sparkes.
Permission to use, copy, modify, and distribute this software and
its documentation for any purpose and without fee is hereby
granted, provided that the above copyright notice appear in all
copies and that both that copyright notice and this permission
notice appear in supporting documentation.
Copyright 1989 by Georgia Tech Research Corporation, Atlanta, GA
30332.
All Rights Reserved. GTRC hereby grants public use of this
software. Derivative works based on this software must
incorporate this copyright notice.
5250 Emulation Code Copyright Minolta (Schweiz) AG, Beat Rubischon.
VERSION
x3270 3.2.18
- 30 - Formatted: September 8, 2024
