$TXT Created by VSM.CENTRAL-TEXAS.PREPROD.DOMAIN.EXT (KIDS) on Thursday, 12/14/23 at 17:37 ============================================================================= Run Date: JAN 24, 2024 Designation: KMP*4*4 Package : KMP - CAPACITY MANAGEMENT Priority: Mandatory Version : 4 SEQ #4 Status: Released Compliance Date: FEB 24, 2024 ============================================================================= Associated patches: (v)KMP*4*3 <<= must be installed BEFORE `KMP*4*4' Subject: VSM ADMINISTRATIVE UPDATES Category: - Routine - Data Dictionary Description: ============ The purpose of patch KMP*4*4 is to provide greater ability to configure the VistA System Monitor data collections and to provide greater insight into the performance of the collections and data transmission. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- VSM CONFIGURATION (8969) TASKMAN SCHEDULE FREQUENCY (1.05) Modified VSM CONFIGURATION (8969) TASKMAN SCHEDULE START (1.06) Modified 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 Associate: 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: ---------------------------- N/A Problem 1: ---------- While technically correct, the code calculating the timestamp variables causes an error in XINDEX due to spaces within the parenthesis. Resolution1: ------------ Remove the spaces to not create an XINDEX error. Problem 2: ---------- The GetHttpMetrics post REST method only provides performance metrics on the last node surveyed. Resolution 2: ------------- The method was edited to report HTTP performance metrics on each node running VSM. Problem 3: ---------- There is currently no visibility into how much data is stored in the "Retry" nodes used to resend data the following day. Resolution 3: ------------- Create an API that provides administrators visibility into the "Retry" data. Problem 4: ---------- If a specific monitor is stopped during a day's run, there is no means to remotely restart the monitor. Resolution 4: ------------- Provide a remote method allowing the administrators to restart a monitor remotely. Problem 5: ---------- The VSM synthetic transaction capability relies on the Site Status API to get the current active node names. Due to timing variances, there are times when the site status API incorrectly denotes the VistA DB server as primary or backup. This allows synthetic transactions to be executed against a DB backup mirror member. Resolution 5: ------------- Code was added to the synthetic transaction methods that checks for the mirror status if it is a DB node. If the status is not Primary, the code will immediately return without executing the synthetic transaction denoting that the node is not Primary. Problem 6: ---------- Currently the purge routine runs once for all VSM monitors. At times, this can inadvertently delete a working VSM file, thus losing data for that collection interval. Resolution 6: ------------- The purge function was changed to run separately for each VSM monitor. Problem 7: ---------- There are cases with the HL7 monitor where an HTTP Request is larger than that allowed by the AWS API Gateway. Resolution 7: ------------- The code was changed to send multiple smaller messages when the total size is too large for a single request. This value is parameterized via the HTTP REQUEST MAX LENGTH field such that it can be changed if needed. Problem 8: ---------- The current GetPackages API only returns the first entry if there are multiple entries for a namespace in the package file. Resolution 8: ------------- The GetPackages API was modified to return all entries. Problem 9: ---------- There are times when a CPRS coversheet load does not complete. This is noted by no end time for the entry. Currently, if the difference between current time and the coversheet start time is greater than 15 minutes the entry is deleted. It is possible that the coversheet does complete, but takes more than 15 minutes. Resolution 9: ------------- The time will be increased to 24 hours before the entry is deleted. At that point the entry will be deleted and counted as "abandoned". Also, any entries with no start time will be counted. This will make sure the coversheet load has ample time to return and allow a means to track these problem situations. Problem 10: ----------- Currently there is no general visibility into how the global buffers are being used. Resolution 10: -------------- Create an API that will return the number of global buffers and the percentage of the global buffers utilized by each global. Test Sites: ----------- Hines VAMC Boston VAMC Cleveland VAMC SNOW IOC Change Orders: Hines VAMC CHG0440887 Boston VAMC CHG0439488 Cleveland VAMC CHG0439488 Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released in a PackMan message. Documentation describing the new functionality is included in this release. Documentation can be found on the VA Software Documentation Library at: https://www.domain.ext/vdl/. Documentation can also be obtained at https://download.vista.domain.ext/index.html/SOFTWARE. Documentation Title File Name -------------------------------------- Technical Manual KMP_TM.PDF KMP_TM.DOCX User Manual KMP_UM.PDF KMP_UM.DOCX Patch Installation: Pre/Post Installation Overview: ------------------------------ The Pre Installation routine, PRE^KMPPS44, will remove existing values from fields TASKMAN SCHEDULE FREQUENCY and TASKMAN SCHEDULE START in VSM CONFIGURATION file (#8969) to prepare for data dictionary changes to these fields. The Post Installation routine, POST^KMPPS44, will set the default values for the 2 modified fields in VSM CONFIGURATION file #8969: * HTTP REQUEST MAX LENGTH (#1.05) * MONITOR START DELAY (#1.06) Pre-Installation Instruction: ----------------------------- This patch can be queued for installation. TaskMan does not have to be stopped, Health Level 7 (HL7) filers do not need to be stopped, the current VistA System Monitors do not need to be stopped, and users may be on the system. The patch should be installed during non-peak hours to minimize potential for disruption to users. This patch should take less than 10 minutes to install. Note: ----- The routines KMPTCMRT, KMPUTLW, KMPTASK and KMPVRUN in this patch will displaY XINDEX errors. This is correct and expected. This has been allowed by the Standards and Conventions Committee exemption 202301251506-01. 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 or build name. (KMP*4*4) NOTE: Using will not bring up a Multi-Package build even if it was loaded immediately before this step. It will only bring up the last patch in the build. B. Select the Backup a Transport Global option to create a backup message. You must use this option and specify what to backup; the entire Build or just Routines. The backup message can be used to restore the routines and components of the build to the pre-patch condition. i. At the Installation option menu, select Backup a Transport Global. ii. At the Select INSTALL NAME prompt, enter your build KMP*4*4 iii. When prompted for the following, enter "B" for Build. Select one of the following: B Build (including Routines) R Routines Only Backup Type: B// iv. When prompted "Do you wish to secure your build? NO//", press and take the default response of "NO". v. When prompted with, "Send mail to: Last Name, First Name", press to take default recipient. Add any additional recipients. vi. When prompted with "Select basket to send to: IN//", press and take the default IN mailbox or select a different mailbox. C. You may also elect to use the following options: i. Print Transport Global - This option will allow you to view the components of the KIDS build. ii. 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 of the components of this patch, such as routines, DDs, templates, etc. D. Select the Install Package(s) option and choose the patch to install. (KMP*4*4) i. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//', answer . ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer . iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', answer . Post-Installation Instructions: ------------------------------ There are no Post-Installation actions. Back-Out/Roll Back Plan: ------------------------ Inform CPE of the problem. Email: VA IT EPMO VistA System Monitor . A patch will be needed to restore to previous state. If there is a problem with the patch installation, each VSM monitor should be turned off locally via the VSM MANAGEMENT menu option under the CAPACITY PLANNING XTCM MAIN menu. This option requires the KMPVOPS security key. Once executing this option take the following steps for each monitor listed: 1) Select "Stop Monitor" at the Select Action prompt. 2) Type the 4 letter monitor acronym from the list above at the "Stop Monitor Type" prompt. (ex. VBEM) 3) Choose "Y" to confirm at the "Do you want to stop VSTM collection?" prompt. 4) Repeat for each monitor listed. Routine Information: ==================== The second line of each of these routines now looks like: ;;4.0;CAPACITY MANAGEMENT;**[Patch List]**;3/1/2018;Build 36 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: KMPBEMRT Before: B66373711 After: B60365315 **1,2,3,4** Routine Name: KMPCSMRT Before: B81503871 After: B83725128 **1,2,3,4** Routine Name: KMPETMRT Before: B49802407 After: B44321934 **1,2,3,4** Routine Name: KMPHLMRT Before:B112350514 After:B125376830 **1,2,3,4** Routine Name: KMPMCMRT Before: B76227616 After: B69297175 **1,2,3,4** Routine Name: KMPPS44 Before: n/a After: B64859854 **4** Routine Name: KMPPS44A Before: n/a After:B129494370 **4** Routine Name: KMPPS44B Before: n/a After:B155974485 **4** Routine Name: KMPPS44C Before: n/a After:B113506653 **4** Routine Name: KMPPST3 Before: B59700788 After: Delete Routine Name: KMPPST3A Before: B27040733 After: Delete Routine Name: KMPPST3B Before: B53675638 After: Delete Routine Name: KMPPST3C Before: B85178395 After: Delete Routine Name: KMPPST42 Before: B10316646 After: Delete Routine Name: KMPPST43A Before: B43113600 After: Delete Routine Name: KMPPST43B Before:B141380921 After: Delete Routine Name: KMPPST43C Before:B138855718 After: Delete Routine Name: KMPSTMRT Before: B75347930 After: B67791040 **1,2,3,4** Routine Name: KMPTASK Before: B97819818 After: B32166800 **1,4** Routine Name: KMPTCMRT Before:B115662867 After:B107811786 **1,2,3,4** Routine Name: KMPUTLW Before:B121862756 After:B119669479 **1,3,4** Routine Name: KMPUTLW2 Before: B70701886 After: B68350568 **1,4** Routine Name: KMPVBETR Before: B27830424 After: Delete Routine Name: KMPVCBG Before:B160104165 After:B100286735 **1,2,3,4** Routine Name: KMPVCCFG Before: B54250810 After: B54379139 **1,2,4** Routine Name: KMPVPST1 Before: B16080867 After: Delete Routine Name: KMPVPST2 Before: B29687723 After: Delete Routine Name: KMPVRUN Before: B26630757 After: B21928207 **1,2,3,4** Routine Name: KMPVVHLM Before:B195443115 After: Delete Routine Name: KMPVVMCM Before: B42787451 After: Delete Routine Name: KMPVVSTM Before: B25044497 After: Delete Routine Name: KMPVVTCM Before: B40949860 After: Delete Routine list of preceding patches: 3 ============================================================================= User Information: Entered By : Date Entered : AUG 18, 2023 Completed By: Date Completed: JAN 24, 2024 Released By : Date Released : JAN 24, 2024 ============================================================================= Packman Mail Message: ===================== $END TXT