============================================================================= Run Date: MAR 21, 2022 Designation: MAG*3*274 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #217 Status: Released Compliance Date: APR 21, 2022 ============================================================================= Subject: LDGW Cache Service Defect Category: - Routine - Other Description: ============ This document describes MAG*3.0*274, a patch that provides fixes to VistA Imaging LEGACY DICOM GATEWAY. This patch addresses the following issues: Defects: -------- 1. INC09453177 - Cache Management studio There is 1 additional ticket related to the same issue: (INC18650857) 2. INC10848851 - DICOM GATEWAY MUMPS ERROR There are 2 additional tickets related to the same issue: (INC10935025) (INC20475888) 3. INC13061534 - Mumps Error on Text Gateway on UPDATE+2^MAGDWLPA There is 1 additional ticket related to the same issue: (INC18464175) 4. INC18631808 - Text gateway 1-4 process stalls out and finally requires a restart after 2 to 3 pages of data. 5. INC18074700 - VISN 16 NOL TXT gateway continuously prompting to delete old DICOM files Patch Components: ----------------- MAG3_0P274.KID - Kernel Installation and Distribution System (KIDS) build for Patch 274 - New MAG3_0P274_DICOM_Setup.exe - Legacy DICOM Gateway Installation File - New MAG3_0P274_DIBORG.PDF - Legacy DICOM Gateway Deployment, Installation, Back-Out, and Rollback Guide - New MAG3_0P274_README.PDF - MAG3 0P274 ReadMe File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- Forms Associated: Form Name File Number New/Modified/Deleted --------- ----------- -------------------- N/A Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- N/A HDIG 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. INC09453177 - Cache Management studio There is 1 additional ticket related to the same issue: (INC18650857) Problem: -------- Details: Required login and modify System > Security Management > Services can be bypassed without being prompted for username / password.http://xx.xxx.xxx.xxx:57772/csp/sys/UtilHome.csp requires log inhttp://xx.xxx.xxx.xxx:57772/csp/sys/sec/%25CSP.UI.Portal.Services.zen# Resolution: ----------- Update the ModServices class method in the DefaultInstallClass.XML distribution file with calls to two %Security methods to set two properties. 2. INC10848851 - DICOM GATEWAY MUMPS ERROR There are 2 additional tickets related to the same issue: (INC10935025) (INC20475888) Problem: -------- Note: Duplicate of INC10935025 Details: The error below was generated when the users at the Amarillo VAMC attempted to migrate TGA images to a new McKesson PACS using the 2-8-2 Legacy DICOM Gateway options. Wed 09:12 Error: PUTVALUE+7^MAGDDW4 -------------------------------------------------------------------------- ----- - DICOM GATEWAY MUMPS ERROR - - Error: PUTVALUE+7^MAGDDW4 - - "" at PUTVALUE+7^MAGDDW4 - - MUMPS Code: " I $T(@VR)'="" D @VR Q" - - Please check the system error log for details - - - - MAGDSTRT Please Call Support Personnel - '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' '''''The CLIN3 team analysis shows that the Value Representation (VR) line label "US or OW" is an invalid line label for the ^MAGDDW4 routine resulting in the syntax error. Resolution: ----------- Modified instances of VR handling logic to use an existing check and VR normalizing code to reduce the VR to a single type. 3. INC13061534 - Mumps Error on Text Gateway on UPDATE+2^MAGDWLPA There is 1 additional ticket related to the same issue: (INC18464175) Problem: -------- Note: Duplicate of INC18464175 The Leavenworth VA Medical Center, which is part of VISN 15 Western Orbit encountered an error on one of the Text Gateways. The error occurs during the workflow for processing orders through the Test Gateway - after an order has been placed and the 1-1 menu prompts are used to send the orders through the Text Gateway. Based on the notes in the SN ticket - The Leavenworth VA Medical Center is part of VISN 15 Western Orbit where there are multiple associated gateways, however, the error often occurs only with one particular text gateway and not on the other gateways at the same site. Per the SN ticket "Normally", if one text [gateway] encounters a mumps error, the rest of the integrated sites also encounter the problem. The ServiceNow ticket indicates that this has been an ongoing issue for a couple of months prior to it being escalated to the Sustainment team. When this happens and the text gateway stops processing, the 1-8 Text Gateway menu is used to "Modify the HL7 Message Pointer" was used to allow the user to proceed - but when the user reprocess with the 1-1 Text Gateway menu the problem occurs again. The error occurs in UPDATE+2^MAGDWLPA when there is no zero node. The capture of the error is displayed below. Resolution: ----------- Update code syntax to prevent an undefined error if no node 0 of ^MAGDWLST(2006.55,DIVISION,1,DFN,0) exists. 4. INC18631808 - Text gateway 1-4 process stalls out and finally requires a restart after 2 to 3 pages of data. Problem: -------- Text Gateway 1-4 process stalls out and requires a restart after 2 to 3 pages of data. The Text Gateway window 1-4 stops processing data and then times out after a few windows. If caught early you can enter until the Exit? no// option is reached. When the user selects option 4 - 'Display Modality Worklist Statistics' from the VistA DICOM Text Gateway and presses 'Enter to continue' through to the end of compiling modality worklist statistics screen(s) and through to the end of today's Modality Worklist Activity screen(s) - at the end of the Modality Worklist Activity screen(s), the system presents the Exit? No // prompt - at this point the system refreshes and should continue to refresh after every 30 seconds but it does not. From this point on, the system will not continue to refresh, and the users have to manually press enter to continue through each page - if the users do not press enter at each page, the system times-out and goes back to the VistA DICOM Gateway Menu. The users are asking that when the Press to continue prompt displays at the list of today's Modality Worklist(active modalities) the system should keep refreshing after 30 seconds instead of stopping and requiring the user action to move forward. The solution needs to allow the active modalities to refresh every 30 seconds and advance to the next page without user intervention. The users need to be able to see what modalities are processing through. At the very end of the active list where it says Exit? No //. Should set the prompt to go to the next page every 30 seconds so it continues to cycle. Resolution: ----------- Modify the prompting behavior so a timeout behaves the same as the user pressing the enter key. 5. INC18074700 - VISN 16 NOL TXT gateway continuously prompting to delete old DICOM files Problem: -------- VISN 16 NOL TXT gateway continuously prompting to delete old DICOM files Resolution: ----------- A message will be added to inform the user of the current space available and the allowable threshold. There is % disk space remaining on drive . The threshold is %. Files need to be deleted to bring disk space above %. Please check the recycle bin and large files to regain space. Test Sites: ----------- Palo Alto HCS VAMC (Livermore, CA) Southeast Louisiana Veterans Health Care System (New Orleans, LA) Software and Documentation Retrieval Instructions: -------------------------------------------------- Documentation describing the new functionality and/or a host file containing a build may be included in this release. Sites may retrieve the software and/or documentation directly using Secure File Transfer Protocol (SFTP) from the ANONYMOUS.SOFTWARE directory on download.vista.domain.ext Documentation can also be found on the VA Software Documentation Library at: https://www.domain.ext/vdl/application.asp?appid=105 File Title File Name --------------------------------------------------------------------- Kernel Installation and MAG3_0P274.KID Distribution System (KIDS) build for MAG*3.0*274 LDGW installation file MAG3_0P274_DICOM_SETUP.EXE Documentation Title File Name ------------------- ---------- Patch Description for MAG*3.0*274 MAG3_0P274_PATCH_DESCRIPTION.PDF Deployment, Installation, Back-Out, MAG3_0P274_DIBORG.PDF and Rollback Guide VistA Imaging DICOM Gateway MAG3_0P274_README.PDF ReadMe File Patch Installation: ------------------- Pre/Post Installation Overview: ------------------------------- MAG*3.0*274 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. After the KID build is installed, install the LDGW Gateway using file MAG3_0P274_DICOM_SETUP.EXE. Note: Refer to the MAG3_0P274_README.PDF file for post installation steps. 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_0P274.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*274). 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*274 11/19/20@10:14:39 => VistA Imaging 3.0 - Patch 274 ;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 274 ;Created on Nov 09, 2020@20:45:05 It consisted of the following Install(s): MAG*3.0*274 Checking Install for Package MAG*3.0*274 Install Questions for MAG*3.0*274 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*274 : 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^MAGIP274. Post Install Mail Message: Nov 19, 2020@10:14:53 Updating Routine file...... Updating KIDS files....... MAG*3.0*274 Installed. Nov 19, 2020@10:14:53 Client Installation Instructions -------------------------------- N/A Post-Installation Instructions: ------------------------------- N/A Back-Out/Roll Back Plan: ------------------------ Uninstalling the Application: ----------------------------- If it is necessary to uninstall the MAG*3.0*274, then the user would follow the following steps: 1. Stop Caché 2014 by selecting the blue Caché cube and select Stop Caché. 2. Copy the file Cache.key in the C:\CacheSys\mgr directory to a temporary location. 3. Go to the Control Panel, choose Uninstall a program, and remove the current version Caché instance. 4. Go to the Control Panel, choose Uninstall a program, and remove the VistA DICOM Gateway (Patch 274). 5. Delete the directory C:\CacheSys. 6. Restart the server. 7. Install Legacy DICOM Gateway patch MAG*3.0*257 refer to the VistA Imaging DICOM Gateway Installation Guide for instructions. 8. Copy the Cache.key file backed up earlier to C:\CacheSys\mgr. KIDS Uninstall: -------------- If it is necessary to uninstall the MAG*3.0*274 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*274 install on And/Or Backup of MAG*3.0*274 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: VistA KIDS Checksums 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 25 CHECK1^XTSUMBLD is used to generate the checksums. Routine Checksums: ------------------ Routine Checksum Before Checksum After Patch List ------- --------------- -------------- ----------- MAGIP274 N/A 4110429 **274** Routine MAGIP274 is an installation routine that is automatically deleted after the KIDS installation. Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : Date Entered : JUL 15, 2020 Completed By: Date Completed: MAR 21, 2022 Released By : Date Released : MAR 21, 2022 ============================================================================= Packman Mail Message: ===================== No routines included