$TXT Created by at COC-CCAD-DEV.AAC.DOMAIN.EXT (KIDS) on Wednesday, 03/25/20 at 13:08 ============================================================================= Run Date: APR 20, 2020 Designation: GMRC*3*152 Package : GMRC - CONSULT/REQUEST TRACKING Priority: EMERGENCY Version : 3 SEQ #132 Status: Released Compliance Date: MAY 20, 2020 ============================================================================= Associated patches: (v)GMRC*3*139 <<= must be installed BEFORE `GMRC*3*152' Subject: DECISION SUPPORT TOOL TIMEOUT ENHANCEMENT Category: - Routine Description: ============ Description: ------------ A %Object error has occurred in a few sites that is a result of the VistA RPC call used by the Decision Support Tool (DST) to acquire data from the DST servers, not being able to either connect to a socket or to receive a response within the current timeout. Since this process happens in the background and is independent of the user interaction with either CPRS or the DST tools it was determined that greatly extending both the timeout and the number of attempts at communicating with the DST Servers is warranted. This patch extends the existing overall timeout to 60 seconds, and adds a specific Socket based timeout that will be 30 seconds long. In addition, the number of attempts is raised to 10 tries and the hang time between each attempt was increased to 3 seconds. This has proven to give ample time for slow systems to get a connection and acquire the DST data. Another bug was also found that involves an error with the Autoforward code in patch GMRC*3.0*139, which attempts to do an evaluation for Autoforward on a line that was blank. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- N/A Forms Associated: Form Name File # 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 Additional Information: N/A New Service Requests (NSRs): ---------------------------- < N/A Patient Safety Issues (PSIs): ----------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- 1.INC8611460 DST not working %ObjectError Problem: ------- For systems that are processing slowly there is an increased possibility of the connection protocols timing out. When this happens within Cache, DST RPC will place a DST-ERR into the consult instead of the DST data. In the case of a timeout problem this has proven to be in a few sites a %ObjectError. Resolution: ---------- The current timeouts can be greatly increased to allow slow systems more time to connect to the internet and acquire the DST Data. 2. INC8638035 DST Error caused by Autoforwarding Problem: ------- If there are blank lines in the data received from DST (i.e. ) the VistA system will generate an undefined error because the blank line in the COM(#) will be checked after it has been killed and that line with not exist. Resolution: ---------- Placed a Quit command after the evaluation of a Null line so no further processing is done on a non-existent line. Test Sites: ------------- Phoenix, AZ Baltimore, MD Salt Lake City, UT Software and Documentation Retrieval Instructions: ---------------------------------------------------- Software being released as a Packman Message. There are no files or KIDs builds to acquire. Documentation for the DST GUI can be found in the Consults/Requests User Manual on the VA Software Documentation Library at: N/A Title File Name FTP Mode ----------------------------------------------------------------------- N/A Patch Installation: Pre/Post Installation Overview: ------------------------------- ========================================================================== NOTE: The Decision Support Tool project team has been granted approval from the SAC compliance team to release this patch nationally with known XINDEX errors. After installation of this patch and execution of XINDEX on the GMRCDST routine, the IT installer will see the following known errors. These errors are being waived by the SAC compliance team at this point with an exemption that was granted on 1/31/20 and documented in line 3 of the routine. Compiled list of Errors and Warnings Mar 25, 2020@17:12:20 page 1 GMRCDST * * 337 Lines, 14237 Bytes, Checksum: B142323041 S REQUEST.Timeout=60 GETDST+22 S - Vendor specific code is restricted. S REQUEST.OpenTimeout=30 GETDST+23 S - Vendor specific code is restricted. . S COM(2)=XUERR.code TRYAG+6 S - Vendor specific code is restricted. . I XUERR["Http" S COM(3)=XUERR.statusLine TRYAG+7 S - Vendor specific code is restricted. . I XUERR["ObjectError" S COM(3)=XUERR.domain,COM(4)=XUERR.errorType TRYAG+8 S - Vendor specific code is restricted. TRYAG+8 S - Vendor specific code is restricted. S RESPONSE=REQUEST.HttpResponse TRYAG+14 S - Vendor specific code is restricted. S DATA=RESPONSE.Data TRYAG+15 S - Vendor specific code is restricted. F Q:DATA.AtEnd Set RESPJSON=RESPJSON_DATA.ReadLine() TRYAG+18 S - Vendor specific code is restricted. TRYAG+18 S - Vendor specific code is restricted. ========================================================================== Pre-Installation Instructions: ------------------------------ 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. This patch should take less than 5 minutes to install. Installation Instructions: -------------------------- There is only a single routine in this patch that contains the increased Timeouts and the additional Quit command in TRYAG^GMRCDST 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 the patch #(GMRC*3.0*152): 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//' 6. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//' 7. If prompted 'Delay Install (Minutes): (0 - 60): 0//' respond 0. Post-Installation Instructions: ------------------------------- N/A Back-Out Plan: -------------------- If there is a need to backout this software. Reinstall patch GMRC*3.0*139 and it will overwrite this patch. Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0;CONSULT/REQUEST TRACKING;**[Patch List]**;DEC 27, 1997;Build 5 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: GMRCDST Before:B137089664 After:B142323041 **124,139,152** Routine list of preceding patches: 139 ============================================================================= User Information: Entered By : Date Entered : DEC 06, 2019 Completed By: Date Completed: APR 17, 2020 Released By : Date Released : APR 20, 2020 ============================================================================= Packman Mail Message: ===================== $END TXT