home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / olz_13.zip / OLZ.BAK < prev    next >
Text File  |  1993-02-08  |  15KB  |  328 lines
  1.  
  2.         ┌────────────────────────────────┐
  3.         │ AvernusWare Proudly Presents   │
  4.         │                                │
  5.         │       OneLinerZ! v1.3          │
  6.         │ Programmed by Dennis Alexander │
  7.         │       Copyright 1993           │
  8.         └────────────────────────────────┘
  9.  
  10.         Introduction
  11.         ────────────
  12.  
  13.                 Hello and welcome to OneLinerZ!  This program was
  14.         written, and should work for the following BBS programs:
  15.         Renegade, T.A.G., and Telegard.  The program works best on
  16.         Renegade and Telegard, but should work on T.A.G. as well.
  17.         What is this program?  OneLinerZ! is a program based on a
  18.         "rumors" program I have seen for other BBS softwares such
  19.         as Celerity.  The program allows users to enter one line
  20.         of ANSI, AVATAR or ASCII text, usually the oneliners are
  21.         something like this: "Press ALT-H for SysOp access!!", or
  22.         often they are used to advertise bulletin boards, "Call
  23.         AVERNUS at 313.427.0224!", etc.  If you have any problems
  24.         with the program, bugs to report, or suggestions, please
  25.         let me know at the above BBS if possible.
  26.  
  27.  
  28.         Disclaimer
  29.         ──────────
  30.  
  31.                 This program contains NO guarantees or warrantees.
  32.         Use it at your own risk.  I HIGHLY doubt, however, that it
  33.         can do ANY damage whatsoever to your computer or BBS, so
  34.         you shouldn't worry.  This program doesn't touch ANY of
  35.         your BBSs data files.
  36.  
  37.  
  38.         Registration
  39.         ────────────
  40.  
  41.                 HA!  This program is FreeWare.  By using this
  42.         program it is payment enough for me.  I also do not
  43.         believe in charging for little BBS utilities.  Support the
  44.         Hacker Ethic and FREE INFORMATION.  (I'm talking about
  45.         TRUE Hackers, get the book Hackers if you don't know what
  46.         I am talking about.)
  47.  
  48.  
  49.         Packing List
  50.         ────────────
  51.  
  52.         The archive OLZ-13.ZIP should contain the following:
  53.  
  54.         OLZ.EXE      ■ The main program.
  55.         OLZ.DOC      ■ This file; manual for use.
  56.         OLZ.MNU      ■ An example Renegade and Telegard menu file
  57.         OLZSETUP.EXE ■ To INSTALL and EDIT OneLinerZ!
  58.         OLZRAND.EXE  ■ Used to randomize OneLiners.
  59.         PACKER.EXE   ■ Used to weed out deleted records.
  60.         AUTODEL.EXE  ■ Used to weed out OneLiners x number of days old.
  61.         AVERNUS.EXE  ■ My shameless BBS ad.
  62.         CONVERT.EXE  ■ Used in converting older versions of OneLinerZ!
  63.         BATCH.ZIP    ■ Archived example batch files.
  64.         UPGRADE.DOC  ■ Upgrade information and history.
  65.         README.1ST   ■ A disclaimer to UNARCHIVE BATCH.ZIP to your BBS dir.
  66.  
  67.         Installation (For Renegade and Telegard systems)
  68.         ────────────────────────────────────────────────
  69.  
  70.         Note: This documentation assumes you know something about your
  71.               respective BBS software.  I cannot provide a key press by
  72.               key press tutorial on how to set this up, use your own
  73.               common sense!
  74.  
  75.         Preliminary Info
  76.         ────────────────
  77.         The example batch files assume the program is in C:\1LINERS.
  78.         The example batch files assume your BBS is in C:\BBS.
  79.         The example batch files assume text files are stored in C:\BBS\AFILES.
  80.         The example batch files assume you use "SHOW" and "SHOWTEN" as file
  81.             prefixes when running OLZRAND.
  82.  
  83.         1) Copy all files to their own directory, ie. C:\1LINERS.
  84.         2) Run OLZSETUP.EXE and configure the door file and the
  85.            configuration sections.  It is fairly well documented, so
  86.            I needn't go in to detail here.
  87.         3) Unarchive the file BATCH.ZIP to your BBS directory, then
  88.            edit the batch files to work on your system.  All batch
  89.            files begin with the three characters "ONE".  You should
  90.            have the following batch files (after you unarchive
  91.            BATCH.ZIP!) :
  92.  
  93.                 ONEADD.BAT   ■ This is run to add a OneLiner.
  94.                 ONEALL.BAT   ■ This is run to list ALL OneLiners.
  95.                 ONEASC.BAT   ■ Used to rotate ten (.ASC/.MSG) files.
  96.                 ONEAVT.BAT   ■ Used to rotate ten (.AVT) files.
  97.                 ONECHANG.BAT ■ This is used to change graphics modes.
  98.                 ONEDEL.BAT   ■ This is run to delete a OneLiner.
  99.                 ONEDELU.BAT  ■ This is used to delete a user from USERFILE.DAT
  100.                 ONEEDIT.BAT  ■ This is run to edit a OneLiner.
  101.                 ONELIST.BAT  ■ This is run to list one OneLiner.
  102.                 ONENEW.BAT   ■ This is used to do a newscan of OneLiners.
  103.                 ONEPACK.BAT  ■ This weeds out deleted OneLiners.  Put
  104.                                this in your night event.
  105.                 ONEPOINT.BAT ■ This is used to change pointer dates.
  106.                 ONERAND.BAT  ■ This is run to randomize to one file.
  107.                 ONESRCH.BAT  ■ This is used to do a "text" search.
  108.                 ONETEN.BAT   ■ This is run to randomize to ten files.
  109.                                You could run this everytime a user logs
  110.                                off, or in a night event.
  111.  
  112.         4) Copy the OLZ.MNU file to your menus directory and edit it
  113.            to work on your system.
  114.         5) Add the following commands to your main menu:
  115.  
  116.            1. Long Descript : (/O)neLinerZ! - Go to the OneLinerZ! menu
  117.            2. Short Descript: (/O)neLinerZ!
  118.            3. Menu Keys     : /O
  119.            4. ACS Required  : ""
  120.            5. CmdKeys       : -/
  121.            6. Options       : OLZ
  122.  
  123.         Renegade commands:
  124.         ──────────────────
  125.  
  126.            1. Long Descript : <this should be set to NULL>
  127.            2. Short Descript: <this should be set to NULL>
  128.            3. Menu Keys     : FIRSTCMD
  129.            4. ACS Required  : "!EV!EN"
  130.            5. CmdKeys       : -F
  131.            6. Options       : SHOWTEN
  132.  
  133.            1. Long Descript : <this should be set to NULL>
  134.            2. Short Descript: <this should be set to NULL>
  135.            3. Menu Keys     : FIRSTCMD
  136.            4. ACS Required  : "EV"
  137.            5. CmdKeys       : D-
  138.            6. Options       : oneavt.bat
  139.  
  140.            1. Long Descript : <this should be set to NULL>
  141.            2. Short Descript: <this should be set to NULL>
  142.            3. Menu Keys     : FIRSTCMD
  143.            4. ACS Required  : "EV"
  144.            5. CmdKeys       : -F
  145.            6. Options       : SHOWTEN.AVT
  146.  
  147.            1. Long Descript : <this should be set to NULL>
  148.            2. Short Descript: <this should be set to NULL>
  149.            3. Menu Keys     : FIRSTCMD
  150.            4. ACS Required  : "EN"
  151.            5. CmdKeys       : D-
  152.            6. Options       : oneasc.bat
  153.  
  154.            1. Long Descript : <this should be set to NULL>
  155.            2. Short Descript: <this should be set to NULL>
  156.            3. Menu Keys     : FIRSTCMD
  157.            4. ACS Required  : "EN"
  158.            5. CmdKeys       : -F
  159.            6. Options       : SHOWTEN.ASC
  160.  
  161.         Telegard commands:
  162.         ──────────────────
  163.  
  164.            1. Long Descript : <this should be set to NULL>
  165.            2. Short Descript: <this should be set to NULL>
  166.            3. Menu Keys     : FIRSTCMD
  167.            4. ACS Required  : "XA"
  168.            5. CmdKeys       : -F
  169.            6. Options       : SHOWTEN
  170.  
  171.            1. Long Descript : <this should be set to NULL>
  172.            2. Short Descript: <this should be set to NULL>
  173.            3. Menu Keys     : FIRSTCMD
  174.            4. ACS Required  : "XV"
  175.            5. CmdKeys       : D-
  176.            6. Options       : oneavt.bat
  177.  
  178.            1. Long Descript : <this should be set to NULL>
  179.            2. Short Descript: <this should be set to NULL>
  180.            3. Menu Keys     : FIRSTCMD
  181.            4. ACS Required  : "XV"
  182.            5. CmdKeys       : -F
  183.            6. Options       : SHOWTEN.AVT
  184.  
  185.            1. Long Descript : <this should be set to NULL>
  186.            2. Short Descript: <this should be set to NULL>
  187.            3. Menu Keys     : FIRSTCMD
  188.            4. ACS Required  : "!XV!XA"
  189.            5. CmdKeys       : D-
  190.            6. Options       : oneasc.bat
  191.  
  192.            1. Long Descript : <this should be set to NULL>
  193.            2. Short Descript: <this should be set to NULL>
  194.            3. Menu Keys     : FIRSTCMD
  195.            4. ACS Required  : "!XV!XA"
  196.            5. CmdKeys       : -F
  197.            6. Options       : SHOWTEN.ASC
  198.  
  199.  
  200.         Notice: You may add the above commands to any of the other menus
  201.                 where you want OneLinerZ! to randomly appear.
  202.  
  203.  
  204.         The above is a SUGGESTED setup for use with Renegade or Telegard.
  205.         The great thing about OneLinerZ! is that it is very flexible and
  206.         configurable due to it's "modular" nature (separate command line
  207.         parameters for separate functions, as opposed to a door with all
  208.         commands in a menu within in the door.)  If you want to
  209.         experiment with different setups, see the documentation below on
  210.         command line parameters.
  211.  
  212.  
  213.         Command Line Parameters for OLZ.EXE
  214.         ───────────────────────────────────
  215.  
  216.                 The format for using parameters with OLZ.EXE is as
  217.         follows: OLZ /R# -xx, where # is your node number, and "xx" is
  218.         one of the following parameters:
  219.  
  220.                -A  ■ Add a OneLiner.
  221.                -AL ■ List all OneLiners.
  222.                -C  ■ Change graphics mode.
  223.                -D  ■ Delete a OneLiner.  The SysOp can delete ANYONE's
  224.                      OneLiner.
  225.                -DU ■ Delete a user from USERFILE.DAT, the ACS for this
  226.                      command should be s255 or u1 for SysOp use only.
  227.                -E  ■ Edit a OneLiner.  The SysOp can edit ANYONE's
  228.                      OneLiner.
  229.                -L  ■ List one OneLiner.
  230.                -N  ■ Newscan the OneLiner data file.
  231.                -P  ■ Change pointer date.
  232.                -T  ■ Do a "text search" of the OneLiner data file.
  233.  
  234.                 Make sure that your DORINFO#.DEF file corresponds with
  235.         the node parameter that is passed to OLZ.EXE.
  236.  
  237.  
  238.         Command Line Parameters for OLZRAND.EXE
  239.         ───────────────────────────────────────
  240.  
  241.                 OLZRAND is used to randomize a OneLiner either to one
  242.         file, or to ten.  Let me first explain what randomizing to ten
  243.         means.  In the example setup, (Installation section), I suggest
  244.         adding a command to the main menu that will display the file
  245.         name "SHOWTEN".  This is why, OLZRAND will make ten files, such
  246.         as: SHOWTEN.ANS, SHOWTEN.AN1, SHOWTEN.AN2, etc, until "AN9".  If
  247.         you are a veteran SysOp with Renegade or Telegard, then you know
  248.         that if you tell the BBS to list a file with just the extension
  249.         it will randomly pick one of the ten.  "Why is this usefull?"
  250.         Well, there is a parameter that allows you to randomize ONE
  251.         OneLiner, but if you were to do this everytime at the main menu,
  252.         it would be SLOW.  Whereas, with the "randomize ten" option, and
  253.         with ANSI, you can have the BBS run the batch file ONETEN.BAT to
  254.         randomize ten everytime the user logs off, so they don't have to
  255.         deal with waiting at the main menu.  Other batch files are pro-
  256.         vided for AVATAR and ASCII users, that will rotate between ten
  257.         (.ASC/.MSG) or (.AVT) files.  You are most likely confused, I
  258.         am sorry.  The best thing to do is to just use the examples.
  259.  
  260.  
  261.                 Finally, the format for using parameters with
  262.         OLZRAND.EXE is as follows: OLZRAND +C/-C +O/-O [type] [filename]
  263.  
  264.         +C will add a carriage return after the OneLiner, -C won't.
  265.         +O will add the "OneLiner By" string, -O won't.
  266.  
  267.         [type] is one of the following commands:
  268.  
  269.                 -S ■ Randomize one OneLiner to one file.  (Actually, it
  270.                     will create three files, ie: SHOW.ANS, SHOW.MSG and
  271.                     SHOW.AVT)
  272.                 -R ■ Randomize ten OneLiners to ten separate files. See
  273.                     explanation above.
  274.  
  275.         [filename] is the **PREFIX** of the file you want to create.
  276.  
  277.         Note: Randomizing is slow because it creates ANSI, AVATAR and
  278.               ASCII files every time it is run, that is why it is best
  279.               to follow my example in the Install section of this DOC.
  280.  
  281.         Information on PACKER.EXE
  282.         ─────────────────────────
  283.  
  284.                 This should be run in a night event.  What this program
  285.         does is "weed out" deleted OneLiners.  "If they are deleted, why
  286.         do they need to be "re-deleted"?  Well, when you delete a
  287.         OneLiner, it is not physically removed from the file.  But, if
  288.         you were to add another OneLiner, it would over-write the
  289.         deleted one.  PACKER removes records PHYSICALLY ... so if you get
  290.         too many deleted records, and they are getting annoying, you can
  291.         just run this to get rid of them.
  292.  
  293.         Information on AUTODEL.EXE
  294.         ──────────────────────────
  295.  
  296.                 This program accepts ONE parameter, and that is the number
  297.         of days to check for.  Example: "AUTODEL 30" would delete all
  298.         OneLiners that are 30 or more days old.
  299.  
  300.         T.A.G. Users
  301.         ────────────
  302.  
  303.                 I *KNOW* that OneLinerZ! can be set up on TAG, but I am
  304.         simply not very familiar with the software.  I'm sure it's only a
  305.         matter of studying the RG/TG example menu, or reading about the
  306.         parameters.  I know of two BBSs local to me that have set it up on
  307.         TAG, but they don't have the time for DOC writing, sooooo... I'm
  308.         sorry!  It can be done, if you are an experienced SysOp.
  309.  
  310.  
  311.         In Conclusion
  312.         ─────────────
  313.  
  314.                 Thank you for using this program, I appreciate it greatly.
  315.         If you are having any problems setting up your copy of OneLinerZ!
  316.         then please feel free to call my BBS, AVERNUS, at 313.427.0224.
  317.         I will be happy to help you set it up, and to take suggestions for
  318.         improvements.  I can also be reached on ITCNet, in the Renegade
  319.         echo, or the utility echo.  Call my board for future versions and
  320.         future AvernusWare programs.
  321.  
  322.                 I would also like to thank Wish Giver, of The Three Wishes
  323.         BBS (313.522.2865), for helping me beta test this program.
  324.         I would also like to thank The Archon and Vangard.
  325.  
  326.         Dennis Alexander - aka LANKHMAR
  327.  
  328.