1Welcome to the new tn3270 - version 4.1.1. 2 3This version consists entirely of bug fixes to the August 1987 beta release 4of tn3270. This version will now deal with CICS and VM/XA on the IBM 5side, and with SunOS 4.0 on Sun 3's and Sun 4's. 6 7This version has been tested on various versions of BSD Unix, including 84.2 and 4.3 (but there are never vanilla versions) and the post-4.3 systems 9running at Berkeley. It has been tested on CCI's, Vaxen, Sun 3's and Sun 4's. 10However, it doesn't necessarily work on all systems (nor has the testing 11been as intensive as one might like). 12 13This version should build on any Berkeley-derived system. 14 15There 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 24The bad news is that I've had to drop MS-DOS support. The good news here is 25that there are various versions available for MS-DOS (from FTP Software in 26Cambridge, Mass.; from IBM; from Excelan; and probably from others). The 27hooks are still there, as well as some code to update the screen. However, 28I 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 30in it. 31 32There is no Mac support. Contact Peter DiCamillo at Brown University if 33you need a Mac tn3270. 34 35The main code change in this version is to what used to be called "telnet.c". 36This is now replaced with a version of telnet (substantially what appeared 37in the "4.3tahoe" release from CSRG) which is broken into separate files. 38 39Here 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 78The fact that system dependancies are isolated should make it easy 79to port to other systems. I would like to hear about problems porting 80to new areas. 81 82In 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 98The next piece of bad news is that none of the above have happened yet, 99and I don't know when they might occur. 100