c3270 Build and Install Instructions

To build c3270, type:
    ./configure
    make
To install c3270 in the default install directory (/usr/local), type:
    make install

Wide Curses Requirement

c3270 needs a 'wide' version of the curses or ncurses library (onethat supports multi-byte character encodings).Without wide curses or ncurses, c3270 will be restricted to using the 7-bitbasic ASCII character set.

On some platforms, the standard curses or ncurses library is the wide versionand no extra packages need be installed. On others, a special wide ncursespackage is needed.On still others (such as on Solaris, documented below) the wide curses libraryis installed in a special location and configure must be told where tolocate it using CPPFLAGS and LDFLAGS.

Notes for Cygwin

The minimum set of Cygwin packages needed to compile c3270 are:Optional features require some additional packages:To build a standalone version of c3270 (a ZIP file containingc3270.exe and the minimum set of Cygwin libraries and configurationfiles -- thus allowing c3270 to be installed and run without afull Cygwin installation), type:
    make c3270-standalone-zip

Notes for Sun's C Compiler

Do not use Sun's BSD-compatibility compiler, /usr/ucb/cc. This is good advice in general, but in particular, c3270 will notbuild with it. In general, you must have a directory containing gcc(preferred) or Sun's ANSI C compiler (usually in /usr/ccs/bin) inyour $PATH ahead of /usr/ucb.

Notes for Solaris

c3270 prefers wide curses, which on Solaris is in the /usr/xpg4directory. To use this version of curses, set CPPFLAGS and LDFLAGS when runningconfigure:
    ./configure CPPFLAGS=-I/usr/xpg4/include LDFLAGS=-L/usr/xpg4/lib

Building on FreeBSD

FreeBSD's iconv library is installed in /usr/local, sothe the following options must be passed to the configure script:
       ./configure LDFLAGS=-L/usr/local/lib CPPFLAGS=-I/usr/local/include

Summary of configure Options

The c3270 configure script accepts the following options:
 
--help Print a help message.
--prefix=prefix Install architecture-independent files under prefix (defaults to /usr/local)
--exec-prefix=eprefix Install architecture-dependent files (executables) under eprefix (defaults to same as prefix)
--bindir=dir Install user executables (c3270, x3270if, pr3287) in dir (defaults to eprefix/bin
--sysconfdir=dir Install configuration files (ibm_hosts, character sets) in dir (defaults to prefix/etc).
--without-readline Don't use the readline command-line editing library, even if it is found on the system.
--without-pr3287 Don't build pr3287.
Useful if you don't need printer session support, or if you want to build pr3287 separately or with different configuration options.
--disable-ansi Leave out NVT (ANSI) support.
Note that NVT support is required for TN3270E support.
--disable-apl Leave out APL character support.
--enable-dbcs
Build in DBCS (Double Byte Character Set) support.
--disable-ft Leave out IND$FILE file transfer support.
--disable-local-process Leave out local process (connecting to "-e shell_command")support.
This will be automatically disabled if the local system does not supportthe forkpty() library call.
--disable-printer Leave out printer session (pr3287) support.
--disable-script Leave out scripting support.
--disable-ssl
Leave out SSL (Secure Sockets Layer) support.  SSL support requires the OpenSSL library.
--with-ssl=dir
Specify the directory where the OpenSSL library is installed.
--disable-tn3270e Leave out TN3270E support.
--disable-trace Leave out tracing support.

Leaving out all of the optional features will result in a smaller binary.