home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbsdoor / storex40.zip / STOREX.DOC < prev    next >
Text File  |  1992-05-31  |  20KB  |  419 lines
  1.  
  2.                                  LIVESTORE 4.0x
  3.  
  4.          One of The Livewire BBS PCBoard(TM) multi-BBS Doorware programs.
  5.                   Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS,
  6.                     Remote Access, SpitFire, WWIV and others.
  7.  
  8.                                       By
  9.                                 Richard Paquette
  10.                                    PO Box 416
  11.                               Mt. Laurel, NJ 08054
  12.  
  13.                                (C) Copyright 1992
  14.                                All Rights Reserved
  15.  
  16.                  DOOR DESCRIPTION!
  17.  
  18.     This door allows the sysop to establish a shopping center environment
  19. for his/her bbs. This door will allow up to 54 Departments when registered and
  20. only 3 while being used for evaluation purposes.
  21.  
  22.     The first screen to be seen (if exist) is a welcome screen, this MUST
  23. be called STOREX.SCR. It can be edited with most any ansi/ascii program. If
  24. you use THEDRAW, please save it with a ALT-B option at maximum 18 lines. It
  25. will display much faster and complete this way. Other programs we aren't sure
  26. about.. let us know!
  27.  
  28.     The next screen shown will be the Main Department Selection Screen, if
  29. you have more than 27 departments, there will be a prompt such as:
  30.  
  31.                  FIRST FLOOR [CR] = Second Floor Departments
  32.                   " Press ENTER to continue or E to exit "
  33.  
  34.     If they hit [CR] then the next floor will be displayed in much the
  35. same way saying:
  36.  
  37.         SECOND FLOOR [CR] = First Floor Departments
  38.     
  39.     But on this floor they will be prompted for the department they wish
  40. to visit. If a [CR] is hit, then they will be brought back to the FIRST FLOOR
  41. automatically at which time the first prompt will be shown again, if they hit
  42. E to exit, then they will be prompted for the department they wish to visit.
  43.  
  44.     If they enter a department number above your last department, they will
  45. be told "NO SUCH DEPARTMENT" and the prompt will return. If they select any
  46. department and LIVESTORE CANNOT find the display file, they will be prompted
  47.  "File not found, Please notify your Sysop!". Hopefully, they will leave you
  48. a comment so that the problem can be fixed.
  49.  
  50.     When viewing a department screen, the prompt bar will have always have
  51. the following options:
  52.  
  53.        [O]=Order  [S]=Search  [M]=Menu  [Q]=Quit to BBS  [CR]=Continue
  54.  
  55.     If the O option is selected, they will be prompted for all the info-
  56. mation we need to create an order file for you called (orders.yes) in the
  57. program directory. At almost every prompt, they have the option to [Q] the
  58. order.. this WILL NOT write and orders.yes file. They will simply be brought
  59. back to the Main Department Menu.
  60.  
  61.     If they select the S option, they will be prompted whether they would
  62. like it displayed [1]=One line at the time or [2]=Full page display. Then they
  63. are prompted for the "keyword" to search.. if none is found, they are brought
  64. back to the Main Department Menu. Of course if the "keyword" is found, it will
  65. be displayed in whichever manner they selected. (I hope)
  66.  
  67.     If they select the M option, they are brought back to the Main Menu.
  68.  
  69.     If they select the Q option, they are brought back to the BBS Menu.
  70.  
  71.     If they hit [CR] then the department file continues to display with
  72. the prompt line always there giving them all the options at any time.
  73.  
  74.     Well, that is about it for the screens. Of course if any of the files
  75. needed for display in a department aren't there.. then they will have a hard
  76. time to order anything! <GR>
  77.  
  78. IMPORTANT NOTE FOR NON STANDARD IRQ's:
  79.  
  80.                   Supports COM 1 to 4 on the standard IRQ's
  81.                     Com1/Com3 = IRQ4 and Com2/Com4 = IRQ3
  82.  
  83.                You can make use of the IRQ environment variable
  84.  
  85.     If you wish to use a non-standard IRQ, add the IRQ number after the 
  86. configuration filename. For example the program is STOREX and you want to use 
  87. Com1 and IRQ5. The command line passed to your door would be:
  88.                             STOREX STOREX.CFG /5 
  89.                                    or
  90.              STOREX STOREX.CFG /%IRQ% using the environment variable
  91.  
  92.     The /5 tells STOREX to use IRQ5 rather than the standard IRQ4 that is
  93. normally used with COM1. No /x parameter is needed for the standard IRQ's.
  94.  
  95.                                  FILES
  96.  
  97.              The following files are packaged with STOREX40.ZIP
  98.  
  99.  Storex.exe   <--- executable program (MUST BE IN DIRECTORY)
  100.  Storex.cfg   <--- sample configuration file (MUST BE IN DIRECTORY)
  101.  Storex.ndx   <--- file names for each department (MUST BE IN DIRECTORY)
  102.  Storex.doc   <--- You are reading it right now
  103.  Storex.new   <--- explains whatsnew with each version
  104.      *x.txt   <--- All the same files renamed for Samples ONLY!
  105.  Storex.scr   <--- Welcome screen that MUST be remain named STORE.SCR
  106.  Strutil.exe  <--- Utility to create txt files
  107.  Strutil.doc  <--- Docs for Strutil.exe program
  108.  Storex.log * <--- program will create and append with each visitor
  109.  Storex.ord * <--- created when an order is placed from any department
  110.                   and appended if not deleted.
  111.  
  112.                   EXPLANATION OF STOREX.CFG FILE NEEDED
  113.  
  114.     %PCBDRIVE%%PCBDIR%\USERS.SYS <-- Using environment variables for path
  115.     The Livewire BBS             <-- Your BBS Name
  116.     Richard                      <-- Your First Name
  117.     Paquette                     <-- Your Last Name
  118.     99999                        <-- Registration # (something MUST be here)
  119.     Callers Digest, Inc.         <-- Your company or BBS name displayed on Menu
  120.     YES                          <-- Allow shipping prompts (YES or NO)
  121.     YES                          <-- Accept Credit Cards (YES or NO)
  122.     VMDA                         <-- Visa, Mastercard, Discover, American Ex
  123.     NJ7                          <-- Your STATE and your STATE TAX
  124.     9                            <-- Number of Departments (SEE NOTE BELOW)
  125.     Add-On Cards                 <-- Name of department (20 character MAX)
  126.     USR Modems                   <-- Name of department 
  127.     VGA Monitors                 <-- Name of department
  128.     Artisoft Lantastic           <-- Name of department
  129.     Mother-Boards                <-- Name of department
  130.     Keyboards                    <-- Name of department
  131.     Entire Systems               <-- Name of department
  132.     Floppy Drives                <-- Name of department
  133.     Hard Drives                  <-- Name of department
  134.         
  135.     NOTE: If you are haven't registered LIVESTORE, then any number you
  136. enter here over 3 will NOT be displayed.. an UNREGISTERED version can only
  137. handle 3 departments.. so it will overlook any department names after the
  138. third one!
  139.  
  140.                    EXPLANATION OF STOREX.NDX FILE NEEDED
  141.     
  142.     EACH of these files MUST be made up by YOU.. We have no outlets for 
  143. any products whatsoever. The products and txt file to display are all your
  144. responsibility. PLEASE do not call us for products or text files.. we have
  145. none.. the text files shown in our copy of STOREX on The Livewire BBS are for
  146. display sample ONLY!
  147.  
  148.     systemsx.txt   <-- sample random file created with strutil.exe
  149.     monix.txt      <-- sample also
  150.     modemx.txt     <-- sample also
  151.     
  152.            NOTE: these files MUST BE in the same directory
  153.                  that the door is being run from, for example:
  154.                  if you have c:\pcb\storex then all go in storex dir.
  155.  
  156.  
  157.     If you have any other suggestions to improve this program and/or have
  158. problems, please call us at THE LIVEWIRE BBS (number at bottom) and leave us
  159. a C)omment explaining in detail what happened, leave us a voice number and we
  160. will be glad to call you back to help with the setup and/or fix the problem.
  161.  
  162.     The following are examples for the first FOUR lines only, you must
  163. read the above for the proper configuration file after the top FOUR lines!
  164.  
  165.         EXAMPLE CONFIGURATION FILE FOR NEW WILDCAT 3.0
  166.         ------------------------------------------
  167.  
  168.         C:\CAT\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  169.         The Livewire BBS    <=-  (Change this to your BBS name)
  170.         Richard             <=-  (The Sysop's first name)
  171.         Paquette            <=-  (The Sysop's last name)
  172.  
  173.         EXAMPLE CONFIGURATION FILE FOR DOOR.SYS
  174.         ---------------------------------------
  175.  
  176.         C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  177.         The Livewire BBS    <=-  (Change this to your BBS name)
  178.         Richard             <=-  (The Sysop's first name)
  179.         Paquette            <=-  (The Sysop's last name)
  180.  
  181.         EXAMPLE CONFIGURATION FILE FOR CALLINFO.BBS
  182.         -------------------------------------------
  183.  
  184.         C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  185.         The Livewire BBS    <=-  (Change this to your BBS name)
  186.         Richard             <=-  (The Sysop's first name)
  187.         Paquette            <=-  (The Sysop's last name)
  188.  
  189.         EXAMPLE CONFIGURATION FILE FOR DORINFOx.DEF
  190.         -------------------------------------------
  191.  
  192.         C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  193.                                   where 'x' is the BBS Node number.
  194.         The Livewire BBS    <=-  (Change this to your BBS name)
  195.         Richard             <=-  (The Sysop's first name)
  196.         Paquette            <=-  (The Sysop's last name)
  197.  
  198.         EXAMPLE CONFIGURATION FILE FOR SFDOORS.DAT
  199.         ------------------------------------------
  200.  
  201.         C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  202.         The Livewire BBS    <=-  (Change this to your BBS name)
  203.         Richard             <=-  (The Sysop's first name)
  204.         Paquette            <=-  (The Sysop's last name)
  205.  
  206.         EXAMPLE CONFIGURATION FILE FOR CHAIN.TXT
  207.         ----------------------------------------
  208.  
  209.         C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  210.         The Livewire BBS    <=-  (Change this to your BBS name)
  211.         Richard             <=-  (The Sysop's first name)
  212.         Paquette            <=-  (The Sysop's last name)
  213.  
  214.                                  ==============
  215.  
  216.                                 STOREX BATCH FILE
  217.  
  218. This is the batch file whose name is entered in your SETUP. It should reside in
  219. your default directory. Leave this as is except for changing the paths.
  220.  
  221.   @ECHO OFF          <-- optional
  222.   E:\                <-- start batch at root directory of door directory
  223.   CD\STOREX          <-- change to door directory
  224.   SET PCBDRIVE = C:  <-- for NON PCBoard BBS's where your system dir is
  225.   SET PCBDIR = \BBS  <-- for NON PCBoard BBS's where your system files are
  226.   STOREX STOREX.CFG  <-- Please read NOTE below
  227.   SET PCBDRIVE =     <-- Set variable to NULL
  228.   SET PCBDIR =       <-- Set variable to NULL
  229.   C:\                <-- return to root
  230.   CD\BBS             <-- change to your bbs dir
  231.   BOARD              <-- run bbs file
  232.  
  233.   NOTE: By using the environment variables you need ONLY ONE CFG for each
  234.         node and saves from editing many CFG files. Our STRUTIL.EXE program
  235.         will default to editing the STOREX.CFG file anyway.. so you would
  236.         then need to rename each if you wanted to use many CFG files. We
  237.         strongly suggest using environment variables to ease operation.
  238.  
  239.   NOTE: STOREX requires the presence of BRT71EFR.EXE either in the
  240.         same directory as STOREX or accessible via PATH. If you set
  241.         your library in autoexec.bat and all the brun files there,
  242.         then you have no problems.. 
  243.  
  244.         SET MYLIB = C:\MYLIB
  245.  
  246.         Be sure to put all your brun*.exe files in the mylib directory!
  247.  
  248.         NOTE: There is NO need for seperate configuration files for each
  249.               node.. you can use the same STOREX.CFG for each node batch
  250.               file. If you have problems, please notify us as soon as you
  251.               can with copies of your batch file and config file.
  252.  
  253.                      ------------------------------------
  254.  
  255.                                 DOOR OPERATION
  256.                                 --------------
  257.   
  258.   F3    -   Toggles the printer On/Off.
  259.             Value is passed to PCBoard.
  260.   F4    -   Toggles the Page Bell On/Off.
  261.             Value is passed to PCBoard.
  262.   F5    -   DOS Shell.  Allows SysOp to exit to DOS from inside a DOOR.
  263.   F7    -   Toggles the Caller Alarm On/Off.
  264.             Value is passed to PCBoard.
  265.   F8    -   Returns the caller involuntarily to PCBoard.
  266.             Without letting them know that the sysop called them back!
  267.   F9    -   Toggles the local display On/Off.
  268.             Value is passed to PCBoard.
  269.   F10   -   Activates SysOp CHAT mode within the DOOR.
  270.  
  271.   ESC   -   Deactivates CHAT mode.  DOOR is resumed.
  272.   HOME  -   HELP key for status line options.
  273.   UP    -   Allows the SysOp to temporarily give the caller extra time
  274.             while in the DOOR.  This time is NOT passed to PCBoard.
  275.   DN    -   Allows the SysOp to temporarily subtract time from the
  276.             caller while in the DOOR.  This time is NOT passed to PCBoard.
  277.   ALT-N -   SysOp next on toggle.
  278.             Value is passed to PCBoard.
  279.   ALT-X -   PCBoard will exit after current caller logs off.
  280.             Value is passed to PCBoard.
  281.  
  282.                             WATCHDOG/CTTY/ANSI.SYS
  283.                             ----------------------
  284.  
  285.         CTTY and WATCHDOG are not required and should not be used with
  286.         this program.  STOREX contains its own communication routines
  287.         which monitor the COM port.  If carrier is lost, it will return
  288.         to the BBS where the BBS will log the user off the system.
  289.  
  290.         ANSI.SYS or something similar, is required for STOREX to function.
  291.  
  292.                                  DISTRIBUTION
  293.                                  ------------
  294.  
  295.         STOREX is COPYRIGHTED by Richard Paquette, with all rights reserved.
  296.         This program is being distributed via the SHAREWARE concept and as
  297.         such, may be copied freely with the following restrictions:
  298.  
  299.                 * The program must be supplied in it's original
  300.                   unmodified form, including documentation.
  301.  
  302.                 * STOREX may not be distributed as part of any
  303.                   commercial application or service without the
  304.                   express, written consent of the author.
  305.  
  306.                 * Vendors of Shareware/Public Domain software may
  307.                   not distribute this program without the express,
  308.                   written consent of the author.
  309.  
  310.                                  REGISTRATION
  311.                                  ------------
  312.  
  313.         STOREX represents many hours of programming and the author
  314.         deserves just compensation for his time, efforts and expertise.
  315.         If you find this program to be of some value and you continue
  316.         to use it on your BBS system, you must return the registration
  317.         form provided along with the registration fee. Registration
  318.         entitles you to free upgrades via modem from The Livewire's Support
  319.  
  320.            **********           REGISTER ONLINE          ***********
  321.  
  322.         You may also call The Livewire BBS and register online via
  323.         Visa or Mastercard using our online Credit Card door which will 
  324.         produce your registration number on the spot! At the main board
  325.         prompt just type  REGISTER  and presto.. 
  326.  
  327.         Suggestions and/or comments may be sent to the address below or
  328.         via electronic mail: 
  329.  
  330.         The executable has been compressed using PKLite and if you have
  331.         any problems.. please call The Livewire BBS and download an exe
  332.         that hasn't been compressed with PKLite.. We have NOT had any
  333.         problems but wanted to notify you the exe is available in its
  334.         raw state! <GR>
  335.  
  336.                   HUBSNJ for RelayNet and Node ID is: LIVEWIRE
  337.                   HUBNJ  for Intellec and Node ID is: LIVEWIRE
  338.                   HUBNJ  for AfterDrk and Node ID is: LIVEWIRE
  339.                   HUBNJ  for SmartNet and Node ID is: LIVEWIRE
  340.                          ILink with Node ID of LIVEWIRE
  341.                        FidoNet Address:  1/266:36@fidoorg
  342.                                 Richard Paquette
  343.                                 The Livewire BBS     
  344.  
  345.           Public Access Node1: (609) 235-5297 MNP/5 - 300/1200/2400
  346.           Access to all other Nodes after registering a door program
  347.                             ----------------------
  348.  
  349.          L I V E W I R E   D O O R   R E G I S T R A T I O N   F O R M 
  350.  
  351.  
  352.       TO:    The Livewire BBS                            Date___/___/___ 
  353.              P.O. Box 416  
  354.              Mt. Laurel, NJ 08054
  355.  
  356.  
  357.             (Please use capitalization and punctuation where necessary.)
  358.  
  359.  
  360.       FROM:  SysOp Name: _______________________________________________ 
  361.  
  362.              BBS Name: _________________________________________________
  363.  
  364.              Address: __________________________________________________ 
  365.  
  366.              City: ______________________ State: __________ ZIP: _______ 
  367.  
  368.              Voice: (   ) _________________ BBS: (   ) _________________
  369.  
  370.              BBS Software: _____________________ BBS Hours: ____________
  371.  
  372.              Baud Rates:________________________                 (01-15)
  373.  
  374.  
  375.       SOFTWARE                          VERSION                   PRICE 
  376.       --------                          -------                   -----
  377.  
  378.       Storex ............................ 4.0 ................. $ 35.00 __
  379.       Store ............................. 3.9 ................. $ 35.00 __
  380.       CD-Sub ............................ 3.7 ................. $ 30.00 __
  381.       Facts ............................. 2.4 ................. $ 20.00 __
  382.       WordPlay .......................... 1.6 ................. $ 20.00 __
  383.       Races ............................. 2.1 ................. $ 20.00 __
  384.       Lottery ........................... 3.8 ................. $ 20.00 __
  385.       Feud .............................. 1.3 ................. $ 20.00 __
  386.       Trek Trivia Online ................ 2.0 ................. $ 30.00 __
  387.       Choice ............................ 2.0 ................. $ 20.00 __
  388.       SexQuiz ........................... 1.8 ................. $ 35.00 __
  389.       Name that Tune .................... 1.9 ................. $ 30.00 __
  390.       TV Trivia ......................... 1.5 ................. $ 30.00 __
  391.       BBS Callers Digest Online! ..............................   Call  __
  392.   
  393.       All of the above ........................................ $225.00 __
  394.  
  395.       (NJ residents add 7% tax)                                   _____
  396.  
  397.       (Foreign orders add $10.00 for shipping)                    _____
  398.  
  399.       Total                                                     $ _____ 
  400.  
  401.  
  402.                                 F E E D B A C K 
  403.                                 ---------------
  404.  
  405.       I learned of STOREX from:
  406.  
  407.                 [  ] - A Friend         [  ] - Computer Club
  408.                 [  ] - BBS              [  ] - Compuserve
  409.                 [  ] - GEnie            [  ] - Other 
  410.  
  411.       COMMENTS: _____________________________________________________ 
  412.       _______________________________________________________________ 
  413.       _______________________________________________________________ 
  414.       _______________________________________________________________ 
  415.       _______________________________________________________________ 
  416.       _______________________________________________________________ 
  417.       _______________________________________________________________ 
  418.       _______________________________________________________________ 
  419.