Return to README CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / ucb / tn3270

Annotation of 43BSDTahoe/ucb/tn3270/README, revision 1.1

1.1     ! root        1: Welcome to the new (beta) tn3270.
        !             2: 
        !             3: The good news is that MOST system dependent code is in a few subdirectories
        !             4: (mostly in sys_curses, on Unix, or sys_dos, on MS_DOS).
        !             5: 
        !             6: Internally, the code has changed substantially.  We now look (to the
        !             7: best of our limited ability) like a 3274 controller.  The screen buffer
        !             8: is kept in 3270 display code format; keystokes are defined in terms
        !             9: of 3270 scan codes (but, no changes to /etc/map3270 are required).
        !            10: 
        !            11: Unfortunately, things are much more complicated that ever.  There are now
        !            12: subdirectories.  To wit:
        !            13: 
        !            14:     api/               General library of function needed by API
        !            15:                        (and, to some extent, by the rest of tn3270).
        !            16: 
        !            17:     arpa/              Location of "telnet.h" (for non-4.3 systems).
        !            18: 
        !            19:     ascii/             Routines necessary to handle the case of running
        !            20:                        from an ASCII-oriented system (ie: unix).
        !            21: 
        !            22:     ctlr/              The main part of the emulator.  Handles 3270 scan
        !            23:                        codes, 3270 data stream, 3270 display codes,
        !            24:                        and EBCDIC.  Also, the internal API function
        !            25:                        lives here.
        !            26: 
        !            27:     general/           Some general subroutines and data structures of
        !            28:                        interest to the emulator only.
        !            29: 
        !            30:     sys_curses/                System-dependent code for a curses-based environment.
        !            31: 
        !            32:     sys_dos/           System-dependent code for an MS-DOS-base environment.
        !            33: 
        !            34:     tools/             Various tools.  Most of these are used during the
        !            35:                        build process.  One (prt3270) is a debugging tool.
        !            36:                        One (mkmake.y) is quite horrible, and attempts to
        !            37:                        transform Unix makefiles into PC makefiles.
        !            38: 
        !            39:     utilities/         The source for tnrecv, which receives files
        !            40:                        (fairly slowly) from an IBM host.  We don't
        !            41:                        include the IBM side, because we really aren't
        !            42:                        happy with very much of it (except that it does,
        !            43:                        sometimes, work).  Hopefully, when we get past
        !            44:                        the beta stage we will have more robust (and
        !            45:                        complete) code to share.
        !            46: 
        !            47: The fact that system dependancies are isolated should make it easy
        !            48: to port to other systems.  I would like to hear about problems porting
        !            49: to new areas.
        !            50: 
        !            51: WHAT IS NOT IN THIS VERSION (sigh):
        !            52: 
        !            53: 1)     We don't have a native X version yet.  I am waiting for X version 11
        !            54:        (though this is mostly an excuse; I could have done version 10,
        !            55:        but I haven't had the time).
        !            56: 
        !            57: 2)     We don't process structured fields.
        !            58: 
        !            59: 3)     We don't do 3270-style graphics (ala 3193, say).
        !            60: 
        !            61: The above three items WILL be in the next version, which should come
        !            62: along "any day now" (say 6 months) (but, they WON'T be in the production
        !            63: release of this version).
        !            64: 
        !            65: 4.2 NOTE:
        !            66: 
        !            67: If you run 4.2 on a vax, you may get error messages involving assignments
        !            68: to variables which are pointers to void returning functions.  These
        !            69: errors can be corrected by using makefile_4.2 as your makefile.
        !            70: 
        !            71: MS-DOS NOTES:
        !            72: 
        !            73: This version can be built on an MS-DOS system.
        !            74: 
        !            75: We use version 4.0 of the MicroSoft C compiler.  We use version 4.0
        !            76: of the MicroSoft assembler.  We use "PolyMake" from "POLYTRON"
        !            77: (P.O. Box 787; Hillsboro, OR 97123; (503)648-8595).
        !            78: 
        !            79: There is a problem in that, on a 512KB PC, memory fills up.  Possibly,
        !            80: before saying make in the "tn3270" directory, you should say make
        !            81: in the "tn3270/api" directory.
        !            82: 
        !            83: The INCLUDE environmental variable is assumed to point to
        !            84: the standard include files, plus to whereever the networking include
        !            85: files are located.  These are files like <sys/socket.h>.  This is
        !            86: assuming that you have a 4.2/3 network emulation package (UB offers such
        !            87: a package with their product; my understanding is that FTP Software
        !            88: is, or soon will be, offering such a package).
        !            89: 
        !            90: As mentioned in the last paragraph, we use Ungermann-Bass's library
        !            91: to perform the networking functions.  Probably other vendors' libraries
        !            92: could be integrated as well.
        !            93: 
        !            94: The file utilities/tarread.exe is a small program which reads tar
        !            95: files on MS-DOS.  It is from Drew Perkins and CMU.  Many thanks
        !            96: to them.

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