home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1994 March / Source_Code_CD-ROM_Walnut_Creek_March_1994.iso / unix_c / tricklnf.txt < prev   
Text File  |  1991-06-10  |  22KB  |  458 lines
  1. You are looking at PD6:<UNIX-C>000-TRICKLE-INFO.TXT, last updated 14-Jul-89:
  2.  
  3. NOTE 1: At present, the European TRICKLE servers *will* supply UNIX-C
  4.         service to people in the USA.  However, they would prefer to
  5.         have some help from sites in the USA.  If you are running a
  6.         BITNET site and are interested in helping out, please contact
  7.         the UNIX-SW moderator.
  8.  
  9. NOTE 2: Please be kind to the TRICKLE if you are a U.S. site.  Don't
  10.     go requesting everything under the sun.  Remember that those
  11.     trans-Atlantic links cost somebody some serious dollars.
  12.  
  13.                         RED - Listserv Redirector
  14.                 (C)1988 Turgut Kalfaoglu <TURGUT@TREARN>
  15.  
  16. What is RED?
  17. ------------
  18. RED provides  the SIMTEL-20   files, and directory listings, with its own
  19. cache, where  it keeps  its most recently requested files. It reduces the
  20. network load  by providing the cache, and by providing directory listings
  21. locally, instead  of through   a  distant list  server.. It  is a machine
  22. (process) that runs disconnected from a terminal.
  23.  
  24.   Currently, the seven sites that run this  software are called:
  25.  
  26. In Denmark:   TRICKLE@DKTC11
  27. In Turkey:    TRICKLE@TREARN
  28. In Italy:     TRICKLE@IMIPOLI
  29. In Belgium:   TRICKLE@BANUFS11
  30. In Austria:   TRICKLE@AWIWUW11
  31. In Germany:   TRICKLE@DB0FUB11
  32. In Spain:     TRICKLE@EB0UB011
  33.  
  34. You are urged  to use the one that is  closer to your location.
  35.  
  36. In this  tutorial, we will  be using 'TELL TRICKLE  AT TREARN', but  this
  37. can   be   replaced   with   'TELL   TRICKLE    AT    <your  location  of
  38. preference>'
  39.  
  40. We also  will use  the 'TELL'  command to send a single line message.  It
  41. should be  replaced with  whatever is appropriate for your system.  (Like
  42. XMIT ,  SEND, etc.)  If you  are on  a node  that cannot  reach a TRICKLE
  43. directly, for example, a JANET node, then you must send MAIL files to the
  44. server. Simply  put the  commands, one per line, into the text portion of
  45. your mail.
  46.  
  47. What Does it Provide?
  48. ---------------------
  49. A Milnet node, WSMR-SIMTEL20.ARMY.MIL at White Sands Missile Range,  New
  50. Mexico  contains a  large  selection  of  public  domain and  'shareware'
  51. software.  This  DECsystem-20  machine,  running  the  Tops-20 operating
  52. system  provides  many  files  of interest, especially to CP/M and MSDOS
  53. users.
  54.  
  55. The collection is open to public, anyone may obtain copies of this of the
  56. files using  the Internet  file transfer  protocol,  FTP.  However,  this
  57. protocol is  not available to Bitnet, or EARN sites. For this reason, two
  58. servers in The United States, who have a connection both to Milnet and to
  59. Bitnet, provide us with these files. However, since both of these servers
  60. are in  The US,  the requests  of these  files puts a burdon on these two
  61. servers. The  solution was  to create  a server here in Europe that could
  62. provide the  files requested,  send the directory listings, and also keep
  63. the recently  requested files,  in case  someone else  wishes to have the
  64. same file.
  65.  
  66. We,  the  server  operators,  would  like  to  stress  that  we  have  no
  67. affiliation with  the US  Army, nor with White Sands Missile Range. These
  68. servers are  made available  in the  true spirit of volunteerism, without
  69. any outside sponsorship for the service.
  70.  
  71. The Trickle, and The US servers support the following directories:
  72.  
  73. CPM  Software and information for CP/M users. Contributions are gathered
  74.    from a variety of sources, including the members of the Info-CPM
  75.    electronic mail discussion group. This archive is updated very
  76.    frequently.
  77. MSDOS  Software and information for PC-DOS and MS-DOS system users. This
  78.    archive is updated very frequently.
  79. PC-BLUE  Software and information for PC-DOS and MS-DOS system users. The
  80.    archive contains files distributed by the PC-Blue Users Group. New
  81.    files are added as they become available.
  82. SIGM  Software and information for CP/M users. The archive contains the
  83.    files distributed by the SIG/M Users Group. New files are added as
  84.    they become available.
  85. MISC  Software and information for miscellaneous systems (mostly large
  86.    systems like IBM/370 and DEC VAX). Contributions are gathered from a
  87.    variety of sources.
  88.  
  89. The Trickle also supports the following directory:
  90.  
  91. UNIX-SW    Software collected from comp.sources.*, the GNU project, and
  92.    elsewhere for use with UNIX systems.
  93.  
  94. How does it work?
  95. -----------------
  96.    It provides  faster file  delivery than  LISTSERV@RPIECS because  it
  97. holds the  most recently  requested files, and it also asks its peers, to
  98. find out if any of them has the file.
  99.  
  100.   It has two major commands.  /PDDIR and /PDGET..  As the names indicate,
  101. /PDDIR provides the names of the files, and /PDGET delivers files.
  102.  
  103. How to use /PDDIR:
  104. ------------------
  105.   On IBM/VM systems, you can get a list of the 'major directory' names by
  106. simply typing this command:
  107.  
  108.                       TELL TRICKLE AT TREARN /PDDIR
  109.  
  110. RED should  now send  you a  list of the major directory names.  Now, you
  111. can obtain a list of the sub-directories of any of the displayed names by
  112. putting the  name between  less-than  and  greater-than  symbols..    For
  113. example,
  114.  
  115.                   TELL TRICKLE AT TREARN /PDDIR <MSDOS>
  116.  
  117. RED will  mail you  a file  containing the  names of the sub-directories.
  118. Once you  choose a  subdirectory to  examine, type  in the main directory
  119. name, a  period, then the name of the subdirectory name.  For example, if
  120. you chose SYSUTL sub-directory of MSDOS, then you may type this:
  121.  
  122.               TELL TRICKLE AT TREARN /PDDIR <MSDOS.SYSUTL>
  123.  
  124. RED will  first notify  you of  the number  of files  found, then will go
  125. ahead and  mail you  this list..   Once you choose your file(s) to order,
  126. then read on..
  127.  
  128. How to use the /PDGET command:
  129. ------------------------------
  130.    Once you  have a filename in hand, then tell RED to send you this file
  131. by providing  it with the full directory name, and the filename..  If you
  132. wish to  order a game called MADMAX.ARC that resides in the <MSDOS.GAMES>
  133. directory, then you may type in this command:
  134.  
  135.           TELL TRICKLE AT TREARN /PDGET <MSDOS.GAMES>MADMAX.ARC
  136.  
  137. naturally, the  above is  only an example, and the file may or may not be
  138. present if you send the above command.
  139.  
  140. Receiving your file in a different format:
  141. Normally, SIMTEL  files are sent AS-IS, meaning, ASCII. If you would like
  142. to receive your file in a different format, you may want to append any of
  143. the below to the end of any of your your commands:
  144.  
  145. (EBC80 Converts the file to 80-Column EBCDIC format
  146. (EBC32 Converts the file to 132-Column EBCDIC format
  147. (UUE uuencodes the file
  148. (OLD Sends the file using DISK DUMP or PUNCH format
  149. (SF Supresses BITSEND, and forces SENDFILE to be used for the transfer.
  150. (MAIL Forces results to be sent via MAILER.  (This option is
  151.    automatically added for MAIL command files)
  152. (XXE  XXDECODES the file that is to be sent to you.
  153. (HEX  Turns the file to HEX format - use it if even (XXE doesn't work for
  154.    you.
  155. (BTOA BTOA-Encrypts the file. Useful for Unix systems.
  156.  
  157. You may  also wish  to combine several options together.  For example, to
  158. receive a directory listing in PUNCH format, and UUEncoded,
  159.  
  160.             TELL TRICKLE AT TREARN /PDDIR <MSDOS.C> (OLD UUE
  161.  
  162. To receive a file in in EBCDIC format, you may enter a command that looks
  163. like this:
  164.  
  165.       TELL TRICKLE AT TREARN /PDGET <MSDOS.GAMES>MADMAX.ARC (EBC80
  166.  
  167. However, it  is not  useful at  all to  receive an  .ARC file  in  EBCDIC
  168. format. The above is not a terribly good example.
  169.  
  170. Other commands:
  171. ---------------
  172. /NEWS  sends you our 2-page newsletter.
  173. /STAT  provides you the statistics of usage.
  174. /HELP  sends you this file.
  175. /IMDAT  sends   the  Turkish  version  of   this  help  file.  Note that
  176.    this command is only valid for the TREARN server.
  177. /CAC Sends  you a list  of the files  that are stored  on its disk right
  178.    now. These files  can be sent  faster than the other files.
  179. /OPS   displays the RED operators
  180. /QUO Shows  you the RED's quota,  and how much of  that quotait has
  181.    used.  Once  RED  exceeds its  quota,  it  cannot order files,  until
  182.    it receives some  of the requested files.
  183. /SUB <dirnam> Allows  you  to  subscribe to  a  directory.  Whenever a
  184.    new listing  comes in,  RED  will send  you a  file containing the
  185.    names of the new files.
  186. /UNSUB <dirnam> is to stop RED from sending you the new files listings.
  187.    Please issue this command  if you will not use the server anymore.
  188. /NEW <dirnam> nnn This command, displays the files that have arrived
  189.    within 'nnn' days, in the 'dirnam' directory.  If 'nnn' is omitted, it
  190.    defaults to the last time you issued this command, for that directory.
  191.    If you are issuing this command for the first time, then it simply
  192.    looks for files that are at most a month old.
  193. /POLL forces RED to check its peer servers
  194.  
  195. Delay Periods:
  196. --------------
  197.    If the  file that you requested already exists in the cache directory,
  198. then you  may expect  to receive  your file within a few hours.  However,
  199. the system  that RED  is running  is  often  slowed  down  by  the  other
  200. processes that are running.  This negatively affects the response time of
  201. RED.   If the  file requested  does not existin the cache directory, then
  202. RED will  have to  order this file from its list server..  If this is the
  203. case, the  response time  of RED  is dependent upon the list server.  RED
  204. will give  up waiting  for a  file after  five to  twelve days  after its
  205. request.
  206.  
  207. Sending files to RED:
  208. ---------------------
  209.    RED now accepts command files in either MAIL or NOTE format.  Use NOTE
  210. or MAIL  utilities to  prepare your  command file.  The files may contain
  211. any number  of instructions,  one per  line.   Note that  RED will  abort
  212. processing a  file if  it detects an invalid command within the file. The
  213. server has  a 'likewise'  habit, and will MAIL back your files, using the
  214. default UUENCODING,  unless you  tell it  otherwise, if  you request your
  215. file via  mail. This  is done for those of us, who are not on Bitnet, and
  216. keep forgetting to put the (MAIL at the end of the command.
  217.  
  218. How to DONATE files to Simtel Archives:
  219. ---------------------------------------
  220.    Files that  you receive from here are sent from another network called
  221. ArpaNet.   The person-in-charge  for  the  programs  is:  Keith  Petersen
  222. <W8SDZ@SIMTEL20.ARMY.MIL>. Since  it's another  network, you will need to
  223. use MAIL  to send  the message.  He urges that you talk to him before you
  224. send in  the file,  so that  he can  check where  it should be put, if it
  225. already exists,  etc.   After getting  his approval, you need to UUENCODE
  226. your file (perhaps using PDUTIL), then MAIL it to him.
  227.  
  228. Format of the files that comes with /PDGET command:
  229. ---------------------------------------------------
  230.  
  231. For the  below chart,  we shall  assume that  you  have  not  placed  any
  232. conversion options at the end of your command.
  233.  
  234. If you have used:        You can expect the file to arrive:
  235. -----------------------------------------------------------
  236. 'tell' style message:    BITSEND, NETDATA format.
  237. -----------------------------------------------------------
  238.  
  239. MAIL command file:       UUENCODED, in numbered pieces.
  240. -----------------------------------------------------------
  241. A regular file, or       Just like 'tell' messages,
  242. IBM's NOTE command:      replies in BITSEND, NETDATA.
  243. -----------------------------------------------------------
  244.  
  245. RED will  send the files in  a NETDATA format, -unless  you use the  (OLD
  246. option-.  On IBM systems, these files can be LOOKed and RECEIVEd, but the
  247. PEEK command cannot handle NETDATA format properly.  However, since  most
  248. files  are ASCII, it  is of little use to LOOK at them.
  249.  
  250. The files  will mostly be either in Binary format, in ASCII format, or in
  251. EBCDIC format.   The  binary files  are recognized  by the '.BIN','.EXE',
  252. '.COM ',  '.ARC', '.LBR' suffix in their names.  These files are machine-
  253. specific.The files  that are  in ASCII  format can be converted to EBCDIC
  254. (so that  they can  be used  on an  IBM system)  by running  a conversion
  255. program called  PDUTIL.   If your  installation does  not have  either of
  256. these files,  Either I,  or the LISTSERV@RPIECS can provide it.  Simply
  257. say: TELL LISTSERV AT RPIECS GET PDUTIL PACKAGE
  258. The .ARC format:
  259.  
  260.   ARC is a special compression method that provides substential reduction
  261. on file  size.   There are  one or  more files  contained within  an .ARC
  262. archive.   In order to extract the files from an archive, you will need a
  263. utility called  ARC or  PKXARC.These are  available from  <MSDOS.ARC-LBR>
  264. directory.   The actual  file names of these files vary, but you may try:
  265. TELL TRICKLE   AT   TREARN  /PDGET   <MSDOS.ARC-LBR>PK361.EXE or:    TELL
  266. TRICKLE   AT   TREARN /PDGET  <MSDOS.ARC-LBR>ARC512.EXE If these attempts
  267. fail, it will probably mean that the file version has changed, and so has
  268. the file name.  You may wish to try
  269.  
  270.               TELL TRICKLE AT TREARN /PDDIR <MSDOS.ARC-LBR>
  271.  
  272. and guess the new name of these files.
  273.  
  274. Once you  receive either ARC or PKXARC and an .ARC file, transmit them to
  275. your personal computer and issue the following command:
  276.                           ARC X <filename.arc>
  277.                                    or
  278.                            PKUNPAK <filename>
  279.  
  280. There is  also a  second utility  called ARCUTIL,  which runs  on the  VM
  281. systems, and extracts files.  It also provides ASCII to EBCDIC conversion
  282. of the extracted files.  To request ARCUTIL, enter:
  283.  
  284.       TELL  TRICKLE  AT   TREARN  /PDGET  <MISC.IBM-VM>ARCUTIL.LBR
  285.  
  286.   The directories of SIMTEL change often.  So, the above files may or may
  287. not be  in the  same directories as I have indicated.  So you may have to
  288. do some  searching to  find them..   A  good place  to check would be the
  289. <MSDOS.STARTER> directory,  where  additional  help,  and  the  mentioned
  290. archive managers can be found.
  291.  
  292. How to use the BITSEND/BITRCV:
  293. ------------------------------
  294. From now  on, RED is sending its files in a special format called BITSEND
  295. - Unless you include the (SF option while issuing your command.
  296.   In this format, the files that are sent are broken into smaller pieces,
  297. if the  entire file  is too  big to  be sent.  If the file you request is
  298. over the  size limit,  then the  server will first send you a file called
  299. <fn> BITCTRL  - this  is the  control file, where BITSEND has written the
  300. protocol used, the number of pieces that make up that file, etc.
  301. -------------------------------------------------------
  302. Important:
  303. You   should NOT  'RECEIVE' any  files that  have BITCTRL or just numbers
  304. as filetype!
  305.  
  306. -------------------------------------------------------
  307. If you  wait a  little longer,  the rest  of the  file will  arrive,  the
  308. filename will be the same as the <fn> BITCTRL file, but the filetype will
  309. consist of  just numbers.  Once you have all the pieces that make up that
  310. file, you  can then  issue the BITRCV command.  You must also specify the
  311. 'spool ID'  of the  file that has BITCTRL as filetype.  From RDRList, you
  312. can simply type BITRCV in front of the file that has BITCTRL as filetype.
  313. If you  get back  an error  message, saying  "UNKNOWN CP/CMS  COMMAND" it
  314. simply states  that your  installation does  not have the BITRCV program.
  315. Contact your network manager/system operator.
  316. Note: BITRCV  EXEC can  be obtained  from your  country NETSERV  as well.
  317. Simply send "GET BITRCV EXEC" to your NETSERV.
  318.  
  319. -----------------------------------------------------------
  320. VAX users:
  321. There is  also an  identical file  for your  installation, however, it is
  322. called 'BITRCV  COM', and  can be  obtained from a NETSERV by issuing GET
  323. BITRCV COM to your country NETSERV.
  324. -----------------------------------------------------------
  325. If you  get back  an error  saying that  not all  of the  file is  in the
  326. reader, it  simply means  that you  have to  wait a little longer for the
  327. rest of the file to arrive.
  328.  
  329. How to receive the file that arrives:
  330. -------------------------------------
  331. Once the file you requested arrives, and is stored on your disk, you will
  332. most likely wish to 'download' this file to your personal computer. There
  333. are many  types of mainframe computers, many kinds of personal computers,
  334. so it  is impossible  for me  to give you direct, and precise directions.
  335. However, here are some clues:
  336.   * If you have a PC with a 3270 Emulation program, and an IBM mainframe,
  337.    you should request your files from the server without options, or with
  338.    (SF option, and use the built-in transfer protocol of the emulation
  339.    program, without any options again.
  340. * If you have KERMIT at your installation, request your file without
  341.    options, or with (SF option, then set the KERMIT's FILE-TYPE to BINARY
  342.    before transferring your file.
  343. * Remember that if you send a MAIL command file to the server to request
  344.    your file, the file will arrive in UUENCODE format, since the mailer
  345.    cannot process binary files - unless you specify (XXE or (HEX in the
  346.    command line.
  347.  
  348. How Does the Cache Work?
  349. ------------------------
  350.     Imagine that you ask for a file, and the server brings this file from
  351. United States for you. Thinking that others may wish to have this file as
  352. well, the  server keeps this file in an area called 'cache.' When someone
  353. else requests  this file,  the server  simply uses the stored copy of the
  354. file, instead of asking for the file again from overseas. All the servers
  355. that you  see on  top of  this document  have different  files  in  their
  356. caches. So,  if you wish to see the files they are holding right now, you
  357. will have  to issue '/CAC' to each one of them. Note that a file does not
  358. stay in cache forever. As new files arrive, the older ones are deleted to
  359. make room.
  360.  
  361. The Amazing Life of a /PDGET request:
  362. -------------------------------------
  363.      Once you order your file via /PDGET, the server will first check its
  364. local cache  listings. If  the file  is not there, then it will check the
  365. SIMTEL20 listings  to ensure  that a such file indeed exists. After this,
  366. the server  sends the  request to  all other servers, asking them if they
  367. have your file in cache. If a server replies 'YES!', then that server has
  368. to send  you the  file.   Everything fails: none of the servers have your
  369. file, or  even some  servers don't  respond. Your  server  will  give  up
  370. waiting for a reply in a day, and order your file from the United States.
  371. Once the  file requested  arrives from there, it will be sent to you, and
  372. put into the cache directory. Quite a trip for one /PDGET command.
  373.  
  374. Quotas, and Other Ugly Limitations
  375. ----------------------------------
  376. You may be surprised that even though most TRICKLE servers have some kind
  377. of quota, we still get several hundred requests daily. Without them, this
  378. number may  easily rise to thousands.  The impact of a such usage rate on
  379. the local  computer can be very 'tiring.' So, the following quota schemes
  380. have been implemented:
  381. 1) Total outstanding bytes quota: This quota is not really put by the
  382.    server's operators. It is the amount that a TRICKLE server can order
  383.    from The United States. This is currently set at 10 megabytes for most
  384.    servers.
  385. 2) Prime times: Some of the servers, do not function during the day, they
  386.    record the commands received, and process these commands later, when
  387.    the load on the computer is low.
  388. 3) User request limitations: Most TRICKLE servers have a limit on how
  389.    many requests a user can make on the server per day. The request can
  390.    be a simple /OPS command, or a file order via /PDGET. It still counts
  391.    as one. The server will warn you that you are approaching the limit,
  392.    once you have 3 more commands left.
  393. 4) Outstanding files per user: This scheme is also employed by some
  394.    servers, and it limits the number of files a user can order from The
  395.    United States.
  396. 5) Delayed Sendfile: This last scheme is simple: it delays sending your
  397.    file until a specified time comes. Usually at night, when the network
  398.    load is low. If a site uses delayed sendfile, you will see a '* Your
  399.    file will be mailed' notice, instead of '* Your file is being mailed.'
  400.  
  401. A Last Word on Options:
  402. -----------------------
  403. Some of  the options are not compatible, such as (MAIL SF, and should not
  404. be used together - the behavior of the server may be unpredictable. Also,
  405. the (SF  option may  result in  a file that is too large for shipment. If
  406. that is  the case, a network control program may detect it, and delete it
  407. before it reaches you. Use (SF carefully.
  408. Also, (SF  and (OLD options would be ignored if you send in your commands
  409. in a  MAIL file.  If you  wish to  receive your files AS-IS, and still be
  410. able to  put your  commands in  a file, you can either send a NOTE to the
  411. server, or  simply create  a file  using your editor, then send this file
  412. directly to the server, without first going through the mailer.
  413.  
  414. VAX/VMS Users:
  415. --------------
  416. If your  host is  a DEC  VAX system  running  VMS  with  Jnet  networking
  417. software, you  can avoid  the need  for uuencoding. You can tell the Jnet
  418. software to bypass the usual EBCDIC/ASCII conversion, but there are a few
  419. additional steps needed before downloading a file.
  420. * Receive the file with the Jnet command RECEIVE/BINARY. The BINARY
  421.    modifier suppresses the normal EBCDIC/ASCII conversion. Let's assume
  422.    that the file is called MYFILE.ARC. This file, as received, is almost
  423.    correct; there may be an error is how VMS interprets the records.
  424. * Generate an FDL file for MYFILE.ARC using:
  425.  
  426.    ANALYZE/RMS/FDL MYFILE.ARC
  427.  
  428. * Edit the FDL file with the command
  429.  
  430.    EDIT/FDL MYFILE
  431.  
  432.    Examine the CARIIAGE_CONTROL setting. Change it to NONE. Exit the
  433.    editor.
  434.  
  435. * Use the edited FDL to correct carriage control interpretation errors in
  436.    the original MYFILE.ARC:
  437.  
  438.    CONVERT/FDL=MYFILE.FDL  MYFILE.ARC  FIXED_MYFILE.ARC
  439.  
  440. * Download the FIXED_MYFILE.ARC as a binary file using any reliable
  441.    means. (For VAX Kermit, use SET FILE TYPE BINARY command before
  442.    starting the download.)
  443.  
  444.  
  445. Puzzled?
  446. --------
  447.      We now  have an  online discussion list that gives assistance on the
  448. server. To  join this  list, simply  send the following command to either
  449. LISTSERV AT TREARN, or LISTSERV AT DB0FUB11:
  450.  
  451.                     SUB RED-UG Myfirstname Mylastname
  452.  
  453. Also, you  may get in touch with your local TRICKLE operator. You can get
  454. his network address by using the /OPS command.
  455.  
  456. We wish you great benefits from using TRICKLE - we know that the software
  457. it provides can accomplish that.
  458.