6. EPMO Open Source Coordination Office Redaction File Detail Report

Produced by Araxis Merge on 4/27/2017 2:09:15 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.

6.1 Files compared

# Location File Last Modified
1 PSS_10_203_cif.zip\PSS_10_203_cif\docs pss_1_tm_r0217.doc Tue Apr 18 15:44:42 2017 UTC
2 PSS_10_203_cif.zip\PSS_10_203_cif\docs pss_1_tm_r0217.doc Thu Apr 27 16:12:19 2017 UTC

6.2 Comparison summary

Description Between
Files 1 and 2
Text Blocks Lines
Unchanged 7 2652
Changed 7 16
Inserted 0 0
Removed 0 0

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

6.4 Active regular expressions

No regular expressions were active.

6.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 F ebruary 20 17)
  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 2/2017
  13   11-13PSS*1 *203Added  auditing o f DRUG fil e (#50) ch anges and  updated Ro utine list
  14   (L. Behuni ak PM; E.  Weaver, Te ch Writer) 10/201612
  15  
  16  
  17    HYPERLINK   \l "appe ndixa34" 
  18  
  19   34
  20   -37
  21   PSS*1*193A dded new r outine PSS HLDFS to t he Routine s section.
  22   Added Appe ndix A for  Pharmacy  Interface  Automation .
  23    (S. Solda n PM; R.Wa lters, Tec h Writer)4 /16i-ii,
  24   11-12, 22- 23PSS*1*17 5Add 2 new  Routines:  PSSCKOS &  PSSDIUTX,  Updated A dditional  Informatio n section
  25   (H. Cross,  PM; S. He iress, Tec h Writer;  R. Ruzback i, Develop er)3/16i-i i, 
  26    REF p11_R outineTabl e \h 
  27   11-12PSS*1 *191Update d Revision  History
  28   Added new  routines t o routine  list:
  29   PSS1P191,  PSSHRHAI,  PSSMRRDG,  PSSMRRI
  30   (D. Connol ly, PM; E.  Phelps, T ech Writer )3/14All
  31   i - iii, 2 , 7-13, 33 , 37PSS*1* 172Renumbe red all pa ges.
  32   Updated Re vision His tory and T able of Co ntents.
  33   Updated th e Glossary  section b y putting  definition s in a tab le format.
  34   New menu,  options, f ile and ro utines add ed.
  35   (C. Powell , PM; K. K apple, Tec h Writer)9 /13i - iii , 3, 7 – 1 3a, 30, 34  - 35PSS*1 *160Update d Revision  History
  36   Updated Ta ble of Con tents with  Exported  Options an d Routines  sections
  37   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 
  38   [PSS TRAIL ING SPACES  REPORT]. 
  39   Added PSS  DOSING ORD ER CHECKS  option
  40   Also added  the follo wing routi nes to the  routine l ist:
  41   PSS160EN
  42   PSS160PO
  43   PSSDRDOS
  44   PSSFDBDI
  45   PSSDSONF
  46   Added Web  Servers, W eb Service s, and Cac he Class s ection
  47   Added text  to the Se curity Key s section
  48   (D. McCanc e, PM; K.  Kapple, Te ch Writer) 01/13i-iv,  3, 6-6b,  7, 10 - 13 PSS*1*164
  49   PSS*1*169
  50   Removed re ference to  patch PSS *1*146 in  the menu o ptions sec tion
  51   Added Prin t Interfac e Data Fil e option t o the Phar macy Data  Management  [PSS MGR]  menu
  52   Added Chec k Drug Int eraction o ption to t he Pharmac y Data Man agement [P SS MGR] me nu
  53   Moved Menu /Option it ems from p age 7 to p age 6a
  54   Added Prin t Interfac e Data Fil e option t o the PEPS  Services  menu under  the Optio n Descript ions secti on
  55   Added Chec k Drug Int eraction o ption to t he Option  Descriptio ns section
  56   Added rout ine PSSDIU TL
  57   Added Find  Unmapped  Local Poss ible Dosag es option  to the Sta nd Alone O ptions sec tion
  58   (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.
  59   (N. Goyal,  PM; J. Ow czarzak, T ech Writer )Table of  Contentsxe  "Table of  Contents"
  60   1Introduct ion
  61  
  62  
  63   2File List
  64  
  65  
  66   3File Desc riptions
  67  
  68  
  69   3Menu/Opti ons
  70  
  71  
  72   7Option De scriptions
  73  
  74  
  75   12Routines
  76  
  77  
  78   13Exported  Options
  79  
  80  
  81   14Protocol s
  82  
  83  
  84   14Bulletin s
  85  
  86  
  87   15Web Serv ers
  88  
  89  
  90   15Web Serv ices
  91  
  92  
  93   15Cache Cl ass
  94  
  95  
  96   15HL7 Mess aging with  an Extern al System
  97  
  98  
  99   21Data Arc hiving and  Purging
  100  
  101  
  102   21Callable  Routines/ Entry Poin ts/Applica tion Progr am Interfa ces (APIs)
  103  
  104  
  105   21Medicati on Routes
  106  
  107  
  108   22Administ ration Sch eduling
  109  
  110  
  111   22External  Relations
  112  
  113  
  114   22Internal  Relations
  115  
  116  
  117   23Package- Wide Varia bles
  118  
  119  
  120   23Package  Requiremen ts
  121  
  122  
  123   23Addition al Informa tion
  124  
  125  
  126   30Security  Managemen t
  127  
  128  
  129   30Mail Gro ups
  130  
  131  
  132   30Alerts
  133  
  134  
  135   30Bulletin s
  136  
  137  
  138   30Remote S ystems
  139  
  140  
  141   30Archivin g/Purging
  142  
  143  
  144   31Continge ncy Planni ng
  145  
  146  
  147   31Interfac ing
  148  
  149  
  150   31Electron ic Signatu res
  151  
  152  
  153   31Locked M enu Option s
  154  
  155  
  156   31Security  Keys
  157  
  158  
  159   33File Sec urity
  160  
  161  
  162   34Referenc es
  163  
  164  
  165   35Appendix  A: Pharma cy Interfa ce Automat ion
  166  
  167  
  168   35Introduc tion
  169  
  170  
  171   36New Func tionality
  172  
  173  
  174   36Options  and Build  Components
  175  
  176  
  177   38Modified  and New R outines
  178  
  179  
  180   40Glossary
  181  
  182  
  183  
  184  
  185   (This page  included  for two-si ded copyin g.)
  186   Introducti on XE "Int roduction"  
  187   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.
  188   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.
  189   Notationsx e "Notatio ns" that w ill be use d consiste ntly throu ghout this  PDM Techn ical Manua l are outl ined below .
  190   Menu optio ns will be  italicize d.
  191   Example: T he Drug En ter/Edit o ption perm its you to  enter or  edit a dru g.
  192   Screen pro mpts will  be denoted  with quot ation mark s around t hem.
  193   Example: t he "SELECT  DRUG" pro mpt will d isplay nex t.
  194   Responses  in bold fa ce indicat e user inp ut.
  195   Example: D RUG GENERI C NAME: AC ETA
  196   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.
  197   <Enter> in dicates th at the Ent er key (or  Return ke y on some  keyboards)  must be p ressed.
  198   Example: T ype Y for  Yes or N f or No and  press <Ent er> 
  199   <Tab> indi cates that  the Tab k ey must be  pressed.
  200   Example:   Press <Tab > to move  the cursor  to the ne xt field.
  201    Indicates  especiall y importan t or helpf ul informa tion.
  202    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.
  203   Example:      Without  the PSXCO MPMGR key,  the Conso lidated Ma il Outpati ent Pharma cy options  cannot be  accessed.  
  204   ( The page  symbol in dicates a  referral t o a diagra m.
  205   ?, ??, ???   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.
  206   ^  Up arro w (caret o r a circum flex) and  pressing < Enter> can  be used t o exit the  present o ption.
  207   File List
  208   The follow ing PDM fi les are ex ported wit h the PDM  package. 
  209   File#        NAME           
  210   UPDATE 
  211   DATA COMES     USER
  212  
  213   DD
  214   WITH FILE    OVERRIDE
  215   50           DRUG 
  216   FULL
  217   NO
  218  
  219   50.4         DRUG ELE CTROLYTES 
  220   FULL
  221   NO
  222   50.606       DOSAGE F ORM                    
  223   FULL
  224   YES (MERGE )
  225   NO
  226   50.7         PHARMACY  ORDERABLE  ITEM 
  227   FULL
  228   NO
  229   51           MEDICATI ON INSTRUC TION         
  230   FULL
  231   NO
  232   51.1         ADMINIST RATION SCH EDULE       
  233   FULL
  234   YES (MERGE )
  235   YES
  236   51.2         MEDICATI ON ROUTES            
  237   FULL
  238   YES (MERGE )
  239   YES
  240   51.5         ORDER UN IT 
  241   FULL
  242   NO
  243   51.7         DRUG TEX T
  244   FULL
  245   YES
  246   YES
  247  
  248  
  249                   (OVER WRITE)
  250   52.6         IV ADDIT IVES 
  251   FULL
  252   NO
  253   52.7         IV SOLUT IONS 
  254   FULL
  255   NO
  256   53.47        INFUSION  INSTRUCTI ONS
  257   FULL
  258   NO
  259   54           RX CONSU LT 
  260   FULL (SCRE EN)
  261   NO
  262   55           PHARMACY  PATIENT ( Partial DD )
  263   PARTIAL
  264   NO
  265   59.7         PHARMACY  SYSTEM 
  266   FULL
  267   NO
  268   59.73         VENDOR  DISABLE/EN ABLE
  269   FULL
  270   NO
  271   59.74         VENDOR  INTERFACE  DATA 
  272   FULL
  273   NO
  274   The follow ing non-PD M files ar e exported  with the  PDM packag e. 
  275   File#        NAME           
  276   UPDATE 
  277   DATA COMES     USER
  278  
  279   DD
  280   WITH FILE    OVERRIDE
  281   200          NEW PERS ON (Partia l DD)
  282   PARTIAL
  283   NO
  284   9009032.3    APSP INT ERVENTION  TYPE      
  285   FULL
  286   YES
  287  
  288   NO
  289  
  290  
  291   (OVERWRITE )
  292   9009032.4    APSP INT ERVENTION 
  293   FULL
  294   NO
  295   9009032.5    APSP INT ERVENTION  RECOMMENDA TION 
  296   FULL
  297   YES
  298   NO
  299  
  300  
  301   (OVERWRITE )
  302   File Descr iptions
  303   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.
  304   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.
  305   Menu/Optio ns
  306   The PDM op tions list ed below s how the PS S MGR Menu  structure .
  307   Pharmacy D ata Manage ment [PSS  MGR] menu:
  308   CMOP Mark/ Unmark (Si ngle drug)  
  309   [PSSXX MAR K]   
  310   Dosages…
  311   [PSS DOSAG ES MANAGEM ENT]
  312   Dosage For m File Ent er/Edit 
  313   [PSS DOSAG E FORM EDI T]
  314   Enter/Edit  Dosages 
  315   [PSS EDIT  DOSAGES]
  316   Most Commo n Dosages  Report 
  317   [PSS COMMO N DOSAGES]
  318   Noun/Dosag e Form Rep ort 
  319   [PSS DOSE  FORM/ NOUN  REPORT]
  320   Review Dos ages Repor
  321   [PSS DOSAG E REVIEW R EPORT]
  322   Local Poss ible Dosag es Report 
  323   [PSS LOCAL  POSSIBLE  DOSAGES] 
  324   Request Ch ange to Do se Unit 
  325   [PSS DOSE  UNIT REQUE ST]
  326   Lookup Dos ing Check  Info for D rug
  327   [PSS DRUG  DOSING LOO KUP]
  328   Drug Names  with Trai ling Space s Report 
  329   [PSS TRAIL ING SPACES  REPORT]
  330   Drug Enter /Edit
  331   [PSS DRUG  ENTER/ EDI T]
  332   Order Chec k Manageme nt…
  333   [PSS ORDER  CHECK MAN AGEMENT] 
  334   Request Ch anges to E nhanced Or der Check  Database
  335   [PSS ORDER  CHECK CHA NGES]
  336   Report of  Locally En tered Inte ractions
  337   [PSS REPOR T LOCAL IN TERACTIONS ]
  338         Elec trolyte Fi le (IV)
  339   [PSSJI ELE CTROLYTE F ILE]
  340   Lookup int o Dispense  Drug File
  341   [PSS LOOK]
  342   Medication  Instructi on Managem ent... 
  343   [PSS MED I NSTRUCTION  MANAGEMEN T]
  344   Medication  Instructi on File Ad d/Edit
  345   [PSSJU MI]
  346   Medication  Instructi on File Re port 
  347   [PSS MED I NSTRUCTION  REPORT]
  348   Medication  Routes Ma nagement..
  349   [PSS MEDIC ATION ROUT ES MGMT]
  350   Medication  Route Fil e Enter/Ed it
  351   [PSS MEDIC ATION ROUT ES EDIT]
  352   Medication  Route Map ping Repor
  353   [PSS MED R OUTE MAPPI NG REPORT]
  354   Medication  Route Map ping Histo ry Report 
  355   [PSS MED R OUTE MAPPI NG CHANGES ]
  356   Request Ch ange to St andard Med ication Ro ute 
  357   [PSS MEDIC ATION ROUT E REQUEST]
  358   Default Me d Route fo r OI Repor t
  359   [PSS DEF M ED ROUTE O I RPT]
  360   Orderable  Item Manag ement…
  361   [PSS ORDER ABLE ITEM  MANAGEMENT ]
  362   Edit Order able Items
  363   [PSS EDIT  ORDERABLE  ITEMS]
  364   Dispense D rug/Ordera ble Item M aintenance
  365   [PSS MAINT AIN ORDERA BLE ITEMS]
  366   Orderable  Item/Dosag es Report
  367   [PSS ORDER ABLE ITEM  DOSAGES]
  368   Patient In structions  Report
  369   [PSS INSTR UCTIONS/ I TEMS REPOR T]
  370   Orderable  Item Repor t
  371   [PSS ORDER ABLE ITEM  REPORT]
  372   Formulary  Informatio n Report
  373   [PSSNFI]
  374   Drug Text  Management ... 
  375   [PSS DRUG  TEXT MANAG EMENT]
  376   Drug Text  Enter/Edit
  377   [PSS EDIT  TEXT] 
  378   Drug Text  File Repor t
  379   [PSS DRUG  TEXT FILE  REPORT]
  380   Pharmacy S ystem Para meters Edi t
  381   [PSS SYS E DIT]
  382   Standard S chedule Ma nagement..
  383   [PSS SCHED ULE MANAGE MENT]
  384   Standard S chedule Ed it
  385   [PSS SCHED ULE EDIT] 
  386   Administra tion Sched ule File R eport 
  387   [PSS SCHED ULE REPORT ]
  388   Synonym En ter/Edit
  389   [PSS SYNON YM EDIT]
  390   Controlled  Substance s/PKI Repo rts… 
  391   [PSS CS/PK I REPORTS]
  392   DEA Spec H dlg & CS F ed Sch Dis crepancy 
  393   [PSS DEA V S CS FED.  SCH. DISCR .]
  394   Controlled  Substance s Not Matc hed to NDF  
  395   [PSS CS NO T MATCHED  TO NDF]
  396   CS (DRUGS)  Inconsist ent with D EA Spec Hd lg 
  397   [PSS CS DR UGS INCON  WITH DEA]
  398   CS (Ord. I tem) Incon sistent wi th DEA Spe c Hdlg
  399   [PSS CS (O I) INCON W ITH DEA] 
  400   Send Entir e Drug Fil e to Exter nal Interf ace
  401   [PSS MASTE R FILE ALL ]
  402   IV Additiv e/Solution  …
  403   [PSS ADDIT IVE/SOLUTI ON]
  404        IV Ad ditive Rep ort 
  405        [PSS  IV ADDITIV E REPORT]
  406        IV So lution Rep ort 
  407        
  408      [PSS IV  SOLUTION  REPORT]
  409        Mark  PreMix Sol utions 
  410       
  411      [PSS MA RK PREMIX  SOLUTIONS]
  412   Warning Bu ilder
  413   [PSS WARNI NG BUILDER ]
  414   Warning Ma pping
  415   [PSS WARNI NG MAPPING ]
  416   PEPS Servi ces…
  417   [PSS PEPS  SERVICES]
  418               Check Ven dor Databa se Link 
  419             
  420    
  421   [PSS CHECK  VENDOR DA TABASE LIN K]
  422    Check PEP S Services  Setup
  423             
  424                 [PSS CH ECK PEPS S ERVICES SE TUP]
  425   Schedule/R eschedule  Check PEPS  Interface
  426               
  427  
  428   [PSS SCHED ULE PEPS I NTERFACE C K]
  429   Print Inte rface Data  File
  430  
  431  
  432   [PSS VENDO R INTERFAC E REPORT]
  433   Inpatient  Drug Manag ement…
  434   [PSS INP M GR]
  435      ADditiv es File 
  436      [PSSJI  DRUG]
  437     Dispense  Drug Fiel ds 
  438     [PSSJU D RG]
  439     Dispense  Drug/ATC  Set Up 
  440     [PSSJU D RUG/ATC SE T UP]
  441     Edit Cos t Data 
  442     [PSSJU D CC]
  443     EDit Dru g Cost (IV
  444     [PSSJI E DIT DRUG C OST]
  445     MARk/Unm ark Dispen se Drugs F or Unit Do se 
  446     [PSSJU M ARK UD ITE MS]
  447     PRimary  Solution F ile (IV)
  448     [PSSJI S OLN]
  449   Check Drug  Interacti on
  450   [PSS CHECK  DRUG INTE RACTION]
  451   Infusion I nstruction  Managemen t …
  452   [PSS INFIN S MGR]
  453   Infusion I nstruction s Add/Edit
  454   [PSS INFIN S ADED]
  455   Infusion I nstruction  Report
  456   [PSS INFIN S RPT]
  457        Locke d: PSXCMOP MGR
  458   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.
  459   Option Des criptions
  460   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.
  461   PSS MGR Ph armacy Dat a Manageme nt   
  462   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.
  463   ITEM: PSS  DRUG ENTER /EDIT                
  464   ITEM: PSS  LOOK                            
  465   ITEM: PSSJ I ELECTROL YTE FILE             
  466   ITEM: PSSX X MARK                          
  467   ITEM: PSS  SYS EDIT                        
  468   ITEM: PSS  ORDERABLE  ITEM MANAG EMENT     
  469   ITEM: PSSN FI                              
  470   ITEM: PSS  SYNONYM ED IT                   
  471   ITEM: PSS  DOSAGES MA NAGEMENT             
  472   ITEM: PSS  CS/PKI REP ORTS                 
  473   ITEM: PSS  MASTER FIL E ALL                
  474   ITEM: PSS  MEDICATION  ROUTES MG MT        
  475   ITEM: PSS  SCHEDULE M ANAGEMENT            
  476   ITEM: PSS  DRUG TEXT  MANAGEMENT           
  477   ITEM: PSS  MED INSTRU CTION MANA GEMENT    
  478   ITEM: PSS  ORDER CHEC K MANAGEME NT        
  479   ITEM: PSS  ADDITIVE/S OLUTION              
  480   ITEM: PSS  WARNING BU ILDER                
  481   ITEM: PSS  WARNING MA PPING                
  482   ITEM: PSS  PEPS SERVI CES                  
  483   ITEM: PSS  INP MGR
  484   ITEM: PSS  Check Drug  Interacti on
  485   ITEM: PSS  INFINS MGR
  486   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------  
  487   PSS DRUG E NTER/EDIT
  488   Drug Enter /Edit    
  489   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.
  490   TYPE: run  routine    ROUTINE: P SSDEE
  491   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  492   PSS LOOK
  493   Lookup int o Dispense  Drug File
  494   This optio n provides  a report  of all inf ormation r egarding t he dispens e drug.
  495   TYPE: run  routine    ROUTINE: P SSLOOK
  496   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  497   PSSJI ELEC TROYLYTE F ILE
  498   Electrolyt e File (IV )
  499   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.
  500   TYPE: run  routine    ROUTINE: E LECTRO^PSS IVDRG
  501   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  502   PSSXX MARK
  503   CMOP Mark/ Unmark (Si ngle drug)
  504   This optio n allows t he user to  mark/unma rk a singl e drug for  transmiss ion to the  CMOP.  
  505   TYPE: run  routine    ROUTINE: P SSMARK                        
  506   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  507   PSS SYS ED IT
  508   Pharmacy S ystem Para meters Edi t
  509   This optio n allows t he user to  edit the  Pharmacy S ystem para meters use d in Pharm acy Data M anagement.   
  510   TYPE: run  routine    ROUTINE: P SSYSP
  511   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  512   PSS ORDERA BLE ITEM M ANAGEMENT
  513   Orderable  Item Manag ement  
  514   This is th e sub-menu  driver fo r Orderabl e Item mai ntenance.   
  515   ITEM: PSS  MAINTAIN O RDERABLE I TEMS      
  516   ITEM: PSS  EDIT ORDER ABLE ITEMS           
  517   ITEM: PSS  ORDERABLE  ITEM DOSAG ES        
  518   ITEM: PSS  INSTRUCTIO NS/ITEMS R EPORT     
  519   ITEM: PSS  ORDERABLE  ITEM REPOR T         
  520   TYPE: menu   
  521   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  522   PSSNFI
  523   Formulary  Informatio n Report
  524   This optio n provides  a listing  of pertin ent pharma cy formula ry informa tion.  
  525   TYPE: run  routine    ROUTINE: P SSNFI
  526   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  527   PSS SYNONY M EDIT
  528   Synonym En ter/Edit          
  529   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.  
  530   TYPE: run  routine    ROUTINE: P SSSEE                         
  531   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  532   PSS DOSAGE S MANAGEME NT
  533   Dosages                      
  534   This menu  option con tains opti ons that c ontrol the  editing o f dosages.   
  535   ITEM: PSS  DOSAGE FOR M EDIT               
  536   ITEM: PSS  EDIT DOSAG ES                   
  537   ITEM: PSS  COMMON DOS AGES                 
  538   ITEM: PSS  DOSE FORM/ NOUN REPOR T         
  539   ITEM: PSS  DOSAGE REV IEW REPORT           
  540   ITEM: PSS  LOCAL POSS IBLE DOSAG ES        
  541   ITEM: PSS  DOSE UNIT  REQUEST              
  542   TYPE: menu   
  543   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  544   PSS CS/PKI  REPORTS
  545   Controlled  Substance s/PKI Repo rts
  546   PKI POST-I NSTALL REP ORTS PROVI DED AS OPT IONS.  
  547   ITEM: PSS  DEA VS CS  FED. SCH.  DISCR.    
  548   ITEM: PSS  CS NOT MAT CHED TO ND F         
  549   ITEM: PSS  CS DRUGS I NCON WITH  DEA       
  550   ITEM: PSS  CS (OI) IN CON WITH D EA        
  551   TYPE: menu   
  552   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  553   PSS MASTER  FILE ALL
  554   Send Entir e Drug Fil e to Exter nal Interf ace
  555   TYPE: run  routine    ROUTINE: P SSMSTR  
  556   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  557   PSS MEDICA TION ROUTE S MGMT
  558   Medication  Routes Ma nagement
  559   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.
  560   ITEM: PSS  MEDICATION  ROUTES ED IT        
  561   ITEM: PSS  MED ROUTE  MAPPING RE PORT      
  562   ITEM: PSS  MED ROUTE  MAPPING CH ANGES     
  563   ITEM: PSS  MEDICATION  ROUTE REQ UEST      
  564   ITEM: PSS  DEF MED RO UTE OI RPT           
  565   TYPE: menu   
  566   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------  
  567   PSS SCHEDU LE MANAGEM ENT
  568   Standard S chedule Ma nagement
  569   This Sub-M enu contai ns options  needed fo r Schedule  maintenan ce. 
  570   ITEM: PSS  SCHEDULE E DIT                  
  571   ITEM: PSS  SCHEDULE R EPORT                
  572   TYPE: menu   
  573   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  574   PSS DRUG T EXT MANAGE MENT
  575   Drug Text  Management        
  576   This Sub-M enu contai ns options  concernin g Drug Tex t.  
  577   ITEM: PSS  EDIT TEXT                       
  578   ITEM: PSS  DRUG TEXT  FILE REPOR T         
  579   TYPE: menu   
  580   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  581   PSS MED IN STRUCTION  MANAGEMENT
  582   Medication  Instructi on Managem ent
  583   The Sub-Me nu contain s options  related to  the MEDIC ATION INST RUCTION (# 51) File.   
  584   ITEM: PSSJ U MI                            
  585   ITEM: PSS  MED INSTRU CTION REPO RT        
  586   TYPE: menu   
  587   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  588   PSS ORDER  CHECK MANA GEMENT
  589   Order Chec k Manageme nt     
  590   This is th e sub-menu  for funct ionality r elated to  managing m edication  order chec ks.  
  591   ITEM: PSS  ORDER CHEC K CHANGES            
  592   ITEM: PSS  REPORT LOC AL INTERAC TIONS     
  593   TYPE: menu   
  594   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  595   PSS ADDITI VE/SOLUTIO N
  596   IV Additiv e/Solution        
  597   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. 
  598   ITEM: PSS  IV ADDITIV E REPORT            
  599   ITEM: PSS  IV SOLUTIO N REPORT             
  600   ITEM: PSS  MARK PREMI X SOLUTION S         
  601   TYPE: menu   
  602   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  603   PSS WARNIN G BUILDER
  604   Warning Bu ilder             
  605   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. 
  606   TYPE: run  routine    ROUTINE: P SSWRNB                        
  607   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  608   PSS WARNIN G MAPPING
  609   Warning Ma pping             
  610   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.  
  611   TYPE: run  routine    ROUTINE: E DIT^PSSWMA P                  
  612   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  613   PSS PEPS S ERVICES
  614   PEPS 
  615   ITEM: PSS  CHECK VEND OR DATABAS E LINK    
  616   ITEM: PSS  CHECK PEPS  SERVICES  SETUP     
  617   ITEM: PSS  SCHEDULE P EPS INTERF ACE CK    
  618   ITEM: PSS  VENDOR INT ERFACE REP ORT       
  619   TYPE: menu   
  620   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  621   PSS INP MG R                         
  622   Inpatient  Drug Manag ement
  623   This Sub-M enu contai ns options  related t o INPATIEN T DRUG MAN AGEMENT.  
  624   ITEM: PSSJ I DRUG                          
  625   ITEM: PSSJ U DRG                           
  626   ITEM: PSSJ U DRUG/ATC  SET UP              
  627   ITEM: PSSJ U DCC                           
  628   ITEM: PSSJ I EDIT DRU G COST               
  629   ITEM: PSSJ U MARK UD  ITEMS                
  630   ITEM: PSSJ I SOLN                          
  631   TYPE: Menu
  632   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  633   PSS CHECK  DRUG INTER ACTION
  634   Check Drug  Interacti on
  635   This menu  contains o ptions per taining to  maintaini ng pharmac y
  636   data files , creating  Pharmacy  Orderable  Items, and  the Medic ation Rout e/ 
  637   Instructio ns table a mong other  assorted  functions.
  638   TYPE: run  routine RO UTINE: PSS DIUTL
  639   PSS INFINS  MGR
  640   Infusion I nstruction  Managemen t
  641   Menu conta ining opti ons relate d to the I NFUSION IN STRUCTIONS  (#53.47)  file.
  642   TYPE: menu
  643   PSS INFINS  ADED 
  644   Infusion I nstruction s Add/Edit
  645   Allows use rs to ente r and edit  abbreviat ions and e xpansions  in the INF USION INST RUCTIONS ( #53.47) fi le.
  646   TYPE: run  routine  R OUTINE: EN II^PSSFILE D
  647  
  648   PSS INFINS  RPT
  649   Infusion I nstruction s Report
  650   Provides a  report of  entries f rom the IN FUSION INS TRUCTIONS( #53.47) fi le
  651   TYPE: run  routine RO UTINE: EN^ PSSIIRPT
  652   Patch PSS* 1*203 enab les auditi ng of DRUG  file (#50 ) changes  made throu gh option  PSS DRUG E NTER/EDIT.  This is d one by gen erating a  message to  a new Mai lMan Group  called PS S DEE AUDI T when cha nges are m ade to DRU G file fie lds. The f ollowing l ist of aud itable fie lds is sto red intern ally in th e PSSDEEA  routine. 
  653   GENERIC NA ME (#.01)
  654   D A N C
S S   FICATION ( #2)
  655   DEA, SPECI AL HDLG (# 3)
  656   MAXIMUM DO SE PER DAY  (#4)
  657   STANDARD S IG (#5)
  658   FSN (#6)
  659   WARNING LA BEL (#8)
  660   MESSAGE (# 101)
  661   PHARMACY O RDERABLE I TEM  (#2.1 )
  662   RESTRICTIO N (#102)
  663   APPLICATIO N PACKAGES ’ USE (#63 )
  664   NDC (#31)
  665   CMOP DISPE NSE (#213)
  666   ATC MNEMON IC (#212.2 )
  667   REORDER LE VEL (#11)
  668   ORDER UNIT  (#12)
  669   PRICE PER  ORDER UNIT  (#13)
  670   PRICE PER  DISPENSE U NIT (#16)
  671   SOURCE OF  SUPPLY (#1 7)
  672   DISPENSE U NIT (#14.5 )
  673   CURRENT IN VENTORY (# 50)
  674   DAW CODE ( #81)
  675   NCPDP DISP ENSE UNIT  (#82)
  676   NCPDP QUAN TITY MULTI PLIER (#83 )
  677   INACTIVE D ATE (#100)
  678   NATIONAL D RUG FILE E NTRY (#20)
  679   D A N P S O   U   T NAME (#2 1)
  680   PSNDF  D A N P S O   U   T NAME ENT RY (#22)
  681   PACKAGE SI ZE (#23)
  682   PACKAGE TY PE (#24)
  683   NATIONAL D RUG CLASS  (#25)
  684   CMOP ID (# 27)
  685   NATIONAL F ORMULARY I NDICATOR ( #29)
  686   If a user  makes chan ges to a n on-auditab le field,  or views a n auditabl e field bu t does not  make any  changes, t hen the ma il message  Subject i s DRUG ENT ER/EDIT AC CESS, and  the messag e body ind icates “No  Audited C hanges Mad e.”
  687   Routines
  688   The follow ing routin es are use d by the P harmacy Da ta Managem ent packag e.
  689   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 RMIX  PSSP RUTL  PSSQ OC    PSSQ ORD   PSSR EF    PSSR EMCH PSSRX ACT  PSSSC HED  PSSSC HRP  PSSSE E    PSSTR ENG  PSSTX T    PSSUN MSI  PSSUT IL   PSSUT IL1  PSSUT IL3PSSUTLA 1  PSSUTLA 2  PSSUTLA Z  PSSUTLP R  PSSUTLP Z  PSSVIDR G  PSSVX6     PSSVX61 PSSVX62    PSSVX63    PSSVX64    PSSVX65    PSSVX66    PSSWMAP    PSSWRNA    PSSWRNBPSS WRNC   PSS WRNE PSSXD IC   PSSXR EF    PSSX RF1   PSSY SPExported  Options
  690   Stand-Alon e Options
  691   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 ]:
  692   Other Lang uage Trans lation Set up
  693   [PSS OTHER  LANGUAGE  SETUP]
  694   Drug Inqui ry (IV) 
  695   [PSSJI DRU G INQUIRY]
  696   Electrolyt e File (IV
  697   [PSSJI ELE CTROLYTE F ILE]
  698   Enable/Dis able Vendo r Database  Link
  699   [PSS ENABL E/DISABLE  DB LINK]
  700   Add Defaul t Med Rout e
  701   [PSS ADD D EFAULT MED  ROUTE]
  702   Find Unmap ped Local  Possible D osages
  703   [PSS LOCAL  DOSAGES E DIT ALL]
  704   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].
  705   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).
  706   Protocols
  707   NAME: PSS  EXT MFU CL IENT 
  708    DESCRIPTI ON:   This  protocol  will be us ed as the  ACK from t he externa l
  709    interface  for a MFN _M01 messa ge.  
  710   NAME: PSS  EXT MFU SE RVER 
  711    DESCRIPTI ON:   This  protocol  will be us ed to send  event not ification  and data
  712    when new  drugs are  added to t he DRUG fi le (#50) a nd when ce rtain fiel ds are 
  713    updated i n the same  file. Thi s informat ion will b e sent to  the automa ted 
  714    dispensin g machines  through H L7 V.2.4 f ormatted m essages.  
  715     
  716   NAME: PSS  HUI DRUG U PDATE 
  717    DESCRIPTI ON:   This  protocol  will be us ed to send  event not ification  and data
  718    when new  drugs are  added to t he Drug fi le (#50) a nd when ce rtain fiel ds are 
  719    updated i n same fil e.  
  720   NAME: PSS  MED ROUTE  RECEIVE
  721    DESCRIPTI ON:   This  protocol  processes  updates to  the Stand ard Medica tion
  722    Routes (# 51.23) Fil e.  
  723   Bulletins
  724   NAME: PSS  FDB INTERF ACE 
  725   SUBJECT: O RDER CHECK  DATABASE  DOWN
  726   RETENTION  DAYS: 3
  727   PRIORITY?:  YES
  728   NAME: PSS  FDB INTERF ACE RESTOR ED
  729   SUBJECT: O RDER CHECK  DATABASE  IS BACK UP
  730   RETENTION  DAYS: 3 
  731   PRIORITY?:  YES
  732   Web Server s
  733   PEPS 
  734   Web Servic es
  735   DOSING_INF O
  736   DRUG_INFO
  737   ORDER_CHEC KS
  738   Cache Clas s
  739   XMLHandler
  740   HL7 Messag ing with a n External  System
  741   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.
  742   HL7 Drug M essage Seg ment Defin ition Tabl e
  743   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 .
  744   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
  745   ^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):
  746   AUTOMATED  DISPENSE f ield (#105 ) needs to  be set to  2.4.
  747   ENABLE MAS TER FILE U PDATE fiel d (#105.2)  needs to  be set to  YES.
  748   LOGICAL LI NK field ( #2005) nee ds to be s et to PSO  DISP.
  749   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             ).
  750   DISPENSE D NS PORT fi eld (#2007 ) needs to  be set to  the dispe nsing syst em port nu mber.
  751   Specific T ransaction xe "Specif ic Transac tion"
  752   The Pharma cy/Treatme nt Encoded  Order Mes sage is as  follows:
  753   MFN
  754   Master Fil e Notifica tion Messa ge
  755   MSH
  756   Message He ader
  757   MFI
  758   Master Fil e Identifi er
  759   {MFE
  760   Master Fil e Entry
  761   {{ZPA}
  762   Drug File  Informatio n
  763     {RXD}
  764   Pharmacy/T reatment D ispense
  765     {OBR}}
  766  
  767   Observatio n Request
  768   }
  769   Example:
  770   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
  771   MFI|50~DRU G~99PSD||U PD|||NE
  772   MFE|MUP||| PROPANTHEL INE 15MG T AB
  773   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
  774   RXD||||1|| |||1|||~P& 200&LPSD50 .0903||||| |||||||O
  775   OBR||||110 2~ACETAZOL AMIDE~LLAB 60|||||||| |||70&NECK &LLAB61||| ||||||WBC| ||7
  776   HL7 Drug M essage Seg ment Defin ition Tabl e
  777   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.
  778   Segments U sed in the  Master Fi le Update  Message
  779   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:
  780   [MSH-3] Se nding Appl ication is  the stati on ID alon g with the  DNS name  of the sen ding facil ity.
  781   [MSH-5] Re ceiving Ap plication  is the DNS  name and  DNS port n umber of t he dispens ing applic ation.
  782   [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.
  783   [MFI-1] Ma ster File  Identifier  is hard-c oded to 50 ~DRUG~99PS D.
  784   [MFE-1] Re cord-Level  Event Cod e can be e ither MUP  for Update  or MAD fo r Add.
  785   [MFE-4] Pr imary Key  Value – MF E is the G ENERIC NAM E field (# .01) from  the DRUG f ile (#50).
  786   [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.
  787   [ZPA-2] Is  Synonym i s set to Y  or N depe nding on w hether the  primary k ey is a sy nonym.
  788   [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.
  789   [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).
  790   [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 .
  791   [ZPA-29] I ntended Us er will be  TRADE NAM E, QUICK C ODE, DRUG  ACCOUNTABI LITY or CO NTROLLED S UBSTANCES.
  792   [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) .
  793   [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).
  794   [RXD-12] T otal Daily  Dose will  be either  P for Pos sible Dosa ges or LP  for Local  Possible D osages.
  795   [OBR-4] Un iversal Se rvice Iden tifier is  used for C lozapine L ab Test.
  796   [OBR-15] S pecimen So urce is us ed for Clo zapine Spe cimen Type .
  797   [OBR-24] D iagnostic  Serv Sect  ID is used  for Cloza pine Type  of Test.
  798   [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 ).
  799   Data Archi ving and P urging
  800   There are  no archivi ng and pur ging funct ions neces sary with  this relea se of the  PDM packag e.
  801   Callable R outines/En try Points /Applicati on Program  Interface s (APIs)
  802   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:
  803   IAs    INT EGRATION C ONTROL REG ISTRATIONS  ...
  804   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 "" .
  805   Medication  Routes
  806   The follow ing paragr aphs provi de an expl anation of  medicatio n route in formation.
  807   For Outpat ient Pharm acy & Inpa tient Medi cation Uni t Dose Ord ers:
  808   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
  809   For IV Flu ids Orders :
  810   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).
  811   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 .
  812   Administra tion Sched uling
  813   The follow ing rules  apply to a dministrat ion schedu ling.
  814   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.
  815   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.
  816   External R elations
  817   Integratio n Agreemen ts
  818   IAs can be  viewed by  first cho osing the  DBA option  on FORUM  and then t he Integra tion Agree ments Menu  option.
  819   Example: D BA Option
  820  
  821   Select Pri mary Menu  Option: DB A
  822   Select DBA  Option: I NTEGration  Agreement s Menu
  823   Select Int egration A greements  Menu Optio n:  Custod ial Packag e Menu
  824   Select Cus todial Pac kage Menu  Option:  A CTIVE by C ustodial P ackage
  825   Select PAC KAGE NAME:  PHARMACY  DATA MANAG EMENT      PSS
  826   DEVICE: HO ME//
  827   Internal R elations
  828   All PDM op tions can  function i ndependent ly.
  829   Package-Wi de Variabl es
  830   There are  no package -wide vari ables for  this versi on.
  831   Package Re quirements
  832   The PDM mo dule relie s on, at l east, the  following  external p ackages to  run effec tively.
  833  
  834   Package
  835   Minimum ve rsion need ed
  836  
  837   National D rug File
  838   V. 4.0
  839  
  840  
  841   Outpatient  Pharmacy
  842   V. 7.0
  843  
  844  
  845   Inpatient  Medication s
  846   V. 5.0
  847  
  848  
  849   Kernel
  850   V. 8.0 
  851  
  852  
  853   VA FileMan
  854  
  855   V. 22.0 
  856  
  857   Package
  858   Minimum ve rsion need ed
  859  
  860   HealtheVet  Web Servi ces Client  (HWSC)
  861   V. 1.0
  862  
  863   VistALink
  864  
  865   V. 1.6
  866   Additional  Informati on
  867   Standards  and Conven tions Comm ittee (SAC C) Exempti ons
  868   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.
  869   PSSFDBDI
  870   PSSFDBRT
  871   PSSHRPST
  872   PSSHTTP
  873   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.
  874   OITIMB3355 4520 - Mig ration fro m M2J to V istA Web S ervices Cl ient (VWSC )
  875   Keywords
  876   M2J,VWSC,J 2EE
  877   Decision D ate
  878   12/1/2006
  879   Decision T ype
  880   Architectu re
  881   Decision M aking Body
  882   HPMO CCB
  883   Descriptio n
  884   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 .
  885   Rationale
  886   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. 
  887   Record Typ e
  888   TDR
  889   State
  890   Approved
  891   Date Submi tted
  892   2/14/2007  8:37:24 AM
  893   Supporting  Documenta tion 
  894   Link
  895   Document T itle
  896   Descriptio n
  897   Date
  898   Download
  899   Migration  from M2J t o VistA We b Services  Client (V WSC) Email  Notificat ion
  900   Email noti fication a lerting of  the decis ion
  901   2/13/2007
  902   Download
  903   VWSC Archi tecture
  904   Proposed a rchitectur e view of  VWSC
  905   12/1/2006
  906   Download
  907   VWSC Propo sed View
  908   Proposed l ogical vie w of VistA  Web Servi ces Client  (VWSC)
  909   12/1/2006
  910   Cross-Refe rence Logi c to Keep  Orderable  Items Up T o Date
  911   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.
  912   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 .
  913   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.
  914   File 50:     DEA Spec ial Hdlg
  915   File 50:     Inactiva tion Date
  916   File 50:     Applicat ion Packag es’ Use
  917   File 50:     Local No n-Formular y
  918   File 50.7:  Inactivat ion Date
  919   File 52.6:  Inactivat ion Date
  920   File 52.6:  Used in I V Fluid Or der Entry
  921   File 52.7:  Inactivat ion Date
  922   File 52.7:  Used in I V Fluid Or der Entry
  923   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).
  924   File 50:      Orderab le Item Po inter
  925   File 52.6:   Generic  Drug Point er
  926   File 52.7:   Generic  Drug Point er
  927   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.
  928   Scenario 1 : The Orde rable Item  Pointer I s Changed  For A Disp ense Drug
  929   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: 
  930   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.
  931   Orderable  Item:    ^ PS(50.7,"A 50",Ordera ble Item I EN, Dispen se Drug IE N)=""
  932   Drug file:               ^PSDRUG ("A526", D ispense Dr ug IEN, Ad ditive IEN ,)=""
  933   Drug file:               ^PSDRUG ("A527", D ispense Dr ug IEN, So lution IEN ,)=""
  934   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. 
  935   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:
  936   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.  
  937   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.
  938   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) .
  939   Example 1:
  940   Additives/ Solution
  941  
  942   Dispense D rugs:
  943  
  944   Orderable  Item:
  945   IEN 3    p oints to = >            
  946   IEN 100     points to  =>
  947  
  948   500      
  949   IEN 4    p oints to = >            
  950   IEN 100     points to  =>
  951  
  952   500
  953   IEN 5    p oints to = >            
  954   IEN 100     points to  =>
  955  
  956   500
  957   IEN 10  po ints to =>
  958  
  959   IEN 200      points t o =>
  960  
  961   500
  962   Cross-Refe rences are :
  963  
  964   ^PS(50.7," A50",500,1 00)=""
  965   ^PS(50.7," A50",500,2 00)=""
  966   ^PSDRUG("A 526",100,3 )=""
  967  
  968   ^PSDRUG("A 526",100,4 )=""
  969  
  970   ^PSDRUG("A 526",100,5 )=""
  971   ^PSDRUG("A 527",200,1 0)=""
  972   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.
  973   (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. 
  974   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.
  975   Kill Logic
  976   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
  977   The Cross- References  would now  be as fol lows.
  978   ^PS(50.7," A50",500,2 00)=""
  979   ^PSDRUG("A 526",100,3 )=""
  980   ^PSDRUG("A 526",100,4 )=""
  981   ^PSDRUG("A 526",100,5 )=""
  982   ^PSDRUG("A 527",200,1 0)=""
  983   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.
  984   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) .  
  985   Set Logic
  986   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.
  987   ^PS(50.7," A50",500,2 00)=""
  988   ^PS(50.7," A50",600,1 00)=""
  989   ^PSDRUG("A 526",100,3 )=""
  990   ^PSDRUG("A 526",100,4 )=""
  991   ^PSDRUG("A 526",100,5 )=""
  992   ^PSDRUG("A 527",200,1 0)=""
  993   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.
  994   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. 
  995   Scenario 2 : The Disp ense Drug  Pointer Is  Edited Fo r An IV Ad ditive Or  IV Solutio n
  996   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.
  997   Kill Logic
  998   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.
  999   Set Logic
  1000   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.  
  1001   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. 
  1002   Example 2:
  1003   IV Additiv es/IV Solu tion
  1004   Dispense D rugs
  1005  
  1006   Orderable  Item
  1007   IEN 3    p oints to = >            
  1008   IEN 100     points to  =>
  1009  
  1010   500      
  1011   IEN 4    p oints to = >           
  1012   IEN 100     points to  =>
  1013  
  1014   500
  1015   IEN 5    p oints to = >         
  1016   IEN 100     points to  =>
  1017  
  1018   500
  1019   IEN 10  po ints to =>
  1020  
  1021   IEN 200      points t o =>                     
  1022   500
  1023   Cross-Refe rences 
  1024   ^PS(50.7," A50",500,1 00)=""
  1025   ^PS(50.7," A50",500,2 00)=""
  1026  
  1027  
  1028  
  1029   ^PSDRUG("A 526",100,3 )=""
  1030  
  1031  
  1032  
  1033   ^PSDRUG("A 526",100,4 )=""
  1034  
  1035  
  1036  
  1037   ^PSDRUG("A 526",100,5 )=""
  1038   ^PSDRUG("A 527",200,1 0)=""
  1039   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 
  1040   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.
  1041   Kill Logic
  1042   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. 
  1043  
  1044  
  1045  
  1046   ^PS(50.7," A50",500,1 00)=""
  1047   ^PS(50.7," A50",500,2 00)=""
  1048  
  1049  
  1050  
  1051   ^PSDRUG("A 526",100,4 )=""
  1052  
  1053  
  1054  
  1055   ^PSDRUG("A 526",100,5 )=""
  1056    
  1057  
  1058  
  1059   ^PSDRUG("A 527",200,1 0)=""
  1060   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.
  1061   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.  
  1062   Set Logic
  1063   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 
  1064  
  1065  
  1066  
  1067   ^PS(50.7," A50",500,1 00)=""
  1068   ^PS(50.7," A50",500,2 00)=""
  1069  
  1070  
  1071  
  1072   ^PSDRUG("A 526",100,4 )=""
  1073  
  1074  
  1075  
  1076   ^PSDRUG("A 526",100,5 )=""
  1077   ^PSDRUG("A 526",900,3 )=""
  1078    
  1079  
  1080  
  1081   ^PSDRUG("A 527",200,1 0)=""
  1082   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 .
  1083  
  1084  
  1085  
  1086   ^PS(50.7," A50",500,1 00)=""
  1087   ^PS(50.7," A50",500,2 00)=""
  1088   ^PS(50.7," A50",2000, 900)=""
  1089  
  1090  
  1091  
  1092   ^PSDRUG("A 526",100,4 )=""
  1093  
  1094  
  1095  
  1096   ^PSDRUG("A 526",100,5 )=""
  1097   ^PSDRUG("A 526",900,3 )=""
  1098    
  1099  
  1100  
  1101   ^PSDRUG("A 527",200,1 0)=""
  1102   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.
  1103   Security M anagement
  1104   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.
  1105   Mail Group
  1106   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.
  1107   NAME: PSS  ORDER CHEC KS                   
  1108   TYPE: publ ic
  1109   DESCRIPTIO N:   Membe rs of this  mail grou p will rec eive vario us notific ations
  1110   that impac t Enhanced  Order Che cks (drug- drug inter actions, d uplicate t herapy
  1111   and dosing  checks) i ntroduced  with PRE V . 0.5 util izing a CO TS databas e.  
  1112   Alerts
  1113   There are  no alerts  in the PDM  package.
  1114   Bulletins
  1115   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.
  1116   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 .
  1117   NAME: PSS  FDB INTERF ACE 
  1118   SUBJECT: O RDER CHECK  DATABASE  DOWN
  1119   RETENTION  DAYS: 3
  1120   PRIORITY?:  YES
  1121   NAME: PSS  FDB INTERF ACE RESTOR ED
  1122   SUBJECT: O RDER CHECK  DATABASE  IS BACK UP
  1123   RETENTION  DAYS: 3 
  1124   PRIORITY?:  YES
  1125   Remote Sys tems
  1126   PDM does n ot transmi t data to  any remote  system or  facility.  
  1127   Archiving/ Purging
  1128   There are  no archivi ng and pur ging funct ions neces sary with  the PDM pa ckage.
  1129   Contingenc y Planning
  1130   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 ).
  1131   Interfacin g
  1132   There are  no special ized produ cts embedd ed within  or require d by the P DM package .
  1133   Electronic  Signature s
  1134   No electro nic signat ures are u tilized in  the PDM p ackage.
  1135   Locked Men u Options
  1136   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.
  1137        Locke d: PSXCMOP MGR
  1138   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.
  1139   Security K eys
  1140   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.
  1141   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.
  1142  
  1143        Packa ge
  1144   Keys
  1145   Outpatient  Pharmacy
  1146   PSORPH
  1147   Inpatient  Medication s
  1148   PSJU MGR
  1149   Inpatient  Medication s
  1150   PSJI MGR
  1151   Automatic  Replenishm ent/Ward S tock 
  1152   PSGWMGR
  1153   Drug Accou ntability/ Inventory  Interface
  1154   PSAMGR
  1155   Drug Accou ntability/ Inventory  Interface
  1156   PSA ORDERS
  1157   Controlled  Substance
  1158   PSDMGR
  1159   National D rug File 
  1160   PSNMGR
  1161   Consolidat ed Mail Ou tpatient P harmacy 
  1162   PSXCMOPMGR
  1163   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. 
  1164   NAME: PSS_ CUSTOM_TAB LES_ADMIN            
  1165   DESCRIPTIV E NAME: AD MINISTRATO R
  1166   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.   
  1167   NAME: PSS_ CUSTOM_TAB LES_APPROV ER        
  1168   DESCRIPTIV E NAME: AP PROVER
  1169   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 .  
  1170   NAME: PSS_ CUSTOM_TAB LES_REL_MA N         
  1171   DESCRIPTIV E NAME: RE LEASE MANA GER
  1172   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.   
  1173   NAME: PSS_ CUSTOM_TAB LES_REQUES TOR       
  1174   DESCRIPTIV E NAME: RE QUESTOR
  1175   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
  1176   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 .
  1177   NAME: PSS_ PPSN_MANAG ER
  1178   DESCRIPTIV E NAME: PP S-National  Manager
  1179   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.
  1180   NAME: PSS_ PPSN_MIGRA TOR
  1181   DESCRIPTIV E NAME: PP S-National  Migration  User
  1182   DESCRIPTIO N:   This  role has t he ability  to run th e PPS-N Mi gration.
  1183   NAME: PSS_ PPSN_SECON D_APPROVER
  1184   DESCRIPTIV E NAME: PP S-National  Second Ap prover
  1185   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.
  1186   NAME: PSS_ PPSN_SUPER VISOR
  1187   DESCRIPTIV E NAME: PP S-National  Superviso r
  1188   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.
  1189   NAME: PSS_ PPSN_VIEWE R
  1190   DESCRIPTIV E NAME: PP S-National  Viewer
  1191   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.
  1192   File Secur ity
  1193   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.
  1194   PDM Files
  1195   File 
  1196   NumbersFil e NamesDDR DWRDELLAYG O50
  1197   DRUG
  1198   @50.4
  1199   DRUG ELECT ROLYTES
  1200   @50.606
  1201   DOSAGE FOR M
  1202   @
  1203  
  1204   @
  1205   @
  1206   @50.7
  1207   PHARMACY O RDERABLE I TEM
  1208   @51
  1209   MEDICATION  INSTRUCTI ON
  1210   @51.1
  1211   ADMINISTRA TION SCHED ULE
  1212   @51.2
  1213   MEDICATION  ROUTES
  1214   @51.23
  1215   STANDARD M EDICATION  ROUTES
  1216   @
  1217   Pp
  1218   @
  1219   @
  1220   @51.24
  1221   DOSE UNIT
  1222   @
  1223   Pp
  1224   @
  1225   @
  1226   @51.5
  1227   ORDER UNIT
  1228   51.7
  1229   DRUG TEXT
  1230   @52.6
  1231   IV ADDITIV ES
  1232   @52.7
  1233   IV SOLUTIO NS
  1234   @53.47
  1235   INFUSION I NSTRUCTION S
  1236   54
  1237   RX CONSULT
  1238   55
  1239   PHARMACY P ATIENT (Pa rtial DD)
  1240   @
  1241   P59.7
  1242   PHARMACY S YSTEM
  1243   ^
  1244  
  1245   ^
  1246  
  1247   ^59.73
  1248   VENDOR DIS ABLE/ENABL
  1249   @
  1250   @
  1251   @
  1252   @
  1253   @
  1254   59.74
  1255   VENDOR INT ERFACE DAT A
  1256   @
  1257   @
  1258   @
  1259   @
  1260   @
  1261   Non-PDM Fi les
  1262   File 
  1263   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    
  1264   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.
  1265   References
  1266   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.
  1267   Appendix A : Pharmacy  Interface  Automatio n
  1268    REF Bulle tins_p32a  \h 
  1269  
  1270  
  1271    REF Bulle tins_p32a  \h 
  1272  
  1273  
  1274    REF Bulle tins_p32a  \h 
  1275   Introducti on
  1276   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. 
  1277   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. 
  1278   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.  
  1279   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. 
  1280   The minimu m required  VistA sof tware is:
  1281   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
  1282   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:
  1283   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.
  1284   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.
  1285   Provide PA DE the cap ability to  alert Vis tA Pharmac y of medic ation remo val from P ADE withou t orders.
  1286   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.
  1287   Refer to t he followi ng Pharmac y Interfac e Automati on documen ts for add itional in formation:
  1288   (will add  hyperlinks  once thes e are in f inal folde r or on TS PR)
  1289   Pharmacy I nterface A utomation  Installati on Guide
  1290   Pharmcy In terface Au tomation U ser Guide
  1291   Pharmacy I nterface A utomation  System Des ign Docume nt
  1292   Pharmacy I nterface A utomation  Data Dicti onary
  1293   Options an d Build Co mponents 
  1294   The follow ing are th e options  and build  components  for Pharm acy Interf ace Automa tion for P SS*1.0*193 :
  1295   Select OPT ION NAME:     XPD PRI NT BUILD      Build F ile Print
  1296   Build File  Print
  1297   Select BUI LD NAME: P SS*1.0*193        PHA RMACY DATA  MANAGEMEN T
  1298   DEVICE: HO ME// ;;999 99  SSH VI RTUAL TERM INAL
  1299   PACKAGE: P SS*1.0*193      Nov 2 5, 2015 10 :27 am                              PAGE 1
  1300   ---------- ---------- ---------- ---------- ---------- ---------- ---------- ---------
  1301   TYPE: SING LE PACKAGE                                   TRACK NAT IONALLY: Y ES
  1302   NATIONAL P ACKAGE: PH ARMACY DAT A MANAGEME NT       A LPHA/BETA  TESTING: N O
  1303   As part of  this patc h PSS*1*19 3, the fol lowing enh ancements  were made:
  1304   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 .
  1305   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.
  1306   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"
  1307   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 .
  1308   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 .
  1309   ENVIRONMEN T CHECK:                                  D ELETE ENV  ROUTINE: 
  1310    PRE-INIT  ROUTINE:                             DELETE  PRE-INIT  ROUTINE: 
  1311   POST-INIT  ROUTINE:                            DELETE  POST-INIT  ROUTINE: 
  1312   PRE-TRANSP ORT RTN: 
  1313   ROUTINE:                                           ACT ION:
  1314      PSSDEE                                              SEND TO SI TE
  1315      PSSHLDF S                                           SEND TO SI TE
  1316      PSSMSTR                                             SEND TO SI TE
  1317   OPTION:                                            ACT ION:
  1318      PSS MAS TER FILE A LL                               SEND TO SI TE
  1319   SECURITY K EY:                                     ACT ION:
  1320      PSS PAD E INIT                                      SEND TO SI TE
  1321   PROTOCOL:                                          ACT ION:
  1322      PSS MFN M01 CLIENT                                  SEND TO SI TE
  1323      PSS MFN M01 SERVER                                  SEND TO SI TE
  1324   REQUIRED B UILDS:                                  ACT ION:
  1325      PSS*1.0 *180                                        Don't inst all, leave  global
  1326   CDEVISC1A2 :DVA>
  1327   Modified a nd New Rou tines
  1328   The follow ing routin es are for  PSS*1*193 :
  1329   PSSDEE  
  1330   PSSHLDFS
  1331   PSSMSTR
  1332   (This page  included  for two-si ded copyin g.)
  1333   Glossary
  1334   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.