1. EPMO Open Source Coordination Office Redaction File Detail Report

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

1.1 Files compared

# Location File Last Modified
1 ETS_1_0_1.zip\ETS_1_0_1 FM_23_Patch Description_ETS_1_1_T1.txt Mon May 15 11:18:18 2017 UTC
2 ETS_1_0_1.zip\ETS_1_0_1 FM_23_Patch Description_ETS_1_1_T1.txt Tue Jun 20 17:05:52 2017 UTC

1.2 Comparison summary

Description Between
Files 1 and 2
Text Blocks Lines
Unchanged 6 836
Changed 5 18
Inserted 0 0
Removed 0 0

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

1.4 Active regular expressions

No regular expressions were active.

1.5 Comparison detail

  1   VistA Patc h Display                                                         Page: 1
  2   ========== ========== ========== ========== ========== ========== ========== =======
  3   Run Date:  MAY 11, 20 17                        Design ation: ETS *1*1  TEST  v1
  4   Package :  ENTERPRISE  TERMINOLO GY SERVICE     Priori ty   : MAN DATORY
  5   Version :  1                                    Status      : UND ER DEVELOP MENT
  6   ========== ========== ========== ========== ========== ========== ========== =======
  7  
  8   Associated  patches:  (u)ETS*1*0      <<= m ust be ins talled BEF ORE `ETS*1 *1'
  9                        
  10  
  11   Subject:   RXNORM COD E SET AND  LOINC UPDA TES
  12  
  13   Category:   ROUTINE
  14               DATA DICT IONARY
  15               ENHANCEME NT
  16  
  17   Descriptio n:
  18   ========== =
  19    
  20   The Vetera ns Informa tion Syste ms and Tec hnology Ar chitecture  (VistA)
  21   Evolution  program to  modernize  VistA inc ludes mode rnizing Ve terans Aff airs
  22   (VA's) ent erprise da ta managem ent capabi lities.  M odernizing  VA FileMa n
  23   will funct ionally st andardize  VistA's da tabase.  T his will e nable
  24   structured  data quer y and exch ange acros s all Vist A instance s, creatin g
  25   an enterpr ise view o f VistA da ta in stan dardized,  computable  form.  Th is
  26   modernized  VA FileMa n is calle d VA FileM an Enterpr ise for it s enterpri se
  27   data manag ement capa bilities.
  28    
  29   This patch , ETS*1.0* 1, introdu ces new an d modified  routines  and data
  30   dictionari es to impl ement Ente rprise Ter minology S ervices (E TS) packag e.
  31   The Enterp rise Termi nology Ser vices pack age exists  to provid
  32   enterprise -wide acce ss to comm on code se ts that ar e needed i n a health
  33   care syste m. It will  contain V A FileMan  files with  the data  and 
  34   Applicatio n Program  Interfaces  (APIs) th at can be  used to pr ovide acce ss
  35   and proces s the data . The Inte gration Co ntrol Regi strations  will be
  36   supported  and thus o pen to all  VistA app lications.
  37    
  38   Specifical ly, patch  ETS*1.0*1  contains t he followi ng:
  39   ---------- ---------- ---------- ---------- ---------- -------
  40   1. The fol lowing new  files hav e been cre ated in ET S to suppo rt the RxN orm
  41      code se t in VistA
  42    
  43      a) The  RXNORM CON CEPT NAMES  AND SOURC ES file (# 129.2)
  44      b) The  RXNORM SIM PLE CONCEP T AND ATOM  ATTRIBUTE S file (#1 29.21)
  45      c) The  RXNORM REL ATED CONCE PTS file ( #129.22)
  46      d) The  RXNORM SEM ANTIC TYPE S file (#1 29.23)
  47      e) The  RXNORM SOU RCE INFORM ATION file  (#129.24)
  48    
  49   2. The dat a for the  above file s will be  populated.  This will  require
  50      approxi mately 516  megabytes  of disk s pace and 1 1.2 gigaby tes of jou rnal
  51      space.
  52    
  53   3. The fol lowing new  APIs were  created t o retrieve  RxNorm da ta.
  54    
  55      a) $$CS DATA^ETSRX N: Get Det ailed Info rmation ab out a RxNo rm Concept
  56         Uniq ue Identif ier (RXCUI )
  57      b) $$CS YS^ETSRXN:  Retrieve  the Coding  System In formation
  58      c) $$GE TDATA^ETSR XN: Return  all infor mation for  a RXCUI
  59      d) $$HI ST^ETSRXN:  Get Activ ation Hist ory for a  RXCUI
  60      e) $$ND C2RXN^ETSR XN: Return  RXCUI for  a Nationa l Drug Cod e (NDC)
  61      f) $$PE RIOD^ETSRX N: Get Act ivation/In activation  Periods f or a RXCUI
  62      g) $RXN 2OUT^ETSRX N: Retriev e a VA Uni que Identi fier (VUID ) and NDC  for
  63         a RX CUI
  64      h) $$TA X^ETSRXN:  Return lis t of VUIDs  in same v alue set
  65      i) $$VU ICLASS^ETS RXN: Retur n list of  VUIDs with  the same  drug class
  66      j) $$VU I2RXN^ETSR XN: Retrie ve RXCUI(s ) for a va lid VUID
  67    
  68   4. The fol lowing Log ical Obser vation Ide ntifiers N ames and C odes (LOIN C)
  69      APIs we re modifie d.
  70    
  71      a) $$CH KCODE^ETSL NC
  72          i)  Change inp ut value t o be the f ull LOINC  Code
  73         ii)  Change ret urn value  from Yes/N o (1 or 0)  to Intern al Entry
  74              Number (IE N)
  75      b) $$CO MLST^ETSLN C: Allow I nput of Co mponent Na me in addi tion to
  76         Comp onent IEN
  77      c) $$CS DATA^ETSLN C: Change  Return val ue to be t he full LO INC Code
  78      d) $$GE TCODE^ETSL NC: 
  79          i)        Add  SHORT NAME  (#81) fie ld to the  output
  80         ii)        Chan ge input v alue to be  the full  LOINC Code
  81      e) $$GE TNAME^ETSL NC: Change  input val ue to be t he full LO INC Code
  82      f) $$GE TREC^ETSLN C
  83          i)  Change inp ut value t o be the f ull LOINC  Code
  84         ii)  Add EXTERN AL COPYRIG HT (#84) a nd COMPONE NT (#1) fi elds to
  85              the output
  86      g) $$GE TSTAT^ETSL NC: Change  input val ue to be t he full LO INC Code
  87      h) $$HI ST^ETSLNC:  Change in put value  to be the  full LOINC  Code
  88      i) $$PE RIOD^ETSLN C: Change  input valu e to be th e full LOI NC Code
  89      j) $$TA X^ETSLNC:  Change inp ut value t o be the f ull LOINC  Code
  90    
  91   5. Modify  the screen s for the  NON-PATIEN T SPECIMEN  (#1.7) an d the 
  92      TIME MO DIFIER (#3 .1) fields  of the LO INC (#129. 1) file.
  93    
  94   6. Update  sixteen re cords in t he LOINC A XIS CODES  (#129.22)  so that 
  95      NAME (# .01) field  is unique .
  96    
  97   Detailed i nformation  on the AP Is and the  tasks the y perform  is include d
  98   in the ETS  1.0 Techn ical Manua l/Security  Guide. 
  99    
  100    
  101   Patch Comp onents:
  102   ---------- -------
  103    
  104   Files & Fi elds Assoc iated:
  105    
  106   File Name  (#)                                                    New/Modifi ed/
  107     Sub-file  Name (#)       Field  Name (#)                          Deleted
  108   ---------- ---------       ----- ---------                        ---------- ---
  109   LOINC (#12 9.1)            NON-P ATIENT SPE CIMEN (#1. 7)         Modified
  110   LOINC (#12 9.1)            TIME  MODIFIER ( #3.1)                 Modified
  111   RXNORM CON CEPT NAMES  AND SOURC ES (#129.2 )                     New
  112   RXNORM SIM PLE CONCEP T AND ATOM  ATTRIBUTE S (#129.21 )          New 
  113   RXNORM REL ATED CONCE PTS (#129. 22)                              New
  114   RXNORM SEM ANTIC TYPE S (#129.23 )                                New
  115   RXNORM SOU RCE INFORM ATION (#12 9.24)                            New
  116    
  117    
  118   Forms Asso ciated:
  119    
  120   Form Name                        File #                 New/Modif ied/Delete d
  121   ---------                        ------                 --------- ---------- -
  122   N/A 
  123    
  124    
  125   Mail Group s Associat ed:
  126    
  127   Mail Group  Name           New/M odified/De leted
  128   ---------- -----           ----- ---------- -----
  129   N/A                         
  130    
  131    
  132   Options As sociated:
  133    
  134   Option Nam e                      Type                 New/Modifi ed/Deleted
  135   ---------- -                      ----                 ---------- ----------  
  136   N/A
  137    
  138    
  139   Protocols  Associated :
  140    
  141   Protocol N ame        New/Modifi ed/Deleted
  142   ---------- ---        ---------- ----------  
  143   N/A
  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       File  Name         (Number )  New/Mod ified/Dele ted
  156   ---------- ---   ----       ---- ---------- ---------- -  ------- ---------- ---
  157   N/A
  158    
  159    
  160   Additional  Informati on:
  161   ---------- ---------- ---
  162   N/A
  163    
  164    
  165   New Servic e Requests  (NSRs):
  166   ---------- ---------- --------  
  167   N/A
  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    
  180   Blood Bank  Clearance :
  181   ---------- ---------- -
  182   EFFECT ON  BLOOD BANK  FUNCTIONA L REQUIREM ENTS: Patc h ETS*1.0* 1 contains  
  183   changes to  a package  reference d in ProPa th standar d titled:  BBM Team 
  184   Review of  VistA Patc hes. This  patch does  not alter  or modify  any VistA  
  185   Blood Bank  software  design saf eguards or  safety cr itical ele ments 
  186   functions.
  187    
  188   RISK ANALY SIS: Chang es made by  patch ETS *1.0*1 hav e no effec t on Blood  
  189   Bank softw are functi onality, t herefore R ISK is non e.
  190    
  191    
  192    
  193   Test Sites :
  194   ---------- -
  195   TBD
  196    
  197    
  198   Software a nd Documen tation Ret rieval Ins tructions:
  199   ---------- ---------- ---------- ---------- ----------  
  200   Documentat ion descri bing the n ew functio nality int roduced by  this patc h
  201   is availab le.
  202    
  203   The prefer red method  is to ret rieve file s from dow nload. DNS        . DNS     .
  204   This trans mits the f iles from  the first  available  server. Si tes may 
  205   also elect  to retrie ve files d irectly fr om a speci fic server
  206   Sites may  retrieve t he softwar e and/or d ocumentati on directl y using 
  207   Secure Tra nsfer Prot ocol (SFTP ) from the  ANONYMOUS .SOFTWARE  directory 
  208   at the fol lowing OI  Field Offi ces:
  209    
  210   Albany:                    FTP-SITE       
  211   Hines:                     FTP-SITE           
  212   Salt Lake  City:           FTP - SITE        
  213    
  214   Documentat ion can al so be foun d on the V A Software  Documenta tion Libra ry 
  215   at: http:/ /www. DNS     /vdl/ 
  216    
  217   Title                                 File  Name           SFTP M ode
  218   ---------- ---------- ---------- ---------- ---------- ---------- ---
  219   ETS 1.0 Te chnical/Se curity Gui de   ETS_1 _TM.PDF        Binary
  220   Software I nstallatio n Host fil e    ETS_1 _0_1.KID       ASCII
  221    
  222    
  223   Backout an d Rollback  Procedure :
  224   ---------- ---------- ---------- -
  225   The rollba ck plan fo r VistA ap plications  is comple x and not  able to be
  226   a 'one siz e fits all ' solution . The gene ral strate gy for Vis tA rollbac k
  227   is to repa ir the com ponents wi th a follo w-on patch . The deve lopment te am
  228   recommends  that site s log a CA  Service D esk Manage r (SDM) ti cket for 
  229   the Health  Systems P latform gr oup if a p atch needs  to be bac ked-out. T he 
  230   support te am will de termine th e best app roach to r estore the  system to  its
  231   previous s tate.
  232    
  233   During the  VistA Ins tallation  Procedure  of the Ker nel Instal lation and
  234   Distributi on System  (KIDS) bui ld, the in staller sh ould back  up the 
  235   modified r outines by  the use o f the 'Bac kup a Tran sport Glob al' action
  236   (step 4a i n the Inst allations  Instructio ns below).  The insta ller can
  237   restore th e routines  using the  MailMan m essage tha t were sav ed prior t o
  238   installing  the patch . The back out proced ure for da ta diction ary data l oads
  239   is more co mplex and  may requir e the issu ance of a  follow-on  patch to
  240   ensure all  component s are prop erly remov ed. Note t hat all ro llback of  all
  241   software c omponents,  including  routines  must be re stored to  their prev ious
  242   state at t he same ti me and in  conjunctio n with res toration o f the data .
  243    
  244    
  245   Patch Inst allation:
  246    
  247   Pre/Post I nstallatio n Overview :
  248   ---------- ---------- ---------- -
  249   There is a  pre-insta ll routine  PRE^ETS1P 1 that pre pares the  current 
  250   process fo r the inst all.
  251    
  252   There is a  post-inst all routin e PST^ETS1 P1 that wi ll update  the NAME
  253   (#.01) fie ld of the  LOINC AXIS  CODES (#1 29.22) fil e for sixt een record s.
  254    
  255    
  256   Pre-Instal lation Ins tructions:
  257   ---------- ---------- ----------
  258   This patch  may be in stalled wi th users o n the syst em althoug h it is 
  259   recommende d that it  be install ed during  non-peak h ours to mi nimize
  260   potential  disruption  to users.  This patc h should t ake approx imately 90
  261   minutes to  install.
  262    
  263   No options  or protoc ols need t o be disab led to ins tall this  patch.
  264    
  265   The instal lation of  this patch  can be qu eued.
  266    
  267   Note that  this insta ll will re quire appr oximately  516 megaby tes of dis k
  268   space and  11.2 gigab ytes of jo urnal spac e.
  269    
  270    
  271   Installati on Instruc tions:
  272   ---------- ---------- ------
  273    
  274   1.  OBTAIN  PATCH
  275       ------ ------
  276       Obtain  the host  file ETS_1 _0_1.KID,  which cont ains the f ollowing 
  277       patch:
  278    
  279           ET S*1.0*1
  280    
  281       Sites  can retrie ve VistA s oftware di rectly usi ng Secure  File Trans fer
  282       Protoc ol (sFTP)  from the A NONYMOUS.S OFTWARE di rectory at  the follo wing
  283       sFTP a ddress:
  284    
  285                         download. DNS      . DNS    
  286    
  287       This w ill transm it the fil es from th e first av ailable sF TP server.
  288       Sites  may also e lect to re trieve sof tware dire ctly from  a specific
  289       server  as follow s:
  290    
  291          Alb any                     FTP-SITE       
  292          Hin es                      FTP-SITE        
  293            Salt Lake  City            FTP - SITE       
  294    
  295       The ET S_1_0_1.KI D host fil e is locat ed in the  anonymous. software 
  296       direct ory. Use A SCII Mode  when downl oading the  file.
  297    
  298   2.  START  UP KIDS
  299       ------ -------
  300       Start  up the Ker nel Instal lation and  Distribut ion System  Menu opti on
  301       [XPD M AIN]:
  302    
  303            E dits and D istributio n ...
  304            U tilities . ..
  305            I nstallatio n ...
  306    
  307       Select  Kernel In stallation  & Distrib ution Syst em Option:  INStallat ion
  308                                                                      ---
  309            L oad a Dist ribution
  310            P rint Trans port Globa l
  311            C ompare Tra nsport Glo bal to Cur rent Syste m
  312            V erify Chec ksums in T ransport G lobal
  313            I nstall Pac kage(s)
  314            R estart Ins tall of Pa ckage(s)
  315            U nload a Di stribution
  316            B ackup a Tr ansport Gl obal
  317    
  318       Select  Installat ion Option :
  319    
  320   3.  LOAD T RANSPORT G LOBAL
  321       ------ ---------- -----
  322       From t he Install ation menu , select t he Load a  Distributi on option.
  323    
  324       When p rompted fo r "Enter a  Host File :", enter  the full d irectory
  325       path w here the h ost file E TS_1_0_1.K ID was sav ed. For ex ample:  
  326       
  327       SYS$SY SDEVICE:[A NONYMOUS]  ETS_1_0_1. KID
  328    
  329       When p rompted fo r "OK to c ontinue wi th Load? N O//", ente r "YES."
  330    
  331       The fo llowing wi ll display :
  332    
  333         Load ing Distri bution...
  334    
  335           ET S_1_0_1.KI D
  336        Use I NSTALL NAM E: ETS*1.0 *1 to inst all this
  337        Distr ibution.
  338    
  339    
  340   4.  RUN OP TIONAL INS TALLATION  OPTIONS
  341       ------ ---------- ---------- -------
  342       From t he Install ation menu , you may  select to  use the fo llowing
  343       option al options  (when pro mpted for  the INSTAL L NAME, en ter 
  344       ETS*1. 0*1):
  345    
  346       a.  Ba ckup a Tra nsport Glo bal - This  option wi ll create  a backup
  347           me ssage of a ny routine s exported  with this  patch. It  will not
  348           ba ckup any o ther chang es such as  data dict ionaries o r template s.
  349           
  350       b.  Co mpare Tran sport Glob al to Curr ent System  - This op tion will
  351           al low you to  view all  changes th at will be  made when  this patc h
  352           is  installed . It compa res all co mponents o f this pat ch
  353           (r outines, d ata dictio naries, te mplates, e tc.).
  354    
  355       c.  Ve rify Check sums in Tr ansport Gl obal - Thi s option w ill allow
  356           yo u to ensur e the inte grity of t he routine s that are  in the
  357           tr ansport gl obal.
  358    
  359   5.  INSTAL L THE BUIL D
  360       ------ ---------- -
  361       This i s the step  to start  the instal lation of  this KIDS  patch. 
  362       This w ill need t o be run f or the ETS *1.0*1 pat ch.
  363    
  364       a.  Ch oose the I nstall Pac kage(s) op tion to st art the pa tch
  365           in stall.
  366    
  367       b.  Wh en prompte d for the  "Select IN STALL NAME :", enter  ETS*1.0*1.
  368    
  369       c.  Wh en prompte d "Want KI DS to INHI BIT LOGONs  during th e install?
  370           YE S//", ente r NO.
  371    
  372       d.  Wh en prompte d "Want to  DISABLE S cheduled O ptions, Me nu Options ,
  373           an d Protocol s? NO//",  enter NO.
  374    
  375       e.  Wh en prompte d "Device:  HOME//",  respond wi th the cor rect devic e.
  376    
  377    
  378   Post-Insta llation In structions :
  379   ---------- ---------- ---------- -
  380   1. In orde r to updat e the META  DATA DICT IONARY Fil e, run the  UPDATE TH
  381      META DA TA DICTION ARY [DDU U PDATE META  DD] optio n, which i s located  on
  382      the DAT A DICTIONA RY UTILITI ES [DI DDU ] menu of  VA FileMan  [DIUSER].
  383    
  384   2. The ETS 1P1 post i nstall rou tine may b e deleted  after inst all.
  385  
  386  
  387   Routine In formation:
  388   ========== ==========
  389  
  390  
  391   The second  line of e ach of the se routine s now look s like:
  392   ;;1.0;Ente rprise Ter minology S ervice;**[ Patch List ]**;Mar 20 , 2017;Bui ld 7
  393  
  394   The checks ums below  are new ch ecksums, a nd
  395    can be ch ecked with  CHECK1^XT SUMBLD.
  396  
  397   Routine Na me: ETS10P 0
  398       Before :       n/ a   After:     Delete   
  399   Routine Na me: ETS1P1
  400       Before :       n/ a   After:   B5937912   **1**
  401   Routine Na me: ETSLNC
  402       Before :       n/ a   After:  B86929400   **1**
  403   Routine Na me: ETSLNC 1
  404       Before :       n/ a   After:  B14161218   **1**
  405   Routine Na me: ETSLNC 2
  406       Before :       n/ a   After:   B8966655   **1**
  407   Routine Na me: ETSLNC 3
  408       Before :       n/ a   After:  B58309656   **1**
  409   Routine Na me: ETSLNC IX
  410       Before :       n/ a   After:   B9991707   **1**
  411   Routine Na me: ETSLNC TX
  412       Before :       n/ a   After:  B32085670   **1**
  413   Routine Na me: ETSRXN
  414       Before :       n/ a   After:  B54861353   **1**
  415   Routine Na me: ETSRXN 1
  416       Before :       n/ a   After:  B70502187   **1**
  417   Routine Na me: ETSRXN TX
  418       Before :       n/ a   After:  B77757125   **1**
  419  
  420  
  421   ========== ========== ========== ========== ========== ========== ========== =======
  422   User Infor mation:  
  423     Entered  By  :   BL AESER,DAVI D        D ate Entere d  :   APR  20,2017
  424     Complete d By:                          D ate Comple ted:   
  425     Released  By :                          D ate Releas ed :   
  426   ========== ========== ========== ========== ========== ========== ========== =======
  427