UCLA/Mail distribution V1.500 (cover letter) University of California Office of Academic Computing 5628 Math Sciences Addition Los Angeles, California 90024 06/20/91 Michael Stein OAC Systems CSYSMAS@MVS.OAC.UCLA.EDU Copyright Regents University of California, 1983, 1984, 1985, 1986, 1988, 1991. Dedication: To those brave volunteers who ran code containing many many constants of "UCLA". I thank the following pioneers for their assistance and suggestions. Peter Sylvester GMD (Bonn, Germany) Doron Shikmoni Bar-Ilan University, Ramat-Gan, Israel Leonard Woren University of Southern California Jim Walker Triangle Universities Computation Center (TUCC) This is the UCLA/Mail V1.500 distribution. This "AS IS" distribution is not intended as a "LOAD and GO" product. It will require an experienced systems programmer with appropriate reference manuals to make use of this material. This is not an "object code only" distribution, the source is the major part of this distribution and is also expected to be used as part of the documentation. This distribution contains updated OFC routines (and TSO MAIL command) from the previous 1.410 tape. The other routines have not been changed from the V1.410 level. This distribution consists of a selection of the code from the mail system currently running at UCLA. You are under no obligation to run all of this code, choose what fits your environment. It might be a good idea to start small and work up. Since this is a copy of the UCLA mail system, many checks exist specifically for the UCLA environment. You will want to change or delete these as required to match your environment. The UCLA MVS/ESA V4.2 system runs on a 3090 model 600J under LPAR. The primary interactive services are TSO and WYLBUR. The MVS system has a NJE connections to various other systems (both MVS and VM) on campus as well as Bitnet. It also runs IBM's TCP/IP for MVS which is connected via the local campus network and NSF regional(s) to the Internet. The UCLA/Mail system is the local MVS post office. It handles all local mail and interfaces with the networks via NJE. This distribution was developed with ASMH V2 as the system assembler and it may be required. The F level assembler will not assemble the source as is and it may NOT be possible to reorder the source to allow assembly. DISTRIBUTION OVERVIEW UCLA/MAIL ("OFC" ROUTINES) These are the post office "server" routines which actually do I/O to the mail VSAM file. These routines also contain the SNA/NJE support used to communicate with networks. These routines contains some (fewer) UCLA specific checks, see the OFCREF document for specifics. UCLA/IPC-370 ("IPC" ROUTINES) IPC stands for Interprocess Communication. These routines comprise a general communication service between address spaces. This is the communication mechanism between the post office and post office users (TSO, WYLBUR). These routines are required for any use of the post office. These routines have not required any changes in years (since MVS/SP 2.2.0). Once in a while they get an assembly error due to a bad IBM macro. The version of IPC on this tape is the same as the previous distribution tape (V1.410). TSO COMMANDS (AND MODIFICATION) The TSO commands include MAIL and SMSG. MAIL is the TSO interface to the post office, while SMSG supports sending nodal messages and commands. The optional TSO modification allows automatically checking for mail at TSO logon. WYLBUR MODIFICATIONS These modifications to Online Business System's WYLBUR product allow it to interface with UCLA/Mail. The mail system WYLBUR interface is designed for R7 of OBS WYLBUR and allows sending and receiving mail from the WYLBUR active file. For those sites which have obtained the necessary permissions, a second tape is included which contains the interface to the UCLA mail system for OBS WYLBUR. UCLA has no current plan to install WYLBUR R8, we are defering any upgrade. If we had to upgrade we might just skip R8. JES2 MODIFICATIONS These modifications address two areas. One modification allows mail addressed to the JES2 node name to be automatically routed to the post office even though it has a different NJE node name. The rest of the modifications support nodal messages and commands in both directions. None of these modifications are required. INTERNAL LOGIC CHECKS (0C3 ABENDS) There are many EX 0,* instructions in this distribution. Most of these are of the "This can never happen" type and have occurred many times during testing. Some in the newer parts (in post office modules only) are for conditions which are just unusual or for parts of code which are incomplete. Which of these cases a particular program check is should be obvious from the source. OFC V1.500 (OVERVIEW OF CHANGES) Major changes have been made to the post office, however the interface to the user agents has not changed. Some of the major changes include: * SMTP documentation Documentation on interfacing with IBM's TCP/IP is now included. * BSMTP processing The post office BSMTP processing now supports IBM's TCP/IP SMTP "NEW" mailer format. * improved RFC822 header parsing Most folded lines are now processed correctly. Multi-hop routes can now be parsed (only the last hop is used). * Domain support The post office now supports domain style naming in a more general way then previously. This includes *.domain matching. * Bitnet table support A new utility OFCBIT is supplied to process the BITNET BITEARN NODES table and create a post office routing member. * PROFS A protocol to simulate PROFS format has been added. This greatly improves the look of messages sent to PROFS nodes. * Many bug fixes/small enhancements. DISTRIBUTION TAPE FORMAT The distribution tape is standard label. The first file of the tape contains the JCL required to load the entire tape. Most of the files after the first are IEBCOPY unloaded partitioned datasets. file 1 DSN=TAPEJCL LRECL 80, RECFM FB, BLKSIZE 6160 (sequential)