Introduction UUPC/extended is a PC based version (and pun of) UUCP (UNIX-to- UNIX copy). UUPC/extended is a program which implements peer-to- peer networking for using the UNIX UUCP protocols. MS-DOS or OS/2 based Personal Computers using these protocols can exchange mail and files with a UNIX system or other UUPC/extended systems over dial up or dedicated phone lines. UUPC/extended 1.12b is available via: Automated mail server running at Kendra Electronic Wonderworks. Clarkson University BBS Anonymous UUCP from kewgate, Kendra Electronic Wonderworks's file server BIX CompuServe Ordering floppies by mail from Crynwr Software Registering your current copy Note: Because of time and disk space restrictions, we do not manually e-mail copies of the source or executables, provide custom .ARC or .ZIP files with only a limited set of the files, or provide other custom distribution services-- please don't ask. Instructions Anonymous FTP UUPC/extended is available from the following anonymous FTP site: ftp.clarkson.edu, IP address 128.153.4.2, directory pub/uupc FTP programs vary from system to system; contact your local system support staff for instructions on anonymous FTP. Kendra Electronic Wonderworks archive server Send a mail message containing the commands "index" and/or "help", one command per line, in the body of the message to listserv@kew.com for the current file list and/or instructions. Clarkson University Bulletin Board The Clarkson University Bulletin Board is reached 24 hours a day at (315)268-6667, 8N1, 1200/2400 Baud. Follow the instructions after logon to download files. Anonymous Kermit Alas, because of conflicts between UUCICO and C-Kermit under OS/2, kendra's anonymous Kermit server has gone to the great lily pad in the sky. Use anonymous UUCP, below, instead. Anonymous UUCP The UUPC/extended files are archived in the directory "~nuucp" on kewgate and can be downloaded via anonymous UUCP. To use anonymous UUCP, define entries for the system kewgate in your SYSTEMS file and PERMISSN file. The SYSTEMS file entry should define the phone number as 1-617-641-4817, the user id as "nuucp", and the password as "nuucp". kewgate uses a Zoom Telephonics V.32bis modem, so connect speed may be up to 14400 baud, depending on your modem. kewgate presently accepts anonymous UUCP phone calls 24 hours a day, seven days a week, except for interruptions for system maintenance. We reserve the right to change these hours without notice. Note: The sample systems file in the documentation archive includes an entry for kewgate. Note: You cannot send mail or files to kewgate via the anonymous dial-in. Send mail to help@kew.com, our normal email address. The files are located in the home directory for nuucp, so files should be requested via the UUCP command with the syntax ~nuucp/filename. For example, to retrieve the index for the archive to your local /tmp directory, issue the command: uucp kewgate!~nuucp/index /tmp/ The UUCICO program must then be invoked to actually process the request. Users should retrieve the file index first, and then issue additional requests for the actual files wanted based on the current directory listing. Note: Do not use a debug level greater than 3 when calling kewgate. To avoid filling the hard drive on kewgate with useless debugging information, the system will automatically hang up on you. BIX Douglas Hamilton of Hamilton Laboratories posts UUPC/extended to the ibm.os2/listings area on BIX. For additional information, contact him (userid hamilton) on BIX. Tell him Snuffles sent you. CompuServe The archives are loaded to CompuServe's UNIX Forum (GO CIS:UNIXFORUM). The files can be searched for within the forum using the keyword UUPC. As not every release is loaded to CompuServe, contact the UUPC/extended Help desk (from CompuServe, >Internet: help@kew.com) before downloading files from CIS which are more than two months old. Because of CompuServe's six character limit on file names, the files uploaded to CompuServe do not follow the normal UUPC/extended naming convention described below. Rather, the files are named UUPCx.nnn, where 'x' is the archive suffix as described below and 'nnn' is the version number. Files should be downloaded as UUPCnnnx.ZIP to restore their normal DOS names. Registering your current copy To receive a copy of the next major release when it becomes available, register your current copy according to the instructions in How to Register UUPC/extended. You can also order the current release from us using the form in How to Register UUPC/extended. About the files The available UUPC/extended files include: Name Description index The current directory listing for the UUPC/extended archive. (Only available on kewgate and the various Clarkson systems) upc12bad.zip Formatted documentation files for UUPC/extended upc12baw.zip Word for Windows documentation source files for UUPC/extended upc12bap.zip Documentation files formatted for a PostScript printer upc12bd1.zip Executable files for MS-DOS, 1 of 3 upc12bd2.zip Executable files for MS-DOS, 2 of 3. upc12bd3.zip Executable files for MS-DOS, 3 of 3. upc12bw1.zip Executable files for Windows 3.x, 1 of 3. upc12bw2.zip Executable files for Windows 3.x, 2 of 3. upc12bw3.zip Executable files for Windows 3.x, 3 of 3. upc12b11.zip Executable files for 16 bit OS/2 (version 1.x), 1 of 3. upc12b12.zip Executable files for 16 bit OS/2 (version 1.x), 2 of 3. upc12b13.zip Executable files for 16 bit OS/2 (version 1.x), 2 of 3. upc12b21.zip Executable files for 32 bit OS/2 (version 2.x), 1 of 3. upc12b22.zip Executable files for 32 bit OS/2 (version 2.x), 2 of 3. upc12b23.zip Executable files for 32 bit OS/2 (version 2.x), 3 of 3. upc12bn1.zip Executable files for Windows NT for Intel x86, 1 of 3. upc12bn2.zip Executable files for Windows NT for Intel x86, 2 of 3. upc12bn3.zip Executable files for Windows NT for Intel x86, 3 of 3. upc12bs1.zip Source files for UUPC/extended, 1 of 2. upc12bs2.zip Source files for UUPC/extended, 2 of 2. howtoget.txt This file. (Only available on kewgate and various Clarkson systems) announce.txt A summary of the newest release. This file is generally an abridged version of the current CHANGES.PRN file included in the documentation archive. This file is not created if the current release has limited changes. For all releases, CHANGES.PRN is the definitive summary of changes. (Only available on kewgate and various Clarkson systems) Note: MS-DOS users will want upc12bd1.zip, upc12bd2.zip, upc12bd3.zip, and upc12bad.zip. Note: OS/2 users will want upc12b21.zip, upc12b22.zip, upc12b23.zip, and upc12bad.zip. Note: Windows NT users will want upc12bn1.zip, upc12bn2.zip, upc12bn3.zip, and upc12bad.zip. The files names change with each release to include the current release number in the file name. For example, the source archive for version 1.24b would be upc24bs1.zip. From time to time, test releases are loaded to kewgate and/or the various Clarkson systems. These releases are placed in a sub- directory on the Clarkson file server and in the same directory as the production directory on kewgate. Formatted Documentation Archive Contents The documentation archive includes both the formatted documents describing UUPC/extended and various configuration files. Most of the configuration files are samples and must be modified to be used. The files in the documentation archive are as follows: REGISTER.PRN describes how to register UUPC/extended to encourage us to keep putting out this insanity. Note: You do not have to register to UUPC/extended to use it or give it to others. INSTALL.PRN tells how to install or upgrade UUPC/extended once you have read README.PRN. COMMANDS.PRN summarizes the commands supplied with UUPC/extended, information on how to use most of them, and instructions on where to find information on the other commands. HOWTOGET.PRN (this file) describes how and where to get a new version of UUPC/extended. CHANGES.PRN is a list of recent changes to UUPC/extended (fixed bugs and enhancements). MAIL.PRN is the documentation file for the MAIL command. TILDE.PRN is used to generate a text file printed by the help (~?) command when sending mail. UUSTAT.PRN is the documentation for the UUSTAT program. BUGS.PRN is a list of known bugs in UUPC/extended. UUPC.RC defines the system information related to UUPC/extended, such as the system name and work directories. Only one UUPC.RC file should exist per PC. PERSONAL.RC defines the user information related to UUCP, such the user id, (mailbox) of the user, the user's full name, and the directory to store mail in. If several people share the same PC, then multiple PERSONAL.RC files may exist under different names. PERSONAL.SIG is a sample signature file, which is appended to each mail file you send. Use of this file is optional, but highly recommended. SYSTEMS defines the telephone numbers and login information for other computers the local PC can call. PASSWD defines both remote systems that can call the local PC and all local users. PERMISSN defines access for remote systems accessing your system via UUPC/extended. It is based on the format of the UUCP PERMISSIONS file. SAMPLE.MDM is a heavily commented modem configuration file which explains the use of the various fields in modem configuration files. Other modem files are also included. HOSTPATH defines routing for hosts that are not directly connected to the PC. ALIASES.TXT defines short aliases for common addresses, allowing a short nickname to be used in place of the full name and mail address of a person. The following programs are included in the UPCxxxD1, UPCxxxW1, UPCxxx21 and UPCxxxN1archives: MAIL.EXE is the mail user agent (MUA); it is used for both sending and receiving mail. UUCICO.EXE acts the mail transport agent by exchanging files with other systems via the serial port (modem). It can both call out (active polling) and wait for another system to call (passive polling). UUXQT.EXE processes requests received via UUCICO, invoking RMAIL.EXE or other programs to process data. It should be run after each UUCICO.EXE invocation. RMAIL.EXE is called by both MAIL.EXE and UUXQT.EXE to deliver mail; as such, it must be called RMAIL.EXE. Note: There are no .COM files in the OS/2 or Windows NT archives; all the OS/2 and Windows NT files have .EXE extensions. Program Archive 2 of 3 The following programs are included in the UPCxxxD2, UPCxxxW2, UPCxxx22 and UPCxxxN2 archives: FMT.COM is a simple program to format text by wrapping it after 72 columns. GENSIG.COM randomly appends quotes or other user selected text to the end of a fixed signature file. NOVRSTRK.COM is a program which removes overstrikes from files for viewing on a terminal. It's use is described above, and is optional. UUPOLL.EXE serves as a driver for UUCICO and UUXQT, invoking UUCICO to answer the phone and/or dial out on regular basis and then automatically invoking UUXQT to process any files received; this permits unattended operation of UUPC/extended, allowing it, for example, to call another system in the middle of the night. UUCP.COM copies binary files between two systems without going through mail. UUSTAT.COM is a utility to report on and update the status of jobs queued for other systems. UUSUB.COM reports and optionally clears statistics on the amount of data transferred between systems. SU.BAT is a sample command file for changing the active user. UUCLEAN.BAT is a sample command file which deletes old logs and temporary files from the UUPC/extended spool and temporary directories. UUIO.BAT is a sample command file for running UUCICO and UUXQT in sequence. Note: There are no .COM or .BAT files in the OS/2 and Windows NT archives. All the OS/2 and Windows NT files have .EXE or .CMD extensions. Program Archive 3 of 3 The following programs are included in both the UPCxxxD3, UPCxxxW3, UPCxxx23 and UPCxxxN3 archives: RNEWS processes incoming news from other systems, and is normally never directly invoked by the user. It is invoked automatically by UUXQT upon the arrival of news at the local system. EXPIRE archives and/or deletes articles created by RNEWS in normal mode after a specified period of days. Source Archives The source archives include all of the files needed to build UUPC/extended under DOS using Borland C++ 3.1. The program can also be built under DOS or OS/2 using Microsoft C 6.0. Microsoft Macro Assembler is required if building the DOS modules with the Microsoft C compiler. Note: The upc12bs.zip file should be PKUNZIPed with the unpack directory (-d) option. Unformatted Documentation Archive The unformatted documentation archive includes all of the Word for Windows (2.0) files and templates used to create the formatted documents in the regular documentation archive. Other Trivia Special Thanks Russ Nelson and Keith Petersen have aided us in getting many of the past releases out to the public. Thanks Clarkson University's Educational Resources Center, with special attention to Brad Clements and Bob Barringer, for providing upload and anonymous FTP facilities. A final thanks to Shawn McKay and Alan Steele of the Massachusetts Institute of Technology and eddie.mit.edu for handling kendra's Internet mail forwarding (including all those questions to help@kew.com). Questions and Comments Please direct all questions on retrieving UUPC/extended to help@kew.com. Within the United States, we will help you get a current copy of this document if you call us at our voice number, (617) 641-3452.