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.
