home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / bbsdoors / chald21.arc / CHALDEAN.DOC < prev    next >
Text File  |  1989-08-22  |  17KB  |  461 lines
  1.  
  2.                              CHALDEAN VERSION 2.0
  3.                        ---------------------------------
  4.                         WRITTEN BY EDWARD J. REGGI 7/89
  5.                             UPDATE AUGUST 08-18-1989
  6.  
  7.  
  8.  
  9.         I. Introduction
  10.         ---------------
  11.  
  12.         Q:What is "Chaldean"?
  13.  
  14.         A:Chaldean is a simple program (door) that can display the
  15.           following information to the user:
  16.  
  17.             - Peronalized Daily Horoscopes
  18.  
  19.             - Special Tips
  20.  
  21.             - Historical Events
  22.  
  23.             - User Birthdays
  24.  
  25.             - Special text files
  26.  
  27.           Chaldean also can tell the sysop who exactly is online.
  28.  
  29.  
  30.         II. Package Contents
  31.         --------------------
  32.  
  33.         Well in this ZIP, ARC, ZOO, PAK, LZH there are the following
  34.         files:
  35.  
  36.                 CHALDxxx.EXE  -  Main program (Ver xxx)
  37.                 MDB     .EXE  -  UnCompile SYS databases
  38.                 UDB     .EXE  -  Compile SYS databases
  39.                 CHALDEAN.DOC  -  This file.
  40.                 UPDATE  .TXT  -  Any last second updates
  41.                 ZODIAC  .SYS  -  Default Horoscopes Database
  42.                 TIP     .SYS  -  Default Tips Database
  43.                 PAGE    .SYS  -  Sample Page control file
  44.                 TODAY   .ZIP  -  TODAY.XXX files
  45.  
  46.         III. Running
  47.         ------------
  48.  
  49.         To run CHALDEAN you first must rename the CHALDxxx.EXE :
  50.  
  51.         C>RENAME CHALDxxx.EXE CHALDEAN.EXE
  52.  
  53.         Where xxx is the version number.
  54.  
  55.         To run Chaldean at MS-DOS Type :
  56.  
  57.         C>CHALDEAN {UserName} {Access} {/[Options]}
  58.  
  59.         Where Username is the user's firstname and lastname with
  60.         an underscore in the between. (or for any Chr(32) in username)
  61.  
  62.         Example: C>CHALDEAN FRANK_LAROSA {Access} {/[Options]}
  63.  
  64.         Where Access can be any number from 0 to 999
  65.  
  66.         Example: C>CHALDEAN FRANK_LAROSA 255 {/[Options]}
  67.  
  68.         Where options can be :
  69.  
  70.                     /C  -  Clear Screen
  71.                     /V  -  Display Software title.
  72.                     /Z  -  Display Horoscope.
  73.                     /B  -  Display Birthdays.
  74.                     /H  -  Display Historical Events
  75.                     /P  -  Page Sysop system
  76.                     /W  -  Wait for Key Press
  77.  
  78.        Note : All these flags can be placed. There is NO special
  79.               order. THE LETTERs MUST BE Capitalized!
  80.  
  81.               Remember though you may use fields more than once
  82.               and in any special order you like. The order you
  83.               list them , is the order they will appear.
  84.  
  85.        *****  There is no need to run the /S parameter!  *****
  86.  
  87.  
  88.         For searchlight BBS the following would be place in an
  89.         AUTODOOR or DOORS.DEF file:
  90.  
  91.         {x};{x};{x};{x}; CHALDEAN;.;CHALDEAN %U %A /V /B /Z
  92.  
  93.         Where {x} are special numbers (Check SLBBS MANUAL}.
  94.  
  95.  
  96.         IV. Note
  97.         --------
  98.  
  99.         Please note that Chaldean creates a INDEX file called
  100.         "EX-USER.BBS". This file contains special information
  101.         on users that where not included in Franks USER.BBS file.
  102.  
  103.         Many new programs that I will make will make heavy
  104.         use of this file. If you are a progrmmer contact me for
  105.         the file format.
  106.  
  107.         There is also a ZODIAC.SYS file. This file is where all
  108.         the horoscope predictions are placed. This is a special
  109.         "SYS" database format that is used by Chaldean.
  110.  
  111.         There is also a TIP.SYS file. This file is where all the
  112.         TIPS are located. This is a "SYS" database format that is
  113.         used by Chaldean.
  114.  
  115.         Using the program UDB.EXE one can "un-compile" the ZODIAC.SYS
  116.         or the TIP.SYS files to plain ASCII files. Then they can change
  117.         it using any editor.
  118.  
  119.         Then using the program MDB.EXE one can "Make" the special
  120.         "SYS" database files.
  121.  
  122.  
  123.         THE NEW VERSION
  124.         ---------------
  125.  
  126.         The new version (2.0) need more files to operate.
  127.  
  128.         PAGE.SYS    -  This file is a plain ascii file loaded
  129.                        with special information that runs
  130.                        the page feature. Below:
  131.  
  132.         {Day};{Start};{End};{Access};{UserName};{Beep};{File};
  133.  
  134.         Where {Day} is the number of the day of the week.
  135.         (monday is 1, Sunday is 7)
  136.  
  137.         Where {Start} is the hour and minutes you want the page
  138.         to start at. (HHMM, notice NO colons)
  139.  
  140.         Where {End} is the hour and minutes you want the page to
  141.         end at. {HHMM, notice NO colons)
  142.  
  143.         Where {Access} is the users access from 0 to 999. On SL
  144.         systems the number will not go any higher that 255!
  145.  
  146.         Where {UserName} is Users first name and last name with
  147.         underscores taking the place of spaces.
  148.  
  149.         Where {Beep} is the beep patter. You can make this as big
  150.         as you like and as small as you like. Digits 1-9 are sound
  151.         pitches. Number 0 for sound off. Use a persiod "." for a
  152.         half second pause.
  153.  
  154.         Where {file} is optionial. You must place a "*" asterisk
  155.         here if you do not use this function. The file is the
  156.         path and directory of the file you might want to display
  157.         to this user (pure ascii only) In the file if you would
  158.         like to clear screen then place a [CLS], for a pause place
  159.         a [MORE] anywhere.
  160.  
  161.         NOTE : YOU must end the line with a semi-colon (;)!!!
  162.  
  163.         Examples :
  164.  
  165.         1;0800;2200;*;*;2....2....;*;
  166.  
  167.         This would page SYSOP on mondays from 8am to 10pm if ANY USER
  168.         calls with any access. The page would be two, two second beeps.
  169.  
  170.         *;*;*;255;*;9.9.9.9.9.9.9;*;
  171.  
  172.         This would page SYSOP everyday if anyone calls with access 255.
  173.         The page would be short beeps.
  174.  
  175.         *;*;*;*;ARNOLD_ARCE;1..2..3..4..5..6;C:\ARNOLD.TXT;
  176.  
  177.         This would PAGE Sysop any time and day only if the user is
  178.         ARNOLD ARCE. The page would be a increasing scale. Then
  179.         Arnold would see the file C:\ARNOLD.TXT
  180.  
  181.         You don't even have to have the system page you can use the
  182.         page control line to send a sign to all users.
  183.  
  184.         *;*;*;*;*;0;C:\SIGN.TXT;
  185.  
  186.         Notice the 0 for NO SOUND! Send all the SIGN.TXT
  187.  
  188.         You may have as many entries as you want. The asterisks always
  189.         make options "defaulted". In other words a asterisk for a
  190.         Hour would make it the current hour. A Asterisk for a username
  191.         would make it for all users. Etc... though if you dont
  192.         use the FILE TYPE feature place an asterisk there!!!!
  193.  
  194.  
  195.         Also in the new version there is the HISTORICAL events
  196.         feature. This feature needs to know where the "TODAY/PC"
  197.         type files are located. (Usually in \TODAY) So please
  198.         make a file called HISTORY.SYS with your editor. In this
  199.         file should be one line (the first) containing the
  200.         path and directory to TODAY.xxx files. Exaple...
  201.  
  202.         D:\UTILS\TODAY\
  203.  
  204.         Notice the ending backslash!!!! You must place that in!
  205.  
  206.         Today.xxx files are included in TODAY.ZIP.
  207.  
  208.  
  209.         V. SYS Database utilities
  210.         -------------------------
  211.  
  212.         To run UDB.EXE type the following in the BBS Directory
  213.         where Chaldean is located :
  214.  
  215.         C>UDB {Database} {Output filename}
  216.  
  217.         Where {DataBase} is the name of the Database file you would
  218.         like to un-comile. (usually ZODIAC.SYS or TIP.SYS)
  219.  
  220.         Where {Output filename} is the name of the file that you
  221.         want the uncompile SYS FILE(S) text to go.
  222.  
  223.         Example : C>UDB ZODIAC.SYS ZODIAC.TXT
  224.  
  225.         Now load up your favorite editor. Load up the new Text File.
  226.         You will notice that there are numbers in front of the
  227.         lines. These numbers aren't important but they are there to
  228.         let you know which Record # you are editing.
  229.  
  230.         Now each Zodiac prediction consists of A two line record,
  231.         like below :
  232.  
  233.         001 "The sun is leaving your Constellation today expect   "  [N]
  234.         001 "some bad news later on in the week. Your luck is low "  [N]
  235.  
  236.         Notice the line numbers are the same. Thats means that both
  237.         lines are ONE prediction. Also note the quotes. They are
  238.         important! Anything in the quotes are taken. Anything outside
  239.         is rejected. Any message (from first quote to last quote) can
  240.         only be 60 characters! UDB.EXE strips off the rest.
  241.  
  242.         Notice the [N]'s. Those will not be saved because they are
  243.         not in the quotes. But it makes sense to categorize the
  244.         horoscopes for ease. Most editors allow a SEARCH feature.
  245.         So those [N]'s to me represent a NEGATIVE predictions.
  246.         Later on I can edit just [N]'s or [P]'s or whatever. You can
  247.         even REM your horoscope predictions.
  248.  
  249.         ****  NOTE : PLEASE note that before you save your
  250.                      TEXT FILE. Make sure that there are no
  251.                      extra Carriage returns (CHR(12)) at the
  252.                      end of the document. Don't let the Editor
  253.                      tack on any extra lines. The last record
  254.                      SHOULD be the very last physical line!
  255.                      A trick to this is by placing your cursor
  256.                      at the end of your last record (say in the
  257.                      example above you would place the cursor
  258.                      at the end of the last "]" then press
  259.                      delete. To bring up all ending lines.
  260.  
  261.         Notice the above goes the same for the TIP.SYS file, instead
  262.         of predictions you can have,
  263.  
  264.         Sl Tips :
  265.  
  266.         001 "Just go inside your [O]ptions to make certain subs"
  267.         001 "invisible. So this way you don't have to see them!"
  268.  
  269.         Famous Quotes :
  270.  
  271.         001 "Early to bed, Early to Rise, Makes a Man "
  272.         001 "healthy, wealthy and wise.               "
  273.  
  274.         Favorite BBS :
  275.  
  276.         001 "For a good time at ulitimate Doors call :          "
  277.         001 "Stargate BBS - 201-529-0854     Tell 'em Ed sent ya"
  278.  
  279.         Jokes :
  280.  
  281.         001 "Q:What does a loney baker do? "
  282.         001 "A:French Toast!               "
  283.  
  284.         Just good ole tips :
  285.  
  286.         001 "If you save a penny today. You might have alot "
  287.         001 "more money years from now.                     "
  288.  
  289.         You can compile several types of TIP.SYS files and rotate
  290.         them around. By renaming old ones. One week have the BBS
  291.         one, the next the tips, etc..
  292.  
  293.         Next version will allow multiple TIP.SYS files.
  294.  
  295.  
  296.         SYS files can hold up to 255 possible entries. Do not
  297.         exceed that number.
  298.  
  299.         MDB.EXE is easy to run. Do the following in the BBS directory
  300.         where your text import file is located :
  301.  
  302.         C>MDB {Database} {Input filename}
  303.  
  304.         Where {Database} is the name of the SYS file that you are
  305.         going to create from the text.
  306.  
  307.         Where {Input filename} is the name of the ASCII file you
  308.         made from UDB.EXE (or from scratch). When it compiles your
  309.         ASCII file it will tell you if errors are encountered.
  310.  
  311.         Once done, your Database files have been changed.
  312.  
  313.  
  314.         VI. Future
  315.         ----------
  316.  
  317.         Let me know what more to include inside CHALDEAN. You
  318.         see I have already covered most bases (ie Beep, Clerk
  319.         Today, Wow, Thatsall, Pager, Food for thought etc)
  320.  
  321.         You can indeed run it as a logoff door if you rather
  322.         say leave the person with another tip! or zodiac horoscope
  323.         reading... or anything!
  324.  
  325.         Please let me know on what else to add...
  326.  
  327.  
  328.         VII. Software Regulations
  329.         -------------------------
  330.  
  331.         Chaldean is not PUBLIC Domain! It is Shareware. If you use
  332.         the program and like it, the please register it for $8!
  333.  
  334.         A registered user gets all free updates forever (thats a
  335.         bargin because CHALDEAN can do what 5 other programs do!
  336.         thats a savings of over $80!)
  337.  
  338.         When you mail me the money I will give you the NEAREST Phone
  339.         Number to pick up that version. Most likely you will be able
  340.         to pick it up from either Searchlight Support or Wisebyte.
  341.  
  342.         Make all Checks or Money Orders payable to :
  343.  
  344.                             Edward Joseph Reggi
  345.                             1204 Chestnut Avenue
  346.                             Brooklyn, New York 11230
  347.  
  348.     If would rather not call a BBS to pick it up then, please
  349.     add $6 dollars to cover the cost of shiping it to you.
  350.  
  351.  
  352.  
  353.         VIII. Disclaimer
  354.         ----------------
  355.  
  356.         If the original ARC/ZIP/LZH or any file within the ARC/ZIP/LZH
  357.         is altered, We do not take the responsibility of ANY TYPE OF
  358.         damage that then may occur. Even though I test each version of
  359.         CHALDEAN on various Bulletin Board systems, some newer versions
  360.         in the future may not work. I also do not take responsiblity of
  361.         any "CRASH" situations, but I doubt this will ever occur, if you
  362.         follow the above installation steps correctly.
  363.  
  364.         I also would like to say that CHALDEAN was designed and made
  365.         exclusively for SEARCHLIGHT software. If you would like it
  366.         to work for other types of Bulletins Boards Contact my BBS:
  367.  
  368.         Emerald Forest BBS : [212]-529-6032   24hours/100megs/24oobd
  369.  
  370.         Please note that even though CHALDEAN Acts as other types
  371.         of programs, it really is not the other program it is an
  372.         individual program that can do things different that the
  373.         the other programs could do. Please understand that I am in
  374.         no way trying to copy these other authors software and make
  375.         money off it. Chaldean has many features unique to itself.
  376.         As well as the original program can still do things that
  377.         Chaldean cannot do.
  378.  
  379.  
  380.         IX. Acknowledgements
  381.         --------------------
  382.  
  383.         - Turbo Pascal is a trademark of Borland International, INC.
  384.         - MS-DOS is a trademark of Microsoft Corporation.
  385.         - Searchlight BBS is a trademark of Searchlight Software.
  386.         - IBM is a trademark of [internation] Business Machines Corp.
  387.         - PKARC & PKXARC are trademarks of PKWARE Inc.
  388.         - PKZIP & PKUNZIP are tradmarks of Phil Katz' PKWARE Inc.
  389.         - LHARC is a trademark of its H. Yoshi
  390.         - Beep is a trademark of Chris Martis.
  391.         - Today/PC is a trademark of Patrick Kincaid
  392.         - Pager & PageSys are Trademarks of Kelvin Natal
  393.         - Thatsall,Wow,Food For Thought are Trademarks of their authors
  394.           repectively.
  395.  
  396.  
  397.         X. Thanks
  398.         ---------
  399.  
  400.         My Personal thanks to:
  401.  
  402.         Josh Stern, and Ian Stern (the Stern brothers!) for their
  403.         thoughts...
  404.  
  405.         and Chris Martis, because he just loves nature!
  406.  
  407.  
  408.         Other Products:
  409.  
  410.            - DAEMON SEED Ver 2.0/SLBBS
  411.              The MULTI-USER text/ANSI adventure,Action door!
  412.  
  413.            - THESPIS Ver 0.1 /SLBBS/PCBoard & Related 
  414.              **** Will be The Greatest Door in BBS history ****
  415.              **** Keep you eyes out for this DOOR, get it! ****
  416.             
  417.            - DELUXE MNEMONIC Ver 2.0 (to take line of MNEMONIC)
  418.              Not just 16 Cards try 24! Must make a Trio! Yeek!
  419.  
  420.            - MNEMONIC's Tiles Ver 1.0
  421.              A new concept in MNEMONIC Memory Games! 
  422.  
  423.  
  424.          Look for the new copy on a Bulletin board near you. Or
  425.          Contact me via my BBS above.
  426.  
  427.                   Or send mail to FIDO Address 107/605
  428.                   (Or search for "Emerald Forest" in NODELIST)
  429.  
  430.  
  431.                             Edward Joseph Reggi
  432.                             1204 Chestnut Avenue
  433.                             Brooklyn, New York 11230
  434.  
  435.  
  436.          CHALDEAN.EXE  Ver 2.0  Copyright 08/1989  Edward J. Reggi
  437.  
  438.  
  439.         Updates:
  440.  
  441.  
  442.         07/89  Ver 1.0   -  First version. (beta)
  443.  
  444.         08/89  Ver 1.1   -  Changed the ZODIAC.DAT to 60 x 2 per
  445.                             Prediction. (80 x 3 was to big)
  446.                             Added color. Added Clear Screen feature.
  447.                             Fixed other bugs.
  448.  
  449.         08/89  Ver 1.2   -  Changes the *.DAT system to the SYS
  450.                             control system. Added the history
  451.                             feature.
  452.  
  453.         08/89  Ver 1.3   -  Added the tips feature. Also fixed code.
  454.  
  455.         08/89  Ver 2.0   -  Changed complete code. Optimized. Added
  456.                             page system, and fixed old routines
  457.                             (2 hour old routines!)
  458.  
  459.     08/89  Ver 2.1   -  Fixed a "linefeed" problem that was in
  460.                             version 2.0
  461.