============================================================================= Run Date: MAY 14, 2020 Designation: DG*5.3*996 Package : DG - REGISTRATION Priority: EMERGENCY Version : 5.3 SEQ #875 Status: Released Compliance Date: MAY 19, 2020 ============================================================================= Associated patches: (v)DG*5.3*858 <<= must be installed BEFORE `DG*5.3*996' (v)DG*5.3*904 <<= must be installed BEFORE `DG*5.3*996' (v)DG*5.3*952 <<= must be installed BEFORE `DG*5.3*996' (v)DG*5.3*978 <<= must be installed BEFORE `DG*5.3*996' Subject: EHBD - NEAR LIST, HARDSHIP, PREFERRED NAME Category: - Routine - Data Dictionary - Enhancement () Description: ============ Patch DG*5.3*996 is being released to support the enhancements for the Enterprise Health Benefits Determination (EHBD) program that focuses on updates for the Enrollment System Modernization (ESM) Phase 2 project. Patch DG*5.3*996 is also being released in support of the Enrollment System (ES) 5.10 release. Refer to Informational Patch EAS*1*186 (Enrollment Application System) for additional details regarding the ES release. NOTE: DG*5.3*996 is being released with IVM*2.0*190 in Host File DG_53_P996.KID. IMPORTANT: The deployment will be a simultaneous rollout and facilities will have three (3) days to plan and to schedule installation of the software. Veterans Health Information Systems and Technology Architecture (VistA) Registration, Eligibility & Enrollment (REE) patch DG*5.3*996 removes the Hardship Review Date prompt from the Hardships [DGMTH HARDSHIPS] option. The date is automatically set to be December 31 of the current calendar year. This patch, DG*5.3*996, modifies the user display to present a message when (1) the Edit Hardship [DGMTH EDIT HARDSHIP} or Delete Hardship [DGMTH DELETE HARDSHIP] protocols are invoked AND (2) the site granting the hardship is 200ESR. The following message is displayed: A Hardship has been granted for . Only the site granting the Hardship may edit it. Please, contact ENROLLMENT SYSTEM REDESIGN to edit the record. Patch DG*5.3*996 updates the HARDSHIP REVIEW DATE (#.21) field of the ANNUAL MEANS TEST (#408.31) file to be UNEDITABLE. Patch DG*5.3*996 modifies the APPOINTMENT REQUEST ON 1010EZ field (#1010.159) of the PATIENT file (#2). The cross-reference trigger which updates the ORIGINAL APPOINTMENT REQUEST field (#1010.1512) of the PATIENT file (#2) will only set that field when the value of the APPOINTMENT REQUEST ON 1010EZ field (#1010.159) of the PATIENT file (#2) is 1. The help text associated with the trigger is updated to describe the behavior. Patch DG*5.3*996 modifies the APPOINTMENT REQUEST DATE field (#1010.1511) of the PATIENT file (#2). The cross-reference trigger which updates the ORIGINAL APPT REQUEST DATE field (#1010.1513) of the PATIENT file (#2) will only set that field when the value of the APPOINTMENT REQUEST ON 1010EZ field (#1010.159) of the PATIENT file (#2) is 1. The help text associated with the trigger is updated to describe the behavior. This patch introduces a new registration Application Programmer Interface (API), DEM^VADPT. Upon installation of this patch, the API will be available to downstream applications via Integration Control Registration (ICR) 7109. ICR 7109 is in addition to existing ICR 10061. The new API will return the basic demographic data with the addition of patient's preferred name. Patch DG*5.3*996 fixes an error in the ES Health Level 7 (HL7) interface with VistA. The error is encountered when VistA receives an HL7 ORU-Z11/ORF-Z11 message from ES with a VHA Profile in the ZHP segment that does not exist in VistA. With this patch, when a VHA Profile that does not exist in VistA is encountered, message processing is stopped, the error is trapped, and an error message is returned to ES. Listing of Updates: =================== This patch makes the following enhancements to VistA REE: PART 1: Hardship =========================================== 1. When Grant Hardship (GH) is selected via the Hardships option [DGMTH HARDSHIPS] of the Means Test User Menu [DG MEANS TEST USER MENU], the prompt for "Hardship Review Date:" is no longer displayed. Begin Screen Capture Select Action:Quit// GH Grant Hardship Means Test Status: GMT COPAY REQUIRED// Hardship Effective Date: (JUL 11, 2019-JUL 12, 2019): Hardship Reason: End Screen Capture 2. If a user selects to Edit Hardship (EH) or Delete Hardship (DH) via the Hardships option [DGMTH HARDSHIPS] of the Means Test User Menu [DG MEANS TEST USER MENU] and does not have the appropriate security key to do so the following message is displayed: "PLEASE USE ES TO EDIT HARDSHIP". Begin Screen Capture Hardship Determinations Page: 1 of 2 Patient: TESTPATIENT,ONE (XXXX) NSC VETERAN Hardship Current Means Test Status: MT COPAY REQUIRED Income Year: 2018 Means Test Date: OCT 12, 2019 Agreed To Pay Deductible: YES Hardship?: YES Hardship Effective Date: OCT 12, 2019 Review Date: DEC 31, 2019 Hardship Expiration Date: DEC 31, 2019 Site Granting Hardship: Approved By: Hardship Reason: Paid out-of-pocket medical Date Category Last Changed: + Enter ?? for more actions GH Grant Hardship EC Edit Comments EH Edit Hardship DH Delete Hardship Select Action:Next Screen// Please use ES to Edit Hardship End Screen Capture 3. The HARDSHIP REVIEW DATE (#.21) field of the ANNUAL MEANS TEST (#408.31) file is set to UNEDITABLE. PART 2: NEAR Tracking Report ============================ 1. The NEAR Tracking Report (Detailed) is modified to remove the ORIGINAL APPT. REQUEST column. This column was originally displayed after the APPT. REQUEST column. The NAME column is expanded 10 characters and the preceding columns are shifted over 10 characters. No other field lengths are changed: Begin Screen Capture NEW ENROLLEE APPOINTMENT REQUEST TRACKING REPORT Date: NOV 08, 2019 AUG 22, 2011 TO NOV 08, 2019 Page: 1 SCHEDULED APPT. APPT. # REQ NAME EP/CV REQUEST DATE DAYS STA ====================================== ===== ========= ========= ==== === DGPATIENT1(1988) 5/ 04/11/19 211* DGPATIENT2(9202) 5/ 05/08/19 184* DGPATIENT3(1989) 5/ 05/08/19 184* DGPATIENT4(3210) 5/ 05/16/19 176* DGPATIENT5(5934) 05/31/19 161* DGPATIENT6(5050) 5/ 04/30/19 192* I COMMENT: TESTING INPROCESS AFTER FILLED DGPATIENT7(9876) 5/ 04/10/19 212* F DGPATIENT8(1234) 5/ 04/23/19 05/13/19 20 F COMMENT: TESTING EWL<>AutoComm:EWL|FILLED DGPATIENT9(2314) 5/ 04/30/19 07/28/19 89 F COMMENT: TESTING DGPATIENT10(5432) 5/ 05/08/19 05/24/19 16 F COMMENT: AutoComm:null|FILLED by Scheduling DGPATIENT11(3456) 5/ 05/15/19 06/25/19 41 F Type to continue or '^' to exit: End Screen Capture 2. The APPOINTMENT REQUEST ON 1010EZ field (#.1010.159) of the PATIENT file (#2) is modified. The cross-reference trigger which updates the ORIGINAL APPOINTMENT REQUEST field (#1010.1512) of the PATIENT file (#2) will only set that field when the value of the APPOINTMENT REQUEST ON 1010EZ field (#1010.159) is 1 (which represents a YES). The help text associated with the trigger is updated to describe the behavior. 3. The APPOINTMENT REQUEST DATE field (#.1010.1511) of the PATIENT file (#2) is modified. The cross-reference trigger which updates the ORIGINAL APPT REQUEST DATE field (#1010.1513) of the PATIENT file (#2) will only set that field when the value of the APPOINTMENT REQUEST ON 1010EZ field is 1 (which represents a YES). The help text associated with the trigger is updated to describe the behavior. 4. The ORIG APPT REQUEST CHG DT/TM field (#1010.1514) of the PATIENT file (#2) is updated by fields ORIGINAL APPT REQUEST and ORGINAL APPT REQUEST DATE above when they are modified. PART 3: Preferred Name Phase 2 ============================== 1. Integration Control Registration (ICR) 7109 (DEMUPD^VADPT) is created and is to allow other/downstream applications to obtain the patient's PREFERRED NAME field (#.2405) of the PATIENT file (#2) along with basic patient demographic data. . ICR 7109 is in addition to, and does not replace, existing ICR 10061. ICR 7109 NAME: VADPT CUSTODIAL PACKAGE: REGISTRATION SUBSCRIBING PACKAGE: USAGE: Supported ENTERED: NOV 26,2019 STATUS: Active EXPIRES: 2. The PIMS Technical Manual documents the input and output variables of the VADPT API and is updated with this modification, DEMUPD^VADPT. The PREFERRED NAME is stored in the (1,1) node of the VADEMO array. VADEMO Array Definition Table ============================= Node # Item stored Example ====== =========== ======= 1 Name PSEUDO,TEST TESTING 1,1 Preferred Name NICKNAME PSEUDO 2 Social Security Number #########P^###-##-####P (internal^external format) 3 Date of Birth 2920229^FEB 29,1992 (internal^external format) 4 Age 27 5 Sex F^FEMALE (internal^external format) 6 Expired Date 3160303^MAR 3,2016 (internal^external format) 7 Remarks [PATIENT DIED ON 03/03/16] 8 Historic Race 3^WHITE, NOT OF HISPANIC ORIGIN (internal^external format) 9 Religion 104^AGNOSTICISM (internal^external format) 10 Marital Status 6^NEVER MARRIED (internal^external format) 11 Number of Ethnicity entries 1 11,1 Ethnicity 2^NOT HISPANIC OR LATINO (internal^external format) 11,1,1 Collection Method 1^SELF IDENTIFICATION (internal^external format) 12 Number of Race entries 1 12,1 Race 13^WHITE (internal^external format) 12,1,1 Collection Method 1^SELF IDENTIFICATION (internal^external format) 13 Current Preferred Language 3190626.1553^JUN 26,2019@15:53 Time and Date entered (internal^external format) 13,1 Patient Current Preferred 1^ENGLISH Language (internal^external format) Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- PATIENT file (#2) APPOINTMENT REQUEST ON Modified 1010EZ (#.1010.159) APPOINTMENT REQUEST DATE Modified (#.1010.1511) ANNUAL MEANS TEST HARDSHIP REVIEW DATE (#.21) Modified (#408.31) Forms Associated: Form Name File Number New/Modified/Deleted --------- ----------- -------------------- N/A Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- N/A Options Associated: Option Name Type New/Modified/Deleted ----------- ---- -------------------- N/A Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- N/A Security Keys Associated: Security Key Name ----------------- N/A Templates Associated: Template Name Type File Name (Number) New/Modified/Deleted ------------- ---- ------------------ -------------------- N/A Remote Procedures Associated: Remote Procedure Name New/Modified/Deleted --------------------- -------------------- N/A Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- N/A Additional Information: ----------------------- New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: 1. Rational Team Concert (RTC) Defect #1214484: When ES sends a VHA Profile to VistA, VistA code is not processing the error when a VHA Profile doesn't exist in VistA. Problem: -------- When ES sends a VHA Profile to VistA, VistA code is not processing the error when a VHA Profile doesn't exist in VistA. A hard error is encountered and the following error is placed in the error trap: HL7UPD+5^DGHBPUTL *ADDHBP() Subscript 1 is "" Resolution: ----------- Once an invalid plan is encountered, message processing is stopped, the error is trapped, and an error message is returned to ES. Test Sites: ----------- Alaska VA Healthcare System, Anchorage, AK El Paso VA Health Care System, El Paso, TX Jesse Brown VA Medical Center, Chicago, IL Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released using a host file. The host file is available at the following location: /srv/vista/patches/SOFTWARE/DG_53_P996.KID Documentation describing the new functionality is included in this release. Documentation can be found on the VA Software Documentation Library at: https://www.domain.ext/vdl/ Documentation Title File Name --------------------------------------------------------------- DG_53_P996.KID Release Notes DG_5_3_P996_RN.PDF PIMS Technical Manual PIMSTM.PDF User Manual - Appointment Menu APPT.PDF User Manual - Registration Menu PIMS_REG_UM.PDF User Manual - Means Test Supervisor Menu MTS_UM.PDF Patch Installation: Pre/Post Installation Overview: ------------------------------- N/A Pre-Installation Instructions: ------------------------------ 1. This patch should NOT be installed while the IVM BACKGROUND JOB [IVM BACKGROUND JOB] is running. The IVM BACKGROUND JOB [IVM BACKGROUND JOB] should be unscheduled. Use the Schedule/Unschedule Options [XUTM SCHEDULE] option on the Taskman Management [XUTM MGR] menu. Note the currently scheduled date/time. 2. The HL7 incoming/outgoing filers should be stopped. Use the Stop All Messaging Background Processes [HL STOP ALL] option on the Filer and Link Management Options [HL MENU FILER LINK MGT] menu on the HL7 Main Menu [HL MAIN MENU]. 3. The following options should be disabled during installation: Register a Patient [DG REGISTER PATIENT] Load/Edit Patient Data [DG LOAD PATIENT DATA] View Registration Data [DG REGISTRATION VIEW] Patient Inquiry [DG PATIENT INQUIRY] Eligibility Verification [DG ELIGIBILITY VERIFICATION] Admit a Patient [DG ADMIT PATIENT] Copay Exemption Test User Menu [DG CO-PAY TEST USER MENU] Means Test User Menu [DG MEANS TEST USER MENU] 4. This patch may be installed with users on the system; although it is recommended that it be installed during non-peak hours to minimize potential disruption to users. This patch should take less than 5 minutes to install. Installation Instructions: ------------------------- 1. Use the Load a Distribution option contained on the Kernel Installation and Distribution System Menu to load the Host file. When prompted to "Enter a Host File:" enter /srv/vista/patches/SOFTWARE/DG_53_P996.KID 2. From the Kernel Installation and Distribution System Menu, select the Installation Menu. From this menu, A. Select the Verify Checksums in Transport Global option to confirm the integrity of the routines that are in the transport global. When prompted for the INSTALL NAME enter the patch or build name DG*5.3*996. NOTE: Using will not bring up a Multi-Package build even if it was loaded immediately before this step. It will only bring up the last patch in the build. B. Select the Backup a Transport Global option to create a backup message of any routines exported with this patch. It will not backup any other changes such as DDs or templates. C. You may also elect to use the following options: i. Print Transport Global - This option will allow you to view the components of the KIDS build. ii. Compare Transport Global to Current System - This option will allow you to view all changes that will be made when this patch is installed. It compares all of the components of this patch, such as routines, DDs, templates, etc. D. Select the Install Package(s) option and choose the patch to install. i. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//', answer NO. ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer NO. iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', answer YES. a. When prompted 'Enter options you wish to mark as 'Out Of Order':', select the following option: Option Name Menu Text ----------- --------- Register a Patient [DG REGISTER PATIENT] Load/Edit Patient Data [DG LOAD PATIENT DATA] View Registration Data [DG REGISTRATION VIEW] Patient Inquiry [DG PATIENT INQUIRY] Eligibility Verification [DG ELIGIBILITY VERIFICATION] Admit a Patient [DG ADMIT PATIENT] Copay Exemption Test User Menu [DG CO-PAY TEST USER MENU] Means Test User Menu [DG MEANS TEST USER MENU] b. When prompted 'Enter protocols you wish to mark as 'Out Of Order':', press the Enter key. c. If prompted 'Delay Install (Minutes): (0 - 60): 0//', respond 0. Post-Installation Instructions: ------------------------------- The HL7 incoming filers should be restarted. Use the Restart/Start All Links and Filers [HL TASK RESTART] option on the Filer and Link Management Options [HL MENU FILER LINK MGT] menu on the HL7 Main Menu [HL MAIN MENU]. The IVM BACKGROUND JOB [IVM BACKGROUND JOB] should be rescheduled. Use the Schedule/Unschedule Options [XUTM SCHEDULE] option on the Taskman Management [XUTM MGR] menu. Back-Out/Roll Back Plan: ------------------------ In the event a site determines that this patch should be backed out, the site should submit a YOUR IT Services ticket with the ESD for assistance with the procedure. Any issues would need to be evaluated to determine if: a back-out of the software is appropriate; a new patch is needed; or if data requires correction or restoration. During installation, if the option to back up routines was run as directed, "Backup a Transport Global", then routines will have the ability to be restored from the "backup" MailMan message that was generated. However, the KIDS installation process does not perform a backup of other VistA software components, such as DD, cross-reference, and template changes. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Registration;**[Patch List]**;08/13/93;Build 47 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: DGENACL1 Before: B63749530 After: B62338339 **779,788,978,996** Routine Name: DGENUPL1 Before: B68704106 After: B70228219 **147,222,232,314,397,379,407, 363,673,653,688,797,842,894, 871,935,959,975,972,952,996** Routine Name: DGMTA Before: B44199650 After: B45774260 **33,45,137,166,177,182,290, 344,332,433,458,535,612,564, 688,661,840,972,996** Routine Name: DGMTHL1 Before: B64633533 After: B89834731 **182,456,536,858,996** Routine Name: DGMTU23 Before: B32516892 After: B32393864 **33,182,254,272,420,435,456, 624,904,996** Routine Name: VADPT Before: B16811812 After: B17534834 **193,343,389,415,489,498,688, 754,887,996** Routine Name: VADPT0 Before: B13669085 After: B15089633 **343,342,415,489,498,528,689, 789,688,759,754,887,952,996** Routine list of preceding patches: 858, 904, 952, 978 ============================================================================= User Information: Entered By : Date Entered : OCT 17, 2019 Completed By: Date Completed: MAY 14, 2020 Released By : Date Released : MAY 14, 2020 ============================================================================= Packman Mail Message: ===================== No routines included