$TXT Created by at DEVEVC.DOMAIN.EXT (KIDS) on Monday, 03/15/21 at 16:06 ============================================================================= Run Date: APR 22, 2021 Designation: DG*5.3*1040 Package : DG - REGISTRATION Priority: Mandatory Version : 5.3 SEQ #912 Status: Released Compliance Date: MAY 22, 2021 ============================================================================= Associated patches: (v)DG*5.3*993 <<= must be installed BEFORE `DG*5.3*1040' (v)DG*5.3*1014 <<= must be installed BEFORE `DG*5.3*1040' Subject: UPDATE VISTA REE ADDRESS ENTRY TO MEET M STANDARDS AND CONVENTIONS Category: - Routine Description: ============ Veterans Health Information Systems and Technology Architecture (VistA) Registration, Eligibility & Enrollment (REE) patch DG*5.3*1040 is being released to support enhancements for the Enterprise Health Benefits Determination (EHBD) program. This patch focuses on updates for the Enrollment System Modernization (ESM) Phase 3 project. Patch DG*5.3*1040 includes functionality to bring the address entry sections of the ADDITIONAL PATIENT DEMOGRAPHIC DATA, SCREEN <1.1> screen into compliance with the M Programming Standards and Conventions (version effective date 10/01/2020) regarding the VistA Timeout conditions. Prior to patch DG*5.3*1040, the VistA timeout exceptions during Patient Address Entry were handled in different ways depending on where in the prompt sequence the user timed out and which of the four address types was being entered/edited. Research into the issue determined that timeout conditions during address entry/edit were not handled in accordance with the current Standards and Conventions (SAC) Standard, Section 3.1.5, which reads: "3.1.5. The program must return to the Menu Manager with no more than one intervening read when a user input READ command times out if the argument of the read is in any way evaluated by the application. A timeout at the menu level must halt through H^XUS." To comply with this standard, as well as maintain the Cybersecurity Risk Information Sharing Program (CRISP) requirements for security of Personally Identifiable Information (PII) displayed on the VistA screen, the VistA system must be updated to return the user to the Select PATIENT NAME: prompt, with no intervening input points. Listing of Updates: ------------------- 1. Patch DG*5.3*1040 updates the timeout processing of all prompts when adding or editing address data in the ADDITIONAL PATIENT DEMOGRAPHIC DATA, SCREEN <1.1> screen. The timeout from all prompts encountered from this screen exits to the Select PATIENT NAME: prompt. *BEGIN SCREEN CAPTURE* ADDITIONAL PATIENT DEMOGRAPHIC DATA, SCREEN <1.1> DGPATIENT,ONE (ONE) XXX XX, XXXX XXX-XX-XXXX NSC VETERAN ========================================================================== [1] Residential Address: [2] Permanent Mailing Address: 000 MAIN STREET 0000 ANY STREET ANYTOWN, MA XXXXX-XXXX ANYTOWN, MA XXXXX-XXXX UNITED STATES UNITED STATES County: XXXXXXX (XXX) County: UNANSWERED Phone: Bad Addr: Office: [3] Temporary Mailing Address: [4] Confidential Mailing Address: NO TEMPORARY MAILING ADDRESS NONE ON FILE Phone: NOT APPLICABLE Phone: NOT APPLICABLE From/To: NOT APPLICABLE From/To: NOT APPLICABLE Categories: NOT APPLICABLE to CONTINUE, 1-4 or ALL to EDIT, ^N for screen N or '^' to QUIT: 1 RESIDENTIAL COUNTRY: UNITED STATES// UNITED STATES USA United States RESIDENTIAL ADDRESS [LINE 1]: 000 MAIN STREET Replace RESIDENTIAL ADDRESS [LINE 2]: ADDITIONAL PATIENT DEMOGRAPHIC DATA, SCREEN <1.1> DGPATIENT,ONE (ONE) XXX XX, XXXX XXX-XX-XXXX NSC VETERAN ========================================================================== [1] Residential Address: [2] Permanent Mailing Address: 000 MAIN STREET 0000 ANY STREET ANYTOWN, MA XXXXX-XXXX ANYTOWN, MA XXXXX-XXXX UNITED STATES UNITED STATES County: XXXXXXX (XXX) County: UNANSWERED Phone: Bad Addr: Office: [3] Temporary Mailing Address: [4] Confidential Mailing Address: NO TEMPORARY MAILING ADDRESS NONE ON FILE Phone: NOT APPLICABLE Phone: NOT APPLICABLE From/To: NOT APPLICABLE From/To: NOT APPLICABLE Categories: NOT APPLICABLE Select PATIENT NAME: *END SCREEN CAPTURE* NOTE: The screen is cleared before the Select PATIENT NAME: prompt is displayed so that no patient data remains visible. 2. In the Load/Edit Patient Data [DG LOAD PATIENT DATA] option, the user is prompted to edit the Permanent Mailing Address. A timeout from any prompt when editing the address exits to the Select PATIENT NAME: prompt. *BEGIN SCREEN CAPTURE* Do you want to edit Patient Data? Yes// (Yes) Permanent Mailing Address: 0000 ANY STREET ANYTOWN, MA XXXXX-XXXX UNITED STATES County: UNANSWERED Bad Addr: Do you want to edit the Patient's Permanent Mailing Address? Y (Yes) COUNTRY: UNITED STATES// UNITED STATES USA United States STREET ADDRESS [LINE 1]: 0000 ANY STREET// 0000 ANY STREET STREET ADDRESS [LINE 2]: Select PATIENT NAME: *END SCREEN CAPTURE* 3. The Application Programming Interface (API), UPDATE^DGADDUTL, used by Outpatient Pharmacy in the Update Patient Record [PSO PAT] option, is impacted by this patch. Modifications to UPDATE^DGADDUTL are made to ensure the timeout on any field when editing the Temporary Address or Permanent Mailing Address exits to the calling routine. The supporting Integration Control Registration for this API is #4886 (see below). 4886 NAME: UPDATE PATIENT ADDRESSES CUSTODIAL PACKAGE: REGISTRATION SUBSCRIBING PACKAGE: OUTPATIENT PHARMACY USAGE: Controlled Subscri ENTERED: AUG 28,2006 STATUS: Active EXPIRES: DURATION: Till Otherwise Agr VERSION: DESCRIPTION: TYPE: Routine This API allows the user to update a patient's permanent or temporary address. ROUTINE: DGADDUTL COMPONENT: UPDATE(DFN,TYPE) This API enables the user to update a patient's permanent or temporary address depending on the value of the TYPE variable. If the TYPE variable equals "PERM" the user will be able to edit the fields for the patient's permanent address. If the TYPE variable equals "TEMP" the user will be able to edit the fields for the patient's temporary address. VARIABLES: Input DFN This is the IEN of the Patient file #2. VARIABLES: Input TYPE The value of TYPE determines which address the user will edit. "PERM" for permanent address, "TEMP" for temporary address. KEYWORDS: ******************** 4. The Patient Address Update [DG ADDRESS UPDATE] option is modified to ensure that the timeout on any field when editing the Temporary Address or Permanent Mailing Address exits to the Veteran Name/SSN: prompt. * BEGIN SCREEN CAPTURE * Veteran Name/SSN: DGPATIENT,ONE (ONE) XX-XX-XX XXXXXXXXX NO NSC VETERAN Enrollment Priority: Category: ENROLLED End Date: Do you want to update the (P)ermanent Mailing Address, (T)emporary Mailing Address, or (B)oth? T Temporary Mailing Address: 123 MAIN STREET County: Phone: From/To: Jan 15,2021-Jan 15,2021 TEMP MAILING ADDRESS ACTIVE: YES// TEMP MAILING ADDRESS START DATE: JAN 15,2021// TEMP MAILING ADDRESS END DATE: JAN 15,2021// TEMPORARY ADDRESS COUNTRY: UNITED STATES// UNITED STATES USA United States TEMPORARY STREET [LINE 1]: 123 MAIN STREET// 123 MAIN STREET Veteran Name/SSN: * END SCREEN CAPTURE * NOTE: The screen is cleared before the Veteran Name/SSN: prompt is displayed so that no patient data remains visible. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- N/A 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: 1. INC16311243 The address entry sections of the ADDITIONAL PATIENT DEMOGRAPHIC DATA, SCREEN <1.1> screen is not in compliance with the M Programming Standards and Conventions (version effective date 10/01/2020) regarding the VistA Timeout conditions. The VistA timeout exceptions during Patient Address Entry were handled in different ways depending on where in the prompt sequence the user timed out and which of the four address types were being entered/edited. Research into the issue determined that timeout conditions during address entry/edit were not handled in accordance with the current SAC Standard, Section 3.1.5. The Application Programming Interface (API), UPDATE^DGADDUTL, used by Outpatient Pharmacy in the Update Patient Record [PSO PAT] option, is impacted by this issue. Modifications to PDATE^DGADDUTL are required to ensure the timeout on any field when editing the Temporary Address or Permanent Mailing Address exits to the calling routine. Problem: -------- The address entry sections of the ADDITIONAL PATIENT DEMOGRAPHIC DATA, SCREEN <1.1> screen is not in compliance with the M Programming Standards and Conventions (version effective date 10/01/2020) regarding the VistA Timeout conditions. Resolution: ----------- Patch DG*5.3*1040 modifies the address entry sections of the ADDITIONAL PATIENT DEMOGRAPHIC DATA, SCREEN <1.1> screen, the Patient Address Update [DG ADDRESS UPDATE] option, and Permanent Mailing Address entry/edit in the Load/Edit Patient Data [DG LOAD PATIENT DATA] option to bring the timeout behavior into compliance with the M Programming Standards and Conventions (version effective date 10/01/2020) regarding the VistA Timeout conditions. Test Sites: ----------- Boise VA Medical Center, Boise, ID VA Maryland Health Care System (Baltimore, Lock Raven, Perry Point), MD Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released in a PackMan message. 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 can also be obtained at https://download.vista.domain.ext/index.html/SOFTWARE. Documentation Title File Name --------------------------------------------------------------------- DG*5.3*1040 Release Notes DG_5_3_1040_RN.PDF Patch Installation: ------------------- Pre/Post Installation Overview: ------------------------------- N/A 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. The following options should be disabled during installation: Register a Patient [DG REGISTER PATIENT] Preregister a Patient [DGPRE PRE-REGISTER OPTION] Load/Edit Patient Data [DG LOAD PATIENT DATA] Eligibility Verification [DG ELIGIBILITY VERIFICATION] Admit a Patient [DG ADMIT PATIENT] Patient Address Update [DG ADDRESS UPDATE] Update Patient Record [PSO PAT] Appointment Management [SDAM APPT MGT] 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 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. DG*5.3*1040) B. Select the Backup a Transport Global option to create a backup message. You can specify what to backup; the entire Build or just Routines. The backup message can be used to restore just the routines or everything that will restore your system to pre-patch condition. 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 options: Option Name Menu Text ----------- --------- Register a Patient [DG REGISTER PATIENT] Preregister a Patient [DGPRE PRE-REGISTER OPTION] Load/Edit Patient Data [DG LOAD PATIENT DATA] Eligibility Verification [DG ELIGIBILITY VERIFICATION] Admit a Patient [DG ADMIT PATIENT] Patient Address Update [DG ADDRESS UPDATE] Update Patient Record [PSO PAT] Appointment Management [SDAM APPT MGT] 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: ------------------------------- N/A 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. 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 "Backup a Transport Global" was run as directed, then the entire Build or Routines (depending on which option was chosen) will have the ability to be restored from the "backup" MailMan message that was generated. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Registration;**[Patch List]**;Aug 13, 1993;Build 15 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: DG10 Before: B30243859 After: B32850951 **32,109,139,149,182,326,513, 425,574,642,658,773,864,921, 993,1040** Routine Name: DGADDLST Before: B24537445 After: B25393125 **1014,1040** Routine Name: DGADDUTL Before: B65854548 After: B72545598 **658,695,730,688,808,851,872, 915,925,941,1010,1040** Routine Name: DGADDVAL Before: B11247230 After: B11543186 **1014,1040** Routine Name: DGENDBS Before: B5347625 After: B5434355 **122,147,182,1040** Routine Name: DGLOCK Before: B53456898 After: B53950031 **108,161,247,485,672,673,688, 754,797,1040** Routine Name: DGLOCK3 Before: B10959586 After: B11146338 **489,527,688,1014,1040** Routine Name: DGREG Before:B156355963 After:B160323026 **1,32,108,147,149,182,245,250, 513,425,533,574,563,624,658, 864,886,915,926,1024,993,1040** Routine Name: DGREGAED Before: B62965158 After: B71144811 **522,560,658,730,688,808,915, 941,1010,1014,1040** Routine Name: DGREGCP1 Before: B30297133 After: B34041962 **941,1010,1040** Routine Name: DGREGRED Before: B77348398 After: B89579662 **941,1010,1014,1040** Routine Name: DGREGTE2 Before: B21210063 After: B21247832 **688,754,851,1040** Routine Name: DGREGTED Before: B65810805 After: B71965031 **688,851,941,1014,1040** Routine Name: DGRP Before: B2492413 After: B2606972 **108,114,250,1040** Routine Name: DGRPE Before:B104572440 After:B108399788 **32,114,139,169,175,247,190, 343,397,342,454,415,489,506, 244,547,522,528,555,508,451, 626,638,624,677,672,702,689, 735,688,797,842,865,871,887, 941,985,997,1014,1040** Routine Name: DGRPP Before: B21625700 After: B22781007 **92,147,343,404,397,489,689, 688,828,797,871,997,1014,1040** Routine list of preceding patches: 993, 1014 ============================================================================= User Information: Entered By : Date Entered : NOV 13, 2020 Completed By: Date Completed: APR 22, 2021 Released By : Date Released : APR 22, 2021 ============================================================================= Packman Mail Message: ===================== $END TXT