$TXT Created by RODRIGUEZ,CESAR at PW             .GOV  (KIDS) on Wednesday, 12/14/16 at 08:36
=============================================================================
Run Date: MAR 03, 2017                     Designation: LR*5.2*476
Package : LR - LAB SERVICE                    Priority: Mandatory
Version : 5.2                                   Status: Under Development
=============================================================================

Associated patches: (v)LR*5.2*153  <<= must be installed BEFORE `LR*5.2*476'
                    (v)LR*5.2*161  <<= must be installed BEFORE `LR*5.2*476'

Subject: EPIP LR REMEDIATION 1.0

Category: 
  - Routine
  - Enhancement (Mandatory)

Description:
============

 LR*5.2*476 provides the following enhancements to VistA:
  
 - Enables tracking of users who reprint Laboratory accession labels. When 
 a user reprints an accession label for a specimen, this enhancement adds 
 the user's internal number to the label for quality control purposes. 
 This internal number is the Designated User (DUZ) from the NEW PERSON 
 file (#200). The lab routines LRLABXOL and LRLABXT have been modified to 
 support this enhancement.
  
 Printing of the user's DUZ on the label applies only to existing 
 accessions; that is, those reprinted after the original accession was 
 created.  
  
 - Enables reporting on historical lab results through FileMan. This Lab 
 Result Report Function (LRRF) enhancement consists of a FileMan report 
 used by Pharmacy Automated Data Processing Application Coordinators 
 (ADPACs) and lab informaticists. The report shows lab results for a 
 specified patient, lab test, and specimen type, looking back over a 
 specified number of days. This enhancement applies only to lab tests with 
 verified results.
  
 Users must be familiar with FileMan file structure and commands to run 
 the report. Input parameters are: a) the Internal Entry Number (IEN) of 
 the patient; b) the IEN of the lab test in the LABORATORY TEST file 
 (#60); c) the specimen type IEN from the TOPOGRAPHY FIELD file (#61); and 
 d) the look-back number of days. The new FileMan function LRRESULT and 
 the new lab routine LRFRSLT are exported to support this enhancement.
  
 - Enables batch entry of preliminary comments for designated accession 
 numbers. When a Microbiology Technician enters preliminary comments for 
 accessions with negative cultures, this enhancement enables the 
 technician to enter the same comment for multiple accession numbers. For 
 example, a site might process hundreds of urine cultures daily. 
 Currently, the technician must enter a "No growth after 24 hours" 
 preliminary result individually for each applicable accession. With this 
 modification, technicians can enter the same preliminary result for all 
 applicable accessions at once, reducing the time and effort required to 
 make preliminary results available for clinical use. 
  
 This modification adds the following sub-fields from the LAB DATA file 
 (#63), MICROBIOLOGY field (#5), sub-file #63.05, to the RB Results Entry 
 (Batch) [LRMISTUF] menu option in VistA: PRELIMINARY BACT COMMENT (#1) 
 for Bacteriology accessions; PRELIMINARY MYCOLOGY COMMENT (#20.5) for 
 Mycology accessions; and PRELIMINARY TB COMMENT (#26.5) for 
 Mycobacteriology accessions. For each sub-field selected, the technician 
 enters the preliminary comment and then enters the accession numbers to 
 be updated with that comment. 
  
 If the technician enters a preliminary comment in one of the new 
 sub-fields, routine LRMISTF updates the corresponding BACTERIOLOGY, TB 
 BACTERIOLOGY, or MYCOLOGY data record in the EXECUTE CODE file (#62.07), 
 EXECUTE CODE field (#1). See the Post Installation section for 
 instructions on how to update the EXECUTE CODE field (#1) in file #62.07.
  
  
 Blood Bank Review:
 ==================
 EFFECT ON BLOOD BANK FUNCTIONAL REQUIREMENTS: Patch LR*5.2*476 does not 
 contain any changes to the VISTA BLOOD BANK Software as defined by 
 ProPath standard titled: BBM Team Review of VistA Patches.
  
 EFFECT ON BLOOD BANK FUNCTIONAL REQUIREMENTS: Patch LR*5.2*476 does not 
 alter or modify any software design safeguards or safety critical 
 elements functions.
  
 RISK ANALYSIS: Changes made by patch LR*5.2*476 have no effect on Blood 
 Bank software functionality, therefore RISK is none.
  
 VALIDATION REQUIREMENTS BY OPTION: Because of the nature of the changes 
 made, no specific validation requirements exist as a result of 
 installation of this patch.
  
  
 Patch Components: 
  
 Files & Fields Associated:
  
 File Name (Number)      Field Name (Number)     New/Modified/Deleted
 ------------------      -------------------     --------------------
 N/A
  
  
 Forms Associated:
  
 Form Name               File #                  New/Modified/Deleted
 ---------               ------                  --------------------
 N/A
  
  
 Mail Groups Associated:
  
 Mail Group Name                                 New/Modified/Deleted
 ---------------                                 --------------------
 N/A
  
  
 Options Associated:
  
 Option Name                  Type               New/Modified/Deleted
 -----------                  ----               -------------------- 
 Reprint accession label(s)   run routine        Modified
 Reprint order accession      run routine        Modified
 label(s)         
  
  
 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
  
  
 Additional Information:
  
 Function Name              File Name (Number)   New/Modified/Deleted
 -------------              ------------------   --------------------
 LRRESULT                   FUNCTION (.5)        New
  
  
 New Service Requests (NSRs):
 ----------------------------  
 NSR20150801 Print User Name - ID Number for Quality Review
 NSR20090305 LAB RESULT REPORT FUNCTION Fileman
 NSR20161009 Batch Entry of Microbiology Preliminary Comments
  
 Patient Safety Issues (PSIs):
 -----------------------------
 N/A
  
 Defect Tracking System Ticket(s) & Overview:
 --------------------------------------------
 N/A
  
 Problem:
 -------
 N/A
  
 Resolution:
 ----------
 N/A
  
 Test Sites:
 ----------
 TBD
  
  
  
  
 Software and Documentation Retrieval Instructions:
 ---------------------------------------------------- 
 Software being released as a host file and/or documentation describing 
 the new functionality introduced by this patch are available.
  
 The preferred method is to retrieve files from download.DNS      .DNS   .
 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 Field Offices:
  
 Albany:            fo-albany.URL       
 Hines:             DNS     .URL         
 Salt Lake City:    fo-slc.URL       
  
 Documentation can also be found in the VA Software Documentation Library 
 (VDL) at: http://URL            /.
  
  
 Title                                    File Name            FTP Mode
 -----------------------------------------------------------------------
 Laboratory User Manual Version 5.2       lab5_2um.pdf         Binary
 Laboratory User Manual Version 5.2       lab5_2um.doc         Binary
 Laboratory Technical Manual Version 5.2  lab5_2tm.pdf         Binary
 Laboratory Technical Manual Version 5.2  lab5_2tm.doc         Binary
  
  
 Patch Installation:
  
 Pre/Post Installation Overview:
 -------------------------------
 Review the Pre-Installation Instructions provided before beginning 
 installation of the patch.
  
 Pre-Installation Instructions:
 ------------------------------
 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 users. This patch should take less than 5 
 minutes to install.
  
 Installation Instructions:
 --------------------------
 To install the patch:
  
 1. Choose the PackMan message containing this patch.
  
 2. Choose the INSTALL/CHECK MESSAGE PackMan option.
  
 3. From the Kernel Installation and Distribution System (KIDS) menu, 
 select the Installation Menu. From this menu, you may elect to use the 
 following options. When prompted for the INSTALL NAME, enter the patch 
 number LR*5.2*476.
  
 a. Verify Checksums in Transport Global - This option will help 
 ensure the integrity of the routines that are in the transport global.
  
 b. Print Transport Global - This option will enable viewing the 
 components of the KIDS build.
  
 c. Compare Transport Global to Current System - This option will 
 enable viewing all changes that will be made when this patch is 
 installed. It compares all components of this patch (routines, data 
 dictionaries, templates, etc.).
  
 d. Back up a Transport Global - This option will create a backup 
 message of any routines exported with this patch. It will not back up any 
 other changes such as data dictionaries or templates.
  
 4. From the Installation Menu, select the Install Package(s) option 
 and choose the patch to install.
  
 5. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of 
 Install? NO//', press <Enter>.
  
 6. When prompted 'Want KIDS to INHIBIT LOGONs during the install? 
 NO//', press <Enter>.
  
 7. When prompted 'Want to DISABLE Scheduled Options, Menu Options, 
 and Protocols? NO//', enter 'YES' and press <Enter>.
  
    a) When prompted 'Enter options you wish to mark as "Out of Order":', 
       enter the following:
  
       Reprint accession label(s)        [LRLABXT]
       Reprint order accession label(s)  [LRLABXOL]
       Results entry (batch)             [LRMISTUF]
  
    b) When prompted 'Enter protocols you wish to mark as "Out of
       Order":', press <Enter>.
  
 8. If prompted 'Delay install (Minutes): (0-60): 0//', press <Enter>.
  
 9. If prompted '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//   HOME  (CRT)', press 
 <Enter>.
  
  
 Post-Installation Instructions:
 -------------------------------
 Invoke 'ENTER OR EDIT FILE ENTRIES' in FileMan to edit the EXECUTE 
 CODE field (#1) in the EXECUTE CODE file (#62.07) for the names
 BACTERIOLOGY, MYCOLOGY, and TB BACTERIOLOGY:
  
 D P^DI
  
  
 VA FileMan 22.2
  
  
 Select OPTION: ENTER OR EDIT FILE ENTRIES  
  
  
  
 Input to what File: EXECUTE CODE//         (73 entries)
 EDIT WHICH FIELD: ALL// .01  NAME
 THEN EDIT FIELD: 1  EXECUTE CODE
 THEN EDIT FIELD: 
  
  
 Select EXECUTE CODE NAME: BACTERIOLOGY     E
 NAME: BACTERIOLOGY// 
 EXECUTE CODE: S DR="11.55////"_DUZ_";.055;.05;.99;11.6;11.5;S 
 LRSPEC=$P(LRBG0,U,
 5),Y=$S(LRSPEC=71:11.57,LRSPEC=68:11.58,1:0);11.57;S Y=0;11.58",LREND=0 D 
 ^DIE S :$D(Y) LREND=1 Q:$D(Y)  D ^LRMIBUG Q:LREND  S DR="13;11" D ^DIE Q
               Replace 11.5; With 11.5;1;  Replace 
    S DR="11.55////"_DUZ_";.055;.05;.99;11.6;11.5;1;S 
 LRSPEC=$P(LRBG0,U,5),Y=$S(L
 RSPEC=71:11.57,LRSPEC=68:11.58,1:0);11.57;S Y=0;11.58",LREND=0 D ^DIE 
 S:$D(Y) LREND=1 Q:$D(Y)  D ^LRMIBUG Q:LREND  S DR="13;11" D ^DIE Q
  
  
 Select EXECUTE CODE NAME: 
  
 Use the same procedure to add field #20.5 to MYCOLOGY and field #26.5 to 
 TB BACTERIOLOGY. At the end of your edit session, the field EXECUTE CODE 
 for the three names in file #62.07 will look as follows:
  
 NAME: BACTERIOLOGY                      TYPE: EDIT
   EXECUTE CODE: S DR="11.55////"_DUZ_";.055;.05;.99;11.6;11.5;1;S 
 LRSPEC=$P(
 LRBG0,U,5),Y=$S(LRSPEC=71:11.57,LRSPEC=68:11.58,1:0);11.57;S 
 Y=0;11.58",LREND=0 D ^DIE S:$D(Y) LREND=1 Q:$D(Y)  D ^LRMIBUG Q:LREND  S
 DR="13;11" D ^DIE Q
  
 NAME: MYCOLOGY                          TYPE: EDIT
   EXECUTE CODE: S 
 DR="19.5////"_DUZ_";.05;.99;19;19.2;20;20.5;21;18",DR(2,63
 .37)=".01:99" D ^DIE Q
  
 NAME: TB BACTERIOLOGY                   TYPE: EDIT
   EXECUTE CODE: S 
 DR="25.5////"_DUZ_";.05;.99;23;24;25;26;26.5;27;22",DR(2,6
 3.39)=".01;1:99)" D ^DIE Q

Routine Information:
====================
The second line of each of these routines now looks like:
 ;;5.2;LAB SERVICE;**[Patch List]**;Sep 27, 1994;Build 5

The checksums below are new checksums, and
 can be checked with CHECK1^XTSUMBLD.

Routine Name: LRFRSLT
    Before:       n/a   After:  B1675070  **476**
Routine Name: LRLABXOL
    Before:  B5111104   After:  B5338976  **11,121,161,476**
Routine Name: LRLABXT
    Before: B16292452   After: B16727986  **80,161,476**
Routine Name: LRMISTF
    Before: B13980655   After: B14531968  **153,476**
 
Routine list of preceding patches: 153, 161

=============================================================================
User Information:
Entered By  : WERTH,WARREN                  Date Entered  : OCT 17, 2016
Completed By:                               Date Completed: 
Released By :                               Date Released : 
=============================================================================


Packman Mail Message:
=====================

$END TXT
