Shareware Overload

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Overload / ShartewareOverload.cdr / database / logbk105.zip / LOGBOOK.DOC < prev next >

Wrap

Text File | 1991-02-13 | 34KB | 983 lines

Copyright and Trademark Notices "IBM," "PC-DOS," and "AT" are registered trademarks of International Business Machines Corporation. "Nantucket" is a registered trademark of Nantucket Corporation. "PLINK86-Plus" is a registered trademark of Sage Software, Inc. "PC/XT" is a trademark of International Business Machines Corporation. "Clipper" is a trademark of Nantucket Corporation. "MS-DOS" is a trademark of Microsoft Corporation. "dBASE," "dBASE III Plus," and "Ashton-Tate" are trademarks of Ashton-Tate Inc. "Diabetes Logbook" is a trademark of Carl S. Zebooker. About Diabetes Logbook Carl S. Zebooker, the author of this program, developed Type II diabetes just before his 40th birthday. Already severely sight- impaired, and already a computer user, he began using dBASE III Plus to keep and print out a record of his glucose readings and other pertinent information for his medical care professionals, Dr. Scott Schroth, MD, and Ms. Marie-Michele Leger, PA-C, of the George Washington University Health Plan. During an office visit, Dr. Schroth inspired the writing of this program by remarking that it would be most helpful if such a tool were made available to other diabetics. Dr. Andrew Bender, MD, had many helpful suggestions with regard to the writing of this program; thanks to him for them. Thanks to Mr. Steve M. O'Gara for suggesting that this program display a graph of blood glucose readings. Thanks to Mr. Bill Fowler, of the Capitol PC User Group, for the suggestion that the text of "note codes" be made available on-screen during a records editing session, and for his suggestion that this program print reports in more than one format. This program was written in the Clipper programming language, compiled using the Clipper compiler, and linked using PLINK86-Plus, all from Nantucket. Registered users of Diabetes Logbook receive an upgrade which allows them to display a bar graph of their glucose readings on-screen, and to choose screen colors for "normal" and "enhanced" characters. Table of Contents Requirements 1 Before You Begin 1 Installing LOGBOOK.EXE 2 Loading LOGBOOK.EXE 3 The Main Menu 3 The Sub-menus 4 The "Set-Up" Sub-menu 4 Data Entry 5 Editing Keys 5, 6 The "Logbook" Sub-menu 7 The Logbook Editing Screen 8 The "Report" Sub-menu 9 The "Print" Sub-menu 9, 10 The "File" Sub-menu 10, 11 The "Graph Demonstration" screen 11 The "Exit" sub-menu 12 The "Free Trial" Period 12 Files Initially Present 13 Files Created by LOGBOOK.EXE 13 Suggested "Note" Codes 14, 15 More Than One Insulin Mixture 16 Editing "Note Codes" 17 User-suggested Improvements 17 BBS/Mailer Support 17 Diabetes Logbook v1.05 Manual - Page 1 Requirements You will need: An IBM PC/XT/AT or compatible with not less than 270K of free (available) RAM. DOS 2.0 or higher. (PC-DOS or MS-DOS is fine) At least one 5¼" 360K floppy drive. The following lines in your CONFIG.SYS file: files=20 (or more) buffers=20 (or more) For more information on the CONIFG.SYS file, please consult your DOS manual. Before You Begin It is wise to make a backup copy of the distribution diskette before you set up your logbook. To do so, first boot your system and obtain a prompt. Enter the appropriate command at the prompt. On a system with two 5¼" 360K drives: 1) Insert distribution diskette in Drive A: 2) Insert a blank formatted 360K diskette in Drive B: 3) Type the command: diskcopy a: b:<Enter> On a system with one 5¼" 360K drive: 1) Insert distribution diskette in Drive A: 2) Type the command: diskcopy a: a: <Enter> 3) Follow the on-screen instructions, inserting a blank formatted "TARGET diskette" in Drive A: when prompted to do so. For more information on the "diskcopy" command, or on formatting diskettes, please see your DOS manual. Diabetes Logbook v1.05 Manual - Page 2 Installing LOGBOOK.EXE On a system with no hard disk: 1) Make a backup copy of the distribution diskette (see "Before you begin" on page 1). 2) Use the backup copy to run LOGBOOK.EXE's "Set-Up" from the backup copy (see "Loading LOGBOOK.EXE," on page 3, and "The `Set-Up' menu," on page 4). On a system with a hard disk: 1) Make your hard disk the default drive by typing: c:<Enter> (You may use a different drive if you wish.) 2) If it is not already part of your AUTOEXEC.BAT file, enter the command: prompt $p$g<Enter> The "p" and "g" in "$p$g" must be lower case. 3) If the prompt does not show the "root" directory as being the default directory ("C:\>"), change to the root directory by typing the command: cd\<Enter> (You may make the directory where LOGBOOK.EXE is stored a subdirectory of some other directory if you wish.) 4) Make a directory for Diabetes Logbook by typing the command: md logbook<Enter> (You may choose another directory name if you wish.) 5) Make the new directory the default directory by typing the command: cd logbook<Enter> 6) With the distribution diskette or a backup copy in Drive A:, copy all files to the new directory by typing the command: copy a:\*.*<Enter> If you need help with any of these commands or terms, please see your DOS manual. Diabetes Logbook v1.05 Manual - Page 3 Loading LOGBOOK.EXE On a system with no hard disk: 1) Place the distribution diskette, or a backup copy, in Drive A: (or B: if you wish). 2) Make A: (or B:) the default drive by typing the command: a:<Enter> (or b:<Enter>) 3) Load LOGBOOK.EXE by typing the command: logbook<Enter> On a system with a hard disk: 1) Change to the drive and directory where LOGBOOK.EXE was installed; please see "Installing LOGBOOK.EXE" on page 2 and your DOS manual if you need help with this. 2) Load LOGBOOK.EXE by typing the command: logbook<Enter> The Main Menu When you load LOGBOOK.EXE, the screen is cleared, and the main menu displays. You may use the arrow keys to navigate the main menu, pressing <Enter> to make a choice, or you may use its "hot key" feature by using the keyboard to enter the first letter of the item you wish to choose. For example, there are two ways you may exit the program from the main menu: 1) Use the left and/or right arrows to highlight "Exit," press <Enter> to activate the "Exit" sub-menu, use the up/down arrow keys to highlight "Yes," and press <Enter> to return to DOS. 2) Press "e" to select the "Exit" sub-menu then press "y" to return to DOS. Note that pressing the right arrow with "Exit" highlighted will cause "Set-Up" to be highlighted, and pressing the left arrow with "Set-Up" highlighted will cause "Exit" to be highlighted. This feature is called "wraparound." Diabetes Logbook v1.05 Manual - Page 4 The Sub-menus Once you have made a choice from the main menu, either by highlighting and pressing <Enter> or by using the "hot key" feature, a sub-menu will appear. You may make a choice from that sub-menu by highlighting your choice and pressing <Enter> or by using the "hot key" feature. You may also move to another sub-menu by using the left/right arrow keys, or return to the main menu by pressing <Esc>. While in the sub-menus, you have full left-right and up-down wraparound. The "Set-Up" Sub-menu There are five (5) options available on this menu: New User Use this choice the first time you load LOGBOOK.EXE. It will store information about you, your health plan, and your health care professionals in a file it creates, called "HEADERS.MEM." This file will be used whenever you print out a hard or soft copy of the logbook. See "Data Entry" on pages 5 and 6 for details. The "New User" module will ask you to "fill in the blanks." In some cases, such as the name of your doctor, the blank is already partly filled in. You may delete these suggestions if you wish. Colors This option is not available in the shareware version of Diabetes Logbook. Those users who send a registration fee to the address given in LICENSE.DOC will receive a copy of Diabetes Logbook that allows the user to choose screen colors. Headers This module allows the user to change existing report header information other than the user's name. If you change health plans or doctors, you will want to use this module. Type If your diabetes changes from Type II (non-insulin-dependent) to Type I (insulin-dependent), you will want to use this module. The old logbook will be saved under the name OLD.DBF. Insulin If you change the type of insulin you use, you will want to run this module. Diabetes Logbook v1.05 Manual - Page 5 Data Entry Recording your glucose and, if applicable, insulin data is the idea behind of Diabetes Logbook. As you run the program, you will be asked to enter or change data displayed on the screen. This data is displayed in "enhanced mode," or "reverse video," as black letters on a white background. Use the keyboard to enter data. While in the "Logbook Editing" screen, you will see a summary of the information below by pressing <F1>. Editing Keys The symbol "^" is used to indicate holding down the "Ctrl" key while pressing another key. For example, "^X" means "Ctrl-X," holding down the "Ctrl" key while pressing the "X" key. You may use the following keys to move around data entry screens: Navigation keys: , ^S Move cursor one character left , ^D Move cursor one character right ^,^A Move cursor one word left ^, ^F Move cursor one word right , ^X, Save contents of current data entry box and move Return, ^M cursor to "next" data entry box * , ^E Move cursor to "previous" data entry box (saves) * Home Move cursor to first character of current data entry box End Move cursor to last character of current data entry box ^Home Move cursor to beginning of first on-screen data entry box ^End Move cursor to beginning of last on-screen data entry box * Please note that data boxes are ordered from left to right horizontally, and from top to bottom vertically Diabetes Logbook v1.05 Manual - Page 6 Editing Keys (continued) Mode Keys: Ins, ^V Toggle "Insert/Typeover" mode (default is "Typover") Editing keys: Del, ^G Delete character at current cursor position Backspace, ^H Delete character to left of cursor position (destructive backspace) ^T Delete word to right of current cursor position ^Y Delete from current cursor position to end of data box ^U Restore original contents of current data box Escape Keys: PgUp, PgDn, Terminate data entry for current screen, saving ^W, ^C contents of all on-screen data boxes Return, ^M Terminate entry for, and save contents of, all on-screen data boxes when issued from last (lowest rightmost) on-screen data box Esc Leave current data entry box without saving its contents Confirmation At the bottom right of the screen is a "confirmation box." Enter "y" and press <Return> if the on-screen information is correct, and you are ready to proceed to the next screen. Diabetes Logbook v1.05 Manual - Page 7 The "Logbook" Sub-menu Today This choice allows the user to edit the daily record corresponding to the computer's current system date. Yesterday This choice allows the user to edit the daily record corresponding to the day before the computer's system date. Period This choice allows the user to specify the period for which records are to be edited. A data entry screen appears, with a data entry box containing the date for the earliest daily record, and a data entry box containing either the current date or the date of the latest daily record, whichever is dated earlier. There are two ways that the "ending date" shown on the screen may precede the current date: 1) The computer's system date is incorrect, and should be reset by using the DOS "date" command. 2) The computer's system date is correct, but is later than the last daily record in LOGBOOK.DBF; this should be remedied by adding enough daily records to allow record- keeping through the end of the current calendar month. The user may change choose another period for which data is to be entered or edited by changing either date, provided that the new dates fall within the period originally given on the screen. The user is not allowed to edit records for any future date, as measured from the computer's system date. If the computer's system date is incorrect, it may be reset by using the DOS "date" command; please see your DOS manual for details on doing this. Add This choice causes one calendar month of blank daily records to be added to LOGBOOK.DBF, with the option of adding more blank daily records, a calendar month at a time. Diabetes Logbook v1.05 Manual - Page 8 The Logbook Editing Screen This screen displays whenever the user is entering or editing data for daily records. The screen displays one day's record at a time, showing the date in blinking letters. Other than weight, each type of data has its own column on the screen. Rows indicate various times of day, such as "Breakfast" or "Bedtime" Help There are two "Help" keys for this screen. <F1> lists the editing commands, <F2> lists, and allows editing of, "note codes." Weight If the user was weighed on the date shown, they may enter that weight. Only numerical data may be entered in this box. The default value is zero. Glucose The user may enter their glucose readings in this column at the appropriate row. Only numerical data may be entered in these boxes. The default value is zero. Insulin Type I (insulin-dependent) diabetics may enter their insulin dosages in this column at the appropriate row. Only numerical data may be entered in these boxes. The default value is zero. Time The user may enter the times of glucose readings and insulin dosages in this column at the appropriate row; use of a 24-hour time format is suggested, such as "17:00" for "5:00 pm." Any alphanumeric characters, such as "Lost" or "Skip" may be entered in these boxes. The default value is five blank spaces. Note The user may enter a one-character note in this box, such as "W" for "[W]orkout" or "B" for "eating [B]inge." See pages 13 and 14 for more suggestions on note codes. Any single alphanumeric character may be entered in this box Confirmation At the bottom right of the screen is a "confirmation box." Enter "y" and press <Return> if the on-screen information is correct, and you are ready to proceed to the next screen. Diabetes Logbook v1.05 Manual - Page 9 The "Report" Sub-menu Choosing this option from the main menu makes three options available. They are: The "Print" Sub-menu, The "File" Sub-menu, and The "Graph Demonstration" screen. Details on these choices are given below. The "Print" Sub-menu Choices from this sub-menu will cause a report to be printed on paper (hard copy). The program will ask whether you want to do a form feed (page eject) either before or nd after printing the report. If you experience difficulty in printing, check to see whether the printer is "on-line" before using the "Wiring" option. Since This choice causes the program to find the date of the user's most recent visit to their doctor's office, print the file from the day before that date through the current date, or end of LOGBOOK.DBF if earlier, and then mark the current date to show a doctor's office visit. THIS IS THE ONLY "PRINT" OPTION THAT CHANGES LOGBOOK.DBF! If you do not want to mark the current date as one on which the doctor's office was visited, use the "Visit" option to print a listing of dates for which a doctor's office visit is marked, then use the "Period" option to print a listing for the period from the most recent doctor's office visit through the current date. Full This option prints the entire logbook, from beginning through the current date, or end of LOGBOOK.DBF if earlier, with a notation for dates showing a doctor's office visit. Diabetes Logbook v1.05 Manual - Page 10 The "Print" Sub-menu (continued) Period This option first displays a data entry screen showing the earliest date in LOGBOOK.DBF and the current date, or latest date in LOGBOOK.DBF if earlier. The user may modify these dates, provided the new dates entered fall within the range of dates originally shown on-screen. After the user has specified a time period, a copy of the logbook for that period is printed. Doctor's office visits are not shown. Visit This option prints a listing of all dates for which a doctor's office visit is marked. Wiring Use this option to select a printer port only if you experience difficulty in printing. The "File" Sub-menu Choices from this menu cause an ASCII file, called LOGBOOK.TXT, to be created in the default directory; the file LOGBOOK.TXT may then be manipulated with any text editor or word processor capable of retrieving and editing ASCII files. The program will ask whether you wish a form feed either before or after printing; these extra "pages" may be useful for adding notes to your health care professional. WARNING: If a LOGBOOK.TXT file already exists, it will be OVER-WRITTEN AND LOST FOREVER! This program does not check for the existence of a LOGBOOK.TXT file! You may wish to rename any existing LOGBOOK.TXT file before loading LOGBOOK.EXE. For more information on ASCII files or on renaming files, please consult your DOS manual, and/or your text editor or word processor manual. Diabetes Logbook v1.05 Manual - Page 11 The "File" Sub-menu (continued) Since This choice creates a file of all daily records starting with the most recent date for which a doctor's office visit is shown, and running through the current date, or end of LOGBOOK.DBF if earlier. No doctor's office visits are shown, nor is any notation of a doctor's office visit made. Full This option creates a file of the entire logbook from earliest date in LOGBOOK.DBF through the current date, or last date in LOGBOOK.DBF if earlier. Dates of all doctor's office visits are noted. Period This option first displays a data entry screen showing the earliest date in LOGBOOK.DBF and the current date, or latest date in LOGBOOK.DBF if earlier. The user may modify these dates, provided the new dates entered fall within the range of dates originally shown on-screen. After the user has specified a time period, a LOGBOOK.TXT file containing a copy of the logbook for that period is created. The "Graph Demonstration" Screen Registered users of Diabetes Logbook receive a version of the program that allows them to display their readings on-screen in the form of a bar graph. This "shareware" version of Diabetes Logbook contains a demonstration of that feature. Choose "Graph" from the "Report" sub-menu if you wish to see this demonstration. If your system supports color display, this demonstration will appear in color. After the demonstration is over, a screen appears reminding you that, by paying the registation fee, you can create and see a similar bar graph of their blood glucose readings. Diabetes Logbook v1.05 Manual - Page 12 The "Exit" Sub-menu Yes Choose this option if you wish to end the current Diabetes Logbook session and return to DOS. No Choose this option if you wish to continue the current Diabetes Logbook session. The "Free Trial" Period This program is distributed on a "free trial" basis. You may try it a no charge, but are expected to pay a registration fee of $18 if you use this program after the "free trial" period. The first time you use Diabetes Logbook, a "New User" set-up module allows you to enter information such as the diabetic's name, name of health plan, and type of insulin used by Type I diabetics. The "New User" module then creates LOGBOOK.EXE and fills it with four month's worth of blank daily records. These records cover the current calendar month, as well as the next three calendar months. That four-month period is your "free trial" period. The "New User" module will put a message on-screen telling you when the "free trial" period begins and ends, so you may mark your calendar. Using the "Add" option from the "Logbook" sub-menu will cause Diabetes Logbook to act as though the "free trial" period is over, as will loading LOGBOOK.EXE when the computer's system date is later than the date the "free trial" period ends. The program will begin displaying a special screen as a reminder that you are expected to pay the registration fee. Aside from the delay caused when this reminder screen displays, Diabetes Logbook will continue to function normally. It will take you longer to load and exit the program, but the program will still work. Once you have paid the $18 registration fee, you become a registered user of Diabetes Logbook, and receive a version of the program that does not display the reminder screen. As an added incentive, this upgrade will not only allow display of blood glucose reading on-screen as a bar graph, but also allow users with color monitors to choose screen colors other than black and white. Diabetes Logbook v1.05 Manual - Page 13 Files Initially Present The following files are present on the distribution diskette: LOGBOOK.EXE This is the "executable" file - the actual program. TYPE_1.DBF This is the prototype database file for Type I (insulin-dependent) diabetics. TYPE_2.DBF This is the prototype database file for Type II (non-insulin-dependent) diabetics. LICENSE.DOC This ASCII text file is the license granted to users of Diabetes Logbook. LOGBOOK.DOC This ASCII text file is the manual you are reading at this moment. SAMPLE.RPT ASCII text file containing sample "soft reports" for Type I and II diabetics. GRA_DEMO.TXT ASCII text file containing the readings on which the "graph demonstration" screen is based, CODES.TXT This ASCII text file contains a "blank form" to which you may add your own "note codes" from within the "Logbook Editing" screen. Files Created by LOGBOOK.EXE HEADERS.MEM This file contains information used in report headers, such as the diabetic's name, name of health plan, etc. LOGBOOK.DBF This is the file of daily records. This file may also be manipulated using dBASE III Plus. OLD.DBF This file will be created if there is a change in type of diabetes. It is the LOGBOOK.DBF file previously in use. LOGBOOK.TXT This is an ASCII text file created from the "File" sub-menu. See page 10 for more information. Diabetes Logbook v1.05 Manual - Page 14 Suggested "Note" Codes The file CODES.TXT, as provided with Diabetes Logbook, contains a "skeleton code sheet," which you may view and edit from within the "Logbook Editing" screen by pressing <F2>. If you have a word processor or text editor, you may use it to eidt or print out a copy of the file CODES.TXT, adding whatever codes you see fit to use, for your health care professional. See your text editor or wrod processor manual for details. If you have neither a text editor nor a word processor, you may use the DOS "type" command to print that file for your health care provider; see your DOS reference for details. These are used by the programs author, and are merely suggestions. A - reading taken [A]fter eating. a - B - eating [B]inge. b - C - two meals [C]ombined into one. c - D - [D]elay of over one hour between medication and food. d - E - e - F - [F]ailed to take reading. f - G - g - H - h - I - i - J - [J]oined health spa j - K - k - L - l - M - change in [M]edication effective today. m - Took [m]edicine when I took this reading. The program's author of includes the following in his printout: The log is in chronological order from top to bottom and from left to right on each line. Although a bedtime after midnight actually took place on the following day, it is shown with the preceding day's activities for clarity and ease of analysis. Diabetes Logbook v1.05 Manual - Page 15 Suggested "Note" Codes (continued) The coees shown below are used by the programs author, and are merely suggestions. Suggested Codes: N - [N]o meal eaten; no medicine taken. n - O - o - P - p - Q - q - R - r - S - [S]nack between last reading and this reading. s - [s]nack between this reading and next reading T - [T]ook medication; if mealtime, ate meal. t - U - u - V - doctor's office [V]isit (NOTE: This code is NOT used by LOGBOOK.EXE to mark doctor's office visits) v - lab [v]isit (for blood testing) W - [W]orkout (exercise) w - X - x - Y - y - Z - z - An insulin-dependent diabetic using more than one mixture of insulin could print out a code sheet with notation simnilar to the following : NOTE: I use the following insulin mixtures: Mixture # 1 - (composition of mixture # 1) Mixture # 2 - (composition of mixture # 2) Mixture # 3 - (composition of mixture # 3) ... (description of all mixtures used routinely) Mixture # 1 is used most frequently; where this report does not indicate otherwise, Mixture # 1 was used. Use of other mixtures is indicated in this report by a corresponding numeral placed to the right of the time blood glucose was read. Diabetes Logbook v1.05 Manual - Page 16 More than one Insulin Mixture Among the constraints the author of this program dealt with while designing and writing Diabetes Logbook were these: 1) Diabetes Logbook must allow for at least four (4) blood glucose readings, insulin dosages, and notes in each daily record, together with a report of the times of these events. 2) A report having each daily record, including the date, printed on one line is easiest to read. Since many diabetics are sight-impaired, ease of reading reports is a major concern in program design. 3) The program must aim at the "lowest common denominator" of computer hardware. For printing reports, this means a printer capable of a mono-spaced 10 cpi font, and nothing more. 4) Items 1, 2, and 3 above, taken together, mean that the report on each daily record must fit on an 80-character line, of which the date takes 9 spaces. This leaves enough space to report only one insulin dosage per blood glucose reading, or four per day. If you use more than one mixture of insulin, you may use the "note" feature of Diabetes Logbook (explained on page 8) to indicate which mixture you use at a given time. Please see the note at the bottom of page 15 for suggestions on doing this. If your choice of an insulin mixture is dictated by your blood glucose reading, you may choose to attach a note explaining the method you use to make this choice to your printed report. Those using more than one type of insulin also may find it useful to enter and store "Please see attached note" as "Insulin Type" during "New User" set-up, or afterwards by using the "Insulin" option of the "Set-Up" sub-menu. That phrase will then be printed in the header on each page of your reports, so your health care provider will know to look for an attached note. Diabetes Logbook v1.05 Manual - Page 17 Editing "Note Codes" From the "Logbook Editing" screen, press <F2> to view the contents of CODES.TXT. You may then edit that file, adding or changing "note codes" as you desire. If you need help with the editing commands, press <F1> to display a "Help" screen. Although many commands are the same as the "Logbook Editing Help" screen, this "Help" screen lists a few more commands that you may find useful for editing your "code sheet." User-suggested Improvements If you have any ideas on improving this program, please send them to the author. Please remember that he is severely sight-impaired, and had great difficulty in reading cursive handwriting. Send your ideas to: Diabetes Logbook c/o Carl S. Zebooker 1409 Hopkins Street NW Washington, DC 20036-5905 All serious suggestions will be considered, with extra weight given those from registered users. Those persons whose suggestions become part of future Diabetes Logbook versions will be given credit for making the suggestion in the "About Diabetes Logbook" section of this manual. There arem, alas!, no cash awards for good suggestions. As Thomas Edison said: "Genius is 1% inspiration and 99% perspiration." BBS/Mailer Support BBS support is available on the New Generation Computers BBS (202) 466-5353. In addition, the program's author may be contacted on his front-end mailer at FidoNet 1:109/349.7.