$TXT Created by T at CLE623.FO-BAYPINES.DOMAIN.EXT (KIDS) on Thursday, 08/03/23 at 12:52 ============================================================================= Run Date: OCT 04, 2023 Designation: MAG*3*356 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #247 Status: Released Compliance Date: NOV 06, 2023 ============================================================================= Associated patches: (v)MAG*3*94 <<= must be installed BEFORE `MAG*3*356' (v)MAG*3*151 <<= must be installed BEFORE `MAG*3*356' Subject: TELEHEATH PROXY SERVICE - SITE SERVICE Category: - Routine Description: ============ Patch MAG*3.0*356 adds support to VistA for a distinct site service for the VA TeleReader Client. This enhancement will allow a simplified, more reliable and performant TeleReader Proxy Service. The TeleReader Proxy Service allows the VA TeleReader Client manage imaging studies sent from Cerner/EHRM supported sites to larger VistA supported medical centers. This enhancement makes no change in the VA TeleReader Client. Specifically, the patch: 1. adds a new parameter, MAG TELER SSERV URL, to hold the address of a distinct site service. A value is added for the parameter pointing to a VAEC-based service. 2. adds a setting to routine CHKVER in MAGGTU4. * this routine implements RPC "MAG4 VERSION CHECK". * the new setting is only applied when a user logs in using Access/Verify * it notes if the RPC is called by the VA TeleReader Client. 3. enhances how routine USERINF2 in MAGGTU3 returns the address of the site service * this routine implements RPC "MAGGUSER2" * return the address recorded in parameter MAG TELER SSERV URL in three situations * when a PIV based login identifies TeleReader Client in DUZ(REMAPP) * when a BSE based login identifies TeleReader Client in DUZ(REMAPP) * when an Access/Verify login from TeleReader Client is recorded in the MAGGTU4 upgrade 4. adds an RPC, MAG TELER UPDATES, for configuration discovery during site planning and go-lives 5. invokes a post install routine MAGIP356 to install and initialize the new parameter 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 --------------------- -------------------- MAGGUSER2 Modified (internally - no behavior change) MAG4 VERSION CHECK Modified (internally - no behavior change) MAG TELER UPDATES New Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- MAG TELER SSERV URL New Additional Information: New Service Requests (NSRs): ---------------------------- N/A Patient Safety Issues (PSIs): ----------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- N/A Test Sites: ----------- Boise VA Medical Center Louis Stokes VA Medical Center (Cleveland) SNOW Change Order Number: ------------------------- Boise: CHG0404859 Cleveland: CHG0405379 Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released using a host file. The host file is available at the following location: /srv/vista/patches/SOFTWARE/MAG3_0P356 File Title File Name --------------------------------------------------------------------- Kernel Installation and Distribution MAG3_0P356.KID System (KIDS) build for MAG*3.0*356 Documentation Title File Name --------------------------------------------------------------------- Patch Description for MAG*3.0*356 MAG3_0P356_Patch_Description.pdf Deployment, Installation, MAG3_0P356_DIBORG.pdf Back-Out, and Rollback Guide Patch Installation: ------------------- Supported Client Versions: -------------------------- MAG*3.0*356 does not affect the VA TeleReader Client. Any working version will continue to work unchanged. Pre/Post Installation Overview: ------------------------------- MAG*3.0*356 must be installed on the VistA System. This patch must be installed by the compliance date. 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. Note: All released VistA Imaging patches must be installed on the VistA system before installing MAG*3.0*356. Installation Instructions: -------------------------- 1. Use the Load a Distribution option contained on the Kernel Installation and Distribution System Menu to load the Host file. When prompted to "Enter a Host File:" enter /srv/vista/patches/SOFTWARE/MAG3_0P356.KID 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 (ex.). 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 MAG*3*356 iii. When prompted for the following, enter "R" for Routines or "B" for Build. Select one of the following: B Build R Routines Enter response: Build iv. When prompted "Do you wish to secure this message? NO//", press and take the default response of "NO". v. When prompted with, "Send mail to: Last name, First VistA Imaging TeleReader Configurator Client Installation Instructions. Post-Installation Instructions: ------------------------------- None Back-Out/Roll Back Plan: ------------------------ KIDS Uninstall: ---------------- If it is necessary to uninstall the MAG*3.0*356 VistA KIDS, the patch backup must be installed. The Kernel Installation & Distribution System menu option, Backup a Transport Global should have been used to create a patch backup of the build prior to installing the patch. (see Installation Steps section, step 2b). Administrators will need to check MailMan for the backup message sent by the Backup a Transport Global function executed prior to the patch install. The patch backup must first be loaded from the MailMan backup message, by performing the message action Xtract KIDS, followed by the PackMan function INSTALL/CHECK MESSAGE. The patch may then be installed using the Install Package(s) option in the KIDS Installation menu. 1. Navigate to the Mailman inbox containing the patch backup message. a. Select the MAG*3.0*356 backup message as shown below: * Backup of MAG*3.0*356 install on b. At the "Enter message action:" prompt, select the Xtract PackMan option. c. At the "Select PackMan function:" prompt, select the Install/Check Message option. d. Enter Yes at the prompt "OK to continue with Load?" 2. Navigate to the Kernel Installation and Distribution System Menu and select the Installation Menu. From this menu: a. Select the Install Package(s) option and choose the patch to install. 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. iv. When prompted 'Delay Install (Minutes): (0 - 60): 0//', answer 0. Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0;IMAGING;**[Patch List]**;Mar 19, 2002;Build 9 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: MAGGTU3 Before: B35227017 After: B38969238 **7,8,48,45,20,46,59,93,117,151,356** Routine Name: MAGGTU4 Before: B78532653 After: B80376737 **8,48,63,45,46,59,96,95,72, 93,94,356** Routine Name: MAGIP356 Before: n/a After: B6653397 **356** Routine Name: MAGTLRD Before: n/a After: B22028113 **356** Routine list of preceding patches: 94, 151 ============================================================================= User Information: Entered By : Date Entered : MAR 21, 2023 Completed By: Date Completed: OCT 03, 2023 Released By : Date Released : OCT 04, 2023 ============================================================================= Packman Mail Message: ===================== $END TXT