============================================================================= Run Date: OCT 09, 2024 Designation: ONC*2.2*20 Package : ONC - ONCOLOGY Priority: EMERGENCY Version : 2.2 SEQ #18 Status: Released Compliance Date: OCT 15, 2024 ============================================================================= Associated patches: (v)ONC*2.2*19 <<= must be installed BEFORE `ONC*2.2*20' Subject: NAACCR 2023 IMPLEMENTATION AND VARIOUS UPDATES Category: - Data Dictionary - Input Template - Routine Description: ============ 1. This patch will implement the NAACCR (North American Association of Central Cancer Registries) 2023 updates and Edits metafile The patch will implement the remainder of the NAACCR 2023 field updates and the v23 Edits metafile. These changes are based on the NAACCR 2023 Implementation Guide. 2. This patch will include NAACCR 2023 Implementation Guide updates The patch will provide updates including calculation changes for AJCC (American Joint Commission on Cancer) Version 9 protocols to the Anus, Appendix, Brain, CNS Other and Intracranial Gland schemas, as well as a new schema called Medullablastoma. 3. This patch will update State, RCRS (Rapid Cancer Reporting System) and NCDB (National Cancer DataBase) extracts to v23 The patch will correct several places in which the schema was not being correctly calculated. The patch will also fix several AJCC ID calculations. 4. This patch will force any completed 2023 and 2024 cases to partial status This patch will reset any completed 2023 abstracts to partial status and will not allow users to complete any 2024 cases. This is because the 2024 metafile is not ready yet. The next patch will allow users to complete 2024 cases. 5. This patch will make changes to the Abstract Status This patch will automatically jump to the Text-Remarks (File #165.5, #13) field if a case is set to "Pending Delete". This will allow users to enter the reason for setting the case to that status. 6. This patch will update the Casefinding Source (File #165.5, #21) field This patch will update the description for Code 20 in the Casefinding Source field. 7. This patch will display Treatment fields when a Date of No Treatment (File #165.5, #124) is entered This patch will allow users to edit the treatment fields when a Date of No Treatment value is entered, instead of stuffing and skipping over those fields. 8. This patch will make updates to the Exposure fields This patch will correct a typo in the name of the OTHER TOXIC EXPOSURE (#160,#73) field and update the XML ID value for that field. The patch will also add a new value to the Set of Codes for this field. The new value will also be added to the other exposure fields: AGENT ORANGE EXPOSURE (#160,#48), IONIZING RADIATION EXPOSURE (#160,#50), CHEMICAL EXPOSURE (#160,#52), ASBESTOS EXPOSURE (#160,#61) and BURN PIT EXPOSURE (#160,#72). 9. This patch will update the case ascertainment section This patch will add HISTOLOGY (#165.5,#20) as an optional field value brought in when a new case is accessioned. This patch will also add the Gender Identity and Sexual Orientation demographic data fields from the PATIENT file into the case ascertainment section. 10. This patch will update the FEE BASIS (#165.5,#237) data item This patch will make the FEE BASIS field a required field. Also, if the FEE BASIS field is set to "YES" then the FEE BASIS LOCATION (#165.5,#237.1) will also be required. 11. This patch will update the Restage CS Cases using latest version option This patch will fix the Restage CS Cases Using Latest Version [ONCO UTIL CS RESTAGING] option which was not working correctly after the cloud migration in Patch ONC*2.2*19. PATCH COMPONENTS: ================= Routines: --------- ONC2PR20 ONCACD0 ONCACD1 ONCACDU2 ONCATF ONCATF1 ONCATF2 ONCCSRS ONCCSRS1 ONCDTX ONCDTX1 ONCGENED ONCNTX ONCNTX1 ONCOAIC ONCOAIM ONCOAIP ONCOCFR ONCODIS ONCOEDC ONCOEDC1 ONCOEDC2 ONCOEOD1 ONCOES ONCOPA1 ONCOPA2 ONCOPA3 ONCOSUR2 ONCOSUR3 ONCOU55 ONCPAT ONCPCI ONCPDI ONCPTX ONCSCHMG ONCSCHMH ONCSCHMM ONCSCHMP ONCSCHMU ONCSED01 ONCSGA8A ONCSGA8B ONCSGA8C ONCSGA8H ONCTXSM ONCUTX1 ONCWEB1 ONCWEB2 Files & Fields Associated: -------------------------- New/Modified/ File Name (#) Field Name (#) Deleted ------------- ------------------ ------------- ONCOLOGY PATIENT (#160) AGENT ORANGE EXPOSURE (#48) MODIFIED IONIZING RADIATION EXPOSURE (#50) MODIFIED CHEMICAL EXPOSURE (#52) MODIFIED ASBESTOS EXPOSURE (#61) MODIFIED BURN PIT EXPOSURE (#72) MODIFIED OTHER TOXIC EXPOSURE (#73) MODIFIED ONCOLOGY DATA EXTRACT FORMAT (#160.16) (data) MODIFIED AJCC STAGING GROUPS (#164.33) (data) MODIFIED ONCOLOGY GRADE TABLES (#164.44) (data) MODIFIED ONCOLOGY PRIMARY (#165.5) RX SUMM--SURG PRIM SITE 03-22(#58.6)MODIFIED RX HOSP--SURG PRIM SITE 03-22(#58.7)MODIFIED FEE BASIS (#237) MODIFIED ONCO AJCC STAGING CHAPTERS (#165.8)(data) MODIFIED ONCOLOGY EOD SCHEMAS (#165.9) (data) MODIFIED 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 --------------------- ---- ------------------ ------------ ONCO ABSTRACT-I INPUT 165.5 MODIFIED ONCO RECURRENCE FOLLOWUP INPUT 165.5 MODIFIED ONCOXA3 PRINT 165.6 MODIFIED ONCOY54 PRINT 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 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 ONC22P20.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/ONC22P20.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 -------------------------------------------------------------------------- ONC22P20.KID KIDS Build ASCII Oncology User Manual ONC_2_2_P20_UM.PDF Binary Oncology Technical Manual and Package Security Guide ONC_2_2_P20_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*20 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*20 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: ONC2PR20 Before: n/a After: B35791866 **20** Routine Name: ONCACD0 Before:B196067329 After:B197120248 **1,4,5,8,6,10,12,13,14,15,17,19,20** Routine Name: ONCACD1 Before:B150284644 After:B150284747 **1,4,5,8,9,13,14,15,17,18,20** Routine Name: ONCACDU2 Before:B118654145 After:B126722746 **1,4,7,5,6,20** Routine Name: ONCATF Before: B47209323 After: B50795063 **1,20** Routine Name: ONCATF1 Before: B59347534 After: B67216371 **1,5,10,20** Routine Name: ONCATF2 Before: n/a After: B9732455 **20** Routine Name: ONCCSRS Before: B44624188 After: B45664126 **1,20** Routine Name: ONCCSRS1 Before: n/a After: B48463065 **20** Routine Name: ONCDTX Before: B80400973 After: B82084461 **1,5,15,20** Routine Name: ONCDTX1 Before: B19374560 After: B19386649 **1,5,20** Routine Name: ONCGENED Before: B35756040 After: B35756112 **1,4,6,10,13,16,17,19,20** Routine Name: ONCNTX Before:B100676915 After:B106251894 **1,6,10,15,20** Routine Name: ONCNTX1 Before: B63436764 After: B68558725 **1,5,15,20** Routine Name: ONCOAIC Before: B11890548 After: B11924000 **1,15,20** Routine Name: ONCOAIM Before: B29627911 After: B29728647 **1,4,15,17,20** Routine Name: ONCOAIP Before:B132498603 After:B134431970 **1,4,5,6,10,15,16,20** Routine Name: ONCOCFR Before: B46725969 After: B46725970 **1,17,20** Routine Name: ONCODIS Before: B805748 After: B805442 **1,4,7,5,8,6,9,11,10,12,13, 14,15,16,17,18,19,20** Routine Name: ONCOEDC Before: B31320775 After: B34472829 **1,5,6,10,19,20** Routine Name: ONCOEDC1 Before: B49427808 After: B49563768 **1,5,6,10,12,15,17,18,20** Routine Name: ONCOEDC2 Before: B34371231 After: B34648586 **10,12,17,18,20** Routine Name: ONCOEOD1 Before: B35586631 After: B35339930 **10,13,18,20** Routine Name: ONCOES Before: B80721526 After: B97117623 **1,19,20** Routine Name: ONCOPA1 Before: B63994489 After: B64033238 **1,5,6,9,10,12,13,20** Routine Name: ONCOPA2 Before: B70986465 After: B72692267 **1,5,10,12,13,15,20** Routine Name: ONCOPA3 Before: B47707728 After: B49045690 **1,12,20** Routine Name: ONCOSUR2 Before: B54000047 After: B55564860 **1,10,13,20** Routine Name: ONCOSUR3 Before: B9322634 After: B12812761 **18,20** Routine Name: ONCOU55 Before: B42030639 After: B43675616 **1,10,12,13,15,17,20** Routine Name: ONCPAT Before: B84084492 After: B84872802 **1,13,17,19,20** Routine Name: ONCPCI Before: B31602147 After: B31657583 **1,9,10,20** Routine Name: ONCPDI Before: B8359089 After: B10231413 **1,13,19,20** Routine Name: ONCPTX Before:B121273459 After:B128339607 **1,5,6,10,15,20** Routine Name: ONCSCHMG Before:B107850633 After:B107855338 **10,12,13,14,20** Routine Name: ONCSCHMH Before: B7208983 After: B19827937 **12,13,20** Routine Name: ONCSCHMM Before: B71528134 After: B71245922 **10,12,13,15,17,18,20** Routine Name: ONCSCHMP Before: B60211985 After: B60064859 **10,12,13,20** Routine Name: ONCSCHMU Before: B83899249 After: B84925074 **10,13,14,15,17,18,20** Routine Name: ONCSED01 Before: B76428071 After: B74474333 **1,16,19,20** Routine Name: ONCSGA8A Before:B180189300 After:B181932809 **10,12,17,19,20** Routine Name: ONCSGA8B Before:B183015681 After:B148044751 **10,12,13,18,20** Routine Name: ONCSGA8C Before: B36648915 After: B56794584 **10,12,13,18,19,20** Routine Name: ONCSGA8H Before: B23486231 After: B25402880 **10,12,17,20** Routine Name: ONCTXSM Before: B19167802 After: B19154871 **1,20** Routine Name: ONCUTX1 Before: B36446886 After: B36456411 **1,5,15,20** Routine Name: ONCWEB1 Before: B44160675 After: B52619783 **16,19,20** Routine Name: ONCWEB2 Before: B20927081 After: B26509087 **19,20** Routine list of preceding patches: 19 ============================================================================= User Information: Entered By : Date Entered : JUL 18, 2024 Completed By: Date Completed: OCT 07, 2024 Released By : Date Released : OCT 09, 2024 ============================================================================= Packman Mail Message: ===================== No routines included