$TXT Created by W at PREMV.FO-BIRM.DOMAIN.EXT (KIDS) on Wednesday, 12/02/20 at 08:45 ============================================================================= Run Date: DEC 14, 2020 Designation: PSO*7*581 Package : PSO - OUTPATIENT PHARMACY Priority: Mandatory Version : 7 SEQ #512 Status: Released Compliance Date: JAN 14, 2021 ============================================================================= Associated patches: (v)PSO*7*457 <<= must be installed BEFORE `PSO*7*581' (v)PSO*7*508 <<= must be installed BEFORE `PSO*7*581' (v)PSO*7*527 <<= must be installed BEFORE `PSO*7*581' (v)PSO*7*551 <<= must be installed BEFORE `PSO*7*581' (v)PSO*7*565 <<= must be installed BEFORE `PSO*7*581' (v)PSO*7*567 <<= must be installed BEFORE `PSO*7*581' (v)PSO*7*582 <<= must be installed BEFORE `PSO*7*581' (v)PSO*7*591 <<= must be installed BEFORE `PSO*7*581' (v)PSO*7*598 <<= must be installed BEFORE `PSO*7*581' (v)PSO*7*606 <<= must be installed BEFORE `PSO*7*581' Subject: ERX 2017071 SCRIPT UPDATES Category: - Data Dictionary - Routine Description: ============ *** Prior to installation, please contact Inbound eRx implementation group, InboundeRx@domain.ext, to finalize coordination of installation with Change Healthcare. *** Inbound Electronic Prescribing (eRx) v4 enhancements provides updates to eRx in order to support the new NCPDP (National Council for Prescription Drug Programs) 2017071 script standard. The inbound XML (Extended Markup Language) parser, Data Dictionaries and displays have all been modified to support the new 2017071 script standard. In addition, enhancements have been made that allow a user (pharmacist, pharmacy tech) to send a Rx Change Request message type to the external provider who originally sent the eRx to the VA. After an Rx Change Request has been sent to the external provider, the provider will be able to send an Rx Change Response. New functionality has been created to enable automatic and manual processing of Rx Change Response messages. The new message types will be stored along with the New Rx type and other message types in the ERX HOLDING QUEUE file (#52.49). Major changes to the data dictionary structures have occurred to facilitate the storing and management of the new data structures in the 2017071 NCPDP message structures. These changes allow the supporting routines to more efficiently parse incoming and build outbound XML structures related to NewRx, Renewal Request/Response, Change Request/Response, and Cancel messages. A new Remote Procedure Call (RPC) has been created to support the receipt of the new 2017071 messages. This new RPC separates the logical flow of messages, ensuring the old version 10.6 messages and the new 2017071 message are not sent through the same RPC. Additionally, new XML parsing and building routines have been created to support the updated message structures. A new hidden action 'EC' (eRx Change Request) has been created and attached to the 'eRx Hidden actions' [PSO ERX HIDDEN ACTIONS] menu protocol. This new action allows a user to generate a change request from an existing eRx in the holding queue. This change request is then sent through the eRx processing hub to the external provider who wrote the prescription. New status values have been added to the ERX SERVICE REASON CODES file (#52.45) in support of the new change request and change response messages. These status values, along with the MESSAGE TYPE field (#.08) in the ERX HOLDING QUEUE file (#52.49) will ensure the messages can be differentiated. List Manager screens have been enhanced to display details about the refill requests, refill responses, cancel requests, cancel responses, change requests, change responses, and error messages in support of the 2017071 script standard. These screens give detailed information about the currently selected message type (request/response) as well as information related to the other linked messages. For example if the selected message is a refill response, details related to the refill request are also displayed to the user. Additional message history information is available at the bottom of the list manager view. Patch Components: ----------------- Files & Fields Associated: -------------------------- See Technical Document Options Associated: Option Name Type New/Modified/Deleted ----------- ---- -------------------- PSO WEB SERVICES OPTION Broker (Client/Server) Modified Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- PSO ERX CHANGE REQUEST New PSO ERX HIDDEN ACTIONS Modified PSO ERX REFILL REQUEST Deleted PSO ERX RX RENEWAL New REQUEST PSO ERX SINGLE REFILL Deleted REQUEST PSO ERX SINGLE RXRENEWAL New REQUEST PSO LM HIDDEN OTHER Modified PSO LM HIDDEN OTHER #2 Modified Remote Procedures: New/Modified/Deleted ------------------ --------------------- PSOERXI1 INCERX New Security Keys Associated: Security Key Name ----------------- N/A Templates Associated: --------------------- PSO ERX DRUG VALIDATION PSO ERX HQ DISPLAY PSO ERX PATIENT VALIDATION PSO ERX PROVIDER VALIDATION Test Sites: ---------- VA Honolulu Regional Office Fayetteville VAMC Veterans Health Care System of the Ozarks Health Administration Center (Meds by Mail) Indianapolis, IN VA Medical Center Software and Documentation Retrieval Instructions: ---------------------------------------------------- Patch PSO*7*581 is being released as a FORUM Patch message, which will be sent to the G.PATCHES mail group. This patch also has a supporting .GBL data file. The supporting data file is available at the following location: /srv/vista/patches/SOFTWARE/PSO_7_581.GBL File Name Contents FTP Mode ----------------- ---------- --------- PSO_7_581.GBL PSO*7*581 GLOBAL ASCII Documentation describing the new functionality is included in this release. Documentation can be found on the VA Software Documentation Library at: https://www.domain.ext/vdl/ Documentation can also be obtained at https://download.vista.domain.ext/index.html/SOFTWARE. Documentation Title File Name -------------------------------------------------------------------------- Installation Guide - Inbound ePrescribing pso_7_0_p581_ig.pdf (PSO*7.0*581) pso_7_0_p581_ig.docx User Manual - Inbound ePrescribing pso_7_0_p581_um.pdf (PSO*7.0*581) pso_7_0_p581_um.docx Technical Manual/Security Guide - Outpatient pso_7_0_p581_tm.pdf Pharmacy V.7.0 pso_7_0_p581_tm.docx Release Notes - Inbound ePrescribing pso_7_0_p581_rn.pdf (PSO*7.0*581) pso_7_0_p581_rn.docx Implementation Guide - Inbound ePrescribing pso_7_0_p581_img.pdf (PSO*7.0*581) pso_7_0_p581_img.docx Patch Installation: Pre/Post Installation Overview: ------------------------------- *** Prior to installation, please contact Inbound eRx implementation group, InboundeRx@domain.ext, to finalize coordination of installation with Change Healthcare. *** A Pre-installation routine exists that will load new file entries for the ERX SERVICE REASON CODES file (#52.45). The number of codes are large enough that it will require the installer to use GIGEN^%ZSPECIAL to load a .GBL file which contains a temp global. There is additional action needed to configure the web service changes for complete installation of this patch. These changes are critical to ensure new functionality additions and seamless communication of Inbound eRx prescriptions to your medical center. INSTALLATION INSTRUCTIONS ========================= This patch may be installed with users on the system although it is recommended that it be installed during non-peak hours to minimize potential disruption to users. This patch should take less than 5 minutes to install. Option [PSO ERX FINISH] should be marked out of order during installation of PSO*7.0*581. 1) Users may be on the system during the install of PSO*7*581. It is recommended that this patch be installed during non-peak hours. This patch should take from 1 to 3 minutes to install depending on the system. Create a backup 1-2 minutes Load the Global 1-2 minute Kids Install 1-3 minutes 2) Size/Disk Space Requirements: The changes to the ERX service reason codes file will be less than 200 kilobytes. 3) Create a backup of the following global files before continuing: ERX SERVICE REASON CODES #52.45 ^PS(52.45 These backup files may get as large as 150 kilobytes. Make sure space is available before proceeding. It should take from 0 to 2 minutes to create the backup files. When you are creating a backup of a subscripted global, you are saving a partial global (a file within a global). You should use the utility GOGEN^%ZSPECIAL, and when prompted for a global, enter the open global reference as shown below. Examples: Enter To create a Backup copy of: ------ -------------------------- ^PS(52.45, ERX SERVICE REASON CODES 4) Install the data from the global host file PSO_7_581.GBL. This file contains the eRx service codes import global ^TMP("PSO581PO"). This global is approximately 150 kilobytes in size. Make sure there is sufficient space available to load this global on your system. The loading of the global should take less than one minute. From the Programmer prompt, execute the following routine: >D GIGEN^%ZSPECIAL Global input Device: /filepath/PSO_7_581.GBL Parameter: RS=> If you receive the following prompt, respond with 'Y'. Transfer entire set of files? No=> Y Input option: A ^TMP("PSO581PO") 5) Set up user and IO variables (D ^XUP) for programmer access. 6) Distribution Load: Load the KIDS Distribution from the Packman Message using the Packman function "Install/Check Message." 7) From the Kernel Installation and Distribution System Menu, select the Installation Menu. From this menu, you may elect to use the following options. When prompted for the INSTALL NAME enter: PSO*7.0*581 a. Backup a Transport Global - This option will create a backup build of patch components. Respond "BUILD" at the "Select one of the following: B Build or R Routines" prompt. **THIS IS CRITICAL TO ACCURATE PATCH BACKUP ON YOUR SYSTEM. ** b. Compare Transport Global to Current System - This option will allow you to view all changes that will be made when this patch is installed. It compares all components of this patch (routines, DDs, templates, etc.). c. Verify Checksums in Transport Global - This option will allow you to ensure the integrity of the routines that are in the transport global. 8) KIDS Installation: Install the patch using the KIDS Installation Menu action "Install Package(s)" and the install name PSO*7.0*581. Respond "NO" at the "Want KIDS to INHIBIT LOGONs during the install?" prompt. Respond "YES" at the "Want to DISABLE Scheduled Options, Menu Options, and Protocols?" prompt. Choose option [PSO ERX FINISH] The KIDs install should take less than 1 minute. 9) Cleanup a) The Post-Install routine PSO581PO should be deleted using the KERNEL option 'Delete Routines' [XTRDEL] upon completion of the installation. NOTE: The installation of this patch should trigger an update protocol and may spawn background tasks for the Clinical Reminders or Consult packages. You do not need to wait for these background jobs to complete to delete the Environment Check and Post-Install routines. 10) Back-out Plan: To back-out data from a production account could cause broken pointers, errors and hard MUMPS crashes. The back-out plan for data only patches is to report your findings and wait for a repair patch. Contact Help desk to log a ticket. 11) Patch Verification: Kernel Installation & Distribution System-> Utilities-> Install File Print option can be used to check for any errors plus the status of the install being Completed. Post-Installation Instructions: ------------------------------- There are additional steps to be completed in order to finalize installation of this patch. Please refer to Inbound ePrescribing (IEP) VistA PSO*7.0*581 / IEP Web-based GUI Version 4.0 Installation Guide found in the Documentation Retrieval Instructions or on the Outpatient Pharmacy VA Software Document Library (VDL) when site is ready to complete final setup. The VDL URL is https://www.domain.ext/vdl/application.asp?appid=90. Documentation can also be obtained at https://download.vista.domain.ext/index.html/SOFTWARE. Routine Information: ==================== The second line of each of these routines now looks like: ;;7.0;OUTPATIENT PHARMACY;**[Patch List]**;DEC 1997;Build 126 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSO581EN Before: n/a After: B538156 **581** Routine Name: PSO581PO Before: n/a After: B28129273 **581** Routine Name: PSOERX Before:B134630031 After:B135510353 **467,527,508,551,567,591,581** Routine Name: PSOERX1 Before: B99497004 After:B169020138 **467,520,527,508,551,581** Routine Name: PSOERX1A Before:B150463790 After:B175273948 **467,527,508,551,581** Routine Name: PSOERX1B Before:B185624398 After:B148682031 **467,506,520,527,508,551,591, 606,581** Routine Name: PSOERX1C Before: B64623473 After:B113785814 **467,520,527,508,551,581** Routine Name: PSOERX1D Before: n/a After:B217653722 **581** Routine Name: PSOERX1E Before: n/a After: B1908867 **581** Routine Name: PSOERXA1 Before:B188036698 After:B191218900 **467,520,508,551,581** Routine Name: PSOERXA5 Before: B65388361 After: B67783943 **508,581** Routine Name: PSOERXA6 Before: n/a After: B60070780 **581** Routine Name: PSOERXC1 Before:B106890934 After:B106435535 **508,551,567,581** Routine Name: PSOERXD1 Before:B131735326 After:B142880201 **467,520,551,582,581** Routine Name: PSOERXD2 Before:B183875290 After:B164315173 **467,506,520,508,551,581** Routine Name: PSOERXEN Before: B15625365 After: B16386315 **508,581** Routine Name: PSOERXH1 Before: B17222601 After: B36800437 **467,527,508,581** Routine Name: PSOERXI1 Before: n/a After:B156967276 **581** Routine Name: PSOERXIA Before: n/a After: B81005829 **581** Routine Name: PSOERXIB Before: n/a After: B57255225 **581** Routine Name: PSOERXIC Before: n/a After: B14137332 **581** Routine Name: PSOERXID Before: n/a After: B88864726 **581** Routine Name: PSOERXIE Before: n/a After:B158461983 **581** Routine Name: PSOERXIF Before: n/a After:B151624775 **581** Routine Name: PSOERXIG Before: n/a After:B148255571 **581** Routine Name: PSOERXIH Before: n/a After: B56027681 **581** Routine Name: PSOERXII Before: n/a After: B46614130 **581** Routine Name: PSOERXIU Before: n/a After: B15943170 **581** Routine Name: PSOERXO1 Before:B115835250 After:B177621724 **467,520,508,581** Routine Name: PSOERXOA Before: n/a After: B77421182 **581** Routine Name: PSOERXOB Before: n/a After: B66413086 **581** Routine Name: PSOERXOC Before: n/a After: B42735501 **581** Routine Name: PSOERXOD Before: n/a After: B54001451 **581** Routine Name: PSOERXOE Before: n/a After: B31609262 **581** Routine Name: PSOERXOF Before: n/a After: B18714201 **581** Routine Name: PSOERXOG Before: n/a After: B63703408 **581** Routine Name: PSOERXOH Before: n/a After: B16534499 **581** Routine Name: PSOERXOI Before: n/a After: B19896023 **581** Routine Name: PSOERXOJ Before: n/a After: B37952226 **581** Routine Name: PSOERXOK Before: n/a After: B55804980 **581** Routine Name: PSOERXOL Before: n/a After: B66259682 **581** Routine Name: PSOERXOM Before: n/a After:B121574740 **581** Routine Name: PSOERXON Before: n/a After:B116135344 **581** Routine Name: PSOERXOU Before: n/a After: B11448528 **581** Routine Name: PSOERXP1 Before: B28678984 After: B28700221 **467,520,527,551,581** Routine Name: PSOERXR1 Before: B33604868 After: B32193647 **467,520,527,581** Routine Name: PSOERXU1 Before:B153595246 After:B157028111 **467,520,508,551,565,581** Routine Name: PSOERXU2 Before: B56457252 After: B61412991 **508,598,581** Routine Name: PSOERXU3 Before:B169980946 After:B187651757 **508,591,606,581** Routine Name: PSOERXU4 Before: B68679574 After: B69312142 **520,508,551,581** Routine Name: PSOERXU5 Before: B64488961 After:B149296453 **508,581** Routine Name: PSOERXU6 Before:B117656460 After:B120358979 **508,551,581** Routine Name: PSOERXU7 Before: n/a After: B44585380 **581** Routine Name: PSOERXU8 Before: n/a After: B10018931 **581** Routine Name: PSOERXX1 Before:B155540262 After:B174429887 **467,520,527,508,581** Routine Name: PSOERXX2 Before:B185958519 After:B182775958 **467,508,581** Routine Name: PSOORNEW Before:B119452733 After:B124801369 **11,23,27,32,55,46,71,90,94, 106,131,133,143,237,222,258, 206,225,251,386,390,391,372, 416,431,313,408,436,411,444, 486,446,505,517,508,457,581** Routine list of preceding patches: 457, 565, 582, 598, 606 ============================================================================= User Information: Entered By : Date Entered : OCT 03, 2019 Completed By: Date Completed: DEC 10, 2020 Released By : Date Released : DEC 14, 2020 ============================================================================= Packman Mail Message: ===================== $END TXT