$TXT Created by GAVRILOV,SERGEY at DEV.DEV.FO-HINES.MED.VA.GOV (KIDS) on Wednesday, 06/30/04 at 11:43 ============================================================================= Run Date: NOV 04, 2004 Designation: ROR*1*6 Package : ROR - CLINICAL CASE REGISTRIES Priority: Mandatory Version : 1 SEQ #7 Status: Released Compliance Date: DEC 05, 2004 ============================================================================= Associated patches: (v)ROR*1*5 <<= must be installed BEFORE `ROR*1*6' Subject: ICR post-implementation fixes and amendments Category: - Routine - Print Template - Data Dictionary - Enhancement (Mandatory) Description: ============ This patch fixes problems discovered during the implementation of the Immunology Case Registry (ICR) in the Clinical Case Registries (CCR) framework. A new version of the CCR GUI (1.0.6.3) is being released with this patch. CCR:ICR documentation was originally distributed with the patch ROR*1.0*5 as ROR1_0P5DOC.ZIP. The documentation files have been updated to remain consistent with the functionality of the software and the file is named the same in order to provide the most current documentation to the user in a single file. Each file in ROR1_0P5DOC.ZIP contains a Revision History table, which documents the versioning of the document. The fixes and enhancements can be separated into two groups: M code and GUI changes. M Code ------ [01] %DSM-E-UNDEF, undefined variable DFLTSITE ----------------------------------------- Data extraction task crashed at LABPROC+18^ROREXT02 due to the undefined DFLTSITE variable. The ROREXT02 routine has been amended. The NOIS references for this problem are ALB-0404-50689, BHS-0404-10660, ELP-0904-71062, LOM-0404-61948, MIW-0404-40866, and OKL-0304-71707. [02] 'NOT DETECTED' seen as positive result -------------------------------------- The NOT DETECTED value was treated as a positive lab result by the registry update process. The RORUPD04 routine has been amended. The NOIS reference for this problem is AMA-0604-70199. [03] ERROR IN POINTER RESOLUTION OF DATA ----------------------------------- The 'Unable to find exact match and resolve pointer (^ORD(101, Entry: RORICR-SITE-DRIVER).' message was displayed during the installation of the patch ROR*1*5. This had been expected and the problem was fixed by the post-install code. However, the message confused some users. The PROTOCOL field (13) of the ROR REGISTRY PARAMETERS file (#798.1) has been cleared in the development account so that this error message will not appear again when the data is exported to the sites. The NOIS reference for this problem is BHS-0304-10753. [04] Registry setup was not suspended -------------------------------- Some assumptions regarding the "intelligence" of the registry update process appeared to be wrong in regards to the registry setup at small sites. If the PATIENT file (#2) contained less than 100,000 records then only a single task was always scheduled and thus the task suspension was not possible. The RORUPD05 routine has been amended. The threshold value has been changed from 100,000 to 10,000. Moreover, it will be possible to suspend even a single task after installation of this patch. The NOIS references for this problem are NHM-0304-11058 and SHE-0304-51339. [05] Ethnicity column and summary tables ----------------------------------- The ethnicity column and some summary tables were missing from the General Utilization report. The RORX003 and RORX003A routines have been amended. The XSL templates stored in the dialogs #7981003.001, #7981003.002, #7981997.001, and #7981997.002 (see the DIALOG file (#.84) for details) have been updated also. The NOIS references for this problem are PAL-0304-60871 and PAL-0304-60872. [06] Not transmitting ICD9 codes for problems ---------------------------------------- Sometimes the ICD-9 codes associated with the patient problems were not transmitted due to invalid characters ('~') appended to the values stored in the DIAGNOSIS field (.01) of the PROBLEM file (#9000011). The RORHL17 routine has been amended to explicitly convert the value to a number before using it as the IEN of the record of the IDC DIAGNOSIS file (#80). The NOIS reference for this problem is PAL-0304-60876. [07] Updated problems were transmitted several times ----------------------------------------------- Updated problems from the problem list were transmitted more than once. The RORHL17 routine has been amended. The NOIS reference for this problem is PAL-0304-60878. [08] Patch number included a sequence number --------------------------------------- Patch number in the CSR-1 field of the HL7 message erroneously included the patch sequence number as well. The ROREXPR routine has been amended. The NOIS reference for this problem is PAL-0404-61198. [09] Incorrect age calculation ------------------------- Age of deceased patients was calculated incorrectly in the General Utilization report. The RORX003A routine has been amended. The NOIS reference for this problem is PAL-0504-61756. [10] IEN instead of a Stop Code -------------------------- IENs of stop codes were sent in the outpatient pharmacy OBX segments instead of the stop codes themselves. The RORHL031, RORHL09, and RORUTL18 routines have been amended. The NOIS reference for this problem is SPO-0404-50850. [11] Provider Class -------------- IENs of the provider classes were sent in the HL7 messages. But the PROVIDER CLASS file (#7) is a locally edited file and IENs of the provider classes are site-specific. The RORHL03, RORHL04, RORHL07, RORHL071, RORHL09, RORHL14, and RORHL17 routines have been amended to send provider class name instead of IEN. The NOIS reference for this problem is PAL-0304-60727. [12] Stray node(s) in the Data Dictionary ------------------------------------ A stray "PT" node was discovered in the data dictionary of the ROR REGISTRY PARAMETERS file (#798.1) at Albuquerque: ^DD(798.1,0,"PT",799.12,.03). It appeared that all sites had this node as a result of deleting/moving the file #799.12 by one of the patches (most probably, the ROR*1*3). It looked like the FileMan API (EN^DIU2) did not delete the reference when the file was deleted. The IRM personnel has been advised to run the Check/Fix DD Structure option of the Data Dictionary Utilities menu (see the step #2 of the patch installation instructions). The NOIS reference for this problem is ALB-0604-51312. [13] Patient IEN (DFN) in the logs ----------------------------- Patient IEN (DFN) was not displayed in the output of the Print Log Files [RORMNT PRINT LOGS] option. It was difficult to find a patient in question using only the patient name. The ROR LOG print template has been amended to print the DFN (in parenthesis) after the patient name. The E3R reference for this enhancement is #18971. [14] Resend the registry information message --------------------------------------- The patch post-install code resends the registry information e-mail (the one that was originally sent after the registry setup had completed). The original e-mail had incorrect coded SSNs in the list of pending patients. The RORUTL17 routine has been amended. The NOIS reference for this problem is PAL-0804-61367. [15] Pseudo-patient and number of pending patients --------------------------------------------- The following changes of the data extraction will be in effect for all registries after the patch 6 installation: * The batch HL7 message will be sent every night (even if there is no new data available); * The first individual message in the batch will represent a pseudo-patient. The message will contain a current number of pending patients in the registry in the second component of the CSR-4 segment (E3R #18891). The first components of the PID-3 and CSR-4 will be zeros for the pseudo-patient. At the same time the pseudo-patient message will guarantee that the batch is not empty (the VistA does not transmit empty batch HL7 messages). * Individual messages in the HL7 batches sent from the test sites will contain a patch build number in the 4th sub-component of the 3rd component of the CSR-1 (e.g. 'VA ICR^VA^ROR&1.0&7&2'). [16] List of Hep C NDC codes ----------------------- The following National Drug Codes (NDC) have been added to the DRUG THERAPY LIST multiple (17) of the Hepatitis C (Hep C) registry parameters record in the ROR REGISTRY PARAMETERS file (#798.1): 000004035239, 000004201607, 000004201609, 000004201707, 000004201709, 000085053901, 000085057102, 000085111001, 000085113301, 000085116801, 000085117902, 000085129701, 000085131601, 000085131801, 000085132301, 000085137001, 000085138507, 000187000714, 038779025605, 038779025608, 038779025609, 049452622101, 049452622103, 049452622104, 054569542700, 054868334100, 062991207701, 062991207702, 062991207703, 063370021950, 063370021955, 064116003101, 064116003106, 064116003124, 064116003901, 064116003906, 064116003924 The following NDC codes have been removed from the list: 000004035639, 000004198701, 000004198709, 000004200909, 000085064703, 000085064704, 000085064705, 000085118401, 000085118402, 055513055401, 055513055406, 055513056201, 055513056206, 055513092601, 055513092606, 055513092701, 055513092706, 999999777701, 999999999999 The NOIS reference for this update is PHI-0204-20591. [17] Old patch routines ------------------ The following old patch routines (post- and pre-install ones) are deleted by this patch: RORP003, RORP004, RORP005, and RORP005B. CCR GUI ------- [01] "Registry" tab access in the GUI -------------------------------- In some cases users without the ROR VA ICR ADMIN security key still had access to the Registry tab of the CCR GUI. After selecting another tab the Registry tab finally disappeared. The GUI code has been amended. The NOIS reference for this problem is HAM-0304-22240. [02] Clinical AIDS label confusing, change to AIDS OI ------------------------------------------------ By request from the Center for Quality Management (CQM) group the 'Clinical AIDS' label on the 'Current Status' tab of the 'Patient Data Editor' dialog box has been replaced with the following text: 'Check if patient ever had an AIDS OI'. The NOIS reference for this problem is PAL-0304-61644. [03] Current Status tab of Patient Data Editor change ------------------------------------------------ By request from the CQM group the 'CD4/Viral Search results' label on the 'Current Status' tab of the 'Patient Data Editor' dialog box has been replaced with the following text: 'CD4/HIV Search Results'. The NOIS reference for this problem is PAL-0304-61649. [04] GUI form does not fit 800x600 screen ------------------------------------ The 'ICR Reports' dialog box did not entirely fit the screen in 800x600 resolution if the Windows taskbar was not set up to auto-hide. The code has been amended so that the dialog box will fit the screen and the content can be scrolled. The NOIS reference for this problem is PAL-0504-61757. [05] Investigational Drugs label confusing ------------------------------------- By request from the CQM group the 'Investigational Drugs' label on the 'ICR Reports' dialog box has been replaced with the following text: 'Investigational Drugs (registry specific)'. The NOIS reference for this problem is PAL-0304-61886. [06] Mismatched links in the GUI help file ------------------------------------- The 'Setting Up ICR Site Parameters' item of the content tree referenced the 'Working with Activity Logs' topic. On the other hand, the 'Working with Activity Logs' item of the content tree referenced the 'Setting Up ICR Site Parameters' topic. The online help file has been corrected. The NOIS reference for this problem is SDC-0404-60545. [07] Blank window when GUI is started -------------------------------- Some users were confused by the empty main window after starting the CCR GUI. The code has been modified to display a registry selection dialog (when the HepC registry functionality is added). If the user has security key(s) only for a single registry, this registry will be opened automatically. The NOIS reference for this problem is PAL-0804-61368. [08] Month/Year fields of CDC from did not accept year 2000 ------------------------------------------------------ The validation code of the Month/Year fields of the CDC (Center for Disease Control and Prevention) form did not allow entering '00' (year 2000) in the year part of the fields. The code has been amended. The NOIS reference for this problem is PAL-0604-62149. [09] Mismatched field values on the CDC form --------------------------------------- Even if the date of death (Section III of the CDC form) had already been entered, it was not possible to enter the state/territory of death. When the form was saved, the state of death was listed as the date of death and could not be changed. The code of the GUI and definition of the CDC form (the ICRCDCDEF instance of the ROR GUI PARAMETER parameter) have been amended. The NOIS reference for this problem is PAL-0804-61370. Associated NOIS: =============== ALB-0404-50689 ALB-0604-51312 AMA-0604-70199 BHS-0404-10660 BHS-0304-10753 ELP-0904-71062 HAM-0304-22240 LOM-0404-61948 MIW-0404-40866 NHM-0304-11058 OKL-0304-71707 PAL-0304-60727 PAL-0304-60871 PAL-0304-60872 PAL-0304-60876 PAL-0304-60878 PAL-0304-61644 PAL-0304-61649 PAL-0404-61198 PAL-0504-61756 PAL-0504-61757 PAL-0304-61886 PAL-0604-62149 PAL-0804-61367 PAL-0804-61368 PAL-0804-61370 PHI-0204-20591 SDC-0404-60545 SHE-0304-51339 SPO-0404-50850 Associated E3R: ============== 18891 18971 Thanks to Test Sites: ==================== Amarillo - VMS/DSM Coatesville - VMS/Cache Fargo - Alpha NT/Cache Palo Alto - VMS/Cache West Los Angeles - VMS/DSM, Thin Client Routine Summary: =============== The following routines are included in this patch. The second line of each of these routines now looks like: ;;1.0;CLINICAL CASE REGISTRIES;**[patchlist]**;May 14, 2002 Checksum Routine Before After Patch List -------- -------- -------- --------------------------- ROR 2391687 2393807 2,3,5,6 ROREXPR 3001150 3054011 2,3,5,6 ROREXT01 4753620 4887747 2,4,5,6 ROREXT02 4489200 4504914 2,5,6 ROREXT03 n/a 1955488 6 RORHL02 7393211 7424588 2,5,6 RORHL03 5320617 5325577 2,5,6 RORHL031 7722343 7575501 5,6 RORHL04 5194059 5193863 2,3,4,5,6 RORHL07 4109759 4114719 2,5,6 RORHL071 4090467 4095427 5,6 RORHL09 7090154 6760261 5,6 RORHL14 5434624 5434428 5,6 RORHL17 6078801 6039977 5,6 RORNTEG 4241157 4224648 3,4,5,6 RORNTEG0 3103051 3103265 3,4,5,6 RORP003 6424519 n/a 3 RORP004 1648658 n/a 4 RORP005 10769113 n/a 5 RORP005B 7032438 n/a 5 RORP006 n/a 4399886 6 RORRP012 2671505 2760144 5,6 RORRP019 3371279 3662396 5,6 RORRP030 6111440 6154417 5,6 RORUPD04 5153157 5149249 5,6 RORUPD05 7326307 7177293 2,5,6 RORUTL06 9119845 9129215 5,6 RORUTL17 6970941 6970881 5,6 RORUTL18 n/a 285281 6 RORX003 4952051 5404752 5,6 RORX003A 6293120 7951022 5,6 INSTALLATION FILES: ================== The following software and documentation files are exported as part of this patch: File Name Contents Transfer Mode Size ---------------- ----------------------- ------------- --------- ROR1_OP6GUI.ZIP Zipped GUI distributive BINARY 3,672,022 ROR1_0P5DOC.ZIP Updated ICR documenta- BINARY 8,615,450 tion (it was originally exported as a part of the patch ROR*1*5) ROR1_0P5IG.DOC Installation Guide 658,432 ROR1_0P5IG.PDF 492,517 ROR1_0P5RN.DOC Release Notes 100,864 ROR1_0P5RN.PDF 53,265 ROR1_0P5TM.DOC Technical Manual 1,922,560 ROR1_0P5TM.PDF 599,040 ROR1_0P5UM.DOC User Manual 6,874,624 ROR1_0P5UM.PDF 2,960,787 The files listed above may be obtained via FTP. The preferred method is to FTP the files from: download.vista.med.va.gov This transmits the files from the first available FTP server. Sites may also elect to retrieve software directly from a specific server as follows: CIO Field Office FTP Address Directory ---------------- ------------------------- -------------------- Albany ftp.fo-albany.med.va.gov [anonymous.software] Hines ftp.fo-hines.med.va.gov [anonymous.software] Salt Lake City ftp.fo-slc.med.va.gov [anonymous.software] The documentation will be in the form of an Adobe Acrobat file, and can also be found on the Health System Design and Development website: http://www.va.gov/vdl/ Installation Instructions: ========================= The ROR VA IRM security key is required for installation of this patch. Installation of this patch will not take more than 10 minutes. The patch can be installed with VistA users online. NOTE: The nightly task (the [ROR TASK] option) must not be running during the installation! Taskman does not need to be STOPPED or placed in a WAIT state. 1. Make sure that the 'AUTOSTART' field of the 'RORICR SND' HL7 logical link is set to 'Enabled': Event monitoring menu ... Systems Link Monitor Filer and Link Management Options ... Message Management Options ... Interface Developer Options ... Site Parameter Edit Select HL7 Main Menu Option: Interface Developer Options === EA Application Edit EP Protocol Edit EL Link Edit VI Validate Interfaces Reports ... Select Interface Developer Options Option: EL Link Edit == Select HL LOGICAL LINK NODE: RORICR SND ========== HL7 LOGICAL LINK -------------------------------------------------------------------- NODE: RORICR SND INSTITUTION: DOMAIN: AUTOSTART: Enabled QUEUE SIZE: 10 LLP TYPE: TCP ____________________________________________________________________ COMMAND: E Press H for help Insert 2. Please perform the data dictionary checks/repairs for the Clinical Case Registries files: VA FileMan Version 22.0 Enter or Edit File Entries Print File Entries Search File Entries Modify File Attributes Inquire to File Entries Utility Functions ... Data Dictionary Utilities ... Transfer Entries Other Options ... Select VA FileMan Option: Data Dictionary Utilities ==== List File Attributes Map Pointer Relations Check/Fix DD Structure Select Data Dictionary Utilities Option: Check/Fix DD Structure ===== Check the Data Dictionary. START WITH WHAT FILE: // 798 ROR LOCAL REGISTRY === GO TO WHAT FILE: // 799.51 ROR GENERIC DRUG ====== Remove erroneous nodes? NO// YES === DEVICE: HOME// HOME;80;999999 ============== 3. AXP/DSM sites: Review your mapped routine set. If any of the routine(s) listed in the ROUTINE SUMMARY section are mapped, they should be removed from the mapped set at this time. 4. Use the "INSTALL/CHECK MESSAGE" option on the Packman menu. This option loads the patch into a Transport Global on your system. 5. On the KIDS menu, select the "Installation" menu, and use the following options to install the Transport Global: Verify Checksums in Transport Global Print Transport Global Compare Transport Global to Current System Backup a Transport Global Install Package(s) Select Installation Option: Install Package(s) ==== Select INSTALL NAME: ROR*1.0*6 ========= 10/22/04@10:13:09 This Distribution was loaded on Oct 22, 2004@10:13:09 with header of It consisted of the following Install(s): ROR*1.0*6 Checking Install for Package ROR*1.0*6 Will first run the Environment Check Routine, RORP006 The [ROR TASK] option is not scheduled. Do not forget to schedule it after completion of the installation. Install Questions for ROR*1.0*6 Incoming Files: 799.31 ROR XML ITEM (including data) Note: You already have the 'ROR XML ITEM' File. I will OVERWRITE your data with mine. 799.34 ROR REPORT PARAMETERS (including data) Note: You already have the 'ROR REPORT PARAMETERS' File. I will OVERWRITE your data with mine. Want KIDS to INHIBIT LOGONs during the install? YES// NO == Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES// Enter options you wish to mark as 'Out Of Order': ROR TASK ======== Enter options you wish to mark as 'Out Of Order': Enter protocols you wish to mark as 'Out Of Order': Delay Install (Minutes): (0-60): 0// Enter the Device you want to print the Install messages. You can queue the install by enter a 'Q' at the device prompt. Enter a '^' to abort the install. DEVICE: HOME// Install Started for ROR*1.0*6 : Oct 22, 2004@10:18:11 Build Distribution Date: Jun 30, 2004 Installing Routines: Oct 22, 2004@10:18:11 Installing Data Dictionaries: Oct 22, 2004@10:18:11 Installing Data: Oct 22, 2004@10:18:13 Installing PACKAGE COMPONENTS: Installing PRINT TEMPLATE Installing DIALOG Oct 22, 2004@10:18:13 Running Post-Install Routine: POS^RORP006 Adding new items to the drug list... 000004035239, 000004201607, 000004201609, 000004201707, 000004201709, 000085053901, 000085057102, 000085111001, 000085113301, 000085116801, 000085117902, 000085129701, 000085131601, 000085131801, 000085132301, 000085137001, 000085138507, 000187000714, 038779025605, 038779025608, 038779025609, 049452622101, 049452622103, 049452622104, 054569542700, 054868334100, 062991207701, 062991207702, 062991207703, 063370021950, 063370021955, 064116003101, 064116003106, 064116003124, 064116003901, 064116003906, 064116003924 The drug list has been updated successfully. Removing obsolete items from the drug list... 000004035639, 000004198701, 000004198709, 000004200909, 000085064703, 000085064704, 000085064705, 000085118401, 000085118402, 055513055401, 055513055406, 055513056201, 055513056206, 055513092601, 055513092606, 055513092701, 055513092706, 999999777701, 999999999999 The drug list has been updated successfully. Restoring the CDC definition... The definition has been restored successfully. Updating Routine file... Updating KIDS files... ROR*1.0*6 Installed. Oct 22, 2004@10:18:15 Install Message sent #27182 Install Completed 6. AXP/DSM sites: After the patch has been installed, if any routines were removed from the mapped set in Step 3 above, rebuild your map set. 7. After the installation is complete, make sure that the ROR TASK option is not marked Out-Of-Order. 8. The ROR1_0P6.ZIP file contains CCRSetup.exe, which will install the GUI application on a workstation. If the workstation is being updated with the new version of the GUI, the installation instructions on pg. 37 of the CCR Installation guide, distributed with the ROR*1.0*6, should be referenced. If the CCR GUI is being installed for the first time on a workstation then the installation instructions on pg. 28 of the CCR Installation Guide that was distributed with the ROR*1.0*6 should be referenced. Routine Information: ==================== Routine Name: - ROR Routine Checksum: Routine Name: - ROREXPR Routine Checksum: Routine Name: - ROREXT01 Routine Checksum: Routine Name: - ROREXT02 Routine Checksum: Routine Name: - ROREXT03 Routine Checksum: Routine Name: - RORHL02 Routine Checksum: Routine Name: - RORHL03 Routine Checksum: Routine Name: - RORHL031 Routine Checksum: Routine Name: - RORHL04 Routine Checksum: Routine Name: - RORHL07 Routine Checksum: Routine Name: - RORHL071 Routine Checksum: Routine Name: - RORHL09 Routine Checksum: Routine Name: - RORHL14 Routine Checksum: Routine Name: - RORHL17 Routine Checksum: Routine Name: - RORP006 Routine Checksum: Routine Name: - RORRP012 Routine Checksum: Routine Name: - RORUPD04 Routine Checksum: Routine Name: - RORUPD05 Routine Checksum: Routine Name: - RORUTL06 Routine Checksum: Routine Name: - RORUTL17 Routine Checksum: Routine Name: - RORUTL18 Routine Checksum: Routine Name: - RORX003 Routine Checksum: Routine Name: - RORX003A Routine Checksum: Routine Name: - RORNTEG Routine Checksum: Routine Name: - RORNTEG0 Routine Checksum: Routine Name: - RORRP030 Routine Checksum: Routine Name: - RORRP019 Routine Checksum: Routine Name: - RORP003 Routine Checksum: Routine Name: - RORP004 Routine Checksum: Routine Name: - RORP005 Routine Checksum: Routine Name: - RORP005B Routine Checksum: ============================================================================= User Information: Entered By : HICKS,BRENT Date Entered : MAR 19, 2004 Completed By: HESS,JAMES Date Completed: OCT 27, 2004 Released By : BELSCHWINDER,MICHAEL Date Released : NOV 04, 2004 ============================================================================= Packman Mail Message: ===================== $END TXT