$TXT Created by at MNTVBB.DOMAIN.EXT (KIDS) on Wednesday, 01/20/21 at 12:41 ============================================================================= Run Date: APR 26, 2021 Designation: IVM*2*187 Package : IVM - INCOME VERIFICATION MATCH Priority: Mandatory Version : 2 SEQ #165 Status: Released Compliance Date: MAY 27, 2021 ============================================================================= Associated patches: (v)IVM*2*49 <<= must be installed BEFORE `IVM*2*187' (v)IVM*2*188 <<= must be installed BEFORE `IVM*2*187' (v)IVM*2*193 <<= must be installed BEFORE `IVM*2*187' Subject: COUNTY CODE NOT POPULATING; UNDEFINED DGMTP ERROR Category: - Routine Description: ============ Patch IVM*2.0*187 addresses 2 issues: 1.Multiple sites reported an issue with the Permanent Mailing Address COUNTY (#.117) field of the PATIENT (#2) file being removed and marked 'unspecified'. This happens when the code is processing the PID segment of an HL7 Z05, which contains the address information, and sets variable FORADDR equal to 1 if the residential address is a foreign address. When evaluating the Permanent Mailing Address County, FORADDR still equals 1 because it never gets reset. 2.Site receives an SET+16^DGMTAUD error when processing an incoming HL7 Z10 (Income Test Transmission) message. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- N/A Forms Associated: Form Name File # 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 Additional Information: N/A New Service Requests (NSRs): -------------------------- N/A Patient Safety Issues (PSIs): ----------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- 1) INC6394927 - Income Verification Match - Address Transmission Error Problem: -------- Multiple sites reported an issue with the Permanent Mailing Address COUNTY (#.117) field of the PATIENT (#2) file being removed and marked 'unspecified'. This happens when the code is processing the PID segment of an HL7 Z05, which contains the address information, and sets variable FORADDR equal to 1 if the residential address is a foreign address. When evaluating the Permanent Mailing Address County, FORADDR still equals 1 because it never gets reset. Therefore, the process does not know the permanent mailing address is a domestic address. Resolution: ----------- Modified routine IVMPREC8 and IVMPREC9 to reset the variable FORADDR prior to evaluating the PID12 segment piece that carries the updated Permanent Address County. 2) INC6015875 - Income Verification Match - SET+16^DGMTAUD Problem: -------- Sites receive an undefined error when processing an incoming HL7 Z10 (Income Test Transmission) message due to the value for the variable DGMTP not being set during the processing of the message. Resolution: ----------- Modified routine IVMCMD to NEW variable DGMTP prior to it being reset when filing an incoming Means Test update. TEST SITES: ----------- VA Pittsburgh HCS Durham VAMC Manchester VAMC North Florida/ South Georgia VAHCS Software and Documentation Retrieval Instructions: -------------------------------------------------- N/A Patch Installation: Pre/Post Installation Overview: ------------------------------- You may install this patch at any time without interruption to users. It should take less than 2 minutes to install this patch. Pre-Installation Instructions: ------------------------------ 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. It 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. The HL7 incoming/outgoing filers should be stopped. Stop All Messaging Background Processes by using the [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]. Installation Instructions: -------------------------- 1. Choose the PackMan message containing this build. Then select the INSTALL/CHECK MESSAGE PackMan option to load the build. 2. From the Kernel Installation & Distribution System menu [XPD MAIN], 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 IVM*2.0*187. B. Backup a Transport Global - This option will create a backup message of any routines or the entire build exported with this patch. When prompted for a response, select Routines: Select one of the following: B Build R Routines Enter response: Routines 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? NO//', answer NO Post-Installation Instructions: ------------------------------- The HL7 incoming/outgoing 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 and enter the scheduled date/time that was noted in the Pre-Installation instruction section above. Back-Out/Roll Back Plan: ------------------------ Prior to installing the updated KIDS package, the installer should have saved a backup of the routines in a mail message using the Backup a Transport Global [XPD BACKUP] menu option. The message containing the backed up routines can be loaded with the "Xtract PackMan" function at the Message Action prompt. The PackMan function INSTALL/CHECK MESSAGE is then used to install the backed up routines onto the VistA system. Routine Information: ==================== The second line of each of these routines now looks like: ;;2.0;INCOME VERIFICATION MATCH;**[Patch List]**;21-OCT-94;Build 3 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: IVMCMD Before: B37811469 After: B38049173 **17,33,49,187** Routine Name: IVMPREC8 Before:B300573849 After:B301595610 **5,6,12,58,73,79,102,115,121, 148,151,152,168,167,171,164, 188,187** Routine Name: IVMPREC9 Before:B112701358 After:B122224974 **34,58,115,121,151,159,167, 192,193,187** Routine list of preceding patches: 49, 188, 193 ============================================================================= User Information: Entered By : Date Entered : AUG 22, 2019 Completed By: Date Completed: APR 26, 2021 Released By : Date Released : APR 26, 2021 ============================================================================= Packman Mail Message: ===================== $END TXT