home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbs / wcpcb102.zip / WC2PCB.DOC < prev    next >
Text File  |  1992-10-22  |  12KB  |  264 lines
  1. WC2PCB 1.02 -> Wildcat! 3.5 to PCBoard 14.5a conversion
  2.                utility for user files and message bases
  3.  
  4.  
  5. Copyright (C) 1992, Clark Development Company, Inc.
  6.  
  7.  
  8. LICENSE TO USE AGREEMENT
  9. ------------------------
  10.  
  11. Clark Development Company (CDC) grants to the user a nonexclusive
  12. license to use the program WC2PCB.EXE.  CDC makes no warranties of any
  13. kind, expressed or implied, with respect to the quality, performance,
  14. accuracy or fitness of the software.  In no event shall CDC, or any of
  15. its representatives, be liable for any loss of profit or damage arising
  16. from the use or inability to use this software even if CDC or an
  17. authorized agent of CDC has been advised of the possibility of damage.
  18. CDC reserves the right to make changes, enhancements, and improvements
  19. to the software at any time and without notice.
  20.  
  21.  
  22. ABOUT WC2PCB
  23. ------------
  24.  
  25. WC2PCB.EXE is a utility to convert user database files and message bases
  26. from Mustang Software's Wildcat! Bulletin Board Software to CDC's
  27. PCBoard Premium Bulletin Board Software.  WC2PCB performs these
  28. functions when the user of the software provides the necessary arguments
  29. via command line parameters.
  30.  
  31. NOTE:  To convert the message bases, WC2PCB utilizes Universal Text
  32. Interface (UTI) drivers.  There is a set of UTI drivers available for
  33. download from Mustang Software's Support BBS by the name of WC35UTI.ZIP.
  34. Make sure that you download this file, unzip it, and copy the
  35. UTIEXPRT.EXE file to the directory where WC2PCB.EXE is located before
  36. you attempt to convert any message bases.
  37.  
  38.  
  39. WC2PCB USAGE
  40. ------------
  41.  
  42.    Converting Users Files
  43.  
  44.   
  45.       WC2PCB /USERS;[wc_users];[pcb_users]
  46.       
  47.           wc_users is the location of Wildcat!'s ALLUSERS.DAT.
  48.           
  49.           pcb_users is the location where the converted PCBoard users file
  50.           should be created.
  51.  
  52.       To convert your Wildcat! users file to PCBoard format you must know
  53.       the location of your ALLUSERS.DAT file and the location where you 
  54.       want to store your USERS file for PCBoard.
  55.       
  56.       For example, if your ALLUSERS.DAT was stored in C:\WC30\DATA\ and
  57.       you wanted your USERS file to be created in C:\PCB\MAIN\ then you
  58.       would use the following:
  59.       
  60.          WC2PCB /USERS;C:\WC30\DATA\ALLUSERS.DAT;C:\PCB\MAIN\USERS
  61.    
  62.       For further detailed instructions on converting your users file
  63.       please see "HOW TO CONVERT THE USER DATABASE".
  64.    
  65.    Converting Message Files
  66.  
  67.       WC2PCB /MSGS;[wc_path];[wc_confnum];[pcb_msgs]
  68.       
  69.           wc_path is the home directory for your Wildcat! installation  
  70.           (e.g., C:\WC30).
  71.           
  72.           wc_confnum is the Wildcat! conference number you wish to convert
  73.           to PCBoard MSGS format.
  74.          
  75.           pcb_msgs is the complete path and filename of the message file
  76.           that will be converted from Wildcat! format to PCBoard format 
  77.           (e.g., C:\PCB\MAIN\MSGS).
  78.  
  79. If you type WC2PCB at the command line without any command line
  80. parameters, it will provide an information screen with usage
  81. information.  Legal options are /USERS and /MSGS, each followed by
  82. required parameters.  After you have performed the selected conversions
  83. there are a couple of other steps that need to be performed separately.
  84. The complete process for each conversion is documented below.
  85.  
  86.  
  87. HOW TO CONVERT THE USER DATABASE
  88. --------------------------------
  89.  
  90. The first step in converting the user database is to process the
  91. Wildcat! user file and convert it to the PCBoard user file. To do this,
  92. you must first make sure you know the locations of your ALLUSERS.DAT 
  93. file (Wildcat! users file) and your USERS file (PCBoard users file).  
  94. Typically these locations are C:\WC30\DATA\ALLUSERS.DAT and 
  95. C:\PCB\MAIN\USERS respectively.
  96.  
  97. Next, you need to execute WC2PCB using the appropriate syntax as 
  98. described earlier.  As an example, lets say that your Wildcat! users
  99. file is stored in D:\WC30\DATA\ALLUSERS.DAT and that your PCBoard
  100. users file is stored in C:\PCB\MAIN\USERS.  If this case you would
  101. use the following to convert your Wildcat! users file to PCBoard
  102. format:
  103.  
  104.    WC2PCB /USERS;D:\WC30\DATA\ALLUSERS.DAT;C:\PCB\MAIN\USERS
  105.  
  106.    NOTE:  If WC2PCB cannot find the ALLUSERS.DAT file then you will 
  107.           receive an error message and the conversion process will
  108.           be aborted.
  109.          
  110.           Likewise, if you specify the location of a PCBoard users
  111.           file that already exists then you will be notified that it
  112.           already exists and the conversion program will be aborted.
  113.           You must delete your existing PCBoard users file or specify
  114.           a different location to create the new PCBoard USERS file.
  115.        
  116.           If you wish to keep your existing users file and also use
  117.           the converted Wildcat! users file then you will need a utility
  118.           that will merge the two user files.  Salt Air (The PCBoard
  119.           support BBS) has such a utility which is available under 
  120.           the filename MERGEUSR.ZIP.
  121.        
  122. As the conversion is taking place you will see the following screen:
  123.  
  124.    WC2PCB 1.01 -> Wildcat! 3.5 to PCBoard 14.5a conversion
  125.                   utility for user files and message bases
  126.                
  127.    Copyright (C) 1992, Clark Development Company, Inc.
  128.  
  129.    Processing . . . 8  
  130.                     ^
  131.                     +--- Shows record currently being converted
  132.  
  133. Once the conversion has been completed, you will be asked where you want 
  134. the conversion report sent to.  This report shows which PCBoard security 
  135. level corresponds with the Wildcat security profile.  You can send this
  136. report to a filename, the screen, or to the printer.  Below are some 
  137. sample entries you could enter at the prompt.
  138.  
  139.    PRN                  Sends report to printer on LPT1:
  140.    C:\CONVERT.TXT       Sends report to C:\CONVERT.TXT
  141.    CON                  Sends report to the console (screen)
  142.  
  143. Because there really is no way to translate security levels between
  144. Wildcat! and PCBoard you will need to use this report to help you
  145. change the security levels.  For example, let's say our report looks
  146. like this:
  147.  
  148.         WC2PCB Security Profile -> Security Level Report
  149.         ================================================
  150.  
  151.                       Name        -  Level
  152.                       --------------------
  153.                       SYSOP       -      1
  154.                       FULLUSER    -      2
  155.                       NEWUSER     -      3
  156.                                                                       
  157. This tells us that there were three Wildcat security profiles called
  158. SYSOP, FULLUSER, and NEWUSER.  It shows that every user in your Wildcat!
  159. system that had a security profile of SYSOP were given a security level
  160. of 1 in the PCBoard users file.  Likewise, every use with a FULLUSER
  161. security profile was given a security level of 2 in the PCBoard users file.
  162.  
  163. Before you adjust the security levels in your new users file you need to
  164. create a USERS.INF file.  To do this, change to the directory where you
  165. installed PCBoard and type:
  166.  
  167.     PCBSM /UPGRADE
  168.  
  169. Of course, the security levels that WC2PCB assigned to the new users 
  170. file are probably not what you had in mind.  Therefore, you will need to 
  171. use PCBSysMgr (PCBSM) to adjust the security levels.  Once PCBSM is 
  172. loaded select Users File Maintenance.  Next, select Adjust by Ranges.  
  173. You should see a screen like the one below:
  174.  
  175.  ╔════════════════════════════════════════════════════════════════════════════╗
  176.  ║                           PCBoard System Manager                           ║
  177.  ║                          Adjust Security by Range                          ║
  178.  ║                                                                            ║
  179.  ║                                                                            ║
  180.  ║                                                                            ║
  181.  ║  Change users whose security is greater than or equal to :   0             ║
  182.  ║        and whose security level is less than or equal to :   0             ║
  183.  ║                                                                            ║
  184.  ║  To a new security level of :   0                                          ║
  185.  ║                                                                            ║
  186.  ║                                                                            ║
  187.  ║                   Press PGDN to continue, or ESC to exit                   ║
  188.  ║                                                                            ║
  189.  ║                                                                            ║
  190.  ╚══ 11:39:38 ═══ 10-13-92 ═════ F1 ═ help ═══ caps: OFF  num: ON   ins: OFF ═╝
  191.  
  192. If we wanted to assign everyone with a security level of 1 to a security level
  193. of 110 you would make your screen look like the following:
  194.  
  195.  ╔════════════════════════════════════════════════════════════════════════════╗
  196.  ║                           PCBoard System Manager                           ║
  197.  ║                          Adjust Security by Range                          ║
  198.  ║                                                                            ║
  199.  ║                                                                            ║
  200.  ║                                                                            ║
  201.  ║  Change users whose security is greater than or equal  to:   1             ║
  202.  ║        and whose security level is less than or equal to :   1             ║
  203.  ║                                                                            ║
  204.  ║  To a new security level of :   110                                        ║
  205.  ║                                                                            ║
  206.  ║                                                                            ║
  207.  ║                   Press PGDN to continue, or ESC to exit                   ║
  208.  ║                                                                            ║
  209.  ║                                                                            ║
  210.  ╚══ 11:39:38 ═══ 10-13-92 ═════ F1 ═ help ═══ caps: OFF  num: ON   ins: OFF ═╝
  211.  
  212. Do that for each security profile that you had in your Wildcat! users 
  213. file and you should be ready to go.
  214.  
  215.  
  216. HOW TO CONVERT A MESSAGE BASE
  217. -----------------------------
  218.  
  219. The first step in converting a message database is to run WC2PCB with
  220. the /MSGS command.  See the syntax at the beginning of the document
  221. for further details.  First make sure you know the name/location of your
  222. message databases and also the name/location where the new PCBoard style
  223. message bases should be stored.  
  224.  
  225. Once you know these locations you can execute the WC2PCB program using 
  226. the appropriate syntax as describe at the beginning of the document.  As 
  227. an example, lets say that Wildcat! is installed in C:\WC30 and you wish 
  228. to convert conference number 1 over to a PCBoard message format stored 
  229. in C:\PCB\MAIN\MSGS.  If you wish to do this conversion you would use 
  230. the following command:
  231.  
  232.    WC2PCB /MSGS;C:\WC30;1;C:\PCB\MAIN\MSGS
  233.  
  234. You will need to repeat these steps for each conference you wish to
  235. convert.
  236.  
  237. Once you have finished doing the conversions, you will need to run
  238. PCBPACK (located where you installed PCBoard) to pack the new message 
  239. bases.  If you converted 10 conferences then you would execute the 
  240. following command:
  241.  
  242.    PCBPACK /AREA:0-10
  243.    
  244. Once you have followed the above steps, your message bases will have
  245. been properly converted for use with PCBoard.
  246.  
  247.  
  248. HOW TO CONTACT US
  249. -----------------
  250.  
  251. If you have any problems with this conversion program, please do not
  252. hesitate to call us.  Our technical support staff can be reached voice
  253. at (801) 261-1686.  If you wish to leave a message on our support BBS
  254. then you can call (801) 261-8976 (all nodes are v.32bis capable).
  255.  
  256.  
  257.  
  258.  
  259.  
  260. "PCBoard" is a registered trademark of Clark Development Company, Inc.
  261. "Wildcat!" is a registered trademark of Mustang Software, Inc.
  262. "Universal Text Interface" and "UTI" are trademarks of Kip Compton
  263.  
  264.