$TXT Created by L. at MNTVBB.DOMAIN.EXT (KIDS) on Thursday, 03/03/22 at 15:24 ============================================================================= Run Date: MAY 18, 2022 Designation: PSD*3*92 Package : PSD - CONTROLLED SUBSTANCES Priority: Mandatory Version : 3 SEQ #76 Status: Released Compliance Date: JUN 17, 2022 ============================================================================= Associated patches: (v)PSD*3*84 <<= must be installed BEFORE `PSD*3*92' Subject: BALANCE DISCREPANCY CHECK DECIMAL INPUT & HELP MESSAGE UPDATES Category: - Routine Description: ============ This patch will resolve the following issue: The following issue occurs only when utilizing the balance discrepancy check for Controlled Substances (CS). While using the menu option Outpatient Rx's (PSD OUTPATIENT) and a user enters a remaining balance that contains a decimal, the entry is not recognized as a valid attempt. Associated NSR(s): ================== N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- 1) INC18508469 - CS balance discrepancy issue when entering decimal numbers Problem 1: --------- This problem happens only for a Narcotic Area Of Use (NAOU) which has activated parameter BALANCE DISCREPANCY CHECK. While using the menu option Outpatient Rx's (PSD OUTPATIENT) and a user enters a quantity that contains a decimal at the remaining balance prompt, the entry is not recognized as a valid attempt even if it is the correct remaining balance. The "you will have 3 tries" message shown below will display each time a decimal number is entered. If the decimal value is the correct remaining balance, the user cannot proceed beyond the prompt with repeated attempts of entering the decimal value. Example: Enter the remaining balance (^ to quit): 22.5 Enter The remaining Balance on hand The system will compare against the database. You will have 3 tries to complete before a message is sent to the CS BALANCE DISCREPANCY mail group Resolution 1: ------------- The CS balance discrepancy check is designed to allow three valid attempts at entering the correct remaining balance on hand. These modifications were made: - A valid attempt was modified to be defined as a quantity that is a whole number or a quantity that has no more than 2 decimal numbers and is within the range of zero to 999999.99. As before this patch, any invalid entry will not be counted as a valid attempt. - The user will now see an upfront notice that they have 3 valid attempts to enter the correct remaining balance before a message is sent to the CS BALANCE DISCREPANCY mail group. This functionality already existed but the notice was not displayed upfront before. - Help text information was updated to describe the format of a valid attempt and about the notification to the CS BALANCE DISCREPANCY mail group. Example of new messaging: (New notice) ***NOTICE: You have 3 valid attempts to enter the correct remaining balance before a message is sent to the CS BALANCE DISCREPANCY mail group. Enter the remaining balance (^ to quit): (0-999999.99): A This response must be a number. (New help message) Enter the remaining balance (^ to quit): (0-999999.99): ?? Enter the remaining balance on hand. The system will compare against the database. You will have a total of 3 valid attempts before a message is sent to the CS BALANCE DISCREPANCY mail group. Input must be a numeric amount with no more than two decimal digits. Invalid attempts will not count against your total attempts. Technical Resolution 1: ----------------------- The API ENTER+PSDNBAL was modified to add a numeric range and the maximum number of decimal places to the DIR(0) assignment. This modification will allow the DIR routine to determine whether the remaining balance entry is valid or not. This, in turn, will allow DIR to control the invalid entry messaging. The DIR(0) assignment. before the patch was: S DIR(0)="N" after the patch: S DIR(0)="N:^0:999999.99:2" Patient Safety Issues (PSIs): ----------------------------- N/A Test Sites: ----------- Heartland West - Kansas City VAMC (Kansas City, MO) Cincinnati VA Medical Center (Cincinnati, OH) Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released in a PackMan message. Documentation can be found on the VA Software Document Library (VDL) at: http://www.domain.ext/vdl/ PSD*3.0*92 Documentation can also be obtained at: https://download.vista.domain.ext/index.html/SOFTWARE Description: File Names: ============ =========== CONTROLLED SUBSTANCES (CS) PSD_3_P92_PHARM_UM.PDF PHARMACIST'S USER MANUAL PSD_3_P92_PHARM_UM.DOCX 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 2 minutes to install. For this install there are no options that are required to be disabled. 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 PSD*3.0*92. 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 PSD*3.0*92. 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 and take the default response of "NO". v. When prompted with, "Send mail to: Last name, First Name", press to take default recipient. Add any additional recipients. vi. When prompted with "Select basket to send to: IN//", press 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. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer NO. ii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', answer NO. Post-Installation Instructions: ------------------------------- None Installation Verification: -------------------------- Successful installation can be verified by reviewing the first 2 lines of the routine contained in the patch. The second line will contain the patch number (92) in the [PATCH LIST] section. The Calculate and Show Checksum Values [XTSUMBLD-CHECK] option can be run to compare the routine checksums to what is documented in the patch description. 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 from the Kernel Installation and Distribution System Menu and selecting the Installation Menu. The back-out plan is to restore the routine from the backup created. The message containing the backed-up routine 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. Select the Install Package(s) option and choose the patch (PSD*3.0*92b) to install. 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 2 lines of the PSD Routine contained in this patch using the First Line Routine Print [XU FIRST LINE PRINT] option. Once the routine contained in the PSD*3.0*92 patch has been backed out, the first two lines of the routine will no longer contain the designation of patch PSD*3.0*92 in the patch list section on line 2. Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0;CONTROLLED SUBSTANCES NARCOTIC BALANCE;**[Patch List]**;13 Feb 97;Build 3 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSDNBAL Before: B16701063 After: B20487390 **84,92** Routine list of preceding patches: 84 ============================================================================= User Information: Entered By : Date Entered : JUL 30, 2021 Completed By: Date Completed: MAY 17, 2022 Released By : Date Released : MAY 18, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT