home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / starter / simtel20.inf < prev    next >
Text File  |  1992-09-08  |  16KB  |  329 lines

  1. [File: SIMTEL20.INF                    Last revised: August 29, 1992]
  2.  
  3.    [Note: Due to local policy changes, we are no longer able to keep
  4.    the PC/Blue collection online and intact.  We are sorry for any
  5.    inconvenience to our users.  The PC-Blue collection is available
  6.    from OAK.Oakland.Edu, in directory /pub/pc-blue/pcblue.]
  7.  
  8.                      THE SIMTEL20 ARCHIVES
  9.  
  10. OVERVIEW
  11.  
  12. There is a colossal amount of free public domain and shareware software
  13. for the CP/M, PCDOS/MSDOS, Macintosh, and UNIX operating systems, and
  14. for the DoD standard programming language, Ada, in several archives on
  15. WSMR-SIMTEL20.ARMY.MIL (IP host 192.88.110.20), a DECSYSTEM-20 running
  16. the TOPS-20 operating system, owned and operated by the U.S. Army
  17. Information Systems Command, at White Sands Missile Range, New Mexico. 
  18. Archives of correspondence for several mailing lists are also available. 
  19.  
  20.     [SIMTEL20 is a contraction of SIMulation and TELeprocessing, the
  21.     name of the branch that originally purchased the machine and in
  22.     whose building the system still resides, and the "20" in
  23.     DECSYSTEM-20.  The convention of including the "20" in some form
  24.     or another was popular with other DECSYSTEM-20 systems at the time
  25.     SIMTEL20 was named, such as MIT-XX at MIT and SCORE at Stanford.]
  26.  
  27. You can obtain these files using the InterNet file transfer protocol,
  28. FTP (described in a following paragraph), with user-name "anonymous". 
  29. For a login password, use your e-mail address.  Throughout this message,
  30. FTP examples are given in a GENERIC syntax.  You will have to consult
  31. either local documentation or your friendly system wizard to learn the
  32. actual syntax used with your local mainframe operating system.  For the
  33. sake of brevity, the full host name "WSMR-SIMTEL20.ARMY.MIL" will be
  34. dropped from further references to SIMTEL20 in this discussion.  Also
  35. please note that square brackets may be used in place of angle brackets
  36. in referring to directory names.  For example, pd1:[msdos.filedocs] is
  37. the same as pd1:<msdos.filedocs>
  38.  
  39. There are many helpful files in the default ANONYMOUS ftp directory.
  40. Please look at these if you have need for further information on
  41. specific collections.
  42.  
  43. To obtain directory listings, connect to SIMTEL20 via FTP and get
  44. these files:
  45.  
  46.   pd1:<msdos>msdos.crclst
  47.   pd2:<cpm>cpm.crclst
  48.   pd2:<cpmug>cpmug.crclst
  49.   pd2:<sigm>sigm.crclst
  50.   pd8:<hz100>hz100.crclst
  51.   pd9:<macintosh>macintosh.crclst
  52.   pd8:<misc>misc.crclst
  53.   pd6:<unix-c>unix-c.crclst
  54.   pd7:<ada>ada.crc
  55.  
  56. There is also a comma-delimited directory listing in each top-level
  57. directory, FILES.IDX, which is suitable for importing into a database
  58. program.  This file may be of greater use than the crclst files
  59. because it can be compared against an earlier version of the same file
  60. to produce a complete list of files added and deleted from the
  61. archives.  Using the comma-delimited fields it is possible to build a
  62. script for FTP to maintain a parallel archive.  FILES.IDX can be
  63. printed or displayed with a simple BASIC program.  For information
  64. on file descriptions see PD1:<MSDOS.FILEDOCS>AAAREAD.ME.
  65.  
  66. The <CPM>, <MSDOS>, <UNIX-C> and <MACINTOSH> archives are the ones to
  67. watch for the very latest offerings, as they are updated frequently. 
  68.  
  69. The <CPMUG>, and <SIGM> archives contain software distributed by
  70. the CP/M Users Group and the SIG/M Users Group respectively.  This
  71. software is available on diskettes from the associated user groups,
  72. and the archives are updated as new volumes are issued.
  73.  
  74. The <MSDOS> archives contain software for the MS-DOS and PC-DOS
  75. operating systems.
  76.  
  77. The <UNIX-C> archive contains a variety of UNIX tools.  Those which
  78. apply specifically to CP/M are in the directory <UNIX-C.CPM>.
  79.  
  80. The <ADA> archive is growing rapidly. Information about this archive
  81. is in directory PD7:<ADA.GENERAL>.  In general, the archived software
  82. is very good, having been worked-over and refined by many users.  The
  83. documentation and comments tend to be complete and informative.
  84.  
  85. Files in all of these archives can be obtained using the FTP procedures
  86. described in this message.
  87.  
  88. PLEASE NOTE:  Due to the large number of files available, the archive
  89. maintainers cannot possibly attempt to validate the proper operation of
  90. the various programs.  When a program bug is reported, immediate action
  91. is taken to either correct the error or remove the offending program
  92. from the archives.  Still, users must understand that all archive
  93. programs are offered AS IS, and the archive maintainers specifically
  94. disclaim any liability should these programs malfunction or cause
  95. damage, incidental or otherwise.  When testing ANY new software, be
  96. certain that all information stored on disk is backed-up before you
  97. start, so that you can recover if files are damaged or erased.  This is
  98. particularly true if you have a hard disk, in which case malfunctions
  99. can be spectacularly disastrous.
  100.  
  101. FILE TYPES
  102.  
  103. Files are stored in two formats: Text files such as those with names
  104. that end with DOC, HEX, INF and ASM are sometimes stored as ASCII
  105. files, but sometimes these files are stored in binary compressed
  106. form.  Binary storage is also used for executable (COM and EXE) and
  107. library/archive files  (LBR and ARC).  All binary data are stored as
  108. four 8-bit bytes per 36-bit SIMTEL20 word, with the low-order four
  109. bits of each word filled with zeros.  If such a file is interpreted
  110. as a contiguous string, as will happen if a straight binary transfer
  111. is made to a 16 or 32-bit UNIX machine, the four zero filler-bits per
  112. 36-bit group will cause rather bizarre and frustrating results.
  113.  
  114. For information on ARJ, ARC, ARK, ARJ, LZH, ZIP, ZOO, LBR, squeezed
  115. and crunched files, get  PD2:<CPM.STARTER-KIT>00-FILES.DOC  and/or
  116. PD1:<MSDOS.STARTER>00-FILES.DOC. 
  117.  
  118. Although the type of storage used for a particular file can usually be
  119. inferred from the file-name, this is not always true.  It is a good idea
  120. to check the appropriate "crclst" of "idx" file to ascertain the storage
  121. format used for each file of interest.  Now, and for the foreseeable
  122. future, storage formats for files in the <SIGM> archive can be
  123. determined from their "generation numbers".  All files with names ending
  124. in ".1" are stored in binary format, and those with names ending in ".2"
  125. are stored in ASCII.  This relationship will continue to apply for files
  126. in the <SIGM> archive until further notice. 
  127.  
  128. WARNING: Because the public domain archives on SIMTEL20 consume a huge
  129. amount of disk space, storage capacity will be conserved by the greatest
  130. practical use of libraries, archives, crunched and squeezed files, all
  131. of which are stored in binary format.  If you cannot properly transfer
  132. binary files, you are going to be VERY FRUSTRATED!  If you need help,
  133. please contact your local system wizard and provide him/her with a copy
  134. of this message.  Having done that, if you are still unable to make
  135. things work correctly, send a message to Action@WSMR-SIMTEL20.ARMY.MIL
  136. and someone will try to help you.  Please provide the following
  137. information:
  138.  
  139.  1. Machine and operating system  (e.g., VAX-11/780, 4.3 BSD UNIX)
  140.  2. Network software in use  (e.g., 3-Com UNET)
  141.  3. Complete list of available FTP commands  (e.g., GET, PUT, etc.)
  142.  
  143. Important files in the <CPMUG> archives are the CATALOG files. These
  144. files, which are stored in ASCII, contain the "-CATALOG.nnn" files
  145. from all the volumes of the archive.  To obtain the composite catalog
  146. files, connect to SIMTEL20 via FTP and get this file:
  147.  
  148.   pd2:<cpmug>cpmug.cat
  149.  
  150. Similar files exist for the <SIGM> archive, but they are stored in
  151. squeezed form.  These files, when unsqueezed, yields SIG0.CAT and
  152. SIG1.CAT (the catalog).
  153.  
  154.   pd2:<sigm.vol000>sig0.cqt
  155.   pd2:<sigm.vol000>sig1.cqt
  156.  
  157. (NOTE: That's "L-and-three-zeros" in "vol000")
  158.  
  159. FILE TRANSFER VIA FTP
  160.  
  161. FTP stands for File Transfer Protocol, a formalized procedure for
  162. moving files among machines on the Defense Data Network (DDN) and other
  163. networks that connect with the DDN.  The protocol is implemented by a
  164. program often called FTP.  The different mainframe operating systems
  165. implement FTP with variations in command syntax.  Some systems have the
  166. remote-file-name precede the local-file-name in the command.  Others
  167. reverse this order.  Some versions have the whole command on a single
  168. input line, while others use multiple lines.  Read the documentation
  169. for your local system, or consult a friendly system wizard for the
  170. details of your local FTP command syntax.
  171.  
  172. UNIX users can do something like "man ftp" for on-line instructions.
  173. However, not all UNIX FTP programs are called "ftp", so you may have
  174. to snoop around in the system directories or ask a system wizard for
  175. the correct local name to use with the "man" command.  ITS users can
  176. do ":INFO FTP", and "HELP FTP" works on TOPS-20 and some other
  177. operating systems.  I will be happy to update this message with
  178. pointers to other sources of on-line documentation if they are sent
  179. to w8sdz@TACOM-EMH1.Army.Mil.
  180.  
  181. FTP transfers from SIMTEL20 can be made with user-name "anonymous".  Use
  182. your e-mail address for the password.  For anonymous logins, SIMTEL20
  183. supports the FTP "change working directory" command.  (Your local syntax
  184. may be something like CD, or CWD).  Ignore the message which may appear
  185. that prompts you to enter a password.  This command allows you to
  186. specify a default SIMTEL20 directory to be used for all file retrievals,
  187. and thereby relieves you from having to repeatedly type "pdx:<whatever>"
  188. as part of each filename.  For example, you can do something like this:
  189.  
  190.   cd pd1:<msdos.goodstuff>
  191.   get filename-1
  192.   get filename-2
  193.   ...and so on
  194.  
  195. instead of using the longer filename forms shown in previous examples.
  196.  
  197. Users of TOPS-10, TENEX, or TOPS-20 systems can use "image" or "paged"
  198. mode for ALL transfers.  UNIX and other users must use "ascii" mode
  199. for ASCII files, and "type tenex", "type binary", or "type L 8" mode
  200. for binary files.
  201.  
  202. All aspects of the FTP process for UNIX machines have been automated
  203. to a high degree by two programs in directory PD8:<MISC.UNIX>. With
  204. these programs, a simple command like "sh autoftp30.sh mylist &" can
  205. be run in no-hangup background mode to transfer multiple files from
  206. SIMTEL20 without the user remaining logged-in on the local system.
  207. For more information, get the file PD8:<MISC.UNIX>AUTOFTP30.TAR-Z, a
  208. compressed tar archive.  After transferring it to your Unix host,
  209. rename to autoftp30.tar.Z, uncompress, and extract with tar.  Also
  210. see BATCHFTP102.TAR-Z which is an enhanced version of autoftp.
  211.  
  212. MAILING LIST CORRESPONDENCE ARCHIVES
  213.  
  214. Copies of correspondence for several mailing lists are kept on SIMTEL20
  215. in directories with names of the form PD2:<ARCHIVES.KEYWORD>, where
  216. "KEYWORD" has been chosen to indicate the associated mailing list.  At
  217. present, the following correspondence archives are available:
  218.  
  219.    mailing list       mail archive filename
  220.   ---------------     ---------------------
  221.   ADA-SW              PD2:<ARCHIVES.ADA-SW>
  222.   AMETHYST-USERS      PD2:<ARCHIVES.AMETHYST>
  223.   INFO-68K            PD2:<ARCHIVES.68K>
  224.   INFO-APPLE          PD2:<ARCHIVES.APPLE>
  225.   INFO-CPM            PD2:<ARCHIVES.CPM>
  226.   INFO-FORTH          PD2:<ARCHIVES.FORTH>
  227.   INFO-IBMPC          PD2:<ARCHIVES.IBMPC>
  228.   INFO-MICRO          PD2:<ARCHIVES.MICRO>
  229.   INFO-MODEMS         PD2:<ARCHIVES.MODEMS>
  230.   INFO-MODEMXX        PD2:<ARCHIVES.MODEMXX>
  231.   INFO-MODULA-2       PD2:<ARCHIVES.MODULA-2>
  232.   INFO-PASCAL         PD2:<ARCHIVES.PASCAL>
  233.   INFO-XENIX310       PD2:<ARCHIVES.XENIX310>
  234.   INFO-XMODEM         PD2:<ARCHIVES.XMODEM>
  235.   NORTHSTAR-USERS     PD2:<ARCHIVES.NORTHSTAR>
  236.   UNIX-SW             PD2:<ARCHIVES.UNIX-SW>
  237.   VIDEOTECH           PD2:<ARCHIVES.VIDEOTECH>
  238.  
  239. Descriptions of these and other mailing lists can be obtained via FTP
  240. with anonymous login (as for SIMTEL20) from FTP.NISC.SRI.COM.  Ask for
  241. the file netinfo/interest-groups (an ASCII file).  And please note,
  242. this is NOT on SIMTEL20.
  243.  
  244. File names for SIMTEL20 mailing list correspondence archives have two
  245. forms.  For example, in PD2:<ARCHIVES.CPM>, which holds the INFO-CPM
  246. correspondence (the "INFO-" is assumed), the forms are: yymm.n-TXT or
  247. yymm.n-TXT-Z.  Files with names ending in -Z were compressed with a
  248. Unix compress-compatible program.  The characters "yymm" in the file
  249. names are the digits of the year and month of the messages in each
  250. particular file.  The "n" was incremented as overflowed 150 disk pages
  251. (approximately 375K).  The current month's correspondence is kept in
  252. CPM-ARCHIV.TXT, which is constantly growing as new messages arrive.
  253. There may also temporarily exist files named CURRENT.n-TXT, which hold
  254. the overflow of the current month's messages when CPM-ARCHIV.TXT is
  255. split into monthly files.  Although INFO-CPM has been used as an
  256. example here, the same naming scheme is used for the other mailing list
  257. files as well.  For a complete list of available files, connect to
  258. SIMTEL20 via FTP and do this:
  259.  
  260.   dir PD2:<ARCHIVES>
  261.  
  262. You will receive a list of names of the form:
  263.  
  264.   KEYWORD.DIRECTORY.n
  265.  
  266. where "n" is one or more digits.  For example, the INFO-CPM listing
  267. currently appears as "CPM.DIRECTORY.1"  To then get a list of files in
  268. a particular archive, do this:
  269.  
  270.   dir PD2:<ARchives.keyword>
  271.  
  272. where "keyword" (for example, "cpm") is chosen from the preceding list,
  273. and the word "directory" and the number "n" are not used.  At present,
  274. all of these files are stored in ASCII.
  275.  
  276. FTP PROBLEMS, FILE ERRORS, CONNECT OR LOGIN PROBLEMS
  277.  
  278. System and network related problems should be reported to
  279. Action@WSMR-SIMTEL20.Army.Mil (SIMTEL20 System Administrators).
  280.  
  281. ADDITIONS, IMPROVEMENTS AND CORRECTIONS
  282.  
  283. Suggestions for additions, improvements and corrections to this message
  284. are always welcome.  Please send them to w8sdz@TACOM-EMH1.Army.Mil.
  285.  
  286. Contributions of public domain and freely-distributable software are
  287. actively solicited.  If you have something that seems appropriate for
  288. inclusion in the <CPM>, <MSDOS>, or <MISC> archives, please contact
  289. w8sdz@TACOM-EMH1.Army.Mil (Keith Petersen).
  290.  
  291. Contact ADA-SW-Request@WSMR-SIMTEL20.Army.Mil (Richard Conn) if you
  292. wish to contribute to the <ADA> archive.
  293.  
  294. Contact RThum@WSMR-SIMTEL20.Army.Mil (Robert Thum) if you wish to
  295. contribute to the <MACINTOSH> archive.
  296.  
  297. Contact UNIX-SW-Request@WSMR-SIMTEL20.Army.Mil (John Pliler) if you
  298. have something for the <UNIX-C> archive.
  299.  
  300. Please do not send files without first getting upload instructions.
  301. Uploads to the default ANONYMOUS directory are ignored and deleted
  302. without review.
  303.  
  304. SIMTEL20 allows only nine ANONYMOUS FTP logins during weekday prime
  305. time, 5am to 3pm Mountain Time (GMT-7), but 27 otherwise. 
  306.  
  307. SIMTEL20 files are also available from mirror sites OAK.Oakland.Edu
  308. (141.210.10.117), wuarchive.wustl.edu (128.252.135.4), ftp.uu.net
  309. (137.39.1.9), nic.funet.fi (128.214.6.100), src.doc.ic.ac.uk
  310. (146.169.3.7), nic.switch.ch (130.59.1.40) or archie.au (139.130.4.6),
  311. by e-mail through the BITNET/EARN file servers, or by uucp from UUNET's
  312. 1-900-GOT-SRCS.  See UUNET file uunet!~/info/archive-help for details.
  313.  
  314. Public, private or corporate institutions and libraries interested in
  315. the SIMTEL20 MS-DOS collection in CD-ROM format bundled with library
  316. card-catalog type access and duplication software can contact Coyote
  317. Data, Ltd. by mail at 1142 N. Main, Rochester, MI 48307 or by FAX at
  318. (313) 651-4071.  Others who do not need the access and duplication
  319. software should send e-mail to  rab@sprite.Berkeley.EDU (Robert Bruce)
  320. or telephone (800) 786-9907 or (510) 947-5996 for details on his CD-ROM
  321. offer. 
  322.  
  323. Happy computing!
  324.  
  325. Keith Petersen
  326. Maintainer of the MSDOS, MISC and CP/M archives at SIMTEL20 [192.88.110.20]
  327. Internet: w8sdz@TACOM-EMH1.Army.Mil      or      w8sdz@vela.acs.oakland.edu
  328. Uucp: uunet!umich!vela!w8sdz                          BITNET: w8sdz@OAKLAND
  329.