============================================================================= Run Date: NOV 17, 2021 Designation: MAG*3*316 Package : MAG - IMAGING Priority: EMERGENCY Version : 3 SEQ #211 Status: Released Compliance Date: NOV 22, 2021 ============================================================================= Subject: Clinical Display Category: - Routine Description: ============ This document describes MAG*3.0*316, a patch that provides fixes to VistA Imaging Clinical Display. This patch addresses the following issues: Defects: -------- 1. IMAG-2363- INC19309150 - It seems that P258 is causing the issue we've been having with people getting "Patient Images Cleared" when trying to view images in VI 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: ----------------------- 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. IMAG-2363- INC19309150 - It seems that P258 is causing the issue we've been having with people getting "Patient Images Cleared" when trying to view images in VI Display. Problem: -------- It seems that P258 is causing the issue we've been having with people getting "Patient Images Cleared" when trying to view images in VI Display. If the user is able to select BILOXI or PENSACOLA when logging in, they can work-around the issue. But if they default Panama City or Mobile CBOCs, they wouldn't see any images, and would only see "Patient Images Cleared" in each patient's record. Resolution: ----------- This problem was caused by new code that was added for the Cerner Enhancement ( MAG*3.0*258), which gets a site code and builds a site descriptor for DOD and for CERNER images. The default code, which retrieves the local site, uses the site name from the return value. However, for some sites there is no local site code. To resolve this, we added a validation such that we do not use the site name when a 'nil' object is returned. Test Sites: ------------ VA Puget Sound Health Care System Boise VA Medical Center Topeka (VA Eastern Kansas HCS) 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_0P316.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_0P316.KID Distribution System (KIDS) build for MAG*3.0*316 VistA Imaging Display client MAG3_0P316_CLINCAL_DISPLAY_SETUP.EXE installation file VistA Imaging Display MSI file MAG3_0P316_CLINICAL_DISPLAY_INSTALL.MSI Documentation Title File Name ------------------------------------------------------------------------ Patch Description for MAG*3.0*316 MAG3_0P316_PATCH_DESCRIPTION.PDF Deployment, Installation, Back-Out, MAG3_0P316_DIBORG.PDF and Rollback Guide Patch Installation: ------------------- Supported Client Versions: When MAG*3.0*316 is released, the list of supported versions of Clinical Display will change: Client Versions Supported: 3.0.316 3.0.258 3.0.256 Client Versions No Longer Supported: 3.0.225 3.0.234 3.0.216 Pre/Post Installation Overview: MAG*3.0*316 must be installed on the VistA System on which the VistA Imaging Application will be used. This patch must be installed by the compliance date. 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. Verify that the previous patch in the Supported Client Versions section has been installed. Note: All released VistA Imaging patches must be installed on the VistA system before installing this patch. 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_0P316.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.). 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. 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 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. KIDS Installation Example: -------------------------- Select Installation Option: 6 Install Package(s) Select INSTALL NAME: MAG*3.0*316 12/19/19@10:14:39 => VistA Imaging 3.0 - Patch 316 ;Created on Dec 09, 2019@20:45:05 This Distribution was loaded on Dec 19, 2019@10:14:39 with header of VistA Imaging 3.0 - Patch 316 ;Created on Dec 09, 2019@20:45:05 It consisted of the following Install(s): MAG*3.0*316 Checking Install for Package MAG*3.0*316 Install Questions for MAG*3.0*316 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*316 : Dec 19, 2019@10:14:53 Build Distribution Date: Dec 09, 2019 Installing Routines:... Dec 19, 2019@10:14:53 Running Post-Install Routine: POS^MAGIP316. Post Install Mail Message: Dec 19, 2019@10:14:53 Updating Routine file...... Updating KIDS files....... MAG*3.0*316 Installed. Dec 19, 2019@10:14:53 Post-Installation Instructions: N/A Back-Out/Roll Back Plan: ------------------------ Uninstalling the Application: If it is necessary to uninstall the MAG*3.0*316 client, use the Uninstall option from Programs and Features within Windows Control Panel to Uninstall: VistA Imaging Clinical Display. Then install the previous version of Clinical Display which was included in MAG*3.0*258. Note: Multi-Division sites may want to revert to MAG*3.0*256 due to an issue found in 258. KIDS Uninstall: If it is necessary to uninstall the MAG*3.0*316 VistA KIDS, then select the Kernel Installation & Distribution System menu option, Backup a Transport Global, (see the Installation Instructions section) where step 2B must be completed 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*316 install on 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 5 CHECK1^XTSUMBLD is used to generate the checksums. Routine Checksums Routine Checksum Before Checksum After Patch List ------- --------------- ------------- ---------- MAGGTU4D 4954392 4960663 **93,94,106,117,122,131,149, 138,156,161,167,181,191,188,216, 234,225,256,258,316** MAGIP316 NEW 4088728 **316** Routine MAGIP316 is an installation routine that is automatically deleted after the KIDS installation. Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : Date Entered : SEP 02, 2021 Completed By: Date Completed: NOV 16, 2021 Released By : Date Released : NOV 17, 2021 ============================================================================= Packman Mail Message: ===================== No routines included