home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / HAMRADIO / R95.ZIP / README.DOC < prev    next >
Encoding:
Text File  |  1989-02-16  |  12.0 KB  |  281 lines
  1.               R95 --- Binary to Data Text Conversion Utility           2/1/89
  2.  
  3.                     Version 1.1  (PC and PC Compatible)
  4.  
  5.  
  6.    By :                                  SHAREWARE Distributed by :
  7.     Greg Jones - WD5IVD                       Texas Packet Software
  8.     Dhanapong "Mouse" Saengrussamee           PO Box 50106
  9.                                               Denton, Texas   76206
  10.  
  11.                  
  12. Shareware  ==================================================================   
  13.  
  14. R95 is distributed by Texas Packet Software (TPS) as SHAREWARE.
  15. Send $15 to TPS to become a registered user of R95.  
  16. A registration form is included at the end. 
  17.  
  18. Registered users receive :
  19.  * R95 User's Manual
  20.  * R95 File Formats
  21.  * R95 encode / decode source
  22.  * Radix 95 - Binary to Text Data Conversion for Packet Radio
  23.  * Texas Packet Radio Society General Information
  24.  * A great feeling by supporting TPS software projects.
  25.  
  26.               **** Look for the Macintosh version soon ****
  27.  
  28.   ** R95 is provided 100% functional, so please register if you use it. **
  29.  
  30.  
  31. R95 LICENSE  ================================================================
  32.  
  33. All versions of R95, including version 1.1, are not public domain software,
  34. nor are they free software.  R95 is (C)1989 Greg Jones.
  35.  
  36.  Non-registered users are granted a limited license to use R95 on a trial 
  37. (15 day) basis for the purpose of determining whether R95 is suitable for 
  38. their needs.  Use of R95, except for this limited purpose, requires 
  39. registration. 
  40.  
  41.  All users are granted a limited license to copy R95 only for the trial use of 
  42. others subject to the above limitations, and also the following:
  43.  
  44.   * R95.ARC must be copied in unmodified form, complete with the file
  45.     containing this license information and R95.
  46.  
  47.   * R95 may not be distributed in conjunction with any other product.
  48.  
  49.   * Operators of electronic bulletin board systems (Sysops) may post R95 for 
  50.     down loading by their users only as long as the above conditions are met.
  51.  
  52.   * Distributors of public domain or user supported software may distribute 
  53.     copies of R95 subject to the above conditions only after obtaining written 
  54.     permission from TPS.  Such permission usually is granted; please write for 
  55.     details.
  56.  
  57.  
  58. Introduction  ===============================================================   
  59.  
  60.   Why R95 ?  The first reason is that the transfer of binary files for the 
  61. normal packet operator can prove to be difficult.  The solution is that every 
  62. packet operator understands how to operate a TNC in converse mode, so why not 
  63. make it possible to transfer binary files using converse mode.  The second 
  64. reason is that R95 generates less overhead than most common conversion 
  65. programs (18%-20% overhead).  [See Appendix A 'Radix 95 : Binary to Text Data 
  66. Conversion for Packet Radio' for further details in the User's Manual]
  67.  
  68.   The third reason is that R95 can also be used in many other applications
  69. besides amateur packet radio file transfer.  Many networks use conversion
  70. programs to convert their files for transfer, so R95 could be very useful.
  71.  
  72.   The other major aspect to the R95 utility is that it provides standard file 
  73. formats for encode, decode, split, and combine functions.  
  74.  
  75.   As a final note, I hope that this is a useful utility for the amateur packet 
  76. community at large as well as computer users in general.
  77.  
  78.                                             73 - Greg Jones WD5IVD
  79.  
  80.  
  81. Bug Reports / Correspondence  ===============================================                                                                                   
  82.  
  83. Please send bug reports and correspondence to :
  84.  
  85.         Texas Packet Software
  86.         ATTN : R95
  87.         PO Box  50106
  88.         Denton, Texas 76206
  89.  
  90.  
  91. Menu Commands  ==============================================================   
  92.  
  93.  * Type 'R95' to access the R95 utilities menu.
  94.  
  95.  R95 supports the following commands :  
  96.      (E)ncode   (D)ecode   (S)plit   (C)ombine   (P)ath   (!)    (Q)uit
  97.  
  98.  * Press the first letter of the command to access the command.
  99.  
  100. Encode - Reads a binary or text file and converts the file to R95 format.  
  101. The original file name and date of encoding is placed in the R95 header.  
  102. A character count check is placed at the end of the R95 format tail line.  
  103. R95 will prompt if you are about to overwrite an existing file.
  104.  
  105. Decode - Reads a R95 format file and converts it back to the original file.  
  106. Decode will read the first ten lines of the R95 format file for the R95 header 
  107. line.  This allows for the natural addition of lines introduced before the R95 
  108. header.  Decode will then restore the file and check to see if the character 
  109. count was correct, in case an error occurred in transmission.  R95 will prompt 
  110. if you are about to overwrite an existing file.  To change the filename being 
  111. extracted, edit the header filename.  .R95 is used as the default extension
  112. used if left off.
  113.  
  114. Split - Reads a R95 format file and splits the file into K-size sections.  
  115. Split creates FILENAME.### with ### being incremented for each file.  This 
  116. creates files .001, .002, .003 ...
  117.  
  118. Combine - Reads a R95SPLIT format file and recombines it back to a R95 format 
  119. file.   The split files must follow these rules : 1 - Have the same filename 
  120. and 2 - with the extension .001, .002 . . . corresponding to the numbering in 
  121. the split files.  To start the combination, enter filename without its 
  122. extension of .001.  Combine will attempt to recombine the files using the 
  123. numbered extensions.  It will also attempt to find the R95SPLIT header in the 
  124. first ten lines, thus allowing for the natural addition of information added 
  125. by mailbox systems.  R95 will prompt if you are about to overwrite an existing 
  126. file.  
  127.  
  128. Path - Allows the user to change where the files are being read and where the 
  129. files are being written to.
  130.  
  131. ! - The Dos-Gateway provides a shell to Command.COM.  Typing 'EXIT' while in 
  132. the gateway returns to R95.
  133.  
  134.  
  135. R95 Command Line Entry ======================================================    
  136.  
  137.  * Type 'R95 h' to access the R95 command line help.
  138.  
  139.  R95 version 1.1
  140.  Uses :
  141.     Menu driven   R95
  142.  
  143.  or Encode        R95 E InputFileName [OutputFilePath]
  144.  or Decode        R95 D InputFileName [OutputFilePath]
  145.  or Split         R95 S InputFileName [OutputFilePath]
  146.  or Combine       R95 C InputFileName [OutputFilePath]
  147.  where 
  148.    InputFileName is the name of file to be processed 
  149.                  (may include drive and/or path name)
  150.    OutputFilePath is (OPTIONAL) the drive and/or path name for output file(s).
  151.                  DO NOT INCLUDE FILE NAME.
  152.  
  153.  
  154. Potential Problems  =========================================================   
  155.  
  156.  Potential problems occur with items such as STREAMSW, which is sometimes set 
  157. to a '|' (vertical bar).  Such cases of printable characters being interpreted 
  158. by the TNC as a command could cause R95 uploads to fail.  If STREAMSW is set 
  159. to '|' (vertical bar), then the TNC will strip two characters.  The solution 
  160. is to set STREAMSW to a non-printable character.  The TAB character works well 
  161. for this.  Another problem is 'TNC buffer overflow'.  Depending on how your 
  162. computer talks to the TNC, you might feed the data too fast for the TNC to 
  163. handle, thus losing whole lines of characters.  The solution is to slow the 
  164. information dump to the TNC from the computer, or set-up correct flow control 
  165. between the TNC and the computer.
  166.  
  167.  Split has the tendency occasionally when splitting a R95 file into 1K
  168. segments to create a last file containing just the end tail line of the R95
  169. encode file.  You must send this file as is; either that, or choose another
  170. file split size.
  171.  
  172.  
  173. Recommendation  =============================================================   
  174.  
  175.  The important thing to remember is that the packet network is a fairly 
  176. fragile environment and when you want to transfer R95 files, you should 
  177. attempt to be as low-impact as possible.  That translates into using 
  178. compression programs (ARC and PKARC) to reduce the file size as much as 
  179. possible before encoding, as well as spacing the split files when you post 
  180. and/or send them.    
  181.  
  182.   The following numbers are recommendations for Split file sizes :
  183.  
  184.     Mailbox Forwarding over       Split Size
  185.        SKIP-NET                       5K or smaller
  186.        Uses TexNet PMS                7K Max
  187.        .01 Network                 8-10K
  188.        TexNet                     10-15K
  189.  
  190. NOTE : These are only recommendations; you should check with your local 
  191. mailbox operator concerning any local restraints.
  192.  
  193.  
  194. R95 File Formats  ===========================================================   
  195.  
  196.  R95 creates two basic types of file formats.  The first is the R95 format 
  197. file [R95 Format] which contains encoded data created by the R95 encode 
  198. function and read by the R95 decode function.  The second is the R95SPLIT 
  199. format which is used by the R95 split and R95 combine functions. [R95SPLIT 
  200. Format]  See User's Manual for specific format.
  201.  
  202.  
  203. WARRANTY  ===================================================================   
  204.  
  205.  TPS makes no warranty of any kind, express or implied, including without 
  206. limitation, any warranties and/or fitness for a particular purpose.  
  207. TPS shall not be liable for any damages, whether direct, indirect, special or 
  208. consequential arising from a failure of this program to operate in the manner 
  209. desired by the user.  TPS shall not be liable for any damage to data or
  210. property which may be caused directly or indirectly by use of the program.
  211.  
  212.  IN NO EVENT WILL TPS BE LIABLE FOR ANY INCIDENTAL OR CONSEQUENTIAL DAMAGES 
  213. ARISING OUT OF USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY CLAIM BY ANY 
  214. OTHER PARTY.
  215.  
  216.  
  217. Registration  ===============================================================   
  218.  
  219.        ##############################################################
  220.        #######                                                #######
  221.        #######  Send $15 to become a registered user of R95.  #######
  222.        #######                                                #######
  223.        ##############################################################
  224.  
  225.        Registered users receive :
  226.                              R95 User Manual
  227.                              R95 File Formats
  228.                        R95 encode / decode source
  229.          Radix 95 - Binary to Text Data Conversion for Packet Radio
  230.                Texas Packet Radio Society General Information
  231.             A great feeling by supporting TPS software projects.
  232.  
  233.               **** LOOK for the Macintosh version soon ! ****
  234.  
  235.   ------------------------------- cut here -------------------------------
  236.  
  237. R95 Registration - TPS                                           2/1/89
  238.  
  239. * R95 Version : _________________
  240.  
  241. Name : _________________________________      Call : ______________
  242.  
  243. Address : ______________________________      Apt : _______________
  244.  
  245.           ______________________________    
  246.      
  247.  
  248. City / St : ____________________________      Zip : _______________
  249.  
  250. Home Phone : (    ) ____________   Work Phone : (    ) ____________
  251.  
  252.  
  253. --- Please take a moment to answer the following questions :
  254.  
  255. * Where did you get your copy of R95 : ____________________________
  256.  
  257. * How do you plan to use R95 : ____________________________________
  258.  
  259.   _________________________________________________________________
  260.  
  261. * Which types of Networks do you use : ____________________________
  262.  
  263.   _________________________________________________________________
  264.  
  265. * What other types of programs would you find useful on packet :
  266.  
  267.   _________________________________________________________________
  268.  
  269.   _________________________________________________________________
  270.  
  271.  
  272.                      Mail to :
  273.                         Texas Packet Software
  274.                         ATTN : R95 Registration
  275.                         P.O. Box 50106
  276.                         Denton, Texas 76206
  277.  
  278.   ------------------------------- cut here -------------------------------
  279.  
  280.  
  281.