$TXT Created by CLN2G2.AAC.DOMAIN.EXT (KIDS) on Friday, 02/16/24 at 08:27 ============================================================================= Run Date: AUG 21, 2024 Designation: CRHD*1*11 Package : CRHD - SHIFT CHANGE HANDOFF TOOL Priority: Mandatory Version : 1 SEQ #8 Status: Released Compliance Date: SEP 21, 2024 ============================================================================= Associated patches: (v)CRHD*1*10 <<= must be installed BEFORE `CRHD*1*11' Subject: UPDATE SOFTWARE TO DELPHI 11 AND MED DETAIL DISPLAY ENDLESS LOOP FIX Category: - Routine - Other Description: ============ This patch addresses the following issues: 1) HDSO-7966 - The Department of Veterans Affairs Office of Information and Technology requires that applications remain compliant with the Technical Reference Model (TRM) regarding the version of tools used for development. This patch accomplished this by updating the version of Delphi to 11.2. 2) INC29032277 - Long Med List causes Endless Loop on Med Detail Display 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: ============================================ Problem 1: ---------- HDSO-7966 - Department of Veterans Affairs Office of Information and Technology requires that applications remain compliant with the Technical Reference Model (TRM) regarding the version of tools used for development. Resolution 1: ------------- This patch accomplished this by updating the version of Delphi to 11.2. To validate compatibility between the GUI code with the VistA server code, post install routine CRHD11PI will update general parameter CRHD GUI VERSION to the supported GUI version. Problem 2: ---------- INC29032277 - Long Med List causes Endless Loop on Med Detail Display. When a patient has long list of active and recently expired meds creating an array of 1000+ nodes (approximately 200 meds), and Shift Handoff Tool is using the "Med Detail" data object, then the RPC Broker call CRHD PAT ACTMEDS can get stuck in an endless loop. If a Shift Hand Off patient has 200+ meds and is causing an endless loop, then sites can change the display to "Med Summary" as a temporary work around. Once the patient is discharged, they can switch back to the "Med Details" display. Resolution 2: ------------- Routine CRHDAM is modified to prevent the endless loop from occurring. The existing logic could end up resetting a counter node which caused the loop to start over at the top of the meds list. This is occurring because the logic did not take into account the array of meds may contain different number of lines for each Unit Dose, IV, and non-VA meds within the array and therefore didn't count correctly in some situations. Technical Resolution 2: ----------------------- There was logic that was attempting to limit the number of meds that were reviewed to 998 lines of the array. No reason for this can be determined, plus, it didn't work and reset the count to -1 which caused the loop to start over from the top of the array of meds. Line PSGI+7 is changed from S CRHDNUM=0 F S CRHDNUM=$O(CRHDLST(CRHDNUM)) Q:'CRHDNUM!('CRHDFG) D To S CRHDNUM=0 F S CRHDNUM=$O(CRHDLST(CRHDNUM)) Q:'CRHDNUM D Line PSGI+16 is changed from ..I CRHDNUM2=CRHDLSTR S CRHDFG=0 To ..;I CRHDNUM2=CRHDLSTR S CRHDFG=0 Test Sites: ----------- Durham VA Medical Center (Durham, NC) Central California VA Health Care System (Fresno, CA) Test Sites - SNOW Change Order #: -------------------------------- DUR: CHG0504668 FRE: CHG0491447 Software and Documentation Retrieval Instructions: -------------------------------------------------- This software is being released with both a PackMan message and an updated Graphical User Interface (GUI). Files and documentation pertaining to this patch are available. Files can be obtained from the SOFTWARE directory. https://download.vista.domain.ext/index.html/SOFTWARE/ Please refer to the "Shift Change Handoff (CRHD*1.0*11) Deployment, Installation, Back-Out, and Rollback Guide" for installation and set-up information. This document is available on the VA Software Document Library (VDL). Title File Name ------------------------------------------------------------------- Shift Change Handoff Deployment, CRHD_1_11_DIBRG.PDF Installation, Back-Out, and Rollback Guide CRHD*1.0*11 GUI files CRHD_1_11.ZIP Zip File Contents Description File Version ----------------- ----------- ------------ ShiftHandoffTool.exe Client 1.0.11.2 CRHD.chm Client help file Patch Installation: =================== GUI Installation Instructions: ------------------------- Sites that employ the VistA Consolidated Server (VACS) installation process will be alerted to the new GUI via an action item from Office of Information and Technology (OIT) Information Technology Operations and Services (ITOPS). Follow the detailed instructions in the Action Item email for VistA Consolidated Server (VACS) installation. The Information Operations (IO) HBMC Field Operations (FO) Application Division will lead and coordinate deployment activities with EUO, Client Technology, Citrix Back Office, and Area Managers, and other OIT and business partners as required. The released software package is available at: https://download.vista.domain.ext/index.html/SOFTWARE 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 patch. 2. Choose the INSTALL/CHECK MESSAGE PackMan option to load the KIDS patch into a Transport Global on your system. 3. From the Kernel Installation & Distribution System Menu (KIDS), select the Installation Menu. 4. From the Installation Menu: i. At the Installation option menu, select Backup a Transport Global. ii. At the Select INSTALL NAME prompt, enter your build CRHD*1.0*11. iii. When prompted for the following, enter "R" for Routines or "B" for Build. Select one of the following: B Build R Routines Enter response: Build iv. When prompted "Do you wish to secure your build? NO//", press and take the default response of "NO". v. When prompted with, "Send mail to: Last name, First Name", press to take default recipient. Add any additional recipients. vi. When prompted with "Select basket to send to: IN//", press and take the default IN mailbox or select a different mailbox., select the Backup a Transport Global. 5. From the Installation Menu, you may elect to use the following options. When prompted for the INSTALL NAME enter the patch CRHD*1.0*11. i. Verify Checksums in Transport Global - This option will allow you to ensure the integrity of the routines that are in the transport global. ii. Print Transport Global - This option will allow you to print only a summary of the patch, to print a summary of the patch and the routines in the transport global, or to print only the routines in the transport global. iii. 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 components of this patch's routines, DDs, templates, etc.). 6. From the Installation Menu, select the Install Package(s) option and enter the patch CRHD*1.0*11. 7. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', respond 'NO'. 8. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', respond 'NO'. Post-Installation Instructions: ------------------------------- Post install routine CRHD11PI will automatically run at the end of the installation process. After the post install has finished running, sites can delete the CRHD11PI routine using the Delete Routines [XTRDEL] if they wish. Back-out/Rollback Strategy: --------------------------- Back-out will be done only with the concurrence and participation of development team and appropriate VA site/region personnel. The decision to back-out or rollback software will be a joint decision between development team, VA site/region personnel and other appropriate VA personnel. Please reference the Shift Change Handoff (CRHD*1.0*11) Deployment, Installation, Back-Out, and Rollback Guide for back-out/rollback instructions. Validation of Back-out Procedure: --------------------------------- The Back-out Procedure can be verified by confirming the checksums have been returned to the pre-patch value using CHECK1^XTSUMBLD. It can also be verified by printing the first 2 lines of the routines contained in this patch using the option First Line Routine Print [XU FIRST LINE PRINT]. Once the build contained in the CRHD*1.0*11 patch has been backed out, the first two lines of the routine will no longer contain the designation of this patch in the patch list section on line 2. Routine Information: ==================== The second line of each of these routines now looks like: ;;1.0;CRHD;**[Patch List]**;Jan 28, 2008;Build 4 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: CRHD11PI Before: n/a After: B931043 **11** Routine Name: CRHDAM Before: B18095609 After: B19003062 **11** ============================================================================= User Information: Entered By : Date Entered : AUG 28, 2023 Completed By: Date Completed: AUG 20, 2024 Released By : Date Released : AUG 21, 2024 ============================================================================= Packman Mail Message: ===================== $END TXT