============================================================================= Run Date: JUN 04, 2020 Designation: GMRA*4*53 Package : GMRA - ADVERSE REACTION TRACKING Priority: Mandatory Version : 4 SEQ #55 Status: Released Compliance Date: SEP 30, 2020 ============================================================================= Associated patches: (v)OR*3*377 install with patch `GMRA*4*53' (v)GMRA*4*48 <<= must be installed BEFORE `GMRA*4*53' (v)GMRA*4*52 <<= must be installed BEFORE `GMRA*4*53' Subject: CPRS V31.B - ADVERSE REACTION TRACKING BUG FIXES Category: - Routine - Other Description: ============ This patch is part of CPRS v31b updates. Below is a list of all the applications involved in this project along with their patch numbers: APPLICATION/VERSION PATCH --------------------------------------------------------------- KERNEL v8.0 XU*8.0*653 TOOLKIT v7.3 XT*7.3*142 TEXT INTEGRATION UTILITIES v1.0 TIU*1.0*290 WOMEN'S HEALTH v1.0 WV*1.0*24 HEALTH SUMMARY v2.7 GMTS*2.7*67 REGISTRATION v5.3 DG*5.3*932 CLINICAL REMINDERS v2.0 PXRM*2.0*45 ADVERSE REACTION TRACKING v4.0 GMRA*4.0*53 CONSULT/REQUEST TRACKING v3.0 GMRC*3.0*88 OUTPATIENT PHARMACY v7.0 PSO*7.0*477 ORDER ENTRY/RESULTS REPORTING v3.0 OR*3.0*377 Patches XU*8.0*653 and XT*7.3*142 are being released in individual Kernel Installation and Distribution System (KIDS) Host files. Other patches (TIU*1.0*290, WV*1.0*24, GMTS*2.7*67, DG*5.3*932, PXRM*2.0*45, GMRA*4.0*53, GMRC*3.0*88, PSO*7.0*477, and OR*3.0*377) are being released in a KIDS multi-package build CPRS V31B REQUIRED PATCHES 1.0. This patch resolves issues identified during the testing of CPRS v31.b as well as post-release issues with recently released patches. It also distributes a new assessment change protocol that will notify subscribing packages when a patient's assessment changes. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- PATIENT ALLERGIES (#120.8) REACTIONS OTHER REACTION (#1) Modified (#120.81) Forms Associated: ----------------- N/A Mail Groups Associated: ----------------------- N/A Options Associated: ------------------- N/A Protocols Associated: --------------------- Protocol Name New/Modified/Deleted ------------- -------------------- GMRA ASSESSMENT CHANGE New Security Keys Associated: ------------------------- N/A Templates Associated: --------------------- N/A Additional Information: New Service Requests (NSRs): ---------------------------- N/A Patient Safety Issues (PSIs): ----------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- 1. I9130534FY16: Pharmacy ADPAC requesting assistance with Assessment clean up utility in PROD following GMRA*4*48 install RTC 342937: Patient is Not Removed From Assessment Clean-up Utility's List Problem: ------- After correcting a patient's record in the utility, the utility was not properly exited. This left the patient on the list of patients with issues. When the patient is selected from the list, the utility does not allow the user to access the patient's record stating that the record is already corrected. There is no way for the user to remove the corrected patient's name from the list. Resolution: ---------- After installing this patch, when the utility determines that a patient's record is already corrected at the time the user selects the patient, it will remove the patient from the list. 2. I9719240FY16: User at Oklahoma City is getting an error when trying to finish an order - DRUG+92^GMRAOR *ITEMS("") Problem: ------- When finishing a pharmacy order for a patient with an adverse reaction that has a sign/symptom of OTHER REACTION and the free text value contains a trailing comma, a subscript error is generated during the drug-allergy order check. Resolution: ---------- This patch contains a post-install routine that schedules a background task that will remove leading, trailing, and repeated commas from the free text value of OTHER REACTION. This patch also modifies the OTHER REACTION field (#1) in the REACTIONS multiple field (#10) in the PATIENT ALLERGIES file (#120.8) to no longer allow leading, trailing or repeated commas in that field's value. Finally, this patch modifies the drug-allergy order check to no longer generate this error when the free-text value for OTHER REACTION contains leading, trailing or repeated commas. 3. INC8611870 - GMRA ASSESSMENT UTILITY bug: patient stuck on report Problem: ------- After the GMRA assessment utility is ran and a patient's record is corrected outside of the utility. Attempts to edit the patient inside of the utility state that the record "has already been corrected.", but the patient does not get removed from the list. This also has the unintended consequence of not allowing a new report to be ran Resolution: ---------- Routine GMRAFA was modified so that if the record was already corrected the program will process that record through the "removal" logic. 4. INC8611936 - GMRA ASSESSMENT UTILITY bug: "has locked that patient's records" message Problem: ------- After the GMRA assessment utility is ran and a patient's record is corrected outside of the utility. Attempts to edit the patient inside of the utility will "lock" the record and then never "unlock" Resolution: ---------- Routine GMRAFA was modified so that if the record was already corrected the program will process that record through the "unlock" logic. Test Sites: ---------- Atlanta VA Health Care System (Decatur, GA) Hampton VA Medical Center (Hampton, VA) Northport VA Medical Center (Northport, NY) Louis Stokes Cleveland VA Medical Center (Cleveland, OH) 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: https://www.domain.ext/vdl/ Updated documentation will not be on the VDL until after the phased deployment has completed. Documentation Title File Name FTP Mode --------------------------------------------------------------------- Adverse Reaction Tracking Technical Manual gmra_4_0_tm.pdf Binary Patch Installation: ------------------- Pre/Post Installation Overview: ------------------------------- This patch has no pre-installation routine. The post-installation routine, GMRAP053, will schedule a background task that will remove leading, trailing and repeated commas from the OTHER REACTION field (#1) in the REACTIONS multiple field (#10) in the PATIENT ALLERGIES file (#120.8). When complete, the background task will send an email to the installer and members of the OR CACS mail group detailing the data that was modified. The email will have the subject "GMRA*4*53 CLEAN-UP STATUS". Recipients are strongly encouraged to review this message to ensure all modifications are acceptable. Installation Instructions: -------------------------- Please refer to the "CPRS v31b Deployment, Installation, Back Out and Rollback Guide" for installation and set-up information. This document is exported as OR_30_377_IG.doc or OR_30_377_IG.pdf and is included in OR_30_377.ZIP and will be emailed to the installation point of contacts by the CPRS Implementation team. Post-Installation Instructions: ------------------------------- Once the email message with the subject "GMRA*4*53 CLEAN-UP STATUS" is received, the installer may safely delete routine GMRAP053 using the Delete Routines [XTRDEL] option. If the background task finishes without sending an email, the message text that would have been sent is stored in the ^XTMP("GMRA*4*53 CLEAN-UP STATUS") global for 31 days after the background task finishes. Routine Information: ==================== The second line of each of these routines now looks like: ;;4.0;Adverse Reaction Tracking;**[Patch List]**;Mar 29, 1996;Build 306 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: GMRADPT Before: B83390495 After: B87802834 **2,10,46,52,53** Routine Name: GMRAFA Before: B82868608 After: B83983798 **48,53** Routine Name: GMRAOR Before:B152346772 After:B152567443 **2,13,26,37,41,42,44,46,52,53** Routine Name: GMRAP053 Before: n/a After: B23628061 **53** Routine Name: GMRAVPR Before: n/a After: B2964831 **53** Routine list of preceding patches: 48, 52 ============================================================================= User Information: Entered By : Date Entered : JUN 13, 2016 Completed By: Date Completed: JUN 02, 2020 Released By : Date Released : JUN 04, 2020 ============================================================================= Packman Mail Message: ===================== No routines included