Install: MAG*3.0*173

Patch Subject:  TELEPATHOLOGY MAINTENANCE
Description:

============
 Associated Patches:  This patch must be installed after MAG*3.0*162.
 Subject:  TELEPATHOLOGY UPDATE
 Category:  OTHER
 Description:
 ===========
 MAG*3.0*173 has emergency fixes for the VistA Imaging processing
 Laboratory (LAB) images of Telepathology.  It will fix email
 notifications being generated because of an error and some undefined
 error issues when the LAB images are processed in the Text Gateway.
 Patch Components:
 ================
 This patch includes software and documentation files.  This document,
 MAG3_0P 173_Patch_Description.pdf, provides an overview, explains the
 changes, and outlines the installation for this patch.
 MAG3_0P173_README.txt, if present, is an informative file associated with
 the patch.
 Software:
 File Name       Description
 MAG3_0P173.KID  Kernel Installation and Distribution System (KIDS) build
                 for Patch
 Documentation:
 =============
 This document, MAG3_0173_Patch_Description.pdf, provides an overview,
 explains the changes, and outlines the installation for this patch.
 Files & Fields Associated:
 =========================
 There are no files or fields associated with this patch.
 Forms Associated:
 ================
 There are no forms associated with this patch.
 Mail Groups Associated:
 ======================
 There are no mail groups associated with this patch.
 Options Associated:
 ==================
 There are no options associated with this patch.
 Protocols Associated:
 ====================
 There are no protocols associated with this patch.
 Security Keys Associated:
 ========================
 There are no security keys associated with this patch.
 Templates Associated:
 ====================
 There are no templates associated with this patch.
 Additional Information:
 ======================
 New Service Requests (NSRs):
 ===========================
 There are no new service requests addressed in this patch.
 Patient Safety Issues (PSIs):
 ============================
 There are no patient safety issues associated with this patch.
 Defect Tracking System Ticket(s) & Overview:
 1. Defect 194669 (Tickets I9738934FY16, I10130099FY16, and
 ==========================================================
 I10236113FY16) Anatomic Pathology Generating HL7 Email Alerts
 =============================================================
 Problem:  Multiple sites have reported receiving an email notification of
 an HL7 Anatomic pathology issue.  The notification is:
 An error occurred in EDIT^MAGT7MA when trying to create and/or send an
 HL7 message.  The error message is as follows:
 "-53`No test found in LAB(60) file for LRSS="SP""
 Please notify your local IRM Staff.
 Several issues were identified:
 1. The variables LRI and LRDFN are sometimes not being passed in the HL7
 message from the Laboratory system to Telepathology.
 2. The Internal Entry Number (IEN) numbers for LAB codes CY (Cytology),
 EM (Electron Microscopy) and SP (Surgical Pathology) were hardcoded, but
 it was found that they can be different at each site.
 Resolution:  The following modifications were made:
 1. If the LRI or Data File Number (DFN) are null in the HL7 message, the
 study is ignored.
 2. Instead of hardcoding the IEN associated with a lab code, the routine
 was modified to look up the IEN of the procedure by searching the
 LABORATORY TEST file #60 by the lab procedure.
 2. Defect 194632 (Tickets R9978605FY16 and I10155657FY16)  Text Gateway
 =======================================================================
 Error "PATIENT NOT IN DATABASE"
 ==============================
 Problem:  Sites are reporting that the Text Gateway was generating the
 error "PATIENT NOT IN DATABASE" in the PID segment of HL7 messages which
 delayed or halted Text Gateway processing.  This error occurred because
 the LAB referral patient was not registered in the VistA Patient database.
 Some patients are defined within the laboratory package itself, but not
 in the VistA Patient file.  For example, patients that are referrals are
 in the REFERRAL PATIENT files (#67) but may not be in the VISTA PATIENT
 file (#2).
 Resolution:  The new VistA MAGT7MA routine resolves this issue by
 checking the PARENT FILE field (#.02) of the LAB DATA file (#63).  If the
 PARENT FILE field is not "PATIENT", the order is skipped.
 Test Sites:
 ==========
 The following sites are test sites for this patch:
         Milwaukee
         Minneapolis
         Iron Mountain
         Phoenix
 Software and Documentation Retrieval Instructions:
 =================================================
 Software being released and/or documentation describing the new
 functionality introduced by this patch are available.
 The preferred method is to retrieve files from
 [email protected] from the COMMAND prompt (example:
 sftp [email protected]). This transmits the files from
 the first available server.
 Sites may also elect to retrieve files directly from a specific server.
 Sites may retrieve the software and/or documentation directly using
 Secure File Transfer Protocol (SFTP) from the ANONYMOUS.SOFTWARE directory
 at the following OI Field Offices:
 When using Attachmate Reflection (Secure Shell):
 Albany:         domain.ext
 Hines:          domain.ext
 Salt Lake City: domain.ext
 When using the COMMAND prompt (example: sftp
 [email protected]):
 Albany:         [email protected]
 Hines:          [email protected]
 Salt Lake City: [email protected]
 Documentation can also be found on the VA Software Documentation Library
 at:
 http://www4.domain.ext/vdl/.
 Patch Installation:
 ==================
 Pre/Post Installation Overview:
 ==============================
 MAG*3.0*173 must be installed on the VistA System.  This patch must be
 installed by the compliance date to conform to VHA Directive 2001-023.
 All sites running VistA Imaging 3.0 must install the KIDS portion of this
 patch.  This patch can be loaded while the VistA Imaging System is active
 and users are on the system.  Installing the MAG*3.0*173 KIDS only takes
 2-3 minutes.

Use default answers for KIDS load/install questions.

Patch-Files: http://code.osehra.org/VistA.git/tree/master/Packages/Imaging/Patches/MAG_3.0_173