============================================================================= Run Date: NOV 22, 2023 Designation: ONC*2.2*18 Package : ONC - ONCOLOGY Priority: EMERGENCY Version : 2.2 SEQ #16 Status: Released Compliance Date: NOV 28, 2023 ============================================================================= Associated patches: (v)ONC*2.2*17 <<= must be installed BEFORE `ONC*2.2*18' Subject: 2023 UPDATES AND CORRECTIONS Category: - Data Dictionary - Print Template - Routine Description: ============ 1. This patch will fix casefinding report discrepancies [JIRA ONC-279] The patch will correct discrepancies in the casefinding report to find cases with the ICD-10 codes listed as reportable in the SEER FY2023 ICD-10-CM Casefinding List. 2. This patch will modify the follow-up process [JIRA ONC-272] This patch will allow the user to change the Cancer Status and Recurrence Type in the follow-up module, before the EDITs are called. 3. This patch will provide the new Surgery of Primary Site codes [JIRA ONC-308] The patch will add the new Surgery of Primary Site codes for the new surgery fields - RX Hosp-Surg Prim Site 2023 (#165.5, #58.8) and RX Summ- Surg Prim Site 2023 (#165.5, #58.9). The new codes are 4 characters long, beginning with either "A" or "B" followed by 3 digits. The codes are dependent on the primary site of the case. 4. This patch will include NAACCR 2023 Implementation Guide updates [JIRA ONC-309] The patch will provide updates including calculation changes for AJCC Version 9 protocols to the Anus, Appendix, Brain, CNS Other and Intracranial Gland schemas, as well as a new schema called Medullablastoma. 5. This patch will correct several incorrect schema and AJCC ID calculation [JIRA ONC-315] The patch will correct two several places in which the schema was not being correctly calculated. The patch will also fix several AJCC ID calculations. 6. This patch will fix several staging default errors [JIRA ONC-316] This patch will fix several issues where the default stage group value was incorrect. 7. This patch change the Stage Group Best field to Roman numeral system [JIRA ONC-317] The patch will change the Stage Group Best (#165.5, #40) field to calculate and display in Roman numerals, to be consistent with the Stage Grouping-AJCC (#165.5, #38.5) field. 8. This patch will add a new abstract status called "Pending Delete" [JIRA ONC-319] This patch will add a new status to the Abstract Status (#165.5, #91) field, called "Pending Delete". This patch will also remove the ability to delete patients and primaries in the "Delete Oncology Patient" and "Delete Primary Site/GP Record" options. 9. This patch will add a new field called Behavior Code [JIRA ONC-320] This patch will add the Behavior Code (#165.5, #22.4) field, which will be a computed field that is the 5th digit of the Histology of the case. 10. This patch will provide several XML extract updates and corrections [JIRA ONC-322/324] This patch will add 4 missing data items from the XML extracts and also remove several obsolete data items from the XML extracts. This patch will also update PHI field values on XML extracts 11. This patch will add a new PHI text field and add the Date Radiation Ended to report [JIRA ONC-323/326] This patch will add a new word processing text field called TEXT-HIV, SCA, DRUG & ETOH (#165.5, #289) to the abstract. This patch will also add the Date Radiation Ended (#165.5, #361) field to the "Print Abstract-Extended (80c) PATCH COMPONENTS: ================= Routines: --------- ONC2PR18 ONC2PS18 ONCACD1 ONCACDU1 ONCOAIF ONCOAIS ONCOAIT ONCOCFL1 ONCOCFP1 ONCODIS ONCOEDC1 ONCOEOD1 ONCOPRT1 ONCOSUR3 ONCOTNS ONCOUTC ONCSCHM0 ONCSCHM1 ONCSCHMA ONCSCHMB ONCSCHMC ONCSCHMM ONCSCHMT ONCSCHMU ONCSCHMV ONCSCHMW ONCSCHMY ONCSGA8B ONCSGA8C Files & Fields Associated: -------------------------- New/Modified/ File Name (#) Field Name (#) Deleted ------------- ------------------ ------------- ONCOLOGY DATA EXTRACT FORMAT (#160.16) (data) MODIFIED FORMS/INSTRUCTIONS (#160.2) (data) MODIFIED ICDO TOPOGRAPHY (#164) (data) MODIFIED ONCOLOGY GRADE TABLES (#164.44) (data) MODIFIED RACE CODE FOR ONCOLOGY (#164.46) (data) MODIFIED ONCOLOGY PRIMARY (#165.5) 22.4,58.8,58.9,91,288,289 3933,3960,3961 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 ------------------- ---- ------------ 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 ONCOLOGY PRIMARY (165.5) MODIFIED ONCO FOLLOWUP INPUT ONCOLOGY PATIENT (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 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 ONC22P18.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/ONC22P18.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 -------------------------------------------------------------------------- ONC22P18.KID KIDS Build ASCII Oncology User Manual ONC_2_2_P18_UM.PDF Binary Oncology Technical Manual and Package Security Guide ONC_2_2_P18_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*18 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*18 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: ONC2PR18 Before: n/a After: B3138291 **18** Routine Name: ONC2PS18 Before: n/a After: B4027056 **18** Routine Name: ONCACD1 Before:B147907204 After:B150284644 **1,4,5,8,9,13,14,15,17,18** Routine Name: ONCACDU1 Before: B83474237 After:B115345736 **1,4,7,5,10,12,13,14,17,18** Routine Name: ONCOAIF Before: B62877726 After: B64392545 **1,4,5,6,17,18** Routine Name: ONCOAIS Before: B7710295 After: B4128987 **1,10,17,18** Routine Name: ONCOAIT Before: B13762065 After: B14181337 **1,4,6,12,18** Routine Name: ONCOCFP1 Before: B50843106 After: B51831321 **7,10,13,14,17,18** Routine Name: ONCODIS Before: B795277 After: B805751 **1,4,7,5,8,6,9,11,10,12,13, 14,15,16,17,18** Routine Name: ONCOEDC1 Before: B50967345 After: B49427808 **1,5,6,10,12,15,17,18** Routine Name: ONCOEDC2 Before: B33569749 After: B34371231 **10,12,17,18** Routine Name: ONCOEOD1 Before: B31213088 After: B35586631 **10,13,18** Routine Name: ONCOPRT1 Before:B110376474 After:B110611411 **1,7,10,13,14,17,18** Routine Name: ONCOSUR3 Before: n/a After: B9322634 **18** Routine Name: ONCOTNS Before: B26522464 After: B28387261 **1,9,13,18** Routine Name: ONCOUTC Before: B22462665 After: B18464286 **1,4,18** Routine Name: ONCSCHM0 Before: B87834093 After: B87988458 **12,17,18** Routine Name: ONCSCHM1 Before: B51856632 After: B52638954 **12,13,17,18** Routine Name: ONCSCHMA Before:B144074488 After: B80806924 **10,12,13,17,18** Routine Name: ONCSCHMB Before: B95797593 After: B86878246 **10,12,18** Routine Name: ONCSCHMC Before: B76552802 After: B81709034 **10,12,15,17,18** Routine Name: ONCSCHMM Before: B70948382 After: B71528134 **10,12,13,15,17,18** Routine Name: ONCSCHMT Before: B40925751 After: B42415728 **10,13,15,17,18** Routine Name: ONCSCHMU Before: B81887776 After: B83899249 **10,13,14,15,17,18** Routine Name: ONCSCHMV Before: n/a After:B103828332 **18** Routine Name: ONCSCHMW Before: n/a After: B19406461 **18** Routine Name: ONCSCHMY Before:B111836779 After:B112222145 **10,12,17,18** Routine Name: ONCSGA8B Before:B183011901 After:B183015681 **10,12,13,18** Routine Name: ONCSGA8C Before: B36599128 After: B36648992 **10,12,13,18** Routine list of preceding patches: 17 ============================================================================= User Information: Entered By : Date Entered : AUG 18, 2023 Completed By: Date Completed: NOV 20, 2023 Released By : Date Released : NOV 22, 2023 ============================================================================= Packman Mail Message: ===================== No routines included