$TXT Created by DEVCRN.DOMAIN.EXT (KIDS) on Wednesday, 10/06/21 at 11:24 ============================================================================= Run Date: DEC 02, 2021 Designation: XU*8*757 Package : XU - KERNEL Priority: Mandatory Version : 8 SEQ #598 Status: Released Compliance Date: JAN 02, 2022 ============================================================================= Associated patches: (v)XOBW*1*4 <<= must be installed BEFORE `XU*8*757' Subject: KERNEL VISTA ENHANCEMENT - MPI WEB SERVICES FOR VISTA-LIKE SYSTEMS Category: - Enhancement (Mandatory) - Routine - Other Description: ============ ************************************************************************* * Local installation tools should NOT be used to install this patch! * * The patch description and installation guide for this patch MUST * * be read and completely understood before any attempt is made to begin * * installation on 'VistA-Like' systems. * ************************************************************************* XOBW*1.0*4 is the ONLY required build for patch XU*8.0*757. NOTE: VistA-Like sites should refer to the install guide for complete installation instructions. A "VistA-Like" system is a VistA system that is NOT fully patched with all packages, but mainly consists of just the infrastructure type patches. Examples of these systems include: - FORUM - HAC (Health Administration Center) - HEC (Health Eligibility Center) - IFCAP (Integrated Funds Control Accounting and Procurement) - CMOP (Consolidated Mail Outpatient Pharmacy). For regular VistA systems that have already installed the MASTER PATIENT INDEX VISTA (MPIF) patch MPIF*1.0*63, the installation instructions below can be followed as the Web Service connection already exists and is properly configured! The following enhancement exported in this patch is needed to support the use of the Master Veteran Index (MVI) / Person Service Identity Management (PSIM) Web Services for 'VistA-Like' systems. Enhancement Upon release of patches XOBW*1.0*4 and MPIF*1.0*63 several years ago, VistA systems received secure communication access to the MVI/PSIM Web Service. However, it has now been determined that VistA-Like systems that do NOT install the Master Patient Index VistA (MPIF) patches also need access to this same Web Service. Therefore, MVI has created this patch to allow these VistA-Like systems to install/configure and execute the PSIM Web Service without having to install the MPIF patches. The required routine (XUMPIWSC) and the Remote Procedure Call (RPC) [MPI VISTA HWS CONFIG] have been copied from the existing MPIF functionality to support the secure Hypertext Transport Protocol Secure (HTTPS) communications with PSIM to these other systems. Finally, for these additional systems, the post-initialization process will create the required WEB SERVICE (#18.02) and WEB SERVER (#18.12) entries if they do NOT exist. NOTE: Existing VistA systems which already have patch MPIF*1.0*63 installed will NOT notice anything different and NO additional configuration changes will be required as the Web Service is already setup and working properly. 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 --------------------------- -------------------- MPI VISTA HWS CONFIG New (VistA-Like Systems) Modified (VistA Systems - Released in MPIF*1.0*63) Parameter Definitions Associated: Parameter Name New/Modified/Deleted --------------------------- -------------------- N/A Additional Information: Blood Bank Team Coordination ---------------------------- EFFECT ON BLOOD BANK FUNCTIONAL REQUIREMENTS: Patch XU*8.0*757 contains changes to a package referenced in Process Asset Library standard titled: BBM Team Review of VistA Patches. This patch does not alter or modify any VistA Blood Bank software design safeguards or safety critical elements functions. RISK ANALYSIS: Changes made by patch XU*8.0*757 have no adverse effect on Blood Bank software functionality, therefore RISK is none. New Service Requests (NSRs) ---------------------------- N/A Patient Safety Issues (PSIs) ----------------------------- N/A Defect Tracking System Ticket(s) & Overview ------------------------------------------- N/A Test Sites: ----------- Minneapolis VAMC (Minneapolis MN) Texas Valley Coastal Bend HCS (Harlingen TX) 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 ------------------------------------------------------------------ Web Service Description VISTAWEBSERVICE.WSDL (ASCII) Language (WSDL) XU*8.0*757 Install Guide XU_80_757IG.PDF (BINARY) Patch Installation: Environment Check ----------------- ENV^XUMPIWSC - This environment check will execute to ensure the proper placement of the VISTAWEBSERVICE.WSDL file is complete prior to allowing this patch to be installed on 'VistA-Like' systems. Note: The VISTAWEBSERVICE.WSDL file must be available in the Default Directory for HOST File Systems (HFS), as stated in the KERNEL SYSTEM PARAMTER (#8989.3) file, else the patch will not install on these 'VistA-Like' systems. NOTE: The environment check will NOT be executed for regular VistA systems that have already installed the MASTER PATIENT INDEX VISTA patch MPIF*1.0*63. VistA-Like systems should reference the install guide for additional installation information. Pre/Post Installation Overview ------------------------------ A post-install program will be executed as the last step of the patch installation process to create the WEB SERVICE (#18.02) and WEB SERVER (#18.12) file entries to support the transfer of PII information using HTTPS communications to PSIM if needed. The post-install process will be part of the installation process rather than tasked, so the patch install log rather than a separate MailMan message will include the post-install results. NOTE: The post-install process will NOT be executed for regular VistA systems that have already installed the MASTER PATIENT INDEX VISTA patch MPIF*1.0*63, as the Web Server and Service are already installed and configured. Pre-Installation Instructions ----------------------------- This patch takes less than 2 minutes to install. This patch may be installed with users on the system. VistA-Like systems should reference the install guide for additional installation information. Installation Instructions ------------------------- NOTE: VistA-Like systems should reference the Installation Guide (XU_80_757IG.PDF) for complete installation instructions. For regular VistA systems that have already installed the MASTER PATIENT INDEX VISTA (MPIF) patch MPIF*1.0*63, the following installation instructions can be followed: 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. (ex. XU*8.0*757) 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 XU*8.0*757 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 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. 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 ------------------------------ NOTE: VistA-Like systems should reference the Installation Guide (XU_80_757IG.PDF) for complete installation instructions. For regular VistA systems that have already installed the MASTER PATIENT INDEX VISTA (MPIF) patch MPIF*1.0*63, there are NO post installation processes to execute. Back-Out Plan ------------- The XU patch backout procedure would consist of deleting the new RPC and routine using the back-up message created during the patch installation. The created entries in the WEB SERVICE (#18.02) and WEB SERVER (#18.12) files can either be deleted or left in place as they will cause no harm. If assistance is still required to back-out the patch please contact the National Service Desk (NSD) to log a help desk ticket so the development team can assist in the process. Note: This process should only be done with the concurrence and participation of the development team and the appropriate VA Site/Region personnel. Routine Information: ==================== The second line of each of these routines now looks like: ;;8.0;KERNEL;**[Patch List]**;Jul 10, 1995;Build 2 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: XUMVIWSC Before: n/a After: B19746353 **757** ============================================================================= User Information: Entered By : Date Entered : SEP 07, 2021 Completed By: Date Completed: NOV 22, 2021 Released By : Date Released : DEC 02, 2021 ============================================================================= Packman Mail Message: ===================== $END TXT