$TXT Created by E at DEVELP.FHIE.DOMAIN.EXT (KIDS) on Wednesday, 02/18/26 at 17:43 ============================================================================= Run Date: APR 16, 2026 Designation: MAG*3*365 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #273 Status: Released Compliance Date: MAY 18, 2026 ============================================================================= Associated patches: (v)MAG*3*122 <<= must be installed BEFORE `MAG*3*365' (v)MAG*3*135 <<= must be installed BEFORE `MAG*3*365' (v)MAG*3*197 <<= must be installed BEFORE `MAG*3*365' (v)MAG*3*258 <<= must be installed BEFORE `MAG*3*365' (v)MAG*3*348 <<= must be installed BEFORE `MAG*3*365' Subject: PREFETCH, ENHANCEMENTS, AND MAINTENANCE Category: - Data Dictionary - Routine - Other Description: ============ This patch addresses the following issues and new capabilities: Unless noted otherwise, each change applies to VIX and Central VistA Imaging eXchange (CVIX). 1. Defect (IMAG-4531) Buffer transaction log database entries. 2. Enhancement (IMAG-4533) Support Presentation State (PR modality) Digital Imaging and Communications in Medicine (DICOM) images in the Viewer. 3. Enhancement (IMAG-4622) Support DOCX files. 4. Enhancement (IMAG-4795) Installation and configuration changes and improvements. 5. Enhancement (IMAG-4807) Commercial off-the-shelf (COTS) package updates for VA Technical Reference Manual (TRM) compliance. 6. Defect (IMAG-4512) VIX was unable to parse VistA patient-study records with a linefeed present in the description. 7. Defect (IMAG-4756) Requests for data that encounter errors (such as from an unresponsive or misconfigured MUSE server) now promptly returns an error in addition to available data. 8. Enhancement (IMAG-4778) Remove unused packages and projects. 9. Defect (IMAG-4861) Allow Importer to retrieve order list for patients not registered in the radiology package. 10. Enhancement (IMAG-4841) Include the application name from the security token in the Tab-separated values (TSV) export of the transaction log. 11. Enhancement (IMAG-4864) Update scheduled task to restart Tomcat and Viewer Services independently. 12. Enhancement (IMAG-4856) Support Windows Server 2022. 13. Defect (IMAG-4887) Imaging Global Node command sometimes returns wrong results for p34 images. 14. Enhancement (IMAG-4752 and IMAG-4624) Improve partial study loads and infinite spinner. 15. Enhancement (IMAG-4899) Replace COTS package for Oracle Java with Amazon Corretto. 16. Defect (IMAG-4878) Embed PDF into DICOM for DICOM QR. 17. Defect (IMAG-4913, INC36852992) Images with missing thumbnails (ABS file) are viewable. 18. Enhancement (IMAG-4460, INC41203710, INC41202913, INC41202555, INC41246299, INC41221216, INC41231794) Add tracking identifier for ingest remote procedure calls. 19. Defect (IMAG-5106) Improve tomcat startup slowed by SQLite VACUUM on transaction log. 20. Enhancement (IMAG-4701 and IMAG-4898) Support for cardiology, dental, and ophthalmology data from Department of Defense (DOD) via Enterprise Clinical Imaging Archive (ECIA). 21. Enhancement (IMAG-4924) Allow C/VIX to retrieve radiology report text for all image types (#2005 and #2005.6*). 22. Enhancement (IMAG-5045) Replace DICOM SCP in memory caching with database implementation. 23. Enhancement (IMAG-5064) Add field name and image type filtering to Study webapp. 24. Enhancement (IMAG-4821) Support Ophthalmic Photography (OP) modality DICOM images with YBR_FULL_422 Photometric Interpolation (PI) and US modality with RGB PI. 25. Enhancement (IMAG-4911, INC36703631, INC36852992, INC25583030) Enhanced MRs stored n the VistA 2005.6* file structure now display in the Viewer. 26. Enhancement (IMAG-5152) Add the software version to the VIX Tools page. 27. Defect (IMAG-5181) DICOM SCP metadata cache time to live (TTL) is not enforced. 28. Defect (IMAG-5211) The restart services script caused outages for JLV. 29. Defect (IMAG-5049) The Viewer defaults to TARGA for files it cannot process. 30. Defect (IMAG-4965) The Viewer does not display radiation dose Structure Reports (SRs). 31. Enhancement (IMAG-4591) Automated retrieval of prior studies (prefetch). 32. Enhancement (IMAG-4847) Improve Tomcat shutdown performance. 33. Enhancement (IMAG-5135) Support Kerberos authentication for VistA imaging data. 34. Defect (IMAG-5723) Imaging Site Usage report crash on image with Tracking ID and no Acquisition Device. EHRM Impact Statement: ---------------------- This patch should have no EHRM impact, and can be installed at all sites, including EHRM converted sites. Patch Components: ----------------- N/A Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- IMAGING SITE PARAMETERS (#2006.1) PRECACHE SETTINGS (#350) NEW PRECACHE CPT CODE (#.01) NEW ON ORDER SIGNED (#1) NEW ON EXAM REGISTERED (#2) NEW PRECACHE ON RAD EXAM REG (#351) NEW Forms Associated: Form Name File Number New/Modified/Deleted --------- ----------- -------------------- N/A Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- MAGCACHECFG NEW Options Associated: Option Name Type New/Modified/Deleted ----------- ---- -------------------- MAG CACHE SETTINGS UPDATE Server NEW MAG PRECACHE QUEUE MANAGER Run Routine NEW Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- MAG PRECACHE ORDER SIGNED NEW 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 --------------------- -------------------- MAG4 IMAGE LIST MODIFIED MAG4 PAT GET IMAGES MODIFIED MAGN CPRS IMAGE LIST MODIFIED 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): Defect Tracking System Ticket(s) & Overview: (IMAG numbers are from VA Jira) 1. Defect (IMAG-4531) Buffer transaction log database entries. Problem: -------- C/VIX can unintentionally lock the transaction log SQLite database such as when backups occur. This causes errors and transaction log entries not to be inserted. Resolution: ----------- A new configuration parameter (maxObjectsToKeep) in the TransactionLoggerJdbSource-1.0.config file now specifies the maximum transactions to buffer in memory to save in the log. When this maximum is exceeded, errors are logged and additional transaction log entries are not inserted. 2. Enhancement (IMAG-4533) Support Presentation State (PR modality) Digital Imaging and Communications in Medicine (DICOM) images in the Viewer. Problem: -------- The Viewer displayed a thumbnail for PR DICOM images, but no image displayed in the Viewport. Resolution: ----------- Now thumbnails for PRs are not displayed as they are non-viewable images and describe visual specifications regarding other DICOM image(s) in the study. The Image Information option in the External Links menu in the Viewer shows the study's PR(s). Further, graphic annotations now display drawn on the referenced DICOM images and can be toggled on and off. 3. Enhancement (IMAG-4622) Support DOCX files. Problem: -------- When a user views a DOCX file in the VIX Viewer, the file never displays. Also, when consumers of the web API call the servePdf endpoint, the file is not included. Resolution: ----------- The VIX Viewer now uses LibreOffice to convert a DOCX file to a Portable Document Format (PDF) file for display, which allows print and export. The servePdf web API introduced in MAG*3.0*348 for scanned documents now includes DOCX images converted to PDFs. 4. Enhancement (IMAG-4795) Installation and configuration changes and improvements. A. Add VIX shortcuts folder on the desktop that includes shortcuts to the scripts folder, restart script, and installer. Problem: -------- Users experience inefficiency having to navigate long paths to access the VIX scripts folder, restart script, and VIX Service Installation Wizard. Resolution: ----------- The VIX Installer now adds a VIX shortcuts folder on the desktop, streamlining access and saving time. The VIX shortcut folder contains: * A shortcut to the scripts folder, providing quick access to all VIX scripts. * A shortcut to the restart VIX services script, allowing for easy restarting of VIX services. * A shortcut to the VIX installer, launching the VIX Service Installation Wizard. B. Remove potential Commercial-Off-The-Shelf (COTS) downgrades from the Installer. Problem: -------- When the Installer is run on a non-production VIX server that has received a COTS upgrade, the VIX Prerequisites page in the Installation Wizard does not allow one to complete Installation as the Installer requires a particular COTS version and does not support higher versions. Resolution: ----------- The VIX Prerequisites page in the Installation Wizard now requires a minimum COTS version. The Installer now allows a Java 8 or Apache Tomcat 9 minor version to be installed if higher than the minimum required. The Installer also allows a LibreOffice or PowerShell 7 major version to be installed that is higher than the minimum required. C. Add scheduled task to install the latest CVIX certificate. Problem: -------- The VIX has a dependency on a CVIX certificate that expires once a year. To minimize downtime for the certificate update across all VIX, a scheduled task was desired. Resolution: ----------- Now the VIX Installer installs a Windows scheduled task to update the CVIX certificate before the current certificate expires. The scheduled task runs approximately once a year and simultaneously across all VIX to minimize potential downtime. D. Preserve transaction log database during installation. Problem: -------- The automatic deletion of the transaction log database was no longer needed after the VIX transaction log database was migrated to SQLite in MAG*3.0*348. Resolution: ----------- The VIX Install now does not delete the VIX transaction log database (VixTx.db) as part of the VIX Installation Wizard. E. Remove duplicate configuration file backups. Problem: -------- The Installer was creating duplicate backups of critical configuration files. Resolution: ----------- Now the Installer no longer creates timestamped file backups of critical configuration files and removes these old duplicate files. The configuration files continue to be backed up at the folder level in C:\VIXBackup. F. Remove all ListenerTool code from the Installer. Problem: -------- The ListenerTool was removed in MAG*3.0*358 and it was no longer necessary to have the Installer support the removal of the ListenerTool. Resolution: ----------- Now the Installer no longer contains code to support the removal of the ListenerTool as the ListenerTool was removed. G. Update Java Virtual Memory (JVM) memory heap size. Problem: -------- To reduce the risk of memory-related errors when loading large imaging studies, there was desire to increase the JVM heap size by allocating more system Random Access Memory (RAM). Resolution: ----------- Now the Installer by defaults sets the initial heap size and maximum heap size for the JVM to 50% of system RAM. H. Add logging to the restart services script. Problem: -------- There was desire to have the restart services script log the output of the script for troubleshooting purposes. Resolution: ----------- Now, when the Windows scheduled tasks restart Tomcat and the Viewer Services every morning, the restart services script logs its output to C:\Program Files\VistA\Imaging\Scripts\restart_vix_services_log.txt. 5. Enhancement (IMAG-4807) Commercial off-the-shelf (COTS) package updates for VA Technical Reference Manual (TRM) compliance. Problem: -------- COTS packages required an upgrade in accordance with the TRM. Resolution: ----------- The Apache Tomcat version in MAG*3.0*358 was 9.0.89 and upgraded to 9.0.107 in accordance with the TRM. The LibreOffice version in MAG*3.0*358 was 24.2.5 and upgraded to 25.2.5 in accordance with the TRM. The PowerShell 7 version in in MAG*3.0*358 was 7.3.9 and upgraded to 7.5.0 in accordance with the TRM. The SignalR version used by the VIX Viewer was 2.2.0 in MAG*3.0*358 and upgraded to 2.4.3 in accordance with the TRM. The Microsoft Entity Framework used by the VIX Viewer was version 6.4.4 in MAG*3.0*358 and upgraded to version 6.5.1 in accordance with the TRM. The Log4j version in MAG*3.0*365 was 2.21.1 and upgraded to 2.25.3 in accordance with the TRM. 6. Defect (IMAG-4512) VIX was unable to parse VistA patient-study records with a linefeed present in the description. Problem: -------- When VIX called the RPC MAG4 PAT GET IMAGES to retrieve patient-study records from VistA a linefeed in the description caused VIX to fail to parse the return values correctly. Resolution: ----------- VistA now removes linefeeds from the study description when the VIX calls the RPC MAG4 PAT GET IMAGES with an *O* option flag. 7. Defect (IMAG-4756) Requests for data that encounter errors (such as from an unresponsive or misconfigured MUSE server) now promptly returns an error in addition to available data. Problem: -------- When a request for a patient's record included multiple datatypes (cardiology, radiology, MUSE, etc.), the response would be delayed if part of the request to a data source fails (such as an unresponsive or misconfigured MUSE server). After the delay, eventually a response that contains successfully retrieved data from available data source(s) for requested datatype(s) is received. Resolution: ----------- When part of a request for a patient's record fails, the VIX now promptly handles the error and reports it in the form of a study along with other datatype result(s) if requested. Further, to provide a faster response time, the intermediary thread pool for HTTP requests to the MUSE is no longer used. 8. Enhancement (IMAG-4778) Remove unused packages and projects. Problem: -------- C/VIX contained several packages and projects which were no longer used. Resolution: ----------- Several unused packages and projects have been removed from the C/VIX code base to facilitate merging of shared code. 9. Defect (IMAG-4861) Allow Importer to retrieve order list for patients not registered in the radiology package. Problem: -------- When an Importer User selects a DICOM Correct worklist item for a patient that is registered in VistA but has never had a radiology order, the Importer User receives an error rather than a list of orders for that patient. VIX calls the VistA RPC MAGV GET PAT ORDERS with a RAD argument, receives an error from VistA, and returns that error to the Importer. Resolution: ----------- The Importer User now receives the CON and LAB orders rather than an error. Now when the VIX calls the VistA RPC MAGV GET PAT ORDERS with a RAD argument and receives an error from VistA, the VIX continues processing and the error is routed to the VIX logs. 10. Enhancement (IMAG-4841) Include the application name from the security token in the Tab-separated values (TSV) export of the transaction log. Problem: -------- The TSV export of the transaction log did not contain the application name from the security token. Resolution: ----------- Now the TSV export of the transaction log contains the application name from the security token. 11. Enhancement (IMAG-4864) Update scheduled task to restart Tomcat and Viewer Services independently. Problem: -------- Tomcat and the Viewer Services were restarted every early morning using a single Windows scheduled task and there was desire to split the Tomcat and the Viewer Services to restart independently. Resolution: ----------- Now two separate Windows scheduled tasks are scheduled every early morning, one to restart Tomcat and one to restart the Viewer Services. The time restarts occur each day can be changed manually if desired. 12. Enhancement (IMAG-4856) Support Windows Server 2022. Problem: -------- The C/VIX did not support Windows Server 2022. Resolution: ----------- The VIX Installer was updated to add Windows Server 2022 as a prerequisite supported version. To comply with group policy password requirements the VIX Installer was updated to require the Windows account named *apachetomcat* that runs the VIX in the Tomcat environment contains at least fifteen alphanumeric characters. The Windows Server 2022 upgrade is not required for VIX as it was driven by a CVIX only upgrade. 13. Defect (IMAG-4887) Imaging Global Node command sometimes returns wrong results for p34 images. Problem: -------- VIX could sometimes return an incorrect result from the MAGG SYS GLOBAL NODE RPC to Clinical Display and VIX Viewer clients. Resolution: ----------- VIX now makes a second call to VistA as part of its MAGG SYS GLOBAL NODE processing to ensure information for the correct record was retrieved before returning the result through its web interfaces. 14. Enhancement (IMAG-4752 and IMAG-4624) Improve partial study loads and infinite spinner. Problem: -------- When a user views certain studies in the VIX Viewer, sometimes two different things happen: 1) An error displays indicating only a partial set of the files could be processed; or 2) A spinner infinitely displays. For the partial set of files, when the user chooses to proceed anyway, no thumbnails display for the problem files, and there is no indication what the files are. For the infinite spinner, nothing else displays. Resolution: ----------- Now, the Viewer no longer displays the partial error message, and the Viewer reduces the frequency of infinite spinners. When these types of studies load, the Viewer now: 1) Shows a thumbnail for each image indicating the image is unviewable; 2) The viewport contains an image explaining why the file cannot be displayed; and 3) For DICOM files, the Image Info main toolbar icon lets the user see the DICOM header, if possible. For example, the Unviewable thumbnail now displays when a RAW DICOM (SOP Class UID 1.2.840.10008.5.1.4.1.1.66) is in the study. The Viewer also has a new Reload Study main toolbar icon that purges (deletes the study from the Render cache) and reloads the study to try again. Note that all error conditions causing the infinite spinner are not yet handled. As we discover unhandled conditions, we will add them to this new feature. 15. Enhancement (IMAG-4899) Replace COTS package for Oracle Java with Amazon Corretto. Problem: -------- There was desire to replace the Oracle Java COTS package with Amazon Corretto. Resolution: ----------- The VIX installer now uninstalls Oracle Java, installs Amazon Corretto 8.472 in accordance with the TRM, and fully transitions the VIX to utilizing Amazon Corretto. The path is C:\Program Files\Amazon Corretto. 16. Defect (IMAG-4878) Embed PDF into DICOM for DICOM QR. Problem: -------- Previously when receiving a PDF from CCIA, the DICOM QR does not deliver the PDF. Resolution: ----------- Now the DICOM QR converts the PDF into a DICOM file to deliver it to the client. 17. Defect (IMAG-4913, INC36852992) Images with missing thumbnails (ABS file) are viewable. Problem: -------- Images that are missing thumbnails (ABS file) cause VIX study and image queries to fail. Resolution: ----------- Now when querying for studies and images with a missing thumbnail (ABS file), a warning is logged and the images are viewable. 18. Enhancement (IMAG-4460, INC41203710, INC41202913, INC41202555, INC41246299, INC41221216, INC41231794) Add tracking identifier for ingest remote procedure calls. Problem: -------- Images ingested via the IngestWebApp or TIU consolidated ingest endpoints did not include a value for the 108 / TRACKING ID field in the VistA MAG4 ADD IMAGE remote procedure call (RPC). As a result, it was difficult to track the source of origin for ingest remote procedure calls. Resolution: ----------- Now upon ingesting an image, the response message contains an HTTP header with the tracking ID generated and the tracking ID and device acquisition ID are now associated with the image file in VistA. This tracking identifier field provided in the RPC call is randomly generated and is trimmed to a maximum length of 30. 19. Defect (IMAG-5106) Improve Tomcat startup slowed by SQLite VACUUM on transaction log. Problem: -------- During Tomcat startup, the SQLite VACUUM command was executed on the VIX Transaction Log database, causing database restructuring and file optimization, which led to slow Tomcat startup times. Resolution: ----------- Tomcat startup time is now improved as the SQLite VACUUM command is only executed once a week on the VIX Transaction Log database. The day of the week is configurable with a new parameter named dayOfWeekToVacuum in TransactionLoggerJdbcSource-1.0.config which defaults to Sunday (a value of 7). Further, now when accessing the VIX Transaction Log database, the SQLite VACUUM command is no longer executed. 20. Enhancement (IMAG-4701 and IMAG-4898) Support for cardiology, dental, and ophthalmology data from Department of Defense (DOD) via Enterprise Clinical Imaging Archive (ECIA). Problem: -------- Users cannot currently query DOD / ECIA for cardiology, dental, and ophthalmology data. Resolution: ----------- The CVIX now supports additional ECIA configuration endpoints via the MIXDataSource-1.0.config to support querying and receiving cardiology, dental, and ophthalmology data from DOD. The imageFilter now accepts DENT (for dental) and OPHTH (for ophthalmology) in the /vix/viewer/studyquery API call. The cardiology, dental, and ophthalmology data now work through federation to get ECIA DoD data, by improved logic to determine the client origin. 21. Enhancement (IMAG-4924) Allow C/VIX to retrieve radiology report text for all image types. Problem: -------- Users of JLV, MHV, and other C/VIX consumers were only able to view radiology report text if the images were stored in the IMAGE file (#2005). The radiology report text would not be returned for studies containing only enhanced (P34) images stored in the 2005.6* file structure. Resolution: ----------- C/VIX now returns the radiology report text for all images that are associated with a radiology exam regardless of how they are stored. 22. Enhancement (IMAG-5045) Replace DICOM SCP in memory caching with database implementation. Problem: -------- Until now, the DICOM SCP used in memory caching and there was desire to persist information with a database. Resolution: ----------- Now the DICOM SCP uses database caching using SQLite which persists data. A new configuration file (QRCache.Config) adds options for this configuration. 23. Enhancement (IMAG-5064) Add field name and image type filtering to Study webapp. Problem: -------- Some study query responses were large and could produce issues for clients. Resolution: ----------- Now query parameters have been added to the Study webapp to reduce the number of the field names and image types returned. Users can now specify the HTTP query parameters *filterFields*, a comma-separated list of field names to allow (e.g., *dicomUid*), and *filterImageTypes*, a comma-separated list of image types to allow (e.g. *jpeg*). 24. Enhancement (IMAG-4821) Support Ophthalmic Photography (OP) modality DICOM images with YBR_FULL_422 Photometric Interpolation (PI) and US modality with RGB PI. Problem: -------- Previously, DICOM images with a YBR_FULL_422 or RGB PI displayed as grayscale in the VIX Viewer. Resolution: ----------- Now the Viewer processes DICOM images with YBR_FULL* and RGB PI as colorized JPEGs, where * stands for any text. 25. Enhancement (IMAG-4911, INC36703631, INC36852992, INC25583030) Enhanced MRs stored in the VistA 2005.6* file structure now display in the Viewer. Problem: -------- Previously, when an enhanced MR (1.2.840.10008.5.1.4.1.1.4.1) was stored in the VistA 2005.6* file structure, the image would not display. Resolution: ----------- The image now displays. 26. Enhancement (IMAG-5152) Add the software version to the VIX Tools page. Problem: -------- Previously, the VIX Tools page did not show the software version. Resolution: ----------- Now the VIX Tools page shows the version in the lower right-hand corner. 27. Defect (IMAG-5181) DICOM SCP metadata cache time to live (TTL) is not enforced. Problem: -------- DICOM SCP's cache enforcement mechanism failed to evict stale metadata. Resolution: ----------- Now DICOM SCP evicts stale metadata, determining if a cached metadata file is stale based on file age and the cacheMetaHoursToLive configuration property in C:\VixConfig\ScpConfiguration.config. 28. Defect (IMAG-5211) The restart services script caused outages for JLV. Problem: -------- In the restart services script, which restarts Tomcat and the Viewer services nightly, the restart of Tomcat occurred before the Viewer Services which lead to potential outages for JLV users. Resolution: ----------- Now the Viewer Services stop before Tomcat restarts, and a wait is added for the Tomcat visa page to be available before the Viewer Services start again, to prevent potential outages for JLV users. 29. Defect (IMAG-5049) The Viewer defaults to TARGA for files it cannot process. Problem: -------- Previously, when the Viewer received a file it cannot process, such as a file structured with a vendor-specific format, the Viewer processed the file as if it's a TARGA file and if it isn't, displayed an infinite spinner. Resolution: ----------- Now when the Viewer receives a file it cannot process, an exception is thrown and the Viewer displays an unviewable thumbnail along with image in the viewport explaining why the file cannot be displayed. 30. Defect (IMAG-4965) The Viewer does not display radiation dose Structured Reports (SRs). Problem: -------- Previously, the Viewer assumed a radiation dose SR file always contained pixel data and if this was not the case, the Viewer failed to display the report and instead displayed an infinite spinner. Resolution: ----------- Now when the Viewer receives a radiation dose SR file without pixel data, the Viewer displays the radiation dose SR. 31. Enhancement (IMAG-4591) Automated retrieval of prior studies (prefetch). Problem: -------- DICOM Query/Retrieve for remote prior studies sometimes resulted in delays, causing end users, such as mammography technicians, to wait longer than desired and hindered timely access to relevant comparison studies. Resolution: ----------- When a study is registered (or order signed for mammography) in VistA, CVIX now receives a notification and matches the registered Current Procedural Terminology (CPT) code to relevant remote prior exams. Once the matching is complete, CVIX moves the studies to any subscribed STORE SCP (Picture Archiving and Communication System - PACS) devices. Both VistA and CVIX have configuration files to determine which CPT codes generate notifications to CVIX and at which sites, what the matching rules are for each CPT code, and what devices are subscribed to each set of matching rules at each site. Additionally, a new nightly job, MAG PRECACHE QUEUE MANAGER, now cleans up precache work items that remain unprocessed for a week or older. 32. Enhancement (IMAG-4847) Improve Tomcat shutdown performance. Problem: -------- Tomcat shutdown in newer versions of Tomcat 9 was taking longer than expected and caused error messages, leading to delays for end users. Resolution: ----------- Enhancements were made to the "Fast Data Transfer" (FDT) library and to the VIX thread system for both to better handle shutdown events. Now with newer versions of Tomcat 9, the service stops within a reasonable amount of time. 33. Enhancement (IMAG-5135) Support Kerberos authentication for VistA imaging data. Problem: -------- VistA Imaging is replacing NT LAN Manager (NTLM) authentication with Kerberos to enhance security and authentication standards. Resolution: ----------- C/VIX now allows administrators to enable and configure Kerberos-based authentication as a replacement for NTLM. C/VIX now allows administrators to configure Kerberos-based authentication as a replacement for NTLM. A new configuration file (VistaStorageConfiguration.config) adds Kerberos configuration that defaults to enabled (useKerberos set to true). 34. Defect (IMAG-5723) Imaging Site usage report crash on image with Tracking ID and no Acquisition Device. Problem: -------- When an image is ingested with a Tracking ID but without setting an Acquisition Device, the monthly background job that transmits data for the Imaging Site Usage report to MAG Enterprise will crash. This will result in Imaging management not having the report data for that site and may result in the system administrator(s) for that site receiving repeated notifications that the report did not run. Resolution: ----------- CVIX will now include an Acquisition Device of "CVIX" when ingesting an image with a Tracking ID but without a specified Acquisition Device. The background job that performs the report extract has also been fixed so that it will no longer crash when processing an existing image with that particular condition. Additionally, any missed reports that should have transmitted between 01/01/2026 and the date of the patch install will be transmitted using the fixed code. Test Sites: ----------- * North Florida VAMC * Philadelphia VAMC * South Texas VAMC Test Sites - ServiceNow (SNOW) Change Order # for VistA: North Florida VAMC: Change Order #: CHG0687538 Philadelphia VAMC: Change Order #: CHG0687527 South Texas VAMC: Change Order #: CHG0686815 Software and Documentation Retrieval Instructions: --------------------------------------------------------------- The software for this patch is being released in a PackMan message. This release includes software files. They can be obtained at location: /srv/vista/patches/SOFTWARE. Software files can also be obtained by accessing the URL: https://download.vista.domain.ext/index.html/SOFTWARE. File Title File Name -------------------------------------------------------------------------- VistA Imaging eXchange (VIX) Installer MAG3_0P365_VIX_SETUP.MSI Central VistA Imaging eXchange (CVIX) Installer* MAG3_0P365_CVIX_SETUP.MSI Documentation describing the new functionality is included in this release. Product documentation can be found on the VA Software Documentation Library at: https://www.domain.ext/vdl/application.asp?appid=105. Documentation can also be obtained at https://download.vista.domain.ext/index.html/SOFTWARE. Documentation Title File Name -------------------------------------------------------------------------- Deployment, Installation, Backout, and Rollback Guide MAG3_0P365_DIBRG.PDF Patch Description MAG3_0P365_PATCH_DESCRIPTION.PDF VistA Imaging eXchange (VIX) Installation Guide MAG3_0P365_VIX_INSTALLATION_GUIDE.PDF Central VistA Imaging eXchange (CVIX) Installation Guide* MAG3_0P365_CVIX_INSTALLATION_GUIDE.PDF VistA Imaging eXchange (VIX) Administration Guide MAG3_0P365_VIX_ADMINISTRATION_GUIDE.PDF CVIX Administrator's Guide and Product Operations Manual* MAG3_0P365_CVIX_POM.PDF *Note: Only the VistA patch and VIX clients for MAG*3.0*365 should be installed at medical centers. As a result, the CVIX Installer and related CVIX installation files are not provided to sites on the Network File Shares. Patch Installation: ------------------- Pre/Post Installation Overview: MAG*3.0*365 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 VistA portion of this patch. This patch may be loaded while the VistA Imaging System is active. The installation takes less than one minute. In order to insure that CVIX is able to continue functioning after more restrictive RPC Broker security is implemented, the post-install routine adds the following RPCs to the OR CPRS GUI CHART RPC Context: * VAFCTFU GET TREATING LIST * VAFCTFU CONVERT DFN TO ICN * VFC LOCAL GETCORRESPONDINGIDS * ORRCQLPT PTDEMOS * DDR FILER * DSIC DPT GET ICN 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 5 minutes to install. For pre-installation instructions, please see the MAG3_0P365_VIX_INSTALLATION_GUIDE.PDF for more detail. Installation Instructions: 1. Choose the PackMan message containing this build. Then select the INSTALL/CHECK MESSAGE PackMan option to load the build. 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 name MAG*3.0*365. NOTE: Using does 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 does not backup any other changes such as DDs or templates. C. You may also elect to use the options: i. Print Transport Global - This option allows you to view the components of the patch. ii. Compare Transport Global to Current System - This option allows you to view all changes 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. When prompted 'Enter the Coordinator for Mail Group 'MAGCACHECFG': ', answer POSTMASTER. ii. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//', answer iii. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer . iv. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', answer Patch installation takes 2 - 5 minutes. For VIX instructions, please see the MAG3_0P365_VIX_INSTALLATION_GUIDE.PDF for more detail. Installation Verification: Use the Install File Print option on the Utilities menu under KIDS and select MAG*3.0*365 to verify successful VistA installation. Successful VIX installation can be verified by following the instructions in the MAG3_0P365_VIX_INSTALLATION_GUIDE.PDF. Post-Installation Instructions: After installing the MAG*3.0*365 patch, you will need to schedule the nightly job to maintain the precache work item queue. From the TaskMan Management menu [XUTM MGR], select the option for Schedule/Unschedule Options [XUTM SCHEDULE]. You will be asked to "Select OPTION to schedule or reschedule". Enter "MAG PRECACHE QUEUE MANAGER" and press enter. You will be asked "Are you adding 'MAG PRECACHE QUEUE MANAGER' as a new OPTION SCHEDULING (the 255TH)?", to which you should answer YES and press enter. A new screen will come up entitled Edit Option Schedule. In the QUEUED TO RUN AT WHAT TIME field, enter a date and time, for example T+1@3AM in order to schedule the option to run tomorrow morning. In the RESCHEDULING FREQUENCY field, enter 1D in order to run the job every day. Navigate to the bottom of the screen and enter the SAVE command, followed by EXIT. For additional client post-installation instructions, please see the MAG3_0P365_VIX_INSTALLATION_GUIDE.PDF for more detail. Back-out Procedures for MAG Routines ------------------------------------ Back-out can be done only with the concurrence and participation of the development team and appropriate VA site/region personnel. The decision to back-out or rollback software can be a joint decision between the development team, VA site/region personnel, and other appropriate VA personnel. Rollback, Back Out, or Uninstalling MAG*3.0*365 MSI -------------------------------------------------- If it is necessary to uninstall the MAG*3.0*365 VIX MSI, use the Uninstall option from Windows Control Panel to uninstall: "VIX Service Installation Wizard 30.365.4.84XX". Then install the previous version of VIX, which was included in MAG*3.0*358. To back out the VIX and replace it with the prior version, please see the MAG3_0P365_VIX_INSTALLATION_GUIDE.PDF for more detail. The versions should be validated during uninstall, rollback or back-out if necessary. Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0;IMAGING;**[Patch List]**;April 15, 2025;Build 19 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: MAGCQMGR Before: n/a After: B6019070 **365** Routine Name: MAGDQR21 Before:B194419260 After:B203546548 **83,104,123,119,221,348,365** Routine Name: MAGGAII Before:B177433198 After:B184096473 **93,94,122,365** Routine Name: MAGGI13 Before: B65233516 After: B66126217 **93,117,122,365** Routine Name: MAGGI14 Before: B39084079 After: B39261581 **93,365** Routine Name: MAGIP365 Before: n/a After: B22944669 **365** Routine Name: MAGNTRAI Before: B82064307 After: B90741273 **170,185,365** Routine Name: MAGNUTL2 Before: B23733574 After: B30348765 **201,221,365** Routine Name: MAGNUTL3 Before: n/a After: B26658383 **365** Routine Name: MAGNUTL4 Before: n/a After: B17839936 **365** Routine Name: MAGNVQ06 Before: B45900223 After: B50551916 **185,197,365** Routine Name: MAGQE3 Before: B76069024 After: B78400842 **27,29,30,20,46,135,365** Routine Name: MAGSIXG1 Before: B40907827 After: B42558971 **8,48,59,93,117,221,365** Routine Name: MAGSIXG3 Before:B109900690 After:B114117847 **93,117,150,138,167,221,258,365** Routine list of preceding patches: 122, 135, 197, 258, 348 ============================================================================= User Information: Entered By : Date Entered : JAN 31, 2024 Completed By: Date Completed: APR 15, 2026 Released By : Date Released : APR 16, 2026 ============================================================================= Packman Mail Message: ===================== $END TXT