ÚÄÄÄÄÄÄ¿ ÚÄÄÄ¿ ÚÄÄÄÄÄÄ¿ ÚÄÄÄÄÄ¿ ÚÄ¿ ÚÄ¿ ÚÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄ¿ ÚÄÄÄÄÄ¿ ÚÄÄÄÄÄ¿ À¿ ÚÄ¿ ³ À¿ ÚÙ ³ ÚÄÄ¿ ³ ÀÄ¿ ÚÄÙ ³ ³ ³ ³ À¿ ÚÄ¿ ³ ³ ÚÄÄ¿ ³ ÀÄ¿ ÚÄÙ ³ ÚÄÄÄÙ ³ ÀÄÙ ³ ³ ³ ³ ÀÄÄÙ ³ ³ ³ ³ ÀÄÙ ³ ³ ³ ³ ³ ³ ÀÄÄÙ ³ ³ ³ ³ ÀÄ¿ ³ ÚÄ¿ ³ ³ ³ ³ ÚÄ¿ ÚÙ ³ ³ ³ ÚÄ¿ ³ ³ ³ ³ ³ ³ ÚÄÄ¿ ³ ³ ³ ³ ÚÄÙ ÚÙ ÀÄÙ ³ ÚÙ À¿ ³ ³ ³ À¿ ³ ³ ³ ³ ³ ³ ÚÙ ÀÄÙ ³ ³ ³ ³ ³ ³ ³ ³ ÀÄÄÄ¿ ÀÄÄÄÄÄÄÙ ÀÄÄÄÙ ÀÄÙ ÀÄÄÙ ÀÄÙ ÀÄÙ ÀÄÙ ÀÄÄÄÄÄÄÙ ÀÄÙ ÀÄÙ ÀÄÙ ÀÄÄÄÄÄÙ The Birth Date Utility v1.40 for PCBoard 15.2 and Above Copyright 1994 ArcticSoft (Mario Mueller) Antarctica (717) 755-2440 USRobotics Courier 28,800 "v.everything" with HST ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³±± I. Introduction to the Utility ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ The Birth Date Utility is a utility that will allow you get the users birth date. Since PCBoard doesn't have this option built in, you can use this PPE to do that job. This can be executed two different ways, one way would be replacing one of PCBoard's prompts and stuffing the entered information into that prompt. Second way would be using this program as your new user script. Another good thing about this utility is that it will make sure that the entered date is NOT invalid. So if a user would enter 00/00/00, the program would reject it and prompt for the correct answer. It will also check for any future dates, so if anyone enters a date later than the present date, it will reject the answer. To make sure that the format of the date is correct, the program will automatically provide the separating slashes (/) for the user. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³±± II. Features of the Utility ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ The following is a list of features of this utility: * Can be Installed almost anywhere in PCBoard * Small and will not take up much hard drive space * Configurable Prompt and Text Messages * Configurable Colors * Rejects Invalid Dates such as 00/00/00 * Rejects Future Dates (Configurable) * Rejects Incomplete Dates such as 01/23/ * Rejects Young Dates (Configurable) * Checks for valid/invalid date Format * Blocks an optional Specified Date Range * Detects an optional Specified Low Date Range * Does NOT require the ANSI emulation * Input Information can be Directed to a File * Optional Reading/Writing to PSA(6) User Notes * Optional Reading/Writing to a TPA Record * Optional Reading/Writing to Sysop Comment #2 * Executable DOS "Today's Birthdays" Bulletin Generator * Multi-Lingual Operation Support ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³±± III. Installing the Utility ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ You have a variety of different places to install this program. Since you want to get a user's birth date when he or she is a new user, you are limited in some ways. This program was originally requested to be a replacement for the Verification prompt which would stuff the entered information from the PPE to that prompt, but I decided to add some other options. If you would like to use this as a prompt replacement (even though it is not recommended), use the following process to accomplish this. I will use the Verification prompt as an example: * Execute the MKPCBTXT program * Press F3 and enter 706 * Clear the Existing prompt with the Ctrl-End Keys * Enter an exclamation point (!) in the first column, followed immediately by the program path and file name (eg. !C:\PPE\BIRTH\BIRTH.PPE) * Press ESC until you are out of the editor and your program is Installed * Edit the BIRTH.CFG file in the Birth Date Utility directory and put "1" (no quotes) on the first line. You also have the option of executing this program as your new user script program (one of the recommended ways). If you don't have a script right now, this would probably be the easiest way of installing this program. Use the following process to accomplish this: * Execute the PCBSETUP program * Select B for File Locations * Select D for New User/Logon/off Questionnaires * Clear the Existing information with the Ctrl-End Keys * Enter the path and file name to the program (eg. C:\PPE\BIRTH\BIRTH.PPE) You will have a big selection of "destinations" if you use this setup. See the next section for more information on configuring this type of setup. Some people might not have the New User script available. In this case, another idea would be to replace a PCBoard "new user" prompt with a display file, on the first line, execute the PPE with the exclamation mark "!" (no quotes) in the display file and place the original PCBoard prompt on the next line. Or, you could make your own PPE and place that in the new user script field, then have that new PPE call the previous PPE and the Birth Date Utility. These two setups are the most complicated (as much as they are to explain), but they are the best way of installing. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³±± IV. Configuration File and the /CHECK Parameter ±±±±±±±±±±±±±±±±±±±±±±±± ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ The configuration file will allow you to change where you would like the received information to be placed. There are a few different ways of storing your users' birth date information. You can set the program to stuff the keyboard's memory, have it sent to the second user comment, you can even send it to any one of the PSA-User Notes(6) if you have it installed, or finally (and the most recommended) install a TPA and have the information placed in that record. (see next section for more information on using the TPA). In order to alter the settings in your configuration file, you will need to use DOS's EDIT.COM program (i.e. EDIT BIRTH.CFG). Default file has been included with the archive. This file consists of the following configuration information: * Line [1] : You can use this line to specify where the "user entered" information is placed. Most of the available options were mentioned in the first paragraph of this section. Below this paragraph exists a listing of the available options corresponding with their actions: Config Action ÄÄÄÄÄÄ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 1 Keyboard Buffer (Stuff to Replaced Prompt) 2 Second User Comment 3 Write Given Information to BIRTH.DAT 4 Users Notes [1] (PSA-User Notes(6) Required) 5 Users Notes [2] (PSA-User Notes(6) Required) 6 Users Notes [3] (PSA-User Notes(6) Required) 7 Users Notes [4] (PSA-User Notes(6) Required) 8 Users Notes [5] (PSA-User Notes(6) Required) 9 Write Given Information to TPA Record Just place the number (no leading or trailing spaces) that is under the Config column to specify the destination corresponding with the number. Entered information will be sent with the format: MM/DD/YYYY * Line [2] : You can block out an optional specified date range by specifying the minimum age allowed (in years). Simply place the number of years you would like to count back from the current year. For example, if you wanted to prevent a 5 year old (or younger) from logging on to the system, you could simply specify 5 on this line. * Line [3] : You can prevent dates that are too OLD by specifying the YEAR on this line. Since it would be unlikely for someone who was born in the 1910's logging on to your system, this option is made available to you. This (and the BLOCK option) are both used to help prevent users from entering a BSed age (or just something random). - End of Configuration File - * Prompting CURRENT Users for their Birth Date * Most Sysops probably already have over 600 users on their system that haven't already been prompted for their birth date. You could always have the birth date utility executed each time a users logs on to the system, but what if that certain user has already entered their birth information? He would be prompted again, continuously until you remove the program from logon. That is unless you don't use the /CHECK parameter. When this parameter is used, the program checks the set destination for any text. If any text is found, the program will exit immediately assuming the user has already entered the birth information. If the program does not find any information in the destination, the program will then prompt for the birth information. Now the users that have been around when this utility wasn't on your BBS can now be prompted for their birth information. How? You can use the example I mentioned above, simply execute the program with the /CHECK command line parameter. The following is an example: !C:\PPE\BIRTH\BIRTH.PPE /CHECK The only disadvantage with this command is that it can't be used with the Keyboard Stuff (1) action. Since there are way TOO many prompts to that the birth information can be stuffed to, there really would be no way for the program to determine if the user has entered the information or not. The program doesn't know where to look for the information when the birth info is stuffed into a prompt. Any other (x) action will work with the /CHECK command line parameter. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³±± V. Install BDATE TPA Record ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ One of the nicest ways of collecting your data is using the TPA record feature that PCBoard provides. It follows the same idea as the PSA's (which is where the PSA idea came from), except it is only accessed by a specific program. In this case, that would be the Birth Date Utility. Use the following procedure to install and setup the TPA record. * Make sure all Nodes are at DOS Prompt * Execute the PCBSM.EXE program in the PCBoard Directory * Select the D "User Info File Maintenance" Option * Select the E "Add/Update Third Party Application" Option * Enter "BDATE" (no quotes) for TPA Name and Press Enter * Enter "10" (no quotes) for Version Number and Press Enter * Enter "10" (no quotes) for Static Size and Press Enter * Enter "0" (no quotes) for Dynamic Size and Press Enter * Enter "BDATE" (no quotes) for Keyword and Press Enter * Press PageDown to Update your User Records * Once Update is Complete Press ESC until you Exit PCBSM.EXE. The number of steps makes the configuration look complicated. But that is only because I was specific for each step. For Sysops who have done this before, this should not be any challenge for you. Once you have installed the TPA in PCBoard, be sure to specify "9" (no quotes) on the first line of the BIRTH.CFG file. You will then be set for using the TPA record system! When most of your users have entered in their Birth Date information, you will probably need some way of accessing the information for viewing and editing. Use the BIRTH.EXE with the /EDIT parameter to accomplish this. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³±± VI. Changing Colors and Text ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ You can change what the program will output to the user. Also, you can change the colors with the PCBoard @X color codes. Included with this program is a sample text file called BIRTH. that you can edit. The format for this file is very simple. Check the following list for more information: * Prompt given to the user for the Birth Date * Error Message for Not Enough Information * Error Message given when a date too Young is Entered (ex. 05/23/99) * Error Message for an Invalid format * Error Message given when a date too Old is Entered (ex. 04/21/00) Color codes can be entered in these messages and with the error messages, you can also use the PCBoard @BEEP@ code for a beep warning. For information/text that should be displayed prior to the prompting, edit the INTRO. text file. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³±± VII. Using the BIRTH.EXE Bulletin/TPA Utility ±±±±±±±±±±±±±±±±±±±±±±±±±± ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Included with the Birth Date Utility is a DOS executable program that will generate a "Today's Birthdays" bulletin. Remember that this works with all actions (destination settings) EXCEPT the Keyboard Stuff command. Mainly because of the same reason why it is restricted with the /CHECK parameter as well. (these are the major disadvantages of keyboard stuffing) But, if you use any other action (destination setting) besides "Keyboard Stuffing", you will be able to use this utility with ease. Just place this program in your nightly BATCH event. Use the following example command line/parameters to accomplish this: C:\PPE\BIRTH\BIRTH.EXE /BLT E:\PCB\ Note the command line parameter. This is used to specify the path of the PCBOARD.DAT file. Even if it is not needed, this specification is ALWAYS required with BIRTH.EXE. Other data will be read from the BIRTH.CFG file. Before the bulletin generating utility creates the bulletin data, it will insert an "introduction" file (BIRTH.SCR) prior to the birthday information. You can use PCBoard colors with PCBEDIT, TheDraw, etc. The BIRTH.EXE program is also used for editing the "BDATE" TPA records if you are using the TPA setup. Use the /EDIT command line parameter to accomplish this. Example: C:\PPE\BIRTH\BIRTH.EXE /EDIT E:\PCB\ With this, you will be able to edit and/or view the current TPA records of each of the users. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³±± VIII. Other Information ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ This program is FREEWARE and requires no fee. I encourage anyone to distribute this program and upload it to all your favorite bulletin boards. ALL files in archive must be included if you plan to distribute this program. If you have any comments or suggestions about the program, feel free to leave me mail at the following net mail address if you have InterNet access: mario.mueller@merchant.com If you have access to Fido-Net style Crash mail, you can send me crash mail at the Fido-Net node number 1:270/619. Latest versions are available for download on the support bulletin board called The Antarctica Bulletin Board System (717) 755-2440 located in York Pennsylvania. I appreciate any comments and suggestions about any of my programs. I am open for ideas that you may have. I would like to thank my friend Robert Morris for helping me BETA test this program. He was the one who requested the [PPE] program. I thought it was a great idea so I worked on it and added a couple of other options to it. I now have a SUPPORT conference on the support bulletin board for all of the programs I have available. You can find the LATEST versions of all of the programs there. If you logon to the system, simply type SUPPORT at the main prompt and you will be taken to the support conference. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³±± End of Documentation "BIRTH.DOC" ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ