============================================================================= Run Date: FEB 26, 2018 Designation: PSS*1*178 Package : PSS - PHARMACY DATA MANAGEMENT Priority: Mandatory Version : 1 SEQ #186 Status: Released Compliance Date: MAR 29, 2018 ============================================================================= Associated patches: (v)PSS*1*180 <<= must be installed BEFORE `PSS*1*178' (v)PSS*1*184 <<= must be installed BEFORE `PSS*1*178' (v)PSS*1*201 <<= must be installed BEFORE `PSS*1*178' Subject: MOCHA 2.1B ENHANCEMENTS Category: - Routine - Enhancement (Mandatory) Description: ============ The Medication Order Check HealthCare Application (MOCHA) 2.1B patches implement Max Daily Dose Order Checks for simple medication orders entered through Computerized Patient Record System (CPRS), Inpatient Medications and Outpatient Pharmacy. If the Daily Dose exceeds the First Databank (FDB) recommended Max Daily Dose, a warning shall be displayed to the user. If the Max Daily Dose Order Check cannot be performed, an error message will be displayed to the user, along with general dosing information for the drug in most cases. This patch is part of the MOCHA Enhancements 2.1B group of builds and must be the first of the group installed. Multiple package host files were created where possible to simplify installation at Veterans Health Administration (VHA) facilities. The combined build host file MOCHA_2_1_PSO_OR_PSJ.KID contains OR*3.0*382, PSJ*5.0*256 and PSO*7.0*402. The combined follow up host file MOCHA_2_1_FOLLOW_UP_PSO_OR_PSJ.KID contains PSO*7.0*500, OR*3.0*469 and PSJ*5.0*347. In addition, there is another standalone Pharmacy Data Management patch, PSS*1.0*206, which must be installed in conjunction with the other builds. * * * Notice * * * This group of patches should not be installed until the follow on patch PSO*7.0*515 has been released and is ready to be immediately installed. PSO*7.0*515 must be installed immediately after the successful installation of this group of builds. See the PSO*7.0*515 patch description for details. * * * Notice * * * MOCHA v2.1B will provide the following enhancements: =================================================== Implement Dose Range Checking with a Max Daily Dose limit for simple medication orders entered through Outpatient Pharmacy, Inpatient Medications and CPRS applications. Display a generic error message when the Max Daily Dose Order Check cannot be performed in CPRS. Display an error message when the Max Daily Dose Order Check cannot be performed in CPRS with a detailed reason when height and/or weight is required, but does not exist in the Vitals application for the patient. Display an error message when the Max Daily Dose Order Check cannot be performed in Pharmacy with a detailed reason. Correct identified daily dose errors due to frequency failure. Resolve miscellaneous frequency issues with incorporation of new dosing check frequency fields. Apply Daily Dose Check exclusion for schedule to medication orders entered through Outpatient Pharmacy, Inpatient Medications, and CPRS. Apply advisory note to high dose warnings and General Dosing Guidelines for medication administered through eye, ear, or nose. Create a customized frequency message. Create a general dosing information message. Create a Max Daily Dose Warning message for the calculated Daily Dose. Add FDB data elements from Dosing Order Check call to VistA side of interface. Display one warning if Maximum Single Dose and Max Daily Dose Order Check warning texts are identical. Adjust the Daily Dose if a Single Dose Adjustment is made for an IV order when performing Dosing Order Checks. Modify entries to the DOSE UNITS file (#51.24). Modify entries to the DOSE UNIT CONVERSION file (#51.25). Update Check PEPS Services Setup [PSS CHECK PEPS SERVICES SETUP] option to perform the Max Daily Dose Order Check instead of the Daily Dose Range Order Check. Patch Components: ================ Files & Fields Associated: ------------------------- Data updates to a handful of entries in the DOSE UNITS (#51.24) file were made to adjust to FDB changes and recent patch updates. The NAME (#.01), FIRST DATABANK DOSE UNIT (#1), and the SYNONYM (#.01) of the SYNONYM (#2) multiple fields are affected. Data updates to a handful of entries in the DOSE UNIT CONVERSION (#51.25) file were made to adjust to FDB changes and recent patch updates. The DOSE UNIT 1 (#.01) and DOSE UNIT 2 (#.01) of the DOSE UNIT 2 (#1) multiple fields are affected. Forms Associated: ---------------- N/A Mail Groups Associated: ---------------------- N/A Options Associated: ------------------ Check PEPS Services Setup [PSS CHECK PEPS SERVICES SETUP] Protocols Associated: -------------------- N/A Security Keys Associated: ------------------------ N/A Associated New Service Request(s): ================================= N/A Patient Safety Issues (PSI)s: ============================ N/A Remedy Ticket(s) & Overview: =========================== N/A Blood Bank Clearance: ==================== N/A Test Sites: ========== CHARLESTON, SC EASTERN COLORADO HCS HEARTLAND WEST HCS TENNESSEE VALLEY HCS WEST PALM BEACH, FL Documentation Retrieval Instructions: ==================================== Updated documentation describing the new functionality introduced by this patch is available. Sites may retrieve the documentation directly using Secure File Transfer Protocol (SFTP) from the ANONYMOUS.SOFTWARE directory at the following OI Field Offices: Hines: domain.ext Salt Lake City: domain.ext The preferred method is to retrieve files from download.vista.domain.ext. This transmits the files from the first available server. Sites may also elect to retrieve files directly from a specific server. Documentation can also be found on the VA Software Documentation Library at: http://www.domain.ext/vdl/ Title File Name SFTP Mode ----------------------------------------------------------------------- MOCHA Enhancements 2.1B PSS_1_PSO_7_PSJ_5_ binary Release Notes RN_R0218.PDF Pharmacy Data Management PSS_1_UM_R0218.PDF binary User Manual v1.0 Pharmacy Data Management PSS_1_TM_R0218.PDF binary Technical Manual v 1.0 MOCHA 2.1B Combined Builds MOCHA_21B_PSO_OR_PSJ_ binary Deployment, Installation, PSS_CB_IG.PDF Back-Out and Rollback Guide Pharmacy Data Management Dosing PSS_1_DOSING_ORD_CK_ binary Order Check User Manual UM_R0218.PDF Vista to MOCHA v2.0 PSS_1_VistA_to_ binary Interface Document MOCHA_ID.PDF Patch Installation: Pre/Post Installation Overview: ------------------------------ This patch must be installed before the combined build, PSS*1.0*206, and the combined follow up build are installed. Pre-Installation Instructions ============================= This patch must be obtained from the ANONYMOUS.SOFTWARE directory at one of the OI Field Offices. The preferred method is to SFTP the file from DOWNLOAD.VISTA.DOMAIN.EXT, which will transmit the file from the first available server. Alternatively, sites may elect to retrieve the file from a specific OI Field Office. Hines FTP.DOMAIN.EXT Salt Lake City FTP.DOMAIN.EXT The MOCHA 2.1B ENHANCEMENTS software distribution includes: File Name Contents Retrieval Format --------------------- ---------------- ---------------- PSS_1_178.KID PSS*1.0*178 ASCII MOCHA_2_1_PSO_OR_ PSJ*5.0*256 ASCII PSJ_BUILD.KID PSO*7.0*402 OR*3.0*382 PSS_1_206.KID PSS*1.0*206 ASCII MOCHA_2_1_FOLLOW_ PSO*7.0*500 ASCII UP_PSO_OR_PSJ.KID OR*3.0*469 PSJ*5.0*347 Installation Instructions ========================= Please refer to the MOCHA 2.1B Combined Builds Deployment, Installation, Back-Out and Rollback Guide for installation instructions. Post-Installation Instructions ============================== Review the install file build for this patch to ensure the eight file entry modifications executed properly. If any of the eight updates indicate anything other than 'PASSED' enter a CA ticket for National Product Support Pharmacy Benefits Management for assistance. These would be minor data issues so you may continue installing the remainder of the builds in the sequence. Routine Information: ==================== The second line of each of these routines now looks like: ;;1.0;PHARMACY DATA MANAGEMENT;**[Patch List]**;9/30/97;Build 14 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSS1P178 Before: n/a After: B29254276 **178** Routine Name: PSSDRDOS Before:B159075215 After:B158735197 **160,173,178** Routine Name: PSSDSAPA Before: B85990165 After:B107927231 **151,160,173,178** Routine Name: PSSDSAPD Before:B176555473 After:B185681379 **117,160,173,201,178** Routine Name: PSSDSAPI Before:B140100816 After:B201957555 **117,160,173,178** Routine Name: PSSDSAPK Before:B226082485 After:B230485547 **117,168,160,178** Routine Name: PSSDSAPL Before:B108974964 After:B115767579 **117,160,201,178** Routine Name: PSSDSAPM Before:B233971912 After:B188303275 **117,168,160,173,201,178** Routine Name: PSSDSEXC Before:B204998585 After:B205518936 **117,160,178** Routine Name: PSSDSEXD Before: n/a After:B194531746 **178** Routine Name: PSSDSEXE Before: n/a After: B89355466 **178** Routine Name: PSSDSUTA Before: n/a After:B132424539 **178** Routine Name: PSSDSUTL Before:B100218791 After:B122545264 **201,178** Routine Name: PSSHRIT Before:B243887860 After:B243980583 **136,168,164,173,180,184,178** Routine Name: PSSHRQ23 Before:B235617797 After:B265225897 **136,178** Routine Name: PSSHRQ24 Before: n/a After: B63136929 **178** Routine Name: PSSHRQ25 Before: n/a After: B59968308 **178** Routine Name: PSSHRQ2D Before: n/a After: B4603797 **178** Routine Name: PSSHRVAL Before:B160566342 After:B170865582 **136,160,178** Routine Name: PSSHRVL1 Before:B224743007 After:B239948287 **136,169,160,173,178** Routine Name: PSSSCHMS Before: n/a After: B72248048 **178** Routine list of preceding patches: 184, 201 ============================================================================= User Information: Entered By : Date Entered : MAR 12, 2013 Completed By: Date Completed: FEB 23, 2018 Released By : Date Released : FEB 26, 2018 ============================================================================= Packman Mail Message: ===================== No routines included