============================================================================= Run Date: JUN 16, 2006 Designation: MAG*3*51 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #36 Status: Released Compliance Date: JUL 17, 2006 ============================================================================= Associated patches: (v)MAG*3*8 <<= must be installed BEFORE `MAG*3*51' (v)MAG*3*10 <<= must be installed BEFORE `MAG*3*51' (v)MAG*3*11 <<= must be installed BEFORE `MAG*3*51' (v)MAG*3*30 <<= must be installed BEFORE `MAG*3*51' Subject: DICOM Maintenance III Category: - Routine - Data Dictionary - Other Description: ============ This document describes the changes made in Patch 51 the DICOM Gateway Maintenance III patch. DICOM is an acronym for the Digital Imaging and Communications in Medicine standard. DICOM brings open systems technology to the medical imaging marketplace and enables VISTA to communicate directly with commercial medical imaging equipment. This patch contains several bug fixes and enhancements. Image Gateway: ------------- . The DICOM Gateway now automatically removes files that were left behind when attempts to acquire an image resulted in an "incomplete image". . The DICOM Gateway now reports the number of incomplete images correctly. . The DICOM Gateway software now offers a facility to verify the count of images to be corrected. If an older version of the software left an incorrect count, this utility will automatically correct the value. . When a study consists of multiple series of images, those series that originate from equivalent acquisition SOP classes are now combined. . DICOM Correct could run into an error when information was removed from the "Related Images" field (#26). Resilience has been added to address this situation. . The DICOM Gateway could run into a situation where it cannot create an "abstract" for an image. In the past, the DICOM Gateway used to stop when such an event occurred. Now, the DICOM Gateway sends an e-mail message and continues. . Patch 51 contains a new version of MAG_MakeABS.exe which allows for the successful creation of an abstract image when the Photometric Interpretation is RGB and the Planar Configuration is set to 0 (zero). Images containing a Photometric Interpretation of Palette Color are not supported at this time. . Patch 51 contains a new version of MAG_AbstrTGA.exe, which can handle images with lines that have more than 4095 pixels. . Process DICOM Images could run into an error ( in MAGDIR9B) when SOP class information was not defined for multi-frame images. Safeguards are now in place to ensure that this information is defined. . The DICOM Gateway could run ino a situation where it could not create a local copy of a part of a DICOM header (PUTVALUE+2^MAGDDW4). Safeguards are now in place to prevent this error from happening. The source of the error is the large Look-Up-Tables in certain image files. . The DICOM Gateway is now able to acquire images for patients who only have a last name (no first name, no middle initials). . The software allowed for a user-override to acquire an image with duplicate SOP Instance UID by aborting and restarting "Process DICOM Images". The possibility to apply this override has been removed. Text Gateway ------------ . The DICOM Gateway now removes discontinued GMRC Consults from the Modality Worklist. . When an SSN is present, and contains only one or more dashes, it is now treated as 'absent' (). . While processing HL7 messages, a DICOM Gateway could run into an error CREATE+37^MAGDWLPB. The software now double-checks the values of all variables before updating the cross-references. . When an accession number looks like GMRC-1234, it could be treated as 'absent'. The current version recognizes such accession numbers properly. . The Modality Worklist software could run into an error ( CHECKMOD^MAGDWLU1). The software was referencing the wrong local variable (MODALITY instead of X, as passed by parameter). The name of the variable is now correct. Routing ------- . Date of Birth in DICOM header must be in correct format. In some cases data in VA-FileMan format was copied. Now the correct format is applied in all cases. . The DICOM Gateway now supports DICOM transmission of images from multiple sessions on the same Gateway. . The DICOM_Send procedure now allocates transmission tasks to multiple processes in such a way that no duplication of effort occurs. . The DICOM Gateway software now handles the field named DESTINATION (file # 2006.035, field # 1) consistently as a 'variable pointer'. . The DICOM Routing software now issues an appropriate warning message when no valid destinations are selected. . Routing now includes the ability to auto-route prior studies. Routing uses the same code as VistARad for finding and selecting prior studies. The Post-Init code will pre-populate the table that is used for determining prior studies. For those entries that have not yet been set up by the site, a default setting will be added that selects a maximum of 1 study that is not older than 5 years. . Routing now includes the ability to perform JPEG 2000 lossless compression. Compression requires a third party (Aware Inc.) end-user license for each workstation at each site. . Patch 51 includes software that can be run as a service on computers that support Remote Routing Shares. This service will automatically decompress image files that are transmitted in compressed format. NOTE: All sites running VISTA Imaging 3.0 that have implemented DICOM Gateways must install both the KIDS portion on their VISTA system and the client portions of this patch on all relevant client systems. Special note for sites who are using menu option 2-8-2 (Transmit to DICOM Destination), on-demand routing of DICOM images using the VistARad manager or DICOM image routing using the VistA Imaging Autorouter. In order to ensure up-to-date information in the DICOM headers of the transmitted images, it is required that the features of patch 50 are installed at the site. Either a test version of patch 50 (version P50T31 or newer) is required, or the released version. This patch can be downloaded from: ================================= This software will be available on the Imaging FTP Server in the following directory: ftp.imaging.med.va.gov/Software/Released_Software/Mag3_0P51. Installation instructions are included in the MAG3_0P51_Patch_Description.pdf doucment. NOTE: Any late-breaking news about this patch will be found in a readme file. If present, this file will also be located in the MAG3_0P51 directory. Patch Contents: ============== This patch includes the following files: Software: MAG30P51.ZIP - Download the file from the Imaging FTP folder. This file contains the entire patch 51 files required for an automatic installation on the Imaging DICOM gateways. MAG_Decompressor_Setup.exe - Installation Program for Automated Decompression Service. MAG30P51.KID - KIDS (Kernel Installation & Distribution System) package to be installed on the VistA hospital database. Documentation: The following is the documentation available for this patch: MAG3_0P51_Patch_Description.pdf - Patch 51's description and installation information. DICOMIG.pdf - Imaging DICOM Gateway Installation Guide. MAG3_0P51_DICOMig_B_4_4.pdf - Change page for section B.4.4 of the DICOM Installation guide. MAG3_0P51_DICOMum_4_18.pdf - Change page for DICOM User Manual MAG3_0P51_DICOMig_G_1.pdf - Change page for section G.1 of the DICOM Installation guide. MAG3_IMGerrormsg.pdf - Imaging Error Message Manual. MAG3_P51_IMGtechmanSec7_2_1VaFileManFiles.pdf - Change page for section 7.2.1 of the Imaging Technical Manual. MAG3_0P51_IG_3_2_3_sw_inst.pdf - Change for section 3.2.3 of the Imaging Installation Guide. MAG_Routing_User_Guide.pdf - VistA Imaging Routing User Guide. Terms of use: ============= FDA regulations require that each Imaging software distribution is documented and tracked by the VISTA Imaging project. To receive this patch, sites must have a Site Agreement filed with and approved by the VISTA Imaging Group. For information about the status of a Site Agreement, contact the VISTA Imaging Distribution Manager (VHAVISiteFeedback@va.gov). NOIS\Remedy entries: ============ The following NOIS (National Online Information System) entries are addressed in this Patch: PUG-0704-51142 - Remedy 68132 CMS-0903-31658 - Remedy 75492 BOI-0704-51949 - Remedy 68150 CLA-0704-20029 - Remedy 78517 ALB-0404-50592 - Remedy 67953 BAY-0604-31328 - Remedy 78381 POR-0604-50749 - Remedy 78294 HUN-0904-20326 - Remedy 79074 LOU-1204-41164 - Remedy 68538 SAM-0604-21866 - Remedy 68078 HUN-0204-21777 - Remedy 67884 HWH-0804-40985 - Remedy 68194 DUB-0704-30879 - Remedy 68125 BOI-0704-51348 - Remedy 78705 HWH-1004-41238 - Remedy 68350 BIL-0503-30510 - Remedy 67628 BHS-1004-11120 - Remedy 68344 FRE-0704-61303 - Remedy 78699 Test Sites: ========== The following sites are test sites for this patch: Biloxi, MS El Paso, TX Puget Sound, WA Routine summary: ================= The following routines are included in the KIDS file. The second line of the routines will look like: like:;;3.0;IMAGING;**[patch list]**;August 26, 2005 Routines that reside on VistA: Routine Before Patch After Patch After Patch Patch List Name Old Style New Style ----------- ----------- --------- MAG7UP 11171313 11177267 34875703 **11,51** MAGBRTE3 5833319 5833319 17206043 **11,51** MAGBRTE4 15019760 15295929 79623233 **11,30,51** MAGBRTE5 12363938 10025015 36381049 **11,30,51** MAGBRTK new 7162000 19598690 **51** MAGBRTLD 5665322 7191644 16140125 **9,11,30,51** MAGBRTUT 6805146 6881357 19709178 **9,11,30,51** MAGDCCSS 7793439 7813577 23075441 **10,11,51** MAGDFB 2768480 2735520 3801843 **11,51** MAGDFCNV 4298417 4468938 8587373 **11,51** MAGDGL 8693119 8800264 30841791 **11,51** MAGDGMRC 8587567 8586191 32065539 **10,51** MAGDHWA 13363951 13363551 58804489 **10,51** MAGDHWC 10917214 11574745 43939437 **10,51** MAGDHWS 8397303 8385051 24229864 **10,11,51** MAGDIR8 4729054 4801612 11043357 **11,51** MAGDIR81 14282136 15887244 73980751 **11,30,51** MAGDIR82 13464369 13699038 61661475 **11,30,51** MAGDIR83 7606355 8183019 24672823 **11,30,51** MAGDIR8A 10602838 10596882 36949369 **11,51** MAGDIR9A 10789655 11238086 49392347 **11,30,51** MAGDIR9B 6837304 6917351 17435777 **11,51** MAGDIR9E 15838144 13785673 60855818 **11,51** MAGDLB12 8451648 8056663 22785592 **11,51** MAGDLB6 4138192 3475437 5741563 **21,10,11,51** MAGDLBAA 6781952 6585681 12734072 **11,51** MAGDLBV new 6999551 16977570 **51** MAGDMEDK 3273379 3272291 5415662 **51** MAGDMEDL 6729803 6755625 19875835 **51** MAGDQR00 new 2425880 3096939 **51** MAGDQR01 new 8020820 25742875 **51** MAGDQR02 new 15665200 75305659 **51** MAGDQR03 new 9918762 63890253 **51** MAGDQR04 new 12503040 52493648 **51** MAGDRA2 7852272 7860816 25261561 **10,11,51** MAGDRCU2 9684070 9684614 38123577 **10,11,51** MAGDRPC1 8395133 11783859 59232604 **11,30,51** MAGDRPC2 12950501 13189349 65141543 **11,30,51** MAGDRPC3 11631756 11696591 44058911 **11,30,51** MAGDRPC4 15201662 16384505 72718318 **11,30,51** MAGDRPC5 14221287 14689488 79459148 **11,30,51** MAGDRPC6 11175169 11177465 36593110 **11,30,51** MAGDRPC7 8750764 8740525 33129765 **11,51** MAGDRPC8 10596480 10596480 49397368 **11,30,51** MAGIPS51 new 9657731 34716479 **51** MAGJEX2 14783713 14452837 48782421 **51** MAGUXRF 4648912 4648912 17102779 **51** MAGVCHK new 7581330 21002170 **51** Routine MAGIPS51 is an installation routine that will be automatically deleted after the KIDs installation. 'Old style' checksums are calculated using the Kernel utility program CHECK^XTSUMBLD and 'new style' checksums are calculated using the Kernel utility program CHECK1^XTSUMBLD. The following routines are included in the automatic DICOM installation files and reside on the DICOM Gateways: Routine Before Patch After Patch After Patch Patch List Name Old Style New Style ----------- ----------- --------- MAG7UP 11171313 11177267 34875703 **11,51** MAGBRTA4 14649218 15428865 73172707 **11,30,51** MAGBRTA5 10316626 14877711 73804721 **11,30,51** MAGBRTA6 6364068 6373178 12302225 **11,51** MAGBRTB1 13923470 9828972 26621691 **9,30,51** MAGBRTB2 14272169 14991882 60866156 **9,30,51** MAGBRTB4 8554349 8783941 29118160 **9,11,30,51** MAGBRTK new 7162000 19598690 **51** MAGBRTLR 4805852 5125359 10697929 **11,51** MAGBRTP1 10101485 10355047 30790871 **11,30,51** MAGDACP1 13082461 13082461 59650730 **21,11,30,51** MAGDACR3 13955651 13962653 52279787 **51** MAGDACU1 9527120 9527120 34421598 **30,51** MAGDAUD2 5645586 5687272 11532851 **10,11,30,51** MAGDBB 12858437 14376269 89797193 **9,10,11,30,51** MAGDCMPE new 5900084 15118468 **51** MAGDCST1 14268531 14288121 72575464 **10,30,51** MAGDCST2 8776919 8776919 31207025 **11,51** MAGDCST3 3942078 3942078 10164681 **51** MAGDCST4 9397031 9397018 34633853 **10,11,30,51** MAGDDEL1 4599235 4603626 7710689 **10,11,51** MAGDDEL2 9199985 9198439 31010776 **10,11,51** MAGDDR0 8701963 8764477 53719761 **1,10,51** MAGDDR1 11902614 11902614 48401141 **10,11,30,51** MAGDDR2A 16272317 16343469 68199808 **1,10,51** MAGDDR3 10064054 10064273 38045689 **1,10,51** MAGDDR7 6884620 6884620 19186938 **10,30,51** MAGDDW0 4978990 4963626 18495768 **1,10,51** MAGDDW2 11362260 11608640 45559121 **10,30,51** MAGDDW3 10875899 10737137 37090653 **10,30,51** MAGDDW4 16898926 18076338 73917452 **1,10,51** MAGDEXC1 11440704 11440704 41318661 **1,11,30,51** MAGDFND1 7366703 7367663 17411878 **51** MAGDFND2 17417656 17399475 81706868 **1,10,30,51** MAGDFND3 17601673 17597033 63025400 **10,30,51** MAGDGEX1 13949343 16487644 74515952 **11,30,51** MAGDGEX2 6645188 8305580 25438723 **11,51** MAGDHRC 18420594 18431107 79269261 **11,30,51** MAGDHRC0 3546805 3546805 6192807 **11,51** MAGDHRC4 14795989 14795989 64819620 **11,51** MAGDHRC5 14004866 14010352 64190006 **11,30,51** MAGDHRC6 9130286 9190185 29890074 **11,51** MAGDHRC7 6120483 6120483 15742845 **11,51** MAGDIR6 16677401 16614368 62868569 **11,30,51** MAGDIR6A 5708446 5708446 11721237 **11,51** MAGDIR6B 6878419 7116394 15944126 **11,30,51** MAGDIR6C 9426495 9467610 29758424 **11,30,51** MAGDIR6E 6132074 7559795 23201866 **11,51** MAGDIR6F 8347373 8345453 19071183 **11,30,51** MAGDIR7 2852599 2852599 4384732 **11,51** MAGDIR71 12548321 12607718 64613651 **11,30,51** MAGDIR73 3477169 3477169 5571354 **11,51** MAGDIR74 3455699 3455699 6178097 **11,51** MAGDIR75 10418643 10418643 35406799 **11,51** MAGDIR7C 16803028 16803028 69748082 **11,30,51** MAGDIR7D 5935244 6341631 15459872 **11,51** MAGDIR7F 9376158 9374590 32449092 **11,51** MAGDIR7G 4348835 4814661 9260044 **11,51** MAGDIR7T 10465594 10464570 35720524 **11,30,51** MAGDIW2A 8403351 8533451 27775763 **10,11,30,51** MAGDIW3B 8675108 8707552 30800042 **11,30,51** MAGDIW3C 6093199 6093199 14608438 **10,51** MAGDIW4 8202326 8202326 25334535 **10,51** MAGDIW6 9843343 9936757 33448524 **30,51** MAGDIWB0 3687576 3490000 5592351 **11,51** MAGDIWB1 13027381 13106994 52612240 **11,30,51** MAGDIWB2 16164545 16325119 65516524 **11,30,51** MAGDIWB5 17118029 17324908 71262979 **11,30,51** MAGDIWB7 6893062 6898354 15957027 **11,51** MAGDIX1 7585244 7585244 27879587 **10,30,51** MAGDLOGI 6158859 8985104 18037111 **11,51** MAGDLOGN 17163970 15804100 76265038 **11,30,51** MAGDM2MB 6685191 6685385 17439097 **11,51** MAGDMENO 11359000 11592607 39056639 **11,30,51** MAGDMENU 11733936 11739707 47753714 **9,21,11,30,51** MAGDMFB1 16235235 16914544 85413954 **9,21,11,30,51** MAGDMFB2 10793627 11582703 42201847 **21,30,51** MAGDMFBB 12563603 13497051 61151108 **9,21,11,51** MAGDMFBD 10100887 10093867 29422066 **9,21,11,51** MAGDMFBE 13375198 13539021 46388838 **9,21,11,30,51** MAGDMFBM 16099039 16729029 82684867 **9,10,11,30,51** MAGDMFBS 9865571 10584696 33621849 **9,10,11,30,51** MAGDMLOG 8463981 8463981 34754117 **9,10,30,51** MAGDMMSG 10560186 10560026 43383583 **21,11,30,51** MAGDQRU0 3492318 3528617 5301775 **51** MAGDQUE4 8631897 8914260 27641814 **30,51** MAGDRPC0 2690683 2734291 3877927 **11,51** MAGDSTRT 10354951 10446503 44172273 **21,11,30,51** MAGDTCP3 8753692 8751388 27795410 **30,51** MAGDTGA 4580712 4578888 9966369 **11,30,51** MAGDVRSN 6818937 7050786 21032634 **1,7,9,26,21,10,36,3,11,30,5,51** MAGDWLPA 15076898 15076898 54654239 **11,51** MAGDWLPB 9563777 9663220 26217934 **11,30,51** MAGDWLPC 14003263 13992688 50677838 **11,51** MAGDWLU 5913249 5911649 14425546 **21,11,30,51** MAGDWLU1 11951646 11914402 38580406 **21,10,30,51** MAGM2VC 10697402 10793890 52209330 **11,30,51** MAGM2VCU 13820422 13820422 89739934 **11,30,51** MAGOSDIR 6245226 6268059 18403377 **10,51** MAGUE 16425342 16428278 75147266 **21,10,51** 'Old style' checksums are calculated using the Kernel utility program CHECK^XTSUMBLD and 'new style' checksums are calculated using the Kernel utility program CHECK1^XTSUMBLD. Installation: ============= Follow the installation instructions provided in documentation titled MAG3_0P51_Patch_Description.pfd. Routine Information: ==================== Routine Name: MAG7UP Routine Name: MAGBRTA4 Routine Name: MAGBRTA5 Routine Name: MAGBRTA6 Routine Name: MAGBRTB1 Routine Name: MAGBRTB2 Routine Name: MAGBRTB4 Routine Name: MAGBRTE3 Routine Name: MAGBRTE4 Routine Name: MAGBRTE5 Routine Name: MAGBRTK Routine Name: MAGBRTLD Routine Name: MAGBRTLR Routine Name: MAGBRTP1 Routine Name: MAGBRTUT Routine Name: MAGDACP1 Routine Name: MAGDACR3 Routine Name: MAGDACU1 Routine Name: MAGDAUD2 Routine Name: MAGDBB Routine Name: MAGDCCSS Routine Name: MAGDCMPE Routine Name: MAGDCST1 Routine Name: MAGDCST2 Routine Name: MAGDCST3 Routine Name: MAGDCST4 Routine Name: MAGDDEL1 Routine Name: MAGDDEL2 Routine Name: MAGDDR0 Routine Name: MAGDDR1 Routine Name: MAGDDR2A Routine Name: MAGDDR3 Routine Name: MAGDDR7 Routine Name: MAGDDW0 Routine Name: MAGDDW2 Routine Name: MAGDDW3 Routine Name: MAGDDW4 Routine Name: MAGDEXC1 Routine Name: MAGDFB Routine Name: MAGDFCNV Routine Name: MAGDFND1 Routine Name: MAGDFND2 Routine Name: MAGDFND3 Routine Name: MAGDGEX1 Routine Name: MAGDGEX2 Routine Name: MAGDGL Routine Name: MAGDGMRC Routine Name: MAGDHRC Routine Name: MAGDHRC0 Routine Name: MAGDHRC4 Routine Name: MAGDHRC5 Routine Name: MAGDHRC6 Routine Name: MAGDHRC7 Routine Name: MAGDHWA Routine Name: MAGDHWC Routine Name: MAGDHWS Routine Name: MAGDIR6 Routine Name: MAGDIR6A Routine Name: MAGDIR6B Routine Name: MAGDIR6C Routine Name: MAGDIR6E Routine Name: MAGDIR6F Routine Name: MAGDIR7 Routine Name: MAGDIR71 Routine Name: MAGDIR73 Routine Name: MAGDIR74 Routine Name: MAGDIR75 Routine Name: MAGDIR7C Routine Name: MAGDIR7D Routine Name: MAGDIR7F Routine Name: MAGDIR7G Routine Name: MAGDIR7T Routine Name: MAGDIR8 Routine Name: MAGDIR81 Routine Name: MAGDIR82 Routine Name: MAGDIR83 Routine Name: MAGDIR8A Routine Name: MAGDIR9A Routine Name: MAGDIR9B Routine Name: MAGDIR9E Routine Name: MAGDIW2A Routine Name: MAGDIW3B Routine Name: MAGDIW3C Routine Name: MAGDIW4 Routine Name: MAGDIW6 Routine Name: MAGDIWB0 Routine Name: MAGDIWB1 Routine Name: MAGDIWB2 Routine Name: MAGDIWB5 Routine Name: MAGDIWB7 Routine Name: MAGDIX1 Routine Name: MAGDLB12 Routine Name: MAGDLB6 Routine Name: MAGDLBAA Routine Name: MAGDLBV Routine Name: MAGDLOGI Routine Name: MAGDLOGN Routine Name: MAGDM2MB Routine Name: MAGDMEDK Routine Name: MAGDMEDL Routine Name: MAGDMENO Routine Name: MAGDMENU Routine Name: MAGDMFB1 Routine Name: MAGDMFB2 Routine Name: MAGDMFBB Routine Name: MAGDMFBD Routine Name: MAGDMFBE Routine Name: MAGDMFBM Routine Name: MAGDMFBS Routine Name: MAGDMLOG Routine Name: MAGDMMSG Routine Name: MAGDPRC7 Routine Name: MAGDPRC8 Routine Name: MAGDQR00 Routine Name: MAGDQR01 Routine Name: MAGDQR02 Routine Name: MAGDQR03 Routine Name: MAGDQR04 Routine Name: MAGDQRU0 Routine Name: MAGDQUE4 Routine Name: MAGDRA2 Routine Name: MAGDRCU2 Routine Name: MAGDRPC0 Routine Name: MAGDRPC1 Routine Name: MAGDRPC2 Routine Name: MAGDRPC3 Routine Name: MAGDRPC4 Routine Name: MAGDRPC5 Routine Name: MAGDRPC6 Routine Name: MAGDSTRT Routine Name: MAGDTCP3 Routine Name: MAGDTGA Routine Name: MAGDVRSN Routine Name: MAGDWLPA Routine Name: MAGDWLPB Routine Name: MAGDWLPC Routine Name: MAGDWLU Routine Name: MAGDWLU1 Routine Name: MAGJEX2 Routine Name: MAGM2VC Routine Name: MAGM2VCU Routine Name: MAGOSDIR Routine Name: MAGUE Routine Name: MAGUXRF Routine Name: MAGVCHK ============================================================================= User Information: Entered By : CASUGAY,ELSIE G Date Entered : DEC 21, 2004 Completed By: BARRIOS,LUCILLE Date Completed: JUN 16, 2006 Released By : BOSAK,GREG Date Released : JUN 16, 2006 ============================================================================= Packman Mail Message: ===================== No routines included