PSB Technical Manual 2.0 August 2002

From VistApedia
Revision as of 16:17, 16 July 2009 by DavidWhitten (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

This is the html version of the file <a href="ftp://ftp.va.gov/FOIA/VistAdocs/Clinical/Pharm-Presc_Practices_(PPP)/Change_Pages/PSB_2_P1_TM_CP.PDF" style="text-decoration:underline;color:#00c">ftp://ftp.va.gov/FOIA/VistAdocs/Clinical/Pharm-Presc_Practices_(PPP)/Change_Pages/PSB_2_P1_TM_CP.PDF</a>.
Google automatically generates html versions of documents as we crawl the web.

<html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <meta name="Producer" content="Acrobat Distiller 5.0 (Windows)"> <meta name="Author" content="EDS"> <meta name="Creator" content="Acrobat PDFMaker 5.0 for Word"> <meta name="ModDate" content="D:20020819114415-04'00'"> <meta name="CreationDate" content="D:20020819114411-05'00'"> <title>First Level of TOC</title>

</head><body bgcolor=#ffffff vlink="blue" link="blue">

<a name=1>Page 1</a>
<nobr>BAR CODE MEDICATION </nobr>
<nobr>ADMINISTRATION (BCMA) </nobr>

<nobr>TECHNICAL MANUAL/SECURITY GUIDE </nobr>

<nobr>Version 2.0 </nobr>
<nobr>May 2002 </nobr>

<nobr>(Revised August 2002) </nobr>
<nobr>Department of Veterans Affairs </nobr>
<nobr>V</nobr>

<nobr>IST</nobr>

<nobr>A System Design & Development </nobr>


<a name=2>Page 2</a>

<a name=3>Page 3</a>
<nobr>August 2002 </nobr>
<nobr>BCMA V. 2.0 Technical Manual/Security Guide </nobr>
<nobr>i </nobr>

<nobr>Revision History </nobr>

<nobr>Any changes subsequent to the initial release of this manual are listed below. You should update </nobr>
<nobr>the manual with the pages listed under the Revised Pages column. Pages listed under this column</nobr>
<nobr>in parentheses are unchanged, but included for two-sided copying. </nobr>

<nobr>Date Revised </nobr>
<nobr>Pages </nobr>
<nobr>Patch </nobr>
<nobr>Number </nobr>
<nobr>Description </nobr>

<nobr>08/02 </nobr>
<nobr>Title Page, </nobr>
<nobr>(5)-6, 7-(8) </nobr>
<nobr>PSB*2*1</nobr>
<nobr>– Updated the Title Page and included this Revision History Page. </nobr>
<nobr>– Renumbered the pages with Roman numerals to include the Revision</nobr>
<nobr>History Page. </nobr>
<nobr>– Decreased the total number of routines for BCMA V. 2.0 to equal 51. </nobr>
<nobr>– Changed the “BCMA V. 2.0 Routines Installed on to V</nobr>

<nobr>IST</nobr>

<nobr>A Server” </nobr>
<nobr>example to reflect the deletion of routine PSB0000 from the V</nobr>

<nobr>IST</nobr>

<nobr>A </nobr>
<nobr>Server. </nobr>
<nobr>05/02 </nobr>
<nobr>Original Released GUI User Manual.</nobr>
<nobr>PSB*2*1</nobr>


<a name=4>Page 4</a>
<nobr>ii</nobr>
<nobr>BCMA V. 2.0 Technical Manual/Security Guide </nobr>
<nobr>August 2002</nobr>
<nobr>PSB*2*1</nobr>


<a name=5>Page 5</a>
<nobr>Table of Contents </nobr>

<nobr>BCMA V. 2.0 and This Guide....................................................................................1 </nobr>

<nobr>Benefits of BCMA V. 2.0 ...................................................................................................................1 </nobr>
<nobr>Benefits of This Guide........................................................................................................................1 </nobr>

<nobr>Our Target Audience............................................................................................................................ 1 </nobr>

<nobr>Other Sources of Information..............................................................................................................2 </nobr>

<nobr>Background/Technical Information ..................................................................................................... 2 </nobr>
<nobr>This Manual and Related Documentation............................................................................................ 2 </nobr>

<nobr>Conventions Used in This Guide ........................................................................................................2 </nobr>
<nobr>Obtaining On-line Help.......................................................................................................................3 </nobr>
<nobr>Locating Detailed Listings..................................................................................................................3 </nobr>

<nobr>Routines ............................................................................................................................................... 3 </nobr>
<nobr>Data Dictionaries.................................................................................................................................. 3 </nobr>

<nobr>Implementation and Maintenance............................................................................4 </nobr>

<nobr>Minimum Required Packages .............................................................................................................4 </nobr>
<nobr>Required Patches.................................................................................................................................5 </nobr>
<nobr>Installation Time Estimates.................................................................................................................5 </nobr>
<nobr>Resource Requirements.......................................................................................................................6 </nobr>

<nobr>Response Time Monitor....................................................................................................................... 6 </nobr>
<nobr>Laptops and Bar Code Scanners........................................................................................................... 6 </nobr>
<nobr>Printers ................................................................................................................................................. 6 </nobr>
<nobr>Unit Dose Label Printer Devices.......................................................................................................... 6 </nobr>
<nobr>IV Label Printer Devices...................................................................................................................... 6 </nobr>

<nobr>Files Required to Run BCMA V. 2.0..................................................................................................7 </nobr>
<nobr>Routines Installed................................................................................................................................7 </nobr>

<nobr>Routines Mapping................................................................................................................................ 7 </nobr>

<nobr>Items Deleted During the Install Process............................................................................................8 </nobr>
<nobr>New Site Parameters in BCMA V. 2.0 ...............................................................................................9 </nobr>

<nobr>BCMA Idle Timeout .......................................................................................................................... 10 </nobr>
<nobr>CPRS Med Order Link (“Hot Button”).............................................................................................. 10 </nobr>
<nobr>IV Functionality ................................................................................................................................. 11 </nobr>

<nobr>Exported Options....................................................................................................16 </nobr>

<nobr>BCMA CHUI Menus ........................................................................................................................16 </nobr>

<nobr>Manager Menu [PSB MGR] .............................................................................................................. 16 </nobr>
<nobr>Pharmacy Medication Administration Menu [PSB PHARMACY]................................................... 17 </nobr>
<nobr>Nursing Medication Administration Menu [PSB NURSE]................................................................ 17 </nobr>

<nobr>Archiving and Purging............................................................................................18 </nobr>

<nobr>Archive and Purge Capabilities.........................................................................................................18 </nobr>

<nobr>August 2002 </nobr>
<nobr>BCMA V. 2.0 Technical Manual/Security Guide </nobr>
<nobr>iii </nobr>
<nobr>PSB*2*1</nobr>


<a name=6>Page 6</a>
<nobr>Table of Contents </nobr>

<nobr>Security Features....................................................................................................19 </nobr>

<nobr>Defining Mail Groups in BCMA ......................................................................................................19 </nobr>

<nobr>Creating Mail Groups for BCMA V. 2.0............................................................................................ 19 </nobr>
<nobr>Mail Group Types in BCMA V. 2.0................................................................................................... 19 </nobr>

<nobr>Assigning Menus to Users ................................................................................................................20 </nobr>

<nobr>CHUI Version .................................................................................................................................... 20 </nobr>
<nobr>GUI Version....................................................................................................................................... 20 </nobr>

<nobr>Allocating Security Keys to Users....................................................................................................20 </nobr>
<nobr>Establishing Electronic Signature Codes ..........................................................................................20 </nobr>
<nobr>Developing a Contingency Plan........................................................................................................21 </nobr>

<nobr>Internal and External Relations..............................................................................22 </nobr>

<nobr>Internal Relations..............................................................................................................................22 </nobr>

<nobr>Options............................................................................................................................................... 22 </nobr>
<nobr>Package-Wide Variables.................................................................................................................... 22 </nobr>
<nobr>Templates........................................................................................................................................... 22 </nobr>

<nobr>External Relations.............................................................................................................................22 </nobr>

<nobr>Callable Routines, Entry Points, and Variables ................................................................................. 23 </nobr>
<nobr>Database Integration Agreements (DBIAs) ....................................................................................... 25 </nobr>

<nobr>Glossary...................................................................................................................26 </nobr>

<nobr>Learning BCMA V. 2.0 Lingo..........................................................................................................26 </nobr>

<nobr>iv</nobr>
<nobr>BCMA V. 2.0 Technical Manual/Security Guide </nobr>
<nobr>August 2002</nobr>
<nobr>PSB*2*1</nobr>


<a name=7>Page 7</a>
<nobr>Implementation and Maintenance </nobr>

<nobr>Required Patches </nobr>

<nobr>Before installing the BCMA V. 2.0 Master Build, make sure that the </nobr>
<nobr>following released patches are installed. </nobr>
<nobr>Pharmacy Data Management V. 1.0 </nobr>
<nobr>PSS*1*46 – requires the following patch</nobr>
<nobr>• PSS*1*44 </nobr>
<nobr>Inpatient Medications V. 5.0 </nobr>
<nobr>PSJ*5*58 – requires the following patches</nobr>
<nobr>• PSJ*5*24 </nobr>
<nobr>• PSJ*5*62 </nobr>
<nobr>• PSS*1*46 – will be installed as part of the BCMA V. 2.0 </nobr>
<nobr>Master Build </nobr>
<nobr>• PSJ*5*68 </nobr>
<nobr>• PSJ*5*69 </nobr>
<nobr>• PSJ*5*71 </nobr>
<nobr>• PSJ*5*75 </nobr>
<nobr>CPRS V. 1.0 </nobr>
<nobr>OR*3*133</nobr>
<nobr>RPC Broker V. 1.1 </nobr>
<nobr>XWB*1.1*26 </nobr>
<nobr>XWB*1.1*29 </nobr>

<nobr>Installation Time </nobr>
<nobr>Estimates </nobr>

<nobr>On average, it takes approximately one minute to install BCMA V. 2.0. </nobr>
<nobr>This estimate was provided by one of our BCMA V. 2.0 Beta Test sites. </nobr>
<nobr>Suggested time to install: non-peak requirement hours. PC Client users </nobr>
<nobr>should not be accessing the Client Software. </nobr>

<nobr>Note: </nobr>

<nobr>Actual times may vary, depending on how your site is using its’ </nobr>
<nobr>system resources. </nobr>

<nobr>May 2002 </nobr>
<nobr>BCMA V. 2.0 Technical Manual/Security Guide </nobr>
<nobr>5</nobr>


<a name=8>Page 8</a>

<a name=9>Page 9</a>
<nobr>Implementation and Maintenance </nobr>

<nobr>Resource</nobr>
<nobr>Requirements </nobr>

<nobr>This section summarizes the (approximate) number of resources </nobr>
<nobr>required to install BCMA V. 2.0. </nobr>
<nobr>• Routines </nobr>
<nobr>51 </nobr>
<nobr>• Globals </nobr>
<nobr>1 (^PSB) </nobr>
<nobr>• Files </nobr>
<nobr>5 (53.66-53.79) </nobr>
<nobr>• ^PSB Size </nobr>
<nobr>Unit Dose = 300 x # of Medications </nobr>
<nobr>(in bytes) </nobr>
<nobr>Administered</nobr>
<nobr>IV = 2100 x # of IV Bags </nobr>
<nobr>Administered</nobr>
<nobr>• FTEE Support </nobr>
<nobr>.2 </nobr>
<nobr>• FTEE Maintenance .2 </nobr>

<nobr>Response Time Monitor </nobr>

<nobr>BCMA V. 2.0 does not include Response Time Monitor hooks. </nobr>

<nobr>Laptops and Bar Code Scanners </nobr>

<nobr>The approximate requirements for laptops and bar code scanners </nobr>
<nobr>depend on the number of Inpatient areas, at your site, that use BCMA </nobr>
<nobr>for administering active medication orders. The BCMA Development </nobr>
<nobr>Team recommends that your site have a minimum of three laptops and </nobr>
<nobr>three scanners for each ward. </nobr>

<nobr>Printers </nobr>

<nobr>Your site should provide printers for creating patient wristbands and </nobr>
<nobr>medication bar code labels, and for handling Missing Dose Requests </nobr>
<nobr>sent from BCMA V. 2.0 to the Pharmacy. </nobr>

<nobr>Unit Dose Label Printer Devices </nobr>

<nobr>BCMA V. 2.0 includes the Label print [PSBO BL] option for printing </nobr>
<nobr>individual or batch Unit Dose bar code labels. It is specifically coded to </nobr>
<nobr>the Zebra-brand printers using ZPL command language. Model 105SE </nobr>
<nobr>was used in the development of the labels. Routine PSBO BL uses site-</nobr>
<nobr>specific printers or terminals to produce labels. </nobr>

<nobr>IV Label Printer Devices </nobr>

<nobr>Inpatient Medications V. 5.0 provides an option for printing individual </nobr>
<nobr>or batch IV bar code labels. See the section “Interfacing with the Bar </nobr>
<nobr>Code Label Printer” in the Inpatient Medications V. 5.0 Technical </nobr>
<nobr>Manual/Security Guide for detailed setup information. </nobr>

<nobr>as the “mean.”</nobr>
<nobr>TIP</nobr>

<nobr>: </nobr>

<nobr>The approximate </nobr>
<nobr>size for ^PSB was </nobr>
<nobr>calculated using a </nobr>
<nobr>“normal” Med Pass </nobr>
<nobr>for a Unit Dose and </nobr>
<nobr>an IV medication </nobr>
<nobr>order. This is only</nobr>
<nobr>an estimated </nobr>
<nobr>number; it serves </nobr>

<nobr>6 </nobr>
<nobr>BCMA V. 2.0 Technical Manual/Security Guide </nobr>
<nobr>August 2002</nobr>
<nobr>PSB*2*1</nobr>


<a name=10>Page 10</a>

<a name=11>Page 11</a>
<nobr>Implementation and Maintenance </nobr>

<nobr>Files Required to </nobr>
<nobr>Run BCMA V. 2.0 </nobr>

<nobr>BCMA V. 2.0 uses the following files installed on the V</nobr>

<nobr>IST</nobr>

<nobr>A Server. </nobr>
<nobr>“Journaling” is recommended. </nobr>
<nobr>• ^PSB (53.66, </nobr>
<nobr>BCMA IV Parameters </nobr>
<nobr>• ^PSB (53.68,</nobr>
<nobr>BCMA Missing Dose Request </nobr>
<nobr>• ^PSB (53.69,</nobr>
<nobr>BCMA Report Request </nobr>
<nobr>• ^PSB (53.78,</nobr>
<nobr>BCMA Medication Variance Log </nobr>
<nobr>• ^PSB (53.79,</nobr>
<nobr>BCMA Medication Log </nobr>

<nobr>Note: </nobr>

<nobr>You can learn more about these files by generating a list with</nobr>
<nobr>file attributes using VA FileMan.</nobr>

<nobr>Routines Installed</nobr>

<nobr>Review the listing below to learn the routines installed on to your </nobr>
<nobr>site’s V</nobr>

<nobr>IST</nobr>

<nobr>A Server during the installation of BCMA V. 2.0. The first </nobr>
<nobr>line of each routine briefly describes its general function. </nobr>

<nobr>Note:</nobr>

<nobr>You can use the Kernel XU First Line Print (First Line Routine </nobr>
<nobr>Print) option to print a list containing the first line of each PSB </nobr>
<nobr>routine. </nobr>

<nobr>Routine Mapping </nobr>

<nobr>At this time, we do not offer any recommendations for routine </nobr>
<nobr>mapping. However, if you choose to map the BCMA V. 2.0 package </nobr>
<nobr>routines, you will need to bring your system down, and then restart it </nobr>
<nobr>to load the new routines into memory. </nobr>

<nobr>TIP</nobr>

<nobr>: </nobr>

<nobr>The namespace for </nobr>
<nobr>the BCMA package </nobr>
<nobr>is PSB and the</nobr>
<nobr>primary global</nobr>
<nobr>is ^PSB. </nobr>

<nobr>Example: BCMA V. 2.0 Routines Installed on to V</nobr>

<nobr>IST</nobr>

<nobr>A Server </nobr>

<nobr>PSBALL PSBAPIPM PSBMD PSBML PSBML1 PSBMLEN PSBMLEN1 PSBMLHS </nobr>
<nobr>PSBMLTS PSBMLU PSBMLVAL PSBO PSBO1 PSBOAL PSBOBL PSBODL </nobr>
<nobr>PSBODL1 PSBODO PSBOHDR PSBOMD PSBOMH PSBOMH1 PSBOMH2 PSBOML </nobr>
<nobr>PSBOMM PSBOMV PSBOPE PSBOPI PSBOPM PSBOWA PSBPAR PSBPARIV </nobr>
<nobr>PSBPOIV PSBPRN PSBRPC PSBRPC1 PSBRPC2 PSBRPCMO PSBRPCXM PSBSAGG </nobr>
<nobr>PSBUTL PSBVAR PSBVDLIV PSBVDLPA PSBVDLPB PSBVDLTB PSBVDLU1 PSBVDLU2 </nobr>
<nobr>PSBVDLUD PSBVDLVL PSBVT </nobr>
<nobr>August 2002 </nobr>
<nobr>BCMA V. 2.0 Technical Manual/Security Guide </nobr>
<nobr>7</nobr>
<nobr>PSB*2*1</nobr>


<a name=12>Page 12</a>

<a name=13>Page 13</a>
<nobr>Implementation and Maintenance </nobr>

<nobr>Items Deleted </nobr>
<nobr>During the Install </nobr>
<nobr>Process </nobr>

<nobr>This section lists the items deleted during the installation of </nobr>
<nobr>BCMA V. 2.0. </nobr>
<nobr>• Files </nobr>
<nobr>None </nobr>
<nobr>• Options </nobr>
<nobr>None </nobr>
<nobr>• Routines </nobr>
<nobr>PSBVDL, PSBVDL1, PSBVDL2, </nobr>
<nobr>PSBORL </nobr>
<nobr>• Templates </nobr>
<nobr>None </nobr>

<nobr>8 </nobr>
<nobr>BCMA V. 2.0 Technical Manual/Security Guide </nobr>
<nobr>May 2002</nobr>

</body>

</html>