============================================================================= Run Date: AUG 10, 2020 Designation: IVM*2*193 Package : IVM - INCOME VERIFICATION MATCH Priority: EMERGENCY Version : 2 SEQ #158 Status: Released Compliance Date: AUG 13, 2020 ============================================================================= Associated patches: (v)IVM*2*5 <<= must be installed BEFORE `IVM*2*193' (v)IVM*2*180 <<= must be installed BEFORE `IVM*2*193' (v)IVM*2*190 <<= must be installed BEFORE `IVM*2*193' (v)IVM*2*192 <<= must be installed BEFORE `IVM*2*193' Subject: NOK/E-CONTACT ADD FOREIGN ADDRESS, HARDSHIP EXPIRATION Category: - Routine - Enhancement () - Data Dictionary Description: ============ ********************************************************************** * * * IMPORTANT: * * * * This patch is being released with a priority of "EMERGENCY" and * * has a 3-day compliance installation requirement. * * * ********************************************************************** Patch IVM*2.0*193 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 3 project. Patch IVM*2.0*193 is also being released in support of the Enrollment System (ES) 5.12 release. Refer to Informational Patch Enrollment Application System EAS*1*191 for additional details regarding the ES release. NOTE: IVM*2.0*193 is being released with DG*5.3*997 in Host File DG_53_P997.KID. Patch IVM*2.0*193 populates the VistA Health Level 7 (HL7) ORU-Z07 message to send foreign address data for patient associate contacts to ES. The associates are Next of Kin, Next of Kin 2, Emergency Contact, Emergency Contact 2, and Designee. Patch IVM*2.0*193 adds 15 entries to the IVM DEMOGRAPHIC UPLOAD FIELDS file (#301.92) which is used to map the HL7 fields to the fields in the VistA database. Patch IVM*2.0*193 updates the HL7 ORU/ORF-Z10 and the ORU/ORF-Z07 messages with the addition of HARDSHIP EXPIRATION DATE in sequence 32 of the ZMT segment. This data will be stored in the HARDSHIP EXPIRATION DATE (#2.13) field of the ANNUAL MEANS TEST (#408.31) file. Listing of Updates ================== This patch makes the following enhancements to VistA REE: 1. The ZCT segment (VA Specific Emergency Contact) includes foreign address data in the CONTACT ADDRESS (SEQ 5). The foreign address fields are in the structure as follows: a. Component 6 contains the Country Code. The value is the CODE field (#.01) of the COUNTRY CODE file (#779.004). b. For Country Code not "USA", component 4 contains the Province field. c. For Country Code not "USA", component 5 contains the Postal Code field. 2. The routines responsible for receiving associate address data from ES in the ORU-Z05 HL7 message are modified to receive foreign address data in the ZCT segment and store the data into VistA. 3. The HL7 LOCATION field (#.02) in the IVM DEMOGRAPHIC UPLOAD FIELDS file (#301.92) is modified to increase the maximum length to 10 characters. 4. 15 entries are added to the IVM DEMOGRAPHIC UPLOAD FIELDS file (#301.92). These entries are used to map the address data fields in the ZCT segment to the VistA database fields. The data is provided in the build with the full data dictionary of the IVM DEMOGRAPHIC UPLOAD FIELDS file (#301.92). DHCP FIELD NAME: K-POSTAL CODE HL7 LOCATION: ZCT055K1F UPLOADABLE DEMOGRAPHIC FIELD: YES DHCP FILE: PATIENT DHCP FIELD NUMBER: .223 ADDRESS FIELD?: NO DHCP LOCATION LOGIC: S DR=.223 D LOOK^IVMPREC9 DHCP OUTPUT LOGIC: S DR=.223 D LOOK^IVMPREC9 DHCP FIELD NAME: K-PROVINCE HL7 LOCATION: ZCT054K1F UPLOADABLE DEMOGRAPHIC FIELD: YES DHCP FILE: PATIENT DHCP FIELD NUMBER: .222 ADDRESS FIELD?: NO DHCP LOCATION LOGIC: S DR=.222 D LOOK^IVMPREC9 DHCP OUTPUT LOGIC: S DR=.222 D LOOK^IVMPREC9 DHCP FIELD NAME: K-COUNTRY HL7 LOCATION: ZCT056K1 UPLOADABLE DEMOGRAPHIC FIELD: YES DHCP FILE: PATIENT DHCP FIELD NUMBER: .221 ADDRESS FIELD?: NO DHCP LOCATION LOGIC: S DR=.221 D LOOK^IVMPREC9 DHCP OUTPUT LOGIC: S DR=.221 D LOOK^IVMPREC9 DHCP FIELD NAME: K2-POSTAL CODE HL7 LOCATION: ZCT055K2F UPLOADABLE DEMOGRAPHIC FIELD: YES DHCP FILE: PATIENT DHCP FIELD NUMBER: .2103 ADDRESS FIELD?: NO DHCP LOCATION LOGIC: S DR=.2103 D LOOK^IVMPREC9 DHCP OUTPUT LOGIC: S DR=.2103 D LOOK^IVMPREC9 DHCP FIELD NAME: K2-PROVINCE HL7 LOCATION: ZCT054K2F UPLOADABLE DEMOGRAPHIC FIELD: YES DHCP FILE: PATIENT DHCP FIELD NUMBER: .2102 ADDRESS FIELD?: NO DHCP LOCATION LOGIC: S DR=.2102 D LOOK^IVMPREC9 DHCP OUTPUT LOGIC: S DR=.2102 D LOOK^IVMPREC9 DHCP FIELD NAME: K2-COUNTRY HL7 LOCATION: ZCT056K2 UPLOADABLE DEMOGRAPHIC FIELD: YES DHCP FILE: PATIENT DHCP FIELD NUMBER: .2101 ADDRESS FIELD?: NO DHCP LOCATION LOGIC: S DR=.2101 D LOOK^IVMPREC9 DHCP OUTPUT LOGIC: S DR=.2101 D LOOK^IVMPREC9 DHCP FIELD NAME: E-POSTAL CODE HL7 LOCATION: ZCT055E1F UPLOADABLE DEMOGRAPHIC FIELD: YES DHCP FILE: PATIENT DHCP FIELD NUMBER: .3308 ADDRESS FIELD?: NO DHCP LOCATION LOGIC: S DR=.3308 D LOOK^IVMPREC9 DHCP OUTPUT LOGIC: S DR=.3308 D LOOK^IVMPREC9 DHCP FIELD NAME: E-PROVINCE HL7 LOCATION: ZCT054E1F UPLOADABLE DEMOGRAPHIC FIELD: YES DHCP FILE: PATIENT DHCP FIELD NUMBER: .3307 ADDRESS FIELD?: NO DHCP LOCATION LOGIC: S DR=.3307 D LOOK^IVMPREC9 DHCP OUTPUT LOGIC: S DR=.3307 D LOOK^IVMPREC9 DHCP FIELD NAME: E-COUNTRY HL7 LOCATION: ZCT056E1 UPLOADABLE DEMOGRAPHIC FIELD: YES DHCP FILE: PATIENT DHCP FIELD NUMBER: .3306 ADDRESS FIELD?: NO DHCP LOCATION LOGIC: S DR=.3306 D LOOK^IVMPREC9 DHCP OUTPUT LOGIC: S DR=.3306 D LOOK^IVMPREC9 DHCP FIELD NAME: E2-POSTAL CODE HL7 LOCATION: ZCT055E2F UPLOADABLE DEMOGRAPHIC FIELD: YES DHCP FILE: PATIENT DHCP FIELD NUMBER: .331014 ADDRESS FIELD?: NO DHCP LOCATION LOGIC: S DR=.331014 D LOOK^IVMPREC9 DHCP OUTPUT LOGIC: S DR=.331014 D LOOK^IVMPREC9 DHCP FIELD NAME: E2-PROVINCE HL7 LOCATION: ZCT054E2F UPLOADABLE DEMOGRAPHIC FIELD: YES DHCP FILE: PATIENT DHCP FIELD NUMBER: .331013 ADDRESS FIELD?: NO DHCP LOCATION LOGIC: S DR=.331013 D LOOK^IVMPREC9 DHCP OUTPUT LOGIC: S DR=.331013 D LOOK^IVMPREC9 DHCP FIELD NAME: E2-COUNTRY HL7 LOCATION: ZCT056E2 UPLOADABLE DEMOGRAPHIC FIELD: YES DHCP FILE: PATIENT DHCP FIELD NUMBER: .331012 ADDRESS FIELD?: NO DHCP LOCATION LOGIC: S DR=.331012 D LOOK^IVMPREC9 DHCP OUTPUT LOGIC: S DR=.331012 D LOOK^IVMPREC9 DHCP FIELD NAME: D-POSTAL CODE HL7 LOCATION: ZCT055D1F UPLOADABLE DEMOGRAPHIC FIELD: YES DHCP FILE: PATIENT DHCP FIELD NUMBER: .34014 ADDRESS FIELD?: NO DHCP LOCATION LOGIC: S DR=.34014 D LOOK^IVMPREC9 DHCP OUTPUT LOGIC: S DR=.34014 D LOOK^IVMPREC9 DHCP FIELD NAME: D-PROVINCE HL7 LOCATION: ZCT054D1F UPLOADABLE DEMOGRAPHIC FIELD: YES DHCP FILE: PATIENT DHCP FIELD NUMBER: .34013 ADDRESS FIELD?: NO DHCP LOCATION LOGIC: S DR=.34013 D LOOK^IVMPREC9 DHCP OUTPUT LOGIC: S DR=.34013 D LOOK^IVMPREC9 DHCP FIELD NAME: D-COUNTRY HL7 LOCATION: ZCT056D1 UPLOADABLE DEMOGRAPHIC FIELD: YES DHCP FILE: PATIENT DHCP FIELD NUMBER: .34012 ADDRESS FIELD?: NO DHCP LOCATION LOGIC: S DR=.34012 D LOOK^IVMPREC9 DHCP OUTPUT LOGIC: S DR=.34012 D LOOK^IVMPREC9 5. With installation of patch IVM*2.0*193, VistA receives and places sequence 32 HARDSHIP EXPIRATION DATE from the HL7 ORU/ORF-Z10 message into the EXPIRATION DATE (#2.13) field of the ANNUAL MEANS TEST (#408.31) file. An ORF/ORU-Z07 message is returned with the HARDSHIP EXPIRATION DATE (#2.13) field of the ANNUAL MEANS TEST (#408.31) file in sequence 32 of the ZMT segment. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- IVM DEMOGRAPHIC UPLOAD HL7 LOCATION (#.02) Modified FIELDS file (#301.92) 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: ----------------------- Blood Bank Team Coordination: N/A New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: RTC # Problem/Resolution: ----- ------------------- 1242011 Problem: IVM Demographic Upload Fields file (#301.92) may contain different Internal Entry Numbers (IENs) due to installing patch DG*5.3*941 more than once. These IENs should be standard within this file. The error "INIT+31^IVMLDEM3 *Y" may be encountered when running the [IVM UPLOAD DEM] Demographics Upload menu option due to this condition. Resolution: A pre-install routine IVM2193P is run in patch IVM*2.0*193 that checks if patch DG*5.3*941 has been installed more than once. If so, the routine performs a cleanup on the IVM DEMOGRAPHIC UPLOAD FIELDS file (#301.92) file to remove all IENs greater than 150. The IVM DEMOGRAPHIC UPLOAD FIELDS file (#301.92) is replaced by patch IVM*2.0*193 and a code modification is made to prevent the UNDEF error occurring. Test Sites: ----------- Durham VA Medical Center, Durham, NC VA North Florida/South Georgia VA Health System (Gainesville, Lake City), FL West Palm Beach VA Medical Center, West Palm Beach, FL 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_P997.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_P997.KID Release Notes DG_5_3_P997_RN.PDF IVM Technical Manual IVM_2_TM.PDF IVM User Manual IVM_2_UM.PDF Patch Installation: Pre/Post Installation Overview: ------------------------------- N/A Pre-Installation Instructions: ------------------------------ N/A Installation Instructions: -------------------------- Please see the Patch Description for patch DG*5.3*997 for installation instructions. Post-Installation Instructions: ------------------------------- N/A Back-Out/Roll Back Plan: ------------------------ Please see the Patch Description for patch DG*5.3*997 for the Back-Out/Roll Back Plan. Routine Information: ==================== The second line of each of these routines now looks like: ;;2.0;INCOME VERIFICATION MATCH;**[Patch List]**;21-OCT-94;Build 29 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: IVM2193P Before: n/a After: B2644994 **193** Routine Name: IVMCM6 Before:B116189198 After:B127306969 **17,25,39,44,50,53,49,58,62, 67,84,115,136,190,193** Routine Name: IVMCZMT Before: B60732106 After: B62719533 **17,53,49,58,81,89,104,105,160,193** Routine Name: IVMLDEM3 Before: B21236131 After: B21780421 **5,193** Routine Name: IVMPREC6 Before:B200375572 After:B207279828 **3,4,12,17,34,58,79,102,115, 140,144,121,151,152,165,167, 171,164,188,192,193** Routine Name: IVMPREC9 Before:B106557497 After:B112701358 **34,58,115,121,151,159,167,192,193** Routine Name: IVMPTRN9 Before: B55375213 After: B57413373 **9,11,19,12,21,17,46,50,53, 34,49,58,79,99,116,105,115,152, 160,164,180,193** Routine list of preceding patches: 5, 180, 190, 192 ============================================================================= User Information: Entered By : Date Entered : MAR 06, 2020 Completed By: Date Completed: AUG 10, 2020 Released By : Date Released : AUG 10, 2020 ============================================================================= Packman Mail Message: ===================== No routines included