home *** CD-ROM | disk | FTP | other *** search
/ Super Net 1 / SUPERNET_1.iso / PC / OTROS / EXTRAS / UUCODE / UUPC / HOWTOGET.TXT < prev    next >
Encoding:
Text File  |  1993-10-04  |  14.4 KB  |  399 lines
  1. Introduction
  2.  
  3. UUPC/extended is a PC based version (and pun of) UUCP (UNIX-to- UNIX
  4. copy).  UUPC/extended is a program which implements peer-to- peer
  5. networking for using the UNIX UUCP protocols.  MS-DOS or OS/2 based
  6. Personal Computers using these protocols can exchange mail and files
  7. with a UNIX system or other UUPC/extended systems over dial up or
  8. dedicated phone lines.
  9.  
  10. UUPC/extended 1.12b is available via:
  11.  
  12.   Automated mail server running at Kendra Electronic Wonderworks.
  13.   Clarkson University BBS
  14.   Anonymous UUCP from kewgate, Kendra Electronic Wonderworks's file server
  15.   BIX
  16.   CompuServe
  17.   Ordering floppies by mail from Crynwr Software
  18.   Registering your current copy
  19.  
  20.     Note: Because of time and disk space restrictions, we do not
  21.           manually e-mail copies of the source or executables,
  22.           provide custom .ARC or .ZIP files with only a limited
  23.           set of the files, or provide other custom distribution
  24.           services-- please don't ask.
  25.  
  26. Instructions
  27.  
  28. Anonymous FTP
  29.  
  30. UUPC/extended is available from the following anonymous FTP site:
  31.  
  32.   ftp.clarkson.edu, IP address  128.153.4.2, directory pub/uupc
  33.  
  34. FTP programs vary from system to system; contact your local system
  35. support staff for instructions on anonymous FTP.
  36.  
  37. Kendra Electronic Wonderworks archive server
  38.  
  39. Send a mail message containing the commands "index" and/or "help", one
  40. command per line, in the body of the message to listserv@kew.com for the
  41. current file list and/or instructions.
  42.  
  43. Clarkson University Bulletin Board
  44.  
  45. The Clarkson University Bulletin Board is reached 24 hours a day at
  46. (315)268-6667, 8N1, 1200/2400 Baud.  Follow the instructions after logon
  47. to download files.
  48.  
  49. Anonymous Kermit
  50.  
  51. Alas, because of conflicts between UUCICO and C-Kermit under OS/2,
  52. kendra's anonymous Kermit server has gone to the great lily pad in the
  53. sky.  Use anonymous UUCP, below, instead.
  54.  
  55. Anonymous UUCP
  56.  
  57. The UUPC/extended files are archived in the directory "~nuucp" on
  58. kewgate and can be downloaded via anonymous UUCP.  To use anonymous
  59. UUCP, define entries for the system kewgate in your SYSTEMS file and
  60. PERMISSN file.  The SYSTEMS file entry should define the phone number as
  61. 1-617-641-4817, the user id as "nuucp", and the password as "nuucp".
  62. kewgate uses a Zoom Telephonics V.32bis modem, so connect speed may be
  63. up to 14400 baud, depending on your modem. kewgate presently accepts
  64. anonymous UUCP phone calls 24 hours a day, seven days a week, except for
  65. interruptions for system maintenance.  We reserve the right to change
  66. these hours without notice.
  67.  
  68.     Note: The sample systems file in the documentation archive
  69.           includes an entry for kewgate.
  70.  
  71.     Note: You cannot send mail or files to kewgate via the
  72.           anonymous dial-in.  Send mail to help@kew.com, our
  73.           normal email address.
  74.  
  75. The files are located in the home directory for nuucp, so files should
  76. be requested via the UUCP command with the syntax ~nuucp/filename.  For
  77. example, to retrieve the index for the archive to your local /tmp
  78. directory, issue the command:
  79.  
  80.      uucp  kewgate!~nuucp/index  /tmp/
  81.  
  82. The UUCICO program must then be invoked to actually process the
  83. request.  Users should retrieve the file index first, and then
  84. issue additional requests for the actual files wanted based on
  85. the current directory listing.
  86.  
  87.     Note: Do not use a debug level greater than 3 when calling
  88.           kewgate.  To avoid filling the hard drive on kewgate
  89.           with useless debugging information, the system will
  90.           automatically hang up on you.
  91.  
  92. BIX
  93.  
  94. Douglas Hamilton of Hamilton Laboratories posts UUPC/extended to the
  95. ibm.os2/listings area on BIX.  For additional information, contact him
  96. (userid hamilton) on BIX.  Tell him Snuffles sent you.
  97.  
  98. CompuServe
  99.  
  100. The archives are loaded to CompuServe's UNIX Forum (GO CIS:UNIXFORUM).
  101. The files can be searched for within the forum using the keyword UUPC.
  102. As not every release is loaded to CompuServe, contact the UUPC/extended
  103. Help desk (from CompuServe, >Internet:  help@kew.com) before downloading
  104. files from CIS which are more than two months old.
  105.  
  106. Because of CompuServe's six character limit on file names, the files
  107. uploaded to CompuServe do not follow the normal UUPC/extended naming
  108. convention described below.  Rather, the files are named UUPCx.nnn,
  109. where 'x' is the archive suffix as described below and 'nnn' is the
  110. version number.  Files should be downloaded as UUPCnnnx.ZIP to restore
  111. their normal DOS names.
  112.  
  113. Registering your current copy
  114.  
  115. To receive a copy of the next major release when it becomes available,
  116. register your current copy according to the instructions in How to
  117. Register UUPC/extended.  You can also order the current release from us
  118. using the form in How to Register UUPC/extended.
  119.  
  120. About the files
  121.  
  122. The available UUPC/extended files include:
  123.  
  124. Name            Description
  125.  
  126. index          The current directory listing for the
  127.                UUPC/extended archive. (Only available on
  128.                kewgate and the various Clarkson systems)
  129.  
  130. upc12bad.zip   Formatted documentation files for UUPC/extended
  131.  
  132. upc12baw.zip   Word for Windows documentation source files for
  133.                UUPC/extended
  134.  
  135. upc12bap.zip   Documentation files formatted for a PostScript
  136.                printer
  137.  
  138. upc12bd1.zip   Executable files for MS-DOS, 1 of 3
  139.  
  140. upc12bd2.zip   Executable files for MS-DOS, 2 of 3.
  141.  
  142. upc12bd3.zip   Executable files for MS-DOS, 3 of 3.
  143.  
  144. upc12bw1.zip   Executable files for Windows 3.x, 1 of 3.
  145.  
  146. upc12bw2.zip   Executable files for Windows 3.x, 2 of 3.
  147.  
  148. upc12bw3.zip   Executable files for Windows 3.x, 3 of 3.
  149.  
  150. upc12b11.zip   Executable files for 16 bit OS/2 (version 1.x),
  151.                1 of 3.
  152.  
  153. upc12b12.zip   Executable files for 16 bit OS/2 (version 1.x),
  154.                2 of 3.
  155.  
  156. upc12b13.zip   Executable files for 16 bit OS/2 (version 1.x),
  157.                2 of 3.
  158.  
  159. upc12b21.zip   Executable files for 32 bit OS/2 (version 2.x),
  160.                1 of 3.
  161.  
  162. upc12b22.zip   Executable files for 32 bit OS/2 (version 2.x),
  163.                2 of 3.
  164.  
  165. upc12b23.zip   Executable files for 32 bit OS/2 (version 2.x),
  166.                3 of 3.
  167.  
  168. upc12bn1.zip   Executable files for Windows NT for Intel x86, 1
  169.                of 3.
  170.  
  171. upc12bn2.zip   Executable files for Windows NT for Intel x86, 2
  172.                of 3.
  173.  
  174. upc12bn3.zip   Executable files for Windows NT for Intel x86, 3
  175.                of 3.
  176.  
  177. upc12bs1.zip   Source files for UUPC/extended, 1 of 2.
  178.  
  179. upc12bs2.zip   Source files for UUPC/extended, 2 of 2.
  180.  
  181. howtoget.txt   This file.  (Only available on kewgate and
  182.                various Clarkson systems)
  183.  
  184. announce.txt   A summary of the newest release.  This file is
  185.                generally an abridged version of the current
  186.                CHANGES.PRN file included in the documentation
  187.                archive. This file is not created if the current
  188.                release has limited changes.  For all releases,
  189.                CHANGES.PRN is the definitive summary of
  190.                changes.  (Only available on kewgate and various
  191.                Clarkson systems)
  192.  
  193.     Note: MS-DOS users will want upc12bd1.zip, upc12bd2.zip,
  194.           upc12bd3.zip, and upc12bad.zip.
  195.  
  196.     Note: OS/2 users will want upc12b21.zip, upc12b22.zip,
  197.           upc12b23.zip, and upc12bad.zip.
  198.  
  199.     Note: Windows NT users will want upc12bn1.zip, upc12bn2.zip,
  200.           upc12bn3.zip, and upc12bad.zip.
  201.  
  202. The files names change with each release to include the current
  203. release number in the file name.  For example, the source archive
  204. for version 1.24b would be upc24bs1.zip.
  205.  
  206. From time to time, test releases are loaded to kewgate and/or the
  207. various Clarkson systems.  These releases are placed in a sub-
  208. directory on the Clarkson file server and in the same directory
  209. as the production directory on kewgate.
  210.  
  211. Formatted Documentation Archive Contents
  212.  
  213. The documentation archive includes both the formatted documents
  214. describing UUPC/extended and various configuration files.  Most
  215. of the configuration files are samples and must be modified to be
  216. used. The files in the documentation archive are as follows:
  217.  
  218.  
  219.      REGISTER.PRN describes how to register UUPC/extended to
  220.      encourage us to keep putting out this insanity.
  221.  
  222.     Note: You do not have to register to UUPC/extended to use it
  223.           or give it to others.
  224.  
  225.      INSTALL.PRN tells how to install or upgrade UUPC/extended
  226.      once you have read README.PRN.
  227.  
  228.      COMMANDS.PRN summarizes the commands supplied with
  229.      UUPC/extended, information on how to use most of them, and
  230.      instructions on where to find information on the other
  231.      commands.
  232.  
  233.      HOWTOGET.PRN (this file) describes how and where to get a
  234.      new version of UUPC/extended.
  235.  
  236.      CHANGES.PRN is a list of recent changes to UUPC/extended
  237.      (fixed bugs and enhancements).
  238.  
  239.      MAIL.PRN is the documentation file for the MAIL command.
  240.  
  241.      TILDE.PRN is used to generate a text file printed by the
  242.      help (~?) command when sending mail.
  243.  
  244.      UUSTAT.PRN is the documentation for the UUSTAT program.
  245.  
  246.      BUGS.PRN is a list of known bugs in UUPC/extended.
  247.  
  248.      UUPC.RC defines the system information related to
  249.      UUPC/extended, such as the system name and work directories.
  250.      Only one UUPC.RC file should exist per PC.
  251.  
  252.      PERSONAL.RC defines the user information related to UUCP,
  253.      such the user id, (mailbox) of the user, the user's full
  254.      name, and the directory to store mail in.  If several people
  255.      share the same PC, then multiple PERSONAL.RC files may exist
  256.      under different names.
  257.  
  258.      PERSONAL.SIG is a sample signature file, which is appended
  259.      to each mail file you send. Use of this file is optional,
  260.      but highly recommended.
  261.  
  262.      SYSTEMS defines the telephone numbers and login information
  263.      for other computers the local PC can call.
  264.  
  265.      PASSWD defines both remote systems that can call the local
  266.      PC and all local users.
  267.  
  268.      PERMISSN defines access for remote systems accessing your
  269.      system via UUPC/extended.  It is based on the format of the
  270.      UUCP PERMISSIONS file.
  271.  
  272.      SAMPLE.MDM is a heavily commented modem configuration file
  273.      which explains the use of the various fields in modem
  274.      configuration files.  Other modem files are also included.
  275.  
  276.      HOSTPATH defines routing for hosts that are not directly
  277.      connected to the PC.
  278.  
  279.      ALIASES.TXT defines short aliases for common addresses,
  280.      allowing a short nickname to be used in place of the full
  281.      name and mail address of a person.
  282.  
  283. The following programs are included in the UPCxxxD1, UPCxxxW1,
  284. UPCxxx21 and UPCxxxN1archives:
  285.  
  286.      MAIL.EXE is the mail user agent (MUA); it is used for both
  287.      sending and receiving mail.
  288.  
  289.      UUCICO.EXE acts the mail transport agent by exchanging files
  290.      with other systems via the serial port (modem).  It can both
  291.      call out (active polling) and wait for another system to
  292.      call (passive polling).
  293.  
  294.      UUXQT.EXE processes requests received via UUCICO, invoking
  295.      RMAIL.EXE or other programs to process data.  It should be
  296.      run after each UUCICO.EXE invocation.
  297.  
  298.      RMAIL.EXE is called by both MAIL.EXE and UUXQT.EXE to
  299.      deliver mail; as such, it must be called RMAIL.EXE.
  300.  
  301.     Note: There are no .COM files in the OS/2 or Windows NT
  302.           archives; all the OS/2 and Windows NT files have .EXE
  303.           extensions.
  304.  
  305. Program Archive 2 of 3
  306.  
  307. The following programs are included in the UPCxxxD2, UPCxxxW2,
  308. UPCxxx22 and UPCxxxN2 archives:
  309.  
  310.      FMT.COM is a simple program to format text by wrapping it
  311.      after 72 columns.
  312.  
  313.      GENSIG.COM randomly appends quotes or other user selected
  314.      text to the end of a fixed signature file.
  315.  
  316.      NOVRSTRK.COM is a program which removes overstrikes from
  317.      files for viewing on a terminal.  It's use is described
  318.      above, and is optional.
  319.  
  320.      UUPOLL.EXE serves as a driver for UUCICO and UUXQT, invoking
  321.      UUCICO to answer the phone and/or dial out on regular basis
  322.      and then automatically invoking UUXQT to process any files
  323.  
  324.      received; this permits unattended operation of
  325.      UUPC/extended, allowing it, for example, to call another
  326.      system in the middle of the night.
  327.  
  328.      UUCP.COM copies binary files between two systems without
  329.      going through mail.
  330.  
  331.      UUSTAT.COM is a utility to report on and update the status
  332.      of jobs queued for other systems.
  333.  
  334.      UUSUB.COM reports and optionally clears statistics on the
  335.      amount of data transferred between systems.
  336.  
  337.      SU.BAT  is a sample command file for changing the active
  338.      user.
  339.  
  340.      UUCLEAN.BAT is a sample command file which deletes old logs
  341.      and temporary files from the UUPC/extended spool and
  342.      temporary directories.
  343.  
  344.      UUIO.BAT is a sample command file for running UUCICO and
  345.      UUXQT in sequence.
  346.  
  347.     Note: There are no .COM or .BAT files in the OS/2 and Windows
  348.           NT archives.  All the OS/2 and Windows NT files have
  349.           .EXE or .CMD extensions.
  350.  
  351. Program Archive 3 of 3
  352.  
  353. The following programs are included in both the UPCxxxD3,
  354. UPCxxxW3, UPCxxx23 and UPCxxxN3 archives:
  355.  
  356.      RNEWS processes incoming news from other systems, and is
  357.      normally never directly invoked by the user.  It is invoked
  358.      automatically by UUXQT upon the arrival of news at the local
  359.      system.
  360.  
  361.      EXPIRE archives and/or deletes articles created by RNEWS in
  362.      normal mode after a specified period of days.
  363.  
  364. Source Archives
  365.  
  366. The source archives include all of the files needed to build
  367. UUPC/extended under DOS using Borland C++ 3.1.  The program can also be
  368. built under DOS or OS/2 using Microsoft C 6.0.  Microsoft Macro
  369. Assembler is required if building the DOS modules with the Microsoft C
  370. compiler.
  371.  
  372.     Note: The upc12bs.zip file should be PKUNZIPed with the
  373.           unpack directory (-d) option.
  374.  
  375. Unformatted Documentation Archive
  376.  
  377. The unformatted documentation archive includes all of the Word for
  378. Windows (2.0) files and templates used to create the formatted documents
  379. in the regular documentation archive.
  380.  
  381. Other Trivia
  382.  
  383. Special Thanks
  384.  
  385. Russ Nelson and Keith Petersen have aided us in getting many of the past
  386. releases out to the public.  Thanks Clarkson University's Educational
  387. Resources Center, with special attention to Brad Clements and Bob
  388. Barringer, for providing upload and anonymous FTP facilities.
  389.  
  390. A final thanks to Shawn McKay and Alan Steele of the Massachusetts
  391. Institute of Technology and eddie.mit.edu for handling kendra's Internet
  392. mail forwarding (including all those questions to help@kew.com).
  393.  
  394. Questions and Comments
  395.  
  396. Please direct all questions on retrieving UUPC/extended to help@kew.com.
  397. Within the United States, we will help you get a current copy of this
  398. document if you call us at our voice number, (617) 641-3452.
  399.