$TXT Created by CLN2G1.AAC.DOMAIN.EXT (KIDS) on Monday, 06/12/23 at 08:27 ============================================================================= Run Date: DEC 28, 2023 Designation: PSB*3*140 Package : PSB - BAR CODE MED ADMIN Priority: Mandatory Version : 3 SEQ #123 Status: Released Compliance Date: JAN 28, 2024 ============================================================================= Associated patches: (v)PSB*3*106 <<= must be installed BEFORE `PSB*3*140' Subject: DELPHI 11 UPGRADE, INCLUDE ORDERCOM.DLL Category: - Routine - Other Description: ============ This patch will resolve the following issues in the Bar Code Medication Administration (BCMA) application. The Department of Veterans Affairs Office of Information and Technology 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 11.1. INC24640179 - Installing PSB*3.0*106 on workstation does not install ordercom.dll INC29571341 - BCMA not prompting for PIV card. 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 New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- Problem 1: ---------- The Department of Veterans Affairs Office of Information and Technology requires that applications remain compliant with the Technical Reference Model (TRM) regarding the version of tools used for development. Resolution 1: ------------- This patch accomplished this by updating the version of Delphi to 11.1. Problem 2: ---------- INC24640179 - Installing PSB*3.0*106 on workstation does not install ordercom.dll Resolution 2: ------------- The BCMA MS Installer (PSB3_0P140.MSI) and BCMA Installation Executable (PSB3_0P140.EXE) have been updated to include the ORDERCOM.dll file as part of the files installed with this patch. Problem 3: ---------- INC29571341 - BCMA not prompting for PIV card. Resolution 3: ------------- When signing onto BCMA, some users were not being prompted for their PIV card PIN number. This was due to a default certificate issue. The BCMA Client and BCMA Parameters applications have been updated to accept a parameter "showcerts" in the desktop shortcut for the application. When this parameter is present, the application with display a prompt allowing users to select the correct certificate and then they will be prompted for their PIV card PIN. Example Target field of a shortcut using the new parameter: "C:\Program Files (x86)\vista\BCMA\BCMA.exe" s=vaausappvmtXXX.aac.domain.ext p=XXXX showcerts Test Sites: ----------- Durham VAMC (Durham, NC) Central California HCS (Fresno, CA) SNOW Change Order #: -------------------- Durham: CHG0420931 Fresno: CHG0420623 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 PSB3_0P140.MSI Binary BCMA Installation Executable PSB3_0P140.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_p140_ig.PDF 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*140) 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*140 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 can be used to upgrade an existing version of BCMA, or can be used for a brand new installation. 1. Right Click and Run as Administrator on PSB3_0P140.EXE, which will launch the InstallShield Wizard. If you prefer, you can run the CMD application as administrator and run PSB3_0P140.MSI instead to lauch the InstallShield Wizard. 2. When the InstallShield Wizard Welcome screen is displayed, click "Next". 3. On the Choose Destination Location screen, simply click "Next" If you would like to change the destination folder to one other than 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*140b) to install. The GUI for the previous version, PSB*3.0*106, can be restored by retrieving the InstallShield setup executable for patch PSB*3*106 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 patch PSB*3.0*140. 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: PSBRPC3 Before: B293370 After: B293306 **6,3,4,16,13,10,32,28,42,58, 68,70,83,97,96,118,101,123,106, 140** Routine list of preceding patches: 106 ============================================================================= User Information: Entered By : Date Entered : SEP 22, 2022 Completed By: Date Completed: DEC 26, 2023 Released By : Date Released : DEC 28, 2023 ============================================================================= Packman Mail Message: ===================== $END TXT