5. EPMO Open Source Coordination Office Redaction File Detail Report

Produced by Araxis Merge on 7/31/2018 9:10:44 AM 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.

5.1 Files compared

# Location File Last Modified
1 EPIP_CiF.zip\215-452\docs pss_1_tm.doc Thu Jul 26 12:11:24 2018 UTC
2 EPIP_CiF.zip\215-452\docs pss_1_tm.doc Thu Jul 26 12:42:04 2018 UTC

5.2 Comparison summary

Description Between
Files 1 and 2
Text Blocks Lines
Unchanged 4 2800
Changed 3 6
Inserted 0 0
Removed 0 0

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

5.4 Active regular expressions

No regular expressions were active.

5.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 J uly 2018)
  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 07/183PSS* 1*215Added  Section 2 .1.1 Data  Dictionary  Changes t o include  informatio n about th e RX# UPPE R BOUND WA RNING LIMI T field (# 48) added  to the PHA RMACY SYST EM file (# 59.7), and  the CLINI CAL ALERT  multiple f ield (#109 ) added to  the PHARM ACY PATIEN T file (#5 5).
  13   (R. Beltra n-West, PM ; N. Mulle r, Tech Wr iter)06/18 12-13PSS*1 *224Update d Routine  List - add ing new ro utines PSS DSEXF and  PSS224PI
  14   (S. Soldan , PM; L. B ertuzis, B A; B. Hyde , Tech Wri ter)03/182 , 11PSS*1. 0*211Updat ed File Li st to incl ude file # 50.60699
  15   Updated Ro utine List  with PSSN DSU and PS S211PO
  16   (J. Asel,  N. Boston  CTT&DM NDS  Medicatio ns Dosage  Form proje ct)02/1812 -13PSS*1*1 78Updated  Routine Li st
  17   (S. Soldan , PM; L. B ertuzis, B A; B. Hyde , Tech Wri ter)05/172 , 12, 34PS S*1*201Upd ated File  List
  18   Updated Ro utine List
  19   Added new  routine PS SOAS
  20   Updated Fi le Securit y
  21   (H.Cross,  PM; D. Ska hn, Tech W riter; L.  Bertuzis,  Developer) 10/1612
  22   34-37
  23   PSS*1*193A dded new r outine PSS HLDFS to t he Routine s section.
  24   Added Appe ndix A for  Pharmacy  Interface  Automation .
  25   (S. Soldan  PM; R.Wal ters, Tech  Writer)4/ 16i-ii,
  26   11-12, 22- 23PSS*1*17 5Add 2 new  Routines:  PSSCKOS &  PSSDIUTX,  Updated A dditional  Informatio n section
  27   (H. Cross,  PM; S. He iress, Tec h Writer;  R. Ruzback i, Develop er)3/16i-i i, 
  28    REF p11_R outineTabl e \h  \* M ERGEFORMAT  
  29   11-12PSS*1 *191Update d Revision  History
  30   Added new  routines t o routine  list:
  31   PSS1P191,  PSSHRHAI,  PSSMRRDG,  PSSMRRI
  32   (D. Connol ly, PM; E.  Phelps, T ech Writer )3/14All
  33   i - iii, 2 , 7-13, 33 , 37PSS*1* 172Renumbe red all pa ges.
  34   Updated Re vision His tory and T able of Co ntents.
  35   Updated th e Glossary  section b y putting  definition s in a tab le format.
  36   New menu,  options, f ile and ro utines add ed.
  37   (C. Powell , PM; K. K apple, Tec h Writer)9 /13i - iii , 3, 7 – 1 3a, 30, 34  - 35PSS*1 *160Update d Revision  History
  38   Updated Ta ble of Con tents with  Exported  Options an d Routines  sections
  39   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 
  40   [PSS TRAIL ING SPACES  REPORT]. 
  41   Added PSS  DOSING ORD ER CHECKS  option
  42   Also added  the follo wing routi nes to the  routine l ist:
  43   PSS160EN
  44   PSS160PO
  45   PSSDRDOS
  46   PSSFDBDI
  47   PSSDSONF
  48   Added Web  Servers, W eb Service s, and Cac he Class s ection
  49   Added text  to the Se curity Key s section
  50   (D. McCanc e, PM; K.  Kapple, Te ch Writer) 01/13i-iv,  3, 6-6b,  7, 10 - 13 PSS*1*164
  51   PSS*1*169R emoved ref erence to  patch PSS* 1*146 in t he menu op tions sect ion
  52   Added Prin t Interfac e Data Fil e option t o the Phar macy Data  Management  [PSS MGR]  menu
  53   Added Chec k Drug Int eraction o ption to t he Pharmac y Data Man agement [P SS MGR] me nu
  54   Moved Menu /Option it ems from p age 7 to p age 6a
  55   Added Prin t Interfac e Data Fil e option t o the PEPS  Services  menu under  the Optio n Descript ions secti on
  56   Added Chec k Drug Int eraction o ption to t he Option  Descriptio ns section
  57   Added rout ine PSSDIU TL
  58   Added Find  Unmapped  Local Poss ible Dosag es option  to the Sta nd Alone O ptions sec tion
  59   (G. Tucker , PM; G. S corca, Tec h Writer)0 6/12AllPSS *1*146Reis sued docum ent. Remov ed redunda ncies due  to MOCHA V .1.0 incre mental rel ease; upda ted format ting and p age numera tion.
  60   (N. Goyal,  PM; J. Ow czarzak, T ech Writer )Table of  Contentsxe  "Table of  Contents"
  61   Contents
  62   11
  63   Introducti on
  64  
  65  
  66   22
  67   File List
  68  
  69  
  70   32.1
  71   File Descr iptions
  72  
  73  
  74   32.1.1
  75   Data Dicti onary Chan ges
  76  
  77  
  78   42.2
  79   Menu/Optio ns
  80  
  81  
  82   83
  83   Option Des criptions
  84  
  85  
  86   123.1
  87   Orderable  Items Opti on
  88  
  89  
  90   123.2
  91   Routines
  92  
  93  
  94   143.3
  95   Exported O ptions
  96  
  97  
  98   143.3.1
  99   Stand-Alon e Options
  100  
  101  
  102   143.4
  103   Protocols
  104  
  105  
  106   153.5
  107   Bulletins
  108  
  109  
  110   153.6
  111   Web Server s
  112  
  113  
  114   153.7
  115   Web Servic es
  116  
  117  
  118   153.8
  119   Cache Clas s
  120  
  121  
  122   153.9
  123   HL7 Messag ing with a n External  System
  124  
  125  
  126   153.9.1
  127   HL7 Drug M essage Seg ment Defin ition Tabl e
  128  
  129  
  130   193.9.2
  131   HL7 Drug M essage Seg ment Defin ition Tabl e
  132  
  133  
  134   213.10
  135   Data Archi ving and P urging
  136  
  137  
  138   223.11
  139   Callable R outines/En try Points /Applicati on Program  Interface s (APIs)
  140  
  141  
  142   223.12
  143   Medication  Routes
  144  
  145  
  146   223.13
  147   Administra tion Sched uling
  148  
  149  
  150   233.14
  151   External R elations
  152  
  153  
  154   233.15
  155   Internal R elations
  156  
  157  
  158   233.16
  159   Package-Wi de Variabl es
  160  
  161  
  162   234
  163   Package Re quirements
  164  
  165  
  166   244.1
  167   Additional  Informati on
  168  
  169  
  170   305
  171   Security M anagement
  172  
  173  
  174   305.1
  175   Mail Group s
  176  
  177  
  178   305.2
  179   Alerts
  180  
  181  
  182   305.3
  183   Bulletins
  184  
  185  
  186   305.4
  187   Remote Sys tems
  188  
  189  
  190   305.5
  191   Archiving/ Purging
  192  
  193  
  194   315.6
  195   Contingenc y Planning
  196  
  197  
  198   315.7
  199   Interfacin g
  200  
  201  
  202   315.8
  203   Electronic  Signature s
  204  
  205  
  206   315.9
  207   Locked Men u Options
  208  
  209  
  210   315.10
  211   Security K eys
  212  
  213  
  214   325.11
  215   File Secur ity
  216  
  217  
  218   335.11.1
  219   PDM Files
  220  
  221  
  222   335.11.2
  223   Non-PDM Fi les
  224  
  225  
  226   345.12
  227   References
  228  
  229  
  230   356
  231   Appendix A : Pharmacy  Interface  Automatio n
  232  
  233  
  234   366.1
  235   New Functi onality
  236  
  237  
  238   366.2
  239   Options an d Build Co mponents
  240  
  241  
  242   376.3
  243   Modified a nd New Rou tines
  244  
  245  
  246   397
  247   Glossary
  248  
  249  
  250  
  251  
  252   (This page  included  for two-si ded copyin g.)
  253   Introducti on XE "Int roduction"  
  254   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.
  255   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.
  256   Notationsx e "Notatio ns" that w ill be use d consiste ntly throu ghout this  PDM Techn ical Manua l are outl ined below .
  257   Menu optio ns will be  italicize d.
  258   Example: T he Drug En ter/Edit o ption perm its you to  enter or  edit a dru g.
  259   Screen pro mpts will  be denoted  with quot ation mark s around t hem.
  260   Example: t he "SELECT  DRUG" pro mpt will d isplay nex t.
  261   Responses  in bold fa ce indicat e user inp ut.
  262   Example: D RUG GENERI C NAME: AC ETA
  263   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.
  264   <Enter> in dicates th at the Ent er key (or  Return ke y on some  keyboards)  must be p ressed.
  265   Example: T ype Y for  Yes or N f or No and  press <Ent er> 
  266   <Tab> indi cates that  the Tab k ey must be  pressed.
  267   Example:   Press <Tab > to move  the cursor  to the ne xt field.
  268    Indicates  especiall y importan t or helpf ul informa tion.
  269    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.
  270   Example:      Without  the PSXCO MPMGR key,  the Conso lidated Ma il Outpati ent Pharma cy options  cannot be  accessed.  
  271   ( The page  symbol in dicates a  referral t o a diagra m.
  272   ?, ??, ???   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.
  273   ^  Up arro w (caret o r a circum flex) and  pressing < Enter> can  be used t o exit the  present o ption.
  274   File List
  275   The follow ing PDM fi les are ex ported wit h the PDM  package. 
  276   File#        NAME           
  277   UPDATE 
  278   DATA COMES     USER
  279  
  280   DD
  281   WITH FILE    OVERRIDE
  282   50           DRUG 
  283   FULL
  284   NO
  285  
  286   50.4         DRUG ELE CTROLYTES 
  287   FULL
  288   NO
  289   50.606       DOSAGE F ORM                    
  290   FULL
  291   YES (MERGE )
  292   NO
  293   50.60699     MASTER D OSAGE FORM
  294   FULL
  295   NO
  296   50.7         PHARMACY  ORDERABLE  ITEM 
  297   FULL
  298   NO
  299   51           MEDICATI ON INSTRUC TION         
  300   FULL
  301   NO
  302   51.1         ADMINIST RATION SCH EDULE       
  303   FULL
  304   YES (MERGE )
  305   YES
  306   51.2         MEDICATI ON ROUTES            
  307   FULL
  308   YES (MERGE )
  309   YES
  310   51.23        STANDARD  MEDICATIO N ROUTES           FU LL
  311   YES
  312   NO
  313                                                                        (OVERWR ITE)
  314   51.24        DOSE UNI TS
  315   FULL
  316   YES
  317   NO
  318  
  319                   (OVER WRITE)
  320   51.25        DOSE UNI T CONVERSI ON
  321   FULL
  322   YES
  323   NO
  324                                                                         (OVERW RITE)
  325   51.5         ORDER UN IT 
  326   FULL
  327   NO
  328   51.7         DRUG TEX T
  329   FULL
  330   YES
  331   YES
  332  
  333  
  334                   (OVER WRITE)
  335   52.6         IV ADDIT IVES 
  336   FULL
  337   NO
  338   52.7         IV SOLUT IONS 
  339   FULL
  340   NO
  341   53.47        INFUSION  INSTRUCTI ONS
  342   FULL
  343   NO
  344   54           RX CONSU LT 
  345   FULL (SCRE EN)
  346   NO
  347   55           PHARMACY  PATIENT ( Partial DD )
  348   PARTIAL
  349   NO
  350   59.7         PHARMACY  SYSTEM 
  351   FULL
  352   NO
  353   59.73         VENDOR  DISABLE/EN ABLE
  354   FULL
  355   NO
  356   59.74         VENDOR  INTERFACE  DATA 
  357   FULL
  358   NO
  359   The follow ing non-PD M files ar e exported  with the  PDM packag e. 
  360   File#        NAME           
  361   UPDATE 
  362   DATA COMES     USER
  363  
  364   DD
  365   WITH FILE    OVERRIDE
  366   200          NEW PERS ON (Partia l DD)
  367   PARTIAL
  368   NO
  369   9009032.3    APSP INT ERVENTION  TYPE      
  370   FULL
  371   YES
  372  
  373   NO
  374  
  375  
  376   (OVERWRITE )
  377   9009032.4    APSP INT ERVENTION 
  378   FULL
  379   NO
  380   9009032.5    APSP INT ERVENTION  RECOMMENDA TION 
  381   FULL
  382   YES
  383   NO
  384  
  385  
  386   (OVERWRITE )
  387   File Descr iptions
  388   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.
  389   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.
  390   Data Dicti onary Chan ges
  391   Patch PSS* 1.0*215 ad ds the RX#  UPPER BOU ND WARNING  LIMIT fie ld (#48) t o the PHAR MACY SYSTE M file (#5 9.7). The  value stor ed in this  field det ermines wh en an earl y warning  message is  sent to m embers of  a new PHAR MACY SUPER VISORS Mai lMan group
  392   This patch  is a comp anion patc h to PSO*7 .0*452, wh ich implem ents an ea rly warnin g message  to notify  mail group  recipient s that one  or more O utpatient  Pharmacy s ites are a pproaching  the upper  limit of  the define d prescrip tion numbe ring serie s. If  no  custom val ue is ente red in thi s field, t hen the me ssage will  be sent w hen 1000 n umbers rem ain in the  series, a nd again e ach time t he associa ted backgr ound job r uns and le ss than 10 00 numbers  remain in  the serie s. Refer t o the Outp atient Pha rmacy (PSO ) Manager’ s User Gui de for mor e informat ion about  the early  warning fu nctionalit y that use s this new  field.
  393   Patch PSS* 1.0*215 al so adds a  CLINICAL A LERT multi ple field  (#109) to  the PHARMA CY PATIENT  file (#55 ). This fi eld stores  the date  and time o f the Clin ical Alert  and provi des a free -text fiel d for the  alert text , which is  displayed  when usin g certain  Outpatient  Pharmacy  [PSO] opti ons. Pharm acy Superv isors can  use Clinic al Alerts  to make Ph armacy sta ff aware o f informat ion such a s drug int eractions  or the pat ient’s par ticipation  in clinic al trials.  Refer to  the Outpat ient Pharm acy (PSO)  Manager’s  User Guide  for more  informatio n about th e Clinical  Alert fun ctionality  that uses  this new  field.
  394     Note: Th e Clinical  Alert Ent er/Edit [P SO CLINICA L ALERT EN TER/EDIT]  option in  the Outpat ient Pharm acy packag e is used  to add, mo dify, or d elete Clin ical Alert s. 
  395   Menu/Optio ns
  396   The PDM op tions list ed below s how the PS S MGR Menu  structure .
  397   Pharmacy D ata Manage ment [PSS  MGR] menu:
  398   CMOP Mark/ Unmark (Si ngle drug)  
  399   [PSSXX MAR K]   
  400   Dosages…
  401   [PSS DOSAG ES MANAGEM ENT]
  402   Dosage For m File Ent er/Edit 
  403   [PSS DOSAG E FORM EDI T]
  404   Enter/Edit  Dosages 
  405   [PSS EDIT  DOSAGES]
  406   Most Commo n Dosages  Report 
  407   [PSS COMMO N DOSAGES]
  408   Noun/Dosag e Form Rep ort 
  409   [PSS DOSE  FORM/ NOUN  REPORT]
  410   Review Dos ages Repor
  411   [PSS DOSAG E REVIEW R EPORT]
  412   Local Poss ible Dosag es Report 
  413   [PSS LOCAL  POSSIBLE  DOSAGES] 
  414   Request Ch ange to Do se Unit 
  415   [PSS DOSE  UNIT REQUE ST]
  416   Lookup Dos ing Check  Info for D rug
  417   [PSS DRUG  DOSING LOO KUP]
  418   Drug Names  with Trai ling Space s Report 
  419   [PSS TRAIL ING SPACES  REPORT]
  420   Drug Enter /Edit
  421   [PSS DRUG  ENTER/ EDI T]
  422   Order Chec k Manageme nt…
  423   [PSS ORDER  CHECK MAN AGEMENT] 
  424              Request Ch anges to E nhanced Or der Check  Database
  425   [PSS ORDER  CHECK CHA NGES]
  426   Report of  Locally En tered Inte ractions
  427   [PSS REPOR T LOCAL IN TERACTIONS ]
  428         Elec trolyte Fi le (IV)
  429   [PSSJI ELE CTROLYTE F ILE]
  430   Lookup int o Dispense  Drug File
  431   [PSS LOOK]
  432   Medication  Instructi on Managem ent... 
  433   [PSS MED I NSTRUCTION  MANAGEMEN T]
  434   Medication  Instructi on File Ad d/Edit
  435   [PSSJU MI]
  436   Medication  Instructi on File Re port 
  437   [PSS MED I NSTRUCTION  REPORT]
  438   Medication  Routes Ma nagement..
  439   [PSS MEDIC ATION ROUT ES MGMT]
  440   Medication  Route Fil e Enter/Ed it
  441   [PSS MEDIC ATION ROUT ES EDIT]
  442   Medication  Route Map ping Repor
  443   [PSS MED R OUTE MAPPI NG REPORT]
  444   Medication  Route Map ping Histo ry Report 
  445   [PSS MED R OUTE MAPPI NG CHANGES ]
  446   Request Ch ange to St andard Med ication Ro ute 
  447   [PSS MEDIC ATION ROUT E REQUEST]
  448   Default Me d Route fo r OI Repor t
  449   [PSS DEF M ED ROUTE O I RPT]
  450   Orderable  Item Manag ement…
  451   [PSS ORDER ABLE ITEM  MANAGEMENT ]
  452   Edit Order able Items
  453   [PSS EDIT  ORDERABLE  ITEMS]
  454   Dispense D rug/Ordera ble Item M aintenance
  455   [PSS MAINT AIN ORDERA BLE ITEMS]
  456   Orderable  Item/Dosag es Report
  457   [PSS ORDER ABLE ITEM  DOSAGES]
  458   Patient In structions  Report
  459   [PSS INSTR UCTIONS/ I TEMS REPOR T]
  460   Orderable  Item Repor t
  461   [PSS ORDER ABLE ITEM  REPORT]
  462   Orderable  Items that  Require R emoval Rep ort
  463            [ PSS MRR OR DERABLE IT EMS RPT]
  464   Orderable  Items for  High Risk\ High Alert
  465            [ PSS HR/HA  ORDERABLE  ITEMS RPT]
  466   Formulary  Informatio n Report
  467   [PSSNFI]
  468   Drug Text  Management ... 
  469   [PSS DRUG  TEXT MANAG EMENT]
  470   Drug Text  Enter/Edit
  471   [PSS EDIT  TEXT] 
  472   Drug Text  File Repor t
  473   [PSS DRUG  TEXT FILE  REPORT]
  474   Pharmacy S ystem Para meters Edi t
  475   [PSS SYS E DIT]
  476   Standard S chedule Ma nagement..
  477   [PSS SCHED ULE MANAGE MENT]
  478   Standard S chedule Ed it
  479   [PSS SCHED ULE EDIT] 
  480   Administra tion Sched ule File R eport 
  481   [PSS SCHED ULE REPORT ]
  482   Synonym En ter/Edit
  483   [PSS SYNON YM EDIT]
  484   Controlled  Substance s/PKI Repo rts… 
  485   [PSS CS/PK I REPORTS]
  486   DEA Spec H dlg & CS F ed Sch Dis crepancy 
  487   [PSS DEA V S CS FED.  SCH. DISCR .]
  488   Controlled  Substance s Not Matc hed to NDF  
  489   [PSS CS NO T MATCHED  TO NDF]
  490   CS (DRUGS)  Inconsist ent with D EA Spec Hd lg 
  491   [PSS CS DR UGS INCON  WITH DEA]
  492   CS (Ord. I tem) Incon sistent wi th DEA Spe c Hdlg
  493   [PSS CS (O I) INCON W ITH DEA] 
  494   Send Entir e Drug Fil e to Exter nal Interf ace
  495   [PSS MASTE R FILE ALL ]
  496   IV Additiv e/Solution  …
  497   [PSS ADDIT IVE/SOLUTI ON]
  498        IV Ad ditive Rep ort 
  499        [PSS  IV ADDITIV E REPORT]
  500   IV Solutio n Report 
  501                   [PSS  IV SOLUTIO N REPORT]
  502    Mark PreM ix Solutio ns 
  503                   [PSS  MARK PREMI X SOLUTION S]
  504   Warning Bu ilder
  505   [PSS WARNI NG BUILDER ]
  506   Warning Ma pping
  507   [PSS WARNI NG MAPPING ]
  508   PEPS Servi ces…
  509   [PSS PEPS  SERVICES]
  510               Check Ven dor Databa se Link 
  511             
  512    
  513   [PSS CHECK  VENDOR DA TABASE LIN K]
  514    Check PEP S Services  Setup
  515             
  516                 [PSS CH ECK PEPS S ERVICES SE TUP]
  517   Schedule/R eschedule  Check PEPS  Interface
  518               
  519  
  520   [PSS SCHED ULE PEPS I NTERFACE C K]
  521   Print Inte rface Data  File
  522  
  523  
  524   [PSS VENDO R INTERFAC E REPORT]
  525   Inpatient  Drug Manag ement…
  526   [PSS INP M GR]
  527      ADditiv es File 
  528      [PSSJI  DRUG]
  529     Dispense  Drug Fiel ds 
  530     [PSSJU D RG]
  531     Dispense  Drug/ATC  Set Up 
  532     [PSSJU D RUG/ATC SE T UP]
  533     Edit Cos t Data 
  534     [PSSJU D CC]
  535     EDit Dru g Cost (IV
  536     [PSSJI E DIT DRUG C OST]
  537     MARk/Unm ark Dispen se Drugs F or Unit Do se 
  538     [PSSJU M ARK UD ITE MS]
  539     PRimary  Solution F ile (IV)
  540     [PSSJI S OLN]
  541   Check Drug  Interacti on
  542   [PSS CHECK  DRUG INTE RACTION]
  543   Infusion I nstruction  Managemen t …
  544   [PSS INFIN S MGR]
  545   Infusion I nstruction s Add/Edit
  546   [PSS INFIN S ADED]
  547   Infusion I nstruction  Report
  548   [PSS INFIN S RPT]
  549   Orders for  MRRs With  Removal P roperties
  550   [PSS MRR O RDERS DIAG NOSTIC RPT ]
  551        Locke d: PSXCMOP MGR
  552   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.
  553   Option Des criptions
  554   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.
  555   PSS MGR Ph armacy Dat a Manageme nt   
  556   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.
  557   ITEM: PSS  DRUG ENTER /EDIT                
  558   ITEM: PSS  LOOK                            
  559   ITEM: PSSJ I ELECTROL YTE FILE             
  560   ITEM: PSSX X MARK                          
  561   ITEM: PSS  SYS EDIT                        
  562   ITEM: PSS  ORDERABLE  ITEM MANAG EMENT     
  563   ITEM: PSSN FI                              
  564   ITEM: PSS  SYNONYM ED IT                   
  565   ITEM: PSS  DOSAGES MA NAGEMENT             
  566   ITEM: PSS  CS/PKI REP ORTS                 
  567   ITEM: PSS  MASTER FIL E ALL                
  568   ITEM: PSS  MEDICATION  ROUTES MG MT        
  569   ITEM: PSS  SCHEDULE M ANAGEMENT            
  570   ITEM: PSS  DRUG TEXT  MANAGEMENT           
  571   ITEM: PSS  MED INSTRU CTION MANA GEMENT    
  572   ITEM: PSS  ORDER CHEC K MANAGEME NT        
  573   ITEM: PSS  ADDITIVE/S OLUTION              
  574   ITEM: PSS  WARNING BU ILDER                
  575   ITEM: PSS  WARNING MA PPING                
  576   ITEM: PSS  PEPS SERVI CES                  
  577   ITEM: PSS  INP MGR
  578   ITEM: PSS  Check Drug  Interacti on
  579   ITEM: PSS  INFINS MGR
  580   ITEM: PSS  MRR ORDERS  DIAGNOSTI C RPT
  581   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------  
  582   PSS DRUG E NTER/EDIT
  583   Drug Enter /Edit    
  584   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.
  585   TYPE: run  routine    ROUTINE: P SSDEE
  586   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  587   PSS LOOK
  588   Lookup int o Dispense  Drug File
  589   This optio n provides  a report  of all inf ormation r egarding t he dispens e drug.
  590   TYPE: run  routine    ROUTINE: P SSLOOK
  591   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  592   PSSJI ELEC TROYLYTE F ILE
  593   Electrolyt e File (IV )
  594   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.
  595   TYPE: run  routine    ROUTINE: E LECTRO^PSS IVDRG
  596   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  597   PSSXX MARK
  598   CMOP Mark/ Unmark (Si ngle drug)
  599   This optio n allows t he user to  mark/unma rk a singl e drug for  transmiss ion to the  CMOP.  
  600   TYPE: run  routine    ROUTINE: P SSMARK                        
  601   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  602   PSS SYS ED IT
  603   Pharmacy S ystem Para meters Edi t
  604   This optio n allows t he user to  edit the  Pharmacy S ystem para meters use d in Pharm acy Data M anagement.   
  605   TYPE: run  routine    ROUTINE: P SSYSP
  606   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  607   PSS ORDERA BLE ITEM M ANAGEMENT
  608   Orderable  Item Manag ement  
  609   This is th e sub-menu  driver fo r Orderabl e Item mai ntenance.   
  610   ITEM: PSS  MAINTAIN O RDERABLE I TEMS      
  611   ITEM: PSS  EDIT ORDER ABLE ITEMS           
  612   ITEM: PSS  ORDERABLE  ITEM DOSAG ES        
  613   ITEM: PSS  INSTRUCTIO NS/ITEMS R EPORT     
  614   ITEM: PSS  ORDERABLE  ITEM REPOR T         
  615   TYPE: menu   
  616   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  617   PSSNFI
  618   Formulary  Informatio n Report
  619   This optio n provides  a listing  of pertin ent pharma cy formula ry informa tion.  
  620   TYPE: run  routine    ROUTINE: P SSNFI
  621   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  622   PSS SYNONY M EDIT
  623   Synonym En ter/Edit          
  624   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.  
  625   TYPE: run  routine    ROUTINE: P SSSEE                         
  626   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  627   PSS DOSAGE S MANAGEME NT
  628   Dosages                      
  629   This menu  option con tains opti ons that c ontrol the  editing o f dosages.   
  630   ITEM: PSS  DOSAGE FOR M EDIT               
  631   ITEM: PSS  EDIT DOSAG ES                   
  632   ITEM: PSS  COMMON DOS AGES                 
  633   ITEM: PSS  DOSE FORM/ NOUN REPOR T         
  634   ITEM: PSS  DOSAGE REV IEW REPORT           
  635   ITEM: PSS  LOCAL POSS IBLE DOSAG ES        
  636   ITEM: PSS  DOSE UNIT  REQUEST              
  637   TYPE: menu   
  638   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  639   PSS CS/PKI  REPORTS
  640   Controlled  Substance s/PKI Repo rts
  641   PKI POST-I NSTALL REP ORTS PROVI DED AS OPT IONS.  
  642   ITEM: PSS  DEA VS CS  FED. SCH.  DISCR.    
  643   ITEM: PSS  CS NOT MAT CHED TO ND F         
  644   ITEM: PSS  CS DRUGS I NCON WITH  DEA       
  645   ITEM: PSS  CS (OI) IN CON WITH D EA        
  646   TYPE: menu   
  647   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  648   PSS MASTER  FILE ALL
  649   Send Entir e Drug Fil e to Exter nal Interf ace
  650   TYPE: run  routine    ROUTINE: P SSMSTR  
  651   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  652   PSS MEDICA TION ROUTE S MGMT
  653   Medication  Routes Ma nagement
  654   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.
  655   ITEM: PSS  MEDICATION  ROUTES ED IT        
  656   ITEM: PSS  MED ROUTE  MAPPING RE PORT      
  657   ITEM: PSS  MED ROUTE  MAPPING CH ANGES     
  658   ITEM: PSS  MEDICATION  ROUTE REQ UEST      
  659   ITEM: PSS  DEF MED RO UTE OI RPT           
  660   TYPE: menu   
  661   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------  
  662   PSS SCHEDU LE MANAGEM ENT
  663   Standard S chedule Ma nagement
  664   This Sub-M enu contai ns options  needed fo r Schedule  maintenan ce. 
  665   ITEM: PSS  SCHEDULE E DIT                  
  666   ITEM: PSS  SCHEDULE R EPORT                
  667   TYPE: menu   
  668   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  669   PSS DRUG T EXT MANAGE MENT
  670   Drug Text  Management        
  671   This Sub-M enu contai ns options  concernin g Drug Tex t.  
  672   ITEM: PSS  EDIT TEXT                       
  673   ITEM: PSS  DRUG TEXT  FILE REPOR T         
  674   TYPE: menu   
  675   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  676   PSS MED IN STRUCTION  MANAGEMENT
  677   Medication  Instructi on Managem ent
  678   The Sub-Me nu contain s options  related to  the MEDIC ATION INST RUCTION (# 51) File.   
  679   ITEM: PSSJ U MI                            
  680   ITEM: PSS  MED INSTRU CTION REPO RT        
  681   TYPE: menu   
  682   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  683   PSS ORDER  CHECK MANA GEMENT
  684   Order Chec k Manageme nt     
  685   This is th e sub-menu  for funct ionality r elated to  managing m edication  order chec ks.  
  686   ITEM: PSS  ORDER CHEC K CHANGES            
  687   ITEM: PSS  REPORT LOC AL INTERAC TIONS     
  688   TYPE: menu   
  689   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  690   PSS ADDITI VE/SOLUTIO N
  691   IV Additiv e/Solution        
  692   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. 
  693   ITEM: PSS  IV ADDITIV E REPORT            
  694   ITEM: PSS  IV SOLUTIO N REPORT             
  695   ITEM: PSS  MARK PREMI X SOLUTION S         
  696   TYPE: menu   
  697   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  698   PSS WARNIN G BUILDER
  699   Warning Bu ilder             
  700   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. 
  701   TYPE: run  routine    ROUTINE: P SSWRNB                        
  702   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  703   PSS WARNIN G MAPPING
  704   Warning Ma pping             
  705   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.  
  706   TYPE: run  routine    ROUTINE: E DIT^PSSWMA P                  
  707   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  708   PSS PEPS S ERVICES
  709   PEPS 
  710   ITEM: PSS  CHECK VEND OR DATABAS E LINK    
  711   ITEM: PSS  CHECK PEPS  SERVICES  SETUP     
  712   ITEM: PSS  SCHEDULE P EPS INTERF ACE CK    
  713   ITEM: PSS  VENDOR INT ERFACE REP ORT       
  714   TYPE: menu   
  715   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  716   PSS INP MG R                         
  717   Inpatient  Drug Manag ement
  718   This Sub-M enu contai ns options  related t o INPATIEN T DRUG MAN AGEMENT.  
  719   ITEM: PSSJ I DRUG                          
  720   ITEM: PSSJ U DRG                           
  721   ITEM: PSSJ U DRUG/ATC  SET UP              
  722   ITEM: PSSJ U DCC                           
  723   ITEM: PSSJ I EDIT DRU G COST               
  724   ITEM: PSSJ U MARK UD  ITEMS                
  725   ITEM: PSSJ I SOLN                          
  726   TYPE: Menu
  727   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  728   PSS CHECK  DRUG INTER ACTION
  729   Check Drug  Interacti on
  730   This menu  contains o ptions per taining to  maintaini ng pharmac y
  731   data files , creating  Pharmacy  Orderable  Items, and  the Medic ation Rout e/ 
  732   Instructio ns table a mong other  assorted  functions.
  733   TYPE: run  routine RO UTINE: PSS DIUTL
  734   PSS INFINS  MGR
  735   Infusion I nstruction  Managemen t
  736   Menu conta ining opti ons relate d to the I NFUSION IN STRUCTIONS  (#53.47)  file.
  737   TYPE: menu
  738   PSS INFINS  ADED 
  739   Infusion I nstruction s Add/Edit
  740   Allows use rs to ente r and edit  abbreviat ions and e xpansions  in the INF USION INST RUCTIONS ( #53.47) fi le.
  741   TYPE: run  routine  R OUTINE: EN II^PSSFILE D
  742  
  743   PSS INFINS  RPT
  744   Infusion I nstruction s Report
  745   Provides a  report of  entries f rom the IN FUSION INS TRUCTIONS( #53.47) fi le
  746   TYPE: run  routine RO UTINE: EN^ PSSIIRPT
  747   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -------
  748   PSS MRR OR DERS DIAGN OSTIC RPT
  749   Orders for  MRRs With  Removal P roperties
  750    Orderable  Items Opt ion
  751   This optio n enables  you to det ermine whi ch active  orders con tain Order able Items  that have  the new " Prompt for  Removal i n BCMA" fl ag value s et to 1, 2  or 3 that  need to b e disconti nued and e ntered as  New (not c opied, edi ted or ren ewed) AFTE R the inst allation o f Pharmacy  Inpatient  
  752   Medication s PSJ*5.0* 315. Failu re to re-c reate thes e orders c ould resul t in confu sing infor mation to  display on  the BCMA  VDL if dis played alo ngside new er MRR ord ers that d o have the  updated r emoval inf ormation.
  753   TYPE: run  routine  R OUTINE: EN ^PSSMRRDG
  754   Routines
  755   The follow ing routin es are use d by the P harmacy Da ta Managem ent packag e.
  756   PSS0052PSS 0093PSS011 4PSS102RPP SS117EN PS S117PO PSS 127PI PSS1 27PTPSS129 EN PSS147E N PSS147PO  PSS160EN  PSS160POPS S172POPSS1 P135 PSS1P 154 PSS1P1 78PSS1P201 PSS1P23  P SS1P43  PS S211POPSS2 24PIPSS32P 3PSS32P5   PSS50    P SS50A   PS S50A1  PSS 50AQM PSS5 0ATC PSS50 B   PSS50B 1PSS50B2   PSS50C   P SS50C1 PSS 50CMP PSS5 0D   PSS50 DAT PSS50D OS PSS50EP SS50F   PS S50F1  PSS 50LAB PSS5 0NDF PSS50 P4  PSS50P 66 PSS50P7   PSS50P7A PSS50TMP P SS50WS  PS S51    PSS 51P1  PSS5 1P15 PSS51 P1A PSS51P 1B PSS51P1 CPSS51P2   PSS51P5  P SS51P5  PS S52P6PSS52 P6A PSS52P 6B PSS52P7   PSS52P7A  PSS54PSS5 5PSS551    PSS55MIS P SS59P7  PS S70UTL PSS 781   PSSA DDITPSSADR PTPSSAUTL   PSSBPSUT  PSSCHENV P SSCHPRE PS SCHPSTPSSC LDRG PSSCL INR PSSCLO ZPSSCMOPE  PSSCOMMN P SSCPRS  PS SCPRS1 PSS CREAT PSSC SPD  PSSCU SRQ PSSDAC SPSSDAWUT  PSSDDUT  P SSDDUT2 PS SDDUT3 PSS DEE   PSSD EE1 PSSDEE 2 PSSDELOI PSSDENT  P SSDFEE  PS SDGUPD PSS DI    PSSD IN  PSSDIN T  PSSDFEE   PSSDIUTL PSSDOS PSS DOSEDPSSDO SERPSSDOSL Z PSSDOSRP  PSSDRINT  PSSDRDOS P SSDSAPA PS SDSAPD PSS DSAPI PSSD SAPKPSSDSA PL PSSDSAP M  PSSDSBB P  PSSDSBD APSSDSBDBP SSDSBPA PS SDSBPB PSS DSBPCPSSDS BPD  PSSDS DATPSSDSEX C PSSDSEXD PSSDSEXEPS SDSFDB PSS DSONF PSSD SPON PSSDS POP PSSDSU TAPSSDSUTL PSSDTR PSS EC123PSSEN V   PSSDSE XFPSSENVN   PSSFDBDI  PSSFDBRT P SSFIL    P SSFILED PS SFILES  PS SGENM  PSS GIUPSSGMI    PSSGS0    PSSGSGUI  PSSGSH     PSSHELP  P SSHFREQ PS SHL1   PSS HLDFSPSSHL SCHPSSHLU  PSSHRCOM   PSSHRENV P SSHREQ  PS SHRIT  PSS HRPST PSSH RQ2PSSHRQ2 2  PSSHRQ2 3   PSSHRQ 24PSSHRQ25 PSSHRQ2DPS SHRQ2O  PS SHRVAL     PSSHRVL1 P SSHTTP  PS SHUIDGPSSI IRPT PSSJE EUPSSJORDF   PSSJSPU   PSSJSPU0   PSSJSV     PSSJSV0    PSSJXR     PSSJXR1    PSSJXR10P SSJXR11  P SSJXR12PSS JXR13  PSS JXR14  PSS JXR15  PSS JXR16 PSSJ XR17  PSSJ XR18PSSJXR 19  PSSJXR 2   PSSJXR 20  PSSJXR 21 PSSJXR2 2  PSSJXR2 3  PSSJXR2 4  PSSJXR2 5PSSJXR26   PSSJXR27  PSSJXR28   PSSJXR29   PSSJXR3    PSSJXR30   PSSJXR31   PSSJXR32PS SJXR33  PS SJXR34  PS SJXR4   PS SJXR5   PS SJXR6   PS SJXR7 PSSJ XR8   PSSJ XR9PSSLAB     PSSLDAL L  PSSLDED T  PSSLDOS EPSSLOCK    PSSLOOK    PSSMARK    PSSMATCHP SSMEDCH  P SSMEDRQ PS SMEDRT  PS SMEDX   PS SMIRPT  PS SMONT   PS SMRTUP  PS SMRTUXPSSM STR   PSSN CPDP PSSND CUT  PSSND SUPSSNFI     PSSNFIP    PSSNOD2   PSSNOUNR   PSSNTEG P SSOAS  PSS OICTPSSOIC T1  PSSOID OS  PSSOPK I  PSSOPKI 1  PSSORPH    PSSORPH 1PSSORPHZP SSORUTEPSS ORUTLPSSOR UTZPSSOUTS CPSSP110PS SP130   PS SP134   PS SPCH13PSSP I89   PSSP KIPIPSSPKI PR PSSPNSR P  PSSPO12 9  PSSPOI  PSSPOIC    PSSPOID1PS SPOID2 PSS POID3  PSS POIDT  PSS POIKA PSSP OIM   PSSP OIM1  PSSP OIM2 PSSPO IM3PSSPOIM N  PSSPOIM O PSSPOIMP   PSSPOST    PSSPOST2 PSSPOST5   PSSPOST6   PSSPREPSSP RE38  PSSP RETR  PSSP RMIXPSSPRU TL  PSSQOC     PSSQOR D  PSSREF     PSSREMC H PSSRXACT   PSSSCHED   PSSSCHMS PSSSCHRP   PSSSEE   P SSSUTILPSS SXRDPSSSYN PSSTRENG   PSSTXT     PSSUNMSI P SSUTIL   P SSUTIL1  P SSUTIL3PSS UTLA1  PSS UTLA2  PSS UTLAZ PSSU TLPR  PSSU TLPZ  PSSV IDRGPSSVX6     PSSVX6 1PSSVX62   PSSVX63    PSSVX64    PSSVX65PSS VX66   PSS WMAP   PSS WRNA PSSWR NBPSSWRNC    PSSWRNEP SSXDIC   P SSXREF     PSSXRF1  P SSYSPExpor ted Option s
  757   Stand-Alon e Options
  758   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 ]:
  759   Other Lang uage Trans lation Set up
  760   [PSS OTHER  LANGUAGE  SETUP]
  761   Drug Inqui ry (IV) 
  762   [PSSJI DRU G INQUIRY]
  763   Electrolyt e File (IV
  764   [PSSJI ELE CTROLYTE F ILE]
  765   Enable/Dis able Vendo r Database  Link
  766   [PSS ENABL E/DISABLE  DB LINK]
  767   Add Defaul t Med Rout e
  768   [PSS ADD D EFAULT MED  ROUTE]
  769   Find Unmap ped Local  Possible D osages
  770   [PSS LOCAL  DOSAGES E DIT ALL]
  771   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].
  772   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).
  773   Protocols
  774   NAME: PSS  EXT MFU CL IENT 
  775    DESCRIPTI ON:   This  protocol  will be us ed as the  ACK from t he externa l
  776    interface  for a MFN _M01 messa ge.  
  777   NAME: PSS  EXT MFU SE RVER 
  778    DESCRIPTI ON:   This  protocol  will be us ed to send  event not ification  and data
  779    when new  drugs are  added to t he DRUG fi le (#50) a nd when ce rtain fiel ds are 
  780    updated i n the same  file. Thi s informat ion will b e sent to  the automa ted 
  781    dispensin g machines  through H L7 V.2.4 f ormatted m essages.  
  782     
  783   NAME: PSS  HUI DRUG U PDATE 
  784    DESCRIPTI ON:   This  protocol  will be us ed to send  event not ification  and data
  785    when new  drugs are  added to t he Drug fi le (#50) a nd when ce rtain fiel ds are 
  786    updated i n same fil e.  
  787   NAME: PSS  MED ROUTE  RECEIVE
  788    DESCRIPTI ON:   This  protocol  processes  updates to  the Stand ard Medica tion
  789    Routes (# 51.23) Fil e.  
  790   Bulletins
  791   NAME: PSS  FDB INTERF ACE 
  792   SUBJECT: O RDER CHECK  DATABASE  DOWN
  793   RETENTION  DAYS: 3
  794   PRIORITY?:  YES
  795   NAME: PSS  FDB INTERF ACE RESTOR ED
  796   SUBJECT: O RDER CHECK  DATABASE  IS BACK UP
  797   RETENTION  DAYS: 3 
  798   PRIORITY?:  YES
  799   Web Server s
  800   PEPS 
  801   Web Servic es
  802   DOSING_INF O
  803   DRUG_INFO
  804   ORDER_CHEC KS
  805   Cache Clas s
  806   XMLHandler
  807   HL7 Messag ing with a n External  System
  808   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.
  809   HL7 Drug M essage Seg ment Defin ition Tabl e
  810   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 .
  811   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 drug6V A CLASSIFI CATIONSTVA  Class7DEA  SPECIAL H DLGSTHow d rug is dis pense base d on DEA c odes8FSNST  Federal S tock #9WAR NING LABEL STDrug War nings for  patient10V ISN NON-FO RMULARCEIf  ‘1’ trueZ PB1PHARMAC Y ORDERABL E ITEMCEIE N^OI tied  to dispens e drug^PSD 50.72DOSAG E FORMSTIE N^Dosage F orm associ ated with  OI^PSD50.6 063MEDICAT ION ROUTES TIEN^Med R oute assoc iated with  OI^PSD51. 24PSNDF VA  PRODUCT N AME ENTRYC EIEN^VA PR ODUCT NAME S^PSD50.68 5DISPENSE  UNITSTDisp ense Unit  for a drug 6CMOP DISP ENSECE1 or  07OP EXTE RNAL DISPE NSECE1 or  08EXPIRATI ON DATEDTH L7 Format  (YYYYMMDD) 9LAB TEST  MONITORCEI EN^Lab Tes t^LAB60ZPC 1SPECIMEN  TYPECEIEN^  SPECIMEN  TYPE^LAB61 2MONITOR R OUTINESTPr ogram that  runs to f ind lab te st and res ults3LAB M ONITOR MAR KCEIf ‘1’  true4STREN GTHNMDose  of drug5UN ITCEIEN^Un it of meas ure^PSD50. 6076PRICE  PER ORDER  UNITNM7PRI CE PER DIS PENSE UNIT NM[{ZPD}]  1SYNONYMST Trade Name 2NDC CODES TNational  Drug Code3 INTENDED U SECE CE^IN TENTED USE 4VSNSTVend or Stock N umber5ORDE R UNITCEIE N^ABBREVIA TION^EXPAN SION
  812   ^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):
  813   AUTOMATED  DISPENSE f ield (#105 ) needs to  be set to  2.4.
  814   ENABLE MAS TER FILE U PDATE fiel d (#105.2)  needs to  be set to  YES.
  815   LOGICAL LI NK field ( #2005) nee ds to be s et to PSO  DISP.
  816   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.vha.med . d o main ).
  817   DISPENSE D NS PORT fi eld (#2007 ) needs to  be set to  the dispe nsing syst em port nu mber.
  818   Specific T ransaction xe "Specif ic Transac tion"
  819   The Pharma cy/Treatme nt Encoded  Order Mes sage is as  follows:
  820   MFN
  821   Master Fil e Notifica tion Messa ge
  822   MSH
  823   Message He ader
  824   MFI
  825   Master Fil e Identifi er
  826   {MFE
  827   Master Fil e Entry
  828   {{ZPA}
  829   Drug File  Informatio n
  830     {RXD}
  831   Pharmacy/T reatment D ispense
  832     {OBR}}
  833  
  834   Observatio n Request
  835   }
  836   Example:
  837   MSH|~^\&|P SS VISTA|5 21~FO-BIRM .VHA.MED. D O MAIN ~DNS|PSS D ISPENSE|~D ISPENSE1.V HA.MED. D O MAIN :9300~DNS| 20030701|| MFN~M01~MF N_M01|1000 1|P|2.4||| AL|AL
  838   MFI|50~DRU G~99PSD||U PD|||NE
  839   MFE|MUP||| PROPANTHEL INE 15MG T AB
  840   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
  841   RXD||||1|| |||1|||~P& 200&LPSD50 .0903||||| |||||||O
  842   OBR||||110 2~ACETAZOL AMIDE~LLAB 60|||||||| |||70&NECK &LLAB61||| ||||||WBC| ||7
  843   HL7 Drug M essage Seg ment Defin ition Tabl e
  844   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.
  845   Segments U sed in the  Master Fi le Update  Message
  846   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. MED. D O MAIN ~DNS5180HD R0361Recei ving Appli cationPSS  DISPENSE61 80HDR0362R eceiving F acility –  DNS name a nd port of  dispensin g machine~ DISPENSE.V HA.MED. D O MAIN :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:
  847   [MSH-3] Se nding Appl ication is  the stati on ID alon g with the  DNS name  of the sen ding facil ity.
  848   [MSH-5] Re ceiving Ap plication  is the DNS  name and  DNS port n umber of t he dispens ing applic ation.
  849   [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.
  850   [MFI-1] Ma ster File  Identifier  is hard-c oded to 50 ~DRUG~99PS D.
  851   [MFE-1] Re cord-Level  Event Cod e can be e ither MUP  for Update  or MAD fo r Add.
  852   [MFE-4] Pr imary Key  Value – MF E is the G ENERIC NAM E field (# .01) from  the DRUG f ile (#50).
  853   [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.
  854   [ZPA-2] Is  Synonym i s set to Y  or N depe nding on w hether the  primary k ey is a sy nonym.
  855   [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.
  856   [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).
  857   [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 .
  858   [ZPA-29] I ntended Us er will be  TRADE NAM E, QUICK C ODE, DRUG  ACCOUNTABI LITY or CO NTROLLED S UBSTANCES.
  859   [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) .
  860   [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).
  861   [RXD-12] T otal Daily  Dose will  be either  P for Pos sible Dosa ges or LP  for Local  Possible D osages.
  862   [OBR-4] Un iversal Se rvice Iden tifier is  used for C lozapine L ab Test.
  863   [OBR-15] S pecimen So urce is us ed for Clo zapine Spe cimen Type .
  864   [OBR-24] D iagnostic  Serv Sect  ID is used  for Cloza pine Type  of Test.
  865   [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 ).
  866   Data Archi ving and P urging
  867   There are  no archivi ng and pur ging funct ions neces sary with  this relea se of the  PDM packag e.
  868   Callable R outines/En try Points /Applicati on Program  Interface s (APIs)
  869   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:
  870   IAs    INT EGRATION C ONTROL REG ISTRATIONS  ...
  871   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 "" .
  872   Medication  Routes
  873   The follow ing paragr aphs provi de an expl anation of  medicatio n route in formation.
  874   For Outpat ient Pharm acy & Inpa tient Medi cation Uni t Dose Ord ers:
  875   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
  876   For IV Flu ids Orders :
  877   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).
  878   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 .
  879   Administra tion Sched uling
  880   The follow ing rules  apply to a dministrat ion schedu ling.
  881   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.
  882   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.
  883   External R elations
  884   Integratio n Agreemen ts
  885   IAs can be  viewed by  first cho osing the  DBA option  on FORUM  and then t he Integra tion Agree ments Menu  option.
  886   Example: D BA Option
  887  
  888   Select Pri mary Menu  Option: DB A
  889   Select DBA  Option: I NTEGration  Agreement s Menu
  890   Select Int egration A greements  Menu Optio n:  Custod ial Packag e Menu
  891   Select Cus todial Pac kage Menu  Option:  A CTIVE by C ustodial P ackage
  892   Select PAC KAGE NAME:  PHARMACY  DATA MANAG EMENT      PSS
  893   DEVICE: HO ME//
  894   Internal R elations
  895   All PDM op tions can  function i ndependent ly.
  896   Package-Wi de Variabl es
  897   There are  no package -wide vari ables for  this versi on.
  898   Package Re quirements
  899   The PDM mo dule relie s on, at l east, the  following  external p ackages to  run effec tively.
  900  
  901   Package
  902   Minimum ve rsion need ed
  903  
  904   National D rug File
  905   V. 4.0
  906  
  907  
  908   Outpatient  Pharmacy
  909   V. 7.0
  910  
  911  
  912   Inpatient  Medication s
  913   V. 5.0
  914  
  915  
  916   Kernel
  917   V. 8.0 
  918  
  919  
  920   VA FileMan
  921  
  922   V. 22.0 
  923  
  924   Package
  925   Minimum ve rsion need ed
  926  
  927   HealtheVet  Web Servi ces Client  (HWSC)
  928   V. 1.0
  929  
  930   VistALink
  931  
  932   V. 1.6
  933   Additional  Informati on
  934   Standards  and Conven tions Comm ittee (SAC C) Exempti ons
  935   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.
  936   PSSFDBDI
  937   PSSFDBRT
  938   PSSHRPST
  939   PSSHTTP
  940   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.
  941   OITIMB3355 4520 - Mig ration fro m M2J to V istA Web S ervices Cl ient (VWSC )
  942   Keywords
  943   M2J,VWSC,J 2EE
  944   Decision D ate
  945   12/1/2006
  946   Decision T ype
  947   Architectu re
  948   Decision M aking Body
  949   HPMO CCB
  950   Descriptio n
  951   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 .
  952   Rationale
  953   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. 
  954   Record Typ e
  955   TDR
  956   State
  957   Approved
  958   Date Submi tted
  959   2/14/2007  8:37:24 AM
  960   Supporting  Documenta tion 
  961   Link
  962   Document T itle
  963   Descriptio n
  964   Date
  965   Download
  966   Migration  from M2J t o VistA We b Services  Client (V WSC) Email  Notificat ion
  967   Email noti fication a lerting of  the decis ion
  968   2/13/2007
  969   Download
  970   VWSC Archi tecture
  971   Proposed a rchitectur e view of  VWSC
  972   12/1/2006
  973   Download
  974   VWSC Propo sed View
  975   Proposed l ogical vie w of VistA  Web Servi ces Client  (VWSC)
  976   12/1/2006
  977   Cross-Refe rence Logi c to Keep  Orderable  Items Up T o Date
  978   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.
  979   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 .
  980   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.
  981   File 50:     DEA Spec ial Hdlg
  982   File 50:     Inactiva tion Date
  983   File 50:     Applicat ion Packag es’ Use
  984   File 50:     Local No n-Formular y
  985   File 50.7:  Inactivat ion Date
  986   File 52.6:  Inactivat ion Date
  987   File 52.6:  Used in I V Fluid Or der Entry
  988   File 52.7:  Inactivat ion Date
  989   File 52.7:  Used in I V Fluid Or der Entry
  990   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).
  991   File 50:      Orderab le Item Po inter
  992   File 52.6:   Generic  Drug Point er
  993   File 52.7:   Generic  Drug Point er
  994   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.
  995   Scenario 1 : The Orde rable Item  Pointer I s Changed  For A Disp ense Drug
  996   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: 
  997   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.
  998   Orderable  Item:    ^ PS(50.7,"A 50",Ordera ble Item I EN, Dispen se Drug IE N)=""
  999   Drug file:               ^PSDRUG ("A526", D ispense Dr ug IEN, Ad ditive IEN ,)=""
  1000   Drug file:               ^PSDRUG ("A527", D ispense Dr ug IEN, So lution IEN ,)=""
  1001   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. 
  1002   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:
  1003   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.  
  1004   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.
  1005   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) .
  1006   Example 1:
  1007   Additives/ Solution
  1008  
  1009   Dispense D rugs:
  1010  
  1011   Orderable  Item:
  1012   IEN 3    p oints to = >            
  1013   IEN 100     points to  =>
  1014  
  1015   500      
  1016   IEN 4    p oints to = >            
  1017   IEN 100     points to  =>
  1018  
  1019   500
  1020   IEN 5    p oints to = >            
  1021   IEN 100     points to  =>
  1022  
  1023   500
  1024   IEN 10  po ints to =>
  1025  
  1026   IEN 200      points t o =>
  1027  
  1028   500
  1029   Cross-Refe rences are :
  1030  
  1031   ^PS(50.7," A50",500,1 00)=""
  1032   ^PS(50.7," A50",500,2 00)=""
  1033   ^PSDRUG("A 526",100,3 )=""
  1034  
  1035   ^PSDRUG("A 526",100,4 )=""
  1036  
  1037   ^PSDRUG("A 526",100,5 )=""
  1038   ^PSDRUG("A 527",200,1 0)=""
  1039   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.
  1040   (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. 
  1041   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.
  1042   Kill Logic
  1043   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
  1044   The Cross- References  would now  be as fol lows.
  1045   ^PS(50.7," A50",500,2 00)=""
  1046   ^PSDRUG("A 526",100,3 )=""
  1047   ^PSDRUG("A 526",100,4 )=""
  1048   ^PSDRUG("A 526",100,5 )=""
  1049   ^PSDRUG("A 527",200,1 0)=""
  1050   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.
  1051   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) .  
  1052   Set Logic
  1053   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.
  1054   ^PS(50.7," A50",500,2 00)=""
  1055   ^PS(50.7," A50",600,1 00)=""
  1056   ^PSDRUG("A 526",100,3 )=""
  1057   ^PSDRUG("A 526",100,4 )=""
  1058   ^PSDRUG("A 526",100,5 )=""
  1059   ^PSDRUG("A 527",200,1 0)=""
  1060   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.
  1061   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. 
  1062   Scenario 2 : The Disp ense Drug  Pointer Is  Edited Fo r An IV Ad ditive Or  IV Solutio n
  1063   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.
  1064   Kill Logic
  1065   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.
  1066   Set Logic
  1067   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.  
  1068   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. 
  1069   Example 2:
  1070   IV Additiv es/IV Solu tion
  1071   Dispense D rugs
  1072  
  1073   Orderable  Item
  1074   IEN 3    p oints to = >            
  1075   IEN 100     points to  =>
  1076  
  1077   500      
  1078   IEN 4    p oints to = >           
  1079   IEN 100     points to  =>
  1080  
  1081   500
  1082   IEN 5    p oints to = >         
  1083   IEN 100     points to  =>
  1084  
  1085   500
  1086   IEN 10  po ints to =>
  1087  
  1088   IEN 200      points t o =>                     
  1089   500
  1090   Cross-Refe rences 
  1091   ^PS(50.7," A50",500,1 00)=""
  1092   ^PS(50.7," A50",500,2 00)=""
  1093  
  1094  
  1095  
  1096   ^PSDRUG("A 526",100,3 )=""
  1097  
  1098  
  1099  
  1100   ^PSDRUG("A 526",100,4 )=""
  1101  
  1102  
  1103  
  1104   ^PSDRUG("A 526",100,5 )=""
  1105   ^PSDRUG("A 527",200,1 0)=""
  1106   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 
  1107   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.
  1108   Kill Logic
  1109   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. 
  1110  
  1111  
  1112  
  1113   ^PS(50.7," A50",500,1 00)=""
  1114   ^PS(50.7," A50",500,2 00)=""
  1115  
  1116  
  1117  
  1118   ^PSDRUG("A 526",100,4 )=""
  1119  
  1120  
  1121  
  1122   ^PSDRUG("A 526",100,5 )=""
  1123    
  1124  
  1125  
  1126   ^PSDRUG("A 527",200,1 0)=""
  1127   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.
  1128   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.  
  1129   Set Logic
  1130   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 
  1131  
  1132  
  1133  
  1134   ^PS(50.7," A50",500,1 00)=""
  1135   ^PS(50.7," A50",500,2 00)=""
  1136  
  1137  
  1138  
  1139   ^PSDRUG("A 526",100,4 )=""
  1140  
  1141  
  1142  
  1143   ^PSDRUG("A 526",100,5 )=""
  1144   ^PSDRUG("A 526",900,3 )=""
  1145    
  1146  
  1147  
  1148   ^PSDRUG("A 527",200,1 0)=""
  1149   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 .
  1150  
  1151  
  1152  
  1153   ^PS(50.7," A50",500,1 00)=""
  1154   ^PS(50.7," A50",500,2 00)=""
  1155   ^PS(50.7," A50",2000, 900)=""
  1156  
  1157  
  1158  
  1159   ^PSDRUG("A 526",100,4 )=""
  1160  
  1161  
  1162  
  1163   ^PSDRUG("A 526",100,5 )=""
  1164   ^PSDRUG("A 526",900,3 )=""
  1165    
  1166  
  1167  
  1168   ^PSDRUG("A 527",200,1 0)=""
  1169   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.
  1170   Security M anagement
  1171   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.
  1172   Mail Group
  1173   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.
  1174   NAME: PSS  ORDER CHEC KS                   
  1175   TYPE: publ ic
  1176   DESCRIPTIO N:   Membe rs of this  mail grou p will rec eive vario us notific ations
  1177   that impac t Enhanced  Order Che cks (drug- drug inter actions, d uplicate t herapy
  1178   and dosing  checks) i ntroduced  with PRE V . 0.5 util izing a CO TS databas e.  
  1179   Alerts
  1180   There are  no alerts  in the PDM  package.
  1181   Bulletins
  1182   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.
  1183   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 .
  1184   NAME: PSS  FDB INTERF ACE 
  1185   SUBJECT: O RDER CHECK  DATABASE  DOWN
  1186   RETENTION  DAYS: 3
  1187   PRIORITY?:  YES
  1188   NAME: PSS  FDB INTERF ACE RESTOR ED
  1189   SUBJECT: O RDER CHECK  DATABASE  IS BACK UP
  1190   RETENTION  DAYS: 3 
  1191   PRIORITY?:  YES
  1192   Remote Sys tems
  1193   PDM does n ot transmi t data to  any remote  system or  facility.  
  1194   Archiving/ Purging
  1195   There are  no archivi ng and pur ging funct ions neces sary with  the PDM pa ckage.
  1196   Contingenc y Planning
  1197   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 ).
  1198   Interfacin g
  1199   There are  no special ized produ cts embedd ed within  or require d by the P DM package .
  1200   Electronic  Signature s
  1201   No electro nic signat ures are u tilized in  the PDM p ackage.
  1202   Locked Men u Options
  1203   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.
  1204        Locke d: PSXCMOP MGR
  1205   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.
  1206   Security K eys
  1207   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.
  1208   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.
  1209  
  1210        Packa ge
  1211   Keys
  1212   Outpatient  Pharmacy
  1213   PSORPH
  1214   Inpatient  Medication s
  1215   PSJU MGR
  1216   Inpatient  Medication s
  1217   PSJI MGR
  1218   Automatic  Replenishm ent/Ward S tock 
  1219   PSGWMGR
  1220   Drug Accou ntability/ Inventory  Interface
  1221   PSAMGR
  1222   Drug Accou ntability/ Inventory  Interface
  1223   PSA ORDERS
  1224   Controlled  Substance
  1225   PSDMGR
  1226   National D rug File 
  1227   PSNMGR
  1228   Consolidat ed Mail Ou tpatient P harmacy 
  1229   PSXCMOPMGR
  1230   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. 
  1231   NAME: PSS_ CUSTOM_TAB LES_ADMIN            
  1232   DESCRIPTIV E NAME: AD MINISTRATO R
  1233   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.   
  1234   NAME: PSS_ CUSTOM_TAB LES_APPROV ER        
  1235   DESCRIPTIV E NAME: AP PROVER
  1236   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 .  
  1237   NAME: PSS_ CUSTOM_TAB LES_REL_MA N         
  1238   DESCRIPTIV E NAME: RE LEASE MANA GER
  1239   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.   
  1240   NAME: PSS_ CUSTOM_TAB LES_REQUES TOR       
  1241   DESCRIPTIV E NAME: RE QUESTOR
  1242   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
  1243   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 .
  1244   NAME: PSS_ PPSN_MANAG ER
  1245   DESCRIPTIV E NAME: PP S-National  Manager
  1246   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.
  1247   NAME: PSS_ PPSN_MIGRA TOR
  1248   DESCRIPTIV E NAME: PP S-National  Migration  User
  1249   DESCRIPTIO N:   This  role has t he ability  to run th e PPS-N Mi gration.
  1250   NAME: PSS_ PPSN_SECON D_APPROVER
  1251   DESCRIPTIV E NAME: PP S-National  Second Ap prover
  1252   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.
  1253   NAME: PSS_ PPSN_SUPER VISOR
  1254   DESCRIPTIV E NAME: PP S-National  Superviso r
  1255   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.
  1256   NAME: PSS_ PPSN_VIEWE R
  1257   DESCRIPTIV E NAME: PP S-National  Viewer
  1258   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.
  1259   File Secur ity
  1260   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.
  1261   PDM Files
  1262   File 
  1263   NumbersFil e NamesDDR DWRDELLAYG O50
  1264   DRUG
  1265   @50.4
  1266   DRUG ELECT ROLYTES
  1267   @50.606
  1268   DOSAGE FOR M
  1269   @
  1270  
  1271   @
  1272   @
  1273   @50.7
  1274   PHARMACY O RDERABLE I TEM
  1275   @51
  1276   MEDICATION  INSTRUCTI ON
  1277   @51.1
  1278   ADMINISTRA TION SCHED ULE
  1279   @51.2
  1280   MEDICATION  ROUTES
  1281   @51.23
  1282   STANDARD M EDICATION  ROUTES
  1283   @
  1284   Pp
  1285   @
  1286   @
  1287   @51.24
  1288   DOSE UNITS
  1289   @
  1290   Pp
  1291   @
  1292   @
  1293   @
  1294   51.25        DOSE UNI T CONVERSI ON                 @      Pp     @      @      @51.5
  1295   ORDER UNIT
  1296   51.7
  1297   DRUG TEXT
  1298   @52.6
  1299   IV ADDITIV ES
  1300   @52.7
  1301   IV SOLUTIO NS
  1302   @53.47
  1303   INFUSION I NSTRUCTION S
  1304   54
  1305   RX CONSULT
  1306   55
  1307   PHARMACY P ATIENT (Pa rtial DD)
  1308   @
  1309   P59.7
  1310   PHARMACY S YSTEM
  1311   ^
  1312  
  1313   ^
  1314  
  1315   ^59.73
  1316   VENDOR DIS ABLE/ENABL
  1317   @
  1318   @
  1319   @
  1320   @
  1321   @
  1322   59.74
  1323   VENDOR INT ERFACE DAT A
  1324   @
  1325   @
  1326   @
  1327   @
  1328   @
  1329   Non-PDM Fi les
  1330   File 
  1331   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    
  1332   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.
  1333   References
  1334   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.
  1335   Appendix A : Pharmacy  Interface  Automatio n
  1336    REF Bulle tins_p32a  \h  \* MER GEFORMAT 
  1337  
  1338  
  1339    REF Bulle tins_p32a  \h  \* MER GEFORMAT 
  1340  
  1341  
  1342    REF Bulle tins_p32a  \h  \* MER GEFORMAT 
  1343   Introducti on appendi x provides  a brief d escription  of the ne w features  and funct ions of th e Pharmacy  Interface  Automatio n project.  This proj ects consi st of mult iple patch es, which  must be in stalled fo r the func tionality  to perform
  1344   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. 
  1345   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.  
  1346   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. 
  1347   The minimu m required  VistA sof tware is:
  1348   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
  1349   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:
  1350   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.
  1351   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.
  1352   Provide PA DE the cap ability to  alert Vis tA Pharmac y of medic ation remo val from P ADE withou t orders.
  1353   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.
  1354   Refer to t he followi ng Pharmac y Interfac e Automati on documen ts for add itional in formation:
  1355   (will add  hyperlinks  once thes e are in f inal folde r or on TS PR)
  1356   Pharmacy I nterface A utomation  Installati on Guide
  1357   Pharmacy I nterface A utomation  User Guide
  1358   Pharmacy I nterface A utomation  System Des ign Docume nt
  1359   Pharmacy I nterface A utomation  Data Dicti onary
  1360   Options an d Build Co mponents 
  1361   The follow ing are th e options  and build  components  for Pharm acy Interf ace Automa tion for P SS*1.0*193 :
  1362   Select OPT ION NAME:     XPD PRI NT BUILD      Build F ile Print
  1363   Build File  Print
  1364   Select BUI LD NAME: P SS*1.0*193        PHA RMACY DATA  MANAGEMEN T
  1365   DEVICE: HO ME// ;;999 99  SSH VI RTUAL TERM INAL
  1366   PACKAGE: P SS*1.0*193      Nov 2 5, 2015 10 :27 am                              PAGE 1
  1367   ---------- ---------- ---------- ---------- ---------- ---------- ---------- ---------S INGLE PACK AGE                                  TRACK  NATIONALLY : YES
  1368   NATIONAL P ACKAGE: PH ARMACY DAT A MANAGEME NT       A LPHA/BETA  TESTING: N O
  1369   As part of  this patc h PSS*1*19 3, the fol lowing enh ancements  were made:
  1370   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 .
  1371   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.
  1372   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"
  1373   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 .
  1374   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 .
  1375   ENVIRONMEN T CHECK:                                  D ELETE ENV  ROUTINE: 
  1376    PRE-INIT  ROUTINE:                             DELETE  PRE-INIT  ROUTINE: 
  1377   POST-INIT  ROUTINE:                            DELETE  POST-INIT  ROUTINE: 
  1378   PRE-TRANSP ORT RTN: 
  1379   ROUTINE:                                           ACT ION:
  1380      PSSDEE                                              SEND TO SI TE
  1381      PSSHLDF S                                           SEND TO SI TE
  1382      PSSMSTR                                             SEND TO SI TE
  1383   OPTION:                                            ACT ION:
  1384      PSS MAS TER FILE A LL                               SEND TO SI TE
  1385   SECURITY K EY:                                     ACT ION:
  1386      PSS PAD E INIT                                      SEND TO SI TE
  1387   PROTOCOL:                                          ACT ION:
  1388      PSS MFN M01 CLIENT                                  SEND TO SI TE
  1389      PSS MFN M01 SERVER                                  SEND TO SI TE
  1390   REQUIRED B UILDS:                                  ACT ION:
  1391      PSS*1.0 *180                                        Don't inst all, leave  global
  1392   CDEVISC1A2 :DVA>
  1393   Modified a nd New Rou tines
  1394   The follow ing routin es are for  PSS*1*193 :
  1395   PSSDEE  
  1396   PSSHLDFS
  1397   PSSMSTR
  1398   (This page  included  for two-si ded copyin g.)
  1399   Glossary
  1400   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  File
  1401   Dose Unit  Conversion  File
  1402   The DOSAGE  FORM file  (#50.606)  contains  all dosage  forms and  associate d data tha t are used  by Pharma cy package s and CPRS . The dosa ge form is  used in S IG constru ction, def ault value s and in t he determi nation of  the type o f each dos age create d for each  applicati on.
  1403   The DOSE U NIT CONVER SION file  (#51.25) w as created  to conver t one dose  unit to a nother usi ng a conve rsion fact or so that  a compari son can be  made betw een two do se units w hen they a re not equ ivalent.   The dose u nit used f or the Dos ing Order  Check may  not be the  same dose  unit Firs t Databank  (FDB) ret urns with  the Dosing  Order Che ck results .Dose Unit  FileThe D OSE UNIT f ile (#51.2 4) was cre ated to ac complish t he mapping  to First  DataBank ( FDB). All  entries in  this file  have been  mapped to  an FDB Do se Unit. A lthough th is file ha s not yet  been stand ardized by  Standards  and Termi nology Ser vices (STS ), no loca l editing  will be al lowed. Whe n populati ng the Dos e Unit fie ld for a L ocal Possi ble Dosage  in the DR UG file (# 50), selec tion will  be from th is new fil e.Drug Ele ctrolytes  FileThe DR UG ELECTRO LYTES file  (#50.4) c ontains th e names of  anions/ca tions, and  their cat ions and c oncentrati on units.D rug FileTh e DRUG fil e (#50) ho lds the in formation  related to  each drug  that can  be used to  fill a pr escription  or medica tion order . It is po inted to f rom severa l other fi les and sh ould be ha ndled care fully, usu ally only  by special  individua ls in the  Pharmacy S ervice. En tries are  not typica lly delete d, but rat her made i nactive by  entering  an inactiv e date.Dru g Text Fil eThe DRUG  TEXT file  (#51.7) st ores rapid ly changin g drug res trictions,  guideline s, and pro tocols to  help assur e medicati ons are be ing used a ccording t o defined  specificat ions.Infus ion Instru ctions Fil eThe INFUS ION INSTRU CTIONS fil e (#53.47)  holds abb reviations  used when  entering  the Infust ion Rate ( #.08) fiel d in the I V (#100) m ultiple of  the PHARM ACY PATIEN T (#55) FI LE, AND TH E infusion  rate (#59 ) FIELD IN  THE non-v erified or ders (#53. 1) file. E ach record  holds an  expansion  of the abb reviation  which repl aces the a bbreviatio n in the I nfusion Ra te at the  time the I V order is  created.I V Additive s FileThe  IV ADDITIV ES file (# 52.6) cont ains drugs  that are  used as Ad ditives in  the IV ro om. Data e ntered inc ludes drug  generic n ame, print  name, dru g informat ion, synon ym(s), dis pensing un its, cost  per unit,  days for I V order, u sual IV sc hedule, ad ministrati on times,  electrolyt es, and qu ick code i nformation .IV Soluti ons FileTh e IV SOLUT IONS file  (#52.7) co ntains dru gs that ar e used as  primary so lutions in  the IV ro om. The so lution mus t already  exist in t he Drug fi le (#50) t o be selec ted. Data  in this fi le include s: drug ge neric name , print na me, status , drug inf ormation,  synonym(s) , volume,  and electr olytes.Loc al Possibl e DosagesL ocal Possi ble Dosage s are free  text dosa ges that a re associa ted with d rugs that  do not mee t all of t he criteri a for Poss ible Dosag es.Medicat ion Instru ction File The MEDICA TION INSTR UCTION fil e (#51) is  used by U nit Dose a nd Outpati ent Pharma cy. It con tains the  medication  instructi on name, e xpansion a nd intende d use.Medi cation Rou tes FileTh e MEDICATI ON ROUTES  file (#51. 2) contain s medicati on route n ames. The  user can e nter an ab breviation  for each  route to b e used at  their site . The abbr eviation w ill most l ikely be t he Latin a bbreviatio n for the  term.Medic ation Rout es/Abbrevi ationsThe  Medication  RouteS fi le (#51.2)  contains  the medica tion route s and abbr eviations,  which are  selected  by each De partment o f Veterans  Affairs M edical Cen ters (VAMC ). The abb reviation  cannot be  longer tha n five cha racters to  fit on la bels and t he Medical  Administr ation Reco rd (MAR).  The user c an add new  routes an d abbrevia tions as a ppropriate .MOCHAMedi cation Ord er Check H ealthcare  Applicatio n. Nationa l Drug Fil eThe Natio nal Drug F ile provid es standar dization o f the loca l drug fil es in all  VA medical  facilitie s. Standar dization i ncludes th e adoption  of new dr ug nomencl ature and  drug class ification  and links  the local  drug file  entries to  data in t he Nationa l Drug Fil e. For dru gs approve d by the F ood and Dr ug Adminis tration (F DA), VA me dical faci lities hav e access t o informat ion concer ning dosag e form, st rength and  unit; pac kage size  and type;  manufactur er’s trade  name; and  National  Drug Code  (NDC). The  NDF softw are lays t he foundat ion for sh aring pres cription i nformation  among med ical facil ities.Non- Formulary  DrugsDrugs  that are  not availa ble for us e by all p roviders.O rderable I temAn Orde rable Item  is pulled  from the  PHARMACY O RDERABLE I TEM file ( #50.7) and  usually h as no stre ngth attac hed to it  (e.g., Ace taminophen ). The nam e, with a  strength a ttached, i s the Disp ense Drug  name (e.g. , Acetamin ophen 325m g).Orderab le Item Fi leThe ORDE RABLE ITEM  file (#10 1.43) is a  CPRS file  that prov ides the O rderable I tems for s election w ithin CPRS . Pharmacy  Orderable  Items are  a subset  of this fi le.PECSPha rmacy Ente rprise Cus tomization  System. A  Graphical  User Inte rface (GUI ) web-base d applicat ion used t o research , update v ia DATUP,  maintain,  and report  VA custom izations o f the comm ercial-off -the-shelf  (COTS) ve ndor datab ase used t o perform  Pharmacy o rder check s such as  drug-drug  interactio ns, duplic ate therap y, and dos ing. PEPSP harmacy En terprise P roduct Ser vices. A s uite of se rvices tha t includes  Outpatien t and Inpa tient serv ices.Pendi ng OrderA  pending or der is one  that has  been enter ed by a pr ovider thr ough CPRS  without Ph armacy fin ishing the  order. On ce Pharmac y has fini shed (and  verified f or Unit Do se only) t he order,  it will be come activ e.Pharmacy  Orderable  ItemThe P harmacy Or derable It em is used  through C PRS to ord er Inpatie nt Medicat ions and O utpatient  Pharmacy p rescriptio ns.Pharmac y Orderabl e Item Fil eThe PHARM ACY ORDERA BLE ITEM f ile (#50.7 ) contains  the Order  Entry nam e for item s that can  be ordere d in the I npatient M edications  and Outpa tient Phar macy packa ges.Possib le Dosages Dosages th at have a  numeric do sage and n umeric Dis pense Unit s Per Dose  appropria te for adm inistratio n.  For a  drug to ha ve possibl e dosages,  it must b e a single  ingredien t product  that is ma tched to V A PRODUCT  file (#50. 68).  The  VA PRODUCT  file (#50 .68) entry  must have  a numeric  strength  and the do sage form/ unit combi nation mus t be such  that a num eric stren gth combin ed with th e unit can  be an app ropriate d osage sele ction.Prom ptA point  at which t he system  questions  the user a nd waits f or a respo nse.Standa rd Medicat ion Route  FileThe ST ANDARD MED ICATION RO UTE file ( #51.23) wa s created  to map Loc al Medicat ion Routes  in VistA  to an FDB  Route in o rder to pe rform dosa ge checks  in PRE V.0 .5.  This  file has b een standa rdized by  Standards  and Termin ology Serv ice (STS)  and is map ped to an  FDB Route.  It cannot  be edited  locally.  Standard S cheduleSta ndard medi cation adm inistratio n schedule s are stor ed in the  Administra tion Sched ule file ( #51.1). Un its Per Do seThe Unit s Per Dose  is the nu mber of Un its (table ts, capsul es, etc.)  to be disp ensed as a  dose for  an order.  Fractional  numbers w ill be acc epted.VA D rug Class  CodeA drug  classific ation syst em used by  VA that s eparates d rugs into  different  categories  based upo n their ch aracterist ics. Some  cost repor ts can be  run for VA  Drug Clas s Codes.VA  Product F ileThe VA  PRODUCT fi le (#50.68 ) contains  a list of  available  drug prod ucts.