home *** CD-ROM | disk | FTP | other *** search
/ The Unsorted BBS Collection / thegreatunsorted.tar / thegreatunsorted / texts / txtfiles_misc / simtel20.4 < prev    next >
Text File  |  1993-10-09  |  16KB  |  329 lines
  1. Subj:  #1(3)      File: "PDGET HELP"
  2. Date:  93-10-09 03:22:23 EDT
  3. From: LISTSERV@VM1.NODAK.EDU
  4. To:    Monk OTY
  5.  
  6. Mail Split By AOL Gateway
  7.  
  8. ------- cut here --------
  9.  
  10. ------------------------------------------------------------------------
  11.  
  12.               Accessing the SIMTEL20 archives from BITNET
  13.  
  14.                                                      Updated 11 Jan 1993
  15. ------------------------------------------------------------------------
  16.  
  17.    This document describes a method for users of systems connected to
  18. BITNET to obtain files from selected archives kept at the MILNET node
  19. WSMR-SIMTEL20.ARMY.MIL.  The information applies specifically to the
  20. file servers installed at NDSUVM1 and RPITSVM.  (A similar service is
  21. provided to EARN and other areas of the world by a set of servers
  22. collectively known as "TRICKLE";  those servers accept similar, but
  23. not identical, commands.)
  24.  
  25. ------------------------------------------------------------------------
  26. Background
  27. ------------------------------------------------------------------------
  28.  
  29.      The U.S. Army maintains a huge collection of public domain (and
  30. "shareware") software and information on WSMR-SIMTEL20.ARMY.MIL, a
  31. DECSYSTEM-20 machine running the TOPS-20 operating system at White Sands
  32. Missile Range, New Mexico.  The collection covers a spectrum of
  33. interests, including files of interest to CP/M and MSDOS users.
  34.  
  35.      The collection is "open to the public"; anyone may obtain copies
  36. of the files using the Internet file transfer protocol, FTP.  The bad
  37. news is that FTP is not a protocol available over BITNET.  BITNET users
  38. can not directly obtain files from the SIMTEL20 collection.  The good
  39. news is that there are several file servers located throughout BITNET
  40. that will accept requests for SIMTEL20 files and perform the appropriate
  41. file transfer on the requestor's behalf.  However, please understand
  42. that...
  43.  
  44.      The BITNET servers that provide access to the SIMTEL20 archives
  45.      have no affiliation with the U.S. Army nor with White Sands Missile
  46.      Range.  Also, the BITNET servers are made available in the true
  47.      spirit of volunteerism (both of the institutions where they are
  48.      installed and of the individuals that support them) without any
  49.      outside sponsorship for the service.
  50. Also...
  51.      Due to the large number of files available, neither the
  52.      archive maintainers at SIMTEL20 nor the server maintainers in
  53.      BITNET can possibly attempt to validate the proper operation of
  54.      the various programs.  When a program bug is reported to an
  55.      archive maintainer, immediate action is taken to either correct
  56.      the error or remove the offending program from the archives.
  57.      Still, users must understand that archive programs are offered
  58.      AS-IS, and the archive maintainers and server maintainers
  59.      specifically disclaim any liability should these programs
  60.      malfunction or cause damage, incidental or otherwise.  When
  61.      testing ANY software, be certain that all information stored on
  62.      disk is backed-up before you start so that you can recover if files
  63.      are damaged or erased.  This is particularly true if you have a
  64.      hard disk, in which case malfunctions can be spectacularly
  65.      disasterous.
  66.  
  67.      The BITNET servers provide access to the following subset of the
  68. software archives residing at SIMTEL20:
  69.  
  70. CPM     Software and information for CP/M system users.  Contributions
  71.         are gathered from a variety of sources, including the members
  72.         of the Info-CPM electronic mail discussion group.  This archive
  73.         is updated very frequently.
  74.  
  75. MSDOS   Software and information for PC-DOS and MSDOS system users.
  76.         Contributions are gathered from a variety of sources, including
  77.         the members of the Info-IBMPC electronic mail discussion group.
  78.         This archive is updated very frequently.
  79.  
  80. SIGM    Software and information for CP/M system users.  The archive
  81.         contains the files distributed by the SIG/M Users group.  New
  82.         files are added as they become available.
  83.  
  84. MISC    Software and information for miscellaneous systems (mostly
  85.         large systems like IBM/370 and DEC VAX).  Contributions are
  86.         gathered from a variety of sources.
  87.  
  88.      The following directories may have different structures than the
  89. previous ones and may be less well supported.  They are included
  90. for the convenience of those working with them.
  91.  
  92. ADA        ADA language information.
  93.  
  94. ARCHIVES   Miscellaneous archives kept at simtel20 (eg. APPLE, FORTH,
  95.            VIDEOTECH, etc.).  We have only one source for the archives
  96.            so retrieval may take longer than for other directories.
  97.  
  98. MACINTOSH  Various Macintosh software files.
  99.  
  100. UNIX-C     Various Unix and C topics.
  101.  
  102. ------------------------------------------------------------------------
  103. SIMTEL20 path names, file names and file types
  104. ------------------------------------------------------------------------
  105.  
  106.      The TOPS-20 operating system supports a hierarchical file system
  107. structure not unlike that found on Unix, Vax/VMS, and even MSDOS
  108. systems.  At SIMTEL20, the software collection is divided into
  109. individual archives by category, each with its own file system
  110. directory.  The archives are subdivided by topic into sub-directories.
  111. The following example is a typical path name for a SIMTEL20 file:
  112.  
  113.           PD:<MSDOS.STARTER>UUDECODE.BAS
  114.  
  115. Here, PD is the name of the disk where the archives reside.  (Well,
  116. actually it is an alias for a group of disks PD1, PD2, and so on.)
  117. MSDOS is the name for the archive; STARTER is a sub-directory containing
  118. generally useful programs and information.  UUDECODE.BAS is the name for
  119. one such file in the STARTER sub-directory.
  120.  
  121.      File names of files in the SIMTEL20 archives generally conform to
  122. the conventions of the target system (e.g. CP/M and MSDOS).  From the
  123. example above, UUDECODE.BAS is a uudecode program written in BASIC.
  124. (MSDOS.STARTER also contains UUDECODE.PAS and UUDECODE.C, versions of
  125. the same program written in Pascal and C, respectively.)  The model of
  126. "name.extension" should be familiar to most.  Extensions of DOC, HEX,
  127. INF and ASM are associated with ASCII text files; COM and EXE, with
  128. binary executables.  However, in an effort to reduce the online storage
  129. required by the files, and to organize software into packages, most of
  130. the files at SIMTEL20 have been through some flavor of data compaction
  131. and/or library utility.  The file extensions used for such beasts may
  132. be less familiar to some:
  133.  
  134. ARC   a collection of related files compacted and collected together
  135.       into a single package, and called an ARChive.  An un-archive
  136.       utility is needed to extract individual files from the package.
  137.  
  138. ARK   exactly the same as ARC.  ARK is used in preference to ARC in
  139.       the CP/M archives.
  140.  
  141. LBR   a collection of related files compacted and collected together
  142.       into a single package, and called a LiBRary.  An un-library
  143.       utility is needed to extract individual files from the package.
  144.  
  145. xQx   a file that has been compacted using a Huffman encoding method
  146.       known as sQueezing.  The extension is derived from that of the
  147.       original file with the letter Q substituted in the middle.  (An
  148.       ASM file that was squeezed would be stored as AQM.)  An
  149.       un-squeeze utility is needed to recover the original file data.
  150.  
  151. xZx   the same as xQx except that an LZW-variant method known as
  152.       crunching has been used.  An un-crunch utility is needed to
  153.       recover the original file data.
  154.  
  155. ZIP   Similar to, but not the same as, the ARC format in concept.
  156.       Requires PKUNZIP (VERSION 1.10 OR HIGHER!) on the PC to
  157.       extract the individual file contents.  Versions of UNZIP are
  158.       available for non-PC extraction.
  159.  
  160.  
  161. Most of the software for MSDOS systems are stored in the ARC format.
  162. All four formats are used in the software for CP/M systems.  (ARK and
  163. ARC represent the same thing, but ARK is the more commonly used name.)
  164. Only a  few "first-time-user" type files (like UUDECODE.BAS) are stored
  165. in their raw form.  The section below titled "Getting Started" gives
  166. some guidance about handling them.
  167.  
  168. ------------------------------------------------------------------------
  169. Using the BITNET Servers
  170. ------------------------------------------------------------------------
  171.  
  172.      In the United States, there are two BITNET servers that provide
  173. access to the SIMTEL20 archives:
  174.  
  175.           LISTSERV@NDSUVM1   North Dakota State University.
  176.           LISTSERV@RPITSVM    Rensselaer Polytechnic Institute.
  177.  
  178. Those addresses are for the BITNET network.  From the INTERNET, the
  179. servers are
  180.  
  181.           LISTSERV@VM1.NODAK.EDU   North Dakota State University.
  182.           LISTSERV@VM.ITS.RPI.EDU  Rensselaer Polytechnic Institute.
  183.  
  184.  
  185. --------Note--------Note--------Note--------Note--------Note-----------
  186.      In Europe, there are many EARN servers.  However, the information
  187. provided here is specifically for the BITNET servers.  The EARN servers
  188. have a similar user interface and may accept the same set of commands,
  189. but information about using them is beyond the scope of this document.
  190. The locations of the EARN servers and the principle contact person for
  191. each are:
  192.  
  193.           TRICKLE@TREARN    ("Turgut Kalfaoglu"   <TURGUT@TREARN>)
  194.           TRICKLE@BBRNSF11  ("Kris Van Hees"      <VUBA005@BBRNSF11>)
  195.           TRICKLE@TAUNIVM   ("Hank Nussbacher"    <HANK@BARILVM>)
  196.           TRICKLE@IMIPOLI   ("Marco Gandolfi"     <MARCO@IMIPOLI>)
  197.           TRICKLE@DB0FUB11  ("Wolfram Fassbender" <EARNIE@DB0FUB11>)
  198.           TRICKLE@AWIWUW11  ("Gustaf Neumann"     <NEUMANN@AWIWUW11>)
  199.           TRICKLE@BANUFS11  ("Michel Daulie"      <DAULIE@BANUFS11>)
  200.           TRICKLE@EB0UB011  ("Oriol Robert"       <ZCCBORR@EB0UB011>)
  201.           TRICKLE@HEARN     ("Jos Wennmacker"     <U001222@HEARN>)
  202.           TRICKLE@FRMOP11   ("Dominique Dumas"    <BRUCH@FRMOP11>)
  203.  
  204.      Trickles in other areas:
  205.           TRICKLE@TWNMOE10  ("Shea Nai Wen"       <SNW@TWNMOE10>)
  206.           TRICKLE@UNALCOL   ("Rodrigo Gutierrez"  <IU254178@UNALCOL>)
  207.           TRICKLE@USACHVM1  ("Gonzalo M. Rojas"   <GROJASCO@USACHVM1>)
  208. --------Note--------Note--------Note--------Note--------Note-----------
  209.  
  210.  
  211.      Requests may be sent to a server as RFC822-style mail.  The
  212. commands to the server must appear in the body of the message, not the
  213. Subject: line.  The server uses the From: header to determine how to
  214. address the files to be returned.  The FROM: header must therefore
  215. specify a VALID, REACHABLE, NETWORK ADDRESS from the server's point of
  216. view.  Mail received from outside BITNET, particularly from UUCP,
  217. sometimes has unusable return addresses.
  218.  
  219.      Requests may also be sent as interactive BITNET messages if your
  220. system supports such a facility.  On an IBM system, this service is
  221. provided by the TELL command, as in
  222.  
  223.           TELL LISTSERV AT nodename  servercommand
  224.  
  225.      The server does enforce some limits on how much can be requested
  226. by whom and from where.  Requests from EARN are not accepted; they
  227. must be delivered to the nearest TRICKLE server in EARN.  For others,
  228. the server restricts how many files and how many bytes of data a user
  229. may request per day.  It also restricts how many files and how many
  230. bytes a host system may request per day.  The limits are changed on
  231. occasion, they are but they are in the neighborhood of at least
  232.  
  233.      3 files/USER/day            10 files/HOST/day
  234.    150 Kbytes/USER/day          600 Kbytes/HOST/day
  235.  
  236. There are some files that are larger than the per-day limit for a user
  237. (or host) would permit, so the server does allow the first request from
  238. a user (or host) on any given day to exceed the byte limit.  Also, the
  239. "host" in this context means what appears after the at-sign (@) in the
  240. return address.  Mailed requests that pass through a gateway usually
  241. appear to be from that gateway host, and so the server applies its host
  242. limits accordingly.
  243.  
  244. --------Note--------Note--------Note--------Note--------Note-----------
  245.      Although requests are SENT TO THE LISTSERV ADDRESS, the requests
  246. are actually processed by userid TRICKLE.  Files sent back to you will
  247. be from TRICKLE.  Do not let this mislead you, though:  Your requests
  248. must go to LISTSERV, and not to TRICKLE at either NDSUVM1 or RPITSVM.
  249.  
  250.      In EARN, LISTSERV is not used, and TRICKLE does accept requests
  251. from users.  NOT IN BITNET.  Your requests must go to LISTSERV.
  252. --------Note--------Note--------Note--------Note--------Note-----------
  253.  
  254.  
  255. THE /PDDIR COMMAND
  256.  
  257. The /PDDIR command is used to list the names of files that match some
  258. pattern.  The command has several forms.  They are:
  259.  
  260.         /PDDIR
  261.         /PDDIR  PD:<directory>
  262.         /PDDIR  PD:<directory.subdirectory>filename.ext  age
  263.  
  264.      The first form lists the names of all the archives known to the
  265. server.  At present these are CPM, SIGM, PC-BLUE, MSDOS, and MISC.  The
  266. second  form lists the names of all the subdirectories in a particular
  267. archive.  (The directory name must be one of the known archives: CPM,
  268. SIGM, etc.)  The third form lists the names of files in the archive that
  269. match a particular pattern.  The age parameter limits how old a file in
  270. the archive may be and still be considered.  If omitted, the default is
  271. 30, meaning 30 days old.  The directory name must be one of CPM, SIGM,
  272. PC-BLUE, MSDOS, or MISC.  The subdirectory, filename, and ext may
  273. include asterisks ('*') a "wild-card" characters.  The following are
  274. examples.
  275.  
  276.         /PDDIR PD:<MSDOS>  --Lists subdirectories in the MSDOS archive.
  277.         /PDDIR PD:<SIGM.*>*.*   --Lists files added in the last 30 days
  278.         /PDDIR PD:<MISC.VAXVMS>*.* 9999  --Lists VAX/VMS related files.
  279.         /PDDIR PD:<CPM.*>UUDECODE*.* 9999  --Lists uudecoders for CP/M.
  280.  
  281.  
  282. THE /PDGET COMMAND
  283.  
  284. The /PDGET command is used to request a specific file.  No pattern-
  285. matching is allowed.  The syntax for this command is as follows:
  286.  
  287.         /PDGET  format  simtel.filename  encoding
  288.  
  289.      The format specifies how the file is to be transmitted.  Allowed
  290. values are NETDATA, PUNCH, and MAIL.
  291.  
  292.      NETDATA  -- suitable for transfer to BITNET hosts that can accept
  293.                  files in IBM Netdata format.
  294.  
  295.      BITSEND  -- suitable for transfer to BITNET hosts that can accept
  296.                  files in IBM Netdata format.
  297.  
  298.      PUNCH    -- suitable for transfer to BITNET hosts that can accept
  299.                  files but cannot decode the Netdata format.  Files
  300.                  are sent as 80-byte card-images.
  301.  
  302.      MAIL     -- suitable for transfer to hosts that can accept only
  303.                  mail or are accessible to BITNET only through gateways.
  304.                  Large files sent via mail are split into several
  305.                  smaller files that the recipient must reassemble.
  306.  
  307. If the format is omitted, NETDATA is assumed for BITNET hosts and MAIL
  308. for all others.
  309.  
  310.      The encoding specifies any special translation for the file data:
  311. ------- cut here --------
  312.  
  313.  
  314. ----------------------- Headers ------------------------
  315. From <@VM1.NODAK.EDU:LISTSERV@VM1.NODAK.EDU> Sat Oct  9 03:21:16 1993
  316. Received: from VM1.NoDak.EDU by jlev.hp.aol.net with SMTP
  317.  (1.37.109.4/16.2) id AA02558; Sat, 9 Oct 93 03:21:16 -0400
  318. Return-Path: <@VM1.NODAK.EDU:LISTSERV@VM1.NODAK.EDU>
  319. Received: from VM1.NODAK.EDU by VM1.NoDak.EDU (IBM VM SMTP V2R2)
  320.    with BSMTP id 1210; Sat, 09 Oct 93 02:20:32 CDT
  321.  
  322. Received: from VM1.NODAK.EDU (NJE origin LISTSERV@NDSUVM1) by VM1.NODAK.EDU (LMail V1.1d/1.7f) with BSMTP id 4642; Sat, 9 Oct 1993 02:20:30 -0500
  323. Date:         Sat, 9 Oct 1993 02:20:29 -0500
  324. From: BITNET list server at NDSUVM1 (1.7f) <LISTSERV@VM1.NODAK.EDU>
  325. To: monkoty@AOL.COM
  326. Subject: #1(3)      File: "PDGET HELP"
  327. AOL-Member: monkoty
  328.  
  329.