$TXT Created by                    at MNTVBB.DOMAIN.EXT  (KIDS) on Thursday, 03/23/23 at 18:06
=============================================================================
Run Date: JUN 27, 2023                     Designation: PSJ*5*440
Package : PSJ - INPATIENT MEDICATIONS         Priority: Mandatory
Version : 5       SEQ #382                      Status: Released
                  Compliance Date: JUL 28, 2023
=============================================================================

Associated patches: (v)PSJ*5*58    <<= must be installed BEFORE `PSJ*5*440'

Subject: RENEWED INPATIENT ORDERS CAN INCORRECTLY BE MARKED AS NOT TO BE GIVEN

Category: 
  - Routine

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

 This patch will resolve the following issue:
  
 INC26226397 - Renewed inpatient orders can incorrectly be marked as "Not 
 to be Given"
  
 Patient Safety Issues (PSIs):
 -----------------------------
 N/A
  
 Additional Information:
 -----------------------
 Defect Tracking System Ticket(s) & Overview:
  
 INC26226397 - Renewed inpatient orders can incorrectly be marked as "Not 
 to be Given"
  
 Problem:
 --------
 Inpatient medication orders in RENEWAL status currently can be marked as
 "Not to be Given". When this happens, the pending renewal is also updated 
 with "Not to be Given" which is also incorrect. Only orders in an Expired
 or Discontinued status should be allowed to be marked with that message.
  
 Resolution:
 -----------
 The following changes were made to address the issue:
  
 The logic used to check the order status was changed to only allow orders
 in an Expired or Discontinued status to be marked as "Not to be Given".
   
 Technical Resolution:
 ---------------------
 The following changes were made to address the issue:
  
 The logic in ^PSGOENG was changed to check the status of the order to 
 ensure that it's either a Discontinued or Expired order before allowing
 the user to mark the order as "Not to be Given".
  
 Test Sites:
 -----------
 1. Jack C. Montgomery VAMC- Muskogee (OK)
 2. Rocky Mountain VAMC- Rocky Mountain (CO)
  
 SNOW Change Order Number
 ----------------------
 Rocky Mountain - CHG0375814
 Muskogee - CHG0378932 
  
 Software and Documentation Retrieval Instructions:
 --------------------------------------------------
 The software for this patch is being released in a PackMan message.
  
 Patch Installation:
 -------------------
 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.
  
 It is not necessary to disable any options.  
  
 Installation Instructions:
  
 1. Choose the PackMan message containing this build. Then select the 
    INSTALL/CHECK MESSAGE PackMan option to load the build.
 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 in the transport global. When 
       prompted for the INSTALL NAME, enter the patch or build name: 
       PSJ*5.0*440
  
       NOTE: Using <spacebar><enter> will not bring up a Multi-Package 
       build even if it was loaded immediately before this step. It will 
       only bring up the last patch in the build.
  
    b. Select the Backup a Transport Global option to create a backup 
       message. You must use this option and specify what to backup; the 
       entire Build or just Routines. The backup message can be used to 
       restore the routines and components of the build to the pre-patch
       condition.
         i. At the Installation option menu, select Backup a Transport 
            Global.
        ii. At the Select INSTALL NAME prompt, enter PATCH NAME HERE
       iii. When prompted for the following, enter "R" for Routines or "B"
            for Build.
  
            Select one of the following:
            
            B          Build
            R          Routines
  
            Enter response: Build
  
        iv. When prompted "Do you wish to secure your build? NO//", press 
            <enter> and take the default response of "NO".
         v. When prompted with, "Send mail to: Last name, First Name", 
            press <enter> to take default recipient. Add any additional
            recipients.
        vi. When prompted with "Select basket to send to: IN//", press 
            <enter> and take the default IN mailbox or select a different 
            mailbox.
  
    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 of the 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? NO//', answer NO.
       ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install? 
           NO//', answer NO.
      iii. When prompted 'Want to DISABLE Scheduled Options, Menu 
           Options, and Protocols? NO//', answer NO.
   
 Back-Out/Roll Back Plan:
 ------------------------
 Back-out will be done only with the concurrence and participation of
 development team and appropriate VA site/region personnel. The decision to
 back-out or rollback software will be a joint decision between development
 team, VA site/region personnel and other appropriate VA personnel.
  
 Prior to installing an updated KIDS package, the site/region should have
 saved a backup of the routines in a mail message using the Backup a
 Transport Global [XPD BACKUP] menu option (this is done at time of
 install). The message containing the backed-up routines can be loaded with
 the "Xtract PackMan" function at the Message Action prompt. The Packman
 function "INSTALL/CHECK MESSAGE" is then used to install the backed up
 routines onto the VistA System. If the patch was backed up for the build,
 from the Kernel Installation and Distribution System Menu, select the
 Installation Menu. Then select the Install Package(s) option and choose 
 the patch (PSJ*5.0*440b) to install.
  
 The back-out plan is to restore the routines from the backup created.
  
 No data was modified by this patch installation and, therefore no 
 rollback strategy is required.
  
 Validation of Back-out Procedure:
 ---------------------------------
 The Back-out Procedure can be verified by printing the first two lines of
 the routines contained in this patch using the First Line Routine Print
 [XU FIRST LINE PRINT] option. After the routines contained in this patch 
 have been backed out, the second line of the routines will no longer
 contain the designation of this patch in the patch list section.

Routine Information:
====================
The second line of each of these routines now looks like:
 ;;5.0;INPATIENT MEDICATIONS;**[Patch List]**;16 DEC 97;Build 1

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

Routine Name: PSGOENG
    Before:  B6599882   After:  B7436486  **58,440**
 
Routine list of preceding patches: 58

=============================================================================
User Information:
Entered By  :                               Date Entered  : MAR 21, 2023
Completed By:                               Date Completed: JUN 26, 2023
Released By :                               Date Released : JUN 27, 2023
=============================================================================


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

$END TXT