View source for 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