============================================================================= Run Date: APR 12, 2022 Designation: MAG*3*292 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #218 Status: Released Compliance Date: MAY 16, 2022 ============================================================================= Subject: VISTA IMAGING TELEREADER MAINTENANCE Category: - Routine Description: ============ Description: This document describes MAG*3.0*292, an adaptive maintenance patch that provides fixes to VistA Imaging TeleReader. This patch addresses the following issues: Defect: -------- 1. INC18558312 - Cheyenne TeleReader VistA error SERVICE+24^MAGDHOW1 ^MAG(2005.85,213,2) 2. INC18487250 - 32-bit integer issue in TeleReader client (MAG*3.0*281) Adaptive Maintenance: --------------------- 1. TeleReader - Adobe Acrobat Reader DC v20.012.20048 upgrade Associated Patches: ------------------- This patch must be installed after MAG*3.0*208 and MAG*3.0*281. 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. INC18558312 - Cheyenne TeleReader VistA error SERVICE+24^MAGDHOW1 ^MAG(2005.85,213,2) Problem: -------- HPS VI Sustainment Contractors - referring VistA Imaging ticket INC18558312 to Tier 3 regarding an issue that will need to be addressed with a VistA patch, to permanently fix the error: SERVICE+24^MAGDHOW1 ^MAG(2005.85,213,2). The root issue was a missing ABBREVIATION value in the #2005.85 'IMAGE INDEX FOR PROCEDURE/EVENT' entry: #2005.85 IMAGE INDEX FOR PROCEDURE/EVENT NUMBER: 213 NAME: DERMATOLOGIC PROCEDURE CLASS: CLIN STATUS: ACTIVE SPECIALTY: DERMATOLOGY ABBREVIATION Note: Presently there are two active entries in #2005.85 missing an abbreviation value, 12 in total: ABBREVIATION NUMBER NAME STATUS 63 INACTIVE 63 INACTIVE 95 INACTIVE 95 INACTIVE 96 INACTIVE 96 INACTIVE 97 INACTIVE 97 INACTIVE 112 INACTIVE 112 INACTIVE 113 INACTIVE 113 INACTIVE 115 INACTIVE 115 INACTIVE 167 HIV COUNSELING 197 INPATIENT STAY 198 MENTAL HEALTH LEGAL STATUS 212 GENETIC COUNSELING ACTIVE 213 DERMATOLOGIC PROCEDURE ACTIVE To temporarily fix the issue at the site the missing abbreviation value was added for the Image Index entry below. A patch will be needed to update the entries in #2005.85 missing an abbreviation. FIX: S ^MAG(2005.85,213,2)="DERM",^MAG(2005.85,"C","DERM",213)="" #2005.85 IMAGE INDEX FOR PROCEDURE/EVENT AFTER NUMBER: 213 NAME: DERMATOLOGIC PROCEDURE CLASS: CLIN STATUS: ACTIVE SPECIALTY: DERMATOLOGY ABBREVIATION: DERM Additional notes: Based on the error trap entry, the error was able to be reproduced: >S SERVICE=1943,GMRCIEN=1584814,DIVISION=442,ITYPNAME="DERMATOLOGY - DERMATOLOGIC PROCEDURE",ITYPCODE="DERM",CPTIEN="",HL7SUBLIST=2 >W $$SERVICE^MAGDHOW1(SERVICE,GMRCIEN,DIVISION,ITYPNAME,ITYPCODE,CPTIEN,HL7SU BLIST) . . . S ITYPCODE=ITYPCODE_"/"_$P(MAG(2005.85,Z,2),"",1) SERVICE+24^MAGDHOW1 ^MAG(2005.85,213,2) After the fix: >S SERVICE=1943,GMRCIEN=1584814,DIVISION=442,ITYPNAME="DERMATOLOGY - DERMATOLOGIC PROCEDURE",ITYPCODE="DERM",CPTIEN="",HL7SUBLIST=2 >W $$SERVICE^MAGDHOW1(SERVICE,GMRCIEN,DIVISION,ITYPNAME,ITYPCODE,CPTIEN,HL7SU BLIST) 1 Resolution: ----------- Modified code to prevent undefined errors from occurring when abbreviation procedure codes are not defined. 2. INC18487250 - 32-bit integer issue in TeleReader client (MAG*3.0*281) Problem: -------- Ticket entered for sustainment to include 64-bit integer update in Patch MAG*3.0*292 Resolution: ----------- Increased 32-bit integer variable to 64-bit integer variable so that it was able to hold the necessary value. Adaptive Maintenance Tracking System Ticket(s) & Overview: ---------------------------------------------------------- 1. TeleReader - Adobe Acrobat Reader DC v20.012.20048 upgrade Description: ------------ Adaptive Maintenance - TeleReader - Adobe Acrobat Reader DC v20.012.20048 upgrade Resolution: ----------- Ensured version 20 was able to work with the TeleReader, after successful testing. Test Sites: ----------- Boise VA Medical Center (Boise, ID) VA Puget Sound Health Care System (Seattle, WA) 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: /srv/vista/patches/SOFTWARE/MAG3_0P292.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 MAG3_0P292_TELEREADER_CONFIGURATOR_INSTALL.MSI client installation VistA Imaging client MAG3_0P292_TELEREADER_CONFIGURATOR_INSTALL.EXE TeleReader installation KIDS build MAG3_0P292.KID VistA Imaging client MAG3_0P292_TELEREADER_SETUP.EXE TeleReader installation VistA Imaging client MAG3_0P292_TELEREADER_INSTALL.MSI TeleReader installation Documentation Title File Name --------------------------------------------------------------------- Patch Description for MAG*3.0*292 MAG3_0P292_PATCH_DESCRIPTION_PDF Deployment, Installation, Back-Out, MAG3_0P292_DIBORG.PDF and Rollback Guide Patch Installation: ------------------- Pre/Post Installation Overview: ------------------------------- MAG*3.0*292 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*292. 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 https://download.vista.domain.ext/index.html/SOFTWARE/MAG3_0P292.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*292). 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*292 11/19/20@10:14:39 => VistA Imaging 3.0 - Patch 292 ;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 292 ;Created on Nov 09, 2020@20:45:05 It consisted of the following Install(s): MAG*3.0*292 Checking Install for Package MAG*3.0*292 Install Questions for MAG*3.0*292 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*292 : 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^MAGIP292. Post Install Mail Message: Nov 19, 2020@10:14:53 Updating Routine file...... Updating KIDS files....... MAG*3.0*292 Installed. Nov 19, 2020@10:14:53 Client Installation Instructions -------------------------------- For installing or updating TeleReader, 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, refer to the VistA Imaging System Installation Guide KIDS Uninstall: -------------- If it is necessary to uninstall the MAG*3.0*292 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*292 install on And/Or Backup of MAG*3.0*292 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 1;Feb 15, 2017 CHECK1^XTSUMBLD is used to generate the checksums. Routine Checksums ----------------- Routine Checksum Before Checksum After Patch List ------- --------------- -------------- ---------- MAGIP292 New 4088749 **292** MAGDHOW1 30512294 31323743 **138,174,180, 210,208,292** MAGGTU4T 4918084 4922300 **93,94,106,117,122,127 182,219,242,281,292** Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : JR Date Entered : DEC 15, 2020 Completed By: Date Completed: APR 12, 2022 Released By : Date Released : APR 12, 2022 ============================================================================= Packman Mail Message: ===================== No routines included