home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / LASTON59.ZIP / LASTON.DOC < prev    next >
Text File  |  1993-06-17  |  19KB  |  363 lines

  1.  
  2.                         LASTON  Version 5.9
  3.                Copyright 1991-1993 Douglas DeLonay
  4.                     SYSOP of The Home of ZIGGY
  5.                            (414)264-3220
  6.                      1200-9600 Baud V.32bis V.42
  7.  
  8.     Graphics screen design-there are now 3 user definable screens for
  9.     LASTON. They consist of 3 lines each..
  10.     in following format....
  11.  
  12.     *****name/handle**************From*******baud*****time-on***Date**
  13.     *                  *                  *        *          *      *
  14.     ******************************************************************
  15.     ^                  ^                  ^        ^          ^      ^Column 68
  16.  line 1            column 21          column 41   column 50   column60
  17.      the 3 files are named LASTON.ANI, LASTON.ASC, and LASTON.SCR..
  18.   The above would be an example of a screen design for no graphics.
  19.   The screen must be 68 colomns and 3 rows to show what you want to
  20.   surround the information about last callers..No more than 3 lines!
  21.     For the ASC and ANSI screens you should first design your ASC screen
  22.   as above.. when you got it the why you want it you can start adding the
  23.   color codes for the ANI screen.. Use a ANSI draw program such as THEDRAW
  24.   to add color to the ASC file to make it a ANSI file. Only Normal ANSI is
  25.   allowed. No animation.
  26.              make sure you have NO SPACES in the first and last lines of
  27.   the screen as that will throw your screen out of wack..
  28.                   also remember 68 colomns and the spaces between info
  29.   dividers...  look at the included sample screens to help guide you..
  30.        only 3 lines each!
  31.          If you change the files make sure you remove the old files from the
  32.   PATH!!
  33.    For easy setup use the SETUP command line parameter. This will make your
  34. .CFG files(s) for you. Easy to follow menu's and selections. Can also edit your
  35. .CFG files, and make/edit your .BAT files for you. the SETUP procedure will
  36. make your LASTON commandline from the options you pick in SETUP menu's. SETUP
  37. also lets you change the comports base address & IRQ lines for all 8 ports.
  38. Though the SETUP utility should be easy to follow that doesn't mean you
  39. shoulnd't read the DOCS for a better understanding of commands. Type from
  40. directory LASTON will be run (can be run from other directory, but that isn't
  41. the safest way)
  42.  
  43.   LASTON SETUP
  44.  
  45.  
  46.                       the PAUSE command. This command will pause
  47.   the output at the end of display for remote callers. Since the main.mnu of
  48.   RyBBS does not put a PRESS ENTER prompt at the return from a program call
  49.   this command will solve that problem. If you run from the bulletin
  50.   menu (first.bbs) you won't need this. dorinfo1.def users may find this useful
  51.   also.
  52.      LASTON PAUSE
  53.  
  54.   Also new in 5.4 is the FOSSIL and FOSSILU commands. LASTON will now use a
  55.   fossil driver if you wish. when using the fossil commands LASTON will try and
  56.   use a fossil driver if resident. If LASTON can't find and init the driver it
  57.   will attempt to use it's own internal port interrupt routines. The difference
  58.   between the 2 commands are the following.
  59.       LASTON FOSSIL       -Will leave fossil active on port when it exits
  60.       LASTON FOSSILU      -Will unload fossil on exit(deactivate port),
  61.                            and leave fossil resident
  62.  
  63.     Work on com routines for better responce on high speed modems.
  64.     also changed the multi-node commands a bit, see appropriate section,
  65.                          and/or new.doc
  66.  
  67.   Now will display node number if use multi-node BBS.
  68.  
  69.     Fix bug were MNP connections would list
  70.   as local connection. Add another commandline option LOCKEDRATE. If you have a
  71.   high speed modem and want to use the lockedrate add this to the commandline
  72.   line.
  73.  
  74.       LASTON LOCKEDRATE
  75.  
  76.        Otherwise it will use the actual connectrate. It always used the
  77.   lockedrate before if you had a high speed modem and locked the port. Another
  78.   big benifit is the ability for you to pause, stop output even if a remote
  79.   user is on. Hitting <ENTER> will now continue output also to be more like
  80.   RYBBS screen output.
  81.  
  82.      LASTON can now use the DORINFO1.DEF file!.. DORINFO1.DEf users can
  83.   disregard the LASTON.SCR (comment file, look ahead) as DORINFO1.DEF only
  84.   detects for 2 choices-ANSI or not ANSI. Only the *.ANI and *.ASC screen files
  85.   apply to DORINFO1.DEF users. Still need both LASTONCM.* files.
  86.     Some of the commands listed do not apply to dorinfo1.def users. Commands
  87.   that DO NOT apply to DORINFO1.DEF users will have a "**" next to them.
  88.  
  89.        It will build a LASTON.DAT file from the dorinfo1.def file, adding to it
  90.   untill it reaches the default 10 users for unregistered version. You'll have
  91.   to run it a few times as above before you notice the laston screen starts to
  92.   build. You will have to run it as above as a log-on program to keep an
  93.   updated callers list. You can also run it at a menu for users to view without
  94.   updating the callers log- refer to the MENU command below.
  95.  
  96.     If you don't use the DAT file and get an MOT ENOUGH USERS IN CALLERS.LOG
  97.   message you can use the LOGP/n command to increase the amount of the
  98.   callers.log the program reads. By default LASTON has n=5, which means it
  99.   reads 500 bytes for every user you list in LASTON. In the unregistered
  100.   version it starts reading 5,000 bytes from the end of the file. The default
  101.   setting should be good for most setup's. If you get the above mentioned error
  102.   try testing it at slightly higher setings till the error disappears. you
  103.   might try something like
  104.  
  105.         **         LASTON LOGP/7
  106.  
  107.     If you have very small amount of events and startup's and shutdowns you
  108.   could try decreasing the the number to increase speed, though I wouldn't
  109.   recommend lowering it. Decreasing it wouldn't increase speed that much. A
  110.   setting of LOGP/0 would read the entire file. Setting it too high will also
  111.   read the whole file, say you set n=400 and your callers.log has only 300,000
  112.   bytes in it. If you use the DAT command you don't need to worry about this.
  113.   It will read the entire CALLERS.LOG the first time to set up the LASTON.DAT
  114.   file, and after that it doesn't need the callers.log anymore.
  115.  
  116.     More versatility for LASTON!!.. The LASTON.DAT file is back, but only if
  117.   you want it!! To use the LASTON.DAT file just enter DAT on the LASTON command
  118.   line, as follows
  119.  
  120.           **       LASTON DAT
  121.  
  122.     This will cause LASTON to make a LASTON.DAT file on the first run then read
  123.   and update it thereafter. The major benifit to using the DAT file option is
  124.   speed. On my XT for the default 10 user list it cut the display time by 2-3
  125.   seconds, which is a pretty decent percentage. Of coarse the disadvantage
  126.   (to some) is that you have to run it in FIRST.BAT (log-on batch file) to
  127.   update the LASTON.DAT file.
  128.     Of coarse since the .DAT file is back the MENU command is back also. When
  129.   using the .DAT file and you want to run LASTON from a menu you must put the
  130.   command on the LASTON command line. as follows, The MENU command assumes use
  131.   of the LASTON.DAT file
  132.  
  133.              LASTON MENU
  134.  
  135.           You can add a 3 line comment to LASTON.. this is optional. To add
  136.   a comment simple write a 1 to 3 line file in exactly the form you want it to
  137.   appear. LASTON will not center, and spaces are accepted. To make an ANSI
  138.   comment simple use THEDRAW or similar program to add colors and attributes
  139.   you want. The file names are LASTONCM.SCR for the pure text or ascii file,
  140.   and LASTONCM.ANI for the ANSI comment file. To have LASTON add the comments,
  141.   just add COMMENT to the command line..  NO ANIMATION lowed in ANSI files!!
  142.  
  143.            i.e.     C:\RYBBS\LASTON COMMENT
  144.  
  145.     The Time display has the option to display in 24 hour military format,
  146.   or in the 12 hour AM/PM format. AM/PM format is on by default.to change to
  147.   24 HR format just add "24HR" to the command line. i.e.
  148.  
  149.              C:\RYBBS\LASTON 24hr
  150.  
  151.     LASTON has a screen pause option. Just add Pn to the command line to
  152.   to pause screen at end of display n seconds. i.e.
  153.            LASTON P5
  154.       will pause screen approximately 5 seconds after screen is displayed.
  155.   default is o seconds.
  156.     LASTON screen is now user abortable. NEW (P)ause, (C)ontinue, or (S)top
  157.   option to accomadate those speed demon users!... SYSOP can also pause, stop
  158.   the display for a remote user if local echo is on.
  159.  
  160.      Laston will show as many callers as memory and size of callers.log will
  161.      allow to your system in the form..(DORINFO1.DEF users doesn't use
  162.      callers.log).
  163.  
  164.           Name   * City state  * baud rate * time logged on*Date(month and day)
  165.      for multi-node version node number will be displayed before name in first
  166.      column like so
  167.  
  168.      1   Name    *City State..etc. etc.
  169.  
  170. **   LASTON will now adjust the number of users shown if callers.log doesn't have
  171.      enough users, or memory isn't sufficient to list amount of callers you specify.
  172.                Must register to change amount of callers listed.
  173.                 unRegistered form will show the last 10 callers
  174.  
  175.      The DOS command line option allows for easy run from DOS without playing
  176.   with curruser.bbs(x). Will make your LASTON.CFG file for you registered users.
  177.     unregistered users can still make one and be ready when they register. Will
  178.   give you the option to use default CURRUSER.BBS(x) or DORINFO1.DEF file..
  179.   Curruser.bbs file is whatever file from last user is. curruser.x is hard coded
  180.   in the program. It will no longer show the caller that has just logged on as
  181.   the last user on.
  182.  
  183.   A command line option in the registered and unregistered version
  184.   is the local screen off mode... put OFF in the command line to stop echo
  185.   to local screen.. will still show on local screen when you are on locally.
  186.   to turn off local echo just put in FIRST.BAT (or menu .bat file) file
  187.   like so..
  188.  
  189.  
  190.               LASTON OFF
  191.  
  192.  
  193.   Local echo is on by default..I would recomend having it off if you run
  194.   a XT since this will speed up the display to your users..
  195.      In the registered version you will need to make a .CFG file.
  196.                 If you want the options that is.
  197.      call it LASTON.CFG  < use DOS command line option to make this file.>
  198.             C:\RYBBS\CURRUSER
  199.             0
  200.             The Home of ZIGGY
  201.             yellow,
  202.             cyan,
  203.             magenta,
  204.             cyan,
  205.             white,
  206.             red,
  207.             green,
  208.             101
  209.             4 mNEW/d,5 e
  210.  
  211.  
  212.    The first line is to tell RyBBS the path and filename of door file you're
  213.    using. RyBBS SYSOP's enter just filename without extension. DORINFO1.DEF
  214.    file users enter enter filename and extension.
  215.      the second line is for your registration number which activates the rest of
  216.    the registered options.
  217.      the third line is for your BBS name. whatever you put here will replace
  218.    the <UNREGISTERED> string in the header when registered.
  219.    The fourth line is the color your BBS name will be displayed in.
  220.    the fifth line is the Name color.
  221.    the sixth line is the City,State color.
  222.    the seventh line is the baud rate color.
  223.    the eighth line is the time called color.
  224.    the ninth line is for the DATE color.
  225.    the tenth line is for the node color.
  226.    the eleventh line is maximum amount of users to list in LASTON.dat.
  227.       it shoule be one more than the maximum you want to display. Enter a
  228.       number even if you don't plan on using the LASTON.DAT file option.
  229.    the twelfth line is for choosing display options by security.. you can chose
  230.      to not have certain security level entered in the list-'e' command.
  231.      to not have the screen display to certain users-'d' command.
  232.      to have users marked as '-NEW'-'m' command.
  233.         NEW.. you can now mark as anything you want.. to mark as new just type
  234.         in NEW right after the 'm' command ending the string with a '/'.. to
  235.         mark a certain security as a subscriber you might enter 'mSUB/' as part
  236.         of the display option for the security level...make it short as the
  237.         name will get truncated to make room for the string you enter to mark
  238.         the user security with. Maximum length accepted is 10 characters.
  239.      there is a 255 character limit to the amount of security selections you
  240.      can make. it must be in the format above.. security level followed by a
  241.      space followed by display options followed by a comma if there is more
  242.      security selections. if you make no selection just enter a 0 with no
  243.      preceding characters or characters following it.
  244.  
  245.    the colors accepted are-
  246.      foreground colors -Blackf, redf, greenf, yellowf, bluef, magentaf
  247.        , cyanf, and whitef
  248.      background colors -Blackb, redb, greenb, yellowb, blueb, magentab
  249.        , cyanb, and whiteb
  250.      action commands -off, bold, reverse, blink.
  251.        off turns off all ansi attributes, bold makes colors bright, reverse is
  252.        reverse video, and blink makes text blink. Any attributes added are in
  253.        effect for selected field only. All ansi color and action commands must
  254.        be followed by a comma(,), including the last one. i.e. to make a field
  255.        blink blue you would put
  256.                 blink,bluef,
  257.           the colors must be spelled correctly as above with no extra spaces or
  258.      punctuation allowed!
  259.  
  260.              also the option to change the # of users the program shows.
  261.   as many users as your memory capacity will allow with the registered version!
  262.  
  263.     LASTON /15 OFF
  264.     MUST have the '/' before number of callers to display with no spaces.
  265.     this will list 15 callers and turn off local echo... 10 callers is on
  266.     by default. Unregistered users don't get this command line option-get
  267.     default 10 user listing.
  268.       The screen will clear on the local screen when RyBBS regains control,
  269.     but remains on the remote screen. When on locally the screen will pause
  270.     till you hit <ENTER> to give you a little time to look it over.
  271.  
  272.                           LASTON DOS
  273.  
  274.       Use the DOS parameter to run from dos .
  275.  
  276.      The program will search for these files(CURRUSER.BBS, CALLERS.LOG,
  277.     LASTON.CFG) in the currrent dir and in the path.
  278.        LASTON /35 OFF     -unregistered version leave out '/35'..
  279.     This would list the last 35 callers to the remote user and turn off local
  280.     echo...
  281.  
  282.        LASTON now has direct node support. All you need is the LASTON command
  283.     line and when run from firt.bat and menu batch file use %1NODE on the
  284.     command line! You must have %node in the menu command line to pass node
  285.     number, dorinfo1.def users refer to your docs for the correct syntax for
  286.     you to pass node number to the batch file running LASTON.
  287.        srun,5,5,  [P]revious callers,*LASTON %node       -menu for RyMULT
  288.  
  289.              LASTON %1NODE                               -batch file
  290.  
  291.        SHARE.EXE must be loaded for the Multi-node version to work. Supports
  292.     file-locking.
  293.  
  294.        In the batch file for RyMULT users only use %1NODE batch file. Must have
  295.     something listed in first line of LASTON.CFG file for LASTON to find the
  296.     correct node correctly, without it it will assume single user and abort
  297.     when a CURRUSER.BBS(x) isn't  found.. i.e.
  298.          You must use a post V6.8 RyBBS RyMult for it to work from FIRST.BAT
  299.     as 6.8 and earlier does not pass the NODE number to FIRST.BAT . For it to
  300.     work correctly from menu RyMULT users need to use V 7.51 or later. This is
  301.     more reliable than previous version of finding NODE number. make sure you
  302.     DELETE your CURRUSER.BBS if you have it laying around from a previous version
  303.     file  before converting the .bat file! or it will use the same CURRUSER.BBS
  304.     file over and over again! Node version can now be run from DOS.
  305.       NOW run's on COM's 1 - 4!!!! it uses the 'Standard' addresses for COM3 &
  306.     COM4-$3E8 & $2E8 respectively. If you use other address for COM3 & COM4 let
  307.     me know what they are and I can make a special copy with them for you-if
  308.     you register, I've put to much into this little project with very little
  309.     return..  I need money for tuition badly!!
  310.  
  311. easy command line referance section
  312.      LASTON Pn        <pause screen n seconds>
  313.      LASTON COMMENT   <will display appropriate comment file.>
  314.      LASTON OFF       <Turns off local display for faster remote display>
  315.      LASTON /n        <registered version only. Display n users>
  316.      LASTON DOS       <Use to create .CFG file when register or to run
  317.                        from dos>
  318.      LASTON 24HR      <displays time in 24 Hour military time>
  319.      LASTON DOR       <Uses the DORINFO1.DEF user file instead of CURRUSER.(x)>
  320.      LASTON %1NODE    <A must for Multi node users- Takes the correct node # in
  321.                         FIRST.BAT, and all batch files. MUST be first parameter>
  322.      LASTON PAUSE     <will pause output at end of display>
  323. **   LASTON LOCKEDRATE<Will use the locked rate instead of actual rate for high
  324.                        speed connections>
  325. **   LASTON LOGP/n    <only set if you don't use DAT command and you get a NOT
  326.                        ENOUGH USERS IN CALLERS.LOG error. n=5 by default.
  327.                        Increase from n=5 till error disappears>
  328. **   LASTON DAT       <Tells laston to make(if not present) and use the
  329.                                                          LASTON.DAT file>
  330.      LASTON MENU      <For use with DAT command when run from a menu>
  331.         All parameters are optional EXCEPT for the %1 parameter for multi-node
  332.      users. Parameters can be used together in any order.
  333.  
  334.      REGISTRATION BENIFITS are- Add your BBS name to header, get rid of the 3
  335.   lines of advertisement before list(will still display copywrite notice after
  336.   display), ability to change amount of users listed, ability to mark users as
  337.   new, paid, or whatever you want, change field colors- i.e. change color of
  338.   name, baud, etc...
  339.  
  340.        This program was written for RyBBS on a 386 AT and tested
  341.     on a XT clone... it was tested using COM ports COM1 & COM2 & COM3..
  342.          Can also use Dorinfo1.def file!!
  343.       It was also run successfully on a 486... if you test this on
  344.     anything else successfully not listed here- other machines Please let me
  345.     know!..  why not try some other programs such as
  346.             ANSED, DOORECHO, NECKTI!...... available on RYBBS homebase!(RyBBS specific)
  347.                                                (414)962-1097  9600 baud
  348.             and on EXEC-PC (414)789-4210  over 200 lines!
  349.             The Home of ZIGGY  (414)264-3220   9600 Baud
  350.  
  351.            To register for the added options send $15 to
  352.                   Douglas DeLonay
  353.                   P.O. BOX 72112
  354.                   Milwaukee, WI 53212
  355.  
  356.            along with any suggestions or comments you may have.
  357.            also indicate if you want you registration number sent
  358.            by US mail, E-MAIL on Homebase or on The Home of ZIGGY
  359.                        (414)264-3220
  360.  
  361.                  Thanks for your support!
  362.  
  363.