|
|
| 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
| |
