|
|
| Line 1: |
Line 1: |
| 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. | | This is still a work in progress |
| 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
| |
