home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / renqwk.zip / RENQWK.DOC < prev   
Text File  |  1993-11-06  |  5KB  |  142 lines
  1.                             RENQWK V1.0
  2.  
  3.                        WHAT "RENQWK" DOES
  4.  
  5. RENQWK is a OS/2 REXX exec that will rename all the QWK packets that you
  6. have in your specified QWK directory.  The new name will consist of a
  7. user-specified abbreviation for the BBS's QWK packet, followed by the
  8. date that it was downloaded on.  I'll show you how to configure RENQWK
  9. to do this later, but first I'll show you a quick example of how it
  10. works.
  11.  
  12. Before you run RENQWK, the directory that contains your QWK packets may
  13. look something like the following:
  14.  
  15. 11-06-93   1:33p    346728           0  allfiles.zip
  16. 11-05-93   7:07p    125902           0  b-beard.qwk
  17. 11-06-93   5:27p     87922           0  b-beard.qw1
  18. 11-06-93   7:00p     79904           0  b-beard.0
  19. 11-05-93   4:02p    134967           0  doors.qwk
  20. 11-06-93   8:01p    225948           0  doors.0  
  21. 11-06-93   8:15p     85624           0  doors.1
  22. 11-06-93   6:24p    136400           0  farther.qwk
  23. 11-06-93   6:45p     56674           0  farther.0
  24. 11-06-93   6:56p     26674           0  farther.1
  25. 11-05-93  11:42p     23939           0  spos2.zip
  26.  
  27.  
  28. After you run RENQWK, the directory that contains your QWK packets will
  29. look something like the following:
  30.  
  31. 11-06-93   1:33p    346728           0  allfiles.zip
  32. 11-05-93   7:07p    125902           0  bb931105.qwk
  33. 11-06-93   5:27p     87922           0  bb931106.qwk
  34. 11-06-93   7:00p     79904           0  bb931106.qw1
  35. 11-05-93   4:02p    134967           0  dr931105.qwk
  36. 11-06-93   8:01p    225948           0  dr931106.qwk  
  37. 11-06-93   8:15p     85624           0  dr931106.qw1
  38. 11-06-93   6:24p    136400           0  fr931106.qwk
  39. 11-06-93   6:45p     56674           0  fr931106.qw1
  40. 11-06-93   6:56p     26674           0  fr931106.qw2
  41. 11-05-93  11:42p     23939           0  spos2.zip
  42.  
  43. To more easily compare the changes, here are the names of the files
  44. side-by-side, before and after running RENQWK:
  45.  
  46.   BEFORE        AFTER
  47. ------------  ------------
  48. allfiles.zip  allfiles.zip
  49. b-beard.qwk   bb931105.qwk
  50. b-beard.qw1   bb931106.qwk
  51. b-beard.0     bb931106.qw1
  52. doors.qwk     dr931105.qwk
  53. doors.0       dr931106.qwk  
  54. doors.1       dr931106.qw1
  55. farther.qwk   fr931106.qwk
  56. farther.0     fr931106.qw1
  57. farther.1     fr931106.qw2
  58. spos2.zip     spos2.zip
  59.  
  60.  
  61. As you can see, RENQWK does not mess with non-QWK files.  It ONLY renames
  62. those files with an extension beginning with:
  63.     .QWn, where n is a number 0 through 9
  64. or
  65.     .n, where n is a number 0 through 9
  66.  
  67. Also, you can see that if you have downloaded a file from the same BBS
  68. on the same day, RENQWK will take care of automatically incrementing the
  69. .QWK extension as .QWn, where again, n is a number 0 through 9.
  70.  
  71.  
  72.                HOW TO INSTALL AND CONFIGURE "RENQWK"
  73.  
  74. To install RENQWKJ, Unzip RENQWK.ZIP into a subdirectory that is on your
  75. OS/2 PATH.  You should then see the following files:
  76.  
  77. RENQWK.CMD  is the REXX program.
  78. RENQWK.DOC  is the documentation you're reading now.
  79. RENQWK.CFG  is the configuration file.
  80.  
  81. You MUST modify RENQWK.CFG in order for RENQWK to run on your system.
  82. RENQWK.CFG can be modified with any ASCII text editor.  An example of
  83. the RENQWK.CFG contents follows:
  84.  
  85.     D:\COMM\DOWNLOAD
  86.     FANTASY! = FY
  87.     FARTHER  = FR
  88.     DOORS    = DR
  89.     EXTRA    = EX
  90.     B-BEARD  = BB
  91.  
  92. The first line MUST contain the directory where your QWK are located. 
  93. In the RENQWK.CFG file above, this directory is "D:\COMM\DOWNLOAD".
  94.  
  95. The second and all other lines contain the abbreviations that are used
  96. when renaming each BBS's QWK files.  You may specify any two letters
  97. for the abbreviation that you like.  For example, if a BBS's QWK files
  98. are called "FANTASY!.QWK", then RENQWK will rename the file using the
  99. prefix of "FY" when renaming the file, based on the information
  100. contained in the second line of the example RENQWK.CFG file above:
  101.     FANTASY! = FY
  102.  
  103. If RENQWK finds a QWK file that does not have an entry in the RENQWK.CFG
  104. configuration file, it will still rename the file, but prefix it with "UN"
  105. for "unknown."  If you see an entry renamed in this way, it is a signal
  106. to you to add this a line for this BBS to the RENQWK.CFG file.
  107.  
  108. Finally, if you wish to execute RENQWK from any subdirectory other than
  109. the subdirectory that contains your RENQWK.CFG file, you must set an
  110. environment variable that tells RENQWK where to find the RENQWK.CFG
  111. configuration file.  This may be done by adding a line to your CONFIG.SYS
  112. file as follows:
  113.     SET CMDDIR=d:\dir
  114.  
  115. where "d:" is the drive you installed RENQWK on, and
  116.       "\dir" is the subdirectory where you installed RENQWK on
  117. For example, on my system, I installed RENQWK in the subdirectory
  118. "D:\CMD", so I've set the environment variable as follows:
  119.     SET CMDDIR=D:\CMD
  120.  
  121.  
  122.                           HOW TO RUN RENQWK
  123.  
  124. Once you have RENQWK configured, all you have to do is type
  125.     RENQWK
  126. on any OS/2 command line.  That's it.  It will then rename your QWK
  127. files, and then tell you how many files were renamed.  
  128.  
  129. RENQWK is FreeWare--enjoy.
  130.  
  131. Steve Allen
  132. Altech Computer Services
  133. 121 Herta St.
  134. Easley, SC 29640
  135. (803) 234-5071
  136.  
  137. Nov 93
  138.  
  139. /* end of RENQWK.DOC */
  140.  
  141.  
  142.