$TXT Created by at CPRS31.DOMAIN.EXT (KIDS) on Thursday, 08/11/22 at 14:34 ============================================================================= Run Date: DEC 14, 2022 Designation: PSO*7*679 Package : PSO - OUTPATIENT PHARMACY Priority: Mandatory Version : 7 SEQ #575 Status: Released Compliance Date: JAN 16, 2023 ============================================================================= Associated patches: (v)PSO*7*642 <<= must be installed BEFORE `PSO*7*679' Subject: ENHANCEMENTS TO PSO VCC REFILL RPC Category: - Enhancement (Mandatory) - Routine - Other Description: ============ ************************************************************************** * PLEASE READ BEFORE INSTALLING * *----------------------------------------------------------------------- * * The PSO*7*679 installation will run a post-install routine to review * * and update existing data. This installation can take 30 minutes * * to a few hours depending on the size of the database. * * * * Therefore, it is highly recommended that this install be QUEUED. * * * * Post-Install instructions provide an example of how to queue the * * installation. * * * * * ************************************************************************** The purpose of this patch is to provide enhancements to the Outpatient Pharmacy PSO VCC REFILL Remote Procedure Call (RPC). The enhancements will provide the ability in Outpatient Pharmacy to store the source of a refill request (e.g. Veteran Contact Center (VCC), Vista Scheduling Enhancements (VSE) Client), MY HEALTHEVET, Outpatient Pharmacy, etc.). Before the installation of PSO*7*679 is performed, the version of the PSO VCC REFILL remote procedure (RPC) will populate the source of the refill request at the REFILL SOURCE field (#94) in the REFILL multiple (#52.1) of the PRESCRIPTION file (#52) as "CONTACT CENTER"; and at the OTHER COMMENTS field (#.01) in the OTHER COMMENTS multiple (#52.34) of the PRESCRIPTION file (#52) as "VCC Auto Refill". The OTHER COMMENTS field is displayed in the Activity Log of the VIEW PRESCRIPTION and the PATIENT PRESCRIPTION PROCESSING options. Once PSO*7*679 is installed, the Activity Log will display the source system that initiated the refill. The enhancement delivers the following: 1. Modified the REFILL SOURCE field (#52.1, 94) of the PRESCRIPTION file (#52) from a SET OF CODES to a FREE TEXT data type. 2. Added a 4th input parameter to the PSO VCC REFILL remote procedure call (RPC). The input parameter, REFILL SOURCE, represents the system from which the REFILL request Originated (e.g., VistA Scheduling Enhancements, VCC, MY HEALTHEVET, OUTPATIENT PHARMACY, etc.). Disclaimer: currently Outpatient Pharmacy and CPRS do not use this functionality. 3. The PSO VCC REFILL RPC populates the REFILL SOURCE field (#52.1, 94) and the OTHER COMMENTS field (#52.34,.01) with the value from the 4th input parameter of the PSO VCC REFILL RPC. Since the 4th input parameter is optional, then if a value is not sent from the client, the text "UNKNOWN" will be stored in the REFILL SOURCE field and in the OTHER COMMENTS field. 4. Added a 5th input parameter to the PSO VCC REFILL RPC which represents a RETURN FLAG. Since this input parameter is optional, the RETURN FLAG will either 1 or null. If the value equals 1, then the RPC will return to the requesting system a numeric error code along with text describing the error. If a null value is sent for this parameter, only a numeric error code will be returned to the requesting system. Integration Agreement 7313 has been updated with the 4th and 5th input parameters. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- PRESCRIPTION (#52) REFILL SOURCE (#52.1,94) Modified Remote Procedure Calls New/Modified/Deleted ----------------------- -------------------- PSO VCC REFILL Modified Forms Associated: Form Name File Number New/Modified/Deleted --------- ----------- -------------------- N/A Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- N/A Options Associated: Option Name Type New/Modified/Deleted ----------- ---- -------------------- N/A Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- N/A Security Keys Associated: Security Key Name ----------------- N/A Templates Associated: Template Name Type File Name (Number) New/Modified/Deleted ------------- ---- ------------------ -------------------- N/A Remote Procedures Associated: Remote Procedure Name New/Modified/Deleted --------------------- -------------------- PSO VCC REFILL Modified Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- N/A Additional Information: ----------------------- Blood Bank Team Coordination: ----------------------------- N/A New Service Requests (NSRs): ---------------------------- N/A Patient Safety Issues (PSIs): ----------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- N/A Test Sites: ----------- Amarillo, TX (AMA) Tomah, WI (TOM) Software and 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. Documentation Title File Name --------------------------------------------------------------------- Outpatient Pharmacy (PSO) Version 7.0 PSO_7_0_P679_PHARM_UM.DOCX Pharmacist's User Manual PSO_7_0_P679_PHARM_UM.PDF Patch Installation: ------------------- Pre/Post Installation Overview: ------------------------------- The post-installation routine will convert set of codes data to their external representations of the REFILL SOURCE field (#94) in the REFILL multiple (#52.1) of the PRESCRIPTION file (#52) from SET OF CODES to FREE TEXT. Since the REFILL SOURCE field is not indexed, the procedure will need to ORDER through the entire file to find and change the data. Consequently, the post install could take more than an hour especially in large databases. It is recommended that the installation of PSO*7*679 be queued to install during non-peak hours to minimize potential disruption to users. Pre-Installation Instructions: ------------------------------ ****************************PLEASE READ*********************************** It is strongly recommended that this patch be queued due to the conversion of the REFILL SOURCE field (52.1,94) which could take more than an hour particularly in a large database. ************************************************************************** This patch may be installed with users on the system although it is recommended that it be installed during non-peak hours. Here is an example of queuing the install: Select INSTALL NAME: PSO*7.0*679 4/27/22@20:33:50 => PSO*7.0*679 This Distribution was loaded on Apr 27, 2022@20:33:50 with header of PSO*7.0*679 It consisted of the following Install(s): PSO*7.0*679 Checking Install for Package PSO*7.0*679 Install Questions for PSO*7.0*679 Incoming Files: 52 PRESCRIPTION (Partial Definition) Note: You already have the 'PRESCRIPTION' File. Want KIDS to INHIBIT LOGONs during the install? NO// Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO// Enter the Device you want to print the Install messages. You can queue the install by enter a 'Q' at the device prompt. Enter a '^' to abort the install. DEVICE: HOME// QUEUE TO PRINT ON DEVICE: HOME// P-MESS P-MESSAGE-HFS HFS FILE => MESSAGE Subject: PSO*7*679 conversion of 52.1,94 Select one of the following: M Me P Postmaster From whom: Me// Send mail to: INSTALLER,NAME// INSTALLER,NAME Select basket to send to: IN// And Send to: Request Start Time: Apr 27, 2022@20:36:41// (APR 27, 2022@20:36:41) Install Queued! Installation Instructions: 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 or build name. PSO*7.0*679 NOTE: Using will not bring up a Multi-Package build even if it was loaded immediately before this step. It will only bring up the last patch in the build. B. Select the Backup a Transport Global option to create a backup message. For each patch you can specify what to backup, the entire Build or just Routines. The backup message can be used to restore just the routines or everything that will restore your system to pre-patch condition. 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 NO. 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. Back-Out/Roll Back Plan: ------------------------ In the event of a catastrophic failure, the site leadership may make the decision to back-out the patch. To back-out the patch, restore the backup created when the patch was installed. For the back-out to be performed, you must ensure a backup is created. To verify the back-out is successful the routine checksums. Routine Information: ==================== The second line of each of these routines now looks like: ;;7.0;OUTPATIENT PHARMACY;**[Patch List]**;DEC 1997;Build 16 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSO679P Before: n/a After: B4162949 **679** Routine Name: PSOATRFV Before: B48290573 After: B51825808 **642,679** Routine Name: PSOVCCA Before: B1326320 After: B8288157 **642,679** Routine list of preceding patches: 642 ============================================================================= User Information: Entered By : Date Entered : APR 08, 2022 Completed By: Date Completed: DEC 13, 2022 Released By : Date Released : DEC 14, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT