============================================================================= Run Date: SEP 14, 2026 Designation: DG*5.3*1167 Package : DG - REGISTRATION Priority: Mandatory Version : 5.3 SEQ #1025 Status: Released Compliance Date: OCT 05, 2026 ============================================================================= Associated patches: (v)DG*5.3*1143 <<= must be installed BEFORE `DG*5.3*1167' Subject: MODIFICATIONS FOR REAL-TIME ADDRESS UPDATES Category: - Routine - Data Dictionary - Enhancement (Mandatory) Description: ============ Veterans Health Information Systems and Technology Architecture (VistA) Registration, Eligibility & Enrollment (REE) patch DG*5.3*1167 is being released as a VistA sustainment patch to support the Veteran Experience Services Enrollment and Eligibility (VESEE) program. Patch DG*5.3*1167 is being released with IVM*2.0*223 in Host File DG_53_P1167.KID Patch DG*5.3*1167 modifies the TEMPORARY ADDRESS START DATE field (#.1217) and the TEMPORARY ADDRESS END DATE field (#.1218) of the PATIENT file (#2) to require the user to enter precise date values. Imprecise values are no longer allowed, for example 12/2026. The full month, day, and year date must be entered. The screen logic for entering or editing these fields on the ADDITIONAL PATIENT DEMOGRAPHIC DATA, SCREEN <1.1> screen is updated to enforce this requirement as well. After updating the mailing address on the ADDITIONAL PATIENT DEMOGRAPHIC DATA, SCREEN <1.1> screen, the user is given the option to copy the mailing address to the residential address. Both addresses are then sent to the VHA Enrollment System (VES) via the Real Time Address (RTA) Update web service when the user saves the changes. The home and office phone numbers would be included with the address fields. Since these numbers had not been validated, any existing invalidly formatted numbers would cause the update to be rejected by VES. Patch DG*5.3*1167 modifies this address copy process to no longer include the home and office phone numbers. Listing of Updates: =================== This patch makes the following enhancements to VistA REE: ********************************************************************* PART 1: DATABASE CHANGES ********************************************************************* The two (2) fields listed below are modified. The setting of the %DT variable in the Input Transform is modified to "S %DT=EX". This will enforce the requirement that the user enter in precise date values of month, day, and year. DATA NAME GLOBAL DATA ELEMENT TITLE LOCATION TYPE -------------------------------------------------------------------------- 2,.1217 TEMPORARY ADDRESS START DATE .121;7 DATE (Required) START DATE OF TEMP ADDRESS INPUT TRANSFORM: S %DT="EX" D ^%DT S X=Y K:Y<1 X I $D(X) S DFN=DA D TAD^DGLOCK LAST EDITED: JUN 05, 2026 HELP-PROMPT: Enter the date on which the patient will first be found at the temporary address indicated. DESCRIPTION: If the WANT TO ENTER A TEMPORARY ADDRESS prompt is answered YES enter the date on which the applicant will commence being contacted at the temporary address indicated, otherwise nothing may be entered. This field may not be deleted as long as the need for a temporary address is indicated. DELETE TEST: 1,0)= S DFN=DA D TADD^DGLOCK1 I '$D(X) GROUP: TAD NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER CROSS-REFERENCE: 2^AGU1^MUMPS 1)= Q 2)= Q RECORD INDEX: ADTTM1 (#595) MUMPS ACTION Short Descr: TEMPORARY ADDRESS Cross-Reference Description: This cross-reference will update the TEMPORARY ADDRESS CHANGE DT/TM field when the Temporary Address data changes for a patient. Set Logic: D TEMP^DGDDDTTM Kill Logic: D TEMP^DGDDDTTM X(1): TEMPORARY STREET [LINE 1] (2,.1211) (forwards) X(2): TEMPORARY STREET [LINE 2] (2,.1212) (forwards) X(3): TEMPORARY STREET [LINE 3] (2,.1213) (forwards) X(4): TEMPORARY CITY (2,.1214) (forwards) X(5): TEMPORARY STATE (2,.1215) (forwards) X(6): TEMPORARY ZIP CODE (2,.1216) (forwards) X(7): TEMPORARY ADDRESS START DATE (2,.1217) (forwards) X(8): TEMPORARY ADDRESS END DATE (2,.1218) (forwards) X(9): TEMPORARY ADDRESS ACTIVE? (2,.12105) (forwards) X(10): TEMPORARY ZIP+4 (2,.12112) (forwards) X(11): TEMPORARY ADDRESS PROVINCE (2,.1221) (forwards) X(12): TEMPORARY ADDRESS POSTAL CODE (2,.1222) (forwards) X(13): TEMPORARY ADDRESS COUNTRY (2,.1223) (forwards) DATA NAME GLOBAL DATA ELEMENT TITLE LOCATION TYPE -------------------------------------------------------------------------- 2,.1218 TEMPORARY ADDRESS END DATE .121;8 DATE END DATE OF TEMP ADDRESS INPUT TRANSFORM: S %DT="EX" D ^%DT S X=Y K:Y<1 X I $D(X) S DFN=DA D TAD^DGLOCK LAST EDITED: JUN 05, 2026 HELP-PROMPT: Enter the date as of which the patient will no longer be at the temporary address indicated. DESCRIPTION: If the WANT TO ENTER A TEMPORARY ADDRESS prompt is answered YES enter the date as of which the applicant will no longer be contacted at that temporary address, otherwise nothing may be entered. This field may not be deleted as long as the need for a temporary address is indicated. DELETE TEST: 1,0)= S DFN=DA D TADD^DGLOCK1 I '$D(X) GROUP: TAD NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER RECORD INDEX: ADTTM1 (#595) MUMPS ACTION Short Descr: TEMPORARY ADDRESS Cross-Reference Description: This cross-reference will update the TEMPORARY ADDRESS CHANGE DT/TM field when the Temporary Address data changes for a patient. Set Logic: D TEMP^DGDDDTTM Kill Logic: D TEMP^DGDDDTTM X(1): TEMPORARY STREET [LINE 1] (2,.1211) (forwards) X(2): TEMPORARY STREET [LINE 2] (2,.1212) (forwards) X(3): TEMPORARY STREET [LINE 3] (2,.1213) (forwards) X(4): TEMPORARY CITY (2,.1214) (forwards) X(5): TEMPORARY STATE (2,.1215) (forwards) X(6): TEMPORARY ZIP CODE (2,.1216) (forwards) X(7): TEMPORARY ADDRESS START DATE (2,.1217) (forwards) X(8): TEMPORARY ADDRESS END DATE (2,.1218) (forwards) X(9): TEMPORARY ADDRESS ACTIVE? (2,.12105) (forwards) X(10): TEMPORARY ZIP+4 (2,.12112) (forwards) X(11): TEMPORARY ADDRESS PROVINCE (2,.1221) (forwards) X(12): TEMPORARY ADDRESS POSTAL CODE (2,.1222) (forwards) X(13): TEMPORARY ADDRESS COUNTRY (2,.1223) (forwards) ********************************************************************* PART 2: ROUTINE/LOGIC CHANGES ********************************************************************* The routines DGREGCOP and DGRPCADD are modified to support the requirement that the home and office phone numbers are excluded from the fields sent to VES when the RTA webservice is enabled and the user copies the mailing address to the residential address. The routine DGREGTE2 is modified to support the requirement that the entry or edit of the temporary address start and temporary address end date does not allow partial dates. EHRM Impact Statement: ---------------------- This patch should have no EHRM impact, and can be installed at all sites, including EHRM converted sites. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- PATIENT (#2) TEMPORARY ADDRESS START DATE (#.1217) Modified TEMPORARY ADDRESS END DATE (#.1218) Modified 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: ----------------------- N/A New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: INC43015802 - Invalid data being sent to VES via the Real-time Address Update webservice. Problem: -------- When RTA Update is enabled in VistA, contact information entered and edited in the ADDITIONAL PATIENT DEMOGRAPHIC DATA, SCREEN <1.1> screen is sent to VES via a webservice. There are two (2) instances where invalid data was being sent. 1. Partial dates were allowed for The Temporary Address Start Date and Temporary Address End Date fields (for example 12/2026.) When VES received these fields, the update was rejected as VES requires full dates (MM/DD/YYYY) only. 2. Prior to patch DG*5.3*1143, which instituted the RTA Update webservice, no validation was done on phone number entry/edit. New validation rules on phone numbers were included in that patch. However, when copying the mailing address to the residential address, the home and office phone numbers were included with the address fields without any validation. As a result, invalid phone numbers sent via the RTA webservice resulted in an error and the update rejected by VES. Resolution: ----------- 1. The Temporary Address Start Date and Temporary Address End Date fields are modified to require exact date values only. The data entry screen logic is also updated to prevent partial date entry. 2. When copying the mailing address to the residential address, the home and office phone numbers are not included with the address fields being sent via the RTA Update webservice. Test Sites: ----------- VA Pittsburgh Healthcare System (PA) West Palm Beach VA Medical Center (FL) Test Sites - SNOW Change Order #: --------------------------------- VA Pittsburgh Healthcare System (PA) - CHG0773772 West Palm Beach VA Medical Center (FL) - CHG0773986 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_P1167.KID Documentation describing the new functionality is not included in this release. Documentation Title File Name --------------------------------------------------------------------- PIMS Version 5.3 ADT Technical Manual ADT_PIMS_TM.DOCX ADT_PIMS_TM.PDF Patch Installation: ------------------- Pre/Post Installation Overview: =============================== The post-install routine, DG531167P, recompiles all input templates that reference the two fields modified by this patch. NOTE: The post install routine will be deleted after installation by the KIDS build. Pre-Installation Instructions: ============================== 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]. 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. The following options should be disabled during installation: Menu Text Option Name --------- ----------- Register a Patient [DG REGISTER PATIENT] Load/Edit Patient Data [DG LOAD PATIENT DATA] View Registration Data [DG REGISTRATION VIEW] Eligibility Verification [DG ELIGIBILITY VERIFICATION] Enter a Request/Notification [FBCH ENTER REQUEST] Preregistration Menu [DGPRE PRE-REGISTER OPTION] Note: These options are automatically enabled after the patch is installed. 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_P1167.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. (ex. ) 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. You must use this option and specify what to backup; the entire Build or just Routines. The backup message can be used to restore the routines and components of the build to the pre-patch condition. i. At the Installation option menu, select Backup a Transport Global. ii. At the Select INSTALL NAME prompt, enter your build . iii. When prompted for the following, enter "R" for Routines or "B" for Build. Select one of the following: B Build (including Routines) R Routines Only Backup Type: B// iv. Enter a Host File: 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: Menu Text Option Name --------- ----------- Register a Patient [DG REGISTER PATIENT] Load/Edit Patient Data [DG LOAD PATIENT DATA] View Registration Data [DG REGISTRATION VIEW] Eligibility Verification [DG ELIGIBILITY VERIFICATION] Enter a Request/Notification [FBCH ENTER REQUEST] Preregistration Menu [DGPRE PRE-REGISTER OPTION] Press the Enter key when you are done selecting options. b. When prompted 'Enter protocols you wish to mark as 'Out Of Order':', press the Enter key. c. When prompted 'Delay Install (Minutes): (0 - 60): 0//', answer 0. Post-Installation Instructions: ------------------------------- 1. 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]. 2. 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: ------------------------ In the event a site/patch installer determines that this patch should be backed out, the site/patch installer should submit a YOUR IT Services ticket with the Enterprise Service Desk (ESD) for assistance with the procedure. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Registration;**[Patch List]**;Feb 23 2021;Build 6 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: DG531167P Before: n/a After: B2870193 **1167** Routine Name: DGREGCOP Before: B27569754 After: B25675815 **941,1127,1143,1167** Routine Name: DGREGTE2 Before:B143878628 After:B151097224 **688,754,851,1040,1143,1167** Routine Name: DGREGTED Before:B176471835 After:B182440524 **688,851,941,1014,1040,1127, 1143,1167** Routine Name: DGRPCADD Before:B132527069 After:B137380982 **489,624,688,754,887,941,1056, 1143,1167** Routine Name: DGRTAUPD Before:B208631675 After:B211955144 **1143,1167** Routine list of preceding patches: 1143 ============================================================================= User Information: Entered By : Date Entered : JUN 05, 2026 Completed By: Date Completed: SEP 14, 2026 Released By : Date Released : SEP 14, 2026 ============================================================================= Packman Mail Message: ===================== No routines included