home *** CD-ROM | disk | FTP | other *** search
/ Programmer's ROM - The Computer Language Library / programmersrom.iso / ada / general / ftp.doc < prev    next >
Encoding:
Text File  |  1988-05-03  |  26.9 KB  |  589 lines

  1.  
  2.  
  3. ----> FTP.DOC <----
  4.  
  5.  
  6.                             THE SIMTEL20 ARCHIVES
  7.  
  8.  
  9.  
  10. SIGNIFICANT CHANGES
  11.  
  12.      New MSDOS  archive  added:   SIMTEL20  now  has  a  new  archive,
  13. PD:<MSDOS>.   This  archive,  like  the PD:<PC-BLUE> archive, contains
  14. software for the MSDOS and PCDOS operating systems.   But  unlike  PC-
  15. BLUE,  this archive is locally managed, and will be updated more often
  16. (the PC-BLUE archive is updated only when new disks are issued by  the
  17. PC-BLUE  Users  Group).   For  a  list  of  files,  get  a copy of the
  18. directory file, PD:<MSDOS>MSDOS.CRCLST.
  19.  
  20.      Newsgroup   correspondence   archive   files   moved:   Newsgroup
  21. correspondence   archives   have    been    moved    from    directory
  22. PS:<MAIL.ARCHIVES>  to individual directories having names of the form
  23. PS:<ARCHIVES.KEYWORD>, where "KEYWORD" has been chosen to indicate the
  24. associated   newsgroup.    See   the   section   entitled   "NEWSGROUP
  25. CORRESPONDENCE ARCHIVES" for additional details.
  26.  
  27.      Public  domain  archive  files  moved:   A  new large disk device
  28. called PD:  has been installed  to  house  the  entire  public  domain
  29. software   collection.   All  files  are  now  accessible  using  file
  30. specifications of the form:
  31.  
  32.                         PD:<directory_name>file_name
  33.  
  34. Example:
  35.  
  36.                         PD:<CPM.STARTER-KIT>LU310.COM
  37.  
  38.      New logical names:  Files  in  the  <CPM>  archive  can  also  be
  39. specified  with a new shortened notation using a logical name for each
  40. directory.  Thus, the file in the above example can also be  specified
  41. as:
  42.  
  43.                         STARTER-KIT:LU310.COM
  44.  
  45.         Note that the part of the directory name following the dot has
  46. been used as the logical name (followed by a  colon).   But  remember,
  47. this new form of file specification applies only to the <CPM> archive.
  48. To avoid confusion, all examples in the text to follow  will  use  the
  49. PD:  specification, as this form works with ALL of the archives.
  50.  
  51.      Getting  started:   The   above   example   provides   a   sneaky
  52. introduction  to  yet another new feature that should greatly ease the
  53. "bootstrap  phase"  for  new  archive  users.   Now  in   one   place,
  54. PD:<CPM.STARTER-KIT>, you will find all of the basic essentials needed
  55. to begin using the archives.  These programs  provide  the  means  for
  56. transferring,  unsqueezing  and  de-librarying archive files, and more
  57. will be said about them later in  this  document.   Special  kudos  to
  58. archive maintainer Keith Petersen for this worthwhile addition.
  59.  
  60.      Finally, a reminder:   For  quite  some  time  now,  "ITS  binary
  61. format"  has not been used for storage of binary files in the SIMTEL20
  62. archives.  If you are a new user of the archives and  you  don't  know
  63. what ITS binary format is, don't worry about it; it no longer matters.
  64. But apparently, some "veteran archive users" are still unaware of  the
  65. change.  Therefore, please note that stripping the first four bytes of
  66. binary files, once necessary for removal of the special "ITS  header",
  67. is  no  longer required.  Indeed, if you do this now, YOU WILL DESTROY
  68. THE FILES.
  69.  
  70.  
  71.  
  72. OVERVIEW
  73.  
  74.      There is a collossal amount of free public  domain  software  for
  75. the  CP/M,  PCDOS/MSDOS  and  UNIX  operating systems, and for the DoD
  76. standard  programming  language,   Ada,   in   several   archives   on
  77. SIMTEL20.ARPA,  a DECsystem-20 running the TOPS-20 operating system at
  78. White Sands Missile Range.  Archives  of  correspondence  for  several
  79. newsgroups, including INFO-CPM, are also available.
  80.  
  81.      You can obtain these  files  using  the  InterNet  file  transfer
  82. protocol,  FTP  (described  in  a following paragraph), with user-name
  83. "anonymous".  For a login password, use your host-name  or  any  other
  84. string  of printing characters.  Throughout this message, FTP examples
  85. are given in a GENERIC syntax.  You will have to consult either  local
  86. documentation  or  your  friendly  system  wizard  to learn the actual
  87. syntax used with your local mainframe operating system.  For the  sake
  88. of  brevity,  the  domain  suffix ".ARPA" will be dropped from further
  89. references to SIMTEL20 in this discussion.
  90.  
  91.      To  obtain directory listings, connect to SIMTEL20 via FTP and do
  92. this:
  93.  
  94.     
  95.                 get pd:<cpm>cpm.crclst 
  96.                 get pd:<cpmug>cpmug.crclst 
  97.                 get pd:<sigm>sigm.crclst 
  98.         get pd:<pc-blue>pc-blue.crclst 
  99.         get pd:<msdos>msdos.crclst
  100.         get pd:<unix>unix.crclst 
  101.         get pd:<ada>ada.crclst
  102.     
  103.  
  104.         The <CPM> archive is the one to watch for the very latest CP/M
  105. offerings, as it is updated frequently.  The <CPMUG>, <SIGM> and  <PC-
  106. BLUE>  archives  contain software distributed by the CP/M Users Group,
  107. the SIG/M Users Group and the PC-Blue Users Group respectively.   This
  108. software  is  available on diskettes from the associated users groups,
  109. and the archives are updated as new volumes are issued.  The <PC-BLUE>
  110. archive  contains  software for the IBM-PC and similar machines.  Some
  111. runs under CP/M, and some under PCDOS/MSDOS.  The <MSDOS> archive also
  112. contains  software for the MSDOS and PCDOS operating systems; but this
  113. archive is locally managed, and therefore is updated  more  frequently
  114. than  the <PC-BLUE> archive.  The <UNIX> archive contains a variety of
  115. UNIX tools.  Those  which  apply  specifically  to  CP/M  are  in  the
  116. directory   <UNIX.CPM>.    The   <ADA>  archive  is  growing  rapidly.
  117. Information about this archive is in directory  PD:<ADA.GENERAL>.   In
  118. general,  the  archived software is very good, having been worked-over
  119. and refined by many users.  The documentation and comments tend to  be
  120. complete  and  informative.   Files  in  all  of these archives can be
  121. obtained using the FTP procedures described in this message.
  122.  
  123.      But  please note that due to the large number of files available,
  124. the archive maintainers cannot possibly attempt to validate the proper
  125. operation  of  the  various programs.  When a program bug is reported,
  126. immediate action is taken to either correct the error  or  remove  the
  127. offending  program  from  the  archives.  Still, users must understand
  128. that  all  archive  programs  are  offered  AS  IS,  and  the  archive
  129. maintainers  specifically disclaim any liability should these programs
  130. malfunction or cause damage, incidental or  otherwise.   When  testing
  131. ANY  new  software,  be certain that all information stored on disk is
  132. backed-up before you start, so that  you  can  recover  if  files  are
  133. damaged or erased.  This is particularly true if you have a hard disk,
  134. in which case malfunctions can be spectacularly disasterous.
  135.  
  136.  
  137.  
  138. FILE TYPES
  139.  
  140.      Files are stored in two formats:  Text files such as  those  with
  141. names  that  end  with  DOC,  HEX, INF and ASM are sometimes stored as
  142. ASCII files, but usually these files are  stored  in  binary  squeezed
  143. form.   Binary  storage  is also used for executable (COM) and library
  144. files.  Squeezed and library files are described  below.   All  binary
  145. data are stored as four 8-bit bytes per 36-bit SIMTEL20 word, with the
  146. low-order four bits of each word filled with zeros.  If such a file is
  147. interpreted  as  a  contiguous  string,  as  will happen if a straight
  148. binary transfer is made to a 16 or 32-bit UNIX machine, the four  zero
  149. filler-bits per 36-bit group will cause rather bizarre and frustrating
  150. results.  The methods for dealing with this  situation,  which  differ
  151. from machine to machine, are explained in a following paragraph.
  152.  
  153.      Squeezed files have been compressed using programs  available  in
  154. directory   <CPM.SQUSQ>  to  obtain  an  approximate  35-percent  size
  155. reduction.  These files can be identified  by  the  letter  Q  in  the
  156. extension  field.  For example, the file PD:<CPM.ASMUTL>RMACPAT.AQM is
  157. a squeezed file.  It must be transferred as a binary  file,  and  then
  158. unsqueezed.   The  unsqueezing can be done on a CP/M system using USQ-
  159. xx.COM (where "xx" is the current version) from directory <CPM.SQUSQ>,
  160. or  there  are  several host-based unsqueezers in the <CPM> and <UNIX>
  161. archives (see for example, directories <CPM.TOPS-20> and <UNIX.CPM>).
  162.  
  163.      CP/M  library  files  (those  with  names  ending in LBR) combine
  164. several regular CP/M files into a single BINARY file which contains an
  165. internal  directory  of its contents.  They are created using the CP/M
  166. library utility LUxxx.COM (where "xxx" is the current version) or some
  167. other compatible utility.  The complete packages for LUxxx and a newer
  168. compatible program called NULUxx (where "xx" is the  version)  can  be
  169. found  in  directory  PD:<CPM.CPMLIB>.   C-language  source code for a
  170. compatible UNIX utility called LAR (library archiver) is in  directory
  171. PD:<UNIX.CPM>.
  172.  
  173.      Although the type of storage  used  for  a  particular  file  can
  174. usually  be  inferred from the file-name, this is not always true.  It
  175. is a good idea to check the appropriate "crclst" file to ascertain the
  176. storage  format  used  for  each  file  of interest.  Now, and for the
  177. foreseeable future, storage formats for files in the  <SIGM>,  <CPMUG>
  178. and  <PC-BLUE>  archives  can  be  determined  from  their "generation
  179. numbers", as shown by the FTP directory command.  For example, the FTP
  180. command:
  181.  
  182.                 dir pd:<pc-blue.vol001>
  183.  
  184. will yield results of the form:
  185.  
  186.     
  187.         -CATALOG.001.2
  188.         ABSTRACT.001.2
  189.         BW.ASM.2
  190.         BW.BAS.1
  191.         BW.EXE.1
  192.         COLOR.ASM.2
  193.         COLOR.BAS.1
  194.         COLOR.EXE.1
  195.         ...and so on
  196.     
  197.  
  198.         All files with names ending  in  ".1"  are  stored  in  binary
  199. format, and those with names ending in ".2" are stored in ASCII.  This
  200. relationship will continue to apply for files in the  <SIGM>,  <CPMUG>
  201. and <PC-BLUE> archives until further notice.
  202.  
  203.      WARNING:  Because the public  domain  archives  on  SIMTEL20
  204.                consume  a  huge  amount  of  disk-space,  storage
  205.                capacity  will  be  conserved  by   the   greatest
  206.                practical  use  of  libraries  and squeezed files,
  207.                both of which are stored in binary format.  If you
  208.                cannot  properly  transfer  binary  files, you are
  209.                going to be VERY FRUSTRATED!  If  you  need  help,
  210.                please   contact  your  local  system  wizard  and
  211.                provide him/her  with  a  copy  of  this  message.
  212.                Having  done that, if you are still unable to make
  213.                things work correctly, send a message to INFO-CPM-
  214.                REQUEST  at AMSAA.ARPA and I will try to help you.
  215.                Please provide the following information:
  216.  
  217.     
  218.     1. Machine and operating system  (e.g., VAX-11/780, 4.2 BSD UNIX)
  219.     2. Network software in use  (e.g., 3-Com UNET)
  220.     3. Complete list of available FTP commands  (e.g., GET, PUT, etc.)
  221.     
  222.  
  223.      Important  files  in  the  <CPMUG> and <PC-BLUE> archives are the
  224. CATALOG files.  These files, which are stored in ASCII, contain the "-
  225. CATALOG.nnn"  files from all the volumes of their respective archives.
  226. To obtain these composite catalog files, connect to SIMTEL20  via  FTP
  227. and do this:
  228.  
  229.     
  230.         get pd:<cpmug>cpmug.cat 
  231.         get pd:<pc-blue.vol000>pcblue.cat 
  232.     
  233.  
  234.         A similar file exists for the <SIGM> archive, but it is stored
  235. in  squeezed  form.   This  file, when unsqueezed, yields SIG.CAT (the
  236. catalog).  It can be obtained using the FTP command:
  237.  
  238.                 get pd:<sigm.vol000>sig.cqt
  239.  
  240.         (NOTE:  That's "L-and-three-zeros" in "vol000")
  241.  
  242.  
  243.  
  244. FILE TRANSFER VIA FTP
  245.  
  246.      FTP stands for File Transfer Protocol, a formalized procedure for
  247. moving  files  among  machines  on  the Defense Data Network (DDN) and
  248. other networks that connect with the DDN.  The protocol is implemented
  249. by  a  program  often  called  FTP.  The different mainframe operating
  250. systems implement FTP with variations in command syntax.  Some systems
  251. have the remote-file-name precede the local- file-name in the command.
  252. Others reverse this order.  Some versions have the whole command on  a
  253. single  input  line,  while  others  use  multiple  lines.   Read  the
  254. documentation for your local system,  or  consult  a  friendly  system
  255. wizard for the details of your local FTP command syntax.
  256.  
  257.      UNIX  users  can  do  something  like  "man  ftp"   for   on-line
  258. instructions.  However, not all UNIX FTP programs are called "ftp", so
  259. you may have to snoop around in the system directories or ask a system
  260. wizard  for the correct local name to use with the "man" command.  ITS
  261. users can do ":INFO FTP", and "HELP FTP" works  on  TOPS-20  and  some
  262. other  operating systems.  I will be happy to update this message with
  263. pointers to other sources of on-line documentation if they are sent to
  264. INFO-CPM-REQUEST@AMSAA.ARPA.
  265.  
  266.      FTP  transfers  from  SIMTEL20  can  be   made   with   user-name
  267. "anonymous".   Use  your  host-name  or  any  other string of printing
  268. characters for a password.  For anonymous  logins,  SIMTEL20  supports
  269. the FTP "change working directory" command.  (Your local syntax may be
  270. something like CD, or CWD.)  Ignore the message that  prompts  you  to
  271. enter  a  password.   This  command  allows  you  to specify a default
  272. SIMTEL20 directory to be used for all  file  retrievals,  and  thereby
  273. relieves you from having to repeatedly type "pd:<whatever>" as part of
  274. each filename.  For example, you can do something like this:
  275.  
  276.     
  277.         cd pd:<cpm.goodstuff>
  278.         get filename-1
  279.         get filename-2
  280.         ...and so on
  281.     
  282.  
  283. instead of using the longer filename forms shown in previous examples.
  284.  
  285.      Users of TOPS-10, TENEX, TOPS-20 or ITS systems can  use  "image"
  286. or  "paged"  mode for ALL transfers.  UNIX users must use "ascii" mode
  287. for ASCII files, and "tenex" or "type L  8"  mode  for  binary  files.
  288. MULTICS  users  can use "ascii" mode for ASCII files, but binary files
  289. require special treatment that is  best  described  by  the  following
  290. example provided by Paul Schauble <Schauble@mit-multics.arpa>:
  291.  
  292.     
  293.     !ftp simtel20
  294.      220 SIMTEL20.ARPA FTP Server Process 5Z(14)-7 at Mon 10-Sep-84 00:27-MDT
  295.  
  296.      user_ftp:  !login anonymous
  297.      331 ANONYMOUS user ok, send real ident as password.
  298.      Password:  !guest
  299.  
  300.      user_ftp:  !quote "type l 8" <--(NOTE: That's lowercase "L" 8.)
  301.      200 Type L bytesize 8 ok.
  302.  
  303.      user_ftp:  !get micro:<cpm.zcpr3>alias.hlp alias.hlp
  304.      150 Retrieve of MICRO:<CPM.ZCPR3>ALIAS.HLP.1 started.
  305.      226 Transfer completed.
  306.      Total elapsed time:  35.7 seconds.
  307.      4348 bytes transferred in 18.5 seconds (1850 bits/sec).
  308.  
  309.      user_ftp:  !quit
  310.      221 QUIT command received. Goodbye.
  311.     
  312.  
  313.         Lines beginning with "!"  are typed by the terminal user.  The
  314. received  files  are  stored  on MULTICS with one 8-bit byte per 9-bit
  315. word, and  can  be  trans-  ferred  to  a  microcomputer  with  Kermit
  316. (described in a following paragraph).
  317.  
  318.      All aspects of the  FTP  process  for  UNIX  machines  have  been
  319. automated  to  a  high degree by a program in directory PD:<UNIX.CPM>.
  320. With this program, a simple command like "mb modm700.com" can  connect
  321. to  SIMTEL20 and transfer the binary file "modm700.com" from directory
  322. PD:<CPM.MODEM7> to a local file also named "modm700.com", all with  no
  323. user  intervention.   Batch command files containing multiple lines of
  324. the form in the above example can be run in no-hangup background  mode
  325. to  transfer whole directories without the user even remaining logged-
  326. in  on  his  local  system.   For  more  information,  get  the   file
  327. PD:<UNIX.CPM>AUTOFTP.DOC.
  328.  
  329.  
  330.  
  331. PROGRAMS FOR FILE TRANSFER BETWEEN MAINFRAMES AND MICROS
  332.  
  333. Christensen Protocol Mainframe Programs:
  334.  
  335.      For  a  micro  to  reliably  exchange  files  with  a  mainframe,
  336. cooperating  file transfer programs with automatic error detection and
  337. retransmission of faulty blocks must be  running  on  both  computers.
  338. One  such  family  of programs uses a popular protocol created by Ward
  339. Christensen and enhanced by others.  Directory PD:<UNIX.CPM>  contains
  340. two  programs,  UC  and  the  older  UMODEM (both written in C), which
  341. implement  this   protocol   on   UNIX   machines.    See   the   file
  342. PD:<UNIX>UNIX.CRCLST for a list of other useful UNIX utilities.
  343.  
  344.      On ITS machines, file transfer using the Christensen protocol can
  345. be  done  using  MMODEM  (type  :MMODEM  for instructions), or LMODEM.
  346. Documentation for LMODEM is in file .INFO.;LMODEM HELP.  Other  useful
  347. ITS utilities include:
  348.  
  349.     
  350.     TYPE8  - types an ASCII file stored in ITS binary format.
  351.     TYPESQ - types an ITS binary format "squeezed" file (see the first
  352.              paragraph under FILE TYPES).
  353.     USQ    - creates an unsqueezed version of a squeezed file.
  354.     HEXIFY - creates an Intel hex format file from an ITS binary format
  355.              COM file.
  356.     COMIFY - creates a COM file from an Intel hex file.
  357.     CRC    - computes the Cyclic Redundancy Check value for a file, using
  358.              the same algorithm that is used by the CP/M program CRCK.
  359.     
  360.  
  361.         Brief instructions for any of these  utilities  except  LMODEM
  362. can be obtained by typing ":utility_name" (for example, :CRC).
  363.  
  364.      The ITS utilities listed above are also available  for  use  with
  365. TOPS-20,  but  since ITS binary format is no longer being used for the
  366. SIMTEL20 archives, these utilities have been converted  to  work  with
  367. TOPS-20  binary  formats.   A  collection  of  TOPS-20  utilities  for
  368. transferring  and  manipulating  files  can  be  found  in   directory
  369. PD:<CPM.TOPS-20>.   See  PD:<CPM>CPM.CRCLST  for  a  list of available
  370. programs.
  371.  
  372.      File  transfer  and  conversion  utilities  for  use with VAX/VMS
  373. machines are contained in directory PD:<CPM.VAXVMS>.   See  CPM.CRCLST
  374. for details.
  375.  
  376.  
  377. Christensen Protocol Microcomputer Programs:
  378.  
  379.      An  excellent  program  for transferring files between micros, or
  380. between micros and mainframes is called MODM7xx,  where  the  "xx"  is
  381. replaced  with  two  digits  to give the current version number.  This
  382. program, often referred to as  MODEM7  (the  name  of  its  easier  to
  383. pronounce ancestor), uses the popular Christensen protocol to transfer
  384. files with automatic error detection and retransmission  of  erroneous
  385. blocks.
  386.  
  387.      To get started with MODM7xx, you should first FTP and examine the
  388. "DOC"    and    "MSG"    files    from   the   binary   library   file
  389. PD:<CPM.MODEM7>MODM7xx.LBR.  The "DOC" and "MSG"  files  are  actually
  390. stored  in  the  library in squeezed form, so you will have to perform
  391. three steps to get them:
  392.  
  393.         1.  FTP the binary library file.
  394.  
  395.         2.  Extract the elements  having  filename  extensions  of
  396.             "DQC"  and "MQG".  If you have no facilities for doing
  397.             this on your mainframe host (see the earlier  comments
  398.             on  mainframe-based  library utilities), then you will
  399.             have to transfer the library to  a  microcomputer  and
  400.             extract   the   necessary  elements  there.   If  this
  401.             requirement seems to put you in a "Catch-22" situation
  402.             because  you  have  no  facilities  for  mainfrome-to-
  403.             microcomputer transfers, there is a way out; read  the
  404.             "Getting Started" section which follows|.
  405.  
  406.         3.  Use an "unsqueezer" (described above) to  convert  the
  407.             "DQC"  and "MQG" files extracted from the library into
  408.             "DOC" and "MSG" files.  As in the case of the  library
  409.             extractions,  unsqueezing  can  be  done  on  either a
  410.             mainfrome host or a microcomputer, depending  on  your
  411.             circumstances.
  412.  
  413.         Together, these files will tell you just about all there is to
  414. know  about  getting MODM7xx to run on your machine.  Take the time to
  415. read them; they're quite informative.  You will also get some  helpful
  416. insights  from  reading  some  of  the overlay files.  These overlays,
  417. described in file PD:<CPM.MODEM7> M7OVL-yy.LST, are used to  customize
  418. MODM7xx  for  particular  machines without having to edit and assemble
  419. the huge MODM7xx source file.  Complete  instructions  for  performing
  420. this  procedure  are contained in each overlay file.  The letters "yy"
  421. in the above filename should be replaced with two  digits  giving  the
  422. current version number as determined from CPM.CRCLST.
  423.  
  424.      And then, there is MEX.  MEX stands for "modem executive", and it
  425. is  just  what  the  name  implies, a communications and file-transfer
  426. program with a built-in mini operating system that  runs  under  CP/M.
  427. This  program  can  do  file transfers using either the Christensen or
  428. Compuserve protocol, and it  has  an  enormous  potential  for  highly
  429. automated  operations  because it can read and execute command-scripts
  430. pre-stored in disk files.  These scripts can include sending  commands
  431. to  a  remote  computer,  as  if  they had been sent manually from the
  432. microcomputer in terminal-mode.  Users of this relatively new  program
  433. are  still exploring its possibilities.  For more information, look in
  434. CPM.CRCLST under the heading "PD:<CPM.MEX>", and then get the  various
  435. files  that  have "DQC" and "IQF" in their names.  These DOCumentation
  436. and INFormation files are stored in squeezed form (note the "Q" in the
  437. filename  extensions),  so  you will have to unsqueeze them.  Overlays
  438. for MODM7xx will also work with MEX, but they will not provide all  of
  439. the extended MEX features.
  440.  
  441.  
  442. Kermit:
  443.  
  444.      Another  excellent  program  for  transferring  files  is  called
  445. KERMIT.  This program has the advantage  of  being  available  for  an
  446. impressively  large  number  of  mainframes  and  micros.   It is, for
  447. example, available for the IBM-PC, and it DOES NOT require CP/M.
  448.  
  449.      To  get started with KERMIT, connect to CU20B.ARPA using FTP, and
  450. do this:
  451.  
  452.                 get ker:aaaread.me
  453.  
  454. Note that this file is NOT on SIMTEL20, and the  name  is  subject  to
  455. change.  If you cannot find a file with this name, snoop around in the
  456. first half- dozen or so files in the alphabetical  listing  obtainable
  457. using the FTP DIRectory command.  You should find something useful.
  458.  
  459.      Questions can be addressed to INFO-KERMIT-REQUEST at CU20B.ARPA.
  460.  
  461.  
  462. Getting Started:
  463.  
  464.      In order to get MODM7xx, MEX or KERMIT running on your micro, you
  465. must  first  transfer the necessary files from mainframe to micro.  If
  466. you already have a  receive-to-disk  communications  program  of  some
  467. sort,  you can use it to move the needed files.  In the long-run it is
  468. essential to be able to transfer 8-bit binary files, but initially  it
  469. is  not absolutely necessary.  Some of the files are quite large.  For
  470. example, MODM7xx.COM is over 18K bytes, and the HEX  file  (which  you
  471. will  need  if  you  can't  transfer 8-bit files) is over 45K.  Moving
  472. large files to your micro without using an  error  detecting  protocol
  473. can  result  in  frustrating  errors,  but it can be done by receiving
  474. multiple copies and using manual or  machine-assisted  comparisons  to
  475. locate  and  repair bad parts of the code.  However, there IS a better
  476. way.
  477.  
  478.      Directory  PD:<CPM.STARTER-KIT>  contains a short starter-program
  479. called PIPMODEM.ASM that can be FTPed to your mainframe, printed,  and
  480. then  entered into your microcomputer by hand and assembled.  This can
  481. then be used to down- load either MBOOT3.ASM or BMODEM.BAS  (depending
  482. on  whether  you prefer assembly language or BASIC), both of which can
  483. receive files using the error detecting  Christensen  protocol.   Once
  484. you  have  this  capability,  you  can download the full-function file
  485. transfer program of your choice.  To examine this option,  connect  to
  486. SIMTEL20 via FTP and do this:
  487.  
  488.     
  489.         get pd:<cpm.starter-kit>pipmodem.asm 
  490.         get pd:<cpm.starter-kit>pipmodem.doc 
  491.         get pd:<cpm.starter-kit>mboot3.asm 
  492.         get pd:<cpm.starter-kit>bmodem.bas
  493.         get pd:<cpm.starter-kit>bmodem.doc
  494.     
  495.  
  496.  
  497.  
  498.  
  499.         All are ASCII files.  Read PIPMODEM.DOC first,  then  look  at
  500. MBOOT3.ASM  and  BMODEM.DOC.  PIPMODEM.DOC explains the situation very
  501. nicely.  Questions concerning these programs should be sent  to  INFO-
  502. CPM@AMSAA.ARPA (NOT to INFO-CPM-REQUEST).
  503.  
  504.  
  505.  
  506. NEWSGROUP CORRESPONDENCE ARCHIVES
  507.  
  508.      Copies  of  correspondence  for  several  newsgroups  are kept on
  509. SIMTEL20 in directories with names of the form  PS:<ARCHIVES.KEYWORD>,
  510. where  "KEYWORD" has been chosen to indicate the associated newsgroup.
  511. At present, the following correspondence archives are available:
  512.  
  513.     
  514.            newsgroup           mail archive filename
  515.         ---------------           ---------------------
  516.         ADA-SW               PS:<ARCHIVES.ADA-SW>
  517.         AMETHYST-USERS           PS:<ARCHIVES.AMETHYST>
  518.         INFO-68K           PS:<ARCHIVES.68K>
  519.         INFO-APPLE           PS:<ARCHIVES.APPLE>
  520.         INFO-CPM           PS:<ARCHIVES.CPM>
  521.         INFO-FORTH           PS:<ARCHIVES.FORTH>
  522.         INFO-HAMS           PS:<ARCHIVES.HAMS>
  523.         INFO-MICRO           PS:<ARCHIVES.MICRO>
  524.         INFO-MODEM7           PS:<ARCHIVES.MODEM7>
  525.         INFO-MODEMXX           PS:<ARCHIVES.MODEMXX>
  526.         INFO-MODULA-2           PS:<ARCHIVES.MODULA-2>
  527.         NORTHSTAR-USERS           PS:<ARCHIVES.NORTHSTAR>
  528.         INFO-PASCAL           PS:<ARCHIVES.PASCAL>
  529.         UNIX-SW               PS:<ARCHIVES.UNIX-SW>
  530.         INFO-XENIX310           PS:<ARCHIVES.XENIX310>
  531.     
  532.  
  533.         Descriptions of these and other newsgroups can be obtained via
  534. FTP  with  anonymous  login  (as  for  SIMTEL20)  from   the   Network
  535. Information   Center's   host   SRI-NIC.ARPA.    Ask   for   the  file
  536. PS:<NETINFO>INTEREST-GROUPS.TXT (an ASCII  file).   And  please  note,
  537. this is NOT on SIMTEL20.
  538.  
  539.      File names for SIMTEL20 newsgroup  correspondence  archives  have
  540. two  forms.  For example, PS:<ARCHIVES.CPM>CPM.ARCHIV.ymmdd is a group
  541. of files containing INFO-CPM correspondence going back several  years.
  542. The  characters  "ymmdd"  in the file names are actually digits giving
  543. the year, month and day of the last message in each  particular  file.
  544. Current  correspondence  is  kept  in  the  file PS:<ARCHIVES.CPM>CPM-
  545. ARCHIV.TXT, which is constantly changing.  Although INFO-CPM has  been
  546. used  as an example here, the same naming scheme is used for the other
  547. newsgroup files as well.  For a  complete  list  of  available  files,
  548. connect to SIMTEL20 via FTP and do this:
  549.  
  550.                 dir ps:<archives>
  551.  
  552. You will receive a list of names of the form:
  553.  
  554.                 KEYWORD.DIRECTORY.n
  555.  
  556. where  "n"  is  one or more digits.  For example, the INFO-CPM listing
  557. currently appears as "CPM.DIRECTORY.1" To then get a list of files  in
  558. a particular archive, do this:
  559.  
  560.                 dir ps:<archives.keyword>
  561.  
  562. where  "keyword"  (for  example,  "cpm")  is chosen from the preceding
  563. list, and the word "directory" and the number "n" are  not  used.   At
  564. present, all of these files are stored in ASCII.
  565.  
  566.  
  567.  
  568. ADDITIONS, IMPROVEMENTS AND CORRECTIONS
  569.  
  570.      Suggestions  for  additions, improvements and corrections to this
  571. message  are  always  welcome.   Please   send   them   to   INFO-CPM-
  572. REQUEST@AMSAA.ARPA.
  573.  
  574.      Contributions of public domain software are  actively  solicited.
  575. If  you  have  something  that  seems appropriate for inclusion in the
  576. <CPM>  archive,  please  contact  Keith   Petersen   <W8SDZ@SIMTEL20>.
  577. Likewise,  contact  Richard Conn <ADA-SW-REQUEST@SIMTEL20> if you wish
  578. to contribute to the <ADA> archive, and Sue  Tabron  <TABRON@SIMTEL20>
  579. if you have something for the <UNIX> archive.
  580.  
  581.  
  582.      Happy computing!
  583.  
  584.  
  585.     
  586.  
  587.                     Dave Towson
  588.                     INFO-CPM-REQUEST@AMSAA.ARPA
  589.