============================================================================= Run Date: AUG 30, 2022 Designation: MAG*3*320 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #227 Status: Released Compliance Date: SEP 30, 2022 ============================================================================= Associated patches: (v)MAG*3*292 <<= must be installed BEFORE `MAG*3*320' Subject: Adaptive Maintenance - VI TeleReader Category: - Routine Description: ============ Description: This document describes MAG*3.0*320, an adaptive maintenance patch that provides fixes to VistA Imaging TeleReader and TeleReader Configurator. This patch addresses the following issues: Defect: -------- 1. INC20652898 - TeleReader Configurator Procedure/Event Index to be defined before you can save an entry for worklist Adaptive Maintenance: --------------------- 1. Adaptive Maintenance - TeleReader - Delphi 10.4 and Accusoft 18 upgrade 2. Adaptive Maintenance - TeleReader Configurator - Delphi 10.4 and Accusoft 18 Upgrade 3. INC20657748 - Adaptive Maintenance - TeleReader Configurator User Guide Associated Patches: ------------------- This patch must be installed after MAG*3.0*292. 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. INC20652898 - TeleReader Configurator requires Procedure/Event Index to be defined before you can save an entry for worklist Problem: -------- Held demonstration of applications (TeleReader & TeleReader Configurator) and showed the issue with the Procedure/Event field as it must be filled out before the "save" button is enabled. Not all sites need to have the Procedure/Event filled out. The worklist dictionary file and CLINICAL SPECIALTY DICOM & HL7 file (#2006.5831) must match. The Edit Clinical Specialties (ECS) menu in VistA does not require the Procedure/Event Index to be populated. The GUI (TeleReader Configurator) should match this and not require the Procedure/Event Index field to be populated. If a site uses the TeleReader Configurator to create the worklist entry and they enter the Procedure/Event Index to enable the "save" button, they will have to take an additional step to remove it via the ECS menu in VistA. Resolution: ----------- Procedure/Event Index field on Acquisition Setup Site / Modality worklist screen is now optional via the TeleReader Configurator. Adaptive Maintenance Tracking System Ticket(s) & Overview: ---------------------------------------------------------- 1. Adaptive Maintenance - TeleReader - Delphi 10.4 and Accusoft 18 upgrade Description: ------------ The following task is for Adaptive Maintenance item: TeleReader Main Delphi 10.4 and Accusoft 18 Upgrade Resolution: ----------- Perform the required testing 2. Adaptive Maintenance - TeleReader Configurator Delphi 10.4 and Accusoft 18 Upgrade Description: ------------ Adaptive Maintenance - TeleReader Configurator Delphi 10.4 and Accusoft 18 Upgrade Resolution: ----------- Perform the required testing 3. INC20657748 - Adaptive Maintenance - Need documentation for TeleReader Configurator User Guide to be updated Description: ------------ Adaptive Maintenance - Need documentation for TeleReader Configurator User Guide to be updated Resolution: ----------- Updated the user manual Test Sites: ----------- Butler VA HCS (Butler, PA) Muskogee VAMC (Muskogee, OK) Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch can be installed by following the installation guide at VistA Imaging System Installation Guide The host file is available at the following location: https://download.vista.domain.ext/index.html/SOFTWARE/MAG3_0P320.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 -------------------------------------------------------------------------- VistA Imaging TeleReader Configurator Installation MAG3_0P320_TELEREADERCONFIGURATOR_INSTALL.MSI VistA Imaging TeleReader Configurator Installation MAG3_0P320_TELEREADERCONFIGURATOR_SETUP.EXE KIDS Build MAG3_0P320.KID VistA Imaging TeleReader Main Installation MAG3_0P320_TELEREADER_INSTALL.MSI VistA Imaging TeleReader Main Installation MAG3_0P320_TELEREADER_SETUP.EXE Documentation Title File Name --------------------------------------------------------------------- Patch Description for MAG*3.0*320 MAG3_0P320_PATCH_DESCRIPTION_PDF Deployment, Installation, Back-Out, and Rollback Guide MAG3_0P320_DIBORG.PDF MAG3_0P320_README.txt for MAG*3.0*320 MAG3_0P320_README.txt VistA Imaging System TeleReader Configurator User Guide MAG_TELEREADER_CONFIGURATOR_USER_GUIDE.PDF NOTE: The reason for the readme file is because on the main screen in VistA Imaging TeleReader Configurator the font style on several buttons do not match. The VistA Imaging Sustainment team will ensure all the button fonts match in MAG*3.0*328. MAG*3.0*328 is scheduled to release in October 2022. Patch Installation: ------------------- Dependencies: ------------- This patch must be installed after MAG*3.0*292. Supported Client Versions: -------------------------- When MAG*3.0*320 is released, the list of supported versions will change: TeleReader Main Versions Supported: 3.0.320 3.0.292 3.0.281 TeleReader Main Versions No Longer Supported: 3.0.242 3.0.219 3.0.182 TeleReader Configurator Versions Supported: 3.0.320 3.0.292 3.0.242 TeleReader Configurator Versions No Longer Supported: 3.0.182 3.0.127 3.0.122 Pre/Post Installation Overview: ------------------------------- MAG*3.0*320 must be installed on the VistA System. This patch must be installed by the compliance date. This patch should take less than five minutes to install. 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. Note: All released VistA Imaging patches must be installed on the VistA system before installing MAG*3.0*320. 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_0P320.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*320). 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*320 11/19/20@10:14:39 => VistA Imaging 3.0 - Patch 320; 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 320; Created on Nov 09, 2020@20:45:05 It consisted of the following Install(s): MAG*3.0*320 Checking Install for Package MAG*3.0*320 Install Questions for MAG*3.0*320 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*320: 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^MAGIP320. Post Install Mail Message: Nov 19, 2020@10:14:53 Updating Routine file...... Updating KIDS files....... MAG*3.0*320 Installed. Nov 19, 2020@10:14:53 Client Installation Instructions -------------------------------- For installing or updating TeleReader Configurator & TeleReader Main, refer to the VistA Imaging System Installation Guide Post-Installation Instructions: ------------------------------- N/A Back-Out/Roll Back Plan: ------------------------ Uninstalling the Application: ----------------------------- For installing or updating TeleReader Configurator & TeleReader Main, refer to the VistA Imaging System Installation Guide KIDS Uninstall: -------------- If it is necessary to uninstall the MAG*3.0*320 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*320 install on And/Or Backup of MAG*3.0*320 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 13 CHECK1^XTSUMBLD is used to generate the checksums. Routine Checksums ----------------- Routine Checksum Before Checksum After Patch List ------- --------------- -------------- ---------- MAGGTU4T 4922300 4926736 **93,94,106,117, 122,127,182,219, 242,281,292,320** MAGIP320 New 4088682 **320** Routine MAGIP320 is an installation routine that is automatically deleted after the KIDS installation. Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : JR Date Entered : OCT 19, 2021 Completed By: Date Completed: AUG 30, 2022 Released By : Date Released : AUG 30, 2022 ============================================================================= Packman Mail Message: ===================== No routines included