home *** CD-ROM | disk | FTP | other *** search
/ Carousel / CAROUSEL.cdr / mactosh / tech / siminfo < prev    next >
Text File  |  1987-05-30  |  16KB  |  361 lines
  1.  
  2. ----------
  3.  
  4.                          THE SIMTEL20 ARCHIVES
  5.  
  6.                                OVERVIEW
  7.  
  8. There is a collossal amount of free public domain software for the
  9. CP/M, PCDOS/MSDOS, UNIX and MACINTOSH operating systems, and for the DoD standard programming language, Ada, in several archives on SIMTEL20.ARPA, a
  10. DECSYSTEM-20 running the TOPS-20 operating system at White Sands
  11. Missile Range.
  12.  
  13. To obtain a directory listing of interest to you, send your request to
  14. ARCHIVE-REQUEST@SIMTEL20 with up to five of the following commands
  15. in the body of any one message:
  16.  
  17. SEND PD:<CPM>CPM.CRCLST
  18. SEND PD:<CPMUG>CPMUG.CRCLST
  19. SEND PD:<SIGM>SIGM.CRCLST
  20. SEND PD:<PC-BLUE>PC-BLUE.CRCLST
  21. SEND PD:<MSDOS>MSDOS.CRCLST
  22. SEND PD:<MACINTOSH>MACINTOSH.CRCLST
  23. SEND PD:<UNIX>UNIX.CRCLST
  24. SEND PD:<ADA>ADA.CRCLST
  25. SEND PD:<MISC>MISC.CRCLST
  26.  
  27. The PD:<CPM> archive is the one to watch for the very latest CP/M
  28. offerings, as it is updated frequently.  The PD:<CPMUG>, PD:<SIGM> and
  29. PD:<PC-BLUE> archives contain software distributed by the CP/M Users
  30. Group, the SIG/M Users Group and the PC-Blue Users Group respectively.
  31. This software is available on diskettes from the associated users
  32. groups, and the archives are updated as new volumes are issued.
  33.  
  34. The PD:<PC-BLUE> archive contains software for the IBM-PC and similar
  35. machines.  Some runs under CP/M, and some under PCDOS/MSDOS.  The
  36. PD:<MSDOS> archive also contains software for the MSDOS and PCDOS
  37. operating systems; but this archive is locally managed, and therefore
  38. is updated more frequently than the PD:<PC-BLUE> archive.
  39.  
  40. The PD:<UNIX> archive contains a variety of UNIX tools.  Those which
  41. apply specifically to CP/M are in the directory PD:<UNIX.CPM>.
  42.  
  43. The PD:<ADA> archive is growing rapidly.  Information about this
  44. archive is in directory PD:<ADA.GENERAL>.
  45.  
  46. The PD:<MACINTOSH> archive is the youngest and perhaps the smallest
  47. archive in the PD area. All of the material has been given to us by other
  48. HostUs or from Apple Macintsoh Users Groups.
  49.  
  50. In general, the archived software is very good, having been
  51. worked-over and refined by many users.  The documentation and comments
  52. tend to be complete and informative.  Files in all of these archives
  53. can be obtained using the ARCHIVE-REQUEST procedures described in this
  54. message.
  55.  
  56.                               DISCLAIMER
  57.  
  58. Please note that due to the large number of files available, the
  59. archive maintainers cannot possibly attempt to validate the proper
  60. operation of the various programs.  When a program bug is reported,
  61. immediate action is taken to either correct the error or remove the
  62. offending program from the archives.  Still, users must understand
  63. that all archive programs are offered AS-IS, and the archive
  64. maintainers specifically disclaim any liability should these programs
  65. malfunction or cause damage, incidental or otherwise.  When testing
  66. ANY new software, be certain that all information stored on disk is
  67. backed-up before you start, so that you can recover if files are
  68. damaged or erased.  This is particularly true if you have a hard disk,
  69. in which case malfunctions can be spectacularly disasterous.
  70.  
  71.  
  72.                      HOW TO USE ARCHIVE-REQUEST
  73.  
  74. To obtain up to five files in a single request message by netmail from
  75. the public domain archives kept on SIMTEL20.ARPA, send a message to:
  76.  
  77. ARCHIVE-REQUEST@SIMTEL20.ARPA
  78.  
  79. or via uucp:
  80.    ...!ucbvax!simtel20.arpa!archive-request
  81.    ...!uw-beaver!simtel20.arpa!archive-request
  82.    ...!decwrl!simtel20.arpa!archive-request
  83.    ...!lll-lcc!simtel20.arpa!archive-request
  84.    ...!ut-sally!simtel20.arpa!archive-request
  85.    ...!harvard!simtel20.arpa!archive-request
  86.  
  87. [do NOT use host "seismo" - they are blocking messages from the server]
  88.  
  89. The message body must contain lines beginning with the keyword SEND,
  90. one SEND line for each file requested.  Case is not significant.
  91.  
  92. The general syntax of a SEND line is:
  93.  
  94. SEND format filename
  95.  
  96. In general, a filename consists of the following components:
  97.  
  98. device:<directory>file.type.generation
  99.  
  100. "device:" is usually PD:, and the combination of PD:<directory> is
  101. expected unless an alias has been advertised of the form "alias:",
  102. which takes the place of both device and directory fields.  The
  103. generation field should be left off in order to default to the highest
  104. generation number so you can be sure of getting the latest version of
  105. the file requested.  "file.type" follows the usual filenaming
  106. conventions.
  107.  
  108. In all formats listed below, if the file to be sent is larger than
  109. 55K, the file is sent in numbered parts.  The parts must be
  110. reassembled in order and edited to remove any headers, preface, and
  111. trailers before the process can be reversed to reconstruct the
  112. original file.
  113.  
  114. Allowable formats are:
  115.  
  116. SEND HELP
  117.         This section you are reading now.
  118.  
  119. SEND INFO
  120.         This file you are reading now.
  121.  
  122. SEND BOOTSTRAP
  123.         A brief quick reference listing of filenames of the key
  124.         utilities used to reconstruct files sent by the compression
  125.         and encoding techniques listed below.
  126.  
  127. SEND DIR filespec
  128.         This format returns a CRC list of the requested files, and is
  129.         the only format which allows wildcard filenames (but not
  130.         wildcard directory names).  The list is sent as an ASCII text
  131.         file.  The wildcard characters are "*" and "%".  The asterisk
  132.         means any number of characters, while the percent sign means
  133.         exactly one character.  Either or both may appear in any
  134.         combination in either or both the file or type fields, while
  135.         only the asterisk may appear in the generation field.
  136.  
  137. SEND RAW filename
  138.         If the file is ASCII, it is sent as-is, regardless of size.
  139.         This format is the least efficient over network and mail
  140.         gateway resources.  Use this format only if you absolutely
  141.         must.
  142.  
  143. SEND DET filename
  144. Same as RAW, except the file is detabified.
  145.  
  146. With the four formats listed below, if the file is ASCII and under 25k
  147. characters, it is sent as-is, as if RAW format was requested.  Binary
  148. files are always processed according to the requested format.
  149. However, a request for ARC or SQ processing of files with type ".ARC",
  150. ".LBR", or ".%Q%" is ignored and the original file is either uuencoded
  151. or hexified (if possible), according to the requested format.  If the
  152. file was not sent RAW, a short preface is inserted at the front of the
  153. message describing the process actually taken and a CRC entry
  154. describing the original file.
  155.  
  156. SEND ARE filename  or  SEND filename
  157.         The original file is made into a uuencoded ARC file.
  158.  
  159. SEND ARH filename
  160.         The original file is made into a hexified ARC file if the ARC
  161.         file is under 64K bytes long.  Otherwise, an apology is
  162.         returned instead of the requested file.
  163.  
  164. SEND SQE filename
  165.         The original file is made into a uuencoded SQueezed file.
  166.  
  167. SEND SQH filename
  168.         The original file is made into a hexified SQueezed file if the
  169.         Squeezed file is under 64K bytes long.  Otherwise, an apology
  170.         is returned instead of the requested file.
  171.  
  172. ARCHIVE-REQUEST is actually a batch job that reschedules itself for
  173. one hour later after it has completed the current batch.  This
  174. frequency may be changed, depending on volume and system load.
  175.  
  176.  
  177.                               FILE TYPES
  178.  
  179. Squeezed files have been compressed using programs available in
  180. directory PD:<CPM.SQUSQ> to obtain an approximate 35-percent size
  181. reduction.  These files can be identified by the letter Q in the
  182. extension field.  For example, the file PD:<CPM.ASMUTL>RMACPAT.AQM is
  183. a squeezed file.  It must be transferred as a binary file, and then
  184. unsqueezed.  The unsqueezing can be done on a CP/M system using
  185. USQ-xx.COM (where "xx" is the current version) from directory
  186. PD:<CPM.SQUSQ>, or there are several host-based unsqueezers in the
  187. PD:<CPM> and PD:<UNIX> archives (see for example, directories
  188. PD:<MISC.TOPS-20> and PD:<UNIX.CPM>).
  189.  
  190. CP/M library files (those with names ending in LBR) combine several
  191. regular CP/M files into a single BINARY file which contains an
  192. internal directory of its contents.  They are created using the CP/M
  193. library utility LUxxx.COM (where "xxx" is the current version) or some
  194. other compatible utility.  The complete packages for LUxxx and a newer
  195. compatible program called NULUxx (where "xx" is the version) can be
  196. found in directory PD:<CPM.CPMLIB>.  C-language source code for a
  197. compatible UNIX utility called LAR (library archiver) is in directory
  198. PD:<UNIX.CPM>.
  199.  
  200. Important files in the PD:<CPMUG> and PD:<PC-BLUE> archives are the
  201. CATALOG files.  These files contain the "-CATALOG.nnn" files from all
  202. the volumes of their respective archives.  To obtain these composite
  203. catalog files, send a message to ARCHIVE-REQUEST@SIMTEL20 with the
  204. message body containing either or both of the following requests:
  205.  
  206. SEND PD:<CPMUG>CPMUG.CAT
  207. SEND PD:<PC-BLUE.VOL000>PCBLUE.CAT
  208.  
  209. A similar file exists for the PD:<SIGM> archive, but it is stored in
  210. squeezed form.  This file, when unsqueezed, yields SIG.CAT (the
  211. catalog).  Tell ARCHIVE-REQUEST to send the file with the request:
  212.  
  213. SEND PD:<SIGM.VOL000>SIG.CQT
  214.  
  215. Files in the PD:<MACINTSOH> archives are stored in Macbinary and HQX
  216. and in some rare cases Mac get files. The extension Binary will appear for
  217. Macbinary files, HQX will apperar for files that have been BINHEXED and
  218. in some cases Packed. Please see RGETTING BINARY FILESS below.
  219.  
  220.       PROGRAMS FOR TRANSFERRING FILES AMONG MAINFRAMES AND MICROS
  221.  
  222. Christensen Protocol Mainframe Programs:
  223.  
  224. For a micro to reliably exchange files with a mainframe, cooperating
  225. file transfer programs with automatic error detection and retrans-
  226. mission of faulty blocks must be running on both computers.  One such
  227. family of programs uses a popular protocol created by Ward Christensen
  228. and enhanced by others.  Directory PD:<UNIX.CPM> contains two
  229. programs, UC and the older UMODEM (both written in C), which implement
  230. this protocol on UNIX machines.  See the file PD:<UNIX>UNIX.CRCLST for
  231. a list of other useful UNIX utilities.
  232.  
  233. On ITS machines, file transfer using the Christensen protocol can be
  234. done using MMODEM (type :MMODEM for instructions), or LMODEM.
  235. Documentation for LMODEM is in file .INFO.;LMODEM HELP.
  236.  
  237. A collection of TOPS-20 utilities for transferring and manipulating
  238. files can be found in directory PD:<MISC.TOPS-20>.  See
  239. PD:<MISC>MISC.CRCLST for a list of available programs.
  240.  
  241. File transfer and conversion utilities for use with VAX/VMS machines
  242. are contained in directory PD:<MISC.VAXVMS>.  See PD:<MISC>MISC.CRCLST
  243. for details.
  244.  
  245.  
  246. Christensen Protocol Microcomputer Programs:
  247.  
  248. An excellent program for transferring files between micros, or between
  249. micros and mainframes is called MODM7xx, where the "xx" is replaced
  250. with two digits to give the current version number.  This program,
  251. often referred to as MODEM7 (the name of its easier to pronounce
  252. ancestor), uses the popular Christensen protocol to transfer files
  253. with automatic error detection and retransmission of erroneous blocks.
  254.  
  255. To get started with MODM7xx, first get and examine the "DOC" and "MSG"
  256. files from the binary library file PD:<CPM.MODEM7>MODM7xx.LBR. The
  257. "DOC" and "MSG" files are actually stored in the library in squeezed
  258. form, so you will have to perform three steps to get them:
  259.  
  260.    1. Get the binary library file.
  261.  
  262.    2. Extract the elements having filename extensions of "DQC" and
  263.       "MQG".  If you have no facilities for doing this on your
  264.       mainframe host (see the earlier comments on mainframe-based
  265.       library utilities), then you will have to transfer the library to
  266.       a microcomputer and extract the necessary elements there.  If
  267.       this requirement seems to put you in a "Catch-22" situation
  268.       because you have no facilities for mainfrome-to-microcomputer
  269.       transfers, there is a way out; read the "Getting Started" section
  270.       which follows.
  271.  
  272.    3. Use an "unsqueezer" (described above) to convert the "DQC" and
  273.       "MQG" files extracted from the library into "DOC" and "MSG"
  274.       files. As in the case of the library extractions, unsqueezing can
  275.       be done on either a mainfrome host or a microcomputer, depending
  276.       on your circumstances.
  277.  
  278. Together, these files will tell you just about all there is to know
  279. about getting MODM7xx to run on your machine.  Take the time to read
  280. them; they're quite informative.  You will also get some helpful
  281. insights from reading some of the overlay files.  These overlays,
  282. described in file PD:<CPM.MODEM7>M7OVL-yy.LST, are used to customize
  283. MODM7xx for particular machines without having to edit and assemble
  284. the huge MODM7xx source file.  Complete instructions for performing
  285. this procedure are contained in each overlay file. The letters "yy" in
  286. the above filename should be replaced with two digits giving the
  287. current version number as determined from CPM.CRCLST.
  288.  
  289. And then, there is MEX.  MEX stands for "Modem EXecutive", and it is
  290. just what the name implies, a communications and file-transfer program
  291. with a built-in mini operating system that runs under CP/M.  This
  292. program can do file transfers using either the Christensen or
  293. CompuServe protocol, and it has an enormous potential for highly
  294. automated operations because it can read and execute command-scripts
  295. pre-stored in disk files.  These scripts can include sending commands
  296. to a remote computer, as if they had been sent manually from the
  297. microcomputer in terminal-mode.  Users of this relatively new program
  298. are still exploring its possibilities.  For more information, look in
  299. CPM.CRCLST under the heading "PD:<CPM.MEX>", and then get the various
  300. files that have "DQC" and "IQF" in their names.  These DOCumentation
  301. and INFormation files are stored in squeezed form (note the "Q" in the
  302. filename extensions), so you will have to unsqueeze them.  Overlays
  303. for MODM7xx will also work with MEX, but they will not provide all of
  304. the extended MEX features.
  305.  
  306. Getting Started:
  307.  
  308. In order to get MODM7xx or MEX running on your CP/M micro, you must
  309. first transfer the necessary files from mainframe to micro.  If you
  310. already have a receive-to-disk communications program of some sort,
  311. you can use it to move the needed files.  In the long-run it is
  312. essential to be able to transfer 8-bit binary files, but initially it
  313. is not absolutely necessary.  Some of the files are quite large.  For
  314. example, MODM7xx.COM is over 18K bytes, and the HEX file (which you
  315. will need if you can't transfer 8-bit files) is over 45K.  Moving
  316. large files to your micro without using an error detecting protocol
  317. can result in frustrating errors, but it can be done by receiving
  318. multiple copies and using manual or machine-assisted comparisons to
  319. locate and repair bad parts of the code.  However, there IS a better
  320. way.
  321.  
  322. Directory PD:<CPM.STARTER-KIT> contains a short starter-program called
  323. PIPMODEM.ASM which you can get to your mainframe, print it, and then
  324. enter into your microcomputer by hand and assemble.  This can then be
  325. used to down-load either MBOOT3.ASM or BMODEM.BAS (depending on
  326. whether you prefer assembly language or BASIC), both of which can
  327. receive files using the error detecting Christensen protocol.  Once
  328. you have this capability, you can download the full-function file
  329. transfer program of your choice.  To examine this option, send the
  330. following requests to ARCHIVE-REQUEST@SIMTEL20:
  331.  
  332. SEND RAW PD:<CPM.STARTER-KIT>PIPMODEM.ASM
  333. SEND RAW PD:<CPM.STARTER-KIT>PIPMODEM.DOC
  334. SEND RAW PD:<CPM.STARTER-KIT>MBOOT3.ASM
  335. SEND RAW PD:<CPM.STARTER-KIT>BMODEM.BAS
  336. SEND RAW PD:<CPM.STARTER-KIT>BMODEM.DOC
  337.  
  338. Read PIPMODEM.DOC first, then look at MBOOT3.ASM and BMODEM.DOC.
  339. PIPMODEM.DOC explains the situation very nicely.  Questions concerning
  340. these programs should be sent to INFO-CPM@AMSAA.ARPA (NOT to
  341. INFO-CPM-REQUEST).
  342.  
  343.                   CONTRIBUTING PUBLIC DOMAIN PROGRAMS
  344.  
  345. Contributions of public domain software are actively solicited.  If
  346. you have something that seems appropriate for inclusion in the
  347. PD:<CPM>, PD:<MSDOS>, or PD:<MISC> archives, please contact Keith
  348. Petersen <W8SDZ@SIMTEL20>.  Likewise, contact Richard Conn
  349. <ADA-SW-REQUEST@SIMTEL20> if you wish to contribute to the PD:<ADA>
  350. archive, and Tom Harrison <UNIX-SW-REQUEST@SIMTEL20> if you have
  351. something for the PD:<UNIX> archive, Robert Thum <RTHUM@SIMTEL20>
  352. if you have goodies for the PD:<MACINTOSH> archives.
  353.  
  354. Special thanks to Dave Towson <Info-Cpm-Request@AMSAA.ARPA> for
  355. writing the original file from which this was extracted.And to Keith Petersen
  356. who revamped it.
  357.  
  358. Happy computing!
  359.  
  360. Robert Thum 5/20/87
  361.