c3270(1)

NAME

c3270 - curses-based IBM host access tool

SYNOPSIS

c3270 [options] [host]

DESCRIPTION

Arrayhostname with a colon `:'. (For compatability with previous versions of c3270 and with tn3270(1), the port may also be specified as a second, separate argument.)

OPTIONS

Array-mono Forces 3278 emulation.

ArrayRESOURCES below.

CHARACTER SETS

Arrayand `]' characters, respectively.

HOSTS DATABASE

Arraytion is first made. See ibm_hosts(5) for details.
You may specify a different ibm_hosts database with the

"c3270.hostsFile" resource.

NVT (ANSI) MODE

Arraytion. When in line mode, the special characters and operational
characteristics are defined by resources:
Separate keymaps can be defined for use only when c3270 is

in 3270 mode or NVT mode. See KEYMAPS for details.

TOGGLES

ArrayThese names are also used as the first parameter to the

Toggle

STATUS LINE

Arraycursor position

The cursor row and column are optionally displayed,

separated by a "/".

ACTIONS

Arrayc3270 also supports the following interactive commands:

Help Displays a list of available commands.

Show Displays statistics and settings.

Arrayoff disables it. The qualifier data or keyboard can be specified before on or off to enable or disable a particular trace. After
on, a filename may be specified to override the default trace
file name of /tmp/x3trc.pid.

KEYMAPS

Arraycase b. Actions for uppercase B, or for Meta-b or Control-B, must be specified separately.
The base keymap is:

Key Action
------------------------------------Ctrl<Key>] Escape
Ctrl<Key>a Ctrl<Key>a Key(0x01)
Ctrl<Key>a Ctrl<Key>] Key(0x1d)
Ctrl<Key>a <Key>Tab BackTab
Ctrl<Key>a <Key>c Clear
Ctrl<Key>a <Key>e Escape
Ctrl<Key>a <Key>r Reset
Ctrl<Key>a <Key>l Redraw
Ctrl<Key>a <Key>m Compose
Ctrl<Key>a <Key>^ Key(notsign)
<Key>UP Up
<Key>DOWN Down
<Key>LEFT Left
<Key>RIGHT Right
<Key>F(n) PF(n)
Ctrl<Key>a <Key>F(n) PF(n+12)
Ctrl<Key>a <Key>1 PA(1)
Ctrl<Key>a <Key>2 PA(2)
Ctrl<Key>a <Key>3 PA(3)

The base 3270-mode keymap adds:

Key Action
--------------------------Ctrl<Key>c Clear
Ctrl<Key>r Reset
Ctrl<Key>l Redraw
<Key>Tab Tab
<Key>DC Delete
<Key>BACKSPACE BackSpace
<Key>BackSpace BackSpace
<Key>Return Enter
<Key>Linefeed Newline

THE META OR ALT KEY

Arraynot set, the keyboard is assumed to use the Escape character as a
prefix to indicate that the following character is supposed to
have the high-order bit set. When c3270 sees an Escape character
from the keyboard, it sets a short timeout. If another character
arrives before the timeout expires, then c3270 will combine the
two characters, setting the high-order bit of the second. In an
event trace file, the combined character is listed as derived. In a keymap, only the combined character or the Meta prefix may
be used. The Escape key can still be used by itself, but only if
there is a short pause before pressing another key.
The default value for c3270.metaEscape is auto.

FILE TRANSFER

ArrayPrimarySpace No
SecondarySpace No
BufferSize No 4096

The option details are as follows.

ArrayHostFile

The name of the file on the host.

LocalFile

The name of the file on the local workstation.

Host The type of host (which dictates the form of the

IND$FILE

Arrayfor non-text files.
Cr Controls how Newline characters are handled when

transferring Mode=ascii files. remove (the default) strips

Newline

host. add adds Newline characters to each host file record before transferring it to the local workstation. keep preserves

Newline

Exist Controls what happens when the destination file al

ready exists. keep (the default) preserves the file, causing the

Transfer

Arraya file with variable-length records. undefined creates a file with undefined-length records (TSO hosts only). The Lrecl option
controls the record length or maximum record length for

Recfm=fixed

Arrayhosts may not be able to support them.

SCRIPTS

There are several types of script functions available.

Arraythe child process are piped back to c3270. The Script action is fully documented in x3270-script(1).

COMPOSITE CHARACTERS

Arraythat maps some other keysym onto the Compose action.

PRINTER SUPPORT

ArrayThe action Printer Stop stops a printer session.

ArrayToken Substitition
%C% Command (value of c3270.printer.command) %H% Host IP address
%L% Current or specified LU

See pr3287(1) for further details.

e

PASSTHRU

Arraythrough a firewall machine. When a p: is prepended to a hostname, c3270 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 hostname and port co the in.telnet-gw server.
.

SCREEN SIZE SWITCHING

Arraysions, and init_string is the escape sequence to transmit to the terminal to enter that mode. For defscreen, the minimum dimensions are 24 rows and 80 columns. For altscreen, the minimum dimensions are 27 rows and 132 columns. Within init_string, the usual escape sequences are supported ( for escape, e
x a m p l e

Note: When defscreen and altscreen are specified, the mod

el number is always set to 5.

RESOURCES

Arraylast one on the command line is used.

FILES

/usr/local/lib/x3270/ibm_hosts
$HOME/.c3270pro

SEE ALSO

ArrayRFC 2355, TN3270 Enhancements

COPYRIGHTS

ArrayMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
file LICENSE for more details.

VERSION

c3270 3.3.4

09 April 2005

c3270(1)