$TXT Created by CRUMLEY,JAMIE at CMLCACHE.ISC-BIRM.VA.GOV (KIDS) on Friday, 06/08/07 at 12:19 ============================================================================= Run Date: AUG 09, 2007 Designation: PSJ*5*159 Package : PSJ - INPATIENT MEDICATIONS Priority: Mandatory Version : 5 SEQ #171 Status: Released Compliance Date: SEP 09, 2007 ============================================================================= Associated patches: (v)PSS*1*88 <<= must be installed BEFORE `PSJ*5*159' (v)PSJ*5*170 <<= must be installed BEFORE `PSJ*5*159' (v)PSJ*5*186 <<= must be installed BEFORE `PSJ*5*159' Subject: UPDATE TO BCMA APIS FOR MED ROUTE Category: - Routine - Enhancement (Mandatory) Description: ============ 1. A site reported a problem with the medication route being blank on the Bar Code Medication Administration (BCMA) V. 3.0 Virtual Due List. During investigation of possible corrections for this, it was determined that another issue needed to be addressed with how to determine when to prompt for an injection site. This patch assists to correct these problems by adding two new items to the Application Programming Interface (API) from Inpatient Medications V. 5.0 to BCMA. The NAME field (.01) as well as the PROMPT FOR INJ. SITE IN BCMA field (#8) from the MEDICATION ROUTES file (#51.2) will now be sent in the API. HD0000000166204, HD0000000164890, PSI-06-152, PSI-06-158. 2. In support of the BCMA V. 3.0 project BCMA HSC-III, two changes are required to the APIs that supply information to BCMA. First, the flag information for both Unit Dose and IV orders has been added to both the summary and detail APIs. Second, an indicator has been added that will tell BCMA that this order would have triggered a notification to the STAT/NOW mail group. 3. During testing of the BCMA V. 3.0 project BCMA HSC-III, a problem was discovered with the API that determines if an order should trigger a notification to the STAT/NOW mail group. If the parameter which controls the trigger was not defined, all orders would be flagged. This patch corrects this problem. However, it is important to note that if the parameter PRIORITIES FOR ACTIVE NOTIFY is not defined, no order will be flagged as stat for the purposes of BCMA. 4. During testing, a site reported a concern about how an order gets placed on the IVP/IVPB tab in BCMA. This patch assists in addressing this concern by adding the field DSPLY ON IVP/IVPB TAB IN BCMA? field (#9) to the MEDICATION ROUTES file (#51.2) to the APIs that supply information to BCMA. Associated Remedy Tickets: ========================== HD0000000164890 HD0000000166204 Associated E3Rs: ================ N/A Test Sites: =========== Iron Mountain, MI North Chicago, IL Oklahoma City, OK Upstate New York HCS Documentation Retrieval: ======================== The release manual that reflects this changes is being distributed with PSS*1*88. Sites may retrieve documentation in one of the following ways: 1. The preferred method is to FTP the files from download.vista.med.va.gov, which will transmit the files from the first available FTP server. 2. Sites may also elect to retrieve documentation directly from a specific server as follows: Albany ftp.fo-albany.med.va.gov Hines ftp.fo-hines.med.va.gov Salt Lake City ftp.fo-slc.med.va.gov 3. Documentation can also be retrieved from VISTA Documentation Library (VDL) on the Internet at the following address, http://www.va.gov/vdl. The documentation distribution includes: FILE NAMES DESCRIPTION =========== =========== PSS_1_P88_RN.PDF Medication Route Changes Release Notes Installation Instructions: ========================== This patch can be installed with users on the system. Installation will take less than 1 minute. Suggested time to install: non-peak requirement hours. 1. Use the INSTALL/CHECK MESSAGE option on the PackMan menu. 2. From the Kernel Installation & Distribution System menu, select the Installation menu. 3. From this menu, you may select to use the following options (when prompted for INSTALL NAME, enter PSJ*5.0*159): (a) Backup a Transport Global - this option will create a backup message of any routines exported with the patch. It will NOT backup any other changes such as DDs or templates. (b) Compare Transport Global to Current System - this option will allow you to view all changes that will be made when the patch is installed. (c) Verify Checksums in Transport Global - this option will allow you to ensure the integrity of the routines that are in the transport global. (d) Print Transport Global - this option will allow you to view the components of the KIDS build. 4. Use the Install Package(s) option and select the package PSJ*5.0*159. 5. When prompted "Want KIDS to INHIBIT LOGONs during the install? YES//" respond NO. 6. When prompted "Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//" respond NO. Example Installation: ===================== Select INSTALL NAME: PSJ*5.0*159 Loaded from Distribution 5/27/05@14:53:49 => PSJ*5*159 This Distribution was loaded on Aug 31, 2006@09:49:41 with header of PSJ*5*159 It consisted of the following Install(s): PSJ*5.0*159 Checking Install for Package PSJ*5.0*159 Install Questions for PSJ*5.0*159 Want KIDS to INHIBIT LOGONs during the install? YES// NO Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES// NO Enter the Device you want to print the Install messages. You can queue the install by enter a 'Q' at the device prompt. Enter a '^' to abort the install. DEVICE: HOME// COMPUTER ROOM PSJ*5.0*159 ------------------------------------------------------------------------ Install Started for PSJ*5.0*159 : Aug 31, 2006@09:52:10 Build Distribution Date: Aug 31, 2006 Installing Routines: Aug 31, 2006@09:52:13 Updating Routine file... Updating KIDS files... PSJ*5.0*159 Installed. Aug 31, 2006@09:52:13 Install Message sent #37655 ------------------------------------------------------------------------ +------------------------------------------------------------+ 100% | 25 50 75 | Complete +------------------------------------------------------------+ Install Completed Routine Summary: ================ The second line now reads as follows: ;;5.0; INPATIENT MEDICATIONS ;**[patch list]**;16 DEC 97 CHECK^XTSUMBLD results: Routine Before Patch After Patch Patch List ------------------------------------------------------------------------- PSJBCMA 19601618 20294958 32,41,46,57,63,66,56,69,58,81,91, 104,111,112,186,159 PSJBCMA1 20012580 22655435 32,41,46,57,63,66,56,58,81,91, 104,186,159 PSJHL4A 17989471 17989497 105,111,154,170,159 Routine Information: ==================== The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSJBCMA Before: B63223587 After: B70029264 **32,41,46,57,63,66,56,69,58, 81,91,104,111,112,186,159** Routine Name: PSJBCMA1 Before: B59316594 After: B70574949 **32,41,46,57,63,66,56,58,81, 91,104,186,159** Routine Name: PSJHL4A Before: B37280433 After: B37280684 **105,111,154,170,159** Routine list of preceding patches: 170, 186 ============================================================================= User Information: Entered By : WILLIAMS,BRIAN Date Entered : SEP 18, 2005 Completed By: FARMER,LINDA Date Completed: AUG 07, 2007 Released By : LESIEUR,SHIRLEY Date Released : AUG 09, 2007 ============================================================================= Packman Mail Message: ===================== $END TXT