$TXT Created by at MNTVBB.DOMAIN.EXT (KIDS) on Monday, 08/15/22 at 09:30 ============================================================================= Run Date: SEP 29, 2022 Designation: XOBV*1.6*6 Package : XOBV - VISTALINK Priority: Mandatory Version : 1.6 SEQ #6 Status: Released Compliance Date: OCT 30, 2022 ============================================================================= Associated patches: (v)XOBV*1.6*4 <<= must be installed BEFORE `XOBV*1.6*6' Subject: ERROR LIMIT RESOLUTION Category: - Routine Description: ============ This patch addresses three known issues in routine XOBVLL: two occurrences of syntax errors when code stored in the $ET and $EC variables executes; and a problem of blanks appearing in the error descriptions in the error trap due to extrinsic function EZBLD^DIALOG being called incorrectly. 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 Remote Procedures Associated: Remote Procedure Name New/Modified/Deleted --------------------- -------------------- N/A Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- N/A Additional Information: ----------------------- New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: 1. INC16544454 - VistALink not honoring error limit Problem: -------- a) Unlimited errors are being logged in the error trap despite the fact that the system is configured to have a maximum of one hundred occurrences for a given error. b) Blank error descriptions appear in the error trap. Resolution: ----------- a) There is a problem in routine XOBVLL in the sections of code that trap errors. There are syntax errors that are not evident at compile time but become evident at runtime. This is because the errors are handled by building executable code into the special variables used by the error trap. The code that is being set into these variables contains syntax errors. Thus, when an error is detected, the sections of code that are supposed to record an error themselves crash with an error, causing a runaway effect. These crashes occur repeatedly before the error recording software has the opportunity to check any error limits. The routine XOBVLL has been modified such that special variables are initiated with syntactically correct code. b) The extrinsic function EZBLD^DIALOG is being called incorrectly at line NXTCALL+46. This call: D ERROR(181002,$$EZBLD^DIALOG(181002),XOBPORT) was changed to: D ERROR(181002,$$EZBLD^DIALOG(181002,$$EC^%ZOSV),XOBPORT) Test Sites: ----------- San Francisco VA Health Care System (San Francisco,CA) Tomah VA Medical Center(Tomah,WI) Documentation Retrieval Instructions: ------------------------------------- N/A Software and Documentation Retrieval Instructions: ---------------------------------------------------- The software for this patch is being released in a PackMan message. Title File Name FTP Mode ---------------------------------------------------------------------- N/A Patch Installation: ------------------- Pre/Post Installation Overview: N/A Pre-Installation Instructions: This installation may be installed with users on the system although it is recommended it be queued to run after normal business hours to minimize potential disruption to users. This patch should take less than 3 minutes to install. 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 name (ex. XOBV*1.6*6). b. Print Transport Global - This option will allow you to view the components of the KIDS build. c. 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, such as routines, DD's, templates, etc. d. 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. You can send the backup message to yourself and others on your team. The backup message can be used to restore just the routines or everything that will restore your system to pre-patch condition. e. Select the Install Package(s) option and choose the patch to install. i. When prompted "Want KIDS to INHIBIT LOGONs during the install? NO//", answer NO. ii. When prompted "Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//", answer NO. Post-Installation Instructions: N/A Back-Out/Roll Back Plan: ------------------------ Prior to installing the patch, the installer should have saved a backup of the routines in a mail message using the Backup a Transport Global [XPD BACKUP] menu option. The message containing the backed up routines can be loaded with the "Xtract PackMan" function at the Message Action prompt. The PackMan function INSTALL/CHECK MESSAGE is then used to install the backed up routines onto the VistA system. Routine Information: ==================== The second line of each of these routines now looks like: ;;1.6;VistALink;**[Patch List]**;Apr 5,2017;Build 33 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: XOBVLL Before: B22120748 After: B23047152 **4,6** ============================================================================= User Information: Entered By : Date Entered : JUL 30, 2020 Completed By: Date Completed: SEP 28, 2022 Released By : Date Released : SEP 29, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT