$TXT Created by at KRNDEV.FO-OAKLAND.DOMAIN.EXT (KIDS) on Thursday, 05/16/24 at 05:33 ============================================================================= Run Date: JUL 01, 2024 Designation: XU*8*798 Package : XU - KERNEL Priority: EMERGENCY Version : 8 SEQ #640 Status: Released Compliance Date: JUL 08, 2024 ============================================================================= Subject: FIX XQALERT DELETE OLD OPTION Category: - Other Description: ============ Kernel Patch XU*8*798 is being released as an emergency patch. It addresses accidental purging of alerts by eliminating interactive use of the Delete Old (>14 d) Alerts [XQALERT DELETE OLD] option. The option will remain on the Alert Management [XQALERT MGR] and the Operations Management [XUSITEMGR] menus, but you will only be able to invoke it from TaskMan. This patch also provides additional information to the option's description. Option "Description" field update to clarify existing functionality: In addition to purging old alerts, the routine for this option is also responsible for forwarding alerts. Alerts that go unprocessed by the initial recipient that are also not forwarded on to SURROGATES, SERVICE CHIEFS, and/or BACKUP REVIEWERS can pose a risk to patient safety. 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 ----------- ---- -------------------- XQALERT DELETE OLD run routine Modified 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. SNOW INC29823755 - Prevent XQALERT DELETE OLD option from purging alerts records too soon Problem: -------- A problem exists with the XQALERT DELETE OLD option that occurs when it is run interactively - rather than queueing it via TaskMan. Resolution: ----------- The XQALERT DELETE OLD option is being modified in two ways: (1) An ENTRY ACTION is being added to the option that will Quit instead of running the OLDDEL^XQALERT routine and displays the following message to the user "***MUST USE TASKMAN. SEE OPTION DESCRIPTION FOR MORE INFO.***" (2) The option's DESCRIPTION field is being updated to include information about scheduling the task, including the recommended daily frequency and using the TASK PARAMETERS field to set the number of days for retention. The new DESCRIPTION is: WARNING: Failure to run this task daily would create a patient safety issue! This option must be scheduled to run daily as it not only purges old alerts, but it is also responsible for forwarding unprocessed alerts to surrogates, service chiefs and backup reviewers. When scheduling, the TASK PARAMETERS field is used to set the number of retention days. The system will default to a value of 14 if this is not set. Failure to set this field could result in alerts as recent as 15 days old being purged from all users. Test Sites: ----------- Test Site Name 1: Grand Junction. Test Site Name 2: Pittsburgh. Test Sites - SNOW Change Order #: Grand Junction - CHG0491033 Pittsburgh - CHG0486674 Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released in a PackMan message. Other Software Files: N/A 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 on the Network File Share (NFS) at https://download.vista.domain.ext/index.html/SOFTWARE. Documentation Title File Name --------------------------------------------------------------------- Redacted Documents (VDL): Kernel 8.0 and Kernel Toolkit 7.3 Systems Management Guide krn_8_0_sm.docx / .pdf Kernel 8.0 and Kernel Toolkit 7.3 Technical Manual krn_8_0_tm.docx / .pdf Unredacted Documents (NFS): Kernel 8.0 and Kernel Toolkit 7.3 Systems Management Guide KRN_8_0_SM.DOCX / .PDF Kernel 8.0 and Kernel Toolkit 7.3 Technical Manual KRN_8_0_TM.DOCX / .PDF Patch Installation: ------------------- Pre/Post Installation Overview: Prior to installation you need to be aware of what the site-specific number of retention days is set to for the alert delete option in use at your site. This retention information should be stored and accessible to other team members in the event of back-out/roll-back. Check TaskMan's OPTION SCHEDULING (#19.2) file for the XQALERT DELETE OLD option, notate the site's TASK PARAMETERS (#15) field value for retention days. (NOTE: The XQALERT DELETE OLD option is the only supported Class I option.) The AR3 XQALERT DELETE OLD and R2XQALERT DELETE OLD options are known to be in wide use at sites as alternative alert delete options. If these or any other alert delete options are in use at your site, notate the site-specific retention days for those options as indicated above. Any of these alternative alert delete options in use, should all be marked Out of Order. REMINDER: In the absence of setting the TASK PARAMETERS (#15) field the Class I default value will purge alerts that are aged greater than 14 days. 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. XU*8.0*798 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. Do not use the Backup a Transport Global option to create a backup message. You must manually backout per the Test Plan, if backout is required. 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 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: Schedule XQALERT DELETE OLD to run daily with TASK PARAMETERS = the site-specific number of retention days. Remove OUT OF ORDER message, if present, to re-enable. Ensure AR3 XQALERT DELETE OLD and/or R2XQALERT DELETE OLD are disabled. Back-Out/Roll Back Plan: ------------------------ ATTENTION: If this patch is backed out, the XQALERT DELETE OLD option is still the only supported Class I option. The backout would restore the ability to invoke this option directly instead of forcing you to schedule it through TaskMan. The information documented pre-install pertaining to the site-specific retention days will be used to manually restore the functionality. For manual backout and restore details with sample screen shots, see Section 2.3, "Backout Instructions", in the XU*8.0*798 Test Plan (XU_8_798_Test_Plan.docx). Routine Information: Routine Information: ==================== No routines included. Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : Date Entered : DEC 13, 2023 Completed By: Date Completed: JUN 27, 2024 Released By : Date Released : JUL 01, 2024 ============================================================================= Packman Mail Message: ===================== $END TXT