$TXT Created by ALVIN JR at MBOXCACHE.FO-BIRM.DOMAIN.EXT (KIDS) on Friday, 12/08/23 at 12:15 ============================================================================= Run Date: JAN 08, 2024 Designation: DG*5.3*1108 Package : DG - REGISTRATION Priority: Mandatory Version : 5.3 SEQ #972 Status: Released Compliance Date: FEB 08, 2024 ============================================================================= Associated patches: (v)DG*5.3*1097 <<= must be installed BEFORE `DG*5.3*1108' Subject: VAS EXPORT UPDATES Category: - Routine Description: ============ This patch contains the following enhancements to the VistA Audit Solution (VAS) DG VAS EXPORT job: 1. Increase the Max Entries in VAS Queue parameter maximum value The MAX ENTRIES IN DG VAS QUEUE parameter is a file entry in the PARAMETER DEFINITION file (#8989.51). The VALUE DOMAIN field, which defines the lower and upper boundaries of the parameter's value, has been changed from a range of zero to sixty thousand (0:60000) to a range of one thousand to one million (1000:1000000) to prevent data loss when software, hardware, or network issues temporarily prevent the transmission of audit data from VistA to the VAS cloud application. The default value of the parameter remains unchanged (60000), but the increased maximum queue size is available to optionally allow sites to store a greater number of audit transactions in the VAS Export Queue. 2. Add Sending Station Information to VAS Audit Record VAS audit records sent by the VAS export contain the name and number of the Station associated with the VistA user who accessed the veteran (patient) record, but they do not contain the sending station name or number; often these two values are the same, but they may differ when a VistA user logs in to VistA remotely. To address this, the sending facility's station name and number are being added to the audit record and sent to the VAS server. 3. Capture Source Audit Data in Invalid JSON Error The 'Missing or Invalid JSON' error logged by the VAS Export job does not capture any of the original source audit data, making it impossible to determine which audit record caused the error or the datum that could not be encoded. The JSON encoded record is not validated until just before the record is sent to the VAS server, at which time there is no way to trace the empty record back to the original audit event. The audit record's JSON format is now validated immediately after the attempt is made to encode the audit data into JSON format, prior to placing the record into the VAS export queue. If the JSON encoding fails validation, the 'Missing or Invalid JSON' error is logged prior to placing the empty record in the VAS Export queue. The source audit information is still available to the VAS Export software at this time, ensuring the source audit record information is captured to assist with troubleshooting. ========================================================================= NOTE: When running the ^XINDEX routine, errors will be encountered after the installation of this patch. Routines DGAUDIT and DGAUDIT1 use the HealtheVet Web Services Client (HWSC), calling Cache Class methods to write a JSON record to the web service, read the response from the web service, and retrieve the error code if one exists. A Department of Veterans Affairs Cache Programming Standards and Conventions (SAC) Exemption request was granted on 02/14/2022, reference number 20220214-02. ************************************************************************** The errors reported by XINDEX are: Routine: DGAUDIT ----------------- S DGRESTOBJ.SSLCheckServerIdentity=0 RESTPOST+13 W - Vendor specific code is restricted.] . D DGRESTOBJ.EntityBody.Write(DGJSON) RESTPOST+26 W - Vendor specific code is restricted.] D DGRESTOBJ.EntityBody.Write("]") RESTPOST+28 W - Vendor specific code is restricted.] F DGHEADER="Accept","ContentType" D DGRESTOBJ.SetHeader(DGHEADER,"application/json") RESTPOST+29 W - Vendor specific code is restricted.] S DGHTTPRSP=DGRESTOBJ.HttpResponse RESTPOST+41 W - Vendor specific code is restricted.] S DGOUTJSON=DGHTTPRSP.Data.ReadLine() ; reads json string response from the data stream. RESTPOST+42 W - Vendor specific code is restricted.] Routine: DGAUDIT1 ------------------ S DGERRCODE=DGRESPERR.code ERRSPMSG+4 W - Vendor specific code is restricted.] Patch Components: ----------------- Files & Fields Associated: N/A Forms Associated: N/A Mail Groups Associated: N/A Options Associated: N/A Protocols Associated: N/A Security Keys Associated: N/A Templates Associated: N/A Remote Procedures Associated: N/A Parameter Definitions Associated: Parameter Name Display Text ------------------------ -------------- DG VAS MAX QUEUE ENTRIES MAX ENTRIES IN DG VAS QUEUE (#46.3) Additional Information: New Service Requests (NSRs): ---------------------------- N/A Patient Safety Issues (PSIs): ----------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- N/A Test Sites: ---------- Tampa HCS, Tampa, FL Central Arkansas, Little Rock, AR Valley Coastal Bend, Harlingen, TX Test Sites - SNOW Change Orders: -------------------------------- Tampa HCS, Tampa: CHG0437651 Central Arkansas: CHG0437561 Valley Coastal Bend: CHG0437561 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. File Title File Name Format ---------------------------------------------------------------------- Deployment, Installation, Back-out DG_5_3_P1108_DIBRG.PDF BINARY And Rollback Guide DG_5_3_P1108_DIBRG.DOCX BINARY Release Notes DG_5_3_P1108_RN.PDF BINARY DG_5_3_P1108_RN.DOCX BINARY Patch Installation: ------------------- Pre/Post Installation Overview: 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. If desired, you may queue this installation. Installation Instructions (KIDS): --------------------------------- 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 [XPD MAIN] menu, select the Installation [XPD INSTALLATION MENU] menu. From this menu, A. Select the Verify Checksums in Transport Global option [XPD PRINT CHECKSUM] to confirm the integrity of the routines that are in the transport global. When prompted for the INSTALL NAME, enter the patch name, DG*5.3*1108. B. Select the Backup a Transport Global [XPD BACKUP] option to create a backup message. You can specify what to backup; the entire Build or just Routines. The backup message can be used to restore just the routines or everything that will restore your system to pre-patch condition. i. At the Installation option menu, select Backup a Transport Global ii. At the Select INSTALL NAME prompt, enter DG*5.3*1108. 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 [XPD PRINT INSTALL] - This option will allow you to view the components of the KIDS build. ii. Compare Transport Global to Current System [XPD COMPARE TO 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) [XPD INSTALL BUILD] option and choose the patch to install, DG*5.3*1108. i. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//', answer NO. ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer NO. iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', answer NO. Post-Installation Instructions: =============================== Successful installation can be verified by reviewing the first 2 lines of the routines contained in the patch. The second line will contain the patch number (1108) in the [PATCH LIST] section. The Calculate and Show Checksum Values [XTSUMBLD-CHECK] option can be run to compare the routine checksums to what is documented in the patch description. Use the Install File Print [XPD PRINT INSTALL FILE] option to verify the parameter definition was successfully updated. The output should include the text "Installing PARAMETER DEFINITION" followed by the date and time the parameter definition was updated. Back-Out/Roll Back Plan: ======================== Back-out will be done only with the concurrence and participation of the development team and appropriate VA site/region personnel. The decision to back-out or rollback software will be a joint decision between the development team, VA site/region personnel and other appropriate VA personnel. The site/region should save a backup of the build in a mail message using the Backup a Transport Global [XPD BACKUP] menu option (this is done at time of install). The back-out plan consists of installing the build backup. This will restore all patch components to their pre-patch state. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Registration;**[Patch List]**;Aug 13, 1993;Build 17 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: DGAUDIT Before:B140216692 After:B142099305 **964,1097,1108** Routine Name: DGAUDIT1 Before:B175068745 After:B177980402 **964,1097,1108** Routine Name: DGAUDIT2 Before: B29143746 After: B87959885 **964,1097,1108** Routine Name: DGAUDIT3 Before: B45954279 After: B47338805 **964,1108** Routine list of preceding patches: 1097 ============================================================================= User Information: Entered By : Date Entered : SEP 11, 2023 Completed By: Date Completed: JAN 08, 2024 Released By : Date Released : JAN 08, 2024 ============================================================================= Packman Mail Message: ===================== $END TXT