$TXT Created by ANWER,MOHAMED at INOCACHE.FO-BIRM.MED.VA.GOV (KIDS) on Monday, 07/13/09 at 13:51 ============================================================================= Run Date: OCT 14, 2009 Designation: PSS*1*140 Package : PSS - PHARMACY DATA MANAGEMENT Priority: Mandatory Version : 1 SEQ #131 Status: Released Compliance Date: NOV 14, 2009 ============================================================================= Associated patches: (v)PSS*1*94 <<= must be installed BEFORE `PSS*1*140' (v)PSS*1*129 <<= must be installed BEFORE `PSS*1*140' (v)PSS*1*137 <<= must be installed BEFORE `PSS*1*140' Subject: Y09-Q2 ENHANCEMENTS Category: - Routine - Enhancement (Mandatory) - Data Dictionary - Other - Print Template - Sort Template Description: ============ This enhancement is an interim resolution approved by the Inpatient Medications Workgroup and Pharmacy Legacy Quarterly Enhancement (PLQE) User Group for Patient Safety Issue PSI 08-026, PSPO #852 as described in Remedy Ticket HD233682. This patch will help mitigate incorrect medication routes being displayed for selection in the Computerized Patient Record System V. 3.0 (CPRS). Problem: -------- Currently, for unit dose orders and Outpatient Pharmacy orders, all medication routes for the dosage form of the orderable item are being displayed in CPRS as possible medication routes to be selected. Even if an orderable item is to be given only Intramuscular (IM), the provider sees a dropdown list to select a potentially inappropriate medication route of Subcutaneous (SC) or Intravenous (IV). Resolution: ----------- This enhancement affects both Inpatient Medications unit dose orders entered via the Inpatient Medications order dialog in CPRS as well as Outpatient Pharmacy orders entered via CPRS. A new parameter will be added to the PHARMACY SYSTEM file (#59.7) to support this functionality (see below). With this parameter set to YES, CPRS order dialogs will display only the default medication route for the orderable item in the medication route selection list in CPRS if a default medication route is defined in the PHARMACY ORDERABLE ITEM file (#50.7). If there is no default medication route defined for the orderable item, then the current functionality will be retained and all possible medication routes for the dosage form will be displayed to the provider for selection in CPRS. Routine PSSJORDF will be modified for this enhancement. This enhancement adds the DEFAULT MED ROUTE FOR CPRS field (#80.7) to the PHARMACY SYSTEM file (#59.7) to support the functionality of this patch. The field will serve as a toggle, allowing the site to choose whether they want to implement the features of this patch in their system. This field is maintained by the Pharmacy System Parameters Edit [PSS SYS EDIT] option. The default for this field is YES when first accessing this field from this option. This field may be set to YES or NO. An example of setting this to YES appears below. Example screen: Select Pharmacy Data Management Option: Pharmacy System Parameters Edit PMIS PRINTER: NULL DEVICE// PMIS LANGUAGE: English// WARNING LABEL SOURCE: CMOP WARNING LABEL SOURCE: OPAI WARNING LABEL SOURCE: AUTOMATE CPRS REFILL: DEFAULT MED ROUTE FOR CPRS: Y YES DATA NAME GLOBAL DATA ELEMENT TITLE LOCATION TYPE -------------------------------------------------------------------------- 59.7,80.7 DEFAULT MED ROUTE FOR CPRS 80;7 SET '0' FOR NO; '1' FOR YES; LAST EDITED: MAY 28, 2009 HELP-PROMPT: Enter Y to display only the default med route in CPRS or N to continue with the current functionality. DESCRIPTION: This field should be marked "YES" if the site prefers the MED ROUTE field (#.06) in the PHARMACY ORDERABLE ITEM file (#50.7) to appear as the default/only entry during CPRS order entry. If no default medication route is defined in the PHARMACY ORDERABLE ITEM file (#50.7), then the routes from the DOSAGE FORM file (#50.606) will display. This field will affect only orders entered via the Inpatient Medications dialog or the Outpatient Medications dialog in CPRS. It will not impact IV Fluids entered via CPRS or orders entered via backdoor Pharmacy. TECHNICAL DESCR: Set of codes. "YES" to display only the default med route in CPRS and "NO" to continue with the current functionality. The following table summarizes the functionality of this patch. **NOTE** This patch will be exported with the new parameter set to YES. Default OI Med Site Parameter Route Defined CPRS Med Route Selection List -------------- -------------- ----------------------------- YES YES Default med route is the only route in selection list. Default med route pre-populates the selection box. YES NO All med routes from dosage form display. Nothing pre-populates the selection box. NO YES All med routes from dosage form display. Default med route pre-populates the selection box. NO NO All med routes from dosage form display. Nothing pre-populates the selection box. Additionally, this patch will provide a new option called Default Med Route For OI Report [PSS DEF MED ROUTE OI RPT] that will be added to the Medication Routes Management [PSS MEDICATION ROUTES MGMT] menu. The site can use this report to identify the current default medication route for the orderable item. Here is an example of the report: DEFAULT MED ROUTE FOR ORDERABLE ITEM REPORT JUN 17,2009 PAGE 1 OI NAME DOSAGE FORM ASSOCIATED ROUTES DEFAULT ROUTE DRUG -------------------------------------------------------------------------- IBERET LIQUID ORAL (BY MOUTH) IBERET-500 ORAL IBUPROFEN TAB ORAL (BY MOUTH) IBUPROFEN 600MG IDOXURIDINE OINT,OPH RIGHT EYE LEFT EYE BOTH EYES IDOXURIDINE 0.5% IMIPRAMINE TAB ORAL (BY MOUTH) IMIPRAMINE 25MG IMIPRAMINE 50MG INDOCYANINE INJ,SOLN INTRAMUSCULAR INTRAVENOUS INTRAVENOUS INDOCYANINE 25MG INSULIN INJ INTRAMUSCULAR INTRAVENOUS ORAL SUBCUTANEOUS INTRAVENOUS INSULIN LENTE INSULIN NPH Associated NSR's: ================ N/A Associated PSIs: ================ PSI 08-026, PSPO #852 Associated Remedy Tickets: ========================== HD0000000233682 Associated E3Rs: ================ N/A Test Sites: =========== DURHAM, NC NEW YORK HCS, NY OKLAHOMA CITY, OK Documentation Retrieval: ======================== The documentation is available on the ANONYMOUS.SOFTWARE directory at one of the following Office of Information (OI) Field Offices. Albany Hines Salt Lake City 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 listed below. Albany ftp.fo-albany.med.va.gov Hines ftp.fo-hines.med.va.gov Salt Lake City ftp.fo-slc.med.va.gov The documentation distribution includes the following. FILE NAME DESCRIPTION PSS_1_UM_R0809.PDF Pharmacy Data Management User Manual PSS_1_P140_UM_CP.PDF Pharmacy Data Management User Manual Change Pages PSS_1_TM_R0809.PDF Pharmacy Data Management Technical Manual/Security Guide PSS_1_P140_TM_CP.PDF Pharmacy Data Management Technical Manual/Security Guide Change Pages (3) Documentation can also be retrieved from the VistA Documentation Library (VDL) on the Internet at the following address: http://www.va.gov/vdl. Install Information: ==================== 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 PSS*1.0*140): 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. It compares all components of the patch (routines, DDs, templates, etc.). c. Verify Checksums in Transport Global - this option will ensure the integrity of the routines that are in the transport global. 4. Use the Install Package(s) option and select the package PSS*1.0*140. 5. When prompted "Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//" respond NO. 6. When prompted "Want KIDS to INHIBIT LOGONs during the install? NO//" respond NO. 7. When prompted "Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//" respond NO. Routine Information: ==================== The second line of each of these routines now looks like: ;;1.0;PHARMACY DATA MANAGEMENT;**[Patch List]**;9/30/97;Build 9 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSSJORDF Before: B36649764 After: B37133061 **5,13,34,38,69,113,94,140** Routine Name: PSSP140 Before: n/a After: B164003 **140** Routine Name: PSSYSP Before: B143904 After: B162983 **20,38,87,120,137,140** ============================================================================= User Information: Entered By : CASTLE,JOHN Date Entered : OCT 09, 2008 Completed By: GREER,MIKE Date Completed: OCT 14, 2009 Released By : TEAGUE,LYN Date Released : OCT 14, 2009 ============================================================================= Packman Mail Message: ===================== $END TXT