2. EPMO Open Source Coordination Office Redaction File Detail Report

Produced by Araxis Merge on 6/14/2018 2:30:45 PM Eastern 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.

2.1 Files compared

# Location File Last Modified
1 EPIP_2.0_PSS_1.0_227.zip EPIP_National_Patch_Module_Patch_Description_(PSS_1.0_227).docx Tue Jun 12 16:05:24 2018 UTC
2 EPIP_2.0_PSS_1.0_227.zip EPIP_National_Patch_Module_Patch_Description_(PSS_1.0_227).docx Tue Jun 12 19:13:28 2018 UTC

2.2 Comparison summary

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

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

2.4 Active regular expressions

No regular expressions were active.

2.5 Comparison detail

  1   Existing P roduct Int ake Progra m (EPIP)
  2   Patch PSS* 1.0*227
  3   National P atch Modul e Patch De scription
  4  
  5   Department  of Vetera ns Affairs
  6   May 2018
  7   Version 1. 0
  8  
  9  
  10   Revision H istory
  11   Date
  12   Version
  13   Descriptio n
  14   Author
  15   05/25/2018
  16   1.0
  17   Initial ve rsion
  18   EPIP Proje ct Team
  19  
  20  
  21  
  22   National P atch Modul e Patch De scription
  23   ========== ========== ========== ========== ========== ========== ========== =======
  24   Run Date:  MAY 25, 20 18                           Des ignation:  PSS*1*227  TEST v1
  25   Package :  PHARMACY D ATA MANAGE MENT              Pri ority   :  MANDATORY
  26   Version :  1                                       Sta tus     :  UNDER DEVE LOPMENT 
  27   ========== ========== ========== ========== ========== ========== ========== =======
  28  
  29   Associated  patches:  (v)PSS*1*1 95   <<= m ust be ins talled BEF ORE `PSS*1 *227'
  30                         (v)PSS*1*2 13   <<= m ust be ins talled BEF ORE `PSS*1 *227'
  31  
  32   Subject:    EPIP: DRU G FILE AUD ITS / DRUG  PRICE HIS TORY
  33  
  34   Category:   ROUTINE
  35               DATA DICT IONARY            
  36               ENHANCEME NT
  37  
  38  
  39   Descriptio n:
  40   ---------- --
  41   Patch PSS* 1.0*227 pr ovides the  following  enhanceme nts to Vis tA:
  42  
  43   - Enables  auditing o f drug fil e changes  when a use r modifies  certain f ields in t he DRUG fi le (#50) t hrough the  Drug Ente r/Edit [PS S DRUG ENT ER/EDIT] m enu option . This enh ancement g enerates a  message t o a new ma il group c alled PSS  DEE AUDIT  when these  fields ar e modified . The mess age shows  the date/t ime of the  change, t he name of  the user  who made t he change,  and befor e/after de scriptions  of the ch anged fiel d(s).
  44  
  45   In additio n, a new P harmacy Pr ice Tracke r function  sends a s eparate au dit messag e to the P SS DEE AUD IT mail gr oup when t he PRICE P ER DISPENS E UNIT fie ld (#16) i s added or  changed,  or when th e PRICE PE R DISPENSE  UNIT fiel d is autom atically u pdated by  a change t o the PRIC E PER ORDE R UNIT fie ld (#13).   
  46  
  47   Not all fi elds in th e DRUG fil e are subj ect to aud it. The fo llowing li st of audi table fiel ds is stor ed interna lly in the  PSSDEEA r outine: 
  48  
  49   GENERIC NA ME (#.01)
  50   VA CLASSIF ICATION (# 2)
  51   DEA, SPECI AL HDLG (# 3)
  52   MAXIMUM DO SE PER DAY  (#4)
  53   STANDARD S IG (#5)
  54   FSN (#6)
  55   WARNING LA BEL (#8)
  56   MESSAGE (# 101)
  57   PHARMACY O RDERABLE I TEM (#2.1)
  58   RESTRICTIO N (#102)
  59   APPLICATIO N PACKAGES ’ USE (#63 )
  60   NDC (#31)
  61   CMOP DISPE NSE (#213)
  62   ATC MNEMON IC (#212.2 )
  63   REORDER LE VEL (#11)
  64   ORDER UNIT  (#12)
  65   PRICE PER  ORDER UNIT  (#13)
  66   PRICE PER  DISPENSE U NIT (#16)
  67   SOURCE OF  SUPPLY (#1 7)
  68   DISPENSE U NIT (#14.5 )
  69   CURRENT IN VENTORY (# 50)
  70   DAW CODE ( #81)
  71   NCPDP DISP ENSE UNIT  (#82)
  72   NCPDP QUAN TITY MULTI PLIER (#83 )
  73   INACTIVE D ATE (#100)
  74   NATIONAL D RUG FILE E NTRY (#20)
  75   VA PRODUCT  NAME (#21 )
  76   PSNDF VA P RODUCT NAM E ENTRY (# 22)
  77   PACKAGE SI ZE (#23)
  78   PACKAGE TY PE (#24)
  79   NATIONAL D RUG CLASS  (#25)
  80   CMOP ID (# 27)
  81   NATIONAL F ORMULARY I NDICATOR ( #29)
  82   EPHARMACY  BILLABLE ( #84)
  83   EPHARMACY  BILLABLE ( TRICARE) ( #85)
  84   EPHARMACY  BILLABLE ( CHAMPVA) ( #86)
  85   SENSITIVE  DIAGNOSIS  DRUG (#87)
  86    
  87   If a user  makes chan ges to an  auditable  field, the n the mail  message S ubject lin e displays  the title  DRUG ENTE R/EDIT AUD IT along w ith the In ternal Ent ry Number  (IEN) and  name of th e drug. Th e message  body shows  the date/ time of th e change,  the name o f the user  who made  the change , and befo re/after d escription s of the c hanged fie ld(s). 
  88  
  89   If a user  makes chan ges to a n on-auditab le field,  or views a ny field b ut does no t make cha nges, then  the mail  message Su bject line  displays  the title  DRUG ENTER /EDIT ACCE SS along w ith the dr ug IEN and  name. The  message b ody indica tes “No Au dited Chan ges Made.”  
  90  
  91   After inst allation o f this pat ch, a desi gnated mai l coordina tor must m odify the  PSS DEE AU DIT mail g roup to in clude the  necessary  recipients
  92  
  93   - Provides  an audit  history fo r price ch anges made  in the DR UG file (# 50). When  the PRICE  PER DISPEN SE UNIT fi eld (#16)  is added o r changed,  or when t he PRICE P ER DISPENS E UNIT fie ld is auto matically  updated by  a change  to the PRI CE PER ORD ER UNIT fi eld (#13),  the syste m will sto re the fol lowing dat a in the H ISTORY PRI CE DISPENS E UNIT mul tiple (#95 0) in the  DRUG file:  the date  and time o f the upda te; the us er who upd ated the f ield; and  the new va lue in the  PRICE PER  DISPENSE  UNIT field . The HIST ORY PRICE  DISPENSE U NIT multip le is sear chable via  FileMan,  and is vie wable usin g either F ileMan or  the Lookup  into Disp ense Drug  File [PSS  LOOK] opti on.
  94  
  95   The new PS S DRUG AUD IT RETENTI ON MOS par ameter is  used to li mit the hi storical d ata held i n the HIST ORY PRICE  DISPENSE U NIT multip le. This p arameter c an be set  to a posit ive whole  number of  retention  months. Th e time per iod for re taining hi storical d ata is bas ed on the  last date  of a price  change, m inus the p arameter v alue (rete ntion mont hs) times  30 days. T hat is, th e retentio n period i s based on  30-day mo nths, coun ting back  from the l ast price  change. On ly those e ntries tha t fall wit hin this t ime period  will be s tored in t he file mu ltiple. If  the param eter is no t set to a  whole num ber of ret ention mon ths, then  all entrie s in the H ISTORY PRI CE DISPENS E UNIT mul tiple will  be retain ed. 
  96  
  97   This modif ication en ables phar macies to  better man age drug p rices by v erifying t hat the pr ice shown  is up to d ate, and b y providin g a price  update his tory. 
  98  
  99  
  100   Patch Comp onents: 
  101   ---------- -------
  102  
  103   Files & Fi elds Assoc iated:
  104  
  105   File Name  (Number)          Fie ld Name (N umber)                  New/Modi fied/Delet ed
  106   ---------- --------          --- ---------- ------                  -------- ---------- --
  107   DRUG (#50)                   HIS TORY PRICE  DISPENSE  UNIT (#950 ) New
  108                                PRI CE PER ORD ER UNIT (# 13)          Modified
  109  
  110  
  111   Forms Asso ciated:
  112  
  113   Form Name                    Fil e #                    New/Modif ied/Delete d
  114   ---------                    --- ---                    --------- ---------- -
  115   N/A
  116  
  117  
  118   Mail Group s Associat ed:
  119  
  120   Mail Group  Name             New /Modified/ Deleted
  121   ---------- -----             --- ---------- -------
  122   PSS DEE AU DIT               NEW
  123  
  124  
  125   Options As sociated:
  126  
  127   Option Nam e                 Typ e                      New/Modif ied/Delete d
  128   ---------- -                 --- -                      --------- ----------
  129   N/A
  130  
  131  
  132   Protocols  Associated :
  133  
  134   Protocol N ame               New /Modified/ Deleted
  135   ---------- ---               --- ---------- ------- 
  136   N/A
  137  
  138  
  139   Parameters  Associate d:
  140  
  141   Parameter  Name                    New/Modi fied/Delet ed
  142   ---------- ---                     -------- ---------- -- 
  143   PSS DRUG A UDIT RETEN TION MOS     New
  144  
  145  
  146   Security K eys Associ ated:
  147  
  148   Security K ey Name
  149   ---------- -------
  150   N/A
  151  
  152  
  153   Templates  Associated :
  154  
  155   Template N ame        Type   Fil e Name (Nu mber)  New /Modified/ Deleted 
  156   ---------- ---        ----   --- ---------- -----  --- ---------- -------
  157   N/A
  158  
  159  
  160   Additional  Informati on:
  161   N/A
  162  
  163  
  164   New Servic e Requests  (NSRs):
  165   ---------- ---------- --------  
  166   NSR2015011 5 Audits f or DRUG fi le 50 Chan ges
  167   NSR2008071 4 Drug Fil e Price Ch ange Date/ Time Stamp
  168  
  169  
  170   Patient Sa fety Issue s (PSIs):
  171   ---------- ---------- ---------
  172   N/A
  173  
  174  
  175   Defect Tra cking Syst em Ticket( s) & Overv iew:
  176   ---------- ---------- ---------- ---------- ----
  177   N/A
  178    
  179   Problem:
  180   -------
  181   N/A
  182  
  183   Resolution :
  184   ----------
  185   N/A
  186  
  187  
  188   Test Sites :
  189   ----------
  190   VA Midwest  Health Ca re Network  (VISN 23) , Eagan, M innesota a nd Lincoln , Nebraska
  191   Dayton VA  Medical Ce nter, Dayt on, Ohio
  192  
  193  
  194   Software a nd Documen tation Ret rieval Ins tructions:
  195   ---------- ---------- ---------- ---------- ---------- -- 
  196   Documentat ion descri bing the n ew functio nality int roduced by  this patc h is avail able.
  197  
  198   The prefer red method  is to ret rieve file s from dow nload. DNS . URL .
  199   This trans mits the f iles from  the first  available  server. Si tes may 
  200   also elect  to retrie ve files d irectly fr om a speci fic server
  201  
  202   Sites may  retrieve t he softwar e and/or d ocumentati on directl y using Se cure File  Transfer P rotocol (S FTP) from  the ANONYM OUS.SOFTWA RE directo ry at the  following 
  203   OI Field O ffices:
  204    
  205   Hines:                     DNS.URL   
  206   Salt Lake  City:           DNS . URL
  207  
  208   Documentat ion can al so be foun d in the V A Software  Documenta tion Libra ry (VDL) a t:
  209   https:// DNS . URL /.
  210  
  211  
  212   Title                                File N ame     FT P Mode
  213   ---------- ---------- ---------- ---------- ---------- ---------- ---------- ---------- ------
  214   Pharmacy D ata Manage ment: User  Manual                        p ss_1_um_r0 618.pdf    Binary
  215   Pharmacy D ata Manage ment: User  Manual                        p ss_1_um_r0 618.doc    Binary
  216   Pharmacy D ata Manage ment: Tech nical Manu al/Securit y Guide  p ss_1_tm_r0 618.pdf    Binary
  217   Pharmacy D ata Manage ment: Tech nical Manu al/Securit y Guide  p ss_1_tm_r0 618.doc    Binary
  218  
  219  
  220   Patch Inst allation:
  221  
  222   Pre/Post I nstallatio n Overview :
  223   ---------- ---------- ---------- -
  224   Review the  Pre-Insta llation In structions  provided  before beg inning ins tallation  of the pat ch.
  225  
  226   Pre-Instal lation Ins tructions:
  227   ---------- ---------- ----------
  228   This patch  may be in stalled wi th users o n the syst em althoug h it is re commended  that it be  installed  during no n-peak hou rs to mini mize poten tial disru ption to u sers. This  patch sho uld take l ess than 5  minutes t o install.
  229  
  230   For both s ingle and  multi-divi sional (in tegrated)  sites, the  installer  must iden tify a spe cific user  as the Ma il Group C oordinator . This ind ividual wi ll coordin ate the re cipients o f the Mail Man messag es. This i s usually  a Pharmacy  Informati cist or AD PAC. Once  identified , the Mail  Group Coo rdinator w ill be abl e to add n ew users t o the Mail  Group PSS  DEE AUDIT  to allow  those user s to recei ve Drug Fi le Audit M ailman mes sages.
  231  
  232   Installati on Instruc tions:
  233   ---------- ---------- ----------
  234   To install  the patch :
  235  
  236   1. Choose  the PackMa n message  containing  this patc h.
  237  
  238   2. Choose  the INSTAL L/CHECK ME SSAGE Pack Man option .
  239  
  240   3. From th e Kernel I nstallatio n and Dist ribution S ystem (KID S) Menu, s elect the  Installati on Menu. F rom this m enu, you m ay elect t o use the  following  options. W hen prompt ed for the  INSTALL N AME, enter  the patch  number PS S*1.0*227.
  241  
  242         a. V erify Chec ksums in T ransport G lobal - Th is option  will help  ensure the  
  243            i ntegrity o f the rout ines that  are in the  transport  global.
  244  
  245         b. P rint Trans port Globa l - This o ption will  enable vi ewing the  components  of
  246            t he KIDS bu ild.
  247  
  248         c. C ompare Tra nsport Glo bal to Cur rent Syste m - This o ption will  enable vi ewing 
  249            a ll changes  that will  be made w hen this p atch is in stalled. I t compares  all
  250            c omponents  of this pa tch (routi nes, data  dictionari es, templa tes, etc.) .
  251  
  252         d. B ack up a T ransport G lobal - Th is option  will creat e a backup  message o f any
  253            r outines ex ported wit h this pat ch. It wil l not back  up any ot her change s such
  254            a s data dic tionaries  or templat es.
  255  
  256   4. From th e Installa tion Menu,  select th e Install  Package(s)  option an d choose t he patch t o install.
  257  
  258   5. When pr ompted ‘Wa nt KIDS to  INHIBIT L OGONs duri ng the ins tall? NO// ’, press < Enter>.
  259  
  260   6. When pr ompted 'Wa nt to DISA BLE Schedu led Option s, Menu Op tions, and  Protocols ? NO//’, p ress <Ente r>.
  261  
  262   7. If prom pted ‘Dela y install  (Minutes):  (0-60): 0 //’, press  <Enter>.
  263  
  264   8. If prom pted 'Ente r the Devi ce you wan t to print  the Insta ll message s. You can  queue the  install b y enter a  'Q' at the  device pr ompt. Ente r a '^' to  abort the  install.  DEVICE: HO ME//   HOM E  (CRT)',  press <En ter>.
  265  
  266   Post-Insta llation In structions :
  267   ---------- ---------- ---------- -
  268   The Mail G roup Coord inator use r identifi ed during  installati on will ne ed to add  new users  to the PSS  DEE AUDIT  mail grou p in order  for them  to receive  Mailman m essages re garding ed its to the  DRUG file  (#50). Th ey should  use the ED IT MAIL GR OUP (XMEDI TMG) optio n to do th is. New us ers may be  entered a s 'I' (Inf ormational ) or 'CC'  (Carbon-co py) users,  as approp riate. The  installer  should no tify the M ail Group  Coordinato r that thi s task mus t be perfo rmed.
  269  
  270   Follow the  steps bel ow to set  the PSS DR UG AUDIT R ETENTION M OS paramet er, if a t ime period  for stori ng histori cal data i s required . See the  Descriptio n section  above for  more infor mation on  how this p arameter i s used. To  set the p arameter,  contact a  VistA prog rammer, Cl inical App lication C oordinator  (CAC), or  similar u ser with a ccess to t he General  Parameter  Tools [XP AR MENU TO OLS] optio n in VistA .
  271  
  272      1. Log  in to Vist A.
  273  
  274      2. At t he "Select  OPTION NA ME:" promp t, type XP AR MENU TO OLS and th en press 
  275      Enter.
  276  
  277      3. At t he "Select  General P arameter T ools Optio n:" prompt , type EP  and then 
  278      press E nter.
  279  
  280      4. At t he "Select  PARAMETER  DEFINITIO N NAME:" p rompt, typ e PSS DRUG  AUDIT RET ENTION
  281      MOS and  then pres s Enter. 
  282    
  283      5. At t he "NUMBER  OF MONTHS :" prompt,  type the  number of  retention  months
  284      and the n press En ter.
  285  
  286  
  287   Backout Pr ocedure:
  288   ---------- --------
  289   Backout of  this patc h will be  performed  only with  the concur rence and 
  290   participat ion of the  appropria te VA site /region pe rsonnel. T he decisio n to 
  291   back out t he patch w ill be a j oint decis ion betwee n VA site/ region per sonnel 
  292   and other  appropriat e VA perso nnel.
  293  
  294   Note: Due  to the com plexity of  this patc h, it is n ot recomme nded for b ackout. Ho wever, in  the event  that a sit e decides  to back ou t this pat ch, the si te should  contact th e National  Service D esk (NSD)  to submit  a help des k ticket.  The develo pment team  will then  assist wi th the bac kout proce ss.
  295  
  296  
  297   Validation  of Backou t Procedur e:
  298   ---------- ---------- ---------- --
  299   The Backou t procedur e can be v erified by  printing  the first  two lines  of the 
  300   PSS routin es contain ed in this  patch usi ng the opt ion First  Line Routi ne 
  301   Print [XU  FIRST LINE  PRINT]. O nce the PS S routines  have been  backed ou t, 
  302   the first  two lines  of the rou tines will  no longer  contain t he designa tion of 
  303   patch PSS* 1.0*227 on  line 2 in  the patch  list sect ion.
  304  
  305   Note: This  validatio n procedur e only ver ifies that  routine c hanges hav e been bac ked out; i t does not  confirm t hat other  patch comp onent chan ges have b een backed  out.
  306  
  307  
  308   Routine In formation:
  309   ---------- ----------
  310   The second  line of e ach of the se routine s now look s like:
  311    ;;1.0;PHA RMACY DATA  MANAGEMEN T;**[Patch  List]**;9 /30/97;Bui ld 16
  312  
  313   The checks ums below  are new ch ecksums, a nd can be  checked wi th CHECK1^ XTSUMBLD.
  314  
  315   Routine Na me: PSSDEE
  316       Before :B15165096 6   After: B151650966   **3,5,15 ,16,20,22, 28,32,34,3 3,
  317                                                  38,57,4 7,68,61,82 ,90,110,15 5,
  318                                                  156,180 ,193,200,2 07,195,227 **
  319   Routine Na me: PSSDEE A
  320       Before : B3515147 8   After:  B35151478   **227**
  321   Routine Na me: PSSLOO K
  322       Before :B13754916 1   After: B137576490   **3,7,15 ,16,20,24, 29,38,68,6 1,
  323                                                  87,90,1 27,147,170 ,189,192,2 00,
  324                                                  195,213 ,227**
  325   Routine Na me: PSSP22 7
  326       Before :       n/ a   After:   B5754647   **227**
  327   Routine Na me: PSSPRI CE
  328       Before :  B517949 5   After:   B5169572   **227**
  329  
  330   Routine li st of prec eding patc hes: 213