$TXT Created by ADM1S1.AAC.DOMAIN.EXT (KIDS) on Thursday, 02/22/18 at 07:27 ============================================================================= Run Date: JUN 18, 2018 Designation: VIAA*1*6 Package : VIAA - REAL TIME LOCATION SYSTEM Priority: Mandatory Version : 1 SEQ #6 Status: Released Compliance Date: JUL 19, 2018 ============================================================================= Associated patches: (v)VIAA*1*3 <<= must be installed BEFORE `VIAA*1*6' Subject: AbovePAR - SYNTACTICALLY INCORRECT ERROR Category: - Routine Description: ============ This patch addresses one issue about a syntactically incorrect error occurring in the interface with the EQUIPMENT INV. (#6914) file via the Document Support System (DSS) Graphical User Interface (GUI) AbovePAR (APAR) system. Patch Components: ----------------- ROUTINE VIAATRI 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. I18190635FY18 - Error CRITICAL (0) The IENS '-1' is syntactically incorrect Problem: -------- The AbovePAR Graphical User Interface (GUI) program is designed to provide functionality in parallel with Automated Engineering Management System /Medical Equipment Reporting System (AEMS/MERS) to update the medical equipment database EQUIPMENT INV. (#6914) file. Triggers on the fields in the EQUIPMENT INV. (#6914) file run a routine WC^VIAATRI to update the PENDING RTLS EVENTS (#6930) file. This process was failing and causing a hard error that was preventing APAR from updating both the EQUIPMENT INV. (#6914) and PENDING RTLS EVENTS (#6930) files. Resolution: ----------- A conditional quit is added between the calls to FILE^DICN and UPDATE^DIE in trigger routine WC^VIAATRI. This prevents a syntax error from occurring when the returned value from the failed FILE^DICN update is a -1. Technical: ---------- When triggers on the ENTRY NUMBER (#.01) field fire, they call routine WC^VIAATRI from the EQUIPMENT INV. (#6914) file. When this routine is called it checks the PENDING RTLS EVENTS (#6930) file to see if the entry is already there, and if it is not then routine makes a call to FILE^DICN to add the entry as a stub. After this it calls UPDATE^DIE to complete the entry. If FILE^DICN fails it submits a negative 1 value to UPDATE^DIE as a record internal entry number (IEN). The failure results in a syntax error that causes a number of changes to FileMan variables that force termination of the update. The syntax error is returned to the remote procedure call (RPC) called by APAR. Trigger firing precedence seems to be the root cause of persistent failure, so this prevents AbovePAR from submitting records. Test Sites: ----------- Durham VA Medical Center Jack C. Montgomery VA Medical Center (Muskogee) VA Boston Health Care System (Boston, Brockton, West Roxbury) Software and Documentation Retrieval Instructions: -------------------------------------------------- N/A Patch Installation: Pre/Post Installation Overview: ------------------------------- No install routines, No special instructions. Pre-Installation Instructions: ------------------------------ N/A Installation Instructions: -------------------------- This patch can be loaded with users in the system. Installation time will be less than 2 minutes. 1. Choose the PackMan message containing this patch and invoke the INSTALL/CHECK MESSAGE PackMan option. 2. Start up the Kernel Installation and Distribution System Menu [XPD MAIN]: Edits and Distribution ... Utilities ... Installation ... Select Kernel Installation & Distribution System Option: Installation 1 Load a Distribution 2 Verify Checksums in Transport Global 3 Print Transport Global 4 Compare Transport Global to Current System 5 Backup a Transport Global 6 Install Package(s) Restart Install of Package(s) Unload a Distribution 3. From this menu, you may elect to use the following options (When prompted for the INSTALL NAME, enter "VIAA*1.0*6"): 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 DD's 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, DD's, 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. Use the Install Package(s) option and select the package. a. When prompted "Want KIDS to INHIBIT LOGONs during the install? NO//", answer NO. b. When prompted "Want to DISABLE Scheduled Options and Menu Options and Protocols? NO//", answer NO. Post-Installation Instructions: ------------------------------- N/A Back-Out Plan: -------------- This patch can be backed out by installing the backup made in Step 3) of the Installation Instructions above. Routine Information: ==================== The second line of each of these routines now looks like: ;;1.0;RTLS;**[Patch List]**;April 22, 2013;Build 1 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: VIAATRI Before: B2232416 After: B2514239 **3,6** Routine list of preceding patches: 3 ============================================================================= User Information: Entered By : Date Entered : JAN 26, 2018 Completed By: Date Completed: JUN 18, 2018 Released By : Date Released : JUN 18, 2018 ============================================================================= Packman Mail Message: ===================== $END TXT