============================================================================= Run Date: APR 25, 2022 Designation: MAG*3*325 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #220 Status: Released Compliance Date: MAY 26, 2022 ============================================================================= Subject: Defect Patch - VI Background Processor Category: - Routine Description: ============ Description: This document describes MAG*3.0*325, a patch that provides fixes to the VistA Imaging Background Processor (BP). There are no code changes in this release. This release rebuilds the executable with the correct Fileman component version fix to the problem. Please refer to the problem description for further clarification. This patch addresses the following issue: Defect: ------- 1. INC18018108 - Getting error message on Background Processor. There is one additional ticket related to the same issue: INC18016479 Associated Patches: ------------------- This patch must be installed after MAG*3.0*248. 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: ----------------------- N/A 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. INC18018108 - Getting error message on Background Processor. There is one additional ticket related to the same issue: INC18016479 Problem: -------- VHAMORIMMVB01 intermittently stops processing, due to a "Certificate Error" that pops up, causing the queue to stop processing. At times, site personnel are forced to consistently enter the access/verify code; it goes through, and the certificate reappears. This impedes the processing of images, causing work stoppage. Additionally, when accessing the IMAGING SITE PARAMETERS' properties on the BGPs, an error message pops up. This started occurring after the Background Processor MAG3.0.248 upgrades. Resolution: ----------- This was resolved, not in the Background Processor GUI, but on the Configuration Management (CM) side, because there was an issue with the VA Fileman components. So there was no coding change required in the GUI, but rather on the build server. As a result, a new patch and a new build was required. Test Sites: ----------- Palo Alto HCS (Menlo Park, CA) VA Hudson Valley HCS (Montrose, NY) Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch can be installed by following the installation guide: VistA Imaging System Installation Guide The host file is available at the following location: /srv/vista/patches/SOFTWARE/MAG3_0P325.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_0P325.KID Distribution System (KIDS) Build for MAG*3.0*325 VistA Imaging Background MAG3_0P325_BACKGROUND_PROCESSOR_SETUP.EXE Processor Installation File Documentation Title File Name --------------------------------------------------------------------- Patch Description MAG3_0P325_PATCH_DESCRIPTION.PDF Deployment, Installation, MAG3_0P325_DIBORG.PDF Back-Out, and Rollback Guide Patch Installation: ------------------- Supported Client Versions: 3.0.325 3.0.248 3.0.243 Client Versions No Longer Supported: 3.0.238 3.0.235 3.0.222 Pre/Post Installation Overview: ------------------------------- MAG*3.0*325 must be installed on the VistA System prior to running the new executables. This patch must be installed by the compliance date. All sites running VistA Imaging 3.0 must install the KIDS portion of this patch. This patch may be loaded while the VistA Imaging System is active. Installation will take less than one minute. 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. 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_0P325.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*325). B. Select the Backup a Transport Global option to create a backup message of any routines and the build for 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. If prompted 'Want KIDS to INHIBIT LOGONs during the install?,' answer NO. iii. If prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols?,' answer NO. KIDS Installation Example: -------------------------- Select Installation Option: 6 Install Package(s) Select INSTALL NAME: MAG*3.0*325 11/19/20@10:14:39 => VistA Imaging 3.0 - Patch 325; Created on Nov 09, 2020@20:45:05 This Distribution was loaded on Nov 19, 2020@10:14:39 with header of VistA Imaging 3.0 - Patch 325; Created on Nov 09, 2020@20:45:05 It consisted of the following Install(s): MAG*3.0*325 Checking Install for Package MAG*3.0*325 Install Questions for MAG*3.0*325 Want KIDS to INHIBIT LOGONs during the install? NO// Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO// Enter the Device you want to print the Install messages. You can queue the install by enter a 'Q' at the device prompt. Enter a '^' to abort the install. DEVICE: HOME// HERE Install Started for MAG*3.0*325: Nov 19, 2020@10:14:53 Build Distribution Date: Nov 09, 2020 Installing Routines: ... Nov 19, 2020@10:14:53 Running Post-Install Routine: POS^MAGIP325. Post Install Mail Message: Nov 19, 2020@10:14:53 Updating Routine file...... Updating KIDS files....... MAG*3.0*325 Installed. Nov 19, 2020@10:14:53 Client Installation Instructions -------------------------------- For installing or updating VI Background Processor, refer to the VistA Imaging System Installation Guide. (See section 2.4 Background Processor Installation) Post-Installation Instructions: -------------------------------- Restart all Background Processor applications that were stopped for installation, provided they are supported versions. Back-Out/Roll Back Plan: ------------------------ Please refer to the Deployment, Implementation, Back-Out and Rollback Guide (MAG3_0P325_DIBORG.PDF) for Client Installation instructions. Uninstalling the Application: ------------------------------ For installing or updating VI Background Processor, refer to the VistA Imaging System Background Processor User Manual. KIDS Uninstall: --------------- If it is necessary to uninstall the MAG*3.0*325 VistA KIDS, select the Kernel Installation & Distribution System menu option, Backup a Transport Global, (see Installation Steps section, step 2-B must be done before installing the patch). Administrators will need to use the PackMan function INSTALL/CHECK MESSAGE. Check the MailMan messages for the backup message sent by the Backup a Transport Global function executed prior to the patch install. 1. Select the message shown below: Backup of MAG*3.0*325 install on And/Or Backup of MAG*3.0*325 install on Routines Only 2. Select the Xtract PackMan option. 3. Select the Install/Check Message option. 4. Enter Yes at the prompt. 5. Enter No at the backup prompt. There is no need to back up the backup. Enter message action (in IN basket): Ignore// Xtract PackMan Select PackMan function: ? Answer with PackMan function NUMBER, or NAME Choose from: 1 ROUTINE LOAD 2 GLOBAL LOAD 3 PACKAGE LOAD 4 SUMMARIZE MESSAGE 5 PRINT MESSAGE 6 INSTALL/CHECK MESSAGE 7 INSTALL SELECTED ROUTINE(S) 8 TEXT PRINT/DISPLAY 9 COMPARE MESSAGE Select PackMan function: Select PackMan function: 6 INSTALL/CHECK MESSAGE Warning: Installing this message will cause a permanent update of globals and routines. Do you really want to do this? NO// YES Routines are the only parts that are backed up. NO other parts are backed up, not even globals. You may use the Summarize Message option of PackMan to see what parts the message contains. Those parts that are not routines should be backed up separately if they need to be preserved. Shall I preserve the routines on disk in a separate back-up message? YES// NO No backup message built. Line 2 Message #43934 Unloading Routine MAGXXXX (PACKMAN_BACKUP) Select PackMan function: Routine Information: 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 1;Feb 15, 2017 CHECK1^XTSUMBLD is used to generate the checksums. Routine Checksums Routine Checksum Before Checksum After Patch List Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : JR Date Entered : DEC 13, 2021 Completed By: Date Completed: APR 22, 2022 Released By : Date Released : APR 25, 2022 ============================================================================= Packman Mail Message: ===================== No routines included