home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / comms / bbs / chatav07.lha / ChatAvail.doc < prev    next >
Encoding:
Text File  |  1991-06-28  |  5.6 KB  |  196 lines
  1.  
  2.           *****  *              *    ****                  *  *
  3.          *       * **    ***   ***  *    *  *   *   ***       *
  4.          *       **  *  *   *   *   ******  *   *  *   *   *  *
  5.          *       *   *  *   *   *   *    *  *   *  *   *   *  *
  6.           *****  *   *   *** *  **  *    *   ***    *** *  *  **
  7.  
  8.                                   Vers.0.7
  9.  
  10.                              (c) by Rafael Metz
  11.  
  12.                             All rights reserved.
  13.  
  14.                              release 27.6.1991
  15.  
  16.                     This program is fully Public Domain
  17.  
  18.  
  19.  Introduction
  20.  
  21.  I wrote this little utility to let a user know if his sysop is
  22.  available for a chat or not. It`s my first utility for DLG Prf.
  23.  the really best mailboxprogram on the Amiga :-).
  24.  I`d like to write some more utilities for DLG so if have you any
  25.  ideas please send me a mail. I hope you like this program...
  26.  
  27.  
  28.  Installation
  29.  
  30.  ChatAvail is easy to install. The program itself could be installed
  31.  everywhere on your harddisk. The configuration file which should
  32.  be named "ChatAvail.cfg" should be placed in the DLGConfig:Misc/ di-
  33.  rectory. I think it`s useful to start the program in the "Login.batch"
  34.  so the user is informed just in the beginning of his logon...
  35.  This is a example configuration file:
  36.  
  37.  ; *** ChatAvail sample config ***
  38.  ;
  39.  ; Sysop available times...
  40.  ; each number is a hour of the day
  41.  ; 0 = not available
  42.  ; 1 = available
  43.  ; make sure that you have 24 numbers... :-)
  44.  ; GERMAN : 0 Uhr bis 23 Uhr
  45.  ; ENGLISH: 12pm (1st number),1am to 12am (2nd to 12th number) and
  46.  ;          1pm to 11pm (13th to 23rd number)...pooh :-)
  47.  
  48.  #AVAIL 010000011100001001100010
  49.  
  50.  ; The config line for the available text.
  51.  
  52.  #TEXT1 2
  53.  The sysop is available for a chat !
  54.  Call him...
  55.  
  56.  ; The config line for the not available text.
  57.  
  58.  #TEXT2 5
  59.  I`m terribly sorry...
  60.  Because of joining my holidays I`m not available for a chat.
  61.  Contact my CoSysop by mail...
  62.  
  63.  The Sysop
  64.  
  65.  ; The config line for the holiday text.
  66.  
  67.  #HOLIDAY 2
  68.  I`m just enjoying my holidays :-)
  69.  I think you have to write a mail...
  70.  
  71.  ; end of sample
  72.  
  73.  
  74.  
  75.  Commands in the configfile
  76.  
  77.  Command   : #AVAIL
  78.  Effect    : This command tells ChatAvail when the sysop is available
  79.              for a chat or not.
  80.  Parameter : 24 numbers - each for a hour
  81.              0 = not available
  82.              1 = available
  83.  Example   : #AVAIL 10000001100010001111001
  84.  
  85.  
  86.  Command   : #TEXT1
  87.  Effect    : The text which will be displayed if the sysop is available
  88.              for a chat.
  89.  Parameter : number of lines which the text has
  90.  Example   : #TEXT1 2
  91.              Hi ! The sysop is available for a chat.
  92.              Call him...
  93.  
  94.  
  95.  Command   : #TEXT2
  96.  Effect    : The text which will be displayed if the sysop is not avail-
  97.              able for a chat.
  98.  Parameter : number of lines which the text has
  99.  Example   : #TEXT2 3
  100.              I`m sorry...
  101.              The sysop isn`t available for a chat.
  102.              But you can write him a mail... :-)
  103.  
  104.  
  105.  Command   : #HOLIDAY
  106.  Effect    : The text which will be displayed if the sysop is in his
  107.              holidays...
  108.  Parameter : number of lines which the text has
  109.  Example   : #HOLIDAY 2
  110.              I`m just enjoying my holidays :-)
  111.              I think you have to write a mail...
  112.  
  113.  
  114.  
  115.  Starting ChatAvail
  116.  
  117.  ** IMPORTANT ** Set a stack for ChatAvail of about 10000 ! (I didn`t
  118.  tested it out if less or more is useful...)
  119.  ChatAvail has some powerful switches so reading the following is very
  120.  important...
  121.  
  122.  
  123.  [-o] ChatAvail has to be started with this switch in the BBS.
  124.  
  125.  [-y] This switch tells ChatAvail that you`re available for a chat.
  126.  
  127.  [-n] This switch tells ChatAvail that you aren`t available for a chat.
  128.  
  129.       (The Y and N switch don`t care the configuration file)
  130.  
  131.  [-t] This switch tells ChatAvail to use the Time Handler.
  132.       That means that it uses the available times of the configuration
  133.       file.
  134.  
  135.  [-c] Tells ChatAvail to use the settings set by the Y and N switch.
  136.  
  137.  [-s] Shows the actual status of the program and it`s settings.
  138.  
  139.       Time handler :
  140.       Y/N Command  :
  141.       Active cmd.  :
  142.  
  143.  [-h] Holiday mode switch. Is to be used when the sysop lies under palms
  144.       in hawaii :-)
  145.  
  146.  
  147.  Calling ChatAvail without any switches an online help will be displayed.
  148.  
  149.  
  150.  Some examples:
  151.  
  152.  If you call ChatAvail with the -y switch and have already set the -t
  153.  switch you`ll get the available status from the config file.
  154.  
  155.  Example: ChatAvail -n -c
  156.  Effect : ChatAvail will show in the online mode that the sysop isn`t
  157.           available - even if the config settings say that the sysop is
  158.           available...
  159.  
  160.  So if you want to enable the config settings type "ChatAvail -c" and
  161.  the Y/N status will be used...
  162.  
  163.  The avail status is subdivided in two parts. The time handled part and
  164.  the Y/N handled part.
  165.  Using ChatAvail time handled it refers on tha available times in the
  166.  configuration file. The Y/N part uses the available status set by the
  167.  Y and N switch.
  168.  
  169.  I hope you understood this...maybe in the beginning it`s a little bit
  170.  complicated - but after a short time you`ll get it !!!
  171.  
  172.  
  173.  Holiday mode
  174.  
  175.  ChatAvail has a special feature for the time when the sysop enjoys his
  176.  holidays.
  177.  So, when you`re joining your holidays call ChatAvail only with the -h
  178.  switch. It will automatically display the "holiday-text" of the confi-
  179.  guration file.
  180.  
  181.  
  182.  I think you`re now able to run the program successfully... :-)
  183.  
  184.  
  185.  Bugs, ideas, money, girls...contact me:
  186.  =======================================
  187.  
  188.  Rafael Metz
  189.  Gottfried-Kinkel-Str. 23
  190.  6200 Wiesbaden, Germany, Europe, Earth
  191.  
  192.  Voice: +49-611-87126
  193.  BBS  : +49-611-801981 (Infernal Lightning - 24h - V32 + V42)
  194.  Fido : 2:248/34
  195.  
  196.