============================================================================= Run Date: OCT 20, 2021 Designation: MAG*3*301 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #210 Status: Released Compliance Date: NOV 22, 2021 ============================================================================= Associated patches: (v)MAG*3*119 <<= must be installed BEFORE `MAG*3*301' (v)MAG*3*185 <<= must be installed BEFORE `MAG*3*301' (v)MAG*3*208 <<= must be installed BEFORE `MAG*3*301' (v)MAG*3*239 <<= must be installed BEFORE `MAG*3*301' Subject: VISTA UPDATES TO ALLOW IHS TO UPGRADE TO LATEST VISTA IMAGING VERSION Category: - Routine - Data Dictionary Description: ============ MAG*3.0*301 was developed to allow Indian Health Service (IHS) sites to install and configure a fully patched VistA Imaging system. The following updates were needed in VistA MAG namespaced routines: MAGVIM08 - updated - IHS uses the ORES key instead of the AUTHORIZED TO WRITE MED ORDERS flag MAGSPID - Added PROD entry point to check if Test or Production for IHS sites MAGDHOW2 - Added 2 lines after OUTPUT+2 to set 3 variables before calling MOVESEG^HLOAPI - This was needed because IHS uses an older version of HLOAPI that doesn't use $G - this affects Consults Worklist MAGDQR20 & MAGNVQ01 - Updated to append the SOP Class UID to the RPC result set to support IHS Image Viewer MAGDQR02 - Removed any leading and trailing asterisks when looking up patients by IHS health record number. This code is called when a Query/Retrieve SCU searches for a patient by patient ID and is limited to IHS sites. Input Transform/Screen updates: Addresses issues with Importer III/DICOM Correct and the ability to use Test accounts: MAG WORK ITEM file (#2006.941) LOCATION Field (#4) Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- --------------------- MAG WORK ITEM (#2006.941) LOCATION (#4) Modified The LOCATION field Screen was modified Pre-Install SHOULD 'INSTITUTION' ENTRIES BE SCREENED? Yes// (Yes) MUMPS CODE THAT WILL SET 'DIC("S")': S DIC("S")="I $$SCRN4^XUOAAUTL(Y)" Post-Install SHOULD 'INSTITUTION' ENTRIES BE SCREENED? Yes// (Yes) MUMPS CODE THAT WILL SET 'DIC("S")': S DIC("S")="I $$SCRN4^XUOAAUTL(Y)!$$PROD^MAGSPID()" 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: N/A Test Sites: ----------- Bay Pines, FL White River Junction, VT IHS sites: ---------- Alpha Sites: Chinle California Area Office Chickasaw Phoenix Indian Medical Center Beta Sites: Chinle Phoenix Indian Medical Center 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_0P301.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_0P301.KID Distribution System (KIDS) build for MAG*3.0*301 Documentation Title File Name ------------------------------------------------------------------------- MAG*3.0*301 Patch Description MAG3_0P301_PATCH_DESCRIPTION.PDF Deployment, Installation, Back-Out, MAG3_0P301_DIBORG.PDF and Rollback Guide Patch Installation: ------------------- Pre/Post Installation Overview: ------------------------------- MAG*3.0*301 must be installed on the VistA System. 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 use. 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*301. 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_0P301.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*301). 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: ------------------------ If a roll back is necessary, use the 'ROUTINE' LOAD PackMan option to restore the original routine from the Mailman backup copy that was created from the 'Backup A Transport Global' option was run during the initial patch install. 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*301 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*301 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: Sample Installation: Select Installation Option: INstall Package(s) Select INSTALL NAME: MAG*3.0*301 7/22/21@15:13:21 => VistA Imaging V3.0 Patch 301 - VistA updates to allow IHS to upgrade t This Distribution was loaded on Jul 22, 2021@15:13:21 with header of VistA Imaging V3.0 Patch 301 - VistA updates to allow IHS to upgrade to latest VistA Imaging version - 07/22/2021 12:25PM ;Created on Jul 22, 2021@12:25:15 It consisted of the following Install(s): MAG*3.0*301 Checking Install for Package MAG*3.0*301 Install Questions for MAG*3.0*301 Incoming Files: 2006.941 MAG WORK ITEM (Partial Definition) Note: You already have the 'MAG WORK ITEM' File. 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 Complete MAG*3.0*301 Install Started for MAG*3.0*301 : Jul 22, 2021@15:17:11 Build Distribution Date: Jul 22, 2021 Installing Routines: Jul 22, 2021@15:17:11 Running Pre-Install Routine: PRE^MAGIP301 Installing Data Dictionaries: Jul 22, 2021@15:17:11 Running Post-Install Routine: POS^MAGIP301 Post Install Mail Message: Jul 22, 2021@15:17:11 Updating Routine file... Updating KIDS files... MAG*3.0*301 Installed. Jul 22, 2021@15:17:11 Install Completed 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 Before Checksum After Checksum Patch List MAGDHOW2 54180158 88185944 **138,156,183,208,301** MAGDQR02 64531448 64690388 **51,54,66,118,239,301** MAGDQR20 81382507 83237743 **119,301** MAGIP301 N/A 4110353 **301** MAGNVQ01 109845219 111364623 **185,301** MAGSPID 3966944 11523584 **122,123,301** MAGVIM08 23870020 24688133 **118,185,301** Routine MAGIP301 is an installation routine that is automatically deleted after the KIDS installation. Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : Date Entered : JAN 25, 2021 Completed By: Date Completed: OCT 20, 2021 Released By : Date Released : OCT 20, 2021 ============================================================================= Packman Mail Message: ===================== No routines included