7. EPMO Open Source Coordination Office Redaction File Detail Report

Produced by Araxis Merge on 8/29/2018 2:55:50 PM Central Daylight Time. See www.araxis.com for information about Merge. This report uses XHTML and CSS2, and is best viewed with a modern standards-compliant browser. For optimum results when printing this report, use landscape orientation and enable printing of background images and colours in your browser.

7.1 Files compared

# Location File Last Modified
1 EPIP.zip\PSS_1.0_225_PSB_3.0_103 _Aug_2018 psb_3_tm_r1118.doc Tue Aug 28 12:14:54 2018 UTC
2 EPIP.zip\PSS_1.0_225_PSB_3.0_103 _Aug_2018 psb_3_tm_r1118.doc Tue Aug 28 12:31:56 2018 UTC

7.2 Comparison summary

Description Between
Files 1 and 2
Text Blocks Lines
Unchanged 5 2050
Changed 4 8
Inserted 0 0
Removed 0 0

7.3 Comparison options

Whitespace
Character case Differences in character case are significant
Line endings Differences in line endings (CR and LF characters) are ignored
CR/LF characters Not shown in the comparison detail

7.4 Active regular expressions

No regular expressions were active.

7.5 Comparison detail

  1   BCMA Techn ical Manua l
  2   BAR CODE M EDICATION  ADMINISTRA TION (BCMA )
  3   TECHNICAL  MANUAL/SEC URITY GUID E
  4   Version 3. 0
  5   February 2 004
  6   (Revised N ovember 20 18)
  7   Department  of Vetera ns Affairs
  8   Office of  Informatio n and Tech nology
  9   Revision H istory
  10   DateRevise d PagesPat ch NumberD escription 11/20187,  8, 9PSB*3* 103Added n ew routine  names to  the Routin es Install ed table.  Added "Rep ort for Re spiratory  Therapy Me dications"  option to  the Medic ation Admi nistration  Menu Phar macy. 
  11   (G. Miller , PM; T. T urowski, T ech Writer )12/2016i,  8, 9PSB*3 *88Add “BC MA Drug IE N Synonym  Check” opt ion to Pha rmacy Medi cation Adm inistratio n Menu12/2 016All
  12   6
  13   7
  14   9
  15   19 PSB*3*8 3Renumbere d pages to  remove su b-pages a,  b, etc.
  16   Updated nu mber of ro utines in  list. 
  17   Added new  Routine “P SBVDLRM”. 
  18   Spelled ou t first us e of acron ym CHUI. 
  19   Added new  RPC “PSB G ETSETWP” t o table an d included  RPC “PSB  GETINJECTI ONSITE” fr om previou s patch.
  20   (D. Connol ly, PM; E.  Phelps, R . Walters,  Tech Writ ers)12/201 3i-ii, 9,  10, 10a-10 b,  14,
  21   18aPSB*3*7 0Added “Do cumenting  Backlog PR Ns” to Man ager’s Men u. Added n ote that M issed Medi cations, W ard Admini stration T imes, and  Due List B CMA CHUI r eports are  Inpatient , only.  A dded PSB N O WITNESS  Security K ey. Missin g Dose Req uest optio n removed  from CHUI  menus. Add ed “VHIC 4 .0 Card Ba r Code Sca nning Supp ort” to Ex ternal Rel ations sec tion.
  22   (R. Santos , DM; B. T homas, Tec h Writer)0 1/2011i-ii , 6, 7, 10 , 15, 
  23   B-2, B-4
  24   PSB*3*42Ad ded note a nd list of  BCMA Repo rts that w ere added  to GUI onl y. 
  25   Added defi nition of  data field  change fo r Indian H ealth Serv ice.
  26   Added Indi an Health  Service te rms to Glo ssary.
  27    (R. Singe r, DM; B.  Thomas, Te ch Writer) 10/2009i-i i, 7, 9, 1 7PSB*3*47A dded PSBPX FL and PSB PXLP to th e list of  installed  routines.   Add Immun izations D ocumentati on by BCMA  Nightly T ask [PSB P X BCMA2PCE  TASK] opt ion to the  Manager [ PSB MGR] m enu.  Adde d Patient  Care Encou nter to th e External  Relations hips secti on.
  28   (R. Singer , DM; D. D ertien/R.  Silverman,  Tech Writ er)01/2009 i-ii, iv,  6-7,
  29   13-14,
  30   18-19, 21P SB*3*28- U pdate Tabl e of Conte nts to inc lude Remot e Procedur e Calls. ( p. iv)
  31   - Increase d the tota l for the  BCMA V .3. 0 routines  to 85 and  files to  6. (p.6-7)
  32   - Updated  the files  and “BCMA  V.3.0 Rout ines Insta lled onto  VistA Serv er” Exampl e. (p.7)
  33   - Updated  the Mail G roup Types  in BCMA V .3.0 to in clude scan ning
  34   failures.  (p. 13)
  35   - Updated  Security K eys to inc lude PSB U NABLE TO S CAN. (p. 1 4)
  36   - Added li st of Remo te Procedu re Calls ( RPCs). (p.  18)
  37   -Added new  Glossary  entry for  LIMITED AC CESS BCMA.  (p. 19)
  38   - Added ne w Glossary  entry for  PSB UNABL E TO SCAN.  (p. 21)
  39   (R. Singer , PM; R. T homas, Tec h Writer)0 3/20086-7,  9-10,
  40   C-1, C-2,
  41   C-4, C-5,
  42   C-7, C-9PS B*3*2Descr iption of  [PSBO BZ]  functional ity added,  code stri ngs update d (p. C-1. )
  43   - Updated  Intermec P rinter Tea m Type Cod es Informa tion, Inte rmec         Barcode  Label Fiel d Position  Map, Inte rmec print er Sample  Terminal T ype File c ode descri ptions upd ated (pp.  C-4, C-5,  C-7.)
  44   - Barcode  samples up dated – re ferences t o “Dosage”  changed t o “Dose” a nd space b etween col on and dos e measurem ent delete d (p. C-9. )
  45   (E. Willia mson, PM;  G. O’Conno r, Tech Wr iter)09/20 076-7PSB*3 *32– Incre ased the t otal for t he BCMA V.  3.0. rout ines to 68 . (p.6)
  46   – Updated  the “BCMA  V. 3.0 Rou tines Inst alled onto  VistA Ser ver” examp le to incl ude the fo llowing ro utine: PSB O XA. (p.  7)
  47   (R. Singer , PM; E. P helps, Tec h Writer)0 8/20066-7,  
  48   9, 13PSB*3 *13– Incre ased the t otal for t he BCMA V.  3.0. rout ines to 68 . (p.6)
  49   – Updated  the “BCMA  V. 3.0 Rou tines Inst alled onto  VistA Ser ver” examp le to incl ude the fo llowing ro utine: PSB O XA. (p.  7)
  50   – Updated  Manager Me nu [PSB MG R] options  list to i nclude Mis sing Dose  Followup ( correction ) and Unkn own Action  Status Re port (new  with this  patch). (p . 9)
  51   – Added de scription  of the “Un known Acti ons” mail  group para meter. (p.  13)
  52   (R. Singer , PM; M. N ewman, Tec h Writer)0 8/2006iv, 
  53   6,
  54   C1-C10PSB* 3*2Note: T he functio nality lis ted below  will be ac tivated wi th the rel ease of PS B*3*2.
  55   – Updated  Table of C ontents to  include n ew Appendi x C. (p. i v)
  56   – Added re ference to  new Unit  Dose label  printing  functional ity and Ap pendix C.  (p. 6)
  57   – Added Ap pendix C:  Interfacin g with the  Bar Code  Label Prin ter. (p. C 1-C10)
  58   (R. Singer , PM; M. N ewman, Tec h Writer)1 2/20056-7P SB*3*16– I ncreased t he total f or the BCM A V. 3.0.  routines t o 67. (p.6 )
  59   – Updated  the “BCMA  V. 3.0 Rou tines Inst alled onto  VistA Ser ver” examp le to incl ude the fo llowing ro utines: PS BCSUTL, PS BCSUTX, PS BCSUTY. (p . 7)
  60   (R. Singer , PM; M. N ewman, Tec h Writer)0 1/20056-7,
  61   14,
  62   20-21PSB*3 *4– Increa sed the to tal for th e BCMA V.  3.0. routi nes to 64.  (p.6)
  63   – Updated  the “BCMA  V. 3.0 Rou tines Inst alled on t o VistA Se rver” exam ple to inc lude the P SBOPF rout ine. (p. 7 ).
  64   – Added de scription  for new PS B READ ONL Y security  key. (p.1 4)
  65   – Added ne w Glossary  entries f or PSB REA D ONLY and  Read-Only  BCMA. (p.  20-21)
  66   (R. Singer , PM; M. N ewman, Tec h Writer)1 0/20046-7
  67   PSB*3*3– I ncreased t he total f or the BCM A V. 3.0 r outines to  63. (p. 6 )
  68   – Updated  the “BCMA  V. 3.0 Rou tines Inst alled on t o VistA Se rver” exam ple to ref lect the i nclusion o f routines  PSBML2, P SBML3, and  PSBMLLKU  to the Vis tA Server.  (p. 7)
  69   (R. Singer , PM; M. N ewman, Tec h Writer)0 2/2004Orig inal Relea sed BCMA V . 3.0 Tech nical Manu al/Securit y Guide
  70   (R. Singer , PM; M. P ospisil, T ech Writer )Table of  Contents
  71   1BCMA V. 3 .0 and Thi s Guide
  72  
  73  
  74   1Benefits  of BCMA V.  3.0
  75  
  76  
  77   1Benefits  of This Gu ide
  78  
  79  
  80   1Our Targe t Audience
  81  
  82  
  83   2Other Sou rces of In formation
  84  
  85  
  86   2Backgroun d/Technica l Informat ion
  87  
  88  
  89   2This Manu al and Rel ated Docum entation
  90  
  91  
  92   2Conventio ns Used in  This Guid e
  93  
  94  
  95   3Obtaining  On-line H elp
  96  
  97  
  98   3Locating  Detailed L istings
  99  
  100  
  101   3Routines
  102  
  103  
  104   3Data Dict ionaries
  105  
  106  
  107   5Implement ation and  Maintenanc e
  108  
  109  
  110   5Minimum R equired Pa ckages
  111  
  112  
  113   5Installat ion Time E stimates
  114  
  115  
  116   6Resource  Requiremen ts
  117  
  118  
  119   6Response  Time Monit or
  120  
  121  
  122   6Laptops a nd Bar Cod e Scanners
  123  
  124  
  125   6Printers
  126  
  127  
  128   6Unit Dose  Label Pri nter Devic es
  129  
  130  
  131   6IV Label  Printer De vices
  132  
  133  
  134   7Files Req uired to R un BCMA V.  3.0
  135  
  136  
  137   7Routines  Installed
  138  
  139  
  140   7Routine M apping
  141  
  142  
  143   8Exported  Options
  144  
  145  
  146   8BCMA CHUI  Menus
  147  
  148  
  149   8Manager M enu [PSB M GR]
  150  
  151  
  152   9Medicatio n Administ ration Men u Pharmacy  [PSB PHAR MACY]
  153  
  154  
  155   9Nursing M edication  Administra tion Menu  [PSB NURSE ]
  156  
  157  
  158   12Archivin g and Purg ing
  159  
  160  
  161   12Archive  and Purge  Capabiliti es
  162  
  163  
  164   14Security  Features
  165  
  166  
  167   14Defining  Mail Grou ps in BCMA
  168  
  169  
  170   14Creating  Mail Grou ps for BCM A V. 3.0
  171  
  172  
  173   14Mail Gro up Types i n BCMA V.  3.0
  174  
  175  
  176   15Assignin g Menus to  Users
  177  
  178  
  179   15CHUI Ver sion
  180  
  181  
  182   15GUI Vers ion
  183  
  184  
  185   15Allocati ng Securit y Keys to  Users
  186  
  187  
  188   15Establis hing Elect ronic Sign ature Code s
  189  
  190  
  191   16Developi ng a Conti ngency Pla n
  192  
  193  
  194   18Internal  and Exter nal Relati ons
  195  
  196  
  197   18Internal  Relations
  198  
  199  
  200   18Options
  201  
  202  
  203   18Package- Wide Varia bles
  204  
  205  
  206   18Template s
  207  
  208  
  209   18External  Relations
  210  
  211  
  212   19Callable  Routines,  Entry Poi nts, and V ariables
  213  
  214  
  215   19Database  Integrati on Agreeme nts (DBIAs )
  216  
  217  
  218   19Remote P rocedure C alls (RPCs )
  219  
  220  
  221   20VHIC 4.0  Card Bar  Code Scann ing Suppor t
  222  
  223  
  224   22Glossary
  225  
  226  
  227   22Learning  BCMA V. 3 .0 Lingo
  228  
  229  
  230   1Appendix  A: Process ing of Sch edule Info rmation
  231  
  232  
  233   1How BCMA  Processes  Schedule I nformation
  234  
  235  
  236   1Steps for  Processin g Schedule  Informati on
  237  
  238  
  239   4Examples  of Odd Sch edules
  240  
  241  
  242   4Examples  of Schedul es That Ar e Not Odd  Schedules
  243  
  244  
  245   1Appendix  B: HL7 Mes saging for  BCMA
  246  
  247  
  248   1Sample HL 7 Data Fie lds Broadc ast to BCM A Subscrib ers
  249  
  250  
  251   4Definitio ns of Data  Fields Un der FIELD  NAME Colum n
  252  
  253  
  254   8Sample HL 7 Data Fie lds Passed  in Each T rigger Eve nt
  255  
  256  
  257   1Appendix  C: Interfa cing with  the Bar Co de Label P rinter
  258  
  259  
  260   1Introduct ion
  261  
  262  
  263   1Hardware  Setup
  264  
  265  
  266   1Software  Setup
  267  
  268  
  269   2Printer C ontrol Cod es
  270  
  271  
  272   2Control C ode Set Up
  273  
  274  
  275   6Example T erminal Ty pe Files
  276  
  277  
  278   8Dot Matri x and Lase r Printers
  279  
  280  
  281   9Printed B ar Code Un it Dose La bel Sample
  282  
  283  
  284   10JCAHO St andard for  Medicatio n Labeling *
  285  
  286  
  287  
  288  
  289   BCMA V. 3. 0 and This  Guide
  290   Benefits o f BCMA
  291   V. 3.0The  Bar Code M edication  Administra tion (BCMA ) V. 3.0 s oftware in cludes new  routines  and files,  Phase Rel ease chang es, and ma intenance  fixes. Thi s version  also inclu des enhanc ements, wh ich are a  direct res ult of fee dback from  the BCMA  Workgroup  and our ma ny end use rs.
  292   The patch  descriptio n for BCMA  V. 2.0 in cludes mor e detailed  informati on about t he mainten ance fixes  and enhan cements fo r Phase Re leases I t hrough IV,  which wer e provided  in patche s PSB*2*20 , *24, *31 , and *36.
  293   BCMA softw are is des igned to i mprove the  accuracy  of the med ication ad ministrati on process . By autom ating this  process,  Department  of Vetera ns Affairs  Medical C enters (VA MCs) can e xpect enha nced patie nt safety  and patien t care.
  294   The electr onic infor mation tha t BCMA V.  3.0 provid es clinici ans improv es their a bility to  administer  medicatio ns safely  and effect ively to p atients on  wards dur ing their  medication  passes. I t also hel ps to impr ove the da ily commun ication th at occurs  between Nu rsing and  Pharmacy s taffs.
  295   Benefits o f This Gui deThis gui de will he lp you dis cover the  many techn ical and s ecurity as pects of B CMA V. 3.0 . It descr ibes imple mentation  and mainte nance feat ures; inte rfaces, va riables, a nd relatio nships; an d security  managemen t. 
  296   Our Target  Audience
  297   We have de veloped th is guide f or members  of the Au tomated Da ta Process ing (ADP)  group and  the Inform ation Reso urces Mana gement (IR M) group w ho are res ponsible f or maintai ning and s upporting  this packa ge.
  298   We assume  that indiv iduals wit hin these  groups hav e the foll owing expe rience or  skills.
  299   Experience d with oth er Veteran s Health I nformation  Systems a nd Technol ogy Archit ecture (Vi stA) softw are
  300   Have worke d with or  will work  with an Ap plications  Package C oordinator  (ADPAC) o r Clinical  Applicati ons Coordi nator (CAC ) familiar  with the  medication  administr ation proc ess in a V AMC
  301   BCMA V. 3. 0 and This  Guide
  302   Other Sour ces of Inf ormationRe fer to the  Web sites  listed be low when y ou want to  receive m ore backgr ound and t echnical i nformation  about BCM A V. 3.0,  and to dow nload this  manual an d related  documentat ion.
  303   Background /Technical  Informati on
  304   From your  Intranet,  enter http :// DNS        . DNS     /bcma in t he Address  field to  access the  BCMA Main  Web page.
  305   This Manua l and Rela ted Docume ntation
  306   From your  Intranet,  enter http ://www. DNS     /vdl in th e Address  field to a ccess this  manual, a nd those l isted belo w, from th e VistA Do cumentatio n Library  (VDL).
  307   Installati on Guide
  308   GUI User M anual
  309   Nursing CH UI User Ma nual
  310   Pharmacy C HUI User M anual
  311   Manager’s  User Manua l
  312   Convention s Used in  This Guide Before ins talling BC MA V. 3.0,  review th is section  to learn  the many c onventions  used thro ughout thi s guide. 
  313   Keyboard R esponses:  Keys provi ded in bol dface, wit hin the co py, help y ou quickly  identify  what to pr ess on you r keyboard  to perfor m an actio n. For exa mple, when  you see e nter in th e copy, pr ess this k ey on your  keyboard.
  314   Mouse Resp onses: But tons provi ded in bol dface, wit hin the st eps, indic ate what y ou should  click on y our comput er screen  using the  mouse. For  example,  when you s ee next, y es/no, or  ok in the  steps, cli ck the app ropriate b utton on y our screen
  315   Screen Cap tures: Pro vide “shad ed” exampl es of what  you will  see on you r computer  screen, a nd possibl e user res ponses.
  316   Notes: Pro vided with in the ste ps, descri be excepti ons or spe cial cases  about the  informati on present ed. They r eflect the  experienc e of our S taff, Deve lopers, an d Testers.
  317   Tips: Loca ted in the  left marg in, these  helpful hi nts are de signed to  help you w ork more e fficiently  with BCMA  V. 3.0.
  318   Menu Optio ns: Provid ed in ital ics. For e xample, Yo u may esta blish Elec tronic Sig natures Co des using  the Kernel  Electroni c Signatur e code Edi t [XUSESIG ] option.
  319   BCMA V. 3. 0 and This  Guide
  320   Obtaining  On-line He lpOn-line  help is de signed rig ht into th e Graphica l User Int erface (GU I) and Cha racter-bas ed User In terface (C HUI) versi ons of BCM A V. 3.0,  making it  quick and  easy for y ou to get  answers to  your ques tions. Her e’s how to  access he lp in both  versions  of BCMA V.  3.0:
  321   GUI BCMA:  Provides c ontext-sen sitive, on -line help  and the H elp menu. 
  322   Context-Se nsitive He lp: Place  your “focu s” on a fe ature, but ton, or Ta b on the B CMA Virtua l Due List  (VDL) usi ng the tab  key, and  then press  f1 to rec eive help  specific t o that are a of the V DL. In the  case of a  command,  first high light it i n the Menu  Bar or Ri ght Click  drop-down  menu, and  then
  323   press f1.
  324   Help Menu:  Open the  Help menu,  and then  choose the  Contents  and Index  command to  receive h elp for ev ery featur e in GUI B CMA V. 3.0
  325   CHUI BCMA:  Lets you  enter up t o two ques tion marks  at any pr ompt to re ceive on-l ine help. 
  326   One Questi on Mark: P rovides a  brief stat ement rela ted to the  prompt. 
  327   Two Questi on Marks:  Displays m ore detail ed informa tion about  the promp t, plus an y hidden a ctions. 
  328   Locating D etailed Li stingsYou  can obtain  and print  listings  about BCMA  V. 3.0 ro utines, an d Data Dic tionaries  using the  informatio n provided  below.
  329   Routines
  330   Use the Ke rnel routi ne XINDEX  to produce  detailed  listings o f routines . Use the  Kernel Fir st Line Ro utine Prin t [XU FIRS T LINE PRI NT] option  to print  a list con taining th e first li ne of ever y PSB rout ine.
  331   Data Dicti onaries
  332   You can us e the VA F ileMan Lis t File Att ributes [D ILIST] opt ion, under  the Data  Dictionary  Utilities  [DI DDU]  option, to  print the  Dictionar ies.
  333   Implementa tion and M aintenance
  334   Minimum Re quired Pac kages
  335   Before ins talling BC MA V. 3.0,  make sure  that your  system in cludes the  following  Departmen t of Veter ans Affair s (VA) sof tware pack ages and v ersions (t hose liste d or highe r). 
  336   Example: M inimum Req uired Pack ages and V ersions
  337   PackageMin imum Versi on NeededI npatient M edications 5.0Kernel8 .0MailMan8 .0Nursing4 .0Order En try/Result s Reportin g3.0Pharma cy Data Ma nagement1. 0RPC Broke r (32-bit) 1.1Toolkit 7.3VA File Man22.0Vit als/Measur ements5.0I nstallatio n Time Est imates
  338   On average , it takes  approxima tely two m inutes to  install BC MA
  339   V. 3.0. Th is estimat e was prov ided by a  few of our  BCMA V. 3 .0 Beta Te st sites.  Actual tim es may var y, dependi ng on how  your site  is using i ts system  resources.
  340   Suggested  time to in stall: non -peak requ irement ho urs. Durin g the inst all proces s, PC Clie nt users s hould not  be accessi ng the Cli ent Softwa re.
  341   Implementa tion and M aintenance
  342  
  343   Resource R equirement sThis sect ion summar izes the ( approximat e) number  of resourc es require d to insta ll BCMA V.  3.0.
  344   Routines
  345  
  346   93
  347   Globals
  348  
  349   1 (^PSB)
  350   Files
  351  
  352   6 (53.66-5 3.79)
  353   ^PSB Size
  354  
  355   Unit Dose  = 300 x #  of Medicat ions
  356   (in bytes)
  357  
  358   Administer ed
  359  
  360  
  361   IV = 2100  x # of IV  Bags
  362  
  363  
  364   Administer ed
  365   FTEE Suppo rt
  366  
  367   .2
  368   FTEE Maint enance
  369  
  370   .2
  371   Response T ime Monito r
  372   BCMA V. 3. 0 does not  include R esponse Ti me Monitor  hooks.
  373   Laptops an d Bar Code  Scanners
  374   The approx imate requ irements f or laptops  and bar c ode scanne rs depend  on the num ber of Inp atient are as at your  site that  use BCMA 
  375   V. 3.0 for  administe ring activ e medicati on orders.  The BCMA  Developmen t Team rec ommends th at your si te have a  minimum of  three lap tops and t hree scann ers for ea ch ward.
  376   Printers
  377   Your site  should pro vide print ers for cr eating pat ient wrist bands and  medication  bar code  labels, an d for hand ling Missi ng Dose Re quests sen t from BCM A V. 3.0 t o the Phar macy.
  378   Unit Dose  Label Prin ter Device s
  379   BCMA V. 3. 0 includes  the Label  Print [PS BO BL] opt ion for pr inting ind ividual or  batch Uni t Dose bar  code labe ls. This o ption allo ws sites t he flexibi lity to us e any prin ter that h as bar cod e printing  capabilit ies to pro duce BCMA  bar code l abels. Rou tine PSBOB L uses sit e-specific  printers  or termina ls to prod uce labels . See Appe ndix C: “I nterfacing  with the  Bar Code L abel Print er” for de tailed set up informa tion. 
  380   IV Label P rinter Dev ices
  381   Inpatient  Medication s V. 5.0 p rovides a  menu optio n for prin ting indiv idual or b atch IV ba r code lab els. See t he section  “Interfac ing with t he Bar Cod e Label Pr inter” in  the Inpati ent Medica tions V. 5 .0 Technic al Manual/ Security G uide for d etailed se tup inform ation.Impl ementation  and Maint enance
  382   Files Requ ired to Ru n BCMA V.  3.0BCMA V.  3.0 uses  the follow ing files  installed  on the Vis tA Server.  “Journali ng” is rec ommended.
  383   ^PSB (53.6 6,
  384   BCMA IV Pa rameters
  385   ^PSB (53.6 8,
  386   BCMA Missi ng Dose Re quest
  387   ^PSB (53.6 9,
  388   BCMA Repor t Request
  389   ^PSB (53.7 7,
  390   BCMA Unabl e to Scan  Log
  391   ^PSB (53.7 8,
  392   BCMA Medic ation Vari ance Log
  393   ^PSB (53.7 9,
  394   BCMA Medic ation Log
  395   Note: You  can learn  more about  these fil es by gene rating a l ist with f ile attrib utes using  VA FileMa n.Routines  Installed Review the  listing b elow to le arn the ro utines ins talled on  your site’ s VistA Se rver durin g the inst allation o f BCMA V.  3.0. The f irst line  of each ro utine brie fly descri bes its ge neral func tion.
  396   Note: You  can use th e Kernel F irst Line  Routine Pr int [XU FI RST LINE P RINT] opti on to prin t a list c ontaining  the first  line of ea ch PSB rou tine.
  397   Routine Ma pping
  398   At this ti me, we do  not offer  any recomm endations  for routin e mapping.  However,  if you cho ose to map  the BCMA  V. 3.0 pac kage routi nes, you w ill need t o bring yo ur system  down, and  then resta rt it to l oad the ne w routines  into memo ry.  Examp le: BCMA V . 3.0 Rout ines Insta lled onto  VistA Serv er
  399   PSB3P103PS BALLPSBAPI PMPSBCHIVH PSBCHKIVPS BCSUTLPSBC SUTXPSBCSU TYPSBINJEC PSBMDPSBML PSBML1PSBM L2PSBML3PS BMLENPSBML EN1PSBMLHS PSBMLLKUPS BMLTSPSBML UPSBMLVALP SBMMRBPSBO PSBO1PSBOA LPSBOBLPSB OBLUPSBOBZ PSBOCEPSBO CE1PSBOCIP SBOCI1PSBO CMPSBOCM1P SBOCPPSBOC P1PSBODLPS BODL1PSBOD OPSBOHDRPS BOHDR1PSBO IVPSBOIV1P SBOMDPSBOM HPSBOMH1PS BOMH2PSBOM H3PSBOMLPS BOMMPSBOMM 2PSBOMTPSB OMT1PSBOMV PSBOPEPSBO PFPSBOPIPS BOPMPSBOPM 1PSBORTPSB OSFPSBOSTP SBOVTPSBOW APSBOXAPSB PARPSBPARI VPSBPOIVPS BPRNPSBPRN DPSBPXFLPS BPXLPPSBRP CPSBRPC1PS BRPC2PSBRP C3PSBRPCMO PSBRPCXMPS BSAGGPSBSV HL7PSBUTLP SBVARPSBVD LIVPSBVDLP APSBVDLPBP SBVDLRMPSB VDLTBPSBVD LU1PSBVDLU 2PSBVDLU3P SBVDLUDPSB VDLVLPSBVI TFLPSBVPRP SBVTPSBVT1 PSBXMRGExp orted Opti ons
  400   BCMA CHUI  MenusBCMA  V. 3.0 exp orts three  main menu s. They in clude thos e listed b elow, in t he Charact er-based U ser Interf ace (CHUI)  version o f BCMA V.  3.0. The o ptions for  each menu  are liste d in this  section.
  401   Manager Me nu: [PSB M GR] is ass igned to m anagers
  402   Pharmacist  Menu: [PS B PHARMACY ] is assig ned to all  inpatient  Pharmacis ts
  403   Nurse Menu : [PSB NUR SE] is ass igned to a ll clinica ns and oth er personn el who adm inister ac tive medic ation orde rs
  404   Manager Me nu [PSB MG R]
  405   This menu  includes t he followi ng options :
  406   Documentin g Backlog  PRNs
  407   Drug File  Inquiry 
  408   Immunizati ons Docume ntation by  BCMA Nigh tly Task
  409   Medication  Administr ation Menu  Nursing
  410   Medication  Administr ation Log  Report
  411   Missed Med ications R eport (INP ATIENT ONL Y)
  412   Ward Admin istration  Times Repo rt (INPATI ENT ONLY)
  413   Due List R eport (INP ATIENT ONL Y)
  414   PRN Effect iveness Li st Report
  415   Enter PRN  Effectiven ess
  416   Manual Med ication En try
  417   Medication  Administr ation Hist ory (MAH)  Report
  418   Medication  Variance  Log
  419   Drug File  Inquiry
  420   Medication  Administr ation Menu  Pharmacy
  421   Medication  Administr ation Log  Report
  422   Missed Med ications R eport (INP ATIENT ONL Y)
  423   Due List R eport (INP ATIENT ONL Y)
  424   Medication  Administr ation Hist ory (MAH)  Report
  425   Missing Do se Followu p
  426   Missing Do se Report
  427   Label Prin
  428   Drug File  Inquiry
  429   Barcode La bel Print
  430   BCMA Drug  IEN Synony m Check
  431   Report for  Respirato ry Therapy  Medicatio ns
  432   Missing Do se Followu p
  433   Reset User  Parameter s
  434   Trouble Sh oot Med Lo g
  435   Unknown Ac tion Statu s Report
  436   Exported O ptions
  437   BCMA CHUI  Menus (con t.)Medicat ion Admini stration M enu Pharma cy
  438  
  439   [PSB PHARM ACY]
  440   This menu  includes t he followi ng options :
  441   Medication  Administr ation Log  Report
  442   Missed Med ications R eport (INP ATIENT ONL Y)
  443   Due List R eport (INP ATIENT ONL Y)
  444   Medication  Administr ation Hist ory (MAH)  Report
  445   Missing Do se Followu p
  446   Missing Do se Report
  447   Label Prin t
  448   Drug File  Inquiry
  449   Barcode La bel Print
  450   BCMA Drug  IEN Synony m Check
  451   Report for  Respirato ry Therapy  Medicatio ns
  452   Nursing Me dication A dministrat ion Menu
  453   [PSB NURSE ]
  454   This menu  includes t he followi ng options :
  455   Medication  Administr ation Log  Report
  456   Missed Med ications R eport (INP ATIENT ONL Y)
  457   Ward Admin istration  Times Repo rt (INPATI ENT ONLY)
  458   Due List R eport (INP ATIENT ONL Y)
  459   PRN Effect iveness Li st Report
  460   Enter PRN  Effectiven ess
  461   Manual Med ication En try
  462   Medication  Administr ation Hist ory (MAH)  Report
  463   Medication  Variance  Log
  464   Drug File  Inquiry
  465   Note: The  Missed Med ications,  Ward Admin istration  Times, and  Due List  BCMA CHUI  reports wi ll only in clude Inpa tient orde rs in the  report.  T he menus c ontaining  these opti ons will b e updated  to include  “(INPATIE NT ONLY)”  in the rep ort label/ descriptio n.  To run  these rep orts for C linic orde rs and upd ated repor t selectio n options,  the repor ts must be  generated  in the BC MA GUI.
  466   Note: The  following  reports ha ve been ad ded to BCM A and are  available  via GUI on ly, but ha ve not bee n added to  the CHUI  menus.
  467   Cover Shee t Reports
  468   Medication  Overview
  469   PRN Overvi ew
  470   IV Overvie wExported  Options
  471   BCMA CHUI  Menus (con t.)Expired /DC’d/Expi ring Order s
  472   IV Bag Sta tus Report
  473   Medication  Therapy R eport
  474   Unable to  Scan Detai led Report
  475   Unable to  Scan Summa ry Report
  476   Archiving  and Purgin g
  477   Archive an d Purge Ca pabilities BCMA V. 3. 0 stores d etailed in formation  about each  inpatient  at your V AMC, inclu ding medic ations adm inistered  to them an d the PRN  Effectiven ess (when  applicable ).
  478   Average Un it Dose Ad ministrati on: Requir es about 3 00 bytes o f disk spa ce
  479   Average IV  Administr ation: Req uires abou t 2100 byt es
  480   of disk sp ace
  481   Note: Alth ough archi ve and pur ge capabil ities are  not curren tly availa ble in BCM A V. 3.0,  when they  are, they  will be co nsistent w ith the Co mputerized  Patient R ecord Syst em (CPRS)  package. B CMA 
  482   V. 3.0 wil l offer th is feature  once it i s made ava ilable in  CPRS.
  483   Security F eatures
  484   Defining M ail Groups  in BCMAIn  BCMA V. 3 .0, you ca n define t wo “Mail G roups” for  notifying  Pharmacy,  IRM, and  other inte rnal staff  about err ors and Mi ssing Dose  Requests.  This sect ion descri bes how yo u can crea te mail gr oups, and  the purpos e of each  group.
  485   Creating M ail Groups  for BCMA  V. 3.0
  486   Creating m ail groups  for BCMA  V. 3.0 inv olves usin g the Vist A Mail Gro up Enter/E dit [XMUSE R] option  to set the  TYPE fiel d to PUBLI C. Once th is task is  accomplis hed, you c an then us e the Para meters Tab  of the GU I BCMA Sit e Paramete rs applica tion to de fine the m ail groups  that you  created.
  487   Mail Group  Types in  BCMA V. 3. 0
  488   This secti on describ es the mai l groups t hat you ca n define u sing the P arameters  Tab of the  GUI BCMA  Site Param eters appl ication.
  489   Due List E rror: Gene rates an E -mail mess age for an y medicati on order t hat BCMA V . 3.0 cann ot resolve  for the B CMA VDL pl acement, a nd sends i t to the m ail group  members. A n example  might incl ude no adm inistratio n times en tered for  a Continuo us order.
  490   Missing Do se Notific ation: Gen erates an  E-mail mes sage for a ny Missing  Dose Requ est entere d using th e BCMA
  491   V. 3.0 GUI  menu opti on. The E- mail is se nt to all  members of  the mail  group, spe cifically  Pharmacy,  as a “fail  safe” eve n if the d esignated  Missing Do se printer  is not fu nctioning.
  492   Unknown Ac tions: Thi s field ge nerates an  E-mail me ssage for  any admini stration w ith an “Un known” sta tus while  processing  administr ations to  display on  the VDL.
  493   Unable to  Scan: Gene rates an E -mail mess age to ale rt the mai l group wh en a user  creates a  scanning f ailure ent ry, and to  assist in  researchi ng the rea sons for a  scanning  failure. 
  494   Security F eatures
  495   Assigning  Menus
  496   to UsersUs e this sec tion to as sign menus  to BCMA V . 3.0 CHUI  and GUI u sers, if t hey have n ot already  been assi gned.
  497   CHUI Versi on
  498   Refer to t his sectio n for BCMA  V. 3.0 CH UI menu as signments.
  499   PSB MGR: a ssign to a  manager
  500   PSB PHARMA CY: assign  to all In patient Ph armacists
  501   PSB NURSE:  assign to  all clini cians and  other pers onnel who  administer  active me dication o rders
  502   GUI Versio n
  503   Refer to t his sectio n for BCMA  V. 3.0 GU I menu ass ignments.
  504   PSB GUI CO NTEXT – US ER: assign  to all cl inicians a nd other p ersonnel w ho adminis ter active  medicatio n orders
  505   Allocating  Security  Keys to Us ersRefer t o this sec tion to al locate the  following  security  keys to ap propriate  site perso nnel.
  506   PSB MANAGE R: designa tes the ho lder as a  manager
  507   PSB INSTRU CTOR: desi gnates the  holder as  a nursing  instructo r supervis ing studen t nurses
  508   PSB STUDEN T: designa tes the ho lder as a  student nu rse, requi ring that  an instruc tor also s ign on to  BCMA V. 3. 0 at the s ame time
  509   PSB CPRS M ED BUTTON:  designate s the hold er as a nu rse who ca n document  administe red verbal - and phon e-type STA T and NOW  (One-Time)  orders us ing the CP RS Med Ord er Button  on the BCM A VDL
  510   PSB READ O NLY: desig nates the  holder as  a user tha t only has  Read-Only  access to  BCMA. Not e that use rs with Re ad-Only ac cess will  also be re quired to  have the P SB GUI CON TEXT – USE R secondar y menu opt ion.
  511   PSB UNABLE  TO SCAN:  designates  the holde r as a use r that can  run the U nable to S can (Detai led and Su mmary) rep orts.
  512   PSB NO WIT NESS: desi gnates the  holder as  a BCMA us er not aut horized to  witness h igh risk/h igh alert  administra tions, suc h as Unlic ensed Assi stive Pers onnel and  Respirator y Therapis ts.Establi shing Elec tronic Sig nature Cod esYou may  establish  Electronic  Signature s Codes us ing the Ke rnel Elect ronic Sign ature code  Edit [XUS ESIG] opti on.
  513   Note: For  easier acc ess by all  users, th is option  is tied to  the Commo n Options,  under the  User’s To olbox [XUS ERTOOLS] s ubmenu.Sec urity Feat ures
  514   Developing  a Conting ency PlanI n March 20 06, patch  PSB*3*8, t he BCMA Ba ckup Syste m (BCBU),  was reissu ed with si gnificant  enhancemen ts to the  field as a  Class I s olution fo r the BCMA  Contingen cy Plan. T his patch  provides r eal-time b ackup of a ll inpatie nt medicat ion activi ties on a  designated  workstati on. Review  the patch  descripti on to lear n more abo ut the ben efits of t his patch.
  515   Internal a nd Externa l Relation s
  516   Internal R elationsTh is section  describes  options,  package-wi de variabl es, and te mplates wi thin BCMA  V. 3.0.
  517   Options
  518   You can in voke ALL o ptions in  BCMA V. 3. 0 independ ently.
  519   Package-Wi de Variabl es
  520   BCMA V. 3. 0 does not  include p ackage-wid e variable s.
  521   Templates
  522   BCMA V. 3. 0 does not  include a ny templat es for Sor t, Input,  or Print.E xternal Re lationsBCM A V. 3.0 c an only be  run in an  environme nt that al ready has  several ex isting fea tures, suc h as a sta ndard MUMP S operatin g system. 
  523   It also re quires the  following  Departmen t of Veter ans Affair s (VA) sof tware pack ages (vers ions liste d or highe r) — and a ll current  patches.  Otherwise,  BCMA V. 3 .0 will no t be fully  functiona l for your  users.
  524   Inpatient  Medication s
  525  
  526   5.0
  527   Kernel 
  528  
  529  
  530   8.0
  531   MailMan
  532  
  533  
  534   8.0
  535   Nursing
  536  
  537  
  538   4.0
  539   Order Entr y/Results
  540  
  541  
  542   3.0
  543   Reporting
  544   Patient Ca re Encount er
  545   1.0
  546   Pharmacy D ata 
  547  
  548  
  549   1.0
  550   Management
  551   RPC Broker  (32-bit)
  552  
  553  
  554   1.1
  555   Toolkit
  556  
  557  
  558   7.3
  559   VA FileMan
  560  
  561  
  562   22.0
  563   Vitals/Mea surements
  564  
  565   5.0
  566   Internal a nd Externa l Relation s
  567   External R elations 
  568   (cont.)Cal lable Rout ines, Entr y Points,  and Variab les
  569   BCMA V. 3. 0 includes  two calla ble routin es: PSBAPI PM and PSB MLHS. Each  routine i s describe d in this  section, a long with  the entry  points and  variables  informati on for eac h.
  570   PSBAPIPM:  Provides i nformation  to Inpati ent Medica tions
  571   V. 5.0 for  determini ng the sta rt date fo r a renewe d order.
  572   PSBMLHS: P rovides ot her softwa re package s with the  ability t o call the  BCMA Medi cation His tory Repor t. The rep ort lists  medication s, that a  patient ha s received , by order able item.
  573   Database I ntegration  Agreement s (DBIAs)
  574   BCMA subsc ribes to D atabase In tegration  Agreements  (DBIAs) w ith the In patient Me dications,  CPRS, Nur sing, and  Registrati on package s. BCMA V.  3.0 also  offers DBI As for oth er package s to subsc ribe to as  well.
  575   For detail ed informa tion about  these DBI As, log in  to FORUM  and select  the Integ ration Agr eements Me nu [DBA IA  ISC] opti on located  under the  DBA [DBA]  option (D ata Base A dministrat or). Once  in the Int egration A greements  Menu Optio n, select  “Inquire”  and type B CMA at the  “Select I NTEGRATION  REFERENCE S:” prompt .
  576   Remote Pro cedure Cal ls (RPCs)
  577   Following  is a list  of Remote  Procedure  Calls asso ciated wit h BCMA.
  578   1   PSB AL LERGY
  579   2   PSB BA G DETAIL
  580   3   PSB CH ECK IV
  581   4   PSB CH ECK SERVER
  582   5   PSB CO VERSHEET1
  583   6   PSB CP RS ORDER
  584   7   PSB DE VICE
  585   8   PSB FM DATE
  586   9   PSB GE TINJECTION SITE
  587   10   PSB G ETIVPAR
  588   11  PSB GE TORDERTAB
  589   12  PSB GE TPRNS
  590   13  PSB GE TPROVIDER
  591   14  PSB GE TSETWP
  592   15  PSB IN STRUCTOR
  593   16  PSB IV  ORDER HIS TORY
  594   17  PSB LO CK
  595   18  PSB MA IL
  596   19  PSB MA N SCAN FAI LURE
  597   20  PSB MA XDAYS
  598   21  PSB ME D LOG LOOK UP
  599   22  PSB ME DICATION H ISTORY
  600   23  PSB MO B DRUG LIS T
  601   24  PSB NU RS WARDLIS T
  602   25  PSB PA RAMETER
  603   26  PSB PU TIVPAR
  604   27  PSB RE PORT
  605   28  PSB SC ANMED
  606   29  PSB SC ANPT
  607   30  PSB SE RVER CLOCK  VARIANCE
  608   31  PSB SU BMIT MISSI NG DOSE
  609   32  PSB TR ANSACTION
  610   33  PSB US ERLOAD
  611   34  PSB US ERSAVE
  612   35  PSB UT L XSTATUS  SRCH
  613   36  PSB VA LIDATE ESI G
  614   37  PSB VA LIDATE ORD ER
  615   38  PSB VE RSION CHEC K
  616   39  PSB VI TAL MEAS F ILE
  617   40  PSB VI TALS
  618   41 PSB WAR DLIST
  619   Internal a nd Externa l Relation s
  620   External R elations ( cont.)VHIC  4.0 Card  Bar Code S canning Su pport
  621   To incorpo rate looku p of patie nts by sca nning the  bar code o n the new  VIC 4.0 ca rd or a Do D CAC card , a new su pported AP I (RPCVIC^ DPTLK) fro m dependen t patch DG *5.3*857 h as been in corporated  into PSB  SCANPT, wh ich return s a patien t DFN for  lookup in  BCMA.
  622   Glossary
  623   Learning B CMA
  624   V. 3.0 Lin goThe alph abetical l isting, in  this sect ion, is de signed to  familiariz e you with  the many  acronyms a nd terms u sed throug hout this  guide.Exam ple: Alpha betical Li sting of B CMA V. 3.0  Acronyms  and Terms
  625   Acronym/Te rmDefiniti on
  626   ArchiveTo  transfer f iles from  a computer  onto long -term stor age.BCMA C linical Re mindersA m arquee loc ated in th e lower, r ight-hand  corner of  the VDL th at identif ies PRN me dication o rders need ing effect iveness do cumentatio n. The set ting is ba sed on the  “PRN Docu mentation”  site para meter, and  applies t o current  admissions  or the si te paramet er timefra me (whiche ver is gre ater). A m ouse-over  list displ ays when t he pointer  is placed  over the  PRN Effect iveness Ac tivity, or  a full li st is avai lable by d ouble clic king on th e Activity .CHUIChara cter-based  User Inte rface.Clie ntAn archi tecture in  which one  computer  can get in formation  from anoth er. The Cl ient is th e computer  that asks  for acces s to data,  software,  or servic es.CPRSCom puterized  Patient Re cord Syste m. A VistA  software  applicatio n that all ows users  to enter p atient ord ers into d ifferent p ackages fr om a singl e applicat ion. All p ending ord ers that a ppear in t he Unit Do se and IV  packages a re initial ly entered  through t he CPRS pa ckage. Cli nicians, M anagers, Q uality Ass urance Sta ff, and Re searchers  use this i ntegrated  record sys tem.Data D ictionaryA lso called  “DD,” the  dictionar y that con tains file  attribute s.DBIAData base Integ ration Agr eement. A  formal und erstanding  between t wo or more  applicati on package s which de scribes ho w data is  shared or  how packag es interac t. This Ag reement ma intains in formation  between pa ckage Deve lopers, al lowing the  use of in ternal ent ry points  or other p ackage-spe cific feat ures.FileM anThe Vist A database  managemen t system.G UIGraphica l User Int erface. Th e type of  interface  chosen for  BCMA V. 3 .0.IVA med ication gi ven intrav enously (w ithin a ve in) to a p atient fro m an IV ba g. IV type s include  Admixture,  Chemother apy, Hyper al, Piggyb ack, and S yringe.Jou rnalingA r ecord of c hanges mad e in files  and messa ges transm itted. It  is quite u seful when  recoverin g previous  versions  of a file  before upd ates were  made, or t o reconstr uct update s if an up dated file  gets dama ged.LIMITE D ACCESS B CMAA mode  in which B CMA can be  accessed  that provi des medica tion admin istering u sers the a bility to  access pat ient recor ds for non -medicatio n administ ration doc umentation , review a nd reporti ng purpose s without  being at t he patient ’s bedside .Glossary
  627   Learning B CMA
  628   V. 3.0 Lin go (cont.) The alphab etical lis ting, in t his sectio n, is desi gned to fa miliarize  you with t he many ac ronyms and  terms use d througho ut this gu ide.Exampl e: Alphabe tical List ing of BCM A V. 3.0 A cronyms an d Terms
  629   Acronym/Te rmDefiniti on
  630   MAHMedicat ion Admini stration H istory. A  patient re port that  lists a cl inician’s  name and i nitials, a nd the exa ct time th at an acti on was tak en on an o rder (in a  conventio nal MAR fo rmat). Eac h order is  listed al phabetical ly by the  orderable  item. The  date colum n lists th ree asteri sks (***)  if a medic ation was  Discontinu ed.MARMedi cation Adm inistratio n Record.  The tradit ional, han dwritten r ecord used  for notin g when a p atient rec eived a me dication.  BCMA V. 3. 0 replaces  this reco rd with an  MAH.NOW O rderA medi cation ord er given A SAP to a p atient, en tered as a  One-Time  order by P roviders a nd Pharmac ists. This  order typ e displays  for a fix ed length  of time on  the VDL,  as defined  by the or der Start  and Stop D ate/Time.P atient Tra nsfer Noti ficationA  message th at display s when a p atient’s r ecord is o pened or t he Unit Do se or IVP/ IVPB Medic ation Tab  is viewed  for the fi rst time.  This messa ge indicat es that th e patient  has had a  movement t ype (usual ly a trans fer) withi n the site -definable  parameter , and the  last actio n for the  medication  occurred  before the  movement,  but still  within th e defined  timeframe. PRN OrderT he Latin a bbreviatio n for Pro  Re Nata. A  medicatio n dosage g iven to a  patient on  an “as ne eded” basi s.PSB CPRS  MED BUTTO NThe name  of the sec urity “key ” that mus t be assig ned to nur ses who do cument ver bal- and p hone-type  STAT and N OW (One-Ti me) medica tion order s using th e CPRS Med  Order But ton on the  BCMA VDL. PSB INSTRU CTORThe na me of the  security “ key” that  must be as signed to  nursing in structors,  supervisi ng nursing  students,  so they c an access  user optio ns within  BCMA V. 3. 0. PSB MAN AGERThe na me of the  security “ key” that  must be as signed to  managers s o they can  access th e PSB Mana ger option s within B CMA V. 3.0 .PSB READ  ONLYThe na me of the  security “ key” that  must be as signed to  users that  can only  access BCM A in Read- Only mode.  Users who  are assig ned the PS B READ ONL Y security  key will  never be a ble to adm inister me dications  or perform  any actio ns against  a patient ’s medical  record. T he PSB REA D ONLY sec urity key  overrides  all other  BCMA secur ity keys.G lossary
  631   Learning B CMA
  632   V. 3.0 Lin go (cont.) The alphab etical lis ting, in t his sectio n, is desi gned to fa miliarize  you with t he many ac ronyms and  terms use d througho ut this gu ide.Exampl e: Alphabe tical List ing of BCM A V. 3.0 A cronyms an d Terms
  633   Acronym/Te rmDefiniti on
  634   PSB STUDEN TThe name  of the sec urity “key ” that mus t be assig ned to nur sing stude nts, super vised by n ursing ins tructors,  so they ca n access u ser option s within B CMA V. 3.0 . This key  also requ ires that  a nursing  instructor  sign on t o BCMA.PSB  UNABLE TO  SCANThe n ame of the  security  “key” that  must be a ssigned to  allow the  user to r un the Una ble to Sca n (Detaile d and Summ ary) repor ts.PurgeTo  delete a  set of dat a, and all  reference s to the d ata.Read-O nly BCMAA  mode in wh ich BCMA c an be acce ssed that  provides n on-medicat ion admini stering us ers the ab ility to v iew a pati ent’s VDL  and print  reports, w ithout per forming an y actions  against a  patient’s  medical re cord.RPC R emote Proc edure Call . A proced ure stored  on the Vi stA Server , which is  executed  to return  data to th e Client.  RPC Broker A Client/S erver Syst em within  the VA’s V eterans He alth Infor mation Sys tems and T echnology  Architectu re (VistA)  environme nt. It ena bles clien t applicat ions to co mmunicate  and exchan ge data wi th M Serve rs.Securit y KeysUsed  to access  specific  options wi thin BCMA  V. 3.0 tha t are othe rwise “loc ked” witho ut the sec urity key.  Only user s designat ed as “Hol ders” may  access the se options .ServerAn  architectu re in whic h one comp uter can g et informa tion from  another. T he Server,  which can  be anythi ng from a  personal c omputer to  a mainfra me, suppli es the req uested dat a or servi ces to the  Client.ST AT OrderA  medication  order giv en immedia tely to a  patient, e ntered as  a One-Time  order by  Providers  and Pharma cists. Thi s order ty pe display s for a fi xed length  of time o n the VDL,  as define d by the o rder Start  and Stop  Date/Time. VDLVirtual  Due List.  An on-lin e “list” u sed by cli nicians wh en adminis tering act ive medica tion order s (i.e., U nit Dose,  IV Push, I V Piggybac k, and lar ge-volume  IVs) to a  patient. T his is the  Main Scre en in BCMA  V. 3.0. 
  635   Note: This  is called  BCMA VDL  in this gu ide to eli minate con fusion wit h the Vist A Document ation Libr ary (VDL)  also menti oned in th is guide.V istAVetera ns Health  Informatio n Systems  and Techno logy Archi tecture.Wa rd StockUn it Dose an d IV medic ations tha t are “sto cked” on a n ongoing  basis on w ards and p atient car e areas. T hey are pa ckaged in  a ready-to -use form  or compoun ded by the  medicatio n administ rator.ZPLZ ebra Progr amming Lan guage.Appe ndix A: Pr ocessing o f Schedule  Informati on
  636   How BCMA P rocesses S chedule In formationT his sectio n describe s how BCMA  V. 3.0 pr ocesses Sc hedule inf ormation f rom Inpati ent Medica tions V. 5 .0, and ho w it deter mines when  to displa y a Contin uous medic ation orde r on the V DL. Keep i n mind tha t BCMA dis plays medi cation ord ers on the  VDL betwe en the ord er Start a nd Stop Da te and Tim e.
  637   The inform ation prov ided below  defines t erm used i n this sec tion:
  638   Admin Time : The ADMI N TIMES fi eld (#41)  of the UNI T DOSE mul tiple (#62 ) of the P HARMACY PA TIENT file  (#55), an d the ADMI NISTRATION  TIMES fie ld (#.12)  of the IV  multiple ( #100) of t he PHARMAC Y PATIENT  file (#55) .
  639   Frequency:  The FREQU ENCY field  (#42) of  the UNIT D OSE multip le (#62) o f the PHAR MACY PATIE NT file (# 55), and t he SCHEDUL E INTERVAL  field (#. 17) of the  IV multip le (#100)  of the PHA RMACY PATI ENT file ( #55).
  640   Schedule:  The SCHEDU LE field ( #26) of th e UNIT DOS E multiple  (#62) of  the PHARMA CY PATIENT  file (#55 ), and the  SCHEDULE  field (#.0 9) of the  IV multipl e (#100) o f the PHAR MACY PATIE NT file (# 55).
  641   Schedule T ype: The S CHEDULE TY PE field ( #7) of the  UNIT DOSE  multiple  (#62) of t he PHARMAC Y PATIENT  file (#55) . For IV o rders, it  refers to  the pseudo -type dete rmined by  Inpatient  Medication s that is  sent to BC MA.
  642   Steps for  Processing  Schedule  Informatio nThis sect ion descri bes the st eps for pr ocessing s chedule in formation  from Inpat ient Medic ations to  BCMA.
  643   BCMA check s the Inpa tient Medi cations or der for a  Schedule T ype of “Co ntinuous.”  
  644   If a Sched ule Type o ther than  “Continuou s” is list ed, BCMA q uits proce ssing the  order, and  proceeds  to the cor rect proce ssing meth od for tha t order’s  Schedule T ype.
  645   Appendix A : Processi ng of Sche dule Infor mation
  646   Steps for  Processing  Schedule  Informatio n (cont.)B CMA verifi es informa tion provi ded in the  Schedule  of the Inp atient Med ications o rder.
  647   If the Sch edule is b lank, BCMA  quits pro cessing th e order an d sends a  Due List E rror Notif ication me ssage. (No te: A blan k indicate s that no  Schedule w as specifi ed.)
  648   If the Sch edule list s a Day of  the Week  (i.e., MO- WE@1200),  BCMA check s the Admi n Time(s)  for the co rrect two-  or four-d igit forma t (i.e., 1 2-14, 1200 , 1400).
  649   If an Admi n Time is  listed, BC MA display s the orde r on the V DL, on spe cified day s, using t he Admin T ime.
  650   If no Admi n Time is  listed, BC MA quits p rocessing  the order  and sends  a Due List  Error Not ification  message.
  651   If the Sch edule list s an Admin  Time (i.e ., 12-14,  1200, 1400 ), BCMA ch ecks the A dmin Time  in the Inp atient Med ications o rder. 
  652   If the Adm in Time is  blank, BC MA quits p rocessing  the order  and sends  a Due List  Error Not ification  message.
  653   If an Admi n Time is  listed, BC MA verifie s for the  correct tw o- or four -digit for mat (i.e.,  12-14, 12 00, 1400).  If valid,  BCMA disp lays the o rder on th e VDL ever y day usin g the Admi n Time pro vided. If  invalid, B CMA quits  processing  the order  and sends  a Due Lis t Error No tification  message.
  654   BCMA verif ies inform ation prov ided in th e Frequenc y of the I npatient M edications  order. (N ote: The F requency i s the amou nt of time  between m edication  administra tions.)
  655   If the Fre quency is  blank, con tains a le tter other  than “O”  (the lette r), or lis ts a Frequ ency less  than one m inute, BCM A quits pr ocessing t he order a nd sends a  Due List  Error Noti fication m essage. (N ote: A bla nk indicat es that no  Frequency  was speci fied.)
  656   If the Fre quency lis ts “O” (th e letter),  BCMA conv erts the F requency t o 1440 min utes (one  day) and p roceeds to  Step #4.
  657   Appendix A : Processi ng of Sche dule Infor mation
  658   Steps for  Processing  Schedule  Informatio n (cont.)B CMA verifi es whether  the order  contains  an Odd Sch edule by d etermining  that data  in the or der Freque ncy is not  divisible  by 1440 m inutes (on e day), an d that 144 0 minutes  is not div isible by  the data i n the orde r Frequenc y. See the  examples  provided b elow.
  659   If the ord er contain s an Odd S chedule an d times in  the Admin  Time, BCM A quits pr ocessing t he order a nd sends a  Due List  Error Noti fication m essage.
  660   If the ord er contain s an Odd S chedule, b ut no time s in the A dmin Time,  BCMA disp lays the m edication  order on t he VDL usi ng the Fre quency and  order Sta rt Date/Ti me provide d by Inpat ient Medic ations to  calculate  the Admin  Times.
  661   If the ord er does no t contain  an Odd Sch edule and  no times a re listed  in the Adm in Time, B CMA displa ys the med ication or der on the  VDL using  the Frequ ency and o rder Start  Date/Time  provided  by Inpatie nt Medicat ions to ca lculate th e Admin Ti mes.
  662   If the ord er does no t contain  an Odd Sch edule, but  times are  listed in  the Admin  Time, BCM A verifies  the Frequ ency liste d in the o rder. 
  663   If the Fre quency is  less than  1440 minut es (or one  day), BCM A displays  the medic ation orde r on the V DL every d ay, based  on the Adm in Times p rovided in  the order .
  664   If the Fre quency is  greater th an 1440 mi nutes (or  one day),  BCMA uses  the Freque ncy inform ation from  Inpatient  Medicatio ns to dete rmine whic h day to d isplay the  medicatio n order on  the VDL,  based on t he Admin T ime provid ed in the  order.
  665   Appendix A : Processi ng of Sche dule Infor mation
  666   Steps for  Processing  Schedule  Informatio n (cont.)T his sectio n provides  examples  showing Sc hedule Typ es that ar e processe d as Odd S chedules a nd those t hat are no t. 
  667   Note: For  an Odd Sch edule to o ccur, both  statement s for a Sc hedule Typ e must be  False.
  668   Examples o f Odd Sche dules
  669   Schedule T ype: Q5H ( 300 minute s)
  670   300 minute s divided  by 1440 mi nutes = fr action, no t a whole  number = F alse
  671   1440 divid ed by 300  minutes =  4.8 (fract ion, not a  whole num ber) = Fal se
  672   Schedule T ype: Q3XM  (13440 min utes)
  673   13440 minu tes divide d by 1440  minutes =  9.3 (fract ion, not a  whole num ber) = Fal se
  674   1440 divid ed by 1344 0 minutes  = fraction , not a wh ole number  = False
  675   Examples o f Schedule s That Are  Not Odd S chedules
  676   Schedule T ype: Q2H ( 120 minute s)
  677   120 minute s divided  by 1440 mi nutes = 8. 3 (fractio n, not a w hole numbe r) = False
  678   1440 minut es divided  by 120 =  12 (whole  number) =  True
  679   Schedule T ype: QOD ( 2880 minut es)
  680   2880 minut es divided  by 1440 m inutes = 2  (whole nu mber) = Tr ue
  681   1440 minut es divided  by 2880 =  0.5 (frac tion, not  a whole nu mber) = Fa lse
  682   Appendix B : HL7 Mess aging for  BCMA
  683   Sample HL7  Data Fiel ds Broadca st to BCMA  Subscribe rsBCMA inc ludes the  Standards  from the H L7 V. 2.4  (VistA Mes saging) pa ckage. For  more info rmation, r efer to th e VistA Me ssaging an d Interfac e Services  Web site  at: http:/ / DNS        . DNS     /messaging /hl7.
  684   This secti on provide s a list o f sample H ealth Leve l Seven (H L7) data f ields that  BCMA broa dcasts to  BCMA HL7 s ubscribers . Review t he informa tion to le arn the “R AS” messag es created  for the a dministrat ion and/or  update of  a medicat ion order.  The activ ities, whi ch cause t he broadca st of BCMA  HL7 messa ges, are c alled “tri gger event s.” BCMA H L7 trigger  events ar e MEDPASS,  UPDATE ST ATUS, PRN  EFFECTIVEN ESS, and A DD COMMENT .
  685   Note: Ever y message  will not u se every d ata field  and every  segment pr ovided. So me segment s may repe at as nece ssary. Som e segments  may not a ppear in t he exact o rder depic ted below  for all tr igger even ts, but th ey will be  consisten t for each  specific  trigger ev ent.Exampl e: “RAS” M essages Cr eated for  the Admini stration o f a Medica tion Order
  686   SEGSEQFiel d NameExam pleHL7 Typ eMSH1Field  Separator ^string2En coding Cha racters~|\ &string3Se nding Appl icationPSB  HL7 SRVhi erarchic d esignator4 Sending Fa cilityhier archic des ignator5Re ceiving Ap plicationP SB HL7 SUB hierarchic  designato r6Receivin g Facility hierarchic  designato r7D/T of M essage2003 0530075514 -0600HL7 f ormat time stamp (yyy ymmddhhnns s-0600)8Se curitystri ng9Message  TypeRAS~O 17composit e10Message  Control I D5001457st ring11Proc essing IDP processing  type12Ver sion ID2.4 ID13Sequen ce Numbern umeric14Co ntinuation  Pointerst ring15Acce pt Acknowl edgement T ypeALID16A pplication  Acknowled gment Type NEID17Coun try CodeUS AID18Chara cter SetID 19Principa l Language  of Messag e coded el ementAppen dix B: HL7  Messaging  for BCMA
  687   Example: “ RAS” Messa ges Create d for the  Administra tion of a  Medication  Order
  688   (cont.)
  689   SEGSEQFiel d NameExam pleHL7 Typ ePID3Patie nt Identif ier List74 8composite  ID4Altern ate Patien t ID54~~~~ AGEextende d composit e ID5Patie nt NameBCM APATIENT~T WOpatient  name7Date/ Time of Bi rth1949010 1HL7 forma t timestam p (yyyymmd d)8Adminis trative Se xMuser tab le19SSN Nu mber (VA) 
  690   or HRN Num ber (IHS)–  Patient00 0001000 (V A) 
  691   or 123456  (IHS)strin gPV12Patie nt ClassUt able 00043 Patient Lo cation7A G EN MED 724 -A~~~500us er table7A ttending D octorBCMAP ROVIDER~ON Ecomposite  IDORC1Ord er Control XXtable 11 92Placer O rder Numbe r1045~PSB~ 1045~IENen tity ident ifier3Fill er Order N umber13Ven tity ident ifier7Quan tity/Timin g~~~~~~~~~ Cdosage, s cheduled a dministrat ion time,  schedule t ype8Parent ~composite 9D/T of Tr ansaction2 0030530075 514-0600HL 7 format t imestamp ( yyyymmddhh nnss-0600) 10Entered  byBCMANURS E~ONEexten ded compos ite name15 Order Effe ctive D/T2 0030530075 514-0600HL 7 format t imestamp ( yyyymmddhh nnss-0600) 19Action B yBCMANURSE ~ONEextend ed composi te nameRXR 1RouteIVta ble 01622A dministrat ion Site3  INJECTION  SITEtable  0163RXO1Re quested Gi ve Code269 ~FLUOROURA CILcoded e lement2Req uested Giv e Amountnu meric10Req uested Dis pense Code 748V52code d element2 1Requested  Give Rate  Amount~25 0 ml/hrstr ingAppendi x B: HL7 M essaging f or BCMA
  692   Example: “ RAS” Messa ges Create d for the  Administra tion of a  Medication  Order
  693   (cont.)
  694   SEGSEQFiel d NameExam pleHL7 Typ eRXC1RX Co mponent Ty peAtable 0 1662Compon ent Code20 ~5-FLUOURA CILcoded e lement3Com ponent Amo unt5-FLUOU RACILnumer ic4Compone nt Unitsco ded elemen tRXC1RX Co mponent Ty peBtable 0 1662Compon ent Code8~ AMINO ACID  SOLUTION  8.5%coded  element3Co mponent Am ountAMINO  ACID SOLUT ION 8.5%nu meric4Comp onent Unit scoded ele mentRXA1Gi ve Sub-ID  Counter0nu mber2Admin istration  Sub-ID Cou nter1numbe r3Date/Tim e Start of  Administr ation20030 530075514- 0600HL7 fo rmat times tamp (yyyy mmddhhnnss -0600)5Adm inistered  Code20~5-F LUOURACILc oded eleme nt6Adminis tered Amou nt450 MGnu mber7Admin istered Un it9Adminis tration No tescoded e lement18Su bstance/Tr eatment Re fusal Reas on~Elevate d Blood Su garcoded e lement19In dication~c oded eleme nt20Comple tion Statu sCuser tab leNTE2Sour ce of Comm enttable 1 053Comment This is a  comment …f ree text4C omment Typ eBCMANURSE ~ONE~20030 530075514- 0600~Date  Enteredcod ed element
  695   (includes  HL7 format  timestamp  [yyyymmdd hhnnss-060 0])Appendi x B: HL7 M essaging f or BCMA
  696   Definition s of Data  Fields Und er FIELD N AME Column This secti on lists t he definit ions for s ome of the  data fiel ds provide d under th e FIELD NA ME column,  along wit h the loca tion of th e data fie ld. The me ssage head er (i.e.,  the MSH se gment) is  constructe d and supp orted by t he VistA H L7 message  developme nt tool.
  697   Note: The  MSH segmen t field na mes are no t describe d below.
  698   PATIENT ID : Field (# .01) of th e BCMA MED ICATION LO G file (#5 3.79) and  Internal E ntry Numbe r (IEN) po inter to t he PATIENT  file (#2) .
  699   PATIENT NA ME: As ret urned by t he Applica tion Progr am Interfa ce (API) V ADPT.
  700   DATE OF BI RTH: As re turned by  the API VA DPT.
  701   ADMINISTRA TIVE SEX:  As returne d by the A PI VADPT.
  702   SSN NUMBER  (VA) or H RN NUMBER  (IHS): As  returned b y the API  VADPT.
  703   PATIENT LO CATION: Fi eld (#.02)  of the BC MA MEDICAT ION LOG fi le (#53.79 ), which c ontains th e actual r oom-bed an d ward loc ation of t he patient  at the ti me the med ication pa ss occurre d. Also co ntains fie ld (#.03)  of the BCM A MEDICATI ON LOG fil e (#53.79) , which co ntains the  division  number of  the ward t hat the pa tient was  on during  the medica tion pass.
  704   PLACER ORD ER NUMBER:  IEN for t he BCMA ME DICATION L OG file (# 53.79).
  705   FILLER ORD ER NUMBER:  Contains  the ORDER  REFERENCE  NUMBER fie ld (#.11)  of the BCM A MEDICATI ON LOG fil e (#53.79) , which co ntains the  IEN of th e actual m edication  order from  the PHARM ACY PATIEN T file (#5 5)PREVIOUS  ORDER NUM BER as ret urned by t he API PSJ BCMA1.
  706   QUANTITY/T IMING: Con tains the  order dosa ge, schedu le type, a nd schedul ed adminis tration ti me data fr om the BCM A MEDICATI ON LOG fil e (#53.79) , fields # .15, #.12,  and #.13  respective ly. 
  707   PARENT: Co ntains the  PREVIOUS  ORDER NUMB ER as retu rned by th e PSB rout ine PSBVT.
  708   DATE/TIME  OF TRANSAC TION: Cont ains the A CTION DATE /TIME fiel d (#.06) o f the BCMA  MEDICATIO N LOG file  (#53.79),  which con tains the  FileMan da te/time of  the actua l time tha t the acti on was tak en.
  709   Appendix B : HL7 Mess aging for  BCMA
  710   Definition s of Data  Fields Und er FIELD N AME Column  (cont.)Th is section  lists the  definitio ns for som e of the d ata fields  provided  under the  FIELD NAME  column, a long with  the locati on of the  data field .
  711   ENTERED BY : Field (# .05) of th e BCMA MED ICATION LO G file (#5 3.79), whi ch contain s the IEN  pointer to  the NEW P ERSON file  (#200) fo r the user  who enter ed the dat a, along w ith the ac tual name  of that pe rson as re turned by  FileMan.
  712   ORDER EFFE CTIVE DATE /TIME: Pro vides data  from the  ENTERED DA TE/TIME fi eld (#.04)  of the BC MA MEDICAT ION LOG fi le (#53.79 ), which c ontains th e FileMan  date/time  that the a ction was  taken.
  713   ACTION BY:  Field (#. 07) of the  BCMA MEDI CATION LOG  file (#53 .79), whic h contains  the IEN p ointer to  the NEW PE RSON file  (#200) for  the user  who took t he action.  
  714   ROUTE: Con tains MEDI CATION ROU TE data as  returned  by the PSB  routine P SBVT. The  ROUTE data  is requir ed for the  RXR messa ge segment .
  715   ADMINISTRA TION SITE:  Presents  the INJECT ION SITE f ield (#.16 ) of the B CMA MEDICA TION LOG f ile (#53.7 9), which  lists the  injection  site where  the medic ation was  administer ed.
  716   REQUESTED  GIVE CODE:  Presents  the ADMINI STRATION M EDICATION  field (#.0 8) of the  BCMA MEDIC ATION LOG  file (#53. 79), conta ining a po inter to t he ORDERAB LE ITEM fi le (#50.7) , which pr ovides the  medicatio n entered  for the or der, as we ll as the  actual ord erable ite m name as  returned b y FileMan.
  717   REQUESTED  GIVE AMOUN T: Provide s the ORDE R DOSAGE f ield (#.15 ) of the B CMA MEDICA TION LOG f ile (#53.7 9), which  contains t he dosage  from the o riginal me dication o rder.
  718   REQUESTED  DISPENSE C ODE: Prese nts the IV  UNIQUE ID  field (#. 26) of the  BCMA MEDI CATION LOG  file (#53 .79), whic h contains  the uniqu e ID numbe r for an
  719   IV bag.
  720   REQUESTED  GIVE RATE  AMOUNT: Pr esents the  INFUSION  RATE field  (#.35) of  the BCMA  MEDICATION  LOG file  (#53.79),  which cont ains the i nfusion ra te for an
  721   IV bag.
  722   RX COMPONE NT TYPE: C ontains da ta specify ing the “t ype” of it em/compone nt process ed. Within  the HL7 s tandard ta ble, “A” s ignifies a dditive an d “B” sign ifies base .
  723    Appendix  B: HL7 Mes saging for  BCMA
  724   Definition s of Data  Fields Und er FIELD N AME Column  (cont.)Th is section  lists the  definitio ns for som e of the d ata fields  provided  under the  FIELD NAME  column, a long with  the locati on of the  data field .
  725   COMPONENT  CODE: Pres ents the A DMINISTRAT ION MEDICA TION field  (#.08) of  the BCMA  MEDICATION  LOG file  (#53.79),  containing  a pointer  to the OR DERABLE IT EM file (# 50.7), whi ch provide s the medi cation ent ered for t he order,  as well as  the actua l orderabl e item nam e as retur ned by Fil eMan.
  726   COMPONENT  AMOUNT:Pre sents the  DOSES ORDE RED field  (#.02) wit hin the DI SPENSE DRU G multiple  (#.5) wit hin the BC MA MEDICAT ION LOG fi le (#53.79 ), which c ontains th e number o f units.
  727   COMPONENT  UNITS: Con sists of t he UNIT OF  ADMINISTR ATION fiel d (#.04) o f the resp ective fil e multiple  (i.e., DI SPENSE DRU G [#.5], A DDITIVES [ #.6], or S OLUTIONS [ .7]) withi n the BCMA  MEDICATIO N LOG file  (#53.79),  which con tains the  unit(s) fo r the medi cation adm inistered.
  728   GIVE SUB-I D COUNTER:  A require d field wi th a value
  729   of “00.”
  730   ADMINISTRA TION SUB-I D COUNTER:  A require d field wi th a numer ic value.
  731   DATE/TIME  START OF A DMINISTRAT ION: Prese nts the AC TION DATE/ TIME field  (#.06) of  the BCMA  MEDICATION  LOG file  (#53.79),  which cont ains the F ileMan dat e/time tha t the acti on was tak en.
  732   ADMINISTER ED CODE: C omposed of  the ADMIN ISTRATION  MEDICATION  field (#. 08) of the  BCMA MEDI CATION LOG  file (#53 .79), whic h contains  a pointer  to ORDERA BLE ITEM f ile (#50.7 ), which p rovides th e medicati on entered  for the o rder, as w ell as the  actual or derable it em name as  returned  by FileMan .
  733   ADMINISTER ED AMOUNT:  Consists  of the DOS ES GIVEN f ield (#.03 ) of the r espective  file multi ple (i.e.,  DISPENSE  DRUG [#.5] , ADDITIVE S [#.6], o r SOLUTION S [.7]) wi thin the B CMA MEDICA TION LOG f ile (#53.7 9), which  contains t he actual  number of  units admi nistered t o the pati ent.
  734   Appendix B : HL7 Mess aging for  BCMA
  735   Definition s of Data  Fields Und er FIELD N AME Column  (cont.)Th is section  lists the  definitio ns for som e of the d ata fields  provided  under the  FIELD NAME  column, a long with  the locati on of the  data field .
  736   ADMINISTER ED UNIT: U NIT OF ADM INISTRATIO N field (# .04) of th e respecti ve file mu ltiple (i. e., DISPEN SE DRUG [# .5], ADDIT IVES [#.6] , or SOLUT IONS [.7])  within th e BCMA MED ICATION LO G file (#5 3.79), whi ch contain s the unit (s) for th e medicati on adminis tered.
  737   ADMINISTRA TION NOTES : Consists  of the AU DIT LOG fi eld (#.9)  and the AU DIT LOG fi eld (#.01)  of the AU DIT LOG mu ltiple (#. 9) within  the BCMA M EDICATION  LOG file ( #53.79).
  738   SUBSTANCE/ TREATMENT  REFUSAL RE ASON: Fiel d (#.21) o f the BCMA  MEDICATIO N LOG file  (#53.79),  which con tains the  PRN reason  for admin istering a  PRN medic ation.
  739   INDICATION : Consists  of the OR DER ADMINI STRATION V ARIANCE fi eld (#.14) , of the B CMA MEDICA TION LOG f ile (#53.7 9), which  if a Conti nuous medi cation ord er, will c ontain the  minutes e arly (<1)  or late (> 1) that th e medicati on was adm inistered.
  740   COMPLETION  STATUS: C onsists of  the ACTIO N STATUS f ield (#.09 ) of the B CMA MEDICA TION LOG f ile (#53.7 9), which  contains t he status  of the med ication pa ss. Values  in this f ield will  equal an A CTION STAT US value.
  741   SOURCE OF  COMMENTS:  “O” source  of the su bsequent m essage.
  742   COMMENT: C ontains th e PRN EFFE CTIVENESS  field (#.2 2) of the  BCMA MEDIC ATION LOG  file (#53. 79). When  appropriat e, contain s a compos ite of the  COMMENT f ield (#.3)  and the C OMMENT fie ld (#.01)  of the COM MENT multi ple (#.3)  within the  BCMA MEDI CATION LOG  file (#53 .79), whic h contains  the comme nts entere d.
  743   COMMENT TY PE: Contai ns a compo site of th e ENTERED  BY field ( #.02) of t he COMMENT  multiple  (#.3) with in the BCM A MEDICATI ON LOG fil e (#53.79) , which co ntains the  pointer t o the NEW  PERSON fil e (#200) f or the use r that ent ered the c omment; al ong with t he actual  name of th e user as  returned b y FileMan;  as well a s the ENTE RED DATE/T IME field  (#.03) of  the COMMEN T multiple  (#.3) wit hin the BC MA MEDICAT ION LOG fi le (#53.79 ), which c ontains th e date and  time that  the entry  was filed  and the s tring “Dat e Entered.
  744   Appendix B : HL7 Mess aging for  BCMA
  745   Sample HL7  Data Fiel ds Passed  in Each Tr igger Even tThis sect ion identi fies the H L7 data fi elds that  are passed  in each o f the four  “trigger  events” as sociated w ith BCMA,  and exampl es of medi cation adm inistratio ns. The pr ocessed tr igger even ts are MED PASS, UPDA TE STATUS,  PRN EFFEC TIVENESS,  and ADD CO MMENT. For  each even t, there i s an order  control c ode and a  set of dat a fields l isted. For  any given  event; ho wever, som e of the d ata fields  may be em pty. Admin istration  Notes is s uch an exa mple. 
  746   The protoc ols provid ed in the  table, use  the BCMA  name spaci ng convent ion (“PSB” ), as do t he message s sent by  BCMA. The  BCMA HL7 m essages ar e unsolici ted; there fore, ackn owledgment  messages  are unnece ssary and  not recogn ized by th e PSB prot ocol. 
  747   Note: Word  wrapping  is in effe ct for the  example M edications  Administr ations on  the follow ing pages. Example: D ata Fields  Passed in  Each Trig ger Event  Associated  with BCMA  HL7
  748   ActionBroa dcast from  BCMASubsc ribing App licationME DPASS
  749   ProtocolPS B RAS O17  SRVPSB RAS  O17 SUB
  750   Order Cont rolXX (Ord er/service  changed)
  751   HL7 Fields MSH (as pr epared by  HL7 tool)
  752   PID: 3,4,5 ,7,8,19
  753   PV1: 2,3,7
  754   ORC: 1,2,3 ,7,8,9,10, 15,19
  755   RXO: 1,2,1 0,21
  756   NTE: 2,3,4
  757   RXR: 1,2
  758   RXC: 1,2,3 ,4
  759   RXA: 1,2,3 ,4,5,6,7,9 ,18,19,20A ppendix B:  HL7 Messa ging for B CMA
  760   Example: M edication  Administra tions 
  761   MEDPASS
  762   Message:
  763  
  764   MESSAGE HE ADER:
  765   MSH^~|\&^P SB HL7 SRV ^^PSB HL7  SUB^^20030 530075514- 0600^^RAS~ O17^500155 9^P^2.4^^^ AL^NE^USA
  766   MESSAGE TE XT: 
  767   PID^^^748^ 54~~~~AGE^ BCMAPATIEN T~TWO^^194 90101^M^^^ ^^^^^^^^00 0001000
  768   PV1^^U^7A  GEN MED 72 4-A~~~500^ ^^^BCMANUR SE~ONE
  769   ORC^XX^104 5~PSB~1045 ~IEN^13V^^ ^^~~~~~~~~ ~C^~^20030 5300755140 -600^BCMAN URSE~ONE^^ ^^^2003053 0075514-06 00^^^^BCMA NURSE~ONE
  770   RXO^269~FL UOROURACIL ^^^^^^^^^7 48V52^^^^^ ^^^^^^~250  ml/hr
  771   NTE^^O^1~T his is a c omment...^ BCMANURSE~ ONE~200305 30075514-0 600~Date E ntered
  772   RXR^IV^3 I NJECTION S ITE
  773   RXC^A^20~5 -FLUOURACI L^5-FLUOUR ACIL^
  774   RXC^B^8~AM INO ACID S OLUTION 8. 5%^AMINO A CID SOLUTI ON 8.5%^
  775   RXA^0^1^20 0305300755 14-0600^ ^ 20~5-FLUOU RACIL^450  MG^^^^^^^^ ^^^^^~^I
  776   RXA^0^2^20 0305300755 14-0600^ ^ 8~AMINO AC ID SOLUTIO N 8.5%^500  ML^^^^^^^ ^^^^^^~^I
  777   UPDATE STA TUS
  778   Message:
  779   MESSAGE HE ADER: 
  780   MSH^~|\&^P SB HL7 SRV ^^PSB HL7  SUB^^20030 530090340- 0600^^RAS~ O17^500156 1^P^2.4^^^ AL^NE^USA
  781   MESSAGE TE XT: 
  782   PID^^^748^ 54~~~~AGE^ BCMAPATIEN T~TWO^^194 90101^M^^^ ^^^^^^^^00 0001000
  783   PV1^^U^7A  GEN MED 72 4-A~~~500^ ^^^BCMANUR SE~ONE
  784   ORC^XX^104 5~PSB~1045 ~IEN^13V^^ ^^~~~~~~~~ ~C^~^20030 5300903400 -600^BCMAN URSE~ONE^^ ^^^2003053 0075514-06 00^^^^BCMA NURSE~ONE
  785   RXO^269~FL UOROURACIL ^^^^^^^^^7 48V52^^^^^ ^^^^^^~250  ml/hr
  786   NTE^^O^2~A dd this co mment to t he adminis tration... ^BCMANURSE ~ONE~20030 530082444- 0600~Date  Entered
  787   RXR^IV^3 I NJECTION S ITE
  788   RXC^A^20~5 -FLUOURACI L^5-FLUOUR ACIL^
  789   RXC^B^8~AM INO ACID S OLUTION 8. 5%^AMINO A CID SOLUTI ON 8.5%^
  790   RXA^0^1^20 0305300903 40-0600^ ^ 20~5-FLUOU RACIL^450  MG^^^4~200 3053009034 0-0600^^^^ ^^^^^^~^C
  791   RXA^0^2^20 0305300903 40-0600^ ^ 8~AMINO AC ID SOLUTIO N 8.5%^500  ML^^^4~20 0305300903 40-0600^^^ ^^^^^^^~^C
  792   Appendix B : HL7 Mess aging for  BCMA
  793   Example: M edication  Administra tions (con t.)
  794   PRN EFFECT IVENESS
  795   Message:
  796  
  797   MESSAGE HE ADER: 
  798   MSH^~|\&^P SB HL7 SRV ^^PSB HL7  SUB^^20030 530110049- 0600^^RAS~ O17^500156 2^P^2.4^^^ AL^NE^USA
  799   MESSAGE TE XT: 
  800   PID^^^748^ 54~~~~AGE^ BCMAPATIEN T~TWO^^194 90101^M^^^ ^^^^^^^^00 0001000
  801   ORC^XX^104 0~PSB~1040 ~IEN^28U^^ ^^13oz~Q6H ~~~~~~~~P^ ~^20030529 132246-060 0^BCMANURS E~ONE^^^^^ 2003052913 2246-0600^ ^^^BCMANUR SE~ONE
  802   NTE^^O^ Ef fectivenes s comment  for 5/29/2 003 1:22PM  admin...^ BCMANURSE~ ONE~200305 30110049-0 600~Date E ntered~~12 98~PRN Min utes
  803   ADD COMMEN T
  804   Message:
  805  
  806   MESSAGE HE ADER: 
  807   MSH^~|\&^P SB HL7 SRV ^^PSB HL7  SUB^^20030 530082444- 0600^^RAS~ O17^500156 0^P^2.4^^^ AL^NE^USA
  808   MESSAGE TE XT: 
  809   PID^^^748^ 54~~~~AGE^ BCMAPATIEN T~TWO^^194 90101^M^^^ ^^^^^^^^00 0001000
  810   ORC^XX^104 5~PSB~1045 ~IEN^13V^^ ^^~~~~~~~~ ~C^~^20030 530075514- 0600^BCMAN URSE~ONE^^ ^^^2003053 0075514-06 00^^^^BCMA NURSE~ONE
  811   NTE^^O^2~A dd this co mment to t he adminis tration... ^BCMANURSE ~ONE~20030 530082444- 0600~Date  Entered
  812   Appendix C : Interfac ing with t he Bar Cod e Label Pr inter
  813   Introducti onThe Bar  Code Medic ation Admi nistration  (BCMA) Me dication p ackage inc ludes an i nterface b etween the  Label Pri nt [PSBO B L] option  and the ba r code lab el printer . The Labe l Print  [ PSBO BL] o ption curr ently prin ts Unit Do se labels  on a label  printer.  This inter face allow s a unique  bar code  to be prin ted on the  first lin e of the U nit Dose l abel. 
  814   Since user s can now  customize  their own  label form ats using  control co des, it is  important  to note t hat all Un it Dose an d Ward Sto ck medicat ion labels  must conf orm to the  JCAHO Sta ndard for  Medication  Labeling  (Standard  MM.4.30).  Please ref er to the  excerpt of  the stand ard and re ferences a t the end  of this Ap pendix.
  815   Any printe r that sup ports bar  code print ing can be  used for  the Unit D ose labels . However,  the scan  success ra te will pr obably be  lower if a nything ot her than d irect ther mal transf er on synt hetic labe ls is used . Labels f rom dot ma trix print ers, laser  printers,  or even b ar code pr inters usi ng other t ypes of tr ansfer, wi pe off mor e easily.  The label  could beco me unreada ble, espec ially in a reas where  the bag m ight becom e wet. Wit h a direct  thermal t ransfer on to a synth etic label , the prin t actually  bonds to  the label  material.  Essentiall y, the lab el would h ave to be  ripped to  damage the  print.
  816   Hardware S etupThe pr inter must  be physic ally conne cted to th e network  and then d efined in  the DEVICE  (#3.5) an d TERMINAL  TYPE (#3. 2) files.
  817   Software S etupThe ty pe of prin ter will d etermine t he next st ep. The Ze bra and In termec pri nters requ ire contro l codes, w here the d ot matrix  or laser p rinters do  not requi re these c odes. The  Unit Does  print rout ine checks  the exist ence of th e control  codes befo re attempt ing to exe cute. It i s not requ ired for a ll control  codes to  be defined ; just bui ld the nec essary con trol codes  for the s elected pr inter. 
  818   When setti ng up the  Terminal T ype file f or the Zeb ra bar cod e printer  device, th e Terminal  Type file  entry mus t contains  the word  “ZEBRA” as  part of t he file na me. 
  819   For exampl e: P-ZEBRA
  820   When setti ng up the  Terminal T ype file f or the Int ermec bar  code print er device,  the Termi nal Type f ile entry  must conta ins the wo rd “INTERM EC” as par t of the f ile name. 
  821   For exampl e: P-INTER MEC
  822   Appendix C : Interfac ing with t he Bar Cod e Label Pr inter
  823   Software S etup (cont ’d)The pri nter must  be physica lly connec ted to the  network a nd then de fined in t he DEVICE  (#3.5) and  TERMINAL  TYPE (#3.2 ) files.
  824   Printer Co ntrol Code s
  825   For this t ype of pri nter to pr int a uniq ue bar cod e on the U nit Dose l abels, IRM s must bui ld control  codes. Th e CONTROL  CODES fiel ds [#55] a re added t o the TERM INAL TYPE  file (#3.2 ) in the K ernel patc h XU*8*205 . This pat ch must be  installed  before pr oceeding. 
  826   Control Co de Set Up
  827   The Unit D ose label  print rout ine curren tly uses p rinter con trol codes  and code  names that  are built  within Fi leMan. The  following  table ill ustrates t he control  codes and  correspon ding names  for the Z ebra print er.
  828   Example: Z ebra Print er Termina l Type Con trol Codes
  829   Abbreviati onFull Nam eControl C odeETEnd T ext N/AETF End Text F ield N/AEB End Barcod e W !,"^FO 20,150^A0N ,30,20^CI1 3^FR^FD"_T EXT_"^FS"E BFEnd Barc ode Field  N/AELEnd L abel W !," ^XZ"FEForm at End N/A FIFormat I nitializat ion N/AFI1 Format Ini tializatio n 1 N/AFI2 Format Ini tializatio n 2 N/ASBS tart Barco de S PSBTY PE=$S(PSBS YM="I25":" B2N",PSBSY M="128":"B CN",1:"B3N ") S:PSBSY M="" PSBBA R="NO-CODE "  W !,"^B Y2,3.0^FO2 0,100^"_PS BTYPE_",N, 80,Y,N^FR^ FD"_PSBBAR _"^FS"SBFS tart Barco de Field N /ASLStart  Label W !, "^XA",!,"^ LH0,0^FS"S TStart Tex t W !,"^FO "_PSBTYPE_ "^A0N,30,2 0^CI13^FR^ FD"_TEXT_" ^FS"STFSta rt Text Fi eldS PSBTY PE=$S(PSBT LE="PSBDRU G":"20,25" ,PSBTLE="P SBDOSE":"2 0,60", PSB TLE="PSBNA ME":"350,6 0",PSBTLE= "PSBWARD": "350,90",  PSBTLE="PS BLOT":"350 ,120", PSB TLE="PSBEX P":"350,15 0", PSBTLE ="PSBMFG": "500,150",  PSBTLE="P SBFCB":"35 0,180",1:" 0,0")Appen dix C: Int erfacing w ith the Ba r Code Lab el Printer
  830   Software S etup (cont ’d)The fie ld positio n map belo w identifi es the spe cific cont rol codes  for the Ze bra printe r that dir ect the ex act positi on in whic h the fiel ds are pri nted on th e bar code  label.Exa mple: Zebr a Bar Code  Label - F ield Posit ion Map
  831   Abbreviati onControl  Code ( Fie ld Coordin ates) Desc riptionEBF O20,150“No  – Code” s tatementSB FO20,100 " Bar code G raphSTFPSB TLE="PSBDR UG":"20,25 " Drug Nam ePSBTLE="P SBDOSE":"2 0,60",  Do sagePSBTLE ="PSBNAME" :"350,60"  Patient Na me and Qua lityPSBTLE ="PSBWARD" :"350,90",  Ward Loca tionPSBTLE ="PSBLOT": "350,120",  Lot Numbe rPSBTLE="P SBEXP":"35 0,150", Ex piration D atePSBTLE= "PSBMFG":" 500,150",  Manufactur erPSBTLE=" PSBFCB":"3 50,180"Fil led By/Che cked ByApp endix C: I nterfacing  with the  Bar Code L abel Print er
  832   Software S etup (cont ’d)The fol lowing tab le illustr ates the c ontrol cod es and cor responding  names for  the Inter mec printe r.Example:  Intermec  Printer Te rminal Typ e Control  Codes
  833   Abbreviati onFull Nam eControl C odeETEnd T ext N/AETF End Text F ield N/AEB End Barcod e W "<STX> H8;o50,40; f3;c7;h2;w 2;d0,80;<E TX>",!EBFE nd Barcode  Field N/A ELEnd Labe l W "<STX> <ETB><ETX> ",!FEForma t End N/AF IFormat In itializati on W "<STX ><ESC>C<ET X>",!,"<ST X><ESC>P<E TX>",!,"<S TX>E2;F2<E SC><ETX>", !FI1Format  Initializ ation 1 W  "<STX>H7;o 30,260;f3; c7;h2;w2;d 0,80;<ETX> ",!,"<STX> H6;o50,440 ;f3;c7;h2; w2;d0,20;< ETX>",!,"< STX>H5;o50 ,260;f3;c7 ;h2;w2;d0, 20;<ETX>", !,"<STX>H4 ;o70,260;f 3;c7;h2;w2 ;d0,20;<ET X>",!
  834   FI2Format  Initializa tion 2 W " <STX>H3;o9 0,260;f3;c 7;h2;w2;d0 ,20;<ETX>" ,!,"<STX>H 2;o110,260 ;f3;c7;h2; w2;d0,20;< ETX>",!,"< STX>H1;o11 0,40;f3;c7 ;h2;w2;d0, 20;<ETX>", !,"<STX>H0 ;o130,40;f 3;c7;h2;w2 ;d0,40;<ET X>",!
  835   SBStart Ba rcode W "< STX>"_TEXT _"<ETX>",! SBFStart B arcode Fie ld S PSBTY PE=$S(PSBS YM="I25":" c2,0",PSBS YM="128":" c6,0",1:"c 0,0") W "< STX>B8;o85 ,40;f3;"_P SBTYPE_";i 1;do,25;p@ ;<ETX>",!, "<STX>I8;h 1;w1;<ETX> ",!SLStart  Label W " <STX>R;<EX T>",!,"<ST X><ESC>E2< EXT>",!STS tart Text  W "<STX>"_ TEXT_"<CR> <ETX>",!ST FStart Tex t FieldN/A Appendix C : Interfac ing with t he Bar Cod e Label Pr inter
  836   Software S etup (cont ’d)The fie ld positio n map belo w identifi es the spe cific cont rol codes  for the In termec pri nter that  direct the  exact pos ition in w hich the f ields are  printed on  the bar c ode label. Example: I ntermec Ba r Code Lab el - Field  Position  Map
  837   Abbreviati onControl  Code ( Fie ld Coordin ates) Desc riptionEB< STX>H8;o50 ,40;f3;c7; h2;w2;d0,8 0;<ETX>“No  – Code” s tatementFI 1<STX>H7;o 30,260;f3; c7;h2;w2;d 0,80;<ETX> Filled By/ Checked By <STX>H6;o5 0,440;f3;c 7;h2;w2;d0 ,20;<ETX>" Manufactur er<STX>H5; o50,260;f3 ;c7;h2;w2; d0,20;<ETX >Expiratio n Date<STX >H4;o70,26 0;f3;c7;h2 ;w2;d0,20; <ETX>Lot N umberFI2<S TX>H3;o90, 260;f3;c7; h2;w2;d0,2 0;<ETX>War d Location <STX>H2;o1 10,260;f3; c7;h2;w2;d 0,20;<ETX> Patient Na me and Qua lity<STX>H 1;o110,40; f3;c7;h2;w 2;d0,20;<E TX>Dosage< STX>H0;o13 0,40;f3;c7 ;h2;w2;d0, 40;<ETX>Dr ug NameSBF <STX>B8;o8 5,40;f3;"_ PSBTYPE_"; i1;do,25;p @;<ETX>
  838   <STX>I8;h1 ;w1;<ETX>" Bar code G raphAppend ix C: Inte rfacing wi th the Bar  Code Labe l Printer
  839   Software S etup (cont ’d)Example  Terminal  Type Files  
  840   The follow ing are ex amples of  terminal t ype file s etups that  were used  in the de velopment  process. T hese examp les are pr ovided to  guide the  user in th e setup pr ocess. Ple ase note t hat they a re only ex amples, an d may not  be appropr iate for y our config uration. 
  841   Example: Z ebra Print er Sample  Terminal T ype File
  842   NUMBER: 1                                   ABBREVIATI ON: SL
  843     FULL NAM E: Star La bel                   CONTROL CO DE: W !,"^ XA",!,"^LH 0,0^FS"
  844   NUMBER: 2                                   ABBREVIATI ON: EL
  845     FULL NAM E: End Lab el                CON TROL CODE:  W !,"^XZ"
  846   NUMBER: 3                                 A BBREVIATIO N: SB
  847     FULL NAM E: Start B arcode
  848     CONTROL  CODE: S PS BTYPE=$S(P SBSYM="I25 ":"B2N",PS BSYM="128" :"BCN",1:" B3N") S:PS BSYM="" PS BBAR="NO-C ODE"  W !, "^BY2,3.0^ FO20,100^" _PSBTYPE_" ,N,80,Y,N^ FR^FD"_PSB BAR_"^FS"
  849   NUMBER: 4                                 A BBREVIATIO N: EB
  850     FULL NAM E: End Bar code
  851     CONTROL  CODE: W !, "^FO20,150 ^A0N,30,20 ^CI13^FR^F D"_TEXT_"^ FS"
  852   NUMBER: 5                                 A BBREVIATIO N: ST
  853     FULL NAM E: Start T ext
  854     CONTROL  CODE: W !, "^FO"_PSBT YPE_"^A0N, 30,20^CI13 ^FR^FD"_TE XT_"^FS"
  855   NUMBER: 6                                 A BBREVIATIO N: STF
  856     FULL NAM E: Start T ext Field
  857     CONTROL  CODE: S PS BTYPE=$S(P SBTLE="PSB DRUG":"20, 25",PSBTLE ="PSBDOSE" :"20,60",  PSBTLE="PS BNAME":"35 0,60",PSBT LE="PSBWAR D":"350,90 ", PSBTLE= "PSBLOT":" 350,120",  PSBTLE="PS BEXP":"350 ,150", PSB TLE="PSBMF G":"500,15 0", PSBTLE ="PSBFCB": "350,180", 1:"0,0")
  858   Appendix C : Interfac ing with t he Bar Cod e Label Pr inter
  859   Software S etup (cont ’d)The fol lowing sho ws a sampl e Intermec  printer t erminal ty pe file.
  860   Example: I ntermec Pr inter Samp le Termina l Type Fil e
  861   NUMBER: 1                                   ABBREVIATI ON: SL
  862     FULL NAM E: Start L abel
  863     CONTROL  CODE: W "< STX>R;<EXT >",!,"<STX ><ESC>E2<E XT>",!
  864   NUMBER: 2                                   ABBREVIATI ON: EL
  865     FULL NAM E: End Lab el                CON TROL CODE:  W "<STX>< ETB><ETX>" ,!
  866   NUMBER: 3                                   ABBREVIATI ON: FI1
  867     FULL NAM E: Format  Initializa tion 1
  868     CONTROL  CODE: W "< STX>H7;o30 ,260;f3;c7 ;h2;w2;d0, 80;<ETX>", !,"<STX>H6 ;o50,440;f 3;c7;h2;w2 ;d0,20;<ET X>",!,"<ST X>H5;o50,2 60;f3;c7;h 2;w2;d0,20 ;<ETX>",!, "<STX>H4;o 70,260;f3; c7;h2;w2;d 0,20;<ETX> ",!
  869   NUMBER: 4                                   ABBREVIATI ON: FI2
  870     FULL NAM E: Format  Initializa tion 2
  871     CONTROL  CODE: W "< STX>H3;o90 ,260;f3;c7 ;h2;w2;d0, 20;<ETX>", !,"<STX>H2 ;o110,260; f3;c7;h2;w 2;d0,20;<E TX>",!,"<S TX>H1;o110 ,40;f3;c7; h2;w2;d0,2 0;<ETX>",! ,"<STX>H0; o130,40;f3 ;c7;h2;w2; d0,40;<ETX >",!
  872   NUMBER: 5                                   ABBREVIATI ON: SBF
  873     FULL NAM E: Start B arcode Fie ld
  874     CONTROL  CODE: S PS BTYPE=$S(P SBSYM="I25 ":"c2,0",P SBSYM="128 ":"c6,0",1 :"c0,0") W  "<STX>B8; o85,40;f3; "_PSBTYPE_ ";i1;do,25 ;p@;<ETX>" ,!,"<STX>I 8;h1;w1;<E TX>",!
  875   NUMBER: 6                                 A BBREVIATIO N: SB
  876     FULL NAM E: Start B arcode                CONTROL CO DE: W "<ST X>"_TEXT_" <ETX>",!
  877   NUMBER: 7                                 A BBREVIATIO N: EB
  878     FULL NAM E: End Bar code
  879     CONTROL  CODE: W "< STX>H8;o50 ,40;f3;c7; h2;w2;d0,8 0;<ETX>",!
  880   NUMBER: 8                                 A BBREVIATIO N: FI
  881     FULL NAM E: Format  Initializa tion
  882     CONTROL  CODE: W "< STX><ESC>C <ETX>",!," <STX><ESC> P<ETX>",!, "<STX>E2;F 2<ESC><ETX >",!
  883   NUMBER: 9                                 A BBREVIATIO N: ST
  884     FULL NAM E: Start T ext
  885     CONTROL  CODE: W "< STX>"_TEXT _"<CR><ETX >",!
  886   Appendix C : Interfac ing with t he Bar Cod e Label Pr inter
  887   Software S etup (cont ’d)Dot Mat rix and La ser Printe rs
  888   The contro l codes in  the TERMI NAL TYPE f ile (#3.2)  are not r equired fo r dot matr ix and las er printer s. However , the BAR  CODE ON fi eld [#60]  and BAR CO DE OFF fie ld [#61] i n the TERM INAL TYPE  file (#3.2 ) are need ed.
  889   An example  of each f ield is sh own below  for the Ou tput Techn ology Corp oration (O TC) printe rs. Please  note that  it is onl y an examp le and  ma y not be a ppropriate  for your  configurat ion. 
  890   Example: O TC Printer  Example 
  891   BAR CODE O FF: $C(27) ,"[0t",!    
  892   BAR CODE O N:  $C(27) ,"[4;4;0;2 ;4;2;4;2}" ,$C(27),"[ 3t"
  893   Appendix C : Interfac ing with t he Bar Cod e Label Pr inter
  894   Printed Ba r Code Uni t Dose Lab el SampleW ith this i nterface,  a unique b ar code wi ll be prin ted on the  first lin e of the U nit Dose l abel with  the label  number pri nted below  it. Depen ding upon  the type o f printer  used, the  asterisks  (*) may or  may not b e printed  on either  side of th e label nu mber.
  895   Example: S ample Unit  Dose Bar  Code Label  
  896   Drug: BACL OFEN 10MG  TABS (Qty:  1)Dosage:  25MGPatie nt: BCMAPA TIENT,ONE
  897   Ward: GEN  MED
  898   Lot: 12314 1
  899      
  900   Exp: 4/5/2 006  Mfg:  UPJOHN
  901   Filled/Che cked By: X X/XX
  902   *500-2564* Example: S ample Ward  Stock Bar  Code Labe
  903   Drug: BACL OFEN 10MG  TABS (Qty:  1)Dosage:  25MGPatie nt: 
  904   Ward: 
  905   Lot: 12314 1
  906      
  907   Exp: 4/5/2 006  Mfg:  UPJOHN
  908   Filled/Che cked By:__ _____/____ ___
  909   *500-2564* Appendix C : Interfac ing with t he Bar Cod e Label Pr inter
  910   JCAHO Stan dard for M edication  Labeling*T he followi ng is an e xcerpt fro m the The  Comprehens ive Accred itation Ma nual for H ospitals:  The Offici al Handboo k (CAMH) t hat lists  the JCAHO  standard f or medicat ion labeli ng. All pr inted medi cation lab els must a dhere to t his standa rd.Standar d MM.4.30M edications  are label ed.Rationa le for MM. 4.30A stan dardized m ethod for  labeling a ll medicat ions will  minimize e rrors.Elem ents of Pe rformance  for MM.4.3 0Medicatio ns are lab eled in a  standardiz ed manner  according  to law or  regulation  and stand ards of pr actice.Any  time one  or more me dications  or solutio ns are pre pared but  are not ad ministered  immediate ly, the me dication c ontainer*  must be la beled.At a  minimum,  all medica tions prep ared in th e hospital  are label ed with th e followin g:Drug nam e, strengt h, amount  (if not ap parent fro m the cont ainer)Expi ration dat e† when no t used wit hin 24 hou rsExpirati on time wh en expirat ion occurs  in less t han 24 hou rsThe date  prepared  and the di luent for  all compou nded IV ad mixtures a nd parente ral nutrit ion soluti onsWhen pr eparing in dividualiz ed medicat ions for m ultiple sp ecific pat ients, or  when the p erson prep aring the  individual ized medic ations is  not the pe rson admin istering t he  medica tion, the  label also  includes  the follow ing:Patien t namePati ent locati onDirectio ns for use  and any a pplicable  cautionary  statement s either o n the labe l or attac hed as an  accessory  label (for  example,  “requires  refrigerat ion,” “for  IM use on ly”)
  911   *Source: J oint Commi ssion on A ccreditati on of Hosp ital Organ izations ( JCAHO). (J anuary, 20 06). The C omprehensi ve Accredi tation Man ual for Ho spitals: T he Officia l Handbook  (CAMH)  
  912   (pp. MM-11 -MM‑12). O akbrook Te rrace, Il:  Joint Com mission Re sources, I nc.  Web l ink:
  913   http://vaw w.oqp. URL         /oqp_servi ces/accred itation/up loads/JCAH O2006/2006 %20CAMH%20 Core.pdf
  914   tip:
  915   BCMA is de signed to  augment, n ot replace , the clin ical judgm ent of the  medicatio n administ rator, or  clinician.
  916  
  917  
  918  
  919  
  920  
  921   tip:
  922   Use this g uide for w orking wit h the CHUI  version o f BCMA, V.  3.0.
  923  
  924  
  925  
  926  
  927  
  928  
  929   tip:
  930   Bookmark t hese sites  for futur e referenc e.
  931  
  932  
  933  
  934  
  935  
  936   tip:
  937   Bookmark t hese sites  for futur e referenc e.
  938  
  939  
  940  
  941  
  942  
  943   tip:
  944   In a CHUI  environmen t, when yo u press th e ENTER ke y, instead  of typing  a respons e, the sys tem accept s the defa ult value  shown to t he left of  the doubl e slash (/ /) at a pr ompt or fi eld.
  945  
  946  
  947  
  948  
  949  
  950   tip:
  951   In a CHUI  environmen t, when yo u press en ter, inste ad of typi ng a respo nse, the s ystem acce pts the de fault valu e shown to  the left  of the dou ble slash  (//) at a  prompt or  a field.
  952  
  953  
  954  
  955  
  956  
  957   tip:
  958   The BCMA V irtual Due  List (VDL ) is calle d “BCMA VD L” in this  guide to  eliminate  confusion  with�the V istA Docum entation L ibrary (VD L)�also me ntioned�in  this guid e.
  959  
  960  
  961  
  962  
  963  
  964   important:
  965   You should  install a nd test BC MA in your  test acco unts befor e installi ng in your  productio n accounts .
  966  
  967  
  968  
  969  
  970  
  971   tip:
  972   The approx imate size  for ^PSB  was calcul ated using  a “normal ” medicati on pass fo r a Unit D ose and an  IV medica tion order . This is  only an es timated nu mber; it s erves as t he “mean.”
  973  
  974  
  975  
  976  
  977  
  978   tip:
  979   The approx imate size  for ^PSB  was calcul ated using  a "normal ” Med Pass  for a Uni t Dose and  an IV med ication or der. This  is only an  estimated  number; i t serves a s the “mea n.”
  980  
  981  
  982  
  983  
  984  
  985   tip:
  986   The namesp ace for th e BCMA pac kage is PS B and the  primary gl obal�is ^P SB.
  987  
  988  
  989  
  990  
  991  
  992   tip:
  993   Archive an d purge ca pabilities  are not a vailable i n�BCMA V.  3.0. 
  994  
  995  
  996  
  997  
  998  
  999   tip:
  1000   Archive an d purge ca pabilities  are not a vailable i n this ver sion of BC MA. 
  1001  
  1002  
  1003  
  1004  
  1005  
  1006   tip:
  1007   You can lo cate speci fic routin es in the  “Routines  Installed”  section o f this gui de.
  1008  
  1009  
  1010  
  1011  
  1012  
  1013  
  1014  
  1015  
  1016   tip:
  1017   The RXC se gment may  repeat, on ce for eac h solution  and each  additive,  in an IV m edication  order. The  RX COMPON ENT TYPE i s “A” for  an additiv e” and “B”  for a sol ution.
  1018  
  1019  
  1020  
  1021  
  1022  
  1023  
  1024   �Blue high lighting d enotes a c orrection  of existin g VDL text ;   not a  change mad e by patch  *103.
  1025  
  1026   February 2 004
  1027   BCMA V. 3. 0 Technica l Manual/S ecurity Gu ide
  1028   iii
  1029   _104417916 0.doc