$TXT Created by ALVIN JR at DOSO.FO-BIRM.DOMAIN.EXT (KIDS) on Wednesday, 04/06/22 at 20:48 ============================================================================= Run Date: MAY 03, 2022 Designation: PSO*7*529 Package : PSO - OUTPATIENT PHARMACY Priority: Mandatory Version : 7 SEQ #553 Status: Released Compliance Date: JUN 03, 2022 ============================================================================= Associated patches: (v)PSO*7*630 <<= must be installed BEFORE `PSO*7*529' Subject: PHARMACY OPERATIONS - DEA# ENHANCEMENTS Category: - Routine - Other - Enhancement (Mandatory) Description: ============ ******************************* ATTENTION ****************************** THE INSTALLATION OF THIS PATCH MUST BE QUEUED ************************************************************************** ******************************* ATTENTION ****************************** XU*8.0*688 MUST BE INSTALLED PRIOR TO INSTALLING THIS PATCH ************************************************************************** The Pharmacy Operations Project (POP) DEA enhancements provides the ability to support multiple Drug Enforcement Administration (DEA) Numbers for a prescriber. This patch performs an initial 'migration' of provider DEA information to new data dictionaries introduced by XU*8*688 in preparation for future development. PSO*7*529 does not modify existing user functionality. This patch PSO*7*529 has the following enhancements: 1. Create a web service client to be used during installation to retrieve the provider information from the VA Maintained DOJ/DEA web server. This information will be stored in the DEA NUMBERS FILE (#8991.9), and linked to the NEW PERSON FILE (#200), NEW DEA #'S (#53.21) multiple. 2. An environment check routine automatically configures the PSO DOJ/DEA WEB SERVER with the production server information when installed in a production environment. If installed in a non-production environment, the installer is prompted to select the environment type, either PRE-PROD or SQA. If the web service is not available during patch installation, the Installation is aborted with the following message: ********************************************************* WARNING: The WEB SERVER/SERVICE SETUP FAILED Please try again after a few minutes. Failed to install, please submit a Service Now ticket. >>>> Installation aborted <<<<" ********************************************************* 3. A post-install routine included in this patch identifies all DEA numbers from the NEW PERSON FILE (#200) and utilizes the PSO DOJ/DEA WEB SERVICE to create entries in the DEA NUMBERS FILE (#8991.9), and migrate VistA providers to the new file by linking providers to their corresponding DEA NUMBERS FILE entry. Providers that cannot be linked will be recorded in a Migration Exception Log and will be sent in an email with the subject "DEA Migration Exception Report MM/DD/YYYY". The migration log is sent to PSDMGR key holders. These entries can be reviewed and corrected using the ePCS GUI (for VA providers), or the Edit Provider [PSO PROVIDER EDIT] option (for non-VA providers). These migrated provider entries in the DEA NUMBERS FILE (#8991.9) will be marked as USE FOR INPATIENT ORDERS. The Detox # will be derived from the business activity code/sub code. 4. A DEA Migration Report, available as a standalone DEA Migration Report [PSO DEA MIGRATION REPORT] option. Patch Components: ----------------- Files & Fields Associated: -------------------------- N/A Forms Associated: ----------------- N/A Mail Groups Associated: ----------------------- N/A Options Associated: ------------------- Option Name Type New/Modified/Deleted ----------- ---- -------------------- DEA Migration Report Routine New [PSO DEA MIGRATION REPORT] Protocols Associated: --------------------- N/A Remote Procedure Calls: N/A Security Keys Associated: ------------------------ N/A Templates Associated: --------------------- N/A Additional Information: ----------------------- New Service Requests (NSRs): ---------------------------- N/A Patient Safety Issues (PSIs): ----------------------------- N/A Remedy Ticket(s) & Overview: ---------------------------- N/A Test Sites: ---------- Coatesville, PA Heartland-West HCS Honolulu, HI Tennessee Valley HCS Documentation Retrieval Instructions: ------------------------------------- The software for this patch is being released in a PackMan message. 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. Title File Name --------------------------------------------------------------------- Patch PSO*7*529 Deployment, Installation PSO_7_P529_DIBRG.DOCX Backout, Rollback Guide PSO_7_P529_DIBRG.PDF Outpatient Pharmacy Version 7 Technical PSO_7_0_P529_TM.DOCX Manual Security Guide PSO_7_0_P529_TM.PDF Outpatient Pharmacy Version 7 Manager's PSO_7_0_P529_MAN_UM.DOCX User Manual PSO_7_0_P529_MAN_UM.PDF Patch Installation: Pre/Post Installation Overview: ------------------------------- The PSO DOJ/DEA WEB SERVICE remote server must be reachable to load And install this patch. When loading the patch, the patch's environment check routine determines whether the patch is being installed in a production or a non-production environment and configures the web server accordingly. Pre-Installation Instructions: ------------------------------ If the patch is being loaded in a production environment, the web service is automatically pointed to the production web server. If being installed in a non-production environment, the environment check routine will display the following options: Select one of the following: D PRE-PROD S SQA ENVIRONMENT TYPE: Installers should select the appropriate environment and accordingly The software will setup the correct web server. The environment check Then checks the availability of the PSO DOJ/DEA WEB SERVICE, and if The service is available the message "The Environmental Check Routine finished Successfully" is displayed and the patch installation process will continue. If the web service is not available then it will abort the installation with the following message: ********************************************************* WARNING: The WEB SERVER/SERVICE SETUP FAILED Please try again after a few minutes. Failed to install, please submit a Service Now ticket. >>>> Installation aborted <<<<" ********************************************************* Installation Instructions: -------------------------- The installation of this patch must be queued and may take up to 24 hours depending on the number of DEA numbers in the NEW PERSON file to be migrated. If installation is attempted WITHOUT queueing, the installation will be aborted, and the distribution must then be unloaded, reloaded, and reinstalled with queuing. It is recommended the patch is installed during non-peak hours. After the post-installation DEA migration is complete, the installer should confirm a post-install message entitled "DEA Migration Exception Report" is sent to all PSDMGR key holders and the patch installer. 1. Choose the PackMan message containing this build. Then select the INSTALL/CHECK MESSAGE PackMan option to load the build. 2. From the Kernel Installation and Distribution System Menu, select the Installation Menu. From this menu, A. Select the Verify Checksums in Transport Global option to confirm the integrity of the routines that are in the transport global. When prompted for the INSTALL NAME enter the patch name, PSO*7.0*529. B. Select the Backup a Transport Global option to create a backup message. You must use this option and specify what to backup; the entire Build or just Routines. The backup message can be used to restore the routines and components of the build to the pre-patch condition. i. At the Installation option menu, select Backup a Transport Global. ii. At the Select INSTALL NAME prompt, enter build PSO*7.0*529. iii. When prompted for the following, enter "R" for Routines or "B" for Build. Select one of the following: B Build R Routines Enter response: Build iv. When prompted "Do you wish to secure this message? NO//", press and take the default response of "NO". v. When prompted with, "Send mail to: Last name, First Name", press to take default recipient. Add any additional recipients. vi. When prompted with "Select basket to send to: IN//", press and take the default IN mailbox or select a different mailbox. C. You may also elect to use the following options: i. Print Transport Global - This option will allow you to view the components of the KIDS build. ii. 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 of the components of this patch, such as routines, DDs, templates, etc. D. Select the Install Package(s) option and choose the patch to install. i. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//', answer . ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer 'NO' iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', answer 'NO'. iv. When prompted 'Delay Install (Minutes): (0 - 60): 0//', answer 0. ******************************* ATTENTION ****************************** THE INSTALLATION OF THIS PATCH MUST BE QUEUED ----------------------------------------------- If installation is attempted WITHOUT queueing the installation will be aborted, and the distribution must then be unloaded, reloaded, and reinstalled with queuing. ************************************************************************** POST-Installation Instructions: ------------------------------- ********************************************************************* The DEA migration process performed by the post-install routine may Take up to 24 hours to complete. This time will vary depending on the number of entries in the NEW PERSON file containing DEA numbers. This process should have no effect on end users. ********************************************************************* Verify Routine Installation ---------------------------- Successful installation can be verified by reviewing the first 2 lines of the routines contained in the patch. The second line will contain the patch number in the [PATCH LIST] section. ;;7.0;OUTPATIENT PHARMACY;**[PATCH LIST]**;DEC 1997;[BUILD #] The option Calculate and Show Checksum Values [XTSUMBLD-CHECK] can be run to compare the routine checksums to what is documented in the patch description. Verify Web Server --------------------- The correct PSO DOJ/DEA WEB SERVER configuration may be verified by performing the following steps: 1) Access the Web Server Manager [XOBW WEB SERVER MANAGER] option. 2) From the list of services, find the PSO DOJ/DEA WEB SERVER from the Web Server Name column and make a note of the value in the ID column for this entry. 3) At the Select Action: prompt, enter EP for Expand Entry. 4) At the Select Web Server prompt, enter the ID from step 2. 5) Verify the following server details are displayed: a. SERVER: prod.deals.vaec.domain.ext (for production installs) b. LOGIN REQUIRED: YES c. SSL ENABLED: TRUE d. SSL CONFIGURATION: encrypt_only_tlsv12 e. SSL PORT:443 f. STATUS: ENABLED Back-out Procedures: -------------------- Back-out Procedures are only needed if there are major problems (examples include the KIDS notice of incompletion or hard errors) resulting from the installation of this patch. You must have concurrence from Health Product Support before a rollback can occur. Enter a ServiceNow ticket to obtain this concurrence. Prior to installing a patch, the site/region should have saved a backup of the routines in a mail message using the Backup a Transport Global [XPD BACKUP] menu option (this is done at time of install). The message containing the backed up routines can be loaded with the "Xtract PackMan" function at the Message Action prompt. The Packman function "INSTALL/CHECK MESSAGE" is then used to install the backed up routines onto the VistA System. Validation of Roll Back Procedure: --------------------------------- The Roll Back Procedure can be verified by printing the first 2 lines of the PSO Routines contained in this patch using the option First Line Routine Print [XU FIRST LINE PRINT]. Once the routines contained in the PSO*7.0*529 patch have been rolled back, the first two lines of the Routines will no longer contain the designation of patch PSO*7.0*529 in the patch list section on line 2. Routine Information: ==================== The second line of each of these routines now looks like: ;;7.0;OUTPATIENT PHARMACY;**[Patch List]**;DEC 1997;Build 94 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSO7E529 Before: n/a After: B34641534 **529** Routine Name: PSO7L529 Before: n/a After: B49721409 **529** Routine Name: PSO7M529 Before: n/a After: B4958709 **529** Routine Name: PSO7P529 Before: n/a After:B103022167 **529** Routine Name: PSODEAU0 Before: n/a After: B18851498 **529** Routine Name: PSODEAUT Before: n/a After:B201057220 **529** ============================================================================= User Information: Entered By : Date Entered : APR 24, 2018 Completed By: Date Completed: MAY 02, 2022 Released By : Date Released : MAY 03, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT