$TXT Created by at C31BM.DEVSLC.DOMAIN.EXT (KIDS) on Thursday, 09/03/20 at 15:09 ============================================================================= Run Date: NOV 18, 2020 Designation: TIU*1*336 Package : TIU - TEXT INTEGRATION UTILITIES Priority: Mandatory Version : 1 SEQ #299 Status: Released Compliance Date: DEC 19, 2020 ============================================================================= Associated patches: (v)TIU*1*290 <<= must be installed BEFORE `TIU*1*336' Subject: COPY/PAST LOCATION ISSUE Category: - Routine - Informational Description: ============ This patch corrects an issue related to the copy/paste functionality released as part of CPRS 31B and patch TIU*1.0*290. Sites who have users that login to a location where the Station Number is not all numeric are seeing a failure in copy/paste functionality. The Text Integration Utility (TIU) Technical Manual is also being modified to add information related to the TIU*1*290 patch release. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- N/A 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 --------------------- -------------------- N/A Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- N/A Additional Information: ----------------------- N/A New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: 1. Defect 1289159: Copy Paste M Side Multi-divisional issue (31bIT 26) Problem: -------- Sites who have users that login to a location where the Station Number is not all numeric are seeing a failure in copy/paste functionality. The issue is caused by the CPRS GUI sending the Station Number of the site in several Remote Procedure Calls (RPC), while the code processing this data was expecting the Internal Entry Number (IEN) of the Institution (#4) file. As these values are not handled properly, pasted text fails to be saved or retrieved by the CPRS GUI. This same issue affects the copy/paste viewing rights for the site entered special userclasses as well. Resolution: ----------- Routines TIUCOP, TIUCOPC, and TIUCOPP were modified to utilize the set DUZ(2) value (INSTITUTION (#4) IEN) and ignore the value received from CPRS in the remote procedure call, before continuing with the processing of the data. This will make sure the proper institution is utilized. A Post-Init routine, TIUP336, will search for stored data which may have used a Station Number instead of the correct IEN to store data and will convert it as necessary. This will correct situations where the Station Number was all numeric but did not match the IEN for it's entry in the Institution (#4) file. 2. Jira Issue TIU-769 Problem: -------- Patch TIU*1*290 updated the rules for the National Medication Patient Data Objects, but failed to include these changes in the Text Integration Utilities (TIU) Technical Manual. Resolution: ----------- The Text Integration Utilities (TIU) Technical Manual was updated to include the modifications for the National Medication Patient Data Objects released in patch TIU*1*290. This involved the inclusion of Clinic medications into the values available for the ALL (ALLMEDS) variable. Test Sites: ----------- VA Heartland Network - East VA Heartland Network - West VA Pacific Islands Health Care System Software and Documentation Retrieval Instructions: -------------------------------------------------- Sites may retrieve the software and/or documentation directly using the Secure File Transfer Protocol (SFTP) address as directed by the CPRS Implementation team. Installation instructions will be distributed when your site begins the implementation process. Documentation can also be found on the VA Software Documentation Library at: http://www.domain.ext/vdl/ Title File Name FTP Mode ------------------------------------------------------------------- TIU Technical Manual tiutm.docx Binary TIU Technical Manual tiutm.pdf Binary Pre-Installation Instructions: ------------------------------ N/A Patch Installation: ------------------- 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. The patch is distributed in KIDS format in a PackMan message. Installation time is less than 5 minutes. This patch can be queued for later installation. These installation steps can be completed with users on the system: 1. Choose the PackMan message containing this patch. 2. Choose the INSTALL/CHECK MESSAGE PackMan option. 3. From the KIDS Menu, select the Installation Menu. From this menu, you may elect to use the following options. When prompted for the INSTALL NAME, enter TIU*1.0*336. 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 Data Dictionaries (DDs) or templates. IN ORDER TO BACKOUT THIS PATCH, THIS OPTION MUST BE USED. 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 when prompted for the INSTALL NAME, enter TIU*1.0*336. 5. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//' respond NO. 6. When prompted "Want KIDS to INHIBIT LOGONs during the install? NO//" respond NO. 7. If prompted "Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//" respond NO. 8. If prompted "Delay Install (Minutes): (0 - 60): 0//" respond 0. Post-Installation Instructions: ------------------------------- N/A Back-Out/Roll Back Plan: ------------------------ In the event of a catastrophic failure, the Area Manager may make the decision to back-out the patch. It is imperative that you have performed a backup of the routines included in this patch prior to installation. The back-out plan is to restore the routines from the backup created. If the post-init converted data needs to be converted as well, then have someone with access to the programmer's prompt run the following line of code: D REVERT^TIUP336 This will start a background job to restore previously modified data in the PASTED TEXT TRACKING (#8928) file. This process relies on the data stored in the temporary global location of ^XTMP("TIUP336 - Post-Init"). This data is saved for 30 days after installation. Once this stored data expires, you are no longer able to revert the changed entries. To verify the back-out completed successfully, ensure the checksum matches the pre-patch checksum from the patch description. Routine Information: ==================== The second line of each of these routines now looks like: ;;1.0;TEXT INTEGRATION UTILITIES;**[Patch List]**;Jun 20, 1997;Build 4 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: TIUCOP Before:B111416781 After:B114396438 **290,336** Routine Name: TIUCOPC Before: B70623553 After: B69055719 **290,336** Routine Name: TIUCOPP Before:B223846199 After:B226151711 **290,336** Routine Name: TIUP336 Before: n/a After: B40538643 **336** Routine list of preceding patches: 290 ============================================================================= User Information: Entered By : Date Entered : JUL 16, 2020 Completed By: Date Completed: NOV 17, 2020 Released By : Date Released : NOV 18, 2020 ============================================================================= Packman Mail Message: ===================== $END TXT