$TXT Created by at MDEVC.FO-BIRM.DOMAIN.EXT (KIDS) on Monday, 09/27/21 at 14:38 ============================================================================= Run Date: OCT 19, 2021 Designation: VPR*1*27 Package : VPR - VIRTUAL PATIENT RECORD Priority: EMERGENCY Version : 1 SEQ #26 Status: Released Compliance Date: OCT 21, 2021 ============================================================================= Associated patches: (v)TIU*1*290 <<= must be installed BEFORE `VPR*1*27' (v)VPR*1*25 <<= must be installed BEFORE `VPR*1*27' Subject: DELETED RECORDS, MISC FIXES Category: - Routine - Other - Data Dictionary Description: ============ ************************************************************************** IMPORTANT: THIS PATCH INSTALLATION IS BEING COORDINATED WITH THE HEALTHSHARE TEAM AND HAS SPECIFIC INSTALLATION DATE(S) AND TIME FRAMES YOUR VISTA PRODUCTION INSTALLATION MUST BE QUEUED TO OCCUR ON 10/20/2021 any time between 2:05 am and 3:55 am -OR- 10/21/2021 any time between 2:05 am and 3:55 am SEE DETAILS BELOW IN THE PRE-INSTALLATION INSTRUCTIONS ************************************************************************** This patch to the Virtual Patient Record (VPR) application will make some updates to the HealthShare processing mechanisms. 1. This patch addresses some issues with removing data from the HealthShare Edge Cache Repositories (ECR) when records are modified or deleted in VistA: * HealthShare requires certain key fields to be passed to match the record being updated; this information will now be stored temporarily in ^XTMP when a record is deleted, so it will be available to the process that builds and sends the delete request. * When a document is amended in the Text Integration Utilities (TIU) package in VistA, the pointer to the VISIT (#9000010) file is removed from the original document. The visit is required for matching the record in HealthShare, so this data will now also be temporarily stored in ^XTMP to keep it available. 2. A few miscellaneous updates are also being made to the data extracts: * The Outside Location will now be saved in the ECR for external visits. * Lab accession information will now be sent to the ECR when available, instead of waiting for the results to be finalized. * An existence check has been added to the Problem extract, to prevent errors that can occur when stray cross reference nodes are left. 3. A new VPR CONTAINER (#560.1) file is being created to hold processing and implementation information for each clinical domain and source. Patch Components: ----------------- Entities Associated: Entity Name New/Modified/Deleted ----------- -------------------- VPR DEL FAMILY HX New VPR DEL HF VACC REFUSAL New VPR DEL PTF New VPR DEL SOCIAL HX New VPR DEL TIU DOCUMENT New VPR DEL V CPT New VPR DEL V EXAM New VPR DEL V POV New VPR DEL VACCINATION New VPR EDP EXTENSION Modified VPR EDP LOG Modified VPR IMM ADMINISTRATION Modified VPR LRCH RESULT Modified VPR LRCY RESULT Modified VPR LREM RESULT Modified VPR LRMI RESULT Modified VPR LRSP RESULT Modified VPR PROBLEM Modified VPR TEXT ONLY New VPR VISIT Modified VPR VISIT EXTENSION Modified Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified ------------------ ------------------- ------------ VPR CONTAINER (#560.1) All New Forms Associated: N/A Mail Groups Associated: N/A Options Associated: N/A Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- TIU DOCUMENT ACTION EVENT Modified (Use as Link) VPR TIU RETRACT New Remote Procedure Calls: N/A Security Keys Associated: N/A Templates Associated: Template Name New/Modified/Deleted ------------- -------------------- VPR CONTAINER SOURCES New (#560.1) Blood Bank Team Coordination: N/A New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Tickets: N/A Test Sites: ----------- Dublin, GA Fayetteville, AR Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released as a KIDS build via a PackMan message. Patch Installation: ------------------- Pre-Installation Instructions: This patch adds a listener to a TIU event that is processed via a tasked resource device; during testing it was discovered that if the resource is blocked, there isn't always an indication of a problem in the TaskMan monitor options. It is strongly recommended to use the SYNC flag file control [XUTM SYNC] option to check this TIU resource; if found here, the resource is currently blocked. Select the START action to clear the flag and schedule the backed up tasks. Select Taskman Management Utilities Option: SYNC flag file control Select TASK SYNC FLAG NAME: TIUDAN~TIU ACTIONS RESOURCE TIUDAN~TIU ACTIONS RESOURCE Select one of the following: Z ZAP S START NEXT Q QUIT What to do with this one:: START NEXT OK If the resource is not found in this option, it is running correctly. Select TASK SYNC FLAG NAME: TIUDAN ?? Select TASK SYNC FLAG NAME: Installation Instructions: 1. Choose the PackMan message containing this patch. 2. Choose the INSTALL/CHECK MESSAGE PackMan option. 3. 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 VPR*1.0*27. a. Backup a Transport Global - This option will create a backup message of any routines exported with this patch. It will not backup any other changes such as DDs or templates. 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. 4. From the Installation Menu, select the Install Package(s) option and choose the patch to install. 5. When prompted Want KIDS to INHIBIT LOGONs during the install? NO// enter NO. 6. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO// enter NO. 7. If prompted Delay Install (Minutes): (0-60): 0// respond 0. Additional Installation Information: ** This patch MUST be queued for installation in a production system! ** Patch installation in production systems is being coordinated with the HealthShare server team. All HealthShare queries to your VistA system will be disabled during the day and time frames listed below. You must *QUEUE* this patch for installation during one these days/times: 10/20/2021 any time between 2:05 am and 3:55 am or 10/21/2021 any time between 2:05 am and 3:55 am Queuing is not required for test or non-production systems. TaskMan and Health Level 7 (HL7) filers do not need to be stopped, and users may be on the system. Installation should take less than 1 minute. At the DEVICE prompt, queue the installation for a required day and time frame, sending the output to yourself in a mail message. DEVICE: HOME// QUEUE DEVICE: HOME// P-MESSAGE Subject: VPR*1*27 INSTALL Select one of the following: M Me P Postmaster From whom: Me// Send mail to: << YOUR NAME HERE Select basket to send to: IN// And Send to: << press enter or select another recipient Request Start Time: 10/20/21@3am << make sure to use a day and time within the ranges stated above. Post-Installation Instructions: There will be errors the first time this patch is installed when KIDS attempts to resolve pointers for the data brought in with the new VPR CONTAINER (#560.1) file, because new entries in the ENTITY (#1.5) file brought in with this patch have not been installed yet. A post-init routine will resolve those links. Backout Procedures: ------------------- If rollback/backout is required, the installer should contact Health Product Support (email clin3@domain.ext) for a KIDS build that will restore all modified components back to their pre-patch released state. Routine Information: ==================== The second line of each of these routines now looks like: ;;1.0;VIRTUAL PATIENT RECORD;**[Patch List]**;Sep 01, 2011;Build 10 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: VPRENC Before: B65457282 After: B95215040 **19,20,26,25,27** Routine Name: VPREVNT Before:B116657683 After:B150306376 **8,10,15,17,19,21,20,26,25,27** Routine Name: VPRHS Before: B58452424 After: B52054574 **8,10,15,16,17,19,25,27** Routine Name: VPRHST Before: B16139513 After: B17310727 **8,25,27** Routine Name: VPRHST1 Before: B6718182 After: B6740890 **8,25,27** Routine Name: VPRHSX Before: B33888544 After: B34508613 **8,15,25,27** Routine Name: VPRHSX1 Before: B36584705 After: B37479268 **25,27** Routine Name: VPRP27 Before: n/a After: B4449259 **27** Routine Name: VPRSDAB Before: B23147718 After: B22983040 **20,26,27** Routine Name: VPRSDAG Before: n/a After: B19261787 **27** Routine Name: VPRSDAQ Before:B154675923 After:B162462999 **8,10,20,26,25,27** Routine Name: VPRSDAV Before: B62189593 After: B75139448 **20,26,27** Routine list of preceding patches: 25 ============================================================================= User Information: Entered By : Date Entered : SEP 29, 2020 Completed By: Date Completed: OCT 19, 2021 Released By : Date Released : OCT 19, 2021 ============================================================================= Packman Mail Message: ===================== $END TXT