============================================================================= Run Date: DEC 17, 2021 Designation: ONC*2.2*13 Package : ONC - ONCOLOGY Priority: Mandatory Version : 2.2 SEQ #11 Status: Released Compliance Date: JAN 17, 2022 ============================================================================= Associated patches: (v)ONC*2.2*12 <<= must be installed BEFORE `ONC*2.2*13' Subject: NAACCR Metafile 21B and Software Updates Category: - Routine - Input Template - Print Template - Data Dictionary Description: ============ 1. This patch will update the software to the new North American Association of Central Cancer Registries (NAACCR) 21B Metafile and update the metafile on the OncServer to the NAACCR 21B version. The accompanying field changes will be updated to the record layouts in OncoTrax. This will include the new Birth Surname field in the Oncology Patient (#160) file and also several updates and data conversions to the Site Specific Data Item fields and files. 2. This patch will set all Site-Specific Data Item (SSDi) fields to Null if Primary Site field is changed. If the Primary Site field is changed for an abstract the software will re-initialize all of the SSDi fields to null; the same as would happen if the Histology is changed. This will prevent any SSDi field values to be inadvertently set for a different schema. There will be a display noting that these fields will be deleted. 3. This patch will fix the American Joint Commission on Cancer (AJCC) ID value for Oropharynx (p16-) cases. For certain Oropharynx (p16-) cases with Schema ID = 00111, the software was incorrectly calculating the value of '11' for the AJCC ID. The correct value of '11.1' will now be calculated. This will resolve any EDIT errors resulting from the incorrect AJCC ID. 4. This patch will remove SYMENC^MXMLUTL Kernel call from ONC code. The call to the Kernel utility SYMENC^MXMLUTL in the Oncology ONCSNACR routine, may be causing a problem by adding extra characters to the NAACCR Record Layout format. This is because it adds XML encoding which adds extra characters to the layout. This Kernel API call has been removed from routine ONCSNACR. 5. This patch will update the PA, EX, QA and MA reports This patch will update the Oncology Report options: 'Print Complete Abstract (132c)' [PA], 'Print Abstract-Extended (80c)' [EX], 'Print Abstract QA(80c)' [QA] and 'Print QA/Multiple Abstracts' [MA]. These print options have been updated by removing obsolete fields and adding new 2018+ fields to the displays. 6. This patch will update the Histology code lists according to NAACCR guidelines by updating the Oncology ICD-O-3 MORPHOLOGY file (#169.3) to include the latest Histology codes. Some are new or modified codes, and some are new terms for existing codes. 7. This patch will update Surgery Codes in Subsequent Treatment module 2018. This patch will address an issue where old Registry Operations and Data Standards (ROADS) codes were displaying for the Surgery of Primary Site (#165.51, .04) multiple in the Subsequent Course of Treatment (#165.5, 60) module. These codes will be updated to the correct values. 8. This patch will address Extent of Disease (EOD) 2.0 Updates. This patch will address some changes in the EOD 2.0 update from the Surveillance, Epidemiology, and End Results program (SEER) Staging website; including new codes for the EOD Primary Tumor, Regional Nodes and METS for 2021+ cases. 9. This patch will add 4 new COVID fields and new AJCC 9th Edition Staging fields. There are 4 new COVID related data items added to evaluate the impact of SARSCoV2 on cancer patients. The 4 new fields will be added to the Oncology Abstract. There are also new 9th Edition AJCC Staging for Cervix Uteri cases that require new staging fields. The 4 new COVID fields are listed below: NCDB-SARSCOV2-TEST (#165.5, 3943) NCDB-SARSCOV2-POSITIVE (#165.5, 3944) NCDB-SARSCOV2-POSITIVE DATE (#165.5, 3945) NCDB-SARSCOV2-COVID-19-TX-IMPACT (#165.5, 3946) 10. This patch will update the Lab-Casefinding list for 2021 codes by updating the 'Automatic Casefinding-Lab Search' [ONCO SUSPENSE-CASEFIND LAB] option to correspond with the FH2021 ICD-10-CM CASEFINDING LIST on the SEER website. The Lab-Casefinding will only include the Reportable codes from the list: https://seer.cancer.gov/tools/casefinding/ 11. This patch will fix Collaborative Stage and Bad Gateway Errors. It will address any remaining Collaborative Stage errors showing up on old cases and any sporadic Bad Gateway errors that may occur when trying to complete abstracts. PATCH COMPONENTS: ================= Routines: --------- ONC2PR13 ONC2PS13 ONCACD0 ONCACD1 ONCACDU1 ONCFUNC ONCGENED ONCOAIP2 ONCOCFP ONCOCFP1 ONCOCOF ONCOCRC ONCOCRF ONCODIS ONCODSP ONCODXD ONCOEOD1 ONCOPA1 ONCOPA1A ONCOPA2 ONCOPA2A ONCOPA4 ONCOPRT ONCOPRT1 ONCOSUR ONCOSUR2 ONCOTNS ONCOU55 ONCPAT ONCPDI ONCPSD ONCSCHM1 ONCSCHM3 ONCSCHMA ONCSCHME ONCSCHMG ONCSCHMH ONCSCHMM ONCSCHMP ONCSCHMS ONCSCHMT ONCSCHMU ONCSCHMX ONCSCHMZ ONCSGA8B ONCSGA8C ONCSGA8U ONCSNACR Files & Fields Associated: -------------------------- New/Modified/ File Name (#) Field Name (#) Deleted ------------- ------------------ ----------------- ONCOLOGY PATIENT (#160) BIRTH SURNAME (#71) New ONCOLOGY DATA EXTRACT FORMAT (#160.16) Modified FORMS/INSTRUCTIONS (#160.2) Modified ONCOLOGY GRADE TABLES (#164.44) Modified ONCOLOGY SCHEMA DISCRIMINATOR CODES (#164.47) Modified ONCO RADIATION TREATMENT MODALITY (#164.84) Modified ONCOLOGY PRIMARY (#165.5) GRADE POST THPY PATH (YP)(#24.5) Modified GRADE POST THPY CLIN (YC)(#24.6) New STAGE GROUPING-AJCC (#38.5) Modified DATE CASE COMPLETED (#90) Modified DATE CASE LAST CHANGED (#198) Modified NEOADJUVANT THERAPY (PRE 2021) (#245) Modified NEOADJUVANT THERAPY (#245.1) New NEOADJUVANT THERAPY-CLIN RESP (#245.2) New NEOADJUVANT THERAPY-TX EFFECT (#245.3) New TEXT-COVID-19 (#287) New FIGO STAGE (#3836) Modified LDH LEVEL (#3869) Modified LDH LAB VALUE (#3932) Modified VISCERAL PARIETAL PLEURAL INV (#3937) New ALK REARRANGEMENT (#3938) New EGFR MUTATIONAL ANALYSIS (#3939) New BRAF MUTATIONAL ANALYSIS (#3940) New NRAS MUTATIONAL ANALYSIS (#3941) New CA 19-9 PRETX LAB VALUE (#3942) New NCDB-SARSCOV2-TEST (#3943) New NCDB-SARSCOV2-POSITIVE (#3944) New NCDB-SARSCOV2-POSITIVE DATE (#3945) New NCDB-COVID19-TX IMPACT (#3946) New AJCC TNM CLIN STAGE GROUP (#5004) Modified AJCC TNM PATH STAGE GROUP (#5014) Modified AJCC TNM POST THERAPY (YP) T (#5021) Modified AJCC TNM POST THERAPY (YP) N (#5022) Modified AJCC TNM POST THERAPY (YP) M (#5023) Modified AJCC TNM POST THERAPY SG (YP) (#5024) Modified AJCC TNM POST THERAPY (YC) T (#5025) New AJCC TNM POST THERAPY (YC) T (#5026) New AJCC TNM POST THERAPY (YC) T (#5027) New AJCC TNM POST THERAPY SG (YC) (#5028) New AJCC TNM POST THRPY (YP) T SFX (#5033) Modified AJCC TNM POST THRPY (YC) T SFX (#5033.5) New AJCC TNM POST THRPY (YP) N SFX (#5036) Modified AJCC TNM POST THRPY (YC) N SFX (#5036.5) New ONCO AJCC STAGING CHAPTERS(#165.8) Modified ONCOLOGY EOD SCHEMAS (#165.9) Modified ONCO RESIDUAL TUMOR VOLUME (#167.5) Modified ONCO NEOADJUVANT THERAPY TREATMENT EFFECT (#167.6) Modified ICD-O-3 MORPHOLOGY (#169.3) Modified Forms Associated: ----------------- N/A Mail Groups Associated: ----------------------- N/A New/Modified/ Options Associated: Type Deleted ------------------- ---- ------------ ONCO RCRS EXTRACT Option Modified 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 ONCOY52 Print ONCOLOGY PRIMARY (#165.5) Modified ONCOY53 Print ONCOLOGY PRIMARY (#165.5) Modified ONCOY54 Print ONCOLOGY PRIMARY (#165.5) Modified ONCQA Print ONCOLOGY PRIMARY (#165.5) Modified ONCQA1 Print ONCOLOGY PRIMARY (#165.5) Modified ONCQA2 Print ONCOLOGY PRIMARY (#165.5) Modified ONCQA3 Print ONCOLOGY PRIMARY (#165.5) Modified ONCO DUE FOLLOWUP Print ONCOLOGY PRIMARY (#160) Modified ONCO DELINQUENT(LTF) LIST Print ONCOLOGY PRIMARY (#160) 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 Washington, DC VAMC Patch Installation: =================== Pre/Post Installation Overview: ------------------------------- There is both a pre- and a post-installation routine included in this patch which will run automatically when the patch is installed. The pre-install routine will delete the site-specific data item data files that will be brought back in with the patch installation. The post-install routine will run several data conversions required for the NAACCR 2021 updates, including Visceral Parietal Plueral Invasion data, Lacrimal Gland Grade data, Lymphoma Ocular Adnexa Grade data and FIGO Stage data. Routines ONC2PR13 and ONC2PS13 may optionally be deleted by the installer after the installation is complete. 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 ONC22P13.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/ONC22P13.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 -------------------------------------------------------------------------- ONC22P13.KID KIDS Build ASCII Oncology User Manual ONC_2_2_P13_UM.PDF Binary Oncology Technical Manual and Package Security Guide ONC_2_2_P13_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*13 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*13 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 7 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: ONC2PR13 Before: n/a After: B1659317 **13** Routine Name: ONC2PS13 Before: n/a After: B48679401 **13** Routine Name: ONCACD0 Before:B197624704 After:B199870574 **1,4,5,8,6,10,12,13** Routine Name: ONCACD1 Before: B70408549 After: B70610718 **1,4,5,8,9,13** Routine Name: ONCACDU1 Before: B64194905 After: B66448453 **1,4,7,5,10,12,13** Routine Name: ONCFUNC Before: B52220927 After: B82307203 **1,7,13** Routine Name: ONCGENED Before: B28576012 After: B28904470 **1,4,6,10,13** Routine Name: ONCOAIP2 Before:B130717759 After:B102767614 **1,4,5,6,10,12,13** Routine Name: ONCOCFP Before: B60703734 After: B58448307 **1,7,5,13** Routine Name: ONCOCFP1 Before: B85300341 After: B39437870 **7,10,13** Routine Name: ONCOCOF Before: B24341196 After: B26222206 **1,13** Routine Name: ONCOCRC Before: B12766110 After: B14874693 **1,13** Routine Name: ONCOCRF Before: B18529127 After: B20240965 **1,5,13** Routine Name: ONCODIS Before: B795057 After: B795101 **1,4,7,5,8,6,9,11,10,12,13** Routine Name: ONCODSP Before: B56361354 After: B55254124 **1,4,5,10,13** Routine Name: ONCODXD Before: B17370508 After: B18738510 **1,13** Routine Name: ONCOEOD1 Before: B16414168 After: B31213088 **10,13** Routine Name: ONCOPA1 Before: B63054675 After: B63994489 **1,5,6,9,10,12,13** Routine Name: ONCOPA1A Before: B93769167 After: B95121934 **1,6,10,12,13** Routine Name: ONCOPA2 Before: B66555080 After: B70958183 **1,5,10,12,13** Routine Name: ONCOPA2A Before: B21329973 After: B22062653 **1,11,12,13** Routine Name: ONCOPA4 Before: B541369 After: B605727 **12,13** Routine Name: ONCOPRT Before: B41401233 After: B45503925 **1,13** Routine Name: ONCOPRT1 Before: B71270764 After: B86977203 **1,7,10,13** Routine Name: ONCOSUR Before: B60090941 After: B61081741 **1,13** Routine Name: ONCOSUR2 Before: B55357665 After: B54000047 **1,10,13** Routine Name: ONCOTNS Before: B19790752 After: B26522464 **1,9,13** Routine Name: ONCOU55 Before: B38734462 After: B39976580 **1,10,12,13** Routine Name: ONCPAT Before: B79038942 After: B79645478 **1,13** Routine Name: ONCPDI Before: B7465905 After: B7745263 **1,13** Routine Name: ONCPSD Before: B18914581 After: B19802995 **1,6,9,10,12,13** Routine Name: ONCSCHM1 Before: B51800570 After: B51987537 **12,13** Routine Name: ONCSCHM3 Before: B84296076 After: B79473100 **12,13** Routine Name: ONCSCHMA Before:B134188048 After:B135311689 **10,12,13** Routine Name: ONCSCHME Before:B102239697 After:B112401222 **10,13** Routine Name: ONCSCHMG Before:B106863905 After:B110535833 **10,12,13** Routine Name: ONCSCHMH Before: B6484281 After: B7208983 **12,13** Routine Name: ONCSCHMM Before: B41447904 After: B65693551 **10,12,13** Routine Name: ONCSCHMP Before: B59014529 After: B60211985 **10,12,13** Routine Name: ONCSCHMS Before: B21992128 After: B26801081 **10,13** Routine Name: ONCSCHMT Before: B38607289 After: B39278658 **10,13** Routine Name: ONCSCHMU Before: B27105358 After: B35375937 **10,13** Routine Name: ONCSCHMX Before:B122586519 After:B124130340 **10,12,13** Routine Name: ONCSCHMZ Before:B103726906 After:B104843694 **12,13** Routine Name: ONCSGA8B Before:B182988531 After:B183011901 **10,12,13** Routine Name: ONCSGA8C Before: B28198292 After: B36599128 **10,12,13** Routine Name: ONCSGA8U Before: B1833018 After: B2999984 **10,12,13** Routine Name: ONCSNACR Before: B6005907 After: B5877899 **1,13** Routine list of preceding patches: 12 ============================================================================= User Information: Entered By : Date Entered : NOV 19, 2020 Completed By: Date Completed: DEC 17, 2021 Released By : Date Released : DEC 17, 2021 ============================================================================= Packman Mail Message: ===================== No routines included