============================================================================= Run Date: SEP 21, 2020 Designation: MAG*3*250 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #193 Status: Released Compliance Date: OCT 22, 2020 ============================================================================= Subject: VI - VistA Fix for Clinical Display and Importer Defect Category: - Routine Description: ============ This document describes MAG*3.0*250, a patch that provides fixes to the VistA patch for VistA Imaging that addresses an issue that affects both Importer and Imaging Clinical Display. This patch addresses the following issues: 1. Clinical Display does not process ROI for the Billings VA Community Based Outpatient Clinic and Health Care Center. 2. An error occurred during direct import: Object reference not set to an instance of an object. 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. Defect 1119706 (Trouble Ticket #INC7331595) Requesting troubleshooting assistance for ROI routing process Problem: -------- Clinical Display doesn't process ROI for the Billings VA Community Based Outpatient Clinic and Health Care Center. Clinical Display allows them to select DICOM images, select the ROI device, and submit the request, but the images were not showing as in process or making it to the legacy gateway. The VIX log showed the following error when creating an entry in MAG WORK ITEM file (#2006.41). [2019-09-06T12:42:45,602] INFO [http-nio-8080-exec-8] (VistaSession.java:859) - RPC [MAGV CREATE WORK ITEM] response: [-4`Invalid data:436GH Field: #2006.941,4] Resolution: ----------- NOTE: See item 2 for Resolution. 2. Defect 1210058 (Trouble Ticket #INC9228300) An error occurred during direct import: Object reference not set to an instance of an object. Problem: -------- When users attempt to import images using the Importer application they receive the following error: Direct Import failed: Object reference not set to an instance of an object. Per the Clinical 3 Team owner who escalated this ticket to the Sustainment team, the error in this ticket is the same as the error that was reported in the INC7331595 ticket, that is being addressed in P250, and is currently in development. The error occurs when creating an entry in MAG WORK ITEM file (#2006.41). The MAG WORK ITEMS file (#2006.941) failed during validation of the LOCATION field (4). It improperly screens out some locations that are valid so the work entry cannot be located. This causes a problem both for the ROI and importer/HDIG processing. Resolution: ----------- NOTE: Installation of MAG*3.0*250 resolves INC7331595 and INC9228300. The location screen was limiting selectable locations to VAMCs and several other facilities. This was addressed by removing the location screen for the Location field (#4) in the MAG Work Item file (#2006.941) and modifying the routine that creates MAG Work Item entries to handle both IENs and Station Numbers. Test Sites: ----------- Montana VA Health Care System (Fort Harrison, MT) Gulf Coast Veterans Health Care System (Biloxi, MS) 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_0P250.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_0P250.KID Distribution System (KIDS) build for MAG*3.0*250 - New Documentation Title File Name --------------------------------------------------------------------- Patch Description for MAG*3.0*250 MAG3_0P250_Patch_Description.pdf Deployment, Installation, Back-Out, MAG3_0P250_DIBORG.pdf and Rollback Guide Patch Installation: ------------------- Pre/Post Installation Overview: -------------------------------- MAG*3.0*250 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. Note: All released VistA Imaging patches must be installed on the VistA system before installing MAG*3.0*250. 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_0P250.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*250). 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 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. When prompted 'Want KIDS to INHIBIT LOGONs during the install?,' answer NO. VistA Client Installation Instructions ---------------------------------------- N/A - Application client installation is not required in a KIDS-only build. Post-Installation Instructions: -------------------------------- N/A - Application client installation is not required in a KIDS-only build. Back-Out/Roll Back Plan: ------------------------ Uninstalling the Application: ------------------------------ N/A - Application client installation is not required in a KIDS-only build. KIDS Uninstall: ---------------- If it is necessary to uninstall the MAG*3.0*250 VistA KIDS, select the Kernel Installation & Distribution System menu option, Backup a Transport Global, see the Installation Steps section where step 4c 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*250 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 1;Feb 15, 2017 CHECK1^XTSUMBLD is used to generate the checksums. Routine Checksums Routine Checksum Checksum Patch List Before After MAGVIM01 195265246 205136809 **118,138,221,250** MAGIP250 New 4110377 **250** Routine MAGIP250 is an installation routine that is automatically deleted after the KIDS installation. Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0;IMAGING;**[Patch List]**;Mar 19, 2002;Build 9 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: MAGIP250 Before: n/a After: B4110377 **250** Routine Name: MAGVIM01 Before:B195265246 After:B205136809 **118,138,221,250** Routine list of preceding patches: 221 ============================================================================= User Information: Entered By : Date Entered : NOV 18, 2019 Completed By: Date Completed: SEP 18, 2020 Released By : Date Released : SEP 21, 2020 ============================================================================= Packman Mail Message: ===================== No routines included