7. EPMO Open Source Coordination Office Redaction File Detail Report

Produced by Araxis Merge on 4/27/2017 2:09:17 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 PSS_10_203_cif.zip\PSS_10_203_cif\docs pss_1_tm_r0417.doc Tue Apr 18 15:44:42 2017 UTC
2 PSS_10_203_cif.zip\PSS_10_203_cif\docs pss_1_tm_r0417.doc Thu Apr 27 16:12:31 2017 UTC

7.2 Comparison summary

Description Between
Files 1 and 2
Text Blocks Lines
Unchanged 5 2590
Changed 5 10
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   Department  of Vetera ns Affairs  Pharmacy  Data Manag ement Tech nical Manu al / Secur ity Guide
  2   PHARMACY D ATA MANAGE MENT
  3   TECHNICAL  MANUAL/
  4   SECURITY G UIDE
  5   Version 1. 0
  6   June 2012
  7   (Revised A pril 2017)
  8   Department  of Vetera ns Affairs
  9   Product De velopment
  10   Revision H istory
  11   Each time  this manua l is updat ed, the Ti tle Page l ists the n ew revised  date and  this page  describes  the change s. If the  Revised Pa ges column  lists “Al l,” replac e the exis ting manua l with the  reissued  manual. If  the Revis ed Pages c olumn list s individu al entries  (e.g., 25 , 32), eit her update  the exist ing manual  with the  Change Pag es Documen t or print  the entir e new manu al.
  12   DateRevise d PagesPat ch NumberD escription 4/2017
  13   11
  14   PSS*1*203A dded new r outines PS SDEEA, PSS P203, and  PSSPRICE t o Routines  section. 
  15   (L. Behuni ak PM; E.  Weaver, Te ch Writer) 10/201612
  16  
  17  
  18    HYPERLINK   \l "appe ndixa34" 
  19  
  20   34
  21   -37
  22   PSS*1*193A dded new r outine PSS HLDFS to t he Routine s section.
  23   Added Appe ndix A for  Pharmacy  Interface  Automation .
  24    (S. Solda n PM; R.Wa lters, Tec h Writer)4 /16i-ii,
  25   11-12, 22- 23PSS*1*17 5Add 2 new  Routines:  PSSCKOS &  PSSDIUTX,  Updated A dditional  Informatio n section
  26   (H. Cross,  PM; S. He iress, Tec h Writer;  R. Ruzback i, Develop er)3/16i-i i, 
  27    REF p11_R outineTabl e \h 
  28   11-12PSS*1 *191Update d Revision  History
  29   Added new  routines t o routine  list:
  30   PSS1P191,  PSSHRHAI,  PSSMRRDG,  PSSMRRI
  31   (D. Connol ly, PM; E.  Phelps, T ech Writer )3/14All
  32   i - iii, 2 , 7-13, 33 , 37PSS*1* 172Renumbe red all pa ges.
  33   Updated Re vision His tory and T able of Co ntents.
  34   Updated th e Glossary  section b y putting  definition s in a tab le format.
  35   New menu,  options, f ile and ro utines add ed.
  36   (C. Powell , PM; K. K apple, Tec h Writer)9 /13i - iii , 3, 7 – 1 3a, 30, 34  - 35PSS*1 *160Update d Revision  History
  37   Updated Ta ble of Con tents with  Exported  Options an d Routines  sections
  38   Added Look up Dosing  Check Info  for Drug  [PSS DRUG  DOSING LOO KUP] OPTIO N to the D osages [PS S DOSAGES  MANAGEMENT ] MENU OPT ION and Dr ug Names w ith Traili ng Spaces  Report 
  39   [PSS TRAIL ING SPACES  REPORT]. 
  40   Added PSS  DOSING ORD ER CHECKS  option
  41   Also added  the follo wing routi nes to the  routine l ist:
  42   PSS160EN
  43   PSS160PO
  44   PSSDRDOS
  45   PSSFDBDI
  46   PSSDSONF
  47   Added Web  Servers, W eb Service s, and Cac he Class s ection
  48   Added text  to the Se curity Key s section
  49   (D. McCanc e, PM; K.  Kapple, Te ch Writer) 01/13i-iv,  3, 6-6b,  7, 10 - 13 PSS*1*164
  50   PSS*1*169
  51   Removed re ference to  patch PSS *1*146 in  the menu o ptions sec tion
  52   Added Prin t Interfac e Data Fil e option t o the Phar macy Data  Management  [PSS MGR]  menu
  53   Added Chec k Drug Int eraction o ption to t he Pharmac y Data Man agement [P SS MGR] me nu
  54   Moved Menu /Option it ems from p age 7 to p age 6a
  55   Added Prin t Interfac e Data Fil e option t o the PEPS  Services  menu under  the Optio n Descript ions secti on
  56   Added Chec k Drug Int eraction o ption to t he Option  Descriptio ns section
  57   Added rout ine PSSDIU TL
  58   Added Find  Unmapped  Local Poss ible Dosag es option  to the Sta nd Alone O ptions sec tion
  59   (G. Tucker , PM; G. S corca, Tec h Writer)0 6/12AllPSS *1*146Reis sued docum ent. Remov ed redunda ncies due  to MOCHA V .1.0 incre mental rel ease; upda ted format ting and p age numera tion.
  60   (N. Goyal,  PM; J. Ow czarzak, T ech Writer )Table of  Contentsxe  "Table of  Contents"
  61   1Introduct ion
  62  
  63  
  64   2File List
  65  
  66  
  67   3File Desc riptions
  68  
  69  
  70   3Menu/Opti ons
  71  
  72  
  73   7Option De scriptions
  74  
  75  
  76   11Routines
  77  
  78  
  79   12Exported  Options
  80  
  81  
  82   13Protocol s
  83  
  84  
  85   13Bulletin s
  86  
  87  
  88   14Web Serv ers
  89  
  90  
  91   14Web Serv ices
  92  
  93  
  94   14Cache Cl ass
  95  
  96  
  97   14HL7 Mess aging with  an Extern al System
  98  
  99  
  100   20Data Arc hiving and  Purging
  101  
  102  
  103   20Callable  Routines/ Entry Poin ts/Applica tion Progr am Interfa ces (APIs)
  104  
  105  
  106   20Medicati on Routes
  107  
  108  
  109   21Administ ration Sch eduling
  110  
  111  
  112   21External  Relations
  113  
  114  
  115   21Internal  Relations
  116  
  117  
  118   22Package- Wide Varia bles
  119  
  120  
  121   22Package  Requiremen ts
  122  
  123  
  124   22Addition al Informa tion
  125  
  126  
  127   29Security  Managemen t
  128  
  129  
  130   29Mail Gro ups
  131  
  132  
  133   29Alerts
  134  
  135  
  136   29Bulletin s
  137  
  138  
  139   29Remote S ystems
  140  
  141  
  142   29Archivin g/Purging
  143  
  144  
  145   30Continge ncy Planni ng
  146  
  147  
  148   30Interfac ing
  149  
  150  
  151   30Electron ic Signatu res
  152  
  153  
  154   30Locked M enu Option s
  155  
  156  
  157   30Security  Keys
  158  
  159  
  160   32File Sec urity
  161  
  162  
  163   33Referenc es
  164  
  165  
  166   34Appendix  A: Pharma cy Interfa ce Automat ion
  167  
  168  
  169   34Introduc tion
  170  
  171  
  172   35New Func tionality
  173  
  174  
  175   35Options  and Build  Components
  176  
  177  
  178   37Modified  and New R outines
  179  
  180  
  181   39Glossary
  182  
  183  
  184  
  185  
  186   (This page  included  for two-si ded copyin g.)
  187   Introducti on XE "Int roduction"  
  188   Pharmacy D ata Manage ment (PDM)  provides  tools for  managing P harmacy da ta. It inc ludes tool s for crea ting Pharm acy Ordera ble Items  and mainta ining file s necessar y for the  Computer P atient Rec ord System  (CPRS). P DM consoli dates tool s for mana ging the v arious Pha rmacy soft ware produ cts. It pr ovides Pha rmacy Supe rvisors, i n one loca tion, the  capability  to enter  and edit d ata from t he local D RUG file ( #50) for a ll Pharmac y related  packages.
  189   The PDM Te chnical Ma nual is de signed to  acquaint t he user wi th the var ious PDM o ptions and  offer spe cific guid ance on th e maintena nce and us e of the P DM package . Document ation conc erning the  PDM packa ge, includ ing any su bsequent c hange page s affectin g this doc umentation , can be f ound at th e VistA Do cumentatio n Library  (VDL) on t he Veteran s Administ ration Int ranet.
  190   Notationsx e "Notatio ns" that w ill be use d consiste ntly throu ghout this  PDM Techn ical Manua l are outl ined below .
  191   Menu optio ns will be  italicize d.
  192   Example: T he Drug En ter/Edit o ption perm its you to  enter or  edit a dru g.
  193   Screen pro mpts will  be denoted  with quot ation mark s around t hem.
  194   Example: t he "SELECT  DRUG" pro mpt will d isplay nex t.
  195   Responses  in bold fa ce indicat e user inp ut.
  196   Example: D RUG GENERI C NAME: AC ETA
  197   Text cente red betwee n bent par entheses r epresents  a keyboard  key that  needs to b e pressed  in order f or the sys tem to cap ture a use r response  or move t he cursor  to another  field.
  198   <Enter> in dicates th at the Ent er key (or  Return ke y on some  keyboards)  must be p ressed.
  199   Example: T ype Y for  Yes or N f or No and  press <Ent er> 
  200   <Tab> indi cates that  the Tab k ey must be  pressed.
  201   Example:   Press <Tab > to move  the cursor  to the ne xt field.
  202    Indicates  especiall y importan t or helpf ul informa tion.
  203    Options a re locked  with a par ticular se curity key .  The use r must hol d the part icular sec urity key  to be able  to perfor m the menu  option.
  204   Example:      Without  the PSXCO MPMGR key,  the Conso lidated Ma il Outpati ent Pharma cy options  cannot be  accessed.  
  205   ( The page  symbol in dicates a  referral t o a diagra m.
  206   ?, ??, ???   One, two  or three  question m arks can b e entered  at any of  the prompt s for onli ne help. O ne questio n mark eli cits a bri ef stateme nt of what  informati on is appr opriate fo r the prom pt. Two qu estion mar ks provide  more help , plus the  hidden ac tions, and  three que stion mark s will pro vide more  detailed h elp, inclu ding a lis t of possi ble answer s, if appr opriate.
  207   ^  Up arro w (caret o r a circum flex) and  pressing < Enter> can  be used t o exit the  present o ption.
  208   File List
  209   The follow ing PDM fi les are ex ported wit h the PDM  package. 
  210   File#        NAME           
  211   UPDATE 
  212   DATA COMES     USER
  213  
  214   DD
  215   WITH FILE    OVERRIDE
  216   50           DRUG 
  217   FULL
  218   NO
  219  
  220   50.4         DRUG ELE CTROLYTES 
  221   FULL
  222   NO
  223   50.606       DOSAGE F ORM                    
  224   FULL
  225   YES (MERGE )
  226   NO
  227   50.7         PHARMACY  ORDERABLE  ITEM 
  228   FULL
  229   NO
  230   51           MEDICATI ON INSTRUC TION         
  231   FULL
  232   NO
  233   51.1         ADMINIST RATION SCH EDULE       
  234   FULL
  235   YES (MERGE )
  236   YES
  237   51.2         MEDICATI ON ROUTES            
  238   FULL
  239   YES (MERGE )
  240   YES
  241   51.5         ORDER UN IT 
  242   FULL
  243   NO
  244   51.7         DRUG TEX T
  245   FULL
  246   YES
  247   YES
  248  
  249  
  250                   (OVER WRITE)
  251   52.6         IV ADDIT IVES 
  252   FULL
  253   NO
  254   52.7         IV SOLUT IONS 
  255   FULL
  256   NO
  257   53.47        INFUSION  INSTRUCTI ONS
  258   FULL
  259   NO
  260   54           RX CONSU LT 
  261   FULL (SCRE EN)
  262   NO
  263   55           PHARMACY  PATIENT ( Partial DD )
  264   PARTIAL
  265   NO
  266   59.7         PHARMACY  SYSTEM 
  267   FULL
  268   NO
  269   59.73         VENDOR  DISABLE/EN ABLE
  270   FULL
  271   NO
  272   59.74         VENDOR  INTERFACE  DATA 
  273   FULL
  274   NO
  275   The follow ing non-PD M files ar e exported  with the  PDM packag e. 
  276   File#        NAME           
  277   UPDATE 
  278   DATA COMES     USER
  279  
  280   DD
  281   WITH FILE    OVERRIDE
  282   200          NEW PERS ON (Partia l DD)
  283   PARTIAL
  284   NO
  285   9009032.3    APSP INT ERVENTION  TYPE      
  286   FULL
  287   YES
  288  
  289   NO
  290  
  291  
  292   (OVERWRITE )
  293   9009032.4    APSP INT ERVENTION 
  294   FULL
  295   NO
  296   9009032.5    APSP INT ERVENTION  RECOMMENDA TION 
  297   FULL
  298   YES
  299   NO
  300  
  301  
  302   (OVERWRITE )
  303   File Descr iptions
  304   This packa ge require s the file s listed b elow. Info rmation ab out the fi les can be  obtained  by using t he VA File Man to gen erate a li st of file  attribute s.
  305   The Data D ictionarie s (DDs) ar e consider ed part of  the onlin e document ation for  this softw are applic ation. Use  the VA Fi leMan List  File Attr ibutes [DI LIST] opti on, under  the Data D ictionary  Utilities  [DI DDU] o ption, to  view/print  the DDs.
  306   Menu/Optio ns
  307   The PDM op tions list ed below s how the PS S MGR Menu  structure .
  308   Pharmacy D ata Manage ment [PSS  MGR] menu:
  309   CMOP Mark/ Unmark (Si ngle drug)  
  310   [PSSXX MAR K]   
  311   Dosages…
  312   [PSS DOSAG ES MANAGEM ENT]
  313   Dosage For m File Ent er/Edit 
  314   [PSS DOSAG E FORM EDI T]
  315   Enter/Edit  Dosages 
  316   [PSS EDIT  DOSAGES]
  317   Most Commo n Dosages  Report 
  318   [PSS COMMO N DOSAGES]
  319   Noun/Dosag e Form Rep ort 
  320   [PSS DOSE  FORM/ NOUN  REPORT]
  321   Review Dos ages Repor
  322   [PSS DOSAG E REVIEW R EPORT]
  323   Local Poss ible Dosag es Report 
  324   [PSS LOCAL  POSSIBLE  DOSAGES] 
  325   Request Ch ange to Do se Unit 
  326   [PSS DOSE  UNIT REQUE ST]
  327   Lookup Dos ing Check  Info for D rug
  328   [PSS DRUG  DOSING LOO KUP]
  329   Drug Names  with Trai ling Space s Report 
  330   [PSS TRAIL ING SPACES  REPORT]
  331   Drug Enter /Edit
  332   [PSS DRUG  ENTER/ EDI T]
  333   Order Chec k Manageme nt…
  334   [PSS ORDER  CHECK MAN AGEMENT] 
  335   Request Ch anges to E nhanced Or der Check  Database
  336   [PSS ORDER  CHECK CHA NGES]
  337   Report of  Locally En tered Inte ractions
  338   [PSS REPOR T LOCAL IN TERACTIONS ]
  339         Elec trolyte Fi le (IV)
  340   [PSSJI ELE CTROLYTE F ILE]
  341   Lookup int o Dispense  Drug File
  342   [PSS LOOK]
  343   Medication  Instructi on Managem ent... 
  344   [PSS MED I NSTRUCTION  MANAGEMEN T]
  345   Medication  Instructi on File Ad d/Edit
  346   [PSSJU MI]
  347   Medication  Instructi on File Re port 
  348   [PSS MED I NSTRUCTION  REPORT]
  349   Medication  Routes Ma nagement..
  350   [PSS MEDIC ATION ROUT ES MGMT]
  351   Medication  Route Fil e Enter/Ed it
  352   [PSS MEDIC ATION ROUT ES EDIT]
  353   Medication  Route Map ping Repor
  354   [PSS MED R OUTE MAPPI NG REPORT]
  355   Medication  Route Map ping Histo ry Report 
  356   [PSS MED R OUTE MAPPI NG CHANGES ]
  357   Request Ch ange to St andard Med ication Ro ute 
  358   [PSS MEDIC ATION ROUT E REQUEST]
  359   Default Me d Route fo r OI Repor t
  360   [PSS DEF M ED ROUTE O I RPT]
  361   Orderable  Item Manag ement…
  362   [PSS ORDER ABLE ITEM  MANAGEMENT ]
  363   Edit Order able Items
  364   [PSS EDIT  ORDERABLE  ITEMS]
  365   Dispense D rug/Ordera ble Item M aintenance
  366   [PSS MAINT AIN ORDERA BLE ITEMS]
  367   Orderable  Item/Dosag es Report
  368   [PSS ORDER ABLE ITEM  DOSAGES]
  369   Patient In structions  Report
  370   [PSS INSTR UCTIONS/ I TEMS REPOR T]
  371   Orderable  Item Repor t
  372   [PSS ORDER ABLE ITEM  REPORT]
  373   Formulary  Informatio n Report
  374   [PSSNFI]
  375   Drug Text  Management ... 
  376   [PSS DRUG  TEXT MANAG EMENT]
  377   Drug Text  Enter/Edit
  378   [PSS EDIT  TEXT] 
  379   Drug Text  File Repor t
  380   [PSS DRUG  TEXT FILE  REPORT]
  381   Pharmacy S ystem Para meters Edi t
  382   [PSS SYS E DIT]
  383   Standard S chedule Ma nagement..
  384   [PSS SCHED ULE MANAGE MENT]
  385   Standard S chedule Ed it
  386   [PSS SCHED ULE EDIT] 
  387   Administra tion Sched ule File R eport 
  388   [PSS SCHED ULE REPORT ]
  389   Synonym En ter/Edit
  390   [PSS SYNON YM EDIT]
  391   Controlled  Substance s/PKI Repo rts… 
  392   [PSS CS/PK I REPORTS]
  393   DEA Spec H dlg & CS F ed Sch Dis crepancy 
  394   [PSS DEA V S CS FED.  SCH. DISCR .]
  395   Controlled  Substance s Not Matc hed to NDF  
  396   [PSS CS NO T MATCHED  TO NDF]
  397   CS (DRUGS)  Inconsist ent with D EA Spec Hd lg 
  398   [PSS CS DR UGS INCON  WITH DEA]
  399   CS (Ord. I tem) Incon sistent wi th DEA Spe c Hdlg
  400   [PSS CS (O I) INCON W ITH DEA] 
  401   Send Entir e Drug Fil e to Exter nal Interf ace
  402   [PSS MASTE R FILE ALL ]
  403   IV Additiv e/Solution  …
  404   [PSS ADDIT IVE/SOLUTI ON]
  405        IV Ad ditive Rep ort 
  406        [PSS  IV ADDITIV E REPORT]
  407        IV So lution Rep ort 
  408        
  409      [PSS IV  SOLUTION  REPORT]
  410        Mark  PreMix Sol utions 
  411       
  412      [PSS MA RK PREMIX  SOLUTIONS]
  413   Warning Bu ilder
  414   [PSS WARNI NG BUILDER ]
  415   Warning Ma pping
  416   [PSS WARNI NG MAPPING ]
  417   PEPS Servi ces…
  418   [PSS PEPS  SERVICES]
  419               Check Ven dor Databa se Link 
  420             
  421    
  422   [PSS CHECK  VENDOR DA TABASE LIN K]
  423    Check PEP S Services  Setup
  424             
  425                 [PSS CH ECK PEPS S ERVICES SE TUP]
  426   Schedule/R eschedule  Check PEPS  Interface
  427               
  428  
  429   [PSS SCHED ULE PEPS I NTERFACE C K]
  430   Print Inte rface Data  File
  431  
  432  
  433   [PSS VENDO R INTERFAC E REPORT]
  434   Inpatient  Drug Manag ement…
  435   [PSS INP M GR]
  436      ADditiv es File 
  437      [PSSJI  DRUG]
  438     Dispense  Drug Fiel ds 
  439     [PSSJU D RG]
  440     Dispense  Drug/ATC  Set Up 
  441     [PSSJU D RUG/ATC SE T UP]
  442     Edit Cos t Data 
  443     [PSSJU D CC]
  444     EDit Dru g Cost (IV
  445     [PSSJI E DIT DRUG C OST]
  446     MARk/Unm ark Dispen se Drugs F or Unit Do se 
  447     [PSSJU M ARK UD ITE MS]
  448     PRimary  Solution F ile (IV)
  449     [PSSJI S OLN]
  450   Check Drug  Interacti on
  451   [PSS CHECK  DRUG INTE RACTION]
  452   Infusion I nstruction  Managemen t …
  453   [PSS INFIN S MGR]
  454   Infusion I nstruction s Add/Edit
  455   [PSS INFIN S ADED]
  456   Infusion I nstruction  Report
  457   [PSS INFIN S RPT]
  458        Locke d: PSXCMOP MGR
  459   Without th e PSXCMOPM GR key,  X E "PSXCMOP MGR key" \ b the CMOP  Mark/Unma rk (Single  drug) XE  "CMOP Mark /Unmark (S ingle drug ) option"  \b  option  will not  appear on  your menu.
  460   Option Des criptions
  461   The option  descripti ons below  were retri eved from  VA FileMan  and provi de the PDM  options f ollowing t he initial  installat ion of the  PDM packa ge.
  462   PSS MGR Ph armacy Dat a Manageme nt   
  463   This menu  contains t he options  necessary  to build  and mainta in the PHA RMACY ORDE RABLE ITEM  file (#50 .7), and t o also bui ld and mai ntain the  Med. Route /Instructi ons table.
  464   ITEM: PSS  DRUG ENTER /EDIT                
  465   ITEM: PSS  LOOK                            
  466   ITEM: PSSJ I ELECTROL YTE FILE             
  467   ITEM: PSSX X MARK                          
  468   ITEM: PSS  SYS EDIT                        
  469   ITEM: PSS  ORDERABLE  ITEM MANAG EMENT     
  470   ITEM: PSSN FI                              
  471   ITEM: PSS  SYNONYM ED IT                   
  472   ITEM: PSS  DOSAGES MA NAGEMENT             
  473   ITEM: PSS  CS/PKI REP ORTS                 
  474   ITEM: PSS  MASTER FIL E ALL                
  475   ITEM: PSS  MEDICATION  ROUTES MG MT        
  476   ITEM: PSS  SCHEDULE M ANAGEMENT            
  477   ITEM: PSS  DRUG TEXT  MANAGEMENT           
  478   ITEM: PSS  MED INSTRU CTION MANA GEMENT    
  479   ITEM: PSS  ORDER CHEC K MANAGEME NT        
  480   ITEM: PSS  ADDITIVE/S OLUTION              
  481   ITEM: PSS  WARNING BU ILDER                
  482   ITEM: PSS  WARNING MA PPING                
  483   ITEM: PSS  PEPS SERVI CES                  
  484   ITEM: PSS  INP MGR
  485   ITEM: PSS  Check Drug  Interacti on
  486   ITEM: PSS  INFINS MGR
  487   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------  
  488   PSS DRUG E NTER/EDIT
  489   Drug Enter /Edit    
  490   This optio n allows t he user to  edit fiel ds for ALL  pharmacy  packages i f they pos sess the p roper pack age key. I t also wil l allow th e user to  match to N DF and Ord erable Ite m.
  491   TYPE: run  routine    ROUTINE: P SSDEE
  492   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  493   PSS LOOK
  494   Lookup int o Dispense  Drug File
  495   This optio n provides  a report  of all inf ormation r egarding t he dispens e drug.
  496   TYPE: run  routine    ROUTINE: P SSLOOK
  497   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  498   PSSJI ELEC TROYLYTE F ILE
  499   Electrolyt e File (IV )
  500   This optio n will all ow you to  alter the  contents o f the DRUG  ELECTORYL YTES file  (#50.4). T his is the  file that  is pointe d to by th e ELECTROL YTE field  in both th e IV ADDIT IVES (#52. 6) and IV  SOLUTIONS  (#52.7) fi les.
  501   TYPE: run  routine    ROUTINE: E LECTRO^PSS IVDRG
  502   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  503   PSSXX MARK
  504   CMOP Mark/ Unmark (Si ngle drug)
  505   This optio n allows t he user to  mark/unma rk a singl e drug for  transmiss ion to the  CMOP.  
  506   TYPE: run  routine    ROUTINE: P SSMARK                        
  507   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  508   PSS SYS ED IT
  509   Pharmacy S ystem Para meters Edi t
  510   This optio n allows t he user to  edit the  Pharmacy S ystem para meters use d in Pharm acy Data M anagement.   
  511   TYPE: run  routine    ROUTINE: P SSYSP
  512   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  513   PSS ORDERA BLE ITEM M ANAGEMENT
  514   Orderable  Item Manag ement  
  515   This is th e sub-menu  driver fo r Orderabl e Item mai ntenance.   
  516   ITEM: PSS  MAINTAIN O RDERABLE I TEMS      
  517   ITEM: PSS  EDIT ORDER ABLE ITEMS           
  518   ITEM: PSS  ORDERABLE  ITEM DOSAG ES        
  519   ITEM: PSS  INSTRUCTIO NS/ITEMS R EPORT     
  520   ITEM: PSS  ORDERABLE  ITEM REPOR T         
  521   TYPE: menu   
  522   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  523   PSSNFI
  524   Formulary  Informatio n Report
  525   This optio n provides  a listing  of pertin ent pharma cy formula ry informa tion.  
  526   TYPE: run  routine    ROUTINE: P SSNFI
  527   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  528   PSS SYNONY M EDIT
  529   Synonym En ter/Edit          
  530   The option  provides  easy acces s to updat e the syno nym inform ation for  an entry i n the loca l DRUG fil e.  
  531   TYPE: run  routine    ROUTINE: P SSSEE                         
  532   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  533   PSS DOSAGE S MANAGEME NT
  534   Dosages                      
  535   This menu  option con tains opti ons that c ontrol the  editing o f dosages.   
  536   ITEM: PSS  DOSAGE FOR M EDIT               
  537   ITEM: PSS  EDIT DOSAG ES                   
  538   ITEM: PSS  COMMON DOS AGES                 
  539   ITEM: PSS  DOSE FORM/ NOUN REPOR T         
  540   ITEM: PSS  DOSAGE REV IEW REPORT           
  541   ITEM: PSS  LOCAL POSS IBLE DOSAG ES        
  542   ITEM: PSS  DOSE UNIT  REQUEST              
  543   TYPE: menu   
  544   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  545   PSS CS/PKI  REPORTS
  546   Controlled  Substance s/PKI Repo rts
  547   PKI POST-I NSTALL REP ORTS PROVI DED AS OPT IONS.  
  548   ITEM: PSS  DEA VS CS  FED. SCH.  DISCR.    
  549   ITEM: PSS  CS NOT MAT CHED TO ND F         
  550   ITEM: PSS  CS DRUGS I NCON WITH  DEA       
  551   ITEM: PSS  CS (OI) IN CON WITH D EA        
  552   TYPE: menu   
  553   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  554   PSS MASTER  FILE ALL
  555   Send Entir e Drug Fil e to Exter nal Interf ace
  556   TYPE: run  routine    ROUTINE: P SSMSTR  
  557   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  558   PSS MEDICA TION ROUTE S MGMT
  559   Medication  Routes Ma nagement
  560   This Sub-M enu contai ns options  related t o Medicati on Routes  in both th e MEDICATI ON ROUTES  (#51.2) Fi le and the  STANDARD  MEDICATION  ROUTES (# 51.23) Fil e.
  561   ITEM: PSS  MEDICATION  ROUTES ED IT        
  562   ITEM: PSS  MED ROUTE  MAPPING RE PORT      
  563   ITEM: PSS  MED ROUTE  MAPPING CH ANGES     
  564   ITEM: PSS  MEDICATION  ROUTE REQ UEST      
  565   ITEM: PSS  DEF MED RO UTE OI RPT           
  566   TYPE: menu   
  567   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------  
  568   PSS SCHEDU LE MANAGEM ENT
  569   Standard S chedule Ma nagement
  570   This Sub-M enu contai ns options  needed fo r Schedule  maintenan ce. 
  571   ITEM: PSS  SCHEDULE E DIT                  
  572   ITEM: PSS  SCHEDULE R EPORT                
  573   TYPE: menu   
  574   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  575   PSS DRUG T EXT MANAGE MENT
  576   Drug Text  Management        
  577   This Sub-M enu contai ns options  concernin g Drug Tex t.  
  578   ITEM: PSS  EDIT TEXT                       
  579   ITEM: PSS  DRUG TEXT  FILE REPOR T         
  580   TYPE: menu   
  581   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  582   PSS MED IN STRUCTION  MANAGEMENT
  583   Medication  Instructi on Managem ent
  584   The Sub-Me nu contain s options  related to  the MEDIC ATION INST RUCTION (# 51) File.   
  585   ITEM: PSSJ U MI                            
  586   ITEM: PSS  MED INSTRU CTION REPO RT        
  587   TYPE: menu   
  588   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  589   PSS ORDER  CHECK MANA GEMENT
  590   Order Chec k Manageme nt     
  591   This is th e sub-menu  for funct ionality r elated to  managing m edication  order chec ks.  
  592   ITEM: PSS  ORDER CHEC K CHANGES            
  593   ITEM: PSS  REPORT LOC AL INTERAC TIONS     
  594   TYPE: menu   
  595   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  596   PSS ADDITI VE/SOLUTIO N
  597   IV Additiv e/Solution        
  598   This Sub-M enu contai ns options  that can  be used to  run repor ts from th e IV ADDIT IVES (#52. 6) File an d the IV S OLUTIONS ( #52.7) Fil e. It also  provides  an option  to edit th e PREMIX ( #18) Field  in the IV  SOLUTIONS  (#52.7) F ile. 
  599   ITEM: PSS  IV ADDITIV E REPORT            
  600   ITEM: PSS  IV SOLUTIO N REPORT             
  601   ITEM: PSS  MARK PREMI X SOLUTION S         
  602   TYPE: menu   
  603   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  604   PSS WARNIN G BUILDER
  605   Warning Bu ilder             
  606   This optio n will all ow you to  define a c ustom warn ing label  list conta ining entr ies from b oth the ne w warning  label sour ce and the  old Rx Co nsult file  entries. 
  607   TYPE: run  routine    ROUTINE: P SSWRNB                        
  608   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  609   PSS WARNIN G MAPPING
  610   Warning Ma pping             
  611   This optio n is used  to match a n entry fr om the old  Rx Consul t file to  the new co mmercial d ata source  warning f ile to aid  in using  the Warnin g Builder  (to identi fy local w arnings th at do not  have an eq uivalent e ntry in th e new comm ercial dat a source).  The user  can also e nter a Spa nish trans lation for  an Rx Con sult file  entry, if  desired, b ut wheneve r possible , the new  commercial  data sour ce's warni ngs (Engli sh or Span ish depend ing on the  patient s etting) sh ould be us ed.  
  612   TYPE: run  routine    ROUTINE: E DIT^PSSWMA P                  
  613   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  614   PSS PEPS S ERVICES
  615   PEPS 
  616   ITEM: PSS  CHECK VEND OR DATABAS E LINK    
  617   ITEM: PSS  CHECK PEPS  SERVICES  SETUP     
  618   ITEM: PSS  SCHEDULE P EPS INTERF ACE CK    
  619   ITEM: PSS  VENDOR INT ERFACE REP ORT       
  620   TYPE: menu   
  621   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  622   PSS INP MG R                         
  623   Inpatient  Drug Manag ement
  624   This Sub-M enu contai ns options  related t o INPATIEN T DRUG MAN AGEMENT.  
  625   ITEM: PSSJ I DRUG                          
  626   ITEM: PSSJ U DRG                           
  627   ITEM: PSSJ U DRUG/ATC  SET UP              
  628   ITEM: PSSJ U DCC                           
  629   ITEM: PSSJ I EDIT DRU G COST               
  630   ITEM: PSSJ U MARK UD  ITEMS                
  631   ITEM: PSSJ I SOLN                          
  632   TYPE: Menu
  633   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  634   PSS CHECK  DRUG INTER ACTION
  635   Check Drug  Interacti on
  636   This menu  contains o ptions per taining to  maintaini ng pharmac y
  637   data files , creating  Pharmacy  Orderable  Items, and  the Medic ation Rout e/ 
  638   Instructio ns table a mong other  assorted  functions.
  639   TYPE: run  routine RO UTINE: PSS DIUTL
  640   PSS INFINS  MGR
  641   Infusion I nstruction  Managemen t
  642   Menu conta ining opti ons relate d to the I NFUSION IN STRUCTIONS  (#53.47)  file.
  643   TYPE: menu
  644   PSS INFINS  ADED 
  645   Infusion I nstruction s Add/Edit
  646   Allows use rs to ente r and edit  abbreviat ions and e xpansions  in the INF USION INST RUCTIONS ( #53.47) fi le.
  647   TYPE: run  routine  R OUTINE: EN II^PSSFILE D
  648  
  649   PSS INFINS  RPT
  650   Infusion I nstruction s Report
  651   Provides a  report of  entries f rom the IN FUSION INS TRUCTIONS( #53.47) fi le
  652   TYPE: run  routine RO UTINE: EN^ PSSIIRPT
  653   Routines
  654   The follow ing routin es are use d by the P harmacy Da ta Managem ent packag e.
  655   PSS0052PSS 0093  PSS0 114  PSS10 2RP PSS117 EN PSS117P O PSS127PI  PSS127PTP SS129EN PS S147EN PSS 147PO PSS1 60EN PSS16 0POPSS172P OPSS1P135  PSS1P154 P SS1P23  PS S1P43  PSS 32P3PSS32P 5  PSS50     PSS50A    PSS50A1   PSS50AQM P SS50ATC PS S50B   PSS 50B1PSS50B 2  PSS50C    PSS50C1   PSS50CMP  PSS50D   P SS50DAT PS S50DOS PSS 50EPSS50F    PSS50F1   PSS50LAB  PSS50NDF P SS50P4  PS S50P66 PSS 50P7  PSS5 0P7APSS50T MP PSS50WS   PSS51     PSS51P1   PSS51P15 P SS51P1A PS S51P1B PSS 51P1CPSS51 P2  PSS51P 5  PSS51P5   PSS52P6A  PSS52P6B  PSS52P7  P SS52P7A PS S54PSS55      PSS551    PSS55MIS  PSS59P7   PSS70UTL P SS781   PS SADDIT PSS ADRPTPSSAU TL  PSSBPS UT PSSCHEN V PSSCHPRE  PSSCHPST  PSSCLDRG P SSCLINR PS SCLOZPSSCM OPE PSSCOM MN PSSCPRS   PSSCPRS1  PSSCREAT  PSSCSPD  P SSCUSRQ PS SDACSPSSDA WUT PSSDDU T  PSSDDUT 2 PSSDDUT3  PSSDEE    PSSDEE1  P SSDEE2  PS SDEEAPSSDE LOIPSSDENT   PSSDFEE   PSSDGUPD  PSSDI    P SSDIN   PS SDINT  PSS DIUTLPSSDO S PSSDOSED PSSDOSER P SSDOSLZ PS SDOSRP PSS DRINT PSSD RDOS PSSDS APA PSSDSA PD  PSSDSA PI PSSDSAP KPSSDSAPL  PSSDSAPM   PSSDSBBP   PSSDSBDA P SSDSBDB PS SDSBPA PSS DSBPB PSSD SBPCPSSDSB PD  PSSDSD AT PSSDSEX C PSSDSFDB  PSSDSONF  PSSDSPON P SSDSPOP PS SDTR   PSS EC123PSSEN V   PSSENV N  PSSFDBD I PSSFDBRT  PSSFIL     PSSFILED   PSSFILES   PSSGENM   PSSGIUPSSG MI   PSSGS 0   PSSGSG UI PSSGSH     PSSHELP   PSSHFREQ  PSSHL1    PSSHLDFSPS SHLSCHPSSH LU PSSHRCO M  PSSHREN V PSSHREQ   PSSHRIT   PSSHRPST P SSHRQ2PSSH RQ22  PSSH RQ23   PSS HRQ2O   PS SHRVAL     PSSHRVL1   PSSHTTP  P SSHUIDGPSS IIRPT PSSJ EEUPSSJORD F  PSSJSPU    PSSJSPU 0  PSSJSV     PSSJSV0    PSSJXR     PSSJXR1    PSSJXR1 0PSSJXR11   PSSJXR12P SSJXR13  P SSJXR14  P SSJXR15  P SSJXR16  P SSJXR17  P SSJXR18PSS JXR19  PSS JXR2   PSS JXR20  PSS JXR21  PSS JXR22  PSS JXR23  PSS JXR24  PSS JXR25PSSJX R26  PSSJX R27  PSSJX R28  PSSJX R29  PSSJX R3   PSSJX R30  PSSJX R31  PSSJX R32PSSJXR3 3  PSSJXR3 4  PSSJXR4    PSSJXR5    PSSJXR6    PSSJXR7    PSSJXR8    PSSJXR9 PSSLAB     SSLDALL  P SSLDEDT  P SSLDOSE  P SSLOCK   P SSLOOK   P SSMARK   P SSMATCHPSS MEDCH  PSS MEDRQ  PSS MEDRT  PSS MEDX   PSS MIRPT  PSS MONT   PSS MRTUP  PSS MRTUXPSSMS TR   PSSNC PDP PSSNDC UT  PSSNFI     PSSNFI P   PSSNOD 2   PSSNOU NR  PSSNTE G PSSOICT    PSSOICT1   PSSOIDOS   PSSOPKI    PSSOPKI1   PSSORPH    PSSORPH1   PSSORPHZ PSSORUTE   PSSORUTL   PSSORUTZ   PSSOUTSC   PSSP110    PSSP130    PSSP134    PSSPI89    PSSP203PSS PCH13PSSPK IPI PSSPKI PR  PSSPNS RP  PSSPO1 29  PSSPOI     PSSPOI C   PSSPOI D1PSSPOID2   PSSPOID3   PSSPOIDT   PSSPOIKA   PSSPOIM    PSSPOIM1   PSSPOIM2   PSSPOIM3 PSSPOIMN   PSSPOIMO   PSSPOIMP   PSSPOST    PSSPOST2   PSSPOST5   PSSPOST6   PSSPREPSSP RE38  PSSP RETR  PSSP RICEPSSPRM IX  PSSPRU TL  PSSQOC     PSSQOR D   PSSREF     PSSREM CH PSSRXAC T  PSSSCHE D  PSSSCHR P  PSSSEE     PSSTREN G  PSSTXT     PSSUNMS I  PSSUTIL    PSSUTIL 1  PSSUTIL 3PSSUTLA1   PSSUTLA2   PSSUTLAZ   PSSUTLPR   PSSUTLPZ   PSSVIDRG   PSSVX6     PSSVX61PS SVX62   PS SVX63   PS SVX64   PS SVX65   PS SVX66   PS SWMAP   PS SWRNA   PS SWRNBPSSWR NC   PSSWR NE PSSXDIC    PSSXREF     PSSXRF 1   PSSYSP Exported O ptions
  656   Stand-Alon e Options
  657   The follow ing is a l ist of all  stand-alo ne options  that are  NOT export ed as part  of the ma in PDM men u [PSS MGR ]:
  658   Other Lang uage Trans lation Set up
  659   [PSS OTHER  LANGUAGE  SETUP]
  660   Drug Inqui ry (IV) 
  661   [PSSJI DRU G INQUIRY]
  662   Electrolyt e File (IV
  663   [PSSJI ELE CTROLYTE F ILE]
  664   Enable/Dis able Vendo r Database  Link
  665   [PSS ENABL E/DISABLE  DB LINK]
  666   Add Defaul t Med Rout e
  667   [PSS ADD D EFAULT MED  ROUTE]
  668   Find Unmap ped Local  Possible D osages
  669   [PSS LOCAL  DOSAGES E DIT ALL]
  670   The Enable /Disable V endor Data base Link  option exi sts ONLY a s a way fo r technica l personne l to turn  on/off the  database  connection  if requir ed for deb ugging. No rmally, it  is enable d and the  Vendor Dat abase upda tes are pe rformed ce ntrally on  the MOCHA  Servers,  not at the  individua l sites. I t is NOT e xported as  part of t he main PD M menu [PS S MGR].
  671   In the rar e case whe re this op tion is us ed and the  database  link is di sabled, NO  drug-drug  interacti on, duplic ate therap y, or dosi ng order c hecks will  be perfor med in Pha rmacy or i n the Comp uterized P atient Rec ord System  (CPRS).
  672   Protocols
  673   NAME: PSS  EXT MFU CL IENT 
  674    DESCRIPTI ON:   This  protocol  will be us ed as the  ACK from t he externa l
  675    interface  for a MFN _M01 messa ge.  
  676   NAME: PSS  EXT MFU SE RVER 
  677    DESCRIPTI ON:   This  protocol  will be us ed to send  event not ification  and data
  678    when new  drugs are  added to t he DRUG fi le (#50) a nd when ce rtain fiel ds are 
  679    updated i n the same  file. Thi s informat ion will b e sent to  the automa ted 
  680    dispensin g machines  through H L7 V.2.4 f ormatted m essages.  
  681     
  682   NAME: PSS  HUI DRUG U PDATE 
  683    DESCRIPTI ON:   This  protocol  will be us ed to send  event not ification  and data
  684    when new  drugs are  added to t he Drug fi le (#50) a nd when ce rtain fiel ds are 
  685    updated i n same fil e.  
  686   NAME: PSS  MED ROUTE  RECEIVE
  687    DESCRIPTI ON:   This  protocol  processes  updates to  the Stand ard Medica tion
  688    Routes (# 51.23) Fil e.  
  689   Bulletins
  690   NAME: PSS  FDB INTERF ACE 
  691   SUBJECT: O RDER CHECK  DATABASE  DOWN
  692   RETENTION  DAYS: 3
  693   PRIORITY?:  YES
  694   NAME: PSS  FDB INTERF ACE RESTOR ED
  695   SUBJECT: O RDER CHECK  DATABASE  IS BACK UP
  696   RETENTION  DAYS: 3 
  697   PRIORITY?:  YES
  698   Web Server s
  699   PEPS 
  700   Web Servic es
  701   DOSING_INF O
  702   DRUG_INFO
  703   ORDER_CHEC KS
  704   Cache Clas s
  705   XMLHandler
  706   HL7 Messag ing with a n External  System
  707   A protocol , PSS HUI  DRUG UPDAT E, is expo rted and h as been cr eated to g enerate HL 7 messages  when new  drugs are  added to t he DRUG fi le (#50) a nd existin g entries  are update d. This pr otocol is  exported w ith the te xt “DELETE  ONLY TO S END DRUG U PDATE MESS AGES” in t he DISABLE  field (#2 ) of the P ROTOCOL fi le (#101).  To activa te the sen ding of th ese HL7 me ssages, th e text fro m the DISA BLE field  (#2) of th e PROTOCOL  file (#10 1) must be  deleted a nd at leas t one rece iving prot ocol added  as a subs criber. Th e drug dat a elements  included  in the HL7  message a re defined  in the fo llowing HL 7 Drug Mes sage Segme nt Definit ion table.
  708   HL7 Drug M essage Seg ment Defin ition Tabl e
  709   When the P SS HUI DRU G UPDATE p rotocol is  enabled,  the follow ing table  defines th e data ele ments sent  in each s egment of  the HL7 dr ug message .
  710   SegmentPie ceField Na meHL7 TBL  # or Data  TypeDescri ptionMSH1| STField Se parator2^~ \&STEncodi ng Charact ers3Pharma cyNo sugge sted value Sending Ap plication9 MFN0076Mes sage TypeM FI150^DRUG ^99PSD0175 Master Fil e ID3UPD01 78File-Lev el Event C ode6NE0179 Response L evel CodeM FA1MUP/MAD 0180UPDATE /ADDMFE1MU P/MAD0180U PDATE/ADD4 IEN^DRUG N AME^99PSDF ile 50 Ent ryZPA1NDCS TNational  Drug Code2 LOCAL NON- FORMULARYC EIf “1” tr ue3INACTIV E DATEDTHL 7 Format ( YYYYMMDD)4 APPLICATIO N PACKAGE  USESTUsed  by what pa ckages5MES SAGESTInfo  on drug6 D A N C
S S   FICATIONST VA Class7D EA SPECIAL  HDLGSTHow  drug is d ispense ba sed on DEA  codes8FSN ST Federal  Stock #9W ARNING LAB ELSTDrug W arnings fo r patient1 0VISN NON- FORMULARCE If ‘1’ tru eZPB1PHARM ACY ORDERA BLE ITEMCE IEN^OI tie d to dispe nse drug^P SD50.72DOS AGE FORMST IEN^Dosage  Form asso ciated wit h OI^PSD50 .6063MEDIC ATION ROUT ESTIEN^Med  Route ass ociated wi th OI^PSD5 1.24PSNDF  D A N P S O   U   T NAME ENT RYCEIEN^ D A N P S O   U   T NAMES^PS D50.685DIS PENSE UNIT STDispense  Unit for  a drug6CMO P DISPENSE CE1 or 07O P EXTERNAL  DISPENSEC E1 or 08EX PIRATION D ATEDTHL7 F ormat (YYY YMMDD)9LAB  TEST MONI TORCEIEN^L ab Test^LA B60ZPC1SPE CIMEN TYPE CEIEN^ SPE CIMEN TYPE ^LAB612MON ITOR ROUTI NESTProgra m that run s to find  lab test a nd results 3LAB MONIT OR MARKCEI f ‘1’ true 4STRENGTHN MDose of d rug5UNITCE IEN^Unit o f measure^ PSD50.6076 PRICE PER  ORDER UNIT NM7PRICE P ER DISPENS E UNITNM[{ ZPD}] 1SYN ONYMSTTrad e Name2NDC  CODESTNat ional Drug  Code3INTE NDED USECE  CE^INTENT ED USE4VSN STVendor S tock Numbe r5ORDER UN ITCEIEN^AB BREVIATION ^EXPANSION
  711   ^PSD51.56P RICE PER O RDER UNITN M7DISPENSE  UNITS PER  ORDER UNI TNM8PRICE  PER DISPEN SE UNITNM9 VENDORSTVe ndor[{ZPE} ]1ACTIVITY  LOGDTHL7  Format YYY YMMDDHHMM[ SS]-ZZZZ2R EASONCEE^E DIT3INITIA TOR OF ACT IVITYCEIEN ^NEW PERSO N^VA2004FI ELD EDITED ST5NEW VAL UEST6NDF U PDATEST[{Z PF}]1DISPE NSE UNITS  PER DOSENM 2DOSENM3PA CKAGECECE^ PACKAGE(S) 4BCMA UNIT S PER DOSE NM[{ZPG}]1 CLOZAPINE  LAB TESTCE IEN^LAB TE ST^LAB602M ONITOR MAX  DAYSNM3SP ECIMEN TYP ECEIEN^ SP ECIMEN TYP E^LAB614TY PE OF TEST CE1^WBC or  2^ANC[{ZP H}]1LOCAL  POSSIBLE D OSAGESTFRE E TEXT2PAC KAGECECE^P ACKAGE(S)3 BCMA UNITS  PER DOSEN MTwo proto cols, PSS  EXT MFU CL IENT and P SS EXT MFU  SERVER, a re exporte d and have  been crea ted to gen erate HL7  messages w hen new dr ugs are ad ded to the  DRUG file  (#50) and  existing  entries ar e updated.  These pro tocols can  only be a ctivated b y setting  the follow ing parame ters in th e OUTPATIE NT SITE fi le (#59):
  712   AUTOMATED  DISPENSE f ield (#105 ) needs to  be set to  2.4.
  713   ENABLE MAS TER FILE U PDATE fiel d (#105.2)  needs to  be set to  YES.
  714   LOGICAL LI NK field ( #2005) nee ds to be s et to PSO  DISP.
  715   DISPENSE D NS NAME fi eld (#2006 ) needs to  be set to  the dispe nsing syst em DNS nam e (for exa mple, disp ensemachin e1. DNS             ).
  716   DISPENSE D NS PORT fi eld (#2007 ) needs to  be set to  the dispe nsing syst em port nu mber.
  717   Specific T ransaction xe "Specif ic Transac tion"
  718   The Pharma cy/Treatme nt Encoded  Order Mes sage is as  follows:
  719   MFN
  720   Master Fil e Notifica tion Messa ge
  721   MSH
  722   Message He ader
  723   MFI
  724   Master Fil e Identifi er
  725   {MFE
  726   Master Fil e Entry
  727   {{ZPA}
  728   Drug File  Informatio n
  729     {RXD}
  730   Pharmacy/T reatment D ispense
  731     {OBR}}
  732  
  733   Observatio n Request
  734   }
  735   Example:
  736   MSH|~^\&|P SS VISTA|5 21~FO-BIRM .VHA URL          ~DNS|PSS D ISPENSE|~D ISPENSE1.V HA URL          :9300~DNS| 20030701|| MFN~M01~MF N_M01|1000 1|P|2.4||| AL|AL
  737   MFI|50~DRU G~99PSD||U PD|||NE
  738   MFE|MUP||| PROPANTHEL INE 15MG T AB
  739   ZPA|PROPAN THELINE 15 MG TAB|N|L FN~Local N on-Formula ry~Pharm F ormulary L isting|200 31226|Take  with food |DE200|6|P |50~6505-0 0-960-8383 ~LPS50|8~N O ALCOHOL~ LPS54|229~ Bacitracin ~LPSD50.7| 3~CAP,ORAL ~LPSD50.60 6|15~IV PU SH~LPSD51. 2|3643~ATR OPINE SO4  0.4MG TAB~ LPSD50.68| OP~OP Disp ense~99OP| 20030830|9 ~Rubella~L LAB60|72~H air of Sca lp~LLAB61| PSOCLO1|N| 100|20~MG~ LPSD50.607 |4.28&USD~ UP|15.64&U SD~UP|TAB| 2|BLUE HOU SE VENDOR| 0010-0501- 33|TRADENA ME
  740   RXD||||1|| |||1|||~P& 200&LPSD50 .0903||||| |||||||O
  741   OBR||||110 2~ACETAZOL AMIDE~LLAB 60|||||||| |||70&NECK &LLAB61||| ||||||WBC| ||7
  742   HL7 Drug M essage Seg ment Defin ition Tabl e
  743   When the P SS EXT MFU  SERVER pr otocol is  enabled, t he followi ng table d efines the  data elem ents sent  in each se gment of t he HL7 dru g message.
  744   Segments U sed in the  Master Fi le Update  Message
  745   SEGMENTSEQ #LENDTR/OR P/#TBL#ELE MENT NAMEE XAMPLEMSH1 1STRField  Separator| 24STREncod ing Charac ters~^\&31 80HDR0361S ending App licationPS S VISTA418 0HDR0362Se nding Faci lity – sta tion ID an d station  DNS name52 1~FO-BIRM URL          ~DNS5180HD R0361Recei ving Appli cationPSS  DISPENSE61 80HDR0362R eceiving F acility –  DNS name a nd port of  dispensin g machine~ DISPENSE.V HA URL          :9300~DNS7 26TSDate/T ime of Mes sage200404 0515241691 5CMR0076Me ssage Type MFN_M01102 0STRMessag e Control  ID10001113 PTR0103Pro cessing ID P123VIDR01 04Version  ID2.4152ID 0155Accept  Ack. Type AL162ID015 5Applicati on Ack Typ eALMFI1250 CER0175Mas ter File I dentifier5 0^DRUG^99P SD33IDR017 8File-Leve l Event Co deUPD62IDR 0179Respon se Level C odeNEMFE13 IDR0180Rec ord-Level  Event Code MUP4200Var iesRPrimar y Key Valu e – MFEPRO PANTHELINE  15MG TABZ PA1200Vari esRPrimary  Key Value  – ZPAPROP ANTHELINE  15MG TAB21 IDR0136Is  SynonymN32 00CERFormu lary Listi ngLFN~Loca l Non-Form ulary~Phar m Formular y Listing4 10DTOInact ive Date20 0312265200 STODrug Me ssageTake  with Food6 30STODrug  Classifica tionDE2007 10STODEA-S chedule Co de681STODE A-Drug Typ eP9100CERS tock Numbe r50~6505-0 0-960-8383 ~LPS501010 0CEOWarnin g Label8~N O ALCOHOL~ LPS5411100 CEOPharmac y Orderabl e Item229~ Bacitracin ~LPSD50.71 2100CEODos age Form3~ CAP,ORAL~L PSD50.6061 3100CEOMed ication Ro ute15~IV P USH~LPSD51 .214100CEO Drug Name  Identifier s3643~ATRO PINE SO4 0 .4MG TAB~L PSD50.6815 100CEODisp ense Flags OP~OP Disp ense~99OP1 615DTODrug  Expiratio n Date2003 083017100C EOLab Test  Monitor9~ Rubella~LL AB6018100C EOSpecimen  Type72~Ha ir of Scal p~LLAB6119 10CEOMonit or Routine PSOCLO1201 IDOLab Mon itor MarkN 2150NMOStr ength10022 250CERUnit 20~MG~LPSD 50.6072350 CPRPrice P er Order U nit4.28&US D~UP2450CP RPrice Per  Dispense  Unit15.64& USD~UP2525 STODispens e UnitTAB2 650NMODisp ense Units  Per Order  Unit22750 STOVendorB LUE HOUSE  VENDOR2812 STONDC Cod e0010-0501 -332925STO Intended U seTRADE NA MERXD420NM RActual Di spense Amo unt1820NMR Dispense N otes11210C QOTotal Da ily Dose~P &200&LPSD5 0.0903242I DRDispense  Package M ethodOOBR4 250CEOUniv ersal Serv ice Identi fier1102~A CETAZOLAMI DE~LLAB601 5300CMOSpe cimen Sour ce70&NECK& LLAB61243I DRDiagnost ic Serv Se ct IDWBC27 200TQOQuan tity/Timin g7Notes Pe rtaining t o Some of  the Data E lements:
  746   [MSH-3] Se nding Appl ication is  the stati on ID alon g with the  DNS name  of the sen ding facil ity.
  747   [MSH-5] Re ceiving Ap plication  is the DNS  name and  DNS port n umber of t he dispens ing applic ation.
  748   [MSH-10] M essage Con trol ID is  the numbe r that uni quely iden tifies the  message.  It is retu rned in MS A-2 of the  dispense  completion  message.
  749   [MFI-1] Ma ster File  Identifier  is hard-c oded to 50 ~DRUG~99PS D.
  750   [MFE-1] Re cord-Level  Event Cod e can be e ither MUP  for Update  or MAD fo r Add.
  751   [MFE-4] Pr imary Key  Value – MF E is the G ENERIC NAM E field (# .01) from  the DRUG f ile (#50).
  752   [ZPA-1] Pr imary Key  Value – ZP A will be  the generi c name of  the drug f irst and t hen all sy nonyms wil l follow i n consecut ive ZPA se gments.
  753   [ZPA-2] Is  Synonym i s set to Y  or N depe nding on w hether the  primary k ey is a sy nonym.
  754   [ZPA-3] Fo rmulary Li sting will  contain L FN and/or  VISN is th e formular y is not t o appear o n the Loca l or VISN  formulary.
  755   [ZPA-9] St ock Number  is the FS N field (# 6) from th e DRUG fil e (#50) or  the VSN f ield (#400 ) from the  SYNONYM s ubfile (#5 0.1) of th e PRESCRIP TION file  (#50).
  756   [ZPA-15] D ispense Fl ags will i ndicate if  this drug  may be di spensed to  an extern al interfa ce and if  it is mark ed to be d ispensed a t a Consol idated Out patient Ph armacy (CM OP). If bo th are yes , the answ er would b e OP~OP Di spense~Pha rm dispens e^CMOP~CMO P dispense ~Pharm dis pense flag .
  757   [ZPA-29] I ntended Us er will be  TRADE NAM E, QUICK C ODE, DRUG  ACCOUNTABI LITY or CO NTROLLED S UBSTANCES.
  758   [RXD-4] Ac tual Dispe nse Amount  is the BC MA UNITS P ER DOSE fi eld (#3) f rom the PO SSIBLE DOS AGES file  (#50.0903) .
  759   [RXD-9] Di spense Not es is the  DISPENSE U NITS PER D OSE field  (#.01) fro m the POSS IBLE DOSAG ES file (# 50.0903).
  760   [RXD-12] T otal Daily  Dose will  be either  P for Pos sible Dosa ges or LP  for Local  Possible D osages.
  761   [OBR-4] Un iversal Se rvice Iden tifier is  used for C lozapine L ab Test.
  762   [OBR-15] S pecimen So urce is us ed for Clo zapine Spe cimen Type .
  763   [OBR-24] D iagnostic  Serv Sect  ID is used  for Cloza pine Type  of Test.
  764   [OBR-27] Q uantity/Ti ming is us ed to enco de Monitor  Max days  from the C LOZAPINE L AB TEST fi le (#50.02 ).
  765   Data Archi ving and P urging
  766   There are  no archivi ng and pur ging funct ions neces sary with  this relea se of the  PDM packag e.
  767   Callable R outines/En try Points /Applicati on Program  Interface s (APIs)
  768   APIs, call able routi nes, and e ntry point s can be v iewed by f irst choos ing the DB A menu opt ion on FOR UM and the n choosing  the Integ ration Agr eements Me nu option:
  769   IAs    INT EGRATION C ONTROL REG ISTRATIONS  ...
  770   For detail ed informa tion on al l supporte d Pharmacy  Data Mana gement API s, see the  Pharmacy  Re-Enginee ring (PRE)  Applicati on Program  Interface  (API) Man ual posted  on the Vi stA Docume ntation Li brary (VDL ) HYPERLIN K "" .
  771   Medication  Routes
  772   The follow ing paragr aphs provi de an expl anation of  medicatio n route in formation.
  773   For Outpat ient Pharm acy & Inpa tient Medi cation Uni t Dose Ord ers:
  774   The Defaul t med rout e will be  returned f rom the DE FAULT MED  ROUTE fiel d (#.06) o f the PHAR MACY ORDER ABLE ITEM  file (#50. 7) if it i s populate d, or from  the POSSI BLE MED RO UTES multi ple (#50.7 11) of the  PHARMACY  ORDERABLE  ITEM file  (#50.7) if  it is pop ulated wit h a single  entry and  the USE D OSAGE FORM  MED ROUTE  LIST fiel d (#10) is  set to "N O." The me d route se lection li st will be  returned  with entri es from th e POSSIBLE  MED ROUTE S multiple  (#50.711)  if the US E DOSAGE F ORM MED RO UTE LIST f ield (#10)  is set to  "NO." Oth erwise, th e med rout es associa ted with t he orderab le item's  dosage for m, MED ROU TE FOR DOS AGE FORM m ultiple (# 50.6061) o f the DOSA GE FORM fi le (#50.60 6), will b e returned
  775   For IV Flu ids Orders :
  776   If there i s only one  orderable  item in t he IV orde r request,  the same  logic as d efined abo ve under ‘ For Outpat ient Pharm acy & Inpa tient Medi cation Uni t Dose Ord ers’ will  be used to  return th e default  med route  from the D EFAULT MED  ROUTE fie ld (#.06)  and the me d route se lection li st from th e PHARMACY  ORDERABLE  ITEM file  (#50.7).
  777   If there i s more tha n one orde rable item  on the IV  order req uest, the  PHARMACY O RDERABLE I TEM file ( #50.7) wil l be check ed for eac h orderabl e item for  the defau lt med rou te and med  route sel ection lis t as defin ed above u nder ‘For  Outpatient  Pharmacy  & Inpatien t Medicati on Unit Do se Orders. ’ If there  is a defa ult med ro ute common  with ever y orderabl e item, th at default  med route  will be r eturned. S imilarly,  the list o f possible  med route s that are  common wi th every o rderable i tem will b e returned .
  778   Administra tion Sched uling
  779   The follow ing rules  apply to a dministrat ion schedu ling.
  780   If there i s a duplic ate schedu le, and if  one of th em contain s ward-spe cific admi nistration  times for  the ward  location o f the pati ent, the s chedule re turned for  inclusion  in the ar ray of sel ectable sc hedules in  CPRS will  be the on e with the  ward-spec ific admin istration  times.
  781   If no dupl icate has  ward-speci fic admini stration t imes for t he ward lo cation of  the patien t, the sch edule with  the lowes t IEN numb er will be  returned.  If both ( or more th an one) du plicate sc hedules ha ve ward-sp ecific adm inistratio n times fo r the ward  location  of the pat ient, the  schedule w ith the lo west IEN n umber in t he ADMINIS TRATION SC HEDULE fil e #51.1 wi ll be the  schedule i n the arra y returned  to CPRS.
  782   External R elations
  783   Integratio n Agreemen ts
  784   IAs can be  viewed by  first cho osing the  DBA option  on FORUM  and then t he Integra tion Agree ments Menu  option.
  785   Example: D BA Option
  786  
  787   Select Pri mary Menu  Option: DB A
  788   Select DBA  Option: I NTEGration  Agreement s Menu
  789   Select Int egration A greements  Menu Optio n:  Custod ial Packag e Menu
  790   Select Cus todial Pac kage Menu  Option:  A CTIVE by C ustodial P ackage
  791   Select PAC KAGE NAME:  PHARMACY  DATA MANAG EMENT      PSS
  792   DEVICE: HO ME//
  793   Internal R elations
  794   All PDM op tions can  function i ndependent ly.
  795   Package-Wi de Variabl es
  796   There are  no package -wide vari ables for  this versi on.
  797   Package Re quirements
  798   The PDM mo dule relie s on, at l east, the  following  external p ackages to  run effec tively.
  799  
  800   Package
  801   Minimum ve rsion need ed
  802  
  803   National D rug File
  804   V. 4.0
  805  
  806  
  807   Outpatient  Pharmacy
  808   V. 7.0
  809  
  810  
  811   Inpatient  Medication s
  812   V. 5.0
  813  
  814  
  815   Kernel
  816   V. 8.0 
  817  
  818  
  819   VA FileMan
  820  
  821   V. 22.0 
  822  
  823   Package
  824   Minimum ve rsion need ed
  825  
  826   HealtheVet  Web Servi ces Client  (HWSC)
  827   V. 1.0
  828  
  829   VistALink
  830  
  831   V. 1.6
  832   Additional  Informati on
  833   Standards  and Conven tions Comm ittee (SAC C) Exempti ons
  834   The follow ing PSS ro utines wil l generate  errors re ported in  the XINDEX  utility f rom using  non-standa rd M synta x, due to  the need t o consume  external w eb service s.
  835   PSSFDBDI
  836   PSSFDBRT
  837   PSSHRPST
  838   PSSHTTP
  839   The follow ing waiver  permits t he use of  this non-s tandard M  syntax to  allow the  use of Cac he feature s to consu me externa l web serv ices. This  waiver is  located i n the Heal theVet Web  Services  Client (HW SC) Develo per Guide.
  840   OITIMB3355 4520 - Mig ration fro m M2J to V istA Web S ervices Cl ient (VWSC )
  841   Keywords
  842   M2J,VWSC,J 2EE
  843   Decision D ate
  844   12/1/2006
  845   Decision T ype
  846   Architectu re
  847   Decision M aking Body
  848   HPMO CCB
  849   Descriptio n
  850   On Decembe r 1, 2006,  the HPMO  Change Con trol Board  voted to  accept the  migration  of VistA  from the c urrent M2J  solution  to the Vis tA Web Ser vices Clie nt (VWSC).  This deci sion was m ade for a  number of  reasons, i n particul ar the fac t that the  existing  12-year-ol d M standa rd has bee n surpasse d by evolv ing techno logies and  can no lo nger addre ss today’s  requireme nts. Addit ionally, w e are no l onger requ ired to su pport DSM,  previousl y the prim ary VistA/ M hosting  environmen t. Today,  all sites  are standa rdized on  Caché 5.0  systems. A s such, ap provals we re granted  as follow s: Waiver  of the req uirement t o adhere t o the exis ting 1995  M standard  (that doe s not addr ess the im plementati on of web  services);  Implement ation of a n industry  standard  such as we b services  for VistA /M to J2EE  calls usi ng Caché’s  built in  HTTP and w eb service  client fe ature; Use  of VWSC a s an inter im solutio n that ens ures conti nuity of i ntegration  between V istA/M app lications  and migrat ed J2EE ap plications  as Health eVet evolv es by enab ling the c onsumption  of extern al web ser vices by l egacy Vist A applicat ions; and  Deprecatio n of the o riginal M2 J approach .
  851   Rationale
  852   This archi tectural c hange allo ws for a n umber of i mprovement s, includi ng better  scalabilit y, resilie nce, and p erformance . Deployme nt and con figuration  is far le ss complic ated for a dministrat ors, and t he APIs ca n be used  by a varie ty of clie nts rather  than sole ly M-based . It also  places res ponsibilit y for supp ort, maint enance, et c. with th e vendor r ather than  OI&T. 
  853   Record Typ e
  854   TDR
  855   State
  856   Approved
  857   Date Submi tted
  858   2/14/2007  8:37:24 AM
  859   Supporting  Documenta tion 
  860   Link
  861   Document T itle
  862   Descriptio n
  863   Date
  864   Download
  865   Migration  from M2J t o VistA We b Services  Client (V WSC) Email  Notificat ion
  866   Email noti fication a lerting of  the decis ion
  867   2/13/2007
  868   Download
  869   VWSC Archi tecture
  870   Proposed a rchitectur e view of  VWSC
  871   12/1/2006
  872   Download
  873   VWSC Propo sed View
  874   Proposed l ogical vie w of VistA  Web Servi ces Client  (VWSC)
  875   12/1/2006
  876   Cross-Refe rence Logi c to Keep  Orderable  Items Up T o Date
  877   With the i ntroductio n of PSS*1 *38, a new  process f or keeping  Orderable  Items upd ated was i mplemented . The proc ess is exp lained in  detail in  the sectio n below.
  878   Anytime sp ecific fie lds are ed ited, or a  pointer t o the PHAR MACY ORDER ABLE ITEM  file (#50. 7) changes , the Orde rable Item  (OI) must  be update d and sent  to CPRS.  Two differ ent situat ions can p recipitate  these cha nges. Both  situation s are expl ained in d etail here .
  879   The first  situation  occurs whe n a field  is edited  that can p ossibly af fect the s tatus of t he Orderab le Item, b ut no Orde rable Item  pointers  change. In  this situ ation, the  old Order able Item  is the sam e as the n ew Orderab le Item. I n these ca ses, the k ill logic  will be th e same as  the set lo gic. The k ill and se t logic wi ll simply  pass in th e Orderabl e Item to  the routin e that che cks all IV  Additives /IV Soluti ons/Dispen se Drugs m atched to  the Ordera ble Item,  does all t he necessa ry updates  (Inactiva tion date,  Supply fl ag, Non-fo rmulary, B ase, Addit ive), and  then sends  the Maste r File Upd ate to CPR S on that  Orderable  Item. This  type of u pdate occu rs when th e fields l isted belo w are edit ed.
  880   File 50:     DEA Spec ial Hdlg
  881   File 50:     Inactiva tion Date
  882   File 50:     Applicat ion Packag es’ Use
  883   File 50:     Local No n-Formular y
  884   File 50.7:  Inactivat ion Date
  885   File 52.6:  Inactivat ion Date
  886   File 52.6:  Used in I V Fluid Or der Entry
  887   File 52.7:  Inactivat ion Date
  888   File 52.7:  Used in I V Fluid Or der Entry
  889   The second  situation  occurs wh en pointer s to the P HARMACY OR DERABLE IT EM file (# 50.7) are  changed. I V Additive s, IV Solu tions and  the Dispen se Drug al ways point  to the sa me Orderab le Item. T hat Ordera ble Item i s, in turn , pointed  to by the  IV Additiv e or IV So lution. So , the fiel ds that ma y be affec ted includ e the Orde rable Item  pointer i n the DRUG  file (#50 ) and the  Generic Dr ug pointer  in the IV  ADDITIVES  file (#52 .6) and th e IV SOLUT IONS file  (#52.7).
  890   File 50:      Orderab le Item Po inter
  891   File 52.6:   Generic  Drug Point er
  892   File 52.7:   Generic  Drug Point er
  893   The initia l change i s to make  the Ordera ble Item p ointers in  the IV AD DITIVES fi le (#52.6)  and the I V SOLUTION S file (#5 2.7) unedi table. The  software  will now c ontrol tho se pointer s.
  894   Scenario 1 : The Orde rable Item  Pointer I s Changed  For A Disp ense Drug
  895   In Example  1, the Or derable It em pointer  is change d for a Di spense Dru g. In this  case, any  Orderable  Item poin ters must  be updated  for entri es in the  IV ADDITIV ES file (# 52.6) and  the IV SOL UTIONS fil e (#52.7)  that point  to that D ispense Dr ug. After  these poin ters have  been updat ed, the Or derable It em must be  updated f or the old  Orderable  Item with  what will  point to  it after t he matchin g. The Ord erable Ite m must als o be updat ed for the  new Order able Item  after the  matching.  And these  pharmacy O rderable I tem update s must be  sent to CP RS as part  of the Ma ster File  Update. To  accomplis h this, th e followin g steps mu st be comp leted: 
  896   Add a Cros s-Referenc e on the O rderable I tem pointe r in the D RUG file ( #50) that  will hard  set one Cr oss-Refere nce in the  ORDERABLE  ITEM file  (#50.7) a nd two Cro ss-Referen ces in the  DRUG file  (#50) as  follows.
  897   Orderable  Item:    ^ PS(50.7,"A 50",Ordera ble Item I EN, Dispen se Drug IE N)=""
  898   Drug file:               ^PSDRUG ("A526", D ispense Dr ug IEN, Ad ditive IEN ,)=""
  899   Drug file:               ^PSDRUG ("A527", D ispense Dr ug IEN, So lution IEN ,)=""
  900   The Ordera ble Item C ross-Refer ence allow s access t o Dispense  Drugs mat ched to an  Orderable  Item.  Th e two DRUG  file (#50 ) Cross-Re ferences a llow acces s to Solut ions and A dditives l inked to D ispense Dr ugs. An "A 50" Cross- Reference  will also  be added o n the NAME  field (#  .01) of th e PHARMACY  ORDERABLE  ITEM file  (#50.7) c ontaining  a "Quit" c ommand for  the set a nd kill lo gic for do cumentatio n purposes  only. 
  901   When the O rderable I tem pointe r of a Dis pense Drug  changes,  only one C ross-Refer ence is ne eded on th at field t o perform  the follow ing action s:
  902   Kill Logic : This com mand perfo rms a hard  kill of t he "A50" C ross-Refer ence in th e PHARMACY  ORDERABLE  ITEM file  (#50.7) f or that Di spense Dru g using ol d value (X ) and DA,  where X eq uals the O I IEN and  DA equals  the Dispen se Drug IE N. The two  DRUG file  (#50) Cro ss-Referen ces will n ot change.  
  903   After the  hard kill  is complet ed, a Mast er File Up date is pe rformed fo r the old  Orderable  Item. The  logic for  all Dispen se Drugs/I V Additive s/IV Solut ions match ed to the  Orderable  item is ex ecuted by  looping th e three Cr oss-Refere nces to fi nd all ent ries in al l three fi les matche d to the O rderable I tem. Also  in the Kil l logic, t he Orderab le Item po inter is s et to null  and the O rderable I tem pointe r Cross-Re ference is  killed fo r any IV A dditives o r IV Solut ions match ed to the  Dispense D rug.
  904   Set Logic:  Using the  New Value  (X), wher e X equals  the OI IE N, the "A5 0" Cross-R eference i s hard set  in the PH ARMACY ORD ERABLE ITE M file (#5 0.7). The  Master Fil e Update i s then per formed for  the new O rderable I tem. The l ogic for a ll Dispens e Drugs/IV  Additives /IV Soluti ons matche d to the O rderable I tem is exe cuted by l ooping on  the three  Cross-Refe rences to  find all e ntries in  all three  files matc hed to the  Orderable  Item. The  Orderable  Item poin ter and th e Orderabl e Item poi nter Cross -Reference s are then  hard set  for all IV  Additives  and IV So lutions th at have be en matched  to the Di spense Dru g with new  value (X) .
  905   Example 1:
  906   Additives/ Solution
  907  
  908   Dispense D rugs:
  909  
  910   Orderable  Item:
  911   IEN 3    p oints to = >            
  912   IEN 100     points to  =>
  913  
  914   500      
  915   IEN 4    p oints to = >            
  916   IEN 100     points to  =>
  917  
  918   500
  919   IEN 5    p oints to = >            
  920   IEN 100     points to  =>
  921  
  922   500
  923   IEN 10  po ints to =>
  924  
  925   IEN 200      points t o =>
  926  
  927   500
  928   Cross-Refe rences are :
  929  
  930   ^PS(50.7," A50",500,1 00)=""
  931   ^PS(50.7," A50",500,2 00)=""
  932   ^PSDRUG("A 526",100,3 )=""
  933  
  934   ^PSDRUG("A 526",100,4 )=""
  935  
  936   ^PSDRUG("A 526",100,5 )=""
  937   ^PSDRUG("A 527",200,1 0)=""
  938   Orderable  Item 500 i s pointed  to by Disp ense Drugs  100 and 2 00, and by  IV Additi ves 3, 4,  and 5, and  IV Soluti on 10.
  939   (If the LO CAL NON-FO RMULARY fi eld (#51)  in the DRU G file (#5 0) is edit ed, the so ftware wil l obtain t he OI poin ter 500 an d execute  the OI log ic by loop ing on 500  in the "A 50" Cross- Reference  of the PHA RMACY ORDE RABLE ITEM  file (#50 .7). As it  reference s each ent ry, the OI  logic is  executed b y looping  on the “A5 26” and “A 527” Cross -reference s on the D RUG file ( #50) befor e going to  the next  Orderable  Item point er in the  "A50" Cros s-referenc e in the P HARMACY OR DERABLE IT EM file (# 50.7). For  Example 1  above, th e software  will find  in the fi rst "A50"  Cross-Refe rence for  OI 500, Di spense Dru g 100. The  software  will then  loop throu gh all the  “A526” an d “A527” C ross-Refer ences in t he DRUG fi le (#50) t o find the  IV Additi ves 3, 4 a nd 5. In t he second  “A50” Cros s-Referenc e for OI 5 00, Dispen se Drug 20 0 is ident ified.  Th e software  will agai n loop thr ough any e xisting “A 526” and “ A527” Cros s-referenc es in the  DRUG file  (#50) to f ind IV Sol ution 10. 
  940   If the Ord erable Ite m pointer  for Dispen se Drug 10 0 is edite d from 500  to 600, t he Cross-R eference i n the DRUG  file (#50 ) the foll owing logi c will be  performed.
  941   Kill Logic
  942   Kill the C ross-Refer ence ^PS(5 0.7,"A50", 500,100) u sing DA an d old valu e (X=500),  where DA  equals the  IEN of th e Dispense  Drug and  X equals t he IEN of  the Ordera ble Item
  943   The Cross- References  would now  be as fol lows.
  944   ^PS(50.7," A50",500,2 00)=""
  945   ^PSDRUG("A 526",100,3 )=""
  946   ^PSDRUG("A 526",100,4 )=""
  947   ^PSDRUG("A 526",100,5 )=""
  948   ^PSDRUG("A 527",200,1 0)=""
  949   The ‘A50”  and “A527”  Cross-ref erences no w identify  Orderable  Item 500  to be poin ted to by  Dispense D rug 200 an d IV Solut ion 10. Th e Orderabl e Item upd ate for OI  500 is th en perform ed for Dis pense Drug  200 and I V solution  10.
  950   While stil l in the K ill logic,  the PHARM ACY ORDERA BLE ITEM f ield (#15)  in the IV  ADDITIVES  file (#52 .6) is set  to null f or IV Addi tives 3, 4 , and 5. T his action  results i n the dele tion of Cr oss-Refere nces on th e PHARMACY  ORDERABLE  ITEM fiel d (#15) of  the IV AD DITIVES fi le (#52.6) .  
  951   Set Logic
  952   The “A50”  Cross-Refe rence in t he PHARMAC Y ORDERABL E ITEM fil e (#50.7)  for the ne w Orderabl e Item 600  is set as  follows.
  953   ^PS(50.7," A50",500,2 00)=""
  954   ^PS(50.7," A50",600,1 00)=""
  955   ^PSDRUG("A 526",100,3 )=""
  956   ^PSDRUG("A 526",100,4 )=""
  957   ^PSDRUG("A 526",100,5 )=""
  958   ^PSDRUG("A 527",200,1 0)=""
  959   The Ordera ble Item l ogic is ex ecuted on  the new OI  600 by lo oping on t he "A50" C ross-Refer ence, to g et the Dis pense Drug  pointer o f 100. The  software  then loops  through a ny existin g “A526” a nd “A527”  Cross-Refe rences to  get IV Add itives 3,  4 and 5.
  960   The value  of the PHA RMACY ORDE RABLE ITEM  (#15) fie ld in the  IV ADDITIV ES file (# 52.6) for  IV Additiv es 3, 4, a nd 5 is se t to 600.  Existing C ross-Refer ences are  also set t o reflect  this chang e. 
  961   Scenario 2 : The Disp ense Drug  Pointer Is  Edited Fo r An IV Ad ditive Or  IV Solutio n
  962   If the Dis pense Drug  is change d for an I V Additive  or IV Sol ution, the  Cross-Ref erences on  the PHARM ACY ORDERA BLE ITEM f ield in th e IV ADDIT IVES file  (#52.6) an d IV SOLUT ION file ( #52.7) wil l perform  the follow ing set an d kill log ic.
  963   Kill Logic
  964   First, the  "A526" or  "A527" Cr oss-Refere nces in th e DRUG fil e (#50) wi ll be kill ed. Then,  using DA,  which is e qual to th e Orderabl e Item IEN , the soft ware will  get the ol d Orderabl e Item poi nter value  and perfo rm the Ord erable Ite m logic on  the old O rderable I tem. Subse quently, t he value i n the PHAR MACY ORDER ABLE ITEM  field for  the IV Add itive and/ or IV Solu tion will  be set to  null and t he existin g Cross-Re ferences o n this fie ld will be  killed.
  965   Set Logic
  966   First, the  "A526" or  "A527" Cr oss-Refere nces in th e DRUG fil e (#50) wi ll be set.  Then Usin g X, which  is equal  to the Dis pense Drug  IEN, the  software w ill identi fy the new  Orderable  Item in t he DRUG fi le (#50) a nd perform  the OI lo gic on tha t Orderabl e Item. Th e PHARMACY  ORDERABLE  ITEM fiel d in the I V ADDITIVE S file (#5 2.6) and I V SOLUTION  file (#52 .7) will b e set to t he new val ue and exi sting Cros s-Referenc es will be  also set.  
  967   Users can  first chec k the new  Dispense D rug, and i f the Orde rable Item  does not  change by  rematching  the Addit ive/Soluti on to the  new Dispen se Drug, t hey can ch oose the Q UIT comman d. 
  968   Example 2:
  969   IV Additiv es/IV Solu tion
  970   Dispense D rugs
  971  
  972   Orderable  Item
  973   IEN 3    p oints to = >            
  974   IEN 100     points to  =>
  975  
  976   500      
  977   IEN 4    p oints to = >           
  978   IEN 100     points to  =>
  979  
  980   500
  981   IEN 5    p oints to = >         
  982   IEN 100     points to  =>
  983  
  984   500
  985   IEN 10  po ints to =>
  986  
  987   IEN 200      points t o =>                     
  988   500
  989   Cross-Refe rences 
  990   ^PS(50.7," A50",500,1 00)=""
  991   ^PS(50.7," A50",500,2 00)=""
  992  
  993  
  994  
  995   ^PSDRUG("A 526",100,3 )=""
  996  
  997  
  998  
  999   ^PSDRUG("A 526",100,4 )=""
  1000  
  1001  
  1002  
  1003   ^PSDRUG("A 526",100,5 )=""
  1004   ^PSDRUG("A 527",200,1 0)=""
  1005   For exampl e, the USE D IN IV FL UID ORDER  ENTRY fiel d (#17) in  the IV AD DITIVES fi le (#52.6)  for IV Ad ditive 3 c ould be ed ited. The  Orderable  Item that  the IV Add itive poin ts to in t his case,  is 500. Bo th the Kil l and Set  logic (sam e logic) f or the OI  500 is upd ated by lo oping thro ugh the "A 50" Cross- Reference  in the PHA RMACY ORDE RABLE ITEM  file (#50 .7), findi ng each Di spense Dru g IEN, and  going thr ough the " A526" and   "A527" Cr oss-Refere nces in th e DRUG fil e (#50) fo r that Dis pense Drug . This pro cess is th en repeate d for the  next Dispe nse drug i dentified  in the “A5 0” Cross-R eference 
  1006   If the DRU G file (#5 0) pointer  for IV Ad ditive 3 w ere change d from Dis pense Drug  100 to Di spense Dru g 900, the  Cross-Ref erence on  the Dispen se Drug Po inter woul d be kille d.
  1007   Kill Logic
  1008   Using old  value of X , which eq uals the D ispense Dr ug 100 and  DA, which  equals th e IV ADDIT IVE 3, the  software  would kill  Cross-Ref erence  ^P SDRUG("A52 6",100,3)  with the f ollowing C ross-Refer ences rema ining. 
  1009  
  1010  
  1011  
  1012   ^PS(50.7," A50",500,1 00)=""
  1013   ^PS(50.7," A50",500,2 00)=""
  1014  
  1015  
  1016  
  1017   ^PSDRUG("A 526",100,4 )=""
  1018  
  1019  
  1020  
  1021   ^PSDRUG("A 526",100,5 )=""
  1022    
  1023  
  1024  
  1025   ^PSDRUG("A 527",200,1 0)=""
  1026   Using DA,  the softwa re would g et the old  Orderable  Item poin ter of 500  and execu te the Ord erable Ite m logic fo r Dispense  Drugs 100 , IV Addit ives 4 and  5, Dispen se Drug 20 0, and IV  Solution 1 0.
  1027   The value  for the PH ARMACY ORD ERABLE ITE M field (# 15) in the  IV ADDITI VES file ( #52.6) wou ld be set  to null an d Cross-Re ferences o n this fie ld would b e deleted.  
  1028   Set Logic
  1029   Using new  value X, w here X equ als the Di spense Dru g 900, the  software  would set  the new "A 526" Cross  Reference  as ^PSDRU G("A526",9 00,3)="",  The update d Cross-Re ferences a re as foll ows 
  1030  
  1031  
  1032  
  1033   ^PS(50.7," A50",500,1 00)=""
  1034   ^PS(50.7," A50",500,2 00)=""
  1035  
  1036  
  1037  
  1038   ^PSDRUG("A 526",100,4 )=""
  1039  
  1040  
  1041  
  1042   ^PSDRUG("A 526",100,5 )=""
  1043   ^PSDRUG("A 526",900,3 )=""
  1044    
  1045  
  1046  
  1047   ^PSDRUG("A 527",200,1 0)=""
  1048   Using new  value of X , where X  equals the  Dispense  Drug 900,  the softwa re gets th e Orderabl e Item poi nter for D ispense Dr ug 900, in  this exam ple, Order able Item  2000. The  applicable  Cross-Ref erences wo uld be the  following .
  1049  
  1050  
  1051  
  1052   ^PS(50.7," A50",500,1 00)=""
  1053   ^PS(50.7," A50",500,2 00)=""
  1054   ^PS(50.7," A50",2000, 900)=""
  1055  
  1056  
  1057  
  1058   ^PSDRUG("A 526",100,4 )=""
  1059  
  1060  
  1061  
  1062   ^PSDRUG("A 526",100,5 )=""
  1063   ^PSDRUG("A 526",900,3 )=""
  1064    
  1065  
  1066  
  1067   ^PSDRUG("A 527",200,1 0)=""
  1068   The softwa re perform s the OI u pdate for  Orderable  Item 2000,  with Disp ense Drug  900 and IV  Additive  3. The PHA RMACY ORDE RABLE ITEM  field (#1 5) value i n the IV A DDITIVES f ile (#52.6 ) is set t o 2000. Th e correspo nding Cros s-Referenc es on this  field are  also set.
  1069   Security M anagement
  1070   The PDM pa ckage does  not conta in any VA  FileMan se curity cod es except  for progra mmer secur ity (@) on  the data  dictionari es for the  PDM files . Security  with resp ect to sta ndard opti ons in the  module is  implement ed by care fully assi gning opti ons to use rs and by  the use of  security  keys.
  1071   Mail Group
  1072   Patch PSS* 1*147 crea tes a new  mail group  called PS S ORDER CH ECKS. The  mail group  descripti on below w as retriev ed from VA  FileMan.  The IRM Ph armacy sup port and P harmacy AD PACs (and  backups) s hould at a  minimum b e added to  this mail  group.
  1073   NAME: PSS  ORDER CHEC KS                   
  1074   TYPE: publ ic
  1075   DESCRIPTIO N:   Membe rs of this  mail grou p will rec eive vario us notific ations
  1076   that impac t Enhanced  Order Che cks (drug- drug inter actions, d uplicate t herapy
  1077   and dosing  checks) i ntroduced  with PRE V . 0.5 util izing a CO TS databas e.  
  1078   Alerts
  1079   There are  no alerts  in the PDM  package.
  1080   Bulletins
  1081   Bulletins  are 'Super ' messages . Each Bul letin has  a text and  a subject  just like  a normal  message. B ut embedde d within e ither the  subject or  the text  can be var iable fiel ds that ca n be fille d in with  parameters . There is  also a st andard set  of recipi ents in th e form of  a Mail Gro up that is  associate d with the  bulletin.
  1082   Bulletins  are proces sed by Mai lMan eithe r because  of either  a special  type of cr oss refere nce or a d irect call  in a rout ine. The i nterface f or the dir ect call i s describe d in the d ocumentati on on prog rammer ent ry points.  FileMan s ets up cod e that wil l issue a  bulletin a utomatical ly when th e special  cross refe rence type  is create d.  In eit her case t he paramet ers that g o into the  text and/ or the sub ject make  each bulle tin unique .
  1083   NAME: PSS  FDB INTERF ACE 
  1084   SUBJECT: O RDER CHECK  DATABASE  DOWN
  1085   RETENTION  DAYS: 3
  1086   PRIORITY?:  YES
  1087   NAME: PSS  FDB INTERF ACE RESTOR ED
  1088   SUBJECT: O RDER CHECK  DATABASE  IS BACK UP
  1089   RETENTION  DAYS: 3 
  1090   PRIORITY?:  YES
  1091   Remote Sys tems
  1092   PDM does n ot transmi t data to  any remote  system or  facility.  
  1093   Archiving/ Purging
  1094   There are  no archivi ng and pur ging funct ions neces sary with  the PDM pa ckage.
  1095   Contingenc y Planning
  1096   Sites util izing the  PDM packag e should d evelop a l ocal conti ngency pla n to be us ed in the  event of p roduct pro blems in a  live envi ronment. T he facilit y continge ncy plan m ust identi fy the pro cedure for  maintaini ng functio nality pro vided by t his packag e in the e vent of sy stem outag e. Field s tation Inf ormation S ecurity Of ficers (IS Os) may ob tain assis tance from  their Reg ional Info rmation Se curity Off icer (RISO ).
  1097   Interfacin g
  1098   There are  no special ized produ cts embedd ed within  or require d by the P DM package .
  1099   Electronic  Signature s
  1100   No electro nic signat ures are u tilized in  the PDM p ackage.
  1101   Locked Men u Options
  1102   This secti on relates  only to o ptions tha t are lock ed. For a  complete l isting of  The PDM op tions list ed in the  PSS MGR Me nu structu re, refer  to the Men u/Options  section of  this docu ment.
  1103        Locke d: PSXCMOP MGR
  1104   Without th e PSXCMOPM GR keyxe " PSXCMOPMGR  key", the  CMOP Mark /Unmark (S ingle drug ) option w ill not ap pear on yo ur menu.
  1105   Security K eys
  1106   The PSS OR DER CHECKS  security  key is use d to contr ol access  to the Ena ble/Disabl e Dosing O rder Check s [PSS DOS ING ORDER  CHECKS] op tion.
  1107   In order t o mark or  edit packa ge specifi c fields i n a DRUG f ile (#50)  entry, the  user must  hold the  correspond ing packag e key. The  keys are  assigned f or the ind ividual pa ckages. PD M does not  export an y of these  keys.
  1108  
  1109        Packa ge
  1110   Keys
  1111   Outpatient  Pharmacy
  1112   PSORPH
  1113   Inpatient  Medication s
  1114   PSJU MGR
  1115   Inpatient  Medication s
  1116   PSJI MGR
  1117   Automatic  Replenishm ent/Ward S tock 
  1118   PSGWMGR
  1119   Drug Accou ntability/ Inventory  Interface
  1120   PSAMGR
  1121   Drug Accou ntability/ Inventory  Interface
  1122   PSA ORDERS
  1123   Controlled  Substance
  1124   PSDMGR
  1125   National D rug File 
  1126   PSNMGR
  1127   Consolidat ed Mail Ou tpatient P harmacy 
  1128   PSXCMOPMGR
  1129   Patch PSS* 1*147 expo rts the fo llowing fo ur securit y keys, th at will be  used by t he Pharmac y Enterpri se Customi zation Sys tem (PECS)  applicati on. Only a  few users  who will  be granted  access to  the PECS  applicatio n will nee d one or m ore keys a ssigned ba sed on the ir role. A ssignment  of these k eys should  be by req uest only.  The secur ity key de scriptions  were retr ieved from  VA FileMa n. 
  1130   NAME: PSS_ CUSTOM_TAB LES_ADMIN            
  1131   DESCRIPTIV E NAME: AD MINISTRATO R
  1132   DESCRIPTIO N:   This  key is use d by the P harmacy En terprise C ustomizati on System  (PECS) web  applicati on. Holder s of this  key will h ave the ab ility to p erform con figuration  and admin istrative  tasks for  the applic ation. The y will als o have que rying capa bilities.   
  1133   NAME: PSS_ CUSTOM_TAB LES_APPROV ER        
  1134   DESCRIPTIV E NAME: AP PROVER
  1135   DESCRIPTIO N:   This  key is use d by the P harmacy En terprise C ustomizati on System  (PECS) web  applicati on.  Holde rs of this  key will  have the s ame privil eges as th ose with t he PSS CUS TOM TABLES  REQUESTOR  key. Addi tional cap abilities  will be to  review, a pprove, de lete or re ject custo mization r equests an d to view  and genera te reports .  
  1136   NAME: PSS_ CUSTOM_TAB LES_REL_MA N         
  1137   DESCRIPTIV E NAME: RE LEASE MANA GER
  1138   DESCRIPTIO N:   This  key is use d by the P harmacy En terprise C ustomizati on System  (PECS) web  applicati on. Holder s of this  key will h ave the ab ility to c reate file  updates f or FDB dat abase tabl es to be a pplied at  local faci lities. Th ey will al so have qu erying cap abilities.   
  1139   NAME: PSS_ CUSTOM_TAB LES_REQUES TOR       
  1140   DESCRIPTIV E NAME: RE QUESTOR
  1141   DESCRIPTIO N:   This  key is use d by the P harmacy En terprise C ustomizati on System  (PECS) web  applicati on.  Holde rs of this  key will  be allowed  to enter  customizat ion reques ts, displa y and view  the statu s of their  own reque sts. They  will also  have limit ed queryin g capabili ties
  1142   Five secur ity keys w ere introd uced with  Patch PSS* 1*167 that  will be u sed to aut henticate  users acce ssing the  Pharmacy P roduct Sys tem-Nation al (PPS-N)  using Ker nel Authen tication a nd Authori zation for  J2EE (KAA JEE).  Use rs requiri ng access  to the Pha rmacy Prod uct System -National  should be  assigned t hese keys  as appropr iate to th eir level  of approve d access.   PPS-N is  a reengine ered produ ct that wi ll replace  the Natio nal Drug F ile Manage ment Syste m (NDFMS).   Site use rs may be  assigned t he PSS_PPS N_VIEWER k ey only.   The other  four secur ity keys a re only to  be assign ed to memb ers of the  National  NDF Manage ment Group .
  1143   NAME: PSS_ PPSN_MANAG ER
  1144   DESCRIPTIV E NAME: PP S-National  Manager
  1145   DESCRIPTIO N:   This  role can p erform the  operation al functio ns in PPS- N but does n't have t he adminis trative ri ghts of th e PPS-N Na tional Sup ervisor.
  1146   NAME: PSS_ PPSN_MIGRA TOR
  1147   DESCRIPTIV E NAME: PP S-National  Migration  User
  1148   DESCRIPTIO N:   This  role has t he ability  to run th e PPS-N Mi gration.
  1149   NAME: PSS_ PPSN_SECON D_APPROVER
  1150   DESCRIPTIV E NAME: PP S-National  Second Ap prover
  1151   DESCRIPTIO N:   This  role has t he ability  to do a s econd appr oval on it ems that a re in the  pending se cond appro val state.
  1152   NAME: PSS_ PPSN_SUPER VISOR
  1153   DESCRIPTIV E NAME: PP S-National  Superviso r
  1154   DESCRIPTIO N:   This  role has t he ability  to perfor m all acti ons in the  PPS-N app lication,  including  Administra tion and C onfigurati on.
  1155   NAME: PSS_ PPSN_VIEWE R
  1156   DESCRIPTIV E NAME: PP S-National  Viewer
  1157   DESCRIPTIO N:   This  role has t he ability  to log in  and view  items in t he PPS-N A pplication  but canno t modify a ny of the  items.
  1158   File Secur ity
  1159   Informatio n about al l files, i ncluding t hese, can  be obtaine d by using  the VA Fi leMan to g enerate a  list of fi le attribu tes.
  1160   PDM Files
  1161   File 
  1162   NumbersFil e NamesDDR DWRDELLAYG O50
  1163   DRUG
  1164   @50.4
  1165   DRUG ELECT ROLYTES
  1166   @50.606
  1167   DOSAGE FOR M
  1168   @
  1169  
  1170   @
  1171   @
  1172   @50.7
  1173   PHARMACY O RDERABLE I TEM
  1174   @51
  1175   MEDICATION  INSTRUCTI ON
  1176   @51.1
  1177   ADMINISTRA TION SCHED ULE
  1178   @51.2
  1179   MEDICATION  ROUTES
  1180   @51.23
  1181   STANDARD M EDICATION  ROUTES
  1182   @
  1183   Pp
  1184   @
  1185   @
  1186   @51.24
  1187   DOSE UNIT
  1188   @
  1189   Pp
  1190   @
  1191   @
  1192   @51.5
  1193   ORDER UNIT
  1194   51.7
  1195   DRUG TEXT
  1196   @52.6
  1197   IV ADDITIV ES
  1198   @52.7
  1199   IV SOLUTIO NS
  1200   @53.47
  1201   INFUSION I NSTRUCTION S
  1202   54
  1203   RX CONSULT
  1204   55
  1205   PHARMACY P ATIENT (Pa rtial DD)
  1206   @
  1207   P59.7
  1208   PHARMACY S YSTEM
  1209   ^
  1210  
  1211   ^
  1212  
  1213   ^59.73
  1214   VENDOR DIS ABLE/ENABL
  1215   @
  1216   @
  1217   @
  1218   @
  1219   @
  1220   59.74
  1221   VENDOR INT ERFACE DAT A
  1222   @
  1223   @
  1224   @
  1225   @
  1226   @
  1227   Non-PDM Fi les
  1228   File 
  1229   NumbersFil e NamesDDR DWRDELLAYG O200          NEW PER SON (Parti al DD)                   #       #       #      #       #9009032. 3   APSP I NTERVENTIO N TYPE                9009032.4    APSP INT ERVENTION                     90 09032.5    APSP INTER VENTION RE COMMENDATI ON    
  1230   Please ref er to the  "Sending S ecurity Co des." sect ion of the  Kernel V.  8.0 Syste ms Manual  for more i nformation  concernin g installa tion of se curity cod es.
  1231   References
  1232   There are  no regulat ions or di rectives r elated to  the Pharma cy Data Ma nagement p ackage. Ad ditional m anuals rel ated to th e Pharmacy  Data Mana gement pac kage can b e found at  the VistA  Documenta tion Libra ry (VDL) o n the Inte rnet.
  1233   Appendix A : Pharmacy  Interface  Automatio n
  1234    REF Bulle tins_p32a  \h 
  1235  
  1236  
  1237    REF Bulle tins_p32a  \h 
  1238  
  1239  
  1240    REF Bulle tins_p32a  \h 
  1241   Introducti on
  1242   This appen dix provid es a brief  descripti on of the  new featur es and fun ctions of  the Pharma cy Interfa ce Automat ion projec t. This pr ojects con sist of mu ltiple pat ches, whic h must be  installed  for the fu nctionalit y to perfo rm. 
  1243   The Clinic al Ancilla ry Service s (CAS) De velopment  Delivery o f Pharmacy  enhanceme nts (DDPE)  Pharmacy  Interface  Automation  project s upports th e initiati ve to crea te an auto mated inte rface betw een the Ph armacy Aut omated Dis pensing Eq uipment (P ADE) used  in the inp atient and  outpatien t care set tings and  VistA Phar macy and A dmission D ischarge T ransfer (A DT) applic ations. Th is will al low VA hea lth care u sers the a bility to  access, tr ansmit, re ceive aler ts, and ge nerate rep orts on me dication t ransaction s. 
  1244   Pharmacy I nterface A utomation  is a vital  enhanceme nt to the  medication  transacti on functio ns of the  PADE.  It  allows pha rmacists t o access d ispensing  equipment  remotely;  keep a per petual inv entory of  all medica tion recei ved, dispe nsed, and  wasted; al ert the ph armacy of  medication  removed f rom the de vices with out orders ; and esta blishes mo nitors for  potential ly inappro priate ele ctronic ph armacy tra nsactions.  
  1245   This produ ct shall r un on stan dard hardw are platfo rms used b y the Depa rtment of  Veterans A ffairs (VA ) Healthca re facilit ies. 
  1246   The minimu m required  VistA sof tware is:
  1247   PackageMin imum Versi on NeededA dverse Rea ction Trac king (ART) 4.0BCMA3.0 Computeriz ed Patient  Record Sy stem (CPRS )3.0Contro lled Subst ance3.0Dru g Accounta bility3.0V A FileMan2 2.0HL72.4I npatient M edications  (IP)5.0Ke rnel8.0Mai lMan7.1Mas ter Patien t Index/Pa tient Demo graphics ( MPI/PD)1.0 National D rug File ( NDF)4.0Nur sing Servi ce4.0Order  Entry/Res ults Repor ting (OERR )3.0Regist ration5.3P harmacy Da ta Managem ent (PDM)1 .0Remote P rocedure C all (RPC)  Broker1.1S cheduling5 .3New Func tionality
  1248   A new auto mated bidi rectional  interface  between Vi stA and PA DE has bee n designed  and devel oped utili zing VIE a s the midd leware com ponent for  communica tion of HL 7 messages  and error  handling.   The adde d function al compone nts are:
  1249   Provide ph armacists  the capabi lity to re motely acc ess dispen sing equip ment to pr ovide the  pharmacist  the statu s of drugs :  whether  they have  been disp ensed, or  in the que ue or some  error con dition tha t may have  been enco untered by  the dispe nsing equi pment.
  1250   Provide PA DE the cap ability to  transmit  dispensing  informati on to Vist A Pharmacy  to keep a  perpetual  inventory  of all dr ugs/medica tions rece ived, disp ensed, and  wasted.
  1251   Provide PA DE the cap ability to  alert Vis tA Pharmac y of medic ation remo val from P ADE withou t orders.
  1252   Establish  monitors o f all pote ntially in appropriat e electron ic pharmac y transact ions.  Imp lement tre nding repo rts in ord er to addr ess and de tect poten tially ina ppropriate  pharmacy  transactio ns, such a s drug div ersion.  F or example , reports  include th e ability  to sort tr ansactions  by nursin g, user, d rug, etc.,  and from  the VA-sid e of the i nterface.
  1253   Refer to t he followi ng Pharmac y Interfac e Automati on documen ts for add itional in formation:
  1254   (will add  hyperlinks  once thes e are in f inal folde r or on TS PR)
  1255   Pharmacy I nterface A utomation  Installati on Guide
  1256   Pharmcy In terface Au tomation U ser Guide
  1257   Pharmacy I nterface A utomation  System Des ign Docume nt
  1258   Pharmacy I nterface A utomation  Data Dicti onary
  1259   Options an d Build Co mponents 
  1260   The follow ing are th e options  and build  components  for Pharm acy Interf ace Automa tion for P SS*1.0*193 :
  1261   Select OPT ION NAME:     XPD PRI NT BUILD      Build F ile Print
  1262   Build File  Print
  1263   Select BUI LD NAME: P SS*1.0*193        PHA RMACY DATA  MANAGEMEN T
  1264   DEVICE: HO ME// ;;999 99  SSH VI RTUAL TERM INAL
  1265   PACKAGE: P SS*1.0*193      Nov 2 5, 2015 10 :27 am                              PAGE 1
  1266   ---------- ---------- ---------- ---------- ---------- ---------- ---------- ---------
  1267   TYPE: SING LE PACKAGE                                   TRACK NAT IONALLY: Y ES
  1268   NATIONAL P ACKAGE: PH ARMACY DAT A MANAGEME NT       A LPHA/BETA  TESTING: N O
  1269   As part of  this patc h PSS*1*19 3, the fol lowing enh ancements  were made:
  1270   Two new pr otocols PS S MFNM01 C LIENT and  PSS MFNM01  SERVER we re added t o facilita te sending  MFN HL7 d rug messag es to PADE .
  1271   The Send E ntire Drug  File to E xternal In terface [P SS MASTER  FILE ALL]   option wa s modified  to allow  transmissi on of the  drug file  to an Inpa tient Inte rface (PAD E) dependi ng on the  PADE setup . It also  provides t he flexibi lity of se nding all  drugs mark ed for Uni t Dose, IV  or Ward S tock or se nd selecte d drugs to  PADE.
  1272   Since this  option no w allows t o send all  or select ed drugs t o PADE, th e option n ame "Send  Entire Dru g File to  External I nterface"  was change d   to "Se nd Drug Fi le Entries  to Extern al Interfa ce"
  1273   A new PSS  PADE INIT  security k ey was add ed so that  holders o f this key  can only  send "all"  drugs to  PADE noted  in item 2 .
  1274   Option Dru g Enter/Ed it [PSS DR UG ENTER/E DIT] was m odified to  send an a ddition/up date/both  or none to  PADE prov ided it is  setup to  receive su ch updates .
  1275   ENVIRONMEN T CHECK:                                  D ELETE ENV  ROUTINE: 
  1276    PRE-INIT  ROUTINE:                             DELETE  PRE-INIT  ROUTINE: 
  1277   POST-INIT  ROUTINE:                            DELETE  POST-INIT  ROUTINE: 
  1278   PRE-TRANSP ORT RTN: 
  1279   ROUTINE:                                           ACT ION:
  1280      PSSDEE                                              SEND TO SI TE
  1281      PSSHLDF S                                           SEND TO SI TE
  1282      PSSMSTR                                             SEND TO SI TE
  1283   OPTION:                                            ACT ION:
  1284      PSS MAS TER FILE A LL                               SEND TO SI TE
  1285   SECURITY K EY:                                     ACT ION:
  1286      PSS PAD E INIT                                      SEND TO SI TE
  1287   PROTOCOL:                                          ACT ION:
  1288      PSS MFN M01 CLIENT                                  SEND TO SI TE
  1289      PSS MFN M01 SERVER                                  SEND TO SI TE
  1290   REQUIRED B UILDS:                                  ACT ION:
  1291      PSS*1.0 *180                                        Don't inst all, leave  global
  1292   CDEVISC1A2 :DVA>
  1293   Modified a nd New Rou tines
  1294   The follow ing routin es are for  PSS*1*193 :
  1295   PSSDEE  
  1296   PSSHLDFS
  1297   PSSMSTR
  1298   (This page  included  for two-si ded copyin g.)
  1299   Glossary
  1300   Administra tion Sched ule FileTh e ADMINIST RATION SCH EDULE file  (#51.1) c ontains ad ministrati on schedul e names an d standard  dosage ad ministrati on times.  The name i s a common  abbreviat ion for an  administr ation sche dule (e.g. , QID, Q4H , PRN). Th e administ ration tim e is enter ed in mili tary time. CPRS A Vis tA compute r software  package c alled Comp uterized P atient Rec ord System . CPRS is  an applica tion in Vi stA that a llows the  user to en ter all ne cessary or ders for a  patient i n differen t packages  from a si ngle appli cation. DA TUPFunctio nality tha t allows t he Pharmac y Enterpri se Customi zation Sys tem (PECS)  to send o ut custom  and standa rd commerc ial-off-th e-shelf (C OTS) vendo r database  changes t o update t he two cen tralized d atabases a t Austin a nd Martins burg.Dispe nse DrugTh e Dispense  Drug is p ulled from  DRUG file  (#50) and  usually h as the str ength atta ched to it  (e.g., Ac etaminophe n 325 mg).  Usually,  the name a lone witho ut a stren gth attach ed is the  Pharmacy O rderable I tem name.D osage Form  FileThe D OSAGE FORM  file (#50 .606) cont ains all d osage form s and asso ciated dat a that are  used by P harmacy pa ckages and  CPRS. The  dosage fo rm is used  in SIG co nstruction , default  values and  in the de terminatio n of the t ype of eac h dosage c reated for  each appl ication.Do se Unit Fi leThe DOSE  UNIT file  (#51.24)  was create d to accom plish the  mapping to  First Dat aBank (FDB ). All ent ries in th is file ha ve been ma pped to an  FDB Dose  Unit. Alth ough this  file has n ot yet bee n standard ized by St andards an d Terminol ogy Servic es (SRS),  no local e diting wil l be allow ed. When p opulating  the Dose U nit field  for a Loca l Possible  Dosage, s election w ill be fro m this new  file.Drug  Electroly tes FileTh e DRUG ELE CTROLYTES  file (#50. 4) contain s the name s of anion s/cations,  and their  cations a nd concent ration uni ts.Drug Fi leThe DRUG  file (#50 ) holds th e informat ion relate d to each  drug that  can be use d to fill  a prescrip tion or me dication o rder. It i s pointed  to from se veral othe r files an d should b e handled  carefully,  usually o nly by spe cial indiv iduals in  the Pharma cy Service . Entries  are not ty pically de leted, but  rather ma de inactiv e by enter ing an ina ctive date .Drug Text  FileThe D RUG TEXT f ile (#51.7 ) stores r apidly cha nging drug  restricti ons, guide lines, and  protocols  to help a ssure medi cations ar e being us ed accordi ng to defi ned specif ications.I nfusion In structions  FileThe I NFUSION IN STRUCTIONS  file (#53 .47) holds  abbreviat ions used  when enter ing the In fustion Ra te (#.08)  field in t he IV (#10 0) multipl e of the P HARMACY PA TIENT (#55 ) FILE, AN D THE infu sion rate  (#59) FIEL D IN THE n on-verifie d orders ( #53.1) fil e. Each re cord holds  an expans ion of the  abbreviat ion which  replaces t he abbrevi ation in t he Infusio n Rate at  the time t he IV orde r is creat ed.IV Addi tives File The IV ADD ITIVES fil e (#52.6)  contains d rugs that  are used a s Additive s in the I V room. Da ta entered  includes  drug gener ic name, p rint name,  drug info rmation, s ynonym(s),  dispensin g units, c ost per un it, days f or IV orde r, usual I V schedule , administ ration tim es, electr olytes, an d quick co de informa tion.IV So lutions Fi leThe IV S OLUTIONS f ile (#52.7 ) contains  drugs tha t are used  as primar y solution s in the I V room. Th e solution  must alre ady exist  in the Dru g file (#5 0) to be s elected. D ata in thi s file inc ludes: dru g generic  name, prin t name, st atus, drug  informati on, synony m(s), volu me, and el ectrolytes .Local Pos sible Dosa gesLocal P ossible Do sages are  free text  dosages th at are ass ociated wi th drugs t hat do not  meet all  of the cri teria for  Possible D osages.Med ication In struction  FileThe ME DICATION I NSTRUCTION  file (#51 ) is used  by Unit Do se and Out patient Ph armacy. It  contains  the medica tion instr uction nam e, expansi on and int ended use. Medication  Routes Fi leThe MEDI CATION ROU TES file ( #51.2) con tains medi cation rou te names.  The user c an enter a n abbrevia tion for e ach route  to be used  at their  site. The  abbreviati on will mo st likely  be the Lat in abbrevi ation for  the term.M edication  Routes/Abb reviations The Medica tion Route S file (#5 1.2) conta ins the me dication r outes and  abbreviati ons, which  are selec ted by eac h Departme nt of Vete rans Affai rs Medical  Centers ( VAMC). The  abbreviat ion cannot  be longer  than five  character s to fit o n labels a nd the Med ical Admin istration  Record (MA R). The us er can add  new route s and abbr eviations  as appropr iate.MOCHA Medication  Order Che ck Healthc are Applic ation. Nat ional Drug  FileThe N ational Dr ug File pr ovides sta ndardizati on of the  local drug  files in  all VA med ical facil ities. Sta ndardizati on include s the adop tion of ne w drug nom enclature  and drug c lassificat ion and li nks the lo cal drug f ile entrie s to data  in the Nat ional Drug  File. For  drugs app roved by t he Food an d Drug Adm inistratio n (FDA), V A medical  facilities  have acce ss to info rmation co ncerning d osage form , strength  and unit;  package s ize and ty pe; manufa cturer’s t rade name;  and Natio nal Drug C ode (NDC).  The NDF s oftware la ys the fou ndation fo r sharing  prescripti on informa tion among  medical f acilities. Non-Formul ary DrugsD rugs that  are not av ailable fo r use by a ll provide rs.Orderab le ItemAn  Orderable  Item is pu lled from  the PHARMA CY ORDERAB LE ITEM fi le (#50.7)  and usual ly has no  strength a ttached to  it (e.g.,  Acetamino phen). The  name, wit h a streng th attache d, is the  Dispense D rug name ( e.g., Acet aminophen  325mg).Ord erable Ite m FileThe  ORDERABLE  ITEM file  (#101.43)  is a CPRS  file that  provides t he Orderab le Items f or selecti on within  CPRS. Phar macy Order able Items  are a sub set of thi s file.PEC SPharmacy  Enterprise  Customiza tion Syste m. A Graph ical User  Interface  (GUI) web- based appl ication us ed to rese arch, upda te via DAT UP, mainta in, and re port VA cu stomizatio ns of the  commercial -off-the-s helf (COTS ) vendor d atabase us ed to perf orm Pharma cy order c hecks such  as drug-d rug intera ctions, du plicate th erapy, and  dosing. P EPSPharmac y Enterpri se Product  Services.  A suite o f services  that incl udes Outpa tient and  Inpatient  services.P ending Ord erA pendin g order is  one that  has been e ntered by  a provider  through C PRS withou t Pharmacy  finishing  the order . Once Pha rmacy has  finished ( and verifi ed for Uni t Dose onl y) the ord er, it wil l become a ctive.Phar macy Order able ItemT he Pharmac y Orderabl e Item is  used throu gh CPRS to  order Inp atient Med ications a nd Outpati ent Pharma cy prescri ptions.Pha rmacy Orde rable Item  FileThe P HARMACY OR DERABLE IT EM file (# 50.7) cont ains the O rder Entry  name for  items that  can be or dered in t he Inpatie nt Medicat ions and O utpatient  Pharmacy p ackages.Po ssible Dos agesDosage s that hav e a numeri c dosage a nd numeric  Dispense  Units Per  Dose appro priate for  administr ation.    For a drug  to have p ossible do sages, it  must be a  single ing redient pr oduct that  is matche d to  D A N P S O   U   T file (#5 0.68).    The  D A N P S O   U   T file (#5 0.68) entr y must hav e a numeri c strength  and the d osage form /unit comb ination mu st be such  that a nu meric stre ngth combi ned with t he unit ca n be an ap propriate  dosage sel ection.Pro mptA point  at which  the system  questions  the user  and waits  for a resp onse.Stand ard Medica tion Route  FileThe S TANDARD ME DICATION R OUTE file  (#51.23) w as created  to map Lo cal Medica tion Route s in VistA  to an FDB  Route in  order to p erform dos age checks  in PRE V. 0.5.    This file  has been s tandardize d by Stand ards and T erminology  Service ( STS) and i s mapped t o an FDB R oute. It c annot be e dited loca lly. Stand ard Schedu leStandard  medicatio n administ ration sch edules are  stored in  the Admin istration  Schedule f ile (#51.1 ). Units P er DoseThe  Units Per  Dose is t he number  of Units ( tablets, c apsules, e tc.) to be  dispensed  as a dose  for an or der. Fract ional numb ers will b e accepted .VA Drug C lass CodeA  drug clas sification  system us ed by VA t hat separa tes drugs  into diffe rent categ ories base d upon the ir charact eristics.  Some cost  reports ca n be run f or VA Drug  Class Cod es.VA Prod uct FileTh D A N P S O   U   T file (#5 0.68) cont ains a lis t of avail able drug  products.