============================================================================= Run Date: OCT 31, 2003 Designation: DG*5.3*528 Package : DG - REGISTRATION Priority: Mandatory Version : 5.3 SEQ #478 Status: Released Compliance Date: NOV 07, 2003 ============================================================================= Associated patches: (v)DG*5.3*342 <<= must be installed BEFORE `DG*5.3*528' (v)DG*5.3*498 <<= must be installed BEFORE `DG*5.3*528' (v)DG*5.3*505 <<= must be installed BEFORE `DG*5.3*528' (v)DG*5.3*507 <<= must be installed BEFORE `DG*5.3*528' (v)DG*5.3*522 <<= must be installed BEFORE `DG*5.3*528' Subject: COMBAT VETERAN ELIGIBILITY Category: - Routine - Data Dictionary - Enhancement (Mandatory) Description: ============ OVERVIEW ======== This patch is released to support the DG* name-spaced changes for the Combat Veteran Interim Solution project. The Combat Vet Interim Solution project is the initial step in implementing VHA Directive 2002-049. For a detailed description of the functionality included in this project, please refer to the Combat Vet Interim Solution Software Requirements Specification documents. These documents are located at the following URL: http://tspr.vista.med.va.gov/warboard/anotebk.asp?proj=749&Type=Active For more information on the Combat Vet program, please refer to VHA Directive 2002-049, COMBAT VETERANS ARE ELIGIBLE FOR MEDICAL SERVICES FOR 2 YEARS AFTER SEPARATION FROM MILITARY SERVICE NOTWITHSTANDING LACK OF EVIDENCE FOR SERVICE CONNECTION. FUNCTIONAL DESCRIPTION ====================== The software will evaluate veterans in the Patient (#2) file for Combat Vet status during an initial seeding of the database. It will also calculate the Combat Vet End Date - the date after which free medical care will no longer be available without proof that the medical condition is service related. Veterans who could not be evaluated during the seeding due to missing or imprecise dates will be listed in a report generated by the software installation(and queued to a non-slaved device). No report will be generated if no veterans are found that could not be evaluated due to incomplete or missing dates. A mail message will be sent to the installer when the seeding is complete. If the seeding task is interrupted it can be re-started by using the following call from the programmer prompt: >D REQUE^DG53528P The mail message that will be sent to the installer when the seeding has completed will look like this: Subj: COMBAT VET INITIAL DATA SEEDING - DG*5.3*528 [#21543] 08/14/03@10:00 2 lines From: COMBAT VET INITIAL DATA SEEDING - DG*5.3*528 In 'WASTE' basket. Page 1 -------------------------------------------------------------------------- Patient file seeding completed.... Enter message action (in WASTE basket): Ignore// A supported API will be provided for use by any package to provide a veteran's CV status and the End Date if the veteran is qualified. Please reference DBIA #4156, COMBAT VETERAN STATUS,for details regarding the API use, input parameters, and meaning of return values. Combat Vet information will be added to the patient look-up display information, as well as general Patient file APIs (VADPT*). Below is an example: Example: Select PATIENT NAME: Test, Ed 9-23-25 ########## NSC VETERAN Enrollment Priority: Category: IN PROCESS End Date: Combat Veteran Status: ELIGIBLE End Date: 10-27-2004 *** Patient Requires a Means Test *** Primary Means Test Required from AUG 28,2002 Enter to continue. Combat Vet status will be displayed on the Eligibility screen (screen #7) of Load/Edit Patient Data [DG LOAD PATIENT DATA]. The status and Combat Veteran End Date are display only fields. ELIGIBILITY STATUS DATA, SCREEN <7> TEST,HARRIET; XXX-XX-XXXX NSC VETERAN ========================================================================== [1] Patient Type: NSC VETERAN Veteran: YES Svc Connected: NO SC Percent: N/A Rated Incomp.: UNANSWERED Claim Number: UNANSWERED Folder Loc.: UNANSWERED [2] Aid & Attendance: NO Housebound: NO VA Pension: NO VA Disability: UNANSWERED Total Check Amount: NOT APPLICABLE GI Insurance: UNANSWERED Amount: UNANSWERED [3] Primary Elig Code: UNANSWERED Other Elig Code(s): NO ADDITIONAL ELIGIBILITIES IDENTIFIED Period of Service: UNANSWERED <3.1> Combat Vet Elig.: ELIGIBLE, End Date: JUN 05, 2005 [4] Service Connected Conditions as stated by applicant --------------------------------------------------- NONE STATED to CONTINUE, 1-4 or ALL to EDIT, ^N for screen N or '^' to QUIT: A new report option, Combat Vet Status Report [DG CV STATUS], will be created listing veterans whose CV status changed during a user specified timeframe. Below is an example: COMBAT VETERAN STATUS CHANGED REPORT Date: JUL 25, 2003 JUL 18, 2003 TO JUL 25, 2003 Page: 1 NAME SSN CV END DATE PRIORITY GROUP ===================== ================= ============= SAMPLE, PT1 ###-##-####P MAY 28, 2005 NONE SAMPLE, PT2 ###-##-#### DELETED!!!! NONE SAMPLE, PT3 ###-##-#### DELETED!!!! 1 SAMPLE, PT4 ###-##-#### JUN 04, 2002 3 The Appointment List [SDLIST] option is modified to add a CV flag by the name of CV eligible veterans. See patch SD*5.3*305 for details. A new entry will be added to the LTC CO-PAY EXEMPTION file (#714.1). See the patch description in EAS*1.0*36 for details. Five new entries are added to the Inconsistent Data Elements file (#38.6). Please see the Technical Description portion of this document for further details. TEST SITES: =========== Altoona Portland Louisville ASSOCIATED PATCHES: =================== DG*5.3*528 (included in the DG_53_P528.KID host file) EAS*1.0*36 (included in the DG_53_P528.KID host file) SD*5.3*305 (included in the DG_53_P528.KID host file) IB*2.0*236 (not included in host file but provides billing functionality) SOFTWARE AND DOCUMENTATION RETRIEVAL ==================================== The software for this patch is being distributed in a host file. The host file will contain three KIDS builds. Host file name: DG_53_P528.KID Builds: DG*5.3*528 EAS*1.0*36 SD*5.3*305 Documentation Updates: DG_5_3_P528_REG_UM.PDF Updates to Registration Menu User Manual DG_5_3_P528_APPT_UM.PDF Updates to Appointment Menu User Manual DG_5_3_P528_SUPV_UM.PDF Updates to Supervisor ADT Menu User Manual DG_5_3_P528_TM.PDF Updates to PIMS Technical Manual Sites may retrieve the software and documentation directly using FTP from the ANONYMOUS.SOFTWARE directory at the following OI Field Offices: Albany: ftp.fo-albany.med.va.gov Hines: ftp.fo-hines.med.va.gov Salt Lake City: ftp.fo-slc.med.va.gov * Note: Use ASCII mode when transferring the .KID file. Use Binary mode when transferring the .PDF files. The .PDF files can be read on a PC using the Adobe Acrobat Reader program. TECHNICAL DESCRIPTION ===================== The following is a summary of the changes included in this patch. For a detailed description of these changes, please refer to the Combat Vet Interim Solution Software Design Documents. These documents are found at the following URL: http://tspr.vista.med.va.gov/warboard/anotebk.asp?proj=749&Type=Active DATA DICTIONARY CHANGES: 1. PATIENT (#2) file changes: ======================= A new field, Combat Veteran End Date (#.5295) is added to the PATIENT File (#2). A new style cross-reference is added to the Combat Veteran End Date (#.5295) field which triggers an evaluation of whether or not to update the Combat Vet End Date (#.5295) field whenever any of the following fields is edited: Service Separation Date [Last] (field #.327) Combat Service Indicated? (field # .5291) Combat To Date (field # .5294) Yugoslavia Service Indicated? (field # .322019) Yugoslavia To Date (field # .322021) Somalia Service Indicated? (field # .322016) Somalia To Date (field # .322018) Persian Gulf Service? (field # .32201) Persian Gulf To Date (field # .322012) A new field, CV Edited Date (#.5296) is added to the Patient File (#2). A traditional lookup cross-reference is added to the CV Edited Date field. 2. INCONSISTENT DATA ELEMENTS (#38.6) file changes: Five new entries are added to the INCONSISTENT DATA ELEMENTS file (#38.6). These entries will add Combat Vet to the consistency checker functionality when using either the Load/Edit Patient Data [DG LOAD PATIENT DATA] or Register A Patient [DG REGISTER PATIENT] options. The new entries will be added in a post-installation routine. They are as follows: 67 - NO CV, CHECK SERV SEP DATE 68 - NO CV, CHECK COMBAT TO DATE 69 - NO CV, CHECK YUGOSLAV TO DATE 70 - NO CV, CHECK SOMALIA TO DATE 71 - NO CV, CHECK PERS GULF TO DATE 3. LTC CO-PAY EXEMPTION (#714.1) file changes: A new entry is added to the LTC CO-PAY EXEMPTION file (#714.1). Please see the description of patch EAS*1.0*36 for details. The new entry is: LTC IS SERVICE RELATED - COMBAT VET ELIGIBLE NEW OPTION: =========== Combat Vet Status Report [DG CV STATUS] - This option provides a listing of veterans who have had their CV status entered, edited or deleted during a user specified time frame. This option is included in the [DG REGISTRATION MENU] Registration Menu. ROUTINE SUMMARY: ================ The following is a list of the routine(s) included in this patch. The second line of each of these routine(s) will look like: ;;5.3;Registration;**[patch list]**;Aug 13, 1993 CHECK^XTSUMBLD results Routine name Before Patch After Patch Patch List ============ ============ =========== ========== DG53528P N/A 8087192 528 DGCV N/A 4969636 528 DGCV1 N/A 6225023 528 DGRP7 10164416 10445466 528 DGRPC2 10465527 10848653 45,69,108,121 205,218,342 387,470,467 489,505,507,528 DGRPE 24202318 24682606 32,114,139,169 175,247,190,343 397,342,454,415 489,506,244,547 522,528 DPTLK 16895547 17547025 32,72,93,73 136,157,197,232 265,277,223,327 244,513,528 VADPT0 3561431 3583728 343,342,415,489 498,528 VADPT4 19236848 19602798 343,342,528 INSTALLATION INSTRUCTIONS ========================= This patch installation should be queued to run off-hours. Users may be on the systems as long as the options listed below are placed out of service. The installation will start a seeding of the database setting the Combat Veteran End Date and CV Date Edited fields (file #2, fields .5295 and .5296) if appropriate. NOTE: If the task is interrupted it may be restarted at the programmer prompt by entering D REQUE^DG53528P. A mail message will be sent to the installer of the patch when the seeding is complete. The user will be asked for a device to print the report of Veterans who could not be evaluated due to missing or imprecise dates. NOTE: A slave printer cannot be used for this report. Installation time will vary from site to site depending upon the number of records existing in your Patient file. The times below will give you an estimation of how long the installation will take. The following installation times are taken from the test sites of this patch: SITE EVALUATED PLATFORM INSTALL TIME TOTAL RECORDS -------------- -------- ------------ ------------- Altoona NT Cache 25 min. 60430 Portland Cache 20 min. 225048 Louisville VMS 40 min 169755 1. KIDS will not install data dictionary or data changes in files that require a higher level of Fileman access than is defined for the user doing the KIDS install. To insure that all data dictionary and data changes distributed in a patch are installed correctly, DUZ(0) must be set equal to the "@" symbol. Set this variable if necessary, e.g.: >S DUZ(0)="@" 2. Download the KIDS file DG_53_P528.KID from the ANONYMOUS.SOFTWARE directory of either Albany, Hines, or the Salt Lake OIFO to the appropriate directory on your system. 3. Use the 'LOAD A DISTRIBUTION' option on the KIDS INSTALLATION menu, and enter: DG_53_P528.KID 4. Review your mapped set. If any of the routines listed in the ROUTINE SUMMARY section of patches DG*5.3*528, EAS*1.0*36 or SD*5.3*305 are mapped, they should be removed from the mapped set at this time. 5. From the 'Kernel Installation & Distribution System' menu, select the Installation menu. 6. From this menu, you may elect to u se the following options (when prompted for INSTALL NAME, enter DG*5.3*528). a. Backup a Transport Global - This option will create a backup message of any routines exported with the patch. It will NOT backup any other changes such as DDs or templates. b. Compare Transport Global to Current System - This option will allow you to view all changes that will be made when the patch is installed. It compares all components of the patch (routines, DDs, templates, etc.). c. Verify Checksums in Transport Global - This option will allow you to ensure the integrity of the routines that are in the transport global. d. Print Transport Global - This option will allow you to view the components of the KIDS build. 7. Use the Install Package(s) option and select DG*5.3*528. 8. The install will ask if you wish to rebuild menu trees. It is recommended that you answer NO to this prompt. The trees will be rebuilt the next time the system does this task. 9. When prompted 'POST INSTALL DEVICE NAME:', please answer with a valid printer. NOTE: A slave device cannot be used for the report generated by the seeding. 10. When prompted 'Want KIDS to INHIBIT Logon's during the install? YES//', it is recommended you answer NO. 11. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', respond YES. When prompted to select the options you would like to place out of order, enter the following: DG LOAD PATIENT DATA Load/Edit Patient Data DG PATIENT INQUIRY Patient Inquiry 12. If routines were unmapped as part of Step 3, they should be returned to the mapped set once the installation has run to completion. 13. If you are running Vista Imaging, use the menu option to copy the routines to the Imaging DICOM gateways as follows: "On the Vista server (hospital database), use menu option 'Copy Routines to DICOM Gateway' located under the 'Imaging System Manager' Menu. Then on all Text and Image gateways use the 'System Maintenance' menu to select Gateway Configuration and DICOM Master File and then select 'Download Current Radiology and MAS Routines'. This will cause the up-to-date versions of all radiology and MAS routines to be copied to the gateway systems." Routine Information: ==================== Routine Name: - DPTLK Routine Checksum: Routine Name: - DGRPE Routine Checksum: Routine Name: - DG53528P Routine Checksum: Routine Name: - DGCV Routine Checksum: Routine Name: - DGCV1 Routine Checksum: Routine Name: - DGRPC2 Routine Checksum: Routine Name: - VADPT0 Routine Checksum: Routine Name: - VADPT4 Routine Checksum: Routine Name: - DGRP7 Routine Checksum: ============================================================================= User Information: Entered By : CURTIN,EDNA Date Entered : JUN 04, 2003 Completed By: MORGAN,BRIAN Date Completed: OCT 31, 2003 Released By : NELSON,VICKI M Date Released : OCT 31, 2003 ============================================================================= Packman Mail Message: ===================== No routines included