$TXT Created by WIPERT,RANDY at PW             .GOV  (KIDS) on Wednesday, 03/15/17 at 18:54
=============================================================================
Run Date: MAR 23, 2017                     Designation: OR*3*441
Package : OR - ORDER ENTRY/RESULTS REPORTING  Priority: Mandatory
Version : 3                                     Status: Under Development
=============================================================================

Associated patches: (v)OR*3*350    <<= must be installed BEFORE `OR*3*441'
                    (v)OR*3*356    <<= must be installed BEFORE `OR*3*441'
                    (u)OR*3*431    <<= must be installed BEFORE `OR*3*441'

Subject: EPIP OR REMEDIATION 2.0

Category: 
  - Routine
  - Data Dictionary
  - Print Template
  - Other

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

 OR*3.0*441 provides the following enhancements to VistA:
  
 - Modifies the display of flagged Order comments and Ward comments to
 make them readily available on the Computerized Patient Record System 
 (CPRS) Orders tab where Clinical staff can plainly see them.
  
 Currently, the clinician must double-click the order and search through 
 activity details to find the flagged Order comment or Ward comment. Not 
 only is this search time-consuming, but it requires that the clinician 
 recognize the need to actively search. This can result in comments being 
 overlooked and not addressed in a timely manner, thus impacting patient 
 safety and care.
  
 The Flagged and Ward comments modification comes with an On/Off switch. 
 The default position is OFF. To enable the modification, use the XPAR 
 MENU TOOLS option to set the OR FLAGGED & WARD COMMENTS parameter to ON. 
 This parameter is stored in the PARAMETER DEFINITION file (#8989.51).
  
 - Enables support for tracking antimicrobial medication quick orders by 
 adding a tracking hook to enhance auditing of those orders. The 
 Antimicrobial Decision Tree Hook functionality is enabled by two new TIU 
 Objects (hooks) added to the TIU DOCUMENT DEFINITION file (#8925.1). The 
 |OR QUICK ORDER AUDIT| hook tracks clinically preferred antimicrobial drug
 quick orders; the |OR QUICK ORDER AUDIT(ALT)| hook tracks quick orders
 that prescribe an alternative to a clinically preferred antimicrobial
 drug.
  
 This enhancement does not provide any preconfigured quick orders; the 
 quick orders must be set up and added to CPRS by a Clinical Application 
 Coordinator (CAC) or an Office of Information and Technology (OI&T) 
 member. When creating an antimicrobial drug quick order, either the |OR 
 QUICK ORDER AUDIT| or the |OR QUICK ORDER AUDIT(ALT)| hook must be added 
 to the order Comments field to enable quick order audit capabilities.
  
 When an antimicrobial drug quick order containing the hook is created from
 the CPRS Orders tab, a pharmacy confirmation number is displayed with
 other order information such as the medication, dose, schedule, and 
 special instructions. When the medication is dispensed, an order number is
 assigned; this number serves as confirmation that the order was completed.
 The pharmacy confirmation number can be used to look up order details in
 VistA, including the Order number if medication was dispensed. The 
 scheduled option ORQOA QUICK ORDER NIGHTLY BG adds the order number to the
 QUICK ORDER AUDIT file (#100.95). The background job scheduling is set to
 YES and is preset to run at 23:01 and then rerun at 24-hour intervals. The
 default settings can be modified by the OI&T staff.
  
 Five VistA quick order auditing options are provided with this 
 enhancement, including the ORQOA QUICK ORDER NIGHTLY BG job. The ORQOA 
 QUICK ORDER AUDIT MENU option provides access to the remaining quick order
 auditing options: The ORQOA QUICK ORDER AUDIT Inquiry option retrieves
 order details from VistA for individual orders; the ORQOA QUICK ORDER
 AUDIT PRINT option enables printing of usage reports and the export of
 statistics to a spreadsheet application; the ORQOA QUICK ORDER AUDIT 
 MONTHLY prints a monthly report of antimicrobial medication orders for a 
 specified group of Medical Center divisions.
  
 The Quick Order Audit Monthly Report (ORQOA QUICK ORDER AUDIT MONTHLY) 
 includes antimicrobial drug orders that were placed using a quick order 
 and orders that were placed using another ordering method. To utilize this
 report, it must be configured by a CAC or an OI&T member editing the QUICK
 ORDER DIVISION GROUPS file (#100.953). Each site must create one or more
 group names in this file and place all the subordinate divisions that may
 order antimicrobial medications in the group by selecting them from the
 MEDICAL CENTER DIVISION file (#40.8).
  
 This functionality is turned ON by adding one of the two new hooks to 
 antimicrobial quick orders defined for the site. The functionality is 
 turned OFF by removing the hook from the Comments section of any quick 
 orders previously configured with either hook. To completely turn off the 
 Antimicrobial Decision Tree Hook function, the scheduled Quick Order 
 Nightly Background Task (ORQOA QUICK ORDER NIGHTLY BG) must also be turned
 off.
  
 Note: Sites that are utilizing the Computer Decision Support System (CDSS)
 software to select quick orders associated with antimicrobial drugs can
 continue using the CDSS system without interruption following 
 implementation of this enhancement.  During the patch installation, Quick 
 Orders preconfigured with a |ZZ QUICK ORDER AUDIT| or |ZZ QUICK ORDER 
 AUDIT(ALT)| hook will be automatically converted to the new |OR QUICK 
 ORDER AUDIT| or |OR QUICK ORDER AUDIT(ALT)| hook. Refer to the 
 Post-Installation Instructions for additional information on this 
 conversion process.
  
 BLOOD BANK Clearance:
 --------------------
  
 EFFECT ON BLOOD BANK FUNCTIONAL REQUIREMENTS: Patch OR*3.0*441 contains 
 changes to a package referenced in ProPath standard titled: BBM Team 
 Review of VistA Patches. This patch does not alter or modify any VistA 
 Blood Bank software design safeguards or safety critical elements 
 functions.
  
 RISK ANALYSIS: Changes made by patch OR*3.0*441 have no effect on Blood 
 Bank software functionality, therefore RISK is none.
  
 Patch Components: 
 -----------------
  
 Files & Fields Associated:
  
 File Name (Number)      Field Name (Number)     New/Modified/Deleted
 ------------------      -------------------     --------------------
 QUICK ORDER AUDIT       #100.95                 NEW
 QUICK ORDER DIVISION    #100.953                NEW
 GROUPS
 TIU DOCUMENT DEFINITION #8925.1                 MERGE/ ADDED TWO OBJECTS
 PARAMETER DEFINITION    #8989.51                MERGE/ ADDED A PARAMETER
  
  
 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
 ------------------------------  ----            --------------------
 ORQA QUICK ORDER AUDIT MONTHLY  RUN ROUTINE     NEW
 ORQOA QUICK ORDER AUDIT         INQUIRE         NEW 
 ORQOA QUICK ORDER AUDIT MENU    MENU            NEW
 ORQOA QUICK ORDER AUDIT PRINT   PRINT           NEW
 ORQOA QUICK ORDER NIGHTLY BG    RUN ROUTINE     NEW
  
  
 Protocols Associated:
  
 Protocol Name   New/Modified/Deleted
 -------------   -------------------- 
 N/A 
  
 Parameters Associated:
  
 Parameter Name              New/Modified/Deleted
 --------------               -------------------- 
 OR FLAGGED & WARD COMMENTS  New
  
  
 Security Keys Associated:
  
 Security Key Name
 -----------------
 N/A
  
  
 Templates Associated:
  
 Template Name      Type    File Name (Number)  New/Modified/Deleted 
 ---------------    ----    -----------------   --------------------
 ORQOA AUDIT PRINT  PRINT   (QUICK ORDER AUDIT  NEW
 REPORT                     (#100.95))
  
  
 Additional Information:
 N/A 
  
  
 New Service Requests (NSRs):
 ----------------------------  
 NSR20150103 Display Flagged and Ward Comments
 NSR20160613 Anti-Microbial Decision Tree Interface Hook
  
  
 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 OI 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 
 http://URL            /.
  
  
 Title                                File Name       FTP Mode
 -----------------------------------------------------------------------
 CPRS User Guide: GUI Version         cprsguium.doc   Binary
 CPRS User Guide: GUI Version         cprsguium.pdf   Binary
 CPRS Technical Manual: GUI Version   cprsguitm.doc   Binary
 CPRS Technical Manual  GUI Version   cprsguitm.pdf   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 OR*3,0*441.
  
 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//', 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:
 ------------------------------
  
 The Post-Installation routine ORQO441P will schedule the QUICK ORDER 
 NIGHTLY BG option to run every 24 hours at 23:01 on the next calendar day.
 If this is not an optimal time to run the option, then a member of the 
 OI&T staff must manually reschedule this option. This routine also creates
 two new objects in the TIU DOCUMENT DEFINITION (file #8925.1) - OR QUICK
 ORDER AUDIT and OR QUICK ORDER AUDIT(ALT).
  
 Sites with Quick orders that contain the |ZZ QUICK ORDER AUDIT| or |ZZ
 QUICK ORDER AUDIT(ALT)| hook in the order comments field must convert 
 those orders to use |OR QUICK ORDER AUDIT| or |OR QUICK ORDER
 AUDIT(ALT)| hook. A utility in the post-installation routine 
 automatically performs this conversion. Each quick order the utility 
 converts is displayed on the screen as the routine executes.
  
 No conversion is needed at sites that do not have previously configured 
 antimicrobial quick orders using the "ZZ" prefixed hook.
  
 Routine ORQO441P is set to be automatically deleted at the end of the 
 installation.

Routine Information:
====================
The second line of each of these routines now looks like:
 ;;3.0;ORDER ENTRY/RESULTS REPORTING;**[Patch List]**;Dec 17, 1997;Build 14

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

Routine Name: ORQ12
    Before: B37558185   After: B41144852  **12,27,78,92,116,190,220,215,
                                           243,356,441**
Routine Name: ORQO441P
    Before:       n/a   After: B17377534  **441**
Routine Name: ORQOAUIA
    Before:       n/a   After:  B6753469  **441**
Routine Name: ORQOAUIB
    Before:       n/a   After: B31131811  **441**
Routine Name: ORQOAUIC
    Before:       n/a   After:  B6873283  **441**
Routine Name: ORWDXM3
    Before:B111449239   After:B112317519  **10,85,131,132,141,185,187,
                                           190,195,215,243,303,296,280,
                                           350,441**
Routine Name: ORWPT
    Before: B64148022   After: B64133438  **10,85,132,149,206,187,190,
                                           215,243,280,306,311,431,441**
 
Routine list of preceding patches: 350, 356, 431

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


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

$END TXT
