home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / ra / upldr102.zip / UPLOADER.DOC < prev    next >
Text File  |  1993-05-19  |  13KB  |  291 lines
  1.   
  2. UPLOADER                                                            Page   1
  3.  
  4.                                 - UPLOADER -
  5.                                 Version 1.02
  6.                            For RemoteAccess 2.00g
  7.                         Database Header File Utility
  8.                           *** SEE CHANGES DOC ***
  9. ┌─────────────────────────────────────────────────────────────────────────────┐
  10. │▒▒▒ The Legal Stuff ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  11. └─────────────────────────────────────────────────────────────────────────────┘
  12.  
  13. UPLOADER is Copyrighted 1993 by Rand Nowell - RaLin Enterprises.
  14.  
  15. This version of UPLOADER is released as a FREE program.
  16. Copyright is retained by the author, but you are not required to pay any
  17. registration fee to use it. You are free to run it on as many systems as you
  18. wish, and to give it to your friends, or even to people you "don't" like.
  19.  
  20. No warranties are expressed or implied, you accept all responsibility for
  21. the use of this program, data should be protected before modification.
  22. If anything breaks, you got both parts!
  23. The author will not be responsible for any damages resulting from your use
  24. of this program.
  25.  
  26. BACK UP IMPORTANT DATA BEFORE RUNNING ANY NEW PROGRAM THAT MODIFIES FILES!!
  27.  
  28. ┌─────────────────────────────────────────────────────────────────────────────┐
  29. │▒▒▒ Why Did I Write It ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  30. └─────────────────────────────────────────────────────────────────────────────┘
  31.  
  32. As many have found out, as will you if you are just getting ready to upgrade
  33. RemoteAccess from version 1.11 to 2.0g, when the conversion program does its
  34. conversion from FILES.BBS to the new database format, it does not, of
  35. course, install Uploaders names into the database header (.HDR) files, which
  36. are what's displayed to the user.
  37.  
  38. Rather than go through every single file entry with RAMGR to update things,
  39. I wrote UPLOADER. It only updates 2 things, the name of the uploader, and
  40. the file DownLoad counter. Thats all I needed at present.
  41.  
  42. It worked well, and I thought others might have a use for it.
  43.  
  44. ┌─────────────────────────────────────────────────────────────────────────────┐
  45. │▒▒▒ What It Does ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  46. └─────────────────────────────────────────────────────────────────────────────┘
  47.  
  48.  UPLOADER will work on ONE header file, or ALL header files.
  49.  
  50.  Just to make sure we all understand what I'm talking about, with RA's new
  51.  database format, you have a directory specified as the File Data directory,
  52.  mine is D:\FILEDATA, and under this RA creates 3 sub-directories. One each
  53.  for Index files, Text(Descriptions), and Header(.HDR). THe .HDR files are
  54.  the ones we are interested in here. These contain the information such as
  55.  Password, Keywords, D/l's etc. and of course, the name of the Uploader.
  56.  
  57.  This info is whats displayed to the user who asks for a file listing.
  58.  I have logged onto many RA systems, who have Uploaded By:       and a big
  59.  
  60.   Uploader - Beam me up a new name!
  61.  
  62.  
  63. UPLOADER                                                            Page  2
  64.  
  65.  blank. I didn't want that here, I'd rather have Lucy, or PigPen listed as
  66.  the uploader, than a big blank space.
  67.  
  68.  This is where UPLOADER comes in. It will let you specify the name to be
  69.  placed in the Uploaded By field, and optionaly assign a new count to the
  70.  Downloads number.
  71.  
  72.  UPLOADER.EXE should be placed in a directory that is in your PATH
  73.  statement. DO NOT place it in the RA Database directory.
  74.  
  75.  You need to change to the RA databse HDR directory before running UPLOADER,
  76.  it expects to find *.HDR files in the current directory.
  77.  
  78. ┌─────────────────────────────────────────────────────────────────────────────┐
  79. │▒▒▒ How It Works ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  80. └─────────────────────────────────────────────────────────────────────────────┘
  81.  
  82. Figured you might like to know how to do it!
  83.  
  84. There are three ways to run UPLOADER....
  85. See SWITCHES below for additional actions, or refer to WHATSNEW.DOC
  86.  
  87.  
  88. 1. UPLOADER ? will present a help screen.
  89.  
  90. 2. UPLOADER FDB#.HDR where the # or ### specifies what file area header file
  91.    you wish to work on. If you have 44 file areas you will have 44 .HDR
  92.    files, named FDB1.HDR to FDB44.HDR
  93.    So if you want to only modify the names and/or D/L count on one file
  94.    area, this is the command format you use.
  95.  
  96. 3. UPLOADER        The program name by itself, will cause ALL FDB*.HDR to be
  97.    modified. Let me re-phrase that, all .HDR files for a file area that has
  98.    file descriptions for them. If there are no files, or more accuratly, if
  99.    there are no entries in the database for that file area, UPLOADER will
  100.    skip it.
  101.  
  102. ┌─────────────────────────────────────────────────────────────────────────────┐
  103. │▒▒▒ Switches ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  104. └─────────────────────────────────────────────────────────────────────────────┘
  105.              ALSO SEE WHATSNEW.DOC FOR THE ADDITIONS TO THIS VERSION
  106.  
  107.  There have been a couple of additions to UPLOADER in this release.
  108.  The following switches may be used on the command line at starup. They may
  109.  be upper or lower case, and may be placed anywhere in the command,
  110.  before, after or before and after the HDR file name.
  111.  
  112.  (*) Represents *.*  Do NOT use *.*, always use the single asterisk. This
  113.  tells UPLOADER that what you enter is to be applied to ALL .HDR files.
  114.  
  115.  (L) for LITERAL, then uploader name will be written EXACTLY as you enter
  116.  it. If the L is not used, the default is to place the name in PROPER case,
  117.  first letter of each name will be capitalized, all the rest will be in
  118.  lower case.
  119.  
  120.  
  121.   Uploader - Beam me up a new name!
  122.  
  123.  
  124. UPLOADER                                                            Page  3
  125.  
  126.  (R) Search and Replace: You will be prompted for what name to replace, all
  127.  comparisons will be done in upper case mode, so you can enter this name in
  128.  any case...upper, lower or mixed. UPLOADER will then change only the
  129.  records that contain this name, to the new name you specify.
  130.  
  131.  Some examples:
  132.  
  133.  UPLOADER   by itself, prompts for new name and D/L count. Updates all
  134.  records in ALL HDR files.
  135.  
  136.  UPLOADER *  Same as above.
  137.  
  138.  UPLOADER * R  Prompts for name to search and replace. Will check ALL HDR
  139.  files, replacing only those that match.
  140.  
  141.  UPLOADER * L  Will update all files,records with the new name exactly as
  142.  you enter it.
  143.  
  144.  Including a HDR file name with any of the above, will restrict actions to
  145.  that file only.
  146.  
  147.  UPLOADER FDB15 R (or r) will prompt for name to replace, and new name, D/L
  148.  and check records in that file only.
  149.  
  150.  Syntax: Examples of valid syntax format....
  151.  
  152.  UPLOADER * R L
  153.  UPLOADER R * L
  154.  UPLOADER r fdb12 l
  155.  UPLOADER fdb13 r l
  156.  
  157.  Its really a very relaxed format, you can put switches any way you want
  158.  them!
  159.  
  160. After you have fired up UPLOADER with either method 2 or 3 you will be
  161. prompted for the name to use as uploader. No matter how you enter the name,
  162. all upper case, all lower, or a mix, it will be converted to Proper case. In
  163. other words, the entry of rand nowell will become Rand Nowell.
  164.  
  165. You can over-ride the Proper casing of the name by including the L switch on
  166. the command line. The L stands for "Literal" which means the uploader name
  167. will be written "EXACTLY"  as you enter it.
  168.  
  169. Next you are asked for a Download Count value, if you do not wish these to
  170. change, just enter a zero. Currently there is no way to change the count
  171. from say 22 to 0, the minimum number you can change to is 1 (one).
  172. I tried a -1 but that didn't work right, and I didn't feel like going to all
  173. the code work required to make it do so. So, this is they way it works for
  174. now.
  175.  
  176. By the way, the max value allowed is 65535 for D/L, but there is no
  177. checking. If you enter a -1 the count will be set to 65535, and if you enter
  178. say 66536, it will be set to something like 1000. So, be sure of the number
  179. you enter. If you DO make a mistake, just run UPLOADER again with the
  180. correct value.
  181.  
  182.   Uploader - Beam me up a new name!
  183.  
  184.  
  185. UPLOADER                                                            Page  4
  186.  
  187.  
  188. Another note, you cannot JUST change the D/L counter, and you cannot JUST
  189. enter a blank for Uploader name, and expect to have it NOT modify the name
  190. in the file. Remember, this is just a quick and dirty program. It works, but
  191. there are no bells and whistles.
  192.  
  193. Once the Uploader Name has been entered, the UPLOADER starts working.
  194. It displays a progress bar which grows for each .HDR file processed, and
  195. when its done it will tell you how many .HDR files were processed. This
  196. count only lists the files that were actually modified, not the total number
  197. of .HDR files in the directory.  If you have 56 .HDR files, but 3 of those
  198. have no file data in them, then the count will only show 53. Simple enough..
  199.  
  200. UPLOADER now lists more information on completion.
  201. It lists how many records were read, how many written, how many Search &
  202. Replace's were done, and how many HDR files were processed.
  203.  
  204. If you have not run UPLOADER before, or in some time, you may see a
  205. difference in the number of records read, and those written.
  206. This is because UPLOADER now removes "dead" records.  It effectivly "PACKS"
  207. the HDR file.
  208.  
  209. NOTE: This is NOT a replacement for RAFILE's COMPRESS, as it does NOTHING to
  210. the index or description files. But it does help.  On a test run with 23 HDR
  211. files containing 113 file records it reduced the total byte size of the
  212. directory by 15325 bytes. So everytime you run it, it does a little house
  213. cleaning.
  214.  
  215. UPLOADER does not modify any entry whose file size is zero (0), if you have
  216. entries for files that are Offline, no action is taken on these files, and
  217. they are not counted in the Files Written total.
  218.  
  219. There is a way to actually PACK the HDR files, without actually doing any
  220. modification. Run as UPLOADER * R
  221.  
  222. When prompted for the name to replace, enter a name you "KNOW" does not
  223. exist, something like Lisa Magillicuddy, and enter anything for the new
  224. name.
  225.  
  226. UPLOADER will never find this fictional name, thus no changes will be made,
  227. but while it is searching it will remove any empty records.
  228.  
  229. I think that about covers it.
  230. Like I said, it works for me! And if it works for you, then outstanding!
  231.  
  232.  
  233. Have added a companion program, LISTREC.EXE, which will list the HDR files
  234. to the screen or printer. See LISTREC.DOC
  235.  
  236. ┌─────────────────────────────────────────────────────────────────────────────┐
  237. │▒▒▒ You Tell Me ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  238. └─────────────────────────────────────────────────────────────────────────────┘
  239.  
  240. If you find UPLOADER useful to you, I'd like to hear about it.
  241. If you would like to see it progress into something more, tell me!
  242.  
  243.   Uploader - Beam me up a new name!
  244.  
  245.  
  246. UPLOADER                                                            Page  5
  247.  
  248.  
  249. It is very possible I could set it up to allow you to TAG files you wish to
  250. work with, allow more data to be changed, mabey allow new information for
  251. each tagged .HDR file as it comes up in the list.....
  252.  
  253.  
  254. I am open to suggestions and/or requests, if no intrest is shown, then this
  255. is probably where it will end. If response is positive, I will consider
  256. upgrading the UPLOADER. And I will try to keep this a FREE program, Sysops
  257. need to save a buck here and there <grin>.
  258.  
  259. ┌─────────────────────────────────────────────────────────────────────────────┐
  260. │▒▒▒ Contacting The Author ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  261. └─────────────────────────────────────────────────────────────────────────────┘
  262.  
  263. If you wish to contact me with requests, suggestions, party invitations....
  264. And I'll accept a complaint or two, I can be reached via the following.
  265.  
  266. ECHOS:       RA SUPPORT - RA UTILS - SHAREWARE
  267. Voice:       (510) 651-0253
  268. BBS  :       (510) 651-0253(4 second pause)3322
  269.               Yep, its a pain. One line for voice, BBS, Mailer. The pause
  270.               and code are required to access the Mailer/BBS...Sorry, hope
  271.               to have it fixed soon!
  272. NetMail:      1:161/710
  273.               If you NetMail, you will have to poll for your reply, usually
  274.               within 24 hours. Free program ya know. If the reply does not
  275.               get picked up, it will go out routed.
  276.  
  277. Snail Mail:   Rand Nowell
  278.               RaLin Enterprises
  279.               40728 Sundale Dr.
  280.               Fremont, Ca. 94538  USA
  281.  
  282. ┌─────────────────────────────────────────────────────────────────────────────┐
  283. │▒▒▒ Credits and Thanks! ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  284. └─────────────────────────────────────────────────────────────────────────────┘
  285. Thanks to Charlie Merryman who suggested the ability to enter names any way
  286. you want, and being able to search and replace.
  287.  
  288. <eof UPLOADER.DOC>
  289.    Uploader - Beam me up a new name!
  290.  
  291.