home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / LAN / NETBDAY3.ZIP / NETBDAY.DOC < prev    next >
Text File  |  1992-06-21  |  6KB  |  154 lines
  1.                               NetBday
  2.  
  3.                     A VERY silly netware utility.
  4.  
  5. "This is probably the stupidest programme my son (the doctor) has ever
  6. written" (authentic apocryphal misquote from the author's mother)
  7.  
  8. 0) This release (#3)
  9.  
  10. This release is a major upgrade - I finally got around to getting rid
  11. of a whole lot of baggage code which caused all sorts of minor
  12. complications for some users of earlier versions.
  13.  
  14. Windowing code is simpler and cleaner and in general the package should
  15. cause fewer problems. Keep those cards and letters coming folks...
  16.  
  17. 1) Licencing and legal stuff
  18.  
  19. This software and associated documentation is copyright software and
  20. may only be distributed and used under the terms described herein. The
  21. documentation and software provided in this package may be freely
  22. copied and distributed in unaltered form only. No fee may be charged
  23. for distribution or use of this package except by prior arrangement
  24. with the copyright holder whose contact details are provided at the
  25. end of this text.
  26.  
  27. This software and documentation are guaranteed to take up room on your
  28. disk until they are deleted. In addition, if this software breaks
  29. anything of yours, you get to keep all the pieces. Other than that,
  30. there are no guarantees or warranties of any kind including
  31. merchantability or fitness for purpose provided with this package. Use
  32. it at your own peril. Remember, you usually get what you pay for.
  33.  
  34. If you install this package, you may use it for a trial period of up
  35. to one calendar month with no obligation. If you like the package and
  36. wish to continue using it, you must send the author a postcard or
  37. email (details below) preferably describing the setting and number of
  38. users on your network(s). Other than that, go for it.
  39.  
  40. 2) Description
  41.  
  42. NetBday is a network login utility (specific to Novell networks) which
  43. is extremely popular with the users on my network (they made me write
  44. it when a clinical package I wrote started playing happy birthday
  45. whenever it was the birthday of a patient whose records were being
  46. accessed). It is quintessentially silly. This stupid program announces
  47. your user's birthdays to the world by playing "Happy Birthday"
  48. (complete with words for those who don't know them) whenever they
  49. login. Amazingly enough, that's all it does !.
  50.  
  51. If there is no novell network present, NetBday will NOT be able to read the
  52. users name from the network bindery. It will still run but will probably
  53. assume that no one is the birthday person (ie act like it was in N for
  54. never play mode).
  55.  
  56.  
  57. 3) Installation
  58.  
  59. Create a text file (details in section 4 below) containing your
  60. network's user login names, the text you want displayed as the users' name
  61. (for example, a full name or nickname) and their birthdate. Call it
  62. BDLIST.DAT (or whatever you prefer). Put both the netbday.exe file and
  63. the birthday list file in your sys:public directory (or some other
  64. directory available to all users during the execution of the system
  65. login script. Make BOTH files readonly and sharable (use the netware
  66. "flag" utility - eg - "flag netbday.exe ro s") and add the following
  67. lines somewhere near the end of your system login script :-
  68.  
  69. #sys:public/netbday /public/bdlist.dat [U|A|N]
  70.  
  71. The first parameter on this login script command line is REQUIRED ! It must
  72. be a file containing birthday dates and user names (see below) and the
  73. user MUST HAVE READ and FIND ACCESS TO THAT DIRECTORY !!. SYS:PUBLIC is a
  74. reasonable place for such a file.
  75.  
  76. The optional 2nd parameter a or n or u controls the behaviour of the
  77. program. The default is U.
  78. For music to be played to ALL users on any other user's birthday use a.
  79. For music NEVER to be played use n.
  80. For music to be played ONLY when a user logs in on his/her birthday, use u.
  81.  
  82. To recapitulate, the optional second parameter controls whether happy
  83. birthday is played to All users, (ie whenever it's someones birthday),
  84. No users (not even the user whose birthday it is) or the user (when it's
  85. his/her birthday) only.
  86.  
  87. The first parameter is the name of a birthday file - eg
  88.  
  89. netbday \public\bdlist.dat a
  90.  
  91. When a user logs in, the netbday executable reads the birthday list
  92. file (the path is passed as a command line parameter as shown above).
  93. It looks to see if anyone has a birthday today, and if so, plays
  94. "happy birthday" depending on the second parameter.
  95.  
  96. If not, it clears the screen, prints the programme name and version
  97. followed by a line saying whose birthday is next and in how many days if
  98. less than 6. During the playing of "happy birthday", pressing any
  99. key will stop the silliness.
  100.  
  101. Note that some users may be insulted by this bizarre piece of social
  102. engineering, in which case the following strategem is recommended.
  103. Create a new user group (called BD for example). Make all users who
  104. want this program executed during login members of this group. Then
  105. change the system login script to something like this :-
  106.  
  107. if member of "BD" then begin
  108. #sys:public/netbday /public/bdlist.dat
  109. end
  110.  
  111. 4) Birthday list file structure
  112.  
  113. The BDLIST.DAT file must be a plain ascii file (NOT a nerdperfect file
  114. for example - although you can ask most wordprocessors to make a plain
  115. dos text file). Each line starting with an asterix (*) is ignored as a
  116. comment. Lines of data must have a netware user name, a comma, a
  117. name to display for that user name, another comma and a birthdate as
  118. dd/mm (eg 03/06 for the third of June) for example :-
  119.  
  120. * this comment line will not be used as data
  121. jim,Sir James PonceNeuf,03/02
  122. judy,Judy Surname,04/05
  123. * put as many lines as you like
  124. * this is the end of the file
  125.  
  126.  
  127. 5) Author !, Author !.
  128.  
  129. NetBday was written in Turbo Pascal and uses a call from the tp5_api
  130. unit of Mark Bramwell (mark@hamster.business.uwo.ca) for finding the
  131. user's name. It uses the music unit of JC Kessels (J.C. Kessels,Philips de
  132. Goedelaan 7, 5615 PN Eindhoven,Netherlands).
  133.  
  134. Source code will be made available for large amounts of money or other
  135. good reason.
  136.  
  137. Email may be sent via the Internet to :-
  138. rml@extro.ucc.su.OZ.AU
  139.  
  140. Postcards may be sent to :-
  141. Dr. Ross Lazarus
  142. 29 Francis St.
  143. Bondi  NSW 2026
  144. Australia.
  145.  
  146. Please provide details of the equipment in use and problem(s)
  147. encountered if 'misfeatures' are detected in using this software, to the
  148. above address.
  149.  
  150. Flames > nul
  151.  
  152. rml
  153. June 20, 1992.
  154.