============================================================================= Run Date: MAY 19, 2026 Designation: MAG*3*384 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #275 Status: Released Compliance Date: JUN 22, 2026 ============================================================================= Associated patches: (v)MAG*3*370 <<= must be installed BEFORE `MAG*3*384' Subject: VISTA IMAGING TELEREADER/VISTA IMAGING TELEREADER CONFIGURATOR Category: - Other - Routine Description: ============ Patch MAG*3.0*384 provides fixes to VistA Imaging TeleReader & VistA Imaging TeleReader Configurator, as well as upgrades of Delphi from 10.4 to 12.2. This patch addresses the following defects and adaptive maintenance: Defects: -------- 1. VISTAIS-5967/INC27601079 - TeleReader Configurator: PIV Certificate not defaulted and certificate selection prompt missing on launch. Location Reporting Incident: Fayetteville VA Medical Center (NC) 2. VISTAIS-5894/INC38066826 - Create new security key for TeleReader Configurator access without MAG SYSTEM key. Location Reporting Incident: Seattle VA Medical Center (WA) Adaptive Maintenance: ===================== 1. VISTAIS-5774 - VistA Imaging TeleReader - Convert VistA Imaging TeleReader Application to Delphi 12.2. 2. VISTAIS-5775 - TeleReader Configurator - Convert TeleReader Configurator Application to Delphi 12.2. 3. VISTAIS-5776 - VistA Imaging TeleReader - Add Delphi Version to the "About Box". 4. VISTAIS-5777 - TeleReader Configurator - Add Delphi Version to the "About Box". 5. VISTAIS-5812 - Update the VistA Imaging System Security Guide and TeleReader Configurator manual to reflect the use of the new key and remove reference to the MAG SYSTEM. EHRM Impact Statement: ---------------------- This patch should have no EHRM impact, and can be installed at all sites, including EHRM converted sites. 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 ----------------- MAGT EDIT CONFIG 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. VISTAIS-5967/INC27601079 - TeleReader Configurator: PIV Certificate not defaulted and certificate selection prompt missing on launch. Location Reporting Incident: Fayetteville VA Medical Center (NC) Problem: -------- Users are unable to select the correct certificate when launching TeleReader Configurator. Users with multiple certificates are unable to choose their primary certificate when logging in. Resolution: ----------- RPC Broker 1.73, a property was added that controls the showing of the certificate selection dialog. The property was set to OFF by default, so set the property to ON for the TeleReader Configurator Application. 2. VISTAIS-5894/INC38066826 - Create new security key for TeleReader Configurator access without MAG SYSTEM key. Location Reporting Incident: Seattle VA Medical Center Problem -------- The TeleReader Configurator GUI Application checks the VistA user's account for the MAG SYSTEM security key. Users without this administrator level key could not run the TeleReader Configurator GUI Application. Resolution: ----------- New security key was added to VistA: MAGT EDIT CONFIG to access TeleReader Configurator. Adaptive Maintenance(s)- ======================== 1. VISTAIS-5774 - Convert VistA Imaging TeleReader Application to Delphi 12.2. Problem: -------- VistA Imaging TeleReader Application, the client needs to be upgraded to the latest version of Delphi (Delphi 12.2) for TRM compliance. Resolution: ----------- Environments were upgraded to Delphi 12.2 and the VistA Imaging TeleReader Configurator application was built and unit tested. 2. VISTAIS-5775 - Convert TeleReader Configurator application to Delphi 12.2. Problem: -------- TeleReader Configurator Application, the client needs to be upgraded to the latest version of Delphi (Delphi 12.2) for TRM compliance. Resolution: ----------- Environments were upgraded to Delphi 12.2 and the TeleReader Configurator application was built and unit tested. 3. VISTAIS-5776 - VistA Imaging TeleReader - Add Delphi Version to the "About Box". Problem: -------- The Delphi Version should be added to the VI TeleReader application "About box" such that users can identify which version of the Delphi that is being used. Resolution: ----------- Coding changes were made to include the current Delphi version in the "About box". 4. VISTAIS-5777 - TeleReader Configurator - Add Delphi Version to the "About Box". Problem: -------- The Delphi Version should be added to the VI TeleReader Configurator application "about box" such that users can identify which version of the Delphi that is being used. Resolution: ----------- Coding changes were made to include the current Delphi version in the "About box". 5. VISTAIS-5812 - Update the VistA Imaging System Security Guide and VistA Imaging System TeleReader Configurator User Guide to reflect the use of the new key and remove reference to the MAG SYSTEM. Problem: -------- In TeleReader Configurator, MAGT EDIT CONFIG security key was added for user access. In addition to this, the updated "About box" was replaced in the VistA Imaging System TeleReader Configurator User Guide. Resolution: ----------- VistA Imaging System Security Guide updated to include Sections 2.8.6 to include MAGT EDIT CONFIG security key details for TeleReader Configurator. VistA Imaging System TeleReader Configurator User Guide - Updated About box for P384. Test Sites - SNOW Change Order #: ----------- Puget Sound Health Care System - Seattle, WA (CO# CHG0728216) Fayetteville Coastal Health Care - Fayetteville, NC (CO#CHG0727409) 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_0P384.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 Format -------------------------------------------------------------------------- Kernel Installation and MAG3_0P384.KID ASCII Distribution System (KIDS) Build for MAG*3.0*384 VistA Imaging TeleReader MAG3_0P384_TELEREADER Binary _INSTALL.MSI Client installation file VistA MAG3_0P384_TELEREADER Binary Imaging TeleReader _SETUP.EXE TeleReader Configurator MAG3_0P384_TELEREADERCONFIGURATOR_ INSTALL.MSI Binary Client installation file MAG3_0P384_TELEREADERCONFIGURATOR_ TeleReader Configurator SETUP.EXE Binary Documentation describing the new functionality is included in this release. Documentation can be found on the VA Software Documentation Library at: VA Software Document Library Documentation Title File Name -------------------------------------------------------------------------- Patch Description for MAG*3.0*384 MAG3_0P384_PATCH_DESCRIPTION.PDF Deployment, Installation, Back-Out, MAG3_0P384_DIBRG.PDF and Rollback Guide VistA Imaging System Security Guide IMGsecgd.PDF VistA Imaging System TeleReader mag_telereader_configurator_user_ Configurator User Guide guide.PDF Patch Installation: ------------------- Pre/Post Installation Overview: Supported Client Versions: When MAG*3.0*384 is released, the list of supported versions of VistA Imaging TeleReader and TeleReader Configurator will change: Telereader Client Versions Supported: 3.0.384 3.0.370 3.0.320 Telereader Configurator Versions Supported: 3.0.384 3.0.370 3.0.352 Client Versions No Longer Supported: 3.0.292 3.0.281 Pre-Installation Instructions: MAG*3.0*384 must be installed on the VistA System on which the VistA Imaging TeleReader and TeleReader Configurator Applications 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 5 minutes to install. Verify that the previous patch in the Supported Client Versions section has been installed. Note: All released VistA Imaging TeleReader and TeleReader Configurator patches must be installed on the VistA system before installing MAG*3.0*384. Routine MAGIP384 is an installation routine that is automatically deleted after the KIDS 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_0P384.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 (MAG*3.0*384). 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. You must use this option and specify what to backup; the entire Build or just Routines. The backup message can be used to restore the routines and components of the build to the pre-patch condition. i. At the Installation option menu, select Backup a Transport Global ii. At the Select INSTALL NAME prompt, enter your build (MAG*3.0*384). 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 this message? 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. 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 of the 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? NO//', answer NO. ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer NO. iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', answer NO. iv. When prompted 'Delay Install (Minutes): (0 - 60): 0//', answer 0. v. 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// Linux Telnet /SSh MAG*3.0*384 ------------------------------------------------------------------------- Installing SECURITY KEY Mar 23, 2026@09:12:14 Running Post-Install Routine: POS^MAGIP384 Post Install Mail Message: Mar 23, 2026@09:12:14 Updating Routine file... Updating KIDS files... MAG*3.0*384 Installed. Mar 23, 2026@09:12:14 ------------------------------------------------------------------------- +------------------------------------------------------------+ 100% | 25 50 75 | Complete +------------------------------------------------------------+ Install Completed Client Installation Instructions For installing or updating VistA Imaging TeleReader, refer to the VistA Imaging TeleReader Installation Guide (VA Software Document Library) - Post-Installation Instructions: Prior to the installation of this patch, users that needed to use TeleReader Configurator were being assigned the MAG SYSTEM security key which also provided administrator level access. Vista TeleReader Configurator users who do not need administrator level access should be de-allocated the MAG SYSTEM security key in VistA and allocated the new MAGT EDIT CONFIG key. To determine who currently holds the MAG SYSTEM key, run the VistA menu option 'List users holding a certain key' (XQSHOKEY) and provide the list to site Clinical Imaging staff. Site Clinical Imaging staff will work with an ISSO at the VistA site to use the VistA menu option 'De-allocation of Security Keys'(XUKEYDEALL) to remove the key from the TeleReader Configurator users as needed. MAG SYSTEM should only be allocated to person(s) managing Imaging/PACs systems. Use the VistA menu option 'Allocation of Security Keys' (XUKEYALL) to assign MAGT EDIT CONFIG to all your TeleReader Configurator users as needed. Back-Out/Roll Back Plan: ------------------------ For information about back-out steps, see document: MAG3_0P384_DIBRG.PDF. Uninstalling the Application: ----------------------------- If it is necessary to uninstall the MAG*3.0*384 client, use the Uninstall option from Programs and Features within Windows Control Panel to Uninstall: VistA Imaging TeleReader and TeleReader Configurator. Then install the previous version of TeleReader Configurator which was included in MAG*3.0*370 and the previous version of VistA Imaging TeleReader which was included in MAG*3.0*370. KIDS Uninstall: ---------------- If it is necessary to uninstall the MAG*3.0*384 VistA KIDS, the patch backup must be installed. The Kernel Installation & Distribution System menu option, Backup a Transport Global should have been used to create a patch backup of the build prior to installing the patch. (see Installation Steps section, step 2b). Administrators will need to check MailMan for the backup message sent by the Backup a Transport Global function executed prior to the patch install. The patch backup must first be loaded from the MailMan backup message, by performing the message action Xtract KIDS, followed by the PackMan function INSTALL/CHECK MESSAGE. The patch may then be installed using the Install Package(s) option in the KIDS Installation menu. 1. Navigate to the Mailman inbox containing the patch backup message. a. Select the MAG*3.0*384 backup message as shown below: * Backup of MAG*3.0*384 install on b. At the "Enter message action:" prompt, select the Xtract PackMan option. c. At the "Select PackMan function:" prompt, select the Install/Check Message option. d. Enter Yes at the prompt "OK to continue with Load?" 2. Navigate to the Kernel Installation and Distribution System Menu and select the Installation Menu. From this menu: a. 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? NO//', answer NO. ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer NO. iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', answer NO. iv. When prompted 'Delay Install (Minutes): (0 - 60): 0//', answer 0. Example, Loading Patch Backup (Build) -------------------------------------------- IN Basket Search *=New/!=Priority.........Subject...............Lines.From.....Read/Rcvd 13093. [313643] 09/06/24 Backup of MAG*3.0*384 3099 Search finished. Enter message number or command: 13093 Subj: Backup of MAG*3.0*384 on Apr 03, 2025 [#313643] Mar 19, 2026@09:26:26 3099 lines From: MANAGER,SYSTEMS In 'IN' basket. Page 1 ------------------------------------------------------------------------- $TXT Created by PROGRAMMER,MAG at DOSO.DOMAIN.EXT (KIDS) on Thursday, 03/19/26 at 12:42 Warning: Installing this backup patch message will install older versions of routines and Build Components (options, protocols, templates, etc.). Please verify with the Development Team that it is safe to install. Enter message action (in IN basket): Ignore// Xtract KIDS Select PackMan function: 6 INSTALL/CHECK MESSAGE Line 8 Message #313643 Unloading KIDS Distribution MAG*3.0*384b OK to continue with Load? NO// YES Distribution OK! Want to Continue with Load? YES// Loading Distribution... MAG*3.0*384b Example, Installing Patch Backup (Build) ----------------------------------------------- Select OPTION NAME: XPD MAIN Kernel Installation & Distribution System Select Kernel Installation & Distribution System Option: Installation Select Installation Option: 6 Install Package(s) Select INSTALL NAME: MAG*3.0*384 3/23/26@09:07:20 => MAG*3.0*384 ;Created on Mar 19, 2026@09:26:26 This Distribution was loaded on Mar 23, 2026@09:07:20 with header of MAG*3.0*384 ;Created on Mar 19, 2026@09:26:26 It consisted of the following Install(s): MAG*3.0*384 Checking Install for Package MAG*3.0*384 Install Questions for MAG*3.0*384 Want KIDS to INHIBIT LOGONs during the install? NO// 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 MAG*3.0*384 -------------------------------------------------------------------------- Installing SECURITY KEY Mar 23, 2026@09:12:14 Running Post-Install Routine: POS^MAGIP384 Post Install Mail Message: Mar 23, 2026@09:12:14 Updating Routine file... Updating KIDS files... MAG*3.0*384 Installed. Mar 23, 2026@09:12:14 ------------------------------------------------------------------------- +------------------------------------------------------------+ 100% | 25 50 75 | Complete +------------------------------------------------------------+ Install Completed Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0;IMAGING;**[Patch List]**;Mar 19, 2002;Build 2 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: MAGGTU4T Before: B5102218 After: B4905369 **93,94,106,117,122,127,182, 219,242,281,292,320,352,370, 384** Routine Name: MAGIP384 Before: n/a After: B4234790 **384** Routine list of preceding patches: 370 Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0;IMAGING;**[Patch List]**;Mar 19, 2002;Build 4 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: MAGGTU4T Before: B5102218 After: B4905369 **93,94,106,117,122,127,182, 219,242,281,292,320,352,370, 384** Routine Name: MAGIP384 Before: n/a After: B4234790 **384** Routine list of preceding patches: 370 ============================================================================= User Information: Entered By : Date Entered : AUG 21, 2025 Completed By: Date Completed: MAY 18, 2026 Released By : Date Released : MAY 19, 2026 ============================================================================= Packman Mail Message: ===================== No routines included