PSB Technical Manual 2.0 August 2002

This is the html version of the file ftp://ftp.va.gov/FOIA/VistAdocs/Clinical/Pharm-Presc_Practices_(PPP)/Change_Pages/PSB_2_P1_TM_CP.PDF. Google automatically generates html versions of documents as we crawl the web. Page 1 BAR CODE MEDICATION ADMINISTRATION (BCMA) TECHNICAL MANUAL/SECURITY GUIDE Version 2.0 May 2002 (Revised August 2002) Department of Veterans Affairs V IST A System Design & Development Page 2 Page 3 August 2002 BCMA V. 2.0 Technical Manual/Security Guide i Revision History Any changes subsequent to the initial release of this manual are listed below. You should update the manual with the pages listed under the Revised Pages column. Pages listed under this column in parentheses are unchanged, but included for two-sided copying. Date Revised Pages Patch Number Description 08/02 Title Page, (5)-6, 7-(8) PSB*2*1 – Updated the Title Page and included this Revision History Page. – Renumbered the pages with Roman numerals to include the Revision History Page. – Decreased the total number of routines for BCMA V. 2.0 to equal 51. – Changed the “BCMA V. 2.0 Routines Installed on to V IST A Server” example to reflect the deletion of routine PSB0000 from the V IST A Server. 05/02 Original Released GUI User Manual. PSB*2*1 Page 4 ii BCMA V. 2.0 Technical Manual/Security Guide August 2002 PSB*2*1 Page 5 Table of Contents BCMA V. 2.0 and This Guide....................................................................................1 Benefits of BCMA V. 2.0 ...................................................................................................................1 Benefits of This Guide........................................................................................................................1 Our Target Audience............................................................................................................................ 1 Other Sources of Information..............................................................................................................2 Background/Technical Information ..................................................................................................... 2 This Manual and Related Documentation............................................................................................ 2 Conventions Used in This Guide ........................................................................................................2 Obtaining On-line Help.......................................................................................................................3 Locating Detailed Listings..................................................................................................................3 Routines ............................................................................................................................................... 3 Data Dictionaries.................................................................................................................................. 3 Implementation and Maintenance............................................................................4 Minimum Required Packages .............................................................................................................4 Required Patches.................................................................................................................................5 Installation Time Estimates.................................................................................................................5 Resource Requirements.......................................................................................................................6 Response Time Monitor....................................................................................................................... 6 Laptops and Bar Code Scanners........................................................................................................... 6 Printers ................................................................................................................................................. 6 Unit Dose Label Printer Devices.......................................................................................................... 6 IV Label Printer Devices...................................................................................................................... 6 Files Required to Run BCMA V. 2.0..................................................................................................7 Routines Installed................................................................................................................................7 Routines Mapping................................................................................................................................ 7 Items Deleted During the Install Process............................................................................................8 New Site Parameters in BCMA V. 2.0 ...............................................................................................9 BCMA Idle Timeout .......................................................................................................................... 10 CPRS Med Order Link (“Hot Button”).............................................................................................. 10 IV Functionality ................................................................................................................................. 11 Exported Options....................................................................................................16 BCMA CHUI Menus ........................................................................................................................16 Manager Menu [PSB MGR] .............................................................................................................. 16 Pharmacy Medication Administration Menu [PSB PHARMACY]................................................... 17 Nursing Medication Administration Menu [PSB NURSE]................................................................ 17 Archiving and Purging............................................................................................18 Archive and Purge Capabilities.........................................................................................................18 August 2002 BCMA V. 2.0 Technical Manual/Security Guide iii PSB*2*1 Page 6 Table of Contents Security Features....................................................................................................19 Defining Mail Groups in BCMA ......................................................................................................19 Creating Mail Groups for BCMA V. 2.0............................................................................................ 19 Mail Group Types in BCMA V. 2.0................................................................................................... 19 Assigning Menus to Users ................................................................................................................20 CHUI Version .................................................................................................................................... 20 GUI Version....................................................................................................................................... 20 Allocating Security Keys to Users....................................................................................................20 Establishing Electronic Signature Codes ..........................................................................................20 Developing a Contingency Plan........................................................................................................21 Internal and External Relations..............................................................................22 Internal Relations..............................................................................................................................22 Options............................................................................................................................................... 22 Package-Wide Variables.................................................................................................................... 22 Templates........................................................................................................................................... 22 External Relations.............................................................................................................................22 Callable Routines, Entry Points, and Variables ................................................................................. 23 Database Integration Agreements (DBIAs) ....................................................................................... 25 Glossary...................................................................................................................26 Learning BCMA V. 2.0 Lingo..........................................................................................................26 iv BCMA V. 2.0 Technical Manual/Security Guide August 2002 PSB*2*1 Page 7 Implementation and Maintenance Required Patches Before installing the BCMA V. 2.0 Master Build, make sure that the following released patches are installed. Pharmacy Data Management V. 1.0 PSS*1*46 – requires the following patch • PSS*1*44 Inpatient Medications V. 5.0 PSJ*5*58 – requires the following patches • PSJ*5*24 • PSJ*5*62 • PSS*1*46 – will be installed as part of the BCMA V. 2.0 Master Build • PSJ*5*68 • PSJ*5*69 • PSJ*5*71 • PSJ*5*75 CPRS V. 1.0 OR*3*133 RPC Broker V. 1.1 XWB*1.1*26 XWB*1.1*29 Installation Time Estimates On average, it takes approximately one minute to install BCMA V. 2.0. This estimate was provided by one of our BCMA V. 2.0 Beta Test sites. Suggested time to install: non-peak requirement hours. PC Client users should not be accessing the Client Software. Note: Actual times may vary, depending on how your site is using its’ system resources. May 2002 BCMA V. 2.0 Technical Manual/Security Guide 5 Page 8 Page 9 Implementation and Maintenance Resource Requirements This section summarizes the (approximate) number of resources required to install BCMA V. 2.0. • Routines 51 • Globals 1 (^PSB) • Files 5 (53.66-53.79) • ^PSB Size Unit Dose = 300 x # of Medications (in bytes) Administered IV = 2100 x # of IV Bags Administered • FTEE Support .2 • FTEE Maintenance .2 Response Time Monitor BCMA V. 2.0 does not include Response Time Monitor hooks. Laptops and Bar Code Scanners The approximate requirements for laptops and bar code scanners depend on the number of Inpatient areas, at your site, that use BCMA for administering active medication orders. The BCMA Development Team recommends that your site have a minimum of three laptops and three scanners for each ward. Printers Your site should provide printers for creating patient wristbands and medication bar code labels, and for handling Missing Dose Requests sent from BCMA V. 2.0 to the Pharmacy. Unit Dose Label Printer Devices BCMA V. 2.0 includes the Label print [PSBO BL] option for printing individual or batch Unit Dose bar code labels. It is specifically coded to the Zebra-brand printers using ZPL command language. Model 105SE was used in the development of the labels. Routine PSBO BL uses site- specific printers or terminals to produce labels. IV Label Printer Devices Inpatient Medications V. 5.0 provides an option for printing individual or batch IV bar code labels. See the section “Interfacing with the Bar Code Label Printer” in the Inpatient Medications V. 5.0 Technical Manual/Security Guide for detailed setup information. as the “mean.” TIP

The approximate size for ^PSB was calculated using a “normal” Med Pass for a Unit Dose and an IV medication order. This is only an estimated number; it serves 6 BCMA V. 2.0 Technical Manual/Security Guide August 2002 PSB*2*1 Page 10 Page 11 Implementation and Maintenance Files Required to Run BCMA V. 2.0 BCMA V. 2.0 uses the following files installed on the V IST A Server. “Journaling” is recommended. • ^PSB (53.66, BCMA IV Parameters • ^PSB (53.68, BCMA Missing Dose Request • ^PSB (53.69, BCMA Report Request • ^PSB (53.78, BCMA Medication Variance Log • ^PSB (53.79, BCMA Medication Log Note: You can learn more about these files by generating a list with file attributes using VA FileMan. Routines Installed Review the listing below to learn the routines installed on to your site’s V IST A Server during the installation of BCMA V. 2.0. The first line of each routine briefly describes its general function. Note: You can use the Kernel XU First Line Print (First Line Routine Print) option to print a list containing the first line of each PSB routine. Routine Mapping At this time, we do not offer any recommendations for routine mapping. However, if you choose to map the BCMA V. 2.0 package routines, you will need to bring your system down, and then restart it to load the new routines into memory. TIP

The namespace for the BCMA package is PSB and the primary global is ^PSB. Example: BCMA V. 2.0 Routines Installed on to V IST A Server PSBALL PSBAPIPM PSBMD PSBML PSBML1 PSBMLEN PSBMLEN1 PSBMLHS PSBMLTS PSBMLU PSBMLVAL PSBO PSBO1 PSBOAL PSBOBL PSBODL PSBODL1 PSBODO PSBOHDR PSBOMD PSBOMH PSBOMH1 PSBOMH2 PSBOML PSBOMM PSBOMV PSBOPE PSBOPI PSBOPM PSBOWA PSBPAR PSBPARIV PSBPOIV PSBPRN PSBRPC PSBRPC1 PSBRPC2 PSBRPCMO PSBRPCXM PSBSAGG PSBUTL PSBVAR PSBVDLIV PSBVDLPA PSBVDLPB PSBVDLTB PSBVDLU1 PSBVDLU2 PSBVDLUD PSBVDLVL PSBVT August 2002 BCMA V. 2.0 Technical Manual/Security Guide 7 PSB*2*1 Page 12 Page 13 Implementation and Maintenance Items Deleted During the Install Process This section lists the items deleted during the installation of BCMA V. 2.0. • Files None • Options None • Routines PSBVDL, PSBVDL1, PSBVDL2, PSBORL • Templates None 8 BCMA V. 2.0 Technical Manual/Security Guide May 2002