home *** CD-ROM | disk | FTP | other *** search
/ Carousel / CAROUSEL.cdr / mactosh / doc / macarchi.txt < prev    next >
Text File  |  1988-12-13  |  14KB  |  323 lines
  1. 123456789012345678901234567890123456789012345678901234567890
  2.                 THE SIMTEL20 MACINTOSH ARCHIVES
  3.  
  4.  
  5.  
  6. OVERVIEW:
  7.  
  8. There is a colossal amount of free public domain software for
  9. the CP/M, PCDOS/MSDOS, MACINTOSH and UNIX operating systems,
  10. and  for the DoD standard programming language, Ada, in 
  11. several archives on WSMR-SIMTEL20.ARMY.MIL, a DECsystem-20 
  12. running the TOPS-20 operating system at White Sands Missile 
  13. Range.N.M.
  14.  
  15. You can obtain these files using the InterNet file transfer
  16. protocol, FTP.  Throughout, FTP examples are given in a GENERIC
  17. syntax. You will have to consult either local documentation 
  18. or your friendly system wizard to learn the actual syntax used
  19. with your local mainframe operating system. For the sake of 
  20. brevity, the domain suffix ".ARMY.MIL" will be dropped from 
  21. further references to WSMR-SIMTEL20 in this document.
  22.  
  23. To obtain directory listings, connect to WSMR-SIMTEL20 
  24. via FTP and do this:
  25.  
  26. Type at the prompt: FTP> getPD1:<macintosh>macintosh.crclst 
  27. A copy of the list will be sent to your host computer.
  28.  
  29. *HINT*
  30.  
  31. dir PD1:<macintosh>*  <-- displays a listing of the sub-directories 
  32.  
  33. A listing of current sub directories is provided below. This list
  34. will from time to time be updated due to the changes brought about 
  35. by the Mac.
  36.  
  37.         PD1:<MACINTOSH.sub directory>
  38.     where sub directory = one of the following
  39.             
  40. .APPL ........ Applications
  41. .CDEV ........ CDEV's 
  42. .CODE ........ Programming source code (except UNIX)
  43. .COMM ........ Communication Applications and Utilities
  44. .DA   ........ Desk Accessories
  45. .DEMO ........ Demonstrations of new software
  46. .DOC ......... Documentation for apps NOTin archives
  47. .ED .......... Education
  48. .FKEY ........ FKeys
  49. .FONTS ....... Fonts for ImageWriter I and II
  50. .HC .......... All HyperCard stacks and XCMDS etc.
  51. .INIT ........ INIT's
  52. .LANG ........ Programming Languages and utilities
  53. .MACII ....... Macintosh II specific apps
  54. .MACTN ....... Macintosh Tech Notes (From Apple)
  55. .NEWS ........ Macintosh news items
  56. .PATCHES ..... Small "fixes" by the software developer 
  57. .PICT ........ Pictures
  58. .REVIEW ...... Software reviews
  59. .SOUNDS ...... Music, sounds, and utilities
  60. .TECH ........ General technical information
  61. .UNIX ........ UNIX programs and utilities
  62. .UTIL ........ Misc. Utilities
  63. .UTILDSK ..... Disk Utilities, Fast formatters, etc.
  64. .UTILFIL ..... File Utilities
  65. .UTILPRN...... Printer Utilities
  66. .VIRUS ....... Anti-Virus detectors and killers (we hope)
  67.  
  68.  
  69. Sub-directories have a file labeled "00README.TXT". It will help you 
  70. to take the time to read this file. You may have to do this on line 
  71. with the "TYPE" [filename] command or you may use the "GET" 
  72. [filename] command and read the doc on your host computer or PC It 
  73. describes files listed in that sub directory. This file is Tab 
  74. delimited so you can use a data base program to input the data 
  75. for easy retrieval, if you wish.
  76.  
  77.              *** PLEASE NOTE *** 
  78.  
  79. Due to the large number of files available, the archives maintainers 
  80. CANNOT possibly attempt to validate the proper operation of the various 
  81. programs.  When a program bug is reported, immediate action is taken to 
  82. either correct the error or remove the offending program from the archives.  
  83. Still, users must understand that all archives programs are offered 
  84. ** AS IS **. THE ARCHIVES MAINTAINERS SPECIFICALLY DISCLAIM ANY LIABILITY 
  85. SHOULD THESE PROGRAMS MALFUNCTION OR CAUSE DAMAGE, INCIDENTAL OR OTHERWISE.  
  86. When testing ANY new software, be certain that all information stored on 
  87. disk is backed-up before you start, so that you can recover if files are 
  88. damaged or erased.  This is particularly true if you have a hard disk, in 
  89. which case malfunctions can be spectacularly disastrous. If you have any 
  90. doubt about any software you *ever* receive, run it from floppy disks and
  91. use the applications  found in PD1:<MACINTOSH.VIRUS>. They can only check 
  92. for KNOWN virus, but they are better than doing nothing!
  93.  
  94. FILE TYPES:
  95.  
  96. Files are stored in four formats:
  97.  
  98. . ASCII, UNCOMPRESSED, with an extension of:
  99. [filename].TXT..... for use with 00README files
  100.  
  101. . BINARY, COMPRESSED, with the following extensions.
  102. [filename].DOC..... for all doc's not with an application
  103. [filename].SIT..... for all applications, utilities,etc.
  104.  
  105. . BINARY,GIFFER, with an extension of:
  106. [filename].GIF..... for use with GIFFER Pictures
  107.  
  108. .BINARY, with an extension of:
  109. [filename].BIN.... for some "bootstrap" programs 
  110.  
  111. The only time you will find  [filename].TXT use in the PD1:<MACINTOSH.*> 
  112. area is for the 00README.TXT file which is in each sub directory. This 
  113. file is a one line explanation of the files contained in that area. 
  114. The format is generally: [filename].ext TAB {date, description}.
  115.  
  116. The  [filename].GIF extension is for the pictures that are stored in 
  117. the more or less standard format of "GIFFER". IBM or compatibilities 
  118. can access and display these files by simply removing the 128 byte 
  119. header on each picture.
  120.  
  121. All Binary data are stored as four 8-bit Bytes per 36-bit SIMTEL20 word, 
  122. with the low-order four bits of each word filled with zeros. If such a 
  123. file is interpreted as a contiguous string, as will happen if a straight 
  124. binary transfer is made to a 16 or 32 bit UNIX machine, the four zero 
  125. filler bits per 36 bit group will cause rather bizarre results.
  126.  
  127. The [filename].BIN extension is for a limited number of programs you 
  128. may need to "get started" in your downloading. As an example. Since 
  129. most of the files on the SIMTEL20 are in the .SIT format the program 
  130. to un-Stuff the files is in a form whereby all you have to do is FTP 
  131. the file to your Host computer in BINARY. Please make sure you under-
  132. stand how to do this. See the section "File Transfer via FTP for more 
  133. details. After you have FTP'ed the file you can download it to your 
  134. Mac with any program that supports MacBinary dowloading. After the 
  135. download is completed you can just double click on the filename icon 
  136. and you will be in the application and working.
  137.  
  138.  
  139. FILE NAMES:
  140.  
  141. Files are named using no more than 14 characters before the "." with up 
  142. to 3 characters for the extension. Since many times the real name, reduced 
  143. to 14 characters would have little or no meaning to you nor myself I have 
  144. taken the liberty of putting a Header on the file and a number. You will 
  145. find this method a little surprising but it really does make sense. The 
  146. MUSIC, MACTN, and CODE sub directories are set up exclusively this way.
  147.  
  148. A couple of examples might be helpful:
  149.  
  150. PD1:<MACINTOSH.MACTN
  151.     TN024-NEW0888     This shows the TechNote number and the date published 
  152.                 but not the title of the TechNote. The 00README file 
  153.                 in the MACTN sub directory will have the title.
  154.  
  155.     TN025-REV0888     This shows the TechNote number and the date Revised by 
  156.                 Apple. Again the title is not shown as the 00README 
  157.                 file will have the title.
  158.  
  159. PD1:<MACINTOSH.MUSIC>
  160.     MU0001        This shows ONLY the MUSIC file number 0001 thru however 
  161.                 many music files we have. The name and description will 
  162.                 again be in the 00README file.
  163.  
  164.     SN0001        This shows ONLY the SOUND file number 0001 thru however 
  165.                 many sound files we have. The name and description will 
  166.                 again be in the 00README file.
  167.  
  168. PD1:<MACINTOSH.CODE>
  169.     ASM-nnnn        Denotes Assembly Code.     
  170.     BAS-nnnn        Denotes BASIC Source Code
  171.     C-nnnn        Denotes "C" Source Code
  172.     CSHAR-nnnn    Denotes related "C" files
  173.     P-nnnn        Denotes Pascal Source Code
  174.     PSHAR-nnnn    Denotes related Pascal files
  175.     RAS-nnnn        Denotes Rascal Source Code
  176.     RMKR-nnnn        Denotes RMaker Source Code
  177.     XLISP-nnnn       Denotes Xlisp Source Code
  178.     XSHAR-nnnn    Denotes related Xlisp Code
  179.  
  180.  
  181. FILE TRANSFER VIA FTP:
  182.  
  183. FTP stands for File Transfer Protocol, a formalized procedure for moving files
  184. among machines on the Defense Data Network (DDN) and other networks that connect 
  185. with the DDN.  The protocol is implemented by a program often called FTP.  The 
  186. different mainframe operating systems implement FTP with variations in command 
  187. syntax.  Some systems have the remote-file-name precede the local-file-name in 
  188. the command. Others reverse this order. Some versions have the whole command on 
  189. a single input line, while others use multiple lines.  Read the documentation for 
  190. your local system, or consult a friendly local system wizard for the details of 
  191. your FTP command syntax.
  192.  
  193. UNIX users can do something like "man ftp" for on-line instructions. However, 
  194. not all UNIX FTP programs are called "FTP", so you may have to snoop around in 
  195. the system directories or ask a system wizard for the correct local name to use 
  196. with the "man" command. ITS users can do ":INFO FTP". "HELP FTP" works on TOPS-20 
  197. and some other operating systems.
  198.  
  199. FTP transfers from SIMTEL20 can be made with user-name "anonymous." 
  200. Use GUEST for the password.  For anonymous logins, SIMTEL20 supports the FTP 
  201. "change working directory" command.  (Your local syntax may be something like 
  202. CD, or CWD). *(Ignore the message which may appear that prompts you to enter 
  203. a password.)*  This command allows you to specify a default SIMTEL20 directory 
  204. to be used for file retrievals, and thereby relieves you from having to repeatedly 
  205. type "PD1:<macintosh.directory name>" as part of each filename.  For example, you 
  206. can do something like this:
  207.  
  208. FTP>cd PD1:<macintosh.goodstuff>
  209. FTP>get filename-1
  210. FTP>get filename-2
  211.   ...and so on
  212. instead of using the longer filename forms shown in previous examples.
  213.  
  214. Users of TOPS-10, TENEX, TOPS-20 or ITS systems can use "image" or "paged" 
  215. mode for ALL transfers.  UNIX users must use "ascii" mode for ASCII files, 
  216. and "type tenex" or "type L 8" mode for binary files. MULTICS users can use 
  217. "ascii" mode for ASCII files, but binary files require special treatment. 
  218. VMS also requires a special setting. Instead of using "BGET" type "Quote Type L-8 
  219. and use "GET" *NOT* "BGET" which is many many cases does not work correctly.
  220.  
  221. The following example provided by Lee  Choquetteu-<ichoqu@ug.utah.edu.>:
  222. shows FTP'ing from a UNIX host.
  223.  
  224.                 *NOTE*
  225.  
  226. Lines with "!" are typed by the terminal user.
  227.  
  228.  
  229.  ug>!_ftp WSMR-SIMTEL20.ARMY.MIL
  230. Connected to WSMR-SIMTEL20.ARMY.MIL
  231.  WSMR-SIMTEL20.ARMY.MIL FTP Server process 5Z(50)-7 at Thu 4-xxx-88
  232. !_name (WSMR-SIMTEL20.ARMY.MIL:u-lchoqu): anonymous
  233.  ANONYMOUS user ok, send real ident as password.
  234. Password: !_(GUEST WILL DO FINE HERE)
  235.  User ANONYMOUS logged in at Thu 4-xxx-88 17:15-MDT, job 10.
  236. ftp>!_cd PD1:<MACINTOSH.MACTN>
  237.  Default name accepted. Send password to connect to it.
  238. !_(carriage return)
  239. ftp>!_tenex (or type l 8) <-- NOTE: That's lowercase "L"8.
  240.  Type L bytesize 8 ok.
  241. ftp>!_get TN40-786 tn40
  242.  Port 17.176 at host 128.110.0.0 accepted
  243.  Retrieve of PD1:<MACINTOSH.MACTN>TN40-786..1   started.
  244.  Transfer completed. 4480 (8) bytes transferred
  245. local: tn40 remote: tn40-786
  246.  bytes received in 4.3 seconds  (1kbytes/s)
  247. ftp> get TN69-386 AND SO ON.
  248. ftp>!_bye or quit
  249.  QUIT command received. Goodbye.
  250.  ug>!_kermit -ix
  251.  
  252. C-Kermit server starting. Return to your local machine by typing  its 
  253. escape sequence for closing the connection,  and issue further commands 
  254. from there. To shut down the C-Kermit server, issue the FINISH or BYE 
  255. command and then reconnect.
  256.  
  257. The received files are stored with one 8-bit byte per 9-bit word.
  258.  
  259. After starting up the UNIX Kermit with -i (binary), and -x (server), set 
  260. your Macintosh Kermit's File Defaults to Mode: Binary and Fork: Data and do Get File TN*
  261.  
  262. After downloading, run the file/s through STUFFIT and uncompress as necessary.
  263.     
  264.             WARNING
  265.  
  266. Because the public domain archives on SIMTEL20 consume a huge amount of 
  267. disk space, storage capacity must be conserved by the greatest practical 
  268. use of compressed files, which are stored in binary format. If you cannot 
  269. properly transfer binary files, you are going to be VERY FRUSTRATED!
  270. If you need help, please contact your local system wizard and provide him/her 
  271. with a copy of these doc's. Having done that, if you are still unable to make 
  272. things work correctly, have your system wizard send a message to: 
  273. RTHUM@WSMR-SIMTEL20.ARMY.MIL and I will try to help.Please have them provide 
  274. the following information:
  275.  
  276. . Machine and system  (e.g., VAX-11/780, 4.2 BSD UNIX)
  277. . Network software in use  (e.g., 3-Com UNET)
  278. . Complete list of available FTP commands  (e.g., GET, PUT)
  279.  
  280.  
  281. PROGRAMS FOR TRANSFERRING FILES AMONG MAINFRAMES AND MICROS:
  282.  
  283. With the wide and varied types of mainframes and micros and with so many 
  284. many different terminal programs, your best approach for downloading to 
  285. your micro will be to contact your local system guru, who will is better 
  286. equipped to help solve your local problems.
  287.  
  288. RedRyder:
  289.  
  290. An excellent program for transferring files between micros, or between micros 
  291. and mainframes is called RedRyderxxx where the xxx is replaced by digits to 
  292. give the version number. This program can use one of several different protocols 
  293. to facilitate file transfers. Not only is Christensen Protocol supported but 
  294. the more popular error checking, called CRC (for Cyclic Redundancy Check) is 
  295. the automatic default. This simply means RR will automatically ask the mainframe 
  296. if it supports CRC error checking, if it says no, RR will switch. X modem protocol 
  297. and Kermit in RedRyder, are two ways to download the file from your host computer 
  298. to your Macintosh. The only thing you will notice is a slight pause before starting 
  299. the file transfer. Kermit has the advantage of being available for an impressively 
  300. large number of mainframes and micros. Universities most notably use Kermit.
  301.  
  302.                 *NOTE*
  303. Kermit has several versions. You WILL have problems if you do not have Mac Kermit 
  304. Version 0.9 (40) or greater.
  305.  
  306.  
  307. ADDITIONS, IMPROVEMENTS AND CORRECTIONS:
  308.  
  309. Suggestions for additions, improvements and corrections to this message are always
  310.  welcome. Please send them to RTHUM@WSMR-SIMTEL20.ARMY.MIL.
  311.  
  312. Contributions of public domain software are actively solicited.If you have 
  313. something that seems appropriate for inclusion in the <MACINTOSH> archives please 
  314. contact RTHUM@WSMR-SIMTEL20.ARMY.MIL
  315.  
  316.  
  317.      Happy MAC'ing!
  318.     Robert Thum
  319.     rthum@WSMR-SIMTEL20.ARMY.MIL  *best*
  320.     rthum@WSMR-EMH10.ARMY.MIL     *if you must*
  321.  
  322.  
  323.