home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / GLEN / V4L412.ZIP / V4L.DOC < prev    next >
Text File  |  1989-09-18  |  20KB  |  426 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                          V4L.EXE (VIAL for LIFE) 
  8.  
  9.                               Version  4.12
  10.  
  11.                            September 17, 1989
  12.  
  13.  
  14.                A Program to prepare VIAL FOR LIFE records
  15.  
  16.                                   and
  17.  
  18.                          BLOOD GLUCOSE records
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                 Copyright 1989 by William M. Galvin, Jr. 
  25.  
  26.                           All Rights Reserved
  27.  
  28.  
  29.  
  30.       VIAL FOR LIFE             V4L.EXE Rev 4.1            Sheet 2 of 9
  31.       -----------------------------------------------------------------
  32.  
  33.       WHAT IS V4L.EXE? 
  34.       ----------------
  35.  
  36.       V4L: a fourth generation program to prepare "Vial for Life" record
  37.       sheets, and weekly Blood Glucose/Insulin dosage records.  A sheet
  38.       is produced listing pertinant medical facts, medicine doses, pre-
  39.       scription numbers, doctors names and phone numbers plus a short
  40.       medical history; useful in the "Vial for Life" rescue squad program.  
  41.  
  42.       The "Vial for Life" is an ongoing project that some of the local
  43.       rescue squads have.  The members of the squads are trained to look
  44.       at the refrigerator for a sticky tag that says "Vial for Life"; and
  45.       if one exists on the door, they then look on the shelves in the door
  46.       for a large prescription (5" approx.) container that has the same
  47.       label.  All the data that they need is in the container.  If your
  48.       local rescue squad does not use this project, they should start it.
  49.  
  50.       Additionally, record sheets are produced for a diabetic to record
  51.       daily blood glucose readings and insulin dosages.  Sheets are also
  52.       printed for an individual who has an anomaly in medication require-
  53.       ments.
  54.  
  55.       The sheets will be combined if the individual has medication anom-
  56.       alies and insulin requirements. 
  57.  
  58.       The program can run on a floppy disk system or a system with a hard
  59.       drive. 
  60.  
  61.       VIAL FOR LIFE             V4L.EXE Rev 4.1            Sheet 3 of 9
  62.       -----------------------------------------------------------------
  63.  
  64.       REGISTERING V4L.EXE
  65.       ------------------- 
  66.  
  67.       V4L is a Shareware product.  It is not public domain software.  P.S.G.
  68.       urges those who find V4L to be of sufficient utility so as to use it
  69.       on a regular basis to remit a registration fee of $30.00. 
  70.  
  71.       Registration will also provide the user with one year's updates 
  72.       without cost.
  73.    
  74.       You may print a registration form using the DOS PRINT utility.  Enter
  75.       PRINT REGISTER.FRM.
  76.  
  77.       The mailing address for registrations is: 
  78.  
  79.          P.S.G. 
  80.          11016 Powder Horn Drive 
  81.          Potomac, MD 20854 
  82.  
  83.       WHY REGISTER V4L? 
  84.       ----------------- 
  85.  
  86.       Shareware is a unique concept.  It benefits the user by providing
  87.       high quality, low cost software that can be thoroughly evaluated 
  88.       before purchase.  If you like the product and you decide to use it,
  89.       then you should register.  Shareware is not like public domain soft-
  90.       ware -- it is protected by federal copyright laws and it is not free.
  91.       More importantly, the only way to encourage Shareware authors to 
  92.       continue to provide Shareware products is by paying them for the 
  93.       products that you use. 
  94.  
  95.       V4L LICENSE TERMS 
  96.       ----------------- 
  97.  
  98.       V4L, and all supporting/attendant documentation and utility 
  99.       software, is copyrighted by P.S.G., Inc. (William M. Galvin, jr.),
  100.       all rights reserved (1989).  It is licensed specifically for eval-
  101.       uation use by all IBM PC/XT/AT and compatible owners and operators
  102.       as Shareware.  As Shareware, V4L may be freely copied by individ-
  103.       uals, Computer User Groups, and Bulletin Board System (BBS) op-
  104.       erators for transmission to others for evaluation.  V4L is not 
  105.       free.  It is a fully mature software product distributed via the 
  106.       Shareware method by P.S.G., Inc. which is owned and operated by
  107.       William M. Galvin, jr.  No charge of any amount may be made by
  108.       anyone for V4L without the express permission of P.S.G., with the
  109.       following exceptions:  Bona fide organized computer user groups
  110.       and/or clubs may charge a nominal copying and handling fee for the
  111.       purpose of distributing Shareware copies of V4L to their members.
  112.       BBS operators who operate on a subscription basis may include copies 
  113.       of V4L on their boards for downloading by board subscribers.  
  114.  
  115.       COMPUTER DISK VENDORS AND SIMILAR DISTRIBUTORS OF PUBLIC DOMAIN AND 
  116.       SHAREWARE WHO PROFIT FROM THE DISTRIBUTION OF DISKS ARE SPECIFICALLY 
  117.       PROHIBITED FROM DISTRIBUTING V4L WITHOUT WRITTEN PERMISSION FROM 
  118.       P.S.G., Inc. 
  119.  
  120.       VIAL FOR LIFE             V4L.EXE Rev 4.1            Sheet 4 of 9
  121.       -----------------------------------------------------------------
  122.  
  123.       All others are encouraged to make copies of V4L and pass them along
  124.       (without charge) to their friends, associates, or acquaintances for 
  125.       the purposes of evaluation.  The self extracting V_4_L should be used 
  126.       for this purpuse. 
  127.  
  128.       WARRANTY
  129.       -------- 
  130.  
  131.       V4L is provided AS IS without any warranty, either expressed or 
  132.       implied, including but not limited to fitness for a particular 
  133.       purpose. 
  134.  
  135.       P.S.G. takes no responsibility for the data entered by the users.
  136.  
  137.       DISTRIBUTION FILES 
  138.       ------------------ 
  139.  
  140.       The following files are included in the Shareware distribution package: 
  141.  
  142.       V_4_L.EXE which contains: 
  143.             V4L.EXE        the operational program 
  144.             V4L.DOC        this document 
  145.             V4L_READ.ME    (if necessary) 
  146.             REGISTER.FRM   a registration form
  147.  
  148.       PRODUCT SUPPORT 
  149.       --------------- 
  150.  
  151.       I support my software!  I will respond to phone calls, letters, or 
  152.       telegrams.  The author/proprietor (Mike Galvin) can be reached at
  153.       (301) 299-8581. 
  154.          
  155.  
  156.       ABOUT P.S.G. 
  157.       -------------- 
  158.  
  159.       P.S.G., Inc. is the registered business name of an entity owned and
  160.       operated by William M. Galvin, jr. (me).  I am a systems engineer. 
  161.          
  162.          
  163.       TECHNICAL INFORMATION & HARDWARE/SOFTWARE REQUIREMENTS 
  164.       ------------------------------------------------------ 
  165.  
  166.       Version 4.1 is written entirely in Borland International's Turbo 
  167.       BASIC (R).  Development and initial test of the program was on an 
  168.       COMPAQ 386-20 equipped with an EGA card and monitor; plus an XT 
  169.       clone using a TURBO motherboard and mono monitor.  
  170.          
  171.       V4L is designed to operate on IBM PC/XT/AT/PS System2 and true 
  172.       compatible computer systems under PCDOS (or MSDOS) 2.0 or higher.  
  173.       It supports monochrome or color (CGA/EGA/VGA) systems and is best 
  174.       uti ized in a system with one or more hard disk drives.   
  175.  
  176.       VIAL FOR LIFE             V4L.EXE Rev 4.1            Sheet 5 of 9
  177.       -----------------------------------------------------------------
  178.  
  179.       INSTALLING V4L
  180.       --------------
  181.  
  182.       Installing and operating V4L is a straight forward process.
  183.  
  184.       Users with floppy drive systems should install the distribution
  185.       disk in drive B: and a blank, formatted disk to be used as a work
  186.       disk in drive A:.  Make the A: drive the default drive.  Enter 
  187.       "COPY B:V_4_L" from the "A>" prompt.  Put asside the distribution
  188.       disk for safe keeping.  The work disk being in the A: drive, enter
  189.       "V_4_L".  All the operating files will then be unarchived.  You
  190.       may then DELete V_4_L.  The program is then invoked by entering V4L. 
  191.  
  192.       Users with hard drives have some options.  First, you may place
  193.       the program file V4L.EXE in any directory of your choice on whatever
  194.       system drive you choose.  It is suggested that the user make a direct-
  195.       ory for V4L, for the operating files and the files V4L creates
  196.  
  197.       Place the distribution disk in the A: drive.  Make the C: the de-
  198.       fault drive and enter MD V4L to create a sub-directory named V4L.
  199.       Enter COPY A:V_4_L.  then enter V_4_L which will unarchive the needed
  200.       files  The user may begin using V4L.
  201.  
  202.       A batch file in your root directory or in a directory called out
  203.       in the user's PATH statement, named "V4L.BAT". might be used 
  204.       to call the program.  The text of the program would be something 
  205.       like:
  206.  
  207.         CD\V4L
  208.         V4L %1
  209.  
  210.       The %1 will take the customer's last name to V4L should it be en-
  211.       tered on the command line and skip the opening screen.           
  212.  
  213.       Once this is accomplished, go ahead and start V4L by typing V4L 
  214.       at the DOS command prompt.
  215.  
  216.       V4L creates a file for each customer; "I###.V4L". (### may be from 
  217.       0 to 9,999,999 which means the theoretical limit is 10,000,000
  218.       customers which is far beyond the capacity of most PC disks.  The
  219.       "I" is a holdover from INSULIN.EXE.)
  220.  
  221.       VIAL FOR LIFE             V4L.EXE Rev 4.1            Sheet 6 of 9
  222.       -----------------------------------------------------------------
  223.  
  224.       OPERATION:
  225.       ---------- 
  226.  
  227.       "V4L", the name of the program, was written with several param-
  228.       eters or "Givens" in mind.  It provides the necessary information
  229.       that a rescue squad would need in an emergency.  It grew out of
  230.       one of P.S.G.'s previously copyrighted programs, named "INSULIN",
  231.       which was designed to keep a Blood Glucose and Insulin dosage log
  232.       for the doctor's perusal.  Additionally, a cover sheet was pro-
  233.       duced that could be invaluable on the occasions that emergency 
  234.       medical assistance is required.
  235.  
  236.       It became obvious that more people than diabetics could use the 
  237.       cover sheet produced by "INSULIN".  As a result, "V4L" was written
  238.       to produce "Vile for Life" sheets, take care of anomalities in med-
  239.       ication, and insulin dosage sheets.  If a medical emergency arrises,
  240.       just hand the "Vile for Life" sheet to the paramedic and its all 
  241.       there for the doctors in the emergency room.
  242.  
  243.       Actually, two cover sheets are produced; one for the log notebook, 
  244.       and one for the "Vial for Life".      
  245.  
  246.       The cover sheet contains the following information:
  247.           1) Full name, address, phone and Sociaaal Security numbers
  248.           2) The date the form is printed
  249.           3) Age - computed at time of printout
  250.           4) Race
  251.           5) Sex
  252.           6) Weight
  253.           7) a brief medical history
  254.           8) a list of medical allergies
  255.           9) Date of last Tetanus shot
  256.          10) Hospital of Choice
  257.          11) Medications
  258.          12) Dose schedule
  259.          13) A list of doctors
  260.  
  261.       The forms are printed on standard 8 1/2 X 11" paper.  Notebooks of
  262.       that size are easy to procure.  The standard page may have 60 lines 
  263.       of text and up to 80 characters per line.  The form produced has 59
  264.       lines of text.  The 60th is reserved, so that laser printers may be 
  265.       used and not produce a blank sheet between printed sheets.  Pre-
  266.       punched three ring tractor feed paper is available.
  267.  
  268.       The form is designed to cover a week; 59/7=8 + 3 remainder.  This 
  269.       gives eight lines per day.  The three lines are used as a header.
  270.       The eight lines per day are broken down: one for the date and a prompt 
  271.       to use the left or right side and a reminder about some annivesary;
  272.       the second is used for header information, times etc.; and the last
  273.       six are used for data entry.  The form uses an area approximately
  274.       .33 X .5 inches for data entry, to assist the aging, infirm and poor 
  275.       of sight.
  276.  
  277.       VIAL FOR LIFE             V4L.EXE Rev 4.1            Sheet 7 of 9
  278.       -----------------------------------------------------------------
  279.  
  280.       No special "computer characters" are used in the printout which 
  281.       means that the widest variety of printers may be addressed.  This
  282.       leaves the form somewhat ragged but the printing time is much faster.
  283.       A neater form could have been made using the graphics mode of the
  284.       printer, but this would restrict the types of printers that could
  285.       be used and the printout would be painfully slow.
  286.  
  287.       All boxes are drawn using the "_" character.  The program issues a
  288.       carriage return without a line feed and then restrikes the areas 
  289.       that need the "_" character.
  290.  
  291.       The form is laid out in a manner requested by an endocrinologist;
  292.       with the blood glucose readings arranged horizontally so that he 
  293.       can scan the readings and look for a trend, mornings and evenings.
  294.       Space is provided to write a short summary of an event for later
  295.       perusal.
  296.  
  297.       Several items are variable as far as the program is concerned.  
  298.       The form provides room for two types of insulin; one of which  
  299.       is Regular; the other may be changed for the patient when the
  300.       form is printed, and is printed in caps.
  301.  
  302.       From time to time, daily medication for the user may be changed;
  303.       e.g., a dose of 250 mg of Dilantin daily would be hard to admin-
  304.       ister as Dilantin com s in capsules.  The solution is to take 
  305.       two on one day and three on the next.  This leaves the problem 
  306.       of remembering the day's dosage.  The program takes care of this sort 
  307.       of thing.  As a matter of fact, it will take care of up to seven of 
  308.       this type anomaly and the cycle may be made between two and thirty 
  309.       days.  (Entering a period of one day will repeat the prompt on a 
  310.       daily basis.)
  311.  
  312.       V4L will create a file for each customer named "I###.V4L".  It also
  313.       creates a master index CUSTOMER.LST.  A file named CUSTOMER.BAK is
  314.       also created after the second name is added to the list.  
  315.  
  316.       CUSTOMER.BAK is useful should an erroneous name be entered.  If the 
  317.       operator catches the error and no other names have been added, it 
  318.       is possible to step back and repair the damage.  Just delete 
  319.       CUSTOMER.LST and rename CUSTOMER.BAK as CUSTOMER.LST.  Don't worry 
  320.       about the I###.V4L file as it will be overwritten the next time a 
  321.       name is added.
  322.  
  323.       The program may be invoked in several ways.  The most obvious way is
  324.       to enter "V4L" at the DOS prompt.  The user is then led through the
  325.       intro screen to a short menu with two choices. 1) to enter a name,
  326.       and 2) to quit (a simple <ENTER> will also exit).
  327.  
  328.       The program then prompts for the customer's name.  A file will be
  329.       created if none exists and the user must enter all the data required.
  330.       <CR> may be entered if no data is needed for a given item.  Next, the
  331.       the data is scrolled in the report's form and the user is prompted
  332.       "Do you wish to modify the data?"  Entering a "Y" or "y" will take 
  333.       the user through the editor; any other key will print the "Vial for
  334.       Life" sheet.
  335.  
  336.       VIAL FOR LIFE             V4L.EXE Rev 4.1            Sheet 8 of 9
  337.       -----------------------------------------------------------------
  338.  
  339.       If the customer has a medication anomaly or is diabetic, the user
  340.       is presented prompts for the dates required for the data sheets; it
  341.       will start the printout on the previous Sunday if the date given is
  342.       not a Sunday, and run through the following Saturday if the end date
  343.       is not a Saturday.
  344.  
  345.       The second and third lines on the printout may be changed by entering 
  346.       "V4L /M" (for maintenance).  Follow the prompts.
  347.  
  348.       Obsolete files may be deleted by entering "V4L /E" for edit.
  349.       The user will be stepped through the customer list and obsolete ones
  350.       may be discarded.  The name is removed from the customer list, 
  351.       CUSTOMER.LST, and the obsolete customer file is deleted, I###.V4L.
  352.  
  353.       The reasoning for not placing these options on the main menu was
  354.       that it was felt that untrained drug store clerks could operate the 
  355.       computer to produce the sheets, but the proprietor would not want
  356.       them to remove names from the file or change the heading on the 
  357.       sheets.
  358.  
  359.       The intro screen may be bypassed by entering "V4L {last name}".
  360.       Should the user arrive at the short menu screen and be presented 
  361.       with the choice of entering either "1" or "2", the user may enter 
  362.       the custoner's LAST NAME and the program will skip to the prompt
  363.       for the customer's first name(s).
  364.  
  365.       The customer's last name should be entered letter for letter; but
  366.       the search is based on the number of letters entered.  Therefore,
  367.       the program will only look at the first six letters in its database
  368.       if "John J" is entered and find "John J.".  The program will find
  369.       "Barbara Q. Galvin" if "Barbara Q Galvin", "Barb Galvin" or "barb
  370.       galvin" is entered.  Obviously it will not match "Mike" with "Michael".
  371.  
  372.       The way it works now; if "John M. Smith" and "John C. Smith" exist 
  373.       in the database and "John Smith" is entered, the program will display 
  374.       both names, one at a time, and the operator is given the opportunity 
  375.       to select or reject the name displayed.  If both are rejected, the 
  376.       operator is given the option to add another name to the database.
  377.  
  378.       A non-formatting word processor, or for that matter, any word pro-
  379.       cessor in the ASCII mode may be used to edit the customer's file,
  380.       but there is an "editor", if you can call it that, built into V4L. 
  381.       The editor will keep any prompt if a <CR> is entered.
  382.  
  383.       Please note; there are two control characters imbedded in this file.
  384.       They are both "Control D" which may also be described as "^D" or 
  385.       ASCII "EOT" and are used to separate portions of the various items 
  386.       in the printout.  PC-WRITE (R), a shareware word processing program,
  387.       was used to edit during debug.  PC-WRITE displays "EOT" as a diamond.
  388.       WORDPERFECT was also used in an ASCII mode; it displays "EOT" as "^D". 
  389.  
  390.       Version 2.0 of INSULIN had a place on the sheets to check when the
  391.       various medication doses were administered.  It was found that the
  392.       checkoff boxes were not used and of use to any one so they have been
  393.       eliminated from the sheets produced by V4L.
  394.  
  395.       VIAL FOR LIFE             V4L.EXE Rev 4.1            Sheet 9 of 9
  396.       -----------------------------------------------------------------
  397.  
  398.       The obvious solution as to whether or not a dose had been taken was 
  399.       to lay out a days dosage in separate "piles".  If the pile was gone
  400.       then the medicine had been taken.  Multi compartmented pill boxes
  401.       don't even seem to be the answer.  Plain old PYREX nesting custard
  402.       cups work fine.  Put the full ones in one pile and the empties in 
  403.       another.  A glance, from across the room, will tell if the medicine
  404.       has been taken.  Remember to keep the custard cups out of reach of
  405.       small children.
  406.  
  407.       The program will accept lower case letters in all cases. 
  408.  
  409.       Remember to keep a fresh ribbon in the printer.
  410.  
  411.       A conversion program is needed to convert the files created in the
  412.       older "INSULIN" program.  PSG will provide "INS2V4L" upon request
  413.       if we overlooked you in this issue of V4L.
  414.  
  415.       Revision 4.2 adds the Social Security Number and date of last 
  416.       Tetanus series.  A customer's file created under Rev 4.1 will 
  417.       prompt for the added data and insert it in the proper file.  A trip 
  418.       to the local E.R. showed that this data was needed.
  419.  
  420.       PSG                                (301) 299-8581 
  421.         Mike Galvin                      9a to 5p Eastern Time 
  422.           11016 Powder Horn Drive        Mon thru Fri 
  423.              Potomac, MD 20854 
  424. 
  425.  
  426.