home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / CONVERT2.ZIP / CONVERT.002 / CONVERT.DOC < prev    next >
Encoding:
Text File  |  1993-04-22  |  3.6 KB  |  80 lines
  1.                          CONVERT v0.02 - April 22, 1993
  2.                          ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. Warranty
  5. ~~~~~~~~
  6. Yeah, right.  This program is provided as is.  It works on my system, and
  7. I see no reason why it won't work elsewhere, but if it chews up your
  8. hard drive, well, good luck to you.
  9.  
  10. Registration
  11. ~~~~~~~~~~~~
  12. This program is distributed as freeware.
  13.  
  14. This is a simple, quick 'n' dirty utility to allow you to run doors written
  15. for RA 1.11 with the new RA 2.0/Gamma release.  Any fool can run it, but
  16. since fools are so ingenious according to Mr. Murphy, we have documentation.
  17. In your batch file before the door is executed, put this line:
  18.  
  19. CONVERT 111
  20.  
  21. This will do the following:
  22.   1) Rename your existing RA 2.0 CONFIG.RA, FILES.RA, MESSAGES.RA, and
  23.      EXITINFO.BBS to .TMP files.
  24.   2) Create an RA 1.11 style CONFIG.RA - note that only a few fields are
  25.      converted as most doors use only a few fields from this field.  The
  26.      ones converted are the Sysop name, System name, menu path, path to
  27.      your message base, your RA system path, the path to your textfiles,
  28.      RA logfilename, the RA semaphore path, and the net addresses.
  29.  
  30.   3) Create an RA 1.11 style FILES.RA and MESSAGES.RA from the existing
  31.      files.  All fields are converted.  If you have more than 200 entries,
  32.      only the first 200 are converted.  If you have less than 200, extra
  33.      records with null information are appended.
  34.   4) Create an RA 1.11 style EXITINFO.BBS.  All fields are converted.
  35.  
  36. After the door has executed, place this line in your batch file before
  37. returning to RA:
  38.  
  39. CONVERT 200
  40.  
  41. This will do the following:
  42.   1) Update the RA 2.00 EXITINFO.BBS file with the information that could
  43.      have changed.  This includes the user security, the "readthru" field,
  44.      highest message read, wantchat, sysopnext, and timelimit.
  45.   2) Delete the RA 1.11 style files, and rename the 2.00 files back to
  46.      their proper names.
  47.  
  48. This program assumes a few things.  You MUST run it from the RA system
  49. directory - it looks for those files in the current directory.  If one
  50. of the files doesn't exist, it is simply skipped.  This program does NOT
  51. directly modify or convert your USERS*.BBS files, and neither does any
  52. other door written by an author who has two brain cells to rub together.
  53. EXITINFO.BBS contains a copy of the user records which RA reads upon returning
  54. from the Type 7/15, therefore there is no reason to directly modify the
  55. user records. (it wouldn't do any good anyway as RA will write the record
  56. back to the user file when the user hangs up... any changes made to the user
  57. file will be ovewritten, so it's pointless to directly modify those files).
  58. This program does not convert your LASTREAD.BBS file because the structure
  59. has not changed since 1.11, and this file is directly modified by programs
  60. like RAMail to update the last read pointers.
  61.  
  62. All files are opened in Read/Write/Deny-None mode, and slower BIOS screen
  63. writes are used to avoid "bleeding" under DESQview, and if DESQview is
  64. detected, it will use DESQview screen writes.
  65.  
  66. This is meant ONLY to help you run your RA 1.11 doors... do NOT use this
  67. if you want to run a program like Mbutil, Tsutil, Feutil, etc.  These
  68. programs need to directly modify the user files when packing your message
  69. base.  Since user files are not touched by this program, it will not do
  70. them any good.  If you have any questions or problems, feel free to netmail
  71. me at 1:261/1108 and we'll get it straightened out.
  72.  
  73. Addendum
  74. ~~~~~~~~
  75. 05 March 1993
  76.  
  77. The USERON.BBS file is now converted as well since some doors such as RAMail
  78. read this file.
  79.  
  80.