home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / AWRLST20.ZIP / PWRLIST.DOC < prev    next >
Encoding:
Text File  |  1996-04-15  |  15.9 KB  |  465 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                              PowerList v2.00
  11.                  ---------------------------------------
  12.                  Copyright (C) 1995-96 by Phillip Powers
  13.                            All Rights Reserved
  14.  
  15.                            Released 04/15/1996
  16.  
  17.  
  18.                        · Formerly called BBSList ·
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.   Table of contents
  29. ╘═══════════════════════════════════════════════════════════════════════
  30.  
  31.   1    Archive Contents .......................................  3
  32.   2    Introduction ...........................................  5
  33.   3    Installation/Configuration .............................  6
  34.   4    Multinode Operations ...................................  8
  35.   5    Remote SysOp Functions .................................  9
  36.   5.1  Local SysOp Functions .................................. 11
  37.   6    PROTO.EXE & Uploading Ads Info ......................... 12
  38.   7    Registration Information ............................... 16
  39.   8    Warranty ............................................... 17
  40.   9    Credits ................................................ 19
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                                  Page 3
  51.  
  52.  
  53.   1 · Archive Contents
  54. ╘═══════════════════════════════════════════════════════════════════════
  55.  
  56.   This archive (PWRLST20.ZIP) contains the following files inside it:
  57.  
  58.   PWRLIST.EXE    -  Main Executable Program
  59.   PLISTCFG.EXE   -  Configuration Program for PowerList
  60.   PLSTUTIL.EXE   -  PowerList Utilities *NEW*
  61.   PHOTO.EXE      -  Protocol Configuration Program
  62.   120to130.EXE   -  Conversion Program to upgrade v1.20 to v1.30
  63.   130to140.EXE   -  Conversion Program to upgrade v1.30 to v1.40
  64.   140to200.EXE   -  Conversion Program to upgrade v1.40 to v2.00
  65.  
  66.   PWRLIST.DOC    -  PowerList v2.00 Documentation
  67.   PLSTUTIL.DOC   -  PowerList Utilities Documentation
  68.  
  69.   FORMAT.DAT     -  File that contains the current Text List Format.
  70.   CONTROL.DAT    -  Textfile which contains cuss words for PWRList to scan
  71.   HELP.ANS       -  Online Help File (ANSi) for PowerList
  72.   HELP.ASC       -  Online Help File (ASCii) for PowerList
  73.   README.1ST     -  Notes on upgrading previous versions of BBSList
  74.   REGISTER.FRM   -  Registration Form for PowerList
  75.   WHATSNEW.200   -  What's new in version 2.00 
  76.   HISTORY.LST    -  PowerList History File
  77.   FILE_ID.DIZ    -  Description of PWRLST20.ZIP
  78.  
  79.   Files that PowerList may create (c) or optional (o) support files:
  80.  
  81.   PWRLIST.CFG    -  Configuration File (c)
  82.   PROTOCOL.CFG   -  Protocol Configuration File (c)
  83.   BBSBASE.DAT    -  PowerList BBS Database (c)
  84.   SYSOPS.CTL     -  Text List of people with SysOp abilities (o)
  85.   OKAY.DAT       -  Text List of people who can add another BBS (o)
  86.   BBSLIST.TXT    -  BBS Listing in a text form (for downloading) (c)
  87.   PWRLIST.KEY    -  Registration KEY for PowerList after registering
  88.  
  89. If you don't have the files that should have been in the original archive,
  90. make sure you have an authentic version of PowerList!
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.                                  Page 5
  98.  
  99.   2 · Introduction / Features
  100. ╘═══════════════════════════════════════════════════════════════════════
  101.  
  102.   Welcome to PowerList!  This is a product that took a lot of time and effort
  103.   to produce.  It is probably the finest BBS Lister out there!  It has some
  104.   features that none other has, like a Built In Split Screen Chat, Remote
  105.   Sysop Functions, and a unique user interface!  And it takes almost no time 
  106.   to install!
  107.  
  108.   Sure took long enough!
  109.   ~~~~~~~~~~~~~~~~~~~~~~
  110.   I apologize for the time it took to get this new version out to you, but
  111.   this should run much smoother (especially concerning COM Port stuff) than
  112.   the other versions.  I am back to programming a lot though, and support
  113.   WILL CONTINUE for this program, and I plan on opening up a support site
  114.   for all my software in the VERY NEAR future! I would also like to thank
  115.   everyone for their continued support in sending in registrations!
  116.  
  117.  
  118.  
  119.  
  120.  
  121.                                  Page 6
  122.  
  123.   3 · Installation/Configuration
  124. ╘═══════════════════════════════════════════════════════════════════════
  125.  
  126. Installation for PowerList is very simple.  First, copy all of your PowerList
  127. files to its own sub-directory.  Then run PLISTCFG.EXE to enter the info
  128. about your BBS and PowerList options.  If you want to set-up the Download
  129. option, run PROTO.EXE (See Below).  Once you've gotten that done, PowerList
  130. is installed!  
  131.  
  132.  
  133. Starting PowerList
  134. ------------------
  135.  
  136. PowerList Supports these types of drop files (definable in PLISTCFG):
  137.  
  138. DOOR.SYS
  139. DORINFO1.DEF
  140. CALLINFO.BBS
  141.  
  142. You can start PowerList in two ways:
  143.  
  144. First, you can start it with one of the drop files.
  145. Here is a common batch file to do this:
  146.  
  147. @Echo off
  148. copy door.sys c:\ra\pwrLst
  149. cd\ra\pwrlist
  150. PWRLIST.EXE
  151. exit
  152.  
  153. You can do it this way, or you can do it with a command line:
  154.  
  155. PWRLIST.EXE <First Name> <Last Name> <Security Level> <Time Left>
  156.  
  157. There is no advantage to which method you use.
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.                                  Page 8
  168.  
  169.   4 · Multinode Operations
  170. ╚═══════════════════════════════════════════════════════════════════════
  171.  
  172. PowerList has FULL MULTI-NODE SUPPORT!  This means you can load it as many
  173. times as you want without any problems!  There is no extra work; however,
  174. you MUST use dropfiles, not the command line.  All you have to do is copy
  175. the new dropfile over the existing dropfile! That's all.  PowerList has
  176. been tested with it loaded 4 times, and there were no problems at all!
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.                                  Page 9
  191.  
  192.   5 · Remote SysOp Functions
  193. ╚═══════════════════════════════════════════════════════════════════════
  194.  
  195. To go to the Remote Sysop Menu of PowerList, type ";" from the Main
  196. Screen. Your security must be equal to or higher than the Sysop Security
  197. you supplied in PLISTCFG. This will take you to another menu where you 
  198. have more options to choose from. Here is a description for each of these 
  199. options:
  200.  
  201. 1. DELETE <No> - This deleted BBS Number <no>. If you do not supply a 
  202.                  number, it will prompt you for the bbs you want to delete
  203.                  and then delete it.
  204.  
  205. 2. DELALL      - This allows you to start with a fresh BBS List. It will  
  206.                  first make sure you want to delete all the BBS, and if you
  207.                  say yes, you WILL NOT be able to get any BBS Info back!
  208.  
  209. 3. EDIT        - Allows you to Edit a BBS by <no>.  It differs from the Main
  210.                  Menu EDIT by letting you edit ANY BBS, not just one you
  211.                  entered. If you do not supply <no>, it will prompt you.
  212.  
  213. 4. VALIDATE <User> - This command puts <User> in the OKAY.DAT file. If a 
  214.                      user is found in this file, they may enter one more
  215.                      BBS to the database. (Someone with Sysop Security can
  216.                      enter as many BBS' as they want)
  217.  
  218. 5. SYSGRANT <User> - Puts <user> in the SYSOPS.CTL.  Anyone in this file has
  219.                      complete sysop access. This means they can get in the
  220.                      Sysop Menu and Enter as many BBS' as they want.
  221.  
  222. 6. BBSAD           - This will allow you to assign a file to be used as an
  223.                      ad for a BBS. It will prompt you for the BBS you want
  224.                      to assign the file to and then it will ask you for the
  225.                      file name itself.
  226.  
  227. 7. QUIT            - Takes you back to the Main Screen.   
  228.  
  229.  
  230. This menu can also be accessed through DOS by typing PWRLIST /S.
  231. This allows you to do Sysop Commands without having to logon to the BBS 
  232. or actually load the entire PowerList program.
  233.  
  234.  
  235.  
  236.                                  Page 11
  237.  
  238.  
  239.   5.1 · Local SysOp Functions
  240. ╚═══════════════════════════════════════════════════════════════════════
  241.  
  242. Here is a listing of all the Sysop Keys available to you while a user is 
  243. PowerList:
  244.  
  245. Alt-C - If the User has Ansi, it takes you into the BUILT IN SPLIT SCREEN
  246.         CHAT! If the user does not have ansi, it takes you into the line 
  247.         chat. While in chat, You can type F1 to toggle between chat modes.
  248.  
  249. Alt-D - Dumps the user back to the BBS.
  250.  
  251. Alt-J - Jumps to DOS, Type EXIT to Return to PowerList
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.                                  Page 12
  260.  
  261.   6 · PROTO.EXE & Uploading Ads Info
  262. ╚═══════════════════════════════════════════════════════════════════════
  263.  
  264. BBS Ads *NEW*
  265. ~~~~~~~~~~~~~
  266. BBSList now offers full support for BBS Ads. When someone enters a new BBS
  267. into the database, they now have an option of whether or not they want to 
  268. upload there own personalized BBS Ad. Once they have uploaded this add, 
  269. PowerList renames it to the BBS Name (or something close to it) and moves
  270. it to the Sub-Directory ADS\ (PowerList will create this directory if not 
  271. found). Someone viewing the BBS list has the option of viewing the ad either 
  272. while in the main screen of PowerList or when they are looking at detailed 
  273. information about the BBS (They can also Download the add).
  274.  
  275. Downloading
  276. ~~~~~~~~~~~
  277. PowerList has a built-in download procedure.  To use this, type "D" from the
  278. Main Menu.  If you haven't defined any protocols (See Below) this feature
  279. will be disabled.  Also make sure that you have the text list format set up.
  280. You can change this format by going into PLISTCFG and choosing Edit Text List
  281. Format. If you do not have this set up, the BBSLIST.TXT file won't be made 
  282. and you might have troubles getting the file transfer to begin.
  283.  
  284. PROTO.EXE
  285. ~~~~~~~~~
  286. There is a program in the PowerList archive called PROTO.EXE.  This is a
  287. utility for the transfer part of PowerList. Since PowerList has no internal 
  288. File Protocol support, you must define external file protocols (you can add
  289. up to 20).  To do this:
  290.  
  291. 1. Go into PROTO.EXE and go to the Number of the Protocol you want to edit.
  292. 2. Hit Enter.
  293. 3. Enter the Protocol Name.
  294. 4. Enter the Download Command Line and the Upload Command Line. PLEASE do not 
  295.    get confused as to what each command line controls. Think in terms of the
  296.    user, where the Download Command Line will be the command to SEND files to
  297.    the user, and the Upload Command Line will be the command where THEY send 
  298.    you a file. Here is a list of what each command line controls:
  299.    
  300.    Download Command Line                                 Upload Command Line
  301.    ~~~~~~~~~~~~~~~~~~~~~                                 ~~~~~~~~~~~~~~~~~~~
  302.    Used for Download BBS List Feature             Used for receiving BBS ads
  303.    Used for Download BBS Ad Feature
  304.  
  305.  
  306.  
  307.  
  308.    These can be batch files or executable files, doesn't matter.  On the
  309.    Command Line, you can use these Directives:
  310.      *P - Current Com Port
  311.      *B - Current Baud Rate
  312.      *F - File name used is different for each use of the command line:
  313.            1. When the user goes to Download the BBS List, this stands for
  314.               BBSLIST.TXT
  315.            2. When the user Uploads an ad, it stands for the file name that
  316.               they define.
  317.            3. When the user Downloads an ad, it stands for the file name that
  318.               contains the ad for the current BBS.
  319.  
  320. Examples:
  321.  
  322. These examples below assume that you have the batch files CALLUP and
  323. CALLDOWN to actually run your external protocol engine. Of course this 
  324. will be different for every BBS.
  325.  
  326. Example Download Command Line:                                
  327.  
  328.   CALLDOWN.BAT *P *B *F
  329.  
  330.   This will pass the COM port, Baud rate and BBSLIST.TXT or a BBS ad, 
  331.   depending upon why this batach file is being called, to CALLUP.BAT. This
  332.   batch file will then call the file protocol program.
  333.  
  334. Example Upload Command Line:
  335.  
  336.   CALLUP.BAT *P *B *F
  337.  
  338.   The *F parameter is VERY IMPORTANT, as PowerList will not allow the user
  339.   to View the ad if it can not find the ad file.
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.                                  Page 16
  354.  
  355.   7 · Registration Information
  356. ╘═══════════════════════════════════════════════════════════════════════
  357.  
  358.   PowerList is Shareware.  This means you can try it out for a period of 30
  359.   days.  If you like it and would like to keep using it, please send in the
  360.   small registration fee.  Registering entitles you to many things.  It
  361.   gives you the right to use it for as long as you wish and takes away the
  362.   short pauses in the program.  It also entitles you to all future versions
  363.   of PowerList for Free!  To Register, all you need to do is send a $10 check
  364.   or money order along with the registration form (Included in the PowerList
  365.   archive).  The key will be sent to you through the mail on a 3.5" floppy
  366.   disk along with the current version of PowerList.
  367.   I GUARANTEE YOU YOUR KEY WILL BE MAILED WITHIN A WEEK OF ITS ARRIVAL TO ME!
  368.   Please send all registrations to:
  369.  
  370.   Power Software
  371.   c/o Phillip Powers
  372.   2031 12th St
  373.   Vero Beach, FL 32960
  374.   
  375. ·· Note to those who have registered ··
  376.  
  377.   THANK YOU! Just keep on using your current PWRLIST.KEY file!
  378.  
  379.   Note to BBSList users: Just rename your BBSLIST.KEY to PWRLIST.KEY
  380.  
  381.  
  382.                                  Page 17
  383.  
  384.   8 · Warranty
  385. ╚═══════════════════════════════════════════════════════════════════════
  386.  
  387.  PowerList is provided as it is, without warranty of any kind or fitness.
  388.  The only guarantee is that PowerList will occupy disk space.
  389.  
  390.  PowerList is protected by applicable copyright laws and international
  391.  laws of treaty.
  392.  
  393.  In no event will Phillip Powers be held responsible to you or anyone else
  394.  for any damages or costs this software may cause, including, but not limited 
  395.  to, any lost profits, lost savings, lost income, lost information, or other 
  396.  accidental damages caused by using PowerList.
  397.  
  398.  You may freely distribute and copy PowerList provided no profit is made and
  399.  that the PowerList archive contains no modified copies of the original files
  400.  as generated by Phillip Powers.  No part of PowerList may be modified,
  401.  altered, sold or distributed in any form which would involve any sort of
  402.  profit without prior written permission from Phillip Powers.
  403.  
  404.  I cannot guarentee that newer versions of PowerList will be released.
  405.  If you have ANY suggestions that I may add, please feel free to contact me
  406.  by snail mail with the address provided in Section 7 (Registration), or
  407.  send me netmail to:  Phillip Powers at 1:374/6568 (The Concession Stand).
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.                                  Page 18
  429.  
  430.   9 · Credits
  431. ╘═══════════════════════════════════════════════════════════════════════
  432.  
  433. I would like to thank Eric Staufer for helping me with this doc file, and
  434. would also like to especially thank Gil Dupuis for his great beta testing!
  435. Also.. I would like to thank not only Eric & Gil for their suggestions, but
  436. also everyone who sent in their comments!   Without your suggestions
  437. PowerList wouldn't be here!   Thanks!
  438.  
  439.  
  440. Beta Team / Distribution List
  441. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  442.  
  443. ┌─────────────┬──────────────────────┬──────────────┬────────────┬───────────┐
  444. │Name:        │BBS Name / Location:  │Phone #:      │ FidoNet #  │ Max Baud  │
  445. ├─────────────┼──────────────────────┼──────────────┼────────────┼───────────┤
  446. │Eric Staufer │The Concession Stand  │407-569-6568  │1:374/6568  │33600bps   │
  447. │             │Vero Beach, FL USA    │              │            │           │
  448. ├─────────────┼──────────────────────┼──────────────┼────────────┼───────────┤
  449. │Gil Dupuis   │Gil's PC              │819-689-5465  │1:12/60     │33600bps   │
  450. │             │Chapeau, QC CANADA    │              │            │           │
  451. └─────────────┴──────────────────────┴──────────────┴────────────┴───────────┘
  452.  
  453. If you are interested in becoming a Beta Member for this program and other
  454. Online programs I make, include it in the Comments part of the Reg. Form.
  455.  
  456. Support
  457. ~~~~~~~
  458. For always the LATEST versions of PowerList, you can Freq the magic name
  459. "PowerList" <without the quotes> from the beta sites listed above.
  460.  
  461. If you have any questions, please contact me in the RA_UTIL echo.
  462.  
  463.  
  464.                       Thanks for Using PowerList!!
  465.