23. EPMO Open Source Coordination Office Redaction File Detail Report

Produced by Araxis Merge on 4/9/2019 3:29:20 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.

23.1 Files compared

# Location File Last Modified
1 CPRS_EP1_OR_3_453.zip\CPRS_EP1_OR_3_453\OR_3_453_Documentation.zip OR_3_453_Install_Guide.doc Wed Mar 20 01:11:46 2019 UTC
2 CPRS_EP1_OR_3_453.zip\CPRS_EP1_OR_3_453\OR_3_453_Documentation.zip OR_3_453_Install_Guide.doc Tue Apr 9 18:51:31 2019 UTC

23.2 Comparison summary

Description Between
Files 1 and 2
Text Blocks Lines
Unchanged 8 1624
Changed 6 19
Inserted 0 0
Removed 3 6

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

23.4 Active regular expressions

No regular expressions were active.

23.5 Comparison detail

  1  
CPRS Patch  OR*3.0*45 3 Provider  Role Chan ge
  2   Deployment , Installa tion, Back -Out, and  Rollback G uide
  3  
  4   March 2019
  5   Department  of Vetera ns Affairs
  6   Office of  Informatio n and Tech nology (OI &T)
  7   Enterprise  Program M anagement  Office
  8   Revision H istory
  9   DateVersio nPagesDesc riptionAut hor3/15/20 190.0411Re moved Note  reference  to Vitals  ManagerC.  Bernier/C . Bell3/5/ 20190.03Up dates per  Developer  reviewC. B ernier2/28 /20190.02D eveloper R eviewC. Be ll1/25/201 90.01Tech  Writer rev iewC. Bern ierArtifac t Rational e
  10   This docum ent descri bes the De ployment,  Installati on, Back-o ut, and Ro llback Pla n for new  products g oing into  the VA Ent erprise. T he plan in cludes inf ormation a bout syste m support,  issue tra cking, esc alation pr ocesses, a nd roles a nd respons ibilities  involved i n all thos e activiti es. Its pu rpose is t o provide  clients, s takeholder s, and sup port perso nnel with  a smooth t ransition  to the new  product o r software , and shou ld be stru ctured app ropriately , to refle ct particu lars of th ese proced ures at a  single or  at multipl e location s.
  11   Per the Ve teran-focu sed Integr ated Proce ss (VIP) G uide, the  Deployment , Installa tion, Back -out, and  Rollback P lan is req uired to b e complete d prior to  Critical  Decision P oint #2 (C D #2), wit h the expe ctation th at it will  be update d througho ut the lif ecycle of  the projec t for each  build, as  needed. 
  12   Table of C ontents
  13   iiRevision  History
  14  
  15  
  16   iiArtifact  Rationale
  17  
  18  
  19   51
  20   Introducti on
  21  
  22  
  23   51.1
  24   Purpose
  25  
  26  
  27   51.2
  28   Dependenci es
  29  
  30  
  31   61.3
  32   Constraint s
  33  
  34  
  35   62
  36   Roles and  Responsibi lities
  37  
  38  
  39   73
  40   Deployment
  41  
  42  
  43   73.1
  44   Timeline
  45  
  46  
  47   83.2
  48   Site Readi ness Asses sment
  49  
  50  
  51   83.2.1
  52   Deployment  Topology  (Targeted  Architectu re)
  53  
  54  
  55   83.2.2
  56   Site Infor mation (Lo cations, D eployment  Recipients )
  57  
  58  
  59   83.2.3
  60   Site Prepa ration
  61  
  62  
  63   83.3
  64   Resources
  65  
  66  
  67   83.3.1
  68   Facility S pecifics
  69  
  70  
  71   83.3.2
  72   Hardware
  73  
  74  
  75   93.3.3
  76   Software
  77  
  78  
  79   93.3.4
  80   Communicat ions
  81  
  82  
  83   94
  84   Installati on
  85  
  86  
  87   94.1
  88   Pre-instal lation Con sideration s
  89  
  90  
  91   94.2
  92   Platform I nstallatio n and Prep aration
  93  
  94  
  95   94.3
  96   Download a nd Extract  Files
  97  
  98  
  99   104.4
  100   Installati on Procedu re
  101  
  102  
  103   114.4.1
  104   Install OR *3.0*453
  105  
  106  
  107   114.4.2
  108   Provider R ole Tool G UI Install ation
  109  
  110  
  111   145
  112   Post-Insta llation Co nsideratio ns
  113  
  114  
  115   145.1
  116   Ensure tha t the Post  Installat ion Routin e Runs to  Completion
  117  
  118  
  119   235.2
  120   Assign the  OR PRT Ac cess Secur ity Key to  Those Ide ntified as  Provider  Role Tool  GUI Users
  121  
  122  
  123   235.3
  124   Assign a C PRS Tools  Menu Item  to Those I dentified  as Provide r Role Too l GUI User s
  125  
  126  
  127   245.4
  128   Installati on Verific ation Proc edure
  129  
  130  
  131   245.5
  132   System Con figuration
  133  
  134  
  135   246
  136   Back-Out P rocedure
  137  
  138  
  139   256.1
  140   Back-Out S trategy
  141  
  142  
  143   256.2
  144   Back-Out C onsiderati ons
  145  
  146  
  147   256.2.1
  148   Load Testi ng
  149  
  150  
  151   256.2.2
  152   User Accep tance Test ing
  153  
  154  
  155   256.3
  156   Back-Out C riteria
  157  
  158  
  159   256.4
  160   Back-Out R isks
  161  
  162  
  163   256.5
  164   Authority  for Back-O ut
  165  
  166  
  167   256.6
  168   Back-Out P rocedure
  169  
  170  
  171   266.7
  172   Back-out V erificatio n Procedur e
  173  
  174  
  175   277
  176   Rollback P rocedure
  177  
  178  
  179   277.1
  180   Rollback C onsiderati ons
  181  
  182  
  183   277.2
  184   Rollback C riteria
  185  
  186  
  187   277.3
  188   Rollback R isks
  189  
  190  
  191   277.4
  192   Authority  for Rollba ck
  193  
  194  
  195   277.5
  196   Rollback P rocedure
  197  
  198  
  199   277.6
  200   Rollback V erificatio n Procedur e
  201  
  202  
  203  
  204  
  205   List of Ta bles
  206   6Table 1:  Roles and  Responsibi lities
  207  
  208  
  209   9Table 2:  OI Field O ffices
  210  
  211  
  212   10Table 3:  Files to  be 
  213  
  214  
  215   26Table 4:  CPRS Deve lopment Te am Contact s
  216  
  217  
  218  
  219  
  220   List of Fi gures
  221   13Figure 1 : Shortcut  Icon Prov ider Role  Tool
  222  
  223  
  224   14Figure 2 : Test Pro viderRoleT ool453 Pro perties
  225  
  226  
  227  
  228  
  229   Introducti on
  230   The purpos e of this  patch is t o allow an  Ordering  Provider w ho is bein g given a  role chang e (e.g., t ransferred  to DoD fr om VA, rot ating from  Cardiolog y to Oncol ogy within  the facil ity), to h ave his or  her Patie nt Orders  reassigned  permanent ly to one  or more Pr oviders wh o will the n receive  alerts/not ifications  for those  orders as  of the tr ansfer dat e/time.
  231   A new Prov ider Role  Tool Graph ical User  Interface  (GUI) tool  will be a vailable t hrough the  Computeri zed Patien t Record S ystem (CPR S) to pull  up an ord ering prov ider’s pat ient order s for a da te range s elected by  the end u ser. Using  the GUI t ool, the e nd user wi ll be able  to reassi gn those p atient ord ers to one  or more p roviders w ho must be  able, at  least gene rally, to  receive al erts/notif ications.  Only patie nt orders  in a signe d state wi ll be avai lable for  selection.  See Post  Installati on instruc tions belo w to see h ow to set  up securit y for user s who need  access to  this new  tool.
  232   A new "EPR ACDT" cros s referenc e (index)  on the ORD ER file (# 100) has b een create d to be ab le to quic kly pull u p order pr oviders fr om the ORD ER ACTIONS  multiple  field (.8)  who are c urrently r esponsible  for patie nt orders  so these c an be reas signed.
  233   Once new p roviders h ave been a ssigned pa tient orde rs, the en d user can  press the  Apply Cha nges butto n to compl ete the re assignment s. Each pa tient orde r will rep ort back t o the end  user succe ss or fail ure of rea ssignment.  For examp le, one fa ilure coul d occur if  a patient  order is  being edit ed by anot her user.
  234   Another ne w "EPRTRDT " cross re ference (i ndex) on t he ORDER f ile (#100)  has been  created to  allow a n ewly assig ned provid er's patie nt orders  to be reas signed per manently t o a third  provider.  This may r arely occu r but it i s possible .
  235   This docum ent descri bes how to  deploy an d install,  how to ba ck-out the  product,  and rollba ck to a pr evious ver sion or da ta set. Th is documen t is a com panion to  the projec t charter  and manage ment plan  for this e ffort.
  236   Purpose
  237   The purpos e of this  guide is t o provide  a single,  common doc ument that  describes  how, when , where, a nd to whom  the Provi der Role T ool patch  (OR*3.0*45 3) and the  associate d Provider  Role Tool  GUI will  be deploye d and inst alled, as  well as ho w it is to  be backed  out and r olled back , if neces sary. The  guide also  identifie s resource s, communi cations pl an, and ro llout sche dule. Spec ific instr uctions fo r installa tion, back -out, and  rollback a re include d in this  document. 
  238   Dependenci es
  239   The instal lation of  the Provid er Role To ol patch ( OR*3.0*453 ) and the  associated  Provider  Role Tool  GUI assume s a fully  patched Vi stA system  and a Win dows syste m. In addi tion, the  following  specific p atches mus t be insta lled:
  240   OR*3.0*42
  241   OR*3.0*397
  242   OR*3.0*452
  243   OR*3.0*471
  244   Constraint s
  245   The Provid er Role To ol patch w ill be ins talled on  VistA serv ers. The p atch and t he associa ted GUI ar e 508 comp liant.
  246   Roles and  Responsibi lities
  247   No one sin gle entity  oversees  decision m aking for  deployment , installa tion, back  out and r ollback of  Provider  Role Tool  v1.0.45.12 . The Rele ase Agent  and Applic ation Coor dinators u nder the V eterans in  Process w ill approv e deployme nt and ins tall from  a product  developmen t perspect ive. If an  issue wit h the soft ware arise s, the Are a Managers  and other  site lead ership wil l meet alo ng with in put from P atient Saf ety and He alth Produ ct Support  to initia te a back  out and ro llback dec ision of t he softwar e along wi th the IT  Operations  and Servi ces person nel. The f ollowing t able provi des Provid er Role To ol v1.0.45 .12 projec t informat ion.
  248   Table 1: R oles and R esponsibil ities
  249   TeamPhase  / RoleTask sIT Operat ions and S ervices pe rsonnelDep loymentPla n and sche dule deplo yment (inc luding orc hestration  with vend ors)IT Ope rations an d Services  personnel Deployment Determine  and docume nt the rol es and res ponsibilit ies of tho se involve d in the d eployment. Site perso nnel. Depl oymentTest  for opera tional rea diness IT  Operations  and Servi ces person nel
  250   The IT sup port will  need to in clude pers on(s) to i nstall the  Kernel In stallation  and Distr ibution Sy stem (KIDS ) build as  well as t he personn el to depl oy the GUI  – which m ay be done  on each m achine, a  shared net work, and/ or the Cit rix access  gatewayDe ploymentEx ecute depl oymentIT O perations  and Servic es personn el.
  251   The IT sup port will  need to in clude pers on(s) to i nstall the  KIDS buil d as well  as the per sonnel to  deploy the  GUI – whi ch may be  done on ea ch machine , a shared  network,  and/or the  Citrix ac cess gatew ayInstalla tionPlan a nd schedul e installa tion N/A –  will work  under the  VistA ATO  and secur ity protoc ols.Instal lationEnsu re authori ty to oper ate and th at the cer tificate a uthority s ecurity do cumentatio n is in pl aceN/A – n o equipmen t is being  added.Ins tallationV alidate th rough faci lity POC t o ensure t hat IT equ ipment has  been acce pted using  asset inv entory pro cessesN/A  – no new f unctionali ty is bein g introduc ed.Install ationsCoor dinate tra ining Faci lity CIO,  IT Operati ons, and S ervices pe rsonnelBac k-outConfi rm availab ility of b ack-out in structions  and back- out strate gy (what a re the cri teria that  trigger a  back-out)  Hardware  and System  support –  no change s.
  252   Software s upport wil l be the H PS Clinica l Sustainm ent team.P ost Deploy mentHardwa re, Softwa re, and Sy stem Suppo rtDeployme nt 
  253   Provider R ole Tool f eatures ar e included  in the M  side patch  (OR*3.0*4 53) and a  Provider R ole Tool G UI compone nt, both o f which mu st be inst alled for  the featur es to be a vailable.  The patch  will be in stalled on  the VistA  server. H owever, be cause Prov ider Role  Tool GUI i s not need ed for all  users, on ly a small  group of  users will  have acce ss to the  Provider R ole Tool G UI through  a link on  their CPR S Tools me nu.
  254   The deploy ment will  be a stand ard releas e with a 3 0-day comp liance win dow.
  255   There are  currently  no site-fa cing onlin e meetings  or traini ng planned  for this  deployment .
  256   Timeline 
  257   There is n o timeline  specifica lly for de ployment.  Installati on will be  at the si te’s discr etion, wit hin the co nstraints  of the com pliance pe riod for t he release .
  258   Site Readi ness Asses sment 
  259   This secti on discuss es the loc ations tha t will rec eive the P rovider Ro le Tool v1 .0.453.12  deployment .
  260   Provider R ole Tool p atch OR*3* 453 will b e installe d on all V istA insta nces for a ll VistA d atabases.
  261   Sites must  decide wh ich indivi duals will  be respon sible for  reassignin g orders f rom provid ers who ha ve changed  roles to  other prov iders. The se individ uals must  be given a  security  key and ac cess to th e Provider  Role Tool  GUI.
  262   The system  must have  the requi red patche s installe d.
  263   Deployment  Topology  (Targeted  Architectu re)
  264   Provider R ole Tool v 1.0.453.12  will be d eployed to  each Vist A instance . That wil l include  local site s as well  as regiona l data pro cessing ce nters. The  executabl e will als o be deplo yed to the  Citrix Ac cess Gatew ay.
  265   Site Infor mation (Lo cations, D eployment  Recipients )
  266   The initia l deployme nt will be  to IOC si tes for ve rification  of functi onality. O nce that t esting is  completed  and approv al is give n for nati onal relea se, Provid er Role To ol v1.0.45 3.12 (OR*3 .0*453) wi ll be depl oyed to al l VistA sy stems.
  267   The Produc tion (IOC)  testing s ites are:
  268   Little Roc k
  269   Milwaukee
  270   Black Hill s
  271   Site Prepa ration
  272   The system  must have  the requi red patche s installe d and a fu lly patche d VistA sy stem.
  273   There are  no specifi c hardware  preparati ons requir ed for pat ch OR*3.0* 453.
  274   Resources
  275   N/A
  276   Facility S pecifics
  277   N/A
  278   Hardware 
  279   N/A
  280   Software
  281   As stated  above, pat ch OR*3.0* 453 requir es a fully  patched V istA syste m and a Wi ndows oper ating syst em.
  282   Communicat ions
  283   Communicat ion with t he Client  Technologi es group m ay be requ ired depen ding on th e installa tion metho d chosen.
  284   Installati on
  285   Pre-instal lation Con sideration s
  286   Patch OR*3 .0*453 ins talls on a  standard  VistA serv er and the  GUI runs  on a Windo ws operati ng system.  There are  no specia l hardware  or operat ing system  requireme nts.
  287   Platform I nstallatio n and Prep aration
  288   [VistA] Th is patch m ay be inst alled with  users on  the system  although  it is reco mmended th at it be i nstalled d uring non- peak hours  to minimi ze potenti al disrupt ion to use rs. The le ngth of ti me to inst all the pa tch will d epend on t he number  of ORDER f ile (#100)  ORDER ACT IONS multi ple record s that the  New Style  cross ref erence (in dex) "EPRA CDT" will  have to cr eate entri es for. 
  289   [GUI] The  time to de ploy the G UI will de pend on wh ich method  the site  utilizes f or running  the execu table (net work share , Citrix,  individual  workstati on install s, etc.).
  290   Download a nd Extract  Files
  291   Provider R ole Change  v1.0.453. 12 is bein g released  as a Host  file dist ributed th rough the  National P atch Modul e and a .Z IP file co ntaining t he GUI fil e(s).
  292   The prefer red method  is to ret rieve file s from  DNS . URL .
  293   This trans mits the f iles from  the first  available  server. Si tes may al so elect t o retrieve  files dir ectly from  a specifi c server.
  294   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 
  295   Table 2: O I Field Of fices
  296   LocationSi teHines DNS . URL  Salt Lake  City DNS . URL  Documenta tion can a lso be fou nd on the  VA Softwar e Document ation Libr ary at:
  297   Computeriz ed Patient  Record Sy stem (CPRS )
  298    HYPERLINK  "https:// www.va.gov /vdl/appli cation.asp ?appid=61"  \o "Compu terized Pa tient Reco rd System  (CPRS)Comp uterized P atient Rec ord System  (CPRS)" T able 3: Fi les to be  Downloaded
  299   File NameF ile Conten ts Downloa d FormatOR _30_453V12 .ZIPProvid er Role To ol GUI and  help file BinaryOR_3 0_453.KIDH ost FileAS CIIDatabas e Creation
  300   N/A
  301   Installati on Scripts
  302   N/A
  303   Cron Scrip ts
  304   N/A
  305   Access Req uirements  and Skills  Needed fo r the Inst allation
  306   Sites will  need pers onnel with  the follo wing to in stall and  implement  the Provid er Role Ch ange softw are.
  307   Installati on of Prov ider Role  Tool v1.0. 453.12 req uires the  following  to install :
  308   Programmer  access to  VistA ins tance and  ability to  install K IDS build.
  309   Local faci lity or In formation  Technology  Operation s and Serv ices (ITOP S) to give  the user  the OR PRT  ACCESS se curity key  and add t he Provide r Role Too l item to  designated  users, su ch as CACs  or others , Tools me nu in CPRS
  310   Citrix Acc ess Gatewa y (CAG) in stalls – a ccess/abil ity to upl oad to the  CAG.
  311   Network Sh are instal ls – acces s/ability  to upload  executable  to the ne twork shar e location .
  312   Individual  work-stat ion instal ls – acces s/ability  to push ex ecutable t o required  work stat ions.
  313   Installati on Procedu re
  314   Before pro ceeding, e nsure that  the follo wing patch es are ins talled on  your syste m:
  315   OR*3*42
  316   OR*3*397
  317   OR*3*452
  318   OR*3*471
  319   Install OR *3.0*453
  320   Please coo rdinate wi th the app ropriate p ersonnel t o ensure t he patch a nd the exe cutable ar e installe d at the a ppropriate  times and  order Ins tallation  Instructio ns:
  321   Load the h ost file O R_30_453.K ID using t he "Load a  Distribut ion" optio n on the V istA XPD I nstallatio n Menu.
  322   From the K ernel Inst allation a nd Distrib ution Syst em 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:  OR*3.0*45 3.
  323   Backup a T ransport G lobal - Th is option  will creat e a backup  message o f any rout ines expor ted with t his patch.  It will n ot backup  any other  changes su ch as DDs  or templat es.
  324   Compare Tr ansport Gl obal to Cu rrent Syst em - This  option wil l allow yo u to view  all change s that wil l be made  when this  patch is i nstalled.  It compare s all comp onents of  this patch  (routines , DDs, tem plates, et c.). 
  325   Verify Che cksums in  Transport  Global - T his option  will allo w you to e nsure the  integrity  of the rou tines that  are in th e transpor t global.
  326   From the I nstallatio n Menu, se lect the I nstall Pac kage(s) op tion and c hoose the  patch to i nstall: OR *3.0*453 
  327   When promp ted 'Want  KIDS to Re build Menu  Trees Upo n Completi on of Inst all? NO//' , respond  NO.
  328   When promp ted 'Want  KIDS to IN HIBIT LOGO Ns during  the instal l? NO//',  respond NO .
  329   When promp ted 'Want  to DISABLE  Scheduled  Options,  Menu Optio ns, and Pr otocols? N O//', resp ond NO.
  330   If prompte d 'Delay I nstall (Mi nutes): (0  - 60): 0/ /' respond  0.
  331   Provider R ole Tool G UI Install ation
  332   The ZIP fi le contain s the Prov ider Role  Tool GUI e xecutables . Download  the ZIP f ile and ex tract all  the files.
  333   The follow ing method s of insta llation of  Provider  Role Tool  are availa ble. Sites ' choice o f which me thod(s) to  use will  depend upo n IT Opera tions and  Services p ersonnel/V ISN polici es, Local  Area Netwo rk (LAN) p erformance  or other  local circ umstances.  User requ irements,  physical l ocation, a nd methods  of connec tion to th e VA netwo rk may war rant more  than one o f the opti ons below  to be used
  334   Network (s hared) ins tallation:
  335   This metho d is typic ally the s implest to  maintain,  providing  the local  network i nfrastruct ure is rob ust enough  to handle  the addit ional traf fic caused  by users  running th e GUI exec utable (Pr oviderRole Tool.exe)  across the  LAN.
  336   The GUI ex ecutable ( ProviderRo leTool.exe ), help fi le (Provid erRoleTool .chm are c opied to a  network s hared loca tion. User s are prov ided with  a desktop  shortcut t o run Prov iderRoleTo ol.exe dir ectly from  the netwo rk shared  drive. The  necessary  command l ine parame ters (Vist A server a ddress or  name and R PC Broker  Port numbe r) are ent ered in th e “Target”  field of  the shortc ut propert ies
  337   At the tim e of a Pro vider Role  Tool vers ion update  the copy  of Provide rRoleTool. exe and th e help fil e are repl aced, on t he network  share, wi th the new  version.
  338   Any users  requiring  access to  another si te's Provi derRoleToo l.exe syst em can be  given an a lternate d esktop sho rtcut with  command l ine parame ters appro priate to  the intend ed target  VistA syst em.
  339   If a user  requires a ccess to a n older or  newer ver sion of Pr oviderRole Tool.exe ( e.g. for t esting pur poses), a  different  version of  ProviderR oleTool.ex e can be p laced in a  separate  network lo cation and  the user  can be sup plied with  an approp riate alte rnate shor tcut (diff erent Targ et path an d differen t VistA se rver comma nd line pa rameters).
  340   Citrix ins tallation:
  341   The GUI ex ecutables  (ProviderR oleTool.ex e) and hel p folder a nd file (P roviderRol eTool.chm)  are insta lled and r un from a  remote wor kstation,  and the us er views t he remote  workstatio n’s screen  on their  local work station.
  342   For the lo cal site u sers, this  method is  on a simi lar level  to the Net work (shar ed) instal lation abo ve. The us ers' works tations re quire only  an approp riate shor tcut (and  the necess ary Citrix  Access Gr oup (CAG)  infrastruc ture).
  343   Note: For  issues wit h CAG, ple ase contac t the loca l or natio nal help d esk.
  344   For the Ci trix Farm  administra tor, this  method inv olves inst allations  on the hos t in a sim ilar manne r to eithe r the Gold  Path or t he Direct  Access met hods outli ned below.
  345   Local work station in stallation :
  346   This is th e “standar d” method  of install ation wher e the GUI  executable  (Provider RoleTool.e xe) and fi le (Provid erRoleTool .chm) are  installed  on and run  from the  user's loc al worksta tion. This  method of  installat ion initia lly requir es the dis tribution  and instal lation of  a Microsof t Software  Installat ion (MSI)  file to ea ch user's  workstatio n, typical ly accompl ished via  SCCM. A Na tional pac kage (Prov ider Role  Tool v1.0. 453.12) ha s been pre pared and  made avail able to Re gional COR  Client Te chnologies  leadershi p.
  347   Manual ins tall:
  348   This metho d is used  for users  who wish t o have a p roduction  instance a nd a non-p roduction  instance r unning on  the same m achine. An  example w ould be us ers who ar e testing  this softw are or nee d to have  access to  a pre-prod uction (mi rror) Vist A instance .
  349   Locate the  OR_30_453 .ZIP and u nzip the f ile.
  350   Copy the c ontents of  the zip a rchive (th e GUI and  the help f ile) to a  test direc tory, for  example, C :\Provider RoleToolTe st. A new  directory  may need t o be creat ed.
  351   Note: Admi nistrator  rights are  required  for the PC  used to c omplete th is step.
  352   Create a S hortcut an d name it  “Test Prov iderRoleTo ol453”
  353   This is to  give the  user anoth er visual  cue that t his is not  the norma l Provider  Role Tool  icon.
  354   Figure 1:  Shortcut I con Provid er Role To ol
  355    
  356   Determine  the DNS se rver name  or IP addr ess for th e appropri ate VistA  server.
  357   Determine  the Broker  RPC port  for the Vi stA accoun t.
  358   Enter IP ( or DNS nam e) and RPC  port in t he Target  field of t he Shortcu t properti es (or use  ServerLis t.exe).
  359   Figure 2:  Test Provi derRoleToo l453 Prope rties
  360  
  361   Note: The  server and  port numb er shown a bove are f or example  only.
  362   Post-Insta llation Co nsideratio ns
  363   There are  several th ings that  need to ha ppen after  the patch  is instal led.
  364   Ensure tha t the Post  Installat ion Routin e Runs to  Completion
  365   This patch  starts a  Post Insta llation ro utine OR3P 453 that w ill run a  Background  Job to cr eate the E PRACDT New  Style cro ss referen ce along w ith the da ta for thi s index fr om the ORD ER file (# 100). Once  it has fi nished, it  will send  a MailMan  message i ndicating  so to the  installing  user. 
  366   Note:
  367   Do NOT act ivate the  Provider R ole Tool G UI for use rs until t his Backgr ound Job h as run to  a successf ul complet ion. Whoev er kicked  off the OR *3*453 ins tallation  can get th e TaskMan  job for th is Backgro und Job by  looking a t the Inst all File P rint for t he Install . If the s ystem is e xperiencin g slowness , the post -installat ion routin e can be p aused and  restarted,  but it MU ST run to  completion  before th e rest of  the instal lation con tinues.
  368   Note:  This Backg round Job  pauses eve ry 100,000  records f or 5 minut es so that  it will n ot hit the  Productio n system t oo hard du ring EPRAC DT creatio n. End use rs who hav e programm er access  will have  the abilit y to Stop  this Job,  Resume it  from where  it last l eft off, a nd check t he Percent age Comple ted by run ning the C HECK^OR3P4 53 Tag.
       
  369   Below is a n example  of the pos t installa tion routi ne running . It also  shows the  user stopp ing and re starting t he routine . This cap ture is a  basic exam ple from a  test acco unt, not a  true prod uction ins tallation.  As a resu lt, some i tems may h ave been a ltered to  remove ide ntifying f eatures or  for clari ty.
  370   Select OPT ION NAME:  XPD MAIN        Kerne l Installa tion & Dis tribution  System men u
  371              Edits and  Distributi on ...
  372              Utilities  ...
  373              Installati on ...
  374              Patch Moni tor Main M enu ...
  375   Select Ker nel Instal lation & D istributio n System < TEST ACCOU NT> Option : INstalla tion
  376      1       Load a Dis tribution
  377      2       Verify Che cksums in  Transport  Global
  378      3       Print Tran sport Glob al
  379      4       Compare Tr ansport Gl obal to Cu rrent Syst em
  380      5       Backup a T ransport G lobal
  381      6       Install Pa ckage(s)
  382              Restart In stall of P ackage(s)
  383              Unload a D istributio n
  384   Select Ins tallation  <TEST ACCO UNT> Optio n: 6  Inst all Packag e(s)
  385   Select INS TALL NAME:     OR*3.0 *453    8/ 10/18@09:5 5:46
  386        => OR *3*453 TES T v7
  387   This Distr ibution wa s loaded o n Aug 10,  2018@09:55 :46 with h eader of 
  388      OR*3*45 3 TEST v7
  389      It cons isted of t he followi ng Install (s):
  390        OR*3. 0*453
  391   Checking I nstall for  Package O R*3.0*453
  392   Will first  run the E nvironment  Check Rou tine, OR3P 453
  393   ****** Cre ation of N ew Style ' EPRACDT' C ross Refer ence ***** *
  394   This will  loop throu gh the ORD ER ACTIONS  Multiple  of the ent ire ORDER
  395   File (#100 ) and crea te the 'EP RACDT' New  Style Cro ss Referen ce based
  396   on the PRO VIDER & DA TE/TIME OR DERED sub- fields.
  397   WARNING: O nce you ag ree to cre ate this,  you should  let it ru n until
  398   it has fin ished comp letely !!
  399   You are ab out to cre ate the in dex which  could take  quite awh ile.
  400   Are you su re you wan t to do th is? NO// Y ES
  401   Ok, let's  continue!
  402   Install Qu estions fo r OR*3.0*4 53
  403   Incoming F iles:
  404      100        ORDER   (Partial D efinition)
  405   Note:  You  already h ave the 'O RDER' File .
  406   Want KIDS  to Rebuild  Menu Tree s Upon Com pletion of  Install?  NO// 
  407   Want KIDS  to INHIBIT  LOGONs du ring the i nstall? NO // 
  408   Want to DI SABLE Sche duled Opti ons, Menu  Options, a nd Protoco ls? NO// 
  409   Enter the  Device you  want to p rint the I nstall mes sages.
  410   You can qu eue the in stall by e nter a 'Q'  at the de vice promp t.
  411   Enter a '^ ' to abort  the insta ll.
  412   DEVICE: HO ME//   SEC URE SHELL
  413                                         OR*3. 0*453                                      
  414          
  415        ORD21 8
  416        ORD22
  417        ORD23
  418        ORD24
  419        ORD25
  420        ORD26
  421        ORD27
  422        ORD28
  423        ORD29
  424    Updating  KIDS files ...
  425    OR*3.0*45 3 Installe d. 
  426                   Aug 1 0, 2018@09 :57:20
  427    Not a pro duction UC I
  428    NO Instal l Message  sent 
  429         
  430                    
  431     100%                   25              5 0              75                 
  432   Complete         
  433   Install Co mpleted
  434   Start:     08/10/2018  09:57:01
  435   Finish:    08/10/2018  09:57:20
  436   Elapsed:   00:00:19
  437      1       Load a Dis tribution
  438      2       Verify Che cksums in  Transport  Global
  439      3       Print Tran sport Glob al
  440      4       Compare Tr ansport Gl obal to Cu rrent Syst em
  441      5       Backup a T ransport G lobal
  442      6       Install Pa ckage(s)
  443              Restart In stall of P ackage(s)
  444              Unload a D istributio n
  445   Select Ins tallation  <TEST ACCO UNT> Optio n: 
  446              Edits and  Distributi on ...
  447              Utilities  ...
  448              Installati on ...
  449              Patch Moni tor Main M enu ...
  450   Select Ker nel Instal lation & D istributio n System < TEST ACCOU NT> Option : UTilitie s
  451              Build File  Print
  452              Install Fi le Print
  453              Edit Insta ll Status
  454              Convert Lo aded Packa ge for Red istributio n
  455              Display Pa tches for  a Package
  456              Purge Buil d or Insta ll Files
  457              Rollup Pat ches into  a Build
  458              Update Rou tine File
  459              Verify a B uild
  460              Verify Pac kage Integ rity
  461   Select Uti lities <TE ST ACCOUNT > Option:  INstall Fi le Print
  462   Select INS TALL NAME:     OR*3.0 *453    8/ 10/18@09:5 7:20
  463        => OR *3*453 TES T v7
  464   DEVICE: HO ME//   SEC URE SHELL
  465                                                    COMPL ETED            ELAPS ED
  466   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -
  467   STATUS: In stall Comp leted                   DATE LOA DED: AUG 1 0, 2018@09 :55:46
  468   INSTALLED  BY: DAVIS, ROBERT
  469   NATIONAL P ACKAGE: OR DER ENTRY/ RESULTS RE PORTING
  470   INSTALL ST ARTED: AUG  10, 2018@ 09:57:19        09:57 :20              0:00 :01
  471   ROUTINES:                                        09:57 :19             
  472   FILES:
  473   ORDER                                            09:57 :20              0:00 :01
  474   SECURITY K EY                                    09:57 :20             
  475   REMOTE PRO CEDURE                                09:57 :20             
  476   OPTION                                           09:57 :20             
  477   POST-INIT  CHECK POIN TS:
  478   XPD POSTIN STALL STAR TED                        09:57 :20             
  479   PACKAGE: O R*3.0*453      Aug 10 , 2018 9:5 7 am                             PAGE 2
  480                                                    COMPL ETED            ELAPS ED
  481   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -
  482   XPD POSTIN STALL COMP LETED                      09:57 :20             
  483   INSTALL QU ESTION PRO MPT                                                    ANSWER
  484   XPO1   Wan t KIDS to  Rebuild Me nu Trees U pon Comple tion of In stall      NO
  485   XPI1   Wan t KIDS to  INHIBIT LO GONs durin g the inst all                   NO
  486   XPZ1   Wan t to DISAB LE Schedul ed Options , Menu Opt ions, and  Protocols  NO
  487   MESSAGES:
  488    Install S tarted for  OR*3.0*45 3 : 
  489                   Aug 1 0, 2018@09 :57:19
  490   Build Dist ribution D ate: Aug 1 0, 2018
  491    Installin g Routines :
  492                   Aug 1 0, 2018@09 :57:19
  493   PACKAGE: O R*3.0*453      Aug 10 , 2018 9:5 7 am                        PAGE  3
  494                                                    COMPL ETED            ELAPS ED
  495   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -
  496    Installin g Data Dic tionaries:  
  497                   Aug 1 0, 2018@09 :57:20
  498    Installin g PACKAGE  COMPONENTS
  499    
  500    Installin g SECURITY  KEY
  501    Installin g REMOTE P ROCEDURE
  502    Installin g OPTION
  503                   Aug 1 0, 2018@09 :57:20
  504    Running P ost-Instal l Routine:  POST^OR3P 453
  505   This patch  will crea te a new N ew Style c ross refer ence
  506   called 'EP RACDT' whi ch will be  at the OR DER file l evel
  507   Type <Ente r> to cont inue or '^ ' to exit:  
  508   PACKAGE: O R*3.0*453      Aug 10 , 2018 9:5 7 am                             PAGE 4
  509                                                    COMPL ETED            ELAPS ED
  510   ---------- ---------- ---------- ---------- ---------- ---------- ---------- -
  511   but on PRO VIDER & DA TE/TIME OR DERED sub- fields of  the
  512   ORDER ACTI ONS Multip le.
  513   Creation o f 'EPRACDT ' will now  go forwar d in the
  514   Background .
  515   You will b e given a  TaskMan ta sk # to ch eck on or,
  516   alternatel y, you can  check you r mail on  MailMan fo r a
  517   message ex pressing C ompletion  of this Ta sk with
  518   appropriat e details.
  519   Note Insta ll of this  Patch can not be con sidered
  520   Complete u nless and  until this  Task is C ompleted.
  521   Note also  that the S tatus of t he 'EPRACD T' Creatio n
  522   can be che cked by re questing I T to run ' D CHECK^OR 3P453'
  523   Type <Ente r> to cont inue or '^ ' to exit:  
  524   PACKAGE: O R*3.0*453      Aug 10 , 2018 9:5 7 am                             PAGE 5
  525                                                    COMPL ETED            ELAPS ED
  526   ---------- ---------- ---------- ---------- ---------- ---------- ---------- ---------
  527   at the Com mand Promp t.
  528   Task #2086 121 queued  to start  Aug 10, 20 18@09:57:2 0
  529    Updating  Routine fi le...
  530    The follo wing Routi nes were c reated dur ing this i nstall:
  531        ORD2
  532        ORD21
  533        ORD21 0
  534        ORD21 1
  535        ORD21 2
  536        ORD21 3
  537        ORD21 4
  538        ORD21 5
  539        ORD21 6
  540   Type <Ente r> to cont inue or '^ ' to exit:  
  541   PACKAGE: O R*3.0*453      Aug 10 , 2018 9:5 7 am                             PAGE 6
  542                                                    COMPL ETED            ELAPS ED
  543   ---------- ---------- ---------- ---------- ---------- ---------- ---------- ---------
  544        ORD21 7
  545        ORD21 8
  546        ORD22
  547        ORD23
  548        ORD24
  549        ORD25
  550        ORD26
  551        ORD27
  552        ORD28
  553        ORD29
  554    Updating  KIDS files ...
  555    OR*3.0*45 3 Installe d. 
  556                   Aug 1 0, 2018@09 :57:20
  557   Type <Ente r> to cont inue or '^ ' to exit:  
  558   PACKAGE: O R*3.0*453      Aug 10 , 2018 9:5 7 am                             PAGE 7
  559                                                    COMPL ETED            ELAPS ED
  560   ---------- ---------- ---------- ---------- ---------- ---------- ---------- ---------
  561   Not a prod uction UCI
  562    NO Instal l Message  sent 
  563              Build File  Print
  564              Install Fi le Print
  565              Edit Insta ll Status
  566              Convert Lo aded Packa ge for Red istributio n
  567              Display Pa tches for  a Package
  568              Purge Buil d or Insta ll Files
  569              Rollup Pat ches into  a Build
  570              Update Rou tine File
  571              Verify a B uild
  572              Verify Pac kage Integ rity
  573   Select Uti lities <TE ST ACCOUNT > Option: 
  574              Edits and  Distributi on ...
  575              Utilities  ...
  576              Installati on ...
  577              Patch Moni tor Main M enu ...
  578   Select Ker nel Instal lation & D istributio n System < TEST ACCOU NT> Option
  579   Do you rea lly want t o halt? YE S// 
  580   Logged out  at Aug 10 , 2018 9:5 7 am
  581   TEST593>D  ^XTER
  582   In respons e to the D ATE prompt  you can e nter:
  583        'S' t o specify  text to be  matched i n error or  routine n ame
  584   TEST593>D  CHECK^OR3P 453
  585   Task to Cr eate 'EPRA CDT' Begun  Aug 10, 2 018@09:57: 20.
  586   ...Current ly, 15% of  Records h ave been P rocessed.
  587   TEST593>D  CHECK^OR3P 453
  588   Task to Cr eate 'EPRA CDT' Begun  Aug 10, 2 018@09:57: 20.
  589   ...Current ly, 16% of  Records h ave been P rocessed.
  590   TEST593>D  CHECK^OR3P 453
  591   Task to Cr eate 'EPRA CDT' Begun  Aug 10, 2 018@09:57: 20.
  592   ...Current ly, 20% of  Records h ave been P rocessed.
  593   Select OPT ION NAME:  EVE
  594        1   E VE       S ystems Man ager Menu      menu
  595        2   E VE + VPE        EVE M enu Plus V PE Options      menu
  596        3   E VENT CAPTU RE  ECX EC S MAINTENA NCE     Ev ent Captur e     menu
  597        4   E VENT CAPTU RE (ECS) E XTRACT AU   ECX ECS S OURCE AUDI T     Even t Capture 
  598   (ECS) Extr act Audit      run ro utine
  599        5   E VENT CAPTU RE DATA EN TRY  ECENT ER     Eve nt Capture  Data Entr y     menu
  600   Press <Ent er> to see  more, '^'  to exit t his list,   OR
  601   CHOOSE 1-5 : 1  EVE      Systems  Manager M enu     me nu
  602              Core Appli cations .. .
  603              Device Man agement .. .
  604      FM      VA FileMan  ...
  605              Manage Mai lman ...
  606              Menu Manag ement ...
  607              Programmer  Options . ..
  608              Operations  Managemen t ...
  609              Spool Mana gement ...
  610              Informatio n Security  Officer M enu ...
  611              Taskman Ma nagement . ..
  612              User Manag ement ...
  613      HL7     HL7 Main M enu ...
  614              Applicatio n Utilitie s ...
  615              Capacity P lanning .. .
  616   Select Sys tems Manag er Menu <T EST ACCOUN T> Option:  TBOX  Use r's Toolbo x
  617              Change my  Division
  618              Display Us er Charact eristics
  619              Edit User  Characteri stics
  620              Electronic  Signature  code Edit
  621              Menu Templ ates ...
  622              Spooler Me nu ...
  623              Switch UCI
  624              TaskMan Us er
  625              User Help
  626   Select Use r's Toolbo x <TEST AC COUNT> Opt ion: TASKM an User
  627   Select TAS K: 2086121   Creation  of New St yle X-Ref  'EPRACDT'  in ORDER f ile
  628                   Taskm an User Op tion
  629                         Display st atus.
  630                         Stop task.
  631                         Edit task.
  632                         Print task .
  633                         List own t asks.
  634                         Select ano ther task.
  635                   Selec t Action ( Task # 208 6121): STO P  Stop ta sk.
  636   This task  has alread y started  running, b ut it has  been asked  to stop.
  637                   Taskm an User Op tion
  638                         Display st atus.
  639                         Stop task.
  640                         Edit task.
  641                         Print task .
  642                         List own t asks.
  643                         Select ano ther task.
  644                   Selec t Action ( Task # 208 6121): DIS   Display  status.
  645   2086121: S ETXREF^OR3 P453, Crea tion of Ne w Style X- Ref 'EPRAC DT' in ORD ER file.
  646            N o device.   DEVCUR,DE VCUR.  Fro m Today at  9:57,  By  you.
  647            C ompleted T oday at 9: 59.  Job M sg: Receiv ed shutdow n request
  648                   Taskm an User Op tion
  649                         Display st atus.
  650                         Stop task.
  651                         Edit task.
  652                         Print task .
  653                         List own t asks.
  654                         Select ano ther task.
  655                   Selec t Action ( Task # 208 6121): ^
  656              Change my  Division
  657              Display Us er Charact eristics
  658              Edit User  Characteri stics
  659              Electronic  Signature  code Edit
  660              Menu Templ ates ...
  661              Spooler Me nu ...
  662              Switch UCI
  663              TaskMan Us er
  664              User Help
  665   Select Use r's Toolbo x <TEST AC COUNT> Opt ion: 
  666              Core Appli cations .. .
  667              Device Man agement .. .
  668      FM      VA FileMan  ...
  669              Manage Mai lman ...
  670              Menu Manag ement ...
  671              Programmer  Options . ..
  672              Operations  Managemen t ...
  673              Spool Mana gement ...
  674              Informatio n Security  Officer M enu ...
  675              Taskman Ma nagement . ..
  676              User Manag ement ...
  677      HL7     HL7 Main M enu ...
  678              Applicatio n Utilitie s ...
  679              Capacity P lanning .. .
  680   Select Sys tems Manag er Menu <T EST ACCOUN T> Option:  
  681   Do you rea lly want t o halt? YE S// 
  682   Logged out  at Aug 10 , 2018 9:5 9 am
  683   TEST593>D  CHECK^OR3P 453
  684   Task to Cr eate 'EPRA CDT' Begun  Aug 10, 2 018@09:57: 20.
  685   ...and Sto pped Aug 1 0, 2018@09 :59:01.
  686   ...Current ly, 30% of  Records h ave been P rocessed.
  687   TEST593>D  POST^OR3P4 53
  688   This patch  will crea te a new N ew Style c ross refer ence
  689   called 'EP RACDT' whi ch will be  at the OR DER file l evel
  690   but on PRO VIDER & DA TE/TIME OR DERED sub- fields of  the
  691   ORDER ACTI ONS Multip le.
  692   Creation o f 'EPRACDT ' will now  go forwar d in the
  693   Background .
  694   You will b e given a  TaskMan ta sk # to ch eck on or,
  695   alternatel y, you can  check you r mail on  MailMan fo r a
  696   message ex pressing C ompletion  of this Ta sk with
  697   appropriat e details.
  698   Note Insta ll of this  Patch can not be con sidered
  699   Complete u nless and  until this  Task is C ompleted.
  700   Note also  that the S tatus of t he 'EPRACD T' Creatio n
  701   can be che cked by re questing I T to run ' D CHECK^OR 3P453'
  702   at the Com mand Promp t.
  703   Task to Cr eate 'EPRA CDT' Alrea dy Begun A ug 10, 201 8@09:57:20 .
  704   ...and Sto pped Aug 1 0, 2018@09 :59:01.
  705   ...Resumin g 'EPRACDT ' Creation .
  706   Task #2086 125 queued  to start  Aug 10, 20 18@09:59:3 2   new t ask # to r esume
  707   TEST593>D  CHECK^OR3P 453
  708   Task to Cr eate 'EPRA CDT' Begun  Aug 10, 2 018@09:57: 20.
  709   ...Current ly, 43% of  Records h ave been P rocessed.
  710   TEST593>D  CHECK^OR3P 453
  711   Task to Cr eate 'EPRA CDT' Begun  Aug 10, 2 018@09:57: 20.
  712   ...Current ly, 45% of  Records h ave been P rocessed.
  713   TEST593>D  CHECK^OR3P 453
  714   Task to Cr eate 'EPRA CDT' Begun  Aug 10, 2 018@09:57: 20.
  715   ...Current ly, 48% of  Records h ave been P rocessed.
  716   TEST593>D  CHECK^OR3P 453
  717   Task to Cr eate 'EPRA CDT' Begun  Aug 10, 2 018@09:57: 20.
  718   ...Current ly, 70% of  Records h ave been P rocessed.
  719   TEST593>D  CHECK^OR3P 453
  720   Task to Cr eate 'EPRA CDT' Begun  Aug 10, 2 018@09:57: 20.
  721   ...Current ly, 75% of  Records h ave been P rocessed.
  722   TEST593>D  CHECK^OR3P 453
  723   Task to Cr eate 'EPRA CDT' Begun  Aug 10, 2 018@09:57: 20.
  724   ...Current ly, 90% of  Records h ave been P rocessed.
  725   TEST593>D  CHECK^OR3P 453
  726   Task to Cr eate 'EPRA CDT' Begun  Aug 10, 2 018@09:57: 20.
  727   ...and Com pleted Aug  10, 2018@ 10:04:47.
  728   TEST593>D  ^XM
  729   VA MailMan  8.0 servi ce for  D NS
. URL
  730   You last u sed MailMa n: 08/10/1 8@09:56
  731   You have 1  new messa ge.
  732   Select Mai lMan Optio n: READ/MA NAGE MESSA GES  
  733   Select mes sage reade r: Classic // Summary  Full Scre en
  734   Read mail  in basket:  IN//         (4 mess ages, 1 ne w)
  735   IN Basket,  4 message s (1-4), 1  new
  736   *=New/!=Pr iority.... ...Subject .......... .......... ....From.. .......... .........
  737     1. ZZZRB D*1.0*1 W  ENALL TAG  TO DIK RTN  IN POST I NST <INSTA LLER,ONE@C PRSEP1.F
  738     2. OR*3* 453 TEST v 7                                    <"NPM    [#900650 89]"@FORU
  739     3. Backu p of OR*3. 0*453 inst all on Aug  10, 2018      INSTAL LER,ONE
  740   *4. OR*3.0 *453 post  install ha s run to c ompletion.    PATCH O R*3.0*453
  741   Enter mess age number  or comman d: 4
  742   Subj: OR*3 .0*453 pos t install  has run to  completio n.  [#4741 00] 08/10/ 18@10:04
  743   5 lines
  744   From: PATC H OR*3.0*4 53  In 'IN ' basket.    Page 1   *New*
  745   ---------- ---------- ---------- ---------- ---------- ---------- ---------- ---------
  746   Creation o f 'EPRACDT ' X-Ref fo r ORDER fi le Started  Aug 10, 2 018@09:57: 20.
  747   Creation o f 'EPRACDT ' X-Ref Co mpleted.
  748   Background  Task Fini shed Aug 1 0, 2018@10 :04:47.
  749   Enter mess age action  (in IN ba sket): Ign ore// 
  750   Assign the  OR PRT Ac cess Secur ity Key to  Those Ide ntified as  Provider  Role Tool  GUI Users
  751   Appropriat e personne l must giv e the OR P RT ACCESS  key to tho se who wil l use the  Provider R ole Tool G UI. Your s ite should  have dete rmined whi ch users w ill be rea ssigning o rders.
  752   Assign a C PRS Tools  Menu Item  to Those I dentified  as Provide r Role Too l GUI User s
  753   In section  3.1.1 Ide ntificatio n of Provi der Role T ool GUI Us ers, sites  were dire cted to id entify whi ch users w ould be gi ven the ne cessary ac cess to pe rform the  order reas signment.  If this ha s not be c ompleted,  this must  be done im mediately  before pro ceeding wi th this st ep.
  754   For the ap propriate  users to r eassign or ders, they  must be g iven the s ecurity ke y and the  necessary  menu item.  The users  should ha ve already  been assi gned the s ecurity ke y. If that  assignmen t has not  occurred,  please ass ign the ke y. 
  755   To place t he item on  the Tools  menu, sit es would u se the fol lowing ste ps:
  756   Within Vis tA, from o ff the Vis tA menu, s elect the  GENERAL PA RAMETER TO OLS menu.
  757   Type EP to  select th e Edit Par ameter Val ues Option . And pres s <Enter>.
  758   Type ORWT  TOOLS MENU  and press  <Enter>.
  759   When the s ystem asks  for PARAM ETER DEFIN ITION NAME , followed  by choosi ng what pe rsonnel sh ould have  access. 
  760   At this pr ompt, the  IT personn el enters  something  similar to  the follo wing: 
  761   Provider R ole Tool=C :\progra~2 \VISTA\Pro vider Role  Tool\Prov iderRoleTo ol.exe S=% SRV P=%POR T
  762   This is on ly an exam ple to ill ustrate th e format o f the entr y and assu mes that t he new exe cutable is  being ins talled int o the user ’s local d irectory a s follows:
  763   C:\Program  Files (x8 6)\VISTA\P rovider Ro le Tool
  764   After the  key has be en assigne d and the  item has b een placed  on the us er’s Tools  menu, ens ure that C PRS launch es correct ly and sho ws the new  Provider  Role Chang e option a vailable o ff the CPR S Tools me nu. The ne w Provider  Role Tool  GUI shoul d launch a nd enable  the user t o reassign  the patie nt orders  of an Orde ring Provi der who is  changing  roles (e.g ., being t ransferred  from VA t o DoD) to  one or mor e VA Provi ders. Thro ugh the Pr ovider Rol e Tool GUI , the user  can eithe r accept t he default  of one ye ar in the  past or ca n set the  date/time  so that fr om that po int forwar d that Pro vider or t hose Provi ders will  receive al erts/notif ications f or the ord ers.
  765   This new P rovider Ro le Tool op tion shoul d not laun ch within  CPRS if th is patch h as not yet  been inst alled.
  766   Installati on Verific ation Proc edure
  767   [VISTA] Th e installe r can veri fy install ation by l ooking at  Install Fi le Print f or OR*3*45 3 to check  on the st atus of th e post-ins tall routi ne (ensuri ng it has  run to com pletion),  as well as  ensuring  that the i nstaller r eceived a  MailMan me ssage that  the EPRAC DT cross r eference c reation co mpleted.
  768   [GUI] Laun ch the Pro vider Role  Tool GUI  and verify  the splas h screen n ow announc es that ve rsion 1.0. 45.12 is r unning. Lo g into the  desired s erver and  verify tha t a versio n mismatch  is not re ceived.
  769   System Con figuration
  770   N/A
  771   Back-Out P rocedure
  772   In the eve nt of a ma jor issue  with the p atch, the  Facility A rea Manage r may make  the decis ion to bac k-out the  patch. How ever, this  decision  should inc lude both  Health Pro duct Suppo rt and the  CPRS deve lopment te am.
  773   Back-Out S trategy
  774   To remove  the Provid er Role Ch ange featu res, the s ite must r emove the  patch and  the way to  access it . Step-by- step instr uctions ar e given in  Section 6 .6 Back-Ou t Procedur e
       
  775   Back-Out C onsiderati ons
  776   Load Testi ng
  777   No load te sting was  performed  on Provide r Role Too l v1.0.453 .12
  778   User Accep tance Test ing
  779   User accep tance test ing was co nducted by  the test  sites list ed in sect ion 3.2.2.  
  780   The sites  followed t he provide d test pla n and exec uted the t est cases  according  to the pla n for the  build of O R*3.0*453.  The sites  either pa ssed or fa iled any i tem based  on testing . The test s were per formed by  users at e ach site w ho are fam iliar with  using the  applicati on. The te st cases w ere then d elivered t o the CPRS  Developme nt team. A ny items t hat failed  were re-d eveloped a nd then se nt back to  the sites  for the n ext build  and furthe r acceptan ce testing  following  the same  process. O nce in pro duction, t he same fi nal test c ases from  the last b uild were  tested in  production . No subse quent buil ds were cr eated as t he test ca ses passed  and sites  signed of f on concu rrence for  release o f the prod uct. 
  781   Back-Out C riteria
  782   Back-out w ould only  be conside red if the re was a c atastrophi c failure  that cause s loss of  function f or the app lication a nd/or a si gnificant  patient sa fety issue .
  783   Back-Out R isks
  784   Backing ou t the patc hes would  prevent th e site’s a bility to  reassign t he orders  to differe nt provide rs, which  was a pati ent safety  issue.
  785   In additio n, there i s a risk t hat the pr ocess, whi ch would b e performe d only in  an emergen t situatio n, would s ignificant ly impact  patient ca re due to  the interr uption.
  786   Authority  for Back-O ut
  787   The Facili ty Area Ma nager has  the ultima te respons ibility fo r the deci sion to ba ck out the  Provider  Role Chang e patch an d the asso ciated GUI . The CPRS  Developme nt team an d Health P roduct Sup port Clini cal person nel should  be consul ted before  backing o ut the pat ches.
  788   Back-Out P rocedure
       
  789   These step s assume t hat the on ly reason  to conside r a back-o ut for Pro vider Role  Tool v1.0 .453.12 is  in the ev ent of a c atastrophi c failure.  
  790   Contact th e CPRS Dev elopment t eam to not ify them t here has b een a cata strophic f ailure wit h Provider  Role Tool  1.0.453.1 2. Use the  following  contacts:
  791    Table 4:  CPRS Devel opment Tea m Contacts
  792   Name & Tit leEmailTel ephone Num berShawn S uiters
  793   VA Project  Manager PIIPII Martha Eve rt
  794   Project Ma nager PIIPII Jamie Crum ley
  795   M Develope r PIIPII Chris Bell
  796   Delphi Dev eloper PIIPII If the dec ision is m ade to pro ceed with  back-out a nd rollbac k, the CPR S Developm ent team w ill be ava ilable to  assist sit es that ha ve misplac ed their b ackup Pack Man messag e, and pro vide the i nstruction s on downl oading the  executabl e.
  797   [VistA]
  798   Remove any  records w ithin ORWT  TOOLS MEN U which ha ve Provide rRoleTool. exe associ ated there with.
  799   Remove the  OR PU GUI  VistA opt ion associ ated with  this patch .
  800   Remove the  SECURITY  KEY called  OR PU ACC ESS, which  should el iminate an y pointers  to it wit hin the NE W PERSON f ile.
  801   Remove all  RPCs asso ciated wit h this pat ch, namely , ORQ3 AUT HUSR, ORQ3  CHKPATCH,  ORQ3 EN,  & ORQ3 XFE R.
  802   Return the  state of  edited rou tines asso ciated wit h this pat ch to the  state they  were in p rior to th e install  of OR*3*45 3 by resto ring the r outines fr om the Mai lMan messa ge saved i n 2a of th e Installa tion Instr uctions. D elete OR3P 453 & ORQ3  routines  that are i ntroduced  by this pa tch.
  803   Utilize Fi leMan Util ities to D elete the  two New St yle Cross- References  (indices)  associate d with thi s patch, n amely "EPR ACDT" & "E PRTRDT".
  804   Using File Man again,  remove th e ORDER TR ANSFERS mu ltiple Dat a Dictiona ry definit ion which  should all ow any ORD ER TRANSFE RS multipl e data for  reassignm ents to be  removed a lso. Note,  before yo u remove t his multip le, you sh ould obtai n a list o f Order #' s where th e Order ha s been Tra nsferred.
  805   Using the  list of Or der #'s fr om Step 7  above, any  Providers  who may h ave receiv ed Alerts/ Notificati ons for a  Provider t hat transf erred may  wish to di spatch tho se alerts  somehow. 
  806   Back-out V erificatio n Procedur e
  807   Once steps  have been  completed  in Sectio n 6.6 abov e, verify  that the P rovider Ro le Tool GU I can no l onger be l aunched fr om the CPR S Tools me nu for the  affected  users. 
  808   Rollback P rocedure
  809   Rollback C onsiderati ons
  810   N/A
  811   Rollback C riteria
  812   N/A
  813   Rollback R isks
  814   N/A
  815   Authority  for Rollba ck
  816   The Facili ty CIO has  the final  authority  to requir e the roll back and a ccept the  associated  risks.
  817   Rollback P rocedure
  818   Back-out w ill automa tically ro llback ver sion. 
  819   Rollback V erificatio n Procedur e
  820   N/A
  821