============================================================================= Run Date: APR 11, 2023 Designation: ONC*2.2*16 Package : ONC - ONCOLOGY Priority: EMERGENCY Version : 2.2 SEQ #14 Status: Released Compliance Date: APR 18, 2023 ============================================================================= Associated patches: (v)ONC*2.2*15 <<= must be installed BEFORE `ONC*2.2*16' Subject: Encryption of Oncology Interface Category: - Routine Description: ============ 1. This patch will utilize the VistA HealtheVet Web Services Client for Oncology interfaces. The VistA Oncology package will now utilize the HealtheVet Web Services Client to extend Cache's Objects web services functionality. This will allow VistA Oncology to make Hypertext Transfer Protocol (Secure) HTTP(S) encrypted connections from VistA to other platforms interfacing with VistA Oncology. PATCH COMPONENTS: ================= Routines: --------- ONC2PR16 ONC2PS16 ONCGENED ONCOAIP ONCODIS ONCSED01 ONCWEB1 *** NOTE *** %INDEX will return compiled list of errors and warnings for ONCWEB1. SAC EXEMPTION 202302071746-02 : non-ANSI standard M code has been submitted and approved. Files & Fields Associated: -------------------------- New/Modified/ File Name (#) Field Name (#) Deleted ------------- ------------------ ----------------- N/A Forms Associated: ----------------- N/A Mail Groups Associated: ----------------------- N/A New/Modified/ Options Associated: Type Deleted ------------------- ---- ------------ N/A Protocols Associated: --------------------- N/A Security Keys Associated: ------------------------- N/A Templates Associated: New/Modified Template Name Type File name (Number) Deleted --------------------- ---- ------------------ ------------ N/A Remote Procedures Associated: ----------------------------- N/A Parameter Definitions Associated: --------------------------------- N/A Additional Information: ----------------------- New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Test Sites: ----------- Albany, NY VAMC Durham, NC VAMC Washington, DC VAMC Patch Installation: =================== Pre/Post Installation Overview: ------------------------------- There are pre- and post- installation routines included in this patch which will run automatically when the patch is installed. The pre-install routine (ONC2PR16) will create the new web service "ONCO VACCR WEB SERVICE" and the new web server "ONCO WEB SERVER". The post-install routine (ONC2PS16) will set the correct URL for the ONC web server in the Oncology Site Parameters File #160.1. These pre- and post- install routines may optionally be deleted after installation. Installation instructions: -------------------------- This patch should be loaded with Oncology users off the system. Installation should take less than 5 minutes. The patch can be queued for installation. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - This patch is available as a Kernel Installation and Distribution System (KIDS) distribution file. The Host File is named ONC22P16.KID. 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/ONC22P16.KID Software being released as a host file and/or documentation describing the new functionality introduced by this patch are available through Forum. 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 and software include: Documentation Title File Name FTP Mode -------------------------------------------------------------------------- ONC22P16.KID KIDS Build ASCII Oncology User Manual ONC_2_2_P16_UM.PDF Binary Oncology Technical Manual and Package Security Guide ONC_2_2_P16_TM.PDF Binary 1. Load the KIDS distribution file via the 'Load a Distribution' option on the KIDS Installation menu. 2. Prior to installing the patch you may want to make use of the following optional installation options located on the KIDS Installation menu: a. Verify Checksums in Transport Global - This option will allow you to ensure the integrity of the routines that are in the transport global. 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. Backup a Transport Global - This option will 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 build name ONC*2.2*16 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 ************************NOTE************************************** For this install choose Build. 3. Install the KIDS distribution via the 'Install Package(s)' option on the KIDS Installation menu. a. When prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//' Answer NO. b. When prompted 'Want KIDS to INHIBIT LOGONS during the install' NO//' Answer NO. c. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//' Answer NO. Back out/Rollback Plan ---------------------- Backout of this patch will be performed only with the concurrence and participation of the appropriate VA site/region personnel. The decision to back out the patch will be a joint decision between VA site/region personnel and other appropriate VA personnel. Prior to installing the updated KIDS package, the site/region should have saved a backup of the routines in a mail message using the Backup a Transport Global [XPD BACKUP] menu option. The message containing the backed up routines can be loaded with the "Xtract PackMan" function at the Message Action prompt. The PackMan function INSTALL/CHECK MESSAGE is then used to install the backed-up routines onto the VistA system. Note: In the event that a site decides to back out this patch, the site should contact the National Service Desk (NSD) to submit an IT Service Desk ticket. The development team will then assist with the backout process and restoration of the DD and Input Template. Validation of Backout Procedure of the Routines: ----------------------------------------------- The Backout procedure can be verified by printing the first two lines of the ONC routines contained in this patch using the option First Line Routine Print [XU FIRST LINE PRINT]. Once the ONC routines have been backed out, the first two lines of the routines will no longer contain the designation of patch ONC*2.2*16 on line 2 in the patch list section. Routine Information: ==================== The second line of each of these routines now looks like: ;;2.2;ONCOLOGY;**[Patch List]**;Jul 31, 2013;Build 5 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: ONC2PR16 Before: n/a After: B5260407 **16** Routine Name: ONC2PS16 Before: n/a After: B230400 **16** Routine Name: ONCGENED Before: B28904470 After: B28904592 **1,4,6,10,13,16** Routine Name: ONCOAIP Before:B132444231 After:B132498603 **1,4,5,6,10,15,16** Routine Name: ONCODIS Before: B795189 After: B795233 **1,4,7,5,8,6,9,11,10,12,13, 14,15,16** Routine Name: ONCSED01 Before: B13507255 After: B14486628 **1,16** Routine Name: ONCWEB1 Before: n/a After: B11835919 **16** Routine list of preceding patches: 15 ============================================================================= User Information: Entered By : Date Entered : JAN 19, 2023 Completed By: Date Completed: APR 10, 2023 Released By : Date Released : APR 11, 2023 ============================================================================= Packman Mail Message: ===================== No routines included