============================================================================= Run Date: JUL 31, 2020 Designation: MAG*3*243 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #192 Status: Released Compliance Date: AUG 31, 2020 ============================================================================= Subject: BP Delphi Upgrade Category: - Routine Description: ============ MAG*3.0*243, a patch that provides fixes to the BACKGROUND PROCESSOR (BP). This patch addresses the following issues: 1. BP Jukebox and Delete Queues Processing at the same time. 2. BP Purge prompting for PIV Logon. 3. Scheduled Verifier Connection Error Timeout. 4. BP Utility - MagHTMLArchiver - Delphi 10.2.3 Tokyo Upgrade 5. BP Utility - MagThumbnailMaker - Delphi 10.2.3 Tokyo Upgrade 6. BP Utility - MagMake_Abs - Delphi 10.2.3 Tokyo Upgrade 7. BP Utility - Import API - Delphi 10.2.3 Tokyo Upgrade 8. BP Purge - Delphi 10.2.3 Tokyo Upgrade 9. BP Verifier - Delphi 10.2.3 Tokyo Upgrade 10. BP Queue Processor - Delphi 10.2.3 Tokyo Upgrade Associated Patches: VistA Imaging MAG*3.0*243 must be installed after MAG*3.0*238. 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: ----------------------- Blood Bank Team Coordination: N/A New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: 1. Defect 1090037 (Trouble Ticket # INC6546188) BP Jukebox_Delete order Problem: -------- The Delete Queue is being processed at the same time the Jukebox is being processed. Resolution: ----------- A code change was made to continue processing if a record is found to be in error status, the Jukebox continues processing with the next Jukebox queue record. 2. Defect 1080579 (Trouble Ticket # INC6546579) Purge prompting for PIV Problem: -------- When starting BP Purge, after selecting the sign-on location, user is being prompted to select a PIV certificate. Resolution: ----------- A code change was made to the Background Processor Purge application that bypasses the Single Sign-On (SSOi) functionality. The user is prompted to enter only their Access/Verify codes. 3. Defect 1078471 (Trouble Ticket # INC6007950) Scheduled Verifier Connection Error Timeout Problem: -------- Scheduled Verifier could not establish a broker connection and loops in the logs to show an XWB error and No Application Context have been created. After changes to the Verifier for the MAG*3.0*243 T2 release, field testing discovered problems when the Verifier program is launched and the network connection drops. If the Verifier is still in the initial setup when this happens, the program will enter into an infinite loop and give a Windows "Program Has Stopped Responding" message. Additionally, when the network connection drops, they saw problems with logging. Multiple archivals of the log are being produced. This causes confusion as there should be at most one (or two) archives produced each time the program is run. Resolution: ----------- To address dropped network connectivity issue, the timeout condition of 30 minutes has been reduced to 15 minutes for reconnection effort. This allows the connectivity issue to be detected and flagged up to five times before failing and silently terminating (no pop up message) before logging an error message. The broken network connection downtime is limited to 15 minutes total between the five login/retry attempt (three minutes, five attempts) before the program silently terminates and an error message is logged. 4. Story 789563 BP Utility - MagHTMLArchiver - Delphi 10.2.3 Tokyo Upgrade Problem: -------- The BP Utility, MagHTMLArchiver, needs to be upgraded to Delphi 10.2.3 Tokyo. Resolution: ----------- Upgraded BP Utility - MagHTMLArchiver to Delphi 10.2.3 Tokyo 5. Story 789562 BP Utility - MagThumbnailMaker - Delphi 10.2.3 Tokyo Upgrade Problem: -------- The BP Utility, MagThumbnailMaker, needs to be upgraded to Delphi 10.2.3 Tokyo. Resolution: ----------- Upgraded BP Utility - MagThumbnailMaker to Delphi 10.2.3 Tokyo 6. Story 789559 BP Utility - MagMake_Abs - Delphi 10.2.3 Tokyo Upgrade Problem: -------- The BP Utility, MagMake_Abs, needs to be upgraded to Delphi 10.2.3 Tokyo. Resolution: ----------- Upgraded BP Utility - MagMake_Abs to Delphi 10.2.3 Tokyo 7. Story 789554 BP Utility - Import API - Delphi 10.2.3 Tokyo Upgrade Problem: -------- The BP Utility, Import API, needs to be upgraded to Delphi 10.2.3 Tokyo. Resolution: ----------- Upgraded BP Utility - Import API to Delphi 10.2.3 Tokyo 8. Story 789552 BP Purge - Delphi 10.2.3 Tokyo Upgrade Problem: -------- The BP Purge needs to be upgraded to Delphi 10.2.3 Tokyo. Resolution: ----------- Upgraded BP Purge to Delphi 10.2.3 Tokyo. 9. Story 789550 BP Verifier - Delphi 10.2.3 Tokyo Upgrade Problem: -------- The BP Verifier needs to be upgraded to Delphi 10.2.3 Tokyo. Resolution: ----------- Upgraded BP Verifier to Delphi 10.2.3 Tokyo 10. Story 789547 BP Queue Processor - Delphi 10.2.3 Tokyo Upgrade Problem: -------- The BP Queue Processor needs to be upgraded to Delphi 10.2.3 Tokyo. Resolution: ----------- Upgraded BP Queue Processor to Delphi 10.2.3 Tokyo Test Sites: ----------- Hunter Holmes McGuire VA Medical Center (Richmond, VA) Royal C. Johnson Veterans Memorial Hospital (Sioux Falls, SD) Montana VA Health Care System (Fort Harrison, MT) Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released using a host file. The host file is available at the following location: /srv/vista/patches/SOFTWARE/MAG3_0P243.KID Other Software Files: This release also includes other software files. These files can be obtained by accessing the URL: https://download.vista.domain.ext/index.html/SOFTWARE File Title File Name --------------------------------------------------------------------- Kernel Installation and MAG3_0P243.KID Distribution System (KIDS) build for MAG*3.0*243 - New Background Processor Client MAG3_0P243_Background_Processor_Setup.exe Installation File - New Documentation Title File Name --------------------------------------------------------------------- Patch Description for MAG*3.0*243 MAG3_0P243_Patch_Description.pdf Deployment, Installation, Back-Out, MAG3_0P243_DIBORG.pdf and Rollback Guide Patch Installation: ------------------- Supported Client Versions: When MAG*3.0*243 is released, the list of supported versions of Background Processor will change: Client Versions Supported: 3.0.243 3.0.238 3.0.235 Client Versions No Longer Supported: 3.0.222 3.0.214 3.0.198 3.0.196 3.0.135 Pre/Post Installation Overview: MAG*3.0*243 must be installed on the VistA System and on 64-bit servers on which the VistA Imaging Applications will be used. This patch must be installed by the compliance date. 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 five minutes to install. Important: Any BP applications (including Queue Processor, Verifier, and Purge) that are running must be stopped and closed prior to the installation of the KIDS and Client software. Any image capture application (Clinical Capture and DICOM Gateway processing) or display application (Clinical Display and TeleReader) can continue to run during the installation. Note: All released VistA Imaging patches must be installed on the VistA system before installing MAG*3.0*243. Installation Instructions: 1. Use the Load a Distribution option contained on the Kernel Installation and Distribution System Menu to load the Host file. When prompted to "Enter a Host File:" enter /srv/vista/patches/SOFTWARE/MAG3_0P243.KID 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. MAG*3.0*243). 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 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 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?,' answer NO. ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install?,' answer NO. Post-Installation Instructions: Restart all Background Processor applications that were stopped for installation, provided they are supported versions. Installing the BP Client: Please refer to the Deployment, Implementation, Back-Out and Rollback Guide (MAG3_0P243_DIBORG.pdf) for Client Installation instructions. Back-Out/Roll Back Plan: ------------------------ Please refer to the Deployment, Implementation, Back-Out and Rollback Guide (MAG3_0P243_DIBORG.pdf) for Client Installation instructions. Routine Information: VistA KIDS Checksums This section lists modified routines for the VistA KIDS build. For each routine, the second line will contain the following information: ;;3.0;IMAGING;**[Patch List]**;Mar 19, 2002;Build 7 CHECK1^XTSUMBLD is used to generate the checksums. Routine Checksums Routine Checksum Checksum Patch List Before After MAGQBUT4 97831307 97830931 **7,8,48,20,81,39,121,135, 196,198,214,222,235,238,243** MAGIP243 NEW 4110396 **243** Routine MAGIP243 is an installation routine that is automatically deleted after the KIDS installation. Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0;IMAGING;**[Patch List]**;Mar 19, 2002;Build 6 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: MAGIP243 Before: n/a After: B4110396 **243** Routine Name: MAGQBUT4 Before: B97831307 After: B97830931 **7,8,48,20,81,39,121,135,196, 198,214,222,235,238,243** Routine list of preceding patches: 238 ============================================================================= User Information: Entered By : Date Entered : MAY 09, 2019 Completed By: Date Completed: JUL 30, 2020 Released By : Date Released : JUL 31, 2020 ============================================================================= Packman Mail Message: ===================== No routines included