============================================================================= Run Date: JAN 05, 2011 Designation: MAG*3*105 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #71 Status: Released Compliance Date: FEB 05, 2011 ============================================================================= Subject: VISTA IMAGING ADVANCED WEB IMAGE VIEWER FOR VISTAWEB Category: - Enhancement (Mandatory) - Routine Description: ============ Patch 105 Overview: =================== This document describes Patch 105, the VistA Imaging Advanced Web Image Viewer (AWIV) for VistAWeb patch. It is part of the Joint Incentive Funds (JIF) 3 Wounded Warrior Initiative. This patch is the first step towards supporting the congressionally mandated exchange of non-radiology images between the VA and the DoD. When implemented, the VistA Imaging (AWIV) will let VistAWeb users locate and display VA images associated with progress notes and radiology reports. NOTE: The VistA Imaging AWIV is designed for use with VistAWeb only. The AWIV is not a stand-alone application. NOTE: The AWIV is not intended for the primary interpretation of radiology exams. When the AWIV is installed on approved and properly maintained hardware, primary interpretation of other image types is permissible by licensed practitioners at their discretion. NOTE: The AWIV will not be available until VistAWeb version 13 is released. Distribution of Software: ========================= This patch can be downloaded from: ================================== ftp.imaging.med.va.gov/Software/Released_Software/Mag3_0P105 Installation instructions are included. Patch Contents: =============== This patch includes the following files: ======================================== Software: ========= MAG3_0P105.KID - KIDS package to be installed on the VistA System. MagAWIVInstall.exe - The AWIV installation file. MagAWIVInstall.msi - The AWIV installation file for automated push installs. Documentation: ============== MAG3_0P105_Patch_Desc.pdf - Patch Description MAG_AWIV_user_guide.pdf - The AWIV User guide. MAG3_0P105_Technical_Manual_Changes.pdf - Change Pages for the Technical Manual. MAG3_0P105_Security_Guide_Changes.pdf - Change Pages for the Security Guide. MAG3_0P105_Install_Guide_Changes.pdf - Change Pages for the Install Guide. Any late-breaking news about this patch will be documented in a readme file. Associated Patches: =================== All Kernel Installation and Distribution System (KIDS) files for previously released Imaging (MAG) patches must be installed before installing the patch 105 KIDS. The Imaging AWIV is designed to run on workstations using VistAWeb version 13 (WEBV*1*20) or later. Older versions of VistAWeb do not support the AWIV. Test Sites: =========== The following sites are test sites for this patch: Baltimore Maryland Health Care System , MD (Integrated) Charleston, SC (Large) Columbus, OH (Medium) El Paso, TX (Medium) Loma Linda, CA (Large) Washington, DC (Large) Wilmington, DE (Medium) Remedy Calls: ============= There are no Remedy help desk calls associated with this patch. NSRs: ===== There are no New Service Requests (NSRs) associated with this patch. Patch 105 Changes: ================== Patch 105 contains the new VistA Imaging AWIV and a KIDS file used to register the AWIV in the REMOTE APPLICATION File (#8994.5). This patch affects no other Imaging components. AWIV Overview: ============== The VistA Imaging AWIV adds image display capabilities to VistAWeb in much the same way that the Clinical Display application adds image display capabilities to CPRS. With the AWIV, a user can display images associated with progress notes or radiology reports within the VistAWeb application. To display remote images in VistAWeb, refer to the patch description document MAG3_0p105_Patch_desc.pdf. AWIV Implementation: ==================== The VistA Imaging AWIV is an ActiveX control that can only be launched from VistAWeb in a VA-approved version of Microsoft Internet Explorer. VistAWeb performs all user authentication and patient sensitivity checking. When VistAWeb launches the AWIV, VistAWeb includes identifiers for the images to be displayed in the parameters it passes to the AWIV. The AWIV in turn uses those parameters to locate remotely stored images via the Centralized VistA Imaging Exchange (CVIX) service. The CVIX, on receiving image requests from the AWIV, pulls the images in question from the applicable remote VA site and passes them back to the AWIV. The CVIX caches images that it handles to speed any subsequent requests for the same images. AWIV Image Access Logging: ========================== Image access using the AWIV is logged in the CVIX transaction log and in the IMAGE ACCESS LOG File (#2006.95) of the site where images originate from. VistA System Changes: ===================== The KIDS file for patch 105 will add a new entry for the AWIV into the REMOTE APPLICATION File (#8994.5). There are no other changes made to VistA for this patch. Data Dictionaries: ================== There are no new or modified data dictionaries in this patch. Security Keys: ============== There are no new or modified security keys in this patch. Remote Procedures: ================== There are no new or modified remote procedures in this patch. Menu Options: ============= There are no new or modified menu options in this patch. Installation: ============= The Patch 105 KIDS must be installed on the VistA System. The KIDS can be installed while VistA Imaging is active. KIDS installation will take less than one minute. The AWIV component is intended for use on workstations that have access to VistAWeb. Note that while VistAWeb itself is installed on a central application server, the AWIV is an Active X control that needs to be installed on the local workstation either manually or using an automated software distribution system. AWIV installation will take less than one minute per workstation. NOTE: The AWIV should not be installed on thin client workstations. Installation Prerequisites: =========================== Before installing this patch, you will need to download the Patch 105 files from the Imaging FTP site to a local storage location. Verify that the patches listed in the Associated Patches section have been installed. Workstations where the AWIV is installed must meet the following minimum requirements: * Access to VistAWeb version 13 (WEBV*1*20) or later * A VA-approved version of Microsoft Internet Explorer * Display capability of 24-bit color with a screen resolution of 1024x768 pixels * 1 gigabyte of RAM VistA System (KIDS) Installation: ================================= Installing the KIDS Package: ============================ 1. Access the Kernel Installation and Distribution System Menu [XPD MAIN]. 2. Run the Installation option [XPD INSTALLATION MENU]. 3. Load the KIDS file by performing the following steps. a. Run the Load a Distribution option [XPD LOAD DISTRIBUTION] to load the KIDS distribution. b. When prompted, enter the path and file name (MAG3_0P105.KID) of the Patch 105 KIDS file that you downloaded from the Imaging FTP server. c. When prompted to continue with the load, enter YES. A Distribution OK! message will be displayed when the load is complete. 4. After loading the KIDS file, use the following options to verify the contents of the patch and to back up any affected routines. Verify Checksums in Transport Global [XPD PRINT CHECKSUM] run this option if you want to verify the integrity of the routines in the patch. Compare Transport Global to Current System [XPD COMPARE TO SYSTEM] run this option if you want to view all changes that will be made when the patch is installed. All components (routines, options, and so on) in the patch will be compared. Backup a Transport Global [XPD BACKUP] run this option if you want to create a backup message of any routines exported with the patch. It will NOT back up any of the other changes. 5. After performing the load and any optional verification steps, perform the following steps to install the KIDS file: a. Run the Install Package(s) [XPD INSTALL BUILD] option. b. When prompted for the install name, enter MAG*3.0*105. c. Answer NO to the following prompts: Want KIDS to INHIBIT LOGONs during the install? No//NO Want to DISABLE Scheduled Options, Menu Options, and Protocols? No//NO 6. When installation is finished, an Install Complete message will be displayed. KIDS Installation Example: ========================== Select INSTALL NAME: MAG*3.0*105 Loaded from Distribution 10/26/10@11:32:07 => VistA Imaging V3.0 - Patch 105 - 10/25/2010 16:28PM ;Created This Distribution was loaded on Oct 26, 2010@11:32:07 with header of VistA Imaging V3.0 - Patch 105 - 10/25/2010 16:28PM ;Created on Oct 25, 2010@16:28:48 It consisted of the following Install(s): MAG*3.0*105 Checking Install for Package MAG*3.0*105 Install Questions for MAG*3.0*105 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// TELNET Install Started for MAG*3.0*105 : Oct 26, 2010@11:32:11 Build Distribution Date: Oct 25, 2010 Installing Routines: Oct 26, 2010@11:32:11 Running Post-Install Routine: POS^MAGIP105 I will check if the AWIV entry is in the REMOTE APPLICATION file. Updating Routine file... Updating KIDS files... MAG*3.0*105 Installed. Oct 26, 2010@11:32:11 Install Message sent #32435 Install Completed AWIV Installation: ================== When the AWIV is installed, be aware that: * The software will be installed in C:\Program Files\Vista\Imaging\Lib on the local workstation. * There are no configurable installation options. Automated Installation: ======================= The AWIV installation file can be pushed to individual workstations using applications such as PSexec or Microsoft Systems Management Server (SMS). Specifics will vary depending on the automated installation tool used. Manual Installation: ==================== Use the following steps to install the VistA Imaging AWIV software. 1. On the workstation where the AWIV will be installed, log into an administrator-level account. 2. Double-click MagAWIVInstall.exe to start the installation wizard. There will be a brief delay as the installation files are extracted. 3. When the Welcome page appears, click Next. 4. When the Ready to Install page displays, click Install. 5. After installation is complete, click Finish to exit the wizard. Verifying Installation: ======================= To verify that the AWIV has been installed, use VistAWeb to select a progress note or radiology report with associated images. Clicking the image icon in VistAWeb should trigger the launch of the AWIV. Routines: ========= For each routine, the second line will contain the following information. ;;3.0;IMAGING;**105**;Mar 19, 2002;Build 1865;Oct 25, 2010 MAGIP105 is a post install routine and is deleted after the KIDS install. Routine Information: ==================== The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: MAGIP105 Before: n/a After: B6974659 **105** ============================================================================= User Information: Entered By : VARDANIAN,VIOLETTA Date Entered : MAR 19, 2009 Completed By: CASUGAY,ELSIE G Date Completed: JAN 03, 2011 Released By : MASSEY,DAVID Date Released : JAN 05, 2011 ============================================================================= Packman Mail Message: ===================== No routines included