home *** CD-ROM | disk | FTP | other *** search
/ The Unsorted BBS Collection / thegreatunsorted.tar / thegreatunsorted / texts / txtfiles_misc / simtel20.1 < prev    next >
Text File  |  1993-10-09  |  15KB  |  328 lines

  1. Subj:  #2(3)      File: "PDGET HELP"
  2. Date:  93-10-09 03:22:21 EDT
  3. From: LISTSERV@VM1.NODAK.EDU
  4. To:    Monk OTY
  5.  
  6. Mail Split By AOL Gateway
  7.  
  8. ------- cut here --------
  9.  
  10.      ASIS     -- suitable for hosts that can receive binary data.  The
  11.                  file is sent exactly as it is stored on the server:
  12.                  binary images of the file data.  ASIS may be used
  13.                  only with format NETDATA.
  14.  
  15.      UUENCODE -- suitable for hosts that cannot receive binary data.
  16.                  The file is sent uuencoded.
  17.  
  18.      OLDUUE   -- suitable for hosts that cannot receive binary data.
  19.                  The file is sent uuencoded using a variant in which
  20.                  an extra character is appended to the end of each
  21.                  line to protect it from trailing blank truncation.
  22.                  (This method is obsolete and should be avoided.)
  23.  
  24.      XXENCODE -- suitable for hosts that cannot receive binary data.
  25.                  The file is sent xxencoded.
  26.  
  27.      TRANSLATE -- suitable for any host, but only when the file actually
  28.                  represents readable text.  The file is translated to
  29.                  EBCDIC.  (If you are on an ASCII machine, then your
  30.                  system should automatically translate to ASCII when
  31.                  the file arrives.)  TRANSLATE applied to a binary file
  32.                  is treated as if UUENCODE were specified.
  33.  
  34. If no encoding is specified, then ASIS is assumed for NETDATA, and
  35. UUENCODE for the others.  If a requested file is too large to send
  36. through BITNET in the requested format, then the server forces it to be
  37. uuencoded MAIL.  (Only the BITSEND format avoids this format
  38. conversion.)
  39.  
  40. --------Note--------Note--------Note--------Note--------Note-----------
  41.      In the actual archives at SIMTEL20 there are a few files stored in
  42. the top-level directory.  (For example, PD:<MSDOS>FILES.IDX is a file
  43. listing the names of all the files in the subdirectories of the MSDOS
  44. archive.)  The design of the BITNET server does not permit access to any
  45. of these files.  However, since the files at the top-level directory
  46. generally contain directory information, the need for them is superseded
  47. by the /PDDIR command.
  48. --------Note--------Note--------Note--------Note--------Note-----------
  49.  
  50. ------------------------------------------------------------------------
  51. Getting Started
  52. ------------------------------------------------------------------------
  53.  
  54. WARNING:
  55.      The specific file names and "paths" used below MAY change over time.
  56. This is expecially likely for ones like:
  57.      PD:<MSDOS.STARTER>ARCE40G.COM
  58.      PD:<MSDOS.STARTER>ARCE40G.DOC
  59.      PD:<MSDOS.ZIP>DEZIP20.COM
  60. where the "40G" and "20" may be a version or release name.
  61.      If you can't find the file indicated try /pddir commands such as
  62.         /pddir pd:<msdos.*>arc*.* 99999     or
  63.         /pddir pd:<msdos.*>dezip*.* 99999
  64. to try to find the correct name and location.
  65.  
  66.      Before all else, something you absolutely must have available is
  67. a method for getting files from your host system to you micro computer.
  68. It would be preferable if this method included support for transferring
  69. binary files as well as normal text files.  If you do not already have
  70. a way to communicate with your host and transfer files, consider getting
  71. the appropriate Kermit implementations available from the KERMSRV file
  72. server at CUVMA.
  73.  
  74.      Once that minor detail has been addressed, then you should consider
  75. what additional utility programs you will need or that will be helpful.
  76. Most files are in an archive format, so you will need a de-archive
  77. utility or two.  You may also need a uudecode program, depending on your
  78. ability to receive binary files on your host and your ability to
  79. download binary files to you micro computer.
  80.  
  81.      This last point requires some explanation.  The server stores all
  82. files from SIMTEL20 as-is in 128 byte sector image blocks.  They are
  83. bit-for-bit identical to how they should appear on your micro computer.
  84. The server makes no attempt to interpret the files; it simply sends them
  85. on demand out through BITNET.  BITNET, though, is fundamentally an
  86. EBCDIC network, and your micro computer is fundamentally an ASCII
  87. machine.  This gives rise to two places along the path from server to
  88. micro where the file data might be misinterpreted or corrupted.
  89.  
  90.      If your host system is ASCII-based (as are most non-IBM systems)
  91. it will translate incoming BITNET files from EBCDIC to ASCII.  If your
  92. host is EBCDIC-based, your communications software will translate files
  93. you download from EBCDIC to ASCII.  But the files from the server do not
  94. contain EBCDIC data.  You must either find a way to disable the
  95. translations or encode the data in such a way that the original file
  96. can be recovered.
  97.  
  98.      There are suggestions given later for specific host machines to
  99. disable the translations.  For now assume data encoding is required.
  100. You can ask the server to send files in encoded from.  If you request
  101. encoding, the file is encoded using either of two techniques, uuencoding
  102. or xxencoding.  Encoded data is preserved through most of the
  103. EBCDIC/ASCII translations the file might encounter.  So, all you need
  104. is a program for you micro computer that decodes an encoded file.
  105.  
  106. --------Note--------Note--------Note--------Note--------Note-----------
  107.      Uuencoding is by far the more popular method for encoding binary
  108. data files.  However, there are some few mail gateways (most notorously
  109. the JANET gateway) through which the encoding does not survive.  There
  110. also are a multitude of uuencode/uudecode implementations which are not
  111. fully 100% compatible with each other.  If an XXdecode implementation
  112. exists for your environment, then that is the method you should favor.
  113.  
  114.      To help diagnose character translation problems we have stored a
  115. file called ASCII CHARS on the LISTSERV@NDSUVM1.BITNET (or on the
  116. Internet listserv@vm1.nodak.edu).  Send the server at that address the
  117. command   GET ASCII CHARS  and download the file to the location where
  118. you do the uu/xxdecoding.  By visually inspecting the result you may be
  119. able to see where the problem is and compensate for it.
  120.  
  121.      For large files the LISTSERV/trickle server will break up the
  122. encoded output into several files.  You must RECOMBINE these files
  123. properly before trying to decode them!  It may be easiest to do this
  124. on the system which firsts receives the mail, before you download
  125. the files to the system where you will decode them.  Be sure they are
  126. recombined in the correct order!  A script for unix users is included
  127. below in the section "Unix Users".
  128.  
  129. --------Note--------Note--------Note--------Note--------Note-----------
  130.  
  131.      There are several decoders available from SIMTEL20.  The only
  132. problem is how do you get the program to your micro computer.  Catch-22.
  133. Well, you can ask the server to send ASCII text files in translated
  134. form.  If you request translation, a file is first translated to EBCDIC
  135. before it is sent.  This is not recommended as a standard option since
  136. there may be some loss of information, but for getting started it may
  137. be essential.
  138.  
  139.      If you need a program for MSDOS to decode uuencoded files, send the
  140. following commands to the server:
  141.  
  142.         /PDGET PD:<MSDOS.STARTER>UUDECODE.xxx  TRANSLATE
  143.         /PDGET PD:<MSDOS.STARTER>UUENCDEC.DOC  TRANSLATE
  144.  
  145. Replace "xxx" with either BAS, C, or PAS depending on which source
  146. language you would prefer (BASIC, C, or Pascal, respectively).
  147.  
  148.      If you need a program for CP/M to decode uuencoded files, send the
  149. following command to the server:
  150.  
  151.         /PDGET PD:<CPM.STARTER-KIT>UUDECODE.HEX  TRANSLATE
  152.  
  153. The file contains the CP/M hex data for the program.  Download it.  Use
  154. the CP/M commands LOAD and SAVE to create an executable program.  You
  155. should end up with UUDECODE.COM, the desired program.
  156.  
  157.      Next, you should consider requesting which ever of the following
  158. files you feel appropriate for your micro computer system:
  159.  
  160. For PC-DOS and MSDOS machines:
  161.      PD:<MSDOS.STARTER>ARCE40G.COM       Un-archive utility.
  162.      PD:<MSDOS.STARTER>ARCE40G.DOC       ..and the documentation.
  163.      PD:<MSDOS.ZIP>DEZIP20.COM           ZIP archive extract
  164.      PD:<MSDOS.STARTER>UUDECODE.COM      Compiled uudecode utility
  165.      PD:<MSDOS.STARTER>UUDECODE.DOC      ...and the documentation.
  166.  
  167. For CP/M machines:
  168.      PD:<CPM.STARTER-KIT>DELBR12.COM     Un-library utility.
  169.      PD:<CPM.STARTER-KIT>UNARC.COM-Z80   Un-archive utility, Z-80 only.
  170.      PD:<CPM.STARTER-KIT>UNARCA.COM-8080 Un-archive utility.
  171.      PD:<CPM.STARTER-KIT>UNARC.DOC       ..and the documentation.
  172.      PD:<CPM.STARTER-KIT>UNCR-Z80.COM    Un-crunch utility, Z-80 only.
  173.      PD:<CPM.STARTER-KIT>UNCR8080.COM    Un-crunch utility.
  174.      PD:<CPM.STARTER-KIT>UNCR8080.DOC    ..and the documentation.
  175.      PD:<CPM.STARTER-KIT>USQ120.COM      Un-squeeze utility.
  176.      PD:<CPM.STARTER-KIT>USQ120.DOC      ..and the documentation.
  177.  
  178. There are many other useful utilities in these and other archive
  179. directories.  Remember, though, if you need the server to UUENCODE the
  180. files you request, you should explicitly ask for it.  Also, some of the
  181. programs listed above may be replaced by newer versions.  (For example,
  182. ARCE40C.COM replaced the earlier ARCE31C.COM.)  If you have trouble with
  183. the server claiming "file not found", use the /PDDIR command to list the
  184. the appropriate directory.
  185.  
  186.      You may find two other files useful.  PD:<MSDOS.FILEDOCS>SIMIBM.ZIP
  187. and PD:<CPM.FILEDOCS>SIMCPM.ARK contain one-line descriptions for many
  188. of the  other files in their respective archives.  Not all files are
  189. described, but it does contain enough valuable information to help you
  190. find other software.
  191.  
  192.  
  193. IBM System Users.
  194.  
  195. If your host is an IBM system running either VM or MVS, you can avoid
  196. the need for uuencoding.  Files received from BITNET will not be
  197. translated, since the IBM is an EBCDIC machine.  Most down-load methods
  198. support binary transfer, so you can defeat the translation that would
  199. otherwise take place there.  For example, with CMS Kermit the command
  200. SET FILE BINARY is all the is required before initiating a download.
  201. If you are using a 3270 emulator and IND$FILE for file transfers, by
  202. default no translation takes place.
  203.  
  204.  
  205. VAX/VMS Users.
  206.  
  207. If your host is a DEC VAX system running VMS, with Jnet as your network
  208. software, you can avoid the need for uuencoding.  You can tell the Jnet
  209. software to bypass the usual EBCDIC/ASCII translation, but there are a
  210. few additional steps needed before downloading a file.
  211.  
  212.     *  Receive the file with the Jnet command RECEIVE/BINARY.  The
  213.        BINARY modifier suppresses the normal EBCDIC/ASCII translation.
  214.        For the sake of discussion, assume that the file is now named
  215.        SOFTWARE.FIL.  This file, as received, is almost correct; but
  216.        there may be an error in how VMS interprets the records.
  217.  
  218.     *  Generate an FDL file for SOFTWARE.FIL using the command
  219.  
  220.           ANALYZE/RMS/FDL  SOFTWARE.FIL
  221.  
  222.     *  Edit the FDL file with the command
  223.  
  224.           EDIT/FDL  SOFTWARE
  225.  
  226.        Examine the CARRIAGE_CONTROL setting.  Change it to NONE.  Exit
  227.        from the editor.
  228.  
  229.     *  Use the edited FDL to correct carriage control interpretation
  230.        errors in the original SOFTWARE.FIL.
  231.  
  232.          CONVERT/FDL=SOFTWARE.FDL  SOFTWARE.FIL  FIXED_SOFTWARE.FIL
  233.  
  234.     *  Download the FIXED_SOFTWARE.FIL as a binary file using any
  235.        reliable means.  (For VAX Kermit, use the SET FILE TYPE BINARY
  236.        command before starting the download.)
  237.  
  238.  
  239. Unix Users.
  240.  
  241. If you save the uuencoded parts in the proper order under unix
  242. and then use the following script, which I call "lcombine" you should
  243. be able to receive the files intact.
  244.  
  245. #! /bin/sh
  246. cat $* | sed '/--- End /,/--- Part/d' | uudecode
  247.  
  248. This assumes the parts were saved using file names that sort
  249. alphabetically into the proper order.  Example:
  250.  
  251. simibm.uue01
  252. simibm.uue02
  253. simibm.uue03
  254.  
  255. lcombine simibm.uue*
  256.  
  257. The result will be simibm.zip and it should be readable.  The script
  258. eliminates the need to strip the headers from each uuencoded part.
  259.  
  260. There is another solution for those who may not be able to use the
  261. lcombine script.  A program called uucat ignores headers and trailers,
  262. passing just the uuencoded part.  It's available from SIMTEL20
  263. directory PD:<MISC.UNIX> as UUCAT.C and UUCAT.MSG.  It works just
  264. like the Unix cat command on uuencoded files (NOT xxencoded):
  265.  
  266. uucat simibm.uue* | uudecode
  267.  
  268.                                   (Contributed by Keith Petersen)
  269.  
  270.  
  271. ------------------------------------------------------------------------
  272. Common Problems
  273. ------------------------------------------------------------------------
  274.  
  275. Q. I downloaded this program to my micro, but when I run it, my machine
  276.    hangs (or I get the message "Out of Memory" or ...).
  277.  
  278. A. Either the file became corrupted in transit (perhaps one of those
  279.    nasty EBCDIC/ASCII translations), or the file was uuencoded and you
  280.    have not decoded it.
  281.  
  282.  
  283. Q. I downloaded an archive to my micro, but the de-archive utility
  284.    would not process it.  I get messages like "File not an archive" or
  285.    "Cannot extract member".
  286.  
  287. A. Same comments as above.
  288.  
  289.  
  290. Q. I really, really need to get these special files that I absolutely
  291.    must have, but the server limits how much I can request per day.  Is
  292.    there any way I can get around these limits for this one special case
  293.  
  294. A. No.
  295.  
  296.  
  297. Q. I am trying to get a file from the (top-level of the) MSDOS
  298.    directory.  /PDDIR won't list it, /PDGET claims it can't find it,
  299.    but I know it is there.
  300.  
  301. A. It may well be there at SIMTEL20.  However, the BITNET server is not
  302.    capable of handling any request for a file from the top-level of an
  303.    archive.  Generally, though, the files stored at the top level list
  304.    the contents of the archive.  The /PDDIR command can be used to get
  305.    a directory listing.
  306.  
  307.  
  308. Q. I have been requesting this same file repeatedly.  Each time the
  309.    server tells me my request has been "queued for processing," then a
  310. ------- cut here --------
  311.  
  312.  
  313. ----------------------- Headers ------------------------
  314. From <@VM1.NODAK.EDU:LISTSERV@VM1.NODAK.EDU> Sat Oct  9 03:21:16 1993
  315. Received: from VM1.NoDak.EDU by jlev.hp.aol.net with SMTP
  316.  (1.37.109.4/16.2) id AA02558; Sat, 9 Oct 93 03:21:16 -0400
  317. Return-Path: <@VM1.NODAK.EDU:LISTSERV@VM1.NODAK.EDU>
  318. Received: from VM1.NODAK.EDU by VM1.NoDak.EDU (IBM VM SMTP V2R2)
  319.    with BSMTP id 1210; Sat, 09 Oct 93 02:20:32 CDT
  320.  
  321. Received: from VM1.NODAK.EDU (NJE origin LISTSERV@NDSUVM1) by VM1.NODAK.EDU (LMail V1.1d/1.7f) with BSMTP id 4642; Sat, 9 Oct 1993 02:20:30 -0500
  322. Date:         Sat, 9 Oct 1993 02:20:29 -0500
  323. From: BITNET list server at NDSUVM1 (1.7f) <LISTSERV@VM1.NODAK.EDU>
  324. To: monkoty@AOL.COM
  325. Subject: #2(3)      File: "PDGET HELP"
  326. AOL-Member: monkoty
  327.  
  328.