home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / XNSREG.ZIP / XNSREG.DOC < prev    next >
Text File  |  1993-08-24  |  20KB  |  415 lines
  1.                         XBase Network System
  2.                    5337 College Avenue, Ste.#451
  3.                          Oakland, CA 94618
  4.                          BBS: 510/687-3633
  5.  
  6.                                    
  7.                              XNSREG v.3.1
  8.                      An RBBS Registration System
  9.  
  10.  
  11.             XNSREG is a very powerful program. It is written in
  12.             QuickBasic 4.5, Microsoft C, Assembly, and uses BTree 
  13.             for Databases including Indices. 
  14.       
  15.             It only runs on bulletin board that supports DORINFO?.DEF
  16.             file system. The program is specifically written for RBBS
  17.             version 17.4 users. It will require users to fill-out the
  18.             registration form online. By defining on XNSREG configuration
  19.             the security level of users that require to register as well as
  20.             users to RENEW, it will update RBBS USERS & Reg. date onLine 
  21.             for you. If you accept VISA, MC, AMEX, DISCOVER, you can run
  22.             a separate program and tell the XNSREG1.EXE where to locate
  23.             your credit card application program. Payment options for 
  24.             BBS requiring membership can be: Cash, Money Order, Charge,
  25.             Visa, MC, Amex, Discover.
  26.  
  27.             The program is a door program. In future, we may merge the
  28.             program with RBBS registration system.
  29.  
  30.             To register, you can fill-out the form ORDER.FRM and send it 
  31.             to us by mail with your payment or use our Questionnaire 
  32.             facility and select "XNSREG" to register online. 
  33.  
  34. OTHER DOCUMENTATION:
  35.  
  36. DORINFO.TXT
  37. CONFIG.TXT
  38.  
  39.  
  40. Files Required to Operate XNSREG.
  41.  
  42. XNSREG1.EXE - Executable file to generate XNSREG.CFG
  43. XNSREG2.EXE - Executable XNSREG System Proper
  44. XNSREG.CFG  - Configuration File of XNSREG
  45. DORINFO?.DEF - RBBS Dorinfo.Def File
  46. USERS       - The RBBS users file.
  47.  
  48. INSTALLATION AND SET-UP
  49.  
  50. The following file had been renamed :
  51.  
  52. XNSREG1.EXE     TO      INSTALL.EXE
  53. XNSREG2.EXE     TO      XNSREG.EXE
  54.  
  55. We assume you know how to configure RBBS to exit to a DOOR and execute a
  56. door program such as, XNSREG.
  57.  
  58. 1. Create your XNSREG Configuration file using the XNSREG1.EXE (This file
  59.    can be renamed to INSTALL.EXE).
  60. 2. Create XNSREG system data files and indices.
  61.      2.1. Use the newly created configuration file by running the
  62.           program LOCAL.
  63.  
  64.           FOR SINGLE NODE:
  65.  
  66.           EXAMPLE: XNSREG2 XNSREG.CFG LOCAL
  67.  
  68.           NOTE: You can rename XNSREG2.EXE (MAIN PROGRAM) to XNSREG.EXE,
  69.                 and XNSREG1.EXE (INSTALLATION PROGRAM) to INSTALL.EXE.
  70.  
  71.                 IF YOU ARE RUNNING A MULTI-NODE BOARD, YOU MUST CREATE
  72.                 INDIVIDUAL CONFIGURATION FOR EACH NODE SO XNSREG CAN FIND
  73.                 YOUR DORINFO?.DEF FILE. 
  74.                 
  75.                 IE: XNSREG1.CFG, XNSREG2.CFG, XNSREG3.CFG, XNSREG4.CFG,
  76.                     XNSREG5.CFG .....ETC.
  77.           
  78.         AFTER YOU RENAMED THE XNSREG EXECUTABLE FILES, CREATE A BATCH FILE 
  79.         TO RUN XNSREG FROM A DOOR, EXAMPLE:
  80.  
  81.         FOR NODE#1 OR MULTI-NODES:
  82.  
  83.         @ECHO OFF
  84.         CHDIR \RBBS\REGISTER
  85.         XNSREG.EXE XNSREG%1.CFG 
  86.         CHDIR \RBBS\NODE%1
  87.         RBBS
  88.  
  89.         (NOTE: NO NEED TO USE WATCHDOG PROGRAM. XNSREG is written using 
  90.         Doorsource 4.0 and it takes care of monitoring your carrier.
  91.  
  92. 2.1.  Choose the SysOp Maintenance option (S).
  93.      ╔═══════════════════════════════════════════════════════════════════╗
  94.      ║            [  Display XNSREG.CFG Line #2 here please  ]           ║
  95.      ║                                                                   ║
  96.      ║                     The XNSREG Main Menu                          ║
  97.      ║                                                                   ║
  98.      ║                  [E] Edit Personal Information File               ║
  99.      ║                  [N] ReNew Registration                           ║
  100.      ║                  [R] OnLine Registration                          ║
  101.      ║                  [S] SysOp Maintenance                            ║
  102.      ║                  [I] Browse a User Information File               ║
  103.      ║                  [X] Exit to BBS                                  ║
  104.      ║                                                                   ║
  105.      ║                  Selection : [ ]                                  ║
  106.      ║                                                                   ║
  107.      ║ XBase Network Systems                              XNSREG v.3.1   ║
  108.      ╚═══════════════════════════════════════════════════════════════════╝
  109.  
  110. 2.3.  Choose the Pack XNSREG Database option (P). This option
  111.           will create and maintain both the data files and their
  112.           respective indices.
  113.      ╔═══════════════════════════════════════════════════════════════════╗
  114.      ║            [  Display XNSREG.CFG Line #2 here please  ]           ║       
  115.      ║                                                                   ║
  116.      ║                  XNSREG SysOp Maintenance                         ║
  117.      ║                                                                   ║
  118.      ║                  [P] Pack XNSREG Database                         ║
  119.      ║                  [E] Edit USERS File                              ║
  120.      ║                  [X] Exit to BBS                                  ║
  121.      ║                                                                   ║
  122.      ║                  Selection : [ ]                                  ║
  123.      ║                                                                   ║
  124.      ║ XBase Network Systems                              XNSREG v.3.1   ║
  125.      ╚═══════════════════════════════════════════════════════════════════╝
  126.  
  127.  
  128. 3. Create a PAYMENT.CAT text file using any ASCII editor.
  129.      The format of the file is :
  130.  
  131. C,Cash                 <    Note 1 
  132. O,Money Order          <    Note 1 
  133. R,Credit               <<   Note 2 
  134. V,Visa                 <<<  Note 3 
  135. M,MasterCard           <<<  Note 3 
  136. A,American Express     <<<  Note 3 
  137. D,Discover             <<<  Note 3 
  138. X,Exit Without Changes <<<< Note 4 
  139.  
  140. NOTE 1: This two options when choosen will not be updated
  141.         immediately. A utility in the SysOp Maintenance will
  142.         confirm receipt of payment.
  143. NOTE 2: This option will update the user immediately
  144. NOTE 3: This options will/can run an external program before it will be saved.
  145.         With or without the external program, the user status will be updated 
  146.         immediately.
  147.         Registered version will include, V, M, A, D selection and ask for
  148.         Credit Card Number & Expiration Date. Will create a Log file for
  149.         credit card registrats before executing "External Program to Execute".
  150.  
  151. NOTE 4: This line need not be included.
  152.  
  153.    You can set-up your PAYMENT.CAT file to accept only Cash, Money Order and 
  154.    Credit see below:
  155. C,Cash
  156. O,Money Order
  157. R,Credit
  158.  
  159. CONFIGURING YOUR XNSREG SYSTEM
  160.  
  161. 1. Execute the XNSREG1.EXE to bring up the configuration screen.
  162.  
  163. CONFIGURATION SCREEN (XNSREG.CFG) : PAGE#1:
  164.  ┌───────────────────────────────────────┬──────────────────────────────────┐
  165.  │ Drive\path\filename of DORINFOx.DEF...│ C:\RBBS\DORINFO?.DEF             │
  166.  │ BBS Name..............................│ THE HOMESHOPPER ONLINE           │
  167.  │ Sysop First Name .....................│ MAX                              │
  168.  │ Sysop Last Name ......................│ MALALUAN                         │
  169.  │ Registration Number...................│ DEMO VERSION                     │
  170.  │ Sysop Security Level .................│ 10                               │
  171.  │ Drive\Path of XNSREG..................│ C:\RBBS\ONLINE\                  │
  172.  │ Drive\Path of CFG File................│ C:\RBBS\ONLINE\                  │
  173.  │ Drive\Path of USERS File..............│ C:\RBBS\SYSTEM\                  │
  174.  │ Name of Welcome File..................│ WELCOME                          │
  175.  │ Name of Goodbye File..................│ GOODBYE                          │
  176.  │ Time delay Reg. ID....................│ 5                                │
  177.  │ Security Level to Auto-Register.......│ 1                                │
  178.  │ Security Level to allow Edit UserFile.│ 10                               │
  179.  │ Security Level to reNew Registration..│ 5                                │
  180.  │ External Program to Execute...........│ PAYMENT.EXE                      │
  181.  │ Drive\Path of External Program........│ C:\PAYNOW\                       │
  182.  │ Drive\path to return after Processing.│ C:\RBBS\                         │
  183.  │ Location of COMMAND.COM processor.....│ C:\DOS\                          │
  184.  │ XNSREG version Number.................│ v.3.1                            │
  185.  └───────────────────────────────────────┴──────────────────────────────────┘
  186.  
  187. 1. Drive\path\file of DORINFOx.DEF file  (* MUST *)
  188.      Example: C:\RBBS\DORINFO1.DEF
  189.    The x is the node number of the Door Information file. This is
  190. generated by the Bulletin Board System (RBBS). The XNSREG1.EXE will
  191. always create a configuration file named XNSREG.CFG. This file can
  192. be used immediately if you are running a single node BBS.
  193.    If you are running a multi-node BBS, rename the file XNSREG.CFG
  194. to XNSREGx.CFG when you exit to DOS. The x corresponds to the node
  195. number. Hence, the file XNSREG2.CFG is the configuration file for
  196. node 2.
  197.  
  198. 2. Name of OnLine System  
  199.      Example: THE HOMESHOPPER ONLINE
  200.    Enter any alphanumeric character for the name of your OnLine
  201. System.
  202.  
  203. 3. First Name of SysOp 
  204.      Example: MAX                     
  205.    Enter the first name of the SysOp.
  206.  
  207. 4. Last Name of SysOp
  208.      Example: MALALUAN
  209.    Enter the last name of the SysOp.
  210.  
  211. 5. XNSREG Registration Number (* MUST *)
  212.      Example: DEMO VERSION (For Unregistered user).
  213.  
  214.    If the Registration Number has the value DEMO VERSION, you are
  215. running a demonstration version of the system. You are allow 10
  216. tries for your demonstration version. Otherwise, the value entered
  217. here must be the one assigned to you.
  218.  
  219. 6. SYSOP SECURITY LEVEL  (* MUST *)
  220.      Example: 1000                    
  221.    You can enter any positive numeric values for your SysOp
  222. Security Level. 
  223.  
  224. 7. Drive\path of XNSREG.EXE  (* MUST *)
  225.      Example: C:\RBBS\ONLINE\         
  226.    You must enter the path where the XNSREG System files are
  227. located. The following files will be found in this directory:
  228.      a) XNSREG2.EXE, the main XNSREG System executable file. It can
  229.           be renamed to XNSREG.EXE if you wish.
  230.      b) XNSREG.DAT, the XNSREG user database.
  231.      c) XNSREG.QBX, the index file of XNSREG.DAT
  232.      d) XNSREG.LOG, the log file of Cash and Money Order paying
  233.           registrants.
  234.      e) XNSREGLG.QBX, the index file of XNSREG.LOG
  235.      f) WELCOME or WELCOMEG, your welcome file (optional).
  236.      g) GOODBYE or GOODBYEG, your goodbye file (optional).
  237.  
  238. 8. Drive\path of XNSREG.CFG
  239.      Example: C:\RBBS\ONLINE\         
  240.    Enter the actual location of the configuration file being read.
  241. This may vary for multi-node BBS. However, it is recommendation to
  242. place it in the Drive/path of XNSREG.EXE. Hence, the value here is
  243. the save as the one above.
  244.  
  245. 9. Drive\path of RBBS  USERS file  (* MUST *)
  246.      Example: C:\RBBS\SYSTEM\
  247.    This is the location of the RBBS users file. The actual filename MUST
  248. also be USERS.
  249.  
  250. 10. Name of XNSREG Welcome/WelcomeG file
  251.      Example: WELCOME
  252.     The default value is WELCOME. You may change them if you wish
  253. or leave this field blank if you do not wish to use any. Based on
  254. our example, the system will locate for a file named WELCOME or a
  255. file named WELCOMEG automatically. Hence, if you have an ANSI
  256. welcome screen in WELCOMEG, you MUST still specify WELCOME only.
  257.  
  258. 11. Name of XNSREG Goodbye/GoodbyeG file
  259.      Example: GOODBYE
  260.     The default value is GOODBYE. You may change them if you wish
  261. or leave this field blank if you do not wish to use any. Based on
  262. our example, the system will locate for a file named GOODBYE or a
  263. file named GOODBYEG automatically. Hence, if you have an ANSI
  264. welcome screen in GOODBYEG, you MUST still specify GOODBYE only.
  265.  
  266. 12. Time Delay Reg. ID  (* MUST *)
  267.      Example: 5  (Unregistered Version)
  268.     
  269.     Enter the number of seconds you wish to display the
  270. Registration ID Screen. The default value is 5.
  271.    
  272. 13. Security level to Auto-Register  (* MUST *)
  273.      Example: 1
  274.     The default user security level to be sent to Auto-Register is
  275. 1.
  276.  
  277. 14. Security Level to allow Edit userfile  (* MUST *)
  278.      Example: 10
  279.     The default user security level is 10. The value set here is
  280. minimum and above will allow the user to edit the UserFile.
  281.  
  282. 15. Security Level to reNew Registration  (* MUST *)
  283.      Example: 5
  284.     The default value is 5. This security level will allow the user
  285. to renew his/her registration.
  286.  
  287. 16. External program to Execute               
  288.      Example: PAYMENT.EXE             
  289.     The external program that will be defined here must be the one
  290. used to validate Credit Card numbers. If there is no external
  291. program, the field should be blank.
  292.  
  293. 17. Drive\path of External Program
  294.      Example: C:\RBBS\ONLINE\PAYNOW\  
  295.     The drive\path of the external program above.
  296.  
  297. 18. Drive\path to return after Processing
  298.      Example: C:\RBBS\                
  299.     The drive\path to return to after executing the external
  300. program above.
  301.  
  302. 19. Location of COMMAND.COM processor         
  303.      Example: C:\DOS\                 
  304.     The location (Drive/Path) of the COMMAND.COM processor.
  305.  
  306. 20. XNSREG version number                     
  307.      Example: v.3.1                   
  308.      The current XNSREG Version number is v.3.1
  309.  
  310. 21-46. Category and Security Level
  311.      Example: A,10 or B,12
  312.     Their are 26 categories that the system can assign. Each one of
  313. these categories are assigned a specific security level. The format
  314. is ?,99 wherein the question mark (?) represents the letters A to
  315. Z. Separated by a comma (,), followed by a security level.
  316.     If the category will not be used or assigned, the acceptable
  317. values are 00.
  318.  
  319. CONFIGURATION SCREEN (XNSREG.CFG) :  PAGE #2.
  320.      ┌─────────────────────────────┬──────────────────────────────┐
  321.      │ Category level A            │ A,10                         │
  322.      │ Category level B            │ B,12                         │
  323.      │ Category level C            │ C,15                         │
  324.      │ Category level D            │ D,20                         │
  325.      │ Category level E            │ E,21                         │
  326.      │ Category level F            │ F,22                         │
  327.      │ Category level G            │ G,30                         │
  328.      │ Category level H            │ H,40                         │
  329.      │ Category level I            │ I,50                         │
  330.      │ Category level J            │ J,60                         │
  331.      │ Category level K            │ K,70                         │
  332.      │ Category level L            │ L,80                         │
  333.      │ Category level M            │ M,90                         │
  334.      │ Category level N            │ 00                           │
  335.      │ Category level O            │ 00                           │
  336.      │ Category level P            │ 00                           │
  337.      │ Category level Q            │ 00                           │
  338.      │ Category level R            │ 00                           │
  339.      │ Category level S            │ 00                           │
  340.      │ Category level T            │ 00                           │
  341.      └─────────────────────────────┴──────────────────────────────┘
  342.  
  343. CONFIGURATION SCREEN (XNSREG.CFG) :  PAGE #3.
  344.      ┌─────────────────────────────┬──────────────────────────────┐
  345.      │ Category level U            │ 00                           │
  346.      │ Category level V            │ 00                           │
  347.      │ Category level W            │ 00                           │
  348.      │ Category level X            │ 00                           │
  349.      │ Category level Y            │ 00                           │
  350.      │ Category level Z            │ 00                           │
  351.      │ Port#:IRQ#                  │ COM3:IRQ5                    │
  352.      │ Port#:IRQ#                  │ COM4:IRQ5                    │
  353.      │ Port#:IRQ#                  │ COM5:IRA5                    │
  354.      │ Port#:IRQ#                  │ COM6:IRQ5                    │
  355.      │ Date of Birth               │ 1                            │
  356.      │ Social Security Number      │ 1                            │
  357.      └─────────────────────────────┴──────────────────────────────┘
  358.  
  359. 47-50. Port#:IRQ#
  360.      Example: COM3:IRQ5 or COM4:IRQ5
  361.     The system allows you to assign four (4) ports; Ports 3, 4, 5
  362. and 6 if Fossil Driver is active. If Fossil Driver is not used or
  363. any of the port is not used, the system recognizes the value 0:0.
  364.  
  365. 51. Date of Birth      
  366.      Example: 1                       
  367.     This field accepts 1 numeric value. The values must be either
  368. zero (0) and any non-zero (1). The default value is 1. Any non-zero
  369. value means that you wish the system to accept and display your
  370. birthdate.
  371.  
  372. 52. Social Security Number
  373.      Example: 1
  374.     This field accepts 1 numeric value. The values must be either
  375. zero (0) and any non-zero (1). The default value is 1. Any non-zero
  376. value means that you wish the system to accept and display your
  377. social securrity number.
  378. REGISTRATION SCREEN FORMAT
  379.  
  380.                OnLine Registration System           XNSREG v.3.1  
  381.     ╔════════════════════════════════════════════════════════════════════╗
  382.     ║                                          Current SecLevel : _____  ║
  383.     ║  Registration Date: MM-DD-YYYY  Time : ____ Hrs.                   ║
  384.     ║  FirstName : _________________        Date of Birth  : MM-DD-YYYY  ║
  385.     ║  LastName  : _________________   Social Security No. : ___-__-____ ║
  386.     ║  Mail Address : ______________________________  Age  : ___         ║
  387.     ║  2nd Line/Apt#: ______________________________                     ║
  388.     ║  City, State  : _______________ _____   ZIP Code : _____-____      ║
  389.     ║                                         Country  : ______________  ║
  390.     ║  Category Type : _                                                 ║
  391.     ║  Employer/BusinessName : ________________________________________  ║
  392.     ║                  Title : ________________________________________  ║
  393.     ║  Tel Numbers : Home (___)___-____     Work (___)___-____           ║
  394.     ║  Electronic Signature : _________________________________________  ║
  395.     ╟────────────────────────────────────────────────────────────────────╢
  396.     ║  All information must be verifiable. Illegitimate registration  is ║
  397.     ║  subject to immediate cancellation without notice. Select only the ║
  398.     ║  category that applies to your Profession or Business.  Thank you. ║
  399.     ╚════════════════════════════════════════════════════════════════════╝
  400.      [   ] Selection      [S]-Save/Exit      [E]-Edit      [D]-Delete   
  401.  
  402. All dates must be entered in MM-DD-YYYY format such as 01-28-2000. You need
  403. to inform your users from the Welcome Screen to use this format. Otherwise,
  404. they will normally say 07-28-91 for July 7, 1993. Dashes & "( )"  are 
  405. automatically attached by XNSREG.
  406.  
  407. The time is in military time (HH:MM format).
  408. Users with SysOp security are allowed to delete records. 
  409.  
  410.                         Thank you for using XNSREG
  411.  
  412.                                 End of File
  413.  
  414.  
  415.