$TXT Created by at DEVVCC.DOMAIN.EXT (KIDS) on Wednesday, 12/08/21 at 07:52 ============================================================================= Run Date: DEC 15, 2021 Designation: VIAB*1*23 Package : VIAB - VISTA INTEGRATION ADAPTOR Priority: Mandatory Version : 1 SEQ #22 Status: Released Compliance Date: JAN 06, 2022 ============================================================================= Associated patches: (v)YS*5.01*85 <<= must be installed BEFORE `VIAB*1*23' (v)SD*5.3*627 <<= must be installed BEFORE `VIAB*1*23' (v)YS*5.01*132 <<= must be installed BEFORE `VIAB*1*23' Subject: Add new RPC's to Web Services Option for Mental Health and Somnoware Category: - Routine Description: ============ Mobile Applications has two clients that require access to RPCs owned by the Mental Health and Visual Scheduling enhancement. VIA has obtained permission from the owning modules to add these to the VIAB WEB SERVICES option that will allow external clients to call these RPCs. This patch adds the RPCs to the VIAB WEB SERVICES option. ----------------- Files & Fields Associated: N/A Forms Associated: N/A Mail Groups Associated: N/A Options Associated: Option Name Type ----------- ---- VIAB WEB SERVICES Modified The following RPCs were added to this option YTQ ALL ANSWERS ICR 6678 YTQ CHOICES ICR 6673 YTQ GET SCALES ICR 6674 YTQ GET REPORT ICR 6675 YTQ QUESTALL ICR 6669 YTQ RULES ICR 6671 YTQ SAVE ADMIN ICR 6827 YTQ SCORE ADMIN ICR 6679 YTQ SCORE SAVE ICR 6680 YTQ SECTION ICR 6670 YTQ SET ANSWER ALL ICR 6677 YTQ SKIP ICR 6672 YTQ TSLIST1 ICR 6668 YTQ USERQ ICR 6667 YTQRRPC SELECT ICR 7260 YTQ PN CREATE ICR 6681 SDEC CHECKIN ICR 7067 SDEC CHECKOUT ICR 7069 SDEC CANCKOUT ICR 7073 Protocols Associated: N/A Security Keys Associated: N/A Templates Associated: N/A Remote Procedures Associated: Remote Procedure Name New/Modified/Deleted --------------------- -------------------- N/A Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- N/A Additional Information: ----------------------- New Service Requests (NSRs): Jira Max VAMFESS-105 Jira Max VAMFESS-194 Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: N/A Test Sites: ----------- North Texas VAMC Indianapolis VAMC Software and Documentation Retrieval Instructions: -------------------------------------------------- Documentation describing the new functionality and/or a host file containing a build may be included in this release. The preferred method is to retrieve the files from download.vista.domain.ext. This transmits the files from the first available server. Sites may also elect to retrieve the files directly from a specific server. Sites may retrieve the software and/or documentation directly using Secure File Transfer Protocol (SFTP) from the following URL: https://download.vista.domain.ext/index.html/SOFTWARE/ Documentation can also be found on the VA Software Documentation Library at: https://www.domain.ext/vdl/ Documentation Title File Name FTP Mode --------------------------------------------------------------------- N/A Host File Name FTP Mode --------------------------------------------------------------------- N/A Patch Installation: ------------------- Pre/Post Installation Overview: Pre-Installation Instructions: Please note that the install will post messages if the RPC is not found in your Site. You will need to install the appropriate patches for the RPCs if you see a message like this: Could not find the Remote Procedure . Not Added! Note the patch from the list below for the RPC in the message and contact the Mental Health Development Team(YS) or the Visual Scheduling Enhancement Development Team(SD) and obtain instructions from them on how to proceed. These are the patches associated with each RPC: YTQ ALL ANSWERS Modified YS*5.01*85 YTQ CHOICES Modified YS*5.01*85 YTQ GET SCALES Modified YS*5.01*85 YTQ GET REPORT Modified YS*5.01*85 YTQ QUESTALL Modified YS*5.01*85 YTQ RULES Modified YS*5.01*85 YTQ SAVE ADMIN New YS*5.01*132 YTQ SCORE ADMIN Modified YS*5.01*85 YTQ SCORE SAVE Modified YS*5.01*85 YTQ SECTION Modified YS*5.01*85 YTQ SET ANSWER ALL Modified YS*5.01*85 YTQ SKIP Modified YS*5.01*85 YTQ TSLIST1 Modified YS*5.01*85 YTQ USERQ Modified YS*5.01*85 YTQRRPC SELECT Modified YS*5.01*85 YTQ PN CREATE Modified YS*5.01*85 SDEC CHECKOUT Modified SD*5.3*627 SDEC CHECKIN Modified SD*5.3*627 SDEC CANCKOUT Modified SD*5.3*627 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. The VIAB WEB SERVICES Menu option does NOT need to be disabled. 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 VIAB*1.0*23. b. Note: This step can be skipped as this patch implements a new routine. 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 VIAB*1.0*23 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: Routines 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. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer NO. ii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', answer NO. e. During install, verify that all entries were updated successfully. If an error is displayed, please create a ServiceNow (SNOW) ticket. Post-Installation Instructions: ------------------------------- The install routine will auto delete, you do not have to remove it post install. Back-Out/Roll Back Plan: ------------------------ The VIAB WEB SERVICES option would require manual removal of any or all RPCs by using the XUMAINT Menu Management option. Example Screen: Select OPTION NAME: XUMAINT Menu Management Edit options Key Management ... Secure Menu Delegation ... Restrict Availability of Options Option Access By User List Options by Parents and Use Fix Option File Pointers Help Processor ... OPED Screen-based Option Editor Display Menus and Options ... Menu Rebuild Menu ... Out-Of-Order Set Management ... See if a User Has Access to a Particular Option Show Users with a Selected primary Menu Select Menu Management Option: EDIT options Select OPTION NAME: VIAB WEB SERVICES OPTION VIAB Web Services Option NAME: VIAB WEB SERVICES OPTION Replace MENU TEXT: VIAB Web Services Option Replace PACKAGE: VISTA INTEGRATION ADAPTER// OUT OF ORDER MESSAGE: LOCK: REVERSE/NEGATIVE LOCK: DESCRIPTION: This option is required by the Kernel Broker to give access to the RPCs used by the Vista Integration Adapter (VIA) team. Edit? NO// TYPE: Broker (Client/Server)// HEADER: ENTRY ACTION: EXIT ACTION: Select RPC: example: Select RPC: YTQ ALL ANSWERS ...OK? Yes// Y (Yes) RPC: YTQ ALL ANSWERS// @ The entry of the "@" symbol will result in the removal of the RPC from this option. Repeat the selection and deletion process for all subsequent Routine Information: ==================== The second line of each of these routines now looks like: ;;1.0;VISTA INTEGRATION ADAPTER;**[Patch List]**;28-OCT-2020;Build 11 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: VIAB1P23 Before: n/a After: B9194557 **23** ============================================================================= User Information: Entered By : Date Entered : NOV 09, 2020 Completed By: Date Completed: DEC 15, 2021 Released By : Date Released : DEC 15, 2021 ============================================================================= Packman Mail Message: ===================== $END TXT