$TXT Created by                    at MNTVBB.DOMAIN.EXT  (KIDS) on Tuesday, 07/26/22 at 15:48
=============================================================================
Run Date: DEC 14, 2022                     Designation: PSB*3*139
Package : PSB - BAR CODE MED ADMIN            Priority: Mandatory
Version : 3       SEQ #121                      Status: Released
                  Compliance Date: JAN 14, 2023
=============================================================================

Associated patches: (v)PSB*3*83    <<= must be installed BEFORE `PSB*3*139'

Subject: BCMA MEDICATION OVERVIEW REPORT ERROR

Category: 
  - Routine

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

 This patch will resolve the following issue:
  
 INC23089823 - The BCMA Medication Overview report may generate an RPC 
 Broker error when the Future and DC'ed/Expired statuses are omitted from 
 the report.
  
 Patient Safety Issues (PSIs):
 -----------------------------
 N/A
  
 Additional Information:
 -----------------------
 Defect Tracking System Ticket(s) & Overview:
  
 INC23089823 - The BCMA Medication Overview report may generate an RPC 
 Broker error when the Future and DC'ed/Expired statuses are omitted from 
 the report.
  
 Problem:
 --------
 The Bar Code Medication Administration (BCMA) Medication Overview report 
 throws an error when a medication's next administration time and stop 
 time are the same and the Future and DC'ed/Expired statuses are unchecked 
 when generating the report.
  
 Resolution:
 -----------
 The following changes were made to address the issue:
  
 Modified the report to handle the scenario where a medication's next 
 administration time and stop time are the same time.
   
 Technical Resolution:
 ---------------------
 The following changes were made to address the issue:
  
 Inserted a line in EN^PSBOCM to ensure that the variable used to track 
 the next administration is not set to null prior to generating the report.
  
 Test Sites:
 -----------
 Fresno VAMC, Fresno CA
 W.G. (Bill) Hefner VAMC (Salisbury), Salisbury NC
  
  
 Software and Documentation Retrieval Instructions:
 --------------------------------------------------
 The software for this patch is being released in a PackMan message.
  
 Documentation describing the new functionality is not included in this 
 release.
  
  
 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: 
       PSB*3.0*139
  
       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 PSB*3.0*139.
       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 (PSB*3.0*139b) 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:
 ;;3.0;BAR CODE MED ADMIN;**[Patch List]**;Mar 2004;Build 1

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

Routine Name: PSBOCM
    Before:B128362247   After:B131462213  **32,50,68,70,83,139**

=============================================================================
User Information:
Entered By  :                               Date Entered  : JUN 28, 2022
Completed By:                               Date Completed: DEC 14, 2022
Released By :                               Date Released : DEC 14, 2022
=============================================================================


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

$END TXT