$TXT Created by                MNTVBB.DOMAIN.EXT  (KIDS) on Tuesday, 04/27/21 at 12:39
=============================================================================
Run Date: AUG 12, 2021                     Designation: PSJ*5*417
Package : PSJ - INPATIENT MEDICATIONS         Priority: Mandatory
Version : 5       SEQ #361                      Status: Released
                  Compliance Date: SEP 12, 2021
=============================================================================

Associated patches: (v)PSJ*5*237   <<= must be installed BEFORE `PSJ*5*417'
                    (v)PSJ*5*302   <<= must be installed BEFORE `PSJ*5*417'

Subject: DOSE LIMIT SHORTS CLINIC MEDS DOSES

Category: 
  - Routine

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

 This patch addresses the following issue:
  
 VISTA Outpatient Pharmacy error with clinic orders and stop dates
  
  
 Associated ticket(s):
 =====================
  
 1. INC17067067 VISTA Inpatient Pharmacy error with clinic orders and stop 
    dates
  
  
 Associated NSR(s):
 ==================
 N/A
  
 Participating Test Sites:
 =========================
 VA Pittsburgh HCS, Pittsburgh PA
 VA Gulf Coast VHCS, Biloxi MS
  
  
 Patient Safety Issues (PSIs):
 =============================
 HITPS-7828
  
  
 Defect Tracking System Ticket(s) & Overview:
 ===========================================
  
 1. INC17067067 VISTA Inpatient Pharmacy error with clinic orders and 
    stop dates
  
    Problem:
    -------
    The issue is seen with "outpatients" and unit dose clinic medications. 
    The function to specify number of doses in the stop date field is   
    calculating incorrectly; it is one dose short. 
  
    When entering a dose limit for an outpatient unit dose clinic 
    medication (for an outpatient who has never been admitted),
    the stop date calculated is at the date/time of the last
    dose to be administered.  As a result, in BCMA that last dose cannot be
    administered at the time the order is defined to stop. To fix this, 
    the stop date/time should be calculated to be after the last dose to be
    administered.
    
    Resolution:
    ----------
    Modify routines PSGDL & PSJORP2 so that the date/time of the first 
    dose is used to determine the stop date/time using the dose limit 
    entered.  Prior to this patch the outpatient clinic order was using 
    the current time (for an outpatient who has never been admitted) to
    calculate the dose limit entered to get the stop date/time which would
    come up with one dose less than the dose limit entered. This patch 
    modifies the code so that the dose limit calculation for all clinic 
    medications have the same calculation logic as if inpatient medication
    orders would have when INPATIENT WARD PARAMETERS (File #59.6) field
    DEFAULT START DATE CALCULATION (field #.05) is set to 2 ("USE NOW AS
    DEFAULT").  To further clarify, the dose limit calculation for clinic
    medications will function the same regardless of the value in the
    DEFAULT START DATE CALCULATION parameter.
  
  
  
  
 Pre-Installation Instructions:
 =============================
 This patch may be loaded with users on the system. You may wish to 
 install it during non-peak hours. Installation will take less than 1 
 minute. 
  
  
 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 that 
         are in the transport global. When prompted for the 
         INSTALL NAME enter PSJ*5.0*417 
  
         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 your 
              build PSJ*5.0*417
          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/Rollback Strategy:
 ==========================
 In the event of a catastrophic failure, the Facility CIO may make the 
 decision to back-out the patch.
   
 It is imperative that you have performed a backup of the routine 
 included in this patch prior to installation.
  
 The back-out plan is to restore the routine from the backup created.

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

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

Routine Name: PSGDL
    Before: B14139634   After: B15922030  **16,50,64,58,111,170,302,417**
Routine Name: PSJORP2
    Before: B23776619   After: B24053265  **80,110,111,133,189,237,417**
 
Routine list of preceding patches: 237, 302

=============================================================================
User Information:
Entered By  :                               Date Entered  : APR 08, 2021
Completed By:                               Date Completed: AUG 12, 2021
Released By :                               Date Released : AUG 12, 2021
=============================================================================


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

$END TXT