ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ Birthday PCBoard 15.21 PPE Birthday Displayer ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ The installation of Birthday is fairly simple. Birthday should be in- stalled into your Main Logon Script file (or any equivilent PCB logon display file). My Logon Script file has this line in it: !E:\PPE\BIRTHDAY\BIRTHDAY.PPE This is all that is needed to be done to call Birthday whenever users call into your system. Also, to run Birthday PPE as a DOOR (a sample BIRTHDAY door batch file is included) you need to add the DOOR commandline parameter. Do NOT add the DOOR commandline parameter to the previously mentioned Logon Script file. It can also be installed as a command in the CMD.LST file but here too add the DOOR commandline. Also, this is IMPORTANT for the installation process... If you're going to use the (1-5) User Notes Fields, then you must have the User Notes PSA installed in PCBoard via PCBSM. If you're going to use the Verification Field then the Verification PSA must be installed. If you're going to use the "CWPPE TPA" (which is the recommended method) then you must install the CWPPE TPA as outlined below. For more info on PSA's and TPA's please see your PCBoard manual. Thanks ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ If you have already installed the CWPPE TPA, then skip this section! ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³ Settings to install the "CWPPE" TPA in PCBSM. For additional info on ³ ³ installing TPA's please consult your PCBoard manual. After bringing ³ ³ down all your nodes, install the TPA with these settings: ³ ³ TPA Name: CWPPE ³ ³ Version: 1 ³ ³ Static: 256 ³ ³ Dynamic: 1 ³ ³ Key: CWPPE ³ ³ This TPA is installed for various "user specific settings" that some ³ ³ of my PPE utils will require. If you installed this TPA already for ³ ³ one of my other PPE's then you DON'T need to re-install it again. ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ That's the installation, now to configure it... The configuration file must be located in the same directory as the BIRTHDAY.PPE and must be called BIRTHDAY.CNF. Config File Details ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Line 1 ³ Intelec Online ³ -> Who registered to (a BBS name or SysOp name) Line 2 ³ 00000 ³ -> Registration number (00000 if unregistered) Line 3 ³ 00000 ³ -> Validation code (assigned upon registration) Line 4 ³ 1 ³ -> Which User Notes line to use. * (See Below) Line 5 ³ E:\PPE\BIRTH ³ -> Path\filename of the birthday "display file" Line 6 ³ 20 ³ -> Minimum security level to "award" extra time Line 7 ³ 30 ³ -> # of minutes to award user on their birthday Line 8 ³ SysOpName ³ -> SysOp name or Birthday PPE as the FROM name. Line 9 ³ 30 ³ -> Days to skip users who missed their birthday Line 10 ³ 0 ³ -> Which conference number to post greetings in Line 11 ³ N or R ³ -> N = Public Greetings ; R = Receiver Only Line 12 ³ SYSOP NAME ³ -> Put the SysOp's name here for online maint. Line 13 ³ I or BLANK ³ -> For using dd-mm-yy international date format ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Line 1 When registered, you should place the name of your BBS on this line as it was used for the registration (no different). Line 2 This is the registration number you were given upon registering. If not yet registered, use 00000 instead or it will not function. Line 3 This is the "validation code" you were given upon registering. If not yet registered, use 00000 instead or it will not function. Line 4 Birthday PPE will place the user's date of birth on the user note line that you configure here. PCBoard offers 5 lines in the users records when the user notes PSA is enabled. Make sure you do not assign this to a line that is already being used by another PPE. Numbers 1-5 are for the 5 lines in the "Notes PSA". If you'd like to use the Verification Code PSA for this, place a 6 on this line instead but you must then have the Verification PSA installed. If you'd like to use the "CWPPE TPA" to store the birthday info and save the Notes or Verification Code PSA for something else, place a 7 on this line instead. Line 5 This is the file that is displayed to users when logging on, on their birthdays. It supports security specific, ansi, pcb macros, language specific, etc PCBoard file formats! Line 6 You can now award extra online time to users on their birthdays. You can limit this with a minimum security level placed here. Line 7 If you don't want to support bonus time awards, then place a 0 on this line. Line 8 This will be the "from name" in a message to the user. You can make it your name, or from BIRTHDAY PPE or whatever you like. Did you say message? Yes I did... If a file called "BIRTHDAY.MSG" exists in the Birthday PPE dir, Birthday PPE will send a message to the user on their birthday. The birthday message will be whatever text you place in the file BIRTHDAY.MSG. If BIRTHDAY.MSG doesn't exist in the PPE directory, no message will be sent to the user. Line 9 This is the number of days to wait after a user's birthday to show the Birthday, or belated birthday greeting. And what is this for? We all know that not all users call their favorite boards on their birthdays. I know I might have better things to do that day. So now Birthday PPE can detect if a user hasn't called since their birthday and if within the number of days you defined in the CNF file (line 9) then Birthday PPE will still display the greeting (BIRTH or LATE) and it will still award the "extra time" and can still send the message if you've configured for messages to be sent. There's two differences in the files displayed/messaged if the user's call is "after" their birthdate. Instead of BIRTHDAY.MSG it will send BIRTHDAY.LAT *if* BIRTHDAY.LAT exists. If it doesn't exist then it will use the default BIRTHDAY.MSG file for the message. Same deal with the display file, if a file called LATE exists it will be displayed instead of the file called DISP (or whatever you defined it as). All of this for added configurability, but... BIRTHDAY.MSG, BIRTHDAY.LAT and LATE are file names that cannot be changed. Line 10 Which conference to post the birthday greeting messages in, if you support the message function of Birthday PPE. Line 11 N is if you want to make the birthday message to the user a public message, and R is if you want to make it a private message. Line 12 This is the SysOp's name. Even though it may be a duplicate of line 8, this line is required where line 8 is not required to be your name. Line 13 If you use the international date format of dd-mm-yy instead of mm-dd-yy (as in using 29-08-57 instead of 08-29-57 for Aug 29th) then place an I on line 13. If you use the standard date format of mm-dd-yy then you can leave this line blank. What It Does To Who If a user calls you and they have not yet entered their D.O.B., this PPE will prompt them for this information. If it's a valid date, it is entered into their PCBoard user record. If it's not it won't enter it and it will prompt them again upon their next call. Once it is entered Birthday PPE will not "bug" them again for this info. Upon their login on their birthday (should they do so) it will display the file you've configured on line 5 in the CNF file. I've included my sample and you can modify it or make your own from scratch. Below are some of the greeting text I've come across, use as you like. Ò ÒÖÄ¿ÒÄ¿ÒÄ¿· Ú ÒÄ¿ÒÒÄ¿ÖÒ¿Ò ÒÒÄ¿ÖÄ¿· Ú ÖÒ¿ÖÄ¿ · ÚÖÄ¿Ò Â Ò ÇĶÇÄ´ÇÄÙÇÄÙÓÒÙ ÇÄ´ºÇÂÙ º ÇĶº ³ÇÄ´ÓÒÙ º º ³ ÓÒÙº ³º ³ Ð Ð ÐÐ ÁÐ Ð Ð ÐÄÙÐÐÀÙ Ð Ð ÐÐÄÙÐ Á Ð Ð ÓÄÙ Ð ÓÄÙÓÄÁ o Ò Ò ÖÄ¿ ÒÄ¿ ÒÄ¿ · Ú ÒÄ¿ Ò ÒÄ¿ ÖÒ¿ Ò Ò ÒÄ¿ ÖÄ¿ · Ú ÖÒ¿ ÖÄ¿ · Ú ÖÄ¿ Ò Â Ò ÇĶ ÇÄ´ ÇÄÙ ÇÄÙ ÓÒÙ ÇÄ´ º ÇÂÙ º ÇĶ º ³ ÇÄ´ ÓÒÙ º º ³ ÓÒÙ º ³ º ³ Ð Ð Ð Ð Á Ð Ð Ð ÐÄÙ Ð ÐÀÙ Ð Ð Ð ÐÄÙ Ð Á Ð Ð ÓÄÙ Ð ÓÄÙ ÓÄÁ o * * * * * Û Û Û Û Û ÞÛÛÛÛÛÛÛÛÛÛÛÝ Þ²²²²²²²²²²²Ý ²GREETINGS² ÜÛÛÛÛÛÛÛÛÛÛÛÛÛÜ ±±±±Ü ±±±±Ü ±±Ûß ±±Ûß ±±Û ±±Û ±±±±±±Ü ±±±±±±Ü ±±±±±±Ü ±±Ü ±±Ü ±±±±±±±±Û ±±Ûß±±Û ±±Ûß±±Û ±±Ûß±±Û ±±Û ±±Û ±±Ûßßß±±Û ±±±±±±Û ±±±±±±Û ±±±±±±Û ±±±±±±Û ±±Û ±±Û ±±Ûß±±Û ±±Ûßßßß ±±Ûßßßß ßßß±±Û ±±±±Û ±±±±Û ±±Û ±±Û ±±Û ±±Û ±±±±±±Û ßßßß ßßßß ßß ßß ßß ßß ßßßßßß ±±±±±±±±±Ü ±±Ü ±±Ûßßß±±Û ±±Û ±±Û ±±Û ±±±±Ü ±±±±±±Ü ±±±±±±±±Ü ±±Ü ±±Ü ±±±±±±±Ü ±±±±±±Ü ±±Ü ±±Ü ±±Û ±±±±±±±Ûß ±±Ûß ±±Ûß±±Û ßß±±Ûßßß ±±Û ±±Û ±±Ûß±±Û ±±Ûß±±Û ±±Û ±±Û ±±Û ±±Ûßßß±±Û ±±Û ±±±±±±Û ±±Û ±±±±±±Û ±±Û ±±Û ±±±±±±Û ±±±±±±Û ±±Û ±±Û ±±Û ±±Û ±±Û±±Ûß ±±Û ±±Ûß±±Û ±±Û ±±Û ±±Ûß±±Û ßßß±±Û ßß ±±±±±±±±±Û ±±±±Û ±±Û ±±Û ±±Û ±±Û ±±Û ±±±±±±±Û ±±Û ±±Û ±±±±±±Û ±±Ü ßßßßßßßßß ßßßß ßß ßß ßß ßß ßß ßßßßßßß ßß ßß ßßßßßß ßß