============================================================================= Run Date: OCT 18, 2022 Designation: ONC*2.2*15 Package : ONC - ONCOLOGY Priority: Mandatory Version : 2.2 SEQ #13 Status: Released Compliance Date: NOV 18, 2022 ============================================================================= Associated patches: (v)ONC*2.2*14 <<= must be installed BEFORE `ONC*2.2*15' Subject: NAACCR 2022 FIELDS AND UPDATES Category: - Data Dictionary - Input Template - Routine Description: ============ 1. This patch will include new Site Specific Data Item (SSDi) Fields and updates required for NAACCR 2022. The Oncology Abstract will include 4 new SSDi fields for Cervix, Vagina and Vulva cases. The new SSDi fields are P16 (#165.5,#3956), LN STATUS PELVIC (#165.5,#3957), LN PARA-AORTIC (#165.5,#3958) and LN FEMORAL- INGUINAL (#165.5,#3959). The patch will also add 4 new custom data items for Breast cases. The new custom fields are RX HOSP--SURG BREAST (#165.5, #10104), RX SUMM--SURG BREAST (#165.5,#10105), RX HOSP--RECON BREAST (#165.5, #101016) and RX SUMM--RECON BREAST (#165.5,#10107). Also several codes (11,13,14,21,23,24,25) will be removed from the site specific surgery codes for Colon, Anus, Rectum and Rectosigmoid cases. The new MACROSCOPIC EVAL OF MESORECTUM (#165.5,#3950) field will be added for C20.9 cases. 2. This patch will add new codes to several Extent Of Disease (EOD) and Site Specific Data Item fields. Bladder cases will include a new code 50 in the EOD Mets at DX field. Lymphoma cases will include a new code 750 in the EOD Primary Tumor field. Also the CA 19-9 Pre TX Lab Value for Pancreas cases and the PSA Lab Value for Prostate cases will add XXXX.2 and XXXX.3 codes. The Sarcomatoid Features field for Kidney Paranchyma cases will add Code XX5 and HER2 Overall Summary field for Esophagus cases will add Code 8. Code 5 will be added for five SSDi fields for Lymphoma CLL/SLL Cases and code 5 will also be added to four SSDi fields for Plasma Cell Myeloma cases. 3. This patch will include corrections for several Classification of Malignant Tumor (TNM) Edition number issues. Some Schema 00421 and Schema 00770 cases will have the value of the TNM Edition number calculation corrected from '88' to '08'. 4. This patch will include a Schema ID calculation correction. The patch will correct an erroneous Schema ID calculation for 'C10.0' cases with Histology of 8071/3. 5. This patch will remove several obsolete warnings when completing a case. This patch will remove the warning 'Laterality must be 0 (not a paired site)' for C44.4 melanoma cases, when completing the case. This patch will also remove the warning 'First Course of Treatment Date = 00/00/0000, Class of Case must be 38'. 6. This patch will correct issues in the Oncology Casefinding reports. The Radiology Casefinding module will remove the word 'Suspicious' from the search criteria and the terms/text strings will be updated. 7. This patch will contain updates to the XML (eXtensible Markup Language) Extract reports. The State Report will have some corrections to XML file errors. This patch will also remove the special character "?" from XML extracts and will correct the Recurrence Type First error (00 instead of original value). 8. This patch will update the RCRS Report dates. The Rapid Cancer Reporting System report option will now include cases going back to 2006, instead of 2008. 9. This patch will require more data fields to be entered before accessioning a case. The Add Another Primary option under the Complete Abstract menu will now require 5 fields to be entered before a new primary will be created/saved. Previously only PRIMARY SITE (#165.5,#20) was required, but now the following fields will also be required: CLASS OF CASE (#165.5,#.04), DATE OF FIRST CONTACT (#165.5,#155), DATE DX (#165.5,#3), PRIMARY SITE (#165.5, #20) and CASEFINDING SOURCE (#165.5,#21). PATCH COMPONENTS: ================= Routines: --------- ONC2PR15 ONC2PS15 ONCACD0 ONCACD1 ONCDTX ONCEDIT ONCNTX ONCNTX1 ONCOAIC ONCOAIM ONCOAIP ONCOCFL1 ONCOCOM ONCODIS ONCODSR ONCOEDC1 ONCOPA2 ONCOSUR ONCOSUR1 ONCOU55 ONCPTX ONCSCHMC ONCSCHMM ONCSCHMT ONCSCHMU ONCUTX1 Files & Fields Associated: -------------------------- New/Modified/ File Name (#) Field Name (#) Deleted ------------- ------------------ ----------------- ONCOLOGY DATA EXTRACT FORMAT (#160.16) Data only ICDO TOPOGRAPGHY (#164) Data only ONCOLOGY PRIMARY (#165.5) CLASS OF CASE (#.04) Modified DATE DX (#3) Modified CASEFINDING SOURCE (#21) Modified SCOPE OF LN SURGERY DATE (#138.2) Modified SCOPE OF LN SURGERY @FAC DATE (#138.3) Modified LYMPH-VASCULAR INVASION (L) (#149) Modified DATE OF FIRST CONTACT (#155) Modified RX HOSP--SURG APP 2010 (#234) Modified ADENOPATHY (#3804) Modified ANEMIA (#3811) Modified HER2 OVERALL SUMMARY (#3855) Modified HIGH RISK CYTOGENETICS (#3857) Modified LDH LEVEL (#3869) Modified LYMPHOCYTOSIS (#3885) Modified ORGANOMEGALY (#3907) Modified PSA LAB VALUE (#3920) Modified SARCOMATIOD FEATURES (#3925) Modified SERUM ALBUMIN PRETREAT VALUE (#3930) Modified SERUM BETA-2 MICROGLOBULIN (#3931) Modified THROMBOCYTOPENIA (#3933) Modified CA 19-9 PRETX LAB VALUE (#3942) Modified MACROSCOPIC EVAL OF MESORECTUM (#3950) New DERIVED RAI STAGE (#3955) New P16 (#3956) New LN STATUS PELVIC (#3957) New LN STATUS PARA-AORTIC (#3958) New LN STATUS FEMORAL-INGUINAL (#3959) New RX HOSP--SURG BREAST (#10104) New RX SUMM--SURG BREAST (#10105) New RX HOSP--RECON BREAST (#10106) New RX SUMM--RECON BREAST (#10107) New ONCOLOGY EOD SCHEMAS (#165.9) Data only 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 --------------------- ---- ------------------ ------------ ONC ABSTRACT-I Input 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 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 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 a data conversion. Routines ONC2PR15 and ONC2PS15 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 ONC22P15.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/ONC22P15.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 -------------------------------------------------------------------------- ONC22P15.KID KIDS Build ASCII Oncology User Manual ONC_2_2_P15_UM.PDF Binary Oncology Technical Manual and Package Security Guide ONC_2_2_P15_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*15 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. Note: If you have local (either class 3 or class 2) changes to the data dictionary for the ONCOLOGY PRIMARY file (#165.5), ICDO TOPOGRAPHY File (#164) and ONCOLOGY EOD SCHEMAS File (#165.9), it is imperative that you back up the data dictionary BEFORE you install. This is in addition to the backup that should be performed during the KIDS installation process. In order to back up the data dictionary, you will be creating a KIDS build and then sending it to the same recipients that would receive backup messages when you backup builds before installation. To create the KIDS build data dictionary, perform the following: Edit a Build PAGE 1 OF 5 Name: ZONC*2.2*15 TYPE: SINGLE PACKAGE ------------------------------------------------------------------------------- Name: ZONC*2.2*15 Date Distributed: Description: + Delete Routine after install Envir. Check Routine: Y/N: Pre-Install Routine: Y/N: Post-Install Routine: Y/N: Pre-Transport Routine: Restore Routine: _______________________________________________________________________________ Exit Save Next Page Previous Page Refresh Quit Enter a COMMAND, or "^" followed by the CAPTION of a FIELD to jump to. COMMAND: N Press H for help Insert The next screen you will enter each file # 160.16, 164, 165 and 165.9 Edit a Build PAGE 2 OF 5 Name: ZONC*2.2*15 TYPE: SINGLE PACKAGE ------------------------------------------------------------------------------- File List (Name or Number) ONCOLOGY DATA EXTRACT FORMAT (#160.16) ONCOLOGY PRIMARY (#165) ICDO TOPOGRAPHY (#164) ONCOLOGY EOD SCHEMAS (#165.9) Edit a Build PAGE 2 OF 5 Name: ZONC*2.2*15 TYPE: SINGLE PACKAGE ------------------------------------------------------------------------------- File List (Name or Number) -------------------------- DD Export Options --------------------------------- | | | File: ONCOLOGY DATA EXTRACT FORMAT | | | | Send Full or Partial DD...: FULL | | | |Update the Data Dictionary: YES Send Security Code: YES | | | |Screen to Determine DD Update | | | | | | Data Comes With File...: NO | ------------------------------------------------------------------------------ COMMAND: R Press H for help Insert Edit a Build PAGE 2 OF 5 Name: ZONC*2.2*15 TYPE: SINGLE PACKAGE ------------------------------------------------------------------------------- File List (Name or Number) -------------------------- DD Export Options --------------------------------- | | | File: ONCOLOGY PRIMARY | | | | Send Full or Partial DD...: FULL | | | |Update the Data Dictionary: YES Send Security Code: YES | | | |Screen to Determine DD Update | | | | | | Data Comes With File...: NO | ------------------------------------------------------------------------------ _______________________________________________________________________________ Close Refresh Enter a COMMAND, or "^" followed by the CAPTION of a FIELD to jump to. COMMAND: Close Press H for help Insert Edit a Build PAGE 2 OF 5 Name: ZONC*2.2*15 TYPE: SINGLE PACKAGE ------------------------------------------------------------------------------- File List (Name or Number) -------------------------- DD Export Options --------------------------------- | | | File: ICDO TOPOGRAPHY | | | | Send Full or Partial DD...: FULL | | | |Update the Data Dictionary: YES Send Security Code: YES | | | |Screen to Determine DD Update | | | | | | Data Comes With File...: NO | ------------------------------------------------------------------------------ _______________________________________________________________________________ Close Refresh COMMAND: Close Press H for help Insert Edit a Build PAGE 2 OF 5 Name: ZONC*2.2*15 TYPE: SINGLE PACKAGE ------------------------------------------------------------------------------- File List (Name or Number) -------------------------- DD Export Options --------------------------------- | | | File: ONCOLOGY EOD SCHEMAS | | | | Send Full or Partial DD...: FULL | | | |Update the Data Dictionary: YES Send Security Code: YES | | | |Screen to Determine DD Update | | | | | | Data Comes With File...: NO | ------------------------------------------------------------------------------ _______________________________________________________________________________ COMMAND: Close Press H for help Insert Edit a Build PAGE 2 OF 5 Name: ZONC*2.2*15 TYPE: SINGLE PACKAGE ------------------------------------------------------------------------------- File List (Name or Number) ONCOLOGY DATA EXTRACT FORMAT ONCOLOGY PRIMARY ICDO TOPOGRAPHY ONCOLOGY EOD SCHEMAS _______________________________________________________________________________ Exit Save Next Page Previous Page Refresh Quit Enter a COMMAND, or "^" followed by the CAPTION of a FIELD to jump to. COMMAND: S Press H for help Insert Tab through the next screen COMMAND: N Press H for help Insert Edit a Build PAGE 3 OF 5 Name: ZONC*2.2*15 TYPE: SINGLE PACKAGE ------------------------------------------------------------------------------- Build Components PRINT TEMPLATE (0) SORT TEMPLATE (0) INPUT TEMPLATE (0) FORM (0) FUNCTION (0) DIALOG (0) ENTITY (0) POLICY (0) APPLICATION ACTION (0) POLICY FUNCTION (0) BULLETIN (0) MAIL GROUP (0) _______________________________________________________________________________ COMMAND: E Create a Build Using Namespace Copy Build to Build Edit a Build Transport a Distribution Old Checksum Update from Build Old Checksum Edit Routine Summary List Version Number Update Select Edits and Distribution Option: TRAnsport a Distribution Enter the Package Names to be transported. The order in which they are entered will be the order in which they are installed. First Package Name: ZONC*2.2*15 Another Package Name: ORDER PACKAGE VERSION # 1 ZONC*2.2*15 1 Do you want to (C)ontinue, (E)dit Version #, (Q)uit: C// ontinue Transport through (HF)Host File or (PM)PackMan: PM PackMan ZONC*2.2*15... No Package File Link Subject: ZONC*2.2*15 v1// Please enter description of Packman Message ==[ WRAP ]==[INSERT ]===================< >=========[Press H for help]==== BACKUP OF DATA DICTIONARIES IMPACTED BY ONC*2.2*15 INSTALL. <=======T=======T=======T=======T=======T=======T=======T=======T=======T>====== Created by at VAHACT.DOMAIN.EXT (KIDS) on Thursday, 07 /28/22 at 08:57 Do you wish to secure this message? NO// press return Send mail to: <<