home *** CD-ROM | disk | FTP | other *** search
/ Programmer's ROM - The Computer Language Library / programmersrom.iso / ada / general / ftp2.doc < prev    next >
Encoding:
Text File  |  1988-05-03  |  19.8 KB  |  416 lines
  1.  
  2.  
  3.  
  4.                             THE SIMTEL20 ARCHIVES
  5.  
  6.  
  7.  
  8. OVERVIEW
  9.  
  10.      There is a collossal amount of free public domain CP/M, PCDOS/MSDOS and
  11. UNIX software in several archives on SIMTEL20.ARPA, a DEC-20 running the
  12. TOPS-20 operating system at White Sands Missile Range.  Now, a new archive of
  13. software for the DoD standard programming language, Ada, is being added.
  14. Archives of correspondence for several newsgroups, including INFO-CPM, are
  15. also available.
  16.  
  17.      You can obtain these files using the InterNet file transfer protocol, FTP
  18. (described in a following paragraph), with user-name "anonymous".  For a
  19. password, use your host-name or any other string of printing characters.
  20. Throughout this message, FTP examples are given in a GENERIC syntax.  You will
  21. have to consult either local documentation or your friendly system wizard to
  22. learn the actual syntax used with your local mainframe operating system.  For
  23. the sake of brevity, the domain suffix ".ARPA" will be dropped from further
  24. references to SIMTEL20 in this discussion.
  25.  
  26.      To obtain directory listings, connect to SIMTEL20 via FTP and do this:
  27.  
  28.                 get micro:<cpm>cpm.crclst 
  29.                 get micro:<cpmug>cpmug.crclst 
  30.                 get micro:<sigm>sigm.crclst 
  31.         get PD:<unix>unix.crclst 
  32.         get micro:<pc-blue>pc-blue.crclst 
  33.         get PD:<ada>ada.crclst
  34.  
  35. The first archive was once on MIT-MC.  This is the one to watch for the very
  36. latest CP/M offerings, as it is updated frequently.  The second is the full
  37. catalog of the CP/M Users Group (CPMUG), and the third is the full catalog of
  38. the Special Interest Group for Microcomputers (SIG/M), a service of the
  39. Amateur Computer Group of New Jersey.  The fourth contains UNIX-related
  40. software, not all of which is CP/M-specific.  That which applies specifically
  41. to CP/M is in the directory <UNIX.CPM>.  The fifth archive contains software
  42. for the IBM-PC.  Some runs under CP/M, and some under PC-DOS/MS-DOS.  The
  43. second, third and fifth archives are updated as new disks are issued by the
  44. associated users' groups.  Now, a sixth archive containing Ada software is
  45. being added.  Plans for this new archive are detailed in two SIMTEL20 files,
  46. PD:<ADA.GENERAL>READ.ME and PD:<ADA.GENERAL>ADAREPOS.TXT, which can be
  47. obtained using the FTP procedures described in this message.
  48.  
  49.      There are many overlaps in the first three archives, but you will find
  50. the latest CP/M programs in the <CPM> archive.  In general, the archived
  51. software is very good, having been worked-over and refined by many users.  The
  52. comments tend to be complete and informative.
  53.  
  54.  
  55.  
  56. FILE TYPES
  57.  
  58.      Files in the <CPM>, <SIGM>, <CPMUG> and <PC-BLUE> archives are stored in
  59. two formats:  Usually, ASCII storage is used for DOC, HEX and ASM files, and
  60. ITS binary is used for COM, LBR and squeezed files.  ITS binary format had its
  61. origin at MIT.  Each file begins with a 36-bit identifier-word containing DSK8
  62. in SIXBIT code.  This reads as 446353300000 in octal, and 933AD8000 in hexa-
  63. decimal.  All data are stored as four 8-bit bytes per 36-bit SIMTEL20 word,
  64. with the low-order four bits of each word filled with zeros.  If such a file
  65. is interpreted as a contiguous string, as will happen if a straight binary
  66. transfer is made to a 16 or 32-bit UNIX machine, the four zero filler-bits per
  67. 36-bit group will cause rather bizarre and frustrating results.  The methods
  68. for dealing with this situation, which differ from machine to machine, are
  69. explained in a following paragraph.
  70.  
  71.      Squeezed files have been compressed using programs available in directory
  72. <CPM.SQUSQ> to obtain an approximate 35-percent size reduction.  These files
  73. can be identified by the letter Q in the extension field.  For example, the
  74. file MICRO:<CPM.MODEM903>DEFF.AQM is a squeezed file.  It must be transferred
  75. as a binary file, and then unsqueezed.  The unsqueezing can be done on a CP/M
  76. system using USQ-20.COM (or whatever is the current version from directory
  77. <CPM.SQUSQ>), or there are several host-based unsqueezers in the <CPM> and
  78. <UNIX> archives (see for example, directories <CPM.TOPS-20> and <UNIX.CPM>).
  79.  
  80.      Although the type of storage used for a particular file can usually be
  81. inferred from the file-name, this is not always true.  It is a good idea to
  82. check the appropriate "crclst" file to ascertain the storage format used for
  83. each file of interest.  This applies to all of the archives except <UNIX> and
  84. <ADA>, where ALL files are presently stored in ASCII.  Now, and for the
  85. foreseeable future, storage formats for files in the <SIGM>, <CPMUG> and
  86. <PC-BLUE> archives can be determined from their "generation numbers", as
  87. shown by the FTP directory command.  For example, the FTP command:
  88.  
  89.         dir micro:<pc-blue.vol001>
  90.  
  91. will yield results of the form:
  92.  
  93.         -CATALOG.001.2
  94.         ABSTRACT.001.2
  95.         BW.ASM.2
  96.         BW.BAS.1
  97.         BW.EXE.1
  98.         COLOR.ASM.2
  99.         COLOR.BAS.1
  100.         COLOR.EXE.1
  101.         ...and so on
  102.  
  103. All files with names ending in ".1" are stored in ITS binary format, and
  104. those with names ending in ".2" are stored in ASCII.  This relationship will
  105. continue to apply for files in the <SIGM>, <CPMUG> and <PC-BLUE> archives
  106. until further notice.
  107.  
  108.      Important files in the <CPMUG> and <PC-BLUE> archives are the CATALOG
  109. files.  These files, which are stored in ASCII, contain (in reverse numerical
  110. order) the "-CATALOG.nnn" files from all the volumes of their respective
  111. archives.  To obtain these composite catalog files, connect to SIMTEL20 via
  112. FTP and do this:
  113.  
  114.         get micro:<cpmug>cpmug.cat 
  115.         get micro:<pc-blue>pc-blue.cat 
  116.  
  117. A similar file once existed for the <SIGM> archive, but it has been made
  118. unnecessary by SIG/M's issuance of a Volume 000 disk which contains several
  119. files with names of the form "SIG-Mx.CAT", where the "x" is replaced with a
  120. digit.  This group of files, taken together, comprise the current SIG/M
  121. catalog.  They can be obtained using FTP commands of the form:
  122.  
  123.         get micro:<sigm.vol000>sig-m1.cat
  124.  
  125. See the current SIGM.CRCLST for a complete list of Volume 000 files.  At
  126. present (unlike the "cat" files previously mentioned), these files are stored
  127. in ITS binary format.
  128.  
  129.      WARNING:  Because space on the SIMTEL20 disk-pack known as "MICRO:" is
  130. running out, plans are now being made to conserve storage through more
  131. extensive use of libraries and squeezed files, both of which are stored in
  132. ITS binary format.  Therefore, the number of files stored in ASCII will
  133. gradually diminish until only a few essential ASCII files remain.  If you
  134. cannot now properly transfer ITS binary files, you are urged to develop this
  135. capability.  If you need help, please contact your local system wizard and
  136. provide him/her with a copy of this message.  Having done that, if you are
  137. still unable to make things work correctly, then send a message addressed to
  138. INFO-CPM-REQUEST@AMSAA.ARPA and I will try to help you.  Please provide the
  139. following information:
  140.  
  141.     1. Machine and operating system  (e.g., VAX-11/780, 4.2 BSD UNIX)
  142.     2. Network software in use  (e.g., 3-Com UNET)
  143.     3. Complete list of available FTP commands  (e.g., GET, PUT, etc.)
  144.  
  145.  
  146.  
  147. FILE TRANSFER VIA FTP
  148.  
  149.      FTP stands for File Transfer Protocol, a formalized procedure for moving
  150. files among machines on the Defense Data Network (DDN) and other networks that
  151. connect with the DDN.  The protocol is implemented by a program often called
  152. FTP.  The different mainframe operating systems implement FTP with variations
  153. in command syntax.  Some systems have the remote-file-name precede the local-
  154. file-name in the command.  Others reverse this order.  Some versions have the
  155. whole command on a single input line, while others use multiple lines.  Read
  156. the documentation for your local system, or consult a friendly system wizard
  157. for the details of your local FTP command syntax.
  158.  
  159.      UNIX users can do something like "man ftp" for on-line instructions.
  160. However, not all UNIX FTP servers are called "ftp", so you may have to snoop
  161. around in the system directories or ask a system wizard for the correct local
  162. name to use with the "man" command.  ITS users can do ":INFO FTP", and  "HELP
  163. FTP" works on TOPS-20 and some other operating systems.  I will be happy to
  164. update this message with pointers to other sources of on-line documentation if
  165. they are sent to INFO-CPM-REQUEST@AMSAA.ARPA.
  166.  
  167.      FTP transfers from SIMTEL20 can be made with user-name "anonymous".  Use
  168. your host-name or any other string of printing characters for a password.  For
  169. anonymous logins, SIMTEL20 supports a limited form of the FTP "change working
  170. directory" command.  (Your local syntax may be something like CD, or CWD.)
  171. This command allows you to specify a default SIMTEL20 directory to be used for
  172. all file retrievals, and thereby relieves you from having to repeatedly type
  173. "micro:<whatever>" as part of each filename.  For example, you can do some-
  174. thing like this:
  175.  
  176.         cd micro:<cpm.goodstuff>
  177.         get filename-1
  178.         get filename-2
  179.         ...and so on
  180.  
  181. instead of using the longer filename forms shown in previous examples.
  182. saver.
  183.  
  184.      Users of TOPS-10, TENEX, TOPS-20 or ITS systems can use "image" or
  185. "paged" mode for ALL transfers.  UNIX users must use "ascii" mode for ASCII
  186. files, and "tenex" or "type L 8" mode for ITS binary files.  MULTICS users
  187. must use "ascii" mode for ASCII files, and "image" mode for ITS binary.
  188.  
  189.      Once an ITS binary file has been transferred to your mainframe, further
  190. processing is needed to make it into a standard CP/M file.  This processing is
  191. done automatically by the programs used on TOPS-20 and ITS machines for
  192. downloading to a micro, so those users need not be concerned with this.  UNIX
  193. users have only to remove the first four bytes of each file.  These four bytes
  194. are a special "ITS header", and are not really a part of the file.  They can
  195. be removed using the UNIX utility "dd", or they can be removed using the CP/M
  196. program ITSCVT, available as an ASCII-transferable HEX file in directory
  197. MICRO:<CPM.HEX>.
  198.  
  199.      Post-processing of files on MULTICS machines can be done using a modified
  200. version of the system copy utility.  At present, transfer of this program is
  201. a delicate matter because of the need to preserve the vendor's proprietary
  202. rights.  If you need this utility, send a message to INFO-CPM-REQUEST at
  203. AMSAA.ARPA, and I'll put you in touch with the person who has the program.
  204.  
  205.      Anyone who can obtain an exact contiguous copy of an ITS binary file 
  206. (probably using "image" mode), and then download it to a CP/M machine without
  207. losing any bits, can post-process the file into standard format using a CP/M
  208. program available from INFO-CPM-REQUEST.  If there is enough interest in this
  209. program, it can be added to the <CPM> archive.  If it is necessary for you to
  210. take this route, study the description of ITS binary format given in the 
  211. section on FILE TYPES, so that you will know what to expect.  This method 
  212. worked satisfactorily with transfers to our 16 and 32-bit UNIX machines before
  213. we learned to use "tenex" mode.
  214.  
  215.      All aspects of the FTP process for UNIX machines have been automated to
  216. a high degree by a pair of programs in directory PD:<UNIX.CPM>.  With these
  217. programs, a simple command like "m7b mdm730.com" can connect to SIMTEL20,
  218. transfer the ITS binary file "mdm730.com" from directory MICRO:<CPM.MODEM7>
  219. to a local file also named "mdm730.com" and strip the ITS header, all with no
  220. user intervention.  Batch command files containing multiple lines of the form
  221. in the above example can be run in no-hangup background mode to transfer
  222. whole directories without the user even remaining logged-in on his local
  223. system.  For more information, get the file PD:<UNIX.CPM>AUTOFTP.DOC.
  224.  
  225.  
  226.  
  227. PROGRAMS FOR TRANSFERRING FILES AMONG MAINFRAMES AND MICROS
  228.  
  229. Christensen Protocol Mainframe Programs:
  230.  
  231.      For a micro to reliably exchange files with a mainframe, cooperating
  232. file transfer programs with automatic error detection and retransmission of
  233. faulty blocks must be running on both computers.  One such family of programs
  234. uses a popular protocol created by Ward Christensen and enhanced by others.  
  235. Directory PD:<UNIX.CPM> contains two programs, UC and the older UMODEM
  236. (both written in C), which implement this protocol on UNIX machines.  See the
  237. file PD:<UNIX>UNIX.CRCLST for a list of other useful UNIX utilities.
  238.  
  239.      On ITS machines, file transfer using the Christensen protocol can be done
  240. using MMODEM (type :MMODEM for instructions), or LMODEM.  Documentation for
  241. LMODEM is in file .INFO.;LMODEM HELP.  Other useful ITS utilities (also
  242. available for TOPS-20) include:
  243.  
  244.     TYPE8 - types an ASCII file stored in ITS binary format.
  245.     TYPESQ - types an ITS binary format "squeezed" file (see the first
  246.              paragraph under FILE TYPES).
  247.     USQ - creates an unsqueezed version of a squeezed file.
  248.     HEXIFY - creates an Intel hex format file from an ITS binary format
  249.              COM file.
  250.     COMIFY - creates a COM file from an Intel hex file.
  251.     CRC - computes the Cyclic Redundancy Check value for a file, using
  252.           the same algorithm that is used by the CP/M program CRCK.
  253.  
  254. Brief instructions for any of these utilities except LMODEM can be obtained by
  255. typing ":utility_name" (for example, :CRC).
  256.  
  257.      TOPS-20 utilities for transferring and manipulating files can be found in
  258. directory MICRO:<CPM.TOPS-20>.  See MICRO:<CPM>CPM.CRCLST for a list of
  259. available programs.
  260.  
  261.      File transfer and conversion utilities for use with VAX/VMS machines are
  262. contained in directory MICRO:<CPM.VAXVMS>.  See CPM.CRCLST for details.
  263.  
  264.  
  265. Christensen Protocol Microcomputer Programs:
  266.  
  267.      An excellent program for transferring files between micros, or between
  268. micros and mainframes is called MODM7xx, where the "xx" is replaced with two
  269. digits to give the current version number.  This program, often referred to as
  270. MODEM7 (the name of its easier to pronounce ancestor), uses the popular
  271. Christensen protocol to transfer files with automatic error detection and
  272. retransmission of erroneous blocks.  
  273.  
  274.      To get started with MODM7xx, you should first FTP and examine two files
  275. from the directory MICRO:<CPM.MODEM7>.  After connecting to SIMTEL20, do this:
  276.  
  277.         get micro:<cpm.modem7>modm7xx.doc 
  278.         get micro:<cpm.modem7>modm7xx.msg 
  279.  
  280. Both are ASCII files.  Together, they will tell you just about all there is to
  281. know about getting the program to run on your machine.  Take the time to read
  282. these files; they're quite informative.  You will also get some helpful
  283. insights from reading some of the overlay files.  These overlays, described in
  284. file MICRO:<CPM.MODEM7>M7OVL-yy.LST, are used to customize MODM7xx for
  285. particular machines without having to edit and assemble the huge MODM7xx
  286. source file.  Complete instructions for performing this procedure are
  287. contained in each overlay file.  The letters "yy" in the above filename should
  288. be replaced with two digits giving the current version number as determined
  289. from CPM.CRCLST.
  290.  
  291.      And then, there is MEX.  MEX stands for "modem executive", and it is just
  292. what the name implies, a communications and file-transfer program with a
  293. built-in mini operating system that runs under CP/M.  This program can do file
  294. transfers using either the Christensen or Compuserve protocol, and it has an
  295. enormous potential for highly automated operations because it can read and
  296. execute command-scripts pre-stored in disk files.  These scripts can include
  297. sending commands to a remote computer, as if they had been sent manually from
  298. the microcomputer in terminal-mode.  Users of this relatively new program are
  299. still exploring its possibilities.  For more information, look in CPM.CRCLST
  300. under the heading "MICRO:<CPM.MEX>", and then get the various files that have
  301. "DOC" in their names.  Overlays for MODM7xx will also work with MEX, but they
  302. will not provide all of the extended MEX features.
  303.  
  304.  
  305. Kermit:
  306.  
  307.      Another excellent program for transferring files is called KERMIT.  This
  308. program has the advantage of being available for an impressively large number
  309. of mainframes and micros.  It is, for example, available for the IBM-PC, and
  310. it DOES NOT require CP/M.
  311.  
  312.      To get started with KERMIT, connect to CU20B.ARPA using FTP, and do this:
  313.  
  314.         get PD:<kermit>00readme.txt 
  315.         get PD:<kermit>current.doc 
  316.  
  317. Note that (1) these files are NOT on SIMTEL20, and (2) the first filename
  318. begins with "zero-zero".
  319.  
  320.      After reading 00README.TXT, look at CURRENT.DOC and see what versions
  321. are currently available.  Questions can be addressed to INFO-KERMIT-REQUEST
  322. at CU20B.ARPA.
  323.  
  324.  
  325. Getting Started:
  326.  
  327.      In order to get MODM7xx, MEX or KERMIT running on your micro, you must
  328. first transfer the necessary files from mainframe to micro.  If you already
  329. have a receive-to-disk communications program of some sort, you can use it to
  330. move the needed files.  It is VERY CONVENIENT to be able to transfer 8-bit
  331. binary files, although in most cases it is not absolutely necessary.  Some of
  332. the files are quite large.  For example, MODM7xx.COM is over 18K bytes, and
  333. the HEX file (which you will need if you can't transfer 8-bit files) is over
  334. 45K.  Moving large files to your micro without using an error detecting
  335. protocol can result in frustrating errors, but it can be done by receiving
  336. multiple copies and using manual or machine-assisted comparisons to locate and
  337. repair bad parts of the code.  However, there IS a better way.
  338.  
  339.      Directory MICRO:<CPM.MODEM> contains a file that can be FTPed to your
  340. mainframe, printed, and then entered into your micro by hand and assembled. 
  341. It is quite short.  To examine this option, connect to SIMTEL20 via FTP and
  342. do this:
  343.  
  344.         get micro:<cpm.modem>pipmodem.asm 
  345.         get micro:<cpm.modem>pipmodem.doc 
  346.         get micro:<cpm.modem>mboot3.asm 
  347.  
  348. All are ASCII files.  Read PIPMODEM.DOC first, then look at MBOOT3.ASM.
  349. PIPMODEM.DOC explains the situation very nicely.  Questions concerning these 
  350. programs should be sent to INFO-CPM@AMSAA.ARPA (NOT to INFO-CPM-REQUEST).
  351.  
  352.  
  353.  
  354. NEWSGROUP CORRESPONDENCE ARCHIVES
  355.  
  356.      Copies of correspondence for several newsgroups are kept in directory
  357. PD:<MAIL.ARCHIVES> on SIMTEL20.  (Note that, unlike all of the other SIMTEL20
  358. files discussed so far, these are NOT kept in the "MICRO:" structure.)  At
  359. present, archives for the following newsgroups are available:
  360.  
  361.         ADA-SW
  362.         AMETHYST-USERS
  363.         INFO-APPLE
  364.         INFO-CPM
  365.         INFO-FORTH
  366.         INFO-HAMS
  367.         INFO-MICRO
  368.         INFO-MODEM7
  369.         INFO-MODEMXX
  370.         NORTHSTAR-USERS
  371.         INFO-PASCAL
  372.  
  373. Descriptions of these, and other, newsgroups can be obtained via FTP with
  374. anonymous login (as for SIMTEL20) from the Network Information Center's host
  375. SRI-NIC.ARPA.  Ask for the file PD:<NETINFO>INTEREST-GROUPS.TXT (an ASCII
  376. file).
  377.  
  378.      File names for SIMTEL20 newsgroup correspondence archives have two
  379. forms.  For example, PD:<MAIL.ARCHIVES>CPM.ARCHIV.ymmdd  is a group of files
  380. containing INFO-CPM correspondence going back several years.  The characters
  381. "ymmdd" in the file names are actually digits giving the year, month and day
  382. of the last message in each particular file.  Current correspondence is kept
  383. in the file PD:<MAIL.ARCHIVES>CPM-ARCHIV.TXT, which is constantly growing.
  384. Although INFO-CPM has been used as an example here, the same naming scheme
  385. is used for the other newsgroup files as well.  For a complete list of
  386. available files, connect to SIMTEL20 via FTP and do this:
  387.  
  388.         dir PD:<mail.archives>
  389.  
  390. At present, all of these files are stored in ASCII.
  391.  
  392.  
  393.  
  394. ADDITIONS, IMPROVEMENTS AND CORRECTIONS
  395.  
  396.      Suggestions for additions, improvements and corrections to this message
  397. are always welcome.  Please send them to INFO-CPM-REQUEST@AMSAA.ARPA.
  398.  
  399.      Contributions of public domain software are actively solicited.  If you
  400. have something that seems appropriate for inclusion in the <CPM> archive, 
  401. please contact Keith Petersen <W8SDZ@SIMTEL20>.  Likewise, contact Richard
  402. Conn <ADA-SW-REQUEST@SIMTEL20> if you wish to contribute to the <UNIX> or
  403. <ADA> archive.
  404.  
  405.  
  406.      Happy hacking!
  407.  
  408.  
  409.  
  410.                     Dave Towson
  411.                     INFO-CPM-REQUEST@AMSAA.ARPA
  412.  
  413.  
  414.  
  415.  
  416.