$TXT Created by DAYON,RUFINO at DEV.DEV.FO-HINES.MED.VA.GOV (KIDS) on Friday, 02/29/08 at 12:01 ============================================================================= Run Date: AUG 27, 2008 Designation: RA*5*65 Package : RA - RADIOLOGY/NUCLEAR MEDICINE Priority: Mandatory Version : 5 SEQ #79 Status: Released Compliance Date: SEP 27, 2008 ============================================================================= Associated patches: (v)RA*5*10 <<= must be installed BEFORE `RA*5*65' (v)RA*5*18 <<= must be installed BEFORE `RA*5*65' (v)RA*5*40 <<= must be installed BEFORE `RA*5*65' (v)RA*5*71 <<= must be installed BEFORE `RA*5*65' (v)PSS*1*108 <<= must be installed BEFORE `RA*5*65' (v)PSS*1*112 <<= must be installed BEFORE `RA*5*65' Subject: RADIOLOGY INCORPORATES PHARMACY API'S Category: - Routine - Data Dictionary - Input Template - Print Template - Enhancement (Mandatory) Description: ============ The Pharmacy Encapsulation Cycle I project requires that all direct references to Pharmacy files be replaced by new Pharmacy APIs. Thus, changes to coding, data definition, and templates have been made to the medication and radiopharmaceutical portions of the Radiology package. From the user's perspective, except for two minor display changes, these portions of the package should function the same way as before this patch. The minor display changes are described in detail in the released notes associated with this patch. The affected portions of the Radiology package are outlined below. ------- Options ------- Patient case data entry: Case No. Exam Edit [RA EDITCN] Edit Exam by Patient [RA EDITPT] Status Tracking of Exams [RA STATRACK] Other data entry: Lot (Radiopharmaceutical) Number Enter/Edit [RA NM EDIT LOT] Procedure Enter/Edit [RA PROCEDURE] Procedure listings: Active Procedure List (Long) [RA PROCLONG] Inactive Procedure List (Long) [RA INACPRCLONG] Series of Procedures List [RA PROCSERIES] Other listings: Duplicate Dosage Ticket [RA DOSAGE TICKET] Radiopharmaceutical Usage Report [RA NM RADIOPHARM USAGE] ---------------- Data Definitions ---------------- File 70 RAD/NUC MED PATIENT Subfile 70.02 REGISTERED EXAMS Subfile 70.03 EXAMINATIONS Subfile 70.15 MEDICATIONS Field .01 MED ADMINISTERED removed data screen DIC("S") File 70.2 NUC MED EXAM DATA Subfile 70.21 RADIOPHARMACEUTICALS Field .01 RADIOPHARMACEUTICAL removed data screen DIC("S") File 71 RAD/NUC MED PROCEDURES Subfile 71.08 Field .01 DEFAULT RADIOPHARMACEUTICALS removed data screen DIC("S") Subfile 71.055 Field .01 DEFAULT MEDICATIONS removed data screen DIC("S") File 71.9 RADIOPHARMACEUTICAL LOT Field 5 RADIOPHARM removed this field's Fileman Identifier and removed data screen DIC("S") -------- Routines -------- RA65PST was added to delete the Fileman Identifier from the RADIOPHARMACEUTICAL LOT file, #71.9, RADIOPHARM field, (#5), and to set a Fileman "WRITE" node to display the RADIOPHARM data whenever a Fileman lookup is done on this file. The changes were made in order to use the Pharmacy API to display RADIOPHARM during Fileman lookup. RADD1 was modified to remove some code that is no longer needed, due to switching to the new Pharmacy API. RADD3 was modified to use the new Pharmacy API to store the RADIOPHARM data for a radiopharmaceutical lot record this is added on-the-fly from any of the three exam edit options: Status Tracking of Exams [RA STATRACK] Case No. Exam Edit [RA EDITCN] Edit Exam by Patient [RA EDITPT] RADD4 was modified to remove some code that is no longer needed, due to switching to the new Pharmacy API. RADOSTIK was modified to use the new Pharmacy API to retrieve the radiopharmaceutical generic drug name. RAMAIN2 was modified to use the new Pharmacy API to retrieve the radiopharmaceutical generic drug name. RANMED1 was modified to use the new Pharmacy API to enter radiopharmaceutical data and include the same help prompt and text that previously came from Fileman. The switch to the new Pharmacy API results in slight changes in some user interactive sessions, such as jumping from field to field. Please refer to the Released Notes (RA5_0RN_65.PDF) for detailed explanation and examples. RANMUSE2 was modified to use the new Pharmacy API to display radiopharmaceutical's generic drug name. RANMUSE3 was modified to correct an error that appears if there are no data for the selected time frame. The bug was discovered during unit testing. This is a bug fix and does not involve the new Pharmacy API. RANMUTL1 was modified to use the new Pharmacy API to select one or more radiopharmaceuticals from the DRUG file, #50. RAPSAPI was added to handle common logic needed by routines RA65PST, RADD3, RADOSTIK, RANMED1, RANMUSE2, RANMUTL1, and RASTREQN to use the new Pharmacy API for displaying generic drug names, for screening and selecting drug data by VA CLASSIFICATION. RAPSAPI2 was added to handle common logic for deleting and getting help prompts for medication and radiopharmaceuticals. RAPSAPI3 was added to handle common logic for editing medication and radiopharmaceuticals from case edit and status tracking options. RASTREQN was modified to use the new Pharmacy API to display the radiopharmaceutical's generic drug name and also to remove extra blank lines after checking general required fields. --------------- Input Templates --------------- [RA EXAM EDIT] from the RAD/NUC MED PATIENT file, #70, was modified to use the new Pharmacy API to handle data entry of medications and radiopharmaceuticals. This input template is used by the following options: 'Case No. Exam Edit' [RA EDITCN] 'Edit Exam by Patient' [RA EDITPT] [RA STATUS CHANGE] from the RAD/NUC MED PATIENT file, #70, was modified to use the new Pharmacy API to handle data entry of medications and radiopharmaceuticals. This input template is used by the following option: 'Status Tracking of Exams' [RA STATRACK] [RA PROCEDURE EDIT] from the RAD/NUC MED PROCEDURES file, #71, was modified to use the new Pharmacy API to handle data entry of default medications and default radiopharmaceuticals. This input template is used by the following option: 'Procedure Enter/Edit' [RA PROCEDURE] option. -------------- Print Template -------------- [RA PROCEDURE LIST] was modified to use the new Pharmacy API to display the generic drug name of radiopharmaceuticals and medications, and to remove the display of a stray variable, RAZ71, in the output of three options: 'Active Procedure List (Long)' [RA PROCLONG] 'Inactive Procedure List' (Long) [RA INACPRCLONG] 'Series of Procedures List' [RA PROCSERIES]. ------------- Documentation ------------- The application documentation for this patch is located in the [ANONYMOUS.SOFTWARE] directory of the following OI Field Offices: Albany ftp.fo-albany.med.va.gov Hines ftp.fo-hines.med.va.gov Salt Lake City ftp.fo-slc.med.va.gov The application documentation distribution includes: File Name Description ========= =========== RA5_0RN_65.pdf Released Notes for patch RA*5*65 Once released, documentation may also be retrieved from VISTA Documentation Library (VDL) on the Internet at the following address, http://www.va.gov/vdl --------------------------- Associated Remedy Ticket(s) --------------------------- N/A ----------------- Associated NSR(s) ----------------- N/A ---------- Test Sites ---------- 1. Central Texas 2. Shreveport The second line of the routine now looks like: ;;5.0;Radiology/Nuclear Medicine;**[Patch List]**;Mar 16, 1998 Integrity checking tools: CHECK^XTSUMBLD Name Before Patch After Patch Patch List ---------------------------------------------------------------- RA65PST N/A 786788 65 RADD1 6360360 6341032 1,5,10,65 RADD3 7537362 6776546 18,65 RADD4 1874452 1248680 65 RADOSTIK 9098854 9086956 65 RAMAIN2 13979487 13968407 45,62,71,65 RANMED1 5477431 5942497 65 RANMUSE2 14601709 14593855 65 RANMUSE3 7785963 7961958 65 RANMUTL1 5155188 4943870 65 RAPSAPI N/A 5799327 65 RAPSAPI2 N/A 5964015 65 RAPSAPI3 N/A 8820862 65 RASTREQN 9332338 9200081 40,65 INSTALLATION INSTRUCTIONS ========================= The install time for this patch should take less than 5 minutes. Because this patch affects data entry of exams, all Radiology users must be off the system during the installation. NOTE: MailMan and Kernel patches must be current on the target system to avoid problems loading and installing this patch. 1. Use the 'INSTALL/CHECK MESSAGE' option of your PackMan menu to load the KIDS distribution onto your system. 2. On the 'Kernel Installation & Distribution System' Menu (KIDS), select the 'Installation' menu. From this menu you may choose the following options prior to installing this patch: a. Backup a Transport Global - this option will create a backup message of any routines exported with the patch. It will NOT backup any other changes such as data dictionaries or templates. b. Compare Transport Global to Current System - this option will allow you to view all changes that will be made when the patch is installed. It compares all components of the patch (routines, DDs, templates, etc.) c. Verify Checksums in Transport Global - this option will allow you to ensure the integrity of the routine that is in the transport global. 3. Use the 'Install Package(s)' option under the 'Installation' menu. When prompted for INSTALL NAME, enter: RA*5.0*65. When prompted "Want KIDS to INHIBIT LOGONs during the install? NO//", respond NO. When prompted "Want to DISABLE Scheduled Options, Menu Options and Protocols? YES//", respond YES. When prompted "Enter options you wish to mark as 'Out of Order':", enter the following to disable all Rad/Nuc Med options: RA* When prompted "Enter protocols you wish to mark as 'Out of Order':", enter the following to disable all Rad/Nuc Med protocols: RA* 4. Verify that the patch installation completed correctly by using the KIDS 'Utilities...' [XPD UTILITY] option 'Install File Print' [XPD PRINT INSTALL FILE] and selecting this patch (RA*5.0*65). 5. Upon successful completion of the installation, the post install routine, RA65PST may be deleted. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.0;Radiology/Nuclear Medicine;**[Patch List]**;Mar 16,1998;Build 8 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: RA65PST Before: n/a After: B1265156 **65** Routine Name: RADD1 Before: B18291881 After: B18784553 **1,5,10,65** Routine Name: RADD3 Before: B22339745 After: B25368385 **18,65** Routine Name: RADD4 Before: B4471215 After: B2279618 **65** Routine Name: RADOSTIK Before: B22290587 After: B23645905 **65** Routine Name: RAMAIN2 Before: B51382730 After: B53609974 **45,62,71,65** Routine Name: RANMED1 Before: B9123243 After: B11414707 **65** Routine Name: RANMUSE2 Before: B36990000 After: B37954161 **65** Routine Name: RANMUSE3 Before: B14878113 After: B15377223 **65** Routine Name: RANMUTL1 Before: B14352459 After: B14346054 **65** Routine Name: RAPSAPI Before: n/a After: B19025307 **65** Routine Name: RAPSAPI2 Before: n/a After: B40591298 **65** Routine Name: RAPSAPI3 Before: n/a After: B59625794 **65** Routine Name: RASTREQN Before: B31958180 After: B32502575 **40,65** Routine list of preceding patches: 10, 18, 40, 71 ============================================================================= User Information: Entered By : MO,SELINA Date Entered : AUG 23, 2005 Completed By: DAVISSON,GARY N Date Completed: AUG 22, 2008 Released By : COWNIE,KEVIN Date Released : AUG 27, 2008 ============================================================================= Packman Mail Message: ===================== $END TXT