$TXT Created by at MDEVC.FO-BIRM.DOMAIN.EXT (KIDS) on Tuesday, 12/01/20 at 12:47 ============================================================================= Run Date: DEC 17, 2020 Designation: DG*5.3*1037 Package : DG - REGISTRATION Priority: Mandatory Version : 5.3 SEQ #901 Status: Released Compliance Date: JAN 17, 2021 ============================================================================= Associated patches: (v)DG*5.3*1028 <<= must be installed BEFORE `DG*5.3*1037' Subject: CERNER Include message ID in application error message Category: - Routine Description: ============ Cerner has requested that the email messages generated when application errors occur in VistA be modified to break out the message control ID (MSA-2) as a separate element in the (mail) message. The timestamp (with timezone) is also explicitly broken out. Finally, the MSH segment is added to the message text, Note: In the case of messages originating from Cerner, the originating message control number is often called the "Q-number" because it is an alphanumeric string beginning with "Q". Testing Constraints: -------------------- The format of error messages delivered to the mail group DGPF APPLICATION ERRORS was verified in Gold (SQA); however, since the constraints of the prodfuction environment rule out the triggering of application errors from Cener, this negative test could not be performed during IOC. 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: N/A Problem: -------- The mail messages generated when PRF generates an application error are not explicitly called out in the body of the (mail message). Resolution: ----------- Add a new line to the message that identifies the MID of the original message (MSA-2). Test Sites: ----------- VA Loma Linda Healthcare System - Loma Linda, CA Central Alabama Veterans Health Systems West Campus - Montgomery, AL Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released in a PackMan message. Documentation describing the new functionality may be included in this release. Sites may retrieve the documentation directly using Secure File Transfer Protocol (SFTP) from DOWNLOAD.VISTA.DOMAIN.EXT. Documentation can also be found on the VA Software Documentation Library at: https://www.domain.ext/vdl/ Documentation Title File Name FTP Mode --------------------------------------------------------------------- N/A Patch Installation: ------------------- Pre/Post Installation Overview: This patch affects the way certain HL7 messages are processed. Accordingly, it is recommended that incoming HL7 filers be STOPPED during installation. 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 HL7 incoming filers should be stopped. Use the Monitor, Start, Stop Filers [HL FILER MONITOR] 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 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*1037). 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 DDs 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 (ex. DG*5.3*1037). 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. a. When prompted 'Enter options you wish to mark as 'Out Of Order':', press the Enter key. 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: ------------------------------- After patch installation has completed, restart the HL7 incoming filers. Use the Monitor, Start, Stop Filers [HL FILER MONITOR] option on the Filer and Link Management Options [HL MENU FILER LINK MGT] menu on the HL7 Main Menu [HL MAIN MENU]. Back-Out/Roll Back Plan: ------------------------ Restore the routine DGPFHLS from the backup you created during the install. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Registration;**[Patch List]**;Aug 13, 1993;Build 4 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: DGPFHLS Before: B91515238 After: B96059624 **425,650,1005,1028,1037** Routine list of preceding patches: 1028 ============================================================================= User Information: Entered By : Date Entered : OCT 08, 2020 Completed By: Date Completed: DEC 16, 2020 Released By : Date Released : DEC 17, 2020 ============================================================================= Packman Mail Message: ===================== $END TXT