$TXT Created by at DEVVOO.DOMAIN.EXT (KIDS) on Monday, 09/21/20 at 08:29 ============================================================================= Run Date: OCT 07, 2020 Designation: DG*5.3*1031 Package : DG - REGISTRATION Priority: EMERGENCY Version : 5.3 SEQ #894 Status: Released Compliance Date: OCT 13, 2020 ============================================================================= Associated patches: (v)DG*5.3*993 <<= must be installed BEFORE `DG*5.3*1031' Subject: PATCH TO A PATCH - DG*5.3*993 DEFECT FIXES FOR ADMISSION AND DISPOSITION Category: - Routine - PATCH FOR A PATCH Description: ============ Veterans Health Information Systems and Technology Architecture (VistA) Registration, Eligibility & Enrollment (REE) patch DG*5.3*993, SEPARATE PATIENT REGISTRATION FROM ENROLLMENT, was recently released to support the Health Eligibility Center (HEC), which has a need to separate registration events from enrollment events. Patch DG*5.3*993 introduced defects into the system. Patch DG*5.3*1031 corrects defects related to DG*5.3*993. The most significant defect was reported in the admission process at select sites. The user must abort the admission process because they cannot exit an incorrect message that repeats. This locks the admission record and prevents data communication to Pharmacy and other ancillary clinical and administrative packages that impact patient care. While the record is locked, providers are prevented from writing orders. Please refer to the 'Defect Tracking System Ticket(s) & Overview' section of this patch for a description of the incidents. At some sites, the message "Use Register a Patient to add a new person. Press RETURN to continue." displayed intermittently in incorrect locations for any patient being admitted or whose admission was edited in the following options: - Admit a Patient [DG ADMIT PATIENT] - Detailed Inpatient Inquiry [DG INPATIENT INQUIRY EXTENDED] - Extended Bed Control [DG BED CONTROL EXTENDED] The incorrect message repeats and the user may not be able to exit except by closing the session. The code to display the message is in the patient lookup routine, and the execution of local database triggers displayed the message in incorrect locations. The code in routine DPTLK to display the prompt was moved to tag NOPAT and corrected to not display the message, which allows normal execution of the local database triggers. A separate defect in the Disposition an Application [DG DISPOSITION APPLICATION] option caused an undefined error after the user selected the patient, and terminated the user's session. For a REGISTRATION ONLY patient, in the Register a Patient [DG REGISTER PATIENT] option, the response to the prompt "Is the patient to be examined in the medical center today? Yes//" is stored in the EXAMINED IN MEDICAL CENTER field (#7) in the DISPOSITION LOG-IN DATE/TIME SUBFILE (#2.101) file of the PATIENT (#2) file. In the Disposition an Application [DG DISPOSITION APPLICATION] option, the default values for the "STATUS:" and "Select the type of disposition:" prompts for a REGISTRATION ONLY patient are set based on the response to the "Is the patient to be examined in the medical center today? Yes//" prompt. In the unlikely event that no response was stored for this prompt, and the patient is REGISTRATION ONLY, an undefined error occurred. The logic in routine DGDIS is updated to handle a blank value in the EXAMINED IN MEDICAL CENTER field (#7) in the DISPOSITION LOG-IN DATE/TIME SUBFILE (#2.101) file of the PATIENT (#2) file. The default values in the Disposition an Application [DG DISPOSITION APPLICATION] option are set as follows if the field is blank. * BEGIN SCREEN CAPTURE * STATUS: APPLICATION WITHOUT EXAM// Select the type of disposition: CANCEL WITHOUT EXAM// * END SCREEN CAPTURE * 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: ----------------------- New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: 1. INC12252768: After Patch DG*5.3*993 installation, the system shows the message "Use Register a Patient option to add a new person.". Problem: -------- In the Admit a Patient [DG ADMIT PATIENT] option, when admitting or editing an existing patient, an incorrect message may display. A message added with DG*5.3*993, "Use Register a Patient to add a new patient." displays after the "PRIMARY PHYSICIAN:" prompt. The user may press RETURN a few times to continue the admission. * BEGIN SCREEN CAPTURE * Admit PATIENT: SEPPATIENTONE,VETERANONE MM-DD-YY 000011111 NO NSC VETERAN Enrollment Priority: 4 Category: VERIFIED End Date: Select ADMISSION DATE: AUG 27,2020@07:38:31// ADMISSION DATE: AUG 27,2020@07:38:31// DOES THE PATIENT WISH TO BE EXCLUDED FROM THE FACILITY DIRECTORY?: NO // ADMITTING REGULATION: NSC// 6 TYPE OF ADMISSION: DIRECT// DIAGNOSIS [SHORT]: TESTING// WARD LOCATION: 82-1A// ROOM-BED: FACILITY TREATING SPECIALTY: GENERAL MEDICAL(ACUTE MED) // PRIMARY PHYSICIAN: PROVIDERONE,TESTPROVIDER//providerone,te PROVIDERONE,TESTPROVIDER A MAB 111 MEDICAL SERVICE PHYSICIAN Use Register a Patient option to add a new person. Press RETURN to continue... ATTENDING PHYSICIAN: //providertwo,te PROVIDERtwo,TESTPROVIDER B MAB 111 MEDICAL SERVICE PHYSICIAN * END SCREEN CAPTURE * This behavior may also be observed in the Extended Bed Control [DG BED CONTROL EXTENDED] option. This issue has only been reported at the Battle Creek VA Medical Center site. With DG*5.3*993, the new message "Use Register a Patient to add a new patient." should display only at the "ADMIT Patient:" prompt if the user attempts to do a patient lookup and admit a new patient. It incorrectly appears after the "PRIMARY PHYSICIAN:" prompt because the patient lookup routine did not prevent the message from displaying if the routine was called for a different purpose during the admission. Resolution: ----------- The patient lookup logic for the Admit a Patient [DG Admit Patient] option is modified to only display the "Use Register a Patient to add a new patient." message when the patient cannot be found at the site. The message is no longer displayed at other admission prompts when the routine is called for a different purpose in the Admit a Patient [DG Admit Patient] or Extended Bed Control [DG BED CONTROL EXTENDED] options. 2. INC12223437: DG DISPOSITION APPLICATION error. Problem: -------- When using the Disposition an Application [DG DISPOSITION APPLICATION] option for a REGISTRATION ONLY patient, an undefined error occurs and terminates the user's connection to VistA. * BEGIN SCREEN CAPTURE * Disposition PATIENT: SEPPATIENTSIX,VETERANSIX MM-DD-YY 000011116 NO NSC VETERAN No Patient Warnings on file for SEPPATIENTSIX,VETERANSIX. Press RETURN to continue... Enrollment Priority: 4 Category: VERIFIED End Date: LOG DATE TYPE OF BENEFIT APPLIED FOR ----------------------------------------------- 04/17/2020@14:23 OUTPATIENT MEDICAL RECORDING THAT AN ERROR OCCURRED --- Sorry 'bout that $ZERROR= Logged out at Sep 16, 2020 5:41 pm * END SCREEN CAPTURE * Resolution: ----------- The logic is updated to handle a blank value in the EXAMINED IN MEDICAL CENTER field (#7) in the DISPOSITION LOG-IN DATE/TIME SUBFILE (#2.101) file of the PATIENT (#2) file. The default values for prompts in the Disposition an Application [DG DISPOSITION APPLICATION] option are set if the field is blank, so an undefined error will not occur. 3. INC12223327: (Duplicate of Incident INC12223437): DG DISPOSITION APPLICATION error. Problem: -------- When using the Disposition an Application [DG DISPOSITION APPLICATION] option for a REGISTRATION ONLY patient, an undefined error occurs and terminates the user's connection to VistA. Resolution : ----------- The logic is updated to handle a blank value in the EXAMINED IN MEDICAL CENTER field (#7) in the DISPOSITION LOG-IN DATE/TIME SUBFILE (#2.101) file of the PATIENT (#2) file. The default values for prompts in the Disposition an Application [DG DISPOSITION APPLICATION] option are set if the field is blank, so an undefined error will not occur. 4. INC12226257: (Duplicate of Incident INC12223437): DG DISPOSITION APPLICATION error. Problem: -------- When using the Disposition an Application [DG DISPOSITION APPLICATION] option for a REGISTRATION ONLY patient, an undefined error occurs and terminates the user's connection to VistA. Resolution: ----------- The logic is updated to handle a blank value in the EXAMINED IN MEDICAL CENTER field (#7) in the DISPOSITION LOG-IN DATE/TIME SUBFILE (#2.101) file of the PATIENT (#2) file. The default values for prompts in Disposition an Application [DG DISPOSITION APPLICATION] option are set if the field is blank, so an undefined error will not occur. 5. INC12449251: Error during patient admission process caused by patch DG*5.3*993. Problem: -------- In the Admit a Patient [DG ADMIT PATIENT] option, when admitting or editing an existing patient, an incorrect message may display. A message added with DG*5.3*993, "Use Register a Patient to add a new patient." displays either after the Admission Date confirmation, or after the "Patient admitted." message. The incorrect message repeats and the user cannot exit except by closing the session. * BEGIN SCREEN CAPTURE * Admit PATIENT: SEPPATIENTTWO,VETERANTWO MM-DD-YY 000011112 NO NSC VETERAN Enrollment Priority: 4 Category: VERIFIED End Date: Select ADMISSION DATE: NOW// SURE YOU WANT TO ADD 'SEP 22,2020@12:01:01' AS A NEW ADMISSION DATE?// Y (Yes) Use Register a Patient option to add a new person. Press RETURN to continue... Use Register a Patient option to add a new person Press RETURN to continue...^ Use Register a Patient option to add a new person Press RETURN to continue... * END SCREEN CAPTURE * This behavior may also be observed in the Detailed Inpatient Inquiry [DG INPATIENT INQUIRY EXTENDED] and the Extended Bed Control [DG BED CONTROL EXTENDED] options. This issue has been reported at Ann Arbor, Lexington, and Louisville sites. With DG*5.3*993, the new message "Use Register a Patient to add a new Patient. Press RETURN to continue." should only display at the "ADMIT Patient:" prompt if the user attempts to do a patient lookup and admit a new patient. It incorrectly appears after the Admission Date confirmation and "Patient admitted" message because the patient lookup routine did not prevent the message from displaying if the routine was called for a different purpose during the admission. Resolution: ----------- The patient lookup logic for the Admit a Patient [DG Admit Patient] option is modified to only display the "Use Register a Patient to add a new patient. Press RETURN to continue." message when the patient cannot be found at the site. The message is no longer displayed at other admission prompts when the routine is called for a different purpose in the Admit a Patient [DG Admit Patient] option. Test Sites: ----------- VA Ann Arbor Healthcare System, Ann Arbor, MI Robley Rex VA Medical Center, Louisville, KY Durham VA Medical Center, Durham, NC 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*1031 Release Notes DG_5_3_1031_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. 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 DG*5.3*1031. 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 Data Dictionaries (DDs) or 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? NO//', 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] Admit a Patient [DG ADMIT PATIENT] Disposition an Application [DG DISPOSITION APPLICATION] Detailed Inpatient Inquiry [DG INPATIENT INQUIRY EXTENDED] Extended Bed Control [DG BED CONTROL EXTENDED] 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 to back up routines, "Backup a Transport Global", was run as directed, 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]**;Aug 13, 1993;Build 1 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: DGDIS Before: B40795456 After: B41794355 **108,121,161,151,459,604,993,1031** Routine Name: DPTLK Before:B136022799 After:B140750292 **32,72,93,73,136,157,197,232, 265,277,223,327,244,513,528, 541,576,600,485,633,629,647, 769,857,876,915,919,993,1031** Routine list of preceding patches: 993 ============================================================================= User Information: Entered By : Date Entered : SEP 09, 2020 Completed By: Date Completed: OCT 07, 2020 Released By : Date Released : OCT 07, 2020 ============================================================================= Packman Mail Message: ===================== $END TXT