============================================================================= Run Date: JUN 27, 2023 Designation: ONC*2.2*17 Package : ONC - ONCOLOGY Priority: EMERGENCY Version : 2.2 SEQ #15 Status: Released Compliance Date: JUN 29, 2023 ============================================================================= Associated patches: (v)ONC*2.2*16 <<= must be installed BEFORE `ONC*2.2*17' Subject: NAACCR 2022 FIELD AND METAFILE UPDATES Category: - Routine - Input Template - Data Dictionary Description: ============ 1. This patch will implement the NAACCR 2022 updates and EDITs metafile The patch will implement the NAACCR 2022 field updates and the v22b EDITs metafile. These changes are based on the NAACCR 2022 Implementation Guide. 2. This patch will include new gynecological fields and data conversion This patch will add 4 new Site-Specific Data Item (SSDi) fields to the Cervix, Vulva and Vagina schemas for 2022+ cases. It will also remove 3 obsolete fields and include a conversion of existing data. 3. This patch will update the histology codes in the ICDO TOPOGRAPHY (#164) file The patch will add 50+ new histology/morphology codes to the ICDO TOPOGRAPHY (#164) file, so that these codes are selectable in the ONCOLOGY Abstract when abstracting cases. 4. This patch will include two new rolling follow-up selections in Follow-Up reports The patch will update the Follow-Up reports to allow two new follow up report choices: 15 Year Follow-Up Rate For All Patients and 5 Year Follow-Up Rate For Recent Patients. These reports are based on specifications in the Commission on Cancer (COC) Long Term Follow-Up Vendor Specifications. 5. This patch will fix several typos and minor default corrections The patch will correct two XML field value typos and also remove the incorrect default values for TYPE OF FIRST RECURRENCE field in the ONCOLOGY PRIMARY file (#165.5) and SPANISH ORIGIN (#9) field in the ONCOLOGY PATIENT file (#160). The patch will also no longer allow 99's in the DATE OF LAST CONTACT (#16) field of the ONCOLOGY PATIENT file (#160). There were also several typos in the SSDi code descriptions for liver and lung schemas. 6. This patch will fix a calculation issue for STAGE GROUPING-AJCC calculation This patch will fix an issue in the STAGE GROUPING-AJCC field (#38.5) of the ONCOLOGY PRIMARY file (#165.5), where the calculation was not working for cases with no staging (88 or 99 staging values). The issue has been fixed and a data conversion will run which will correctly set the value of this field for 2018+ cases. 7. This patch will add a new Tobacco field and convert Tobacco History values The patch will add a new field called TOBACCO USE SMOKING STATUS (#288) in the ONCOLOGY PRIMARY file (#165.5) to the ONCOLOGY Abstract and use the values in the existing TOBACCO HISTORY field (#38) in the ONCOLOGY PATIENT file (#160) to fill in the values for the new field. 8. This patch will remove the ability to add physician contacts without a National Provider Index (NPI) number This patch will no longer allow new physician contacts to be added in the ONCOLOGY Abstract at the PRIMARY SURGEON (#2), FOLLOWING PHYSICIAN (#2.1), MANAGING PHYSICIAN (#2.2), PHYSICIAN 3 (#2.3) and PHYSICIAN 4 (#2.4) field prompts in the ONCOLOGY PRIMARY file (#165.5). This will eliminate the ability to add a physician contact without adding an NPI value. Physician contacts may still be added in the "Add Patient Contact" option. 9. This patch will remove several obsolete fields from the required fields list This patch will remove several fields from the list of required fields to complete an abstract. These fields are obsolete and no longer needed to complete a case. The patch will also remove date flag fields from the abstract for 2022+ cases. 10. This patch correct an issue with the Accession/Sequence number for new cases This patch will fix an issue in the code to calculate the Accession/Sequence number for new primaries created at a multi-divisional site. This field was not updating properly at multi-divisional sites because it was missing a check on the Division field. 11. This patch will add two new alpha-numeric Surgery fields for 2022+ cases This patch will add two new fields for 2022+ cases: RX HOSP-SURG PRIM SITE 2023 (#58.8) and RX SUMM-SURG PRIM SITE 2023 (#58.9) in the ONCOLOGY PRIMARY file (#165.5). These fields will be located in the ONCOLOGY abstract for 2022+ cases. PATCH COMPONENTS: ================= Routines: --------- ONC2PR17 ONC2PS17 ONCACD0 ONCACD1 ONCACDU1 ONCGENED ONCOAI ONCOAIF ONCOAIM ONCOAIP2 ONCOAIS ONCOCFP1 ONCOCFR ONCOCOF ONCODIS ONCODSP ONCOEDC1 ONCOEDC2 ONCOFLF ONCOPRT1 ONCOU55 ONCPAT ONCPM ONCSCHM0 ONCSCHM1 ONCSCHM2 ONCSCHM3 ONCSCHMA ONCSCHMC ONCSCHME ONCSCHMM ONCSCHMT ONCSCHMU ONCSCHMX ONCSCHMY ONCSCHMZ ONCSGA8A ONCSGA8H Files & Fields Associated: -------------------------- New/Modified/ File Name (#) Field Name (#) Deleted ------------- ------------------ ------------- ONCOLOGY PATIENT (#160) 160.04, .01 MODIFIED ONCOLOGY SITE PARAMETERS (#160.1) 71 MODIFIED ONCOLOGY DATA EXTRACT FORMAT (#160.16) (data) MODIFIED FORMS/INSTRUCTIONS (#160.2) (data) MODIFIED ONCOLOGY GRADE TABLES (#164.44) (data) MODIFIED RACE CODE FOR ONCOLOGY (#164.46) (data) MODIFIED ONCOLOGY CONTACT (#165) 101 MODIFIED ONCOLOGY PRIMARY (#165.5) 2,2.1,2.2,2.3,2.4, MODIFIED 58.8,58.9,288,3811,3885,3933 MODIFIED ONCOLOGY AJCC STAGING CHAPTERS (#165.8) (data) MODIFIED ONCOLOGY EOD SCHEMAS (#165.9) (data) MODIFIED ICD-O-3 MORPHOLOGY (#169.3) (data) MODIFIED Forms Associated: ----------------- N/A Mail Groups Associated: ----------------------- N/A New/Modified/ Options Associated: Type Deleted ------------------- ---- ------------ ONCO UPDATE PHYSICIAN CONTACTS RUN NEW ONCO UTIL MENU MENU MODIFIED Protocols Associated: --------------------- N/A Security Keys Associated: ------------------------- N/A Templates Associated: New/Modified Template Name Type File name (Number) Deleted --------------------- ---- ------------------ ------------ ONCO ABSTRACT-I INPUT ONCOLOGY PRIMARY (165.5) MODIFIED ONCO RECURRENCE FOLLOWUP INPUT ONCOLOGY PRIMARY (165.5) MODIFIED 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 Long Beach, CA 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. 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 ONC22P17.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/ONC22P17.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 -------------------------------------------------------------------------- ONC22P17.KID KIDS Build ASCII Oncology User Manual ONC_2_2_P17_UM.PDF Binary Oncology Technical Manual and Package Security Guide ONC_2_2_P17_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*17 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*17 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 6 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: ONC2PR17 Before: n/a After: B2354279 **17** Routine Name: ONC2PS17 Before: n/a After: B20729781 **17** Routine Name: ONCACD0 Before:B200560464 After:B201405363 **1,4,5,8,6,10,12,13,14,15,17** Routine Name: ONCACD1 Before:B147907104 After:B147907204 **1,4,5,8,9,13,14,15,17** Routine Name: ONCACDU1 Before: B82824172 After: B83474237 **1,4,7,5,10,12,13,14,17** Routine Name: ONCGENED Before: B28904592 After: B29181687 **1,4,6,10,13,16,17** Routine Name: ONCOAI Before: B28755753 After: B31209323 **1,17** Routine Name: ONCOAIF Before: B63074237 After: B62877726 **1,4,5,6,17** Routine Name: ONCOAIM Before: B23324938 After: B29627911 **1,4,15,17** Routine Name: ONCOAIP2 Before:B102767614 After:B106214732 **1,4,5,6,10,12,13,17** Routine Name: ONCOAIS Before: B7372604 After: B7710295 **1,10,17** Routine Name: ONCOCFP1 Before: B55050272 After: B50843106 **7,10,13,14,17** Routine Name: ONCOCFR Before: B30967942 After: B46725969 **1,17** Routine Name: ONCOCOF Before: B26222206 After: B32104221 **1,13,17** Routine Name: ONCODIS Before: B795233 After: B795277 **1,4,7,5,8,6,9,11,10,12,13, 14,15,16,17** Routine Name: ONCODSP Before: B55254124 After: B63725869 **1,4,5,10,13,17** Routine Name: ONCOEDC1 Before: B51296770 After: B50967345 **1,5,6,10,12,15,17** Routine Name: ONCOEDC2 Before: B25682871 After: B33569749 **10,12,17** Routine Name: ONCOFLF Before: B17881251 After: B42370823 **1,17** Routine Name: ONCOPRT1 Before:B110272002 After:B110376474 **1,7,10,13,14,17** Routine Name: ONCOU55 Before: B39532065 After: B42030639 **1,10,12,13,15,17** Routine Name: ONCPAT Before: B79645478 After: B79205412 **1,13,17** Routine Name: ONCPM Before: B7795122 After: B8216074 **1,17** Routine Name: ONCSCHM0 Before: B85521140 After: B87834093 **12,17** Routine Name: ONCSCHM1 Before: B51987537 After: B51856632 **12,13,17** Routine Name: ONCSCHM2 Before: B50332378 After:B106111424 **12,17** Routine Name: ONCSCHM3 Before: B79473100 After: B80912649 **12,13,17** Routine Name: ONCSCHMA Before:B135311689 After:B144074488 **10,12,13,17** Routine Name: ONCSCHMC Before: B75147879 After: B76552802 **10,12,15,17** Routine Name: ONCSCHME Before:B112401222 After:B124673837 **10,13,17** Routine Name: ONCSCHMM Before: B69068028 After: B70948382 **10,12,13,15,17** Routine Name: ONCSCHMT Before: B40642848 After: B40925751 **10,13,15,17** Routine Name: ONCSCHMU Before: B68776825 After: B81887776 **10,13,14,15,17** Routine Name: ONCSCHMX Before:B124130340 After:B125691230 **10,12,13,17** Routine Name: ONCSCHMY Before:B111698219 After:B111836779 **10,12,17** Routine Name: ONCSCHMZ Before:B104843694 After:B118505436 **12,13,17** Routine Name: ONCSGA8A Before:B180053400 After:B180099360 **10,12,17** Routine Name: ONCSGA8H Before: B23394802 After: B23486231 **10,12,17** Routine list of preceding patches: 16 ============================================================================= User Information: Entered By : Date Entered : APR 20, 2023 Completed By: Date Completed: JUN 26, 2023 Released By : Date Released : JUN 27, 2023 ============================================================================= Packman Mail Message: ===================== No routines included