$TXT Created by V at CHY0143D.FO-BAYPINES.DOMAIN.EXT (KIDS) on Friday, 08/08/25 at 10:34 ============================================================================= Run Date: SEP 16, 2025 Designation: PSB*3*152 Package : PSB - BAR CODE MED ADMIN Priority: Mandatory Version : 3 SEQ #133 Status: Released Compliance Date: OCT 17, 2025 ============================================================================= Associated patches: (v)PSB*3*140 <<= must be installed BEFORE `PSB*3*152' Subject: BCMA UPGRADE TO DELPHI 12, INCIDENT FIXES Category: - Other - Routine Description: ============ This patch will resolve the following issues in the Bar Code Medication Administration (BCMA) application. VISTAPSB-3101 - The Department of Veterans Affairs (VA) Office of Information and Technology (OIT) requires that applications remain compliant with the Technical Reference Model (TRM) regarding the version of tools used for development. This patch accomplished this by updating the version of Delphi to 12. INC36515426 - BCMA unable to scan med look up only allows numbers. INC39133639 - BCMA allows editing the medication log while in Read-Only Mode INC38632463 - BCMA Security Assertion Markup Language (SAML) issue. EHRM Impact Statement: ---------------------- - This patch should have no EHRM impact, and can be installed at all sites, including EHRM converted sites. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- N/A Forms Associated: Form Name File Number New/Modified/Deleted --------- ----------- -------------------- N/A Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- N/A Options Associated: Option Name Type New/Modified/Deleted ----------- ---- -------------------- N/A Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- N/A Security Keys Associated: Security Key Name ----------------- N/A Templates Associated: Template Name Type File Name (Number) New/Modified/Deleted ------------- ---- ------------------ -------------------- N/A Remote Procedures Associated: Remote Procedure Name New/Modified/Deleted --------------------- -------------------- N/A Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- N/A Additional Information: ----------------------- N/A New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: 1. VISTAPSB-3101 - Updating the BCMA application to Delphi 12 Problem: -------- The VA OIT requires that applications remain compliant with the TRM regarding the version of tools used for development. Resolution: ----------- This patch accomplished that by updating the version of Delphi to 12. 2. INC36515426 - BCMA unable to scan med look up only allows numbers. Problem: -------- User in BCMA is unable to manually administer a medication if it contains alpha characters. The user gets a message to the screen saying only numeric entries are allowed. Resolution: ----------- The BCMA application was checking medication labels and rejecting any that were not numbers only. This check has been removed. 3. INC39133639 - BCMA Read-Only Allows Editing of Medication Log Problem: -------- If BCMA is opened in Read-Only mode, the user can still select and edit the medication log. Resolution: ----------- When the BCMA application was running in READ ONLY mode, users were still able to access the menu option "Edit Med Log", which would allow them to edit a patient's medication log. The code has been updated so that the menu option is no longer available while the application is in READ ONLY mode. **NOTE** If the application is in Limited Access mode, the menu option is available. 4. INC38632463 - BCMA SAML issue (signature failure) Problem: -------- BCMA SAML issue (signature failure) Resolution: ----------- By updating BCMA to Delphi 12 and using the latest Broker Development Kit (BDK) the signature will no longer fail. Test Sites: ----------- James E. Van Zandt VAMC (Altoona, PA) William S. Middleton Memorial VAMC (Madison, WI) Test Sites - SNOW Change Order #: Altoona: CHG0637069 Madison: CHG0635987 Software and Documentation Retrieval Instructions: -------------------------------------------------- This software is being released with both a PackMan message and an updated Graphical User Interface (GUI). Files and documentation pertaining to this patch are available. Other Software Files: This release also includes other software files. They can be obtained at location: /srv/vista/patches/SOFTWARE Other software files can also be obtained by accessing the URL: https://download.vista.domain.ext/index.html/SOFTWARE File Title File Name Format --------------------------------------------------------------------- BCMA MS Installer PSB_3_0P152.MSI Binary BCMA Installation Executable PSB_3_0P152.EXE Binary Documentation describing the new functionality is included in this release. Documentation can be found on the VA Software Documentation Library at: https://www.domain.ext/vdl/. Documentation can also be obtained at https://download.vista.domain.ext/index.html/SOFTWARE. Documentation Title File Name ------------------------------------------------------------------- BCMA Installation Guide PSB_3_P152_IG.PDF PSB_3_P152_IG.DOCX Patch Installation: ------------------- Pre/Post Installation Overview: Please reference the BCMA Installation Guide as this server install needs to be coordinated with the GUI installation. Pre-Installation Instructions: BCMA users should be off the system when this patch is installed. This patch should be installed during non-peak hours. Installation will take less than 5 minutes. 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 the patch name. (ex. PSB*3.0*152) NOTE: Using 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 PSB*3.0*152 iii. When prompted for the following, enter "R" for Routines or "B" for Build. Select one of the following: B Build (including Routines) R Routines Only Backup Type: B// 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. 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. Client Installation Instructions: --------------------------------- 1. Prior client compatible with patch: NO 2. Client can be copied instead of installed: YES If BCMA is currently running, please exit BCMA. This client installation patch file will NOT upgrade an existing/previous version of BCMA, so if there is a previous version installed, please remove it using the Control Panel option to uninstall software, then follow these steps: 1. Right Click and Run as Administrator on PSB3_0P152.EXE, which will launch the InstallShield Wizard. If you prefer, you can run the CMD application as administrator and run PSB3_0P152.MSI instead to launch the InstallShield Wizard. 2. When the InstallShield Wizard Welcome screen is displayed, click "Next". 3. On the Choose Destination Location screen, simply click "Next" to select the default destination folder that is prefilled. If you would like to change the destination folder to one other than the default, click "Browse" to navigate to the folder of your choice. Click "Next". 4. On the "Setup Type" screen select Complete. The following choices are shown: a. Typical - installs only the BCMA client program, which is necessary for medication administration. b. Complete - installs the BCMA client, the GUI BCMA site parameters definition program and the OrderCom.dll. c. Custom - allows you to select which programs to install. Typical is selected by default. Click "Next". 5. The InstallShield Wizard Ready to Install the Program screen will display. Click "Install" to proceed with the installation Post-Installation Instructions: N/A Back-out/Roll Back Plan: ------------------------ Back-out of this patch will be performed only with the concurrence and participation of the appropriate VA site/region personnel. The decision to back out the patch will be a joint decision between 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 routine 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 routine 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 (PSB*3.0*152) to install. The GUI for the previous version, PSB*3.0*140, can be restored by first removing the installed version of PSB*3.0*152 and then retrieving the InstallShield setup executable for patch PSB*3*140 from the software download site: Index of /index.html/SOFTWARE (domain.ext) and running the wizard. 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 confirming the checksums have been returned to the pre-patch value using CHECK1^XTSUMBLD. It can also be verified by printing the first 2 lines of the PSB routine(s) contained in this patch using the option First Line Routine Print [XU FIRST LINE PRINT]. Once the routine(s) contained in this patch have been backed out, the Second line of each routine will no longer contain the designation of Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0;BAR CODE MED ADMIN;**[Patch List]**;Mar 2004;Build 4 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSBRPC3 Before: B293306 After: B293395 **6,3,4,16,13,10,32,28,42,58, 68,70,83,97,96,118,101,123,106, 140,152** Routine list of preceding patches: 140 ============================================================================= User Information: Entered By : Date Entered : OCT 31, 2024 Completed By: Date Completed: SEP 10, 2025 Released By : Date Released : SEP 16, 2025 ============================================================================= Packman Mail Message: ===================== $END TXT