Annotation of 43BSDReno/usr.bin/tn3270/distribution/README, revision 1.1.1.1

1.1       root        1: Welcome to the new tn3270 - version 4.1.1.
                      2: 
                      3: This version consists entirely of bug fixes to the August 1987 beta release
                      4: of tn3270.  This version will now deal with CICS and VM/XA on the IBM
                      5: side, and with SunOS 4.0 on Sun 3's and Sun 4's.
                      6: 
                      7: This version has been tested on various versions of BSD Unix, including
                      8: 4.2 and 4.3 (but there are never vanilla versions) and the post-4.3 systems
                      9: running at Berkeley.  It has been tested on CCI's, Vaxen, Sun 3's and Sun 4's.
                     10: However, it doesn't necessarily work on all systems (nor has the testing
                     11: been as intensive as one might like).
                     12: 
                     13: This version should build on any Berkeley-derived system.
                     14: 
                     15: There are two alternate make files:  ./makefile_4.2 and telnet/Makefile_ultrix.
                     16: 
                     17: ****    Try ./makefile_4.2 if you get compile-time errors, or get
                     18:        "multiply defined" messages for "_putchar" from the loader.
                     19: 
                     20: ****    Try telnet/Makefile_ultrix if your make(1) utility doesn't
                     21:        support VPATH.  Also try this makefile if your ld(1) doesn't
                     22:        support the -r flag correctly.
                     23: 
                     24: The bad news is that I've had to drop MS-DOS support.  The good news here is
                     25: that there are various versions available for MS-DOS (from FTP Software in
                     26: Cambridge, Mass.; from IBM; from Excelan; and probably from others).  The
                     27: hooks are still there, as well as some code to update the screen.  However,
                     28: I just haven't had the time to produce a fully integrated version that would
                     29: "just make".  I suspect that a future release may have MS-DOS support back
                     30: in it.
                     31: 
                     32: There is no Mac support.  Contact Peter DiCamillo at Brown University if
                     33: you need a Mac tn3270.
                     34: 
                     35: The main code change in this version is to what used to be called "telnet.c".
                     36: This is now replaced with a version of telnet (substantially what appeared
                     37: in the "4.3tahoe" release from CSRG) which is broken into separate files.
                     38: 
                     39: Here is an overview of the directory structure:
                     40: 
                     41:     api/               General library of function needed by API
                     42:                        (and, to some extent, by the rest of tn3270).
                     43: 
                     44:     arpa/              Location of "telnet.h" (for non-4.3 systems).
                     45: 
                     46:     ascii/             Routines necessary to handle the case of running
                     47:                        from an ASCII-oriented system (ie: unix).
                     48: 
                     49:     ctlr/              The main part of the emulator.  Handles 3270 scan
                     50:                        codes, 3270 data stream, 3270 display codes,
                     51:                        and EBCDIC.  Also, the internal API function
                     52:                        lives here.
                     53: 
                     54:     general/           Some general subroutines and data structures of
                     55:                        interest to the emulator only.
                     56: 
                     57:     sys_curses/                System-dependent code for a curses-based environment.
                     58: 
                     59:     sys_dos/           System-dependent code for an MS-DOS-base environment.
                     60:                        Remember that this is included for your developmental
                     61:                        needs (ie: it doesn't work).
                     62: 
                     63:     telnet/            Where the telnet portion of tn3720 is built.
                     64: 
                     65:     tools/             Various tools.  Most of these are used during the
                     66:                        build process.  One (prt3270) is a debugging tool.
                     67:                        One (mkmake.y) is quite horrible, and attempts to
                     68:                        transform Unix makefiles into PC makefiles.
                     69: 
                     70:     utilities/         The source for tnrecv, which receives files
                     71:                        (fairly slowly) from an IBM host.  We don't
                     72:                        include the IBM side, because we really aren't
                     73:                        happy with very much of it (except that it does,
                     74:                        sometimes, work).  Hopefully, when we get past
                     75:                        the beta stage we will have more robust (and
                     76:                        complete) code to share.
                     77: 
                     78: The fact that system dependancies are isolated should make it easy
                     79: to port to other systems.  I would like to hear about problems porting
                     80: to new areas.
                     81: 
                     82: In the August, 1987 README file, the following appeared:
                     83: 
                     84: > WHAT IS NOT IN THIS VERSION (sigh):
                     85: 
                     86: > 1)   We don't have a native X version yet.  I am waiting for X version 11
                     87: >      (though this is mostly an excuse; I could have done version 10,
                     88: >      but I haven't had the time).
                     89: 
                     90: > 2)   We don't process structured fields.
                     91: 
                     92: > 3)   We don't do 3270-style graphics (ala 3193, say).
                     93: 
                     94: > The above three items WILL be in the next version, which should come
                     95: > along "any day now" (say 6 months) (but, they WON'T be in the production
                     96: > release of this version).
                     97: 
                     98: The next piece of bad news is that none of the above have happened yet,
                     99: and I don't know when they might occur.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.